 浅念
|
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 |
|
|
浅念
|
8485c51d59
|
fix(import): term 边缘欠报闭合（null-id 双序等价/同 slug 双 id 报告）；handleEvent 分派形状
审查修复：
- null-id wp:term 双序等价：seen 分支同样报缺 term_id issue；自建行 name-only
收编（UPDATE name 为权威名、source_id 不动），term 先行/row 先行终态 name
与 issue 双序一致（测试钉死）；真实 id 行不覆盖（first-wins）
- 同 slug 双 term_id：镜像条件显式报告（保留先到、跳过后到 + rawLocation），
文档序 first-wins 策略 JSDoc 钉死（测试含关联绑保留行）
- 冲突重查未命中由 found[0]! 改显式 throw（taxonomy/term 两处，含键上下文）
- adoptTerm catch 注明 ctx.db 直连约定（事务内 25P02 连锁风险——Task 6 包
事务时须重估）；收编撞唯一约束路径补测试（自建行原样保留 + issue）
- 重构：内部件抽为 createTermEventHandler({handleEvent, finish}) 可分派形状
（Task 6 单消费方拉流分派、无 tee 的编排意图），createTermWriter 为自消费
整流便捷壳
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-21 16:44:25 +08:00 |
|
|
浅念
|
191c275713
|
feat(import): term 物化与缺失自建
Plan 3 Task 2：createTermWriter 管道写入器——双源物化分类域。
- wp:term 事件：taxonomies（key→object_type 映射 + public_base_path 前置事实 9
常量）+ terms（source_id=term_id 字符串）
- row 的 taxonomyRefs miss 时自建（source_id=auto:<nicename>、slug=nicename；
phase2-smoke 实证真实 WXR 的 wp:term 表缺 category/post_tag 整域）；同 nicename
多次引用只建一条（内存 (taxonomy,slug) 索引 + UNIQUE 兜底）
- 单遍流式 + 收编：WXR 文档序 items 先于 wp:term——row 先到自建、wp:term 后到
就地 UPDATE 扶正 source_id/name，两种顺序终态一致（测试钉死顺序无关性）
- content_terms：is_primary 每 (entry, taxonomy) 首个 true 余 false（WP 单主分类
近似）；row 无 content entry → term 仍物化、关联跳过 + issue（禁静默）
- ctx 加法扩展 events: AsyncIterable<AdapterEvent>（测试手构注入，Task 6 接真流）
- Task 1 遗留两行：ImportErrorCode 补 REPORT_WRITE_FAILED、ctx.db 事务边界 JSDoc
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-21 16:19:00 +08:00 |
|
|
浅念
|
eb188da5c2
|
fix(import): 复用口径忠实化；管道 Outcome 契约与 succeeded_with_issues；报告写入时序；stale 警告
评审修复（Plan 3 Task 1 复审）：
- 复用路径只返回 job 锚定字段（jobId/status/reused/siteId/mapping_version/
report_path），快照/版本块仅在非复用时解析返回——复用结果不再回显编造数据
- ImportPipeline 契约钉死：返回 Promise<ImportPipelineOutcome>
（{ counts, issues }）；服务按"累加器 ⊕ 返回值"合并（counts 同键返回值
覆盖、issues 累加器在前），issues 非空 → succeeded_with_issues；
ctx.report 即累加器（管道抛错时部分产出仍入报告）
- 报告时序：mkdir + tmp 写入 + rename 先于终态行更新——report_path 落库
即文件存在；写失败 → failed（REPORT_WRITE_FAILED），不挂悬空路径
- CLI 复用命中非终态（queued/running）→ 崩溃残留警告（重试需显式换 --key）
- 管道抛 ImportError 保留原 code 入 error_code，summary 冠 [pipeline]
- 确定性 23505 探针：未提交孪生 job 行事务内持唯一键触发真实 PG 唯一
冲突 → 败者复用既有 job
- 报告补 idempotencyKey / attempt 字段
- 计划文档 Task 6 增补 stale 回收决策项（ADR-017）
测试 282 通过（279 + 3：Outcome 合并/ImportError 前缀/23505 探针）；
typecheck 四段链 + lint 全绿。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-21 15:56:00 +08:00 |
|
|
浅念
|
0e8b2b5356
|
feat(import): job 骨架与生命周期
Plan 3 Task 1：sf import 命令骨架 + import_jobs 生命周期（空管道，Task 6 接真实管道）。
- import.service.ts（零装饰器）：createImportJob——站点/快照解析（缺省按 (connection,
kind='wxr') 选最新；三快照绑定按前置事实 13 记入报告，job 行不扩列）、幂等建行
（默认 key=site+wxr快照+三语义版本；重复提交复用既有 job 不重跑，并发撞唯一约束
重查收敛）、状态推进 queued→running→succeeded/failed（attempt/started_at/finished_at/
error_code/error_summary）、报告落 artifacts/import/<jobId>/reports/import.json
（全四版本块：adapter/mapping/sanitizer/parser；job 行落 mapping_version）
- 可预期错误带 code：SITE_NOT_FOUND / SNAPSHOT_NOT_FOUND / NO_WXR_SNAPSHOT /
PIPELINE_FAILED——解析期失败零 job 行
- adapter 事件加法式补 postId（前置事实 12）：unsupported/error 事件可选携带
String(postId)，缺失时键缺席不硬造 source_id；row 事件与报告聚合零影响、不触发版本 bump
- canonicalJson 提取至 apps/api/src/common/canonical.ts 共享导出（前置事实 6），
register 侧改 import 零行为变更（既有清单哈希测试守护）
- sf CLI + import 命令（--site/--snapshot/--key/--connection），输出 job 摘要与版本块
- 测试：tests/integration/import-job.test.ts（5 例：生命周期观察/最新快照解析/幂等复用
与并发收敛/可预期失败零落行/failed 路径）+ adapter postId 3 例 + canonical 单测 6 例
（265→279 全绿）；typecheck 四段链/lint 绿；临时库 CLI 冒烟（register→import→复用）通过
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-21 15:30:42 +08:00 |
|