@ai-matrx/records 0.95.1 → 0.96.1

package/dist/templates/index.cjs

@@ -28,6 +28,7 @@ __export(templates_exports, {
   CHOICE_COLORS: () => CHOICE_COLORS,
   CHOICE_COLORS_DISTINCT_UP_TO: () => CHOICE_COLORS_DISTINCT_UP_TO,
   DEFAULT_TEMPLATE_AGENT: () => DEFAULT_TEMPLATE_AGENT,
+  DESCRIBE_RESULT_KIND: () => DESCRIBE_RESULT_KIND,
   DESIGNATED_REAL_NUMBERS: () => DESIGNATED_REAL_NUMBERS,
   ENTITY_REFERENCE_KINDS: () => ENTITY_REFERENCE_KINDS,
   FORMULA_FUNCTION_NAMES: () => FORMULA_FUNCTION_NAMES,
@@ -85,6 +86,7 @@ __export(templates_exports, {
   deferredRelations: () => deferredRelations,
   derivedFieldSpec: () => derivedFieldSpec,
   describeCheck: () => describeCheck,
+  describeResultJsonSchema: () => describeResultJsonSchema,
   describeSpec: () => describeSpec,
   describeVocabulary: () => describeVocabulary,
   digestSpec: () => digestSpec,
@@ -113,6 +115,7 @@ __export(templates_exports, {
   numberedStreet: () => numberedStreet,
   packageDescribeResult: () => packageDescribeResult,
   parseAt: () => parseAt,
+  parseDescribeTemplate: () => parseDescribeTemplate,
   parseGateFormula: () => parseGateFormula,
   parseNumeric: () => parseNumeric,
   pathOfAt: () => pathOfAt,
@@ -1861,9 +1864,9 @@ var ACCOUNT_DOOR_PATTERNS = [
     instead: "Call create_fixture_user / fixture_user (aidream/aidream/testing/persona.py) or createFixtureUser / withFixtureUser (scripts/lib/persona.mjs). A rolled-back raw insert is allowed with a trailing matrx-fixture:rollback-only <reason> on the same line."
   }
 ];
-function findPlaceholders(text) {
+function findPlaceholders(text2) {
   const hits = [];
-  const lines = text.split("\n");
+  const lines = text2.split("\n");
   for (const line of lines) {
     if (ALLOW_PRAGMA.test(line)) continue;
     for (const pattern of PLACEHOLDER_PATTERNS) {
@@ -2729,8 +2732,8 @@ function bookingColumnsProblem(tables, booking) {
     if (clash) return `The booking page adds a "${label}" column to "${t.name}", which already has one ("${clash.key}"). Rename that column, or key it "${key}".`;
   }
   const status = t.fields.find((f) => f.key === "status");
-  const words = new Set((status?.choices ?? []).map((c) => c.toLowerCase()));
-  if (status && (!words.has("booked") || !words.has("cancelled"))) {
+  const words2 = new Set((status?.choices ?? []).map((c) => c.toLowerCase()));
+  if (status && (!words2.has("booked") || !words2.has("cancelled"))) {
     return `The booking page writes "booked" and "cancelled" into "${t.name}"'s status, and its choices do not hold both.`;
   }
   return null;
@@ -2848,8 +2851,8 @@ var q = (n, d) => {
 };
 var qAdd = (a, b) => q(a.n * b.d + b.n * a.d, a.d * b.d);
 var qCmp = (a, b) => a.n * b.d === b.n * a.d ? 0 : a.n * b.d < b.n * a.d ? -1 : 1;
-function parseNumeric(text) {
-  const m = /^\s*([+-]?)(\d*)(?:\.(\d*))?(?:[eE]([+-]?\d+))?\s*$/.exec(text);
+function parseNumeric(text2) {
+  const m = /^\s*([+-]?)(\d*)(?:\.(\d*))?(?:[eE]([+-]?\d+))?\s*$/.exec(text2);
   if (!m || !m[2] && !m[3]) return null;
   const frac = m[3] ?? "";
   let n = BigInt(`${m[1] === "-" ? "-" : ""}${m[2] || "0"}${frac}` || "0");
@@ -2899,9 +2902,9 @@ function unwrap(v) {
   return v && typeof v === "object" && !Array.isArray(v) && "value" in v ? unwrap(v.value) : v;
 }
 function boundMoment(raw) {
-  const text = raw.trim();
-  if (!text) return null;
-  const at = Date.parse(/^\d{4}-\d{2}-\d{2}$/.test(text) ? `${text}T00:00:00Z` : text);
+  const text2 = raw.trim();
+  if (!text2) return null;
+  const at = Date.parse(/^\d{4}-\d{2}-\d{2}$/.test(text2) ? `${text2}T00:00:00Z` : text2);
   return Number.isNaN(at) ? null : at;
 }
 function storeFilterMatches(row, filter, _timeZone) {
@@ -2939,8 +2942,8 @@ function toFx(n) {
       return { k: "call", f: n.name, args: n.args.map(toFx) };
   }
 }
-function parseGateFormula(text) {
-  const parsed = (0, import_formula.parseFormula)(text);
+function parseGateFormula(text2) {
+  const parsed = (0, import_formula.parseFormula)(text2);
   return parsed.ok ? toFx(parsed.ast) : parsed.error;
 }
 function formulaRefs(n) {
@@ -3290,8 +3293,8 @@ function capabilitiesUsed(spec) {
 }
 var DESIGNATED_REAL_NUMBERS = ["9498072145", "9496662578", "9497027626"];
 var DIGIT_ZEROS = [1632, 1776, 1984, 2406, 2534, 2662, 2790, 2918, 3046, 3174, 3302, 3430, 3664, 3792, 3872, 4160, 6112, 6160, 65296];
-function normalizeForPhones(text) {
-  return text.normalize("NFKC").replace(/\p{Nd}/gu, (c) => {
+function normalizeForPhones(text2) {
+  return text2.normalize("NFKC").replace(/\p{Nd}/gu, (c) => {
     const cp = c.codePointAt(0) ?? 48;
     const zero = DIGIT_ZEROS.find((z) => cp >= z && cp <= z + 9);
     return zero === void 0 ? c : String(cp - zero);
@@ -3305,8 +3308,8 @@ function nanpBad(area, exchange, line) {
   const n = Number(line);
   return exchange !== "555" || n < 100 || n > 199 || DESIGNATED_REAL_NUMBERS.includes(`${area}${exchange}${line}`);
 }
-function phonesOutsideFictionalRange(text, phoneField = false) {
-  const t = normalizeForPhones(text);
+function phonesOutsideFictionalRange(text2, phoneField = false) {
+  const t = normalizeForPhones(text2);
   const out = [];
   for (const m of t.matchAll(INTL)) {
     const digits = m[0].replace(/\D/g, "");
@@ -3360,11 +3363,11 @@ var PUBLIC_MAIL_DOMAINS = [
   "163.com",
   "web.de"
 ];
-function domainsIn(text) {
+function domainsIn(text2) {
   const found = /* @__PURE__ */ new Set();
-  for (const m of text.matchAll(/[a-z0-9._%+-]+@([a-z0-9-]+(?:\.[a-z0-9-]+)+)/gi)) found.add((m[1] ?? "").toLowerCase());
-  for (const m of text.matchAll(/\bhttps?:\/\/([a-z0-9-]+(?:\.[a-z0-9-]+)+)/gi)) found.add((m[1] ?? "").toLowerCase().replace(/^www\./, ""));
-  for (const m of text.matchAll(/\bwww\.([a-z0-9-]+(?:\.[a-z0-9-]+)+)/gi)) found.add((m[1] ?? "").toLowerCase().replace(/\.$/, ""));
+  for (const m of text2.matchAll(/[a-z0-9._%+-]+@([a-z0-9-]+(?:\.[a-z0-9-]+)+)/gi)) found.add((m[1] ?? "").toLowerCase());
+  for (const m of text2.matchAll(/\bhttps?:\/\/([a-z0-9-]+(?:\.[a-z0-9-]+)+)/gi)) found.add((m[1] ?? "").toLowerCase().replace(/^www\./, ""));
+  for (const m of text2.matchAll(/\bwww\.([a-z0-9-]+(?:\.[a-z0-9-]+)+)/gi)) found.add((m[1] ?? "").toLowerCase().replace(/\.$/, ""));
   return [...found];
 }
 function numberedStreet(line) {
@@ -3450,7 +3453,7 @@ function peopleOf(spec) {
 function proseOf(spec) {
   return templateText(spec).filter(([at]) => !at.startsWith("tables ("));
 }
-var words8 = (text) => text.toLowerCase().replace(/\{\{[^}]*\}\}/g, " ").split(/[^a-z0-9']+/).filter(Boolean);
+var words8 = (text2) => text2.toLowerCase().replace(/\{\{[^}]*\}\}/g, " ").split(/[^a-z0-9']+/).filter(Boolean);
 var FOREIGN_INDEX = /* @__PURE__ */ new WeakMap();
 function foreignIndexOf(other) {
   let ix = FOREIGN_INDEX.get(other);
@@ -3470,8 +3473,8 @@ function foreignIndexOf(other) {
 }
 function foreignTextProblems(spec, library) {
   const problems = [];
-  const text = templateText(spec);
-  const hay = text.map(([at, v]) => [at, v.toLowerCase()]);
+  const text2 = templateText(spec);
+  const hay = text2.map(([at, v]) => [at, v.toLowerCase()]);
   const all = hay.map(([, v]) => v).join("\n");
   const esc = (w) => w.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   const find = (word) => {
@@ -3481,9 +3484,9 @@ function foreignTextProblems(spec, library) {
     return hay.find(([, v]) => re.test(v));
   };
   const mine = proseOf(spec).map(([at, w]) => {
-    const words = words8(w);
+    const words2 = words8(w);
     const runs = [];
-    for (let i = 0; i + 8 <= words.length; i += 1) runs.push(words.slice(i, i + 8).join(" "));
+    for (let i = 0; i + 8 <= words2.length; i += 1) runs.push(words2.slice(i, i + 8).join(" "));
     return [at, runs];
   });
   for (const other of library.specs) {
@@ -3518,8 +3521,8 @@ var SYNONYM_WORDS = {
 function labelMeans(f, sameAs) {
   const label = norm(f.label);
   if (sameAs.includes(label)) return true;
-  const words = new Set(label.split(" "));
-  return Object.values(SYNONYM_WORDS).some((group) => group.some((w) => words.has(w)) && sameAs.some((s) => group.some((w) => s.split(" ").includes(w))));
+  const words2 = new Set(label.split(" "));
+  return Object.values(SYNONYM_WORDS).some((group) => group.some((w) => words2.has(w)) && sameAs.some((s) => group.some((w) => s.split(" ").includes(w))));
 }
 var sameJson = (a, b) => JSON.stringify(a) === JSON.stringify(b);
 var sortedJson = (v) => JSON.stringify(Object.keys(v).sort().map((k) => [k, v[k]]));
@@ -4111,8 +4114,8 @@ function validateTemplate(raw, options = {}) {
     for (const by of dim.default?.by ?? []) if (!dimKeys.has(by.split(":")[0] ?? "")) say(`${at}.default.by`, `The first screen groups by "${by}", which is not a dimension.`);
     for (const show of dim.default?.show ?? []) if (!inferredMeasures.has(show) && !newMeasures.has(show)) say(`${at}.default.show`, `The first screen shows "${show}", which is not a measure of this table.`);
   });
-  const checkMerge = (at, table, text2) => {
-    for (const m of text2.matchAll(MERGE_TOKEN)) {
+  const checkMerge = (at, table, text3) => {
+    for (const m of text3.matchAll(MERGE_TOKEN)) {
       const key = m[1] ?? "";
       const f = fieldOf(table, key);
       if (!f) say(at, `{{${key}}} does not resolve: the store merges only the fields of "${table}" (no today, no business details).`);
@@ -5020,7 +5023,7 @@ function validateTemplate(raw, options = {}) {
     const f = fieldOf(table, key);
     if (f?.absoluteDates) say(`tables (${table}).fields (${key})`, `"${f.label}" holds history (absoluteDates), so it cannot drive ${where}: schedule dates are relative to install day.`);
   }
-  const text = JSON.stringify(raw);
+  const text2 = JSON.stringify(raw);
   const isPhoneField = (f) => f.parityType === "phone" || /(^|_)(phone|mobile|cell|fax|tel)(_|$)/.test(f.key) || /\b(phone|mobile|cell|fax)\b/.test(norm(f.label));
   const phoneHits = /* @__PURE__ */ new Set();
   for (const p of phonesOutsideFictionalRange(raw.business?.phone ?? "", true)) phoneHits.add(p);
@@ -5038,7 +5041,7 @@ function validateTemplate(raw, options = {}) {
   for (const d of raw.provenance?.fictionalDomains ?? []) {
     if (PUBLIC_MAIL_DOMAINS.includes(d.toLowerCase())) say("provenance.fictionalDomains", `"${d}" is a public mail provider real people use, so it is never fictional. Give each person a mailbox on an invented domain.`);
   }
-  for (const domain of /* @__PURE__ */ new Set([...domainsIn(text), ...websites])) {
+  for (const domain of /* @__PURE__ */ new Set([...domainsIn(text2), ...websites])) {
     if (!declaredDomains.has(domain)) say("provenance.fictionalDomains", `"${domain}" is used but not declared fictional. List every invented domain in provenance.fictionalDomains (each is checked not to resolve).`);
   }
   const streets = new Set((raw.provenance?.fictionalStreets ?? []).map((s) => s.toLowerCase()));
@@ -5081,10 +5084,10 @@ function validateTemplate(raw, options = {}) {
       if (seeded) say(`tables (${t.token}).fields (${f.key})`, `"${f.label}" is computed by the store (${f.parityType}), and ${seeded} seed row(s) write a value into it; leave it to the store.`);
     }
   }
-  const label = (at, text2, kind) => {
-    if (!text2) return;
-    const hit = findBannedLabel(text2, kind);
-    if (hit) say(at, `"${text2}" is ${hit.why}. Use the practitioner's own word.`);
+  const label = (at, text3, kind) => {
+    if (!text3) return;
+    const hit = findBannedLabel(text3, kind);
+    if (hit) say(at, `"${text3}" is ${hit.why}. Use the practitioner's own word.`);
   };
   for (const t of own) {
     label(`tables (${t.token}).name`, t.name, "table");
@@ -5117,9 +5120,9 @@ function validateTemplate(raw, options = {}) {
       for (const [k, v] of Object.entries(r.values ?? {})) {
         const f = byKey.get(k);
         if (!f || isRelation(f) || f.parityType === "email" || f.parityType === "url" || f.parityType === "phone") continue;
-        const text2 = unwrap(v);
-        if (typeof text2 === "string" && !RELATIVE_DATE.test(text2) && STALE.test(text2)) {
-          say(`tables (${t.token}).rows (${r.key}).${k}`, `"${text2}" says "${STALE.exec(text2)?.[0]}", which is only true on the day it was written. Put the date in a date field written relative to install day ("@today+1b 10:00"), and keep the text free of "today" and "next week".`);
+        const text3 = unwrap(v);
+        if (typeof text3 === "string" && !RELATIVE_DATE.test(text3) && STALE.test(text3)) {
+          say(`tables (${t.token}).rows (${r.key}).${k}`, `"${text3}" says "${STALE.exec(text3)?.[0]}", which is only true on the day it was written. Put the date in a date field written relative to install day ("@today+1b 10:00"), and keep the text free of "today" and "next week".`);
         }
       }
     }
@@ -5127,14 +5130,14 @@ function validateTemplate(raw, options = {}) {
   for (const t of own) {
     for (const f of t.fields) {
       const at = `tables (${t.token}).fields (${f.key})`;
-      const text2 = `${f.key} ${norm(f.label)}`;
+      const text3 = `${f.key} ${norm(f.label)}`;
       const e = effective(t.token, f);
       const floor = sensitivityFloorOf(t, f);
       if (floor === "restricted" && !(e.sensitivity === "restricted" && e.contextPolicy === "exclude")) {
         say(at, `"${f.label}" is the kind of value that is restricted and kept from the AI (restricted + exclude).`);
       } else if (floor === "confidential" && SENSITIVITY_RANK.indexOf(e.sensitivity) < 2) {
         say(at, `"${f.label}" reaches a person or a home, so it is at least confidential.`);
-      } else if (/note/.test(text2) && e.sensitivity === "public") {
+      } else if (/note/.test(text3) && e.sensitivity === "public") {
         say(at, `"${f.label}" is somebody's notes; notes are never public.`);
       }
     }
@@ -5319,8 +5322,8 @@ function validateTemplate(raw, options = {}) {
     const status2 = fieldOf(e.table, "status");
     if (!status2) say(at, `A booking table needs a choice field keyed \`status\` whose choices include "booked" and "cancelled"; "${e.table}" has none. Add it, so a held time can be confirmed and given back.`);
     else if (isChoice(status2)) {
-      const words = (status2.choices ?? []).map((c) => c.trim().toLowerCase());
-      const missing = ["booked", "cancelled"].filter((w) => !words.includes(w));
+      const words2 = (status2.choices ?? []).map((c) => c.trim().toLowerCase());
+      const missing = ["booked", "cancelled"].filter((w) => !words2.includes(w));
       if (missing.length) say(`${at}`, `This table's Status is a list of choices, and it has no choice called ${missing.join(" or ")} \u2014 the booking page writes those words (custom.booking_declare refuses).`);
     }
     const columns = bookingColumnsProblem(tables, e);
@@ -5440,9 +5443,9 @@ ${e.body}`.matchAll(MERGE_TOKEN)].map((m) => m[1]));
   if (agent?.question?.expect) {
     const qq = agent.question;
     const ask = norm(qq.ask);
-    const words = (t) => norm(t).split(" ").filter((w) => w.length >= 4);
+    const words2 = (t) => norm(t).split(" ").filter((w) => w.length >= 4);
     const askWords = new Set(ask.split(" "));
-    const mentions = (t) => !!norm(t) && ask.includes(norm(t)) || words(t).some((w) => ask.includes(w.replace(/s$/, ""))) || words(t).length === 0 && norm(t).split(" ").filter(Boolean).some((w) => w.length >= 3 && (askWords.has(w) || askWords.has(`${w}s`)));
+    const mentions = (t) => !!norm(t) && ask.includes(norm(t)) || words2(t).some((w) => ask.includes(w.replace(/s$/, ""))) || words2(t).length === 0 && norm(t).split(" ").filter(Boolean).some((w) => w.length >= 3 && (askWords.has(w) || askWords.has(`${w}s`)));
     for (const [k, v] of Object.entries(qq.expect.filter ?? {})) {
       if (typeof v === "string" && !mentions(v) && !ask.includes(norm(v))) say("agent.question.ask", `It filters on ${k} = "${v}", and the question never says so.`);
     }
@@ -5524,9 +5527,9 @@ ${e.body}`.matchAll(MERGE_TOKEN)].map((m) => m[1]));
       if (!t) return false;
       if (says.includes(norm(t))) return true;
       const long = [...new Set(norm(t).split(" ").filter((w) => w.length >= 4))];
-      const words = long.length ? long : [...new Set(norm(t).split(" ").filter((w) => w.length >= 2))];
+      const words2 = long.length ? long : [...new Set(norm(t).split(" ").filter((w) => w.length >= 2))];
       const said = new Set(says.split(" "));
-      return words.length > 0 && words.filter((w) => said.has(w) || said.has(`${w}s`)).length >= Math.min(2, words.length);
+      return words2.length > 0 && words2.filter((w) => said.has(w) || said.has(`${w}s`)).length >= Math.min(2, words2.length);
     };
     if (!a) return;
     if (a.kind === "move" || a.kind === "edit" || a.kind === "archive" || a.kind === "restore") {
@@ -5627,9 +5630,9 @@ ${e.body}`.matchAll(MERGE_TOKEN)].map((m) => m[1]));
   const LABEL_MAX = 40;
   const IMPLEMENTATION = /\b(?:the\s+)?(?:ai|a\.i\.|agent|assistant|llm|model)\b[^.]*\b(?:reads?|sees?|never|cannot|can't|won't|doesn't|does not|is kept)\b|\b(?:never|not)\b[^.]*\b(?:ai|agent)\b|\bthe store\b|\bthis field\b|\bthis column\b|\bthe booking page writes\b|\bwrites? (?:a |the )?(?:booked )?time here\b|\bcustom\.[a-z_]+|\{\{|\b[a-z]+_[a-z0-9_]+\b|\b(?:sum|avg|count|min|max)\s*\(|\s=\s/i;
   const STAFF_VOICE = /\bwe\b|\bour system\b/i;
-  const screen = (at, text2, slot, opts = {}) => {
-    if (!text2?.trim()) return;
-    const t = text2.trim();
+  const screen = (at, text3, slot, opts = {}) => {
+    if (!text3?.trim()) return;
+    const t = text3.trim();
     if (slot === "label" && (t.length > LABEL_MAX || t.split(/\s+/).length > 6)) say(at, `"${t}" is a label (${t.length} characters); keep it to a few words \u2014 the name of the thing, no explanation.`);
     if (slot === "secondary" && (t.length > 60 || sentences(t) > 1)) say(at, `"${t}" is ${t.length} characters; help text is one line of at most 60, one sentence.`);
     if (slot === "tooltip" && (t.length > 140 || sentences(t) > 1)) say(at, `"${t.slice(0, 60)}\u2026" is ${t.length} characters; a description is one sentence of at most 140.`);
@@ -6004,14 +6007,14 @@ var holdsPeople = (t) => t.subject ? t.subject === "person" : t.fields.some((f)
 var GOOD_OUTCOME = /^(completed?|done|paid|approved|won|closed won|booked|confirmed|delivered|resolved|published|signed|passed|hired|accepted)$/i;
 var BAD_OUTCOME = /^(cancell?ed|skipped|lost|closed lost|denied|rejected|no[- ]show|failed|overdue|declined|void(ed)?|refunded|churned|expired|blocked)$/i;
 function sensitivityFloorOf(table, f) {
-  const text = `${f.key} ${norm(f.label)}`;
+  const text2 = `${f.key} ${norm(f.label)}`;
   const billingTable = /(invoice|bill|statement|receipt|payment|charge|fee|order|account)/i.test(`${table.token} ${table.labelSingular ?? ""}`);
   const criminalCharges = /(^|_)charges?($|_)/.test(f.key) && behaviorOf(f) === "text" && !billingTable;
   const phoneLike = behaviorOf(f) === "text" && /\b(cell|mobile|phone)\b/.test(norm(f.label));
   const personal = PERSONAL_ONLY.test(f.key) || /\b(medical conditions?|medications?|diagnos[ie]s)\b/.test(norm(f.label));
   const floored = (RESTRICTED_KEY.test(f.key) || RESTRICTED_LABEL.test(norm(f.label)) || criminalCharges) && (!personal || holdsPeople(table));
   if (floored) return "restricted";
-  if (f.parityType === "phone" || phoneLike || f.parityType === "email" || /address|street/.test(text)) return "confidential";
+  if (f.parityType === "phone" || phoneLike || f.parityType === "email" || /address|street/.test(text2)) return "confidential";
   return null;
 }
 
@@ -6497,6 +6500,7 @@ function describeSpec(template) {
   s.specVersion = 1;
   if (typeof s.version !== "number") s.version = 1;
   if (typeof s.audience !== "string") s.audience = "organization";
+  if (s.audience === "personal") s.audience = "individual";
   if (typeof s.cleanupTag !== "string" && typeof s.id === "string") s.cleanupTag = `describe:${s.id}`;
   for (const k of ["relationships", "sharedBlocks", "views", "forms", "dimensions", "extras"]) if (!Array.isArray(s[k])) s[k] = [];
   if (Array.isArray(s.tables)) s.tables = s.tables.map(describeTable);
@@ -6539,9 +6543,9 @@ function stemWord(w) {
   if (s.length > 4 && (s.endsWith("y") || s.endsWith("e"))) s = s.slice(0, -1);
   return s;
 }
-function meaningWords(text) {
-  const words = text.replace(/([a-z])([A-Z])/g, "$1 $2").split(/[^A-Za-z0-9]+/).filter(Boolean).map((w) => w.toLowerCase()).filter((w) => !FILLER.has(w)).map(stemWord).filter(Boolean);
-  return [...new Set(words)].sort();
+function meaningWords(text2) {
+  const words2 = text2.replace(/([a-z])([A-Z])/g, "$1 $2").split(/[^A-Za-z0-9]+/).filter(Boolean).map((w) => w.toLowerCase()).filter((w) => !FILLER.has(w)).map(stemWord).filter(Boolean);
+  return [...new Set(words2)].sort();
 }
 var same = (a, b) => a.length > 0 && a.length === b.length && a.every((w, i) => w === b[i]);
 function sameMeaning(a, b) {
@@ -7081,31 +7085,31 @@ function fixFormulaRefs(spec, fixes) {
       if (f.parityType !== "formula" || typeof f.formula !== "string") continue;
       const others = t.fields.filter((x) => x.key !== f.key);
       const labelFor = (name) => others.find((x) => x.label === name)?.label ?? others.find((x) => x.key === name)?.label ?? others.find((x) => same3(x.key, name))?.label ?? others.find((x) => same3(x.label, name))?.label;
-      const text = f.formula.replace(/^\s*=\s*/, "");
+      const text2 = f.formula.replace(/^\s*=\s*/, "");
       let out = "";
       let i = 0;
-      while (i < text.length) {
-        const c = text[i];
+      while (i < text2.length) {
+        const c = text2[i];
         if (c === "{") {
-          const j = text.indexOf("}", i);
+          const j = text2.indexOf("}", i);
           if (j < 0) {
-            out += text.slice(i);
+            out += text2.slice(i);
             break;
           }
-          const name = text.slice(i + 1, j).trim();
+          const name = text2.slice(i + 1, j).trim();
           out += `{${labelFor(name) ?? name}}`;
           i = j + 1;
         } else if (c === "'" || c === '"') {
-          const j = text.indexOf(c, i + 1);
+          const j = text2.indexOf(c, i + 1);
           if (j < 0) {
-            out += text.slice(i);
+            out += text2.slice(i);
             break;
           }
-          out += text.slice(i, j + 1);
+          out += text2.slice(i, j + 1);
           i = j + 1;
         } else if (/[A-Za-z_]/.test(c)) {
-          const m = /^[A-Za-z_][A-Za-z_0-9]*/.exec(text.slice(i))[0];
-          const after = text.slice(i + m.length).trimStart()[0];
+          const m = /^[A-Za-z_][A-Za-z_0-9]*/.exec(text2.slice(i))[0];
+          const after = text2.slice(i + m.length).trimStart()[0];
           const label = after === "(" ? void 0 : labelFor(m);
           out += label ? `{${label}}` : m;
           i += m.length;
@@ -7837,7 +7841,7 @@ function describeVocabulary() {
     field_shape: FIELD_SHAPE_FACTS,
     formula_shape: FORMULA_SHAPE_FACTS,
     relationship_shape: RELATIONSHIP_SHAPE_FACTS,
-    phone_rule: "seed phone numbers are fictional: 555-0100 to 555-0199 in North America (e.g. (813) 555-0142) or a UK Ofcom drama number (e.g. 020 7946 0123); never a real-looking number.",
+    phone_rule: "seed phone numbers are fictional: 555-0100 to 555-0199 (e.g. (813) 555-0142); never a real-looking number, and never a number from a country the person did not name.",
     team_rule: "the team (name, role, work email, mobile, start date) is the shared team_member block; do not declare a table with those fields \u2014 keep a table of your own to just name and role, or point a relation field at team_member.",
     title_field: "a table's titleField is the key of a plain text-like field of that same table (a name, a title) \u2014 never a link to another table, a formula or a timed date"
   };
@@ -7900,4 +7904,59 @@ function safeReuses(spec, reuses, existingTables) {
   const out = { ...spec, tables: spec.tables.map((t) => rename.has(t.token) ? { ...t, ...rename.get(t.token) } : t) };
   return { spec: out, reuses: kept, notes, converted };
 }
+
+// src/templates/describe/result-schema.ts
+var DESCRIBE_RESULT_KIND = "describe_template_result";
+var text = { type: "string" };
+var words = (list) => ({ type: "string", enum: [...list] });
+var jsonText = { type: "string", description: "one JSON object, as text" };
+var jsonTextList = { type: "array", items: jsonText };
+var DESCRIBE_TEXT_PARTS = ["tables", "relationships", "views", "forms", "extras"];
+function describeResultJsonSchema() {
+  return {
+    type: "object",
+    required: ["__kind", "template", "notes", "reuses"],
+    properties: {
+      __kind: { type: "string", enum: [DESCRIBE_RESULT_KIND] },
+      template: {
+        type: "object",
+        required: ["id", "useCase", "industry", "vertical", "job", "teaches", "business", "tables", "forms"],
+        properties: {
+          id: text,
+          useCase: text,
+          industry: words(INDUSTRY_GROUPS),
+          vertical: text,
+          job: words(TEMPLATE_JOBS),
+          audience: words(TEMPLATE_AUDIENCES),
+          teaches: words(TEACHES_FEATURES),
+          business: jsonText,
+          tables: jsonTextList,
+          relationships: jsonTextList,
+          views: jsonTextList,
+          forms: jsonTextList,
+          extras: jsonTextList
+        }
+      },
+      notes: { type: "array", items: text },
+      reuses: { type: "array", items: { type: "object", required: ["token", "existing_table_id"], properties: { token: text, existing_table_id: text } } }
+    }
+  };
+}
+function open(value, at) {
+  if (typeof value !== "string") return value;
+  try {
+    return JSON.parse(value);
+  } catch {
+    throw new Error(`${at} was not valid JSON text.`);
+  }
+}
+function parseDescribeTemplate(template) {
+  const out = { ...template };
+  if ("business" in out) out.business = open(out.business, "business");
+  for (const k of DESCRIBE_TEXT_PARTS) {
+    const v = out[k];
+    if (Array.isArray(v)) out[k] = v.map((x, i) => open(x, `${k}[${i}]`));
+  }
+  return out;
+}
 //# sourceMappingURL=index.cjs.map