@cloud411716/fancy-webnovel 1.0.46 → 3.0.0

package/plugins/fancy-story-builder/storydb/impact.js

@@ -0,0 +1,170 @@
+/**
+ * Graph impact analysis: changing a relation or a foreshadow.
+ */
+
+import { recordLiteral } from './ids.js';
+import { getEntity } from './store.js';
+
+const STORY = 'story:main';
+
+async function resolveCharacter(sdb, value) {
+  const text = String(value || '').trim();
+  const row = await sdb.one(
+    `SELECT * FROM character WHERE story = ${STORY} AND (entity_id = $q OR name = $q) LIMIT 1;`,
+    { q: text },
+  );
+  if (!row) throw new Error('未找到人物：' + text);
+  return row;
+}
+
+export async function impactRelation(sdb, aRaw, bRaw, opts = {}) {
+  const a = await resolveCharacter(sdb, aRaw);
+  const b = await resolveCharacter(sdb, bRaw);
+  const aId = a.entity_id;
+  const bId = b.entity_id;
+  const from = Number(opts.fromChapter) || 1;
+  const newKind = opts.newKind || null;
+
+  const current = await sdb.rows(
+    `SELECT from_id, to_id, kind, initial_state, changes FROM relation
+     WHERE story = ${STORY}
+       AND ((from_id = $a AND to_id = $b) OR (from_id = $b AND to_id = $a));`,
+    { a: aId, b: bId },
+  );
+
+  const chapters = await sdb.rows(
+    `SELECT chapter_id, display_no, title FROM chapter
+     WHERE story = ${STORY} AND display_no >= $from
+       AND $a IN ->chapter_cast->character.entity_id
+       AND $b IN ->chapter_cast->character.entity_id
+     ORDER BY display_no;`,
+    { from, a: aId, b: bId },
+  );
+  const chapterNos = new Set(chapters.map((row) => Number(row.display_no)));
+
+  const conflicts = await sdb.rows(
+    `SELECT entity_id, name, type FROM conflict
+     WHERE story = ${STORY} AND $a IN participants AND $b IN participants;`,
+    { a: aId, b: bId },
+  );
+
+  const actions = await sdb.rows(
+    `SELECT out.entity_id AS foreshadow, out.name AS name, in.display_no AS chapter, action, detail
+     FROM foreshadow_action WHERE story = ${STORY} AND in.display_no >= $from ORDER BY chapter;`,
+    { from },
+  );
+  const foreshadows = actions.filter((row) => chapterNos.has(Number(row.chapter)));
+
+  const knowledge = await sdb.rows(
+    `SELECT chapter_no, character_id, subject_type, subject_id, change, coverage
+     FROM knowledge_event WHERE story = ${STORY} AND chapter_no >= $from
+       AND character_id IN [$a, $b] ORDER BY chapter_no;`,
+    { from, a: aId, b: bId },
+  );
+
+  const pending = await sdb.rows(
+    `SELECT subject, kind, hard, due_chapter FROM requirement
+     WHERE story = ${STORY} AND status = 'pending' ORDER BY hard DESC, due_chapter ASC;`,
+  );
+  const affectedPending = pending.filter((row) => {
+    const ref = String(row.subject).split(':');
+    if (ref[0] === 'chapter') {
+      const ch = chapters.find((c) => c.chapter_id === ref[1]);
+      return Boolean(ch);
+    }
+    if (ref[0] === 'foreshadow') {
+      return foreshadows.some((f) => f.foreshadow === ref[1]);
+    }
+    return false;
+  });
+
+  const warnings = [];
+  if (!current.length) warnings.push('当前没有 ' + aId + ' 与 ' + bId + ' 的关系边');
+  if (!chapters.length) warnings.push('第 ' + from + ' 章之后没有两人同时出场的章节');
+  if (newKind && current.length && current[0].kind === newKind) warnings.push('新关系与当前关系相同：' + newKind);
+  for (const fs of foreshadows) {
+    if (fs.action === 'reveal') warnings.push('伏笔 ' + fs.foreshadow + ' 在第 ' + fs.chapter + ' 章回收，依赖当前关系');
+  }
+
+  return {
+    query: 'relation_change',
+    characters: [{ id: aId, name: a.name }, { id: bId, name: b.name }],
+    current_relation: current[0] || null,
+    change: { from_chapter: from, to_kind: newKind },
+    impact: {
+      chapters,
+      conflicts,
+      foreshadows,
+      knowledge_events: knowledge,
+      pending_requirements: affectedPending,
+    },
+    warnings,
+  };
+}
+
+export async function impactForeshadow(sdb, idOrName, opts = {}) {
+  const text = String(idOrName || '').trim();
+  const entity = await sdb.one(
+    `SELECT * FROM foreshadow WHERE story = ${STORY} AND (entity_id = $q OR name = $q) LIMIT 1;`,
+    { q: text },
+  );
+  if (!entity) throw new Error('未找到伏笔：' + text);
+  const id = entity.entity_id;
+  const record = recordLiteral('foreshadow', id);
+
+  const actions = await sdb.rows(
+    `SELECT in.display_no AS chapter, in.chapter_id AS chapter_id, action, detail
+     FROM foreshadow_action WHERE story = ${STORY} AND out = ${record} ORDER BY chapter;`,
+  );
+  const payoffs = await sdb.rows(
+    `SELECT out.entity_id AS payoff, out.name AS name FROM foreshadow_payoff
+     WHERE story = ${STORY} AND in = ${record};`,
+  );
+  const requiredBy = await sdb.rows(
+    `SELECT entity_id, name FROM payoff WHERE story = ${STORY} AND $id IN required_setup;`,
+    { id },
+  );
+  const knowledge = await sdb.rows(
+    `SELECT chapter_no, character_id, change, coverage FROM knowledge_event
+     WHERE story = ${STORY} AND subject_type = 'foreshadow' AND subject_id = $id ORDER BY chapter_no;`,
+    { id },
+  );
+  const chapters = await sdb.rows(
+    `SELECT in.display_no AS chapter, in.chapter_id AS chapter_id FROM foreshadow_action
+     WHERE story = ${STORY} AND out = ${record} ORDER BY chapter;`,
+  );
+  const requirements = await sdb.rows(
+    `SELECT kind, status, hard, due_chapter FROM requirement
+     WHERE story = ${STORY} AND subject = $subject ORDER BY kind;`,
+    { subject: 'foreshadow:' + id },
+  );
+
+  const plant = actions.find((row) => row.action === 'plant');
+  const reveal = actions.find((row) => row.action === 'reveal');
+  const warnings = [];
+  if (!plant) warnings.push('这条伏笔尚未埋设记录');
+  if (opts.action === 'reveal') {
+    if (reveal) warnings.push('这条伏笔已经在第 ' + reveal.chapter + ' 章回收');
+    if (opts.chapter && plant && Number(plant.chapter) >= Number(opts.chapter)) {
+      warnings.push('回收章（' + opts.chapter + '）必须不早于埋设章（' + plant.chapter + '）');
+    }
+  }
+  if (payoffs.length + requiredBy.length > 0 && !reveal) {
+    warnings.push('有 ' + (payoffs.length + requiredBy.length) + ' 个爽点依赖这条伏笔，但尚未回收记录');
+  }
+
+  return {
+    query: 'foreshadow_change',
+    foreshadow: entity,
+    change: { action: opts.action || null, chapter: opts.chapter || null },
+    timeline: actions,
+    linked_payoffs: payoffs,
+    required_by_payoffs: requiredBy,
+    knowledge_events: knowledge,
+    affected_chapters: chapters,
+    requirements,
+    warnings,
+  };
+}
+
+export { getEntity };