feat(episode-mapping): 映射规则接口与模拟预览、待处理确认 / 忽略、作品页集数映射分区与订阅摘要

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01Cxwgnn2pbzQ7rXv3rq7fei

packages/contracts/src/api/episode-mapping.ts

@@ -0,0 +1,54 @@
+import { IdParam } from "../common.ts";
+import * as em from "../episode-mapping.ts";
+import { ep } from "./shared.ts";
+
+// 集数映射(docs/plan/episode-resolution.md 批次 4):作品的映射规则增删改、模拟预览。
+// 写入后立即按作品重算已绑定资源(返回受影响数量);待处理 episode_mapping 的确认 / 忽略走 /decisions/{id}/resolve 的选项。
+
+export const episodeMappingApi = {
+  episodeMapping: {
+    listRules: ep({
+      method: "get",
+      path: "/media-entities/{id}/episode-mapping-rules",
+      scope: "read",
+      summary: "作品的集数映射规则（含停用的与停用原因）",
+      params: IdParam,
+      response: em.EpisodeMappingRuleList,
+    }),
+    createRule: ep({
+      method: "post",
+      path: "/media-entities/{id}/episode-mapping-rules",
+      scope: "organize.execute",
+      summary: "新建集数映射规则并按作品重算（同作品 + 季 + 发布组只能有一条启用的规则）",
+      params: IdParam,
+      body: em.EpisodeMappingRuleCreate,
+      response: em.EpisodeMappingRuleWriteResult,
+    }),
+    updateRule: ep({
+      method: "patch",
+      path: "/episode-mapping-rules/{id}",
+      scope: "organize.execute",
+      summary: "修改 / 停用 / 启用集数映射规则并按作品重算",
+      params: IdParam,
+      body: em.EpisodeMappingRuleUpdate,
+      response: em.EpisodeMappingRuleWriteResult,
+    }),
+    deleteRule: ep({
+      method: "delete",
+      path: "/episode-mapping-rules/{id}",
+      scope: "organize.execute",
+      summary: "删除集数映射规则并按作品重算",
+      params: IdParam,
+      response: em.EpisodeMappingRuleWriteResult,
+    }),
+    preview: ep({
+      method: "post",
+      path: "/media-entities/{id}/episode-mapping/preview",
+      scope: "read",
+      summary: "模拟预览：近期资源的原始季集 → 当前结果 → 套用草稿规则后的结果（纯读）",
+      params: IdParam,
+      body: em.EpisodeMappingPreviewInput,
+      response: em.EpisodeMappingPreview,
+    }),
+  },
+} as const;