@ai-matrx/records 0.96.1 → 0.96.2

package/dist/templates/index.d.cts

@@ -1,5 +1,5 @@
-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, I as IndustryGroup, v as TemplateJob, w as TeachesFeature, x as TemplateViewKind, y as TemplateBookingWindow } from '../types-SezYoQ5_.cjs';
-export { z as CAPABILITY_WORDS, B as CATALOGUE_QUOTAS, D as CATALOGUE_STATUSES, E as CHOICE_COLORS, F as CHOICE_COLORS_DISTINCT_UP_TO, G as CatalogueRow, H as CatalogueStatus, J as ChoiceColor, K as ConfidentialLevel, L as ConfidentialRequest, M as DEFAULT_TEMPLATE_AGENT, N as ENTITY_REFERENCE_KINDS, O as INDUSTRY_GROUPS, R as RELATIVE_DATE, P as RetiredId, Q as SHARED_BLOCKS, U as SHARED_BLOCK_IDS, V as STRENGTHS, W as SharedBlock, X as SharedBlockField, Y as SharedBlockUse, Z as Strength, _ as TABLE_KERNEL_ID, $ as TEACHES_FEATURES, a0 as TEMPLATE_AUDIENCES, a1 as TEMPLATE_EXTRA_KINDS, a2 as TEMPLATE_JOBS, a3 as TEMPLATE_REFERENCE_DATE, a4 as TEMPLATE_SPEC_VERSION, a5 as TEMPLATE_VIEW_KINDS, a6 as TemplateAgentQuestion, a7 as TemplateAgentVariable, a8 as TemplateAudience, a9 as TemplateCalendarView, aa as TemplateChecklistStep, ab as TemplateConfidential, ac as TemplateConfidentialReader, ad as TemplateDashboardBlock, ae as TemplateDimensionOverride, af as TemplateDrillPath, ag as TemplateExtra, ah as TemplateExtraAgent, ai as TemplateExtraAgentVariable, aj as TemplateExtraKind, ak as TemplateFormField, al as TemplateFoundation, am as TemplateGalleryView, an as TemplateGridView, ao as TemplateGuideStep, ap as TemplateKanbanView, aq as TemplateMeasureOverride, ar as TemplatePortalTable, as as TemplateProvenance, at as TemplateSource, au as TemplateTableSettings, av as TemplateTimelineView, aw as TemplateViewSort, ax as UseCaseSingulars, ay as WalkAction, az as WalkAssertion, aA as WalkImport, aB as WalkMove, aC as WalkStep, aD as confidentialPending, aE as confidentialRequests, aF as footprintOf, aG as membersAddRowsSteps, aH as tableSettingsProblems, aI as whenRule } from '../types-SezYoQ5_.cjs';
+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, I as IndustryGroup, v as TemplateJob, w as TeachesFeature, x as TemplateViewKind, y as TemplateBookingWindow } from '../types-BhGs3f8s.cjs';
+export { z as CAPABILITY_WORDS, B as CATALOGUE_QUOTAS, D as CATALOGUE_STATUSES, E as CHOICE_COLORS, F as CHOICE_COLORS_DISTINCT_UP_TO, G as CatalogueRow, H as CatalogueStatus, J as ChoiceColor, K as ConfidentialLevel, L as ConfidentialRequest, M as DEFAULT_TEMPLATE_AGENT, N as ENTITY_REFERENCE_KINDS, O as INDUSTRY_GROUPS, R as RELATIVE_DATE, P as RetiredId, Q as SHARED_BLOCKS, U as SHARED_BLOCK_IDS, V as STRENGTHS, W as SharedBlock, X as SharedBlockField, Y as SharedBlockUse, Z as Strength, _ as TABLE_KERNEL_ID, $ as TEACHES_FEATURES, a0 as TEMPLATE_AUDIENCES, a1 as TEMPLATE_EXTRA_KINDS, a2 as TEMPLATE_JOBS, a3 as TEMPLATE_REFERENCE_DATE, a4 as TEMPLATE_SPEC_VERSION, a5 as TEMPLATE_VIEW_KINDS, a6 as TemplateAgentQuestion, a7 as TemplateAgentVariable, a8 as TemplateAudience, a9 as TemplateCalendarView, aa as TemplateChecklistStep, ab as TemplateConfidential, ac as TemplateConfidentialReader, ad as TemplateDashboardBlock, ae as TemplateDimensionOverride, af as TemplateDrillPath, ag as TemplateExtra, ah as TemplateExtraAgent, ai as TemplateExtraAgentVariable, aj as TemplateExtraKind, ak as TemplateFormField, al as TemplateFoundation, am as TemplateGalleryView, an as TemplateGridView, ao as TemplateGuideStep, ap as TemplateKanbanView, aq as TemplateMeasureOverride, ar as TemplatePortalTable, as as TemplateProvenance, at as TemplateSource, au as TemplateTableSettings, av as TemplateTimelineView, aw as TemplateViewSort, ax as UseCaseSingulars, ay as WalkAction, az as WalkAssertion, aA as WalkImport, aB as WalkMove, aC as WalkStep, aD as confidentialPending, aE as confidentialRequests, aF as footprintOf, aG as membersAddRowsSteps, aH as tableSettingsProblems, aI as whenRule } from '../types-BhGs3f8s.cjs';
 import { c as AggregateMeasure, b as AggregateFilter } from '../subscription-ycCVo9e2.cjs';
 import { U as UseCase, o as UseCaseRelationship } from '../types-DtEP7XLv.cjs';
 import { U as UseCaseProblem } from '../validate-QdnFP97_.cjs';
@@ -390,6 +390,15 @@ declare function digestSpec(digest: TemplateDigest, viewId: string): Record<stri
 declare function checklistSpec(checklist: TemplateChecklist, tables: Record<string, string>, forms: Record<string, string>, documents: Record<string, string>): Record<string, unknown>;
 /** An automation has no door yet: lane 11 owes it, and the validator holds such a template. */
 declare function automationHeld(a: TemplateAutomation): string;
+/** The triggers a template automation installs, by the use-case event word. */
+declare const AUTOMATION_EVENTS: readonly ["created", "due", "overdue"];
+/**
+ * custom.automation_declare's spec for one template automation: a reminder that tells the person who set
+ * it up (the installer — `to: {author: true}`). `due` waits for the date `daysBefore` days ahead
+ * (offset_days negative), `overdue` the day after it, `created` runs on every new row. Field ids are
+ * install-time refs (`${ref:fields.<table>.<key>}`).
+ */
+declare function automationSpec(a: TemplateAutomation, fieldIds: Record<string, string>): Record<string, unknown>;
 /**
  * What custom.booking_declare requires of its table, said BEFORE install: a `slot` column (the door
  * writes the booked time into it on confirm, and adds it as a required text column when missing),
@@ -444,7 +453,7 @@ declare const INSTALL_PLAN_VERSION: 1;
  */
 declare const SERVER_DATE_GRAMMAR: RegExp;
 /** The store doors a plan may call — the server's custom._template_doors(), mirrored. */
