@aglyn/plugins-ai 1.0.0-beta.256 → 1.0.0-beta.258

package/src/lib/insights/ai-figure-readers.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/insights/ai-figure-readers.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 { formPeriodKey, formStatsTotals, type FormStats } from '@aglyn/aglyn/app-utils/forms'\nimport {\n  PLUGIN_FIGURE_MAX_ROWS,\n  pluginFigureChange,\n  pluginFigureDay,\n  pluginFigureWindows,\n  registerPluginFigureReader,\n  type PluginFigureReader,\n  type PluginFigureRead,\n  type PluginFigureRequest,\n  type PluginFigureRow,\n  type PluginFigureTable,\n} from '@aglyn/aglyn/plugin-manager/plugin-figures'\nimport { AI_PLUGIN_ID } from '../constants'\n\n/**\n * The figure readers this plugin registers for records the PLATFORM keeps\n * (AGL-2915): a site's page-view counters and its forms' counters. Every\n * other reader an insight reads is registered by the plugin that owns its\n * records — commerce, bookings, marketing, the workspace's datasets — on the\n * `plugin-figures` seam, and nothing here reads their documents.\n *\n * Each reader answers with one compact table of aggregates, read-only and\n * about nobody: counts, sums and rates, labeled by a page path, a form's name\n * or a referring site — never a visitor or a submission.\n *\n * The readers use the arithmetic their console cards use: the Traffic card's\n * windows and change (`pluginFigureWindows`, `pluginFigureChange`, which are\n * that card's split and delta), and the forms plugin's month counters through\n * `formStatsTotals`, the one function every forms surface windows by.\n */\n\ntype Firestore = FirebaseFirestore.Firestore\n\n/** How a reader reaches Firestore: resolved when it reads, never when it registers. */\nexport type AiFigureFirestore = () => Firestore\n\n/** The traffic windows: the Traffic card's own ranges. */\nexport const AI_TRAFFIC_WINDOWS: readonly number[] = [7, 14, 30, 90]\n\n/** A day-by-day table fits a table's row bound only over a short window. */\nexport const AI_TRAFFIC_DAILY_WINDOWS: readonly number[] = [7, 14]\n\n/** Pages a pages table lists; the rest are counted in `omitted`. */\nexport const AI_TRAFFIC_TOP_PAGES = 10\n\n/** Referring sites, and campaign sources and campaigns, a sources table lists. */\nexport const AI_TRAFFIC_TOP_REFERRERS = 8\nexport const AI_TRAFFIC_TOP_CAMPAIGNS = 5\n\n/** Forms a forms table reads. */\nexport const AI_FORMS_READ_LIMIT = 100\n\nconst str = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\n\nconst num = (value: unknown): number => {\n  const parsed = typeof value === 'number' ? value : Number(value)\n  return Number.isFinite(parsed) ? parsed : 0\n}\n\nconst round1 = (value: number): number => Math.round(value * 10) / 10\n\nconst share = (part: number, whole: number): number | null => (whole > 0 ? round1((part / whole) * 100) : null)\n\nfunction refused(status: 400 | 403 | 404, error: string): PluginFigureRead {\n  return { ok: false, status, error }\n}\n\n/** A window's days as the table's period, oldest to newest. */\nfunction periodOf(request: PluginFigureRequest): PluginFigureTable['period'] {\n  const { current } = pluginFigureWindows(request.now, request.days)\n  return { from: current.from, to: current.to, days: request.days }\n}\n\n/** Every day id of the window and the one before it, newest first. */\nfunction dayIds(now: Date, days: number): { current: string[]; previous: string[] } {\n  const { current, previous } = pluginFigureWindows(now, days)\n  const walk = (startMs: number, endMs: number): string[] => {\n    const ids: string[] = []\n    for (let at = endMs - 86_400_000; at >= startMs; at -= 86_400_000) ids.push(pluginFigureDay(new Date(at)))\n    return ids\n  }\n  return { current: walk(current.startMs, current.endMs), previous: walk(previous.startMs, previous.endMs) }\n}\n\n// ── Traffic ───────────────────────────────────────────────────────────────\n\ninterface TrafficDay {\n  total: number\n  visitors: number\n  paths: Record<string, number>\n  referrers: Record<string, number>\n  utm: Record<string, Record<string, number>>\n}\n\nconst counts = (value: unknown): Record<string, number> => {\n  const out: Record<string, number> = {}\n  if (!value || typeof value !== 'object') return out\n  for (const [key, count] of Object.entries(value as Record<string, unknown>)) {\n    const n = num(count)\n    if (n > 0) out[key] = n\n  }\n  return out\n}\n\nasync function readTrafficDays(\n  firestore: Firestore,\n  hostId: string,\n  ids: readonly string[],\n): Promise<TrafficDay[]> {\n  if (!ids.length) return []\n  const collection = firestore.collection('hosts').doc(hostId).collection('analytics')\n  const snapshots = await firestore.getAll(...ids.map((id) => collection.doc(id)))\n  return snapshots.map((snapshot) => {\n    const data = (snapshot.exists ? snapshot.data() : null) ?? {}\n    const utm: Record<string, Record<string, number>> = {}\n    for (const [param, values] of Object.entries((data['utm'] ?? {}) as Record<string, unknown>)) {\n      utm[param] = counts(values)\n    }\n    return {\n      total: num(data['total']),\n      visitors: num(data['visitors']),\n      paths: counts(data['paths']),\n      referrers: counts(data['referrers']),\n      utm,\n    }\n  })\n}\n\nfunction sumMaps(days: readonly TrafficDay[], pick: (day: TrafficDay) => Record<string, number>): Map<string, number> {\n  const totals = new Map<string, number>()\n  for (const day of days) {\n    for (const [key, count] of Object.entries(pick(day))) totals.set(key, (totals.get(key) ?? 0) + count)\n  }\n  return totals\n}\n\nconst ranked = (totals: Map<string, number>): Array<[string, number]> =>\n  [...totals.entries()].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))\n\nfunction siteReader(\n  base: Omit<PluginFigureReader, 'read' | 'scope' | 'plugin'>,\n  read: (firestore: Firestore, request: PluginFigureRequest & { hostId: string }) => Promise<PluginFigureRead>,\n  firestore: AiFigureFirestore,\n  plugin: string | null,\n): PluginFigureReader {\n  return {\n    ...base,\n    scope: 'site',\n    plugin,\n    read: async (request) => {\n      if (!request.hostId) return refused(400, 'Open a site to read its figures')\n      if (!base.windows.includes(request.days)) return refused(400, 'That window is not one this reader covers')\n      return read(firestore(), { ...request, hostId: request.hostId })\n    },\n  }\n}\n\nexport function trafficFigureReaders(firestore: AiFigureFirestore): PluginFigureReader[] {\n  const source = { label: 'Analytics', path: 'analytics' }\n  const visitorsNote =\n    'Visitors are counted once per browser tab per day, so one person on two days counts twice.'\n  return [\n    siteReader(\n      {\n        id: 'traffic.summary',\n        label: 'Traffic',\n        description:\n          'Page views, visitors and views a day on the site over the window, each beside the window before it and the change.',\n        windows: AI_TRAFFIC_WINDOWS,\n      },\n      async (db, request) => {\n        const ids = dayIds(request.now, request.days)\n        const [current, previous] = await Promise.all([\n          readTrafficDays(db, request.hostId, ids.current),\n          readTrafficDays(db, request.hostId, ids.previous),\n        ])\n        const total = (days: TrafficDay[]) => days.reduce((sum, day) => sum + day.total, 0)\n        const visitors = (days: TrafficDay[]) => days.reduce((sum, day) => sum + day.visitors, 0)\n        const views = total(current)\n        const viewsBefore = total(previous)\n        const perDay = Math.round(views / request.days)\n        const perDayBefore = Math.round(viewsBefore / request.days)\n        const table: PluginFigureTable = {\n          title: 'Traffic',\n          source,\n          period: periodOf(request),\n          columns: [\n            { key: 'figure', label: 'Figure', kind: 'text' },\n            { key: 'current', label: 'This window', kind: 'count' },\n            { key: 'previous', label: 'Window before', kind: 'count' },\n            { key: 'change', label: 'Change', kind: 'change' },\n          ],\n          rows: [\n            { figure: 'Page views', current: views, previous: viewsBefore, change: pluginFigureChange(views, viewsBefore) },\n            {\n              figure: 'Visitors',\n              current: visitors(current),\n              previous: visitors(previous),\n              change: pluginFigureChange(visitors(current), visitors(previous)),\n            },\n            {\n              figure: 'Page views a day',\n              current: perDay,\n              previous: perDayBefore,\n              change: pluginFigureChange(perDay, perDayBefore),\n            },\n          ],\n          omitted: 0,\n          notes: [\n            visitorsNote,\n            ...(viewsBefore ? [] : ['The window before this one recorded no page views, so there is no change to compare.']),\n          ],\n        }\n        return { ok: true, table }\n      },\n      firestore,\n      null,\n    ),\n    siteReader(\n      {\n        id: 'traffic.pages',\n        label: 'Top pages',\n        description: `The site's ${AI_TRAFFIC_TOP_PAGES} most viewed pages over the window, with each page's share of all views and its change from the window before.`,\n        windows: AI_TRAFFIC_WINDOWS,\n      },\n      async (db, request) => {\n        const ids = dayIds(request.now, request.days)\n        const [current, previous] = await Promise.all([\n          readTrafficDays(db, request.hostId, ids.current),\n          readTrafficDays(db, request.hostId, ids.previous),\n        ])\n        const now = ranked(sumMaps(current, (day) => day.paths))\n        const before = sumMaps(previous, (day) => day.paths)\n        const all = now.reduce((sum, [, count]) => sum + count, 0)\n        const rows: PluginFigureRow[] = now.slice(0, AI_TRAFFIC_TOP_PAGES).map(([path, views]) => ({\n          page: path,\n          views,\n          share: share(views, all),\n          change: pluginFigureChange(views, before.get(path) ?? null),\n        }))\n        return {\n          ok: true,\n          table: {\n            title: 'Top pages',\n            source,\n            period: periodOf(request),\n            columns: [\n              { key: 'page', label: 'Page', kind: 'text' },\n              { key: 'views', label: 'Views', kind: 'count' },\n              { key: 'share', label: 'Share of views', kind: 'percent' },\n              { key: 'change', label: 'Change', kind: 'change' },\n            ],\n            rows,\n            omitted: Math.max(0, now.length - rows.length),\n            notes: [],\n          },\n        }\n      },\n      firestore,\n      null,\n    ),\n    siteReader(\n      {\n        id: 'traffic.sources',\n        label: 'Traffic sources',\n        description:\n          'Where visits came from over the window: the referring sites, and the campaign sources and campaigns links were tagged with, with each one’s views.',\n        windows: AI_TRAFFIC_WINDOWS,\n      },\n      async (db, request) => {\n        const days = await readTrafficDays(db, request.hostId, dayIds(request.now, request.days).current)\n        const all = days.reduce((sum, day) => sum + day.total, 0)\n        const referrers = ranked(sumMaps(days, (day) => day.referrers))\n        const sources = ranked(sumMaps(days, (day) => day.utm['source'] ?? {}))\n        const campaigns = ranked(sumMaps(days, (day) => day.utm['campaign'] ?? {}))\n        const rowsOf = (entries: Array<[string, number]>, limit: number, type: string) =>\n          entries.slice(0, limit).map(([name, views]) => ({ source: name, type, views, share: share(views, all) }))\n        const rows = [\n          ...rowsOf(referrers, AI_TRAFFIC_TOP_REFERRERS, 'Referring site'),\n          ...rowsOf(sources, AI_TRAFFIC_TOP_CAMPAIGNS, 'Campaign source'),\n          ...rowsOf(campaigns, AI_TRAFFIC_TOP_CAMPAIGNS, 'Campaign'),\n        ]\n        return {\n          ok: true,\n          table: {\n            title: 'Traffic sources',\n            source,\n            period: periodOf(request),\n            columns: [\n              { key: 'source', label: 'Source', kind: 'text' },\n              { key: 'type', label: 'Kind', kind: 'text' },\n              { key: 'views', label: 'Views', kind: 'count' },\n              { key: 'share', label: 'Share of all views', kind: 'percent' },\n            ],\n            rows,\n            omitted:\n              Math.max(0, referrers.length - AI_TRAFFIC_TOP_REFERRERS) +\n              Math.max(0, sources.length - AI_TRAFFIC_TOP_CAMPAIGNS) +\n              Math.max(0, campaigns.length - AI_TRAFFIC_TOP_CAMPAIGNS),\n            notes: ['A visit with no referring site, such as a typed address, is in no row.'],\n          },\n        }\n      },\n      firestore,\n      null,\n    ),\n    siteReader(\n      {\n        id: 'traffic.daily',\n        label: 'Traffic by day',\n        description: 'Page views and visitors on each day of the window, oldest first, for spotting a day that stood out.',\n        windows: AI_TRAFFIC_DAILY_WINDOWS,\n      },\n      async (db, request) => {\n        const ids = [...dayIds(request.now, request.days).current].reverse()\n        const days = await readTrafficDays(db, request.hostId, ids)\n        return {\n          ok: true,\n          table: {\n            title: 'Traffic by day',\n            source,\n            period: periodOf(request),\n            columns: [\n              { key: 'day', label: 'Day', kind: 'date' },\n              { key: 'views', label: 'Page views', kind: 'count' },\n              { key: 'visitors', label: 'Visitors', kind: 'count' },\n            ],\n            rows: days.map((day, index) => ({ day: ids[index], views: day.total, visitors: day.visitors })),\n            omitted: 0,\n            notes: [visitorsNote],\n          },\n        }\n      },\n      firestore,\n      null,\n    ),\n  ]\n}\n\n// ── Forms ─────────────────────────────────────────────────────────────────\n\nexport function formsFigureReader(firestore: AiFigureFirestore): PluginFigureReader {\n  return siteReader(\n    {\n      id: 'forms.performance',\n      label: 'Forms',\n      description:\n        'Each form’s views, submissions, the share of views that became a submission, and leads, over the calendar months the window falls in.',\n      windows: AI_TRAFFIC_WINDOWS,\n    },\n    async (db, request) => {\n      const { current } = pluginFigureWindows(request.now, request.days)\n      const from = formPeriodKey(current.startMs)\n      const to = formPeriodKey(current.endMs - 1)\n      const snapshot = await db\n        .collection('hosts')\n        .doc(request.hostId)\n        .collection('forms')\n        .limit(AI_FORMS_READ_LIMIT)\n        .get()\n      const forms = snapshot.docs\n        .map((doc) => ({ doc, data: (doc.data() ?? {}) as Record<string, unknown> }))\n        .filter(({ data }) => !data['deletedAt'])\n        .map(({ doc, data }) => {\n          const totals = formStatsTotals(data['stats'] as FormStats | undefined, { from, to })\n          return {\n            form: str(data['displayName']) || doc.id,\n            views: totals.views,\n            submissions: totals.submissions,\n            completion:\n              totals.views && totals.submissions !== null ? share(totals.submissions, totals.views) : null,\n            leads: totals.leads,\n          }\n        })\n        .sort((a, b) => (b.submissions ?? -1) - (a.submissions ?? -1) || a.form.localeCompare(b.form))\n      const monthStart = from ? `${from}-01` : current.from\n      return {\n        ok: true,\n        table: {\n          title: 'Forms',\n          source: { label: 'Forms', path: 'forms' },\n          period: {\n            from: monthStart,\n            to: current.to,\n            days: Math.round((Date.parse(current.to) - Date.parse(monthStart)) / 86_400_000) + 1,\n          },\n          columns: [\n            { key: 'form', label: 'Form', kind: 'text' },\n            { key: 'views', label: 'Views', kind: 'count' },\n            { key: 'submissions', label: 'Submissions', kind: 'count' },\n            { key: 'completion', label: 'Views that became a submission', kind: 'percent' },\n            { key: 'leads', label: 'Leads', kind: 'count' },\n          ],\n          rows: forms.slice(0, PLUGIN_FIGURE_MAX_ROWS),\n          omitted: Math.max(0, forms.length - PLUGIN_FIGURE_MAX_ROWS),\n          notes: [\n            'Form figures are kept by calendar month, so they cover whole months from the first day of the month the window starts in.',\n            'Views are counted in the visitor’s browser and submissions on the server, so a rate can pass 100%.',\n          ],\n        },\n      }\n    },\n    firestore,\n    'forms',\n  )\n}\n\n/** Every reader this plugin registers, for the platform's own records. */\nexport function aiFigureReaders(firestore: AiFigureFirestore): PluginFigureReader[] {\n  return [...trafficFigureReaders(firestore), formsFigureReader(firestore)]\n}\n\n/**\n * Registers them from the console surface, the one surface that runs insight\n * jobs. By a call, never by an import (AGL-3025).\n */\nexport function registerAiFigureReaders(firestore: AiFigureFirestore): void {\n  for (const reader of aiFigureReaders(firestore)) {\n    registerPluginFigureReader(reader, { pluginId: AI_PLUGIN_ID })\n  }\n}\n"],"names":["formPeriodKey","formStatsTotals","PLUGIN_FIGURE_MAX_ROWS","pluginFigureChange","pluginFigureDay","pluginFigureWindows","registerPluginFigureReader","AI_PLUGIN_ID","AI_TRAFFIC_WINDOWS","AI_TRAFFIC_DAILY_WINDOWS","AI_TRAFFIC_TOP_PAGES","AI_TRAFFIC_TOP_REFERRERS","AI_TRAFFIC_TOP_CAMPAIGNS","AI_FORMS_READ_LIMIT","str","value","trim","num","parsed","Number","isFinite","round1","Math","round","share","part","whole","refused","status","error","ok","periodOf","request","current","now","days","from","to","dayIds","previous","walk","startMs","endMs","ids","at","push","Date","counts","out","key","count","Object","entries","n","readTrafficDays","firestore","hostId","length","collection","doc","snapshots","getAll","map","id","snapshot","data","exists","utm","param","values","total","visitors","paths","referrers","sumMaps","pick","totals","Map","day","set","get","ranked","sort","a","b","localeCompare","siteReader","base","read","plugin","scope","windows","includes","trafficFigureReaders","source","label","path","visitorsNote","description","db","Promise","all","reduce","sum","views","viewsBefore","perDay","perDayBefore","table","title","period","columns","kind","rows","figure","change","omitted","notes","before","slice","page","max","sources","campaigns","rowsOf","limit","type","name","reverse","index","formsFigureReader","forms","docs","filter","form","submissions","completion","leads","monthStart","parse","aiFigureReaders","registerAiFigureReaders","reader","pluginId"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/insights/ai-figure-readers.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 { formPeriodKey, formStatsTotals, type FormStats } from '@aglyn/aglyn/app-utils/forms'\nimport {\n  PLUGIN_FIGURE_MAX_ROWS,\n  pluginFigureChange,\n  pluginFigureDay,\n  pluginFigureWindows,\n  registerPluginFigureReader,\n  type PluginFigureReader,\n  type PluginFigureRead,\n  type PluginFigureRequest,\n  type PluginFigureRow,\n  type PluginFigureTable,\n} from '@aglyn/aglyn/plugin-manager/plugin-figures'\nimport { AI_PLUGIN_ID } from '../constants'\n\n/**\n * The figure readers this plugin registers for records the PLATFORM keeps\n * (AGL-2915): a site's page-view counters and its forms' counters. Every\n * other reader an insight reads is registered by the plugin that owns its\n * records — commerce, bookings, marketing, the workspace's datasets — on the\n * `plugin-figures` seam, and nothing here reads their documents.\n *\n * Each reader answers with one compact table of aggregates, read-only and\n * about nobody: counts, sums and rates, labeled by a page path, a form's name\n * or a referring site — never a visitor or a submission.\n *\n * The readers use the arithmetic their console cards use: the Traffic card's\n * windows and change (`pluginFigureWindows`, `pluginFigureChange`, which are\n * that card's split and delta), and the forms plugin's month counters through\n * `formStatsTotals`, the one function every forms surface windows by.\n */\n\ntype Firestore = FirebaseFirestore.Firestore\n\n/** How a reader reaches Firestore: resolved when it reads, never when it registers. */\nexport type AiFigureFirestore = () => Firestore\n\n/** The traffic windows: the Traffic card's own ranges. */\nexport const AI_TRAFFIC_WINDOWS: readonly number[] = [7, 14, 30, 90]\n\n/** A day-by-day table fits a table's row bound only over a short window. */\nexport const AI_TRAFFIC_DAILY_WINDOWS: readonly number[] = [7, 14]\n\n/** Pages a pages table lists; the rest are counted in `omitted`. */\nexport const AI_TRAFFIC_TOP_PAGES = 10\n\n/** Referring sites, and campaign sources and campaigns, a sources table lists. */\nexport const AI_TRAFFIC_TOP_REFERRERS = 8\nexport const AI_TRAFFIC_TOP_CAMPAIGNS = 5\n\n/** Forms a forms table reads. */\nexport const AI_FORMS_READ_LIMIT = 100\n\nconst str = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\n\nconst num = (value: unknown): number => {\n  const parsed = typeof value === 'number' ? value : Number(value)\n  return Number.isFinite(parsed) ? parsed : 0\n}\n\nconst round1 = (value: number): number => Math.round(value * 10) / 10\n\nconst share = (part: number, whole: number): number | null => (whole > 0 ? round1((part / whole) * 100) : null)\n\nfunction refused(status: 400 | 403 | 404, error: string): PluginFigureRead {\n  return { ok: false, status, error }\n}\n\n/** A window's days as the table's period, oldest to newest. */\nfunction periodOf(request: PluginFigureRequest): PluginFigureTable['period'] {\n  const { current } = pluginFigureWindows(request.now, request.days)\n  return { from: current.from, to: current.to, days: request.days }\n}\n\n/** Every day id of the window and the one before it, newest first. */\nfunction dayIds(now: Date, days: number): { current: string[]; previous: string[] } {\n  const { current, previous } = pluginFigureWindows(now, days)\n  const walk = (startMs: number, endMs: number): string[] => {\n    const ids: string[] = []\n    for (let at = endMs - 86_400_000; at >= startMs; at -= 86_400_000) ids.push(pluginFigureDay(new Date(at)))\n    return ids\n  }\n  return { current: walk(current.startMs, current.endMs), previous: walk(previous.startMs, previous.endMs) }\n}\n\n// ── Traffic ───────────────────────────────────────────────────────────────\n\ninterface TrafficDay {\n  total: number\n  visitors: number\n  paths: Record<string, number>\n  referrers: Record<string, number>\n  utm: Record<string, Record<string, number>>\n}\n\nconst counts = (value: unknown): Record<string, number> => {\n  const out: Record<string, number> = {}\n  if (!value || typeof value !== 'object') return out\n  for (const [key, count] of Object.entries(value as Record<string, unknown>)) {\n    const n = num(count)\n    if (n > 0) out[key] = n\n  }\n  return out\n}\n\nasync function readTrafficDays(\n  firestore: Firestore,\n  hostId: string,\n  ids: readonly string[],\n): Promise<TrafficDay[]> {\n  if (!ids.length) return []\n  const collection = firestore.collection('hosts').doc(hostId).collection('analytics')\n  const snapshots = await firestore.getAll(...ids.map((id) => collection.doc(id)))\n  return snapshots.map((snapshot) => {\n    const data = (snapshot.exists ? snapshot.data() : null) ?? {}\n    const utm: Record<string, Record<string, number>> = {}\n    for (const [param, values] of Object.entries((data['utm'] ?? {}) as Record<string, unknown>)) {\n      utm[param] = counts(values)\n    }\n    return {\n      total: num(data['total']),\n      visitors: num(data['visitors']),\n      paths: counts(data['paths']),\n      referrers: counts(data['referrers']),\n      utm,\n    }\n  })\n}\n\nfunction sumMaps(days: readonly TrafficDay[], pick: (day: TrafficDay) => Record<string, number>): Map<string, number> {\n  const totals = new Map<string, number>()\n  for (const day of days) {\n    for (const [key, count] of Object.entries(pick(day))) totals.set(key, (totals.get(key) ?? 0) + count)\n  }\n  return totals\n}\n\nconst ranked = (totals: Map<string, number>): Array<[string, number]> =>\n  [...totals.entries()].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))\n\nfunction siteReader(\n  base: Omit<PluginFigureReader, 'read' | 'scope' | 'plugin'>,\n  read: (firestore: Firestore, request: PluginFigureRequest & { hostId: string }) => Promise<PluginFigureRead>,\n  firestore: AiFigureFirestore,\n  plugin: string | null,\n): PluginFigureReader {\n  return {\n    ...base,\n    scope: 'site',\n    plugin,\n    read: async (request) => {\n      if (!request.hostId) return refused(400, 'Open a site to read its figures')\n      if (!base.windows.includes(request.days)) return refused(400, 'That window is not one this reader covers')\n      return read(firestore(), { ...request, hostId: request.hostId })\n    },\n  }\n}\n\nexport function trafficFigureReaders(firestore: AiFigureFirestore): PluginFigureReader[] {\n  const source = { label: 'Analytics', path: 'analytics' }\n  const visitorsNote =\n    'Visitors are counted once per browser tab per day, so one person on two days counts twice.'\n  return [\n    siteReader(\n      {\n        id: 'traffic.summary',\n        label: 'Traffic',\n        description:\n          'Page views, visitors and views a day on the site over the window, each beside the window before it and the change.',\n        windows: AI_TRAFFIC_WINDOWS,\n      },\n      async (db, request) => {\n        const ids = dayIds(request.now, request.days)\n        const [current, previous] = await Promise.all([\n          readTrafficDays(db, request.hostId, ids.current),\n          readTrafficDays(db, request.hostId, ids.previous),\n        ])\n        const total = (days: TrafficDay[]) => days.reduce((sum, day) => sum + day.total, 0)\n        const visitors = (days: TrafficDay[]) => days.reduce((sum, day) => sum + day.visitors, 0)\n        const views = total(current)\n        const viewsBefore = total(previous)\n        const perDay = Math.round(views / request.days)\n        const perDayBefore = Math.round(viewsBefore / request.days)\n        const table: PluginFigureTable = {\n          title: 'Traffic',\n          source,\n          period: periodOf(request),\n          columns: [\n            { key: 'figure', label: 'Figure', kind: 'text' },\n            { key: 'current', label: 'This window', kind: 'count' },\n            { key: 'previous', label: 'Window before', kind: 'count' },\n            { key: 'change', label: 'Change', kind: 'change' },\n          ],\n          rows: [\n            { figure: 'Page views', current: views, previous: viewsBefore, change: pluginFigureChange(views, viewsBefore) },\n            {\n              figure: 'Visitors',\n              current: visitors(current),\n              previous: visitors(previous),\n              change: pluginFigureChange(visitors(current), visitors(previous)),\n            },\n            {\n              figure: 'Page views a day',\n              current: perDay,\n              previous: perDayBefore,\n              change: pluginFigureChange(perDay, perDayBefore),\n            },\n          ],\n          omitted: 0,\n          notes: [\n            visitorsNote,\n            ...(viewsBefore ? [] : ['The window before this one recorded no page views, so there is no change to compare.']),\n          ],\n        }\n        return { ok: true, table }\n      },\n      firestore,\n      null,\n    ),\n    siteReader(\n      {\n        id: 'traffic.pages',\n        label: 'Top pages',\n        description: `The site's ${AI_TRAFFIC_TOP_PAGES} most viewed pages over the window, with each page's share of all views and its change from the window before.`,\n        windows: AI_TRAFFIC_WINDOWS,\n      },\n      async (db, request) => {\n        const ids = dayIds(request.now, request.days)\n        const [current, previous] = await Promise.all([\n          readTrafficDays(db, request.hostId, ids.current),\n          readTrafficDays(db, request.hostId, ids.previous),\n        ])\n        const now = ranked(sumMaps(current, (day) => day.paths))\n        const before = sumMaps(previous, (day) => day.paths)\n        const all = now.reduce((sum, [, count]) => sum + count, 0)\n        const rows: PluginFigureRow[] = now.slice(0, AI_TRAFFIC_TOP_PAGES).map(([path, views]) => ({\n          page: path,\n          views,\n          share: share(views, all),\n          change: pluginFigureChange(views, before.get(path) ?? null),\n        }))\n        return {\n          ok: true,\n          table: {\n            title: 'Top pages',\n            source,\n            period: periodOf(request),\n            columns: [\n              { key: 'page', label: 'Page', kind: 'text' },\n              { key: 'views', label: 'Views', kind: 'count' },\n              { key: 'share', label: 'Share of views', kind: 'percent' },\n              { key: 'change', label: 'Change', kind: 'change' },\n            ],\n            rows,\n            omitted: Math.max(0, now.length - rows.length),\n            notes: [],\n          },\n        }\n      },\n      firestore,\n      null,\n    ),\n    siteReader(\n      {\n        id: 'traffic.sources',\n        label: 'Traffic sources',\n        description:\n          'Where visits came from over the window: the referring sites, and the campaign sources and campaigns links were tagged with, with each one’s views.',\n        windows: AI_TRAFFIC_WINDOWS,\n      },\n      async (db, request) => {\n        const days = await readTrafficDays(db, request.hostId, dayIds(request.now, request.days).current)\n        const all = days.reduce((sum, day) => sum + day.total, 0)\n        const referrers = ranked(sumMaps(days, (day) => day.referrers))\n        const sources = ranked(sumMaps(days, (day) => day.utm['source'] ?? {}))\n        const campaigns = ranked(sumMaps(days, (day) => day.utm['campaign'] ?? {}))\n        const rowsOf = (entries: Array<[string, number]>, limit: number, type: string) =>\n          entries.slice(0, limit).map(([name, views]) => ({ source: name, type, views, share: share(views, all) }))\n        const rows = [\n          ...rowsOf(referrers, AI_TRAFFIC_TOP_REFERRERS, 'Referring site'),\n          ...rowsOf(sources, AI_TRAFFIC_TOP_CAMPAIGNS, 'Campaign source'),\n          ...rowsOf(campaigns, AI_TRAFFIC_TOP_CAMPAIGNS, 'Campaign'),\n        ]\n        return {\n          ok: true,\n          table: {\n            title: 'Traffic sources',\n            source,\n            period: periodOf(request),\n            columns: [\n              { key: 'source', label: 'Source', kind: 'text' },\n              { key: 'type', label: 'Kind', kind: 'text' },\n              { key: 'views', label: 'Views', kind: 'count' },\n              { key: 'share', label: 'Share of all views', kind: 'percent' },\n            ],\n            rows,\n            omitted:\n              Math.max(0, referrers.length - AI_TRAFFIC_TOP_REFERRERS) +\n              Math.max(0, sources.length - AI_TRAFFIC_TOP_CAMPAIGNS) +\n              Math.max(0, campaigns.length - AI_TRAFFIC_TOP_CAMPAIGNS),\n            notes: ['A visit with no referring site, such as a typed address, is in no row.'],\n          },\n        }\n      },\n      firestore,\n      null,\n    ),\n    siteReader(\n      {\n        id: 'traffic.daily',\n        label: 'Traffic by day',\n        description: 'Page views and visitors on each day of the window, oldest first, for spotting a day that stood out.',\n        windows: AI_TRAFFIC_DAILY_WINDOWS,\n      },\n      async (db, request) => {\n        const ids = [...dayIds(request.now, request.days).current].reverse()\n        const days = await readTrafficDays(db, request.hostId, ids)\n        return {\n          ok: true,\n          table: {\n            title: 'Traffic by day',\n            source,\n            period: periodOf(request),\n            columns: [\n              { key: 'day', label: 'Day', kind: 'date' },\n              { key: 'views', label: 'Page views', kind: 'count' },\n              { key: 'visitors', label: 'Visitors', kind: 'count' },\n            ],\n            rows: days.map((day, index) => ({ day: ids[index], views: day.total, visitors: day.visitors })),\n            omitted: 0,\n            notes: [visitorsNote],\n          },\n        }\n      },\n      firestore,\n      null,\n    ),\n  ]\n}\n\n// ── Forms ─────────────────────────────────────────────────────────────────\n\nexport function formsFigureReader(firestore: AiFigureFirestore): PluginFigureReader {\n  return siteReader(\n    {\n      id: 'forms.performance',\n      label: 'Forms',\n      description:\n        'Each form’s views, submissions, the share of views that became a submission, and leads, over the calendar months the window falls in.',\n      windows: AI_TRAFFIC_WINDOWS,\n    },\n    async (db, request) => {\n      const { current } = pluginFigureWindows(request.now, request.days)\n      const from = formPeriodKey(current.startMs)\n      const to = formPeriodKey(current.endMs - 1)\n      const snapshot = await db\n        .collection('hosts')\n        .doc(request.hostId)\n        .collection('forms')\n        .limit(AI_FORMS_READ_LIMIT)\n        .get()\n      const forms = snapshot.docs\n        .map((doc) => ({ doc, data: (doc.data() ?? {}) as Record<string, unknown> }))\n        .filter(({ data }) => !data['deletedAt'])\n        .map(({ doc, data }) => {\n          const totals = formStatsTotals(data['stats'] as FormStats | undefined, { from, to })\n          // Every submission to a form is counted on it, so a form with none\n          // recorded in the window had none: 0, not a blank the answer has to\n          // hedge over (AGL-3834). Leads are counted only on a form that\n          // routes them, so one that does reads 0 the same way, and a form\n          // that never has keeps a blank, which the table's note explains.\n          const submissions = totals.submissions ?? 0\n          const routesLeads = (data['routing'] as { lead?: unknown } | undefined)?.lead === true\n          return {\n            form: str(data['displayName']) || doc.id,\n            views: totals.views,\n            submissions,\n            completion: totals.views ? share(submissions, totals.views) : null,\n            leads: totals.leads ?? (routesLeads ? 0 : null),\n          }\n        })\n        .sort((a, b) => b.submissions - a.submissions || a.form.localeCompare(b.form))\n      const monthStart = from ? `${from}-01` : current.from\n      return {\n        ok: true,\n        table: {\n          title: 'Forms',\n          source: { label: 'Forms', path: 'forms' },\n          period: {\n            from: monthStart,\n            to: current.to,\n            days: Math.round((Date.parse(current.to) - Date.parse(monthStart)) / 86_400_000) + 1,\n          },\n          columns: [\n            { key: 'form', label: 'Form', kind: 'text' },\n            { key: 'views', label: 'Views', kind: 'count' },\n            { key: 'submissions', label: 'Submissions', kind: 'count' },\n            { key: 'completion', label: 'Views that became a submission', kind: 'percent' },\n            { key: 'leads', label: 'Leads', kind: 'count' },\n          ],\n          rows: forms.slice(0, PLUGIN_FIGURE_MAX_ROWS),\n          omitted: Math.max(0, forms.length - PLUGIN_FIGURE_MAX_ROWS),\n          notes: [\n            'Form figures are kept by calendar month, so they cover whole months from the first day of the month the window starts in.',\n            'Views are counted in the visitor’s browser and submissions on the server, so a rate can pass 100%.',\n            'A blank Leads figure means the form does not add its submissions to Leads.',\n          ],\n        },\n      }\n    },\n    firestore,\n    'forms',\n  )\n}\n\n/** Every reader this plugin registers, for the platform's own records. */\nexport function aiFigureReaders(firestore: AiFigureFirestore): PluginFigureReader[] {\n  return [...trafficFigureReaders(firestore), formsFigureReader(firestore)]\n}\n\n/**\n * Registers them from the console surface, the one surface that runs insight\n * jobs. By a call, never by an import (AGL-3025).\n */\nexport function registerAiFigureReaders(firestore: AiFigureFirestore): void {\n  for (const reader of aiFigureReaders(firestore)) {\n    registerPluginFigureReader(reader, { pluginId: AI_PLUGIN_ID })\n  }\n}\n"],"names":["formPeriodKey","formStatsTotals","PLUGIN_FIGURE_MAX_ROWS","pluginFigureChange","pluginFigureDay","pluginFigureWindows","registerPluginFigureReader","AI_PLUGIN_ID","AI_TRAFFIC_WINDOWS","AI_TRAFFIC_DAILY_WINDOWS","AI_TRAFFIC_TOP_PAGES","AI_TRAFFIC_TOP_REFERRERS","AI_TRAFFIC_TOP_CAMPAIGNS","AI_FORMS_READ_LIMIT","str","value","trim","num","parsed","Number","isFinite","round1","Math","round","share","part","whole","refused","status","error","ok","periodOf","request","current","now","days","from","to","dayIds","previous","walk","startMs","endMs","ids","at","push","Date","counts","out","key","count","Object","entries","n","readTrafficDays","firestore","hostId","length","collection","doc","snapshots","getAll","map","id","snapshot","data","exists","utm","param","values","total","visitors","paths","referrers","sumMaps","pick","totals","Map","day","set","get","ranked","sort","a","b","localeCompare","siteReader","base","read","plugin","scope","windows","includes","trafficFigureReaders","source","label","path","visitorsNote","description","db","Promise","all","reduce","sum","views","viewsBefore","perDay","perDayBefore","table","title","period","columns","kind","rows","figure","change","omitted","notes","before","slice","page","max","sources","campaigns","rowsOf","limit","type","name","reverse","index","formsFigureReader","forms","docs","filter","submissions","routesLeads","lead","form","completion","leads","monthStart","parse","aiFigureReaders","registerAiFigureReaders","reader","pluginId"],"mappings":"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"}

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

