@ai-matrx/records 0.72.14 → 0.72.24

package/dist/templates/index.d.ts

@@ -1,1178 +1,11 @@
-import { p as DashboardBlockKind, h as AggregateMeasure, e as AggregateBucket, q as AggregateFilter, r as SubscriptionCadence, s as AggregateOperation, t as RecordsDataSource } from '../ports-Bhu2Q3V0.js';
-import { d as UseCaseField, o as UseCaseRow, f as UseCaseFormField, i as UseCaseNotificationTrigger, N as NotificationChannel, U as UseCase, p as UseCaseTable, e as UseCaseForm, m as UseCaseProvenance, l as UseCaseProblem } from '../validate-QtFxMmJc.js';
+import { A as AgentSnapshotRow, T as TemplateSpec, a as TemplateTable, S as SharedBlockId, C as CapabilityWord, b as TemplateField, c as TemplateAgent, d as TemplateAutomation, e as TemplateBooking, f as TemplateChecklist, g as TemplateDashboard, h as TemplateDigest, i as TemplateDocument, j as TemplateDrillDown, k as TemplateDimensions, l as TemplateForm, m as TemplateNotification, n as TemplatePortal, o as TemplateRowAction, p as TemplateStageRules, q as TemplateView, r as TemplateMergeBinding, s as TemplateTryIt, t as TemplateWorkflow, u as TemplateFootprint } from '../types-DxVoKKpL.js';
+export { v as CAPABILITY_WORDS, w as CATALOGUE_QUOTAS, x as CATALOGUE_STATUSES, y as CHOICE_COLORS, z as CatalogueRow, B as CatalogueStatus, D as ChoiceColor, E as ConfidentialLevel, F as ConfidentialRequest, G as DEFAULT_TEMPLATE_AGENT, H as ENTITY_REFERENCE_KINDS, I as INDUSTRY_GROUPS, J as IndustryGroup, R as RELATIVE_DATE, K as RetiredId, L as SHARED_BLOCKS, M as SHARED_BLOCK_IDS, N as STRENGTHS, O as SharedBlock, P as SharedBlockField, Q as SharedBlockUse, U as Strength, V as TABLE_KERNEL_ID, W as TEACHES_FEATURES, X as TEMPLATE_AUDIENCES, Y as TEMPLATE_EXTRA_KINDS, Z as TEMPLATE_JOBS, _ as TEMPLATE_REFERENCE_DATE, $ as TEMPLATE_SPEC_VERSION, a0 as TEMPLATE_VIEW_KINDS, a1 as TeachesFeature, a2 as TemplateAgentQuestion, a3 as TemplateAgentVariable, a4 as TemplateAudience, a5 as TemplateBookingWindow, a6 as TemplateCalendarView, a7 as TemplateChecklistStep, a8 as TemplateConfidential, a9 as TemplateConfidentialReader, aa as TemplateDashboardBlock, ab as TemplateDimensionOverride, ac as TemplateDrillPath, ad as TemplateExtra, ae as TemplateExtraAgent, af as TemplateExtraAgentVariable, ag as TemplateExtraKind, ah as TemplateFormField, ai as TemplateFoundation, aj as TemplateGalleryView, ak as TemplateGridView, al as TemplateGuideStep, am as TemplateJob, an as TemplateKanbanView, ao as TemplateMeasureOverride, ap as TemplatePortalTable, aq as TemplateProvenance, ar as TemplateSource, as as TemplateTableSettings, at as TemplateTimelineView, au as TemplateViewKind, av as TemplateViewSort, aw as UseCaseSingulars, ax as WalkAction, ay as WalkAssertion, az as WalkImport, aA as WalkMove, aB as WalkStep, aC as confidentialPending, aD as confidentialRequests, aE as footprintOf, aF as membersAddRowsSteps, aG as tableSettingsProblems, aH as whenRule } from '../types-DxVoKKpL.js';
+import { b as AggregateMeasure, a as AggregateFilter, t as RecordsDataSource } from '../ports-Df3VghxK.js';
+import { U as UseCase } from '../types-Ba11aOEO.js';
+import { U as UseCaseProblem } from '../validate-E-g4LAZ6.js';
+export { R as RESOLVABLE_FIELD_TYPE_WORDS } from '../validate-E-g4LAZ6.js';
 import '../field-CekLWOPw.js';
 
