@aglyn/aglyn 1.0.0-beta.217 → 1.0.0-beta.219

package/src/lib/app-utils/docs-retrieval.d.ts

@@ -14,11 +14,11 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { type AssistDocsSection } from './docs-index.generated';
+import { type DocsSection } from './docs-index.generated';
 /** Lowercase word tokens, stop words removed, length >= 2. */
 export declare function tokenize(text: string): string[];
 export interface ScoredSection {
-    section: AssistDocsSection;
+    section: DocsSection;
     score: number;
 }
 /**
@@ -26,7 +26,7 @@ export interface ScoredSection {
  * nothing scores above zero — the caller then answers without docs grounding
  * rather than citing an irrelevant page.
  */
-export declare function retrieveDocsSections(question: string, limit?: number, sections?: readonly AssistDocsSection[]): ScoredSection[];
+export declare function retrieveDocsSections(question: string, limit?: number, sections?: readonly DocsSection[]): ScoredSection[];
 export declare function docsDocumentFrequency(): {
     frequency: ReadonlyMap<string, number>;
     sections: number;

package/src/lib/app-utils/docs-retrieval.js

@@ -13,14 +13,18 @@
  * 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 { ASSIST_DOCS_INDEX } from "./docs-index.generated.js";
+ */ import { DOCS_SECTION_INDEX } from "./docs-index.generated.js";
 import { DOCS_BASE_URL } from "./docs-help.js";
 /**
- * Lexical docs retrieval for Aglyn Assist (AGL-1860, phase 1) — deliberately
- * no vector store: a BM25-flavoured term-frequency score over the generated
- * docs section index, with title/heading term boosts. Good enough to ground
- * "how do I…" answers in the right docs section and cheap enough to run on
- * every message inside the API route.
+ * Lexical docs search (AGL-1860, phase 1) — deliberately no vector store: a
+ * BM25-flavoured term-frequency score over the generated docs section index,
+ * with title/heading term boosts. Good enough to find the right docs section
+ * for a "how do I…" question and cheap enough to run on every request inside
+ * an API route.
+ *
+ * The platform's, and named so (AGL-3080): the console's issue reports
+ * deflect to it with no model involved, and the AI plugin grounds its answers
+ * in it — one reader among others, not its owner.
  */ /** Words too common in this corpus to carry signal. */ const STOP_WORDS = new Set([
     'a',
     'an',
@@ -97,12 +101,12 @@ function buildIndex(sections) {
  * Top-`limit` docs sections for a user question. Returns an empty array when
  * nothing scores above zero — the caller then answers without docs grounding
  * rather than citing an irrelevant page.
- */ export function retrieveDocsSections(question, limit = 6, sections = ASSIST_DOCS_INDEX) {
+ */ export function retrieveDocsSections(question, limit = 6, sections = DOCS_SECTION_INDEX) {
     const queryTokens = [
         ...new Set(tokenize(question))
     ];
     if (!queryTokens.length) return [];
-    const index = sections === ASSIST_DOCS_INDEX ? indexed != null ? indexed : indexed = buildIndex(sections) : buildIndex(sections);
+    const index = sections === DOCS_SECTION_INDEX ? indexed != null ? indexed : indexed = buildIndex(sections) : buildIndex(sections);
     return index.map((entry)=>({
             section: entry.section,
             score: scoreSection(entry.section, queryTokens, entry.bodyTokenCounts, entry.titleTokens, entry.headingTokens)
@@ -124,7 +128,7 @@ function buildIndex(sections) {
  */ let documentFrequency = null;
 export function docsDocumentFrequency() {
     if (!documentFrequency) {
-        const index = indexed != null ? indexed : indexed = buildIndex(ASSIST_DOCS_INDEX);
+        const index = indexed != null ? indexed : indexed = buildIndex(DOCS_SECTION_INDEX);
         const frequency = new Map();
         for (const entry of index){
             const seen = new Set([
@@ -141,7 +145,7 @@ export function docsDocumentFrequency() {
     }
     return {
         frequency: documentFrequency,
-        sections: ASSIST_DOCS_INDEX.length
+        sections: DOCS_SECTION_INDEX.length
     };
 }
 /**

package/src/lib/app-utils/docs-retrieval.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/docs-retrieval.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  ASSIST_DOCS_INDEX,\n  type AssistDocsSection,\n} from './docs-index.generated'\nimport { DOCS_BASE_URL } from './docs-help'\n\n/**\n * Lexical docs retrieval for Aglyn Assist (AGL-1860, phase 1) — deliberately\n * no vector store: a BM25-flavoured term-frequency score over the generated\n * docs section index, with title/heading term boosts. Good enough to ground\n * \"how do I…\" answers in the right docs section and cheap enough to run on\n * every message inside the API route.\n */\n\n/** Words too common in this corpus to carry signal. */\nconst STOP_WORDS = new Set([\n  'a', 'an', 'and', 'are', 'as', 'at', 'be', 'by', 'can', 'do', 'does',\n  'for', 'from', 'how', 'i', 'in', 'is', 'it', 'my', 'of', 'on', 'or',\n  'that', 'the', 'this', 'to', 'what', 'when', 'where', 'which', 'why',\n  'with', 'you', 'your',\n])\n\n/** Lowercase word tokens, stop words removed, length >= 2. */\nexport function tokenize(text: string): string[] {\n  return (text.toLowerCase().match(/[\\p{L}\\p{N}]{2,}/gu) ?? []).filter(\n    (token) => !STOP_WORDS.has(token),\n  )\n}\n\nexport interface ScoredSection {\n  section: AssistDocsSection\n  score: number\n}\n\n/**\n * Score one section against query tokens. Term frequency saturates quickly\n * (BM25-ish k=1.2) so one section mentioning \"domain\" ten times does not\n * drown a section about the actual task; title and heading hits carry\n * dedicated boosts because those are the docs' own statement of topic.\n */\nfunction scoreSection(\n  section: AssistDocsSection,\n  queryTokens: readonly string[],\n  bodyTokenCounts: Map<string, number>,\n  titleTokens: Set<string>,\n  headingTokens: Set<string>,\n): number {\n  let score = 0\n  for (const token of queryTokens) {\n    const tf = bodyTokenCounts.get(token) ?? 0\n    if (tf > 0) score += (tf * 2.2) / (tf + 1.2)\n    if (titleTokens.has(token)) score += 2.5\n    if (headingTokens.has(token)) score += 2\n  }\n  return score\n}\n\ninterface IndexedSection {\n  section: AssistDocsSection\n  bodyTokenCounts: Map<string, number>\n  titleTokens: Set<string>\n  headingTokens: Set<string>\n}\n\n/** Tokenized once per process — module scope, ~650 sections. */\nlet indexed: IndexedSection[] | null = null\n\nfunction buildIndex(sections: readonly AssistDocsSection[]): IndexedSection[] {\n  return sections.map((section) => {\n    const bodyTokenCounts = new Map<string, number>()\n    for (const token of tokenize(section.text)) {\n      bodyTokenCounts.set(token, (bodyTokenCounts.get(token) ?? 0) + 1)\n    }\n    return {\n      section,\n      bodyTokenCounts,\n      titleTokens: new Set(tokenize(section.title)),\n      headingTokens: new Set(tokenize(section.heading)),\n    }\n  })\n}\n\n/**\n * Top-`limit` docs sections for a user question. Returns an empty array when\n * nothing scores above zero — the caller then answers without docs grounding\n * rather than citing an irrelevant page.\n */\nexport function retrieveDocsSections(\n  question: string,\n  limit = 6,\n  sections: readonly AssistDocsSection[] = ASSIST_DOCS_INDEX,\n): ScoredSection[] {\n  const queryTokens = [...new Set(tokenize(question))]\n  if (!queryTokens.length) return []\n  const index =\n    sections === ASSIST_DOCS_INDEX\n      ? (indexed ??= buildIndex(sections))\n      : buildIndex(sections)\n  return index\n    .map((entry) => ({\n      section: entry.section,\n      score: scoreSection(\n        entry.section,\n        queryTokens,\n        entry.bodyTokenCounts,\n        entry.titleTokens,\n        entry.headingTokens,\n      ),\n    }))\n    .filter((scored) => scored.score > 0)\n    .sort((a, b) => b.score - a.score)\n    .slice(0, limit)\n}\n\n/**\n * How many indexed sections each token appears in — the raw material for an\n * IDF weight (AGL-2486).\n *\n * Lives here rather than in the deflection module because the tokenized index\n * is already built here and rebuilding it there would tokenize ~500KB of docs\n * a second time, per process, to reach the same numbers. Memoised alongside\n * `indexed` and derived from it, so the two can never disagree about what a\n * token is.\n *\n * Counts SECTIONS, not pages: a term confined to one page but repeated in\n * every section of it is still a specific term, and page-level counting would\n * flatten exactly the distinction the weight exists to make.\n */\nlet documentFrequency: Map<string, number> | null = null\n\nexport function docsDocumentFrequency(): {\n  frequency: ReadonlyMap<string, number>\n  sections: number\n} {\n  if (!documentFrequency) {\n    const index = (indexed ??= buildIndex(ASSIST_DOCS_INDEX))\n    const frequency = new Map<string, number>()\n    for (const entry of index) {\n      const seen = new Set<string>([\n        ...entry.bodyTokenCounts.keys(),\n        ...entry.titleTokens,\n        ...entry.headingTokens,\n      ])\n      for (const token of seen) {\n        frequency.set(token, (frequency.get(token) ?? 0) + 1)\n      }\n    }\n    documentFrequency = frequency\n  }\n  return { frequency: documentFrequency, sections: ASSIST_DOCS_INDEX.length }\n}\n\n/**\n * Public docs-site origin for deep links the assistant hands the user.\n *\n * Configurable (AGL-2016): a self-hoster who publishes the `apps/docs` site on\n * their own domain otherwise had every Assist citation deep-link into\n * `docs.aglyn.com` — our documentation, describing our deployment's flags and\n * plans, cited as if it were theirs.\n *\n * Unlike the operator CONTACT values this keeps our value as the default, and\n * the difference is deliberate: an unset citation origin degrades to a page\n * that genuinely exists and is genuinely about this software, so it is wrong\n * in the way a stale bookmark is wrong. An unset contact address would\n * misroute a legal notice, which is why that one refuses to guess.\n *\n * ⚠️ RE-EXPORTED FROM `DOCS_BASE_URL` RATHER THAN READ AGAIN HERE (AGL-2014).\n * This module had its own `process.env.NEXT_PUBLIC_DOCS_ORIGIN || 'https://\n * docs.aglyn.com'`, which accepted ONLY the canonical name — while\n * `constants/docs-links.ts` also honours the older `NEXT_PUBLIC_AGLYN_DOCS_URL`.\n * So AGL-2186's own defect survived, inverted, in the one file it did not\n * touch: a deployment configured under the older name retargeted every console\n * and besigner help link and left every ASSIST CITATION pointing at\n * `docs.aglyn.com` — our documentation, cited inside their product as theirs.\n * That is the same \"one value, two env names\" split AGL-733 is the record of.\n * One reader means an operator's docs site cannot be honoured on some surfaces\n * and ignored on others.\n */\nexport const DOCS_SITE_ORIGIN = DOCS_BASE_URL\n\n/**\n * The grounding block injected into the system prompt: the retrieved\n * sections, each with its citable URL, wrapped so the model can quote and\n * link them. Kept AFTER the stable system prefix so prompt caching of the\n * static prefix survives per-question variation.\n */\nexport function docsGroundingBlock(scored: readonly ScoredSection[]): string {\n  if (!scored.length) return ''\n  const parts = scored.map(({ section }) => {\n    const url = `${DOCS_SITE_ORIGIN}${section.path}${section.anchor}`\n    const heading = section.heading\n      ? `${section.title} — ${section.heading}`\n      : section.title\n    return `<doc url=\"${url}\" title=\"${heading}\">\\n${section.text}\\n</doc>`\n  })\n  return `\\n\\nRelevant documentation sections (cite these URLs when they answer the question):\\n${parts.join('\\n')}`\n}\n"],"names":["ASSIST_DOCS_INDEX","DOCS_BASE_URL","STOP_WORDS","Set","tokenize","text","toLowerCase","match","filter","token","has","scoreSection","section","queryTokens","bodyTokenCounts","titleTokens","headingTokens","score","tf","get","indexed","buildIndex","sections","map","Map","set","title","heading","retrieveDocsSections","question","limit","length","index","entry","scored","sort","a","b","slice","documentFrequency","docsDocumentFrequency","frequency","seen","keys","DOCS_SITE_ORIGIN","docsGroundingBlock","parts","url","path","anchor","join"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,iBAAiB,QAEZ,4BAAwB;AAC/B,SAASC,aAAa,QAAQ,iBAAa;AAE3C;;;;;;CAMC,GAED,qDAAqD,GACrD,MAAMC,aAAa,IAAIC,IAAI;IACzB;IAAK;IAAM;IAAO;IAAO;IAAM;IAAM;IAAM;IAAM;IAAO;IAAM;IAC9D;IAAO;IAAQ;IAAO;IAAK;IAAM;IAAM;IAAM;IAAM;IAAM;IAAM;IAC/D;IAAQ;IAAO;IAAQ;IAAM;IAAQ;IAAQ;IAAS;IAAS;IAC/D;IAAQ;IAAO;CAChB;AAED,4DAA4D,GAC5D,OAAO,SAASC,SAASC,IAAY;QAC3BA;IAAR,OAAO,EAACA,0BAAAA,KAAKC,WAAW,GAAGC,KAAK,CAAC,4naAAzBF,0BAAkD,EAAE,EAAEG,MAAM,CAClE,CAACC,QAAU,CAACP,WAAWQ,GAAG,CAACD;AAE/B;AAOA;;;;;CAKC,GACD,SAASE,aACPC,OAA0B,EAC1BC,WAA8B,EAC9BC,eAAoC,EACpCC,WAAwB,EACxBC,aAA0B;IAE1B,IAAIC,QAAQ;IACZ,KAAK,MAAMR,SAASI,YAAa;YACpBC;QAAX,MAAMI,MAAKJ,uBAAAA,gBAAgBK,GAAG,CAACV,kBAApBK,uBAA8B;QACzC,IAAII,KAAK,GAAGD,SAAS,AAACC,KAAK,MAAQA,CAAAA,KAAK,GAAE;QAC1C,IAAIH,YAAYL,GAAG,CAACD,QAAQQ,SAAS;QACrC,IAAID,cAAcN,GAAG,CAACD,QAAQQ,SAAS;IACzC;IACA,OAAOA;AACT;AASA,8DAA8D,GAC9D,IAAIG,UAAmC;AAEvC,SAASC,WAAWC,QAAsC;IACxD,OAAOA,SAASC,GAAG,CAAC,CAACX;QACnB,MAAME,kBAAkB,IAAIU;QAC5B,KAAK,MAAMf,SAASL,SAASQ,QAAQP,IAAI,EAAG;gBACdS;YAA5BA,gBAAgBW,GAAG,CAAChB,OAAO,EAACK,uBAAAA,gBAAgBK,GAAG,CAACV,kBAApBK,uBAA8B,KAAK;QACjE;QACA,OAAO;YACLF;YACAE;YACAC,aAAa,IAAIZ,IAAIC,SAASQ,QAAQc,KAAK;YAC3CV,eAAe,IAAIb,IAAIC,SAASQ,QAAQe,OAAO;QACjD;IACF;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASC,qBACdC,QAAgB,EAChBC,QAAQ,CAAC,EACTR,WAAyCtB,iBAAiB;IAE1D,MAAMa,cAAc;WAAI,IAAIV,IAAIC,SAASyB;KAAW;IACpD,IAAI,CAAChB,YAAYkB,MAAM,EAAE,OAAO,EAAE;IAClC,MAAMC,QACJV,aAAatB,oBACRoB,kBAAAA,UAAAA,UAAYC,WAAWC,YACxBD,WAAWC;IACjB,OAAOU,MACJT,GAAG,CAAC,CAACU,QAAW,CAAA;YACfrB,SAASqB,MAAMrB,OAAO;YACtBK,OAAON,aACLsB,MAAMrB,OAAO,EACbC,aACAoB,MAAMnB,eAAe,EACrBmB,MAAMlB,WAAW,EACjBkB,MAAMjB,aAAa;QAEvB,CAAA,GACCR,MAAM,CAAC,CAAC0B,SAAWA,OAAOjB,KAAK,GAAG,GAClCkB,IAAI,CAAC,CAACC,GAAGC,IAAMA,EAAEpB,KAAK,GAAGmB,EAAEnB,KAAK,EAChCqB,KAAK,CAAC,GAAGR;AACd;AAEA;;;;;;;;;;;;;CAaC,GACD,IAAIS,oBAAgD;AAEpD,OAAO,SAASC;IAId,IAAI,CAACD,mBAAmB;QACtB,MAAMP,QAASZ,kBAAAA,UAAAA,UAAYC,WAAWrB;QACtC,MAAMyC,YAAY,IAAIjB;QACtB,KAAK,MAAMS,SAASD,MAAO;YACzB,MAAMU,OAAO,IAAIvC,IAAY;mBACxB8B,MAAMnB,eAAe,CAAC6B,IAAI;mBAC1BV,MAAMlB,WAAW;mBACjBkB,MAAMjB,aAAa;aACvB;YACD,KAAK,MAAMP,SAASiC,KAAM;oBACFD;gBAAtBA,UAAUhB,GAAG,CAAChB,OAAO,EAACgC,iBAAAA,UAAUtB,GAAG,CAACV,kBAAdgC,iBAAwB,KAAK;YACrD;QACF;QACAF,oBAAoBE;IACtB;IACA,OAAO;QAAEA,WAAWF;QAAmBjB,UAAUtB,kBAAkB+B,MAAM;IAAC;AAC5E;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;CAyBC,GACD,OAAO,MAAMa,mBAAmB3C,cAAa;AAE7C;;;;;CAKC,GACD,OAAO,SAAS4C,mBAAmBX,MAAgC;IACjE,IAAI,CAACA,OAAOH,MAAM,EAAE,OAAO;IAC3B,MAAMe,QAAQZ,OAAOX,GAAG,CAAC,CAAC,EAAEX,OAAO,EAAE;QACnC,MAAMmC,MAAM,GAAGH,mBAAmBhC,QAAQoC,IAAI,GAAGpC,QAAQqC,MAAM,EAAE;QACjE,MAAMtB,UAAUf,QAAQe,OAAO,GAC3B,GAAGf,QAAQc,KAAK,CAAC,GAAG,EAAEd,QAAQe,OAAO,EAAE,GACvCf,QAAQc,KAAK;QACjB,OAAO,CAAC,UAAU,EAAEqB,IAAI,SAAS,EAAEpB,QAAQ,IAAI,EAAEf,QAAQP,IAAI,CAAC,QAAQ,CAAC;IACzE;IACA,OAAO,CAAC,sFAAsF,EAAEyC,MAAMI,IAAI,CAAC,OAAO;AACpH"}
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/docs-retrieval.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  DOCS_SECTION_INDEX,\n  type DocsSection,\n} from './docs-index.generated'\nimport { DOCS_BASE_URL } from './docs-help'\n\n/**\n * Lexical docs search (AGL-1860, phase 1) — deliberately no vector store: a\n * BM25-flavoured term-frequency score over the generated docs section index,\n * with title/heading term boosts. Good enough to find the right docs section\n * for a \"how do I…\" question and cheap enough to run on every request inside\n * an API route.\n *\n * The platform's, and named so (AGL-3080): the console's issue reports\n * deflect to it with no model involved, and the AI plugin grounds its answers\n * in it — one reader among others, not its owner.\n */\n\n/** Words too common in this corpus to carry signal. */\nconst STOP_WORDS = new Set([\n  'a', 'an', 'and', 'are', 'as', 'at', 'be', 'by', 'can', 'do', 'does',\n  'for', 'from', 'how', 'i', 'in', 'is', 'it', 'my', 'of', 'on', 'or',\n  'that', 'the', 'this', 'to', 'what', 'when', 'where', 'which', 'why',\n  'with', 'you', 'your',\n])\n\n/** Lowercase word tokens, stop words removed, length >= 2. */\nexport function tokenize(text: string): string[] {\n  return (text.toLowerCase().match(/[\\p{L}\\p{N}]{2,}/gu) ?? []).filter(\n    (token) => !STOP_WORDS.has(token),\n  )\n}\n\nexport interface ScoredSection {\n  section: DocsSection\n  score: number\n}\n\n/**\n * Score one section against query tokens. Term frequency saturates quickly\n * (BM25-ish k=1.2) so one section mentioning \"domain\" ten times does not\n * drown a section about the actual task; title and heading hits carry\n * dedicated boosts because those are the docs' own statement of topic.\n */\nfunction scoreSection(\n  section: DocsSection,\n  queryTokens: readonly string[],\n  bodyTokenCounts: Map<string, number>,\n  titleTokens: Set<string>,\n  headingTokens: Set<string>,\n): number {\n  let score = 0\n  for (const token of queryTokens) {\n    const tf = bodyTokenCounts.get(token) ?? 0\n    if (tf > 0) score += (tf * 2.2) / (tf + 1.2)\n    if (titleTokens.has(token)) score += 2.5\n    if (headingTokens.has(token)) score += 2\n  }\n  return score\n}\n\ninterface IndexedSection {\n  section: DocsSection\n  bodyTokenCounts: Map<string, number>\n  titleTokens: Set<string>\n  headingTokens: Set<string>\n}\n\n/** Tokenized once per process — module scope, ~650 sections. */\nlet indexed: IndexedSection[] | null = null\n\nfunction buildIndex(sections: readonly DocsSection[]): IndexedSection[] {\n  return sections.map((section) => {\n    const bodyTokenCounts = new Map<string, number>()\n    for (const token of tokenize(section.text)) {\n      bodyTokenCounts.set(token, (bodyTokenCounts.get(token) ?? 0) + 1)\n    }\n    return {\n      section,\n      bodyTokenCounts,\n      titleTokens: new Set(tokenize(section.title)),\n      headingTokens: new Set(tokenize(section.heading)),\n    }\n  })\n}\n\n/**\n * Top-`limit` docs sections for a user question. Returns an empty array when\n * nothing scores above zero — the caller then answers without docs grounding\n * rather than citing an irrelevant page.\n */\nexport function retrieveDocsSections(\n  question: string,\n  limit = 6,\n  sections: readonly DocsSection[] = DOCS_SECTION_INDEX,\n): ScoredSection[] {\n  const queryTokens = [...new Set(tokenize(question))]\n  if (!queryTokens.length) return []\n  const index =\n    sections === DOCS_SECTION_INDEX\n      ? (indexed ??= buildIndex(sections))\n      : buildIndex(sections)\n  return index\n    .map((entry) => ({\n      section: entry.section,\n      score: scoreSection(\n        entry.section,\n        queryTokens,\n        entry.bodyTokenCounts,\n        entry.titleTokens,\n        entry.headingTokens,\n      ),\n    }))\n    .filter((scored) => scored.score > 0)\n    .sort((a, b) => b.score - a.score)\n    .slice(0, limit)\n}\n\n/**\n * How many indexed sections each token appears in — the raw material for an\n * IDF weight (AGL-2486).\n *\n * Lives here rather than in the deflection module because the tokenized index\n * is already built here and rebuilding it there would tokenize ~500KB of docs\n * a second time, per process, to reach the same numbers. Memoised alongside\n * `indexed` and derived from it, so the two can never disagree about what a\n * token is.\n *\n * Counts SECTIONS, not pages: a term confined to one page but repeated in\n * every section of it is still a specific term, and page-level counting would\n * flatten exactly the distinction the weight exists to make.\n */\nlet documentFrequency: Map<string, number> | null = null\n\nexport function docsDocumentFrequency(): {\n  frequency: ReadonlyMap<string, number>\n  sections: number\n} {\n  if (!documentFrequency) {\n    const index = (indexed ??= buildIndex(DOCS_SECTION_INDEX))\n    const frequency = new Map<string, number>()\n    for (const entry of index) {\n      const seen = new Set<string>([\n        ...entry.bodyTokenCounts.keys(),\n        ...entry.titleTokens,\n        ...entry.headingTokens,\n      ])\n      for (const token of seen) {\n        frequency.set(token, (frequency.get(token) ?? 0) + 1)\n      }\n    }\n    documentFrequency = frequency\n  }\n  return { frequency: documentFrequency, sections: DOCS_SECTION_INDEX.length }\n}\n\n/**\n * Public docs-site origin for deep links the assistant hands the user.\n *\n * Configurable (AGL-2016): a self-hoster who publishes the `apps/docs` site on\n * their own domain otherwise had every Assist citation deep-link into\n * `docs.aglyn.com` — our documentation, describing our deployment's flags and\n * plans, cited as if it were theirs.\n *\n * Unlike the operator CONTACT values this keeps our value as the default, and\n * the difference is deliberate: an unset citation origin degrades to a page\n * that genuinely exists and is genuinely about this software, so it is wrong\n * in the way a stale bookmark is wrong. An unset contact address would\n * misroute a legal notice, which is why that one refuses to guess.\n *\n * ⚠️ RE-EXPORTED FROM `DOCS_BASE_URL` RATHER THAN READ AGAIN HERE (AGL-2014).\n * This module had its own `process.env.NEXT_PUBLIC_DOCS_ORIGIN || 'https://\n * docs.aglyn.com'`, which accepted ONLY the canonical name — while\n * `constants/docs-links.ts` also honours the older `NEXT_PUBLIC_AGLYN_DOCS_URL`.\n * So AGL-2186's own defect survived, inverted, in the one file it did not\n * touch: a deployment configured under the older name retargeted every console\n * and besigner help link and left every ASSIST CITATION pointing at\n * `docs.aglyn.com` — our documentation, cited inside their product as theirs.\n * That is the same \"one value, two env names\" split AGL-733 is the record of.\n * One reader means an operator's docs site cannot be honoured on some surfaces\n * and ignored on others.\n */\nexport const DOCS_SITE_ORIGIN = DOCS_BASE_URL\n\n/**\n * The grounding block injected into the system prompt: the retrieved\n * sections, each with its citable URL, wrapped so the model can quote and\n * link them. Kept AFTER the stable system prefix so prompt caching of the\n * static prefix survives per-question variation.\n */\nexport function docsGroundingBlock(scored: readonly ScoredSection[]): string {\n  if (!scored.length) return ''\n  const parts = scored.map(({ section }) => {\n    const url = `${DOCS_SITE_ORIGIN}${section.path}${section.anchor}`\n    const heading = section.heading\n      ? `${section.title} — ${section.heading}`\n      : section.title\n    return `<doc url=\"${url}\" title=\"${heading}\">\\n${section.text}\\n</doc>`\n  })\n  return `\\n\\nRelevant documentation sections (cite these URLs when they answer the question):\\n${parts.join('\\n')}`\n}\n"],"names":["DOCS_SECTION_INDEX","DOCS_BASE_URL","STOP_WORDS","Set","tokenize","text","toLowerCase","match","filter","token","has","scoreSection","section","queryTokens","bodyTokenCounts","titleTokens","headingTokens","score","tf","get","indexed","buildIndex","sections","map","Map","set","title","heading","retrieveDocsSections","question","limit","length","index","entry","scored","sort","a","b","slice","documentFrequency","docsDocumentFrequency","frequency","seen","keys","DOCS_SITE_ORIGIN","docsGroundingBlock","parts","url","path","anchor","join"],"mappings":"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"}

package/src/lib/app-utils/duplicate-resource.d.ts

@@ -41,7 +41,10 @@ export type DuplicableResourceKind = (typeof DUPLICABLE_RESOURCE_KINDS)[number];
 export declare function isDuplicableResourceKind(value: unknown): value is DuplicableResourceKind;
 /**
  * The kinds that live under a site and are copied by the core server module;
- * the other two belong to the plugins that own their collections.
+ * the other two belong to the plugins that own their collections. A copy is
+ * made by the platform's own recipe for its kinds, and by the recipe the
+ * owning plugin declares beside its collection for the rest (a workflow's,
+ * in `plugins.config.json`); a kind here with neither is refused.
  */
 export declare const DUPLICABLE_HOST_RESOURCE_KINDS: readonly ["screen", "component", "layout", "template", "form", "emailDesign", "workflow"];
 export type DuplicableHostResourceKind = (typeof DUPLICABLE_HOST_RESOURCE_KINDS)[number];

package/src/lib/app-utils/duplicate-resource.js

@@ -49,7 +49,10 @@ export function isDuplicableResourceKind(value) {
 }
 /**
  * The kinds that live under a site and are copied by the core server module;
- * the other two belong to the plugins that own their collections.
+ * the other two belong to the plugins that own their collections. A copy is
+ * made by the platform's own recipe for its kinds, and by the recipe the
+ * owning plugin declares beside its collection for the rest (a workflow's,
+ * in `plugins.config.json`); a kind here with neither is refused.
  */ export const DUPLICABLE_HOST_RESOURCE_KINDS = [
     'screen',
     'component',
@@ -64,7 +67,7 @@ export function isDuplicableHostResourceKind(value) {
 }
 /** The one-line refusal a client shows when the copy is already being made. */ export const DUPLICATE_BUSY_MESSAGE = 'That copy is still being made';
 /** What a person calls one of each, in the dialog and the feed. */ export const DUPLICABLE_RESOURCE_NOUNS = {
-    screen: 'screen',
+    screen: 'page',
     component: 'component',
     layout: 'layout',
     template: 'template',
@@ -86,11 +89,11 @@ export function isDuplicableHostResourceKind(value) {
     component: [
         'The definition and its properties',
         'The latest version as a new draft',
-        'No instances — screens keep pointing at the original'
+        'No instances — pages keep pointing at the original'
     ],
     layout: [
         'The latest version, with its full element tree and properties',
-        'A new draft — no screen uses the copy yet'
+        'A new draft — no page uses the copy yet'
     ],
     template: [
         'The element tree, placeholders and properties',

package/src/lib/app-utils/duplicate-resource.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/duplicate-resource.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\n/**\n * Duplicating a resource whole (AGL-2936): the catalog every surface reads.\n *\n * One list of the kinds that can be copied, what a copy is called, how its\n * name and slug are made unique, and the activity code the copy writes —\n * shared by the row menus and More menus that offer the action, the routes\n * that perform it, the AI tool that exposes it, and the feed that reports\n * it. A kind missing from the catalog cannot be offered anywhere, so the\n * three surfaces cannot disagree about what is duplicable.\n *\n * The activity rows are CODES rather than the prose sentences the rest of\n * the feed stores, for the reason the AI rows are (`ai-activity-actions`):\n * the code names the kind, the feed translates it once, and a reader who\n * filters on \"duplicated\" sees every kind's copies together.\n *\n * A theme is absent on purpose. A site holds exactly one, as fields on its\n * host document rather than as a row in a collection, so there is no list\n * for a second one to appear in: copying a theme means carrying it to\n * another site or saving it into a template, and both of those doors\n * already exist (marketplace install, Save as template).\n */\n\n/** The resource kinds a whole copy can be made of. */\nexport const DUPLICABLE_RESOURCE_KINDS = [\n  'screen',\n  'component',\n  'layout',\n  'template',\n  'form',\n  'emailDesign',\n  'emailTemplate',\n  'campaign',\n  'workflow',\n] as const\n\nexport type DuplicableResourceKind = (typeof DUPLICABLE_RESOURCE_KINDS)[number]\n\nexport function isDuplicableResourceKind(\n  value: unknown,\n): value is DuplicableResourceKind {\n  return (\n    typeof value === 'string' &&\n    (DUPLICABLE_RESOURCE_KINDS as readonly string[]).includes(value)\n  )\n}\n\n/**\n * The kinds that live under a site and are copied by the core server module;\n * the other two belong to the plugins that own their collections.\n */\nexport const DUPLICABLE_HOST_RESOURCE_KINDS = [\n  'screen',\n  'component',\n  'layout',\n  'template',\n  'form',\n  'emailDesign',\n  'workflow',\n] as const satisfies readonly DuplicableResourceKind[]\n\nexport type DuplicableHostResourceKind =\n  (typeof DUPLICABLE_HOST_RESOURCE_KINDS)[number]\n\nexport function isDuplicableHostResourceKind(\n  value: unknown,\n): value is DuplicableHostResourceKind {\n  return (\n    typeof value === 'string' &&\n    (DUPLICABLE_HOST_RESOURCE_KINDS as readonly string[]).includes(value)\n  )\n}\n\n/** The one-line refusal a client shows when the copy is already being made. */\nexport const DUPLICATE_BUSY_MESSAGE = 'That copy is still being made'\n\n/** What a person calls one of each, in the dialog and the feed. */\nexport const DUPLICABLE_RESOURCE_NOUNS: Record<DuplicableResourceKind, string> = {\n  screen: 'screen',\n  component: 'component',\n  layout: 'layout',\n  template: 'template',\n  form: 'form',\n  emailDesign: 'email design',\n  emailTemplate: 'email template',\n  campaign: 'campaign',\n  workflow: 'workflow',\n}\n\n/**\n * What the copy carries, per kind — the sentence the dialog shows before the\n * copy is made, so nobody is surprised by what came along and what did not.\n */\nexport const DUPLICATE_COPIES: Record<DuplicableResourceKind, readonly string[]> = {\n  screen: [\n    'The latest version, with its full element tree and layout values',\n    'Description and SEO fields',\n    'A new draft — the copy is not published and has no address yet',\n  ],\n  component: [\n    'The definition and its properties',\n    'The latest version as a new draft',\n    'No instances — screens keep pointing at the original',\n  ],\n  layout: [\n    'The latest version, with its full element tree and properties',\n    'A new draft — no screen uses the copy yet',\n  ],\n  template: [\n    'The element tree, placeholders and properties',\n    'Description, slug and SEO fields',\n  ],\n  form: [\n    'The design, fields, validation, consent and routing',\n    'A new form of its own — submissions stay with the original',\n  ],\n  emailDesign: [\n    'The latest version, with its full element tree',\n    'A new draft — not published',\n  ],\n  emailTemplate: ['The subject and body, with their merge fields'],\n  campaign: [\n    'The subject, message, sender and design',\n    'A new draft — the audience and the send time are cleared',\n  ],\n  workflow: [\n    'Every step and the return value',\n    'The trigger is cleared, so the copy runs nothing until you arm it',\n  ],\n}\n\n/** The action code each copy writes to the activity logs. */\nexport const DUPLICATE_ACTIVITY_ACTIONS: Record<DuplicableResourceKind, string> = {\n  screen: 'screen.duplicated',\n  component: 'component.duplicated',\n  layout: 'layout.duplicated',\n  template: 'template.duplicated',\n  form: 'form.duplicated',\n  emailDesign: 'emailDesign.duplicated',\n  emailTemplate: 'emailTemplate.duplicated',\n  campaign: 'campaign.duplicated',\n  workflow: 'workflow.duplicated',\n}\n\n/** `a screen`, `an email design` — the article the noun takes. */\nconst withArticle = (noun: string): string =>\n  `${/^[aeiou]/i.test(noun) ? 'an' : 'a'} ${noun}`\n\n/** What a person reads for each code, in the feed and the actor table. */\nexport const DUPLICATE_ACTIVITY_ACTION_LABELS: Record<string, string> =\n  Object.fromEntries(\n    DUPLICABLE_RESOURCE_KINDS.map((kind) => [\n      DUPLICATE_ACTIVITY_ACTIONS[kind],\n      `Duplicated ${withArticle(DUPLICABLE_RESOURCE_NOUNS[kind])}`,\n    ]),\n  )\n\n/** Whether a stored action is one of the duplicate codes. */\nexport function isDuplicateActivityAction(action: unknown): boolean {\n  return typeof action === 'string' && action in DUPLICATE_ACTIVITY_ACTION_LABELS\n}\n\n/** The readable label for a duplicate code; `undefined` for any other action. */\nexport function duplicateActivityActionLabel(action: unknown): string | undefined {\n  return isDuplicateActivityAction(action)\n    ? DUPLICATE_ACTIVITY_ACTION_LABELS[action as string]\n    : undefined\n}\n\n/** The name a copy is offered under before anyone edits it. */\nexport const DUPLICATE_NAME_PREFIX = 'Copy of '\n\n/** The longest name a copy may carry, matching the create drawers' field. */\nexport const DUPLICATE_NAME_MAX = 200\n\n/**\n * The default name for a copy of `sourceName`, before uniqueness.\n *\n * A copy of a copy does not stack prefixes — `Copy of Copy of Home` tells\n * nobody anything — so a name already carrying the prefix keeps it, and the\n * counter {@link uniqueDuplicateName} appends is what tells the two apart.\n */\nexport function duplicateDisplayName(sourceName: string | null | undefined): string {\n  const name = String(sourceName ?? '').trim() || 'Untitled'\n  const base = name.startsWith(DUPLICATE_NAME_PREFIX)\n    ? name\n    : `${DUPLICATE_NAME_PREFIX}${name}`\n  return base.slice(0, DUPLICATE_NAME_MAX)\n}\n\n/**\n * The first of `requested`, `requested 2`, `requested 3`, … that no sibling\n * already carries, compared case-insensitively so `Home` and `home` are one\n * name. A blank request falls back to the prefix alone, never to an empty\n * name; the counter starts at 2 because the unnumbered name IS the first.\n */\nexport function uniqueDuplicateName(\n  requested: string | null | undefined,\n  taken: Iterable<string | null | undefined>,\n): string {\n  const base =\n    String(requested ?? '')\n      .trim()\n      .slice(0, DUPLICATE_NAME_MAX) || DUPLICATE_NAME_PREFIX.trim()\n  const used = new Set<string>()\n  for (const name of taken) {\n    const key = String(name ?? '').trim().toLowerCase()\n    if (key) used.add(key)\n  }\n  if (!used.has(base.toLowerCase())) return base\n  for (let counter = 2; ; counter += 1) {\n    const suffix = ` ${counter}`\n    const candidate = `${base.slice(0, DUPLICATE_NAME_MAX - suffix.length)}${suffix}`\n    if (!used.has(candidate.toLowerCase())) return candidate\n  }\n}\n\n/** The suffix a copied slug takes so it never claims the original's address. */\nexport const DUPLICATE_SLUG_SUFFIX = '-copy'\n\n/**\n * `<slug>-copy`, then `<slug>-copy-2`, `<slug>-copy-3`, … — the first the\n * siblings do not carry. A source with no slug yields no slug: the copy is a\n * draft with no address, and inventing one would be a publish decision made\n * by a copy button.\n *\n * A source that is itself a copy (`about-copy`) does not stack suffixes:\n * its base is recovered and numbered instead, so a copy of a copy is\n * `about-copy-2` rather than `about-copy-copy`.\n */\nexport function uniqueDuplicateSlug(\n  sourceSlug: string | null | undefined,\n  taken: Iterable<string | null | undefined>,\n): string | undefined {\n  const slug = String(sourceSlug ?? '').trim()\n  if (!slug) return undefined\n  const used = new Set<string>()\n  for (const value of taken) {\n    const key = String(value ?? '').trim().toLowerCase()\n    if (key) used.add(key)\n  }\n  const base = slug.replace(\n    new RegExp(`${DUPLICATE_SLUG_SUFFIX}(?:-\\\\d+)?$`),\n    '',\n  )\n  const first = `${base}${DUPLICATE_SLUG_SUFFIX}`\n  if (!used.has(first.toLowerCase())) return first\n  for (let counter = 2; ; counter += 1) {\n    const candidate = `${first}-${counter}`\n    if (!used.has(candidate.toLowerCase())) return candidate\n  }\n}\n\n/** The note the copy's first version carries: `Duplicated from Home v3`. */\nexport function duplicateVersionNote(\n  sourceName: string | null | undefined,\n  sourceVersionNumber: number | null | undefined,\n): string {\n  const name = String(sourceName ?? '').trim() || 'Untitled'\n  const version =\n    typeof sourceVersionNumber === 'number' && sourceVersionNumber > 0\n      ? ` v${Math.floor(sourceVersionNumber)}`\n      : ''\n  return `Duplicated from ${name}${version}`\n}\n\n/** The AI runtime tool that opens this door for the planner. */\nexport const DUPLICATE_RESOURCE_TOOL_NAME = 'duplicate_resource'\n"],"names":["DUPLICABLE_RESOURCE_KINDS","isDuplicableResourceKind","value","includes","DUPLICABLE_HOST_RESOURCE_KINDS","isDuplicableHostResourceKind","DUPLICATE_BUSY_MESSAGE","DUPLICABLE_RESOURCE_NOUNS","screen","component","layout","template","form","emailDesign","emailTemplate","campaign","workflow","DUPLICATE_COPIES","DUPLICATE_ACTIVITY_ACTIONS","withArticle","noun","test","DUPLICATE_ACTIVITY_ACTION_LABELS","Object","fromEntries","map","kind","isDuplicateActivityAction","action","duplicateActivityActionLabel","undefined","DUPLICATE_NAME_PREFIX","DUPLICATE_NAME_MAX","duplicateDisplayName","sourceName","name","String","trim","base","startsWith","slice","uniqueDuplicateName","requested","taken","used","Set","key","toLowerCase","add","has","counter","suffix","candidate","length","DUPLICATE_SLUG_SUFFIX","uniqueDuplicateSlug","sourceSlug","slug","replace","RegExp","first","duplicateVersionNote","sourceVersionNumber","version","Math","floor","DUPLICATE_RESOURCE_TOOL_NAME"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/duplicate-resource.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\n/**\n * Duplicating a resource whole (AGL-2936): the catalog every surface reads.\n *\n * One list of the kinds that can be copied, what a copy is called, how its\n * name and slug are made unique, and the activity code the copy writes —\n * shared by the row menus and More menus that offer the action, the routes\n * that perform it, the AI tool that exposes it, and the feed that reports\n * it. A kind missing from the catalog cannot be offered anywhere, so the\n * three surfaces cannot disagree about what is duplicable.\n *\n * The activity rows are CODES rather than the prose sentences the rest of\n * the feed stores, for the reason the AI rows are (`ai-activity-actions`):\n * the code names the kind, the feed translates it once, and a reader who\n * filters on \"duplicated\" sees every kind's copies together.\n *\n * A theme is absent on purpose. A site holds exactly one, as fields on its\n * host document rather than as a row in a collection, so there is no list\n * for a second one to appear in: copying a theme means carrying it to\n * another site or saving it into a template, and both of those doors\n * already exist (marketplace install, Save as template).\n */\n\n/** The resource kinds a whole copy can be made of. */\nexport const DUPLICABLE_RESOURCE_KINDS = [\n  'screen',\n  'component',\n  'layout',\n  'template',\n  'form',\n  'emailDesign',\n  'emailTemplate',\n  'campaign',\n  'workflow',\n] as const\n\nexport type DuplicableResourceKind = (typeof DUPLICABLE_RESOURCE_KINDS)[number]\n\nexport function isDuplicableResourceKind(\n  value: unknown,\n): value is DuplicableResourceKind {\n  return (\n    typeof value === 'string' &&\n    (DUPLICABLE_RESOURCE_KINDS as readonly string[]).includes(value)\n  )\n}\n\n/**\n * The kinds that live under a site and are copied by the core server module;\n * the other two belong to the plugins that own their collections. A copy is\n * made by the platform's own recipe for its kinds, and by the recipe the\n * owning plugin declares beside its collection for the rest (a workflow's,\n * in `plugins.config.json`); a kind here with neither is refused.\n */\nexport const DUPLICABLE_HOST_RESOURCE_KINDS = [\n  'screen',\n  'component',\n  'layout',\n  'template',\n  'form',\n  'emailDesign',\n  'workflow',\n] as const satisfies readonly DuplicableResourceKind[]\n\nexport type DuplicableHostResourceKind =\n  (typeof DUPLICABLE_HOST_RESOURCE_KINDS)[number]\n\nexport function isDuplicableHostResourceKind(\n  value: unknown,\n): value is DuplicableHostResourceKind {\n  return (\n    typeof value === 'string' &&\n    (DUPLICABLE_HOST_RESOURCE_KINDS as readonly string[]).includes(value)\n  )\n}\n\n/** The one-line refusal a client shows when the copy is already being made. */\nexport const DUPLICATE_BUSY_MESSAGE = 'That copy is still being made'\n\n/** What a person calls one of each, in the dialog and the feed. */\nexport const DUPLICABLE_RESOURCE_NOUNS: Record<DuplicableResourceKind, string> = {\n  screen: 'page',\n  component: 'component',\n  layout: 'layout',\n  template: 'template',\n  form: 'form',\n  emailDesign: 'email design',\n  emailTemplate: 'email template',\n  campaign: 'campaign',\n  workflow: 'workflow',\n}\n\n/**\n * What the copy carries, per kind — the sentence the dialog shows before the\n * copy is made, so nobody is surprised by what came along and what did not.\n */\nexport const DUPLICATE_COPIES: Record<DuplicableResourceKind, readonly string[]> = {\n  screen: [\n    'The latest version, with its full element tree and layout values',\n    'Description and SEO fields',\n    'A new draft — the copy is not published and has no address yet',\n  ],\n  component: [\n    'The definition and its properties',\n    'The latest version as a new draft',\n    'No instances — pages keep pointing at the original',\n  ],\n  layout: [\n    'The latest version, with its full element tree and properties',\n    'A new draft — no page uses the copy yet',\n  ],\n  template: [\n    'The element tree, placeholders and properties',\n    'Description, slug and SEO fields',\n  ],\n  form: [\n    'The design, fields, validation, consent and routing',\n    'A new form of its own — submissions stay with the original',\n  ],\n  emailDesign: [\n    'The latest version, with its full element tree',\n    'A new draft — not published',\n  ],\n  emailTemplate: ['The subject and body, with their merge fields'],\n  campaign: [\n    'The subject, message, sender and design',\n    'A new draft — the audience and the send time are cleared',\n  ],\n  workflow: [\n    'Every step and the return value',\n    'The trigger is cleared, so the copy runs nothing until you arm it',\n  ],\n}\n\n/** The action code each copy writes to the activity logs. */\nexport const DUPLICATE_ACTIVITY_ACTIONS: Record<DuplicableResourceKind, string> = {\n  screen: 'screen.duplicated',\n  component: 'component.duplicated',\n  layout: 'layout.duplicated',\n  template: 'template.duplicated',\n  form: 'form.duplicated',\n  emailDesign: 'emailDesign.duplicated',\n  emailTemplate: 'emailTemplate.duplicated',\n  campaign: 'campaign.duplicated',\n  workflow: 'workflow.duplicated',\n}\n\n/** `a screen`, `an email design` — the article the noun takes. */\nconst withArticle = (noun: string): string =>\n  `${/^[aeiou]/i.test(noun) ? 'an' : 'a'} ${noun}`\n\n/** What a person reads for each code, in the feed and the actor table. */\nexport const DUPLICATE_ACTIVITY_ACTION_LABELS: Record<string, string> =\n  Object.fromEntries(\n    DUPLICABLE_RESOURCE_KINDS.map((kind) => [\n      DUPLICATE_ACTIVITY_ACTIONS[kind],\n      `Duplicated ${withArticle(DUPLICABLE_RESOURCE_NOUNS[kind])}`,\n    ]),\n  )\n\n/** Whether a stored action is one of the duplicate codes. */\nexport function isDuplicateActivityAction(action: unknown): boolean {\n  return typeof action === 'string' && action in DUPLICATE_ACTIVITY_ACTION_LABELS\n}\n\n/** The readable label for a duplicate code; `undefined` for any other action. */\nexport function duplicateActivityActionLabel(action: unknown): string | undefined {\n  return isDuplicateActivityAction(action)\n    ? DUPLICATE_ACTIVITY_ACTION_LABELS[action as string]\n    : undefined\n}\n\n/** The name a copy is offered under before anyone edits it. */\nexport const DUPLICATE_NAME_PREFIX = 'Copy of '\n\n/** The longest name a copy may carry, matching the create drawers' field. */\nexport const DUPLICATE_NAME_MAX = 200\n\n/**\n * The default name for a copy of `sourceName`, before uniqueness.\n *\n * A copy of a copy does not stack prefixes — `Copy of Copy of Home` tells\n * nobody anything — so a name already carrying the prefix keeps it, and the\n * counter {@link uniqueDuplicateName} appends is what tells the two apart.\n */\nexport function duplicateDisplayName(sourceName: string | null | undefined): string {\n  const name = String(sourceName ?? '').trim() || 'Untitled'\n  const base = name.startsWith(DUPLICATE_NAME_PREFIX)\n    ? name\n    : `${DUPLICATE_NAME_PREFIX}${name}`\n  return base.slice(0, DUPLICATE_NAME_MAX)\n}\n\n/**\n * The first of `requested`, `requested 2`, `requested 3`, … that no sibling\n * already carries, compared case-insensitively so `Home` and `home` are one\n * name. A blank request falls back to the prefix alone, never to an empty\n * name; the counter starts at 2 because the unnumbered name IS the first.\n */\nexport function uniqueDuplicateName(\n  requested: string | null | undefined,\n  taken: Iterable<string | null | undefined>,\n): string {\n  const base =\n    String(requested ?? '')\n      .trim()\n      .slice(0, DUPLICATE_NAME_MAX) || DUPLICATE_NAME_PREFIX.trim()\n  const used = new Set<string>()\n  for (const name of taken) {\n    const key = String(name ?? '').trim().toLowerCase()\n    if (key) used.add(key)\n  }\n  if (!used.has(base.toLowerCase())) return base\n  for (let counter = 2; ; counter += 1) {\n    const suffix = ` ${counter}`\n    const candidate = `${base.slice(0, DUPLICATE_NAME_MAX - suffix.length)}${suffix}`\n    if (!used.has(candidate.toLowerCase())) return candidate\n  }\n}\n\n/** The suffix a copied slug takes so it never claims the original's address. */\nexport const DUPLICATE_SLUG_SUFFIX = '-copy'\n\n/**\n * `<slug>-copy`, then `<slug>-copy-2`, `<slug>-copy-3`, … — the first the\n * siblings do not carry. A source with no slug yields no slug: the copy is a\n * draft with no address, and inventing one would be a publish decision made\n * by a copy button.\n *\n * A source that is itself a copy (`about-copy`) does not stack suffixes:\n * its base is recovered and numbered instead, so a copy of a copy is\n * `about-copy-2` rather than `about-copy-copy`.\n */\nexport function uniqueDuplicateSlug(\n  sourceSlug: string | null | undefined,\n  taken: Iterable<string | null | undefined>,\n): string | undefined {\n  const slug = String(sourceSlug ?? '').trim()\n  if (!slug) return undefined\n  const used = new Set<string>()\n  for (const value of taken) {\n    const key = String(value ?? '').trim().toLowerCase()\n    if (key) used.add(key)\n  }\n  const base = slug.replace(\n    new RegExp(`${DUPLICATE_SLUG_SUFFIX}(?:-\\\\d+)?$`),\n    '',\n  )\n  const first = `${base}${DUPLICATE_SLUG_SUFFIX}`\n  if (!used.has(first.toLowerCase())) return first\n  for (let counter = 2; ; counter += 1) {\n    const candidate = `${first}-${counter}`\n    if (!used.has(candidate.toLowerCase())) return candidate\n  }\n}\n\n/** The note the copy's first version carries: `Duplicated from Home v3`. */\nexport function duplicateVersionNote(\n  sourceName: string | null | undefined,\n  sourceVersionNumber: number | null | undefined,\n): string {\n  const name = String(sourceName ?? '').trim() || 'Untitled'\n  const version =\n    typeof sourceVersionNumber === 'number' && sourceVersionNumber > 0\n      ? ` v${Math.floor(sourceVersionNumber)}`\n      : ''\n  return `Duplicated from ${name}${version}`\n}\n\n/** The AI runtime tool that opens this door for the planner. */\nexport const DUPLICATE_RESOURCE_TOOL_NAME = 'duplicate_resource'\n"],"names":["DUPLICABLE_RESOURCE_KINDS","isDuplicableResourceKind","value","includes","DUPLICABLE_HOST_RESOURCE_KINDS","isDuplicableHostResourceKind","DUPLICATE_BUSY_MESSAGE","DUPLICABLE_RESOURCE_NOUNS","screen","component","layout","template","form","emailDesign","emailTemplate","campaign","workflow","DUPLICATE_COPIES","DUPLICATE_ACTIVITY_ACTIONS","withArticle","noun","test","DUPLICATE_ACTIVITY_ACTION_LABELS","Object","fromEntries","map","kind","isDuplicateActivityAction","action","duplicateActivityActionLabel","undefined","DUPLICATE_NAME_PREFIX","DUPLICATE_NAME_MAX","duplicateDisplayName","sourceName","name","String","trim","base","startsWith","slice","uniqueDuplicateName","requested","taken","used","Set","key","toLowerCase","add","has","counter","suffix","candidate","length","DUPLICATE_SLUG_SUFFIX","uniqueDuplicateSlug","sourceSlug","slug","replace","RegExp","first","duplicateVersionNote","sourceVersionNumber","version","Math","floor","DUPLICATE_RESOURCE_TOOL_NAME"],"mappings":"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"}

package/src/lib/app-utils/dynamic-list-rule.d.ts

@@ -139,7 +139,7 @@ export interface DynamicListDimensions {
      * attribution record; this says which campaign the merchant FILED the
      * record under. The two are different facts about different acts and a
      * single dimension over both would answer neither question — see
-     * `campaign-attribution.ts` for the other one.
+     * `utm-attribution.ts` for the other one.
      *
      * ⛔ And membership is not consent. A person selected by this dimension has
      * opted in to nothing: they are here because a merchant put a form in a