fix(rest): undo of a historical import preserves the audit timeline (#3549)

[os-zhuang]

背景 / 问题

关闭 #3549。

treatAsHistorical（历史数据导入）在 #3493/#3497 中获得了「另一半」能力：导入的写上下文携带 preserveAudit，因此会保留原始 updated_at/updated_by 以及业务 readonly 字段（closed_at、resolved_by 等），而不是「盖上当前时间 / 剥离」。

但撤销（undo）路径被遗漏了。撤销一个已完成的导入作业时（POST /data/import/jobs/:jobId/undo），它会用捕获的导入前快照 u.before 还原被更新的行——却使用了一个普通写上下文：

const writeCtx = { ...(context ?? {}), skipAutomations: true, skipStateMachine: true };

于是审计自动戳（audit auto-stamp）会把 updated_at/updated_by 重写为「现在」，悄悄破坏了历史导入刻意保留的那条审计时间线。换句话说：导入保留了原始时间戳，撤销却把它抹掉了——撤销本应是「还原」，结果反而改写了事实。

改动

撤销的写上下文现在镜像导入自身的写上下文：当作业行标记了 treat_as_historical 时，携带 preserveAudit，从而把快照里的审计/时间戳值（以及任何业务 readonly 字段）原样写回。

const writeCtx = {
    ...(context ?? {}),
    skipAutomations: true,
    skipStateMachine: true,
    ...(row.treat_as_historical ? { preserveAudit: true } : {}),
};

• row.treat_as_historical 已经持久化在导入作业行上（rest-server.ts 创建作业时写入 treat_as_historical: prepared.treatAsHistorical），因此撤销时无需额外查询即可判定。
• 普通导入的撤销行为完全不变（默认 stamp/strip）——preserveAudit 仅在历史导入时按条件加入。
• 条件式合并对齐了 import-runner.ts 里导入自身写上下文的写法（treatAsHistorical ? { skipStateMachine: true, preserveAudit: true } : {}）。

为什么这是「保留」而非「特权」

• captureBefore 只快照导入负载里出现过的键，所以撤销写回的就是导入前的确切值；带上 preserveAudit 只是让这些值被原样写回，而不是被审计钩子覆盖。
• 审计溯源不受影响：撤销本身仍会记录（sys_audit_log + 作业行上的 reverted_at），所以「谁在何时撤销」这条事实依然可查——被保留的只是被还原行的业务时间线。

测试

packages/rest/src/import-job-integration.test.ts 新增两条回归测试（真实 ObjectQL 引擎 + 内存驱动 + RestServer，全链路走真实的 create-job / worker / undo 路由）：

1. 历史导入的撤销：断言还原写（updateData）的上下文携带 preserveAudit: true。
2. 普通导入的撤销：断言还原写的上下文不含 preserveAudit（默认 stamp/strip）。

为让 treat_as_historical 标志在作业行上往返，测试的 sys_import_job 镜像补充了该字段。

Test Files  3 passed (3)   # import-integration + import-runner-historical + import-job-integration
     Tests  42 passed (42)

（import-job-integration.test.ts 单独运行：13 passed，含 2 条新增。）

影响面

• 仅改动撤销路由的写上下文构造 + 测试；无接口/schema 变更。
• Changeset：@objectstack/rest patch（行为修复）。

---

🤖 Generated with Claude Code

https://claude.ai/code/session_01B5rdfBKjkbcoEif4KUV6xE

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectstack	Ignored		Jul 27, 2026 4:30am

[github-actions]

📓 Docs Drift Check

This PR changes 1 package(s): @objectstack/rest.

8 hand-written doc(s) reference the affected code and may need an implementation-accuracy re-verification:

• content/docs/api/error-catalog.mdx (via @objectstack/rest)
• content/docs/api/error-handling-server.mdx (via @objectstack/rest)
• content/docs/api/index.mdx (via @objectstack/rest)
• content/docs/plugins/index.mdx (via @objectstack/rest)
• content/docs/plugins/packages.mdx (via @objectstack/rest)
• content/docs/protocol/kernel/i18n-standard.mdx (via packages/rest)
• content/docs/releases/implementation-status.mdx (via @objectstack/rest)
• content/docs/releases/v12.mdx (via @objectstack/rest)

Advisory only. To re-verify, run the docs-accuracy-audit workflow scoped to these files:
node scripts/docs-audit/affected-docs.mjs origin/main → pass the list as args.docs.