chore(import): 终验三处一行补完——fact-12 JSDoc 分层和解、flush 措辞、tsbuildignore

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

apps/api/src/modules/import/content-writer.ts

@@ -31,8 +31,9 @@
 //
 // unsupported/error 也写 source_records（前置事实 12）：parse_status='unsupported'/'failed'、
 // locale=站点默认、不关联 entry——"不支持对象有明确结果"的可审计性；postId 缺失时
-// source_id 以 rawLocation 回退（**不硬造**身份）。这两类是预期输入不是问题——行与计数
-// 即审计，不推 issue（job 不因此 succeeded_with_issues）。
+// source_id 以 rawLocation 回退（**不硬造**身份）。这两类是预期输入——写入器侧不推
+// issue；Task 6 起编排层将 reason/issue 归档 adapter 组（进 report.issues，终态随之
+// succeeded_with_issues——两层纪律有意分层）。
 //
 // 事务边界（ctx.db 直连约定下的自行包裹）：跨语句不变量的路径（全新建四行 / 变化三步）
 // 用 db.transaction；单语句路径（跨快照 skip 补行）单 INSERT 自原子。写入路径对

apps/api/src/modules/import/import.service.ts

@@ -732,7 +732,7 @@ function mergeOutcomes(acc: ImportPipelineOutcome, ret: ImportPipelineOutcome):
  *   的 reason/issue 同归 adapter 组（审查 Fix 4——不静默丢弃诊断信息）；
  * - **失败报告部分冲刷**（审查 Fix 1）：分派/finish 中途抛错时，把可安全取得的部分产出
  *   冲入 ctx.report 累加器后重抛——term/content 的 finish 是纯返回（无库依赖，就地补算）；
- *   media/route 的 finish 依赖库与先序产物，失败路径**不调用**（其键/issue 缺席于失败报告）；
+ *   media/route 的 finish 依赖库与先序产物，失败路径**不调用**（其 issueGroups 为空数组——未到该 finish 阶段，部分数据不可安全取得）；
  *   进度以 orchestrator 键 eventsDispatched 落 counts（仅失败路径出现——成功路径不占键）。
  */
 function orchestratedPipeline(paths: { productsPath: string; newsPath: string }): ImportPipeline {