cms-website

xinyouhe/cms-website

Fork 0

Commit Graph

Author	SHA1	Message	Date
浅念	8003de336b	feat(import): 全链编排与导入报告 Task 6（Plan 3）：四家写入器汇流为默认编排管道。 - import.service：注入 events/pipeline 缺席时走真实事件流（runWxrAdapter 惰性 async generator，mapConfig.locale=site.default_locale 前置事实 8）；分派严格串行 content→term→media→route（禁 Promise.all）；finish 硬序 term(sync)→content(sync)→media(await)→route(await)；counts 由 ⊕ 覆盖改为逐 key 求和聚合；新增 stale 回收（同站点 queued/running >24h 一条 SQL 置 stale）；报告新增 paths/productsPath+newsPath、issueGroups 六组、 sanitize 清洗统计（事件流 changedRows/byDiffType 聚合）、adapterTiming。 - content-writer：NULL-entry 收编（快照行在而 content_entry 空，五列先验三分支：无先验新建挂接/同 checksum 挂接 skipped/异 checksum 挂接新版本）。 - route-writer：attachment 降级汇总按去重 sourceId 计（重跑仍必现）； normalizeListPath 导出；writeAttachmentRoute 返回 written/resolved/blocked。 - 四家写入器 identity 收敛共享基类型 WriterContext = Pick<ImportJobContext,'db'\|'siteId'\|'connectionId'>（type-only import，无运行时环依赖）。 - CLI import 增 --products-path/--news-path（前置事实 9，缺省 /products/ /news/）记入 job 报告。 - 测试：tests/integration/import-full.test.ts 6 例（全链 zh-CN 接线证明 +published 全 NULL/报告四域计数+sanitize+分组/幂等重跑零写语义/ 无 media 快照域缺失不失败/NULL-entry 收编/stale 回收/REPORT_WRITE_FAILED 遗留补测）；import-job 契约测试钉死 counts 求和（100⊕3=103）。全量 323 通过；typecheck/lint 干净。 Co-Authored-By: Claude Code <noreply@anthropic.com>	2026-10-21 20:08:06 +08:00
浅念	fe72df3afa	chore(import): unsupported/failed 分项计数与键契约 JSDoc；NULL-entry 缝注释；lineage 语义注记审查 cheap riders 四项：handleUnmappable 分项 unsupportedRecords/ failedRecords（按事件计——拆分只在分派点可知，Task 6 无从重derive，测试对拍两键）；ImportPipelineOutcome.counts 键契约注记（跨写入器扁平全局命名空间、同名 CLOBBER 不求和、各键归属声明、Task 4 勿复用 'skipped'）；六列 NULL-entry 已知死角缝注释（23505 → Task 6 收编）；态 1 checksum-diff 的 import_job_id lineage 语义注记（source_records 留建行 job、新 job 记 content_revisions）。296 全绿；typecheck/lint 通过。 Co-Authored-By: Claude Code <noreply@anthropic.com>	2026-10-21 18:19:37 +08:00
浅念	2b61431da8	feat(import): 内容稳定身份写入 Plan 3 Task 3：content-writer（row→entry/locale/revision/source_record， checksum skip 幂等三态）。checksum 按前置事实 6 公式精确实现（canonicalJson 六输入域 + sha256；rawLocation 排除、版本三常量入、status 入、sourceUrl 经 route_source_values 入）；六列快照行身份 + 五列内容身份（跨快照复用 entry， permalink 变化产新修订不建新 entry）；attachment/unsupported/error 只记 source_records（前置事实 11/12，error 无 postId 以 rawLocation 回退不硬造）；导入全程不触 published 指针（ADR-010）。term-writer JSDoc 补 null-id 建行不计入 autoCreatedTerms 注脚（Task 2 遗留）。测试：tests/integration/import-content.test.ts 7 用例（mini 全链对拍/同快照 skip/跨快照稳定身份/内容变化/ permalink 变化/unsupported+error/locale 校验）， 296 全绿；typecheck 四段链/lint 通过。 Co-Authored-By: Claude Code <noreply@anthropic.com>	2026-10-21 17:09:06 +08:00

