docs: 阶段2收尾——ADR-016/typecheck链/阶段3移交清单/README

- ADR-016：saxes ^6.0.0（勘误：计划曾误写 ^0.9）/commander ^14 根依赖/清洗三件套
  同 range + 镜像直调 launder.naughtyHref/tsx ^4 CLI 直吃 TS；跨包接线（根 tsconfig
  paths 三方消费、build 侧 dist+prebuild、tsconfig 双链型并存）；根 engines 升
  >=22.12（对齐 sanitize-html 2.18 engines，CI node 22 与本机 24 均满足）
- 根 typecheck 链扩为四段：追加 pnpm --filter @sf/adapter-wp typecheck
- Plan 2 文末新增"移交阶段 3 清单"定稿（7 项：taxonomyRefs 自建缺失 term、
  media_bundle 映射、connection 库级唯一索引、REST 重审项、导入消费接口、
  Task 0.2 cms 备份续传携带、versions.ts bump 纪律）；Task 9 与验收节勾选
- README：快速开始加 pnpm sf 示例；目录结构/文档导航/当前状态更新为阶段 2 完成
- 三绿：lint / typecheck（四段）/ test 263 全部通过（数量不变）

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

README.md

@@ -4,7 +4,7 @@ WordPress 站点到静态站点迁移引擎：读取 WXR/Sitemap/媒体归档
 
 ## 快速开始
 
-前置：Node.js >= 22、Docker、[corepack](https://nodejs.org/api/corepack.html)。
+前置：Node.js >= 22.12、Docker、[corepack](https://nodejs.org/api/corepack.html)。
 
 ```bash
 corepack enable                      # 激活 pnpm（或自行安装 pnpm@10）
@@ -14,6 +14,13 @@ pnpm db:migrate                      # 开发库全量迁移（apps/api/drizzle
 pnpm db:test                         # 一键验收：起库 + 跑全部测试（测试用临时库，开发库零写入）
 ```
 
+WXR 适配器（阶段 2）速览——`pnpm sf` CLI（tsx 直吃 TS，无需构建）：
+
+```bash
+pnpm sf wxr:probe --wxr path/to/export.xml   # 只读诊断：流式解析→映射→清洗→计数报告（不入库）
+pnpm sf source:register --site <key> --wxr <path> [--sitemap <path>] [--media <dir>]   # 快照登记（content-addressed、幂等）
+```
+
 日常质量门（等价于 CI）：
 
 ```bash
@@ -25,11 +32,12 @@ pnpm lint && pnpm typecheck && pnpm test
 ## 目录结构
 
 ```
-apps/api/            NestJS standalone 骨架 + Drizzle schema/迁移（21 表，数据库约束即规格）
+apps/api/            NestJS standalone 骨架 + Drizzle schema/迁移（21 表，数据库约束即规格）+ source 快照登记
 packages/contracts/  UniversalRow / Route / Render / Theme 跨源契约（冻结，变更须升版）
+packages/adapter-wordpress/  WXR 适配器（saxes 流式解析 + PHP unserialize + 映射 + HTML 白名单清洗，纯函数无 DB）
 tests/               单元 + 集成测试（fixtures：WXR/Sitemap/媒体样例）
 infra/               docker-compose：PostgreSQL 16（端口 5434，避开 cms 项目 5433）
-scripts/             migrate-test.sh 等运维脚本
+scripts/             migrate-test.sh 等运维脚本 · sf.ts（source:register / wxr:probe CLI）
 docs/                adr/ 决策记录 · evidence/ 基线证据 · superpowers/ 规格与计划
 ```
 
@@ -37,10 +45,11 @@ docs/                adr/ 决策记录 · evidence/ 基线证据 · superpowers/
 
 - 设计基线（表结构/技术决策/阶段划分）：`docs/superpowers/specs/2026-10-20-siteforge-vertical-slice-design-v2.md`
 - 阶段 0+1 实施计划：`docs/superpowers/plans/2026-10-20-slice-foundation-phase0-1.md`
-- 架构决策记录（ADR-001~015）：`docs/adr/`
+- 架构决策记录（ADR-001~016）：`docs/adr/`
 - 基线证据（环境/真实 WXR）：`docs/evidence/`
 
 ## 当前状态
 
 - **阶段 1 已完成**：契约冻结、21 表数据模型全量落地（不可变触发器/唯一约束/CHECK 均落数据库并被 75 项测试锁定）、空环境一键启动+迁移验收通过。
-- **下一步：阶段 2**——WXR 适配器（流式 SAX 解析 → UniversalRow），计划基于阶段 1 经验另立。
+- **阶段 2 已完成**：WXR 流式适配器（saxes 流式解析 → PHP unserialize → UniversalRow 映射 → HTML 白名单清洗 → 导入前报告）、`source:register` 快照登记（content-addressed、幂等）与 `pnpm sf` CLI；263 测试全绿，真实 hesupipe WXR（5.5MB）冒烟 18 项计数对照全过（峰值堆 62MiB < 100MiB，证据见 `docs/evidence/phase2-smoke.md`）。
+- **下一步：阶段 3**——内容/分类/媒体入库（source_records 落库、稳定身份 upsert、checksum skip、route_registry 生成）；输入清单见 Plan 2 文末"移交阶段 3 清单"。