@ai-matrx/records 0.54.0 → 0.56.0

package/dist/{field-Ct7_iYEF.d.ts → types-RxnWzAWZ.d.ts}

@@ -1083,6 +1083,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "";
     readonly returns: "TABLE(function_name text, identity_args text, why text)";
     readonly security: "invoker";
+}, {
+    readonly name: "doors_refusing_in_another_doors_name";
+    readonly args: "";
+    readonly returns: "TABLE(function_name text, identity_args text, why text)";
+    readonly security: "invoker";
 }, {
     readonly name: "effective_level";
     readonly args: "p_user_id uuid, p_organization_id uuid, p_id uuid, p_type text DEFAULT 'record'::text";
@@ -1293,6 +1298,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_to jsonb, p_value jsonb";
     readonly returns: "jsonb";
     readonly security: "invoker";
+}, {
+    readonly name: "field_words";
+    readonly args: "p_organization_id uuid, p_field_id uuid, p_value jsonb";
+    readonly returns: "text";
+    readonly security: "invoker";
 }, {
     readonly name: "file_kernel_id";
     readonly args: "";
@@ -1748,6 +1758,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_organization_id uuid, p_table_id uuid DEFAULT NULL::uuid, p_dry_run boolean DEFAULT true";
     readonly returns: "jsonb";
     readonly security: "definer";
+}, {
+    readonly name: "migrate_purge_hard";
+    readonly args: "p_organization_id uuid, p_table_id uuid DEFAULT NULL::uuid, p_compliance_reason text DEFAULT NULL::text, p_chunk integer DEFAULT 200, p_dry_run boolean DEFAULT true";
+    readonly returns: "jsonb";
+    readonly security: "definer";
 }, {
     readonly name: "migrate_reclass";
     readonly args: "p_organization_id uuid, p_id uuid, p_to text DEFAULT 'field'::text, p_note text DEFAULT NULL::text";
@@ -2383,6 +2398,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_organization_id uuid, p_table_id uuid, p_data jsonb";
     readonly returns: "uuid";
     readonly security: "definer";
+}, {
+    readonly name: "record_write_graph";
+    readonly args: "p_organization_id uuid, p_table_id uuid, p_parent jsonb, p_edges jsonb DEFAULT '[]'::jsonb, p_children jsonb DEFAULT '[]'::jsonb";
+    readonly returns: "jsonb";
+    readonly security: "definer";
 }, {
     readonly name: "record_write_many";
     readonly args: "p_organization_id uuid, p_table_id uuid, p_rows jsonb[], p_ids uuid[] DEFAULT NULL::uuid[]";
@@ -2773,6 +2793,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_organization_id uuid, p_table_id uuid";
     readonly returns: "boolean";
     readonly security: "invoker";
+}, {
+    readonly name: "table_is_options_table";
+    readonly args: "p_organization_id uuid, p_table_id uuid";
+    readonly returns: "boolean";
+    readonly security: "invoker";
 }, {
     readonly name: "table_kernel_id";
     readonly args: "";
@@ -2838,6 +2863,16 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_organization_id uuid, p_table_id uuid";
     readonly returns: "text";
     readonly security: "definer";
+}, {
+    readonly name: "table_unique_rule_fields";
+    readonly args: "p_organization_id uuid, p_table_id uuid";
+    readonly returns: "jsonb";
+    readonly security: "invoker";
+}, {
+    readonly name: "table_work_kind";
+    readonly args: "p_organization_id uuid, p_table_id uuid";
+    readonly returns: "text";
+    readonly security: "invoker";
 }, {
     readonly name: "tables_at_home";
     readonly args: "p_organization_id uuid, p_home_ids uuid[]";
@@ -3350,7 +3385,7 @@ declare const STORE_REFUSAL_CODES: readonly [{
     readonly raised_by: "context_resolve";
 }, {
     readonly code: "22004";
-    readonly raised_by: "_entity_custom_fields_guard,_share_write_person,_value_envelope,actor_word,agg_assert_key,agg_sql,anon_capture,anon_token_issue,anon_write,assert_client_may_reach,booking_declare,capture_submit,checklist_declare,context_resolve,dashboard_block_normalize,dashboard_declare,dashboard_window_sql,doc_render_write,doc_sign,doc_signature_write,doc_template_save,enrich_land,enrich_normalize,external_history_event,external_rows,external_source_declare,external_stub_upsert,external_write_through,external_writes_set,field_history,form_declare,form_submit,home_add,io_comment_write,io_import_begin,io_infer_column,io_outbox_drain,io_restore,migrate_choice_keys,migrate_purge,migrate_reclass,migrate_split,migrate_undo,organization_clear,organization_contents,pipeline_declare,pipeline_gate_preview,portal_declare,portal_invite,portal_principal_bind,provenance_retention_days,provenance_write,query_across_homes,query_by_coordinates,query_rollup,record_delete,record_reparent,record_resolve,record_restore,record_update,record_write,record_write_many,relation_carry,relation_own,rule_declare,share_grant,sign_request_create,sign_request_sign,subscription_declare,table_archive,table_declare,table_share_outside_invite,value_restore,view_declare,work_approval_decide,work_approval_request,work_template_declare";
+    readonly raised_by: "_entity_custom_fields_guard,_share_write_person,_value_envelope,actor_word,agg_assert_key,agg_sql,anon_capture,anon_token_issue,anon_write,assert_client_may_reach,booking_declare,capture_submit,checklist_declare,context_resolve,dashboard_block_normalize,dashboard_declare,dashboard_window_sql,doc_render_write,doc_sign,doc_signature_write,doc_template_save,enrich_land,enrich_normalize,external_history_event,external_rows,external_source_declare,external_stub_upsert,external_write_through,external_writes_set,field_history,form_declare,form_submit,home_add,io_comment_write,io_import_begin,io_infer_column,io_outbox_drain,io_restore,migrate_choice_keys,migrate_purge,migrate_purge_hard,migrate_reclass,migrate_split,migrate_undo,organization_clear,organization_contents,pipeline_declare,pipeline_gate_preview,portal_declare,portal_invite,portal_principal_bind,provenance_retention_days,provenance_write,query_across_homes,query_by_coordinates,query_rollup,record_delete,record_reparent,record_resolve,record_restore,record_update,record_write,record_write_graph,record_write_many,relation_carry,relation_own,rule_declare,share_grant,sign_request_create,sign_request_sign,subscription_declare,table_archive,table_declare,table_share_outside_invite,value_restore,view_declare,work_approval_decide,work_approval_request,work_template_declare";
 }, {
     readonly code: "22007";
     readonly raised_by: "dashboard_window_sql";
@@ -3359,7 +3394,7 @@ declare const STORE_REFUSAL_CODES: readonly [{
     readonly raised_by: "rule_eval";
 }, {
     readonly code: "22023";
-    readonly raised_by: "_booking_availability,_entity_custom_fields_guard,_take_op_id,_value_envelope,_work_shape_guard,actor_word,agg_assert_key,agg_sql,anon_token_issue,booking_declare,containment_parent,dashboard_block_normalize,dashboard_window_sql,doc_render_body,doc_render_write,doc_signature_write,enrich_declare,enrich_land,enrich_normalize,enrich_pin,entity_value_write,external_history_event,external_source_declare,external_stub_upsert,external_write_through,field_history,field_update,io_export,io_import_begin,io_import_finish,io_import_plan,io_import_report,io_proposal_accept,list_portals,migrate_merge,migrate_reclass,my_levels,organization_clear,page_size,pin_agent_cells,pipeline_move,portal_declare,provenance_write,query_by_coordinates,query_rollup,read_records_archived,record_update,record_write_many,relation_carry,rule_eval,rule_members,share_grant,share_lane_set,sign_request_create,sign_request_sign,subscription_declare,table_rules,visibility_as_of,work_approval_request,work_list,work_slot_hold";
+    readonly raised_by: "_booking_availability,_entity_custom_fields_guard,_take_op_id,_value_envelope,_work_shape_guard,actor_word,agg_assert_key,agg_sql,anon_token_issue,booking_declare,containment_parent,dashboard_block_normalize,dashboard_window_sql,doc_render_body,doc_render_write,doc_signature_write,enrich_declare,enrich_land,enrich_normalize,enrich_pin,entity_value_write,external_history_event,external_source_declare,external_stub_upsert,external_write_through,field_history,field_update,io_export,io_import_begin,io_import_finish,io_import_plan,io_import_report,io_proposal_accept,list_portals,migrate_merge,migrate_reclass,my_levels,organization_clear,page_size,pin_agent_cells,pipeline_move,portal_declare,provenance_write,query_by_coordinates,query_rollup,read_records_archived,record_update,record_write_graph,record_write_many,relation_carry,rule_eval,rule_members,share_grant,share_lane_set,sign_request_create,sign_request_sign,subscription_declare,table_rules,visibility_as_of,work_approval_request,work_list,work_slot_hold";
 }, {
     readonly code: "23503";
     readonly raised_by: "_booking_availability,_checklist_instantiate,_containment_guard,_display_spec_for,_field_document_for,_field_type_parity_guard,_pipeline_stage_key,_record_rule_uses,agg_digest_assemble,anon_publish,anon_rate_take,anon_token_issue,anon_write,assert_organization_wall,booking_cancel,booking_confirm,booking_declare,booking_hold,booking_reschedule,capture_publish,checklist_declare,checklist_steps_table,comment_write,dashboard_declare,delete_rule,doc_sign,doc_template_save,enrich_declare,enrich_due,enrich_land,form_declare,form_submit,home_add,inbound_declare,inbound_mail_land,inbound_set,io_comment_write,io_import_begin,io_import_finish,io_import_report,io_import_rows,io_proposal_accept,migrate_demote,migrate_promote,pipeline_board,pipeline_declare,pipeline_move,pipeline_read,pipeline_transition_refusal,promote_field,promote_table,record_applicability,record_reparent,relation_carry,relation_own,resolve_first_match,rule_applies,rule_declare,rule_eval,rule_members,rule_run,sign_request_create,subscription_mute,subscription_preview,view_declare,work_set_state,work_take_assignment,work_template_instantiate";
@@ -3368,13 +3403,13 @@ declare const STORE_REFUSAL_CODES: readonly [{
     readonly raised_by: "_share_write_person,_unique_rule_holds,doc_sign,doc_signature_write,entity_field_declare,field_declare,home_add,inbound_declare,io_proposal_accept,relation_carry,relation_own,sign_request_cancel,sign_request_create,table_share_outside_resend,work_approval_decide,work_slot_hold";
 }, {
     readonly code: "23514";
-    readonly raised_by: "_checklist_instantiate,_checklist_step_guard,_containment_guard,_dated_values_guard,_derived_fields,_display_spec_for,_entity_custom_fields_guard,_field_class_guard,_field_document_for,_field_shape_guard,_field_type_parity_guard,_merge_field_shape_guard,_merge_field_temporal_guard,_promoted_field_cap_guard,_record_rule_uses,_resolve_choice_words,_rule_shape_guard,_rule_topology_guard,_store_relation_edge_names_its_field,_table_columns_word_guard,_table_shape_guard,_undeclared_key_guard,_value_envelope,_with_display,_work_shape_guard,_workdoors_approval_guard,assert_columns_are_defined,assert_entity_is_organization_scoped,booking_declare,capture_publish,capture_sheet_declare,checklist_declare,checklist_step_complete,doc_sign,doc_signature_write,doc_template_save,entity_field_declare,entity_field_retire,entity_field_update,entity_records_find,entity_table,field_declare,field_retire,field_update,home_add,io_comment_write,io_import_rows,migrate_merge,portal_archive,portal_restore,relation_carry,relation_own,sign_request_create,sign_request_sign,table_declare,validate_value_envelope,validate_values,work_set_state,work_slots_declare,work_take_assignment,work_template_instantiate";
+    readonly raised_by: "_checklist_instantiate,_checklist_step_guard,_containment_guard,_dated_values_guard,_derived_fields,_display_spec_for,_entity_custom_fields_guard,_field_class_guard,_field_document_for,_field_shape_guard,_field_type_parity_guard,_merge_field_shape_guard,_merge_field_temporal_guard,_promoted_field_cap_guard,_record_rule_uses,_relation_halves_agree,_resolve_choice_words,_rule_shape_guard,_rule_topology_guard,_store_relation_edge_names_its_field,_table_columns_word_guard,_table_shape_guard,_undeclared_key_guard,_value_envelope,_with_display,_work_shape_guard,_workdoors_approval_guard,assert_columns_are_defined,assert_entity_is_organization_scoped,booking_declare,capture_publish,capture_sheet_declare,checklist_declare,checklist_step_complete,doc_sign,doc_signature_write,doc_template_save,entity_field_declare,entity_field_retire,entity_field_update,entity_records_find,entity_table,field_declare,field_retire,field_update,home_add,io_comment_write,io_import_rows,migrate_merge,migrate_purge_hard,portal_archive,portal_restore,record_write_graph,relation_carry,relation_own,sign_request_create,sign_request_sign,table_declare,validate_value_envelope,validate_values,work_set_state,work_slots_declare,work_take_assignment,work_template_instantiate";
 }, {
     readonly code: "40001";
     readonly raised_by: "has_visibility_at";
 }, {
     readonly code: "42501";
-    readonly raised_by: "_doc_render_immutable,_doc_signature_immutable,_field_definition_write,_field_write_door,_rule_definition_write,_store_door,agent_table_claim,anon_capture,anon_inbound_land,anon_publish,anon_token_issue,anon_token_verify,anon_write,assert_client_may_change,assert_client_may_open,assert_client_may_reach,assert_may_know_table,assert_organization_admin,assert_store_door,booking_confirm,booking_declare,booking_hold,capture_submit,checklist_run,comment_write,conversation_scope_bind,conversation_scope_unbind,doc_sign,enrich_declare,enrich_due,enrich_land,enrich_normalize,entity_field_declare,entity_field_retire,entity_field_update,entity_value_write,external_write_through,form_declare,form_submit,inbound_mail_land,io_comment_resolve,io_comment_write,io_import_begin,io_import_finish,io_restore,migrate_purge,migrate_reclass,my_levels,organization_clear,portal_declare,portal_invitation,portal_invite,portal_invite_accept,portal_principal_bind,promote_table,query_visibility_parity,read_record,read_records,read_records_archived,read_records_by_ids,read_records_matching,record_table,share_grant,subscription_mute,subscription_preview,table_share_outside_accept,table_share_outside_invite,table_share_outside_resend,visibility_as_of,work_approval_decide,work_approval_read,work_approval_request,work_person";
+    readonly raised_by: "_doc_render_immutable,_doc_signature_immutable,_field_definition_write,_field_write_door,_rule_definition_write,_store_door,agent_table_claim,anon_capture,anon_inbound_land,anon_publish,anon_token_issue,anon_token_verify,anon_write,assert_client_may_change,assert_client_may_open,assert_client_may_reach,assert_may_know_table,assert_organization_admin,assert_store_door,booking_confirm,booking_declare,booking_hold,capture_submit,checklist_run,comment_write,conversation_scope_bind,conversation_scope_unbind,doc_sign,enrich_declare,enrich_due,enrich_land,enrich_normalize,entity_field_declare,entity_field_retire,entity_field_update,entity_value_write,external_write_through,form_declare,form_submit,inbound_mail_land,io_comment_resolve,io_comment_write,io_import_begin,io_import_finish,io_restore,migrate_purge,migrate_purge_hard,migrate_reclass,my_levels,organization_clear,portal_declare,portal_invitation,portal_invite,portal_invite_accept,portal_principal_bind,promote_table,query_visibility_parity,read_record,read_records,read_records_archived,read_records_by_ids,read_records_matching,record_table,record_write_graph,share_grant,subscription_mute,subscription_preview,table_share_outside_accept,table_share_outside_invite,table_share_outside_resend,visibility_as_of,work_approval_decide,work_approval_read,work_approval_request,work_person";
 }, {
     readonly code: "42703";
     readonly raised_by: "entity_table,portal_declare";
@@ -3779,6 +3814,27 @@ interface RecordDocument {
     [fieldKey: string]: unknown;
 }
 /** `custom.record` as the store holds it — the row around the document. */
+/**
+ * What `custom.record_write_graph` wrote — a parent, the rows that belong to it, and the
+ * edges it stands on, all in one transaction.
+ *
+ * `edges` counts BOTH writers: the edges written through `public.assoc_add` (whose ids are
+ * in `edge_ids`) and the relation targets written through `platform.relation_set`, which
+ * answers a count rather than ids because a relation is one field's worth of targets and
+ * not a list of independent edges. `relations` is that second number on its own, so a
+ * caller can tell them apart instead of subtracting.
+ */
+interface RecordGraphWritten {
+    parent_id: Uuid;
+    table_id: Uuid | null;
+    child_ids: Uuid[];
+    edge_ids: Uuid[];
+    children: number;
+    edges: number;
+    relations: number;
+    /** The door's own sentence about what it did. Shown, never re-worded. */
+    how: string;
+}
 interface StoredRecord {
     id: Uuid;
     organization_id: Uuid;
@@ -4203,4 +4259,338 @@ interface FieldPatch {
     expr?: Record<string, unknown>;
 }
 
-export { MERGE_FIELD_SEMANTIC_TYPES as $, ABSENCE_REASONS as A, DELIVERIES as B, type ComputeOn as C, DECLARABLE_FIELD_KINDS as D, type DeclarableFieldKind as E, type FieldTypeWord as F, type Delivery as G, ENTITY_TOKENS as H, type EntityToken as I, FIELD_SENSITIVITIES as J, FIELD_SOURCES as K, FRESHNESS as L, type FieldBehavior as M, type NewFieldDeclaration as N, type OnDelete as O, type PgError as P, type ForbiddenEnvelopeWord as Q, type RelationFlavor as R, type StorageMode as S, type TableType as T, type Uuid as U, type Freshness as V, type WriteConflict as W, type HiddenFieldNotice as X, KERNEL_TABLES as Y, type KernelTableName as Z, MERGE_FIELD_MODIFIERS as _, type TableDisplay as a, MERGE_FIELD_SOURCES as a0, type MergeFieldModifier as a1, type MergeFieldSemanticType as a2, type MergeFieldSource as a3, ON_DELETE as a4, OVERRIDE_POLICIES as a5, type OverridePolicy as a6, PARITY_FIELD_TYPES as a7, PER_VALUE_ACCESS_WORDS as a8, type ParityFieldType as a9, VALUE_ENVELOPE_KEYS as aA, type ValueAlternate as aB, type ValueAlternateKey as aC, type ValueEnvelope as aD, type ValueEnvelopeKey as aE, type ValueSource as aF, err as aG, isRecordsErr as aH, ok as aI, type ParityFieldTypeDescriptor as aa, type PerValueAccessWord as ab, type ProvenancePointer as ac, RELATION_BINDINGS as ad, RELATION_CARDINALITIES as ae, RELATION_FLAVORS as af, RETIRED_ACTOR_WORDS as ag, RULE_NODE_KINDS as ah, RULE_USES as ai, type RecordsErrorCode as aj, type RelationBinding as ak, type RelationDisplay as al, type RetiredActorWord as am, type RuleNodeKind as an, type RuleUse as ao, STORAGE_MODES as ap, STORE_DOORS as aq, STORE_KNOBS as ar, STORE_REFUSAL_CODES as as, type StoreDoorName as at, type StoreRefusalCode as au, TABLE_DISPLAYS as av, TABLE_ORIGINS as aw, TABLE_TYPES as ax, type TableOrigin as ay, VALUE_ALTERNATE_KEYS as az, type FieldSource as b, type FieldRule as c, type FieldSensitivity as d, type ContextPolicy as e, type RelationCardinality as f, type Timestamp as g, type RecordDocument as h, type RecordsResult as i, type RecordRead as j, type ReadRow as k, type Field as l, type StoredRecord as m, type FieldPatch as n, type RecordRevision as o, type ReadValue as p, type FieldProposal as q, type TableProposal as r, type RecordsError as s, type StaleWriteDetail as t, type PredictedRefusal as u, ACTOR_VOCABULARY as v, type AbsenceReason as w, type Actor as x, COMPUTE_ON as y, CONTEXT_POLICIES as z };
+/**
+ * Who the data belongs to. A test organization is created under this name — the
+ * owner's law #4: every organization, table, record, form, portal, dashboard,
+ * document, checklist, booking page, capture sheet, subscription, pipeline and
+ * enrichment created for a test carries the use case's own name. Cleanup finds
+ * a test organization by `cleanupTag` in its settings, NEVER by a junk name.
+ */
+interface BusinessIdentity {
+    /** "Harbor Dental Group" — what goes on the organization, the invoice, the screenshot. */
+    name: string;
+    /** "Harbor Dental Group, PLLC" — used on documents that need the legal entity. */
+    legalName?: string;
+    /** One line a stranger would understand: "A six-chair family dental practice." */
+    describes: string;
+    /** Plausible and synthesized. Never a real business's real address. */
+    address: PostalAddress;
+    /** Synthesized, E.164-shaped or the local convention the document uses. */
+    phone: string;
+    /**
+     * Synthesized. NOT a `.example` domain — those read as fake on a screenshot.
+     * Optional, because the law welcomes personal-life use cases and a household
+     * renovation or a family recipe collection genuinely has no website.
+     */
+    website?: string;
+    /** Synthesized mailbox on the same domain: "frontdesk@harbordentalgroup.com". */
+    email: string;
+    /** IANA zone, so dates in the rows make sense together. */
+    timezone: string;
+}
+interface PostalAddress {
+    line1: string;
+    line2?: string;
+    city: string;
+    /** State, province or region, in the country's own convention. */
+    region: string;
+    postalCode: string;
+    /** ISO 3166-1 alpha-2. */
+    country: string;
+}
+/**
+ * One table of the business, in the words the practitioner uses. `token` is the
+ * slug the store addresses it by; `name` is what a person reads.
+ */
+interface UseCaseTable {
+    /** snake_case, singular, the practitioner's noun: "patient", "work_order". */
+    token: string;
+    /** "Patients", "Work orders". */
+    name: string;
+    labelSingular: string;
+    labelPlural: string;
+    /** REC-32. One of the seven, closed. Most business tables are `entity`. */
+    type: TableType;
+    display: TableDisplay;
+    /** REC-4. `light` is the whole document; `heavy` is indexed on write. */
+    weight: StorageMode;
+    ordered: boolean;
+    /** A lucide icon name, so the screen is not a wall of identical rows. */
+    icon?: string;
+    /** REC-2. The field key whose value titles a record. Must be a declared field. */
+    titleField: string;
+    /** What this table is FOR, in the practitioner's words. */
+    describes: string;
+    fields: UseCaseField[];
+    /** The seed rows. Enough that the screen looks like a working business. */
+    rows: UseCaseRow[];
+}
+/**
+ * One field. `parityType` is the word a person picks in the UI and it must be
+ * one the store resolves — any parity type the store ships, any behaviour they
+ * are made of, or one of the plain synonyms (see `FieldTypeWord`). The set is
+ * `RESOLVABLE_FIELD_TYPE_WORDS`, derived from the registry; never a count or a
+ * list typed out here.
+ */
+interface UseCaseField {
+    /** snake_case, the practitioner's own name for it: "date_of_birth", "po_number". */
+    key: string;
+    /** "Date of birth", "PO number". Sentence case, the way the form reads. */
+    label: string;
+    parityType: FieldTypeWord;
+    /** FLD-2. The shape of the value, never a second behaviour. */
+    multi?: boolean;
+    /** FLD-2. The values carry their own dates. */
+    dated?: boolean;
+    required?: boolean;
+    /** FLD-N-1. The unit CHANGES THE MEANING and lives on the field: "USD", "lb", "mi". */
+    unit?: string | null;
+    /** "currency", "percent", "email", "phone", "url", "date". Never decoration. */
+    format?: string | null;
+    /** FLD-7. Where the values come from. Defaults to `manual`. */
+    source?: FieldSource;
+    /** FLD-9. A formula says whether it computes on read or on write. */
+    computeOn?: ComputeOn;
+    /** FLD-3. Validation rules the store will enforce. */
+    rules?: FieldRule[];
+    /**
+     * For `select` / `multi_select`: the REAL lifecycle words of this business,
+     * in the order they actually happen. "Scheduled, Confirmed, Seen, No-show" —
+     * never "Option A, Option B".
+     */
+    choices?: string[];
+    /** For a relation field: the `token` of the table it points at. */
+    relationTarget?: string;
+    relationMax?: number;
+    /** AGT-7. The ceiling a merge field's delivery can never widen. */
+    sensitivity: FieldSensitivity;
+    /** FLD-12. Whether an agent may see this field's values at all. */
+    contextPolicy: ContextPolicy;
+    /** What the practitioner would be told about this field, if anything. */
+    help?: string;
+}
+/**
+ * One row of seed data.
+ *
+ * `key` is a stable LOCAL id (not a UUID): relationships across tables point at
+ * it, so a template is readable and a seeder can resolve the graph in one pass
+ * without inventing identifiers. Use a meaningful slug — "patient-rivera-m",
+ * not "row-7".
+ */
+interface UseCaseRow {
+    key: string;
+    /**
+     * Keyed by the table's field keys. A relation field's value is the `key` (or
+     * an array of keys) of rows in the target table.
+     */
+    values: Record<string, unknown>;
+}
+/**
+ * REL-1…REL-9. The domain truth, stated once: "an invoice belongs to the job it
+ * bills, and a job belongs to the client who asked for it."
+ *
+ * The field side carries `relationTarget`; this is the declaration a seeder
+ * reads, because it also carries the flavour, the cardinality, what happens to
+ * the far side on delete, and the reverse name.
+ */
+interface UseCaseRelationship {
+    /** One sentence of domain truth. Not "links A to B". */
+    describes: string;
+    /** The table that HOLDS the relation field. */
+    fromTable: string;
+    /** The field key on `fromTable`. Must be declared and must be a relation. */
+    fromField: string;
+    /** The `token` of the table it points at. */
+    toTable: string;
+    /** REL-1. Ownership is one fact, stored once, read from the field's side. */
+    flavor: RelationFlavor;
+    /** REL-7. */
+    cardinality: RelationCardinality;
+    /** REL-2. What happens to the far side, separate from flavour. */
+    onDelete: OnDelete;
+    /** REL-9. The reverse, visible from both ends, and NOT a second field. */
+    inverseKey: string;
+}
+/** Who is allowed to open a form. */
+type FormAudience = "public" | "member" | "staff";
+/**
+ * A form a practitioner in this business would actually put in front of someone
+ * — "the Harbor Dental new-patient intake", never "Test Form 1".
+ */
+interface UseCaseForm {
+    token: string;
+    name: string;
+    /** What it is for, and who fills it in. */
+    describes: string;
+    audience: FormAudience;
+    /** The table a submission becomes a record of. */
+    table: string;
+    fields: UseCaseFormField[];
+    submitLabel: string;
+    /** What the person sees after they submit. Real words, not "Success!". */
+    confirmation: string;
+}
+interface UseCaseFormField {
+    /** A field key on the form's table. */
+    fieldKey: string;
+    /** Override the field's own label when the form asks it differently. */
+    label?: string;
+    required?: boolean;
+    /** The helper line under the input, if a practitioner would want one. */
+    help?: string;
+}
+/**
+ * The real lifecycle a record moves through in this business, in order. A
+ * pipeline's stages are the words the staff say out loud.
+ */
+interface UseCasePipeline {
+    token: string;
+    name: string;
+    describes: string;
+    /** The table whose records move through it. */
+    table: string;
+    /** The `select` field that holds the current stage. */
+    stageField: string;
+    stages: UseCasePipelineStage[];
+}
+interface UseCasePipelineStage {
+    /** Must appear in the stage field's `choices`. */
+    key: string;
+    label: string;
+    /** What is true of a record sitting here, and what moves it on. */
+    describes: string;
+    /** Roughly how long a record sits here, so a board looks believable. */
+    typicalDurationDays?: number;
+}
+/**
+ * The question the owner of this business actually asks a dashboard on Monday
+ * morning — "how much have we invoiced this month that hasn't been paid?" —
+ * plus how it is answered from the tables above.
+ */
+interface UseCaseDashboardQuestion {
+    /** The question in the practitioner's own words, ending in a question mark. */
+    question: string;
+    /** Why they care. What they DO differently depending on the answer. */
+    whyItMatters: string;
+    table: string;
+    aggregate: "count" | "sum" | "avg" | "min" | "max";
+    /** The field aggregated. Omitted only for `count`. */
+    of?: string;
+    groupBy?: string;
+    /** A plain-language filter: "status is Unpaid and due_date is before today". */
+    filter?: string;
+    /** What the number IS: "USD", "days", "appointments". */
+    answerUnit: string;
+}
+/**
+ * A document this business really sends. The body carries merge fields in
+ * `{{double_brace}}` form; every one of them is declared below and resolves to a
+ * field on the document's table (or a stated literal).
+ */
+interface UseCaseDocumentTemplate {
+    token: string;
+    name: string;
+    describes: string;
+    table: string;
+    /** The subject or title line, merge fields allowed. */
+    title: string;
+    /** The body. Real prose this business would send, merge fields inline. */
+    body: string;
+    mergeFields: UseCaseMergeField[];
+}
+interface UseCaseMergeField {
+    /** The token inside `{{ }}` in the body. */
+    key: string;
+    /**
+     * The field key it reads, on the document's table — or, when it is not a
+     * field, the word `business` (from `BusinessIdentity`) or `today`.
+     */
+    from: string;
+    describes: string;
+}
+/** How a notification reaches someone. */
+type NotificationChannel = "email" | "sms" | "in_app";
+/**
+ * The one automatic message this business would genuinely want — the thing a
+ * practitioner sets up on day one and never turns off.
+ */
+interface UseCaseNotificationRule {
+    token: string;
+    name: string;
+    describes: string;
+    when: UseCaseNotificationTrigger;
+    /** Who it goes to, in the business's own words: "the assigned hygienist". */
+    audience: string;
+    channel: NotificationChannel;
+    /** The actual message. Merge fields allowed, same convention as documents. */
+    message: string;
+}
+interface UseCaseNotificationTrigger {
+    table: string;
+    event: "created" | "updated" | "stage_entered" | "due" | "overdue";
+    /** For `stage_entered`: the stage key. */
+    stage?: string;
+    /** For `due` / `overdue`: the date field watched. */
+    field?: string;
+    /** For `due`: how many days ahead it fires. */
+    daysBefore?: number;
+}
+/**
+ * Where the shape and the values came from. `synthesized` means a person wrote
+ * plausible values out of domain knowledge; `public-data` means the numbers or
+ * names were derived from a genuinely public dataset, which is named.
+ *
+ * Either way the law holds: no real person, no real customer, no production row.
+ */
+interface UseCaseProvenance {
+    kind: "synthesized" | "public-data";
+    /** Named when `kind` is `public-data`. */
+    source?: string;
+    /** Who or what wrote this file, and when. */
+    authoredBy: string;
+    authoredOn: string;
+    /**
+     * The affirmation, carried in the data so a reviewer can see it: every person,
+     * address, phone and mailbox here is invented and belongs to nobody.
+     */
+    noRealPeople: true;
+}
+/** One real business, and everything a test, seed, demo or screenshot needs of it. */
+interface UseCase {
+    /** kebab-case and unique: "harbor-dental-new-patient-intake". */
+    id: string;
+    /**
+     * THE SENTENCE. Who the user is, what business they run, and what job this
+     * exact feature does for them — one sentence, at the top, before anything
+     * else. This is the first thing the law asks for and the validator checks it.
+     */
+    useCase: string;
+    /** The industry, for rotation: "Dentistry", "Property management". */
+    industry: string;
+    business: BusinessIdentity;
+    /**
+     * The tag written into a test organization's settings so cleanup can find it.
+     * Cleanup finds test data by THIS, never by a junk name.
+     */
+    cleanupTag: string;
+    tables: UseCaseTable[];
+    relationships: UseCaseRelationship[];
+    form: UseCaseForm;
+    pipeline: UseCasePipeline;
+    dashboardQuestion: UseCaseDashboardQuestion;
+    documentTemplate: UseCaseDocumentTemplate;
+    notificationRule: UseCaseNotificationRule;
+    provenance: UseCaseProvenance;
+}
+/** What the registry lists without loading a use case's rows. */
+interface UseCaseSummary {
+    id: string;
+    useCase: string;
+    industry: string;
+    businessName: string;
+    /** How many tables and rows the file carries, so a caller can pick by size. */
+    tableCount: number;
+    rowCount: number;
+}
+
+export { type EntityToken as $, type TableProposal as A, type BusinessIdentity as B, type RecordsError as C, type PgError as D, type StaleWriteDetail as E, type FormAudience as F, type PredictedRefusal as G, ABSENCE_REASONS as H, ACTOR_VOCABULARY as I, type AbsenceReason as J, type Actor as K, COMPUTE_ON as L, CONTEXT_POLICIES as M, type NotificationChannel as N, type ComputeOn as O, type PostalAddress as P, type ContextPolicy as Q, type RecordDocument as R, type StoredRecord as S, type Timestamp as T, type UseCase as U, DECLARABLE_FIELD_KINDS as V, type WriteConflict as W, DELIVERIES as X, type DeclarableFieldKind as Y, type Delivery as Z, ENTITY_TOKENS as _, type UseCaseSummary as a, err as a$, FIELD_SENSITIVITIES as a0, FIELD_SOURCES as a1, FRESHNESS as a2, type FieldBehavior as a3, type FieldRule as a4, type FieldSensitivity as a5, type FieldSource as a6, type FieldTypeWord as a7, type ForbiddenEnvelopeWord as a8, type Freshness as a9, type RelationBinding as aA, type RelationCardinality as aB, type RelationDisplay as aC, type RelationFlavor as aD, type RetiredActorWord as aE, type RuleNodeKind as aF, type RuleUse as aG, STORAGE_MODES as aH, STORE_DOORS as aI, STORE_KNOBS as aJ, STORE_REFUSAL_CODES as aK, type StorageMode as aL, type StoreDoorName as aM, type StoreRefusalCode as aN, TABLE_DISPLAYS as aO, TABLE_ORIGINS as aP, TABLE_TYPES as aQ, type TableDisplay as aR, type TableOrigin as aS, type TableType as aT, VALUE_ALTERNATE_KEYS as aU, VALUE_ENVELOPE_KEYS as aV, type ValueAlternate as aW, type ValueAlternateKey as aX, type ValueEnvelope as aY, type ValueEnvelopeKey as aZ, type ValueSource as a_, type HiddenFieldNotice as aa, KERNEL_TABLES as ab, type KernelTableName as ac, MERGE_FIELD_MODIFIERS as ad, MERGE_FIELD_SEMANTIC_TYPES as ae, MERGE_FIELD_SOURCES as af, type MergeFieldModifier as ag, type MergeFieldSemanticType as ah, type MergeFieldSource as ai, ON_DELETE as aj, OVERRIDE_POLICIES as ak, type OnDelete as al, type OverridePolicy as am, PARITY_FIELD_TYPES as an, PER_VALUE_ACCESS_WORDS as ao, type ParityFieldType as ap, type ParityFieldTypeDescriptor as aq, type PerValueAccessWord as ar, type ProvenancePointer as as, RELATION_BINDINGS as at, RELATION_CARDINALITIES as au, RELATION_FLAVORS as av, RETIRED_ACTOR_WORDS as aw, RULE_NODE_KINDS as ax, RULE_USES as ay, type RecordsErrorCode as az, type UseCaseDashboardQuestion as b, isRecordsErr as b0, ok as b1, type UseCaseDocumentTemplate as c, type UseCaseField as d, type UseCaseForm as e, type UseCaseFormField as f, type UseCaseMergeField as g, type UseCaseNotificationRule as h, type UseCaseNotificationTrigger as i, type UseCasePipeline as j, type UseCasePipelineStage as k, type UseCaseProvenance as l, type UseCaseRelationship as m, type UseCaseRow as n, type UseCaseTable as o, type Uuid as p, type RecordsResult as q, type RecordGraphWritten as r, type RecordRead as s, type ReadRow as t, type Field as u, type NewFieldDeclaration as v, type FieldPatch as w, type RecordRevision as x, type ReadValue as y, type FieldProposal as z };

package/dist/use-cases/index.cjs

@@ -2182,6 +2182,21 @@ var PLACEHOLDER_PATTERNS = [
     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.)"
   },
+  {
+    // ADDED 2026-09-23, lane ORG-CLEANUP-2, after 48 organizations named "Throwaway Dash
+    // 3fee58c2", "Throwaway Pipe 21d0e260" walked back onto the owner's organization
+    // picker overnight and this list could not see ONE of them: 28 of the 48 carried no
+    // `zz` at all. "Throwaway" is the word a test writes when it means "I will delete this
+    // later", and later never comes — the row outlives the run and the screen shows it.
+    //
+    // `iam.placeholder_in_a_name(name, slug)` on the platform database carries the SAME
+    // list and refuses these at the organization door; the two are deliberate mirrors and
+    // a pattern added to one belongs in the other.
+    id: "throwaway",
+    test: /\bthrow[\s_-]?away\b|\bdisposable[\s_-]org|\bsafe[\s_-]to[\s_-]delete\b|\btest[\s_-]only\b/gi,
+    why: "'Throwaway' / 'safe to delete' is a promise to clean up later that nothing keeps \u2014 the row survives the run and shows up on the owner's screen.",
+    instead: "Name it after the real business the use case is about, reuse the SAME one by slug run after run, and carry the classification in settings.test_fixture so cleanup can find it."
+  },
   {
     id: "test-table",
     test: /\btest[\s_-]table\b|\bmy[\s_-]table\b|\bsample[\s_-]table\b/gi,