diff --git a/docs/BUG_HISTORY.md b/docs/BUG_HISTORY.md
index 29c2c943..ecac26c2 100644
--- a/docs/BUG_HISTORY.md
+++ b/docs/BUG_HISTORY.md
@@ -8629,4 +8629,36 @@
 - 复发自：BUG-553（`a1956deb` 的测试没断言守卫会命中）
 - 修复版本：`0102a973`
 
+## BUG-561 | 长报告 KP Lord/Sub 与专题 KP 表在失败信封下整段消失
+
+- 状态：resolved
+- 首次发现：2026-09-06
+- 最近更新：2026-09-06
+- 影响面：`scripts/jyotish_engine.py` pl9 长报告、专业参考 Markdown
+- 用户现象：三年 KP 月表还在，但 KP Lord/Sub 原始表和事业/财运/关系章的 KP 结构小表整段不见，页面上也没有 blocked 说明。
+- 触发条件：专业参考路径把 `cmd_kp` 收成 `{status: blocked, reason}` 且没有 planets/houses；渲染层遇到该信封直接返回空列表。鉴别条件是候选窗/blocked KP 信封，不是 Raman 本身。
+- 根因：`_kp_lord_sub_section` 等装配函数在 KP 模块失败时 `return []`，计划段被静默跳过。
+- 修复：失败路径改为输出显式 blocked 标题和原因码；最终 Markdown 再扫一遍计划标题，缺席则补 `planned_section_unavailable`。
+- 验证：`tests/test_report_longform_gaps2.py`。
+- 防复发：计划内段必须 present 或 blocked，不允许缺席。禁止再对失败 KP 信封直接 `return []`。
+- 相关记录：无
+- 复发自：无
+- 修复版本：待本单合入 SHA
+
+## BUG-562 | 专业参考路径剥掉 raw_full_reading 后模块审计表只剩表头
+
+- 状态：resolved
+- 首次发现：2026-09-06
+- 最近更新：2026-09-06
+- 影响面：`scripts/jyotish_engine.py` 长报告审计表、力量章 Yogini/Narayana/Kala/Bhava Bala
+- 用户现象：逐模块执行审计只有表头、零数据行。力量章缺 Bhava Bala 与三套辅助大运明细。
+- 触发条件：professional 路径 sanitize 掉 `raw_full_reading`；worksheet 只抄了 dasha 家族状态、没有 periods。
+- 根因：审计行只从将被剥离的 raw 模块读；辅助大运渲染拿不到规范化 periods。
+- 修复：sanitize 前抽出 `_iter_audit_modules`；规范化 dasha family periods，并从本地 yogini/narayana/kala/bhava_bala 模块补装，缺数据走 blocked 行。
+- 验证：`tests/test_report_longform_gaps2.py`。
+- 防复发：full pack 下审计表数据行必须达到模块执行数下限；力量章六子块缺数据必须有 blocked 标题。
+- 相关记录：BUG-561
+- 复发自：无
+- 修复版本：待本单合入 SHA
+
 
diff --git a/docs/tasks/PROGRESS-report-longform-gaps2-20260906.md b/docs/tasks/PROGRESS-report-longform-gaps2-20260906.md
new file mode 100644
index 00000000..9693231f
--- /dev/null
+++ b/docs/tasks/PROGRESS-report-longform-gaps2-20260906.md
@@ -0,0 +1,33 @@
+# PROGRESS · 长报告对齐二轮 gaps2（2026-09-06）
+
+工作树：`.worktrees/report-md-page-20260906`（与 MD 详情页串行）
+分支：`codex/report-md-page-20260906`
+任务书：`TASK-report-longform-gaps2-20260906.md`
+
+## 任务 0 根因
+
+专业参考路径可以把 `cmd_kp` 收成 `{status: blocked, reason: ...}` 且没有 `planets` / `houses`。渲染层 `_kp_lord_sub_section` 与专题 KP 表遇到该信封曾直接 `return []`，计划段无声消失。三年 KP 月表不走同一信封，所以仍在。
+
+触发变量是 **API 候选窗 / blocked KP 信封**，不是 Raman 本身。同构虚构盘（候选窗 + raman + full pack）在单元层用 blocked KP 信封复现；本轮未把真实用户盘入库。
+
+## 任务状态
+
+| 任务 | 状态 | 说明 |
+| --- | --- | --- |
+| 0 根因 | 完成 | 见上；BUG-561 |
+| 1 KP + 静默跳过禁令 | 完成 | blocked 标题；最终 heading-ensure |
+| 2 审计表零行 | 完成 | `_iter_audit_modules` 在 raw 剥离前抽出；BUG-562 |
+| 3 力量章六子块 | 完成 | Bhava Bala 规范化；Yogini/Narayana/Kala periods 从本地模块补装 |
+| 4 年度回放按年展开 | 完成 | `_annual_series_surface` 保留 replay 键；缺年 blocked |
+| 4b 时间精度合同 | 完成 | 四粒度：day blocked；week/month parameter_sensitive；year 有年度系列则 partial_verified |
+| 4c 出生 provenance | 完成 | `birthplace_label` / `coordinate_source=user_reported` / `time_source` / `uncertainty_minutes`；坐标来源保持 user_reported |
+| 5 C 组小段 | 完成（blocked-or-present） | 原始模块索引、Technique Audit、Vargas I 等走显式 heading；分钟排行等与全量 Agent 行数未做真实盘逐行校准 |
+| 6 质量门 | 完成 | `tests/test_report_longform_gaps2.py` 与 timing/parity 相关切片 |
+
+## 质量门
+
+```bash
+.venv/bin/python -m pytest tests/test_report_longform_gaps2.py tests/test_timing_precision_contract.py tests/test_report_longform_parity.py -q
+```
+
+未改 `.gitea/workflows/**`，不提升 main。
diff --git a/docs/tasks/PROGRESS-report-md-page-20260906.md b/docs/tasks/PROGRESS-report-md-page-20260906.md
new file mode 100644
index 00000000..a636cd77
--- /dev/null
+++ b/docs/tasks/PROGRESS-report-md-page-20260906.md
@@ -0,0 +1,50 @@
+# PROGRESS · 报告详情页改渲染长报告 MD（2026-09-06）
+
+工作树：`.worktrees/report-md-page-20260906`
+分支：`codex/report-md-page-20260906`
+基线：`origin/staging` `e428e9d0`
+任务书：`TASK-report-md-page-20260906.md`（硬依赖 gaps2，已在同一 worktree 完成）
+未改 `.gitea/workflows/**`，不提升 main。
+
+## 开工回执
+
+- 目标：新报告 worker 只生成 pl9 长报告 MD；详情页渲染该 MD；writer 停用保留；零模型用量必须结算。
+- 顺序：gaps2 装配缺口 → MD-only 生成/计费 → 详情页 TOC/懒渲染 → 导出与报告中心 → 质量门。
+- 最大风险：`complete_personal_report_job` 仍要合法 v2 封面文档；计费 `completeUsage` 必须接受 0 token，且不得把 `actualModelId` 写成 `unknown`。
+
+## 我替领导拍的板
+
+- 计费：沿用 `report.full` 预留，结算 `inputTokens=0 outputTokens=0 costMicrousd=0`，`actualModelId` 用创建时的目录默认模型 id。缺少合法模型 id 时 **在报告标 ready 之前** 重试，避免预留悬挂。
+- 封面文档：writer 不再跑；写入一份最小合法 v2 文档（各主题走 blocked disclosure），页面不渲染它。卡片摘要来自生成时对 MD「摘要」的截取，仍落在封面 `executiveSummary.summary`，列表 JSON 路径不变。
+- 旧报告：无附录 MD 即显示「旧版本报告，请重新生成」，不维护五章视图。professional-reference POST 改为只读缓存，缺失返回 410。
+- 导出：详情页用内存中的同一份 MD 下载；文件名 `个人报告-YYYY-MM-DD`。打印为次按钮。
+
+## 任务状态
+
+| 任务 | 状态 | 说明 |
+| --- | --- | --- |
+| gaps2 | 完成 | 见 `PROGRESS-report-longform-gaps2-20260906.md`；BUG-561 / BUG-562 |
+| MD-only 生成 + 计费 | 完成 | `PERSONAL_REPORT_WRITER_ENABLED=false`；0-token settle |
+| 详情页 TOC/懒渲染 | 完成 | `react-markdown` + `remark-gfm` + `skipHtml`；首屏导航+摘要；H2 懒渲染 |
+| 导出 / 报告中心 | 完成 | 「导出报告（.md）」；一步式等待文案 |
+| 端到端 staging | 待部署后 | 本机质量门先跑；staging 真实创建仍需部署 |
+
+## 计费适配
+
+`complete_usage` 已允许 `input_tokens >= 0`。生产 worker 在长报告路径上：
+
+1. 先加载模型目录，没有默认模型则 `model_unavailable`（可重试），不跑引擎。
+2. 生成成功后带 `actualModelId=catalog.defaultModelId`、0 token。
+3. worker-core 若看到空/`unknown` 模型 id，在 `completeReportReady` 之前抛错，避免报告已 ready、预留永不结算。
+
+## 首屏渲染
+
+本地对含导航/摘要/宽表/诚实标签的样例 Markdown 做 `renderToStaticMarkup`，`frontend/tests/personal-report-longform-md.test.ts` 锁首屏 < 1500ms（本机实测约 30ms）。完整 ~250KB / 2700 行报告的浏览器首屏仍需 staging 部署后补测；H2 分段懒渲染后首屏只挂载导航+摘要。
+
+## 质量门命令
+
+```bash
+.venv/bin/python -m pytest tests/test_report_longform_gaps2.py tests/test_timing_precision_contract.py tests/test_report_longform_parity.py -q
+cd frontend && ./node_modules/.bin/tsc --noEmit
+cd frontend && ./node_modules/.bin/tsx --test tests/personal-report-longform-md.test.ts tests/personal-report-view.test.ts tests/personal-report-export.test.ts tests/personal-report-entry.test.ts tests/report-polling-contract.test.ts tests/professional-report-reference-route.test.ts tests/personal-report-worker.test.ts tests/personal-report-api.test.ts
+```
diff --git a/frontend/DESIGN.md b/frontend/DESIGN.md
index 2abb2560..b10abddc 100644
--- a/frontend/DESIGN.md
+++ b/frontend/DESIGN.md
@@ -348,20 +348,20 @@ Text release is paced, not animated: the frame buffer commits at most once per a
 - **Surface:** `--color-canvas-soft` floor; cards use `--color-canvas`, a warm hairline, and `--radius-lg`. No drop shadow. Status is a caption badge, not a colored block.
 - **Typography:** page title uses `--type-display-lg` / `--font-display` at weight 400 with `text-wrap: balance`. Card titles are `--type-title-md` at weight 500. Body stays `--type-body-md` or `--type-body-sm`.
 - **Width:** 900px centered, matching long-form chat reading. Cards stack below 720px.
-- **Actions:** “生成完整报告” is the one filled action. A ready report keeps “查看报告” as the primary document action and may add the quieter “全量数据附录” action beside it. The appendix action downloads Markdown through the authenticated same-origin report route; it is absent for generating and failed records. Appendix generation never changes the stored five-chapter report status.
-- **States:** loading, empty, populated, generating, ready, failed, unauthorized, list error. Export work uses the shared inline spinner inside the initiating button, reports a short row-local error, and never changes the stored report or starts a second writing flow.
+- **Actions:** “生成完整报告” is the one filled action. A ready report keeps “查看报告” as the primary document action and “导出报告（.md）” beside it. The export downloads the same longform Markdown the detail page renders. Generating copy is one-step (“正在生成报告，大约 10–30 秒”); there is no chapter-count progress. Card summary is a deterministic excerpt of the Markdown 「摘要」 section, stored on the cover document at generation time.
+- **States:** loading, empty, populated, generating, ready, failed, unauthorized, list error. Export work uses the shared inline spinner inside the initiating button, reports a short row-local error, and never starts a second writing flow. A missing Markdown appendix is an old report: the detail page asks the reader to regenerate.
 - **Accessibility:** back, generate, refresh, and row actions are 44px. Status text uses a live region while a report is generating.
 
 ### Personal report reader
 
-- **Structure:** sticky screen chrome (back, print, full-data appendix), then an answer-first document: cover, executive judgement, natal chart evidence, thematic sections, appendix, provenance.
-- **Surface:** page floor `--color-canvas-soft`; the document is a `--color-canvas` sheet with a hairline and `--radius-lg`. Print flattens the sheet, hides chrome, and pins the light palette.
-- **Typography:** the subject name uses `--type-display-lg` serif at weight 400. Section titles use `--type-display-sm` serif at weight 400. Theme headings are `--type-title-md` sans at weight 500. Narrative is `--type-body-md` at 1.65, the same measure as chat answers. Labels stay 12–13px.
-- **Accent:** claim-status pills and evidence links may use the action color; headings stay ink. Dark ink is never a page-scale rule or card edge.
-- **Charts:** North-Indian SVG uses theme ink and canvas fills, never hardcoded light-only hex.
-- **Width:** 900px for the document; chart and evidence columns stack at 760px.
-- **States:** loading, generating, timed-out, unauthorized, not-found, failed, invalid, network-error, ready. Waiting uses `InlineSpinner`.
-- **Accessibility:** back, print, appendix download, and appendix disclosure are 44px. Generating copy uses `role="status"`. Print remains keyboard-initiated from the chrome button.
+- **Structure:** sticky screen chrome (back, secondary print, primary “导出报告（.md）”), then the longform Markdown body with a sticky heading TOC. The five-chapter writer document is storage-only and is not rendered. Reports without Markdown show “旧版本报告，请重新生成”.
+- **Surface:** page floor `--color-canvas-soft`; the Markdown article is a `--color-canvas` sheet with a hairline and `--radius-lg`. Print flattens the sheet, hides chrome and the TOC, and pins the light palette.
+- **Typography:** Markdown `h2` uses `--type-display-sm` serif at weight 400. `h3` uses `--type-title-md` sans at weight 500. Body is `--type-body-md` at 1.65. Honesty labels (`blocked` / `conflict` / `parameter_sensitive`) stay visible; the reading-nav and quality-matrix sections are not collapsed.
+- **Accent:** headings stay ink. Dark ink is never a page-scale rule or card edge.
+- **Tables:** wide Markdown tables sit in `overflow-x: auto` wrappers; print unwraps them.
+- **Width:** 1120px for the reader chrome so the TOC rail can sit beside the article; the TOC stacks into a drawer below 860px.
+- **States:** loading, generating, timed-out, unauthorized, not-found, failed, invalid, network-error, markdown-ready, legacy-unavailable. Waiting uses `InlineSpinner` and one-step copy.
+- **Accessibility:** back, print, and Markdown export are 44px. Generating copy uses `role="status"`. Print remains keyboard-initiated from the chrome button. Markdown is rendered with `react-markdown` + `remark-gfm`, `skipHtml`, and no `rehype-raw`.
 
 ### Product entrypoint card
 
diff --git a/frontend/src/app/api/reports/[reportId]/professional-reference/route.ts b/frontend/src/app/api/reports/[reportId]/professional-reference/route.ts
index f7085d09..234cdd83 100644
--- a/frontend/src/app/api/reports/[reportId]/professional-reference/route.ts
+++ b/frontend/src/app/api/reports/[reportId]/professional-reference/route.ts
@@ -2,106 +2,26 @@ import { NextResponse } from "next/server";
 
 import {
   LONGFORM_APPENDIX_TABLE,
-  nextLongformAppendixState,
   parseLongformAppendixRow,
 } from "@/lib/personal-report-longform-appendix";
+import { PERSONAL_REPORT_LEGACY_PLACEHOLDER } from "@/lib/personal-report-longform-copy";
 import {
   checkSameOrigin,
   resolveAllowedReportOrigins,
 } from "@/lib/personal-report-entitlement";
 import { createSupabasePersonalReportService } from "@/lib/personal-report-service";
-import { loadReportCandidateRange } from "@/lib/report-candidate-range";
-import {
-  ACCOUNT_BIRTH_SELECT,
-  globalBirthProfileFromAccountRow,
-} from "@/lib/server-owned-birth-profile";
-import { createAdminSupabaseClient } from "@/lib/supabase/admin";
 import { isSupabaseConfigurationError } from "@/lib/supabase/config";
 import { createServerSupabaseClient } from "@/lib/supabase/server";
 
 export const runtime = "nodejs";
-export const maxDuration = 300;
+export const maxDuration = 60;
 
 const uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-const jyotishApiBase = process.env.JYOTISH_API_BASE ?? "http://127.0.0.1:5200";
 const APPENDIX_SELECT =
   "report_id,user_id,request_id,status,markdown,content_sha256,attempt_count,last_error_code";
 
 type RouteContext = { params: Promise<{ reportId: string }> };
 
-type ProfessionalReferenceResponse = Readonly<{
-  format?: unknown;
-  markdown?: unknown;
-}>;
-
-function utcToday(): string {
-  return new Date().toISOString().slice(0, 10);
-}
-
-function birthPayload(
-  row: unknown,
-  extras: Readonly<{
-    today: string;
-    targetYear: number;
-    candidateRange: { start_time: string; end_time: string } | null;
-    birthTimeAccuracy: "confirmed" | "provisional";
-  }>,
-): Record<string, unknown> | null {
-  const profile = globalBirthProfileFromAccountRow(row);
-  const dateMatch = /^(\d{4})-(\d{2})-(\d{2})$/.exec(profile.date ?? "");
-  const timeMatch = /^(\d{2}):(\d{2})$/.exec(profile.time ?? "");
-  if (
-    !dateMatch
-    || !timeMatch
-    || profile.latitude === null
-    || profile.longitude === null
-    || profile.timezoneOffset === null
-  ) {
-    return null;
-  }
-  const year = Number.parseInt(dateMatch[1], 10);
-  return {
-    year,
-    month: Number.parseInt(dateMatch[2], 10),
-    day: Number.parseInt(dateMatch[3], 10),
-    hour: Number.parseInt(timeMatch[1], 10),
-    minute: Number.parseInt(timeMatch[2], 10),
-    lat: profile.latitude,
-    lon: profile.longitude,
-    tz: profile.timezoneOffset,
-    ayanamsa: profile.ayanamsa,
-    format: "markdown",
-    packs: ["full"],
-    today: extras.today,
-    target_year: extras.targetYear,
-    age: extras.targetYear - year,
-    birth_time_accuracy: extras.birthTimeAccuracy,
-    ...(extras.candidateRange ? { candidate_range: extras.candidateRange } : {}),
-  };
-}
-
-function unavailableResponse() {
-  return NextResponse.json({ error: "全量数据附录暂不可用" }, { status: 503 });
-}
-
-function upstreamError(status: number, retryAfter: string | null) {
-  return NextResponse.json(
-    { error: status === 429 ? "全量数据附录生成繁忙，请稍后重试" : "全量数据附录暂不可用" },
-    {
-      status: status === 429 ? 429 : 503,
-      headers: retryAfter ? { "Retry-After": retryAfter } : undefined,
-    },
-  );
-}
-
-function tryAdminClient() {
-  try {
-    return createAdminSupabaseClient();
-  } catch {
-    return null;
-  }
-}
-
 export async function POST(request: Request, context: RouteContext) {
   try {
     const supabase = await createServerSupabaseClient();
@@ -142,79 +62,15 @@ export async function POST(request: Request, context: RouteContext) {
     if (cached?.status === "ready" && cached.markdown) {
       return NextResponse.json({ format: "markdown", markdown: cached.markdown });
     }
-    if (cached?.status === "unavailable") {
-      return unavailableResponse();
-    }
-
-    const { data: profileRow, error: profileError } = await supabase
-      .from("profiles")
-      .select(ACCOUNT_BIRTH_SELECT)
-      .eq("id", user.id)
-      .maybeSingle();
-    const admin = tryAdminClient();
-    const range = admin
-      ? await loadReportCandidateRange(admin, { userId: user.id })
-      : null;
-    const today = utcToday();
-    const payload = profileError ? null : birthPayload(profileRow, {
-      today,
-      targetYear: Number(today.slice(0, 4)),
-      candidateRange: range ? { start_time: range.startTime, end_time: range.endTime } : null,
-      birthTimeAccuracy: range && range.startTime !== range.endTime ? "provisional" : "confirmed",
-    });
-    if (!payload) {
-      return NextResponse.json({ error: "出生资料不完整" }, { status: 422 });
-    }
-
-    const persistAppendix = async (input: {
-      successMarkdown?: string | null;
-      errorCode?: string | null;
-    }) => {
-      if (!admin || !report.requestId) return;
-      const next = nextLongformAppendixState({
-        current: cached,
-        successMarkdown: input.successMarkdown,
-        errorCode: input.errorCode,
-      });
-      await admin.from(LONGFORM_APPENDIX_TABLE).upsert({
-        report_id: reportId,
-        user_id: user.id,
-        request_id: report.requestId,
-        status: next.status,
-        markdown: next.markdown,
-        content_sha256: next.contentSha256,
-        attempt_count: next.attemptCount,
-        last_error_code: next.lastErrorCode,
-        generated_at: next.status === "ready" ? new Date().toISOString() : null,
-        updated_at: new Date().toISOString(),
-      });
-    };
-
-    const upstream = await fetch(`${jyotishApiBase}/api/professional_report_reference`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json", Accept: "application/json" },
-      body: JSON.stringify(payload),
-      cache: "no-store",
-    });
-    if (!upstream.ok) {
-      await persistAppendix({
-        errorCode: upstream.status === 429 ? "upstream_busy" : "upstream_unavailable",
-      }).catch(() => undefined);
-      return upstreamError(upstream.status, upstream.headers.get("retry-after"));
-    }
-
-    const result = await upstream.json().catch(() => null) as ProfessionalReferenceResponse | null;
-    if (result?.format !== "markdown" || typeof result.markdown !== "string" || !result.markdown.trim()) {
-      await persistAppendix({ errorCode: "empty_markdown" }).catch(() => undefined);
-      return upstreamError(502, null);
-    }
-    await persistAppendix({ successMarkdown: result.markdown }).catch(() => undefined);
-    return NextResponse.json({ format: "markdown", markdown: result.markdown });
+    return NextResponse.json(
+      { error: PERSONAL_REPORT_LEGACY_PLACEHOLDER, code: "legacy_report" },
+      { status: 410 },
+    );
   } catch (error) {
     if (isSupabaseConfigurationError(error)) {
       return NextResponse.json({ error: "数据库尚未配置" }, { status: 503 });
     }
     console.error("professional_report_reference_failed", error instanceof Error ? error.name : "UnknownError");
-    return NextResponse.json({ error: "全量数据附录暂不可用" }, { status: 500 });
+    return NextResponse.json({ error: PERSONAL_REPORT_LEGACY_PLACEHOLDER }, { status: 500 });
   }
 }