@@ -77,6 +77,13 @@ export declare const AI_BUILD_MAX_PASSES: number;
 export declare function aiBuildUnitJobKind(unit: AiBuildUnit, ops: AiBuildOps): AiJobKind | null;
 /** What the job drawer says under an item another plugin's writer made (`model/ai-build-job.ts`). */
 export { aiBuildItemOutputNote };
+/**
+ * An item's arguments without the list entries that link what this build
+ * could not make (AGL-3832): a menu's `About => new:About` once the page
+ * About failed. The item is built with the rest, and its note names what it
+ * is without, so its own report never shows a `new:` reference.
+ */
+export declare function aiBuildItemArgsWithout(args: Readonly<Record<string, unknown>>, dropped: ReadonlySet<string> | undefined): Record<string, unknown>;
 /** The id a unit's job, and so its draft, is named by. */
 export declare function aiBuildUnitJobId(job: Pick<AiJob, '$id'>, unit: AiBuildUnit): string;
 /**
@@ -92,6 +99,8 @@ export declare function aiBuildUnitJob(job: AiJob, unit: AiBuildUnit, context: {
     ledger: readonly AiJobItemLedger[];
     ops: AiBuildOps;
     briefLines?: readonly string[];
+    /** The `new:` names, lowercased, of what failed and the unit is built without (`aiBuildDegradation`). */
+    dropped?: ReadonlySet<string>;
 }): AiJob;
 export interface AiJobBuildStepDeps {
     /** The runner registry; specs hand in fakes. */

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

@@ -17,7 +17,7 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  */ import { aiJobCancelAsked } from "./ai-job-cancel.js";
 import { resolveEffectivePlan } from "@aglyn/aglyn/app-utils/plan-entitlements";
 import { resolveOrgIdForHost } from "@aglyn/tenant-data-admin/server/organizations";
-import { AI_BUILD_LIMITS, AI_BUILD_MADE_INPUT, AI_BUILD_PUBLISH_INPUT, aiArticle, aiBuildCreditRange, aiBuildDegradation, aiBuildInitialLedger, aiBuildItemDelivered, aiBuildItemOpen, aiBuildNextUnit, aiBuildOrder, aiBuildItemOutputNote, aiBuildPlacedItemLines, aiBuildPlanMissingInput, aiBuildPlanShapeRefusal, aiBuildSmaller, aiBuildUnits } from "../model/ai-build-job.js";
+import { AI_BUILD_LIMITS, AI_BUILD_MADE_INPUT, AI_BUILD_PUBLISH_INPUT, aiArticle, aiBuildCreditRange, aiBuildDegradation, aiBuildInitialLedger, aiBuildItemArgRefs, aiBuildItemDelivered, aiBuildItemOpen, aiBuildNextUnit, aiBuildOrder, aiBuildItemOutputNote, aiBuildPlacedItemLines, aiBuildPlanMissingInput, aiBuildPlanShapeRefusal, aiBuildRefName, aiBuildSmaller, aiBuildUnits } from "../model/ai-build-job.js";
 import { isAiPlanNewRef } from "../model/ai-build-plan.js";
 import { AI_SITE_MAX_SECTIONS } from "../model/ai-site-job.js";
 import { AI_CREDITS_CONFIRM_CODE, aiCreditsPromptFor, aiCreditsPromptText } from "../model/ai-credit-estimate.js";
@@ -99,6 +99,21 @@ import { AI_PLANNED_JOB_KINDS, aiJobStepRunMinimumMs, aiJobStepRunnerFor, regist
     return runnerKind ? runnerKind : null;
 }
 /** What the job drawer says under an item another plugin's writer made (`model/ai-build-job.ts`). */ export { aiBuildItemOutputNote };
+/**
+ * An item's arguments without the list entries that link what this build
+ * could not make (AGL-3832): a menu's `About => new:About` once the page
+ * About failed. The item is built with the rest, and its note names what it
+ * is without, so its own report never shows a `new:` reference.
+ */ export function aiBuildItemArgsWithout(args, dropped) {
+    if (!(dropped == null ? void 0 : dropped.size)) return _extends({}, args);
+    const links = (entry)=>aiBuildItemArgRefs({
+            entry
+        }).some((ref)=>dropped.has(aiBuildRefName(ref)));
+    return Object.fromEntries(Object.entries(args).map(([key, value])=>[
+            key,
+            Array.isArray(value) ? value.filter((entry)=>!links(entry)) : value
+        ]));
+}
 /** The id a unit's job, and so its draft, is named by. */ export function aiBuildUnitJobId(job, unit) {
     var _ref, _ref1, _ref2;
     var _unit_creation, _unit_screen, _unit_item;
@@ -199,7 +214,7 @@ import { AI_PLANNED_JOB_KINDS, aiJobStepRunMinimumMs, aiJobStepRunnerFor, regist
         ] : [];
     }
     brief.push(...(_context_briefLines = context.briefLines) != null ? _context_briefLines : []);
-    const inputs = _extends({}, job.inputs, (_ref = item == null ? void 0 : item.args) != null ? _ref : {}, {
+    const inputs = _extends({}, job.inputs, aiBuildItemArgsWithout((_ref = item == null ? void 0 : item.args) != null ? _ref : {}, context.dropped), {
         originJobId: aiOriginJobId(job)
     });
     delete inputs[AI_BUILD_PUBLISH_INPUT];
@@ -848,7 +863,8 @@ export function createAiJobBuildStep(deps = {}) {
             units,
             ledger,
             ops,
-            briefLines: degradation.briefLines
+            briefLines: degradation.briefLines,
+            dropped: degradation.dropped
         });
         // An item's kind is asked its own admission first (a campaign's plan,
         // a template's subject), once, before its first pass.