@ai-matrx/records 0.29.0 → 0.36.0

package/dist/use-cases/index.d.cts

@@ -1,4 +1,4 @@
-import { T as TableType, a as TableDisplay, S as StorageMode, F as FieldTypeWord, b as FieldSource, C as ComputeOn, c as FieldRule, d as FieldSensitivity, e as ContextPolicy, R as RelationFlavor, f as RelationCardinality, O as OnDelete } from '../field-DrOTIPCF.cjs';
+import { T as TableType, a as TableDisplay, S as StorageMode, F as FieldTypeWord, b as FieldSource, C as ComputeOn, c as FieldRule, d as FieldSensitivity, e as ContextPolicy, R as RelationFlavor, f as RelationCardinality, O as OnDelete } from '../field-CWBdZfFv.cjs';
 
 /**
  * Who the data belongs to. A test organization is created under this name — the

package/dist/use-cases/index.d.ts

@@ -1,4 +1,4 @@
-import { T as TableType, a as TableDisplay, S as StorageMode, F as FieldTypeWord, b as FieldSource, C as ComputeOn, c as FieldRule, d as FieldSensitivity, e as ContextPolicy, R as RelationFlavor, f as RelationCardinality, O as OnDelete } from '../field-DrOTIPCF.js';
+import { T as TableType, a as TableDisplay, S as StorageMode, F as FieldTypeWord, b as FieldSource, C as ComputeOn, c as FieldRule, d as FieldSensitivity, e as ContextPolicy, R as RelationFlavor, f as RelationCardinality, O as OnDelete } from '../field-CWBdZfFv.js';
 
 /**
  * Who the data belongs to. A test organization is created under this name — the

package/dist/use-cases/index.js

@@ -2130,10 +2130,24 @@ var PLACEHOLDER_PATTERNS = [
     instead: "Write the sentence this business would really send."
   },
   {
+    // TWO Zs, NOT THREE (widened 2026-09-21, lane ZZ-SWEEP-2). `ZZ W4-AGG Red`,
+    // `ZZ HQ`, `zz_a_deal` are the same junk as `ZZZ …` and were the larger
+    // half of it: 791 of them across 88 campaign-suite files when this widened.
+    //
+    // BUT A LEADING `zz` ON A DATABASE TRIGGER IS NOT A NAME, IT IS AN ORDERING
+    // DEVICE. PostgreSQL fires triggers in alphabetical order of their name and
+    // gives no other way to say "last", so this platform spells "last" with
+    // z's: 591 live triggers across 79 distinct names — `zz0_table_owner`,
+    // `zz_memo_clear_i`, `zzz_history_capture_s_u`, `zzzz_unique_rule_holds` —
+    // where each extra z buys another rung. A suite that asserts which triggers
+    // fire on `custom.record` MUST quote those names exactly. Reddening on them
+    // would be this file's own "catch the junk, never the vocabulary" rule
+    // broken, so a line that is talking about triggers is exempt.
     id: "zzz-prefix",
-    test: /\bzzz+[\s_-]/gi,
-    why: "A 'ZZZ \u2026' name exists to sort test rows to the bottom and to be deleted; it makes every screen look broken.",
-    instead: "Give it the use case's own name and find it for cleanup by the organization's cleanup tag."
+    test: /\bzz+[\s_-]/gi,
+    unlessLineMatches: /\btriggers?\b|\btgname\b|\btgrelid\b|\btgenabled\b|\bpg_trigger\b/i,
+    why: "A 'ZZ \u2026' / 'ZZZ \u2026' name exists to sort test rows to the bottom and to be deleted; it makes every screen look broken.",
+    instead: "Give it the use case's own name and find it for cleanup by the organization's cleanup tag. (On a TRIGGER the prefix is a firing-order device, not a name \u2014 say 'trigger' on the line and it is exempt.)"
   },
   {
     id: "test-table",
@@ -2165,6 +2179,38 @@ var PLACEHOLDER_PATTERNS = [
     why: "A repeated stand-in person is the tell that nobody modelled the domain.",
     instead: "Synthesize varied, plausible people who belong to nobody \u2014 and never copy a real person."
   },
+  {
+    // THE CHAIR'S RULING, 2026-09-21. People in a template are fictional but
+    // REALISTIC, and a realistic person's mailbox is a mailbox — not a mailbox
+    // with a counter welded to the end of it. `linda.reyes0@…`,
+    // `wei.singh.m34@…` are the tell that a loop wrote the row, and the owner
+    // reads a whole column of them as one fake person repeated.
+    //
+    // NARROW ON PURPOSE: it fires only when the local part is name-shaped
+    // (two or more words joined by . _ or -) AND ends in a bare counter. That
+    // is exactly the generator's signature and leaves the real mailboxes a
+    // business has — `support365@`, `ap2@`, `frontdesk@` — alone.
+    id: "suffixed-mailbox",
+    test: /\b[a-z]+(?:[._-][a-z]+)+\d{1,3}@/gi,
+    why: "A mailbox whose name ends in a counter (linda.reyes0@, wei.singh.m34@) is a generated row wearing a person's name.",
+    instead: "Give each person their own mailbox on the fictional business's own domain \u2014 'linda.reyes@handsandhopealliance.org' \u2014 and vary the people instead of numbering one."
+  },
+  {
+    // THE CHAIR'S RULING, 2026-09-21. "Test fixture" is a CLASSIFICATION, and a
+    // classification lives in the organization's kind/metadata — the
+    // `test_fixture` flag in its settings, which is how cleanup finds it. It is
+    // never part of a NAME, because a name is what the owner reads on the
+    // screen and "Birchwood Ave Renovation (test fixture)" tells him the
+    // product is a rehearsal.
+    //
+    // The settings KEY is the right place, so a line that is writing the key is
+    // exempt; a line that is writing the words into text is not.
+    id: "fixture-in-name",
+    test: /\(\s*test\s+fixture\s*\)|\btest[\s_-]fixture\b|\bfixture[\s_-]org(?:anization|anisation)?\b/gi,
+    unlessLineMatches: /["'`]?test_fixture["'`]?\s*[:=]|\bp_settings\b|\bcleanupTag\b|\bsettings\.[a-z_]*fixture\b/i,
+    why: "'Test fixture' is a classification, not a name. In a name it tells the owner the screen he is looking at is a rehearsal.",
+    instead: "Name the organization after the business the use case is about, and carry the classification in its settings (`test_fixture: true`), which is also how cleanup finds it."
+  },
   {
     id: "keyboard-mash",
     test: /\basdf+\b|\bqwerty\b|\bxxx+\b|\btodo name\b|\bfixme\b|\btbd\b/gi,
@@ -2200,6 +2246,7 @@ function describePlaceholder(hit) {
 var STORAGE_MODES = ["light", "heavy"];
 var PARITY_FIELD_TYPES = [
   { parity_type: "attachment", behavior: "relation", made_of: "REC-31: a File record reached through a relation, target the kernel `File` Table" },
+  { parity_type: "checkbox", behavior: "boolean", made_of: "a ticked or unticked answer, stored as a REAL boolean \u2014 and a record that never answered holds neither, so filters and group-by see three states, not two" },
   { parity_type: "currency", behavior: "range", made_of: "FLD-N-1: a number whose UNIT is the currency and whose format is currency \u2014 on the Field, never in presentation" },
   { parity_type: "datetime", behavior: "range", made_of: "a range of kind date or datetime \u2014 the dated modifier says the VALUES are dated, which is a different question" },
   { parity_type: "email", behavior: "text", made_of: "text whose format is email" },
@@ -2253,6 +2300,21 @@ var MIN_ROWS_IN_PRIMARY_TABLE = 5;
 function fieldsByKey(table) {
   return new Map(table.fields.map((f) => [f.key, f]));
 }
+var FIXTURE_IN_NAME = /\(\s*test\s+fixture\s*\)|\btest[\s_-]fixture\b|^\s*fixtures?\b/i;
+function nameFields(useCase5) {
+  const out = [
+    ["business.name", useCase5.business?.name],
+    ["business.legalName", useCase5.business?.legalName],
+    ["form.name", useCase5.form?.name],
+    ["pipeline.name", useCase5.pipeline?.name]
+  ];
+  useCase5.tables?.forEach((table, ti) => {
+    out.push([`tables[${ti}].name`, table.name]);
+    out.push([`tables[${ti}].labelSingular`, table.labelSingular]);
+    out.push([`tables[${ti}].labelPlural`, table.labelPlural]);
+  });
+  return out;
+}
 function validateUseCase(useCase5) {
   const problems = [];
   const say = (at, says) => problems.push({ at, says });
@@ -2269,6 +2331,15 @@ function validateUseCase(useCase5) {
   for (const hit of findPlaceholders(JSON.stringify(useCase5, null, 1))) {
     say(useCase5.id, describePlaceholder(hit));
   }
+  for (const [at, value] of nameFields(useCase5)) {
+    if (!value) continue;
+    if (FIXTURE_IN_NAME.test(value)) {
+      say(
+        at,
+        `"${value}" carries the test-fixture classification in a name. Name it after the business this use case is about, and carry the classification where it belongs \u2014 \`test_fixture: true\` in the organization's settings, which is also how cleanup finds it (never by a junk name).`
+      );
+    }
+  }
   if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(useCase5.id ?? "")) {
     say("id", `The id "${useCase5.id}" should be kebab-case, like "harbor-dental-new-patient-intake".`);
   }