-declare const TEMPLATE_PLAN_DOORS: readonly ["person_kernel_id", "file_kernel_id", "record_write", "record_write_many", "record_change_many", "table_from_example", "table_declare", "field_declare", "applicable_fields", "table_dimensions_set", "view_declare", "form_declare", "anon_publish", "booking_declare", "dashboard_declare", "pipeline_declare", "doc_template_save", "action_declare", "subscription_declare", "rule_declare", "checklist_declare", "portal_declare", "query_table_homes"];
+declare const TEMPLATE_PLAN_DOORS: readonly ["person_kernel_id", "file_kernel_id", "record_write", "record_write_many", "record_change_many", "table_from_example", "table_declare", "field_declare", "applicable_fields", "table_dimensions_set", "view_declare", "form_declare", "anon_publish", "booking_declare", "dashboard_declare", "pipeline_declare", "doc_template_save", "action_declare", "subscription_declare", "rule_declare", "checklist_declare", "portal_declare", "query_table_homes", "automation_declare"];
 type TemplatePlanDoor = (typeof TEMPLATE_PLAN_DOORS)[number];
 /** What uninstall archives for a step, by kind (custom.template_uninstall). */
 type TemplateMadeKind = "table" | "field" | "view" | "form" | "dashboard" | "document" | "portal" | "record" | "rule";