Author

SHA1

Message

Date

浅念

8003de336b

feat(import): 全链编排与导入报告

Task 6（Plan 3）：四家写入器汇流为默认编排管道。

- import.service：注入 events/pipeline 缺席时走真实事件流（runWxrAdapter
  惰性 async generator，mapConfig.locale=site.default_locale 前置事实 8）；
  分派严格串行 content→term→media→route（禁 Promise.all）；finish 硬序
  term(sync)→content(sync)→media(await)→route(await)；counts 由 ⊕ 覆盖
  改为逐 key 求和聚合；新增 stale 回收（同站点 queued/running >24h 一条
  SQL 置 stale）；报告新增 paths/productsPath+newsPath、issueGroups 六组、
  sanitize 清洗统计（事件流 changedRows/byDiffType 聚合）、adapterTiming。
- content-writer：NULL-entry 收编（快照行在而 content_entry 空，五列先验
  三分支：无先验新建挂接/同 checksum 挂接 skipped/异 checksum 挂接新版本）。
- route-writer：attachment 降级汇总按去重 sourceId 计（重跑仍必现）；
  normalizeListPath 导出；writeAttachmentRoute 返回 written/resolved/blocked。
- 四家写入器 identity 收敛共享基类型 WriterContext =
  Pick<ImportJobContext,'db'|'siteId'|'connectionId'>（type-only import，
  无运行时环依赖）。
- CLI import 增 --products-path/--news-path（前置事实 9，缺省 /products/
  /news/）记入 job 报告。
- 测试：tests/integration/import-full.test.ts 6 例（全链 zh-CN 接线证明
  +published 全 NULL/报告四域计数+sanitize+分组/幂等重跑零写语义/
  无 media 快照域缺失不失败/NULL-entry 收编/stale 回收/REPORT_WRITE_FAILED
  遗留补测）；import-job 契约测试钉死 counts 求和（100⊕3=103）。
  全量 323 通过；typecheck/lint 干净。

Co-Authored-By: Claude Code <noreply@anthropic.com>

2026-10-21 20:08:06 +08:00

浅念

fe72df3afa

chore(import): unsupported/failed 分项计数与键契约 JSDoc；NULL-entry 缝注释；lineage 语义注记

审查 cheap riders 四项：handleUnmappable 分项 unsupportedRecords/
failedRecords（按事件计——拆分只在分派点可知，Task 6 无从重derive，测试
对拍两键）；ImportPipelineOutcome.counts 键契约注记（跨写入器扁平全局
命名空间、同名 CLOBBER 不求和、各键归属声明、Task 4 勿复用 'skipped'）；
六列 NULL-entry 已知死角缝注释（23505 → Task 6 收编）；态 1 checksum-diff
的 import_job_id lineage 语义注记（source_records 留建行 job、新 job 记
content_revisions）。296 全绿；typecheck/lint 通过。

Co-Authored-By: Claude Code <noreply@anthropic.com>

2026-10-21 18:19:37 +08:00

浅念

2b61431da8

feat(import): 内容稳定身份写入

Plan 3 Task 3：content-writer（row→entry/locale/revision/source_record，
checksum skip 幂等三态）。checksum 按前置事实 6 公式精确实现（canonicalJson
六输入域 + sha256；rawLocation 排除、版本三常量入、status 入、sourceUrl 经
route_source_values 入）；六列快照行身份 + 五列内容身份（跨快照复用 entry，
permalink 变化产新修订不建新 entry）；attachment/unsupported/error 只记
source_records（前置事实 11/12，error 无 postId 以 rawLocation 回退不硬造）；
导入全程不触 published 指针（ADR-010）。term-writer JSDoc 补 null-id 建行
不计入 autoCreatedTerms 注脚（Task 2 遗留）。

测试：tests/integration/import-content.test.ts 7 用例（mini 全链对拍/同快照
skip/跨快照稳定身份/内容变化/ permalink 变化/unsupported+error/locale 校验），
296 全绿；typecheck 四段链/lint 通过。

Co-Authored-By: Claude Code <noreply@anthropic.com>

2026-10-21 17:09:06 +08:00

3 Commits