-declare const TABLE_KERNEL_ID = "11111111-0000-4000-8000-000000000001";
-type ConfidentialLevel = "viewer" | "commenter" | "editor";
-interface TemplateConfidentialReader {
-    /** A member / person field of the table whose value names the reader. */
-    field: string;
-    level: ConfidentialLevel;
-    /** The row's own condition, flat saved-view filter: { "cycle_manager_status": "Submitted" }. */
-    when?: Record<string, string | number | boolean>;
-}
-interface TemplateConfidential {
-    table: string;
-    readers: TemplateConfidentialReader[];
-    /** true: the person who installs it is only a reader (the organization owns the table). */
-    makerIsReader: boolean;
-    /** One sentence for the chair and for Arman: why this table is Confidential. */
-    why: string;
-}
-interface TemplateTableSettings {
-    confidential?: TemplateConfidential[];
-    membersAddRows?: string[];
-}
-/** One request the chair runs after install (the SQL is the exact call; words are the chair's). */
-interface ConfidentialRequest {
-    table: string;
-    tableId: string;
-    readers: Array<{
-        field: string;
-        level: ConfidentialLevel;
-        when?: Record<string, unknown>;
-    }>;
-    makerIsReader: boolean;
-    why: string;
-    /** `select custom.set_table_confidential_arman_explicitly_approved(…)` with `:'arman_words'` left for the chair. */
-    sql: string;
-}
-/** What a spec's confidential / membersAddRows say is wrong, in plain sentences ([] = fine). */
-declare function tableSettingsProblems(spec: TemplateSpec & TemplateTableSettings): string[];
-/** The plan steps that set members_add_rows (custom.record_change_many on the Table kernel, as the person). */
-declare function membersAddRowsSteps(spec: TemplateTableSettings, tableRef: (token: string) => string): {
-    label: string;
-    door: "record_change_many";
-    args: {
-        p_organization_id: string;
-        p_table_id: string;
-        p_changes: {
-            op: string;
-            record_id: string;
-            patch: {
-                members_add_rows: boolean;
-            };
-        }[];
-    };
-}[];
-/** The chair's requests for one install: table ids from the install answer's `made`. */
-declare function confidentialRequests(spec: TemplateTableSettings, made: Array<{
-    kind: string;
-    ref: string;
-    id: string | null;
-}>): ConfidentialRequest[];
-/**
- * A reader's `when`, as the store asks it. The flat saved-view map compiles against the row's STORED
- * document only (custom.record_filter_sql reads r.data), so a lookup — "both sides are submitted",
- * read through the review cycle — would never be true there. A Rule expression is evaluated over
- * custom.record_values_of(r), which works lookups and roll-ups out on read; so every condition is
- * written as a Rule over the installed fields' ids (REC-17: a Rule points at a Field by id).
- */
-declare function whenRule(table: string, when: Record<string, unknown>, made: Array<{
-    kind: string;
-    ref: string;
-    id: string | null;
-}>): Record<string, unknown>;
-/** True while any of the template's Confidential tables is not Confidential yet (hold its forms). */
-declare function confidentialPending(spec: TemplateTableSettings, levels: Record<string, string | null | undefined>): boolean;
-
-/** The schema version of this file format. Bumped only when the SHAPE changes. */
-declare const TEMPLATE_SPEC_VERSION: 1;
-/**
- * THE RELATIVE-DATE GRAMMAR. A seed date is written relative to the day the template is
- * installed, so a calendar installed in March shows this week's work, not last year's:
- *
- *   ANCHOR   @today                     the install day
- *            @mon … @sun                that weekday of the install week (weeks start Monday)
- *            @last-mon … @next-sun      that weekday of the week before / after
- *   OFFSET   +3d  -2w  +1m  -1y          days / weeks / months / years (N ≤ 9999)
- *            +2b  -5b                   BUSINESS days (Monday–Friday): never lands on a weekend
- *   SNAP     ~b                         if the result is a Saturday or Sunday, move to Monday
- *   TIME     " 09:30"                   a moment that day, 24-hour local time in the business's
- *                                       zone, written out with its offset
- *
- *   "@today-3b 08:30"   "@today~b 10:00"   "@next-tue"   "@mon+1d 14:00"
- *
- * Closed: anything else in a date field is an absolute date, which only a field flagged
- * `absoluteDates` (a date of birth) may hold. `resolveRelativeDates` (./validate) turns
- * every token into the store's own date or moment text.
- *
- * Groups: 1 anchor, 2 sign, 3 count, 4 unit, 5 snap, 6 hour, 7 minute.
- */
-declare const RELATIVE_DATE: RegExp;
-/** The day the validator resolves relative dates against, so every check is deterministic. */
-declare const TEMPLATE_REFERENCE_DATE = "2026-10-05";
-/** The 20 industry groups of the catalogue (handoff §5 table). The quota per group is in CATALOGUE_QUOTAS. */
-declare const INDUSTRY_GROUPS: readonly ["healthcare", "legal_professional", "construction_trades", "real_estate_property", "hospitality_food", "agencies_creative", "field_home_services", "retail_ecommerce", "manufacturing_logistics", "education", "nonprofit_community", "software_it", "fitness_beauty_wellness", "media_creators", "staffing_hr_recruiting", "personal_family", "events_weddings", "automotive", "agriculture_environment", "cross_industry"];
-type IndustryGroup = (typeof INDUSTRY_GROUPS)[number];
-/** The first 1,000 rows' quota per group (sums to 1,000). G3 enforces it at 1,000 and proportionally before. */
-declare const CATALOGUE_QUOTAS: Readonly<Record<IndustryGroup, number>>;
-/** The 12 jobs a template does for a business. */
-declare const TEMPLATE_JOBS: readonly ["intake", "scheduling", "crm_pipeline", "work_orders", "inventory", "billing", "team_hr", "projects", "content", "compliance_quality", "customer_service", "reporting"];
-type TemplateJob = (typeof TEMPLATE_JOBS)[number];
-/** The 16 features a template can teach. Each is taught by at least 40 of the first 1,000. */
-declare const TEACHES_FEATURES: readonly ["relations_rollups", "dimensions", "kanban", "calendar", "timeline", "gallery", "forms", "bookings", "portals", "dashboards", "drill_down", "agents", "field_governance", "import_upsert", "checklists", "documents_esign"];
-type TeachesFeature = (typeof TEACHES_FEATURES)[number];
-/**
- * The five places we beat the champions (ADV-P §4). Each is shown in at least 100 of the first 1,000.
- *
- *   S1 — governed columns: every column says who sees it and whether AI may read it.
- *   S2 — agents inside the data: an agent works on the table's own records.
- *   S3 — every front door on one table: form, booking, portal, digest, webhook all land in one table.
- *   S4 — a column can point at anything on the platform (entity reference).
- *   S5 — imports and edits cannot lose data: an upsert import that updates and adds, or
- *        archive → Trash → restore, shown in the walk.
- */
-declare const STRENGTHS: readonly ["S1", "S2", "S3", "S4", "S5"];
-type Strength = (typeof STRENGTHS)[number];
-/** Who installs it: a business, or a person for their own life. */
-declare const TEMPLATE_AUDIENCES: readonly ["organization", "individual"];
-type TemplateAudience = (typeof TEMPLATE_AUDIENCES)[number];
-/**
- * THE CAPABILITY WORDS a template may `require`. Closed: a word not here is a typo, and a
- * word the template does not use is refused. Whether each is PROVIDED today is derived by
- * `capabilityStatus` (./validate) from the store's registry and the records-ui layouts, so a
- * word flips to provided the day its lane lands, with no edit to this list.
- */
-declare const CAPABILITY_WORDS: readonly ["view.grid", "view.kanban", "view.kanban.swimlanes", "view.calendar", "view.calendar.month", "view.timeline", "view.gallery", "field.select", "field.multi_select", "field.datetime", "field.currency", "field.percent", "field.email", "field.phone", "field.url", "field.checkbox", "field.attachment", "field.member", "field.lookup", "field.rollup", "field.formula", "field.entity_reference", "field.signature", "field.rating", "choice.colors", "seed.attachments", "form", "form.question_text", "booking", "portal", "dashboard", "dashboard.multi_table", "drill_down", "dimensions", "digest", "checklist", "document", "document.esign", "notification", "stage_rules", "row_action", "import.upsert", "archive.restore", "agent", "automation"];
-type CapabilityWord = (typeof CAPABILITY_WORDS)[number];
-/**
- * The platform kinds an entity_reference column may point at — custom.entity_reference_kinds(),
- * read on the clone 2026-10-02 (the TEMPLATES lane refreshes it the way it refreshes the agent
- * snapshot). A word outside it is refused: the store would refuse the column.
- */
-declare const ENTITY_REFERENCE_KINDS: readonly ["agent", "agent_shortcut", "agent_template", "ai_api", "ai_endpoint", "ai_model", "ai_provider", "ai_setting", "anon_form", "app", "assessment", "canvas_comment", "canvas_item", "canvas_score", "category", "code_file", "code_folder", "code_repository", "comparison_set", "contact_submission", "content_ir_kind", "content_ir_kind_instance", "context_item", "conversation", "crm_deal", "crm_outreach_list", "cx_agent_memory", "data_store", "fc_set", "feature_doc", "flexible_data", "folder", "game_result", "heatmap_save", "hr_asset", "hr_candidate", "hr_careers_portal", "hr_checklist_template", "hr_course", "hr_crew", "hr_deduction_code", "hr_department", "hr_earning_code", "hr_employee", "hr_holiday_calendar", "hr_interview_kit", "hr_job_title", "hr_jurisdiction", "hr_jurisdiction_rule_class", "hr_leave_policy", "hr_location", "hr_pay_group", "hr_posting", "hr_record_class", "hr_requisition", "hr_schedule", "hr_schedule_template", "hr_survey", "league_membership", "learn_doc", "mandate", "marketing_initiative", "meet_meeting", "message_template", "note", "note_folder", "organization", "page_extraction_job", "party", "pc_article", "pc_episode", "pc_show", "pc_studio_run", "processed_document", "project", "quiz_session", "research_template", "research_topic", "rulebook", "sch_task", "scope_type", "seo_topic", "shared_canvas_item", "skill", "skill_render_definition", "studio_session", "study_goal", "study_media", "study_plan", "study_plan_block", "surface", "task", "thread", "tool", "tool_bundle", "transcript", "udt_document", "user_markdown_sample", "voice", "war_room", "wbx_pattern", "web_analysis_item", "web_brand", "web_provider", "web_site", "workbook", "workflow", "workflow_template", "workflow_trigger", "working_document"];
-/** The colours a choice may wear — the palette `display_format.options.choices[].color` holds (design-system STYLE_COLORS). */
-declare const CHOICE_COLORS: readonly ["slate", "green", "amber", "red", "blue", "violet", "teal"];
-type ChoiceColor = (typeof CHOICE_COLORS)[number];
-interface SharedBlockField {
-    key: string;
-    label: string;
-    parityType: UseCaseField["parityType"];
-    sensitivity: UseCaseField["sensitivity"];
-    contextPolicy: UseCaseField["contextPolicy"];
-    required?: boolean;
-    /** Labels and keys that mean this field, for the copy check (normalised, lower-case words). */
-    sameAs: readonly string[];
-}
-interface SharedBlock {
-    /** The table's token in every organization: one table, shared by every template that uses it. */
-    table: string;
-    name: string;
-    labelSingular: string;
-    labelPlural: string;
-    titleField: string;
-    describes: string;
-    fields: readonly SharedBlockField[];
-    /** A template table matching this many of the block's fields (by type and meaning) has copied it. */
-    copyThreshold: number;
-}
-/**
- * THE SHARED BLOCKS. The scope templates carried 26 byte-identical copies of a team-member
- * block (312 of 846 fields). Now the block is ONE seeded table per organization; a template
- * lists the block in `sharedBlocks` with the rows it seeds (its own people), and points its
- * "assigned to" columns at the block's table with an ordinary relation field — so the
- * column is filled, and no template declares those fields again.
- */
-declare const SHARED_BLOCKS: {
-    readonly team_member: {
-        readonly table: "team_member";
-        readonly name: "Team";
-        readonly labelSingular: "Team member";
-        readonly labelPlural: "Team";
-        readonly titleField: "full_name";
-        readonly describes: "The people on the business's own team — who is assigned, who answers, who signs.";
-        readonly fields: readonly [{
-            readonly key: "full_name";
-            readonly label: "Name";
-            readonly parityType: "text";
-            readonly sensitivity: "internal";
-            readonly contextPolicy: "include";
-            readonly required: true;
-            readonly sameAs: readonly ["name", "full name", "employee name", "staff name"];
-        }, {
-            readonly key: "role";
-            readonly label: "Role";
-            readonly parityType: "text";
-            readonly sensitivity: "internal";
-            readonly contextPolicy: "include";
-            readonly sameAs: readonly ["role", "job title", "title", "position"];
-        }, {
-            readonly key: "work_email";
-            readonly label: "Work email";
-            readonly parityType: "email";
-            readonly sensitivity: "confidential";
-            readonly contextPolicy: "summarize";
-            readonly sameAs: readonly ["email", "work email", "email address"];
-        }, {
-            readonly key: "mobile";
-            readonly label: "Mobile";
-            readonly parityType: "phone";
-            readonly sensitivity: "confidential";
-            readonly contextPolicy: "exclude";
-            readonly sameAs: readonly ["phone", "mobile", "work phone", "cell", "phone number"];
-        }, {
-            readonly key: "start_date";
-            readonly label: "Start date";
-            readonly parityType: "datetime";
-            readonly sensitivity: "internal";
-            readonly contextPolicy: "include";
-            readonly sameAs: readonly ["start date", "hire date", "started", "date hired"];
-        }];
-        readonly copyThreshold: 3;
-    };
-};
-type SharedBlockId = keyof typeof SHARED_BLOCKS;
-declare const SHARED_BLOCK_IDS: SharedBlockId[];
-/** One shared block this template uses, with the rows it seeds into the block's table. */
-interface SharedBlockUse {
-    block: SharedBlockId;
-    /** Keyed by the block's field keys. Relation fields elsewhere point at these row keys. */
-    rows: UseCaseRow[];
-}
-interface TemplateField extends UseCaseField {
-    /** Every choice of a select/multi_select wears a colour: choice word → colour. */
-    choiceColors?: Record<string, ChoiceColor>;
-    /** For an `entity_reference` field (S4): the platform kinds it may point at. */
-    allowedTypes?: string[];
-    /** For a lookup / rollup: the relation field it reads through. */
-    via?: string;
-    /** Lookup: the field picked on the far side. Rollup: the field aggregated. */
-    pick?: string;
-    /** Rollup: the aggregate along the relation. */
-    agg?: AggregateOperation;
-    /**
-     * Rollup: WHICH linked records it adds up — "sessions booked", "unpaid balance", "open requests"
-     * per parent. The saved view's own filter grammar, written against the far table: a flat map of
-     * far-side column keys (`{ status: "open" }`) or a Rule expression over far-side field IDs. The
-     * store refuses an unknown column or op at install (custom.field_declare).
-     */
-    filter?: Record<string, unknown>;
-    /**
-     * For a `formula` field: the formula text custom.field_declare parses (`formula_text`, through
-     * custom.formula_parse) — fields named by LABEL in braces, functions from
-     * custom.formula_node_kinds(): `{Total} - {Paid}`, `DATEDIFF({Starts}, {Ends}, 'minutes') / 60`.
-     * The store computes it on read; seeds never write it.
-     */
-    formula?: string;
-    /**
-     * ELIGIBILITY across tables, on a relation field: the record this field points at must hold a
-     * row in `table` (linked back by `relation`) matching `where`, whose `until` date is on or after
-     * this row's `onDate` — a shift's staff member holds an unexpired food-handler card on the
-     * shift's day. Checked on the seed and on the walk's state after every step.
-     */
-    eligible?: {
-        table: string;
-        relation: string;
-        where?: Record<string, string>;
-        until: string;
-        onDate: string;
-    };
-    /**
-     * A date field whose values are history, not schedule (a date of birth, a founding
-     * date): its seed rows hold absolute dates. Every other date field is written in the
-     * relative grammar (RELATIVE_DATE).
-     */
-    absoluteDates?: boolean;
-    /**
-     * A schedule date for a weekday-only business: every seed value must resolve to Monday–
-     * Friday on EVERY install weekday (write it with business-day offsets "+2b" or the "~b" snap).
-     */
-    businessDays?: boolean;
-    /** The value a new record gets when nobody gives one — lets a form or an import leave a required field out. */
-    default?: unknown;
-    /**
-     * A public form may ask a confidential / restricted field only when it is the asker's OWN
-     * data (a patient's member id on her own intake). Flag it here; never for anyone else's.
-     */
-    askOfSubject?: boolean;
-    /** A parent or guardian answers this on a public form for a minor (youth league, school, pediatrics). */
-    askOfGuardian?: boolean;
-    /**
-     * Required with `absoluteDates`: why these dates are history ("date of birth", "the year
-     * the firm was founded"). A field flagged absolute may never drive a calendar, a timeline,
-     * a booking, a digest, a stage rule, the Q6 question or a walk step — those are schedule.
-     */
-    historicalReason?: string;
-}
-interface TemplateTable extends UseCaseTable {
-    fields: TemplateField[];
-    /**
-     * Ordered date pairs that hold on every seed row: [earlier, later]. A side is a field of
-     * this table ("sent_on") or a field reached through one of its relations ("patient.date_of_birth").
-     * A table with two or more schedule date fields declares its order here, or says why the
-     * dates are independent (`datesIndependent`).
-     */
-    before?: [string, string][];
-    datesIndependent?: string;
-    /**
-     * A roster of recurring slots (weekly shifts, standing roles): rows may share a title when
-     * they differ in a date and in who or what they are for (a relation).
-     */
-    schedule?: boolean;
-    /**
-     * Date coherence across relations, declared: on every seed row `earlier` is on or before
-     * `later`. A side is a field of this table ("invoice_date") or one reached through a relation
-     * ("engagement.start_date"). `onlyWhen` limits the pair to rows whose field holds one of the
-     * values (a report is due only on an Awarded grant). A billing or grants template declares at
-     * least one pair that crosses a relation.
-     */
-    datePairs?: {
-        earlier: string;
-        later: string;
-        onlyWhen?: {
-            field: string;
-            values: string[];
-        };
-    }[];
-    /**
-     * CROSS-TABLE REALISM, stated once on the CHILD table (the one holding the relation) and
-     * enforced on every seed row. A relation whose two sides both carry a schedule date needs a
-     * childDates entry; both a status, a statusAgrees entry.
-     *
-     * childDates: this row's date is on or after its parent's ("start_on" ≥ "requisition.opened_on").
-     */
-    childDates?: {
-        relation: string;
-        field: string;
-        parentField: string;
-    }[];
-    /** withinParent: this row's number stays within its parent's (deal.price ≤ client.budget_max) unless a status says otherwise. */
-    withinParent?: {
-        relation: string;
-        field: string;
-        op: "<=" | ">=";
-        parentField: string;
-        unless?: {
-            field: string;
-            values: string[];
-        };
-    }[];
-    /**
-     * statusAgrees: a child in one of `childStatus` means its parent's `parentField` is one of
-     * `parentStatus` (deal Closed ⇒ listing Sold); `maxPerParent` caps how many children of one
-     * parent may sit in those statuses (one accepted offer per listing).
-     */
-    statusAgrees?: {
-        relation: string;
-        field: string;
-        childStatus: string[];
-        parentField: string;
-        parentStatus: string[];
-        maxPerParent?: number;
-    }[];
-    /** countMatches: a stored count equals the number of linked rows. Prefer a rollup, which the store computes. */
-    countMatches?: {
-        field: string;
-        childTable: string;
-        childRelation: string;
-    }[];
-    /**
-     * STATUS IMPLIES FIELDS: a row in one of `when` (on `field`) has every `filled` field filled
-     * and every `equals` field at that value — Paid ⇒ paid_on set and balance 0; Signed ⇒ the
-     * signature filled. Checked on every seed row and after every walk step that changes a row.
-     */
-    statusImplies?: {
-        field: string;
-        when: string[];
-        filled?: string[];
-        equals?: Record<string, unknown>;
-    }[];
-    /**
-     * DATE-DRIVEN STATUS: `field` follows `dateField` measured from the install day, on every
-     * install weekday — bands in days from today, `from` inclusive, `to` exclusive:
-     * [{status: "Expired", to: 0}, {status: "Renewal due", from: 0, to: 61}, {status: "Current", from: 61}].
-     * A row whose status is one of the bands' statuses sits in the band its date says. (A status the
-     * store should compute is better a formula: IF(DATEDIFF(TODAY(), {Expires on}, 'days') < 0, …).)
-     */
-    statusByDate?: {
-        field: string;
-        dateField: string;
-        bands: {
-            status: string;
-            from?: number;
-            to?: number;
-        }[];
-    };
-    /** Relations (by field key) whose two sides' dates and statuses truly do not constrain each other, each with the reason. */
-    independentOf?: Record<string, string>;
-    /**
-     * What one row is: a person, an animal or a thing. The personal-data floors (date of birth,
-     * allergies, diagnoses, medications, member ids) bind people only — a dog's birthday is not
-     * personal data. Undeclared, a table holds people when it has a name and a phone or email.
-     */
-    subject?: "person" | "animal" | "thing";
-    /**
-     * Lane 10 FD. An echo of the template's `foundation` list (R13), which is the ONE source the
-     * installers read. Optional; when present the validator requires it to agree with the list.
-     */
-    foundation?: boolean;
-}
-declare const TEMPLATE_VIEW_KINDS: readonly ["grid", "kanban", "calendar", "gallery", "timeline"];
-type TemplateViewKind = (typeof TEMPLATE_VIEW_KINDS)[number];
-interface TemplateViewSort {
-    field: string;
-    direction: "asc" | "desc";
-}
-interface TemplateViewBase {
-    /** snake_case, unique within the template. */
-    token: string;
-    /** What a person clicks: "Today's chairs", "Intake board". */
-    name: string;
-    /** The table token it looks at. */
-    table: string;
-    /** The view the table opens on (at most one per table). */
-    isDefault?: boolean;
-    /** custom.view_declare `filters`: Field key → value (scalar equality, null = unset, object = window). */
-    filters?: Record<string, AggregateFilter>;
-    /**
-     * Any-of conditions: Field key → the values a row may hold ("Open requests" = New, In progress,
-     * Waiting). The store's flat `filters` map is equality only; this is declared as the view's
-     * `where` Rule expression (S2-PRIME) — `{op: "and", args: [{op: "or", args: [{op: "eq", args:
-     * [{field: <field id>}, {const: <value>}]}, …]}, …]}`, Fields by id — which custom.record_filter_sql
-     * compiles for the grid and the board. Digests and the notifier read only `filters`, never this.
-     */
-    anyOf?: Record<string, string[]>;
-    sorts?: TemplateViewSort[];
-    /** Field keys hidden on this view (presentation.hiddenFields). */
-    hiddenFields?: string[];
-}
-interface TemplateGridView extends TemplateViewBase {
-    kind: "grid";
-    groupBy?: string;
-}
-interface TemplateKanbanView extends TemplateViewBase {
-    kind: "kanban";
-    /** `group_field`: the choice field whose values are the columns. */
-    groupBy: string;
-    /** `swimlane_field`: never the column field itself. */
-    swimlaneBy?: string;
-    /** `measure`: a number field totalled under each column heading. */
-    measure?: string;
-}
-interface TemplateCalendarView extends TemplateViewBase {
-    kind: "calendar";
-    /** `date_field`: a datetime, so every card has a time on the day. */
-    dateField: string;
-    /** The records are whole-day by intent (a deadline, a due date). */
-    allDay?: boolean;
-    /** "month" needs `view.calendar.month` (lane 10). */
-    span?: "month" | "week";
-}
-interface TemplateGalleryView extends TemplateViewBase {
-    kind: "gallery";
-    /** `image_field`: the file field shown as each card's picture. Needs `seed.attachments`. */
-    coverField: string;
-}
-interface TemplateTimelineView extends TemplateViewBase {
-    kind: "timeline";
-    startField: string;
-    endField: string;
-    groupBy?: string;
-}
-type TemplateView = TemplateGridView | TemplateKanbanView | TemplateCalendarView | TemplateGalleryView | TemplateTimelineView;
-interface TemplateFormField extends UseCaseFormField {
-    /**
-     * The question as it is ASKED: "What brings you in today?" — not the column label.
-     * Sent as the question's `ask` to custom.form_declare / booking_declare (`help` rides beside it).
-     */
-    ask: string;
-}
-interface TemplateForm extends UseCaseForm {
-    fields: TemplateFormField[];
-}
-interface TemplateDimensionOverride {
-    /** An inferred dimension key (custom._table_dimensions_infer): a single choice, a single relation, a tick box, a date, created_at or updated_at. */
-    key: string;
-    label?: string;
-    hidden?: boolean;
-}
-interface TemplateMeasureOverride {
-    /** An inferred measure key (count, sum_x, avg_x, min_x, max_x, filled_x) — rename/hide only — or a NEW key. */
-    key: string;
-    label?: string;
-    hidden?: boolean;
-    /** A NEW measure only: one of custom.agg_operations() except count. */
-    op?: Exclude<AggregateOperation, "count">;
-    /** A NEW measure only: the column it reads. */
-    of?: string;
-}
-interface TemplateDrillPath {
-    key: string;
-    /** Dimension keys, coarsest first; a date takes ":year" | ":quarter" | ":month" | ":week" | ":day". */
-    levels: string[];
-}
-interface TemplateDimensions {
-    table: string;
-    dimensions?: TemplateDimensionOverride[];
-    measures?: TemplateMeasureOverride[];
-    paths?: TemplateDrillPath[];
-    default?: {
-        by?: string[];
-        show?: string[];
-    };
-}
-interface TemplateBookingWindow {
-    /** 0 = Sunday … 6 = Saturday. */
-    weekday: number;
-    /** "09:00". */
-    from: string;
-    /** "17:00", later than `from`. */
-    to: string;
-}
-interface TemplateBooking {
-    kind: "booking";
-    token: string;
-    title: string;
-    table: string;
-    questions: TemplateFormField[];
-    availability: {
-        timezone?: string;
-        slotMinutes: number;
-        bufferMinutes?: number;
-        leadMinutes?: number;
-        maxPerDay?: number;
-        days?: number;
-        windows: TemplateBookingWindow[];
-    };
-    slug?: string;
-    /**
-     * The statuses of rows that came through (or wait on) this booking page. Only those rows must
-     * sit in its windows; rows that reached later stages by other routes (a same-day emergency
-     * dispatch) do not. Default: Booked, Confirmed, Requested, Held, Pending, Scheduled, Cancelled.
-     */
-    bookedStages?: string[];
-}
-interface TemplatePortalTable {
-    table: string;
-    /** The relation field of `table` that points at the portal's client table — "only theirs". */
-    namesVia: string;
-    /** Never empty; never a restricted / confidential field or one the AI is kept from. */
-    visibleFields: string[];
-    editableFields?: string[];
-    comments?: boolean;
-}
-interface TemplatePortal {
-    kind: "portal";
-    token: string;
-    title: string;
-    /** The table whose records are the portal's clients (patients, owners, tenants). */
-    clientTable: string;
-    tables: TemplatePortalTable[];
-    /** Form tokens offered inside the portal. */
-    forms?: string[];
-    slug?: string;
-}
-interface TemplateDashboardBlock {
-    title: string;
-    kind: DashboardBlockKind;
-    /** Absent = the dashboard's own table. */
-    table?: string;
-    groupBy?: string[];
-    measures?: AggregateMeasure[];
-    bucket?: {
-        key: string;
-        by: AggregateBucket;
-    };
-    filter?: Record<string, AggregateFilter>;
-    span?: number;
-    /** `stuck` only. */
-    stateKey?: string;
-    days?: number;
-}
-interface TemplateDashboard {
-    kind: "dashboard";
-    token: string;
-    name: string;
-    table: string;
-    /** At least two charts: bar, column, line or donut (`number`, `table` and `stuck` are not charts). */
-    blocks: TemplateDashboardBlock[];
-}
-interface TemplateDrillDown {
-    kind: "drill_down";
-    token: string;
-    name: string;
-    table: string;
-    /** A `paths[].key` of this table's `dimensions` entry. */
-    path: string;
-}
-interface TemplateDigest {
-    kind: "digest";
-    token: string;
-    name: string;
-    /** The view token whose records the digest sends. */
-    view: string;
-    cadence: SubscriptionCadence;
-    /** "monday 08:00". */
-    schedule?: string;
-    channel?: "in_app" | "email" | "sms";
-}
-interface TemplateChecklistStep {
-    ref: string;
-    title: string;
-    role?: string;
-    dueDays?: number;
-    dependsOn?: string[];
-    requires?: {
-        kind: "none" | "note";
-    } | {
-        kind: "answer";
-        key: string;
-        label: string;
-    } | {
-        kind: "record_field";
-        key: string;
-        label?: string;
-    } | {
-        kind: "form";
-        form: string;
-    } | {
-        kind: "document";
-        document: string;
-    };
-}
-interface TemplateChecklist {
-    kind: "checklist";
-    token: string;
-    name: string;
-    aboutTable: string;
-    roles?: {
-        role: string;
-        label?: string;
-    }[];
-    trigger?: {
-        kind: "manual";
-    } | {
-        kind: "record_created";
-        table: string;
-    } | {
-        kind: "status_reached";
-        table: string;
-        status: string;
-    };
-    steps: TemplateChecklistStep[];
-}
-interface TemplateDocument {
-    kind: "document";
-    token: string;
-    name: string;
-    describes: string;
-    table: string;
-    /** The subject or title line; merge fields allowed. */
-    title: string;
-    /**
-     * Prose with {{field_key}} merge fields, each a field of `table` (the installer writes
-     * {{field:<id>}}, the only token custom.doc_render_body resolves). No {{today}}, no
-     * {{business.x}}, no signature field (a signature never merges into the body).
-     */
-    body: string;
-    /** Sent for e-signature (needs `document.esign`). */
-    signature?: boolean;
-}
-interface TemplateNotification {
-    kind: "notification";
-    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 message; {{field_key}} merge fields of the watched table only. */
-    message: string;
-}
-interface TemplateStageRules {
-    kind: "stage_rules";
-    token: string;
-    /** "Route board" — the lifecycle's own name. */
-    name: string;
-    table: string;
-    /** The choice field holding the stage. */
-    stageField: string;
-    /** Stage → what is true of a record sitting there, in the staff's words (every stage). */
-    stages: Record<string, string>;
-    transitions?: {
-        from: string;
-        to: string;
-    }[];
-    /** Stage → field keys that must be filled to land there. */
-    requires?: Record<string, string[]>;
-    /** Stage → how many cards may sit there at once. */
-    limits?: Record<string, number>;
-    movesMessage?: string;
-    /**
-     * Status ↔ date coherence, enforced on every seed row for every install weekday: the date
-     * field, and per stage whether its date is in the past (on or before install day), today,
-     * or the future (on or after install day). A stage left out is unconstrained.
-     */
-    dateField?: string;
-    /** Every stage is listed once a dateField is declared; "any" says a stage's date is unconstrained, on purpose. */
-    /** "none": this stage has no date yet ("New call", "Draft") — its date field is EMPTY. */
-    stageDates?: Record<string, "past" | "today" | "future" | "any" | "none">;
-    /** Why a time-bound stage ("No-show", "Completed", "Scheduled"…) is "any": one real sentence (≥ 6 words) per such stage. */
-    anyBecause?: Record<string, string>;
-    /**
-     * Moves OUT of a terminal stage (Cancelled, No-show, Lost, Declined, Closed, Withdrawn…) are
-     * refused unless declared here with the business reason — a reopened deal, a rebooked guest.
-     */
-    reopen?: {
-        from: string;
-        to: string;
-        because: string;
-    }[];
-    /**
-     * A stage that needs a linked child: "First pickup booked" ⇒ at least `min` (default 1) row of
-     * `table` whose `relation` points at this row and whose `field` is one of `in`. Checked on the
-     * seed and on the walk's state after every step.
-     */
-    requiresChild?: Record<string, {
-        table: string;
-        relation: string;
-        field?: string;
-        in?: string[];
-        min?: number;
-    }>;
-}
-interface TemplateRowAction {
-    kind: "row_action";
-    token: string;
-    table: string;
-    name: string;
-    actionKind: "update" | "agent";
-    confirm?: boolean;
-    color?: ChoiceColor;
-    /** `update`: what it writes. Fields by key; the installer resolves ids. */
-    steps?: ({
-        field: string;
-        set: "value";
-        value: unknown;
-    } | {
-        field: string;
-        set: "clear";
-    })[];
-    /** `agent`: what the record chat opens with. */
-    prompt?: string;
-}
-interface TemplateAutomation {
-    kind: "automation";
-    token: string;
-    name: string;
-    when: UseCaseNotificationTrigger;
-    /** What happens, in the business's words: "text the owner the pickup window". */
-    then: string;
-}
-type TemplateExtra = TemplateBooking | TemplatePortal | TemplateDashboard | TemplateDrillDown | TemplateDigest | TemplateChecklist | TemplateDocument | TemplateNotification | TemplateStageRules | TemplateRowAction | TemplateAutomation;
-type TemplateExtraKind = TemplateExtra["kind"];
-declare const TEMPLATE_EXTRA_KINDS: readonly TemplateExtraKind[];
-interface TemplateAgentVariable {
-    /** One of the platform agent's own variable names (templates/AGENTS.snapshot.json). */
-    name: string;
-    /** The table token bound to it at install. */
-    table: string;
-    describes: string;
-    /**
-     * Optional (Kits → Template merge): the full merge-field binding instead of the whole-table
-     * default. Its `table` must equal `table` above.
-     */
-    binding?: TemplateMergeBinding;
-}
-/**
- * Q6: one question, and the exact `custom.record_aggregate` answer it must give. The
- * validator recomputes the answer from the seed rows with the store's own semantics
- * (text-equality filters, half-open date windows, sum over nothing is null, no rounding).
- */
-interface TemplateAgentQuestion {
-    ask: string;
-    /** Why the owner asks it — what they do differently depending on the answer. */
-    whyItMatters: string;
-    expect: {
-        table: string;
-        measure: AggregateMeasure;
-        /**
-         * Scalar equality, null = unset, or a {from, to} window on a date field whose bounds are
-         * relative tokens WITH a time ("@today-7d 00:00"), never a bare or absolute date. The
-         * filter may not match 90% or more of the table's rows (that is "how many are there").
-         */
-        filter?: Record<string, AggregateFilter>;
-        /** Never 0 and never null. */
-        answer: number;
-        unit: string;
-    };
-}
-/** The platform agent every template copies unless it says why not (`agentReason`). */
-declare const DEFAULT_TEMPLATE_AGENT: {
-    readonly id: "4cd676c6-f55d-4426-b7eb-a9d0273566ec";
-    readonly name: "Answers From Your Tables";
-};
-interface TemplateAgent {
-    /** The platform agent copied — id AND name, as the committed catalogue snapshot has them. */
-    platformAgent: {
-        id: string;
-        name: string;
-    };
-    /** Required when platformAgent is not DEFAULT_TEMPLATE_AGENT: why this template needs another agent. */
-    agentReason?: string;
-    /** The copy's name in the installed org. */
-    name: string;
-    variables: TemplateAgentVariable[];
-    question: TemplateAgentQuestion;
-    /** Optional (Kits → Template merge): what "Try it" sends the copy. */
-    tryIt?: TemplateTryIt;
-}
-/**
- * The merge-field binding, with the two ids replaced by template-local handles the host resolves
- * at install: `table` (a table token) and `rowIndex` (the index of a seed row of that table).
- * `collection` = the table's rows (one text, via `transform`); `reference` = one row (`rowIndex`);
- * `value` = one field (`field`) of one row (`rowIndex`).
- */
-interface TemplateMergeBinding {
-    semantic: "collection" | "reference" | "value";
-    table: string;
-    rowIndex?: number;
-    field?: string;
-    transform?: {
-        name: "list";
-        template?: string;
-        join?: string;
-        max?: number;
-        header?: string;
-    };
-    limit?: number;
-    sort?: {
-        field: string;
-        dir: "asc" | "desc";
-    };
-    match?: Record<string, unknown>;
-    /** What the agent sees when nothing matches (default "absent"). */
-    missing?: string;
-}
-/** What "Try it" sends a template's agent copy: the user's message and/or its other variables. */
-interface TemplateTryIt {
-    userInput?: string;
-    variables?: Record<string, string>;
-}
-interface TemplateExtraAgentVariable {
-    /** One of the platform agent's own variable names (templates/AGENTS.snapshot.json). */
-    name: string;
-    describes: string;
-    binding: TemplateMergeBinding;
-}
-/** One more agent a template copies (no Q6: its question is the primary agent's). */
-interface TemplateExtraAgent {
-    /** Template-local handle: guide highlights and workflow `{{agent:key}}` placeholders use it. */
-    key: string;
-    platformAgent: {
-        id: string;
-        name: string;
-    };
-    /** Why this template carries this agent — a full sentence (agents never author agents). */
-    agentReason: string;
-    name: string;
-    variables: TemplateExtraAgentVariable[];
-    tryIt?: TemplateTryIt;
-}
-/** A workflow made at install through aidream `POST /workflows`; `{{table:<token>}}` / `{{agent:<key>}}` are resolved. */
-interface TemplateWorkflow {
-    key: string;
-    name: string;
-    description: string;
-    definition: unknown;
-}
-/** One display step of how the template works (NOT the gated `walk`). */
-interface TemplateGuideStep {
-    title: string;
-    body: string;
-    /** `agent` key "agent" names the primary agent. */
-    highlight?: {
-        kind: "table" | "agent" | "workflow" | "binding";
-        key: string;
-    };
-}
-/** One CSV-shaped import: a header of field keys and the rows under it, as the file holds them. */
-interface WalkImport {
-    kind: "import";
-    table: string;
-    /** What the file is called: "October customer list.csv". */
-    sourceName: string;
-    /** The field that makes a row the same row (`p_dedupe_key`); it carries a `unique` rule. */
-    dedupeKey: string;
-    /** The header row: field keys (the mapping is identity). */
-    columns: string[];
-    /** The data rows, cell by cell, as text — at least one updates a seed row and one is new. */
-    rows: string[][];
-}
-/** One row's move inside a grouped `moves` step. */
-interface WalkMove {
-    table: string;
-    row: string;
-    field: string;
-    to: string;
-    set?: Record<string, unknown>;
-}
-type WalkAction = {
-    kind: "open";
-    surface: string;
-}
-/**
- * A stage move, optionally landing with the fields that stage requires or implies (`set`:
- * "mark Paid" writes paid_on and balance in the same step). Judged as ONE step: stage
- * requires, statusImplies, date pairs and the stage's date rule are checked on the result.
- * A checker or installer runs it as ONE store call, as the person:
- * `pipeline_move(p_record_id, p_to, p_also => set)` — the door writes `p_also` with the
- * stage in the same record write, judged by the same Rules (the board's "this move needs
- * these fields" prompt makes the same call). Never record_update first: that leaves a
- * half-moved row if the move is then refused.
- */
- | {
-    kind: "move";
-    table: string;
-    row: string;
-    field: string;
-    to: string;
-    set?: Record<string, unknown>;
-}
-/**
- * A GROUPED step: 2–3 linked moves made together ("accept the quote AND move its lead to
- * Agreement signed"). Each move is judged against its own table's transitions, requires,
- * statusImplies and date rules; the template's cross-table rules (statusAgrees,
- * withinParent, childDates) are judged on the state after the WHOLE group. A checker runs it
- * as one `pipeline_move(p_record_id, p_to, p_also => set)` per row, in the listed order, as
- * the person; the expect asserts where one of the moved rows landed.
- */
- | {
-    kind: "moves";
-    moves: WalkMove[];
-}
-/**
- * One field (`field` + `value`) or several at once (`set: {field: value, …}` — "mark paid"
- * sets status, paid and balance together); the coherence rules judge the whole result.
- */
- | {
-    kind: "edit";
-    table: string;
-    row: string;
-    field?: string;
-    value?: unknown;
-    set?: Record<string, unknown>;
-} | {
-    kind: "submit_form";
-    form: string;
-    values: Record<string, unknown>;
-} | {
-    kind: "archive";
-    table: string;
-    row: string;
-} | {
-    kind: "restore";
-    table: string;
-    row: string;
-} | WalkImport | {
-    kind: "ask_agent";
-};
-type WalkAssertion = 
-/** The surface renders with at least `minItems` (≥ 1) records. */
-/**
- * The surface renders with at least `minItems` (≥ 1) records. `within` is the date window the
- * step talks about ("the next three weeks"): relative tokens on the view's date field, checked
- * on every install weekday. A step that names a span on a calendar or timeline must carry it.
- */
-{
-    kind: "renders";
-    surface: string;
-    minItems: number;
-    within?: {
-        from?: string;
-        to?: string;
-    };
-}
-/** Over the walk's state after this step; never 0. */
- | {
-    kind: "count";
-    table: string;
-    where?: Record<string, AggregateFilter>;
-    equals: number;
-} | {
-    kind: "value";
-    table: string;
-    row: string;
-    field: string;
-    equals: unknown;
-} | {
-    kind: "aggregate";
-    table: string;
-    measure: AggregateMeasure;
-    where?: Record<string, AggregateFilter>;
-    equals: number;
-}
-/** After `ask_agent`: the exact number the agent must answer (= agent.question.expect.answer). */
- | {
-    kind: "agent_answer";
-    equals: number;
-}
-/** After `archive` / `restore`: the row it acted on is (or is no longer) archived. */
- | {
-    kind: "archived";
-    table: string;
-    row: string;
-    equals: boolean;
-};
-interface WalkStep {
-    /** What the person does, in plain words: "Drag Rosa to Scheduled". */
-    says: string;
-    action: WalkAction;
-    expect: WalkAssertion;
-}
-/** A table marked as day-one foundation data (R13): kept for the reason given. */
-interface TemplateFoundation {
-    table: string;
-    keptFor: string;
-}
-interface TemplateSource {
-    title: string;
-    url?: string;
-    /** What was taken: structure ideas only — never text, data or a real person. */
-    took: string;
-}
-interface TemplateProvenance extends UseCaseProvenance {
-    sources: TemplateSource[];
-    /** Every domain an email, website or url in the file uses. Each must not resolve in DNS (G6). */
-    fictionalDomains: string[];
-    /** Every street a numbered address in the file is on: invented, never a real street. */
-    fictionalStreets: string[];
-}
-/** The five singular artefacts a UseCase carries; a template derives them (toUseCase). */
-type UseCaseSingulars = "form" | "pipeline" | "dashboardQuestion" | "documentTemplate" | "notificationRule";
-/**
- * ONE TEMPLATE: the UseCase's business, tables and relationships, with the singulars
- * replaced by their plural, installable forms (forms[], stage_rules / document /
- * notification extras, the agent's question).
- */
-interface TemplateSpec extends Omit<UseCase, UseCaseSingulars | "tables" | "provenance" | "industry"> {
-    /** The schema version of this file (TEMPLATE_SPEC_VERSION). */
-    specVersion: typeof TEMPLATE_SPEC_VERSION;
-    /** The CATALOGUE.json row this realises: "T0042". Stable, never positional. */
-    catalogueId: string;
-    industry: IndustryGroup;
-    /** The practitioner's own vertical: "Dental practice", "Residential HVAC". */
-    vertical: string;
-    job: TemplateJob;
-    audience: TemplateAudience;
-    teaches: TeachesFeature;
-    strengths: Strength[];
-    requires: CapabilityWord[];
-    tables: TemplateTable[];
-    sharedBlocks: SharedBlockUse[];
-    views: TemplateView[];
-    forms: TemplateForm[];
-    dimensions: TemplateDimensions[];
-    extras: TemplateExtra[];
-    agent: TemplateAgent;
-    /** Three teaching steps, plus an optional fourth that is the ask_agent step. */
-    walk: [WalkStep, WalkStep, WalkStep] | [WalkStep, WalkStep, WalkStep, WalkStep];
-    foundation: TemplateFoundation[];
-    provenance: TemplateProvenance;
-    /** The gallery card's picture (lane 2), relative to the template file. */
-    previewImage?: string;
-    /** Content version: an integer, bumped on every published change. */
-    version: number;
-    /**
-     * Lane 12 P7: tables that are Confidential (asked of the chair after install — a template never
-     * sets the level itself) and tables whose members add their own rows. See ./confidential.
-     */
-    confidential?: TemplateConfidential[];
-    membersAddRows?: string[];
-    /** Kits → Template merge: more agents the install copies, after `agent`. */
-    extraAgents?: TemplateExtraAgent[];
-    /** Kits → Template merge: workflows the install creates. */
-    workflows?: TemplateWorkflow[];
-    /** Kits → Template merge: how-it-works steps, shown only (the gated teaching steps are `walk`). */
-    guide?: TemplateGuideStep[];
-}
-/** "3 tables · 2 views · 1 form · 1 booking" plus the counts it is made of — what uninstall takes back. */
-interface TemplateFootprint {
-    tables: number;
-    /** Shared-block tables it seeds rows into (not owned: uninstall archives its rows only). */
-    sharedBlocks: number;
-    views: number;
-    forms: number;
-    dimensions: number;
-    extras: Partial<Record<TemplateExtraKind, number>>;
-    agents: number;
-    /** Workflows an install creates (host step). */
-    workflows: number;
-    /**
-     * custom.portal_declare opens the organization's outside sign-in. Q7: uninstall restores
-     * the setting it found (the installer records the before-value).
-     */
-    opensOutsideSignIn: boolean;
-    line: string;
-}
-/** The footprint, DERIVED from the spec — never written by hand, so it cannot drift. */
-declare function footprintOf(spec: Pick<TemplateSpec, "tables" | "views" | "forms" | "extras" | "agent" | "dimensions" | "sharedBlocks"> & Partial<Pick<TemplateSpec, "extraAgents" | "workflows">>): TemplateFootprint;
-declare const CATALOGUE_STATUSES: readonly ["planned", "authoring", "checking", "waiting_on_lane_10", "ready", "published", "retired"];
-type CatalogueStatus = (typeof CATALOGUE_STATUSES)[number];
-interface CatalogueRow {
-    /** Stable forever: a retired row keeps its id with status "retired"; ids are never reused. */
-    catalogueId: string;
-    industry: IndustryGroup;
-    /** The vertical within the group: "Dental practice". */
-    vertical: string;
-    job: TemplateJob;
-    teaches: TeachesFeature;
-    strengths: Strength[];
-    audience: TemplateAudience;
-    /** One sentence the writer starts from: who, what business, what job. */
-    personaSeed: string;
-    ownerLane: string;
-    status: CatalogueStatus;
-    /** "scope-template:<key>" | "use-case:<id>" | "new". */
-    source: string;
-    /** Why a retired row was retired ("duplicate of T0009"). */
-    retiredBecause?: string;
-    /** The gallery card's picture, once the template has one. */
-    previewImage?: string;
-    /** Capabilities this row will need that may still be held (seed.attachments, automation), so batches can skip held rows. */
-    requires?: CapabilityWord[];
-    /**
-     * The real install check of the CURRENT file (scripts/templates-publish.ts verify): installed through
-     * the template family on the clone as a person, then uninstalled. `fileHash` pins which file passed.
-     */
-    installCheck?: {
-        result: "pass" | "fail";
-        /** Where the install ran: "live" since 2026-10-04 (Arman 2026-10-03: checks run on live; the clone is for destructive rehearsals only). */
-        target: "clone" | "live";
-        checkedAt: string;
-        fileHash: string;
-        wallMs: number;
-        installMs?: number;
-        steps?: number;
-        calls?: number;
-        orgId?: string;
-        /** The refusal verbatim (store sentence, validator problem, or uninstall leftover). */
-        refusal?: string;
-    };
-    /** Set by scripts/templates-publish.ts publish once declared for everyone on production. */
-    published?: {
-        templateId: string;
-        version: number;
-        steps: number;
-        publishedAt: string;
-        fileHash: string;
-    };
-}
-/** One platform agent a template may copy (templates/AGENTS.snapshot.json). */
-interface AgentSnapshotRow {
-    id: string;
-    name: string;
-    variables: string[];
-}
-/** One entry of templates/RETIRED_IDS.json — append-only. */
-interface RetiredId {
-    catalogueId: string;
-    retiredOn: string;
-    because: string;
-}
-
 /** The UTC offset ("-04:00") of a local wall-clock moment in an IANA zone. */
 declare function zoneOffset(localIso: string, timeZone: string): string;
 /** One token → "2026-10-08" or "2026-10-08T09:30:00-04:00". `null` when it is not a token. */
