浅念
c28c1655a4
评审修复（4 项 Important + 8 项 Minor）： - DB 事务化：site→connection→snapshots 全部落库包进 db.transaction 单事务 （"任何失败零落库"字面成立）；助手改收 Pick<select|insert|execute> 结构类型 （tx 与直连 db 通用）。并发撞唯一约束不在事务内补查（语句失败后续查 25P02）， 改为 registerSource 层事务级重试（≤3 次，第二次 select 命中复用分支） - connection 并发：select-then-insert 无约束可兜底，事务内 pg_advisory_xact_lock (siteId:name) 串行化同键登记（kind 枚举扩展推迟 REST 通道，注释注明） - storageRoot 绝对路径固化进每条 snapshot metadata 与报告 inputs（快照不可变， 事后无法补写——永久缺口封堵） - ensureSite 返回 created；RegisterResult.siteCreated；CLI 站点已存在时提示 --name/--locale/--origin 未生效 - 媒体复制期逐文件 sha 复核（copyAndHash 对拍清单，源中途变更 → COPY_FAILED） - 空媒体目录拒绝（EMPTY_MEDIA_DIR） - CLI：PATH_NOT_ALLOWED 追加 --allow 提示；--origin 经 new URL 校验（http/s）、 --locale 语言标签形状校验，fail fast；开跑打印生效白名单（审计） - makeRunId 服务导出、CLI 复用；.tmp 残留手工清理策略写入文件头注释 - 测试 +2：并发同输入恰好一组行/双方同 id/新建标志恰一（3 次重跑稳定）； isUniqueViolation 形状单测（drizzle cause.code / 裸 code / 其他） 全套 263 绿；typecheck / lint 绿；CLI 冒烟对临时库验证事务路径、siteCreated 输出、defaults 落库（en-US / https://qa.example）、白名单打印与校验报错 Co-Authored-By: Claude Code <noreply@anthropic.com>
SiteForge
WordPress 站点到静态站点迁移引擎：读取 WXR/Sitemap/媒体归档 → 清洗入不可变内容库 → 主题化构建为自包含静态站点（Astro），全程可审计、可复现、契约冻结。
快速开始
前置：Node.js >= 22、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 # 一键验收：起库 + 跑全部测试（测试用临时库，开发库零写入）
日常质量门（等价于 CI）：
pnpm lint && pnpm typecheck && pnpm test
说明：集成测试由 vitest globalSetup 自动创建临时库 sf_test_<ts> 并注入 DATABASE_URL_TEST，结束即 DROP——勿在 .env 手动设置该变量。
目录结构
apps/api/ NestJS standalone 骨架 + Drizzle schema/迁移（21 表，数据库约束即规格）
packages/contracts/ UniversalRow / Route / Render / Theme 跨源契约（冻结，变更须升版）
tests/ 单元 + 集成测试（fixtures：WXR/Sitemap/媒体样例）
infra/ docker-compose：PostgreSQL 16（端口 5434，避开 cms 项目 5433）
scripts/ migrate-test.sh 等运维脚本
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/ - 基线证据（环境/真实 WXR）：
docs/evidence/
当前状态
- 阶段 1 已完成：契约冻结、21 表数据模型全量落地（不可变触发器/唯一约束/CHECK 均落数据库并被 75 项测试锁定）、空环境一键启动+迁移验收通过。
- 下一步：阶段 2——WXR 适配器（流式 SAX 解析 → UniversalRow），计划基于阶段 1 经验另立。