浅念
8f42c838c1
Plan 4 Task 2：build_jobs 生命周期（queued→snapshotting→validating(空)→succeeded） + build_input_snapshots 行（三哈希/主题/config 引用/真实版本列）+ 六文件物化 （site/content/taxonomies/routes/assets/render-manifest——canonicalJson 确定性落盘）。 - render-snapshot.ts：纯物化（db 只读）——published 修订（ADR-010 冻结语义）+ 路由/媒体 ready 集合 → 六文件；bodyHtml URL 重写（剥 host 按 path 与 ready 集合 public_path/source_url 双源比对，命中根相对化、未命中保留+计数）；媒体实体路径 三候选解析（快照 storageRoot→仓库存储根→incoming 兜底） - build.service.ts：幂等键 = site+published 集合哈希+主题版本（复用不重跑）； repeatable read 单事务一致性读取+落盘+快照行；报告 artifacts/jobs/<id>/reports/ build.json 先于终态落行；解析期失败零 job 行（NOT_PUBLISHED/SITE_NOT_FOUND） - sf.ts + build:create；build.module.ts Nest 薄壳 - tests/integration/build-snapshot.test.ts：10 测试（状态机/六文件面/URL 重写/ 字节确定性/NOT_PUBLISHED/ADR-010 双修订/重写器纯函数四例） Co-Authored-By: Claude Code <noreply@anthropic.com>
SiteForge
WordPress 站点到静态站点迁移引擎：读取 WXR/Sitemap/媒体归档 → 清洗入不可变内容库 → 主题化构建为自包含静态站点（Astro），全程可审计、可复现、契约冻结。
快速开始
前置：Node.js >= 22.12、Docker、corepack。
corepack enable # 激活 pnpm（或自行安装 pnpm@10）
pnpm install # 安装依赖
pnpm db:up # 启动 PostgreSQL 16（宿主端口 5434，等 healthcheck 就绪）
pnpm db:migrate # 开发库全量迁移（apps/api/drizzle）
pnpm db:test # 一键验收：起库 + 跑全部测试（测试用临时库，开发库零写入）
pnpm sf CLI 速览（tsx 直吃 TS，无需构建）——阶段 2 探测/登记 + 阶段 3 导入：
pnpm sf wxr:probe --wxr path/to/export.xml # 只读诊断：流式解析→映射→清洗→计数报告（不入库）
pnpm sf source:register --site <key> --wxr <path> [--sitemap <path>] [--media <dir>] [--media-map <json>] # 快照登记（content-addressed、幂等）
pnpm sf import --site <key> [--snapshot <id>] [--products-path /products/] [--news-path /news/] # 导入落库（幂等 job + JSON/HTML 报告）
# 全链示例（register → import；同快照重复 import 复用既有 job 不重跑）
pnpm sf source:register --site demo --wxr storage/incoming/export.xml --media storage/incoming/media --media-map storage/incoming/media-map.json
pnpm sf import --site demo # 报告落 artifacts/import/<jobId>/reports/import.{json,html}
日常质量门（等价于 CI）：
pnpm lint && pnpm typecheck && pnpm test
说明：集成测试由 vitest globalSetup 自动创建临时库 sf_test_<ts> 并注入 DATABASE_URL_TEST，结束即 DROP——勿在 .env 手动设置该变量。
目录结构
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 等运维脚本 · sf.ts（wxr:probe / source:register / import CLI）
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~017）：
docs/adr/ - 基线证据（环境/真实 WXR/阶段 3 导入验收）：
docs/evidence/
当前状态
- 阶段 1 已完成：契约冻结、21 表数据模型全量落地（不可变触发器/唯一约束/CHECK 均落数据库并被 75 项测试锁定）、空环境一键启动+迁移验收通过。
- 阶段 2 已完成：WXR 流式适配器（saxes 流式解析 → PHP unserialize → UniversalRow 映射 → HTML 白名单清洗 → 导入前报告）、
source:register快照登记（content-addressed、幂等）与pnpm sfCLI；真实 hesupipe WXR（5.5MB）冒烟 18 项计数对照全过（峰值堆 62MiB < 100MiB，证据见docs/evidence/phase2-smoke.md）。 - 阶段 3 已完成：内容导入管道（
sf import——content/term/media/route 四家写入器串行编排、稳定身份双轨幂等、checksum skip、route_registry §6.1 全表处置、JSON+HTML 导入报告与错误封顶）；真实 hesupipe 全量导入验收通过——192 内容条目/1122 source_records/927 terms/2772 routes 落库，二导幂等（0 新修订）、published 指针全程未动（ADR-010），333 测试全绿（证据见docs/evidence/phase3-import.md）。 - 下一步：阶段 4——content:publish 命令 + Render Snapshot + pilot-minimal 主题 + Astro 构建 + 本地 Preview；输入清单见 Plan 3 文末"移交 Plan 4 清单"。