docs(plugin-grid): reflect audit-timeline preservation in the historical-import hint (#3493) (#2822)

Companion to framework #3497. The "Import as historical data" checkbox already sends treatAsHistorical (verified: ImportWizard.tsx + assembleImportRequest on both paths, pinned by importDryRun.test.ts), so the server-side preserveAudit extension is reachable with no wiring change. Only the hint copy was stale — it described just the state-machine-skip half. Update the wizard hint and the ImportRequest.treatAsHistorical type doc to also mention that original timestamps/author (and business readonly fields) are preserved. Copy-only, no behavior change.

Author: os-zhuang

.changeset/import-historical-hint.md

@@ -0,0 +1,15 @@
+---
+"@object-ui/plugin-grid": patch
+---
+
+docs(plugin-grid): the "Import as historical data" wizard hint now reflects audit-timeline preservation (#3493)
+
+`treatAsHistorical` gained a second half in framework #3493/#3497 — the import
+write context also carries `preserveAudit`, so a historical import keeps the
+original `updated_at`/`updated_by` and business `readonly` fields instead of
+stamping-now / stripping them. The checkbox hint only described the
+state-machine-skip half; it now also says the original timestamps & author are
+preserved. The `ImportRequest.treatAsHistorical` type doc (`@object-ui/types`)
+is updated to match. Copy-only — no behavior change (the checkbox already sent
+`treatAsHistorical`, so the server-side extension is reached without any wiring
+change).

packages/plugin-grid/src/ImportWizard.tsx

@@ -121,7 +121,7 @@ const IMPORT_DEFAULT_TRANSLATIONS: Record<string, string> = {
   'grid.import.optCreateOptions': 'Keep unknown option values',
   'grid.import.optRunAutomations': 'Run automations & triggers',
   'grid.import.optTreatHistorical': 'Import as historical data',
-  'grid.import.optTreatHistoricalHint': '(skip state-machine checks so already-completed records import as-is)',
+  'grid.import.optTreatHistoricalHint': '(import completed records as-is — skip state-machine checks and keep their original timestamps & author instead of stamping now)',
   'grid.import.optSkipBlankKey': 'Skip rows with a blank match value',
   'grid.import.optBackground': 'Import in the background',
   'grid.import.optBackgroundHint': '(runs as an undoable job)',

packages/types/src/data.ts

@@ -819,9 +819,11 @@ export interface ImportRequestOptions {
   matchFields?: string[];
   /** Fire triggers/hooks for each imported row (off by default for bulk). */
   runAutomations?: boolean;
-  /** Import as established historical facts: skip the `state_machine` rule so
+  /** Import as established historical facts. Skips the `state_machine` rule so
    *  mid-lifecycle rows (already-closed tickets, closed_won deals) aren't rejected
-   *  by `initialStates` (framework #3479). @default false */
+   *  by `initialStates` (framework #3479), AND preserves the original audit timeline:
+   *  a supplied `updated_at`/`updated_by` and business `readonly` fields are kept
+   *  instead of stamped-now / stripped (framework #3493). @default false */
   treatAsHistorical?: boolean;
   /** Trim leading/trailing whitespace from string cells. @default true */
   trimWhitespace?: boolean;