@@ -1641,8 +474,17 @@ interface TemplateInstallPlan {
     /** The business's IANA zone: install-relative dates resolve in it. */
     timezone: string;
     steps: TemplatePlanStep[];
-    /** The host's step (the kit path's agent copy), answered by custom.template_install once installed. */
-    agent: TemplatePlanAgent;
+    /**
+     * The host's step (the kit path's agent copy), answered by custom.template_install once installed.
+     * Absent for a spec with no agent (a describe one-off): the door answers no agent step.
+     */
+    agent?: TemplatePlanAgent;
+    /**
+     * Ids known before the first step (`ref:tables.<token>` → an existing table's id, for each table that
+     * `bindsTo` one): custom.template_install starts its id map with these, so every later step and every
+     * `made` entry resolves the bound table exactly as if the install had made it.
+     */
+    ids?: Record<string, string>;
     /** Kits → Template merge (optional): more agent copies, then workflows — host steps too (./extras). */
     extraAgents?: TemplateHostExtras["extraAgents"];
     workflows?: TemplateHostExtras["workflows"];
@@ -1749,4 +591,4 @@ declare function runTemplateDoor(source: RecordsDataSource, door: TemplateFamily
 /** Tables a plan makes (for a suite): the `tables.*` refs its steps save. */
 declare function planTables(plan: TemplateInstallPlan): string[];
 
-export { type AgentSnapshotRow, type AggregateOutcome, CAPABILITY_WORDS, CATALOGUE_QUOTAS, CATALOGUE_STATUSES, CHOICE_COLORS, type CapabilityStatus, type CapabilityWord, type CatalogueRow, type CatalogueStatus, type ChoiceColor, type ConfidentialLevel, type ConfidentialRequest, DEFAULT_TEMPLATE_AGENT, DESIGNATED_REAL_NUMBERS, type DerivedUseCase, ENTITY_REFERENCE_KINDS, FORMULA_FUNCTIONS, INDUSTRY_GROUPS, INSTALL_PLAN_VERSION, type IndustryGroup, MAIN_TABLE_ROWS_MAX, MAIN_TABLE_ROWS_MIN, PUBLIC_MAIL_DOMAINS, RECORDS_UI_CALENDAR_MODES, RECORDS_UI_FIELD_SURFACES, RECORDS_UI_VIEW_LAYOUTS, RELATIVE_DATE, type RetiredId, SERVER_DATE_GRAMMAR, SHARED_BLOCKS, SHARED_BLOCK_IDS, STRENGTHS, type SeedRow, type SharedBlock, type SharedBlockField, type SharedBlockId, type SharedBlockUse, type Strength, TABLES_MAX, TABLES_MIN, TABLE_KERNEL_ID, TEACHES_FEATURES, TEMPLATE_AUDIENCES, TEMPLATE_EXTRA_KINDS, TEMPLATE_JOBS, TEMPLATE_PLAN_DOORS, TEMPLATE_REFERENCE_DATE, TEMPLATE_SPEC_VERSION, TEMPLATE_VIEW_KINDS, TIME_BOUND_STAGE, TITLE_DISTINCT_SHARE, type TeachesFeature, type TemplateAgent, type TemplateAgentBinding, type TemplateAgentCopyRequest, type TemplateAgentQuestion, type TemplateAgentVariable, type TemplateAssetRow, type TemplateAttachment, type TemplateAudience, type TemplateAutomation, type TemplateBooking, type TemplateBookingWindow, type TemplateCalendarView, type TemplateCard, type TemplateChecklist, type TemplateChecklistStep, type TemplateConfidential, type TemplateConfidentialReader, type TemplateDashboard, type TemplateDashboardBlock, type TemplateDeclaration, type TemplateDigest, type TemplateDimensionOverride, type TemplateDimensions, type TemplateDocument, type TemplateDoorAnswer, type TemplateDoorRun, type TemplateDrillDown, type TemplateDrillPath, type TemplateExtra, type TemplateExtraAgent, type TemplateExtraAgentVariable, type TemplateExtraKind, type TemplateFamilyDoor, type TemplateField, type TemplateFootprint, type TemplateForm, type TemplateFormField, type TemplateFoundation, type TemplateGalleryView, type TemplateGridView, type TemplateGuideStep, type TemplateHostExtras, type TemplateInstallPlan, type TemplateJob, type TemplateKanbanView, type TemplateMadeKind, type TemplateMeasureOverride, type TemplateMergeBinding, type TemplateNotification, type TemplatePlanAgent, type TemplatePlanBinding, type TemplatePlanDoor, type TemplatePlanExtraAgent, type TemplatePlanStep, type TemplatePortal, type TemplatePortalTable, type TemplateProvenance, type TemplateRowAction, type TemplateSource, type TemplateSpec, type TemplateSpecWithAttachments, type TemplateStageRules, type TemplateStatus, type TemplateTable, type TemplateTableSettings, type TemplateTimelineView, type TemplateTryIt, type TemplateVerdict, type TemplateView, type TemplateViewKind, type TemplateViewSort, type TemplateWorkflow, type UseCaseSingulars, type ValidateOptions, type WalkAction, type WalkAssertion, type WalkImport, type WalkMove, type WalkStep, agentCopyRequest, allTables, anyOfWhere, assertTemplate, attachmentProblems, automationHeld, blockTable, bookingArgs, bookingColumnsProblem, capabilitiesUsed, capabilityStatus, checklistSpec, choiceDisplayFormat, compileHostExtras, compileInstallPlan, confidentialPending, confidentialRequests, dashboardBlocks, deferredRelationFields, deferredRelations, derivedFieldSpec, digestSpec, documentBody, domainsIn, drillDownDashboard, evalFormula, extrasProblems, footprintOf, foreignTextProblems, formArgs, formulaFieldSpec, formulaOrder, formulaRefs, foundationTokens, isSelfDeclaredField, isTimedField, membersAddRowsSteps, normalizeForPhones, notificationParts, numberText, numberedStreet, parseFormula, parseNumeric, peopleOf, phonesOutsideFictionalRange, planTables, portalArgs, relationFieldSpec, relationPatches, relativeHasTime, requiredCircleProblem, resolveDateToken, resolveRelativeDates, rowActionList, rowLevels, rowsFor, ruleBreak, runTemplateDoor, selfDeclaredFieldSpec, shellsPayload, stageFieldOf, stageRulesSpec, storeAggregate, storeFilterMatches, storeText, tableSettingsProblems, tableShellPayload, templateCard, templateDeclaration, templateText, timedFieldSpec, toUseCase, unwrap, useCaseProblemsOf, validateTemplate, viewMatches, viewSpec, whenRule, zoneOffset };
+export { AgentSnapshotRow, type AggregateOutcome, type CapabilityStatus, CapabilityWord, DESIGNATED_REAL_NUMBERS, type DerivedUseCase, FORMULA_FUNCTIONS, INSTALL_PLAN_VERSION, MAIN_TABLE_ROWS_MAX, MAIN_TABLE_ROWS_MIN, PUBLIC_MAIL_DOMAINS, RECORDS_UI_CALENDAR_MODES, RECORDS_UI_FIELD_SURFACES, RECORDS_UI_VIEW_LAYOUTS, SERVER_DATE_GRAMMAR, type SeedRow, SharedBlockId, TABLES_MAX, TABLES_MIN, TEMPLATE_PLAN_DOORS, TIME_BOUND_STAGE, TITLE_DISTINCT_SHARE, TemplateAgent, type TemplateAgentBinding, type TemplateAgentCopyRequest, type TemplateAssetRow, type TemplateAttachment, TemplateAutomation, TemplateBooking, type TemplateCard, TemplateChecklist, TemplateDashboard, type TemplateDeclaration, TemplateDigest, TemplateDimensions, TemplateDocument, type TemplateDoorAnswer, type TemplateDoorRun, TemplateDrillDown, type TemplateFamilyDoor, TemplateField, TemplateFootprint, TemplateForm, type TemplateHostExtras, type TemplateInstallPlan, type TemplateMadeKind, TemplateMergeBinding, TemplateNotification, type TemplatePlanAgent, type TemplatePlanBinding, type TemplatePlanDoor, type TemplatePlanExtraAgent, type TemplatePlanStep, TemplatePortal, TemplateRowAction, TemplateSpec, type TemplateSpecWithAttachments, TemplateStageRules, type TemplateStatus, TemplateTable, TemplateTryIt, type TemplateVerdict, TemplateView, TemplateWorkflow, type ValidateOptions, agentCopyRequest, allTables, anyOfWhere, assertTemplate, attachmentProblems, automationHeld, blockTable, bookingArgs, bookingColumnsProblem, capabilitiesUsed, capabilityStatus, checklistSpec, choiceDisplayFormat, compileHostExtras, compileInstallPlan, dashboardBlocks, deferredRelationFields, deferredRelations, derivedFieldSpec, digestSpec, documentBody, domainsIn, drillDownDashboard, evalFormula, extrasProblems, foreignTextProblems, formArgs, formulaFieldSpec, formulaOrder, formulaRefs, foundationTokens, isSelfDeclaredField, isTimedField, normalizeForPhones, notificationParts, numberText, numberedStreet, parseFormula, parseNumeric, peopleOf, phonesOutsideFictionalRange, planTables, portalArgs, relationFieldSpec, relationPatches, relativeHasTime, requiredCircleProblem, resolveDateToken, resolveRelativeDates, rowActionList, rowLevels, rowsFor, ruleBreak, runTemplateDoor, selfDeclaredFieldSpec, shellsPayload, stageFieldOf, stageRulesSpec, storeAggregate, storeFilterMatches, storeText, tableShellPayload, templateCard, templateDeclaration, templateText, timedFieldSpec, toUseCase, unwrap, useCaseProblemsOf, validateTemplate, viewMatches, viewSpec, zoneOffset };