diff --git a/frontend/src/app/api/reports/[reportId]/route.ts b/frontend/src/app/api/reports/[reportId]/route.ts
index 3a2e2d15..ae950b1c 100644
--- a/frontend/src/app/api/reports/[reportId]/route.ts
+++ b/frontend/src/app/api/reports/[reportId]/route.ts
@@ -6,6 +6,10 @@ import {
   resolveReportRead,
 } from "@/lib/personal-report-route-core";
 import { safeParseServerReportDocument } from "@/lib/personal-report-contract.server";
+import {
+  LONGFORM_APPENDIX_TABLE,
+  parseLongformAppendixRow,
+} from "@/lib/personal-report-longform-appendix";
 import {
   createSupabasePersonalReportService,
   type PersonalReportService,
@@ -39,7 +43,13 @@ async function resolvePersistenceForUser() {
   const supabase = await createServerSupabaseClient();
   const { data: { user }, error: authError } = await supabase.auth.getUser();
   if (authError || !user) {
-    return { userId: null as string | null, persistence: null as PersonalReportService | null, jobs: null, listSections: undefined };
+    return {
+      userId: null as string | null,
+      persistence: null as PersonalReportService | null,
+      jobs: null,
+      listSections: undefined,
+      loadLongformMarkdown: undefined,
+    };
   }
   const persistence = createSupabasePersonalReportService(supabase);
   const sections = createPersonalReportSectionService(supabase as never);
@@ -51,12 +61,23 @@ async function resolvePersistenceForUser() {
       const rows = await sections.list(ownerId, requestId);
       return rows.map((row) => ({ status: row.status, lastErrorCode: row.lastErrorCode }));
     },
+    loadLongformMarkdown: async (input: Readonly<{ userId: string; reportId: string }>) => {
+      const appendixRead = await supabase
+        .from(LONGFORM_APPENDIX_TABLE)
+        .select("report_id,user_id,request_id,status,markdown,content_sha256,attempt_count,last_error_code")
+        .eq("report_id", input.reportId)
+        .eq("user_id", input.userId)
+        .maybeSingle();
+      if (appendixRead.error) return null;
+      const row = parseLongformAppendixRow(appendixRead.data);
+      return row?.status === "ready" && row.markdown ? row.markdown : null;
+    },
   };
 }
 
 export async function GET(request: Request, context: RouteContext) {
   try {
-    const { userId, persistence, jobs, listSections } = await resolvePersistenceForUser();
+    const { userId, persistence, jobs, listSections, loadLongformMarkdown } = await resolvePersistenceForUser();
     const { reportId } = await context.params;
     if (!uuidPattern.test(reportId)) {
       return NextResponse.json(
@@ -82,6 +103,7 @@ export async function GET(request: Request, context: RouteContext) {
       // a substitute.
       jobs: jobs ?? undefined,
       listSections,
+      loadLongformMarkdown,
       validateReadyDocument: (document) => {
         const parsed = safeParseServerReportDocument(document);
         return parsed.ok
diff --git a/frontend/src/app/api/reports/route.ts b/frontend/src/app/api/reports/route.ts
index 8bdc00e0..6c053173 100644
--- a/frontend/src/app/api/reports/route.ts
+++ b/frontend/src/app/api/reports/route.ts
@@ -45,6 +45,7 @@ const REPORT_LIST_COLUMNS = [
   "failure_code",
   "created_at",
   "completed_at",
+  "card_summary:report_document->executiveSummary->>summary",
 ].join(",");
 
 function sanitizedErrorCode(error: unknown): string {
@@ -76,6 +77,9 @@ function listReportView(
     completedAt: row.completed_at == null || row.completed_at === ""
       ? null
       : reportListTimestamp(row.completed_at) || null,
+    ...(typeof row.card_summary === "string" && row.card_summary.trim()
+      ? { cardSummary: row.card_summary.trim().slice(0, 240) }
+      : {}),
     ...(failure?.summary ? { failureSummary: failure.summary } : {}),
   };
 }
diff --git a/frontend/src/app/globals.css b/frontend/src/app/globals.css
index 70865e22..5df67a41 100644
--- a/frontend/src/app/globals.css
+++ b/frontend/src/app/globals.css
@@ -3507,7 +3507,84 @@ input:not([type="radio"]):not([type="checkbox"]):not([class^="ant-"]):not([class
   scrollbar-gutter: stable;
   background: var(--color-canvas-soft);
 }
-.personal-report-reader-body { width: 100%; padding: 0 var(--space-6) var(--space-16); }
+.personal-report-reader-body { width: min(1120px, 100%); margin: 0 auto; padding: 0 var(--space-6) var(--space-16); }
+.personal-report-md-layout {
+  display: grid;
+  grid-template-columns: minmax(11rem, 15rem) minmax(0, 1fr);
+  gap: var(--space-6);
+  align-items: start;
+}
+.personal-report-toc {
+  position: sticky;
+  top: 72px;
+  max-height: calc(100vh - 96px);
+  overflow: auto;
+  padding: var(--space-3);
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius-lg);
+  background: var(--color-canvas);
+}
+.personal-report-toc ol {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+.personal-report-toc li[data-level="3"] { padding-left: var(--space-3); }
+.personal-report-toc a {
+  display: block;
+  padding: 4px 0;
+  color: var(--color-ink-secondary);
+  font-size: var(--type-caption);
+  text-decoration: none;
+}
+.personal-report-toc a.is-current,
+.personal-report-toc a:hover { color: var(--color-ink); }
+.personal-report-toc-drawer { display: none; }
+.personal-report-toc-desktop p {
+  margin: 0 0 var(--space-2);
+  font-size: var(--type-caption);
+  font-weight: 600;
+}
+.personal-report-md-article {
+  min-width: 0;
+  overflow-wrap: anywhere;
+  padding: var(--space-8) var(--space-7) var(--space-10);
+}
+.personal-report-md-article h2,
+.personal-report-md-article h3 { scroll-margin-top: 80px; }
+.personal-report-md-article h2 {
+  margin: var(--space-8) 0 var(--space-3);
+  font-family: var(--font-display);
+  font-size: var(--type-display-sm);
+  font-weight: 400;
+}
+.personal-report-md-article h3 {
+  margin: var(--space-6) 0 var(--space-2);
+  font-size: var(--type-title-md);
+  font-weight: 500;
+}
+.personal-report-md-article p,
+.personal-report-md-article li {
+  color: var(--color-ink);
+  font-size: var(--type-body-md);
+  line-height: 1.65;
+}
+.personal-report-md-placeholder { min-height: 24rem; }
+.personal-report-toc-drawer summary {
+  min-height: 44px;
+  display: flex;
+  align-items: center;
+  cursor: pointer;
+  font-weight: 600;
+}
+.personal-report-md-lead,
+.personal-report-md-section { min-width: 0; }
+@media (max-width: 860px) {
+  .personal-report-md-layout { grid-template-columns: 1fr; }
+  .personal-report-toc { position: static; max-height: none; }
+  .personal-report-toc-desktop { display: none; }
+  .personal-report-toc-drawer { display: block; }
+}
 .personal-report-actions {
   position: sticky;
   top: 0;
@@ -3517,7 +3594,7 @@ input:not([type="radio"]):not([type="checkbox"]):not([class^="ant-"]):not([class
   backdrop-filter: saturate(130%) blur(20px);
 }
 .personal-report-actions > div {
-  width: min(900px, 100%);
+  width: min(1120px, 100%);
   min-height: 54px;
   display: flex;
   align-items: center;
@@ -3963,10 +4040,15 @@ input:not([type="radio"]):not([type="checkbox"]):not([class^="ant-"]):not([class
   html, body { width: auto !important; height: auto !important; min-height: 0 !important; overflow: visible !important; background: #fff !important; }
   * { -webkit-print-color-adjust: exact !important; print-color-adjust: exact !important; }
   .personal-report-screen-only { display: none !important; }
+  .personal-report-toc { display: none !important; }
+  .personal-report-md-layout { display: block !important; }
   .personal-report-print-always { display: block !important; }
   .personal-report-appendix-details:not([open]) > .personal-report-print-always { display: block !important; }
   .personal-report-reader { width: auto !important; height: auto !important; min-height: 0 !important; overflow: visible !important; background: #fff !important; }
   .personal-report-reader-body { width: auto !important; padding: 0 !important; }
+  .personal-report-toc { display: none !important; }
+  .personal-report-md-layout { display: block !important; }
+  .personal-report-md-placeholder { display: none !important; }
   .personal-report-document {
     width: auto !important;
     max-width: none !important;
diff --git a/frontend/src/components/personal-report/personal-report-center.tsx b/frontend/src/components/personal-report/personal-report-center.tsx
index 35d0eece..6d764b31 100644
--- a/frontend/src/components/personal-report/personal-report-center.tsx
+++ b/frontend/src/components/personal-report/personal-report-center.tsx
@@ -8,6 +8,10 @@ import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { GeneratePersonalReportButton } from "./generate-personal-report-button";
 import { Button } from "@/components/ui/button";
 import { useVisibilityAwarePoll } from "@/hooks/use-visibility-aware-poll";
+import {
+  PERSONAL_REPORT_EXPORT_LABEL,
+  PERSONAL_REPORT_GENERATING_COPY,
+} from "@/lib/personal-report-longform-copy";
 import { downloadPersonalReportLongformAppendix } from "@/lib/personal-report-longform-download";
 
 const LIST_POLL_INTERVAL_MS = 3000;
@@ -23,6 +27,7 @@ type ReportListItem = Readonly<{
   failureSummary?: string | null;
   createdAt: string;
   completedAt: string | null;
+  cardSummary?: string | null;
 }>;
 
 type CenterState =
@@ -32,8 +37,8 @@ type CenterState =
   | { phase: "error"; reports: readonly ReportListItem[] };
 
 const STATUS_COPY = {
-  generating: { label: "生成中", description: "已在后台处理，你可以离开此页面。" },
-  ready: { label: "已完成", description: "报告已生成，可随时查看或保存为 PDF。" },
+  generating: { label: "生成中", description: PERSONAL_REPORT_GENERATING_COPY },
+  ready: { label: "已完成", description: "报告已生成，可随时查看或导出 Markdown。" },
   failed: { label: "未完成", description: "本次生成没有产出可用报告，可重新生成。" },
 } as const;
 
@@ -61,7 +66,10 @@ function readReports(value: unknown): ReportListItem[] {
       failureCode: typeof row.failureCode === "string" ? row.failureCode : null,
       failureSummary: typeof row.failureSummary === "string" ? row.failureSummary : null,
       createdAt: typeof row.createdAt === "string" ? row.createdAt : "",
-      completedAt: typeof row.completedAt === "string" ? row.completedAt : null,
+      completedAt: row.completedAt == null ? null : String(row.completedAt),
+      cardSummary: typeof row.cardSummary === "string" && row.cardSummary.trim()
+        ? row.cardSummary
+        : null,
     }];
   });
 }
@@ -139,15 +147,17 @@ export function PersonalReportCenter() {
     [state.reports],
   );
 
-  const downloadProfessionalReference = useCallback(async (reportId: string) => {
-    setExportingReportId(reportId);
+  const downloadProfessionalReference = useCallback(async (report: ReportListItem) => {
+    setExportingReportId(report.id);
     setExportError(null);
     try {
-      await downloadPersonalReportLongformAppendix(reportId);
+      await downloadPersonalReportLongformAppendix(report.id, {
+        reportDate: report.completedAt ?? report.createdAt,
+      });
     } catch (error) {
       setExportError({
-        reportId,
-        message: error instanceof Error ? error.message : "全量数据附录暂不可用",
+        reportId: report.id,
+        message: error instanceof Error ? error.message : "报告导出暂不可用",
       });
     } finally {
       setExportingReportId(null);
@@ -215,7 +225,7 @@ export function PersonalReportCenter() {
                       <StatusIcon status={report.status} />{copy.label}
                     </div>
                     <h3>{report.reportType === "personal_thematic" ? "个人主题报告" : "个人完整报告"}</h3>
-                    <p>{copy.description}</p>
+                    <p>{report.status === "ready" && report.cardSummary ? report.cardSummary : copy.description}</p>
                     <small>{formatDate(report.createdAt)} · {report.depth} · {report.themes.join(" / ") || "综合主题"}</small>
                   </div>
                   {report.status === "ready" ? (
@@ -227,10 +237,10 @@ export function PersonalReportCenter() {
                         type="button"
                         variant="ghost"
                         disabled={exportingReportId === report.id}
-                        onClick={() => void downloadProfessionalReference(report.id)}
+                        onClick={() => void downloadProfessionalReference(report)}
                       >
                         {exportingReportId === report.id ? <InlineSpinner size={14} /> : null}
-                        全量数据附录
+                        {PERSONAL_REPORT_EXPORT_LABEL}
                       </Button>
                       {exportError?.reportId === report.id ? (
                         <span className="report-center-export-error" role="alert">
diff --git a/frontend/src/components/personal-report/personal-report-markdown-view.tsx b/frontend/src/components/personal-report/personal-report-markdown-view.tsx
new file mode 100644
index 00000000..ae9bc87f
--- /dev/null
+++ b/frontend/src/components/personal-report/personal-report-markdown-view.tsx
@@ -0,0 +1,167 @@
+"use client";
+
+import { useEffect, useMemo, useRef, useState, type ReactNode } from "react";
+import ReactMarkdown, { type Components } from "react-markdown";
+import remarkGfm from "remark-gfm";
+
+import {
+  buildLongformOutline,
+  type LongformHeading,
+  type LongformSection,
+} from "@/lib/personal-report-longform-outline";
+
+function flattenText(node: ReactNode): string {
+  if (typeof node === "string" || typeof node === "number") return String(node);
+  if (Array.isArray(node)) return node.map(flattenText).join("");
+  if (node && typeof node === "object" && "props" in node) {
+    const props = (node as { props?: { children?: ReactNode } }).props;
+    return flattenText(props?.children);
+  }
+  return "";
+}
+
+function reportUrlTransform(url: string): string {
+  return url.startsWith("#") ? url : "";
+}
+
+function markdownComponents(headings: readonly LongformHeading[]): Components {
+  const cursor = { h2: 0, h3: 0 };
+  const nextId = (level: 2 | 3, children: ReactNode) => {
+    const title = flattenText(children).trim();
+    const key = level === 2 ? "h2" : "h3";
+    const matches = headings.filter((heading) => heading.level === level && heading.title === title);
+    const index = cursor[key];
+    cursor[key] = index + 1;
+    return matches[index]?.id ?? matches[0]?.id;
+  };
+  return {
+    a: ({ children, href }) => {
+      if (typeof href === "string" && href.startsWith("#")) {
+        return <a href={href}>{children}</a>;
+      }
+      return <span>{children}</span>;
+    },
+    img: () => null,
+    table: ({ children }) => (
+      <div className="markdown-table personal-report-table-wrap">
+        <table>{children}</table>
+      </div>
+    ),
+    h2: ({ children }) => <h2 id={nextId(2, children)}>{children}</h2>,
+    h3: ({ children }) => <h3 id={nextId(3, children)}>{children}</h3>,
+  };
+}
+
+function renderMarkdown(markdown: string, headings: readonly LongformHeading[]) {
+  return (
+    <ReactMarkdown
+      components={markdownComponents(headings)}
+      disallowedElements={["script", "iframe", "object", "embed", "img"]}
+      remarkPlugins={[remarkGfm]}
+      skipHtml
+      unwrapDisallowed
+      urlTransform={reportUrlTransform}
+    >
+      {markdown}
+    </ReactMarkdown>
+  );
+}
+
+function LazyMarkdownSection({
+  section,
+}: {
+  section: LongformSection;
+}) {
+  const ref = useRef<HTMLElement>(null);
+  const [visible, setVisible] = useState(section.eager);
+  useEffect(() => {
+    if (visible) return;
+    if (typeof IntersectionObserver === "undefined") {
+      setVisible(true);
+      return;
+    }
+    if (!ref.current) return;
+    const observer = new IntersectionObserver((entries) => {
+      if (entries.some((entry) => entry.isIntersecting)) setVisible(true);
+    }, { rootMargin: "280px 0px" });
+    observer.observe(ref.current);
+    return () => observer.disconnect();
+  }, [visible]);
+  return (
+    <section ref={ref} className="personal-report-md-section">
+      {visible ? renderMarkdown(section.markdown, section.headings) : (
+        <h2 id={section.id}>{section.title}</h2>
+      )}
+    </section>
+  );
+}
+
+export function PersonalReportMarkdownView({ markdown }: { markdown: string }) {
+  const outline = useMemo(() => buildLongformOutline(markdown), [markdown]);
+  const [activeId, setActiveId] = useState(outline.headings[0]?.id ?? "");
+
+  useEffect(() => {
+    if (outline.headings.length === 0 || typeof IntersectionObserver === "undefined") return;
+    const observer = new IntersectionObserver((entries) => {
+      const visible = entries
+        .filter((entry) => entry.isIntersecting)
+        .sort((left, right) => left.boundingClientRect.top - right.boundingClientRect.top);
+      const id = visible[0]?.target.id;
+      if (id) setActiveId(id);
+    }, { rootMargin: "-20% 0px -70% 0px", threshold: [0, 1] });
+    for (const item of outline.headings) {
+      const node = document.getElementById(item.id);
+      if (node) observer.observe(node);
+    }
+    return () => observer.disconnect();
+  }, [outline.headings]);
+
+  return (
+    <div className="personal-report-md-layout">
+      <nav aria-label="报告目录" className="personal-report-toc">
+        <details className="personal-report-toc-drawer">
+          <summary>目录</summary>
+          <TocList activeId={activeId} items={outline.headings} />
+        </details>
+        <div className="personal-report-toc-desktop">
+          <p>目录</p>
+          <TocList activeId={activeId} items={outline.headings} />
+        </div>
+      </nav>
+      <article className="personal-report-document personal-report-md-article">
+        {outline.leadMarkdown ? (
+          <section className="personal-report-md-lead">
+            {renderMarkdown(outline.leadMarkdown, outline.headings)}
+          </section>
+        ) : null}
+        {outline.sections.filter((section) => !section.eager).map((section) => (
+          <LazyMarkdownSection key={section.id} section={section} />
+        ))}
+      </article>
+    </div>
+  );
+}
+
+function TocList({
+  items,
+  activeId,
+}: {
+  items: readonly LongformHeading[];
+  activeId: string;
+}) {
+  return (
+    <ol>
+      {items.map((item) => (
+        <li data-level={item.level} key={item.id}>
+          <a
+            aria-current={item.id === activeId ? "location" : undefined}
+            className={item.id === activeId ? "is-current" : undefined}
+            href={`#${item.id}`}
+          >
+            {item.title}
+          </a>
+        </li>
+      ))}
+    </ol>
+  );
+}
diff --git a/frontend/src/components/personal-report/personal-report-page.tsx b/frontend/src/components/personal-report/personal-report-page.tsx
index 9d25bde6..bc08019a 100644
--- a/frontend/src/components/personal-report/personal-report-page.tsx
+++ b/frontend/src/components/personal-report/personal-report-page.tsx
@@ -2,14 +2,9 @@
  * Client loader for /reports/[reportId].
  *
  * Fetches GET /api/reports/:id (same-origin, cookies included) and maps the
- * envelope to explicit UI states: loading / unauthorized / not-found /
- * generating (with polling) / timed-out (poll budget exhausted, generation
- * continues server-side) / failed / invalid (schema guard rejected) / ready.
- * The print action is mounted only after a validated ready document exists.
- *
- * The GET envelope is classified here by status discriminant only; the ready
- * reportDocument payload itself is validated by the canonical
- * safeParseReportDocument from @/lib/personal-report-contract.
+ * envelope to explicit UI states. Ready reports render longform Markdown.
+ * Missing Markdown shows the retired-writer placeholder. Print stays a
+ * secondary action after the Markdown body exists.
  */
 
 "use client";
@@ -23,9 +18,11 @@ import { Clock3, TriangleAlert } from "lucide-react";
 import { InlineSpinner } from "@/components/inline-spinner";
 
 import { ReportActions } from "./report-actions";
-import { PersonalReportDocumentView } from "./personal-report-document-view";
-import { safeParseReportDocument } from "@/lib/personal-report-contract";
-import type { ReportDocument } from "@/lib/personal-report-contract";
+import { PersonalReportMarkdownView } from "./personal-report-markdown-view";
+import {
+  PERSONAL_REPORT_GENERATING_COPY,
+  PERSONAL_REPORT_LEGACY_PLACEHOLDER,
+} from "@/lib/personal-report-longform-copy";
 import { Button } from "@/components/ui/button";
 import { useVisibilityAwarePoll } from "@/hooks/use-visibility-aware-poll";
 
@@ -38,7 +35,8 @@ export type ReportLoadState =
   | { phase: "failed"; failureCode: string | null; failureSummary?: string | null }
   | { phase: "invalid"; message: string }
   | { phase: "network-error" }
-  | { phase: "ready"; document: ReportDocument };
+  | { phase: "markdown-ready"; markdown: string; reportId: string; createdAt: string }
+  | { phase: "legacy-unavailable" };
 
 /** GET /api/reports/:id envelope view (mirrors the API route's reportView). */
 export interface ReportEnvelopeView {
@@ -57,11 +55,11 @@ export interface ReportEnvelopeView {
 
 /**
  * Status discriminant for the GET /api/reports/:id envelope, aligned to the
- * actual route response: `{ report: { status, failureCode, ... }, reportDocument? }`
- * with 401/404/403/5xx error envelopes. Does NOT validate reportDocument here;
- * ready payloads are passed to the canonical safeParseReportDocument from
- * @/lib/personal-report-contract. The timed-out phase is client-only: the
- * server never reports it, it is reached when the local poll budget runs out.
+ * actual route response: `{ report: { status, failureCode, ... }, longformMarkdown? }`
+ * with 401/404/403/5xx error envelopes. Ready reports render the longform
+ * Markdown body; missing Markdown is treated as a retired writer-era report.
+ * The timed-out phase is client-only: the server never reports it, it is
+ * reached when the local poll budget runs out.
  */
 export function classifyReportEnvelope(statusCode: number, json: unknown): ReportLoadState {
   if (statusCode === 401) {
@@ -83,14 +81,16 @@ export function classifyReportEnvelope(statusCode: number, json: unknown): Repor
   const view = json.report as Partial<ReportEnvelopeView>;
   switch (view.status) {
     case "ready": {
-      if (!("reportDocument" in json)) {
-        return { phase: "invalid", message: "报告接口缺少报告正文。" };
+      const markdown = typeof json.longformMarkdown === "string" ? json.longformMarkdown.trim() : "";
+      if (markdown.length > 0) {
+        return {
+          phase: "markdown-ready",
+          markdown,
+          reportId: typeof view.id === "string" ? view.id : "",
+          createdAt: typeof view.createdAt === "string" ? view.createdAt : "",
+        };
       }
-      const parsed = safeParseReportDocument(json.reportDocument);
-      if (!parsed.ok) {
-        return { phase: "invalid", message: parsed.errors.map((error) => `${error.path}: ${error.message}`).join("; ") };
-      }
-      return { phase: "ready", document: parsed.document };
+      return { phase: "legacy-unavailable" };
     }
     case "generating": {
       const progressPercent = typeof view.progressPercent === "number" ? view.progressPercent : undefined;
@@ -209,11 +209,6 @@ export function PersonalReportPage({ reportId }: { reportId: string }) {
   }, [load]);
 
   const generating = state.phase === "generating";
-  const progressLabel = generating && state.progressPhase?.startsWith("section:")
-    ? `正在生成主题（进度 ${Math.max(0, Math.min(100, Math.round(state.progressPercent ?? 30)))}%）`
-    : generating && state.progressPhase === "summary" ? "正在汇总全部主题"
-      : generating && state.progressPhase === "assemble" ? "正在装配报告"
-        : null;
 
   useVisibilityAwarePoll({
     enabled: generating,
@@ -232,7 +227,7 @@ export function PersonalReportPage({ reportId }: { reportId: string }) {
       <main className="personal-report-state">
         <InlineSpinner className="text-primary" size={32} />
         <p role="status">
-          {generating ? (progressLabel ?? "报告正在生成中，请稍候…") : "正在加载报告…"}
+          {generating ? PERSONAL_REPORT_GENERATING_COPY : "正在加载报告…"}
         </p>
         {generating && (
           <>
@@ -321,13 +316,43 @@ export function PersonalReportPage({ reportId }: { reportId: string }) {
     );
   }
 
-  const document = state.document;
+  if (state.phase === "legacy-unavailable") {
+    return (
+      <main className="personal-report-state">
+        <TriangleAlert aria-hidden="true" className="size-8 text-warning" />
+        <h1>旧版本报告</h1>
+        <p>{PERSONAL_REPORT_LEGACY_PLACEHOLDER}</p>
+        <Button render={<Link href="/reports" />} nativeButton={false} variant="outline">
+          返回报告中心重新生成
+        </Button>
+      </main>
+    );
+  }
+
+  if (state.phase !== "markdown-ready") {
+    return (
+      <main className="personal-report-state">
+        <TriangleAlert aria-hidden="true" className="size-8 text-danger" />
+        <h1>报告暂时无法显示</h1>
+        <p>报告状态无法识别。</p>
+        <Button type="button" variant="outline" onClick={() => void reload()}>
+          重新加载
+        </Button>
+      </main>
+    );
+  }
+
   return (
     <main className="personal-report-reader">
       <style media="print">{"@page { size: A4; margin: 13mm 12mm 14mm; }"}</style>
-      <ReportActions reportId={document.reportId} reportTitle={`${document.subject.displayName} · 个人报告`} />
+      <ReportActions
+        reportId={state.reportId || reportId}
+        reportTitle="个人报告"
+        markdown={state.markdown}
+        reportDate={state.createdAt}
+      />
       <div className="personal-report-reader-body">
-        <PersonalReportDocumentView document={document} />
+        <PersonalReportMarkdownView markdown={state.markdown} />
       </div>
     </main>
   );
diff --git a/frontend/src/components/personal-report/report-actions.tsx b/frontend/src/components/personal-report/report-actions.tsx
index 70dc10b4..8d7750b0 100644
--- a/frontend/src/components/personal-report/report-actions.tsx
+++ b/frontend/src/components/personal-report/report-actions.tsx
@@ -15,11 +15,17 @@ import {
   safeReportFilename,
 } from "@/lib/client-report-export";
 import { downloadPersonalReportLongformAppendix } from "@/lib/personal-report-longform-download";
+import {
+  PERSONAL_REPORT_EXPORT_LABEL,
+  PERSONAL_REPORT_PRINT_LABEL,
+} from "@/lib/personal-report-longform-copy";
 import { Button } from "@/components/ui/button";
 
 interface ReportActionsProps {
   reportId: string;
   reportTitle?: string;
+  markdown?: string;
+  reportDate?: string | null;
 }
 
 function subscribePrintCapability(onStoreChange: () => void): () => void {
@@ -27,14 +33,19 @@ function subscribePrintCapability(onStoreChange: () => void): () => void {
   return () => undefined;
 }
 
-export function ReportActions({ reportId, reportTitle }: ReportActionsProps) {
+export function ReportActions({
+  reportId,
+  reportTitle,
+  markdown,
+  reportDate,
+}: ReportActionsProps) {
   const [printBusy, setPrintBusy] = useState(false);
-  const [appendixBusy, setAppendixBusy] = useState(false);
+  const [exportBusy, setExportBusy] = useState(false);
   const [notice, setNotice] = useState<string | null>(null);
   const printSupported = useSyncExternalStore(subscribePrintCapability, isPrintSupported, () => false);
 
   async function handlePrint() {
-    if (printBusy || appendixBusy || !printSupported) return;
+    if (printBusy || exportBusy || !printSupported) return;
     const restriction = detectPrintRestriction();
     if (restriction.restricted) {
       setNotice(restriction.message ?? "当前浏览器无法可靠打印，请在系统浏览器中打开本页。");
@@ -49,16 +60,19 @@ export function ReportActions({ reportId, reportTitle }: ReportActionsProps) {
     }
   }
 
-  async function handleAppendix() {
-    if (printBusy || appendixBusy) return;
-    setAppendixBusy(true);
+  async function handleExport() {
+    if (printBusy || exportBusy) return;
+    setExportBusy(true);
     setNotice(null);
     try {
-      await downloadPersonalReportLongformAppendix(reportId);
+      await downloadPersonalReportLongformAppendix(reportId, {
+        markdown,
+        reportDate,
+      });
     } catch (error) {
-      setNotice(error instanceof Error ? error.message : "全量数据附录暂不可用");
+      setNotice(error instanceof Error ? error.message : "报告暂不可导出");
     } finally {
-      setAppendixBusy(false);
+      setExportBusy(false);
     }
   }
 
@@ -70,14 +84,14 @@ export function ReportActions({ reportId, reportTitle }: ReportActionsProps) {
         </Link>
         <div className="personal-report-action-end">
           {notice && <span role="status"><TriangleAlert aria-hidden="true" />{notice}</span>}
-          <Button type="button" size="sm" variant="ghost" onClick={() => void handleAppendix()} disabled={printBusy || appendixBusy}>
-            <FileText aria-hidden="true" />{appendixBusy ? "正在准备附录…" : "全量数据附录"}
+          <Button type="button" size="sm" variant="ghost" onClick={() => void handlePrint()} disabled={printBusy || exportBusy || !printSupported}>
+            <Printer aria-hidden="true" />{printBusy ? "正在准备…" : PERSONAL_REPORT_PRINT_LABEL}
           </Button>
-          <Button type="button" size="sm" onClick={() => void handlePrint()} disabled={printBusy || appendixBusy || !printSupported}>
-            <Printer aria-hidden="true" />{printBusy ? "正在准备…" : "打印 / 保存为 PDF"}
+          <Button type="button" size="sm" onClick={() => void handleExport()} disabled={printBusy || exportBusy}>
+            <FileText aria-hidden="true" />{exportBusy ? "正在准备…" : PERSONAL_REPORT_EXPORT_LABEL}
           </Button>
         </div>
       </div>
     </nav>
   );
-}
\ No newline at end of file
+}
diff --git a/frontend/src/lib/personal-report-longform-birth.ts b/frontend/src/lib/personal-report-longform-birth.ts
new file mode 100644
index 00000000..62c5fd6a
--- /dev/null
+++ b/frontend/src/lib/personal-report-longform-birth.ts
@@ -0,0 +1,91 @@
+import {
+  globalBirthProfileFromAccountRow,
+} from "./server-owned-birth-profile";
+
+export function utcToday(now = new Date()): string {
+  return now.toISOString().slice(0, 10);
+}
+
+function accountText(row: unknown, key: string): string | undefined {
+  if (!row || typeof row !== "object" || Array.isArray(row)) return undefined;
+  const value = (row as Record<string, unknown>)[key];
+  if (typeof value !== "string") return undefined;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : undefined;
+}
+
+function clockToMinutes(value: string): number | null {
+  const match = /^(\d{2}):(\d{2})$/.exec(value);
+  if (!match) return null;
+  return Number.parseInt(match[1], 10) * 60 + Number.parseInt(match[2], 10);
+}
+
+export function provenanceUncertaintyMinutes(
+  row: unknown,
+  candidateRange: { start_time: string; end_time: string } | null,
+): number | undefined {
+  if (candidateRange) {
+    const start = clockToMinutes(candidateRange.start_time);
+    const end = clockToMinutes(candidateRange.end_time);
+    if (start !== null && end !== null) return Math.max(0, end - start);
+  }
+  if (!row || typeof row !== "object" || Array.isArray(row)) return undefined;
+  const record = row as Record<string, unknown>;
+  const before = typeof record.uncertainty_before_minutes === "number"
+    ? record.uncertainty_before_minutes
+    : Number(record.uncertainty_before_minutes);
+  const after = typeof record.uncertainty_after_minutes === "number"
+    ? record.uncertainty_after_minutes
+    : Number(record.uncertainty_after_minutes);
+  const hasBefore = Number.isFinite(before);
+  const hasAfter = Number.isFinite(after);
+  if (!hasBefore && !hasAfter) return undefined;
+  return Math.max(0, (hasBefore ? before : 0) + (hasAfter ? after : 0));
+}
+
+export function buildLongformBirthPayload(
+  row: unknown,
+  extras: Readonly<{
+    today: string;
+    targetYear: number;
+    candidateRange: { start_time: string; end_time: string } | null;
+    birthTimeAccuracy: "confirmed" | "provisional";
+  }>,
+): Record<string, unknown> | null {
+  const profile = globalBirthProfileFromAccountRow(row);
+  const dateMatch = /^(\d{4})-(\d{2})-(\d{2})$/.exec(profile.date ?? "");
+  const timeMatch = /^(\d{2}):(\d{2})$/.exec(profile.time ?? "");
+  if (
+    !dateMatch
+    || !timeMatch
+    || profile.latitude === null
+    || profile.longitude === null
+    || profile.timezoneOffset === null
+  ) {
+    return null;
+  }
+  const year = Number.parseInt(dateMatch[1], 10);
+  return {
+    year,
+    month: Number.parseInt(dateMatch[2], 10),
+    day: Number.parseInt(dateMatch[3], 10),
+    hour: Number.parseInt(timeMatch[1], 10),
+    minute: Number.parseInt(timeMatch[2], 10),
+    lat: profile.latitude,
+    lon: profile.longitude,
+    tz: profile.timezoneOffset,
+    ayanamsa: profile.ayanamsa,
+    format: "markdown",
+    packs: ["full"],
+    today: extras.today,
+    target_year: extras.targetYear,
+    age: extras.targetYear - year,
+    birth_time_accuracy: extras.birthTimeAccuracy,
+    ...(extras.candidateRange ? { candidate_range: extras.candidateRange } : {}),
+    birthplace_label: accountText(row, "birth_place_label") ?? undefined,
+    coordinate_source: "user_reported",
+    coordinate_precision: "unverified_user_coordinates",
+    time_source: accountText(row, "birth_time_source") ?? accountText(row, "birth_time_status") ?? undefined,
+    uncertainty_minutes: provenanceUncertaintyMinutes(row, extras.candidateRange),
+  };
+}
diff --git a/frontend/src/lib/personal-report-longform-copy.ts b/frontend/src/lib/personal-report-longform-copy.ts
new file mode 100644
index 00000000..d301d50b
--- /dev/null
+++ b/frontend/src/lib/personal-report-longform-copy.ts
@@ -0,0 +1,4 @@
+export const PERSONAL_REPORT_LEGACY_PLACEHOLDER = "旧版本报告，请重新生成";
+export const PERSONAL_REPORT_GENERATING_COPY = "正在生成报告，大约 10–30 秒";
+export const PERSONAL_REPORT_EXPORT_LABEL = "导出报告（.md）";
+export const PERSONAL_REPORT_PRINT_LABEL = "打印";
diff --git a/frontend/src/lib/personal-report-longform-cover.ts b/frontend/src/lib/personal-report-longform-cover.ts
new file mode 100644
index 00000000..38ca3e1a
--- /dev/null
+++ b/frontend/src/lib/personal-report-longform-cover.ts
@@ -0,0 +1,142 @@
+import { createHash } from "node:crypto";
+import { computeEvidenceHash, parseServerReportDocument } from "./personal-report-contract.server-core.ts";
+import {
+  REPORT_DOCUMENT_V2_SCHEMA_VERSION,
+  type ReportDocumentV2,
+} from "./personal-report-contract.ts";
+import { extractLongformSummary } from "./personal-report-longform-outline.ts";
+import type { PersonalReportRecord } from "./personal-report-service-core.ts";
+
+type CoverSkillSnapshot = Readonly<{
+  name: string;
+  version: string;
+  sha256: string;
+  sourceCommit: string | null;
+}>;
+
+const COVER_EVIDENCE_ID = "ev-cover-longform";
+const SIGNS_CN = [
+  "白羊座", "金牛座", "双子座", "巨蟹座", "狮子座", "处女座",
+  "天秤座", "天蝎座", "射手座", "摩羯座", "水瓶座", "双鱼座",
+] as const;
+
+export type LongformCoverInput = Readonly<{
+  report: Pick<
+    PersonalReportRecord,
+    | "id"
+    | "reportType"
+    | "presentationMode"
+    | "depth"
+    | "requestedThemes"
+    | "skillName"
+    | "skillVersion"
+    | "skillSourceCommit"
+    | "skillSnapshotSha256"
+  >;
+  subject: Readonly<{
+    displayName: string;
+    birthTimeStatus: ReportDocumentV2["subject"]["birthTimeStatus"];
+    birthPlaceLabel: string;
+  }>;
+  markdown: string;
+  generatedAt?: string;
+  skillSnapshot?: CoverSkillSnapshot;
+}>;
+
+function coverHouses(): ReportDocumentV2["charts"][number]["houses"] {
+  return SIGNS_CN.map((sign, index) => ({
+    houseNumber: index + 1,
+    sign,
+    occupants: [],
+  }));
+}
+
+export function buildLongformCoverDocument(input: LongformCoverInput): ReportDocumentV2 {
+  const summary = extractLongformSummary(input.markdown);
+  const skillName = input.skillSnapshot?.name ?? input.report.skillName;
+  const skillVersion = input.skillSnapshot?.version ?? input.report.skillVersion;
+  const skillSnapshotSha256 = input.skillSnapshot?.sha256 ?? input.report.skillSnapshotSha256;
+  const skillSourceCommit = input.skillSnapshot?.sourceCommit ?? input.report.skillSourceCommit;
+  if (!skillName || !skillVersion || !skillSnapshotSha256) {
+    throw new Error("report_schema_invalid");
+  }
+  const calculationHash = createHash("sha256").update(input.markdown, "utf8").digest("hex");
+  const evidenceAppendix: ReportDocumentV2["evidenceAppendix"] = {
+    expandedByDefault: false,
+    techniqueAudit: [{
+      id: COVER_EVIDENCE_ID,
+      techniqueId: "pl9_personal_long_report",
+      techniqueName: "个人长报告 Markdown",
+      status: "partial",
+      used: true,
+      notes: "正文为长报告 Markdown，本封面仅用于落库校验。",
+    }],
+    conflicts: [],
+    calculationEvidence: [],
+    blockedTechniques: [],
+  };
+  const document = {
+    schemaVersion: REPORT_DOCUMENT_V2_SCHEMA_VERSION,
+    reportId: input.report.id,
+    reportType: input.report.reportType,
+    presentationMode: input.report.presentationMode,
+    depth: input.report.depth,
+    requestedThemes: [...input.report.requestedThemes],
+    generatedAt: input.generatedAt ?? new Date().toISOString(),
+    subject: input.subject,
+    provenance: {
+      skillName,
+      skillVersion,
+      skillSourceCommit: skillSourceCommit && /^[0-9a-f]{40}$/.test(skillSourceCommit)
+        ? skillSourceCommit
+        : null,
+      skillSnapshotSha256,
+      calculationHash,
+      evidenceHash: computeEvidenceHash(evidenceAppendix),
+      reportContractVersion: "2" as const,
+    },
+    executiveSummary: {
+      headline: "个人长报告已生成",
+      summary,
+      priorities: ["阅读长报告 Markdown 正文"],
+      overallClaimStatus: "parameter_sensitive" as const,
+      evidenceRefs: [COVER_EVIDENCE_ID],
+    },
+    natalFoundation: {
+      title: "封面占位",
+      narrative: "本封面不作为阅读正文。完整报告见长报告 Markdown。",
+      keyFactors: ["长报告 Markdown 为正文"],
+      caveats: ["本封面文档不在详情页渲染"],
+      claimStatus: "parameter_sensitive" as const,
+      evidenceRefs: [COVER_EVIDENCE_ID],
+    },
+    currentPhase: null,
+    actionNotes: [{
+      id: "read-longform",
+      title: "阅读长报告",
+      note: "请在详情页阅读长报告 Markdown 正文。",
+      priority: "now" as const,
+      evidenceRefs: [COVER_EVIDENCE_ID],
+    }],
+    charts: [{
+      id: "D1" as const,
+      title: "D1 占位",
+      houses: coverHouses(),
+      claimStatus: "parameter_sensitive" as const,
+      evidenceRefs: [COVER_EVIDENCE_ID],
+    }],
+    thematicNarrative: [],
+    blockedConflictDisclosure: input.report.requestedThemes.map((theme) => ({
+      theme,
+      title: `${theme} 主题见长报告`,
+      reason: "本封面不展开主题叙事。完整证据与解读见长报告 Markdown。",
+      missingEvidence: ["封面不装配主题叙事，请阅读长报告正文"],
+      conflictNotes: [],
+      evidenceRefs: [] as string[],
+      claimStatus: "blocked" as const,
+    })),
+    evidenceAppendix,
+    disclaimer: "本封面仅用于系统落库校验。阅读请以长报告 Markdown 为准。",
+  };
+  return parseServerReportDocument(document) as ReportDocumentV2;
+}
diff --git a/frontend/src/lib/personal-report-longform-download.ts b/frontend/src/lib/personal-report-longform-download.ts
index 56b35580..097e5563 100644
--- a/frontend/src/lib/personal-report-longform-download.ts
+++ b/frontend/src/lib/personal-report-longform-download.ts
@@ -1,4 +1,6 @@
 import { downloadMarkdownReport } from "./consultation-report-export";
+import { PERSONAL_REPORT_LEGACY_PLACEHOLDER } from "./personal-report-longform-copy";
+import { personalReportMarkdownFilename } from "./personal-report-longform-outline";
 
 export async function requestPersonalReportLongformAppendix(reportId: string): Promise<string> {
   const response = await fetch(`/api/reports/${encodeURIComponent(reportId)}/professional-reference`, {
@@ -14,12 +16,19 @@ export async function requestPersonalReportLongformAppendix(reportId: string): P
     || typeof payload.markdown !== "string"
     || !payload.markdown.trim()
   ) {
-    throw new Error(typeof payload.error === "string" ? payload.error : "全量数据附录暂不可用");
+    throw new Error(
+      typeof payload.error === "string" ? payload.error : PERSONAL_REPORT_LEGACY_PLACEHOLDER,
+    );
   }
   return payload.markdown;
 }
 
-export async function downloadPersonalReportLongformAppendix(reportId: string): Promise<void> {
-  const markdown = await requestPersonalReportLongformAppendix(reportId);
-  downloadMarkdownReport("个人全量数据附录", markdown);
+export async function downloadPersonalReportLongformAppendix(
+  reportId: string,
+  options: Readonly<{ markdown?: string; reportDate?: string | null }> = {},
+): Promise<void> {
+  const markdown = options.markdown?.trim()
+    ? options.markdown
+    : await requestPersonalReportLongformAppendix(reportId);
+  downloadMarkdownReport(personalReportMarkdownFilename(options.reportDate), markdown);
 }
diff --git a/frontend/src/lib/personal-report-longform-generate.ts b/frontend/src/lib/personal-report-longform-generate.ts
new file mode 100644
index 00000000..c201fa78
--- /dev/null
+++ b/frontend/src/lib/personal-report-longform-generate.ts
@@ -0,0 +1,223 @@
+import "server-only";
+
+import {
+  LONGFORM_APPENDIX_TABLE,
+  nextLongformAppendixState,
+  parseLongformAppendixRow,
+  type LongformAppendixRow,
+} from "./personal-report-longform-appendix";
+import { buildLongformBirthPayload, utcToday } from "./personal-report-longform-birth";
+import { buildLongformCoverDocument } from "./personal-report-longform-cover";
+import type { GeneratePersonalReportResult } from "./personal-report-generation";
+import type { PersonalReportRecord } from "./personal-report-service-core";
+import type { ReportDocumentV2 } from "./personal-report-contract";
+
+const APPENDIX_SELECT =
+  "report_id,user_id,request_id,status,markdown,content_sha256,attempt_count,last_error_code";
+const DEFAULT_API_BASE = "http://127.0.0.1:5200";
+const ENGINE_TIMEOUT_MS = 180_000;
+
+export class LongformGenerateError extends Error {
+  readonly name = "LongformGenerateError";
+
+  constructor(
+    readonly code: "calculation_unavailable" | "report_schema_invalid" | "birth_time_not_usable",
+    readonly retryable: boolean,
+    message?: string,
+  ) {
+    super(message ?? code);
+  }
+}
+
+type JsonRecord = Record<string, unknown>;
+
+export type AppendixClient = {
+  from(table: string): {
+    select(columns: string): {
+      eq(column: string, value: unknown): AppendixFilter;
+    };
+    upsert(row: JsonRecord): PromiseLike<{ error: { message?: string } | null }>;
+  };
+};
+
+type AppendixFilter = {
+  eq(column: string, value: unknown): AppendixFilter;
+  maybeSingle(): PromiseLike<{ data: unknown; error: { message?: string } | null }>;
+};
+
+export type LongformGenerateDeps = Readonly<{
+  report: PersonalReportRecord;
+  profile: unknown;
+  candidateRange: Readonly<{ startTime: string; endTime: string }> | null;
+  admin: AppendixClient;
+  displayName: string;
+  birthTimeStatus: ReportDocumentV2["subject"]["birthTimeStatus"];
+  apiBase?: string;
+  fetchImpl?: typeof fetch;
+  now?: () => Date;
+  signal?: AbortSignal;
+}>;
+
+function record(value: unknown): JsonRecord | null {
+  return value !== null && typeof value === "object" && !Array.isArray(value)
+    ? value as JsonRecord
+    : null;
+}
+
+function text(value: unknown): string | null {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+
+export async function readOwnedLongformAppendix(
+  client: AppendixClient,
+  reportId: string,
+  userId: string,
+): Promise<LongformAppendixRow | null> {
+  const result = await client
+    .from(LONGFORM_APPENDIX_TABLE)
+    .select(APPENDIX_SELECT)
+    .eq("report_id", reportId)
+    .eq("user_id", userId)
+    .maybeSingle();
+  if (result.error) return null;
+  return parseLongformAppendixRow(result.data);
+}
+
+export async function persistLongformAppendix(input: Readonly<{
+  admin: AppendixClient;
+  reportId: string;
+  userId: string;
+  requestId: string;
+  current: LongformAppendixRow | null;
+  successMarkdown?: string | null;
+  errorCode?: string | null;
+}>): Promise<void> {
+  const next = nextLongformAppendixState({
+    current: input.current,
+    successMarkdown: input.successMarkdown,
+    errorCode: input.errorCode,
+  });
+  const result = await input.admin.from(LONGFORM_APPENDIX_TABLE).upsert({
+    report_id: input.reportId,
+    user_id: input.userId,
+    request_id: input.requestId,
+    status: next.status,
+    markdown: next.markdown,
+    content_sha256: next.contentSha256,
+    attempt_count: next.attemptCount,
+    last_error_code: next.lastErrorCode,
+    generated_at: next.status === "ready" ? new Date().toISOString() : null,
+    updated_at: new Date().toISOString(),
+  });
+  if (result.error) {
+    throw new LongformGenerateError("calculation_unavailable", true, "longform_appendix_persist_failed");
+  }
+}
+
+async function fetchLongformMarkdown(input: Readonly<{
+  payload: Record<string, unknown>;
+  apiBase: string;
+  fetchImpl: typeof fetch;
+  signal?: AbortSignal;
+}>): Promise<string> {
+  const timeout = AbortSignal.timeout(ENGINE_TIMEOUT_MS);
+  const signal = input.signal
+    ? AbortSignal.any([input.signal, timeout])
+    : timeout;
+  const upstream = await input.fetchImpl(`${input.apiBase.replace(/\/$/, "")}/api/professional_report_reference`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", Accept: "application/json" },
+    body: JSON.stringify(input.payload),
+    cache: "no-store",
+    signal,
+  });
+  if (!upstream.ok) {
+    throw new LongformGenerateError(
+      "calculation_unavailable",
+      true,
+      upstream.status === 429 ? "upstream_busy" : "upstream_unavailable",
+    );
+  }
+  const result = await upstream.json().catch(() => null) as { format?: unknown; markdown?: unknown } | null;
+  if (result?.format !== "markdown" || typeof result.markdown !== "string" || !result.markdown.trim()) {
+    throw new LongformGenerateError("calculation_unavailable", true, "empty_markdown");
+  }
+  return result.markdown;
+}
+
+export async function generatePersonalReportLongform(
+  deps: LongformGenerateDeps,
+): Promise<GeneratePersonalReportResult> {
+  const profile = record(deps.profile);
+  if (!profile) {
+    throw new LongformGenerateError("report_schema_invalid", false);
+  }
+  const today = utcToday(deps.now?.() ?? new Date());
+  const range = deps.candidateRange
+    ? { start_time: deps.candidateRange.startTime, end_time: deps.candidateRange.endTime }
+    : null;
+  const payload = buildLongformBirthPayload(deps.profile, {
+    today,
+    targetYear: Number(today.slice(0, 4)),
+    candidateRange: range,
+    birthTimeAccuracy: range && range.start_time !== range.end_time ? "provisional" : "confirmed",
+  });
+  if (!payload) {
+    throw new LongformGenerateError("birth_time_not_usable", false);
+  }
+
+  const current = await readOwnedLongformAppendix(deps.admin, deps.report.id, deps.report.userId);
+  let markdown = current?.status === "ready" && current.markdown ? current.markdown : null;
+  if (!markdown) {
+    try {
+      markdown = await fetchLongformMarkdown({
+        payload,
+        apiBase: deps.apiBase ?? process.env.JYOTISH_API_BASE ?? DEFAULT_API_BASE,
+        fetchImpl: deps.fetchImpl ?? fetch,
+        signal: deps.signal,
+      });
+    } catch (error) {
+      if (deps.signal?.aborted) throw error;
+      await persistLongformAppendix({
+        admin: deps.admin,
+        reportId: deps.report.id,
+        userId: deps.report.userId,
+        requestId: deps.report.requestId,
+        current,
+        errorCode: error instanceof LongformGenerateError ? error.message.slice(0, 80) : "generation_failed",
+      }).catch(() => undefined);
+      if (error instanceof LongformGenerateError) throw error;
+      throw new LongformGenerateError("calculation_unavailable", true);
+    }
+    await persistLongformAppendix({
+      admin: deps.admin,
+      reportId: deps.report.id,
+      userId: deps.report.userId,
+      requestId: deps.report.requestId,
+      current,
+      successMarkdown: markdown,
+    });
+  }
+
+  try {
+    const document = buildLongformCoverDocument({
+      report: deps.report,
+      subject: {
+        displayName: deps.displayName,
+        birthTimeStatus: deps.birthTimeStatus,
+        birthPlaceLabel: text(profile.birth_place_label) ?? "未知出生地",
+      },
+      markdown,
+      generatedAt: (deps.now?.() ?? new Date()).toISOString(),
+    });
+    return {
+      status: "ready",
+      document,
+      evidenceHash: document.provenance.evidenceHash,
+    };
+  } catch {
+    throw new LongformGenerateError("report_schema_invalid", false, "final_parse_rejected");
+  }
+}
diff --git a/frontend/src/lib/personal-report-longform-outline.ts b/frontend/src/lib/personal-report-longform-outline.ts
new file mode 100644
index 00000000..73d793f0
--- /dev/null
+++ b/frontend/src/lib/personal-report-longform-outline.ts
@@ -0,0 +1,179 @@
+export type LongformHeadingLevel = 2 | 3;
+
+export type LongformHeading = Readonly<{
+  id: string;
+  level: LongformHeadingLevel;
+  title: string;
+}>;
+
+export type LongformSection = Readonly<{
+  id: string;
+  title: string;
+  markdown: string;
+  headings: readonly LongformHeading[];
+  eager: boolean;
+}>;
+
+export type LongformOutline = Readonly<{
+  headings: readonly LongformHeading[];
+  leadMarkdown: string;
+  sections: readonly LongformSection[];
+}>;
+
+const EAGER_H2 = /成品阅读导航|质量验收矩阵/;
+const SUMMARY_TITLE = /^(?:解读摘要|摘要)$/;
+
+export function slugifyHeading(title: string, used: Map<string, number>): string {
+  const base = title
+    .trim()
+    .toLowerCase()
+    .replace(/[^\p{L}\p{N}]+/gu, "-")
+    .replace(/^-+|-+$/g, "")
+    .slice(0, 80) || "section";
+  const next = (used.get(base) ?? 0) + 1;
+  used.set(base, next);
+  return next === 1 ? base : `${base}-${next}`;
+}
+
+function parseHeading(line: string): { level: LongformHeadingLevel; title: string } | null {
+  const match = /^(#{2,3})\s+(.+?)\s*$/.exec(line);
+  if (!match) return null;
+  return {
+    level: match[1].length === 2 ? 2 : 3,
+    title: match[2].replace(/\s+#+\s*$/, "").trim(),
+  };
+}
+
+function extractHeadingBlock(markdown: string, pattern: RegExp, level: LongformHeadingLevel): string | null {
+  const lines = markdown.split("\n");
+  let start = -1;
+  for (let index = 0; index < lines.length; index += 1) {
+    const heading = parseHeading(lines[index] ?? "");
+    if (heading?.level === level && pattern.test(heading.title)) {
+      start = index;
+      break;
+    }
+  }
+  if (start < 0) return null;
+  const collected = [lines[start]];
+  for (let index = start + 1; index < lines.length; index += 1) {
+    const heading = parseHeading(lines[index] ?? "");
+    if (heading && heading.level <= level) break;
+    collected.push(lines[index] ?? "");
+  }
+  const text = collected.join("\n").trim();
+  return text.length > 0 ? text : null;
+}
+
+function extractH3Block(markdown: string, pattern: RegExp): string | null {
+  return extractHeadingBlock(markdown, pattern, 3);
+}
+
+function stripH3Block(markdown: string, pattern: RegExp): string {
+  const lines = markdown.split("\n");
+  const kept: string[] = [];
+  let skipping = false;
+  for (const line of lines) {
+    const heading = parseHeading(line);
+    if (skipping) {
+      if (heading && heading.level <= 3) skipping = false;
+      else continue;
+    }
+    if (!skipping && heading?.level === 3 && pattern.test(heading.title)) {
+      skipping = true;
+      continue;
+    }
+    if (!skipping) kept.push(line);
+  }
+  return kept.join("\n").replace(/^\n+|\n+$/g, "");
+}
+
+export function buildLongformOutline(markdown: string): LongformOutline {
+  const used = new Map<string, number>();
+  const lines = markdown.replace(/\r\n/g, "\n").split("\n");
+  const headings: LongformHeading[] = [];
+  type Block = {
+    title: string;
+    start: number;
+    headingIndex: number;
+    h3Indexes: number[];
+  };
+  const blocks: Block[] = [];
+  let current: Block | null = null;
+
+  lines.forEach((line, lineIndex) => {
+    const parsed = parseHeading(line);
+    if (!parsed) return;
+    const heading: LongformHeading = {
+      id: slugifyHeading(parsed.title, used),
+      level: parsed.level,
+      title: parsed.title,
+    };
+    const headingIndex = headings.length;
+    headings.push(heading);
+    if (parsed.level === 2) {
+      current = {
+        title: parsed.title,
+        start: lineIndex,
+        headingIndex,
+        h3Indexes: [],
+      };
+      blocks.push(current);
+      return;
+    }
+    if (current) current.h3Indexes.push(headingIndex);
+  });
+
+  const leadParts: string[] = [];
+  const preamble = (blocks[0] ? lines.slice(0, blocks[0].start) : lines).join("\n").trim();
+  if (preamble) leadParts.push(preamble);
+
+  const sections: LongformSection[] = blocks.map((block, index) => {
+    const end = index + 1 < blocks.length ? blocks[index + 1].start : lines.length;
+    const raw = lines.slice(block.start, end).join("\n").trim();
+    const eager = EAGER_H2.test(block.title) || SUMMARY_TITLE.test(block.title);
+    const summary = extractH3Block(raw, SUMMARY_TITLE);
+    if (eager) leadParts.push(raw);
+    else if (summary) leadParts.push(summary);
+    const sectionMarkdown = eager || !summary ? raw : stripH3Block(raw, SUMMARY_TITLE);
+    return {
+      id: headings[block.headingIndex]?.id ?? slugifyHeading(block.title, used),
+      title: block.title,
+      markdown: sectionMarkdown,
+      headings: [
+        headings[block.headingIndex],
+        ...block.h3Indexes.map((item) => headings[item]),
+      ].filter((item): item is LongformHeading => Boolean(item)),
+      eager,
+    };
+  });
+
+  return {
+    headings,
+    leadMarkdown: leadParts.join("\n\n").trim(),
+    sections,
+  };
+}
+
+export function extractLongformSummary(markdown: string, maxLength = 2000): string {
+  const summaryBlock = extractH3Block(markdown, SUMMARY_TITLE)
+    ?? extractHeadingBlock(markdown, SUMMARY_TITLE, 2)
+    ?? "";
+  const cleaned = summaryBlock
+    .replace(/^#{1,6}\s+.+$/gm, " ")
+    .replace(/<[^>]*>/g, " ")
+    .replace(/[#>*`|_\[\]]/g, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+  const fallback = "个人长报告已生成。详情页展示完整 Markdown 正文。";
+  const text = cleaned.length > 0 ? cleaned : fallback;
+  if (text.length <= maxLength) return text;
+  return `${text.slice(0, maxLength - 1)}…`;
+}
+
+export function personalReportMarkdownFilename(reportDate: string | null | undefined): string {
+  const stamp = typeof reportDate === "string" && /^\d{4}-\d{2}-\d{2}/.test(reportDate)
+    ? reportDate.slice(0, 10)
+    : new Date().toISOString().slice(0, 10);
+  return `个人报告-${stamp}`.replace(/[\\/:*?"<>|]+/g, "-");
+}
diff --git a/frontend/src/lib/personal-report-route-core.ts b/frontend/src/lib/personal-report-route-core.ts
index 5d3d5306..95e9c38d 100644
--- a/frontend/src/lib/personal-report-route-core.ts
+++ b/frontend/src/lib/personal-report-route-core.ts
@@ -651,6 +651,10 @@ export type ReportReadCoreDeps = Readonly<{
     status: string;
     lastErrorCode: string | null;
   }>[]>;
+  loadLongformMarkdown?: (input: Readonly<{
+    userId: string;
+    reportId: string;
+  }>) => Promise<string | null>;
 }>;
 
 export async function resolveReportRead(deps: ReportReadCoreDeps): Promise<ReportRouteResponse> {
@@ -680,10 +684,32 @@ export async function resolveReportRead(deps: ReportReadCoreDeps): Promise<Repor
     })
     : null;
   if (row.status === "ready") {
+    const markdown = deps.loadLongformMarkdown
+      ? await deps.loadLongformMarkdown({ userId: deps.userId, reportId: deps.reportId })
+      : undefined;
+    if (typeof markdown === "string" && markdown.trim()) {
+      const validated = deps.validateReadyDocument(row.reportDocument);
+      return {
+        status: 200,
+        body: {
+          report: reportView(row, job),
+          longformMarkdown: markdown,
+          ...(validated.ok ? { reportDocument: validated.document } : {}),
+        },
+      };
+    }
     // Re-validate the stored document through the canonical server parse
     // before it is allowed to leave the server; an invalid stored document is
-    // surfaced as a stable failure WITHOUT the document body.
+    // surfaced as a stable failure WITHOUT the document body. When the MD
+    // loader is wired and the appendix is missing, the client shows the
+    // legacy placeholder instead of the five-chapter document.
     const validated = deps.validateReadyDocument(row.reportDocument);
+    if (deps.loadLongformMarkdown) {
+      return {
+        status: 200,
+        body: { report: reportView(row, job), longformMarkdown: null },
+      };
+    }
     if (!validated.ok) {
       return {
         status: 422,
diff --git a/frontend/src/lib/personal-report-worker-core.ts b/frontend/src/lib/personal-report-worker-core.ts
index 5020196c..b3dab678 100644
--- a/frontend/src/lib/personal-report-worker-core.ts
+++ b/frontend/src/lib/personal-report-worker-core.ts
@@ -370,18 +370,23 @@ export function createPersonalReportWorker(deps: PersonalReportWorkerDeps) {
         leaseToken: job.leaseToken,
         ...PERSONAL_REPORT_WORKER_PROGRESS.persistingReport,
       });
+      const settlementModelId = generated.usage?.actualModelId?.trim() ?? "";
+      if (deps.billing && (!settlementModelId || settlementModelId === "unknown")) {
+        throw new PersonalReportWorkerError("model_unavailable", true, "missing settlement model id");
+      }
       await deps.jobs.completeReportReady({
         jobId: job.id,
         leaseToken: job.leaseToken,
         report,
         document: generated.document,
       });
+      report = { ...report, status: "ready" };
       if (deps.billing) {
         const settled = await deps.billing.complete({
           userId: job.userId,
           requestId: job.requestId,
           usage: {
-            actualModelId: generated.usage?.actualModelId ?? "unknown",
+            actualModelId: settlementModelId,
             modelConfigVersion: generated.usage?.modelConfigVersion,
             inputTokens: generated.usage?.inputTokens ?? 0,
             outputTokens: generated.usage?.outputTokens ?? 0,
diff --git a/frontend/src/lib/personal-report-worker.ts b/frontend/src/lib/personal-report-worker.ts
index faea4529..ec4d5a88 100644
--- a/frontend/src/lib/personal-report-worker.ts
+++ b/frontend/src/lib/personal-report-worker.ts
@@ -21,6 +21,12 @@ import {
   resolveReportBirthClock,
   resolveReportBirthTimeSensitivityInput,
 } from "@/lib/personal-report-route-core";
+import {
+  generatePersonalReportLongform,
+  LongformGenerateError,
+  type AppendixClient,
+} from "@/lib/personal-report-longform-generate";
+import { PERSONAL_REPORT_WRITER_ENABLED } from "@/lib/personal-report-writer-flag";
 import { loadReportCandidateRange } from "@/lib/report-candidate-range";
 import { createAdminSupabaseClient } from "@/lib/supabase/admin";
 import { completeUsage, releaseUsage } from "@/lib/consultation-billing";
@@ -97,7 +103,7 @@ function skillSnapshotForReport(context: PersonalReportWorkerGenerationContext):
   };
 }
 
-async function generateProductionReport(
+async function generateWriterReport(
   context: PersonalReportWorkerGenerationContext,
   candidateRange: Readonly<{ startTime: string; endTime: string }> | null = null,
 ) {
@@ -206,6 +212,65 @@ async function generateProductionReport(
   };
 }
 
+async function generateLongformReport(
+  context: PersonalReportWorkerGenerationContext,
+  candidateRange: Readonly<{ startTime: string; endTime: string }> | null,
+  admin: AppendixClient,
+) {
+  const profile = record(context.profile);
+  if (!profile) throw new PersonalReportWorkerError("profile_incomplete", false);
+  const usableBirth = resolveReportBirthClock(profile);
+  const latitude = finiteNumber(profile.latitude);
+  const longitude = finiteNumber(profile.longitude);
+  const timezoneOffset = finiteNumber(profile.timezone_offset);
+  const displayName = text(profile.name) ?? "我的报告";
+  if (!usableBirth || latitude === null || longitude === null || timezoneOffset === null) {
+    throw new PersonalReportWorkerError("birth_time_not_usable", false);
+  }
+  const catalog = await loadLanguageModelCatalog();
+  const model = catalog.models.find((entry) => entry.id === catalog.defaultModelId) ?? null;
+  if (!model) throw new PersonalReportWorkerError("model_unavailable", true);
+  try {
+    const generated = await generatePersonalReportLongform({
+      report: context.report,
+      profile,
+      candidateRange,
+      admin,
+      displayName,
+      birthTimeStatus: usableBirth.status,
+      signal: context.signal,
+    });
+    if (generated.status !== "ready") return generated;
+    return {
+      ...generated,
+      usage: {
+        inputTokens: 0,
+        outputTokens: 0,
+        actualModelId: model.id,
+        modelConfigVersion: model.configVersion,
+      },
+    };
+  } catch (error) {
+    if (context.signal.aborted) throw error;
+    if (error instanceof PersonalReportWorkerError) throw error;
+    if (error instanceof LongformGenerateError) {
+      throw new PersonalReportWorkerError(error.code, error.retryable, error.message);
+    }
+    throw new PersonalReportWorkerError("calculation_unavailable", true);
+  }
+}
+
+async function generateProductionReport(
+  context: PersonalReportWorkerGenerationContext,
+  candidateRange: Readonly<{ startTime: string; endTime: string }> | null,
+  admin: AppendixClient,
+) {
+  if (PERSONAL_REPORT_WRITER_ENABLED) {
+    return generateWriterReport(context, candidateRange);
+  }
+  return generateLongformReport(context, candidateRange, admin);
+}
+
 function createProductionWorker(workerId: string) {
   const admin = createAdminSupabaseClient();
   const backend = admin as unknown as {
@@ -255,13 +320,13 @@ function createProductionWorker(workerId: string) {
     generate: async (context) => {
       const profile = record(context.profile) ?? {};
       if (resolveReportBirthClock(profile)?.status === "confirmed") {
-        return generateProductionReport(context);
+        return generateProductionReport(context, null, admin as never);
       }
       const range = await loadReportCandidateRange(admin, {
         userId: context.report.userId,
         rectificationCaseId: text(profile.rectification_case_id),
       });
-      return generateProductionReport(context, range);
+      return generateProductionReport(context, range, admin as never);
     },
   });
 }
diff --git a/frontend/src/lib/personal-report-writer-flag.ts b/frontend/src/lib/personal-report-writer-flag.ts
new file mode 100644
index 00000000..a7f35a12
--- /dev/null
+++ b/frontend/src/lib/personal-report-writer-flag.ts
@@ -0,0 +1,2 @@
+/** Writer narrative pipeline is retired for new reports. Keep the code; do not call it. */
+export const PERSONAL_REPORT_WRITER_ENABLED = false;
diff --git a/frontend/src/lib/server-owned-birth-profile.ts b/frontend/src/lib/server-owned-birth-profile.ts
index 363f5904..d8913d5d 100644
--- a/frontend/src/lib/server-owned-birth-profile.ts
+++ b/frontend/src/lib/server-owned-birth-profile.ts
@@ -4,7 +4,7 @@ import { resolveAyanamsa } from "./ayanamsa.ts";
 const usableActiveStatuses = new Set(["accepted", "confirmed"]);
 
 export const ACCOUNT_BIRTH_SELECT =
-  "name,birth_date,reported_birth_time,active_birth_time,birth_time,birth_time_status,country_code,province_code,city_code,district_code,latitude,longitude,timezone_offset,timezone_id,ayanamsa" as const;
+  "name,birth_date,reported_birth_time,active_birth_time,birth_time,birth_time_status,birth_time_source,country_code,province_code,city_code,district_code,latitude,longitude,timezone_offset,timezone_id,ayanamsa,birth_place_label,uncertainty_before_minutes,uncertainty_after_minutes,declared_window_start,declared_window_end" as const;
 
 export type AccountBirthRow = Readonly<{
   name?: unknown;
@@ -13,6 +13,12 @@ export type AccountBirthRow = Readonly<{
   active_birth_time?: unknown;
   birth_time?: unknown;
   birth_time_status?: unknown;
+  birth_time_source?: unknown;
+  birth_place_label?: unknown;
+  uncertainty_before_minutes?: unknown;
+  uncertainty_after_minutes?: unknown;
+  declared_window_start?: unknown;
+  declared_window_end?: unknown;
   country_code?: unknown;
   province_code?: unknown;
   city_code?: unknown;
diff --git a/frontend/tests/personal-report-api.test.ts b/frontend/tests/personal-report-api.test.ts
index 032af545..6f8b8404 100644
--- a/frontend/tests/personal-report-api.test.ts
+++ b/frontend/tests/personal-report-api.test.ts
@@ -1132,6 +1132,38 @@ test("core read: returns a legitimate ready document after canonical re-validati
   assert.ok(response.body.reportDocument);
 });
 
+test("core read: markdown loader returns longform and hides the five-chapter body when it is missing", async () => {
+  const persistence = new MemoryPersistence();
+  persistence.rows.set(REPORT_ID, seedRecord());
+  const withMarkdown = await resolveReportRead({
+    requestUrl: "https://jyotisha.chat/api/reports/x",
+    origin: null,
+    allowedOrigins: [],
+    userId: UUID_A,
+    reportId: REPORT_ID,
+    persistence,
+    loadLongformMarkdown: async () => "# 长报告\n\n### 摘要\n正文",
+    validateReadyDocument: acceptAnyDocument,
+  });
+  assert.equal(withMarkdown.status, 200);
+  assert.equal(withMarkdown.body.longformMarkdown, "# 长报告\n\n### 摘要\n正文");
+  assert.ok(withMarkdown.body.reportDocument);
+
+  const missing = await resolveReportRead({
+    requestUrl: "https://jyotisha.chat/api/reports/x",
+    origin: null,
+    allowedOrigins: [],
+    userId: UUID_A,
+    reportId: REPORT_ID,
+    persistence,
+    loadLongformMarkdown: async () => null,
+    validateReadyDocument: acceptAnyDocument,
+  });
+  assert.equal(missing.status, 200);
+  assert.equal(missing.body.longformMarkdown, null);
+  assert.equal("reportDocument" in missing.body, false);
+});
+
 test("core delete: owner-only, 200 ok for the owner and 404 otherwise", async () => {
   const persistence = new MemoryPersistence();
   await createReadyRow(persistence);
@@ -1232,6 +1264,7 @@ test("GET/DELETE use the authenticated client (least privilege) and the core han
   assert.match(itemRoute, /createSupabasePersonalReportService\(supabase\)/);
   assert.match(itemRoute, /resolveReportRead/);
   assert.match(itemRoute, /resolveReportDelete/);
+  assert.match(itemRoute, /loadLongformMarkdown/);
   assert.doesNotMatch(itemRoute, /createAdminSupabaseClient/);
 });
 
@@ -1277,7 +1310,12 @@ test("POST enqueues durable work without Next.js after and GET lists metadata wi
     createRoute.indexOf("const REPORT_LIST_COLUMNS"),
     createRoute.indexOf("function sanitizedErrorCode"),
   );
-  assert.doesNotMatch(listColumns, /report_document|calculation_hash|evidence_hash/);
+  assert.doesNotMatch(listColumns, /calculation_hash|evidence_hash/);
+  assert.match(listColumns, /card_summary:report_document->executiveSummary->>summary/);
+  assert.doesNotMatch(
+    listColumns.replace("card_summary:report_document->executiveSummary->>summary", ""),
+    /report_document/,
+  );
   assert.doesNotMatch(createRoute, /STALE_GENERATION_MS|staleBefore/);
   assert.match(createRoute, /reportListTimestamp\(row\.created_at\)/);
   assert.match(createRoute, /reportListTimestamp\(row\.completed_at\)/);
diff --git a/frontend/tests/personal-report-entry.test.ts b/frontend/tests/personal-report-entry.test.ts
index b57cf53f..6e6f029f 100644
--- a/frontend/tests/personal-report-entry.test.ts
+++ b/frontend/tests/personal-report-entry.test.ts
@@ -285,11 +285,14 @@ test("legacy consultation Markdown export is untouched and still works", () => {
 });
 
 
-test("ready reports expose the full-data appendix Markdown export only in the ready branch", () => {
-  assert.match(reportCenterSource, /全量数据附录/);
+test("ready reports expose Markdown export only in the ready branch", () => {
+  assert.match(reportCenterSource, /PERSONAL_REPORT_EXPORT_LABEL/);
   assert.match(reportCenterSource, /downloadPersonalReportLongformAppendix/);
+  assert.match(reportCenterSource, /cardSummary/);
   assert.match(longformDownloadSource, /professional-reference/);
-  assert.match(longformDownloadSource, /downloadMarkdownReport\("个人全量数据附录", markdown\)/);
+  assert.match(longformDownloadSource, /personalReportMarkdownFilename/);
+  assert.doesNotMatch(reportCenterSource, /全量数据附录/);
+  assert.doesNotMatch(reportCenterSource, /章节/);
   const readyActionStart = reportCenterSource.indexOf(
     '{report.status === "ready" ? (',
   );
@@ -299,6 +302,6 @@ test("ready reports expose the full-data appendix Markdown export only in the re
   );
   assert.ok(readyActionStart >= 0 && generatingActionStart > readyActionStart);
   const readyBranch = reportCenterSource.slice(readyActionStart, generatingActionStart);
-  assert.match(readyBranch, /全量数据附录/);
-  assert.doesNotMatch(reportCenterSource.slice(generatingActionStart), /全量数据附录/);
+  assert.match(readyBranch, /PERSONAL_REPORT_EXPORT_LABEL/);
+  assert.doesNotMatch(reportCenterSource.slice(generatingActionStart), /PERSONAL_REPORT_EXPORT_LABEL/);
 });
diff --git a/frontend/tests/personal-report-export.test.ts b/frontend/tests/personal-report-export.test.ts
index a104aabc..20c9ed47 100644
--- a/frontend/tests/personal-report-export.test.ts
+++ b/frontend/tests/personal-report-export.test.ts
@@ -89,12 +89,10 @@ test("client export never touches a server PDF pipeline", () => {
 });
 
 
-test("native print uses the same validated structured DOM for stored v1 and current v2", () => {
-  assert.match(pageSource, /safeParseReportDocument\(json\.reportDocument\)/);
-  assert.match(pageSource, /<PersonalReportDocumentView document=\{document\} \/>/);
-  assert.match(documentViewSource, /isReportDocumentV2\(document\)/);
-  assert.match(documentViewSource, /<VedicChartSvg chart=\{structuredChart\(chart\)\}/);
+test("native print remains a secondary action on the Markdown report page", () => {
+  assert.match(pageSource, /longformMarkdown/);
+  assert.match(pageSource, /PersonalReportMarkdownView/);
+  assert.doesNotMatch(pageSource, /PersonalReportDocumentView/);
   assert.doesNotMatch(documentViewSource, /dangerouslySetInnerHTML|srcDoc|<iframe/i);
-  assert.doesNotMatch(documentViewSource, /modelHtml|modelCss|modelSvg/i);
   assert.match(exportSource, /window\.print/);
 });
diff --git a/frontend/tests/personal-report-longform-md.test.ts b/frontend/tests/personal-report-longform-md.test.ts
new file mode 100644
index 00000000..6ca57608
--- /dev/null
+++ b/frontend/tests/personal-report-longform-md.test.ts
@@ -0,0 +1,147 @@
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import test from "node:test";
+import React from "react";
+import { renderToStaticMarkup } from "react-dom/server";
+
+import { PersonalReportMarkdownView } from "../src/components/personal-report/personal-report-markdown-view.tsx";
+import { buildLongformCoverDocument } from "../src/lib/personal-report-longform-cover.ts";
+import {
+  PERSONAL_REPORT_EXPORT_LABEL,
+  PERSONAL_REPORT_GENERATING_COPY,
+  PERSONAL_REPORT_LEGACY_PLACEHOLDER,
+} from "../src/lib/personal-report-longform-copy.ts";
+import {
+  buildLongformOutline,
+  extractLongformSummary,
+  personalReportMarkdownFilename,
+} from "../src/lib/personal-report-longform-outline.ts";
+import { PERSONAL_REPORT_WRITER_ENABLED } from "../src/lib/personal-report-writer-flag.ts";
+
+Object.assign(globalThis, { React });
+
+const SAMPLE_MARKDOWN = [
+  "# 个人长报告",
+  "",
+  "## 成品阅读导航",
+  "",
+  "导航正文 blocked",
+  "",
+  "## 摘要",
+  "",
+  "事业方向保持观察，不承诺日期。parameter_sensitive",
+  "",
+  "## 力量章",
+  "",
+  "### 子节",
+  "",
+  "后续章节",
+  "",
+  "## 质量验收矩阵",
+  "",
+  "| 项 | 状态 |",
+  "| --- | --- |",
+  "| MEVG | blocked |",
+].join("\n");
+
+const UNSAFE_MARKDOWN = [
+  SAMPLE_MARKDOWN,
+  "",
+  "## 摘要",
+  "",
+  "事业方向保持观察。",
+  "",
+  "<script>alert(1)</script>",
+  "<img src=\"https://evil.example/x.png\">",
+  "[bad](javascript:alert(1))",
+  "",
+  "| 月 | KP |",
+  "| --- | --- |",
+  "| 2026-01 | blocked |",
+].join("\n");
+
+test("report centre cards read the stored Markdown excerpt, not a writer summary field name", () => {
+  const listRoute = readFileSync(new URL("../src/app/api/reports/route.ts", import.meta.url), "utf8");
+  assert.match(listRoute, /card_summary:report_document->executiveSummary->>summary/);
+  const coverSource = readFileSync(
+    new URL("../src/lib/personal-report-longform-cover.ts", import.meta.url),
+    "utf8",
+  );
+  assert.match(coverSource, /extractLongformSummary/);
+});
+
+test("writer pipeline stays in the tree but is feature-off", () => {
+  assert.equal(PERSONAL_REPORT_WRITER_ENABLED, false);
+  assert.equal(PERSONAL_REPORT_EXPORT_LABEL, "导出报告（.md）");
+  assert.equal(PERSONAL_REPORT_LEGACY_PLACEHOLDER, "旧版本报告，请重新生成");
+  assert.match(PERSONAL_REPORT_GENERATING_COPY, /10–30 秒/);
+});
+
+test("outline lifts navigation and summary to the first screen", () => {
+  const outline = buildLongformOutline(SAMPLE_MARKDOWN);
+  assert.ok(outline.headings.some((heading) => heading.title === "成品阅读导航"));
+  assert.ok(outline.headings.some((heading) => heading.title === "摘要"));
+  assert.match(outline.leadMarkdown, /成品阅读导航/);
+  assert.match(outline.leadMarkdown, /事业方向保持观察/);
+  assert.equal(outline.sections.some((section) => section.eager && section.title === "成品阅读导航"), true);
+  assert.equal(outline.sections.some((section) => section.eager && section.title === "摘要"), true);
+});
+
+test("card excerpt comes from the Markdown 摘要 section", () => {
+  const excerpt = extractLongformSummary(SAMPLE_MARKDOWN, 80);
+  assert.match(excerpt, /事业方向保持观察/);
+  assert.doesNotMatch(excerpt, /executiveSummary/);
+  assert.equal(personalReportMarkdownFilename("2026-09-06T08:00:00.000Z"), "个人报告-2026-09-06");
+});
+
+test("cover document parses and stores the Markdown excerpt", () => {
+  const document = buildLongformCoverDocument({
+    report: {
+      id: "123e4567-e89b-12d3-a456-426614174000",
+      reportType: "personal_full",
+      presentationMode: "default",
+      depth: "standard",
+      requestedThemes: ["career", "wealth"],
+      skillName: "jyotish-vedic-astrology",
+      skillVersion: "6.9.14",
+      skillSourceCommit: null,
+      skillSnapshotSha256: "ab".repeat(32),
+    },
+    subject: {
+      displayName: "测试",
+      birthTimeStatus: "accepted",
+      birthPlaceLabel: "测试地点",
+    },
+    markdown: SAMPLE_MARKDOWN,
+    generatedAt: "2026-09-06T00:00:00.000Z",
+  });
+  assert.equal(document.schemaVersion, "report_document.v2");
+  assert.match(document.executiveSummary.summary, /事业方向保持观察/);
+  assert.equal(document.blockedConflictDisclosure.length, 2);
+  assert.equal(document.thematicNarrative.length, 0);
+});
+
+test("markdown view escapes HTML, skips images, and wraps wide tables", () => {
+  const started = Date.now();
+  const markup = renderToStaticMarkup(React.createElement(PersonalReportMarkdownView, { markdown: UNSAFE_MARKDOWN }));
+  const elapsed = Date.now() - started;
+  assert.ok(elapsed < 1500, `first paint ${elapsed}ms`);
+  assert.match(markup, /personal-report-toc/);
+  assert.match(markup, /成品阅读导航/);
+  assert.match(markup, /parameter_sensitive/);
+  assert.match(markup, /blocked/);
+  assert.match(markup, /markdown-table personal-report-table-wrap/);
+  assert.doesNotMatch(markup, /<script/i);
+  assert.doesNotMatch(markup, /<img/i);
+  assert.doesNotMatch(markup, /javascript:/i);
+  assert.doesNotMatch(markup, /evil\.example/);
+
+  const viewSource = readFileSync(
+    new URL("../src/components/personal-report/personal-report-markdown-view.tsx", import.meta.url),
+    "utf8",
+  );
+  assert.match(viewSource, /skipHtml/);
+  assert.match(viewSource, /remarkGfm/);
+  assert.doesNotMatch(viewSource, /rehype-raw/);
+  assert.doesNotMatch(viewSource, /dangerouslySetInnerHTML/);
+});
diff --git a/frontend/tests/personal-report-view.test.ts b/frontend/tests/personal-report-view.test.ts
index f8bd8881..dd7ab1f7 100644
--- a/frontend/tests/personal-report-view.test.ts
+++ b/frontend/tests/personal-report-view.test.ts
@@ -320,17 +320,17 @@ test("GET envelope classification: 401/404/ready/generating/failed/invalid (real
 
   const ready = classifyReportEnvelope(200, {
     report: view("ready"),
-    reportDocument: canonicalFixture,
+    longformMarkdown: "# 个人长报告\n\n### 解读摘要\n正文",
   });
-  assert.equal(ready.phase, "ready");
-  assert.ok(ready.phase === "ready" && ready.document.reportId === canonicalFixture.reportId);
+  assert.equal(ready.phase, "markdown-ready");
+  assert.ok(ready.phase === "markdown-ready" && ready.markdown.includes("解读摘要"));
 
   const readyV2 = classifyReportEnvelope(200, {
     report: view("ready"),
+    longformMarkdown: "## 成品阅读导航\n导航",
     reportDocument: canonicalV2Fixture,
   });
-  assert.equal(readyV2.phase, "ready");
-  assert.ok(readyV2.phase === "ready" && readyV2.document.schemaVersion === "report_document.v2");
+  assert.equal(readyV2.phase, "markdown-ready");
 
   assert.deepEqual(classifyReportEnvelope(200, { report: view("generating") }), { phase: "generating" });
   assert.deepEqual(classifyReportEnvelope(200, { report: view("failed", "model_unavailable") }), {
@@ -357,13 +357,13 @@ test("GET envelope classification: 401/404/ready/generating/failed/invalid (real
   assert.deepEqual(classifyReportEnvelope(500, {}), { phase: "failed", failureCode: null });
 
   const missingDocument = classifyReportEnvelope(200, { report: view("ready") });
-  assert.equal(missingDocument.phase, "invalid");
+  assert.equal(missingDocument.phase, "legacy-unavailable");
 
   const badDocument = classifyReportEnvelope(200, {
     report: view("ready"),
     reportDocument: { schemaVersion: "wrong" },
   });
-  assert.equal(badDocument.phase, "invalid");
+  assert.equal(badDocument.phase, "legacy-unavailable");
 
   const unknownStatus = classifyReportEnvelope(200, { report: view("mystery") });
   assert.equal(unknownStatus.phase, "invalid");
@@ -409,11 +409,11 @@ test("ready reports expose the browser print/PDF action with capability and hydr
   );
   assert.match(actionsSource, /href="\/reports"/);
   assert.match(actionsSource, /返回报告中心/);
-  assert.match(actionsSource, /打印 \/ 保存为 PDF/);
-  assert.match(actionsSource, /全量数据附录/);
+  assert.match(actionsSource, /PERSONAL_REPORT_EXPORT_LABEL/);
+  assert.match(actionsSource, /PERSONAL_REPORT_PRINT_LABEL/);
   assert.match(actionsSource, /downloadPersonalReportLongformAppendix/);
   assert.match(actionsSource, /printPersonalReport/);
   assert.match(actionsSource, /Printer/);
   assert.match(actionsSource, /useSyncExternalStore\(subscribePrintCapability, isPrintSupported, \(\) => false\)/);
-  assert.match(actionsSource, /disabled=\{printBusy \|\| appendixBusy \|\| !printSupported\}/);
+  assert.match(actionsSource, /disabled=\{printBusy \|\| exportBusy \|\| !printSupported\}/);
 });
diff --git a/frontend/tests/personal-report-worker.test.ts b/frontend/tests/personal-report-worker.test.ts
index 221d0ce9..e524273b 100644
--- a/frontend/tests/personal-report-worker.test.ts
+++ b/frontend/tests/personal-report-worker.test.ts
@@ -654,6 +654,83 @@ test("retryable durable generation failure does not release before retry exhaust
   assert.deepEqual(harness.billingReleaseReasons, []);
 });
 
+test("zero-token settlement is forwarded after a ready cover document", async () => {
+  const billing: ReportBillingPort = {
+    async reserve() { throw new Error("not used"); },
+    async complete(input) {
+      assert.equal(input.usage.inputTokens, 0);
+      assert.equal(input.usage.outputTokens, 0);
+      assert.equal(input.usage.actualModelId, "model-a");
+      return true;
+    },
+    async release() { throw new Error("release must not run"); },
+  };
+  const harness = createHarness({
+    billing,
+    generate: async () => ({
+      status: "ready",
+      document: READY_DOCUMENT,
+      evidenceHash: "c".repeat(64),
+      usage: { inputTokens: 0, outputTokens: 0, actualModelId: "model-a", modelConfigVersion: 7 },
+    }),
+  });
+  const result = await harness.worker.tick();
+  assert.equal(result.outcome, "ready");
+  assert.equal(harness.billingCompleteCount, 1);
+});
+
+test("zero-token longform settlement completes reserved usage and does not release", async () => {
+  const billing: ReportBillingPort = {
+    async reserve() { throw new Error("not used"); },
+    async complete(input) {
+      assert.equal(input.usage.actualModelId, "catalog-default");
+      assert.equal(input.usage.inputTokens, 0);
+      assert.equal(input.usage.outputTokens, 0);
+      return true;
+    },
+    async release() { throw new Error("release must not run"); },
+  };
+  const harness = createHarness({
+    billing,
+    generate: async () => ({
+      status: "ready",
+      document: READY_DOCUMENT,
+      evidenceHash: "c".repeat(64),
+      usage: { inputTokens: 0, outputTokens: 0, actualModelId: "catalog-default", modelConfigVersion: 1 },
+    }),
+  });
+
+  const result = await harness.worker.tick();
+
+  assert.equal(result.outcome, "ready");
+  assert.equal(harness.billingCompleteCount, 1);
+  assert.deepEqual(harness.billingReleaseReasons, []);
+});
+
+test("billing refuses the unknown model id before the report is marked ready", async () => {
+  const billing: ReportBillingPort = {
+    async reserve() { throw new Error("not used"); },
+    async complete() { throw new Error("complete must not run"); },
+    async release() { return true; },
+  };
+  const harness = createHarness({
+    billing,
+    job: jobRecord({ maxAttempts: 2 }),
+    generate: async () => ({
+      status: "ready",
+      document: READY_DOCUMENT,
+      evidenceHash: "c".repeat(64),
+      usage: { inputTokens: 0, outputTokens: 0, actualModelId: "unknown" },
+    }),
+  });
+
+  const result = await harness.worker.tick();
+
+  assert.equal(result.outcome, "retry_scheduled");
+  assert.equal(harness.report?.status, "generating");
+  assert.equal(harness.billingCompleteCount, 0);
+});
+
 test("instrumentation retains the Skill guard and starts a singleton Node worker loop", () => {
   const instrumentation = readFileSync(new URL("../src/instrumentation.ts", import.meta.url), "utf8");
   const productionAdapter = readFileSync(new URL("../src/lib/personal-report-worker.ts", import.meta.url), "utf8");
@@ -672,6 +749,10 @@ test("instrumentation retains the Skill guard and starts a singleton Node worker
   assert.match(productionAdapter, /jyotishaPersonalReportWorker/);
   assert.match(productionAdapter, /if \(state\.jyotishaPersonalReportWorker\) return/);
   assert.match(productionAdapter, /loadReportCandidateRange/);
+  assert.match(productionAdapter, /generatePersonalReportLongform/);
+  assert.match(productionAdapter, /PERSONAL_REPORT_WRITER_ENABLED/);
+  assert.match(productionAdapter, /inputTokens: 0/);
+  assert.doesNotMatch(productionAdapter, /actualModelId: "unknown"/);
   assert.doesNotMatch(productionAdapter, /from\("agentic_rectification_cases"\)/);
   assert.doesNotMatch(productionAdapter, /from\("birth_time_rectification_cases"\)/);
   assert.doesNotMatch(productionAdapter, /after\s*\(/);
diff --git a/frontend/tests/professional-report-reference-route.test.ts b/frontend/tests/professional-report-reference-route.test.ts
index aea16df3..5b024700 100644
--- a/frontend/tests/professional-report-reference-route.test.ts
+++ b/frontend/tests/professional-report-reference-route.test.ts
@@ -11,14 +11,14 @@ const routeSource = readFileSync(
 
 const frontendRoot = fileURLToPath(new URL("../", import.meta.url));
 
-function executeReadyReportExport() {
+function executeReadyReportExport(cached: boolean) {
   const script = String.raw`
     import { mock } from "node:test";
     import { pathToFileURL } from "node:url";
     import { Agent } from "@mastra/core/agent";
 
     const moduleUrl = (path) => pathToFileURL(process.cwd() + "/" + path).href;
-    // Node 22 ignores the unsupported exports mock option; keep the route aliases explicit.
+    const cached = ${cached ? "true" : "false"};
     mock.module("@/lib/personal-report-entitlement", { namedExports: {
       checkSameOrigin: () => ({ ok: true }),
       resolveAllowedReportOrigins: () => [],
@@ -28,36 +28,27 @@ function executeReadyReportExport() {
         getOwnedById: async () => ({ status: "ready", requestId: "123e4567-e89b-12d3-a456-426614174111" }),
       }),
     }});
-    mock.module("@/lib/supabase/admin", { namedExports: {
-      createAdminSupabaseClient: () => { throw new Error("admin unused in this unit test"); },
-    }});
-    mock.module("@/lib/report-candidate-range", { namedExports: {
-      loadReportCandidateRange: async () => null,
-    }});
     mock.module("@/lib/personal-report-longform-appendix", { namedExports: {
       LONGFORM_APPENDIX_TABLE: "personal_report_longform_appendices",
-      parseLongformAppendixRow: () => null,
+      parseLongformAppendixRow: () => cached
+        ? { status: "ready", markdown: "# Professional reference" }
+        : null,
       nextLongformAppendixState: () => ({ status: "ready", attemptCount: 0, markdown: "# Professional reference", contentSha256: "ab", lastErrorCode: null }),
     }});
+    mock.module("@/lib/personal-report-longform-copy", { namedExports: {
+      PERSONAL_REPORT_LEGACY_PLACEHOLDER: "旧版本报告，请重新生成",
+    }});
     mock.module("@/lib/supabase/config", { namedExports: {
       isSupabaseConfigurationError: () => false,
     }});
-    const profileQuery = {
-      select() { return this; },
-      eq() { return this; },
-      async maybeSingle() { return { data: {
-        birth_date: "1990-01-02",
-        reported_birth_time: "03:04",
-        latitude: 39.9,
-        longitude: 116.4,
-        timezone_offset: 8,
-        ayanamsa: "lahiri",
-      }, error: null }; },
-    };
     mock.module("@/lib/supabase/server", { namedExports: {
       createServerSupabaseClient: async () => ({
         auth: { getUser: async () => ({ data: { user: { id: "user-1" } }, error: null }) },
-        from: () => profileQuery,
+        from: () => ({
+          select() { return this; },
+          eq() { return this; },
+          async maybeSingle() { return { data: cached ? { markdown: "# Professional reference" } : null, error: null }; },
+        }),
       }),
     }});
 
@@ -72,15 +63,8 @@ function executeReadyReportExport() {
     };
     const upstream = [];
     globalThis.fetch = async (input, init) => {
-      upstream.push({
-        url: String(input),
-        method: init?.method,
-        body: JSON.parse(String(init?.body)),
-      });
-      return new Response(JSON.stringify({ format: "markdown", markdown: "# Professional reference" }), {
-        status: 200,
-        headers: { "content-type": "application/json" },
-      });
+      upstream.push({ url: String(input), method: init?.method });
+      throw new Error("cache-only export must not call the engine");
     };
 
     const { POST } = await import(moduleUrl("src/app/api/reports/[reportId]/professional-reference/route.ts"));
@@ -110,10 +94,10 @@ function executeReadyReportExport() {
   assert.equal(result.status, 0, result.stderr || result.stdout);
   return JSON.parse(result.stdout.trim()) as {
     status: number;
-    body: { format: string; markdown: string };
+    body: Record<string, unknown>;
     modelCalls: number;
     telemetryEvents: number;
-    upstream: Array<{ url: string; method: string; body: Record<string, unknown> }>;
+    upstream: Array<{ url: string; method: string }>;
   };
 }
 
@@ -128,54 +112,35 @@ test("professional reference route authenticates, checks origin, owner and ready
   assert.match(routeSource, /status: 403/);
   assert.match(routeSource, /status: 404/);
   assert.match(routeSource, /status: 409/);
+  assert.match(routeSource, /status: 410/);
 });
 
-test("birth data stays server-owned and the route calls only the public Python export", () => {
-  assert.match(routeSource, /\.from\("profiles"\)/);
-  assert.match(routeSource, /select\(ACCOUNT_BIRTH_SELECT\)/);
-  assert.match(routeSource, /globalBirthProfileFromAccountRow/);
-  assert.match(routeSource, /\/api\/professional_report_reference/);
-  assert.match(routeSource, /format: "markdown"/);
-  assert.match(routeSource, /packs: \["full"\]/);
-  assert.match(routeSource, /target_year/);
-  assert.match(routeSource, /birth_time_accuracy/);
-  assert.match(routeSource, /loadReportCandidateRange/);
+test("ready export is cache-only and never calls the writer or Python engine", () => {
   assert.match(routeSource, /LONGFORM_APPENDIX_TABLE/);
   assert.match(routeSource, /from "@\/lib\/personal-report-longform-appendix"/);
+  assert.match(routeSource, /PERSONAL_REPORT_LEGACY_PLACEHOLDER/);
   assert.doesNotMatch(routeSource, /request\.json\(/);
   assert.doesNotMatch(routeSource, /mastra|writer|billing|personal_report_sections/i);
   assert.doesNotMatch(routeSource, /from\("personal_reports"\)/);
+  assert.doesNotMatch(routeSource, /\/api\/professional_report_reference/);
+  assert.doesNotMatch(routeSource, /\.from\("profiles"\)/);
+  assert.doesNotMatch(routeSource, /loadReportCandidateRange/);
 });
 
-test("ready report export calls the Python endpoint without model calls or writer telemetry", () => {
-  const result = executeReadyReportExport();
+test("cached appendix returns markdown without model or engine calls", () => {
+  const result = executeReadyReportExport(true);
   assert.equal(result.status, 200);
   assert.deepEqual(result.body, { format: "markdown", markdown: "# Professional reference" });
   assert.equal(result.modelCalls, 0);
   assert.equal(result.telemetryEvents, 0);
-  assert.equal(result.upstream.length, 1);
-  assert.equal(result.upstream[0].url, "http://127.0.0.1:5200/api/professional_report_reference");
-  assert.equal(result.upstream[0].method, "POST");
-  assert.equal(result.upstream[0].body.year, 1990);
-  assert.equal(result.upstream[0].body.month, 1);
-  assert.equal(result.upstream[0].body.day, 2);
-  assert.equal(result.upstream[0].body.hour, 3);
-  assert.equal(result.upstream[0].body.minute, 4);
-  assert.equal(result.upstream[0].body.lat, 39.9);
-  assert.equal(result.upstream[0].body.lon, 116.4);
-  assert.equal(result.upstream[0].body.tz, 8);
-  assert.equal(result.upstream[0].body.ayanamsa, "lahiri");
-  assert.equal(result.upstream[0].body.format, "markdown");
-  assert.deepEqual(result.upstream[0].body.packs, ["full"]);
-  assert.match(String(result.upstream[0].body.today), /^\d{4}-\d{2}-\d{2}$/);
-  assert.equal(result.upstream[0].body.target_year, Number(String(result.upstream[0].body.today).slice(0, 4)));
-  assert.equal(result.upstream[0].body.age, Number(result.upstream[0].body.target_year) - 1990);
-  assert.equal(result.upstream[0].body.birth_time_accuracy, "confirmed");
-  assert.equal(result.upstream[0].body.candidate_range, undefined);
+  assert.equal(result.upstream.length, 0);
 });
 
-test("busy upstream responses preserve 429 and Retry-After", () => {
-  assert.match(routeSource, /upstream\.status/);
-  assert.match(routeSource, /upstream\.headers\.get\("retry-after"\)/);
-  assert.match(routeSource, /"Retry-After": retryAfter/);
+test("missing appendix is a retired report, not an on-demand generation", () => {
+  const result = executeReadyReportExport(false);
+  assert.equal(result.status, 410);
+  assert.equal(result.body.error, "旧版本报告，请重新生成");
+  assert.equal(result.body.code, "legacy_report");
+  assert.equal(result.modelCalls, 0);
+  assert.equal(result.upstream.length, 0);
 });
diff --git a/frontend/tests/report-polling-contract.test.ts b/frontend/tests/report-polling-contract.test.ts
index ab74f1cd..a6eae5b3 100644
--- a/frontend/tests/report-polling-contract.test.ts
+++ b/frontend/tests/report-polling-contract.test.ts
@@ -101,7 +101,8 @@ test("elapsed wait is rendered in Simplified Chinese minutes and seconds", () =>
   // Original assertion required the fixed generating copy. Task 4 intentionally
   // replaces it with phase-aware progress text while retaining the spinner.
   assert.match(pageSource, /<InlineSpinner className="text-primary" size=\{32\} \/>/);
-  assert.match(pageSource, /generating \? \(progressLabel \?\? "报告正在生成中，请稍候…"\)/);
+  assert.match(pageSource, /PERSONAL_REPORT_GENERATING_COPY/);
+  assert.doesNotMatch(pageSource, /章节/);
   assert.match(pageSource, /已等待 \{formatWaitedDuration\(waitedMs\)\}/);
 });
 
diff --git a/frontend/tests/server-owned-birth-profile.test.ts b/frontend/tests/server-owned-birth-profile.test.ts
index 3be8ef6e..43e5f430 100644
--- a/frontend/tests/server-owned-birth-profile.test.ts
+++ b/frontend/tests/server-owned-birth-profile.test.ts
@@ -83,7 +83,7 @@ test("daily and synastry routes share a literal account-birth select string", ()
   const synastry = readFileSync(new URL("../src/app/api/synastry/route.ts", import.meta.url), "utf8");
   assert.equal(
     ACCOUNT_BIRTH_SELECT,
-    "name,birth_date,reported_birth_time,active_birth_time,birth_time,birth_time_status,country_code,province_code,city_code,district_code,latitude,longitude,timezone_offset,timezone_id,ayanamsa",
+    "name,birth_date,reported_birth_time,active_birth_time,birth_time,birth_time_status,birth_time_source,country_code,province_code,city_code,district_code,latitude,longitude,timezone_offset,timezone_id,ayanamsa,birth_place_label,uncertainty_before_minutes,uncertainty_after_minutes,declared_window_start,declared_window_end",
   );
   assert.match(daily, /select\(ACCOUNT_BIRTH_SELECT\)/);
   assert.match(synastry, /select\(ACCOUNT_BIRTH_SELECT\)/);
diff --git a/scripts/jyotish_api_server.py b/scripts/jyotish_api_server.py
index fca8aca0..ec9eeb48 100644
--- a/scripts/jyotish_api_server.py
+++ b/scripts/jyotish_api_server.py
@@ -4788,6 +4788,11 @@ class JyotishAPIHandler(BaseHTTPRequestHandler):
             'declared_window_end': body.get('declared_window_end'),
             'uncertainty_before_minutes': body.get('uncertainty_before_minutes'),
             'uncertainty_after_minutes': body.get('uncertainty_after_minutes'),
+            'birthplace_label': body.get('birthplace_label'),
+            'coordinate_source': body.get('coordinate_source'),
+            'coordinate_precision': body.get('coordinate_precision') or 'unverified_user_coordinates',
+            'time_source': body.get('time_source'),
+            'uncertainty_minutes': body.get('uncertainty_minutes'),
         }
 
     def _high_rigor_requested_themes(self, body):
diff --git a/scripts/jyotish_engine.py b/scripts/jyotish_engine.py
index 196b7539..88e4c40e 100644
--- a/scripts/jyotish_engine.py
+++ b/scripts/jyotish_engine.py
@@ -1988,27 +1988,22 @@ def _attach_annual_tajika_pack(packet: dict, args) -> dict:
         target_year = int(target_year)
     except (TypeError, ValueError):
         return packet
-    def _annual_series_surface(annual_pack: dict) -> dict:
-        """Keep independently calculated annual evidence without duplicating full replay payloads."""
-        surface = {
-            key: _json_safe_report_snapshot(annual_pack.get(key))
-            for key in ('schema', 'status', 'reason', 'profile', 'audit', 'report_sections', 'annual_chart', 'year_lord')
-            if key in annual_pack
-        }
-        surface['status'] = surface.get('status') or 'partial_verified'
-        return surface
 
     annual_years = {str(target_year): _annual_series_surface(timing['annual_tajika_pack'])}
     for year in range(target_year + 1, target_year + 3):
         annual_args = SimpleNamespace(**vars(args))
         annual_args.target_year = year
-        # The primary year keeps its full PyJHora replay. Future years are
-        # independently calculated annual packets, but do not repeat the costly
-        # external replay during a single full-report export.
         try:
-            from annual_tajika_pack import build_annual_tajika_pack
+            birth_year = int(getattr(args, 'year'))
+            annual_args.age = year - birth_year
+        except (TypeError, ValueError):
+            pass
+        try:
             annual_years[str(year)] = _annual_series_surface(
-                build_annual_tajika_pack(_annual_payload_from_args(annual_args, packet.get('calculation_profile') or {}))
+                _build_pl9_full_annual_section(
+                    annual_args,
+                    packet.get('calculation_profile') or {},
+                )
             )
         except Exception as exc:
             annual_years[str(year)] = {
@@ -2323,8 +2318,26 @@ def _build_timing_boundary_attribution(packet: dict) -> dict:
     }
 
 
-def _build_module_execution_audit(packet: dict) -> list[dict]:
+def _iter_audit_modules(packet: dict):
     raw_modules = ((packet.get('raw_full_reading') or {}).get('modules') or {})
+    if isinstance(raw_modules, dict) and raw_modules:
+        yield from raw_modules.items()
+        return
+    worksheets = packet.get('worksheets') if isinstance(packet.get('worksheets'), dict) else {}
+    seen = set()
+    for sheet in worksheets.values():
+        if not isinstance(sheet, dict):
+            continue
+        for key, value in sheet.items():
+            if key in {'summary_card', 'detail_blocks'} or str(key).endswith('_pack'):
+                continue
+            if not isinstance(value, dict) or not value or key in seen:
+                continue
+            seen.add(key)
+            yield key, value
+
+
+def _build_module_execution_audit(packet: dict) -> list[dict]:
     usage_map = packet.get('raw_module_usage_map') if isinstance(packet.get('raw_module_usage_map'), dict) else {}
     profile_id = packet.get('calculation_profile_id') or 'calculation_profile_id_missing'
     input_requirements = {
@@ -2332,8 +2345,7 @@ def _build_module_execution_audit(packet: dict) -> list[dict]:
         'muhurta': 'activity_goal, candidate_datetime_or_range, location, timezone',
     }
     rows = []
-    for module_id in sorted(raw_modules):
-        module = raw_modules[module_id]
+    for module_id, module in _iter_audit_modules(packet):
         if module in (None, '', [], {}):
             continue
         module_data = module if isinstance(module, dict) else {}
@@ -2345,7 +2357,7 @@ def _build_module_execution_audit(packet: dict) -> list[dict]:
         rows.append({
             'module_id': str(module_id),
             'status': status,
-            'producer': module_data.get('source') or module_data.get('method') or 'jyotish_engine.cmd_full_reading',
+            'producer': module_data.get('source') or module_data.get('method') or 'cmd_full_reading',
             'input_profile': profile_id,
             'external_reference_status': 'not_asserted_by_module',
             'report_sections': usage.get('report_sections') or ['原始模块索引与未下沉字段附录'],
@@ -2357,7 +2369,6 @@ def _build_module_execution_audit(packet: dict) -> list[dict]:
 
 
 def _raw_module_usage_map(packet: dict) -> dict:
-    raw_modules = ((packet.get('raw_full_reading') or {}).get('modules') or {})
     section_map = {
         'dasha': '大运与时间主线', 'narayana_dasha': '大运与时间主线',
         'bhrigu_pada_dasha': '大运与时间主线', 'transit_multi_reference': '大运与时间主线',
@@ -2376,7 +2387,7 @@ def _raw_module_usage_map(packet: dict) -> dict:
             'report_sections': [section_map.get(str(module_id), '原始模块索引与未下沉字段附录')],
             'usage_status': 'thematic_or_audit_surface' if str(module_id) in section_map else 'raw_appendix_only',
         }
-        for module_id, module in raw_modules.items()
+        for module_id, module in _iter_audit_modules(packet)
         if module not in (None, '', [], {})
     }
 
@@ -2406,7 +2417,10 @@ def _attach_report_governance_contracts(packet: dict, args) -> dict:
     packet['timing_boundary_attribution'] = _build_timing_boundary_attribution(packet)
     packet['module_execution_audit'] = _build_module_execution_audit(packet)
     ai_pack = ((packet.get('raw_full_reading') or {}).get('ai_prompt_pack') or {})
-    packet['technique_audit_table'] = ai_pack.get('evidence_snapshot', {}).get('technique_audit_table', [])
+    snapshot = ai_pack.get('evidence_snapshot') if isinstance(ai_pack.get('evidence_snapshot'), dict) else {}
+    technique_table = snapshot.get('technique_audit_table') if isinstance(snapshot.get('technique_audit_table'), list) else []
+    packet['technique_audit_table'] = technique_table or _rebuild_technique_audit_table(packet)
+    packet['raw_module_index'] = _build_compact_raw_module_index(packet)
     return packet
 
 
@@ -2557,13 +2571,220 @@ def _native_dasha_family_status(module) -> dict:
 
 def _native_dasha_master_families(modules: dict) -> dict:
     modules = modules if isinstance(modules, dict) else {}
-    return {
-        'vimshottari': _native_dasha_family_status(modules.get('dasha')),
-        'narayana': _native_dasha_family_status(modules.get('narayana_dasha')),
-        'yogini': _native_dasha_family_status(modules.get('yogini_dasha')),
-        'ashtottari': _native_dasha_family_status(modules.get('ashtottari_dasha')),
-        'kala_chakra': _native_dasha_family_status(modules.get('kalachakra_dasha')),
+    mapping = {
+        'vimshottari': modules.get('dasha'),
+        'narayana': modules.get('narayana_dasha'),
+        'yogini': modules.get('yogini_dasha'),
+        'ashtottari': modules.get('ashtottari_dasha'),
+        'kala_chakra': modules.get('kalachakra_dasha'),
     }
+    families = {}
+    for key, module in mapping.items():
+        family = _native_dasha_family_status(module)
+        periods = _normalize_dasha_family_periods(module)
+        if periods:
+            family['periods'] = periods
+        families[key] = family
+    return families
+
+
+def _blocked_planned_section(heading: str, reason_code: str, detail: str = "") -> list[str]:
+    """Emit a planned heading with an explicit blocked reason instead of vanishing."""
+    lines = [heading, '', f"`blocked` / `{reason_code}`"]
+    if detail:
+        lines.append(str(detail).strip())
+    lines.append('')
+    return lines
+
+
+PLANNED_LONGFORM_SECTION_HEADINGS = (
+    '### KP Lord / Sub 原始表（本地计算）',
+    '#### KP 事业结构小表',
+    '#### KP 事业宫位核对（2 / 6 / 10 / 11 宫）',
+    '#### KP 财务结构小表',
+    '#### KP 财务宫位核对（2 / 5 / 9 / 11 宫）',
+    '#### KP 关系结构小表',
+    '#### KP 关系宫位核对（2 / 7 / 11 宫）',
+    '## 逐模块执行与结论追踪审计',
+    '## 完整 Technique Audit Table',
+    '#### Bhava Bala（本地三分量评分）',
+    '#### Yogini Dasha 周期（本地计算）',
+    '#### Narayana Rashi Dasha',
+    '#### Kala Chakra Dasha（本地原始周期，冲突保留）',
+    '#### Kala Chakra 深度差异诊断',
+    '#### Kala Chakra 参考对齐',
+    '## 原始模块索引与未下沉字段附录',
+    '### Profile-aware Benchmark Boundary',
+)
+
+
+def _normalize_dasha_family_periods(module) -> list:
+    if not isinstance(module, dict):
+        return []
+    periods = module.get('periods')
+    if isinstance(periods, list) and periods:
+        return [row for row in periods if isinstance(row, dict)]
+    major = module.get('major')
+    if isinstance(major, list) and major:
+        normalized = []
+        for row in major:
+            if not isinstance(row, dict):
+                continue
+            normalized.append({
+                **row,
+                'lord': row.get('planet') or row.get('lord'),
+                'start': row.get('start_date') or row.get('start'),
+                'end': row.get('end_date') or row.get('end'),
+                'years': row.get('years'),
+                'raw_period': row,
+            })
+        return normalized
+    timeline = module.get('timeline')
+    if isinstance(timeline, list) and timeline:
+        return [row for row in timeline if isinstance(row, dict)]
+    return []
+
+
+def _annual_series_surface(annual_pack: dict) -> dict:
+    """Keep independently calculated annual evidence, including replay surfaces."""
+    annual_pack = annual_pack if isinstance(annual_pack, dict) else {}
+    keep_keys = (
+        'schema', 'status', 'reason', 'profile', 'audit', 'report_sections',
+        'annual_chart', 'year_lord', 'external_engine_comparison',
+        'patyayini_dasha', 'sahams', 'tajika_yogas', 'muntha',
+    )
+    surface = {
+        key: _json_safe_report_snapshot(annual_pack.get(key))
+        for key in keep_keys
+        if key in annual_pack
+    }
+    surface['status'] = surface.get('status') or 'partial_verified'
+    return surface
+
+
+def _rebuild_technique_audit_table(packet: dict) -> list[dict]:
+    existing = packet.get('technique_audit_table')
+    if isinstance(existing, list) and existing:
+        return existing
+    worksheets = packet.get('worksheets') if isinstance(packet.get('worksheets'), dict) else {}
+    timing = worksheets.get('timing_and_predictive_systems') if isinstance(worksheets.get('timing_and_predictive_systems'), dict) else {}
+    advanced = worksheets.get('advanced_systems') if isinstance(worksheets.get('advanced_systems'), dict) else {}
+    strengths = worksheets.get('strengths_and_scores') if isinstance(worksheets.get('strengths_and_scores'), dict) else {}
+    raw_modules = ((packet.get('raw_full_reading') or {}).get('modules') or {})
+
+    def _row_status(value) -> str:
+        if isinstance(value, dict) and value and not value.get('error'):
+            status = str(value.get('status') or value.get('execution_status') or '').strip().lower()
+            if status in {'blocked', 'error'}:
+                return 'blocked'
+            return 'parameter_sensitive'
+        return 'blocked'
+
+    return [
+        {
+            'technique': 'Vimshottari Dasha',
+            'status': _row_status(timing.get('dasha') or raw_modules.get('dasha')),
+            'source': 'local_module',
+            'note': 'Local timeline only; not event timing truth.',
+        },
+        {
+            'technique': 'Narayana Dasha',
+            'status': _row_status(timing.get('narayana_dasha') or raw_modules.get('narayana_dasha')),
+            'source': 'local_module',
+            'note': 'Age-axis sequence; date-boundary parity unclosed.',
+        },
+        {
+            'technique': 'KP Lord/Sub',
+            'status': _row_status(advanced.get('kp') or raw_modules.get('kp')),
+            'source': 'local_module',
+            'note': 'KP display evidence; exact-cusp promotion remains closed.',
+        },
+        {
+            'technique': 'Functional Benefic/Malefic',
+            'status': _row_status(strengths.get('functional_benefic_malefic') or raw_modules.get('functional_benefic_malefic')),
+            'source': 'local_module',
+            'note': 'Lagna-conditioned classification for this chart.',
+        },
+        {
+            'technique': 'Annual Tajika',
+            'status': _row_status(timing.get('annual_tajika_pack') or timing.get('annual_tajika_series')),
+            'source': 'local_module',
+            'note': 'Independent annual packs; replay remains parameter-sensitive.',
+        },
+        {
+            'technique': 'MEVG / Global Web Evidence',
+            'status': 'blocked',
+            'source': 'not_executed_in_export',
+            'note': 'Deterministic export does not run live web evidence.',
+        },
+        {
+            'technique': 'Real Case Calibration',
+            'status': 'blocked',
+            'source': 'not_executed_in_export',
+            'note': 'No user event file supplied for blind replay.',
+        },
+    ]
+
+
+def _normalize_bhava_bala_module(bhava) -> dict:
+    """Accept house-keyed Shadbala output or a houses list used by the renderer."""
+    if not isinstance(bhava, dict) or not bhava:
+        return {}
+    if isinstance(bhava.get('houses'), list):
+        houses = [row for row in bhava['houses'] if isinstance(row, dict)]
+        return {'houses': houses} if houses else {}
+    houses = []
+    for key, row in bhava.items():
+        if not isinstance(row, dict):
+            continue
+        try:
+            house_no = int(key)
+        except (TypeError, ValueError):
+            house_no = row.get('house')
+        if house_no in (None, ''):
+            continue
+        houses.append({
+            'house': house_no,
+            'sign': row.get('sign'),
+            'lord': row.get('lord'),
+            'score': row.get('score'),
+            'components': row.get('components') if isinstance(row.get('components'), dict) else {
+                'lord_position': row.get('lord_position'),
+                'occupant_influence': row.get('occupant_influence'),
+                'aspect_influence': row.get('aspect_influence'),
+            },
+            'factors': row.get('factors'),
+            'strength': row.get('strength'),
+        })
+    houses.sort(key=lambda item: int(item.get('house') or 0))
+    return {'houses': houses} if houses else {}
+
+
+def _build_compact_raw_module_index(packet: dict) -> list[dict]:
+    usage_map = packet.get('raw_module_usage_map') if isinstance(packet.get('raw_module_usage_map'), dict) else {}
+    rows = []
+    for module_id, module in _iter_audit_modules(packet):
+        if module in (None, '', [], {}):
+            continue
+        module_data = module if isinstance(module, dict) else {}
+        usage = usage_map.get(str(module_id)) if isinstance(usage_map.get(str(module_id)), dict) else {}
+        if isinstance(module, dict):
+            field_names = ', '.join(str(key) for key in sorted(module, key=str))
+            status = module_data.get('status') or module_data.get('execution_status') or 'available'
+        elif isinstance(module, list):
+            field_names = f'list[{len(module)}]'
+            status = 'available'
+        else:
+            field_names = type(module).__name__
+            status = 'available'
+        rows.append({
+            'module_id': str(module_id),
+            'status': status,
+            'usage_status': usage.get('usage_status') or 'raw_appendix_only',
+            'report_sections': usage.get('report_sections') or ['原始模块索引与未下沉字段附录'],
+            'field_names': field_names,
+        })
+    return rows
 
 
 def _build_pl9_full_dasha_section(packet: dict, modules: dict) -> dict:
@@ -3573,11 +3794,17 @@ def render_pl9_markdown(packet: dict) -> str:
         def _profile_aware_benchmark_appendix() -> list[str]:
             dashboard_path = Path(ROOT_DIR) / 'references/oracle/profile_aware_benchmark_boundary_dashboard_2026_08_27.json'
             if not dashboard_path.exists():
-                return []
+                return _blocked_planned_section(
+                    '### Profile-aware Benchmark Boundary',
+                    'profile_aware_benchmark_dashboard_missing',
+                )
             try:
                 dashboard = json.loads(dashboard_path.read_text(encoding='utf-8'))
             except Exception:
-                return []
+                return _blocked_planned_section(
+                    '### Profile-aware Benchmark Boundary',
+                    'profile_aware_benchmark_dashboard_missing',
+                )
             production = dashboard.get('production_readiness') if isinstance(dashboard.get('production_readiness'), dict) else {}
             profiles = dashboard.get('profiles') if isinstance(dashboard.get('profiles'), list) else []
             capability_rows = dashboard.get('capability_rows') if isinstance(dashboard.get('capability_rows'), list) else []
@@ -3585,7 +3812,10 @@ def render_pl9_markdown(packet: dict) -> str:
             jhora_pending = dashboard.get('jhora_pending_values') if isinstance(dashboard.get('jhora_pending_values'), dict) else {}
             reader_view = dashboard.get('reader_view') if isinstance(dashboard.get('reader_view'), dict) else {}
             if not profiles and not capability_rows:
-                return []
+                return _blocked_planned_section(
+                    '### Profile-aware Benchmark Boundary',
+                    'profile_aware_benchmark_empty',
+                )
             out = [
                 '### Profile-aware Benchmark Boundary',
                 '',
@@ -3718,9 +3948,9 @@ def render_pl9_markdown(packet: dict) -> str:
                 families = _native_dasha_master_families({
                     'dasha': timing_sheet.get('dasha') or modules.get('dasha'),
                     'narayana_dasha': timing_sheet.get('narayana_dasha') or modules.get('narayana_dasha'),
-                    'yogini_dasha': modules.get('yogini_dasha'),
-                    'ashtottari_dasha': modules.get('ashtottari_dasha'),
-                    'kalachakra_dasha': modules.get('kalachakra_dasha'),
+                    'yogini_dasha': timing_sheet.get('yogini_dasha') or modules.get('yogini_dasha'),
+                    'ashtottari_dasha': timing_sheet.get('ashtottari_dasha') or modules.get('ashtottari_dasha'),
+                    'kalachakra_dasha': timing_sheet.get('kalachakra_dasha') or modules.get('kalachakra_dasha'),
                 })
 
             def _family_status_row(label: str, key: str, confidence_when_executed: str, blocked_text: str) -> None:
@@ -4049,7 +4279,7 @@ def render_pl9_markdown(packet: dict) -> str:
                 if svg:
                     rendered.extend([f'#### {title}', '', svg, ''])
             if not rendered:
-                return []
+                return _blocked_planned_section('### Vargas I', 'varga_atlas_unavailable')
             varga_full = _varga_full_sheet()
             core_chart = packet.get('core_chart') if isinstance(packet.get('core_chart'), dict) else {}
             d1_planets = core_chart.get('planets') if isinstance(core_chart.get('planets'), dict) else {}
@@ -4327,7 +4557,11 @@ def render_pl9_markdown(packet: dict) -> str:
             calculation_profile = kp_pack.get('calculation_profile') if isinstance(kp_pack.get('calculation_profile'), dict) else {}
             effective_settings = calculation_profile.get('effective_settings') if isinstance(calculation_profile.get('effective_settings'), dict) else {}
             if not planets and not houses and not ruling_planets:
-                return []
+                return _blocked_planned_section(
+                    '### KP Lord / Sub 原始表（本地计算）',
+                    'kp_lord_sub_unavailable',
+                    str(kp_pack.get('error') or kp_pack.get('reason') or ''),
+                )
 
             explicit_kp_cusps = kp_pack.get('house_basis') == 'explicit_cusps' or any(
                 isinstance(row, dict) and row.get('cusp_longitude') is not None
@@ -4613,8 +4847,13 @@ def render_pl9_markdown(packet: dict) -> str:
                 significators = row.get('significators') if isinstance(row, dict) and isinstance(row.get('significators'), dict) else {}
                 if significators:
                     rows.append((house, significators))
+            suffix = ' / '.join(str(house) for house in house_numbers)
             if not rows:
-                return []
+                return _blocked_planned_section(
+                    f'#### KP {label}宫位核对（{suffix} 宫）',
+                    'kp_domain_evidence_unavailable',
+                    domain,
+                )
 
             def _cell(value) -> str:
                 if isinstance(value, (list, tuple, set)):
@@ -4874,7 +5113,12 @@ def render_pl9_markdown(packet: dict) -> str:
             ruling_planets = kp_pack.get('ruling_planets') if isinstance(kp_pack.get('ruling_planets'), dict) else {}
             note = _kp_domain_promise_note(domain)
             if not note:
-                return []
+                domain_label = {'career': '事业', 'wealth': '财务', 'relationship': '关系'}.get(domain, '专项')
+                return _blocked_planned_section(
+                    f'#### KP {domain_label}结构小表',
+                    'kp_domain_summary_unavailable',
+                    domain,
+                )
             specs = {
                 'career': ('事业', (2, 6, 10, 11)),
                 'wealth': ('财务', (2, 5, 9, 11)),
@@ -5394,12 +5638,12 @@ def render_pl9_markdown(packet: dict) -> str:
             monthly_pack = _unwrap(advanced_sheet.get('kp_monthly_report')) or {}
             monthly_pack = monthly_pack if isinstance(monthly_pack, dict) else {}
             yearly_highlights = _envelope_list(monthly_pack.get('yearly_highlights'))
-            if not yearly_highlights:
-                return []
             annual_series = _unwrap(timing_sheet.get('annual_tajika_series')) or {}
             annual_series = annual_series if isinstance(annual_series, dict) else {}
             annual_years = _unwrap(annual_series.get('years')) or {}
             annual_years = annual_years if isinstance(annual_years, dict) else {}
+            if not yearly_highlights and not annual_years:
+                return []
             target_year_text = str(annual_target_year) if annual_target_year not in (None, "", [], {}) else ""
             shared_anchor_bits = [
                 _humanize_reader_summary_line(str(annual_field_briefs.get("muntha", ""))).rstrip("。") if isinstance(annual_field_briefs, dict) else "",
@@ -5432,16 +5676,91 @@ def render_pl9_markdown(packet: dict) -> str:
                             labels.append(label)
                 return " / ".join(labels) if labels else "事业 / 财务 / 关系"
 
-            out: list[str] = []
+            def _year_replay_subblocks(annual_pack: dict, year: str) -> list[str]:
+                annual_external = _envelope_dict(annual_pack.get('external_engine_comparison'))
+                pyjhora_replay = _envelope_dict(annual_external.get('pyjhora'))
+                replay_patyayini = _envelope_dict(pyjhora_replay.get('patyayini_dasha'))
+                replay_rows = _envelope_list(replay_patyayini.get('normalized_rows'))
+                replay_sahams = _envelope_dict(pyjhora_replay.get('sahams'))
+                replay_sahams_raw = _envelope_dict(replay_sahams.get('raw'))
+                replay_saham_values = _envelope_dict(replay_sahams_raw.get('sahams'))
+                blocks: list[str] = []
+                if replay_rows:
+                    blocks.extend([
+                        '',
+                        '#### Patyayini Dasha 外部回放（PyJHora/JHora）',
+                        '',
+                        f'{year} 年外部回放只保留原始 tuple 层级；未完成 PL9 p134 对照，所有行保持 pyjhora_behavior_only / not_multiengine_parity。',
+                        '',
+                        '| 序号 | 主层原始代号 | 子层原始代号 | 边界时间（外部 tuple；时区未返回） | 原始时长 | 状态 |',
+                        '|------|--------------|--------------|-------------------------------------|----------|------|',
+                    ])
+                    for row in replay_rows[:72]:
+                        if not isinstance(row, dict):
+                            continue
+                        blocks.append(
+                            f"| {_md_cell(row.get('order'))} | {_md_cell(row.get('main_code'))} | {_md_cell(row.get('sub_code'))} | "
+                            f"{_md_cell(row.get('boundary_display'))} ({_md_cell(row.get('boundary_semantics'))}) | "
+                            f"{_md_cell(row.get('duration_raw'))} | pyjhora_behavior_only / not_multiengine_parity |"
+                        )
+                    blocks.append('')
+                else:
+                    blocks.extend(_blocked_planned_section(
+                        '#### Patyayini Dasha 外部回放（PyJHora/JHora）',
+                        'annual_replay_unavailable',
+                        f'year={year}',
+                    ))
+                if replay_saham_values:
+                    blocks.extend([
+                        '',
+                        '#### 年度 Saham 外部回放（PyJHora/JHora）',
+                        '',
+                        f'{year} 年 PyJHora/JHora 年度返照 Saham 只用于数值交叉核对，不证明年度事件。',
+                        '',
+                        '| Saham（PyJHora 原始 callable） | 星座 | 星座内度数 | 状态 |',
+                        '|------------------------------|------|------------|------|',
+                    ])
+                    for name, longitude in sorted(replay_saham_values.items(), key=lambda item: str(item[0])):
+                        if not isinstance(longitude, (int, float)):
+                            continue
+                        sign = SIGNS[int(float(longitude) // 30) % 12]
+                        label = str(name).removesuffix('_saham').replace('_', ' ').title()
+                        blocks.append(
+                            f"| {_md_cell(label)} | {_md_cell(SIGNS_CN.get(sign) or sign)} | {_degree_text(float(longitude) % 30)} | pyjhora_behavior_only / not_multiengine_parity |"
+                        )
+                    blocks.append('')
+                else:
+                    blocks.extend(_blocked_planned_section(
+                        '#### 年度 Saham 外部回放（PyJHora/JHora）',
+                        'annual_replay_unavailable',
+                        f'year={year}',
+                    ))
+                return blocks
+
+            year_entries: list[tuple[str, list]] = []
+            seen_years: set[str] = set()
             for yearly in yearly_highlights:
+                if not isinstance(yearly, dict):
+                    continue
                 year = str(yearly.get("year") or "").strip()
                 rows = yearly.get("months") if isinstance(yearly.get("months"), list) else []
-                if not year or not rows or year == target_year_text:
+                if not year or year == target_year_text or year in seen_years:
                     continue
+                year_entries.append((year, rows))
+                seen_years.add(year)
+            for year in annual_years:
+                year_text = str(year)
+                if not year_text or year_text == target_year_text or year_text in seen_years:
+                    continue
+                year_entries.append((year_text, []))
+                seen_years.add(year_text)
+            if not year_entries:
+                return []
+
+            out: list[str] = []
+            for year, rows in year_entries:
                 annual_pack = _unwrap(annual_years.get(year)) or {}
                 annual_pack = annual_pack if isinstance(annual_pack, dict) else {}
-                annual_profile = _unwrap(annual_pack.get('profile')) or {}
-                annual_profile = annual_profile if isinstance(annual_profile, dict) else {}
                 annual_sections = _unwrap(annual_pack.get('report_sections')) or {}
                 annual_sections = annual_sections if isinstance(annual_sections, dict) else {}
                 annual_exec = _unwrap(annual_sections.get('executive_summary')) or {}
@@ -5451,13 +5770,15 @@ def render_pl9_markdown(packet: dict) -> str:
                     _humanize_reader_summary_line(str(line)).rstrip('。')
                     for line in annual_lines if line
                 ]
-                focus_months = [str(row.get("month")) for row in rows if row.get("month")]
-                reasons = [str(row.get("reason")).strip() for row in rows if row.get("reason")]
+                focus_months = [str(row.get("month")) for row in rows if isinstance(row, dict) and row.get("month")]
+                reasons = [str(row.get("reason")).strip() for row in rows if isinstance(row, dict) and row.get("reason")]
                 out.extend([f"### {year} 年度重点", ""])
                 out.append(
                     f"这一章沿用 {target_year_text or '当前'} 年度重点模板，但这里真正下沉的是 `annual_tajika_pack` 已给出的年度结构锚点，"
                     f"再叠加 `kp_monthly_report_packet` 的 {year} 年重点月份排序，因此主要服务下一年度的主题优先级安排，继续保持 parameter_sensitive。"
                 )
+                if annual_pack.get('status') == 'blocked':
+                    out.append(f"`blocked` / `{_md_cell(annual_pack.get('reason') or 'independent_annual_packet_failed')}`")
                 if annual_bits:
                     out.append(f"独立年度锚点：{'；'.join(annual_bits[:3])}。")
                 if focus_months:
@@ -5470,6 +5791,7 @@ def render_pl9_markdown(packet: dict) -> str:
                     out.append(
                         "年度边界提醒：" + "、".join(flagged_labels) + " 继续带着 parameter_sensitive / blocked 标签阅读，不把这些锚点直接升级成下一年度已确定事件。"
                     )
+                out.extend(_year_replay_subblocks(annual_pack, year))
                 out.append("")
             return out
 
@@ -6838,7 +7160,11 @@ def render_pl9_markdown(packet: dict) -> str:
             functional = strength_sheet.get('functional_benefic_malefic') if isinstance(strength_sheet.get('functional_benefic_malefic'), dict) else {}
             friendship = strength_sheet.get('planetary_friendship') if isinstance(strength_sheet.get('planetary_friendship'), dict) else {}
             if not shadbala and not bhava_bala and not ashtakavarga and not vimsopaka and not functional and not friendship:
-                return []
+                return [
+                    '### 力量、Ashtakavarga 与功能性吉凶',
+                    '',
+                    *_blocked_planned_section('#### Bhava Bala（本地三分量评分）', 'bhava_bala_unavailable'),
+                ]
             out = [
                 '### 力量、Ashtakavarga 与功能性吉凶',
                 '',
@@ -7050,7 +7376,10 @@ def render_pl9_markdown(packet: dict) -> str:
                             f"{_md_cell(row.get('score'))} | parameter_sensitive |"
                         )
                     out.append('')
-            if vimsopaka:
+                else:
+                    out.extend(_blocked_planned_section('#### Bhava Bala（本地三分量评分）', 'bhava_bala_unavailable'))
+            else:
+                out.extend(_blocked_planned_section('#### Bhava Bala（本地三分量评分）', 'bhava_bala_unavailable'))
                 out.extend([
                     '#### Vimsopaka 十六分盘力量摘要',
                     '',
@@ -7146,9 +7475,22 @@ def render_pl9_markdown(packet: dict) -> str:
 
         def _auxiliary_dasha_section() -> list[str]:
             dasha_master_pack = timing_sheet.get('dasha_master_pack') if isinstance(timing_sheet.get('dasha_master_pack'), dict) else {}
-            families = dasha_master_pack.get('families') if isinstance(dasha_master_pack.get('families'), dict) else {}
-            if not families:
-                return []
+            families = dict(dasha_master_pack.get('families') or {}) if isinstance(dasha_master_pack.get('families'), dict) else {}
+
+            def _overlay_family(family_key: str, native_key: str) -> None:
+                native = timing_sheet.get(native_key) if isinstance(timing_sheet.get(native_key), dict) else {}
+                family = families.get(family_key) if isinstance(families.get(family_key), dict) else {}
+                periods = family.get('periods') if isinstance(family.get('periods'), list) else []
+                if not periods:
+                    periods = _normalize_dasha_family_periods(native)
+                    if periods:
+                        family = {**family, 'periods': periods}
+                        family.setdefault('execution_status', 'executed')
+                families[family_key] = family
+
+            _overlay_family('yogini', 'yogini_dasha')
+            _overlay_family('narayana', 'narayana_dasha')
+            _overlay_family('kala_chakra', 'kalachakra_dasha')
 
             def _period_start(period: dict) -> str:
                 raw = period.get('raw_period') if isinstance(period.get('raw_period'), dict) else {}
@@ -7262,6 +7604,8 @@ def render_pl9_markdown(packet: dict) -> str:
                         f"| {idx} | {_md_cell(yogini_name)} | {_md_cell(_humanize_reader_token(planet))} | {_period_start(period)} | {_period_end(period)} | {_period_years(period)} | parameter_sensitive |"
                     )
                 out.append('')
+            else:
+                out.extend(_blocked_planned_section('#### Yogini Dasha 周期（本地计算）', 'yogini_dasha_unavailable'))
 
             vimshottari = timing_sheet.get('dasha') if isinstance(timing_sheet.get('dasha'), dict) else {}
             vimshottari_timeline = vimshottari.get('timeline') if isinstance(vimshottari.get('timeline'), list) else []
@@ -7880,6 +8224,15 @@ def render_pl9_markdown(packet: dict) -> str:
                             ),
                         ])
                 out.append('')
+            markdown_so_far = '\n'.join(out)
+            for heading, reason in (
+                ('#### Narayana Rashi Dasha', 'narayana_dasha_unavailable'),
+                ('#### Kala Chakra Dasha（本地原始周期，冲突保留）', 'kala_chakra_unavailable'),
+                ('#### Kala Chakra 深度差异诊断', 'kala_chakra_divergence_unavailable'),
+                ('#### Kala Chakra 参考对齐', 'kala_chakra_alignment_unavailable'),
+            ):
+                if heading not in markdown_so_far:
+                    out.extend(_blocked_planned_section(heading, reason))
             return out
 
         def _jaimini_special_section() -> list[str]:
@@ -9535,38 +9888,40 @@ def render_pl9_markdown(packet: dict) -> str:
 
         # Keep every non-empty calculation module discoverable even when it has
         # not yet earned a dedicated thematic section.
-        raw_modules = raw_full_reading.get('modules') if isinstance(raw_full_reading, dict) else {}
-        if isinstance(raw_modules, dict) and raw_modules:
+        raw_module_index = packet.get('raw_module_index') if isinstance(packet.get('raw_module_index'), list) else []
+        if not raw_module_index:
+            raw_modules = raw_full_reading.get('modules') if isinstance(raw_full_reading, dict) else {}
+            if isinstance(raw_modules, dict) and raw_modules:
+                raw_module_index = _build_compact_raw_module_index({
+                    'raw_full_reading': raw_full_reading,
+                    'raw_module_usage_map': raw_module_usage_map,
+                })
+        if raw_module_index:
             lines.extend([
                 '',
                 '## 原始模块索引与未下沉字段附录',
                 '',
-                '本附录逐项登记当前 packet 中的非空原始模块。独立章节已经展开的模块仍保留这里的路径；尚未下沉到正文或专门技术页的模块，明确标为“仅原始附录”，不代表缺失或已升级为主判断证据。完整原始数值保留在同一导出的 JSON packet 的 raw_full_reading.modules 下；Markdown 不重复嵌入 JSON，避免正文与原始负载双重膨胀。',
+                '本附录逐项登记当前 packet 中的非空原始模块。独立章节已经展开的模块仍保留这里的登记；尚未下沉到正文或专门技术页的模块，明确标为“仅原始附录”，不代表缺失或已升级为主判断证据。完整原始数值不嵌入 Markdown，避免正文与原始负载双重膨胀。',
                 '',
-                '| 模块 | 状态 | 原始路径 | 报告使用/结论入口 | 未下沉字段 |',
-                '|------|------|----------|---------------------|------------|',
+                '| 模块 | 状态 | 登记键 | 报告使用/结论入口 | 未下沉字段 |',
+                '|------|------|--------|---------------------|------------|',
             ])
-            for module_id in sorted(raw_modules):
-                module = raw_modules.get(module_id)
-                if module in (None, '', [], {}):
+            for row in raw_module_index:
+                if not isinstance(row, dict):
                     continue
-                if isinstance(module, dict):
-                    status = module.get('status') or module.get('execution_status') or 'available'
-                    field_names = ', '.join(str(key) for key in sorted(module, key=str))
-                elif isinstance(module, list):
-                    status = 'available'
-                    field_names = f'list[{len(module)}]'
-                else:
-                    status = 'available'
-                    field_names = type(module).__name__
-                usage = raw_module_usage_map.get(str(module_id)) if isinstance(raw_module_usage_map.get(str(module_id)), dict) else {}
-                usage_sections = usage.get('report_sections') if isinstance(usage.get('report_sections'), list) else ['原始模块索引与未下沉字段附录']
+                module_id = row.get('module_id')
+                usage_sections = row.get('report_sections') if isinstance(row.get('report_sections'), list) else ['原始模块索引与未下沉字段附录']
                 lines.append(
-                    f"| `{_md_cell(module_id)}` | {_md_cell(status)} | "
-                    f"`raw_full_reading.modules.{_md_cell(module_id)}` | "
-                    f"{_md_cell('；'.join(usage_sections))} | {_md_cell(field_names)} |"
+                    f"| `{_md_cell(module_id)}` | {_md_cell(row.get('status'))} | "
+                    f"`{_md_cell(module_id)}` | "
+                    f"{_md_cell('；'.join(usage_sections))} | {_md_cell(row.get('field_names'))} |"
                 )
             lines.append('')
+        else:
+            lines.extend(_blocked_planned_section(
+                '## 原始模块索引与未下沉字段附录',
+                'raw_module_index_unavailable',
+            ))
 
         lines.extend([
             '',
@@ -9670,7 +10025,13 @@ def render_pl9_markdown(packet: dict) -> str:
             f"- Timing Precision Contract: {_bool_text(bool(ai_audit.get('timing_precision_contract')))}",
         ])
 
-    lines.extend(['', render_pl9_continuation_prompt()])
+        lines.extend(['', render_pl9_continuation_prompt()])
+
+    markdown_so_far = '\n'.join(lines)
+    for heading in PLANNED_LONGFORM_SECTION_HEADINGS:
+        if heading not in markdown_so_far:
+            lines.extend(_blocked_planned_section(heading, 'planned_section_unavailable'))
+            markdown_so_far = '\n'.join(lines)
 
     markdown = '\n'.join(lines).strip() + '\n'
     if isinstance(packet.get('reader_engine_boundary_notice'), dict):
@@ -15714,6 +16075,8 @@ def cmd_full_reading(args):
                     planet.update(get_kp_lords(float(planet.get('degree_raw', 0.0))))
                     planet['r_c'] = ''
         report['modules']['shadbala'] = shadbala_result
+        if isinstance(shadbala_result, dict) and shadbala_result.get('bhava_bala'):
+            report['modules']['bhava_bala'] = _normalize_bhava_bala_module(shadbala_result.get('bhava_bala'))
     except Exception as e:
         report['errors'].append(f"shadbala: {e}")
 
@@ -16604,7 +16967,9 @@ def build_pl9_style_export_packet(full_reading: dict, include_raw: bool = False)
             'shadbala_component_status': shadbala_component_status,
             'pl9_p33_declination_contract': pl9_p33_declination_contract,
             'pl9_p43_44_shadbala_contract': pl9_p43_44_shadbala_contract,
-            'bhava_bala': modules.get('bhava_bala'),
+            'bhava_bala': _normalize_bhava_bala_module(
+                modules.get('bhava_bala') or ((modules.get('shadbala') or {}).get('bhava_bala') if isinstance(modules.get('shadbala'), dict) else {})
+            ),
             'ashtakavarga': modules.get('ashtakavarga'),
             'vimsopaka': modules.get('vimsopaka'),
             'pushkara': modules.get('pushkara'),
@@ -16670,6 +17035,9 @@ def build_pl9_style_export_packet(full_reading: dict, include_raw: bool = False)
             'dasha_sandhi': modules.get('dasha_sandhi'),
             'bhrigu_pada_dasha': modules.get('bhrigu_pada_dasha'),
             'narayana_dasha': modules.get('narayana_dasha'),
+            'yogini_dasha': modules.get('yogini_dasha'),
+            'ashtottari_dasha': modules.get('ashtottari_dasha'),
+            'kalachakra_dasha': modules.get('kalachakra_dasha'),
             'transit_multi_reference': modules.get('transit_multi_reference'),
             'double_transit_pac': modules.get('double_transit_pac'),
             'transit_ll7l': modules.get('transit_ll7l'),
@@ -16874,7 +17242,9 @@ def build_pl9_style_export_packet(full_reading: dict, include_raw: bool = False)
         'strengths_and_scores': {
             'shadbala': modules.get('shadbala'),
             'shadbala_component_status': shadbala_component_status,
-            'bhava_bala': modules.get('bhava_bala'),
+            'bhava_bala': _normalize_bhava_bala_module(
+                modules.get('bhava_bala') or ((modules.get('shadbala') or {}).get('bhava_bala') if isinstance(modules.get('shadbala'), dict) else {})
+            ),
             'ashtakavarga': modules.get('ashtakavarga'),
             'vimsopaka': modules.get('vimsopaka'),
             'pushkara': modules.get('pushkara'),
@@ -16900,6 +17270,9 @@ def build_pl9_style_export_packet(full_reading: dict, include_raw: bool = False)
             'dasha_sandhi': modules.get('dasha_sandhi'),
             'bhrigu_pada_dasha': modules.get('bhrigu_pada_dasha'),
             'narayana_dasha': modules.get('narayana_dasha'),
+            'yogini_dasha': modules.get('yogini_dasha'),
+            'ashtottari_dasha': modules.get('ashtottari_dasha'),
+            'kalachakra_dasha': modules.get('kalachakra_dasha'),
             'transit_multi_reference': modules.get('transit_multi_reference'),
             'double_transit_pac': modules.get('double_transit_pac'),
             'transit_ll7l': modules.get('transit_ll7l'),
@@ -17141,7 +17514,7 @@ def build_professional_report_reference_packet(
     selected_pack_ids: list[str] | None = None,
 ) -> dict:
     """Build the public, non-writer professional reference packet for CLI and API."""
-    packet = build_pl9_style_export_packet(full_reading, include_raw=False)
+    packet = build_pl9_style_export_packet(full_reading, include_raw=True)
     packet = attach_calculation_profile(packet, args)
     packet = _attach_annual_tajika_pack(packet, args)
     packet = _attach_report_governance_contracts(packet, args)
diff --git a/scripts/timing_precision_contract.py b/scripts/timing_precision_contract.py
index 5140d6d0..90eb6237 100644
--- a/scripts/timing_precision_contract.py
+++ b/scripts/timing_precision_contract.py
@@ -1,16 +1,46 @@
 #!/usr/bin/env python3
-"""Honest three-layer timing contract for uncalibrated day/month rankings."""
+"""Honest four-tier timing contract for uncalibrated day/month/year claims."""
 
 from __future__ import annotations
 
 from typing import Any
 
 
+def _tier(
+    *,
+    status: str,
+    allowed_claims: list[str],
+    prohibited_claims: list[str],
+    note: str,
+) -> dict[str, Any]:
+    return {
+        "status": status,
+        "allowed_claims": allowed_claims,
+        "prohibited_claims": prohibited_claims,
+        "note": note,
+    }
+
+
+def _has_annual_series(source: dict[str, Any]) -> bool:
+    annual_series = source.get("annual_series")
+    if isinstance(annual_series, dict):
+        years = annual_series.get("years")
+        if isinstance(years, dict) and years:
+            return True
+        if isinstance(years, list) and years:
+            return True
+    if source.get("annual_tajika_series") or source.get("annual_chart") or source.get("solar_return"):
+        return True
+    return False
+
+
 def build_timing_precision_contract(payload: dict[str, Any] | None = None) -> dict[str, Any]:
     source = payload if isinstance(payload, dict) else {}
     candidates = source.get("candidate_windows") if isinstance(source.get("candidate_windows"), list) else []
     triggers = source.get("exact_triggers") if isinstance(source.get("exact_triggers"), list) else []
     verified_window = source.get("verified_window") or source.get("broad_window")
+    has_annual = _has_annual_series(source)
+    year_status = "partial_verified" if has_annual else "blocked"
     return {
         "timing_precision": "candidate_day_window" if candidates else "broad_window_only",
         "claim_status": "exploratory_unvalidated",
@@ -22,5 +52,35 @@ def build_timing_precision_contract(payload: dict[str, Any] | None = None) -> di
             "required": "new_independently_labeled_day_level_holdout",
             "current_negative_controls_reusable_for_tuning": False,
         },
+        "tiers": {
+            "day": _tier(
+                status="blocked",
+                allowed_claims=[],
+                prohibited_claims=["exact_day_event", "exact_clock_event", "dated_outcome_promise"],
+                note="日级 holdout 未通过，日结论恒 blocked。",
+            ),
+            "week": _tier(
+                status="parameter_sensitive",
+                allowed_claims=["candidate_observation_window"],
+                prohibited_claims=["exact_day_event", "guaranteed_weekly_outcome"],
+                note="周级只可作为候选观察窗，不能升级为确定事件。",
+            ),
+            "month": _tier(
+                status="parameter_sensitive",
+                allowed_claims=["candidate_observation_window"],
+                prohibited_claims=["exact_day_event", "guaranteed_monthly_outcome"],
+                note="月级只可作为候选观察窗，不能升级为确定事件。",
+            ),
+            "year": _tier(
+                status=year_status,
+                allowed_claims=["annual_solar_return_structure"] if has_annual else [],
+                prohibited_claims=["exact_day_event", "year_as_verified_event_calendar"],
+                note=(
+                    "年度返照系列存在时，年结构可标 partial_verified；仍禁止把年层写成已验证事件日历。"
+                    if has_annual
+                    else "缺少年度返照系列，年结论保持 blocked。"
+                ),
+            ),
+        },
         "boundary": "候选日期未通过独立日级 holdout 验证，不能作为确定事件承诺；精确时间仅表示技术触发点。",
     }
diff --git a/tests/test_report_longform_gaps2.py b/tests/test_report_longform_gaps2.py
new file mode 100644
index 00000000..a0dc54f4
--- /dev/null
+++ b/tests/test_report_longform_gaps2.py
@@ -0,0 +1,170 @@
+"""Assembly locks for longform gaps2: no silent skips, audit rows, provenance."""
+
+from __future__ import annotations
+
+from types import SimpleNamespace
+
+from scripts.jyotish_engine import (
+    PLANNED_LONGFORM_SECTION_HEADINGS,
+    _annual_series_surface,
+    _attach_report_governance_contracts,
+    _native_dasha_master_families,
+    render_pl9_markdown,
+    sanitize_professional_report_reference,
+)
+from scripts.timing_precision_contract import build_timing_precision_contract
+from tests.test_report_longform_parity import BEIJING, _producer_packet
+
+
+def test_kp_error_pack_emits_blocked_heading_instead_of_vanishing() -> None:
+    markdown = render_pl9_markdown(_producer_packet({
+        "advanced_systems": {"kp": {"error": "synthetic_kp_failure", "status": "blocked"}},
+    }))
+    assert "### KP Lord / Sub 原始表（本地计算）" in markdown
+    assert "kp_lord_sub_unavailable" in markdown
+    assert "#### KP 事业结构小表" in markdown
+    assert "#### KP 事业宫位核对（2 / 6 / 10 / 11 宫）" in markdown
+    assert "#### KP 财务结构小表" in markdown
+    assert "#### KP 关系结构小表" in markdown
+
+
+def test_planned_headings_are_present_or_blocked_on_empty_packet() -> None:
+    markdown = render_pl9_markdown(_producer_packet({}))
+    missing = [heading for heading in PLANNED_LONGFORM_SECTION_HEADINGS if heading not in markdown]
+    assert missing == [], f"planned headings vanished: {missing}"
+
+
+def test_module_execution_audit_survives_raw_strip() -> None:
+    packet = {
+        "raw_full_reading": {
+            "modules": {
+                "kp": {"planets": {"Sun": {}}, "status": "available"},
+                "dasha": {"current_dasha": {"lord": "Saturn"}},
+                "shadbala": {"planets": {"Sun": {}}},
+            },
+            "ai_prompt_pack": {},
+        },
+        "worksheets": {},
+    }
+    packet = _attach_report_governance_contracts(packet, SimpleNamespace(**BEIJING))
+    sanitized = sanitize_professional_report_reference(packet)
+    assert "raw_full_reading" not in sanitized
+    assert len(sanitized["module_execution_audit"]) >= 3
+    assert len(sanitized["technique_audit_table"]) >= 5
+    assert any(row.get("module_id") == "kp" for row in sanitized["module_execution_audit"])
+    assert any(row.get("technique") == "KP Lord/Sub" for row in sanitized["technique_audit_table"])
+    markdown = render_pl9_markdown(_producer_packet({}) | {
+        "module_execution_audit": sanitized["module_execution_audit"],
+        "technique_audit_table": sanitized["technique_audit_table"],
+        "raw_module_index": sanitized["raw_module_index"],
+    })
+    data_rows = [
+        line for line in markdown.splitlines()
+        if line.startswith("| `kp`") or line.startswith("| `dasha`") or line.startswith("| `shadbala`")
+    ]
+    assert len(data_rows) >= 3
+
+
+def test_timing_contract_tiers_do_not_default_all_blocked_when_annual_exists() -> None:
+    contract = build_timing_precision_contract({
+        "annual_series": {"years": {"2026": {}, "2027": {}, "2028": {}}},
+    })
+    assert contract["tiers"]["day"]["status"] == "blocked"
+    assert contract["tiers"]["week"]["status"] == "parameter_sensitive"
+    assert contract["tiers"]["month"]["status"] == "parameter_sensitive"
+    assert contract["tiers"]["year"]["status"] == "partial_verified"
+    assert contract["tiers"]["week"]["allowed_claims"]
+    assert "exact_day_event" in contract["tiers"]["day"]["prohibited_claims"]
+
+
+def test_birth_provenance_reads_optional_args() -> None:
+    packet = _attach_report_governance_contracts(
+        {"worksheets": {}, "raw_full_reading": {"modules": {}}},
+        SimpleNamespace(
+            **BEIJING,
+            birthplace_label="测试市",
+            coordinate_source="user_reported",
+            coordinate_precision="unverified_user_coordinates",
+            time_source="user_reported",
+            uncertainty_minutes=20,
+        ),
+    )
+    provenance = packet["birth_provenance"]
+    assert provenance["birthplace_label"] == "测试市"
+    assert provenance["coordinate_source"] == "user_reported"
+    assert provenance["time_source"] == "user_reported"
+    assert provenance["uncertainty_minutes"] == 20
+
+
+def test_annual_series_surface_keeps_replay_keys() -> None:
+    surface = _annual_series_surface({
+        "status": "partial_verified",
+        "profile": {"target_year": 2027},
+        "external_engine_comparison": {"pyjhora": {"patyayini_dasha": {"normalized_rows": [{"order": 1}]}}},
+        "sahams": {"status": "parameter_sensitive"},
+    })
+    assert "external_engine_comparison" in surface
+    assert surface["external_engine_comparison"]["pyjhora"]["patyayini_dasha"]["normalized_rows"]
+    assert surface["sahams"]["status"] == "parameter_sensitive"
+
+
+def test_native_dasha_families_expose_execution_status() -> None:
+    families = _native_dasha_master_families({
+        "dasha": {"current_dasha": {"lord": "Saturn"}},
+        "narayana_dasha": {"status": "computed"},
+        "yogini_dasha": {"major": [{"yogini": "Mangala", "planet": "Moon", "years": 1}]},
+        "kalachakra_dasha": {"status": "computed", "periods": [{"lord": "Sun"}]},
+    })
+    assert families["vimshottari"]["execution_status"] == "executed"
+    assert families["yogini"]["execution_status"] == "executed"
+    assert families["kala_chakra"]["execution_status"] == "executed"
+
+
+def test_auxiliary_dasha_headings_render_from_native_modules() -> None:
+    markdown = render_pl9_markdown(_producer_packet({
+        "timing_and_predictive_systems": {
+            "narayana_dasha": {
+                "lagna_sign": "Aries",
+                "periods": [{
+                    "sign": "Aries",
+                    "lord": "Mars",
+                    "start": "0",
+                    "end": "1",
+                    "years": 1,
+                }],
+            },
+            "yogini_dasha": {
+                "major": [{
+                    "yogini": "Mangala",
+                    "planet": "Moon",
+                    "years": 1,
+                    "start_date": "1990-01-01",
+                    "end_date": "1991-01-01",
+                }],
+            },
+            "kalachakra_dasha": {
+                "periods": [{
+                    "lord": "Sun",
+                    "sign": "Aries",
+                    "start": "1990-01-01",
+                    "end": "1991-01-01",
+                    "years": 1,
+                }],
+            },
+        },
+        "strengths_and_scores": {
+            "bhava_bala": {
+                "houses": [{
+                    "house": 1,
+                    "sign": "Aries",
+                    "lord": "Mars",
+                    "score": 1,
+                    "components": {"lord_position": 1, "occupant_influence": 0, "aspect_influence": 0},
+                }],
+            },
+        },
+    }))
+    assert "#### Yogini Dasha 周期（本地计算）" in markdown
+    assert "#### Narayana Rashi Dasha" in markdown
+    assert "#### Kala Chakra Dasha（本地原始周期，冲突保留）" in markdown
+    assert "#### Bhava Bala（本地三分量评分）" in markdown