feat(build): astro 构建管线与媒体落盘

Plan 4 Task 5：build.service snapshotting 后接真实构建——building 态进
pipeline.ts（spawn `pnpm --filter @sf/theme-pilot-minimal exec astro build`
（SF_BUILD_INPUT env；非零退出+stderr 标记判据）→ dist 定位与 target_file
完整性 → 媒体 copyPath→dist/public_path（sha256 全量校验）→ sitemap.xml/
robots.txt（编码 URL 原样）→ route-manifest.json（§12.1 字段面、哈希链复用）
→ build_artifacts dist/manifest 登记）→ validating(空,Task 6) → 报告+report
行 → succeeded；失败任何一步 failed+error_code/error_summary（stderr 摘要）
+input/dist 清残。

dist 双位置纪律：主题包 dist 是暂存，产物汇齐后拷出 <artifactsRoot>/jobs/
<jobId>/dist（job 级权威），暂存随即清空。无网证明：ASTRO_TELEMETRY_DISABLED=1
（实测 @astrojs/telemetry 构建期真调 fetch）+ NODE_OPTIONS 透传（测试注入
fetch/net stub 构建仍成功）。主题集成补面：ProductList 模板 + /products/
主列表分派特判（DB 物化形状 targetContentId=null，Task 4 夹具曾被占位绕过）。

测试：tests/integration/build-pipeline.test.ts 五用例（全链/夹具直跑/五禁
断言/失败路径）；build-snapshot 状态机补 building + 清场补 build_artifacts。
root 359 + theme 26 全绿。

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

tests/integration/build-snapshot.test.ts

@@ -1,7 +1,7 @@
 // Plan 4 Task 2 失败测试（先于实现）：Render Snapshot 物化 + build job（ADR-011、V2 spec §9）。
 // 覆盖契约（对照计划 Task 2）：
-// 1. build job 状态机：queued→snapshotting→validating（空，Task 6 填）→succeeded（dist 尚空
-//    ——Task 5 接真实构建时新建 job 不改行，build_input_snapshots 有不可变触发器）+
+// 1. build job 状态机：queued→snapshotting→building（Task 5 真实构建）→validating
+//    （空，Task 6 填）→succeeded +
 //    build_input_snapshots 行（content/route/asset 三哈希 = 各自**文件字节**（canonicalJson+
 //    尾换行）的 sha256——哈希链与落盘文件互证、site_config_revision_id 指向 config v1、
 //    theme_key='pilot-minimal'、node_version 等版本信息列真实读 process.versions）+
@@ -71,8 +71,10 @@ async function countOf(db: Db, sql: string): Promise<number> {
   return Number(rows[0].n)
 }
 
-/** 本文件写入的行清场：构建域（不可变快照先行）+ 发布/导入/来源全链反序 */
+/** 本文件写入的行清场：构建域（build_artifacts 先于 build_jobs——FK；不可变快照先行）+ 发布/导入/来源全链反序 */
 async function cleanupSiteRows(db: Db, siteId: string): Promise<void> {
+  await db.execute(`delete from build_artifacts where build_job_id in
+    (select id from build_jobs where site_id = '${siteId}')`)
   await withImmutableCleanup(db, 'build_input_snapshots', 'build_input_snapshots_immutable', `site_id = '${siteId}'`)
   await db.execute(`delete from build_jobs where site_id = '${siteId}'`)
   await withImmutableCleanup(db, 'audit_logs', 'audit_logs_immutable', `site_id = '${siteId}'`)
@@ -158,8 +160,9 @@ describe('build job + Render Snapshot 物化', () => {
           })
           expect(result.reused).toBe(false)
           expect(result.status).toBe('succeeded')
-          // 状态机序列（validating 空：Task 6 填真实门禁）
-          expect(statuses).toStrictEqual(['queued', 'snapshotting', 'validating', 'succeeded'])
+          // 状态机序列（Task 5 起 snapshotting 后进 building：真实 astro 构建管线；
+          // validating 空：Task 6 填真实门禁）
+          expect(statuses).toStrictEqual(['queued', 'snapshotting', 'building', 'validating', 'succeeded'])
 
           // build_jobs 行：终态 + attempt/时间戳/error 空（epoch 投影——时间戳非空身份断言；
           // raw execute 的 timestamptz 回串不做 Date 形状断言）