@@ -789,6 +798,8 @@ interface ExistingTable {
 interface DescribeCtx {
     plan?: DescribePlan;
     existingTables?: ExistingTable[];
+    /** Install day, YYYY-MM-DD in the business's zone: absolute seed dates become relative to it. Defaults to today in UTC. */
+    today?: string;
 }
 /** S7: the answer the frontend's describe box already reads. */
 interface DescribeResult {
@@ -837,7 +848,6 @@ interface AutofixResult {
 interface DescribeCheckResult extends AutofixResult {
     problems: DescribeProblem[];
 }
-/** S5 steps 2–9. Never mutates its input. */
 declare function autofixDescribeSpec(input: TemplateSpec | Record<string, unknown>, ctx?: DescribeCtx): AutofixResult;
 /** S5 whole: autofix, then the describe-profile check. */
 declare function describeCheck(spec: TemplateSpec | Record<string, unknown>, ctx?: DescribeCtx): DescribeCheckResult;
@@ -954,4 +964,4 @@ declare function describeResultJsonSchema(): Record<string, unknown>;
 /** The template as the check reads it: every JSON-text part opened (an object already open is left as it is). */
 declare function parseDescribeTemplate(template: Record<string, unknown>): Record<string, unknown>;
 
-export { AgentSnapshotRow, type AggregateOutcome, type ApplyResult, type AutofixResult, BAD_OUTCOME, BOOKING_AVAILABILITY_FACTS, type CapabilityStatus, CapabilityWord, DESCRIBE_RESULT_KIND, DESIGNATED_REAL_NUMBERS, type DerivedUseCase, type DescribeCheckResult, type DescribeCtx, type DescribePlan, type DescribePlanDoor, type DescribePlanTable, type DescribeProblem, type DescribeResult, type DoorsPart, type ExistingTable, FORMULA_FUNCTION_NAMES, type FieldRequest, GALLERY_ONLY, GOOD_OUTCOME, INSTALL_PLAN_VERSION, IndustryGroup, MAIN_TABLE_ROWS_MAX, MAIN_TABLE_ROWS_MIN, PUBLIC_MAIL_DOMAINS, RECORDS_UI_CALENDAR_MODES, RECORDS_UI_FIELD_SURFACES, RECORDS_UI_VIEW_LAYOUTS, type RepairAnswer, type RepairPatch, type RepairSlice, SERVER_DATE_GRAMMAR, type SafeReusesResult, type SeedRow, SharedBlockId, TABLES_MAX, TABLES_MIN, TEMPLATE_PLAN_DOORS, TIME_BOUND_STAGE, TITLE_DISTINCT_SHARE, type TablesPart, TeachesFeature, TemplateAgent, type TemplateAgentBinding, type TemplateAgentCopyRequest, type TemplateAssetRow, type TemplateAttachment, TemplateAutomation, TemplateBooking, TemplateBookingWindow, type TemplateCard, TemplateChecklist, TemplateDashboard, type TemplateDeclaration, TemplateDigest, TemplateDimensions, TemplateDocument, type TemplateDoorAnswer, type TemplateDoorRun, TemplateDrillDown, type TemplateFamilyDoor, TemplateField, TemplateFootprint, TemplateForm, type TemplateHostExtras, type TemplateInstallPlan, TemplateJob, 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 TemplateUpgradeAnswer, type TemplateUpgradeHint, type TemplateUpgradeRun, type TemplateVerdict, TemplateView, TemplateViewKind, TemplateWorkflow, type TrimResult, VIEW_SHAPE_FACTS, type ValidateOptions, type ViewsPart, agentCopyRequest, allTables, anyOfWhere, applyRepairPatches, assertTemplate, attachmentProblems, autofixDescribeSpec, automationHeld, blockTable, bookingArgs, bookingColumnsProblem, capabilitiesUsed, capabilityStatus, checklistSpec, choiceDisplayFormat, compileHostExtras, compileInstallPlan, dashboardBlocks, deferredRelationFields, deferredRelations, derivedFieldSpec, describeCheck, describeResultJsonSchema, describeSpec, describeVocabulary, digestSpec, documentBody, domainsIn, drillDownDashboard, evalFormula, extrasProblems, fallbackView, foreignTextProblems, formArgs, formulaFieldSpec, formulaOrder, formulaRefs, foundationTokens, isSelfDeclaredField, isTimedField, lastResortTrim, meaningWords, mergeDescribeParts, normalizeForPhones, notificationParts, numberText, numberedStreet, packageDescribeResult, parseAt, parseDescribeTemplate, parseGateFormula, parseNumeric, pathOfAt, peopleOf, phonesOutsideFictionalRange, planTables, portalArgs, relationFieldSpec, relationPatches, relativeHasTime, repairSlices, requiredCircleProblem, resolveDateToken, resolvePath, resolveRelativeDates, reusesOf, rowActionList, rowLevels, rowsFor, ruleBreak, runTemplateDoor, safeReuses, sameMeaning, selfDeclaredFieldSpec, sensitivityFloorOf, shellsPayload, stageFieldOf, stageRulesSpec, storeAggregate, storeFilterMatches, storeText, tableShellPayload, templateCard, templateDeclaration, templateText, templateUpgradeHint, timedFieldSpec, toUseCase, unwrap, upgradeTemplateInstall, useCaseProblemsOf, validateTemplate, viewMatches, viewSpec, zoneOffset };
+export { AUTOMATION_EVENTS, AgentSnapshotRow, type AggregateOutcome, type ApplyResult, type AutofixResult, BAD_OUTCOME, BOOKING_AVAILABILITY_FACTS, type CapabilityStatus, CapabilityWord, DESCRIBE_RESULT_KIND, DESIGNATED_REAL_NUMBERS, type DerivedUseCase, type DescribeCheckResult, type DescribeCtx, type DescribePlan, type DescribePlanDoor, type DescribePlanTable, type DescribeProblem, type DescribeResult, type DoorsPart, type ExistingTable, FORMULA_FUNCTION_NAMES, type FieldRequest, GALLERY_ONLY, GOOD_OUTCOME, INSTALL_PLAN_VERSION, IndustryGroup, MAIN_TABLE_ROWS_MAX, MAIN_TABLE_ROWS_MIN, PUBLIC_MAIL_DOMAINS, RECORDS_UI_CALENDAR_MODES, RECORDS_UI_FIELD_SURFACES, RECORDS_UI_VIEW_LAYOUTS, type RepairAnswer, type RepairPatch, type RepairSlice, SERVER_DATE_GRAMMAR, type SafeReusesResult, type SeedRow, SharedBlockId, TABLES_MAX, TABLES_MIN, TEMPLATE_PLAN_DOORS, TIME_BOUND_STAGE, TITLE_DISTINCT_SHARE, type TablesPart, TeachesFeature, TemplateAgent, type TemplateAgentBinding, type TemplateAgentCopyRequest, type TemplateAssetRow, type TemplateAttachment, TemplateAutomation, TemplateBooking, TemplateBookingWindow, type TemplateCard, TemplateChecklist, TemplateDashboard, type TemplateDeclaration, TemplateDigest, TemplateDimensions, TemplateDocument, type TemplateDoorAnswer, type TemplateDoorRun, TemplateDrillDown, type TemplateFamilyDoor, TemplateField, TemplateFootprint, TemplateForm, type TemplateHostExtras, type TemplateInstallPlan, TemplateJob, 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 TemplateUpgradeAnswer, type TemplateUpgradeHint, type TemplateUpgradeRun, type TemplateVerdict, TemplateView, TemplateViewKind, TemplateWorkflow, type TrimResult, VIEW_SHAPE_FACTS, type ValidateOptions, type ViewsPart, agentCopyRequest, allTables, anyOfWhere, applyRepairPatches, assertTemplate, attachmentProblems, autofixDescribeSpec, automationHeld, automationSpec, blockTable, bookingArgs, bookingColumnsProblem, capabilitiesUsed, capabilityStatus, checklistSpec, choiceDisplayFormat, compileHostExtras, compileInstallPlan, dashboardBlocks, deferredRelationFields, deferredRelations, derivedFieldSpec, describeCheck, describeResultJsonSchema, describeSpec, describeVocabulary, digestSpec, documentBody, domainsIn, drillDownDashboard, evalFormula, extrasProblems, fallbackView, foreignTextProblems, formArgs, formulaFieldSpec, formulaOrder, formulaRefs, foundationTokens, isSelfDeclaredField, isTimedField, lastResortTrim, meaningWords, mergeDescribeParts, normalizeForPhones, notificationParts, numberText, numberedStreet, packageDescribeResult, parseAt, parseDescribeTemplate, parseGateFormula, parseNumeric, pathOfAt, peopleOf, phonesOutsideFictionalRange, planTables, portalArgs, relationFieldSpec, relationPatches, relativeHasTime, repairSlices, requiredCircleProblem, resolveDateToken, resolvePath, resolveRelativeDates, reusesOf, rowActionList, rowLevels, rowsFor, ruleBreak, runTemplateDoor, safeReuses, sameMeaning, selfDeclaredFieldSpec, sensitivityFloorOf, shellsPayload, stageFieldOf, stageRulesSpec, storeAggregate, storeFilterMatches, storeText, tableShellPayload, templateCard, templateDeclaration, templateText, templateUpgradeHint, timedFieldSpec, toUseCase, unwrap, upgradeTemplateInstall, useCaseProblemsOf, validateTemplate, viewMatches, viewSpec, zoneOffset };

package/dist/templates/index.d.ts

@@ -1,5 +1,5 @@
-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, I as IndustryGroup, v as TemplateJob, w as TeachesFeature, x as TemplateViewKind, y as TemplateBookingWindow } from '../types-Cl0b_Hy8.js';
-export { z as CAPABILITY_WORDS, B as CATALOGUE_QUOTAS, D as CATALOGUE_STATUSES, E as CHOICE_COLORS, F as CHOICE_COLORS_DISTINCT_UP_TO, G as CatalogueRow, H as CatalogueStatus, J as ChoiceColor, K as ConfidentialLevel, L as ConfidentialRequest, M as DEFAULT_TEMPLATE_AGENT, N as ENTITY_REFERENCE_KINDS, O as INDUSTRY_GROUPS, R as RELATIVE_DATE, P as RetiredId, Q as SHARED_BLOCKS, U as SHARED_BLOCK_IDS, V as STRENGTHS, W as SharedBlock, X as SharedBlockField, Y as SharedBlockUse, Z as Strength, _ as TABLE_KERNEL_ID, $ as TEACHES_FEATURES, a0 as TEMPLATE_AUDIENCES, a1 as TEMPLATE_EXTRA_KINDS, a2 as TEMPLATE_JOBS, a3 as TEMPLATE_REFERENCE_DATE, a4 as TEMPLATE_SPEC_VERSION, a5 as TEMPLATE_VIEW_KINDS, a6 as TemplateAgentQuestion, a7 as TemplateAgentVariable, a8 as TemplateAudience, a9 as TemplateCalendarView, aa as TemplateChecklistStep, ab as TemplateConfidential, ac as TemplateConfidentialReader, ad as TemplateDashboardBlock, ae as TemplateDimensionOverride, af as TemplateDrillPath, ag as TemplateExtra, ah as TemplateExtraAgent, ai as TemplateExtraAgentVariable, aj as TemplateExtraKind, ak as TemplateFormField, al as TemplateFoundation, am as TemplateGalleryView, an as TemplateGridView, ao as TemplateGuideStep, ap as TemplateKanbanView, aq as TemplateMeasureOverride, ar as TemplatePortalTable, as as TemplateProvenance, at as TemplateSource, au as TemplateTableSettings, av as TemplateTimelineView, aw as TemplateViewSort, ax as UseCaseSingulars, ay as WalkAction, az as WalkAssertion, aA as WalkImport, aB as WalkMove, aC as WalkStep, aD as confidentialPending, aE as confidentialRequests, aF as footprintOf, aG as membersAddRowsSteps, aH as tableSettingsProblems, aI as whenRule } from '../types-Cl0b_Hy8.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, I as IndustryGroup, v as TemplateJob, w as TeachesFeature, x as TemplateViewKind, y as TemplateBookingWindow } from '../types-DAruHh1G.js';
+export { z as CAPABILITY_WORDS, B as CATALOGUE_QUOTAS, D as CATALOGUE_STATUSES, E as CHOICE_COLORS, F as CHOICE_COLORS_DISTINCT_UP_TO, G as CatalogueRow, H as CatalogueStatus, J as ChoiceColor, K as ConfidentialLevel, L as ConfidentialRequest, M as DEFAULT_TEMPLATE_AGENT, N as ENTITY_REFERENCE_KINDS, O as INDUSTRY_GROUPS, R as RELATIVE_DATE, P as RetiredId, Q as SHARED_BLOCKS, U as SHARED_BLOCK_IDS, V as STRENGTHS, W as SharedBlock, X as SharedBlockField, Y as SharedBlockUse, Z as Strength, _ as TABLE_KERNEL_ID, $ as TEACHES_FEATURES, a0 as TEMPLATE_AUDIENCES, a1 as TEMPLATE_EXTRA_KINDS, a2 as TEMPLATE_JOBS, a3 as TEMPLATE_REFERENCE_DATE, a4 as TEMPLATE_SPEC_VERSION, a5 as TEMPLATE_VIEW_KINDS, a6 as TemplateAgentQuestion, a7 as TemplateAgentVariable, a8 as TemplateAudience, a9 as TemplateCalendarView, aa as TemplateChecklistStep, ab as TemplateConfidential, ac as TemplateConfidentialReader, ad as TemplateDashboardBlock, ae as TemplateDimensionOverride, af as TemplateDrillPath, ag as TemplateExtra, ah as TemplateExtraAgent, ai as TemplateExtraAgentVariable, aj as TemplateExtraKind, ak as TemplateFormField, al as TemplateFoundation, am as TemplateGalleryView, an as TemplateGridView, ao as TemplateGuideStep, ap as TemplateKanbanView, aq as TemplateMeasureOverride, ar as TemplatePortalTable, as as TemplateProvenance, at as TemplateSource, au as TemplateTableSettings, av as TemplateTimelineView, aw as TemplateViewSort, ax as UseCaseSingulars, ay as WalkAction, az as WalkAssertion, aA as WalkImport, aB as WalkMove, aC as WalkStep, aD as confidentialPending, aE as confidentialRequests, aF as footprintOf, aG as membersAddRowsSteps, aH as tableSettingsProblems, aI as whenRule } from '../types-DAruHh1G.js';
 import { c as AggregateMeasure, b as AggregateFilter } from '../subscription-DucBLG-Y.js';
 import { U as UseCase, o as UseCaseRelationship } from '../types-D31PewA2.js';
 import { U as UseCaseProblem } from '../validate-BWqeG2sK.js';
@@ -390,6 +390,15 @@ declare function digestSpec(digest: TemplateDigest, viewId: string): Record<stri
 declare function checklistSpec(checklist: TemplateChecklist, tables: Record<string, string>, forms: Record<string, string>, documents: Record<string, string>): Record<string, unknown>;
 /** An automation has no door yet: lane 11 owes it, and the validator holds such a template. */
 declare function automationHeld(a: TemplateAutomation): string;
+/** The triggers a template automation installs, by the use-case event word. */
+declare const AUTOMATION_EVENTS: readonly ["created", "due", "overdue"];
+/**
+ * custom.automation_declare's spec for one template automation: a reminder that tells the person who set
+ * it up (the installer — `to: {author: true}`). `due` waits for the date `daysBefore` days ahead
+ * (offset_days negative), `overdue` the day after it, `created` runs on every new row. Field ids are
+ * install-time refs (`${ref:fields.<table>.<key>}`).
+ */
+declare function automationSpec(a: TemplateAutomation, fieldIds: Record<string, string>): Record<string, unknown>;
 /**
  * What custom.booking_declare requires of its table, said BEFORE install: a `slot` column (the door
  * writes the booked time into it on confirm, and adds it as a required text column when missing),
@@ -444,7 +453,7 @@ declare const INSTALL_PLAN_VERSION: 1;
  */
 declare const SERVER_DATE_GRAMMAR: RegExp;
 /** The store doors a plan may call — the server's custom._template_doors(), mirrored. */
-declare const TEMPLATE_PLAN_DOORS: readonly ["person_kernel_id", "file_kernel_id", "record_write", "record_write_many", "record_change_many", "table_from_example", "table_declare", "field_declare", "applicable_fields", "table_dimensions_set", "view_declare", "form_declare", "anon_publish", "booking_declare", "dashboard_declare", "pipeline_declare", "doc_template_save", "action_declare", "subscription_declare", "rule_declare", "checklist_declare", "portal_declare", "query_table_homes"];
+declare const TEMPLATE_PLAN_DOORS: readonly ["person_kernel_id", "file_kernel_id", "record_write", "record_write_many", "record_change_many", "table_from_example", "table_declare", "field_declare", "applicable_fields", "table_dimensions_set", "view_declare", "form_declare", "anon_publish", "booking_declare", "dashboard_declare", "pipeline_declare", "doc_template_save", "action_declare", "subscription_declare", "rule_declare", "checklist_declare", "portal_declare", "query_table_homes", "automation_declare"];
 type TemplatePlanDoor = (typeof TEMPLATE_PLAN_DOORS)[number];
 /** What uninstall archives for a step, by kind (custom.template_uninstall). */
 type TemplateMadeKind = "table" | "field" | "view" | "form" | "dashboard" | "document" | "portal" | "record" | "rule";
@@ -789,6 +798,8 @@ interface ExistingTable {
 interface DescribeCtx {
     plan?: DescribePlan;
     existingTables?: ExistingTable[];
+    /** Install day, YYYY-MM-DD in the business's zone: absolute seed dates become relative to it. Defaults to today in UTC. */
+    today?: string;
 }
 /** S7: the answer the frontend's describe box already reads. */
 interface DescribeResult {
@@ -837,7 +848,6 @@ interface AutofixResult {
 interface DescribeCheckResult extends AutofixResult {
     problems: DescribeProblem[];
 }
-/** S5 steps 2–9. Never mutates its input. */
 declare function autofixDescribeSpec(input: TemplateSpec | Record<string, unknown>, ctx?: DescribeCtx): AutofixResult;
 /** S5 whole: autofix, then the describe-profile check. */
 declare function describeCheck(spec: TemplateSpec | Record<string, unknown>, ctx?: DescribeCtx): DescribeCheckResult;
@@ -954,4 +964,4 @@ declare function describeResultJsonSchema(): Record<string, unknown>;
 /** The template as the check reads it: every JSON-text part opened (an object already open is left as it is). */
 declare function parseDescribeTemplate(template: Record<string, unknown>): Record<string, unknown>;
 
-export { AgentSnapshotRow, type AggregateOutcome, type ApplyResult, type AutofixResult, BAD_OUTCOME, BOOKING_AVAILABILITY_FACTS, type CapabilityStatus, CapabilityWord, DESCRIBE_RESULT_KIND, DESIGNATED_REAL_NUMBERS, type DerivedUseCase, type DescribeCheckResult, type DescribeCtx, type DescribePlan, type DescribePlanDoor, type DescribePlanTable, type DescribeProblem, type DescribeResult, type DoorsPart, type ExistingTable, FORMULA_FUNCTION_NAMES, type FieldRequest, GALLERY_ONLY, GOOD_OUTCOME, INSTALL_PLAN_VERSION, IndustryGroup, MAIN_TABLE_ROWS_MAX, MAIN_TABLE_ROWS_MIN, PUBLIC_MAIL_DOMAINS, RECORDS_UI_CALENDAR_MODES, RECORDS_UI_FIELD_SURFACES, RECORDS_UI_VIEW_LAYOUTS, type RepairAnswer, type RepairPatch, type RepairSlice, SERVER_DATE_GRAMMAR, type SafeReusesResult, type SeedRow, SharedBlockId, TABLES_MAX, TABLES_MIN, TEMPLATE_PLAN_DOORS, TIME_BOUND_STAGE, TITLE_DISTINCT_SHARE, type TablesPart, TeachesFeature, TemplateAgent, type TemplateAgentBinding, type TemplateAgentCopyRequest, type TemplateAssetRow, type TemplateAttachment, TemplateAutomation, TemplateBooking, TemplateBookingWindow, type TemplateCard, TemplateChecklist, TemplateDashboard, type TemplateDeclaration, TemplateDigest, TemplateDimensions, TemplateDocument, type TemplateDoorAnswer, type TemplateDoorRun, TemplateDrillDown, type TemplateFamilyDoor, TemplateField, TemplateFootprint, TemplateForm, type TemplateHostExtras, type TemplateInstallPlan, TemplateJob, 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 TemplateUpgradeAnswer, type TemplateUpgradeHint, type TemplateUpgradeRun, type TemplateVerdict, TemplateView, TemplateViewKind, TemplateWorkflow, type TrimResult, VIEW_SHAPE_FACTS, type ValidateOptions, type ViewsPart, agentCopyRequest, allTables, anyOfWhere, applyRepairPatches, assertTemplate, attachmentProblems, autofixDescribeSpec, automationHeld, blockTable, bookingArgs, bookingColumnsProblem, capabilitiesUsed, capabilityStatus, checklistSpec, choiceDisplayFormat, compileHostExtras, compileInstallPlan, dashboardBlocks, deferredRelationFields, deferredRelations, derivedFieldSpec, describeCheck, describeResultJsonSchema, describeSpec, describeVocabulary, digestSpec, documentBody, domainsIn, drillDownDashboard, evalFormula, extrasProblems, fallbackView, foreignTextProblems, formArgs, formulaFieldSpec, formulaOrder, formulaRefs, foundationTokens, isSelfDeclaredField, isTimedField, lastResortTrim, meaningWords, mergeDescribeParts, normalizeForPhones, notificationParts, numberText, numberedStreet, packageDescribeResult, parseAt, parseDescribeTemplate, parseGateFormula, parseNumeric, pathOfAt, peopleOf, phonesOutsideFictionalRange, planTables, portalArgs, relationFieldSpec, relationPatches, relativeHasTime, repairSlices, requiredCircleProblem, resolveDateToken, resolvePath, resolveRelativeDates, reusesOf, rowActionList, rowLevels, rowsFor, ruleBreak, runTemplateDoor, safeReuses, sameMeaning, selfDeclaredFieldSpec, sensitivityFloorOf, shellsPayload, stageFieldOf, stageRulesSpec, storeAggregate, storeFilterMatches, storeText, tableShellPayload, templateCard, templateDeclaration, templateText, templateUpgradeHint, timedFieldSpec, toUseCase, unwrap, upgradeTemplateInstall, useCaseProblemsOf, validateTemplate, viewMatches, viewSpec, zoneOffset };
+export { AUTOMATION_EVENTS, AgentSnapshotRow, type AggregateOutcome, type ApplyResult, type AutofixResult, BAD_OUTCOME, BOOKING_AVAILABILITY_FACTS, type CapabilityStatus, CapabilityWord, DESCRIBE_RESULT_KIND, DESIGNATED_REAL_NUMBERS, type DerivedUseCase, type DescribeCheckResult, type DescribeCtx, type DescribePlan, type DescribePlanDoor, type DescribePlanTable, type DescribeProblem, type DescribeResult, type DoorsPart, type ExistingTable, FORMULA_FUNCTION_NAMES, type FieldRequest, GALLERY_ONLY, GOOD_OUTCOME, INSTALL_PLAN_VERSION, IndustryGroup, MAIN_TABLE_ROWS_MAX, MAIN_TABLE_ROWS_MIN, PUBLIC_MAIL_DOMAINS, RECORDS_UI_CALENDAR_MODES, RECORDS_UI_FIELD_SURFACES, RECORDS_UI_VIEW_LAYOUTS, type RepairAnswer, type RepairPatch, type RepairSlice, SERVER_DATE_GRAMMAR, type SafeReusesResult, type SeedRow, SharedBlockId, TABLES_MAX, TABLES_MIN, TEMPLATE_PLAN_DOORS, TIME_BOUND_STAGE, TITLE_DISTINCT_SHARE, type TablesPart, TeachesFeature, TemplateAgent, type TemplateAgentBinding, type TemplateAgentCopyRequest, type TemplateAssetRow, type TemplateAttachment, TemplateAutomation, TemplateBooking, TemplateBookingWindow, type TemplateCard, TemplateChecklist, TemplateDashboard, type TemplateDeclaration, TemplateDigest, TemplateDimensions, TemplateDocument, type TemplateDoorAnswer, type TemplateDoorRun, TemplateDrillDown, type TemplateFamilyDoor, TemplateField, TemplateFootprint, TemplateForm, type TemplateHostExtras, type TemplateInstallPlan, TemplateJob, 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 TemplateUpgradeAnswer, type TemplateUpgradeHint, type TemplateUpgradeRun, type TemplateVerdict, TemplateView, TemplateViewKind, TemplateWorkflow, type TrimResult, VIEW_SHAPE_FACTS, type ValidateOptions, type ViewsPart, agentCopyRequest, allTables, anyOfWhere, applyRepairPatches, assertTemplate, attachmentProblems, autofixDescribeSpec, automationHeld, automationSpec, blockTable, bookingArgs, bookingColumnsProblem, capabilitiesUsed, capabilityStatus, checklistSpec, choiceDisplayFormat, compileHostExtras, compileInstallPlan, dashboardBlocks, deferredRelationFields, deferredRelations, derivedFieldSpec, describeCheck, describeResultJsonSchema, describeSpec, describeVocabulary, digestSpec, documentBody, domainsIn, drillDownDashboard, evalFormula, extrasProblems, fallbackView, foreignTextProblems, formArgs, formulaFieldSpec, formulaOrder, formulaRefs, foundationTokens, isSelfDeclaredField, isTimedField, lastResortTrim, meaningWords, mergeDescribeParts, normalizeForPhones, notificationParts, numberText, numberedStreet, packageDescribeResult, parseAt, parseDescribeTemplate, parseGateFormula, parseNumeric, pathOfAt, peopleOf, phonesOutsideFictionalRange, planTables, portalArgs, relationFieldSpec, relationPatches, relativeHasTime, repairSlices, requiredCircleProblem, resolveDateToken, resolvePath, resolveRelativeDates, reusesOf, rowActionList, rowLevels, rowsFor, ruleBreak, runTemplateDoor, safeReuses, sameMeaning, selfDeclaredFieldSpec, sensitivityFloorOf, shellsPayload, stageFieldOf, stageRulesSpec, storeAggregate, storeFilterMatches, storeText, tableShellPayload, templateCard, templateDeclaration, templateText, templateUpgradeHint, timedFieldSpec, toUseCase, unwrap, upgradeTemplateInstall, useCaseProblemsOf, validateTemplate, viewMatches, viewSpec, zoneOffset };

package/dist/templates/index.js

@@ -2546,7 +2546,21 @@ function checklistSpec(checklist, tables, forms, documents) {
   };
 }
 function automationHeld(a) {
-  return `The automation "${a.name}" is held for lane 11: no store door runs automations yet, so a template carrying one is held, never installed without it.`;
+  return `The automation "${a.name}" has a trigger the install cannot set up (${a.when.event}); a template automation runs on created, due or overdue.`;
+}
+var AUTOMATION_EVENTS = ["created", "due", "overdue"];
+function automationSpec(a, fieldIds) {
+  const text2 = (a.message?.trim() || a.then.trim()).slice(0, 600);
+  const actions = [{ do: "notify", to: { author: true }, text: text2 }];
+  const at = a.at && /^([01][0-9]|2[0-3]):[0-5][0-9]$/.test(a.at) ? a.at : "09:00";
+  if (a.when.event === "created") return { name: a.name, trigger: { on: "row_added" }, actions };
+  if (a.when.event === "due" || a.when.event === "overdue") {
+    const field2 = a.when.field ? fieldIds[a.when.field] : void 0;
+    if (!field2) throw new Error(`The automation "${a.name}" waits for "${a.when.field ?? "?"}", which "${a.when.table}" does not declare.`);
+    const offset = a.when.event === "due" ? -Math.max(0, Math.round(a.when.daysBefore ?? 0)) : 1;
+    return { name: a.name, trigger: { on: "date_arrives", field: field2, offset_days: offset, at }, actions };
+  }
+  throw new Error(automationHeld(a));
 }
 function bookingColumnsProblem(tables, booking) {
   const t = tables.find((x) => x.token === booking.table);
@@ -3048,6 +3062,7 @@ var DOOR_FOR = {
   document: "doc_template_save",
   "document.esign": "doc_sign",
   notification: "rule_declare",
+  automation: "automation_declare",
   stage_rules: "pipeline_declare",
   row_action: "action_declare",
   "import.upsert": "io_import_begin",
@@ -3055,9 +3070,7 @@ var DOOR_FOR = {
   agent: "agent_context",
   "view.kanban.swimlanes": "view_declare"
 };
-var OWED_BY = {
-  automation: "lane 11"
-};
+var OWED_BY = {};
 var STORE_DOOR_NAMES = new Set(STORE_DOORS.map((d) => d.name));
 var STORE_FIELD_KINDS = new Set(BEHAVIOR_OF.keys());
 function capabilityStatus(word) {
@@ -3645,7 +3658,8 @@ function validateTemplate(raw, options = {}) {
     const e = effective(table, f);
     return e.contextPolicy !== "exclude" && e.sensitivity !== "restricted";
   };
-  if (own.length < TABLES_MIN || own.length > TABLES_MAX) say("tables", `A template installs ${TABLES_MIN}\u2013${TABLES_MAX} related tables; this one has ${own.length}.`);
+  if (own.length === 0 || own.length > TABLES_MAX) say("tables", `A template installs ${TABLES_MIN}\u2013${TABLES_MAX} related tables; this one has ${own.length}.`);
+  else if (own.length < TABLES_MIN) sayGallery("tables", `A template installs ${TABLES_MIN}\u2013${TABLES_MAX} related tables; this one has ${own.length}.`);
   const main = own[0];
   if (main && (main.rows.length < MAIN_TABLE_ROWS_MIN || main.rows.length > MAIN_TABLE_ROWS_MAX)) {
     say(`tables[0] (${main.token}).rows`, `The main table carries ${MAIN_TABLE_ROWS_MIN}\u2013${MAIN_TABLE_ROWS_MAX} realistic rows; it has ${main.rows.length}.`);
@@ -3683,12 +3697,12 @@ function validateTemplate(raw, options = {}) {
         if (seeds.length) {
           const hi = Math.max(...seeds);
           const lo = Math.min(...seeds);
-          if (new Set(seeds).size < 2) say(`${at}`, `Every seed row holds the same ${field2.label}; real records vary.`);
+          if (new Set(seeds).size < 2) saySeed(`${at}`, `Every seed row holds the same ${field2.label}; real records vary.`);
           for (const rule of field2.rules ?? []) {
             const bound = Number(rule.value);
-            if (rule.kind === "max" && hi > 0 && bound > 100 * hi) say(`${at}.rules`, `The most "${field2.label}" allows (${rule.value}) is over 100\xD7 the largest real value (${hi}); write the real ceiling.`);
-            if (rule.kind === "min" && bound < -1e3 * Math.abs(lo)) say(`${at}.rules`, `The least "${field2.label}" allows (${rule.value}) is far below any real value (${lo}); write the real floor.`);
-            if (rule.kind === "min" && bound < 0 && lo >= 0) say(`${at}.rules`, `"${field2.label}" allows negative values, and no real one is negative; the floor is 0 or above.`);
+            if (rule.kind === "max" && hi > 0 && bound > 100 * hi) saySeed(`${at}.rules`, `The most "${field2.label}" allows (${rule.value}) is over 100\xD7 the largest real value (${hi}); write the real ceiling.`);
+            if (rule.kind === "min" && bound < -1e3 * Math.abs(lo)) saySeed(`${at}.rules`, `The least "${field2.label}" allows (${rule.value}) is far below any real value (${lo}); write the real floor.`);
+            if (rule.kind === "min" && bound < 0 && lo >= 0) saySeed(`${at}.rules`, `"${field2.label}" allows negative values, and no real one is negative; the floor is 0 or above.`);
           }
         }
       }
@@ -4192,10 +4206,21 @@ function validateTemplate(raw, options = {}) {
           }
         } else if (!extra.prompt?.trim()) say(`${at}.prompt`, "An agent action says what the record chat opens with.");
         break;
-      case "automation":
-        if (needTable(extra.when.table, "when.table") && extra.when.field && !fieldOf(extra.when.table, extra.when.field)) say(`${at}.when.field`, `"${extra.when.table}" does not declare a field "${extra.when.field}".`);
+      case "automation": {
+        const ev = extra.when?.event;
+        if (needTable(extra.when?.table, "when.table") && extra.when.field && !fieldOf(extra.when.table, extra.when.field)) say(`${at}.when.field`, `"${extra.when.table}" does not declare a field "${extra.when.field}".`);
+        if (!AUTOMATION_EVENTS.includes(ev)) say(`${at}.when.event`, `An automation runs on ${AUTOMATION_EVENTS.join(", ")}; for "${ev}" use a notification.`);
+        if (ev === "due" || ev === "overdue") {
+          const f = extra.when.field ? fieldOf(extra.when.table, extra.when.field) : void 0;
+          if (!extra.when.field) say(`${at}.when.field`, "A date reminder names the date field it waits for.");
+          else if (f && f.parityType !== "datetime") say(`${at}.when.field`, `"${extra.when.field}" is not a date or datetime field, so nothing arrives to remind about.`);
+          const d = extra.when.daysBefore;
+          if (d != null && (!Number.isInteger(d) || d < 0 || d > 365)) say(`${at}.when.daysBefore`, "Say how many whole days before the date, 0 to 365.");
+        }
+        if (extra.at != null && !/^([01][0-9]|2[0-3]):[0-5][0-9]$/.test(extra.at)) say(`${at}.at`, "Say the time of day as HH:MM on a 24-hour clock, like 09:00.");
         if (!extra.then?.trim()) say(`${at}.then`, "Say what happens, in the business's words.");
         break;
+      }
       default:
         say(at, `"${extra.kind}" is not an extra a template can carry.`);
     }
@@ -5876,7 +5901,8 @@ var TEMPLATE_PLAN_DOORS = [
   "rule_declare",
   "checklist_declare",
   "portal_declare",
-  "query_table_homes"
+  "query_table_homes",
+  "automation_declare"
 ];
 var ROW_BATCH = 10;
 var DERIVED = /* @__PURE__ */ new Set(["lookup", "rollup"]);
@@ -6056,6 +6082,8 @@ function compileInstallPlan(written) {
   }
   const needIds = /* @__PURE__ */ new Set([
     ...spec.extras.filter((e) => e.kind === "document" || e.kind === "row_action").map((e) => e.table),
+    // A date reminder names its date Field by id.
+    ...spec.extras.filter((e) => e.kind === "automation" && e.when.field).map((e) => e.when.table),
     ...spec.views.filter((v) => v.anyOf && Object.keys(v.anyOf).length).map((v) => v.table)
   ]);
   const fieldRefs = (token) => {
@@ -6221,7 +6249,13 @@ function compileInstallPlan(written) {
         });
         break;
       case "automation":
-        throw new Error(automationHeld(e));
+        steps.push({
+          label: `automations.${e.token}`,
+          door: "automation_declare",
+          args: { p_organization_id: "${org}", p_table_id: tableRef(e.when.table), p_spec: automationSpec(e, fieldRefs(e.when.table)), p_automation_id: null },
+          save: { [`automations.${e.token}`]: ["automation_id"] }
+        });
+        break;
       default:
         throw new Error(`The install plan has no door for a ${e.kind} yet ("${e.token ?? "?"}"), so this template cannot be declared until it does.`);
     }
@@ -7382,6 +7416,36 @@ function switchJob(spec, fixes) {
   fixes.push(`job: ${spec.job} switched to ${to} (linked tables, no realism declarations)`);
   spec.job = to;
 }
+var ABSOLUTE_SEED = /^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:?\d{2})?)?$/;
+function fixSeedDates(spec, ctx, fixes) {
+  const today = ctx.today && /^\d{4}-\d{2}-\d{2}$/.test(ctx.today) ? ctx.today : (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const t0 = Date.UTC(+today.slice(0, 4), +today.slice(5, 7) - 1, +today.slice(8, 10));
+  for (const t of spec.tables) {
+    const dates = t.fields.filter((f) => f.parityType === "datetime" && !f.absoluteDates);
+    if (!dates.length || !t.rows?.length) continue;
+    let rewritten = 0;
+    for (const f of dates) {
+      let timed = false;
+      for (const r of t.rows) {
+        const v = r.values?.[f.key];
+        if (typeof v !== "string") continue;
+        const m = ABSOLUTE_SEED.exec(v.trim());
+        if (m) {
+          const days = Math.round((Date.UTC(+m[1], +m[2] - 1, +m[3]) - t0) / 864e5);
+          if (Math.abs(days) > 9999) continue;
+          r.values[f.key] = `@today${days === 0 ? "" : days > 0 ? `+${days}d` : `${days}d`}${m[4] ? ` ${m[4]}:${m[5]}` : ""}`;
+          rewritten++;
+        }
+        if (/ \d{2}:\d{2}$|T\d{2}:\d{2}/.test(String(r.values[f.key]))) timed = true;
+      }
+      if (timed && f.format !== "datetime") {
+        f.format = "datetime";
+        fixes.push(`tables.${t.token}.${f.key}: holds a time of day, so it is a date-and-time column`);
+      }
+    }
+    if (rewritten) fixes.push(`tables.${t.token}.rows: ${rewritten} example date(s) written relative to today`);
+  }
+}
 function autofixDescribeSpec(input, ctx = {}) {
   const spec = describeSpec(clone2(input));
   const autoFixes = [];
@@ -7404,14 +7468,51 @@ function autofixDescribeSpec(input, ctx = {}) {
   fixRelationships(spec, ctx, autoFixes);
   askRequired(spec, autoFixes);
   switchJob(spec, autoFixes);
+  fixSeedDates(spec, ctx, autoFixes);
   return { spec, autoFixes };
 }
+var ROW_AT = /^tables(?:\[\d+\])? \((\w+)\)\.rows/;
+function rowProblemTables(spec, problems) {
+  const out = /* @__PURE__ */ new Set();
+  for (const p of problems) {
+    const m = ROW_AT.exec(p.at);
+    if (m) out.add(m[1]);
+    else if (/^placeholder data "([^"]+)"/.test(p.says)) {
+      const value = /^placeholder data "([^"]+)"/.exec(p.says)[1];
+      for (const t of spec.tables) if (t.rows?.some((r) => JSON.stringify(r.values ?? {}).includes(value))) out.add(t.token);
+    }
+  }
+  return out;
+}
 function describeCheck(spec, ctx = {}) {
   const fixed = autofixDescribeSpec(spec, ctx);
   const v = validateTemplate(fixed.spec, { profile: "describe" });
   const sameFields = (t) => (ctx.existingTables ?? []).some((e) => e.fields.map((f) => f.key).sort().join("|") === t.fields.map((f) => f.key).sort().join("|"));
   const reused = new Set(fixed.spec.tables.filter(sameFields).map((t) => t.token));
-  const problems = v.problems.filter((p) => !(/^This table copies the shared /.test(p.says) && reused.has(/\((\w+)\)/.exec(p.at)?.[1] ?? "")));
+  const notReused = (ps) => ps.filter((p) => !(/^This table copies the shared /.test(p.says) && reused.has(/\((\w+)\)/.exec(p.at)?.[1] ?? "")));
+  let problems = notReused(v.problems);
+  for (let round = 0; round < 3; round++) {
+    const bad = rowProblemTables(fixed.spec, problems);
+    if (!bad.size) break;
+    let grew = true;
+    while (grew) {
+      grew = false;
+      for (const t of fixed.spec.tables) {
+        if (bad.has(t.token) || !t.rows?.length) continue;
+        if (t.fields.some((f) => f.relationTarget && bad.has(f.relationTarget) && t.rows.some((r) => r.values?.[f.key] != null))) {
+          bad.add(t.token);
+          grew = true;
+        }
+      }
+    }
+    for (const t of fixed.spec.tables) {
+      if (!bad.has(t.token) || !t.rows?.length) continue;
+      const why = problems.find((p) => ROW_AT.exec(p.at)?.[1] === t.token)?.says ?? "they did not pass the check";
+      fixed.autoFixes.push(`tables.${t.token}.rows: example rows left out (${why.slice(0, 120)})`);
+      t.rows = [];
+    }
+    problems = notReused(validateTemplate(fixed.spec, { profile: "describe" }).problems);
+  }
   return { ...fixed, problems: problems.map((p) => ({ at: p.at, says: p.says })) };
 }
 
@@ -7640,6 +7741,10 @@ var FORMULA_SHAPE_FACTS = {
   rule: "a formula names every field by its LABEL in braces ({Quantity}), never by key; operators are + - * / % only (no >, <, = or comparisons), functions are IF, ROUND, SUM, DATEDIFF and the other store functions; it never reads a lookup or rollup, nor itself.",
   example: { key: "line_total", label: "Line total", parityType: "formula", formula: "{Quantity} * {Unit price}" }
 };
+var AUTOMATION_SHAPE_FACTS = {
+  rule: `an automation extra is {kind:"automation", token, name, when:{table, event, field?, daysBefore?}, then, message?, at?}. event is one of: due (a date field is coming up \u2014 field = the key of a datetime field of that table, daysBefore = whole days ahead 0 to 365), overdue (the day after that date field), created (every new row). then says what happens in the business's words; message is the reminder text the person reads (no merge fields); at is the time of day HH:MM (default 09:00). It always tells the person who set it up. Add one only when the sentence asks for a reminder, a heads-up or a follow-up nudge.`,
+  example: { kind: "automation", token: "remind_before_post", name: "Reminder 2 days before a post", when: { table: "post", event: "due", field: "publish_at", daysBefore: 2 }, then: "remind me two days before a post goes out", message: "A post goes out in 2 days \u2014 check the copy and image.", at: "09:00" }
+};
 var RELATIONSHIP_SHAPE_FACTS = {
   rule: "a relationship's inverseKey is the name the OTHER table sees this link under; it must not be a key that table already has as a field. A parent that lists its children owns ONE multi relation field (multi true); the child's single link to the parent is a second field, and their inverseKeys differ from every field key.",
   example: { fromTable: "request", fromField: "client", toTable: "client", flavor: "referenced", cardinality: "one", onDelete: "restrict", inverseKey: "requests_from" }
@@ -7663,7 +7768,7 @@ function describeVocabulary() {
     template_view_kinds: TEMPLATE_VIEW_KINDS,
     template_audiences: TEMPLATE_AUDIENCES,
     form_audiences: ["public", "member", "staff"],
-    extra_kinds_for_describe: ["booking"],
+    extra_kinds_for_describe: ["booking", "automation"],
     booking_window: { weekday: "0 = Sunday \u2026 6 = Saturday", from: "HH:MM", to: "HH:MM later than from" },
     booking_availability: BOOKING_AVAILABILITY_FACTS,
     view_shape: VIEW_SHAPE_FACTS,
@@ -7673,6 +7778,7 @@ function describeVocabulary() {
     field_shape: FIELD_SHAPE_FACTS,
     formula_shape: FORMULA_SHAPE_FACTS,
     relationship_shape: RELATIONSHIP_SHAPE_FACTS,
+    automation_shape: AUTOMATION_SHAPE_FACTS,
     phone_rule: "seed phone numbers are fictional: 555-0100 to 555-0199 (e.g. (813) 555-0142); never a real-looking number, and never a number from a country the person did not name.",
     team_rule: "the team (name, role, work email, mobile, start date) is the shared team_member block; do not declare a table with those fields \u2014 keep a table of your own to just name and role, or point a relation field at team_member.",
     title_field: "a table's titleField is the key of a plain text-like field of that same table (a name, a title) \u2014 never a link to another table, a formula or a timed date"
@@ -7792,6 +7898,7 @@ function parseDescribeTemplate(template) {
   return out;
 }
 export {
+  AUTOMATION_EVENTS,
   BAD_OUTCOME,
   BOOKING_AVAILABILITY_FACTS,
   CAPABILITY_WORDS,
@@ -7842,6 +7949,7 @@ export {
   attachmentProblems,
   autofixDescribeSpec,
   automationHeld,
+  automationSpec,
   blockTable,
   bookingArgs,
   bookingColumnsProblem,