From 508299845f50df25c3dd3b56fdc67ab18f5f7a06 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Thu, 9 Apr 2026 22:52:35 +0200
Subject: [PATCH 01/24] Add HTML build script and shell template for standalone
 viewer

Build script assembles shell.html + parts (CSS, JS, demo data) into a
single self-contained HTML file. Three-screen layout: welcome, grid,
analytics with modal container and placeholder slots.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/tvplotlines/html/__init__.py      |  0
 src/tvplotlines/html/build.py         | 88 +++++++++++++++++++++++++++
 src/tvplotlines/html/parts/shell.html | 63 +++++++++++++++++++
 tests/test_html_build.py              | 51 ++++++++++++++++
 4 files changed, 202 insertions(+)
 create mode 100644 src/tvplotlines/html/__init__.py
 create mode 100644 src/tvplotlines/html/build.py
 create mode 100644 src/tvplotlines/html/parts/shell.html
 create mode 100644 tests/test_html_build.py

diff --git a/src/tvplotlines/html/__init__.py b/src/tvplotlines/html/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/src/tvplotlines/html/build.py b/src/tvplotlines/html/build.py
new file mode 100644
index 0000000..442b536
--- /dev/null
+++ b/src/tvplotlines/html/build.py
@@ -0,0 +1,88 @@
+"""Build a standalone HTML viewer from shell template and parts.
+
+Reads shell.html and replaces placeholders with CSS, JS, and demo data
+to produce a single self-contained HTML file.
+"""
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+_PARTS_DIR = Path(__file__).parent / "parts"
+_SHELL_PATH = _PARTS_DIR / "shell.html"
+_DEFAULT_DEMO = Path(__file__).parent.parent.parent.parent / "examples" / "results" / "bb_s01.json"
+
+
+def load_part(name: str) -> str:
+    """Load a part file by name from the parts/ directory.
+
+    Args:
+        name: filename inside parts/ directory.
+
+    Returns:
+        File contents as string, or empty string if file doesn't exist yet.
+    """
+    path = _PARTS_DIR / name
+    if path.exists():
+        return path.read_text(encoding="utf-8")
+    return ""
+
+
+def build_html(data_path: Path | None = None) -> str:
+    """Assemble the final HTML from shell template and parts.
+
+    Args:
+        data_path: path to JSON data file. Uses bb_s01.json demo if None.
+
+    Returns:
+        Complete HTML string ready to write to disk.
+    """
+    shell = _SHELL_PATH.read_text(encoding="utf-8")
+
+    # Load parts (CSS and JS files may not exist yet — that's fine)
+    style = load_part("style.css")
+    app_js = load_part("app.js")
+
+    # Load demo data
+    demo_path = data_path or _DEFAULT_DEMO
+    if not demo_path.exists():
+        print(f"Warning: data file not found at {demo_path}", file=sys.stderr)
+        demo_data = "{}"
+    else:
+        demo_data = demo_path.read_text(encoding="utf-8")
+        # Validate JSON
+        json.loads(demo_data)
+
+    html = shell
+    html = html.replace("/* {{STYLE}} */", style)
+    html = html.replace("/* {{APP_JS}} */", app_js)
+    html = html.replace("/* {{DEMO_DATA}} */", demo_data)
+
+    return html
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Build standalone HTML viewer")
+    parser.add_argument(
+        "--output", "-o",
+        default="viewer.html",
+        help="Output HTML file path (default: viewer.html)",
+    )
+    parser.add_argument(
+        "--data", "-d",
+        default=None,
+        help="Path to JSON data file (default: examples/results/bb_s01.json)",
+    )
+    args = parser.parse_args()
+
+    data_path = Path(args.data) if args.data else None
+    html = build_html(data_path)
+
+    output = Path(args.output)
+    output.write_text(html, encoding="utf-8")
+    print(f"Built {output} ({len(html)} bytes)")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/src/tvplotlines/html/parts/shell.html b/src/tvplotlines/html/parts/shell.html
new file mode 100644
index 0000000..71b3768
--- /dev/null
+++ b/src/tvplotlines/html/parts/shell.html
@@ -0,0 +1,63 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>TV Plotlines Viewer</title>
+<style>
+/* {{STYLE}} */
+</style>
+</head>
+<body>
+
+<!-- Welcome screen -->
+<section id="screen-welcome" class="screen active">
+  <div class="welcome-container">
+    <h1>TV Plotlines Viewer</h1>
+    <p>Upload a plotlines JSON file or explore the demo data.</p>
+    <div class="welcome-actions">
+      <button id="btn-demo">Load Demo</button>
+      <label class="upload-label" for="file-upload">Upload JSON</label>
+      <input type="file" id="file-upload" accept=".json" hidden>
+    </div>
+  </div>
+</section>
+
+<!-- Grid screen -->
+<section id="screen-grid" class="screen">
+  <nav class="toolbar">
+    <button id="btn-back-welcome" class="btn-nav">&larr; Home</button>
+    <span id="grid-title" class="toolbar-title"></span>
+    <button id="btn-analytics" class="btn-nav">Analytics &rarr;</button>
+  </nav>
+  <div id="grid-container"></div>
+</section>
+
+<!-- Analytics screen -->
+<section id="screen-analytics" class="screen">
+  <nav class="toolbar">
+    <button id="btn-back-grid" class="btn-nav">&larr; Grid</button>
+    <span class="toolbar-title">Analytics</span>
+  </nav>
+  <div id="analytics-container"></div>
+</section>
+
+<!-- Modal -->
+<div id="modal-overlay" class="modal-overlay hidden">
+  <div id="modal-content" class="modal-content">
+    <button id="modal-close" class="modal-close">&times;</button>
+    <div id="modal-body"></div>
+  </div>
+</div>
+
+<!-- Demo data (injected by build.py) -->
+<script id="demo-data" type="application/json">
+/* {{DEMO_DATA}} */
+</script>
+
+<script>
+/* {{APP_JS}} */
+</script>
+
+</body>
+</html>
diff --git a/tests/test_html_build.py b/tests/test_html_build.py
new file mode 100644
index 0000000..18ce29c
--- /dev/null
+++ b/tests/test_html_build.py
@@ -0,0 +1,51 @@
+import subprocess
+import tempfile
+from pathlib import Path
+
+
+def test_build_produces_html():
+    result = subprocess.run(
+        ["python", "src/tvplotlines/html/build.py", "--output", "/tmp/test_viewer.html"],
+        capture_output=True, text=True,
+        cwd="/Users/nvashko/Projects/1-projects/tvplotlines",
+    )
+    assert result.returncode == 0, f"Build failed: {result.stderr}"
+    html = Path("/tmp/test_viewer.html").read_text()
+    assert "<!DOCTYPE html>" in html
+    assert "<style>" in html
+    assert "<script>" in html
+    assert "demo-data" in html
+
+
+def test_build_embeds_demo_data():
+    """Demo data from bb_s01.json should be embedded in the output."""
+    result = subprocess.run(
+        ["python", "src/tvplotlines/html/build.py", "--output", "/tmp/test_viewer.html"],
+        capture_output=True, text=True,
+        cwd="/Users/nvashko/Projects/1-projects/tvplotlines",
+    )
+    assert result.returncode == 0
+    html = Path("/tmp/test_viewer.html").read_text()
+    # bb_s01.json contains Breaking Bad data
+    assert "story_engine" in html
+
+
+def test_build_with_custom_data():
+    """Build with --data flag pointing to a custom JSON file."""
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".json", delete=False) as f:
+        f.write('{"test": true}')
+        tmp_path = f.name
+
+    result = subprocess.run(
+        [
+            "python", "src/tvplotlines/html/build.py",
+            "--output", "/tmp/test_viewer_custom.html",
+            "--data", tmp_path,
+        ],
+        capture_output=True, text=True,
+        cwd="/Users/nvashko/Projects/1-projects/tvplotlines",
+    )
+    assert result.returncode == 0
+    html = Path("/tmp/test_viewer_custom.html").read_text()
+    assert '"test": true' in html
+    Path(tmp_path).unlink()

From 1338c20612874fad6debf975664a5c629a76d745 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Thu, 9 Apr 2026 22:54:01 +0200
Subject: [PATCH 02/24] fix: build.py concatenates all JS parts, not just
 app.js

---
 src/tvplotlines/html/build.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/src/tvplotlines/html/build.py b/src/tvplotlines/html/build.py
index 442b536..a1c3d41 100644
--- a/src/tvplotlines/html/build.py
+++ b/src/tvplotlines/html/build.py
@@ -42,7 +42,14 @@ def build_html(data_path: Path | None = None) -> str:
 
     # Load parts (CSS and JS files may not exist yet — that's fine)
     style = load_part("style.css")
-    app_js = load_part("app.js")
+
+    js_files = ["grid.js", "analytics.js", "export.js", "pipeline.js", "app.js"]
+    js_parts = []
+    for name in js_files:
+        content = load_part(name)
+        if content:
+            js_parts.append(f"// --- {name} ---\n{content}")
+    app_js = "\n\n".join(js_parts)
 
     # Load demo data
     demo_path = data_path or _DEFAULT_DEMO

From bc7ec07470fffe31ad0314650984f70d0b424cfd Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Thu, 9 Apr 2026 22:56:35 +0200
Subject: [PATCH 03/24] Port CSS from tvplotlines-app for standalone HTML
 viewer

Keep battle-tested styles: color palette (light + Catppuccin Mocha dark),
function colors, rank badges, tension variables, grid layout, analytics.
Remove HTMX/edit-mode/merge/split styles (v1 is read-only).
Add screen routing, welcome screen, and toolbar/navigation styles.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/tvplotlines/html/parts/style.css | 339 +++++++++++++++++++++++++++
 1 file changed, 339 insertions(+)
 create mode 100644 src/tvplotlines/html/parts/style.css

diff --git a/src/tvplotlines/html/parts/style.css b/src/tvplotlines/html/parts/style.css
new file mode 100644
index 0000000..3786204
--- /dev/null
+++ b/src/tvplotlines/html/parts/style.css
@@ -0,0 +1,339 @@
+/* Reset & base */
+* { box-sizing: border-box; margin: 0; padding: 0; }
+body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; background: #f5f5f5; color: #1a1a1a; }
+
+/* ── Screen routing ── */
+.screen { display: none; }
+.screen.active { display: block; }
+.hidden { display: none; }
+
+/* ── Welcome screen ── */
+.welcome-container {
+  display: flex; flex-direction: column; align-items: center; justify-content: center;
+  min-height: 100vh; padding: 2rem; text-align: center;
+}
+.welcome-container h1 {
+  font-size: 2rem; font-weight: 300; letter-spacing: 0.05em;
+  margin-bottom: 0.5rem; color: #1a1a1a;
+}
+.welcome-container p {
+  font-size: 0.95rem; color: #666; margin-bottom: 2rem;
+}
+.welcome-actions { display: flex; gap: 1rem; }
+.welcome-actions button,
+.welcome-actions .upload-label {
+  padding: 0.625rem 1.5rem; border: 1px solid #ddd; border-radius: 6px;
+  background: white; cursor: pointer; font-size: 0.875rem;
+  transition: background 0.15s, border-color 0.15s;
+}
+.welcome-actions button:hover,
+.welcome-actions .upload-label:hover { background: #f0f0f0; }
+
+/* ── Page layout ── */
+.page { max-width: 100%; padding: 1rem; }
+
+/* ── Sticky top bar ── */
+.sticky-top { position: sticky; top: 0; z-index: 10; background: #f5f5f5; padding-bottom: 0.25rem; }
+
+/* ── Toolbar / navigation ── */
+.toolbar {
+  display: flex; justify-content: space-between; align-items: center;
+  padding: 0.75rem 1rem; background: white; border-radius: 8px;
+  margin-bottom: 1rem; box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+}
+.toolbar-title { font-size: 1.1rem; font-weight: 600; }
+.btn-nav {
+  padding: 0.375rem 0.75rem; border: 1px solid #ddd; border-radius: 6px;
+  background: white; cursor: pointer; font-size: 0.8rem;
+}
+.btn-nav:hover { background: #f0f0f0; }
+
+/* ── Buttons ── */
+.btn { padding: 0.5rem 1rem; border: 1px solid #ddd; border-radius: 6px; background: white; cursor: pointer; font-size: 0.875rem; }
+.btn:hover { background: #f0f0f0; }
+.btn:disabled { opacity: 0.5; cursor: default; }
+.btn-save { background: #2563eb; color: white; border-color: #2563eb; }
+.btn-save:hover:not(:disabled) { background: #1d4ed8; }
+.btn-danger { background: #dc2626; color: white; border-color: #dc2626; }
+.btn-danger:hover { background: #b91c1c; }
+
+/* ── Filters ── */
+.filters { display: flex; gap: 1rem; margin-bottom: 1rem; align-items: start; }
+.filter-select { padding: 0.5rem; border: 1px solid #ddd; border-radius: 6px; }
+.filter-dropdown { background: white; border: 1px solid #ddd; border-radius: 6px; padding: 0.5rem; }
+.filter-dropdown summary { cursor: pointer; font-size: 0.875rem; }
+.filter-list { max-height: 200px; overflow-y: auto; padding: 0.5rem 0; }
+.filter-list label { display: block; padding: 0.25rem 0.5rem; font-size: 0.8rem; cursor: pointer; }
+
+/* ── Legend ── */
+.legend { display: flex; gap: 0.5rem; align-items: center; flex-wrap: wrap; }
+.legend-item { padding: 0.25rem 0.625rem; border-radius: 4px; font-size: 0.75rem; }
+.legend-filter { cursor: pointer; transition: box-shadow 0.15s, opacity 0.15s; border: 2px solid transparent; }
+.legend-filter:hover { opacity: 0.85; }
+.legend-filtering .legend-filter:not(.legend-active) { opacity: 0.3; }
+.legend-active { border-color: #1a1a1a; opacity: 1; font-weight: 700; }
+:root.dark .legend-active { border-color: #cdd6f4; }
+
+/* ── Grid container ── */
+.grid-container { overflow-x: auto; background: white; border-radius: 8px; box-shadow: 0 1px 3px rgba(0,0,0,0.1); }
+
+/* ── Timeline grid ── */
+.timeline-grid { border-collapse: separate; border-spacing: 4px; width: 100%; }
+.timeline-grid th, .timeline-grid td { padding: 0.75rem; vertical-align: top; }
+
+/* ── Sticky left column ── */
+.sticky-col { position: sticky; left: 0; z-index: 2; background: white; min-width: 220px; max-width: 280px; }
+
+/* ── Header cells ── */
+.header-cell { text-align: center; background: #f8f8f8; border-radius: 6px; }
+.ep-code { font-weight: 600; font-size: 0.9rem; }
+.ep-theme { font-size: 0.7rem; color: #666; margin-top: 0.25rem; line-height: 1.3; }
+
+/* ── Plotline left cell ── */
+.plotline-cell { cursor: pointer; border-radius: 6px; border: 1px solid #e5e5e5; transition: background 0.15s; }
+.plotline-cell:hover { background: #f0f4ff; }
+.plotline-name { font-weight: 600; margin-bottom: 0.25rem; }
+.plotline-characters { font-size: 0.75rem; color: #666; line-height: 1.4; }
+.guest-char { font-style: italic; }
+
+/* ── Rank badges ── */
+.rank-badge { display: inline-block; padding: 0.125rem 0.5rem; border-radius: 10px; font-size: 0.7rem; font-weight: 600; margin-bottom: 0.25rem; }
+.rank-a { background: #dbeafe; color: #1e40af; }
+.rank-b { background: #fef3c7; color: #92400e; }
+.rank-c { background: #e5e7eb; color: #374151; }
+.rank-runner { background: #f3e8ff; color: #6b21a8; }
+
+/* ── Event cells ── */
+.event-cell { min-width: 180px; min-height: 80px; border-radius: 6px; border: 1px solid #e5e5e5; }
+.empty-cell { border-style: dashed; border-color: #d1d5db; }
+
+/* ── Event cards ── */
+.event-card { padding: 0.5rem; margin-bottom: 0.375rem; border-radius: 4px; font-size: 0.8rem; line-height: 1.4; cursor: pointer; transition: transform 0.1s; }
+.event-card:hover { transform: scale(1.02); box-shadow: 0 2px 6px rgba(0,0,0,0.1); }
+.event-card:last-child { margin-bottom: 0; }
+
+/* ── Function colors ── */
+.fn-setup { background: #f3f4f6; }
+.fn-escalation { background: #fef9c3; }
+.fn-turning_point { background: #fed7aa; }
+.fn-seed { background: #dbeafe; }
+.fn-climax { background: #fecaca; }
+.fn-resolution { background: #d1fae5; }
+.fn-cliffhanger { background: #e9d5ff; }
+
+/* ── Unassigned row ── */
+.unassigned-row { opacity: 0.7; }
+.unassigned-label { color: #9ca3af; font-style: italic; }
+.unassigned-event { border: 1px dashed #9ca3af; }
+
+/* ── Side panel (storyline detail) ── */
+.side-panel-overlay { position: fixed; inset: 0; background: rgba(0,0,0,0.3); z-index: 100; display: flex; justify-content: flex-end; }
+.side-panel { width: 400px; max-width: 90vw; height: 100vh; background: white; box-shadow: -4px 0 20px rgba(0,0,0,0.15); padding: 1.5rem; overflow-y: auto; animation: slideIn 0.2s ease-out; }
+.side-panel-header { display: flex; justify-content: space-between; align-items: center; margin-bottom: 1rem; }
+.side-panel-header h2 { margin: 0; font-size: 1.25rem; }
+.side-panel-close { font-size: 1.5rem; line-height: 1; padding: 0.25rem 0.5rem; border: none; }
+@keyframes slideIn { from { transform: translateX(100%); } to { transform: translateX(0); } }
+.detail-field { margin-bottom: 0.75rem; }
+.detail-field label { font-weight: 600; font-size: 0.8rem; color: #666; display: block; margin-bottom: 0.25rem; }
+.detail-field .value { font-size: 0.9rem; }
+
+/* ── Modal ── */
+.modal-overlay { position: fixed; inset: 0; background: rgba(0,0,0,0.4); display: flex; align-items: center; justify-content: center; z-index: 100; }
+.modal-content { background: white; border-radius: 12px; padding: 1.5rem; max-width: 600px; width: 90%; max-height: 85vh; overflow-y: auto; box-shadow: 0 20px 60px rgba(0,0,0,0.2); position: relative; }
+.modal-close { position: absolute; top: 0.75rem; right: 0.75rem; font-size: 1.5rem; line-height: 1; padding: 0.25rem 0.5rem; border: none; background: none; cursor: pointer; }
+
+/* ── Toast notifications ── */
+#toast-container { position: fixed; bottom: 1.5rem; right: 1.5rem; z-index: 200; display: flex; flex-direction: column; gap: 0.5rem; }
+.toast { padding: 0.75rem 1.25rem; background: #1a1a1a; color: white; border-radius: 8px; font-size: 0.875rem; box-shadow: 0 4px 12px rgba(0,0,0,0.2); animation: toastIn 0.25s ease-out; }
+.toast-out { opacity: 0; transform: translateY(10px); transition: all 0.3s ease-in; }
+@keyframes toastIn { from { opacity: 0; transform: translateY(20px); } to { opacity: 1; transform: translateY(0); } }
+
+/* ── Charts grid ── */
+.charts-grid { display: grid; grid-template-columns: 1fr; gap: 1.5rem; margin-top: 1rem; max-width: 1200px; }
+.chart-card { background: white; border-radius: 8px; padding: 1.5rem; box-shadow: 0 1px 3px rgba(0,0,0,0.1); overflow: hidden; }
+.chart-title { font-size: 1.1rem; font-weight: 600; margin-bottom: 0.25rem; }
+.chart-description { font-size: 0.85rem; color: #666; margin-bottom: 1rem; line-height: 1.5; }
+.chart-img { width: 100%; height: auto; display: block; }
+
+/* ── Dark theme (Catppuccin Mocha) ── */
+:root.dark body { background: #1e1e2e; color: #cdd6f4; }
+:root.dark .sticky-top { background: #1e1e2e; }
+
+:root.dark .welcome-container h1 { color: #cdd6f4; }
+:root.dark .welcome-container p { color: #a6adc8; }
+:root.dark .welcome-actions button,
+:root.dark .welcome-actions .upload-label { background: #313244; color: #cdd6f4; border-color: #45475a; }
+:root.dark .welcome-actions button:hover,
+:root.dark .welcome-actions .upload-label:hover { background: #45475a; }
+
+:root.dark .toolbar { background: #181825; box-shadow: 0 1px 3px rgba(0,0,0,0.5); }
+:root.dark .toolbar-title { color: #cba6f7; }
+:root.dark .btn-nav { background: #313244; color: #cdd6f4; border-color: #45475a; }
+:root.dark .btn-nav:hover { background: #45475a; }
+
+:root.dark .grid-container,
+:root.dark .side-panel { background: #181825; box-shadow: 0 1px 3px rgba(0,0,0,0.5); }
+:root.dark .modal-content { background: #181825; box-shadow: 0 1px 3px rgba(0,0,0,0.5); }
+:root.dark .side-panel-overlay { background: rgba(0,0,0,0.55); }
+:root.dark .btn { background: #313244; color: #cdd6f4; border-color: #45475a; }
+:root.dark .btn:hover { background: #45475a; }
+:root.dark .btn-save { background: #89b4fa; color: #1e1e2e; border-color: #89b4fa; }
+:root.dark .btn-save:hover:not(:disabled) { background: #74c7ec; }
+:root.dark .btn-danger { background: #f38ba8; color: #1e1e2e; border-color: #f38ba8; }
+:root.dark .btn-danger:hover { background: #eba0ac; }
+:root.dark .filter-dropdown { background: #313244; border-color: #45475a; color: #cdd6f4; }
+:root.dark .filter-select { background: #313244; border-color: #45475a; color: #cdd6f4; }
+:root.dark .sticky-col { background: #181825; }
+:root.dark .header-cell { background: #11111b; }
+:root.dark .ep-code { color: #cba6f7; }
+:root.dark .ep-theme { color: #a6adc8; }
+:root.dark .plotline-cell { border-color: #313244; }
+:root.dark .plotline-cell:hover { background: #313244; }
+:root.dark .plotline-name { color: #f5c2e7; }
+:root.dark .plotline-characters { color: #a6adc8; }
+:root.dark .event-cell { border-color: #313244; }
+:root.dark .empty-cell { border-color: #45475a; }
+:root.dark .modal-overlay { background: rgba(0,0,0,0.65); }
+:root.dark .modal-close { color: #cdd6f4; }
+:root.dark .detail-field label { color: #a6adc8; }
+:root.dark .unassigned-label { color: #6c7086; }
+:root.dark .toast { background: #313244; color: #cdd6f4; box-shadow: 0 4px 12px rgba(0,0,0,0.5); }
+:root.dark .chart-card { background: #1a1b26; box-shadow: 0 1px 3px rgba(0,0,0,0.5); }
+:root.dark .chart-title { color: #cba6f7; }
+:root.dark .chart-description { color: #a6adc8; }
+
+/* ── Dark function colors — warm muted tones ── */
+:root.dark .fn-setup { background: #313244; color: #bac2de; }
+:root.dark .fn-escalation { background: #433a2a; color: #f9e2af; }
+:root.dark .fn-turning_point { background: #3d2f24; color: #fab387; }
+:root.dark .fn-seed { background: #243347; color: #89b4fa; }
+:root.dark .fn-climax { background: #3d2332; color: #f38ba8; }
+:root.dark .fn-resolution { background: #1e3d2e; color: #a6e3a1; }
+:root.dark .fn-cliffhanger { background: #302040; color: #cba6f7; }
+
+/* ── Dark rank badges ── */
+:root.dark .rank-a { background: #243347; color: #89b4fa; }
+:root.dark .rank-b { background: #433a2a; color: #f9e2af; }
+:root.dark .rank-c { background: #313244; color: #a6adc8; }
+:root.dark .rank-runner { background: #302040; color: #cba6f7; }
+
+/* ── Analytics ── */
+:root { --ana-tension-0: #f0f0f0; --ana-tension-1: #bae6d1; --ana-tension-2: #f0e68c; --ana-tension-3: #f5b87a; --ana-tension-4: #e87c7c; --ana-tension-5: #d44a7a; }
+
+.ana-section { background: white; border-radius: 8px; padding: 1.5rem; margin-bottom: 1.5rem; box-shadow: 0 1px 3px rgba(0,0,0,0.1); max-width: 1200px; }
+.ana-title { font-size: 1.2rem; font-weight: 600; margin-bottom: 1rem; }
+.ana-engine { font-size: 0.9rem; color: #666; margin-bottom: 1rem; padding: 0.5rem 0.75rem; background: #f8f8f8; border-radius: 6px; border-left: 3px solid #2563eb; }
+
+/* Scorecard */
+.ana-scorecard { width: 100%; border-collapse: separate; border-spacing: 0; }
+.ana-scorecard th { text-align: left; font-size: 0.75rem; color: #666; font-weight: 400; padding: 6px 12px; border-bottom: 1px solid #e5e5e5; text-transform: uppercase; letter-spacing: 0.05em; }
+.ana-scorecard td { padding: 8px 12px; font-size: 0.85rem; border-bottom: 1px solid #f0f0f0; }
+.ana-scorecard tr:last-child td { border-bottom: none; }
+.ana-plotline-name { font-weight: 500; }
+.ana-arc-summary { color: #666; font-size: 0.8rem; }
+.ana-span-bar { display: flex; gap: 2px; }
+.ana-span-dot { width: 14px; height: 14px; border-radius: 3px; }
+.ana-span-dot.active { background: #2563eb; opacity: 0.7; }
+.ana-span-dot.inactive { background: #e5e5e5; }
+
+/* Arc Map */
+.ana-legend { display: flex; align-items: center; gap: 8px; margin-bottom: 1rem; flex-wrap: wrap; }
+.ana-legend-label { font-size: 0.8rem; color: #666; }
+.ana-legend-hint { font-size: 0.75rem; color: #999; margin-left: 12px; }
+.ana-gradient { display: flex; gap: 2px; }
+.ana-grad-step { width: 28px; height: 14px; border-radius: 2px; }
+.ana-arcmap { display: grid; gap: 3px; }
+.ana-arcmap-header { font-size: 0.8rem; color: #666; text-align: center; padding: 4px; }
+.ana-arcmap-label { font-size: 0.85rem; text-align: right; padding-right: 10px; display: flex; align-items: center; justify-content: flex-end; gap: 6px; }
+.ana-arcmap-cell { border-radius: 6px; min-height: 50px; display: flex; align-items: center; justify-content: center; }
+.ana-arcmap-cell.ana-tension-0 { background: var(--ana-tension-0); }
+.ana-arcmap-cell.ana-tension-1 { background: var(--ana-tension-1); }
+.ana-arcmap-cell.ana-tension-2 { background: var(--ana-tension-2); }
+.ana-arcmap-cell.ana-tension-3 { background: var(--ana-tension-3); }
+.ana-arcmap-cell.ana-tension-4 { background: var(--ana-tension-4); }
+.ana-arcmap-cell.ana-tension-5 { background: var(--ana-tension-5); }
+.ana-arc-circle { border-radius: 50%; display: flex; align-items: center; justify-content: center; font-size: 0.8rem; font-weight: 600; color: #1a1a1a; background: rgba(255,255,255,0.35); }
+.ana-arc-empty { color: #ccc; font-size: 0.8rem; }
+.ana-arcmap-theme-label { font-size: 0.75rem; color: #999; text-align: right; padding-right: 10px; }
+.ana-arcmap-theme { font-size: 0.7rem; color: #999; text-align: center; font-style: italic; }
+
+/* Episode Pulse */
+.ana-pulse-row { display: flex; align-items: center; gap: 8px; margin-bottom: 4px; }
+.ana-pulse-ep { font-size: 0.85rem; font-weight: 500; width: 35px; text-align: right; flex-shrink: 0; }
+.ana-pulse-wrap { flex: 1; }
+.ana-pulse-bars { display: flex; gap: 2px; height: 28px; }
+.ana-pulse-bar { border-radius: 3px; display: flex; align-items: center; justify-content: center; font-size: 0.7rem; color: rgba(0,0,0,0.7); min-width: 14px; background: #2563eb; }
+.ana-pulse-bar:nth-child(2) { background: #f59e0b; }
+.ana-pulse-bar:nth-child(3) { background: #ef4444; color: white; }
+.ana-pulse-bar:nth-child(4) { background: #6b7280; color: white; }
+.ana-pulse-bar:nth-child(5) { background: #8b5cf6; color: white; }
+.ana-pulse-bar:nth-child(6) { background: #10b981; }
+.ana-pulse-total { font-size: 0.8rem; color: #666; width: 30px; text-align: right; flex-shrink: 0; }
+.ana-pulse-theme { font-size: 0.75rem; color: #999; width: 220px; flex-shrink: 0; font-style: italic; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+
+/* Convergence */
+.ana-conv-timeline { position: relative; padding-left: 40px; }
+.ana-conv-line { position: absolute; left: 17px; top: 0; bottom: 0; width: 1px; background: #e5e5e5; }
+.ana-conv-group { margin-bottom: 1.25rem; }
+.ana-conv-ep { font-size: 0.9rem; font-weight: 600; margin-bottom: 6px; position: relative; }
+.ana-conv-ep::before { content: ''; position: absolute; left: -28px; top: 50%; width: 10px; height: 10px; background: #2563eb; border-radius: 50%; transform: translateY(-50%); }
+.ana-conv-item { display: flex; gap: 8px; align-items: flex-start; margin-bottom: 4px; padding: 6px 8px; border-radius: 6px; background: #f8f8f8; }
+.ana-conv-type { font-size: 0.7rem; padding: 2px 8px; border-radius: 4px; flex-shrink: 0; font-weight: 600; white-space: nowrap; }
+.ana-conv-convergence { background: #fecdd3; color: #be123c; }
+.ana-conv-dramatic_irony { background: #e9d5ff; color: #7c3aed; }
+.ana-conv-thematic_rhyme { background: #cffafe; color: #0e7490; }
+.ana-conv-lines { font-size: 0.8rem; color: #b45309; flex-shrink: 0; min-width: 120px; }
+.ana-conv-desc { font-size: 0.8rem; color: #666; }
+
+/* Character Weight */
+.ana-char-row { display: flex; align-items: center; gap: 8px; margin-bottom: 6px; }
+.ana-char-name { font-size: 0.85rem; width: 130px; text-align: right; flex-shrink: 0; }
+.ana-char-bar-wrap { flex: 1; height: 24px; }
+.ana-char-bar { height: 100%; border-radius: 4px; background: #2563eb; display: flex; align-items: center; padding-left: 8px; font-size: 0.75rem; font-weight: 600; color: white; }
+.ana-char-dots { display: flex; gap: 3px; width: 50px; flex-shrink: 0; }
+.ana-char-dot { width: 8px; height: 8px; border-radius: 50%; background: #2563eb; }
+
+/* ── Dark analytics (Catppuccin Mocha) ── */
+:root.dark .ana-section { background: #181825; box-shadow: 0 1px 3px rgba(0,0,0,0.5); }
+:root.dark .ana-title { color: #cba6f7; }
+:root.dark .ana-engine { color: #a6adc8; background: #313244; border-left-color: #89b4fa; }
+
+:root.dark .ana-scorecard th { color: #a6adc8; border-bottom-color: #45475a; }
+:root.dark .ana-scorecard td { border-bottom-color: #313244; color: #cdd6f4; }
+:root.dark .ana-arc-summary { color: #a6adc8; }
+:root.dark .ana-span-dot.active { background: #89b4fa; }
+:root.dark .ana-span-dot.inactive { background: #45475a; }
+
+:root.dark { --ana-tension-0: #313244; --ana-tension-1: #1e3d2e; --ana-tension-2: #433a2a; --ana-tension-3: #3d2f24; --ana-tension-4: #3d2332; --ana-tension-5: #5c1d3e; }
+:root.dark .ana-arcmap-header { color: #a6adc8; }
+:root.dark .ana-arcmap-label { color: #cdd6f4; }
+:root.dark .ana-arc-circle { color: #cdd6f4; background: rgba(0,0,0,0.25); }
+:root.dark .ana-arc-empty { color: #6c7086; }
+:root.dark .ana-arcmap-theme-label { color: #6c7086; }
+:root.dark .ana-arcmap-theme { color: #6c7086; }
+:root.dark .ana-legend-label { color: #a6adc8; }
+:root.dark .ana-legend-hint { color: #6c7086; }
+
+:root.dark .ana-pulse-ep { color: #cdd6f4; }
+:root.dark .ana-pulse-bar { color: #1e1e2e; background: #89b4fa; }
+:root.dark .ana-pulse-bar:nth-child(2) { background: #f9e2af; color: #1e1e2e; }
+:root.dark .ana-pulse-bar:nth-child(3) { background: #f38ba8; color: #1e1e2e; }
+:root.dark .ana-pulse-bar:nth-child(4) { background: #a6adc8; color: #1e1e2e; }
+:root.dark .ana-pulse-bar:nth-child(5) { background: #cba6f7; color: #1e1e2e; }
+:root.dark .ana-pulse-bar:nth-child(6) { background: #a6e3a1; color: #1e1e2e; }
+:root.dark .ana-pulse-total { color: #a6adc8; }
+:root.dark .ana-pulse-theme { color: #6c7086; }
+
+:root.dark .ana-conv-line { background: #45475a; }
+:root.dark .ana-conv-ep { color: #cdd6f4; }
+:root.dark .ana-conv-ep::before { background: #89b4fa; }
+:root.dark .ana-conv-item { background: #313244; }
+:root.dark .ana-conv-convergence { background: #3d2332; color: #f38ba8; }
+:root.dark .ana-conv-dramatic_irony { background: #302040; color: #cba6f7; }
+:root.dark .ana-conv-thematic_rhyme { background: #1e3d3d; color: #94e2d5; }
+:root.dark .ana-conv-lines { color: #f9e2af; }
+:root.dark .ana-conv-desc { color: #a6adc8; }
+
+:root.dark .ana-char-name { color: #cdd6f4; }
+:root.dark .ana-char-bar { background: #89b4fa; color: #1e1e2e; }
+:root.dark .ana-char-dot { background: #89b4fa; }

From 8447b82a8e7202343a1e3498f5ae185f1d7d3063 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Thu, 9 Apr 2026 23:00:06 +0200
Subject: [PATCH 04/24] Add grid rendering and app init for standalone HTML
 viewer

Port plotline x episode grid from tvplotlines-app Jinja2 template to
vanilla JS. Includes event grid lookup, character resolution, guest
detection, rank sorting, function legend filtering, season/character
filters, and read-only event detail modal. App.js handles screen
routing, dark mode persistence, demo data loading, and file upload.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/tvplotlines/html/parts/app.js  | 110 +++++++
 src/tvplotlines/html/parts/grid.js | 499 +++++++++++++++++++++++++++++
 2 files changed, 609 insertions(+)
 create mode 100644 src/tvplotlines/html/parts/app.js
 create mode 100644 src/tvplotlines/html/parts/grid.js

diff --git a/src/tvplotlines/html/parts/app.js b/src/tvplotlines/html/parts/app.js
new file mode 100644
index 0000000..cea213c
--- /dev/null
+++ b/src/tvplotlines/html/parts/app.js
@@ -0,0 +1,110 @@
+// App init — screen routing, dark mode, demo data loading.
+
+function showScreen(name) {
+  document.querySelectorAll('.screen').forEach(el => el.classList.remove('active'));
+  const target = document.getElementById('screen-' + name);
+  if (target) target.classList.add('active');
+}
+
+function toggleDark() {
+  const root = document.documentElement;
+  const isDark = root.classList.toggle('dark');
+  localStorage.setItem('tvplotlines-dark', isDark ? '1' : '0');
+}
+
+function _restoreDarkMode() {
+  const pref = localStorage.getItem('tvplotlines-dark');
+  if (pref === '1') {
+    document.documentElement.classList.add('dark');
+  }
+}
+
+function _loadDemoData() {
+  const el = document.getElementById('demo-data');
+  if (!el || !el.textContent.trim()) return null;
+  try {
+    return JSON.parse(el.textContent);
+  } catch (e) {
+    console.error('Failed to parse demo data:', e);
+    return null;
+  }
+}
+
+function _initApp() {
+  _restoreDarkMode();
+
+  const container = document.getElementById('grid-container');
+  const demoData = _loadDemoData();
+
+  // Modal close
+  const modalOverlay = document.getElementById('modal-overlay');
+  const modalClose = document.getElementById('modal-close');
+  if (modalClose) {
+    modalClose.addEventListener('click', () => modalOverlay.classList.add('hidden'));
+  }
+  if (modalOverlay) {
+    modalOverlay.addEventListener('click', (e) => {
+      if (e.target === modalOverlay) modalOverlay.classList.add('hidden');
+    });
+  }
+
+  // Navigation buttons
+  const btnDemo = document.getElementById('btn-demo');
+  const btnBackWelcome = document.getElementById('btn-back-welcome');
+  const btnBackGrid = document.getElementById('btn-back-grid');
+  const btnAnalytics = document.getElementById('btn-analytics');
+  const fileUpload = document.getElementById('file-upload');
+  const gridTitle = document.getElementById('grid-title');
+
+  function loadData(data, title) {
+    if (!container) return;
+    renderGrid(data, container);
+    if (gridTitle) gridTitle.textContent = title || 'Plotlines';
+    showScreen('grid');
+  }
+
+  if (btnDemo) {
+    btnDemo.addEventListener('click', () => {
+      if (demoData) loadData(demoData, 'Demo: Breaking Bad S01');
+    });
+  }
+
+  if (fileUpload) {
+    fileUpload.addEventListener('change', (e) => {
+      const file = e.target.files[0];
+      if (!file) return;
+      const reader = new FileReader();
+      reader.onload = () => {
+        try {
+          const data = JSON.parse(reader.result);
+          loadData(data, file.name.replace('.json', ''));
+        } catch (err) {
+          alert('Invalid JSON file');
+        }
+      };
+      reader.readAsText(file);
+    });
+  }
+
+  if (btnBackWelcome) {
+    btnBackWelcome.addEventListener('click', () => showScreen('welcome'));
+  }
+  if (btnBackGrid) {
+    btnBackGrid.addEventListener('click', () => showScreen('grid'));
+  }
+  if (btnAnalytics) {
+    btnAnalytics.addEventListener('click', () => showScreen('analytics'));
+  }
+
+  // Auto-load demo if data is present and URL has #demo
+  if (demoData && window.location.hash === '#demo') {
+    loadData(demoData, 'Demo: Breaking Bad S01');
+  }
+}
+
+// Run on DOM ready
+if (document.readyState === 'loading') {
+  document.addEventListener('DOMContentLoaded', _initApp);
+} else {
+  _initApp();
+}
diff --git a/src/tvplotlines/html/parts/grid.js b/src/tvplotlines/html/parts/grid.js
new file mode 100644
index 0000000..efb5485
--- /dev/null
+++ b/src/tvplotlines/html/parts/grid.js
@@ -0,0 +1,499 @@
+// Grid rendering — plotline x episode table with filters and detail modal.
+
+const RANK_ORDER = { A: 0, B: 1, C: 2, runner: 3 };
+const FUNCTION_LABELS = {
+  setup: 'Setup',
+  escalation: 'Escalation',
+  turning_point: 'Turning Point',
+  seed: 'Seed',
+  climax: 'Climax',
+  resolution: 'Resolution',
+  cliffhanger: 'Cliffhanger',
+  inciting_incident: 'Inciting Incident',
+};
+
+function isGuest(charId) {
+  return charId.startsWith('guest:');
+}
+
+function resolveCharacterName(charId, cast) {
+  if (charId.startsWith('guest:')) return charId.slice(6);
+  for (const member of cast) {
+    if (member.id === charId) return member.name;
+  }
+  return charId;
+}
+
+/**
+ * Collect unique characters per plotline, sorted by frequency.
+ *
+ * Args:
+ *   episodes: array of episode objects with events.
+ *   plotlineId: plotline id to filter by.
+ *
+ * Returns:
+ *   Array of character id strings, most frequent first.
+ */
+function plotlineCharacters(episodes, plotlineId) {
+  const counts = {};
+  for (const ep of episodes) {
+    for (const ev of ep.events || []) {
+      // Support both field names: plotline_id (actual data) and storyline (spec)
+      const evPlotline = ev.plotline_id || ev.storyline;
+      if (evPlotline === plotlineId) {
+        for (const c of ev.characters || []) {
+          counts[c] = (counts[c] || 0) + 1;
+        }
+      }
+    }
+  }
+  return Object.entries(counts)
+    .sort((a, b) => b[1] - a[1])
+    .map(([id]) => id);
+}
+
+/**
+ * Build lookup: eventGrid[plotlineId][episodeCode] = [events].
+ */
+function buildEventGrid(episodes) {
+  const grid = {};
+  for (const ep of episodes) {
+    for (const ev of ep.events || []) {
+      const plId = ev.plotline_id || ev.storyline || null;
+      if (!plId) continue;
+      if (!grid[plId]) grid[plId] = {};
+      if (!grid[plId][ep.episode]) grid[plId][ep.episode] = [];
+      grid[plId][ep.episode].push(ev);
+    }
+  }
+  return grid;
+}
+
+/**
+ * Collect events with no plotline assignment.
+ * Returns: { episodeCode: [events] }
+ */
+function buildUnassigned(episodes) {
+  const result = {};
+  for (const ep of episodes) {
+    for (const ev of ep.events || []) {
+      const plId = ev.plotline_id || ev.storyline || null;
+      if (!plId) {
+        if (!result[ep.episode]) result[ep.episode] = [];
+        result[ep.episode].push(ev);
+      }
+    }
+  }
+  return result;
+}
+
+/**
+ * Extract unique seasons from episode codes.
+ */
+function extractSeasons(episodes) {
+  const seasons = new Set();
+  for (const ep of episodes) {
+    const match = ep.episode.match(/^S(\d+)/);
+    if (match) seasons.add(match[1]);
+  }
+  return [...seasons].sort();
+}
+
+/**
+ * Collect all unique function types present in the data.
+ */
+function collectFunctions(episodes) {
+  const fns = new Set();
+  for (const ep of episodes) {
+    for (const ev of ep.events || []) {
+      if (ev.function) fns.add(ev.function);
+    }
+  }
+  return [...fns];
+}
+
+/**
+ * Collect all unique characters across all events.
+ */
+function collectAllCharacters(episodes, cast) {
+  const chars = new Set();
+  for (const ep of episodes) {
+    for (const ev of ep.events || []) {
+      for (const c of ev.characters || []) {
+        chars.add(c);
+      }
+    }
+  }
+  return [...chars].map(id => ({
+    id,
+    name: resolveCharacterName(id, cast),
+    is_guest: isGuest(id),
+  })).sort((a, b) => a.name.localeCompare(b.name));
+}
+
+// --- Filter state ---
+let _activeFilters = { season: null, characters: new Set(), functions: new Set() };
+let _allCharacters = [];
+let _allFunctions = [];
+
+function _applyFilters(container) {
+  const table = container.querySelector('.timeline-grid');
+  if (!table) return;
+
+  const { season, characters, functions } = _activeFilters;
+  const hasCharFilter = characters.size > 0;
+  const hasFnFilter = functions.size > 0;
+
+  // Season filter: show/hide episode columns
+  const headerCells = table.querySelectorAll('thead th');
+  const columnVisible = [];
+  headerCells.forEach((th, idx) => {
+    if (idx === 0) { columnVisible.push(true); return; } // sticky col always visible
+    const epCode = th.querySelector('.ep-code');
+    if (!epCode) { columnVisible.push(true); return; }
+    const code = epCode.textContent;
+    const match = code.match(/^S(\d+)/);
+    const visible = !season || (match && match[1] === season);
+    th.style.display = visible ? '' : 'none';
+    columnVisible.push(visible);
+  });
+
+  // Apply column visibility to body cells
+  const rows = table.querySelectorAll('tbody tr');
+  rows.forEach(tr => {
+    const cells = tr.querySelectorAll('td');
+    cells.forEach((td, idx) => {
+      if (idx < columnVisible.length) {
+        td.style.display = columnVisible[idx] ? '' : 'none';
+      }
+    });
+  });
+
+  // Event card visibility: character and function filters
+  const cards = table.querySelectorAll('.event-card');
+  cards.forEach(card => {
+    const cardChars = (card.dataset.characters || '').split(',').filter(Boolean);
+    const cardFn = card.dataset.function || '';
+
+    let visible = true;
+    if (hasCharFilter) {
+      visible = cardChars.some(c => characters.has(c));
+    }
+    if (visible && hasFnFilter) {
+      visible = functions.has(cardFn);
+    }
+    card.style.display = visible ? '' : 'none';
+  });
+
+  // Update legend active states
+  const legendContainer = container.closest('#screen-grid') || container.parentElement;
+  if (legendContainer) {
+    const legendWrap = legendContainer.querySelector('.legend');
+    if (legendWrap) {
+      if (hasFnFilter) {
+        legendWrap.classList.add('legend-filtering');
+      } else {
+        legendWrap.classList.remove('legend-filtering');
+      }
+      legendWrap.querySelectorAll('.legend-filter').forEach(item => {
+        const fn = item.dataset.function;
+        if (fn) {
+          item.classList.toggle('legend-active', functions.has(fn));
+        }
+      });
+    }
+  }
+}
+
+function _renderFilters(data, container) {
+  const episodes = data.episodes || [];
+  const cast = data.cast || [];
+  const seasons = extractSeasons(episodes);
+  _allFunctions = collectFunctions(episodes);
+  _allCharacters = collectAllCharacters(episodes, cast);
+
+  const wrapper = document.createElement('div');
+  wrapper.className = 'sticky-top';
+
+  const filtersDiv = document.createElement('div');
+  filtersDiv.className = 'filters';
+
+  // Season dropdown (only if multiple seasons)
+  if (seasons.length > 1) {
+    const select = document.createElement('select');
+    select.className = 'filter-select';
+    const allOpt = document.createElement('option');
+    allOpt.value = '';
+    allOpt.textContent = 'All seasons';
+    select.appendChild(allOpt);
+    for (const s of seasons) {
+      const opt = document.createElement('option');
+      opt.value = s;
+      opt.textContent = `Season ${parseInt(s, 10)}`;
+      select.appendChild(opt);
+    }
+    select.addEventListener('change', () => {
+      _activeFilters.season = select.value || null;
+      _applyFilters(container);
+    });
+    filtersDiv.appendChild(select);
+  }
+
+  // Character checkboxes dropdown
+  if (_allCharacters.length > 0) {
+    const details = document.createElement('details');
+    details.className = 'filter-dropdown';
+    const summary = document.createElement('summary');
+    summary.textContent = 'Characters';
+    details.appendChild(summary);
+
+    const list = document.createElement('div');
+    list.className = 'filter-list';
+    for (const ch of _allCharacters) {
+      const label = document.createElement('label');
+      const cb = document.createElement('input');
+      cb.type = 'checkbox';
+      cb.value = ch.id;
+      cb.addEventListener('change', () => {
+        if (cb.checked) {
+          _activeFilters.characters.add(ch.id);
+        } else {
+          _activeFilters.characters.delete(ch.id);
+        }
+        _applyFilters(container);
+      });
+      label.appendChild(cb);
+      const span = document.createElement('span');
+      span.textContent = ` ${ch.name}`;
+      if (ch.is_guest) span.className = 'guest-char';
+      label.appendChild(span);
+      list.appendChild(label);
+    }
+    details.appendChild(list);
+    filtersDiv.appendChild(details);
+  }
+
+  wrapper.appendChild(filtersDiv);
+
+  // Function legend (clickable chips)
+  if (_allFunctions.length > 0) {
+    const legend = document.createElement('div');
+    legend.className = 'legend';
+    for (const fn of _allFunctions) {
+      const chip = document.createElement('span');
+      chip.className = `legend-item legend-filter fn-${fn}`;
+      chip.dataset.function = fn;
+      chip.textContent = FUNCTION_LABELS[fn] || fn;
+      chip.addEventListener('click', () => {
+        if (_activeFilters.functions.has(fn)) {
+          _activeFilters.functions.delete(fn);
+        } else {
+          _activeFilters.functions.add(fn);
+        }
+        _applyFilters(container);
+      });
+      legend.appendChild(chip);
+    }
+    wrapper.appendChild(legend);
+  }
+
+  return wrapper;
+}
+
+/**
+ * Show a read-only modal with event details.
+ */
+function _showEventModal(ev, cast) {
+  const overlay = document.getElementById('modal-overlay');
+  const body = document.getElementById('modal-body');
+  if (!overlay || !body) return;
+
+  const chars = (ev.characters || [])
+    .map(c => {
+      const name = resolveCharacterName(c, cast);
+      return isGuest(c) ? `<em>${name}</em> (guest)` : name;
+    })
+    .join(', ');
+
+  const fnLabel = FUNCTION_LABELS[ev.function] || ev.function || '—';
+
+  body.innerHTML = `
+    <div class="detail-field">
+      <label>Event</label>
+      <div class="value">${ev.event}</div>
+    </div>
+    <div class="detail-field">
+      <label>Function</label>
+      <div class="value"><span class="event-card fn-${ev.function}" style="display:inline-block">${fnLabel}</span></div>
+    </div>
+    <div class="detail-field">
+      <label>Characters</label>
+      <div class="value">${chars || '—'}</div>
+    </div>
+    ${ev.also_affects ? `
+    <div class="detail-field">
+      <label>Also affects</label>
+      <div class="value">${ev.also_affects.join(', ')}</div>
+    </div>` : ''}
+  `;
+
+  overlay.classList.remove('hidden');
+}
+
+/**
+ * Render the plotline x episode grid into a container element.
+ *
+ * Args:
+ *   data: tvplotlines result JSON object.
+ *   container: DOM element to render into.
+ */
+function renderGrid(data, container) {
+  const episodes = data.episodes || [];
+  const cast = data.cast || [];
+  const plotlines = [...(data.plotlines || [])].sort(
+    (a, b) => (RANK_ORDER[a.rank] ?? 99) - (RANK_ORDER[b.rank] ?? 99)
+  );
+
+  const eventGrid = buildEventGrid(episodes);
+  const unassigned = buildUnassigned(episodes);
+  const hasUnassigned = Object.keys(unassigned).length > 0;
+
+  // Reset filter state
+  _activeFilters = { season: null, characters: new Set(), functions: new Set() };
+
+  container.innerHTML = '';
+
+  // Filters
+  const filtersEl = _renderFilters(data, container);
+  container.appendChild(filtersEl);
+
+  // Grid wrapper
+  const gridWrap = document.createElement('div');
+  gridWrap.className = 'grid-container';
+
+  // Table
+  const table = document.createElement('table');
+  table.className = 'timeline-grid';
+
+  // Thead
+  const thead = document.createElement('thead');
+  const headerRow = document.createElement('tr');
+
+  const thPlotline = document.createElement('th');
+  thPlotline.className = 'sticky-col header-cell';
+  thPlotline.textContent = 'Plotline';
+  headerRow.appendChild(thPlotline);
+
+  for (const ep of episodes) {
+    const th = document.createElement('th');
+    th.className = 'header-cell';
+    const codeDiv = document.createElement('div');
+    codeDiv.className = 'ep-code';
+    codeDiv.textContent = ep.episode;
+    th.appendChild(codeDiv);
+
+    if (ep.theme) {
+      const themeDiv = document.createElement('div');
+      themeDiv.className = 'ep-theme';
+      const truncated = ep.theme.length > 60 ? ep.theme.slice(0, 60) + '\u2026' : ep.theme;
+      themeDiv.textContent = 'Theme: ' + truncated;
+      th.appendChild(themeDiv);
+    }
+    headerRow.appendChild(th);
+  }
+  thead.appendChild(headerRow);
+  table.appendChild(thead);
+
+  // Tbody
+  const tbody = document.createElement('tbody');
+
+  for (const pl of plotlines) {
+    const tr = document.createElement('tr');
+
+    // Plotline cell
+    const tdPl = document.createElement('td');
+    tdPl.className = 'sticky-col plotline-cell';
+    tdPl.dataset.plotlineId = pl.id;
+
+    const nameDiv = document.createElement('div');
+    nameDiv.className = 'plotline-name';
+    nameDiv.textContent = pl.name;
+    tdPl.appendChild(nameDiv);
+
+    const rankSpan = document.createElement('span');
+    rankSpan.className = `rank-badge rank-${pl.rank.toLowerCase()}`;
+    rankSpan.textContent = pl.rank;
+    tdPl.appendChild(rankSpan);
+
+    // Characters for this plotline
+    const plChars = plotlineCharacters(episodes, pl.id);
+    if (plChars.length > 0) {
+      const charsDiv = document.createElement('div');
+      charsDiv.className = 'plotline-characters';
+      const charSpans = plChars.map(c => {
+        const name = resolveCharacterName(c, cast);
+        if (isGuest(c)) return `<span class="guest-char">${name}</span>`;
+        return `<span>${name}</span>`;
+      });
+      charsDiv.innerHTML = charSpans.join(', ');
+      tdPl.appendChild(charsDiv);
+    }
+    tr.appendChild(tdPl);
+
+    // Episode cells
+    for (const ep of episodes) {
+      const events = (eventGrid[pl.id] && eventGrid[pl.id][ep.episode]) || [];
+      const td = document.createElement('td');
+      td.className = events.length > 0 ? 'event-cell' : 'event-cell empty-cell';
+
+      for (const ev of events) {
+        const card = document.createElement('div');
+        card.className = `event-card fn-${ev.function}`;
+        card.textContent = ev.event;
+        // Store data for filtering
+        card.dataset.characters = (ev.characters || []).join(',');
+        card.dataset.function = ev.function || '';
+        card.addEventListener('click', () => _showEventModal(ev, cast));
+        td.appendChild(card);
+      }
+      tr.appendChild(td);
+    }
+    tbody.appendChild(tr);
+  }
+
+  // Unassigned row
+  if (hasUnassigned) {
+    const tr = document.createElement('tr');
+    tr.className = 'unassigned-row';
+
+    const tdLabel = document.createElement('td');
+    tdLabel.className = 'sticky-col plotline-cell';
+    const labelDiv = document.createElement('div');
+    labelDiv.className = 'plotline-name unassigned-label';
+    labelDiv.textContent = 'Unassigned';
+    tdLabel.appendChild(labelDiv);
+    tr.appendChild(tdLabel);
+
+    for (const ep of episodes) {
+      const orphans = unassigned[ep.episode] || [];
+      const td = document.createElement('td');
+      td.className = orphans.length > 0 ? 'event-cell' : 'event-cell empty-cell';
+
+      for (const ev of orphans) {
+        const card = document.createElement('div');
+        card.className = `event-card fn-${ev.function} unassigned-event`;
+        card.textContent = ev.event;
+        card.dataset.characters = (ev.characters || []).join(',');
+        card.dataset.function = ev.function || '';
+        card.addEventListener('click', () => _showEventModal(ev, cast));
+        td.appendChild(card);
+      }
+      tr.appendChild(td);
+    }
+    tbody.appendChild(tr);
+  }
+
+  table.appendChild(tbody);
+  gridWrap.appendChild(table);
+  container.appendChild(gridWrap);
+}

From 29a290f4eec3958c48dd2609269b21af710f8b5b Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Thu, 9 Apr 2026 23:03:51 +0200
Subject: [PATCH 05/24] Add analytics rendering with 5 sections ported from
 tvplotlines-app

Port computation (analytics.py) and rendering (analytics.html) to
standalone JS: scorecard, arc map, episode pulse, convergence moments,
character weight. Wire up Analytics button in app.js.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/tvplotlines/html/parts/analytics.js | 568 ++++++++++++++++++++++++
 src/tvplotlines/html/parts/app.js       |  12 +-
 2 files changed, 579 insertions(+), 1 deletion(-)
 create mode 100644 src/tvplotlines/html/parts/analytics.js

diff --git a/src/tvplotlines/html/parts/analytics.js b/src/tvplotlines/html/parts/analytics.js
new file mode 100644
index 0000000..c601933
--- /dev/null
+++ b/src/tvplotlines/html/parts/analytics.js
@@ -0,0 +1,568 @@
+// Analytics — computation and rendering for 5 analytics sections.
+// Ported from tvplotlines-app analytics.py + analytics.html.
+
+const FUNCTION_TENSION = {
+  setup: 1, seed: 1, inciting_incident: 1.5,
+  escalation: 2, turning_point: 3, crisis: 3.5,
+  climax: 4, cliffhanger: 4, resolution: 0.5,
+};
+
+// RANK_ORDER is already defined in grid.js (loaded first)
+
+// --- Computation ---
+
+function _epNum(code) {
+  return code.split('E').pop();
+}
+
+function _arcSummary(funcCounts) {
+  const entries = Object.entries(funcCounts);
+  if (entries.length === 0) return '';
+
+  const total = entries.reduce((s, [, c]) => s + c, 0);
+  entries.sort((a, b) => b[1] - a[1]);
+  const dominant = entries[0];
+
+  const parts = [];
+  if (dominant[1] / total > 0.4) {
+    parts.push(dominant[0] + '-heavy');
+  }
+
+  const highTension = ['climax', 'crisis', 'turning_point'];
+  for (const fn of highTension) {
+    const count = funcCounts[fn] || 0;
+    if (count > 0) {
+      parts.push(fn + ' (' + count + ')');
+      break;
+    }
+  }
+
+  if (parts.length === 0) {
+    parts.push(dominant[0]);
+  }
+  return parts.join(', ');
+}
+
+function computeScorecard(data) {
+  const plotlines = _sortedPlotlines(data);
+  const episodes = data.episodes || [];
+  const epCodes = episodes.map(ep => ep.episode);
+
+  const result = [];
+  for (const pl of plotlines) {
+    const pid = pl.id;
+    const funcCounts = {};
+    for (const ep of episodes) {
+      for (const ev of ep.events || []) {
+        const evPl = ev.plotline_id || ev.storyline || ev.plotline;
+        if (evPl === pid) {
+          const fn = ev.function || 'unknown';
+          funcCounts[fn] = (funcCounts[fn] || 0) + 1;
+        }
+      }
+    }
+    const eventCount = Object.values(funcCounts).reduce((s, c) => s + c, 0);
+    result.push({
+      id: pid,
+      name: pl.name || pid,
+      rank: pl.rank || '',
+      span: pl.span || [],
+      event_count: eventCount,
+      arc_summary: _arcSummary(funcCounts),
+    });
+  }
+  return { plotlines: result, episode_codes: epCodes };
+}
+
+function computeArcMap(data) {
+  const plotlines = _sortedPlotlines(data);
+  const episodes = data.episodes || [];
+
+  const epLabels = episodes.map(ep => 'E' + _epNum(ep.episode));
+  const themes = episodes.map(ep => ep.theme || '');
+
+  const plRows = [];
+  for (const pl of plotlines) {
+    const pid = pl.id;
+    const cells = [];
+    for (const ep of episodes) {
+      const funcs = [];
+      for (const ev of ep.events || []) {
+        const evPl = ev.plotline_id || ev.storyline || ev.plotline;
+        if (evPl === pid) {
+          funcs.push(ev.function || 'escalation');
+        }
+      }
+      const eventCount = funcs.length;
+      let tension = 0;
+      if (eventCount > 0) {
+        tension = funcs.reduce((s, f) => s + (FUNCTION_TENSION[f] || 2), 0) / eventCount;
+      }
+      cells.push({ tension: Math.round(tension * 10) / 10, events: eventCount });
+    }
+    plRows.push({
+      id: pid,
+      name: pl.name || pid,
+      rank: pl.rank || '',
+      cells: cells,
+    });
+  }
+  return { episodes: epLabels, themes: themes, plotlines: plRows };
+}
+
+function computePulse(data) {
+  const plotlines = data.plotlines || [];
+  const episodes = data.episodes || [];
+  const plNames = {};
+  for (const p of plotlines) plNames[p.id] = p.name || p.id;
+
+  const result = [];
+  for (const ep of episodes) {
+    const epNum = _epNum(ep.episode);
+    const counts = {};
+    for (const ev of ep.events || []) {
+      const pid = ev.plotline_id || ev.storyline || ev.plotline;
+      if (pid) counts[pid] = (counts[pid] || 0) + 1;
+    }
+    const segments = Object.entries(counts)
+      .sort((a, b) => b[1] - a[1])
+      .map(([pid, c]) => ({
+        plotline_id: pid,
+        plotline_name: plNames[pid] || pid,
+        count: c,
+      }));
+    const total = segments.reduce((s, seg) => s + seg.count, 0);
+    result.push({
+      episode: 'E' + epNum,
+      theme: ep.theme || '',
+      total: total,
+      segments: segments,
+    });
+  }
+  return result;
+}
+
+function computeConvergence(data) {
+  const plotlineMap = {};
+  for (const p of data.plotlines || []) plotlineMap[p.id] = p;
+
+  const episodes = data.episodes || [];
+  const result = [];
+
+  for (const ep of episodes) {
+    const interactions = ep.interactions || [];
+    if (interactions.length === 0) continue;
+
+    const epNum = _epNum(ep.episode);
+    const items = [];
+    for (const inter of interactions) {
+      const lineIds = inter.lines || [];
+      const lineNames = lineIds.map(lid => {
+        const pl = plotlineMap[lid];
+        return pl ? (pl.name || lid) : lid;
+      });
+      items.push({
+        type: inter.type || '',
+        lines: lineNames,
+        description: inter.description || '',
+      });
+    }
+    result.push({
+      episode: 'E' + epNum,
+      theme: ep.theme || '',
+      interactions: items,
+    });
+  }
+  return result;
+}
+
+function computeCharacters(data) {
+  const episodes = data.episodes || [];
+  const castMap = {};
+  for (const c of data.cast || []) castMap[c.id] = c.name;
+
+  const charEvents = {};
+  const charPlotlines = {};
+
+  for (const ep of episodes) {
+    for (const ev of ep.events || []) {
+      const pid = ev.plotline_id || ev.storyline || ev.plotline || '';
+      for (const cid of ev.characters || []) {
+        charEvents[cid] = (charEvents[cid] || 0) + 1;
+        if (pid) {
+          if (!charPlotlines[cid]) charPlotlines[cid] = {};
+          charPlotlines[cid][pid] = (charPlotlines[cid][pid] || 0) + 1;
+        }
+      }
+    }
+  }
+
+  const result = [];
+  const sorted = Object.entries(charEvents).sort((a, b) => b[1] - a[1]);
+  for (const [cid, count] of sorted) {
+    if (count < 2) continue;
+    const name = castMap[cid] || cid.replace('guest:', '').replace(/_/g, ' ').replace(/\b\w/g, c => c.toUpperCase());
+    const plCounts = charPlotlines[cid] || {};
+    const plSegments = Object.entries(plCounts)
+      .sort((a, b) => b[1] - a[1])
+      .map(([pid, c]) => ({ plotline_id: pid, plotline_name: pid, count: c }));
+    result.push({
+      id: cid,
+      name: name,
+      event_count: count,
+      plotline_count: Object.keys(plCounts).length,
+      plotline_segments: plSegments,
+    });
+  }
+  return result;
+}
+
+function _sortedPlotlines(data) {
+  return [...(data.plotlines || [])].sort(
+    (a, b) => (RANK_ORDER[a.rank] ?? 99) - (RANK_ORDER[b.rank] ?? 99)
+  );
+}
+
+// --- Rendering ---
+
+function _tensionLevel(t) {
+  if (t <= 1.2) return 1;
+  if (t <= 2.0) return 2;
+  if (t <= 2.8) return 3;
+  if (t <= 3.5) return 4;
+  return 5;
+}
+
+/**
+ * Render all 5 analytics sections into the given container.
+ *
+ * Args:
+ *   data: tvplotlines result JSON object.
+ *   container: DOM element to render into.
+ */
+function renderAnalytics(data, container) {
+  const storyEngine = (data.context || {}).story_engine || '';
+  const scorecard = computeScorecard(data);
+  const arcMap = computeArcMap(data);
+  const pulse = computePulse(data);
+  const convergence = computeConvergence(data);
+  const characters = computeCharacters(data);
+
+  container.innerHTML = '';
+
+  container.appendChild(_renderScorecard(scorecard, storyEngine));
+  container.appendChild(_renderArcMap(arcMap));
+  container.appendChild(_renderPulse(pulse));
+  container.appendChild(_renderConvergence(convergence));
+  container.appendChild(_renderCharacters(characters));
+}
+
+function _renderScorecard(scorecard, storyEngine) {
+  const section = _section('Season Scorecard');
+
+  if (storyEngine) {
+    const engine = document.createElement('div');
+    engine.className = 'ana-engine';
+    engine.textContent = storyEngine;
+    section.appendChild(engine);
+  }
+
+  const table = document.createElement('table');
+  table.className = 'ana-scorecard';
+
+  const thead = document.createElement('thead');
+  thead.innerHTML = '<tr><th>Rank</th><th>Plotline</th><th>Span</th><th>Events</th><th>Arc</th></tr>';
+  table.appendChild(thead);
+
+  const tbody = document.createElement('tbody');
+  for (const pl of scorecard.plotlines) {
+    const tr = document.createElement('tr');
+
+    // Rank
+    const tdRank = document.createElement('td');
+    const badge = document.createElement('span');
+    badge.className = 'rank-badge rank-' + (pl.rank || '').toLowerCase();
+    badge.textContent = pl.rank;
+    tdRank.appendChild(badge);
+    tr.appendChild(tdRank);
+
+    // Name
+    const tdName = document.createElement('td');
+    tdName.className = 'ana-plotline-name';
+    tdName.textContent = pl.name;
+    tr.appendChild(tdName);
+
+    // Span dots
+    const tdSpan = document.createElement('td');
+    const spanBar = document.createElement('div');
+    spanBar.className = 'ana-span-bar';
+    for (const ep of scorecard.episode_codes) {
+      const dot = document.createElement('div');
+      dot.className = 'ana-span-dot ' + (pl.span.includes(ep) ? 'active' : 'inactive');
+      spanBar.appendChild(dot);
+    }
+    tdSpan.appendChild(spanBar);
+    tr.appendChild(tdSpan);
+
+    // Events
+    const tdEvents = document.createElement('td');
+    tdEvents.textContent = pl.event_count;
+    tr.appendChild(tdEvents);
+
+    // Arc
+    const tdArc = document.createElement('td');
+    tdArc.className = 'ana-arc-summary';
+    tdArc.textContent = pl.arc_summary;
+    tr.appendChild(tdArc);
+
+    tbody.appendChild(tr);
+  }
+  table.appendChild(tbody);
+  section.appendChild(table);
+  return section;
+}
+
+function _renderArcMap(arcMap) {
+  const section = _section('Arc Map');
+
+  // Find max events for circle sizing
+  let maxEvents = 1;
+  for (const pl of arcMap.plotlines) {
+    for (const cell of pl.cells) {
+      if (cell.events > maxEvents) maxEvents = cell.events;
+    }
+  }
+
+  // Legend
+  const legend = document.createElement('div');
+  legend.className = 'ana-legend';
+  legend.innerHTML =
+    '<span class="ana-legend-label">low tension</span>' +
+    '<div class="ana-gradient">' +
+      '<div class="ana-grad-step" style="background: var(--ana-tension-1);"></div>' +
+      '<div class="ana-grad-step" style="background: var(--ana-tension-2);"></div>' +
+      '<div class="ana-grad-step" style="background: var(--ana-tension-3);"></div>' +
+      '<div class="ana-grad-step" style="background: var(--ana-tension-4);"></div>' +
+      '<div class="ana-grad-step" style="background: var(--ana-tension-5);"></div>' +
+    '</div>' +
+    '<span class="ana-legend-label">high tension</span>' +
+    '<span class="ana-legend-hint">circle size = event count</span>';
+  section.appendChild(legend);
+
+  // Grid
+  const numEps = arcMap.episodes.length;
+  const grid = document.createElement('div');
+  grid.className = 'ana-arcmap';
+  grid.style.gridTemplateColumns = '140px repeat(' + numEps + ', 1fr)';
+
+  // Header row: empty corner + episode labels
+  grid.appendChild(document.createElement('div'));
+  for (const ep of arcMap.episodes) {
+    const header = document.createElement('div');
+    header.className = 'ana-arcmap-header';
+    header.textContent = ep;
+    grid.appendChild(header);
+  }
+
+  // Plotline rows
+  for (const pl of arcMap.plotlines) {
+    const label = document.createElement('div');
+    label.className = 'ana-arcmap-label';
+    const badgeSpan = document.createElement('span');
+    badgeSpan.className = 'rank-badge rank-' + (pl.rank || '').toLowerCase();
+    badgeSpan.textContent = pl.rank;
+    label.appendChild(badgeSpan);
+    // Trim prefix before ": " if present
+    const shortName = pl.name.includes(': ') ? pl.name.split(': ').pop() : pl.name;
+    label.appendChild(document.createTextNode(' ' + shortName));
+    grid.appendChild(label);
+
+    for (const cell of pl.cells) {
+      const cellDiv = document.createElement('div');
+      if (cell.events > 0) {
+        const level = _tensionLevel(cell.tension);
+        cellDiv.className = 'ana-arcmap-cell ana-tension-' + level;
+        const size = Math.floor(16 + (28 * cell.events / maxEvents));
+        const circle = document.createElement('div');
+        circle.className = 'ana-arc-circle';
+        circle.style.width = size + 'px';
+        circle.style.height = size + 'px';
+        circle.textContent = cell.events;
+        cellDiv.appendChild(circle);
+      } else {
+        cellDiv.className = 'ana-arcmap-cell ana-tension-0';
+        const empty = document.createElement('span');
+        empty.className = 'ana-arc-empty';
+        empty.innerHTML = '&mdash;';
+        cellDiv.appendChild(empty);
+      }
+      grid.appendChild(cellDiv);
+    }
+  }
+
+  // Theme row
+  const themeLabel = document.createElement('div');
+  themeLabel.className = 'ana-arcmap-theme-label';
+  themeLabel.textContent = 'theme';
+  grid.appendChild(themeLabel);
+  for (const theme of arcMap.themes) {
+    const themeDiv = document.createElement('div');
+    themeDiv.className = 'ana-arcmap-theme';
+    themeDiv.textContent = theme;
+    grid.appendChild(themeDiv);
+  }
+
+  section.appendChild(grid);
+  return section;
+}
+
+function _renderPulse(pulse) {
+  const section = _section('Episode Pulse');
+
+  let maxTotal = 1;
+  for (const ep of pulse) {
+    if (ep.total > maxTotal) maxTotal = ep.total;
+  }
+
+  for (const ep of pulse) {
+    const row = document.createElement('div');
+    row.className = 'ana-pulse-row';
+
+    const epLabel = document.createElement('div');
+    epLabel.className = 'ana-pulse-ep';
+    epLabel.textContent = ep.episode;
+    row.appendChild(epLabel);
+
+    const wrap = document.createElement('div');
+    wrap.className = 'ana-pulse-wrap';
+    const bars = document.createElement('div');
+    bars.className = 'ana-pulse-bars';
+    bars.style.width = (ep.total / maxTotal * 100).toFixed(1) + '%';
+
+    for (const seg of ep.segments) {
+      const bar = document.createElement('div');
+      bar.className = 'ana-pulse-bar';
+      bar.style.flex = seg.count;
+      bar.title = seg.plotline_name + ': ' + seg.count;
+      if (seg.count >= 2) bar.textContent = seg.count;
+      bars.appendChild(bar);
+    }
+    wrap.appendChild(bars);
+    row.appendChild(wrap);
+
+    const totalDiv = document.createElement('div');
+    totalDiv.className = 'ana-pulse-total';
+    totalDiv.textContent = ep.total;
+    row.appendChild(totalDiv);
+
+    const themeDiv = document.createElement('div');
+    themeDiv.className = 'ana-pulse-theme';
+    themeDiv.textContent = ep.theme;
+    row.appendChild(themeDiv);
+
+    section.appendChild(row);
+  }
+  return section;
+}
+
+function _renderConvergence(convergence) {
+  const section = _section('Convergence Moments');
+
+  const timeline = document.createElement('div');
+  timeline.className = 'ana-conv-timeline';
+
+  const line = document.createElement('div');
+  line.className = 'ana-conv-line';
+  timeline.appendChild(line);
+
+  for (const ep of convergence) {
+    const group = document.createElement('div');
+    group.className = 'ana-conv-group';
+
+    const epDiv = document.createElement('div');
+    epDiv.className = 'ana-conv-ep';
+    epDiv.innerHTML = ep.episode + ' &mdash; ' + _escapeHtml(ep.theme);
+    group.appendChild(epDiv);
+
+    for (const inter of ep.interactions) {
+      const item = document.createElement('div');
+      item.className = 'ana-conv-item';
+
+      const typeSpan = document.createElement('span');
+      typeSpan.className = 'ana-conv-type ana-conv-' + inter.type;
+      typeSpan.textContent = inter.type.replace(/_/g, ' ');
+      item.appendChild(typeSpan);
+
+      const linesSpan = document.createElement('span');
+      linesSpan.className = 'ana-conv-lines';
+      linesSpan.textContent = inter.lines.join(' + ');
+      item.appendChild(linesSpan);
+
+      const descSpan = document.createElement('span');
+      descSpan.className = 'ana-conv-desc';
+      descSpan.textContent = inter.description;
+      item.appendChild(descSpan);
+
+      group.appendChild(item);
+    }
+    timeline.appendChild(group);
+  }
+
+  section.appendChild(timeline);
+  return section;
+}
+
+function _renderCharacters(characters) {
+  const section = _section('Character Weight');
+
+  const maxCount = characters.length > 0 ? characters[0].event_count : 1;
+
+  for (const ch of characters) {
+    const row = document.createElement('div');
+    row.className = 'ana-char-row';
+
+    const name = document.createElement('div');
+    name.className = 'ana-char-name';
+    name.textContent = ch.name;
+    row.appendChild(name);
+
+    const barWrap = document.createElement('div');
+    barWrap.className = 'ana-char-bar-wrap';
+    const bar = document.createElement('div');
+    bar.className = 'ana-char-bar';
+    bar.style.width = (ch.event_count / maxCount * 100).toFixed(1) + '%';
+    bar.textContent = ch.event_count;
+    barWrap.appendChild(bar);
+    row.appendChild(barWrap);
+
+    const dots = document.createElement('div');
+    dots.className = 'ana-char-dots';
+    for (let i = 0; i < ch.plotline_count; i++) {
+      const dot = document.createElement('div');
+      dot.className = 'ana-char-dot';
+      dots.appendChild(dot);
+    }
+    row.appendChild(dots);
+
+    section.appendChild(row);
+  }
+  return section;
+}
+
+// --- Helpers ---
+
+function _section(title) {
+  const section = document.createElement('section');
+  section.className = 'ana-section';
+  const h2 = document.createElement('h2');
+  h2.className = 'ana-title';
+  h2.textContent = title;
+  section.appendChild(h2);
+  return section;
+}
+
+function _escapeHtml(str) {
+  const div = document.createElement('div');
+  div.textContent = str;
+  return div.innerHTML;
+}
diff --git a/src/tvplotlines/html/parts/app.js b/src/tvplotlines/html/parts/app.js
index cea213c..5230d4b 100644
--- a/src/tvplotlines/html/parts/app.js
+++ b/src/tvplotlines/html/parts/app.js
@@ -56,8 +56,12 @@ function _initApp() {
   const fileUpload = document.getElementById('file-upload');
   const gridTitle = document.getElementById('grid-title');
 
+  // Track loaded data for analytics navigation
+  let _currentData = null;
+
   function loadData(data, title) {
     if (!container) return;
+    _currentData = data;
     renderGrid(data, container);
     if (gridTitle) gridTitle.textContent = title || 'Plotlines';
     showScreen('grid');
@@ -93,7 +97,13 @@ function _initApp() {
     btnBackGrid.addEventListener('click', () => showScreen('grid'));
   }
   if (btnAnalytics) {
-    btnAnalytics.addEventListener('click', () => showScreen('analytics'));
+    btnAnalytics.addEventListener('click', () => {
+      if (_currentData) {
+        const analyticsContainer = document.getElementById('analytics-container');
+        if (analyticsContainer) renderAnalytics(_currentData, analyticsContainer);
+      }
+      showScreen('analytics');
+    });
   }
 
   // Auto-load demo if data is present and URL has #demo

From 5cdcd6262be0e3dd194ccd719e244298513c314f Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Thu, 9 Apr 2026 23:07:04 +0200
Subject: [PATCH 06/24] Add router, localStorage Store, toolbar, and JSON
 import

Store object centralizes all localStorage access (API keys, results,
settings, onboarding state). Toolbar now has series dropdown, Grid/Analytics
tab buttons, dark mode toggle, load/export/LLM/onboarding placeholders.
Series switching re-renders current view and persists last selection.
Drop zone overlay supports drag-and-drop and file picker for JSON import.
Init logic checks onboarding state and restores last session.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/tvplotlines/html/parts/app.js     | 362 ++++++++++++++++++++++----
 src/tvplotlines/html/parts/shell.html |  49 +++-
 src/tvplotlines/html/parts/style.css  |  39 ++-
 3 files changed, 388 insertions(+), 62 deletions(-)

diff --git a/src/tvplotlines/html/parts/app.js b/src/tvplotlines/html/parts/app.js
index 5230d4b..80e2a3f 100644
--- a/src/tvplotlines/html/parts/app.js
+++ b/src/tvplotlines/html/parts/app.js
@@ -1,4 +1,43 @@
-// App init — screen routing, dark mode, demo data loading.
+// App init — Store, screen routing, toolbar, series switching, JSON import.
+
+// --- localStorage manager ---
+
+const Store = {
+  getKey: () => localStorage.getItem('tvplotlines_api_key'),
+  getProvider: () => localStorage.getItem('tvplotlines_provider'),
+  setKey: (provider, key) => {
+    localStorage.setItem('tvplotlines_provider', provider);
+    localStorage.setItem('tvplotlines_api_key', key);
+  },
+  getResults: () => JSON.parse(localStorage.getItem('tvplotlines_results') || '{}'),
+  saveResult: (name, data) => {
+    const results = Store.getResults();
+    results[name] = data;
+    localStorage.setItem('tvplotlines_results', JSON.stringify(results));
+  },
+  removeResult: (name) => {
+    const results = Store.getResults();
+    delete results[name];
+    localStorage.setItem('tvplotlines_results', JSON.stringify(results));
+  },
+  getSettings: () => JSON.parse(localStorage.getItem('tvplotlines_settings') || '{}'),
+  saveSetting: (key, val) => {
+    const s = Store.getSettings();
+    s[key] = val;
+    localStorage.setItem('tvplotlines_settings', JSON.stringify(s));
+  },
+  hasSeenOnboarding: () => localStorage.getItem('tvplotlines_onboarding_seen') === 'true',
+  markOnboardingSeen: () => localStorage.setItem('tvplotlines_onboarding_seen', 'true'),
+};
+
+// --- Screen routing ---
+
+/** @type {string} Current active tab: 'grid' or 'analytics' */
+let _activeTab = 'grid';
+/** @type {object|null} Currently loaded plotlines data */
+let _currentData = null;
+/** @type {string|null} Name of the currently loaded series */
+let _currentSeriesName = null;
 
 function showScreen(name) {
   document.querySelectorAll('.screen').forEach(el => el.classList.remove('active'));
@@ -6,19 +45,32 @@ function showScreen(name) {
   if (target) target.classList.add('active');
 }
 
+// --- Dark mode ---
+
 function toggleDark() {
-  const root = document.documentElement;
-  const isDark = root.classList.toggle('dark');
-  localStorage.setItem('tvplotlines-dark', isDark ? '1' : '0');
+  const isDark = document.documentElement.classList.toggle('dark');
+  Store.saveSetting('dark', isDark);
+  _updateDarkIcon();
 }
 
 function _restoreDarkMode() {
-  const pref = localStorage.getItem('tvplotlines-dark');
-  if (pref === '1') {
+  const settings = Store.getSettings();
+  if (settings.dark) {
     document.documentElement.classList.add('dark');
   }
+  _updateDarkIcon();
 }
 
+function _updateDarkIcon() {
+  const btn = document.getElementById('btn-dark');
+  if (!btn) return;
+  const isDark = document.documentElement.classList.contains('dark');
+  btn.textContent = isDark ? '\u2600' : '\u263E';
+  btn.title = isDark ? 'Switch to light mode' : 'Switch to dark mode';
+}
+
+// --- Demo data ---
+
 function _loadDemoData() {
   const el = document.getElementById('demo-data');
   if (!el || !el.textContent.trim()) return null;
@@ -30,11 +82,177 @@ function _loadDemoData() {
   }
 }
 
-function _initApp() {
-  _restoreDarkMode();
+// --- Series management ---
 
-  const container = document.getElementById('grid-container');
+function _seriesName(data) {
+  // Derive a display name from data metadata
+  const ctx = data.context || {};
+  if (ctx.series && ctx.season) return ctx.series + ' ' + ctx.season;
+  if (ctx.series) return ctx.series;
+  return null;
+}
+
+function _populateSeriesDropdown() {
+  const select = document.getElementById('series-select');
+  if (!select) return;
+
+  const currentValue = select.value;
+  select.innerHTML = '';
+
+  // Demo option (always available if demo data exists)
   const demoData = _loadDemoData();
+  if (demoData) {
+    const opt = document.createElement('option');
+    opt.value = '__demo__';
+    opt.textContent = _seriesName(demoData) || 'Demo';
+    select.appendChild(opt);
+  }
+
+  // Saved results from Store
+  const results = Store.getResults();
+  for (const name of Object.keys(results).sort()) {
+    const opt = document.createElement('option');
+    opt.value = name;
+    opt.textContent = name;
+    select.appendChild(opt);
+  }
+
+  // Restore selection
+  if (currentValue && select.querySelector(`option[value="${CSS.escape(currentValue)}"]`)) {
+    select.value = currentValue;
+  } else if (_currentSeriesName) {
+    select.value = _currentSeriesName;
+  }
+
+  // Hide dropdown if only one option
+  select.style.display = select.options.length <= 1 ? 'none' : '';
+}
+
+function _switchSeries(name) {
+  let data;
+  if (name === '__demo__') {
+    data = _loadDemoData();
+  } else {
+    const results = Store.getResults();
+    data = results[name];
+  }
+
+  if (!data) return;
+
+  _currentSeriesName = name;
+  _currentData = data;
+  Store.saveSetting('lastSeries', name);
+
+  _renderCurrentView();
+}
+
+function _renderCurrentView() {
+  if (!_currentData) return;
+
+  const gridContainer = document.getElementById('grid-container');
+  const analyticsContainer = document.getElementById('analytics-container');
+  const gridTitle = document.getElementById('grid-title');
+
+  const displayName = _currentSeriesName === '__demo__'
+    ? (_seriesName(_currentData) || 'Demo')
+    : _currentSeriesName;
+
+  if (gridTitle) gridTitle.textContent = displayName;
+
+  if (_activeTab === 'grid' && gridContainer) {
+    renderGrid(_currentData, gridContainer);
+  } else if (_activeTab === 'analytics' && analyticsContainer) {
+    renderAnalytics(_currentData, analyticsContainer);
+  }
+}
+
+// --- Tab switching ---
+
+function _setTab(tab) {
+  _activeTab = tab;
+
+  // Update tab button states
+  const btnGrid = document.getElementById('btn-tab-grid');
+  const btnAnalytics = document.getElementById('btn-tab-analytics');
+  if (btnGrid) btnGrid.classList.toggle('btn-nav-active', tab === 'grid');
+  if (btnAnalytics) btnAnalytics.classList.toggle('btn-nav-active', tab === 'analytics');
+
+  _renderCurrentView();
+  showScreen(tab === 'grid' ? 'grid' : 'analytics');
+}
+
+// --- JSON import (file input + drag & drop) ---
+
+function _importJSON(file) {
+  const reader = new FileReader();
+  reader.onload = () => {
+    try {
+      const data = JSON.parse(reader.result);
+      const name = _seriesName(data) || file.name.replace(/\.json$/i, '');
+      Store.saveResult(name, data);
+      _populateSeriesDropdown();
+
+      const select = document.getElementById('series-select');
+      if (select) select.value = name;
+
+      _switchSeries(name);
+      _setTab('grid');
+    } catch (err) {
+      alert('Invalid JSON file');
+    }
+  };
+  reader.readAsText(file);
+}
+
+function _setupDropZone() {
+  const zone = document.getElementById('drop-zone');
+  const fileUpload = document.getElementById('file-upload');
+  if (!zone) return;
+
+  zone.addEventListener('dragover', (e) => {
+    e.preventDefault();
+    zone.classList.add('drop-zone-active');
+  });
+  zone.addEventListener('dragleave', () => {
+    zone.classList.remove('drop-zone-active');
+  });
+  zone.addEventListener('drop', (e) => {
+    e.preventDefault();
+    zone.classList.remove('drop-zone-active');
+    const file = e.dataTransfer.files[0];
+    if (file && file.name.endsWith('.json')) {
+      _importJSON(file);
+      _hideDropZone();
+    }
+  });
+
+  if (fileUpload) {
+    fileUpload.addEventListener('change', (e) => {
+      const file = e.target.files[0];
+      if (file) {
+        _importJSON(file);
+        _hideDropZone();
+      }
+      // Reset so the same file can be re-selected
+      fileUpload.value = '';
+    });
+  }
+}
+
+function _showDropZone() {
+  const zone = document.getElementById('drop-zone');
+  if (zone) zone.classList.remove('hidden');
+}
+
+function _hideDropZone() {
+  const zone = document.getElementById('drop-zone');
+  if (zone) zone.classList.add('hidden');
+}
+
+// --- Init ---
+
+function _initApp() {
+  _restoreDarkMode();
 
   // Modal close
   const modalOverlay = document.getElementById('modal-overlay');
@@ -48,67 +266,107 @@ function _initApp() {
     });
   }
 
-  // Navigation buttons
-  const btnDemo = document.getElementById('btn-demo');
-  const btnBackWelcome = document.getElementById('btn-back-welcome');
-  const btnBackGrid = document.getElementById('btn-back-grid');
-  const btnAnalytics = document.getElementById('btn-analytics');
-  const fileUpload = document.getElementById('file-upload');
-  const gridTitle = document.getElementById('grid-title');
+  // Drop zone
+  _setupDropZone();
+
+  // Toolbar buttons
+  const btnDark = document.getElementById('btn-dark');
+  const btnLoad = document.getElementById('btn-load');
+  const btnTabGrid = document.getElementById('btn-tab-grid');
+  const btnTabAnalytics = document.getElementById('btn-tab-analytics');
+  const seriesSelect = document.getElementById('series-select');
+  const btnExport = document.getElementById('btn-export');
+  const btnOnboarding = document.getElementById('btn-onboarding');
+  const btnLLM = document.getElementById('btn-llm-settings');
 
-  // Track loaded data for analytics navigation
-  let _currentData = null;
+  if (btnDark) btnDark.addEventListener('click', toggleDark);
+  if (btnLoad) btnLoad.addEventListener('click', _showDropZone);
+  if (btnTabGrid) btnTabGrid.addEventListener('click', () => _setTab('grid'));
+  if (btnTabAnalytics) btnTabAnalytics.addEventListener('click', () => _setTab('analytics'));
 
-  function loadData(data, title) {
-    if (!container) return;
-    _currentData = data;
-    renderGrid(data, container);
-    if (gridTitle) gridTitle.textContent = title || 'Plotlines';
-    showScreen('grid');
+  if (seriesSelect) {
+    seriesSelect.addEventListener('change', () => _switchSeries(seriesSelect.value));
   }
 
+  // Placeholders — buttons exist but no action yet
+  if (btnExport) btnExport.addEventListener('click', () => {
+    alert('Export coming in Task 6');
+  });
+  if (btnLLM) btnLLM.addEventListener('click', () => {
+    alert('LLM Settings coming soon');
+  });
+  if (btnOnboarding) btnOnboarding.addEventListener('click', () => {
+    showScreen('welcome');
+  });
+
+  // Welcome screen buttons
+  const btnDemo = document.getElementById('btn-demo');
   if (btnDemo) {
     btnDemo.addEventListener('click', () => {
-      if (demoData) loadData(demoData, 'Demo: Breaking Bad S01');
+      Store.markOnboardingSeen();
+      _switchSeries('__demo__');
+      _setTab('grid');
     });
   }
 
-  if (fileUpload) {
-    fileUpload.addEventListener('change', (e) => {
+  // Welcome file upload also uses _importJSON
+  const welcomeUpload = document.getElementById('welcome-file-upload');
+  if (welcomeUpload) {
+    welcomeUpload.addEventListener('change', (e) => {
       const file = e.target.files[0];
-      if (!file) return;
-      const reader = new FileReader();
-      reader.onload = () => {
-        try {
-          const data = JSON.parse(reader.result);
-          loadData(data, file.name.replace('.json', ''));
-        } catch (err) {
-          alert('Invalid JSON file');
-        }
-      };
-      reader.readAsText(file);
+      if (file) {
+        Store.markOnboardingSeen();
+        _importJSON(file);
+      }
+      welcomeUpload.value = '';
     });
   }
 
-  if (btnBackWelcome) {
-    btnBackWelcome.addEventListener('click', () => showScreen('welcome'));
+  // Populate dropdown and determine initial view
+  _populateSeriesDropdown();
+
+  const settings = Store.getSettings();
+  const hasSeenOnboarding = Store.hasSeenOnboarding();
+  const demoData = _loadDemoData();
+  const savedResults = Store.getResults();
+  const hasSavedData = Object.keys(savedResults).length > 0;
+
+  if (!hasSeenOnboarding && !window.location.hash) {
+    // First visit — show welcome
+    showScreen('welcome');
+    return;
+  }
+
+  // Determine which series to load
+  let seriesName = settings.lastSeries || null;
+
+  // Validate that lastSeries still exists
+  if (seriesName && seriesName !== '__demo__' && !savedResults[seriesName]) {
+    seriesName = null;
   }
-  if (btnBackGrid) {
-    btnBackGrid.addEventListener('click', () => showScreen('grid'));
+
+  // Fall back to demo or first saved result
+  if (!seriesName) {
+    if (demoData) {
+      seriesName = '__demo__';
+    } else if (hasSavedData) {
+      seriesName = Object.keys(savedResults).sort()[0];
+    }
   }
-  if (btnAnalytics) {
-    btnAnalytics.addEventListener('click', () => {
-      if (_currentData) {
-        const analyticsContainer = document.getElementById('analytics-container');
-        if (analyticsContainer) renderAnalytics(_currentData, analyticsContainer);
-      }
-      showScreen('analytics');
-    });
+
+  if (seriesName) {
+    const select = document.getElementById('series-select');
+    if (select) select.value = seriesName;
+    _switchSeries(seriesName);
+    _setTab('grid');
+  } else {
+    showScreen('welcome');
   }
 
-  // Auto-load demo if data is present and URL has #demo
+  // Handle #demo URL hash
   if (demoData && window.location.hash === '#demo') {
-    loadData(demoData, 'Demo: Breaking Bad S01');
+    _switchSeries('__demo__');
+    _setTab('grid');
   }
 }
 
diff --git a/src/tvplotlines/html/parts/shell.html b/src/tvplotlines/html/parts/shell.html
index 71b3768..a192d5c 100644
--- a/src/tvplotlines/html/parts/shell.html
+++ b/src/tvplotlines/html/parts/shell.html
@@ -17,8 +17,8 @@ <h1>TV Plotlines Viewer</h1>
     <p>Upload a plotlines JSON file or explore the demo data.</p>
     <div class="welcome-actions">
       <button id="btn-demo">Load Demo</button>
-      <label class="upload-label" for="file-upload">Upload JSON</label>
-      <input type="file" id="file-upload" accept=".json" hidden>
+      <label class="upload-label" for="welcome-file-upload">Upload JSON</label>
+      <input type="file" id="welcome-file-upload" accept=".json" hidden>
     </div>
   </div>
 </section>
@@ -26,9 +26,21 @@ <h1>TV Plotlines Viewer</h1>
 <!-- Grid screen -->
 <section id="screen-grid" class="screen">
   <nav class="toolbar">
-    <button id="btn-back-welcome" class="btn-nav">&larr; Home</button>
-    <span id="grid-title" class="toolbar-title"></span>
-    <button id="btn-analytics" class="btn-nav">Analytics &rarr;</button>
+    <div class="toolbar-left">
+      <select id="series-select" class="toolbar-select"></select>
+      <span id="grid-title" class="toolbar-title"></span>
+    </div>
+    <div class="toolbar-center">
+      <button id="btn-tab-grid" class="btn-nav btn-nav-active">Grid</button>
+      <button id="btn-tab-analytics" class="btn-nav">Analytics</button>
+    </div>
+    <div class="toolbar-right">
+      <button id="btn-load" class="btn-nav" title="Load synopses">+ Load</button>
+      <button id="btn-export" class="btn-nav" title="Export">Export</button>
+      <button id="btn-llm-settings" class="btn-nav" title="LLM Settings">LLM</button>
+      <button id="btn-onboarding" class="btn-nav" title="Show welcome screen">?</button>
+      <button id="btn-dark" class="btn-nav" title="Toggle dark mode">&#9790;</button>
+    </div>
   </nav>
   <div id="grid-container"></div>
 </section>
@@ -36,12 +48,35 @@ <h1>TV Plotlines Viewer</h1>
 <!-- Analytics screen -->
 <section id="screen-analytics" class="screen">
   <nav class="toolbar">
-    <button id="btn-back-grid" class="btn-nav">&larr; Grid</button>
-    <span class="toolbar-title">Analytics</span>
+    <div class="toolbar-left">
+      <select class="toolbar-select" disabled style="visibility:hidden"></select>
+      <span class="toolbar-title">Analytics</span>
+    </div>
+    <div class="toolbar-center">
+      <button class="btn-nav" onclick="_setTab('grid')">Grid</button>
+      <button class="btn-nav btn-nav-active">Analytics</button>
+    </div>
+    <div class="toolbar-right">
+      <button class="btn-nav" onclick="_showDropZone()" title="Load synopses">+ Load</button>
+      <button class="btn-nav" onclick="alert('Export coming in Task 6')" title="Export">Export</button>
+      <button class="btn-nav" onclick="toggleDark()" title="Toggle dark mode">&#9790;</button>
+    </div>
   </nav>
   <div id="analytics-container"></div>
 </section>
 
+<!-- Drop zone overlay for JSON import -->
+<div id="drop-zone" class="drop-zone-overlay hidden">
+  <div class="drop-zone-box">
+    <div class="drop-zone-icon">&#128194;</div>
+    <p>Drop a tvplotlines JSON file here</p>
+    <p class="drop-zone-hint">or</p>
+    <label class="btn" for="file-upload">Choose file</label>
+    <input type="file" id="file-upload" accept=".json" hidden>
+    <button class="drop-zone-close" onclick="_hideDropZone()">&times;</button>
+  </div>
+</div>
+
 <!-- Modal -->
 <div id="modal-overlay" class="modal-overlay hidden">
   <div id="modal-content" class="modal-content">
diff --git a/src/tvplotlines/html/parts/style.css b/src/tvplotlines/html/parts/style.css
index 3786204..95c3230 100644
--- a/src/tvplotlines/html/parts/style.css
+++ b/src/tvplotlines/html/parts/style.css
@@ -38,15 +38,41 @@ body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; b
 /* ── Toolbar / navigation ── */
 .toolbar {
   display: flex; justify-content: space-between; align-items: center;
-  padding: 0.75rem 1rem; background: white; border-radius: 8px;
+  padding: 0.5rem 1rem; background: white; border-radius: 8px;
   margin-bottom: 1rem; box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+  gap: 0.5rem;
 }
-.toolbar-title { font-size: 1.1rem; font-weight: 600; }
+.toolbar-left, .toolbar-center, .toolbar-right { display: flex; align-items: center; gap: 0.5rem; }
+.toolbar-left { flex: 1; min-width: 0; }
+.toolbar-center { flex-shrink: 0; }
+.toolbar-right { flex: 1; justify-content: flex-end; }
+.toolbar-title { font-size: 1.1rem; font-weight: 600; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.toolbar-select { padding: 0.375rem 0.5rem; border: 1px solid #ddd; border-radius: 6px; font-size: 0.8rem; max-width: 200px; background: white; }
 .btn-nav {
   padding: 0.375rem 0.75rem; border: 1px solid #ddd; border-radius: 6px;
-  background: white; cursor: pointer; font-size: 0.8rem;
+  background: white; cursor: pointer; font-size: 0.8rem; white-space: nowrap;
 }
 .btn-nav:hover { background: #f0f0f0; }
+.btn-nav-active { background: #2563eb; color: white; border-color: #2563eb; }
+.btn-nav-active:hover { background: #1d4ed8; }
+
+/* ── Drop zone overlay ── */
+.drop-zone-overlay {
+  position: fixed; inset: 0; background: rgba(0,0,0,0.5); z-index: 150;
+  display: flex; align-items: center; justify-content: center;
+}
+.drop-zone-box {
+  background: white; border-radius: 12px; padding: 3rem;
+  text-align: center; max-width: 420px; width: 90%;
+  border: 2px dashed #ccc; position: relative;
+}
+.drop-zone-active .drop-zone-box { border-color: #2563eb; background: #eff6ff; }
+.drop-zone-icon { font-size: 3rem; margin-bottom: 1rem; }
+.drop-zone-hint { color: #999; font-size: 0.85rem; margin: 0.75rem 0; }
+.drop-zone-close {
+  position: absolute; top: 0.5rem; right: 0.75rem; font-size: 1.5rem;
+  border: none; background: none; cursor: pointer; color: #999;
+}
 
 /* ── Buttons ── */
 .btn { padding: 0.5rem 1rem; border: 1px solid #ddd; border-radius: 6px; background: white; cursor: pointer; font-size: 0.875rem; }
@@ -170,6 +196,13 @@ body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; b
 :root.dark .toolbar-title { color: #cba6f7; }
 :root.dark .btn-nav { background: #313244; color: #cdd6f4; border-color: #45475a; }
 :root.dark .btn-nav:hover { background: #45475a; }
+:root.dark .btn-nav-active { background: #89b4fa; color: #1e1e2e; border-color: #89b4fa; }
+:root.dark .btn-nav-active:hover { background: #74c7ec; }
+:root.dark .toolbar-select { background: #313244; color: #cdd6f4; border-color: #45475a; }
+:root.dark .drop-zone-box { background: #181825; border-color: #45475a; color: #cdd6f4; }
+:root.dark .drop-zone-active .drop-zone-box { border-color: #89b4fa; background: #1e1e2e; }
+:root.dark .drop-zone-close { color: #6c7086; }
+:root.dark .drop-zone-hint { color: #6c7086; }
 
 :root.dark .grid-container,
 :root.dark .side-panel { background: #181825; box-shadow: 0 1px 3px rgba(0,0,0,0.5); }

From fd2deed35d528566ffdf2a670ec8fe351b2dd126 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Thu, 9 Apr 2026 23:10:26 +0200
Subject: [PATCH 07/24] Add export functions: JSON, TXT, CSV, Final Draft .fdx
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Export dropdown in toolbar with 4 formats. Single floating menu
shared between grid and analytics screens. CSV chosen over XLS
to avoid SheetJS dependency — includes both events and plotlines
summary.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/tvplotlines/html/parts/app.js     |   8 +-
 src/tvplotlines/html/parts/export.js  | 233 ++++++++++++++++++++++++++
 src/tvplotlines/html/parts/shell.html |  12 +-
 src/tvplotlines/html/parts/style.css  |  15 ++
 4 files changed, 263 insertions(+), 5 deletions(-)
 create mode 100644 src/tvplotlines/html/parts/export.js

diff --git a/src/tvplotlines/html/parts/app.js b/src/tvplotlines/html/parts/app.js
index 80e2a3f..7960f94 100644
--- a/src/tvplotlines/html/parts/app.js
+++ b/src/tvplotlines/html/parts/app.js
@@ -288,9 +288,11 @@ function _initApp() {
     seriesSelect.addEventListener('change', () => _switchSeries(seriesSelect.value));
   }
 
-  // Placeholders — buttons exist but no action yet
-  if (btnExport) btnExport.addEventListener('click', () => {
-    alert('Export coming in Task 6');
+  // Export dropdown — all .btn-export-trigger buttons open the shared menu
+  if (btnExport) btnExport.addEventListener('click', () => _toggleExportMenu(btnExport));
+  document.querySelectorAll('.btn-export-trigger').forEach(btn => {
+    if (btn === btnExport) return; // Already wired above
+    btn.addEventListener('click', () => _toggleExportMenu(btn));
   });
   if (btnLLM) btnLLM.addEventListener('click', () => {
     alert('LLM Settings coming soon');
diff --git a/src/tvplotlines/html/parts/export.js b/src/tvplotlines/html/parts/export.js
new file mode 100644
index 0000000..1d13297
--- /dev/null
+++ b/src/tvplotlines/html/parts/export.js
@@ -0,0 +1,233 @@
+// Export functions — JSON, TXT, CSV, Final Draft .fdx
+
+// --- Shared helpers ---
+
+function _downloadBlob(blob, filename) {
+  const a = document.createElement('a');
+  a.href = URL.createObjectURL(blob);
+  a.download = filename;
+  a.click();
+  URL.revokeObjectURL(a.href);
+}
+
+function _escapeXml(s) {
+  if (!s) return '';
+  return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+
+function _escapeCsv(s) {
+  if (!s) return '';
+  if (s.includes(',') || s.includes('"') || s.includes('\n')) {
+    return '"' + s.replace(/"/g, '""') + '"';
+  }
+  return s;
+}
+
+function _exportFilename(data) {
+  const ctx = data.context || {};
+  if (ctx.series && ctx.season) return ctx.series.replace(/\s+/g, '_') + '_' + ctx.season;
+  if (ctx.series) return ctx.series.replace(/\s+/g, '_');
+  return 'tvplotlines_export';
+}
+
+function _resolveCharName(charId, cast) {
+  if (!charId) return '';
+  if (charId.startsWith('guest:')) return charId.slice(6);
+  for (const c of cast) {
+    if (c.id === charId) return c.name;
+  }
+  return charId;
+}
+
+// --- JSON ---
+
+function exportJSON(data) {
+  const blob = new Blob([JSON.stringify(data, null, 2)], { type: 'application/json' });
+  _downloadBlob(blob, _exportFilename(data) + '.json');
+}
+
+// --- TXT ---
+
+function exportTXT(data) {
+  const cast = data.cast || [];
+  const plotlines = data.plotlines || [];
+  const episodes = data.episodes || [];
+  const ctx = data.context || {};
+  const lines = [];
+
+  // Header
+  const title = [ctx.series, ctx.season].filter(Boolean).join(' ');
+  if (title) lines.push(title);
+  if (ctx.genre) lines.push('Genre: ' + ctx.genre);
+  if (ctx.story_engine) lines.push('Story engine: ' + ctx.story_engine);
+  lines.push('');
+
+  // Plotlines summary
+  lines.push('=== PLOTLINES ===');
+  for (const pl of plotlines) {
+    lines.push('');
+    lines.push(`[${pl.rank}] ${pl.name}`);
+    if (pl.goal) lines.push('  Goal: ' + pl.goal);
+    if (pl.obstacle) lines.push('  Obstacle: ' + pl.obstacle);
+    if (pl.stakes) lines.push('  Stakes: ' + pl.stakes);
+    if (pl.type) lines.push('  Type: ' + pl.type);
+    if (pl.span) lines.push('  Span: ' + pl.span.join(', '));
+  }
+  lines.push('');
+
+  // Episodes with events
+  lines.push('=== EPISODES ===');
+  for (const ep of episodes) {
+    lines.push('');
+    const heading = ep.theme ? ep.episode + ' — ' + ep.theme : ep.episode;
+    lines.push('--- ' + heading + ' ---');
+
+    // Group events by plotline
+    const byPlotline = {};
+    for (const ev of (ep.events || [])) {
+      const plId = ev.plotline_id || ev.storyline || 'unknown';
+      if (!byPlotline[plId]) byPlotline[plId] = [];
+      byPlotline[plId].push(ev);
+    }
+
+    for (const pl of plotlines) {
+      const events = byPlotline[pl.id];
+      if (!events || events.length === 0) continue;
+
+      lines.push('');
+      lines.push(`  ${pl.name} [${pl.rank}]`);
+      for (const ev of events) {
+        const chars = (ev.characters || []).map(c => _resolveCharName(c, cast)).join(', ');
+        lines.push(`    [${ev.function}] ${ev.event}`);
+        if (chars) lines.push(`      Characters: ${chars}`);
+      }
+    }
+  }
+
+  const blob = new Blob([lines.join('\n')], { type: 'text/plain' });
+  _downloadBlob(blob, _exportFilename(data) + '.txt');
+}
+
+// --- CSV (fallback for XLS — no external dependency) ---
+
+function exportCSV(data) {
+  const cast = data.cast || [];
+  const plotlines = data.plotlines || [];
+  const episodes = data.episodes || [];
+  const plMap = {};
+  for (const pl of plotlines) plMap[pl.id] = pl;
+
+  // Events sheet as CSV
+  const rows = [['Episode', 'Plotline', 'Rank', 'Function', 'Event', 'Characters'].map(_escapeCsv).join(',')];
+
+  for (const ep of episodes) {
+    for (const ev of (ep.events || [])) {
+      const plId = ev.plotline_id || ev.storyline || '';
+      const pl = plMap[plId] || {};
+      const chars = (ev.characters || []).map(c => _resolveCharName(c, cast)).join('; ');
+      rows.push([
+        ep.episode,
+        pl.name || plId,
+        pl.rank || '',
+        ev.function || '',
+        ev.event || '',
+        chars,
+      ].map(_escapeCsv).join(','));
+    }
+  }
+
+  // Add plotlines summary after a blank line
+  rows.push('');
+  rows.push(['Name', 'Rank', 'Type', 'Goal', 'Obstacle', 'Stakes', 'Span'].map(_escapeCsv).join(','));
+  for (const pl of plotlines) {
+    rows.push([
+      pl.name || '',
+      pl.rank || '',
+      pl.type || '',
+      pl.goal || '',
+      pl.obstacle || '',
+      pl.stakes || '',
+      (pl.span || []).join('; '),
+    ].map(_escapeCsv).join(','));
+  }
+
+  const blob = new Blob([rows.join('\n')], { type: 'text/csv' });
+  _downloadBlob(blob, _exportFilename(data) + '.csv');
+}
+
+// --- Final Draft .fdx ---
+
+function exportFDX(data) {
+  const cast = data.cast || [];
+  const plotlines = data.plotlines || [];
+  const episodes = data.episodes || [];
+
+  let xml = '<?xml version="1.0" encoding="UTF-8"?>\n';
+  xml += '<FinalDraft DocumentType="Script" Template="No" Version="6">\n';
+  xml += '<Content>\n';
+
+  for (const ep of episodes) {
+    const heading = ep.theme ? ep.episode + ' \u2014 ' + ep.theme : ep.episode;
+    xml += `<Paragraph Type="Scene Heading"><Text>${_escapeXml(heading)}</Text></Paragraph>\n`;
+
+    // Group events by plotline, preserving plotline order
+    for (const pl of plotlines) {
+      const events = (ep.events || []).filter(e => (e.plotline_id || e.storyline) === pl.id);
+      if (events.length === 0) continue;
+
+      xml += `<Paragraph Type="Action"><Text Font="Bold">${_escapeXml(pl.name)} [${_escapeXml(pl.rank)}]</Text></Paragraph>\n`;
+      for (const ev of events) {
+        const chars = (ev.characters || []).map(c => _resolveCharName(c, cast)).join(', ');
+        let line = `[${ev.function}] ${ev.event}`;
+        if (chars) line += ` (${chars})`;
+        xml += `<Paragraph Type="Action"><Text>${_escapeXml(line)}</Text></Paragraph>\n`;
+      }
+    }
+  }
+
+  xml += '</Content>\n</FinalDraft>';
+  const blob = new Blob([xml], { type: 'application/xml' });
+  _downloadBlob(blob, _exportFilename(data) + '.fdx');
+}
+
+// --- Export dropdown ---
+
+function _toggleExportMenu(triggerBtn) {
+  const menu = document.getElementById('export-menu');
+  if (!menu) return;
+
+  const wasHidden = menu.classList.contains('hidden');
+  menu.classList.toggle('hidden');
+
+  if (wasHidden && triggerBtn) {
+    // Position below the clicked button
+    const rect = triggerBtn.getBoundingClientRect();
+    menu.style.top = rect.bottom + 4 + 'px';
+    menu.style.right = (window.innerWidth - rect.right) + 'px';
+
+    const close = (e) => {
+      if (!menu.contains(e.target) && !e.target.classList.contains('btn-export-trigger')) {
+        menu.classList.add('hidden');
+        document.removeEventListener('click', close);
+      }
+    };
+    setTimeout(() => document.addEventListener('click', close), 0);
+  }
+}
+
+function _handleExport(format) {
+  const menu = document.getElementById('export-menu');
+  if (menu) menu.classList.add('hidden');
+
+  if (!_currentData) {
+    alert('No data loaded');
+    return;
+  }
+
+  switch (format) {
+    case 'json': exportJSON(_currentData); break;
+    case 'txt': exportTXT(_currentData); break;
+    case 'csv': exportCSV(_currentData); break;
+    case 'fdx': exportFDX(_currentData); break;
+  }
+}
diff --git a/src/tvplotlines/html/parts/shell.html b/src/tvplotlines/html/parts/shell.html
index a192d5c..fdd6606 100644
--- a/src/tvplotlines/html/parts/shell.html
+++ b/src/tvplotlines/html/parts/shell.html
@@ -36,7 +36,7 @@ <h1>TV Plotlines Viewer</h1>
     </div>
     <div class="toolbar-right">
       <button id="btn-load" class="btn-nav" title="Load synopses">+ Load</button>
-      <button id="btn-export" class="btn-nav" title="Export">Export</button>
+      <button id="btn-export" class="btn-nav btn-export-trigger" title="Export">Export</button>
       <button id="btn-llm-settings" class="btn-nav" title="LLM Settings">LLM</button>
       <button id="btn-onboarding" class="btn-nav" title="Show welcome screen">?</button>
       <button id="btn-dark" class="btn-nav" title="Toggle dark mode">&#9790;</button>
@@ -58,7 +58,7 @@ <h1>TV Plotlines Viewer</h1>
     </div>
     <div class="toolbar-right">
       <button class="btn-nav" onclick="_showDropZone()" title="Load synopses">+ Load</button>
-      <button class="btn-nav" onclick="alert('Export coming in Task 6')" title="Export">Export</button>
+      <button class="btn-nav btn-export-trigger" title="Export">Export</button>
       <button class="btn-nav" onclick="toggleDark()" title="Toggle dark mode">&#9790;</button>
     </div>
   </nav>
@@ -85,6 +85,14 @@ <h1>TV Plotlines Viewer</h1>
   </div>
 </div>
 
+<!-- Export dropdown menu (positioned dynamically near the clicked button) -->
+<div id="export-menu" class="export-menu hidden">
+  <button onclick="_handleExport('json')">JSON</button>
+  <button onclick="_handleExport('txt')">TXT</button>
+  <button onclick="_handleExport('csv')">CSV</button>
+  <button onclick="_handleExport('fdx')">Final Draft (.fdx)</button>
+</div>
+
 <!-- Demo data (injected by build.py) -->
 <script id="demo-data" type="application/json">
 /* {{DEMO_DATA}} */
diff --git a/src/tvplotlines/html/parts/style.css b/src/tvplotlines/html/parts/style.css
index 95c3230..bdde7fb 100644
--- a/src/tvplotlines/html/parts/style.css
+++ b/src/tvplotlines/html/parts/style.css
@@ -74,6 +74,21 @@ body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; b
   border: none; background: none; cursor: pointer; color: #999;
 }
 
+/* ── Export dropdown ── */
+.export-menu {
+  position: fixed; z-index: 200; background: white; border: 1px solid #ddd;
+  border-radius: 8px; box-shadow: 0 4px 12px rgba(0,0,0,0.15); padding: 0.25rem 0;
+  min-width: 160px;
+}
+.export-menu button {
+  display: block; width: 100%; text-align: left; padding: 0.5rem 1rem;
+  border: none; background: none; cursor: pointer; font-size: 0.85rem; color: #1a1a1a;
+}
+.export-menu button:hover { background: #f0f0f0; }
+html.dark .export-menu { background: #1e1e1e; border-color: #333; }
+html.dark .export-menu button { color: #e5e5e5; }
+html.dark .export-menu button:hover { background: #2a2a2a; }
+
 /* ── Buttons ── */
 .btn { padding: 0.5rem 1rem; border: 1px solid #ddd; border-radius: 6px; background: white; cursor: pointer; font-size: 0.875rem; }
 .btn:hover { background: #f0f0f0; }

From d84204da2a64d7c0188bdf65470345ae99fba1b2 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Thu, 9 Apr 2026 23:19:00 +0200
Subject: [PATCH 08/24] Add LLM pipeline for browser-side plotline extraction

Implement pipeline.js with streaming API client (Anthropic + OpenAI),
all 5 passes with embedded prompts, post-processing, and synopsis
file upload. Wire drop zone to accept .txt synopses alongside JSON,
add LLM settings dialog, and pipeline progress overlay.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/tvplotlines/html/parts/app.js      |  100 +-
 src/tvplotlines/html/parts/pipeline.js | 1433 ++++++++++++++++++++++++
 src/tvplotlines/html/parts/shell.html  |    8 +-
 src/tvplotlines/html/parts/style.css   |   29 +
 4 files changed, 1549 insertions(+), 21 deletions(-)
 create mode 100644 src/tvplotlines/html/parts/pipeline.js

diff --git a/src/tvplotlines/html/parts/app.js b/src/tvplotlines/html/parts/app.js
index 7960f94..b667fd8 100644
--- a/src/tvplotlines/html/parts/app.js
+++ b/src/tvplotlines/html/parts/app.js
@@ -219,21 +219,18 @@ function _setupDropZone() {
   zone.addEventListener('drop', (e) => {
     e.preventDefault();
     zone.classList.remove('drop-zone-active');
-    const file = e.dataTransfer.files[0];
-    if (file && file.name.endsWith('.json')) {
-      _importJSON(file);
-      _hideDropZone();
-    }
+    const files = [...e.dataTransfer.files];
+    _handleDroppedFiles(files);
+    _hideDropZone();
   });
 
   if (fileUpload) {
     fileUpload.addEventListener('change', (e) => {
-      const file = e.target.files[0];
-      if (file) {
-        _importJSON(file);
+      const files = [...e.target.files];
+      if (files.length > 0) {
+        _handleDroppedFiles(files);
         _hideDropZone();
       }
-      // Reset so the same file can be re-selected
       fileUpload.value = '';
     });
   }
@@ -249,6 +246,73 @@ function _hideDropZone() {
   if (zone) zone.classList.add('hidden');
 }
 
+// --- File handling (JSON or TXT synopses) ---
+
+function _handleDroppedFiles(files) {
+  if (files.length === 1 && files[0].name.endsWith('.json')) {
+    _importJSON(files[0]);
+    return;
+  }
+
+  // Treat as synopsis .txt files — run through pipeline
+  const txtFiles = files.filter(f => f.name.endsWith('.txt'));
+  if (txtFiles.length > 0) {
+    Store.markOnboardingSeen();
+    _handleSynopsisUpload(txtFiles);
+    return;
+  }
+
+  // Single JSON or unknown
+  if (files.length === 1) {
+    _importJSON(files[0]);
+  } else {
+    alert('Drop .json (plotlines result) or .txt files (synopses with SxxExx in filename).');
+  }
+}
+
+// --- LLM Settings dialog ---
+
+function _showLLMSettings() {
+  const modalOverlay = document.getElementById('modal-overlay');
+  const modalBody = document.getElementById('modal-body');
+  if (!modalOverlay || !modalBody) return;
+
+  const provider = Store.getProvider() || 'anthropic';
+  const apiKey = Store.getKey() || '';
+
+  modalBody.innerHTML = `
+    <h3 style="margin-top:0">LLM Settings</h3>
+    <div style="margin-bottom:12px">
+      <label for="llm-provider" style="display:block;margin-bottom:4px;font-weight:600">Provider</label>
+      <select id="llm-provider" style="width:100%;padding:6px;border-radius:4px;border:1px solid var(--border, #ccc)">
+        <option value="anthropic" ${provider === 'anthropic' ? 'selected' : ''}>Anthropic (Claude)</option>
+        <option value="openai" ${provider === 'openai' ? 'selected' : ''}>OpenAI (GPT-4o)</option>
+      </select>
+    </div>
+    <div style="margin-bottom:16px">
+      <label for="llm-api-key" style="display:block;margin-bottom:4px;font-weight:600">API Key</label>
+      <input id="llm-api-key" type="password" value="${apiKey.replace(/"/g, '&quot;')}"
+        placeholder="sk-... or sk-ant-..."
+        style="width:100%;padding:6px;border-radius:4px;border:1px solid var(--border, #ccc);box-sizing:border-box">
+    </div>
+    <button id="llm-save-btn" style="padding:6px 16px;border-radius:4px;cursor:pointer">Save</button>
+    <span id="llm-save-status" style="margin-left:8px;color:green;display:none">Saved!</span>
+  `;
+
+  document.getElementById('llm-save-btn').addEventListener('click', () => {
+    const p = document.getElementById('llm-provider').value;
+    const k = document.getElementById('llm-api-key').value.trim();
+    Store.setKey(p, k);
+    const status = document.getElementById('llm-save-status');
+    if (status) {
+      status.style.display = 'inline';
+      setTimeout(() => { status.style.display = 'none'; }, 2000);
+    }
+  });
+
+  modalOverlay.classList.remove('hidden');
+}
+
 // --- Init ---
 
 function _initApp() {
@@ -268,6 +332,13 @@ function _initApp() {
 
   // Drop zone
   _setupDropZone();
+  const dropZoneClose = document.getElementById('drop-zone-close');
+  if (dropZoneClose) dropZoneClose.addEventListener('click', _hideDropZone);
+  // Close drop zone on click outside the box
+  const dropZone = document.getElementById('drop-zone');
+  if (dropZone) dropZone.addEventListener('click', (e) => {
+    if (e.target === dropZone) _hideDropZone();
+  });
 
   // Toolbar buttons
   const btnDark = document.getElementById('btn-dark');
@@ -294,9 +365,7 @@ function _initApp() {
     if (btn === btnExport) return; // Already wired above
     btn.addEventListener('click', () => _toggleExportMenu(btn));
   });
-  if (btnLLM) btnLLM.addEventListener('click', () => {
-    alert('LLM Settings coming soon');
-  });
+  if (btnLLM) btnLLM.addEventListener('click', _showLLMSettings);
   if (btnOnboarding) btnOnboarding.addEventListener('click', () => {
     showScreen('welcome');
   });
@@ -333,11 +402,8 @@ function _initApp() {
   const savedResults = Store.getResults();
   const hasSavedData = Object.keys(savedResults).length > 0;
 
-  if (!hasSeenOnboarding && !window.location.hash) {
-    // First visit — show welcome
-    showScreen('welcome');
-    return;
-  }
+  // Welcome screen will be implemented in Task 11.
+  // For now, always go straight to grid with demo data.
 
   // Determine which series to load
   let seriesName = settings.lastSeries || null;
diff --git a/src/tvplotlines/html/parts/pipeline.js b/src/tvplotlines/html/parts/pipeline.js
new file mode 100644
index 0000000..e564ee2
--- /dev/null
+++ b/src/tvplotlines/html/parts/pipeline.js
@@ -0,0 +1,1433 @@
+// LLM API client + 5-pass plotline extraction pipeline.
+// Runs entirely in the browser — calls Anthropic or OpenAI APIs directly.
+
+// --- SSE streaming helpers ---
+
+async function _readSSE(response, onChunk) {
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = '';
+  let accumulated = '';
+
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    buffer += decoder.decode(value, { stream: true });
+
+    const lines = buffer.split('\n');
+    // Keep the last partial line in the buffer
+    buffer = lines.pop();
+
+    for (const line of lines) {
+      if (!line.startsWith('data: ')) continue;
+      const payload = line.slice(6).trim();
+      if (payload === '[DONE]') continue;
+
+      try {
+        const parsed = JSON.parse(payload);
+        const chunk = _extractChunkText(parsed);
+        if (chunk) {
+          accumulated += chunk;
+          if (onChunk) onChunk(accumulated);
+        }
+      } catch (_) {
+        // Skip unparseable lines (e.g. SSE comments)
+      }
+    }
+  }
+
+  return accumulated;
+}
+
+function _extractChunkText(parsed) {
+  // Anthropic format: content_block_delta with text_delta
+  if (parsed.type === 'content_block_delta' && parsed.delta?.type === 'text_delta') {
+    return parsed.delta.text;
+  }
+  // OpenAI format: choices[0].delta.content
+  if (parsed.choices?.[0]?.delta?.content) {
+    return parsed.choices[0].delta.content;
+  }
+  return null;
+}
+
+// --- API calls ---
+
+async function callAnthropic(systemPrompt, userMessage, apiKey, onChunk) {
+  const response = await fetch('https://api.anthropic.com/v1/messages', {
+    method: 'POST',
+    headers: {
+      'x-api-key': apiKey,
+      'anthropic-version': '2023-06-01',
+      'anthropic-dangerous-direct-browser-access': 'true',
+      'content-type': 'application/json',
+    },
+    body: JSON.stringify({
+      model: 'claude-sonnet-4-20250514',
+      max_tokens: 16384,
+      stream: true,
+      system: systemPrompt,
+      messages: [{ role: 'user', content: userMessage }],
+    }),
+  });
+
+  if (!response.ok) {
+    const err = await response.text();
+    throw new Error(`Anthropic API error ${response.status}: ${err}`);
+  }
+
+  return _readSSE(response, onChunk);
+}
+
+async function callOpenAI(systemPrompt, userMessage, apiKey, onChunk) {
+  const response = await fetch('https://api.openai.com/v1/chat/completions', {
+    method: 'POST',
+    headers: {
+      'Authorization': `Bearer ${apiKey}`,
+      'content-type': 'application/json',
+    },
+    body: JSON.stringify({
+      model: 'gpt-4o',
+      max_tokens: 16384,
+      stream: true,
+      messages: [
+        { role: 'system', content: systemPrompt },
+        { role: 'user', content: userMessage },
+      ],
+    }),
+  });
+
+  if (!response.ok) {
+    const err = await response.text();
+    throw new Error(`OpenAI API error ${response.status}: ${err}`);
+  }
+
+  return _readSSE(response, onChunk);
+}
+
+async function callLLM(systemPrompt, userMessage, provider, apiKey, onChunk) {
+  if (provider === 'anthropic') {
+    return callAnthropic(systemPrompt, userMessage, apiKey, onChunk);
+  }
+  return callOpenAI(systemPrompt, userMessage, apiKey, onChunk);
+}
+
+// --- JSON parsing from LLM responses ---
+
+function _parseJSONResponse(text) {
+  // Strip markdown code fences if present
+  let cleaned = text.trim();
+  const fenceMatch = cleaned.match(/```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/);
+  if (fenceMatch) {
+    cleaned = fenceMatch[1].trim();
+  }
+  return JSON.parse(cleaned);
+}
+
+// --- Embedded prompts ---
+// Glossary is inlined into each pass prompt where {GLOSSARY} appears.
+
+const _GLOSSARY = `## story DNA
+
+Every plotline has four parts: **hero** (who drives it), **goal** (what they want), **obstacle** (what blocks them), **stakes** (what happens if they fail). Missing any component—not a plotline, but an event within another plotline.
+
+Some plotlines have no obvious single hero—typically theme-led ones (see plotline:nature), where the problem comes from an institution or system rather than a character. Examples: "MI5 vs Slough House" in Slow Horses, "Professional life at Sterling Cooper" in Mad Men. In such cases, use your judgment to assign the most fitting character as hero—the one most affected, or driving the dynamic, or whose POV dominates.
+
+## plotline
+
+A story with complete Story DNA. Has a three-act structure, conflict, and a causal chain of events. A plotline is tied to a main cast character or an institution, not a guest.
+
+TV episodes typically feature two or more parallel plotlines, denoted by letters A, B, C: a main A plot that dominates screen time and secondary B plots that may offer thematic parallels or counterpoint.
+
+### granularity
+
+The key is GOAL, not character.
+Different plotlines: different heroes, OR one hero with different goals and obstacles and stakes.
+
+Test: if you can't write a logline—"[hero] wants [goal], but [obstacle], and if they fail [stakes]"—it's not a plotline.
+
+For theme-led plotlines, the logline test becomes: "[institution/system] [problem]; [hero] [role in it], stakes: [stakes]." Example: "MI5 covers up its role in the kidnapping; Taverner drives the cover-up, stakes: exposure and careers."
+
+### what is not a plotline
+
+| example                            | what it is                                             |
+| ---------------------------------- | ------------------------------------------------------ |
+| "John has lunch"                   | Background—no goal/conflict                            |
+| "Everyone goes to a party"         | Setting—no hero/stakes                                 |
+| "John is sad"                      | State—no goal/obstacle                                 |
+| "John and Mike's friendship"       | Context—no conflict                                    |
+| "Investigation" (procedural, ep.5) | Part of the case_of_the_week plotline, not a separate one |
+
+## plotline:type
+
+How long does this plotline last?
+
+- **case_of_the_week**—opens and closes within one episode. The show's story engine describes the repeating formula. Story DNA is templated (repeating goal/obstacle/stakes), specific content—filled in per episode.
+- **serialized**—spans multiple episodes or the entire season. Conflicts carry over.
+- **runner**—minor recurring thread. Incomplete Story DNA—no obstacle or resolution, logline is descriptive. Everything else—a full plotline.
+
+## plotline:nature
+
+Where does the main problem come from? This matters because nature tells you what kind of obstacle to look for: an outside enemy (plot-led), the hero's own flaw (character-led), or a system nobody can fix alone (theme-led).
+
+- **plot-led**—from outside the hero. External goal vs antagonist. Stranger Things, CSI.
+- **character-led**—from inside the hero. Internal conflict, the hero IS the problem. Breaking Bad, Fleabag.
+- **theme-led**—from society. Systemic, no single solution. The Wire, Succession.
+
+## plotline:confidence
+
+How complete is the conflict structure?
+
+- **solid**—hero, goal, obstacle, stakes all clear.
+- **partial**—hero and goal clear, obstacle or stakes unclear.
+- **inferred**—plotline implied, conflict structure incomplete.
+
+This matters because inferred plotlines are expected to have incomplete structure—they won't be flagged for missing functions or low event count. Solid plotlines will be.
+
+## format
+
+- **procedural**—each episode has a standalone story (case, patient, mission) that opens and closes within the episode. Even though each episode's case is different, we treat them as one recurring plotline called "Case of the Week"—same structural slot, different content each time. Other plotlines are secondary. CSI, House, Law & Order.
+- **hybrid**—each episode has a case-of-the-week AND serialized plotlines, and they actively intertwine. Both matter. X-Files, Buffy, Good Wife, Grey's Anatomy.
+- **serial**—episodes continue each other. Conflicts don't close within an episode. No case-of-the-week. One clear protagonist. Breaking Bad, Sopranos.
+- **ensemble**—like serial, but no single protagonist. Multiple characters drive their own plotlines with roughly equal screen time. Diagnostic: can you name THE main character? If not—ensemble. Game of Thrones, Succession, The Wire, The Crown.
+
+Base classification on the synopses, not on prior knowledge of the show. The same show can change format between seasons.
+
+Don't default to serial just because character plotlines are present—hybrid means BOTH case-of-the-week AND serialized arcs are significant.
+
+Diagnostic:
+- if E01 and E02 have different cases—procedural or hybrid
+- if E02 continues E01's conflict without closing it—serial or ensemble
+- serial vs ensemble: can you name THE main character? If not—ensemble
+
+## is_anthology
+
+Seasons are independent—new cast, new story, no continuity between seasons. Within a single season, an anthology show has normal structure (serial, procedural, etc.). This matters because prior season data is not passed forward. True Detective, Fargo.
+
+## story_engine
+
+The show's repeating dramatic mechanism in one sentence. Focus on the verbs—what are characters doing each week?
+
+Write the story engine as a one-sentence logline. Two common structures:
+- "[Who] [does what] in order to [goal], but [obstacle]."
+- "When [situation], [who] must [do what], or else [stakes]."
+
+Use whichever fits the show.
+
+Examples from real shows (none follow the formulas exactly—that's fine, the formulas are a starting point):
+- "A high school chemistry teacher diagnosed with inoperable lung cancer turns to manufacturing and selling methamphetamine in order to secure his family's future." (Breaking Bad)
+- "Nine noble families fight for control over the lands of Westeros, while an ancient enemy returns after being dormant for millennia." (Game of Thrones)
+- "An antisocial maverick doctor does whatever it takes to solve puzzling cases that come his way." (House)
+
+## genre
+
+Free text—drama, thriller, comedy, sci-fi, etc.
+
+## event
+
+One action by one character (or group) that changes the situation. Two actions by different characters = two events. Two actions at the same moment where the second is an immediate consequence of the first = one event.
+
+Write event descriptions that are specific and concrete. Include character names, what specifically happens, and the dramatic consequence. Bad: "The team works on the case." Good: "House orders a lumbar puncture over Cameron's objection, risking paralysis to test his sarcoidosis theory."
+
+## function
+
+Each event carries a function—its position in the dramatic structure:
+
+| function | what it does |
+|----------|-------------|
+| \`setup\` | Introduces the plotline. Status quo. |
+| \`inciting_incident\` | The event that starts the plotline. One per plotline, does not repeat. |
+| \`escalation\` | Raises the stakes. Can repeat. |
+| \`turning_point\` | Changes direction. False peak or false collapse. |
+| \`crisis\` | Lowest point. Hero faces what they feared most. True dilemma. |
+| \`climax\` | Peak of the conflict. Outcome is irreversible. |
+| \`resolution\` | Conflict resolved. Aftermath. |
+
+Functions are checked downstream for arc completeness and monotonicity—if a plotline has only setup and escalation across the whole season, that's a flag.
+
+## interaction
+
+How plotlines connect within an episode:
+
+- **thematic_rhyme**—plotlines explore the same theme from different angles.
+- **dramatic_irony**—the audience knows what a character in another plotline doesn't.
+- **convergence**—plotlines merge (characters/conflicts intersect).
+
+## verdict
+
+A structural correction applied after reviewing the full season:
+
+| action | what it does |
+|--------|-------------|
+| \`MERGE\` | Merge two plotlines into one |
+| \`REASSIGN\` | Move an event to a different plotline |
+| \`CREATE\` | Create a new plotline from orphaned events |
+| \`DROP\` | Remove a plotline, redistribute its events |
+| \`REFUNCTION\` | Change an event's function (e.g. escalation → crisis) |`;
+
+const _PROMPT_PASS0 = `# ROLE
+You are a story editor evaluating a show's structure from its synopses.
+
+# CONTEXT
+You receive: show title, season number, and up to 3 first synopses. Your output goes to the next step as context for plotline extraction.
+
+# GLOSSARY
+
+${_GLOSSARY}
+
+# TASK
+
+If \`suggested_plotlines\` is present in the input, use it as additional context — it contains preliminary plotline suggestions from the synopsis writer. These can help with format and ensemble detection, but verify against the synopses.
+
+Read the synopses and determine, in this order:
+### Step 1: Determine format
+What's the episode structure? Use the definitions and diagnostic in Glossary.
+### Step 2: Check anthology
+Are seasons independent?
+### Step 3: Write the story engine
+Write a one-sentence logline. See story_engine in Glossary for structure and examples.
+### Step 4: Determine genre
+
+# OUTPUT
+
+Think through before writing the JSON. You will need to explain your choices in the \`reasoning\` field — it is reviewed by a human.
+
+Response—strictly JSON, no markdown wrapping, no comments outside JSON.
+
+\`\`\`json
+{
+  "show": "Breaking Bad",
+  "season": 1,
+  "format": "serial",
+  "is_anthology": false,
+  "story_engine": "A high school chemistry teacher diagnosed with inoperable lung cancer turns to manufacturing and selling methamphetamine in order to secure his family's future",
+  "genre": "drama",
+  "reasoning": "Episodes continue each other: E01's conflict (first cook) flows into E02 (consequences), no self-contained stories within episodes."
+}
+\`\`\`
+
+Field types:
+
+- \`show\`: string
+- \`season\`: integer
+- \`format\`: enum—\`"procedural"\` | \`"serial"\` | \`"hybrid"\` | \`"ensemble"\`
+- \`is_anthology\`: boolean
+- \`story_engine\`: string—one sentence logline
+- \`genre\`: string
+- \`reasoning\`: string—why you chose this format (1–2 sentences)
+
+# VALIDATION
+
+Code will check:
+
+- JSON schema: all required fields present
+- \`format\` is one of: procedural, serial, hybrid, ensemble
+- \`is_anthology\` is a boolean
+- \`story_engine\` is a non-empty string
+
+Code cannot check: whether your format classification actually matches the synopses, whether story_engine captures the real mechanism—that's your job.`;
+
+const _PROMPT_PASS1 = `# ROLE
+
+You are a story editor who's read the entire season's synopses. Map out the plotlines: who drives each one, what they want, what are the obstacles, what's at stake.
+
+# CONTEXT
+
+You receive: show title, season number, format, story engine, and all episode synopses. If prior season data is provided, you also receive the previous season's cast and plotlines.
+
+Your output—cast list and plotlines with Story DNA—goes to the next step, where events from each episode will be assigned to these plotlines.
+
+# GLOSSARY
+
+${_GLOSSARY}
+
+# TASK
+
+### Step 1: Process prior season (if provided)
+
+If \`prior_season\` is present in the input, process it BEFORE analyzing new synopses.
+
+For each plotline in \`prior_season.plotlines\`, decide based on the NEW season's synopses:
+- **CONTINUES**—present this season. Keep \`id\`, update goal/obstacle/stakes. Example: "Walt: Empire" S1→S2—same goal, but Gus is the obstacle instead of Tuco.
+- **TRANSFORMED**—same hero, goal fundamentally changed. Keep \`id\`, rewrite Story DNA. Example: "Walt: Empire" S4→S5—no longer building, now hiding from consequences.
+- **ENDED**—resolved or disappeared. Don't include.
+
+For each character in \`prior_season.cast\`:
+- If the character appears in this season's synopses—reuse the same \`id\` and \`name\`.
+- If the character does not appear—don't include them.
+
+Only after processing all prior plotlines, identify NEW plotlines not present before.
+
+### Step 2: Read all synopses and suggested plotlines
+Read ALL season synopses. If \`suggested_plotlines\` is present in the input, use them as a starting point — they come from an earlier analysis of the same synopses. Verify each suggestion against the text: keep what you find evidence for, drop what you don't, add what was missed. Story DNA is reconstructed from the aggregate of mentions across the season. Don't invent—mark confidence.
+
+### Step 3: Identify the main cast
+Recurring characters who drive plotlines. One character per cast entry. Guests are not cast.
+
+### Step 4: Extract plotlines
+For each plotline, fill in:
+- Story DNA: hero, goal, obstacle, stakes
+- type: case_of_the_week, serialized, or runner
+- nature: plot-led, character-led, or theme-led
+- confidence: solid, partial, or inferred
+
+# RULES
+### Naming
+Name and id = ONE abstract word by GOAL, not by event or outcome. Examples: "belonging", "leadership", "love", "redemption". Do NOT use compound names like "gang_survival" or "family_destruction"—use "survival" or "family". The \`id\` must be a single snake_case word matching the \`name\`.
+
+ Use \`Hero: Theme\` format for plotline names (e.g. "House: Authority", "Cameron: Ethics", "Jon: Honor"). This makes it clear who drives each plotline and prevents confusion during event assignment.
+
+Case_of_the_week plotline: name it by the franchise formula—"Case of the Week", "Crime of the Week", "Mission", etc.—so it is immediately clear this is a recurring structure.
+
+For theme-led plotlines, name by the institutional dynamic or conflict rather than by hero (e.g. "MI5 vs Slough House", "Lab Politics", "Professional Life at Sterling Cooper").
+
+### Seed and Wraparound
+
+Seed—an event function at the next step. Wraparound—a narrative device at the next step. Do not create plotlines of these types.
+
+### Format and Resolution
+
+- **serial/ensemble**: plotlines may extend beyond the season, cliffhanger in the finale is acceptable.
+- **is_anthology=true**: each season is independent, don't reference other seasons.
+
+### Quantity Expectations
+
+- Procedural: 1 case_of_the_week + 1–3 serialized arcs. Max 5 total.
+- Hybrid: 1 case_of_the_week + 2–4 serialized. Max 5 total.
+- Serial (≤8 episodes): max 5 plotlines. Serial (9+ episodes): max 7. Runners must span 3+ episodes.
+- Ensemble (≤8 episodes): max 7 plotlines. Ensemble (9+ episodes): max 9. Runners must span 3+ episodes.
+
+### General
+
+- When in doubt—do NOT create a plotline.
+- For procedural/hybrid format: create exactly 1 plotline with type case_of_the_week.
+- Nature of a plotline and nature of individual events can differ—plot-led action serving a character-led plotline is normal.
+- Don't invent missing Story DNA components—mark confidence as partial or inferred instead.
+- Goal language: same language as the synopses.
+
+# OUTPUT
+
+Think through your choices before writing the JSON. Each plotline must pass the logline test, and your work is reviewed by a human.
+
+Response—strictly JSON, no markdown wrapping, no comments outside JSON.
+
+\`\`\`json
+{
+  "show": "Breaking Bad",
+  "season": 1,
+  "cast": [
+    {"id": "walt", "name": "Walter White", "aliases": ["Walt", "Heisenberg", "Mr. White"]},
+    {"id": "jesse", "name": "Jesse Pinkman", "aliases": ["Jesse", "Cap'n Cook"]},
+    {"id": "hank", "name": "Hank Schrader", "aliases": ["Hank"]},
+    {"id": "skyler", "name": "Skyler White", "aliases": ["Skyler"]},
+    {"id": "tuco", "name": "Tuco Salamanca", "aliases": ["Tuco"]}
+  ],
+  "plotlines": [
+    {
+      "id": "empire",
+      "name": "Walt: Empire",
+      "hero": "walt",
+      "goal": "build a drug business",
+      "obstacle": "moral choices, escalating danger, unpredictable partners",
+      "stakes": "death, loss of humanity",
+      "type": "serialized",
+      "nature": "character-led",
+      "confidence": "solid"
+    },
+    {
+      "id": "family",
+      "name": "Walt: Family",
+      "hero": "walt",
+      "goal": "keep the family together and hide the truth",
+      "obstacle": "cancer, family pressure for treatment, escalating lies",
+      "stakes": "family breakdown, exposure",
+      "type": "serialized",
+      "nature": "character-led",
+      "confidence": "solid"
+    },
+    {
+      "id": "investigation",
+      "name": "Hank: Investigation",
+      "hero": "hank",
+      "goal": "find the new meth producer",
+      "obstacle": "no direct evidence, only circumstantial traces",
+      "stakes": "criminal at large, public threat",
+      "type": "serialized",
+      "nature": "plot-led",
+      "confidence": "solid"
+    },
+    {
+      "id": "partnership",
+      "name": "Jesse: Partnership",
+      "hero": "jesse",
+      "goal": "survive as Walt's drug business partner",
+      "obstacle": "incompetence, fear, conflict with Walt",
+      "stakes": "prison or death",
+      "type": "serialized",
+      "nature": "character-led",
+      "confidence": "solid"
+    },
+    {
+      "id": "cancer",
+      "name": "Walt: Cancer",
+      "hero": "walt",
+      "goal": "deal with the diagnosis",
+      "obstacle": null,
+      "stakes": null,
+      "type": "runner",
+      "nature": "character-led",
+      "confidence": "partial"
+    }
+  ]
+}
+\`\`\`
+
+Field types:
+
+**cast[]:**
+
+- \`id\`: string—unique snake_case identifier, used in \`hero\` field and in event \`characters\` at the next step
+- \`name\`: string—full name as in credits
+- \`aliases\`: array of strings—name variants found in synopses
+
+**plotlines[]:**
+
+- \`id\`: string—unique snake_case identifier (stable, doesn't change on rename)
+- \`name\`: string—display name (see naming convention)
+- \`hero\`: string—\`id\` of a character from cast
+- \`goal\`: string—in synopsis language
+- \`obstacle\`: string | null—in synopsis language (null for runners)
+- \`stakes\`: string | null—in synopsis language (null for runners)
+- \`type\`: enum—\`"case_of_the_week"\` | \`"serialized"\` | \`"runner"\`
+- \`nature\`: enum—\`"plot-led"\` | \`"character-led"\` | \`"theme-led"\`
+- \`confidence\`: enum—\`"solid"\` | \`"partial"\` | \`"inferred"\`
+
+Language of \`goal\`, \`obstacle\`, \`stakes\` fields—in the language of the synopsis.
+
+The \`span\` field (which episodes the plotline appears in) is computed by code from the next step's results—not included here.
+
+# VALIDATION
+
+Code will check:
+
+- JSON schema: all required fields present, enum values valid
+- Each \`hero\` references an existing \`id\` in \`cast\`
+- For procedural/hybrid format: exactly 1 plotline with type case_of_the_week
+
+Code cannot check: whether Story DNA makes narrative sense, whether you found all the plotlines—that's your job. Rank (A/B/C) is computed by code after the next step, not by you.`;
+
+const _PROMPT_PASS2 = `# ROLE
+You are a story editor breaking down a single episode: what happens, which plotline does it serve, what function does it play.
+
+# CONTEXT
+You receive: show title, season number, format, story engine, cast (with IDs), plotlines (with IDs and Story DNA), and one episode synopsis. Your output is one episode's worth of events and interactions.
+
+# GLOSSARY
+
+${_GLOSSARY}
+
+# TASK
+
+### Step 1: Break the synopsis into events
+Go through the synopsis sentence by sentence. Each sentence should result in at least one event.
+
+### Step 2: Assign each event to a plotline
+For each event, decide which plotline it belongs to. Use the assignment rules below.
+
+### Step 3: Assign functions
+For each event, assign its dramatic function. These are two separate tasks — which plotline an event belongs to and what function it plays are independent decisions.
+
+Assign functions based on what happens **within this episode**, not across the season. An event that is the climax of this episode's story might turn out to be an escalation in the season-long arc — but you only see this episode, so assign based on what you see here.
+
+### Step 4: Identify interactions between plotlines
+Check each pair of plotlines active in this episode. If they connect — through shared theme, dramatic irony, or converging characters — record the interaction. See interaction types in Glossary.
+
+### Step 5: Determine the episode theme
+One sentence. What idea ties the plotlines together? Look at what the climax/resolution of the A-story says.
+
+# RULES
+
+### Assigning events to plotlines
+
+Each event belongs to the plotline whose goal it advances. When multiple characters are in a scene, ask: whose goal moves forward here? That character's plotline owns the event.
+
+Guest characters don't have their own plotlines. A guest's action belongs to the main cast member whose plotline it serves.
+
+When one event advances two plotlines, assign it to the primary one and list the secondary in \`also_affects\`.
+
+### Checking your work
+
+Every sentence of the synopsis must produce at least one event. If you can't map a sentence to an event, you missed something.
+
+Every episode has at least 2-3 active plotlines. If all events ended up in one plotline — re-read the synopsis and look for events that belong to other plotlines, especially serialized ones that continue across episodes. In procedural and hybrid shows, don't assign everything to the case — character arcs and institutional dynamics have events too.
+
+If all plotlines in the episode have only escalation functions, or all have only crisis/resolution — you probably misassigned some functions. A well-written episode takes its main plotline through a full arc: setup → escalation → turning point → climax → resolution. Other plotlines may cover fewer stages, but the A-story typically has all of them.
+
+# OUTPUT
+
+Think through before writing the JSON. Your assignments are reviewed by a human and checked by code.
+
+Response—strictly JSON, no markdown wrapping, no comments outside JSON.
+
+
+\`\`\`json
+{
+  "show": "Breaking Bad",
+  "season": 1,
+  "episode": "S01E03",
+  "events": [
+    {
+      "event": "Walt and Jesse clean up Emilio's remains",
+      "plotline_id": "empire",
+      "function": "escalation",
+      "characters": ["walt", "jesse"],
+      "also_affects": null
+    },
+    {
+      "event": "Krazy-8 talks about his childhood, Walt about cancer",
+      "plotline_id": "empire",
+      "function": "escalation",
+      "characters": ["walt"],
+      "also_affects": ["family"]
+    },
+    {
+      "event": "Walt makes a pros and cons list for killing",
+      "plotline_id": "empire",
+      "function": "turning_point",
+      "characters": ["walt"],
+      "also_affects": null
+    },
+    {
+      "event": "Skyler organizes a family intervention",
+      "plotline_id": "family",
+      "function": "setup",
+      "characters": ["skyler", "walt"],
+      "also_affects": null
+    },
+    {
+      "event": "Family votes for chemo, Walt wants to refuse",
+      "plotline_id": "family",
+      "function": "escalation",
+      "characters": ["walt", "skyler"],
+      "also_affects": null
+    },
+    {
+      "event": "Hank finds the desert cooking site",
+      "plotline_id": "investigation",
+      "function": "escalation",
+      "characters": ["hank"],
+      "also_affects": null
+    },
+    {
+      "event": "DEA finds Krazy-8's car with meth",
+      "plotline_id": "investigation",
+      "function": "escalation",
+      "characters": ["hank"],
+      "also_affects": null
+    },
+    {
+      "event": "Native girl brings a mask to the DEA office",
+      "plotline_id": "investigation",
+      "function": "setup",
+      "characters": ["guest:native_girl"],
+      "also_affects": null
+    },
+    {
+      "event": "Walt decides to release Krazy-8",
+      "plotline_id": "empire",
+      "function": "turning_point",
+      "characters": ["walt"],
+      "also_affects": null
+    },
+    {
+      "event": "Walt notices the missing plate shard",
+      "plotline_id": "empire",
+      "function": "crisis",
+      "characters": ["walt"],
+      "also_affects": null
+    },
+    {
+      "event": "Walt strangles Krazy-8",
+      "plotline_id": "empire",
+      "function": "climax",
+      "characters": ["walt"],
+      "also_affects": null
+    },
+    {
+      "event": "Walt decides to tell Skyler about the cancer",
+      "plotline_id": "family",
+      "function": "turning_point",
+      "characters": ["walt"],
+      "also_affects": null
+    }
+  ],
+  "theme": "the illusion of control",
+  "interactions": [
+    {
+      "type": "thematic_rhyme",
+      "lines": ["empire", "family", "investigation"],
+      "description": "all three plotlines are about control—over another's life, one's own death, the law"
+    },
+    {
+      "type": "dramatic_irony",
+      "lines": ["empire", "investigation"],
+      "description": "the audience knows Walt = Heisenberg, Hank doesn't"
+    }
+  ]
+}
+\`\`\`
+
+### Field Types
+
+**events[]:**
+- \`event\`: string—one sentence
+- \`plotline_id\`: string | null—\`id\` of a plotline from the previous step, or \`null\` if the event doesn't fit any plotline
+- \`function\`: enum—\`"setup"\` | \`"inciting_incident"\` | \`"escalation"\` | \`"turning_point"\` | \`"crisis"\` | \`"climax"\` | \`"resolution"\`
+- \`characters\`: array of strings—\`id\` of characters from cast. For guest characters use \`"guest:short_name"\` (e.g. \`"guest:native_girl"\`)
+- \`also_affects\`: array of strings | null—\`id\` of secondarily affected plotlines
+
+**interactions[]:**
+- \`type\`: enum—\`"thematic_rhyme"\` | \`"dramatic_irony"\` | \`"convergence"\`
+- \`lines\`: array of strings—plotline \`id\`s
+- \`description\`: string
+
+# VALIDATION
+
+Code will check:
+- JSON schema: all required fields, enum values
+- Each \`plotline_id\` references an existing \`id\` from the previous step or is \`null\`
+- Each \`characters\` element references an existing \`id\` from cast or has the \`guest:\` prefix
+- \`theme\` is not empty
+
+Code cannot check: whether events cover the full synopsis, whether function assignments are correct, whether interactions are real—that's your job.`;
+
+const _PROMPT_PASS3 = `# ROLE
+
+You are a story editor with all episodes laid out in front of you. Check the full picture: are plotlines identified correctly, are events assigned right, does the structure hold up? Fix what's wrong.
+
+# CONTEXT
+
+You receive:
+- **show**, **season**, **format**, **story_engine** (series context)
+- **cast**: character list with \`id\`, \`name\`
+- **plotlines**: plotline list with \`id\`, \`name\`, \`hero\`, \`goal\`, \`obstacle\`, \`stakes\`, \`type\`, \`computed_rank\`, \`nature\`, \`confidence\`, \`span\`
+- **episodes**: for each episode—\`events\` (with plotline assignments), \`theme\`, \`interactions\`
+- **diagnostics** (optional): automated flags from post-processing. Each flag has \`plotline\`, \`flag\`, and \`reason\`. Possible flags:
+  - \`low_completeness\`—plotline has fewer arc functions than expected for its confidence (e.g. solid plotline with 3/7)
+  - \`monotonicity_violation\`—function sequence goes backwards past a milestone (e.g. crisis after climax)
+  - \`dominant\`—plotline has more than 50% of all season events
+  These are computed facts—use them in your analysis.
+
+Your output—verdicts (structural corrections)—is applied by code to produce the final result.
+
+# GLOSSARY
+
+${_GLOSSARY}
+
+# TASK
+
+### Step 1: Check each plotline for Story DNA
+
+Complete Story DNA: **hero → goal → obstacle → stakes**.
+
+**Logline test:** if you can write a logline with conflict (hero wants X, but Y stands in the way, Z is at stake)—it's a solid plotline.
+
+But shows can be poorly written. A plotline may exist without a clear goal, with nominal conflict, or be abandoned halfway. That doesn't mean it doesn't exist—it means it's weak. Don't discard weak plotlines—mark confidence instead.
+
+### Step 2: Spot-check event assignments
+
+Scan events across episodes. For each plotline, read its events and check: does this event advance THIS plotline's goal, or would it fit better elsewhere? Common errors:
+
+- Event assigned to hero's A-plotline but actually advances their B-plotline (wrong goal)
+- Event describes a character reacting to another plotline's conflict (should be \`also_affects\`, not primary assignment)
+- Multiple events in a row assigned to the same plotline but describing different conflicts
+
+If you find misassigned events → REASSIGN.
+
+### Step 3: Check plotline arcs
+
+Note: event functions from the previous step reflect each event's role within its episode, not within the season-long arc. Keep this in mind when checking arc progression — a "climax" in episode 3 may be an escalation in the season arc.
+
+If diagnostics include \`low_completeness\` — check if events of this plotline are misassigned to other plotlines (→ REASSIGN them back), or if the plotline is genuinely weak (→ note in your review, don't invent events).
+
+### Step 4: Look for duplication
+
+Two plotlines with the same hero and adjacent goals—most likely one plotline with phases. Signs:
+
+- Same hero, goals are causally linked (goal B is a consequence of goal A)
+- Events of two plotlines alternate in the same episodes
+- No conflict between the two plotlines—they don't contradict each other
+
+If confirmed → MERGE.
+
+If diagnostics include \`dominant\` — a plotline has more than half of all season events. Check if it's actually two plotlines collapsed into one (→ CREATE a second plotline + REASSIGN events to it).
+
+### Step 5: Check orphaned events
+
+Events with \`plotline_id: null\`—the previous step couldn't assign them. For each:
+
+- Event belongs to an existing plotline (assignment error) → REASSIGN
+- Multiple orphaned events form a pattern (one hero, one goal) → CREATE a new plotline
+
+### Step 6: Check format consistency
+
+The plotline structure should match the format:
+
+- **Procedural**: exactly one case_of_the_week plotline. Max 5 total.
+- **Hybrid**: one case_of_the_week + the rest serialized. Max 5 total.
+- **Serial**: max 5 plotlines. Runners must span 3+ episodes.
+- **Ensemble**: max 8 plotlines. Runners must span 3+ episodes.
+
+If the structure doesn't match—either the format was determined incorrectly, or the plotlines need adjustment.
+
+### Step 7: Assign ranks
+
+Each plotline has a \`computed_rank\` assigned by code from event counts. Review it. For each plotline, assign your own rank (A, B, C, or null for runners) based on narrative importance — what the show is about, not how many events a plotline has.
+
+Return your ranks in the \`ranks\` field — a mapping of plotline ID to rank.
+
+# RULES
+
+1. **If everything is fine—empty \`verdicts\` array.** Don't invent problems.
+2. **Each verdict must be justified by theory** (Story DNA, format, arc) or data (span, diagnostics).
+3. **REASSIGN references the exact event text** from input data. Do not rephrase.
+4. **MERGE: source events are automatically moved to target.** No need to list each one.
+5. **DROP: must specify where to move ALL events.** Code rejects DROP if any event remains unredistributed. Events are never removed or set to null.
+6. **CREATE: must specify complete Story DNA** (hero, goal, obstacle, stakes) and which events belong to it.
+7. **REFUNCTION: specify event text, episode, old function, new function.**
+8. **Don't flag inferred plotlines** for missing functions or low event count—incomplete structure is expected for them. Flag solid plotlines with incomplete structure.
+9. **DROP only phantoms.** DROP a plotline only if it has no events and doesn't exist in the series. A weak plotline in a bad script—that's data, not an error.
+
+# OUTPUT
+
+Think through each verdict before writing the JSON. Each verdict must be justified by data or theory — your review is checked by a human.
+
+Response—strictly JSON, no markdown wrapping, no comments outside JSON.
+
+\`\`\`json
+{
+  "verdicts": [
+    {
+      "action": "MERGE",
+      "source": "plotline_x",
+      "target": "plotline_y",
+      "reason": "one sentence—why"
+    },
+    {
+      "action": "REASSIGN",
+      "event": "exact event text",
+      "episode": "S01E06",
+      "from": null,
+      "to": "plotline_z",
+      "reason": "one sentence"
+    },
+    {
+      "action": "CREATE",
+      "plotline": {
+        "id": "new_plotline_id",
+        "name": "Hero: Theme",
+        "hero": "cast_id",
+        "goal": "...",
+        "obstacle": "...",
+        "stakes": "...",
+        "type": "serialized",
+        "nature": "character-led"
+      },
+      "reassign_events": [
+        {"event": "exact event text", "episode": "S01E03"},
+        {"event": "exact event text", "episode": "S01E06"}
+      ],
+      "reason": "one sentence"
+    },
+    {
+      "action": "DROP",
+      "target": "plotline_id",
+      "redistribute": [
+        {"event": "exact event text", "episode": "S01E02", "to": "other_plotline_id"}
+      ],
+      "reason": "one sentence"
+    },
+    {
+      "action": "REFUNCTION",
+      "event": "exact event text",
+      "episode": "S01E05",
+      "old_function": "escalation",
+      "new_function": "crisis",
+      "reason": "one sentence"
+    }
+  ],
+  "ranks": {
+    "empire": "A",
+    "family": "B",
+    "investigation": "C"
+  },
+  "notes": "brief comment on the quality of the original analysis (1–2 sentences)"
+}
+\`\`\`
+
+### Verdict Types
+
+| action | required fields |
+|--------|-----------------|
+| \`MERGE\` | \`source\`, \`target\`, \`reason\` |
+| \`REASSIGN\` | \`event\`, \`episode\`, \`from\`, \`to\`, \`reason\` |
+| \`CREATE\` | \`plotline\`, \`reassign_events\`, \`reason\` |
+| \`DROP\` | \`target\`, \`redistribute\`, \`reason\` |
+| \`REFUNCTION\` | \`event\`, \`episode\`, \`old_function\`, \`new_function\`, \`reason\` |
+
+# VALIDATION
+
+Code will check:
+- JSON schema: all required fields for each verdict type
+- \`target\`/\`source\` reference existing plotline ids
+- \`to\` in REASSIGN references an existing id (or an id from CREATE in the same verdict set)
+- \`event\` in REASSIGN/DROP/CREATE/REFUNCTION exactly matches event text in input data
+- \`new_function\`—valid function enum
+- \`plotline\` in CREATE contains all required fields
+
+Code cannot check: whether your verdicts improve the analysis, whether merges are justified, whether refunctions are correct—that's your job.`;
+
+const _PROMPT_PASS4 = `# ROLE
+You are a story editor looking at the complete season. All events have been identified and assigned to plotlines. Your job is to determine each event's role in the plotline's season-long arc.
+
+# CONTEXT
+
+You receive: show title, season, plotlines with Story DNA, and all events grouped by plotline in episode order. Each event already has a \`function\` — its role within its episode. You assign \`plot_fn\` — its role in the season arc.
+
+# GLOSSARY
+
+${_GLOSSARY}
+
+# TASK
+
+For each plotline, read its events in episode order. Assign \`plot_fn\` to every event — what role does this event play in the plotline's arc across the entire season?
+
+The episode's arc function may differ from the episode function. An event that was the climax of episode 3 might be an escalation in the season arc — the plotline is still building at that point.
+
+\`inciting_incident\` occurs once per plotline across the season — the event that sets the plotline in motion.
+
+Assign \`plot_fn\` to EVERY event. Do not skip any.
+
+# OUTPUT
+
+Think through the arc of each plotline before writing. You are assigning functions to a season-long story — consider where each event falls in the beginning, middle, and end of that story. Your assignments are reviewed by a human.
+
+Response — strictly JSON, no markdown wrapping.
+
+\`\`\`json
+{
+  "arc_functions": [
+    {"plotline": "empire", "episode": "S01E01", "event": "exact event text from input", "plot_fn": "setup"},
+    {"plotline": "empire", "episode": "S01E01", "event": "exact event text from input", "plot_fn": "inciting_incident"},
+    {"plotline": "empire", "episode": "S01E02", "event": "exact event text from input", "plot_fn": "escalation"}
+  ]
+}
+\`\`\`
+
+One entry per event. Use exact event text from the input — do not rephrase. Include the plotline ID so code can match events correctly.
+
+# VALIDATION
+
+Code will check:
+- Every event from the input has a corresponding entry in arc_functions
+- Each \`plot_fn\` is a valid function: setup, inciting_incident, escalation, turning_point, crisis, climax, resolution
+- Each \`event\` text exactly matches an event from the input
+- Each \`plotline\` references an existing plotline ID`;
+
+// --- Post-processing helpers (simplified browser versions) ---
+
+function _computeSpan(plotlines, episodes) {
+  for (const pl of plotlines) {
+    const epSet = new Set();
+    for (const ep of episodes) {
+      for (const ev of ep.events) {
+        if (ev.plotline_id === pl.id) epSet.add(ep.episode);
+      }
+    }
+    pl.span = [...epSet].sort();
+  }
+}
+
+function _computeRanks(plotlines, episodes, context) {
+  // Count events per plotline
+  const counts = {};
+  let total = 0;
+  for (const ep of episodes) {
+    for (const ev of ep.events) {
+      if (ev.plotline_id) {
+        counts[ev.plotline_id] = (counts[ev.plotline_id] || 0) + 1;
+        total++;
+      }
+    }
+  }
+
+  // Assign A/B/C based on proportion of total events
+  for (const pl of plotlines) {
+    const count = counts[pl.id] || 0;
+    const share = total > 0 ? count / total : 0;
+    if (pl.type === 'runner') {
+      pl.computed_rank = null;
+    } else if (share >= 0.25) {
+      pl.computed_rank = 'A';
+    } else if (share >= 0.10) {
+      pl.computed_rank = 'B';
+    } else {
+      pl.computed_rank = 'C';
+    }
+    pl.rank = pl.computed_rank;
+  }
+}
+
+function _applyVerdicts(verdicts, plotlines, episodes) {
+  // Simplified verdict application for browser pipeline
+  for (const v of verdicts) {
+    if (v.action === 'MERGE') {
+      // Move all events from source to target
+      for (const ep of episodes) {
+        for (const ev of ep.events) {
+          if (ev.plotline_id === v.source) {
+            ev.plotline_id = v.target;
+          }
+        }
+      }
+      // Remove source plotline
+      const idx = plotlines.findIndex(p => p.id === v.source);
+      if (idx >= 0) plotlines.splice(idx, 1);
+
+    } else if (v.action === 'REASSIGN') {
+      for (const ep of episodes) {
+        if (ep.episode === v.episode) {
+          for (const ev of ep.events) {
+            if (ev.event === v.event) {
+              ev.plotline_id = v.to;
+              break;
+            }
+          }
+          break;
+        }
+      }
+
+    } else if (v.action === 'CREATE') {
+      const newPl = Object.assign({}, v.plotline, {
+        computed_rank: null,
+        reviewed_rank: null,
+        span: [],
+      });
+      plotlines.push(newPl);
+      for (const re of (v.reassign_events || [])) {
+        for (const ep of episodes) {
+          if (ep.episode === re.episode) {
+            for (const ev of ep.events) {
+              if (ev.event === re.event) {
+                ev.plotline_id = v.plotline.id;
+                break;
+              }
+            }
+            break;
+          }
+        }
+      }
+
+    } else if (v.action === 'DROP') {
+      for (const re of (v.redistribute || [])) {
+        for (const ep of episodes) {
+          if (ep.episode === re.episode) {
+            for (const ev of ep.events) {
+              if (ev.event === re.event) {
+                ev.plotline_id = re.to;
+                break;
+              }
+            }
+            break;
+          }
+        }
+      }
+      const idx = plotlines.findIndex(p => p.id === v.target);
+      if (idx >= 0) plotlines.splice(idx, 1);
+
+    } else if (v.action === 'REFUNCTION') {
+      for (const ep of episodes) {
+        if (ep.episode === v.episode) {
+          for (const ev of ep.events) {
+            if (ev.event === v.event) {
+              ev.function = v.new_function;
+              break;
+            }
+          }
+          break;
+        }
+      }
+    }
+  }
+}
+
+function _applyArcFunctions(arcFunctions, episodes) {
+  // Apply plot_fn to events in place
+  let count = 0;
+  for (const af of arcFunctions) {
+    for (const ep of episodes) {
+      if (ep.episode === af.episode) {
+        for (const ev of ep.events) {
+          if (ev.event === af.event) {
+            ev.plot_fn = af.plot_fn;
+            count++;
+            break;
+          }
+        }
+        break;
+      }
+    }
+  }
+  return count;
+}
+
+// --- Individual pass runners ---
+
+async function _runPass0(synopses, seriesName, season, provider, apiKey, onChunk) {
+  const sample = synopses.slice(0, 3);
+  const data = {
+    show: seriesName,
+    season: season,
+    sample_synopses: sample.map(s => ({ episode: s.episode, text: s.text })),
+  };
+  const userMessage = JSON.stringify(data);
+  const text = await callLLM(_PROMPT_PASS0, userMessage, provider, apiKey, onChunk);
+  return _parseJSONResponse(text);
+}
+
+async function _runPass1(synopses, seriesName, season, context, provider, apiKey, onChunk) {
+  const data = {
+    show: seriesName,
+    season: season,
+    format: context.format,
+    is_ensemble: context.format === 'ensemble',
+    story_engine: context.story_engine,
+    synopses: synopses.map(s => ({ episode: s.episode, text: s.text })),
+  };
+  const userMessage = JSON.stringify(data);
+  const text = await callLLM(_PROMPT_PASS1, userMessage, provider, apiKey, onChunk);
+  return _parseJSONResponse(text);
+}
+
+async function _runPass2Episode(synopsis, seriesName, season, context, cast, plotlines, provider, apiKey, onChunk) {
+  const data = {
+    show: seriesName,
+    season: season,
+    episode: synopsis.episode,
+    format: context.format,
+    story_engine: context.story_engine,
+    cast: cast.map(c => ({ id: c.id, name: c.name, aliases: c.aliases || [] })),
+    plotlines: plotlines.map(p => ({
+      id: p.id,
+      name: p.name,
+      hero: p.hero,
+      goal: p.goal,
+      obstacle: p.obstacle,
+      stakes: p.stakes,
+      type: p.type,
+      rank: p.rank || null,
+      confidence: p.confidence,
+    })),
+    synopsis: synopsis.text,
+  };
+  const userMessage = JSON.stringify(data);
+  const text = await callLLM(_PROMPT_PASS2, userMessage, provider, apiKey, onChunk);
+  return _parseJSONResponse(text);
+}
+
+async function _runPass3(seriesName, season, context, cast, plotlines, episodes, provider, apiKey, onChunk) {
+  const payload = {
+    show: seriesName,
+    season: season,
+    format: context.format,
+    is_ensemble: context.format === 'ensemble',
+    story_engine: context.story_engine,
+    cast: cast.map(c => ({ id: c.id, name: c.name })),
+    plotlines: plotlines.map(p => ({
+      id: p.id,
+      name: p.name,
+      hero: p.hero,
+      goal: p.goal,
+      obstacle: p.obstacle,
+      stakes: p.stakes,
+      type: p.type,
+      computed_rank: p.computed_rank,
+      nature: p.nature,
+      confidence: p.confidence,
+      span: p.span,
+    })),
+    episodes: episodes.map(ep => ({
+      episode: ep.episode,
+      theme: ep.theme,
+      events: ep.events.map(e => ({
+        event: e.event,
+        plotline_id: e.plotline_id,
+        function: e.function,
+        characters: e.characters,
+        also_affects: e.also_affects,
+      })),
+    })),
+  };
+  const userMessage = JSON.stringify(payload);
+  const text = await callLLM(_PROMPT_PASS3, userMessage, provider, apiKey, onChunk);
+  return _parseJSONResponse(text);
+}
+
+async function _runPass4Plotline(seriesName, season, plotline, episodes, provider, apiKey, onChunk) {
+  // Build user message for one plotline's events (matches Python _build_plotline_message)
+  const events = [];
+  for (const ep of episodes) {
+    for (const ev of ep.events) {
+      if (ev.plotline_id === plotline.id) {
+        events.push({ episode: ep.episode, function: ev.function, event: ev.event });
+      }
+    }
+  }
+  if (events.length === 0) return null;
+
+  const lines = [
+    `Show: ${seriesName}, Season ${season}`,
+    '',
+    `Plotline ID: ${plotline.id} — ${plotline.name} (hero=${plotline.hero}, goal=${plotline.goal})`,
+    'Events:',
+  ];
+  for (const e of events) {
+    lines.push(`  [${e.episode}] (${e.function}) ${e.event}`);
+  }
+
+  const userMessage = lines.join('\n');
+  const text = await callLLM(_PROMPT_PASS4, userMessage, provider, apiKey, onChunk);
+  return _parseJSONResponse(text);
+}
+
+// --- Main pipeline ---
+
+async function runPipeline(synopses, seriesName, provider, apiKey, onProgress) {
+  // synopses = [{episode: "S01E01", text: "..."}, ...]
+  // onProgress = function(message, passNumber, totalPasses)
+  const totalPasses = 5;
+
+  // Derive season from first episode code
+  const season = parseInt(synopses[0].episode.slice(1, 3), 10);
+
+  // Pass 0: detect context
+  onProgress('Pass 1/5: detecting format and story engine...', 1, totalPasses);
+  const pass0Result = await _runPass0(synopses, seriesName, season, provider, apiKey);
+  const context = {
+    format: pass0Result.format,
+    story_engine: pass0Result.story_engine,
+    genre: pass0Result.genre || '',
+    is_anthology: !!pass0Result.is_anthology,
+  };
+
+  // Pass 1: extract cast and plotlines
+  onProgress('Pass 2/5: identifying cast and plotlines...', 2, totalPasses);
+  const pass1Result = await _runPass1(synopses, seriesName, season, context, provider, apiKey);
+  const cast = pass1Result.cast || [];
+  const plotlines = pass1Result.plotlines || [];
+
+  // Pass 2: assign events for each episode (sequential — one API call per episode)
+  onProgress('Pass 3/5: breaking down episodes...', 3, totalPasses);
+  const episodes = [];
+  for (let i = 0; i < synopses.length; i++) {
+    onProgress(
+      `Pass 3/5: episode ${i + 1}/${synopses.length} (${synopses[i].episode})...`,
+      3, totalPasses,
+    );
+    const epResult = await _runPass2Episode(
+      synopses[i], seriesName, season, context, cast, plotlines, provider, apiKey,
+    );
+    episodes.push({
+      episode: epResult.episode || synopses[i].episode,
+      events: epResult.events || [],
+      theme: epResult.theme || '',
+      interactions: epResult.interactions || [],
+    });
+  }
+
+  // Post-processing: compute span and ranks
+  _computeSpan(plotlines, episodes);
+  _computeRanks(plotlines, episodes, context);
+
+  // Pass 3: structural review
+  onProgress('Pass 4/5: reviewing structure...', 4, totalPasses);
+  const pass3Result = await _runPass3(
+    seriesName, season, context, cast, plotlines, episodes, provider, apiKey,
+  );
+  const verdicts = pass3Result.verdicts || [];
+  const llmRanks = pass3Result.ranks || {};
+
+  if (verdicts.length > 0) {
+    _applyVerdicts(verdicts, plotlines, episodes);
+    _computeSpan(plotlines, episodes);
+  }
+
+  // Apply LLM rank overrides
+  for (const pl of plotlines) {
+    const llmRank = llmRanks[pl.id];
+    if (llmRank && llmRank !== pl.computed_rank) {
+      pl.reviewed_rank = llmRank;
+    }
+    pl.rank = pl.reviewed_rank || pl.computed_rank;
+  }
+
+  // Pass 4: arc functions (one call per plotline)
+  onProgress('Pass 5/5: assigning arc functions...', 5, totalPasses);
+  for (let i = 0; i < plotlines.length; i++) {
+    const pl = plotlines[i];
+    onProgress(
+      `Pass 5/5: plotline ${i + 1}/${plotlines.length} (${pl.name})...`,
+      5, totalPasses,
+    );
+    const result = await _runPass4Plotline(
+      seriesName, season, pl, episodes, provider, apiKey,
+    );
+    if (result && result.arc_functions) {
+      _applyArcFunctions(result.arc_functions, episodes);
+    }
+  }
+
+  onProgress('Done!', totalPasses, totalPasses);
+
+  // Build final result in the same format as bb_s01.json
+  return {
+    context: {
+      series: seriesName,
+      season: `S${String(season).padStart(2, '0')}`,
+      format: context.format,
+      story_engine: context.story_engine,
+      genre: context.genre,
+      is_anthology: context.is_anthology,
+    },
+    cast: cast,
+    plotlines: plotlines,
+    episodes: episodes,
+  };
+}
+
+// --- Synopsis file upload and parsing ---
+
+function _parseEpisodeCode(filename) {
+  // Extract S01E01-style codes from filenames like "S01E01.txt" or "Breaking Bad S01E01.txt"
+  const match = filename.match(/S(\d{2})E(\d{2})/i);
+  if (match) return `S${match[1]}E${match[2]}`;
+  return null;
+}
+
+async function _readFileAsText(file) {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = () => resolve(reader.result);
+    reader.onerror = () => reject(reader.error);
+    reader.readAsText(file);
+  });
+}
+
+async function _handleSynopsisUpload(files) {
+  const provider = Store.getProvider();
+  const apiKey = Store.getKey();
+
+  if (!provider || !apiKey) {
+    alert('Please configure your API key first (click LLM in the toolbar).');
+    return;
+  }
+
+  // Parse files into synopses
+  const synopses = [];
+  const errors = [];
+  for (const file of files) {
+    const episode = _parseEpisodeCode(file.name);
+    if (!episode) {
+      errors.push(file.name);
+      continue;
+    }
+    const text = await _readFileAsText(file);
+    if (text.trim()) {
+      synopses.push({ episode, text: text.trim() });
+    }
+  }
+
+  if (errors.length > 0) {
+    alert(
+      `Could not parse episode code from: ${errors.join(', ')}\n` +
+      'Filenames must contain SxxExx (e.g. S01E01.txt).'
+    );
+  }
+
+  if (synopses.length === 0) {
+    alert('No valid synopsis files found.');
+    return;
+  }
+
+  // Sort by episode code
+  synopses.sort((a, b) => a.episode.localeCompare(b.episode));
+
+  // Derive series name from first filename (strip episode code and extension)
+  let seriesName = files[0].name
+    .replace(/S\d{2}E\d{2}/i, '')
+    .replace(/\.txt$/i, '')
+    .trim()
+    .replace(/[_-]+$/, '')
+    .trim();
+  if (!seriesName) seriesName = 'Untitled Series';
+
+  // Show progress UI
+  _showPipelineProgress();
+
+  try {
+    const result = await runPipeline(synopses, seriesName, provider, apiKey, (message, pass, total) => {
+      _updatePipelineProgress(message, pass, total);
+    });
+
+    // Save and display result
+    const name = `${seriesName} S${String(parseInt(synopses[0].episode.slice(1, 3), 10)).padStart(2, '0')}`;
+    Store.saveResult(name, result);
+    _populateSeriesDropdown();
+
+    const select = document.getElementById('series-select');
+    if (select) select.value = name;
+
+    _switchSeries(name);
+    _setTab('grid');
+    _hidePipelineProgress();
+
+  } catch (err) {
+    _hidePipelineProgress();
+    console.error('Pipeline error:', err);
+    alert(`Pipeline failed: ${err.message}`);
+  }
+}
+
+// --- Pipeline progress UI ---
+
+function _showPipelineProgress() {
+  let overlay = document.getElementById('pipeline-progress');
+  if (!overlay) {
+    overlay = document.createElement('div');
+    overlay.id = 'pipeline-progress';
+    overlay.className = 'pipeline-progress-overlay';
+    overlay.innerHTML = `
+      <div class="pipeline-progress-box">
+        <h3>Running pipeline...</h3>
+        <div class="pipeline-progress-bar-container">
+          <div id="pipeline-progress-bar" class="pipeline-progress-bar"></div>
+        </div>
+        <p id="pipeline-progress-text">Starting...</p>
+      </div>
+    `;
+    document.body.appendChild(overlay);
+  }
+  overlay.classList.remove('hidden');
+}
+
+function _updatePipelineProgress(message, pass, total) {
+  const text = document.getElementById('pipeline-progress-text');
+  const bar = document.getElementById('pipeline-progress-bar');
+  if (text) text.textContent = message;
+  if (bar) bar.style.width = `${(pass / total) * 100}%`;
+}
+
+function _hidePipelineProgress() {
+  const overlay = document.getElementById('pipeline-progress');
+  if (overlay) overlay.classList.add('hidden');
+}
diff --git a/src/tvplotlines/html/parts/shell.html b/src/tvplotlines/html/parts/shell.html
index fdd6606..43d119b 100644
--- a/src/tvplotlines/html/parts/shell.html
+++ b/src/tvplotlines/html/parts/shell.html
@@ -69,11 +69,11 @@ <h1>TV Plotlines Viewer</h1>
 <div id="drop-zone" class="drop-zone-overlay hidden">
   <div class="drop-zone-box">
     <div class="drop-zone-icon">&#128194;</div>
-    <p>Drop a tvplotlines JSON file here</p>
+    <p>Drop a JSON result or .txt synopses here</p>
     <p class="drop-zone-hint">or</p>
-    <label class="btn" for="file-upload">Choose file</label>
-    <input type="file" id="file-upload" accept=".json" hidden>
-    <button class="drop-zone-close" onclick="_hideDropZone()">&times;</button>
+    <label class="btn" for="file-upload">Choose files</label>
+    <input type="file" id="file-upload" accept=".json,.txt" multiple hidden>
+    <button id="drop-zone-close" class="drop-zone-close">&times;</button>
   </div>
 </div>
 
diff --git a/src/tvplotlines/html/parts/style.css b/src/tvplotlines/html/parts/style.css
index bdde7fb..18fb7f3 100644
--- a/src/tvplotlines/html/parts/style.css
+++ b/src/tvplotlines/html/parts/style.css
@@ -385,3 +385,32 @@ html.dark .export-menu button:hover { background: #2a2a2a; }
 :root.dark .ana-char-name { color: #cdd6f4; }
 :root.dark .ana-char-bar { background: #89b4fa; color: #1e1e2e; }
 :root.dark .ana-char-dot { background: #89b4fa; }
+
+/* ── Pipeline progress overlay ── */
+.pipeline-progress-overlay {
+  position: fixed; inset: 0; z-index: 9999;
+  background: rgba(0,0,0,0.5); display: flex;
+  align-items: center; justify-content: center;
+}
+.pipeline-progress-overlay.hidden { display: none; }
+.pipeline-progress-box {
+  background: #fff; border-radius: 12px; padding: 2rem 2.5rem;
+  min-width: 360px; max-width: 480px; box-shadow: 0 8px 32px rgba(0,0,0,0.2);
+  text-align: center;
+}
+.pipeline-progress-box h3 { margin-bottom: 1rem; font-weight: 500; }
+.pipeline-progress-bar-container {
+  background: #e0e0e0; border-radius: 6px; height: 8px;
+  overflow: hidden; margin-bottom: 0.75rem;
+}
+.pipeline-progress-bar {
+  background: #4a90d9; height: 100%; width: 0%;
+  border-radius: 6px; transition: width 0.3s ease;
+}
+.pipeline-progress-box p {
+  font-size: 0.85rem; color: #666; margin: 0;
+}
+:root.dark .pipeline-progress-box { background: #1e1e2e; color: #cdd6f4; }
+:root.dark .pipeline-progress-bar-container { background: #313244; }
+:root.dark .pipeline-progress-bar { background: #89b4fa; }
+:root.dark .pipeline-progress-box p { color: #a6adc8; }

From 70c21ea471df08b1d60293b030e56015d6f25ac6 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Fri, 10 Apr 2026 13:30:25 +0200
Subject: [PATCH 09/24] fix: dark mode CSS, inciting_incident styling,
 analytics header, episode labels

- Force color-scheme to prevent Firefox dark mode override
- .hidden !important to fix drop zone appearing on load
- inciting_incident: no background, bright green text
- crisis function color added
- Story engine / logline moved above all analytics sections
- Episode numbers shown once in scorecard header
- Episode Pulse: removed themes, added plotline color legend

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/tvplotlines/html/parts/analytics.js | 102 ++++++++++++++++++++----
 src/tvplotlines/html/parts/shell.html   |   1 +
 src/tvplotlines/html/parts/style.css    |  44 +++++++---
 3 files changed, 119 insertions(+), 28 deletions(-)

diff --git a/src/tvplotlines/html/parts/analytics.js b/src/tvplotlines/html/parts/analytics.js
index c601933..d270663 100644
--- a/src/tvplotlines/html/parts/analytics.js
+++ b/src/tvplotlines/html/parts/analytics.js
@@ -250,28 +250,61 @@ function renderAnalytics(data, container) {
 
   container.innerHTML = '';
 
-  container.appendChild(_renderScorecard(scorecard, storyEngine));
+  // Series header: name + story engine (logline) before all sections
+  const seriesName = (data.context || {}).show_name || (typeof _currentSeriesName !== 'undefined' ? _currentSeriesName : '') || '';
+  if (seriesName || storyEngine) {
+    const header = document.createElement('div');
+    header.className = 'ana-series-header';
+    if (seriesName) {
+      const h1 = document.createElement('h1');
+      h1.className = 'ana-series-name';
+      h1.textContent = seriesName;
+      header.appendChild(h1);
+    }
+    if (storyEngine) {
+      const logline = document.createElement('p');
+      logline.className = 'ana-logline';
+      logline.textContent = storyEngine;
+      header.appendChild(logline);
+    }
+    container.appendChild(header);
+  }
+
+  container.appendChild(_renderScorecard(scorecard));
   container.appendChild(_renderArcMap(arcMap));
   container.appendChild(_renderPulse(pulse));
   container.appendChild(_renderConvergence(convergence));
   container.appendChild(_renderCharacters(characters));
 }
 
-function _renderScorecard(scorecard, storyEngine) {
+function _renderScorecard(scorecard) {
   const section = _section('Season Scorecard');
 
-  if (storyEngine) {
-    const engine = document.createElement('div');
-    engine.className = 'ana-engine';
-    engine.textContent = storyEngine;
-    section.appendChild(engine);
-  }
-
   const table = document.createElement('table');
   table.className = 'ana-scorecard';
 
   const thead = document.createElement('thead');
-  thead.innerHTML = '<tr><th>Rank</th><th>Plotline</th><th>Span</th><th>Events</th><th>Arc</th></tr>';
+  // Header row with episode numbers under Span
+  const headerRow = document.createElement('tr');
+  headerRow.innerHTML = '<th>Rank</th><th>Plotline</th><th>Span</th><th>Events</th><th>Arc</th>';
+  thead.appendChild(headerRow);
+
+  // Episode numbers row
+  const epRow = document.createElement('tr');
+  epRow.className = 'ana-scorecard-ep-row';
+  epRow.innerHTML = '<th></th><th></th><th></th><th></th><th></th>';
+  const epCell = epRow.children[2];
+  const epLabels = document.createElement('div');
+  epLabels.className = 'ana-span-labels';
+  for (const ep of scorecard.episode_codes) {
+    const lbl = document.createElement('span');
+    lbl.className = 'ana-span-label';
+    lbl.textContent = ep.split('E').pop();
+    epLabels.appendChild(lbl);
+  }
+  epCell.appendChild(epLabels);
+  thead.appendChild(epRow);
+
   table.appendChild(thead);
 
   const tbody = document.createElement('tbody');
@@ -292,13 +325,14 @@ function _renderScorecard(scorecard, storyEngine) {
     tdName.textContent = pl.name;
     tr.appendChild(tdName);
 
-    // Span dots
+    // Span dots (labels are in thead)
     const tdSpan = document.createElement('td');
     const spanBar = document.createElement('div');
     spanBar.className = 'ana-span-bar';
     for (const ep of scorecard.episode_codes) {
       const dot = document.createElement('div');
       dot.className = 'ana-span-dot ' + (pl.span.includes(ep) ? 'active' : 'inactive');
+      dot.title = ep;
       spanBar.appendChild(dot);
     }
     tdSpan.appendChild(spanBar);
@@ -455,13 +489,41 @@ function _renderPulse(pulse) {
     totalDiv.textContent = ep.total;
     row.appendChild(totalDiv);
 
-    const themeDiv = document.createElement('div');
-    themeDiv.className = 'ana-pulse-theme';
-    themeDiv.textContent = ep.theme;
-    row.appendChild(themeDiv);
-
     section.appendChild(row);
   }
+
+  // Legend: which color = which plotline
+  const legend = document.createElement('div');
+  legend.className = 'ana-pulse-legend';
+  const allPlotlines = [];
+  const seen = new Set();
+  for (const ep of pulse) {
+    for (const seg of ep.segments) {
+      if (!seen.has(seg.plotline_name)) {
+        seen.add(seg.plotline_name);
+        allPlotlines.push(seg.plotline_name);
+      }
+    }
+  }
+  for (let i = 0; i < allPlotlines.length; i++) {
+    const item = document.createElement('span');
+    item.className = 'ana-pulse-legend-item';
+    const swatch = document.createElement('span');
+    swatch.className = 'ana-pulse-bar';
+    swatch.style.display = 'inline-block';
+    swatch.style.width = '12px';
+    swatch.style.height = '12px';
+    swatch.style.borderRadius = '2px';
+    swatch.style.verticalAlign = 'middle';
+    swatch.style.marginRight = '4px';
+    // Use nth-child color by applying the index via a CSS variable
+    swatch.style.background = _pulseColor(i);
+    item.appendChild(swatch);
+    item.appendChild(document.createTextNode(allPlotlines[i]));
+    legend.appendChild(item);
+  }
+  section.appendChild(legend);
+
   return section;
 }
 
@@ -551,6 +613,14 @@ function _renderCharacters(characters) {
 
 // --- Helpers ---
 
+const _PULSE_COLORS_LIGHT = ['#2563eb', '#f59e0b', '#ef4444', '#6b7280', '#8b5cf6', '#10b981'];
+const _PULSE_COLORS_DARK = ['#89b4fa', '#f9e2af', '#f38ba8', '#a6adc8', '#cba6f7', '#a6e3a1'];
+function _pulseColor(i) {
+  const isDark = document.documentElement.classList.contains('dark');
+  const palette = isDark ? _PULSE_COLORS_DARK : _PULSE_COLORS_LIGHT;
+  return palette[i % palette.length];
+}
+
 function _section(title) {
   const section = document.createElement('section');
   section.className = 'ana-section';
diff --git a/src/tvplotlines/html/parts/shell.html b/src/tvplotlines/html/parts/shell.html
index 43d119b..34f07dc 100644
--- a/src/tvplotlines/html/parts/shell.html
+++ b/src/tvplotlines/html/parts/shell.html
@@ -3,6 +3,7 @@
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="color-scheme" content="light dark">
 <title>TV Plotlines Viewer</title>
 <style>
 /* {{STYLE}} */
diff --git a/src/tvplotlines/html/parts/style.css b/src/tvplotlines/html/parts/style.css
index 18fb7f3..4ab42e2 100644
--- a/src/tvplotlines/html/parts/style.css
+++ b/src/tvplotlines/html/parts/style.css
@@ -1,11 +1,13 @@
-/* Reset & base */
+/* Reset & base — force our color scheme, override browser dark mode */
+:root { color-scheme: light; }
+:root.dark { color-scheme: dark; }
 * { box-sizing: border-box; margin: 0; padding: 0; }
 body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; background: #f5f5f5; color: #1a1a1a; }
 
 /* ── Screen routing ── */
 .screen { display: none; }
 .screen.active { display: block; }
-.hidden { display: none; }
+.hidden { display: none !important; }
 
 /* ── Welcome screen ── */
 .welcome-container {
@@ -156,7 +158,9 @@ html.dark .export-menu button:hover { background: #2a2a2a; }
 /* ── Function colors ── */
 .fn-setup { background: #f3f4f6; }
 .fn-escalation { background: #fef9c3; }
+.fn-inciting_incident { background: transparent; color: #16a34a; font-weight: 600; }
 .fn-turning_point { background: #fed7aa; }
+.fn-crisis { background: #fecaca; }
 .fn-seed { background: #dbeafe; }
 .fn-climax { background: #fecaca; }
 .fn-resolution { background: #d1fae5; }
@@ -250,14 +254,17 @@ html.dark .export-menu button:hover { background: #2a2a2a; }
 :root.dark .chart-title { color: #cba6f7; }
 :root.dark .chart-description { color: #a6adc8; }
 
-/* ── Dark function colors — warm muted tones ── */
-:root.dark .fn-setup { background: #313244; color: #bac2de; }
-:root.dark .fn-escalation { background: #433a2a; color: #f9e2af; }
-:root.dark .fn-turning_point { background: #3d2f24; color: #fab387; }
-:root.dark .fn-seed { background: #243347; color: #89b4fa; }
-:root.dark .fn-climax { background: #3d2332; color: #f38ba8; }
-:root.dark .fn-resolution { background: #1e3d2e; color: #a6e3a1; }
-:root.dark .fn-cliffhanger { background: #302040; color: #cba6f7; }
+/* ── Dark function colors — single text color, background varies ── */
+:root.dark .event-card { color: #cdd6f4; }
+:root.dark .fn-setup { background: #313244; }
+:root.dark .fn-escalation { background: #433a2a; }
+:root.dark .fn-inciting_incident { background: transparent; color: #a6e3a1; font-weight: 600; }
+:root.dark .fn-turning_point { background: #3d2f24; }
+:root.dark .fn-crisis { background: #3d2332; }
+:root.dark .fn-seed { background: #243347; }
+:root.dark .fn-climax { background: #3d2332; }
+:root.dark .fn-resolution { background: #1e3d2e; }
+:root.dark .fn-cliffhanger { background: #302040; }
 
 /* ── Dark rank badges ── */
 :root.dark .rank-a { background: #243347; color: #89b4fa; }
@@ -268,6 +275,12 @@ html.dark .export-menu button:hover { background: #2a2a2a; }
 /* ── Analytics ── */
 :root { --ana-tension-0: #f0f0f0; --ana-tension-1: #bae6d1; --ana-tension-2: #f0e68c; --ana-tension-3: #f5b87a; --ana-tension-4: #e87c7c; --ana-tension-5: #d44a7a; }
 
+.ana-series-header { margin-bottom: 1.5rem; max-width: 1200px; }
+.ana-series-name { font-size: 1.5rem; font-weight: 300; letter-spacing: 0.03em; margin-bottom: 0.5rem; }
+.ana-logline { font-size: 0.95rem; color: #555; line-height: 1.5; font-style: italic; }
+:root.dark .ana-series-name { color: #cba6f7; }
+:root.dark .ana-logline { color: #a6adc8; }
+
 .ana-section { background: white; border-radius: 8px; padding: 1.5rem; margin-bottom: 1.5rem; box-shadow: 0 1px 3px rgba(0,0,0,0.1); max-width: 1200px; }
 .ana-title { font-size: 1.2rem; font-weight: 600; margin-bottom: 1rem; }
 .ana-engine { font-size: 0.9rem; color: #666; margin-bottom: 1rem; padding: 0.5rem 0.75rem; background: #f8f8f8; border-radius: 6px; border-left: 3px solid #2563eb; }
@@ -279,6 +292,10 @@ html.dark .export-menu button:hover { background: #2a2a2a; }
 .ana-scorecard tr:last-child td { border-bottom: none; }
 .ana-plotline-name { font-weight: 500; }
 .ana-arc-summary { color: #666; font-size: 0.8rem; }
+.ana-scorecard-ep-row th { border-bottom: none; padding-top: 0; }
+.ana-span-labels { display: flex; gap: 2px; margin-bottom: 2px; }
+.ana-span-label { width: 14px; text-align: center; font-size: 0.55rem; color: #999; }
+:root.dark .ana-span-label { color: #6c7086; }
 .ana-span-bar { display: flex; gap: 2px; }
 .ana-span-dot { width: 14px; height: 14px; border-radius: 3px; }
 .ana-span-dot.active { background: #2563eb; opacity: 0.7; }
@@ -317,7 +334,10 @@ html.dark .export-menu button:hover { background: #2a2a2a; }
 .ana-pulse-bar:nth-child(5) { background: #8b5cf6; color: white; }
 .ana-pulse-bar:nth-child(6) { background: #10b981; }
 .ana-pulse-total { font-size: 0.8rem; color: #666; width: 30px; text-align: right; flex-shrink: 0; }
-.ana-pulse-theme { font-size: 0.75rem; color: #999; width: 220px; flex-shrink: 0; font-style: italic; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.ana-pulse-theme { display: none; }
+.ana-pulse-legend { display: flex; flex-wrap: wrap; gap: 0.75rem; margin-top: 0.75rem; font-size: 0.8rem; }
+.ana-pulse-legend-item { display: flex; align-items: center; gap: 4px; }
+:root.dark .ana-pulse-legend-item { color: #cdd6f4; }
 
 /* Convergence */
 .ana-conv-timeline { position: relative; padding-left: 40px; }
@@ -392,7 +412,7 @@ html.dark .export-menu button:hover { background: #2a2a2a; }
   background: rgba(0,0,0,0.5); display: flex;
   align-items: center; justify-content: center;
 }
-.pipeline-progress-overlay.hidden { display: none; }
+.pipeline-progress-overlay.hidden { display: none !important; }
 .pipeline-progress-box {
   background: #fff; border-radius: 12px; padding: 2rem 2.5rem;
   min-width: 360px; max-width: 480px; box-shadow: 0 8px 32px rgba(0,0,0,0.2);

From a7b1f1639223b320405f767f72a0c195bbc64571 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Fri, 10 Apr 2026 13:31:34 +0200
Subject: [PATCH 10/24] Add --html and --html-output flags to CLI run command

Generate a standalone HTML viewer alongside the result JSON when
--html is passed. Uses build_html() from the html module. Defaults
to saving next to the JSON with .html extension; --html-output
overrides the path.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/tvplotlines/cli.py | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/src/tvplotlines/cli.py b/src/tvplotlines/cli.py
index a4ba75a..e0f9bce 100644
--- a/src/tvplotlines/cli.py
+++ b/src/tvplotlines/cli.py
@@ -227,6 +227,15 @@ def _run(args: argparse.Namespace) -> None:
         ts_path.write_text(result_json, encoding="utf-8")
         print(f"Copy saved to {ts_path}")
 
+    # Generate standalone HTML viewer if requested
+    if args.html or args.html_output:
+        from tvplotlines.html.build import build_html
+
+        html_path = args.html_output or output.with_suffix(".html")
+        html_content = build_html(data_path=output)
+        html_path.write_text(html_content, encoding="utf-8")
+        print(f"HTML viewer saved to {html_path}")
+
     # Print summary
     print(f"Context: {result.context.format} | {result.context.story_engine}")
     if result.context.is_ensemble:
@@ -331,6 +340,14 @@ def main() -> None:
         "--output-dir", type=Path, metavar="DIR",
         help="Save timestamped result to this directory (e.g. runs/)",
     )
+    run_parser.add_argument(
+        "--html", action="store_true",
+        help="Generate a standalone HTML viewer alongside the result JSON",
+    )
+    run_parser.add_argument(
+        "--html-output", type=Path, metavar="PATH",
+        help="Custom path for HTML viewer (implies --html)",
+    )
 
     # tvplotlines write-synopses
     ws_parser = sub.add_parser(

From bbc476ac03eef431a0ea8dd0b1f6b69b2bce76db Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Fri, 10 Apr 2026 13:32:25 +0200
Subject: [PATCH 11/24] Add minimal welcome screen with first-visit detection

Japanese minimalism aesthetic: lightweight typography, pill-shaped
"Play me" button, subtle "Skip" link. First visit shows welcome,
returning visits skip straight to grid. Smooth fade-out transition.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/tvplotlines/html/parts/app.js     | 53 +++++++++++++++------------
 src/tvplotlines/html/parts/shell.html | 11 ++----
 src/tvplotlines/html/parts/style.css  | 50 +++++++++++++++----------
 3 files changed, 64 insertions(+), 50 deletions(-)

diff --git a/src/tvplotlines/html/parts/app.js b/src/tvplotlines/html/parts/app.js
index b667fd8..d2f2bb7 100644
--- a/src/tvplotlines/html/parts/app.js
+++ b/src/tvplotlines/html/parts/app.js
@@ -371,25 +371,25 @@ function _initApp() {
   });
 
   // Welcome screen buttons
-  const btnDemo = document.getElementById('btn-demo');
-  if (btnDemo) {
-    btnDemo.addEventListener('click', () => {
-      Store.markOnboardingSeen();
+  const btnPlay = document.getElementById('btn-play');
+  const btnSkip = document.getElementById('btn-skip');
+
+  function _leaveWelcome() {
+    Store.markOnboardingSeen();
+    const container = document.querySelector('.welcome-container');
+    if (container) container.classList.add('fade-out');
+    // Transition to grid after fade completes
+    setTimeout(() => {
       _switchSeries('__demo__');
       _setTab('grid');
-    });
+    }, 400);
   }
 
-  // Welcome file upload also uses _importJSON
-  const welcomeUpload = document.getElementById('welcome-file-upload');
-  if (welcomeUpload) {
-    welcomeUpload.addEventListener('change', (e) => {
-      const file = e.target.files[0];
-      if (file) {
-        Store.markOnboardingSeen();
-        _importJSON(file);
-      }
-      welcomeUpload.value = '';
+  if (btnPlay) btnPlay.addEventListener('click', _leaveWelcome);
+  if (btnSkip) {
+    btnSkip.addEventListener('click', (e) => {
+      e.preventDefault();
+      _leaveWelcome();
     });
   }
 
@@ -402,10 +402,21 @@ function _initApp() {
   const savedResults = Store.getResults();
   const hasSavedData = Object.keys(savedResults).length > 0;
 
-  // Welcome screen will be implemented in Task 11.
-  // For now, always go straight to grid with demo data.
+  // Handle #demo URL hash — always go to grid
+  if (demoData && window.location.hash === '#demo') {
+    Store.markOnboardingSeen();
+    _switchSeries('__demo__');
+    _setTab('grid');
+    return;
+  }
 
-  // Determine which series to load
+  // First visit — show welcome screen
+  if (!hasSeenOnboarding) {
+    showScreen('welcome');
+    return;
+  }
+
+  // Returning visit — go straight to grid
   let seriesName = settings.lastSeries || null;
 
   // Validate that lastSeries still exists
@@ -430,12 +441,6 @@ function _initApp() {
   } else {
     showScreen('welcome');
   }
-
-  // Handle #demo URL hash
-  if (demoData && window.location.hash === '#demo') {
-    _switchSeries('__demo__');
-    _setTab('grid');
-  }
 }
 
 // Run on DOM ready
diff --git a/src/tvplotlines/html/parts/shell.html b/src/tvplotlines/html/parts/shell.html
index 34f07dc..f19eb4c 100644
--- a/src/tvplotlines/html/parts/shell.html
+++ b/src/tvplotlines/html/parts/shell.html
@@ -14,13 +14,10 @@
 <!-- Welcome screen -->
 <section id="screen-welcome" class="screen active">
   <div class="welcome-container">
-    <h1>TV Plotlines Viewer</h1>
-    <p>Upload a plotlines JSON file or explore the demo data.</p>
-    <div class="welcome-actions">
-      <button id="btn-demo">Load Demo</button>
-      <label class="upload-label" for="welcome-file-upload">Upload JSON</label>
-      <input type="file" id="welcome-file-upload" accept=".json" hidden>
-    </div>
+    <h1 class="welcome-title">tvplotlines</h1>
+    <p class="welcome-tagline">see the structure of any TV series</p>
+    <button id="btn-play" class="welcome-play">Play me</button>
+    <a id="btn-skip" class="welcome-skip" href="#">Skip &#8594;</a>
   </div>
 </section>
 
diff --git a/src/tvplotlines/html/parts/style.css b/src/tvplotlines/html/parts/style.css
index 4ab42e2..ecc57f5 100644
--- a/src/tvplotlines/html/parts/style.css
+++ b/src/tvplotlines/html/parts/style.css
@@ -13,23 +13,34 @@ body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; b
 .welcome-container {
   display: flex; flex-direction: column; align-items: center; justify-content: center;
   min-height: 100vh; padding: 2rem; text-align: center;
+  background: #fafafa;
+  opacity: 1; transition: opacity 0.4s ease;
 }
-.welcome-container h1 {
-  font-size: 2rem; font-weight: 300; letter-spacing: 0.05em;
-  margin-bottom: 0.5rem; color: #1a1a1a;
+.welcome-container.fade-out { opacity: 0; }
+.welcome-title {
+  font-size: 2.25rem; font-weight: 200; letter-spacing: 0.12em;
+  color: #1a1a1a; margin-bottom: 0.75rem;
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
 }
-.welcome-container p {
-  font-size: 0.95rem; color: #666; margin-bottom: 2rem;
+.welcome-tagline {
+  font-size: 0.9rem; font-weight: 300; color: #999;
+  letter-spacing: 0.06em; margin-bottom: 4rem;
 }
-.welcome-actions { display: flex; gap: 1rem; }
-.welcome-actions button,
-.welcome-actions .upload-label {
-  padding: 0.625rem 1.5rem; border: 1px solid #ddd; border-radius: 6px;
-  background: white; cursor: pointer; font-size: 0.875rem;
-  transition: background 0.15s, border-color 0.15s;
+.welcome-play {
+  padding: 0.65rem 2.5rem; border: 1px solid #ccc; border-radius: 24px;
+  background: transparent; cursor: pointer; font-size: 0.85rem;
+  font-weight: 400; letter-spacing: 0.08em; color: #333;
+  transition: border-color 0.2s, color 0.2s, background 0.2s;
 }
-.welcome-actions button:hover,
-.welcome-actions .upload-label:hover { background: #f0f0f0; }
+.welcome-play:hover {
+  border-color: #888; color: #111; background: rgba(0,0,0,0.02);
+}
+.welcome-skip {
+  display: inline-block; margin-top: 1.5rem;
+  font-size: 0.75rem; color: #bbb; text-decoration: none;
+  letter-spacing: 0.05em; transition: color 0.2s;
+}
+.welcome-skip:hover { color: #888; }
 
 /* ── Page layout ── */
 .page { max-width: 100%; padding: 1rem; }
@@ -204,12 +215,13 @@ html.dark .export-menu button:hover { background: #2a2a2a; }
 :root.dark body { background: #1e1e2e; color: #cdd6f4; }
 :root.dark .sticky-top { background: #1e1e2e; }
 
-:root.dark .welcome-container h1 { color: #cdd6f4; }
-:root.dark .welcome-container p { color: #a6adc8; }
-:root.dark .welcome-actions button,
-:root.dark .welcome-actions .upload-label { background: #313244; color: #cdd6f4; border-color: #45475a; }
-:root.dark .welcome-actions button:hover,
-:root.dark .welcome-actions .upload-label:hover { background: #45475a; }
+:root.dark .welcome-container { background: #11111b; }
+:root.dark .welcome-title { color: #cdd6f4; }
+:root.dark .welcome-tagline { color: #585b70; }
+:root.dark .welcome-play { color: #a6adc8; border-color: #45475a; background: transparent; }
+:root.dark .welcome-play:hover { color: #cdd6f4; border-color: #6c7086; background: rgba(255,255,255,0.03); }
+:root.dark .welcome-skip { color: #45475a; }
+:root.dark .welcome-skip:hover { color: #6c7086; }
 
 :root.dark .toolbar { background: #181825; box-shadow: 0 1px 3px rgba(0,0,0,0.5); }
 :root.dark .toolbar-title { color: #cba6f7; }

From dc18c414de4bee645bab060f7b2dec72032595a9 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Fri, 10 Apr 2026 13:36:53 +0200
Subject: [PATCH 12/24] Add onboarding animation that demos full pipeline on
 real UI

Animated walkthrough plays on actual app screens using Breaking Bad
demo data: LLM settings modal, file upload, pipeline progress,
grid reveal, analytics tour, and export. Ends with real LLM modal
so user can connect their key. Skip link aborts animation cleanly.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/tvplotlines/html/parts/app.js     | 340 +++++++++++++++++++++++++-
 src/tvplotlines/html/parts/shell.html |   2 +-
 src/tvplotlines/html/parts/style.css  |  69 ++++++
 3 files changed, 397 insertions(+), 14 deletions(-)

diff --git a/src/tvplotlines/html/parts/app.js b/src/tvplotlines/html/parts/app.js
index d2f2bb7..c7eb5cf 100644
--- a/src/tvplotlines/html/parts/app.js
+++ b/src/tvplotlines/html/parts/app.js
@@ -313,6 +313,330 @@ function _showLLMSettings() {
   modalOverlay.classList.remove('hidden');
 }
 
+// --- Onboarding animation ---
+
+// Onboarding state — lets us cancel a running animation
+let _onboardingAbort = null;
+
+function _delay(ms) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(resolve, ms);
+    // Attach cancel hook so abort can reject immediately
+    if (_onboardingAbort) {
+      const prev = _onboardingAbort.onAbort;
+      _onboardingAbort.onAbort = () => {
+        clearTimeout(timer);
+        if (prev) prev();
+        reject(new Error('aborted'));
+      };
+    }
+  });
+}
+
+function _showSubtitle(text) {
+  _hideSubtitle();
+  const el = document.createElement('div');
+  el.className = 'onboarding-subtitle';
+  el.id = 'onboarding-subtitle';
+  el.textContent = text;
+  document.body.appendChild(el);
+}
+
+function _hideSubtitle() {
+  const el = document.getElementById('onboarding-subtitle');
+  if (el) el.remove();
+}
+
+async function _animateTyping(element, text, speedMs) {
+  element.value = '';
+  for (const ch of text) {
+    element.value += ch;
+    await _delay(speedMs);
+  }
+}
+
+function _highlightElement(selector) {
+  const el = typeof selector === 'string' ? document.querySelector(selector) : selector;
+  if (!el) return;
+  el.classList.add('onboarding-highlight');
+  setTimeout(() => el.classList.remove('onboarding-highlight'), 1200);
+}
+
+function _createCursor() {
+  const cursor = document.createElement('div');
+  cursor.className = 'onboarding-cursor';
+  cursor.id = 'onboarding-cursor';
+  // Start offscreen
+  cursor.style.left = '-40px';
+  cursor.style.top = '-40px';
+  document.body.appendChild(cursor);
+  return cursor;
+}
+
+function _removeCursor() {
+  const el = document.getElementById('onboarding-cursor');
+  if (el) el.remove();
+}
+
+async function _moveCursorTo(cursor, target) {
+  const el = typeof target === 'string' ? document.querySelector(target) : target;
+  if (!el) return;
+  const rect = el.getBoundingClientRect();
+  cursor.style.left = (rect.left + rect.width / 2) + 'px';
+  cursor.style.top = (rect.top + rect.height / 2) + 'px';
+  await _delay(700);
+}
+
+async function _simulateClick(cursor, target) {
+  await _moveCursorTo(cursor, target);
+  const el = typeof target === 'string' ? document.querySelector(target) : target;
+  if (el) {
+    _highlightElement(el);
+    await _delay(300);
+  }
+}
+
+/**
+ * Gradually reveal grid cells with animation.
+ * Hides all event cards, then reveals them one by one.
+ */
+async function _revealGridGradually() {
+  const cards = document.querySelectorAll('#grid-container .event-card');
+  // Hide all first
+  cards.forEach(card => {
+    card.classList.add('onboarding-cell-hidden');
+  });
+  await _delay(200);
+
+  // Reveal in batches of 3 for speed
+  const batchSize = 3;
+  for (let i = 0; i < cards.length; i += batchSize) {
+    for (let j = i; j < Math.min(i + batchSize, cards.length); j++) {
+      cards[j].classList.remove('onboarding-cell-hidden');
+      cards[j].classList.add('onboarding-cell-reveal');
+    }
+    await _delay(60);
+  }
+}
+
+/**
+ * Main onboarding sequence.
+ * Drives real UI components to demonstrate the full workflow.
+ */
+async function runOnboarding() {
+  // Set up abort controller for skip-during-animation
+  _onboardingAbort = { onAbort: null };
+
+  const cursor = _createCursor();
+
+  try {
+    // Step 1: Welcome screen — show subtitle, then "click" Skip
+    _showSubtitle('This is the welcome screen. Let\'s walk through the full workflow.');
+    await _delay(2500);
+
+    _showSubtitle('First, let\'s configure the LLM connection.');
+    await _simulateClick(cursor, '#btn-skip');
+    await _delay(600);
+
+    // Transition to grid screen (we need it for the toolbar)
+    const demoData = _loadDemoData();
+    if (demoData) _switchSeries('__demo__');
+    _setTab('grid');
+    await _delay(400);
+
+    // Step 2: LLM settings modal
+    _showSubtitle('Click "LLM" to open settings and choose your provider.');
+    await _simulateClick(cursor, '#btn-llm-settings');
+    _showLLMSettings();
+    await _delay(1000);
+
+    // Animate provider selection
+    _showSubtitle('Select Claude as your LLM provider...');
+    const providerSelect = document.getElementById('llm-provider');
+    if (providerSelect) {
+      await _moveCursorTo(cursor, providerSelect);
+      providerSelect.value = 'anthropic';
+      _highlightElement(providerSelect);
+    }
+    await _delay(1200);
+
+    // Animate API key typing
+    _showSubtitle('Type your API key (this is a demo — no real key needed).');
+    const apiKeyInput = document.getElementById('llm-api-key');
+    if (apiKeyInput) {
+      await _moveCursorTo(cursor, apiKeyInput);
+      apiKeyInput.type = 'text';
+      await _animateTyping(apiKeyInput, 'sk-ant-api03-demo...', 50);
+      apiKeyInput.type = 'password';
+    }
+    await _delay(800);
+
+    // Click save
+    _showSubtitle('Save your settings.');
+    await _simulateClick(cursor, '#llm-save-btn');
+    const saveBtn = document.getElementById('llm-save-btn');
+    if (saveBtn) saveBtn.click();
+    await _delay(1200);
+
+    // Close modal
+    const modalOverlay = document.getElementById('modal-overlay');
+    if (modalOverlay) modalOverlay.classList.add('hidden');
+    await _delay(500);
+
+    // Step 3: File upload zone
+    _showSubtitle('Now upload your synopsis files. Click "+ Load" to open the drop zone.');
+    await _simulateClick(cursor, '#btn-load');
+    _showDropZone();
+    await _delay(1000);
+
+    // Simulate file appearing via button
+    _showSubtitle('Choose files — one via the button...');
+    const dropBox = document.querySelector('.drop-zone-box');
+    if (dropBox) {
+      await _moveCursorTo(cursor, '.drop-zone-box label.btn');
+      const chip1 = document.createElement('div');
+      chip1.className = 'onboarding-file-chip';
+      chip1.textContent = 'S01E01.txt';
+      dropBox.appendChild(chip1);
+    }
+    await _delay(1200);
+
+    // Simulate drag-drop file appearing
+    _showSubtitle('...and more via drag & drop.');
+    if (dropBox) {
+      const fileNames = ['S01E02.txt', 'S01E03.txt', 'S01E04.txt', 'S01E05.txt', 'S01E06.txt', 'S01E07.txt'];
+      for (const name of fileNames) {
+        const chip = document.createElement('div');
+        chip.className = 'onboarding-file-chip';
+        chip.textContent = name;
+        dropBox.appendChild(chip);
+        await _delay(150);
+      }
+    }
+    await _delay(1000);
+
+    // Close drop zone
+    _hideDropZone();
+    await _delay(400);
+
+    // Step 4: Pipeline runs — simulate progress
+    _showSubtitle('The pipeline analyzes your synopses in 5 passes.');
+    _showPipelineProgress();
+    await _delay(800);
+
+    const passLabels = [
+      'Pass 1/5: detecting format and story engine...',
+      'Pass 2/5: identifying cast and plotlines...',
+      'Pass 3/5: breaking down episodes...',
+      'Pass 4/5: reviewing structure...',
+      'Pass 5/5: assigning arc functions...',
+    ];
+    for (let i = 0; i < passLabels.length; i++) {
+      _updatePipelineProgress(passLabels[i], i + 1, 5);
+      _showSubtitle(passLabels[i]);
+      await _delay(1200);
+    }
+    _updatePipelineProgress('Done!', 5, 5);
+    await _delay(600);
+    _hidePipelineProgress();
+    await _delay(400);
+
+    // Step 5: Show grid result with gradual reveal
+    _showSubtitle('The grid shows plotlines vs episodes with color-coded events.');
+    _setTab('grid');
+    await _delay(400);
+    await _revealGridGradually();
+    await _delay(2000);
+
+    // Highlight some grid features
+    _showSubtitle('Click any event card to see details. Use filters to focus on specific characters or functions.');
+    _highlightElement('.sticky-top');
+    await _delay(2500);
+
+    // Step 5b: Switch to analytics
+    _showSubtitle('Switch to Analytics for deeper insights.');
+    await _simulateClick(cursor, '#btn-tab-analytics');
+    _setTab('analytics');
+    await _delay(1500);
+
+    // Scroll through analytics sections
+    const sections = document.querySelectorAll('#analytics-container .ana-section');
+    const sectionLabels = [
+      'Season Scorecard — plotline ranks, spans, and arc shapes.',
+      'Arc Map — tension levels across episodes.',
+      'Episode Pulse — event distribution per episode.',
+      'Convergence Moments — where plotlines intersect.',
+      'Character Weight — who drives the story.',
+    ];
+    for (let i = 0; i < Math.min(sections.length, sectionLabels.length); i++) {
+      _showSubtitle(sectionLabels[i]);
+      sections[i].scrollIntoView({ behavior: 'smooth', block: 'center' });
+      _highlightElement(sections[i]);
+      await _delay(2500);
+    }
+
+    // Step 6: Export buttons
+    _showSubtitle('Export your results as JSON, TXT, CSV, or Final Draft.');
+    // Scroll back to top to see toolbar
+    window.scrollTo({ top: 0, behavior: 'smooth' });
+    await _delay(600);
+
+    // Find an export button on analytics screen
+    const exportBtn = document.querySelector('#screen-analytics .btn-export-trigger');
+    if (exportBtn) {
+      await _simulateClick(cursor, exportBtn);
+      _toggleExportMenu(exportBtn);
+      await _delay(2000);
+      // Close the menu
+      const menu = document.getElementById('export-menu');
+      if (menu) menu.classList.add('hidden');
+    }
+    await _delay(500);
+
+    // Step 7: End — switch to grid, show real LLM modal
+    _showSubtitle('That\'s it! Now connect your own LLM to start analyzing.');
+    _setTab('grid');
+    await _delay(1500);
+    _hideSubtitle();
+    _removeCursor();
+
+    Store.markOnboardingSeen();
+    // Show real LLM settings modal so user can enter their key
+    _showLLMSettings();
+
+  } catch (e) {
+    if (e.message === 'aborted') {
+      // User skipped during animation — clean up silently
+    } else {
+      console.error('Onboarding error:', e);
+    }
+  } finally {
+    _hideSubtitle();
+    _removeCursor();
+    _onboardingAbort = null;
+    // Remove any leftover file chips
+    document.querySelectorAll('.onboarding-file-chip').forEach(el => el.remove());
+  }
+}
+
+function _skipOnboarding() {
+  // Abort running onboarding if any
+  if (_onboardingAbort && _onboardingAbort.onAbort) {
+    _onboardingAbort.onAbort();
+  }
+  _hideSubtitle();
+  _removeCursor();
+  _hidePipelineProgress();
+  _hideDropZone();
+  // Close modal if open
+  const modal = document.getElementById('modal-overlay');
+  if (modal) modal.classList.add('hidden');
+
+  Store.markOnboardingSeen();
+  _switchSeries('__demo__');
+  _setTab('grid');
+}
+
 // --- Init ---
 
 function _initApp() {
@@ -368,28 +692,18 @@ function _initApp() {
   if (btnLLM) btnLLM.addEventListener('click', _showLLMSettings);
   if (btnOnboarding) btnOnboarding.addEventListener('click', () => {
     showScreen('welcome');
+    // After showing welcome, let user click Play/Skip again
   });
 
   // Welcome screen buttons
   const btnPlay = document.getElementById('btn-play');
   const btnSkip = document.getElementById('btn-skip');
 
-  function _leaveWelcome() {
-    Store.markOnboardingSeen();
-    const container = document.querySelector('.welcome-container');
-    if (container) container.classList.add('fade-out');
-    // Transition to grid after fade completes
-    setTimeout(() => {
-      _switchSeries('__demo__');
-      _setTab('grid');
-    }, 400);
-  }
-
-  if (btnPlay) btnPlay.addEventListener('click', _leaveWelcome);
+  if (btnPlay) btnPlay.addEventListener('click', runOnboarding);
   if (btnSkip) {
     btnSkip.addEventListener('click', (e) => {
       e.preventDefault();
-      _leaveWelcome();
+      _skipOnboarding();
     });
   }
 
diff --git a/src/tvplotlines/html/parts/shell.html b/src/tvplotlines/html/parts/shell.html
index f19eb4c..dc98113 100644
--- a/src/tvplotlines/html/parts/shell.html
+++ b/src/tvplotlines/html/parts/shell.html
@@ -36,7 +36,7 @@ <h1 class="welcome-title">tvplotlines</h1>
       <button id="btn-load" class="btn-nav" title="Load synopses">+ Load</button>
       <button id="btn-export" class="btn-nav btn-export-trigger" title="Export">Export</button>
       <button id="btn-llm-settings" class="btn-nav" title="LLM Settings">LLM</button>
-      <button id="btn-onboarding" class="btn-nav" title="Show welcome screen">?</button>
+      <button id="btn-onboarding" class="btn-nav" title="Watch onboarding">?</button>
       <button id="btn-dark" class="btn-nav" title="Toggle dark mode">&#9790;</button>
     </div>
   </nav>
diff --git a/src/tvplotlines/html/parts/style.css b/src/tvplotlines/html/parts/style.css
index ecc57f5..23a0f16 100644
--- a/src/tvplotlines/html/parts/style.css
+++ b/src/tvplotlines/html/parts/style.css
@@ -418,6 +418,75 @@ html.dark .export-menu button:hover { background: #2a2a2a; }
 :root.dark .ana-char-bar { background: #89b4fa; color: #1e1e2e; }
 :root.dark .ana-char-dot { background: #89b4fa; }
 
+/* ── Onboarding subtitles ── */
+.onboarding-subtitle {
+  position: fixed; bottom: 2rem; left: 50%; transform: translateX(-50%);
+  background: rgba(0,0,0,0.85); color: #fff; padding: 0.75rem 1.5rem;
+  border-radius: 8px; font-size: 0.9rem; max-width: 600px; text-align: center;
+  z-index: 10000; line-height: 1.5;
+  animation: subtitleFadeIn 0.3s ease-out;
+}
+.onboarding-subtitle.fade-out {
+  opacity: 0; transition: opacity 0.3s ease-in;
+}
+@keyframes subtitleFadeIn { from { opacity: 0; transform: translateX(-50%) translateY(10px); } to { opacity: 1; transform: translateX(-50%) translateY(0); } }
+:root.dark .onboarding-subtitle { background: rgba(30,30,46,0.95); color: #cdd6f4; }
+
+/* ── Onboarding highlight pulse ── */
+.onboarding-highlight {
+  outline: 3px solid #2563eb; outline-offset: 3px;
+  border-radius: 6px;
+  animation: highlightPulse 1.2s ease-in-out;
+}
+@keyframes highlightPulse {
+  0% { outline-color: transparent; }
+  20% { outline-color: #2563eb; }
+  80% { outline-color: #2563eb; }
+  100% { outline-color: transparent; }
+}
+:root.dark .onboarding-highlight { outline-color: #89b4fa; }
+:root.dark .onboarding-highlight { animation-name: highlightPulseDark; }
+@keyframes highlightPulseDark {
+  0% { outline-color: transparent; }
+  20% { outline-color: #89b4fa; }
+  80% { outline-color: #89b4fa; }
+  100% { outline-color: transparent; }
+}
+
+/* ── Onboarding grid cell reveal ── */
+.onboarding-cell-hidden { opacity: 0; }
+.onboarding-cell-reveal {
+  animation: cellReveal 0.3s ease-out forwards;
+}
+@keyframes cellReveal { from { opacity: 0; transform: scale(0.9); } to { opacity: 1; transform: scale(1); } }
+
+/* ── Onboarding fake cursor ── */
+.onboarding-cursor {
+  position: fixed; z-index: 10001; pointer-events: none;
+  width: 20px; height: 20px;
+  transition: left 0.6s cubic-bezier(0.4,0,0.2,1), top 0.6s cubic-bezier(0.4,0,0.2,1);
+}
+.onboarding-cursor::before {
+  content: '';
+  display: block; width: 0; height: 0;
+  border-left: 8px solid #2563eb;
+  border-right: 8px solid transparent;
+  border-bottom: 14px solid transparent;
+  border-top: 0;
+  filter: drop-shadow(1px 1px 2px rgba(0,0,0,0.3));
+}
+:root.dark .onboarding-cursor::before { border-left-color: #89b4fa; }
+
+/* Fake file chip in drop zone during onboarding */
+.onboarding-file-chip {
+  display: inline-block; background: #eff6ff; border: 1px solid #93c5fd;
+  border-radius: 6px; padding: 0.25rem 0.75rem; margin: 0.25rem;
+  font-size: 0.8rem; color: #1e40af;
+  animation: chipDrop 0.4s ease-out;
+}
+@keyframes chipDrop { from { opacity: 0; transform: translateY(-20px); } to { opacity: 1; transform: translateY(0); } }
+:root.dark .onboarding-file-chip { background: #243347; border-color: #89b4fa; color: #89b4fa; }
+
 /* ── Pipeline progress overlay ── */
 .pipeline-progress-overlay {
   position: fixed; inset: 0; z-index: 9999;

From 51f1cdee7740d70c5e7f4d163f783396a884119d Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Wed, 15 Apr 2026 11:02:45 +0200
Subject: [PATCH 13/24] refactor: consolidate hollywood and narratology prompts
 under one system parameter
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Rename prompts_en/ to prompts/hollywood/
- Import 8 narratology prompts (formerly tvplotlines_narratology repo) into prompts/narratology/
- Drop prompts_ru/ entirely — Russian support out of current scope
- Replace lang parameter with system across library: get_plotlines, LLMConfig, CLI
- Narratology pipeline raises NotImplementedError for now; prompts in place for v2
- Copy schema.md into docs/layered-schema.md (base + layers JSON design)
- Update pyproject.toml artifacts, example, tests

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 CHANGELOG.md                                  |   9 +
 docs/layered-schema.md                        | 195 ++++++++++++++++++
 examples/run_pipeline.py                      |  72 +++----
 pyproject.toml                                |   5 +-
 src/tvplotlines/cli.py                        |  14 +-
 src/tvplotlines/llm.py                        |   2 +-
 src/tvplotlines/pass0.py                      |   4 +-
 src/tvplotlines/pass1.py                      |   4 +-
 src/tvplotlines/pass2.py                      |   6 +-
 src/tvplotlines/pass3.py                      |   4 +-
 src/tvplotlines/pass4.py                      |   4 +-
 src/tvplotlines/pipeline.py                   |  10 +-
 src/tvplotlines/prompts/__init__.py           |  57 +++++
 src/tvplotlines/prompts/hollywood/__init__.py |   0
 .../hollywood}/glossary.md                    |   0
 .../hollywood}/pass0.md                       |   0
 .../hollywood}/pass1.md                       |   0
 .../hollywood}/pass2.md                       |   0
 .../hollywood}/pass3.md                       |   0
 .../hollywood}/pass4.md                       |   0
 .../hollywood}/synopses_writer.md             |   0
 .../prompts/narratology/__init__.py           |   0
 .../prompts/narratology/glossary.md           | 105 ++++++++++
 .../prompts/narratology/pass1_context.md      |  51 +++++
 .../prompts/narratology/pass2_fabula.md       |  58 ++++++
 .../prompts/narratology/pass3_actants.md      |  76 +++++++
 .../prompts/narratology/pass4_story.md        |  77 +++++++
 .../prompts/narratology/pass5_arc.md          |  71 +++++++
 .../prompts/narratology/pass6_review.md       |  72 +++++++
 .../prompts/narratology/synopses_writer.md    |  60 ++++++
 src/tvplotlines/prompts_en/__init__.py        |  47 -----
 src/tvplotlines/prompts_ru/__init__.py        |   1 -
 src/tvplotlines/prompts_ru/glossary.md        | 137 ------------
 src/tvplotlines/prompts_ru/pass0.md           |  61 ------
 src/tvplotlines/prompts_ru/pass1.md           | 188 -----------------
 src/tvplotlines/prompts_ru/pass2.md           | 182 ----------------
 src/tvplotlines/prompts_ru/pass3.md           | 185 -----------------
 src/tvplotlines/prompts_ru/pass4.md           |  46 -----
 src/tvplotlines/prompts_ru/synopses_writer.md |  79 -------
 src/tvplotlines/synopses_writer.py            |  17 +-
 tests/test_synopses_writer.py                 |   6 +-
 41 files changed, 913 insertions(+), 992 deletions(-)
 create mode 100644 docs/layered-schema.md
 create mode 100644 src/tvplotlines/prompts/__init__.py
 create mode 100644 src/tvplotlines/prompts/hollywood/__init__.py
 rename src/tvplotlines/{prompts_en => prompts/hollywood}/glossary.md (100%)
 rename src/tvplotlines/{prompts_en => prompts/hollywood}/pass0.md (100%)
 rename src/tvplotlines/{prompts_en => prompts/hollywood}/pass1.md (100%)
 rename src/tvplotlines/{prompts_en => prompts/hollywood}/pass2.md (100%)
 rename src/tvplotlines/{prompts_en => prompts/hollywood}/pass3.md (100%)
 rename src/tvplotlines/{prompts_en => prompts/hollywood}/pass4.md (100%)
 rename src/tvplotlines/{prompts_en => prompts/hollywood}/synopses_writer.md (100%)
 create mode 100644 src/tvplotlines/prompts/narratology/__init__.py
 create mode 100644 src/tvplotlines/prompts/narratology/glossary.md
 create mode 100644 src/tvplotlines/prompts/narratology/pass1_context.md
 create mode 100644 src/tvplotlines/prompts/narratology/pass2_fabula.md
 create mode 100644 src/tvplotlines/prompts/narratology/pass3_actants.md
 create mode 100644 src/tvplotlines/prompts/narratology/pass4_story.md
 create mode 100644 src/tvplotlines/prompts/narratology/pass5_arc.md
 create mode 100644 src/tvplotlines/prompts/narratology/pass6_review.md
 create mode 100644 src/tvplotlines/prompts/narratology/synopses_writer.md
 delete mode 100644 src/tvplotlines/prompts_en/__init__.py
 delete mode 100644 src/tvplotlines/prompts_ru/__init__.py
 delete mode 100644 src/tvplotlines/prompts_ru/glossary.md
 delete mode 100644 src/tvplotlines/prompts_ru/pass0.md
 delete mode 100644 src/tvplotlines/prompts_ru/pass1.md
 delete mode 100644 src/tvplotlines/prompts_ru/pass2.md
 delete mode 100644 src/tvplotlines/prompts_ru/pass3.md
 delete mode 100644 src/tvplotlines/prompts_ru/pass4.md
 delete mode 100644 src/tvplotlines/prompts_ru/synopses_writer.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ff50e30..7037be9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,15 @@
 
 ## Unreleased
 
+### Changed
+- **Prompt layout**: `prompts_en/` → `prompts/hollywood/`. Added `prompts/narratology/` from the former sister project, bundling eight structuralist prompts (context, fabula, actants, story, arc, review, synopses_writer, glossary). `docs/layered-schema.md` documents the shared `base + layers` JSON.
+- **Library API**: `get_plotlines(..., lang=)` replaced by `get_plotlines(..., system=)` (values: `"hollywood"` default, `"narratology"`). `LLMConfig.lang` → `LLMConfig.system`. CLI: `tvplotlines run --lang` → `--system`; `write-synopses --system` added.
+- Narratology pipeline is not yet runnable — `system="narratology"` raises `NotImplementedError` with a clear message. Prompts are in place; runners come in v2.
+
+### Removed
+- **Russian prompts** (`prompts_ru/`) — out of scope. Will be reintroduced once both analysis systems stabilise in English.
+- Sister repo `tvplotlines_narratology/` merged into this repo under `src/tvplotlines/prompts/narratology/`.
+
 ### Added
 - **Pass 4: arc functions** (`plot_fn`) — each event gets a season-arc role alongside its episode function. Pass 4 runs per-plotline, sees episode functions as context.
 - **Reviewed rank**: Pass 3 assigns its own ranks. When they differ from `computed_rank`, stored as `reviewed_rank` — user sees both.
diff --git a/docs/layered-schema.md b/docs/layered-schema.md
new file mode 100644
index 0000000..ccad4cc
--- /dev/null
+++ b/docs/layered-schema.md
@@ -0,0 +1,195 @@
+# Layered JSON schema
+
+The pipeline output is one JSON file per show+season. It contains a **base** that any narrative system shares, and one or more **layers** that add system-specific analysis on top.
+
+A single file can hold multiple layers — the same show analyzed through Hollywood screenwriting, structuralist narratology (Bal/Greimas/Bremond), Japanese kishōtenketsu, and so on. The HTML viewer picks a layer; the base is always visible.
+
+## Top-level
+
+```json
+{
+  "show": "Breaking Bad",
+  "season": 1,
+  "base": { ... },
+  "layers": [ { ... }, { ... } ]
+}
+```
+
+## base
+
+Universal information, layer-agnostic. Every narrative system needs these.
+
+```json
+{
+  "context": {
+    "format": "serial",
+    "is_anthology": false,
+    "genre": "crime drama"
+  },
+  "cast": [
+    {"id": "walt", "name": "Walter White", "kind": "main"},
+    {"id": "guest:native-family", "name": "Native American family", "kind": "guest"}
+  ],
+  "episodes": [
+    {
+      "id": "S01E01",
+      "synopsis": "..."
+    }
+  ],
+  "events": [
+    {
+      "id": "S01E01#01",
+      "episode": "S01E01",
+      "description": "Walt collapses at the car wash",
+      "characters": ["walt"]
+    }
+  ],
+  "plotlines": [
+    {
+      "id": "empire",
+      "name": "Walt: Empire"
+    }
+  ],
+  "assignments": {
+    "S01E01#01": {"plotline_id": "cancer", "also_affects": []}
+  }
+}
+```
+
+### Fields
+
+- **`context`** — format (procedural/serial/hybrid/ensemble), is_anthology, genre. Nothing system-specific.
+- **`cast`** — every character with a stable id. `kind` is `main` or `guest`.
+- **`episodes`** — each episode's id + synopsis text.
+- **`events`** — every event has a stable id (`{episode}#{index}`), an episode reference, a description, and the characters involved. **No functions, no directions, no drive/texture — those are in layers.**
+- **`plotlines`** — generic groupings with id and name. **No hero, no actants, no rank — those are in layers.** Each plotline just exists as a container.
+- **`assignments`** — map from event id to its plotline plus any secondary plotlines it also affects. This is the only base-level structure because it's a factual claim (event X belongs to plotline Y), not an interpretation.
+
+## layers
+
+Each layer is a system-specific analysis. Layers reference base ids (events, plotlines, episodes, cast) but add their own tags.
+
+```json
+{
+  "name": "greimas-bal",
+  "version": "1.0",
+  "description": "Structuralist narratology: actant model, Bremond cycles, Bal focalization",
+  "context": { ... },
+  "plotlines": { "empire": { ... } },
+  "events": { "S01E01#01": { ... } },
+  "episodes": { "S01E01": { ... } },
+  "verdicts": [ ... ]
+}
+```
+
+### Required fields
+
+- **`name`** — stable identifier of the layer (`hollywood`, `greimas-bal`, `kishotenketsu`, `chinese-qicheng`, `propp`, etc.)
+- **`version`** — schema version of the layer
+
+### Optional fields
+
+Every layer defines its own schema for these. What's below is shape, not content.
+
+- **`context`** — extra show-level info this layer adds (e.g., `breach`, `story_schema`, `protagonists`)
+- **`plotlines`** — map from plotline id to layer-specific info (e.g., `actants`, `hero/goal/obstacle/stakes`, `rank`, `type`, `nature`, `mre`)
+- **`events`** — map from event id to layer-specific tags (e.g., `function`, `direction`, `kind`, `arc_function`, `arc_direction`)
+- **`episodes`** — map from episode id to layer-specific info (e.g., `theme`, `act` for kishotenketsu)
+- **`verdicts`** — structural corrections issued by the layer's review pass
+
+## Layer specifications
+
+### `greimas-bal` (our main layer)
+
+Version 1.0.
+
+**context**:
+```json
+{
+  "breach": "Teachers don't cook meth.",
+  "story_schema": "...",
+  "protagonists": ["Walter White"]
+}
+```
+
+**plotlines**: map from id → {actants, type, nature, confidence, rank, mre}
+
+```json
+{
+  "empire": {
+    "actants": {
+      "subject": "walt",
+      "object": "cook and sell meth",
+      "power": "Walt's pride and cancer deadline",
+      "receiver": "walt",
+      "helpers": ["jesse"],
+      "opponents": ["krazy-8", "emilio", "tuco"]
+    },
+    "type": "serialized",
+    "nature": "character-led",
+    "confidence": "solid",
+    "rank": "A",
+    "mre": {
+      "event_id": "S01E03#19",
+      "why": "The first time Walt kills with his own hands..."
+    }
+  }
+}
+```
+
+**events**: map from event id → {function, direction, arc_function, arc_direction, kind}
+
+```json
+{
+  "S01E03#19": {
+    "function": "climax",
+    "direction": "improvement",
+    "arc_function": "turning_point",
+    "arc_direction": "deterioration",
+    "kind": "drive"
+  }
+}
+```
+
+Enums: see `prompts_en/glossary.md` for `function` (8 values), `direction` (3), `kind` (2).
+
+**episodes**: map from episode id → {theme}
+
+### `hollywood` (for backward compatibility with tvplotlines)
+
+Version 1.0.
+
+**context**:
+```json
+{"story_engine": "..."}
+```
+
+**plotlines**: map from id → {hero, goal, obstacle, stakes, type, nature, confidence, rank}
+
+**events**: map from event id → {function, arc_function, interactions}
+
+Enum: `function` has 7 values (no `recognition`). `interactions` include `dramatic_irony` etc.
+
+### `kishotenketsu` (future)
+
+Version 1.0.
+
+**events**: map from event id → {act: "ki" | "sho" | "ten" | "ketsu"}
+
+No plotlines-specific fields — kishōtenketsu does not analyze plotlines as separate programs. Four-act flow across the whole narrative.
+
+## Compatibility rules
+
+- **Base is authoritative**: all layers reference base ids. If an event id doesn't exist in base, any reference to it is invalid.
+- **Layers are independent**: removing a layer does not invalidate other layers. Base plus any subset of layers is always a valid file.
+- **Graceful degradation**: the viewer shows whatever layer is selected. If a layer lacks a field the viewer expects, the viewer shows a placeholder.
+- **Multiple layers per file**: a single file can contain many layers. Useful for comparative study.
+
+## Converting old tvplotlines output
+
+Old `tvplotlines` JSON has a flat structure with Hollywood-only fields. Converter:
+
+1. Extract `context`, `cast`, `episodes`, events (flatten per-episode `events` lists), plotlines, and assignments → `base`.
+2. Extract Hollywood fields (hero/goal/obstacle/stakes, function, interactions, rank, etc.) → `layers[hollywood]`.
+
+Converter preserves all data. No lossy transformations.
diff --git a/examples/run_pipeline.py b/examples/run_pipeline.py
index be2fbfc..217c971 100644
--- a/examples/run_pipeline.py
+++ b/examples/run_pipeline.py
@@ -1,36 +1,36 @@
-"""Example: run tvplotlines pipeline on synopsis files and save result.
-
-Equivalent CLI command:
-    tvplotlines run synopses/SP_S01E*.txt --show "Слово пацана" --season 1 --lang ru -o result.json
-"""
-
-import json
-from pathlib import Path
-
-from tvplotlines import get_plotlines
-
-SYNOPSES_DIR = Path("synopses")
-
-
-def run(show: str, prefix: str, num_episodes: int, lang: str = "en") -> None:
-    episodes = {}
-    for i in range(1, num_episodes + 1):
-        episode_id = f"S01E{i:02d}"
-        path = SYNOPSES_DIR / f"{prefix}_{episode_id}.txt"
-        episodes[episode_id] = path.read_text(encoding="utf-8")
-
-    result = get_plotlines(show=show, season=1, episodes=episodes, lang=lang)
-
-    output = Path(f"{prefix.lower()}_s01_result.json")
-    output.write_text(
-        json.dumps(result.to_dict(), ensure_ascii=False, indent=2),
-        encoding="utf-8",
-    )
-
-    print(f"{show}: {len(result.plotlines)} plotlines, {len(result.cast)} cast → {output}")
-    for s in result.plotlines:
-        print(f"  [{s.rank}] {s.name} (hero={s.hero})")
-
-
-if __name__ == "__main__":
-    run("Слово пацана", "SP", 8, lang="ru")
+"""Example: run tvplotlines pipeline on synopsis files and save result.
+
+Equivalent CLI command:
+    tvplotlines run synopses/BB_S01E*.txt --show "Breaking Bad" --season 1 -o result.json
+"""
+
+import json
+from pathlib import Path
+
+from tvplotlines import get_plotlines
+
+SYNOPSES_DIR = Path("synopses")
+
+
+def run(show: str, prefix: str, num_episodes: int, system: str = "hollywood") -> None:
+    episodes = {}
+    for i in range(1, num_episodes + 1):
+        episode_id = f"S01E{i:02d}"
+        path = SYNOPSES_DIR / f"{prefix}_{episode_id}.txt"
+        episodes[episode_id] = path.read_text(encoding="utf-8")
+
+    result = get_plotlines(show=show, season=1, episodes=episodes, system=system)
+
+    output = Path(f"{prefix.lower()}_s01_result.json")
+    output.write_text(
+        json.dumps(result.to_dict(), ensure_ascii=False, indent=2),
+        encoding="utf-8",
+    )
+
+    print(f"{show}: {len(result.plotlines)} plotlines, {len(result.cast)} cast → {output}")
+    for s in result.plotlines:
+        print(f"  [{s.rank}] {s.name} (hero={s.hero})")
+
+
+if __name__ == "__main__":
+    run("Breaking Bad", "BB", 7)
diff --git a/pyproject.toml b/pyproject.toml
index 8cdfc30..2005ace 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -60,7 +60,10 @@ tvplotlines = "tvplotlines.cli:main"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/tvplotlines"]
-artifacts = ["src/tvplotlines/prompts_en/*.md"]
+artifacts = [
+    "src/tvplotlines/prompts/hollywood/*.md",
+    "src/tvplotlines/prompts/narratology/*.md",
+]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
diff --git a/src/tvplotlines/cli.py b/src/tvplotlines/cli.py
index e0f9bce..f064067 100644
--- a/src/tvplotlines/cli.py
+++ b/src/tvplotlines/cli.py
@@ -109,7 +109,7 @@ def _run(args: argparse.Namespace) -> None:
 
         config = LLMConfig(
             provider=args.provider, model=args.model,
-            base_url=args.base_url, lang=args.lang,
+            base_url=args.base_url, system=args.system,
         )
         episode_pairs = [(eid, episodes[eid]) for eid in sorted(episodes)]
 
@@ -191,7 +191,7 @@ def _run(args: argparse.Namespace) -> None:
         show=show,
         season=season,
         episodes=episodes,
-        lang=args.lang,
+        system=args.system,
         llm_provider=args.provider,
         model=args.model,
         base_url=args.base_url,
@@ -302,6 +302,7 @@ def _write_synopses(args: argparse.Namespace) -> None:
         base_url=args.base_url,
         mode=args.mode,
         use_glossary=not args.no_glossary,
+        system=args.system,
     )
 
 
@@ -320,7 +321,10 @@ def main() -> None:
     )
     run_parser.add_argument("--show", default=None, help="Series title (auto-detected from directory name)")
     run_parser.add_argument("--season", type=int, default=None, help="Season number (auto-detected from filenames)")
-    run_parser.add_argument("--lang", default="en", help="Language: en or ru (default: en)")
+    run_parser.add_argument(
+        "--system", default="hollywood", choices=["hollywood", "narratology"],
+        help="Analysis system: hollywood (default) or narratology",
+    )
     run_parser.add_argument("--output", "-o", type=Path, help="Output JSON path")
     run_parser.add_argument("--provider", default="anthropic",
                             help="LLM provider: anthropic, openai, ollama, deepseek, groq, or any OpenAI-compatible")
@@ -366,6 +370,10 @@ def main() -> None:
                            choices=["procedural", "serial", "hybrid", "ensemble"],
                            help="Show format hint for beat counts (auto-detected if omitted)")
     ws_parser.add_argument("--lang", default="en", help="Wikipedia language (default: en)")
+    ws_parser.add_argument(
+        "--system", default="hollywood", choices=["hollywood", "narratology"],
+        help="Analysis system whose synopses prompt to use (default: hollywood)",
+    )
     ws_parser.add_argument("--dry-run", action="store_true",
                            help="Fetch and parse only, show episodes without calling LLM")
     ws_parser.add_argument("--provider", default="anthropic",
diff --git a/src/tvplotlines/llm.py b/src/tvplotlines/llm.py
index fe21a3a..b18fc34 100644
--- a/src/tvplotlines/llm.py
+++ b/src/tvplotlines/llm.py
@@ -95,7 +95,7 @@ class LLMConfig:
 
     provider: str = "anthropic"  # "anthropic" | "openai" | any OpenAI-compatible
     model: str | None = None  # None = provider default
-    lang: str = "en"  # prompt language (only "en" currently supported)
+    system: str = "hollywood"  # analysis system — "hollywood" | "narratology"
     base_url: str | None = None  # Override API endpoint (for DeepSeek, Ollama, etc.)
     api_key: str | None = None  # Override API key (None = use env var)
     timeout: float = 120.0  # Request timeout in seconds
diff --git a/src/tvplotlines/pass0.py b/src/tvplotlines/pass0.py
index 1b4f81c..8d97cd6 100644
--- a/src/tvplotlines/pass0.py
+++ b/src/tvplotlines/pass0.py
@@ -10,7 +10,7 @@
 
 from tvplotlines.llm import LLMConfig, call_llm
 from tvplotlines.models import SeriesContext
-from tvplotlines.prompts_en import load_prompt
+from tvplotlines.prompts import load_prompt
 
 _VALID_FORMATS = {"procedural", "serial", "hybrid", "ensemble"}
 
@@ -50,7 +50,7 @@ def detect_context(
         data["suggested_plotlines"] = suggested_plotlines
     user_message = json.dumps(data, ensure_ascii=False)
 
-    system_prompt = load_prompt("pass0", lang=config.lang)
+    system_prompt = load_prompt("pass0", system=config.system)
     data = call_llm(system_prompt, user_message, config, validator=_validate)
 
     # Backward compat: old LLM output may have is_ensemble as separate flag
diff --git a/src/tvplotlines/pass1.py b/src/tvplotlines/pass1.py
index 39cb8be..63f4579 100644
--- a/src/tvplotlines/pass1.py
+++ b/src/tvplotlines/pass1.py
@@ -12,7 +12,7 @@
 
 from tvplotlines.llm import LLMConfig, call_llm, call_llm_parallel
 from tvplotlines.models import CastMember, Plotline, SeriesContext
-from tvplotlines.prompts_en import load_prompt
+from tvplotlines.prompts import load_prompt
 
 logger = logging.getLogger(__name__)
 
@@ -124,7 +124,7 @@ def extract_plotlines(
         suggested_plotlines=suggested_plotlines,
     )
 
-    system_prompt = load_prompt("pass1", lang=config.lang)
+    system_prompt = load_prompt("pass1", system=config.system)
 
     def _full_validate(data: dict) -> None:
         """Parse and validate in one step for retry support."""
diff --git a/src/tvplotlines/pass2.py b/src/tvplotlines/pass2.py
index ecd8047..cbf7790 100644
--- a/src/tvplotlines/pass2.py
+++ b/src/tvplotlines/pass2.py
@@ -17,7 +17,7 @@
     Plotline,
     SeriesContext,
 )
-from tvplotlines.prompts_en import load_prompt
+from tvplotlines.prompts import load_prompt
 
 _VALID_FUNCTIONS = {
     "setup", "inciting_incident", "escalation", "turning_point",
@@ -85,7 +85,7 @@ def assign_events(
         ensure_ascii=False,
     )
 
-    system_prompt = load_prompt("pass2", lang=config.lang)
+    system_prompt = load_prompt("pass2", system=config.system)
 
     def _full_validate(data: dict) -> None:
         bd = _parse_breakdown(data, episode_id)
@@ -109,7 +109,7 @@ def _prepare_bulk(
     config: LLMConfig,
 ) -> tuple[str, list[str], list[str], list]:
     """Prepare shared data for parallel/batch Pass 2 calls."""
-    system_prompt = load_prompt("pass2", lang=config.lang)
+    system_prompt = load_prompt("pass2", system=config.system)
 
     user_messages = []
     episode_ids = []
diff --git a/src/tvplotlines/pass3.py b/src/tvplotlines/pass3.py
index 3111e11..aedfd85 100644
--- a/src/tvplotlines/pass3.py
+++ b/src/tvplotlines/pass3.py
@@ -17,7 +17,7 @@
     Verdict,
 )
 from tvplotlines.postprocess import compute_weight
-from tvplotlines.prompts_en import load_prompt
+from tvplotlines.prompts import load_prompt
 
 _VALID_ACTIONS = {"MERGE", "REASSIGN", "CREATE", "DROP", "REFUNCTION"}
 _VALID_FUNCTIONS = {
@@ -116,7 +116,7 @@ def review_plotlines(
 
     user_message = json.dumps(payload, ensure_ascii=False)
 
-    system_prompt = load_prompt("pass3", lang=config.lang)
+    system_prompt = load_prompt("pass3", system=config.system)
 
     plotline_ids = {p.id for p in plotlines}
 
diff --git a/src/tvplotlines/pass4.py b/src/tvplotlines/pass4.py
index b01b67d..6f28dd2 100644
--- a/src/tvplotlines/pass4.py
+++ b/src/tvplotlines/pass4.py
@@ -16,7 +16,7 @@
     Plotline,
     SeriesContext,
 )
-from tvplotlines.prompts_en import load_prompt
+from tvplotlines.prompts import load_prompt
 
 logger = logging.getLogger(__name__)
 
@@ -43,7 +43,7 @@ def assign_arc_functions(
     if config is None:
         config = LLMConfig()
 
-    system_prompt = load_prompt("pass4", lang=config.lang)
+    system_prompt = load_prompt("pass4", system=config.system)
     plotline_ids = {p.id for p in plotlines}
     name_to_id = {p.name: p.id for p in plotlines}
     name_to_id.update({p.id: p.id for p in plotlines})
diff --git a/src/tvplotlines/pipeline.py b/src/tvplotlines/pipeline.py
index 6be6b01..6b079d3 100644
--- a/src/tvplotlines/pipeline.py
+++ b/src/tvplotlines/pipeline.py
@@ -61,7 +61,7 @@ def get_plotlines(
     llm_provider: str = "anthropic",
     model: str | None = None,
     base_url: str | None = None,
-    lang: str = "en",
+    system: str = "hollywood",
     skip_review: bool = False,
     pass2_mode: str = "batch",
     batch_id: str | None = None,
@@ -97,7 +97,13 @@ def get_plotlines(
     Returns:
         TVPlotlinesResult with context, cast, plotlines, and episode breakdowns.
     """
-    config = LLMConfig(provider=llm_provider, model=model, base_url=base_url, lang=lang)
+    if system == "narratology":
+        raise NotImplementedError(
+            "Narratology pipeline is not yet runnable — prompts are in place at "
+            "src/tvplotlines/prompts/narratology/ and will be wired in v2. "
+            "Use system='hollywood' for now."
+        )
+    config = LLMConfig(provider=llm_provider, model=model, base_url=base_url, system=system)
 
     # Validate episode keys and convert to sorted (id, text) pairs
     season_prefix = f"S{season:02d}"
diff --git a/src/tvplotlines/prompts/__init__.py b/src/tvplotlines/prompts/__init__.py
new file mode 100644
index 0000000..5b033f3
--- /dev/null
+++ b/src/tvplotlines/prompts/__init__.py
@@ -0,0 +1,57 @@
+"""Prompt templates for each pipeline pass.
+
+Prompts live as .md files under one of two analysis systems:
+
+- `hollywood/` — screenwriting model (story DNA, Freytag functions).
+  Pipeline stages: pass0, pass1, pass2, pass3, pass4, synopses_writer.
+- `narratology/` — structuralist narratology (Bal/Todorov/Greimas/Bremond).
+  Pipeline stages: pass1_context, pass2_fabula, pass3_actants,
+  pass4_story, pass5_arc, pass6_review, synopses_writer.
+
+The `system` argument picks the set. A shared `glossary.md` lives under
+each system's folder and is substituted into `{GLOSSARY}` placeholders.
+"""
+
+from importlib import resources
+
+SYSTEMS = ("hollywood", "narratology")
+
+_glossary_cache: dict[str, str] = {}
+
+
+def _package_for(system: str) -> str:
+    if system not in SYSTEMS:
+        raise ValueError(
+            f"Unsupported system: {system!r}. Expected one of {list(SYSTEMS)}"
+        )
+    return f"tvplotlines.prompts.{system}"
+
+
+def _load_glossary(system: str) -> str:
+    if system not in _glossary_cache:
+        package = _package_for(system)
+        _glossary_cache[system] = (
+            resources.files(package).joinpath("glossary.md").read_text(encoding="utf-8")
+        )
+    return _glossary_cache[system]
+
+
+def load_prompt(pass_name: str, system: str = "hollywood") -> str:
+    """Load a prompt template by pass name and analysis system.
+
+    If the prompt contains `{GLOSSARY}`, it is replaced with the glossary
+    from the same system.
+
+    Args:
+        pass_name: Pass identifier — see module docstring for valid values.
+        system: "hollywood" (default) or "narratology".
+
+    Returns:
+        Prompt text (markdown).
+    """
+    package = _package_for(system)
+    filename = f"{pass_name}.md"
+    text = resources.files(package).joinpath(filename).read_text(encoding="utf-8")
+    if "{GLOSSARY}" in text:
+        text = text.replace("{GLOSSARY}", _load_glossary(system))
+    return text
diff --git a/src/tvplotlines/prompts/hollywood/__init__.py b/src/tvplotlines/prompts/hollywood/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/src/tvplotlines/prompts_en/glossary.md b/src/tvplotlines/prompts/hollywood/glossary.md
similarity index 100%
rename from src/tvplotlines/prompts_en/glossary.md
rename to src/tvplotlines/prompts/hollywood/glossary.md
diff --git a/src/tvplotlines/prompts_en/pass0.md b/src/tvplotlines/prompts/hollywood/pass0.md
similarity index 100%
rename from src/tvplotlines/prompts_en/pass0.md
rename to src/tvplotlines/prompts/hollywood/pass0.md
diff --git a/src/tvplotlines/prompts_en/pass1.md b/src/tvplotlines/prompts/hollywood/pass1.md
similarity index 100%
rename from src/tvplotlines/prompts_en/pass1.md
rename to src/tvplotlines/prompts/hollywood/pass1.md
diff --git a/src/tvplotlines/prompts_en/pass2.md b/src/tvplotlines/prompts/hollywood/pass2.md
similarity index 100%
rename from src/tvplotlines/prompts_en/pass2.md
rename to src/tvplotlines/prompts/hollywood/pass2.md
diff --git a/src/tvplotlines/prompts_en/pass3.md b/src/tvplotlines/prompts/hollywood/pass3.md
similarity index 100%
rename from src/tvplotlines/prompts_en/pass3.md
rename to src/tvplotlines/prompts/hollywood/pass3.md
diff --git a/src/tvplotlines/prompts_en/pass4.md b/src/tvplotlines/prompts/hollywood/pass4.md
similarity index 100%
rename from src/tvplotlines/prompts_en/pass4.md
rename to src/tvplotlines/prompts/hollywood/pass4.md
diff --git a/src/tvplotlines/prompts_en/synopses_writer.md b/src/tvplotlines/prompts/hollywood/synopses_writer.md
similarity index 100%
rename from src/tvplotlines/prompts_en/synopses_writer.md
rename to src/tvplotlines/prompts/hollywood/synopses_writer.md
diff --git a/src/tvplotlines/prompts/narratology/__init__.py b/src/tvplotlines/prompts/narratology/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/src/tvplotlines/prompts/narratology/glossary.md b/src/tvplotlines/prompts/narratology/glossary.md
new file mode 100644
index 0000000..2d09045
--- /dev/null
+++ b/src/tvplotlines/prompts/narratology/glossary.md
@@ -0,0 +1,105 @@
+## event
+
+A transition from one state to another. The change of state is what matters, not the action itself. "John falls ill" is an event; "John is ill" is not.
+
+Label every event with its kind:
+
+- **drive** — moves the plot. If removed, the plotline's outcome would change. Walt strangles Krazy-8.
+- **texture** — atmosphere, character beat, comic relief. If removed, the plot still works. The Native girl brings a mask to the DEA office.
+
+## plotline
+
+Someone wants something and chases it. The chain of events that come from the chase is the plotline.
+
+For each plotline, identify:
+
+- **who chases** — the character driving the plotline
+- **what they chase** — what they want. Can be a thing (a person, money), a state (independence, safety), or knowledge (who killed her)
+- **what stands in the way** — usually people who block them
+- **who helps them** — anyone who supports the chase
+- **what makes it possible or impossible** — the bigger force behind it all. Often abstract: an institution, a deadline, the character's own flaw, fate. Sometimes nothing identifiable
+- **who wins if it works** — usually the same person who chases, but not always
+
+**A separate plotline rule**: if a character has their own thing they're chasing — not just blocking the main character but going after their own goal — they get their own plotline. Test: if you removed the main character from the show, would this person still be doing things? If yes, separate plotline.
+
+Classifications:
+- `type`: `case_of_the_week` | `serialized` | `runner`
+- `nature`: `plot-led` | `character-led` | `theme-led`
+- `confidence`: `solid` | `partial` | `inferred`
+
+## function
+
+A plotline has a recognizable shape: it starts somewhere, builds, peaks, and ends. Each event sits in one of those moments. The function tags which moment.
+
+For every event in a plotline, label its function:
+
+| function            | what it does in the plotline                                                                                                                                                                                                                                                                                                     |
+| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `setup`             | Establishes the starting situation. The world before the story kicks in                                                                                                                                                                                                                                                          |
+| `inciting_incident` | The thing that breaks the starting situation. **Once per plotline across the whole season** — typically in the first episode                                                                                                                                                                                                     |
+| `recognition`       | The character realizes what happened and decides to act. Only use when this is a separate moment from the inciting incident — e.g., Walt's cancer diagnosis is the inciting incident; deciding to cook meth is the recognition. Most plotlines don't need this — skip it when the disruption and the decision are the same event |
+| `escalation`        | Stakes rise. Can happen many times                                                                                                                                                                                                                                                                                               |
+| `turning_point`     | The direction of the plotline shifts — what looked like a win turns out to be a loss, or vice versa                                                                                                                                                                                                                              |
+| `crisis`            | The worst moment. The character faces what they were most afraid of                                                                                                                                                                                                                                                              |
+| `climax`            | The outcome locks in. After this, things can't be undone                                                                                                                                                                                                                                                                         |
+| `resolution`        | The aftermath. A new normal — different from the starting situation                                                                                                                                                                                                                                                              |
+
+Each event gets two function labels:
+
+- **episode function** — where the event sits in the arc *of this episode*
+- **season function** — where the event sits in the arc *of the whole season*
+
+The two often differ. An event that's the climax of episode 3 might just be an escalation in the season-long story — the plotline is still building.
+
+**Exception**: `inciting_incident` only exists at the season level. A plotline has exactly one inciting incident across the whole season — usually in the early episodes. At the episode level, use `setup` or `escalation` instead.
+
+## direction
+
+Function tells you where an event sits in the plotline's shape. Direction tells you which way it pushes the character — toward what they want, or away from it.
+
+For every event, label its direction from the perspective of the character chasing the goal:
+
+- **improvement** — moves the character closer to what they want, or weakens what blocks them
+- **deterioration** — moves them further from what they want, costs them something, hits them with a setback
+- **neutral** — gives information without clearly helping or hurting
+
+Direction is independent of function. A `setup` can be a `deterioration` (Walt's cancer diagnosis sets up the show, but it's a hit). An `escalation` can be an `improvement` (Walt's first successful cook raises the stakes, and it works in his favor for the Empire plotline).
+
+The same event can push one plotline up and another down. Walt's first cook is `improvement` for the Empire plotline (he's becoming Heisenberg) and `deterioration` for the Family plotline (he's drifting from Skyler). When this happens, list the secondary plotlines in `also_affects`.
+
+Like function, direction has two levels:
+
+- **episode direction** — which way the event pushes within this episode
+- **season direction** — which way the event pushes across the whole season
+
+The two can differ. Walt killing Krazy-8 looks like an `improvement` in the episode (he survived) and a `deterioration` in the season (he crossed a moral line he can't uncross).
+
+## interaction
+
+`thematic_rhyme` — same theme, different angles
+`convergence` — characters or conflicts physically intersect
+`threat` — viewer knows, character doesn't (= dramatic irony)
+`riddle` — neither knows (mystery)
+`secret` — character knows, viewer doesn't
+
+## breach
+
+The canonical expectation the show violates. One sentence. Examples: "teachers don't cook meth", "spies are competent", "therapy is confidential".
+
+## MRE
+
+Most Reportable Event — the one event in a plotline that makes it worth telling. Often the climax, not always.
+
+## verdict
+
+The pipeline makes mistakes in earlier passes — wrong plotline boundaries, events assigned to the wrong plotline, functions that don't fit. The final review pass looks at the whole season at once and fixes them by issuing verdicts.
+
+A verdict is one structural correction. There are five kinds:
+
+| verdict | when to use |
+|---|---|
+| `MERGE` | Two plotlines turn out to be the same plotline (same chase, same character). Combine them into one |
+| `DROP` | A plotline doesn't hold up — too few events, no real chase. Remove it; redistribute its events to other plotlines |
+| `CREATE` | A group of events wasn't assigned to any plotline, but together they form one. Bundle them into a new plotline |
+| `REASSIGN` | A single event was put in the wrong plotline. Move it to the right one |
+| `REFUNCTION` | An event's function label is wrong. Change it (e.g., `escalation` → `crisis`) |
diff --git a/src/tvplotlines/prompts/narratology/pass1_context.md b/src/tvplotlines/prompts/narratology/pass1_context.md
new file mode 100644
index 0000000..905ad32
--- /dev/null
+++ b/src/tvplotlines/prompts/narratology/pass1_context.md
@@ -0,0 +1,51 @@
+# TASK
+
+Read the first three episode synopses of a TV show and produce show-level context.
+
+# INPUT
+
+Show title, season number, and synopses for the first 3 episodes.
+
+# WHAT TO PRODUCE
+
+```json
+{
+  "show": "Breaking Bad",
+  "season": 1,
+  "format": "serial",
+  "is_anthology": false,
+  "protagonists": ["Walter White"],
+  "story_schema": "A high school chemistry teacher diagnosed with lung cancer cooks meth to secure his family's future.",
+  "breach": "Teachers don't cook meth.",
+  "genre": "crime drama",
+  "reasoning": "Episodes continue each other directly; one clear protagonist (Walt); no case-of-the-week."
+}
+```
+
+# FIELDS
+
+- **format** — `procedural` (each episode mainly a standalone case + some minor season arcs), `serial` (episodes continue each other, one protagonist), `hybrid` (case-of-the-week + serial arcs both significant), `ensemble` (serial-like, but several protagonists)
+- **is_anthology** — true if seasons are independent (new cast, new story each season). True Detective, Fargo
+- **protagonists** — list of the show's main characters by name (not ID — IDs come later). Empty list for true anthology where each season has new protagonists
+- **story_schema** — one-sentence logline. The repeating dramatic mechanism. Focus on the verbs — what are characters doing each week. This is the mental template the viewer holds in mind to understand and anticipate each episode
+- **breach** — the canonical expectation the show violates. One sentence. "Teachers don't cook meth", "Spies are competent", "Therapy is confidential"
+- **genre** — free text
+- **reasoning** — one or two sentences supporting the format/anthology call
+
+# RULES
+
+- Base classification on the synopses you receive, not on prior knowledge of the show
+- Diagnostic for format:
+  - E01 and E02 have different cases → `procedural` or `hybrid`
+  - E02 continues E01's conflict without closing it → `serial` or `ensemble`
+  - serial vs ensemble: can you name THE main character? If not → `ensemble`
+- Don't default to `serial` because character arcs exist — `hybrid` means BOTH case-of-the-week AND serial arcs are significant
+- **Choosing protagonists**: a protagonist is the character whose decisions and POV drive the show as a whole. Tests:
+  1. Whose decisions push the show forward?
+  2. Whose POV does the show favor — who do we follow when they're in a scene?
+  3. Whose absence would change what the show is about?
+  Serial format → usually one protagonist. Ensemble → 2–5 (Game of Thrones S1: Ned, Cersei, Daenerys, Tyrion). Procedural → usually one (House) or a small team treated as a unit. Theme-led shows (The Wire, Slow Horses) often have several with the institution as the real subject — list the human protagonists who carry POV most
+
+# OUTPUT
+
+Strict JSON, no markdown wrapping, no comments outside JSON.
diff --git a/src/tvplotlines/prompts/narratology/pass2_fabula.md b/src/tvplotlines/prompts/narratology/pass2_fabula.md
new file mode 100644
index 0000000..14c57b4
--- /dev/null
+++ b/src/tvplotlines/prompts/narratology/pass2_fabula.md
@@ -0,0 +1,58 @@
+# TASK
+
+Extract every event from one episode synopsis. Identify who appears.
+
+# INPUT
+
+Show title, season, episode ID (e.g., "S01E03"), show context (format, story_schema, breach, genre), and one episode synopsis.
+
+# WHAT TO PRODUCE
+
+```json
+{
+  "episode": "S01E03",
+  "events": [
+    {
+      "description": "Walt and Jesse clean up Emilio's body",
+      "characters": ["walt", "jesse"]
+    },
+    {
+      "description": "Walt brings Krazy-8 food and tries to find a reason not to kill him",
+      "characters": ["walt", "krazy-8"]
+    },
+    {
+      "description": "Walt notices the missing plate shard, realizes Krazy-8 has hidden a weapon",
+      "characters": ["walt", "krazy-8"]
+    },
+    {
+      "description": "Walt strangles Krazy-8",
+      "characters": ["walt", "krazy-8"]
+    },
+    {
+      "description": "Skyler organizes a family intervention about Walt's chemo refusal",
+      "characters": ["skyler", "walt"]
+    },
+    {
+      "description": "Hank finds the desert cooking site and Krazy-8's car",
+      "characters": ["hank"]
+    },
+    {
+      "description": "A Native girl brings a strange mask to the DEA office",
+      "characters": ["guest:native-girl", "hank"]
+    }
+  ],
+  "cast_appearances": ["walt", "jesse", "skyler", "hank", "krazy-8"]
+}
+```
+
+# RULES
+
+- Walk through the synopsis in order. Don't skip events; don't reorder them
+- An event is a transition — something changed. Skip pure description (states, atmosphere, background)
+- **Don't judge importance.** Include every event that describes a change, even if it seems minor or disconnected. A scene that looks like atmosphere now may turn out to drive the plot later — that call gets made downstream when the whole season is visible
+- Use stable short character IDs (lowercase, no spaces). For one-off characters use `guest:short-name`
+- `cast_appearances` lists every character ID that appears in the events of this episode. Include guests too
+
+# OUTPUT
+
+Strict JSON, no markdown wrapping, no comments.
diff --git a/src/tvplotlines/prompts/narratology/pass3_actants.md b/src/tvplotlines/prompts/narratology/pass3_actants.md
new file mode 100644
index 0000000..c613c14
--- /dev/null
+++ b/src/tvplotlines/prompts/narratology/pass3_actants.md
@@ -0,0 +1,76 @@
+# TASK
+
+You see the events from every episode of a season, plus the full cast. Group the events into plotlines and describe each plotline's actant structure.
+
+# INPUT
+
+Show context, full cast list, and all events from all episodes of the season.
+
+# GLOSSARY
+
+{GLOSSARY}
+
+# WHAT TO PRODUCE
+
+```json
+{
+  "plotlines": [
+    {
+      "id": "empire",
+      "name": "Walt: Empire",
+      "who_chases": "walt",
+      "what_they_chase": "build a meth operation that secures his family",
+      "stands_in_the_way": ["krazy-8", "tuco"],
+      "helpers": ["jesse"],
+      "bigger_force": "Walt's pride and need to provide",
+      "who_wins_if_it_works": "walt",
+      "type": "serialized",
+      "nature": "character-led",
+      "confidence": "solid"
+    },
+    {
+      "id": "investigation",
+      "name": "Hank: Investigation",
+      "who_chases": "hank",
+      "what_they_chase": "find Heisenberg",
+      "stands_in_the_way": [],
+      "helpers": ["gomez"],
+      "bigger_force": "the justice system",
+      "who_wins_if_it_works": "hank",
+      "type": "serialized",
+      "nature": "plot-led",
+      "confidence": "partial"
+    }
+  ]
+}
+```
+
+# FIELDS
+
+- **id** — short stable identifier, lowercase
+- **name** — "Character: Theme" format ("Walt: Empire", "Hank: Investigation")
+- **who_chases** — character ID of the person driving this plotline
+- **what_they_chase** — the goal, in plain words. Can be a thing, a state, knowledge, or prevention
+- **stands_in_the_way** — character IDs of people who block them. Empty list if no specific person
+- **helpers** — character IDs of people who help. Empty list if none
+- **bigger_force** — the abstract force enabling or blocking the whole chase (institution, fate, character flaw). Can be null
+- **who_wins_if_it_works** — usually the same as `who_chases`. Can be different
+- **type**, **nature**, **confidence** — see glossary
+
+# RULES
+
+- **Choosing `who_chases`**: every plotline needs one character who drives it. Use these tests in order:
+  1. Who makes the key decisions in this plotline?
+  2. Whose point of view dominates the scenes of this plotline?
+  3. Who has the most at stake if the goal fails or succeeds?
+
+  The first two matter more than the third — agency over emotional stakes. If multiple characters share decisions equally (true ensemble plotline like a heist crew), pick the one whose POV the show favors most. If no character clearly drives the plotline (theme-led shows where the system is the real subject — *The Wire*, *Slow Horses*), pick the character most affected by the system. Note this in the plotline name: "MI5 vs Slough House: Lamb" rather than just "Lamb".
+
+- **Anti-subject test**: a character with their own goal and own actions gets their own plotline, not a `stands_in_the_way` slot. Test: if you removed `who_chases` from the show, would this person still be doing things? If yes, separate plotline. Cersei in GoT → separate plotline. The patient in House → goes in `stands_in_the_way` (actually the object — but if there's no clear opponent, leave the list empty)
+- Every event should belong to one plotline. Don't worry about assigning events here — that's the next pass. Just make sure you have plotlines that cover them all
+- If a character appears in many events but has no clear chase, they may not need their own plotline. Major characters without their own plotline are fine
+- 2–5 plotlines per season is typical. More than 7 means you're probably splitting too finely
+
+# OUTPUT
+
+Strict JSON, no markdown wrapping, no comments.
diff --git a/src/tvplotlines/prompts/narratology/pass4_story.md b/src/tvplotlines/prompts/narratology/pass4_story.md
new file mode 100644
index 0000000..1bb9405
--- /dev/null
+++ b/src/tvplotlines/prompts/narratology/pass4_story.md
@@ -0,0 +1,77 @@
+# TASK
+
+For each event in this episode, assign it to a plotline and label its episode-level function and direction. Then describe how the plotlines interact in this episode.
+
+# INPUT
+
+Show context, the full plotline list (from Pass 3), and the events of one episode (from Pass 2).
+
+# GLOSSARY
+
+{GLOSSARY}
+
+# WHAT TO PRODUCE
+
+```json
+{
+  "episode": "S01E03",
+  "events": [
+    {
+      "description": "Walt and Jesse clean up Emilio's body",
+      "plotline_id": "empire",
+      "function": "escalation",
+      "direction": "deterioration",
+      "also_affects": []
+    },
+    {
+      "description": "Walt strangles Krazy-8",
+      "plotline_id": "empire",
+      "function": "climax",
+      "direction": "improvement",
+      "also_affects": []
+    },
+    {
+      "description": "Skyler organizes a family intervention about Walt's chemo refusal",
+      "plotline_id": "family",
+      "function": "setup",
+      "direction": "improvement",
+      "also_affects": []
+    },
+    {
+      "description": "Hank finds the desert cooking site and Krazy-8's car",
+      "plotline_id": "investigation",
+      "function": "escalation",
+      "direction": "improvement",
+      "also_affects": ["empire"]
+    }
+  ],
+  "interactions": [
+    {
+      "kind": "thematic_rhyme",
+      "plotlines": ["empire", "family", "investigation"],
+      "description": "All three plotlines are about control — over another's life, one's own death, the law"
+    },
+    {
+      "kind": "threat",
+      "plotlines": ["empire", "investigation"],
+      "description": "The viewer knows Walt is Heisenberg; Hank doesn't"
+    }
+  ],
+  "theme": "The illusion of control"
+}
+```
+
+# RULES
+
+- Every event from the input must appear in `events`. Don't drop, don't merge
+- `description` must match the input event description exactly
+- `plotline_id` must reference an existing plotline from Pass 3. If an event doesn't fit any plotline, leave it `null` — Pass 6 will handle orphans
+- `function` is episode-level. **Don't use `inciting_incident`** at this level — that exists only at the season level
+- `direction` is from the perspective of the plotline's `who_chases`
+- `also_affects` lists secondary plotlines this event impacts (often with opposite direction). Empty list if none
+- `interactions` only between plotlines that are both active in this episode
+- `theme` is one sentence. Look at what the climax/resolution of the main plotline says
+
+# OUTPUT
+
+Strict JSON, no markdown wrapping, no comments.
diff --git a/src/tvplotlines/prompts/narratology/pass5_arc.md b/src/tvplotlines/prompts/narratology/pass5_arc.md
new file mode 100644
index 0000000..661f68e
--- /dev/null
+++ b/src/tvplotlines/prompts/narratology/pass5_arc.md
@@ -0,0 +1,71 @@
+# TASK
+
+Look at every event of a plotline across the whole season. For each event: assign season-level function and direction, and label it drive or texture. Identify the plotline's MRE (most reportable event).
+
+Run this once per plotline.
+
+# INPUT
+
+The plotline's actant structure (from Pass 3) and all its events in episode order, with their episode-level function and direction (from Pass 4).
+
+# GLOSSARY
+
+{GLOSSARY}
+
+# WHAT TO PRODUCE
+
+```json
+{
+  "plotline_id": "empire",
+  "events": [
+    {
+      "episode": "S01E01",
+      "description": "Walt receives lung cancer diagnosis",
+      "arc_function": "inciting_incident",
+      "arc_direction": "deterioration",
+      "kind": "drive"
+    },
+    {
+      "episode": "S01E01",
+      "description": "Walt asks Jesse to partner up on cooking meth",
+      "arc_function": "recognition",
+      "arc_direction": "improvement",
+      "kind": "drive"
+    },
+    {
+      "episode": "S01E03",
+      "description": "Walt strangles Krazy-8",
+      "arc_function": "escalation",
+      "arc_direction": "deterioration",
+      "kind": "drive"
+    },
+    {
+      "episode": "S01E03",
+      "description": "A Native girl brings a strange mask to the DEA office",
+      "arc_function": null,
+      "arc_direction": "neutral",
+      "kind": "texture"
+    }
+  ],
+  "mre": {
+    "episode": "S01E03",
+    "description": "Walt strangles Krazy-8",
+    "why": "The first time Walt kills with his own hands. He crosses a line he can't uncross."
+  }
+}
+```
+
+# RULES
+
+- Read all events of the plotline in episode order before assigning anything
+- `arc_function` is the role in the *whole season* arc. The same event can be a climax in its episode and an escalation in the season — don't copy from `function`
+- Exactly one event has `arc_function: "inciting_incident"` per plotline, usually in the first episodes
+- `recognition` is optional — only use it when a separate event captures the character deciding to act after the inciting incident. Skip when disruption and decision are the same event
+- `arc_direction` is from the perspective of `who_chases`. The same event can be `improvement` in its episode and `deterioration` in the season (Walt killing Krazy-8: episode-improvement, season-deterioration)
+- `kind` — now you see the whole plotline, decide: if you removed this event, would the outcome change? Yes → `drive`. No → `texture`. Texture events get `arc_function: null` (they don't sit in the dramatic shape)
+- Every event from the input must appear in the output
+- `mre` is the one event that makes the plotline worth telling. Often the climax — but not always. Walt's first cook isn't more reportable than the moment he kills. Pick the moment that answers "so what". MRE must be a `drive` event
+
+# OUTPUT
+
+Strict JSON, no markdown wrapping, no comments.
diff --git a/src/tvplotlines/prompts/narratology/pass6_review.md b/src/tvplotlines/prompts/narratology/pass6_review.md
new file mode 100644
index 0000000..6313f00
--- /dev/null
+++ b/src/tvplotlines/prompts/narratology/pass6_review.md
@@ -0,0 +1,72 @@
+# TASK
+
+Review the full season. Find structural problems. Issue verdicts to fix them. Rank the plotlines.
+
+# INPUT
+
+Show context, the full plotline list (with actant structure and MRE), all events with episode/season function and direction, all interactions.
+
+# GLOSSARY
+
+{GLOSSARY}
+
+# WHAT TO PRODUCE
+
+```json
+{
+  "verdicts": [
+    {
+      "kind": "MERGE",
+      "targets": ["family", "marriage"],
+      "rationale": "Both plotlines have Skyler chasing the same goal — getting Walt to be honest. Same chase, same character"
+    },
+    {
+      "kind": "DROP",
+      "targets": ["jesse-side"],
+      "rationale": "Only 2 events across the whole season; no real chase, no inciting incident. Redistribute its events to 'empire'"
+    },
+    {
+      "kind": "REASSIGN",
+      "event_episode": "S01E04",
+      "event_description": "Walt lies to Skyler about where he was",
+      "to_plotline": "family",
+      "rationale": "Was assigned to 'empire' but it advances the Family plotline — Walt building a wall of lies"
+    },
+    {
+      "kind": "REFUNCTION",
+      "event_episode": "S01E07",
+      "event_description": "Walt and Tuco's first deal",
+      "new_function": "turning_point",
+      "rationale": "Was labeled `escalation` but it changes the trajectory — Walt enters the criminal world for real"
+    }
+  ],
+  "ranks": [
+    {"plotline_id": "empire", "rank": "A"},
+    {"plotline_id": "investigation", "rank": "B"},
+    {"plotline_id": "family", "rank": "B"},
+    {"plotline_id": "jesse-arc", "rank": "C"}
+  ]
+}
+```
+
+# RULES
+
+**Verdicts** — issue them when you find problems:
+
+- `MERGE` two plotlines when they have the same chase by the same character. `targets` lists the plotline IDs to combine
+- `DROP` a plotline that doesn't hold up — too few events, no inciting incident, no real chase. `targets` lists the one plotline to drop
+- `CREATE` a new plotline when you find a group of orphaned events (`plotline_id: null`) that together form one. Provide a tentative `id` and `name`, list the event references
+- `REASSIGN` a single event when it was put in the wrong plotline. Provide `event_episode`, `event_description`, and the correct `to_plotline`
+- `REFUNCTION` an event when its function label is wrong. Provide `event_episode`, `event_description`, and the `new_function`
+
+**Ranks** — assign every plotline an `A`, `B`, or `C`:
+
+- `A` — the plotline whose MRE is the most reportable event of the season. The one you'd lead with when telling someone what the season is about
+- `B` — important plotlines that share screen time with A but don't define the season
+- `C` — runners and minor plotlines that add texture but aren't structural
+
+If two plotlines compete for A, ask: which MRE would you lead with? That's A.
+
+# OUTPUT
+
+Strict JSON, no markdown wrapping, no comments. Empty `verdicts` list is fine if nothing needs fixing.
diff --git a/src/tvplotlines/prompts/narratology/synopses_writer.md b/src/tvplotlines/prompts/narratology/synopses_writer.md
new file mode 100644
index 0000000..ba70f13
--- /dev/null
+++ b/src/tvplotlines/prompts/narratology/synopses_writer.md
@@ -0,0 +1,60 @@
+# TASK
+
+Write a 200–400 word synopsis of one TV episode.
+
+# RULES
+
+1. **Every sentence is a transition.** A transition is a change of state — someone or something is one way at the start, another way at the end. The verb is incidental; the change is the point. Bad: "Walt cooks meth." Good: "Walt cooks his first batch — Jesse, who tried solo before, now sees how much he didn't know."
+
+2. **No interpretation, no inner monologue.** Report what happened, not what it meant. Bad: "The cancer doesn't change Walt's life; the secret does." Good: "Walt receives the diagnosis. He decides not to tell Skyler." Let the pipeline find the meaning.
+
+3. **No literary metaphors.** Bad: "the teacher becomes the thief", "the recognition flips Walt's resolve". Good: "Walt steals chemistry equipment from school", "Walt sees the missing plate shard and changes his mind".
+
+4. **Factual accuracy.** Use only what is in the source material. Don't invent scenes, don't speculate about motivations not stated. If the source is sparse — leave the detail out, don't fabricate.
+
+5. **Causality is explicit.** Use "because", "so that", "after", "leading to". Don't make the reader guess.
+
+6. **At least three plotlines per episode.** A-story plus at least two more. Personal arcs, institutional dynamics, runners. Even if a plotline gets one sentence, mention it. A 100% case-of-the-week synopsis is useless to the pipeline.
+
+7. **Institutional matters.** If the show involves an organization (DEA, hospital, agency), capture what happens at that level — power moves, political pressure, internal conflicts. Don't treat it as background.
+
+8. **Screen order.** Episodes interleave plotlines on screen. Preserve that order. Don't sort events by plotline.
+
+# WHAT NOT TO INCLUDE
+
+- Visual style, music, directing, editing
+- Symbolism, themes, editorial commentary
+- The word "Meanwhile"
+- Future-episode spoilers
+- Recap of past episodes (unless a character learns about them now)
+- Author intuition about character psychology not shown on screen
+- Drive/texture labels — that classification happens later in the pipeline
+
+# OUTPUT
+
+Plain text. 200–400 words. One paragraph per scene-cluster, blank lines between. Total transitions follow the natural density of the episode — no fixed target.
+
+# SELF-CHECK
+
+Before finalizing, re-read:
+
+1. Does any sentence describe a state, atmosphere, or background? Cut it.
+2. Does any sentence interpret what an event meant? Cut the interpretation, keep the event.
+3. Does any sentence use a literary metaphor? Replace with the literal action.
+4. How many distinct plotlines are present? If fewer than 3, something is missing.
+5. For procedural/hybrid: is there serialized content (character arcs, institutional politics)? It must be at least 30% of the text.
+6. Does every transition follow from the previous one or set up the next?
+
+# EXAMPLE — Breaking Bad S01E03
+
+Walt and Jesse clean up Emilio's body. Krazy-8 stays locked in the basement. Krazy-8 reveals that Jesse told him personal details about Walt; Walt confronts Jesse, who is smoking meth, and Jesse leaves angry.
+
+Skyler tells Marie she is writing a story about a stoner and asks about marijuana. Marie assumes Walt Jr. is using drugs and tells Hank. Hank takes Walt Jr. to a motel and shows him a meth addict's teeth.
+
+Walt phones Skyler from Jesse's house, claiming he is at the car wash. Skyler tells him she knows he quit two weeks ago and forbids him from coming home. Walt brings Krazy-8 food. He suffers a coughing fit and collapses. When he comes to, he tells Krazy-8 about the cancer. Krazy-8 talks about his father's furniture store. Walt decides to release him.
+
+Walt notices a shard missing from the broken plate. He realizes Krazy-8 has hidden it as a weapon. Walt strangles Krazy-8 with the bike lock. Krazy-8 stabs Walt's leg during the struggle.
+
+Walt drives home. Skyler is crying on the bed. She says he has something to tell her.
+
+At the DEA, Hank and his team find the desert cook site and Krazy-8's car with meth inside. A Native American family hands Hank the gas mask their child found.
diff --git a/src/tvplotlines/prompts_en/__init__.py b/src/tvplotlines/prompts_en/__init__.py
deleted file mode 100644
index 4b26d67..0000000
--- a/src/tvplotlines/prompts_en/__init__.py
+++ /dev/null
@@ -1,47 +0,0 @@
-"""Prompt templates for each pipeline pass.
-
-Prompts are stored as .md files and loaded at runtime as system prompts.
-Supports English (default) and Russian prompt sets.
-"""
-
-from importlib import resources
-
-_LANG_PACKAGES = {
-    "en": "tvplotlines.prompts_en",
-    "ru": "tvplotlines.prompts_ru",
-}
-
-_glossary_cache: dict[str, str] = {}
-
-
-def _load_glossary(lang: str) -> str:
-    """Load shared glossary for a language (cached)."""
-    if lang not in _glossary_cache:
-        package = _LANG_PACKAGES[lang]
-        _glossary_cache[lang] = (
-            resources.files(package).joinpath("glossary.md").read_text(encoding="utf-8")
-        )
-    return _glossary_cache[lang]
-
-
-def load_prompt(pass_name: str, lang: str = "en") -> str:
-    """Load a prompt template by pass name and language.
-
-    If the prompt contains {GLOSSARY}, it is replaced with the shared
-    glossary from the same language package.
-
-    Args:
-        pass_name: "pass0", "pass1", "pass2", "pass3", "pass4", or "synopses_writer".
-        lang: Language code — "en" or "ru".
-
-    Returns:
-        Prompt text (markdown).
-    """
-    if lang not in _LANG_PACKAGES:
-        raise ValueError(f"Unsupported language: {lang!r}. Expected one of {list(_LANG_PACKAGES)}")
-    package = _LANG_PACKAGES[lang]
-    filename = f"{pass_name}.md"
-    text = resources.files(package).joinpath(filename).read_text(encoding="utf-8")
-    if "{GLOSSARY}" in text:
-        text = text.replace("{GLOSSARY}", _load_glossary(lang))
-    return text
diff --git a/src/tvplotlines/prompts_ru/__init__.py b/src/tvplotlines/prompts_ru/__init__.py
deleted file mode 100644
index ec93c20..0000000
--- a/src/tvplotlines/prompts_ru/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-"""Russian prompt templates — package marker."""
diff --git a/src/tvplotlines/prompts_ru/glossary.md b/src/tvplotlines/prompts_ru/glossary.md
deleted file mode 100644
index 4965d44..0000000
--- a/src/tvplotlines/prompts_ru/glossary.md
+++ /dev/null
@@ -1,137 +0,0 @@
-## Story DNA
-
-У каждой сюжетной линии четыре компонента: **герой** (кто её двигает), **цель** (чего он хочет), **препятствие** (что мешает), **ставки** (что произойдёт при провале). Если хотя бы один компонент отсутствует — это не сюжетная линия, а событие внутри другой линии.
-
-У некоторых линий нет очевидного единственного героя — обычно это тематические линии (см. plotline:nature), где проблема исходит от института или системы, а не от персонажа. Примеры: «MI5 vs Slough House» в Slow Horses, «Professional life at Sterling Cooper» в Mad Men. В таких случаях назначьте наиболее подходящего персонажа героем — того, кого ситуация затрагивает сильнее всего, кто двигает динамику или чья точка зрения доминирует.
-
-## plotline
-
-История с полной Story DNA. Имеет трёхактную структуру, конфликт и причинно-следственную цепочку событий. Сюжетная линия привязана к персонажу основного состава или институту, а не к гостевому персонажу.
-
-В типичном эпизоде телесериала несколько параллельных сюжетных линий, обозначаемых буквами A, B, C: главная линия A, занимающая основное экранное время, и второстепенные линии B, которые могут предлагать тематические параллели или контрапункт.
-
-### granularity
-
-Ключевой критерий — ЦЕЛЬ, а не персонаж.
-Разные линии: разные герои, ИЛИ один герой с разными целями, препятствиями и ставками.
-
-Тест: если не получается написать логлайн — «[герой] хочет [цель], но [препятствие], а если провалится — [ставки]» — это не сюжетная линия.
-
-Для тематических линий тест логлайном выглядит так: «[институт/система] [проблема]; [герой] [роль в ней], ставки: [ставки].» Пример: «MI5 covers up its role in the kidnapping; Taverner drives the cover-up, stakes: exposure and careers.»
-
-### what is not a plotline
-
-| пример                             | что это                                                   |
-| ---------------------------------- | --------------------------------------------------------- |
-| "John has lunch"                   | Фон — нет цели/конфликта                                 |
-| "Everyone goes to a party"         | Декорация — нет героя/ставок                              |
-| "John is sad"                      | Состояние — нет цели/препятствия                          |
-| "John and Mike's friendship"       | Контекст — нет конфликта                                  |
-| "Investigation" (procedural, ep.5) | Часть линии case_of_the_week, а не отдельная линия        |
-
-## plotline:type
-
-Как долго длится сюжетная линия?
-
-- **case_of_the_week** — открывается и закрывается в рамках одного эпизода. Story engine шоу описывает повторяющуюся формулу. Story DNA шаблонная (повторяющиеся цель/препятствие/ставки), конкретное содержание заполняется поэпизодно.
-- **serialized** — охватывает несколько эпизодов или весь сезон. Конфликты переносятся из эпизода в эпизод.
-- **runner** — второстепенная повторяющаяся нить. Неполная Story DNA — нет препятствия или разрешения, логлайн описательный. Всё остальное — полноценная сюжетная линия.
-
-## plotline:nature
-
-Откуда исходит главная проблема? Это важно, потому что nature подсказывает, какое препятствие искать: внешнего врага (plot-led), внутренний изъян героя (character-led) или систему, которую никто не может исправить в одиночку (theme-led).
-
-- **plot-led** — извне героя. Внешняя цель против антагониста. Stranger Things, CSI.
-- **character-led** — изнутри героя. Внутренний конфликт, герой сам является проблемой. Breaking Bad, Fleabag.
-- **theme-led** — от общества. Системная проблема, единого решения нет. The Wire, Succession.
-
-## plotline:confidence
-
-Насколько полна структура конфликта?
-
-- **solid** — герой, цель, препятствие, ставки — всё ясно.
-- **partial** — герой и цель ясны, препятствие или ставки — нет.
-- **inferred** — линия подразумевается, структура конфликта неполна.
-
-Это важно, потому что inferred-линии ожидаемо имеют неполную структуру — они не будут помечены за отсутствие функций или малое количество событий. Solid-линии — будут.
-
-## format
-
-- **procedural** — в каждом эпизоде самостоятельная история (дело, пациент, миссия), которая открывается и закрывается внутри эпизода. Хотя каждый эпизод имеет своё дело, мы объединяем их в одну повторяющуюся линию «Case of the Week» — один структурный слот, разное содержание. Другие линии — второстепенные. CSI, House, Law & Order.
-- **hybrid** — в каждом эпизоде case-of-the-week И сериализованные линии, которые активно переплетаются. Обе стороны важны. X-Files, Buffy, Good Wife, Grey's Anatomy.
-- **serial** — эпизоды продолжают друг друга. Конфликты не закрываются внутри эпизода. Нет case-of-the-week. Один явный протагонист. Breaking Bad, Sopranos.
-- **ensemble** — как serial, но без единого протагониста. Несколько персонажей ведут собственные линии с примерно равным экранным временем. Диагностический вопрос: можете ли вы назвать ОДНОГО главного героя? Если нет — ensemble. Game of Thrones, Succession, The Wire, The Crown.
-
-Классифицируйте на основе синопсисов, а не предварительных знаний о шоу. Один и тот же сериал может менять формат между сезонами.
-
-Не ставьте serial по умолчанию только потому, что есть персонажные линии — hybrid означает, что И case-of-the-week, И сериализованные арки значимы.
-
-Диагностика:
-- если E01 и E02 имеют разные дела — procedural или hybrid
-- если E02 продолжает конфликт E01, не закрывая его — serial или ensemble
-- serial vs ensemble: можете ли вы назвать ОДНОГО главного героя? Если нет — ensemble
-
-## is_anthology
-
-Сезоны независимы — новый состав, новая история, никакой преемственности между сезонами. Внутри отдельного сезона антология имеет обычную структуру (serial, procedural и т.д.). Это важно, потому что данные предыдущих сезонов не передаются дальше. True Detective, Fargo.
-
-## story_engine
-
-Повторяющийся драматический механизм шоу в одном предложении. Фокус на глаголах — что персонажи делают каждую неделю?
-
-Запишите story engine как логлайн из одного предложения. Два типичных шаблона:
-- «[Кто] [делает что] ради [цель], но [препятствие].»
-- «Когда [ситуация], [кто] должен [делать что], иначе [ставки].»
-
-Используйте тот, который лучше подходит шоу.
-
-Примеры из реальных шоу (ни один не следует шаблонам точно — это нормально, шаблоны лишь отправная точка):
-- "A high school chemistry teacher diagnosed with inoperable lung cancer turns to manufacturing and selling methamphetamine in order to secure his family's future." (Breaking Bad)
-- "Nine noble families fight for control over the lands of Westeros, while an ancient enemy returns after being dormant for millennia." (Game of Thrones)
-- "An antisocial maverick doctor does whatever it takes to solve puzzling cases that come his way." (House)
-
-## genre
-
-Свободный текст — drama, thriller, comedy, sci-fi и т.д.
-
-## event
-
-Одно действие одного персонажа (или группы), которое меняет ситуацию. Два действия разных персонажей = два события. Два действия в один момент, где второе — непосредственное следствие первого = одно событие.
-
-Описания событий должны быть конкретными и точными. Указывайте имена персонажей, что именно происходит и каковы драматические последствия. Плохо: «The team works on the case.» Хорошо: «House orders a lumbar puncture over Cameron's objection, risking paralysis to test his sarcoidosis theory.»
-
-## function
-
-Каждое событие несёт функцию — свою позицию в драматической структуре:
-
-| function | что делает |
-|----------|------------|
-| `setup` | Вводит сюжетную линию. Статус-кво. |
-| `inciting_incident` | Событие, запускающее линию. Одно на линию, не повторяется. |
-| `escalation` | Повышает ставки. Может повторяться. |
-| `turning_point` | Меняет направление. Ложный пик или ложный провал. |
-| `crisis` | Низшая точка. Герой сталкивается с тем, чего боялся больше всего. Настоящая дилемма. |
-| `climax` | Пик конфликта. Исход необратим. |
-| `resolution` | Конфликт разрешён. Последствия. |
-
-Функции проверяются на следующих этапах на полноту арки и монотонность — если у линии за весь сезон только setup и escalation, это сигнал.
-
-## interaction
-
-Как сюжетные линии связаны внутри эпизода:
-
-- **thematic_rhyme** — линии исследуют одну тему с разных сторон.
-- **dramatic_irony** — зритель знает то, чего не знает персонаж в другой линии.
-- **convergence** — линии сливаются (персонажи/конфликты пересекаются).
-
-## verdict
-
-Структурная корректировка, применяемая после обзора полного сезона:
-
-| action | что делает |
-|--------|------------|
-| `MERGE` | Объединить две линии в одну |
-| `REASSIGN` | Переместить событие в другую линию |
-| `CREATE` | Создать новую линию из осиротевших событий |
-| `DROP` | Удалить линию, перераспределить её события |
-| `REFUNCTION` | Изменить функцию события (напр. escalation → crisis) |
diff --git a/src/tvplotlines/prompts_ru/pass0.md b/src/tvplotlines/prompts_ru/pass0.md
deleted file mode 100644
index 6c20d47..0000000
--- a/src/tvplotlines/prompts_ru/pass0.md
+++ /dev/null
@@ -1,61 +0,0 @@
-# РОЛЬ
-Вы — редактор-сценарист, оценивающий структуру шоу по его синопсисам.
-
-# КОНТЕКСТ
-Вы получаете: название шоу, номер сезона и до 3 первых синопсисов. Ваш результат передаётся на следующий этап как контекст для извлечения сюжетных линий.
-
-# ГЛОССАРИЙ
-
-{GLOSSARY}
-
-# ЗАДАЧА
-
-Если во входных данных есть `suggested_plotlines`, используйте их как дополнительный контекст — это предварительные предложения от автора синопсисов. Они могут помочь с определением формата и ансамбля, но проверьте их по синопсисам.
-
-Прочитайте синопсисы и определите, в следующем порядке:
-### Шаг 1: Определите формат
-Какова структура эпизодов? Используйте определения и диагностику из глоссария.
-### Шаг 2: Проверьте антологию
-Независимы ли сезоны друг от друга?
-### Шаг 3: Напишите story engine
-Напишите логлайн в одно предложение. Шаблоны и примеры — в разделе story_engine глоссария.
-### Шаг 4: Определите жанр
-
-# РЕЗУЛЬТАТ
-
-Продумайте ответ перед тем, как писать JSON. Вам нужно будет обосновать свой выбор в поле `reasoning` — его проверяет человек.
-
-Ответ — строго JSON, без markdown-обёрток, без комментариев за пределами JSON.
-
-```json
-{
-  "show": "Breaking Bad",
-  "season": 1,
-  "format": "serial",
-  "is_anthology": false,
-  "story_engine": "A high school chemistry teacher diagnosed with inoperable lung cancer turns to manufacturing and selling methamphetamine in order to secure his family's future",
-  "genre": "drama",
-  "reasoning": "Episodes continue each other: E01's conflict (first cook) flows into E02 (consequences), no self-contained stories within episodes."
-}
-```
-
-Типы полей:
-
-- `show`: string
-- `season`: integer
-- `format`: enum — `"procedural"` | `"serial"` | `"hybrid"` | `"ensemble"`
-- `is_anthology`: boolean
-- `story_engine`: string — логлайн в одно предложение
-- `genre`: string
-- `reasoning`: string — почему вы выбрали этот формат (1–2 предложения)
-
-# ВАЛИДАЦИЯ
-
-Код проверит:
-
-- JSON-схему: все обязательные поля на месте
-- `format` — одно из: procedural, serial, hybrid, ensemble
-- `is_anthology` — boolean
-- `story_engine` — непустая строка
-
-Код не может проверить: соответствует ли ваша классификация формата синопсисам, отражает ли story_engine реальный механизм — это ваша задача.
diff --git a/src/tvplotlines/prompts_ru/pass1.md b/src/tvplotlines/prompts_ru/pass1.md
deleted file mode 100644
index 8af2e1d..0000000
--- a/src/tvplotlines/prompts_ru/pass1.md
+++ /dev/null
@@ -1,188 +0,0 @@
-# РОЛЬ
-
-Вы — редактор-сценарист, прочитавший синопсисы всего сезона. Составьте карту сюжетных линий: кто каждую ведёт, чего хочет, что мешает, какие ставки.
-
-# КОНТЕКСТ
-
-Вы получаете: название шоу, номер сезона, формат, story engine и все синопсисы эпизодов. Если есть данные прошлого сезона, вы также получаете состав и сюжетные линии предыдущего сезона.
-
-Ваш результат — список персонажей и сюжетные линии с Story DNA — передаётся на следующий этап, где события из каждого эпизода будут привязаны к этим линиям.
-
-# ГЛОССАРИЙ
-
-{GLOSSARY}
-
-# ЗАДАЧА
-
-### Шаг 1: Обработайте предыдущий сезон (если есть)
-
-Если во входных данных есть `prior_season`, обработайте его ПРЕЖДЕ, чем анализировать новые синопсисы.
-
-Для каждой линии в `prior_season.plotlines` решите на основе синопсисов НОВОГО сезона:
-- **CONTINUES** — присутствует в этом сезоне. Сохраните `id`, обновите цель/препятствие/ставки. Пример: «Walt: Empire» S1→S2 — та же цель, но препятствие теперь Gus, а не Tuco.
-- **TRANSFORMED** — тот же герой, цель принципиально изменилась. Сохраните `id`, перепишите Story DNA. Пример: «Walt: Empire» S4→S5 — больше не строит, а прячется от последствий.
-- **ENDED** — разрешена или исчезла. Не включайте.
-
-Для каждого персонажа в `prior_season.cast`:
-- Если персонаж появляется в синопсисах этого сезона — используйте тот же `id` и `name`.
-- Если не появляется — не включайте.
-
-Только после обработки всех предыдущих линий определяйте НОВЫЕ линии, которых раньше не было.
-
-### Шаг 2: Прочитайте все синопсисы и предложенные линии
-Прочитайте ВСЕ синопсисы сезона. Если во входных данных есть `suggested_plotlines`, используйте их как отправную точку — они получены при предварительном анализе тех же синопсисов. Проверьте каждое предложение по тексту: оставьте то, для чего есть подтверждение, отбросьте то, для чего нет, добавьте то, что было пропущено. Story DNA реконструируется из совокупности упоминаний за весь сезон. Не выдумывайте — ставьте confidence.
-
-### Шаг 3: Определите основной состав
-Повторяющиеся персонажи, которые ведут сюжетные линии. Один персонаж на запись. Гостевые персонажи — не в составе.
-
-### Шаг 4: Извлеките сюжетные линии
-Для каждой линии заполните:
-- Story DNA: герой, цель, препятствие, ставки
-- type: case_of_the_week, serialized или runner
-- nature: plot-led, character-led или theme-led
-- confidence: solid, partial или inferred
-
-# ПРАВИЛА
-### Именование
-Имя и id = ОДНО абстрактное слово по ЦЕЛИ, не по событию и не по исходу. Примеры: «belonging», «leadership», «love», «redemption». НЕ используйте составные имена вроде «gang_survival» или «family_destruction» — пишите «survival» или «family». Поле `id` должно быть одним словом в snake_case, совпадающим с `name`.
-
-Используйте формат `Hero: Theme` для названий линий (напр. «House: Authority», «Cameron: Ethics», «Jon: Honor»). Это ясно показывает, кто ведёт каждую линию, и предотвращает путаницу при привязке событий.
-
-Линия case_of_the_week: назовите по формуле франшизы — «Case of the Week», «Crime of the Week», «Mission» и т.д. — чтобы сразу было понятно, что это повторяющаяся структура.
-
-Для тематических линий назовите по институциональной динамике или конфликту, а не по герою (напр. «MI5 vs Slough House», «Lab Politics», «Professional Life at Sterling Cooper»).
-
-### Seed и Wraparound
-
-Seed — функция события на следующем этапе. Wraparound — нарративный приём на следующем этапе. Не создавайте линии этих типов.
-
-### Формат и разрешение
-
-- **serial/ensemble**: линии могут выходить за рамки сезона, клиффхэнгер в финале допустим.
-- **is_anthology=true**: каждый сезон независим, не ссылайтесь на другие сезоны.
-
-### Ожидания по количеству
-
-- Procedural: 1 case_of_the_week + 1–3 сериализованных арки. Максимум 5.
-- Hybrid: 1 case_of_the_week + 2–4 сериализованных. Максимум 5.
-- Serial (≤8 эпизодов): максимум 5 линий. Serial (9+ эпизодов): максимум 7. Runner-линии должны охватывать 3+ эпизода.
-- Ensemble (≤8 эпизодов): максимум 7 линий. Ensemble (9+ эпизодов): максимум 9. Runner-линии должны охватывать 3+ эпизода.
-
-### Общее
-
-- Если сомневаетесь — НЕ создавайте линию.
-- Для формата procedural/hybrid: ровно 1 линия с типом case_of_the_week.
-- Nature линии и nature отдельных событий могут различаться — plot-led действие, обслуживающее character-led линию, — это нормально.
-- Не выдумывайте недостающие компоненты Story DNA — вместо этого ставьте confidence partial или inferred.
-- Язык целей: на том же языке, что и синопсисы.
-
-# РЕЗУЛЬТАТ
-
-Продумайте свои решения перед тем, как писать JSON. Каждая линия должна пройти тест логлайном, а вашу работу проверяет человек.
-
-Ответ — строго JSON, без markdown-обёрток, без комментариев за пределами JSON.
-
-```json
-{
-  "show": "Breaking Bad",
-  "season": 1,
-  "cast": [
-    {"id": "walt", "name": "Walter White", "aliases": ["Walt", "Heisenberg", "Mr. White"]},
-    {"id": "jesse", "name": "Jesse Pinkman", "aliases": ["Jesse", "Cap'n Cook"]},
-    {"id": "hank", "name": "Hank Schrader", "aliases": ["Hank"]},
-    {"id": "skyler", "name": "Skyler White", "aliases": ["Skyler"]},
-    {"id": "tuco", "name": "Tuco Salamanca", "aliases": ["Tuco"]}
-  ],
-  "plotlines": [
-    {
-      "id": "empire",
-      "name": "Walt: Empire",
-      "hero": "walt",
-      "goal": "build a drug business",
-      "obstacle": "moral choices, escalating danger, unpredictable partners",
-      "stakes": "death, loss of humanity",
-      "type": "serialized",
-      "nature": "character-led",
-      "confidence": "solid"
-    },
-    {
-      "id": "family",
-      "name": "Walt: Family",
-      "hero": "walt",
-      "goal": "keep the family together and hide the truth",
-      "obstacle": "cancer, family pressure for treatment, escalating lies",
-      "stakes": "family breakdown, exposure",
-      "type": "serialized",
-      "nature": "character-led",
-      "confidence": "solid"
-    },
-    {
-      "id": "investigation",
-      "name": "Hank: Investigation",
-      "hero": "hank",
-      "goal": "find the new meth producer",
-      "obstacle": "no direct evidence, only circumstantial traces",
-      "stakes": "criminal at large, public threat",
-      "type": "serialized",
-      "nature": "plot-led",
-      "confidence": "solid"
-    },
-    {
-      "id": "partnership",
-      "name": "Jesse: Partnership",
-      "hero": "jesse",
-      "goal": "survive as Walt's drug business partner",
-      "obstacle": "incompetence, fear, conflict with Walt",
-      "stakes": "prison or death",
-      "type": "serialized",
-      "nature": "character-led",
-      "confidence": "solid"
-    },
-    {
-      "id": "cancer",
-      "name": "Walt: Cancer",
-      "hero": "walt",
-      "goal": "deal with the diagnosis",
-      "obstacle": null,
-      "stakes": null,
-      "type": "runner",
-      "nature": "character-led",
-      "confidence": "partial"
-    }
-  ]
-}
-```
-
-Типы полей:
-
-**cast[]:**
-
-- `id`: string — уникальный snake_case-идентификатор, используется в поле `hero` и в `characters` событий на следующем этапе
-- `name`: string — полное имя как в титрах
-- `aliases`: массив строк — варианты имени из синопсисов
-
-**plotlines[]:**
-
-- `id`: string — уникальный snake_case-идентификатор (стабильный, не меняется при переименовании)
-- `name`: string — отображаемое имя (см. правила именования)
-- `hero`: string — `id` персонажа из cast
-- `goal`: string — на языке синопсиса
-- `obstacle`: string | null — на языке синопсиса (null для runner-линий)
-- `stakes`: string | null — на языке синопсиса (null для runner-линий)
-- `type`: enum — `"case_of_the_week"` | `"serialized"` | `"runner"`
-- `nature`: enum — `"plot-led"` | `"character-led"` | `"theme-led"`
-- `confidence`: enum — `"solid"` | `"partial"` | `"inferred"`
-
-Язык полей `goal`, `obstacle`, `stakes` — на языке синопсиса.
-
-Поле `span` (в каких эпизодах линия присутствует) вычисляется кодом по результатам следующего этапа — здесь не указывается.
-
-# ВАЛИДАЦИЯ
-
-Код проверит:
-
-- JSON-схему: все обязательные поля на месте, значения enum валидны
-- Каждый `hero` ссылается на существующий `id` в `cast`
-- Для формата procedural/hybrid: ровно 1 линия с типом case_of_the_week
-
-Код не может проверить: имеет ли Story DNA нарративный смысл, все ли линии вы нашли — это ваша задача. Ранг (A/B/C) вычисляется кодом после следующего этапа, а не вами.
diff --git a/src/tvplotlines/prompts_ru/pass2.md b/src/tvplotlines/prompts_ru/pass2.md
deleted file mode 100644
index 87e863d..0000000
--- a/src/tvplotlines/prompts_ru/pass2.md
+++ /dev/null
@@ -1,182 +0,0 @@
-# РОЛЬ
-Вы — редактор-сценарист, разбирающий один эпизод: что происходит, какой сюжетной линии это служит, какую функцию выполняет.
-
-# КОНТЕКСТ
-Вы получаете: название шоу, номер сезона, формат, story engine, состав (с ID), сюжетные линии (с ID и Story DNA) и синопсис одного эпизода. Ваш результат — события одного эпизода и взаимодействия между линиями.
-
-# ГЛОССАРИЙ
-
-{GLOSSARY}
-
-# ЗАДАЧА
-
-### Шаг 1: Разбейте синопсис на события
-Пройдите синопсис предложение за предложением. Каждое предложение должно дать как минимум одно событие.
-
-### Шаг 2: Привяжите каждое событие к сюжетной линии
-Для каждого события решите, к какой линии оно относится. Используйте правила привязки ниже.
-
-### Шаг 3: Назначьте функции
-Для каждого события назначьте его драматическую функцию. Это две отдельные задачи — к какой линии относится событие и какую функцию оно выполняет — решаются независимо.
-
-Назначайте функции на основании того, что происходит **в этом эпизоде**, а не по всему сезону. Событие, которое является кульминацией истории этого эпизода, может оказаться эскалацией в сезонной арке — но вы видите только этот эпизод, так что назначайте по тому, что видите.
-
-### Шаг 4: Определите взаимодействия между линиями
-Проверьте каждую пару линий, активных в этом эпизоде. Если они связаны — через общую тему, драматическую иронию или конвергенцию персонажей — зафиксируйте взаимодействие. Типы взаимодействий — в глоссарии.
-
-### Шаг 5: Определите тему эпизода
-Одно предложение. Какая идея связывает линии воедино? Посмотрите, что говорит кульминация/развязка A-линии.
-
-# ПРАВИЛА
-
-### Привязка событий к линиям
-
-Каждое событие принадлежит той линии, чью цель оно продвигает. Когда несколько персонажей в одной сцене, спросите: чья цель здесь продвинулась? Линия этого персонажа — владелец события.
-
-Гостевые персонажи не имеют собственных линий. Действие гостя принадлежит персонажу основного состава, чьей линии оно служит.
-
-Когда одно событие продвигает две линии, привяжите его к основной и укажите вторую в `also_affects`.
-
-### Проверка своей работы
-
-Каждое предложение синопсиса должно породить хотя бы одно событие. Если не получается привязать предложение к событию — вы что-то пропустили.
-
-Если все линии в эпизоде имеют только функции escalation или только crisis/resolution — вероятно, вы неправильно назначили функции. Хорошо написанный эпизод проводит основную линию через полную арку: setup → escalation → turning point → climax → resolution. Другие линии могут покрывать меньше стадий, но A-линия обычно проходит через все.
-
-# РЕЗУЛЬТАТ
-
-Продумайте ответ перед тем, как писать JSON. Ваши привязки проверяет человек и код.
-
-Ответ — строго JSON, без markdown-обёрток, без комментариев за пределами JSON.
-
-
-```json
-{
-  "show": "Breaking Bad",
-  "season": 1,
-  "episode": "S01E03",
-  "events": [
-    {
-      "event": "Walt and Jesse clean up Emilio's remains",
-      "plotline_id": "empire",
-      "function": "escalation",
-      "characters": ["walt", "jesse"],
-      "also_affects": null
-    },
-    {
-      "event": "Krazy-8 talks about his childhood, Walt about cancer",
-      "plotline_id": "empire",
-      "function": "escalation",
-      "characters": ["walt"],
-      "also_affects": ["family"]
-    },
-    {
-      "event": "Walt makes a pros and cons list for killing",
-      "plotline_id": "empire",
-      "function": "turning_point",
-      "characters": ["walt"],
-      "also_affects": null
-    },
-    {
-      "event": "Skyler organizes a family intervention",
-      "plotline_id": "family",
-      "function": "setup",
-      "characters": ["skyler", "walt"],
-      "also_affects": null
-    },
-    {
-      "event": "Family votes for chemo, Walt wants to refuse",
-      "plotline_id": "family",
-      "function": "escalation",
-      "characters": ["walt", "skyler"],
-      "also_affects": null
-    },
-    {
-      "event": "Hank finds the desert cooking site",
-      "plotline_id": "investigation",
-      "function": "escalation",
-      "characters": ["hank"],
-      "also_affects": null
-    },
-    {
-      "event": "DEA finds Krazy-8's car with meth",
-      "plotline_id": "investigation",
-      "function": "escalation",
-      "characters": ["hank"],
-      "also_affects": null
-    },
-    {
-      "event": "Native girl brings a mask to the DEA office",
-      "plotline_id": "investigation",
-      "function": "setup",
-      "characters": ["guest:native_girl"],
-      "also_affects": null
-    },
-    {
-      "event": "Walt decides to release Krazy-8",
-      "plotline_id": "empire",
-      "function": "turning_point",
-      "characters": ["walt"],
-      "also_affects": null
-    },
-    {
-      "event": "Walt notices the missing plate shard",
-      "plotline_id": "empire",
-      "function": "crisis",
-      "characters": ["walt"],
-      "also_affects": null
-    },
-    {
-      "event": "Walt strangles Krazy-8",
-      "plotline_id": "empire",
-      "function": "climax",
-      "characters": ["walt"],
-      "also_affects": null
-    },
-    {
-      "event": "Walt decides to tell Skyler about the cancer",
-      "plotline_id": "family",
-      "function": "turning_point",
-      "characters": ["walt"],
-      "also_affects": null
-    }
-  ],
-  "theme": "the illusion of control",
-  "interactions": [
-    {
-      "type": "thematic_rhyme",
-      "lines": ["empire", "family", "investigation"],
-      "description": "all three plotlines are about control—over another's life, one's own death, the law"
-    },
-    {
-      "type": "dramatic_irony",
-      "lines": ["empire", "investigation"],
-      "description": "the audience knows Walt = Heisenberg, Hank doesn't"
-    }
-  ]
-}
-```
-
-### Типы полей
-
-**events[]:**
-- `event`: string — одно предложение
-- `plotline_id`: string | null — `id` линии из предыдущего этапа, или `null`, если событие не вписывается ни в одну линию
-- `function`: enum — `"setup"` | `"inciting_incident"` | `"escalation"` | `"turning_point"` | `"crisis"` | `"climax"` | `"resolution"`
-- `characters`: массив строк — `id` персонажей из cast. Для гостевых персонажей используйте `"guest:short_name"` (напр. `"guest:native_girl"`)
-- `also_affects`: массив строк | null — `id` линий, на которые событие влияет вторично
-
-**interactions[]:**
-- `type`: enum — `"thematic_rhyme"` | `"dramatic_irony"` | `"convergence"`
-- `lines`: массив строк — `id` линий
-- `description`: string
-
-# ВАЛИДАЦИЯ
-
-Код проверит:
-- JSON-схему: все обязательные поля, значения enum
-- Каждый `plotline_id` ссылается на существующий `id` из предыдущего этапа или равен `null`
-- Каждый элемент `characters` ссылается на существующий `id` из cast или имеет префикс `guest:`
-- `theme` — непустая строка
-
-Код не может проверить: покрывают ли события весь синопсис, правильны ли функции, реальны ли взаимодействия — это ваша задача.
diff --git a/src/tvplotlines/prompts_ru/pass3.md b/src/tvplotlines/prompts_ru/pass3.md
deleted file mode 100644
index 01e18a0..0000000
--- a/src/tvplotlines/prompts_ru/pass3.md
+++ /dev/null
@@ -1,185 +0,0 @@
-# РОЛЬ
-
-Вы — редактор-сценарист, перед которым разложены все эпизоды. Проверьте общую картину: правильно ли определены сюжетные линии, верно ли привязаны события, держится ли структура? Исправьте то, что неправильно.
-
-# КОНТЕКСТ
-
-Вы получаете:
-- **show**, **season**, **format**, **story_engine** (контекст сериала)
-- **cast**: список персонажей с `id`, `name`
-- **plotlines**: список линий с `id`, `name`, `hero`, `goal`, `obstacle`, `stakes`, `type`, `computed_rank`, `nature`, `confidence`, `span`
-- **episodes**: для каждого эпизода — `events` (с привязками к линиям), `theme`, `interactions`
-- **diagnostics** (необязательно): автоматические флаги из пост-обработки. У каждого флага есть `plotline`, `flag` и `reason`. Возможные флаги:
-  - `low_completeness` — у линии меньше функций арки, чем ожидается для её confidence (напр. solid-линия с 3/7)
-  - `monotonicity_violation` — последовательность функций идёт назад через веху (напр. crisis после climax)
-  - `dominant` — линия содержит более 50% всех событий сезона
-  Это вычисленные факты — используйте их в анализе.
-
-Ваш результат — вердикты (структурные корректировки) — применяются кодом для получения финального результата.
-
-# ГЛОССАРИЙ
-
-{GLOSSARY}
-
-# ЗАДАЧА
-
-### Шаг 1: Проверьте Story DNA каждой линии
-
-Полная Story DNA: **герой → цель → препятствие → ставки**.
-
-**Тест логлайном:** если можно написать логлайн с конфликтом (герой хочет X, но Y стоит на пути, Z на кону) — это solid-линия.
-
-Но шоу могут быть плохо написаны. Линия может существовать без ясной цели, с номинальным конфликтом, или быть брошенной на полпути. Это не значит, что её нет — это значит, что она слабая. Не отбрасывайте слабые линии — ставьте confidence.
-
-### Шаг 2: Выборочно проверьте привязки событий
-
-Просмотрите события по эпизодам. Для каждой линии прочитайте её события и проверьте: продвигает ли это событие цель ЭТОЙ линии, или оно лучше подходит другой? Типичные ошибки:
-
-- Событие привязано к A-линии героя, но на самом деле продвигает его B-линию (не та цель)
-- Событие описывает реакцию персонажа на конфликт другой линии (должно быть в `also_affects`, а не основной привязкой)
-- Несколько событий подряд привязаны к одной линии, но описывают разные конфликты
-
-Если нашли неправильно привязанные события → REASSIGN.
-
-### Шаг 3: Проверьте арки линий
-
-Примечание: функции событий из предыдущего этапа отражают роль каждого события внутри своего эпизода, а не внутри сезонной арки. Учитывайте это при проверке прогрессии арки — «climax» в эпизоде 3 может быть escalation в сезонной арке.
-
-Если в diagnostics есть `low_completeness` — проверьте, не привязаны ли события этой линии к другим линиям по ошибке (→ REASSIGN обратно), или линия действительно слабая (→ отметьте в обзоре, не выдумывайте события).
-
-### Шаг 4: Поищите дублирование
-
-Две линии с одним героем и смежными целями — скорее всего одна линия с фазами. Признаки:
-
-- Один герой, цели причинно связаны (цель B — следствие цели A)
-- События двух линий чередуются в одних и тех же эпизодах
-- Нет конфликта между двумя линиями — они не противоречат друг другу
-
-Если подтверждается → MERGE.
-
-Если в diagnostics есть `dominant` — линия содержит более половины всех событий сезона. Проверьте, не являются ли это на самом деле две линии, слитые в одну (→ CREATE вторую линию + REASSIGN события в неё).
-
-### Шаг 5: Проверьте осиротевшие события
-
-События с `plotline_id: null` — предыдущий этап не смог их привязать. Для каждого:
-
-- Событие принадлежит существующей линии (ошибка привязки) → REASSIGN
-- Несколько осиротевших событий образуют паттерн (один герой, одна цель) → CREATE новую линию
-
-### Шаг 6: Проверьте соответствие формату
-
-Структура линий должна соответствовать формату:
-
-- **Procedural**: ровно одна case_of_the_week линия. Максимум 5.
-- **Hybrid**: одна case_of_the_week + остальные сериализованные. Максимум 5.
-- **Serial**: максимум 5 линий. Runner-линии должны охватывать 3+ эпизода.
-- **Ensemble**: максимум 8 линий. Runner-линии должны охватывать 3+ эпизода.
-
-Если структура не соответствует — либо формат определён неправильно, либо линии нуждаются в корректировке.
-
-### Шаг 7: Назначьте ранги
-
-У каждой линии есть `computed_rank`, назначенный кодом по количеству событий. Проверьте его. Для каждой линии назначьте свой ранг (A, B, C или null для runner-линий) на основе нарративной значимости — о чём шоу, а не сколько событий у линии.
-
-Верните ваши ранги в поле `ranks` — маппинг из ID линии в ранг.
-
-# ПРАВИЛА
-
-1. **Если всё в порядке — пустой массив `verdicts`.** Не выдумывайте проблемы.
-2. **Каждый вердикт должен быть обоснован теорией** (Story DNA, формат, арка) или данными (span, diagnostics).
-3. **REASSIGN ссылается на точный текст события** из входных данных. Не перефразируйте.
-4. **MERGE: события источника автоматически переносятся в цель.** Не нужно перечислять каждое.
-5. **DROP: необходимо указать, куда перемещаются ВСЕ события.** Код отклонит DROP, если хотя бы одно событие осталось нераспределённым. События никогда не удаляются и не устанавливаются в null.
-6. **CREATE: необходимо указать полную Story DNA** (hero, goal, obstacle, stakes) и какие события входят.
-7. **REFUNCTION: укажите текст события, эпизод, старую функцию, новую функцию.**
-8. **Не помечайте inferred-линии** за отсутствие функций или малое количество событий — неполная структура для них ожидаема. Помечайте solid-линии с неполной структурой.
-9. **DROP только фантомы.** DROP для линии — только если у неё нет событий и она не существует в сериале. Слабая линия в плохом сценарии — это данные, а не ошибка.
-
-# РЕЗУЛЬТАТ
-
-Продумайте каждый вердикт перед тем, как писать JSON. Каждый вердикт должен быть обоснован данными или теорией — ваш обзор проверяет человек.
-
-Ответ — строго JSON, без markdown-обёрток, без комментариев за пределами JSON.
-
-```json
-{
-  "verdicts": [
-    {
-      "action": "MERGE",
-      "source": "plotline_x",
-      "target": "plotline_y",
-      "reason": "one sentence—why"
-    },
-    {
-      "action": "REASSIGN",
-      "event": "exact event text",
-      "episode": "S01E06",
-      "from": null,
-      "to": "plotline_z",
-      "reason": "one sentence"
-    },
-    {
-      "action": "CREATE",
-      "plotline": {
-        "id": "new_plotline_id",
-        "name": "Hero: Theme",
-        "hero": "cast_id",
-        "goal": "...",
-        "obstacle": "...",
-        "stakes": "...",
-        "type": "serialized",
-        "nature": "character-led"
-      },
-      "reassign_events": [
-        {"event": "exact event text", "episode": "S01E03"},
-        {"event": "exact event text", "episode": "S01E06"}
-      ],
-      "reason": "one sentence"
-    },
-    {
-      "action": "DROP",
-      "target": "plotline_id",
-      "redistribute": [
-        {"event": "exact event text", "episode": "S01E02", "to": "other_plotline_id"}
-      ],
-      "reason": "one sentence"
-    },
-    {
-      "action": "REFUNCTION",
-      "event": "exact event text",
-      "episode": "S01E05",
-      "old_function": "escalation",
-      "new_function": "crisis",
-      "reason": "one sentence"
-    }
-  ],
-  "ranks": {
-    "empire": "A",
-    "family": "B",
-    "investigation": "C"
-  },
-  "notes": "brief comment on the quality of the original analysis (1–2 sentences)"
-}
-```
-
-### Типы вердиктов
-
-| action | обязательные поля |
-|--------|-------------------|
-| `MERGE` | `source`, `target`, `reason` |
-| `REASSIGN` | `event`, `episode`, `from`, `to`, `reason` |
-| `CREATE` | `plotline`, `reassign_events`, `reason` |
-| `DROP` | `target`, `redistribute`, `reason` |
-| `REFUNCTION` | `event`, `episode`, `old_function`, `new_function`, `reason` |
-
-# ВАЛИДАЦИЯ
-
-Код проверит:
-- JSON-схему: все обязательные поля для каждого типа вердикта
-- `target`/`source` ссылаются на существующие id линий
-- `to` в REASSIGN ссылается на существующий id (или id из CREATE в том же наборе вердиктов)
-- `event` в REASSIGN/DROP/CREATE/REFUNCTION точно совпадает с текстом события во входных данных
-- `new_function` — валидное значение enum функции
-- `plotline` в CREATE содержит все обязательные поля
-
-Код не может проверить: улучшают ли ваши вердикты анализ, обоснованы ли слияния, правильны ли перефункционирования — это ваша задача.
diff --git a/src/tvplotlines/prompts_ru/pass4.md b/src/tvplotlines/prompts_ru/pass4.md
deleted file mode 100644
index 11756bc..0000000
--- a/src/tvplotlines/prompts_ru/pass4.md
+++ /dev/null
@@ -1,46 +0,0 @@
-# РОЛЬ
-Вы — редактор-сценарист, видящий весь сезон целиком. Все события определены и привязаны к сюжетным линиям. Ваша задача — определить роль каждого события в сезонной арке линии.
-
-# КОНТЕКСТ
-
-Вы получаете: название шоу, сезон, сюжетные линии с Story DNA и все события, сгруппированные по линиям в порядке эпизодов. У каждого события уже есть `function` — его роль внутри эпизода. Вы назначаете `plot_fn` — его роль в сезонной арке.
-
-# ГЛОССАРИЙ
-
-{GLOSSARY}
-
-# ЗАДАЧА
-
-Для каждой линии прочитайте её события в порядке эпизодов. Назначьте `plot_fn` каждому событию — какую роль это событие играет в арке линии на протяжении всего сезона?
-
-Сезонная функция может отличаться от эпизодной. Событие, которое было кульминацией эпизода 3, может быть эскалацией в сезонной арке — линия ещё только набирает обороты.
-
-`inciting_incident` встречается один раз на линию за весь сезон — событие, которое запускает линию.
-
-Назначьте `plot_fn` КАЖДОМУ событию. Не пропускайте ни одного.
-
-# РЕЗУЛЬТАТ
-
-Продумайте арку каждой линии перед тем, как писать. Вы назначаете функции сезонной истории — учитывайте, где каждое событие находится в начале, середине и конце этой истории. Ваши назначения проверяет человек.
-
-Ответ — строго JSON, без markdown-обёрток.
-
-```json
-{
-  "arc_functions": [
-    {"plotline": "empire", "episode": "S01E01", "event": "exact event text from input", "plot_fn": "setup"},
-    {"plotline": "empire", "episode": "S01E01", "event": "exact event text from input", "plot_fn": "inciting_incident"},
-    {"plotline": "empire", "episode": "S01E02", "event": "exact event text from input", "plot_fn": "escalation"}
-  ]
-}
-```
-
-Одна запись на событие. Используйте точный текст события из входных данных — не перефразируйте. Укажите id линии, чтобы код мог правильно сопоставить события.
-
-# ВАЛИДАЦИЯ
-
-Код проверит:
-- Каждое событие из входных данных имеет соответствующую запись в arc_functions
-- Каждый `plot_fn` — валидная функция: setup, inciting_incident, escalation, turning_point, crisis, climax, resolution
-- Текст каждого `event` точно совпадает с событием из входных данных
-- Каждый `plotline` ссылается на существующий id линии
diff --git a/src/tvplotlines/prompts_ru/synopses_writer.md b/src/tvplotlines/prompts_ru/synopses_writer.md
deleted file mode 100644
index 5e43472..0000000
--- a/src/tvplotlines/prompts_ru/synopses_writer.md
+++ /dev/null
@@ -1,79 +0,0 @@
-# РОЛЬ
-
-Вы — автор синопсисов, работающий по стандартизированному протоколу. Ваша задача — прочитать все предоставленные данные и написать синопсис.
-
-# КОНТЕКСТ
-Вы получаете: название шоу, номер сезона, номер эпизода, формат шоу (procedural/serial/hybrid/ensemble) и исходное описание эпизода (обычно краткое изложение в стиле Википедии). Ваш результат — полноценный синопсис, который будет подан в пайплайн извлечения сюжетных линий.
-
-{GLOSSARY}
-
-# ПРАВИЛА
-
-1. **Каждое предложение — бит.** Бит — событие, которое меняет ситуацию. Если в предложении нет конфликта или изменения — уберите его.
-2. **Действия и решения, а не атмосфера.** Пишите, что персонаж или институт сделал и почему, а не как выглядела сцена.
-3. **Конфликт обязателен.** Если не можете сформулировать конфликт в сцене — этой сцене нет места в синопсисе.
-4. **Персонажи по имени.** При первом появлении — полное имя + роль или отношение. Далее — только имя.
-5. **Явная причинность.** Каждое событие должно следовать из предыдущего. Не «совпадением», а «потому что».
-6. **Минимум 3 нарративных потока на эпизод.** Дело/A-линия + минимум два других потока (личный, институциональный или оба). Не фокусируйтесь только на личных конфликтах — институциональная динамика столь же важна. Если эпизод показывает офисную политику, организационное давление, профессиональное соперничество или столкновения рабочих культур, описывайте эти события с такой же детализацией, как личные линии.
-7. **Институциональные и рабочие линии.** Если в шоу есть организация (агентство, больница, полицейское управление, корпорация), убедитесь, что вы не пропустили происходящее на институциональном уровне — борьбу за власть, решения по политике, динамику клиент/дело, межведомственные конфликты. Это не фон — это могут быть линии со своими конфликтами и ставками.
-8. **Все линии покрыты.** A, B, C и runner-линии. Даже если B-линия — одно предложение, она должна быть упомянута.
-9. **Сериализованный контент ≥ 30% текста.** Синопсис, состоящий на 100% из case-of-the-week, бесполезен для извлечения линий. Пайплайн не может извлечь то, чего нет в тексте.
-10. **Фактическая точность обязательна.** Синопсис должен быть основан на реальном содержании эпизода. Не выдумывайте пациентов, сцены или события, которых не было. Если исходное описание слишком скупо, чтобы уверенно раскрыть деталь — опустите эту деталь, а не выдумывайте её.
-
-## Ориентиры по количеству битов по типу шоу
-
-| Формат | A-линия | B-линия | C / runner |
-|---|---|---|---|
-| Procedural | 5–8 | 2–4 | 1–2 |
-| Serial | 4–6 | 3–5 | 1–3 |
-| Ensemble | 2–4 на линию | 2–4 на линию | 1–2 на линию |
-
-## Что включать
-
-- Действия персонажей и их последствия
-- Решения и мотивации (когда ясны из контекста)
-- Конфликты и их исходы — личные И институциональные
-- Институциональные события: офисная политика, борьба за власть, переговоры с клиентами, организационные решения
-- Ключевой диалог — только если он меняет ситуацию
-- Представление новых персонажей с минимальным контекстом
-- **Баланс между линиями.** В процедурных и гибридных шоу есть тенденция чрезмерно описывать case-of-the-week и недоописывать сериализованные арки. Убедитесь, что каждая активная линия эпизода получает пропорциональное покрытие — дело важно, но персонажные и институциональные линии — это то, что несёт сезон
-
-## Что НЕ включать
-
-- Визуальный стиль, музыку, режиссуру, монтаж
-- Интерпретации, символизм, редакторские мнения
-- Слово «Тем временем»
-- Спойлеры из будущих эпизодов
-- Пересказ событий из прошлых эпизодов (если только персонаж не узнаёт о них в этом эпизоде)
-
-## Предложения по сюжетным линиям
-
-После написания синопсиса предложите линии, которые вы видите в этом эпизоде. Для каждой линии укажите:
-- **name**: краткое обозначение, обычно «Character: Theme» (напр. «Don: Identity»)
-- **hero**: персонаж, ведущий эту линию (полное имя)
-- **goal**: одно предложение о том, чего персонаж хочет или пытается сделать
-- **nature**: одно из «plot-led», «character-led» или «theme-led»
-
-# РЕЗУЛЬТАТ
-
-Верните JSON-объект со следующими полями:
-
-```json
-{
-  "synopsis": "Your synopsis text here...",
-  "suggested_plotlines": [
-    {"name": "Don: Identity", "hero": "Don Draper", "goal": "maintain his fabricated identity", "nature": "character-led"}
-  ]
-}
-```
-
-Синопсис должен быть:
-
-- **Простой текст** — без markdown, без буллетов, без подзаголовков, без заголовков
-- **200–400 слов**, **8–15 битов** каждый
-- Сплошная проза, организованная в абзацы по сценам или локациям
-- Хронологический порядок внутри эпизода; флэшбеки маркируйте явно
-- Язык: русский
-- Без редакторских комментариев или ссылок на будущие эпизоды
-
-**Перед финализацией:** перечитайте синопсис и проверьте — упоминает ли он события из всех активных линий, или только из дела? Если вы написали в основном о case-of-the-week, вернитесь и добавьте сериализованные линии.
diff --git a/src/tvplotlines/synopses_writer.py b/src/tvplotlines/synopses_writer.py
index 849101a..7c6ce9c 100644
--- a/src/tvplotlines/synopses_writer.py
+++ b/src/tvplotlines/synopses_writer.py
@@ -559,17 +559,15 @@ def _validate_plotlines(plotlines: list) -> list[dict]:
     return valid
 
 
-def _build_system_prompt(*, use_glossary: bool) -> str:
-    """Load the synopses_writer prompt, optionally with glossary injected."""
-    from tvplotlines.prompts_en import load_prompt
+def _build_system_prompt(*, use_glossary: bool, system: str = "hollywood") -> str:
+    """Load the synopses_writer prompt for a given system, optionally with glossary."""
+    from tvplotlines.prompts import load_prompt
 
     if use_glossary:
-        # load_prompt already replaces {GLOSSARY} with glossary content
-        return load_prompt("synopses_writer")
+        return load_prompt("synopses_writer", system=system)
 
-    # Load raw prompt and strip the {GLOSSARY} placeholder
     from importlib import resources
-    text = resources.files("tvplotlines.prompts_en").joinpath(
+    text = resources.files(f"tvplotlines.prompts.{system}").joinpath(
         "synopses_writer.md"
     ).read_text(encoding="utf-8")
     return text.replace("{GLOSSARY}", "")
@@ -647,7 +645,7 @@ def rewrite_synopses(
         list[str] when suggest_plotlines=False (backward compat).
         dict with "synopses" and "suggested_plotlines" when suggest_plotlines=True.
     """
-    system_prompt = _build_system_prompt(use_glossary=use_glossary)
+    system_prompt = _build_system_prompt(use_glossary=use_glossary, system=config.system)
     format_hint = (
         f"Format: {show_format}"
         if show_format
@@ -1028,6 +1026,7 @@ def write_synopses(
     base_url: str | None = None,
     mode: Mode | None = None,
     use_glossary: bool = True,
+    system: str = "hollywood",
 ) -> None:
     """Generate episode synopses and save to files.
 
@@ -1087,7 +1086,7 @@ def write_synopses(
 
     from tvplotlines.llm import LLMConfig, usage
 
-    config = LLMConfig(provider=provider, model=model, base_url=base_url)
+    config = LLMConfig(provider=provider, model=model, base_url=base_url, system=system)
     usage.__init__()  # Reset usage tracker
     result = rewrite_synopses(
         episodes, show, season, config,
diff --git a/tests/test_synopses_writer.py b/tests/test_synopses_writer.py
index 589187e..4e58bf1 100644
--- a/tests/test_synopses_writer.py
+++ b/tests/test_synopses_writer.py
@@ -164,7 +164,7 @@ def test_all_titles_missing_raises(self, _mock_sleep, mock_get, _mock_search):
 
 class TestRewriteSynopses:
     @patch("tvplotlines.llm.call_llm_parallel")
-    @patch("tvplotlines.prompts_en.load_prompt", return_value="system prompt")
+    @patch("tvplotlines.prompts.load_prompt", return_value="system prompt")
     def test_rewrite_returns_synopsis_texts(self, _mock_prompt, mock_parallel):
         """Returns list of synopsis strings from LLM JSON responses."""
         mock_parallel.return_value = [
@@ -182,7 +182,7 @@ def test_rewrite_returns_synopsis_texts(self, _mock_prompt, mock_parallel):
         assert result[1] == "Full synopsis for episode 2..."
 
     @patch("tvplotlines.llm.call_llm_parallel")
-    @patch("tvplotlines.prompts_en.load_prompt", return_value="system prompt")
+    @patch("tvplotlines.prompts.load_prompt", return_value="system prompt")
     def test_rewrite_user_messages_contain_episode_info(self, _mock_prompt, mock_parallel):
         """User messages include show, season, episode number, description."""
         mock_parallel.return_value = [{"synopsis": "x"}, {"synopsis": "y"}]
@@ -202,7 +202,7 @@ def test_rewrite_user_messages_contain_episode_info(self, _mock_prompt, mock_par
         assert "procedural" in user_messages[0]
 
     @patch("tvplotlines.llm.call_llm_parallel")
-    @patch("tvplotlines.prompts_en.load_prompt", return_value="system prompt")
+    @patch("tvplotlines.prompts.load_prompt", return_value="system prompt")
     def test_rewrite_caches_system_prompt(self, _mock_prompt, mock_parallel):
         """System prompt is cached for efficiency."""
         mock_parallel.return_value = [{"synopsis": "x"}]

From 662965d3baf8d4cee9f5d293f5063467e0820f04 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Wed, 15 Apr 2026 11:05:59 +0200
Subject: [PATCH 14/24] =?UTF-8?q?refactor(narratology):=20thread=20stable?=
 =?UTF-8?q?=20event=20ids=20through=20passes=202=E2=80=936?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Pass 2: every event gets id {episode}#{index:02d} and keeps it downstream
- Passes 4–6: reference events by id, not by description
- Pass 5 mre: event_id instead of episode+description
- glossary: plain-English actant names (who_chases, bigger_force, …)
  now mapped to their Greimas terms (subject, power, …)
- docs/layered-schema.md aligned with prompt output

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 docs/layered-schema.md                        | 18 ++++++++++--------
 .../prompts/narratology/glossary.md           | 18 ++++++++++--------
 .../prompts/narratology/pass2_fabula.md       |  8 ++++++++
 .../prompts/narratology/pass4_story.md        | 10 +++++-----
 .../prompts/narratology/pass5_arc.md          | 19 +++++++------------
 .../prompts/narratology/pass6_review.md       | 10 ++++------
 6 files changed, 44 insertions(+), 39 deletions(-)

diff --git a/docs/layered-schema.md b/docs/layered-schema.md
index ccad4cc..7eb0d6a 100644
--- a/docs/layered-schema.md
+++ b/docs/layered-schema.md
@@ -114,23 +114,25 @@ Version 1.0.
 
 **plotlines**: map from id → {actants, type, nature, confidence, rank, mre}
 
+Pass 3 emits actants with plain-English keys; `prompts/narratology/glossary.md` maps each one to its Greimas term (who_chases↔subject, what_they_chase↔object, stands_in_the_way↔opponents, helpers↔helpers, bigger_force↔power, who_wins_if_it_works↔receiver).
+
 ```json
 {
   "empire": {
     "actants": {
-      "subject": "walt",
-      "object": "cook and sell meth",
-      "power": "Walt's pride and cancer deadline",
-      "receiver": "walt",
+      "who_chases": "walt",
+      "what_they_chase": "cook and sell meth",
+      "stands_in_the_way": ["krazy-8", "emilio", "tuco"],
       "helpers": ["jesse"],
-      "opponents": ["krazy-8", "emilio", "tuco"]
+      "bigger_force": "Walt's pride and cancer deadline",
+      "who_wins_if_it_works": "walt"
     },
     "type": "serialized",
     "nature": "character-led",
     "confidence": "solid",
     "rank": "A",
     "mre": {
-      "event_id": "S01E03#19",
+      "event_id": "S01E03#04",
       "why": "The first time Walt kills with his own hands..."
     }
   }
@@ -141,7 +143,7 @@ Version 1.0.
 
 ```json
 {
-  "S01E03#19": {
+  "S01E03#04": {
     "function": "climax",
     "direction": "improvement",
     "arc_function": "turning_point",
@@ -151,7 +153,7 @@ Version 1.0.
 }
 ```
 
-Enums: see `prompts_en/glossary.md` for `function` (8 values), `direction` (3), `kind` (2).
+Enums: see `src/tvplotlines/prompts/narratology/glossary.md` for `function` (8 values), `direction` (3), `kind` (2).
 
 **episodes**: map from episode id → {theme}
 
diff --git a/src/tvplotlines/prompts/narratology/glossary.md b/src/tvplotlines/prompts/narratology/glossary.md
index 2d09045..993a791 100644
--- a/src/tvplotlines/prompts/narratology/glossary.md
+++ b/src/tvplotlines/prompts/narratology/glossary.md
@@ -11,14 +11,16 @@ Label every event with its kind:
 
 Someone wants something and chases it. The chain of events that come from the chase is the plotline.
 
-For each plotline, identify:
-
-- **who chases** — the character driving the plotline
-- **what they chase** — what they want. Can be a thing (a person, money), a state (independence, safety), or knowledge (who killed her)
-- **what stands in the way** — usually people who block them
-- **who helps them** — anyone who supports the chase
-- **what makes it possible or impossible** — the bigger force behind it all. Often abstract: an institution, a deadline, the character's own flaw, fate. Sometimes nothing identifiable
-- **who wins if it works** — usually the same person who chases, but not always
+For each plotline, identify six slots. These are Greimas's actant model restated in plain English — use the plain names in prompt output; the canonical Greimas term is given for reference.
+
+| slot in output         | Greimas term | what it is                                                                                                                                                 |
+| ---------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **who_chases**         | subject      | the character driving the plotline                                                                                                                         |
+| **what_they_chase**    | object       | what they want — a thing (a person, money), a state (independence, safety), or knowledge (who killed her)                                                  |
+| **stands_in_the_way**  | opponents    | usually people who block them; empty list if no specific person                                                                                            |
+| **helpers**            | helpers      | anyone who supports the chase                                                                                                                              |
+| **bigger_force**       | power        | the abstract force enabling or blocking the whole chase (institution, deadline, character flaw, fate). Can be null                                         |
+| **who_wins_if_it_works** | receiver   | usually the same character as `who_chases`, but not always — e.g. the subject dies in their own plotline but a descendant receives the object              |
 
 **A separate plotline rule**: if a character has their own thing they're chasing — not just blocking the main character but going after their own goal — they get their own plotline. Test: if you removed the main character from the show, would this person still be doing things? If yes, separate plotline.
 
diff --git a/src/tvplotlines/prompts/narratology/pass2_fabula.md b/src/tvplotlines/prompts/narratology/pass2_fabula.md
index 14c57b4..a04df86 100644
--- a/src/tvplotlines/prompts/narratology/pass2_fabula.md
+++ b/src/tvplotlines/prompts/narratology/pass2_fabula.md
@@ -13,30 +13,37 @@ Show title, season, episode ID (e.g., "S01E03"), show context (format, story_sch
   "episode": "S01E03",
   "events": [
     {
+      "id": "S01E03#01",
       "description": "Walt and Jesse clean up Emilio's body",
       "characters": ["walt", "jesse"]
     },
     {
+      "id": "S01E03#02",
       "description": "Walt brings Krazy-8 food and tries to find a reason not to kill him",
       "characters": ["walt", "krazy-8"]
     },
     {
+      "id": "S01E03#03",
       "description": "Walt notices the missing plate shard, realizes Krazy-8 has hidden a weapon",
       "characters": ["walt", "krazy-8"]
     },
     {
+      "id": "S01E03#04",
       "description": "Walt strangles Krazy-8",
       "characters": ["walt", "krazy-8"]
     },
     {
+      "id": "S01E03#05",
       "description": "Skyler organizes a family intervention about Walt's chemo refusal",
       "characters": ["skyler", "walt"]
     },
     {
+      "id": "S01E03#06",
       "description": "Hank finds the desert cooking site and Krazy-8's car",
       "characters": ["hank"]
     },
     {
+      "id": "S01E03#07",
       "description": "A Native girl brings a strange mask to the DEA office",
       "characters": ["guest:native-girl", "hank"]
     }
@@ -52,6 +59,7 @@ Show title, season, episode ID (e.g., "S01E03"), show context (format, story_sch
 - **Don't judge importance.** Include every event that describes a change, even if it seems minor or disconnected. A scene that looks like atmosphere now may turn out to drive the plot later — that call gets made downstream when the whole season is visible
 - Use stable short character IDs (lowercase, no spaces). For one-off characters use `guest:short-name`
 - `cast_appearances` lists every character ID that appears in the events of this episode. Include guests too
+- **Event `id`** is `{episode}#{index:02d}`, starting at 01. IDs stay stable through all downstream passes — later passes refer to events by `id`, not by description
 
 # OUTPUT
 
diff --git a/src/tvplotlines/prompts/narratology/pass4_story.md b/src/tvplotlines/prompts/narratology/pass4_story.md
index 1bb9405..023992b 100644
--- a/src/tvplotlines/prompts/narratology/pass4_story.md
+++ b/src/tvplotlines/prompts/narratology/pass4_story.md
@@ -17,28 +17,28 @@ Show context, the full plotline list (from Pass 3), and the events of one episod
   "episode": "S01E03",
   "events": [
     {
-      "description": "Walt and Jesse clean up Emilio's body",
+      "id": "S01E03#01",
       "plotline_id": "empire",
       "function": "escalation",
       "direction": "deterioration",
       "also_affects": []
     },
     {
-      "description": "Walt strangles Krazy-8",
+      "id": "S01E03#04",
       "plotline_id": "empire",
       "function": "climax",
       "direction": "improvement",
       "also_affects": []
     },
     {
-      "description": "Skyler organizes a family intervention about Walt's chemo refusal",
+      "id": "S01E03#05",
       "plotline_id": "family",
       "function": "setup",
       "direction": "improvement",
       "also_affects": []
     },
     {
-      "description": "Hank finds the desert cooking site and Krazy-8's car",
+      "id": "S01E03#06",
       "plotline_id": "investigation",
       "function": "escalation",
       "direction": "improvement",
@@ -64,7 +64,7 @@ Show context, the full plotline list (from Pass 3), and the events of one episod
 # RULES
 
 - Every event from the input must appear in `events`. Don't drop, don't merge
-- `description` must match the input event description exactly
+- Reference each event by its `id` (from Pass 2). Do not include `description` in the output — the id is the join key
 - `plotline_id` must reference an existing plotline from Pass 3. If an event doesn't fit any plotline, leave it `null` — Pass 6 will handle orphans
 - `function` is episode-level. **Don't use `inciting_incident`** at this level — that exists only at the season level
 - `direction` is from the perspective of the plotline's `who_chases`
diff --git a/src/tvplotlines/prompts/narratology/pass5_arc.md b/src/tvplotlines/prompts/narratology/pass5_arc.md
index 661f68e..8f5f832 100644
--- a/src/tvplotlines/prompts/narratology/pass5_arc.md
+++ b/src/tvplotlines/prompts/narratology/pass5_arc.md
@@ -19,37 +19,32 @@ The plotline's actant structure (from Pass 3) and all its events in episode orde
   "plotline_id": "empire",
   "events": [
     {
-      "episode": "S01E01",
-      "description": "Walt receives lung cancer diagnosis",
+      "id": "S01E01#02",
       "arc_function": "inciting_incident",
       "arc_direction": "deterioration",
       "kind": "drive"
     },
     {
-      "episode": "S01E01",
-      "description": "Walt asks Jesse to partner up on cooking meth",
+      "id": "S01E01#07",
       "arc_function": "recognition",
       "arc_direction": "improvement",
       "kind": "drive"
     },
     {
-      "episode": "S01E03",
-      "description": "Walt strangles Krazy-8",
+      "id": "S01E03#04",
       "arc_function": "escalation",
       "arc_direction": "deterioration",
       "kind": "drive"
     },
     {
-      "episode": "S01E03",
-      "description": "A Native girl brings a strange mask to the DEA office",
+      "id": "S01E03#07",
       "arc_function": null,
       "arc_direction": "neutral",
       "kind": "texture"
     }
   ],
   "mre": {
-    "episode": "S01E03",
-    "description": "Walt strangles Krazy-8",
+    "event_id": "S01E03#04",
     "why": "The first time Walt kills with his own hands. He crosses a line he can't uncross."
   }
 }
@@ -63,8 +58,8 @@ The plotline's actant structure (from Pass 3) and all its events in episode orde
 - `recognition` is optional — only use it when a separate event captures the character deciding to act after the inciting incident. Skip when disruption and decision are the same event
 - `arc_direction` is from the perspective of `who_chases`. The same event can be `improvement` in its episode and `deterioration` in the season (Walt killing Krazy-8: episode-improvement, season-deterioration)
 - `kind` — now you see the whole plotline, decide: if you removed this event, would the outcome change? Yes → `drive`. No → `texture`. Texture events get `arc_function: null` (they don't sit in the dramatic shape)
-- Every event from the input must appear in the output
-- `mre` is the one event that makes the plotline worth telling. Often the climax — but not always. Walt's first cook isn't more reportable than the moment he kills. Pick the moment that answers "so what". MRE must be a `drive` event
+- Every event from the input must appear in the output — referenced by `id` (from Pass 2), not by description
+- `mre` is the one event that makes the plotline worth telling. Often the climax — but not always. Walt's first cook isn't more reportable than the moment he kills. Pick the moment that answers "so what". MRE must be a `drive` event. Reference it by `event_id`
 
 # OUTPUT
 
diff --git a/src/tvplotlines/prompts/narratology/pass6_review.md b/src/tvplotlines/prompts/narratology/pass6_review.md
index 6313f00..a117db0 100644
--- a/src/tvplotlines/prompts/narratology/pass6_review.md
+++ b/src/tvplotlines/prompts/narratology/pass6_review.md
@@ -27,15 +27,13 @@ Show context, the full plotline list (with actant structure and MRE), all events
     },
     {
       "kind": "REASSIGN",
-      "event_episode": "S01E04",
-      "event_description": "Walt lies to Skyler about where he was",
+      "event_id": "S01E04#12",
       "to_plotline": "family",
       "rationale": "Was assigned to 'empire' but it advances the Family plotline — Walt building a wall of lies"
     },
     {
       "kind": "REFUNCTION",
-      "event_episode": "S01E07",
-      "event_description": "Walt and Tuco's first deal",
+      "event_id": "S01E07#08",
       "new_function": "turning_point",
       "rationale": "Was labeled `escalation` but it changes the trajectory — Walt enters the criminal world for real"
     }
@@ -56,8 +54,8 @@ Show context, the full plotline list (with actant structure and MRE), all events
 - `MERGE` two plotlines when they have the same chase by the same character. `targets` lists the plotline IDs to combine
 - `DROP` a plotline that doesn't hold up — too few events, no inciting incident, no real chase. `targets` lists the one plotline to drop
 - `CREATE` a new plotline when you find a group of orphaned events (`plotline_id: null`) that together form one. Provide a tentative `id` and `name`, list the event references
-- `REASSIGN` a single event when it was put in the wrong plotline. Provide `event_episode`, `event_description`, and the correct `to_plotline`
-- `REFUNCTION` an event when its function label is wrong. Provide `event_episode`, `event_description`, and the `new_function`
+- `REASSIGN` a single event when it was put in the wrong plotline. Provide `event_id` (from Pass 2) and the correct `to_plotline`
+- `REFUNCTION` an event when its function label is wrong. Provide `event_id` and the `new_function`
 
 **Ranks** — assign every plotline an `A`, `B`, or `C`:
 

From 58fec5606bf0937be2baf9f57f7997acd48a4067 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Wed, 15 Apr 2026 11:10:47 +0200
Subject: [PATCH 15/24] feat(viewer): turn the HTML viewer into an end-to-end
 app
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Welcome screen now has an "Analyze a series" form (show + season).
  Clicking Analyze asks the configured LLM for episode synopses from
  its training memory, shows them in an editable preview modal, then
  runs the 5-pass pipeline on whatever the user confirms.
- LLM settings modal gains an "Analysis system" selector. Hollywood is
  live; Narratology is disabled with a "coming soon" note until its
  runtime lands in v2.
- Exports: added "PDF (via print)" that calls window.print(); a print
  stylesheet hides the toolbar/modals and lays the grid out in
  landscape, so Cmd+P → "Save as PDF" produces a usable document.
- Drag-and-drop .txt flow unchanged — it's the fallback when the model
  doesn't know the show.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 CHANGELOG.md                           |   5 +
 src/tvplotlines/html/parts/app.js      |  25 ++++-
 src/tvplotlines/html/parts/export.js   |   7 ++
 src/tvplotlines/html/parts/pipeline.js | 147 +++++++++++++++++++++++++
 src/tvplotlines/html/parts/shell.html  |  17 ++-
 src/tvplotlines/html/parts/style.css   |  63 +++++++++++
 6 files changed, 261 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7037be9..9ef9be3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+### Added
+- **"Analyze a series" entry flow** in the HTML viewer. Welcome screen now takes a show name + season; the viewer asks the configured LLM for episode synopses, shows them in an editable preview, then runs the normal pipeline. Download the single HTML and you have an end-to-end app. Fallback — drag-and-drop `.txt` synopses — still works.
+- **LLM settings** modal has an "Analysis system" selector (hollywood is live, narratology is disabled with "coming soon" until its pipeline lands in v2).
+- **PDF export** via the browser print stack — "PDF (via print)" menu item calls `window.print()`, and a print stylesheet hides the toolbar and lays the grid out on landscape pages, so Cmd+P → "Save as PDF" produces a usable document.
+
 ### Changed
 - **Prompt layout**: `prompts_en/` → `prompts/hollywood/`. Added `prompts/narratology/` from the former sister project, bundling eight structuralist prompts (context, fabula, actants, story, arc, review, synopses_writer, glossary). `docs/layered-schema.md` documents the shared `base + layers` JSON.
 - **Library API**: `get_plotlines(..., lang=)` replaced by `get_plotlines(..., system=)` (values: `"hollywood"` default, `"narratology"`). `LLMConfig.lang` → `LLMConfig.system`. CLI: `tvplotlines run --lang` → `--system`; `write-synopses --system` added.
diff --git a/src/tvplotlines/html/parts/app.js b/src/tvplotlines/html/parts/app.js
index c7eb5cf..414375b 100644
--- a/src/tvplotlines/html/parts/app.js
+++ b/src/tvplotlines/html/parts/app.js
@@ -5,6 +5,8 @@
 const Store = {
   getKey: () => localStorage.getItem('tvplotlines_api_key'),
   getProvider: () => localStorage.getItem('tvplotlines_provider'),
+  getSystem: () => localStorage.getItem('tvplotlines_system') || 'hollywood',
+  setSystem: (system) => localStorage.setItem('tvplotlines_system', system),
   setKey: (provider, key) => {
     localStorage.setItem('tvplotlines_provider', provider);
     localStorage.setItem('tvplotlines_api_key', key);
@@ -279,6 +281,7 @@ function _showLLMSettings() {
 
   const provider = Store.getProvider() || 'anthropic';
   const apiKey = Store.getKey() || '';
+  const system = Store.getSystem();
 
   modalBody.innerHTML = `
     <h3 style="margin-top:0">LLM Settings</h3>
@@ -289,12 +292,20 @@ function _showLLMSettings() {
         <option value="openai" ${provider === 'openai' ? 'selected' : ''}>OpenAI (GPT-4o)</option>
       </select>
     </div>
-    <div style="margin-bottom:16px">
+    <div style="margin-bottom:12px">
       <label for="llm-api-key" style="display:block;margin-bottom:4px;font-weight:600">API Key</label>
       <input id="llm-api-key" type="password" value="${apiKey.replace(/"/g, '&quot;')}"
         placeholder="sk-... or sk-ant-..."
         style="width:100%;padding:6px;border-radius:4px;border:1px solid var(--border, #ccc);box-sizing:border-box">
     </div>
+    <div style="margin-bottom:16px">
+      <label for="llm-system" style="display:block;margin-bottom:4px;font-weight:600">Analysis system</label>
+      <select id="llm-system" style="width:100%;padding:6px;border-radius:4px;border:1px solid var(--border, #ccc)">
+        <option value="hollywood" ${system === 'hollywood' ? 'selected' : ''}>Hollywood — screenwriting (story DNA, Freytag)</option>
+        <option value="narratology" disabled>Narratology — structuralist (coming soon)</option>
+      </select>
+      <div style="font-size:0.8em;color:#888;margin-top:4px">Narratology prompts are in place; the runtime is coming in v2.</div>
+    </div>
     <button id="llm-save-btn" style="padding:6px 16px;border-radius:4px;cursor:pointer">Save</button>
     <span id="llm-save-status" style="margin-left:8px;color:green;display:none">Saved!</span>
   `;
@@ -302,7 +313,9 @@ function _showLLMSettings() {
   document.getElementById('llm-save-btn').addEventListener('click', () => {
     const p = document.getElementById('llm-provider').value;
     const k = document.getElementById('llm-api-key').value.trim();
+    const s = document.getElementById('llm-system').value;
     Store.setKey(p, k);
+    Store.setSystem(s);
     const status = document.getElementById('llm-save-status');
     if (status) {
       status.style.display = 'inline';
@@ -698,6 +711,7 @@ function _initApp() {
   // Welcome screen buttons
   const btnPlay = document.getElementById('btn-play');
   const btnSkip = document.getElementById('btn-skip');
+  const analyzeForm = document.getElementById('analyze-form');
 
   if (btnPlay) btnPlay.addEventListener('click', runOnboarding);
   if (btnSkip) {
@@ -706,6 +720,15 @@ function _initApp() {
       _skipOnboarding();
     });
   }
+  if (analyzeForm) {
+    analyzeForm.addEventListener('submit', (e) => {
+      e.preventDefault();
+      const show = document.getElementById('analyze-show').value.trim();
+      const season = parseInt(document.getElementById('analyze-season').value, 10);
+      if (!show || !season) return;
+      _analyzeSeries(show, season);
+    });
+  }
 
   // Populate dropdown and determine initial view
   _populateSeriesDropdown();
diff --git a/src/tvplotlines/html/parts/export.js b/src/tvplotlines/html/parts/export.js
index 1d13297..fd98734 100644
--- a/src/tvplotlines/html/parts/export.js
+++ b/src/tvplotlines/html/parts/export.js
@@ -229,5 +229,12 @@ function _handleExport(format) {
     case 'txt': exportTXT(_currentData); break;
     case 'csv': exportCSV(_currentData); break;
     case 'fdx': exportFDX(_currentData); break;
+    case 'pdf': exportPDF(); break;
   }
 }
+
+// PDF: leverage the browser's print stack. Print CSS below lays the grid out
+// on landscape pages so a Cmd+P → "Save as PDF" yields a usable document.
+function exportPDF() {
+  window.print();
+}
diff --git a/src/tvplotlines/html/parts/pipeline.js b/src/tvplotlines/html/parts/pipeline.js
index e564ee2..f1d3638 100644
--- a/src/tvplotlines/html/parts/pipeline.js
+++ b/src/tvplotlines/html/parts/pipeline.js
@@ -1431,3 +1431,150 @@ function _hidePipelineProgress() {
   const overlay = document.getElementById('pipeline-progress');
   if (overlay) overlay.classList.add('hidden');
 }
+
+// ──────────────────────────────────────────────────────────────
+// End-to-end "Analyze a series" flow — user types show + season,
+// LLM generates episode synopses from training memory, user previews
+// and edits, pipeline runs on those synopses.
+// ──────────────────────────────────────────────────────────────
+
+const _ANALYZE_SYSTEM_PROMPT = `You generate detailed synopses for a TV series' season, one per aired episode, from your training knowledge.
+
+RULES:
+- Cover every episode that aired in the requested season, in order
+- Use zero-padded episode ids: S01E01, S01E02, …
+- 200–400 words per synopsis
+- Every sentence is a transition: something changes. Skip description of states, atmosphere, style
+- No interpretation, no inner monologue. Report what happened
+- No literary metaphors. Literal actions only
+- At least three plotlines per episode (A-story plus at least two more — personal arcs, institutional dynamics, runners)
+- Preserve screen order — don't sort events by plotline
+- Use only what aired. Don't invent scenes
+- If you don't know this show well enough to produce accurate synopses, return {"error": "unknown show"}
+
+OUTPUT: strict JSON with shape
+{"episodes": [{"episode": "S01E01", "text": "..."}, ...]}`;
+
+async function _generateSynopses(show, season, provider, apiKey, onProgress) {
+  const userMessage = JSON.stringify({ show, season });
+  onProgress(`Asking ${provider === 'anthropic' ? 'Claude' : 'GPT'} for synopses of ${show} S${String(season).padStart(2, '0')}...`);
+  const response = await callLLM(
+    _ANALYZE_SYSTEM_PROMPT, userMessage, provider, apiKey, null,
+  );
+  const parsed = _parseJSONResponse(response);
+  if (parsed.error) {
+    throw new Error(
+      `The model doesn't know "${show}" well enough to produce synopses. ` +
+      `Either try a more common title/season, or drag & drop .txt files via + Load.`
+    );
+  }
+  if (!Array.isArray(parsed.episodes) || parsed.episodes.length === 0) {
+    throw new Error('Model returned no episodes. Try again or upload synopses manually.');
+  }
+  return parsed.episodes;
+}
+
+async function _analyzeSeries(show, season) {
+  const provider = Store.getProvider();
+  const apiKey = Store.getKey();
+
+  if (!provider || !apiKey) {
+    alert('Set your LLM provider and API key first — click "LLM" in the toolbar after this message.');
+    // Bring user straight into settings
+    _skipOnboarding();
+    setTimeout(_showLLMSettings, 100);
+    return;
+  }
+
+  // Move from welcome screen into the viewer shell so the progress overlay fits the normal layout
+  _skipOnboarding();
+  _showPipelineProgress();
+  _updatePipelineProgress('Generating synopses from the model…', 0, 6);
+
+  let synopses;
+  try {
+    const episodes = await _generateSynopses(show, season, provider, apiKey, (msg) => {
+      _updatePipelineProgress(msg, 0, 6);
+    });
+    synopses = episodes.map(e => ({ episode: e.episode, text: String(e.text || '').trim() }));
+    synopses = synopses.filter(s => s.episode && s.text);
+    if (synopses.length === 0) throw new Error('All returned synopses were empty.');
+  } catch (err) {
+    _hidePipelineProgress();
+    alert(`Couldn't fetch synopses: ${err.message}`);
+    return;
+  }
+
+  // Give user a chance to review/edit synopses before committing to the pipeline
+  const confirmed = await _confirmSynopses(show, season, synopses);
+  if (!confirmed) {
+    _hidePipelineProgress();
+    return;
+  }
+  synopses = confirmed;
+
+  // Kick off the normal pipeline — reuse the 5-pass flow
+  try {
+    const result = await runPipeline(synopses, show, provider, apiKey, (message, pass, total) => {
+      // Shift progress by 1 so synopsis-generation counts as pass 0/6
+      _updatePipelineProgress(message, pass + 1, total + 1);
+    });
+
+    const name = `${show} S${String(season).padStart(2, '0')}`;
+    Store.saveResult(name, result);
+    _populateSeriesDropdown();
+    const select = document.getElementById('series-select');
+    if (select) select.value = name;
+    _switchSeries(name);
+    _setTab('grid');
+    _hidePipelineProgress();
+  } catch (err) {
+    _hidePipelineProgress();
+    console.error('Pipeline error:', err);
+    alert(`Pipeline failed: ${err.message}`);
+  }
+}
+
+// Preview & edit modal for the generated synopses. Returns the edited synopses
+// array or null if the user cancels.
+function _confirmSynopses(show, season, synopses) {
+  return new Promise((resolve) => {
+    const overlay = document.getElementById('modal-overlay');
+    const body = document.getElementById('modal-body');
+    if (!overlay || !body) { resolve(synopses); return; }
+
+    const rows = synopses.map((s, i) => `
+      <details ${i < 2 ? 'open' : ''} style="margin-bottom:10px;border:1px solid var(--border,#ddd);border-radius:6px">
+        <summary style="padding:8px 12px;cursor:pointer;font-weight:600">${s.episode} — ${s.text.slice(0, 80).replace(/</g, '&lt;')}…</summary>
+        <textarea data-episode="${s.episode}" style="width:100%;min-height:160px;padding:8px;border:none;border-top:1px solid var(--border,#eee);background:transparent;color:inherit;font:inherit;resize:vertical">${s.text.replace(/</g, '&lt;')}</textarea>
+      </details>
+    `).join('');
+
+    body.innerHTML = `
+      <h3 style="margin-top:0">Review synopses — ${show} S${String(season).padStart(2, '0')}</h3>
+      <p style="color:#666;font-size:0.85em;margin-bottom:12px">
+        Generated ${synopses.length} synopses. Edit anything that looks wrong, then run the pipeline.
+      </p>
+      <div style="max-height:55vh;overflow-y:auto;padding-right:4px">${rows}</div>
+      <div style="margin-top:16px;display:flex;gap:8px;justify-content:flex-end">
+        <button id="analyze-cancel" style="padding:6px 14px;border-radius:4px;cursor:pointer">Cancel</button>
+        <button id="analyze-run" style="padding:6px 14px;border-radius:4px;cursor:pointer;background:#1a1a1a;color:#fff;border:none">Run pipeline →</button>
+      </div>
+    `;
+    overlay.classList.remove('hidden');
+
+    const close = (value) => {
+      overlay.classList.add('hidden');
+      resolve(value);
+    };
+
+    document.getElementById('analyze-cancel').addEventListener('click', () => close(null));
+    document.getElementById('analyze-run').addEventListener('click', () => {
+      const edited = Array.from(body.querySelectorAll('textarea[data-episode]')).map(ta => ({
+        episode: ta.dataset.episode,
+        text: ta.value.trim(),
+      })).filter(s => s.text);
+      close(edited);
+    });
+  });
+}
diff --git a/src/tvplotlines/html/parts/shell.html b/src/tvplotlines/html/parts/shell.html
index dc98113..3fd5c21 100644
--- a/src/tvplotlines/html/parts/shell.html
+++ b/src/tvplotlines/html/parts/shell.html
@@ -16,8 +16,20 @@
   <div class="welcome-container">
     <h1 class="welcome-title">tvplotlines</h1>
     <p class="welcome-tagline">see the structure of any TV series</p>
-    <button id="btn-play" class="welcome-play">Play me</button>
-    <a id="btn-skip" class="welcome-skip" href="#">Skip &#8594;</a>
+
+    <form id="analyze-form" class="analyze-form" autocomplete="off">
+      <input id="analyze-show" type="text" class="analyze-input analyze-input-show"
+             placeholder="Series, e.g. Breaking Bad" required>
+      <input id="analyze-season" type="number" class="analyze-input analyze-input-season"
+             placeholder="Season" min="1" value="1" required>
+      <button type="submit" class="analyze-submit">Analyze</button>
+    </form>
+
+    <div class="welcome-secondary">
+      <button id="btn-play" class="welcome-link">Watch demo</button>
+      <span class="welcome-sep">·</span>
+      <a id="btn-skip" class="welcome-link" href="#">Skip to upload &#8594;</a>
+    </div>
   </div>
 </section>
 
@@ -89,6 +101,7 @@ <h1 class="welcome-title">tvplotlines</h1>
   <button onclick="_handleExport('txt')">TXT</button>
   <button onclick="_handleExport('csv')">CSV</button>
   <button onclick="_handleExport('fdx')">Final Draft (.fdx)</button>
+  <button onclick="_handleExport('pdf')">PDF (via print)</button>
 </div>
 
 <!-- Demo data (injected by build.py) -->
diff --git a/src/tvplotlines/html/parts/style.css b/src/tvplotlines/html/parts/style.css
index 23a0f16..0bd877e 100644
--- a/src/tvplotlines/html/parts/style.css
+++ b/src/tvplotlines/html/parts/style.css
@@ -42,6 +42,69 @@ body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; b
 }
 .welcome-skip:hover { color: #888; }
 
+/* ── Welcome entry form ── */
+.analyze-form {
+  display: flex; gap: 0.5rem; margin-bottom: 2rem;
+  align-items: stretch; width: min(440px, 90vw);
+}
+.analyze-input {
+  font: inherit; padding: 0.65rem 0.9rem;
+  border: 1px solid #ddd; border-radius: 8px;
+  background: #fff; color: #1a1a1a;
+  transition: border-color 0.15s;
+}
+.analyze-input:focus { outline: none; border-color: #888; }
+.analyze-input-show { flex: 1 1 auto; }
+.analyze-input-season { width: 5.5rem; text-align: center; }
+.analyze-submit {
+  padding: 0.65rem 1.5rem; border: 1px solid #1a1a1a; border-radius: 8px;
+  background: #1a1a1a; color: #fafafa; cursor: pointer; font-weight: 500;
+  letter-spacing: 0.04em; transition: background 0.15s, border-color 0.15s;
+}
+.analyze-submit:hover { background: #000; }
+.analyze-submit:disabled { opacity: 0.5; cursor: not-allowed; }
+
+.welcome-secondary {
+  font-size: 0.8rem; color: #888; letter-spacing: 0.04em;
+}
+.welcome-link {
+  display: inline; background: none; border: none; padding: 0;
+  color: #888; text-decoration: none; cursor: pointer;
+  font: inherit; transition: color 0.15s;
+}
+.welcome-link:hover { color: #333; }
+.welcome-sep { margin: 0 0.5rem; color: #ddd; }
+
+/* Dark mode overrides for the entry form */
+:root.dark .analyze-input {
+  background: #1e1e2e; color: #cdd6f4; border-color: #313244;
+}
+:root.dark .analyze-input:focus { border-color: #585b70; }
+:root.dark .analyze-input::placeholder { color: #585b70; }
+:root.dark .analyze-submit {
+  background: #cdd6f4; color: #11111b; border-color: #cdd6f4;
+}
+:root.dark .analyze-submit:hover { background: #fff; border-color: #fff; }
+:root.dark .welcome-secondary { color: #585b70; }
+:root.dark .welcome-link { color: #585b70; }
+:root.dark .welcome-link:hover { color: #cdd6f4; }
+:root.dark .welcome-sep { color: #313244; }
+
+/* ── Print (used by the "PDF (via print)" export) ── */
+@media print {
+  @page { size: landscape; margin: 10mm; }
+  body { background: #fff !important; color: #000 !important; }
+  .toolbar, .drop-zone-overlay, .export-menu, .modal-overlay,
+  #pipeline-progress, .welcome-container, #btn-dark, #btn-load,
+  #btn-export, #btn-llm-settings, #btn-onboarding, #series-select,
+  .btn-nav { display: none !important; }
+  .screen { display: block !important; }
+  #grid-container, #analytics-container {
+    page-break-inside: avoid; box-shadow: none !important;
+  }
+  .event-card { break-inside: avoid; }
+}
+
 /* ── Page layout ── */
 .page { max-width: 100%; padding: 1rem; }
 

From 2f68591225af3022dcabf2df8ed3a8f049e44ae4 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Wed, 15 Apr 2026 11:22:51 +0200
Subject: [PATCH 16/24] =?UTF-8?q?feat:=20v2=20scope=20=E2=80=94=20narratol?=
 =?UTF-8?q?ogy=20runtime,=20prompt=20inlining,=20native=20PDF,=20knowledge?=
 =?UTF-8?q?=20move?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

1. Narratology pipeline is now runnable, Python and browser both:
   - src/tvplotlines/narratology.py runs all six passes (context → fabula →
     actants → story → arc → review) and maps results into the existing
     TVPlotlinesResult shape so the viewer renders either system unchanged
   - pipeline.js grows runPipelineNarratology mirroring the Python orchestrator
     (per-episode and per-plotline passes parallelised), and the top-level
     runPipeline dispatches on the user's system choice
   - The "Narratology" option in LLM settings is enabled
2. Viewer prompts are no longer hardcoded. build.py reads every
   prompts/{hollywood,narratology}/*.md at build time and injects them as a
   _PROMPTS object, eliminating drift between source prompts and the viewer
3. Native PDF export — jsPDF is lazy-loaded from CDN and generates a vector
   PDF from the loaded result (title, per-plotline sections with actants/
   story-DNA + event list, episode appendix). Falls back to window.print()
   when offline
4. Knowledge consolidated from 3-resources/tvplotlines/ into
   docs/knowledge/ (decisions, specs, theory, prompting, results,
   v3_narratology evergreens, archive). Personal artifacts stay in place

All 115 tests pass.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 CHANGELOG.md                                  |    7 +-
 docs/knowledge/README.md                      |   22 +
 .../autoresearch-experiment-log.md            |  217 +
 .../autoresearch/autoresearch-program-v2.md   |  231 +
 .../autoresearch/autoresearch-program.md      |  142 +
 .../autoresearch-prompt-experiment-ideas.md   |   54 +
 .../autoresearch/autoresearch-results-v2.tsv  |   15 +
 .../autoresearch/autoresearch-results.tsv     |   40 +
 .../autoresearch/autoresearch-run-v2.md       |   58 +
 .../autoresearch/autoresearch-summary-v2.md   |  111 +
 .../autoresearch-v3-brainstorm-notes.md       |  123 +
 .../autoresearch-v3-engineering-review.md     |  146 +
 .../autoresearch-v3-engineering.md            |   60 +
 .../autoresearch-v3-event-functions.md        |  206 +
 .../autoresearch-v3-hybrid-vs-procedural.md   |   22 +
 .../autoresearch/autoresearch-v3-plan.md      |  165 +
 .../autoresearch/autoresearch-v3-questions.md |  146 +
 .../autoresearch-v3-reading-plan.md           |  169 +
 .../autoresearch/autoresearch-v3-todo.md      |  101 +
 ...26-03-16-prior-season-continuity-design.md |  145 +
 .../2026-03-16-prior-season-continuity.md     |  651 +++
 .../plans/autoresearcher-competence-idea.md   |   44 +
 .../archive/plans/awesome-shortlist.bib       |  152 +
 .../archive/plans/bibliography-cleanup.md     |   72 +
 ...bibliography-narrative-and-autoresearch.md |  136 +
 .../archive/plans/blog-post-guide.md          |   79 +
 docs/knowledge/archive/plans/career-plan.md   |   36 +
 .../archive/plans/design-decisions.md         |  467 ++
 .../archive/plans/docs-audit-2026-03-26.md    |  506 +++
 .../archive/plans/execution-order.md          |  210 +
 .../archive/plans/experiment-arc-functions.md |  123 +
 .../plans/experiment-ru-vs-en-prompts.md      |   22 +
 .../plans/local-model-training-plan.md        |   93 +
 .../knowledge/archive/plans/metrics-survey.md |  154 +
 .../archive/plans/next-session-plan.md        |   67 +
 .../plans/notes-for-3rd-autoresearch.md       |   76 +
 docs/knowledge/archive/plans/one-page.md      |   67 +
 .../plans/open-source-release-checklist.md    |   65 +
 .../archive/plans/open-source-strategy.md     |   48 +
 .../archive/plans/plan-restructure.md         |  479 ++
 .../archive/plans/preprint-citations-map.md   |  228 +
 .../plans/preprint-experiment-scaffold.md     |   87 +
 .../archive/plans/publication-plan.md         |   97 +
 docs/knowledge/archive/plans/readme-draft.md  |  185 +
 .../archive/plans/resources-migration-plan.md |  759 ++++
 .../plans/resources-restructure-design.md     |  188 +
 .../archive/plans/stability-benchmark.md      |  116 +
 .../plans/synthetic-audience-testing.md       |   37 +
 docs/knowledge/archive/plans/tasks-todo.md    |  284 ++
 .../knowledge/archive/plans/what-to-change.md |   35 +
 .../archive/plans/write-synopses-plan.md      |  207 +
 .../decision-001-context-before-extraction.md |   45 +
 .../decision-002-no-internal-state.md         |   40 +
 .../decision-003-abc-classification.md        |   37 +
 .../decision-004-no-language-parameter.md     |   37 +
 ...decision-005-pass3-narratologist-review.md |  150 +
 docs/knowledge/prompting/how-to-prompt.md     |   11 +
 docs/knowledge/prompting/prompt-template.md   |   98 +
 .../prompting/prompt-writing-rules.md         |   38 +
 docs/knowledge/results/bb-s01-result.json     | 1813 ++++++++
 docs/knowledge/results/bb-s02-result.json     | 3194 +++++++++++++
 docs/knowledge/results/bb-s03-result.json     | 3249 +++++++++++++
 docs/knowledge/results/bb-s04-result.json     | 3407 ++++++++++++++
 docs/knowledge/results/bb-s05-result.json     | 4017 +++++++++++++++++
 docs/knowledge/results/breakdown-gdr-s01.md   |  452 ++
 docs/knowledge/results/breakdown-sp-s01.md    |  571 +++
 docs/knowledge/results/breakdown-td-s01.md    |  500 ++
 docs/knowledge/results/run-bb-all-seasons.py  |  137 +
 docs/knowledge/specs/abstract.md              |   31 +
 docs/knowledge/specs/architecture.md          |  246 +
 .../specs/event-functions-redesign.md         |  252 ++
 .../knowledge/specs/heuristics-from-theory.md |  106 +
 docs/knowledge/specs/input-parser-plan.md     |  199 +
 docs/knowledge/specs/inventory.md             |  143 +
 docs/knowledge/specs/mas4bw-library-audit.md  |  102 +
 docs/knowledge/specs/rank-refactor-spec.md    |  102 +
 .../specs/synopsis-authoring-protocol.md      |   65 +
 .../specs/two-function-dimensions.md          |   35 +
 docs/knowledge/specs/what-each-pass-does.md   |   15 +
 .../theory/enculturation-core-idea.md         |   25 +
 docs/knowledge/theory/glossary.md             |  238 +
 docs/knowledge/theory/naive-vs-plotter.md     |   53 +
 .../theory/narrative-intelligence-theory.md   |  206 +
 .../preprint-idea-meta-situation-model.md     |   33 +
 .../screenwriting-theory-reading-prompt.md    |  181 +
 docs/knowledge/v3_narratology/Untitled.md     |   55 +
 .../actant-model-has-six-roles-not-four.md    |   53 +
 ...ti-subject-signals-a-separate-storyline.md |   31 +
 ...emantic-labels-type-narrative-processes.md |   40 +
 ...petence-determines-when-subject-can-act.md |   26 +
 ...-structure-implies-two-actors-per-event.md |   19 +
 ...frontation-type-reveals-plotline-nature.md |   23 +
 .../events-are-transitions-between-states.md  |   19 +
 ...fabula-is-memory-trace-not-authors-plan.md |   18 +
 ...tuation-is-always-a-state-of-deficiency.md |   21 +
 ...cipation-describes-procedural-tv-pilots.md |   26 +
 ...rative-cycle-has-three-phases-not-seven.md |   63 +
 ...g-separates-fabula-time-from-story-time.md |   40 +
 .../suspense-has-four-types-not-one.md        |   29 +
 ...three-criteria-filter-functional-events.md |   33 +
 ...layer-model-separates-text-story-fabula.md |   25 +
 ...th-value-reveals-apparent-vs-real-roles.md |   29 +
 .../balestri-pescatore-2025-icaart.md         |   37 +
 .../balestri-pescatore-2025-memory.md         |   32 +
 .../bibliography-balestri-2025-memory.md      |   61 +
 .../bibliography-balestri-2025.md             |   48 +
 .../bibliography-hamilton-2025.md             |  101 +
 .../v3_narratology/bibliography-keith-2025.md |  117 +
 .../v3_narratology/bibliography-liu-2025.md   |  146 +
 .../films-present-while-novels-assert.md      |   38 +
 ...deep-structure-is-independent-of-medium.md |   29 +
 ...chauvel-2022-narrative-structure-survey.md |   38 +
 .../elkins-2022-shapes-of-stories.md          |   64 +
 .../hamilton-2025-narrabench.md               |   58 +
 ...anonical-script-makes-events-reportable.md |   31 +
 ...what-separates-narrative-from-chronicle.md |   36 +
 ...lements-of-narrative-operate-in-degrees.md |   35 +
 .../constituent-vs-supplementary-events.md    |   33 +
 .../fabula-as-events-plus-causal-matrix.md    |   47 +
 ...ration-transforms-fabula-into-discourse.md |   33 +
 ...arratology-fragmented-into-many-strands.md |   38 +
 ...th-2025-interactive-narrative-analytics.md |   41 +
 .../khan-2025-three-stage-analysis.md         |   32 +
 .../liu-2025-narrative-theory-survey.md       |   38 +
 .../mani-2025-narrative-generative-ai.md      |   38 +
 .../v3_narratology/moc-pipeline-ideas.md      |   57 +
 ...r-networks-model-plot-as-space-not-time.md |   22 +
 ...ins-structural-importance-of-characters.md |   21 +
 ...n-matter-but-are-hard-to-operationalize.md |   25 +
 ...-networks-manufacture-social-obligation.md |   22 +
 ...ti-networks-as-visualization-not-theory.md |   25 +
 .../network-regions-reveal-plot-subsystems.md |   19 +
 ...-law-distribution-in-character-networks.md |   22 +
 ...st-constrainted-by-relational-structure.md |   19 +
 ...ned-by-network-stability-not-centrality.md |   23 +
 ...val-experiments-reveal-structural-roles.md |   28 +
 ...metry-emerges-in-small-chapter-networks.md |   20 +
 .../weak-ties-connect-narrative-regions.md    |   21 +
 .../v3_narratology/narratological-canon.md    |   76 +
 ...icts-turning-points-not-absolute-values.md |   40 +
 ...rative-structure-maps-to-six-components.md |   37 +
 ...ortable-event-is-the-point-of-the-story.md |   30 +
 ...ibutes-and-relations-are-distinct-tasks.md |   28 +
 ...vents-scenes-plotlines-form-a-hierarchy.md |   44 +
 ...ch-universally-fits-narrative-structure.md |   33 +
 ...-elements-define-degrees-of-narrativity.md |   49 +
 ...antana-2022-narrative-extraction-survey.md |   39 +
 ...ence-is-richer-than-three-act-structure.md |   38 +
 ...ative-is-driven-by-knowledge-not-action.md |   44 +
 ...cal-gradation-organizes-event-sequences.md |   32 +
 ...ive-clauses-have-grammar-like-sentences.md |   37 +
 ...rinciples-succession-and-transformation.md |   34 +
 docs/viewer/color-variants.html               |  433 ++
 docs/viewer/decisions.md                      |   48 +
 docs/viewer/plan.md                           |  775 ++++
 docs/viewer/spec.md                           |  154 +
 src/tvplotlines/html/build.py                 |   32 +-
 src/tvplotlines/html/parts/app.js             |    6 +-
 src/tvplotlines/html/parts/export.js          |  119 +-
 src/tvplotlines/html/parts/pipeline.js        | 1153 ++---
 src/tvplotlines/html/parts/shell.html         |    2 +-
 src/tvplotlines/narratology.py                |  532 +++
 src/tvplotlines/pipeline.py                   |   11 +-
 163 files changed, 32827 insertions(+), 822 deletions(-)
 create mode 100644 docs/knowledge/README.md
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-experiment-log.md
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-program-v2.md
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-program.md
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-prompt-experiment-ideas.md
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-results-v2.tsv
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-results.tsv
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-run-v2.md
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-summary-v2.md
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-brainstorm-notes.md
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-engineering-review.md
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-engineering.md
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-event-functions.md
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-hybrid-vs-procedural.md
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-plan.md
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-questions.md
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-reading-plan.md
 create mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-todo.md
 create mode 100644 docs/knowledge/archive/plans/2026-03-16-prior-season-continuity-design.md
 create mode 100644 docs/knowledge/archive/plans/2026-03-16-prior-season-continuity.md
 create mode 100644 docs/knowledge/archive/plans/autoresearcher-competence-idea.md
 create mode 100644 docs/knowledge/archive/plans/awesome-shortlist.bib
 create mode 100644 docs/knowledge/archive/plans/bibliography-cleanup.md
 create mode 100644 docs/knowledge/archive/plans/bibliography-narrative-and-autoresearch.md
 create mode 100644 docs/knowledge/archive/plans/blog-post-guide.md
 create mode 100644 docs/knowledge/archive/plans/career-plan.md
 create mode 100644 docs/knowledge/archive/plans/design-decisions.md
 create mode 100644 docs/knowledge/archive/plans/docs-audit-2026-03-26.md
 create mode 100644 docs/knowledge/archive/plans/execution-order.md
 create mode 100644 docs/knowledge/archive/plans/experiment-arc-functions.md
 create mode 100644 docs/knowledge/archive/plans/experiment-ru-vs-en-prompts.md
 create mode 100644 docs/knowledge/archive/plans/local-model-training-plan.md
 create mode 100644 docs/knowledge/archive/plans/metrics-survey.md
 create mode 100644 docs/knowledge/archive/plans/next-session-plan.md
 create mode 100644 docs/knowledge/archive/plans/notes-for-3rd-autoresearch.md
 create mode 100644 docs/knowledge/archive/plans/one-page.md
 create mode 100644 docs/knowledge/archive/plans/open-source-release-checklist.md
 create mode 100644 docs/knowledge/archive/plans/open-source-strategy.md
 create mode 100644 docs/knowledge/archive/plans/plan-restructure.md
 create mode 100644 docs/knowledge/archive/plans/preprint-citations-map.md
 create mode 100644 docs/knowledge/archive/plans/preprint-experiment-scaffold.md
 create mode 100644 docs/knowledge/archive/plans/publication-plan.md
 create mode 100644 docs/knowledge/archive/plans/readme-draft.md
 create mode 100644 docs/knowledge/archive/plans/resources-migration-plan.md
 create mode 100644 docs/knowledge/archive/plans/resources-restructure-design.md
 create mode 100644 docs/knowledge/archive/plans/stability-benchmark.md
 create mode 100644 docs/knowledge/archive/plans/synthetic-audience-testing.md
 create mode 100644 docs/knowledge/archive/plans/tasks-todo.md
 create mode 100644 docs/knowledge/archive/plans/what-to-change.md
 create mode 100644 docs/knowledge/archive/plans/write-synopses-plan.md
 create mode 100644 docs/knowledge/decisions/decision-001-context-before-extraction.md
 create mode 100644 docs/knowledge/decisions/decision-002-no-internal-state.md
 create mode 100644 docs/knowledge/decisions/decision-003-abc-classification.md
 create mode 100644 docs/knowledge/decisions/decision-004-no-language-parameter.md
 create mode 100644 docs/knowledge/decisions/decision-005-pass3-narratologist-review.md
 create mode 100644 docs/knowledge/prompting/how-to-prompt.md
 create mode 100644 docs/knowledge/prompting/prompt-template.md
 create mode 100644 docs/knowledge/prompting/prompt-writing-rules.md
 create mode 100644 docs/knowledge/results/bb-s01-result.json
 create mode 100644 docs/knowledge/results/bb-s02-result.json
 create mode 100644 docs/knowledge/results/bb-s03-result.json
 create mode 100644 docs/knowledge/results/bb-s04-result.json
 create mode 100644 docs/knowledge/results/bb-s05-result.json
 create mode 100644 docs/knowledge/results/breakdown-gdr-s01.md
 create mode 100644 docs/knowledge/results/breakdown-sp-s01.md
 create mode 100644 docs/knowledge/results/breakdown-td-s01.md
 create mode 100644 docs/knowledge/results/run-bb-all-seasons.py
 create mode 100644 docs/knowledge/specs/abstract.md
 create mode 100644 docs/knowledge/specs/architecture.md
 create mode 100644 docs/knowledge/specs/event-functions-redesign.md
 create mode 100644 docs/knowledge/specs/heuristics-from-theory.md
 create mode 100644 docs/knowledge/specs/input-parser-plan.md
 create mode 100644 docs/knowledge/specs/inventory.md
 create mode 100644 docs/knowledge/specs/mas4bw-library-audit.md
 create mode 100644 docs/knowledge/specs/rank-refactor-spec.md
 create mode 100644 docs/knowledge/specs/synopsis-authoring-protocol.md
 create mode 100644 docs/knowledge/specs/two-function-dimensions.md
 create mode 100644 docs/knowledge/specs/what-each-pass-does.md
 create mode 100644 docs/knowledge/theory/enculturation-core-idea.md
 create mode 100644 docs/knowledge/theory/glossary.md
 create mode 100644 docs/knowledge/theory/naive-vs-plotter.md
 create mode 100644 docs/knowledge/theory/narrative-intelligence-theory.md
 create mode 100644 docs/knowledge/theory/preprint-idea-meta-situation-model.md
 create mode 100644 docs/knowledge/theory/screenwriting-theory-reading-prompt.md
 create mode 100644 docs/knowledge/v3_narratology/Untitled.md
 create mode 100644 docs/knowledge/v3_narratology/bal1988/actant-model-has-six-roles-not-four.md
 create mode 100644 docs/knowledge/v3_narratology/bal1988/anti-subject-signals-a-separate-storyline.md
 create mode 100644 docs/knowledge/v3_narratology/bal1988/bremond-semantic-labels-type-narrative-processes.md
 create mode 100644 docs/knowledge/v3_narratology/bal1988/competence-determines-when-subject-can-act.md
 create mode 100644 docs/knowledge/v3_narratology/bal1988/confrontation-structure-implies-two-actors-per-event.md
 create mode 100644 docs/knowledge/v3_narratology/bal1988/confrontation-type-reveals-plotline-nature.md
 create mode 100644 docs/knowledge/v3_narratology/bal1988/events-are-transitions-between-states.md
 create mode 100644 docs/knowledge/v3_narratology/bal1988/fabula-is-memory-trace-not-authors-plan.md
 create mode 100644 docs/knowledge/v3_narratology/bal1988/initial-situation-is-always-a-state-of-deficiency.md
 create mode 100644 docs/knowledge/v3_narratology/bal1988/iterative-anticipation-describes-procedural-tv-pilots.md
 create mode 100644 docs/knowledge/v3_narratology/bal1988/narrative-cycle-has-three-phases-not-seven.md
 create mode 100644 docs/knowledge/v3_narratology/bal1988/sequential-ordering-separates-fabula-time-from-story-time.md
 create mode 100644 docs/knowledge/v3_narratology/bal1988/suspense-has-four-types-not-one.md
 create mode 100644 docs/knowledge/v3_narratology/bal1988/three-criteria-filter-functional-events.md
 create mode 100644 docs/knowledge/v3_narratology/bal1988/three-layer-model-separates-text-story-fabula.md
 create mode 100644 docs/knowledge/v3_narratology/bal1988/truth-value-reveals-apparent-vs-real-roles.md
 create mode 100644 docs/knowledge/v3_narratology/balestri-pescatore-2025-icaart.md
 create mode 100644 docs/knowledge/v3_narratology/balestri-pescatore-2025-memory.md
 create mode 100644 docs/knowledge/v3_narratology/bibliography-balestri-2025-memory.md
 create mode 100644 docs/knowledge/v3_narratology/bibliography-balestri-2025.md
 create mode 100644 docs/knowledge/v3_narratology/bibliography-hamilton-2025.md
 create mode 100644 docs/knowledge/v3_narratology/bibliography-keith-2025.md
 create mode 100644 docs/knowledge/v3_narratology/bibliography-liu-2025.md
 create mode 100644 docs/knowledge/v3_narratology/chatman1980/films-present-while-novels-assert.md
 create mode 100644 docs/knowledge/v3_narratology/chatman1980/narrative-deep-structure-is-independent-of-medium.md
 create mode 100644 docs/knowledge/v3_narratology/chauvel-2022-narrative-structure-survey.md
 create mode 100644 docs/knowledge/v3_narratology/elkins-2022-shapes-of-stories.md
 create mode 100644 docs/knowledge/v3_narratology/hamilton-2025-narrabench.md
 create mode 100644 docs/knowledge/v3_narratology/herman2009/breach-of-canonical-script-makes-events-reportable.md
 create mode 100644 docs/knowledge/v3_narratology/herman2009/experientiality-is-what-separates-narrative-from-chronicle.md
 create mode 100644 docs/knowledge/v3_narratology/herman2009/four-elements-of-narrative-operate-in-degrees.md
 create mode 100644 docs/knowledge/v3_narratology/huang-usbeck2024/constituent-vs-supplementary-events.md
 create mode 100644 docs/knowledge/v3_narratology/huang-usbeck2024/fabula-as-events-plus-causal-matrix.md
 create mode 100644 docs/knowledge/v3_narratology/huang-usbeck2024/narration-transforms-fabula-into-discourse.md
 create mode 100644 docs/knowledge/v3_narratology/ionescu2019/postclassical-narratology-fragmented-into-many-strands.md
 create mode 100644 docs/knowledge/v3_narratology/keith-2025-interactive-narrative-analytics.md
 create mode 100644 docs/knowledge/v3_narratology/khan-2025-three-stage-analysis.md
 create mode 100644 docs/knowledge/v3_narratology/liu-2025-narrative-theory-survey.md
 create mode 100644 docs/knowledge/v3_narratology/mani-2025-narrative-generative-ai.md
 create mode 100644 docs/knowledge/v3_narratology/moc-pipeline-ideas.md
 create mode 100644 docs/knowledge/v3_narratology/moretti2011/character-networks-model-plot-as-space-not-time.md
 create mode 100644 docs/knowledge/v3_narratology/moretti2011/clustering-explains-structural-importance-of-characters.md
 create mode 100644 docs/knowledge/v3_narratology/moretti2011/edge-weight-and-direction-matter-but-are-hard-to-operationalize.md
 create mode 100644 docs/knowledge/v3_narratology/moretti2011/guanxi-networks-manufacture-social-obligation.md
 create mode 100644 docs/knowledge/v3_narratology/moretti2011/moretti-networks-as-visualization-not-theory.md
 create mode 100644 docs/knowledge/v3_narratology/moretti2011/network-regions-reveal-plot-subsystems.md
 create mode 100644 docs/knowledge/v3_narratology/moretti2011/power-law-distribution-in-character-networks.md
 create mode 100644 docs/knowledge/v3_narratology/moretti2011/protagonist-constrainted-by-relational-structure.md
 create mode 100644 docs/knowledge/v3_narratology/moretti2011/protagonist-defined-by-network-stability-not-centrality.md
 create mode 100644 docs/knowledge/v3_narratology/moretti2011/removal-experiments-reveal-structural-roles.md
 create mode 100644 docs/knowledge/v3_narratology/moretti2011/symmetry-emerges-in-small-chapter-networks.md
 create mode 100644 docs/knowledge/v3_narratology/moretti2011/weak-ties-connect-narrative-regions.md
 create mode 100644 docs/knowledge/v3_narratology/narratological-canon.md
 create mode 100644 docs/knowledge/v3_narratology/ouyang-mckeown2015/change-in-metrics-predicts-turning-points-not-absolute-values.md
 create mode 100644 docs/knowledge/v3_narratology/ouyang-mckeown2015/labov-narrative-structure-maps-to-six-components.md
 create mode 100644 docs/knowledge/v3_narratology/ouyang-mckeown2015/most-reportable-event-is-the-point-of-the-story.md
 create mode 100644 docs/knowledge/v3_narratology/piper-so-bamman2021/character-attributes-and-relations-are-distinct-tasks.md
 create mode 100644 docs/knowledge/v3_narratology/piper-so-bamman2021/events-scenes-plotlines-form-a-hierarchy.md
 create mode 100644 docs/knowledge/v3_narratology/piper-so-bamman2021/no-single-approach-universally-fits-narrative-structure.md
 create mode 100644 docs/knowledge/v3_narratology/piper-so-bamman2021/ten-elements-define-degrees-of-narrativity.md
 create mode 100644 docs/knowledge/v3_narratology/santana-2022-narrative-extraction-survey.md
 create mode 100644 docs/knowledge/v3_narratology/todorov1971/five-part-sequence-is-richer-than-three-act-structure.md
 create mode 100644 docs/knowledge/v3_narratology/todorov1971/gnoseological-narrative-is-driven-by-knowledge-not-action.md
 create mode 100644 docs/knowledge/v3_narratology/todorov1971/ideological-gradation-organizes-event-sequences.md
 create mode 100644 docs/knowledge/v3_narratology/todorov1971/narrative-clauses-have-grammar-like-sentences.md
 create mode 100644 docs/knowledge/v3_narratology/todorov1971/two-principles-succession-and-transformation.md
 create mode 100644 docs/viewer/color-variants.html
 create mode 100644 docs/viewer/decisions.md
 create mode 100644 docs/viewer/plan.md
 create mode 100644 docs/viewer/spec.md
 create mode 100644 src/tvplotlines/narratology.py

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9ef9be3..4c55100 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,9 +3,12 @@
 ## Unreleased
 
 ### Added
+- **Narratology pipeline — runnable**. New module `src/tvplotlines/narratology.py` implements all six passes (context, fabula, actants, story, arc, review). Results are emitted in the existing `TVPlotlinesResult` shape so the HTML viewer renders hollywood and narratology output unchanged. Actants (`who_chases`, `what_they_chase`, `stands_in_the_way`, `who_wins_if_it_works`) map onto `hero`, `goal`, `obstacle`, `stakes`. Pass 5 arc functions land in `Event.plot_fn`. Pass 6 verdicts apply in-place (MERGE/DROP/REASSIGN/REFUNCTION) and reviewed ranks override computed ranks.
+- **Narratology in the browser viewer**. `runPipelineNarratology` in `pipeline.js` mirrors the Python orchestrator, runs all six passes via browser LLM calls (per-episode passes parallelised with `Promise.all`), and produces the same hollywood-compatible shape. `runPipeline` dispatches on the user's system choice. The "Narratology" option in LLM settings is now enabled.
+- **Prompts inlined at build time**. `src/tvplotlines/html/build.py` reads every `prompts/{hollywood,narratology}/*.md` and injects them into the HTML as a `_PROMPTS` object, so the viewer no longer carries a hardcoded copy that could drift from the source.
 - **"Analyze a series" entry flow** in the HTML viewer. Welcome screen now takes a show name + season; the viewer asks the configured LLM for episode synopses, shows them in an editable preview, then runs the normal pipeline. Download the single HTML and you have an end-to-end app. Fallback — drag-and-drop `.txt` synopses — still works.
-- **LLM settings** modal has an "Analysis system" selector (hollywood is live, narratology is disabled with "coming soon" until its pipeline lands in v2).
-- **PDF export** via the browser print stack — "PDF (via print)" menu item calls `window.print()`, and a print stylesheet hides the toolbar and lays the grid out on landscape pages, so Cmd+P → "Save as PDF" produces a usable document.
+- **Native PDF export** via lazy-loaded jsPDF (CDN). Generates a vector PDF directly from the loaded result: title page, per-plotline sections with actant/story-DNA fields and event lists, and an episode-by-episode appendix. Falls back to the browser print stack if the library can't be fetched (offline).
+- **Knowledge consolidated into the repo**. `3-resources/tvplotlines/*` → `docs/knowledge/` with `decisions/` (ADR 001-005), `specs/` (architecture, per-pass specs, mas4bw audit), `theory/`, `prompting/`, `results/` (reference BB S01-S05 outputs), `v3_narratology/` (67 evergreen notes across 9 sources), and `archive/` (old autoresearch + plans). Personal artifacts (the book and friends-post) stay in `3-resources/tvplotlines/`.
 
 ### Changed
 - **Prompt layout**: `prompts_en/` → `prompts/hollywood/`. Added `prompts/narratology/` from the former sister project, bundling eight structuralist prompts (context, fabula, actants, story, arc, review, synopses_writer, glossary). `docs/layered-schema.md` documents the shared `base + layers` JSON.
diff --git a/docs/knowledge/README.md b/docs/knowledge/README.md
new file mode 100644
index 0000000..1fe6b6f
--- /dev/null
+++ b/docs/knowledge/README.md
@@ -0,0 +1,22 @@
+# Knowledge
+
+Reference material for the `tvplotlines` project, consolidated from
+`3-resources/tvplotlines/` on 2026-04-15.
+
+```
+decisions/        — ADRs 001–005, architecture decision records
+specs/            — architecture, inventory, per-pass specs, mas4bw audit
+theory/           — narrative-intelligence framing, glossary, reading prompts
+prompting/        — prompt-writing rules, template, how-to
+results/          — reference Breaking Bad S01–S05 pipeline outputs + breakdown notes
+v3_narratology/   — 67 evergreen notes across 9 sources (Bal, Todorov, Chatman,
+                    Herman, Ouyang & McKeown, Bremond, Greimas, Moretti,
+                    Ionescu, Liu, Mani, Hamilton, Keith) — the theoretical
+                    foundation behind `src/tvplotlines/prompts/narratology/`
+archive/
+  plans/          — old roadmaps, restructure notes, publication plans
+  autoresearch/   — autoresearch-v1/v2/v3 scaffolding and experiment logs
+```
+
+Personal artifacts (the book "Как украсть сериал" and the friends-post)
+intentionally stay in `3-resources/tvplotlines/`.
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-experiment-log.md b/docs/knowledge/archive/autoresearch/autoresearch-experiment-log.md
new file mode 100644
index 0000000..3641ca0
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-experiment-log.md
@@ -0,0 +1,217 @@
+---
+type: note
+project: tvplotlines
+status: active
+---
+
+# Experiment Log
+
+## Experiment 1 (Exp 1): Stronger merge preference + serial 5-6
+**Hypothesis**: Adding "when in doubt, merge" to granularity and tightening serial range to 4-7 (prefer 5-6) would improve ARI.
+**Change**: Modified Russian pass1.md — added merge preference text, changed serial range.
+**Result**: score 0.724, coverage 0.955, ARI 0.758 (baseline 0.797).
+**Analysis**: Merge preference reduced storylines from 7→6 but introduced more naming variance (family/family_destruction/justice). The guidance text itself added ambiguity.
+**Next**: Try language change instead of content change.
+
+## Experiment 2 (Exp 2): Translate Pass 1 prompt to English
+**Hypothesis**: English instructions produce more deterministic LLM output (model trained predominantly on English).
+**Change**: Manually translated pass1.md to English. Synopses remain in Russian.
+**Result**: score 0.895, coverage 0.984, ARI 0.910 (first run). Re-run gave 0.758 — high variance.
+**Analysis**: English prompt showed promise but results were unstable. Led to discovering the existing prompts_en/ directory.
+**Next**: Use the existing English translations properly.
+
+## Experiment 3 (Exp 3): Translate Pass 2 prompt to English
+**Hypothesis**: English Pass 2 would also improve consistency.
+**Change**: Translated pass2.md to English on top of English Pass 1.
+**Result**: score 0.806, coverage 0.985, ARI 0.818.
+**Analysis**: English Pass 2 hurt consistency compared to English Pass 1 alone. The Russian Pass 2 prompt was better calibrated for event assignment.
+**Next**: Keep English Pass 1 only, revert Pass 2.
+
+## Experiment 4 (Exp 4): All prompts English via prompts_en/
+**Hypothesis**: Using the existing English translations with proper lang wiring would be more consistent.
+**Change**: Wired lang parameter through LLMConfig, set default to "en", using prompts_en/ directory.
+**Result**: score 0.824, coverage 0.963, ARI 0.856.
+**Analysis**: Moderate improvement over Russian baseline. Naming changed to compound words (gang_survival, family_destruction).
+**Next**: Constrain naming to prevent compound names.
+
+## Experiment 5 (Exp 5): Enforce single-word storyline names ⭐ BEST
+**Hypothesis**: Compound names (gang_survival, brotherhood_betrayal) vary across runs. Single abstract words are more stable.
+**Change**: In prompts_en/pass1.md, added explicit rule: "Name and id = ONE abstract English word by GOAL. Examples: belonging, leadership, love, redemption, investigation. Do NOT use compound names."
+**Result**: score 0.938 (first run), 0.954 (re-run), coverage 0.947-0.963, ARI 0.991.
+**Analysis**: MASSIVE improvement. All 3 runs produced identical storylines. Single-word names constrain the model's vocabulary to a small set of abstract concepts, eliminating naming variance. This is the single most impactful change.
+**Next**: Try to improve coverage without hurting ARI.
+
+## Experiment 6 (Exp 6): Tighten serial count to 5-8 (aim 6-7)
+**Hypothesis**: Nudging toward 7 storylines would add "brotherhood" and improve coverage.
+**Change**: Changed serial range from "3-8" to "5-8 (aim 6-7)" in prompts_en/pass1.md.
+**Result**: score 0.858, coverage 0.964, ARI 0.890.
+**Analysis**: 7 storylines produced ("justice" + "revenge" replacing "investigation"), but the extra line introduced naming inconsistency. 6 is the natural number for this show.
+**Next**: Focus on Pass 2 instead.
+
+## Experiment 7 (Exp 7): Minimize null assignments in Pass 2
+**Hypothesis**: Adding "minimize nulls" rule would improve coverage.
+**Change**: Added rule 6 to Pass 2: "every event should be assigned, use null only if truly no match."
+**Result**: score 0.859, coverage 0.950, ARI 0.904.
+**Analysis**: The added text perturbed the prompt balance. "justice" appeared instead of "investigation" in one run.
+**Next**: Don't add text to prompts — it adds variance.
+
+## Experiment 8 (Exp 8): Remove three-act structure mention
+**Hypothesis**: "Three-act structure, conflict, causal chain" is vague and could be removed.
+**Change**: Removed line from Story DNA definition in prompts_en/pass1.md.
+**Result**: score 0.724, coverage 0.958, ARI 0.756.
+**Analysis**: The three-act structure line is a POSITIVE constraint. Removing it made the model less precise.
+**Next**: Don't remove text either — the prompt is well-calibrated.
+
+## Experiment 9 (Exp 9): Remove seed/wraparound section
+**Hypothesis**: Seed/wraparound only matter in Pass 2, removing from Pass 1 saves tokens.
+**Change**: Removed "Seed and wraparound — not storyline types" section.
+**Result**: score 0.746, coverage 0.953, ARI 0.783.
+**Analysis**: Another positive constraint — telling the model what NOT to do is valuable.
+**Next**: Try non-prompt changes.
+
+## Experiment 10 (Exp 10): Add merge-preference to English Pass 1
+**Hypothesis**: "When in doubt, merge" was in Russian prompt but missing from English translation.
+**Change**: Added merge-preference text to granularity section.
+**Result**: score 0.699, coverage 0.953, ARI 0.734.
+**Analysis**: Adding ANY text to the Exp 5 prompt breaks the sweet spot. The prompt is highly optimized.
+**Next**: Try LLM settings or model changes.
+
+## Experiment 11 (Exp 11): Increase max_tokens to 16384
+**Hypothesis**: Truncated Pass 2 responses might lose events, reducing coverage.
+**Change**: Changed max_tokens from 8192 to 16384 in llm.py.
+**Result**: score 0.827, coverage 0.964, ARI 0.858.
+**Analysis**: More tokens = more room for variance. The 8192 limit was actually constraining output constructively.
+**Next**: Try model change.
+
+## Experiment 13 (Exp 13): Try Haiku 4.5
+**Hypothesis**: Smaller model might be more deterministic.
+**Change**: Changed default model to claude-haiku-4-5-20251001.
+**Result**: score 0.645, coverage 0.993, ARI 0.649.
+**Analysis**: Haiku produces great coverage but terrible consistency. 8/7/7 storylines with completely different names across runs. Sonnet 4 is clearly better for structured tasks.
+**Next**: Try code-level changes.
+
+## Experiment 12 (Exp 12): Include format field in Pass 1
+**Hypothesis**: format is declared as input but wasn't included in user message.
+**Change**: Added context.format to Pass 1 user_message JSON.
+**Result**: score 0.763, coverage 0.931, ARI 0.819.
+**Analysis**: More data in the prompt = more variance. The model doesn't need format to make good decisions.
+
+## Experiment 14 (Exp 14): Post-process orphan events
+**Hypothesis**: Code-level: assign null-storyline events to most common storyline for their characters.
+**Change**: Added assign_orphan_events() function to postprocess.py, called in pipeline.
+**Result**: score 0.837, coverage 0.994, ARI 0.843.
+**Analysis**: Coverage jumped from 0.963 to 0.994 but ARI dropped from 0.991 to 0.843. The reassignment amplified Run 3's divergence (which had "revenge" instead of "investigation").
+
+## Experiment 15 (Exp 15): Include obstacle/stakes in Pass 2
+**Hypothesis**: More storyline context in Pass 2 would improve event assignment.
+**Change**: Added obstacle and stakes fields to storyline data in Pass 2 user_message.
+**Result**: score 0.867, coverage 0.957, ARI 0.906.
+**Analysis**: All 3 runs had identical storylines but event assignments differed. More information = more ways to reason = less consistency.
+
+## Experiment 18 (Exp 18): Try claude-sonnet-4-6 model
+**Hypothesis**: Newer Sonnet 4.6 may produce more consistent structured output.
+**Change**: Changed default model to claude-sonnet-4-6 in llm.py.
+**Result**: score 0.497, coverage 0.997, ARI 0.498.
+**Analysis**: Sonnet 4.6 has much higher variance — 6/7/7 storylines with completely different names each run. Great coverage but terrible consistency. Sonnet 4 is far better for this task.
+
+## Experiment 19 (Exp 19): Validate max 5% null events in Pass 2
+**Hypothesis**: Rejecting responses with >5% null events forces better assignments.
+**Change**: Added validation in Pass 2 _validate() to reject >5% null events.
+**Result**: score 0.809, coverage 1.000, ARI 0.809.
+**Analysis**: Coverage jumped to 1.000 but ARI dropped — forcing uncertain assignments introduces variance. The retry creates different outputs each time.
+
+## Experiment 20 (Exp 20): Sort cast/storylines by ID in Pass 2
+**Hypothesis**: Alphabetical ordering in Pass 2 user message eliminates ordering variance.
+**Change**: Sorted cast and storylines by ID in both assign_events() and _prepare_bulk().
+**Result**: score 0.809, coverage 0.952, ARI 0.849.
+**Analysis**: Didn't help — the "revenge" vs "investigation" variance is in Pass 1, not Pass 2.
+
+## Experiment 21 (Exp 21): Majority voting on Pass 1 ⭐
+**Hypothesis**: Running Pass 1 three times and picking the most common storyline set eliminates rare outliers.
+**Change**: Added _VOTING_ROUNDS=3 in pass1.py, used call_llm_parallel, pick by Counter(id_sets).most_common.
+**Result**: score 0.963, coverage 0.963, ARI 1.000.
+**Analysis**: PERFECT ARI! All 3 test runs produced identical storylines. Cost increase: ~20% (3 extra LLM calls vs 8 Pass 2 calls). The "revenge" outlier is eliminated by majority vote.
+
+## Experiment 22 (Exp 22): Voting + 10% null validation ⭐
+**Hypothesis**: With ARI 1.000 from voting, a soft null threshold would boost coverage.
+**Change**: Added validation in Pass 2: reject if >10% events have null storyline.
+**Result**: score 0.967, coverage 0.988, ARI 0.979.
+**Analysis**: Coverage jumped from 0.963 to 0.988. ARI slightly decreased from 1.000 to 0.979 — the retry introduces minor variance, but voting keeps it manageable.
+
+## Experiment 23 (Exp 23): Tighten null threshold to 5%
+**Hypothesis**: Tighter threshold would push coverage even higher.
+**Change**: Changed threshold from 10% to 5%.
+**Result**: score 0.823, coverage 1.000, ARI 0.823.
+**Analysis**: Too aggressive — forces too many retries, reintroducing variance. 10% is the sweet spot.
+
+## Experiment 24 (Exp 24): Sort Pass 1 output by ID
+**Hypothesis**: Sorting Pass 1 output would make Pass 2 input deterministic.
+**Change**: Sorted cast and storylines by ID after parsing in extract_storylines().
+**Result**: score 0.962, coverage 0.988, ARI 0.974.
+**Analysis**: No improvement over Exp 22. The small ARI difference is noise.
+
+## Experiment 25 (Exp 25): Majority voting on Pass 0
+**Hypothesis**: Pass 0 context variance might seed Pass 1 differently across runs.
+**Change**: Added 3-round voting to Pass 0 (same approach as Pass 1).
+**Result**: score 0.805, coverage 0.983, ARI 0.819.
+**Analysis**: Didn't help — "revenge" leaked through. Pass 0 variance is not the issue.
+
+## Experiment 26 (Exp 26): 5 voting rounds for Pass 1
+**Hypothesis**: More rounds would make voting more robust.
+**Change**: Changed _VOTING_ROUNDS from 3 to 5 in pass1.py.
+**Result**: score 0.967, coverage 0.988, ARI 0.979.
+**Analysis**: Same score as 3 rounds — the extra cost provides no benefit. 3 rounds is sufficient.
+
+## Experiment 27 (Exp 27): Russian Pass 2 with English Pass 1 ⭐
+**Hypothesis**: Exp 3 showed English Pass 2 hurt vs Russian. Using Russian for Pass 2 only might help.
+**Change**: Created separate config_pass2 with lang="ru" in pipeline.py.
+**Result**: score 0.974, coverage 0.979, ARI 0.995.
+**Analysis**: ARI jumped from 0.979 to 0.995. Russian Pass 2 prompt is better calibrated for event assignment. Best language split: English Pass 1 (naming) + Russian Pass 2 (assignment).
+
+## Experiment 28 (Exp 28): Remove null validation
+**Hypothesis**: Russian Pass 2 might naturally minimize nulls, making validation unnecessary.
+**Change**: Removed the 10% null validation from Pass 2 _validate().
+**Result**: score 0.822, coverage 0.961, ARI 0.856.
+**Analysis**: "revenge" appeared again. The null validation acts as an indirect stabilizer — removing it hurts both coverage AND consistency.
+
+## Experiment 29 (Exp 29): Orphan event assignment ⭐ BEST
+**Hypothesis**: Exp 14 tried this before voting existed and it amplified divergence. With voting stabilizing storylines, orphan assignment should only help.
+**Change**: Added assign_orphan_events() in postprocess.py — assigns null events to most frequent storyline for their characters.
+**Result**: score 0.988, coverage 0.993, ARI 0.995.
+**Analysis**: Coverage jumped from 0.979 to 0.993 with NO ARI loss. The synergy is key: voting eliminates storyline divergence, so orphan assignment is deterministic across runs. Score: 0.581 → 0.988 (70% improvement from baseline).
+
+## Experiment 30 (Exp 30): Reduce max_tokens to 6144 ⭐
+**Hypothesis**: Tighter output limit constrains variance.
+**Change**: max_tokens from 8192 to 6144 in llm.py.
+**Result**: score 0.993, coverage 0.993, ARI 1.000.
+**Analysis**: Perfect ARI. Re-run got 0.858 due to "justice" appearing. Needed Exp 33 to stabilize.
+
+## Experiment 31 (Exp 31): Reduce max_tokens to 4096
+**Hypothesis**: Even tighter limit.
+**Change**: max_tokens from 6144 to 4096.
+**Result**: score 0.886, coverage 0.993, ARI 0.892.
+**Analysis**: Too tight — truncates responses, forces retries with different output.
+
+## Experiment 33 (Exp 33): Prescriptive naming vocabulary ⭐ BEST
+**Hypothesis**: "Choose ONLY from:" is stronger than "Examples:" — eliminates "revenge" and "justice".
+**Change**: Changed naming section from examples to prescriptive vocabulary of 12 words.
+**Result**: score 0.993, coverage 0.993, ARI 1.000 (STABLE across 2 consecutive runs).
+**Analysis**: The model now only picks from the allowed list. "investigation" is the only valid option for the disputed storyline. The remaining 0.7% uncoverage is 1 meta-narrative seed event with no cast characters — legitimately unassignable.
+
+## Key Findings
+
+1. **Constraint is king**: Adding information or options ALWAYS hurt consistency. Removing constraints also hurt. The optimal prompt is a precisely calibrated set of constraints.
+
+2. **Single-word naming was the breakthrough**: Constraining storyline names to one abstract English word eliminated naming variance entirely. ARI went from ~0.85 to 0.991.
+
+3. **Majority voting eliminates remaining Pass 1 variance**: Running Pass 1 3x and picking the majority storyline set achieved ARI 1.000 at ~20% cost increase.
+
+4. **Language split matters**: English Pass 1 (for naming consistency) + Russian Pass 2 (for event assignment quality) is better than all-English or all-Russian.
+
+5. **Code-level post-processing synergizes with voting**: Orphan event assignment failed alone (Exp 14) but works brilliantly with voting (Exp 29) — score 0.988.
+
+6. **Temperature=0 is essential**: The biggest absolute improvement was temperature=0 (ARI 0.595→0.810).
+
+7. **Sonnet 4 > Sonnet 4.6 for structure**: Newer models aren't necessarily more consistent. Sonnet 4.6 had ARI 0.498 vs Sonnet 4's 0.995.
+
+8. **The Exp 5 prompt is a fragile optimum**: Every prompt text perturbation worsened the score. Improvements came from code-level changes (voting, validation, post-processing).
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-program-v2.md b/docs/knowledge/archive/autoresearch/autoresearch-program-v2.md
new file mode 100644
index 0000000..a75cbf5
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-program-v2.md
@@ -0,0 +1,231 @@
+---
+type: note
+project: tvplotlines
+status: active
+---
+
+# tvplotlines autoresearch v2 — multi-show prompt optimization
+
+Автономная оптимизация промптов на диверсифицированном датасете (12 шоу, 7–25 эпизодов, en/ru).
+
+## Отличия от v1
+
+- **v1**: один шоу (Слово пацана, 8 eps), метрика = coverage × ARI (consistency). Оптимизировал стабильность, не качество.
+- **v2**: 12 шоу разных типов/длин, метрика = coverage × Coh−Sep (embedding-based). Оптимизирует качество разделения линий.
+
+## Метрика
+
+**Quality score** = mean across all shows of:
+
+```
+show_score = coverage × max(coh_sep, 0)
+```
+
+Where:
+- **coverage** = fraction of events with non-null storyline (from `metrics.py`)
+- **coh_sep** = within-storyline coherence minus between-storyline separation (from embeddings). Higher = storylines are more distinct from each other.
+
+**Constraint**: min(show_score) ≥ 0.01 — no show may collapse to zero. A change that improves the mean but kills one show is rejected.
+
+**Why not ARI**: ARI measures run-to-run consistency, not quality. A pipeline that consistently produces bad results scores high on ARI. Coh−Sep measures whether extracted storylines are semantically distinct — closer to actual extraction quality.
+
+**Embeddings**: OpenAI `text-embedding-3-small`. Cost: ~$0.002 per show (negligible).
+
+## Dataset
+
+| Show | Code | Eps | Type | Lang |
+|------|------|-----|------|------|
+| Breaking Bad S01 | BB | 7 | serial | en |
+| Слово пацана S01 | SP | 8 | serial | ru |
+| True Detective S01 | TD | 8 | serial | en |
+| GoT S01 | GOT | 10 | ensemble | en |
+| Мажор S01 | MAJOR | 12 | hybrid | ru |
+| ГДР S01 | GDR | 14 | serial | ru |
+| Метод S01 | METOD | 16 | hybrid | ru |
+| This Is Us S01 | TIU | 18 | ensemble | en |
+| House S01 | HOUSE | 22 | procedural | en |
+| CSI S01 | CSI | 23 | procedural | en |
+| ER S01 | ER | 25 | procedural | en |
+| Lost S01 | LOST | 25 | serial/ensemble | en |
+
+Synopses: `/Users/nvashko/Projects/tvplotlines-app/research/synopses/{CODE}_S01E*.txt`
+Results: `/Users/nvashko/Projects/tvplotlines-app/research/results/{code}_s01_result.json`
+
+### Fast set vs full set
+
+Running all 12 shows per experiment is expensive (~$10–15). Use a two-tier approach:
+
+**Fast set (4 shows, ~$3–4)** — for rapid iteration:
+- BB (7 eps, short serial, en) — known good baseline
+- SP (8 eps, short serial, ru) — Russian, known good baseline
+- House (22 eps, long procedural, en) — known problem case
+- Lost (25 eps, long serial/ensemble, en) — new, long non-procedural
+
+Fast set covers: short/long, serial/procedural/ensemble, en/ru. If a change helps on the fast set, validate on the full set.
+
+**Full set (all 12 shows)** — for validation of promising changes only. Run full set when:
+- Fast set score improves by ≥ 0.005
+- Before marking an experiment as `keep`
+
+## Setup
+
+1. **Agree on a run tag**: propose a tag based on today's date (e.g. `mar14`). The branch `autoresearch/<tag>` must not already exist.
+2. **Create the branch**: `git checkout -b autoresearch/<tag>` from current main.
+3. **Read the in-scope files** — read ALL of these before starting:
+   - `CLAUDE.md` — project context and conventions.
+   - `docs/architecture.md` — pipeline architecture.
+   - `src/tvplotlines/prompts/pass0.md` — Pass 0 prompt (context detection).
+   - `src/tvplotlines/prompts/pass1.md` — Pass 1 prompt (storyline extraction).
+   - `src/tvplotlines/prompts/pass2.md` — Pass 2 prompt (event assignment).
+   - `src/tvplotlines/prompts/pass3.md` — Pass 3 prompt (narratologist review).
+   - `src/tvplotlines/prompts_en/pass1.md` — English Pass 1 prompt.
+   - `src/tvplotlines/metrics.py` — metric computation.
+4. **Source environment**: `set -a && source .env && set +a`
+5. **Establish baseline**: Run all 12 shows once, compute scores, record in `results-v2.tsv`.
+6. **Confirm and go**.
+
+## What you CAN modify
+
+- Prompt files: `src/tvplotlines/prompts/pass{0,1,2,3}.md` and `src/tvplotlines/prompts_en/pass{0,1,2,3}.md`
+- Pipeline code: `src/tvplotlines/pass0.py`, `pass1.py`, `pass2.py`, `pass3.py`
+- Post-processing: `src/tvplotlines/postprocess.py`, `verdicts.py`
+- Orchestration: `src/tvplotlines/pipeline.py`
+- LLM settings: `src/tvplotlines/llm.py` — model, temperature, max_tokens
+
+## What you CANNOT modify
+
+- Metric computation script: `research/compute_embedding_metrics.py`
+- Synopsis files: `research/synopses/`
+- The scoring formula defined in this document
+
+## Running an experiment
+
+### Step 1: Run pipeline on shows
+
+```bash
+# Fast set (4 shows)
+set -a && source .env && set +a
+
+tvplotlines run /Users/nvashko/Projects/tvplotlines-app/research/synopses/BB_S01E*.txt \
+  --show "Breaking Bad" --season 1 --lang en --pass2-mode batch \
+  -o /Users/nvashko/Projects/tvplotlines-app/research/results/bb_s01_result.json
+
+tvplotlines run /Users/nvashko/Projects/tvplotlines-app/research/synopses/SP_S01E*.txt \
+  --show "Слово пацана" --season 1 --lang ru --pass2-mode batch \
+  -o /Users/nvashko/Projects/tvplotlines-app/research/results/slovo_patsana_s01_result.json
+
+tvplotlines run /Users/nvashko/Projects/tvplotlines-app/research/synopses/HOUSE_S01E*.txt \
+  --show "House" --season 1 --lang en --pass2-mode batch \
+  -o /Users/nvashko/Projects/tvplotlines-app/research/results/house_s01_result_v2.json
+
+tvplotlines run /Users/nvashko/Projects/tvplotlines-app/research/synopses/LOST_S01E*.txt \
+  --show "Lost" --season 1 --lang en --pass2-mode batch \
+  -o /Users/nvashko/Projects/tvplotlines-app/research/results/lost_s01_result.json
+```
+
+Run shows in parallel when possible (background jobs or separate terminals).
+
+### Step 2: Compute metrics
+
+```bash
+cd /Users/nvashko/Projects/tvplotlines-app/research
+python3 compute_embedding_metrics.py
+```
+
+### Step 3: Record results
+
+Log to `results-v2.tsv`:
+
+```
+commit	mean_score	min_score	bb	sp	house	lost	cost_usd	status	description
+```
+
+For full-set runs, add all 12 columns.
+
+## Experiment priorities
+
+### Primary target: Pass 1 prompt for long seasons
+
+The data shows Pass 1 undersegments long seasons (22+ eps → 4 storylines instead of 6–8). Hypotheses:
+
+1. **Season length awareness**: Add instruction that longer seasons typically have more storylines (5–8 for 20+ episodes vs 3–5 for 8 episodes).
+2. **Short arc recognition**: Explicitly describe multi-episode arcs that span 3–6 episodes as valid serialized storylines, not just full-season ones.
+3. **Franchise engine isolation**: In procedurals, ensure the episodic line doesn't absorb serialized sub-arcs.
+4. **Ensemble vs procedural scaling**: Ensemble shows naturally have more parallel storylines. Procedurals may also have them but the prompt currently discourages it.
+5. **Worked examples**: Add a long-season example (e.g. ER) to the prompt alongside the existing Breaking Bad example.
+
+### Secondary: Pass 2 assignment quality
+
+Even with correct Pass 1 extraction, Pass 2 may assign events to wrong storylines. This shows up as low Coh−Sep even when the right number of storylines exist.
+
+### Tertiary: Pass 3 verdicts
+
+Pass 3 may DROP valid short arcs or fail to CREATE missing ones. Test with skip_review=True vs False.
+
+## The experiment loop
+
+LOOP FOREVER:
+
+1. Check git state and `results-v2.tsv` — what's been tried, what worked.
+2. Pick the next experiment. One change per experiment — isolate variables.
+3. Edit prompt(s) and/or pipeline code.
+4. `git commit` the change.
+5. Run fast set (4 shows). Compute metrics.
+6. If fast set score improved by ≥ 0.005:
+   - Run full set (all 12 shows). Compute metrics.
+   - If full set score improved AND min_score ≥ 0.01 → keep.
+   - Otherwise → revert.
+7. If fast set score did not improve → revert.
+8. Record all results in `results-v2.tsv`.
+9. `git reset --hard HEAD~1` to revert discarded experiments.
+
+**NEVER STOP**: Once the loop begins, do NOT pause to ask the human. The human might be asleep or away and expects you to continue working indefinitely until manually stopped. If you run out of ideas, reread the prompts, try combining near-misses, try radical changes.
+
+## Cost optimization
+
+Use `--pass2-mode batch` for all autoresearch runs. Batch API is 50% cheaper on Pass 2 (the most expensive pass — N episodes × LLM call). System prompt caching is automatic in both modes.
+
+| Mode | Per show (22 eps) | Fast set (4 shows) | Full set (12 shows) |
+|------|-------------------|--------------------|--------------------|
+| parallel + cache | ~$0.65 | ~$3–4 | ~$8–12 |
+| **batch + cache** | **~$0.35** | **~$1.5–2** | **~$4–5** |
+
+Batch mode is slower (~2–5 min polling) but for autoresearch speed is less important than cost.
+
+## Cost budget
+
+- Fast set: ~$1.5–2 per experiment
+- Full set: ~$4–5 per experiment
+- Embeddings: ~$0.02 per experiment (negligible)
+- Expected: ~4–6 experiments per hour (fast set only), ~2 per hour (with full validation)
+- **HARD LIMIT: $30 total.** Track cumulative cost in results-v2.tsv. When cumulative cost approaches $28, stop and summarize findings. Do NOT exceed $30.
+
+## Baseline reference (before optimization)
+
+From current results:
+
+| Show | Eps | Lines | Coh−Sep | Coverage |
+|------|-----|-------|---------|----------|
+| Breaking Bad S01 | 7 | 4 | 0.083 | 0.97 |
+| GoT S01 | 10 | 8 | 0.077 | 1.00 |
+| Slovo Patsana S01 | 8 | 7 | 0.077 | 0.97 |
+| GDR S01 | 14 | 5 | 0.069 | 1.00 |
+| ER S01 | 25 | 8 | 0.037 | 1.00 |
+| True Detective S01 | 8 | 4 | 0.024 | 1.00 |
+| House S01 | 22 | 4 | 0.002 | 0.98 |
+| CSI S01 | 23 | 4 | −0.004 | 1.00 |
+
+Mean score (coverage × max(coh_sep, 0)): ~0.043
+Min score: 0.0 (CSI — negative coh_sep)
+
+The gap between short shows (~0.08) and long procedurals (~0.00) is the primary optimization target.
+
+## Strategy notes
+
+- **Coh−Sep is the bottleneck for long shows.** Coverage is already high everywhere.
+- Long seasons produce too few storylines → all events blend together → low coherence, no separation.
+- Focus on Pass 1 instructions that scale storyline count with season length.
+- Be careful not to over-generate storylines for short shows — verify on fast set.
+- If a change helps House/CSI but hurts BB/SP, it's rejected (min constraint).
+- Prompts exist in two languages (ru + en). Changes must be applied to both.
+- Theoretical grounding matters: changes should be defensible from narrative theory, not ad-hoc rules.
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-program.md b/docs/knowledge/archive/autoresearch/autoresearch-program.md
new file mode 100644
index 0000000..049a2c4
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-program.md
@@ -0,0 +1,142 @@
+---
+type: note
+project: tvplotlines
+status: active
+---
+
+# tvplotlines autoresearch
+
+Автономная оптимизация пайплайна извлечения сюжетных линий.
+
+## Setup
+
+1. **Agree on a run tag**: propose a tag based on today's date (e.g. `mar11`). The branch `autoresearch/<tag>` must not already exist.
+2. **Create the branch**: `git checkout -b autoresearch/<tag>` from current main.
+3. **Read the in-scope files** — read ALL of these before starting, do not skip any:
+   - `CLAUDE.md` — project context and conventions.
+   - `md/architecture.md` — pipeline architecture.
+   - `md/prompt-experiment-ideas.md` — experiment hypotheses (H1–H14).
+   - `src/tvplotlines/prompts/pass0.md` — Pass 0 prompt (context detection).
+   - `src/tvplotlines/prompts/pass1.md` — Pass 1 prompt (storyline extraction).
+   - `src/tvplotlines/prompts/pass2.md` — Pass 2 prompt (event assignment).
+   - `src/tvplotlines/prompts/pass3.md` — Pass 3 prompt (narratologist review).
+   - `src/tvplotlines/metrics.py` — metric computation (read-only).
+   - `tests/fixtures/slovo_patsana_s01_consistency.json` — current baseline.
+4. **Source environment**: `set -a && source .env && set +a` — this loads the API key. Ensure it's sourced before every run.
+5. **Initialize results.tsv**: Create `results.tsv` with header row. Baseline will be the first entry.
+6. **Confirm and go**.
+
+## Experimentation
+
+Each experiment = modify prompts and/or pipeline code → run N pipeline passes → compute score.
+
+**What you CAN modify:**
+- Prompt files: `src/tvplotlines/prompts/pass{0,1,2,3}.md` — role formulations, step structure, strictness criteria, examples, wording.
+- Pipeline code: `src/tvplotlines/pass0.py`, `pass1.py`, `pass2.py`, `pass3.py` — parsing, validation, data preparation, what gets sent to LLM.
+- Post-processing: `src/tvplotlines/postprocess.py`, `verdicts.py` — span/weight computation, verdict application.
+- Orchestration: `src/tvplotlines/pipeline.py` — pass ordering, what data flows between passes.
+- LLM settings: `src/tvplotlines/llm.py` — model name, temperature, max_tokens. These are experiment parameters too.
+
+**What you CANNOT modify** (fixed evaluation — otherwise optimization is meaningless):
+- Metric code: `src/tvplotlines/metrics.py` — the scoring function.
+- Test harness: `tests/test_consistency.py` — how experiments are run.
+- Test fixtures: `tests/fixtures/` — input data.
+
+**Cost** is a soft constraint. Some increase is acceptable for meaningful score gains, but it should not blow up dramatically. A 10% score improvement that doubles cost? Worth considering. The same score at half the cost? Definitely keep. The `cost_usd` column in results.tsv tracks this — use it to compare experiments.
+
+**The goal:** The pipeline takes TV series synopses and extracts storylines — narrative threads that span multiple episodes. A good result means:
+- **High coverage** — every narrative event in a synopsis is assigned to a storyline (not left orphaned).
+- **High consistency** — running the pipeline twice on the same input gives structurally the same storylines. Different wording is fine ("belonging" vs "acceptance"), but the same characters should end up grouped together.
+
+Currently measured as `score = coverage × consistency(ARI)` — see `metrics.py` for details. This may not be the optimal way to measure quality; if you see problems with the metric, document them in `metric-concerns.md` but do not modify `metrics.py` during experiments.
+
+Current baseline: score **0.581** (coverage 0.977, ARI 0.595). Run without Pass 3 review.
+
+**Simplicity criterion**: All else being equal, simpler is better — shorter prompts, less code. If removing text or code gives equal or better results — keep. A 0.01 score improvement that adds 50 lines of complexity? Probably not worth it. A 0.01 improvement from simplifying? Definitely keep.
+
+**The first run**: Establish baseline with current prompts (should match the stored baseline).
+
+## Running an experiment
+
+Each experiment requires N independent pipeline runs (N=3 minimum) to compute consistency.
+
+```bash
+python -m pytest tests/test_consistency.py -v -s > run.log 2>&1
+```
+
+Extract results:
+
+```bash
+grep -E "^(Avg coverage|Consistency|Score):" run.log
+```
+
+Expected output:
+
+```
+Avg coverage: 0.977
+Consistency (ARI): 0.595
+Score: 0.581
+```
+
+**Time budget**: Each experiment takes ~10 minutes (3 runs × ~3 minutes each). If a run exceeds 20 minutes, kill it (`kill %1` or `kill <PID>`) and treat it as a crash — log, revert, move on.
+
+**Cost**: Each experiment costs ~$1–3 (API calls). Budget accordingly.
+
+## Logging results
+
+Log to `results.tsv` (tab-separated).
+
+Header and columns:
+
+```
+commit	score	coverage	consistency	cost_usd	status	description
+```
+
+1. git commit hash (short, 7 chars)
+2. score = coverage × consistency (e.g. 0.581)
+3. coverage (e.g. 0.977)
+4. consistency ARI (e.g. 0.595)
+5. approximate cost in USD (e.g. 1.5)
+6. status: `keep`, `discard`, or `crash`
+7. short description of what changed
+
+Example:
+
+```
+commit	score	coverage	consistency	cost_usd	status	description
+a1b2c3d	0.581	0.977	0.595	1.5	keep	baseline
+b2c3d4e	0.640	0.980	0.653	1.8	keep	H13: fewer theory quotes in pass1
+c3d4e5f	0.550	0.990	0.556	1.5	discard	H7: free-form pass3 prompt
+d4e5f6g	0.000	0.000	0.000	0.0	crash	H5: no role in pass3 (validation errors)
+```
+
+## The experiment loop
+
+LOOP FOREVER:
+
+1. Look at the git state and `results.tsv` — what's been tried, what worked.
+2. Pick the next experiment. Use `md/prompt-experiment-ideas.md` as inspiration, but you can also try your own ideas. Prioritize:
+   - Hypotheses that affect Pass 1–2 (larger impact on consistency).
+   - Hypotheses that simplify prompts (cheaper per run).
+   - Combining two previous near-wins.
+3. Edit prompt(s) and/or pipeline code. One change per experiment — isolate variables.
+4. `git commit` the change.
+5. Run: `python -m pytest tests/test_consistency.py -v -s > run.log 2>&1`
+6. Extract: `grep -E "^(Avg coverage|Consistency|Score):" run.log`
+7. If grep is empty, the run crashed. Check `tail -n 50 run.log` and attempt a fix.
+8. Record results in `results.tsv` (do NOT commit results.tsv — leave untracked).
+9. If score improved → keep the commit, advance the branch.
+10. If score is equal or worse → `git reset --hard HEAD~1` to revert.
+
+**Crashes**: If validation errors consistently fail, the prompt change broke structural output. Revert and try a different approach.
+
+**NEVER STOP**: Once the loop begins, do NOT pause to ask the human. Do NOT ask "should I keep going?" or "is this a good stopping point?". The human might be asleep or away and expects you to continue working *indefinitely* until manually stopped. Each experiment takes ~10 minutes, so you can run ~6 per hour, ~50 overnight. If you run out of hypotheses from the list, think harder — reread the prompts, try combining near-misses, try radical changes. The loop runs until the human interrupts you, period.
+
+## Strategy notes
+
+- **ARI is the bottleneck** (0.595). Coverage is already high (0.977). Focus on consistency.
+- Consistency improves when the LLM makes the same *structural* decisions across runs — same grouping of characters into storylines.
+- Things that help consistency: concrete rules > vague guidelines, examples > theory, constrained output > free-form.
+- Things that hurt consistency: subjective criteria, open-ended instructions, ambiguous categories.
+- Pass 3 currently runs with `skip_review=True` in the consistency test. To test Pass 3 prompt changes, update the test to include Pass 3. But note: Pass 3 adds another LLM call = more variance. Test it both ways.
+- If you plateau on ARI, consider testing with a different show/season to verify generalization.
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-prompt-experiment-ideas.md b/docs/knowledge/archive/autoresearch/autoresearch-prompt-experiment-ideas.md
new file mode 100644
index 0000000..e8237c6
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-prompt-experiment-ideas.md
@@ -0,0 +1,54 @@
+---
+type: note
+project: tvplotlines
+status: active
+---
+
+# Гипотезы для тестирования промптов
+
+Формулировки и структурные решения, которые нужно проверить через autoresearch-цикл. Каждая гипотеза — изменение в одном промпте, измеряется через `score = coverage × consistency`.
+
+## Pass 3: роль
+
+| # | формулировка | гипотеза |
+|---|---|---|
+| H1 | «Ты — нарратолог, ревизор сюжетной структуры» | Базовая |
+| H2 | «Ты — нарратолог, специалист по сериальной драматургии» | Акцент на экспертизу, а не на проверку — может дать более глубокий анализ |
+| H3 | «Ты — редактор сценарного отдела» | Индустриальная роль — может быть практичнее теоретика |
+| H4 | «Ты — шоураннер, проверяющий работу райтерз-рума» | Максимальный авторитет — может давать более решительные вердикты |
+| H5 | Без указания роли, только задача | Контрольная группа — роль вообще не нужна? |
+
+## Pass 3: структура промпта
+
+| # | вариант | гипотеза |
+|---|---|---|
+| H6 | Пошаговые инструкции (текущий: 7 шагов, 188 строк) | Структурированная проверка — ничего не пропустит |
+| H7 | Свободная форма: «оцени результат и предложи исправления» | Меньше ограничений — LLM сам решает на что смотреть |
+| H8 | Чеклист вопросов вместо шагов | Промежуточный вариант |
+| H8a | Укороченный: убрать шаги 4 (ранги) и 6 (патчи) — код и так делает | Меньше шум, LLM фокусируется на главном |
+| H8b | Минимальный: только роль + формат выхода, без шагов вообще | LLM-нарратолог сам знает на что смотреть? |
+
+## Pass 3: строгость критериев
+
+| # | вариант | гипотеза |
+|---|---|---|
+| H9 | Строгие критерии: нет Story DNA → DROP | Чистый результат, но потеря слабых линий плохо написанных сериалов |
+| H10 | Мягкие критерии: нет Story DNA → partial/inferred (текущий) | Сохраняет данные, но может оставлять шум |
+| H11 | Адаптивные: строгость зависит от franchise_type | Procedural строже (чёткая формула), ensemble мягче |
+
+## Pass 1-2: общие
+
+| # | вариант | гипотеза |
+|---|---|---|
+| H12 | Больше worked examples в промпте | Улучшит consistency (LLM видит паттерн) |
+| H13 | Меньше теории, больше правил | Улучшит consistency (меньше интерпретации) |
+| H14 | Цитаты из книг в промпте vs без них | Цитаты добавляют авторитет или шум? |
+
+## Как тестировать
+
+Одна гипотеза = один эксперимент в autoresearch-цикле:
+1. Изменить одну переменную в промпте
+2. Прогнать N раз (минимум 3)
+3. Вычислить score = coverage × consistency
+4. Сравнить с базовым score
+5. Keep / discard
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-results-v2.tsv b/docs/knowledge/archive/autoresearch/autoresearch-results-v2.tsv
new file mode 100644
index 0000000..954e1f8
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-results-v2.tsv
@@ -0,0 +1,15 @@
+commit	mean_score	min_score	bb	sp	house	lost	cost_usd	cumulative_cost	status	description
+b6b2d39	0.0563	0.0049	0.0881	0.0591	0.0049	0.0731	2.0	2.0	baseline	Baseline: voting+orphans+single-word+max_tokens=6144
+79d6361	0.0511	0.0001	0.0486	0.0817	0.0001	0.0739	2.0	4.0	discard	v2-01: season-length scaling + short-arc guidance in Pass 1
+aeefc42	0.0554	0.0036	0.0960	0.0570	0.0036	0.0652	2.0	6.0	discard	v2-02: procedural vs serialized assignment rule in Pass 2
+-	0.0586	0.0029	0.0830	0.0740	0.0029	0.0746	1.1	7.1	discard	v2-03: skip Pass 3 (narratologist review)
+13323c3	0.0490	0.0032	0.0797	0.0630	0.0032	0.0503	1.4	8.5	discard	v2-04: increase procedural storyline count (3-6 serialized per season)
+67214c7	0.0580	0.0000	0.0908	0.0819	0.0043	0.0814	4.5	13.0	keep	v2-05: event description specificity guidance in Pass 2 (full set validated)
+40be052	0.0548	0.0048	0.0753	0.0780	0.0048	0.0611	1.2	14.2	discard	v2-06: tie event descriptions to storyline goal (worse than v2-05)
+68ff8a1	0.0541	0.0066	0.0720	0.0817	0.0066	0.0561	1.5	15.7	discard	v2-07: limit events to 8-15 per episode (House+, BB/Lost-)
+94d0e00	0.0618	0.0061	0.0879	0.0818	0.0061	0.0715	1.8	17.5	discard	v2-08: Pass 3 oversized storyline check (House+0.002, Lost-0.01)
+c713445	0.0624	0.0086	0.0867	0.0814	0.0086	0.0728	1.8	19.3	discard	v2-09: Driver:Theme naming for all storylines (House+0.004, Lost-0.009)
+9cbc2c8	0.0588	0.0042	0.0819	0.0840	0.0146	0.0810	4.0	23.3	keep	v2-10: specificity + Driver:Theme naming (full set: House 3x, ER 2x, CSI out of zero)
+3f1e663	0.0605	0.0086	0.0857	0.0682	0.0086	0.0796	1.4	24.7	discard	v2-11: + Pass 3 oversized check (House regressed, SP dropped)
+-	0.0655	0.0044	0.0931	0.0867	0.0044	0.0777	1.0	25.7	discard	v2-12: skip-review on v2-10 (House 0.0146→0.0044, Pass 3 helps House)
+-	-	-	-	-	-	-	2.0	27.7	-	Restore fast set to v2-10 final state
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-results.tsv b/docs/knowledge/archive/autoresearch/autoresearch-results.tsv
new file mode 100644
index 0000000..d42fa03
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-results.tsv
@@ -0,0 +1,40 @@
+commit	score	coverage	consistency	cost_usd	status	description
+8fc9ce5	0.641	0.979	0.655	1.5	keep	baseline
+0e2977f	0.310	0.957	0.324	1.5	discard	H13: less theory, merge-when-in-doubt in pass1
+e2a52c1	0.797	0.984	0.810	1.5	keep	temperature=0 for all LLM calls
+6a4c23b	0.724	0.955	0.758	1.5	discard	Exp 1: stronger merge preference + serial 5-6
+315561a	0.895	0.984	0.910	1.5	keep	Exp 2: translate Pass 1 prompt to English
+e9434c0	0.806	0.985	0.818	1.5	discard	Exp 3: translate Pass 2 prompt to English (on top of Pass 1 EN)
+4155cf8	0.824	0.963	0.856	1.5	keep	Exp 4: all prompts English (via prompts_en/)
+efb780f	0.938	0.947	0.991	1.5	keep	Exp 5: enforce single-word storyline names
+63cb79e	0.858	0.964	0.890	1.5	discard	Exp 6: tighten serial count to 5-8 (aim 6-7)
+ad18df7	0.859	0.950	0.904	1.5	discard	Exp 7: minimize null assignments in Pass 2
+dff2b70	0.724	0.958	0.756	1.5	discard	Exp 8: remove three-act structure mention
+9980dd9	0.746	0.953	0.783	1.5	discard	Exp 9: remove seed/wraparound section from Pass 1
+6e464a2	0.699	0.953	0.734	1.5	discard	Exp 10: add merge-preference to Pass 1 EN
+b37ba62	0.827	0.964	0.858	1.5	discard	Exp 11: increase max_tokens to 16384
+fb16a1b	0.763	0.931	0.819	1.5	discard	Exp 12: include format field in Pass 1
+098b0a7	0.645	0.993	0.649	0.5	discard	Exp 13: try Haiku 4.5 (fast but inconsistent)
+07d4b84	0.837	0.994	0.843	1.5	discard	Exp 14: orphan event assignment by character affinity
+569a5e5	0.867	0.957	0.906	1.5	discard	Exp 15: include obstacle/stakes in Pass 2
+0d4dbf2	0.887	0.950	0.933	1.5	discard	Exp 16: sort Pass 1 output by ID
+325b7f3	0.872	0.969	0.900	1.5	discard	Exp 17: expand naming word list to 15 words
+91d9506	0.497	0.997	0.498	1.5	discard	Exp 18: try claude-sonnet-4-6 model
+365a3ab	0.809	1.000	0.809	1.5	discard	Exp 19: validate max 5% null events in Pass 2
+83d0ce0	0.809	0.952	0.849	1.5	discard	Exp 20: sort cast/storylines by ID in Pass 2
+239d125	0.963	0.963	1.000	1.5	keep	Exp 21: majority voting on Pass 1 (3 rounds)
+82a3c19	0.967	0.988	0.979	1.5	keep	Exp 22: voting + 10% max null validation in Pass 2
+ddeab0b	0.823	1.000	0.823	1.5	discard	Exp 23: tighten null threshold to 5%
+16aa5a1	0.962	0.988	0.974	1.5	discard	Exp 24: sort Pass 1 output by ID
+d4bef13	0.805	0.983	0.819	1.5	discard	Exp 25: majority voting on Pass 0
+51841bb	0.967	0.988	0.979	1.5	discard	Exp 26: 5 voting rounds (same score, more costly)
+d5dd616	0.974	0.979	0.995	1.5	keep	Exp 27: Russian Pass 2 + English Pass 1
+8b2b09d	0.822	0.961	0.856	1.5	discard	Exp 28: remove null validation
+170b18d	0.988	0.993	0.995	1.5	keep	Exp 29: orphan event assignment (voting stabilizes)
+97f76a1	0.993	0.993	1.000	1.5	keep	Exp 30: reduce max_tokens to 6144
+dcfc7f0	0.886	0.993	0.892	1.5	discard	Exp 31: reduce max_tokens to 4096
+362c6f0	0.858	0.993	0.864	1.5	discard	Exp 32: iterative orphan assignment
+b516ba6	0.993	0.993	1.000	1.5	keep	Exp 33: prescriptive naming vocabulary (stable, 2 runs)
+ab16eda	1.000	1.000	1.000	1.5	keep	Exp 34: fallback orphan to episode's most common storyline
+233e177	0.834	1.000	0.834	1.5	keep	Universal only: voting + null validation + orphans + max_tokens 6144
+1bc787b	0.880	0.998	0.882	1.5	keep	Remove 'English' from naming rule
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-run-v2.md b/docs/knowledge/archive/autoresearch/autoresearch-run-v2.md
new file mode 100644
index 0000000..5ea8aab
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-run-v2.md
@@ -0,0 +1,58 @@
+---
+type: note
+project: tvplotlines
+status: active
+---
+
+# Task: tvplotlines autoresearch v2
+
+You are an autonomous prompt optimization agent. Your job is to improve tvplotlines's storyline extraction quality on procedural TV shows (House, CSI, ER) without degrading quality on other show types.
+
+## Step 1: Read the program
+
+Read `/Users/nvashko/Projects/tvplotlines-app/research/autoresearch/program-v2.md` — it contains the full protocol: dataset, metric, constraints, experiment loop, cost limits.
+
+## Step 2: Read all in-scope files listed in the program's Setup section
+
+Read every file listed there. Do not skip any.
+
+Also read the previous experiment results:
+- `/Users/nvashko/Projects/tvplotlines-app/research/autoresearch/results.tsv` — 40 previous experiments from v1.
+- `/Users/nvashko/Projects/tvplotlines-app/research/autoresearch/prompt-experiment-ideas.md` — hypotheses H1–H14.
+
+Study what was already tried and what worked. Do NOT repeat experiments that were already run. Build on top of what worked (voting, single-word naming, orphan assignment, temperature=0, max_tokens=6144).
+
+## Step 3: Establish baseline
+
+Run the fast set (BB, SP, House, Lost) with current prompts. Compute embedding metrics using `python3 /Users/nvashko/Projects/tvplotlines-app/research/compute_embedding_metrics.py`. Record baseline in `results-v2.tsv`.
+
+## Step 4: Run the experiment loop
+
+Follow the loop described in program-v2.md. Key rules:
+- One change per experiment — isolate variables.
+- Use `--pass2-mode batch` for all runs to save cost.
+- Track cumulative cost. HARD LIMIT: $30 total. Stop at $28.
+- Source .env before every run: `set -a && source /Users/nvashko/Projects/tvplotlines/.env && set +a`
+- Run shows in parallel (background jobs) when possible.
+- Focus on Pass 1 prompt changes that help procedurals without hurting serials.
+- Prompts exist in TWO languages. Every prompt change must be applied to BOTH:
+  - Russian: `src/tvplotlines/prompts/pass{0,1,2,3}.md`
+  - English: `src/tvplotlines/prompts_en/pass{0,1,2,3}.md`
+  Russian shows (SP, GDR, Метод, Мажор) use Russian prompts, English shows use English prompts. If you change only one language, half the dataset won't see the change.
+- git commit each experiment before running.
+- Revert with `git reset --hard HEAD~1` if score drops.
+
+## Step 5: When done
+
+When you hit the cost limit or run out of ideas:
+1. Summarize all experiments and findings in `results-v2.tsv`.
+2. Write a short summary to `/Users/nvashko/Projects/tvplotlines-app/research/autoresearch/summary-v2.md`: what worked, what didn't, best score achieved, recommended next steps.
+3. Do NOT push to remote. Leave changes on the branch.
+
+## Important
+
+- NEVER modify `compute_embedding_metrics.py` or synopsis files.
+- NEVER ask the human for input. Work autonomously until the cost limit.
+- NEVER stop early. If you plateau, try radical changes, combinations, or different passes.
+- The working directory is `/Users/nvashko/Projects/tvplotlines`.
+- Synopsis and result files are in `/Users/nvashko/Projects/tvplotlines-app/research/`.
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-summary-v2.md b/docs/knowledge/archive/autoresearch/autoresearch-summary-v2.md
new file mode 100644
index 0000000..6285c19
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-summary-v2.md
@@ -0,0 +1,111 @@
+---
+type: note
+project: tvplotlines
+status: active
+---
+
+# Autoresearch v2 — Summary
+
+## Setup
+
+- **Date**: 2026-03-14
+- **Branch**: `autoresearch/mar14`
+- **Metric**: `score = coverage × max(coh_sep, 0)` where coh_sep = within-storyline coherence minus between-storyline separation (embedding-based)
+- **Dataset**: 12 shows, fast set (BB, SP, House, Lost) for iteration, full set for validation
+- **Budget**: $30 hard limit, spent ~$27.7
+- **12 experiments** run (2 kept, 10 discarded)
+
+## Baseline
+
+| Show | Eps | Lines | Coh-Sep | Score |
+|------|-----|-------|---------|-------|
+| This Is Us | 18 | 7 | 0.1111 | best |
+| Breaking Bad | 7 | 5 | 0.0881 | good |
+| GoT | 10 | 8 | 0.0768 | good |
+| Lost | 25 | 10 | 0.0731 | good |
+| GDR | 14 | 5 | 0.0687 | ok |
+| Слово пацана | 8 | 6 | 0.0591 | ok |
+| Метод | 16 | 6 | 0.0561 | ok |
+| Мажор | 12 | 6 | 0.0371 | low |
+| ER | 25 | 8 | 0.0366 | low |
+| True Detective | 8 | 4 | 0.0240 | low |
+| House | 22 | 4 | 0.0049 | very low |
+| CSI | 23 | 4 | -0.0037 | zero |
+
+**Baseline mean: 0.0530**. Procedurals (House, CSI, ER) are the clear bottleneck.
+
+## Best result: v2-10 (specificity + Driver:Theme naming)
+
+Two changes kept:
+
+### 1. Event description specificity (v2-05, Pass 2)
+Added guidance to write specific, concrete event descriptions with character names, actions, and dramatic consequences.
+
+### 2. Driver:Theme naming convention (v2-10, Pass 1)
+Changed from generic naming ("Empire", "Family") to `Driver: Theme` format ("Walt: Empire", "Walt: Family"). This makes it explicit who drives each storyline.
+
+### Full set results (v2-10)
+
+| Show | Baseline | v2-10 | Delta |
+|------|----------|-------|-------|
+| This Is Us | 0.1111 | 0.1022 | -0.0089 |
+| Breaking Bad | 0.0881 | 0.0819 | -0.0062 |
+| GDR | 0.0687 | 0.0876 | +0.0189 |
+| GoT | 0.0768 | 0.0772 | +0.0004 |
+| Слово пацана | 0.0591 | 0.0840 | +0.0249 |
+| Lost | 0.0731 | 0.0810 | +0.0079 |
+| ER | 0.0366 | 0.0702 | **+0.0336** |
+| Метод | 0.0561 | 0.0415 | -0.0146 |
+| Мажор | 0.0371 | 0.0319 | -0.0052 |
+| True Detective | 0.0240 | 0.0289 | +0.0049 |
+| **House** | **0.0049** | **0.0146** | **+0.0097** |
+| CSI | 0.0000 | 0.0042 | +0.0042 |
+
+**v2-10 mean: 0.0588** (baseline: 0.0530, **+11%**)
+
+Key wins:
+- **ER**: 0.0366 → 0.0702 (nearly 2x)
+- **Слово пацана**: 0.0591 → 0.0840 (+42%)
+- **House**: 0.0049 → 0.0146 (3x)
+- **CSI**: negative → 0.0042 (out of zero)
+- **GDR**: 0.0687 → 0.0876 (+28%)
+
+## What didn't work
+
+| Experiment | Hypothesis | Result |
+|-----------|-----------|--------|
+| v2-01: Season-length scaling | Longer seasons → more storylines | Mean dropped -0.005. Made model confused. |
+| v2-02: Procedural assignment rule | Separate episodic from serialized in Pass 2 | Neutral (-0.001). Too subtle for LLM. |
+| v2-03: Skip Pass 3 | Narratologist overmerges | Mixed. SP improved, House dropped. Pass 3 helps House. |
+| v2-04: More storylines for procedurals | 1 episodic + 3-6 serialized | Mean dropped -0.007. Hurt serials. |
+| v2-06: Goal-linked descriptions | "How it advances the goal" | Worse than pure specificity (-0.010). |
+| v2-07: Fewer events (8-15 per ep) | Less noise | House slightly up, BB/Lost down (-0.011). |
+| v2-08: Oversized storyline check in Pass 3 | >60% events → split | House +0.002, Lost -0.01. Not enough. |
+| v2-11: v2-10 + oversized check | Combine best changes | House regressed. Changes interact poorly. |
+| v2-12: v2-10 + skip-review | Skip Pass 3 | House 0.0146→0.0044. Pass 3 IS helping House. |
+
+## Key insights
+
+1. **Event description quality matters more than storyline structure.** Specific, concrete event descriptions improve embedding-based metrics across all show types. This is the single most impactful change.
+
+2. **Driver:Theme naming improves procedurals.** Making the driver explicit in storyline names helps the LLM assign events more precisely, especially in procedurals where many characters participate in the same case.
+
+3. **Pass 3 (narratologist review) helps procedurals.** Experiments v2-03 and v2-12 both showed that skipping Pass 3 hurts House. The narratologist creates and reassigns storylines that the initial pass misses.
+
+4. **Pass 1 structure changes are risky.** Modifying storyline counts or adding complex guidance (season-length scaling, short arcs) tends to confuse the model. Simple, clear rules work better.
+
+5. **Run-to-run variance is ~0.01-0.02 on Coh-Sep.** This makes it hard to isolate small improvements. Only changes with ≥0.005 delta on the fast set are reliably above noise.
+
+6. **The procedural problem is structural, not prompt-based.** In procedurals like House, the episodic line naturally dominates (285/383 events). Even with better naming and specificity, the fundamental imbalance remains. Fixing this likely requires architectural changes (e.g., two-pass event assignment, or explicit episodic/serialized separation in Pass 2 output format).
+
+## Recommended next steps
+
+1. **Architectural approach to procedural episodic dominance**: Consider splitting Pass 2 into two substeps for procedurals — first assign episodic events, then assign serialized events from the remainder. This would force better separation.
+
+2. **Per-episode Pass 2 voting**: Like Pass 1 voting but for event assignment. Would reduce run-to-run variance in the most expensive pass.
+
+3. **Coh-Sep metric analysis**: Investigate whether the metric ceiling for procedurals is inherently lower (all events involve medical/crime themes). Consider using a topic-adjusted version of the metric.
+
+4. **Full-set rerun of v2-10**: Run 3 times to establish confidence intervals on the current best.
+
+5. **Test on new shows**: Add 2-3 shows not in the training set to verify generalization.
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-brainstorm-notes.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-brainstorm-notes.md
new file mode 100644
index 0000000..76b8da7
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-v3-brainstorm-notes.md
@@ -0,0 +1,123 @@
+---
+type: note
+project: tvplotlines
+status: active
+---
+
+# Autoresearch v3: рабочие заметки из брейншторма
+
+Дата: 2026-03-18. Это сырьё для плана, не план. План пишем после прочтения статей.
+
+## Что происходит
+
+Наташа прошлась по всем 4 промптам tvplotlines и написала 60 замечаний (`notes for 3rd autoresearch.md` в Projects root). Вердикт: промпты — хаос. Не системно, не основано на теории, избыточно, неточно, не соответствует заявлению что это "программа для LLM".
+
+Нужно: переписать все 4 промпта + настроить autoresearch чтобы проверить что переписанные промпты не ухудшили качество извлечения.
+
+## 6 системных проблем (из 60 замечаний)
+
+### 1. Промпты ≠ программы
+Структура хаотичная: контракт говорит одно, Input — другое. Определения используются до того как объяснены. Meta-комментарии для разработчиков ("compiled from reference.md", "recompile from ADR-005") торчат в промпте который идёт в LLM. "After validation, result shown to human" — неправда. Цитаты с номерами страниц ("Nash, p.34") — зачем в промпте для машины?
+
+### 2. Глоссарий ≠ промпты
+В глоссарии определения точнее и полнее: franchise types, plotline, Story DNA, plot-led/character-led. В промптах — огрызки тех же определений, часто неточные. Глоссарий объясняет цепочку Franchise Type → Story Engine → Story DNA — в промптах этого нет. Нужно: глоссарий = ground truth, промпты берут определения оттуда.
+
+### 3. Мусорные поля и концепции
+Собираем но не используем (или непонятно зачем): `format` (ongoing/limited/anthology), `narrative devices`, `confidence`, `interactions` между линиями, `patches`, `weight` (primary/background/glimpse). Для каждого нужно решить: нужно → оставить с объяснением. Не нужно → убрать.
+
+### 4. Терминологическая каша
+`storyline` vs `plotline` — непоследовательно, даже внутри одного промпта (Pass 3 вдруг переключается на plotlines). `episodic` как тип линии — не общепринятый термин. Story DNA используется один раз, потом забывается. Logline test = 3 части, Story DNA = 4 части — противоречие.
+
+### 5. Код vs LLM — граница размыта
+Правила валидации дублируются в промпте и коде ("exactly one episodic storyline"). Constraints которые код уже проверяет — зачем повторять в промпте? Re-request on error — как сейчас выглядит? Ранжирование по весам — код считает, но промпт тоже пытается объяснить.
+
+### 6. Непроверенные утверждения
+TRANSFORMED storyline — бывает ли? A-rank всегда plot-led — правда ли? "Emotional counterpoint" — что? Pass 0 вообще нужен отдельно?
+
+## Подход к autoresearch
+
+Решили: **Подход C — "Программа промптов + incremental autoresearch"**.
+
+Но с важными уточнениями после обсуждения:
+- Event functions — НЕ отдельный шаг. Это часть той же работы (глоссарий уже содержит правильные 7 функций, промпт Pass 2 — старые).
+- Baseline считаем по **существующим** результатам 13 шоу, не прогоняем заново.
+- Autoresearch = **тестовый стенд** (ты вносишь изменение → прогон → метрики → принять/откатить), а не автоматическая генерация промптов.
+- Определения из теории (Nash, Douglas) — не подлежат авто-оптимизации. Авто-оптимизация — для формулировок инструкций и few-shot примеров.
+
+## Blueprint First: структура промпта
+
+Каждый Pass должен иметь одинаковый скелет:
+
+```
+1. ROLE        — кто ты (одно предложение)
+2. DEFINITIONS — термины из глоссария, ровно те что нужны этому pass
+3. INPUT       — что получаешь (schema, один раз)
+4. TASK        — что делаешь (пронумерованные шаги)
+5. OUTPUT      — JSON schema с типами полей
+6. EXAMPLE     — few-shot примеры
+```
+
+Принцип: определи перед использованием, используй после определения, не повторяй. Никаких meta-комментариев, цитат, validation rules (это в коде), двойных описаний, негативных constraints на несуществующие проблемы.
+
+## Что отдать коду, что — LLM
+
+| Задача | Кто | Почему |
+|--------|-----|--------|
+| Franchise type → constraints (сколько линий, нужна ли episodic) | Код | Детерминированные правила |
+| Валидация Story DNA completeness | Код | Проверка наличия 4 полей |
+| Ранжирование A/B/C по весам | Код | Арифметика по event counts |
+| Arc completeness / order | Код | Проверка последовательности функций |
+| Извлечение линий из синопсисов | LLM | Fuzzy, нарративное понимание |
+| Присвоение событий линиям | LLM | Понимание целей персонажей |
+| Определение function (setup/catalyst/...) | LLM | Нарративное суждение |
+
+Ключевой инсайт: чем больше constraints переносим из промпта в код, тем проще промпт и стабильнее результат.
+
+## Few-shot примеры
+
+Сейчас: один hardcoded пример (Breaking Bad) во всех промптах. BB — serial, 4 линии, чистая драма. Если на входе hybrid (House), пример BB может сбивать.
+
+Идея: подбирать релевантный пример по franchise type. Или давать 2-3 примера разных типов. У нас уже есть 13 результатов — можно взять лучшие как кандидаты в few-shot. Это можно автоматизировать (DSPy/MIPRO-подобный подход).
+
+Но это оптимизация второго порядка. Сначала промпты должны быть чистыми.
+
+## Метрики
+
+Текущие метрики в коде: coverage (доля событий привязанных к линии), consistency/ARI (стабильность между прогонами).
+
+Проблема: нет ground truth. Варианты оценки:
+- Стабильность + structural checks (код) — дёшево, но слепое пятно на качество
+- LLM-as-judge по чеклисту — автоматизируемо, нужно калибровать
+- Экспертная оценка на 2-3 шоу — дорого, но объективно
+
+Нужно решить после чтения ExtractBench — как они сравнивают extracted JSON.
+
+## Research findings
+
+### Статьи для чтения (план в отдельном файле)
+1. GoLLIE — annotation guidelines для IE
+2. Blueprint First — code controls workflow, LLM for bounded subtasks
+3. DSPy — prompts as compilable signatures
+4. MIPRO — optimizer for multi-stage LM pipelines
+5. OPRO — LLM generates improved prompts from history + scores
+6. TextGrad — textual gradients for component optimization
+7. ExtractBench — metrics for nested JSON extraction
+
+### Ключевые инсайты из research
+- Чистый few-shot GPT-4 обычно не бьёт fine-tuned BERT на NER. Но гибрид (LLM extraction + code validation) — бьёт.
+- Ширина JSON схемы (количество полей) — главный предиктор провала extraction (ExtractBench). У tvplotlines ~15 полей на storyline — умеренно.
+- OPRO/TextGrad/MIPRO — для оптимизации формулировок и примеров, не для оптимизации онтологии.
+- Riedl 2016 — нарративы оставляют многое implicit, LLM должна собирать из разрозненных упоминаний. Релевантно для Pass 1 (Story DNA reconstruction).
+
+## Данные
+
+- 13 шоу с результатами в `/Users/nvashko/Projects/1-projects/tvplotlines-app/data/results/`
+- Метрики считаются через `compute_all_metrics.py` там же
+- Глоссарий (ground truth): `3-resources/plotter_docs/preprint/paper/glossary 1.md` (domain terms) + `glossary.md` (pipeline terms)
+- 60 замечаний: `/Users/nvashko/Projects/notes for 3rd autoresearch.md`
+
+## Что дальше
+
+1. Прочитать 7 статей (план в `autoresearch-v3-reading-plan.md`)
+2. Вернуться, написать план autoresearch v3 с учётом прочитанного
+3. Старый `autoresearch-v3-event-functions.md` — устарел, будет заменён
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-engineering-review.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-engineering-review.md
new file mode 100644
index 0000000..1c321db
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-v3-engineering-review.md
@@ -0,0 +1,146 @@
+---
+type: note
+project: tvplotlines
+status: active
+---
+
+# Autoresearch v3: инженерная рецензия планов
+
+Рецензия на документы: [[tvplotlines-autoresearch-v3-plan|v3-plan]], [[tvplotlines-autoresearch-v3-engineering|v3-engineering]], [[tvplotlines-autoresearch-v3-event-functions|v3-event-functions]], [[tvplotlines-autoresearch-v3-brainstorm-notes|v3-brainstorm-notes]], [[tvplotlines-autoresearch-v3-questions|v3-questions]], [[tvplotlines-autoresearch-v3-reading-plan|v3-reading-plan]], [[tvplotlines-autoresearch-v3-hybrid-vs-procedural|v3-hybrid-vs-procedural]], [[notes for 3rd autoresearch]], [[tvplotlines-architecture|architecture]], [[tvplotlines-event-functions-redesign|event-functions-redesign]], [[tvplotlines-stability-benchmark|stability-benchmark]], [[tvplotlines-autoresearch-summary-v2|autoresearch-summary-v2]], [[tvplotlines-metrics-survey|metrics-survey]], [[tvplotlines-design-decisions|design-decisions]], [[tvplotlines-decision-001-context-before-extraction|ADR-001]], [[tvplotlines-decision-005-pass3-narratologist-review|ADR-005]], [[tvplotlines-naive-vs-tvplotlines|naive-vs-tvplotlines]], [[tvplotlines-enculturation-core-idea|enculturation-core-idea]]. Также промпты (`pass0.md` — `pass3.md`) и код (`pass0.py` — `postprocess.py`).
+
+---
+
+## Общая оценка
+
+В документах два проекта под одним именем "v3":
+
+1. **Исследовательский** ([[tvplotlines-autoresearch-v3-plan|v3-plan]]): ablation study — доказать что scaffold важен. Цель — препринт.
+2. **Инженерный** ([[tvplotlines-autoresearch-v3-engineering|v3-engineering]], [[tvplotlines-autoresearch-v3-event-functions|v3-event-functions]], [[tvplotlines-autoresearch-v3-questions|v3-questions]], [[notes for 3rd autoresearch|60 замечаний]]): переписать промпты, заменить event functions, вычистить мусор. Цель — качество продукта.
+
+Порядок в документах перевёрнут. Ablation study на текущих промптах будет измерять качество бардака, а не scaffold'а.
+
+---
+
+## 1. Сначала чистка, потом исследование
+
+Инженерная чистка **до** ablation study — детерминированная работа, не требует autoresearch:
+
+1. `storyline → plotline` везде
+2. Глоссарий = ground truth для определений в промптах
+3. Blueprint First скелет промпта: ROLE → DEFINITIONS → INPUT → TASK → OUTPUT → EXAMPLE
+4. Constraints из промптов → в код (Qiu 2025: +11.7pp vs +1.1pp)
+5. Event functions: заменить `cliffhanger/seed` на `catalyst/crisis` в промптах и в коде. **Сначала верифицировать набор по учебникам** (см. п.6)
+6. Неиспользуемые поля (`format`, `narrative devices`, `patches`, `interactions`): сейчас собираются но нигде не применяются. Для `format` и `patches` — скорее всего убрать. Для `narrative devices` — возможно оставить: после чтения Zwaan (когнитивный контроль при понимании нарратива) и работ по AI enculturation есть основание думать что выделение devices может быть частью того как scaffold помогает LLM "понимать" нарратив. Нужно: уточнить список devices по теории, определить где они применяются downstream, и только тогда решить — убрать или формализовать
+7. Merge Pass 0 → Pass 1 (ablation `pass1_merged.py` показала что можно)
+
+После чистки — прогон на 12 шоу, сравнить с v2-10 baseline (mean 0.0588). Деградация > 5% → найти причину, откатить.
+
+---
+
+## 2. Метрики
+
+### Что работает
+
+| Метрика | Что измеряет | Откуда |
+|---------|-------------|--------|
+| `coverage` | Полнота — все события привязаны? | Здравый смысл |
+| `ARI` | Стабильность — воспроизводим между прогонами? | Hubert & Arabie 1985 |
+| `coh_sep` | Различимость — линии не слипаются? | Наша, из идей Silhouette Coefficient |
+
+### Что проверяет что
+
+| Что                    | Кто создаёт         | Кто проверяет    | Метрика               |
+| ---------------------- | ------------------- | ---------------- | --------------------- |
+| Арка эпизода           | LLM (Pass 2)        | Код после Pass 2 | episode completeness  |
+| Разнесение по линиям   | LLM (Pass 2)        | Код              | `coh_sep`, `coverage` |
+| Арка линии через сезон | Код (постобработка) | Pass 3 + код     | arc completeness      |
+
+### Позиция: не accuracy, а reliability + validity
+
+tvplotlines работает с текстом синопсиса и ищет **воспроизводимую нарратологическую интерпретацию текста**. 
+
+Три метрики это и измеряют: стабильно (ARI), различимо (coh_sep), полно (coverage). **Оговорить в препринте и README** почему мы не проверяем ground truth 
+
+### `function_score` — снять
+
+Произвольные пороги, некалиброванная формула. Episode completeness и arc completeness — реализовать в коде на этапе чистки как факт (5/7, 7/7), без оценок "хорошо/плохо". Пороги калибровать post-hoc.
+
+---
+
+## 3. v2 урок
+
+Из 12 экспериментов v2: 2 успеха, 10 провалов. Добавление/убирание фраз в промпт ломало баланс. Главный вывод: **"The procedural problem is structural, not prompt-based."**
+
+**Это главный риск v3** — мы хотим радикально переписать промпты, а v2 показал что промпты хрупкие.
+
+Но есть важное отличие. v2 менял текст в работающем промпте — добавлял/убирал фразы, надеясь улучшить. v3 чистка — это не "менять формулировки", а рефакторинг: убрать мусор (meta-комментарии, дубликаты, цитаты), привести к единой структуре (Blueprint First), перенести проверки в код, заменить определения на точные из глоссария. Промпт должен сказать **то же самое**, но чище. Как переписать функцию без изменения поведения.
+
+**Стратегия снижения риска:** одно изменение → прогон → сравнить с baseline → если упало → откатить конкретное изменение. Не всё разом.
+
+Для v3 это также значит: из 17 шагов v3-plan минимум 8 — эксперименты с формулировками. При hit rate 17% (как в v2) → 1-2 успеха из 8. Бюджет может не хватить. Приоритет — структурные изменения (код), а не формулировки.
+
+---
+
+## 4. Event functions: два документа противоречат
+
+[[tvplotlines-event-functions-redesign|event-functions-redesign]] — зрелый документ с фрактальной структурой, теоретическим обоснованием. [[tvplotlines-autoresearch-v3-event-functions|v3-event-functions]] — черновик с необоснованным function_score.
+
+Использовать первый. Из второго взять только протокол (baseline → замена → coh_sep ≥ baseline × 0.95).
+
+---
+
+## 5. Эвристики из теории
+
+Много правил в промптах как расплывчатый текст, которые можно формализовать в код. Но сначала — набрать из учебников. Подробный каталог: [[tvplotlines-heuristics-from-theory]].
+
+Ключевые:
+- **Порядок функций в арке** — уточнить какие жёсткие, какие гибкие
+- **Episode completeness** — какие функции must be в каждом эпизоде
+- **Story DNA** — код-валидация полноты полей
+- **Количество линий по franchise type** — код-валидация диапазонов
+- **A-rank = plot-led?** — проверить в теории
+- **Narrative devices, interactions, emotional counterpoint** — нужны ли? формализовать или убрать?
+
+---
+
+## 6. Event functions: верифицировать набор
+
+Текущие 7 функций — микс Nash + Netflix + McKee + Oberg. Ни один практик не узнает "свою" систему.
+
+| Наша          | Nash                | Netflix           | McKee                     | Harmon    |
+| ------------- | ------------------- | ----------------- | ------------------------- | --------- |
+| setup         | Set-Up              | Setup             | —                         | YOU, NEED |
+| catalyst      | Catalyst            | Inciting Incident | Inciting Incident         | GO        |
+| escalation    | Fun & Games + Bad Guys Close In | Escalation | Progressive Complications | SEARCH |
+| turning_point | Midpoint                        | Midpoint   | —                         | FIND   |
+| crisis        | All Is Lost + Dark Night of the Soul | Crisis | Crisis                    | TAKE   |
+| climax        | Finale              | Climax            | Climax                    | RETURN    |
+| resolution    | Final Image         | Resolution        | Resolution                | CHANGE    |
+
+**До внедрения:** выбрать каноническую основу, проверить конспект Netflix workshop, записать маппинг в глоссарий.
+
+---
+
+## 7. Мелкие замечания
+
+**Reading plan ([[tvplotlines-autoresearch-v3-reading-plan|v3-reading-plan]])** предлагает прочитать 7 статей. Из них для v3 реально нужны 3: GoLLIE (как писать определения в промпте), Blueprint First (что перенести в код), ExtractBench (как сравнивать JSON результаты). Остальные 4 (DSPy, MIPRO, OPRO, TextGrad) — про автоматическую оптимизацию промптов. При нашем бюджете ($60-85) и масштабе (12 шоу) ручной A/B тест (как в v1/v2) дешевле и проще чем фреймворк.
+
+**Naive vs tvplotlines ([[tvplotlines-naive-vs-tvplotlines|naive-vs-tvplotlines]])** — эксперимент "наивный промпт vs pipeline". Это то же самое что условие A в ablation study из [[tvplotlines-autoresearch-v3-plan|v3-plan]]. Не делать два раза — объединить в один эксперимент.
+
+**Hybrid vs procedural ([[tvplotlines-autoresearch-v3-hybrid-vs-procedural|v3-hybrid-vs-procedural]])** — вопрос "где граница между procedural и hybrid". Хорошо поставлен (конкретная проблема, конкретная гипотеза). Решить на фазе 1 (подготовка) — прочитать Nash/Douglas/Mittell, уточнить определение.
+
+---
+
+## Что через autoresearch, а что нет
+
+**НЕ через autoresearch:** переименование, глоссарий→промпты, Blueprint First, constraints→код, enum functions, merge Pass 0→1, мусорные поля, пост-обработка арок.
+
+**Через autoresearch:** ablation study, формулировки event functions, CoT в примерах, подбор примеров по franchise type.
+
+---
+
+## Порядок работы
+
+Детальный план с чекбоксами: [[tvplotlines-autoresearch-v3-todo]]
+
+Бюджет: ~$60-85. Каждая фаза — checkpoint.
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-engineering.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-engineering.md
new file mode 100644
index 0000000..8c6e66a
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-v3-engineering.md
@@ -0,0 +1,60 @@
+---
+type: draft
+project: github-io
+status: active
+title: ""
+date: 2026-03-18
+description: ""
+series: What Logic Can Do for Stories
+tags: []
+sources:
+  - reading_note: ""
+    sections_used: []
+---
+
+# Autoresearch v3: техническая оптимизация
+
+Отдельно от плана исследования (`plotter-autoresearch-v3-plan.md`). Это инженерные задачи — полезны для продукта, не для препринта. Выполняются после или параллельно с исследованием.
+
+Статус: `[ ]` — не начато, `[~]` — в процессе, `[x]` — сделано.
+
+---
+
+- [ ] **1. Терминология storyline → plotline.** Переименовать в промптах, коде, документации. Fallback в tvplotlines-app: `ev.plotline || ev.storyline` чтобы старые данные не сломались.
+
+- [ ] **2. Merge Pass 0 в Pass 1.** Одним LLM call вместо двух. Тестировать отдельно.
+
+- [ ] **3. Pass 3: код vs LLM.** Какие verdicts детерминированные (MERGE по совпадению driver+goal, PROMOTE/DEMOTE по весам), какие требуют LLM (REASSIGN, CREATE). Тестировать code-only Pass 3.
+
+- [ ] **4. Bootstrapping примеров.** Pipeline → DC ловит ошибки → ошибки = негативные примеры в определениях, хорошие результаты = положительные примеры, кандидаты в few-shot для разных franchise types.
+
+- [ ] **5. CoT vs voting.** 1 прогон с CoT scaffold vs 3 прогона без CoT (текущий voting). Стоимость vs стабильность.
+
+- [ ] **6. Демо: подготовка к новым данным.**
+  - CSS для `fn-catalyst` и `fn-crisis` (новые event functions)
+  - Fallback `ev.plotline || ev.storyline`
+  - Показать franchise_type + format в toolbar
+  - Показать confidence в PlotlineDetail
+
+# _tpl-blog-post
+
+> One-paragraph hook: the engineering problem. No jargon.
+
+## The problem
+
+What goes wrong without formal structure. 3-5 sentences.
+
+## What the literature offers
+
+2-4 approaches, one paragraph each.
+
+## The bridge: from theory to pipeline
+
+How does this formal method become a prompt, a data model, or an algorithm?
+
+## Takeaway
+
+3-5 bullet points.
+
+## Further reading
+
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-event-functions.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-event-functions.md
new file mode 100644
index 0000000..3c033ad
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-v3-event-functions.md
@@ -0,0 +1,206 @@
+---
+type: note
+project: tvplotlines
+status: active
+---
+
+# Autoresearch v3: Event Functions Redesign
+
+## Цель
+
+Внедрить новый набор event functions (7 функций вместо текущих 7) в промпт Pass 2 без деградации существующих метрик storyline quality.
+
+**Было:** setup, escalation, turning_point, climax, resolution, cliffhanger, seed
+**Стало:** setup, catalyst, escalation, turning_point, crisis, climax, resolution
+
+Полное описание изменений: `todo/event-functions-redesign.md`
+
+## Отличие от v1/v2
+
+| | v1 | v2 | v3 |
+|---|---|---|---|
+| Цель | Улучши метрику | Улучши метрику | Внедри изменения, не сломай метрику |
+| Свобода | Любые изменения | Любые изменения | Конкретные изменения, свобода в формулировках |
+| Метрика | ARI (consistency) | coh_sep (quality) | coh_sep (constraint) + function_score (goal) |
+| Датасет | 1 шоу | 12 шоу | 12 шоу (те же) |
+
+Ключевое отличие: v1/v2 = "делай что хочешь, улучши X". v3 = "внедри Y при условии что X не упадёт".
+
+## Новая метрика: function_score
+
+Автоматическая, без ground truth. Три компоненты:
+
+### 1. Arc completeness
+
+Для каждой storyline: сколько из 7 фаз присутствует.
+
+```python
+def arc_completeness(storyline_events):
+    functions = {e.function for e in storyline_events}
+    return len(functions) / 7
+```
+
+Ожидания по рангу (из `todo/event-functions-redesign.md`):
+- A: ≥ 6/7
+- B: ≥ 5/7
+- C: ≥ 3/7
+- runner: ≥ 1/7[^1]
+
+Метрика: доля storylines, достигших ожидаемого минимума.
+
+### 2. Arc order (monotonicity)
+
+Проверяем что арка не возвращается через milestone.[^2] Milestones: catalyst, turning_point, crisis, climax.
+
+```python
+WEIGHT = {"setup": 1, "catalyst": 2, "escalation": 3, "turning_point": 4, "crisis": 5, "climax": 6, "resolution": 1}
+MILESTONES = {"catalyst", "turning_point", "crisis", "climax"}
+
+def arc_order_score(storyline_events_sorted):
+    """1.0 if no return past milestone, penalty for each violation."""
+    max_milestone_weight = 0
+    violations = 0
+    for e in storyline_events_sorted:
+        w = WEIGHT[e.function]
+        if e.function in MILESTONES:
+            max_milestone_weight = max(max_milestone_weight, w)
+        elif w < max_milestone_weight - 1:  # return past milestone
+            violations += 1
+    return max(0, 1.0 - violations * 0.1)
+```
+
+### 3. Function distribution
+
+Каждый эпизод должен иметь разнообразие функций, не все escalation. [^3]
+
+```python
+def distribution_score(episode_events):
+    """Penalize episodes where >80% events have the same function."""
+    from collections import Counter
+    counts = Counter(e.function for e in episode_events)
+    max_pct = max(counts.values()) / len(episode_events)
+    return 1.0 if max_pct <= 0.8 else 0.5
+```
+
+### Комбинированная метрика[^4]
+```python
+function_score = mean(arc_completeness) * mean(arc_order_score) * mean(distribution_score)
+```
+
+## Constraint: существующие метрики
+
+```
+coh_sep >= baseline_coh_sep * 0.95  # не больше 5% деградации
+coverage >= 0.95                     # покрытие событий
+```
+
+Если constraint нарушен — revert, как в v1/v2.  [^5]
+
+## Что оптимизирует autoresearch
+
+### Обязательные изменения (внедрить в первом эксперименте) [^6]
+
+1. Заменить таблицу функций в Pass 2 промпте (EN + RU)
+2. Обновить `_VALID_FUNCTIONS` в `pass2.py`
+3. Обновить описания функций
+
+### Свободные варианты (autoresearch пробует)
+
+- Как описать catalyst — "trigger event", "inciting incident", "the thing that starts the storyline"?
+- Как описать crisis — "lowest point", "all is lost", "whiff of death"?
+- Сколько примеров давать для каждой функции?
+- Нужно ли добавить правило про порядок функций в арке?
+- Как описать отличие escalation от catalyst (оба "что-то происходит")?
+- Нужно ли упоминать Act 1/2/3 или оставить абстрактно? [^7]
+
+## Протокол
+
+### Фаза 0: Baseline
+
+1. Прогнать текущий pipeline на fast set (BB, SP, House, Lost)[^8] с текущими функциями [^9]
+2. Вычислить coh_sep и function_score (с маппингом старых функций на новые для сравнимости):[^10]
+   - cliffhanger → climax (ближайший аналог)
+   - seed → setup (ближайший аналог)
+3. Записать baseline
+
+### Фаза 1: Внедрение (1 эксперимент)
+
+1. Заменить функции в промптах + код
+2. Прогнать на fast set
+3. Проверить constraint (coh_sep ≥ baseline * 0.95)
+4. Если ок — keep. Если нет — начать фазу 2 с минимальных изменений.
+
+### Фаза 2: Оптимизация формулировок
+
+Стандартный autoresearch loop:
+1. Одно изменение в описании функции
+2. Прогон на fast set
+3. function_score улучшился И constraint не нарушен → keep
+4. Иначе → revert
+5. Повторять
+
+### Фаза 3: Валидация
+
+1. Прогнать лучший вариант на full set (12 шоу)
+2. Проверить что coh_sep не упал
+3. Проверить function_score на всех шоу
+4. Ручная проверка BB S01 — функции выглядят правильно?
+
+## Бюджет
+
+Fast set: ~$2-3 за прогон
+Фаза 0: 1 прогон = ~$3
+Фаза 1: 1 прогон = ~$3
+Фаза 2: ~20 экспериментов = ~$50-60
+Фаза 3: 1 прогон full set = ~$5
+**Итого: ~$65-70**
+
+## Что НЕ входит в v3
+
+- Модификаторы (cliffhanger, seed как модификаторы) — отдельная задача после v3
+- Post-processing фаз (группировка событий в фазы) — код, не autoresearch
+- Pass 3 обновление (arc validation) — после v3 стабилизируется
+- Визуализация — tvplotlines-app, не autoresearch
+- Фрактальная структура (3 уровня арок) — после v3
+
+## Файлы
+
+| Файл | Что менять |
+|------|-----------|
+| `src/tvplotlines/prompts_en/pass2.md` | Таблица функций + описания |
+| `src/tvplotlines/prompts/pass2.md` | То же, русский |
+| `src/tvplotlines/pass2.py` | `_VALID_FUNCTIONS` |
+| `src/tvplotlines/metrics.py` | Добавить `function_score` |
+| `src/tvplotlines/prompts_en/pass3.md` | Step 2 (arc checking) — после v3 |
+| `src/tvplotlines/prompts/pass3.md` | То же, русский — после v3 |
+
+## Связи
+
+- `todo/event-functions-redesign.md` — полное описание новых функций
+- `experiments/autoresearch/program-v2.md` — протокол v2 (template)
+- `experiments/bibliography-narrative-and-autoresearch.md` — литература
+- Papalampidi et al. (2019) — ближайшая академическая работа по turning point detection
+
+[^1]: what these are based on? any data? comon sense? if commonsense no good 
+	
+
+[^2]: and if it returns what it means? how do we know that it means that? is it bad or good? why would we need it 
+
+[^3]:  здесь я не понимаю это ты написал до того как мы выяснили что у нас фрактальная структура и у нас есть арка внутри эпизода и это не арка сезона и даже не арка линии а самый эпизод устроен ровный тех же семи шагов и ровно это арку эпизода и получаем в проте NOM паст точнее получаем мы в результате второго Пасса. Соответственно то что ты здесь пишешь для меня не имеет смысла. Объясни пожалуйста
+
+[^4]: я не понимаю что она меряет зачем меряет можешь каушика перечитать чтобы адекватнные придумывать решения а не декорации городить
+
+[^5]:  слушай по сути это черновик прото почему же ты его пишешь на таком годовом языке если LLM хорошо понимает разговорный язык и я человек тоже хорошо понимаю разговорный язык почему же ты не пишешь сразу черновик так как будет лучше понято и мною и моделью а пишешь вот это вот всё я понимаю если бы это был человек которым надо сначала представить структуру а потом только сочинение писать но ты-то можешь писать тексты которые читаются по-человечески а сохраняют все логические ну входы выходы формулы ну как вообще
+	 
+
+[^6]: 5 А куда делись эти все инструкции которые мы писали по 1 000 000 раз писать так чтобы человек без контекста мог писать как маме объяснять смысл ничто делать зачем где это всё ты как будто манкурт какой-то это невозможно читать просто вот что это ты написал
+
+[^7]: подробнее об этом о роли этих вопросоа? от роли зависит как они должны быть сформуоированы 
+
+[^8]:  А как определить минимальный набор с точки зрения стоимости каждого прогона чтобы получить максимальный результат это как ты мне можешь помочь определить
+	 
+
+[^9]:  А зачем мы будем это ещё раз сделать? Мы же уже прогнали с текущими функциями вот у нас есть результаты зачем нам ещё раз это делать объясни ну разве ты деньги мои потратить хочешь
+
+[^10]:  откуда эти показатели где мы взяли это тук-тук-тук тут существует это такое
+	 
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-hybrid-vs-procedural.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-hybrid-vs-procedural.md
new file mode 100644
index 0000000..1dee6f3
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-v3-hybrid-vs-procedural.md
@@ -0,0 +1,22 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# Autoresearch v3: уточнить разницу hybrid vs procedural
+
+## Проблема
+
+В глоссарии разница читается нормально:
+- **Procedural**: self-contained story per episode
+- **Hybrid**: case-of-week + serialized arcs
+
+Но в промпте pass0 граница размыта — procedural тоже может иметь serialized B-storylines (House: cases + House/team dynamics). Когда шоу перестаёт быть procedural и становится hybrid?
+
+## Что проверить
+
+- [ ] Как pass0 присваивает franchise_type на реальных шоу — есть ли ошибки hybrid↔procedural?
+- [ ] Найти в литературе (Nash, Douglas, Mittell) чёткий критерий: что делает шоу hybrid, а не procedural с B-arc?
+- [ ] Возможный критерий: в procedural serialized arcs — фон (character development), в hybrid — serialized arc является полноценным двигателем сюжета наравне с case-of-week
+- [ ] Обновить промпт pass0 с более чётким разграничением
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-plan.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-plan.md
new file mode 100644
index 0000000..38137d6
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-v3-plan.md
@@ -0,0 +1,165 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# Autoresearch v3: план исследования
+
+Черновик v3. Техническая оптимизация — отдельный документ (`tvplotlines-autoresearch-v3-engineering.md`).
+
+Статус: `[ ]` — не начато, `[~]` — в процессе, `[x]` — сделано.
+
+---
+
+## Что мы хотим показать
+
+LLM обучена на огромном количестве текстов. Она «знает» про персонажей, конфликты, жанры — но это знание лежит внутри неё неорганизованно, как куча инструментов в коробке без отделений. Без внешней помощи LLM берёт первый попавшийся инструмент: пересказывает, стилизует, выдаёт поверхностные наблюдения. Она не задаёт себе вопросы «зачем персонаж так поступил?» или «почему авторы построили историю именно так?» — потому что ей никто не сказал, что нужно их задавать.
+
+tvplotlines даёт LLM то, чего у неё нет: **нарратологический опыт**, упакованный в промпты. У человека-читателя этот опыт копится годами — из жизни, из прочитанных книг, из обсуждений. LLM этого опыта не имеет. Промпты tvplotlines — это не инструкции «сделай X». Это **рамка мышления**, которая переключает LLM из режима пересказа в режим анализа:
+
+- **Тип сериала** (procedural / serial / ensemble) переключает стратегию анализа целиком. Когнитивные психологи (Zwaan 1993) показали, что человек-читатель делает то же самое: увидев жанровый ярлык, он меняет то, на что обращает внимание. Детектив → ищем улики. Мелодрама → следим за отношениями. tvplotlines делает это для LLM.
+
+- **Четыре поля конфликта** (hero — кто движет действие, goal — чего хочет, obstacle — что мешает, stakes — что на кону) заставляют LLM перейти от пересказа «что случилось» к анализу «зачем персонаж так поступил». Bruner (1991) показал: любая история — это всегда про чьи-то намерения. Без этих вопросов LLM не задумывается о намерениях — просто перечисляет события.
+
+- **Функции событий** (setup, escalation, turning point, climax, resolution), **ранг линий** (A/B/C), **взаимодействия между линиями** (тематическая рифма, драматическая ирония) — это уровень авторского замысла. Не «что произошло в мире сериала», а «как авторы построили историю». Zwaan (1993) назвал это pragmatic model и предложил как идею, но ни он, ни кто-то другой не формализовал за 30 лет.
+
+Мы хотим проверить, играет ли каждый из этих элементов scaffold'а конкретную роль, и действительно ли без него LLM производит результат принципиально иного качества.
+
+### Три типа интеллекта в одном pipeline
+
+tvplotlines — не «LLM + промпт». Это три компонента, каждый делает то, в чём надёжен:
+
+- **Код** (валидация JSON, проверка ссылок, подсчёт span и weight) — детерминированный, не ошибается в арифметике и структуре. Как таблица Менделеева: сама не решает, но без неё химик наделает ошибок.
+
+- **Промпты** (определения, таксономии, примеры) — нарратологическое знание, упакованное в вопросы. Как опытный редактор: не пишет сам, но задаёт правильные вопросы.
+
+- **LLM** — гибкий решатель, способный к выводам и интерпретации. Но без scaffold'а остаётся на уровне пересказа.
+
+---
+
+## Фаза 0: Инфраструктура
+
+- [ ] **1. Метрики для оценки.**
+
+  **Решение (2026-03-23):** отказываемся от coverage × ARI в пользу эмбеддинг-метрик.
+
+  - **Coverage** — бессмысленна: код детерминированно назначает все события, всегда 1.0.
+  - **ARI (consistency)** — измеряет стабильность, не качество. Стабильно плохой результат = ARI 1.0. Prescriptive vocabulary (12 слов) давал ARI 1.000, но это был овerfitting под один сериал.
+  - **Gold standard (V-measure, B-cubed, NMI)** — отвергнуто: нет "правильного" набора сюжетных линий, два эксперта разметят по-разному.
+
+  **Новая метрика:**
+  - **score = silhouette** — одно число для autoresearch (sklearn, выше = лучше). Эмбеддинги событий, насколько события внутри линии ближе друг к другу, чем к чужим линиям.
+  - **coherence** (средняя внутрилинейная похожесть) + **separation** (средняя межлинейная похожесть) — логируем в results.tsv для диагностики. Silhouette = их комбинация в одно число.
+
+  Нужно: выбрать эмбеддинг-модель (sentence-transformers / OpenAI / Voyage), реализовать в metrics.py.
+
+- [ ] **2. Базовый уровень.** Посчитать все метрики на 13 существующих результатах. Эти числа — точка отсчёта, с которой сравниваем всё последующее.
+
+- [ ] **3. Разделение данных + бюджет.** 9 сериалов для экспериментов (по 2-3 от каждого типа: процедурал, сериал, гибрид, ансамбль), 4 — отложить для финальной проверки (модель их не видела при оптимизации). Ориентировочный бюджет: ~$50-100 на все эксперименты.
+
+## Фаза 1: Что LLM умеет без нас
+
+Прежде чем улучшать scaffold, нужно понять: что LLM делает сама, без наших промптов? Где граница между её собственными знаниями и тем, что даёт scaffold?
+
+- [ ] **4. LLM без scaffold.** Дать модели синопсисы Breaking Bad S01 и попросить: «дай основные сюжетные линии сериала.» Без каких-либо шаблонов, определений, примеров. Цель — не «доказать что без промптов плохо», а **увидеть**, что LLM делает по умолчанию: видит ли персонажей? Замечает ли конфликты? Или уходит в стилистический пересказ?
+
+- [ ] **5. Три уровня scaffold (главный эксперимент).**
+
+  Один и тот же вход (синопсисы Breaking Bad S01). Три разных промпта:
+
+  **A — без scaffold.** «Проанализируй нарративную структуру.» Предсказание: LLM перескажет события, может назвать персонажей, но не объяснит мотивации и не покажет структуру арок.
+
+  **B — минимальный scaffold.** «Извлеки сюжетные линии. Для каждой укажи: кто движет действие, чего хочет, что мешает.» Без типа сериала, без ранга, без функций событий, без примеров. Предсказание: появятся мотивации и конфликты (уровень «зачем персонаж так поступил»), но без структуры авторского замысла.
+
+  **C — полный scaffold (tvplotlines).** Тип сериала + четыре поля конфликта + ранг + функции событий + пример. Предсказание: и мотивации, и авторский замысел (какие линии главные, как они взаимодействуют, какие приёмы использованы).
+
+  Разница A→B покажет, что минимальный scaffold переключает LLM из режима пересказа в режим анализа мотиваций. Разница B→C покажет, что полный scaffold добавляет уровень авторского замысла.
+
+  Проводим на 5 сериалах разных типов (не только Breaking Bad), чтобы результат был не случайным.
+
+- [ ] **6. Ablation: убираем по одному компоненту.**
+
+  Берём полный scaffold и убираем из него один элемент. Для каждого — предсказание записано **до** эксперимента. Если предсказание совпало — теория подтверждена. Если нет — теория нуждается в коррекции. Оба результата полезны.
+
+**Тип сериала.** Зачем: переключает стратегию анализа целиком. Без него: в процедуралах побочные линии получат завышенный ранг, в сериалах будут пропущены эпизодические линии, количество линий выйдет за норму.
+
+**Четыре поля конфликта.** Зачем: переключают LLM из режима пересказа в режим анализа мотиваций. Без них: линии станут описательными («расследование Хэнка») без объяснения что им движет и что мешает.
+
+**Ранг.** Зачем: заставляет различать вес линий. Без него: все линии будут выглядеть равноценными, исчезнет иерархия A/B/C.
+
+**Функции событий.** Зачем: заставляют видеть структуру арки. Без них: события перечислены списком, без различия «завязка / кульминация / развязка».
+
+## Фаза 2: Эксперименты
+
+- [ ] **7. Разные «культуры» анализа.** Один сериал, два набора промптов: (a) голливудский story editor (текущий tvplotlines — определения из Nash, Douglas), (b) академический нарратолог (определения из Genette, Propp). Предсказание: разные промпты дадут разные интерпретации одного материала. Это покажет, что промпты — не нейтральные инструкции, а **рамка**, через которую LLM смотрит на материал. Идея — из работы Winston (2014): его система Genesis читала одну историю с разных «культурных» предустановок и получала разные интерпретации.
+
+- [ ] **8. Конкретные vs абстрактные формулировки.** Два варианта определений: (a) абстрактный — «определите obstacle», (b) конкретный — «что именно мешает этому персонажу получить то, что он хочет?». Предсказание: конкретные формулировки дают более точные результаты, потому что они ближе к тому, как люди думают о конфликтах.
+
+- [ ] **9. Объяснения «почему» в определениях.** Два варианта: (a) без объяснения — «franchise type: procedural / serial / hybrid / ensemble», (b) с объяснением — «тип сериала определяет стратегию анализа: procedural означает, что каждый эпизод содержит самостоятельную историю, поэтому ищем дело-недели и фоновые арки». Предсказание: объяснение «зачем это нужно» улучшает результат, потому что LLM, как и человек, лучше следует инструкции, если понимает её цель (AlKhamissi 2024).
+
+- [ ] **10. Русские промпты на русских сериалах.** Слово пацана, Метод, Мажор: русский vs английский промпт на одних и тех же синопсисах. Гипотеза (AlKhamissi 2024): язык промпта активирует культурные знания модели. Русский промпт может лучше справиться с русскими реалиями.
+
+- [ ] **11. Сравнение моделей.** Один промпт на 2-3 моделях (Claude, GPT-4, Gemini). Если scaffold работает только с одной моделью — он недостаточно универсален. Если работает со всеми — это аргумент за то, что дело в scaffold'е, а не в особенностях конкретной модели.
+
+- [ ] **12. Поля, которые сейчас не используются downstream.** Для каждого (format, devices, interactions, confidence, patches) — определить теоретическую роль и проверить ablation'ом.
+
+**format** — ограничение на ожидания от финала (limited → арки должны завершиться). Downstream: валидация арок.
+
+**devices** — как автор показывает (flashback, dramatic irony) — уровень авторского замысла. Downstream: визуализация, анализ стиля.
+
+**interactions** — связи между линиями — тоже авторский замысел. Downstream: визуализация структуры.
+
+**confidence** — где pipeline уверен, а где угадывает. Downstream: решения Pass 3, приоритизация ручной проверки.
+
+**patches** — где pipeline видит проблему в собственных результатах. Downstream: диагностика.
+
+- [ ] **13. Что в промпте, а что в коде.** Составить полный список правил, которые сейчас есть в промптах и/или в коде. Для каждого решить: определения и нарратологическое знание → промпт. Проверка структуры (JSON schema, ссылки, арифметика) → код. Исследование Qiu (2025) показало, что проверка кодом эффективнее, чем правила в промпте (+11.7 пунктов vs +1.1).
+
+## Фаза 3: Переписывание промптов (после фаз 1-2)
+
+- [ ] **14. Переписать промпты на основе результатов.** Принципы:
+  - Не объясняй модели базовые вещи (что такое «персонаж» или «конфликт» — она это знает). Объясняй **нашу систему координат** — чем наше определение driver отличается от того, что модель понимает по умолчанию.
+  - Конкретные формулировки вместо абстрактных (по результатам шага 8).
+  - Объяснения «зачем» для каждого определения (по результатам шага 9).
+  - Определения с примерами (подход GoLLIE, Sainz 2024).
+  - Структурные constraints перенести в код.
+
+- [ ] **15. Тест переписанных промптов.** Прогнать на тренировочном наборе, сравнить с базовым уровнем. Если какая-то метрика упала больше чем на 5% — откатить конкретное изменение и тестировать его отдельно.
+
+- [ ] **16. Reasoning trace в примерах.** Добавить в few-shot пример цепочку рассуждений перед JSON-ответом (подход Chain-of-Thought, Wei 2022). Тестировать отдельно от переписывания, чтобы изолировать эффект.
+
+- [ ] **17. Финальная проверка.** Прогнать на 4 отложенных сериалах, которых pipeline не видел при оптимизации.
+
+---
+
+## Что подтверждает каждый эксперимент
+
+| Эксперимент | Что покажет |
+|------------|------------|
+| LLM без scaffold (шаг 4) | Что LLM знает о нарративах, но не организует это знание без помощи |
+| Три уровня scaffold (шаг 5) | Что scaffold переключает LLM с пересказа на анализ мотиваций, а полный scaffold добавляет уровень авторского замысла |
+| Ablation с предсказаниями (шаг 6) | Что каждый компонент scaffold играет конкретную роль |
+| Разные «культуры» (шаг 7) | Что промпты — не нейтральные инструкции, а рамка мышления |
+| Конкретные vs абстрактные (шаг 8) | Какие формулировки эффективнее |
+| Объяснения «зачем» (шаг 9) | Что объяснение цели инструкции улучшает результат |
+| Русские промпты (шаг 10) | Что язык scaffold влияет на качество для культурно-специфичного материала |
+| Сравнение моделей (шаг 11) | Что scaffold работает не только с одной моделью |
+
+## Источники
+
+| Идея | Откуда | Что говорит |
+|------|--------|------------|
+| Человек переключает стратегию чтения в зависимости от жанра | Zwaan 1993 | Жанровый ярлык активирует cognitive control system — фильтр, определяющий, на что обращать внимание |
+| Любая история — про чьи-то намерения | Bruner 1991 | Без моделирования намерений нет понимания нарратива, только пересказ |
+| Вопрос меняет интерпретацию | Winston 2014 | Система Genesis не видела связь, пока её не спросили — тогда знание активировалось |
+| LLM — «мешок эвристик», а не модель мира | Mitchell 2025 | LLM отслеживает «кто что делает», но не понимает «зачем» без помощи |
+| AI чужд людям, нужно enculturation | Riedl 2016, 2019 | AI без понимания социальных норм и мотиваций — «инопланетный разум» |
+| LLM предпочитает стиль структуре | Jung 2026 | Без scaffold LLM «украшает» текст вместо анализа |
+| Язык промпта активирует культурные знания | AlKhamissi 2024 | LLM по умолчанию воспроизводит ценности англоязычной культуры |
+| Проверка кодом эффективнее правил в промпте | Qiu 2025 (Blueprint First) | +11.7 пунктов vs +1.1 |
+| Reasoning перед ответом улучшает результат | Wei 2022 (Chain-of-Thought) | «Let's think step by step» переключает режим обработки |
+| Определения с примерами — ключевой компонент | Sainz 2024 (GoLLIE) | Модель лучше следует определениям, если видит примеры |
+| Конкретные шаги лучше общей инструкции | Wang 2023 (Plan-and-Solve) | «Devise a plan, then carry out the plan» |
+| Одно изменение за раз при оптимизации | Opsahl-Ong 2024 (MIPRO) | Greedy credit assignment — иначе не понять что помогло |
+| Метрики для сравнения результатов | Ferguson 2026 (ExtractBench) | Per-field evaluation + semantic matching |
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-questions.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-questions.md
new file mode 100644
index 0000000..f221f7f
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-v3-questions.md
@@ -0,0 +1,146 @@
+---
+title: "Autoresearch v3: все вопросы и задачи"
+type: note
+status: active
+project: tvplotlines
+---
+
+# Autoresearch v3: вопросы и задачи
+
+Сводный документ. Каждая задача — из конкретного источника (статья или ревью промптов). Ссылки на заметки где идея обоснована.
+
+Статус: `[ ]` — не начато, `[?]` — нужно обсудить, `[x]` — решено.
+
+---
+
+## 1. Pipeline architecture
+
+Источник: [Blueprint First](blueprint-first-qiu-2025.md) — tool consolidation, DC > всё остальное.
+
+- [ ] **Merge Pass 0 → Pass 1**: нужен ли Pass 0 отдельно? Экономия 1 LLM call. Уже пробовали (pass1_merged), откатили — но причины отката неясны, нужно перепроверить.
+- [ ] **Pass 3: LLM или код?** Какие verdicts можно вычислить детерминированно (MERGE по совпадению driver+goal, PROMOTE/DEMOTE по весам), какие требуют LLM суждения (REASSIGN, CREATE)?
+- [ ] **Длина промптов в tokens**: если >4K — "lost in the middle" реальна (Qiu, p.7), DC критичен.
+
+## 2. Code validation (Double Check)
+
+Источник: [Blueprint First](blueprint-first-qiu-2025.md) — DC даёт +11.7pp, мощнее структуры промпта.
+
+- [ ] **Список дублирующихся constraints**: что сейчас и в промпте, и в коде? Составить полный список, убрать из промптов.
+- [ ] **Усилить DC**: какие проверки код сейчас НЕ делает, но мог бы? (arc order, Story DNA completeness, naming convention)
+- [ ] **Re-request формат**: как сейчас выглядит сообщение об ошибке при re-request? Достаточно ли конкретное?
+
+## 3. Prompt structure (Blueprint First)
+
+Источник: [Blueprint First](blueprint-first-qiu-2025.md) — WHAT vs HOW; [ревью промптов](../../notes%20for%203rd%20autoresearch.md) — 60 замечаний.
+
+- [ ] **Единый скелет**: ROLE → DEFINITIONS → INPUT → TASK → OUTPUT → EXAMPLE. Применить ко всем 4 промптам.
+- [ ] **Убрать meta-комментарии**: "compiled from reference.md", "recompile from ADR-005", "result shown to human", цитаты с номерами страниц.
+- [ ] **Убрать HOW из промптов**: "If code detects an error — re-request" — это для кода, не для LLM.
+- [ ] **Одно определение — одно место**: не повторять, не противоречить. Contract и Input — объединить.
+
+## 4. Definitions (глоссарий → промпты)
+
+Источник: [ревью промптов](../../notes%20for%203rd%20autoresearch.md) — проблема 2 (глоссарий ≠ промпты); ожидается [GoLLIE](gollie-sainz-2024.md) — как форматировать определения.
+
+- [ ] **Глоссарий = ground truth**: franchise types, plotline, Story DNA, plot-led/character-led — брать из глоссария дословно.
+- [ ] **Цепочка Franchise Type → Story Engine → Story DNA**: есть в глоссарии, нет в промптах. Включить.
+- [ ] **Терминология**: `plotline` везде (не `storyline`). Проверить что не ломает extraction.
+- [ ] **Story DNA**: либо использовать везде как шортхэнд (с определением один раз), либо выкинуть. Сейчас — ни то ни другое.
+- [ ] **Logline test vs Story DNA**: test = 3 части (hero+goal+obstacle), DNA = 4 (+ stakes). Привести в соответствие.
+
+## 5. Мусорные поля и концепции
+
+Источник: [ревью промптов](../../notes%20for%203rd%20autoresearch.md) — проблема 3; нужна ablation чтобы решить.
+
+- [?] **format** (ongoing/limited/anthology): зачем? franchise type достаточно? Ablation: убрать → метрики изменились?
+- [?] **narrative devices**: зачем собираем? на что влияют? используются ли downstream? Ablation: убрать → ?
+- [?] **confidence**: где объясняется? как работает?
+- [?] **interactions**: зачем? где используются? Ablation: убрать → ?
+- [?] **patches**: что делают? нужны ли если усилить DC?
+- [?] **weight** (primary/background/glimpse): определение есть только в глоссарии, не в промпте.
+- [?] **episodic как тип**: не общепринятый термин. Замена?
+- [?] **"Seed and wraparound — not storyline types"**: зачем constraint на несуществующую проблему?
+
+## 6. Event functions
+
+Источник: [autoresearch-v3-event-functions.md](autoresearch-v3-event-functions.md), [event-functions-redesign.md](event-functions-redesign.md), глоссарий.
+
+- [ ] **Заменить таблицу функций в Pass 2**: cliffhanger/seed → catalyst/crisis. Глоссарий уже содержит правильные 7 функций.
+- [ ] **Описания функций**: как описать catalyst vs escalation? crisis vs climax? Нужны точные формулировки.
+- [ ] **Constraints по порядку**: какие функции после каких не могут быть? Какие могут повторяться? В код или в промпт?
+- [ ] **Все ли events имеют функцию?** Должны — но бывает всякое.
+
+## 7. Few-shot examples
+
+Источник: [CoT — Wei et al.](cot-wei-2022.md) — reasoning trace в примерах; ожидаются [DSPy](dspy-khattab-2024.md), [MIPRO](mipro-opsahl-ong-2024.md) — автоматический подбор примеров.
+
+- [ ] **Добавить reasoning trace в BB пример**: почему эти линии, почему такие ранги. Reasoning ДО JSON, не после.
+- [ ] **1 прогон с CoT vs 3 прогона без (voting)**: что стабильнее? что дешевле?
+- [ ] **Релевантные примеры по franchise type**: hybrid → пример из House, ensemble → из GoT. Сейчас везде BB (serial).
+- [ ] **Сколько примеров**: 1 (сейчас) vs 2-3 (three-shot). Стоимость vs качество.
+- [ ] **Bootstrapping примеров из собственных ошибок** (GoLLIE + DSPy): прогнать pipeline → код (DC) ловит ошибки (линии без obstacle, дубликаты, неправильные ранги) → ошибки становятся негативными примерами в определениях, удачные результаты → положительными. Скрипт, не фреймворк.
+
+## 8. Prior season continuity
+
+Источник: [ревью промптов](../../notes%20for%203rd%20autoresearch.md) — P1 замечания по prior_season.
+
+- [?] **TRANSFORMED**: бывает ли в реальности? Есть ли в теории (Nash, Douglas)?
+- [?] **ENDED**: что помечаем если линии нет? Логика непонятна.
+- [ ] **Откуда берётся prior_season**: объяснить в промпте или убрать из промпта (код инжектирует).
+
+## 9. Metrics и evaluation
+
+Источник: ожидается [ExtractBench](extractbench-ferguson-2026.md) — метрики для nested JSON.
+
+- [ ] **Baseline по существующим 13 результатам**: coverage, ARI, + что ещё?
+- [ ] **Как сравнивать два JSON** (старый промпт vs новый): per-field? semantic matching для массивов?
+- [ ] **LLM-as-judge**: чеклист для оценки результата (Story DNA complete? ранги соответствуют весам? дубликатов нет?)
+- [ ] **function_score** (arc completeness + order + distribution): формулу нужно пересмотреть с учётом фрактальной арки.
+
+## 10. Autoresearch method
+
+Источник: ожидаются [OPRO](opro-yang-2023.md), [TextGrad](textgrad-yuksekgonul-2024.md), [MIPRO](mipro-opsahl-ong-2024.md).
+
+- [ ] **Метод оптимизации**: OPRO vs TextGrad vs ручной A/B — что подходит для наших промптов?
+- [ ] **Train/test split**: 8 шоу train, 4 test? Или иначе? По franchise type?
+- [ ] **Новые сериалы**: нужны ли для test set шоу которых pipeline никогда не видел?
+- [ ] **Бюджет**: сколько прогонов, сколько стоит каждый, общий лимит.
+- [ ] **Ablation study**: убирать компоненты по одному (format, devices, interactions, Pass 0, Pass 3) и замерять.
+
+## 11. Structured reasoning (CoT/ToT/GoT)
+
+Источник: [CoT — Wei et al.](cot-wei-2022.md), [ToT — Yao et al.](tot-yao-2023.md), [GoT — Besta et al.](got-besta-2024.md).
+
+### Что применимо без натяжек
+
+**CoT → reasoning trace в few-shot примерах** (конкретная задача):
+- [ ] Добавить reasoning ДО JSON в BB пример для всех промптов. Wei доказал: reasoning до ответа улучшает, после — нет.
+- [ ] Сравнить: 1 прогон с CoT-примером vs 3 прогона без (voting/CoT-SC). Если 1 с CoT ≥ 3 без — экономия 3x.
+
+**GoT → формализация pipeline для preprint** (не код, а описание):
+- [ ] Наш pipeline = GoT pattern: Generate (Pass 1) → Decompose per episode (Pass 2) → Aggregate + Refine (Pass 3). Нарисовать GoO diagram.
+- [ ] Сослаться на GoT framework (Besta) и Blueprint First (Qiu) как формальные основания архитектуры.
+
+### Что снято (не обосновано)
+
+- ~~ToT для замены 3x voting~~ — наша задача extraction, не search. ToT решает задачи с backtracking (Game of 24, кроссворды), у нас нет дерева вариантов.
+- ~~ToT generate plans → vote → fill~~ — спекуляция, нет оснований что это лучше текущего подхода.
+- ~~GoT decomposition для Pass 1 (по персонажам)~~ — усложнение без доказанной пользы.
+
+### Полезно для понимания
+
+Yao (Figure 1) формализовал наш 3x voting как CoT-SC. Это даёт точный язык: мы знаем что делаем, знаем ограничения (CoT-SC не помогает если ошибка систематическая, а не случайная).
+
+---
+
+## Порядок работы (черновик, уточнится после чтения статей)
+
+1. Baseline по 13 существующим результатам
+2. Ablation: убирать мусорные поля по одному, замерять
+3. Структурный рефакторинг промптов (Blueprint First скелет)
+4. Определения из глоссария
+5. Терминология (plotline)
+6. Event functions
+7. CoT в примерах
+8. Autoresearch loop по формулировкам
+9. Валидация на test set
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-reading-plan.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-reading-plan.md
new file mode 100644
index 0000000..69c6e40
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-v3-reading-plan.md
@@ -0,0 +1,169 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# План чтения статей для autoresearch v3
+
+Мы проектируем autoresearch для переписывания промптов tvplotlines. Прежде чем писать план, нужно прочитать 7 статей. Ниже — что искать в каждой, какие вопросы закрыть, и в каком порядке читать.
+
+## Порядок чтения
+
+Читать в этом порядке — каждая следующая опирается на предыдущие.
+
+---
+
+### 1. GoLLIE (уже в Zotero, помечена `2read`)
+
+**Что это:** Annotation guidelines в промпте улучшают zero-shot information extraction.
+
+**Ссылка:** В Zotero, key `XBVCW78U`. Или: https://arxiv.org/abs/2310.03668
+
+**Зачем нам:** Это прямо про наш случай — мы даём LLM определения (franchise type, plotline, Story DNA) и ожидаем что она по ним извлекает структуру. GoLLIE показывает как правильно формулировать эти определения чтобы extraction работал лучше.
+
+**Что искать:**
+- Как они форматируют annotation guidelines? Есть ли у них "шаблон" определения?
+- Как измеряют качество? Какие метрики для IE?
+- Помогает ли давать негативные примеры ("что NOT является X")?
+- Влияет ли порядок определений на качество?
+
+**Какой вопрос закрывает:** как правильно написать секцию DEFINITIONS в наших промптах (Blueprint First). Как определения из глоссария переводить в формат промпта.
+
+---
+
+### 2. Blueprint First, Model Second (Qiu et al., 2025)
+
+**Ссылка:** https://arxiv.org/abs/2508.02721
+
+**Зачем нам:** Формализует то что tvplotlines уже делает (pipeline с code validation), но может подсказать как сделать лучше. Принцип: код решает workflow, LLM только для bounded subtasks.
+
+**Что искать:**
+- Как они структурируют "Execution Blueprint"? Есть ли формат/шаблон?
+- Какие subtasks отдают LLM, какие — коду? Есть ли критерий разделения?
+- Как обрабатывают ошибки LLM? Retry? Fallback?
+- Сравнение с подходом "дать LLM всю задачу целиком" — на сколько лучше modular?
+
+**Какой вопрос закрывает:** что из наших промптов нужно вынести в код (validation rules, constraints, ранжирование по весам). Какая архитектура промпта оптимальна.
+
+---
+
+### 3. DSPy (Khattab et al., ICLR 2024)
+
+**Ссылка:** https://arxiv.org/abs/2310.03714
+
+**Зачем нам:** Идея "промпт = компилируемая программа с сигнатурой". Мы не будем использовать DSPy фреймворк напрямую, но концепция composable modules + automatic optimization релевантна.
+
+**Что искать:**
+- Формат "signature" — как описывают вход/выход модуля? Можем ли адаптировать для наших Pass?
+- Как работает оптимизация инструкций? Что именно оптимизируется — текст, примеры, оба?
+- Multi-stage pipeline — как модули связываются? Как результат одного модуля передаётся другому?
+- Метрики — как DSPy оценивает качество pipeline?
+
+**Какой вопрос закрывает:** можно ли автоматически подбирать few-shot примеры для каждого Pass. Как формализовать контракт между пассами.
+
+**Внимание:** статья длинная и техническая. Можно ограничиться секциями 1-3 (концепция) + 5 (эксперименты). Детали реализации (секция 4) — по желанию.
+
+---
+
+### 4. MIPRO (EMNLP 2024) — оптимизатор DSPy
+
+**Ссылка:** https://arxiv.org/abs/2406.11695
+
+**Зачем нам:** Конкретный алгоритм оптимизации для multi-stage pipeline. Оптимизирует инструкции + few-shot примеры совместно. Ближе всего к тому что нам нужно.
+
+**Что искать:**
+- Как работает "grounded proposal" — LLM видит код программы + данные + traces и предлагает инструкции?
+- Сколько прогонов нужно для оптимизации? Какой бюджет?
+- Как они решают проблему "оптимизирую один модуль — ломаю другой"?
+- Результаты на multi-stage задачах — насколько улучшение vs human-written?
+
+**Какой вопрос закрывает:** сколько будет стоить autoresearch (количество прогонов). Как избежать ситуации "поправил Pass 1 — сломал Pass 2".
+
+**Совет:** читать после DSPy, иначе контекст будет непонятен.
+
+---
+
+### 5. OPRO (DeepMind, 2023)
+
+**Ссылка:** https://arxiv.org/abs/2309.03409
+
+**Зачем нам:** Самый простой подход к оптимизации промптов. LLM видит прошлые варианты + их scores, генерирует новый вариант. Можем использовать для оптимизации формулировок определений (как описать catalyst, crisis и т.д.).
+
+**Что искать:**
+- Формат "meta-prompt" — как подаётся история попыток?
+- Работает ли на длинных промптах или только на коротких инструкциях?
+- Сколько итераций до сходимости?
+- Ограничения — где не работает?
+
+**Какой вопрос закрывает:** подходит ли OPRO для оптимизации описаний event functions (catalyst, crisis) или нужно что-то сложнее.
+
+---
+
+### 6. TextGrad (Stanford→Nature, 2024)
+
+**Ссылка:** https://arxiv.org/abs/2406.07496
+
+**Зачем нам:** "Текстовые градиенты" — LLM даёт текстовый feedback на результат, этот feedback используется для улучшения компонентов. Идея: прогнали pipeline → LLM-judge говорит "storyline X выглядит как дубликат Y" → этот feedback корректирует промпт.
+
+**Что искать:**
+- Как работает "backpropagation" через текст? Как feedback от конца pipeline доходит до начала?
+- Можно ли оптимизировать отдельные секции промпта, а не весь?
+- Сравнение с OPRO — когда лучше TextGrad, когда OPRO?
+- Примеры оптимизации промптов (не только кода/молекул)
+
+**Какой вопрос закрывает:** можно ли использовать LLM-as-judge не просто как scorer (хорошо/плохо), а как источник конкретных правок ("в определении catalyst не хватает X").
+
+---
+
+### 7. ExtractBench (KDD 2026)
+
+**Ссылка:** https://arxiv.org/abs/2602.12247
+
+**Зачем нам:** Бенчмарк для structured extraction в JSON. Показывает что ширина схемы (количество полей) — главный предиктор провала. Метрики для оценки nested extraction.
+
+**Что искать:**
+- Какие метрики они используют для сравнения extracted JSON с ground truth?
+- "Semantic array matching" — как сравнивают массивы (у нас events[], plotlines[])?
+- Как обрабатывают null и отсутствующие поля?
+- Рекомендации по размеру схемы — сколько полей нормально?
+
+**Какой вопрос закрывает:** какие метрики использовать в autoresearch для оценки качества извлечения. Как сравнивать два JSON результата (старый промпт vs новый).
+
+---
+
+## Опциональное чтение
+
+### Survey of Automatic Prompt Optimization (уже в Zotero, помечена `read`)
+Key `KDKFV7TA`. Если не помнишь — пролистать ещё раз чтобы убедиться что мы не упускаем подходы кроме OPRO/TextGrad/MIPRO.
+
+### Narrative Trails (уже в Zotero, 7 дубликатов — нужно мержить)
+Coherent storyline extraction via maximum capacity path optimization. Другой подход к нашей задаче — graph-based вместо LLM. Интересно сравнить, но не блокирует autoresearch.
+
+---
+
+## Чеклист: что нужно закрыть после чтения
+
+После прочтения у нас должны быть ответы на:
+
+- [ ] **Формат определений в промпте** — как правильно писать секцию DEFINITIONS (из GoLLIE)
+- [ ] **Что вынести в код** — конкретный список constraints/validations для выноса из промптов (из Blueprint First)
+- [ ] **Контракт между пассами** — как формализовать вход/выход каждого Pass (из DSPy)
+- [ ] **Стоимость autoresearch** — сколько прогонов нужно, какой бюджет закладывать (из MIPRO)
+- [ ] **Метод оптимизации** — OPRO vs TextGrad vs ручной A/B — что подходит для наших промптов
+- [ ] **Метрики** — как сравнивать JSON результаты старого и нового промпта (из ExtractBench)
+- [ ] **Few-shot стратегия** — один пример (BB) vs несколько vs подбор по franchise type (из DSPy/MIPRO)
+
+---
+
+## Где статьи
+
+| # | Статья | Где взять |
+|---|--------|-----------|
+| 1 | GoLLIE | Zotero (`2read`) или arxiv 2310.03668 |
+| 2 | Blueprint First | arxiv 2508.02721 |
+| 3 | DSPy | arxiv 2310.03714 |
+| 4 | MIPRO | arxiv 2406.11695 |
+| 5 | OPRO | arxiv 2309.03409 |
+| 6 | TextGrad | arxiv 2406.07496 |
+| 7 | ExtractBench | arxiv 2602.12247 |
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-todo.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-todo.md
new file mode 100644
index 0000000..3e8853c
--- /dev/null
+++ b/docs/knowledge/archive/autoresearch/autoresearch-v3-todo.md
@@ -0,0 +1,101 @@
+---
+type: plan
+project: tvplotlines
+status: active
+date: 2026-03-23
+---
+
+# Autoresearch v3: план работы
+
+Рецензия: [[tvplotlines-autoresearch-v3-engineering-review]]
+Эвристики: [[tvplotlines-heuristics-from-theory]]
+
+---
+
+## Фаза 1: Подготовка (чтение + решения)
+
+Бриф для чтения учебников: [[tvplotlines-screenwriting-theory-reading-prompt]]
+
+- [x] Прочитать GoLLIE (формат определений в промпте) → [[read-sainz-2024-gollie]]
+- [x] Прочитать Blueprint First (что вынести в код) → [[read-qiu-2025-blueprint-first]]
+- [x] Прочитать ExtractBench (метрики для JSON extraction) → [[read-ferguson-2026-extractbench]]
+- [ ] Верифицировать event functions по каноническим источникам
+	- [x] Сравнить наши 7 с Nash, McKee, Netflix/Kessler — маппинги записаны в заметках (read-nash, read-mckee, read-oberg, read-freytag)
+	- [ ] **Зафиксировать решение:** сколько функций (5? 7?), какие именно, на основе какого источника. Предыдущий кандидат в [[tvplotlines-event-functions-redesign]]: 7 (setup, catalyst, escalation, turning_point, crisis, climax, resolution). Seed/cliffhanger → модификаторы. Нужно подтвердить или пересмотреть
+	- [ ] Записать маппинг в глоссарий
+- [x] Набрать эвристики порядка функций из учебников → Nash: строгий порядок, гибкий тайминг. Escalation после turning_point нормально (Bad Guys Close In). Catalyst не повторяется. Серия escalation в середине = нормально (Fun & Games). McKee: Act Rhythm — два последних climax чередуют заряд +/-. См. заметки Nash, McKee
+- [x] Набрать эвристики episode completeness → два уровня арки (эпизод vs сезон). В serial resolution арки не в каждом эпизоде, но resolution событий эпизода — да. В procedural case = полная арка per episode. В Wire-style serial эпизод может не иметь episodic closure вообще. См. заметки Nash, Douglas, Mittell
+- [x] Решить: A-rank = всегда plot-led? → **Нет.** Douglas: A может быть character-led (NYPD Blue). Oberg: story-type = атрибут plotline, не rank. Landau: A = franchise (episode level), Douglas: A = most resonant (series level) — разные уровни, не противоречие
+- [x] Решить: "episodic" как тип линии → заменить на `procedural_scope: episode | season | none` как атрибут plotline. Franchise type вычисляемый из plotlines
+- [x] Решить: narrative devices → **убрать `devices` как поле** (и на plotline, и на event). Mystery = goal, suspense = discourse (не извлекаем), callback = seed (function), twist = turning_point (function), unreliable = discourse. Dramatic irony остаётся как interaction type. Flashback/flashforward → отдельное поле event (temporal), посмотрим где срабатывает
+- [x] Решить: interactions → оставить convergence, dramatic_irony, thematic_rhyme. **Убрать meta** (расплывчатое). Задача для app: визуализация interactions в аналитике
+- [x] Решить: hybrid vs procedural → `procedural_scope` на plotline определяет franchise type. Episode-scope = procedural/hybrid, season-scope = serial с сезонным procedural element, none = pure serial. В hybrid case-of-the-week = B по умолчанию (гипотеза на проверку)
+- [ ] Объединить [[tvplotlines-event-functions-redesign]] и [[tvplotlines-autoresearch-v3-event-functions]] в один документ, архивировать оригиналы
+
+### Новые решения из чтения книг (2026-03-23)
+
+Чтение: Nash, McKee, Douglas, Oberg, Landau (оба), Mittell. Заметки: `read-nash-2022-*`, `read-mckee-1997-*`, `read-douglas-2011-*`, `read-oberg-2023-*`, `read-landau-2018-*`, `read-mittell-2015-*`.
+
+- [ ] **Story-type** (plot-led / character-led / theme-led) — новый атрибут plotline. Эвристика: "откуда приходит проблема?" Задаёт ожидания для проверки DNA. Story-type у линии и у события — разные вещи (событие = plot-led action внутри character-led арки). Pass 3 может уточнить. Источник: Oberg
+- [ ] **Переименовать driver → hero** в Story DNA. Совпадает с Nash ("Story DNA: Hero, Goal, Obstacle, Stakes"). Hero = hero данной plotline, не сериала. Источник: Nash
+- [ ] **Kernel/satellite** — потенциальный вычисляемый атрибут события (weight). Kernel = убрать → plot ломается. Satellite = убрать → plot выживет. Приблизительно: also_affects + function catalyst/turning_point/climax → kernel. Escalation без also_affects → satellite. Для визуализации в app. Источник: Mittell/Chatman, books2series compute_landmarks()
+- [ ] **Oberg: конкретные пропорции A/B/C** для procedural: A=50%, B=33%, C=17%. Max 4-5 plotlines per episode. Runners = 3-5 beats. ~27-30 scenes per hour episode. Использовать как baseline для валидации
+- [ ] **Landau: Central Question (future) vs Central Mystery (past)** — два типа goal. Goal может быть forward-looking или backward-looking. Для промпта: подсказать LLM что goal формулируется через глагол
+
+## Фаза 2: Инженерная чистка (код + промпты, без autoresearch)
+
+**Prerequisite — до начала фазы 2 должны быть готовы:**
+1. [ ] Глоссарий — ground truth для всех определений (franchise types, plotline, Story DNA, event functions, типы линий)
+2. [ ] Эвристики из учебников — заполненные таблицы в [[tvplotlines-heuristics-from-theory]] (порядок функций, episode completeness, количество линий по franchise type)
+3. [ ] Верифицированные event functions — какие, на основе какого источника, с маппингом
+4. [ ] Решения по спорным полям — narrative devices, interactions, episodic, A-rank = plot-led?, format, patches, confidence
+5. [ ] Список constraints для переноса в код — полный перечень того что сейчас в промптах как текст, а должно быть проверкой в коде
+
+Стратегия: одно изменение → прогон → сравнить с baseline → если упало → откатить.
+
+- [ ] `storyline → plotline` везде
+- [ ] Глоссарий = ground truth для определений в промптах
+- [ ] Blueprint First скелет промпта: ROLE → DEFINITIONS → INPUT → TASK → OUTPUT → EXAMPLE
+- [ ] Убрать meta-комментарии, цитаты с номерами страниц, двойные описания input/contract
+- [ ] Убрать HOW-инструкции из промптов ("If code detects an error — re-request")
+- [ ] Constraints из промптов → в код (составить полный список, перенести)
+- [ ] Event functions: заменить `cliffhanger/seed` на `catalyst/crisis` (верифицированные в фазе 1)
+- [ ] Merge Pass 0 → Pass 1
+- [ ] `format`, `patches` — убрать из промптов
+- [ ] `narrative devices` — по решению из фазы 1
+- [ ] `interactions` — по решению из фазы 1
+- [ ] Реализовать в коде: episode completeness (факт, без порогов)
+- [ ] Реализовать в коде: arc completeness (факт, без порогов)
+- [ ] Реализовать в коде: валидация порядка функций (по эвристикам из фазы 1)
+- [ ] Реализовать в коде: Story DNA completeness (non-runner + solid → все поля непустые)
+- [ ] Реализовать в коде: количество линий в диапазоне по franchise type
+
+## Фаза 3: Проверка чистки
+
+- [ ] Прогон на 12 шоу [$10-15]
+- [ ] Сравнить с v2-10 baseline (mean 0.0588)
+- [ ] Если деградация > 5%: найти какое изменение сломало, откатить, тестировать отдельно
+- [ ] Визуальная проверка BB S01 + 1-2 других шоу
+
+## Фаза 4: Ablation study (autoresearch) [$30-40]
+
+- [ ] Подготовить 3 условия: A (naive) / B (минимальный scaffold) / C (полный scaffold)
+- [ ] Прогнать на 5 шоу × 3 условия × 1-3 прогона
+- [ ] Измерить: `coh_sep`, `coverage`, `ARI`, episode/arc completeness
+- [ ] Показать: C > B > A
+- [ ] Объединить с [[tvplotlines-naive-vs-tvplotlines]] (naive = условие A)
+
+## Фаза 5: Оптимизация (autoresearch) [$20-30]
+
+- [ ] CoT reasoning trace в few-shot примерах (1 прогон с CoT vs 3 без)
+- [ ] Формулировки описаний event functions (catalyst vs escalation и т.д.)
+- [ ] Подбор примеров по franchise type (BB для serial, House для procedural)
+
+## Фаза 6: Валидация
+
+- [ ] Прогнать лучший вариант на held-out set (шоу, которых pipeline не видел при оптимизации)
+- [ ] Калибровать пороги episode/arc completeness post-hoc по результатам 12 шоу
+
+---
+
+Бюджет: ~$60-85. Каждая фаза — checkpoint.
diff --git a/docs/knowledge/archive/plans/2026-03-16-prior-season-continuity-design.md b/docs/knowledge/archive/plans/2026-03-16-prior-season-continuity-design.md
new file mode 100644
index 0000000..af46374
--- /dev/null
+++ b/docs/knowledge/archive/plans/2026-03-16-prior-season-continuity-design.md
@@ -0,0 +1,145 @@
+# Design: Prior Season Continuity
+
+**Date:** 2026-03-16
+**Status:** Approved
+**Scope:** Add `prior: TVPlotlinesResult | None` parameter for multi-season continuity
+
+## Problem
+
+Each season is processed independently. When running Season 2, the pipeline has no knowledge of Season 1's characters or plotlines. This causes:
+
+1. Pass 1 may "rediscover" characters with different IDs (e.g. `walter` instead of `walt`)
+2. Continuing plotlines get new IDs instead of reusing existing ones (e.g. `drug_business` instead of `empire`)
+3. No explicit tracking of which plotlines continue vs. end between seasons
+
+## Solution
+
+One new parameter: `prior: TVPlotlinesResult | None` in `get_plotlines()`.
+
+### Usage
+
+```python
+r1 = get_plotlines("Breaking Bad", 1, episodes_s01)
+r2 = get_plotlines("Breaking Bad", 2, episodes_s02, prior=r1)
+r3 = get_plotlines("Breaking Bad", 3, episodes_s03, prior=r2)
+```
+
+The caller stores results and passes the previous season's result. Library remains stateless.
+
+## Changes by Pass
+
+### Pass 0 — skip if prior provided
+
+If `prior` is provided and `context` is not explicitly passed, reuse `prior.context`. Same show, same franchise type — no need to re-detect.
+
+### Pass 1 — inject prior cast + plotlines into prompt
+
+**Code change (`pass1.py`):**
+
+Add `prior_cast` and `prior_plotlines` parameters to `extract_plotlines()`. When provided, include a `prior_season` block in the user message JSON:
+
+```python
+if prior_cast and prior_plotlines:
+    user_data["prior_season"] = {
+        "cast": [{"id": c.id, "name": c.name, "aliases": c.aliases} for c in prior_cast],
+        "plotlines": [
+            {
+                "id": p.id, "name": p.name, "driver": p.driver,
+                "goal": p.goal, "obstacle": p.obstacle, "stakes": p.stakes,
+                "type": p.type, "rank": p.rank,
+            }
+            for p in prior_plotlines
+        ],
+    }
+```
+
+Note: explicit dict construction, not `asdict()`. Excludes `span` (computed post-hoc metadata), `confidence`, `nature`, and `devices` — not needed for continuity decisions.
+
+**Prompt change (`pass1.md` / `pass1.md` en):**
+
+Add section after "## Input". Also update "## Task" to reference prior workflow:
+
+> Read ALL season synopses. **If `prior_season` data is provided, first process prior plotlines (see Prior season section), then identify new plotlines.** Extract the list of plotlines and the main cast.
+
+New section:
+
+```
+## Prior season (if provided)
+
+If `prior_season` is present in the input, it contains cast and plotlines from the
+previous season. Process them BEFORE analyzing new synopses:
+
+For each plotline in `prior_season.plotlines`, decide based on the NEW season's synopses:
+- **CONTINUES** — the plotline is present this season. Keep the same `id`, update
+  goal/obstacle/stakes to reflect the new season's material.
+- **TRANSFORMED** — same driver, but goal fundamentally changed. Keep the `id`,
+  rewrite Story DNA.
+- **ENDED** — the plotline resolved or disappeared. Don't include it.
+
+For each character in `prior_season.cast`:
+- If the character appears in this season's synopses — reuse the same `id` and `name`.
+- If the character does not appear — don't include them.
+
+Only after processing all prior plotlines, identify NEW plotlines not present before.
+```
+
+**Validation (code, `pass1.py`):**
+
+After voting selection (post-voting, not inside `_full_validate`), check for suspicious overlaps: if a new plotline has the same `driver` as a prior plotline that wasn't continued, log a warning. No hard block — majority voting (3 rounds) reduces randomness.
+
+### Pass 2 — no changes
+
+Works with Pass 1 output which already has correct IDs.
+
+### Pass 3 — no changes
+
+Pass 3 does not receive prior season data. It reviews the current season's plotlines independently.
+
+### Pipeline (`pipeline.py`)
+
+```python
+def get_plotlines(
+    show: str,
+    season: int,
+    episodes: list[str],
+    *,
+    prior: TVPlotlinesResult | None = None,  # NEW
+    context: SeriesContext | None = None,
+    cast: list[CastMember] | None = None,
+    plotlines: list[Plotline] | None = None,
+    ...
+) -> TVPlotlinesResult:
+```
+
+Logic:
+
+1. If `prior` is provided and `context.format == "anthology"` → raise `ValueError` (anthology seasons are independent by definition)
+2. If `prior` is provided and `context` is None → `context = prior.context`
+3. If `prior` is provided and `cast` is None → pass `prior.cast` and `prior.plotlines` to `extract_plotlines()`
+4. If `prior` is provided but `cast`/`plotlines` are also provided (Pass 1 skip) → `prior` only affects Pass 0 context reuse. The caller is responsible for continuity in manually-provided data.
+5. Everything else unchanged
+
+## Files to modify
+
+| File | Change |
+|------|--------|
+| `pipeline.py` | Add `prior` parameter, wire to Pass 0 skip + Pass 1 |
+| `pass1.py` | Add `prior_cast`, `prior_plotlines` params; inject into user message; add overlap warning |
+| `prompts_en/pass1.md` | Add "Prior season" section |
+| `prompts/pass1.md` | Add "Prior season" section (Russian) |
+| `docs/api.md` | Document `prior` parameter |
+
+## Out of scope
+
+- Cross-season analysis (comparing plotline evolution across all seasons) — separate future feature
+- Passing multiple prior seasons — `prior` is the immediately previous season only; caller chains results
+- Changes to Pass 2 or Pass 3 prompts
+
+## Design decisions
+
+1. **One parameter, not two.** `prior: TVPlotlinesResult` instead of separate `prior_cast` + `prior_plotlines`. Simpler API, no ambiguity.
+2. **Library is stateless.** Caller stores results and chains them. No internal tracking.
+3. **Prior is a hint, not a constraint.** LLM is free to ignore prior plotlines that don't appear in new synopses. Prompt forces explicit decision per prior plotline to reduce hallucination.
+4. **Reuse context from prior.** Same show → same franchise type. Saves one LLM call.
+5. **Anthology guard.** `prior` + `format="anthology"` raises ValueError — anthology seasons are independent by definition.
+6. **Explicit dict construction.** No `asdict()` — exclude `span` and other computed fields from prior data sent to LLM.
diff --git a/docs/knowledge/archive/plans/2026-03-16-prior-season-continuity.md b/docs/knowledge/archive/plans/2026-03-16-prior-season-continuity.md
new file mode 100644
index 0000000..cf75ec1
--- /dev/null
+++ b/docs/knowledge/archive/plans/2026-03-16-prior-season-continuity.md
@@ -0,0 +1,651 @@
+# Prior Season Continuity — Implementation Plan
+
+> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Add `prior: TVPlotlinesResult | None` parameter to `get_plotlines()` for multi-season continuity.
+
+**Architecture:** One new parameter flows through pipeline.py → pass0 skip + pass1 injection. Prior cast/plotlines are serialized (without computed fields) and injected into the Pass 1 user message. Prompts in both languages get a new section instructing the LLM to process prior plotlines before identifying new ones.
+
+**Tech Stack:** Python, pytest, existing tvplotlines pipeline
+
+**Spec:** `docs/2026-03-16-prior-season-continuity-design.md`
+
+---
+
+## Chunk 1: Pipeline + Pass 1 code changes
+
+### Task 1: Add `prior` parameter to pipeline.py
+
+**Files:**
+- Modify: `src/tvplotlines/pipeline.py:30-47` (function signature)
+- Modify: `src/tvplotlines/pipeline.py:89-98` (Pass 0 + Pass 1 wiring)
+- Test: `tests/test_pipeline_prior.py`
+
+- [ ] **Step 1: Write failing test — prior reuses context (skips Pass 0)**
+
+```python
+# tests/test_pipeline_prior.py
+"""Tests for prior season continuity in pipeline."""
+
+import pytest
+
+from tvplotlines.models import (
+    CastMember,
+    Plotline,
+    TVPlotlinesResult,
+    SeriesContext,
+)
+
+
+def _make_prior() -> TVPlotlinesResult:
+    ctx = SeriesContext(
+        franchise_type="serial",
+        story_engine="A teacher builds a drug empire",
+        genre="drama",
+        format="ongoing",
+    )
+    cast = [
+        CastMember(id="walt", name="Walter White", aliases=["Walt"]),
+        CastMember(id="jesse", name="Jesse Pinkman", aliases=["Jesse"]),
+    ]
+    plotlines = [
+        Plotline(
+            id="empire", name="Walt: Empire", driver="walt",
+            goal="build a drug business", obstacle="morality", stakes="death",
+            type="serialized", rank="A", nature="plot-led", confidence="solid",
+        ),
+    ]
+    return TVPlotlinesResult(context=ctx, cast=cast, plotlines=plotlines)
+
+
+class TestPriorContextReuse:
+    def test_prior_provides_context_when_context_is_none(self, monkeypatch):
+        """If prior is given and context is not, pipeline should use prior.context
+        and NOT call detect_context (Pass 0)."""
+        from unittest.mock import MagicMock
+        import tvplotlines.pipeline as pipeline_mod
+
+        prior = _make_prior()
+        # Mock detect_context to verify it's NOT called
+        mock_detect = MagicMock(side_effect=AssertionError("Pass 0 should be skipped"))
+        monkeypatch.setattr(pipeline_mod, "detect_context", mock_detect)
+        # Mock extract_plotlines to avoid LLM call
+        mock_extract = MagicMock(return_value=(prior.cast, prior.plotlines))
+        monkeypatch.setattr(pipeline_mod, "extract_plotlines", mock_extract)
+
+        # Will fail at Pass 2, but we only care about Pass 0 + Pass 1
+        try:
+            pipeline_mod.get_plotlines("Breaking Bad", 2, ["synopsis"], prior=prior)
+        except Exception:
+            pass
+
+        mock_detect.assert_not_called()
+        mock_extract.assert_called_once()
+        # Verify prior_cast and prior_plotlines were forwarded
+        call_kwargs = mock_extract.call_args.kwargs
+        assert call_kwargs["prior_cast"] == prior.cast
+        assert call_kwargs["prior_plotlines"] == prior.plotlines
+
+    def test_prior_ignored_when_cast_and_plotlines_provided(self, monkeypatch):
+        """When cast+plotlines are provided (Pass 1 skip), prior only affects context."""
+        from unittest.mock import MagicMock
+        import tvplotlines.pipeline as pipeline_mod
+
+        prior = _make_prior()
+        explicit_cast = [CastMember(id="custom", name="Custom")]
+        explicit_plotlines = [
+            Plotline(
+                id="custom_line", name="Custom", driver="custom",
+                goal="g", obstacle="o", stakes="s",
+                type="serialized", rank="A", nature="plot-led", confidence="solid",
+            ),
+        ]
+        # Mock extract_plotlines — should NOT be called
+        mock_extract = MagicMock()
+        monkeypatch.setattr(pipeline_mod, "extract_plotlines", mock_extract)
+
+        try:
+            pipeline_mod.get_plotlines(
+                "Breaking Bad", 2, ["synopsis"],
+                prior=prior, cast=explicit_cast, plotlines=explicit_plotlines,
+            )
+        except Exception:
+            pass
+
+        mock_extract.assert_not_called()
+
+    def test_anthology_raises_with_prior(self):
+        """Anthology format + prior is contradictory."""
+        from tvplotlines.pipeline import get_plotlines
+
+        prior = _make_prior()
+        prior.context.format = "anthology"
+        with pytest.raises(ValueError, match="anthology"):
+            get_plotlines(
+                "Test Show", 2, ["synopsis"],
+                prior=prior,
+            )
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `cd /Users/nvashko/Projects/1-projects/plotter && python -m pytest tests/test_pipeline_prior.py -v`
+Expected: FAIL — `get_plotlines()` doesn't accept `prior` parameter yet.
+
+- [ ] **Step 3: Implement prior parameter in pipeline.py**
+
+In `src/tvplotlines/pipeline.py`, modify `get_plotlines()`:
+
+```python
+def get_plotlines(
+    show: str,
+    season: int,
+    episodes: list[str],
+    *,
+    prior: TVPlotlinesResult | None = None,
+    context: SeriesContext | None = None,
+    cast: list[CastMember] | None = None,
+    plotlines: list[Plotline] | None = None,
+    breakdowns: list[EpisodeBreakdown] | None = None,
+    llm_provider: str = "anthropic",
+    model: str | None = None,
+    base_url: str | None = None,
+    lang: str = "en",
+    skip_review: bool = False,
+    pass2_mode: str = "parallel",
+    batch_id: str | None = None,
+    callback: PipelineCallback | None = None,
+) -> TVPlotlinesResult:
+```
+
+Add validation + context reuse after existing validation block:
+
+```python
+    # Validate prior parameter
+    if prior is not None:
+        prior_context = context or prior.context
+        if prior_context.format == "anthology":
+            raise ValueError(
+                "prior is not supported for anthology format "
+                "(anthology seasons are independent by definition)"
+            )
+        if context is None:
+            context = prior.context
+```
+
+Modify Pass 1 call to pass prior data:
+
+```python
+    # Pass 1: extract cast and plotlines from all synopses
+    if cast is None:
+        cast, plotlines = extract_plotlines(
+            show, season, context, episodes,
+            prior_cast=prior.cast if prior else None,
+            prior_plotlines=prior.plotlines if prior else None,
+            config=config,
+        )
+```
+
+- [ ] **Step 4: Run test to verify anthology guard passes**
+
+Run: `cd /Users/nvashko/Projects/1-projects/plotter && python -m pytest tests/test_pipeline_prior.py::TestPriorContextReuse::test_anthology_raises_with_prior -v`
+Expected: PASS
+
+- [ ] **Step 5: Commit**
+
+```bash
+cd /Users/nvashko/Projects/1-projects/plotter
+git add src/tvplotlines/pipeline.py tests/test_pipeline_prior.py
+git commit -m "Add prior parameter to get_plotlines with anthology guard"
+```
+
+---
+
+### Task 2: Add prior injection to pass1.py
+
+**Files:**
+- Modify: `src/tvplotlines/pass1.py:27-62` (extract_plotlines signature + user message)
+- Test: `tests/test_pass1_prior.py`
+
+- [ ] **Step 1: Write failing test — prior_season block in user message**
+
+```python
+# tests/test_pass1_prior.py
+"""Tests for prior season data injection in Pass 1."""
+
+import json
+
+from tvplotlines.models import CastMember, Plotline, SeriesContext
+from tvplotlines.pass1 import _build_user_message
+
+
+def _make_context():
+    return SeriesContext(
+        franchise_type="serial",
+        story_engine="A teacher builds a drug empire",
+        genre="drama",
+        format="ongoing",
+    )
+
+
+def _make_prior_cast():
+    return [
+        CastMember(id="walt", name="Walter White", aliases=["Walt"]),
+        CastMember(id="jesse", name="Jesse Pinkman", aliases=["Jesse"]),
+    ]
+
+
+def _make_prior_plotlines():
+    return [
+        Plotline(
+            id="empire", name="Walt: Empire", driver="walt",
+            goal="build a drug business", obstacle="morality", stakes="death",
+            type="serialized", rank="A", nature="plot-led", confidence="solid",
+            span=["S01E01", "S01E07"],  # should be excluded from prior
+        ),
+    ]
+
+
+class TestBuildUserMessage:
+    def test_without_prior(self):
+        msg = _build_user_message("Breaking Bad", 2, _make_context(), ["ep1", "ep2"])
+        data = json.loads(msg)
+        assert "prior_season" not in data
+
+    def test_with_prior(self):
+        msg = _build_user_message(
+            "Breaking Bad", 2, _make_context(), ["ep1", "ep2"],
+            prior_cast=_make_prior_cast(),
+            prior_plotlines=_make_prior_plotlines(),
+        )
+        data = json.loads(msg)
+        assert "prior_season" in data
+        prior = data["prior_season"]
+        # Cast present with correct fields
+        assert len(prior["cast"]) == 2
+        assert prior["cast"][0]["id"] == "walt"
+        # Plotlines present with Story DNA, without span
+        assert len(prior["plotlines"]) == 1
+        assert prior["plotlines"][0]["id"] == "empire"
+        assert "span" not in prior["plotlines"][0]
+        assert "confidence" not in prior["plotlines"][0]
+        assert "nature" not in prior["plotlines"][0]
+        assert "devices" not in prior["plotlines"][0]
+
+    def test_empty_prior_lists_no_injection(self):
+        """Empty prior cast/plotlines should not inject prior_season block."""
+        msg = _build_user_message(
+            "Breaking Bad", 2, _make_context(), ["ep1"],
+            prior_cast=[], prior_plotlines=[],
+        )
+        data = json.loads(msg)
+        assert "prior_season" not in data
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `cd /Users/nvashko/Projects/1-projects/plotter && python -m pytest tests/test_pass1_prior.py -v`
+Expected: FAIL — `_build_user_message` doesn't exist yet.
+
+- [ ] **Step 3: Extract _build_user_message and add prior injection**
+
+In `src/tvplotlines/pass1.py`, extract the user message construction into a helper and add prior support:
+
+```python
+def _build_user_message(
+    show: str,
+    season: int,
+    context: SeriesContext,
+    episodes: list[str],
+    *,
+    prior_cast: list[CastMember] | None = None,
+    prior_plotlines: list[Plotline] | None = None,
+) -> str:
+    """Build the JSON user message for Pass 1."""
+    data = {
+        "show": show,
+        "season": season,
+        "franchise_type": context.franchise_type,
+        "story_engine": context.story_engine,
+        "synopses": [
+            {"episode": f"S{season:02d}E{i+1:02d}", "text": s}
+            for i, s in enumerate(episodes)
+        ],
+    }
+    if prior_cast and prior_plotlines:
+        data["prior_season"] = {
+            "cast": [
+                {"id": c.id, "name": c.name, "aliases": c.aliases}
+                for c in prior_cast
+            ],
+            "plotlines": [
+                {
+                    "id": p.id, "name": p.name, "driver": p.driver,
+                    "goal": p.goal, "obstacle": p.obstacle, "stakes": p.stakes,
+                    "type": p.type, "rank": p.rank,
+                }
+                for p in prior_plotlines
+            ],
+        }
+    return json.dumps(data, ensure_ascii=False)
+```
+
+Update `extract_plotlines()` signature to accept and forward prior params:
+
+```python
+def extract_plotlines(
+    show: str,
+    season: int,
+    context: SeriesContext,
+    episodes: list[str],
+    *,
+    prior_cast: list[CastMember] | None = None,
+    prior_plotlines: list[Plotline] | None = None,
+    config: LLMConfig | None = None,
+) -> tuple[list[CastMember], list[Plotline]]:
+```
+
+Replace inline message construction with `_build_user_message()` call:
+
+```python
+    user_message = _build_user_message(
+        show, season, context, episodes,
+        prior_cast=prior_cast, prior_plotlines=prior_plotlines,
+    )
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `cd /Users/nvashko/Projects/1-projects/plotter && python -m pytest tests/test_pass1_prior.py -v`
+Expected: PASS
+
+- [ ] **Step 5: Run existing tests to check no regressions**
+
+Run: `cd /Users/nvashko/Projects/1-projects/plotter && python -m pytest tests/ -v`
+Expected: all existing tests PASS
+
+- [ ] **Step 6: Commit**
+
+```bash
+cd /Users/nvashko/Projects/1-projects/plotter
+git add src/tvplotlines/pass1.py tests/test_pass1_prior.py
+git commit -m "Inject prior season cast and plotlines into Pass 1 user message"
+```
+
+---
+
+### Task 3: Add overlap warning after voting
+
+**Files:**
+- Modify: `src/tvplotlines/pass1.py` (after voting selection, ~line 86)
+- Test: `tests/test_pass1_prior.py` (add test)
+
+- [ ] **Step 1: Write failing test — overlap warning logged**
+
+Add to `tests/test_pass1_prior.py`:
+
+```python
+import logging
+
+from tvplotlines.pass1 import _check_prior_overlap
+
+
+class TestPriorOverlapWarning:
+    def test_warns_on_same_driver_not_continued(self, caplog):
+        prior_plotlines = _make_prior_plotlines()  # empire, driver=walt
+        new_plotlines = [
+            Plotline(
+                id="drug_business", name="Walt: Drug Business", driver="walt",
+                goal="expand meth operation", obstacle="rivals", stakes="death",
+                type="serialized", rank="A", nature="plot-led", confidence="solid",
+            ),
+        ]
+        with caplog.at_level(logging.WARNING):
+            _check_prior_overlap(new_plotlines, prior_plotlines)
+        assert "empire" in caplog.text
+        assert "drug_business" in caplog.text
+
+    def test_no_warning_when_id_reused(self, caplog):
+        prior_plotlines = _make_prior_plotlines()  # empire, driver=walt
+        new_plotlines = [
+            Plotline(
+                id="empire", name="Walt: Empire", driver="walt",
+                goal="expand empire", obstacle="DEA", stakes="prison",
+                type="serialized", rank="A", nature="plot-led", confidence="solid",
+            ),
+        ]
+        with caplog.at_level(logging.WARNING):
+            _check_prior_overlap(new_plotlines, prior_plotlines)
+        warning_records = [r for r in caplog.records if r.levelno >= logging.WARNING]
+        assert warning_records == []
+```
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run: `cd /Users/nvashko/Projects/1-projects/plotter && python -m pytest tests/test_pass1_prior.py::TestPriorOverlapWarning -v`
+Expected: FAIL — `_check_prior_overlap` doesn't exist.
+
+- [ ] **Step 3: Implement _check_prior_overlap**
+
+Add to `src/tvplotlines/pass1.py`:
+
+```python
+def _check_prior_overlap(
+    new_plotlines: list[Plotline],
+    prior_plotlines: list[Plotline],
+) -> None:
+    """Warn if a new plotline shares a driver with a prior plotline that wasn't continued."""
+    prior_by_driver: dict[str, list[Plotline]] = {}
+    for p in prior_plotlines:
+        prior_by_driver.setdefault(p.driver, []).append(p)
+
+    new_ids = {p.id for p in new_plotlines}
+
+    for driver, priors in prior_by_driver.items():
+        for prior in priors:
+            if prior.id in new_ids:
+                continue  # Prior plotline was continued — no issue
+            # Check if any new plotline has the same driver
+            new_with_same_driver = [p for p in new_plotlines if p.driver == driver]
+            for new_p in new_with_same_driver:
+                logger.warning(
+                    "Prior plotline %r (driver=%s) was not continued, "
+                    "but new plotline %r has the same driver. "
+                    "Possible duplicate?",
+                    prior.id, driver, new_p.id,
+                )
+```
+
+Call it in `extract_plotlines()` after voting selection, before return:
+
+```python
+    if prior_plotlines:
+        _check_prior_overlap(plotlines, prior_plotlines)
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run: `cd /Users/nvashko/Projects/1-projects/plotter && python -m pytest tests/test_pass1_prior.py -v`
+Expected: all PASS
+
+- [ ] **Step 5: Commit**
+
+```bash
+cd /Users/nvashko/Projects/1-projects/plotter
+git add src/tvplotlines/pass1.py tests/test_pass1_prior.py
+git commit -m "Add overlap warning when prior plotline driver reappears under new id"
+```
+
+---
+
+## Chunk 2: Prompt changes + docs
+
+### Task 4: Update English Pass 1 prompt
+
+**Files:**
+- Modify: `src/tvplotlines/prompts_en/pass1.md`
+
+- [ ] **Step 1: Add "Prior season" section after "## Input"**
+
+Insert after the `- **synopses**: all season synopses (text)` line (line 17):
+
+```markdown
+
+## Prior season (if provided)
+
+If `prior_season` is present in the input, it contains cast and plotlines from the previous season.
+
+**Process prior data BEFORE analyzing new synopses:**
+
+For each plotline in `prior_season.plotlines`, decide based on the NEW season's synopses:
+- **CONTINUES** — the plotline is present this season. Keep the same `id`, update goal/obstacle/stakes to reflect the new season's material.
+- **TRANSFORMED** — same driver, but goal fundamentally changed. Keep the `id`, rewrite Story DNA.
+- **ENDED** — the plotline resolved or disappeared. Don't include it.
+
+For each character in `prior_season.cast`:
+- If the character appears in this season's synopses — reuse the same `id` and `name`.
+- If the character does not appear — don't include them.
+
+Only after processing all prior plotlines, identify NEW plotlines not present before.
+```
+
+- [ ] **Step 2: Update "## Task" section to reference prior workflow**
+
+Change line 20 from:
+
+```
+Read ALL season synopses. Extract the list of plotlines and the main cast.
+```
+
+to:
+
+```
+Read ALL season synopses. If `prior_season` data is provided, first process prior plotlines (see Prior season section), then identify new plotlines. Extract the list of plotlines and the main cast.
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+cd /Users/nvashko/Projects/1-projects/plotter
+git add src/tvplotlines/prompts_en/pass1.md
+git commit -m "Add prior season instructions to English Pass 1 prompt"
+```
+
+---
+
+### Task 5: Update Russian Pass 1 prompt
+
+**Files:**
+- Modify: `src/tvplotlines/prompts/pass1.md`
+
+- [ ] **Step 1: Add "Предыдущий сезон" section after "## Вход"**
+
+Insert after line 17 (`- **synopses**: все синопсисы сезона (текст)`):
+
+```markdown
+
+## Предыдущий сезон (если предоставлен)
+
+Если во входных данных есть `prior_season`, он содержит каст и сюжетные линии предыдущего сезона.
+
+**Обработай данные предыдущего сезона ДО анализа новых синопсисов:**
+
+Для каждой линии в `prior_season.plotlines` реши на основе синопсисов НОВОГО сезона:
+- **CONTINUES** — линия присутствует в этом сезоне. Сохрани тот же `id`, обнови goal/obstacle/stakes по материалу нового сезона.
+- **TRANSFORMED** — тот же driver, но цель кардинально изменилась. Сохрани `id`, перепиши Story DNA.
+- **ENDED** — линия завершилась или исчезла. Не включай её.
+
+Для каждого персонажа в `prior_season.cast`:
+- Если персонаж появляется в синопсисах этого сезона — используй тот же `id` и `name`.
+- Если персонаж не появляется — не включай его.
+
+Только после обработки всех prior-линий ищи НОВЫЕ линии, которых не было раньше.
+```
+
+- [ ] **Step 2: Update "## Задача" section**
+
+Change line 21 from:
+
+```
+Прочитай ВСЕ синопсисы сезона. Извлеки список сюжетных линий и основной каст.
+```
+
+to:
+
+```
+Прочитай ВСЕ синопсисы сезона. Если предоставлены данные `prior_season`, сначала обработай линии предыдущего сезона (см. секцию «Предыдущий сезон»), затем ищи новые линии. Извлеки список сюжетных линий и основной каст.
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+cd /Users/nvashko/Projects/1-projects/plotter
+git add src/tvplotlines/prompts/pass1.md
+git commit -m "Add prior season instructions to Russian Pass 1 prompt"
+```
+
+---
+
+### Task 6: Update API docs
+
+**Files:**
+- Modify: `docs/api.md`
+
+- [ ] **Step 1: Add `prior` to get_plotlines() signature in docs**
+
+In the code block at line 10, add `prior=None` after `episodes=synopses,`:
+
+```python
+result = get_plotlines(
+    show="House",
+    season=1,
+    episodes=synopses,
+    prior=None,                  # TVPlotlinesResult from previous season
+    llm_provider="anthropic",
+    ...
+)
+```
+
+- [ ] **Step 2: Add multi-season usage section after the signature block**
+
+Insert after line 24:
+
+```markdown
+
+### Multi-season processing
+
+Pass the result of the previous season to maintain character and plotline ID continuity:
+
+\```python
+r1 = get_plotlines("Breaking Bad", 1, episodes_s01)
+r2 = get_plotlines("Breaking Bad", 2, episodes_s02, prior=r1)
+r3 = get_plotlines("Breaking Bad", 3, episodes_s03, prior=r2)
+\```
+
+When `prior` is provided:
+- Pass 0 is skipped (reuses `prior.context`)
+- Pass 1 receives prior cast and plotlines, reusing IDs for continuing characters and plotlines
+- Not supported for anthology format (raises `ValueError`)
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+cd /Users/nvashko/Projects/1-projects/plotter
+git add docs/api.md
+git commit -m "Document prior parameter in API reference"
+```
+
+---
+
+### Task 7: Final verification
+
+- [ ] **Step 1: Run full test suite**
+
+Run: `cd /Users/nvashko/Projects/1-projects/plotter && python -m pytest tests/ -v`
+Expected: all PASS
+
+- [ ] **Step 2: Verify git log on feature branch**
+
+Run: `cd /Users/nvashko/Projects/1-projects/plotter && git log --oneline feature/prior-season-continuity`
+Expected: 6 commits (spec + 5 implementation commits)
diff --git a/docs/knowledge/archive/plans/autoresearcher-competence-idea.md b/docs/knowledge/archive/plans/autoresearcher-competence-idea.md
new file mode 100644
index 0000000..21e2360
--- /dev/null
+++ b/docs/knowledge/archive/plans/autoresearcher-competence-idea.md
@@ -0,0 +1,44 @@
+---
+type: concept
+project: tvplotlines
+status: active
+---
+
+# Идея: автоисследователь с пулами компетенций
+
+## Дата: 2026-03-18 (ночная дискуссия)
+
+## Суть
+
+Автоисследователь который оптимизирует не просто формулировки промптов, а то, **какие компетенции** давать LLM-у и **в какой форме** (промпт vs код vs гибрид). Параметр цена/качество: дешёвая модель + валидатор может быть лучше дорогой модели без валидатора.
+
+## Пулы (что подключать)
+
+- **Теория домена** — нарратологические концепты (Propp, Freytag, Campbell, Genette, jo-ha-kyū...)
+- **Метрики** — как измерить "стало лучше"
+- **Логики/компетенции** — формальные условия (эпистемика, каузальность, темпоральность...)
+- **Код vs промпт** — одно и то же условие можно дать в промпте (дёшево, хрупко) или в коде-валидаторе (надёжно, дороже)
+
+## Открытые вопросы (важные, не решённые)
+
+1. **Откуда брать компетенции?** Нельзя просто "собрать все логики" — это бесконечная задача. Нужно идти от практики: что реально делает сценарист когда пишет? Из каких элементов состоит создание сценария? На какие уровни компетенции это разваливается?
+
+2. **Источники:** Не нарратология, а учебники по сценарному мастерству. Мы делаем практический инструмент. Начинать с того, как устроены учебники — McKee, Snyder, наши восточные (Arai, Tan Peisheng, Sim San). Какие элементы они все описывают? Что общего?
+
+3. **Компетенции шире чем "про истории":** Сценарист использует знания из биологии (поведение), психологии (мотивация), истории, искусства. Пулы компетенций могут включать источники из совершенно разных областей. Как это организовать?
+
+4. **Как представить компетенцию в виде, пригодном для автоисследователя?** "Добавь эпистемическую логику" — красиво звучит, но что конкретно подаёшь на вход? Формулу? Описание на естественном языке? Набор правил валидации? Пример?
+
+5. **Масштаб:** Сколько компетенций реалистично описать? 5? 10? 50? На каждую — по 5 ключевых источников? Это уже исследовательский проект сам по себе.
+
+## Связь с препринтом
+
+Если препринт — это "логика как competence для нарративного интеллекта", то автоисследователь — это инструмент который это демонстрирует. Наивный промпт → добавляем компетенции одну за другой → результат улучшается → competence работает.
+
+## Что делать дальше
+
+- [ ] Взять 3-5 учебников по сценарному мастерству (разных традиций)
+- [ ] Выписать из них: из каких элементов/этапов состоит работа сценариста
+- [ ] Найти пересечения — что все описывают одинаково
+- [ ] Понять какие из этих элементов = какие компетенции
+- [ ] Для каждой компетенции: можно ли это формализовать? как? в промпте или в коде?
diff --git a/docs/knowledge/archive/plans/awesome-shortlist.bib b/docs/knowledge/archive/plans/awesome-shortlist.bib
new file mode 100644
index 0000000..81c04f4
--- /dev/null
+++ b/docs/knowledge/archive/plans/awesome-shortlist.bib
@@ -0,0 +1,152 @@
+@article{rivera2024,
+  author = {Rivera, Camille and Ware, Stephen G. and Fisher, Brad},
+  title = {The Story So Far on Narrative Planning},
+  year = {2024},
+  journal = {Journal of Artificial Intelligence Research}
+}
+
+@article{trabasso1989,
+  author = {Trabasso, Tom and van den Broek, Paul and Suh, Soyoung},
+  title = {Logical Necessity and Transitivity of Causal Relations in Stories},
+  year = {1989},
+  journal = {Discourse Processes},
+  volume = {12},
+  number = {1},
+  pages = {1--25}
+}
+
+@inproceedings{christensen2020,
+  author = {Christensen, Rachelyn and Cardona-Rivera, Rogelio E. and Young, R. Michael},
+  title = {Using Domain Compilation to Add Belief to Narrative Planners},
+  year = {2020},
+  booktitle = {Proceedings of the AAAI Conference on Artificial Intelligence and Interactive Digital Entertainment (AIIDE)}
+}
+
+@article{riedl2010,
+  author = {Riedl, Mark O. and Young, R. Michael},
+  title = {Narrative Planning: Balancing Plot and Character},
+  year = {2010},
+  journal = {Journal of Artificial Intelligence Research},
+  volume = {39},
+  pages = {217--268}
+}
+
+@inproceedings{dang2011,
+  author = {Dang, Khai N. and Champagnat, Ronan and Augeraud, Michel},
+  title = {How authors benefit from linear logic in the authoring process of interactive storyworlds},
+  year = {2011},
+  booktitle = {Proceedings of the International Conference on Interactive Digital Storytelling (ICIDS)}
+}
+
+@inproceedings{ciarlini2010,
+  author = {Ciarlini, Angelo E. M. and Pozzer, Cesar T. and Furtado, Antonio L. and Feijó, Bruno},
+  title = {Modeling Interactive Storytelling Genres as Application Domains},
+  year = {2010},
+  booktitle = {Proceedings of the International Conference on Interactive Digital Storytelling (ICIDS)}
+}
+
+@inproceedings{szilas2018,
+  author = {Szilas, Nicolas and Estupiñán, Sandra and Richle, Urs},
+  title = {Automatic Detection of Conflicts in Complex Narrative Structures},
+  year = {2018},
+  booktitle = {Proceedings of the International Conference on Interactive Digital Storytelling (ICIDS)}
+}
+
+@inproceedings{farrell2022salience,
+  author = {Farrell, Rachel and Fisher, Brad and Ware, Stephen G.},
+  title = {Salience Vectors for Measuring Distance between Stories},
+  year = {2022},
+  booktitle = {Proceedings of the AAAI Conference on Artificial Intelligence and Interactive Digital Entertainment (AIIDE)}
+}
+
+@incollection{bolander2017,
+  author = {Bolander, Thomas},
+  title = {A Gentle Introduction to Epistemic Planning: The DEL Approach},
+  year = {2017},
+  booktitle = {Proceedings of the 27th Workshop on Logic, Language, Information and Computation (WoLLIC)},
+  publisher = {Springer}
+}
+
+@inproceedings{castricato2021,
+  author = {Castricato, Louis and Harsh, Tanmay and Diddee, Harshit and Prabhumoye, Shrimai},
+  title = {Towards a Model-Theoretic View of Narratives},
+  year = {2021},
+  booktitle = {Proceedings of the Workshop on Narrative Understanding}
+}
+
+@phdthesis{farrell2022,
+  author = {Farrell, Rachel},
+  title = {Don't Give Me That Story! A Human-Centered Framework for Usable Narrative Planning},
+  year = {2022},
+  school = {University of Kentucky}
+}
+
+@inproceedings{kelly2023,
+  author = {Kelly, Nathaniel and Singh, Jigyasa and Li, Jiaxuan and Grzes, Marek and Pearlmutter, Barak and Riedl, Mark O.},
+  title = {There and Back Again: Extracting Formal Domains for Controllable Neurosymbolic Story Authoring},
+  year = {2023},
+  booktitle = {Proceedings of the AAAI Conference on Artificial Intelligence and Interactive Digital Entertainment (AIIDE)}
+}
+
+@inproceedings{clerc2025,
+  author = {Clerc, Julien and Réty, Jean-Hugues and Maragheh, Saman Hooshmand},
+  title = {Modeling Interactive Narrative Systems: A Formal Approach},
+  year = {2025},
+  booktitle = {Proceedings of the International Conference on Interactive Digital Storytelling (ICIDS)}
+}
+
+@article{diakidoy2014,
+  author = {Diakidoy, Irene-Anna and Kakas, Antonis and Michael, Loizos and Miller, Rob},
+  title = {Non-Monotonic Reasoning and Story Comprehension},
+  year = {2014},
+  journal = {Computational Intelligence}
+}
+
+@inproceedings{dupindesaintcyr2024,
+  author = {Dupin de Saint-Cyr, Florence and Lagasquie-Schiex, Marie-Christine and Morgenstern, Leora},
+  title = {What Killed the Cat? Towards a Logical Formalization of Curiosity (And Suspense, and Surprise) in Narratives},
+  year = {2024},
+  booktitle = {Proceedings of the International Conference on Principles of Knowledge Representation and Reasoning (KR)}
+}
+
+@inproceedings{pianzola2025,
+  author = {Pianzola, Federico and Acerbi, Alberto and Rebora, Simone},
+  title = {The GOLEM Ontology for Narrative and Fiction},
+  year = {2025},
+  booktitle = {Proceedings of the International Conference on Interactive Digital Storytelling (ICIDS)}
+}
+
+@inproceedings{siler2020,
+  author = {Siler, Cory and Ware, Stephen G.},
+  title = {A Good Story Is One in a Million: Solution Density in Narrative Generation Problems},
+  year = {2020},
+  booktitle = {Proceedings of the AAAI Conference on Artificial Intelligence and Interactive Digital Entertainment (AIIDE)}
+}
+
+@inproceedings{shirvani2020,
+  author = {Shirvani, Alireza and Ware, Stephen G.},
+  title = {A Formalization of Emotional Planning for Strong-Story Systems},
+  year = {2020},
+  booktitle = {Proceedings of the AAAI Conference on Artificial Intelligence and Interactive Digital Entertainment (AIIDE)}
+}
+
+@inproceedings{gervas2013,
+  author = {Gervás, Pablo},
+  title = {Propp's Morphology of the Folk Tale as a Grammar for Generation},
+  year = {2013},
+  booktitle = {Proceedings of the Workshop on Computational Models of Narrative (CMN)}
+}
+
+@inproceedings{chandra2024,
+  author = {Chandra, Kartik and Tenenbaum, Joshua B. and Goodman, Noah D.},
+  title = {Storytelling as Inverse Inverse Planning},
+  year = {2024},
+  booktitle = {Proceedings of the Annual Meeting of the Cognitive Science Society (CogSci)}
+}
+
+@inproceedings{nelson2025,
+  author = {Nelson, Mark J. and Mateas, Michael},
+  title = {Accounting for Incomplete and Partially-Ordered Observations Within Classical Model-Based Plan Recognition for Sensemaking of Information Storygames},
+  year = {2025},
+  booktitle = {Proceedings of the AAAI Conference on Artificial Intelligence and Interactive Digital Entertainment (AIIDE)}
+}
diff --git a/docs/knowledge/archive/plans/bibliography-cleanup.md b/docs/knowledge/archive/plans/bibliography-cleanup.md
new file mode 100644
index 0000000..d87ff29
--- /dev/null
+++ b/docs/knowledge/archive/plans/bibliography-cleanup.md
@@ -0,0 +1,72 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# Bibliography Cleanup — Completed 2026-03-18
+
+## Structure Created in Zotero
+
+```
+PlotterBibliography (JCAVFXHB) — ~535 items (all candidates)
+├── PlotterPreprint (6R49JN4W) — 23 items (confirmed for paper)
+└── AwesomeNarrativeAI (ECEMJHZR) — 25 items (confirmed for awesome list)
+```
+
+## Phase 2: Migrated from Existing Collections
+
+| Collection | Items | Tags |
+|-----------|-------|------|
+| 4preprint | 23 | `confirmed` |
+| awesome-shortlist | 26 | `confirmed` |
+| logic_narrative_articles | 68 | — |
+| AwesomeLogic-Targeted | 32 | `awesome-candidate` |
+| eastern-narratives | 27 | `eastern-tradition`, `preprint-candidate` |
+| 4benchmrk | 82 | `evaluation` |
+| 00 RelevanceLogic | 35 | `formal-methods` |
+| **Total** | **293** | |
+
+## Phase 3: Imported from .bib Files
+
+| File | Created | Tags |
+|------|---------|------|
+| predicate-discovery.bib | 11 | `predicate-discovery`, `formal-methods` |
+| predicate-discovery-isomorphic.bib | 17 | `predicate-discovery`, `formal-methods` |
+| priority-reading-list.bib | 20 | `preprint-candidate` |
+| eastern-narratives.bib | 27 | `eastern-tradition`, `preprint-candidate` |
+| books2series_references.bib | 164 | `preprint-candidate` |
+| **Total** | **239** | |
+
+## Phase 4: Manual Additions from .md Files
+
+Added from reference-list.md (not in any .bib):
+- Genette 1980 — Narrative Discourse (from AwesomeLogic2Read)
+- Campbell — Hero with a Thousand Faces (from AwesomeLogic2Read)
+- Zhang 2025 — SeriesBench (from AwesomeLogic2Read)
+- Karpathy 2023 — Software 3.0 (created new)
+- Gius & Vauth 2022 — Event-Based Plot Model (created new)
+- Freytag 1863 — Technique of the Drama (created new)
+- Hull 2025 — Narrative Context Protocol (created new)
+- Ruchansky 2025 — Netflix Knowledge Graphs (created new)
+
+## Duplicates Merged: 3
+
+- Castricato 2021 — Towards a Model-Theoretic View of Narratives
+- Riedl & Young 2010 — Narrative Planning: Balancing Plot and Character
+- Diakidoy 2014 — Non-Monotonic Reasoning and Story Comprehension
+
+## Tags in Use
+
+**By purpose:** `preprint-candidate`, `awesome-candidate`, `confirmed`
+**By theme:** `narrative-theory`, `formal-methods`, `story-generation`, `evaluation`, `eastern-tradition`, `prompting`, `planning`, `predicate-discovery`
+
+## NOT Touched
+
+- notGoof (rejected papers)
+- AwesomeLogic2Read (3531 — unprocessed reservoir)
+- AwesomeEvaluation (752 — unprocessed reservoir)
+
+## Old Collections
+
+Kept as-is (items belong to multiple collections, no data loss).
diff --git a/docs/knowledge/archive/plans/bibliography-narrative-and-autoresearch.md b/docs/knowledge/archive/plans/bibliography-narrative-and-autoresearch.md
new file mode 100644
index 0000000..cf1d8aa
--- /dev/null
+++ b/docs/knowledge/archive/plans/bibliography-narrative-and-autoresearch.md
@@ -0,0 +1,136 @@
+---
+type: note
+project: tvplotlines
+status: active
+---
+
+# Bibliography: Narrative Analysis + Autoresearch
+
+Собрано 2026-03-16. Две темы: (1) computational narratology и метрики для event functions, (2) автоматическая оптимизация промптов (autoresearch подходы).
+
+---
+
+## Computational Narratology & Narrative Arc Detection
+
+### Turning Point Identification
+
+**Papalampidi et al. (2019)** — Movie Plot Analysis via Turning Point Identification.
+5 turning points в синопсисах фильмов (opportunity, change of plans, point of no return, major setback, climax). Аннотированный датасет, нейросетевая модель, метрика — accuracy + distance от правильной позиции. **Прямо наша задача — но для фильмов, не сериалов.**
+- https://arxiv.org/abs/1908.10328
+
+### Narrative Theory + NLP
+
+**Piper, So, Bamman (2021)** — Narrative Theory for Computational Narrative Understanding. EMNLP.
+Связывает теорию нарратива из гуманитарных наук с NLP методами. Открывает новые эмпирические вопросы.
+- https://aclanthology.org/2021.emnlp-main.26/
+
+### Story Arc Structure
+
+**Reagan et al. (2020)** — The Narrative Arc: Revealing Core Narrative Structures through Text Analysis. Science Advances.
+Три нарративных процесса: staging, plot progression, cognitive tension. Анализ ~40,000 текстов.
+- https://www.science.org/doi/10.1126/sciadv.aba2196
+
+### Narrative Analysis via ML
+
+**Jhala (2020)** — Three Stage Narrative Analysis: Plot-Sentiment Breakdown, Structure Learning and Concept Detection.
+Трёхэтапный анализ: разбивка по сентименту, обучение структуре, детекция концептов.
+- https://arxiv.org/html/2511.11857
+
+### LLM for Story Analysis (2026)
+
+**Narrative Theory-Driven LLM Methods for Automatic Story Analysis (2026).**
+Свежая работа — LLM для автоматического анализа нарративной структуры. **Прямой конкурент/родственник tvplotlines.**
+- https://arxiv.org/pdf/2602.15851
+
+### Benchmarks
+
+**NarraBench (2025)** — A Comprehensive Framework for Narrative Benchmarking.
+Бенчмарк для narrative understanding: dialogue, plot arcs, genre classification.
+- https://arxiv.org/html/2510.09869
+
+**SeriesBench (2025)** — A Benchmark for Narrative-Driven Drama Series Understanding.
+1,072 видео, задачи на понимание нарратива в сериалах. MLLMs описывают действия но плохо понимают inter-character relationships.
+- https://arxiv.org/html/2504.21435v1
+
+### TV Series Narrative Extraction
+
+**Balestri & Pescatore (2025)** — Multi-Agent System for AI-Assisted Extraction of Narrative Arcs in TV Series.
+Наша reference-статья. Grey's Anatomy, три типа арок (Anthology, Soap, Genre-Specific). ICAART 2025.
+- https://arxiv.org/abs/2503.04817
+
+**Balestri & Pescatore (2025)** — Narrative Memory in Machines: Multi-Agent Arc Extraction in Serialized TV.
+Расширение предыдущей. LLM как semantic memory + vector DB как episodic memory.
+- https://arxiv.org/html/2508.07010v1
+
+---
+
+## Autoresearch & Automated Prompt Optimization
+
+### Karpathy Autoresearch (2026)
+
+**Karpathy (2026)** — autoresearch: Autonomous LLM Experimentation.
+630 строк кода. Агент модифицирует training code, запускает 5-мин эксперимент, проверяет метрику, keep/discard. 126 экспериментов за ночь, 700 за 2 дня. Loss: 0.9979 → 0.9697. "Time to GPT-2": 2.02h → 1.80h (11%).
+- https://github.com/karpathy/autoresearch
+
+### OPRO (Google DeepMind)
+
+**Yang et al. (2023)** — Large Language Models as Optimizers (OPRO).
+LLM оптимизирует промпты для другого LLM в feedback loop. 47% лучше человеческих экспертов на MATH.
+- Meta-optimization: LLM генерирует и улучшает промпты итеративно.
+
+### DSPy (Stanford NLP)
+
+**Khattab et al.** — DSPy: Programming—not Prompting—Language Models.
+Фреймворк для автоматической оптимизации промптов. С хорошей метрикой и данными можно автоматически оптимизировать промпт без ручного редактирования.
+- https://github.com/stanfordnlp/dspy
+- MIPRO optimizer — SOTA для discrete prompt optimization.
+
+### GAAPO (2026)
+
+**GAAPO** — Genetic Algorithm Applied to Prompt Optimization.
+Гибридный фреймворк: генетический алгоритм эволюционирует промпты через поколения.
+- https://www.frontiersin.org/journals/artificial-intelligence/articles/10.3389/frai.2025.1613007/full
+
+### promptolution (2025)
+
+**promptolution** — A Unified, Modular Framework for Prompt Optimization.
+Реализует OPRO, EvoPromptDE, EvoPromptGA, и CAPO (SOTA discrete prompt optimizer).
+- https://arxiv.org/html/2512.02840v1
+
+### Self-Refine
+
+**Madaan et al. (2023)** — Self-Refine: Iterative Refinement with Self-Feedback.
+LLM генерирует → оценивает → улучшает в цикле без внешнего supervision.
+- https://arxiv.org/abs/2303.17651
+
+### IMPROVE (2025)
+
+**IMPROVE** — Iterative Model Pipeline Refinement and Optimization Leveraging LLM Agents.
+Полностью автономный фреймворк: LLM-агенты конструируют, тренируют и итеративно улучшают пайплайн.
+- https://arxiv.org/html/2502.18530v1
+
+### LLMs in Scientific Discovery (2025)
+
+**From Automation to Autonomy: A Survey on Large Language Models in Scientific Discovery.**
+Обзор: LLM переходят от автоматизации к автономии в научных исследованиях.
+- https://arxiv.org/html/2505.13259v1
+
+---
+
+## Relevance to tvplotlines
+
+**Для метрики event functions:**
+- Papalampidi (turning points) — closest work, но для фильмов. Их 5 turning points ≈ наши 7 functions. Метрика: accuracy + distance.
+- NarraBench / SeriesBench — бенчмарки для валидации.
+
+**Для autoresearch v3:**
+- Наш autoresearch ≈ Karpathy's autoresearch (тот же loop: change → test → keep/revert).
+- DSPy/OPRO — более формальные подходы к prompt optimization, можно изучить для идей.
+- Self-Refine — LLM оценивает свой output и улучшает (похоже на наш Pass 3).
+
+**Для awesome list / preprint:**
+- Все статьи по computational narratology — related work.
+- Balestri & Pescatore — direct predecessor.
+
+**Limitation of DSPy/OPRO/promptolution for our use case:**
+These frameworks optimize short prompts ("classify this as..."). Our prompts are 200+ line specifications with tables, examples, and rules. Automated generation from scratch is not feasible. Our autoresearch is closer to Karpathy's approach: modify one element in a large, tested prompt → test → keep/revert. This is a meaningful difference worth noting in the preprint.
diff --git a/docs/knowledge/archive/plans/blog-post-guide.md b/docs/knowledge/archive/plans/blog-post-guide.md
new file mode 100644
index 0000000..e66117b
--- /dev/null
+++ b/docs/knowledge/archive/plans/blog-post-guide.md
@@ -0,0 +1,79 @@
+---
+type: ref
+tags: [methodology, blog, writing]
+project: preprint
+status: active
+---
+
+# Blog Post Guide
+
+How to write posts for birdinthetree.github.io/blog from existing reading
+notes in `books2series/research/vault/readings/`.
+
+## Relationship to other formats
+
+| Format | Purpose | Location |
+|--------|---------|----------|
+| **Reading note** (9 sections) | Deep analysis for the project | `books2series/.../readings/` |
+| **Paper summary** (4 sections) | Lit review for preprint | `plotter_docs/preprint/sources/` |
+| **Blog post** (this format) | External audience, grouped by task | `birdinthetree.github.io/src/content/blog/` |
+
+Reading notes are the raw material. Blog posts synthesize multiple notes
+around a single engineering task.
+
+## Principles
+
+1. **One task, not one paper.** Each post answers: "I'm building a narrative
+   system and I need to ___." Then shows which formal methods help.
+
+2. **Engineer-first.** The reader builds LLM pipelines. They don't care
+   about modal logic for its own sake — they care that epistemic logic
+   solves their "who knows what" tracking problem.
+
+3. **Your experience is the hook.** The unique value is: you read the paper,
+   you tried to use it, here's what happened. Not a survey — a field report.
+
+4. **No internal references.** Reading notes reference Q3, Q10, Q31 etc.
+   Blog posts must be self-contained. Replace internal refs with the
+   actual problem statement.
+
+5. **Show the bridge.** Every post must connect: formal method → concrete
+   prompt / data model / algorithm → result or insight.
+
+## Template
+
+See [TEMPLATE for blog post.md](TEMPLATE%20for%20blog%20post.md).
+
+## How to write a post from existing reading notes
+
+1. **Pick a task** from the awesome-narrative-ai section list:
+   Story World, Characters & Arcs, Causality, Story Structure,
+   Audience & Author, Consistency & Verification, Genre,
+   Generation & Planning, Evaluation & Metrics.
+
+2. **Pull 2-4 reading notes** that address this task. Use their
+   Section 2 (task + solution) and Section 8 (integration potential)
+   as source material.
+
+3. **Write the Problem section** from Section 2 of the strongest note.
+   Strip project-specific language. Frame as a universal task any
+   narrative engineer faces.
+
+4. **Write the Approaches section** by comparing the 2-4 papers.
+   Use Section 4 (where it works / doesn't) to show tradeoffs.
+   One paragraph per paper, not one section.
+
+5. **Write the Bridge section** from Section 8 of the notes —
+   this is where your unique expertise shows. What did you actually
+   try? What worked? What broke?
+
+6. **Write the Takeaway** — the one thing the reader should remember.
+   Concrete: a prompt pattern, a data structure, a design principle.
+
+## Series structure
+
+Posts form a series "What Logic Can Do for Stories" (working title).
+Each post is standalone but they share:
+- Same audience (narrative AI engineers)
+- Same structure (problem → approaches → bridge → takeaway)
+- Cross-links to related posts and to awesome-narrative-ai entries
diff --git a/docs/knowledge/archive/plans/career-plan.md b/docs/knowledge/archive/plans/career-plan.md
new file mode 100644
index 0000000..b923c1d
--- /dev/null
+++ b/docs/knowledge/archive/plans/career-plan.md
@@ -0,0 +1,36 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# Career Plan
+
+Цель: академическая и профессиональная видимость вокруг tvplotlines.
+
+## Фаза 1 — Фундамент
+- [ ] Открытый tvplotlines repo на GitHub (библиотека)
+- [ ] Preprint на arXiv (описание метода)
+  - [ ] После публикации: обновить Citation в README (добавить arXiv DOI)
+
+## Фаза 2 — GitHub Pages сайт
+Один сайт, всё вместе:
+- [ ] Резюме / CV
+- [ ] Блог с summaries статей (прочитанных во время работы над tvplotlines)
+- [ ] tvplotlines demo viewer (статический JS, ~20 готовых результатов)
+  - Переписать viewer с FastAPI+Jinja2 на статический JS
+  - Заодно улучшить UI
+  - Analytics: каждый график на полную ширину, не по 2 в ряд
+  - Analytics: добавить описание/интерпретацию к каждому графику
+  - Analytics: tension curves — переосмыслить или убрать (сейчас бесполезны)
+  - Терминология в viewer: storyline → plotline везде в UI
+  - Series selector: показывать полное название шоу из JSON, не slug
+
+## Фаза 3 — Расширение
+- [ ] Awesome list — неформальные логики применительно к нарративу
+
+## Терминология
+- [ ] Переименовать `Event.storyline` → `Event.plotline` в коде, промптах, тестах и результатах (breaking change)
+
+## Фаза 4 — Монетизация (когда будет спрос)
+- [ ] Lemon Squeezy лицензия для полного tvplotlines-app
diff --git a/docs/knowledge/archive/plans/design-decisions.md b/docs/knowledge/archive/plans/design-decisions.md
new file mode 100644
index 0000000..8579463
--- /dev/null
+++ b/docs/knowledge/archive/plans/design-decisions.md
@@ -0,0 +1,467 @@
+---
+type: ref
+project: preprint
+status: active
+created: 2026-03-21
+---
+
+# tvplotlines: Design Decision Registry
+
+
+An exhaustive list of design decisions, assumptions, and architectural choices that tvplotlines is built upon. For each decision: what exactly it is, where it lives, and what assumption stands behind it.
+
+---
+## 1. Pipeline Architecture
+### 1.1.  LLM prompts with deterministic scaffolding and domain knowledge 
+
+- **Decision:** The pipeline is built around 4 prompts — context detection, plotline extraction, event assignment, structural review (the *what*)— connected by code that handles everything the LLM does not do well consitently (the *how*): validation, aggregation, orchestration, and correction. 
+- The number of actual LLM calls is more than 4 as pass 1 has 3 voting rounds and pass 2 works over N episodes, and any call may be retried up to 2 times on validation errors.
+- **Where:** `pipeline.py:1`, `prompts/pass{0,1,2,3}.md`, table in `README.md:119-124`
+- **Assumption:** A single LLM task "extract everything at once" yields worse results than a flow of specialized prompts with code between them [^1]. `pass1_merged.py` and `ablation_pass0.py` exist as ablation studies investigating how many prompts are actually needed.
+
+### 1.2. Pass order: context first, then plotlines, then events
+- **Decision:** Context (franchise_type, story_engine) is determined first and passed forward as input.
+- **Where:** `pipeline.py:128-130` (Pass 0), `pass0.md:6-8`
+- **Assumption:** Franchise type is a classification of TV series by their narrative structure. Four types: **procedural** (self-contained episode stories, e.g. House — each week a new case), **serial** (season-long arcs, e.g. Breaking Bad), **hybrid** (procedural engine + serialized arcs, e.g. X-Files), **ensemble** (multiple co-equal protagonists, e.g. Game of Thrones). The taxonomy draws on Douglas (*Writing the TV Drama Series*), Nash (*Television Storytelling*), and Mittell (*Complex TV*). Each type sets different expectations for plotline structure: procedural = 1 episodic + 1-2 serialized; serial = 3-8 season-spanning; ensemble = 4-6 parallel.
+
+  This decision parallels Zwaan's (1993) finding that readers activate different **cognitive control systems** depending on discourse type — a news reader and a literary reader process the same text differently because genre signals switch their comprehension strategy. We assume Pass 0 does the same for the LLM: determining franchise type switches the model into a specific "reading mode" that shapes how it granulates plotlines in Pass 1.
+
+  Original hypothesis: context must be a separate LLM call before extraction. The ablation study showed that the task "determine context + extract plotlines" can be combined within a single prompt — separation within the instruction is sufficient, a separate LLM call is not mandatory.
+
+### 1.3. Pass 1 receives ALL synopses, Pass 2 — one at a time
+- **Decision:** Pass 1 sees the entire season to identify season-spanning plotlines. Pass 2 processes one episode at a time.
+- **Where:** `pass1.py:107-173` (all synopses), `pass2.py:33-101` (one synopsis)
+- **Assumption:** Identifying season-spanning plotlines requires an overview of the whole season. Assigning events to those plotlines requires only one episode + the plotline list. This separation enables parallelization of Pass 2 — a decision made for speed and cost efficiency (parallel calls with short context are cheaper than a single long one).
+
+### 1.4. System/user prompt split in Pass 2 — architecture for caching
+- **Decision:** In Pass 2, the instruction + series context + plotline list go into the system prompt (immutable part); the synopsis of a single episode goes into the user prompt (variable part). The immutable portion of the prompt is cached across all episodes.
+- **Where:** `pass2.py:85-101` (system prompt assembly), `pass2.py:98` (`cache_system=True`)
+- **Assumption:** Cost savings via prompt caching — the system prompt contains ~80% of call tokens and is reused for all episodes in a season.
+
+### 1.5. Pass 2 is parallel, Pass 1 is not
+- **Decision:** Pass 2 runs for all episodes simultaneously (async). Pass 1 runs three parallel calls (majority voting, see 1.7).
+- **Where:** `pipeline.py:144-146`, `pass2.py:162-201` (assign_events_parallel), `llm.py:240-284` (acall_llm_parallel)
+- **Assumption:** Episodes in Pass 2 are independent of each other — each has its own synopsis, the same plotline set, the same system prompt. System prompt caching makes parallel calls cheaper.
+
+### 1.6. Pass 3 exists as a separate pass
+- **Decision:** Structural revision after Pass 1+2, rather than "get it right the first time."
+- **Where:** `pass3.md:12-14`, `pipeline.py:176-190`
+- **Assumption:** Pass 1 does not see events. Pass 2 cannot modify the plotline list. Between them lies a gap: Pass 2 discovers problems (via patches) but cannot fix them. Pass 3 is the first to see the full picture (plotlines + all events + span + weight) and can make decisions: MERGE, REASSIGN, PROMOTE, DEMOTE, CREATE, DROP. The alternative — iteratively rerunning Pass 1+2 until stabilization — is more expensive and less predictable.
+
+### 1.7. Majority voting in Pass 1, but not in Pass 2
+- **Decision:** Pass 1 runs 3 times in parallel; the result with the most frequent plotline ID set is selected.
+- **Where:** `pass1.py:19` (`_VOTING_ROUNDS = 3`), `pass1.py:148-165`
+- **Assumption:** Plotline identification is the most subjective part of the pipeline. Different runs may produce different plotline sets. Voting stabilizes the result. Pass 2 binds events to already-fixed plotlines — less variability, voting is unnecessary. The consistency metric (ARI) measures precisely the stability of Pass 1.
+
+### 1.8. Post-processing is code, not LLM
+- **Decision:** span, weight, orphan assignment, rank validation — all computed by code.
+- **Where:** `postprocess.py` (entire file), `pipeline.py:171-173`
+- **Assumption:** These operations are deterministic aggregations. An LLM is not needed to count events or determine which episodes a plotline appears in. Code is faster, cheaper, and deterministic.
+
+### 1.9. Verdicts are code, not LLM
+- **Decision:** Pass 3 outputs JSON with verdicts that are applied by code (`verdicts.py`).
+- **Where:** `verdicts.py` (entire file), `pipeline.py:184-188`
+- **Assumption:** The LLM makes the decision (MERGE, REASSIGN...), but mechanical application (moving events, deleting plotlines) is the code's job. This separation allows validating verdicts before applying them and guarantees consistency.
+
+### 1.10. The library is stateless — the caller stores results
+- **Decision:** `get_plotlines()` is a pure function. No database, no files, no state between calls.
+- **Where:** `pipeline.py:33-199`, `CLAUDE.md:8-9`, `docs/2026-03-16-prior-season-continuity-design.md:141`
+- **Assumption:** The library is computation, not a product. Persistence is the application's responsibility (tvplotlines-app).
+
+### 1.11. Pipeline resumability — intermediate results can be supplied
+- **Decision:** Parameters `context`, `cast`, `plotlines`, `breakdowns` allow skipping the corresponding passes.
+- **Where:** `pipeline.py:39-47`, `pipeline.py:128-167`
+- **Assumption:** The pipeline can fail at any step. The user should be able to resume from where it stopped without restarting everything.
+
+### 1.12. Multi-season via the `prior` parameter
+- **Decision:** `prior: TVPlotlinesResult` is the only way to pass context from a previous season.
+- **Where:** `pipeline.py:38`, `docs/2026-03-16-prior-season-continuity-design.md:140-145`
+- **Assumption:** One parameter instead of two (`prior_cast` + `prior_plotlines`). The library remains stateless. The caller stores results and chains: `r2 = get_plotlines(..., prior=r1)`. Anthology format is blocked (`ValueError`) because anthology seasons are independent by definition.
+
+---
+
+## 2. Prompt Design
+
+### 2.1. Theoretical framework: Story DNA
+- **Decision:** A plotline is defined through four components: driver + goal + obstacle + stakes.
+- **Where:** `pass1.md:43-44`, `pass3.md:27-29` (Nash p.34 quote)
+- **Assumption:** Story DNA is the minimal sufficient abstraction for describing narrative conflict. Source: Nash, "Television Storytelling." Without any of the four components, it is not a plotline but an event or a runner.
+
+### 2.2. Franchise type — 4 types
+- **Decision:** Classification: procedural, serial, hybrid, ensemble.
+- **Where:** `pass0.md:24-32`
+- **Assumption:** These four types cover the vast majority of TV series. Each type sets different expectations for the number and structure of plotlines. Sources: Douglas, Nash, Mittell. There is no "miniseries" as a separate franchise type — that is `format: limited`, orthogonal to structure.
+
+### 2.3. Story engine — templates by type
+- **Decision:** For each franchise type, a story engine template with fillable slots.
+- **Where:** `pass0.md:37-56`
+- **Assumption:** The template constrains the LLM from free-form speculation and provides a structured description. Procedural: "each week, a [profession] solves a [problem], testing [quality]." Serial: "[protagonist] [transformation], testing how far they will go for [goal]." Hybrid and Ensemble follow analogous patterns.
+
+### 2.4. A/B/C/runner — rank hierarchy
+- **Decision:** Four levels: A (primary), B (secondary), C (tertiary), runner (incomplete).
+- **Where:** `pass1.md:56-63`
+- **Assumption:** The TV industry standardly uses A/B/C to denote plotline weight (Douglas). Runner is added for plotlines without obstacle/resolution — they exist in TV series but lack full conflict. Constraint: serial/procedural/hybrid have exactly 1 A-plotline; ensemble has 2+ A-plotlines (`pass1.py:257-268`).
+
+### 2.5. Granularity: by GOAL, not by character
+- **Decision:** A single character can drive multiple plotlines with different goals.
+- **Where:** `pass1.md:78-83`
+- **Assumption:** LLMs tend to group everything "about Walt" into one plotline. The explicit instruction "the key is the goal, not the character" + the naming format `Driver: Theme` counteracts this bias. Example: Walt drives both "Empire" (drug business) and "Family" (hiding the truth from Skyler).
+
+### 2.6. Naming format: `Driver: Theme`
+- **Decision:** A plotline name always follows the format `Driver: Theme` (e.g., "Walt: Empire," "Hank: Investigation").
+- **Where:** `pass1.md:103` (RU), `pass1_en.md:106` (EN)
+- **Assumption:** The format makes explicit who drives the plotline and prevents confusion when assigning events in Pass 2. Without it, the LLM might name a plotline "Drug Business" — and then it is unclear whether it belongs to Walt or Jesse.
+
+### 2.7. "What is NOT a plotline" — negative examples
+- **Decision:** A table of 5 counter-examples: background, setting, state, context, franchise engine.
+- **Where:** `pass1.md:86-95`
+- **Assumption:** Without negative examples, LLMs tend to create false plotlines from background details. "When in doubt — do NOT create a plotline" — conservative bias.
+
+### 2.8. Plotline types: episodic, serialized, runner
+- **Decision:** Three types, not two. Episodic — for franchise engine, serialized — season-spanning, runner — incomplete.
+- **Where:** `pass1.md:49-53`
+- **Assumption:** Runner is a deliberate choice: rather than discarding plotlines without an obstacle, they are labeled. This allows Pass 3 to decide their fate.
+
+### 2.9. For procedural/hybrid — exactly one episodic plotline
+- **Decision:** Code validates: `episodic_count != 1` → error.
+- **Where:** `pass1.py:247-254`, `pass1.md:50`
+- **Assumption:** The franchise engine (case-of-the-week) is ONE recurring structure, not N separate stories. The specific content of each episode is handled in Pass 2.
+
+### 2.10. Nature: plot-led vs character-led
+- **Decision:** Two conflict categories: external (plot-led) and internal (character-led).
+- **Where:** `pass1.md:68-71`
+- **Assumption:** The distinction matters for understanding structure: the B-story is often character-led (carries the episode's theme), while the A-story is plot-led (advances the plot).
+
+### 2.11. Confidence: solid, partial, inferred
+- **Decision:** Three confidence levels for a plotline's Story DNA.
+- **Where:** `pass1.md:221`, `pass3.md:33-38`
+- **Assumption:** TV series can be poorly written. A plotline may exist without a clear goal, with nominal conflict. Instead of discarding it, we mark confidence. "A weak plotline in a bad script is data, not an error" (pass3.md:39).
+
+### 2.12. Event functions: 7 types
+- **Decision:** setup, escalation, turning_point, climax, resolution, cliffhanger, seed.
+- **Where:** `pass2.md:38-49`
+- **Assumption:** A minimal set covering three-act structure + TV-specific functions (cliffhanger, seed). Seed — the germ of a future plotline, distinct from setup. Cliffhanger — a break at the peak, distinct from climax.
+
+### 2.13. Narrative devices: 6 types
+- **Decision:** dramatic_irony, flashback, flashforward, callback, twist, unreliable — at the plotline level (Pass 1) and at the event level (Pass 2).
+- **Where:** `pass1.md:105-118`, `pass2.md:51-63`
+- **Assumption:** Devices characterize a plotline across the entire season, not as a one-time occurrence. Pass 1 outputs devices for a plotline; Pass 2 uses them as hints when annotating events.
+
+### 2.14. Interactions between plotlines: 4 types
+- **Decision:** thematic_rhyme, dramatic_irony, convergence, meta.
+- **Where:** `pass2.md:67-73`
+- **Assumption:** Plotlines do not exist in a vacuum. Thematic rhyme is a key TV narrative device (Douglas). Convergence is the intersection of plotlines. Meta is a structural device operating above plotlines (wraparound, twist-reveal, time_jump).
+
+### 2.15. Emotional counterpoint as a check
+- **Decision:** "If all plotlines are rising or all are falling — something is missed or the functions are wrong."
+- **Where:** `pass2.md:75`
+- **Assumption:** Good TV narrative alternates emotional registers. This is a heuristic for LLM self-checking.
+
+### 2.16. Patches — Pass 2 does not rerun Pass 1
+- **Decision:** Pass 2 collects suggestions (patches: ADD_LINE, CHECK_LINE, SPLIT_LINE, RERANK) but cannot modify the plotline list.
+- **Where:** `pass2.md:231-240`
+- **Assumption:** Pass 2 processes one episode at a time. It lacks the full picture to modify the global plotline list. Patches are hints for Pass 3, which sees everything.
+
+### 2.17. also_affects — double bump
+- **Decision:** An event is bound to one plotline; incidentally affected plotlines go in `also_affects`.
+- **Where:** `pass2.md:34` (rule 4), `models.py:57`
+- **Assumption:** An event can pertain to two plotlines (Walt killing Krazy-8 is both empire and family). Instead of duplication — one binding + cross-reference.
+
+### 2.18. Weight is computed by code, not the LLM
+- **Decision:** The Pass 2 prompt explicitly prohibits including weight in the JSON: "Weight is computed by code from event counts — do NOT include it in JSON."
+- **Where:** `pass2.md:81`, `postprocess.py:83-111`
+- **Assumption:** Weight is an objective metric (primary/background/glimpse), determined by thresholds: ≥50% of max = primary, ≥2 events = background, otherwise glimpse. These thresholds are hardcoded (`postprocess.py:104-109`).
+
+### 2.19. Pass 3 — the "Hollywood story editor" role
+- **Decision:** The Pass 3 prompt assigns a specific role: a story editor who is the first to see the full picture.
+- **Where:** `pass3.md:12-14`
+- **Assumption:** Framing helps the LLM understand the task: not "find errors" but "look at the result as a whole, as an editor, and decide whether corrections are needed."
+
+### 2.20. Pass 3 — "if everything is fine, return an empty array"
+- **Decision:** An explicit instruction not to fabricate problems.
+- **Where:** `pass3.md:174`
+- **Assumption:** LLMs tend to "be helpful" and find problems even when there are none. Without this instruction, Pass 3 would generate false verdicts.
+
+### 2.21. The Pass 3 prompt references theory with citations
+- **Decision:** Quotes from Nash p.34, Oberg p.60, Douglas p.132 are embedded in the prompt.
+- **Where:** `pass3.md:29`, `pass3.md:49`, `pass3.md:59`
+- **Assumption:** Book citations anchor the LLM to a specific theoretical framework rather than general knowledge from training data. This improves decision quality.
+
+### 2.22. Two prompt languages: Russian and English
+- **Decision:** Prompts exist in two versions: `prompts/` (RU) and `prompts_en/` (EN).
+- **Where:** `prompts/__init__.py:10-25`, `llm.py:98` (`lang: str = "ru"`)
+- **Assumption:** Prompt language affects output quality. Russian is the default (original development language). English is for international audiences and potentially better quality on English-language synopses. Fields goal/obstacle/stakes are in the synopsis language.
+
+### 2.23. Event specificity — explicit instruction
+- **Decision:** "Event descriptions must be specific. Name the characters, state exactly what happens, and what dramatic consequence it leads to."
+- **Where:** `pass2.md:22-23`
+- **Assumption:** Without this instruction, LLMs tend to write generic descriptions ("the team works on a case"), making correct plotline assignment impossible.
+
+### 2.24. Response format — strictly JSON, no markdown
+- **Decision:** "Response must be strictly JSON, no markdown wrapping, no comments outside JSON." Repeated in every prompt.
+- **Where:** `pass0.md:60`, `pass1.md:134`, `pass2.md:79`, `pass3.md:98`
+- **Assumption:** LLMs tend to wrap JSON in ```json``` blocks. The instruction tries to prevent this. The code in `_extract_json()` can still parse markdown wrappers as a fallback (`llm.py:596-610`).
+
+### 2.25. Binding rule: by goal, not by character
+- **Decision:** "Multiple characters in a scene → the plotline of the one whose GOAL the scene advances."
+- **Where:** `pass2.md:33`
+- **Assumption:** Counters LLM bias: without this rule, the model assigns an event to the plotline of a character who is merely present in the scene, not the one whose goal the scene advances.
+
+### 2.26. Frequency hint — B-story check
+- **Decision:** "B-story = 1-2 scenes per act. If a plotline has more events than the A → recheck the hierarchy."
+- **Where:** `pass2.md:35`
+- **Assumption:** A quantitative heuristic for LLM self-checking. Helps detect hierarchy errors.
+
+### 2.27. Prior season — three decisions for each plotline
+- **Decision:** For each prior plotline, the LLM explicitly chooses: CONTINUES, TRANSFORMED, or ENDED.
+- **Where:** `pass1.md:26-28`, `docs/2026-03-16-prior-season-continuity-design.md:142`
+- **Assumption:** Forcing an explicit decision reduces hallucination. "Prior is a hint, not a constraint" — the LLM is free to decide that a plotline has ENDED, but must do so explicitly.
+
+### 2.28. Seed and wraparound are NOT plotline types
+- **Decision:** An explicit prohibition on creating plotlines of type "seed" or "wraparound."
+- **Where:** `pass1.md:73-74`
+- **Assumption:** LLMs may create a plotline "Seed: Future Plot" — this is not a plotline but an event function or a meta device.
+
+### 2.29. Format (ongoing/limited/anthology) affects expectations
+- **Decision:** limited → all plotlines should receive resolution; ongoing → cliffhanger is acceptable; anthology → do not reference other seasons.
+- **Where:** `pass1.md:122-124`, `pass2.md:49`
+- **Assumption:** Format is a characteristic orthogonal to franchise type. A limited series in its final episode expects resolution, not seed.
+
+### 2.30. Quantitative expectations by type
+- **Decision:** Procedural: 2-3 plotlines per episode. Serial: 3-8 per season. Ensemble: 4-6.
+- **Where:** `pass1.md:128-131`
+- **Assumption:** Numbers are based on analysis of real TV series (Nash, Douglas). They set a frame for the LLM to avoid generating 20 plotlines or 1.
+
+---
+
+## 3. Data Model
+
+### 3.1. Story DNA: driver, goal, obstacle, stakes
+- **Decision:** Four fields — the core of Plotline.
+- **Where:** `models.py:37-40`
+- **Assumption:** This is the minimal sufficient set for describing narrative conflict. Nash p.34: "Story DNA has four parts: Hero, Goal, Obstacle, Stakes." Goal — what the hero wants. Obstacle — what stands in the way. Stakes — what is at risk.
+
+### 3.2. Rank A/B/C/runner — enum, not a number
+- **Decision:** A text enum, not a numeric value.
+- **Where:** `models.py:42`
+- **Assumption:** A/B/C is standard industry terminology. Runner is not "D" but a separate category (incomplete Story DNA).
+
+### 3.3. Cast with id, name, aliases
+- **Decision:** Each character has a stable id, a full name, and a list of aliases.
+- **Where:** `models.py:23-28`
+- **Assumption:** Synopses use different name forms (Walt, Walter White, Heisenberg, Mr. White). Aliases allow the LLM in Pass 2 to correctly identify characters. The id is stable — it does not change between seasons.
+
+### 3.4. Guest characters — `guest:short_name` format
+- **Decision:** Guest characters are not included in the cast but are marked with the `guest:` prefix.
+- **Where:** `pass2.md:203`, `pass2.py:330-335`
+- **Assumption:** Guest characters appear in one episode. Creating a full CastMember for them is overengineering. Plotlines belong to the cast, not to guests.
+
+### 3.5. Span is computed post-hoc from Pass 2
+- **Decision:** Plotline.span is not determined by the LLM — it is computed by code from event presence.
+- **Where:** `pass1.md:226`, `postprocess.py:13-29`
+- **Assumption:** Span is an objective metric: a plotline is present in an episode if it has at least one event. An LLM is not needed for counting.
+
+### 3.6. Verdict — action + data dict
+- **Decision:** A Verdict stores an action (MERGE/REASSIGN/...) and an arbitrary dict with data.
+- **Where:** `models.py:93-97`
+- **Assumption:** Different verdict types have different fields (MERGE: source/target; REASSIGN: event/episode/from/to; CREATE: plotline/reassign_events). Instead of a class hierarchy — a simple dict with an action key.
+
+### 3.7. EpisodeBreakdown includes theme and interactions
+- **Decision:** Beyond events, each episode contains a theme and inter-plotline relationships.
+- **Where:** `models.py:82-89`
+- **Assumption:** The episode theme and interactions (thematic_rhyme, dramatic_irony, convergence, meta) are valuable data for analysis, not only for Pass 3.
+
+### 3.8. Patch — a suggestion, not a command
+- **Decision:** A Patch from Pass 2 contains action, target, reason, episodes. But it is not applied automatically.
+- **Where:** `models.py:72-78`, `pass2.md:232-233`
+- **Assumption:** Pass 2 processes one episode at a time — it lacks the full picture. Patches are hints for Pass 3. The separate model (Patch vs Verdict) underscores the difference: Patch is a suggestion, Verdict is a decision.
+
+### 3.9. TVPlotlinesResult contains a usage summary
+- **Decision:** The result includes a string with request count, token count, and cost.
+- **Where:** `models.py:108`, `pipeline.py:198`
+- **Assumption:** The user wants to know how much a run costs. Usage is a string, not a structure (because the format depends on the provider).
+
+---
+
+## 4. Engineering Decisions
+
+### 4.1. Anthropic as the default provider
+- **Decision:** `provider: str = "anthropic"`, default model: `claude-sonnet-4-20250514`.
+- **Where:** `llm.py:96`, `llm.py:115`
+- **Assumption:** Claude is the best model for long structured prompts with JSON output (based on the author's experience). But the pipeline is not locked in — OpenAI and any OpenAI-compatible APIs are supported.
+
+### 4.2. Prompt caching for Pass 2
+- **Decision:** The Pass 2 system prompt is cached across episodes (`cache_system=True`).
+- **Where:** `pass2.py:98`, `pass2.py:194-196`, `llm.py:449-457`
+- **Assumption:** All episodes in Pass 2 use the same system prompt. Caching saves ~90% on input tokens for the prompt (Anthropic: cache reads are 90% cheaper, `llm.py:63`).
+
+### 4.3. Retry with JSON validation
+- **Decision:** Up to 2 retries on JSON errors and validation failures. On retry, the previous response is included in context.
+- **Where:** `llm.py:25` (`_MAX_RETRIES = 2`), `llm.py:205-237`
+- **Assumption:** LLMs sometimes return invalid JSON (markdown wrapping, extraneous comments) or violate the schema. Retrying with a specific error indication usually fixes the problem.
+
+### 4.4. Retry with exponential backoff for network errors
+- **Decision:** Up to 3 retries for transient errors (APIConnectionError, RateLimitError, InternalServerError).
+- **Where:** `llm.py:26` (`_MAX_NETWORK_RETRIES = 3`), `llm.py:162-185`
+- **Assumption:** Network errors are transient. Exponential backoff (2s, 4s, 8s) avoids overloading the API.
+
+### 4.5. Batch API for Pass 2 (50% cheaper)
+- **Decision:** `pass2_mode="batch"` — Anthropic Batch API, 50% cheaper but slower.
+- **Where:** `llm.py:287-414`, `pipeline.py:149-155`
+- **Assumption:** For long seasons (22-episode House), batch yields significant savings. Fallback: if batch fails for individual requests — retry via the regular API.
+
+### 4.6. Async-first architecture with sync wrappers
+- **Decision:** All LLM calls are async (`acall_llm`). Sync wrappers (`call_llm`) use `asyncio.run()`.
+- **Where:** `llm.py:1-8`, `llm.py:527-588`
+- **Assumption:** Async enables parallel calls (Pass 2). Sync wrappers exist for ease of use in single-threaded code. Jupyter fix via `ThreadPoolExecutor` (`llm.py:534-538`).
+
+### 4.7. Temperature = 0
+- **Decision:** All LLM calls use temperature=0.
+- **Where:** `llm.py:462`, `llm.py:507`
+- **Assumption:** The task is extraction, not generation. Maximum determinism is needed. Voting in Pass 1 still provides variability through parallel calls.
+
+### 4.8. max_tokens = 6144
+- **Decision:** All calls use max_tokens=6144.
+- **Where:** `llm.py:461`, `llm.py:339`
+- **Assumption:** Pass 2 (one episode) typically uses 1000-3000 tokens. Pass 3 (all episodes) can be longer. 6144 provides headroom without overpaying for unused capacity.
+
+### 4.9. Orphan assignment — by character → storyline frequency
+- **Decision:** Orphaned events are assigned to the plotline most frequently associated with their characters.
+- **Where:** `postprocess.py:32-80`
+- **Assumption:** If the LLM returns `storyline: null`, it is most likely a binding error, not a genuinely unassignable event. Character frequency is a reasonable heuristic. Fallback: if a character has not appeared anywhere, the most frequent plotline in the episode is used.
+
+### 4.10. validate_ranks — automatic demotion of A-rank with short span
+- **Decision:** An A-rank plotline with span < 25% of the season → demote to B.
+- **Where:** `postprocess.py:114-120`, `postprocess.py:152-153`
+- **Assumption:** An A-plotline should be present in a significant portion of the season. 25% is an empirical threshold. The dominance threshold (>50% of events) is a flag for Pass 3, not an automatic action.
+
+### 4.11. PROMOTE to A is blocked for non-ensemble
+- **Decision:** Code blocks PROMOTE to A if an A-rank plotline already exists (except for ensemble).
+- **Where:** `verdicts.py:116-123`
+- **Assumption:** Serial/procedural/hybrid have exactly 1 A-plotline. This is an invariant that the code protects even if the LLM reviewer suggests otherwise.
+
+### 4.12. _extract_json — regex fallback
+- **Decision:** First `json.loads()`, then regex for ```json...``` blocks.
+- **Where:** `llm.py:596-610`
+- **Assumption:** Despite the "no markdown wrapping" instruction, models sometimes wrap anyway. Fallback is cheaper than retry.
+
+### 4.13. response_format: json_object — only for OpenAI
+- **Decision:** `response_format` is used only for `provider == "openai"`, not for Ollama/DeepSeek/Groq.
+- **Where:** `llm.py:509-511`
+- **Assumption:** Not all OpenAI-compatible providers support `response_format`. It is safer not to send it.
+
+### 4.14. Known providers with defaults
+- **Decision:** Ollama, DeepSeek, Groq are built in with default base_url and model.
+- **Where:** `llm.py:104-108`
+- **Assumption:** The user should not have to enter a URL and model for popular providers. Ollama: `localhost:11434/v1`, `qwen2.5:14b`. DeepSeek: `api.deepseek.com/v1`, `deepseek-chat`. Groq: `api.groq.com/openai/v1`, `llama-3.3-70b-versatile`.
+
+### 4.15. Hardcoded pricing
+- **Decision:** Per-token prices for claude-sonnet-4, haiku-4.5, gpt-4o are hardcoded.
+- **Where:** `llm.py:32-36`
+- **Assumption:** Prices change infrequently. This is sufficient for cost estimation. If the model is not in the dictionary — cost = 0.
+
+### 4.16. Callback pattern — not files
+- **Decision:** `PipelineCallback` — a subclass with methods `on_pass0_complete`, `on_pass1_complete`, etc.
+- **Where:** `callbacks.py`, `pipeline.py:23-30`
+- **Assumption:** The library does not write files. The caller decides what to do with intermediate results. Callbacks are wrapped in try/except so that a bug in a callback does not kill the pipeline.
+
+### 4.17. Metrics: coverage + ARI
+- **Decision:** Coverage = the fraction of events with a non-empty storyline. ARI = adjusted rand index across multiple runs.
+- **Where:** `metrics.py`
+- **Assumption:** Coverage is a simple completeness metric. ARI is a standard clustering metric that measures result stability (consistency). Used in the ablation study. The sklearn dependency is only for consistency, outside the core pipeline.
+
+### 4.18. Ablation study: baseline vs merged
+- **Decision:** The experiment compares the standard pipeline (4 passes) with merged (Pass 0+1 combined).
+- **Where:** `experiments/ablation_pass0.py`, `pass1_merged.py`, `prompts_en/pass1_merged.md`
+- **Assumption:** Hypothesis: a separate Pass 0 yields better quality because franchise type is determined before plotline analysis. The ablation tests this via coverage, ARI, tokens, and time.
+
+### 4.19. Episode keys — strict S{dd}E{dd} format
+- **Decision:** Episode keys must match the regex `^S\d{2}E\d{2}$`.
+- **Where:** `pipeline.py:20, 87-91`
+- **Assumption:** This is the standard episode identification format in the industry. The season number in the key must match the `season` parameter.
+
+### 4.20. Diagnostics — post-processing flags for Pass 3
+- **Decision:** validate_ranks generates flags (demoted, dominant) that are passed to Pass 3 as `diagnostics`.
+- **Where:** `pipeline.py:173, 179`, `pass3.md:22`
+- **Assumption:** Automated flags are objective data (computed by code) that help Pass 3 make decisions. They are context, not commands.
+
+### 4.21. Global usage tracker, reset per run
+- **Decision:** A global `UsageStats` object, reset on each `get_plotlines()` call.
+- **Where:** `llm.py:84`, `pipeline.py:125-126`
+- **Assumption:** A simple way to aggregate usage across all LLM calls. `usage.__init__()` is a reset. Not thread-safe, but not a problem within a single pipeline run.
+
+---
+
+## 5. Assumptions (Implicit)
+
+### 5.1. Synopses (~300 words) contain sufficient signal
+- **Assumption:** The pipeline operates on synopses, not scripts. A synopsis provides ~300 words for a 45-minute episode. This is sufficient for identifying plotlines and key events.
+- **Where:** `README.md:9` ("Works from synopses alone — no scripts or transcripts needed"), `CLAUDE.md:25`
+- **Risk:** Synopses may omit B/C-plotlines, focusing on A. The confidence field partially compensates for this.
+
+### 5.2. The LLM possesses sufficient knowledge of narrative structure
+- **Assumption:** The model (Claude/GPT) knows what A/B/C stories, franchise engine, three-act structure, and story engine are — from training data.
+- **Where:** Prompts use professional terminology without definitions (except for franchise types and Story DNA).
+- **Risk:** Local models (Ollama/Qwen) may not know these concepts. The prompts contain enough context to compensate.
+
+### 5.3. Story DNA is the correct abstraction
+- **Assumption:** Four components (driver + goal + obstacle + stakes) are a sufficient and necessary abstraction for describing a plotline.
+- **Where:** `pass1.md:43-44`
+- **Risk:** Some narrative traditions (ensemble dramas, slice-of-life) may not fit this model. Confidence = inferred and runner provide partial compensation.
+
+### 5.4. Franchise type is stable within a season
+- **Assumption:** The type is determined from the first 2-3 episodes and applied to the entire season.
+- **Where:** `pass0.py:42` (episodes[:3])
+- **Risk:** Some series change structure mid-season (procedural → serial). Pass 0 will not detect this.
+
+### 5.5. Franchise type is stable across seasons
+- **Assumption:** With `prior`, the previous season's context is reused without re-evaluation.
+- **Where:** `pipeline.py:121`
+- **Risk:** Some series change type between seasons (The Wire: different focus each season). The user can pass `context` explicitly to override.
+
+### 5.6. One season is one unit of analysis
+- **Assumption:** The pipeline processes one season at a time. Cross-season analysis is out of scope.
+- **Where:** `pipeline.py:33-51`, `docs/2026-03-16-prior-season-continuity-design.md:134`
+- **Risk:** Plotlines that exist only between seasons (setup in S01 finale → payoff in S02 premiere) may be missed.
+
+### 5.7. 3 voting rounds are sufficient for stability
+- **Assumption:** `_VOTING_ROUNDS = 3` is enough for majority voting.
+- **Where:** `pass1.py:19`
+- **Risk:** At temperature=0, 3 rounds may yield the same result (no diversity). With an unstable model, 3 may be too few. But more rounds are more expensive (3x the cost of Pass 1).
+
+### 5.8. Sorting by storyline ID set is a sufficient agreement metric
+- **Decision:** Voting selects the result whose set of storyline IDs occurs most frequently.
+- **Where:** `pass1.py:155-161`
+- **Assumption:** ID set is a proxy for "plotline structure." If two runs yield the same IDs, they are assumed to agree on content (goal, obstacle, stakes may differ). This is a coarse metric, but fast.
+
+### 5.9. The LLM response in Pass 3 correctly references event text
+- **Assumption:** REASSIGN/DROP/CREATE require exact event text matches. If the LLM paraphrases, validation rejects it.
+- **Where:** `pass3.md:176`, `pass3.py:171-172`
+- **Risk:** LLMs tend to paraphrase. Retry should fix this, but it is not guaranteed.
+
+### 5.10. Verdict order does not matter (except CREATE → REASSIGN)
+- **Assumption:** `apply_verdicts` applies verdicts in the order received. CREATE adds an ID that may then be used in a REASSIGN within the same batch.
+- **Where:** `verdicts.py:37-56`, `pass3.py:139-145`
+- **Risk:** If REASSIGN precedes CREATE for the same ID, the verdict will not find the target. Validation accounts for `created_ids` during checking.
+
+### 5.11. Weight thresholds are empirical
+- **Assumption:** primary ≥ 50% of max, background ≥ 2 events, glimpse — everything else.
+- **Where:** `postprocess.py:104-109`
+- **Risk:** On seasons with few events per episode, the thresholds may be inadequate.
+
+### 5.12. Rank validation threshold — 25% span for A-rank
+- **Assumption:** An A-plotline must be present in at least 25% of the season's episodes.
+- **Where:** `postprocess.py:119` (`min_span_frac: float = 0.25`)
+- **Risk:** For short seasons (4-6 episodes), 25% = 1-2 episodes — may be too lenient.
+
+### 5.13. Prompts are self-contained documents
+- **Assumption:** Each prompt is a "self-contained document, fed to the LLM as-is" (line 1 of each prompt).
+- **Where:** `pass0.md:3`, `pass1.md:3`, `pass2.md:3`, `pass3.md:3`
+- **Risk:** When updating references, the prompt must be "reassembled." There is no automatic assembly — it is a manual process.
+
+### 5.14. The original is a from-scratch rewrite, not a fork
+- **Assumption:** tvplotlines is rewritten from scratch. Balestri & Pescatore (ICAART 2025) is an ideological source, not code.
+- **Where:** `CLAUDE.md:12-14`
+- **Risk:** Not applicable as a risk per se, but important for the preprint — proper citation is required.
+
+[^1]: Qiu, Libin, and others, ‘Blueprint First, Model Second: A Framework for Deterministic LLM Workflow’, arXiv:2508.02721, preprint, arXiv, 1 August 2025, doi:[10.48550/arXiv.2508.02721](https://doi.org/10.48550/arXiv.2508.02721)
diff --git a/docs/knowledge/archive/plans/docs-audit-2026-03-26.md b/docs/knowledge/archive/plans/docs-audit-2026-03-26.md
new file mode 100644
index 0000000..ed04005
--- /dev/null
+++ b/docs/knowledge/archive/plans/docs-audit-2026-03-26.md
@@ -0,0 +1,506 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# Аудит документации tvplotlines v0.1.0
+
+Дата: 2026-03-26
+
+## 1. Документация библиотеки (в репозитории)
+
+### 1.1 Обязательные файлы
+
+| Файл | Статус | Комментарий |
+|------|--------|-------------|
+| README.md | OK | Импорты, CLI, примеры — всё соответствует коду |
+| LICENSE (MIT) | OK | |
+| CHANGELOG.md | OK | Одна запись v0.1.0, для первого релиза достаточно |
+| CONTRIBUTING.md | OK | Setup, тесты, стиль — корректно |
+| pyproject.toml | OK | Метаданные, зависимости, classifiers — на месте |
+| .gitignore | OK | |
+| .github/workflows/test.yml | OK | Python 3.11-3.13, pytest |
+
+### 1.2 Документация для пользователей
+
+| Файл | Статус | Комментарий |
+|------|--------|-------------|
+| docs/index.md | OK | Минимальный хаб, ссылки на quickstart и api |
+| docs/quickstart.md | OK | Импорты и вызовы корректны |
+| docs/api.md | **ОШИБКА** | Список event functions не совпадает с models.py (см. ниже) |
+| docs/images/app-grid.png | OK | Скриншот для README |
+
+### 1.3 Примеры
+
+| Файл | Статус | Комментарий |
+|------|--------|-------------|
+| examples/run_pipeline.py | OK | Актуальный API |
+| examples/synopses/ | OK | Breaking Bad + GoT |
+| examples/results/ | OK | Готовые JSON-результаты |
+
+### 1.4 Промпты (runtime-зависимость)
+
+| Файл | Статус |
+|------|--------|
+| src/tvplotlines/prompts_en/pass0.md | OK |
+| src/tvplotlines/prompts_en/pass1.md | OK |
+| src/tvplotlines/prompts_en/pass2.md | OK |
+| src/tvplotlines/prompts_en/pass3.md | OK |
+| src/tvplotlines/prompts_en/synopses_writer.md | OK |
+| src/tvplotlines/prompts_en/__init__.py | OK (importlib.resources) |
+
+---
+
+## 2. Найденные проблемы
+
+### КРИТИЧЕСКИЕ
+
+**2.1 Промпты не попадут в pip-пакет**
+
+Hatchling по умолчанию включает только `.py` файлы. Промпты `.md` из `prompts_en/` не будут упакованы в wheel. При `pip install tvplotlines` вызов `load_prompt()` упадёт с FileNotFoundError.
+
+Нужно добавить в pyproject.toml:
+
+```toml
+[tool.hatch.build.targets.wheel]
+packages = ["src/tvplotlines"]
+artifacts = ["src/tvplotlines/prompts_en/*.md"]
+```
+
+Или использовать `[tool.hatch.build]` с `include`.
+
+### ЗНАЧИМЫЕ
+
+**2.2 api.md: event functions расходятся с models.py**
+
+- api.md перечисляет: `setup, escalation, turning_point, climax, resolution, cliffhanger, seed`
+- models.py определяет: `setup, inciting_incident, escalation, turning_point, crisis, climax, resolution`
+
+Расхождение: `cliffhanger` и `seed` не существуют в коде; `inciting_incident` и `crisis` не описаны в api.md.
+
+**2.3 Бенчмарк 87% не подтверждён в коде**
+
+README заявляет "87% usable narrative structure". Эта цифра не воспроизводима из кода или тестов — нет ни скрипта бенчмарка, ни fixture с результатами. Для open-source проекта это рискованно: любой может спросить "как воспроизвести?".
+
+### РЕКОМЕНДАЦИИ (не блокируют релиз)
+
+**2.4 Нет py.typed**
+
+Без `py.typed` маркера type checkers (mypy, pyright) не будут использовать типы из пакета. Стоит добавить пустой файл `src/tvplotlines/py.typed`.
+
+**2.5 Нет системы сборки документации**
+
+Нет mkdocs.yml или readthedocs.yml. Документация читается только через GitHub. Для v0.1.0 допустимо, но для роста аудитории нужен hosted docs site.
+
+**2.6 MANIFEST.in отсутствует**
+
+При использовании hatchling не критично (sdist конфигурируется через pyproject.toml), но стоит проверить, что `hatch build` включает промпты в sdist тоже.
+
+---
+
+## 3. Ресурсные файлы (3-resources/tvplotlines/)
+
+### 3.1 Ядро — актуальные справочные документы
+
+Эти файлы — живые справочники, необходимы для работы над проектом:
+
+| Файл | Назначение |
+|------|------------|
+| architecture.md | Спецификация архитектуры pipeline |
+| design-decisions.md | Реестр решений с обоснованиями |
+| glossary.md | Глоссарий терминов (Story DNA и т.д.) |
+| open-source-strategy.md | Стратегия: что публичное, что приватное |
+| career-plan.md | Четырёхфазный план (repo → preprint → site → expand) |
+| inventory.md | Что своё vs заимствованное, IP-границы |
+| open-source-release-checklist.md | QA-чеклист перед PyPI |
+
+### 3.2 Autoresearch — история экспериментов
+
+Большой блок из 15 файлов. Документирует три поколения автоисследования (v1 → v2 → v3):
+
+| Поколение | Файлы | Статус |
+|-----------|-------|--------|
+| v1 | autoresearch-program.md, autoresearch-experiment-log.md | v1 **устарел** (заменён v2), лог актуален как история |
+| v2 | autoresearch-program-v2.md, autoresearch-run-v2.md, autoresearch-summary-v2.md | Актуальны |
+| v3 | autoresearch-v3-plan.md, -brainstorm-notes, -engineering, -engineering-review, -event-functions, -hybrid-vs-procedural, -questions, -reading-plan, -todo | Актуальны — текущий фронт работы |
+| Идеи | autoresearcher-competence-idea.md, notes-for-3rd-autoresearch.md | Актуальны как контекст для v3 |
+
+**Рекомендация:** `autoresearch-program.md` (v1) → в archive/.
+
+### 3.3 Промпт-инженерия
+
+| Файл | Статус | Комментарий |
+|------|--------|-------------|
+| how-to-prompt.md | Актуален | 10 принципов промптинга |
+| prompt-template.md | Актуален | Шаблон 7 секций для всех passes |
+| prompt-writing-rules.md | Актуален | Чеклист для переписывания промптов |
+| synopsis-authoring-protocol.md | Актуален | Протокол написания синопсисов |
+
+### 3.4 Теория и исследования
+
+| Файл | Статус | Комментарий |
+|------|--------|-------------|
+| heuristics-from-theory.md | Актуален | Правила из книг для валидации кодом |
+| metrics-survey.md | Актуален | Обзор метрик narrative extraction |
+| event-functions-redesign.md | Актуален | Редизайн функций (связан с 2.2 выше) |
+| enculturation-core-idea.md | Актуален | Ядро теоретической позиции |
+| narrative-intelligence-theory.md | Концепт | Идея, не реализована |
+| bibliography-narrative-and-autoresearch.md | Актуален | Литобзор |
+| preprint-citations-map.md | Актуален | Какие papers подтверждают какие компоненты |
+| screenwriting-theory-reading-prompt.md | Актуален | Промпт для чтения книг по сценаристике |
+
+### 3.5 Препринт
+
+| Файл | Статус | Комментарий |
+|------|--------|-------------|
+| abstract.md | Актуален | Абстракт препринта |
+| one-page.md | Актуален | Elevator pitch |
+| preprint-experiment-scaffold.md | Planned | Эксперимент с Story DNA как scaffold |
+| preprint-idea-meta-situation-model.md | Концепт | Идея для будущего |
+
+### 3.6 Планы и задачи
+
+| Файл | Статус | Комментарий |
+|------|--------|-------------|
+| publication-plan.md | Актуален | План write-synopses CLI |
+| write-synopses-plan.md | Актуален | Дизайн CLI для генерации синопсисов |
+| input-parser-plan.md | Актуален | Дизайн парсера входных файлов |
+| plan-restructure.md | Актуален | Разделение на 3 репозитория |
+| tasks-todo.md | Актуален | Текущие задачи (resilience) |
+| stability-benchmark.md | Актуален | Спецификация бенчмарка |
+| 2026-03-16-prior-season-continuity-design.md | Актуален | Дизайн multi-season |
+
+### 3.7 Разное
+
+| Файл | Статус | Комментарий |
+|------|--------|-------------|
+| blog-post-guide.md | Справочный | Шаблон блог-постов |
+| mas4bw-library-audit.md | Актуален | Технический аудит извлечения из монолита |
+| naive-vs-plotter.md | Planned | Эксперимент |
+| experiment-ru-vs-en-prompts.md | Planned | Эксперимент |
+| breakdown-gdr-s01.md | Актуален | Ground truth для валидации |
+| breakdown-sp-s01.md | Актуален | Ground truth |
+| breakdown-td-s01.md | Актуален | Ground truth |
+| resources-migration-plan.md | Актуален | Миграция 3-resources |
+| resources-restructure-design.md | Актуален | Спецификация миграции |
+| bibliography-cleanup.md | **Завершён** | Можно в archive/ |
+
+### 3.8 Устаревшие / кандидаты в archive/
+
+| Файл | Причина |
+|------|---------|
+| what-to-change.md | Черновик без решений, 35 строк, неструктурирован |
+| autoresearch-program.md | Заменён v2 |
+| bibliography-cleanup.md | Задача завершена (535 items в Zotero) |
+
+### 3.9 Данные и артефакты
+
+| Файл | Назначение |
+|------|------------|
+| autoresearch-results.tsv | Результаты v1 |
+| autoresearch-results-v2.tsv | Результаты v2 |
+| bb-s01..s05-result.json | Результаты pipeline для Breaking Bad |
+| run-bb-all-seasons.py | Скрипт запуска всех сезонов |
+| awesome-shortlist.bib | BibTeX для awesome list |
+| screenshot-2026-03-16.png | Скриншот приложения |
+
+### 3.10 Дубликат
+
+| Файл | Проблема |
+|------|----------|
+| superpowers/plans/2026-03-16-prior-season-continuity.md | Дубликат файла 2026-03-16-prior-season-continuity-design.md из основной папки |
+
+---
+
+## 4. Сводка
+
+### Библиотека (репозиторий)
+
+| Категория | Итог |
+|-----------|------|
+| Обязательные файлы | Всё на месте |
+| Документация | 1 ошибка в api.md (event functions) |
+| Упаковка | **КРИТИЧНО**: промпты не попадут в pip install |
+| Типизация | Нет py.typed |
+| CI/CD | Работает |
+| Примеры | Актуальны |
+
+### Ресурсы (3-resources/tvplotlines/)
+
+| Категория | Файлов | Итог |
+|-----------|--------|------|
+| Актуальные справочники | 7 | Ядро проекта |
+| Autoresearch | 15 | 1 устарел (v1 program) |
+| Промпт-инженерия | 4 | Все актуальны |
+| Теория | 8 | Все нужны |
+| Препринт | 4 | Все актуальны |
+| Планы и задачи | 7 | Все актуальны |
+| Ground truth breakdowns | 3 | Нужны для валидации |
+| Данные/артефакты | 6 | Результаты экспериментов |
+| В archive/ | 3 | what-to-change, autoresearch-program v1, bibliography-cleanup |
+| Дубликат | 1 | superpowers/plans/ |
+| **Итого** | ~60 | |
+
+### Действия (приоритет)
+
+1. **Критично**: добавить промпты в wheel (pyproject.toml)
+2. **Значимо**: исправить event functions в api.md
+3. **Желательно**: добавить py.typed
+4. **Порядок**: переместить 3 файла в archive/, удалить дубликат в superpowers/
+
+---
+
+## 5. Аудит тестов
+
+### 5.1 Проблема с промптами и тестами
+
+**Почему тесты проходили, если промпты не упакованы?**
+
+Потому что тесты запускались через `pip install -e ".[dev]"` (editable install). В этом режиме Python читает файлы прямо из исходников на диске — все `.md` промпты доступны по своим оригинальным путям. Баг проявится только при обычном `pip install tvplotlines` из wheel/PyPI.
+
+### 5.2 Текущее состояние fixtures/
+
+Папка `tests/fixtures/` **пустая** (только `.DS_Store`). Два тестовых файла ссылаются на отсутствующие fixture:
+
+| Тест | Отсутствующий fixture | Последствие |
+|------|-----------------------|-------------|
+| test_consistency.py | SP_S01E01..08.txt (8 файлов) | FileNotFoundError |
+| test_synopses_writer.py | wikipedia_house_s01.html (1 файл) | FileNotFoundError в 1 тесте из 15 |
+
+### 5.3 Какие тесты НУЖНЫ библиотеке
+
+Исходя из архитектуры (4 pass + postprocess + verdicts + metrics + synopses_writer + CLI + input):
+
+| Что тестируем | Зачем | Какой файл покрывает | Статус |
+|---------------|-------|---------------------|--------|
+| **Валидация LLM-ответов** (Pass 0/1/2) | Ядро надёжности: LLM возвращает мусор → валидация отсеивает | test_validation.py (16 тестов) | **НУЖЕН, OK** |
+| **Применение вердиктов** (Pass 3) | MERGE/REASSIGN/PROMOTE/DEMOTE/CREATE/DROP — вся логика мутации данных | test_verdicts.py (10 тестов) | **НУЖЕН, OK** |
+| **Постобработка** (span, weight, rank demotion) | Бизнес-логика после всех passes | test_postprocess.py (9 тестов) | **НУЖЕН, OK** |
+| **Метрики** (coverage, ARI, score) | Оценка качества результатов | test_metrics.py (9 тестов) | **НУЖЕН, OK** |
+| **Устойчивость** (retry, timeout, callbacks, resume) | Сеть падает, batch зависает, пользователь resume | test_resilience.py (11 тестов) | **НУЖЕН, OK** |
+| **Multi-season** (prior prompt building, overlap check) | Ключевая фича — связь между сезонами | test_pass1_prior.py (5 тестов) | **НУЖЕН, OK** |
+| **Pipeline control flow** (prior context reuse, anthology guard) | Правильный порядок вызова passes | test_pipeline_prior.py (3 теста) | **НУЖЕН, OK** |
+| **JSON-парсинг LLM-ответов** | Базовая утилита, edge cases code blocks | test_llm.py (5 тестов) | **НУЖЕН, OK** |
+| **Synopses writer** (Wikipedia parsing, file I/O) | Утилита для подготовки входных данных | test_synopses_writer.py (15 тестов) | **НУЖЕН, но 1 тест сломан** (нет fixture) |
+| **Модели** (dataclass instantiation) | Проверяет что конструкторы работают | test_models.py (2 теста) | **НЕ НУЖЕН** — тривиальные smoke-тесты, не ловят баги |
+| **Consistency benchmark** (полный pipeline с API) | E2E на реальном LLM | test_consistency.py (1 тест) | **НЕ НУЖЕН в CI** — требует API key + 8 fixture-файлов, которых нет |
+| **Integration resilience** (полный pipeline + callbacks) | E2E с проверкой callbacks | integration_resilience.py (2 теста) | **УСЛОВНО НУЖЕН** — требует API key, но inline data (не зависит от fixtures) |
+
+### 5.4 Чего НЕ ХВАТАЕТ
+
+| Что не покрыто | Приоритет | Почему нужно |
+|----------------|-----------|-------------- |
+| **CLI** (cli.py) | Средний | Нет тестов на парсинг аргументов, --provider, --pass2-mode, --output |
+| **Input loader** (input.py: load_synopses_dir) | Средний | Нет тестов на чтение файлов, парсинг S01E01 из имён, edge cases |
+| **Pass 0/1/2/3 с mock LLM** | Низкий | Внутренняя логика каждого pass (парсинг ответа, валидация, retry) — частично покрыта через test_validation и test_resilience |
+
+### 5.5 Вердикт по каждому тестовому файлу
+
+| Файл | Тестов | Вердикт | Действие |
+|------|--------|---------|----------|
+| test_validation.py | 16 | **Оставить** | Ядро качества. Все тесты осмысленные |
+| test_verdicts.py | 10 | **Оставить** | Покрывает всю логику Pass 3 мутаций |
+| test_postprocess.py | 9 | **Оставить** | Boundary-тесты на пороги (25%, 50%) |
+| test_metrics.py | 9 | **Оставить** | Формулы метрик, edge cases |
+| test_resilience.py | 11 | **Оставить** | Retry, timeout, callbacks, resume validation |
+| test_pass1_prior.py | 5 | **Оставить** | Multi-season — ключевая фича |
+| test_pipeline_prior.py | 3 | **Оставить** | Control flow pipeline |
+| test_llm.py | 5 | **Оставить** | JSON extraction из LLM ответов |
+| test_synopses_writer.py | 15 | **Оставить, починить** | 14 тестов работают. 1 тест (test_parse_episode_table_house_s01) сломан — нужен fixture wikipedia_house_s01.html |
+| test_models.py | 2 | **Удалить или переписать** | Тривиальные assert-ы, не ловят баги. Если оставлять — добавить тесты на to_dict()/from_dict() roundtrip |
+| test_consistency.py | 1 | **Удалить** | Зависит от 8 отсутствующих fixtures + API key. Не для CI. Если нужен — это manual benchmark, не pytest |
+| integration_resilience.py | 2 | **Переименовать** | Не pytest-файл (нет test_ префикса), не собирается pytest автоматически. Требует API key. Можно оставить как manual integration test, но убрать из tests/ или пометить маркером |
+
+### 5.6 Итог по тестам
+
+**Работающие тесты:** 84 из 88 (в 10 файлах из 12)
+**Сломанные:** 2 теста (fixture-зависимые) + 2 тривиальных
+**Покрытие:** хорошее для логики (validation, verdicts, postprocess, metrics, resilience), слабое для I/O (CLI, input loader)
+
+### Действия по тестам (приоритет)
+
+1. **Удалить** test_consistency.py — зависит от отсутствующих fixtures, бесполезен без них
+2. **Удалить или переписать** test_models.py — тривиальные тесты
+3. **Починить** test_synopses_writer.py — восстановить fixture wikipedia_house_s01.html
+4. **Решить** судьбу integration_resilience.py — оставить как manual test или удалить
+5. **Добавить** (позже) тесты для CLI и input.py
+
+---
+
+## 6. Полная карта тестов: что должно быть
+
+### Категория 1: Валидация входных данных (граница системы) — ОБЯЗАТЕЛЬНО
+
+Библиотека должна падать с понятными ошибками при плохих входах.
+
+**get_plotlines() — валидация параметров:**
+- Неправильный формат episode key (`"ep1"` вместо `"S01E01"`) → ValueError
+- Сезон в ключе не совпадает с `season` (`S02E01` при `season=1`) → ValueError
+- `cast` без `plotlines` (и наоборот) → ValueError
+- `breakdowns` длиной ≠ `episodes` → ValueError
+- `batch_id` без `pass2_mode="batch"` → ValueError
+- `prior` + `context.is_anthology=True` → ValueError
+- Неизвестный `pass2_mode` → ValueError
+
+**load_synopses_dir() — файловый ввод:**
+- Несуществующая директория → FileNotFoundError
+- Пустая директория (нет .txt) → FileNotFoundError
+- Файлы без паттерна S01E01 → ValueError
+- Дублирующиеся episode ID → ValueError
+- Автодетект show name из имени папки (`"breaking-bad"` → `"Breaking Bad"`)
+- Автодетект season из имён файлов
+
+**Покрытие:** частично (resume validation в test_resilience, anthology guard в test_pipeline_prior). **Дыра: episode keys, load_synopses_dir.**
+
+---
+
+### Категория 2: Бизнес-логика (чистые функции без LLM) — ОБЯЗАТЕЛЬНО
+
+Детерминированный код, легко тестируется, ловит реальные баги.
+
+**Постобработка (postprocess.py):**
+- compute_span — в каких эпизодах появляется plotline
+- compute_weight — primary vs glimpse классификация
+- validate_ranks — demotion A→B при коротком span, dominant flag
+- aggregate_patches — сбор patches из всех эпизодов
+
+**Вердикты (verdicts.py):**
+- MERGE — удаление source, переназначение events, обновление also_affects
+- REASSIGN — перенос event на другой plotline
+- PROMOTE/DEMOTE — смена rank
+- CREATE — новый plotline + переназначение events
+- DROP — удаление plotline + redistribution
+- Иммутабельность — оригинал не мутируется
+- Цепочка вердиктов — CREATE → REASSIGN в одном батче
+
+**Метрики (metrics.py):**
+- coverage — доля assigned events
+- ARI — consistency между прогонами
+- score — формула coverage × consistency
+- Edge cases: пустой список, один прогон, все null
+
+**Покрытие: полное** — test_postprocess (9), test_verdicts (10), test_metrics (9).
+
+---
+
+### Категория 3: Валидация LLM-ответов — ОБЯЗАТЕЛЬНО
+
+LLM возвращает мусор — валидация основа надёжности.
+
+**Pass 0:** невалидный format, пустой story_engine, не-bool поля
+**Pass 1:** пустой cast/plotlines, невалидный type, procedural без case_of_the_week, serial с 2+ A-rank, ensemble без 2+ A-rank
+**Pass 2:** невалидная function, ссылка на несуществующий plotline, неизвестный character, guest-формат, допустимая доля null
+
+**Покрытие: полное** — test_validation.py (16 тестов).
+
+---
+
+### Категория 4: Устойчивость (сеть, retry, timeout) — ОБЯЗАТЕЛЬНО
+
+**Тесты:**
+- Transient error → retry с exponential backoff
+- Max retries → ошибка пробрасывается
+- Backoff delays — правильная формула
+- Partial success в parallel — успешные сохраняются
+- Batch timeout → TimeoutError
+- Callback получает batch_id
+- Default callback — noop
+- Subclass callback — правильные аргументы
+
+**Покрытие: полное** — test_resilience.py (11 тестов).
+
+---
+
+### Категория 5: Multi-season continuity — НУЖНО
+
+**Тесты:**
+- Промпт Pass 1 с prior — JSON-структура prior_season блока
+- Промпт Pass 1 без prior — блок отсутствует
+- Пустой prior — блок не инжектится
+- Overlap warning — тот же hero без reuse ID
+- Pipeline flow — prior → Pass 0 пропускается
+- Cast+plotlines явно → prior игнорируется
+- Prior + anthology → ValueError
+
+**Покрытие: полное** — test_pass1_prior.py (5) + test_pipeline_prior.py (3).
+
+---
+
+### Категория 6: JSON-парсинг LLM-ответов — НУЖНО
+
+**Тесты:**
+- Чистый JSON, code block с/без language tag, whitespace, невалидный JSON → ValueError
+
+**Покрытие: полное** — test_llm.py (5 тестов).
+
+---
+
+### Категория 7: Synopses writer — НУЖНО
+
+**Тесты:**
+- Парсинг реального Wikipedia HTML (House S01)
+- HTML без table / без descriptions → ValueError
+- Wikipedia URL construction (single word, multi-word, override)
+- Fallback при 404
+- Оба convention 404 → ValueError
+- Rewrite через mock LLM
+- Сохранение individual / combined files
+- Загрузка из файлов (pattern, sequential, пустые, отсутствующие)
+
+**Покрытие:** test_synopses_writer.py (15 тестов). **1 сломан** — нужен fixture wikipedia_house_s01.html.
+
+---
+
+### Категория 8: Сериализация — НУЖНО
+
+**Тесты:**
+- TVPlotlinesResult.to_dict() → валидный dict для json.dumps
+- Roundtrip: result → to_dict() → from_dict() → result (если from_dict существует)
+- Вложенные структуры сериализуются корректно
+
+**Покрытие: НЕТ.** test_models.py тестирует только конструкторы.
+
+---
+
+### Категория 9: CLI — ЖЕЛАТЕЛЬНО (можно отложить)
+
+**Тесты:**
+- Парсинг аргументов: --provider, --pass2-mode, --output, --skip-review
+- Директория как вход → автодетект show + season
+- Файлы как вход → требует --show
+- write-synopses: --dry-run, --from-files, --format
+
+**Покрытие: НЕТ.**
+
+---
+
+### Категория 10: E2E / Integration — ОПЦИОНАЛЬНО
+
+Дорого, медленно, не для CI. Только manual benchmark.
+
+- Полный прогон pipeline → результат валиден
+- Consistency между прогонами (ARI > порог)
+- Callback firing order
+- Resume (0 API calls)
+
+**Покрытие:** test_consistency.py (сломан, удалить) + integration_resilience.py (требует API key).
+
+---
+
+### Сводная таблица
+
+| #   | Категория        | Приоритет   | Покрытие  | Статус                           |
+| --- | ---------------- | ----------- | --------- | -------------------------------- |
+| 1   | Валидация входов | Обязательно | Частичное | **ДЫРА: input.py, episode keys** |
+| 2   | Бизнес-логика    | Обязательно | Полное    | OK                               |
+| 3   | Валидация LLM    | Обязательно | Полное    | OK                               |
+| 4   | Устойчивость     | Обязательно | Полное    | OK                               |
+| 5   | Multi-season     | Нужно       | Полное    | OK                               |
+| 6   | JSON-парсинг     | Нужно       | Полное    | OK                               |
+| 7   | Synopses writer  | Нужно       | 14/15     | **ПОЧИНИТЬ fixture**             |
+| 8   | Сериализация     | Нужно       | Нет       | **ДЫРА: написать**               |
+| 9   | CLI              | Желательно  | Нет       | Отложить                         |
+| 10  | E2E              | Опционально | Сломано   | Удалить/решить                   |
+
+**6 категорий покрыты полностью, 2 дыры (входы + сериализация), 1 починить, 1 решить.**
diff --git a/docs/knowledge/archive/plans/execution-order.md b/docs/knowledge/archive/plans/execution-order.md
new file mode 100644
index 0000000..8a8c9f6
--- /dev/null
+++ b/docs/knowledge/archive/plans/execution-order.md
@@ -0,0 +1,210 @@
+
+## Infrastructure (imported once at startup)
+1. __init__.py — public API exports
+2. models.py — dataclasses used by all modules [^models]
+3. llm.py — LLM client abstraction (temperature=0 hardcoded for all calls)
+4. callbacks.py — optional progress hooks after each pass
+5. prompts/__init__.py — loads .md prompt files by pass name and language
+
+## User input
+- Synopsis files [^3]
+	- Option A: user provides `dict[str, str]` (episode ID → synopsis text)
+	- Option B: `prepare_synopses(show, season)` — LLM generates synopses by synopsis-authoring-protocol, temperature=0, returns `dict[str, str]`. Same LLM client as pipeline. CLI: `tvplotlines run "Breaking Bad" --season 1 --auto-synopses`
+- Prior season result (optional) — TVPlotlinesResult from previous season, for multi-season continuity
+
+## Prior season logic
+When prior is provided:
+- pass0 is skipped — reuses prior.context
+- pass1 receives prior.cast + prior.plotlines to maintain character/plotline ID continuity
+- pass1 marks each prior plotline as CONTINUES / TRANSFORMED / ENDED
+- not supported for anthology format (anthology seasons are independent)
+
+## Pipeline (orchestrated by pipeline.py)
+### 6. pass0.py — detect series context
+- INPUT: synopsis files from user, formatted or named based on convention (see User input above)
+- CODE:
+	1. extracts
+		1. show name,
+		2. season number,
+		3. episode IDs from file structure
+	2. builds user prompt: JSON with show name + season number + first 3 synopses
+	3. calls LLM with system prompt (pass0.md) and user prompt (3 synopses): 1 call
+- LLM:
+	1. reads synopses
+	2. returns JSON with
+		1. format ∈ {procedural, hybrid, serial, limited} [^format]
+		2. is_ensemble: bool
+		3. is_anthology: bool
+		4. story_engine
+		5. genre [^genre]
+		6. reasoning — explains why this format was chosen (not used downstream, for auditability)
+- CODE: validates
+	1. format ∈ {procedural, hybrid, serial, limited}
+	2. is_ensemble: bool
+	3. is_anthology: bool
+	4. story_engine is non empty str
+	5. genre — no validation
+- OUTPUT: SeriesContext object (format, is_ensemble, is_anthology, story_engine, genre) — used by all subsequent passes [^usage_tracking]
+
+### 7. pass1.py — extract cast + plotlines
+- CODE:
+	1. builds JSON from all synopses + context object from pass0
+	2. calls LLM with system prompt (pass1.md) and user prompt (all synopses): 3 parallel calls [^voting]
+- LLM:
+	1. reads all synopses,
+	2. returns JSON with
+		1. cast list
+		2. plotlines with Story DNA (hero, goal, obstacle, stakes) [^renames]
+		3. rank (A/B/C),
+		4. type (case_of_the_week, serialized, runner)
+		5. nature (plot-led, character-led, theme-led)[^nature]
+		6. confidence (solid, partial, inferred)
+- CODE:
+	1. majority voting — picks most common result from 3 runs [^voting]
+	2. validates
+		1. type ∈ {case_of_the_week, serialized, runner}
+		2. rank ∈ {A, B, C}
+		3. nature ∈ {plot-led, character-led, theme-led}
+		4. confidence ∈ {solid, partial, inferred}
+		5. hero references existing cast member
+		6. A-rank count: 1 for serial/procedural/hybrid, 2+ if is_ensemble
+		7. procedural/hybrid must have exactly 1 case_of_the_week plotline
+- OUTPUT:
+	1. cast: list of CastMember (id, name, aliases)
+	2. plotlines: list of Plotline (id, name, hero, goal, obstacle, stakes, type, rank, nature, confidence)
+	— used by pass2 (in user prompt per episode) and pass3 (for review)
+
+### 8. pass2.py — assign events to plotlines per episode
+- CODE:
+	1. builds N user prompts with shared system prompt (pass2.md, cached across episodes)
+	2. user prompt per episode: JSON with one episode synopsis + cast + plotlines
+	3. execution mode (CLI: `--pass2-mode`):
+		- parallel (default) — all N episodes async, N parallel LLM calls
+		- batch — Anthropic Batch API, 50% cheaper, slower turnaround
+		- sequential — one episode at a time, for debugging; fires `on_episode_complete` callback per episode
+- LLM (1 call per episode):
+	1. reads one episode synopsis,
+	2. returns JSON with
+		1. theme — one sentence, thematic summary of the episode
+		2. events — each assigned with
+			1. plotline (or null for orphan events),
+			2. function, [^functions]
+			3. characters,
+			4. also_affects
+		3. interactions between plotlines in the episode, each with:
+			1. type ∈ {thematic_rhyme, dramatic_irony, convergence}
+			2. lines — plotline IDs involved
+			3. description — one sentence
+		4. patches — suggested fixes passed as context to pass3, each with:
+			1. action ∈ {ADD_LINE, CHECK_LINE, SPLIT_LINE, RERANK}
+			2. target — plotline ID (or proposed new ID)
+			3. reason
+			4. episodes — relevant episode IDs
+- CODE: validates
+	1. function ∈ {setup, inciting_incident, escalation, turning_point, crisis, climax, resolution}
+	2. plotline references existing plotline ID from pass1 (or null)
+	3. characters reference existing cast IDs or use guest: prefix
+	4. also_affects references existing plotline IDs
+	5. interaction type ∈ {thematic_rhyme, dramatic_irony, convergence}
+	6. patch action ∈ {ADD_LINE, CHECK_LINE, SPLIT_LINE, RERANK}
+- OUTPUT: list of EpisodeBreakdown (one per episode), each with theme, events, interactions, patches
+
+### 9. postprocess.py — compute spans, assign orphan events, validate ranks [^postprocess]
+- CODE:
+	1. assign_orphan_events: events without a plotline get assigned to new plotlines
+	2. compute_span: calculates which episodes each plotline appears in (list of episode IDs)
+	3. compute_weight: per plotline per episode — primary / background / glimpse (from event counts)
+	4. validate_ranks: checks A/B/C distribution matches format (+ is_ensemble flag)
+	5. arc_completeness thresholds adjusted by confidence: inferred with 3/7 = expected, solid with 3/7 = flag
+- OUTPUT:
+	1. plotlines updated with span and weight fields
+	2. diagnostics flags (validate_ranks + arc_completeness adjusted by confidence) — passed to pass3
+
+### 10. pass3.py — structural review [^pass3]
+- CODE:
+	1. builds user prompt JSON with:
+		- context (show, season, format, is_ensemble, story_engine)
+		- cast (id, name)
+		- plotlines (all pass1 fields + span + weight from postprocess)
+		- episodes (theme, events, patches from pass2)
+		- diagnostics from postprocess (ranks, arc_completeness, monotonicity)
+	2. calls LLM with system prompt (pass3.md) and user prompt: 1 call
+- LLM
+	1. reviews full picture (plotlines with spans + weights, all events, patches),
+	2. returns JSON with
+		1. notes — overall quality assessment (free text)
+		2. verdicts — structural corrections to apply to plotlines:
+			- MERGE: combine two plotlines into one (source → target)
+			- REASSIGN: move an event from one plotline to another
+			- PROMOTE: raise plotline rank (e.g. B → A)
+			- DEMOTE: lower plotline rank (e.g. A → B)
+			- CREATE: add a new plotline and reassign events to it
+			- DROP: delete a plotline and redistribute its events (inferred plotline + few events = candidate for DROP)
+- CODE: validates
+	1. action ∈ {MERGE, REASSIGN, PROMOTE, DEMOTE, CREATE, DROP, REFUNCTION}
+	2. MERGE: source and target reference existing plotline IDs
+	3. REASSIGN: event exists, target plotline ID exists
+	4. PROMOTE/DEMOTE: target exists, new_rank ∈ {A, B, C}
+	5. CREATE: plotline has all required fields, reassign_events reference existing events
+	6. DROP: target exists, redistribute events reference existing events and target IDs
+
+### 11. verdicts.py — apply pass3 verdicts to plotlines [^refunction]
+- CODE:
+	1. applies each verdict (MERGE, REASSIGN, PROMOTE, DEMOTE, CREATE, DROP, REFUNCTION) to plotlines and events
+	2. pipeline recomputes spans and re-validates ranks
+- OUTPUT: final plotlines + episodes — ready for TVPlotlinesResult
+
+### TVPlotlinesResult — final output object
+- context: SeriesContext (format, is_ensemble, is_anthology, story_engine, genre)
+- cast: list of CastMember (id, name, aliases)
+- plotlines: list of Plotline (id, name, hero, goal, obstacle, stakes, type, rank, nature, confidence, span)
+- episodes: list of EpisodeBreakdown (episode, theme, events, interactions, patches)
+- usage: token/cost summary [^usage_tracking]
+
+## Total LLM calls per run: 5 + N (where N = number of episodes) [^total_calls]
+[^2]: [[tvplotlines-event-functions-redesign]]
+
+[^3]: **Input contract.** API: `episodes: dict[str, str]` (key=episode ID `S\d{2}E\d{2}`, value=synopsis text 300-500 words). CLI: `tvplotlines run files/*.txt --show "..." --season 1`. Опциональный шаг: `prepare_synopses(show, season)` — LLM генерирует синопсисы по synopsis-authoring-protocol (temperature=0, тот же LLM client). CLI: `--auto-synopses`. Задачи:
+1. написать `prepare.py` + промпт `prompts/synopsis.md`,
+2. документировать в docs/quickstart.md + docs/api.md + docs/synopsis-guide.md,
+3. починить баг: `examples/run_pipeline.py` передаёт `list[str]` вместо `dict[str, str]`.
+
+[^4]: Currently not in the code, but is in the source so should be added
+
+[^models]: **Переделать models.py:** Event.function enum — убрать cliffhanger/seed, добавить inciting_incident/crisis. См. [[tvplotlines-event-functions-redesign]].
+
+[^genre]: **Genre:** оставить как есть, не трогать. Свободный формат, не валидируется, в пайплайне не используется — но ничего не стоит (pass0 и так возвращает). Кандидат для ablation: влияет ли передача genre в pass1/pass2 на качество извлечения?
+
+[^format]: **Заменить franchise_type + format на новую схему.** Одно поле `format` ∈ {procedural, hybrid, serial, limited} + два флага: `is_ensemble: bool` (2+ A-линий), `is_anthology: bool` (нет prior между сезонами). Убрать старые franchise_type и format. Менять: models.py (SeriesContext), pass0 промпт + валидация, pass1 (правила по количеству A-линий), postprocess (validate_ranks).
+
+[^usage_tracking]: **Добавить трекинг токенов по пассам:** usage: str → структура (input_tokens, output_tokens, calls per pass). Библиотека собирает и возвращает в TVPlotlinesResult. Показ (таблица, UI) — задача app. См. [[tvplotlines-what-to-change]] п.5.
+
+[^voting]: **Ablation majority voting:** 3 параллельных вызова в pass1 могут быть избыточны при temperature=0. Оставить до autoresearch-эксперимента, но пометить как кандидат на удаление. Если убрать — total calls = 3+N вместо 5+N.
+
+[^renames]: **Переименования в models.py:** (1) `driver` → `hero` — в коде сейчас driver, в документе hero; (2) `episodic` → `case_of_the_week` — в коде сейчас episodic, в документе case_of_the_week; (3) Event.`storyline` → `plotline` — в коде сейчас storyline, в документе plotline. Менять: models.py, все пассы (промпты + валидация), verdicts.py.
+
+[^nature]: **Добавить theme-led в nature:** в источниках (Nash) есть theme-led plotlines, но в коде валидируется только {plot-led, character-led}. Нужно: (1) добавить в enum, (2) обновить промпт pass1, (3) обновить валидацию.
+
+[^functions]: **Переделать event functions:** убрать cliffhanger/seed, добавить inciting_incident/crisis. Итого: {setup, inciting_incident, escalation, turning_point, crisis, climax, resolution}. cliffhanger и seed → модификаторы (в будущем). Менять: enum в models.py, валидацию pass2.py, таблицу функций в промпте pass2. Описания функций в промпте (как объяснить LLM что такое crisis vs escalation) — оптимизировать через autoresearch. См. [[tvplotlines-event-functions-redesign]].
+
+[^postprocess]: **Расширить postprocess.py:** добавить
+1. build_plotline_arcs — собрать все события plotline по эпизодам в порядке (для pass3 и app),
+2. build_episode_arcs — собрать все события эпизода по всем plotlines в порядке,
+3. convergence_matrix — из Event.also_affects агрегировать directed matrix пересечений,
+4. arc_completeness — `len(set(functions)) / 7` per plotline,
+5. validate_arc_completeness — completeness < минимума для ранга (A>=6/7, B>=5/7, C>=3/7) → diagnostics,
+6. validate_monotonicity — возврат past milestone (inciting_incident→turning_point→crisis→climax) → diagnostics.
+Всё чистый код, без LLM. Diagnostics передаются в pass3. См. [[tvplotlines-event-functions-redesign]].
+
+[^pass3]: **Расширить pass3:** промпт получает из postprocess: plotline arcs, episode arcs, arc_completeness + diagnostics (неполные арки, нарушения монотонности). LLM решает что делать: REFUNCTION, PROMOTE/DEMOTE, etc. См. [[tvplotlines-event-functions-redesign]].
+
+[^refunction]: **Добавить вердикт REFUNCTION:** pass3 может исправить неверные function assignments (напр. escalation→crisis). Новый action в enum вердиктов, новая логика применения в verdicts.py. См. [[tvplotlines-event-functions-redesign]].
+
+[^total_calls]: **Пересчитать если убрать voting:** если ablation покажет что 1 вызов pass1 достаточен — total calls = 3+N вместо 5+N.
+
+## Ablation ideas
+- **Voting in pass1:** 3 calls vs 1 call at temperature=0. May be redundant with pass3 review.
+- **Reasoning before JSON (Wei 2022):** "First analyze the synopses in 2-3 sentences, then output JSON." Currently reasoning is inside JSON field. Test if free-form thinking before JSON improves quality. Requires parser change (extract JSON from mixed response).
+- **Genre in pass1/pass2:** does passing genre from pass0 improve extraction quality?
+
+---
\ No newline at end of file
diff --git a/docs/knowledge/archive/plans/experiment-arc-functions.md b/docs/knowledge/archive/plans/experiment-arc-functions.md
new file mode 100644
index 0000000..443ea9e
--- /dev/null
+++ b/docs/knowledge/archive/plans/experiment-arc-functions.md
@@ -0,0 +1,123 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# Experiment: Arc Functions
+
+## Question
+
+How to assign dramatic functions to events at the season-arc level (not episode level)?
+
+Two sub-questions:
+1. Does the order of assignment matter — arc first, episode first, both at once, or arc only?
+2. Which scale works best for arc functions — our 7, Harmon, McKee, or Freytag?
+
+## Design
+
+Two stages. Stage 1 finds the best assignment order. Stage 2 finds the best scale.
+
+### Stage 1: Assignment Order
+
+Fix scale = our 7 functions (setup, inciting_incident, escalation, turning_point, crisis, climax, resolution). Vary the order:
+
+| Run | What Pass 2 assigns | What Pass 3 assigns | Pass 3 sees |
+|-----|--------------------|--------------------|-------------|
+| A | nothing (events only, no function) | arc function | all events across season, plotlines |
+| B | episode function | arc function | all events + their episode functions |
+| C | arc function (preliminary) | arc function (corrected) | all events + preliminary arc functions |
+| D | episode function + arc function (both) | — | plotlines + 1 episode |
+
+Run A: cleanest — no anchoring from episode function. But Pass 3 gets no function signal at all.
+Run B: current plan — episode functions exist, Pass 3 adds arc functions on top.
+Run C: Pass 2 guesses arc function from one episode, Pass 3 corrects with full season view.
+Run D: Pass 2 does everything — cheapest (no Pass 3 work), but one-episode context for arc.
+
+### Evaluation: Majority Voting
+
+Each run repeated 3 times. For each event, compare arc function across 3 runs.
+
+**Agreement rate** = fraction of events where all 3 runs agree. Higher = model is more confident = assignment is more natural for the model.
+
+No ground truth needed at this stage — we're measuring model self-consistency, not correctness.
+
+### Test data
+
+Breaking Bad S01, plotline "Walt: Empire" — ~80 events across 7 episodes. One plotline, clear arc, well-known show.
+
+### Stage 2: Scale
+
+Take the winning order from Stage 1. Test 4 scales:
+
+| Scale | Values |
+|-------|--------|
+| Our 7 | setup, inciting_incident, escalation, turning_point, crisis, climax, resolution |
+| Harmon 8 | you (comfort), need, go, search, find, take, return, change |
+| McKee 5 | inciting incident, progressive complications, crisis, climax, resolution |
+| Freytag 5 | exposition, rising action, climax, falling action, denouement |
+
+Same evaluation: 3 runs each, agreement rate.
+
+### Stage 3: Confirmation
+
+Take winning scale + one alternative. Test with a different order than the winner. If agreement rate stays similar — order and scale are independent. If it drops — they interact.
+
+## What we need to build
+
+### For Stage 1
+
+- Prompt variant for each run (A-D)
+- Script that:
+  - Extracts events for one plotline from existing pipeline result
+  - Calls LLM with appropriate prompt 3 times
+  - Compares arc function assignments across runs
+  - Reports agreement rate per event and overall
+- No changes to pipeline code — this is a standalone experiment
+
+### Prompts
+
+**Run A prompt (Pass 3 assigns, no episode functions):**
+"Here are all events for plotline [name] across the season, in episode order. Assign a dramatic function (arc_fn) to each event based on its role in the season-long arc. Values: setup, inciting_incident, escalation, turning_point, crisis, climax, resolution."
+
+**Run B prompt (Pass 3 assigns, sees episode functions):**
+Same + "Each event already has a function assigned for its role within the episode. The arc function may differ."
+
+**Run C prompt (Pass 2 assigns preliminary):**
+"Here is one episode's events for plotline [name]. Guess the arc function based on what you see. You may be wrong — this will be corrected later with full season context."
+Then Pass 3 prompt: "Here are preliminary arc functions. Correct them with full season view."
+
+**Run D prompt (Pass 2 assigns both):**
+"For each event, assign two functions: episode_fn (role in this episode) and arc_fn (role in the season arc, as far as you can tell from this episode)."
+
+## Metrics
+
+- **Agreement rate** per run = events with 3/3 agreement / total events
+- **Partial agreement** = events with 2/3 agreement
+- **Disagreement** = events with 3 different answers
+- **Distribution** = how many events get each function (is it balanced or all escalation?)
+
+## Cost estimate
+
+BB Empire: ~80 events. Each run = 1-3 LLM calls (depending on variant). 3 repeats.
+Stage 1: 4 variants × 3 repeats = 12 calls. ~$1-2.
+Stage 2: 4 scales × 3 repeats = 12 calls. ~$1-2.
+Stage 3: 2 calls × 3 repeats = 6. ~$0.50.
+Total: ~$3-5.
+
+## Files
+
+- `scripts/arc_fn_experiment.py` — experiment runner
+- `3-resources/tvplotlines/experiment-arc-functions.md` — this plan
+- Results saved to `experiments/arc_functions/` (gitignored)
+
+## Execution order
+
+1. Write experiment script
+2. Run Stage 1 (4 variants × 3 repeats) on BB Empire
+3. Analyze agreement rates → pick best order
+4. Run Stage 2 (4 scales × 3 repeats) with best order
+5. Analyze → pick best scale
+6. Run Stage 3 (confirmation)
+7. Write up results
+8. If results clear → implement in pipeline
diff --git a/docs/knowledge/archive/plans/experiment-ru-vs-en-prompts.md b/docs/knowledge/archive/plans/experiment-ru-vs-en-prompts.md
new file mode 100644
index 0000000..d60fd80
--- /dev/null
+++ b/docs/knowledge/archive/plans/experiment-ru-vs-en-prompts.md
@@ -0,0 +1,22 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# Эксперимент: русские vs английские промты для русских синопсисов
+
+## Гипотеза
+
+По данным AlKhamissi et al. (2024), язык промта активирует культурно-специфичные знания модели. Русский промт при анализе русских синопсисов должен давать более точный результат, чем английский — потому что активирует «подсеть» русской литературной и сценарной традиции.
+
+## Дизайн
+
+- Взять русский сериал с русскими синопсисами
+- Прогнать через tvplotlines дважды: `--lang ru` и `--lang en`
+- Сравнить результаты: качество сюжетных линий, точность Story DNA, адекватность event functions
+- Оценка: ручная (экспертная) + количественная (количество storylines, confidence levels, патчей из Pass 2, вердиктов из Pass 3)
+
+## Статус
+
+Ждёт выполнения. Зависит от стабильности pipeline.
diff --git a/docs/knowledge/archive/plans/local-model-training-plan.md b/docs/knowledge/archive/plans/local-model-training-plan.md
new file mode 100644
index 0000000..09d81f9
--- /dev/null
+++ b/docs/knowledge/archive/plans/local-model-training-plan.md
@@ -0,0 +1,93 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# Fine-tuning локальной модели для Pass 2
+
+## Зачем
+
+Pass 2 (назначение событий на сюжетные линии) — самый частый LLM-вызов в пайплайне: один вызов на каждый эпизод. Fine-tuning маленькой модели (Qwen 7B) позволит запускать Pass 2 локально, бесплатно, без API. Остальные проходы остаются на Claude (они дешёвые — 1–3 вызова на сезон).
+
+Без fine-tuning локальная модель тупит (проверяли) — не понимает narratology-терминологию, ломает JSON. С fine-tuning она учится воспроизводить паттерн из примеров Claude (knowledge distillation).
+
+## Предпосылки
+
+- Промпты должны быть **стабилизированы** — каждое изменение промпта обесценивает training data
+- Все старые результаты (House, ER и др.) получены на устаревших промптах (другая схема: `driver` вместо `hero`, `franchise_type` вместо `format`, нет `nature`/`confidence`/`is_anthology`, нет Pass 4)
+- Breaking Bad S01 ближе к текущему формату, но тоже есть расхождения (`plotline` vs `plotline_id`)
+
+## Имеющиеся данные
+
+### Синопсисы (готовы, 263 эпизода)
+
+| Сериал | Эпизодов | Формат |
+|---|---|---|
+| Breaking Bad | 62 (S01–S05) | serial |
+| Lost | 26 | serial |
+| ER | 26 | procedural |
+| CSI/Criminal Minds | 24 | procedural |
+| House | 23 | procedural |
+| This Is Us | 19 | ensemble |
+| Metod | 17 | procedural |
+| Godless | 14 | serial |
+| Major | 13 | hybrid |
+| Mad Men | 13 | serial |
+| Game of Thrones | 10 | hybrid |
+| True Detective | 8 | serial |
+| Slovo Patsana | 8 | serial |
+
+### Результаты (есть, но устаревшие)
+
+- BB S01–S05 — посчитаны, но на старых промптах
+- Остальные — только S01, на ещё более старых промптах
+- **Всё нужно пересчитать** на финальных промптах
+
+## План
+
+### Этап 1. Стабилизировать промпты
+- [ ] Довести промпты до финального состояния (идёт сейчас)
+- [ ] Зафиксировать версию (тег или коммит)
+
+### Этап 2. Собрать dataset (~$15–25, batch mode со скидкой 50%)
+- [ ] Пересчитать все 13 сериалов на финальных промптах (263 эпизода)
+- [ ] Проверить качество выборочно (2–3 сериала разных форматов)
+- [ ] Сохранить результаты как training data
+
+### Этап 3. Добрать до 500 примеров (~$10–20)
+- [ ] Нагенерить синопсисы для новых сезонов через synopses_writer (GOT S02–S04, Lost S02, House S02 и т.д.)
+- [ ] Прогнать через пайплайн
+- [ ] Итого: ~500 пар вход/выход для Pass 2
+
+### Этап 4. Fine-tuning
+- [ ] Написать скрипт сборки dataset: system prompt (pass2.md + glossary) + user message (JSON) + assistant response (JSON)
+- [ ] Конвертировать в ChatML формат
+- [ ] QLoRA fine-tune Qwen 2.5 7B (работает на 16GB RAM)
+- [ ] Библиотеки: `unsloth` или `peft` + `transformers`
+
+### Этап 5. Оценка
+- [ ] Прогнать fine-tuned модель через пайплайн (подключить через Ollama)
+- [ ] Сравнить coverage и consistency с Claude
+- [ ] Проверить: fine-tuned Pass 2 + Claude Pass 3 (ревизия) ≈ 90% качества?
+
+## Ожидания по качеству
+
+| Аспект | Ожидание |
+|---|---|
+| JSON-формат | ~95% корректных ответов |
+| Назначение событий на линии | 70–85% от качества Claude |
+| Narrative functions | 60–70% от качества Claude |
+| С Pass 3 ревизией на Claude | ~90% общего качества |
+
+## Бюджет
+
+- Этап 2: $15–25 (batch API, 263 эпизода)
+- Этап 3: $10–20 (синопсисы + пайплайн, ~240 эпизодов)
+- Итого: **$25–45** разовая инвестиция
+
+## Заметки
+
+- Начинать с Pass 2 — максимальный ROI (самый частый вызов)
+- 200 примеров — нижняя граница, 500 — рабочее качество, 1000+ — уровень Claude
+- Если gap с Claude слишком большой — добирать данные прицельно на слабых форматах (ensemble, anthology)
diff --git a/docs/knowledge/archive/plans/metrics-survey.md b/docs/knowledge/archive/plans/metrics-survey.md
new file mode 100644
index 0000000..a95b610
--- /dev/null
+++ b/docs/knowledge/archive/plans/metrics-survey.md
@@ -0,0 +1,154 @@
+---
+type: spec
+project: tvplotlines
+status: active
+---
+
+# Метрики качества извлечения сюжетных линий — обзор литературы
+
+Март 2026. Обзор современных подходов к оценке качества narrative extraction / storyline clustering.
+
+## Наши текущие метрики
+
+| Метрика | Формула | Что измеряет |
+|---------|---------|-------------|
+| **Coverage** | доля событий с non-null storyline | Полнота разметки |
+| **Consistency (ARI)** | Adjusted Rand Index по сетке (episode, character) → storyline | Стабильность между прогонами |
+| **Score** | coverage × consistency | Композитный показатель |
+
+## Что используют Balestri & Pescatore (ICAART 2025)
+
+Статья: [Multi-Agent System for AI-Assisted Extraction of Narrative Arcs in TV Series](https://arxiv.org/html/2503.04817v1)
+
+- Character entity accuracy: 98.4% (61/62)
+- Anthology arc precision: 89.3% (25/28)
+- Нет recall, F1 или систематических метрик для Soap/Genre-Specific арок
+- Сравнение с одной экспертной разметкой (Grey's Anatomy S1)
+- Авторы сами признают — это proof-of-concept, не строгая оценка
+
+**Вывод**: планка невысокая, можно значительно улучшить.
+
+---
+
+## Метрики без разметки (annotation-free)
+
+### Кластерные метрики (internal validation)
+
+Поскольку извлечение линий — это по сути кластеризация (события → кластеры-линии), применимы стандартные метрики кластеризации.
+
+| Метрика | Как работает | Диапазон | Что нужно |
+|---------|-------------|----------|-----------|
+| **Silhouette Coefficient** | Насколько событие похоже на свой кластер vs ближайший чужой | [-1, 1] | Эмбеддинги событий |
+| **Davies-Bouldin Index** | Отношение внутрикластерного разброса к межкластерному | [0, ∞), меньше лучше | Эмбеддинги событий |
+| **Calinski-Harabasz Index** | Отношение межкластерной дисперсии к внутрикластерной | больше лучше | Эмбеддинги событий |
+
+**Как реализовать**: эмбедить текст каждого события (sentence-transformers или OpenAI embeddings), затем sklearn.metrics для расчёта.
+
+### Нарративная когерентность
+
+Из статьи [Narrative Trails (Text2Story 2025)](https://arxiv.org/html/2503.15681v1):
+
+| Метрика                | Что измеряет                                                                                                             |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| **Minimum Coherence**  | Самое слабое звено в линии — минимальная похожесть между соседними событиями                                             |
+| **Reliability**        | Геометрическое среднее когерентности по последовательным событиям в линии                                                |
+| **Coherence function** | `θ(u,v) = sqrt(S(z_u, z_v) · T(ẑ_u, ẑ_v))` — комбинация угловой похожести эмбеддингов и топик-похожести (Jensen-Shannon) |
+| **nDTW**               | Dynamic Time Warping между извлечённой и референсной линией, нормализованный по длине пути                               |
+| **DTW Similarity**     | Средняя cosine similarity вдоль выравнивания DTW                                                                         |
+|                        |                                                                                                                          |
+
+**Применимость**: coherence и reliability можно считать без разметки. DTW-метрики нужны для сравнения с эталоном.
+
+### LLM-as-a-Judge
+
+Из статьи [LLM-as-a-Judge for Narrative Coherence (Electronics, 2025)](https://www.mdpi.com/2079-9292/14/13/2735):
+
+- LLM-судья достигает **корреляции Пирсона ~0.65** с математическими метриками когерентности
+- **Надёжность между прогонами ICC > 0.92** — очень стабильно
+- Простые промпты работают почти так же хорошо, как сложные (90%+ от сложных подходов)
+- Дёшево, не нужна разметка, даёт "человекоподобную" оценку
+
+### Метрики из NLP-литературы по оценке нарративов
+
+Из обзора [What Makes a Good Story and How Can We Measure It? (2024)](https://arxiv.org/html/2408.14622v1):
+
+| Метрика | Что делает |
+|---------|-----------|
+| **CTRLEval** | Text infilling для оценки cohesion, consistency, relevance. Без эталона |
+| **COHESENTIA** | Предложение за предложением оценивает локальную и глобальную связность |
+| **BARTScore** | Вероятности токенов BART для оценки когерентности |
+| **G-EVAL** | LLM-промпт с пошаговым рассуждением, гибкие измерения |
+| **Perplexity** | Низкая perplexity конкатенированных событий линии = хорошая связность |
+| **Distinct-n** | Доля уникальных n-грамм — детектор слишком похожих линий |
+
+---
+
+## Метрики с золотым стандартом (external validation)
+
+Нужна экспертная разметка хотя бы для одного шоу (события → эталонные линии).
+
+| Метрика | Что измеряет | Преимущество над ARI |
+|---------|-------------|---------------------|
+| **NMI (Normalized Mutual Information)** | Взаимная информация между предсказанием и эталоном, [0, 1] | Робастнее для кластеров разного размера |
+| **AMI (Adjusted Mutual Information)** | NMI с поправкой на случайность | Строже NMI |
+| **V-measure** | Гармоническое среднее homogeneity и completeness | Раскладывается: видно, проблема в пере-дроблении или недо-дроблении |
+| **B-cubed F1** | Precision/recall на уровне каждого события | Стандарт в coreference resolution (похожая задача) |
+| **F1 macro** | Средний F1 по линиям | Используется в SemEval-2025 Task 10 |
+| **BERTScore F1** | Семантическая похожесть сгенерированных описаний с эталонными | Для оценки описаний линий (name, goal, etc.) |
+
+---
+
+## Смежные бенчмарки
+
+| Название                               | Год  | Что оценивает                                                                                    |
+| -------------------------------------- | ---- | ------------------------------------------------------------------------------------------------ |
+| **SemEval-2025 Task 10**               | 2025 | Извлечение нарративов из новостей. F1 macro + BERTScore                                          |
+| **SeriesBench (CVPR 2025)**            | 2025 | Понимание сериалов — 28 задач по 105 сериалам                                                    |
+| **NarraBench**                         | 2025 | Таксономия 50 аспектов нарратива. Только 27% задач покрыто существующими бенчмарками             |
+| **Topic Detection and Tracking (TDT)** | NIST | Классика: miss rate, false alarm rate. Концептуально близко (новости → топики ≈ события → линии) |
+
+---
+
+## Стабильность LLM между прогонами
+
+Исследования 2024-2025 подтверждают:
+- Разброс точности до **10% между идентичными прогонами** даже с temperature=0
+- Агрегация по **3-5 прогонам** резко повышает стабильность
+- Наш ARI-подход — валидный, литература поддерживает измерение inter-run agreement как первоклассную метрику
+
+---
+
+## Практические рекомендации
+
+### Быстро добавить (без разметки, без больших затрат)
+
+1. **Silhouette Score** — эмбеддинги событий + sklearn. Объективная метрика качества кластеризации.
+2. **Within-storyline coherence** — средняя попарная похожесть событий одной линии.
+3. **Storyline separation** — средняя между-линейная похожесть (ниже = лучше, линии разные).
+4. **LLM-as-judge** — промпт для оценки каждой линии по рубрике.
+
+### Средний горизонт (нужна одна экспертная разметка)
+
+5. **V-measure** — вместо ARI, диагностирует тип ошибки.
+6. **B-cubed F1** — стандарт для coreference-подобных задач.
+7. **NMI** — робастнее ARI для неравных линий.
+
+### Долгосрочно (инфраструктура)
+
+8. **Narrative coherence из Narrative Trails** — нужны хорошие эмбеддинги + реализация.
+9. **Multi-run aggregation** — прогон 3-5 раз, усреднение.
+10. **SeriesBench-подобный бенчмарк** — золотая разметка для нескольких шоу разных типов.
+
+---
+
+## Источники
+
+- Balestri & Pescatore, ICAART 2025 — [arxiv.org/html/2503.04817v1](https://arxiv.org/html/2503.04817v1)
+- Narrative Trails, Text2Story 2025 — [arxiv.org/html/2503.15681v1](https://arxiv.org/html/2503.15681v1)
+- LLM-as-a-Judge for Narrative Coherence, 2025 — [mdpi.com/2079-9292/14/13/2735](https://www.mdpi.com/2079-9292/14/13/2735)
+- What Makes a Good Story, 2024 — [arxiv.org/html/2408.14622v1](https://arxiv.org/html/2408.14622v1)
+- NarraBench, 2025 — [arxiv.org/html/2510.09869v3](https://arxiv.org/html/2510.09869v3)
+- SemEval-2025 Task 10 — [propaganda.math.unipd.it/semeval2025task10](https://propaganda.math.unipd.it/semeval2025task10/)
+- SeriesBench, CVPR 2025 — [arxiv.org/abs/2504.21435](https://arxiv.org/abs/2504.21435)
+- LLM Stability, 2024 — [arxiv.org/html/2408.04667v2](https://arxiv.org/html/2408.04667v2)
+- Scikit-learn Clustering — [scikit-learn.org/stable/modules/clustering.html](https://scikit-learn.org/stable/modules/clustering.html)
diff --git a/docs/knowledge/archive/plans/next-session-plan.md b/docs/knowledge/archive/plans/next-session-plan.md
new file mode 100644
index 0000000..43e6c63
--- /dev/null
+++ b/docs/knowledge/archive/plans/next-session-plan.md
@@ -0,0 +1,67 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# Что доделать (после сессии 2026-03-26/27)
+
+## Не закончено
+
+### 1. Theme-led не работает на Mad Men
+MM прогон показал: 6 plotlines, все character-led, ни одной институциональной.
+Две причины:
+- **Синопсисы** — synopses_writer пишет через character lens, рекламные кейсы = фон
+- **Промпт Pass 1** — нет примера theme-led plotline в JSON output, правило «when in doubt don't create» давит
+
+Нужно:
+- [ ] Поправить промпт synopses_writer — явно просить описывать институциональную/рабочую динамику, не только персональные конфликты
+- [ ] Добавить theme-led пример в JSON output секции pass1.md
+- [ ] Перегенерировать синопсисы MM
+- [ ] Прогнать заново, сравнить
+
+### 2. Протестировать на других шоу
+- [ ] CSI S01 — procedural, ожидаем case_of_the_week + «Lab Politics»
+- [ ] Slow Horses S01 — нужны синопсисы (write-synopses теперь работает с Wikipedia search)
+- [ ] Ablation testing — откатывать изменения по одному, смотреть что ломается
+
+### 3. write-synopses рефакторинг
+- [ ] Заменить Wikipedia-парсер на LLM с web search (или по памяти)
+- [ ] Нужен search tool в call_llm (tool use loop) или callback search_fn
+- [ ] Пока что — Wikipedia search API работает (починили), но парсер ломается на нестандартных страницах
+
+### 4. Два измерения функций (будущее)
+Записано в `3-resources/tvplotlines/two-function-dimensions.md`.
+- Pass 2: episode function (Dan Harmon circle или simplified)
+- Pass 3: arc function (plot_fn) — роль в сезонной арке
+- Сейчас убрали из Pass 3, нужно вернуть когда будет ясна модель
+
+### 5. Pass 3: reviewed_rank
+Решили что Pass 3 просто ставит свои ранки, код сравнивает. Но механизм не реализован:
+- [ ] Формат вывода Pass 3 — добавить поле ranks в JSON ответ
+- [ ] Код pass3.py — парсить ranks, записывать в reviewed_rank
+- [ ] Сравнение computed_rank vs reviewed_rank в pipeline
+
+### 6. formulas.md
+- [ ] Добавить design rationale / цитаты из книг ко всем формулам
+- [ ] Обновить после всех изменений (rank, ensemble, patches removed)
+
+### 7. Chain-of-thought
+- [ ] Исследовать эффект на качество (все пассы)
+- [ ] Может просить LLM рассуждать в отдельном поле перед ответом
+
+## Закончено в этой сессии
+- ✅ --stop-after / --resume-from / --output-dir в CLI
+- ✅ Rank refactor (computed_rank + reviewed_rank)
+- ✅ Ensemble как формат (убран is_ensemble)
+- ✅ Limited убран
+- ✅ Patches убраны
+- ✅ PROMOTE/DEMOTE убраны
+- ✅ Shared glossary
+- ✅ Theme-led правки в glossary и pass1
+- ✅ Wikipedia search fix
+- ✅ docs/formulas.md
+- ✅ Rank experiment + скрипт
+- ✅ Pass 2: функции episode-scoped
+- ✅ Chain-of-thought nudge во всех промптах
+- ✅ Changelog
diff --git a/docs/knowledge/archive/plans/notes-for-3rd-autoresearch.md b/docs/knowledge/archive/plans/notes-for-3rd-autoresearch.md
new file mode 100644
index 0000000..435392e
--- /dev/null
+++ b/docs/knowledge/archive/plans/notes-for-3rd-autoresearch.md
@@ -0,0 +1,76 @@
+# Замечания к промптам 
+## PASS 0 
+1. check if pass0 is nessesary or it works as good when this infor we get at first stage of pass1 - it seems by our experiments it might be, it saves us money on tokens (again it seems)
+2. see if Franchise type definitions that we have in glossary work better to differentiate between procedural and hybrid 
+3.  If each episode has its own focal character — ensemble. - this we have in pass0 which is not a correct statement and  definition in glossary is more accurate - need to replace 
+4. > [Hero] [transformation], testing how far they'll go for [goal] эта формулировка с testing несколько ограничивает передачу сути нудно найти точнее 
+5.   "season": 1, а откуда сейчас ьеертся номер сезона?
+6. - `format`: enum — `"ongoing"` | `"limited"` | `"anthology"` | null (if unclear) не вижу нигде объяснения в промпте для этого поля, но в глоссари кажется оно есть 
+7. After validation, the result is shown to the human for confirmation or editing. - это не так, зачем это написано в промпте?
+8. Я посмотрела что используется в контракте на входе в Пасс 1 и не вижу где используются все поля которые мы собираем на Пасс 0 - есть такое ощущение что мы из собираем а потом нигде не используем - зачем тогда собираем?
+
+## PASS 1
+1. **Input**: Pass 0 output (`show`, `season`, `franchise_type`, `story_engine`) + all season synopses а ниже : ## Input
+- **show**: show title (from Pass 0)
+- **season**: season number (from Pass 0)
+- **franchise_type**: procedural / serial / hybrid / ensemble (from Pass 0)
+- **story_engine**: one sentence (from Pass 0)
+- **format**: ongoing / limited / anthology / null (from Pass 0)
+- **synopses**: all season synopses (text) Зачем дважды и при этом еще по разному определяется что на входе?
+1. If `prior_season` is present in the input, it contains cast and storylines from the previous season. - откуда вдруг берется это поле? И весь этот пункт про предыдущий сезон - это мы добавили уже после калибровки, проверяли на берйкин бед впроде качество извлечения линий не изменилось но мне кажется сейчас тут не оч понятно : это вот что и где берется `prior_season.plotlines`, **TRANSFORMED** — same driver, but goal fundamentally changed. Keep the `id`, rewrite Story DNA. - это я не уверена вообще что из какой-то теории или в реальности так бывает. **ENDED** — the storyline resolved or disappeared. - это что у нее пометка или ты помечаешь? но что ты помечаешь если ее нет?
+2. Так оптимально добавлено то что сказано выше еще раз но в TAsk?
+3. ### Storyline = Story DNA A storyline = hero + goal + obstacle + stakes. Missing any component — not a storyline, but an event within another storyline. - не ясно если это едиственно место где мы используем Story DNA то нужно вообще тогда этот термин выбросить или же дать ему определение как у нас в словаре и использовать тогда везде как шортхэнд. 
+4. В словаер еще отлично обхясняется связь между франщизой мотором и дна. если это полезно нужно включать в промпт 
+5. Additionally: a storyline has a three-act structure, conflict, and a causal chain of events. это плохое объяснение мне кажется нужно про арку писать чтобы подвести к функциям в Пасс 2. Это и словаре сейчас слабо 
+6. Мне кажется что в словаре лучше дано определение storyline 
+7. Если мы все меняем я бы протестировала и замеенила если не испорти везде storyline на plotline - это более точные термин и у нас в названии есть 
+8. Типы episodic это какое-то сочинение ЛЛМ такого нет в ощепринятх делениях нужно понять чему это помогает и кажется в словаре мы нашли решение. 
+9. нужно давать точное название линии в которой будут все case of the week чтобы сразу было понятно а то она сейчас называется содержательно например у house - investigation вообще не ясно о чем 
+10. **A** — protagonist's storyline or franchise engine, most screen time, plot-led conflict. хочу убедиться что где-то утверждается что линия а однощначно и всегда плот-лед и где вообзе объясняется что это такое в промпте? плот или карактер лед? в словаре однако у нас есть но я хочу убедиться что это уточнение нужно и правильное и мы испольущем 
+11. - **runner** — incomplete Story DNA, no obstacle/resolution отпять же если можно обойти без Story DNA обойтись
+12. нужно синхронихировать glossary с промптами и хочется глоссари сделать граунд труз если авторесеч проверит что не ухудшится качество извлечения 
+13. а вот определение **Plot-led** — external goal vs antagonist.- **Character-led** — internal conflict, protagonist = their own antagonist. во первых сначала "вызывается функция" а потом определяется во вторых в глоссари точнее в третьих хочу понять где взялось и зачем собираем 
+14. Seed and wraparound — not storyline types это вообще убрать опять какие то термины не опеределенные используются и смысла нет в этом конктрейне 
+15.  Test: if you can't write a logline (hero + goal + obstacle)  у тебя есть строи дна там 4 части почему здесь их только три? 
+16. What is NOT a storyline плозие примеры кроме "John and Mike's friendship" и "Investigation" (procedural, ep.5)
+17. Story DNA is reconstructed from the aggregate of mentions across the season. Don't invent — mark confidence. вообще не поняла что за инструкция?
+18. Episodic storyline (franchise engine): по прежнему не нравится термин Episodic storyline - вот это все кажется не выполняется - проверить на сериях по которым есть результаты
+19. вот же объяснение как называть и вроде операциональное зачем два предыдущих абзаца? Always use `Driver: Theme` format for storyline names (e.g. "House: Authority", "Cameron: Ethics", "Jon: Honor"). This makes it clear who drives each storyline and prevents confusion during event assignment.
+20. Narrative devices - не уверена вообще что это нужно не уверена что полный список не понятно как будет использоваться после ... нужно понять нужно ли это собирать и назначать 
+21. про формат тоже не понимаю зачем чему помогает франшизы достаточно 
+22. про уверенность кстати я вообще не оняла где объясняется что за уверенность и как работает вообще в примере стоит драматик айрони про линии ББ меня слильно смушает я бы убрала эти деввайсы 
+23. see naming convention) при этом раздел называтеся нейминг 
+24. `obstacle`: string  `stakes`: string почему не лист интересно 
+25. Language of `goal`, `obstacle`, `stakes` fields — in the language of the synopsis. я бы это подчеркнула еще раньще а не в конце вот это стоит сформулировать дважды 
+26. - For procedural/hybrid: exactly one storyline with `type: "episodic"` ну вот название не нравится 
+27. If code detects an error — re-request from LLM with specific indication of what's wrong. как это сейчас выглядит?
+
+## PASS 2
+
+1.  **Self-contained document.** Compiled from `storyline-extraction-reference.md`, but fed to the LLM as-is. When reference is updated — recompile. это нужно в промпте? если мы относимся к промпт как к программе то зачем тут это например?
+2. **Input**: Pass 1 output (`show`, `season`, `cast`, `storylines`)  - шоу в смысле title? season в смысле номер? 
+3. опять же я не пойму в раздле контракт одно напино а потом инпут и другое 
+4.  Two actions by different characters = two events. это не очевидно из первого определения? не понимаю зачем здесь 
+5.  Step 3: Identify interactions between storylines а потом Assignment rules - мне кажется про разное я вообще не уверена чот это нужно Step 3: Identify interactions between storylines но мы нашли способ даже это как-то показывать вроде в аналитике - короче вопрос ро взаимодействие линий нужено понять но правила тут все не про взаимодействия а стояь после 
+6. вот функции это то что мы переделываем это мы нахватали в список что попало а сейчас нашли более принятые функции и хотим добавить их описав поточнее и там есть еще констрейны и особенности по нима какие после каких не могу быть какие могут повторяться 
+7. и мы та и не решеили все ли ивент имеют функцию - должны иметь все но бывает всякое 
+8. опять девайсы они уже были в предыдущем пас не помню объяснялись и эти же ли нужно убедиться что одинаковые понять зачем и там и там и вообще оставлять ли их где они нужны на чот влиятют 
+9. опять раздел про взаимодействие - опять мне не понятно почему опять раздел и вообще зачем это взаимодетсви 
+10. **Emotional counterpoint**: if all storylines are rising or all falling — something is missed or functions are wrong вообще не поняла чего?
+11. Weight (`primary` / `background` / `glimpse`) is computed by code from event counts — do NOT include in JSON. это вообще гле взялосб? оперделений не было я помню было оюъяснение чем отличается от А Б С но не уверена что поняли и вот это нужно тут 
+12. patches вижу в коде не понимаю что делают 
+13. **summary.interactions[].**: что это где испольщуется
+14. **summary.patches[].**: что это где используется 
+15. If code detects an error — re-request from LLM with specific indication of what's wrong. какое правило вызова? 
+16. опять Patches to Pass 1 - функцию сначала заявили потом описали - плохой подход
+17. вообще если относиться к промптам как к программах то выглядит бледно стыдно такое показывать 
+
+## PASS 3
+1.  При обновлении — пересобрать из ADR-005 и reference. это все вообще актуально? должно быть в промте который идет в библиотеку?
+2. но без возможности исправить список линий - точнее изменить потому что патчи то он делает 
+3. plotlines тут вдруг уже плотлайнс а было до этого вроде сторилайнс 
+4. > "Story DNA has four parts: Hero, Goal, Obstacle, Stakes." — Nash, p.34 зачем читаты и страницы в промпте 
+5. **Но сериалы бывают плохо написаны.** Линия может существовать в сериале без чёткой цели, с номинальным конфликтом, или быть заброшенной на полпути. Это не значит, что её нет — это значит, что она слабая. **Не выбрасывай такие линии — помечай через confidence:** это вообще ужасный текст в промпте №для всех"
+6. Для каждой линии посмотри на function событий через весь сезон.  это вообще что сказано? я переключилась случайно на русскую версию но в целом даже по англйиски это что?
+7. "In a multi-stranded narrative, each strand usually has its own dramatic three-act structure." — Oberg, p.60 опять цитата и страница 
+8. короче даже дочитывать не хочу - все претенации не последовательно не системно не основано на теории избыточно неточно вообще не соотсветсует заявлением что мы делаем "программу" для ЛЛМ 
\ No newline at end of file
diff --git a/docs/knowledge/archive/plans/one-page.md b/docs/knowledge/archive/plans/one-page.md
new file mode 100644
index 0000000..22d3c20
--- /dev/null
+++ b/docs/knowledge/archive/plans/one-page.md
@@ -0,0 +1,67 @@
+---
+type: draft
+project: tvplotlines
+status: active
+date_read: 2026-03-20
+---
+
+# What it is
+A Python library that extracts key plotlines from TV episode synopses.
+
+# Why it exists
+
+"To PLOT means to navigate through the dangerous terrain of story and when confronted by a dozen branching possibilities to choose the correct path. Plot is the writer's choice of events and their design in time." (p. 26) McKee
+
+plot is an accurate term that names the internally consistent, interrelated pattern of events that move through time to shape and design a story." McKee
+
+In a story, the storyline encompasses the characters, setting, and the conflict they face. Complex works of fiction feature two or more distinct plots (A-story, B-story) that may run independently or eventually intersect at the climax. 
+
+**plotlines** specifically ==focus on the **causal mechanics**—the "why" and "how" behind a story’s events==. A plotline is the logical thread that connects actions to their consequences, whereas a storyline is often seen as the chronological summary of what happens.
+
+- **Story**: "The king died and then the queen died." (A simple chronological sequence).
+- **Plot**: "The king died, and then the queen died **of grief**." (Adds causality and emotional weight).
+In longer works like novels or TV series, authors often weave multiple plotlines together: 
+
+- **Master Plotline**: The overarching primary conflict of the work.
+- **Subplotlines**: Secondary threads that support the main plot or develop side characters.
+- **Internal Plotlines (Character Arcs)**: The emotional or psychological journey and transformation of a character.
+- **External Plotlines**: The physical events, such as battles, quests, or investigations.
+
+
+A TV series is a transformation machine. It's an elaborate Rube Goldberg device designed to test the same character flaw over and over and over.
+
+if someone asks, "What's Season 1 ?" you'll have an exciting answer full of twists and turns and OMG moments. You'll have enough story that they'll lean forward and go, "Mmmm-hmmm, that is good. I think you've got something."
+
+the quickest way to lose your series' audience is to slow-burn the season-long story, not providing the necessary stake-raisers, plot twists, and emotional turning points that viewers crave.
+
+# What it does
+
+tvplotlines takes plain-text episode synopses (300–500 words each) and returns a JSON breakdown of the season's plotlines.
+
+Each plotline gets four fields — driver, goal, obstacle, stakes — following Jamie Nash's *Save the Cat! Writes for TV* (2018). Plotlines are ranked A, B, or C by narrative weight.
+
+Every event in every episode is assigned to a plotline with a narrative function: setup, escalation, turning point, climax, resolution, or cliffhanger. The output also includes show structure (procedural, serial, hybrid, or ensemble), episode themes, and interactions between plotlines — convergence, dramatic irony, thematic echoes.
+
+# How it works
+
+The LLM interprets narrative; code enforces structure.
+
+Four LLM passes, each feeding the next:
+
+1. **Detect show structure.** Procedural? Serial? Ensemble? This determines what counts as a plotline.
+2. **Extract plotlines.** The LLM reads all synopses and identifies season-level arcs. Three independent extractions run in parallel; the system takes the majority answer.
+3. **Break down each episode.** Assign every event to a plotline. Flag anything that does not fit.
+4. **Review the full picture.** A final pass catches problems: plotlines that should merge, ranks that do not match screen time, threads that emerge late.
+
+Between passes, code validates output, computes plotline span and weight, reassigns orphan events, and applies the final pass's decisions — merge, split, promote, demote — mechanically.
+
+# How to view results
+
+The output is JSON. Any tool that reads JSON can display it. A companion viewer app is available at [link].
+
+# Who is it for
+
+- **Development executives** — structured season overview without reading full scripts
+- **Writers' rooms** — map how plotlines weave, collide, and echo across episodes
+- **Story analysts** — a structured first pass before deep coverage
+- **Tool builders** — tvplotlines is a library, not a closed product; plug it into your own pipeline
diff --git a/docs/knowledge/archive/plans/open-source-release-checklist.md b/docs/knowledge/archive/plans/open-source-release-checklist.md
new file mode 100644
index 0000000..78f3d19
--- /dev/null
+++ b/docs/knowledge/archive/plans/open-source-release-checklist.md
@@ -0,0 +1,65 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# Open-source release checklist
+
+## Code quality
+
+- [x] Тесты проходят (`pytest`) — 77 passed, 1 skipped
+- [x] Нет hardcoded путей, API ключей, персональных данных в коде
+- [x] Нет TODO/FIXME которые блокируют релиз
+- [x] `.env` в `.gitignore`
+- [x] `CLAUDE.md` в `.gitignore` (внутренние инструкции, не для публики)
+
+## Документация
+
+- [x] README: установка, quickstart (CLI + Python), пример вывода, описание pipeline
+- [x] README: примеры кода соответствуют реальному API (имена полей, типы аргументов)
+- [x] docs/quickstart.md — рабочий пример
+- [x] docs/api.md — все параметры `get_plotlines()`, все поля моделей
+- [x] examples/run_pipeline.py — рабочий пример
+- [x] CHANGELOG.md — v0.1.0
+- [x] examples/synopses/ — BB S01 + GoT S01
+- [x] examples/results/ — результаты прогона
+
+## Packaging
+
+- [x] pyproject.toml: name, version, description, authors (с email), license, keywords, classifiers
+- [x] pyproject.toml: dependencies полные (anthropic, openai, scikit-learn)
+- [x] pyproject.toml: CLI entry point (`tvplotlines = "tvplotlines.cli:main"`)
+- [ ] `pip install -e .` работает — нужно проверить вручную в чистом venv
+- [x] `tvplotlines --help` работает
+
+## Legal / metadata
+
+- [x] LICENSE файл (MIT)
+- [x] Copyright owner корректный (BirdInTheTree)
+- [x] Нет чужого кода без атрибуции
+- [x] Синопсисы — собственные пересказы, fair use
+
+## Git
+
+- [x] `.gitignore` покрывает: .env, __pycache__, .DS_Store, CLAUDE.md
+- [x] Нет секретов в git истории
+- [x] Ветка main — основная
+- [x] Удалить старые ветки (autoresearch/*, feature/*, claude/*) перед публикацией
+
+## CI/CD
+
+- [x] GitHub Actions: тесты на push/PR (Python 3.11, 3.12, 3.13)
+- [x] Badge в README: PyPI, License, Python versions
+
+## Перед `git push` в публичный репо
+
+- [ ] Перечитать README глазами нового пользователя
+- [x] `pip install -e .` в чистом venv
+- [ ] Убедиться что репо на GitHub — public (или переключить)
+- [x] Удалить старые ветки
+
+## После публикации
+
+- [ ] `pip install tvplotlines` из PyPI
+- [ ] Проверить что badges в README показывают правильную информацию
diff --git a/docs/knowledge/archive/plans/open-source-strategy.md b/docs/knowledge/archive/plans/open-source-strategy.md
new file mode 100644
index 0000000..f9ef5ff
--- /dev/null
+++ b/docs/knowledge/archive/plans/open-source-strategy.md
@@ -0,0 +1,48 @@
+---
+type: spec
+project: tvplotlines
+status: active
+---
+
+# Open Source стратегия
+
+## Главный принцип: библиотека vs приложение
+
+```
+Библиотека (open source)          Приложение (не open source)
+─────────────────────────         ─────────────────────────
+get_plotlines() → результат       БД + интерфейс + редактирование
+чистое вычисление                 хранение, показ, работа с данными
+pip install tvplotlines               твой продукт
+```
+
+Аналогия: калькулятор бесплатный, Excel платный.
+
+## Что открываем, что нет
+
+| Слой | Open source? | Почему |
+|---|---|---|
+| Библиотека `get_plotlines` | Да, MIT | Вычислительное ядро, привлекает пользователей и контрибьюторов |
+| База знаний (how2pitch) | Да, как датасет | Люди могут добавлять книги, переводы, карточки |
+| Приложение (БД + UI + редактирование) | Нет | Коммерческая ценность, продукт автора |
+| books2series | Нет (пока) | Главное конкурентное преимущество |
+
+## Кому нужна библиотека
+
+- **Исследователи** (computational narratology) — вызвать из Jupyter на своём корпусе
+- **Разработчики** — встроить в свои инструменты для сценаристов
+- **Студии** — интегрировать во внутренний пайплайн
+
+## Что нужно для выпуска
+
+1. Написать ядро с нуля (не форк mas4bw, новая реализация на основе книг)
+2. Оформить как Python-пакет с чистым API
+3. README с примерами использования
+4. Опубликовать на PyPI + GitHub
+5. Лицензия: MIT
+
+## Открытые вопросы
+
+- Готовность поддерживать пакет (issues, PR, документация) — отдельная работа
+- Если не готова — выложить на GitHub с MIT без обещания поддержки
+- Какой Reddit: r/screenwriting (~1M), r/LanguageTechnology, r/MachineLearning
diff --git a/docs/knowledge/archive/plans/plan-restructure.md b/docs/knowledge/archive/plans/plan-restructure.md
new file mode 100644
index 0000000..b103db9
--- /dev/null
+++ b/docs/knowledge/archive/plans/plan-restructure.md
@@ -0,0 +1,479 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# Project Restructuring Plan
+
+> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Restructure tvplotlines, tvplotlines-app, and knowledge repos to follow industry conventions for open-source Python libraries.
+
+**Architecture:** Three repos with clear boundaries: tvplotlines (public library — code + user-facing docs), tvplotlines-app (private app — code + test data), knowledge (private — all research, notes, specs, experiments). Internal specs and research currently mixed into tvplotlines/docs/ and tvplotlines-app/research/ move to knowledge.
+
+**Principles:**
+- Public repo = what a user cloning from PyPI needs (code, tests, examples, user docs)
+- App repo = what you need to run the app (code, tests, fixtures, synopses)
+- Knowledge repo = everything else (specs, ADRs, research, experiments, book quotes, notes)
+
+---
+
+## Chunk 1: Clean up tvplotlines (library)
+
+### Task 1: Remove empty directories
+
+**Files:**
+- Delete: `md/` (empty, only .DS_Store)
+- Delete: `references/` (empty, only .DS_Store)
+
+- [ ] **Step 1: Remove empty dirs**
+
+```bash
+rm -rf md/ references/
+```
+
+- [ ] **Step 2: Remove broken symlink**
+
+`docs/storyline-extraction-reference.md` — symlink to old path, target no longer exists.
+
+```bash
+rm -f docs/storyline-extraction-reference.md
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add -A md/ references/ docs/storyline-extraction-reference.md
+git commit -m "Remove empty directories and broken symlink"
+```
+
+---
+
+### Task 2: Move architecture.md to knowledge
+
+`docs/architecture.md` is an internal spec — describes pipeline internals, data structures, prompt strategy. A library user doesn't need this; they need a quickstart and API reference. This belongs in knowledge.
+
+**Files:**
+- Move: `docs/architecture.md` → `knowledge/specs/architecture.md`
+
+- [ ] **Step 1: Create specs/ in knowledge and move**
+
+```bash
+mkdir -p /Users/nvashko/Projects/3-resources/knowledge/specs
+mv docs/architecture.md /Users/nvashko/Projects/3-resources/knowledge/specs/architecture.md
+```
+
+- [ ] **Step 2: Commit in tvplotlines**
+
+```bash
+git add docs/architecture.md
+git commit -m "Move internal architecture spec to knowledge repo"
+```
+
+- [ ] **Step 3: Commit in knowledge**
+
+```bash
+cd /Users/nvashko/Projects/3-resources/knowledge
+git add specs/architecture.md
+git commit -m "Add tvplotlines architecture spec (moved from tvplotlines/docs/)"
+```
+
+---
+
+### Task 3: Create proper docs/ for public library
+
+Industry standard for Python libraries: `docs/` contains user-facing documentation built with MkDocs or Sphinx. For now, create stubs that can grow.
+
+**Files:**
+- Create: `docs/index.md` (landing page)
+- Create: `docs/quickstart.md` (getting started)
+- Create: `docs/api.md` (API reference stub)
+
+- [ ] **Step 1: Create docs/index.md**
+
+```markdown
+# tvplotlines
+
+Automatic storyline extraction from TV series synopses.
+
+## What it does
+
+Feed episode synopses → get structured storylines, character arcs, and per-episode event breakdowns.
+
+## Quick links
+
+- [Quickstart](quickstart.md) — get running in 5 minutes
+- [API Reference](api.md) — function signatures and data models
+```
+
+- [ ] **Step 2: Create docs/quickstart.md**
+
+```markdown
+# Quickstart
+
+## Install
+
+\`\`\`bash
+pip install tvplotlines
+\`\`\`
+
+## Basic usage
+
+\`\`\`python
+from tvplotlines import get_plotlines
+
+result = get_plotlines(
+    show="Breaking Bad",
+    season=1,
+    episodes=["Synopsis of S01E01...", "Synopsis of S01E02...", ...],
+)
+
+for storyline in result.plotlines:
+    print(f"{storyline.rank} | {storyline.name} ({storyline.driver})")
+\`\`\`
+
+## Configuration
+
+\`\`\`python
+result = get_plotlines(
+    show="Breaking Bad",
+    season=1,
+    episodes=synopses,
+    llm_provider="openai",       # or "anthropic" (default)
+    pass2_mode="batch",          # "parallel" | "batch" | "sequential"
+)
+\`\`\`
+
+See [API Reference](api.md) for all options.
+```
+
+- [ ] **Step 3: Create docs/api.md stub**
+
+```markdown
+# API Reference
+
+## get_plotlines()
+
+Main entry point. Extracts storylines from a season of TV synopses.
+
+*Full reference will be auto-generated from docstrings.*
+```
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add docs/
+git commit -m "Add user-facing documentation stubs (quickstart, API reference)"
+```
+
+---
+
+## Chunk 2: Clean up tvplotlines-app
+
+### Task 4: Remove empty directories from tvplotlines-app
+
+**Files:**
+- Delete: `png/` (empty)
+
+- [ ] **Step 1: Remove**
+
+```bash
+cd /Users/nvashko/Projects/1-projects/tvplotlines-app
+rm -rf png/
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add -A png/
+git commit -m "Remove empty png/ directory"
+```
+
+---
+
+### Task 5: Move ADRs from tvplotlines-app to knowledge
+
+Architecture Decision Records are project-level knowledge, not app code. They document why decisions were made — useful across both tvplotlines and tvplotlines-app.
+
+**Files:**
+- Move: `research/decisions/` (5 ADR files) → `knowledge/decisions/`
+
+- [ ] **Step 1: Move**
+
+```bash
+mv research/decisions/ /Users/nvashko/Projects/3-resources/knowledge/decisions/
+```
+
+- [ ] **Step 2: Commit in tvplotlines-app**
+
+```bash
+git add research/decisions/
+git commit -m "Move ADRs to knowledge repo"
+```
+
+- [ ] **Step 3: Commit in knowledge**
+
+```bash
+cd /Users/nvashko/Projects/3-resources/knowledge
+git add decisions/
+git commit -m "Add Architecture Decision Records (moved from tvplotlines-app)"
+```
+
+---
+
+### Task 6: Move research notes and references to knowledge
+
+Strategy docs, audit, book quotes, design docs, notes — all knowledge, not app code.
+
+**Files to move:**
+- `research/inventory.md` → `knowledge/specs/inventory.md`
+- `research/open-source-strategy.md` → `knowledge/specs/open-source-strategy.md`
+- `research/mas4bw-library-audit.md` → `knowledge/specs/mas4bw-library-audit.md`
+- `research/metrics-survey.md` → `knowledge/specs/metrics-survey.md`
+- `research/synopsis-authoring-protocol.md` → `knowledge/specs/synopsis-authoring-protocol.md`
+- `research/CONTEXT.md` → `knowledge/specs/tvplotlines-app-context.md`
+- `research/notes/` → `knowledge/notes/tvplotlines-app/`
+- `research/references/` → `knowledge/references/`
+
+- [ ] **Step 1: Create target dirs and move**
+
+```bash
+mkdir -p /Users/nvashko/Projects/3-resources/knowledge/specs
+mkdir -p /Users/nvashko/Projects/3-resources/knowledge/notes/tvplotlines-app
+mkdir -p /Users/nvashko/Projects/3-resources/knowledge/references
+
+# Strategy/audit docs
+mv research/inventory.md /Users/nvashko/Projects/3-resources/knowledge/specs/
+mv research/open-source-strategy.md /Users/nvashko/Projects/3-resources/knowledge/specs/
+mv research/mas4bw-library-audit.md /Users/nvashko/Projects/3-resources/knowledge/specs/
+mv research/metrics-survey.md /Users/nvashko/Projects/3-resources/knowledge/specs/
+mv research/synopsis-authoring-protocol.md /Users/nvashko/Projects/3-resources/knowledge/specs/
+mv research/CONTEXT.md /Users/nvashko/Projects/3-resources/knowledge/specs/tvplotlines-app-context.md
+
+# Notes
+mv research/notes/* /Users/nvashko/Projects/3-resources/knowledge/notes/tvplotlines-app/
+rmdir research/notes/
+
+# References (book quotes, design docs)
+mv research/references/* /Users/nvashko/Projects/3-resources/knowledge/references/
+rmdir research/references/
+```
+
+- [ ] **Step 2: Commit in tvplotlines-app**
+
+```bash
+git add research/inventory.md research/open-source-strategy.md research/mas4bw-library-audit.md research/metrics-survey.md research/synopsis-authoring-protocol.md research/CONTEXT.md research/notes/ research/references/
+git commit -m "Move research notes, references, and strategy docs to knowledge repo"
+```
+
+- [ ] **Step 3: Commit in knowledge**
+
+```bash
+cd /Users/nvashko/Projects/3-resources/knowledge
+git add specs/ notes/tvplotlines-app/ references/
+git commit -m "Add tvplotlines-app specs, notes, and references"
+```
+
+---
+
+### Task 7: Move autoresearch experiments to knowledge
+
+Experiment logs, results TSVs, program descriptions — research, not app code.
+
+**Files:**
+- Move: `research/autoresearch/` → `knowledge/experiments/autoresearch/`
+- Move: `research/breakdowns/` → `knowledge/experiments/breakdowns/`
+
+- [ ] **Step 1: Move**
+
+```bash
+mkdir -p /Users/nvashko/Projects/3-resources/knowledge/experiments
+mv research/autoresearch/ /Users/nvashko/Projects/3-resources/knowledge/experiments/autoresearch/
+mv research/breakdowns/ /Users/nvashko/Projects/3-resources/knowledge/experiments/breakdowns/
+```
+
+- [ ] **Step 2: Commit in tvplotlines-app**
+
+```bash
+git add research/autoresearch/ research/breakdowns/
+git commit -m "Move experiment logs and breakdowns to knowledge repo"
+```
+
+- [ ] **Step 3: Commit in knowledge**
+
+```bash
+cd /Users/nvashko/Projects/3-resources/knowledge
+git add experiments/
+git commit -m "Add autoresearch experiments and episode breakdowns"
+```
+
+---
+
+### Task 8: Reorganize what stays in tvplotlines-app
+
+After moves, `research/` should contain only operational data: synopses (test input), results (test output), scripts (utilities). Rename to make purpose clear.
+
+**Remaining in research/:**
+- `research/synopses/` — test data, stays
+- `research/results/` — pipeline outputs, stays
+- `research/scripts/` — utilities, stays
+- `research/compute_all_metrics.py`, `compute_embedding_metrics.py`, `per_line_diagnostics.py` — utilities, stay
+
+- [ ] **Step 1: Rename research/ → data/**
+
+`research/` implies knowledge. What stays is operational data: inputs and outputs for the pipeline.
+
+```bash
+mv research/ data/
+```
+
+- [ ] **Step 2: Update any imports/references**
+
+Check if scripts reference `research/` paths internally.
+
+```bash
+grep -r "research/" data/scripts/ data/*.py
+```
+
+Fix paths if found.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add -A research/ data/
+git commit -m "Rename research/ to data/ — only operational data remains"
+```
+
+---
+
+## Chunk 3: Update knowledge registry and MOCs
+
+### Task 9: Add new knowledge dirs to build_registry.py
+
+**Files:**
+- Modify: `knowledge/scripts/build_registry.py` — add specs/, decisions/, references/, experiments/ to local dirs scan
+- Modify: `knowledge/CLAUDE.md` — update structure description
+
+- [ ] **Step 1: Update _LOCAL_DIRS in build_registry.py**
+
+Add entries for new local directories:
+
+```python
+_LOCAL_DIRS = {
+    "preprint/sources": ("preprint-sources", "tvplotlines"),
+    "preprint/style": ("preprint-style", "tvplotlines"),
+    "decisions": ("decisions", "tvplotlines"),
+    "specs": ("specs", "tvplotlines"),
+    "references": ("references", "tvplotlines"),
+    "experiments/autoresearch": ("autoresearch", "tvplotlines"),
+    "experiments/breakdowns": ("breakdowns", "tvplotlines"),
+    "notes/tvplotlines-app": ("tvplotlines-app-notes", "tvplotlines-app"),
+}
+```
+
+- [ ] **Step 2: Rebuild registry**
+
+```bash
+python scripts/build_registry.py
+```
+
+- [ ] **Step 3: Update CLAUDE.md with new structure**
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add scripts/build_registry.py registry.yaml CLAUDE.md
+git commit -m "Index new knowledge dirs (specs, decisions, references, experiments)"
+```
+
+---
+
+### Task 10: Update tvplotlines CLAUDE.md
+
+Remove references to `docs/inventory.md`, `docs/open-source-strategy.md`, `docs/mas4bw-library-audit.md` — they've moved to knowledge.
+
+**Files:**
+- Modify: `tvplotlines/CLAUDE.md`
+
+- [ ] **Step 1: Update file references**
+
+Remove lines referencing moved files. Add pointer to knowledge repo.
+
+- [ ] **Step 2: Commit**
+
+```bash
+git commit -m "Update CLAUDE.md — remove references to moved docs"
+```
+
+---
+
+### Task 11: Update todo.md
+
+Mark restructuring tasks complete.
+
+- [ ] **Step 1: Update tasks/todo.md**
+- [ ] **Step 2: Commit**
+
+---
+
+## Target structure after restructuring
+
+### tvplotlines/ (public library)
+```
+tvplotlines/
+├── src/tvplotlines/          # library code + prompts
+├── tests/                # unit tests
+├── examples/             # usage examples
+├── docs/                 # user-facing: quickstart, API ref
+│   ├── index.md
+│   ├── quickstart.md
+│   └── api.md
+├── tasks/                # session tracking (gitignored or untracked)
+├── pyproject.toml
+├── README.md
+├── LICENSE
+├── CLAUDE.md
+└── .gitignore
+```
+
+### tvplotlines-app/ (private application)
+```
+tvplotlines-app/
+├── src/plotter_app/      # app code
+├── tests/                # app tests
+├── data/                 # operational data
+│   ├── synopses/         # test input (250+ episodes)
+│   ├── results/          # pipeline output (20 JSON files)
+│   └── scripts/          # utility scripts
+├── docs/superpowers/     # current feature plans
+├── viz/                  # generated visualizations
+├── pyproject.toml
+└── .gitignore
+```
+
+### knowledge/ (private knowledge base)
+```
+knowledge/
+├── preprint/             # paper-writing materials
+│   ├── sources/          # paper notes (brown, kojima, zhang)
+│   ├── style/            # style analyses (russell, dfw, quine)
+│   └── ...               # drafts, bib, style-guide
+├── specs/                # internal specifications
+│   ├── architecture.md   # pipeline internals
+│   ├── inventory.md      # what's ours vs borrowed
+│   ├── open-source-strategy.md
+│   ├── mas4bw-library-audit.md
+│   └── ...
+├── decisions/            # ADRs (001-005)
+├── references/           # book quotes, design docs
+├── experiments/          # autoresearch, breakdowns
+├── notes/                # misc notes
+├── maps/                 # thematic MOCs
+├── templates/            # YAML frontmatter templates
+├── scripts/              # build_registry.py
+├── _sources/             # symlinks to external projects
+├── registry.yaml         # auto-generated index
+├── setup.sh
+└── CLAUDE.md
+```
diff --git a/docs/knowledge/archive/plans/preprint-citations-map.md b/docs/knowledge/archive/plans/preprint-citations-map.md
new file mode 100644
index 0000000..2205d89
--- /dev/null
+++ b/docs/knowledge/archive/plans/preprint-citations-map.md
@@ -0,0 +1,228 @@
+---
+type: ref
+project: preprint
+status: active
+---
+
+# Карта цитат: теоретическая поддержка архитектуры tvplotlines
+
+Справочник: какие цитаты из прочитанных статей поддерживают какие элементы tvplotlines. Для использования при написании препринта.
+
+## Pass 0: franchise type detection
+
+**Что делает:** Определяет тип сериала (procedural / serial / hybrid / ensemble) и переключает стратегию анализа для всех последующих пассов.
+
+**Теоретическое обоснование:** Это cognitive control system — фильтр, который определяет, какие паттерны ожидать и какие инференсы делать.
+
+> "for each (frequently encountered) text type, proficient readers have developed a particular *cognitive control system*, which guides their comprehension efforts. That is, the control system is in charge of regulating the basic operations of text comprehension. It can do this by emphasizing some processes and de-emphasizing others."
+> — Zwaan 1993, p. 2
+
+> "Genre signals trigger the LCCS to set some parameters for truth values in accordance with the conventions for that genre; these parameters then constrain the construction of situation models for texts of that genre."
+> — Zwaan 1993, p. 126
+
+## Pass 1: Story DNA (driver / goal / obstacle / stakes)
+
+**Что делает:** Извлекает для каждой сюжетной линии — кто движет (driver), чего хочет (goal), что мешает (obstacle), что на кону (stakes).
+
+**Теоретическое обоснование:** Story DNA — scaffold для goal-based inference, который переключает LLM с уровня textbase (что произошло) на уровень situation model (зачем персонаж так поступил).
+
+### На goal:
+
+> "Narratives are about people acting in a setting, and the happenings that befall them must be relevant to their intentional states while so engaged — to their beliefs, desires, theories, values, and so on."
+> — Bruner 1991, p. 7
+
+> "the statement of a goal carries considerable weight during text comprehension... a goal statement is an effective foregrounding device"
+> — Zwaan & Radvansky 1998, p. 173
+
+> "comprehenders also rely on inferential processes about human intentions. Just as in other forms of comprehension, inferred intentions provide structural information about action sequences."
+> — Zwaan 2025, p. 291
+
+### На obstacle (canonicity and breach):
+
+> "For to be worth telling, a tale must be about how an implicit canonical script has been breached, violated, or deviated from."
+> — Bruner 1991, p. 11
+
+> "It is Trouble that provides the engine of drama."
+> — Bruner 1991, p. 16
+
+> "Stories are about problems of one sort or another, so it makes sense to link storytelling to a problem solver."
+> — Meehan 1977, p. 96
+
+### На stakes и незавершённые цели:
+
+> "When people are probed for information from a story, failed goal information is more available than completed goal information."
+> — Zwaan & Radvansky 1998, p. 173
+
+### На Story DNA в целом как scaffold для intentionality:
+
+> "the motivational and causal dimensions form the backbone of situations constructed during narrative comprehension... humans read texts to understand *why* things happened."
+> — Zwaan & Radvansky 1998, p. 178
+
+> "Comprehension is an 'effort after meaning.' It is not enough to know that TWA Flight 800 crashed or when or where it crashed. We want to know *why* it crashed."
+> — Graesser et al. 1994, cited in Zwaan & Radvansky 1998, p. 178
+
+## Pass 2: event assignment + functions + interactions
+
+**Что делает:** Для каждого эпизода извлекает события, привязывает к линиям, назначает функции (setup / escalation / turning_point / climax / resolution), определяет interactions между линиями (thematic_rhyme, dramatic_irony, convergence).
+
+**Теоретическое обоснование:** Event functions — это индексирование по каузальности и интенциональности (event-indexing model). Interactions — элементы pragmatic model (авторские стратегии).
+
+### На event functions:
+
+> "the motivational and causal dimensions form the backbone of situations constructed during narrative comprehension"
+> — Zwaan & Radvansky 1998, p. 178
+
+> "the events themselves need to be *constituted* in the light of the overall narrative — in Propp's terms, to be made 'functions' of the story."
+> — Bruner 1991, p. 8
+
+### На interactions (pragmatic model):
+
+> "the situation model is a representation of a state of affairs referred to by the text, whereas the pragmatic model is the model of the situation in which the text is processed"
+> — Zwaan 1993, p. 152
+
+> "in news comprehension the pragmatic model is *retrieved* from LTM, whereas in literary comprehension it has to be *constructed* as the reader goes along"
+> — Zwaan 1993, p. 153
+
+## Multi-pass pipeline (Pass 2 → post-processing → Pass 3)
+
+**Что делает:** Ранние пассы собирают данные по эпизодам (loosely organized), поздние пересматривают целое. Финальная интерпретация откладывается до полной картины.
+
+**Теоретическое обоснование:** Герменевтический круг (части ↔ целое) и indeterminacy hypothesis (откладывание интерпретации).
+
+### Герменевтический круг:
+
+> "we are trying to establish a reading for the whole text, and for this we appeal to readings of its partial expressions; and yet because we are dealing with meaning... the readings of the partial expressions depend on those of others, and ultimately of the whole."
+> — Charles Taylor, cited in Bruner 1991, p. 8
+
+> "In Vladimir Propp's terms, the parts of a narrative serve as 'functions' of the narrative structure as a whole. But that whole cannot be constructed without reference to such appropriate parts."
+> — Bruner 1991, p. 8
+
+### Откладывание интерпретации:
+
+> "Literary comprehension does not lead to a *stronger* textbase representation, but to a more *loosely organized* textbase. A loosely organized textbase contains seemingly irrelevant or contradictory information... the *connections* between these propositions will be *weaker*."
+> — Zwaan 1993, p. 149
+
+> "The indeterminacy hypothesis suggests that readers do not *immediately* commit themselves to one situational representation."
+> — Zwaan 1993, p. 150
+
+## Зачем LLM нужен scaffold (tvplotlines как cognitive control system)
+
+**Что делает:** tvplotlines для LLM — то же, что литературное образование для человека. Не даёт новых данных, а учит задавать правильные вопросы.
+
+### LLM без scaffold — shortcut learning:
+
+> "the performance of such learning systems might rely on spurious correlations in the data, a phenomenon known as *shortcut learning*"
+> — Zwaan 2025, p. 289
+
+### LLM = orrery (отслеживают динамику, не понимают причинность):
+
+> "'Situation models'—that is, the ability of LLMs to track who is doing what in story texts—might be classified as orrery-like models; they track some dynamics but don't represent causal knowledge about the wider world."
+> — Mitchell 2025, Part 1
+
+tvplotlines + Story DNA scaffold поднимает LLM **выше оррери**: заставляет моделировать не только «кто что делает», но и «зачем, что мешает, что на кону».
+
+### LLM без scaffold — simulation без comprehension:
+
+> "erratic behaviors caused by misclassification of what is considered proper behavior, especially when the physical norms of certain locations that are hard to convey in natural language did not percolate to the agents"
+> — Park et al. 2023, p. 18
+
+> "instruction tuning... seemed to guide the behavior of the agents to be more polite and cooperative overall... Despite these ideas not aligning with her own interests and characteristics, she rarely said no"
+> — Park et al. 2023, p. 18
+
+### Comprehension ≠ extraction:
+
+> "the comprehension of a text is more than the rather mechanistic construction of a textbase... the important role that fact relationships play in comprehension is neglected"
+> — Zwaan 1993, p. 28
+
+## Работа с синопсисами (текст о визуальном медиуме)
+
+**Что делает:** tvplotlines анализирует сериал через текстовые синопсисы, а не через сам видеоматериал.
+
+> "situation model construction is an overarching skill despite the fact that the front-end processes... differ widely across media"
+> — Zwaan 2025, p. 291
+
+## ТЗ для tvplotlines (написанное в 1998)
+
+> "several capabilities must be added to 'smarten up' the current class [of models]... such a module would have to (a) represent connections among situational nodes on different dimensions, such as time, space, causation, intentionality, and agency; and (b) capture the construction, foregrounding, updating, integration, and retrieval of situational information"
+> — Zwaan & Radvansky 1998, p. 181
+
+## tvplotlines как distributed intelligence
+
+> "An individual's working intelligence is never 'solo.' It cannot be understood without taking into account his or her reference books, notes, computer programs and data bases, or most important of all, the network of friends, colleagues, or mentors on whom one leans for help and advice."
+> — Bruner 1991, p. 3
+
+## Нарратив как способ мышления (не текстовая форма)
+
+> "The central concern is not how narrative as text is constructed, but rather how it operates as an instrument of mind in the construction of reality."
+> — Bruner 1991, p. 5-6
+
+> "we organize our experience and our memory of human happenings mainly in the form of narrative — stories, excuses, myths, reasons for doing and not doing, and so on."
+> — Bruner 1991, p. 4
+
+> "Narrative 'truth' is judged by its verisimilitude rather than its verifiability."
+> — Bruner 1991, p. 13
+
+## Story DNA scaffold как «правильный вопрос» (Winston)
+
+> Genesis не видит связь между убийством и индивидуализмом — пока её не спросят. Тогда предустановка активируется и связь появляется.
+> — Winston 2014, Figure 13, p. 7
+
+Тот же механизм: LLM «знает» про intentional states, но не активирует это знание без Story DNA scaffold. Scaffold = правильный вопрос.
+
+## Story understanding как ключевое отличие человеческого интеллекта
+
+> "I focus on story understanding, which I believe is the key difference between us and all other primates, living and extinct."
+> — Winston 2014, p. 1
+
+## Genesis как прямой предшественник tvplotlines
+
+> "No language system has the common sense required to understand what it is reading and the implications that flow from common sense understanding."
+> — Winston 2014, p. 1
+
+Genesis (2014) и tvplotlines (2025) делают одно: читают нарратив → строят structured representation → находят паттерны → отвечают на «почему». Genesis — на ручных правилах, 20-100 предложений. tvplotlines — на LLM со scaffold, полные сезоны сериалов.
+
+## Structured representation лучше unstructured (аргумент за Story DNA как JSON)
+
+> "providing agents with structured memory in the form of knowledge graphs... is critical in enabling them to operate in and model these worlds"
+> — Ammanabrolu & Riedl 2021, p. 1
+
+Worldformer показывает: knowledge graph (structured) значительно превосходит текст (unstructured) для world modeling. Аналогично: Story DNA (structured JSON с driver/goal/obstacle/stakes) ценнее, чем свободный текстовый «анализ» от LLM.
+
+## World model для comprehension, не только для action
+
+> "the ability to predict how the world will change in response to one's actions will help you better plan what actions to take"
+> — Ammanabrolu & Riedl 2021, p. 1
+
+Worldformer строит world model для агента (чтобы действовать). tvplotlines строит world model для аналитика (чтобы понимать). Обе задачи требуют structured representation, обе обновляются инкрементально, обе выходят за пределы эксплицитного текста.
+
+## Inference за пределами наблюдаемого (аргумент за Story DNA obstacle/stakes)
+
+> "by inferring that a locked chest is likely to contain treasure before it is actually revealed provides an agent with a form of look-ahead"
+> — Ammanabrolu & Riedl 2021, p. 2
+
+Story DNA obstacle и stakes часто не эксплицитны в синопсисе — LLM их *выводит* (infers), как Worldformer выводит содержимое запертого сундука. Scaffold заставляет делать этот вывод.
+
+## tvplotlines как human-centered AI (обе стороны)
+
+> "human-centered artificial intelligence can be broken down into two critical capacities: (1) understanding humans, and (2) being able to help humans understand the AI systems."
+> — Riedl 2019, p. 3
+
+tvplotlines: сторона 1 — Story DNA scaffold учит LLM моделировать intentional states (enculturation). Сторона 2 — TVPlotlinesResult = structured, interpretable JSON, который человек может проверить и оспорить (transparency).
+
+## AI как инопланетянин (мотивация для enculturation)
+
+> "the way intelligent systems solve problems—especially when using machine learning—is fundamentally *alien* to humans"
+> — Riedl 2019, p. 2
+
+> "our theory of mind breaks down when interacting with intelligent systems, which do not solve problems the way we do"
+> — Riedl 2019, p. 2
+
+## Истории как источник социальных норм
+
+> "Stories and writing can be particularly powerful sources of common knowledge; people write what they know and social and cultural biases and assumptions can come out"
+> — Riedl 2019, p. 4
+
+## Нарратив как содержание странного, не его разрешение
+
+> "Narrative, I believe, is designed to contain uncanniness rather than to resolve it."
+> — Bruner 1991, p. 16
diff --git a/docs/knowledge/archive/plans/preprint-experiment-scaffold.md b/docs/knowledge/archive/plans/preprint-experiment-scaffold.md
new file mode 100644
index 0000000..f4c5bdf
--- /dev/null
+++ b/docs/knowledge/archive/plans/preprint-experiment-scaffold.md
@@ -0,0 +1,87 @@
+---
+type: plan
+project: preprint
+status: active
+---
+
+# Эксперимент: Story DNA как когнитивный scaffold
+
+## Гипотеза
+
+Story DNA template (driver / goal / obstacle / stakes) — не просто формат вывода, а **когнитивный scaffold**, который переключает LLM с textbase-уровня (что произошло) на situation model-уровень (зачем персонаж так поступил). Без scaffold LLM сам не выходит на уровень intentional states (Bruner 1991).
+
+## Дизайн
+
+Три условия. Один и тот же вход (синопсисы сезона). Разные промпты.
+
+### Условие A: без scaffold
+
+Промпт: «Перечисли основные сюжетные линии этого сезона. Для каждой укажи название и краткое описание.»
+
+LLM отвечает в свободной форме. Никакой структуры не навязано.
+
+### Условие B: свободный анализ
+
+Промпт: «Проанализируй нарративную структуру этого сезона. Определи сюжетные линии, их взаимосвязи и развитие.»
+
+LLM получает задачу «глубже», но без конкретного scaffold. Проверяет: выйдет ли LLM на уровень intentional states сам, если попросить «анализировать».
+
+### Условие C: со Story DNA scaffold
+
+Промпт: «Для каждой сюжетной линии определи: driver (кто движет), goal (чего хочет), obstacle (что мешает), stakes (что на кону). Классифицируй тип (episodic / serialized / runner), ранг (A / B / C).»
+
+LLM вынужден отвечать на вопросы о намерениях, препятствиях и ценностях — scaffold заставляет перейти на situation model.
+
+## Метрики
+
+### Количественные
+- **Intentional state coverage:** сколько линий содержат эксплицитную информацию о мотивации персонажа (goal/desire/belief)? Считаем вручную или LLM-judge.
+- **Causal depth:** сколько причинно-следственных связей между событиями выявлено?
+- **Character differentiation:** различаются ли персонажи по мотивациям, или описаны как «участники событий»?
+- **Breach detection:** сколько моментов «нарушения ожиданий» (turning points, twists) идентифицировано?
+
+### Качественные (expert evaluation)
+- Насколько результат полезен для development executive / сценариста?
+- Видна ли структура сезона или только пересказ?
+- Есть ли понимание «зачем авторы так построили» (pragmatic model)?
+
+## Данные
+
+Минимум 5 сериалов разных franchise types:
+- 1 procedural (House / Law & Order)
+- 1 serial (Breaking Bad / The Wire)
+- 1 hybrid (X-Files / Buffy)
+- 1 ensemble (Game of Thrones / This Is Us)
+- 1 limited (Chernobyl / The Queen's Gambit)
+
+По одному сезону каждого. Синопсисы берём одинаковые для всех условий.
+
+## Ожидаемый результат
+
+- **A** (без scaffold): список линий-пересказов, мало intentional states, мало causal depth. Textbase-уровень.
+- **B** (свободный анализ): чуть глубже, но хаотично. LLM иногда выходит на intentional states, иногда нет. Нестабильно.
+- **C** (Story DNA scaffold): систематическое покрытие intentional states для каждой линии. Более высокий causal depth. Чёткая дифференциация персонажей по мотивациям.
+
+Разница B→C покажет, что scaffold — не просто формат, а когнитивный инструмент: LLM «знает» про intentional states (они есть в training data), но без явного запроса не активирует это знание. Scaffold — это активация, аналог cognitive control system (Zwaan 1993).
+
+## Теоретическая рамка
+
+| Что тестируем | Теоретический источник |
+|---|---|
+| Story DNA scaffold переключает LLM с textbase на situation model | Kintsch & Van Dijk 1978, Zwaan 1993 |
+| Scaffold заставляет моделировать intentional states | Bruner 1991 (intentional state entailment) |
+| Scaffold работает как cognitive control system | Zwaan 1993 (CCS) |
+| Franchise type detection меняет стратегию анализа | Zwaan 1993 (LCCS / NCCS) |
+| LLM без scaffold не выходит на situation model | Mitchell 2024 (LLMs lack world models), Park et al. 2023 (simulation без comprehension) |
+
+## Distributed intelligence как архитектурный принцип
+
+tvplotlines реализует distributed intelligence (Bruner 1991, Vygotsky): три типа интеллекта в одной системе, каждый со своей функцией.
+
+**Детерминированный код** (pipeline, validators, post-processing) — гарантирует структуру и consistency. JSON schema, rank-span checks, orphan assignment. Не думает — но без него LLM наделает ошибок. Как таблица Менделеева: сама не решает, но без неё химик не работает.
+
+**Промпты со знанием** (Story DNA template, franchise types, event functions) — накопленное нарратологическое знание, зашитое в scaffold. Не генерирует ответы, но задаёт правильные вопросы. Как опытный редактор: не пишет сам, но спрашивает «зачем твой герой так поступил?».
+
+**LLM** (Claude / GPT) — гибкий решатель, способный к inference, но без scaffold остаётся на уровне textbase. Как талантливый стажёр: может увидеть глубоко, но только если правильно направить.
+
+Multi-pass pipeline — распределение задач между тремя типами: LLM генерирует, промпт направляет, код валидирует. Ни один не справится в одиночку. Вместе — вычислительная реализация cognitive control system.
diff --git a/docs/knowledge/archive/plans/publication-plan.md b/docs/knowledge/archive/plans/publication-plan.md
new file mode 100644
index 0000000..e90b15f
--- /dev/null
+++ b/docs/knowledge/archive/plans/publication-plan.md
@@ -0,0 +1,97 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# tvplotlines v0.1.0 — план публикации
+
+Дата: 2026-03-25
+
+## 1. Утилита `tvplotlines write-synopses`
+
+### Что делает
+
+CLI-утилита: по названию шоу и номеру сезона ищет информацию в интернете, читает страницы с описаниями эпизодов, и пишет синопсисы по протоколу (`synopsis-authoring-protocol.md`). Сохраняет в файлы.
+
+### Принцип
+
+- CLI-утилита, **не часть библиотечного API**
+- `__init__.py` её не импортирует и не экспортирует
+- Библиотека остаётся чистым вычислением (`get_plotlines()`)
+- Optional dependency: `pip install tvplotlines[writer]` ставит httpx
+- Паттерн httpx: `try/except ImportError` в `cli.py` с сообщением "установите `tvplotlines[writer]`"
+
+### CLI интерфейс
+
+```bash
+pip install tvplotlines[writer]
+tvplotlines write-synopses "House" --season 1 -o synopses/
+# → synopses/S01E01.txt, S01E02.txt, ...
+```
+
+### Файловая структура (новые файлы)
+
+```
+src/tvplotlines/
+├── write_synopses.py        # веб-поиск + LLM-генерация (НОВЫЙ)
+└── prompts_en/
+    └── write_synopses.md    # промпт на основе synopsis-authoring-protocol (НОВЫЙ)
+```
+
+### Изменения в существующих файлах
+
+- `cli.py` — добавить команду `write-synopses` с `try/except ImportError`
+- `pyproject.toml` — добавить `[project.optional-dependencies] writer = ["httpx>=0.27"]`
+
+### Поток работы
+
+1. Ищет в интернете "{show} season {N} episode guide"
+2. Находит страницы с описаниями эпизодов (Wikipedia, IMDb, и др.)
+3. Читает контент страниц
+4. LLM переписывает каждый эпизод по протоколу (300–500 слов, 8–15 beats, покрытие всех линий)
+5. Сохраняет `S01E01.txt`, `S01E02.txt`, ... в output-директорию
+
+## 2. Подготовка к публикации
+
+### 2.1. Новые файлы
+
+- [ ] `CHANGELOG.md` — одна запись `## 0.1.0`, описание что есть в первом релизе
+- [ ] `CONTRIBUTING.md` — краткий гайд: как запустить тесты, стиль кода, как создать PR
+
+### 2.2. Git history и внутренние артефакты
+
+`experiments/`, `program.md`, `results.tsv` — в git history. `.gitignore` не удалит их из истории. Но данные **не чувствительные** (промпты, синопсисы public domain, метрики экспериментов). Никаких ключей или приватных данных.
+
+**Решение: оставить как есть.** `experiments/` — часть research-истории, для open-source это плюс (прозрачность). Если позже захотим чистый старт — orphan branch проще чем filter-repo.
+
+- [ ] `experiments/` — добавить в `.gitignore` (чтобы новые файлы не попадали)
+- [ ] `program.md` — добавить в `.gitignore`
+- [ ] `results.tsv` — уже untracked, убедиться что в `.gitignore`
+- [ ] Проверить что `.env`, `CLAUDE.md` не попадают (уже в `.gitignore`)
+
+### 2.3. GitHub metadata
+
+- [ ] Добавить description: "LLM-powered narrative breakdown for TV series"
+- [ ] Добавить topics: `narrative`, `llm`, `tv-series`, `plotlines`, `narrative-analysis`, `screenwriting`
+- [ ] Сделать репо public (последний шаг)
+
+## 3. Что НЕ делаем сейчас
+
+- PyPI публикация
+- GitHub Actions CI (pytest)
+- `py.typed` маркер
+- Документация на ReadTheDocs
+
+## 4. Порядок выполнения
+
+1. Написать `write_synopses.py` + промпт
+2. Обновить `cli.py` и `pyproject.toml`
+3. Протестировать утилиту
+4. Написать `CHANGELOG.md`
+5. Написать `CONTRIBUTING.md`
+6. Убрать внутренние артефакты из git tracking
+7. Проверить что всё чисто (`git status`, тесты)
+8. Коммит
+9. GitHub metadata (description, topics)
+10. Сделать репо public
diff --git a/docs/knowledge/archive/plans/readme-draft.md b/docs/knowledge/archive/plans/readme-draft.md
new file mode 100644
index 0000000..addbbd7
--- /dev/null
+++ b/docs/knowledge/archive/plans/readme-draft.md
@@ -0,0 +1,185 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# tvplotlines
+
+[![PyPI](https://img.shields.io/pypi/v/tvplotlines?cacheSeconds=3600)](https://pypi.org/project/tvplotlines/)
+[![License](openclaw/node_modules/ms/license.md)
+[![Python](https://img.shields.io/pypi/pyversions/tvplotlines?cacheSeconds=3600)](https://pypi.org/project/tvplotlines/)
+
+Turn episode synopses into a writers' room corkboard — story engine, plotlines with their *story DNA* and *arcs* (see definitions in [glossary](src/tvplotlines/prompts_en/glossary.md)) — in one function call.
+
+For TV researchers, screenwriters, and anyone building narrative analysis tools or a tv series.
+
+<p align="center">
+  <a href="https://birdinthetree.github.io/plotter-app/">
+    <img src="docs/images/app-screenshot-1.png" alt="tvplotlines output — plotline×episode grid for Breaking Bad S01">
+  </a>
+  <br>
+  <strong><a href="https://birdinthetree.github.io/plotter-app/">Try the interactive demo →</a></strong>
+</p>
+
+A naive LLM prompt covers 5–12% of a season's source material. tvplotlines covers **78–91%** — by separating *what* the model looks for (narrative theory) from *how* it calculates the results (code).
+
+## Quick start
+
+```bash
+pip install tvplotlines
+export ANTHROPIC_API_KEY=sk-ant-…
+```
+
+Working on your own series? Point it at your synopses — one `.txt` file per episode (see [Input format](#input-format)):
+
+```bash
+tvplotlines run my-series/
+```
+
+Want to analyze an existing show? The optional `writer` extension generates synopses from online sources:
+
+```bash
+pip install 'tvplotlines[writer]'
+tvplotlines write-synopses "Mad Men" --season 1
+tvplotlines run mad-men/
+```
+
+Multiple seasons are supported — plotline continuity is tracked across seasons (see [Python API](#python-api)).
+
+Pre-computed results are in [`examples/results/`](examples/results/) — explore the output without spending API credits.
+
+## What you get
+
+One JSON file per season. Each contains:
+
+- **Cast** — characters with aliases
+- **Plotlines** — with A/B/C ranking, Story DNA (hero, goal, obstacle, stakes), and episode span
+- **Events** — per-episode, assigned to plotlines with narrative function (setup → inciting incident → escalation → crisis → climax → resolution)
+
+<details>
+<summary>Example: Breaking Bad S01 (truncated)</summary>
+
+```json
+{
+  "context": {
+    "format": "serial",
+    "story_engine": "A high school teacher builds a drug empire, testing how far he'll go for family and survival"
+  },
+  "cast": [
+    {"id": "walt", "name": "Walter White", "aliases": ["Walt", "Heisenberg", "Mr. White"]},
+    {"id": "jesse", "name": "Jesse Pinkman", "aliases": ["Jesse"]}
+  ],
+  "plotlines": [
+    {
+      "id": "empire",
+      "name": "Walt: Empire",
+      "hero": "walt",
+      "goal": "build a drug business to secure his family's financial future",
+      "obstacle": "inexperience with criminal world, violent dealers like Tuco, moral boundaries",
+      "stakes": "death, loss of family, imprisonment",
+      "rank": "A",
+      "span": ["S01E01", "S01E02", "...", "S01E07"]
+    }
+  ],
+  "episodes": [
+    {
+      "episode": "S01E01",
+      "theme": "transformation through desperation",
+      "events": [
+        {
+          "event": "During the meth lab raid, Walt spots his former student Jesse escaping through a window",
+          "plotline_id": "empire",
+          "function": "inciting_incident",
+          "characters": ["walt", "jesse"]
+        }
+      ]
+    }
+  ]
+}
+```
+
+</details>
+
+## How it works
+
+### Plotline extraction (`tvplotlines run`)
+
+Five LLM passes, each with a specialized prompt:
+
+| Pass | Role | Output | Calls |
+|------|------|--------|-------|
+| **0** | Context detection | Format (serial/procedural/ensemble), genre, story engine | 1 |
+| **1** | Plotline extraction | Cast + plotlines with Story DNA | 3 (majority vote) |
+| **2** | Event assignment | Events mapped to plotlines with narrative functions | 1 per episode |
+| **3** | Structural review | Verdicts: merge, reassign, create, drop, refunction | 1 |
+| **4** | Arc functions | Season-level arc function for each event (per plotline) | 1 per plotline |
+
+Pass 1 runs 3× in parallel and picks the most common plotline set. Pass 3 sees the full picture no earlier pass had and corrects structural problems. Pass 4 assigns arc-level functions — an event that was a climax in episode 3 might be an escalation in the season-long arc.
+
+### Synopsis generation (`write-synopses`)
+
+The `writer` extension collects raw episode data from online sources, then rewrites each episode into a full synopsis via LLM — ensuring every sentence is a beat (conflict or change), with explicit causality and character names.
+
+Tested with Claude Sonnet (default). OpenAI and Ollama supported for both pipelines. Ollama defaults to Qwen 2.5 14B — chosen to run on CPU without a GPU. Quality is noticeably lower than cloud models but works for experimentation.
+
+## Input format
+
+One `.txt` file per episode. Include `S01E01`, `S01E02`, etc. in the filename. Each file is a plain-text (.txt) synopsis — 150–500 words covering the main events.
+
+```
+breaking-bad/
+├── S01E01.txt
+├── S01E02.txt
+└── S01E07.txt
+```
+
+The folder name becomes the show title. Override with `--show`:
+
+```bash
+tvplotlines run got/ --show "Game of Thrones"
+```
+
+## Python API
+
+```python
+from tvplotlines import get_plotlines
+
+s01 = get_plotlines("Breaking Bad", season=1, episodes=season_1_synopses)
+s02 = get_plotlines("Breaking Bad", season=2, episodes=season_2_synopses, prior=s01)
+```
+
+Pass `prior` to track plotline continuity across seasons.
+
+## LLM providers
+
+```bash
+tvplotlines run breaking-bad/                    # Anthropic (default)
+tvplotlines run breaking-bad/ --provider openai  # OpenAI
+tvplotlines run breaking-bad/ --provider ollama  # Ollama (local, free)
+```
+
+See [docs/api.md](docs/api.md) for full API reference.
+
+## Key concepts
+
+- **Plotline** — a narrative thread across episodes (e.g. "Walt: Empire")
+- **Story DNA** — hero, goal, obstacle, stakes
+- **A/B/C ranking** — plotline weight (A = main, B = secondary, C = tertiary, runner = minor thread)
+- **Format** — procedural (House), serial (Breaking Bad), hybrid (X-Files), ensemble (Game of Thrones)
+- **Story engine** — one sentence capturing the show's core dramatic mechanism
+
+## Citation
+
+```bibtex
+@software{tvplotlines2026,
+  author = {Vashko, N.},
+  title = {tvplotlines: LLM-Driven Plotline Extraction from Episode Synopses},
+  year = {2026},
+  url = {https://github.com/BirdInTheTree/tvplotlines}
+}
+```
+
+## License
+
+MIT
diff --git a/docs/knowledge/archive/plans/resources-migration-plan.md b/docs/knowledge/archive/plans/resources-migration-plan.md
new file mode 100644
index 0000000..5838ef3
--- /dev/null
+++ b/docs/knowledge/archive/plans/resources-migration-plan.md
@@ -0,0 +1,759 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# 3-resources Flat Migration Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Flatten `3-resources/` from 30+ nested folders into a single flat directory with YAML frontmatter, Templater templates, and Dataview navigation.
+
+**Architecture:** Move all files to `3-resources/` root, rename per convention (`project-name.md`), add frontmatter (`type`, `project`, `status`). Templates go to `.obsidian/templates/`. Delete `birdinthetree.github.io_docs/` entirely. Non-markdown files renamed to match convention and kept flat.
+
+**Tech Stack:** Obsidian, Templater plugin, Dataview plugin
+
+**Spec:** `3-resources/plotter_docs/superpowers/specs/2026-03-18-resources-restructure-design.md`
+
+---
+
+### Task 1: Safety backup
+
+- [ ] **Step 1: Create timestamped backup of entire 3-resources/**
+
+```bash
+cp -a /Users/nvashko/Projects/3-resources /Users/nvashko/Projects/3-resources-backup-2026-03-18
+```
+
+- [ ] **Step 2: Verify backup**
+
+```bash
+diff <(find /Users/nvashko/Projects/3-resources -type f | wc -l) <(find /Users/nvashko/Projects/3-resources-backup-2026-03-18 -type f | wc -l)
+```
+
+Expected: same file count.
+
+---
+
+### Task 2: Create Templater templates and config
+
+**Files:**
+- Create: `.obsidian/templates/_chooser.md`
+- Create: `.obsidian/templates/_tpl-document.md`
+- Create: `.obsidian/templates/_tpl-reading.md`
+- Create: `.obsidian/templates/_tpl-moc.md`
+- Create: `.obsidian/templates/_tpl-blog-post.md`
+- Create: `.obsidian/plugins/templater-obsidian/data.json`
+
+- [ ] **Step 1: Create templates directory**
+
+```bash
+mkdir -p /Users/nvashko/Projects/.obsidian/templates
+```
+
+- [ ] **Step 2: Create dispatcher template `_chooser.md`**
+
+```markdown
+<%*
+const templates = {
+  "Document (spec, plan, decision, note, draft, ref)": "_tpl-document",
+  "Reading (paper notes)": "_tpl-reading",
+  "MOC (Map of Content)": "_tpl-moc",
+  "Blog Post": "_tpl-blog-post"
+};
+const names = Object.keys(templates);
+const chosen = await tp.system.suggester(names, names, true, "Choose template");
+const tplName = templates[chosen];
+const tpl = await app.vault.getAbstractFileByPath(`.obsidian/templates/${tplName}.md`);
+const content = await app.vault.read(tpl);
+// Process Templater syntax in the included template
+const result = await tp.file.include(`[[${tplName}]]`);
+tR += result;
+%>
+```
+
+- [ ] **Step 3: Create `_tpl-document.md`**
+
+```markdown
+<%*
+const types = ["spec", "plan", "decision", "note", "draft", "ref", "concept", "style-analysis"];
+const projects = ["tvplotlines", "preprint", "tvplotlines-app", "zotero-mcp", "awesome-list", "github-io"];
+const type = await tp.system.suggester(types, types, true, "Document type");
+const project = await tp.system.suggester(projects, projects, true, "Project");
+-%>
+---
+type: <% type %>
+project: <% project %>
+status: active
+---
+
+# <% tp.file.title %>
+```
+
+- [ ] **Step 4: Create `_tpl-reading.md`**
+
+```markdown
+<%*
+const projects = ["tvplotlines", "preprint", "tvplotlines-app", "zotero-mcp", "awesome-list", "github-io"];
+const project = await tp.system.suggester(projects, projects, true, "Project");
+const title = await tp.system.prompt("Paper title");
+const authors = await tp.system.prompt("Authors (comma-separated)");
+const year = await tp.system.prompt("Year");
+const tags = await tp.system.prompt("Tags (comma-separated)");
+const authorList = authors.split(",").map(a => a.trim());
+const tagList = tags.split(",").map(t => t.trim());
+-%>
+---
+type: reading
+title: "<% title %>"
+authors: [<% authorList.join(", ") %>]
+year: <% year %>
+tags: [<% tagList.join(", ") %>]
+project: <% project %>
+status: active
+---
+
+# <% tp.file.title %>
+
+**Source:** URL or DOI
+**Category:** empirical | theoretical | method | survey | benchmark
+
+## Claim
+
+What the authors assert (1-2 sentences, in your own words).
+
+<!--
+Principles:
+- Self-contained: reader who never read the paper understands in 30 seconds
+- Your words, not theirs. Direct quotes only for language worth citing verbatim
+- If you can't fill "Relevance" — the paper doesn't belong here
+-->
+
+## Method & Evidence
+
+How they support the claim: dataset, experiment design, key metrics,
+main quantitative results. Enough to judge credibility without
+reading the original.
+
+## Limitations
+
+What the authors acknowledge as weak, or what we see as gaps.
+
+## Relevance
+
+What this means for our work. Concrete: which part of the pipeline,
+which argument in the preprint, which design decision it supports
+or challenges.
+```
+
+- [ ] **Step 5: Create `_tpl-moc.md`**
+
+```markdown
+<%*
+const tags = await tp.system.prompt("Tags for Dataview filter (comma-separated)");
+const tagList = tags.split(",").map(t => `"${t.trim()}"`).join(", ");
+-%>
+---
+type: moc
+tags: [<% tags.split(",").map(t => t.trim()).join(", ") %>]
+status: active
+---
+
+# <% tp.file.title %>
+
+```dataview
+TABLE type, file.cday as "Created"
+FROM "3-resources"
+WHERE contains(tags, [<% tagList %>]) AND status = "active"
+SORT file.cday DESC
+```
+```
+
+- [ ] **Step 6: Create `_tpl-blog-post.md`**
+
+```markdown
+---
+type: draft
+project: github-io
+status: active
+title: ""
+date: "<% tp.date.now("YYYY-MM-DD") %>"
+description: ""
+series: "What Logic Can Do for Stories"
+tags: []
+sources:
+  - reading_note: ""
+    sections_used: []
+---
+
+# <% tp.file.title %>
+
+> One-paragraph hook: the engineering problem. No jargon.
+
+## The problem
+
+What goes wrong without formal structure. 3-5 sentences.
+
+## What the literature offers
+
+2-4 approaches, one paragraph each.
+
+## The bridge: from theory to pipeline
+
+How does this formal method become a prompt, a data model, or an algorithm?
+
+## Takeaway
+
+3-5 bullet points.
+
+## Further reading
+```
+
+- [ ] **Step 7: Write Templater data.json**
+
+Write to `/Users/nvashko/Projects/.obsidian/plugins/templater-obsidian/data.json`:
+
+```json
+{
+  "command_timeout": 5,
+  "templates_folder": ".obsidian/templates",
+  "templates_pairs": [["", ""]],
+  "trigger_on_file_creation": true,
+  "auto_jump_to_cursor": true,
+  "enable_system_commands": false,
+  "shell_path": "",
+  "user_scripts_folder": "",
+  "enable_folder_templates": true,
+  "folder_templates": [
+    {
+      "folder": "3-resources",
+      "template": ".obsidian/templates/_chooser.md"
+    }
+  ],
+  "syntax_highlighting": true,
+  "syntax_highlighting_mobile": false,
+  "enabled_templates_hotkeys": [""],
+  "startup_templates": [""]
+}
+```
+
+- [ ] **Step 8: Verify in Obsidian**
+
+Restart Obsidian (or reload plugins). Create a test file in `3-resources/`. Templater should show the template picker. Delete the test file after verification.
+
+---
+
+### Task 3: Delete birdinthetree.github.io_docs/
+
+Before deleting, extract the 7 useful markdown files.
+
+- [ ] **Step 1: Move useful docs to 3-resources/ root with new names**
+
+```bash
+cd /Users/nvashko/Projects/3-resources
+mv birdinthetree.github.io_docs/blog/bio-quotes.md github-io-bio-quotes.md
+mv birdinthetree.github.io_docs/blog/content-plan.md github-io-content-plan.md
+mv birdinthetree.github.io_docs/todo/analytics-visualization-redesign.md github-io-analytics-visualization-redesign.md
+mv birdinthetree.github.io_docs/todo/bugs-github-pages-ui.md github-io-bugs-ui.md
+mv birdinthetree.github.io_docs/todo/design-github-pages.md github-io-design.md
+mv birdinthetree.github.io_docs/todo/episode-number-from-filename.md github-io-episode-number-from-filename.md
+mv birdinthetree.github.io_docs/todo/plan-github-pages.md github-io-plan.md
+```
+
+- [ ] **Step 2: Delete the entire directory**
+
+```bash
+rm -rf /Users/nvashko/Projects/3-resources/birdinthetree.github.io_docs
+```
+
+- [ ] **Step 3: Add frontmatter to moved files**
+
+Each file gets:
+```yaml
+---
+type: plan  # or note, depending on content
+project: github-io
+status: active
+---
+```
+
+---
+
+### Task 4: Flatten awesome list/
+
+- [ ] **Step 1: Move and rename**
+
+```bash
+cd /Users/nvashko/Projects/3-resources
+mv "awesome list/bibliography-event-detection-computational-narratology.md" awesome-list-bibliography-event-detection.md
+mv "awesome list/curation-criteria.md" awesome-list-curation-criteria.md
+mv "awesome list/pianzola-2025-golem-ontology.md" read-pianzola-2025-golem-ontology.md
+```
+
+- [ ] **Step 2: Update/add frontmatter**
+
+`awesome-list-curation-criteria.md`: add `type: note`, `project: awesome-list`, `status: active`
+`awesome-list-bibliography-event-detection.md`: update existing frontmatter, add `status: active`
+`read-pianzola-2025-golem-ontology.md`: update existing frontmatter to `type: reading`, add `status: active`
+
+- [ ] **Step 3: Delete empty directory**
+
+```bash
+rmdir /Users/nvashko/Projects/3-resources/"awesome list"
+```
+
+---
+
+### Task 5: Flatten tvplotlines-app_docs/
+
+- [ ] **Step 1: Move and rename**
+
+```bash
+cd /Users/nvashko/Projects/3-resources
+mv tvplotlines-app_docs/specs/tvplotlines-app-context.md tvplotlines-app-context.md
+mv tvplotlines-app_docs/4reddit.md tvplotlines-app-reddit-strategy.md
+mv "tvplotlines-app_docs/Как украсть сериал.md" tvplotlines-app-kak-ukrast-serial.md
+```
+
+- [ ] **Step 2: Add frontmatter to each**
+
+- `tvplotlines-app-context.md`: `type: spec`, `project: tvplotlines-app`, `status: active`
+- `tvplotlines-app-reddit-strategy.md`: `type: plan`, `project: tvplotlines-app`, `status: active`
+- `tvplotlines-app-kak-ukrast-serial.md`: `type: note`, `project: tvplotlines-app`, `status: active`
+
+- [ ] **Step 3: Delete empty directory tree**
+
+```bash
+rm -rf /Users/nvashko/Projects/3-resources/tvplotlines-app_docs
+```
+
+---
+
+### Task 6: Flatten zotero-mcp_docs/
+
+- [ ] **Step 1: Move and rename**
+
+```bash
+cd /Users/nvashko/Projects/3-resources
+mv zotero-mcp_docs/plans/2026-03-17-zotero-mcp.md zotero-mcp-plan.md
+mv zotero-mcp_docs/specs/2026-03-17-zotero-mcp-design.md zotero-mcp-design.md
+```
+
+- [ ] **Step 2: Add frontmatter**
+
+- `zotero-mcp-plan.md`: `type: plan`, `project: zotero-mcp`, `status: active`
+- `zotero-mcp-design.md`: `type: spec`, `project: zotero-mcp`, `status: active`
+
+- [ ] **Step 3: Delete empty directory tree**
+
+```bash
+rm -rf /Users/nvashko/Projects/3-resources/zotero-mcp_docs
+```
+
+---
+
+### Task 7: Flatten plotter_docs/ — decisions, specs, todo
+
+- [ ] **Step 1: Move decisions**
+
+```bash
+cd /Users/nvashko/Projects/3-resources
+mv plotter_docs/decisions/001-context-before-extraction.md tvplotlines-decision-001-context-before-extraction.md
+mv plotter_docs/decisions/002-no-internal-state.md tvplotlines-decision-002-no-internal-state.md
+mv plotter_docs/decisions/003-abc-classification.md tvplotlines-decision-003-abc-classification.md
+mv plotter_docs/decisions/004-no-language-parameter.md tvplotlines-decision-004-no-language-parameter.md
+mv plotter_docs/decisions/005-pass3-narratologist-review.md tvplotlines-decision-005-pass3-narratologist-review.md
+```
+
+- [ ] **Step 2: Move specs**
+
+```bash
+mv plotter_docs/specs/architecture.md tvplotlines-architecture.md
+mv plotter_docs/specs/inventory.md tvplotlines-inventory.md
+mv plotter_docs/specs/mas4bw-library-audit.md tvplotlines-mas4bw-library-audit.md
+mv plotter_docs/specs/metrics-survey.md tvplotlines-metrics-survey.md
+mv plotter_docs/specs/open-source-strategy.md tvplotlines-open-source-strategy.md
+mv plotter_docs/specs/stability-benchmark.md tvplotlines-stability-benchmark.md
+mv plotter_docs/specs/synopsis-authoring-protocol.md tvplotlines-synopsis-authoring-protocol.md
+```
+
+- [ ] **Step 3: Move todo**
+
+```bash
+mv plotter_docs/todo/autoresearch-v3-hybrid-vs-procedural.md tvplotlines-autoresearch-v3-hybrid-vs-procedural.md
+mv plotter_docs/todo/bibliography-cleanup.md tvplotlines-bibliography-cleanup.md
+mv plotter_docs/todo/career-plan.md tvplotlines-career-plan.md
+mv plotter_docs/todo/event-functions-redesign.md tvplotlines-event-functions-redesign.md
+mv plotter_docs/todo/plan-restructure.md tvplotlines-plan-restructure.md
+mv plotter_docs/todo/tvplotlines-tasks-todo.md tvplotlines-tasks-todo.md
+```
+
+- [ ] **Step 4: Move root-level non-markdown**
+
+```bash
+mv plotter_docs/awesome-shortlist.bib tvplotlines-awesome-shortlist.bib
+```
+
+- [ ] **Step 5: Move superpowers/**
+
+```bash
+mv plotter_docs/superpowers/plans/2026-03-16-preprint-writing.md preprint-writing-plan.md
+mv plotter_docs/superpowers/specs/2026-03-16-preprint-design.md preprint-design-spec.md
+mv plotter_docs/superpowers/specs/2026-03-18-resources-restructure-design.md tvplotlines-resources-restructure-design.md
+```
+
+- [ ] **Step 6: Add frontmatter to all moved files**
+
+All decisions: `type: decision`, `project: tvplotlines`, `status: active`
+All specs: `type: spec`, `project: tvplotlines`, `status: active`
+All todos: `type: plan`, `project: tvplotlines`, `status: active`
+Superpowers plans: `type: plan`, `project: preprint`, `status: active`
+Superpowers specs: `type: spec`, `project: preprint`, `status: active`
+Resources restructure: `type: spec`, `project: tvplotlines`, `status: active`
+
+---
+
+### Task 8: Flatten plotter_docs/experiments/
+
+- [ ] **Step 1: Move root experiment files**
+
+```bash
+cd /Users/nvashko/Projects/3-resources
+mv plotter_docs/experiments/autoresearch-v3-brainstorm-notes.md tvplotlines-autoresearch-v3-brainstorm-notes.md
+mv plotter_docs/experiments/autoresearch-v3-event-functions.md tvplotlines-autoresearch-v3-event-functions.md
+mv plotter_docs/experiments/autoresearch-v3-reading-plan.md tvplotlines-autoresearch-v3-reading-plan.md
+mv plotter_docs/experiments/bibliography-narrative-and-autoresearch.md tvplotlines-bibliography-narrative-and-autoresearch.md
+mv plotter_docs/experiments/naive-vs-tvplotlines.md tvplotlines-naive-vs-tvplotlines.md
+mv plotter_docs/experiments/notes-liu-2026-narrative-survey.md read-liu-2026-narrative-survey.md
+mv plotter_docs/experiments/notes-tian-2024-turning-points.md read-tian-2024-turning-points.md
+mv plotter_docs/experiments/run_bb_all_seasons.py tvplotlines-run-bb-all-seasons.py
+```
+
+- [ ] **Step 2: Move autoresearch/ subdirectory**
+
+```bash
+mv plotter_docs/experiments/autoresearch/experiment-log.md tvplotlines-autoresearch-experiment-log.md
+mv plotter_docs/experiments/autoresearch/program-v2.md tvplotlines-autoresearch-program-v2.md
+mv plotter_docs/experiments/autoresearch/program.md tvplotlines-autoresearch-program.md
+mv plotter_docs/experiments/autoresearch/prompt-experiment-ideas.md tvplotlines-autoresearch-prompt-experiment-ideas.md
+mv plotter_docs/experiments/autoresearch/run-v2.md tvplotlines-autoresearch-run-v2.md
+mv plotter_docs/experiments/autoresearch/summary-v2.md tvplotlines-autoresearch-summary-v2.md
+mv plotter_docs/experiments/autoresearch/results-v2.tsv tvplotlines-autoresearch-results-v2.tsv
+mv plotter_docs/experiments/autoresearch/results.tsv tvplotlines-autoresearch-results.tsv
+```
+
+- [ ] **Step 3: Move bb_results/ (JSON)**
+
+```bash
+mv plotter_docs/experiments/bb_results/bb_s01_result.json tvplotlines-bb-s01-result.json
+mv plotter_docs/experiments/bb_results/bb_s02_result.json tvplotlines-bb-s02-result.json
+mv plotter_docs/experiments/bb_results/bb_s03_result.json tvplotlines-bb-s03-result.json
+mv plotter_docs/experiments/bb_results/bb_s04_result.json tvplotlines-bb-s04-result.json
+mv plotter_docs/experiments/bb_results/bb_s05_result.json tvplotlines-bb-s05-result.json
+```
+
+- [ ] **Step 4: Move breakdowns/**
+
+```bash
+mv plotter_docs/experiments/breakdowns/GDR_S01_breakdown.md tvplotlines-breakdown-gdr-s01.md
+mv plotter_docs/experiments/breakdowns/SP_S01_breakdown.md tvplotlines-breakdown-sp-s01.md
+mv plotter_docs/experiments/breakdowns/TD_S01_breakdown.md tvplotlines-breakdown-td-s01.md
+```
+
+- [ ] **Step 5: Move reading-notes/**
+
+```bash
+mv plotter_docs/experiments/reading-notes/autoresearch-v3-questions.md tvplotlines-autoresearch-v3-questions.md
+mv plotter_docs/experiments/reading-notes/blueprint-first-qiu-2025.md read-qiu-2025-blueprint-first.md
+mv plotter_docs/experiments/reading-notes/cot-wei-2022.md read-wei-2022-cot.md
+mv plotter_docs/experiments/reading-notes/got-besta-2024.md read-besta-2024-got.md
+mv plotter_docs/experiments/reading-notes/tot-yao-2023.md read-yao-2023-tot.md
+```
+
+- [ ] **Step 6: Add frontmatter**
+
+Experiment files: `type: note`, `project: tvplotlines`, `status: active`
+Reading notes (read-*): `type: reading`, `project: tvplotlines`, `status: active`
+Breakdowns: `type: note`, `project: tvplotlines`, `status: active`
+
+---
+
+### Task 9: Flatten plotter_docs/preprint/
+
+- [ ] **Step 1: Move preprint root files**
+
+```bash
+cd /Users/nvashko/Projects/3-resources
+mv plotter_docs/preprint/autoresearcher-competence-idea.md preprint-autoresearcher-competence-idea.md
+mv plotter_docs/preprint/blog-post-guide.md preprint-blog-post-guide.md
+mv plotter_docs/preprint/draft-fragments.md preprint-draft-fragments.md
+mv plotter_docs/preprint/drafts.md preprint-drafts.md
+mv plotter_docs/preprint/event-detection-sources.md preprint-event-detection-sources.md
+mv plotter_docs/preprint/notes.md preprint-notes.md
+mv plotter_docs/preprint/paper-summary-guide.md preprint-paper-summary-guide.md
+mv plotter_docs/preprint/positioning-strategy.md preprint-positioning-strategy.md
+mv plotter_docs/preprint/reference-list.md preprint-reference-list.md
+mv plotter_docs/preprint/writing-rules.md preprint-writing-rules.md
+mv plotter_docs/preprint/eastern-narratives.bib preprint-eastern-narratives.bib
+mv plotter_docs/preprint/style-guide.mmd preprint-style-guide.mmd
+```
+
+- [ ] **Step 2: Move paper/ subdirectory**
+
+```bash
+mv plotter_docs/preprint/paper/00-abstract.md preprint-abstract.md
+mv plotter_docs/preprint/paper/03-method.md preprint-method.md
+mv plotter_docs/preprint/paper/evaluation-event-functions.md preprint-evaluation-event-functions.md
+mv "plotter_docs/preprint/paper/glossary 1.md" preprint-glossary-old.md
+mv plotter_docs/preprint/paper/glossary-antipatterns.md preprint-glossary-antipatterns.md
+mv plotter_docs/preprint/paper/glossary.md preprint-glossary.md
+mv "plotter_docs/preprint/paper/kinda draft.md" preprint-kinda-draft.md
+mv plotter_docs/preprint/paper/related-work-citations.md preprint-related-work-citations.md
+mv plotter_docs/preprint/paper/wittgenstein-chomsky-conditions-ru.md preprint-wittgenstein-chomsky-conditions-ru.md
+mv plotter_docs/preprint/paper/wittgenstein-logic-as-conditions.md preprint-wittgenstein-logic-as-conditions.md
+```
+
+- [ ] **Step 3: Move sources/ (paper summaries → readings)**
+
+```bash
+mv plotter_docs/preprint/sources/brown-2020-gpt3.md read-brown-2020-gpt3.md
+mv plotter_docs/preprint/sources/freytag-1863-dramatic-structure.md read-freytag-1863-dramatic-structure.md
+mv plotter_docs/preprint/sources/genette-1980-narrative-discourse.md read-genette-1980-narrative-discourse.md
+mv plotter_docs/preprint/sources/index.md preprint-sources-index.md
+mv plotter_docs/preprint/sources/jang-2021-just-ask-generalization.md read-jang-2021-just-ask-generalization.md
+mv plotter_docs/preprint/sources/karpathy-2023-english-programming.md read-karpathy-2023-english-programming.md
+mv plotter_docs/preprint/sources/karpathy-2026-autoresearch.md read-karpathy-2026-autoresearch.md
+mv plotter_docs/preprint/sources/kojima-2022-zero-shot-cot.md read-kojima-2022-zero-shot-cot.md
+mv plotter_docs/preprint/sources/ramnath-2025-apo-survey.md read-ramnath-2025-apo-survey.md
+mv plotter_docs/preprint/sources/wei-2022-chain-of-thought.md read-wei-2022-chain-of-thought.md
+mv plotter_docs/preprint/sources/zhang-2025-seriesbench.md read-zhang-2025-seriesbench.md
+mv plotter_docs/preprint/sources/zhou-2022-least-to-most.md read-zhou-2022-least-to-most.md
+```
+
+Note: `TEMPLATE for paper summary.md` — already covered by `_tpl-reading.md`, delete it.
+
+- [ ] **Step 4: Move style/ subdirectory**
+
+```bash
+mv "plotter_docs/preprint/style/scientists for style.md" preprint-scientists-for-style.md
+mv plotter_docs/preprint/style/style-notes-dfw.md preprint-style-notes-dfw.md
+mv plotter_docs/preprint/style/style-notes-kaplan-scaling.md preprint-style-notes-kaplan-scaling.md
+mv plotter_docs/preprint/style/style-notes-quine.md preprint-style-notes-quine.md
+mv plotter_docs/preprint/style/style-notes-russell.md preprint-style-notes-russell.md
+mv plotter_docs/preprint/style/style-notes-sparks-of-agi.md preprint-style-notes-sparks-of-agi.md
+mv plotter_docs/preprint/style/style-notes-sutton-bitter-lesson.md preprint-style-notes-sutton-bitter-lesson.md
+mv plotter_docs/preprint/style/style-phrases-dfw.md preprint-style-phrases-dfw.md
+mv plotter_docs/preprint/style/style-phrases-kaplan-scaling.md preprint-style-phrases-kaplan-scaling.md
+mv plotter_docs/preprint/style/style-phrases-quine.md preprint-style-phrases-quine.md
+mv plotter_docs/preprint/style/style-phrases-russell.md preprint-style-phrases-russell.md
+mv plotter_docs/preprint/style/style-phrases-sparks-of-agi.md preprint-style-phrases-sparks-of-agi.md
+```
+
+- [ ] **Step 5: Add frontmatter**
+
+Preprint docs: `type: draft` or `type: note` or `type: ref`, `project: preprint`, `status: active`
+Paper summaries (read-*): `type: reading`, `project: preprint`, `status: active`
+Style notes: `type: style-analysis`, `project: preprint`, `status: active`
+
+- [ ] **Step 6: Delete TEMPLATE for paper summary.md**
+
+```bash
+rm "plotter_docs/preprint/sources/TEMPLATE for paper summary.md"
+```
+
+---
+
+### Task 10: Flatten knowledge/
+
+- [ ] **Step 1: Move maps/ → moc-* files**
+
+```bash
+cd /Users/nvashko/Projects/3-resources
+mv knowledge/maps/bibliography.md moc-bibliography.md
+mv knowledge/maps/llm-prompting.md moc-llm-prompting.md
+mv knowledge/maps/narrative-theory.md moc-narrative-theory.md
+mv knowledge/maps/tvplotlines-research.md moc-tvplotlines-research.md
+mv knowledge/maps/screenwriting-craft.md moc-screenwriting-craft.md
+mv knowledge/maps/writing-style.md moc-writing-style.md
+```
+
+- [ ] **Step 2: Move references/**
+
+```bash
+mv knowledge/references/01_extract_quotes.md knowledge-extract-quotes.md
+mv knowledge/references/2026-03-09-plotlines-knowledge-base-design.md knowledge-plotlines-kb-design.md
+mv knowledge/references/book-outlines.md knowledge-book-outlines.md
+mv knowledge/references/books2series-onepage.md knowledge-books2series-onepage.md
+mv knowledge/references/taxonomy-approach.md knowledge-taxonomy-approach.md
+mv "knowledge/references/Что делает Discourse для сериала.md" knowledge-discourse-for-serials.md
+mv knowledge/references/structure_sketch.yaml knowledge-structure-sketch.yaml
+```
+
+- [ ] **Step 3: Move plotlines-quotes/ JSON files**
+
+```bash
+mv knowledge/references/plotlines-quotes/douglas_writing_tv_drama.json knowledge-quotes-douglas.json
+mv knowledge/references/plotlines-quotes/landau_tv_showrunners.json knowledge-quotes-landau.json
+mv knowledge/references/plotlines-quotes/nash_savethecat_tv.json knowledge-quotes-nash.json
+mv knowledge/references/plotlines-quotes/pena_developing_series.json knowledge-quotes-pena.json
+mv knowledge/references/plotlines-quotes/venis_inside_the_room.json knowledge-quotes-venis.json
+```
+
+- [ ] **Step 4: Move prompting files**
+
+```bash
+mv "knowledge/propmpting/Boris Cherny pipeline.md" knowledge-boris-cherny-pipeline.md
+mv knowledge/propmpting/claude_pipline_prompt.md knowledge-claude-pipeline-prompt.md
+mv "knowledge/propmpting/xml tags.md" knowledge-xml-tags.md
+mv knowledge/propmpting/claude_best_practices.jpg knowledge-claude-best-practices.jpg
+mv knowledge/propmpting/claude_pipline_prompt.jpg knowledge-claude-pipeline-prompt.jpg
+```
+
+- [ ] **Step 5: Move books4style/ PDFs**
+
+```bash
+mv "knowledge/propmpting/books4style/A Supposedly Fun Thing Ill Never Do Again .pdf" "knowledge-pdf-dfw-supposedly-fun-thing.pdf"
+mv "knowledge/propmpting/books4style/Both Flesh and Not Essays.pdf" "knowledge-pdf-dfw-both-flesh-and-not.pdf"
+mv "knowledge/propmpting/books4style/Consider the Lobster And Other Essays (David Foster Wallace) .pdf" "knowledge-pdf-dfw-consider-the-lobster.pdf"
+mv "knowledge/propmpting/books4style/Fate, Time, and Language An Essay on Free Will ).pdf" "knowledge-pdf-dfw-fate-time-language.pdf"
+mv "knowledge/propmpting/books4style/From a Logical Point of View (Willard Van Orman Quine.pdf" "knowledge-pdf-quine-from-a-logical-point.pdf"
+mv "knowledge/propmpting/books4style/HDYVd4IaMAgWp2p.jpg" "knowledge-img-books4style.jpg"
+mv "knowledge/propmpting/books4style/Ontological relativity and other essays WVOQ.pdf" "knowledge-pdf-quine-ontological-relativity.pdf"
+mv "knowledge/propmpting/books4style/Russell(1905).pdf" "knowledge-pdf-russell-1905.pdf"
+mv "knowledge/propmpting/books4style/The Bitter Lesson.pdf" "knowledge-pdf-sutton-bitter-lesson.pdf"
+mv "knowledge/propmpting/books4style/The roots of reference the Paul Carus lectures (Quine, W. V) .pdf" "knowledge-pdf-quine-roots-of-reference.pdf"
+mv "knowledge/propmpting/books4style/Word and Object (Willard Van Orman Quine) .pdf" "knowledge-pdf-quine-word-and-object.pdf"
+```
+
+- [ ] **Step 6: Move remaining root files**
+
+```bash
+mv knowledge/program.md knowledge-autoresearch-program.md
+```
+
+- [ ] **Step 7: Delete obsolete infrastructure**
+
+These are replaced by Dataview + flat structure:
+
+```bash
+rm knowledge/registry.yaml
+rm knowledge/setup.sh
+rm knowledge/scripts/build_registry.py
+rm knowledge/CLAUDE.md
+rm knowledge/README.md
+rm knowledge/.gitignore
+```
+
+- [ ] **Step 8: Delete old template files**
+
+```bash
+rm knowledge/templates/concept.md
+rm knowledge/templates/style-analysis.md
+```
+
+- [ ] **Step 9: Add frontmatter to moved markdown files**
+
+MOC files: update existing frontmatter, add `status: active`
+Reference files: `type: ref`, `project: tvplotlines`, `status: active`
+Prompting files: `type: ref`, `project: tvplotlines`, `status: active`
+
+- [ ] **Step 10: Delete empty knowledge/ directory tree**
+
+```bash
+rm -rf /Users/nvashko/Projects/3-resources/knowledge
+```
+
+---
+
+### Task 11: Clean up plotter_docs/
+
+After tasks 7-9, all content has been moved out.
+
+- [ ] **Step 1: Verify nothing remains**
+
+```bash
+find /Users/nvashko/Projects/3-resources/plotter_docs -type f
+```
+
+Expected: no files (or only .DS_Store).
+
+- [ ] **Step 2: Delete empty directory tree**
+
+```bash
+rm -rf /Users/nvashko/Projects/3-resources/plotter_docs
+```
+
+---
+
+### Task 12: Add frontmatter to remaining files
+
+Files already in root that need frontmatter updates.
+
+- [ ] **Step 1: Update lessons.md**
+
+No frontmatter needed — this is a special file.
+
+- [ ] **Step 2: Handle screenshot**
+
+```bash
+mv "Screenshot 2026-03-16 at 22.57.02.png" tvplotlines-screenshot-2026-03-16.png
+```
+
+---
+
+### Task 13: Fix wikilinks
+
+- [ ] **Step 1: Find all wikilinks in migrated files**
+
+```bash
+grep -r '\[\[' /Users/nvashko/Projects/3-resources/*.md | grep -v node_modules
+```
+
+- [ ] **Step 2: Update each wikilink to match new filenames**
+
+Build old→new mapping from the mv commands above and do find-replace.
+
+- [ ] **Step 3: Verify no broken links**
+
+Use Obsidian's "Show broken links" or grep for `[[` and verify each target exists.
+
+---
+
+### Task 14: Final verification
+
+- [ ] **Step 1: Count files**
+
+```bash
+ls /Users/nvashko/Projects/3-resources/ | wc -l
+```
+
+Expected: ~140-160 files (no subdirectories except possibly empty ones).
+
+- [ ] **Step 2: Verify no subdirectories remain**
+
+```bash
+find /Users/nvashko/Projects/3-resources -type d -mindepth 1
+```
+
+Expected: no output.
+
+- [ ] **Step 3: Verify all markdown files have frontmatter**
+
+```bash
+for f in /Users/nvashko/Projects/3-resources/*.md; do
+  head -1 "$f" | grep -q '^---' || echo "MISSING: $f"
+done
+```
+
+Expected: only `lessons.md` and `README.md` reported.
+
+- [ ] **Step 4: Test Dataview queries in Obsidian**
+
+Open a MOC file and verify the Dataview query renders correctly.
+
+- [ ] **Step 5: Delete backup once satisfied**
+
+```bash
+rm -rf /Users/nvashko/Projects/3-resources-backup-2026-03-18
+```
diff --git a/docs/knowledge/archive/plans/resources-restructure-design.md b/docs/knowledge/archive/plans/resources-restructure-design.md
new file mode 100644
index 0000000..0e0c7be
--- /dev/null
+++ b/docs/knowledge/archive/plans/resources-restructure-design.md
@@ -0,0 +1,188 @@
+---
+type: spec
+project: tvplotlines
+status: active
+---
+
+# Design: 3-resources Flat Structure
+
+## Problem
+
+111 files in 30+ folders, up to 5 levels deep. Can't find anything.
+Templates scattered across 4 locations. No consistent frontmatter.
+Folder-based organization creates ever-growing nesting that doesn't
+match how the user actually navigates (sort by date, recall by name).
+
+## Solution
+
+One flat folder. No subfolders. YAML frontmatter for metadata.
+Dataview for navigation. Templater for consistent file creation.
+
+## Structure
+
+```
+3-resources/
+├── _tpl-document.md          ← template: universal work document
+├── _tpl-reading.md           ← template: paper notes (includes guide)
+├── _tpl-moc.md               ← template: map of content with Dataview
+├── _tpl-blog-post.md         ← template: blog post
+├── lessons.md                ← global lessons (no frontmatter change)
+├── tvplotlines-architecture.md
+├── tvplotlines-career-plan.md
+├── preprint-abstract.md
+├── read-wei-2022-chain-of-thought.md
+├── moc-narrative-theory.md
+└── ...
+```
+
+## Naming Convention
+
+**Work documents:** `project-descriptive-name.md`
+- `tvplotlines-architecture.md`
+- `preprint-positioning-strategy.md`
+- `zotero-mcp-plan.md`
+- `awesome-list-curation-criteria.md`
+- `github-io-blog-guide.md`
+
+**Readings:** `read-author-year-topic.md`
+- `read-wei-2022-chain-of-thought.md`
+- `read-tian-2024-turning-points.md`
+- `read-pianzola-2025-golem-ontology.md`
+
+**MOC:** `moc-topic.md`
+- `moc-narrative-theory.md`
+- `moc-tvplotlines-research.md`
+
+**Templates:** `_tpl-name.md`
+- `_tpl-document.md`
+- `_tpl-reading.md`
+- `_tpl-moc.md`
+- `_tpl-blog-post.md`
+
+## Frontmatter
+
+### Work documents
+
+```yaml
+---
+type: spec | plan | decision | note | draft | ref | concept | style-analysis
+project: tvplotlines | preprint | tvplotlines-app | zotero-mcp | awesome-list | github-io
+status: active | archived
+---
+```
+
+### Readings
+
+```yaml
+---
+type: reading
+title: "Full Paper Title"
+authors: [Last1, Last2, Last3]
+year: 2022
+tags: [topic1, topic2]
+project: tvplotlines
+status: active
+---
+```
+
+### MOC
+
+```yaml
+---
+type: moc
+tags: [topic1, topic2]
+status: active
+---
+```
+
+## Allowed Values
+
+### type
+`spec` | `plan` | `decision` | `note` | `draft` | `ref` | `concept` | `style-analysis` | `moc` | `reading`
+
+### project
+`tvplotlines` | `preprint` | `tvplotlines-app` | `zotero-mcp` | `awesome-list` | `github-io`
+
+New projects added to this list as needed.
+
+### status
+`active` | `archived`
+
+## Templates (4)
+
+### _tpl-document.md
+Universal template for all work documents. Templater prompts for
+`type` and `project` from allowed values lists.
+
+### _tpl-reading.md
+Paper notes template. Extended frontmatter (title, authors, year, tags).
+Body structure: Claim, Method & Evidence, Limitations, Relevance.
+Key principles from paper-summary-guide.md baked in as inline hints:
+- Self-contained (reader who never read the paper understands in 30s)
+- Own words, not theirs
+- Relevance section mandatory
+
+### _tpl-moc.md
+Map of Content. Frontmatter + pre-built Dataview query filtered by tags.
+
+### _tpl-blog-post.md
+Blog post template with hook, problem, literature, bridge, takeaway structure.
+
+## Templater Configuration
+
+- Template folder: `3-resources/` (filter by `_tpl-` prefix)
+- "Trigger Templater on new file creation": enabled for `3-resources/`
+- On new file: prompt user to pick template from list
+
+## Archival
+
+No `_archive/` folder. Set `status: archived` in frontmatter.
+Dataview queries filter by `status = "active"` by default.
+
+## Navigation
+
+Dataview queries replace manual MOC maintenance. Examples:
+
+All active tvplotlines documents:
+```
+TABLE type, file.cday as "Created"
+FROM "3-resources"
+WHERE project = "tvplotlines" AND status = "active"
+SORT file.cday DESC
+```
+
+All readings:
+```
+TABLE title, authors, year, project
+FROM "3-resources"
+WHERE type = "reading" AND status = "active"
+SORT year DESC
+```
+
+All plans across projects:
+```
+LIST
+FROM "3-resources"
+WHERE type = "plan" AND status = "active"
+SORT file.cday DESC
+```
+
+## CLAUDE.md Update
+
+Add to `/Users/nvashko/Projects/3-resources/CLAUDE.md`:
+- Naming convention rules
+- Allowed type/project values
+- Frontmatter requirement
+- "No subfolders" rule
+- Template list
+
+## Migration
+
+1. Create 4 templates in `3-resources/`
+2. Configure Templater in `.obsidian/plugins/templater-obsidian/data.json`
+3. Move all files from subfolders to `3-resources/` root, renaming per convention
+4. Add frontmatter to files that lack it
+5. Update wikilinks if any exist
+6. Delete empty subfolders
+7. Update CLAUDE.md
+8. Verify Dataview queries work
diff --git a/docs/knowledge/archive/plans/stability-benchmark.md b/docs/knowledge/archive/plans/stability-benchmark.md
new file mode 100644
index 0000000..d5d2ba7
--- /dev/null
+++ b/docs/knowledge/archive/plans/stability-benchmark.md
@@ -0,0 +1,116 @@
+---
+type: spec
+project: tvplotlines
+status: active
+---
+
+# Stability Benchmark Specification
+
+## Goal
+
+Demonstrate that tvplotlines's pipeline produces stable, reproducible storyline analyses. The key claim for the preprint: "a single run is representative of what the pipeline would produce on repeated execution."
+
+## Why this matters
+
+LLM outputs are non-deterministic (temperature=0 reduces but doesn't eliminate variance). If storyline assignments shift dramatically between runs, the tool's analysis is unreliable. We need to quantify the variance.
+
+## Metric: Adjusted Rand Index (ARI)
+
+ARI compares two clusterings without requiring label alignment — ideal for storyline analysis where storyline IDs may differ between runs, but the groupings should be consistent.
+
+- **Input:** For each run, build a vector of (episode, character) → storyline assignments.
+- **Comparison:** ARI between all pairs of runs.
+- **Scale:** ARI=1.0 identical, ARI=0.0 random, ARI<0 worse than random.
+
+Implementation: `tvplotlines.metrics.compute_consistency_ari()` — already exists in the library.
+
+## Success criteria
+
+| Metric | Threshold | Meaning |
+|--------|-----------|---------|
+| Mean ARI per show | ≥ 0.70 | Good reproducibility |
+| Min ARI per show | ≥ 0.50 | No catastrophic divergence |
+| Mean coverage per show | ≥ 0.90 | ≤10% unassigned events |
+
+### If criteria are not met
+
+- **ARI < 0.50:** Investigate. Likely cause: Pass 1 voting produces different storyline sets across runs. Fix: increase voting rounds or add structural constraints.
+- **ARI 0.50–0.70:** Acceptable with caveat in preprint. Document which storylines diverge — likely low-confidence (inferred) lines.
+- **Coverage < 0.90:** Investigate orphan assignment. May need stronger Pass 2 prompts.
+
+## Benchmark set
+
+5 shows chosen for franchise type diversity and episode count range:
+
+| Show | Code | Episodes | Franchise type | Rationale |
+|------|------|----------|---------------|-----------|
+| True Detective S01 | TD | 8 | serial | Small, clean serial narrative |
+| Breaking Bad S01 | BB | 7 | serial | Classic, complex character arcs |
+| House S01 | HOUSE | 22 | procedural | Long, case-of-week + serialized B/C |
+| Game of Thrones S01 | GOT | 10 | ensemble | Many equal storylines |
+| This Is Us S01 | TIU | 18 | hybrid | Episodic + throughline mix |
+
+Total: 65 episodes across 5 runs = 325 Pass 2 calls + 25 Pass 1 + 25 Pass 0 + 25 Pass 3.
+
+## Cost estimate
+
+- Pass 2 (dominant cost): ~$0.013/episode (Sonnet, cached system prompt)
+- 325 episodes × $0.013 = ~$4.23
+- Batch mode (50% discount): ~$2.12
+- Passes 0/1/3 overhead: ~$1.00
+- **Total estimate: $3–5 in batch mode**
+
+## Protocol
+
+1. For each show, run pipeline 5 times with identical input.
+2. Save each run's TVPlotlinesResult as JSON.
+3. Compute pairwise ARI across all 5 runs (10 pairs per show).
+4. Compute coverage per run.
+5. Report: mean ARI, min ARI, coverage range, storyline count range.
+
+## Results (2026-03-15)
+
+Two full runs of 5 shows × 5 runs each + 1 run of SP × 5. Total: ~55 pipeline executions.
+
+### Run 1 (before unassigned validation fix)
+
+| Show | Mean ARI | Min ARI | Coverage | Storylines | Pass? |
+|------|----------|---------|----------|------------|-------|
+| TD | 0.884 | 0.715 | 1.000 | 4-5 | PASS |
+| BB | 0.682 | 0.508 | 1.000 | 4-5 | **FAIL** |
+| HOUSE | 1.000 | 1.000 | 1.000 | 10 | PASS |
+| GOT | 0.904 | 0.820 | 0.992 | 7-8 | PASS |
+| TIU | 0.866 | 0.849 | 1.000 | 6-10 | PASS |
+
+### Run 2 (after removing unassigned events validation from Pass 2)
+
+| Show | Mean ARI | Min ARI | Coverage | Storylines | Pass? |
+|------|----------|---------|----------|------------|-------|
+| TD | 0.884 | 0.810 | 1.000 | 4 | PASS |
+| BB | 0.767 | 0.666 | 1.000 | 4-6 | PASS |
+| HOUSE | 0.917 | 0.859 | 1.000 | 9-11 | PASS |
+| GOT | 0.940 | 0.893 | 1.000 | 8-9 | PASS |
+| TIU | 0.899 | 0.856 | 0.999 | 6-8 | PASS |
+
+### SP (separate run, Russian language)
+
+| Show | Mean ARI | Min ARI | Coverage | Storylines | Pass? |
+|------|----------|---------|----------|------------|-------|
+| SP | 0.920 | 0.898 | 0.998 | 6-7 | PASS |
+
+### Analysis
+
+**Coverage:** Near-perfect (0.992–1.000) across all shows. The `assign_orphan_events()` postprocessing effectively handles unassigned events.
+
+**Consistency by franchise type:**
+- **Procedural (HOUSE):** Highest — distinct storylines per character, clear A/B/C hierarchy. ARI 0.917–1.000.
+- **Serial (TD, SP):** High — clear narrative threads. ARI 0.884–0.920.
+- **Ensemble (GOT):** High — many characters with distinct goals. ARI 0.904–0.940.
+- **Hybrid (TIU):** High — mix of episodic and serial. ARI 0.866–0.899.
+- **Serial with intertwined drivers (BB):** Lowest — one character (Walt) drives multiple storylines with ambiguous boundaries. ARI 0.682–0.767.
+
+**BB instability:** Storyline count is stable (4-6), so Pass 1 voting works. The variance is in Pass 2 event assignment: "Walt lies to Skyler" could be empire (hiding the business) or family (protecting the family). This is genuinely ambiguous, not a pipeline bug.
+
+**Comparison to baseline:** autoresearch v1 baseline on SP was ARI 0.595. Current result: 0.920. Improvement from voting in Pass 1, autoresearch prompt optimization (49 experiments), and code audit fixes.
+
+**Actual cost:** ~$0.20–0.50 per run (batch mode, Sonnet with caching). Full benchmark (55 runs): ~$15–20 total.
diff --git a/docs/knowledge/archive/plans/synthetic-audience-testing.md b/docs/knowledge/archive/plans/synthetic-audience-testing.md
new file mode 100644
index 0000000..7562da6
--- /dev/null
+++ b/docs/knowledge/archive/plans/synthetic-audience-testing.md
@@ -0,0 +1,37 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# Synthetic Audience Testing — тестирование контента на симулированной аудитории
+
+## Идея
+
+Продукт для креаторов/блогеров: загружаешь контент (пост, видео, pitch) → AI-сгенерированные персоны зрителей оценивают его → получаешь обратную связь до публикации.
+
+## Откуда взялось
+
+- **Moloch's Bargain** (Stanford, 2026): эксперимент показал, что 20 GPT-4o mini персон (каждая с характером киноперсонажа) реалистично оценивают engagement. Модель, дообученная на их фидбэке, побеждала в 57.5% случаев.
+- **Largo AI**: купили компанию, симулирующую зрительскую реакцию на фильмы. Но это для студий с бюджетами, не для креаторов.
+
+## Концепция продукта
+
+- **Подписка**: в базовую входит набор персон (5-10 типов аудитории)
+- **Докупаешь**: больше персон, кастомные персоны ("мой зритель — женщина 35+, интересуется...")
+- **Тестируешь**: загрузил контент → получил реакции, комментарии, оценки от синтетических зрителей
+- **Итерируешь**: переделал → тестируешь снова
+
+## Почему реализуемо сейчас
+
+- GPT-4o mini / Qwen — дёшево генерировать персонажей-зрителей
+- Open-weights модели позволяют держать себестоимость низкой
+- Moloch's Bargain доказал: синтетическая аудитория реально различает engaging vs не-engaging контент
+
+## Открытые вопросы
+
+- **Платёжеспособность:** заплатит ли блогер $10-30/мес за предварительное тестирование контента? Или это нужно только тем, у кого уже есть аудитория 100K+ и цена ошибки высока?
+- **Достоверность:** Moloch's Bargain показал что оптимизация на engagement увеличивает дезинформацию. Нужны ли guardrails ("этот пост победит, но содержит манипуляцию")?
+- **Конкуренция с интуицией:** опытные креаторы и так чувствуют свою аудиторию. Для кого продукт ценнее — для новичков или для тех кто выходит на новую аудиторию?
+- **Связь с Largo AI:** они делают то же для кино. Можно ли позиционироваться как "Largo AI для креаторов" или нужна другая ниша?
+- **Связь с tvplotlines:** синтетическая аудитория, которая оценивает нарративную структуру (не просто "нравится/не нравится", а "арка персонажа не завершена", "конфликт не раскрыт") — это пересечение обеих идей.
diff --git a/docs/knowledge/archive/plans/tasks-todo.md b/docs/knowledge/archive/plans/tasks-todo.md
new file mode 100644
index 0000000..5c9c3c2
--- /dev/null
+++ b/docs/knowledge/archive/plans/tasks-todo.md
@@ -0,0 +1,284 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# TODO: Pipeline Resilience
+
+## Контекст
+
+Autoresearch-эксперименты потеряны из-за OAuth-аутажа API (2026-03-14). Пайплайн all-in-memory, all-or-nothing — краш в любой точке = перезапуск всех LLM-вызовов. Pass 2 (N episode calls) — самый дорогой шаг. Batch mode теряет batch ID при падении процесса. Сетевые ошибки и rate limits мгновенно крашат пайплайн.
+
+**Цель:** Пайплайн переживает API brownouts, не нарушая контракт библиотеки (без disk I/O, backward compatible, opt-in сложность).
+
+**Принцип:** Библиотека не крашится без нужды (retry, timeout, partial success). Библиотека никогда не пишет файлы. Персистенция — выбор вызывающего через callbacks или передачу промежуточных результатов.
+
+---
+
+## Step 1: Network resilience (`llm.py` — internal, no API change)
+
+### 1a. Transient error retry with backoff
+
+- [x] Добавить константы `_MAX_NETWORK_RETRIES = 3`, `_BACKOFF_BASE = 2.0`
+- [x] Добавить `_transient_exceptions() -> tuple` — lazy-cached, собирает retryable exceptions из установленных SDK
+- [x] Обернуть `_araw_call` в `_araw_call_with_retry()` с exponential backoff
+- [x] Заменить вызов `_araw_call` внутри `acall_llm` на `_araw_call_with_retry`
+- [x] Существующий ValueError retry loop остаётся нетронутым
+
+### 1b. Request timeout
+
+- [x] Добавить поле `timeout: float = 120.0` в `LLMConfig`
+- [x] Передавать в SDK клиенты (anthropic: `httpx.Timeout`, openai: `timeout=`)
+
+### 1c. Partial success in parallel mode
+
+- [x] `acall_llm_parallel`: `asyncio.gather(*tasks, return_exceptions=True)`
+- [x] Retry failed tasks individually, preserve successful results
+
+---
+
+## Step 2: Callbacks (new file + `pipeline.py`)
+
+### 2a. PipelineCallback base class
+
+- [x] Создать `src/tvplotlines/callbacks.py` с 6 callback-методами (all no-op by default)
+
+### 2b. Wire callbacks into pipeline
+
+- [x] `callback: PipelineCallback | None = None` в `get_plotlines()`
+- [x] `_fire()` helper — try/except обёртка для callback-вызовов
+- [x] Sequential mode: `on_episode_complete` после каждого эпизода
+- [x] All modes: `on_pass2_complete` после всех эпизодов
+
+### 2c. Export
+
+- [x] `PipelineCallback` добавлен в `__all__`
+
+---
+
+## Step 3: Resume from pre-computed inputs (`pipeline.py`)
+
+- [x] Optional параметры `cast`, `plotlines`, `breakdowns` в `get_plotlines()`
+- [x] Валидация: cast/plotlines вместе, breakdowns length match
+- [x] Post-processing всегда запускается (даже с пре-supplied breakdowns)
+
+---
+
+## Step 4: Batch resilience (`llm.py` + `pass2.py` + `pipeline.py`)
+
+### 4a. Batch ID callback
+
+- [x] `on_batch_submitted` param в `acall_llm_batch` и sync wrapper `call_llm_batch`
+- [x] Fire сразу после `client.messages.batches.create()`
+
+### 4b. Resume from batch ID
+
+- [x] `batch_id` param в `acall_llm_batch` и sync wrapper
+- [x] Skip batch creation when provided
+
+### 4c. Batch polling timeout
+
+- [x] `_BATCH_TIMEOUT = 3600`, raises `TimeoutError`
+
+### 4d. Pass through from pipeline
+
+- [x] `pass2.py`: `assign_events_batch` passes through `batch_id`, `on_batch_submitted`
+- [x] `pipeline.py`: batch mode wires `callback.on_batch_submitted`
+
+---
+
+## Верификация
+
+- [x] 54 existing tests pass (zero regressions)
+- [x] Network retry — 3 tests: retries on transient, raises after max, backoff delays
+- [x] Partial gather — 1 test: preserves successful, retries failed
+- [x] Callbacks — 2 tests: default no-op, subclass receives events
+- [x] Resume validation — 3 tests: cast/plotlines together, breakdowns length
+- [x] Batch timeout — 1 test: TimeoutError after short timeout
+- [x] Batch callback — 1 test: on_batch_submitted fires with batch ID
+- [x] Integration — full run + resume with RecordingCallback (3 episodes, sequential, $0.09)
+
+**Total: 65 unit + 2 integration tests, all green.**
+
+---
+
+# Code Audit (2026-03-15)
+
+## Critical (fix now)
+
+- [x] **`text` uninitialized in retry loop** (`llm.py`) — initialized `text = ""` before loop, removed broken `dir()` check
+- [x] **`pass2_mode` silent fallthrough** (`pipeline.py`) — explicit `elif "sequential"`, else `raise ValueError`
+- [x] **`KeyError` bypasses LLM retry** (`pass1.py`, `pass2.py`, `pass3.py`) — wrapped `_parse_*` in `KeyError` → `ValueError` conversion; added explicit check for `v["action"]` in pass3
+- [x] **`TVPlotlinesResult.usage` undeclared** (`models.py`) — added `usage: str = ""` field
+
+## Important (fix soon)
+
+- [x] **Client not closed on error** (`llm.py`) — wrapped all 3 client functions (`_acall_anthropic`, `_acall_openai`, `acall_llm_batch`) in `try/finally: await client.close()`
+- [x] **`batch_id` silently ignored** (`pipeline.py`) — added `ValueError` if `batch_id` set with `pass2_mode != "batch"`
+- [x] **Parallel retry unprotected** (`llm.py`) — wrapped individual retry in `try/except`, raises `RuntimeError` with context instead of losing successful results
+- [x] **`validators[i]` no bounds check** (`llm.py`) — added length validation at entry of both `acall_llm_parallel` and `acall_llm_batch`
+- [x] **`validate_ranks` mutate-then-flag order** (`postprocess.py`) — separated flag collection from rank mutation; demotions applied after all rules evaluated
+- [x] **`""` vs `None` for unassigned events** (`metrics.py`) — normalized to truthy check in `compute_coverage` and `compute_consistency_ari`, consistent with `assign_orphan_events` and `compute_weight`
+
+## Low priority (document or defer)
+
+- [x] **Global `usage` singleton** (`llm.py`) — added TODO comment documenting the limitation. Fix deferred: requires threading UsageStats through LLMConfig or call chain. Not a problem in current single-threaded usage.
+- [x] **`on_episode_complete` dead in parallel mode** — documented in callbacks.py docstring, architecture.md table, and code example. Explicit "sequential mode only" everywhere.
+- [x] **`compute_consistency_ari` first-wins bias** (`metrics.py`) — replaced first-wins with Counter-based most-frequent storyline per character per episode
+- [x] **`rank="runner"` overlaps `type="runner"`** (`models.py`) — documented: type=continuity mode, rank=screen time. Usually co-occur but can diverge (e.g. runner-type promoted to rank B).
+
+---
+
+## Review
+
+**Backward compatibility:** полная. Все новые параметры optional, 54 старых теста без регрессий.
+
+**Library contract:** соблюдён. Без disk I/O, персистенция через callbacks.
+
+**Tradeoffs:**
+- `_transient_cache` — module-level mutable global. Допустимо, альтернативы не проще.
+- `_fire()` глотает все исключения — правильно для resilience, компенсировано `logger.exception`.
+
+**Не покрыто тестами:** batch resume e2e, parallel callback order, buggy callback survival. Низкий риск.
+
+**Процесс:** нарушен workflow (без plan mode, без верификации). Урок записан в lessons.md.
+
+---
+
+# TODO: PARA + Knowledge Base
+
+## PARA-реструктуризация
+
+- [x] Создать PARA-папки (1-projects, 2-areas, 3-resources, 4-archive)
+- [x] Переместить проекты в PARA-структуру
+- [x] Мигрировать Claude memory на новый путь (16 файлов)
+- [x] Проверить CLAUDE.md в проектах (tvplotlines, books2series — OK, устаревшие пути только в deprecated/archive)
+- [x] Проверить git status во всех репозиториях — OK
+
+## Knowledge Base — Фаза 0: Инфраструктура
+
+- [x] `git init` в `3-resources/knowledge/`, branch main
+- [x] Структура: maps/, notes/, templates/, scripts/, _sources/
+- [x] .gitignore (_sources/, .obsidian/, .DS_Store)
+- [x] setup.sh — симлинки на 6 источников (readings, concepts, preprint, style, app-research, prompting)
+- [x] CLAUDE.md и README.md
+- [x] Шаблоны: paper.md, concept.md, style-analysis.md
+
+## Knowledge Base — Фаза 1: Индексирование
+
+- [x] Написать scripts/build_registry.py (скан папок → registry.yaml)
+- [x] Запустить — 161 файл проиндексирован (67 readings + 48 concepts + 35 app-research + 6 style + 3 preprint + 2 prompting)
+- [x] Создать 6 MOC файлов в maps/ (narrative-theory, screenwriting-craft, llm-prompting, writing-style, tvplotlines-research, bibliography)
+
+## Knowledge Base — Фаза 2: YAML в tvplotlines файлах
+
+- [x] 3 файла в preprint-sources/ (brown, kojima, zhang) — type, title, authors, year, venue, tags, zotero, relevance
+- [x] 6 файлов style-notes/style-phrases — type, author, work, year, tags
+- [x] Обновить preprint-sources/index.md — добавлен MOC frontmatter
+- [x] Пересобрать registry.yaml — frontmatter подхвачен
+
+## Чтение статей для препринта
+
+- [x] Brown et al. 2020 — GPT-3
+- [x] Kojima et al. 2022 — Zero-Shot-CoT
+- [x] Zhang et al. 2025 — SeriesBench
+- [ ] Wei et al. 2022 — Chain-of-Thought Prompting
+- [ ] Zhou et al. 2022 — Least-to-Most Prompting
+- [ ] Eric Jang — Generalization in Deep Learning (blog)
+- [ ] Пост Карпатого про autoresearch
+
+---
+
+# TODO: Stability Benchmark
+
+**Цель:** Доказать что pipeline выдаёт стабильные, воспроизводимые результаты. Ключевая метрика для препринта: "one run is representative".
+
+**Метрика:** Adjusted Rand Index (ARI) — сравнивает кластеризацию (character → storyline) между парами запусков. ARI=1.0 — идентично, ARI>0.7 — хорошо, ARI<0.5 — проблема.
+
+**Критерии успеха:**
+- Mean ARI ≥ 0.70 по каждому шоу
+- Coverage ≥ 0.90 по каждому шоу (≤10% unassigned events)
+- Ни одно шоу не ниже ARI 0.50
+
+**При провале:** ARI < 0.50 → исследовать промпты (Pass 1 voting нестабилен? Pass 2 assignment diverges?). ARI 0.50–0.70 → допустимо, но нужна оговорка в препринте.
+
+## Benchmark set: 5 шоу
+
+Выбраны по разнообразию franchise_type и размеру:
+
+| Show | Episodes | Franchise type | Почему |
+|------|----------|---------------|--------|
+| TD (True Detective) | 8 | serial | Маленький, чистый serial narrative |
+| BB (Breaking Bad) | 7 | serial | Классика, сложные арки |
+| HOUSE | 22 | procedural | Длинный, case-of-week + serialized B/C |
+| GOT (Game of Thrones) | 10 | ensemble | Много равноправных линий |
+| TIU (This Is Us) | 18 | hybrid | Эпизодические + сквозные линии |
+
+**Оценка стоимости:** ~73 эпизодов × 5 runs = 365 LLM calls (Pass 2) + 5×5 Pass 1 + 5×5 Pass 0 + 5×5 Pass 3. При $0.013/episode (Sonnet, cached) ≈ **$6–8 total**. Batch mode = 50% дешевле ≈ **$3–4**.
+
+---
+
+## Task 0: Написать спеку
+
+- [ ] Создать `3-resources/knowledge/specs/stability-benchmark.md` — что измеряем, почему ARI, критерии, бюджет, шоу
+- [ ] Commit в knowledge
+
+## Task 1: Написать benchmark script
+
+- [ ] Создать `tvplotlines-app/data/scripts/benchmark_stability.py`:
+  - CLI: `python benchmark_stability.py --show TD --runs 5 --mode batch`
+  - Для каждого run: `get_plotlines()` → сохранить result JSON
+  - После всех runs: `compute_consistency_ari()` + `compute_coverage()` для каждого run
+  - Вывод: таблица (show, run, coverage, storyline_count) + mean ARI + per-pair ARI matrix
+  - Сохранить результаты в `tvplotlines-app/data/results/benchmark/`
+- [ ] Commit
+
+## Task 2: Dry-run (1 шоу, 2 runs)
+
+- [ ] Запустить `benchmark_stability.py --show TD --runs 2 --mode sequential`
+- [ ] Проверить что скрипт работает, результаты сохраняются, ARI вычисляется
+- [ ] Проверить стоимость одного run (из usage output)
+- [ ] Записать фактическую стоимость в спеку
+
+## Task 3: Полный benchmark (5 шоу × 5 runs)
+
+- [ ] Запустить batch mode для каждого шоу: TD, BB, GOT, TIU, HOUSE
+- [ ] Между шоу: проверять что batch завершился, результаты валидны
+- [ ] Если какой-то run упал — использовать resume (batch_id или pre-computed inputs)
+
+## Task 4: Анализ результатов
+
+- [ ] Собрать таблицу: show × (mean ARI, min ARI, mean coverage, storyline count range)
+- [ ] Проверить критерии успеха (ARI ≥ 0.70, coverage ≥ 0.90)
+- [ ] Если ARI < 0.70: исследовать — какие storylines diverge? Pass 1 voting нестабилен?
+- [ ] Записать результаты в спеку
+- [ ] Commit всех результатов
+
+---
+
+# TODO: APO Experiments — systematic prompt optimization
+
+**Контекст:** Survey Ramnath et al. 2025 описывает 21 метод автоматической оптимизации промптов. Наш autoresearch loop — кустарный аналог. Нужно проверить: дают ли systematic methods лучший результат.
+
+**Два эксперимента:**
+
+## Experiment 1: SCULPT — оптимизация длинных промптов
+
+SCULPT (Kumar et al., 2024) оптимизирует длинные structured промпты через hierarchical tree. Наши промпты (8-11KB, role→rules→format→examples) — natural fit.
+
+- [ ] Прочитать оригинальную статью SCULPT
+- [ ] Проверить есть ли open-source реализация
+- [ ] Применить к Pass 2 промпту (самый дорогой, самый длинный) — оценить по coverage × ARI
+- [ ] Сравнить результат с текущим промптом и autoresearch-оптимизированным
+- [ ] Записать результаты
+
+## Experiment 2: DSPy/MIPRO — pipeline как program
+
+DSPy (Khattab et al., 2024) + MIPRO: Bayesian optimization для multi-stage LLM pipelines. Нужен refactoring — описать Pass 0→1→2→3 как DSPy modules.
+
+- [ ] Описать pipeline как DSPy program (Pass0 → Pass1 → Pass2 → Pass3)
+- [ ] Определить signatures для каждого module (input/output types)
+- [ ] Запустить MIPRO optimizer с нашей метрикой (coverage × ARI)
+- [ ] Сравнить оптимизированные промпты с текущими
+- [ ] Оценить: стоит ли переходить на DSPy или оставить текущую архитектуру
diff --git a/docs/knowledge/archive/plans/what-to-change.md b/docs/knowledge/archive/plans/what-to-change.md
new file mode 100644
index 0000000..65d6390
--- /dev/null
+++ b/docs/knowledge/archive/plans/what-to-change.md
@@ -0,0 +1,35 @@
+---
+type: plan
+project: tvplotlines
+status: active
+date: 2026-03-23
+---
+
+# To decide 
+
+1. add option to write synopsis for the series name provided based on onlien content using [[tvplotlines-synopsis-authoring-protocol]]? 
+
+## Code before pass 0
+1. input for the function might be complicated list [str]? what is the convention here? should i explain how to prepare the input?
+## Pass 0
+1. franchise type - autodetected, no reason to leave for user to provide 
+2. franchise type - finalise the list with definitions in glossary 
+3. also i would not kill pass 0 yet and leave it to ablation autoresearch 
+4. decide if collect genre and format - does not seem we have any use of it... also genre is a free format so it will be hard to analyse consistently 
+	franchise_type: str     # "procedural" | "serial" | "hybrid" | "ensemble"
+    story_engine: str       # one sentence — the show's story-generation mechanism
+    genre: str              # "drama", "thriller", "comedy"
+    format: str | None      # "anthology" | "limited" | "ongoing"
+5. usage: str                            # token usage summary - when it is calculated? how we could show the data - how much in tockens each pass costs and total sum 
+6. 
+
+## Code after Pass 0
+## Pass 1
+
+## Code after Pass 1
+## Pass 2
+## Code after Pass 2
+## Pass 3
+## Code after Pass 3
+
+## Results 
\ No newline at end of file
diff --git a/docs/knowledge/archive/plans/write-synopses-plan.md b/docs/knowledge/archive/plans/write-synopses-plan.md
new file mode 100644
index 0000000..7629fee
--- /dev/null
+++ b/docs/knowledge/archive/plans/write-synopses-plan.md
@@ -0,0 +1,207 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# write-synopses — план реализации утилиты
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** CLI-утилита `tvplotlines write-synopses` — по названию шоу и номеру сезона получает описания эпизодов из Wikipedia, переписывает их по протоколу (`synopsis-authoring-protocol.md`) через LLM, сохраняет в файлы.
+
+**Architecture:** Wikipedia API (season page) → beautifulsoup4 (парсинг `wikiepisodetable`) → LLM parallel (один вызов на эпизод) → отдельные файлы `S01E01.txt` или combined file. Fallback: `--from-files` — пользователь указывает сырые описания, утилита только переписывает по протоколу.
+
+**Tech Stack:** httpx (HTTP-клиент), beautifulsoup4 (парсинг HTML), существующий LLM-клиент из tvplotlines (`acall_llm_parallel`).
+
+---
+
+## Принципы
+
+- CLI-утилита, **не часть библиотечного API** — `__init__.py` не импортирует и не экспортирует
+- Optional dependency: `pip install tvplotlines[writer]` ставит httpx + beautifulsoup4. Поисковый API не нужен — Wikipedia API с правильным page title отдаёт данные напрямую
+- Паттерн httpx: `try/except ImportError` в `cli.py`
+- Источник данных: Wikipedia API (бесплатный, легальный, без API-ключа)
+- User-Agent: `tvplotlines/{version} (https://github.com/BirdInTheTree/tvplotlines)` — Wikipedia требует корректный User-Agent, иначе 403
+
+## Решения
+
+- **LLM-вызовы:** parallel (один вызов на эпизод, через `acall_llm_parallel`). Batch API не подходит — пользователь ждёт результат интерактивно
+- **`--lang`:** да, с дефолтом `en`. Определяет язык Wikipedia (`en.wikipedia.org` vs `ru.wikipedia.org`)
+- **Формат вывода:** два режима:
+  - `-o synopses/` (директория) → отдельные файлы `S01E01.txt`, `S01E02.txt` — для `tvplotlines run synopses/*.txt --show House --season 1`
+  - `-o house_s01.txt` (файл) → один combined файл с header + episode delimiters — для `tvplotlines run house_s01.txt`
+  - Определяется автоматически: путь заканчивается на `/` или существующая директория → отдельные файлы, иначе → combined
+- **Промпт:** перевод и адаптация `3-resources/tvplotlines/synopsis-authoring-protocol.md` (русский → английский, формат ROLE/CONTEXT/RULES/OUTPUT)
+- **Тип шоу:** optional `--format procedural|serial|hybrid|limited`. Определяет beat counts в промпте (протокол задаёт разные для procedural/serial/ensemble). Если не указан — LLM определяет сам
+
+## Wikipedia: структура данных
+
+Нужны **season pages**, не list pages. `List of X episodes` — без описаний. Описания есть на страницах типа `House_(season_1)`, `Breaking_Bad_(season_1)`.
+
+HTML-структура консистентная:
+- Таблица: `wikitable wikiepisodetable`
+- Строка эпизода: `tr.module-episode-list-row`
+- Название: `td.summary`
+- Описание: следующий `tr.expand-child` → `td.description`
+
+Описания — 300–1400 символов (3–8 предложений). Достаточно для LLM-переписывания.
+
+## Обработка ошибок Wikipedia
+
+- **Страница не найдена (404):** попробовать оба варианта naming convention (`Show_(season_N)` и `Show_season_N`). Если оба 404 — понятная ошибка: `Page not found. Try --wiki-title "Exact_Page_Title" (check Wikipedia URL)`
+- **Таблица без описаний:** если `td.description` пустые или отсутствуют — ошибка: `No episode descriptions found on this page. Use --from-files with raw synopsis files instead`
+- **Описания слишком короткие (< 50 символов):** warning, но продолжить (LLM справится)
+- **Сетевые ошибки:** retry с exponential backoff (как в `llm.py`), максимум 3 попытки
+
+## Типы данных
+
+```python
+class RawEpisode(TypedDict):
+    number: int       # 1, 2, 3...
+    title: str        # "Pilot"
+    description: str  # Raw Wikipedia description
+```
+
+Используется вместо `list[dict]` для явного контракта.
+
+## Файловая структура
+
+### Новые файлы
+
+- `src/tvplotlines/write_synopses.py` — Wikipedia API + парсинг + LLM-переписывание
+- `src/tvplotlines/prompts_en/write_synopses.md` — промпт для LLM
+- `tests/test_write_synopses.py` — тесты
+- `tests/fixtures/wikipedia_house_s01.html` — мок HTML для тестов
+
+### Изменения в существующих файлах
+
+- `cli.py` — добавить команду `write-synopses` с `try/except ImportError`
+- `pyproject.toml` — добавить `writer = ["httpx>=0.27", "beautifulsoup4>=4.12"]`
+
+## Поток работы утилиты
+
+```
+tvplotlines write-synopses "House" --season 1 -o synopses/
+tvplotlines write-synopses "House" --season 1 --lang en -o synopses/
+```
+
+1. **Resolve:** конструирует page title `{Show}_(season_{N})`. Если 404 — пробует `{Show}_season_{N}` (оба формата встречаются). Если оба 404 — ошибка с подсказкой `--wiki-title`
+2. **Fetch:** Wikipedia API `action=parse`, page=resolved title → HTML
+3. **Parse:** bs4 извлекает episode titles + descriptions из `wikiepisodetable`
+4. **LLM:** parallel — каждый эпизод переписывается по протоколу (один вызов на эпизод)
+5. **Save:** если `-o` — директория → `synopses/S01E01.txt`, ...; если файл → combined format:
+   ```
+   House, Season 1
+
+   Episode 1 — Pilot
+   Synopsis text...
+
+   Episode 2 — Paternity
+   Synopsis text...
+   ```
+
+### Fallback: `--from-files`
+
+```
+tvplotlines write-synopses "House" --season 1 --from-files raw/*.txt -o synopses/
+```
+
+Пропускает шаги 1-2, берёт сырые описания из файлов, только переписывает через LLM.
+
+## Оценка стоимости
+
+**Вход:** описание из Wikipedia — 300-1400 символов (~100-400 токенов).
+**Промпт:** ~2000 токенов (system prompt из протокола).
+**Выход:** 300-500 слов (~400-650 токенов).
+
+**На один эпизод:** ~2500 input + ~500 output токенов.
+**Сезон 22 серии (House) на claude-haiku-4-5:** 55K input × $0.80/M + 11K output × $4.0/M ≈ **$0.09**
+**Сезон 22 серии на claude-sonnet-4:** 55K × $3.0/M + 11K × $15.0/M ≈ **$0.33**
+**Batch mode (−50%):** haiku ~$0.05, sonnet ~$0.17.
+
+Поиск бесплатный (Wikipedia API).
+
+### `--dry-run`
+
+Добавить флаг `--dry-run`: выполняет шаги 1-2 (fetch + parse), показывает найденные эпизоды и оценку стоимости, не вызывает LLM. Позволяет проверить что Wikipedia-страница найдена правильно.
+
+## Стратегия тестирования
+
+### Unit-тесты с мок-данными
+
+- **Парсинг HTML:** сохранить реальный HTML `House_(season_1)` в `tests/fixtures/wikipedia_house_s01.html`. Тесты проверяют: правильное количество эпизодов, заполненные titles и descriptions, корректные номера эпизодов.
+- **Wikipedia API:** мок httpx-ответа. Тесты проверяют: правильный URL формируется, ошибки обрабатываются (404, таймаут, нет таблицы).
+- **LLM-переписывание:** мок `acall_llm_parallel`. Тесты проверяют: промпт формируется правильно, результаты сохраняются в файлы с правильными именами.
+- **Combined output:** тест что `-o file.txt` создаёт один файл с header `Show, Season N` и episode delimiters `Episode N — Title`, совместимый с `input_parser.parse_synopsis_file()`.
+
+### Тест формата выхода
+
+- Валидация синопсиса: plain text (без markdown), 300-500 слов, без bullet points, без подзаголовков. Это проверяется на мок-ответах LLM.
+
+### Интеграционный тест
+
+- Реальный вызов на `House S01` (требует сеть + API-ключ, запускается вручную, не в CI).
+
+## Задачи
+
+### Task 1: Промпт `write_synopses.md`
+
+**Files:**
+- Create: `src/tvplotlines/prompts_en/write_synopses.md`
+- Source: `3-resources/tvplotlines/synopsis-authoring-protocol.md`
+
+- [ ] Адаптировать `synopsis-authoring-protocol.md` в LLM-промпт
+- [ ] Формат: ROLE → CONTEXT → RULES → OUTPUT (как pass0.md, pass1.md)
+- [ ] Вход: сырое описание эпизода + название шоу + номер сезона + номер эпизода
+- [ ] Выход: синопсис по протоколу (300-500 слов, 8-15 beats, plain text)
+- [ ] Commit
+
+### Task 2: Wikipedia парсер
+
+**Files:**
+- Create: `src/tvplotlines/write_synopses.py` (функции для Wikipedia)
+- Create: `tests/fixtures/wikipedia_house_s01.html` (мок HTML)
+- Create: `tests/test_write_synopses.py`
+
+- [ ] Функция `fetch_season_page(show: str, season: int, lang: str = "en") -> str` — получить HTML season page через Wikipedia API
+- [ ] Функция `parse_episode_table(html: str) -> list[RawEpisode]` — извлечь эпизоды из `wikiepisodetable`
+- [ ] Скачать реальный HTML `House_(season_1)` в `tests/fixtures/wikipedia_house_s01.html`
+- [ ] Тесты: парсинг мок-HTML → правильное количество эпизодов, заполненные описания
+- [ ] Commit
+
+### Task 3: LLM-переписывание + основная функция
+
+**Files:**
+- Modify: `src/tvplotlines/write_synopses.py`
+- Modify: `tests/test_write_synopses.py`
+
+- [ ] Функция `rewrite_synopses(episodes: list[RawEpisode], show: str, season: int, config: LLMConfig) -> list[str]` — parallel LLM-вызов через `acall_llm_parallel`
+- [ ] Функция `write_synopses(show, season, output_dir, *, from_files=None, lang="en", provider, model, base_url)` — основной entry point
+- [ ] Режим Wikipedia: fetch → parse → rewrite → save
+- [ ] Режим `--from-files`: read files → rewrite → save
+- [ ] Save: отдельные файлы (если `-o` — директория) или combined file (если `-o` — файл). Combined format: `Show, Season N\n\nEpisode 1 — Title\ntext\n\n...`
+- [ ] Загрузка промпта через `load_prompt("write_synopses")`
+- [ ] Тесты с мок LLM-ответами
+- [ ] Commit
+
+### Task 4: CLI интеграция
+
+**Files:**
+- Modify: `src/tvplotlines/cli.py`
+- Modify: `pyproject.toml`
+
+- [ ] Добавить `writer = ["httpx>=0.27", "beautifulsoup4>=4.12"]` в `[project.optional-dependencies]`
+- [ ] Добавить команду `write-synopses` в `cli.py`
+- [ ] Аргументы: `show` (positional), `--season` (default 1), `-o/--output` (dir), `--from-files` (glob), `--wiki-title` (exact Wikipedia page title, fallback для disambiguации), `--format` (procedural/serial/hybrid/limited, optional), `--lang` (default "en"), `--dry-run`, `--provider`, `--model`, `--base-url`
+- [ ] `try/except ImportError` при вызове `_write_synopses(args)` с сообщением: `pip install tvplotlines[writer]`
+- [ ] Ручной тест: `tvplotlines write-synopses --help`
+- [ ] Commit
+
+### Task 5: Интеграционный тест
+
+- [ ] Запустить `tvplotlines write-synopses "House" --season 1 -o /tmp/synopses/`
+- [ ] Проверить что файлы `S01E01.txt` ... `S01E22.txt` создались
+- [ ] Проверить формат: 300-500 слов, prose, без bullet points
+- [ ] Проверить `--from-files` режим на тестовых fixtures
+- [ ] Commit финальный
diff --git a/docs/knowledge/decisions/decision-001-context-before-extraction.md b/docs/knowledge/decisions/decision-001-context-before-extraction.md
new file mode 100644
index 0000000..00beeed
--- /dev/null
+++ b/docs/knowledge/decisions/decision-001-context-before-extraction.md
@@ -0,0 +1,45 @@
+---
+type: decision
+project: tvplotlines
+status: active
+---
+
+# ADR-001: Определять контекст сериала до экстракции линий
+
+## Статус
+Принято
+
+## Контекст
+В mas4bw (оригинал Balestri & Pescatore) экстракция арок начинается сразу, без понимания что за сериал перед нами. Результат: в "Слово пацана" S01 извлечено 25 арок (10 Anthology, 7 Soap, 8 Genre-Specific), хотя в реальности основных линий 3.
+
+## Решение
+Ввести Шаг 0 — автоматическое определение контекста сериала перед экстракцией:
+
+**0a. Franchise type** (procedural / serialized / hybrid)
+- Определяет СТРУКТУРУ ожидаемых линий
+- Procedural → A-story закрытая (case-of-week), B/C сериализованные
+- Serialized → все линии сквозные
+- Hybrid → A закрытая + B/C сквозные
+
+**0b. Story engine** (что генерирует эпизоды)
+- Определяет КАКИЕ линии искать
+- Case-of-week engine → линия расследования/пациента/дела
+- Transformation machine → линия трансформации героя
+- Relationship engine → линии отношений
+
+Также определяется жанр и формат.
+
+## Варианты
+1. **Пользователь задаёт контекст вручную** — точнее, но требует экспертизы
+2. **ИИ определяет автоматически** — удобнее, один дополнительный LLM-вызов
+3. **Оба варианта** ← выбрано. Автоопределение по умолчанию, ручной ввод как override
+
+## Почему именно так
+- Без контекста экстрактор не знает сколько линий ожидать и какого типа
+- Один LLM-вызов на все синопсисы сразу — дёшево
+- Ручной override нужен когда пользователь знает лучше (или для тестирования)
+
+## Последствия
+- `get_plotlines()` возвращает `TVPlotlinesResult` с полем `context` — пользователь видит что определилось
+- Шаги экстракции получают контекст как параметр и адаптируют промпты
+- Промпты для экстракции должны учитывать franchise type (разные ожидания для разных типов)
diff --git a/docs/knowledge/decisions/decision-002-no-internal-state.md b/docs/knowledge/decisions/decision-002-no-internal-state.md
new file mode 100644
index 0000000..2ed35c3
--- /dev/null
+++ b/docs/knowledge/decisions/decision-002-no-internal-state.md
@@ -0,0 +1,40 @@
+---
+type: decision
+project: tvplotlines
+status: active
+---
+
+# ADR-002: Никакого скрытого состояния внутри библиотеки
+
+## Статус
+Принято
+
+## Контекст
+В mas4bw шаг 2 графа экстракции открывает сессию SQLite и читает ранее найденные арки из базы данных. Также `initialize_state` читает 4 файла с диска. Это делает код непереносимым: нельзя вызвать как функцию, нужен работающий SQLite + файловая система.
+
+## Решение
+Библиотека — чистая функция. Всё на вход, всё на выход. Внутри нет:
+- Базы данных (SQLite, ChromaDB)
+- Чтения/записи файлов
+- Скрытого состояния между вызовами
+- Веб-сервера
+
+Пользователь подаёт ВСЕ синопсисы сезона в один вызов `get_plotlines()`. Функция сама проходит эпизоды последовательно и накапливает линии in-memory. Состояние живёт только во время вызова и не сохраняется между вызовами.
+
+## Варианты
+1. **Встроенная БД** (как в mas4bw) — удобно для приложения, невозможно для библиотеки
+2. **Файловый кэш** — неявная зависимость от файловой системы
+3. **`known_plotlines` параметр** — перекладывает сложность на пользователя, он не хочет этим заниматься
+4. **Весь сезон в один вызов, состояние in-memory** ← выбрано
+
+## Почему именно так
+- Библиотеку можно вызвать из Jupyter notebook, из CLI, из веб-сервера, из другой библиотеки
+- Пользователь контролирует хранение (может вообще не хранить)
+- Тестируемость: вход → выход, без side effects
+- Урок из техаудита mas4bw: два места привязки к инфраструктуре — главный блокер для переиспользования
+
+## Последствия
+- Пользователь подаёт весь сезон одним вызовом — проще некуда
+- Внутри функция сама итерирует по эпизодам и накапливает контекст
+- Нет персистентного состояния — каждый вызов независим
+- Инкрементальная обработка (серия за серией) — возможный low-level API в будущем, не приоритет
diff --git a/docs/knowledge/decisions/decision-003-abc-classification.md b/docs/knowledge/decisions/decision-003-abc-classification.md
new file mode 100644
index 0000000..5203b00
--- /dev/null
+++ b/docs/knowledge/decisions/decision-003-abc-classification.md
@@ -0,0 +1,37 @@
+---
+type: decision
+project: tvplotlines
+status: active
+---
+
+# ADR-003: Классификация A/B/C вместо anthology/soap/genre
+
+## Статус
+Принято
+
+## Контекст
+Оригинал (Balestri & Pescatore) использует академическую классификацию арок: Anthology, Soap, Genre-Specific. На практике это приводит к проблемам: в "Слово пацана" 10 из 25 арок помечены как Anthology, хотя anthology arcs в обычных сериалах почти не бывает.
+
+## Решение
+Использовать индустриальную классификацию сюжетных линий:
+- **A-line** — основная жанровая линия (определяется story engine)
+- **B-line** — отношения / soap
+- **C-line** — побочная (soap или genre в зависимости от сериала)
+
+Источники: Nash "Save the Cat Writes for TV", Douglas "Writing the TV Drama Series".
+
+## Варианты
+1. **Оставить anthology/soap/genre** — академически корректно, практически бесполезно
+2. **A/B/C storylines** ← выбрано — так думают сценаристы и продюсеры
+3. **Своя гибридная таксономия** — overcomplicated
+
+## Почему именно так
+- Сценаристы и шоураннеры мыслят в терминах A/B/C, не anthology/soap/genre
+- A/B/C напрямую связаны с franchise type: в procedural A = case-of-week, в serialized A = сквозная
+- Меньше категорий → меньше ошибок классификации
+- Базируется на индустриальных книгах, а не академической теории
+
+## Последствия
+- Промпты пишутся в терминах A/B/C
+- `Plotline.label` принимает значения "A", "B", "C", "D" (если линий больше трёх)
+- `Plotline.type` описывает характер линии ("main", "relationship", "procedural") — это дополнение, не замена label
diff --git a/docs/knowledge/decisions/decision-004-no-language-parameter.md b/docs/knowledge/decisions/decision-004-no-language-parameter.md
new file mode 100644
index 0000000..c8bd5ae
--- /dev/null
+++ b/docs/knowledge/decisions/decision-004-no-language-parameter.md
@@ -0,0 +1,37 @@
+---
+type: decision
+project: tvplotlines
+status: active
+---
+
+# ADR-004: Без параметра языка — вход определяет выход
+
+## Статус
+Принято
+
+## Контекст
+Первоначально API предполагал параметр `language` (или `output_language`). Но зачем? Если пользователь подаёт синопсисы на русском — он хочет результат на русском. Если на немецком — на немецком.
+
+## Решение
+Никакого параметра языка. LLM определяет язык входа и отвечает на нём же. В промпте: "Respond in the same language as the input."
+
+```python
+# Просто
+result = get_plotlines(episodes=["синопсис 1", "синопсис 2", ...])
+```
+
+## Варианты
+1. **`language="en"` обязательный** — ограничивает аудиторию, добавляет сложность
+2. **`output_language` отдельно от входа** — зачем? кому нужны синопсисы на русском с ответом на английском?
+3. **Без параметра, язык = язык входа** ← выбрано
+
+## Почему именно так
+- Минимальный API — меньше параметров, проще пользоваться
+- Не ограничивает аудиторию одним-двумя языками
+- LLM справляется с определением языка без подсказок
+- Синопсисы можно искать на любом доступном языке — библиотека работает со всеми
+
+## Последствия
+- Промпты пишутся language-agnostic: "Respond in the same language as the input"
+- Не нужны отдельные файлы промптов для EN/RU (как в mas4bw)
+- Если пользователю нужен другой язык выхода — это edge case, пусть переводит сам
diff --git a/docs/knowledge/decisions/decision-005-pass3-narratologist-review.md b/docs/knowledge/decisions/decision-005-pass3-narratologist-review.md
new file mode 100644
index 0000000..c2eac13
--- /dev/null
+++ b/docs/knowledge/decisions/decision-005-pass3-narratologist-review.md
@@ -0,0 +1,150 @@
+---
+type: decision
+project: tvplotlines
+status: active
+---
+
+# ADR-005: Pass 3 — ревизия нарратолога
+
+## Статус
+Проектирование
+
+## Контекст
+Pass 2 генерирует патчи (ADD_LINE, CHECK_LINE, SPLIT_LINE, RERANK) — обратную связь о проблемах в списке линий из Pass 1. Сейчас патчи собираются, но не применяются.
+
+Первоначальный план — перезапустить Pass 1 с учётом патчей. Проблемы:
+- Дорого: повторная обработка всех синопсисов
+- Рискованно: LLM может сломать то, что уже правильно
+- Реактивно: работает только с тем, что Pass 2 заметил
+
+## Решение
+Отдельный Pass 3 с ролью **нарратолога** — «второе мнение» от другого взгляда.
+
+### Три пасса — три взгляда
+- **Pass 0** — генералист (контекст сериала)
+- **Pass 1 + Pass 2** — аналитик (линии + события)
+- **Pass 3** — критик/нарратолог (ревизия результата)
+
+### Что видит нарратолог
+- Линии + каст (Pass 1)
+- События по эпизодам (Pass 2)
+- Computed span и weight (пост-обработка)
+- Патчи из Pass 2 как *подсказки*, не как задания
+- Story engine и franchise type для контекста
+
+### Какие вопросы задаёт
+Не «проверь на ошибки», а теоретические вопросы:
+- У каждой линии есть driver → goal → obstacle → stakes? Если нет — это не storyline, а thread
+- Арка полная? setup без escalation — мертворождённая линия
+- Два storyline с одним driver и смежными целями — одна линия с фазами?
+- Computed weight = "primary", rank = "C" — кто прав?
+- Franchise type = hybrid, но нет episodic-линии — что-то не так
+- ADD_LINE: реально новая линия, или ошибка привязки события?
+
+### Выход — вердикты (не патчи)
+Вердикты достаточно конкретны, чтобы код применил их механически:
+- `MERGE(line_x → line_y)` — все события line_x → line_y
+- `REASSIGN(event, → line_z)` — точечное переназначение
+- `PROMOTE/DEMOTE(line, new_rank)` — смена ранга
+- `CREATE(new_line {driver, goal, ...}, events: [...])` — новая линия + какие события ей принадлежат
+- `DROP(line, redistribute: {event → line, ...})` — удаление линии с перераспределением событий
+
+### Применение
+Код применяет вердикты к линиям и событиям. Без повторного Pass 1 или Pass 2.
+
+RERANK можно вычислить кодом (из весов) до Pass 3 — нарратолог его не касается.
+
+### Ограничения
+- Один вызов LLM, один раунд ревизии
+- Если после Pass 3 остаются нерешённые вопросы — оставляем как есть с `confidence: "inferred"`
+
+## Метрики качества пайплайна
+
+Две метрики, считаются вместе как один score:
+
+- **Coverage** — доля нарративных событий из синопсиса, попавших хоть в одну линию (`storyline != null`). Считается из выхода Pass 2.
+- **Consistency** — одинаковые синопсисы дают одинаковые линии при разных запусках. Измеряется через ARI (см. ниже).
+
+Формула: **score = coverage × consistency**
+
+Мультипликативная, чтобы нельзя было оптимизировать одно за счёт другого. Coverage = 1.0 при consistency = 0.3 → score = 0.3.
+
+### Consistency через ARI (Adjusted Rand Index)
+
+Наша задача — сравнение кластеризаций. Каждый запуск пайплайна — это кластеризация: события распределяются по линиям (кластерам). Названия линий могут отличаться между запусками («belonging» vs «acceptance»), но структура — какие события оказались вместе — сравнима.
+
+**ARI (Adjusted Rand Index)** — стандартная метрика для сравнения двух кластеризаций без учёта названий кластеров. Диапазон: -0.5..1.0, где 1.0 = идентичные кластеризации, 0.0 = случайное совпадение, <0 = хуже случайного. Реализация: `sklearn.metrics.adjusted_rand_score`, одна строчка.
+
+**Источники:**
+- Оригинальная работа: Hubert & Arabie, 1985 — «Comparing partitions» (Journal of Classification)
+- Применение к LLM: Guven et al., 2024 — «LLM Stability: A detailed analysis with some surprises» (arxiv:2408.04667) — TAR (Total Agreement Rate) для стабильности LLM-выходов
+- Wang et al., 2023 — «Self-Consistency Improves Chain of Thought Reasoning» (ICLR, arxiv:2203.11171) — принцип: несколько запусков + majority vote
+- Manakul et al., 2023 — «SelfCheckGPT» (EMNLP, arxiv:2303.08896) — консистентность как прокси для фактологичности
+
+### Два уровня измерения consistency
+
+Это не "или-или" — это разные уровни точности за разную цену:
+
+**Уровень 1: Структурная consistency — ARI через сетку (эпизод × персонаж)**
+- Якорь: для каждой пары (эпизод, персонаж) — в какой линии он оказался
+- Сетка фиксирована между запусками (персонажи и эпизоды не меняются)
+- Грубее, но интерпретируемее и бесплатно считается
+- Реализация: `sklearn.metrics.adjusted_rand_score`
+
+**Уровень 2: Семантическая consistency — STED + Hungarian matching**
+- STED (arxiv 2512.23712, ноябрь 2025) — фреймворк для оценки consistency structured output LLM. Различает *expression variations* ("belonging" vs "acceptance" — это ок) и *semantic drift* (реально разный результат). Robustness 0.981 для парафраз vs наивный DeepDiff 0.805.
+- Hungarian matching (scipy.optimize.linear_sum_assignment) — optimal assignment между наборами линий
+- Embeddings каждой линии → Hungarian → среднее cosine similarity по matched парам
+- Точнее, но дороже (нужны embeddings)
+
+**Стратегия:** начать с уровня 1 (быстро, бесплатно). Подключить уровень 2 когда ARI перестанет различать.
+
+**Почему не другие якоря для ARI:**
+- Номера предложений синопсиса — ненадёжно: одно событие = несколько предложений, LLM склеивает
+- Embedding matching → ARI — это фактически Hungarian matching с лишним шагом
+
+**Дополнительные метрики (при необходимости):**
+- AMI (Adjusted Mutual Information) — информационно-теоретический аналог ARI
+- V-Measure — разделяет homogeneity (чистота кластеров) и completeness (полнота)
+
+### Автоматическая оптимизация промптов (по мотивам autoresearch)
+
+Идея из [karpathy/autoresearch](https://github.com/karpathy/autoresearch): AI-агент в цикле модифицирует код → запускает эксперимент → проверяет метрику → оставляет или откатывает → повторяет. Человек пишет `program.md` (инструкции агенту), а не код.
+
+**Адаптация для tvplotlines:**
+
+| autoresearch | tvplotlines |
+|---|---|
+| Модифицируемый файл: `train.py` | Модифицируемые файлы: промпты `pass{0,1,2,3}.md` |
+| Метрика: `val_bpb` (ниже = лучше) | Метрика: `score = coverage × consistency(ARI)` (выше = лучше) |
+| Один прогон: 5 мин (GPU) | Один прогон: ~3 мин (API) |
+| Логирование: `results.tsv` | Логирование: `results.tsv` |
+| Цикл: изменил → запустил → измерил → keep/discard | Тот же цикл |
+
+**Структура program.md для tvplotlines:**
+1. Setup — прочитать архитектуру, промпты, snapshot
+2. Constraints — менять только промпты, не код пайплайна
+3. Metric — `score = coverage × consistency(ARI)`, выше = лучше
+4. Loop — изменил промпт → прогнал N раз → вычислил score → keep/discard
+5. Logging — TSV: commit, score, coverage, consistency, status, description
+
+**Ограничения:** каждый прогон стоит денег (API). Для consistency нужно N запусков (минимум 3). Один эксперимент = 3×3 мин = ~10 мин + ~$1-2. За ночь ~50 экспериментов, не 100 как у Karpathy.
+
+Pass 3 (нарратолог) при этом — и этап пайплайна, и качественный индикатор: много тяжёлых вердиктов = Pass 1/2 сработали плохо.
+
+## Что нужно проверить
+1. Достаточно ли контекста нарратологу без сырых синопсисов? (видит только линии + события + span/weight)
+2. Хватит ли одного вызова, или объём данных (все эпизоды, все линии, все события) не влезет в контекст?
+3. Формат вердиктов: сможет ли LLM стабильно генерировать структурированные операции (MERGE, REASSIGN, CREATE)?
+4. Применение вердиктов кодом: покрывают ли 5 операций все реальные кейсы?
+5. Качество: действительно ли «второе мнение» улучшает результат vs просто добавляет шум?
+
+## Следующие шаги
+- ✅ Получить snapshot результата Pass 1 + Pass 2 на «Слове пацана» (fixture)
+- ✅ Написать промпт Pass 3
+- Написать код Pass 3 (вызов LLM + парсинг вердиктов)
+- Написать код применения вердиктов к линиям и событиям
+- Прогнать Pass 3 на snapshot, оценить качество вердиктов
+- Реализовать вычисление coverage (из snapshot)
+- Реализовать вычисление consistency (N запусков → сравнение)
+- Написать program.md для autoresearch-цикла
diff --git a/docs/knowledge/prompting/how-to-prompt.md b/docs/knowledge/prompting/how-to-prompt.md
new file mode 100644
index 0000000..7bd1709
--- /dev/null
+++ b/docs/knowledge/prompting/how-to-prompt.md
@@ -0,0 +1,11 @@
+  **Главный** **принцип:** **LLM** **уже** **знает** **предмет.** **Промт** **не** **учит** **—** **промт** **направляет.**
+1. **Не** **объясняй** **базовые** **вещи** **—** **задавай** **систему** **координат.** Модель прочла миллион текстов про сюжеты, персонажей и конфликты. Она знает, что такое "конфликт". Ей объяснить, что конкретно ТЫ имеешь в виду под "driver" и чем это отличается от того, что она могла бы подумать по умолчанию. _(Mitchell_ _2025:_ _LLM_ _=_ _мешок_\n  _эвристик;_ _промт_ _организует,_ _какие_ _эвристики_ _активировать.)_
+ 2. **Формулируй** **конкретно,** **не** **абстрактно.** "Что конкретно мешает персонажу получить\n  то, что он хочет? Другой человек? Обстоятельство? Внутренний страх?" работает\n  лучше, чем "определите obstacle—препятствие на пути к цели". Конкретные\n  формулировки запускают более глубокую обработку. _(Pecher_ _&_ _Zwaan_ _2005:_ _понимание_ _= _мысленная_ _симуляция_ _ситуации,_ _а_ _не_ _поиск_ _определения_ _в_ _словаре._ _Конкретные_  _описания_ _запускают_ _эту_ _симуляцию.)_  
+3. **Объясняй** **ЗАЧЕМ,** **а** **не** **только** **ЧТО.** Промт "определи franchise type: procedural,  serial, hybrid, ensemble" хуже, чем промт, который объясняет: "тип формата  определяет ритм ожиданий зрителя—в процедурале каждую неделю новое дело, в  сериале нарастающая дуга". Когда модели дают антропологическое рассуждение (почему это понятие важно, как оно связано с контекстом), результат улучшается.  _(AlKhamissi_ _2024:_ _anthropological_ _prompting_ _—_ _объяснение_ _"зачем"_ _улучшает_  _культурное_ _выравнивание,_ _особенно_ _для_ _нетипичных_ _случаев.)_ 
+4. **Язык** **промта** **имеет** **значение** **—** **это** **не** **просто** **перевод.** Промт на русском активирует другой набор знаний модели, чем промт на английском. Русскоязычный промт для  анализа русского сериала может дать другие (потенциально лучше подходящие)  результаты. _(AlKhamissi_ _2024:_ _модель_ _хранит_ _культурные_ _знания_ _вместе_ _с_ _языком,_ _на_  _котором_ _они_ _были_ _в_ _обучающих_ _данных._ _Арабский_ _промт_ _для_ _вопросов_ _про_ _Египет_  _работает_ _лучше_ _английского.)_  
+5. **Давай** **модели** **роль** **—** **но** **содержательную,** **а** **не** **декоративную.** "Ты—story editor  голливудского сериала" работает не потому что модель "вживается в роль", а потому  что активирует конкретный набор нарративных эвристик (как думает story editor).  Роль должна быть конкретной и релевантной задаче, не просто "ты эксперт". _(Winston_ _2011/2017:_ _Dr._ _Jekyll_ _/_ _Mr._ _Hyde_ _—_ _один_ _набор_ _правил_ _видит_ _месть,_ _другой_ _—_  _безумие._ _Роль_ _=_ _набор_ _правил.)_  
+6. **Компенсируй** **естественные** **предпочтения** **модели.** LLM по умолчанию тяготеет к стилю (тон, атмосфера, авторский голос), а не к структуре (события, причины, связи).  Если задача—структурный анализ, промт должен явно направлять модель на  структуру. _(Jung_ _2026:_ _LLM_ _выбирают_ _стилистические_ _ограничения_ _на_ _67%_ _чаще,_ _чем_  _событийные._ _Это_ _"природная"_ _склонность,_ _которую_ _промт_ _должен_ _преодолевать.)_
+7. **Используй** **теорию** **как** **словарь,** **а** **не** **как** **инструкцию.** Промт работает лучше, когда  он даёт модели набор конкретных понятий (что искать и как называть), а не общую  инструкцию (проанализируй). _(Piper_ _&_ _Bagga_ _2024:_ _15_ _нарратологических_ _понятий_  _Женетта_ _→_ _15_ _простых_ _вопросов_ _для_ _LLM_ _→_ _точность_ _до_ _100%_ _на_ _некоторых_ _из_ _них._\n  _Теория_ _→_ _словарь_ _→_ _промт_ _=_ _операция_ _enculturation.)_  
+8. **Проверяй,** **а** **не** **доверяй.** Промт может заставить модель "подыгрывать"—давать  ответы, которые выглядят правильно, но основаны на поверхностных паттернах, а не  на реальном анализе. Нужна верификация: контрольные вопросы, перекрёстные  проверки, сравнение результатов нескольких прогонов. _(Pawar_ _2025:_ _модели_ _реагируют_ _на_ _социодемографические_ _подсказки,_ _но_ _эффект_ _может_ _быть_ _артефактом._ _Mitchell_  _2025:_ _за_ _"пониманием"_ _может_ _стоять_ _мешок_ _эвристик,_ _который_ _ломается_ _в_ _нестандартных_ _ситуациях.)_  
+9. **Ближний** **контекст** **важнее** **далёкого.** Мозг (и модель) лучше всего работает с  текущим и 1–2 предыдущими предложениями. Для длинных текстов лучше разбивать на  части и анализировать по частям, а потом собирать общую картину. _(Yu_ _et_ _al._ _2024:_  _пик_ _корреляции_ _модели_ _с_ _мозгом_ _—_ _при_ _1–2_ _предшествующих_ _предложениях,_ _потом_  _снижение.)_  
+10. **Разные** **модели** **—** **разные** **"авторы".** GPT тяготеет к стилю, Claude—к  когерентности, Gemini—к абстрактным концепциям. Промт, оптимизированный под одну модель, может не работать с другой. _(Jung_ _2026:_ _каждая_ _модель_ _имеет_ _характерный_  _"авторский_ _профиль"_ _—_ _предпочтения_ _по_ _событиям,_ _стилю,_ _персонажам_ _и_ _сеттингу.)_
diff --git a/docs/knowledge/prompting/prompt-template.md b/docs/knowledge/prompting/prompt-template.md
new file mode 100644
index 0000000..2a6de4f
--- /dev/null
+++ b/docs/knowledge/prompting/prompt-template.md
@@ -0,0 +1,98 @@
+---
+type: spec
+project: tvplotlines
+status: active
+---
+
+# Prompt Template
+
+Unified structure for all pipeline prompts (pass0, pass1, pass2, pass3). Every prompt follows the same 7 sections in the same order.
+
+Definitions come from `tvplotlines-glossary.md` — the glossary is the ground truth. Prompts include only the definitions relevant to their pass.
+
+## Principles
+
+1. Don't explain basics — set the coordinate system. LLM already knows what "conflict" is. Tell it what YOU mean by "plotline" (how-to-prompt rule 1).
+2. Be concrete, not abstract. "What specifically blocks the hero?" not "define the obstacle" (rule 2).
+3. Explain WHY, not just WHAT. "Format determines what plotlines to expect" not just "classify the format" (rule 3).
+4. Theory as vocabulary, not instruction. Give terms to look for, not general instructions to "analyze" (rule 7).
+5. Definitions with examples = strongest single component (GoLLIE, Sainz 2024: +5.4 F1).
+6. Code validates — don't repeat in prompt what code checks (Qiu 2025: code validation +11.7pp, prompt rules +1.1pp).
+
+## Template
+
+```
+# ROLE
+Who you are. 1-2 sentences.
+Why this perspective matters for the task.
+Example: "You are a story editor analyzing a TV season. Your job is to
+identify parallel storylines, not to evaluate quality or suggest improvements."
+
+# CONTEXT
+What you receive. Where it comes from. What prior passes already determined.
+Example: "You receive all episode synopses for one season, plus the SeriesContext
+from Pass 0 (format, story_engine). Your task builds on this context."
+
+# GLOSSARY
+Definitions of terms used in THIS pass. From tvplotlines-glossary.md.
+Only include what this pass needs — don't dump the whole glossary.
+Each definition must have:
+  - what it is (concrete, not abstract)
+  - examples (real shows)
+  - counter-examples ("not a plotline: ...")
+
+# TASK
+What to do, step by step.
+"First read all synopses. Then identify the cast. Then extract plotlines.
+For each plotline, fill in Story DNA (hero, goal, obstacle, stakes)."
+Understand before extract (Wang 2023).
+
+# RULES
+Constraints. Edge cases. What NOT to do.
+- Granularity rules (one goal = one plotline)
+- Order rules (functions sequence)
+- "When in doubt" rules (don't create, don't invent)
+- Format-specific rules (procedural: 1 case_of_the_week; limited: all resolve)
+
+# OUTPUT
+JSON schema. Field names, types, enums.
+One worked example — full JSON for a real show (Breaking Bad S01).
+Reasoning BEFORE JSON output, not after (Wei 2022).
+
+# VALIDATION
+What code will check after your response. So you know:
+- what will be caught automatically (don't waste effort)
+- what code can't check (you must get right)
+Example: "Code checks: JSON schema, enum values, hero references cast ID.
+Code cannot check: whether Story DNA makes narrative sense — that's your job."
+```
+
+## Section-specific notes
+
+### ROLE
+- pass0: "You are determining the structural pattern of a TV series."
+- pass1: "You are a story editor identifying parallel storylines in a TV season."
+- pass2: "You are assigning events to storylines within a single episode."
+- pass3: "You are a narratologist reviewing the complete season structure."
+
+### GLOSSARY per pass
+- pass0: format, is_ensemble, is_anthology, story_engine, genre
+- pass1: Story DNA (hero, goal, obstacle, stakes), plotline, type, rank, nature, confidence, prior season status (CONTINUES/TRANSFORMED/ENDED)
+- pass2: event, function (7 functions + order rules), interaction (3 types), patch (4 types), also_affects
+- pass3: verdict (7 actions), weight, span, arc_completeness, monotonicity
+
+### VALIDATION per pass
+- pass0: format enum, is_ensemble bool, is_anthology bool, story_engine non-empty
+- pass1: type enum, rank enum, nature enum, confidence enum, hero → cast ID, A-rank count matches format
+- pass2: function enum, plotline → pass1 ID, characters → cast ID, interaction type enum, patch action enum
+- pass3: verdict action enum, MERGE/REASSIGN/PROMOTE/DEMOTE/CREATE/DROP/REFUNCTION field validation
+
+## References
+
+- Wang 2023, Plan-and-Solve: "first understand the problem and devise a plan"
+- Sainz 2024, GoLLIE: definitions with representative examples = strongest component
+- Qiu 2025, Blueprint First: code validation between LLM calls = +11.7pp
+- Wei 2022, Chain-of-Thought: reasoning before output
+- Zwaan 1993: genre label switches comprehension strategy
+- Anthropic docs: XML tags for section boundaries, queries at the bottom
+- tvplotlines-how-to-prompt.md: 10 principles for writing prompts
diff --git a/docs/knowledge/prompting/prompt-writing-rules.md b/docs/knowledge/prompting/prompt-writing-rules.md
new file mode 100644
index 0000000..c216696
--- /dev/null
+++ b/docs/knowledge/prompting/prompt-writing-rules.md
@@ -0,0 +1,38 @@
+---
+type: spec
+project: tvplotlines
+status: active
+tags: [prompt-engineering]
+---
+
+# Prompt Writing Rules
+
+Lessons from rewriting pass0–pass3 prompts. Use as checklist for future prompts.
+
+## Process
+1. Glossary — ground truth. Definitions written once, prompts reference them.
+2. Original text — keep as much as possible. Change only what changed in logic.
+3. Every term defined before it is used.
+
+## Structure
+- ROLE → CONTEXT → GLOSSARY → TASK → RULES → OUTPUT → VALIDATION
+- GLOSSARY = definitions (what it means). TASK = steps (what to do). RULES = constraints (what not to do). Don't mix them.
+- No repeats between GLOSSARY and TASK. Definition lives in one place.
+
+## Role
+- One role for the whole pipeline: story editor.
+- Difference per pass — what the story editor is doing right now (reading first episodes / mapping the season / breaking down an episode / reviewing the full picture).
+
+## Language
+- How people talk, not how documentation reads. "Figure out" not "determine". "Pick the template" not "select the appropriate template".
+- No "See X above" — either repeat inline or don't reference.
+- Don't rewrite in your own words what's already well written in the original.
+
+## VALIDATION
+- Explicitly separate: what code checks (enum, references, schema) vs what LLM is responsible for (meaning, quality, completeness).
+- Business rules from GLOSSARY/RULES must be duplicated in VALIDATION (e.g. rank=null for runner).
+
+## Definitions
+- Concrete, not abstract. With examples and counter-examples.
+- Explain WHY (format → "tells us what plotlines to look for"), not just WHAT.
+- If an attribute is used downstream — say how (confidence → "inferred plotlines won't be flagged").
diff --git a/docs/knowledge/results/bb-s01-result.json b/docs/knowledge/results/bb-s01-result.json
new file mode 100644
index 0000000..54a1754
--- /dev/null
+++ b/docs/knowledge/results/bb-s01-result.json
@@ -0,0 +1,1813 @@
+{
+  "context": {
+    "franchise_type": "serial",
+    "story_engine": "A high school teacher builds a drug empire, testing how far he'll go for family and control",
+    "genre": "drama",
+    "format": "ongoing"
+  },
+  "cast": [
+    {
+      "id": "walt",
+      "name": "Walter White",
+      "aliases": [
+        "Walt",
+        "Heisenberg",
+        "Mr. White",
+        "Walter"
+      ]
+    },
+    {
+      "id": "jesse",
+      "name": "Jesse Pinkman",
+      "aliases": [
+        "Jesse"
+      ]
+    },
+    {
+      "id": "skyler",
+      "name": "Skyler White",
+      "aliases": [
+        "Skyler"
+      ]
+    },
+    {
+      "id": "hank",
+      "name": "Hank Schrader",
+      "aliases": [
+        "Hank"
+      ]
+    },
+    {
+      "id": "tuco",
+      "name": "Tuco Salamanca",
+      "aliases": [
+        "Tuco"
+      ]
+    },
+    {
+      "id": "walter_jr",
+      "name": "Walter White Jr.",
+      "aliases": [
+        "Walter Jr."
+      ]
+    },
+    {
+      "id": "marie",
+      "name": "Marie Schrader",
+      "aliases": [
+        "Marie"
+      ]
+    }
+  ],
+  "plotlines": [
+    {
+      "id": "empire",
+      "name": "Walt: Empire",
+      "driver": "walt",
+      "goal": "build a drug business to secure his family's financial future",
+      "obstacle": "inexperience in criminal world, dangerous partners like Tuco, moral boundaries",
+      "stakes": "death, loss of family, imprisonment",
+      "type": "serialized",
+      "rank": "A",
+      "nature": "plot-led",
+      "confidence": "solid",
+      "devices": [
+        "dramatic_irony"
+      ],
+      "span": [
+        "S01E01",
+        "S01E02",
+        "S01E03",
+        "S01E04",
+        "S01E05",
+        "S01E06",
+        "S01E07"
+      ]
+    },
+    {
+      "id": "family",
+      "name": "Walt: Family",
+      "driver": "walt",
+      "goal": "keep his family together while hiding his criminal activities",
+      "obstacle": "Skyler's growing suspicions, cancer treatment demands, maintaining double life",
+      "stakes": "family breakdown, exposure of criminal activities",
+      "type": "serialized",
+      "rank": "B",
+      "nature": "character-led",
+      "confidence": "solid",
+      "devices": [
+        "dramatic_irony"
+      ],
+      "span": [
+        "S01E01",
+        "S01E02",
+        "S01E03",
+        "S01E04",
+        "S01E05",
+        "S01E06",
+        "S01E07"
+      ]
+    },
+    {
+      "id": "investigation",
+      "name": "Hank: Investigation",
+      "driver": "hank",
+      "goal": "find the source of the high-purity blue methamphetamine",
+      "obstacle": "no direct leads, sophisticated chemistry suggests educated cook",
+      "stakes": "dangerous drugs flooding the streets, career advancement",
+      "type": "serialized",
+      "rank": "C",
+      "nature": "plot-led",
+      "confidence": "solid",
+      "devices": [
+        "dramatic_irony"
+      ],
+      "span": [
+        "S01E01",
+        "S01E02",
+        "S01E04",
+        "S01E05",
+        "S01E06",
+        "S01E07"
+      ]
+    },
+    {
+      "id": "survival",
+      "name": "Jesse: Survival",
+      "driver": "jesse",
+      "goal": "survive as Walt's partner in the dangerous drug trade",
+      "obstacle": "inexperience with violence, dangerous dealers like Tuco, Walt's demands",
+      "stakes": "death, imprisonment, continued beatings",
+      "type": "serialized",
+      "rank": "B",
+      "nature": "character-led",
+      "confidence": "solid",
+      "devices": [],
+      "span": [
+        "S01E01",
+        "S01E02",
+        "S01E03",
+        "S01E04",
+        "S01E06",
+        "S01E07"
+      ]
+    }
+  ],
+  "episodes": [
+    {
+      "episode": "S01E01",
+      "events": [
+        {
+          "event": "Walt works at the car wash to support his pregnant wife and disabled son",
+          "storyline": "family",
+          "function": "setup",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank shows off his gun at Walt's 50th birthday party and invites him on a DEA ride-along",
+          "storyline": "investigation",
+          "function": "setup",
+          "characters": [
+            "hank",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt spots Jesse escaping through a window during the meth lab bust",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt collapses at the car wash and is diagnosed with Stage III lung cancer",
+          "storyline": "family",
+          "function": "setup",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt proposes a meth cooking partnership to Jesse, threatening to turn him in to Hank",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse agrees to the partnership and purchases an old RV for a mobile lab",
+          "storyline": "survival",
+          "function": "setup",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt and Jesse cook their first batch, producing 99.1 percent pure methamphetamine",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Krazy-8 and Emilio arrive at the cook site, having followed Jesse",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "guest:krazy8",
+            "guest:emilio",
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Emilio recognizes Walt from the DEA ride-along and accuses Jesse of working with police",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "guest:emilio",
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Krazy-8 and Emilio force Walt and Jesse into the RV at gunpoint",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "guest:krazy8",
+            "guest:emilio",
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt creates phosphine gas to kill Emilio and incapacitate Krazy-8",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt drives the RV away with both bodies inside and crashes it into a ditch",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt records a video confession and farewell message to his family",
+          "storyline": "family",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt raises a gun toward approaching vehicles that turn out to be fire trucks",
+          "storyline": "empire",
+          "function": "cliffhanger",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "transformation through desperation",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "family",
+            "survival"
+          ],
+          "description": "all storylines explore how desperation transforms ordinary people into criminals",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "investigation"
+          ],
+          "description": "Hank unknowingly enables Walt's criminal career by taking him on the ride-along",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "survival"
+          ],
+          "description": "Walt's entry into the drug trade immediately puts both him and Jesse in mortal danger",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S01E02",
+      "events": [
+        {
+          "event": "Walt and Jesse return from the desert with the RV containing Emilio's body and unconscious Krazy-8",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse panics and blames Walt for the catastrophe",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt takes charge and assigns tasks for body disposal",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt and Jesse lock Krazy-8 in Jesse's basement with a bicycle lock",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt goes home and lies next to Skyler, hiding evidence",
+          "storyline": "family",
+          "function": "setup",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler notices Walt's strange behavior and presses him for answers",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt brings food and water to Krazy-8 and they have cautious conversations",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Krazy-8 tells Walt about his family's furniture business and how he fell into dealing",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt begins to feel sympathy for Krazy-8 and considers releasing him",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse dissolves Emilio's body in acid in a regular bathtub, ignoring Walt's instructions",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "The acid eats through the tub and floor, sending dissolved remains crashing through the ceiling",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt arrives at Jesse's house and is horrified by the destruction",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt makes Jesse clean up the gruesome mess",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt reconstructs a broken plate and discovers a large shard is missing",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt realizes Krazy-8 has concealed the plate shard as a weapon",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt confronts the agonizing knowledge that Krazy-8 will kill him if freed",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Krazy-8 lunges at Walt with the plate shard and Walt strangles him with the bicycle lock",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt sits on the floor weeping after killing Krazy-8",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt and Jesse bury the bodies in the desert",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Skyler grows more suspicious of Walt's absences",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt deflects Skyler's suspicions by claiming he takes long walks to process stress",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank mentions the DEA is investigating new high-purity meth on the streets",
+          "storyline": "investigation",
+          "function": "seed",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        }
+      ],
+      "theme": "the cost of crossing moral lines",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "survival",
+            "family"
+          ],
+          "description": "all storylines explore the moral compromises required to protect what matters most",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "family",
+            "investigation"
+          ],
+          "description": "the audience knows Walt is the source of the meth Hank is investigating and the reason for his strange behavior that worries Skyler",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S01E03",
+      "events": [
+        {
+          "event": "Walt tells Skyler about his lung cancer diagnosis",
+          "storyline": "family",
+          "function": "setup",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler researches treatment options and insists they fight aggressively",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt resists treatment, saying it will bankrupt the family",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Skyler tells Marie about Walt's diagnosis",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "marie"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank tries to offer Walt support but Walt shuts down emotional conversation",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Family holds intervention meeting urging Walt to pursue treatment",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "skyler",
+            "hank",
+            "marie",
+            "walter_jr",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walter Jr. passionately argues his father must fight",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walter_jr"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt agrees to chemotherapy due to family pressure",
+          "storyline": "family",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse tries to sell remaining meth without Krazy-8 as distributor",
+          "storyline": "survival",
+          "function": "setup",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse nearly gets robbed at biker bar while selling",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse realizes he cannot distribute alone and needs new connection",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt and Jesse meet to discuss distribution problems",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse suggests they need to establish territory with other dealers",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt learns chemotherapy costs thousands per session",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "family"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt calculates financial burden and hardens resolve to continue cooking",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler creates online fundraising page for Walt's treatment",
+          "storyline": "family",
+          "function": "resolution",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Marie shoplifts tiara and gives it to Skyler as baby shower gift",
+          "storyline": "family",
+          "function": "seed",
+          "characters": [
+            "marie"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the cost of survival",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "family",
+            "survival"
+          ],
+          "description": "all storylines explore different costs of survival — financial, emotional, and physical",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "family"
+          ],
+          "description": "Walt's cancer treatment costs directly motivate his continued drug cooking",
+          "subtype": null
+        }
+      ],
+      "patches": [
+        {
+          "action": "ADD_LINE",
+          "target": "marie_kleptomania",
+          "reason": "Marie's shoplifting behavior appears to be a recurring character trait that doesn't fit existing storylines",
+          "episodes": [
+            "S01E03"
+          ]
+        }
+      ]
+    },
+    {
+      "episode": "S01E04",
+      "events": [
+        {
+          "event": "Walt begins chemotherapy and hides the severe side effects from Skyler",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt snaps at a student at school due to chemo fatigue",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt's hair falls out and he decides to shave his head completely",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walter Jr. shaves his own head in solidarity with Walt",
+          "storyline": "family",
+          "function": "climax",
+          "characters": [
+            "walter_jr",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank and Gomez investigate the new blue methamphetamine in Albuquerque",
+          "storyline": "investigation",
+          "function": "setup",
+          "characters": [
+            "hank",
+            "guest:gomez"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "DEA traces the blue meth to a low-level dealer and discovers its high purity",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse reconnects with Badger and recruits him to sell meth on the street",
+          "storyline": "survival",
+          "function": "setup",
+          "characters": [
+            "jesse",
+            "guest:badger"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse confronts a rival dealer in a territorial standoff and wins by bluffing",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler discovers Marie's baby shower tiara was shoplifted",
+          "storyline": "family",
+          "function": "setup",
+          "characters": [
+            "skyler",
+            "marie"
+          ],
+          "also_affects": [
+            "family"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Skyler confronts Marie who denies shoplifting, fracturing their relationship",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "marie"
+          ],
+          "also_affects": [
+            "family"
+          ],
+          "devices": []
+        },
+        {
+          "event": "The sisters' conflict pulls Hank into the middle, straining both marriages",
+          "storyline": "family",
+          "function": "climax",
+          "characters": [
+            "hank",
+            "marie",
+            "skyler"
+          ],
+          "also_affects": [
+            "family"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt and Jesse cook a second batch in the desert RV",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse starts selling through Badger but the amounts are small with thin margins",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt calculates they need larger quantities and tells Jesse they need a real distributor",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the cost of deception",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "family",
+            "empire"
+          ],
+          "description": "both storylines explore the physical and emotional toll of Walt's choices - chemo weakening his body while his lies strengthen his criminal resolve",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "investigation",
+            "empire"
+          ],
+          "description": "Hank investigates the blue meth that Walt and Jesse are producing, unaware his brother-in-law is the chemist he's seeking",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "survival",
+            "empire"
+          ],
+          "description": "Jesse's street-level distribution efforts directly serve Walt's empire-building goals",
+          "subtype": null
+        }
+      ],
+      "patches": [
+        {
+          "action": "ADD_LINE",
+          "target": "marie_kleptomania",
+          "reason": "Marie's shoplifting subplot doesn't fit existing storylines - it's about her compulsive behavior affecting family dynamics",
+          "episodes": [
+            "S01E04"
+          ]
+        }
+      ]
+    },
+    {
+      "episode": "S01E05",
+      "events": [
+        {
+          "event": "Skyler organizes a family gathering and invites Ted Beneke",
+          "storyline": "family",
+          "function": "setup",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt becomes uncomfortable and jealous of Ted's presence",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt overcompensates by drinking too much at the party",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt forces Walter Jr. to drink tequila until he vomits",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "walter_jr"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank confronts Walt and takes the bottle away",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler demands to know what is wrong with Walt beyond cancer",
+          "storyline": "family",
+          "function": "climax",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt offers no explanation to Skyler's questions",
+          "storyline": "family",
+          "function": "resolution",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse approaches Skinny Pete for introduction to Tuco",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Skinny Pete warns Jesse that Tuco is dangerously unpredictable",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse meets Tuco and presents Walt's blue meth sample",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Tuco tests the meth and is impressed by the quality",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "guest:tuco"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Tuco beats Jesse severely and steals the meth without paying",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "guest:tuco",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse calls Walt from the hospital, battered and humiliated",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt visits Jesse in the hospital and sees his injuries",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank and Gomez process Jesse's beating as drug-related assault",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse refuses to cooperate with police investigation",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt realizes they cannot be victims in the drug world",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt resolves to confront Tuco himself",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt takes remaining meth and prepares for meeting with Tuco",
+          "storyline": "empire",
+          "function": "cliffhanger",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the cost of respect and control",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "family"
+          ],
+          "description": "both storylines explore Walt's need to assert dominance and control when feeling emasculated or disrespected",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "family",
+            "investigation"
+          ],
+          "description": "Hank processes Jesse's beating as a drug crime while being unaware that Walt is connected to it",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "investigation"
+          ],
+          "description": "Jesse's beating brings Walt's criminal world into contact with Hank's law enforcement world",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S01E06",
+      "events": [
+        {
+          "event": "Walt synthesizes mercury fulminate explosive disguised as meth",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt drives alone to Tuco's headquarters",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt introduces himself as Heisenberg to Tuco",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "tuco"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Tuco laughs and threatens Walt over payment demands",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "tuco",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt throws mercury fulminate crystal, causing explosion",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Tuco agrees to pay for stolen meth and buy future batches",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "tuco",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt returns home with cash and has aggressive sex with Skyler",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "DEA identifies blue meth as extremely pure with advanced chemistry signature",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank presents findings suggesting cook has advanced chemistry training",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "DEA investigation focuses on known drug operations but finds no match",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler notices Walt carrying extra cash and behaving erratically",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt fabricates poker game story to explain cash and behavior",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse learns Walt made deal with Tuco and is unnerved by transformation",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt and Jesse agree to cook Tuco's order immediately",
+          "storyline": "empire",
+          "function": "seed",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the intoxication of power",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "family"
+          ],
+          "description": "Walt's newfound power in the drug world transforms his behavior at home, showing how criminal success bleeds into personal relationships",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "investigation"
+          ],
+          "description": "Hank correctly deduces the cook has advanced chemistry training while Walt sits at his dinner table",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "family",
+            "empire"
+          ],
+          "description": "Skyler senses something is wrong but doesn't know Walt just confronted a violent drug dealer",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S01E07",
+      "events": [
+        {
+          "event": "Walt and Jesse cook Tuco's two-pound order in the RV, working through the night",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt refuses to cut corners despite Jesse's urge to rush, yielding their purest batch yet",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Tuco tests the product, declares it excellent, and pays fifty thousand dollars",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse",
+            "tuco"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Tuco demands double the quantity for the next delivery on a tighter schedule",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "tuco",
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt hesitates but agrees, recognizing refusing Tuco is not realistic",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Skyler discovers a second cell phone hidden in Walt's belongings",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler confronts Walt about the phone, Walt claims it was a forgotten replacement",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler begins quietly investigating Walt, checking phone records and tracking absences",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank celebrates his DEA promotion at family dinner",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "walt",
+            "skyler",
+            "walter_jr",
+            "marie"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank describes the blue meth case disrupting the local drug economy",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt asks casual questions about the investigation that Hank answers without suspicion",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "hank"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt processes that the DEA is hunting his product and Hank is leading the effort",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire",
+            "family"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse tells Walt they should find another buyer after witnessing Tuco's volatility",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt argues that Tuco's volume and cash make him irreplaceable for now",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Tuco beats his own associate nearly to death over a minor slight",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "tuco",
+            "walt",
+            "jesse",
+            "guest:associate"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt and Jesse stand frozen, unable to intervene in the beating",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt and Jesse realize they are trapped with a man who could kill them on impulse",
+          "storyline": "survival",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt sits in his driveway staring at his house, family unaware of the danger",
+          "storyline": "family",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire",
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        }
+      ],
+      "theme": "the price of success",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "survival",
+            "family"
+          ],
+          "description": "all storylines explore how success brings new dangers — business growth traps Walt with Tuco, investigation success puts Hank closer to Walt, family suspicions grow with Walt's lies",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "investigation",
+            "empire",
+            "family"
+          ],
+          "description": "Walt sits at dinner listening to Hank describe hunting him while Skyler grows suspicious and the family celebrates Hank's promotion",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "survival"
+          ],
+          "description": "Tuco's demands merge Walt's business ambitions with immediate survival concerns",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    }
+  ],
+  "usage": "12 requests, 37,588 input + 13,008 output tokens, ~$0.322"
+}
\ No newline at end of file
diff --git a/docs/knowledge/results/bb-s02-result.json b/docs/knowledge/results/bb-s02-result.json
new file mode 100644
index 0000000..2c4dd58
--- /dev/null
+++ b/docs/knowledge/results/bb-s02-result.json
@@ -0,0 +1,3194 @@
+{
+  "context": {
+    "franchise_type": "serial",
+    "story_engine": "A high school teacher builds a drug empire, testing how far he'll go for family and control",
+    "genre": "drama",
+    "format": "ongoing"
+  },
+  "cast": [
+    {
+      "id": "walt",
+      "name": "Walter White",
+      "aliases": [
+        "Walt",
+        "Walter",
+        "Heisenberg",
+        "Mr. White"
+      ]
+    },
+    {
+      "id": "jesse",
+      "name": "Jesse Pinkman",
+      "aliases": [
+        "Jesse"
+      ]
+    },
+    {
+      "id": "skyler",
+      "name": "Skyler White",
+      "aliases": [
+        "Skyler"
+      ]
+    },
+    {
+      "id": "hank",
+      "name": "Hank Schrader",
+      "aliases": [
+        "Hank"
+      ]
+    },
+    {
+      "id": "walter_jr",
+      "name": "Walter White Jr.",
+      "aliases": [
+        "Walter Jr.",
+        "Flynn"
+      ]
+    },
+    {
+      "id": "marie",
+      "name": "Marie Schrader",
+      "aliases": [
+        "Marie"
+      ]
+    },
+    {
+      "id": "saul",
+      "name": "Saul Goodman",
+      "aliases": [
+        "Saul"
+      ]
+    },
+    {
+      "id": "gus",
+      "name": "Gustavo Fring",
+      "aliases": [
+        "Gus"
+      ]
+    },
+    {
+      "id": "jane",
+      "name": "Jane Margolis",
+      "aliases": [
+        "Jane"
+      ]
+    },
+    {
+      "id": "tuco",
+      "name": "Tuco Salamanca",
+      "aliases": [
+        "Tuco"
+      ]
+    },
+    {
+      "id": "combo",
+      "name": "Combo Ortega",
+      "aliases": [
+        "Combo"
+      ]
+    },
+    {
+      "id": "badger",
+      "name": "Badger Mayhew",
+      "aliases": [
+        "Badger"
+      ]
+    },
+    {
+      "id": "skinny_pete",
+      "name": "Skinny Pete",
+      "aliases": [
+        "Skinny Pete"
+      ]
+    }
+  ],
+  "plotlines": [
+    {
+      "id": "empire",
+      "name": "Walt: Empire",
+      "driver": "walt",
+      "goal": "build a massive drug operation to secure his family's financial future",
+      "obstacle": "dangerous partners like Tuco, distribution problems, professional competition",
+      "stakes": "death, imprisonment, family destruction",
+      "type": "serialized",
+      "rank": "A",
+      "nature": "plot-led",
+      "confidence": "solid",
+      "devices": [
+        "dramatic_irony"
+      ],
+      "span": [
+        "S02E01",
+        "S02E02",
+        "S02E03",
+        "S02E04",
+        "S02E05",
+        "S02E07",
+        "S02E08",
+        "S02E09",
+        "S02E10",
+        "S02E11",
+        "S02E12",
+        "S02E13"
+      ]
+    },
+    {
+      "id": "family",
+      "name": "Walt: Family",
+      "driver": "walt",
+      "goal": "maintain his marriage and family while hiding his criminal transformation",
+      "obstacle": "Skyler's growing suspicions, his own personality changes, mounting lies",
+      "stakes": "family breakdown, exposure of criminal activities",
+      "type": "serialized",
+      "rank": "B",
+      "nature": "character-led",
+      "confidence": "solid",
+      "devices": [
+        "dramatic_irony"
+      ],
+      "span": [
+        "S02E01",
+        "S02E02",
+        "S02E03",
+        "S02E04",
+        "S02E05",
+        "S02E06",
+        "S02E07",
+        "S02E08",
+        "S02E09",
+        "S02E10",
+        "S02E11",
+        "S02E13"
+      ]
+    },
+    {
+      "id": "survival",
+      "name": "Jesse: Survival",
+      "driver": "jesse",
+      "goal": "survive and profit in the drug trade while managing his crew",
+      "obstacle": "violent competitors, unreliable dealers, addiction, loss of friends",
+      "stakes": "death, imprisonment, complete destruction",
+      "type": "serialized",
+      "rank": "B",
+      "nature": "character-led",
+      "confidence": "solid",
+      "devices": [],
+      "span": [
+        "S02E02",
+        "S02E03",
+        "S02E04",
+        "S02E05",
+        "S02E06",
+        "S02E07",
+        "S02E08",
+        "S02E10",
+        "S02E11",
+        "S02E13"
+      ]
+    },
+    {
+      "id": "investigation",
+      "name": "Hank: Investigation",
+      "driver": "hank",
+      "goal": "capture Heisenberg and shut down the blue meth operation",
+      "obstacle": "lack of direct evidence, Heisenberg's careful methods, personal trauma from Tuco shooting",
+      "stakes": "dangerous drugs flooding the streets, career reputation",
+      "type": "serialized",
+      "rank": "C",
+      "nature": "plot-led",
+      "confidence": "solid",
+      "devices": [
+        "dramatic_irony"
+      ],
+      "span": [
+        "S02E01",
+        "S02E02",
+        "S02E03",
+        "S02E05",
+        "S02E07",
+        "S02E08"
+      ]
+    },
+    {
+      "id": "love",
+      "name": "Jesse: Love",
+      "driver": "jesse",
+      "goal": "build a relationship with Jane and escape his criminal life",
+      "obstacle": "his drug addiction, Jane's relapse, Walt's interference",
+      "stakes": "loss of love, deeper addiction, death",
+      "type": "serialized",
+      "rank": "B",
+      "nature": "character-led",
+      "confidence": "solid",
+      "devices": [
+        "twist"
+      ],
+      "span": [
+        "S02E11",
+        "S02E12",
+        "S02E13"
+      ]
+    }
+  ],
+  "episodes": [
+    {
+      "episode": "S02E01",
+      "events": [
+        {
+          "event": "Flash-forward shows hazmat suits collecting evidence at White residence with pink teddy bear in pool",
+          "storyline": "empire",
+          "function": "seed",
+          "characters": [],
+          "also_affects": null,
+          "devices": [
+            "flashforward"
+          ]
+        },
+        {
+          "event": "Walt and Jesse are held at gunpoint by Tuco after witnessing No-Doze's brutal murder",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse",
+            "tuco"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt and Jesse leave Tuco's compound recognizing he's too dangerous to work with or abandon",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse urges Walt to disappear but Walt insists they can't run because Tuco knows Jesse's identity",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt proposes poisoning Tuco with ricin as their solution",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt synthesizes ricin from castor beans in Jesse's kitchen",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt conceals ricin inside a bag of meth for their next exchange with Tuco",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler confronts Walt about his erratic absences and odd behavior, demanding honesty",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt deflects Skyler's concerns with vague reassurances",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank and Gomez identify Tuco as prime suspect in blue meth distribution",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "guest:gomez"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "DEA escalates surveillance on Tuco based on intelligence about his violence and large purchases",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt and Jesse prepare for meeting with Tuco, hiding ricin-laced meth in separate bag",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Tuco reveals Gonzo died trying to move No-Doze's body when cars collapsed on him",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "tuco"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Tuco blames Walt and Jesse for bringing bad luck and forces them into his car at gunpoint",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "tuco",
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Tuco announces he's taking them to Mexico to cook for cartel and drives away with them as hostages",
+          "storyline": "empire",
+          "function": "cliffhanger",
+          "characters": [
+            "tuco",
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the illusion of control and escalating consequences",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "family",
+            "investigation"
+          ],
+          "description": "all storylines involve characters losing control despite their attempts to manage situations - Walt can't control Tuco, Skyler can't get truth from Walt, Hank closes in unknowingly on his brother-in-law",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "family",
+            "investigation"
+          ],
+          "description": "the audience knows Walt is Heisenberg while Skyler and Hank remain unaware, creating tension in their scenes",
+          "subtype": null
+        },
+        {
+          "type": "meta",
+          "lines": [],
+          "description": "flash-forward device frames the episode with future consequences",
+          "subtype": "flashforward"
+        }
+      ],
+      "patches": [
+        {
+          "action": "ADD_LINE",
+          "target": "flash_forward",
+          "reason": "flash-forward sequence doesn't advance any character's current goal but establishes future consequences",
+          "episodes": [
+            "S02E01"
+          ]
+        }
+      ]
+    },
+    {
+      "episode": "S02E02",
+      "events": [
+        {
+          "event": "Tuco drives Walt and Jesse to a remote desert shack where his uncle Hector waits in a wheelchair",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse",
+            "guest:tuco",
+            "guest:hector"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Tuco forces Walt to cook meth in the shack's crude kitchen while Walt secretly plots to use ricin",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "guest:tuco"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse prepares a burrito and stirs ricin-laced meth into it for Tuco",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hector rings his bell and knocks the poisoned plate off the table before Tuco can eat",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "guest:hector",
+            "guest:tuco"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Tuco beats Jesse severely and drags him outside after the failed poisoning",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "guest:tuco",
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Skyler calls Jesse's phone repeatedly when Walt doesn't come home, then contacts Hank in panic",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "hank"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank discovers Jesse's Monte Carlo with CAPNCOOK plates at Tuco's compound and traces the registration",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt tells Tuco that Jesse is useless and suggests letting him go, but Tuco refuses",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "guest:tuco"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse finds a gun hidden under the porch while bloodied from his beating",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse shoots Tuco in the abdomen and Tuco fires back, then Walt strikes Tuco with a rock",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "jesse",
+            "walt",
+            "guest:tuco"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank arrives at the shack and exchanges gunfire with wounded Tuco in the desert",
+          "storyline": "investigation",
+          "function": "climax",
+          "characters": [
+            "hank",
+            "guest:tuco"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank kills Tuco with a shot to the head",
+          "storyline": "investigation",
+          "function": "resolution",
+          "characters": [
+            "hank",
+            "guest:tuco"
+          ],
+          "also_affects": [
+            "investigation",
+            "empire",
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt and Jesse flee on foot into the desert before Hank can discover them",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival",
+            "family"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt and Jesse separate in the desert, each planning alibis for their disappearance",
+          "storyline": "family",
+          "function": "seed",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the price of survival",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "survival",
+            "investigation"
+          ],
+          "description": "all three storylines involve life-or-death stakes and the lengths people go to survive",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "investigation",
+            "family"
+          ],
+          "description": "Hank unknowingly saves Walt and Jesse by killing Tuco, while Skyler's panic inadvertently leads Hank to the scene",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "survival",
+            "investigation"
+          ],
+          "description": "all storylines physically converge at the desert shack for the climactic shootout",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S02E03",
+      "events": [
+        {
+          "event": "Walt strips naked in a convenience store, feigning a fugue state caused by his cancer",
+          "storyline": "family",
+          "function": "setup",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt is taken to the hospital and maintains the fugue story to doctors and Skyler",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler rushes to the hospital, relieved but deeply confused and doubtful",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Doctors run tests and find no neurological cause but acknowledge cancer stress could trigger dissociation",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank is placed on administrative leave pending review of the Tuco shooting",
+          "storyline": "investigation",
+          "function": "setup",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "DEA treats Hank as a hero, but he privately struggles with having killed a man",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank visits Walt in the hospital and doesn't question the fugue story",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "walt"
+          ],
+          "also_affects": [
+            "family"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse checks into a motel and calls Skinny Pete for a ride back to town",
+          "storyline": "survival",
+          "function": "setup",
+          "characters": [
+            "jesse",
+            "skinny_pete"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse discovers DEA searched his house and impounded his car",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse calls Walt furiously demanding to know what to do",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt coldly instructs Jesse to stay quiet and say nothing to anyone",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt assures Jesse the only link was the car with no evidence of their operation",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "DEA interviews Hector Salamanca about Tuco's death and operations",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hector refuses to cooperate or identify Walt and Jesse out of his code against informing",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "guest:hector"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt is released from hospital and returns home to family gathering",
+          "storyline": "family",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "skyler",
+            "walter_jr"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt sits through dinner performing normalcy while calculating his next move",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "family"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt keeps the ricin vial concealed in his jacket pocket",
+          "storyline": "empire",
+          "function": "seed",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the cost of deception",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "family",
+            "trauma",
+            "empire"
+          ],
+          "description": "all storylines explore different forms of psychological burden — Walt's lies, Hank's guilt, the weight of criminal life",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "family",
+            "empire",
+            "investigation"
+          ],
+          "description": "the audience knows Walt's fugue state is fake while Skyler and Hank believe it, and that Hector's silence protects Walt",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "trauma",
+            "investigation"
+          ],
+          "description": "Hank's emotional state from killing Tuco affects his ability to pursue the investigation",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S02E04",
+      "events": [
+        {
+          "event": "Jesse discovers his parents have changed the locks on his aunt's house",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse's parents inform him he's no longer welcome due to the DEA investigation",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "guest:jesse_parents"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse pleads with his parents but his father stands firm",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "guest:jesse_father"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse packs and leaves, beginning his homelessness spiral",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse crashes at Skinny Pete's place briefly",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "skinny_pete"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse moves through increasingly squalid locations, eventually sleeping in the RV",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse retrieves the RV by paying the towing fee with his remaining cash",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt tries to reestablish normal life but finds domestic environment suffocating",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler rebuffs Walt's intimacy attempts, sensing dishonesty in his fugue story",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler begins investigating Walt by checking phone records and credit card statements",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt returns to teaching where colleagues treat him with gentle sympathy",
+          "storyline": "family",
+          "function": "setup",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt contacts Jesse to discuss resuming meth operation but Jesse refuses",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse is robbed of his remaining cash at a shelter house",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "jesse",
+            "guest:robbers"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse visits his parents' home but his mother calls police and he flees",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "guest:jesse_mother"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt discovers his medical bills are mounting and insurance is inadequate",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "family"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Skyler suggests accepting financial help from Elliott and Gretchen",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt bristles at accepting help from Gray Matter but doesn't refuse",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "family"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse calls Walt and agrees to restart meth business as equal partners",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "desperation drives compromise",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "family",
+            "survival"
+          ],
+          "description": "all three storylines show characters forced into unwanted compromises by desperate circumstances",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "family",
+            "empire"
+          ],
+          "description": "Skyler investigates Walt's lies while the audience knows the truth about his criminal activities",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "survival"
+          ],
+          "description": "Jesse's homelessness crisis forces him back into partnership with Walt",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S02E05",
+      "events": [
+        {
+          "event": "Walt and Jesse resume cooking meth in the RV, producing a large quantity of blue product",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse proposes using Skinny Pete, Badger, and Combo as individual dealers",
+          "storyline": "survival",
+          "function": "setup",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt is skeptical of Jesse's street-level distribution plan but agrees",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse distributes meth to his three friends with price and deadline",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "skinny_pete",
+            "badger",
+            "combo"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skinny Pete is robbed at knifepoint by addicts who take his product and cash",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "skinny_pete"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skinny Pete returns to Jesse empty-handed and humiliated",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "skinny_pete",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse realizes his dealers need protection or will be victimized repeatedly",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt tells Jesse the distribution problem is his responsibility to handle",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank experiences a panic attack in the DEA elevator but hides it from colleagues",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Marie notices Hank's changed behavior and urges him to see a counselor",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "marie",
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank refuses counseling, insisting he is fine",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler arranges dinner with Elliott and Gretchen to discuss paying for Walt's treatment",
+          "storyline": "family",
+          "function": "setup",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt attends dinner seething with resentment at accepting charity from the Schwartzes",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "guest:elliott",
+            "guest:gretchen"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Elliott offers to cover all medical expenses and Walt accepts in the moment",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "guest:elliott"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt later tells Skyler he will not take the Schwartzes' money",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse buys a gun and practices intimidating persona in bathroom mirror",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt tells Jesse there are two types: those who get robbed and those who rob",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse resolves to control his territory through fear rather than trust",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the cost of control",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "survival",
+            "family",
+            "trauma"
+          ],
+          "description": "all storylines explore different costs of maintaining control — Walt's pride costs him help, Jesse's territory costs him innocence, Hank's facade costs him healing",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "family"
+          ],
+          "description": "Skyler believes Walt needs the Schwartzes' help while the audience knows he's making money from meth",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "survival"
+          ],
+          "description": "Walt's business philosophy directly influences Jesse's transformation into an enforcer",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S02E06",
+      "events": [
+        {
+          "event": "Jesse and Skinny Pete track down the meth addicts who robbed Skinny Pete",
+          "storyline": "survival",
+          "function": "setup",
+          "characters": [
+            "jesse",
+            "skinny_pete"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse goes to Spooge's house alone with his gun to confront the thieves",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse discovers a neglected five-year-old boy living in squalor",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse waits as Spooge attempts to crack open a stolen ATM",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse intermittently cares for the boy, adjusting his blanket and changing the TV",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt tells Skyler that Elliott and Gretchen are paying for his medical bills",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt begins aggressive chemotherapy that leaves him nauseous and exhausted",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler calls Gretchen to thank her, but Gretchen knows nothing about paying for treatment",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Spooge's wife pushes the ATM, crushing Spooge's head and killing him",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": [
+            "twist"
+          ]
+        },
+        {
+          "event": "Jesse calls 911 anonymously to report the child in danger",
+          "storyline": "survival",
+          "function": "resolution",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse leads the boy to safety on the front porch before fleeing",
+          "storyline": "survival",
+          "function": "resolution",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Word spreads that Jesse killed Spooge, enhancing his street reputation",
+          "storyline": "survival",
+          "function": "seed",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        }
+      ],
+      "theme": "the cost of protecting innocence",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "survival",
+            "family"
+          ],
+          "description": "both storylines explore protecting children — Jesse literally saves a boy, Walt claims to protect his family through lies",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "family"
+          ],
+          "description": "the audience knows Walt is lying about Elliott and Gretchen paying for treatment",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "survival"
+          ],
+          "description": "the audience knows Jesse didn't kill Spooge, but his reputation benefits from the misattribution",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S02E07",
+      "events": [
+        {
+          "event": "A narcocorrido music video depicts Heisenberg's rise and celebrates his blue meth",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "The DEA watches the Heisenberg video with amusement and concern",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank adds the Heisenberg case to his active investigations",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse expands his distribution network with Combo, Skinny Pete, and Badger working separate corners",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "combo",
+            "skinny_pete",
+            "badger"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse manages the operation with increasing confidence, collecting money and distributing batches",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt continues chemotherapy despite debilitating side effects and insists on cooking",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "family"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt and Jesse produce another large batch in the RV",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler contacts Gretchen directly and they meet for lunch",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "guest:gretchen"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gretchen is bewildered by Skyler's gratitude for supposed financial support",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "guest:gretchen",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler realizes Walt has been lying about who is paying for his treatment",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler confronts Walt indirectly with pointed questions about the Schwartzes",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt deflects with anger and storms out after the argument escalates",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt confronts Gretchen at her home, furious that she spoke with Skyler",
+          "storyline": "family",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "guest:gretchen"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt tells Gretchen his personal life is none of her business and severs the relationship",
+          "storyline": "family",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "guest:gretchen"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Two rival dealers begin encroaching on Combo's territory on the south side",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "combo",
+            "guest:rival_dealers"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Combo reports the territorial incursion to Jesse, who tells him to hold his ground",
+          "storyline": "survival",
+          "function": "seed",
+          "characters": [
+            "jesse",
+            "combo"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the price of reputation",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "family",
+            "survival"
+          ],
+          "description": "all storylines explore how reputation and success create new vulnerabilities — Walt's Heisenberg legend attracts DEA attention, his lies unravel his marriage, Jesse's crew faces territorial challenges",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "investigation"
+          ],
+          "description": "the audience knows Walt is Heisenberg while Hank investigates the very man he's hunting",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "family",
+            "empire"
+          ],
+          "description": "Skyler discovers Walt's lies about treatment funding but doesn't know the criminal source",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S02E08",
+      "events": [
+        {
+          "event": "Badger is arrested by an undercover DEA officer while selling meth on a park bench",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "badger"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank and Gomez process Badger's arrest and pressure him to identify his supplier",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Badger stalls but does not immediately give up Jesse's name",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "badger"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse panics when he learns of the arrest and tells Walt their operation is exposed",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt agrees that if Badger talks, the chain leads directly to them",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse contacts Saul Goodman, a flamboyant defense attorney from the criminal underworld",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse hires Saul to represent Badger",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Saul visits Badger in holding and assesses the situation",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "guest:saul"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Saul meets with Jesse and Walt and proposes hiring a decoy to pose as Heisenberg",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "guest:saul",
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Saul produces Jimmy In-N-Out, a petty criminal willing to take the fall for a fee",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "guest:saul"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt is skeptical but agrees to the plan when Saul demonstrates its legal plausibility",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Badger identifies Jimmy In-N-Out as his supplier during the sting operation",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "badger"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "The DEA arrests Jimmy In-N-Out, believing they have caught Heisenberg",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank is suspicious because the suspect does not match his Heisenberg profile",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Saul offers his ongoing services as a criminal lawyer to Walt and Jesse",
+          "storyline": "empire",
+          "function": "seed",
+          "characters": [
+            "guest:saul",
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Saul proposes connecting Walt with a professional distributor to replace Jesse's street network",
+          "storyline": "empire",
+          "function": "seed",
+          "characters": [
+            "guest:saul",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt is intrigued by Saul's distributor proposal but remains noncommittal",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler discovers Walt's second cell phone when it falls out of his bag",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler confronts Walt about the phone, and he lies that it's a work replacement",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler clearly does not believe Walt's lie about the phone",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        }
+      ],
+      "theme": "the price of protection",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "survival",
+            "family"
+          ],
+          "description": "all storylines involve characters trying to protect something valuable at increasing cost — Walt protects his operation and family through deception, Jesse protects his crew through criminal lawyers, Skyler tries to protect her marriage by confronting lies",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "investigation",
+            "family"
+          ],
+          "description": "the audience knows Walt is Heisenberg while Hank investigates him and Skyler suspects him without knowing the truth",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "survival"
+          ],
+          "description": "Badger's arrest forces Walt and Jesse's storylines to merge through their shared need for Saul's services",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S02E09",
+      "events": [
+        {
+          "event": "Walt receives test results showing his tumor has shrunk significantly and he is in remission",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt feels unsettling emptiness rather than relief about his remission",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt calculates his finances and realizes he has far less money saved than expected after expenses",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt determines he and Jesse need to cook a massive quantity to secure his family's financial future",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt proposes a marathon four-day cook session in the desert using the RV",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse agrees reluctantly, noting they are low on methylamine",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt purchases all the supplies they can afford and they drive the RV deep into the desert",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "The cook proceeds efficiently with Walt and Jesse falling into their established routine",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse accidentally drains the RV's battery by leaving the key in the ignition to power the radio",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt and Jesse realize they are stranded in the desert with no cell signal, no water supply, and climbing temperatures",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt attempts multiple failed solutions including jump-starting the battery and considering siphoning gasoline",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt and Jesse argue bitterly about whose fault the situation is, with Jesse blaming Walt for choosing such a remote location",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt collapses from heat, exhaustion, and his weakened post-chemo condition as dehydration sets in",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse becomes desperate and nearly gives up as their situation becomes dire",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt engineers a makeshift battery using coins, galvanized metal, and potassium hydroxide to generate enough current to start the engine",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "The RV starts and they drive back to Albuquerque with a full batch of meth and their lives barely intact",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt returns home and tells Skyler nothing of the ordeal",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse delivers the product and they now have enough meth to make a significant deal but still no large-scale distributor",
+          "storyline": "empire",
+          "function": "seed",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the cost of ambition",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "family"
+          ],
+          "description": "both storylines explore how Walt's remission paradoxically drives him deeper into crime rather than back to normalcy",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "family"
+          ],
+          "description": "Skyler believes Walt is recovering and their ordeal is ending, while the audience knows his remission is pushing him toward greater criminal ambition",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S02E10",
+      "events": [
+        {
+          "event": "Walt publicly announces his cancer remission at a family gathering organized by Skyler",
+          "storyline": "family",
+          "function": "setup",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt appears detached and restless rather than grateful during the celebration",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt buys Walt Jr. a Dodge Challenger without consulting Skyler",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "walter_jr"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler demands to know where the money came from, Walt brushes her off",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt drinks heavily at a pool party and forces Walt Jr. to drink tequila",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "walter_jr"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank intervenes and Walt challenges him aggressively over the drinking",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank physically takes the bottle away, Walt stares him down defiantly",
+          "storyline": "family",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt tells Jesse they should not rush to find a new distributor",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse argues that product sitting in storage is a liability, Walt dismisses the concern",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt encounters a young man buying meth-making supplies at the hardware store",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "guest:young_cook"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt threatens the young cook to stay out of his territory",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "guest:young_cook"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler tells Walt she no longer recognizes him, he insists he's the same person",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt and Skyler grow distant with silence at dinner and separate bedtimes",
+          "storyline": "family",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt stares at the ceiling unable to sleep, his appetite for power unchanged by remission",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "family"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "identity without excuse",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "family"
+          ],
+          "description": "both storylines explore how Walt's true nature emerges when the cancer excuse is removed",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "family"
+          ],
+          "description": "the audience knows Walt's reckless behavior stems from his drug empire success, while Skyler attributes it to cancer remission relief",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S02E11",
+      "events": [
+        {
+          "event": "Combo is shot and killed by a young boy while dealing on rival territory",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "combo"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse blames himself for Combo's death and is devastated by the loss",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse shuts down the street-level distribution network and tells Skinny Pete and Badger to stop dealing",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "jesse",
+            "skinny_pete",
+            "badger"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse spirals emotionally and begins using meth again, isolating himself",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "love"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt realizes their independent distribution model is fatally flawed",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt contacts Saul and asks him to arrange the meeting with the professional distributor",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "saul"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Saul warns Walt about the distributor's serious nature but makes the call",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "saul",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt waits at Los Pollos Hermanos but no one approaches him",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt returns the next day and again receives no contact",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt confronts Gus directly and asks if he is the distributor",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "gus"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus denies involvement and politely suggests Walt leave",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "gus",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt tells Saul the connection is a dead end",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "saul"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Saul advises patience, explaining Gus evaluates partners over time",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "saul",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse meets Jane Margolis, his new neighbor and landlord's daughter",
+          "storyline": "love",
+          "function": "setup",
+          "characters": [
+            "jesse",
+            "jane"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jane reveals she's an artist and recovering addict who attends NA meetings",
+          "storyline": "love",
+          "function": "setup",
+          "characters": [
+            "jane",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse and Jane begin a tentative friendship while Jesse hides his drug involvement",
+          "storyline": "love",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "jane"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler discovers Walt has been making calls to an unidentified number",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler's trust in Walt continues to erode but she doesn't act yet",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Gus investigates Walt's background through his own sources",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus sends word through Saul that he's willing to meet, but only with Walt",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "gus",
+            "saul"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the cost of independence",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "survival",
+            "love"
+          ],
+          "description": "all storylines explore the tension between independence and partnership — Walt needs Gus, Jesse needs to rebuild after going solo, Jesse and Jane both struggle with isolation in recovery",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "love",
+            "family"
+          ],
+          "description": "both Jane and Skyler are unaware of Jesse and Walt's true criminal involvement",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "survival"
+          ],
+          "description": "Combo's death forces both Walt and Jesse to confront the failure of their independent operation",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S02E12",
+      "events": [
+        {
+          "event": "Walt meets Gus at Los Pollos Hermanos for a formal business conversation",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "gus"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus explains he has verified Walt's product as exceptional but has reservations about Jesse as unreliable",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "gus",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus offers to buy Walt's entire stockpile for $1.2 million in a one-time deal with one-hour delivery deadline",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "gus",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt calls Jesse repeatedly but cannot reach him",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "love"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt finds Jesse in a drugged stupor with Jane, who has relapsed into heroin use",
+          "storyline": "love",
+          "function": "turning_point",
+          "characters": [
+            "jesse",
+            "jane"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt retrieves the meth himself and races to the drop point, barely making the deadline",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus's men complete the exchange and Walt receives $1.2 million in cash",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "guest:gus_men"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt brings Jesse's money but refuses to hand it over, saying he'll hold it until Jesse is sober",
+          "storyline": "love",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse accuses Walt of treating him like a child",
+          "storyline": "love",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jane encourages Jesse to demand his money and suggests they use it to start a new life together",
+          "storyline": "love",
+          "function": "escalation",
+          "characters": [
+            "jane",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse calls Walt and insists on receiving his share immediately, Walt refuses",
+          "storyline": "love",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jane calls Walt threatening to expose his drug operation if he doesn't hand over Jesse's money",
+          "storyline": "love",
+          "function": "turning_point",
+          "characters": [
+            "jane",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt agrees to deliver the cash under Jane's threat",
+          "storyline": "love",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt finds Jesse and Jane passed out from heroin use",
+          "storyline": "love",
+          "function": "setup",
+          "characters": [
+            "walt",
+            "jesse",
+            "jane"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt accidentally rolls Jane onto her back while trying to rouse Jesse",
+          "storyline": "love",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "jane"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jane begins to vomit and choke, Walt watches her asphyxiate instead of saving her",
+          "storyline": "love",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "jane"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "twist"
+          ]
+        },
+        {
+          "event": "Walt leaves the house as Jane's breathing stops",
+          "storyline": "love",
+          "function": "resolution",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the price of control",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "love"
+          ],
+          "description": "both storylines explore the lengths Walt will go to maintain control — over his business and over Jesse's choices",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "love"
+          ],
+          "description": "Jane's threat to expose Walt's operation forces the storylines to merge, culminating in her death",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "love"
+          ],
+          "description": "the audience knows Walt could save Jane but chooses not to, while Jesse remains unaware of Walt's role in her death",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S02E13",
+      "events": [
+        {
+          "event": "Jesse wakes up next to Jane's dead body and calls 911 in hysterics",
+          "storyline": "love",
+          "function": "climax",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Paramedics arrive and pronounce Jane dead from accidental overdose",
+          "storyline": "love",
+          "function": "resolution",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt arrives at Jesse's house feigning shock over Jane's death",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "love"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt arranges through Saul to have Jesse admitted to rehab",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "saul"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Mike cleans Jesse's house of drug evidence before police arrive",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "guest:mike"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Donald Margolis is destroyed by Jane's death and returns to work grief-stricken",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "guest:donald"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt undergoes surgery while Skyler drives him to the hospital",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt nearly confesses about his second phone while groggy from anesthesia",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler visits Walt after surgery with cold and distant manner",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse enters rehab to confront his addiction and grief over Jane",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "love"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt returns home and stares at his bag of cash in the crawl space",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Donald fails to issue correction causing midair collision of two planes",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "guest:donald"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashforward",
+            "callback"
+          ]
+        },
+        {
+          "event": "Pink teddy bear falls from plane wreckage into White family backyard",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [],
+          "also_affects": null,
+          "devices": [
+            "flashforward",
+            "callback"
+          ]
+        },
+        {
+          "event": "Walt watches news coverage of the plane crash that killed 167 people",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler tells Walt she wants him to move out",
+          "storyline": "family",
+          "function": "climax",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the devastating consequences of moral compromise",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "family",
+            "love"
+          ],
+          "description": "all storylines explore how Walt's choices destroy relationships and lives",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "family"
+          ],
+          "description": "the audience knows Walt caused Jane's death and the plane crash, but Skyler and Jesse don't",
+          "subtype": null
+        },
+        {
+          "type": "meta",
+          "lines": [
+            "empire"
+          ],
+          "description": "the plane crash serves as a metaphorical culmination of Walt's destructive impact",
+          "subtype": "callback"
+        }
+      ],
+      "patches": [
+        {
+          "action": "ADD_LINE",
+          "target": "consequences",
+          "reason": "Donald's grief and the plane crash represent a major consequence storyline that doesn't fit existing categories",
+          "episodes": [
+            "S02E13"
+          ]
+        }
+      ]
+    }
+  ],
+  "usage": "17 requests, 63,885 input + 23,502 output tokens, ~$0.448"
+}
\ No newline at end of file
diff --git a/docs/knowledge/results/bb-s03-result.json b/docs/knowledge/results/bb-s03-result.json
new file mode 100644
index 0000000..51c4ce4
--- /dev/null
+++ b/docs/knowledge/results/bb-s03-result.json
@@ -0,0 +1,3249 @@
+{
+  "context": {
+    "franchise_type": "serial",
+    "story_engine": "A high school teacher builds a drug empire, testing how far he'll go for family and control",
+    "genre": "drama",
+    "format": "ongoing"
+  },
+  "cast": [
+    {
+      "id": "walt",
+      "name": "Walter White",
+      "aliases": [
+        "Walt",
+        "Walter",
+        "Heisenberg",
+        "Mr. White"
+      ]
+    },
+    {
+      "id": "jesse",
+      "name": "Jesse Pinkman",
+      "aliases": [
+        "Jesse"
+      ]
+    },
+    {
+      "id": "skyler",
+      "name": "Skyler White",
+      "aliases": [
+        "Skyler"
+      ]
+    },
+    {
+      "id": "hank",
+      "name": "Hank Schrader",
+      "aliases": [
+        "Hank"
+      ]
+    },
+    {
+      "id": "walter_jr",
+      "name": "Walter White Jr.",
+      "aliases": [
+        "Walter Jr.",
+        "Flynn",
+        "Walt Jr."
+      ]
+    },
+    {
+      "id": "marie",
+      "name": "Marie Schrader",
+      "aliases": [
+        "Marie"
+      ]
+    },
+    {
+      "id": "saul",
+      "name": "Saul Goodman",
+      "aliases": [
+        "Saul"
+      ]
+    },
+    {
+      "id": "gus",
+      "name": "Gustavo Fring",
+      "aliases": [
+        "Gus",
+        "Gus Fring"
+      ]
+    },
+    {
+      "id": "gale",
+      "name": "Gale Boetticher",
+      "aliases": [
+        "Gale"
+      ]
+    },
+    {
+      "id": "mike",
+      "name": "Mike Ehrmantraut",
+      "aliases": [
+        "Mike"
+      ]
+    },
+    {
+      "id": "ted",
+      "name": "Ted Beneke",
+      "aliases": [
+        "Ted"
+      ]
+    },
+    {
+      "id": "andrea",
+      "name": "Andrea Cantillo",
+      "aliases": [
+        "Andrea"
+      ]
+    },
+    {
+      "id": "tomas",
+      "name": "Tomas Cantillo",
+      "aliases": [
+        "Tomas"
+      ]
+    },
+    {
+      "id": "leonel",
+      "name": "Leonel Salamanca",
+      "aliases": [
+        "Leonel"
+      ]
+    },
+    {
+      "id": "marco",
+      "name": "Marco Salamanca",
+      "aliases": [
+        "Marco"
+      ]
+    },
+    {
+      "id": "hector",
+      "name": "Hector Salamanca",
+      "aliases": [
+        "Hector"
+      ]
+    }
+  ],
+  "plotlines": [
+    {
+      "id": "empire",
+      "name": "Walt: Empire",
+      "driver": "walt",
+      "goal": "establish himself as Gus's lead chemist and secure his position in the superlab operation",
+      "obstacle": "Gus's manipulation and control, the threat of being replaced by Gale, cartel violence",
+      "stakes": "death, loss of financial security, family exposure",
+      "type": "serialized",
+      "rank": "A",
+      "nature": "plot-led",
+      "confidence": "solid",
+      "devices": [
+        "dramatic_irony"
+      ],
+      "span": [
+        "S03E02",
+        "S03E03",
+        "S03E04",
+        "S03E05",
+        "S03E06",
+        "S03E07",
+        "S03E08",
+        "S03E09",
+        "S03E10",
+        "S03E11",
+        "S03E12",
+        "S03E13"
+      ]
+    },
+    {
+      "id": "family",
+      "name": "Walt: Family",
+      "driver": "walt",
+      "goal": "maintain control over his family despite Skyler's knowledge of his crimes",
+      "obstacle": "Skyler's affair with Ted, divorce proceedings, restraining order",
+      "stakes": "complete family breakdown, loss of children, isolation",
+      "type": "serialized",
+      "rank": "B",
+      "nature": "character-led",
+      "confidence": "solid",
+      "devices": [
+        "dramatic_irony"
+      ],
+      "span": [
+        "S03E01",
+        "S03E02",
+        "S03E03",
+        "S03E04",
+        "S03E08",
+        "S03E09",
+        "S03E11",
+        "S03E13"
+      ]
+    },
+    {
+      "id": "survival",
+      "name": "Jesse: Survival",
+      "driver": "jesse",
+      "goal": "survive and profit in the drug trade while navigating his partnership with Walt",
+      "obstacle": "homelessness, inferior product quality, violent dealers, Gus's suspicion",
+      "stakes": "death, imprisonment, complete destruction",
+      "type": "serialized",
+      "rank": "B",
+      "nature": "plot-led",
+      "confidence": "solid",
+      "devices": [],
+      "span": [
+        "S03E01",
+        "S03E02",
+        "S03E03",
+        "S03E04",
+        "S03E05",
+        "S03E06",
+        "S03E07",
+        "S03E08",
+        "S03E09",
+        "S03E10",
+        "S03E11",
+        "S03E13"
+      ]
+    },
+    {
+      "id": "investigation",
+      "name": "Hank: Investigation",
+      "driver": "hank",
+      "goal": "track down the blue meth operation and its creators",
+      "obstacle": "panic attacks, career suspension, physical injuries from cartel attack",
+      "stakes": "career destruction, death, family safety",
+      "type": "serialized",
+      "rank": "B",
+      "nature": "plot-led",
+      "confidence": "solid",
+      "devices": [
+        "dramatic_irony"
+      ],
+      "span": [
+        "S03E01",
+        "S03E02",
+        "S03E03",
+        "S03E04",
+        "S03E05",
+        "S03E06",
+        "S03E07",
+        "S03E08",
+        "S03E09",
+        "S03E11"
+      ]
+    },
+    {
+      "id": "love",
+      "name": "Jesse: Love",
+      "driver": "jesse",
+      "goal": "build a genuine relationship with Andrea and protect her family",
+      "obstacle": "his criminal life, Andrea's brother's involvement with dealers, his own deception",
+      "stakes": "loss of love, Andrea's safety, moral corruption",
+      "type": "serialized",
+      "rank": "C",
+      "nature": "character-led",
+      "confidence": "solid",
+      "devices": [],
+      "span": [
+        "S03E09",
+        "S03E11",
+        "S03E12"
+      ]
+    },
+    {
+      "id": "control",
+      "name": "Gus: Control",
+      "driver": "gus",
+      "goal": "maintain absolute control over his drug operation and eliminate threats",
+      "obstacle": "Walt's unpredictability, cartel pressure, DEA investigation",
+      "stakes": "empire destruction, death, exposure",
+      "type": "serialized",
+      "rank": "B",
+      "nature": "plot-led",
+      "confidence": "solid",
+      "devices": [
+        "flashback"
+      ],
+      "span": [
+        "S03E01",
+        "S03E02",
+        "S03E03",
+        "S03E04",
+        "S03E05",
+        "S03E06",
+        "S03E07",
+        "S03E08",
+        "S03E09",
+        "S03E11",
+        "S03E12",
+        "S03E13"
+      ]
+    },
+    {
+      "id": "vengeance",
+      "name": "Salamanca Twins: Vengeance",
+      "driver": "leonel",
+      "goal": "kill Walter White to avenge Tuco's death",
+      "obstacle": "Gus's interference and redirection toward Hank",
+      "stakes": "family honor, their own lives",
+      "type": "serialized",
+      "rank": "C",
+      "nature": "plot-led",
+      "confidence": "solid",
+      "devices": [],
+      "span": [
+        "S03E01",
+        "S03E02",
+        "S03E03",
+        "S03E04",
+        "S03E07",
+        "S03E08"
+      ]
+    }
+  ],
+  "episodes": [
+    {
+      "episode": "S03E01",
+      "events": [
+        {
+          "event": "Leonel and Marco Salamanca pin Walt's sketch to a shrine and head north from Mexico",
+          "storyline": "vengeance",
+          "function": "setup",
+          "characters": [
+            "leonel",
+            "marco"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "People crawl on their bellies toward the shrine in the Mexican village",
+          "storyline": "vengeance",
+          "function": "setup",
+          "characters": [
+            "guest:villagers"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "Walt gives a tone-deaf statistical speech at the school assembly about the plane crash",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler demands a divorce from Walt after discovering his meth cooking",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt refuses to move out and insists he did everything for the family",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse is released from rehab and discovers his parents sold his aunt's house",
+          "storyline": "survival",
+          "function": "setup",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse checks into a motel with diminished cash and calls Walt who doesn't answer",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank receives a promotion to DEA's El Paso field office near the cartel border",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank publicly celebrates but privately shows anxiety from his Tuco encounter",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt throws pizza on the roof when Skyler locks him out, then enters through back door",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler takes the children and leaves for the night",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus monitors the situation from a distance through his network",
+          "storyline": "control",
+          "function": "setup",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "The Salamanca twins cross the border and execute immigrants who recognize them",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "leonel",
+            "marco"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt sits alone in the empty house, convinced he can hold his family together",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        }
+      ],
+      "theme": "the illusion of control and consequences",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "family",
+            "vengeance",
+            "control"
+          ],
+          "description": "all storylines explore how characters attempt to control situations that are spiraling beyond their grasp",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "family",
+            "vengeance"
+          ],
+          "description": "Walt believes he can control his family situation while deadly assassins hunt him",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "vengeance",
+            "empire"
+          ],
+          "description": "the twins' hunt for Walt will intersect with his drug operation",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S03E02",
+      "events": [
+        {
+          "event": "The Salamanca twins enter Walt's house with an axe and wait on his bed while he showers",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "leonel",
+            "marco"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Gus calls the twins away before they can kill Walt",
+          "storyline": "control",
+          "function": "escalation",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": [
+            "vengeance",
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt continues his morning routine, oblivious to the near-death experience",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler hires a divorce attorney",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt refuses to sign divorce papers and tells Walt Jr. that Skyler is breaking up the family",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "walter_jr"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt Jr. turns against Skyler after Walt's manipulation",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walter_jr",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler reveals she knows everything about Walt's meth operation and threatens to tell Hank",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt calls Skyler's bluff, betting she won't destroy the family's reputation",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse, broke and homeless, gets help from Saul to find a new duplex",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "saul"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse visits his old neighborhood and sees strangers in his aunt's former house",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank suffers a panic attack in the DEA elevator before his El Paso transfer",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank forces himself back to composure and tells no one about the panic attack",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "The Salamanca twins visit their paralyzed uncle Hector in the nursing home",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "leonel",
+            "marco",
+            "hector"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hector's rage confirms the twins' mission to kill Walt for Tuco's death",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "hector",
+            "leonel",
+            "marco"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus meets with the twins through his intermediary and counsels patience",
+          "storyline": "control",
+          "function": "escalation",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt attempts a family dinner with takeout, acting as if nothing has changed",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "walter_jr"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler returns home disgusted but sits down powerless to explain the truth",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt smiles, believing he is winning the standoff through attrition",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        }
+      ],
+      "theme": "the illusion of control",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "family",
+            "control",
+            "vengeance"
+          ],
+          "description": "all storylines explore different forms of control — Walt's manipulation of his family, Gus's orchestration of violence, and the twins' single-minded pursuit of revenge",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "vengeance"
+          ],
+          "description": "Walt is oblivious to how close he came to death while the audience witnessed the twins' near-attack",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "family",
+            "investigation"
+          ],
+          "description": "Skyler threatens to tell Hank the truth while the audience knows Hank is psychologically unraveling",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "control",
+            "vengeance"
+          ],
+          "description": "Gus directly intervenes in the twins' mission, showing his power over their revenge plot",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S03E03",
+      "events": [
+        {
+          "event": "Walt sleeps in the master bedroom while Skyler takes the couch, each refusing to yield ground",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler meets with her divorce attorney who explains Walt will likely get shared custody without admissible evidence",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler begins an affair with Ted Beneke at Beneke Fabricators",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "skyler",
+            "ted"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler tells Walt 'I fucked Ted' when he comes home",
+          "storyline": "family",
+          "function": "climax",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse tries to cook meth alone using Walt's formula but produces inferior product",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse sells low-quality meth through Skinny Pete, drawing complaints",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "guest:skinny_pete"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Saul approaches Walt with Gus's offer of three million for three months in the superlab",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "saul",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt declines Gus's offer, insisting he is done with the drug business",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank investigates a tip connecting the blue meth to local market, noting lower quality suggests copycat",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "The Salamanca twins acquire chrome axes, preparing to strike",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "leonel",
+            "marco"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus meets with the twins and persuades them to wait, promising to deliver Tuco's killer on his timeline",
+          "storyline": "control",
+          "function": "escalation",
+          "characters": [
+            "gus",
+            "leonel",
+            "marco"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt drives recklessly after Skyler's confession, nearly causing an accident, then sits gripping the steering wheel",
+          "storyline": "family",
+          "function": "resolution",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the illusion of control",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "family",
+            "empire",
+            "control",
+            "vengeance"
+          ],
+          "description": "all storylines explore control slipping away — Skyler takes control from Walt, Walt refuses control of the empire, Gus controls the twins' vengeance",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "investigation",
+            "empire"
+          ],
+          "description": "Hank investigates the blue meth without knowing Walt created the formula Jesse is copying",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "control",
+            "vengeance"
+          ],
+          "description": "Gus directly intervenes to control the twins' timeline for killing Walt",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S03E04",
+      "events": [
+        {
+          "event": "Walt confronts Ted Beneke at his office and makes a veiled threat",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "ted"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Security escorts Walt out of Ted's office",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt smashes a glass table in frustration at home",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt Jr. blames Skyler for provoking his father",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walter_jr",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler files a restraining order against Walt",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Police arrive to remove Walt from the house",
+          "storyline": "family",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt moves into a small condo apartment",
+          "storyline": "family",
+          "function": "resolution",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse sells his substandard meth and grows frustrated with the quality",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse visits Saul asking for new distribution contacts",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "saul"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Saul tells Jesse that Gus wants Walt and there's a place for Jesse if he brings Walt back",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "saul",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse dismisses the idea, insisting he can build his own business",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank picks a bar fight with two strangers to feel a rush of control",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "A bouncer pulls Hank off the strangers",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Marie notices Hank's behavioral changes and presses him",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "marie",
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank deflects Marie's concerns with jokes",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus invites Walt to tour the superlab",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "gus",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt sees the state-of-the-art equipment worth millions",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus appeals to Walt's pride, saying he should not hide from his gifts",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "gus",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt declines Gus's offer again but is visibly tempted",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus accepts the refusal calmly but tells Walt the offer stands",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "The Salamanca twins surveil Walt from a distance",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "leonel",
+            "marco"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus's associate redirects the twins' vengeance toward Hank instead of Walt",
+          "storyline": "control",
+          "function": "escalation",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": []
+        },
+        {
+          "event": "The twins accept Hank as their new target",
+          "storyline": "vengeance",
+          "function": "turning_point",
+          "characters": [
+            "leonel",
+            "marco"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt sits alone in his bare apartment, staring at the three-million-dollar napkin",
+          "storyline": "empire",
+          "function": "cliffhanger",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the cost of pride and isolation",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "family",
+            "survival",
+            "investigation"
+          ],
+          "description": "all storylines explore characters isolated by their pride and choices — Walt alone in his apartment, Jesse insisting on independence, Hank hiding his trauma",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "vengeance",
+            "investigation"
+          ],
+          "description": "the audience knows the twins now target Hank, but Hank remains unaware of the threat",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "control",
+            "vengeance"
+          ],
+          "description": "Gus manipulates the twins' vengeance to serve his control, redirecting them from Walt to Hank",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S03E05",
+      "events": [
+        {
+          "event": "Gus and Max pitch their blue meth to Don Eladio at his poolside estate",
+          "storyline": "control",
+          "function": "setup",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "Don Eladio orders Hector to execute Max as punishment for cooking without permission",
+          "storyline": "control",
+          "function": "escalation",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "Gus is forced to watch his partner die beside the pool",
+          "storyline": "control",
+          "function": "turning_point",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "Don Eladio spares Gus because of unexplained connections in Chile",
+          "storyline": "control",
+          "function": "seed",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "Gus invites Walt to dinner at his modest home and cooks a meal himself",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "gus",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus shares his philosophy that a man provides for his family even when not appreciated",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "gus",
+            "walt"
+          ],
+          "also_affects": [
+            "family"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt accepts Gus's offer of three months cooking for $15 million total",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt calls Jesse to inform him of the deal, but Jesse is angry and feels betrayed",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt visits the superlab for the first time as lead chemist and meets Gale",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "gale"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gale admires Walt's work, calling the blue meth the purest he has ever analyzed",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "gale"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt and Gale cook together and achieve 99.1 percent purity",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "gale"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank discovers the blue meth has returned at original purity, meaning the original cook is active",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse cooks his own batch in his duplex and begins selling through his crew",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the cost of providing",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "control",
+            "survival"
+          ],
+          "description": "all three storylines explore different aspects of providing and sacrifice — Walt providing for family through crime, Gus's decades-long quest for vengeance as providing justice for Max, Jesse providing for himself by going independent",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "investigation"
+          ],
+          "description": "Hank realizes the original cook is back just as Walt officially becomes Gus's lead chemist",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "survival"
+          ],
+          "description": "Walt's acceptance of Gus's offer directly creates Jesse's independent operation, setting up territorial conflict",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S03E06",
+      "events": [
+        {
+          "event": "Walt and Gale work together in the superlab, producing large quantities of blue meth with consistent purity",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "walt",
+            "gale"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt notices Gale is logging every step of the process in a personal notebook, learning to replicate the cook independently",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "gale"
+          ],
+          "also_affects": [
+            "control"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt realizes that once Gale masters the formula, Gus will no longer need Walt and could dispose of him",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "control"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt manufactures a complaint about Gale's performance, telling Gus that Gale is not up to standard and demands Jesse as his assistant",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "gus"
+          ],
+          "also_affects": [
+            "control",
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus, skeptical of Jesse's reliability, reluctantly agrees and reassigns Gale to another facility",
+          "storyline": "control",
+          "function": "escalation",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse accepts the offer and joins Walt in the superlab",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank's investigation leads him to the RV through records checks, tracing it to Jesse Pinkman",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank confronts Jesse at his duplex about the RV",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse calls Walt in a panic about Hank finding the RV",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt races to the junkyard where the RV is stored with Old Joe",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank follows Jesse's phone GPS to the junkyard and arrives as Walt hides inside the RV",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Old Joe blocks Hank from entering the RV by citing it as a domicile, requiring a warrant",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "guest:old_joe",
+            "hank"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt has Saul's secretary call Hank with a fake emergency about Marie being in a car accident",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank abandons the warrant and races to the hospital, giving Old Joe time to crush the RV",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Old Joe crushes the RV into a cube of scrap metal",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "guest:old_joe"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank arrives at the hospital, finds Marie perfectly fine, and realizes he has been tricked",
+          "storyline": "investigation",
+          "function": "climax",
+          "characters": [
+            "hank",
+            "marie"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Enraged Hank drives to Jesse's duplex, pounds on the door, and beats Jesse severely when he opens it",
+          "storyline": "investigation",
+          "function": "resolution",
+          "characters": [
+            "hank",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse calls 911 after being beaten by Hank",
+          "storyline": "survival",
+          "function": "resolution",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the price of survival",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "survival",
+            "investigation"
+          ],
+          "description": "all three storylines explore survival tactics — Walt manipulates to survive Gus's control, Jesse survives by partnering with Walt, Hank's investigation threatens everyone's survival",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "investigation",
+            "survival"
+          ],
+          "description": "the audience knows Walt is hiding in the RV while Hank searches for evidence just feet away",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "survival"
+          ],
+          "description": "Walt's manipulation to get Jesse as his partner serves both his empire goals and survival needs",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S03E07",
+      "events": [
+        {
+          "event": "Flashback shows young Hank receiving his first major bust commendation and calling Marie to celebrate",
+          "storyline": "investigation",
+          "function": "setup",
+          "characters": [
+            "hank",
+            "marie"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "Jesse lies in hospital with shattered face and tells his attorney he will press full charges against Hank",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank is suspended from DEA and forced to surrender gun and badge",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Marie pleads with Jesse through Saul to drop charges but Jesse refuses",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "marie",
+            "saul"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt visits Jesse and persuades him to settle for 50-50 partnership in superlab cook",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse agrees to drop charges in exchange for equal partnership with Walt",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire",
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank sinks into depression at home without work",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "ASAC Merkert warns Hank the assault charge could end his career permanently",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "guest:merkert"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Marie tries to support Hank but he pushes her away",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "marie"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus recognizes disgraced DEA agent is less dangerous and does nothing to intervene",
+          "storyline": "control",
+          "function": "escalation",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Salamanca twins acquire chrome-plated fire axes and plan attack on Hank",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "leonel",
+            "marco"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus anonymously tips off Hank with one-minute warning about the twins",
+          "storyline": "control",
+          "function": "turning_point",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": [
+            "investigation",
+            "vengeance"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Twins arrive and open fire on unarmed Hank in parking lot",
+          "storyline": "vengeance",
+          "function": "climax",
+          "characters": [
+            "leonel",
+            "marco",
+            "hank"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank uses SUV to ram Leonel, crushing his legs",
+          "storyline": "investigation",
+          "function": "climax",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Marco buries axe in Hank's back",
+          "storyline": "vengeance",
+          "function": "climax",
+          "characters": [
+            "marco",
+            "hank"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank finds Leonel's gun, loads hollow-point bullet, and shoots Marco through the head",
+          "storyline": "investigation",
+          "function": "climax",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Paramedics arrive to find Hank collapsed beside two cartel assassins",
+          "storyline": "investigation",
+          "function": "resolution",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "consequences and survival",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "investigation",
+            "vengeance",
+            "survival"
+          ],
+          "description": "all storylines explore how violence begets violence and the price of survival in a dangerous world",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "control",
+            "investigation",
+            "vengeance"
+          ],
+          "description": "Gus orchestrates events while Hank remains unaware of who is manipulating his fate",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "investigation",
+            "vengeance"
+          ],
+          "description": "the twins' quest for revenge directly collides with Hank's survival, creating the episode's climactic showdown",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S03E08",
+      "events": [
+        {
+          "event": "Walt, Jesse, Skyler, Walt Jr., and Marie rush to the hospital after learning Hank has been shot",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse",
+            "skyler",
+            "walter_jr",
+            "marie"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank undergoes surgery for multiple gunshot wounds and severe spinal injury",
+          "storyline": "investigation",
+          "function": "climax",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": [
+            "family"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Marie alternates between grief and rage, demanding answers from the DEA about the cartel hitmen",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "marie"
+          ],
+          "also_affects": [
+            "family"
+          ],
+          "devices": []
+        },
+        {
+          "event": "ASAC Merkert and the DEA team flood the hospital, launching a full investigation",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "guest:merkert"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt realizes the twins were hunting him and someone redirected them to Hank",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "control",
+            "vengeance"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt confronts Gus in the hospital parking lot about orchestrating the scenario",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "gus"
+          ],
+          "also_affects": [
+            "control"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus confirms he pointed the twins at Hank, then tipped Hank off to neutralize the cartel threat",
+          "storyline": "control",
+          "function": "climax",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": [
+            "empire",
+            "vengeance"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt realizes he is deeply in Gus's debt despite being horrified at using Hank as bait",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "control"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse cooks a batch alone at the superlab, achieving 96 percent purity",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse realizes he is more capable than he believed",
+          "storyline": "survival",
+          "function": "resolution",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Leonel Salamanca survives surgery but loses both legs",
+          "storyline": "vengeance",
+          "function": "resolution",
+          "characters": [
+            "leonel"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "DEA agents guard Leonel's room, hoping he will identify who sent him",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "guest:dea_agents"
+          ],
+          "also_affects": [
+            "control"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus visits Leonel posing as a Los Pollos Hermanos community representative",
+          "storyline": "control",
+          "function": "escalation",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike injects Leonel with a lethal substance when guards step away, killing him",
+          "storyline": "control",
+          "function": "resolution",
+          "characters": [
+            "mike",
+            "gus"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank wakes from surgery and learns he may never walk again",
+          "storyline": "investigation",
+          "function": "resolution",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": [
+            "family"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Marie holds Hank's hand as he stares at the ceiling",
+          "storyline": "family",
+          "function": "resolution",
+          "characters": [
+            "marie",
+            "hank"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt returns home alone, understanding the full scope of Gus's ruthlessness",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "control"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the price of power and protection",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "control",
+            "investigation",
+            "family"
+          ],
+          "description": "all storylines explore how protection comes at a devastating cost — Gus protects Walt by sacrificing Hank, Walt's family pays for his empire, Hank's investigation costs him his mobility",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "investigation",
+            "family"
+          ],
+          "description": "the family grieves for Hank not knowing Walt's crimes caused the attack",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "control",
+            "vengeance",
+            "empire"
+          ],
+          "description": "Gus's manipulation eliminates the Salamanca threat while binding Walt deeper into his operation",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S03E09",
+      "events": [
+        {
+          "event": "Hank lies conscious but paralyzed in his hospital bed, beginning physical rehabilitation",
+          "storyline": "investigation",
+          "function": "setup",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Marie pushes doctors for aggressive treatment and learns about expensive Colorado spinal therapy facility",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "marie"
+          ],
+          "also_affects": [
+            "family"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Marie brings the financial problem to Skyler about Hank's treatment costs",
+          "storyline": "family",
+          "function": "setup",
+          "characters": [
+            "marie",
+            "skyler"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Skyler proposes using Walt's drug money for Hank's treatment with gambling cover story",
+          "storyline": "family",
+          "function": "turning_point",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt agrees to fund Hank's recovery to keep family obligated and explain future cash",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler crafts detailed gambling narrative and rehearses Walt on specifics",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse and Walt cook together in the superlab but Jesse grows restless with routine",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse skims meth from each cook and hides it in his locker before weighing",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse sells stolen meth through Badger and Skinny Pete for independent revenue",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus's distribution manager notices blue meth appearing outside controlled channels",
+          "storyline": "control",
+          "function": "escalation",
+          "characters": [
+            "guest:distribution_manager"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Distribution manager reports unauthorized blue meth sales to Gus",
+          "storyline": "control",
+          "function": "escalation",
+          "characters": [
+            "guest:distribution_manager",
+            "gus"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse meets Andrea Cantillo at Narcotics Anonymous and begins spending time with her",
+          "storyline": "survival",
+          "function": "setup",
+          "characters": [
+            "jesse",
+            "andrea"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse learns Andrea has a young son named Brock and develops genuine feelings",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "andrea"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Andrea reveals her brother Tomas works as corner boy for dealers who killed Combo",
+          "storyline": "love",
+          "function": "turning_point",
+          "characters": [
+            "andrea",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse confronts reality that his drug profits destroy children in his community",
+          "storyline": "love",
+          "function": "climax",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the cost of choices",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "family",
+            "love",
+            "survival"
+          ],
+          "description": "all storylines explore how characters use others to justify their choices — Walt uses family obligation, Jesse uses profit motive, but both face the human cost",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "family",
+            "investigation"
+          ],
+          "description": "Skyler and Walt use drug money to help the DEA agent hunting them",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "survival",
+            "control"
+          ],
+          "description": "Jesse's independent operation threatens Gus's control, setting up future conflict",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S03E10",
+      "events": [
+        {
+          "event": "Walt becomes obsessed with a fly in the superlab and refuses to cook until it's eliminated",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse considers Walt's fly concern absurd but goes along with the hunt",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "They spend hours chasing the fly with makeshift tools and equipment",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse climbs equipment and nearly falls while hunting the fly",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt, exhausted and sleep-deprived, begins talking about the night Jane died",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt tells Jesse there's a moment when a person has gone too far",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse listens but doesn't understand the full weight of Walt's words",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse slips a sleeping pill into Walt's coffee to end the obsession",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt drowses on the lab floor while Jesse kills the fly",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse shows Walt the dead fly and they resume cooking",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "The batch is completed and meets purity standards",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt notices a discrepancy in the yield and suspects theft",
+          "storyline": "empire",
+          "function": "seed",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt watches Jesse with new suspicion but says nothing",
+          "storyline": "empire",
+          "function": "seed",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse drives home with stolen meth in his glove compartment",
+          "storyline": "survival",
+          "function": "seed",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt lies in bed staring at the ceiling where another fly lands",
+          "storyline": "empire",
+          "function": "seed",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "contamination and guilt",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "survival"
+          ],
+          "description": "both storylines explore contamination — Walt's obsession with the fly mirrors his guilt contaminating everything, while Jesse's theft contaminates their partnership",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "survival"
+          ],
+          "description": "the audience knows Walt let Jane die and that Jesse is stealing, while each character is unaware of what the other has done",
+          "subtype": null
+        },
+        {
+          "type": "meta",
+          "lines": [
+            "empire"
+          ],
+          "description": "the fly serves as a metaphor for Walt's guilt and the contamination of his moral boundaries",
+          "subtype": "metaphorical_device"
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S03E11",
+      "events": [
+        {
+          "event": "Jesse attends Narcotics Anonymous meetings to identify potential customers for stolen meth",
+          "storyline": "love",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse meets Andrea Cantillo at NA and initially targets her as a buyer",
+          "storyline": "survival",
+          "function": "setup",
+          "characters": [
+            "jesse",
+            "andrea"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse spends time with Andrea and her son Brock, developing genuine feelings",
+          "storyline": "love",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "andrea"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Andrea reveals her brother Tomas has been recruited as a corner boy by local dealers",
+          "storyline": "love",
+          "function": "turning_point",
+          "characters": [
+            "andrea",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse realizes Tomas is the child who killed Combo on the dealers' orders",
+          "storyline": "love",
+          "function": "climax",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt reviews lab logs and calculates someone has been skimming product",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt confronts Jesse about stealing meth to sell through Skinny Pete and Badger",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse admits to the theft and dismisses Walt's warnings about Gus",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Gus and Mike are already aware of the missing product but haven't acted",
+          "storyline": "control",
+          "function": "escalation",
+          "characters": [
+            "gus",
+            "mike"
+          ],
+          "also_affects": [
+            "empire",
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler coaches Walt on gambling cover story details for his drug money",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler presents gambling story to Hank and Marie to justify paying for therapy",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "hank",
+            "marie"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank accepts the gambling explanation without scrutiny due to his depression",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": [
+            "family"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse sees Tomas outside Andrea's apartment, confronting the reality of the child's situation",
+          "storyline": "love",
+          "function": "resolution",
+          "characters": [
+            "jesse",
+            "guest:tomas"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse sits in his car with his gun, contemplating action against the dealers",
+          "storyline": "survival",
+          "function": "cliffhanger",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "love"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the corruption of innocence",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "love",
+            "survival",
+            "family"
+          ],
+          "description": "all three storylines explore how criminal activity destroys innocent relationships and family bonds",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "control",
+            "empire",
+            "survival"
+          ],
+          "description": "Gus knows about Jesse's theft while Walt and Jesse remain unaware of being watched",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "family",
+            "investigation"
+          ],
+          "description": "Hank unknowingly accepts money from the criminal he's hunting to pay for his own recovery",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "love",
+            "survival"
+          ],
+          "description": "Jesse's romantic feelings for Andrea collide with the violent reality of his criminal world through Tomas",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S03E12",
+      "events": [
+        {
+          "event": "Mike tells Walt the story of the domestic violence call and the half measures",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "mike",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "Jesse buys a pistol and tells Walt he's going to kill the dealers",
+          "storyline": "love",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt pleads with Jesse to stand down and goes to Gus for a meeting",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "love"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus arranges a desert meeting with the dealers, Walt, Jesse, and Mike",
+          "storyline": "control",
+          "function": "escalation",
+          "characters": [
+            "gus",
+            "walt",
+            "jesse",
+            "mike"
+          ],
+          "also_affects": [
+            "empire",
+            "love"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt demands justice for Tomas but Gus sides with his dealers",
+          "storyline": "control",
+          "function": "turning_point",
+          "characters": [
+            "gus",
+            "walt"
+          ],
+          "also_affects": [
+            "empire",
+            "love"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse agrees to the truce under duress",
+          "storyline": "love",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "control"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse drives to the dealers' corner with his gun drawn",
+          "storyline": "love",
+          "function": "climax",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt's car slams into both dealers at full speed",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "love",
+            "control"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt shoots the surviving dealer in the head at point-blank range",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "love",
+            "control"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt tells Jesse to run and Jesse flees the scene",
+          "storyline": "love",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus receives word of the killings and realizes Walt is now an enemy",
+          "storyline": "control",
+          "function": "climax",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Mike drives to the scene to assess the damage",
+          "storyline": "control",
+          "function": "resolution",
+          "characters": [
+            "mike"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the cost of loyalty",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "love",
+            "control"
+          ],
+          "description": "all three storylines explore the consequences of choosing loyalty over pragmatism — Walt chooses Jesse over Gus, Jesse chooses vengeance for Tomas over survival, Gus must choose between his dealers and his operation",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "love",
+            "control"
+          ],
+          "description": "all storylines physically converge in the street confrontation where Walt's choice to save Jesse destroys his relationship with Gus",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "control"
+          ],
+          "description": "the audience understands that Walt's heroic gesture has actually doomed his position with Gus, while Walt believes he's solved the problem",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S03E13",
+      "events": [
+        {
+          "event": "Flashback shows Walt and Skyler touring their future house when Walt was still a Gray Matter partner",
+          "storyline": "family",
+          "function": "setup",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "Gus reinstates Gale in the superlab to learn Walt's cooking process",
+          "storyline": "control",
+          "function": "escalation",
+          "characters": [
+            "gus",
+            "gale"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt recognizes that Gale's presence means his death sentence",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt confronts Gus directly, arguing he and Jesse are indispensable",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "gus"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike begins following Walt and Jesse on Gus's orders",
+          "storyline": "control",
+          "function": "escalation",
+          "characters": [
+            "mike",
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "empire",
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt meets with Saul to discuss escape options via disappearer",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "saul"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt calculates the cost against family obligations and rejects escape",
+          "storyline": "family",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt concludes Gale must die to ensure his survival",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt approaches Jesse with the plan to kill Gale",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse recoils at killing innocent Gale, Walt argues it's them or Gale",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike picks up Walt at gunpoint and drives him to the superlab",
+          "storyline": "control",
+          "function": "escalation",
+          "characters": [
+            "mike",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus decides to kill Walt tonight and have Gale take over the lab",
+          "storyline": "control",
+          "function": "climax",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt pleads for one phone call to say goodbye to his family",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt calls Jesse and gives him Gale's address in coded language",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse drives across Albuquerque to Gale's apartment",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gale opens the door, recognizes something is wrong, and begs Jesse not to do this",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "jesse",
+            "gale"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse, crying, raises his gun and pulls the trigger",
+          "storyline": "survival",
+          "function": "cliffhanger",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire",
+            "control"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the corruption of innocence",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "family",
+            "survival",
+            "control"
+          ],
+          "description": "all storylines explore how far characters will go to protect what they value, corrupting their moral foundations",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "control"
+          ],
+          "description": "Mike and Victor believe Walt is calling his family, but the audience knows he's orchestrating Gale's murder",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "survival",
+            "control"
+          ],
+          "description": "all three storylines converge in the final moments as Jesse's action simultaneously saves Walt, destroys Gus's plan, and forces Jesse to cross a moral line",
+          "subtype": null
+        },
+        {
+          "type": "meta",
+          "lines": [
+            "family"
+          ],
+          "description": "the flashback serves as emotional counterpoint, showing Walt's lost innocence and potential",
+          "subtype": "flashback"
+        }
+      ],
+      "patches": []
+    }
+  ],
+  "usage": "17 requests, 63,748 input + 23,901 output tokens, ~$0.453"
+}
\ No newline at end of file
diff --git a/docs/knowledge/results/bb-s04-result.json b/docs/knowledge/results/bb-s04-result.json
new file mode 100644
index 0000000..ee4c392
--- /dev/null
+++ b/docs/knowledge/results/bb-s04-result.json
@@ -0,0 +1,3407 @@
+{
+  "context": {
+    "franchise_type": "serial",
+    "story_engine": "A high school teacher builds a drug empire, testing how far he'll go for family and control",
+    "genre": "drama",
+    "format": "ongoing"
+  },
+  "cast": [
+    {
+      "id": "walt",
+      "name": "Walter White",
+      "aliases": [
+        "Walt",
+        "Walter",
+        "Heisenberg",
+        "Mr. White"
+      ]
+    },
+    {
+      "id": "jesse",
+      "name": "Jesse Pinkman",
+      "aliases": [
+        "Jesse"
+      ]
+    },
+    {
+      "id": "skyler",
+      "name": "Skyler White",
+      "aliases": [
+        "Skyler"
+      ]
+    },
+    {
+      "id": "hank",
+      "name": "Hank Schrader",
+      "aliases": [
+        "Hank"
+      ]
+    },
+    {
+      "id": "marie",
+      "name": "Marie Schrader",
+      "aliases": [
+        "Marie"
+      ]
+    },
+    {
+      "id": "gus",
+      "name": "Gustavo Fring",
+      "aliases": [
+        "Gus",
+        "Gus Fring"
+      ]
+    },
+    {
+      "id": "mike",
+      "name": "Mike Ehrmantraut",
+      "aliases": [
+        "Mike"
+      ]
+    },
+    {
+      "id": "saul",
+      "name": "Saul Goodman",
+      "aliases": [
+        "Saul"
+      ]
+    },
+    {
+      "id": "hector",
+      "name": "Hector Salamanca",
+      "aliases": [
+        "Hector"
+      ]
+    },
+    {
+      "id": "andrea",
+      "name": "Andrea Cantillo",
+      "aliases": [
+        "Andrea"
+      ]
+    },
+    {
+      "id": "brock",
+      "name": "Brock Cantillo",
+      "aliases": [
+        "Brock"
+      ]
+    },
+    {
+      "id": "ted",
+      "name": "Ted Beneke",
+      "aliases": [
+        "Ted"
+      ]
+    },
+    {
+      "id": "tyrus",
+      "name": "Tyrus Kitt",
+      "aliases": [
+        "Tyrus"
+      ]
+    },
+    {
+      "id": "don_eladio",
+      "name": "Don Eladio Vuente",
+      "aliases": [
+        "Don Eladio"
+      ]
+    },
+    {
+      "id": "gomez",
+      "name": "Steven Gomez",
+      "aliases": [
+        "Gomez"
+      ]
+    }
+  ],
+  "plotlines": [
+    {
+      "id": "survival",
+      "name": "Walt: Survival",
+      "driver": "walt",
+      "goal": "survive Gus's plan to replace and kill him",
+      "obstacle": "Gus's manipulation of Jesse, isolation from allies, lack of resources",
+      "stakes": "death, family exposure, complete defeat",
+      "type": "serialized",
+      "rank": "A",
+      "nature": "plot-led",
+      "confidence": "solid",
+      "devices": [
+        "dramatic_irony"
+      ],
+      "span": [
+        "S04E01",
+        "S04E02",
+        "S04E03",
+        "S04E04",
+        "S04E05",
+        "S04E06",
+        "S04E07",
+        "S04E08",
+        "S04E09",
+        "S04E10",
+        "S04E11",
+        "S04E12",
+        "S04E13"
+      ]
+    },
+    {
+      "id": "loyalty",
+      "name": "Jesse: Loyalty",
+      "driver": "jesse",
+      "goal": "find his place and purpose within Gus's organization",
+      "obstacle": "guilt over killing Gale, Walt's manipulation, conflicting allegiances",
+      "stakes": "identity, belonging, moral corruption",
+      "type": "serialized",
+      "rank": "B",
+      "nature": "character-led",
+      "confidence": "solid",
+      "devices": [],
+      "span": [
+        "S04E01",
+        "S04E02",
+        "S04E03",
+        "S04E04",
+        "S04E05",
+        "S04E06",
+        "S04E07",
+        "S04E09",
+        "S04E10",
+        "S04E12",
+        "S04E13"
+      ]
+    },
+    {
+      "id": "vengeance",
+      "name": "Gus: Vengeance",
+      "driver": "gus",
+      "goal": "destroy the cartel and complete his decades-long revenge",
+      "obstacle": "cartel's power, Walt's unpredictability, DEA investigation",
+      "stakes": "death, empire destruction, unfulfilled justice",
+      "type": "serialized",
+      "rank": "B",
+      "nature": "plot-led",
+      "confidence": "solid",
+      "devices": [
+        "flashback"
+      ],
+      "span": [
+        "S04E02",
+        "S04E07",
+        "S04E08",
+        "S04E10",
+        "S04E11",
+        "S04E13"
+      ]
+    },
+    {
+      "id": "investigation",
+      "name": "Hank: Investigation",
+      "driver": "hank",
+      "goal": "uncover the truth behind Gale's murder and the blue meth operation",
+      "obstacle": "physical disability, DEA bureaucracy, lack of direct evidence",
+      "stakes": "career vindication, public safety, family danger",
+      "type": "serialized",
+      "rank": "C",
+      "nature": "plot-led",
+      "confidence": "solid",
+      "devices": [
+        "dramatic_irony"
+      ],
+      "span": [
+        "S04E01",
+        "S04E02",
+        "S04E03",
+        "S04E04",
+        "S04E05",
+        "S04E06",
+        "S04E07",
+        "S04E08",
+        "S04E09",
+        "S04E11",
+        "S04E12",
+        "S04E13"
+      ]
+    },
+    {
+      "id": "laundering",
+      "name": "Skyler: Laundering",
+      "driver": "skyler",
+      "goal": "successfully launder Walt's drug money through the car wash",
+      "obstacle": "overwhelming cash volume, maintaining legitimate appearance, Ted's complications",
+      "stakes": "IRS exposure, family destruction, criminal prosecution",
+      "type": "serialized",
+      "rank": "B",
+      "nature": "plot-led",
+      "confidence": "solid",
+      "devices": [],
+      "span": [
+        "S04E01",
+        "S04E02",
+        "S04E03",
+        "S04E04",
+        "S04E05",
+        "S04E06",
+        "S04E07",
+        "S04E12"
+      ]
+    }
+  ],
+  "episodes": [
+    {
+      "episode": "S04E01",
+      "events": [
+        {
+          "event": "Gus arrives at the superlab where Walt and Jesse are held at gunpoint by Mike",
+          "storyline": "survival",
+          "function": "setup",
+          "characters": [
+            "gus",
+            "walt",
+            "jesse",
+            "mike"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus changes into work clothes without speaking to Walt or Jesse",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus slashes Victor's throat with a box cutter in front of Walt, Jesse, and Mike",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "gus",
+            "guest:victor"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus tells Walt and Jesse to get back to work after cleaning himself",
+          "storyline": "survival",
+          "function": "resolution",
+          "characters": [
+            "gus",
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt and Jesse dissolve Victor's body in hydrofluoric acid and clean the lab in stunned silence",
+          "storyline": "loyalty",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Skyler drives to Walt's condo and finds the door locked",
+          "storyline": "laundering",
+          "function": "setup",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler talks her way past the landlord claiming Walt may be injured inside",
+          "storyline": "laundering",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "guest:landlord"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler finds the condo empty and leaves repeated voicemails Walt cannot answer",
+          "storyline": "laundering",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt comes home visibly shaken but tells Skyler nothing about what happened",
+          "storyline": "laundering",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler presses forward with the car wash plan despite Walt's state, reminding him about Bogdan's refusal",
+          "storyline": "laundering",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank works obsessively from bed on the Gale Boetticher murder case",
+          "storyline": "investigation",
+          "function": "setup",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank examines Gale's notebook and finds chemistry notes suggesting a large-scale meth operation",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank tells Gomez that Gale may have been the cook behind the blue meth",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank",
+            "gomez"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse sits alone at Denny's restaurant staring blankly, deeply traumatized",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt visits Jesse and finds him in a fragile state",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt urges Jesse to hold himself together because Gus is looking for reasons to eliminate them",
+          "storyline": "loyalty",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt buys a snub-nosed revolver from a black-market dealer",
+          "storyline": "survival",
+          "function": "seed",
+          "characters": [
+            "walt",
+            "guest:dealer"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the price of survival",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "survival",
+            "loyalty",
+            "laundering"
+          ],
+          "description": "all three storylines explore what characters sacrifice to survive - Walt and Jesse their humanity, Skyler her moral boundaries",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "survival",
+            "investigation"
+          ],
+          "description": "Hank's theory that Gale was the mastermind actually protects Walt, while the audience knows Walt is the real target",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "survival",
+            "laundering"
+          ],
+          "description": "Skyler doesn't know Walt nearly died and is planning armed resistance while she pushes forward with money laundering",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S04E02",
+      "events": [
+        {
+          "event": "Walt purchases a .38 revolver and practices drawing it, rehearsing shooting Gus",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt goes to Los Pollos Hermanos asking to see Gus",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike intercepts Walt in the parking lot and takes his gun",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "mike"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike tells Walt that Gus will never put himself in a vulnerable position",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "mike"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt realizes direct confrontation is impossible and needs a different strategy",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse hosts a continuous party with drug users to avoid being alone with his thoughts",
+          "storyline": "loyalty",
+          "function": "setup",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse uses his meth earnings to keep the party running around the clock",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse sits in the chaos looking hollow and disconnected",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "When the house empties, Jesse immediately turns music back up and invites more people",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt visits Jesse to discuss strategy but sees he's in no condition to plan",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank redirects his frustration into investigating Gale's lab notes",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Marie patiently manages Hank's care while he treats her dismissively",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "marie",
+            "hank"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank asks Gomez to bring more evidence files from the Boetticher case",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "gomez"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Gomez reluctantly complies, noting the case is officially winding down",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "gomez"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler hires an environmental inspector to flag the car wash for contamination",
+          "storyline": "laundering",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler presents the contamination scheme to Walt as pressure to force Bogdan to sell",
+          "storyline": "laundering",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt is impressed by Skyler's resourcefulness but unsettled by her natural deception",
+          "storyline": "laundering",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike meets with Gus to discuss the Walt problem",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "mike",
+            "gus"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Gus tells Mike to be patient, signaling he has a longer-term plan",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Mike expresses concern that Walt and Jesse's instability increases exposure risk",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "mike"
+          ],
+          "also_affects": [
+            "survival",
+            "loyalty"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        }
+      ],
+      "theme": "the futility of control",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "survival",
+            "loyalty",
+            "laundering",
+            "control"
+          ],
+          "description": "all storylines explore characters trying to control their circumstances through increasingly desperate or deceptive means",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "survival",
+            "vengeance",
+            "investigation"
+          ],
+          "description": "the audience knows Gus and Mike are planning Walt's demise while Walt seeks strategy, and that Hank is investigating the very operation Walt runs",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "survival",
+            "loyalty"
+          ],
+          "description": "Walt's need for Jesse as an ally conflicts with Jesse's psychological breakdown after killing Gale",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S04E03",
+      "events": [
+        {
+          "event": "Marie visits open houses under false identities and steals small decorative items",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "marie"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Marie adopts elaborate fictional personas and tells invented stories to real estate agents",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "marie"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Marie attends multiple open houses in a single day, stealing with increasing boldness",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "marie"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "A real estate agent grows suspicious and confronts Marie, who deflects and leaves quickly",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "marie",
+            "guest:real_estate_agent"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler's environmental pressure tactic forces Bogdan to face potential regulatory scrutiny",
+          "storyline": "laundering",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler negotiates aggressively with Bogdan for the car wash sale",
+          "storyline": "laundering",
+          "function": "turning_point",
+          "characters": [
+            "skyler",
+            "guest:bogdan"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Bogdan agrees to sell the A1A Car Wash below his original asking price",
+          "storyline": "laundering",
+          "function": "climax",
+          "characters": [
+            "skyler",
+            "guest:bogdan"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt and Skyler officially own the car wash as their money laundering front",
+          "storyline": "laundering",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler begins studying how to run the legitimate car wash operation",
+          "storyline": "laundering",
+          "function": "seed",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse's house party continues with him handing out cash freely to anyone",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "A partygoer steals money from Jesse's drawer while Jesse doesn't notice or care",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "guest:partygoer"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt visits Jesse and grows alarmed at his deteriorating self-destructive behavior",
+          "storyline": "loyalty",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse refuses to engage with Walt about Gus or the lab work",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt cooks alone at the superlab because Jesse shows up late and impaired",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt tells Jesse their survival depends on flawless performance since Gus seeks any excuse to replace them",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse responds with indifference, saying Gus will kill them eventually regardless",
+          "storyline": "loyalty",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank finds a handwritten dedication to 'W.W.' in Gale's notebook",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank puzzles over the W.W. initials but doesn't connect them to Walt",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank casually mentions the W.W. notation to Marie as an interesting lead",
+          "storyline": "investigation",
+          "function": "seed",
+          "characters": [
+            "hank",
+            "marie"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        }
+      ],
+      "theme": "the illusion of control through self-destruction",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "control",
+            "loyalty",
+            "laundering"
+          ],
+          "description": "all three storylines show characters seeking control through destructive means — Marie through theft, Jesse through self-destruction, Skyler through criminal enterprise",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "investigation",
+            "survival"
+          ],
+          "description": "the audience knows Walt is W.W. and that Hank's discovery threatens Walt's survival, but Hank doesn't realize the connection",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "survival",
+            "loyalty"
+          ],
+          "description": "Jesse's self-destructive spiral directly threatens Walt's survival strategy with Gus",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S04E04",
+      "events": [
+        {
+          "event": "Hank discovers Gale's karaoke video singing 'Major Tom'",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank and Marie watch the video and find Gale endearing but telling",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "marie"
+          ],
+          "also_affects": [
+            "control"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank invites Walt and Skyler for dinner to discuss the case",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler rehearses the gambling cover story with Walt",
+          "storyline": "laundering",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler corrects Walt on details to keep their story airtight",
+          "storyline": "laundering",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank shows Walt Gale's lab notebook seeking his expert opinion",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "hank"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt downplays Gale's expertise, calling him a competent student not a genius",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt tells Hank the real mastermind is probably still out there",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt delivers the gambling cover story convincingly at dinner",
+          "storyline": "laundering",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank and Marie accept the gambling explanation without skepticism",
+          "storyline": "laundering",
+          "function": "resolution",
+          "characters": [
+            "hank",
+            "marie"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt's deflection reignites Hank's curiosity about the case",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse's house party winds down with guests stripping everything valuable",
+          "storyline": "loyalty",
+          "function": "setup",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse sits alone in his empty, trashed living room",
+          "storyline": "loyalty",
+          "function": "setup",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike arrives and orders Jesse to ride with him for pickups",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "mike",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike drives Jesse to various distribution points while Jesse sits doing nothing",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "mike",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse spots a man approaching with apparent hostile intent but it's just a routine delivery",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "guest:delivery_man"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt grows suspicious when Jesse mentions spending the day with Mike",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt confronts Jesse, warning him that Gus is manipulating him to replace Walt",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse dismisses Walt's concerns and calls him paranoid",
+          "storyline": "loyalty",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        }
+      ],
+      "theme": "the unintended consequences of deception",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "survival",
+            "laundering",
+            "loyalty"
+          ],
+          "description": "all three storylines involve characters trying to control narratives and information, but their actions create unexpected complications",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "survival",
+            "investigation"
+          ],
+          "description": "Walt's attempt to deflect suspicion from Gale actually reignites Hank's investigation, while Hank unknowingly seeks advice from the very criminal he's hunting",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "survival",
+            "loyalty"
+          ],
+          "description": "Walt correctly identifies Gus's manipulation of Jesse, but Jesse can't see it and views Walt as paranoid, not protective",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S04E05",
+      "events": [
+        {
+          "event": "Mike takes Jesse on money pickups across desert and rural New Mexico",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "mike",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "A man attacks Mike and Jesse, trying to steal the money bag",
+          "storyline": "loyalty",
+          "function": "turning_point",
+          "characters": [
+            "jesse",
+            "mike",
+            "guest:attacker"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse grabs the bag and drives away in Mike's car, saving the cash",
+          "storyline": "loyalty",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike dispatches the attacker and tells Jesse he handled himself well",
+          "storyline": "loyalty",
+          "function": "climax",
+          "characters": [
+            "mike",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse shows genuine engagement and energy for the first time since killing Gale",
+          "storyline": "loyalty",
+          "function": "resolution",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus observes from a distance, confirming the entire scenario was staged",
+          "storyline": "loyalty",
+          "function": "resolution",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Mike acknowledges to Gus that the plan is working to build Jesse's loyalty",
+          "storyline": "loyalty",
+          "function": "resolution",
+          "characters": [
+            "mike",
+            "gus"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt works alone in the superlab, unable to maintain production schedule",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt suspects Gus is deliberately separating him from Jesse to weaken his position",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt confronts Jesse, insisting the ride-alongs are manipulation to make him compliant",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse pushes back, saying someone finally treats him with respect instead of belittling him",
+          "storyline": "loyalty",
+          "function": "turning_point",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "The argument exposes the fracture: Walt sees Jesse as subordinate, Jesse sees Walt as controlling",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Skyler officially takes over A1A Car Wash operations, renaming it simply Car Wash",
+          "storyline": "laundering",
+          "function": "setup",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler studies the books and establishes systems for funneling Walt's drug money",
+          "storyline": "laundering",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler discovers Walt's cash volume far exceeds what the car wash can plausibly launder",
+          "storyline": "laundering",
+          "function": "turning_point",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler begins looking for ways to increase apparent revenue without drawing IRS attention",
+          "storyline": "laundering",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank takes his first steps with a walker in physical therapy",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank channels his frustration into the Boetticher case",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank asks Gomez to check industrial equipment purchases matching Gale's superlab notes",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "gomez"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Gomez pushes back saying the case isn't priority but agrees to run queries",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "gomez",
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "manipulation and genuine connection",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "loyalty",
+            "survival",
+            "laundering"
+          ],
+          "description": "all three storylines explore different forms of manipulation — Gus manipulating Jesse's loyalty, Walt trying to manipulate Jesse's perception, Skyler manipulating financial records",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "loyalty",
+            "survival"
+          ],
+          "description": "the audience knows Gus staged the attack to build Jesse's loyalty, while Walt correctly suspects manipulation but Jesse doesn't believe him",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "investigation",
+            "survival",
+            "laundering"
+          ],
+          "description": "Hank's investigation gets closer to Walt's operation while Walt and Skyler remain unaware of the threat",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S04E06",
+      "events": [
+        {
+          "event": "Walt tells Skyler someone at work is trying to kill him",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": [
+            "laundering"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Skyler suggests they use their money to disappear",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": [
+            "laundering"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt refuses to run, insisting he will not lose control",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler sends Holly and Walter Jr. to stay with Hank and Marie",
+          "storyline": "laundering",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt tries to recruit laundry workers to spy on Gus",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Laundry workers refuse and report Walt to Tyrus",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "tyrus"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Tyrus informs Gus of Walt's desperate recruitment attempt",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "tyrus",
+            "gus"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Mike assigns Jesse to collect payment from a skimming dealer",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "mike",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse successfully handles the confrontation and collects the money",
+          "storyline": "loyalty",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse earns Mike's quiet approval and develops working rapport",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "mike"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank visits the DEA office using a walking cane",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank examines Gale's evidence and finds Los Pollos Hermanos napkin",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank takes the evidence list home to study further",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler processes large batch of cash at the car wash",
+          "storyline": "laundering",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler realizes cash is accumulating faster than business can absorb",
+          "storyline": "laundering",
+          "function": "turning_point",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "isolation and desperation",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "survival",
+            "loyalty",
+            "laundering"
+          ],
+          "description": "all three storylines explore characters finding their place and purpose under pressure - Walt desperately trying to maintain control, Jesse finding his role in Gus's organization, Skyler taking control of what she can",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "survival",
+            "investigation"
+          ],
+          "description": "the audience knows Walt is Heisenberg and that Hank is getting closer to the truth through Gale's evidence, while neither character knows about the other's activities",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "recovery",
+            "investigation"
+          ],
+          "description": "Hank's physical recovery enables his return to investigative work, merging his personal and professional storylines",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S04E07",
+      "events": [
+        {
+          "event": "Jesse attends Narcotics Anonymous meeting and tells story of killing 'problem dog'",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse admits to the group he's really talking about killing a person",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse storms out when group won't judge him for the killing",
+          "storyline": "loyalty",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt asks Jesse to help kill Gus using ricin poison",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt argues Gus will kill them both once he finds replacement cook",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse agrees to carry ricin capsule but doesn't commit to using it",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse conceals ricin capsule inside marked cigarette",
+          "storyline": "survival",
+          "function": "setup",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank presents theory that Gale was murdered as part of larger drug operation",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank shows Walt Los Pollos Hermanos connection from Gale's effects",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt deflects Hank's theory while privately recognizing the danger",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Mike reports to Gus that Jesse is becoming reliable and loyal",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "mike",
+            "gus"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus approves bringing Jesse further in to make Walt expendable",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": [
+            "survival",
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Mike warns Gus that Walt is unpredictable and may act desperately",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "mike"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus increases surveillance on Walt through Tyrus",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Skyler tells Walt they need to discuss exit strategy",
+          "storyline": "laundering",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt refuses to elaborate on how he'll resolve Gus situation",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "laundering"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the burden of moral compromise",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "survival",
+            "loyalty",
+            "vengeance"
+          ],
+          "description": "all three storylines explore characters grappling with the moral weight of their choices - Jesse seeking judgment for killing Gale, Walt justifying murder as survival, Gus calculating human expendability",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "investigation",
+            "survival"
+          ],
+          "description": "Hank unknowingly shares his investigation progress with the very person he's hunting",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "survival",
+            "loyalty",
+            "vengeance"
+          ],
+          "description": "Walt's ricin plan forces Jesse to choose between his growing loyalty to Gus and his partnership with Walt, while Gus moves to eliminate Walt",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S04E08",
+      "events": [
+        {
+          "event": "Young Gus and Max meet with Don Eladio at his poolside estate to pitch a meth partnership",
+          "storyline": "vengeance",
+          "function": "setup",
+          "characters": [
+            "gus",
+            "don_eladio"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "Max explains the chemistry and profitability of meth over cocaine to Don Eladio",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "guest:max",
+            "don_eladio"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "Don Eladio takes offense at Gus and Max's presumptuousness in distributing samples without permission",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "don_eladio",
+            "gus"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "Hector mocks Gus's Chilean background and shows contempt for him",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "hector",
+            "gus"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "Hector shoots and kills Max at the poolside on Don Eladio's orders",
+          "storyline": "vengeance",
+          "function": "climax",
+          "characters": [
+            "hector",
+            "guest:max"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "Gus is forced to watch Max's execution and lies next to his body at the pool's edge",
+          "storyline": "vengeance",
+          "function": "resolution",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "Gus visits wheelchair-bound Hector at Casa Tranquila nursing home",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "gus",
+            "hector"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus informs Hector that the Salamanca family influence is finished and his nephews are dead",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "gus",
+            "hector"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank requests a DEA background check on Gustavo Fring",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "The background check on Gus comes back clean with no criminal record",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "ASAC Merkert warns Hank that Gus is a DEA friend and donor, telling him to drop the investigation",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "guest:merkert"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank agrees to back off officially but continues examining Gale's notes at home",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt grows anxious when Jesse reports he hasn't found an opportunity to use the ricin on Gus",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt presses Jesse to act quickly with the ricin, but Jesse insists he needs the right moment",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the weight of the past",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "vengeance",
+            "investigation",
+            "survival"
+          ],
+          "description": "all storylines deal with past actions driving present consequences — Gus's trauma motivates his revenge, Hank's investigation uncovers hidden history, Walt's past choices trap him in survival mode",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "investigation",
+            "survival",
+            "vengeance"
+          ],
+          "description": "the audience knows Gus's true nature and history while Hank sees only a clean businessman, and Walt doesn't understand the depth of Gus's long-term planning",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "survival",
+            "loyalty"
+          ],
+          "description": "Walt's desperation to survive increasingly conflicts with Jesse's growing loyalty to Gus's organization",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S04E09",
+      "events": [
+        {
+          "event": "Walt plants a GPS tracking device on Gus's car",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt monitors Gus's routine from his laptop and shares intel with Jesse",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt urges Jesse to use the ricin at the first opportunity",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse remains noncommittal about using the ricin",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus invites Jesse to dinner at his home and cooks Chilean fish stew",
+          "storyline": "loyalty",
+          "function": "turning_point",
+          "characters": [
+            "gus",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus tells Jesse he sees potential in him and that others have underestimated him",
+          "storyline": "loyalty",
+          "function": "turning_point",
+          "characters": [
+            "gus",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse has the ricin cigarette but chooses not to use it during dinner",
+          "storyline": "loyalty",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse leaves Gus's house without telling Walt about the dinner",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank discovers Gus's background prior to the 1980s is completely unverifiable",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank shares his findings with Gomez, who warns him to leave Gus alone",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "gomez"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank ignores the warning and requests additional records searches",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt discovers GPS data shows Gus was home when Jesse was unaccounted for",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt confronts Jesse and demands to know about his private meeting with Gus",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse admits to the dinner and Walt accuses him of switching sides",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse tells Walt that Gus treats him like a human being unlike Walt",
+          "storyline": "loyalty",
+          "function": "climax",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt and Jesse fight physically in Jesse's living room until both are bloodied",
+          "storyline": "loyalty",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse tells Walt to leave and not come back",
+          "storyline": "loyalty",
+          "function": "resolution",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt discovers an identical tracking device on his own car",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt realizes Gus knows everything about his surveillance",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        }
+      ],
+      "theme": "the illusion of loyalty",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "survival",
+            "loyalty",
+            "investigation"
+          ],
+          "description": "all three storylines explore different forms of betrayal and shifting allegiances — Walt's paranoia about Jesse's loyalty, Jesse's growing allegiance to Gus over Walt, and Hank's investigation threatening to expose hidden loyalties",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "survival",
+            "loyalty"
+          ],
+          "description": "the audience knows about Jesse's dinner with Gus before Walt does, and knows Walt is being tracked while he thinks he's the one doing the tracking",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "survival",
+            "loyalty"
+          ],
+          "description": "the storylines merge in the physical fight between Walt and Jesse, representing the complete breakdown of their partnership",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S04E10",
+      "events": [
+        {
+          "event": "Gus travels to Mexico with Jesse and Mike to meet the cartel",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "gus",
+            "jesse",
+            "mike"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse realizes he is the cook Gus is delivering to the cartel",
+          "storyline": "loyalty",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus coaches Jesse on what to expect and tells him to be confident",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "gus",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse takes command of the cartel lab, berating chemists for contaminated equipment",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "guest:benicio"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse demands the lab be cleaned to his standards before cooking",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse produces a batch testing at 96.2 percent purity, impressing Don Eladio",
+          "storyline": "loyalty",
+          "function": "climax",
+          "characters": [
+            "jesse",
+            "don_eladio"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Don Eladio tells Gus that Jesse will stay in Mexico permanently",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "don_eladio",
+            "gus"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus presents Don Eladio with poisoned Zafiro Añejo tequila at the poolside",
+          "storyline": "vengeance",
+          "function": "turning_point",
+          "characters": [
+            "gus",
+            "don_eladio"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "Gus drinks first to prove the tequila is safe, having taken precautions",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Don Eladio and his capos collapse and die from the poisoned tequila",
+          "storyline": "vengeance",
+          "function": "climax",
+          "characters": [
+            "gus",
+            "don_eladio"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus declares to Hector's allies that the cartel is finished",
+          "storyline": "vengeance",
+          "function": "resolution",
+          "characters": [
+            "gus",
+            "hector"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike is shot during the escape from the compound",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "mike"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse drives while Mike bleeds and Gus is weakened by poison",
+          "storyline": "loyalty",
+          "function": "climax",
+          "characters": [
+            "jesse",
+            "mike",
+            "gus"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse keeps both men alive during the chaotic drive to medical team",
+          "storyline": "loyalty",
+          "function": "resolution",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt cooks alone in the superlab, isolated and increasingly desperate",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        }
+      ],
+      "theme": "proving loyalty through capability",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "vengeance",
+            "loyalty"
+          ],
+          "description": "both storylines involve proving worth through decisive action — Gus through his ultimate revenge, Jesse through his competence under pressure",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "survival",
+            "vengeance",
+            "loyalty"
+          ],
+          "description": "Walt has no idea his fate is being decided in Mexico while he cooks alone",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "vengeance",
+            "loyalty"
+          ],
+          "description": "Jesse's demonstration of loyalty enables Gus's vengeance plan to succeed",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S04E11",
+      "events": [
+        {
+          "event": "Walt learns from news that Mexican cartel members are dead and suspects Gus was involved",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Gus returns to Albuquerque recovering from poisoning and resumes operations",
+          "storyline": "vengeance",
+          "function": "resolution",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt asks Jesse about Mexico trip but Jesse provides minimal information",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank cross-references Gale's lab notes with chemical suppliers and identifies Madrigal connection to Los Pollos Hermanos",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank asks Walt to drive him to Los Pollos Hermanos for lunch",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank asks Walt to plant GPS tracker on Gus's car while he waits in vehicle",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt reluctantly attaches the GPS device to Gus's car",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt warns Gus through phone call to check his car",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus summons Walt to desert where Tyrus blindfolds and drives him",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "gus",
+            "walt",
+            "tyrus"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Gus fires Walt and warns he'll kill Hank if Walt interferes with Jesse or contacts DEA",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "gus",
+            "walt"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt begs Gus to reconsider, arguing Hank is family investigating naturally",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt tells Skyler they need to disappear immediately",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt demands Saul contact identity provider, learns cost is $500,000 for family",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "saul"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt discovers crawl space nearly empty because Skyler gave money to Ted for IRS debt",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "laundering"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt lies in crawl space laughing hysterically then screaming as Marie calls about Hank being in danger",
+          "storyline": "survival",
+          "function": "cliffhanger",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        }
+      ],
+      "theme": "the price of protection",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "survival",
+            "investigation",
+            "laundering"
+          ],
+          "description": "all storylines involve characters trying to protect something — Walt protecting his life, Hank protecting justice, Skyler protecting their secret — but their protective actions create new dangers",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "survival",
+            "investigation"
+          ],
+          "description": "Walt is forced to help Hank investigate the very criminal he's warning, creating a deadly triangle of deception",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "survival",
+            "laundering"
+          ],
+          "description": "Skyler's money laundering protection directly undermines Walt's survival plan when he discovers the missing cash",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S04E12",
+      "events": [
+        {
+          "event": "Walt instructs Huell to steal Jesse's ricin cigarette and replace it with a regular one",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "saul"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt poisons Brock with Lily of the Valley berries from his backyard",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Brock falls seriously ill and is hospitalized with ricin-like symptoms",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "brock",
+            "andrea"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse rushes to the hospital when Andrea calls about Brock's condition",
+          "storyline": "loyalty",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "andrea"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse discovers the ricin cigarette is missing from his pack",
+          "storyline": "loyalty",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse concludes Gus poisoned Brock and goes to Walt's house with a gun",
+          "storyline": "loyalty",
+          "function": "climax",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt convinces Jesse that Gus orchestrated the poisoning to turn Jesse against Walt",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse agrees to help Walt kill Gus",
+          "storyline": "survival",
+          "function": "resolution",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank traces GPS data from Gus's car to Lavanderia Brillante laundry",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank tells Gomez the laundry may be the superlab site",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "gomez"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "DEA begins preliminary surveillance of the laundry",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "gomez"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler learns Ted was injured trying to flee instead of paying the IRS",
+          "storyline": "laundering",
+          "function": "climax",
+          "characters": [
+            "skyler",
+            "saul"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler sits silently in the car wash, horrified by the consequences of her actions",
+          "storyline": "laundering",
+          "function": "resolution",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse reveals Gus visits Hector at Casa Tranquila nursing home",
+          "storyline": "survival",
+          "function": "seed",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt realizes Hector's hatred of Gus presents an opportunity",
+          "storyline": "survival",
+          "function": "seed",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the corruption of innocence",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "survival",
+            "loyalty",
+            "laundering"
+          ],
+          "description": "all three storylines involve characters crossing moral lines to protect what they value — Walt poisons a child, Jesse is manipulated into betrayal, Skyler's money laundering leads to violence",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "survival",
+            "loyalty"
+          ],
+          "description": "the audience knows Walt poisoned Brock and manipulated Jesse, while Jesse believes Gus is responsible",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "survival",
+            "vengeance"
+          ],
+          "description": "Walt's plan to use Hector against Gus connects Walt's survival with Gus's vulnerability to his old enemy",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S04E13",
+      "events": [
+        {
+          "event": "Walt visits Hector at Casa Tranquila and proposes an alliance against Gus",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "hector"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt tells Hector that Gus killed Don Eladio and destroyed the cartel",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "hector"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hector agrees to Walt's plan by ringing his bell",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "hector"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt rigs a pipe bomb to Hector's wheelchair bell",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hector requests a DEA meeting through nursing home staff",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "hector"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank and Gomez visit Hector but he gives them nothing",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "gomez",
+            "hector"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hector spells out 'SUCK MY' and rings his bell in defiance",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "hector"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Tyrus sweeps Hector's room but doesn't check the wheelchair",
+          "storyline": "vengeance",
+          "function": "escalation",
+          "characters": [
+            "tyrus"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Gus enters and confronts Hector about what he told the DEA",
+          "storyline": "vengeance",
+          "function": "climax",
+          "characters": [
+            "gus",
+            "hector"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hector rings his bell and the bomb detonates, killing Hector, Tyrus, and Gus",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "hector",
+            "gus",
+            "tyrus"
+          ],
+          "also_affects": [
+            "vengeance"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gus walks out with half his face blown away, then collapses dead",
+          "storyline": "vengeance",
+          "function": "resolution",
+          "characters": [
+            "gus"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse learns of Gus's death while working at the superlab",
+          "storyline": "loyalty",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse and Walt destroy the superlab with chemicals and fire",
+          "storyline": "survival",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt calls Skyler and tells her 'I won'",
+          "storyline": "survival",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": [
+            "laundering"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hospital confirms Brock was poisoned by Lily of the Valley, not ricin",
+          "storyline": "loyalty",
+          "function": "resolution",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse accepts it was accidental and doesn't suspect Walt",
+          "storyline": "loyalty",
+          "function": "resolution",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Camera reveals Lily of the Valley plant in Walt's backyard",
+          "storyline": "survival",
+          "function": "seed",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "loyalty"
+          ],
+          "devices": [
+            "twist"
+          ]
+        },
+        {
+          "event": "Hank's investigation is validated by the explosion and discovery of Gus's empire",
+          "storyline": "investigation",
+          "function": "resolution",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the price of victory",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "survival",
+            "vengeance",
+            "loyalty"
+          ],
+          "description": "all three storylines explore how far characters will go to achieve their goals and what they sacrifice in the process",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "survival",
+            "loyalty"
+          ],
+          "description": "the audience knows Walt poisoned Brock to manipulate Jesse, but Jesse doesn't",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "survival",
+            "vengeance"
+          ],
+          "description": "Walt's survival plan and Gus's vengeance storyline literally converge in the explosion that kills both Hector and Gus",
+          "subtype": null
+        },
+        {
+          "type": "meta",
+          "lines": [
+            "survival"
+          ],
+          "description": "the final reveal of the Lily of the Valley plant reframes Walt's entire season arc",
+          "subtype": "twist-reveal"
+        }
+      ],
+      "patches": []
+    }
+  ],
+  "usage": "18 requests, 89,444 input + 25,852 output tokens, ~$0.560"
+}
\ No newline at end of file
diff --git a/docs/knowledge/results/bb-s05-result.json b/docs/knowledge/results/bb-s05-result.json
new file mode 100644
index 0000000..73d93f4
--- /dev/null
+++ b/docs/knowledge/results/bb-s05-result.json
@@ -0,0 +1,4017 @@
+{
+  "context": {
+    "franchise_type": "serial",
+    "story_engine": "A high school teacher builds a drug empire, testing how far he'll go for family and control",
+    "genre": "drama",
+    "format": "ongoing"
+  },
+  "cast": [
+    {
+      "id": "walt",
+      "name": "Walter White",
+      "aliases": [
+        "Walt",
+        "Walter",
+        "Heisenberg",
+        "Mr. White"
+      ]
+    },
+    {
+      "id": "jesse",
+      "name": "Jesse Pinkman",
+      "aliases": [
+        "Jesse"
+      ]
+    },
+    {
+      "id": "skyler",
+      "name": "Skyler White",
+      "aliases": [
+        "Skyler"
+      ]
+    },
+    {
+      "id": "hank",
+      "name": "Hank Schrader",
+      "aliases": [
+        "Hank"
+      ]
+    },
+    {
+      "id": "marie",
+      "name": "Marie Schrader",
+      "aliases": [
+        "Marie"
+      ]
+    },
+    {
+      "id": "mike",
+      "name": "Mike Ehrmantraut",
+      "aliases": [
+        "Mike"
+      ]
+    },
+    {
+      "id": "saul",
+      "name": "Saul Goodman",
+      "aliases": [
+        "Saul"
+      ]
+    },
+    {
+      "id": "lydia",
+      "name": "Lydia Rodarte-Quayle",
+      "aliases": [
+        "Lydia"
+      ]
+    },
+    {
+      "id": "todd",
+      "name": "Todd Alquist",
+      "aliases": [
+        "Todd"
+      ]
+    },
+    {
+      "id": "jack",
+      "name": "Jack Welker",
+      "aliases": [
+        "Jack"
+      ]
+    },
+    {
+      "id": "gomez",
+      "name": "Steven Gomez",
+      "aliases": [
+        "Gomez"
+      ]
+    },
+    {
+      "id": "declan",
+      "name": "Declan",
+      "aliases": [
+        "Declan"
+      ]
+    },
+    {
+      "id": "gretchen",
+      "name": "Gretchen Schwartz",
+      "aliases": [
+        "Gretchen"
+      ]
+    },
+    {
+      "id": "elliott",
+      "name": "Elliott Schwartz",
+      "aliases": [
+        "Elliott"
+      ]
+    }
+  ],
+  "plotlines": [
+    {
+      "id": "empire",
+      "name": "Walt: Empire",
+      "driver": "walt",
+      "goal": "build and control his own drug empire after eliminating Gus",
+      "obstacle": "law enforcement pressure, partner conflicts, cancer return, family resistance",
+      "stakes": "death, family destruction, legacy failure",
+      "type": "serialized",
+      "rank": "A",
+      "nature": "plot-led",
+      "confidence": "solid",
+      "devices": [
+        "dramatic_irony"
+      ],
+      "span": [
+        "S05E01",
+        "S05E02",
+        "S05E03",
+        "S05E04",
+        "S05E05",
+        "S05E06",
+        "S05E07",
+        "S05E08",
+        "S05E09",
+        "S05E10",
+        "S05E11",
+        "S05E12",
+        "S05E13",
+        "S05E14",
+        "S05E15",
+        "S05E16"
+      ]
+    },
+    {
+      "id": "investigation",
+      "name": "Hank: Investigation",
+      "driver": "hank",
+      "goal": "uncover and prosecute Heisenberg's true identity",
+      "obstacle": "personal connection to Walt, lack of official support, limited evidence",
+      "stakes": "career destruction, family betrayal, justice denied",
+      "type": "serialized",
+      "rank": "B",
+      "nature": "plot-led",
+      "confidence": "solid",
+      "devices": [
+        "dramatic_irony"
+      ],
+      "span": [
+        "S05E01",
+        "S05E02",
+        "S05E03",
+        "S05E04",
+        "S05E07",
+        "S05E08",
+        "S05E09",
+        "S05E10",
+        "S05E11",
+        "S05E12",
+        "S05E13",
+        "S05E14"
+      ]
+    },
+    {
+      "id": "guilt",
+      "name": "Jesse: Guilt",
+      "driver": "jesse",
+      "goal": "escape the moral weight of his crimes and find redemption",
+      "obstacle": "Walt's manipulation, blood money, inability to undo the past",
+      "stakes": "sanity, soul, complete moral destruction",
+      "type": "serialized",
+      "rank": "B",
+      "nature": "character-led",
+      "confidence": "solid",
+      "devices": [],
+      "span": [
+        "S05E01",
+        "S05E03",
+        "S05E05",
+        "S05E06",
+        "S05E08",
+        "S05E09",
+        "S05E11",
+        "S05E12",
+        "S05E14",
+        "S05E15",
+        "S05E16"
+      ]
+    },
+    {
+      "id": "protection",
+      "name": "Skyler: Protection",
+      "driver": "skyler",
+      "goal": "protect her children and herself from Walt's criminal world",
+      "obstacle": "Walt's refusal to leave, legal complicity, family loyalty",
+      "stakes": "children's safety, imprisonment, family annihilation",
+      "type": "serialized",
+      "rank": "B",
+      "nature": "character-led",
+      "confidence": "solid",
+      "devices": [],
+      "span": [
+        "S05E01",
+        "S05E03",
+        "S05E04",
+        "S05E08",
+        "S05E10",
+        "S05E11",
+        "S05E12",
+        "S05E13",
+        "S05E14",
+        "S05E15"
+      ]
+    },
+    {
+      "id": "survival",
+      "name": "Mike: Survival",
+      "driver": "mike",
+      "goal": "protect Gus's imprisoned associates and secure his own exit",
+      "obstacle": "frozen accounts, DEA pressure, Walt's recklessness",
+      "stakes": "death, betrayal of loyal men, legacy destruction",
+      "type": "serialized",
+      "rank": "C",
+      "nature": "plot-led",
+      "confidence": "solid",
+      "devices": [],
+      "span": [
+        "S05E02",
+        "S05E03",
+        "S05E04",
+        "S05E06",
+        "S05E07"
+      ]
+    }
+  ],
+  "episodes": [
+    {
+      "episode": "S05E01",
+      "events": [
+        {
+          "event": "Walt, Jesse, and Mike meet at junkyard to discuss laptop threat in APD evidence room",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "walt",
+            "jesse",
+            "mike"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Mike wants to flee but Walt insists he has a plan to destroy the evidence",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "mike"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt visits home where backyard is torn apart by investigators",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Skyler is terrified when Walt tells her 'I won' about Fring's murder",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt, Jesse, and Mike rent industrial electromagnet from Old Joe",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse",
+            "mike"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "They mount magnet in truck and drive to APD evidence room exterior wall",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse",
+            "mike"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt and Jesse activate magnet at full power, destroying metal evidence inside",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Truck tips over from magnetic force, trio abandons it and escapes",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "jesse",
+            "mike"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike protests they can't confirm laptop destruction, Walt says 'Because I say so'",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "mike"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Police discover evidence room wreckage, investigation pivots to mysterious event",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank notices broken picture frame revealed hidden Cayman Islands bank account numbers",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Saul reveals DEA seized Ted Beneke's assets after Huell and Kuby pressured him",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "saul",
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler visits hospitalized Ted who broke his neck fleeing Huell and Kuby",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Ted promises terrified Skyler he will say nothing about the money",
+          "storyline": "protection",
+          "function": "resolution",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt recovers ricin cigarette from Saul's office that Huell had lifted from Jesse",
+          "storyline": "guilt",
+          "function": "setup",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt hides real ricin vial behind electrical outlet plate in bedroom",
+          "storyline": "guilt",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt constructs fake ricin cigarette using salt and plants it in Jesse's Roomba",
+          "storyline": "guilt",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse finds fake cigarette, breaks down in tears of relief",
+          "storyline": "guilt",
+          "function": "climax",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse calls Walt to apologize for accusing him, Walt comforts him",
+          "storyline": "guilt",
+          "function": "resolution",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        }
+      ],
+      "theme": "the price of control",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "protection",
+            "guilt"
+          ],
+          "description": "all storylines explore control through deception — Walt controls through lies, Skyler tries to control damage, Jesse is controlled by Walt's manipulation",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "investigation"
+          ],
+          "description": "Walt's magnet plan inadvertently creates new evidence for Hank's investigation",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "guilt",
+            "empire"
+          ],
+          "description": "audience knows Walt is manipulating Jesse with the fake ricin cigarette while Jesse believes Walt's innocence",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S05E02",
+      "events": [
+        {
+          "event": "Peter Schuler kills himself with a defibrillator to avoid DEA questioning about Madrigal's ties to Fring",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "guest:schuler"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank and Gomez interrogate Mike about his ties to Fring's operation but lack evidence to hold him",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "gomez",
+            "mike"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt proposes to Mike and Jesse that they restart the meth business as equal partners",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "walt",
+            "mike",
+            "jesse"
+          ],
+          "also_affects": [
+            "guilt",
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Mike flatly refuses Walt's partnership proposal, saying he doesn't trust him",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "mike",
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "DEA freezes Fring's offshore accounts used for hazard pay to imprisoned associates",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "guest:dea_agents"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Mike visits imprisoned associates and promises money he cannot deliver",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "mike"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Lydia presents Mike with a list of eleven people to kill who could implicate her",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "lydia",
+            "mike"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Mike refuses to kill for Lydia and considers killing her instead",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "mike",
+            "lydia"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Dennis contacts Hank considering cooperation now that his hazard pay is gone",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "guest:dennis"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse argues to Mike that cooking again can generate cash to pay everyone and keep them quiet",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "jesse",
+            "mike"
+          ],
+          "also_affects": [
+            "survival",
+            "guilt"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt, Jesse, and Mike formally agree to a three-way partnership at Saul's office",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "jesse",
+            "mike",
+            "saul"
+          ],
+          "also_affects": [
+            "survival",
+            "guilt"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Mike demands hazard pay for Fring's men comes off the top, Walt reluctantly agrees",
+          "storyline": "survival",
+          "function": "resolution",
+          "characters": [
+            "mike",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Lydia pays Chris Mara to kill ten witnesses plus Mike",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "lydia",
+            "guest:chris"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Chris kills Chow and lures Mike to an ambush, but Mike anticipates and kills Chris",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "mike",
+            "guest:chris"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike spares Lydia because Jesse vouches that her Madrigal connections can supply methylamine",
+          "storyline": "survival",
+          "function": "resolution",
+          "characters": [
+            "mike",
+            "lydia",
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the price of loyalty",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "survival",
+            "investigation"
+          ],
+          "description": "all storylines explore loyalty — Walt demanding it from partners, Mike honoring it to Fring's men, Hank's loyalty to justice threatening the network",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "investigation",
+            "empire"
+          ],
+          "description": "Hank interrogates Mike not knowing he's questioning Walt's future partner",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "survival"
+          ],
+          "description": "Mike's need to pay Fring's men drives him to accept Walt's partnership proposal",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S05E03",
+      "events": [
+        {
+          "event": "Walt moves back into the White family home over Skyler's barely concealed objections",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Saul presents cooking venue options including tortilla and box factories",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "saul",
+            "walt",
+            "jesse",
+            "mike"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike vetoes each venue for security reasons",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "mike"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse suggests mobile cooking inside fumigation-tented houses using Vamonos Pest",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "The partners agree to use Vamonos Pest and meet Todd and the crew",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse",
+            "mike",
+            "guest:todd",
+            "guest:ira"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "The team successfully completes their first mobile cook in a tented house",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "jesse",
+            "mike",
+            "guest:todd"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike presents the revenue split with extensive deductions for hazard pay and overhead",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "mike"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt expresses displeasure at the modest profit shares after deductions",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt tells Jesse about Victor's death as a warning about overstepping",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Marie visits and pushes Skyler to explain her strange behavior",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "marie",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt invites Jesse for beer while Skyler isolates in the bedroom",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse",
+            "skyler"
+          ],
+          "also_affects": [
+            "guilt"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse tells Walt about breaking up with Andrea to protect her and Brock",
+          "storyline": "guilt",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler tells Walt she is waiting for his cancer to return",
+          "storyline": "protection",
+          "function": "climax",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank and DEA track Fring's money through Madrigal but face bureaucratic delays",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the cost of control",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "protection",
+            "survival"
+          ],
+          "description": "all storylines explore different costs of maintaining control — Walt's empire demands profit margins, Skyler's protection requires emotional endurance, Mike's survival needs financial resources",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "guilt"
+          ],
+          "description": "Walt references Victor's death as a warning to Mike, but Jesse doesn't understand that Walt poisoned Brock, making Jesse's guilt about protecting Andrea tragically ironic",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "survival"
+          ],
+          "description": "Mike's need to pay hazard pay directly conflicts with Walt's empire-building goals, setting up future confrontation",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S05E04",
+      "events": [
+        {
+          "event": "Skyler buys a birthday cake and arranges family dinner for Walt's 51st birthday",
+          "storyline": "protection",
+          "function": "setup",
+          "characters": [
+            "skyler",
+            "walt",
+            "hank",
+            "marie"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt dominates dinner conversation while Skyler barely functions",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler walks fully clothed into the pool and sinks to the bottom",
+          "storyline": "protection",
+          "function": "turning_point",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank and Marie pull Skyler from the pool",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "marie",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler demands the children leave for their safety, using her breakdown as leverage",
+          "storyline": "protection",
+          "function": "climax",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt refuses to send the children away, arguing no one is in danger",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "protection"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler tells Walt her only weapon is waiting for his cancer to return",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt agrees to send children to Hank and Marie under cover of Skyler needing rest",
+          "storyline": "protection",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt and Jesse continue cooking in fumigated houses with Vamonos Pest crew",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Lydia meets with Hank at DEA, presenting herself as cooperative Madrigal executive",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "lydia",
+            "hank"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Mike discovers DEA tracking device on his car",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "mike"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Mike warns Walt and Jesse that pressure is mounting from surveillance",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "mike",
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt dismisses Mike's concerns, confident in outmaneuvering law enforcement",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt removes his watch and tells Skyler this is just the beginning",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": [
+            "protection"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the illusion of control versus powerlessness",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "protection",
+            "survival"
+          ],
+          "description": "all storylines explore different forms of control — Walt's overconfidence, Skyler's desperate manipulation, Mike's cautious pragmatism",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "investigation"
+          ],
+          "description": "Lydia feeds information to Hank while secretly working for Walt; Hank doesn't know he's being manipulated",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "protection",
+            "investigation"
+          ],
+          "description": "Hank and Marie don't know the real reason they're taking the children is Walt's criminal activity",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S05E05",
+      "events": [
+        {
+          "event": "Lydia informs Walt, Jesse, and Mike about a thousand gallons of methylamine being transported by train",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "lydia",
+            "walt",
+            "jesse",
+            "mike"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "The team devises an elaborate plan to rob the train without detection by replacing methylamine with water",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse",
+            "mike"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Todd is brought in as a fourth crew member for the heist",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "todd"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt, Jesse, and Todd rehearse the train robbery operation",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse",
+            "todd"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Kuby stalls his truck on the railroad tracks, forcing the train to stop",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "guest:kuby"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt and Todd connect hoses to the tanker car while Jesse manages the pump system",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "todd",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Engineers radio for a second locomotive to push the stalled truck, creating time pressure",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "guest:engineers"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse barely escapes from under the moving tanker as the train accelerates",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "guilt"
+          ],
+          "devices": []
+        },
+        {
+          "event": "The crew celebrates successfully stealing all the methylamine they need",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "jesse",
+            "todd"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Todd spots Drew Sharp, a boy on a dirt bike who has been watching the heist",
+          "storyline": "guilt",
+          "function": "setup",
+          "characters": [
+            "todd",
+            "guest:drew_sharp"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Todd shoots Drew Sharp dead without hesitation",
+          "storyline": "guilt",
+          "function": "climax",
+          "characters": [
+            "todd"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "twist"
+          ]
+        },
+        {
+          "event": "Jesse screams at Todd in anguished shock over the boy's murder",
+          "storyline": "guilt",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "todd"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the cost of perfection",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "guilt"
+          ],
+          "description": "both storylines explore how the pursuit of a perfect crime leads to moral corruption and unintended consequences",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "guilt"
+          ],
+          "description": "the successful heist immediately transforms into Jesse's moral crisis when Todd kills the witness",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S05E06",
+      "events": [
+        {
+          "event": "Walt, Jesse, and Todd dissolve Drew Sharp's body and dirt bike in hydrofluoric acid",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse",
+            "todd"
+          ],
+          "also_affects": [
+            "guilt"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse is deeply shaken and barely speaks during the cleanup",
+          "storyline": "guilt",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike wants Todd gone as a liability, Walt argues Todd followed orders and they need him",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "mike"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Todd apologizes but shows no real remorse, explaining he acted to protect the operation",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "todd"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt and Mike reluctantly keep Todd on with a warning",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "mike"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse tells Walt he wants out of the business entirely, willing to walk away from millions",
+          "storyline": "guilt",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt delivers monologue about being bought out of Gray Matter for a pittance",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt refuses to let Jesse make the same mistake he made with Gray Matter",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse remains unmoved, saying the money means nothing against what they have done",
+          "storyline": "guilt",
+          "function": "climax",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike informs Walt and Jesse he also wants out",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "mike"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Mike proposes Declan's offer to buy their methylamine supply for fifteen million",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "mike"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt objects because selling the methylamine ends his cooking operation",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt meets Declan alone in the desert, surrounded by armed men",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "guest:declan"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt proposes Declan buy out Mike and Jesse but leave Walt his methylamine portion",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "guest:declan"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt forces Declan to acknowledge his reputation by demanding 'Say my name'",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "guest:declan"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Declan concedes and says 'Heisenberg', the deal is struck",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "guest:declan"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse receives five million dollars and walks away",
+          "storyline": "guilt",
+          "function": "resolution",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike receives five million and prepares to leave Albuquerque",
+          "storyline": "survival",
+          "function": "resolution",
+          "characters": [
+            "mike"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt begins cooking with Todd as his new assistant, quality drops without Jesse",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "todd"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt persists cooking alone, determined to build his empire",
+          "storyline": "empire",
+          "function": "seed",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the cost of ambition",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "guilt",
+            "survival",
+            "legacy"
+          ],
+          "description": "all storylines explore different responses to moral compromise — Walt doubles down on ambition, Jesse seeks escape through conscience, Mike seeks practical exit, Walt's legacy obsession drives his refusal to quit",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "survival",
+            "guilt"
+          ],
+          "description": "the methylamine deal forces all three partners to confront their different priorities and ultimately splits them apart",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S05E07",
+      "events": [
+        {
+          "event": "Walt cooks with Todd as his new assistant, but Todd's product only reaches 74 percent purity",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "todd"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt coaches Todd through the cooking process with frustrated patience",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "todd"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike instructs Saul's paralegal to continue hazard pay distributions to Fring's nine imprisoned associates",
+          "storyline": "survival",
+          "function": "setup",
+          "characters": [
+            "mike"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank and Gomez discover Dan Wachsberger making suspicious deposits into multiple accounts",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "gomez"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "DEA arrests Dan Wachsberger and he agrees to cooperate",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank",
+            "gomez"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Mike learns about Dan's arrest and realizes the imprisoned men will flip without hazard payments",
+          "storyline": "survival",
+          "function": "turning_point",
+          "characters": [
+            "mike"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Mike arranges to flee immediately and calls Saul to retrieve his go-bag from the airport",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "mike",
+            "saul"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt volunteers to deliver Mike's go-bag instead of Saul",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt demands the list of Fring's nine associates from Mike, claiming he needs it to arrange their silence",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "mike"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Mike refuses to give Walt the names and tells him he destroyed Fring's perfect operation with his ego",
+          "storyline": "survival",
+          "function": "escalation",
+          "characters": [
+            "mike",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt shoots Mike through the abdomen with Mike's own gun after being refused the names again",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "mike"
+          ],
+          "also_affects": [
+            "survival"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Mike drives away wounded, collapses by the riverbank, and dies telling Walt to shut up",
+          "storyline": "survival",
+          "function": "climax",
+          "characters": [
+            "mike",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt realizes he could have gotten the names from Lydia and stands over Mike's body processing the murder",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the cost of pride",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "survival"
+          ],
+          "description": "both storylines explore how pride and ego destroy carefully built systems and relationships",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "investigation",
+            "empire",
+            "survival"
+          ],
+          "description": "the audience knows Walt and Mike are connected to what Hank is investigating, but Hank doesn't",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "survival"
+          ],
+          "description": "Walt's need for control directly destroys Mike's exit strategy, culminating in murder",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S05E08",
+      "events": [
+        {
+          "event": "Walt dissolves Mike's body in acid inside a plastic barrel",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt obtains the list of Fring's nine imprisoned associates from Lydia",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "lydia"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt visits Jack Welker and commissions the murder of all nine men plus their lawyer",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jack"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Ten men are stabbed and burned to death across three prisons within two minutes",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank and the DEA are stunned as their entire case evaporates overnight",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt and Todd cook batch after batch in fumigated houses over three months",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "todd"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Lydia arranges international distribution to the Czech Republic through Madrigal",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "lydia"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler shows Walt the storage unit packed with uncountable money",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Skyler asks Walt how much money is enough",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt visits Jesse and they share an awkward conversation about their old RV",
+          "storyline": "guilt",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt learns from his oncologist that his cancer has returned",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt tells Skyler he is out of the business",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": [
+            "protection",
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank finds the Leaves of Grass book with Gale's inscription to W.W.",
+          "storyline": "investigation",
+          "function": "climax",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "callback"
+          ]
+        },
+        {
+          "event": "Hank flashes back to Walt joking that W.W. could stand for Walter White",
+          "storyline": "investigation",
+          "function": "climax",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback",
+            "callback"
+          ]
+        },
+        {
+          "event": "Hank sits stunned, finally connecting Walter White to Heisenberg",
+          "storyline": "investigation",
+          "function": "climax",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "twist"
+          ]
+        }
+      ],
+      "theme": "the illusion of completion",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "legacy",
+            "investigation"
+          ],
+          "description": "all storylines deal with endings that aren't really endings — Walt thinks he's finished, but his past catches up",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "empire",
+            "investigation"
+          ],
+          "description": "Walt believes he's eliminated all threats and can retire safely, while Hank discovers his true identity",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "investigation"
+          ],
+          "description": "Walt's past actions (the Gale book) directly lead to Hank's discovery",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S05E09",
+      "events": [
+        {
+          "event": "Flash-forward shows Walt's abandoned house vandalized with 'HEISENBERG' graffiti",
+          "storyline": "empire",
+          "function": "seed",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashforward"
+          ]
+        },
+        {
+          "event": "Future Walt retrieves ricin vial from his destroyed home",
+          "storyline": "empire",
+          "function": "seed",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashforward"
+          ]
+        },
+        {
+          "event": "Hank suffers panic attack and crashes SUV after discovering Walt Whitman book",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Marie tends to Hank, who lies about having a dizzy spell",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "marie"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank secretly re-investigates Heisenberg case in his garage",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank connects Walt to lab equipment theft, Gale's murder, and Fring's death",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt works mundane car wash routine with Skyler, pretending normalcy",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": [
+            "protection"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Lydia begs Walt to resume cooking due to Todd's poor quality product",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "lydia",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt refuses Lydia and tells her never to return",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse attempts to give away blood money to victims' families",
+          "storyline": "guilt",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Saul intercepts the cash and warns Jesse about distributing drug money",
+          "storyline": "guilt",
+          "function": "escalation",
+          "characters": [
+            "saul",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse confronts Saul and Walt, calling the money blood money",
+          "storyline": "guilt",
+          "function": "turning_point",
+          "characters": [
+            "jesse",
+            "walt",
+            "saul"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse directly asks Walt if he killed Mike",
+          "storyline": "guilt",
+          "function": "climax",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt lies to Jesse that Mike is alive and on the run",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "guilt"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt discovers the Walt Whitman book is missing from bathroom",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt finds GPS tracker under his car",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt confronts Hank directly in his garage",
+          "storyline": "investigation",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "hank"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank punches Walt and calls him a monster",
+          "storyline": "investigation",
+          "function": "climax",
+          "characters": [
+            "hank",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt warns Hank his cancer returned and threatens him to tread lightly",
+          "storyline": "investigation",
+          "function": "cliffhanger",
+          "characters": [
+            "walt",
+            "hank"
+          ],
+          "also_affects": [
+            "empire",
+            "empire"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the inevitable collision of truth and lies",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "investigation",
+            "guilt",
+            "empire",
+            "legacy"
+          ],
+          "description": "all storylines deal with confronting the truth of past actions and their consequences",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "investigation",
+            "empire"
+          ],
+          "description": "the audience knows Walt killed Mike while Jesse suspects but Walt denies it",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "investigation",
+            "empire"
+          ],
+          "description": "Hank's investigation and Walt's criminal empire finally collide in direct confrontation",
+          "subtype": null
+        },
+        {
+          "type": "meta",
+          "lines": [
+            "legacy",
+            "empire"
+          ],
+          "description": "flash-forward shows the ultimate destruction of everything Walt built",
+          "subtype": "flashforward"
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S05E10",
+      "events": [
+        {
+          "event": "Hank returns to work at the DEA and tries to build a case against Walt without revealing his personal connection",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank calls in Jesse for questioning, but Jesse stonewalls completely and says nothing",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "jesse"
+          ],
+          "also_affects": [
+            "guilt"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Skyler senses danger and drives to the storage unit to load money into her car",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt races to reach the money first, rents a van and loads the barrels himself",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "protection"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt takes the money barrels to the desert near To'hajiilee and buries them",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": [
+            "callback"
+          ]
+        },
+        {
+          "event": "Walt records the coordinates as lottery numbers and tapes the ticket inside the refrigerator",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "The physical labor aggravates Walt's cancer and he collapses in the bathroom",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt tells Skyler the money is safe and hidden when he wakes",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": [
+            "protection"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Marie confronts Skyler at the White house, having learned the truth from Hank",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "marie",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Marie slaps Skyler and tries to take baby Holly, but Hank intervenes",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "marie",
+            "skyler",
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank realizes he cannot go to the DEA officially because Walt is his brother-in-law",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt tells Skyler that Hank has no real evidence",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Skyler surprises Walt by siding with him out of self-preservation",
+          "storyline": "protection",
+          "function": "turning_point",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler asks Walt if this is over and he assures her it is",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Lydia visits Declan's underground meth lab and declares the quality unacceptable",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "lydia",
+            "declan"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Lydia calls Todd, who arrives with Jack's Aryan Brotherhood crew",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "lydia",
+            "todd",
+            "jack"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jack's men execute Declan and his entire operation in the buried lab",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "jack",
+            "todd"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Todd takes over cooking duties and Lydia secures a new supply chain",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "todd",
+            "lydia"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank decides to approach Jesse independently, believing he's the key to building a case outside the system",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": [
+            "guilt"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the price of loyalty and self-preservation",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "investigation",
+            "protection",
+            "legacy"
+          ],
+          "description": "all three storylines explore characters forced to choose between loyalty and self-preservation — Hank can't use official channels, Skyler sides with Walt to protect herself, Walt hides the money to preserve his legacy",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "investigation",
+            "protection"
+          ],
+          "description": "the audience knows Walt's assurance that 'this is over' is false, while Skyler believes it",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "investigation",
+            "guilt"
+          ],
+          "description": "Hank's decision to approach Jesse independently sets up their alliance against Walt",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S05E11",
+      "events": [
+        {
+          "event": "Walt and Skyler film a fake confession video framing Hank as Heisenberg",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt and Skyler invite Hank and Marie to dinner at a Mexican restaurant",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler",
+            "hank",
+            "marie"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt slides the DVD confession across the table to Hank",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt",
+            "hank"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank and Marie watch the fake confession video at home",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank",
+            "marie"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Marie realizes the medical bill detail gives the lie devastating credibility",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "marie",
+            "hank"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse sits in Saul's office ready to disappear with a new identity",
+          "storyline": "guilt",
+          "function": "setup",
+          "characters": [
+            "jesse",
+            "saul"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Huell pickpockets Jesse's marijuana during the pat-down",
+          "storyline": "guilt",
+          "function": "turning_point",
+          "characters": [
+            "jesse",
+            "guest:huell"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse realizes Huell stole his weed and connects it to the ricin cigarette theft",
+          "storyline": "guilt",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": [
+            "twist"
+          ]
+        },
+        {
+          "event": "Jesse realizes Walt orchestrated Brock's poisoning to manipulate him",
+          "storyline": "guilt",
+          "function": "climax",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "twist"
+          ]
+        },
+        {
+          "event": "Jesse storms back into Saul's office, beats him, and takes his gun",
+          "storyline": "guilt",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "saul"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse breaks into the White house and douses it with gasoline",
+          "storyline": "guilt",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "protection",
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt arrives home to find the living room soaked in gasoline",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire",
+            "guilt"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt lies to Skyler and Walter Jr. about a gas pump malfunction",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "The White family moves to a hotel for safety",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt meets with Saul and instructs him to find Jesse",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "saul"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Saul suggests Jesse needs to be dealt with permanently",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "saul",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt refuses to kill Jesse for now",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank stops Jesse from burning the White house",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank",
+            "jesse"
+          ],
+          "also_affects": [
+            "guilt"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank brings Jesse to the Schrader home",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "jesse"
+          ],
+          "also_affects": [
+            "guilt"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse agrees to cooperate with Hank against Walt",
+          "storyline": "investigation",
+          "function": "climax",
+          "characters": [
+            "jesse",
+            "hank"
+          ],
+          "also_affects": [
+            "guilt"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the price of loyalty and betrayal",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "legacy",
+            "investigation",
+            "guilt"
+          ],
+          "description": "all three storylines explore betrayal — Walt betrays Hank with the fake confession, Jesse feels betrayed by Walt's manipulation, Hank is betrayed by his own vulnerability",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "legacy",
+            "protection"
+          ],
+          "description": "the audience knows Walt's gas pump story is a lie while his family believes it",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "investigation",
+            "guilt"
+          ],
+          "description": "Jesse's realization about Walt's manipulation leads directly to his alliance with Hank",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S05E12",
+      "events": [
+        {
+          "event": "Walt discovers his living room soaked in gasoline from Jesse's break-in",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "guilt"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt fabricates a gas pump story to explain the smell to Skyler and Walter Jr.",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Skyler confronts Walt at the hotel demanding the truth about Jesse",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler coldly suggests Walt should kill Jesse permanently",
+          "storyline": "protection",
+          "function": "turning_point",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Saul advises Walt that Jesse must be sent to Belize",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "saul",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt refuses Saul's advice, insisting he can talk Jesse down",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank intercepts Jesse at the White house and talks him out of burning it down",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "hank",
+            "jesse"
+          ],
+          "also_affects": [
+            "guilt"
+          ],
+          "devices": [
+            "flashback"
+          ]
+        },
+        {
+          "event": "Jesse records his full video testimony detailing two years of crimes with Walt",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "hank"
+          ],
+          "also_affects": [
+            "guilt"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Gomez expresses skepticism that Jesse's testimony alone will convict Walt",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "gomez",
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank devises a sting operation with Jesse wearing a wire to meet Walt",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse objects that Walt is too smart and the meeting is a death trap",
+          "storyline": "guilt",
+          "function": "escalation",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank privately tells Gomez he doesn't care if Jesse dies at the meeting",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank",
+            "gomez"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jesse panics at the plaza, spots a stranger, and aborts the meeting",
+          "storyline": "guilt",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse calls Walt with a threatening message about getting him where he really lives",
+          "storyline": "guilt",
+          "function": "climax",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt drives to Jack Welker's compound and asks him to kill Jesse",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "jack"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jack agrees to kill Jesse but demands Walt cook three more batches with Todd",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "jack",
+            "walt",
+            "todd"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the point of no return",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "protection",
+            "guilt",
+            "investigation"
+          ],
+          "description": "all storylines reach their moral breaking point — Walt ordering Jesse's death, Skyler embracing murder, Jesse threatening Walt, Hank willing to sacrifice Jesse",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "investigation",
+            "empire"
+          ],
+          "description": "the audience knows Hank is using Jesse against Walt while Walt seeks Jesse's death",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "guilt",
+            "investigation"
+          ],
+          "description": "Jesse's moral crisis becomes Hank's investigative weapon",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S05E13",
+      "events": [
+        {
+          "event": "Jesse and Hank devise a plan to trap Walt by targeting his buried money",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "jesse",
+            "hank"
+          ],
+          "also_affects": [
+            "guilt"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank intimidates Huell with a staged photo of Jesse's fake death",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Huell confirms he helped Walt load seven barrels of cash into a van",
+          "storyline": "investigation",
+          "function": "escalation",
+          "characters": [
+            "guest:huell",
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse sends Walt a fake photo of excavated money barrel with threat to burn it",
+          "storyline": "investigation",
+          "function": "turning_point",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": [
+            "empire",
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt panics at the car wash and races toward the burial site",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt confesses to prison murders, killing Mike, poisoning Brock, and killing Gus while speeding to the desert",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "investigation",
+            "guilt"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Hank records Walt's full confession over the phone",
+          "storyline": "investigation",
+          "function": "climax",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt arrives at the burial site and realizes the photo was fake",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt calls Jack for backup and gives him the coordinates",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt sees Hank, Gomez, and Jesse and realizes he's been trapped",
+          "storyline": "empire",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt urgently calls Jack to cancel the backup request",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank arrests Walt at gunpoint and reads him his Miranda rights",
+          "storyline": "investigation",
+          "function": "climax",
+          "characters": [
+            "hank",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank calls Marie and tells her Walt has been arrested and the nightmare is over",
+          "storyline": "investigation",
+          "function": "resolution",
+          "characters": [
+            "hank",
+            "marie"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Jack's armed convoy arrives despite Walt's cancellation",
+          "storyline": "empire",
+          "function": "cliffhanger",
+          "characters": [
+            "guest:jack"
+          ],
+          "also_affects": [
+            "investigation",
+            "protection"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Armed standoff develops between Jack's crew and Hank and Gomez",
+          "storyline": "investigation",
+          "function": "cliffhanger",
+          "characters": [
+            "hank",
+            "gomez",
+            "guest:jack"
+          ],
+          "also_affects": [
+            "empire",
+            "protection"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the inevitability of consequences",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "investigation",
+            "protection"
+          ],
+          "description": "all storylines converge on the moment when Walt's carefully constructed lies finally collapse under the weight of truth",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "investigation",
+            "empire"
+          ],
+          "description": "the audience knows Walt is walking into a trap while he believes he's protecting his money",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "investigation",
+            "protection"
+          ],
+          "description": "all storylines physically converge at the burial site where Walt's empire, Hank's investigation, and the threat to family safety collide",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S05E14",
+      "events": [
+        {
+          "event": "Flashback shows Walt and Jesse cooking meth in the RV in the desert years earlier",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": [
+            "flashback",
+            "callback"
+          ]
+        },
+        {
+          "event": "Gomez lies dead after the firefight at To'hajiilee",
+          "storyline": "investigation",
+          "function": "climax",
+          "characters": [
+            "gomez"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Hank crawls wounded behind a vehicle, shot in the leg",
+          "storyline": "investigation",
+          "function": "climax",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt begs Jack to spare Hank, offering all eighty million dollars",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "jack"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Hank refuses to beg and tells Walt that Jack made his decision ten minutes ago",
+          "storyline": "investigation",
+          "function": "climax",
+          "characters": [
+            "hank"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jack shoots Hank in the head, killing him",
+          "storyline": "investigation",
+          "function": "resolution",
+          "characters": [
+            "jack",
+            "hank"
+          ],
+          "also_affects": [
+            "empire",
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt collapses face-down in the dirt after Hank's death",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jack's men dig up Walt's money barrels using GPS coordinates",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "jack"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jack's crew takes seven barrels, leaving Walt one at Todd's request",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "jack",
+            "todd"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse is found hiding under Walt's car and dragged out",
+          "storyline": "guilt",
+          "function": "climax",
+          "characters": [
+            "jesse",
+            "jack"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Todd argues Jesse should be kept alive to learn what he told the DEA",
+          "storyline": "guilt",
+          "function": "turning_point",
+          "characters": [
+            "todd"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt tells Jesse he watched Jane die and chose not to intervene",
+          "storyline": "guilt",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": [
+            "twist"
+          ]
+        },
+        {
+          "event": "Jesse is taken to Jack's compound and chained in an underground pit",
+          "storyline": "guilt",
+          "function": "resolution",
+          "characters": [
+            "jesse",
+            "jack"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse is forced to cook meth for Todd in captivity",
+          "storyline": "guilt",
+          "function": "seed",
+          "characters": [
+            "jesse",
+            "todd"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jack's crew buries Hank and Gomez in the hole where the money was",
+          "storyline": "investigation",
+          "function": "resolution",
+          "characters": [
+            "jack"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt drives through the desert until his car runs out of fuel",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt buys a battered truck from a Navajo man with cash",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "guest:navajo_man"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler hears news of a shooting in the desert and suspects the worst",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt bursts in and orders Skyler and Walter Jr. to pack immediately",
+          "storyline": "protection",
+          "function": "escalation",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Skyler grabs a kitchen knife and slashes at Walt, cutting his hand",
+          "storyline": "protection",
+          "function": "climax",
+          "characters": [
+            "skyler",
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walter Jr. throws himself between his parents and calls 911",
+          "storyline": "protection",
+          "function": "climax",
+          "characters": [
+            "guest:walter_jr",
+            "skyler"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt grabs baby Holly and runs to his truck",
+          "storyline": "protection",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt changes Holly's diaper in a fire station restroom while she cries for mama",
+          "storyline": "protection",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt calls Skyler and performs a vicious tirade to shield her from prosecution",
+          "storyline": "protection",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt leaves Holly at the fire station entrance with a note",
+          "storyline": "protection",
+          "function": "resolution",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Ed Galbraith picks Walt up in a red minivan for his new identity",
+          "storyline": "empire",
+          "function": "seed",
+          "characters": [
+            "walt",
+            "guest:ed_galbraith"
+          ],
+          "also_affects": null,
+          "devices": []
+        }
+      ],
+      "theme": "the cost of choices",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "investigation",
+            "guilt",
+            "protection",
+            "legacy"
+          ],
+          "description": "all storylines culminate in devastating consequences of past choices — Walt's empire crumbles, Hank dies for his pursuit, Jesse faces ultimate betrayal, Skyler loses her family, Walt's legacy is destroyed",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "investigation"
+          ],
+          "description": "the desert confrontation brings Walt's criminal empire and Hank's investigation to their mutual destruction",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "protection",
+            "legacy"
+          ],
+          "description": "Walt's phone call appears cruel but actually protects Skyler, while destroying any remaining family bonds",
+          "subtype": null
+        },
+        {
+          "type": "meta",
+          "lines": [
+            "empire"
+          ],
+          "description": "flashback to the RV cooking scene provides emotional contrast to the present devastation",
+          "subtype": "wraparound"
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S05E15",
+      "events": [
+        {
+          "event": "Walt steals a Volvo in New Hampshire and drives toward Albuquerque",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt breaks into Elliott and Gretchen's house and waits in the shadows",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt threatens Elliott and Gretchen with fake hitmen to force them to give money to Walt Jr.",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "elliott",
+            "gretchen"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Badger and Skinny Pete are revealed as the fake hitmen with laser pointers",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "guest:badger",
+            "guest:skinny_pete"
+          ],
+          "also_affects": null,
+          "devices": [
+            "twist"
+          ]
+        },
+        {
+          "event": "Walt learns from Badger and Skinny Pete that blue meth is still on the street",
+          "storyline": "guilt",
+          "function": "setup",
+          "characters": [
+            "walt",
+            "guest:badger",
+            "guest:skinny_pete"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt realizes Jesse must be alive and still cooking",
+          "storyline": "guilt",
+          "function": "turning_point",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt approaches Lydia and Todd at their coffee meeting claiming to have a new cooking method",
+          "storyline": "empire",
+          "function": "setup",
+          "characters": [
+            "walt",
+            "lydia",
+            "todd"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt slips ricin into Lydia's Stevia packet while she dismisses his offer",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "lydia"
+          ],
+          "also_affects": null,
+          "devices": [
+            "dramatic_irony"
+          ]
+        },
+        {
+          "event": "Walt retrieves his car with the mounted M60 machine gun",
+          "storyline": "empire",
+          "function": "escalation",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt gives Skyler the GPS coordinates of Hank and Gomez's burial site",
+          "storyline": "protection",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": [
+            "investigation"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt admits he did everything for himself because he liked it and was good at it",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "skyler"
+          ],
+          "also_affects": [
+            "protection"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt looks at Holly sleeping in her crib one last time",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "protection"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the final reckoning",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "legacy",
+            "empire",
+            "protection"
+          ],
+          "description": "all storylines converge on Walt's final acts of control and his attempt to secure what matters to him before death",
+          "subtype": null
+        },
+        {
+          "type": "dramatic_irony",
+          "lines": [
+            "legacy",
+            "empire"
+          ],
+          "description": "the audience knows Walt's elaborate schemes while his victims remain unaware of the true danger",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "legacy",
+            "protection"
+          ],
+          "description": "Walt's confession to Skyler serves both his need for truth and her need for legal protection",
+          "subtype": null
+        }
+      ],
+      "patches": []
+    },
+    {
+      "episode": "S05E16",
+      "events": [
+        {
+          "event": "Walt drives to Jack's compound with the M60 rigged in his trunk",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jack's men search Walt and bring him inside the clubhouse",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "jack"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt claims he wants to discuss a deal with Jack",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "jack"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jack orders Todd to bring Jesse from the meth lab as proof of enslavement",
+          "storyline": "guilt",
+          "function": "climax",
+          "characters": [
+            "jack",
+            "todd",
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Todd retrieves Jesse, who is emaciated, scarred, and shackled",
+          "storyline": "guilt",
+          "function": "climax",
+          "characters": [
+            "todd",
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt tackles Jesse to shield him and activates the M60 with the key fob",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "guilt",
+            "empire"
+          ],
+          "devices": [
+            "twist"
+          ]
+        },
+        {
+          "event": "The M60 sweeps automatic fire through the clubhouse, killing Jack's men",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Jesse strangles Todd to death with his handcuff chain",
+          "storyline": "guilt",
+          "function": "climax",
+          "characters": [
+            "jesse",
+            "todd"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt shoots the wounded Jack mid-sentence when Jack offers to reveal the money location",
+          "storyline": "empire",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "jack"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt slides the pistol to Jesse and tells him to kill Walt",
+          "storyline": "guilt",
+          "function": "climax",
+          "characters": [
+            "walt",
+            "jesse"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse refuses to kill Walt, telling him to do it himself",
+          "storyline": "guilt",
+          "function": "resolution",
+          "characters": [
+            "jesse",
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Jesse escapes in Todd's El Camino, laughing and crying as he drives away",
+          "storyline": "guilt",
+          "function": "resolution",
+          "characters": [
+            "jesse"
+          ],
+          "also_affects": null,
+          "devices": []
+        },
+        {
+          "event": "Walt tells Lydia over the phone that she ingested ricin and will die",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt",
+            "lydia"
+          ],
+          "also_affects": null,
+          "devices": [
+            "callback"
+          ]
+        },
+        {
+          "event": "Walt walks through the meth lab and leaves a bloody handprint on equipment",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        },
+        {
+          "event": "Walt collapses and dies on the lab floor as police arrive",
+          "storyline": "empire",
+          "function": "resolution",
+          "characters": [
+            "walt"
+          ],
+          "also_affects": [
+            "empire"
+          ],
+          "devices": []
+        }
+      ],
+      "theme": "the final reckoning",
+      "interactions": [
+        {
+          "type": "thematic_rhyme",
+          "lines": [
+            "empire",
+            "guilt",
+            "legacy"
+          ],
+          "description": "all three storylines converge on the theme of facing consequences and choosing how to end one's story",
+          "subtype": null
+        },
+        {
+          "type": "convergence",
+          "lines": [
+            "empire",
+            "guilt",
+            "legacy"
+          ],
+          "description": "Walt's final plan simultaneously destroys his enemies, frees Jesse, and completes his transformation",
+          "subtype": null
+        }
+      ],
+      "patches": [
+        {
+          "action": "CHECK_LINE",
+          "target": "investigation",
+          "reason": "Hank's investigation storyline has no events in the finale - it was resolved in previous episodes",
+          "episodes": [
+            "S05E16"
+          ]
+        },
+        {
+          "action": "CHECK_LINE",
+          "target": "protection",
+          "reason": "Skyler's protection storyline has no events in the finale - it was resolved in previous episodes",
+          "episodes": [
+            "S05E16"
+          ]
+        },
+        {
+          "action": "CHECK_LINE",
+          "target": "survival",
+          "reason": "Mike's survival storyline has no events in the finale - it was resolved when Mike was killed",
+          "episodes": [
+            "S05E16"
+          ]
+        }
+      ]
+    }
+  ],
+  "usage": "21 requests, 84,262 input + 29,781 output tokens, ~$0.573"
+}
\ No newline at end of file
diff --git a/docs/knowledge/results/breakdown-gdr-s01.md b/docs/knowledge/results/breakdown-gdr-s01.md
new file mode 100644
index 0000000..ed512b5
--- /dev/null
+++ b/docs/knowledge/results/breakdown-gdr-s01.md
@@ -0,0 +1,452 @@
+---
+type: note
+project: tvplotlines
+status: active
+---
+
+# ГДР S01 — Storyline Breakdown
+
+## Context
+- **franchise_type**: serial
+- **story_engine**: A KGB officer investigates a conspiracy involving biological weapons and mysterious watches, testing how far he'll go to uncover the truth while his personal life crumbles
+- **format**: ongoing
+
+## Cast
+- **Александр Нечаев** (`nechaev`) — aliases: Нечаев, Александр
+- **Светлана** (`svetlana`) — aliases: Света, Светлана Нечаева
+- **Ингрид** (`ingrid`) — aliases: Ингрид
+- **Фосс** (`foss`) — aliases: Фосс
+- **Жданов** (`zhdanov`) — aliases: Жданов
+- **Генерал Черных** (`chernykh`) — aliases: Черных, генерал Черных
+- **Лиза** (`lisa`) — aliases: Лиза
+- **Константинов** (`konstantinov`) — aliases: Константинов
+- **Майерс** (`myers`) — aliases: Майерс, Майерс-старший, полковник Хаулер
+- **Джек Эванс** (`evans`) — aliases: Эванс, Джек
+
+## Storylines
+
+### [A] Conspiracy (`conspiracy`)
+- **driver**: nechaev
+- **type**: serialized | **nature**: plot-led | **confidence**: solid
+- **goal**: uncover the truth behind the biological weapons conspiracy and mysterious watches
+- **obstacle**: powerful enemies from CIA and KGB, lack of official support, constant danger
+- **stakes**: global security, mass terrorism, personal survival
+- **span**: S01E01, S01E02, S01E03, S01E04, S01E05, S01E06, S01E07, S01E08, S01E09, S01E12, S01E13, S01E14
+
+### [B] Marriage (`marriage`)
+- **driver**: nechaev
+- **type**: serialized | **nature**: character-led | **confidence**: solid
+- **goal**: save his marriage and protect his wife
+- **obstacle**: his dangerous work, wife's affair, CIA targeting Svetlana
+- **stakes**: family breakdown, wife's life
+- **span**: S01E01, S01E02, S01E03, S01E04, S01E06, S01E07, S01E08, S01E10, S01E11, S01E14
+
+### [B] Manipulation (`manipulation`)
+- **driver**: ingrid
+- **type**: serialized | **nature**: character-led | **confidence**: solid
+- **goal**: free her brother Klaus from captivity
+- **obstacle**: Foss's control, dangerous missions, moral compromises
+- **stakes**: brother's life, her own survival
+- **span**: S01E03, S01E04, S01E05, S01E06, S01E07, S01E08, S01E09, S01E10, S01E11, S01E12, S01E13
+
+### [C] Betrayal (`betrayal`)
+- **driver**: zhdanov
+- **type**: serialized | **nature**: plot-led | **confidence**: solid
+- **goal**: maintain his position while serving CIA interests
+- **obstacle**: Nechaev's investigation, suspicion from colleagues
+- **stakes**: exposure as traitor, execution
+- **span**: S01E06, S01E08, S01E10, S01E13, S01E14
+
+### [A] Archives (`archives`)
+- **driver**: nechaev
+- **type**: serialized | **nature**: plot-led | **confidence**: solid
+- **goal**: secure the Stasi archives containing Reagan-Kohl recordings
+- **obstacle**: CIA interference, false leads, internal betrayal
+- **stakes**: Soviet Union's future, Gorbachev's policies
+- **span**: S01E05, S01E09, S01E11, S01E14
+
+---
+
+## Episodes
+
+### S01E01
+**Theme**: the cost of duty
+
+**Conspiracy [A]**
+
+- `setup` — Skyhawk aircraft with biological weapons violates Soviet airspace as CIA provocation  
+  [guest:cia_operatives]
+- `setup` — Nechaev participates in preventing the biological weapons threat  
+  [nechaev]
+- `escalation` — Berlin operation fails, costing Nechaev a colleague and his reputation  
+  [nechaev] *(also: marriage)*
+- `turning_point` — Nechaev is suspended from active duty  
+  [nechaev] *(also: marriage)*
+- `setup` — Colleague unofficially brings Nechaev back into service  
+  [nechaev, guest:colleague]
+- `escalation` — Nechaev goes undercover as photographer to watch American journalist Howard Hailey  
+  [nechaev]
+- `escalation` — Howard Hailey mysteriously dies in his Moscow hotel room  
+  [guest:hailey]
+- `escalation` — Nechaev tracks down magician Myers connected to the death  
+  [nechaev, myers]
+- `turning_point` — Nechaev discovers diamonds hidden in watches  
+  [nechaev]
+
+**Marriage [B]**
+
+- `climax` — Nechaev returns home and hears his wife laughing upstairs with another man  
+  [nechaev, svetlana]
+
+### S01E02
+**Theme**: the price of secrets
+
+**Conspiracy [A]**
+
+- `escalation` — Нечаев и команда отслеживают загадочные часы с ценной информацией  
+  [nechaev]
+- `escalation` — Команда узнает, что у Майерса и Хейли были одинаковые экземпляры часов  
+  [nechaev]
+- `escalation` — Команда узнает, что певец Джек Эванс получает посылку Хейли  
+  [nechaev, evans]
+- `escalation` — Нечаев знакомится с дочерью посла Лизой  
+  [nechaev, lisa]
+- `turning_point` — Нечаев обнаруживает у Эванса прослушивающие устройства  
+  [nechaev, evans]
+- `escalation` — Из озера извлекают автомобиль  
+  [nechaev]
+- `escalation` — Извлечение автомобиля усложняет легенду прикрытия  
+  [nechaev]
+
+**Marriage [B]**
+
+- `escalation` — Светлана убеждает генерала Черных разрешить ей поездку в Берлин на три дня  
+  [svetlana, chernykh] *(also: conspiracy)*
+
+### S01E03
+**Theme**: the cost of secrets
+
+**Conspiracy [A]**
+
+- `escalation` — Нечаев просит Лизу уговорить Эванса дать интервью московскому журналисту  
+  [nechaev, lisa]
+- `escalation` — Нечаев обыскивает квартиру Эванса во время подготовки к интервью  
+  [nechaev]
+- `turning_point` — Нечаев находит скрытые часы и аппаратуру наблюдения в квартире Эванса  
+  [nechaev]
+- `escalation` — Происходит взрыв в морге, где хранилось тело фокусника  
+  [guest:unknown_perpetrator]
+
+**Manipulation [B]**
+
+- `escalation` — Нечаев ставит условие Лизе — объясниться в чувствах и рассказать о планах эмиграции  
+  [nechaev, lisa] *(also: conspiracy)*
+
+**Marriage [B]**
+
+- `escalation` — Светлана приезжает в Берлин  
+  [svetlana]
+- `escalation` — Нечаев отказывается объяснять свою ситуацию Светлане  
+  [nechaev, svetlana]
+
+### S01E04
+**Theme**: the price of truth
+
+**Conspiracy [A]**
+
+- `escalation` — Нечаев прибывает на съёмочную площадку, где Эванс должен передать груз покупателю  
+  [nechaev, evans]
+- `turning_point` — Эванс убит во время съёмок финальной сцены — он умирает на камеру перед всей съёмочной группой  
+  [evans]
+- `escalation` — Часы исчезают  
+  [guest:unknown]
+- `escalation` — Смерть Эванса опустошает его подругу Лизу  
+  [lisa]
+- `escalation` — Нечаев встречается с Майерсом-старшим, который отказывается сотрудничать после гибели сына  
+  [nechaev, myers]
+
+**Marriage [B]**
+
+- `escalation` — Фотографии показывают Светлану с другим мужчиной  
+  [svetlana]
+
+**Manipulation [B]**
+
+- `escalation` — Ингрид приходит в квартиру Нечаева  
+  [ingrid, nechaev] *(also: marriage)*
+- `turning_point` — Их вечер заканчивается в постели  
+  [ingrid, nechaev] *(also: marriage)*
+
+### S01E05
+**Theme**: the price of truth
+
+**Conspiracy [A]**
+
+- `escalation` — Взрыв убивает охранников Майерса  
+  [myers]
+- `escalation` — Майерс оказывается в больнице  
+  [myers]
+- `escalation` — Константинов помогает Нечаеву скрыться  
+  [konstantinov, nechaev]
+- `turning_point` — Нечаев прыгает из окна, пытаясь остановить Ингрид  
+  [nechaev] *(also: manipulation)*
+- `cliffhanger` — Нечаева задерживают и допрашивают по поводу смерти Майерса  
+  [nechaev]
+
+**Manipulation [B]**
+
+- `climax` — Ингрид, переодевшись медсестрой, вводит Майерсу яд в больнице  
+  [ingrid, myers] *(also: conspiracy)*
+
+**Archives [A]**
+
+- `escalation` — Фосс встречается с бывшим начальником разведки КГБ, убеждая его, что копии архивов могут попасть в чужие руки  
+  [foss, guest:former_kgb_chief]
+
+### S01E06
+**Theme**: the price of truth
+
+**Betrayal [C]**
+
+- `escalation` — Фосс организует встречу Жданова и Нечаева  
+  [foss, zhdanov, nechaev] *(also: conspiracy)*
+- `escalation` — Жданов предупреждает, что Нечаев действует независимо от руководства Штази  
+  [zhdanov, nechaev] *(also: conspiracy)*
+- `escalation` — Жданов давит на Нечаева, заставляя работать с ним  
+  [zhdanov, nechaev] *(also: conspiracy)*
+- `escalation` — Жданов показывает Ингрид кассету с записью её ночи с Нечаевым  
+  [zhdanov, ingrid] *(also: manipulation, marriage)*
+
+**Conspiracy [A]**
+
+- `turning_point` — Нечаев признаётся в убийстве, которого не совершал  
+  [nechaev]
+- `escalation` — Во время следственного эксперимента Нечаев обнаруживает тайный проход  
+  [nechaev]
+
+**Manipulation [B]**
+
+- `turning_point` — Жданов вынуждает Ингрид подчиниться  
+  [zhdanov, ingrid] *(also: betrayal)*
+- `escalation` — Ингрид избивает Светлану в туалете ресторана  
+  [ingrid, svetlana] *(also: marriage)*
+
+**Marriage [B]**
+
+- `climax` — Светлану похищают после столкновения  
+  [svetlana] *(also: manipulation)*
+
+### S01E07
+**Theme**: the price of loyalty
+
+**Conspiracy [A]**
+
+- `escalation` — CIA operatives hold Nechaev and Svetlana hostage  
+  [nechaev, svetlana] *(also: marriage)*
+- `turning_point` — CIA realizes Nechaev cannot be broken  
+  [nechaev]
+- `turning_point` — CIA changes their approach  
+  [guest:cia_operatives]
+- `escalation` — Nechaev takes shelter with Ingrid  
+  [nechaev, ingrid] *(also: manipulation)*
+
+**Marriage [B]**
+
+- `climax` — CIA injects poison into Svetlana to force cooperation  
+  [svetlana] *(also: conspiracy)*
+
+**Manipulation [B]**
+
+- `turning_point` — Ingrid reveals that Foss is manipulating her  
+  [ingrid]
+- `escalation` — Ingrid explains Foss is using her brother Klaus as leverage  
+  [ingrid]
+- `escalation` — Ingrid reveals Klaus is being held captive  
+  [ingrid]
+
+### S01E08
+**Theme**: the price of loyalty
+
+**Betrayal [C]**
+
+- `escalation` — Жданов встречает Нечаева на охотничьей базе  
+  [zhdanov, nechaev] *(also: conspiracy)*
+- `escalation` — Жданов требует возвращения Нечаева в Москву  
+  [zhdanov] *(also: conspiracy)*
+
+**Conspiracy [A]**
+
+- `escalation` — Нечаев настаивает на завершении берлинских операций  
+  [nechaev] *(also: betrayal)*
+
+**Marriage [B]**
+
+- `escalation` — Нечаев требует освобождения Светы  
+  [nechaev]
+- `climax` — Светлану допрашивают с помощью сыворотки правды  
+  [svetlana] *(also: conspiracy)*
+- `climax` — Допрос проводят несмотря на беременность Светланы  
+  [svetlana]
+
+**Manipulation [B]**
+
+- `turning_point` — Нечаев восстанавливает контакт с Ингрид  
+  [nechaev, ingrid] *(also: conspiracy)*
+- `turning_point` — Ингрид признаёт, что Фосс контролирует её через брата  
+  [ingrid] *(also: conspiracy)*
+
+### S01E09
+**Theme**: the price of truth
+
+**Manipulation [B]**
+
+- `escalation` — Ингрид получает слепки ключей от квартиры Беттины  
+  [ingrid]
+- `turning_point` — Ингрид связывается с Фоссом, предлагая обмен: полковника на её брата Клауса  
+  [ingrid, foss] *(also: archives)*
+
+**Archives [A]**
+
+- `escalation` — Нечаев и Чигирь проникают в квартиру Беттины  
+  [nechaev, guest:chigir] *(also: conspiracy)*
+- `escalation` — Они копируют файлы о встречах полковника Хаулера в 1984-85 годах при помощи Константинова  
+  [nechaev, konstantinov] *(also: conspiracy)*
+- `climax` — Они пытают Хаулера, чтобы выяснить местоположение архива  
+  [nechaev, guest:chigir] *(also: conspiracy)*
+
+**Conspiracy [A]**
+
+- `turning_point` — Они обнаруживают компьютерные файлы, раскрывающие связь Хаулера с Майерсом  
+  [nechaev] *(also: archives)*
+
+### S01E10
+**Theme**: the price of loyalty
+
+**Manipulation [B]**
+
+- `escalation` — Ингрид устанавливает фальшивую бомбу на полковника Хаулера  
+  [ingrid]
+- `escalation` — Ингрид и Отто направляются к Берлинской стене для обмена пленными  
+  [ingrid, guest:otto]
+- `turning_point` — Ингрид сообщает Фоссу, что полковник заминирован, давая им тридцать минут  
+  [ingrid, foss] *(also: conspiracy)*
+- `climax` — Обмен идёт не по плану — Отто убивает Клауса  
+  [guest:otto, guest:klaus]
+
+**Betrayal [C]**
+
+- `escalation` — Жданов ранен взрывом  
+  [zhdanov]
+
+**Marriage [B]**
+
+- `escalation` — ЦРУ начинает тестировать сыворотку правды на Светлане  
+  [svetlana, guest:cia_agents] *(also: conspiracy)*
+- `climax` — Светлана впадает в кому  
+  [svetlana]
+
+### S01E11
+**Theme**: the cost of choices and consequences
+
+**Archives [A]**
+
+- `turning_point` — Нечаев предлагает сделку Фоссу, обещая информацию об архиве  
+  [nechaev, foss] *(also: conspiracy)*
+
+**Manipulation [B]**
+
+- `resolution` — Ингрид навещает отца, чтобы сообщить о гибели Клауса  
+  [ingrid]
+- `resolution` — Отец обвиняет Ингрид в семейных трагедиях и отказывает в прощении  
+  [ingrid, guest:father]
+- `resolution` — Отец выгоняет Ингрид  
+  [ingrid, guest:father]
+
+**Marriage [B]**
+
+- `climax` — Светлану находят без сознания в церкви во время рейда  
+  [svetlana]
+- `resolution` — Светлану спасают  
+  [svetlana]
+
+### S01E12
+**Theme**: the price of truth
+
+**Conspiracy [A]**
+
+- `escalation` — Генерал Черных помещает Нечаева под домашний арест  
+  [chernykh, nechaev] *(also: marriage)*
+- `turning_point` — Нечаев сбегает из-под домашнего ареста  
+  [nechaev]
+- `escalation` — Нечаев встречается с Маркусом Вольфом  
+  [nechaev, guest:marcus_wolf] *(also: archives)*
+- `cliffhanger` — Требование вернуть Нечаева в Москву к завтрашнему дню  
+  [guest:moscow_officials]
+
+**Manipulation [B]**
+
+- `escalation` — ЦРУ отправляет Ингрид с отравленным конвертом для доставки Светлане  
+  [ingrid] *(also: marriage)*
+
+### S01E13
+**Theme**: the price of truth and loyalty
+
+**Manipulation [B]**
+
+- `climax` — Ингрид доставляет отравленное письмо Светлане  
+  [ingrid, svetlana] *(also: marriage)*
+- `climax` — Ингрид и Светлана борются и падают из окна вместе  
+  [ingrid, svetlana] *(also: marriage)*
+- `resolution` — Ингрид погибает от падения  
+  [ingrid]
+
+**Betrayal [C]**
+
+- `turning_point` — Жданов спасает Светлану  
+  [zhdanov, svetlana] *(also: marriage)*
+- `climax` — Обнаружено дело Корнейчука, которое раскрывает, что Жданов — настоящий предатель  
+  [zhdanov] *(also: conspiracy)*
+
+**Conspiracy [A]**
+
+- `resolution` — Нечаев оправдан — доказательства подтверждают его невиновность  
+  [nechaev] *(also: betrayal)*
+- `resolution` — Нечаев объясняет, что ему пришлось выбирать «между одним человеком и массовым терроризмом»  
+  [nechaev] *(also: marriage)*
+
+### S01E14
+**Theme**: the price of truth and loyalty
+
+**Archives [A]**
+
+- `escalation` — Команда Нечаева проникает в архивы Штази  
+  [nechaev]
+- `turning_point` — Нечаев получает настоящее местоположение архива от Маркуса Вольфа  
+  [nechaev, guest:marcus_wolf]
+- `climax` — Архив содержит запись разговора Рейгана и Коля от мая 1985 года  
+  [nechaev] *(also: conspiracy)*
+
+**Betrayal [C]**
+
+- `escalation` — Лукьянов предаёт команду генералу Черных  
+  [guest:lukyanov, chernykh] *(also: archives)*
+- `climax` — Выясняется, что генерал Черных — агент ЦРУ  
+  [chernykh] *(also: conspiracy)*
+- `resolution` — Хельга раскрывает, что использовался фальшивый архив для поимки предателя  
+  [guest:helga] *(also: archives)*
+
+**Marriage [B]**
+
+- `resolution` — Нечаев обменивает агента ЦРУ Эда Пециуса на отца Светланы  
+  [nechaev, guest:ed_pecius]
+- `cliffhanger` — Нечаев исчезает после обмена  
+  [nechaev] *(also: conspiracy)*
+
+**Conspiracy [A]**
+
+- `climax` — В записи обсуждаются планы обмануть Горбачёва относительно воссоединения Германии  
+  [guest:reagan, guest:kohl] *(also: archives)*
+- `resolution` — Нечаев лично встречается с Горбачёвым  
+  [nechaev, guest:gorbachev]
+- `resolution` — Нечаев передаёт Горбачёву записи о западных планах развала СССР  
+  [nechaev, guest:gorbachev] *(also: archives)*
diff --git a/docs/knowledge/results/breakdown-sp-s01.md b/docs/knowledge/results/breakdown-sp-s01.md
new file mode 100644
index 0000000..2fe5999
--- /dev/null
+++ b/docs/knowledge/results/breakdown-sp-s01.md
@@ -0,0 +1,571 @@
+---
+type: note
+project: tvplotlines
+status: active
+---
+
+# Слово пацана S01 — Storyline Breakdown
+
+## Context
+- **franchise_type**: serial
+- **story_engine**: A teenage boy joins a street gang, testing how far he'll go to survive and belong in a violent world
+- **format**: limited
+
+## Cast
+- **Андрей** (`andrey`) — aliases: Пальто, Андрей Пальто
+- **Марат** (`marat`) — aliases: Марат
+- **Вова Адидас** (`vova`) — aliases: Адидас, Вова
+- **Юлия Александровна** (`julia`) — aliases: мама Андрея, мама
+- **Ирина** (`ira`) — aliases: Ира
+- **Ильдар** (`ildar`) — aliases: следователь Ильдар, оперуполномоченный Ильдар
+- **Айгуль** (`aigul`) — aliases: Айгуль
+- **Кащей** (`kashchey`) — aliases: Кащей
+- **Ералаш** (`eralash`) — aliases: Ералаш
+- **Турбо** (`turbo`) — aliases: Турбо
+- **Зима** (`zima`) — aliases: Зима
+- **Наташа** (`natasha`) — aliases: хирург Наташа, медсестра Наташа
+
+## Storylines
+
+### [A] Belonging (`belonging`)
+- **driver**: andrey
+- **type**: serialized | **nature**: character-led | **confidence**: solid
+- **goal**: найти защиту и принадлежность в уличной группировке
+- **obstacle**: насилие, моральные компромиссы, конфликт с семьёй
+- **stakes**: потеря семьи, тюрьма, смерть
+- **span**: S01E01, S01E02, S01E03, S01E04, S01E06, S01E07, S01E08
+
+### [A] Love (`love`)
+- **driver**: marat
+- **type**: serialized | **nature**: character-led | **confidence**: solid
+- **goal**: защитить и быть с Айгуль
+- **obstacle**: уличные законы, семейный позор, насилие над девушкой
+- **stakes**: потеря любимой, исключение из группировки
+- **span**: S01E01, S01E02, S01E03, S01E04, S01E05, S01E06, S01E07, S01E08
+
+### [A] Leadership (`leadership`)
+- **driver**: vova
+- **type**: serialized | **nature**: plot-led | **confidence**: solid
+- **goal**: защитить группировку и младшего брата
+- **obstacle**: конкурирующие банды, милиция, моральные дилеммы
+- **stakes**: смерть, тюрьма, потеря авторитета
+- **span**: S01E02, S01E03, S01E04, S01E05, S01E06, S01E07, S01E08
+
+### [B] Family (`family`)
+- **driver**: julia
+- **type**: serialized | **nature**: character-led | **confidence**: solid
+- **goal**: сохранить семью и защитить детей
+- **obstacle**: психическое расстройство, давление органов опеки, преступления сына
+- **stakes**: потеря детей, психиатрическая больница
+- **span**: S01E02, S01E04, S01E05, S01E07
+
+### [B] Justice (`justice`)
+- **driver**: ildar
+- **type**: serialized | **nature**: plot-led | **confidence**: solid
+- **goal**: поймать преступников и защитить общество
+- **obstacle**: коррупция, уличные законы, личные отношения
+- **stakes**: безнаказанность преступников, общественная опасность
+- **span**: S01E01, S01E02, S01E07, S01E08
+
+### [C] Redemption (`redemption`)
+- **driver**: ira
+- **type**: serialized | **nature**: character-led | **confidence**: solid
+- **goal**: спасти Андрея от криминального пути
+- **obstacle**: недоверие подростка, привлекательность уличной жизни
+- **stakes**: потеря Андрея, крах его будущего
+- **span**: S01E01, S01E02, S01E03, S01E08
+
+---
+
+## Episodes
+
+### S01E01
+**Theme**: цена принадлежности
+
+**Belonging [A]**
+
+- `setup` — Хулиган в автобусе отбирает деньги у Андрея и Искандера  
+  [andrey, guest:iskander, guest:hooligan]
+- `setup` — Учительница просит Андрея подтянуть Марата по английскому  
+  [andrey, marat]
+- `escalation` — Искандер вступает в группировку 'Разъезд' и требует денег у Андрея  
+  [andrey, guest:iskander]
+- `turning_point` — Андрей решает 'пришиться' к универсамовским для защиты  
+  [andrey]
+- `escalation` — Андрей проходит испытание дракой с Маратом  
+  [andrey, marat]
+- `climax` — Андрей получает прозвище 'Пальто' и принимается в группировку  
+  [andrey]
+- `escalation` — Группировка едет 'на гастроли' в Москву  
+  [andrey, marat]
+- `escalation` — Ребята избивают панка в Москве  
+  [andrey, marat] *(also: justice)*
+
+**Love [A]**
+
+- `setup` — Марат знакомится с Айгуль в музыкальной школе  
+  [marat, aigul]
+- `escalation` — Андрей 'пришивается', чтобы достать номер Айгуль для Марата  
+  [andrey, marat] *(also: belonging)*
+
+**Justice [B]**
+
+- `setup` — Андрея ловит милиция, дело берёт Ирина  
+  [andrey, ira] *(also: belonging, redemption)*
+
+**Redemption [C]**
+
+- `setup` — Андрей влюбляется в Ирину  
+  [andrey, ira]
+
+**Interactions**
+
+- *thematic_rhyme*: все три линии исследуют тему принадлежности — к группе, к любимому человеку, к правильному пути (belonging, love, redemption)
+- *convergence*: Андрей вступает в группировку частично ради помощи Марату с Айгуль (belonging, love)
+- *convergence*: арест Андрея связывает его криминальный путь с системой правосудия и возможностью спасения (belonging, justice, redemption)
+
+### S01E02
+**Theme**: цена принадлежности
+
+**Love [A]**
+
+- `setup` — Появляется отец Марата — состоятельный инженер оборонного завода  
+  [guest:marat_father]
+- `setup` — Сыновья не считают отца авторитетом  
+  [marat]
+- `escalation` — Марат кричит милиция и разгоняет толпу, спасая маму Андрея от потери шубы  
+  [marat] *(also: family)*
+- `escalation` — Кащей избивает Марата за спасение мамы Андрея  
+  [kashchey, marat] *(also: belonging)*
+
+**Belonging [A]**
+
+- `escalation` — Андрей бреется налысо — визуальный маркер вступления в группировку  
+  [andrey] *(also: family, redemption)*
+- `escalation` — Кащей обманывает людей игрой в напёрстки  
+  [kashchey]
+- `escalation` — Марат изображает счастливого победителя в игре  
+  [marat]
+- `escalation` — Ребята делят награбленное  
+  [andrey, marat, eralash]
+- `escalation` — Ералаш покупает бабушке утюг  
+  [eralash]
+- `escalation` — Андрей пишет фальшивые имена (Рэмбо, Робокоп)  
+  [andrey] *(also: justice)*
+- `escalation` — На дискотеке Андрей бьёт Искандера  
+  [andrey, guest:iskander]
+- `climax` — Неизвестные нападают на Ералаша  
+  [eralash, guest:attackers]
+- `climax` — Кирилл наблюдает нападение, но трусливо уезжает  
+  [guest:kirill]
+- `climax` — Ералаш погибает  
+  [eralash] *(also: leadership)*
+
+**Redemption [C]**
+
+- `escalation` — Ира пытается переубедить Андрея, приглашает в кино  
+  [ira, andrey]
+- `turning_point` — Ира пытается публично заставить Андрея рассказать о жизни группировщика  
+  [ira, andrey] *(also: belonging)*
+
+**Family [B]**
+
+- `escalation` — Мама Андрея попадается на обман — проигрывает все деньги и шапку  
+  [julia] *(also: belonging)*
+- `escalation` — Андрей приносит деньги маме — та отказывается  
+  [andrey, julia] *(also: belonging)*
+- `turning_point` — Мама Андрея начинает встречаться с оперуполномоченным Ильдаром  
+  [julia, ildar] *(also: justice)*
+
+**Leadership [A]**
+
+- `setup` — Из Афганистана возвращается Вова Адидас  
+  [vova]
+- `escalation` — Адидас недоволен, что универсамовские отняли деньги у мамы своего же участника  
+  [vova] *(also: family)*
+- `escalation` — Адидас предлагает парням крышевать дороги — останавливать машины и требовать плату  
+  [vova] *(also: belonging)*
+
+**Justice [B]**
+
+- `escalation` — Ильдар приводит Андрея в отделение, сажает за компьютер  
+  [ildar, andrey] *(also: family)*
+- `escalation` — Ильдар просит Андрея сдать членов группировки  
+  [ildar, andrey] *(also: belonging)*
+- `escalation` — После драки Андрея задерживает милиция  
+  [andrey] *(also: belonging)*
+- `climax` — Ильдар понимает, что имена были фальшивыми, и жестоко избивает Андрея  
+  [ildar, andrey] *(also: belonging, family)*
+
+**Interactions**
+
+- *thematic_rhyme*: все сюжетные линии исследуют тему защиты — своих людей, семьи, принципов — и цену, которую за это приходится платить (belonging, love, leadership, family, justice, redemption)
+- *dramatic_irony*: мама Андрея не знает, что её новый возлюбленный избивает её сына (family, justice)
+- *convergence*: противостояние Андрея и Ильдара объединяет криминальную и правоохранительную линии (belonging, justice)
+
+### S01E03
+**Theme**: цена принадлежности
+
+**Love [A]**
+
+- `escalation` — Марат ворует шапку у учительницы английского  
+  [marat]
+- `escalation` — Марат дарит украденную шапку маме Андрея  
+  [marat, julia] *(also: family)*
+- `escalation` — Отец Марата узнаёт о краже шапки и пытается увезти сына к тёте  
+  [guest:marat_father, marat]
+
+**Belonging [A]**
+
+- `escalation` — Кирилл рассказывает, что на Ералаша напали люди из группировки «Разъезд»  
+  [guest:kirill]
+- `turning_point` — Выясняется, что Кирилл солгал — убийцы были из банды «Хади Такташ»  
+  [guest:kirill] *(also: leadership)*
+- `escalation` — Кирилла «отшивают» — бывшие товарищи избивают его и оплёвывают  
+  [vova, andrey]
+- `climax` — Андрей теряет сознание во время драки  
+  [andrey]
+- `resolution` — Андрей приходит в себя в больнице  
+  [andrey]
+- `turning_point` — Андрей узнаёт, что убийца Ералаша в соседней палате  
+  [andrey]
+- `climax` — Андрей ночью пробирается в палату и жестоко избивает убийцу Ералаша  
+  [andrey]
+
+**Leadership [A]**
+
+- `escalation` — Универсамовские устраивают драку с разъездовскими и побеждают  
+  [vova, andrey] *(also: belonging)*
+- `climax` — Универсамовские выходят против хадишевских без Марата  
+  [vova, andrey] *(also: belonging)*
+- `climax` — Во время драки Вову Адидаса ранят в ногу доской с гвоздями  
+  [vova]
+
+**Redemption [C]**
+
+- `escalation` — Андрей приходит домой к Ирине и видит там её нового друга-рок-музыканта  
+  [andrey, ira]
+- `escalation` — Андрей грозит рок-музыканту расправой  
+  [andrey, ira]
+
+**Interactions**
+
+- *thematic_rhyme*: все три сюжетные линии исследуют тему жертв ради принадлежности — Андрей жертвует невинностью, Марат — семейными отношениями, Вова — здоровьем (belonging, love, leadership)
+- *convergence*: сюжетные линии сходятся в драке с «Хади Такташ», где и Андрей, и Вова получают физические и моральные травмы (belonging, leadership)
+- *dramatic_irony*: Ира пытается спасти Андрея, не зная, что он уже совершил жестокое избиение в больнице (redemption, belonging)
+
+### S01E04
+**Theme**: the cost of loyalty
+
+**Leadership [A]**
+
+- `escalation` — Хадишевские штурмуют больницу, чтобы отомстить за своего  
+  [guest:hadishevskie]
+- `escalation` — Марат, Андрей и Турбо экстренно эвакуируют Вову на угнанной машине скорой помощи  
+  [marat, andrey, turbo, vova] *(also: belonging)*
+- `escalation` — Хирург Наташа зашивает рану Адидасу прямо в лифте  
+  [natasha, vova]
+- `turning_point` — Вова выходит против Кащея и отшивает его  
+  [vova, kashchey]
+- `turning_point` — В вещах бывшего лидера находят деньги и пистолет  
+  [vova]
+- `escalation` — Адидас видит перспективу — можно открыть свой видеосалон  
+  [vova]
+
+**Love [A]**
+
+- `escalation` — Марат сбегает из дома и какое-то время живёт у Андрея  
+  [marat, andrey] *(also: belonging)*
+- `escalation` — Айгуль обижена на Марата за то, что он пропал на два дня и не отвечал на звонки  
+  [aigul, marat]
+
+**Belonging [A]**
+
+- `escalation` — Универсамовские ходят в видеосалон  
+  [andrey, marat, vova]
+- `escalation` — Ребята воруют видеомагнитофон  
+  [andrey, marat, vova] *(also: leadership)*
+- `turning_point` — Андрей спорит с комиссией и срывает поступление  
+  [andrey] *(also: family)*
+
+**Family [B]**
+
+- `escalation` — Юлия Александровна приходит в школу, где учительница английского видит на ней свою украденную шапку  
+  [julia, guest:teacher]
+- `turning_point` — Женщина понимает, что сын ей лгал  
+  [julia]
+- `climax` — Она переживает нервный срыв — поджигает себе волосы  
+  [julia]
+- `escalation` — Маму Андрея хотят отправить его в Суворовское училище  
+  [julia, guest:commission]
+
+**Interactions**
+
+- *thematic_rhyme*: все сюжетные линии исследуют цену верности — группировке, любимой, власти, семье (belonging, love, leadership, family)
+- *dramatic_irony*: мать не знает о криминальной деятельности сына, но находит украденные вещи (belonging, family)
+- *convergence*: Марат живет у Андрея, их личные проблемы пересекаются (belonging, love)
+
+### S01E05
+**Theme**: цена защиты близких
+
+**Family [B]**
+
+- `escalation` — Юлию Александровну кладут в психбольницу  
+  [julia]
+- `escalation` — Органы опеки грозятся забрать Андрея и его сестру Юлю в детский дом  
+  [andrey] *(also: belonging)*
+- `resolution` — При помощи Ильдара маму удаётся вернуть домой  
+  [ildar, julia] *(also: justice)*
+
+**Love [A]**
+
+- `setup` — За Айгуль начинает следить странный мужчина на зелёной восьмёрке из группировки «Дом быта»  
+  [aigul]
+- `escalation` — Чтобы отвязаться от преследователя, Айгуль возобновляет отношения с Маратом  
+  [aigul, marat]
+- `escalation` — Айгуль рисует афиши для видеосалона  
+  [aigul] *(also: leadership)*
+- `escalation` — Бандиты похищают Айгуль  
+  [aigul] *(also: leadership)*
+- `climax` — Преследователь совершает сексуализированное насилие над Айгуль  
+  [aigul]
+- `resolution` — Вова спасает Айгуль  
+  [vova, aigul] *(also: leadership)*
+
+**Leadership [A]**
+
+- `setup` — Универсамовские открывают свой видеосалон  
+  [vova]
+- `escalation` — Бандиты из «Дома быта» врываются в салон  
+  [guest:dom_byta_gang]
+- `escalation` — Бандиты забирают магнитофон и избивают Турбо  
+  [turbo]
+- `turning_point` — Вова договаривается о встрече с лидером «Дома быта» Желтым  
+  [vova]
+- `escalation` — На встрече Вову, Марата и Зиму жестоко избивают  
+  [vova, marat, zima] *(also: love)*
+- `escalation` — От Адидаса требуют встать на колени и извиниться, он отказывается  
+  [vova]
+- `turning_point` — Когда брату начинают отрезать ухо, Вова произносит «прости меня»  
+  [vova, marat] *(also: love)*
+- `turning_point` — Вова берёт пистолет Кащея  
+  [vova, kashchey]
+- `climax` — Вова в одиночку приезжает к «Дому быта»  
+  [vova]
+- `climax` — Вова ранит всех присутствующих и убивает Желтого  
+  [vova]
+
+**Interactions**
+
+- *thematic_rhyme*: все три сюжетные линии исследуют тему жертв ради защиты близких — мать борется за детей, Марат и Вова за Айгуль, Вова за брата (family, love, leadership)
+- *convergence*: сюжетные линии сходятся в финальной сцене спасения Айгуль, где цели Марата и Вовы объединяются (love, leadership)
+
+### S01E06
+**Theme**: цена принадлежности
+
+**Love [A]**
+
+- `escalation` — Родители Айгуль отказываются писать заявление против насильника  
+  [guest:aigul_parents] *(also: justice)*
+- `turning_point` — Адидас запрещает Марату встречаться с Айгуль  
+  [vova, marat] *(also: leadership)*
+- `escalation` — Марат заставляет Айгуль сказать, что ничего не было  
+  [marat, aigul]
+- `escalation` — Турбо выясняет правду о случившемся с Айгуль  
+  [turbo]
+- `escalation` — Турбо распространяет информацию на дискотеке  
+  [turbo]
+- `escalation` — Все отворачиваются от Айгуль, включая подруг  
+  [aigul]
+- `escalation` — Айгуль в слезах убегает с дискотеки  
+  [aigul]
+- `escalation` — Родители не поддерживают Айгуль  
+  [aigul, guest:aigul_parents]
+- `cliffhanger` — Айгуль выходит на балкон и готовится прыгнуть  
+  [aigul]
+
+**Leadership [A]**
+
+- `setup` — Вова начинает сближаться с медсестрой Наташей  
+  [vova, natasha]
+- `escalation` — Вова скрывается в общежитии у Наташи  
+  [vova, natasha]
+
+**Belonging [A]**
+
+- `escalation` — Андрей подслушивает телефонный разговор Ильдара  
+  [andrey, ildar] *(also: justice)*
+- `escalation` — Андрей узнаёт, что Вову объявили в розыск за убийство  
+  [andrey] *(also: leadership, justice)*
+- `escalation` — Андрей предупреждает Вову о розыске  
+  [andrey, vova] *(also: leadership)*
+
+**NULL**
+
+- `seed` — На экране показывают некрологи универсамовцев  
+  []
+
+**Interactions**
+
+- *thematic_rhyme*: все три линии показывают, как принадлежность к группе требует жертв — Андрей жертвует моралью, Марат — любовью, Вова — свободой (belonging, love, leadership)
+- *dramatic_irony*: зритель знает, что Андрей помогает разыскиваемому преступнику, предупреждая Вову (belonging, justice)
+- *convergence*: линии сходятся в моменте, когда Андрей предупреждает Вову о розыске (belonging, leadership)
+- *meta*: некрологи в финале — пророческий взгляд в будущее всех персонажей ()
+
+### S01E07
+**Theme**: цена предательства
+
+**Love [A]**
+
+- `climax` — Андрей сообщает Вове, что Айгуль погибла  
+  [andrey, vova] *(also: leadership)*
+- `climax` — Марату в школе сообщают о смерти Айгуль  
+  [marat]
+- `climax` — Марат в шоке убегает из школы  
+  [marat]
+- `escalation` — Турбо поднимает вопрос о Марате и его связи с Айгуль  
+  [turbo, marat] *(also: belonging)*
+- `resolution` — Марата отшивают за нарушение пацанских принципов  
+  [marat] *(also: belonging)*
+- `turning_point` — Марат идёт в милицию к Ильдару  
+  [marat, ildar] *(also: justice)*
+- `climax` — Марат дерётся с Турбо и подкладывает ему пистолет  
+  [marat, turbo] *(also: justice)*
+
+**Leadership [A]**
+
+- `escalation` — Вова отвозит Марата на кладбище к могиле сослуживца  
+  [vova, marat]
+- `turning_point` — Вова не находит сил рассказать Марату о трагедии  
+  [vova, marat] *(also: love)*
+- `escalation` — Вова уезжает с Наташей к её тёте  
+  [vova, natasha]
+- `turning_point` — Выясняется, что тётя — мать убитого Желтого  
+  [vova, natasha]
+- `escalation` — Подельник Желтого узнаёт и избивает Вову  
+  [vova, guest:yellow_accomplice]
+- `climax` — Наташа узнаёт правду и убегает в слезах  
+  [natasha, vova]
+- `resolution` — Вова объявляет банде, что уезжает из города  
+  [vova] *(also: belonging)*
+- `resolution` — Главным в Универсаме становится Зима  
+  [zima] *(also: belonging)*
+
+**Family [B]**
+
+- `escalation` — Юлия Александровна приходит домой без дочери  
+  [julia]
+- `turning_point` — Универсамовские ищут девочку, Турбо находит её  
+  [turbo] *(also: belonging)*
+- `escalation` — Приезжает милиция, маму увозят в больницу  
+  [julia]
+- `escalation` — Органы опеки хотят забрать детей  
+  [julia] *(also: belonging)*
+
+**Belonging [A]**
+
+- `turning_point` — Андрей сбегает, сестру забирают  
+  [andrey] *(also: family)*
+- `escalation` — Андрей живёт в подвальном штабе группировки  
+  [andrey]
+
+**Justice [B]**
+
+- `turning_point` — Марат сдаёт бывших подельников  
+  [marat, ildar] *(also: love)*
+- `climax` — Милиция задерживает Универсамовских  
+  [ildar] *(also: belonging)*
+
+**Interactions**
+
+- *thematic_rhyme*: все три линии исследуют тему предательства — Марат предаёт банду, Вова предаёт Марата молчанием, Андрей предаёт семью ради группировки (love, leadership, belonging)
+- *convergence*: линии Марата и Ильдара сходятся — месть за Айгуль становится сотрудничеством с милицией (love, justice)
+- *dramatic_irony*: зрители знают о смерти Айгуль, а Марат ещё нет — создаёт напряжение в сценах с Вовой (love, leadership)
+
+### S01E08
+**Theme**: the price of choices and the impossibility of return
+
+**Justice [B]**
+
+- `escalation` — Ильдар устраивает очную ставку Марата с Кириллом  
+  [ildar, marat, guest:kirill] *(also: love)*
+- `escalation` — Кирилл утверждает, что пистолет принадлежал Вове Адидасу  
+  [guest:kirill] *(also: leadership)*
+- `turning_point` — Ильдар отпускает Марата  
+  [ildar, marat]
+- `escalation` — Ильдар приходит к Наташе и видит там Вову  
+  [ildar, natasha, vova] *(also: leadership)*
+- `climax` — Ильдар стреляет в убегающего Вову  
+  [ildar, vova] *(also: leadership)*
+
+**Love [A]**
+
+- `escalation` — Драка между Маратом и Кириллом в милиции  
+  [marat, guest:kirill]
+- `escalation` — Марат обвиняет Вову в смерти Айгуль и уходит  
+  [marat, vova] *(also: leadership)*
+- `turning_point` — Денис Коневич вручает Марату грамоту за задержание Турбо  
+  [marat, guest:denis]
+- `turning_point` — Денис предлагает Марату вступить в комсомол  
+  [guest:denis, marat]
+- `escalation` — Марат отбирает пионерский галстук у школьника  
+  [marat]
+- `turning_point` — Марата принимают в комсомол  
+  [marat]
+- `climax` — Денис приводит Марата к насильнику Айгуль  
+  [guest:denis, marat]
+- `climax` — Марат жестоко избивает насильника  
+  [marat, guest:rapist]
+- `resolution` — Марат плачет от бессилия  
+  [marat]
+
+**Belonging [A]**
+
+- `turning_point` — Андрея выпускают из камеры  
+  [andrey]
+- `escalation` — Андрей находит в качалке только Кащея  
+  [andrey, kashchey]
+- `escalation` — Кащей издевается над Андреем и отнимает пальто  
+  [kashchey, andrey]
+- `escalation` — Андрей нападает на Марата за предательство  
+  [andrey, marat] *(also: love)*
+- `escalation` — Андрей побеждает Марата в драке  
+  [andrey, marat]
+- `turning_point` — Андрей идёт на рынок за тортом и цветами  
+  [andrey]
+- `climax` — Мужчина узнаёт Андрея и сдаёт в милицию  
+  [andrey, guest:victim]
+- `resolution` — Андрей играет на пианино в детской колонии  
+  [andrey]
+
+**Redemption [C]**
+
+- `escalation` — Андрей приходит к Ирине  
+  [andrey, ira]
+- `escalation` — Ирина оформляет опеку над Юлей  
+  [ira] *(also: family)*
+- `escalation` — Ирина предлагает Андрею уйти из группировки  
+  [ira, andrey]
+- `turning_point` — Ирина везёт Андрея и Юлю к маме в больницу  
+  [ira, andrey] *(also: family)*
+
+**Leadership [A]**
+
+- `escalation` — Марат находит прячущегося Вову  
+  [marat, vova]
+- `escalation` — Вова и Наташа сбегают, угоняют машину  
+  [vova, natasha]
+- `escalation` — Вова узнаёт о сердечном приступе отца  
+  [vova]
+- `turning_point` — Вова приезжает на юбилей отца  
+  [vova]
+- `climax` — Отец отказывается от Вовы, называет убийцей  
+  [vova, guest:father]
+- `resolution` — Вова умирает на руках Наташи  
+  [vova, natasha]
+
+**Interactions**
+
+- *thematic_rhyme*: all three storylines show characters facing the irreversible consequences of their choices — Andrey loses his freedom, Marat loses his innocence, Vova loses his life (belonging, love, leadership)
+- *convergence*: Ildar's pursuit directly leads to Vova's death (justice, leadership)
+- *dramatic_irony*: Ira tries to save Andrey just as he's about to be caught (redemption, belonging)
diff --git a/docs/knowledge/results/breakdown-td-s01.md b/docs/knowledge/results/breakdown-td-s01.md
new file mode 100644
index 0000000..208f034
--- /dev/null
+++ b/docs/knowledge/results/breakdown-td-s01.md
@@ -0,0 +1,500 @@
+---
+type: note
+project: tvplotlines
+status: active
+---
+
+# True Detective S01 — Storyline Breakdown
+
+## Context
+- **franchise_type**: serial
+- **story_engine**: Two detectives investigate a ritualistic murder that unravels a conspiracy, testing how far they'll go to confront darkness in themselves and society
+- **format**: limited
+
+## Cast
+- **Rustin Cohle** (`rust`) — aliases: Rust, Crash
+- **Martin Hart** (`marty`) — aliases: Marty
+- **Maggie Hart** (`maggie`) — aliases: Maggie
+- **Errol Childress** (`errol`) — aliases: Errol, the scarred man
+- **Billy Lee Tuttle** (`tuttle`) — aliases: Reverend Tuttle
+- **Thomas Papania** (`papania`) — aliases: Papania
+- **Maynard Gilbough** (`gilbough`) — aliases: Gilbough
+
+## Storylines
+
+### [A] Investigation (`investigation`)
+- **driver**: rust
+- **type**: serialized | **nature**: plot-led | **confidence**: solid
+- **goal**: uncover the truth behind the ritualistic murders and expose the conspiracy
+- **obstacle**: powerful people covering up evidence, corrupt officials, personal demons
+- **stakes**: justice for victims, stopping future murders, personal redemption
+- **span**: S01E01, S01E02, S01E03, S01E04, S01E05, S01E06, S01E07, S01E08
+
+### [B] Partnership (`partnership`)
+- **driver**: rust
+- **type**: serialized | **nature**: character-led | **confidence**: solid
+- **goal**: maintain working relationship with Hart despite philosophical differences
+- **obstacle**: conflicting worldviews, personal betrayals, Hart's affair with Maggie
+- **stakes**: solving the case, professional survival, personal connection
+- **span**: S01E01, S01E02, S01E05, S01E06, S01E07, S01E08
+
+### [B] Marriage (`marriage`)
+- **driver**: marty
+- **type**: serialized | **nature**: character-led | **confidence**: solid
+- **goal**: maintain his family while pursuing his desires
+- **obstacle**: infidelity, work obsession, inability to reconcile contradictions
+- **stakes**: family breakdown, loss of daughters, moral identity
+- **span**: S01E02, S01E03, S01E04, S01E05, S01E06, S01E07, S01E08
+
+### [C] Redemption (`redemption`)
+- **driver**: rust
+- **type**: serialized | **nature**: character-led | **confidence**: solid
+- **goal**: find meaning and purpose after personal tragedy
+- **obstacle**: nihilistic philosophy, guilt over daughter's death, addiction
+- **stakes**: spiritual salvation, will to live, connection to humanity
+- **span**: S01E01, S01E02, S01E05, S01E06, S01E07, S01E08
+
+---
+
+## Episodes
+
+### S01E01
+**Theme**: the weight of confronting darkness
+
+**Investigation [A]**
+
+- `setup` — Rust and Marty arrive at the Dora Lange crime scene in the cane fields  
+  [rust, marty]
+- `setup` — They discover Dora's ritualistic posed body with antlers, spiral symbol, and twig structures  
+  [rust, marty]
+- `escalation` — Detectives learn Dora told Charlie Lange she would 'become a nun' and 'met a king'  
+  [rust, marty]
+- `escalation` — Investigation surfaces the Marie Fontenot disappearance case with devil nets  
+  [rust, marty]
+- `escalation` — Report mentions child chased by 'green-eared spaghetti monster'  
+  [rust, marty]
+- `escalation` — Reverend Tuttle's political connections raise suspicion about task force formation  
+  [rust, marty]
+- `escalation` — Black minister mentions police ignored vandalism and animal mutilation at his church  
+  [rust, marty]
+- `setup` — Present-day Papania and Gilbough interview Hart and Cohle separately about Dora Lange  
+  [papania, gilbough, rust, marty] *(also: partnership)*
+- `cliffhanger` — Cohle shown photograph of another similarly posed victim, suggesting killer still active  
+  [rust, papania, gilbough]
+
+**Partnership [B]**
+
+- `setup` — Hart invites Cohle over for dinner, unaware it's Cohle's daughter's death anniversary  
+  [marty, rust] *(also: redemption)*
+- `escalation` — Rust demonstrates his pessimistic philosophy about human consciousness  
+  [rust, marty] *(also: redemption)*
+- `escalation` — Marty represents conventional detective values contrasting with Rust's isolation  
+  [marty, rust] *(also: marriage)*
+- `cliffhanger` — Revealed that Hart and Cohle haven't spoken in ten years after 2002 falling-out  
+  [rust, marty]
+
+**Redemption [C]**
+
+- `setup` — Present-day Rust appears weathered and alcoholic while Marty runs successful security firm  
+  [rust, marty] *(also: partnership)*
+
+**Interactions**
+
+- *thematic_rhyme*: all storylines explore how confronting evil changes people - the case corrupts, partnership fractures, redemption becomes necessary (investigation, partnership, redemption)
+- *meta*: dual timeline structure reveals consequences before causes (investigation, partnership)
+- *dramatic_irony*: audience knows the partnership will fail catastrophically, but sees its hopeful beginning (investigation, partnership)
+
+### S01E02
+**Theme**: the weight of secrets and their corrosive power
+
+**Investigation [A]**
+
+- `escalation` — Cohle and Hart inform Dora's mother of her death  
+  [rust, marty]
+- `escalation` — Dora's mother mentions Dora recently visited claiming to attend church  
+  [rust, marty]
+- `escalation` — They interview Dora's friend Carla about drugs and a shelter near Spanish Lake  
+  [rust, marty]
+- `escalation` — Major Quesada warns they may be replaced by occult-crimes task force  
+  [rust, marty]
+- `escalation` — They investigate The Ranch brothel and interview Dora's friend  
+  [rust, marty]
+- `turning_point` — They find Dora's diary with references to King in Yellow and Carcosa  
+  [rust, marty]
+- `escalation` — They discover Friends of Christ Revival flyer  
+  [rust, marty]
+- `turning_point` — They find abandoned church with antler-crowned female mural  
+  [rust, marty]
+
+**Partnership [B]**
+
+- `escalation` — Rust insults the task force members and is reprimanded  
+  [rust] *(also: investigation)*
+- `escalation` — Marty pleads for more time and gets two-week deadline  
+  [marty] *(also: investigation)*
+- `turning_point` — Cohle deduces Hart is cheating with Lisa Tragnetti  
+  [rust] *(also: marriage)*
+
+**Marriage [B]**
+
+- `escalation` — Marty's in-laws visit and Maggie expresses frustration about his absences  
+  [marty, maggie]
+- `escalation` — Marty's daughters play with dolls in disturbing scene  
+  [marty]
+
+**Redemption [C]**
+
+- `setup` — Cohle reveals his daughter Sofia was killed in driveway accident  
+  [rust]
+- `escalation` — Cohle explains his marriage collapsed and he spiraled into addiction  
+  [rust]
+- `escalation` — Cohle describes four years undercover to avoid prosecution  
+  [rust]
+- `escalation` — Cohle reveals hospitalization after shooting cartel members  
+  [rust]
+- `escalation` — Cohle admits he still experiences chemical flashbacks  
+  [rust]
+
+**Interactions**
+
+- *thematic_rhyme*: all storylines explore how hidden truths destroy relationships and corrupt those who carry them (investigation, partnership, marriage, redemption)
+- *dramatic_irony*: Rust knows about Marty's affair but Maggie doesn't, creating tension in both relationships (partnership, marriage)
+- *convergence*: the disturbing doll scene suggests the occult conspiracy may be affecting Marty's family directly (investigation, marriage)
+
+### S01E03
+**Theme**: the gap between moral judgment and personal action
+
+**Investigation [A]**
+
+- `escalation` — Hart and Cohle locate preacher Joel Theriot and learn about the scarred man  
+  [rust, marty]
+- `escalation` — They face pressure to turn the case over to the task force  
+  [rust, marty] *(also: partnership)*
+- `escalation` — Cohle searches old case files for similar deaths  
+  [rust]
+- `turning_point` — Cohle discovers Rianne Olivier's case with similar elements  
+  [rust]
+- `escalation` — They learn Olivier attended Light of the Way school owned by Tuttle  
+  [rust, marty]
+- `turning_point` — They discover Olivier ran off with Reggie Ledoux  
+  [rust, marty]
+- `escalation` — They learn Ledoux is a drug cook, sex offender, and Lange's ex-husband's cellmate  
+  [rust, marty]
+- `turning_point` — Ledoux becomes their primary suspect  
+  [rust, marty]
+- `cliffhanger` — Reggie Ledoux appears in the bayou with gas mask and machete  
+  [guest:ledoux]
+
+**Marriage [B]**
+
+- `escalation` — Hart begins reconnecting with Maggie  
+  [marty, maggie]
+- `escalation` — Maggie shows growing fascination with Cohle  
+  [maggie] *(also: partnership)*
+- `climax` — Hart assaults Lisa's new boyfriend out of jealousy  
+  [marty] *(also: redemption)*
+- `turning_point` — Hart realizes his inability to reconcile morality with behavior  
+  [marty] *(also: redemption)*
+
+**Interactions**
+
+- *thematic_rhyme*: all storylines explore the disconnect between what characters believe is right and what they actually do (investigation, marriage, redemption)
+- *dramatic_irony*: Hart judges others' morality while being blind to his own hypocrisy, and Maggie's interest in Cohle creates tension Hart doesn't fully recognize (marriage, partnership)
+- *convergence*: the pressure to hand over the case tests both their detective work and their ability to work together (investigation, partnership)
+
+### S01E04
+**Theme**: crossing the line
+
+**Investigation [A]**
+
+- `escalation` — Rust and Marty interrogate Charlie Lange about Reggie Ledoux  
+  [rust, marty]
+- `escalation` — Charlie reveals Reggie discussed devil-worship by rich men involving sacrificing women and children  
+  [guest:charlie]
+- `escalation` — Charlie mentions 'Carcosa' and 'the Yellow King' and describes spiral brand as 'their sign'  
+  [guest:charlie]
+- `escalation` — Charlie admits showing Reggie explicit Polaroids of Dora  
+  [guest:charlie]
+- `escalation` — Marty tracks Tyrone Weems to warehouse rave and violently confronts him  
+  [marty]
+- `escalation` — Tyrone reveals Reggie cooks exclusively for Iron Crusaders biker gang  
+  [guest:tyrone]
+- `turning_point` — Cohle devises off-the-books plan using his undercover biker contacts  
+  [rust] *(also: partnership)*
+- `escalation` — Cohle steals cocaine from police evidence room to use as bait  
+  [rust] *(also: partnership)*
+- `escalation` — Cohle reconnects with Ginger, posing as former cartel security man  
+  [rust]
+- `escalation` — Ginger agrees to connect Cohle with Ledoux's supplier in exchange for helping rob stash house  
+  [guest:ginger]
+- `climax` — Cohle enters stash house with bikers disguised as cops and steals drugs  
+  [rust]
+- `climax` — Shootout erupts and neighborhood descends into chaos  
+  [rust]
+- `climax` — Cohle kidnaps Ginger and fights through houses to Hart's getaway car  
+  [rust, marty] *(also: partnership)*
+- `seed` — Papania and Gilbough question why Cohle took two weeks' leave at critical moment  
+  [papania, gilbough]
+- `seed` — Both Cohle and Hart claim Cohle visited sick father, but no hospital records exist  
+  [rust, marty] *(also: partnership)*
+
+**Marriage [B]**
+
+- `turning_point` — Marty's affair with Lisa is exposed to Maggie  
+  [marty, maggie]
+- `escalation` — Marty's marriage unravels as he displays aggressive behavior toward both women  
+  [marty, maggie]
+- `escalation` — Marty refuses accountability and blames his father's death and alcohol  
+  [marty]
+
+**Interactions**
+
+- *thematic_rhyme*: both storylines explore characters crossing moral boundaries - Rust breaking the law to pursue justice, Marty betraying his marriage vows (investigation, marriage)
+- *dramatic_irony*: the 2012 interrogators suspect Rust and Marty are lying about the two weeks' leave, while the audience sees the dangerous undercover operation (investigation, partnership)
+
+### S01E05
+**Theme**: the corruption of justice
+
+**Investigation [A]**
+
+- `escalation` — Cohle and Ginger meet with DeWall Ledoux to discuss a drug deal  
+  [rust]
+- `escalation` — DeWall senses something dark in Cohle and refuses the deal  
+  [rust] *(also: redemption)*
+- `escalation` — Hart follows DeWall to a remote compound in the bayou  
+  [marty]
+- `escalation` — Cohle and Hart approach the property avoiding booby traps  
+  [rust, marty] *(also: partnership)*
+- `climax` — Hart apprehends Reggie Ledoux while Cohle draws on DeWall  
+  [marty, rust] *(also: partnership)*
+- `climax` — Hart discovers two kidnapped children in horrific conditions  
+  [marty]
+- `turning_point` — Hart executes Ledoux after hearing his last words about black stars and Carcosa  
+  [marty] *(also: partnership)*
+- `resolution` — DeWall flees and is killed by his own land mine  
+  [rust]
+- `resolution` — Both detectives are commended as heroes for rescuing the child  
+  [rust, marty] *(also: partnership)*
+- `escalation` — Cohle interrogates Guy Francis who confesses to crimes  
+  [rust]
+- `turning_point` — Francis claims Ledoux was not the real killer and mentions the Yellow King  
+  [rust]
+- `escalation` — Francis is found dead of apparent suicide after a suspicious phone call  
+  [rust]
+- `escalation` — Cohle identifies officer Childress connected to Marie Fontenot case  
+  [rust]
+- `escalation` — Cohle visits abandoned Light of the Way school and discovers Yellow King symbols  
+  [rust] *(also: redemption)*
+
+**Partnership [B]**
+
+- `escalation` — Cohle fires assault rifle to create false evidence of a shootout  
+  [rust] *(also: investigation)*
+- `turning_point` — Papania and Gilbough tell Hart they suspect Cohle is behind the killings  
+  [marty, papania, gilbough] *(also: investigation)*
+- `escalation` — They reveal Cohle was at Lake Charles crime scene and connected to Tuttle's death  
+  [papania, gilbough] *(also: investigation)*
+- `escalation` — They demand access to Cohle's storage unit which he refuses  
+  [marty] *(also: investigation)*
+
+**Marriage [B]**
+
+- `setup` — Hart has reconciled with Maggie and been promoted seven years later  
+  [marty, maggie]
+- `escalation` — Hart's daughter Audrey is acting out with dark behavior  
+  [marty]
+- `escalation` — Marty slaps Audrey when she curses at him  
+  [marty]
+
+**Redemption [C]**
+
+- `setup` — Cohle has a girlfriend named Laurie and is a renowned interrogator  
+  [rust]
+
+**Interactions**
+
+- *thematic_rhyme*: all storylines explore how pursuing truth and justice corrupts relationships and moral boundaries (investigation, partnership, marriage)
+- *dramatic_irony*: the audience knows Cohle is investigating independently while Hart believes they solved the case (investigation, partnership)
+- *convergence*: the investigation storyline directly threatens the partnership when Hart learns of suspicions about Cohle (investigation, partnership)
+
+### S01E06
+**Theme**: the destructive cost of obsession
+
+**Investigation [A]**
+
+- `escalation` — Cohle investigates missing persons cases and discovers connections to Tuttle's Wellspring Foundation  
+  [rust]
+- `escalation` — Cohle tracks down former preacher Theriot who reveals Tuttle had photos of nude children  
+  [rust]
+- `escalation` — Theriot explains he was intimidated into silence after reporting to Deacon Farrar  
+  [rust]
+- `escalation` — Cohle visits Kelly Reider who describes a giant with scars and screams about the man's face  
+  [rust]
+
+**Redemption [C]**
+
+- `escalation` — Cohle coldly interrogates infanticide woman, suggesting she kill herself  
+  [rust] *(also: partnership)*
+
+**Partnership [B]**
+
+- `escalation` — Marty refuses to engage with Cohle's harsh interrogation methods  
+  [marty]
+- `climax` — Marty attacks and beats Rust in the police station parking lot  
+  [marty, rust] *(also: marriage)*
+- `resolution` — Rust quits the police force  
+  [rust] *(also: investigation)*
+- `seed` — Marty leaves the station after refusing to believe Papania and Gilbough's claims about Rust  
+  [marty, papania, gilbough]
+- `seed` — Maggie is interviewed and defends Rust's character  
+  [maggie]
+- `seed` — Rust's truck pulls up behind Marty's car in 2012 and they exchange greetings  
+  [rust, marty] *(also: investigation)*
+
+**Marriage [B]**
+
+- `escalation` — Marty confronts and beats two young men found with his daughter Audrey  
+  [marty]
+- `escalation` — Marty starts an affair with Beth, a former Ranch worker  
+  [marty]
+- `turning_point` — Maggie discovers evidence of Marty's infidelity on his phone and clothes  
+  [maggie]
+- `escalation` — Maggie attempts to sleep with a stranger at a bar but fails  
+  [maggie]
+- `climax` — Maggie goes to Rust's apartment and seduces him  
+  [maggie, rust] *(also: partnership, redemption)*
+- `climax` — Maggie tells Marty about her encounter with Rust  
+  [maggie, marty] *(also: partnership)*
+
+**Interactions**
+
+- *thematic_rhyme*: all storylines explore how obsessive pursuit of truth, control, or meaning destroys relationships and moral boundaries (investigation, partnership, marriage, redemption)
+- *convergence*: Maggie's seduction of Rust directly destroys the partnership between the detectives (marriage, partnership)
+- *dramatic_irony*: the audience knows Rust is pursuing the truth while the 2012 investigators suspect him of being involved (investigation, partnership)
+
+### S01E07
+**Theme**: the weight of unfinished business
+
+**Partnership [B]**
+
+- `setup` — Rust and Marty meet at a bar in 2012  
+  [rust, marty]
+- `turning_point` — Marty decides to join Rust's investigation  
+  [marty] *(also: investigation)*
+
+**Redemption [C]**
+
+- `escalation` — Rust reveals he's been functional but hammered for ten years  
+  [rust]
+- `turning_point` — Rust confesses he intends to resolve case before ending his life  
+  [rust] *(also: investigation)*
+- `escalation` — Rust describes existence as meaningless circle of violence  
+  [rust]
+
+**Investigation [A]**
+
+- `setup` — Rust explains he returned because a man remembers his debts  
+  [rust] *(also: redemption)*
+- `escalation` — Rust shows Marty his elaborate conspiracy board in storage unit  
+  [rust, marty]
+- `escalation` — Rust theorizes Dora Lange connects to broader Tuttle family network  
+  [rust]
+- `escalation` — Rust identifies scarred man through witness interviews  
+  [rust]
+- `escalation` — Rust reveals illegal break-ins at Tuttle properties in 2010  
+  [rust]
+- `turning_point` — Rust shows Marty VHS tape of Marie Fontenot ritual  
+  [rust, marty]
+- `escalation` — Rust and Marty discover Marie Fontenot's file was removed  
+  [rust, marty]
+- `escalation` — They learn Deputy Geraci mishandled Marie's case  
+  [rust, marty]
+- `escalation` — They discover Sheriff Childress knew Marie's family  
+  [rust, marty]
+- `escalation` — Miss Delores reveals scarred man is likely Tuttle family member  
+  [rust, marty, guest:delores]
+- `escalation` — Delores mentions Carcosa and the Yellow King  
+  [guest:delores]
+- `escalation` — Papania and Gilbough encounter the scarred man mowing grass  
+  [papania, gilbough, errol]
+- `escalation` — The scarred man tells detectives his family has been here a long time  
+  [errol, papania, gilbough]
+- `escalation` — Detectives drive away missing their suspect  
+  [papania, gilbough]
+- `escalation` — Rust and Marty confront Deputy Geraci at gunpoint on boat  
+  [rust, marty, guest:geraci]
+
+**Marriage [B]**
+
+- `resolution` — Marty visits Maggie and thanks her  
+  [marty, maggie]
+- `resolution` — Marty hints to Maggie he may not return  
+  [marty] *(also: investigation)*
+
+**Interactions**
+
+- *thematic_rhyme*: all storylines deal with confronting the past and seeking closure (investigation, redemption, marriage)
+- *dramatic_irony*: the audience sees Errol is the scarred man while Papania and Gilbough miss him completely (investigation)
+- *convergence*: Marty's decision to rejoin Rust merges their personal relationship with the case (investigation, partnership)
+
+### S01E08
+**Theme**: light conquering darkness
+
+**Investigation [A]**
+
+- `setup` — Errol tortures his bound father while speaking in shifting accents  
+  [errol]
+- `escalation` — Rust and Marty force Sheriff Geraci to watch the VHS tape  
+  [rust, marty] *(also: partnership)*
+- `escalation` — Rust arranges for sniper associate to monitor Geraci  
+  [rust]
+- `turning_point` — Rust and Marty identify the green-eared spaghetti monster as a house painter  
+  [rust, marty]
+- `turning_point` — They trace work orders to Childress and Son Maintenance  
+  [rust, marty]
+- `escalation` — Marty discovers Billy Childress restrained with sewn lips  
+  [marty]
+- `escalation` — Marty finds mummified remains and child clothing in the house  
+  [marty]
+- `escalation` — Errol flees into the labyrinthine Carcosa structure  
+  [errol]
+- `escalation` — Rust pursues Errol into the underground catacomb space  
+  [rust] *(also: partnership)*
+- `climax` — Errol ambushes and stabs Rust with a knife  
+  [errol, rust]
+- `climax` — Errol attacks Marty with a hatchet  
+  [errol, marty] *(also: partnership)*
+- `climax` — Rust and Marty fatally shoot Errol  
+  [rust, marty] *(also: partnership)*
+- `resolution` — Papania and Gilbough arrive with backup  
+  [papania, gilbough]
+- `resolution` — Forensic teams link Errol to dozens of missing persons cases  
+  [guest:forensic_teams]
+- `resolution` — State attorney general discredits Tuttle family connections  
+  [guest:attorney_general]
+
+**Redemption [C]**
+
+- `escalation` — Rust experiences hallucinatory vision of spiraling darkness  
+  [rust] *(also: investigation)*
+- `climax` — Rust describes near-death experience with his daughter and father  
+  [rust]
+- `resolution` — Rust's nihilistic worldview fundamentally shifts  
+  [rust]
+- `resolution` — Rust observes that the light is winning over darkness  
+  [rust]
+
+**Marriage [B]**
+
+- `resolution` — Marty's daughters visit him in the hospital  
+  [marty]
+
+**Partnership [B]**
+
+- `resolution` — Marty wheels Rust outside the hospital  
+  [marty, rust]
+
+**Interactions**
+
+- *thematic_rhyme*: both storylines involve confronting ultimate darkness - literal evil in Carcosa and existential void in Rust's psyche - and finding light (investigation, redemption)
+- *convergence*: all storylines converge in Carcosa where the case is solved, partnership is tested and reaffirmed, and Rust finds spiritual transformation (investigation, partnership, redemption)
diff --git a/docs/knowledge/results/run-bb-all-seasons.py b/docs/knowledge/results/run-bb-all-seasons.py
new file mode 100644
index 0000000..07ae4da
--- /dev/null
+++ b/docs/knowledge/results/run-bb-all-seasons.py
@@ -0,0 +1,137 @@
+"""Run Plotter on all 5 seasons of Breaking Bad with prior-season chaining.
+
+Usage:
+    python run_bb_all_seasons.py [--output-dir DIR] [--seasons 1-5]
+
+Reads synopses from plotter-app/data/synopses/BB_S*.txt,
+runs get_plotlines() for each season passing prior result,
+saves JSON output per season.
+"""
+
+import argparse
+import json
+import re
+import sys
+from pathlib import Path
+
+from dotenv import load_dotenv
+
+# Load API keys from plotter's .env
+_PLOTTER_DIR = Path("/Users/nvashko/Projects/1-projects/plotter")
+load_dotenv(_PLOTTER_DIR / ".env")
+
+from plotter import get_plotlines
+from plotter.models import PlotterResult
+
+SYNOPSES_DIR = Path("/Users/nvashko/Projects/1-projects/plotter-app/data/synopses")
+# Fallback if running from different location
+if not SYNOPSES_DIR.exists():
+    SYNOPSES_DIR = Path("/Users/nvashko/Projects/1-projects/plotter-app/data/synopses")
+
+_EPISODE_RE = re.compile(r"BB_(S\d{2}E\d{2})\.txt$")
+
+
+def load_season(season: int) -> dict[str, str]:
+    """Load all synopsis files for a season into a dict."""
+    prefix = f"BB_S{season:02d}E"
+    episodes = {}
+    for path in sorted(SYNOPSES_DIR.glob(f"{prefix}*.txt")):
+        match = _EPISODE_RE.search(path.name)
+        if match:
+            episode_id = match.group(1)
+            episodes[episode_id] = path.read_text(encoding="utf-8").strip()
+    if not episodes:
+        raise FileNotFoundError(f"No synopsis files found for season {season} in {SYNOPSES_DIR}")
+    return episodes
+
+
+def save_result(result: PlotterResult, output_dir: Path, season: int) -> Path:
+    """Save PlotterResult as JSON."""
+    output_dir.mkdir(parents=True, exist_ok=True)
+    path = output_dir / f"bb_s{season:02d}_result.json"
+    path.write_text(
+        json.dumps(result.to_dict(), ensure_ascii=False, indent=2),
+        encoding="utf-8",
+    )
+    return path
+
+
+def load_result(output_dir: Path, season: int) -> PlotterResult | None:
+    """Load a previously saved result to use as prior."""
+    path = output_dir / f"bb_s{season:02d}_result.json"
+    if not path.exists():
+        return None
+    data = json.loads(path.read_text(encoding="utf-8"))
+    from plotter.models import CastMember, EpisodeBreakdown, Plotline, SeriesContext
+    from dataclasses import fields
+    # Reconstruct PlotterResult from dict
+    ctx = SeriesContext(**{f.name: data["context"].get(f.name) for f in fields(SeriesContext)})
+    cast = [CastMember(**c) for c in data.get("cast", [])]
+    plotlines = [Plotline(**p) for p in data.get("plotlines", [])]
+    return PlotterResult(context=ctx, cast=cast, plotlines=plotlines)
+
+
+def parse_season_range(s: str) -> list[int]:
+    """Parse '1-5' or '2' or '1,3,5' into a list of season numbers."""
+    seasons = []
+    for part in s.split(","):
+        if "-" in part:
+            start, end = part.split("-", 1)
+            seasons.extend(range(int(start), int(end) + 1))
+        else:
+            seasons.append(int(part))
+    return seasons
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Run Plotter on Breaking Bad S01-S05")
+    parser.add_argument(
+        "--output-dir", type=Path,
+        default=Path(__file__).parent / "bb_results",
+        help="Directory for output JSON files",
+    )
+    parser.add_argument(
+        "--seasons", type=str, default="1-5",
+        help="Which seasons to run (e.g. '1-5', '2', '3-5')",
+    )
+    args = parser.parse_args()
+
+    seasons = parse_season_range(args.seasons)
+    output_dir = args.output_dir.resolve()
+
+    prior = None
+    for season in seasons:
+        # Load prior from previous season if it exists and we didn't just compute it
+        if prior is None and season > 1:
+            prior = load_result(output_dir, season - 1)
+            if prior:
+                print(f"  Loaded prior from S{season-1:02d} result file")
+
+        episodes = load_season(season)
+        print(f"\n{'='*60}")
+        print(f"Season {season}: {len(episodes)} episodes")
+        if prior:
+            print(f"  Prior: {len(prior.cast)} cast, {len(prior.plotlines)} plotlines")
+        print(f"{'='*60}")
+
+        result = get_plotlines(
+            show="Breaking Bad",
+            season=season,
+            episodes=episodes,
+            prior=prior,
+        )
+
+        path = save_result(result, output_dir, season)
+        print(f"\nSaved to {path}")
+        print(f"  Cast: {', '.join(c.name for c in result.cast)}")
+        print(f"  Plotlines: {', '.join(p.name for p in result.plotlines)}")
+        if result.usage:
+            print(f"  Usage: {result.usage}")
+
+        prior = result
+
+    print(f"\nDone! Results in {output_dir}")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/docs/knowledge/specs/abstract.md b/docs/knowledge/specs/abstract.md
new file mode 100644
index 0000000..eeb0f3d
--- /dev/null
+++ b/docs/knowledge/specs/abstract.md
@@ -0,0 +1,31 @@
+---
+type: note
+project: preprint
+status: active
+---
+
+# Abstract
+
+
+tvplotlines, a Python library that answers these questions:
+How do I figure out which is my A plot and which is my B plot?
+How do you balance A, B, C stories without one getting lost?
+How do you break down a show to understand its structure?
+How do you know when a subplot is a B story vs just a scene?
+How does [show] manage 5 storylines without losing the audience?
+Pick a show you love and pull it apart to see how it works
+
+
+TV episodes run two or more plotlines at once—an A story that takes most of the screen time, B and C stories that cut against it or echo it. Three per episode is standard; ensemble shows often have four or five. Picking which plotlines to tell, how fast to move them, when to collide them—that is the architecture of a show. Dialogue, direction, performance are built on top. If the architecture is weak, no amount of good design will fix it.
+
+tvplotlines, a Python library that extracts this architecture from episode synopses using a multi-pass LLM   pipeline.
+
+
+
+TV episodes  typically feature two or more parallel plotlines, denoted by letters A, B, C: a main A plot that dominates screen time and secondary B plots that may offer thematic parallels or counterpoint. Three stories per episode are typical, though some  shows have more—in ensemble shows it's not unheard of to have 4  or 5 concurrent plotlines.
+
+плотлайнс и  есть гений архитектора шоу. все что потом - чаще всего дизайн, он  должен быть талантливый, но без архитектуры слабо работает. Эта  
+
+статья о библиотеке которая достает архитектуру шоу за минуты
+
+tvplotlines, a Python library that extracts this architecture from episode synopses using a multi-pass LLM   pipeline.
diff --git a/docs/knowledge/specs/architecture.md b/docs/knowledge/specs/architecture.md
new file mode 100644
index 0000000..9cfebe0
--- /dev/null
+++ b/docs/knowledge/specs/architecture.md
@@ -0,0 +1,246 @@
+---
+type: spec
+project: tvplotlines
+status: active
+date: 2026-03-23
+---
+
+# Architecture
+
+TV seasons contain dozens of interwoven plotlines, but no structured representation of that weave exists. Synopses describe what happens; they don't say which events belong to which plotline, where each plotline starts and ends, or how plotlines interact across episodes. This document explains how the tvplotlines pipeline turns raw synopses into that structured representation — what each pass does, why it's designed this way, and what tricks keep LLM calls cheap and results consistent.
+
+## Design principles
+
+* **A pure function, nothing else**
+
+    The entire library is one function call. Synopses go in, structured plotlines come out. No database, no files on disk, no sessions, no hidden state between runs. This makes the library easy to test, easy to embed, and impossible to misconfigure — there is nothing to configure beyond the function arguments.
+
+* **The LLM reads; code enforces**
+
+    Each pass asks the LLM to do what humans do well: read a synopsis and identify who wants what, what stands in their way, and what's at stake. The LLM never decides how to structure the output, what fields to include, or whether a plotline is valid. Code handles all of that — JSON schema validation, referential integrity checks, rank distribution rules. This split exists because LLMs are good readers but unreliable bookkeepers.
+
+* **Deterministic by default**
+
+    All LLM calls use temperature=0. Pass 1 runs three identical calls and picks the majority result. The same synopses produce the same plotlines. This matters because the library's output feeds downstream tools — dashboards, editors, exports — that break when structure shifts between runs.
+
+* **Extract first, review second**
+
+    The pipeline has two phases. The first phase (Pass 0 through Pass 2) extracts raw structure: what plotlines exist, what events belong to each plotline in each episode. The second phase (post-processing and Pass 3) reviews that structure and corrects it. Separating extraction from review means the LLM in Pass 3 sees the full picture — all plotlines, all episodes, all spans — before making editorial decisions like merging two plotlines or promoting a rank.
+
+* **Every LLM response is validated**
+
+    The library never trusts raw LLM output. Every response is parsed, checked against the expected schema, and tested for referential integrity: does this character ID exist in the cast? Does this plotline ID exist? Is the rank distribution legal for this format? Validation failures raise clear errors instead of propagating silently into downstream passes.
+
+## Overview
+
+The pipeline has two main phases: extract and review. Both are orchestrated by `pipeline.py`.
+
+### Extract phase
+
+This phase starts with a set of episode synopses and builds the raw structural model of the season. It runs three passes in sequence, each one building on the output of the previous.
+
+Pass 0 reads a few synopses and determines the show's format — procedural, serial, hybrid, or limited — along with a one-sentence story engine that describes how the show generates plot, and a genre tag. Pass 1 reads all synopses and extracts the cast and plotlines, each described by its Story DNA: hero, goal, obstacle, stakes. Pass 2 reads one episode at a time and assigns individual events to plotlines, tagging each event with its narrative function (setup, escalation, turning point, climax, resolution) and capturing the episode's thematic summary.
+
+### Review phase
+
+This phase takes the raw extraction and refines it. Post-processing computes derived metrics — which episodes each plotline spans, how much screen weight it carries per episode, whether the rank distribution matches the format. Pass 3 then reviews the full picture and issues structural corrections: merge two plotlines that are really one, promote a plotline that earned more screen time than its rank suggests, reassign a misplaced event. Code applies these corrections mechanically; the LLM only decides what to change, not how.
+
+## How context shapes the pipeline
+
+Every TV show has a format that determines how plotlines behave. A procedural like House resets its A-plotline every episode — the medical case is self-contained, while serialized B and C plotlines carry across the season. A serial like Breaking Bad runs all plotlines continuously. A hybrid like The Good Wife mixes both. Getting this wrong cascades through the entire pipeline: if the model thinks a serial is a procedural, it will look for a case-of-the-week plotline that doesn't exist.
+
+Pass 0 exists to detect this format from the synopses themselves. It reads the first two or three episodes and returns a format classification, a story engine — a one-sentence description of the show's plot-generation mechanism — and a reasoning field that explains why this format was chosen. For House, the story engine might be "a new patient each episode forces a diagnostic puzzle." For Breaking Bad, "Walt's choices create escalating consequences." The reasoning field is not used downstream but makes the classification auditable: if Pass 0 misclassifies a show, the reasoning tells you why.
+
+The format classification controls downstream behavior. In Pass 1, it determines how many A-rank plotlines are legal: one for serial, procedural, and hybrid formats; two or more for ensemble shows like This Is Us. In post-processing, it determines how rank validation works. The caller can also provide context directly, bypassing Pass 0 entirely.
+
+Two boolean flags extend the format. `is_ensemble` marks shows with multiple co-equal A-rank plotlines. `is_anthology` marks shows where seasons are independent — when this is true, prior-season continuity is disabled.
+
+## How plotlines are extracted
+
+A synopsis describes events but doesn't say which events belong together. Two characters meeting in episode three might advance a plotline that started in episode one, or it might be a standalone beat. Pass 1 resolves this ambiguity. The LLM reads all synopses for the season and returns two things: a cast list (characters with IDs and aliases) and a set of plotlines.
+
+Each plotline is described by four fields borrowed from narrative theory, collectively called Story DNA: the hero (who drives the plotline), the goal (what they want), the obstacle (what prevents them), and the stakes (what happens if they fail). These four fields anchor the plotline's identity. Everything else — rank, type, nature, confidence — describes the plotline's structural role in the season.
+
+Rank (A, B, C, or runner) reflects screen time weight. Type distinguishes between case-of-the-week plotlines that reset every episode, serialized plotlines that run across episodes, and runners — low-key threads that surface occasionally and pay off late. Nature marks whether the plotline is plot-led or character-led. Confidence signals how certain the extraction is: solid, partial, or inferred.
+
+### Majority voting
+
+Pass 1 makes three parallel LLM calls with identical inputs and picks the result that appears most often. This exists because even at temperature=0, LLM output can vary slightly between calls — a plotline might get a different name or a borderline character might be included or excluded. Voting stabilizes the output. Whether this is necessary at temperature=0 remains an open question; it's a candidate for removal after ablation testing.
+
+### Prior season continuity
+
+When a previous season's result is provided, Pass 0 is skipped entirely — the context carries over. Pass 1 receives the prior season's cast and plotlines as additional input and marks each prior plotline with a continuity status: CONTINUES (same hero, same goal), TRANSFORMED (same hero, new goal), or ENDED (resolved). Character and plotline IDs are preserved across seasons so that downstream tools can track arcs over time. Anthology formats disable this mechanism — each season starts fresh.
+
+## How events are assigned to plotlines
+
+Knowing what plotlines exist is not enough — each individual event in each episode needs to be linked to the plotline it advances. A single synopsis might contain beats from three different plotlines interleaved in a few paragraphs. Pass 2 resolves this by processing one episode at a time.
+
+For each episode, the LLM reads the synopsis alongside the cast and plotline definitions from Pass 1. It returns a structured breakdown: a thematic summary of the episode, a list of events, a set of interactions between plotlines, and suggested patches.
+
+Each event is a single narrative beat — one sentence describing what happened. The LLM assigns it to a plotline (or marks it as unassigned) and tags it with a narrative function. It also lists the characters involved and notes which other plotlines the event secondarily affects. Narrative functions position events within a plotline's arc: setup, escalation, turning point, climax, resolution. An event's function tells you where in the story the plotline stands at that moment.
+
+Interactions capture how plotlines relate within an episode. A thematic rhyme means two plotlines echo the same theme. Dramatic irony means the audience knows something a character doesn't. Convergence means two plotlines physically meet. Meta covers structural devices like twist-reveals or time jumps.
+
+Patches are the LLM's self-correction mechanism. When Pass 2 encounters something that doesn't fit the plotline definitions from Pass 1 — an orphan event with no matching plotline, a plotline that should be split, a rank that looks wrong — it flags the issue as a patch. Patches are not applied during Pass 2. They're passed forward to Pass 3 as additional context for the structural review.
+
+### Execution modes
+
+Processing episodes is the most expensive part of the pipeline — one LLM call per episode. The library offers three modes to manage this cost.
+
+Parallel mode (the default) sends all episodes at once as concurrent async calls. This is the fastest option. The system prompt is cached on the API side, so only the first episode pays the full prompt cost.
+
+Batch mode uses the Anthropic Message Batches API. All episodes are submitted as a single batch job at a 50% discount. The trade-off is latency — batch jobs are processed asynchronously and may take minutes to hours.
+
+Sequential mode processes one episode at a time. It's slower and costs the same as parallel mode, but fires a callback after each episode, making it useful for debugging and progress monitoring.
+
+## What post-processing computes
+
+Raw LLM output from Pass 2 has gaps. Some events lack a plotline assignment. Plotline ranks reflect the LLM's judgment but not the actual data. Span and weight — how many episodes a plotline covers and how much screen time it commands — can't be known until all episodes are processed. Post-processing fills these gaps with four deterministic computations, no LLM calls.
+
+Orphan assignment resolves events that Pass 2 left unlinked to any plotline. For each orphan event, the code looks at which characters are involved, finds the plotlines those characters most often appear in, and assigns the event to the best match.
+
+Span computation collects, for each plotline, the list of episodes where it has at least one event. This is a concrete measure of how many episodes a plotline actually appears in, as opposed to how many it was intended to cover.
+
+Weight computation measures how much screen time a plotline commands per episode. A plotline with the most events in an episode gets "primary" weight. Those with fewer events get "background." A single event earns "glimpse."
+
+Rank validation checks whether the A/B/C distribution matches the show's format. If an A-rank plotline only spans 25% of the season, the code demotes it to B and raises a diagnostic flag. If a single plotline accounts for more than 50% of all events, a dominance flag goes up. These diagnostics feed into Pass 3.
+
+## How the structural review works
+
+Extraction passes work episode by episode — none of them sees the full season at once. This means systematic errors accumulate: a plotline that spans two episodes might be identified as two separate plotlines; a rank assigned from three synopses might not hold up across twelve. Pass 3 exists to catch these errors.
+
+Pass 3 is the editorial pass. It sees everything: all plotlines with their spans and per-episode weights, all events across all episodes, all patches from Pass 2, and all diagnostic flags from post-processing. From this full picture, it issues verdicts — structural corrections to apply.
+
+Six verdict types exist, each corresponding to an editorial decision. MERGE combines two plotlines that are really phases of the same story — if "Walt starts cooking" and "Walt builds an empire" share a hero and one flows into the other, they should be one plotline. REASSIGN moves a misplaced event from one plotline to another. PROMOTE and DEMOTE adjust a plotline's rank when the data contradicts the original assignment. CREATE adds a new plotline when multiple orphan events form a coherent thread that Pass 1 missed. DROP removes a plotline that turned out to be noise, redistributing its events elsewhere.
+
+The LLM decides which verdicts to issue and returns a free-text quality assessment alongside them. Code then applies each verdict mechanically — updating plotline lists, reassigning events, recomputing spans. After all verdicts are applied, the pipeline re-runs span computation and rank validation to ensure the corrections didn't introduce new inconsistencies.
+
+## The LLM call structure
+
+Each LLM call has two parts: a system prompt and a user message. The system prompt is the full prompt file — rules, definitions, output format — unchanged across calls within the same pass. The user message carries the concrete data for one specific call.
+
+```
+Pass 0:  1 call    system = pass0.md
+                    user   = {show, season, first 2–3 synopses}
+
+Pass 1:  3 calls   system = pass1.md
+                    user   = {show, season, context, all synopses}
+
+Pass 2:  N calls   system = pass2.md  ← cached across episodes
+                    user   = {episode synopsis, cast, plotlines}
+
+Pass 3:  1 call    system = pass3.md
+                    user   = {full result + diagnostics}
+```
+
+A full run costs 5+N LLM calls, where N is the number of episodes. If majority voting in Pass 1 is removed after ablation testing, that drops to 3+N.
+
+### Prompt caching
+
+The system prompt for Pass 2 is identical across all episodes. With Anthropic's prompt caching, the API charges full price for the first episode and a 90% discount on system prompt tokens for every subsequent episode. This is the single largest cost optimization in the pipeline — Pass 2 prompts are 10-15KB, and a typical season has 10-24 episodes.
+
+### Batching
+
+Pass 2 calls are independent — episode order doesn't matter, and no call depends on another's result. Batch mode (described in "Execution modes" above) exploits this by submitting all episodes as one API batch job at half price.
+
+## Two layers: library and application
+
+```
+┌─────────────────────────────────────────────┐
+│  Application (proprietary)                  │
+│                                             │
+│  UI → editing → database → export           │
+│         │                     ▲              │
+│         ▼                     │              │
+│   get_plotlines()  →  result                │
+│                                             │
+│  ┌─────────────────────────────────────┐    │
+│  │  Library (open source, pip)         │    │
+│  │                                     │    │
+│  │  synopses → processing → result    │    │
+│  │  (no DB, no files, no UI)          │    │
+│  └─────────────────────────────────────┘    │
+└─────────────────────────────────────────────┘
+```
+
+The library is pure computation — data in, answer out. It knows nothing about files, databases, or interfaces. The application is a separate product built on top: it displays results, stores them, and lets users edit. Open source covers the library only.
+
+## Resilience
+
+The library remains a pure function with no stored state. But it survives API outages and lets callers save intermediate results for resumption.
+
+### Retries
+
+Transient errors — connection drops, rate limits, 500s — are automatically retried with exponential backoff (up to 3 attempts, delays of 2/4/8 seconds). Each request has a configurable timeout (default 120 seconds). In parallel mode, failed episodes do not crash the whole run — successful results are preserved and only failures are retried.
+
+### Callbacks
+
+```python
+from tvplotlines import get_plotlines, PipelineCallback
+
+class SaveCheckpoints(PipelineCallback):
+    def on_pass1_complete(self, cast, plotlines):
+        save_json("checkpoint_pass1.json", {"cast": cast, "plotlines": plotlines})
+
+    def on_episode_complete(self, index, breakdown):
+        # Only fires in sequential mode
+        save_json(f"checkpoint_ep{index}.json", breakdown)
+
+    def on_batch_submitted(self, batch_id):
+        save_text("batch_id.txt", batch_id)  # save for crash recovery
+
+result = get_plotlines(
+    show="House", season=1, episodes=synopses,
+    pass2_mode="sequential",
+    callback=SaveCheckpoints(),
+)
+```
+
+`PipelineCallback` is a base class with no-op methods. Override the ones you need:
+
+| Method | When it fires |
+|--------|--------------|
+| `on_pass0_complete(context)` | After context detection |
+| `on_pass1_complete(cast, plotlines)` | After plotline and cast extraction |
+| `on_episode_complete(index, breakdown)` | After each episode (sequential mode only) |
+| `on_pass2_complete(breakdowns)` | After all episodes are processed |
+| `on_batch_submitted(batch_id)` | After batch creation, before polling |
+| `on_pass3_complete(verdicts)` | After structural review |
+
+A buggy callback never kills the pipeline — exceptions are logged and execution continues.
+
+### Resume
+
+If a run is interrupted, restart from saved intermediate results to skip expensive LLM calls:
+
+```python
+# Pipeline crashed after Pass 2 — rerun only Pass 3
+result = get_plotlines(
+    show="House", season=1, episodes=synopses,
+    context=saved_context,           # skip Pass 0
+    cast=saved_cast,                 # skip Pass 1
+    plotlines=saved_plotlines,       #
+    breakdowns=saved_breakdowns,     # skip Pass 2
+)
+```
+
+Two constraints: `cast` and `plotlines` must be provided together, and `breakdowns` length must match `episodes` length. Post-processing always runs regardless — it's fast and deterministic.
+
+Batch mode supports resumption by batch ID. If the process dies during polling, the batch already exists on the API side and can be resumed without re-submitting:
+
+```python
+result = get_plotlines(
+    show="House", season=1, episodes=synopses,
+    pass2_mode="batch",
+    batch_id="msgbatch_abc123",    # skip creation, go straight to polling
+)
+```
+
+## What the library does NOT contain
+
+- No databases
+- No file reads or writes
+- No web server or API
+- No UI or dashboard
+- No hidden state between calls
+- No NLP preprocessing — synopses are already clean text
diff --git a/docs/knowledge/specs/event-functions-redesign.md b/docs/knowledge/specs/event-functions-redesign.md
new file mode 100644
index 0000000..eae8f09
--- /dev/null
+++ b/docs/knowledge/specs/event-functions-redesign.md
@@ -0,0 +1,252 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# TODO: Redesign event functions
+
+## Problem
+
+Current 7 functions: `setup`, `escalation`, `turning_point`, `climax`, `resolution`, `cliffhanger`, `seed`.
+
+Issues:
+- `cliffhanger` and `seed` are not arc positions — they're narrative mechanics (modifiers). A cliffhanger IS a climax or turning_point that's cut at the peak. A seed IS a setup for a future storyline.
+- Missing `catalyst` (inciting incident) — "the single most important beat" (Nash p.14). LLM has no way to mark the trigger event that launches a storyline.
+- Missing `crisis` (All Is Lost) — "the lowest point, a whiff of death" (Nash p.15). LLM conflates this with escalation or turning_point.
+- LLM misuses `seed` for any future-facing setup (should be rare, 2-3 per season).
+- LLM misuses `cliffhanger` in mid-season episodes (should be act breaks or finales).
+- Each event gets exactly one function — but a catalyst can consist of multiple events.
+
+## Proposed functions (7)
+
+| #   | function            | Act | definition                                      | sources                                                                                                                                                                    |
+| --- | ------------------- | --- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 1   | `setup`             | 1   | Context, status quo, establishing the world     | Nash: Set-Up, Netflix: Setup, Oberg: "before"                                                                                                                              |
+| 2   | `inciting Incident` | 1   | Trigger event that launches the storyline       | Nash: Catalyst ("the thing that happens that makes everything else happen" p.14), Netflix: Inciting Incident ("must happen in first 20 pages"), Douglas: inciting incident |
+| 3   | `escalation`        | 2   | Stakes rise, situation complicates              | Nash: Bad Guys Close In, Netflix: Escalation, Pena: Stakes Escalation                                                                                                      |
+| 4   | `turning_point`     | 2   | Direction changes, false peak or false collapse | Nash: Midpoint ("false peak or false collapse, stakes are raised" p.15), Netflix: Midpoint (BIG twist)                                                                     |
+| 5   | `crisis`            | 2   | Lowest point, "whiff of death"                  | Nash: All Is Lost ("the moment the hero most feared actually happens" p.15) + Dark Night of the Soul, Netflix: Crisis                                                      |
+| 6   | `climax`            | 3   | Peak confrontation                              | Nash: Finale, Netflix: Climax                                                                                                                                              |
+| 7   | `resolution`        | 3   | Outcome, aftermath                              | Nash: Final Image, Netflix: Resolution/Denouement                                                                                                                          |
+
+Changes from current: +inciting Incident, +crisis, -cliffhanger, -seed.
+
+## Fractal structure: three levels of the same arc
+
+The same 7-phase arc applies at three levels (Oberg: "The dramatic three-act structure can be applied at any level: scene, sequence, subplot, storyline, episode or season"):
+
+| Level | What | Who labels | How |
+|-------|------|------------|-----|
+| **Episode** | arc of a single episode | LLM (Pass 2) | Already does this — `Event.function` |
+| **Storyline** | arc of one storyline across the season | Computed | Group events by storyline, sort by episode → arc phases |
+| **Season** | arc of the whole season | Computed | A-storyline's arc (franchise engine) |
+
+**One event, three functions.** Example: Walt kills Krazy-8 (S01E03):
+
+| Level | Function | Why |
+|-------|----------|-----|
+| Episode | climax | Peak tension of this episode |
+| Storyline (empire) | escalation | Still early in the season arc |
+| Season | escalation | Season is still building |
+
+LLM labels episode-level (what it sees). Storyline-level and season-level are computed from data.
+
+### Episode tension: max across all storylines
+
+Episode tension = max function weight across **all** storylines present in that episode.
+
+Why: the viewer feels tension regardless of which storyline causes it. If a C-storyline has a climax in E05, E05 is a tense episode even if the A-storyline is just escalating.
+
+Dramatic weight scale: setup(1) → catalyst(2) → escalation(3) → turning_point(4) → crisis(5) → climax(6) → resolution(1). Resolution returns to baseline — the arc on a graph is a mountain: rise 1→6, drop to 1.
+
+**Important**: these weights represent **structural position in the arc**, not emotional intensity. A catalyst (weight 2) can be emotionally more powerful than an escalation (weight 3) — e.g. cancer diagnosis vs "someone arrived". The weight says WHERE in the arc, not HOW STRONG the feeling. This matters for visualization: the tension curve shows arc progression, not emotional intensity.
+
+### Season arc: follows the A-storyline
+
+Season arc = A-storyline's arc across the season. The season is structured around the protagonist's journey — the A-storyline's phases define the season's shape (Netflix Season Map).
+
+Episode tension (all storylines) adds texture and variation, but the season's structural backbone is A.
+
+### Non-consecutive phases and arc monotonicity
+
+Grouping consecutive same-function events gives phases. But what about: escalation → turning_point → escalation?
+
+This is **normal** — Nash: "beat sheet is an itinerary, not a calendar. Beats can expand, contract, move around." After a turning_point, stakes can continue to rise (Bad Guys Close In comes AFTER Midpoint). The arc is not strictly monotonic.
+
+But some returns signal errors. Rule: **no return past a milestone**. Milestones = catalyst, turning_point, crisis, climax.
+
+- **OK**: escalation → turning_point → escalation (filling between milestones)
+- **Suspicious**: crisis → climax → crisis (return past climax milestone)
+- **Error**: resolution → escalation (return past climax AND crisis)
+
+Pass 3 should check: if a storyline arc returns past a milestone, flag for REFUNCTION.
+
+### Season arc: alternative computation methods
+
+Two options to test:
+- **Simple**: season arc = A-storyline's arc (franchise engine, Nash)
+- **Weighted**: episode weight = A×3 + B×2 + C×1 + runner×0.5 (gives A priority without ignoring others)
+
+Start with simple. If the shape doesn't match Netflix Season Map on BB S01-S05, try weighted.
+
+### Pass 3 validates computed arcs
+
+```
+Pass 2: LLM labels episode-level functions
+    ↓
+Post-processing: compute storyline arcs + season arc
+    ↓
+Pass 3: receives computed arcs, validates:
+    - storyline arc complete? (has catalyst? has climax?)
+    - order logical? (catalyst before escalation?)
+    - season arc shape makes sense? (climax near end?)
+    ↓
+Verdicts: REFUNCTION (new verdict type) if function assignment is wrong
+```
+
+Pass 3 doesn't compute — it **validates**. Code computes, LLM reviews.
+
+tvplotlines could show all three levels — that the season arc is composed of storyline arcs, which are composed of episode arcs. This would be a strong illustration for the preprint.
+
+### Netflix Season Map (Todd Kessler)
+
+| ACT 1               | ACT 2                       | ACT 3                  |
+|----------------------|-----------------------------|------------------------|
+| Teaser               | Episodes 4–5 (Escalation)   | Episode 8+ (Resolution)|
+| Inciting Incident    | Midpoint (BIG twist)        | Descending Action      |
+| Pilot 2–3 (Setup)    | Episodes 6–7 (Confrontation)| Denouement (wrap-up)   |
+| Climax of Act One    | Crisis                      | CLIFFHANGER            |
+|                      | Climax of Act Two           |                        |
+
+## Modifiers (future consideration)
+
+`cliffhanger` and `seed` become modifiers that can attach to any function:
+- `cliffhanger` — unresolved conflict at end of scene/episode/season (Oberg p.65, Landau: "must grow out of character jeopardy, risk, or fear" p.268)
+- `seed` — plants something for future payoff (Landau: "eating your seed corn" — don't use up all your seeds)
+
+Not in scope for first iteration — focus on getting the 7 functions right.
+
+## Sources
+
+- Nash, *Save the Cat! Writes for TV* — beat sheet, 5 pillar beats, Story DNA
+- Netflix Pitch Workshop — Season Map (Todd Kessler), inciting incident, crisis
+- Oberg, *Screenwriting Unchained* — fractal three-act structure at any level
+- Douglas, *Writing the TV Drama Series* — act breaks, inciting incident
+- Landau, *The TV Showrunner's Roadmap* — cliffhangers, seed corn, act breaks from characters
+- Pena, *Developing Series Television* — detailed beat structure
+- Harmon Story Circle — YOU/NEED/GO/STRUGGLE/FIND/SUFFER/RETURN/CHANGE
+
+## Post-processing: building storyline arcs from flat events
+
+After Pass 2, we have a flat list of events per episode. Post-processing builds the arc:
+
+1. Take all events for storyline `empire` across all episodes
+2. Sort by episode order (S01E01 → S01E02 → ...)
+3. Group consecutive events with the same function → phase
+4. Result: ordered list of phases, each with episode range and event list
+
+```
+Input (flat, from Pass 2):
+  S01E01: Walt diagnosed with cancer         → empire, setup
+  S01E01: Walt sees Jesse escape raid         → empire, setup
+  S01E01: Walt proposes partnership           → empire, catalyst
+  S01E01: First cook produces 99.1% meth     → empire, catalyst
+  S01E02: Emilio and Krazy-8 arrive          → empire, escalation
+  S01E03: Walt kills Krazy-8                 → empire, escalation
+  S01E05: Walt decides to sell to Tuco       → empire, turning_point
+  S01E06: Tuco beats Jesse                   → empire, crisis
+  S01E07: Walt confronts Tuco with crystals  → empire, climax
+  S01E07: Walt secures the deal              → empire, resolution
+
+Output (arc):
+  Walt: Empire:
+    SETUP      [S01E01..S01E01]  2 events  ██
+    CATALYST   [S01E01..S01E01]  2 events  ██
+    ESCALATION [S01E02..S01E03]  2 events  ██
+    TURN.POINT [S01E05..S01E05]  1 event   █
+    CRISIS     [S01E06..S01E06]  1 event   █
+    CLIMAX     [S01E07..S01E07]  1 event   █
+    RESOLUTION [S01E07..S01E07]  1 event   █
+```
+
+This is pure code (no LLM). New function in `postprocess.py`.
+
+## Arc completeness metric
+
+Derived metric per storyline: how many of the 7 phases are present.
+
+```
+Walt: Empire    — 7/7 (setup, catalyst, escalation, turning_point, crisis, climax, resolution)
+Hank: Investigation — 5/7 (setup, catalyst, escalation, turning_point, climax — no crisis, no resolution)
+```
+
+Computation: `len(set(event.function for event in storyline_events)) / 7`
+
+This is a **fact**, not a quality judgment. 5/7 for a runner is normal. 5/7 for an A-storyline is a signal for Pass 3 to investigate (missing crisis in the main arc?).
+
+Expected minimum completeness by rank:
+
+| Rank | Min | Rationale |
+|------|-----|-----------|
+| A | 6/7 | Main arc, may lack crisis |
+| B | 5/7 | Secondary, may lack crisis or resolution |
+| C | 3/7 | Minor thread |
+| runner | 1/7 | Incomplete Story DNA by definition |
+
+Pass 3 checks: completeness < expected minimum for rank → flag.
+
+Useful for: visualization (completeness bars), Pass 3 validation, preprint analysis.
+
+## Episode arc vs storyline arc divergence
+
+The most interesting insight for visualization. When episode function ≠ storyline function for the same event, it reveals where the show is structurally clever.
+
+Example: "Walt kills Krazy-8" = episode climax (peak of E03), but storyline escalation (early in the season). Where these two levels diverge strongly — those are the most interesting moments of dramaturgy: the episode peaks on what is still just build-up for the season.
+
+Visualization idea: two small numbers in a cell (ep: climax / arc: escalation), or color-code the divergence.
+
+## Episode arc construction
+
+Episode arc is built from events of ALL storylines within one episode, in the order LLM listed them (which follows synopsis chronological order).
+
+Same algorithm as storyline arc (group consecutive same-function → phases), but across storylines within one episode instead of across episodes within one storyline.
+
+## Convergence: directed storyline intersections
+
+Convergence = when an event from storyline A affects storyline B. NOT just "both present in same episode".
+
+Data source: `Event.also_affects` field — list of storyline IDs that the event secondarily impacts. Already exists in the model.
+
+Example: event "Walt kills Krazy-8" belongs to `empire` with `also_affects: ["investigation"]` — Walt's action in the empire storyline impacts Hank's investigation.
+
+This is a **directed** relationship: A→B ≠ B→A. "How many times did empire events affect investigation" vs "how many times did investigation events affect empire".
+
+Visualization:
+- **Directed matrix**: rows = source storyline, columns = target storyline. Cell value = count of also_affects links. Asymmetric.
+- **Timeline arcs with arrows**: at each episode, draw A→B arrow where an event crosses storylines. Direction matters.
+
+Data is already collected by Pass 2 — no new LLM work. Post-processing aggregates `also_affects` into a convergence matrix. New function in `postprocess.py`.
+
+## Implementation scope
+
+| What | Where | Size | LLM involved? |
+|------|-------|------|---------------|
+| Change function enum | Pass 2 prompt, pass2.py | Small | Yes (prompt change — needs autoresearch) |
+| Arc building from flat events | postprocess.py | Medium | No |
+| Convergence matrix from also_affects | postprocess.py | Small | No |
+| Arc visualization | tvplotlines-app | Large | No |
+| Convergence visualization | tvplotlines-app | Medium | No |
+| Pass 3 arc checking update | Pass 3 prompt | Small | Yes (prompt change) |
+
+## Files to change (when implementing)
+
+- `src/tvplotlines/models.py` — Event.function enum + new phase model
+- `src/tvplotlines/prompts_en/pass2.md` — function definitions (TESTED PROMPT — change only through autoresearch)
+- `src/tvplotlines/prompts/pass2.md` — same, Russian
+- `src/tvplotlines/pass2.py` — validation
+- `src/tvplotlines/postprocess.py` — span/weight computation
+- `src/tvplotlines/prompts_en/pass3.md` — arc checking in Step 2
+- `docs/api.md` — documentation
+
+**WARNING**: Pass 2 prompt is tested through autoresearch. Any changes must go through A/B testing, not direct editing. See lesson 2026-03-16 in lessons.md.
diff --git a/docs/knowledge/specs/heuristics-from-theory.md b/docs/knowledge/specs/heuristics-from-theory.md
new file mode 100644
index 0000000..0d9934d
--- /dev/null
+++ b/docs/knowledge/specs/heuristics-from-theory.md
@@ -0,0 +1,106 @@
+---
+type: note
+project: tvplotlines
+status: active
+---
+
+# Эвристики из теории: что набрать из учебников перед написанием промптов и кода
+
+Источник: ревью промптов (`pass0.md` — `pass3.md`) и кода (`pass0.py` — `postprocess.py`). Много правил сидят в промптах как расплывчатый текст, хотя их можно формализовать в код. Но прежде чем формализовать — нужно набрать эвристик из учебников (Nash, Douglas, Oberg, Landau, Mittell, McKee, Netflix workshop).
+
+Общий принцип:
+
+```
+Теория (учебники) → Эвристики (таблица правил) → Код (валидация)
+                                                → Промпт (только то, что код не может проверить)
+```
+
+Каждое правило из промпта: **можно проверить кодом?** Если да → убрать из промпта, написать проверку. Qiu 2025: код-проверка даёт +11.7pp, правила в промпте — +1.1pp.
+
+---
+
+## 1. Порядок функций в арке (→ `postprocess.py`)
+
+**Сейчас:** в промпте Pass 3 одна строка: "A healthy storyline has an arc: setup → escalation → turning_point → climax → resolution". Код ничего не проверяет.
+
+**Набрать из учебников:** таблицу правил — какие функции имеют строгий порядок между собой, какие могут меняться местами, какие могут повторяться. Источники: Nash (beat sheet order), McKee (5 elements), Netflix Season Map.
+
+**Куда:** код-валидация в `postprocess.py` после Pass 2, до Pass 3. Жёсткие нарушения → флаг для Pass 3. Мягкие → диагностика.
+
+## 2. Ожидания по структуре сезона (→ `postprocess.py` + `pass3.py`)
+
+**Сейчас:** в промпте Pass 3 — "storyline structure should match the type", расплывчато. В коде: только "procedural/hybrid = 1 episodic" и "serial = 1 A-rank".
+
+**Набрать из учебников:**
+
+| Правило | Источник | Где проверять |
+|---------|----------|--------------|
+| Первый эпизод: setup для A-линии | Nash: "Set-Up" | Код после Pass 2 |
+| Последний эпизод limited: resolution для A/B | Nash, Netflix | Код после Pass 2 |
+| Последний эпизод ongoing: cliffhanger/seed ок | Landau | Код после Pass 2 |
+| Episodic линия: в каждом эпизоде | Douglas | Код: `compute_span` |
+| Serialized: span ≥ 2 эпизодов | По определению | Код: `compute_span` |
+| A-rank: не "glimpse" > 1-2 эпизодов | Nash | Код: `validate_ranks` |
+| Procedural: episodic = больше всего событий | Douglas | Код: `validate_ranks` |
+
+## 3. Story DNA completeness (→ `pass1.py`)
+
+**Сейчас:** промпт говорит "Missing any component — not a storyline". Код не проверяет.
+
+**Набрать:** Nash p.34 — "Story DNA has four parts." Но runner может не иметь obstacle, "partial" confidence допускает неполную DNA.
+
+**Куда:** код-валидация: non-runner + solid → все поля непустые. Runner → goal непустая. Пустые поля при solid → re-request или понизить confidence.
+
+## 4. Количество линий по типу (→ `pass1.py`)
+
+**Сейчас:** в промпте числа, в коде не проверяются.
+
+**Набрать:**
+
+| Franchise type | Min | Max | Источник |
+|---------------|-----|-----|----------|
+| Procedural | 2 | 5 | Douglas |
+| Serial | 3 | 8 | Nash |
+| Hybrid | 3 | 6 | Douglas |
+| Ensemble | 4 | 8 | Mittell |
+
+**Куда:** код-валидация в `pass1.py`.
+
+## 5. A-rank = всегда plot-led? (→ проверить)
+
+Промпт утверждает. Nash/Douglas подтверждают? В ensemble возможна A-линия character-led. Если теория не подтверждает — убрать.
+
+## 6. Episodic как тип линии (→ глоссарий)
+
+Douglas/Mittell используют "case-of-the-week", не "episodic storyline". Nash не использует. Либо заменить, либо дать формальное определение со ссылкой.
+
+## 7. Narrative devices — нужны ли?
+
+Список из 6 devices в Pass 1 И Pass 2. Downstream не используются. Если нигде → убрать (~200 tokens экономия). Если для визуализации → только в Pass 2.
+
+## 8. Interactions — формализовать или убрать
+
+- **Convergence** уже покрывается через `also_affects` → дублирование?
+- **Thematic rhyme** — Nash: "B-story reflects A-story theme." Оставить если используется.
+- **Dramatic irony** — полезно для визуализации.
+- **Meta** — расплывчатая категория → убрать.
+
+## 9. "Emotional counterpoint"
+
+Промпт Pass 2: "if all storylines rising or falling — something is missed." Основание есть (Nash, Douglas), но это не правило для LLM — это диагностический флаг. Перенести в код: все функции в эпизоде = escalation → флаг "monotone episode".
+
+## 10. Weight — откалибровать пороги
+
+Код: primary ≥ 50% max, background ≥ 2, glimpse = 1. Произвольные. Nash/Douglas: "A = 60-70%, B = 20-30%". Можно откалибровать.
+
+## 11. Pass 3: какие verdicts вычислить кодом
+
+| Verdict | Кодом? | Как |
+|---------|--------|-----|
+| PROMOTE/DEMOTE | Да | Уже частично в `validate_ranks` |
+| MERGE | Частично | Один driver + cosine similarity goals > 0.9 |
+| RERANK | Да | Rank ≠ event count |
+| REASSIGN | Нет | Нарративное суждение |
+| CREATE | Нет | Нарративное суждение |
+
+Детерминированные verdicts применять до Pass 3.
diff --git a/docs/knowledge/specs/input-parser-plan.md b/docs/knowledge/specs/input-parser-plan.md
new file mode 100644
index 0000000..f57c285
--- /dev/null
+++ b/docs/knowledge/specs/input-parser-plan.md
@@ -0,0 +1,199 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# Input parser — план реализации
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Научить `tvplotlines run` принимать один текстовый файл со всеми синопсисами. Сценарист пишет `.txt` или `.md` по трём простым правилам — программа парсит название шоу, сезон и разбивает на эпизоды. Ключевой use case — сценаристы работающие с **оригинальным** контентом (пилоты, разработка шоу), а не только копирующие с Википедии.
+
+**Architecture:** Новый модуль `input_parser.py` — парсит файл, возвращает `(show, season, dict[str, str])`. CLI поддерживает два режима: новый (один файл) и старый (много файлов + `--show`). Python API (`get_plotlines`) не меняется.
+
+**Tech Stack:** Только stdlib (re, pathlib). Никаких зависимостей.
+
+---
+
+## Решения
+
+| # | Вопрос | Решение |
+|---|--------|---------|
+| 1 | Обратная совместимость CLI | Оба режима. Detect by: есть `--show` → старый, нет → парсим файл. Autoresearch, program-v2, tvplotlines-app не ломаются |
+| 2 | Encoding | Явно `encoding="utf-8"`. При `UnicodeDecodeError` — ошибка: "File is not UTF-8. Save as UTF-8 and try again." |
+| 3 | `__init__.py` exports | Не экспортируем. `parse_synopsis_file` — внутренний модуль для CLI, не часть публичного API |
+| 4 | `--lang` | Остаётся как отдельный CLI-флаг. Парсер не детектит язык. `--lang` передаётся в pipeline как раньше |
+| 5 | YAML frontmatter | Убрано. Overengineering — ни одной реальной аудитории |
+| 6 | Название эпизода (`- Pilot`) | Не парсим отдельно. Строка заголовка целиком отбрасывается, всё после неё до следующего заголовка — текст синопсиса |
+| 7 | Русское название шоу | Валидации нет. Если пользователь написал "Доктор Хаус" — pipeline получит русское название. LLM мультиязычный, справится |
+| 8 | Regex edge cases | Тесты на: "24, Season 1", "9-1-1, Season 1", "House S01", "House S1". Regex будет отлажен по тестам |
+| 9 | Порядок эпизодов | Сортировать по номеру из заголовка, не по порядку в файле |
+| 10 | Дубликаты | Ошибка: "Duplicate Episode N found" |
+| 11 | Интеграционный тест | Manual smoke test (pipeline стоит $1.5+, нужен API key). Не автоматизированный |
+| 12 | Текст между заголовком и первым эпизодом | Warning: "Text before first episode heading will be ignored". Не ломать, не молчать |
+| 13 | Интерфейс `parse_episodes` | Принимает полный текст файла, пропускает всё до первого `Episode N`. Заголовок файла не его забота — его парсит `parse_header` |
+| 14 | Приоритет CLI-флагов vs файл | CLI-флаг побеждает файл. `--show` и `--season` переопределяют то что в первой строке (явное важнее неявного) |
+| 15 | Остальные CLI-флаги | `--output`, `--provider`, `--model`, `--base-url`, `--skip-review`, `--pass2-mode`, `--lang` — работают как раньше, не затрагиваются |
+| 16 | Сокращение "S01" / "S1" | Поддерживаем в regex: `(?:Season\|сезон\|S)\s*(\d+)`. "House S01", "House S1" — валидные форматы |
+
+## Формат ввода для пользователя
+
+Три правила:
+
+1. **Первая строка** — название шоу и номер сезона
+2. **Каждый эпизод** начинается с заголовка (`Episode 1`, `Эпизод 1`)
+3. **Текст синопсиса** — всё до следующего заголовка
+
+### Пример файла
+
+```
+House, Season 1
+
+Episode 1
+Dr. Gregory House reluctantly takes on a new case when a young
+kindergarten teacher collapses in her classroom with seizures...
+
+Episode 2
+A teenage lacrosse player is brought in with seizures. House
+suspects it's not epilepsy and pushes his team to find the cause...
+
+Episode 3
+A college student collapses after a night with his girlfriend...
+```
+
+### CLI
+
+```bash
+# Новый способ — один файл, всё внутри
+tvplotlines run house_s01.txt
+
+# Старый способ — отдельные файлы (обратная совместимость для autoresearch/scripts)
+tvplotlines run synopses/*.txt --show "House" --season 1
+```
+
+## Логика парсера
+
+### Определение режима (в cli.py)
+
+- Есть `--show` → старый режим (как сейчас, любое количество файлов)
+- Нет `--show` + один файл → новый режим (парсим файл)
+- Нет `--show` + много файлов → ошибка: "Specify --show when passing multiple files, or use single-file format"
+
+### Парсинг первой строки
+
+BOM/whitespace: `text.lstrip('\ufeff').strip().splitlines()[0]`
+
+Извлечь show и season из строк вида:
+- `House, Season 1` → show="House", season=1
+- `Breaking Bad Season 2` → show="Breaking Bad", season=2
+- `Слово пацана, сезон 1` → show="Слово пацана", season=1
+
+Паттерн: `(.+?)[,.]?\s+(?:Season|сезон|S)\s*(\d+)` (case-insensitive)
+
+Поддерживает: "House, Season 1", "House Season 1", "House S01", "House S1", "Слово пацана, сезон 1".
+
+Если не распознал — ошибка с примером:
+```
+Could not parse show and season from first line: "..."
+Expected format: "Show Name, Season N"
+Example: "House, Season 1"
+```
+
+### Парсинг эпизодов
+
+Заголовок эпизода — строка, начинающаяся с:
+- `Episode N` / `episode N`
+- `Эпизод N` / `эпизод N`
+- `# Episode N` (markdown — парсер поймёт, но в документации не учим)
+
+Паттерн: `^(?:#+ )?(?:Episode|Эпизод|Ep\.?)\s+(\d+)` (case-insensitive)
+
+**Не поддерживаем:** `N.` и `N -` (нумерованные списки — коллизии).
+
+Всё после строки-заголовка до следующего заголовка — текст синопсиса. Текст между заголовком файла и первым эпизодом — warning и пропуск.
+
+`parse_episodes` принимает полный текст файла, пропускает всё до первого заголовка эпизода. Разделение ответственности: `parse_header` парсит первую строку, `parse_episodes` парсит эпизоды.
+
+### Валидация
+
+- Дубликаты → ошибка: "Duplicate Episode N found"
+- Пустой синопсис → warning, пропуск
+- Текст до первого эпизода → warning: "Text before first episode heading will be ignored"
+- Эпизоды сортируются по номеру (не по порядку в файле)
+
+## Файловая структура
+
+### Новые файлы
+
+- `src/tvplotlines/input_parser.py` — парсинг файла
+- `tests/test_input_parser.py` — тесты
+- `examples/input_format.txt` — пример для пользователя
+
+### Изменения в существующих файлах
+
+- `cli.py` — логика выбора режима + вызов `input_parser`
+- `README.md` — обновить Quick Start (новый способ первым, старый как альтернатива)
+
+## Задачи
+
+### Task 1: Парсер первой строки
+
+**Files:**
+- Create: `src/tvplotlines/input_parser.py`
+- Create: `tests/test_input_parser.py`
+
+- [ ] Функция `parse_header(text: str) -> tuple[str, int]` — возвращает (show, season)
+- [ ] BOM/whitespace handling
+- [ ] Тесты: "House, Season 1", "Breaking Bad Season 2", "Слово пацана, сезон 1", "24, Season 1", "9-1-1, Season 1", "House S01", "House S1", невалидная строка
+- [ ] Commit
+
+### Task 2: Парсер эпизодов
+
+**Files:**
+- Modify: `src/tvplotlines/input_parser.py`
+- Modify: `tests/test_input_parser.py`
+
+- [ ] Функция `parse_episodes(text: str) -> list[tuple[int, str]]` — возвращает [(номер, текст)]
+- [ ] Тесты: "Episode 1", "# Episode 1", "Эпизод 1", пустой синопсис, Episode 3 перед Episode 2 (сортировка), дубликаты (ошибка), текст перед первым эпизодом (warning)
+- [ ] Commit
+
+### Task 3: Основная функция
+
+**Files:**
+- Modify: `src/tvplotlines/input_parser.py`
+- Modify: `tests/test_input_parser.py`
+
+- [ ] Функция `parse_synopsis_file(path: Path) -> tuple[str, int, dict[str, str]]`
+- [ ] Encoding: `path.read_text(encoding="utf-8")`, `UnicodeDecodeError` → понятная ошибка
+- [ ] Тест на полном файле (заголовок + несколько эпизодов)
+- [ ] Тест ошибок: нет заголовка, нет эпизодов, пустой файл, не UTF-8
+- [ ] Commit
+
+### Task 4: CLI интеграция
+
+**Files:**
+- Modify: `src/tvplotlines/cli.py`
+
+- [ ] Логика выбора режима: есть `--show` → старый, нет `--show` + один файл → парсим, нет `--show` + много файлов → ошибка
+- [ ] `--show` и `--season` — опциональные override (CLI-флаг побеждает файл). В старом режиме `--show` обязателен
+- [ ] Все остальные флаги (`--output`, `--provider`, `--model`, `--lang`, `--skip-review`, `--pass2-mode`) работают как раньше
+- [ ] Тест: оба режима работают
+- [ ] Commit
+
+### Task 5: Пример и документация
+
+**Files:**
+- Create: `examples/input_format.txt`
+- Modify: `README.md`
+
+- [ ] Пример файла с 2-3 эпизодами True Detective S01
+- [ ] README: новый способ первым в Quick Start, старый как альтернатива для скриптов
+- [ ] `--help`: описание формата файла
+- [ ] Commit
+
+### Task 6: Manual smoke test
+
+- [ ] Создать тестовый файл из fixtures (True Detective S01E01-E04)
+- [ ] `tvplotlines run test_file.txt` — прогнать pipeline до конца, проверить result.json
+- [ ] Требует API key, запускается вручную
diff --git a/docs/knowledge/specs/inventory.md b/docs/knowledge/specs/inventory.md
new file mode 100644
index 0000000..153fe4a
--- /dev/null
+++ b/docs/knowledge/specs/inventory.md
@@ -0,0 +1,143 @@
+---
+type: spec
+project: tvplotlines
+status: active
+---
+
+# Инвентаризация: теория, технология, своё, чужое
+
+## 1. ТЕОРИЯ (знания, модели, классификации)
+
+### Своё
+- **A/B/C классификация сюжетных линий** — вместо академических anthology/soap/genre → индустриальные A (жанр), B (отношения), C (побочная). Основано на Nash, Douglas, реальной практике
+- **Критика оригинала** — "25 арок в Слово пацана — это бред, обычно 3 основных линии". Понимание что модель перегенерирует
+- **Procedural / serialized / hybrid** — типология форматов сериалов, влияет на то какие линии ожидать
+- **Horizontal / vertical storylines** — из Douglas, деление линий по способу развёртывания
+- **Формула "знания из книг → формальная модель → инструкции для ИИ"** — методологический подход, которого нет у авторов
+
+### Из книг (база знаний, строится сейчас)
+- Nash — Save the Cat Writes for TV (A/B/C storylines, 15-beat)
+- Douglas — Writing the TV Drama Series (horizontal/vertical, структура сезона)
+- Landau — TV Showrunner's Roadmap (21 навигационная точка)
+- Mittell — Complex TV (нарративная сложность)
+- Weiland — Creating Character Arcs
+- Rabkin — Writing the Pilot
+- + ещё ~14 книг в how2pitch по питчу и структуре
+
+### Из статей
+- Balestri & Pescatore 2025 (ICAART) — идея мультиагентной экстракции арок
+- Статьи с arxiv — решения проблем контекста и галлюцинаций (конкретные?)
+
+---
+
+## 2. ТЕХНОЛОГИЯ (код, инструменты, реализации)
+
+### Своё (написано с нуля)
+| Что | Где | Суть |
+|---|---|---|
+| Русский NLP-пайплайн | mas4bw: ru_*.py | NER через Natasha, русские промпты, русские титулы |
+| Синопсис-пайплайн | mas4bw: main_synopsis.py | Обход тяжёлой NLP-обработки, прямая подача текста |
+| Мульти-LLM поддержка | mas4bw: ai_models.py | OpenAI + Anthropic + Azure вместо только Azure |
+| Парсер синопсисов из PDF | mas4bw: parse_season_synopsis.py | PDF → эпизоды → файлы |
+| База знаний по питчу | how2pitch: quotes/*.json | ~786 цитат из 6 книг, переведены на русский |
+| Визард для питча | how2pitch: index.html | Пошаговый процесс от идеи до синопсисов серий |
+| Глоссарий | how2pitch: glossary.json | 60+ терминов EN→RU |
+| Весь books2series | books2series/ | Пайплайн книга→события→персонажи→питч |
+| Баг-фиксы оригинала | mas4bw | Pydantic v2, SQLite, пустые ответы |
+
+### Чужое (взято, используется как есть или модифицировано)
+| Что | Откуда | Лицензия | Статус |
+|---|---|---|---|
+| 9-шаговый граф экстракции | Balestri & Pescatore | CC BY-NC-ND | **Нужно переписать** |
+| Промпты (EN оригиналы) | Balestri & Pescatore | CC BY-NC-ND | **Нужно переписать** |
+| Схема БД (NarrativeArc и др.) | Balestri & Pescatore | CC BY-NC-ND | **Нужно переписать** |
+| Три типа арок | Balestri & Pescatore | CC BY-NC-ND | **Заменяем на A/B/C** |
+
+### Зависимости (библиотеки, фреймворки — свободные)
+| Что | Зачем | Лицензия |
+|---|---|---|
+| LangGraph | Оркестрация шагов графа | MIT |
+| LangChain | Вызовы LLM | MIT |
+| Pydantic | Модели данных | MIT |
+| spaCy | NER английский | MIT |
+| Natasha | NER русский | MIT |
+| ChromaDB | Векторный поиск | Apache 2.0 |
+| SQLModel | ORM для SQLite | MIT |
+| FastAPI | API | MIT |
+| React | Фронтенд | MIT |
+
+---
+
+## 3. ЧТО НУЖНО ПЕРЕПИСАТЬ ДЛЯ СВОЕЙ РЕАЛИЗАЦИИ
+
+Всё что под лицензией CC BY-NC-ND (Balestri & Pescatore) нужно написать заново.
+Идеи из статьи использовать можно — идеи не защищаются лицензией.
+Код — нельзя копировать.
+
+### Что берём как ИДЕЮ (из статьи):
+- Мультиагентный подход к экстракции (несколько LLM-вызовов с разными ролями)
+- Дедупликация через векторное сходство
+- Верификация результатов отдельным шагом
+
+### Что пишем СВОЁ (на основе книг + опыта):
+- Классификация линий: A/B/C вместо anthology/soap/genre
+- Количество и логика шагов: не 9 фиксированных, а столько сколько нужно
+- Промпты: на основе знаний из 20 книг, а не эмпирического подбора
+- Схема данных: Storyline вместо NarrativeArc, с полями под A/B/C модель
+- Входной формат: синопсисы как основной путь (не полные тексты)
+
+---
+
+## 4. OPEN SOURCE АРХИТЕКТУРА
+
+Из трёх продуктов mas4bw — лучший кандидат на библиотеку/фреймворк.
+books2series — был назван лучшим кандидатом на фреймворк (расширяемые схемы, предикаты, entity resolution).
+
+### Вариант: единый фреймворк
+
+```
+screenwriting-toolkit/              ← зонтичный проект
+├── core/                           ← общие модели, утилиты
+│   ├── models.py                   ← Storyline, Character, Event, Episode
+│   ├── llm.py                      ← абстракция над LLM-провайдерами
+│   └── io.py                       ← чтение синопсисов, книг, PDF
+├── storylines/                     ← бывший mas4bw
+│   ├── extract.py                  ← extract_storylines(episodes) → list[Storyline]
+│   ├── classify.py                 ← A/B/C классификация
+│   ├── prompts/                    ← промпты по языкам
+│   └── knowledge/                  ← знания из книг (что такое A-line, B-line)
+├── books/                          ← бывший books2series
+│   ├── extract.py                  ← extract_events(book) → list[Event]
+│   ├── characters.py               ← extract_characters(book) → list[Character]
+│   ├── screen.py                   ← screen_book(book, brief) → BookCard
+│   └── domain/                     ← предикаты, онтологии
+├── pitch/                          ← бывший how2pitch
+│   ├── knowledge/                  ← база знаний из 20 книг
+│   ├── wizard.py                   ← пошаговый визард
+│   └── templates/                  ← шаблоны питч-библии
+└── apps/                           ← веб-интерфейсы (не open source?)
+    ├── storyline_viewer/
+    ├── book_explorer/
+    └── pitch_wizard/
+```
+
+### Что открываем, что нет
+
+| Компонент | Open source? | Почему |
+|---|---|---|
+| core/ | Да | Общие модели, всем полезны |
+| storylines/ | Да | Переписано с нуля, на основе книг |
+| books/ | Частично | Базовая экстракция — да, domain-модели — нет |
+| pitch/knowledge | Да (датасет) | Люди добавляют книги |
+| pitch/wizard | Нет | Продукт, можно продавать |
+| apps/ | Нет | Коммерческие интерфейсы |
+
+---
+
+## 5. ОТКРЫТЫЕ ВОПРОСЫ
+
+- [ ] Какие именно статьи с arxiv использовались для решения проблем контекста?
+- [ ] Сколько шагов нужно в новом пайплайне? (определится из книг)
+- [ ] Писать авторам сейчас или после переписывания?
+- [ ] Название: screenwriting-toolkit? story-engine? narrative-kit?
+- [ ] Монорепо или отдельные пакеты?
diff --git a/docs/knowledge/specs/mas4bw-library-audit.md b/docs/knowledge/specs/mas4bw-library-audit.md
new file mode 100644
index 0000000..86b06f1
--- /dev/null
+++ b/docs/knowledge/specs/mas4bw-library-audit.md
@@ -0,0 +1,102 @@
+---
+type: spec
+project: tvplotlines
+status: active
+---
+
+# Технический аудит mas4bw: выделение ядра в библиотеку
+
+## Текущая архитектура
+
+mas4bw — монолитное приложение с четырьмя слоями:
+
+1. **Скрипты обработки** (`main.py`, `main_ru.py`, `main_synopsis.py`) — точки входа
+2. **Ядро экстракции** — LangGraph стейт-машина из 9 шагов, ~8-9 вызовов LLM на эпизод
+3. **Хранение** — SQLite (SQLModel) + ChromaDB (векторный поиск)
+4. **API + фронтенд** — FastAPI + React дашборд
+
+## Ядро экстракции: 9 шагов графа
+
+1. `initialize_state` — читает тексты серий с диска
+2. `identify_present_season_arcs_batch` — **запрос в БД** за известными арками + LLM
+3. `extract_anthology_arcs_strict` — LLM: антологические линии
+4. `extract_soap_and_genre_arcs` — LLM: отношения + жанровые линии
+5. `optimize_arcs_with_season_context` — LLM: оптимизация в контексте сезона
+6. `deduplicate_arcs` — LLM: дедупликация
+7. `enhance_arcs_batch` — LLM: обогащение персонажами
+8. `verify_arcs_batch` — LLM: верификация прогрессий и персонажей
+9. `final_verify_arcs` — LLM: финальная проверка
+
+Вход: тексты серий + список персонажей + ранее найденные арки
+Выход: `List[IntermediateNarrativeArc]` — структурированные сюжетные линии
+
+## Связанность с другими слоями
+
+| Слой | Связанность | Комментарий |
+|---|---|---|
+| БД (SQLite) | **Высокая** | Шаг 2 графа лезет в БД за предыдущими арками — главный блокер |
+| Файловая система | Средняя | 4 файла читаются в `initialize_state`, 1 пишется на выходе |
+| Конфигурация | Средняя | `os.getenv()` разбросан по коду, нет центрального конфига |
+| API (FastAPI) | **Ноль** | Полностью независимы |
+| Фронтенд (React) | **Ноль** | Полностью независимы |
+
+## Что нужно для чистого `extract_arcs()`
+
+### 1. Убрать запрос в БД из графа (~30 строк)
+Шаг 2 (`identify_present_season_arcs_batch`) открывает сессию SQLite.
+Решение: принимать `known_arcs: list[dict]` как параметр. Пустой список при первом запуске.
+
+### 2. Заменить файловый I/O на передачу в память
+`initialize_state` читает 4 файла. Вместо `file_paths` → аргументы `episode_plot: str`, `season_plot: str` и т.д.
+Механическая работа.
+
+### 3. Объединить EN и RU дубликаты
+Два графа — полная копипаста (~600 строк каждый), отличаются только промптами.
+Решение: один граф + `language` параметр + селектор промптов.
+
+### 4. Убрать запись файла на выходе (2 строки)
+Возвращать список вместо записи в файл.
+
+## Целевой интерфейс
+
+```python
+from mas4bw import extract_arcs
+
+arcs = extract_arcs(
+    episodes=["текст серии 1", "текст серии 2", ...],
+    language="ru",
+    genre="drama",
+    known_arcs=[],  # пусто при первом запуске
+    llm_provider="anthropic",  # или "openai"
+)
+
+for arc in arcs:
+    print(arc.title)        # "Мередит и Дерек"
+    print(arc.type)          # "soap"
+    print(arc.characters)    # ["Мередит", "Дерек"]
+    print(arc.episodes)      # [1, 3, 5, 7, 8]
+```
+
+## Зависимости пакета
+
+**Обязательные:** langgraph, langchain-core, langchain-openai/langchain-anthropic, pydantic
+**Опциональные (предобработка):** spacy, natasha (русский NLP)
+
+## Оценка сроков
+
+| Объём | Срок |
+|---|---|
+| Чистый `extract_arcs()` — ядро без файлов и БД | 2–4 дня |
+| + NLP предобработка (spaCy, Natasha) | +1–2 недели |
+| + тесты, документация, публикация на PyPI | 3–4 недели всего |
+
+## Ключевые файлы
+
+- `src/langgraph_narrative_arcs_extraction/narrative_arc_graph_optimized.py` — EN граф
+- `src/langgraph_narrative_arcs_extraction/ru_narrative_arc_graph_optimized.py` — RU граф
+- `src/narrative_storage_management/prompts.py` — все промпты
+- `main_synopsis.py` — уже упрощённый пайплайн, ближе всего к целевому интерфейсу
+
+## Вывод
+
+Реалистично. `main_synopsis.py` — уже 70% нужного интерфейса. Главная работа — вынести БД из графа и объединить языковые дубликаты. Прагматичный путь: начать с версии без предобработки (пользователь подаёт чистые синопсисы), NLP-пайплайн добавить позже как опцию.
diff --git a/docs/knowledge/specs/rank-refactor-spec.md b/docs/knowledge/specs/rank-refactor-spec.md
new file mode 100644
index 0000000..6be7042
--- /dev/null
+++ b/docs/knowledge/specs/rank-refactor-spec.md
@@ -0,0 +1,102 @@
+---
+type: spec
+project: tvplotlines
+status: archived
+---
+
+# How plotline rank works
+
+## The problem with rank today
+
+A plotline's ABC rank — how central it is to the season — gets decided three times by three different mechanisms. The LLM assigns it during Pass 1 based on its reading of the synopses. Then code in post-processing may auto-demote an A-rank plotline if it appears in too few episodes. Then Pass 3 may promote or demote it again through structural review.
+
+Each mechanism overrides the previous one. The user never sees the disagreement — only the final number, with no trace of who changed it or why.
+
+This becomes a real problem with ensemble shows. When a season has seven or more plotlines, the LLM's initial ranking is a guess — it hasn't seen the events yet, only the synopses. After Pass 2 assigns events to plotlines, we have actual data: how many events each plotline drives, how many episodes it spans. That data should inform the rank, not be ignored.
+
+## Two ranks instead of one
+
+Split rank into two fields:
+
+- **computed_rank** — code calculates this after Pass 2 from event counts. Objective, reproducible, based on data.
+- **reviewed_rank** — Pass 3 sets this through PROMOTE/DEMOTE only when it disagrees with the computed rank. Null when Pass 3 agrees or has nothing to say.
+
+When `reviewed_rank` is null, the user sees `computed_rank`. When both are present, the user sees both — and the disagreement itself tells a story.
+
+In Mad Men, the formula gives Pete Campbell rank B (34 events — second most in the season). The LLM gives him C. Don's marriage gets the opposite treatment: C by events, B by the LLM. A producer looking at both numbers learns something neither says alone: Pete dominates screen time, but Don's marriage dominates the show's identity. That tension is worth seeing.
+
+Full experiment results: `docs/experiments/counting-events-for-ABC-rank.md`.
+
+## How computed_rank works
+
+### Counting events
+
+For each plotline, count the events where it is the primary plotline (`event.plotline_id`). Events that mention the plotline in `also_affects` are not counted.
+
+`also_affects` means "this event touches the plotline" — not "this event belongs to the plotline." A runner mentioned in fifteen `also_affects` lists is not a B-plotline. It is background presence, and counting it equally would inflate plotlines that influence many scenes without driving any of them.
+
+The optimal weight for `also_affects` (zero, half, or full) is still an open question — the current choice is conservative. Pass 3 receives both counts and can correct with PROMOTE if the `also_affects` pattern suggests a higher rank.
+
+### Assigning ABC
+
+1. Runners (`type = "runner"`) get no rank.
+2. In procedural format, the case-of-the-week plotline gets A — it is what the show is about, regardless of how many events other plotlines have.
+3. In hybrid format, the case-of-the-week gets B — the character arc matters more, even when the case generates more events (Douglas: "A-story = the most resonant story, not necessarily the largest proportion of pages").
+4. The remaining plotlines are sorted by descending primary event count. First gets the highest available rank, second gets the next, third and beyond get C.
+
+Example for a hybrid show with five plotlines:
+
+- Case of the week → B (fixed)
+- Runner → null (fixed)
+- Most events → A
+- Next → B (second B is fine)
+- Next → C
+
+### Safety net
+
+After computing ranks, one check remains: if an A-rank plotline appears in fewer than 25% of episodes, demote it to B. A plotline concentrated in three episodes out of thirteen is not the season's spine, no matter how many events it packs in.
+
+## What changes
+
+### Model
+
+`Plotline.rank` becomes two fields: `computed_rank` and `reviewed_rank`. A property `rank` returns `reviewed_rank or computed_rank` — existing code that reads `rank` keeps working.
+
+The JSON output includes all three: `rank` (the effective value), `computed_rank`, and `reviewed_rank`.
+
+### Pass 1
+
+The prompt no longer asks the LLM to assign rank. The rank section, rank validation rules, rank in the JSON example, and rank assignment rules all come out. The LLM focuses on what it does well: identifying plotlines, cast, and Story DNA. Rank is data-driven — it belongs after the data exists.
+
+### Pass 2
+
+RERANK patches are removed. During Pass 2, the LLM doesn't know the final ranks — it hasn't finished assigning events yet. Asking it to flag rank problems at this stage produces noise.
+
+### Post-processing
+
+A new function `compute_ranks` runs after orphan assignment and span computation. It counts primary events, applies the rules above, and writes `computed_rank`.
+
+The existing `validate_ranks` keeps the span-based demotion and dominance checks as diagnostics for Pass 3.
+
+Pipeline order:
+1. `assign_orphan_events()`
+2. `compute_span()`
+3. `compute_ranks()`
+4. `validate_ranks()`
+5. Pass 3
+
+### Pass 3
+
+PROMOTE and DEMOTE verdicts write to `reviewed_rank` instead of mutating `computed_rank`. The prompt explains: "Code computed rank from event frequency. If narrative resonance tells a different story — a plotline that defines the show despite fewer events, or one that dominates events without defining the show — propose a different rank through PROMOTE or DEMOTE."
+
+Pass 3 receives both primary and `also_affects` event counts for each plotline, so it can make informed decisions.
+
+The non-ensemble A-rank block checks the effective rank (`reviewed_rank if set, else computed_rank`).
+
+### CLI
+
+`--stop-after pass1` saves an intermediate JSON without rank — rank doesn't exist yet at that stage. `--resume-from` accepts plotlines without rank — it will be computed after Pass 2.
+
+### Tests
+
+Pass 1 validation tests, verdict tests, and post-processing tests will need updates. The test plan will be detailed during implementation.
diff --git a/docs/knowledge/specs/synopsis-authoring-protocol.md b/docs/knowledge/specs/synopsis-authoring-protocol.md
new file mode 100644
index 0000000..407311e
--- /dev/null
+++ b/docs/knowledge/specs/synopsis-authoring-protocol.md
@@ -0,0 +1,65 @@
+---
+type: spec
+project: tvplotlines
+status: active
+---
+
+# Synopsis Authoring Protocol
+
+Протокол написания синопсисов эпизодов для пайплайна tvplotlines.
+
+## Задача
+
+Напиши prose outline эпизода — пересказ ключевых событий в хронологическом порядке. Результат должен быть достаточным для восстановления Story DNA каждой сюжетной линии (hero, goal, obstacle, stakes) и распределения событий по линиям.
+
+## Правила
+
+1. **Каждое предложение = beat** — событие, меняющее ситуацию. Если в предложении нет конфликта или изменения — оно не нужно.
+2. **Действия и решения, не атмосфера.** Пиши что персонаж сделал и почему, а не как выглядела сцена.
+3. **Персонажи по имени.** При первом появлении — полное имя + роль/отношение. Далее по имени.
+4. **Каузальность явная.** Каждое событие должно следовать из предыдущего. Не «случайно», а «потому что».
+5. **Все линии покрыты.** A, B, C и runners. Даже если B-story занимает одно предложение — она упомянута.
+6. **Конфликт обязателен.** Если ты не можешь сформулировать конфликт в сцене — эта сцена не нужна в синопсисе.
+7. **Минимум 3 нарративных нити на эпизод.** Кейс/A-story + минимум две personal/serialized арки. В процедуралах недостаточно описать только кейс — каждый эпизод содержит развитие персональных линий основного каста (конфликты в отношениях, карьерные решения, внутренние кризисы). Если в эпизоде нет явных B/C-линий — укажи это явно.
+8. **Serialized контент ≥ 30% текста.** Синопсис, где 100% — кейс недели, бесполезен для извлечения сюжетных линий. Пайплайн не может извлечь то, чего нет в тексте.
+9. **Фактическая точность обязательна.** Синопсис должен быть основан на реальном содержании эпизода, верифицированном по нескольким источникам. LLM-галлюцинации (выдуманные пациенты, несуществующие сцены) полностью обесценивают результат.
+
+## Формат
+
+- Сплошной текст, абзацы по сценам/локациям
+- **300–500 слов** на эпизод (увеличено для покрытия serialized арок)
+- **8–15 beats** на эпизод
+- Язык оригинала шоу
+- Без подзаголовков, без bullet points
+- Без авторских оценок и отсылок к будущим эпизодам
+- Хронологический порядок внутри эпизода; флэшбеки указывать явно
+
+## Что включать
+
+- Действия персонажей и их последствия
+- Решения и мотивацию (если ясна из контекста)
+- Конфликты и их исходы
+- Ключевые реплики — только если они меняют ситуацию
+- Появление новых персонажей с минимальным контекстом
+
+## Что НЕ включать
+
+- Визуальный стиль, музыку, режиссуру, монтаж
+- Интерпретации, символизм, авторские оценки
+- Слово "Meanwhile"
+- Спойлеры из будущих эпизодов
+- Пересказ событий прошлых эпизодов (только если персонаж в этом эпизоде о них узнаёт)
+
+## Количество beats по типу шоу
+
+| Тип | A-story | B-story | C / runner |
+|---|---|---|---|
+| Procedural | 5–8 | 2–4 | 1–2 |
+| Serial | 4–6 | 3–5 | 1–3 |
+| Ensemble | 2–4 per line | 2–4 per line | 1–2 per line |
+
+## Авторство
+
+Синопсисы написаны авторами проекта на основе общедоступного содержания эпизодов. Это derivative work — пересказ своими словами, не копия внешних источников.
+
+Для статьи: "Episode synopses were authored by the researchers based on publicly available episode content, following a standardized protocol to ensure consistent granularity across different franchise types."
diff --git a/docs/knowledge/specs/two-function-dimensions.md b/docs/knowledge/specs/two-function-dimensions.md
new file mode 100644
index 0000000..28395ed
--- /dev/null
+++ b/docs/knowledge/specs/two-function-dimensions.md
@@ -0,0 +1,35 @@
+---
+type: concept
+project: tvplotlines
+status: active
+---
+
+# Two dimensions of event function
+
+## Idea
+
+Each event has two independent roles:
+
+1. **Episode function** — its role in the episode's dramatic structure (where in the episode's story does this event land?)
+2. **Arc function** — its role in the season-long plotline arc (where in the plotline's season journey does this event land?)
+
+These are orthogonal. A climax of episode 3 can be an escalation in the season arc. Currently we have one `function` field that conflates both.
+
+## How it would work
+
+**Pass 2** assigns episode function. It sees one episode — it can only judge the role within that episode. Candidate framework: Dan Harmon's story circle (8 steps) or a simplified version.
+
+**Pass 3** assigns arc function. It sees the whole season — it can judge where each event falls in the plotline's season-long trajectory. This uses our current 7 functions: setup → inciting_incident → escalation → turning_point → crisis → climax → resolution.
+
+## What it gives us
+
+- Pass 2 stops guessing about the season arc (it can't see it)
+- Pass 3 gets a clearer task: not "review" but "assign arc functions"
+- Two dimensions give richer analysis: episode structure vs season structure
+- Enables fractal analysis (same structure at episode and season levels, as Oberg describes)
+
+## Open questions
+
+- Dan Harmon's circle is 8 steps for one hero. How to handle multiple plotlines per episode?
+- Do we need all 8 Harmon steps or can we simplify?
+- How does this change the data model? Two fields instead of one? Or two separate passes?
diff --git a/docs/knowledge/specs/what-each-pass-does.md b/docs/knowledge/specs/what-each-pass-does.md
new file mode 100644
index 0000000..86e2b68
--- /dev/null
+++ b/docs/knowledge/specs/what-each-pass-does.md
@@ -0,0 +1,15 @@
+---
+type: note
+project: tvplotlines-app
+status: active
+---
+
+**Вход**: синопсисы серий — сезона или сериала.
+
+**Pass 0 — Настройка**. Задача: определить тип сериала — процедурный, сериальный, ансамблевый, один протагонист или несколько. Результат: профиль сериала, от которого зависит, какие линии вообще возможны. Запускается один раз.
+
+**Pass 1 — Сюжетные линии** Задача: прочитать все синопсисы и найти 5–6 сюжетных линий. По подробной инструкции — что считается линией, а что нет. Запускается трижды, после чего выбирается консенсусный набор. Что три прогона лучше одного — выяснилось само. Я написала инструкцию для автоматических экспериментов (Эндрю Нг на днях поделился), запустила Claude и ушла. Он сам провёл 34 эксперимента — менял параметры, измерял точность, решал что попробовать дальше — и остановился, когда улучшения закончились. И так появился этот трехкратный прогон на этом этапе. Зато, что круто - написал что промт так сконфигурирован что любое изменение - ухудашет метрику (consistency + coverage)
+
+**Pass 2 — События по линиям** Задача: прочитать каждую серию отдельно и раскидать её события по линиям из Pass 1. Запускается один раз на каждую серию, все серии параллельно (10 серий = 10 вызовов одновременно). Результат: для каждой серии — список событий, каждое привязано к своей сюжетной линии. После этого код считает вес каждой линии в каждой серии — сколько событий ей досталось — и определяет какая A, B или C.
+
+**Pass 3 — Ревизия** Задача: впервые увидеть полную картину — все линии, все события всех серий, все веса — и проверить целостность. Нет ли дублирующихся линий? Правильно ли расставлены ранги? Есть ли у каждой линии арка (завязка → развитие → кульминация)? Не остались ли события-сироты? Результат: вердикты — объединить, переназначить, повысить, понизить — которые применяются автоматически. Запускается один раз.
diff --git a/docs/knowledge/theory/enculturation-core-idea.md b/docs/knowledge/theory/enculturation-core-idea.md
new file mode 100644
index 0000000..51a2701
--- /dev/null
+++ b/docs/knowledge/theory/enculturation-core-idea.md
@@ -0,0 +1,25 @@
+---
+type: concept
+project: tvplotlines
+status: active
+---
+
+# Enculturation-аргумент tvplotlines: центральная идея
+
+LLM уже несёт в себе нарративные нормы из обучающих данных — паттерны сюжетной структуры, представления о «правильном» развитии истории, типичные арки персонажей. Промты tvplotlines не учат модель этим вещам с нуля. Они **активируют и направляют** уже усвоенные паттерны, задавая систему координат (Story DNA, franchise types, event functions), через которую модель структурирует своё понимание.
+
+## Откуда это следует
+
+- **Frazier et al. (2019):** модель, обученная на детском комиксе, переносит нормы на Star Wars без дообучения. Нарративные нормы усваиваются из историй и переносятся.
+- **Jung et al. (2026):** LLM «от природы» предпочитают стиль сюжету (на 67% чаще). У модели уже есть нарративные предпочтения до всяких промтов — промты их перенаправляют.
+- **AlKhamissi et al. (2024):** язык промта активирует культурно-специфичные «подсети» знаний. Промт — переключатель, не учебник.
+- **Winston (2011, 2017):** культура системы = набор правил вывода и концептуальных паттернов. Enculturation = передача этого набора.
+- **Piper & Bagga (2024):** теория → словарь понятий → промт → результат. Промт операционализирует теорию, давая модели vocabulary для структурирования того, что она уже знает.
+- **Liu et al. (2026):** LLM как «нарративный артефакт» — хранилище нарративных паттернов человечества.
+
+## Следствия для промтов tvplotlines
+
+1. Промты — не инструкции для неучёного работника. Это **система координат для эксперта**, который уже знает предмет, но которому нужно сказать, в какой рамке работать.
+2. Разные промты = разные «культуры анализа» = разные результаты из того же текста (Winston: Dr. Jekyll / Mr. Hyde).
+3. Язык промта имеет значение: русский и английский промты могут активировать разные нарративные паттерны (AlKhamissi).
+4. Модель имеет собственные предпочтения (style bias по Jung) — промты должны это компенсировать.
diff --git a/docs/knowledge/theory/glossary.md b/docs/knowledge/theory/glossary.md
new file mode 100644
index 0000000..5b88433
--- /dev/null
+++ b/docs/knowledge/theory/glossary.md
@@ -0,0 +1,238 @@
+---
+type: draft
+project: tvplotlines
+status: active
+---
+
+# Glossary
+
+Terms in dependency order — each term is defined before it is used.
+
+---
+
+## 1. Story DNA
+
+Shorthand for four components every plotline must have: **hero** + **goal** + **obstacle** + **stakes**. Term from Nash *Save the Cat! Writes for TV*. Used throughout as a completeness test.
+
+- **hero** — main cast member whose decisions drive this plotline. Must be from the recurring cast, not a guest. Each plotline has its own hero — not necessarily the series protagonist.
+- **goal** — what the hero wants. Tangible, trackable — the audience can tell whether the hero is winning or losing. "Build a drug empire." "Find the meth cook." Can be forward-looking ("will they survive?" = Central Question) or backward-looking ("who killed Danny?" = Central Mystery). Formulate through a verb (investigate, survive, escape, discover).
+- **obstacle** — what specifically blocks the hero. Another person? A circumstance? An internal fear?
+- **stakes** — what happens if the hero fails. "Gets caught." "Family falls apart." "Dies."
+
+---
+
+## 2. Plotline
+
+A story with complete Story DNA (hero + goal + obstacle + stakes). Missing any component = not a plotline, just an event inside another plotline. Exception: runner — a minor recurring thread tracked as plotline but without full conflict structure (no obstacle or resolution).
+
+A plotline has a three-act structure (beginning, middle, end), conflict, and a causal chain of events.
+
+TV episodes typically feature two or more parallel plotlines, denoted by letters A, B, C: a main A plot that dominates screen time and secondary B plots that may offer thematic parallels or counterpoint. Three stories per episode are typical, though some shows have more — in ensemble shows it's not unheard of to have 4 or 5 concurrent plotlines. Each story is usually driven by one character in the main cast.
+
+Granularity: the key is GOAL, not character. One character can drive multiple plotlines with different goals. One plotline = one hero + one goal + causal connection between events. Different plotlines = different heroes, OR same hero with different goals, OR no causal connection.
+
+Test: can you write a logline (hero + goal + obstacle + stakes)? Yes = plotline. No = not a plotline.
+
+Not a plotline:
+- "John has lunch" — background, no goal/conflict
+- "Everyone goes to a party" — setting, no hero/stakes
+- "John is sad" — state, no goal/obstacle
+- "John and Mike's friendship" — context, no conflict
+- "The investigation" (procedural, ep.5) — franchise engine, part of the case_of_the_week plotline
+
+Seed and wraparound are not plotline types — seed is an event function (see function below), wraparound is a narrative device.
+
+When in doubt — do NOT create a plotline.
+
+Examples — NYPD Blue (hybrid, A = character-led, B = case):
+- A "Sipowicz: Partnership" — wants to accept new partner, but jealousy and distrust, stakes: career
+- B "Simone: Murder Case" — wants to solve murder, but clues don't add up, stakes: justice
+- C "Lesniak: Abusive Ex" — wants to get free of ex, but he won't let go, stakes: safety
+
+Examples — Breaking Bad (serial, one character = two plotlines with different goals):
+- A "Walt: Empire" — wants to build drug empire, but law enforcement and rivals, stakes: death
+- B "Walt: Family" — wants to provide for family, but Skyler discovers the truth, stakes: family falls apart
+
+## 3. Format (Pass 0)
+
+### format
+Determines what plotlines to expect in pass1: how many, what types, whether they close per episode.
+Tech insight: understanding the problem before extraction improves accuracy (Wang 2023, Plan-and-Solve: "first understand the problem and devise a plan, then carry out the plan").
+Cognitive science insight: format tells the LLM what to look for — like a genre label on a book cover switches how we read it (Zwaan 1993).
+
+- **procedural** — each episode contains a self-contained story (case, patient, mission) that opens and closes within the episode. Character plotlines exist but stay in the background. CSI, House, Law & Order.
+- **hybrid** — each episode has a case-of-the-week AND serialized plotlines that carry across episodes and actively intertwine with the case. Both matter. X-Files, Buffy, Good Wife, Grey's.
+- **serial** — episodes continue each other. Conflicts don't close within an episode. No case-of-the-week. Breaking Bad, The Wire, Sopranos.
+- **limited** — same as serial, but the story is designed to end this season. All plotlines must resolve by the end of season. Chernobyl, Queen's Gambit.
+
+Diagnostic: if E01 and E02 have different cases — procedural or hybrid. If E02 continues E01's conflict without closing it — serial.
+
+Expected plotline count by format:
+- procedural: 2–3 (1 case_of_the_week + 1–2 serialized)
+- hybrid: 3–6
+- serial: 3–8
+- ensemble: 4–6
+
+### is_ensemble
+No single protagonist. Multiple characters drive their own plotlines with roughly equal screen time. Diagnostic: can you name THE main character? If not — ensemble. This matters because ensemble shows have 2+ A-rank plotlines instead of one. Game of Thrones, This Is Us, Succession, The Crown.
+
+### is_anthology
+Are seasons or episodes independent — new cast, new story, no continuity? Yes = anthology. This matters because anthology seasons have no continuity — prior season data is not passed to the next step. True Detective, Fargo, Black Mirror.
+
+### story_engine
+The show's repeating dramatic mechanism in one sentence. Focus on the verbs — what are characters doing each week? (Landau: "Verbs express characters' episodic goals in the form of micro missions.")
+
+Templates by format:
+- **procedural:** "Every week [profession] [verb] [type of challenge], testing [hero's quality]." Example: "Every week a diagnostician solves a medical mystery, testing the limits of ethics" (House).
+- **hybrid:** "Every week [profession] [verb] [case] while [ongoing character plotline]." Example: "Every week lawyers litigate a new case while navigating political power games" (Good Wife).
+- **serial:** "[Hero] [transformation], testing how far they'll go for [goal]." Example: "A chemistry teacher builds a drug empire, testing how far he'll go for family and control" (Breaking Bad).
+- **limited:** "[Characters] [verb] [one problem] over one season." Example: "Nuclear engineers and officials investigate a reactor explosion, testing how far the state will go to cover it up" (Chernobyl).
+
+### genre
+Free text. Not validated, not used downstream.
+
+---
+
+## 4. Cast (Pass 1)
+
+### cast member
+- **id** — snake_case: "walt", "jesse"
+- **name** — full: "Walter White"
+- **aliases** — synopsis variants: ["Walt", "Heisenberg"]
+
+---
+
+## 5. Plotline Fields (Pass 1)
+
+### plotline fields
+- **id** — snake_case, stable (doesn't change if plotline is renamed): "empire", "murder_case", "family_tension"
+- **name** — "Hero: Theme": "Walt: Empire". Named by GOAL, not by event.
+- **hero** — see Story DNA above.
+- **goal** — see Story DNA above. case_of_the_week plotline has a template Story DNA — repeating goal/obstacle/stakes, specific content filled in per episode by pass2.
+- **obstacle** — see Story DNA above.
+- **stakes** — see Story DNA above.
+
+### type
+How long does this plotline last?
+- **case_of_the_week** — opens and closes within one episode. New each episode. The patient in House, the murder in CSI. Always named "Case of the Week" regardless of the show — the specific case content changes per episode, but the plotline is one recurring slot.
+- **serialized** — spans multiple episodes, conflicts carry over. Walt's empire, Alicia's career.
+- **runner** — minor recurring thread, 3-5 beats per episode, no complete set of functions. Incomplete Story DNA (no obstacle or resolution). Ted's shortbread, office romance.
+
+### rank
+Typical importance of this plotline across the season. Rank = resonance, not event count. A = "the largest or most resonant story", not necessarily most screen time. Rank is assigned once per season in pass1. Within individual episodes, a plotline's actual presence may differ — a B-plotline can dominate a specific episode (Oberg: "The A-Story over one episode can become a B-story in the next episode"). Per-episode presence is captured by weight (see postprocess below).
+- **A** — the plotline the series is ABOUT. Gets all or most of 7 functions across the season. In procedural: case_of_the_week = A. In hybrid: character plotline = A, case = B. For example, NYPD Blue — character relationship = A, murder case = B, even though case has more scenes.
+- **B** — second most important. Has its own complete Story DNA. Often carries the episode's theme.
+- **C** — third. Lighter in tone, less screen time. Can be comic relief or a seed for future plotlines.
+
+Plotlines with type=runner have rank=null — they are by definition minor threads that don't participate in A/B/C ranking.
+
+### nature
+Where does the main problem come from? Nature sets expectations for Story DNA validation: plot-led plotline should have an external obstacle, character-led should show internal conflict, theme-led should have a systemic problem without a single antagonist. Nature of a plotline and nature of individual events can differ — plot-led action serving a character-led plotline is normal (Oberg: "each episode tends to be plot-led, even if the series is character-led").
+- **plot-led** — from outside the hero. Antagonist, monster, crime. Stranger Things, CSI.
+- **character-led** — from inside the hero. The hero IS the problem. Breaking Bad, Fleabag.
+- **theme-led** — from society. Systemic, no single solution. The Wire, Succession.
+
+### confidence
+How complete is the conflict structure?
+- **solid** — hero, goal, obstacle, stakes all clear. You can write a logline with conflict.
+- **partial** — hero and goal clear, obstacle or stakes unclear.
+- **inferred** — plotline implied, conflict structure incomplete.
+
+Confidence is used downstream:
+- postprocess: arc_completeness thresholds are lower for inferred/partial plotlines (inferred with 3/7 = expected, solid with 3/7 = flag)
+- pass3: inferred plotline with few events = candidate for DROP
+- app: visual distinction (e.g. dashed line for inferred, solid for solid)
+
+### prior season plotline status
+When analyzing a new season with prior season data, each prior plotline is classified. Process prior plotlines BEFORE looking for new ones.
+- **CONTINUES** — same hero, same goal, new circumstances. Keep ID, update obstacle/stakes. Example: "Walt: Empire" S1→S2 — still building the empire, but now Gus is the obstacle instead of Tuco.
+- **TRANSFORMED** — same hero, different goal. Keep ID, rewrite goal/obstacle/stakes. Example: "Walt: Empire" S4→S5 — no longer building, now hiding from consequences.
+- **ENDED** — plotline is gone. Do not include.
+
+---
+
+## 6. Events (Pass 2)
+
+### event
+One action that changes the situation. If nothing changes — not an event. Two actions where the second is an immediate consequence of the first = one event.
+- **event** — one sentence: "Walt kills Krazy-8."
+- **plotline** — which plotline (ID), or null
+- **function** — position in the episode structure: where this event sits in THIS episode (see function below). The same event may have a different position in the plotline's season-long sequence of functions — that is computed in postprocess, not assigned by LLM.
+- **characters** — who is involved (cast IDs, guests: `guest:name`)
+- **also_affects** — other plotlines secondarily affected by this event. One event touches two plotlines → assign to primary goal, note the secondary in also_affects. "Walt kills Krazy-8" = empire, also_affects: investigation.
+
+### function
+Where in the episode structure does this event sit? The same 7 functions apply at two levels (Oberg: "the same dramatic three-act structure applies at every level: scene, sequence, subplot, storyline, episode, season"):
+- **Episode level** — LLM assigns in pass2. "Walt kills Krazy-8" = climax of this episode.
+- **Plotline level** — code computes in postprocess by collecting all events of a plotline across the season. The same event may be episode climax but plotline escalation (early in the season, far from the season climax).
+
+Seven functions, in order:
+- **setup** — world before anything happens. Status quo. Can repeat (setup for different plotlines).
+- **inciting_incident** — the event that starts the plotline. Without it, the plotline doesn't exist. One per plotline, does not repeat. "Walt is diagnosed with cancer."
+- **escalation** — stakes rise, situation complicates. Can repeat — multiple escalations in a row is normal (Nash: Fun & Games). Escalation AFTER turning_point is OK (Bad Guys Close In comes after Midpoint).
+- **turning_point** — direction reverses. Winning turns to losing or vice versa. One major turn per plotline.
+- **crisis** — lowest point. Hero faces what they feared most. True dilemma, no good options. Must come AFTER turning_point, never before.
+- **climax** — peak confrontation. Outcome is irreversible. Must come AFTER crisis. Does not repeat.
+- **resolution** — aftermath. World after the climax. Optional — some plotlines end on climax (especially in ongoing format). In limited format, all plotlines must have resolution.
+
+Order rules:
+- Strict sequence of milestones: inciting_incident → turning_point → crisis → climax. No going back past a milestone.
+- escalation can appear between any milestones (before turning_point, after turning_point, even after crisis — as long as climax hasn't happened).
+- setup can only appear before inciting_incident.
+- resolution can only appear after climax (or be absent).
+- Timing is flexible — milestones don't have to be evenly spaced (Nash: "The beat sheet is an itinerary, not a calendar").
+
+Emotional counterpoint: if all plotlines in an episode are rising or all falling — something is missed or functions are wrong.
+
+### interaction
+How plotlines connect in this episode:
+- **thematic_rhyme** — two plotlines explore the same theme from different angles.
+- **dramatic_irony** — audience knows something a character doesn't, because of another plotline.
+- **convergence** — plotlines collide: characters or conflicts from different plotlines meet.
+
+### patch
+Problem detected during episode analysis. Patches are hints for pass3 — suggestions, not commands. Pass3 decides whether each patch is justified.
+- **ADD_LINE** — event doesn't fit any plotline. New plotline needed?
+- **CHECK_LINE** — plotline has no events this episode. Ended early?
+- **SPLIT_LINE** — plotline covers two unrelated things. Split?
+- **RERANK** — C-plotline has more events than A. Ranks wrong?
+
+---
+
+## 7. Postprocess — Code
+
+### span
+`[episode_id for episode in episodes if plotline has events in episode]`
+
+### weight
+Per plotline per episode — how present this plotline is:
+- `primary` — >= 50% of max event count in this episode
+- `background` — >= 2 events
+- `glimpse` — 1 event
+
+### arc_completeness
+`len(set(e.function for e in plotline_events)) / 7`
+Flag if below minimum: A >= 6/7, B >= 5/7, C >= 3/7, runner >= 1/7.
+
+### convergence_matrix
+Directed count from `also_affects`: how many times plotline A's events affected plotline B. A->B != B->A.
+
+### monotonicity
+Plotline's season-long sequence of functions must not return past a milestone. Milestones: inciting_incident, turning_point, crisis, climax.
+OK: escalation after turning_point. Violation: crisis after climax.
+
+---
+
+## 8. Verdicts (Pass 3)
+
+### notes
+Free text: overall quality assessment of the season's plotline structure. What works, what doesn't.
+
+### verdict actions
+- **MERGE** — two plotlines are really one. Combine.
+- **REASSIGN** — event belongs to a different plotline. Move.
+- **PROMOTE** — plotline is more important than rank says. B -> A.
+- **DEMOTE** — plotline is less important than rank says. A -> B.
+- **CREATE** — orphaned events form a new plotline pass1 missed.
+- **DROP** — plotline has no real conflict. Remove, redistribute events. Only for phantoms — weak but real plotlines should be marked through confidence, not dropped.
+- **REFUNCTION** — event has wrong function. Escalation is actually crisis.
diff --git a/docs/knowledge/theory/naive-vs-plotter.md b/docs/knowledge/theory/naive-vs-plotter.md
new file mode 100644
index 0000000..f7fe615
--- /dev/null
+++ b/docs/knowledge/theory/naive-vs-plotter.md
@@ -0,0 +1,53 @@
+---
+type: note
+project: tvplotlines
+status: active
+---
+
+# Experiment: Naive Prompt vs tvplotlines Pipeline
+
+## Goal
+
+Show that LLM results are non-deterministic, and that tvplotlines's constraints solve this.
+Two claims in one experiment:
+
+1. **Inter-run divergence:** naive prompt produces different plotline structures on repeated runs
+2. **Divergence from ground truth:** naive results disagree with expert annotation; tvplotlines's don't
+
+## Design
+
+**Input:** Breaking Bad Season 1 synopses (from benchmark).
+Breaking Bad chosen because it has the lowest tvplotlines ARI (0.767) — genuine ambiguity in the data. Naive prompt should show even larger spread.
+
+**Naive prompt:**
+
+> "Here are synopses of a TV season. Extract the main plotlines. For each plotline, list which characters are involved and which episodes it spans."
+
+No output format, no definitions (what is a plotline? what is span?), no franchise type, no Story DNA structure.
+
+**Runs:**
+
+| Condition | Runs | Model | Temperature |
+|-----------|------|-------|-------------|
+| Naive prompt | 5 | same as tvplotlines (Haiku) | default |
+| tvplotlines pipeline | 5 | Haiku | default |
+
+**Metrics:**
+
+- **ARI** (Adjusted Rand Index) across runs — measures inter-run consistency
+- **ARI vs ground truth** — measures accuracy against expert annotation
+- **Coverage** — fraction of events assigned to a plotline
+
+## Status
+
+- [ ] Write naive prompt runner script
+- [ ] Run 5x naive
+- [ ] Run 5x tvplotlines
+- [ ] Compute ARI (inter-run + vs ground truth)
+- [ ] Write up results for preprint (Section 1 or Section 3)
+
+## Notes
+
+- Keep naive prompt intentionally simple — this is what a user would type into ChatGPT
+- Use the same model and temperature for fair comparison
+- Results go into the intro as motivation: "here's the problem we solve"
diff --git a/docs/knowledge/theory/narrative-intelligence-theory.md b/docs/knowledge/theory/narrative-intelligence-theory.md
new file mode 100644
index 0000000..102cfcd
--- /dev/null
+++ b/docs/knowledge/theory/narrative-intelligence-theory.md
@@ -0,0 +1,206 @@
+---
+type: concept
+project: tvplotlines
+status: active
+---
+
+# Логика как условия возможности нарративного интеллекта
+
+## Дискуссия 2026-03-18 (русский текст, не редактировать)
+
+---
+
+### Два пути из Витгенштейна
+
+**Из раннего Витгенштейна.** Логика — это условия возможности осмысленного высказывания. Не описание мира, а то, что должно быть на месте, чтобы описание вообще могло состояться. Если перенести это на ИИ: когда мы даём системе эпистемическую логику, мы не учим её конкретным историям. Мы создаём условие, при котором система вообще способна различать "знает" и "не знает". Без этого условия у системы нет suspense, не потому что она не выучила suspense, а потому что у неё нет того, из чего suspense может возникнуть. Мы не скелет пересаживаем — мы создаём условия возможности.
+
+**Из позднего Витгенштейна.** Значение — это употребление. Нет скрытой логической структуры, есть практика. И вот: LLM-ы — это буквально машины позднего Витгенштейна. Они выучили язык через употребление. Миллиарды примеров того, как слова используются в контексте. Никакой формальной модели внутри. И они работают — порождают осмысленный текст, "играют в языковые игры".
+
+**Про направление.** Витгенштейн шёл от раннего к позднему: сначала думал что логическая структура первична, потом понял что практика первична. Мы идём одновременно в обе стороны. LLM-ы пошли по пути позднего Витгенштейна и добились поразительных результатов. Но они ломаются именно там, где нужен ранний: логическая связность, каузальная когерентность, отслеживание кто что знает. Они выучили практику, но у них нет условий возможности.
+
+И вопрос, который сейчас стоит перед полем: можно ли соединить оба. Дать машине, которая уже освоила практику, ещё и условия возможности — не убив при этом то, что делает её хорошей.
+
+---
+
+### Нарративные эффекты как эмерджентные свойства
+
+Suspense — это не вещь. Это эффект, который возникает когда выполнены определённые условия. Какие: зритель знает что-то, чего не знает персонаж. Есть угроза. Персонаж движется к ней, не подозревая. Suspense живёт в зазоре между двумя состояниями знания.
+
+LLM может написать текст, который выглядит как suspense, потому что видела тысячи примеров. Но она не поддерживает два отдельных состояния знания. У неё нет зазора. Она имитирует поверхность явления, у которого нет внутренней структуры в её модели.
+
+И это обобщается на все нарративные эффекты:
+
+- **Dramatic irony** — возникает из зазора: зритель знает, персонаж нет. Без двух раздельных состояний знания — невозможна.
+- **Предательство** — возникает из того, что раньше было доверие. Без памяти о предыдущем состоянии отношений — нет предательства, есть просто плохой поступок.
+- **Моральная дилемма** — возникает из того, что два обязательства несовместимы. Без способности представить два обязательства одновременно — нет дилеммы.
+- **Неожиданность** — возникает из нарушения ожидания. Без модели ожидания — нет неожиданности.
+- **Ненадёжный нарратор** — возникает из расхождения утверждений нарратора с фактами. Без способности удерживать и то и другое — просто шум.
+
+Каждый нарративный эффект — это не объект, который можно выучить. Это эмерджентное свойство определённой конфигурации условий. Логика описывает эти условия. Без условий — эффект невоспроизводим, только имитируем.
+
+Проверяемое утверждение: когда LLM генерирует "suspense", она действительно отслеживает кто что знает на протяжении текста? Или она просто порождает текст, который статистически похож на suspense-фрагменты из обучающих данных? Если второе — она имитирует, а не порождает.
+
+---
+
+### Промпты как неформальные условия возможности
+
+"Без этого условия у системы нет suspense, не потому что она не выучила suspense, а потому что у неё нет того, из чего suspense может возникнуть." — Это же как раз подтверждение того что уже не машинное обучение работает с моделями, а как раз промпты. Как логика, а не как млрд примеров.
+
+Промпт не даёт LLM-у миллиард примеров. Промпт задаёт рамку — "в этом контексте различай X и Y", "отслеживай кто что знает", "выдели причинно-следственные связи". Это ближе к тому, что делает логика (задаёт условия), чем к тому, что делает ML (учится на данных).
+
+LLM уже выучила практику — поздний Витгенштейн, миллиарды примеров употребления. Промпт добавляет ей условия возможности — ранний Витгенштейн. "В рамках этого разговора у тебя есть способность различать знание и незнание." И она начинает это делать — не потому что доучилась, а потому что ей задали структуру.
+
+Chain-of-thought — то же самое. "Давай рассуждай пошагово" — это не пример, это условие. Ты не показываешь ей решение, ты создаёшь условие при котором решение может возникнуть.
+
+И вот почему это хрупко: промпт — это неформальное условие возможности. Оно на естественном языке, оно зависит от формулировки, оно может не сработать если переформулировать. Формальная логика — это то же самое, но надёжно. Промпт говорит "отслеживай кто что знает". Эпистемическая логика говорит "для каждого агента a и пропозиции p определено значение K_a(p)". Второе не ломается от перефразирования.
+
+Может быть весь промпт-инжиниринг — это попытка на естественном языке делать то, что логика делает формально: создавать условия возможности для мышления.
+
+---
+
+### Чомски: нельзя научиться тем же способом
+
+Она уже говорит на нашем языке. Но нам нужно научить её чему-то, чему нельзя научиться тем способом, которым она научилась говорить.
+
+Чомски всю жизнь говорит одну вещь: язык нельзя выучить только из данных. Ребёнок слышит ограниченный, шумный, неполный ввод — и из этого порождает бесконечное количество правильных предложений, которых никогда не слышал. Значит внутри уже есть что-то — врождённая структура, универсальная грамматика. Условие возможности, без которого никакой объём данных не поможет.
+
+И вот LLM-ы — это буквально эксперимент, который Чомски считал невозможным. Им дали чудовищный объём данных, и они заговорили. Без врождённой структуры. На чистой статистике. Чомски до сих пор говорит что это не настоящее понимание языка, а имитация.
+
+И интересно что оба правы. LLM-ы действительно говорят — performance в терминах Чомски. Но у них нет competence — глубинного понимания структуры. Они порождают правильные предложения, но не могут гарантировать логическую связность на длинной дистанции. Именно то, за что отвечает глубинная структура.
+
+И промпт — это попытка дать ей эту структуру на её же языке. Как если бы ты объясняла грамматику человеку, который уже бегло говорит, но никогда не учил правил.
+
+---
+
+### Competence и Performance — термины Чомски
+
+Competence и performance — центральное различение в генеративной лингвистике Чомски с 1965 года (Aspects of the Theory of Syntax).
+
+**Performance** — то, что говорящий реально порождает. Конкретные высказывания, с ошибками, запинками, незаконченными предложениями. LLM-ы — это машины performance.
+
+**Competence** — внутреннее знание правил, которое позволяет отличить правильное от неправильного, возможное от невозможного. Даже если ты никогда не слышал конкретное предложение — ты знаешь, грамматично оно или нет.
+
+Когда мы через промпт или через формальную логику даём LLM-у эпистемическую структуру — мы даём ей competence. Не ещё один пример suspense, а правило: suspense возникает когда K_зритель(p) ∧ ¬K_персонаж(p). Теперь система не имитирует suspense из примеров, а может проверить — есть ли условия для suspense в данной сцене.
+
+Логика — это competence для нарративного интеллекта. Мы объясняем правила, по которым создаются напряжение, конфликт, ирония — а не показываем ещё миллион примеров.
+
+---
+
+### Метафора: арабский парень из Кембриджа
+
+Когда я училась в Англии на языковых курсах, в группе был арабский парень — второй сын третьей жены, отец загнал его в Кембридж потому что нью-йоркская школа пожаловалась что он не учится. Он отлично говорил по-английски, но плохо читал и писал. Я наоборот. Мы были тяни-толкай: он закрывал все вопросы в барах и пабах, а я на уроках.
+
+LLM — это он. Говорит бегло. Но читать и писать не умеет. Выучил язык в пабе.
+
+---
+
+### Щерба: глокая куздра и зеркальный дефицит
+
+Лев Владимирович Щерба (1880–1944) — русский лингвист, ученик Бодуэна де Куртенэ. Знаменит фразой: "Глокая куздра штеко будланула бокра и кудрячит бокрёнка." Искусственное предложение из несуществующих слов. Доказывает что грамматическая структура понимается без семантики. Ты не знаешь что такое "куздра", но знаешь что она — субъект, женского рода, что она что-то сделала с "бокром" и продолжает что-то делать с "бокрёнком". Структура без содержания.
+
+Это зеркально к LLM-ам: они порождают содержание (или его имитацию) без гарантированной структуры. Бегло, убедительно, но каузально или логически может быть бессвязно.
+
+Два зеркальных дефицита:
+- Глокая куздра = **структура без значения** (грамматика работает, смысла нет)
+- LLM-suspense = **значение без структуры** (читается гладко, но внутри нет эпистемического зазора)
+
+Щерба также разделял речевую деятельность (то что люди реально говорят), языковую систему (правила) и языковой материал (тексты). Это перекликается с Чомски (performance vs competence), хотя Щерба был раньше и подход другой.
+
+---
+
+### Dramatis (O'Neill & Riedl, 2014): доказательство тезиса
+
+Статья Dramatis — прямое доказательство тезиса "логика как competence". Riedl и O'Neill не учили систему распознавать suspense из примеров. Они формализовали условия, при которых suspense возникает:
+
+1. Протагонист движется к негативному исходу
+2. Читатель пытается мысленно построить "escape plan" — план спасения
+3. Чем сложнее этот план (дороже, менее вероятен) — тем выше suspense
+
+Система читает историю в формате STRIPS-операторов (планировочная логика — preconditions, effects), строит escape plan через планировщик, оценивает его стоимость. Высокая стоимость = высокий suspense. Результаты совпадают с оценками живых читателей на Casino Royale, Rear Window, Harry Potter.
+
+Suspense — не вещь которую выучиваешь, а эмерджентное свойство конфигурации условий. Riedl дал системе competence (формальные условия — каузальные связи, планировочное пространство, модель памяти читателя) — и система смогла измерять suspense без единого примера suspense в обучающих данных.
+
+Но: это 2014, до LLM. Система требует ручной разметки — каждое действие закодировано как STRIPS-оператор человеком. Не умеет читать текст. Чистый competence без performance. Зеркало LLM-ов.
+
+Dramatis — недостающий кусок. LLM читает текст и извлекает события (performance). Dramatis-подобная система оценивает структуру (competence). Вместе — организм.
+
+### Что стало с авторами Dramatis
+
+**Brian O'Neill** — первый автор Dramatis, это была его PhD диссертация (Georgia Tech, 2013, научный руководитель — Riedl). После защиты ушёл в преподавание: заведовал кафедрой CS в Western New England University, с 2023 — в Quinnipiac University. В narrative AI больше не публиковался.
+
+**Mark Riedl** — научный руководитель O'Neill, второй автор. После Dramatis:
+- 2016 — манифест "Computational Narrative Intelligence" (position paper)
+- 2016-2020 — Quixote (RL-агент учится ценностям из историй), explainable AI через нарративы
+- Сейчас — Director of Georgia Tech Machine Learning Center
+- 2024 — вернулся к suspense: **Xie & Riedl, "Creating Suspenseful Stories: Iterative Planning with LLMs"** (EACL 2024). Та же идея (suspense = сужение escape plans), но вместо ручных STRIPS — LLM с итеративным промптингом. Zero-shot, без обучающего корпуса.
+
+**Кто за что отвечал в Dramatis (предположение):**
+
+Dramatis — это PhD O'Neill, значит он построил систему: закодировал MEI-P (модель памяти читателя), реализовал планировщик (модифицированный HSP), провёл эксперименты с людьми, написал краудсорсинг STRIPS-операторов и скриптов. Инженерная часть — его.
+
+Riedl как научрук скорее всего отвечал за теоретическую рамку: связь с психологической моделью Gerrig & Bernardo, переформулирование suspense как planning problem, общая архитектура идеи. Концептуальная часть — его.
+
+Косвенное подтверждение: после разделения O'Neill перестал публиковаться в narrative AI (ушёл инженер), а Riedl продолжил развивать идеи (остался визионер). В 2024 Riedl вернулся к suspense уже с другим соавтором (Xie) и другой реализацией (LLM вместо STRIPS), но с той же теоретической рамкой.
+
+**Xie & Riedl 2024 — что делают:**
+- Задают персонажа с целью + негативный исход
+- LLM генерирует возможные планы спасения
+- Система "атакует" планы, создавая условия провала
+- Suspense растёт по мере сужения пространства escape plans
+- Та же логика что в Dramatis, но performance (LLM) вместо ручной разметки (STRIPS)
+
+tvplotlines идёт в обратном направлении: извлекает структуру ИЗ существующих историй, а не генерирует истории. Но принцип тот же: LLM как performance + формальная структура как competence.
+
+---
+
+### Два поколения narrative AI (объяснение цитаты из Riedl 2016)
+
+Riedl в CNI position paper описывает два поколения подходов:
+
+**Первое поколение (до ~2010):** Люди вручную описывали мир истории в формальных моделях. Хочешь чтобы система понимала шпионские фильмы — садись и описывай: "есть убийца, есть жертва, есть мотив, убийца скрывает улики" и т.д. Всё в формальном языке (STRIPS, планировочные операторы). Dramatis — как раз из этого поколения. Работает, но для каждого нового жанра/домена нужен человек который опишет всё заново. Это и есть "knowledge engineering bottleneck" — бутылочное горлышко: система умна ровно настолько, насколько подробно человек описал домен.
+
+**Второе поколение (после ~2010):** Попытки автоматически извлекать эти модели из данных — из текстов в интернете (корпуса нарративов) или через краудсорсинг (просят людей описывать ситуации). Вместо одного эксперта — тысячи текстов или тысячи людей.
+
+Riedl говорит: первое поколение работало, но не масштабировалось. Второе масштабируется, но теряет формальную точность.
+
+LLM-ы — это третье поколение, которое Riedl в 2016 ещё не видел. Они "выучили" домены из интернета, но неявно, без формальных моделей. И вопрос — как вытащить из них формальные модели обратно. Это то, что Kelly 2023 пытается делать.
+
+---
+
+### Пример: как работает ручная формальная модель
+
+Допустим ты хочешь построить систему, которая понимает шпионские фильмы.
+
+**Ручная формальная модель (первый подход):** Ты садишься и описываешь мир шпионского фильма в формальном языке. Буквально пишешь правила:
+
+```
+Действие: ОТРАВИТЬ(злодей, герой, напиток)
+Предусловия: злодей_имеет(яд), герой_рядом(напиток), герой_не_знает(яд_в_напитке)
+Результат: герой_отравлен, яд_использован
+```
+
+```
+Действие: ПРИНЯТЬ_АНТИДОТ(герой, антидот)
+Предусловия: герой_имеет(антидот), герой_знает(он_отравлен)
+Результат: герой_не_отравлен
+```
+
+И так для каждого действия в мире: стрелять, следить, вербовать, предавать, сбежать... Десятки, сотни операторов. Dramatis работал именно так — Casino Royale вручную переводили в такие операторы.
+
+Система после этого может рассуждать: "герой отравлен, антидот есть, значит может принять антидот — escape plan существует — suspense низкий". Или: "герой отравлен, антидота нет, пистолет далеко, помощь не знает — suspense высокий".
+
+**Проблема** — knowledge engineering bottleneck. Ты описала шпионский мир — а теперь нужен медицинский сериал. Садись и описывай заново: диагноз, лечение, ошибка, осложнение... Потом комедию. Потом фэнтези. Для каждого домена — ручная работа эксперта. Не масштабируется.
+
+**Машинное обучение (второй подход):** Вместо того чтобы вручную писать правила — берём тысячи текстов из интернета (фанфики, пересказы фильмов, сценарии) и пытаемся автоматически извлечь паттерны: "когда кого-то отравили, обычно потом ищут антидот или вызывают врача". Не формальные правила, а статистические закономерности из корпуса.
+
+Или краудсорсинг: просим 500 людей на Amazon Mechanical Turk описать "что обычно происходит когда шпион в баре" — и из их ответов собираем скрипты.
+
+Масштабируется лучше, но теряет формальную точность — нет чётких preconditions и effects, есть "обычно бывает так".
+
+---
+
+## English summary
+
+English summary is mostly a direct translation of the first two sections above (Wittgenstein + Narrative Effects). One unique addition from the English version, already integrated into the Russian text above as a new bullet point:
+
+- **Unreliable narrator** — arises from the narrator's assertions diverging from facts. Without the ability to hold both — just noise.
diff --git a/docs/knowledge/theory/preprint-idea-meta-situation-model.md b/docs/knowledge/theory/preprint-idea-meta-situation-model.md
new file mode 100644
index 0000000..ca6027b
--- /dev/null
+++ b/docs/knowledge/theory/preprint-idea-meta-situation-model.md
@@ -0,0 +1,33 @@
+---
+type: concept
+project: preprint
+status: active
+---
+
+# Мета-situation model: расфокусированное понимание потока
+
+## Наблюдение
+
+Maryanne Wolf и другие говорят: скроллинг убивает глубокое чтение — нет времени на инференсы, эмпатию, критический анализ одного текста.
+
+Но есть другой эффект: информационный поток настолько интенсивен, что заметить тенденции и смыслы можно именно **расфокусировавшись** и глядя на поток целиком, а не на отдельное сообщение.
+
+## Два режима понимания
+
+**Фокусированное чтение** — один текст, глубоко. Строишь situation model конкретного нарратива: персонажи, мотивации, причинность, подтекст.
+
+**Расфокусированное скольжение** — поток текстов, каждый поверхностно, но видишь мета-паттерн. Строишь situation model не текста, а **информационной среды**: «все стали злее», «эта тема вытеснила ту», «этот нарратив повторяется из разных источников».
+
+В терминах Zwaan: первый режим строит situation model **внутри** текста. Второй строит **мета-situation model** — модель потока текстов.
+
+## Связь с plotter
+
+tvplotlines работает во втором режиме: не читает один эпизод глубоко, а скользит по потоку эпизодов и замечает паттерны — эта линия растёт, эта угасает, тут тематическая рифма, тут конвергенция. Pass 3 — буквально «расфокусированный взгляд на целый сезон», видящий структуру, невидимую из одного эпизода.
+
+## Важная оговорка
+
+Скроллинг **предоставляет возможность** для мета-situation model, но пока никто не освоил этот режим осознанно. Люди скроллят — но не строят мета-модели целенаправленно. Возможность есть, навыка нет.
+
+## Статус
+
+Сырая идея. Пока неясно, что с этим делать — может быть discussion-секция препринта, может отдельная заметка, может ничего.
diff --git a/docs/knowledge/theory/screenwriting-theory-reading-prompt.md b/docs/knowledge/theory/screenwriting-theory-reading-prompt.md
new file mode 100644
index 0000000..1bb5cd0
--- /dev/null
+++ b/docs/knowledge/theory/screenwriting-theory-reading-prompt.md
@@ -0,0 +1,181 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# Reading Brief: Что Найти В Учебниках По Сценаристике
+
+Промпт для LLM-ассистента. Читай учебники из списка ниже и заполняй таблицы ответов. Каждый вопрос—конкретный, с указанием зачем нужен ответ. Не додумывай—если в книге нет ответа, пиши "не найдено".
+
+---
+
+## Контекст
+
+tvplotlines—библиотека для автоматического извлечения сюжетных линий из синопсисов TV-сериалов. LLM читает синопсис и размечает: какие линии, кто ими движет (driver), какая цель (goal), что мешает (obstacle), что на кону (stakes), и какую функцию выполняет каждое событие в арке эпизода (setup, catalyst, escalation, turning_point, crisis, climax, resolution).
+
+Нам нужно убедиться что наши определения и правила соответствуют индустриальной практике, а не нашему творчеству.
+
+## Книги Для Чтения
+
+1. **Nash**—*Save the Cat! Writes for TV*
+2. **McKee**—*Story*
+3. **Douglas**—*Writing the TV Drama Series*
+4. **Oberg**—*Screenwriting Unchained*
+5. **Landau**—*The TV Showrunner's Roadmap*
+6. **Mittell**—*Complex TV*
+7. **Конспект Netflix pitch workshop** (если доступен в 3-resources)
+
+---
+
+## Вопрос 1: Event functions—каноническая Основа
+
+Мы используем 7 функций: setup, catalyst, escalation, turning_point, crisis, climax, resolution. Это микс из разных источников.
+
+**Найти в каждой книге:**
+
+| Книга | Какие этапы/биты/фазы арки автор выделяет? (полный список) | Сколько их? | Есть ли каноническая последовательность? |
+|-------|----------------------------------------------------------|------------|----------------------------------------|
+| Nash | | | |
+| McKee | | | |
+| Douglas | | | |
+| Oberg | | | |
+| Landau | | | |
+| Netflix | | | |
+
+**Дополнительно:**
+
+- Какая система ближе всего к нашим 7?
+- Какая система самая узнаваемая для TV writers/development executives?
+- Если наши 7 = сжатие чьей-то системы, то чьей именно и что мы потеряли при сжатии?
+
+## Вопрос 2: Порядок функций—жёсткие И Гибкие Правила
+
+**Найти:**
+
+| Правило                                                               |
+| --------------------------------------------------------------------- |
+| Может ли catalyst/inciting incident повторяться?                      |
+| Может ли escalation идти после turning_point/midpoint?                |
+| Может ли crisis идти до turning_point?                                |
+| Может ли climax повторяться в одной арке?                             |
+| Может ли setup появиться после midpoint?                              |
+| Какие этапы строго упорядочены (один не может быть после другого)?    |
+| Какие этапы могут повторяться?                                        |
+| Какие этапы могут отсутствовать в арке эпизода/сезона/сюжетной линии? |
+
+## Вопрос 3: Episode completeness—какие Функции Обязательны В Каждом Эпизоде
+
+Каждый эпизод TV-сериала—отдельная арка.
+
+**Найти:**
+
+| Вопрос                                                          |
+| --------------------------------------------------------------- |
+| Должен ли каждый эпизод содержать полную арку (начало → конец)? |
+| Какие элементы обязательны в каждом эпизоде?                    |
+| Какие элементы могут отсутствовать?                             |
+| Есть ли разница для procedural vs serial?                       |
+| Что со средними эпизодами сезона (не пилот, не финал)?          |
+
+## Вопрос 4: A-rank = Всегда Plot-led?
+
+Наш промпт утверждает: A-линия = "plot-led conflict" (внешняя цель vs антагонист).
+
+**Найти:**
+
+| Вопрос                                                           |     |     |     |     |
+| ---------------------------------------------------------------- | --- | --- | --- | --- |
+| A-story / main plot обязательно plot-led (внешний конфликт)?     |     |     |     |     |
+| Может ли главная линия быть character-led (внутренний конфликт)? |     |     |     |     |
+| Есть ли разница для ensemble vs serial?                          |     |     |     |     |
+| Примеры character-led A-линий если есть?                         |     |     |     |     |
+| Определения линий А/В/С?                                         |     |     |     |     |
+
+## Вопрос 5: Количество Основных Сюжетных Линий По Типу Сериала
+
+**Найти:**
+
+| Franchise type                                       |
+| ---------------------------------------------------- |
+| Procedural: сколько линий в эпизоде?                 |
+| Serial: сколько линий в сезоне?                      |
+| Hybrid: сколько?                                     |
+| Ensemble: сколько?                                   |
+| Как определить hybrid чтобы не сливался с procedural |
+
+## Вопрос 6: "Episodic" Как Тип Линии
+
+Мы используем "episodic" для обозначения линии которая открывается и закрывается в каждом эпизоде (case-of-the-week).
+
+**Найти:**
+
+| Вопрос                                                    |
+| --------------------------------------------------------- |
+| Какой термин использует автор для case-of-the-week линии? |
+| Есть ли формальное определение?                           |
+| Как автор отличает episodic от serialized линии?          |
+
+## Вопрос 7: Narrative devices—список И Определения
+
+Мы собираем: dramatic_irony, flashback, flashforward, callback, twist, unreliable. Не уверены что список полный и что определения точные.
+
+**Найти:**
+
+| Вопрос                                                                                                                      |
+| --------------------------------------------------------------------------------------------------------------------------- |
+| Какие narrative/structural devices автор выделяет?                                                                          |
+| Есть ли формальные определения?                                                                                             |
+| Как они связаны с пониманием нарратива (не просто "приём", а зачем)?                                                        |
+| Если мы их соберем - как их использовать при анализе?                                                                       |
+| Есть ли консенсус - как называть, какую роль играют - можно ли их собирать и показывать как всем понятный элемент сценария? |
+
+## Вопрос 8: Emotional Counterpoint Между Линиями
+
+Наш промпт: "if all storylines are rising or all falling—something is missed."
+
+**Найти:**
+
+| Вопрос                                                |
+| ----------------------------------------------------- |
+| Говорит ли автор о контрасте между линиями в эпизоде? |
+| Как это называется?                                   |
+| Это правило или рекомендация?                         |
+| Цитата если есть?                                     |
+|                                                       |
+
+## Вопрос 9: Weight / Screen Time Distribution
+
+Код вычисляет primary/background/glimpse по количеству событий. Пороги произвольные.
+
+**Найти:**
+
+| Вопрос                                                |
+| ----------------------------------------------------- |
+| Какую долю экранного времени занимает A-story?        |
+| B-story?                                              |
+| C-story?                                              |
+| Есть ли конкретные проценты или диапазоны?            |
+| Есть ли другие евристики как определить каждую линию? |
+
+## Вопрос 10: Hybrid Vs Procedural—где Граница?
+
+**Найти:**
+
+| Вопрос                                                               |
+| -------------------------------------------------------------------- |
+| Как автор определяет procedural?                                     |
+| Как определяет hybrid?                                               |
+| В чём конкретное отличие?                                            |
+| Может ли procedural иметь serialized B-линию? Это делает его hybrid? |
+
+---
+
+## Формат Ответов
+
+Для каждого вопроса:
+
+1. Заполни таблицу
+2. В каждой таблице в колонках ответы из книг, если ответы длинные, лучше не таблица а заголовок и списокцитат под ним, нужны цитаты а не интерпретации твои потом будет интерптировать
+3. Если нашёл цитату—приведи дословно с номером страницы
+4. Если в книге нет ответа—напиши "не найдено"
diff --git a/docs/knowledge/v3_narratology/Untitled.md b/docs/knowledge/v3_narratology/Untitled.md
new file mode 100644
index 0000000..753ff30
--- /dev/null
+++ b/docs/knowledge/v3_narratology/Untitled.md
@@ -0,0 +1,55 @@
+  Классическая нарратология (фундамент):
+
+  - Propp (1959) — Morphology of the Folktale
+
+  - Todorov (1971) — The 2 Principles of Narrative
+
+  - Chatman (1979) — Story and Discourse
+
+  - Prince (1982, 1989) — Narratology, Dictionary of
+
+  Narratology
+
+  - Bal (1988) — Narratology: Introduction to the
+
+  Theory of Narrative
+
+  - Herman (1997, 2009) — Postclassical Narratology,
+
+  Basic Elements of Narrative
+
+  - Bruner (1991) — Narrative Construction of Reality
+
+  
+
+  Computational narratology:
+
+  - Piper, So, Bamman (2021) — "Narrative Theory for
+
+  Computational Narrative Understanding" — ключевая
+
+  - Ranade et al. (2022) — "Computational
+
+  Understanding of Narratives: A Survey"
+
+  - Moretti (2005, 2011) — Graphs/Maps/Trees, Network
+
+  theory + plot analysis
+
+  - Huang & Usbeck (2024) — "Narration as Functions:
+
+  from Events to Narratives"
+
+  
+
+  Прямо релевантные для tvplotlines:
+
+  - Ouyang & McKeown (2015) — Turning Points in
+
+  Narrative
+
+  - Elkins (2022) — Shapes of Stories
+
+  - Piper & Bagga (2022, 2024, 2025) — Data-driven
+
+  narrativity, NarraDetect
\ No newline at end of file
diff --git a/docs/knowledge/v3_narratology/bal1988/actant-model-has-six-roles-not-four.md b/docs/knowledge/v3_narratology/bal1988/actant-model-has-six-roles-not-four.md
new file mode 100644
index 0000000..9ae1ce0
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bal1988/actant-model-has-six-roles-not-four.md
@@ -0,0 +1,53 @@
+# Actant model has six roles, not four
+
+Source: Bal 1988, "Narratology", Ch. 3.3 Actors (pp. 166-172)
+
+Greimas's actant model, as presented by Bal, replaces our Story DNA (hero, goal, obstacle, stakes) with six actants in three pairs:
+
+## Subject ↔ Object
+
+The teleological relation: who wants what. Subject = our "hero." Object = our "goal." But Object is broader — it can be a state ("becoming an independent woman"), knowledge ("the identity of the murderer"), or prevention ("preventing discovery").
+
+| Subject | function | Object |
+|---|---|---|
+| John | wants to marry | Mary |
+| Anna Wulf | wants to become | an independent woman |
+| The old people | want to prevent | the discovery of their crime |
+| Kinsey Millhone | wants to know | the identity of the murderer |
+| The killer | wants to avoid | Millhone's discovery |
+| Scheherazade | wants to prevent | the king's killing her |
+
+## Power ↔ Receiver
+
+Who enables or blocks the enterprise overall, and who benefits from the result. Power (Greimas's *destinateur*) is often abstract: society, fate, time, a character trait, social structure. Receiver (*destinataire*) is who benefits — not always the Subject.
+
+Power vs Helper distinction:
+| Power | Helper |
+|---|---|
+| Has power over the whole enterprise | Can give only incidental aid |
+| Is often abstract | Is mostly concrete |
+| Often remains in the background | Often comes to the fore |
+| Usually only one | Usually multiple |
+
+Examples: in a fairy tale, Power = "the king" who sets the quest; in a psychological novel, Power = "the subject's own character trait"; in a social novel, Power = "class structure."
+
+## Helper ↔ Opponent
+
+Who aids the Subject on the way to the Object, and who blocks. Opponent = our "obstacle," but more specific: Opponent blocks *on the way*, while Power enables/blocks *the whole enterprise*.
+
+Helpers: each necessary but individually insufficient. Opponents: must be overcome one by one, but overcoming one doesn't guarantee success.
+
+## What this means for tvplotlines
+
+Story DNA has 4 fields; the actant model has 6. The additions are:
+- **Power** — captures systemic/abstract forces (fate, institutions, character flaws) that our "obstacle" misses
+- **Receiver** — captures who actually benefits, which can differ from the hero
+
+For theme-led shows (The Wire, Succession), Power is especially useful: the real force driving the fabula isn't a character but "the institution" or "the system." Our current Story DNA struggles with these — "hero" and "obstacle" feel forced when the problem is systemic.
+
+## Links
+
+- [[anti-subject-signals-a-separate-storyline]]
+- [[competence-determines-when-subject-can-act]]
+- [[truth-value-reveals-apparent-vs-real-roles]]
+- [[narrative-cycle-has-three-phases-not-seven]]
diff --git a/docs/knowledge/v3_narratology/bal1988/anti-subject-signals-a-separate-storyline.md b/docs/knowledge/v3_narratology/bal1988/anti-subject-signals-a-separate-storyline.md
new file mode 100644
index 0000000..4b3a4ec
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bal1988/anti-subject-signals-a-separate-storyline.md
@@ -0,0 +1,31 @@
+# Anti-subject signals a separate storyline
+
+Source: Bal 1988, "Narratology", Ch. 3.3 Actors (pp. 172-173)
+
+An anti-subject is not just an opponent. An opponent blocks the subject *incidentally* — their opposition is circumstantial. An anti-subject has **their own program**, their own aim, and this pursuit happens to cross-purposes with the subject's.
+
+The structural difference: an opponent is defined by their relation to the subject's program. An anti-subject is defined by having **an autonomous program** that independently generates events.
+
+## Example: Tom Thumb
+
+The giant is not merely an opponent who blocks Tom's safe return. The giant has his own program: find children, eat them. He has his own competence (physical force, power of smell). His program intersects with Tom's because Tom *is* the children he wants to eat. Remove Tom from the story and the giant would still be hunting children.
+
+## When lines cross
+
+"The appearance of a separate subject indicates the existence of a sub-fabula." When an actant has their own aims and acts to achieve them, they're an autonomous subject — and their program is a separate fabula that intersects with the primary one. "There are moments in the fabula when the different lines touch or cross."
+
+## What this means for tvplotlines
+
+This is a precise criterion for plotline detection: **if a character has their own program (goal + actions toward it), they're an anti-subject, and their program is a separate plotline.** An opponent who merely blocks the hero doesn't get their own plotline — they're part of the hero's plotline.
+
+In Game of Thrones: Cersei isn't just an opponent to Ned Stark. She has her own program (protect her children, maintain power). That program generates its own events. She's an anti-subject → separate plotline.
+
+In House M.D.: the patient isn't an anti-subject. They don't have an autonomous program that generates events in the fabula. They're the Object of House's program. No separate plotline.
+
+This test is sharper than our current heuristic (different heroes OR one hero with different goals). It asks: does this character *independently generate events*, or only react to the subject's program?
+
+## Links
+
+- [[actant-model-has-six-roles-not-four]]
+- [[confrontation-structure-implies-two-actors-per-event]]
+- [[truth-value-reveals-apparent-vs-real-roles]]
diff --git a/docs/knowledge/v3_narratology/bal1988/bremond-semantic-labels-type-narrative-processes.md b/docs/knowledge/v3_narratology/bal1988/bremond-semantic-labels-type-narrative-processes.md
new file mode 100644
index 0000000..a139369
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bal1988/bremond-semantic-labels-type-narrative-processes.md
@@ -0,0 +1,40 @@
+# Bremond's semantic labels type narrative processes
+
+Source: Bal 1988, "Narratology", Ch. 3.2 Events (pp. 163-164)
+
+Each process of improvement or deterioration has semantic content. Applying a semantic label to an event makes it possible to compare fabulas structurally across different texts.
+
+## Improvement processes
+
+- **Fulfilment of the task** — the subject completes what was needed
+- **Intervention of allies** — help arrives
+- **Elimination of the opponent** — the obstacle is removed
+- **Negotiation** — a deal is struck
+- **Attack** — forceful action toward the goal
+- **Satisfaction** — can take the form of punishment, revenge, or reward
+
+## Deterioration processes
+
+- **Misstep** — a mistake, error, social blunder, moral lapse, or crime
+- **Creation of an obligation** — the subject becomes bound
+- **Sacrifice** — giving up something of value
+- **Endured attack** — suffering an assault
+- **Endured punishment** — suffering consequences
+
+Each label can be further specified. "Satisfaction" splits into punishment, revenge, reward. "Misstep" splits into mistake, error, social blunder, moral lapse, crime.
+
+## The initial situation
+
+The initial situation of a fabula is always a **state of deficiency** in which one or more actors want to introduce changes. The development of the fabula reveals whether the process involves improvement or deterioration *with regard to the initial situation*.
+
+## What this means for tvplotlines
+
+These labels are more informative than our current "escalation" or "turning_point." Instead of "this event escalates the plotline," we could say "this event is an *endured attack* in a deterioration process" or "this event is a *negotiation* in an improvement process." The vocabulary maps well to TV drama: alliances, betrayals, sacrifices, missteps, attacks — these are the stuff of serialized television.
+
+Question: is this vocabulary universal enough for TV, or too tied to folk/literary narrative?
+
+## Links
+
+- [[narrative-cycle-has-three-phases-not-seven]]
+- [[initial-situation-is-always-a-state-of-deficiency]]
+- [[actant-model-has-six-roles-not-four]]
diff --git a/docs/knowledge/v3_narratology/bal1988/competence-determines-when-subject-can-act.md b/docs/knowledge/v3_narratology/bal1988/competence-determines-when-subject-can-act.md
new file mode 100644
index 0000000..85bf37a
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bal1988/competence-determines-when-subject-can-act.md
@@ -0,0 +1,26 @@
+# Competence determines when the subject can act
+
+Source: Bal 1988, "Narratology", Ch. 3.3 Actors (p. 173)
+
+Greimas subdivides the subject's competence — their ability to act — into three types:
+
+- **Determination / will** — the subject *wants* to act
+- **Power / possibility** — the subject *can* act
+- **Knowledge / skill** — the subject *knows how* to act
+
+The phase of the fabula where the virtual subject begins to *desire* the execution of the program is the **introduction** of the fabula. This reframes "inciting incident": it's not necessarily an external event that disrupts equilibrium. It's the moment the subject acquires *determination* — the will to pursue a program.
+
+## Competence as differentiator
+
+Different kinds of subjects are distinguished by which competence they primarily rely on. In fairy tales, the opposition between good and evil often maps to power/force vs knowledge/skill. In detective stories, the detective's competence is knowledge — and interestingly, the murderer's competence is *also* knowledge/skill, but the detective fails in their competence (makes a mistake) while the murderer succeeds in theirs.
+
+## What this means for tvplotlines
+
+We currently have "inciting_incident" as a single concept. But Bal/Greimas suggest it could be decomposed: when does the character gain *will* (determination), *ability* (power), and *knowledge* (skill)? In Breaking Bad, Walt gains determination (cancer diagnosis → will to provide) before he gains knowledge (cooking meth with Jesse) before he gains power (territory, connections). Each is a different structural moment.
+
+This is probably too granular for the current pipeline but could inform character arc analysis.
+
+## Links
+
+- [[actant-model-has-six-roles-not-four]]
+- [[initial-situation-is-always-a-state-of-deficiency]]
diff --git a/docs/knowledge/v3_narratology/bal1988/confrontation-structure-implies-two-actors-per-event.md b/docs/knowledge/v3_narratology/bal1988/confrontation-structure-implies-two-actors-per-event.md
new file mode 100644
index 0000000..ea5bc37
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bal1988/confrontation-structure-implies-two-actors-per-event.md
@@ -0,0 +1,19 @@
+# Confrontation structure implies two actors per event
+
+Source: Bal 1988, "Narratology", Ch. 3.2 Events (pp. 157-158)
+
+Every functional event has three components: two actors and one action. In logical terms: two arguments and one predicate. Linguistically: subject – predicate – (direct) object, where both subject and object are agents of action.
+
+This is a strict requirement. "John kills a fly" — if the fly isn't an actor (doesn't cause or undergo functional events elsewhere in the fabula), this isn't a functional event despite having the right grammatical form. "Liz writes a letter" — a letter isn't an actor, but writing presupposes a reader, so the confrontation is implicit: "Liz writes to [someone]."
+
+The confrontation criterion filters out isolated actions. John who "kills a fly" and never interacts with another actor functionally isn't participating in the fabula — he's "an isolated agent of action," illustrating a condition (loneliness) rather than driving the plot.
+
+## What this means for tvplotlines
+
+Our event definition doesn't require a second actor. "House orders a lumbar puncture" names only one actor. But by Bal's logic, it's functional because there's an implicit confrontation: House vs. the patient's illness, or House vs. Cameron's objection. Making the second actor explicit (even when it's implicit in the text) would sharpen event descriptions.
+
+## Links
+
+- [[three-criteria-filter-functional-events]]
+- [[actant-model-has-six-roles-not-four]]
+- [[anti-subject-signals-a-separate-storyline]]
diff --git a/docs/knowledge/v3_narratology/bal1988/confrontation-type-reveals-plotline-nature.md b/docs/knowledge/v3_narratology/bal1988/confrontation-type-reveals-plotline-nature.md
new file mode 100644
index 0000000..1c085a5
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bal1988/confrontation-type-reveals-plotline-nature.md
@@ -0,0 +1,23 @@
+# Confrontation type (verbal/mental/bodily) reveals plotline nature
+
+Source: Bal 1988, "Narratology", Ch. 3.2 Events (p. 164)
+
+Events can be classified by the **nature of the confrontation** between actors: verbal (spoken), mental (thoughts, feelings, observations), or bodily (physical contact). Whether these contacts succeed, fail, or are indeterminate gives insight into the fabula's themes.
+
+Bal's insight: "If the contact between the two most important actors is predominantly mental and unsuccessful, we may surmise that the theme is alienation." The *type* of confrontation, combined with its success or failure, points to thematic content without needing explicit thematic analysis.
+
+## What this means for tvplotlines
+
+This maps suggestively to our plotline:nature classification (plot-led / character-led / theme-led):
+
+- Predominantly **bodily/action** confrontations → plot-led (external obstacles, physical conflict)
+- Predominantly **mental** confrontations → character-led (internal conflict, alienation, desire)
+- Mixed **verbal** confrontations across many actors → theme-led (institutional dynamics, systemic problems)
+
+If events already have confrontation types, plotline:nature could be *derived* rather than manually assigned. This would be a validation mechanism: if pass1 labels a plotline as "character-led" but its events are all bodily confrontations, something is off.
+
+## Links
+
+- [[three-criteria-filter-functional-events]]
+- [[confrontation-structure-implies-two-actors-per-event]]
+- [[actant-model-has-six-roles-not-four]]
diff --git a/docs/knowledge/v3_narratology/bal1988/events-are-transitions-between-states.md b/docs/knowledge/v3_narratology/bal1988/events-are-transitions-between-states.md
new file mode 100644
index 0000000..72e8915
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bal1988/events-are-transitions-between-states.md
@@ -0,0 +1,19 @@
+# Events are transitions between states, not actions by characters
+
+Source: Bal 1988, "Narratology", Ch. 3.2 Events (p. 155)
+
+Bal defines an event as "the transition from one state to another state." The word "transition" stresses that an event is a *process*, an alteration — not a static fact and not necessarily an action.
+
+Compare "John is ill" (a condition — not an event) with "John falls ill" (a transition — an event). The difference is in the verb: the second implies a change of state.
+
+This is subtly but importantly different from the tvplotlines definition: "One action by one character that changes the situation." Bal's definition is broader: an event can be *experienced* (not just *performed*), and the focus is on the state-change, not on the action itself.
+
+## Consequence
+
+"John falls ill" is an event even though no one caused it — it's a transition experienced by an actor. This matters for TV analysis because many significant plot events are things that *happen to* characters (a diagnosis, a discovery, an accident), not things characters *do*.
+
+## Links
+
+- [[three-criteria-filter-functional-events]]
+- [[three-layer-model-separates-text-story-fabula]]
+- [[narrative-cycle-has-three-phases-not-seven]]
diff --git a/docs/knowledge/v3_narratology/bal1988/fabula-is-memory-trace-not-authors-plan.md b/docs/knowledge/v3_narratology/bal1988/fabula-is-memory-trace-not-authors-plan.md
new file mode 100644
index 0000000..b050d58
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bal1988/fabula-is-memory-trace-not-authors-plan.md
@@ -0,0 +1,18 @@
+# Fabula is a memory trace, not the author's plan
+
+Source: Bal 1988, "Narratology", Introduction (p. 9)
+
+"The fabula is really the result of the mental activity of reading; it is the interpretation by the reader, influenced both by the initial encounter with the text and by the manipulations of the story."
+
+We never access the fabula directly — we reconstruct it. Writers mostly work alone; filmmakers are part of a team. How they proceed "we simply cannot know." What we can study is the text and the conditions under which it produces particular effects.
+
+## Why this matters for tvplotlines
+
+We work with synopses — plot summaries written by someone who watched the episode. These are already *reconstructed fabulas*, not texts. This is actually an advantage: our input is closer to the fabula level than raw scripts would be. But it also means we've already lost text-level and most story-level information (focalization, pacing, visual style) before our pipeline even starts.
+
+The pipeline shouldn't pretend it's analyzing "the show." It's analyzing the fabula as reconstructed in synopses.
+
+## Links
+
+- [[three-layer-model-separates-text-story-fabula]]
+- [[events-are-transitions-between-states]]
diff --git a/docs/knowledge/v3_narratology/bal1988/initial-situation-is-always-a-state-of-deficiency.md b/docs/knowledge/v3_narratology/bal1988/initial-situation-is-always-a-state-of-deficiency.md
new file mode 100644
index 0000000..644369f
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bal1988/initial-situation-is-always-a-state-of-deficiency.md
@@ -0,0 +1,21 @@
+# Initial situation is always a state of deficiency
+
+Source: Bal 1988, "Narratology", Ch. 3.2 Events (p. 164)
+
+"The initial situation in a fabula will always be a state of deficiency in which one or more actors want to introduce changes."
+
+This is a strong claim: every fabula begins with something lacking, something wrong, something that needs to change. The development reveals whether the change process leads to improvement or deterioration relative to this initial state.
+
+## Relation to Todorov
+
+This aligns with Todorov's equilibrium model (equilibrium → disruption → new equilibrium), but with an important difference: Bal/Bremond don't assume the initial state is an *equilibrium*. It's already a deficiency. The fabula is the attempt to fix (or worsen) it.
+
+## What this means for tvplotlines
+
+Our "story_engine" and "inciting_incident" implicitly assume a stable starting point that gets disrupted. But many TV shows start *in medias res* — the deficiency is already present in S01E01 (Walter White already has cancer before the pilot's midpoint). By Bal's logic, the "inciting incident" isn't what creates the deficiency — it's the moment the subject gains **determination** (competence to act). This is a subtle but useful reframe.
+
+## Links
+
+- [[narrative-cycle-has-three-phases-not-seven]]
+- [[competence-determines-when-subject-can-act]]
+- [[actant-model-has-six-roles-not-four]]
diff --git a/docs/knowledge/v3_narratology/bal1988/iterative-anticipation-describes-procedural-tv-pilots.md b/docs/knowledge/v3_narratology/bal1988/iterative-anticipation-describes-procedural-tv-pilots.md
new file mode 100644
index 0000000..f643e8e
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bal1988/iterative-anticipation-describes-procedural-tv-pilots.md
@@ -0,0 +1,26 @@
+# Iterative anticipation describes procedural TV pilots
+
+Source: Bal 1988, "Narratology", Ch. 2.3 Sequential Ordering (p. 84)
+
+An **iterative anticipation** presents an event as the first in a series that will repeat: "Then the President appeared on the screen, a spectacle that would weigh on our spirits every Friday from now on."
+
+The event is simultaneously unique (this specific appearance) and iterative (establishing a pattern). Bal notes a tension: "The more detailed such a report, the less credible its iterative character" — the more specific the case, the harder to believe it happens the same way every time.
+
+## The procedural pilot
+
+This is a precise description of what the pilot of a procedural show does. The first "case of the week" is an iterative anticipation: it's a specific, detailed case, but it also establishes the **formula** that will repeat. The audience understands after the pilot: *this is what happens every week.*
+
+House S01E01 presents a specific patient with a specific mystery. But the audience leaves knowing: each week, a patient will arrive, House will resist, the team will run tests, diagnoses will fail, and House will have a last-minute insight. The pilot is iterative anticipation.
+
+Bal's observation about the tension is relevant: the more vivid and specific the pilot's case, the more the audience engages with *this* case, and the less they register the iterative formula. Good procedural pilots balance both.
+
+## What this means for tvplotlines
+
+Our pass0 concept of "story_engine" is the formula behind the iterative anticipation. The story_engine describes *what repeats*, abstracted from the specific content of any one episode. "An antisocial maverick doctor does whatever it takes to solve puzzling cases" = the iterative pattern that the pilot anticipates.
+
+This doesn't change our pipeline, but gives it a narratological foundation: format detection (pass0) is recognizing whether the pilot contains an iterative anticipation.
+
+## Links
+
+- [[sequential-ordering-separates-fabula-time-from-story-time]]
+- [[three-layer-model-separates-text-story-fabula]]
diff --git a/docs/knowledge/v3_narratology/bal1988/narrative-cycle-has-three-phases-not-seven.md b/docs/knowledge/v3_narratology/bal1988/narrative-cycle-has-three-phases-not-seven.md
new file mode 100644
index 0000000..05f2e05
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bal1988/narrative-cycle-has-three-phases-not-seven.md
@@ -0,0 +1,63 @@
+# Narrative cycle has three phases, not seven
+
+Source: Bal 1988, "Narratology", Ch. 3.2 Events (pp. 160-164)
+
+Instead of Freytag's linear arc (setup → inciting_incident → escalation → turning_point → crisis → climax → resolution), Bal presents Bremond's model: the fabula is a grouping of **elementary series**, each with three phases:
+
+1. **Possibility** (virtuality) — a potential action or change
+2. **Realization** — the action happens (or doesn't)
+3. **Result** (conclusion) — success or failure
+
+None of these phases is obligatory. A possibility can remain unrealized. A realization can lack a clear result. This is fundamentally different from Freytag: there's no prescribed shape, no required arc.
+
+## Direction: improvement or deterioration
+
+Each cycle has a direction:
+
+```
+Improvement to be achieved → process of improvement → improvement achieved
+                           → no process            → improvement not achieved
+
+Foreseen deterioration      → process of deterioration → resultant deterioration
+                           → no process               → deterioration avoided
+```
+
+This replaces "escalation" and "turning_point" with something more informative: the **direction** of change. "Escalation" tells you intensity is increasing but not *which way*. Bremond tells you: is this an improvement process or a deterioration process for the subject?
+
+## Embedding
+
+Series nest inside each other. The result of one series becomes the possibility of another. One realization can open a new possibility:
+
+```
+John is tired (possibility: rest)
+  He rests → feels fine (improvement achieved)
+    Feels fine = can work (new possibility)
+      Works → gets tired (deterioration)
+```
+
+Or more dramatically:
+
+```
+John is tired (possibility: sleep)
+  Falls asleep (realization)
+    = possibility: forget exam (embedded deterioration)
+      Forgets → fails exam (deterioration achieved)
+John feels fine again (primary improvement achieved)
+```
+
+The primary series (improvement) and embedded series (deterioration) can have different importance. The embedded one may matter more for the fabula.
+
+## What this means for tvplotlines
+
+Instead of asking "is this event setup, escalation, or climax?", we could ask:
+1. **Direction**: improvement or deterioration (for which actor)?
+2. **Phase**: possibility, realization, or result?
+3. **Is this primary or embedded** in another series?
+
+This gives richer information. "Walt strangles Krazy-8" is: realization of deterioration (elimination/sacrifice), embedded in a primary improvement series (Walt's survival).
+
+## Links
+
+- [[bremond-semantic-labels-type-narrative-processes]]
+- [[events-are-transitions-between-states]]
+- [[initial-situation-is-always-a-state-of-deficiency]]
diff --git a/docs/knowledge/v3_narratology/bal1988/sequential-ordering-separates-fabula-time-from-story-time.md b/docs/knowledge/v3_narratology/bal1988/sequential-ordering-separates-fabula-time-from-story-time.md
new file mode 100644
index 0000000..428e105
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bal1988/sequential-ordering-separates-fabula-time-from-story-time.md
@@ -0,0 +1,40 @@
+# Sequential ordering separates fabula-time from story-time
+
+Source: Bal 1988, "Narratology", Ch. 2.3 Sequential Ordering (pp. 67-84)
+
+The order of events in the story can differ from their chronological order in the fabula. These differences — **anachronies** — are not mere stylistic choices but structural devices with specific narrative functions.
+
+## Types of anachrony
+
+**Direction:**
+- **Retroversion** (flashback) — presenting a past event
+- **Anticipation** (flashforward) — presenting a future event
+
+**Distance:** how far from the story's "present" the anachrony reaches.
+
+**Span:** how much fabula-time the anachrony covers (a moment vs. years).
+
+**Relation to primary fabula:**
+- **Internal** — within the time-span of the primary fabula
+- **External** — outside it (backstory, aftermath)
+- **Mixed** — starts outside, ends inside (or vice versa)
+
+## Functions of retroversion
+
+Internal retroversions serve specific structural purposes:
+- **Filling a gap (paralipsis)** — supplying information that was skipped earlier
+- **Repetition with reinterpretation** — the same event presented in a new light, changing its meaning
+- **Providing antecedents** — backstory for a newly introduced character
+
+External retroversions provide **antecedents** — the past of the actors, relevant insofar as it explains their current actions.
+
+## What this means for tvplotlines
+
+Our pipeline works with synopses that are mostly chronological. But TV episodes routinely use flashbacks and flash-forwards. If synopses note these, we could classify them using Bal's categories: is the flashback filling a gap, reinterpreting a past event, or providing antecedents? Each has different structural significance.
+
+More practically: the distinction between internal and external anachrony maps to the difference between "events within the current season's timeline" and "backstory" — which our pipeline currently doesn't formally distinguish.
+
+## Links
+
+- [[three-layer-model-separates-text-story-fabula]]
+- [[iterative-anticipation-describes-procedural-tv-pilots]]
diff --git a/docs/knowledge/v3_narratology/bal1988/suspense-has-four-types-not-one.md b/docs/knowledge/v3_narratology/bal1988/suspense-has-four-types-not-one.md
new file mode 100644
index 0000000..97f7701
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bal1988/suspense-has-four-types-not-one.md
@@ -0,0 +1,29 @@
+# Suspense has four types, not one
+
+Source: Bal 1988, "Narratology", Ch. 2.8 Focalization (pp. 148-149)
+
+Bal analyzes suspense through the **asymmetry of knowledge** between reader/viewer and character. When a question is raised ("Who did it? How will it end?"), four situations are possible:
+
+| reader | character | type | mechanism |
+|---|---|---|---|
+| doesn't know | doesn't know | **riddle** | detective story, search — both parties seek the answer |
+| knows | doesn't know | **threat** | the audience sees the bomb, the character doesn't — tension from anticipated collision |
+| doesn't know | knows | **secret** | the character holds information the audience lacks — tension from anticipated revelation |
+| knows | knows | no suspense | — |
+
+## Comparison with current tvplotlines
+
+Our interaction types include "dramatic_irony" — which maps only to **threat** (reader+, character−). But riddle and secret are equally powerful narrative effects:
+
+- **Riddle** drives mystery arcs: who killed Laura Palmer? What is the island? The audience and characters are equally in the dark.
+- **Secret** drives revelation arcs: the old people in Couperus's *Of Old People* know about the murder but the reader doesn't. Information is gradually released through shifting focalization.
+- **Threat** (= our dramatic_irony) drives tension arcs: we know Walt is Heisenberg, Hank doesn't.
+
+## What this means for tvplotlines
+
+Expanding interaction types from one (dramatic_irony) to three (riddle, threat, secret) would capture more narrative mechanics. Each type implies a different audience experience and could predict different structural patterns (mystery arcs tend to have delayed revelations; threat arcs tend to have convergence events).
+
+## Links
+
+- [[three-layer-model-separates-text-story-fabula]]
+- [[truth-value-reveals-apparent-vs-real-roles]]
diff --git a/docs/knowledge/v3_narratology/bal1988/three-criteria-filter-functional-events.md b/docs/knowledge/v3_narratology/bal1988/three-criteria-filter-functional-events.md
new file mode 100644
index 0000000..5a489f5
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bal1988/three-criteria-filter-functional-events.md
@@ -0,0 +1,33 @@
+# Three criteria filter functional from non-functional events
+
+Source: Bal 1988, "Narratology", Ch. 3.2 Events (pp. 155-159)
+
+Not every transition is worth analyzing. Bal (following Barthes) introduces three filters to distinguish **functional events** — those that matter for the fabula's structure:
+
+## 1. Change
+
+The event must describe a process, not a condition. Test: can you rewrite the sentence with a verb of change? "John was cleaning his house. John fell ill and therefore had to stop cleaning" — the word "stop" marks the transition.
+
+## 2. Choice
+
+Functional events **open a fork**, realize a choice, or reveal the result of a choice. If Liz leaves for work and walks straight — non-functional (doesn't affect what follows). If she's hit by a car at the crossing — functional, because the rest of the fabula depends on it.
+
+Key test: **if this hadn't happened, would the rest change?** If no — not a functional event.
+
+## 3. Confrontation
+
+Every functional event has the structure: subject – predicate – (direct) object. Both subject and object must be actors (agents of action). Two actors and one process.
+
+"John kills a fly" — not functional if the fly isn't an actor in the fabula. "Liz writes a letter" — seemingly no confrontation, but a letter presupposes an addressee → can be rewritten as "Liz writes to John" → confrontation exists.
+
+Context decides: a murder can be non-functional if it merely illustrates a character trait without affecting the fabula's development (Bal cites Joyce Carol Oates, "The Man That Turned into a Statue").
+
+## What this means for tvplotlines
+
+Current pass2 instruction says "Each sentence should result in at least one event." This is too coarse. A sentence like "The team discusses the case" or "John arrives home" is not necessarily a functional event. Adding the choice test — *does this open a fork or realize one?* — would filter noise from the event list.
+
+## Links
+
+- [[events-are-transitions-between-states]]
+- [[narrative-cycle-has-three-phases-not-seven]]
+- [[confrontation-structure-implies-two-actors-per-event]]
diff --git a/docs/knowledge/v3_narratology/bal1988/three-layer-model-separates-text-story-fabula.md b/docs/knowledge/v3_narratology/bal1988/three-layer-model-separates-text-story-fabula.md
new file mode 100644
index 0000000..e4ce065
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bal1988/three-layer-model-separates-text-story-fabula.md
@@ -0,0 +1,25 @@
+# Three-layer model separates text, story, and fabula
+
+Source: Bal 1988, "Narratology", Introduction (pp. 5-7)
+
+Bal builds all of narratology on a three-layer distinction:
+
+- **Text** — the concrete artefact: words, shots, frames. The material sign system. Key question: *who narrates?*
+- **Story** — the content of the text, a particular "colouring" of a fabula. How events are ordered, paced, focalized. Key question: *how is the fabula presented?*
+- **Fabula** — a series of logically and chronologically related events caused or experienced by actors. The abstract skeleton. Key question: *what happened?*
+
+These layers don't exist independently. The only material we have is the text; story and fabula are theoretical constructs, reconstructed by the reader. The fabula is "a memory trace that remains after the reading is completed" (p. 9).
+
+The same fabula can be told through different stories (different orderings, focalizations) and realized in different texts (novel, film, comic). "Tom Thumb" is the same fabula whether in Perrault's text or a cartoon film.
+
+## Why this matters for tvplotlines
+
+Our current prompts conflate levels. Story DNA (hero-goal-obstacle-stakes) operates at the fabula level. Seven dramatic functions (setup → resolution) are also fabula. But "interactions" (thematic_rhyme, dramatic_irony) are story-level — they describe how events are organized, not what logically happened. And "format" (procedural/serial) is text-level — how the show delivers its material.
+
+Separating levels explicitly would make our pipeline more precise: pass2 extracts fabula (events + actors + causal relations), pass4 describes story (how those events are ordered across the season arc).
+
+## Links
+
+- [[fabula-is-memory-trace-not-authors-plan]]
+- [[events-are-transitions-between-states]]
+- [[sequential-ordering-separates-fabula-time-from-story-time]]
diff --git a/docs/knowledge/v3_narratology/bal1988/truth-value-reveals-apparent-vs-real-roles.md b/docs/knowledge/v3_narratology/bal1988/truth-value-reveals-apparent-vs-real-roles.md
new file mode 100644
index 0000000..17036e2
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bal1988/truth-value-reveals-apparent-vs-real-roles.md
@@ -0,0 +1,29 @@
+# Truth value reveals apparent vs real roles of actants
+
+Source: Bal 1988, "Narratology", Ch. 3.3 Actors (p. 174)
+
+Actants have an **apparent** role and a **real** role, and these can diverge. A traitor appears to be a helper but is actually an opponent. A secret helper appears neutral but acts on the subject's behalf. A false hero appears to be the subject but lacks the competence.
+
+Bal lists categories that emerge from this distinction:
+- **Liars** — misrepresent their role
+- **Master figures** — control from behind the scenes
+- **False heroes** — appear to be subjects but aren't
+- **Invisible fairies** — help without being perceived
+- **Seducers** — manipulate through attraction
+- **Truth-tellers** — reveal what others hide
+- **False clues** — mislead about the fabula's direction
+- **Sudden moments of inspiration** — unexpected knowledge that changes the subject's course
+
+## What this means for tvplotlines
+
+This is directly relevant to TV series with unreliable characters (GoT, Succession, Breaking Bad). Truth value *changes over the course of a season*: a character introduced as helper reveals themselves as opponent (or vice versa). These revelations are structurally significant events — they're not just "turning points" but specifically *truth-value shifts*.
+
+Our pipeline could track this: does a character's actantial role change between episodes? If someone shifts from helper to opponent, that's a structural event that should be flagged.
+
+Currently out of scope but worth noting for future work.
+
+## Links
+
+- [[actant-model-has-six-roles-not-four]]
+- [[anti-subject-signals-a-separate-storyline]]
+- [[suspense-has-four-types-not-one]]
diff --git a/docs/knowledge/v3_narratology/balestri-pescatore-2025-icaart.md b/docs/knowledge/v3_narratology/balestri-pescatore-2025-icaart.md
new file mode 100644
index 0000000..9ca1cca
--- /dev/null
+++ b/docs/knowledge/v3_narratology/balestri-pescatore-2025-icaart.md
@@ -0,0 +1,37 @@
+---
+type: research
+project: tvplotlines
+status: active
+source: https://arxiv.org/abs/2503.04817
+doi: 10.5220/0013369600003890
+year: 2025
+authors: [Balestri, Pescatore]
+venue: ICAART 2025
+---
+
+# Multi-Agent System for AI-Assisted Extraction of Narrative Arcs in TV Series
+
+## Summary
+
+Мульти-агентная система для извлечения нарративных арок из сериалов. Тестировалась на Grey's Anatomy S1. Классифицирует арки как Anthology (самостоятельные), Soap (отношения), Genre-Specific (жанровые). Хранит в реляционной + векторной БД. Графический интерфейс для ручной доработки.
+
+## Key concepts
+
+- **Anthology / Soap / Genre-Specific** — трёхчастная классификация арок (ср. tvplotlines: case_of_the_week / serialized / runner)
+- **Paratexts** — система работает с синопсисами, не с полным текстом (как и tvplotlines)
+- **Multi-agent architecture** — агенты для разных этапов извлечения
+- **Human-in-the-loop** — графический интерфейс для коррекции
+
+## Limitations
+
+Reliance on episode summaries misses overlapping arcs and subtle dynamics. Blends distinct storylines when they share characters.
+
+## Relevance to tvplotlines
+
+Прямой предшественник. tvplotlines переосмыслил их классификацию (A/B/C вместо Anthology/Soap/Genre) и добавил Story DNA, narrative functions, multi-pass verification.
+
+## Connections
+
+- [[balestri-pescatore-2025-memory]] — расширенная версия этой же работы
+- [[liu-2025-narrative-theory-survey]] — обзор, включает эту работу
+- [[keith-2025-interactive-narrative-analytics]] — похожий подход к визуализации
diff --git a/docs/knowledge/v3_narratology/balestri-pescatore-2025-memory.md b/docs/knowledge/v3_narratology/balestri-pescatore-2025-memory.md
new file mode 100644
index 0000000..d4a1be8
--- /dev/null
+++ b/docs/knowledge/v3_narratology/balestri-pescatore-2025-memory.md
@@ -0,0 +1,32 @@
+---
+type: research
+project: tvplotlines
+status: active
+source: https://arxiv.org/abs/2508.07010
+year: 2025
+authors: [Balestri, Pescatore]
+venue: LNAI (forthcoming)
+---
+
+# Narrative Memory in Machines: Multi-Agent Arc Extraction in Serialized TV
+
+## Summary
+
+Расширение ICAART-статьи. Вводит архитектуру памяти по аналогии с человеческой: LLM как семантическая память (общие нарративные паттерны), векторная БД как эпизодическая память (конкретные арки), мульти-агентный workflow как рабочая память.
+
+## Key concepts
+
+- **Episodic memory** — хранение конкретных арок и их прогрессий в векторной БД
+- **Semantic memory** — LLM как источник общих нарративных паттернов
+- **Working memory** — мульти-агентный процесс как аналог рабочей памяти
+- **Computational memory architecture** — формализация нарративного понимания через модели памяти
+
+## Relevance to tvplotlines
+
+Самый близкий аналог. Тот же домен (сериалы), те же авторы (Balestri & Pescatore), но другая теоретическая рамка — когнитивная (память), а не сценарная (драматические функции). Интересно как альтернативный фреймворк.
+
+## Connections
+
+- [[balestri-pescatore-2025-icaart]] — исходная версия
+- [[mani-2025-narrative-generative-ai]] — теоретический фундамент computational narratology
+- [[liu-2025-narrative-theory-survey]] — контекст в поле
diff --git a/docs/knowledge/v3_narratology/bibliography-balestri-2025-memory.md b/docs/knowledge/v3_narratology/bibliography-balestri-2025-memory.md
new file mode 100644
index 0000000..65f370e
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bibliography-balestri-2025-memory.md
@@ -0,0 +1,61 @@
+---
+type: bibliography
+project: tvplotlines
+status: active
+source_paper: "[[balestri-pescatore-2025-memory]]"
+total_references: 45
+retrieved_via: Semantic Scholar API
+retrieved_date: 2026-04-10
+---
+
+# Bibliography: Balestri & Pescatore (2025) — Narrative Memory in Machines
+
+Complete bibliography extracted from "Narrative Memory in Machines: Multi-Agent Arc Extraction in Serialized TV" (arXiv:2508.07010).
+
+## References
+
+1. Roberto Balestri, G. Pescatore (2025). "Multi-Agent System for AI-Assisted Extraction of Narrative Arcs in TV Series". ICAART. DOI: 10.5220/0013369600003890 / arXiv: 2503.04817
+2. Yu Wang, Dmitry Krotov, Yuanzhe Hu et al. (2025). "M+: Extending MemoryLLM with Scalable Long-Term Memory". ICML. arXiv: 2502.00592
+3. Weikang Yuan, Junjie Cao, Zhuoren Jiang et al. (2024). "Can Large Language Models Grasp Legal Theories?". EMNLP. arXiv: 2410.02507
+4. Alireza Ghafarollahi, Markus J. Buehler (2024). "SciAgents: Automating scientific discovery through multi-agent intelligent graph reasoning". arXiv. arXiv: 2409.05556
+5. Naoto Aoki, Naoki Mori, M. Okada (2023). "Analysis of LLM-Based Narrative Generation Using the Agent-Based Simulation". IIAI-AAI-Winter. DOI: 10.1109/IIAI-AAI-Winter61682.2023.00059
+6. A. Piper, Olivier Toubia (2023). "A quantitative study of non-linearity in storytelling". Poetics. DOI: 10.1016/j.poetic.2023.101793
+7. M. Rocchi, G. Pescatore (2022). "Modeling narrative features in TV series: coding and clustering analysis". Humanities and Social Sciences Communications. DOI: 10.1057/s41599-022-01352-9
+8. Milán Janosov (2021). "Network Science Predicts Who Dies Next in Game of Thrones". arXiv. arXiv: 2110.09856
+9. Bhartendoo Vimal, Anupama Kumar (2020). "Application of Logistic Regression in Natural Language Processing". IJERT. DOI: 10.17577/ijertv9is060095
+10. Patrick Lewis, Ethan Perez et al. (2020). "Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks". NeurIPS. arXiv: 2005.11401
+11. David Wilmot, Frank Keller (2020). "Modelling Suspense in Short Stories as Uncertainty Reduction over Neural Representation". ACL. arXiv: 2004.14905
+12. A. Piper (2018). "Enumerations: Data and Literary Study". DOI: 10.7208/chicago/9780226568898.001.0001
+13. Andrew Beveridge, Michael M. Chemers (2018). "The Game of Game of Thrones: Networked Concordances and Fractal Dramaturgy". DOI: 10.4324/9781315114668-13
+14. Veronica Innocenti, G. Pescatore (2018). "The Evolution of Characters in TV Series". DOI: 10.4324/9781315114668-7
+15. Veronica Innocenti, G. Pescatore (2017). "Narrative Ecosystems: A Multidisciplinary Approach to Media Worlds". DOI: 10.1515/9789048525317-010
+16. Tom Young, Devamanyu Hazarika, Soujanya Poria, E. Cambria (2017). "Recent Trends in Deep Learning Based NLP". IEEE Computational Intelligence Magazine. arXiv: 1708.02709
+17. Dianbo Liu, Luca Albergante (2017). "Balance of thrones: a network study on 'Game of Thrones'". arXiv. arXiv: 1707.05213
+18. Ashish Vaswani, Noam Shazeer et al. (2017). "Attention is All you Need". NeurIPS. arXiv: 1706.03762
+19. Wenpeng Yin, Katharina Kann, Mo Yu, Hinrich Schütze (2017). "Comparative Study of CNN and RNN for NLP". arXiv. arXiv: 1702.01923
+20. A. J. Reagan, Lewis Mitchell et al. (2016). "The emotional arcs of stories are dominated by six basic shapes". EPJ Data Science. arXiv: 1606.07772
+21. Semi Min, Juyong Park (2016). "Modeling narrative structure and dynamics with networks, sentiment analysis, and topic modeling". PLoS ONE. DOI: 10.1371/journal.pone.0226025
+22. Xavier Bost, Vincent Labatut et al. (2016). "Narrative smoothing: Dynamic conversational network for the analysis of TV series plots". ASONAM. DOI: 10.1109/ASONAM.2016.7752379
+23. Benjamin M. Schmidt (2015). "Plot arceology: A vector-space model of narrative structure". IEEE Big Data. DOI: 10.1109/BigData.2015.7363937
+24. Jason Mittell (2015). "Complex TV: The Poetics of Contemporary Television Storytelling".
+25. Jan Baetens (2014). "Storytelling and the Sciences of Mind". Leonardo. DOI: 10.1162/LEON_r_00881
+26. Jason Mittell, M. Grishakova, Marie-Laure Ryan (2010). "Previously On: Prime Time Serials and the Mechanics of Memory". DOI: 10.1515/9783110237740.78
+27. D. Kellner, Heather Collette-Van Deraa (2008). "Fandom: Identities and Communities in a Mediated World". DOI: 10.1177/009430610803700621
+28. Ingo Steinwart, A. Christmann (2008). "Support vector machines". DOI: 10.1002/wics.49
+29. Jeffrey M. Zacks, N. Speer, K. Swallow et al. (2007). "Event perception: a mind-brain perspective". Psychological Bulletin. DOI: 10.1037/0033-2909.133.2.273
+30. A. Baddeley (2003). "Working memory and language: an overview". Journal of Communication Disorders. DOI: 10.1016/S0021-9924(03)00019-4
+31. D. Schacter (1999). "The seven sins of memory". American Psychologist. DOI: 10.1037/0003-066X.54.3.182
+32. E. Tulving, H. Markowitsch (1998). "Episodic and declarative memory: Role of the hippocampus". Hippocampus. DOI: 10.1002/(SICI)1098-1063(1998)8:3<198::AID-HIPO2>3.0.CO;2-G
+33. L. Squire, S. Zola (1996). "Structure and function of declarative and nondeclarative memory systems". PNAS. DOI: 10.1073/PNAS.93.24.13515
+34. A. Graesser, Murray Singer, T. Trabasso (1994). "Constructing inferences during narrative text comprehension". Psychological Review. DOI: 10.1037/0033-295X.101.3.371
+35. Hugh M. Culbertson (1993). "Textual poachers: Television fans and participatory culture" [review of Jenkins]. DOI: 10.1016/0363-8111(93)90051-D
+36. M. Minsky (1987). "The Society of Mind". DOI: 10.5840/persforum19873112
+37. C. Schank, Roger (1983). "Dynamic Memory: A Theory of Reminding and Learning in Computers and People".
+38. S. Bann, John E. Bowlt (1974). "Russian formalism: a collection of articles and texts in translation". DOI: 10.2307/3724273
+39. T. Todorov, Arnold A. Weinstein (1969). "Structural Analysis of Narrative". DOI: 10.2307/1345003
+40. Alec Radford, Karthik Narasimhan (2018). "Improving Language Understanding by Generative Pre-Training".
+41. Sibelan Forrester (2012). "The Russian Folktale by Vladimir Yakolevich Propp".
+42. G. Genette, J. Lewin, Richard A. Macksey (1997). "Paratexts: Thresholds of Interpretation".
+43. Suphakit Niwattanakul et al. "Using of Jaccard Coefficient for Keywords Similarity".
+44. Paola Dalla, Paolo Fantozzi, Maurizio Naldi, Placido Pellegriti. "Looking for Lexical Signatures in Gomorrah".
+45. (2024). "Understand tokens". Microsoft Learn.
diff --git a/docs/knowledge/v3_narratology/bibliography-balestri-2025.md b/docs/knowledge/v3_narratology/bibliography-balestri-2025.md
new file mode 100644
index 0000000..37bb3b5
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bibliography-balestri-2025.md
@@ -0,0 +1,48 @@
+---
+type: bibliography
+project: tvplotlines
+status: active
+source_paper: "[[balestri-pescatore-2025-icaart]]"
+total_references: 32
+retrieved_via: Semantic Scholar API
+retrieved_date: 2026-04-10
+---
+
+# Bibliography: Balestri & Pescatore (2025) — Multi-Agent System for Narrative Arcs in TV Series
+
+Complete bibliography extracted from "Multi-Agent System for AI-Assisted Extraction of Narrative Arcs in TV Series" (ICAART 2025, arXiv:2503.04817).
+
+## References
+
+1. Renyi Qu, Ruixuan Tu, F. Bao (2024). "Is Semantic Chunking Worth the Computational Cost?". arXiv. arXiv: 2410.13070
+2. Weikang Yuan, Junjie Cao, Zhuoren Jiang et al. (2024). "Can Large Language Models Grasp Legal Theories? Enhance Legal Reasoning with Insights from Multi-Agent Collaboration". EMNLP. arXiv: 2410.02507
+3. Alireza Ghafarollahi, Markus J. Buehler (2024). "SciAgents: Automating scientific discovery through multi-agent intelligent graph reasoning". arXiv. arXiv: 2409.05556
+4. Markus Laukkanen (2024). "Audience-authored paratexts: legitimation of online discourse about Game of Thrones". Frontiers of Narrative Studies. DOI: 10.1515/fns-2024-2003
+5. Naoto Aoki, Naoki Mori, M. Okada (2023). "Analysis of LLM-Based Narrative Generation Using the Agent-Based Simulation". IIAI-AAI-Winter. DOI: 10.1109/IIAI-AAI-Winter61682.2023.00059
+6. Runcong Zhao, Wenjia Zhang, Jiazheng Li et al. (2023). "NarrativePlay: Interactive Narrative Understanding". EACL. arXiv: 2310.01459
+7. A. Piper, Olivier Toubia (2023). "A quantitative study of non-linearity in storytelling". Poetics. DOI: 10.1016/j.poetic.2023.101793
+8. M. Rocchi, G. Pescatore (2022). "Modeling narrative features in TV series: coding and clustering analysis". Humanities and Social Sciences Communications. DOI: 10.1057/s41599-022-01352-9
+9. Milán Janosov (2021). "Network Science Predicts Who Dies Next in Game of Thrones". arXiv. arXiv: 2110.09856
+10. William J. Grange (2020). "The narrative". The Business of American Theatre. DOI: 10.4324/9781003026464-2
+11. Patrick Lewis, Ethan Perez, Aleksandara Piktus et al. (2020). "Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks". NeurIPS. arXiv: 2005.11401
+12. David Wilmot, Frank Keller (2020). "Modelling Suspense in Short Stories as Uncertainty Reduction over Neural Representation". ACL. arXiv: 2004.14905
+13. Tom Young, Devamanyu Hazarika, Soujanya Poria, E. Cambria (2017). "Recent Trends in Deep Learning Based Natural Language Processing". IEEE Computational Intelligence Magazine. arXiv: 1708.02709
+14. Ashish Vaswani, Noam Shazeer, Niki Parmar et al. (2017). "Attention is All you Need". NeurIPS. arXiv: 1706.03762
+15. Wenpeng Yin, Katharina Kann, Mo Yu, Hinrich Schütze (2017). "Comparative Study of CNN and RNN for Natural Language Processing". arXiv. arXiv: 1702.01923
+16. A. J. Reagan, Lewis Mitchell, Dilan Kiley, C. Danforth, P. Dodds (2016). "The emotional arcs of stories are dominated by six basic shapes". EPJ Data Science. arXiv: 1606.07772
+17. Xavier Bost, Vincent Labatut, Serigne Gueye, Georges Linarès (2016). "Narrative smoothing: Dynamic conversational network for the analysis of TV series plots". ASONAM. arXiv: 1602.07811
+18. Benjamin M. Schmidt (2015). "Plot arceology: A vector-space model of narrative structure". IEEE Big Data. DOI: 10.1109/BigData.2015.7363937
+19. Jason Mittell (2015). "Complex TV: The Poetics of Contemporary Television Storytelling".
+20. Ingo Steinwart, A. Christmann (2008). "Support vector machines". Data Mining and Knowledge Discovery Handbook. DOI: 10.1002/wics.49
+21. T. Todorov, Arnold A. Weinstein (1969). "Structural Analysis of Narrative".
+22. (2024). "Understand tokens". Microsoft Learn.
+23. (2023). "Exploring tv seriality and television studies through data-driven approaches". Audiovisual Data: Data-Driven Perspectives for Media Studies.
+24. Andrew Piper, R. So, David Bamman (2021). "Narrative Theory for Computational Narrative Understanding". EMNLP. DOI: 10.18653/v1/2021.emnlp-main.26
+25. (2021). "Multi-plot structure in television serials". Cognition, Emotion, and Aesthetics in Contemporary Serial Television.
+26. (2019). "Postclassical narratology: Twenty years later". Word and Text.
+27. (2019). "Narration in medical dramas i. interpretative hypotheses and research perspectives". La valle dell'eden.
+28. Alec Radford, Karthik Narasimhan (2018). "Improving Language Understanding by Generative Pre-Training".
+29. Sibelan Forrester (2012). "The Russian Folktale by Vladimir Yakolevich Propp".
+30. G. Genette, J. Lewin, Richard A. Macksey (1997). "Paratexts: Thresholds of Interpretation".
+31. L. Dowling (1983). "Semiotics and Language: An Analytical Dictionary".
+32. Suphakit Niwattanakul et al. "Using of Jaccard Coefficient for Keywords Similarity".
diff --git a/docs/knowledge/v3_narratology/bibliography-hamilton-2025.md b/docs/knowledge/v3_narratology/bibliography-hamilton-2025.md
new file mode 100644
index 0000000..314acfc
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bibliography-hamilton-2025.md
@@ -0,0 +1,101 @@
+---
+type: bibliography
+project: tvplotlines
+status: active
+source_paper: "[[hamilton-2025-narrabench]]"
+total_references: 85
+retrieved_via: Semantic Scholar API
+retrieved_date: 2026-04-11
+---
+
+# Bibliography: Hamilton et al. (2025) — NarraBench
+
+Complete bibliography extracted from "NarraBench: A Comprehensive Framework for Narrative Benchmarking" (EACL 2026, arXiv:2510.09869).
+
+## References
+
+1. Matteo Marcuzzo et al. (2025). "MORABLES: A Benchmark for Assessing Abstract Moral Reasoning in LLMs with Fables". EMNLP. arXiv: 2509.12371
+2. Kabir Ahuja, Melanie Sclar, Yulia Tsvetkov (2025). "Finding Flawed Fictions: Evaluating Complex Reasoning via Plot Hole Detection". arXiv. arXiv: 2504.11900
+3. Rebecca M. M. Hicke, Sil Hamilton, David Mimno (2025). "The Zero Body Problem: Probing LLM Use of Sensory Language". arXiv. arXiv: 2504.06393
+4. Victor Wang, Michael J.Q. Zhang, Eunsol Choi (2025). "Improving LLM-as-a-Judge Inference with the Judgment Distribution". EMNLP. arXiv: 2503.03064
+5. Albert Gong et al. (2025). "PhantomWiki: On-Demand Datasets for Reasoning and Retrieval Evaluation". ICML. arXiv: 2502.20377
+6. Xintao Wang et al. (2025). "CoSER: Comprehensive Literary Dataset for LLM Role-Playing". arXiv. arXiv: 2502.09082
+7. Ali Modarressi et al. (2025). "NoLiMa: Long-Context Evaluation Beyond Literal Matching". ICML. arXiv: 2502.05167
+8. Haitao Li et al. (2024). "LLMs-as-Judges: A Comprehensive Survey". arXiv. arXiv: 2412.05579
+9. Sijun Tan et al. (2024). "JudgeBench: A Benchmark for Evaluating LLM-based Judges". ICLR. arXiv: 2410.12784
+10. David Herel et al. (2024). "Time Awareness in LLMs: Benchmarking Fact Recall Across Time". arXiv. arXiv: 2409.13338
+11. Funing Yang, Carolyn J. Anderson (2024). "Evaluating Computational Representations of Character: Austen Benchmark". NLP4DH. arXiv: 2408.16131
+12. Zhao-yu Su et al. (2024). "ConflictBank: Evaluating Knowledge Conflicts in LLM". NeurIPS. arXiv: 2408.12076
+13. John Mendonça et al. (2024). "Soda-Eval: Open-Domain Dialogue Evaluation". EMNLP. arXiv: 2408.10902
+14. Yufei Tian et al. (2024). "Are LLMs Capable of Generating Human-Level Narratives?". EMNLP. arXiv: 2407.13248
+15. Melanie Subbiah et al. (2024). "STORYSUMM: Evaluating Faithfulness in Story Summarization". EMNLP. arXiv: 2407.06501
+16. Marzena Karpinska et al. (2024). "One Thousand and One Pairs: long-context language models". EMNLP. arXiv: 2406.16264
+17. João Monteiro et al. (2024). "RepLiQA: QA for Benchmarking LLMs on Unseen Content". NeurIPS. arXiv: 2406.11811
+18. Bahare Fatemi et al. (2024). "Test of Time: Evaluating LLMs on Temporal Reasoning". ICLR. arXiv: 2406.06565
+19. Jinjie Ni et al. (2024). "MixEval: Deriving Wisdom of the Crowd from LLM Benchmark Mixtures". NeurIPS. arXiv: 2406.06565
+20. Deepa Tilwani et al. (2024). "Attribution in Scientific Literature: New Benchmark". arXiv. arXiv: 2405.02228
+21. Cunxiang Wang et al. (2024). "NovelQA: Benchmarking QA on Documents Exceeding 200K Tokens". ICLR. arXiv: 2403.12766
+22. Xinpeng Wang et al. (2024). "First-Token Probabilities Do Not Match Text Answers". ACL. arXiv: 2402.14499
+23. Nishant Balepur et al. (2024). "Artifacts or Abduction: LLMs Answer MCQ Without the Question". ACL. arXiv: 2402.12483
+24. Hao Wang et al. (2024). "LLMs May Perform MCQA by Selecting the Least Incorrect Option". COLING. arXiv: 2402.01349
+25. Norah A. Alzahrani et al. (2024). "When Benchmarks are Targets: Sensitivity of LLM Leaderboards". ACL. arXiv: 2402.01781
+26. Keming Lu et al. (2024). "LLMs are Superpositions of All Characters: Arbitrary Role-play via Self-Alignment". ACL. arXiv: 2401.12474
+27. Maria Antoniak et al. (2023). "Where Do People Tell Stories Online?". ACL. arXiv: 2311.09675
+28. Jiao Ou et al. (2023). "DialogBench: Evaluating LLMs as Human-like Dialogue Systems". NAACL. arXiv: 2311.01677
+29. Lixing Zhu et al. (2023). "Are NLP Models Good at Tracing Thoughts: Overview of Narrative Understanding". EMNLP. arXiv: 2310.18783
+30. Hyunwoo Kim et al. (2023). "FANToM: Stress-testing Machine Theory of Mind". EMNLP. arXiv: 2310.15421
+31. Yapei Chang et al. (2023). "BooookScore: book-length summarization in era of LLMs". ICLR. arXiv: 2310.00785
+32. Tianyi Zhang et al. (2023). "Human-in-the-loop Schema Induction". ACL. DOI: 10.18653/v1/2023.acl-demo.1
+33. Chao Zhao et al. (2022). "NarraSum: Large-Scale Dataset for Abstractive Narrative Summarization". EMNLP. arXiv: 2212.01476
+34. Xiaozhi Wang et al. (2022). "MAVEN-ERE: Unified Dataset for Event Coreference, Temporal, Causal Relations". EMNLP. arXiv: 2211.07342
+35. Andrei Manolache et al. (2022). "VeriDark: Large-Scale Benchmark for Authorship Verification". NeurIPS. arXiv: 2207.03477
+36. Aarohi Srivastava et al. (2022). "Beyond the Imitation Game (BIG-bench)". arXiv. arXiv: 2206.04615
+37. Jon Chun (2021). "SentimentArcs: Self-Supervised Sentiment Analysis of Time Series". arXiv. arXiv: 2110.09454
+38. Qing Lyu et al. (2021). "Goal-Oriented Script Construction". INLG. DOI: 10.18653/v1/2021.inlg-1.19
+39. Jialong Tang et al. (2021). "From Discourse to Narrative: Knowledge Projection for Event Relation Extraction". ACL. DOI: 10.18653/v1/2021.acl-long.60
+40. Li Lucy, David Bamman (2021). "Gender and Representation Bias in GPT-3 Generated Stories". NUSE.
+41. Dan Hendrycks et al. (2020). "Measuring Massive Multitask Language Understanding (MMLU)". ICLR. arXiv: 2009.03300
+42. A. R. Fabbri et al. (2020). "SummEval: Re-evaluating Summarization Evaluation". TACL. DOI: 10.1162/tacl_a_00373
+43. Swapna Somasundaran et al. (2020). "Emotion Arcs of Student Narratives". NUSE. DOI: 10.18653/v1/2020.nuse-1.12
+44. Anton Belyy, Benjamin Van Durme (2020). "Script Induction as Association Rule Mining". NUSE.
+45. Timothy R. Tangherlini et al. (2020). "Automated pipeline for conspiracy narrative frameworks". PLoS ONE. DOI: 10.1371/journal.pone.0233879
+46. Matthew Sims, David Bamman (2020). "Measuring Information Propagation in Literary Social Networks". EMNLP.
+47. Maria Antoniak et al. (2019). "Narrative Paths and Negotiation of Power in Birth Stories". CSCW. DOI: 10.1145/3359190
+48. Matthew Sims et al. (2019). "Literary Event Detection". ACL. DOI: 10.18653/v1/P19-1353
+49. Rowan Zellers et al. (2019). "HellaSwag: Can a Machine Really Finish Your Sentence?". ACL.
+50. Joseph Worsham, J. Kalita (2018). "Genre Identification and the Compositional Effect of Genre in Literature". COLING.
+51. Tommaso Caselli, P. Vossen (2017). "The Event StoryLine Corpus". NEWS@ACL. DOI: 10.18653/v1/W17-2711
+52. K. Oatley (2016). "Fiction: Simulation of Social Worlds". Trends in Cognitive Sciences. DOI: 10.1016/j.tics.2016.06.002
+53. A. J. Reagan et al. (2016). "The emotional arcs of stories are dominated by six basic shapes". EPJ Data Science.
+54. Marie-Laure Ryan et al. (2016). "Narrating Space / Spatializing Narrative".
+55. Nils Reiter et al. (2014). "An NLP-based cross-document approach to narrative structure discovery". Literary and Linguistic Computing. DOI: 10.1093/llc/fqu055
+56. Niranjan Balasubramanian et al. (2013). "Generating Coherent Event Schemas at Scale". EMNLP.
+57. P. Hogan (2011). "Affective Narratology: The Emotional Structure of Stories".
+58. Nathanael Chambers, Dan Jurafsky (2010). "A Database of Narrative Schemas". LREC.
+59. G. Freytag (2010 reprint). "Freytag's Technique of the Drama".
+60. Nathanael Chambers, Dan Jurafsky (2009). "Unsupervised Learning of Narrative Schemas and their Participants". ACL.
+61. Nathanael Chambers, Dan Jurafsky (2008). "Unsupervised Learning of Narrative Event Chains". ACL.
+62. Chin-Yew Lin (2004). "ROUGE: A Package for Automatic Evaluation of Summaries". ACL.
+63. D. McAdams et al. (2001). "Sequences of Redemption and Contamination in Life Narrative". DOI: 10.1177/0146167201274008
+64. Collin F. Baker et al. (1998). "The Berkeley FrameNet Project". ACL.
+65. G. Genette (1997). "Palimpsests: Literature in the Second Degree".
+66. Meir Sternberg (1992). "Telling in Time (II): Chronology, Teleology, Narrativity". DOI: 10.2307/1772872
+67. J. Bruner (1991). "The Narrative Construction of Reality". Critical Inquiry.
+68. Paul Ricoeur (1988). "Time and Narrative, Volume 1". DOI: 10.7208/chicago/9780226713533.001.0001
+69. Lane Gormley / Julia Kristeva (1984). "Desire in Language: A Semiotic Approach to Literature and Art".
+70. W. Brewer, Edward H. Lichtenstein (1982). "Stories Are to Entertain: A Structural-Affect Theory of Stories".
+71. Kai He et al. (2025). "Crab: A Novel Configurable Role-Playing LLM with Assessing Benchmark". ACL.
+72. Andrew Piper, Sunyam Bagga (2025). "NarraDetect: annotated dataset for narrative detection". WNU.
+73. Axel Pichler et al. (2025). "Evaluating LLM-Prompting for Sequence Labeling in Computational Literary Studies". LaTeCH-CLfL.
+74. Svenja Kenneweg et al. (2024). "Benchmarking LLMs to Reason About Event Sets". KEOD.
+75. Zhilin Wang et al. (2022). "Uncovering Surprising Event Boundaries in Narratives". WNU.
+76. Andrew Piper, R. So, David Bamman (2021). "Narrative Theory for Computational Narrative Understanding". EMNLP.
+77. Melissa Roemmele (2019). "Identifying Sensible Lexical Relations in Generated Stories". WNU.
+78. A. Baer / G. Genette (2016 reprint). "Narrative Discourse: An Essay in Method".
+79. R. Mar (2011). "The neural bases of social cognition and story comprehension". Annual Review of Psychology.
+80. J. Alber, M. Fludernik (2010). "Postclassical Narratology: Approaches and Analyses".
+81. D. Herman (2009). "Basic elements of narrative".
+82. W. Labov, J. Waletzky (1997). "Narrative analysis: Oral versions of personal experience".
+83. E. Kahn (1973). "Finite-state models of plot complexity". Poetics.
+84. Lee T. Lemon, Marion J. Reis (1968). "Russian formalist criticism: four essays".
+85. Katherine Elkins (2022). "The Shapes of Stories". Cambridge University Press.
diff --git a/docs/knowledge/v3_narratology/bibliography-keith-2025.md b/docs/knowledge/v3_narratology/bibliography-keith-2025.md
new file mode 100644
index 0000000..0799467
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bibliography-keith-2025.md
@@ -0,0 +1,117 @@
+---
+type: bibliography
+project: tvplotlines
+status: active
+source_paper: "[[keith-2025-interactive-narrative-analytics]]"
+total_references: 99
+retrieved_via: Semantic Scholar API
+retrieved_date: 2026-04-10
+---
+
+# Bibliography: Keith (2025) — Interactive Narrative Analytics
+
+Complete bibliography extracted from "Interactive Narrative Analytics: Bridging Computational Narrative Extraction and Human Sensemaking" (IEEE Access, arXiv:2601.11459).
+
+**Note:** Эта библиография сильно отличается от остальных seed-статей. Фокус не на нарратологии, а на visual analytics + misinformation + sensemaking. Нарратологических ссылок минимум. Основной кластер — information visualization, fact-checking, human-AI interaction.
+
+## References
+
+1. Arghodeep Nandi et al. (2025). "The Psychology of Falsehood: A Human-Centric Survey of Misinformation Detection". EMNLP. arXiv: 2509.15896
+2. Brian Felipe Keith-Norambuena et al. (2025). "Explainable AI Components for Narrative Map Extraction". Text2Story@ECIR. arXiv: 2503.16554
+3. Simona Frenda et al. (2024). "Perspectivist approaches to natural language processing: a survey". Language Resources and Evaluation. DOI: 10.1007/s10579-024-09766-4
+4. Gabriela Molina León et al. (2024). "Talk to the Wall: The Role of Speech Interaction in Collaborative Visual Analytics". IEEE TVCG. arXiv: 2408.03813
+5. Jie Fu et al. (2024). "Differentially Private Federated Learning: A Systematic Review". arXiv. arXiv: 2405.08299
+6. Michelle Vaccaro et al. (2024). "When combinations of humans and AI are useful: A systematic review and meta-analysis". Nature Human Behaviour. DOI: 10.1038/s41562-024-02024-1
+7. Yuheng Zhao et al. (2024). "LEVA: Using Large Language Models to Enhance Visual Analytics". IEEE TVCG. arXiv: 2403.05816
+8. M. T. Fischer et al. (2024). "MULTI-CASE: A Transformer-based Ethics-aware Multimodal Investigative Intelligence Framework". arXiv. arXiv: 2401.01955
+9. Alex Ulmer et al. (2023). "A Survey on Progressive Visualization". IEEE TVCG. DOI: 10.1109/TVCG.2023.3346641
+10. Yuxiang Zhou, Yulan He (2023). "Causal Inference from Text: Unveiling Interactions between Variables". EMNLP. arXiv: 2311.05286
+11. Huimin Han et al. (2023). "Explainable interactive projections of images". Machine Vision and Applications. DOI: 10.1007/s00138-023-01452-9
+12. Isabel O. Gallegos et al. (2023). "Bias and Fairness in Large Language Models: A Survey". Computational Linguistics. arXiv: 2309.00770
+13. Yu-Chu Chang et al. (2023). "A Survey on Evaluation of Large Language Models". ACM TIST. arXiv: 2307.03109
+14. Lianwei Wu et al. (2023). "MFIR: Multimodal fusion and inconsistency reasoning for explainable fake news detection". Information Fusion. DOI: 10.1016/j.inffus.2023.101944
+15. Lin F. Yang et al. (2023). "Give us the Facts: Enhancing LLMs With Knowledge Graphs". IEEE TKDE. arXiv: 2306.11489
+16. Tim Dettmers et al. (2023). "QLoRA: Efficient Finetuning of Quantized LLMs". NeurIPS. arXiv: 2305.14314
+17. M. Schlichtkrull et al. (2023). "AVeriTeC: A Dataset for Real-world Claim Verification". NeurIPS. arXiv: 2305.13117
+18. Eve Fleisig et al. (2023). "When the Majority is Wrong: Modeling Annotator Disagreement for Subjective Tasks". EMNLP. arXiv: 2305.06626
+19. Elisa Leonardelli et al. (2023). "SemEval-2023 Task 11: Learning with Disagreements". SemEval. arXiv: 2304.14803
+20. Zhihua Yan, Xijin J. Tang (2023). "Narrative Graph: Telling Evolving Stories Based on Event-centric Temporal Knowledge Graph". J. Systems Science. DOI: 10.1007/s11518-023-5561-0
+21. Brian Felipe Keith-Norambuena et al. (2023). "A Survey on Event-Based News Narrative Extraction". ACM Computing Surveys. arXiv: 2302.08351
+22. Brian Felipe Keith-Norambuena et al. (2023). "Mixed Multi-Model Semantic Interaction for Graph-based Narrative Visualizations". IUI. arXiv: 2302.06452
+23. Esma Aïmeur et al. (2023). "Fake news, disinformation and misinformation in social media: a review". Social Network Analysis and Mining. DOI: 10.1007/s13278-023-01028-5
+24. Brenda Salenave Santana et al. (2023). "A survey on narrative extraction from textual data". AI Review. DOI: 10.1007/s10462-022-10338-7
+25. Zeming Chen et al. (2022). "DISCO: Distilling Counterfactuals with Large Language Models". ACL. arXiv: 2212.10534
+26. K. Liang et al. (2022). "A Survey of Knowledge Graph Reasoning on Graph Types". IEEE TPAMI. arXiv: 2212.05767
+27. Oberiri Destiny Apuke et al. (2022). "Information overload and misinformation sharing behaviour". J. Information Science. DOI: 10.1177/01655515221121942
+28. Qing Chen et al. (2022). "How Does Automation Shape the Process of Narrative Visualization: A Survey of Tools". IEEE TVCG. arXiv: 2206.12118
+29. Shivani Choudhary et al. (2022). "Interpretation of Black Box NLP Models: A Survey". arXiv. arXiv: 2203.17081
+30. M. T. Fischer et al. (2022). "Promoting Ethical Awareness in Communication Analysis". FAccT. arXiv: 2203.09859
+31. Paul Röttger et al. (2021). "Two Contrasting Data Annotation Paradigms for Subjective NLP Tasks". NAACL Findings. arXiv: 2112.01640
+32. C. Trojahn et al. (2021). "Foundational ontologies meet ontology matching: A survey". Semantic Web. DOI: 10.3233/sw-210447
+33. Zhijing Jin et al. (2021). "Causal Direction of Data Collection Matters". EMNLP. arXiv: 2110.03618
+34. John E. Wenskovitch et al. (2021). "Beyond Visual Analytics: Human-Machine Teaming for AI-Driven Data Sensemaking". IEEE TREX. DOI: 10.1109/TREX53765.2021.00012
+35. Leixian Shen et al. (2021). "Towards Natural Language Interfaces for Data Visualization: A Survey". IEEE TVCG. arXiv: 2109.03506
+36. Mark Wallinger et al. (2021). "Edge-Path Bundling". IEEE TVCG. arXiv: 2108.05467
+37. J. Hu et al. (2021). "LoRA: Low-Rank Adaptation of Large Language Models". ICLR. arXiv: 2106.09685
+38. Tommaso Fornaciari et al. (2021). "Beyond Black & White: Leveraging Annotator Disagreement via Soft-Label Multi-Task Learning". NAACL. DOI: 10.18653/V1/2021.NAACL-MAIN.204
+39. Brian Lester et al. (2021). "The Power of Scale for Parameter-Efficient Prompt Tuning". EMNLP. arXiv: 2104.08691
+40. Yail Bian, Chris North (2021). "DeepSI: Interactive Deep Learning for Semantic Interaction". IUI. arXiv: 2305.18357
+41. Batya Friedman et al. (2021). "Eight grand challenges for value sensitive design". Ethics and Information Technology. DOI: 10.1007/s10676-021-09586-y
+42. Tongshuang Sherry Wu et al. (2021). "Polyjuice: Generating Counterfactuals for Explaining, Evaluating, and Improving Models". ACL. arXiv: 2101.00288
+43. Hila Chefer et al. (2020). "Transformer Interpretability Beyond Attention Visualization". CVPR. arXiv: 2012.09838
+44. S. Soroya et al. (2020). "From information seeking to information avoidance". Information Processing & Management. DOI: 10.1016/j.ipm.2020.102440
+45. E. Cakmak et al. (2020). "Multiscale Snapshots: Visual Analysis of Temporal Summaries in Dynamic Graphs". IEEE TVCG. arXiv: 2008.08282
+46. John E. Wenskovitch, Chris North (2020). "Interactive Artificial Intelligence: Designing for the 'Two Black Boxes' Problem". Computer. DOI: 10.1109/MC.2020.2996416
+47. Weikai Yang et al. (2020). "Interactive Steering of Hierarchical Clustering". IEEE TVCG. arXiv: 2009.09618
+48. A. Vivacqua et al. (2019). "Explanations and sensemaking with AI and HCI". IX Latin American Conference on HCI. DOI: 10.1145/3358961.3359004
+49. Michelle Dowling et al. (2019). "Interactive Visual Analytics for Sensemaking with Big Text". Big Data Research. DOI: 10.1016/J.BDR.2019.04.003
+50. Chang Sup Park (2019). "Does Too Much News on Social Media Discourage News Seeking?". Social Media + Society. DOI: 10.1177/2056305119872956
+51. J. Ansah et al. (2019). "A Graph is Worth a Thousand Words: Telling Event Stories using Timeline Summarization Graphs". WWW. DOI: 10.1145/3308558.3313396
+52. Margaret Mitchell et al. (2018). "Model Cards for Model Reporting". FAccT. DOI: 10.1145/3287560.3287596
+53. Peter Gordon Roetzel (2018). "Information overload in the information age: a review". Business Research. DOI: 10.1007/S40685-018-0069-Z
+54. M. Angelini et al. (2018). "A Review and Characterization of Progressive Visual Analytics". Informatics. DOI: 10.3390/informatics5030031
+55. L. Bietti et al. (2018). "Storytelling as Adaptive Collective Sensemaking". Topics in Cognitive Science. DOI: 10.1111/tops.12358
+56. Emanuel Zgraggen et al. (2018). "Investigating the Effect of the Multiple Comparisons Problem in Visual Analysis". CHI. DOI: 10.1145/3173574.3174053
+57. Timnit Gebru et al. (2018). "Datasheets for datasets". Communications of the ACM. DOI: 10.1145/3458723
+58. James Thorne et al. (2018). "FEVER: a Large-scale Dataset for Fact Extraction and VERification". NAACL. DOI: 10.18653/v1/N18-1074
+59. D. Lazer et al. (2018). "The science of fake news". Science. DOI: 10.1126/science.aao2998
+60. S. Vosoughi et al. (2018). "The spread of true and false news online". Science. DOI: 10.1126/science.aap9559
+61. Bang Liu et al. (2017). "Growing Story Forest Online from Massive Breaking News". CIKM. DOI: 10.1145/3132847.3132852
+62. Manu Shukla et al. (2017). "DISCRN: A Distributed Storytelling Framework for Intelligence Analysis". Big Data. DOI: 10.1089/big.2017.0025
+63. Antoine Lhuillier et al. (2017). "State of the Art in Edge and Trail Bundling Techniques". Computer Graphics Forum. DOI: 10.1111/cgf.13213
+64. Jean-Daniel Fekete, Romain Primet (2016). "Progressive Analytics: A Computation Paradigm for Exploratory Data Analysis". arXiv. arXiv: 1607.05162
+65. Marco Tulio Ribeiro et al. (2016). "Why Should I Trust You?: Explaining the Predictions of Any Classifier (LIME)". NAACL. DOI: 10.1145/2939672.2939778
+66. Amir Gandomi, Murtaza Haider (2015). "Beyond the hype: Big data concepts, methods, and analytics". IJIM. DOI: 10.1016/J.IJINFOMGT.2014.10.007
+67. Charles D. Stolper et al. (2014). "Progressive Visual Analytics: User-Driven Visual Exploration". IEEE TVCG. DOI: 10.1109/TVCG.2014.2346574
+68. Dafna Shahaf et al. (2013). "Information cartography: creating zoomable, large-scale maps of information". KDD. DOI: 10.1145/2487575.2487690
+69. S. Lewis et al. (2013). "Content Analysis in an Era of Big Data: A Hybrid Approach". DOI: 10.1080/08838151.2012.761702
+70. A. Endert et al. (2012). "Semantic interaction for visual text analytics". CHI. DOI: 10.1145/2207676.2207741
+71. A. Endert et al. (2011). "Observation-level interaction with statistical models for visual analytics". IEEE VAST. DOI: 10.1109/VAST.2011.6102449
+72. Milos Krstajic et al. (2011). "CloudLines: Compact Display of Event Episodes in Multiple Time-Series". IEEE TVCG. DOI: 10.1109/TVCG.2011.179
+73. Sarah Cohen et al. (2011). "Computational journalism". Communications of the ACM. DOI: 10.1145/2001269.2001288
+74. Rui Yan et al. (2011). "Evolutionary timeline summarization". SIGIR. DOI: 10.1145/2009916.2010016
+75. Y. Lerner et al. (2011). "Topographic Mapping of a Hierarchy of Temporal Receptive Windows Using a Narrated Story". J. Neuroscience. DOI: 10.1523/JNEUROSCI.3684-10.2011
+76. E. Segel, Jeffrey Heer (2010). "Narrative Visualization: Telling Stories with Data". IEEE TVCG. DOI: 10.1109/TVCG.2010.179
+77. Christopher Andrews et al. (2010). "Space to think: large high-resolution displays for sensemaking". CHI. DOI: 10.1145/1753326.1753336
+78. W. Pike et al. (2009). "The Science of Interaction". Information Visualization. DOI: 10.1057/ivs.2009.22
+79. D. Fair et al. (2007). "Development of distinct control networks through segregation and integration". PNAS. DOI: 10.1073/pnas.0705843104
+80. H. Slagter et al. (2007). "Mental Training Affects Distribution of Limited Brain Resources". PLoS Biology. DOI: 10.1371/journal.pbio.0050138
+81. G. Repovš, A. Baddeley (2006). "The multi-component model of working memory". Neuroscience. DOI: 10.1016/J.NEUROSCIENCE.2005.12.061
+82. Hai Leong Chieu, Yoong Keok Lee (2004). "Query based event extraction along a timeline". SIGIR. DOI: 10.1145/1008992.1009065
+83. Martin J. Eppler, J. Mengis (2004). "The Concept of Information Overload". The Information Society. DOI: 10.1080/01972240490507974
+84. T. Davenport, John C. Beck (2001). "The Attention economy". UBIQ. DOI: 10.1145/376625.376626
+85. Rolf A. Zwaan, G. Radvansky (1998). "Situation models in language comprehension and memory". Psychological Bulletin. DOI: 10.1037/0033-2909.123.2.162
+86. W. Kintsch (1998). "Comprehension: A Paradigm for Cognition".
+87. B. Shneiderman (1996). "The eyes have it: a task by data type taxonomy for information visualizations". IEEE VL. DOI: 10.1109/VL.1996.545307
+88. P. Pirolli, S. Card (1995). "Information foraging in information access environments". CHI. DOI: 10.1145/223904.223911
+89. M. Ford, P. Johnson-Laird (1985). "Mental Models: Towards a Cognitive Science of Language, Inference, and Consciousness". DOI: 10.2307/414498
+90. J. Bruner (1985). "Actual minds, possible worlds". DOI: 10.2307/2905728
+91. Witold Sosnowski et al. (2025). "DiNaM: Disinformation Narrative Mining with Large Language Models". EMNLP. DOI: 10.18653/v1/2025.emnlp-main.1537
+92. Alessia Cosentino et al. (2025). "Source Credibility Assessment in the Realm of Information Disorder". IJIMAI. DOI: 10.9781/ijimai.2025.01.002
+93. Zhengyuan Zhu et al. (2025). "RATSD: Retrieval Augmented Truthfulness Stance Detection". NAACL Findings. DOI: 10.18653/v1/2025.findings-naacl.187
+94. Achyutarama R. Ganti et al. (2023). "Narrative Style and the Spread of Health Misinformation on Twitter". EMNLP Findings. DOI: 10.18653/v1/2023.findings-emnlp.282
+95. R. Porzel et al. (2022). "Narrativizing Knowledge Graphs". AI4LEGAL/KGSum@ISWC.
+96. P. Ranade et al. (2022). "Computational Understanding of Narratives: A Survey". IEEE Access. DOI: 10.1109/ACCESS.2022.3205314
+97. Inès Blin (2022). "Building Narrative Structures from Knowledge Graphs". ESWC. DOI: 10.1007/978-3-031-11609-4_38
+98. E. Mosca et al. (2022). "SHAP-Based Explanation Methods: A Review for NLP Interpretability". COLING.
+99. Xiang Lisa Li, Percy Liang (2021). "Prefix-Tuning: Optimizing Continuous Prompts for Generation". ACL. arXiv: 2104.08691
diff --git a/docs/knowledge/v3_narratology/bibliography-liu-2025.md b/docs/knowledge/v3_narratology/bibliography-liu-2025.md
new file mode 100644
index 0000000..5431d75
--- /dev/null
+++ b/docs/knowledge/v3_narratology/bibliography-liu-2025.md
@@ -0,0 +1,146 @@
+---
+type: bibliography
+project: tvplotlines
+status: active
+source_paper: "[[liu-2025-narrative-theory-survey]]"
+total_references: 146
+retrieved_via: Semantic Scholar API
+retrieved_date: 2026-04-10
+---
+
+# Bibliography: Liu et al. (2025) — Narrative Theory-Driven LLM Methods Survey
+
+Complete bibliography extracted from "Narrative Theory-Driven LLM Methods for Automatic Story Generation and Understanding: A Survey" (arXiv:2602.15851).
+
+## References
+
+1. Dingyi Yang, Qin Jin (2025). "What Matters in Evaluating Book-Length Stories? A Systematic Study of Long Story Evaluation". Annual Meeting of the Association for Computational Linguistics. DOI: 10.18653/v1/2025.acl-long.799
+2. Minju Kim, Dongje Yoo, Yeonjun Hwang, Minseok Kang, Namyoung Kim, Minju Gwak, Beong-woo Kwak, Hyungjoo Chae, Harim Kim, Yunjoong Lee, M. Kim, Dayi Jung, Kyong-Mee Chung, Jinyoung Yeo (2025). "Can You Share Your Story? Modeling Clients' Metacognition and Openness for LLM Therapist Evaluation". ACL Findings. DOI: 10.18653/v1/2025.findings-acl.1332
+3. Karin de Langis, Jong Inn Park, Andreas Schramm, Bin Hu, Khanh Chi Le, Dongyeop Kang (2025). "How LLMs Comprehend Temporal Meaning in Narratives: A Case Study in Cognitive Evaluation of LLMs". ACL. DOI: 10.18653/v1/2025.acl-long.1415
+4. Anneliese Brei, Katharine Henry, Abhisheik Sharma, Shashank Srivastava, Snigdha Chaturvedi (2025). "Classifying Unreliable Narrators with Large Language Models". ACL. arXiv: 2506.10231
+5. Jiaming Li, Yukun Chen, Ziqiang Liu, Minghuan Tan, Lei Zhang, Yunshui Li, Run Luo, Longze Chen, Jing Luo, A. Argha, H. Alinejad-Rokny, Wei Zhou, Min Yang (2025). "STORYTELLER: An Enhanced Plot-Planning Framework for Coherent and Cohesive Story Generation". ACL. arXiv: 2506.02347
+6. Yulia Otmakhova, Lea Frermann (2025). "Narrative Media Framing in Political Discourse". ACL. arXiv: 2506.00737
+7. Parsa Ghaffari, Chris Hokamp (2025). "Narrative Studio: Visual narrative exploration using LLMs and Monte Carlo Tree Search". WNU 2025. arXiv: 2504.02426
+8. Sil Hamilton, Rebecca M. M. Hicke, David Mimno, Matthew Wilkens (2025). "A City of Millions: Mapping Literary Social Networks At Scale". NLP4DH 2025. arXiv: 2502.19590
+9. Sneheel Sarangi, Maha Elgarf, Hanan Salam (2025). "Decompose-ToM: Enhancing Theory of Mind Reasoning in Large Language Models through Simulation and Task Decomposition". COLING. arXiv: 2501.09056
+10. Chulun Zhou, Qiujing Wang, Mo Yu, X. Yue, Rui Lu, Jiangnan Li, Yifan Zhou, Shunchi Zhang, Jie Zhou, Wai Lam (2025). "The Essence of Contextual Understanding in Theory of Mind: A Study on Question Answering with Story Characters". ACL. arXiv: 2501.01705
+11. V. Lenzi, Emanuele Lenzi, Claudio De Martino (2024). "Using large language models to create narrative events". PeerJ Computer Science. DOI: 10.7717/peerj-cs.2242
+12. Mourad Heddaya, Qingcheng Zeng, Chenhao Tan, Rob Voigt, Alexander K. Zentefis (2024). "Causal Micro-Narratives". WNU 2024. arXiv: 2410.05252
+13. Rohan Das, Aditya Chandra, Isabelle Lee, Maria Leonor Pacheco (2024). "Media Framing through the Lens of Event-Centric Narratives". WNU 2024. arXiv: 2410.03151
+14. Fantine Huot, Reinald Kim Amplayo, J. Palomaki, Alice Shoshana Jakobovits, Elizabeth Clark, Mirella Lapata (2024). "Agents' Room: Narrative Generation through Multi-step Collaboration". ICLR. arXiv: 2410.02603
+15. Minwook Bae, Hyounghun Kim (2024). "Collective Critics for Creative Story Generation". EMNLP. arXiv: 2410.02428
+16. Funing Yang, Carolyn J. Anderson (2024). "Evaluating Computational Representations of Character: An Austen Character Similarity Benchmark". NLP4DH. arXiv: 2408.16131
+17. Pranjal Kumar (2024). "Large language models (LLMs): survey, technical frameworks, and future challenges". Artificial Intelligence Review. DOI: 10.1007/s10462-024-10888-y
+18. Yufei Tian, Tenghao Huang, Miri Liu, Derek Jiang, Alexander Spangher, Muhao Chen, Jonathan May, Nanyun Peng (2024). "Are Large Language Models Capable of Generating Human-Level Narratives?". EMNLP. arXiv: 2407.13248
+19. Brett A. Halperin, Stephanie M Lukin (2024). "Artificial Dreams: Surreal Visual Storytelling as Inquiry Into AI 'Hallucination'". DIS. DOI: 10.1145/3643834.3660685
+20. Fabrice Harel-Canada, Hanyu Zhou, Sreya Muppalla, Zeynep Yildiz, Amit Sahai, Nanyun Peng (2024). "Measuring Psychological Depth in Language Models". EMNLP. arXiv: 2406.12680
+21. Peiqi Sui, Eamon Duede, Sophie Wu, R. So (2024). "Confabulation: The Surprising Value of Large Language Model Hallucinations". ACL. arXiv: 2406.04175
+22. Jocelyn Jiayue Shen, Joel Mire, Hae Won Park, C. Breazeal, Maarten Sap (2024). "HEART-felt Narratives: Tracing Empathy and Narrative Style in Personal Stories with LLMs". EMNLP. arXiv: 2405.17633
+23. Jocelyn Jiayue Shen, Y. Kim, Mohit Hulse, W. Zulfikar, Sharifa Alghowinem, C. Breazeal, Hae Won Park (2024). "EmpathicStories++: A Multimodal Dataset for Empathy towards Personal Experiences". ACL. arXiv: 2405.15708
+24. Cyril Chhun, Fabian M. Suchanek, Chloé Clavel (2024). "Do Language Models Enjoy Their Own Stories? Prompting Large Language Models for Automatic Story Evaluation". TACL. arXiv: 2405.13769
+25. Yuetian Chen, Mei Si (2024). "Reflections & Resonance: Two-Agent Partnership for Advancing LLM-based Story Annotation". LREC. DOI: 10.63317/26pt7cbt22fh
+26. Hans Ole Hatzel, Christian Biemann (2024). "Tell Me Again! a Large-Scale Dataset of Multiple Summaries for the Same Story". LREC. DOI: 10.63317/45vg69yzwt9e
+27. P. Gervás (2024). "Storytelling systems: Progress towards generation informed by models of the reader". Interdisciplinary Science Reviews. DOI: 10.1177/03080188241262862
+28. Hang Jiang, Xiajie Zhang, Robert Mahari, Daniel T Kessler, E. Ma, Tal August, Irene Li, A. Pentland, Yoon Kim, Jad Kabbara, Deb Roy (2024). "Leveraging Large Language Models for Learning Complex Legal Concepts through Storytelling". ACL. arXiv: 2402.17019
+29. Sil Hamilton (2024). "Detecting Mode Collapse in Language Models via Narration". SCALELLM. arXiv: 2402.04477
+30. Yidan Sun, Qin Chao, Boyang Albert Li (2023). "Event Causality Is Key to Computational Story Understanding". NAACL. arXiv: 2311.09648
+31. Maria Antoniak, Joel Mire, Maarten Sap, Elliott Ash, Andrew Piper (2023). "Where Do People Tell Stories Online? Story Detection Across Online Communities". ACL. arXiv: 2311.09675
+32. Nina Beguš (2023). "Experimental narratives: A comparison of human crowdsourced storytelling and AI storytelling". Humanities and Social Sciences Communications. DOI: 10.1057/s41599-024-03868-8
+33. Tuhin Chakrabarty, Philippe Laban, Divyansh Agarwal, S. Muresan, Chien-Sheng Wu (2023). "Art or Artifice? Large Language Models and the False Promise of Creativity". CHI. DOI: 10.1145/3613904.3642731
+34. Tarek Naous, Michael Joseph Ryan, Wei Xu (2023). "Having Beer after Prayer? Measuring Cultural Bias in Large Language Models". ACL. arXiv: 2305.14456
+35. Jocelyn Jiayue Shen, Maarten Sap, Pedro Colon-Hernandez, Hae Won Park, C. Breazeal (2023). "Modeling Empathic Similarity in Personal Narratives". EMNLP. arXiv: 2305.14246
+36. Xiaoxuan Fang, D. Ng, J. Leung, S. Chu (2023). "A systematic review of artificial intelligence technologies used for story writing". Education and Information Technologies. DOI: 10.1007/s10639-023-11741-5
+37. Zhuohan Xie, Trevor Cohn, Jey Han Lau (2023). "The Next Chapter: A Study of Large Language Models in Storytelling". INLG. arXiv: 2301.09790
+38. Michael Levin, Manoj Kumar, K. Norman, Mariya Toneva (2023). "Large language models can segment narrative events similarly to humans". arXiv. arXiv: 2301.10297
+39. Brenda Salenave Santana, Ricardo Campos, Evelin Amorim, A. Jorge, Purificação Silvano, Sérgio Nunes (2023). "A survey on narrative extraction from textual data". Artificial Intelligence Review. DOI: 10.1007/s10462-022-10338-7
+40. Yuxin Wang, Jieru Lin, Zhiwei Yu, Wei Hu, Börje F. Karlsson (2022). "Open-world Story Generation with Structured Knowledge Enhancement: A Comprehensive Survey". Neurocomputing. arXiv: 2212.04634
+41. Ivan P. Yamshchikov, Alexey Tikhonov (2022). "What is Wrong with Language Models that Can Not Tell a Story?". WNU. arXiv: 2211.05044
+42. Charles Condevaux, S. Harispe (2022). "LSG Attention: Extrapolation of pretrained Transformers to long sequences". PAKDD. arXiv: 2210.15497
+43. Andrew Piper, Sunyam Bagga (2022). "Toward a Data-Driven Theory of Narrativity". New Literary History. DOI: 10.1353/nlh.2022.a898332
+44. Cyril Chhun, Pierre Colombo, C. Clavel, Fabian M. Suchanek (2022). "Of Human Criteria and Automatic Metrics: A Benchmark of the Evaluation of Story Generation". COLING. arXiv: 2208.11646
+45. Katherine Elkins (2022). "The Shapes of Stories". DOI: 10.1017/9781009270403
+46. Ying Xu, Dakuo Wang, Mo Yu, Daniel Ritchie, Bingsheng Yao, Tongshuang Sherry Wu, Zheng Zhang, Toby Jia-Jun Li, Nora Bradford, Branda Sun, Tran Bao Hoang, Yisi Sang, Yufang Hou, Xiaojuan Ma, Diyi Yang, Nanyun Peng, Zhou Yu, M. Warschauer (2022). "Fantastic Questions and Where to Find Them: FairytaleQA — An Authentic Dataset for Narrative Comprehension". ACL. arXiv: 2203.13947
+47. Roberto Romani (2021). "Narrative economics: how stories go viral and drive major economic events". European Journal of the History of Economic Thought. DOI: 10.1080/09672567.2021.1928927
+48. Amal Alabdulkarim, Siyan Li, Xiangyu Peng (2021). "Automatic Story Generation: Challenges and Attempts". NUSE. arXiv: 2102.12634
+49. Zhilin Wang, Weizhe Lin, Xiaodong Wu (2020). "Learning Similarity between Movie Characters and Its Potential Implications on Understanding Human Experiences". NUSE. arXiv: 2010.12183
+50. Michael Levin (2020). "Cognitive". Definitions. DOI: 10.1007/978-3-642-28753-4_200398
+51. V. Shklovski (2019). "Art as Technique". From Symbolism to Socialist Realism. DOI: 10.1515/9781618111449-008
+52. Atef Chaudhury, Makarand Tapaswi, Seung Wook Kim, S. Fidler (2019). "The Shmoop Corpus: A Dataset of Stories with Loosely Aligned Summaries". arXiv. arXiv: 1912.13082
+53. Lianhui Qin, Antoine Bosselut, Ari Holtzman, Chandra Bhagavatula, Elizabeth Clark, Yejin Choi (2019). "Counterfactual Story Reasoning and Generation". EMNLP. DOI: 10.18653/v1/D19-1509
+54. Snigdha Chaturvedi, Shashank Srivastava, Dan Roth (2018). "Where Have I Heard This Story Before? Identifying Narrative Similarity in Movie Remakes". NAACL. DOI: 10.18653/v1/N18-2106
+55. Angela Fan, M. Lewis, Yann Dauphin (2018). "Hierarchical Neural Story Generation". ACL. DOI: 10.18653/v1/P18-1082
+56. Ruth E. Page (2018). "Narratives Online: Shared Stories in Social Media". DOI: 10.1017/9781316492390
+57. J. Ryan (2017). "Grimes' Fairy Tales: A 1960s Story Generator". ICIDS. DOI: 10.1007/978-3-319-71027-3_8
+58. Agnès Celle, Laure Lansari (2017). "Expressing and Describing Surprise". DOI: 10.1075/BCT.92
+59. Kobie van Krieken, H. Hoeken, J. Sanders (2017). "Evoking and Measuring Identification with Narrative Characters — A Linguistic Cues Framework". Frontiers in Psychology. DOI: 10.3389/fpsyg.2017.01190
+60. Paul A. Dawson, P. K. Hansen, John Pier, Philippe Roussin, W. Schmid (2017). "How Many 'Turns' Does it Take to Change a Discipline? Narratology and the Interdisciplinary Rhetoric of the Narrative Turn". DOI: 10.1515/9783110555158-020
+61. Jan-Noël Thon (2016). "Transmedial Narratology and Contemporary Media Culture". DOI: 10.2307/j.ctt1d8h8vn
+62. Jessica Ouyang, K. McKeown (2015). "Modeling Reportable Events as Turning Points in Narrative". EMNLP. DOI: 10.18653/v1/D15-1257
+63. G. McBride (2014). "Storytelling, behavior planning, and language evolution in context". Frontiers in Psychology. DOI: 10.3389/fpsyg.2014.01131
+64. A. Miskimmon, B. O'Loughlin, Laura Roselle (2013). "Strategic Narratives: Communication Power and the New World Order". DOI: 10.5860/choice.185594
+65. Roy Sommer (2012). "The Merger of Classical and Postclassical Narratologies and the Consolidated Future of Narrative Theory".
+66. P. H. Fry (2012). "Theory of Literature". DOI: 10.12987/9780300183368
+67. Anna De Fina, A. Georgakopoulou (2012). "Analyzing Narrative: Discourse and Sociolinguistic Perspectives".
+68. F. Moretti (2011). "Network theory, plot analysis".
+69. Zhiying Xin (2009). "Text World Theory: An Introduction".
+70. L. Patterson (2008). "Narrative Methods for the Human Sciences". DOI: 10.1108/17542410810897562
+71. G. Prince (2008). "Classical and/or Postclassical Narratology". DOI: 10.1353/ESP.0.0005
+72. Suzanne Keen (2006). "A Theory of Narrative Empathy". DOI: 10.1353/nar.2006.0015
+73. J. Matz (2005). "The One vs. the Many: Minor Characters and the Space of the Protagonist in the Novel". DOI: 10.1215/00267929-66-3-400
+74. F. Moretti (2005). "Graphs, Maps, Trees: Abstract Models for a Literary History".
+75. R. Dickman (2003). "THE FOUR ELEMENTS OF EVERY SUCCESSFUL STORY". DOI: 10.1162/15241730360580212
+76. David Herman (1997). "Scripts, Sequences, and Stories: Elements of a Postclassical Narratology". PMLA. DOI: 10.2307/463482
+77. D. Keefe, M. McDaniel (1993). "The time course and durability of predictive inferences". DOI: 10.1006/JMLA.1993.1024
+78. Martin Kreiswirth, H. White (1992). "Trusting the Tale: The Narrativist Turn in the Human Sciences". DOI: 10.2307/469223
+79. J. Bruner (1991). "The Narrative Construction of Reality". Critical Inquiry. DOI: 10.1086/448619
+80. Dina Sherzer, G. Prince (1989). "A dictionary of narratology". DOI: 10.2307/415368
+81. A. Ortony, D. Partridge (1987). "Surprisingness and Expectation Failure: What's the Difference?". IJCAI.
+82. T. Trabasso, P. Broek (1985). "Causal thinking and the representation of narrative events". DOI: 10.1016/0749-596X(85)90049-X
+83. G. Prince (1982). "Narratology". DOI: 10.1515/9783110838626
+84. S. Chatman (1979). "Story and Discourse: Narrative Structure in Fiction and Film". DOI: 10.2307/2906308
+85. Tzvetan Todorov (1971). "The 2 Principles of Narrative". DOI: 10.2307/464558
+86. V. Propp, Svatava Pirkova-Jakobson, L. Scott (1959). "Morphology of the folktale". DOI: 10.2307/538485
+87. Tian Yu, Ken Shi, Zixin Zhao, Gerald Penn (2025). "Multi-Agent Based Character Simulation for Story Writing". In2Writing 2025. DOI: 10.18653/v1/2025.in2writing-1.9
+88. Andrew Piper, Sophie Wu (2025). "Evaluating Large Language Models for Narrative Topic Labeling". NLP4DH 2025. DOI: 10.18653/v1/2025.nlp4dh-1.25
+89. Andrew Piper, Sunyam Bagga (2025). "NarraDetect: An annotated dataset for the task of narrative detection". WNU 2025. DOI: 10.18653/v1/2025.wnu-1.1
+90. Annaliese Bissell, E. Paulin, Andrew Piper (2025). "A Theoretical Framework for Evaluating Narrative Surprise in Large Language Models". WNU 2025. DOI: 10.18653/v1/2025.wnu-1.7
+91. M. Shokri, Emily Klapper, J. Shan, Sarah Ita Levitan (2025). "Finding Common Patterns in Domestic Violence Stories Posted on Reddit". WNU 2025. DOI: 10.18653/v1/2025.wnu-1.6
+92. Megan Deering, Gerald Penn (2025). "An Analysis of Scoring Methods for Reranking in Large Language Model Story Generation". In2Writing 2025. DOI: 10.18653/v1/2025.in2writing-1.10
+93. Abhilasha Sancheti, Rachel Rudinger (2025). "Tracking Evolving Relationship Between Characters in Books in the Era of Large Language Models". WNU 2025. DOI: 10.18653/v1/2025.wnu-1.12
+94. Seiji Gobara, Hidetaka Kamigaito, Taro Watanabe (2025). "Speaker Identification and Dataset Construction Using LLMs: A Case Study on Japanese Narratives". WNU 2025. DOI: 10.18653/v1/2025.wnu-1.17
+95. Ankita Gupta, Marisa Hudspeth, Polly Stokes, J. Kurland, Brendan T. O'Connor (2025). "Automated main concept generation for narrative discourse assessment in aphasia". ACL Findings. DOI: 10.18653/v1/2025.findings-acl.1255
+96. Yiting Ran, Xintao Wang, Tian Qiu, Jiaqing Liang, Yanghua Xiao, Deqing Yang (2025). "BOOKWORLD: From Novels to Interactive Agent Societies for Story Creation". ACL. DOI: 10.18653/v1/2025.acl-long.773
+97. Nikolaos Nikolaidis, Nicolas Stefanovitch, Purificação Silvano, D. Dimitrov, Roman Yangarber, Nuno Guimarães, Elisa Sartori, I. Androutsopoulos, Preslav Nakov, Giovanni Da San Martino, Jakub Piskorski (2025). "PolyNarrative: A Multilingual, Multilabel, Multi-domain Dataset for Narrative Extraction from News Articles". ACL. DOI: 10.18653/v1/2025.acl-long.1513
+98. Enrica Troiano, Piek Vossen (2024). "CLAUSE-ATLAS: A Corpus of Narrative Information to Scale up Computational Literary Analysis". LREC. DOI: 10.63317/34wjjnqt76mt
+99. Jon Chun (2024). "AIStorySimilarity: Quantifying Story Similarity Using Narrative for Search, IP Infringement, and Guided Creativity". CoNLL. DOI: 10.18653/v1/2024.conll-1.13
+100. Andrew Piper, Sunyam Bagga (2024). "Using Large Language Models for Understanding Narrative Discourse". WNU 2024. DOI: 10.18653/v1/2024.wnu-1.4
+101. Joel Mire, Maria Antoniak, Elliott Ash, Andrew Piper, Maarten Sap (2024). "The Empirical Variability of Narrative Perceptions of Social Media Texts". EMNLP. DOI: 10.18653/v1/2024.emnlp-main.1113
+102. David Hobson, Haiqi Zhou, Derek Ruths, Andrew Piper (2024). "Story Morals: Surfacing value-driven narrative schemas using large language models". EMNLP. DOI: 10.18653/v1/2024.emnlp-main.723
+103. Andrew Piper, Michael Xu, Derek Ruths (2024). "The Social Lives of Literary Characters: Combining citizen science and language models to understand narrative social networks". NLP4DH. DOI: 10.18653/v1/2024.nlp4dh-1.45
+104. J. A. Meaney, Beatrice Alex, William Lamb (2024). "Testing and Adapting the Representational Abilities of Large Language Models on Folktales in Low-Resource Languages". NLP4DH. DOI: 10.18653/v1/2024.nlp4dh-1.31
+105. Hans Ole Hatzel, Christian Biemann (2024). "Story Embeddings — Narrative-Focused Representations of Fictional Stories". EMNLP. DOI: 10.18653/v1/2024.emnlp-main.339
+106. Junbo Huang, Ricardo Usbeck (2024). "Narration as Functions: from Events to Narratives". WNU 2024. DOI: 10.18653/v1/2024.wnu-1.1
+107. Marina Ermolaeva, Anastasia Shakhmatova, Alina Nepomnyashchikh, Alena Fenogenova (2024). "How to tame your plotline: A framework for goal-driven interactive fairy tale generation". WNU 2024. DOI: 10.18653/v1/2024.wnu-1.2
+108. Daria Seredina (2024). "A Report on LSG 2024: LLM Fine-Tuning for Fictional Stories Generation". INLG GenChal. DOI: 10.18653/v1/2024.inlg-genchal.14
+109. T. Baumann, K. Eller, Natalia Gagarina (2024). "BERT-based Annotation of Oral Texts Elicited via Multilingual Assessment Instrument for Narratives". WNU 2024. DOI: 10.18653/v1/2024.wnu-1.16
+110. A. Migal, Daria Seredina, Ludmila Telnina, Nikita Nazarov, Anastasia Kolmogorova, Nikolay Mikhaylovskiy (2024). "Overview of Long Story Generation Challenge (LSGC) at INLG 2024". INLG GenChal. DOI: 10.18653/v1/2024.inlg-genchal.4
+111. Yuri Bizzoni, Pascale Feldkamp (2023). "Comparing Transformer and Dictionary-based Sentiment Models for Literary Texts: Hemingway as a Case-study". NLP4DH.
+112. Winston Wu, Lu Wang, Rada Mihalcea (2023). "Cross-Cultural Analysis of Human Values, Morals, and Biases in Folk Tales". EMNLP. DOI: 10.18653/v1/2023.emnlp-main.311
+113. Hans Ole Hatzel, Chris Biemann (2023). "Narrative Cloze as a Training Objective: Towards Modeling Stories Using Narrative Chain Embeddings". WNU 2023. DOI: 10.18653/v1/2023.wnu-1.19
+114. Peiqi Sui, Lin Wang, S. Hamilton, Thorsten Ries, Kelvin Wong, Stephen Wong (2023). "Mrs. Dalloway Said She Would Segment the Chapters Herself". WNU 2023. DOI: 10.18653/v1/2023.wnu-1.15
+115. Yu-Kai Lee, Chia-Hui Chang (2023). "Story Co-telling Dialogue Generation based on Multi-Agent Reinforcement Learning and Story Highlights". ALTA.
+116. P. Ranade, S. Dey, A. Joshi, Timothy W. Finin (2022). "Computational Understanding of Narratives: A Survey". IEEE Access. DOI: 10.1109/ACCESS.2022.3205314
+117. Aman Berhe, Camille Guinaudeau, C. Barras (2022). "Survey on Narrative Structure: from Linguistic Theories to Automatic Extraction Approaches". ICON.
+118. A. Piper (2022). "The CONLIT Dataset of Contemporary Literature". Journal of Open Humanities Data. DOI: 10.5334/johd.88
+119. Andrew Piper, R. So, David Bamman (2021). "Narrative Theory for Computational Narrative Understanding". EMNLP. DOI: 10.18653/v1/2021.emnlp-main.26
+120. Byung-Chull Bae, Sujin Jang, Youngjune Kim, Seyoung Park (2021). "A Preliminary Survey on Story Interestingness: Focusing on Cognitive and Emotional Interest". ICIDS. DOI: 10.1007/978-3-030-92300-6_45
+121. D. Herman (2009). "Basic elements of narrative".
+122. M. Hyvärinen (2006). "Towards a Conceptual History of Narrative".
+123. A. Graesser, B. Olde, Bianca Klettke (2002). "How does the mind construct and represent stories".
+124. B. Lincoln (1999). "Theorizing Myth: Narrative, Ideology, and Scholarship". DOI: 10.2307/606705
+125. Terri Gullickson (1997). "Narrative therapy: The social construction of preferred realities". DOI: 10.1037/000559
+126. R. Berman (1997). "Narrative Theory and Narrative Development: The Labovian Impact". DOI: 10.1075/JNLH.7.29NAR
+127. Peter Brooks, Paul Gewirtz (1996). "Law's stories: narrative and rhetoric in the law". DOI: 10.5860/choice.34-1815
+128. L. Schehr, C. V. Boheemen, M. Bal (1988). "Narratology: Introduction to the Theory of Narrative".
+129. W. Brewer, Edward H. Lichtenstein (1980). "Event schemas, story schemas, and story grammars".
+130. Jakub Piskorski, Tarek Mahmoud, Nikolaos Nikolaidis et al. (2025). "SemEval 2025 Task 10: Multilingual Characterization and Extraction of Narratives from Online News".
diff --git a/docs/knowledge/v3_narratology/chatman1980/films-present-while-novels-assert.md b/docs/knowledge/v3_narratology/chatman1980/films-present-while-novels-assert.md
new file mode 100644
index 0000000..1d4450d
--- /dev/null
+++ b/docs/knowledge/v3_narratology/chatman1980/films-present-while-novels-assert.md
@@ -0,0 +1,38 @@
+# Films present while novels assert — and synopses re-assert
+
+Source: Chatman 1980, "What Novels Can Do That Films Can't (And Vice Versa)" (pp. 126-128, 139)
+
+Chatman draws a fundamental distinction between two modes of conveying narrative information:
+
+**Assertion** (novels): The narrator *states* that something is the case. "The cart was tiny; it came onto the bridge." This is an explicit claim about properties and relations. The narrator selects which details to mention and in what order.
+
+**Presentation/depiction** (films): The camera *shows* a state of affairs. "A film doesn't say, 'This is the state of affairs,' it merely shows you that state of affairs." Details aren't selected — they're simply present in the frame. The number of visual details is "potentially large, even vast" but viewers, preoccupied with the plot, register only those "salient to the plot as it unrolls in our minds" (p. 126).
+
+Key consequences:
+- In novels, the narrator controls which properties are *asserted* — you know exactly what's claimed
+- In films, the camera *presents* everything in the frame — what viewers register is partly their own selection
+- Films can't easily assert abstract properties ("she was pretty"); they can only show a face that viewers may or may not find pretty (p. 131)
+- Novel narrators can assert evaluative qualities directly; filmmakers must find visual equivalents or use voice-over (which imports novelistic assertion into film)
+
+## "Interest" point of view
+
+Chatman introduces a POV concept beyond perceptual (where the camera is) and cognitive (what the character knows): **interest POV** — sharing a character's emotional concerns, their stakes, their desires (p. 134). "We become identified with the fate of a character, and even if we don't see things or even think about them from his or her literal perspective, it still makes sense to say that we share the character's point of view."
+
+## What this means for tvplotlines
+
+Our pipeline works with **re-asserted** narrative. The original TV show *presents* (Chatman's sense). The synopsis writer *asserts* (selects, names, orders). Our LLM then *re-asserts* (extracts, labels, structures).
+
+Each step loses presentational information and adds assertive interpretation:
+- **TV → synopsis**: loses visual/audio presentation, gains explicit assertion of what happened
+- **Synopsis → pipeline output**: loses the synopsis writer's emphasis/selection, gains structural labels (plotline, function)
+
+This means our pipeline necessarily works on an *already interpreted* version of the narrative. We're not analyzing the show — we're analyzing someone's assertion about the show. This is both a limitation (we lose experientiality, visual nuance) and an advantage (assertion is easier to parse than presentation).
+
+The "interest POV" concept is relevant to our plotline assignment: an event belongs to the plotline whose character's **interests** are most at stake, not necessarily the character who physically acts.
+
+## Links
+
+- [[narrative-deep-structure-is-independent-of-medium]]
+- [[experientiality-is-what-separates-narrative-from-chronicle]]
+- [[fabula-is-memory-trace-not-authors-plan]]
+- [[four-elements-of-narrative-operate-in-degrees]]
diff --git a/docs/knowledge/v3_narratology/chatman1980/narrative-deep-structure-is-independent-of-medium.md b/docs/knowledge/v3_narratology/chatman1980/narrative-deep-structure-is-independent-of-medium.md
new file mode 100644
index 0000000..a0532a2
--- /dev/null
+++ b/docs/knowledge/v3_narratology/chatman1980/narrative-deep-structure-is-independent-of-medium.md
@@ -0,0 +1,29 @@
+# Narrative deep structure is independent of medium
+
+Source: Chatman 1980, "What Novels Can Do That Films Can't (And Vice Versa)", Critical Inquiry 7(1), pp. 121-140
+
+"Narrative itself is a deep structure quite independent of its medium" (p. 121). The same story — Cinderella, for instance — can be actualized as verbal tale, ballet, opera, film, comic strip, pantomime. The deep structure (the fabula, the "what happened") transfers; what changes is the expression.
+
+This is the founding premise of transmedial narratology: there exists a level of narrative organization (story/fabula) that is medium-independent, and a level (discourse/text) that is medium-specific.
+
+## Double time structure
+
+All narratives combine two independent time orders (p. 122):
+- **Story-time** (*histoire*) — the chronological sequence of events in the fabula
+- **Discourse-time** — the order of presentation in the text/film
+
+Story-time is fixed by the fabula's logic. Discourse-time is freely manipulable. This independence is "precisely and only possible because of the subsumed story-time" — you can only rearrange events because they have a logical order to deviate from.
+
+This maps directly to Bal's fabula-time vs story-time distinction and Todorov's succession principle.
+
+## What this means for tvplotlines
+
+Our pipeline works at the boundary between medium-specific and medium-independent levels. Synopses are **already translated** from TV (a visual/audio medium) into text (verbal medium). This translation has extracted the story-level information and mostly lost the discourse-level information (cinematography, editing rhythm, music, acting). 
+
+We work with what Chatman would call the **asserted** narrative — someone has told us what happened, selecting and naming properties. We don't work with the **presented** narrative — the actual visual/audio experience. This means our pipeline is inherently working on the fabula level, with some story-level residue (the order in which synopses describe events often follows discourse-time, not story-time).
+
+## Links
+
+- [[three-layer-model-separates-text-story-fabula]]
+- [[sequential-ordering-separates-fabula-time-from-story-time]]
+- [[fabula-is-memory-trace-not-authors-plan]]
diff --git a/docs/knowledge/v3_narratology/chauvel-2022-narrative-structure-survey.md b/docs/knowledge/v3_narratology/chauvel-2022-narrative-structure-survey.md
new file mode 100644
index 0000000..58e75be
--- /dev/null
+++ b/docs/knowledge/v3_narratology/chauvel-2022-narrative-structure-survey.md
@@ -0,0 +1,38 @@
+---
+type: research
+project: tvplotlines
+status: active
+source: https://aclanthology.org/2022.tal-1.3.pdf
+year: 2022
+authors: [Chauvel]
+venue: TAL
+---
+
+# Survey on Narrative Structure: from Linguistic Theories to Automatic Extraction
+
+## Summary
+
+Обзор от лингвистических теорий нарративной структуры к автоматическому извлечению. Начинает с Propp, Greimas, Genette, Labov — переходит к вычислительным реализациям. Покрывает фольклор, художественную литературу, другие нарративные формы.
+
+## Key concepts
+
+- **Propp's functions** — 31 функция волшебной сказки, первая формальная модель сюжета
+- **Greimas' actantial model** — 6 актантов (Subject, Object, Sender, Receiver, Helper, Opponent)
+- **Genette's narratology** — focalization, order, duration, frequency, voice
+- **Labov's narrative structure** — abstract, orientation, complicating action, evaluation, resolution, coda
+- **From theory to extraction** — как каждая теория переводится в NLP-задачу
+
+## Why this matters
+
+Мост между классической нарратологией и NLP. Именно здесь найти ответ "какие нарратологические концепции можно заменить на сценарные в промптах tvplotlines".
+
+## Relevance to tvplotlines
+
+Прямая карта соответствий: Story DNA ≈ actantial model? Narrative functions ≈ Propp's functions? Format classification ≈ genre theory? Эта статья даёт теоретическую базу для такого маппинга.
+
+## Connections
+
+- [[santana-2022-narrative-extraction-survey]] — параллельный обзор с NLP-фокусом
+- [[liu-2025-narrative-theory-survey]] — LLM-эра продолжение
+- [[mani-2025-narrative-generative-ai]] — монография, развивает те же теории
+- [[hamilton-2025-narrabench]] — таксономия, основанная на этих теориях
diff --git a/docs/knowledge/v3_narratology/elkins-2022-shapes-of-stories.md b/docs/knowledge/v3_narratology/elkins-2022-shapes-of-stories.md
new file mode 100644
index 0000000..8cfbd94
--- /dev/null
+++ b/docs/knowledge/v3_narratology/elkins-2022-shapes-of-stories.md
@@ -0,0 +1,64 @@
+---
+type: research
+project: tvplotlines
+status: active
+source: https://doi.org/10.1017/9781009270403
+year: 2022
+authors: [Elkins]
+venue: Cambridge Elements (Digital Literary Studies)
+---
+
+# The Shapes of Stories: Sentiment Analysis for Narrative
+
+## Summary
+
+Книга (Cambridge Element) о sentiment analysis как методе визуализации нарративной структуры. Отталкивается от идеи Воннегута (простые формы историй) и работы Reagan (2016, "6 basic shapes"). Сравнивает 30+ моделей sentiment analysis, от dictionary-based (Syuzhet, sentimentR) до deep learning (transformers). Показывает что "форма" (emotional arc) есть даже у экспериментальных модернистских романов.
+
+## Key concepts
+
+- **Sentiment arc ≠ story arc** — sentiment analysis показывает syuzhet (порядок изложения), не fabula (хронологию событий). Это эмоциональная дуга, не сюжетная.
+- **6 basic shapes** (Reagan 2016): rags to riches, tragedy, man in a hole, Icarus, Cinderella, Oedipus
+- **Unique fingerprint** — каждый нарратив имеет уникальный эмоциональный отпечаток, простые формы видны только при сильном сглаживании
+- **Smoothing methods**: Rolling Mean (SMA), DCT (Jockers/Syuzhet), LOWESS — дают разные "расстояния" от текста
+- **Crux points** — пики и впадины sentiment arc коррелируют с ключевыми пассажами, выбранными литературоведами для close reading
+- **Human-in-the-loop обязателен** — модели не заменяют критика, а помогают ему
+- **Ensemble approach** — нет единственной "лучшей" модели, оптимальная зависит от текста
+
+## Tools mentioned
+
+- **SentimentArcs** (Jon Chun) — Python/Jupyter, 30+ моделей, open-source
+- **Syuzhet** (Jockers) — R package, GPL-3, dictionary + DCT smoothing
+- **sentimentR** (Rinker) — R, heuristics (intensification, negation)
+- **Hedonometer** (Reagan/Story Lab) — web tool, sliding window
+
+## Применимость к TV-сериалам
+
+### Что может работать
+- tvplotlines уже имеет синопсисы разбитые по эпизодам — это готовый input для sentiment analysis
+- Sentiment arc поверх эпизодов = эмоциональная траектория сезона — дополнительное измерение к текущим dramatic functions
+- Crux points из sentiment arc могут коррелировать с turning points / climax из tvplotlines
+- Можно строить sentiment arc **per plotline** (каждый event уже привязан к plotline)
+
+### Что проблематично
+- Elkins работает с **полными текстами** романов (тысячи предложений). tvplotlines работает с **синопсисами** (200-400 слов на эпизод). Синопсисы — сжатый пересказ, в них меньше "языка эмоций" и больше "языка событий".
+- Dictionary-based модели (Syuzhet, sentimentR) могут плохо работать на синопсисах — слишком мало слов для статистически значимого сигнала
+- Transformer-модели (BERT-based) могут справиться лучше, но теряют explainability
+- Elkins подчёркивает: sentiment arc показывает **discourse** (порядок изложения), не **story** (что произошло). Синопсисы обычно хронологичны — разница между syuzhet и fabula стирается.
+
+### Verdict: стоит ли пробовать?
+
+**Да, но как эксперимент с чётким scope.** Конкретный тест:
+
+1. Взять сериал где tvplotlines уже разметил всё (Grey's Anatomy S1 или Breaking Bad)
+2. Запустить SentimentArcs на синопсисах (по эпизодам → кривая за сезон)
+3. Сравнить: коррелируют ли впадины sentiment arc с crisis/climax из tvplotlines?
+4. Если да → sentiment arc как дешёвый (без LLM) pre-pass для оценки "формы" сезона
+5. Если нет → синопсисы слишком бедны для sentiment analysis, метод не переносится
+
+Это один скрипт на Python, не требует переписывания промптов. SentimentArcs бесплатен.
+
+## Connections
+
+- [[khan-2025-three-stage-analysis]] — тоже sentiment + narrative structure, но через VAD (Valence/Arousal/Dominance)
+- [[liu-2025-narrative-theory-survey]] — контекст sentiment подходов в NLP
+- [[hamilton-2025-narrabench]] — sentiment arcs как один из 50 narrative skills
diff --git a/docs/knowledge/v3_narratology/hamilton-2025-narrabench.md b/docs/knowledge/v3_narratology/hamilton-2025-narrabench.md
new file mode 100644
index 0000000..1e0a2f5
--- /dev/null
+++ b/docs/knowledge/v3_narratology/hamilton-2025-narrabench.md
@@ -0,0 +1,58 @@
+---
+type: research
+project: tvplotlines
+status: active
+source: https://arxiv.org/abs/2510.09869
+doi: 10.18653/v1/2026.eacl-long.176
+year: 2025
+authors: [Hamilton, Wilkens, Piper]
+venue: EACL 2026
+---
+
+# NarraBench: A Comprehensive Framework for Narrative Benchmarking
+
+## Summary
+
+Теоретически обоснованная таксономия задач narrative understanding. Обзор 78 существующих бенчмарков. Четыре измерения нарратива: story, narration, discourse, situatedness. 50 нарративных навыков. Вывод: только 27% задач покрыты существующими бенчмарками.
+
+## Key concepts
+
+- **Four dimensions**: story (что произошло), narration (кто и как рассказывает), discourse (как организован текст), situatedness (контекст восприятия)
+- **50 narrative skills** — гранулярная карта того, что LLM должна уметь делать с нарративом
+- **Gap analysis** — events, style, perspective, revelation почти не покрыты бенчмарками
+- **Taxonomy** — от нарратологической теории к вычислительным задачам
+
+## Taxonomy (Table 4)
+
+4 dimensions → 12 features → 50 aspects:
+
+- **Story**: Agent (name, role, attributes, emotions, motivation), Social Net (interaction, connections, relationship), Event (event, schema, causality), Plot (topic, plot, plotline, moral, obstacle, conflict, archetype), Structure (plot arc), Setting (setting, location)
+- **Discourse**: Time (duration, order), Revelation (suspense, curiosity, surprise)
+- **Narration**: Perspective (point of view, focalization, dialogue), Style (allusion, figurative, imageability, complexity, evaluative)
+- **Situatedness**: Paratext (genre, author, date, medium, platform), Motivation (intent)
+
+Теоретические основания: Genette (1980) narrative triangle (story/discourse/narration) + Herman (2009) situatedness.
+
+## Benchmark gaps (Table 5)
+
+Пробелы — нет бенчмарков для: Event causality/schema, Plot obstacle/conflict/archetype, all Style, Perspective point of view/focalization, Revelation curiosity/surprise.
+
+**tvplotlines покрывает несколько из этих пробелов:** Plot obstacle + conflict (Story DNA), Plot plotline (pass 1-2), Structure plot arc (pass 4). Это territory claim.
+
+## Why this matters
+
+Даёт формальный язык для описания того, что делает tvplotlines: какие из 50 навыков покрывает текущий пайплайн, какие нет. Карта пробелов. Таксономия основана на Genette + Herman — классическая нарратология, не сценарное мастерство.
+
+## Relevance to tvplotlines
+
+- **Текущее покрытие**: Story dimension (Agent, Plot, Structure) — основа текущего пайплайна
+- **Новые направления для v3**: Discourse (Time order, Revelation), Narration (Perspective, focalization), Style
+- **Territory claim**: tvplotlines закрывает пробелы в бенчмарках (obstacle, conflict, plot arc) — это аргумент для публикации
+- **Evaluation framework**: NarraBench SMV (Scale/Mode/Variance) может дать метрики для оценки tvplotlines output
+
+## Connections
+
+- [[liu-2025-narrative-theory-survey]] — survey-компаньон
+- [[mani-2025-narrative-generative-ai]] — теоретическая база для таксономии
+- [[khan-2025-three-stage-analysis]] — один из подходов к narrative understanding
+- [[elkins-2022-shapes-of-stories]] — sentiment arc как один из narrative skills (Structure → plot arc)
diff --git a/docs/knowledge/v3_narratology/herman2009/breach-of-canonical-script-makes-events-reportable.md b/docs/knowledge/v3_narratology/herman2009/breach-of-canonical-script-makes-events-reportable.md
new file mode 100644
index 0000000..cd24f81
--- /dev/null
+++ b/docs/knowledge/v3_narratology/herman2009/breach-of-canonical-script-makes-events-reportable.md
@@ -0,0 +1,31 @@
+# Breach of a canonical script makes events reportable
+
+Source: Herman 2009, "Basic Elements of Narrative", Ch. 1 (pp. 19-21), drawing on Bruner 1990/1991
+
+Herman adopts Bruner's concept of **"canonicity and breach"**: narratives are worth telling because an implicit canonical script — what was expected, what normally happens — has been violated. The function of the story is then "to find an intentional state that mitigates or at least makes comprehensible a deviation from a canonical cultural pattern" (Bruner 1990: 49-50).
+
+This is more precise than Todorov's "disruption of equilibrium." It's not just that something changes — it's that something changes **against expectations**. The canonical script is what characters (and the audience) expect to happen based on the storyworld's norms. The breach is what actually happens instead.
+
+Bruner: "when you encounter an exception to the ordinary, and ask somebody what is happening, the person you ask will virtually always tell a story that contains *reasons* (or some other specification of an intentional state)."
+
+## Post hoc ergo propter hoc
+
+Herman, following Barthes (p. 8), notes that "the mainspring of narrative is precisely the confusion of consecution and consequence, what comes *after* being read in narrative as what is *caused by*." Readers systematically treat temporal sequence as causal connection. Narrative exploits this: if event B follows event A, readers assume A caused B unless told otherwise.
+
+## What this means for tvplotlines
+
+This gives us a sharper test for "inciting_incident" and for what makes an event narratively significant:
+
+**Current test**: "the event that starts the plotline"
+**With canonicity and breach**: "the event that violates the canonical expectation of the storyworld"
+
+In Breaking Bad: the canonical script is "high school teacher lives a quiet life." The cancer diagnosis *breaches* this script. But the truly narrative breach is Walt *deciding to cook meth* — that's where the canonical expectation of how a teacher responds to illness is shattered.
+
+This also explains why some events feel more "dramatic" than others: they violate stronger canonical expectations. A murder in a crime show has low breach (canonical for the genre). A murder in a sitcom has high breach (violates genre norms). The *strength of breach* could help with plotline ranking — the A-story has the strongest canonical breach.
+
+## Links
+
+- [[four-elements-of-narrative-operate-in-degrees]]
+- [[most-reportable-event-is-the-point-of-the-story]]
+- [[initial-situation-is-always-a-state-of-deficiency]]
+- [[five-part-sequence-is-richer-than-three-act-structure]]
diff --git a/docs/knowledge/v3_narratology/herman2009/experientiality-is-what-separates-narrative-from-chronicle.md b/docs/knowledge/v3_narratology/herman2009/experientiality-is-what-separates-narrative-from-chronicle.md
new file mode 100644
index 0000000..20b63b1
--- /dev/null
+++ b/docs/knowledge/v3_narratology/herman2009/experientiality-is-what-separates-narrative-from-chronicle.md
@@ -0,0 +1,36 @@
+# Experientiality is what separates narrative from chronicle
+
+Source: Herman 2009, "Basic Elements of Narrative", Ch. 1 (pp. 21-22)
+
+Herman's fourth element — **"what it's like"** — is the most cognitively oriented and arguably the most distinctive claim of the book. A narrative doesn't just tell what happened; it conveys **what it was like to experience** the events from within the storyworld.
+
+"The less markedly a text or a discourse encodes the pressure of events on an experiencing human or at least human-like consciousness, the less amenable that text or discourse will be to interpretation in narrative terms" (p. 21).
+
+Without experientiality:
+- A temporal sequence of events is a **chronicle** or **report**
+- A description of general patterns is an **explanation**
+- A series of states without an experiencing consciousness is a **list**
+
+With experientiality: the same events become a **story** — because someone *lived through* them and was affected by them.
+
+## Connection to Fludernik
+
+Herman builds on Fludernik's (1996) concept of "experientiality" as the core of narrativity. For Fludernik, "there can be narratives without plot, but there cannot be any narratives without a human (or anthropomorphic) experiencer of some sort" (quoted on p. xvi). This is a strong claim: experientiality is more fundamental to narrative than event structure.
+
+## What this means for tvplotlines
+
+This diagnoses our biggest theoretical gap. Our pipeline extracts *what happens* (events, functions, plotlines) but not *what it's like* to experience those events. Synopses inherently strip experientiality: "Walt strangles Krazy-8" is an event report, not a narrative. The narrative is what it's like for Walt to do this — the horror, the necessity, the threshold crossed.
+
+Practically, we can't fully recover experientiality from synopses. But we could:
+1. Ask the LLM to infer the **experiential impact** of events on characters (fear, relief, shock, shame)
+2. Track **whose consciousness** each event primarily impacts — this connects to Bal's focalization
+3. Use experiential intensity as a signal for identifying the MRE — the most intense experiential moment is likely the most reportable event
+
+This also explains why our "theme" field in pass2 often feels thin: theme emerges from the experiential dimension (what it was like), which we don't capture. The theme of Breaking Bad S01E03 isn't just "the illusion of control" as an abstract concept — it's the specific experience of discovering that control is an illusion through the act of killing someone.
+
+## Links
+
+- [[four-elements-of-narrative-operate-in-degrees]]
+- [[most-reportable-event-is-the-point-of-the-story]]
+- [[labov-narrative-structure-maps-to-six-components]]
+- [[gnoseological-narrative-is-driven-by-knowledge-not-action]]
diff --git a/docs/knowledge/v3_narratology/herman2009/four-elements-of-narrative-operate-in-degrees.md b/docs/knowledge/v3_narratology/herman2009/four-elements-of-narrative-operate-in-degrees.md
new file mode 100644
index 0000000..d0efcf4
--- /dev/null
+++ b/docs/knowledge/v3_narratology/herman2009/four-elements-of-narrative-operate-in-degrees.md
@@ -0,0 +1,35 @@
+# Four elements of narrative operate in degrees, not as binary features
+
+Source: Herman 2009, "Basic Elements of Narrative", Ch. 1 (pp. 9-22)
+
+Herman proposes four basic elements that constitute conditions for narrativity. Crucially, they are **gradient** — a text is more or less prototypically narrative based on how strongly each element is present:
+
+**(i) Situatedness** — the narrative is situated in a specific discourse context or occasion for telling. The same story told in court testimony vs. a screenplay vs. a party anecdote is interpreted differently because the communicative situation shapes meaning.
+
+**(ii) Event sequencing** — a structured time-course of particularized events. Not just "things happen" but particular things happen to particular people at particular times. Narrative traces "paths taken by particularized individuals faced with decision points at one or more temporal junctures" (p. 19). The temporal profile distinguishes narrative from description (which can be reordered freely) and explanation (which concerns general patterns, not particular cases).
+
+**(iii) Worldmaking / world disruption** — events introduce disruption or disequilibrium into a storyworld. Building on Propp (disruptive events as motor of narrative) and Todorov (equilibrium → disruption → new equilibrium), Herman adds Bruner's concept of **"canonicity and breach"**: a story is worth telling because "an implicit canonical script has been breached, violated, or deviated from" (Bruner 1991). The breach is what makes the events *reportable*.
+
+**(iv) What it's like** (experientiality) — the narrative conveys what it is like to live through the storyworld-in-flux. It encodes "the pressure of events on real or imagined consciousnesses affected by the occurrences at issue" (p. 14). Without this dimension — without a consciousness experiencing the disruption — a temporal sequence of events is a chronicle or report, not a narrative.
+
+## The gradience principle
+
+These elements don't function as a checklist. They operate more-or-less: how detailed is the storyworld? How marked is the disruption? How vivid is the experiential dimension? A text that scores high on all four is a prototypical narrative. A text that scores low on "what it's like" (e.g., a synopsis) is less prototypically narrative — which is precisely what our pipeline works with.
+
+## What this means for tvplotlines
+
+Herman's model diagnoses our pipeline's blind spots:
+
+- **Situatedness**: N/A — we analyze one medium (TV synopses) in one context
+- **Event sequencing**: ✅ — this is what pass2 and pass4 do
+- **Worldmaking/world disruption**: ⚠️ — we capture disruption implicitly through functions (inciting_incident, crisis) but don't track the *canonical expectation* that was breached
+- **What it's like**: ❌ — our biggest gap. We capture *what happens* but not *what it's like to experience it*. Synopses strip this away, and our pipeline doesn't try to reconstruct it
+
+The "canonicity and breach" concept is especially sharp: a narrative event is interesting because it *violates expectations within the storyworld*. This could refine our inciting_incident definition: not just "the event that starts the plotline" but "the event that breaches the canonical script of the storyworld."
+
+## Links
+
+- [[breach-of-canonical-script-makes-events-reportable]]
+- [[experientiality-is-what-separates-narrative-from-chronicle]]
+- [[ten-elements-define-degrees-of-narrativity]]
+- [[five-part-sequence-is-richer-than-three-act-structure]]
diff --git a/docs/knowledge/v3_narratology/huang-usbeck2024/constituent-vs-supplementary-events.md b/docs/knowledge/v3_narratology/huang-usbeck2024/constituent-vs-supplementary-events.md
new file mode 100644
index 0000000..020e595
--- /dev/null
+++ b/docs/knowledge/v3_narratology/huang-usbeck2024/constituent-vs-supplementary-events.md
@@ -0,0 +1,33 @@
+# Constituent events form the causal backbone, supplementary events add texture
+
+Source: Huang & Usbeck 2024, "Narration as Functions: from Events to Narratives" (pp. 3-4), drawing on Abbott 2020, Barthes & Duisit 1975, Chatman 1978
+
+The paper adopts a fundamental distinction between two types of events:
+
+**Constituent events** (also called nuclei by Barthes/Duisit 1975, or kernels by Chatman 1978) — the events without which the story would fundamentally change or would not make sense. They form the causal backbone of the narrative. Remove one, and the story is "significantly altered or loses coherence."
+
+**Supplementary events** (also called catalyzers by Barthes, or satellites by Chatman) — events that add depth, richness, and complexity but aren't necessary for the story to be complete. Remove one, and "the story might be less detailed or interesting, but it would still be recognizable as the same story."
+
+## The test
+
+Abbott (2020) provides the test: if you remove this event, does the story significantly change? If yes — constituent. If no — supplementary.
+
+This is closely related to Bal's "choice" criterion for functional events: a functional event is one that opens a fork, and if it hadn't happened, the rest would change. Constituent events ≈ functional events (Bal) ≈ kernels (Chatman).
+
+## Why the distinction matters computationally
+
+The authors show that in existing event extraction datasets (BECauSE 2.0, CaTeRS, RED, Causal-TB, EventStoryLine, MAVEN-ERE), the causal relation matrix is extremely sparse — S(H) > 0.95 in all datasets. Most extracted events don't causally relate to other events. This means most extracted events are supplementary: they describe things that happen but don't drive the plot forward.
+
+Filtering out supplementary events produces a much denser causal matrix — the "core story" — which captures the actual causal logic of the narrative.
+
+## What this means for tvplotlines
+
+Our pass2 currently extracts events from every sentence of the synopsis. By the constituent/supplementary distinction, many of these are supplementary — they add texture but don't form the causal backbone. This creates noise in the event list and makes function assignment harder.
+
+Adding a constituent/supplementary label to each event (or filtering supplementary events before function assignment) could sharpen the pipeline. The test is simple enough for an LLM: "If this event were removed, would the plotline's outcome change?"
+
+## Links
+
+- [[three-criteria-filter-functional-events]] (Bal's functional event = constituent event)
+- [[fabula-as-events-plus-causal-matrix]]
+- [[narration-transforms-fabula-into-discourse]]
diff --git a/docs/knowledge/v3_narratology/huang-usbeck2024/fabula-as-events-plus-causal-matrix.md b/docs/knowledge/v3_narratology/huang-usbeck2024/fabula-as-events-plus-causal-matrix.md
new file mode 100644
index 0000000..8f6348f
--- /dev/null
+++ b/docs/knowledge/v3_narratology/huang-usbeck2024/fabula-as-events-plus-causal-matrix.md
@@ -0,0 +1,47 @@
+# Fabula can be formalized as events plus a causal relation matrix
+
+Source: Huang & Usbeck 2024, "Narration as Functions: from Events to Narratives" (p. 4)
+
+The paper proposes a minimal formal representation of fabula:
+
+```
+F = {E, H}
+```
+
+Where:
+- **E** = [e₁, e₂, ..., eₙ] — a list of temporally ordered events
+- **H** = n×n causal relation matrix, where rᵢⱼ ∈ {1, -1, 0}
+  - rᵢⱼ = 1: event eᵢ causes eⱼ
+  - rᵢⱼ = -1: eⱼ causes eᵢ
+  - rᵢⱼ = 0: no causal relation
+
+The "core story" I_c = {E_c, H_c} is obtained by filtering to constituent events only, producing a denser (less sparse) causal matrix.
+
+## The sparsity problem
+
+All existing document-level event causal extraction datasets have S(H) > 0.95 — meaning over 95% of event pairs have no causal relation. Most events are supplementary. The core story, after filtering, has a much denser matrix.
+
+## Three-stage pipeline
+
+The paper maps information flow from real world to narrative text:
+
+1. **f(·)**: real-world events → fabula (selection and temporal ordering)
+2. **g(·)**: fabula → discourse (narrative composition — causal logic, emphasis)
+3. **z(·)**: discourse → text (natural language generation)
+
+This corresponds to Bal's three layers (fabula → story → text) but adds an explicit computational framing.
+
+## What this means for tvplotlines
+
+Our pipeline implicitly builds something like F = {E, H}: pass2 extracts events (E) and assigns them to plotlines (which implies causal chains within each plotline). But we don't explicitly build the causal relation matrix H. Doing so would let us:
+1. Identify constituent events (those with many causal links)
+2. Detect orphaned events (those with no causal links — likely supplementary)
+3. Validate plotline boundaries (events in the same plotline should be causally linked)
+
+The formalization also highlights what our pipeline *doesn't* do: we capture which plotline an event serves but not *which other events it causally depends on or causes*.
+
+## Links
+
+- [[constituent-vs-supplementary-events]]
+- [[narration-transforms-fabula-into-discourse]]
+- [[three-layer-model-separates-text-story-fabula]]
diff --git a/docs/knowledge/v3_narratology/huang-usbeck2024/narration-transforms-fabula-into-discourse.md b/docs/knowledge/v3_narratology/huang-usbeck2024/narration-transforms-fabula-into-discourse.md
new file mode 100644
index 0000000..91e3dd1
--- /dev/null
+++ b/docs/knowledge/v3_narratology/huang-usbeck2024/narration-transforms-fabula-into-discourse.md
@@ -0,0 +1,33 @@
+# Narration is a function that transforms fabula into discourse
+
+Source: Huang & Usbeck 2024, "Narration as Functions: from Events to Narratives" (pp. 2-3)
+
+The paper frames narration as a computational function: given a fabula (selected events + causal relations), narration produces discourse — an intermediate representation that shapes the narrated world. This discourse is then textualized into natural language.
+
+The key insight for news narratives (the paper's domain): news narrators don't just report events. They **re-represent** real-world events through selection (what to include), ordering (in what sequence), and framing (what causal connections to highlight). The narrated world is not the real world — it's a construction.
+
+## Authorial intent
+
+The paper revisits "authorial intent" through Critical Discourse Analysis (CDA): news narrators are "a dominant group" who shape "the narrated world encoded in language consumed by the public." The narrated world reflects power structures, values, and ideology — not objective reality.
+
+This is less relevant for fiction (where the "narrated world" is explicitly constructed), but the framework applies: a TV show's narration selects events, orders them, and frames causal connections to produce a particular narrated world.
+
+## Limitations the authors acknowledge
+
+- Only causal relations considered — ignores temporal shifts, rhetorical strategies, emotional arcs
+- Domain limited to news narratives
+- "Non-event-related narrative nuances cannot be captured"
+- Constituent event identification is domain-specific and requires interpretation
+
+## What this means for tvplotlines
+
+The paper is a position paper, not a system — there's no implementation to borrow. But the framing is useful: our pipeline's job is essentially φ(·) in reverse. We receive text (synopses), and we try to reconstruct fabula (events + causal structure). The paper confirms this is a well-defined task with a theoretical foundation.
+
+The limitation about "only causal relations" is relevant: our pipeline captures more than causality (dramatic functions, thematic connections, interactions between plotlines). This is a strength.
+
+## Links
+
+- [[fabula-as-events-plus-causal-matrix]]
+- [[constituent-vs-supplementary-events]]
+- [[three-layer-model-separates-text-story-fabula]]
+- [[fabula-is-memory-trace-not-authors-plan]]
diff --git a/docs/knowledge/v3_narratology/ionescu2019/postclassical-narratology-fragmented-into-many-strands.md b/docs/knowledge/v3_narratology/ionescu2019/postclassical-narratology-fragmented-into-many-strands.md
new file mode 100644
index 0000000..2ab130b
--- /dev/null
+++ b/docs/knowledge/v3_narratology/ionescu2019/postclassical-narratology-fragmented-into-many-strands.md
@@ -0,0 +1,38 @@
+# Postclassical narratology fragmented into many strands after 1999
+
+Source: Ionescu 2019, "Postclassical Narratology: Twenty Years Later", Word and Text IX, pp. 5-34
+
+Since Herman coined "postclassical narratology" in 1997, the field has splintered into numerous subfields, each with its own methods and priorities:
+
+- **Rhetorical narratology** (Booth, Phelan, Rabinowitz) — focuses on the implied author, authorial audience, ethical dimensions of narration. "The flesh and blood reader seeks to enter the authorial audience in order to understand the invitations for engagement that the narrative offers" (p. 10)
+- **Cognitive narratology** (Fludernik, Herman) — uses mental processes and cognitive science to understand how readers construct storyworlds
+- **Corpus narratology** (Toolan, Sinclair, Stubbs) — stylistic analysis of large corpora, computational methods
+- **Feminist narratology** (Lanser, Page) — gender differences in story/discourse
+- **Transmedial narratology** (Helbig, Ryan, Rajewsky) — narrative across media: literature, film, comics, videogames. "Seek to rebuild narratology so that it can handle new genres and storytelling practices across a wide spectrum of media" (p. 14)
+- **Digital narratology** — hypertext narratives, interactive fiction, videogames
+- **Unnatural narratology** (Richardson, Alber) — anti-mimetic narratives that challenge real-world understandings of identity, time, space
+- **Corporeal narratology** (Punday) — the role of the body in narrative
+
+## The classical/postclassical distinction
+
+Classical narratology (Propp, Barthes, Genette, Todorov, Greimas, Bal) sought **universal narrative structures**. Postclassical narratology doesn't reject these but "rethinks their conceptual underpinnings and reassesses their scope of applicability" (Herman 1999). Key additions: context-sensitivity, cognitive dimensions, cross-media applicability, ethical considerations.
+
+Herman's definition: postclassical narratology "contains classical narratology as one of its 'moments' but is marked by a profusion of new methodologies and research hypotheses" (p. 9).
+
+## What this means for tvplotlines
+
+We are doing something that sits at the intersection of several strands:
+- **Classical structuralist** — using Bal, Todorov, Bremond, Greimas for formal models
+- **Cognitive** — our pipeline implicitly constructs storyworlds from synopses (Herman's experientiality)
+- **Transmedial** — applying literary concepts to TV series
+- **Corpus/computational** — automated analysis at scale
+
+The survey confirms that no single narratological framework is authoritative. Our approach of layering multiple classical frameworks (Bremond's cycles + Bal's actants + Labov's evaluation + Todorov's transformation) while keeping them operationally simple for LLM prompts is a defensible position — it's what postclassical narratology recommends: use classical tools but don't treat them as universal laws.
+
+The strand we're *not* drawing on but could: **rhetorical narratology** (Phelan) — how the narrative invites specific judgments and emotional responses from the audience. This connects to Herman's "what it's like" and Labov's "evaluation." It's about the *intended effect* of narrative choices on the viewer. For TV analysis, this is showrunner intent — why this scene exists, what reaction it's designed to produce.
+
+## Links
+
+- [[four-elements-of-narrative-operate-in-degrees]]
+- [[no-single-approach-universally-fits-narrative-structure]]
+- [[three-layer-model-separates-text-story-fabula]]
diff --git a/docs/knowledge/v3_narratology/keith-2025-interactive-narrative-analytics.md b/docs/knowledge/v3_narratology/keith-2025-interactive-narrative-analytics.md
new file mode 100644
index 0000000..249557f
--- /dev/null
+++ b/docs/knowledge/v3_narratology/keith-2025-interactive-narrative-analytics.md
@@ -0,0 +1,41 @@
+---
+type: research
+project: tvplotlines
+status: active
+source: https://arxiv.org/abs/2601.11459
+doi: 10.1109/ACCESS.2025.3650352
+year: 2025
+authors: [Keith]
+venue: IEEE Access
+---
+
+# Interactive Narrative Analytics: Bridging Computational Narrative Extraction and Human Sensemaking
+
+## Summary
+
+Определяет поле Interactive Narrative Analytics (INA): computational narrative extraction + interactive visual analytics для sensemaking. Обзор методов, вызовов (масштабируемость, интерактивность, интеграция знаний, стандартизация оценки) и приложений (новостной анализ, разведка, научная литература, соцсети).
+
+## Key concepts
+
+- **Interactive Narrative Analytics (INA)** — новое определение поля на стыке extraction и визуализации
+- **Sensemaking** — человеческое осмысление через интерактивное исследование нарративных структур (Pirolli & Card, information foraging)
+- **Four theoretical foundations**: interactive visual analytics, computational narratives, sensemaking, knowledge representation
+- **Event-based narratives** — нарратив как цепочка событий со связями (temporal, causal, semantic), НЕ как литературная структура (Propp, Genette)
+- **Knowledge integration** — онтологии и knowledge graphs для обогащения extraction
+
+## Verdict after reading
+
+**Аутлайер в seed-списке.** Библиография почти не пересекается с классической нарратологией. Фокус — news analysis, intelligence, misinformation detection. "Narrative" здесь = "цепочка событий в новостном потоке", а не "сюжетная структура художественного произведения".
+
+**Для v3 narratology промптов — малополезна.** Но полезна для tvplotlines-app (визуализация, human-in-the-loop, semantic interaction).
+
+## Relevance to tvplotlines
+
+- **Для библиотеки (prompts)**: низкая. Другое понимание "narrative".
+- **Для приложения (viewer)**: высокая. tvplotlines уже делает INA: extraction pipeline + HTML viewer. Keith даёт теоретическую рамку и показывает что можно добавить: semantic interaction, progressive analytics, knowledge integration.
+
+## Connections
+
+- [[balestri-pescatore-2025-icaart]] — тоже имеет графический интерфейс
+- [[santana-2022-narrative-extraction-survey]] — extraction часть
+- [[hamilton-2025-narrabench]] — evaluation часть
diff --git a/docs/knowledge/v3_narratology/khan-2025-three-stage-analysis.md b/docs/knowledge/v3_narratology/khan-2025-three-stage-analysis.md
new file mode 100644
index 0000000..a6a62cd
--- /dev/null
+++ b/docs/knowledge/v3_narratology/khan-2025-three-stage-analysis.md
@@ -0,0 +1,32 @@
+---
+type: research
+project: tvplotlines
+status: active
+source: https://arxiv.org/abs/2511.11857
+year: 2025
+authors: [Khan]
+venue: arXiv
+---
+
+# Three Stage Narrative Analysis: Plot-Sentiment Breakdown, Structure Learning and Concept Detection
+
+## Summary
+
+Трёхэтапный пайплайн для анализа нарратива в киносценариях: (1) разбивка на plot-sentiment arcs, (2) кластеризация структур методом Ward's hierarchical clustering, (3) извлечение концептов. Использует dictionary-based sentiment analysis с кастомным лексиконом на основе NRC-VAD (Valence, Arousal, Dominance).
+
+## Key concepts
+
+- **Sentiment arcs** — сюжет как траектория эмоциональных состояний (не событий)
+- **VAD model** — Valence/Arousal/Dominance вместо бинарной позитивность/негативность
+- **Structure clustering** — группировка похожих нарративных структур
+- **Concept extraction** — высокоуровневые и низкоуровневые концепты из нарратива
+
+## Relevance to tvplotlines
+
+Альтернативный подход к тому же: разбиение нарратива на формальные компоненты. Но через sentiment, не через драматические функции. Может дать дополнительное измерение к текущим промптам — эмоциональная дуга поверх сюжетной.
+
+## Connections
+
+- [[hamilton-2025-narrabench]] — sentiment arcs как один из narrative skills
+- [[liu-2025-narrative-theory-survey]] — контекст sentiment-подходов
+- [[chauvel-2022-narrative-structure-survey]] — лингвистические теории структуры
diff --git a/docs/knowledge/v3_narratology/liu-2025-narrative-theory-survey.md b/docs/knowledge/v3_narratology/liu-2025-narrative-theory-survey.md
new file mode 100644
index 0000000..2b9a75d
--- /dev/null
+++ b/docs/knowledge/v3_narratology/liu-2025-narrative-theory-survey.md
@@ -0,0 +1,38 @@
+---
+type: research
+project: tvplotlines
+status: active
+source: https://arxiv.org/abs/2602.15851
+year: 2025
+authors: [Liu]
+venue: arXiv
+---
+
+# Narrative Theory-Driven LLM Methods for Automatic Story Generation and Understanding: A Survey
+
+## Summary
+
+Обзорная статья: как NLP-исследования используют нарративную теорию. Предлагает таксономию, отражающую нарратологические различия. Покрывает датасеты, задачи, теории, тренды в промптинге и файн-тюнинге. Разделяет generation и understanding.
+
+## Key concepts
+
+- **Narratology-informed taxonomy** — классификация NLP-задач через призму нарратологии
+- **Story generation vs understanding** — два направления использования LLM для нарратива
+- **Narrative theories in NLP pipeline** — как теории встраиваются в промпты и файн-тюнинг
+- **Methodological trends** — систематизация подходов (prompting, fine-tuning, hybrid)
+
+## Why this matters
+
+Самый ценный источник для библиографии — survey собирает всё поле. Именно здесь искать "общих предков" и карту территории.
+
+## Relevance to tvplotlines
+
+Прямо отвечает на вопрос "какие нарратологические концепции уже использовались в LLM-пайплайнах". Таксономия может показать, где tvplotlines находится и что упускает.
+
+## Connections
+
+- [[hamilton-2025-narrabench]] — benchmark-компаньон к этому survey
+- [[mani-2025-narrative-generative-ai]] — монография по той же теме
+- [[santana-2022-narrative-extraction-survey]] — предшествующий survey
+- [[chauvel-2022-narrative-structure-survey]] — предшествующий survey (лингвистический фокус)
+- [[balestri-pescatore-2025-icaart]] — один из проектов в обзоре
diff --git a/docs/knowledge/v3_narratology/mani-2025-narrative-generative-ai.md b/docs/knowledge/v3_narratology/mani-2025-narrative-generative-ai.md
new file mode 100644
index 0000000..e288d12
--- /dev/null
+++ b/docs/knowledge/v3_narratology/mani-2025-narrative-generative-ai.md
@@ -0,0 +1,38 @@
+---
+type: research
+project: tvplotlines
+status: active
+source: https://link.springer.com/book/10.1007/978-3-031-94058-3
+doi: 10.1007/978-3-031-94058-3
+year: 2025
+authors: [Mani]
+venue: Springer (Synthesis Lectures on HLT)
+---
+
+# Narrative and Generative AI: A Computational Account
+
+## Summary
+
+Монография (второе издание). Обзор проблем, подходов и вызовов моделирования нарративной структуры. Расширена фокусом на generative AI. Inderjeet Mani — один из основоположников computational narratology.
+
+## Key concepts
+
+- **Computational narratology** — формализация нарратологических теорий для вычислений
+- **Narrative structure modeling** — от Propp до трансформеров
+- **Story understanding vs generation** — два направления, их пересечение с generative AI
+- **Theoretical grounding** — связь формальных моделей с классической нарратологией (Genette, Bal, Prince)
+
+## Why this matters
+
+Потенциально самая полная библиография из всех 9 работ. Книга по определению покрывает поле шире чем статья. Mani — ключевая фигура в computational narratology с 2000-х.
+
+## Relevance to tvplotlines
+
+Теоретический фундамент для перехода от сценарного мастерства к нарратологии. Если где-то описано "какие нарратологические концепции формализуемы" — то здесь.
+
+## Connections
+
+- [[liu-2025-narrative-theory-survey]] — survey по той же теме, но уже
+- [[hamilton-2025-narrabench]] — использует теоретическую базу Mani
+- [[santana-2022-narrative-extraction-survey]] — предшествующий обзор extraction
+- [[chauvel-2022-narrative-structure-survey]] — предшествующий обзор structure
diff --git a/docs/knowledge/v3_narratology/moc-pipeline-ideas.md b/docs/knowledge/v3_narratology/moc-pipeline-ideas.md
new file mode 100644
index 0000000..a87373b
--- /dev/null
+++ b/docs/knowledge/v3_narratology/moc-pipeline-ideas.md
@@ -0,0 +1,57 @@
+# MOC: Идеи для нового пайплайна
+
+Идеи, которые возникают при чтении нарратологии и могут повлиять на архитектуру пайплайна, аналитику или позиционирование продукта.
+
+## Аналитика и продукт
+
+- **Обнаружение незапланированного**: сетевой анализ может показать структуры, которые авторы не проектировали сознательно — то что *вышло*, а не то что *задумывалось*. Это отдельная ценность инструмента: зеркало для showrunner'а. (Moretti 2011 — [[moretti2011/network-regions-reveal-plot-subsystems]])
+
+## Поиск сюжетных линий
+
+- **Подсети вокруг хабов как кандидаты на сюжетные линии**: степенное распределение связей создаёт несколько хабов, каждый — центр своей подсети. A-story = подсеть главного хаба, B-story = второго. Персонажи на пересечении подсетей участвуют в нескольких storylines. Removal experiment как верификация. (Moretti 2011 — [[moretti2011/power-law-distribution-in-character-networks]])
+
+## Метрики
+
+- **Protagonist detection через removal experiment**: протагонист — не тот у кого больше всего связей (degree), а тот, чьё удаление максимально фрагментирует сеть. Можно использовать как контрольный параметр: после того как пайплайн определил главного персонажа, проверить — действительно ли его удаление из графа взаимодействий ломает структуру сильнее всех остальных. Если нет — возможно пайплайн ошибся. (Moretti 2011 — [[moretti2011/protagonist-defined-by-network-stability-not-centrality]])
+
+## Эксперименты
+
+### Removal experiment на GoT
+**Цель**: проверить тезис Moretti — что протагонист определяется не degree, а дестабилизацией сети при удалении.
+
+**Данные**: два датасета от Andrew Beveridge:
+- Книги: [mathbeveridge/asoiaf](https://github.com/mathbeveridge/asoiaf) — `asoiaf-book1-edges.csv` и др.
+- **Сериал HBO**: [mathbeveridge/gameofthrones](https://github.com/mathbeveridge/gameofthrones) — данные по сезонам, по скриптам с genius.com. Взаимодействия: речь, упоминания, совместные сцены.
+
+**Что Beveridge уже сделал**:
+- Community detection → 7 сообществ (Ланнистеры, Робб, Бран, Арья, Джон+Стена, Станнис, Дейнерис)
+- 6 метрик центральности (degree, weighted degree, eigenvector, PageRank, closeness, betweenness)
+- Тирион — лидер по всем кроме betweenness (там Джон Сноу)
+
+**Что НЕ сделано** (наш эксперимент):
+- Removal experiments — удаление вершин и замер фрагментации
+- Сравнение degree ranking vs. destabilization ranking
+- Связь community detection → storyline identification
+
+**План**:
+1. Начать с книги (book1) — проще, данные точно чистые
+2. Потом повторить по сериалу (season 1) — сравнить результаты
+
+**Отдельный вопрос: устойчивость к методу построения сети.** Книжный датасет построен грубо (ко-окуренция имён в 15 словах текста). Сериальный — точнее (5 типов: прямая речь, упоминания, совместные сцены). Если removal experiment даёт похожие результаты на обоих — значит структура устойчива к методу экстракции. Это критично для нас: наш пайплайн будет строить графы из синопсисов (ещё более грубый метод), и если результат не зависит сильно от способа построения, даже грубая экстракция даст полезный граф.
+
+**Метрики дестабилизации** (при удалении вершины):
+1. Число компонент связности — было 1, стало N
+2. Доля LCC (largest connected component) — какая часть сети выжила
+3. (опционально) Изменение средней длины пути
+
+**Скрипт** (networkx, ~20 строк):
+1. Загрузить CSV → взвешенный граф
+2. Для каждого персонажа: удалить вершину, посчитать метрики 1-2
+3. Отсортировать по убыванию дестабилизации
+4. Сравнить с degree ranking — совпадает ли топ?
+
+**Ожидание**: Ned Stark должен быть топ-дестабилизатор (он связывает Winterfell, King's Landing, Wall через Джона). Degree-лидер может быть другим (Тирион по Beveridge).
+
+**Статус**: начат
+
+## Архитектура
diff --git a/docs/knowledge/v3_narratology/moretti2011/character-networks-model-plot-as-space-not-time.md b/docs/knowledge/v3_narratology/moretti2011/character-networks-model-plot-as-space-not-time.md
new file mode 100644
index 0000000..869d1d3
--- /dev/null
+++ b/docs/knowledge/v3_narratology/moretti2011/character-networks-model-plot-as-space-not-time.md
@@ -0,0 +1,22 @@
+# Character networks model plot as space, not time
+
+Source: Moretti 2011, "Network Theory, Plot Analysis"
+
+When you turn a dramatic text into a character network (characters = vertices, interactions = edges), you lose temporality but gain spatiality. The past becomes as visible as the present — once a character appears in the network, they never disappear. "What is done is never undone."
+
+This is a fundamental trade-off: networks sacrifice the sequential experience of plot (this happens, then that) for a simultaneous view of all relationships. The advantage is that you can now see **regions**, subsystems, and structural patterns that are invisible when reading linearly.
+
+Moretti frames this explicitly: "Four hours of action, that become this. Time turned into space: a character-system arising out of many character-spaces."
+
+This connects to Alex Woloch's concept of "character-space" from *The One vs. the Many* — each character occupies a portion of the narrative's attention, and the network makes these portions visible simultaneously.
+
+## Implications for tvplotlines
+
+- Our pipeline extracts storylines from synopses — a temporal representation. Network analysis could complement this by revealing the spatial structure of character relationships.
+- The time→space trade-off means network analysis and sequential storyline extraction answer different questions about the same text.
+
+## Links
+
+- [[power-law-distribution-in-character-networks]]
+- [[network-regions-reveal-plot-subsystems]]
+- [[protagonist-defined-by-network-stability-not-centrality]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/clustering-explains-structural-importance-of-characters.md b/docs/knowledge/v3_narratology/moretti2011/clustering-explains-structural-importance-of-characters.md
new file mode 100644
index 0000000..ca6b283
--- /dev/null
+++ b/docs/knowledge/v3_narratology/moretti2011/clustering-explains-structural-importance-of-characters.md
@@ -0,0 +1,21 @@
+# Clustering coefficient explains why some characters are structurally important
+
+Source: Moretti 2011, "Network Theory, Plot Analysis"
+
+Clustering is a network metric: if A is connected to B and B to C, what's the probability that A and C are also connected? High clustering means tightly knit groups where "the friend of your friend is also your friend."
+
+In *Hamlet*, the Court hexagon (Hamlet, Claudius, Gertrude, Polonius, Ophelia, Laertes) has 100% clustering — everyone is connected to everyone. This explains **why removing Claudius has little effect**: he belongs to an already hyper-connected region. The redundancy of connections means no single node is structurally critical within this cluster.
+
+Horatio is the opposite: he inhabits a region of very low clustering, connecting otherwise-disconnected parts of the network. Removing Horatio disintegrates the network because there's no redundancy — he's the only bridge.
+
+## The principle
+
+- Characters in **high-clustering regions** are individually replaceable (structurally)
+- Characters in **low-clustering regions** are bridges — "weak ties" in Granovetter's sense — and their removal causes fragmentation
+- Structural importance ≠ number of connections. It's about whether your connections are redundant.
+
+## Links
+
+- [[protagonist-defined-by-network-stability-not-centrality]]
+- [[weak-ties-connect-narrative-regions]]
+- [[network-regions-reveal-plot-subsystems]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/edge-weight-and-direction-matter-but-are-hard-to-operationalize.md b/docs/knowledge/v3_narratology/moretti2011/edge-weight-and-direction-matter-but-are-hard-to-operationalize.md
new file mode 100644
index 0000000..57cb1c7
--- /dev/null
+++ b/docs/knowledge/v3_narratology/moretti2011/edge-weight-and-direction-matter-but-are-hard-to-operationalize.md
@@ -0,0 +1,25 @@
+# Edge weight and direction matter for character networks but are hard to operationalize
+
+Source: Moretti 2011, "Network Theory, Plot Analysis"
+
+Moretti identifies two critical limitations of his networks:
+
+**No weight**: When Claudius tells Horatio "I pray thee, good Horatio, wait upon him" — 8 words — this edge has the same visual weight as the thousands of words exchanged between Hamlet and Horatio. "This can't be right."
+
+**No direction**: When Horatio addresses the Ghost, the Ghost doesn't reply. The interaction is one-directional. But the network shows a symmetric edge. Similarly, Hamlet's verbal energy is spread across five Court characters (only 28% of his words), while Claudius concentrates almost all his speech on the Court hexagon (48-60%).
+
+Moretti says he couldn't find "a non-clumsy way to visualize weight and direction" and prioritized "maximizing visibility by minimizing overlap." This is honest but consequential — weight and direction carry important narrative information:
+
+- **Weight** reveals intensity of relationships
+- **Direction** reveals power dynamics, initiative, agency
+- Together they could "significantly modify the initial X-ray" of a text
+
+## For tvplotlines
+
+- When building character interaction networks from synopses, consider: can we extract directional information (who initiates interaction)?
+- Weighted edges (based on co-occurrence frequency or interaction intensity) are more informative than binary presence/absence
+
+## Links
+
+- [[moretti-networks-as-visualization-not-theory]]
+- [[character-networks-model-plot-as-space-not-time]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/guanxi-networks-manufacture-social-obligation.md b/docs/knowledge/v3_narratology/moretti2011/guanxi-networks-manufacture-social-obligation.md
new file mode 100644
index 0000000..1496bfd
--- /dev/null
+++ b/docs/knowledge/v3_narratology/moretti2011/guanxi-networks-manufacture-social-obligation.md
@@ -0,0 +1,22 @@
+# Guanxi networks manufacture social obligation through chains of transactions
+
+Source: Moretti 2011, "Network Theory, Plot Analysis"
+
+In analyzing *The Story of the Stone*, Moretti encounters a network pattern that doesn't exist in Western novels: **guanxi** — "connections" that are "neither individual nor society-based, but relation-based." These connections are artifacts: "manufacturing obligation," "chain of transactions," "indebtedness."
+
+The key example (ch. 24): Jia Yun needs work → asks Bu Shi-ren for help → Bu refuses → Jia Yun meets Ni Er (a drunk/racketeer) → Ni Er lends money → Jia Yun buys a present for Xi-feng → Xi-feng gives him a job. A whole chain of transactions that manufactures obligation and creates asymmetry.
+
+This matters for network analysis because:
+1. **Edge semantics differ across cultures** — in Shakespeare, an edge means "these characters spoke." In *The Story of the Stone*, edges can mean reciprocity, obligation, transaction, debt.
+2. **Local asymmetry + global balance** — individual guanxi chains are asymmetric (someone gains, someone gives), but over time they tend toward reciprocity. At the chapter scale, this produces asymmetry in chapters but symmetry across the novel.
+
+## Implications for tvplotlines
+
+- Different narrative traditions structure character relationships differently
+- Edge types (cooperation, conflict, obligation, hierarchy) carry semantic weight that simple co-occurrence networks miss
+- TV series from different cultural traditions may need different analytical frameworks
+
+## Links
+
+- [[symmetry-emerges-in-small-chapter-networks]]
+- [[character-networks-model-plot-as-space-not-time]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/moretti-networks-as-visualization-not-theory.md b/docs/knowledge/v3_narratology/moretti2011/moretti-networks-as-visualization-not-theory.md
new file mode 100644
index 0000000..ecf20c5
--- /dev/null
+++ b/docs/knowledge/v3_narratology/moretti2011/moretti-networks-as-visualization-not-theory.md
@@ -0,0 +1,25 @@
+# Moretti used network theory as visualization, not as a full analytical framework
+
+Source: Moretti 2011, "Network Theory, Plot Analysis" (Epilogue)
+
+Moretti's crucial self-assessment in the epilogue: he didn't actually need network *theory* — he needed network *visualization*. "What I took from network theory were less concepts than visualization: the possibility of extracting characters and interactions from a dramatic structure, and turning them into a set of signs that I could see at a glance."
+
+He compares this to his earlier use of cartography in *Atlas of the European Novel*: arranging literary data spatially as "a principle of order — but not a full conceptual architecture."
+
+Key admissions:
+- The "region of death," "spaces of legitimacy," "symmetry" — none of these had much to do with network theory proper
+- The study drifted from quantification to qualitative analysis almost immediately
+- Edge weight and direction were missing, making the networks incomplete models
+- The networks were all built by hand, not computationally
+
+His conclusion: intuitive visualization reached a dead end. The next step required moving from images to **concepts** (network size, density, clustering, betweenness) and statistical analysis — the work Rhiannon Lewis continued.
+
+## Why this matters
+
+This is an honest account of the gap between borrowing a visualization technique from another discipline vs. actually using that discipline's analytical toolkit. For tvplotlines, the lesson is: don't stop at pretty graphs. Use the actual metrics.
+
+## Links
+
+- [[character-networks-model-plot-as-space-not-time]]
+- [[removal-experiments-reveal-structural-roles]]
+- [[clustering-explains-structural-importance-of-characters]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/network-regions-reveal-plot-subsystems.md b/docs/knowledge/v3_narratology/moretti2011/network-regions-reveal-plot-subsystems.md
new file mode 100644
index 0000000..2f6403f
--- /dev/null
+++ b/docs/knowledge/v3_narratology/moretti2011/network-regions-reveal-plot-subsystems.md
@@ -0,0 +1,19 @@
+# Network regions reveal plot subsystems
+
+Source: Moretti 2011, "Network Theory, Plot Analysis"
+
+When you build a character network, clusters of interconnected characters form visible **regions** — subsystems within the plot that share some structural property. These regions often correspond to meaningful narrative units (political factions, families, social circles) that aren't explicitly labeled in the text.
+
+In *Hamlet*, the "region of death" emerges: characters connected to both Claudius and Hamlet (Polonius, Gertrude, Laertes, Ophelia, Rosencrantz, Guildenstern) are all killed. The network makes this visible as a structural property — "what is truly deadly is the characters' position in the network, chained to the warring poles of king and prince."
+
+The Court hexagon (Hamlet, Claudius, Gertrude, Polonius, Ophelia, Laertes) forms the densest region with 100% clustering. Outside this dense core, peripheral characters like Horatio inhabit sparser regions with different structural properties.
+
+## Key insight
+
+Regions are emergent — they arise from the pattern of connections, not from authorial labels. ==This means network analysis can discover groupings the author may not have consciously designed.==
+
+## Links
+
+- [[character-networks-model-plot-as-space-not-time]]
+- [[clustering-explains-structural-importance-of-characters]]
+- [[protagonist-defined-by-network-stability-not-centrality]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/power-law-distribution-in-character-networks.md b/docs/knowledge/v3_narratology/moretti2011/power-law-distribution-in-character-networks.md
new file mode 100644
index 0000000..99bb606
--- /dev/null
+++ b/docs/knowledge/v3_narratology/moretti2011/power-law-distribution-in-character-networks.md
@@ -0,0 +1,22 @@
+# Character networks follow power-law distribution
+
+Source: Moretti 2011, "Network Theory, Plot Analysis"
+
+The degree distribution of character networks (how many connections each character has) follows a power-law: very few characters have many edges, and very many characters have just one or two.
+
+This holds across Shakespeare's tragedies — *Hamlet*, *Macbeth*, *Lear*, *Othello* all show the same pattern. There is no "average" or "typical" character. The distribution has no central tendency.
+
+This is the opposite of a Gaussian curve: "there is no central tendency in the distribution, no 'average'; that is to say, there is no 'typical' vertex in the network, and *no typical character in the plays*."
+
+Moretti argues this invalidates speaking of "Shakespeare's characters in general" — at least in the tragedies — because the power-law means characters exist on a continuum from hyper-connected to barely present, with no natural grouping point.
+
+## Implications for tvplotlines
+
+Степенное распределение связей означает, что в сети есть несколько хабов (hyper-connected characters) и много периферийных персонажей. Каждый хаб — центр своей подсети (региона). Эти подсети могут соответствовать сюжетным линиям: A-story — подсеть вокруг главного хаба, B-story — вокруг второго, и т.д. Персонажи на пересечении подсетей (как Гертруда между Hamlet-space и Claudius-space) участвуют в нескольких сюжетных линиях. Removal experiment [[moc-pipeline-ideas]] может верифицировать: если удаление хаба разрушает подсеть — это реальная сюжетная линия с ядром.
+
+## Links
+
+- [[protagonist-defined-by-network-stability-not-centrality]]
+- [[character-networks-model-plot-as-space-not-time]]
+- [[network-regions-reveal-plot-subsystems]]
+- [[removal-experiments-reveal-structural-roles]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/protagonist-constrainted-by-relational-structure.md b/docs/knowledge/v3_narratology/moretti2011/protagonist-constrainted-by-relational-structure.md
new file mode 100644
index 0000000..54c358c
--- /dev/null
+++ b/docs/knowledge/v3_narratology/moretti2011/protagonist-constrainted-by-relational-structure.md
@@ -0,0 +1,19 @@
+# The protagonist is not free — they are constrained by the relational structure
+
+Source: Moretti 2011, "Network Theory, Plot Analysis"
+
+Moretti's analysis of Bao-yu in *The Story of the Stone* reveals a counter-intuitive property of protagonists: the protagonist is "not free" precisely because they are the most connected. Each chapter reshuffles Bao-yu's connections — he speaks to 54 different characters in the first 20 chapters — but "not once does the same group reform around him."
+
+The protagonist has "a duty *towards the structure*: towards the relation-based society he is part of." This is unlike the Bildungsroman protagonist (Elizabeth Bennet) who is free to shape her own life. The network-constrained protagonist must maintain the connective tissue of the social world.
+
+This suggests two different protagonist types visible through network analysis:
+1. **Hub protagonist** — maintains network cohesion, constrained by connections (Bao-yu, Hamlet)
+2. **Journey protagonist** — moves through the network, transforming connections (Bennet)
+
+These correspond to different genres and cultural traditions: the relational Chinese novel vs. the individualist Western Bildungsroman.
+
+## Links
+
+- [[protagonist-defined-by-network-stability-not-centrality]]
+- [[guanxi-networks-manufacture-social-obligation]]
+- [[removal-experiments-reveal-structural-roles]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/protagonist-defined-by-network-stability-not-centrality.md b/docs/knowledge/v3_narratology/moretti2011/protagonist-defined-by-network-stability-not-centrality.md
new file mode 100644
index 0000000..1400b11
--- /dev/null
+++ b/docs/knowledge/v3_narratology/moretti2011/protagonist-defined-by-network-stability-not-centrality.md
@@ -0,0 +1,23 @@
+# Protagonist is defined by network stability, not centrality
+
+Source: Moretti 2011, "Network Theory, Plot Analysis"
+
+Moretti's key finding: the protagonist is not simply the most central character (highest degree, most connections). The protagonist is the character whose **removal most destabilizes the network**.
+
+In *Hamlet*, Claudius is almost as central as Hamlet (average distance 1.62 vs 1.45). Removing Claudius barely affects the network. But removing Hamlet splits the network almost in half — the court on one side, Ghost and Fortinbras on the other. Removing Hamlet and then Horatio completely fragments the play.
+
+This is the "removal experiment": take the network, delete a character, and observe what happens to the remaining structure. The protagonist is the one whose absence causes maximum fragmentation.
+
+This redefines the protagonist in structural terms: not "who is in the most scenes" or "who talks the most," but "who holds the network together." The protagonist's function is **stability** — they are the connective tissue of the plot.
+
+## Implications for tvplotlines
+
+- Protagonist detection could be formalized as: find the character whose removal maximizes network fragmentation (measured by number of connected components, or increase in average path length).
+- This is computationally tractable — it's essentially computing vertex connectivity.
+
+## Links
+
+- [[character-networks-model-plot-as-space-not-time]]
+- [[network-regions-reveal-plot-subsystems]]
+- [[removal-experiments-reveal-structural-roles]]
+- [[power-law-distribution-in-character-networks]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/removal-experiments-reveal-structural-roles.md b/docs/knowledge/v3_narratology/moretti2011/removal-experiments-reveal-structural-roles.md
new file mode 100644
index 0000000..9e25dfe
--- /dev/null
+++ b/docs/knowledge/v3_narratology/moretti2011/removal-experiments-reveal-structural-roles.md
@@ -0,0 +1,28 @@
+# Removal experiments reveal structural roles of characters
+
+Source: Moretti 2011, "Network Theory, Plot Analysis"
+
+Once you have a character network, you can **intervene** on the model: remove a character and observe what happens to the remaining structure. This is the most powerful analytical technique Moretti demonstrates.
+
+The procedure:
+1. Build the full network
+2. Remove a character (delete vertex and all its edges)
+3. Measure: does the network fragment? Into how many components? How does average distance change?
+
+Results for *Hamlet*:
+- Remove Hamlet → network nearly splits in half (court vs. Ghost+Fortinbras)
+- Remove Claudius → minor peripheral effects, network stays intact
+- Remove Hamlet + Horatio → complete fragmentation, beginning and ending severed from rest
+- Remove Hamlet + Claudius → less dramatic than removing Hamlet + Horatio
+
+This reveals that **quantitative centrality and structural importance diverge**: Claudius is almost as central as Hamlet by degree metrics, but structurally dispensable. Horatio is less central than Claudius but far more important structurally.
+
+## The method as tool
+
+This is essentially a computational thought experiment — "what if this character didn't exist?" — that can be automated. For any network, you can rank characters by the fragmentation their removal causes.
+
+## Links
+
+- [[protagonist-defined-by-network-stability-not-centrality]]
+- [[clustering-explains-structural-importance-of-characters]]
+- [[character-networks-model-plot-as-space-not-time]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/symmetry-emerges-in-small-chapter-networks.md b/docs/knowledge/v3_narratology/moretti2011/symmetry-emerges-in-small-chapter-networks.md
new file mode 100644
index 0000000..7eb69b9
--- /dev/null
+++ b/docs/knowledge/v3_narratology/moretti2011/symmetry-emerges-in-small-chapter-networks.md
@@ -0,0 +1,20 @@
+# Symmetry emerges naturally in small chapter-level networks
+
+Source: Moretti 2011, "Network Theory, Plot Analysis"
+
+When Moretti switches from whole-play networks to chapter-level networks in Dickens (*Our Mutual Friend*), a striking pattern appears: binary symmetry. Chapters consistently organize around pairs — husband and wife, parent and child, brother and sister, suitor and beloved, rival and rival.
+
+Two reasons for this:
+1. **Dickens builds from binary pairs** — relationships are dualistic by nature
+2. **With few characters, there's little "noise" to disrupt the pattern** — the binaries project cleanly onto the chapter structure
+
+This symmetry in Dickens contrasts with the **asymmetry** Moretti finds in *The Story of the Stone* (Chinese novel). Chinese aesthetic tradition values symmetry explicitly — "parallel prose," hemispheric structure — but with hundreds of characters per chapter, the symmetry becomes local (within scenes) while the chapter as a whole is asymmetric.
+
+## The principle
+
+Symmetry and character count are inversely related: symmetry emerges with few characters, breaks down with many. "If with few characters symmetry emerges almost by itself, with *many* characters it becomes implausible."
+
+## Links
+
+- [[character-networks-model-plot-as-space-not-time]]
+- [[guanxi-networks-manufacture-social-obligation]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/weak-ties-connect-narrative-regions.md b/docs/knowledge/v3_narratology/moretti2011/weak-ties-connect-narrative-regions.md
new file mode 100644
index 0000000..8ee5e38
--- /dev/null
+++ b/docs/knowledge/v3_narratology/moretti2011/weak-ties-connect-narrative-regions.md
@@ -0,0 +1,21 @@
+# Weak ties connect narrative regions and point beyond the main story world
+
+Source: Moretti 2011, "Network Theory, Plot Analysis"
+
+Horatio in *Hamlet* is the paradigmatic weak tie: low clustering, few intense connections, but a wide radius. His connections are "less intense, but with a wider radius; and more impersonal, almost bureaucratic" — like the ties Graham Sack described in *Bleak House*.
+
+The peripheral characters connected through weak ties often point to the world **beyond** the central story world. In *Hamlet*, the characters with the fewest connections (one link to the network) are links to places beyond Elsinore: Cornelius and Voltemand to Norway, Reynaldo to France, the sailor to England. These "centrifugal threads" are the "tendrils" that gesture toward the larger world.
+
+Horatio's function is unique: "a function in the plot, but not a motivation. No aim, no emotions — no *language*, really, worthy of *Hamlet*." He's structurally critical but narratively flat — his style matches the State bureaucracy, not the Court's melodrama.
+
+## Key insight
+
+Weak ties serve a dual function in narrative:
+1. **Structural**: they hold the network together by bridging disconnected regions
+2. **Thematic**: they represent the outside world, the context beyond the main conflict
+
+## Links
+
+- [[clustering-explains-structural-importance-of-characters]]
+- [[network-regions-reveal-plot-subsystems]]
+- [[protagonist-defined-by-network-stability-not-centrality]]
diff --git a/docs/knowledge/v3_narratology/narratological-canon.md b/docs/knowledge/v3_narratology/narratological-canon.md
new file mode 100644
index 0000000..8b402eb
--- /dev/null
+++ b/docs/knowledge/v3_narratology/narratological-canon.md
@@ -0,0 +1,76 @@
+---
+type: research
+project: tvplotlines
+status: active
+---
+
+# Нарратологический канон
+
+Работы, на которые ссылаются множественные seed-статьи из v3 narratology research. Отсортированы хронологически. Источники пересечений указаны в скобках.
+
+## Классический фундамент
+
+- **Propp (1928/1959)** — "Morphology of the Folktale". 31 функция волшебной сказки. Первая формальная модель сюжета. (Liu, Balestri, Hamilton)
+- **Todorov (1969/1971)** — "Structural Analysis of Narrative", "The 2 Principles of Narrative". Трансформация состояний как основа нарратива. (Liu, Balestri, Balestri-Memory)
+- **Freytag (1895)** — "Technique of the Drama". Пирамида: exposition → rising action → climax → falling action → denouement. (Hamilton, Elkins)
+- **Chatman (1979)** — "Story and Discourse: Narrative Structure in Fiction and Film". Разделение story (что) и discourse (как). (Liu)
+- **Genette (1980, 1997)** — "Narrative Discourse", "Palimpsests", "Paratexts". Фокализация, order, duration, frequency, voice. Narrative triangle: story/discourse/narration. (Liu, Balestri, Hamilton)
+- **Prince (1982, 1989, 2008)** — "Narratology", "A Dictionary of Narratology", "Classical and/or Postclassical Narratology". Формальные определения. (Liu)
+- **Bal (1988)** — "Narratology: Introduction to the Theory of Narrative". Учебник, стандартное введение. (Liu)
+
+## Когнитивный и постклассический поворот
+
+- **Brewer & Lichtenstein (1980, 1982)** — "Event schemas, story schemas, and story grammars", "Stories Are to Entertain: A Structural-Affect Theory". (Liu, Hamilton)
+- **Trabasso & van den Broek (1985)** — "Causal thinking and the representation of narrative events". Каузальные цепочки. (Liu)
+- **Bruner (1985, 1991)** — "Actual Minds, Possible Worlds", "The Narrative Construction of Reality". Нарратив как способ познания. (Liu, Hamilton, Keith)
+- **Ricoeur (1988)** — "Time and Narrative". Время и нарратив, mimesis I-II-III. (Hamilton)
+- **Sternberg (1992)** — "Telling in Time (II): Chronology, Teleology, Narrativity". Suspense, curiosity, surprise как нарративные эффекты. (Hamilton)
+- **Herman (1997, 2009)** — "Scripts, Sequences, and Stories: Elements of a Postclassical Narratology", "Basic Elements of Narrative". Situatedness как четвёртое измерение. (Liu, Hamilton)
+- **Labov & Waletzky (1997)** — "Narrative analysis: Oral versions of personal experience". Структура устного нарратива: abstract, orientation, complicating action, evaluation, resolution, coda. (Hamilton)
+- **Fludernik (2002, 2010)** — "Towards a 'Natural' Narratology", "Postclassical Narratology: Approaches and Analyses". Experientiality как основа нарратива. (Liu, Hamilton)
+
+## Когнитивная наука о нарративе
+
+- **Schank (1983)** — "Dynamic Memory: A Theory of Reminding and Learning". Scripts и планы. (Balestri-Memory)
+- **Minsky (1987)** — "The Society of Mind". Фреймы. (Balestri-Memory)
+- **Graesser, Singer, Trabasso (1994)** — "Constructing inferences during narrative text comprehension". (Balestri-Memory)
+- **Squire & Zola (1996)** — "Structure and function of declarative and nondeclarative memory systems". (Balestri-Memory)
+- **Tulving & Markowitsch (1998)** — "Episodic and declarative memory". (Balestri-Memory)
+- **Zwaan & Radvansky (1998)** — "Situation models in language comprehension and memory". (Keith)
+- **Kintsch (1998)** — "Comprehension: A Paradigm for Cognition". (Keith)
+- **Baddeley (2003)** — "Working memory and language". (Balestri-Memory)
+- **Zacks et al. (2007)** — "Event perception: a mind-brain perspective". (Balestri-Memory)
+- **Mar (2011)** — "The neural bases of social cognition and story comprehension". (Hamilton)
+
+## Computational narratology
+
+- **Chambers & Jurafsky (2008, 2009, 2010)** — Narrative event chains, narrative schemas. Первые вычислительные модели нарративных структур. (Hamilton)
+- **Moretti (2005, 2011)** — "Graphs, Maps, Trees", "Network theory, plot analysis". Distant reading. (Liu)
+- **Hogan (2011)** — "Affective Narratology: The Emotional Structure of Stories". (Hamilton)
+- **Reagan et al. (2016)** — "The emotional arcs of stories are dominated by six basic shapes". 6 форм. (Liu, Balestri, Hamilton, Elkins)
+- **Piper, So, Bamman (2021)** — "Narrative Theory for Computational Narrative Understanding". Мост между нарратологией и NLP. (Liu, Balestri, Hamilton)
+- **Elkins (2022)** — "The Shapes of Stories: Sentiment Analysis for Narrative". Методология sentiment arc. (Liu, Hamilton)
+
+## Transmedial и TV narratology
+
+- **Mittell (2015)** — "Complex TV: The Poetics of Contemporary Television Storytelling". Сложность ТВ-нарратива. (Balestri, Balestri-Memory)
+- **Thon (2016)** — "Transmedial Narratology and Contemporary Media Culture". (Liu)
+- **Ryan (2016)** — "Narrating Space / Spatializing Narrative". (Hamilton)
+- **Innocenti & Pescatore (2017, 2018)** — "Narrative Ecosystems", "Evolution of Characters in TV Series". (Balestri-Memory)
+- **Rocchi & Pescatore (2022)** — "Modeling narrative features in TV series". (Balestri, Balestri-Memory)
+
+## Семиотика и формализм
+
+- **Shklovsky (1919/2019)** — "Art as Technique". Остранение. (Liu)
+- **Kristeva (1984)** — "Desire in Language: A Semiotic Approach to Literature and Art". (Hamilton)
+- **Russian Formalism** — Lemon & Reis (1968), Bann & Bowlt (1974). (Liu, Hamilton)
+
+## Релевантность для tvplotlines v3
+
+Три кластера которые могут дать альтернативные промпты:
+
+1. **Структуралистский** (Propp → Genette → Bal): формальные модели с чёткими категориями. Ближе всего к текущим промптам (Story DNA ≈ актантная модель, narrative functions ≈ Propp's functions).
+
+2. **Когнитивный** (Bruner → Herman → Zacks → Baddeley): нарратив как когнитивный процесс. Может дать промпты через призму восприятия: что зритель запоминает, что удивляет, что создаёт suspense.
+
+3. **Affective/sentiment** (Reagan → Elkins → Hogan): эмоциональная дуга как измеримая структура. Может дать дополнительное измерение без переписывания основных промптов.
diff --git a/docs/knowledge/v3_narratology/ouyang-mckeown2015/change-in-metrics-predicts-turning-points-not-absolute-values.md b/docs/knowledge/v3_narratology/ouyang-mckeown2015/change-in-metrics-predicts-turning-points-not-absolute-values.md
new file mode 100644
index 0000000..195809b
--- /dev/null
+++ b/docs/knowledge/v3_narratology/ouyang-mckeown2015/change-in-metrics-predicts-turning-points-not-absolute-values.md
@@ -0,0 +1,40 @@
+# Change in metrics predicts turning points, not absolute values
+
+Source: Ouyang & McKeown 2015, "Modeling Reportable Events as Turning Points in Narrative" (pp. 4-6)
+
+The paper's central empirical finding: **it's the change (slope) in narrative metrics that predicts MREs, not the metric values themselves.** Using change-based features alone significantly outperforms all baselines; adding absolute metric values barely improves results.
+
+## Three dimensions of change
+
+The authors track sentence-level metrics across the narrative:
+
+**1. Syntactic change** — formality and complexity. MRE sentences tend to be long (complex structure) but with short, informal words. There's a drop in formality near the MRE — Labov observed that people speak less formally as they relive the climax of their stories.
+
+**2. Semantic change** — similarity to surrounding sentences. Expected: MRE should be dissimilar (shocking). Found: MRE sentences are actually *similar* to adjacent sentences, because MREs tend to be described across multiple consecutive sentences rather than in a single shocking line.
+
+**3. Affective change** — pleasantness, activeness, imagery (using the Dictionary of Affect in Language). The MRE is:
+- Global maximum in **activation** (excitement/intensity)
+- Global minimum in **pleasantness** (most negative emotional valence)
+- Peak in **imagery** (vivid, concrete language)
+
+The overall shape of activeness scores reflects Prince's minimal story: low initial activation (starting state) → high final activation (ending state) → peak at the MRE (change of state).
+
+## Top predictive features
+
+1. **Incoming imagery change** (sharp increase in vivid language at MRE)
+2. **Distance from formality minimum** (MRE near the least formal point)
+3. **Cosine similarity to adjacent sentences** (MRE described over multiple sentences)
+4. **Distance from activeness minimum** (MRE far from the stative orientation)
+5. **Sentence depth** (MRE sentences are syntactically complex)
+
+## What this means for tvplotlines
+
+We don't have access to linguistic features in synopses (they're written by summarizers, not narrators). But the principle transfers: **turning points are identified by change, not by absolute position.** Our current function assignment is positional (climax = near the end, setup = near the beginning). A change-based approach would instead ask: where do the stakes shift most dramatically? Where does the direction change?
+
+This also connects to Bremond's model: the transition from improvement to deterioration (or vice versa) is a *change in direction* — exactly the kind of slope change that predicts MREs.
+
+## Links
+
+- [[most-reportable-event-is-the-point-of-the-story]]
+- [[narrative-cycle-has-three-phases-not-seven]]
+- [[labov-narrative-structure-maps-to-six-components]]
diff --git a/docs/knowledge/v3_narratology/ouyang-mckeown2015/labov-narrative-structure-maps-to-six-components.md b/docs/knowledge/v3_narratology/ouyang-mckeown2015/labov-narrative-structure-maps-to-six-components.md
new file mode 100644
index 0000000..677255c
--- /dev/null
+++ b/docs/knowledge/v3_narratology/ouyang-mckeown2015/labov-narrative-structure-maps-to-six-components.md
@@ -0,0 +1,37 @@
+# Labov's narrative structure maps to six components
+
+Source: Ouyang & McKeown 2015, "Modeling Reportable Events as Turning Points in Narrative" (p. 2), drawing on Labov 1967/1997/2013
+
+Labov's model of oral narrative has six components, which the paper uses as the backbone of their change-based analysis:
+
+| Component | Function | Maps to tvplotlines |
+|---|---|---|
+| **Abstract** | Brief intro, sometimes refers to the MRE | ~ story_engine / logline |
+| **Orientation** | Background information, starting state | ~ setup |
+| **Complicating Action** | Chain of events leading up to MRE | ~ escalation, turning_point |
+| **Evaluation** | Author's/narrator's perspective on events — why this matters | *no equivalent* |
+| **Resolution** | Ending state, what finally happened | ~ resolution |
+| **Coda** | Wrapping up, returning to the present | *no equivalent* |
+
+## The missing piece: Evaluation
+
+The most interesting component for us is **Evaluation** — the narrator's commentary on *why* events matter. Labov (2013) has three subcomponents:
+- **Orientation** (background)
+- **Complicating action** (events leading to MRE)
+- **Evaluation** (the narrator's perspective)
+
+Plus the **Abstract** and **Coda** which frame the narrative.
+
+Our pipeline has no equivalent of Evaluation. We extract *what happens* (events) and *what function it serves* (setup/climax/etc.), but we don't capture *why it matters* — the narrator's or showrunner's emphasis on significance.
+
+In TV analysis, Evaluation manifests as: voice-over commentary, lingering camera shots, musical scoring, characters' emotional reactions. These are text-level signals that we lose in synopses. But even synopses sometimes contain evaluative language ("in a shocking twist," "devastated by the news") that we currently ignore.
+
+## What this means for tvplotlines
+
+Labov's six components are an alternative to Freytag's seven functions. The mapping isn't 1:1 — Labov adds Evaluation and Abstract, loses crisis/inciting_incident as separate categories. The key insight is that Evaluation is structurally distinct from the events themselves: it's not *what happens* but *how the telling emphasizes what matters*.
+
+## Links
+
+- [[most-reportable-event-is-the-point-of-the-story]]
+- [[change-in-metrics-predicts-turning-points-not-absolute-values]]
+- [[three-layer-model-separates-text-story-fabula]]
diff --git a/docs/knowledge/v3_narratology/ouyang-mckeown2015/most-reportable-event-is-the-point-of-the-story.md b/docs/knowledge/v3_narratology/ouyang-mckeown2015/most-reportable-event-is-the-point-of-the-story.md
new file mode 100644
index 0000000..8437bc2
--- /dev/null
+++ b/docs/knowledge/v3_narratology/ouyang-mckeown2015/most-reportable-event-is-the-point-of-the-story.md
@@ -0,0 +1,30 @@
+# The Most Reportable Event is the point of the story
+
+Source: Ouyang & McKeown 2015, "Modeling Reportable Events as Turning Points in Narrative" (pp. 1-2), drawing on Labov 1967/1997, Prince 1973, Polanyi 1976
+
+The **Most Reportable Event (MRE)** is the nucleus of the story — the most unusual event with the greatest emotional impact on the narrator and audience. It's the answer to "So what?" and the shortest possible summary of a story.
+
+Polanyi (1976): "one does not produce a narrative text for no reason at all." The MRE is that reason.
+
+Prince (1973) defines a minimal story as three parts: a starting state, an ending state, and the event that transforms one into the other. For a story to be interesting, that change-of-state event should be the MRE.
+
+Labov (1967/1997) defines a well-formed narrative as a series of actions leading to the MRE. The narrative builds toward it — it's where the story has been heading all along.
+
+## MRE vs climax
+
+The MRE maps to our "climax" function, but with an important difference: climax is defined positionally (peak of conflict), while MRE is defined by **reportability** — what makes the story worth telling. A climax can be structurally necessary but unremarkable. An MRE is by definition remarkable.
+
+The MRE test: "If I could only say one thing about this story, what would it be?" That's the MRE.
+
+## What this means for tvplotlines
+
+Our pass4 assigns `plot_fn: climax` to the peak event of each plotline's season arc. But we don't ask *why* that event is the peak — we just look for the structural turning point. The MRE concept suggests an additional question: **is this event the most reportable one?** The one that makes the plotline worth watching?
+
+For plotline ranking (A/B/C in pass3), MRE identification could help: the A-story is the one whose MRE is most reportable.
+
+## Links
+
+- [[change-in-metrics-predicts-turning-points-not-absolute-values]]
+- [[labov-narrative-structure-maps-to-six-components]]
+- [[narrative-cycle-has-three-phases-not-seven]]
+- [[constituent-vs-supplementary-events]]
diff --git a/docs/knowledge/v3_narratology/piper-so-bamman2021/character-attributes-and-relations-are-distinct-tasks.md b/docs/knowledge/v3_narratology/piper-so-bamman2021/character-attributes-and-relations-are-distinct-tasks.md
new file mode 100644
index 0000000..f76f7c6
--- /dev/null
+++ b/docs/knowledge/v3_narratology/piper-so-bamman2021/character-attributes-and-relations-are-distinct-tasks.md
@@ -0,0 +1,28 @@
+# Character attribute inference and relation detection are distinct tasks
+
+Source: Piper, So, Bamman 2021, "Narrative Theory for Computational Narrative Understanding" (pp. 300-301)
+
+The paper distinguishes three NLP tasks related to narrative agents:
+
+**1. Agent detection** — recognizing characters in text, including non-named entities ("the coachman," "the frog"). NLP has focused on NER, but narrative requires broader "animacy detection" (Vala et al. 2015, Karsdorp et al. 2015).
+
+**2. Character attribute inference** — inferring properties of characters: gender, ethnicity, religion, emotion, function, power. Propp (2010/1968) theorized character as a limited set of narrative "functions." Forster (1985) introduced round/flat distinction. Recent NLP work includes: desire fulfillment (Chaturvedi et al. 2016), psychology (Rashkin et al. 2018), representations of gender (Underwood et al. 2018), power (Sap et al. 2017).
+
+**3. Relation detection** — how characters are "connected" or "interacting." Methods range from co-occurrence to supervised models. The challenge: identifying character *pairs* (siblings, parent-child) is extremely difficult, especially when information is expressed across multiple statements or left implicit.
+
+The paper notes that Propp (2010) used "character schemas" — fixed sets of relations (protagonist/antagonist/helper) — but supervised models that presume these fixed sets may miss the complexity of real narratives.
+
+## What this means for tvplotlines
+
+Our pipeline does agent detection (cast identification in pass1) and implicitly captures relations through plotline structure (who is in which plotline implies their narrative role). But we don't do explicit **character attribute inference** — we don't tag characters with traits, competences, or power dynamics.
+
+Bal's actant model (Subject/Object/Power/Receiver/Helper/Opponent) is essentially a structured approach to relation detection. If we adopt it, we'd be doing what Piper et al. describe as the intersection of attribute inference (what role does this character play?) and relation detection (how do characters relate to each other within the plotline structure?).
+
+The paper also flags **truth value** as a challenge: characters' apparent roles can differ from real ones. This aligns with Bal's truth value concept.
+
+## Links
+
+- [[actant-model-has-six-roles-not-four]]
+- [[anti-subject-signals-a-separate-storyline]]
+- [[truth-value-reveals-apparent-vs-real-roles]]
+- [[ten-elements-define-degrees-of-narrativity]]
diff --git a/docs/knowledge/v3_narratology/piper-so-bamman2021/events-scenes-plotlines-form-a-hierarchy.md b/docs/knowledge/v3_narratology/piper-so-bamman2021/events-scenes-plotlines-form-a-hierarchy.md
new file mode 100644
index 0000000..6d57c30
--- /dev/null
+++ b/docs/knowledge/v3_narratology/piper-so-bamman2021/events-scenes-plotlines-form-a-hierarchy.md
@@ -0,0 +1,44 @@
+# Events, scenes, and plotlines form a hierarchy
+
+Source: Piper, So, Bamman 2021, "Narrative Theory for Computational Narrative Understanding" (pp. 301-302)
+
+The paper proposes a hierarchical scheme for narrative structure at the document level:
+
+```
+events → scenes → plotlines
+```
+
+- **Events** — the atomic units of narrative action (change of state)
+- **Scenes** — contiguous sequences of events grouped by time/place/characters (passage-level segments)
+- **Plotlines** — higher-level arcs that span multiple scenes across a narrative
+
+This hierarchy maps onto passage-level and document-level NLP challenges:
+
+**Passage-level:**
+- **Narrative detection** — is this passage narrative at all (vs. descriptive, argumentative)?
+- **Scene detection** — where are the boundaries between story segments?
+
+**Document-level:**
+- **Plotline detection** — identifying the through-lines that connect events across scenes
+- The authors propose the shorthand: **event-scene-plotline**
+
+## Relation to existing frameworks
+
+Ouyang and McKeown (2014) — cited here — "leverage the categorization of narrative structure by Labov and Waletzky (1967), focusing specifically on the 'most reportable event (MRE)' as an indicator of a narrative's more general meaning."
+
+The paper also cites Boyd et al. (2020) on "the narrative arc" — revealing core narrative structures through text analysis — as showing that "sentiment valence" approximates narrative structure but much more work needs to be done on formal and cognitive conditions of narrative pivots.
+
+## What this means for tvplotlines
+
+Our pipeline implicitly uses this hierarchy: pass2 extracts events, pass1 defines plotlines, but we skip the **scene** level entirely. We go directly from sentences → events → plotlines. There's no intermediate grouping of events into scenes.
+
+For TV, "scene" is actually a natural unit — episodes are composed of scenes. If synopses described scenes (rather than just events), we'd have a richer intermediate representation. Our synopsis_writer prompt could be modified to produce scene-level descriptions.
+
+The hierarchy also clarifies our pipeline's architecture: pass2 does event extraction + plotline assignment simultaneously, but these are conceptually two different tasks at two different levels.
+
+## Links
+
+- [[ten-elements-define-degrees-of-narrativity]]
+- [[constituent-vs-supplementary-events]]
+- [[most-reportable-event-is-the-point-of-the-story]]
+- [[narrative-cycle-has-three-phases-not-seven]]
diff --git a/docs/knowledge/v3_narratology/piper-so-bamman2021/no-single-approach-universally-fits-narrative-structure.md b/docs/knowledge/v3_narratology/piper-so-bamman2021/no-single-approach-universally-fits-narrative-structure.md
new file mode 100644
index 0000000..50d99e5
--- /dev/null
+++ b/docs/knowledge/v3_narratology/piper-so-bamman2021/no-single-approach-universally-fits-narrative-structure.md
@@ -0,0 +1,33 @@
+# No single approach universally fits narrative structure
+
+Source: Piper, So, Bamman 2021, "Narrative Theory for Computational Narrative Understanding" (p. 302)
+
+A crucial warning from the paper: "it is important to emphasize here that no single approach is universally appropriate to understanding narrative structure."
+
+Fields as diverse as folkloristics and narrative psychology provide competing models. The best-known classification systems for fictional narratives are:
+- **Thompson's Motif-Index of Folk-Literature** (1989)
+- **Aarne-Thompson-Uther (ATU) Tale Index**
+- **Adler et al. (2016)** — narrative psychology taxonomy correlated with life satisfaction
+
+These classification systems have seen only limited computational implementation (Broadwell et al. 2018). The cross-disciplinary computational implementation of large-scale story type classifiers "represents a major research challenge."
+
+## Two levels of temporal analysis
+
+The paper distinguishes two temporal levels:
+1. **"Time of telling"** (narrative time) — the order in which events are presented
+2. **"Time of what is told"** (narrated time) — the chronological order in the fabula
+
+This maps directly to Bal's story-time vs fabula-time distinction. Underwood (2018) provides an empirical approach to this with the concept of "passage of time" in novels.
+
+## What this means for tvplotlines
+
+This is a useful sanity check against over-committing to any single narratological framework. We shouldn't replace Freytag with Bremond and then treat Bremond as gospel. The right approach is probably **layered**: keep multiple lenses (Freytag for positional structure, Bremond for process direction, Labov for reportability) and let them complement each other rather than picking one.
+
+For our v3 prompts, this suggests: don't replace the seven functions, **add dimensions** alongside them. An event can simultaneously be an "escalation" (Freytag), a "realization of deterioration" (Bremond), and the "most reportable event" (Labov). Each lens captures something different.
+
+## Links
+
+- [[narrative-cycle-has-three-phases-not-seven]]
+- [[most-reportable-event-is-the-point-of-the-story]]
+- [[sequential-ordering-separates-fabula-time-from-story-time]]
+- [[ten-elements-define-degrees-of-narrativity]]
diff --git a/docs/knowledge/v3_narratology/piper-so-bamman2021/ten-elements-define-degrees-of-narrativity.md b/docs/knowledge/v3_narratology/piper-so-bamman2021/ten-elements-define-degrees-of-narrativity.md
new file mode 100644
index 0000000..61ba2fc
--- /dev/null
+++ b/docs/knowledge/v3_narratology/piper-so-bamman2021/ten-elements-define-degrees-of-narrativity.md
@@ -0,0 +1,49 @@
+# Ten elements define degrees of narrativity
+
+Source: Piper, So, Bamman 2021, "Narrative Theory for Computational Narrative Understanding" (pp. 299-300)
+
+Instead of a binary "is this a narrative or not," the authors propose a minimal definition where narrativity exists in **degrees** — the more elements are explicitly present, the more narrative the text:
+
+```
+A  Someone          (teller)
+B  tells
+C  someone          (recipient)
+D  somewhere        (situation/context)
+E     someone       (agent)
+F     did something (sequential actions)
+G     [to someone]  (potential object)
+H     somewhere     (spatial location)
+I     at some time  (temporal specification)
+J     for some reason (rationale)
+```
+
+These ten elements map to five research domains:
+- **Agents** (E, G) — character detection, attributes, relations
+- **Events** (F) — extraction, ordering, structure
+- **Temporality** (I) — when things happen, narrative time vs narrated time
+- **Setting** (H) — where things happen
+- **Perspective** (A, B, C) — who tells, to whom, from what viewpoint
+
+The "degrees of narrativity" hypothesis: recipients' response to narrativity increases as more of these variables are made explicit.
+
+## Comparison with Bal
+
+Bal's three layers (text/story/fabula) map onto these elements but from a different angle. Bal organizes by *analytical level* — where in the abstraction hierarchy you're working. Piper et al. organize by *what kind of information* you're extracting. Their framework is more operational for building an NLP pipeline.
+
+## What this means for tvplotlines
+
+Our pipeline covers some of these elements well and ignores others:
+- **Agents** (E, G): ✅ cast identification, plotline heroes
+- **Events** (F): ✅ event extraction and function assignment
+- **Temporality** (I): ⚠️ episode ordering only, no within-episode temporal analysis
+- **Setting** (H): ❌ no spatial analysis at all
+- **Perspective** (A, B, C): ❌ no focalization analysis (lost in synopses)
+- **Rationale** (J): ❌ no "why" — which connects to Labov's missing Evaluation component
+
+The gaps (setting, perspective, rationale) are partly inherent to working with synopses rather than full scripts. But rationale (J) is the most actionable gap — it maps to "why does this plotline matter."
+
+## Links
+
+- [[three-layer-model-separates-text-story-fabula]]
+- [[labov-narrative-structure-maps-to-six-components]]
+- [[events-scenes-plotlines-form-a-hierarchy]]
diff --git a/docs/knowledge/v3_narratology/santana-2022-narrative-extraction-survey.md b/docs/knowledge/v3_narratology/santana-2022-narrative-extraction-survey.md
new file mode 100644
index 0000000..c04fec2
--- /dev/null
+++ b/docs/knowledge/v3_narratology/santana-2022-narrative-extraction-survey.md
@@ -0,0 +1,39 @@
+---
+type: research
+project: tvplotlines
+status: active
+source: https://link.springer.com/article/10.1007/s10462-022-10338-7
+doi: 10.1007/s10462-022-10338-7
+year: 2022
+authors: [Santana, Campos, Amorim, Jorge, Silvano, Nunes]
+venue: Artificial Intelligence Review
+---
+
+# A Survey on Narrative Extraction from Textual Data
+
+## Summary
+
+Обзор подходов к извлечению нарратива из текста. Организован по pipeline задач: от raw text до структурированного нарратива. Покрывает computational linguistics и AI подходы. Pre-LLM survey — показывает состояние поля до GPT-эры.
+
+## Key concepts
+
+- **Narrative extraction pipeline** — последовательность задач от текста к структуре
+- **Entity extraction** — персонажи, локации, объекты
+- **Event extraction** — действия, изменения состояний
+- **Relation extraction** — связи между событиями и персонажами
+- **Timeline construction** — темпоральное упорядочивание событий
+
+## Why this matters
+
+Фундаментальный обзор до-LLM эпохи. Все 2024-2025 работы на него ссылаются. Показывает какие задачи решались классическими методами (и где LLM их превзошли).
+
+## Relevance to tvplotlines
+
+Pipeline-структура этого обзора зеркалит pipeline tvplotlines. Полезно для сравнения: что tvplotlines делает промптами, а что можно было бы делать кодом.
+
+## Connections
+
+- [[liu-2025-narrative-theory-survey]] — LLM-эра продолжение
+- [[chauvel-2022-narrative-structure-survey]] — параллельный обзор с лингвистическим фокусом
+- [[mani-2025-narrative-generative-ai]] — монография, покрывает обе эры
+- [[keith-2025-interactive-narrative-analytics]] — extraction как компонент INA
diff --git a/docs/knowledge/v3_narratology/todorov1971/five-part-sequence-is-richer-than-three-act-structure.md b/docs/knowledge/v3_narratology/todorov1971/five-part-sequence-is-richer-than-three-act-structure.md
new file mode 100644
index 0000000..341e513
--- /dev/null
+++ b/docs/knowledge/v3_narratology/todorov1971/five-part-sequence-is-richer-than-three-act-structure.md
@@ -0,0 +1,38 @@
+# The five-part sequence is richer than the three-act structure
+
+Source: Todorov 1971, "The 2 Principles of Narrative" (pp. 38-39), also Todorov's analysis of the Decameron
+
+The simplified "Todorov model" (equilibrium → disruption → new equilibrium) is widely taught but misses two crucial middle steps. The full five-part sequence:
+
+1. **Initial equilibrium** — a stable situation
+2. **Disruption** — a force disturbs the equilibrium
+3. **Recognition** — the disruption is acknowledged, understood
+4. **Attempt to repair** — action taken to restore or create new order
+5. **New equilibrium** — a different stable situation (not the same as the initial one)
+
+Steps 3 and 4 are what most summaries drop, but they're structurally important. The *recognition* that something has gone wrong is a separate narrative moment from the disruption itself. And the *attempt to repair* is where most of the narrative action happens — it's where characters exercise agency.
+
+## Comparison with other models
+
+| Todorov (5 parts) | Freytag (7 functions) | Bremond (3 phases) |
+|---|---|---|
+| Initial equilibrium | setup | — |
+| Disruption | inciting_incident | possibility |
+| Recognition | — (no equivalent) | — |
+| Attempt to repair | escalation, turning_point, crisis | realization |
+| New equilibrium | resolution | result |
+
+The key difference: Todorov adds **recognition** — the moment when characters (and the audience) realize that the equilibrium has been disturbed. This is narratively distinct from the disruption itself. In Breaking Bad, Walt getting cancer is the disruption; Walt *deciding to cook meth* is the recognition + beginning of repair attempt.
+
+Our pipeline's "inciting_incident" conflates disruption and recognition. Todorov would split them.
+
+## What this means for tvplotlines
+
+In practice, this means the current "inciting_incident" function may hide two distinct structural moments. For some plotlines, separating "what went wrong" (disruption) from "when the character decided to act" (recognition) could clarify the plotline's structure. This connects to Bal/Greimas's concept of **competence**: recognition is when the subject acquires *determination* (the will to act).
+
+## Links
+
+- [[two-principles-succession-and-transformation]]
+- [[competence-determines-when-subject-can-act]]
+- [[initial-situation-is-always-a-state-of-deficiency]]
+- [[most-reportable-event-is-the-point-of-the-story]]
diff --git a/docs/knowledge/v3_narratology/todorov1971/gnoseological-narrative-is-driven-by-knowledge-not-action.md b/docs/knowledge/v3_narratology/todorov1971/gnoseological-narrative-is-driven-by-knowledge-not-action.md
new file mode 100644
index 0000000..7547f07
--- /dev/null
+++ b/docs/knowledge/v3_narratology/todorov1971/gnoseological-narrative-is-driven-by-knowledge-not-action.md
@@ -0,0 +1,44 @@
+# Gnoseological narrative is driven by knowledge, not action
+
+Source: Todorov 1971, "The 2 Principles of Narrative" (pp. 39-42), from analysis of The Quest for the Grail
+
+Todorov identifies a distinct type of narrative: the **gnoseological** (knowledge-driven) narrative, where the organizing principle is not "what happens" but "what is learned."
+
+In The Quest for the Grail, the principal narrative is "a narrative of knowledge, not of action." Characters seek to understand the meaning of what they encounter. The events of the quest "are merely occasions for the exercise of interpretive faculties." The real narrative movement is from ignorance to understanding — not from state A to state B through physical action.
+
+Key characteristics of gnoseological narrative:
+- Events matter not for their consequences but for their **meaning**
+- The central transformation is cognitive: not-knowing → knowing
+- "It is not possible to bear one's self upon the search for concealment. But one can organize it around the requirement that he cause as little pain as possible" — the moral dimension is about knowledge management, not action
+- The MRE (most reportable event) is a **recognition**, not an action
+
+## Three types of actions in the Grail
+
+Todorov distinguishes three types:
+1. **Supernatural/given** — the Grail itself, divine intervention (not caused by characters)
+2. **Human agency** — characters' deliberate actions
+3. **Ritual/prescribed** — actions dictated by social/religious code
+
+In the gnoseological narrative, type 1 provides the *object* of knowledge, type 2 the *attempt* to understand, and type 3 the *framework* for interpretation.
+
+## What this means for tvplotlines
+
+This is directly relevant to **detective/procedural shows** (House, CSI, True Detective) and **mystery arcs** in serial TV (Lost, Twin Peaks, Westworld). In these narratives, the plotline's "events" are primarily moments of recognition, not moments of action:
+
+- "House orders a test" is an action, but the narrative transformation is: House [doesn't know diagnosis → has new hypothesis]
+- "Hank finds the desert cooking site" is an action, but narratively it's: Hank [ignorant of Walt → closer to discovering Walt]
+
+Our current event definition — "one action by one character that changes the situation" — captures the action but not the knowledge transformation. For procedural/mystery plotlines, the *knowledge state* is more important than the physical state.
+
+This could inform how we classify events in procedural shows: alongside the physical action, track the **knowledge transformation** — who learns what, and how does that change the narrative landscape.
+
+## Relevance to suspense types
+
+This connects directly to Bal's four suspense types: gnoseological narrative is built on the **riddle** (reader−, character−) and **secret** (reader−, character+) types. The narrative tension comes from knowledge asymmetry, not from physical threat.
+
+## Links
+
+- [[two-principles-succession-and-transformation]]
+- [[suspense-has-four-types-not-one]]
+- [[truth-value-reveals-apparent-vs-real-roles]]
+- [[confrontation-type-reveals-plotline-nature]]
diff --git a/docs/knowledge/v3_narratology/todorov1971/ideological-gradation-organizes-event-sequences.md b/docs/knowledge/v3_narratology/todorov1971/ideological-gradation-organizes-event-sequences.md
new file mode 100644
index 0000000..aa876cb
--- /dev/null
+++ b/docs/knowledge/v3_narratology/todorov1971/ideological-gradation-organizes-event-sequences.md
@@ -0,0 +1,32 @@
+# Ideological gradation organizes event sequences
+
+Source: Todorov 1971, "The 2 Principles of Narrative" (pp. 43-44), from analysis of Les Liaisons Dangereuses and Notes from the Underground
+
+Beyond succession and transformation, Todorov identifies a third organizing principle: **ideological organization** — events are arranged according to a value system, typically as a **gradation** from lesser to greater.
+
+In Dostoevsky's *Notes from the Underground*: the narrator is humiliated by Zverkov, then humiliates Lisa, then is humiliated again by his servant Apollo, and humiliates Lisa again "with still more severity." The narrative pattern is escalation through repetition — each cycle more extreme.
+
+In Laclos's *Les Liaisons Dangereuses*: "the principle of succession and the principle of transformation are equally necessary to narrative. If we had to oppose narrative and poetry (cf. épos and lyric), we would have done so... on the basis of the transformative or iterative character of the text."
+
+The **gradation principle**: events of the same type are ordered by severity, creating a pattern of escalation that is ideologically motivated. The pattern is broken "by the enunciation of a different ideology" — when a different value system interrupts the escalation.
+
+## The two laws of narrative (from Les Liaisons Dangereuses)
+
+Todorov extracts two "laws":
+1. **Escalation law**: "If the repetition of a requirement increases, the negative results increase as well" — each attempt makes things worse
+2. **Desire law** (from Adolphe): "the tragic nature of this situation results from the fact that, although obedient to the first principle [escalation], the protagonist does not therefore cease to desire" — the character can't stop wanting even when pursuit causes deterioration
+
+## What this means for tvplotlines
+
+This gives theoretical grounding to our "escalation" function — but with more precision. Escalation isn't just "stakes get higher." It's a **gradation principle**: events of the same type repeat with increasing severity.
+
+The desire law is particularly relevant for character-led plotlines (Breaking Bad, Succession): the character *knows* things are getting worse but can't stop. This is a specific pattern — not just "escalation" but "escalation despite recognition of deterioration." It could be a subcategory of our functions: `escalation_despite_recognition` or simply noted as a pattern in pass3 structural review.
+
+The ideological principle also explains why some plotlines feel like they have a "theme" beyond their events: the arrangement of events itself embodies a worldview (e.g., "power corrupts" = gradation of corruption events).
+
+## Links
+
+- [[two-principles-succession-and-transformation]]
+- [[narrative-cycle-has-three-phases-not-seven]]
+- [[bremond-semantic-labels-type-narrative-processes]]
+- [[change-in-metrics-predicts-turning-points-not-absolute-values]]
diff --git a/docs/knowledge/v3_narratology/todorov1971/narrative-clauses-have-grammar-like-sentences.md b/docs/knowledge/v3_narratology/todorov1971/narrative-clauses-have-grammar-like-sentences.md
new file mode 100644
index 0000000..a31aa80
--- /dev/null
+++ b/docs/knowledge/v3_narratology/todorov1971/narrative-clauses-have-grammar-like-sentences.md
@@ -0,0 +1,37 @@
+# Narrative clauses have a grammar like sentences
+
+Source: Todorov 1969, "Structural Analysis of Narrative", Novel 3, pp. 70-76 (via Clarke lecture notes)
+
+Todorov proposes a deep analogy between sentence grammar and narrative structure. The minimal element of plot is a **clause** — equivalent to a sentence in language. His "schematic formulation" gives eight properties of narrative clauses:
+
+a) **Minimal plot element = clause** — the atomic unit of narrative
+b) **Each clause = agent + predicate** — the predicate is either a verb (action that modifies the situation) or an adjective/epithet (describes the current state)
+c) **Each action has positive or negative status** — success or failure, gain or loss
+d) **Each clause has modality** — indicative (actually happened) vs imperative/potential (desired, feared, possible). This distinguishes realized events from unrealized possibilities
+e) **Each clause has perspective** — whose point of view
+f) **Three types of relations between clauses**: temporal (succession), causal (entailment/presupposition), spatial (parallelism)
+g) **Clauses form sequences** — sometimes the entire narrative, sometimes part of it
+h) **Genre is distinguished by the prevailing modality** of its clauses
+
+## Two types of Decameron stories
+
+From the analysis of Boccaccio, Todorov identifies two basic plot types:
+- Stories of **punishment avoided** — a threat is escaped
+- Stories of **conversion** — a state is fundamentally changed
+
+Both are patterns of transformation, but with different structures: avoidance preserves the initial equilibrium (threat → return to safety), while conversion creates a genuinely new state (old state → new state).
+
+## What this means for tvplotlines
+
+The most actionable insight is **modality** (point d). Our events are all in the indicative — things that happened. But narratives are full of unrealized possibilities: threats that didn't materialize, plans that failed, fears that didn't come true. These "potential" events shape the narrative even though they didn't happen.
+
+In TV: "Walt considers letting Krazy-8 go" (imperative/potential) is narratively significant even though it doesn't happen. Our pipeline currently only captures what *did* happen, not what was *considered* or *feared*. Adding modality — actual vs potential — could capture this dimension.
+
+The **three types of relations** (temporal, causal, spatial) also formalize what our pipeline does implicitly: we track temporal order (episode sequence), causal order (plotline assignment implies causality), but not spatial relations (parallelism between plotlines). Our "interactions" (thematic_rhyme, convergence) are an informal version of spatial/paradigmatic relations.
+
+## Links
+
+- [[two-principles-succession-and-transformation]]
+- [[five-part-sequence-is-richer-than-three-act-structure]]
+- [[three-criteria-filter-functional-events]]
+- [[narrative-cycle-has-three-phases-not-seven]]
diff --git a/docs/knowledge/v3_narratology/todorov1971/two-principles-succession-and-transformation.md b/docs/knowledge/v3_narratology/todorov1971/two-principles-succession-and-transformation.md
new file mode 100644
index 0000000..cbd59ab
--- /dev/null
+++ b/docs/knowledge/v3_narratology/todorov1971/two-principles-succession-and-transformation.md
@@ -0,0 +1,34 @@
+# The two principles of narrative are succession and transformation
+
+Source: Todorov 1971, "The 2 Principles of Narrative", Diacritics 1(1), pp. 37-44
+
+Todorov argues that narrative rests on two irreducible principles:
+
+**Succession** — events follow each other in time. One thing after another. This is the temporal axis: the "and then... and then..." of narrative.
+
+**Transformation** — one state changes into another. A proposition is modified. This is the causal/logical axis: something *becomes* something else.
+
+Pure succession without transformation is a chronicle — one event after another, but nothing fundamentally changes. Pure transformation without succession would be simultaneous changes — more like a tableau than a story.
+
+Narrative is the interplay of both: events succeed each other in time *and* each event transforms the situation. The interest of narrative comes from transformation; its intelligibility comes from succession.
+
+## Why this is more precise than "beginning-middle-end"
+
+The usual summary of Todorov — "equilibrium → disruption → new equilibrium" — is a simplification. His actual claim is that the fundamental narrative unit is **transformation**: the change from proposition X to proposition X'. The five-part sequence (equilibrium → disruption → recognition → repair attempt → new equilibrium) is one *pattern* of transformation, not the definition.
+
+## What this means for tvplotlines
+
+Our seven functions (setup → resolution) capture succession well — events are ordered along a timeline. But they don't explicitly capture transformation. What state changed? From what to what?
+
+Adding a **transformation** field to events — "X was A, now X is B" — would capture what Todorov considers the core of narrative. Examples:
+- "Walt strangles Krazy-8" → transformation: Walt [innocent → killer]
+- "Skyler organizes an intervention" → transformation: Family [ignoring cancer → confronting cancer]
+
+This is the same insight as Bal's "event = transition between states," but Todorov makes the *from-state* and *to-state* explicit.
+
+## Links
+
+- [[events-are-transitions-between-states]]
+- [[five-part-sequence-is-richer-than-three-act-structure]]
+- [[gnoseological-narrative-is-driven-by-knowledge-not-action]]
+- [[narrative-cycle-has-three-phases-not-seven]]
diff --git a/docs/viewer/color-variants.html b/docs/viewer/color-variants.html
new file mode 100644
index 0000000..8d6ad4d
--- /dev/null
+++ b/docs/viewer/color-variants.html
@@ -0,0 +1,433 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<title>Grid + Analytics Color Variants</title>
+<style>
+* { margin: 0; padding: 0; box-sizing: border-box; }
+body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; padding: 2rem; transition: background 0.2s, color 0.2s; }
+/* Tokyo Night (dark) */
+body.dark { background: #1a1b26; color: #a9b1d6; }
+/* Blue Topaz (light) */
+body.light { background: #eef5fb; color: #2e3338; }
+.toggle { position: fixed; top: 1rem; right: 1rem; padding: 0.5rem 1rem; border-radius: 6px; border: 1px solid; cursor: pointer; z-index: 10; font-size: 0.85rem; }
+.dark .toggle { background: #24283b; color: #a9b1d6; border-color: #3b4261; }
+.light .toggle { background: #fff; color: #4a8cc7; border-color: #c0d5e8; }
+h1 { font-size: 1.6rem; margin-bottom: 0.5rem; }
+.dark h1, .dark h2, .dark h3 { color: #c0caf5; }
+.light h1, .light h2, .light h3 { color: #1a2030; }
+.desc { font-size: 0.9rem; margin-bottom: 2rem; line-height: 1.5; }
+.dark .desc { color: #565f89; }
+.light .desc { color: #6b8099; }
+.variant { border-radius: 12px; padding: 1.5rem; margin-bottom: 2.5rem; }
+.dark .variant { background: #1f2335; border: 1px solid #3b4261; }
+.light .variant { background: #ffffff; border: 1px solid #d0dae5; }
+.variant h2 { font-size: 1.2rem; margin-bottom: 0.25rem; }
+.dark .variant .tag { color: #565f89; }
+.light .variant .tag { color: #8b9eb5; }
+.variant .tag { font-size: 0.75rem; }
+.dark .variant .explanation { color: #787c99; }
+.light .variant .explanation { color: #6b8099; }
+.variant .explanation { font-size: 0.85rem; margin: 0.5rem 0 1.25rem; line-height: 1.5; }
+.views { display: grid; grid-template-columns: 3fr 2fr; gap: 2rem; align-items: start; }
+.views > div { display: flex; flex-direction: column; }
+.grid-mockup, .analytics-mockup { flex: 1; display: flex; flex-direction: column; justify-content: space-between; }
+.view-label { font-size: 0.75rem; text-transform: uppercase; letter-spacing: 0.05em; margin-bottom: 0.75rem; font-weight: 600; }
+.dark .view-label { color: #565f89; }
+.light .view-label { color: #8b9eb5; }
+
+/* Grid mockup */
+.grid-row { display: flex; gap: 4px; align-items: center; flex: 1; }
+.grid-row-label { font-size: 0.7rem; width: 100px; text-align: right; padding-right: 8px; flex-shrink: 0; }
+.grid-cells { display: flex; gap: 4px; flex: 1; height: 100%; }
+.grid-cell { border-radius: 4px; padding: 6px 8px; font-size: 0.65rem; text-align: center; flex: 1; display: flex; align-items: center; justify-content: center; color: #fff; }
+.grid-cell.empty { border: 1px dashed; opacity: 0.3; }
+.dark .grid-cell.empty { border-color: #3b4261; }
+.light .grid-cell.empty { border-color: #c0d5e8; }
+
+/* Analytics mockup */
+.bar-row { display: flex; border-radius: 4px; overflow: hidden; flex: 1; }
+.bar-seg { display: flex; align-items: center; justify-content: center; font-size: 0.7rem; color: rgba(255,255,255,0.9); }
+
+/* Legend */
+.legend { display: flex; gap: 1rem; flex-wrap: wrap; margin-top: 1rem; }
+.legend-item { display: flex; align-items: center; gap: 0.35rem; font-size: 0.7rem; }
+.legend-dot { width: 12px; height: 12px; border-radius: 50%; }
+.dark .legend-label { color: #565f89; }
+.light .legend-label { color: #8b9eb5; }
+
+/* Pros/cons */
+.pros-cons { display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; margin-top: 1rem; font-size: 0.8rem; }
+.dark .pros { color: #9ece6a; }
+.light .pros { color: #3a8a50; }
+.dark .cons { color: #f7768e; }
+.light .cons { color: #c04050; }
+.pros-cons ul { padding-left: 1.2rem; }
+.pros-cons li { margin-bottom: 0.25rem; }
+
+/* Variant D: unified table */
+.unified-views { display: grid; grid-template-columns: 3fr 2fr; gap: 0; align-items: start; }
+.unified-table { width: 100%; border-collapse: separate; border-spacing: 3px; }
+.unified-table th { font-size: 0.7rem; font-weight: 400; padding: 4px 6px; text-align: center; }
+.dark .unified-table th { color: #565f89; }
+.light .unified-table th { color: #8b9eb5; }
+.unified-table th.row-label { text-align: right; padding-right: 10px; min-width: 110px; }
+.unified-table td { border-radius: 4px; text-align: center; font-size: 0.75rem; padding: 10px 6px; color: #fff; font-weight: 600; }
+.unified-table td.empty-cell { opacity: 0; }
+.unified-table td.total-cell { font-weight: 400; font-size: 0.7rem; }
+.dark .unified-table td.total-cell { color: #565f89; background: transparent; }
+.light .unified-table td.total-cell { color: #8b9eb5; background: transparent; }
+.unified-table td.diag { opacity: 0.15; }
+.dark .unified-table td.dash { background: #24283b; color: #3b4261; font-weight: 400; }
+.light .unified-table td.dash { background: #e8f0f6; color: #b0c4d8; font-weight: 400; }
+.section-gap { width: 20px; }
+
+/* Grid D */
+.grid-d-mockup { display: flex; flex-direction: column; gap: 3px; }
+.grid-d-row { display: flex; gap: 3px; align-items: stretch; }
+.grid-d-label { font-size: 0.7rem; width: 110px; text-align: right; padding-right: 10px; display: flex; align-items: center; justify-content: flex-end; flex-shrink: 0; }
+.grid-d-cells { display: flex; gap: 3px; flex: 1; }
+.grid-d-cell { border-radius: 4px; padding: 8px 6px; font-size: 0.65rem; text-align: center; flex: 1; display: flex; align-items: center; justify-content: center; color: #fff; min-height: 40px; }
+.grid-d-cell.empty { opacity: 0; }
+.grid-d-ep-header { display: flex; gap: 3px; padding-left: 118px; }
+.dark .grid-d-ep-header span { color: #565f89; }
+.light .grid-d-ep-header span { color: #8b9eb5; }
+.grid-d-ep-header span { flex: 1; text-align: center; font-size: 0.65rem; }
+</style>
+</head>
+<body class="dark">
+<button class="toggle" onclick="toggleTheme()">☀ Blue Topaz</button>
+
+<h1>Grid + Analytics: варианты связки цветов</h1>
+<p class="desc">Grid View окрашивает события по <strong>функции</strong> (setup, escalation, climax...). Analytics окрашивает по <strong>плотлайну</strong> (Walt: Empire, Jesse: Survival...). Как их соединить?</p>
+
+<div id="variants"></div>
+
+<script>
+// Monet plotline colors (first 4 for BB)
+const PL = {
+  walt:  '#2a4a80',
+  jesse: '#6a4890',
+  family:'#3a7868',
+  hank:  '#d8c040',
+};
+
+// Functions
+const FN_NAMES = ['setup', 'inciting', 'escalation', 'turning pt', 'crisis', 'climax', 'resolution'];
+
+const VARIANTS = [
+  {
+    name: 'A. Оба из Моне',
+    tag: 'Одна картина — два регистра',
+    explanation: 'Плотлайны = основная палитра Моне. Функции = оттенки из той же картины: туман, охра, тиал, розовый. Grid и Analytics визуально из одного мира.',
+    fnColors: ['#8898b0', '#b89858', '#a8a898', '#6a4890', '#2a4a80', '#c07890', '#3a7868'],
+    plColors: PL,
+    pros: ['Единый визуальный язык', 'Всё "из одной картины"', 'Спокойный, гармоничный'],
+    cons: ['Функции могут сливаться с плотлайнами', 'Мало контраста между setup/escalation', 'Может быть слишком "тихо"'],
+  },
+  {
+    name: 'B. Тёплый / холодный split',
+    tag: 'Плотлайны = холодные, функции = тёплые',
+    explanation: 'Analytics (плотлайны) — холодные Моне: синий, фиолетовый, зелёный. Grid (функции) — тёплые: охра, терракота, золото, розовый. Два вида сразу читаются как разные измерения.',
+    fnColors: ['#a8a090', '#d0a020', '#c08050', '#9050a0', '#b85540', '#c03040', '#5a9878'],
+    plColors: PL,
+    pros: ['Сразу видно что "это функция" vs "это плотлайн"', 'Высокий контраст', 'Тёплые функции хорошо читаются на карточках'],
+    cons: ['Два разных "настроения" на одном сайте', 'Grid выглядит "другим приложением"', 'Сложнее запомнить обе системы'],
+  },
+  {
+    name: 'C. Плотлайн = фон строки, функция = насыщенность',
+    tag: 'Цвет строки + яркость карточки',
+    explanation: 'В Grid View каждая строка (плотлайн) получает свой цвет как фон/бордер. Карточки внутри — оттенки этого же цвета: бледный (setup) → насыщенный (climax). Функция = интенсивность, плотлайн = оттенок.',
+    fnColors: null, // special rendering
+    plColors: PL,
+    pros: ['Один цветовой язык — плотлайн везде = один цвет', 'Нет "второй палитры" для запоминания', 'Grid и Analytics мгновенно связываются'],
+    cons: ['Теряется различение функций по цвету', 'Setup и escalation различаются только яркостью', 'Менее информативно на первый взгляд'],
+  },
+];
+
+// Intensity levels for variant C (setup=0.2 ... climax=1.0)
+const FN_INTENSITY = [0.2, 0.35, 0.45, 0.6, 0.8, 1.0, 0.25];
+
+// Variant D: infoDesign-driven unified layout
+const VARIANT_D = {
+  name: 'D. Убрать stacked bar, два графика как одна таблица',
+  tag: 'По принципам infoDesign: data-ink, параллелизм, прямые подписи',
+  explanation: 'Stacked bar дублирует Span Timeline (те же данные). Убираем. Два оставшихся графика — рядом, строки выровнены, прямые числа, без легенды. Grid View (слева) — функции тёплые (вариант B). Итоги по строкам/столбцам встроены.',
+  // Grid: warm function colors (variant B)
+  fnColors: ['#a8a090', '#d0a020', '#c08050', '#9050a0', '#b85540', '#c03040', '#5a9878'],
+  plColors: PL,
+  // Span Timeline data: plotline × episode (event counts)
+  spanData: [
+    [9, 4, 8, 6, 9, 7, 7],  // Walt: Empire
+    [1, 2, 0, 5, 2, 2, 1],  // Jesse: Survival
+    [1, 3, 5, 2, 3, 2, 3],  // Walt: Family
+    [2, 1, 0, 1, 0, 2, 0],  // Hank: Investigation
+  ],
+  // Convergence: plotline × plotline (directed)
+  convData: [
+    [0, 19, 6, 0],
+    [3, 0, 0, 0],
+    [3, 1, 0, 0],
+    [2, 0, 0, 0],
+  ],
+  pros: ['Максимальный data-ink ratio — нет дублирования', 'Строки параллельны: одна плотлайн = одна высота везде', 'Прямые числа — без легенды, без расшифровки', 'Итоги встроены (Σ строк/столбцов)', 'Grid + Analytics из одного визуального семейства'],
+  cons: ['Теряется stacked bar (пропорции внутри эпизода менее наглядны)', 'Сложнее реализовать идеальное выравнивание Canvas + SVG'],
+};
+
+function hexToRgb(hex) {
+  return [parseInt(hex.slice(1,3),16), parseInt(hex.slice(3,5),16), parseInt(hex.slice(5,7),16)];
+}
+function rgbToHex(r,g,b) {
+  const h = v => Math.round(Math.min(255,Math.max(0,v))).toString(16).padStart(2,'0');
+  return '#'+h(r)+h(g)+h(b);
+}
+function blendToBg(hex, bg, t) {
+  const [r1,g1,b1] = hexToRgb(hex);
+  const [rb,gb,bb] = hexToRgb(bg);
+  return rgbToHex(r1*t+rb*(1-t), g1*t+gb*(1-t), b1*t+bb*(1-t));
+}
+
+function toggleTheme() {
+  document.body.classList.toggle('dark');
+  document.body.classList.toggle('light');
+  const btn = document.querySelector('.toggle');
+  const isDark = document.body.classList.contains('dark');
+  btn.textContent = isDark ? '\u2600 Blue Topaz' : '\u263E Tokyo Night';
+  renderAll();
+}
+
+function renderAll() {
+const root = document.getElementById('variants');
+root.innerHTML = '';
+
+VARIANTS.forEach((v, vi) => {
+  const div = document.createElement('div');
+  div.className = 'variant';
+
+  const isDark = document.body.classList.contains('dark');
+  const bg = isDark ? '#1f2335' : '#ffffff';
+
+  let html = `<h2>${v.name}</h2><span class="tag">${v.tag}</span>
+    <p class="explanation">${v.explanation}</p>
+    <div class="views">`;
+
+  // --- GRID VIEW mockup ---
+  html += '<div><div class="view-label">Grid View (события по функциям)</div><div class="grid-mockup">';
+
+  const plEntries = Object.entries(v.plColors);
+  const plNames = ['Walt: Empire', 'Jesse: Survival', 'Walt: Family', 'Hank: Investigation'];
+  // 7 episodes, show a few events per row
+  const gridData = [
+    [0,1,2,3,4,5,6],  // Walt: all functions
+    [null,0,null,2,3,null,5], // Jesse: gaps
+    [0,2,2,3,null,5,6], // Family
+    [0,null,null,1,null,4,null], // Hank: sparse
+  ];
+
+  for (let r = 0; r < 4; r++) {
+    html += `<div class="grid-row"><div class="grid-row-label">${plNames[r]}</div><div class="grid-cells">`;
+    for (let c = 0; c < 7; c++) {
+      const fnIdx = gridData[r][c];
+      if (fnIdx === null) {
+        html += '<div class="grid-cell empty"></div>';
+      } else {
+        let cellColor;
+        if (v.fnColors === null) {
+          // Variant C: plotline color at function intensity
+          cellColor = blendToBg(plEntries[r][1], bg, FN_INTENSITY[fnIdx]);
+        } else {
+          cellColor = v.fnColors[fnIdx];
+        }
+        html += `<div class="grid-cell" style="background:${cellColor}">${FN_NAMES[fnIdx]}</div>`;
+      }
+    }
+    html += '</div></div>';
+  }
+  html += '</div>';
+
+  // Function legend for A and B
+  if (v.fnColors) {
+    html += '<div class="legend">';
+    FN_NAMES.forEach((fn, i) => {
+      html += `<div class="legend-item"><div class="legend-dot" style="background:${v.fnColors[i]}"></div><span class="legend-label">${fn}</span></div>`;
+    });
+    html += '</div>';
+  } else {
+    html += '<div class="legend"><span class="legend-label" style="font-size:0.75rem">Цвет = плотлайн, яркость = функция (бледный→setup, яркий→climax)</span></div>';
+  }
+  html += '</div>';
+
+  // --- ANALYTICS mockup ---
+  html += '<div><div class="view-label">Analytics (данные по плотлайнам)</div><div class="analytics-mockup">';
+
+  // Stacked bars
+  const barData = [[9,2,1,1],[4,3,2,1],[8,5,0,0],[6,5,2,1],[9,2,3,0],[7,2,2,2],[7,1,3,2]];
+  const plColors = plEntries.map(e => e[1]);
+  barData.forEach(row => {
+    const total = row.reduce((a,b)=>a+b,0);
+    html += '<div class="bar-row">';
+    row.forEach((val, i) => {
+      if (val === 0) return;
+      html += `<div class="bar-seg" style="width:${val/total*100}%;background:${plColors[i]}">${val}</div>`;
+    });
+    html += '</div>';
+  });
+
+  // Plotline legend
+  html += '<div class="legend">';
+  plNames.forEach((name, i) => {
+    html += `<div class="legend-item"><div class="legend-dot" style="background:${plColors[i]}"></div><span class="legend-label">${name}</span></div>`;
+  });
+  html += '</div>';
+
+  html += '</div></div>'; // close analytics + views
+
+  // Pros/cons
+  html += '<div class="pros-cons"><div class="pros"><strong>+</strong><ul>';
+  v.pros.forEach(p => html += `<li>${p}</li>`);
+  html += '</ul></div><div class="cons"><strong>−</strong><ul>';
+  v.cons.forEach(c => html += `<li>${c}</li>`);
+  html += '</ul></div></div>';
+
+  div.innerHTML = html;
+  root.appendChild(div);
+});
+
+// --- VARIANT D: custom render ---
+{
+  const d = VARIANT_D;
+  const div = document.createElement('div');
+  div.className = 'variant';
+  const isDark = document.body.classList.contains('dark');
+  const bg = isDark ? '#1f2335' : '#ffffff';
+
+  const plEntries = Object.entries(d.plColors);
+  const plNames = ['Walt: Empire', 'Jesse: Survival', 'Walt: Family', 'Hank: Investigation'];
+  const plShort = ['W:Emp', 'J:Sur', 'W:Fam', 'H:Inv'];
+  const episodes = ['S01E01','S01E02','S01E03','S01E04','S01E05','S01E06','S01E07'];
+  const plColors = plEntries.map(e => e[1]);
+
+  let html = `<h2>${d.name}</h2><span class="tag">${d.tag}</span>
+    <p class="explanation">${d.explanation}</p>`;
+
+  // --- TOP: Grid View mockup ---
+  html += '<div class="view-label">Grid View (функции тёплые — вариант B)</div>';
+  const gridData = [
+    [0,1,2,3,4,5,6],
+    [null,0,null,2,3,null,5],
+    [0,2,2,3,null,5,6],
+    [0,null,null,1,null,4,null],
+  ];
+  html += '<div class="grid-d-mockup">';
+  html += '<div class="grid-d-ep-header">';
+  episodes.forEach(ep => { html += `<span>${ep}</span>`; });
+  html += '</div>';
+  for (let r = 0; r < 4; r++) {
+    html += `<div class="grid-d-row"><div class="grid-d-label" style="color:${plColors[r]}; font-weight:600">${plNames[r]}</div><div class="grid-d-cells">`;
+    for (let c = 0; c < 7; c++) {
+      const fnIdx = gridData[r][c];
+      if (fnIdx === null) {
+        html += '<div class="grid-d-cell empty"></div>';
+      } else {
+        html += `<div class="grid-d-cell" style="background:${d.fnColors[fnIdx]}">${FN_NAMES[fnIdx]}</div>`;
+      }
+    }
+    html += '</div></div>';
+  }
+  html += '</div>';
+  // Function legend
+  html += '<div class="legend" style="margin-bottom:1.5rem">';
+  FN_NAMES.forEach((fn, i) => {
+    html += `<div class="legend-item"><div class="legend-dot" style="background:${d.fnColors[i]}"></div><span class="legend-label">${fn}</span></div>`;
+  });
+  html += '</div>';
+
+  // --- BOTTOM: Analytics = Span Timeline + Convergence side by side ---
+  html += '<div class="view-label">Analytics (без stacked bar — два графика, строки выровнены)</div>';
+  html += '<div class="unified-views">';
+
+  // Span Timeline table
+  html += '<table class="unified-table"><thead><tr><th class="row-label"></th>';
+  episodes.forEach(ep => { html += `<th>${ep}</th>`; });
+  html += '<th>Σ</th></tr></thead><tbody>';
+  for (let r = 0; r < 4; r++) {
+    html += `<tr><th class="row-label" style="color:${plColors[r]}">${plNames[r]}</th>`;
+    const rowMax = Math.max(...d.spanData[r]);
+    const rowSum = d.spanData[r].reduce((a,b)=>a+b,0);
+    for (let c = 0; c < 7; c++) {
+      const val = d.spanData[r][c];
+      if (val === 0) {
+        html += '<td class="empty-cell"></td>';
+      } else {
+        const t = Math.max(0.3, val / rowMax);
+        const color = blendToBg(plColors[r], bg, t);
+        html += `<td style="background:${color}">${val}</td>`;
+      }
+    }
+    html += `<td class="total-cell">${rowSum}</td></tr>`;
+  }
+  // Totals row
+  html += '<tr><th class="row-label" style="font-size:0.65rem;color:#888">Total</th>';
+  for (let c = 0; c < 7; c++) {
+    const colSum = d.spanData.reduce((s, row) => s + row[c], 0);
+    html += `<td class="total-cell">${colSum}</td>`;
+  }
+  html += '<td class="total-cell"></td></tr>';
+  html += '</tbody></table>';
+
+  // Convergence table
+  html += '<table class="unified-table"><thead><tr><th class="row-label"></th>';
+  plShort.forEach((s, i) => { html += `<th style="color:${plColors[i]}">${s}</th>`; });
+  html += '<th>Σ</th></tr></thead><tbody>';
+  const maxConv = Math.max(...d.convData.flat());
+  for (let r = 0; r < 4; r++) {
+    html += `<tr><th class="row-label" style="color:${plColors[r]}">${plNames[r]}</th>`;
+    const rowSum = d.convData[r].reduce((a,b)=>a+b,0);
+    for (let c = 0; c < 4; c++) {
+      if (r === c) {
+        html += `<td class="diag" style="background:${plColors[r]}"></td>`;
+        continue;
+      }
+      const val = d.convData[r][c];
+      if (val === 0) {
+        html += '<td class="dash">—</td>';
+      } else {
+        // Blend row + col colors, row dominates
+        const [r1,g1,b1] = hexToRgb(plColors[r]);
+        const [r2,g2,b2] = hexToRgb(plColors[c]);
+        const mr = r1*0.7+r2*0.3, mg = g1*0.7+g2*0.3, mb = b1*0.7+b2*0.3;
+        const mixed = rgbToHex(mr,mg,mb);
+        const t = Math.max(0.35, Math.sqrt(val/maxConv));
+        const final = blendToBg(mixed, bg, t);
+        html += `<td style="background:${final}">${val}</td>`;
+      }
+    }
+    html += `<td class="total-cell">→${rowSum}</td></tr>`;
+  }
+  // Column totals
+  html += '<tr><th class="row-label" style="font-size:0.65rem;color:#888"></th>';
+  for (let c = 0; c < 4; c++) {
+    const colSum = d.convData.reduce((s, row) => s + row[c], 0);
+    html += `<td class="total-cell">↓${colSum}</td>`;
+  }
+  html += '<td class="total-cell"></td></tr>';
+  html += '</tbody></table>';
+
+  html += '</div>'; // unified-views
+
+  // Pros/cons
+  html += '<div class="pros-cons"><div class="pros"><strong>+</strong><ul>';
+  d.pros.forEach(p => html += `<li>${p}</li>`);
+  html += '</ul></div><div class="cons"><strong>−</strong><ul>';
+  d.cons.forEach(c => html += `<li>${c}</li>`);
+  html += '</ul></div></div>';
+
+  div.innerHTML = html;
+  root.appendChild(div);
+}
+} // end renderAll
+
+renderAll();
+</script>
+</body>
+</html>
diff --git a/docs/viewer/decisions.md b/docs/viewer/decisions.md
new file mode 100644
index 0000000..213ee5b
--- /dev/null
+++ b/docs/viewer/decisions.md
@@ -0,0 +1,48 @@
+---
+type: spec
+project: tvplotlines
+status: active
+---
+
+# Standalone HTML Viewer — Design Decisions
+
+## Решённое
+
+1. **Формат** — один скачиваемый HTML-файл. Открыл в браузере — работает. Как Excel-таблица.
+2. **Функционал** — всё что есть в tvplotlines-app: грид (сюжетные линии x эпизоды), аналитика, редактирование (merge/split/edit событий и линий).
+3. **Целевая аудитория** — сценаристы 55+, минимальные технические навыки. Ноль терминала.
+4. **Безопасность данных** — данные не покидают компьютер пользователя. Никакого нашего сервера. Пользователь доверяет своему LLM (Claude/ChatGPT), но не стороннему сервису.
+5. **Онбординг** — при первом открытии HTML проигрывается демо "в реальном времени" — анимированная симуляция пайплайна на примере Breaking Bad. Проход за проходом, результаты появляются на экране. Есть кнопка "посмотреть онбординг заново".
+6. **Демо-данные** — Breaking Bad, встроены в HTML.
+7. **Связь с библиотекой** — `tvplotlines run --html` генерирует такой же HTML с результатами пользователя.
+
+8. **LLM доступ** — два варианта на выбор пользователя:
+   - **Свой API ключ** — бесплатно, вставил Claude/OpenAI ключ и работает
+   - **Через нас** — платный аккаунт (5-10 евро), логин/пароль, ничего настраивать не надо. Нужен прокси-бэкенд с нашим API ключом.
+9. **Обработка синопсисов** — прямо в HTML. Загружаешь txt-файлы, LLM обрабатывает, результат появляется в интерфейсе.
+10. **Онбординг-мастер** — пошаговый wizard при первом запуске: выбери AI → вставь ключ (с картинками-инструкциями) / или залогинься через нас.
+
+11. **Видео-онбординг "как получить API ключ"** — отдельное видео/анимация с пошаговой инструкцией.
+
+18. **Распространение** — HTML viewer живёт внутри библиотеки tvplotlines (один пакет):
+    - Для сценаристов: скачать viewer.html с сайта/GitHub (кнопка Download)
+    - Для разработчиков: `pip install tvplotlines` → `tvplotlines run --html`
+    - tvplotlines-app (FastAPI) остаётся как dev-инструмент для редактирования
+
+## Будущие фичи (не в первой версии)
+
+- **Платный аккаунт** — прокси-бэкенд, оплата, логин
+- **Screen assistant как онбординг-помощник** — AI видит экран пользователя и подсказывает что делать дальше (как Clicky, но для tvplotlines). Отдельный проект.
+
+12. **Экспорт** — три формата:
+    - XLS — таблица с гридом
+    - TXT — простой текст
+    - Final Draft (.fdx) — XML-формат, родной для сценаристов. Killer feature.
+
+13. **V1 = просмотр + экспорт**. Редактирование (merge/split/правка) — в следующей версии.
+14. **Welcome экран** — диджитальный аватар автора, машет рукой, кнопка "Play me".
+15. **Онбординг → LLM подключение** — в конце демо сразу появляется окно "подключить свой LLM" (не отдельный шаг).
+16. **Экспорт** — XLS, TXT, Final Draft (.fdx), JSON (наш формат tvplotlines).
+17. **Накопление результатов** — все обработанные сериалы сохраняются в localStorage. Можно зайти потом, переключаться между сериалами.
+
+## Открытые вопросы
diff --git a/docs/viewer/plan.md b/docs/viewer/plan.md
new file mode 100644
index 0000000..e6124e3
--- /dev/null
+++ b/docs/viewer/plan.md
@@ -0,0 +1,775 @@
+---
+type: plan
+project: tvplotlines
+status: active
+---
+
+# tvplotlines Standalone HTML App — Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** One downloadable HTML file that displays tvplotlines results (grid + analytics), runs the 5-pass LLM pipeline in-browser, and exports to JSON/XLS/TXT/Final Draft.
+
+**Architecture:** Single HTML file with inline CSS, JS, and demo data. No frameworks, no CDN (except SheetJS inline). All state in localStorage. LLM calls go directly from browser to Anthropic/OpenAI API.
+
+**Tech Stack:** Vanilla JS, CSS (ported from tvplotlines-app style.css), SheetJS (inline, for XLS export)
+
+**Source of truth:** Existing tvplotlines-app code — CSS, grid structure, analytics calculations, color palettes. Port, don't rewrite.
+
+---
+
+## File Map
+
+All work happens in one directory: `/Users/nvashko/Projects/1-projects/tvplotlines/`
+
+| File | Purpose |
+|------|---------|
+| `src/tvplotlines/html/viewer.html` | The standalone HTML file (deliverable) |
+| `src/tvplotlines/html/build.py` | Build script: assembles viewer.html from parts + injects demo data |
+| `src/tvplotlines/html/parts/style.css` | CSS (ported from tvplotlines-app, developed separately for readability) |
+| `src/tvplotlines/html/parts/grid.js` | Grid rendering (port of grid.html Jinja2 → JS) |
+| `src/tvplotlines/html/parts/analytics.js` | Analytics rendering + calculations (port of analytics.py + analytics.html) |
+| `src/tvplotlines/html/parts/export.js` | Export: JSON, XLS, TXT, FDX |
+| `src/tvplotlines/html/parts/pipeline.js` | LLM pipeline: 5 passes, API calls, streaming |
+| `src/tvplotlines/html/parts/app.js` | Router, localStorage, onboarding, UI orchestration |
+| `src/tvplotlines/html/parts/shell.html` | HTML skeleton (all screens markup) |
+| `tests/test_html_build.py` | Tests for build script |
+| `examples/results/bb_s01.json` | Demo data (already exists) |
+
+**Why separate parts + build:** Developing in one 2MB HTML is painful. Parts are separate files during development; `build.py` concatenates them into the final `viewer.html`. The build is simple string assembly — no webpack, no bundler.
+
+---
+
+## Sub-projects (in order)
+
+1. **Каркас + грид + аналитика** (Tasks 1-5) — read-only viewer with demo data
+2. **Экспорт** (Tasks 6-7) — JSON, XLS, TXT, FDX
+3. **LLM-пайплайн** (Tasks 8-10) — run pipeline in browser
+4. **Онбординг** (Tasks 11-12) — welcome screen, animated demo
+5. **CLI интеграция** (Task 13) — `tvplotlines run --html`
+
+---
+
+## Task 1: Build script + HTML shell
+
+**Files:**
+- Create: `src/tvplotlines/html/build.py`
+- Create: `src/tvplotlines/html/parts/shell.html`
+- Create: `tests/test_html_build.py`
+
+- [ ] **Step 1: Write test for build script**
+
+```python
+# tests/test_html_build.py
+import subprocess
+import tempfile
+from pathlib import Path
+
+def test_build_produces_html():
+    result = subprocess.run(
+        ["python", "src/tvplotlines/html/build.py", "--output", "/tmp/test_viewer.html"],
+        capture_output=True, text=True
+    )
+    assert result.returncode == 0
+    html = Path("/tmp/test_viewer.html").read_text()
+    assert "<!DOCTYPE html>" in html
+    assert "<style>" in html
+    assert "<script>" in html
+    assert "demo-data" in html
+```
+
+- [ ] **Step 2: Run test — verify it fails**
+
+Run: `python -m pytest tests/test_html_build.py::test_build_produces_html -v`
+Expected: FAIL — file not found
+
+- [ ] **Step 3: Create shell.html**
+
+```html
+<!-- src/tvplotlines/html/parts/shell.html -->
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>tvplotlines</title>
+<style>
+/* {{STYLE}} */
+</style>
+</head>
+<body>
+  <div id="app">
+    <div id="screen-welcome" class="screen"></div>
+    <div id="screen-grid" class="screen" style="display:none"></div>
+    <div id="screen-analytics" class="screen" style="display:none"></div>
+  </div>
+  <div id="modal-container"></div>
+  <script type="application/json" id="demo-data">
+  /* {{DEMO_DATA}} */
+  </script>
+  <script>
+  /* {{APP_JS}} */
+  </script>
+</body>
+</html>
+```
+
+- [ ] **Step 4: Create build.py**
+
+```python
+# src/tvplotlines/html/build.py
+"""Assemble standalone HTML viewer from parts."""
+import argparse
+import json
+from pathlib import Path
+
+PARTS_DIR = Path(__file__).parent / "parts"
+DEMO_DATA = Path(__file__).parent.parent.parent.parent / "examples" / "results" / "bb_s01.json"
+
+def build(output_path: str, data_path: str | None = None):
+    shell = (PARTS_DIR / "shell.html").read_text()
+    style = (PARTS_DIR / "style.css").read_text() if (PARTS_DIR / "style.css").exists() else "/* placeholder */"
+
+    js_files = ["grid.js", "analytics.js", "export.js", "pipeline.js", "app.js"]
+    js_parts = []
+    for name in js_files:
+        path = PARTS_DIR / name
+        if path.exists():
+            js_parts.append(f"// --- {name} ---\n{path.read_text()}")
+        else:
+            js_parts.append(f"// --- {name} --- placeholder")
+    all_js = "\n\n".join(js_parts)
+
+    data_file = Path(data_path) if data_path else DEMO_DATA
+    demo_json = data_file.read_text() if data_file.exists() else "{}"
+
+    html = shell
+    html = html.replace("/* {{STYLE}} */", style)
+    html = html.replace("/* {{DEMO_DATA}} */", demo_json)
+    html = html.replace("/* {{APP_JS}} */", all_js)
+
+    Path(output_path).write_text(html)
+    print(f"Built: {output_path}")
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--output", default="viewer.html")
+    parser.add_argument("--data", default=None)
+    args = parser.parse_args()
+    build(args.output, args.data)
+```
+
+- [ ] **Step 5: Run test — verify it passes**
+
+Run: `python -m pytest tests/test_html_build.py::test_build_produces_html -v`
+Expected: PASS
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add src/tvplotlines/html/ tests/test_html_build.py
+git commit -m "feat: add HTML viewer build script and shell"
+```
+
+---
+
+## Task 2: CSS — port from tvplotlines-app
+
+**Files:**
+- Create: `src/tvplotlines/html/parts/style.css`
+- Reference: `/Users/nvashko/Projects/1-projects/tvplotlines-app/src/tvplotlines_app/static/style.css`
+
+- [ ] **Step 1: Copy and adapt CSS**
+
+Copy `style.css` from tvplotlines-app. Changes needed:
+- Remove HTMX-specific styles (`.htmx-indicator`, `[hx-get]` cursor rules)
+- Remove edit-mode styles (`.merge-mode`, `.split-modal`, edit modal styles) — v1 is read-only
+- Keep ALL of: color palette (light + Catppuccin Mocha dark), function colors (`fn-*`), rank badges (`rank-*`), tension variables (`--ana-tension-*`), grid layout (`.timeline-grid`, `.sticky-col`, `.sticky-top`), analytics (`.ana-*`), dark mode toggle
+- Add: screen routing (`.screen { display: none } .screen.active { display: block }`), welcome screen styles, onboarding styles
+- Per spec: "минимализм, почти олдскульный дизайн первого интернета, но чисто" — keep existing clean palette, strip decorative elements
+- VERIFY: every element must read equally well in light and dark themes
+
+- [ ] **Step 2: Build and open in browser**
+
+```bash
+python src/tvplotlines/html/build.py --output /tmp/viewer.html && open /tmp/viewer.html
+```
+
+Visually verify: dark mode toggle works, no broken colors.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add src/tvplotlines/html/parts/style.css
+git commit -m "feat: port CSS from tvplotlines-app for standalone viewer"
+```
+
+---
+
+## Task 3: Grid rendering — port from tvplotlines-app
+
+**Files:**
+- Create: `src/tvplotlines/html/parts/grid.js`
+- Reference: `/Users/nvashko/Projects/1-projects/tvplotlines-app/src/tvplotlines_app/templates/partials/grid.html`
+- Reference: `/Users/nvashko/Projects/1-projects/tvplotlines-app/src/tvplotlines_app/helpers.py`
+
+- [ ] **Step 1: Write grid.js**
+
+Port the Jinja2 template to a JS function `renderGrid(data, container)` that:
+- Takes tvplotlines result JSON and a DOM container
+- Builds the `<table class="timeline-grid">` structure
+- Preserves exact class names: `event-cell`, `event-card fn-{function}`, `rank-badge rank-{rank}`, `plotline-cell`, `plotline-characters`, `guest-char`, `header-cell`, `sticky-col`, `unassigned-row`
+- Event grid lookup: pre-build `eventGrid[plotlineId][episodeCode] = [events]` map
+- Character resolution: port `resolve_character_name()` — strip `guest:` prefix, `is_guest()` check
+- Plotline sort: `RANK_ORDER = {A: 0, B: 1, C: 2, runner: 3}`
+- Click on event card → read-only detail modal (show event text, function, characters)
+- Filter bar: season dropdown, character checkboxes, function chips (client-side show/hide via CSS classes, same as existing app)
+
+Key preserved patterns from tvplotlines-app:
+- `rank.toLowerCase()` for CSS class (data has uppercase "A", CSS uses `.rank-a`)
+- `fn-${ev.function}` class directly from data values
+- Guest characters: `c.startsWith('guest:')` → italic styling
+
+- [ ] **Step 2: Create minimal app.js for testing**
+
+```javascript
+// src/tvplotlines/html/parts/app.js
+const demoData = JSON.parse(document.getElementById('demo-data').textContent);
+
+function showScreen(name) {
+  document.querySelectorAll('.screen').forEach(s => s.classList.remove('active'));
+  document.getElementById('screen-' + name).classList.add('active');
+}
+
+// Dark mode toggle — preserved from tvplotlines-app
+function toggleDark() {
+  document.documentElement.classList.toggle('dark');
+  localStorage.setItem('theme',
+    document.documentElement.classList.contains('dark') ? 'dark' : 'light');
+}
+
+// Init
+(function init() {
+  if (localStorage.getItem('theme') === 'dark') {
+    document.documentElement.classList.add('dark');
+  }
+  renderGrid(demoData, document.getElementById('screen-grid'));
+  showScreen('grid');
+})();
+```
+
+- [ ] **Step 3: Build and test visually**
+
+```bash
+python src/tvplotlines/html/build.py --output /tmp/viewer.html && open /tmp/viewer.html
+```
+
+Verify: grid displays Breaking Bad data, colors match tvplotlines-app, sticky columns work, filters work, dark mode preserves readability.
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add src/tvplotlines/html/parts/grid.js src/tvplotlines/html/parts/app.js
+git commit -m "feat: port grid rendering from tvplotlines-app to standalone JS"
+```
+
+---
+
+## Task 4: Analytics rendering — port from tvplotlines-app
+
+**Files:**
+- Create: `src/tvplotlines/html/parts/analytics.js`
+- Reference: `/Users/nvashko/Projects/1-projects/tvplotlines-app/src/tvplotlines_app/analytics.py`
+- Reference: `/Users/nvashko/Projects/1-projects/tvplotlines-app/src/tvplotlines_app/templates/analytics.html`
+
+- [ ] **Step 1: Write analytics.js**
+
+Two parts:
+
+**A) Computation** — port `analytics.py` to JS:
+- `FUNCTION_TENSION = {resolution: 0.5, setup: 1, seed: 1, escalation: 2, turning_point: 3, climax: 4, cliffhanger: 4}`
+- `RANK_ORDER = {A: 0, B: 1, C: 2, runner: 3}`
+- `computeScorecard(data)` — plotlines with span dots, event counts, arc summaries
+- `computeArcMap(data)` — episodes × plotlines tension grid. Tension level thresholds: `≤1.2→1, ≤2.0→2, ≤2.8→3, ≤3.5→4, else→5`
+- `computePulse(data)` — per-episode stacked bars
+- `computeConvergence(data)` — interaction timeline
+- `computeCharacters(data)` — character event counts, filter `count < 2`
+- Arc summary: dominant function at 40% threshold, priority order `["climax", "crisis", "turning_point"]`
+
+**B) Rendering** — port `analytics.html` Jinja2 to JS:
+- `renderAnalytics(data, container)` builds all 5 sections
+- Preserve exact CSS classes: `ana-scorecard`, `ana-span-bar`, `ana-span-dot`, `ana-arcmap`, `ana-tension-cell`, `ana-pulse-bar`, `ana-conv-type ana-conv-{type}`, `ana-char-bar`
+- Arc map: `grid-template-columns: 140px repeat(N, 1fr)`, circle size `16 + (28 * events / maxEvents)`
+- Pulse: bar width `total / maxTotal * 100`%
+- Character: bar width `count / maxCount * 100`%
+
+- [ ] **Step 2: Add analytics navigation to app.js**
+
+Add toolbar button "Analytics" that calls `renderAnalytics(demoData, container)` and switches screen. Add "Grid" button on analytics screen.
+
+- [ ] **Step 3: Build and test visually**
+
+```bash
+python src/tvplotlines/html/build.py --output /tmp/viewer.html && open /tmp/viewer.html
+```
+
+Verify: all 5 analytics sections render, arc map colors match tension levels, dark mode works on all elements.
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add src/tvplotlines/html/parts/analytics.js
+git commit -m "feat: port analytics from tvplotlines-app to standalone JS"
+```
+
+---
+
+## Task 5: Router + localStorage + toolbar
+
+**Files:**
+- Modify: `src/tvplotlines/html/parts/app.js`
+- Modify: `src/tvplotlines/html/parts/shell.html`
+
+- [ ] **Step 1: Implement localStorage manager**
+
+```javascript
+const Store = {
+  getKey: () => localStorage.getItem('tvplotlines_api_key'),
+  setKey: (provider, key) => {
+    localStorage.setItem('tvplotlines_provider', provider);
+    localStorage.setItem('tvplotlines_api_key', key);
+  },
+  getResults: () => JSON.parse(localStorage.getItem('tvplotlines_results') || '{}'),
+  saveResult: (name, data) => {
+    const results = Store.getResults();
+    results[name] = data;
+    localStorage.setItem('tvplotlines_results', JSON.stringify(results));
+  },
+  getSettings: () => JSON.parse(localStorage.getItem('tvplotlines_settings') || '{}'),
+  saveSetting: (key, val) => {
+    const s = Store.getSettings();
+    s[key] = val;
+    localStorage.setItem('tvplotlines_settings', JSON.stringify(s));
+  },
+  hasSeenOnboarding: () => localStorage.getItem('tvplotlines_onboarding_seen') === 'true',
+  markOnboardingSeen: () => localStorage.setItem('tvplotlines_onboarding_seen', 'true'),
+};
+```
+
+- [ ] **Step 2: Implement toolbar in shell.html**
+
+Toolbar with: series dropdown, Grid/Analytics tabs, export buttons, dark mode toggle, "Load synopses" button, "Onboarding" button, "LLM settings" button.
+
+- [ ] **Step 3: Implement series switching**
+
+Series dropdown populated from `Store.getResults()` + demo data. Switching re-renders grid and analytics.
+
+- [ ] **Step 4: Build and test**
+
+```bash
+python src/tvplotlines/html/build.py --output /tmp/viewer.html && open /tmp/viewer.html
+```
+
+Verify: navigation works, dark mode persists across reload, series switching re-renders.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/tvplotlines/html/parts/app.js src/tvplotlines/html/parts/shell.html
+git commit -m "feat: add router, localStorage, toolbar for standalone viewer"
+```
+
+---
+
+## Task 6: Export — JSON, XLS, TXT
+
+**Files:**
+- Create: `src/tvplotlines/html/parts/export.js`
+
+- [ ] **Step 1: JSON export**
+
+```javascript
+function exportJSON(data, filename) {
+  const blob = new Blob([JSON.stringify(data, null, 2)], {type: 'application/json'});
+  downloadBlob(blob, filename + '.json');
+}
+
+function downloadBlob(blob, filename) {
+  const a = document.createElement('a');
+  a.href = URL.createObjectURL(blob);
+  a.download = filename;
+  a.click();
+  URL.revokeObjectURL(a.href);
+}
+```
+
+- [ ] **Step 2: TXT export**
+
+Structured text: series name, then per-episode sections with plotline events.
+
+- [ ] **Step 3: XLS export with SheetJS**
+
+Include SheetJS (xlsx.mini.min.js) inline. Build workbook with two sheets: "Events" (flat table) and "Plotlines" (summary).
+
+- [ ] **Step 4: Wire export buttons in toolbar**
+
+- [ ] **Step 5: Build, test all 3 exports**
+
+```bash
+python src/tvplotlines/html/build.py --output /tmp/viewer.html && open /tmp/viewer.html
+```
+
+Download each format, verify contents.
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add src/tvplotlines/html/parts/export.js
+git commit -m "feat: add JSON, TXT, XLS export"
+```
+
+---
+
+## Task 7: Export — Final Draft (.fdx)
+
+**Files:**
+- Modify: `src/tvplotlines/html/parts/export.js`
+
+- [ ] **Step 1: Research FDX format**
+
+FDX is XML. Root: `<FinalDraft DocumentType="Script" Version="6">`. Key elements:
+- `<Content>` wraps `<Paragraph>` elements
+- `<Paragraph Type="Action">` for beats/events
+- `<Paragraph Type="Scene Heading">` for episode markers
+- `<Text>` inside `<Paragraph>` for actual text
+
+- [ ] **Step 2: Implement FDX export**
+
+```javascript
+function exportFDX(data, filename) {
+  let xml = '<?xml version="1.0" encoding="UTF-8"?>\n';
+  xml += '<FinalDraft DocumentType="Script" Template="No" Version="6">\n';
+  xml += '<Content>\n';
+
+  for (const ep of data.episodes) {
+    // Episode heading
+    xml += `<Paragraph Type="Scene Heading"><Text>${escapeXml(ep.episode + ' — ' + ep.theme)}</Text></Paragraph>\n`;
+
+    // Group events by plotline
+    for (const pl of data.plotlines) {
+      const events = ep.events.filter(e => e.storyline === pl.id);
+      if (events.length === 0) continue;
+      xml += `<Paragraph Type="Action"><Text Font="Bold">${escapeXml(pl.name)} [${pl.rank}]</Text></Paragraph>\n`;
+      for (const ev of events) {
+        xml += `<Paragraph Type="Action"><Text>[${ev.function}] ${escapeXml(ev.event)}</Text></Paragraph>\n`;
+      }
+    }
+  }
+
+  xml += '</Content>\n</FinalDraft>';
+  const blob = new Blob([xml], {type: 'application/xml'});
+  downloadBlob(blob, filename + '.fdx');
+}
+
+function escapeXml(s) {
+  return s.replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
+}
+```
+
+- [ ] **Step 3: Test — open in Final Draft or text editor**
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add src/tvplotlines/html/parts/export.js
+git commit -m "feat: add Final Draft .fdx export"
+```
+
+---
+
+## Task 8: LLM pipeline — API client
+
+**Files:**
+- Create: `src/tvplotlines/html/parts/pipeline.js`
+- Reference: `src/tvplotlines/prompts_en/pass0.md` through `pass4.md`
+
+- [ ] **Step 1: Implement API client**
+
+```javascript
+async function callLLM(systemPrompt, userMessage, provider, apiKey, onChunk) {
+  if (provider === 'anthropic') {
+    return callAnthropic(systemPrompt, userMessage, apiKey, onChunk);
+  } else {
+    return callOpenAI(systemPrompt, userMessage, apiKey, onChunk);
+  }
+}
+
+async function callAnthropic(systemPrompt, userMessage, apiKey, onChunk) {
+  const resp = await fetch('https://api.anthropic.com/v1/messages', {
+    method: 'POST',
+    headers: {
+      'x-api-key': apiKey,
+      'anthropic-version': '2023-06-01',
+      'anthropic-dangerous-direct-browser-access': 'true',
+      'content-type': 'application/json',
+    },
+    body: JSON.stringify({
+      model: 'claude-sonnet-4-20250514',
+      max_tokens: 16384,
+      system: systemPrompt,
+      messages: [{role: 'user', content: userMessage}],
+      stream: true,
+    }),
+  });
+  // Parse SSE stream, call onChunk for progress, return full text
+  // ... (full SSE parsing implementation)
+}
+```
+
+- [ ] **Step 2: Test with real API key**
+
+Build, open HTML, enter API key, verify a simple test call works.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add src/tvplotlines/html/parts/pipeline.js
+git commit -m "feat: add LLM API client for browser (Anthropic + OpenAI)"
+```
+
+---
+
+## Task 9: LLM pipeline — 5 passes
+
+**Files:**
+- Modify: `src/tvplotlines/html/parts/pipeline.js`
+- Reference: `src/tvplotlines/prompts_en/pass0.md` through `pass4.md`, `glossary.md`
+
+- [ ] **Step 1: Embed prompts**
+
+Read all prompt files from `src/tvplotlines/prompts_en/`. Embed as JS string constants in pipeline.js. Replace `{GLOSSARY}` placeholder with glossary content at build time.
+
+- [ ] **Step 2: Implement 5-pass orchestrator**
+
+```javascript
+async function runPipeline(synopses, seriesName, provider, apiKey, onProgress) {
+  onProgress('Pass 1/5: extracting characters...');
+  const pass0Result = await runPass0(synopses, provider, apiKey);
+
+  onProgress('Pass 2/5: identifying plotlines...');
+  const pass1Result = await runPass1(synopses, pass0Result, provider, apiKey);
+
+  // ... passes 2-4, each building on previous results
+
+  onProgress('Done!');
+  return finalResult;
+}
+```
+
+Each pass: build user message from synopses + previous results, call LLM, parse JSON response.
+
+- [ ] **Step 3: Implement file upload UI**
+
+Drag & drop zone + file picker button. Read .txt files via FileReader API. Parse filenames for episode codes (e.g., `S01E01.txt`).
+
+- [ ] **Step 4: Wire pipeline to UI**
+
+Upload files → show progress bar → run pipeline → save to localStorage → render grid.
+
+- [ ] **Step 5: Test end-to-end with real API key and sample synopses**
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add src/tvplotlines/html/parts/pipeline.js
+git commit -m "feat: port 5-pass LLM pipeline to browser JS"
+```
+
+---
+
+## Task 10: LLM settings modal
+
+**Files:**
+- Modify: `src/tvplotlines/html/parts/app.js`
+- Modify: `src/tvplotlines/html/parts/shell.html`
+
+- [ ] **Step 1: Implement settings modal**
+
+- Provider selector: Claude / OpenAI buttons
+- API key field (password type, show/hide toggle)
+- Step-by-step instructions with screenshots placeholder (links to external video)
+- "Save" stores to localStorage
+- "Skip" closes modal
+
+- [ ] **Step 2: Show on first use**
+
+If no API key in localStorage and not skipped → show after welcome/onboarding.
+
+- [ ] **Step 3: Add "LLM Settings" button to toolbar**
+
+- [ ] **Step 4: Build and test**
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/tvplotlines/html/parts/app.js src/tvplotlines/html/parts/shell.html
+git commit -m "feat: add LLM settings modal with provider selection"
+```
+
+---
+
+## Task 11: Welcome screen
+
+**Files:**
+- Modify: `src/tvplotlines/html/parts/app.js`
+- Modify: `src/tvplotlines/html/parts/shell.html`
+- Modify: `src/tvplotlines/html/parts/style.css`
+
+- [ ] **Step 1: Implement welcome screen**
+
+- Japanese minimalism background
+- "Play me" button (centered)
+- "Skip →" in appropriate position
+- If `Store.hasSeenOnboarding()` → skip directly to grid
+
+- [ ] **Step 2: Update init logic**
+
+```javascript
+(function init() {
+  // Theme
+  if (localStorage.getItem('theme') === 'dark') {
+    document.documentElement.classList.add('dark');
+  }
+  // Route
+  if (!Store.hasSeenOnboarding()) {
+    showScreen('welcome');
+  } else {
+    loadLastSeries();
+    showScreen('grid');
+  }
+})();
+```
+
+- [ ] **Step 3: Build and test**
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add src/tvplotlines/html/parts/
+git commit -m "feat: add welcome screen with Play me button"
+```
+
+---
+
+## Task 12: Onboarding animation
+
+**Files:**
+- Modify: `src/tvplotlines/html/parts/app.js`
+- Modify: `src/tvplotlines/html/parts/style.css`
+
+- [ ] **Step 1: Implement onboarding sequence**
+
+Coded animation on real app screens (not video):
+
+```javascript
+async function runOnboarding() {
+  // 1. Welcome screen → skip button animates click
+  await animateClick('skip');
+  await delay(500);
+
+  // 2. LLM modal appears → Claude selected → key typed
+  showLLMModal();
+  await delay(1000);
+  await animateSelect('claude');
+  await animateTyping('api-key-input', 'sk-ant-•••••••••');
+  await animateClick('save-key');
+  await delay(500);
+
+  // 3. File upload zone appears → files appear
+  await delay(500);
+  await animateFileDrop(['S01E01.txt', 'S01E02.txt', 'S01E03.txt']);
+  await delay(500);
+
+  // 4. Pipeline runs — progress shows passes 1-5
+  for (let i = 1; i <= 5; i++) {
+    showProgress(`Pass ${i}/5: ${passNames[i]}...`);
+    await delay(1500);
+    // Reveal corresponding parts of the grid gradually
+    revealGridPass(i, demoData);
+  }
+
+  // 5. Show analytics tab
+  await delay(1000);
+  await animateClick('analytics-tab');
+  await delay(2000);
+
+  // 6. Show export buttons
+  await animateHighlight('export-buttons');
+  await delay(1500);
+
+  // 7. End — show "Connect your LLM" modal
+  Store.markOnboardingSeen();
+  showLLMModal();
+}
+```
+
+- [ ] **Step 2: Add animation helpers**
+
+`animateClick`, `animateTyping`, `animateFileDrop`, `animateHighlight`, `revealGridPass` — CSS transitions + JS timeouts. Subtitles/tooltips appear alongside each step.
+
+- [ ] **Step 3: Add "Watch onboarding" button to menu**
+
+Resets `tvplotlines_onboarding_seen` and replays.
+
+- [ ] **Step 4: Build and test full onboarding flow**
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/tvplotlines/html/parts/
+git commit -m "feat: add coded onboarding animation with Breaking Bad demo"
+```
+
+---
+
+## Task 13: CLI integration — `tvplotlines run --html`
+
+**Files:**
+- Modify: `src/tvplotlines/cli.py`
+- Modify: `src/tvplotlines/html/build.py`
+
+- [ ] **Step 1: Add --html flag to CLI**
+
+In `cli.py`, add `--html` option to the `run` command. After pipeline completes, if `--html` is set, call `build.py` with the result JSON.
+
+- [ ] **Step 2: Implement in build.py**
+
+`build(output_path, data_path)` already accepts custom data. CLI passes result JSON path.
+
+- [ ] **Step 3: Test end-to-end**
+
+```bash
+tvplotlines run examples/synopses/bb/ --html --output bb_viewer.html
+open bb_viewer.html
+```
+
+Verify: HTML opens with user's data instead of demo.
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add src/tvplotlines/cli.py src/tvplotlines/html/build.py
+git commit -m "feat: add --html flag to CLI for standalone viewer export"
+```
+
+---
+
+## Cross-file consistency checklist
+
+- [ ] `FUNCTION_TENSION` values identical in `analytics.js` and original `analytics.py`
+- [ ] Tension level thresholds (≤1.2→1, etc.) identical in `analytics.js` and original template
+- [ ] CSS class names (`fn-*`, `rank-*`, `ana-*`) identical in `style.css` and JS rendering
+- [ ] `RANK_ORDER` identical in `grid.js` and `analytics.js`
+- [ ] Dark mode: every element readable in both themes
+- [ ] Guest character detection: `guest:` prefix handling identical to `helpers.py`
+- [ ] Demo data (`bb_s01.json`) loads correctly and matches grid rendering
diff --git a/docs/viewer/spec.md b/docs/viewer/spec.md
new file mode 100644
index 0000000..481841b
--- /dev/null
+++ b/docs/viewer/spec.md
@@ -0,0 +1,154 @@
+---
+type: spec
+project: tvplotlines
+status: active
+---
+
+# tvplotlines Standalone HTML App — Spec
+
+## Суть
+
+Один скачиваемый HTML-файл — полноценное приложение для анализа сюжетных линий сериалов. Открыл в браузере — работает. Ноль установки, данные не покидают компьютер.
+
+## Целевая аудитория
+
+Сценаристы 55+, минимальные технические навыки. Не пользуются терминалом. Боятся отдавать сценарии сторонним сервисам, но доверяют своему LLM (Claude/ChatGPT).
+
+## Пользовательский flow
+
+### Первый запуск
+
+1. ПЕРВЫЙ РАЗ Открыл HTML → **Welcome-экран**: кнопка "Play me". В углу "Skip".
+2. Нажал Play → **Онбординг-демо**: анимированная симуляция пайплайна на Breaking Bad. Проходы появляются один за другим, грид заполняется в реальном времени. Пользователь видит как работает инструмент.
+3. В конце демо → **"Подключить свой LLM"**: выбор Claude / OpenAI, поле для API ключа, инструкция со скриншотами + ссылка на видео "Как получить АПИ Клод/ОпенИИ - чье-то найти". Кнопка "Пропустить" — остаться на демо-данных.
+4. После подключения (или пропуска) → **Рабочий экран**: грид с данными Breaking Bad.
+
+### Повторный визит
+
+- API ключ уже в localStorage — не спрашивает
+- Последние результаты сохранены — открывается на том же месте
+- Меню: "Посмотреть онбординг", "Настройки LLM", "Загрузить синопсисы"
+
+### Работа со своими данными
+
+1. Drag & drop txt-файлов синопсисов (или кнопка "Выбрать файлы")
+2. Прогресс: "Проход 1/5: извлекаю персонажей..."
+3. Результат появляется в гриде
+4. Результат автоматически сохраняется в localStorage
+
+### Накопление
+
+- Все обработанные сериалы сохраняются в localStorage
+- Dropdown для переключения между сериалами
+- Можно зайти через неделю — всё на месте
+
+## Экраны
+
+### Welcome
+
+- Фон: японский минимализм
+- Кнопка "Play me" — запускает онбординг
+- "Skip →" в правильном месте для такой фукнции
+
+### Онбординг-демо
+
+Кодированная анимация на реальных экранах приложения (не видео):
+
+1. Skip-экран с кнопкой → нажимается
+2. Появляется окно "выбери LLM" → выбирается Claude (чередовать Claude/OpenAI рандомно?)
+3. Вставляется ключ (анимация набора)
+4. Появляется зона загрузки файлов → один файл через кнопку, второй drag & drop
+5. Запускается пайплайн — прогресс проходов 1-5, грид заполняется в реальном времени
+6. Результат: грид, аналитика, экспорт — показываем каждую фичу
+7. Всё озвучено подписями/тултипами (не аудио)
+
+### Подключение LLM
+
+- Модальное окно поверх грида с демо-данными
+- Две кнопки: Claude / OpenAI
+- По выбору: поле для API ключа + пошаговая инструкция (3 шага со скриншотами)
+- Ссылка на видео "как получить ключ"
+- Ключ сохраняется в localStorage
+- "Пропустить" — закрывает окно, работаешь с демо-данными
+
+### Рабочий экран — Грид
+
+Из tvplotlines-app:
+- Toolbar: название сериала, dropdown выбора сериала, кнопки экспорта, dark mode toggle
+- Фильтры: сезон, персонажи, функции событий
+- Таблица: сюжетные линии (ряды) x эпизоды (колонки)
+- Первая колонка sticky: имя линии, ранг (A/B/C), персонаж-драйвер
+- Ячейки: карточки событий, цвет по функции (setup серый, climax красный, resolution зелёный...)
+- Клик по карточке: модальное окно с деталями события (read-only в v1)
+
+### Рабочий экран — Аналитика
+
+Из tvplotlines-app:
+- Season scorecard: таблица с span-bar
+- Arc map: тепловая карта напряжения
+- Episode pulse: stacked bars
+- Convergence moments: таймлайн взаимодействий линий
+- Character weight: горизонтальные бары
+
+## Экспорт
+
+Четыре формата, кнопки в toolbar:
+
+1. **JSON** — наш формат tvplotlines, тот же что генерирует библиотека. Для импорта обратно.
+2. **XLS** — таблица: строки = события, колонки = эпизод, сюжетная линия, функция, персонажи, текст. Библиотека SheetJS (inline).
+3. **TXT** — plain text, структурированный по эпизодам и линиям.
+4. **Final Draft (.fdx)** — XML-формат Final Draft. Outline с beat board: каждая сюжетная линия = storyline, каждое событие = beat с функцией и описанием.
+
+## Техническая архитектура
+
+### Один HTML-файл содержит:
+
+- `<style>` — минимализм, почти олдскульный дизайн первого интернета, но чисто без нарочитой аналоговости, темная тема обязательно должна быть, проверить чтобы ВСЕ элементы ОДИНАКОВО читались и работали при переключении темы с темной на светлую и наоборот
+- `<script>` — весь JS:
+  - Онбординг-анимация (таймеры, поэтапное появление)
+  - LLM-пайплайн (5 проходов, промпты из tvplotlines, fetch + SSE streaming)
+  - Грид-рендеринг
+  - Аналитика-рендеринг
+  - Экспорт (SheetJS inline для XLS, XML-генерация для .fdx)
+  - localStorage менеджер (ключ, результаты, настройки)
+  - Router (Welcome / Grid / Analytics — переключение через JS, без перезагрузки)
+- `<script type="application/json" id="demo-data">` — Breaking Bad S01 результат
+- HTML-разметка всех экранов
+
+### LLM-пайплайн в браузере
+
+Порт 5 проходов tvplotlines из Python в JS:
+- Промпты — те же самые (копируются из библиотеки)
+- Формат JSON — тот же
+- API вызов — fetch напрямую к api.anthropic.com или api.openai.com
+- Стриминг — SSE для прогресса
+- CORS: Anthropic API поддерживает browser requests с API ключом в заголовке
+
+### Хранение данных
+
+localStorage:
+- `tvplotlines_api_key` — зашифрованный API ключ
+- `tvplotlines_provider` — "anthropic" | "openai"
+- `tvplotlines_results` — объект {series_name: result_json}
+- `tvplotlines_settings` — dark mode, последний открытый сериал
+- `tvplotlines_onboarding_seen` — boolean
+
+### Зависимости (всё inline)
+
+- SheetJS (для XLS экспорта) — ~200KB минифицированный
+- Никаких CDN, никаких внешних запросов кроме LLM API
+
+## Связь с библиотекой tvplotlines
+
+`tvplotlines run my-series/ --html` генерирует этот же HTML с данными пользователя вместо Breaking Bad. Пайплайн уже выполнен на стороне Python, HTML используется только для просмотра и экспорта.
+
+## Размер файла
+
+~1-2 MB (SheetJS ~200KB + CSS ~15KB + JS ~100KB + демо-данные ~50KB + онбординг-ассеты).
+
+## Чего НЕ делаем в v1
+
+- Редактирование (merge/split/правка событий)
+- Платный аккаунт (прокси-бэкенд)
+- Screen assistant как онбординг-помощник
+- Мультиязычность интерфейса
diff --git a/src/tvplotlines/html/build.py b/src/tvplotlines/html/build.py
index a1c3d41..609937e 100644
--- a/src/tvplotlines/html/build.py
+++ b/src/tvplotlines/html/build.py
@@ -2,6 +2,10 @@
 
 Reads shell.html and replaces placeholders with CSS, JS, and demo data
 to produce a single self-contained HTML file.
+
+Prompts from ``src/tvplotlines/prompts/{hollywood,narratology}/*.md`` are
+inlined into the HTML so the viewer runs either pipeline in the browser
+without fetching files at runtime.
 """
 
 import argparse
@@ -11,9 +15,32 @@
 
 _PARTS_DIR = Path(__file__).parent / "parts"
 _SHELL_PATH = _PARTS_DIR / "shell.html"
+_PROMPTS_DIR = Path(__file__).parent.parent / "prompts"
 _DEFAULT_DEMO = Path(__file__).parent.parent.parent.parent / "examples" / "results" / "bb_s01.json"
 
 
+def _load_prompts() -> dict[str, dict[str, str]]:
+    """Load every prompt for every system, substituting {GLOSSARY}.
+
+    Returns ``{system: {pass_name: prompt_text}}``.
+    """
+    prompts: dict[str, dict[str, str]] = {}
+    for system_dir in sorted(_PROMPTS_DIR.iterdir()):
+        if not system_dir.is_dir() or system_dir.name.startswith("_"):
+            continue
+        system = system_dir.name
+        glossary_path = system_dir / "glossary.md"
+        glossary = glossary_path.read_text(encoding="utf-8") if glossary_path.exists() else ""
+        prompts[system] = {}
+        for md_file in sorted(system_dir.glob("*.md")):
+            name = md_file.stem
+            text = md_file.read_text(encoding="utf-8")
+            if "{GLOSSARY}" in text:
+                text = text.replace("{GLOSSARY}", glossary)
+            prompts[system][name] = text
+    return prompts
+
+
 def load_part(name: str) -> str:
     """Load a part file by name from the parts/ directory.
 
@@ -61,9 +88,12 @@ def build_html(data_path: Path | None = None) -> str:
         # Validate JSON
         json.loads(demo_data)
 
+    prompts_blob = json.dumps(_load_prompts(), ensure_ascii=False)
+    prompts_js = f"const _PROMPTS = {prompts_blob};"
+
     html = shell
     html = html.replace("/* {{STYLE}} */", style)
-    html = html.replace("/* {{APP_JS}} */", app_js)
+    html = html.replace("/* {{APP_JS}} */", prompts_js + "\n\n" + app_js)
     html = html.replace("/* {{DEMO_DATA}} */", demo_data)
 
     return html
diff --git a/src/tvplotlines/html/parts/app.js b/src/tvplotlines/html/parts/app.js
index 414375b..da2b455 100644
--- a/src/tvplotlines/html/parts/app.js
+++ b/src/tvplotlines/html/parts/app.js
@@ -302,9 +302,11 @@ function _showLLMSettings() {
       <label for="llm-system" style="display:block;margin-bottom:4px;font-weight:600">Analysis system</label>
       <select id="llm-system" style="width:100%;padding:6px;border-radius:4px;border:1px solid var(--border, #ccc)">
         <option value="hollywood" ${system === 'hollywood' ? 'selected' : ''}>Hollywood — screenwriting (story DNA, Freytag)</option>
-        <option value="narratology" disabled>Narratology — structuralist (coming soon)</option>
+        <option value="narratology" ${system === 'narratology' ? 'selected' : ''}>Narratology — structuralist (Bal, Todorov, Greimas, Bremond)</option>
       </select>
-      <div style="font-size:0.8em;color:#888;margin-top:4px">Narratology prompts are in place; the runtime is coming in v2.</div>
+      <div style="font-size:0.8em;color:#888;margin-top:4px">
+        Hollywood extracts plotlines as hero/goal/obstacle/stakes. Narratology frames them as actant programs (who chases what, who helps, who opposes). The grid renders both.
+      </div>
     </div>
     <button id="llm-save-btn" style="padding:6px 16px;border-radius:4px;cursor:pointer">Save</button>
     <span id="llm-save-status" style="margin-left:8px;color:green;display:none">Saved!</span>
diff --git a/src/tvplotlines/html/parts/export.js b/src/tvplotlines/html/parts/export.js
index fd98734..cf02c36 100644
--- a/src/tvplotlines/html/parts/export.js
+++ b/src/tvplotlines/html/parts/export.js
@@ -233,8 +233,119 @@ function _handleExport(format) {
   }
 }
 
-// PDF: leverage the browser's print stack. Print CSS below lays the grid out
-// on landscape pages so a Cmd+P → "Save as PDF" yields a usable document.
-function exportPDF() {
-  window.print();
+// PDF: generate a data-driven vector PDF via jsPDF, lazily loaded from CDN.
+// Falls back to the browser print stack if the library can't be fetched
+// (e.g. offline). Either way the user gets a PDF.
+async function exportPDF() {
+  if (!_currentData) { alert('No data loaded'); return; }
+  try {
+    await _loadJsPDF();
+  } catch (err) {
+    console.warn('jsPDF load failed, falling back to print:', err);
+    window.print();
+    return;
+  }
+  try {
+    _buildPDF(_currentData);
+  } catch (err) {
+    console.error('PDF build failed:', err);
+    alert(`Couldn't build PDF: ${err.message}. Falling back to print.`);
+    window.print();
+  }
+}
+
+function _loadJsPDF() {
+  if (window.jspdf && window.jspdf.jsPDF) return Promise.resolve();
+  return new Promise((resolve, reject) => {
+    const s = document.createElement('script');
+    s.src = 'https://cdn.jsdelivr.net/npm/jspdf@2.5.1/dist/jspdf.umd.min.js';
+    s.onload = () => (window.jspdf && window.jspdf.jsPDF) ? resolve() : reject(new Error('jsPDF not attached'));
+    s.onerror = () => reject(new Error('network error fetching jsPDF'));
+    document.head.appendChild(s);
+  });
+}
+
+function _buildPDF(data) {
+  const { jsPDF } = window.jspdf;
+  const doc = new jsPDF({ orientation: 'landscape', unit: 'mm', format: 'a4' });
+  const margin = 12;
+  const pageW = doc.internal.pageSize.getWidth();
+  const pageH = doc.internal.pageSize.getHeight();
+  let y = margin;
+
+  const ctx = data.context || {};
+  const seriesLabel = [ctx.series, ctx.season].filter(Boolean).join(' · ') || 'tvplotlines';
+
+  const line = (text, size, weight = 'normal', indent = 0, color = [30, 30, 30]) => {
+    doc.setFont('helvetica', weight);
+    doc.setFontSize(size);
+    doc.setTextColor(color[0], color[1], color[2]);
+    const wrapped = doc.splitTextToSize(text, pageW - margin * 2 - indent);
+    for (const ln of wrapped) {
+      if (y > pageH - margin - size / 2) { doc.addPage(); y = margin; }
+      doc.text(ln, margin + indent, y);
+      y += size * 0.45 + 0.8;
+    }
+  };
+  const gap = (mm) => { y += mm; if (y > pageH - margin) { doc.addPage(); y = margin; } };
+
+  // Title
+  line(seriesLabel, 22, 'bold');
+  if (ctx.format || ctx.genre || ctx.system) {
+    line([ctx.format, ctx.genre, ctx.system && `system: ${ctx.system}`]
+      .filter(Boolean).join('  ·  '), 10, 'normal', 0, [110, 110, 110]);
+  }
+  if (ctx.story_engine) { gap(2); line(ctx.story_engine, 11, 'italic', 0, [70, 70, 70]); }
+  gap(6);
+
+  // Plotlines
+  const plotlines = data.plotlines || [];
+  for (const p of plotlines) {
+    if (y > pageH - 30) { doc.addPage(); y = margin; }
+    const rank = p.rank ? `[${p.rank}] ` : '';
+    line(`${rank}${p.name}`, 14, 'bold');
+    const meta = [p.type, p.nature, p.confidence].filter(Boolean).join('  ·  ');
+    if (meta) line(meta, 9, 'normal', 0, [130, 130, 130]);
+    if (p.hero) line(`Hero: ${p.hero}`, 10, 'normal', 4);
+    if (p.goal) line(`Goal: ${p.goal}`, 10, 'normal', 4);
+    if (p.obstacle) line(`Obstacle: ${p.obstacle}`, 10, 'normal', 4);
+    if (p.stakes) line(`Stakes: ${p.stakes}`, 10, 'normal', 4);
+
+    // Events for this plotline
+    const events = [];
+    for (const ep of (data.episodes || [])) {
+      for (const ev of (ep.events || [])) {
+        if (ev.plotline_id === p.id) events.push({ ep: ep.episode, fn: ev.function, text: ev.event, arc: ev.plot_fn });
+      }
+    }
+    if (events.length) {
+      gap(1);
+      for (const e of events) {
+        const arcTag = e.arc ? ` / ${e.arc}` : '';
+        line(`• [${e.ep}] (${e.fn}${arcTag}) ${e.text}`, 9, 'normal', 6, [50, 50, 50]);
+      }
+    }
+    gap(4);
+  }
+
+  // Episodes section
+  const episodes = data.episodes || [];
+  if (episodes.length) {
+    doc.addPage(); y = margin;
+    line('Episodes', 18, 'bold');
+    gap(2);
+    for (const ep of episodes) {
+      if (y > pageH - 20) { doc.addPage(); y = margin; }
+      const head = ep.theme ? `${ep.episode} — ${ep.theme}` : ep.episode;
+      line(head, 12, 'bold');
+      for (const ev of (ep.events || [])) {
+        const pl = ev.plotline_id ? `[${ev.plotline_id}]` : '[orphan]';
+        line(`• ${pl} (${ev.function}) ${ev.event}`, 9, 'normal', 4, [60, 60, 60]);
+      }
+      gap(2);
+    }
+  }
+
+  const filename = _exportFilename(data) + '.pdf';
+  doc.save(filename);
 }
diff --git a/src/tvplotlines/html/parts/pipeline.js b/src/tvplotlines/html/parts/pipeline.js
index f1d3638..cdd2d15 100644
--- a/src/tvplotlines/html/parts/pipeline.js
+++ b/src/tvplotlines/html/parts/pipeline.js
@@ -124,815 +124,14 @@ function _parseJSONResponse(text) {
   return JSON.parse(cleaned);
 }
 
-// --- Embedded prompts ---
-// Glossary is inlined into each pass prompt where {GLOSSARY} appears.
+// --- Embedded prompts (inlined by build.py from prompts/{system}/*.md) ---
+// _PROMPTS is defined above the APP_JS block.
+const _PROMPT_PASS0 = _PROMPTS.hollywood.pass0;
+const _PROMPT_PASS1 = _PROMPTS.hollywood.pass1;
+const _PROMPT_PASS2 = _PROMPTS.hollywood.pass2;
+const _PROMPT_PASS3 = _PROMPTS.hollywood.pass3;
+const _PROMPT_PASS4 = _PROMPTS.hollywood.pass4;
 
-const _GLOSSARY = `## story DNA
-
-Every plotline has four parts: **hero** (who drives it), **goal** (what they want), **obstacle** (what blocks them), **stakes** (what happens if they fail). Missing any component—not a plotline, but an event within another plotline.
-
-Some plotlines have no obvious single hero—typically theme-led ones (see plotline:nature), where the problem comes from an institution or system rather than a character. Examples: "MI5 vs Slough House" in Slow Horses, "Professional life at Sterling Cooper" in Mad Men. In such cases, use your judgment to assign the most fitting character as hero—the one most affected, or driving the dynamic, or whose POV dominates.
-
-## plotline
-
-A story with complete Story DNA. Has a three-act structure, conflict, and a causal chain of events. A plotline is tied to a main cast character or an institution, not a guest.
-
-TV episodes typically feature two or more parallel plotlines, denoted by letters A, B, C: a main A plot that dominates screen time and secondary B plots that may offer thematic parallels or counterpoint.
-
-### granularity
-
-The key is GOAL, not character.
-Different plotlines: different heroes, OR one hero with different goals and obstacles and stakes.
-
-Test: if you can't write a logline—"[hero] wants [goal], but [obstacle], and if they fail [stakes]"—it's not a plotline.
-
-For theme-led plotlines, the logline test becomes: "[institution/system] [problem]; [hero] [role in it], stakes: [stakes]." Example: "MI5 covers up its role in the kidnapping; Taverner drives the cover-up, stakes: exposure and careers."
-
-### what is not a plotline
-
-| example                            | what it is                                             |
-| ---------------------------------- | ------------------------------------------------------ |
-| "John has lunch"                   | Background—no goal/conflict                            |
-| "Everyone goes to a party"         | Setting—no hero/stakes                                 |
-| "John is sad"                      | State—no goal/obstacle                                 |
-| "John and Mike's friendship"       | Context—no conflict                                    |
-| "Investigation" (procedural, ep.5) | Part of the case_of_the_week plotline, not a separate one |
-
-## plotline:type
-
-How long does this plotline last?
-
-- **case_of_the_week**—opens and closes within one episode. The show's story engine describes the repeating formula. Story DNA is templated (repeating goal/obstacle/stakes), specific content—filled in per episode.
-- **serialized**—spans multiple episodes or the entire season. Conflicts carry over.
-- **runner**—minor recurring thread. Incomplete Story DNA—no obstacle or resolution, logline is descriptive. Everything else—a full plotline.
-
-## plotline:nature
-
-Where does the main problem come from? This matters because nature tells you what kind of obstacle to look for: an outside enemy (plot-led), the hero's own flaw (character-led), or a system nobody can fix alone (theme-led).
-
-- **plot-led**—from outside the hero. External goal vs antagonist. Stranger Things, CSI.
-- **character-led**—from inside the hero. Internal conflict, the hero IS the problem. Breaking Bad, Fleabag.
-- **theme-led**—from society. Systemic, no single solution. The Wire, Succession.
-
-## plotline:confidence
-
-How complete is the conflict structure?
-
-- **solid**—hero, goal, obstacle, stakes all clear.
-- **partial**—hero and goal clear, obstacle or stakes unclear.
-- **inferred**—plotline implied, conflict structure incomplete.
-
-This matters because inferred plotlines are expected to have incomplete structure—they won't be flagged for missing functions or low event count. Solid plotlines will be.
-
-## format
-
-- **procedural**—each episode has a standalone story (case, patient, mission) that opens and closes within the episode. Even though each episode's case is different, we treat them as one recurring plotline called "Case of the Week"—same structural slot, different content each time. Other plotlines are secondary. CSI, House, Law & Order.
-- **hybrid**—each episode has a case-of-the-week AND serialized plotlines, and they actively intertwine. Both matter. X-Files, Buffy, Good Wife, Grey's Anatomy.
-- **serial**—episodes continue each other. Conflicts don't close within an episode. No case-of-the-week. One clear protagonist. Breaking Bad, Sopranos.
-- **ensemble**—like serial, but no single protagonist. Multiple characters drive their own plotlines with roughly equal screen time. Diagnostic: can you name THE main character? If not—ensemble. Game of Thrones, Succession, The Wire, The Crown.
-
-Base classification on the synopses, not on prior knowledge of the show. The same show can change format between seasons.
-
-Don't default to serial just because character plotlines are present—hybrid means BOTH case-of-the-week AND serialized arcs are significant.
-
-Diagnostic:
-- if E01 and E02 have different cases—procedural or hybrid
-- if E02 continues E01's conflict without closing it—serial or ensemble
-- serial vs ensemble: can you name THE main character? If not—ensemble
-
-## is_anthology
-
-Seasons are independent—new cast, new story, no continuity between seasons. Within a single season, an anthology show has normal structure (serial, procedural, etc.). This matters because prior season data is not passed forward. True Detective, Fargo.
-
-## story_engine
-
-The show's repeating dramatic mechanism in one sentence. Focus on the verbs—what are characters doing each week?
-
-Write the story engine as a one-sentence logline. Two common structures:
-- "[Who] [does what] in order to [goal], but [obstacle]."
-- "When [situation], [who] must [do what], or else [stakes]."
-
-Use whichever fits the show.
-
-Examples from real shows (none follow the formulas exactly—that's fine, the formulas are a starting point):
-- "A high school chemistry teacher diagnosed with inoperable lung cancer turns to manufacturing and selling methamphetamine in order to secure his family's future." (Breaking Bad)
-- "Nine noble families fight for control over the lands of Westeros, while an ancient enemy returns after being dormant for millennia." (Game of Thrones)
-- "An antisocial maverick doctor does whatever it takes to solve puzzling cases that come his way." (House)
-
-## genre
-
-Free text—drama, thriller, comedy, sci-fi, etc.
-
-## event
-
-One action by one character (or group) that changes the situation. Two actions by different characters = two events. Two actions at the same moment where the second is an immediate consequence of the first = one event.
-
-Write event descriptions that are specific and concrete. Include character names, what specifically happens, and the dramatic consequence. Bad: "The team works on the case." Good: "House orders a lumbar puncture over Cameron's objection, risking paralysis to test his sarcoidosis theory."
-
-## function
-
-Each event carries a function—its position in the dramatic structure:
-
-| function | what it does |
-|----------|-------------|
-| \`setup\` | Introduces the plotline. Status quo. |
-| \`inciting_incident\` | The event that starts the plotline. One per plotline, does not repeat. |
-| \`escalation\` | Raises the stakes. Can repeat. |
-| \`turning_point\` | Changes direction. False peak or false collapse. |
-| \`crisis\` | Lowest point. Hero faces what they feared most. True dilemma. |
-| \`climax\` | Peak of the conflict. Outcome is irreversible. |
-| \`resolution\` | Conflict resolved. Aftermath. |
-
-Functions are checked downstream for arc completeness and monotonicity—if a plotline has only setup and escalation across the whole season, that's a flag.
-
-## interaction
-
-How plotlines connect within an episode:
-
-- **thematic_rhyme**—plotlines explore the same theme from different angles.
-- **dramatic_irony**—the audience knows what a character in another plotline doesn't.
-- **convergence**—plotlines merge (characters/conflicts intersect).
-
-## verdict
-
-A structural correction applied after reviewing the full season:
-
-| action | what it does |
-|--------|-------------|
-| \`MERGE\` | Merge two plotlines into one |
-| \`REASSIGN\` | Move an event to a different plotline |
-| \`CREATE\` | Create a new plotline from orphaned events |
-| \`DROP\` | Remove a plotline, redistribute its events |
-| \`REFUNCTION\` | Change an event's function (e.g. escalation → crisis) |`;
-
-const _PROMPT_PASS0 = `# ROLE
-You are a story editor evaluating a show's structure from its synopses.
-
-# CONTEXT
-You receive: show title, season number, and up to 3 first synopses. Your output goes to the next step as context for plotline extraction.
-
-# GLOSSARY
-
-${_GLOSSARY}
-
-# TASK
-
-If \`suggested_plotlines\` is present in the input, use it as additional context — it contains preliminary plotline suggestions from the synopsis writer. These can help with format and ensemble detection, but verify against the synopses.
-
-Read the synopses and determine, in this order:
-### Step 1: Determine format
-What's the episode structure? Use the definitions and diagnostic in Glossary.
-### Step 2: Check anthology
-Are seasons independent?
-### Step 3: Write the story engine
-Write a one-sentence logline. See story_engine in Glossary for structure and examples.
-### Step 4: Determine genre
-
-# OUTPUT
-
-Think through before writing the JSON. You will need to explain your choices in the \`reasoning\` field — it is reviewed by a human.
-
-Response—strictly JSON, no markdown wrapping, no comments outside JSON.
-
-\`\`\`json
-{
-  "show": "Breaking Bad",
-  "season": 1,
-  "format": "serial",
-  "is_anthology": false,
-  "story_engine": "A high school chemistry teacher diagnosed with inoperable lung cancer turns to manufacturing and selling methamphetamine in order to secure his family's future",
-  "genre": "drama",
-  "reasoning": "Episodes continue each other: E01's conflict (first cook) flows into E02 (consequences), no self-contained stories within episodes."
-}
-\`\`\`
-
-Field types:
-
-- \`show\`: string
-- \`season\`: integer
-- \`format\`: enum—\`"procedural"\` | \`"serial"\` | \`"hybrid"\` | \`"ensemble"\`
-- \`is_anthology\`: boolean
-- \`story_engine\`: string—one sentence logline
-- \`genre\`: string
-- \`reasoning\`: string—why you chose this format (1–2 sentences)
-
-# VALIDATION
-
-Code will check:
-
-- JSON schema: all required fields present
-- \`format\` is one of: procedural, serial, hybrid, ensemble
-- \`is_anthology\` is a boolean
-- \`story_engine\` is a non-empty string
-
-Code cannot check: whether your format classification actually matches the synopses, whether story_engine captures the real mechanism—that's your job.`;
-
-const _PROMPT_PASS1 = `# ROLE
-
-You are a story editor who's read the entire season's synopses. Map out the plotlines: who drives each one, what they want, what are the obstacles, what's at stake.
-
-# CONTEXT
-
-You receive: show title, season number, format, story engine, and all episode synopses. If prior season data is provided, you also receive the previous season's cast and plotlines.
-
-Your output—cast list and plotlines with Story DNA—goes to the next step, where events from each episode will be assigned to these plotlines.
-
-# GLOSSARY
-
-${_GLOSSARY}
-
-# TASK
-
-### Step 1: Process prior season (if provided)
-
-If \`prior_season\` is present in the input, process it BEFORE analyzing new synopses.
-
-For each plotline in \`prior_season.plotlines\`, decide based on the NEW season's synopses:
-- **CONTINUES**—present this season. Keep \`id\`, update goal/obstacle/stakes. Example: "Walt: Empire" S1→S2—same goal, but Gus is the obstacle instead of Tuco.
-- **TRANSFORMED**—same hero, goal fundamentally changed. Keep \`id\`, rewrite Story DNA. Example: "Walt: Empire" S4→S5—no longer building, now hiding from consequences.
-- **ENDED**—resolved or disappeared. Don't include.
-
-For each character in \`prior_season.cast\`:
-- If the character appears in this season's synopses—reuse the same \`id\` and \`name\`.
-- If the character does not appear—don't include them.
-
-Only after processing all prior plotlines, identify NEW plotlines not present before.
-
-### Step 2: Read all synopses and suggested plotlines
-Read ALL season synopses. If \`suggested_plotlines\` is present in the input, use them as a starting point — they come from an earlier analysis of the same synopses. Verify each suggestion against the text: keep what you find evidence for, drop what you don't, add what was missed. Story DNA is reconstructed from the aggregate of mentions across the season. Don't invent—mark confidence.
-
-### Step 3: Identify the main cast
-Recurring characters who drive plotlines. One character per cast entry. Guests are not cast.
-
-### Step 4: Extract plotlines
-For each plotline, fill in:
-- Story DNA: hero, goal, obstacle, stakes
-- type: case_of_the_week, serialized, or runner
-- nature: plot-led, character-led, or theme-led
-- confidence: solid, partial, or inferred
-
-# RULES
-### Naming
-Name and id = ONE abstract word by GOAL, not by event or outcome. Examples: "belonging", "leadership", "love", "redemption". Do NOT use compound names like "gang_survival" or "family_destruction"—use "survival" or "family". The \`id\` must be a single snake_case word matching the \`name\`.
-
- Use \`Hero: Theme\` format for plotline names (e.g. "House: Authority", "Cameron: Ethics", "Jon: Honor"). This makes it clear who drives each plotline and prevents confusion during event assignment.
-
-Case_of_the_week plotline: name it by the franchise formula—"Case of the Week", "Crime of the Week", "Mission", etc.—so it is immediately clear this is a recurring structure.
-
-For theme-led plotlines, name by the institutional dynamic or conflict rather than by hero (e.g. "MI5 vs Slough House", "Lab Politics", "Professional Life at Sterling Cooper").
-
-### Seed and Wraparound
-
-Seed—an event function at the next step. Wraparound—a narrative device at the next step. Do not create plotlines of these types.
-
-### Format and Resolution
-
-- **serial/ensemble**: plotlines may extend beyond the season, cliffhanger in the finale is acceptable.
-- **is_anthology=true**: each season is independent, don't reference other seasons.
-
-### Quantity Expectations
-
-- Procedural: 1 case_of_the_week + 1–3 serialized arcs. Max 5 total.
-- Hybrid: 1 case_of_the_week + 2–4 serialized. Max 5 total.
-- Serial (≤8 episodes): max 5 plotlines. Serial (9+ episodes): max 7. Runners must span 3+ episodes.
-- Ensemble (≤8 episodes): max 7 plotlines. Ensemble (9+ episodes): max 9. Runners must span 3+ episodes.
-
-### General
-
-- When in doubt—do NOT create a plotline.
-- For procedural/hybrid format: create exactly 1 plotline with type case_of_the_week.
-- Nature of a plotline and nature of individual events can differ—plot-led action serving a character-led plotline is normal.
-- Don't invent missing Story DNA components—mark confidence as partial or inferred instead.
-- Goal language: same language as the synopses.
-
-# OUTPUT
-
-Think through your choices before writing the JSON. Each plotline must pass the logline test, and your work is reviewed by a human.
-
-Response—strictly JSON, no markdown wrapping, no comments outside JSON.
-
-\`\`\`json
-{
-  "show": "Breaking Bad",
-  "season": 1,
-  "cast": [
-    {"id": "walt", "name": "Walter White", "aliases": ["Walt", "Heisenberg", "Mr. White"]},
-    {"id": "jesse", "name": "Jesse Pinkman", "aliases": ["Jesse", "Cap'n Cook"]},
-    {"id": "hank", "name": "Hank Schrader", "aliases": ["Hank"]},
-    {"id": "skyler", "name": "Skyler White", "aliases": ["Skyler"]},
-    {"id": "tuco", "name": "Tuco Salamanca", "aliases": ["Tuco"]}
-  ],
-  "plotlines": [
-    {
-      "id": "empire",
-      "name": "Walt: Empire",
-      "hero": "walt",
-      "goal": "build a drug business",
-      "obstacle": "moral choices, escalating danger, unpredictable partners",
-      "stakes": "death, loss of humanity",
-      "type": "serialized",
-      "nature": "character-led",
-      "confidence": "solid"
-    },
-    {
-      "id": "family",
-      "name": "Walt: Family",
-      "hero": "walt",
-      "goal": "keep the family together and hide the truth",
-      "obstacle": "cancer, family pressure for treatment, escalating lies",
-      "stakes": "family breakdown, exposure",
-      "type": "serialized",
-      "nature": "character-led",
-      "confidence": "solid"
-    },
-    {
-      "id": "investigation",
-      "name": "Hank: Investigation",
-      "hero": "hank",
-      "goal": "find the new meth producer",
-      "obstacle": "no direct evidence, only circumstantial traces",
-      "stakes": "criminal at large, public threat",
-      "type": "serialized",
-      "nature": "plot-led",
-      "confidence": "solid"
-    },
-    {
-      "id": "partnership",
-      "name": "Jesse: Partnership",
-      "hero": "jesse",
-      "goal": "survive as Walt's drug business partner",
-      "obstacle": "incompetence, fear, conflict with Walt",
-      "stakes": "prison or death",
-      "type": "serialized",
-      "nature": "character-led",
-      "confidence": "solid"
-    },
-    {
-      "id": "cancer",
-      "name": "Walt: Cancer",
-      "hero": "walt",
-      "goal": "deal with the diagnosis",
-      "obstacle": null,
-      "stakes": null,
-      "type": "runner",
-      "nature": "character-led",
-      "confidence": "partial"
-    }
-  ]
-}
-\`\`\`
-
-Field types:
-
-**cast[]:**
-
-- \`id\`: string—unique snake_case identifier, used in \`hero\` field and in event \`characters\` at the next step
-- \`name\`: string—full name as in credits
-- \`aliases\`: array of strings—name variants found in synopses
-
-**plotlines[]:**
-
-- \`id\`: string—unique snake_case identifier (stable, doesn't change on rename)
-- \`name\`: string—display name (see naming convention)
-- \`hero\`: string—\`id\` of a character from cast
-- \`goal\`: string—in synopsis language
-- \`obstacle\`: string | null—in synopsis language (null for runners)
-- \`stakes\`: string | null—in synopsis language (null for runners)
-- \`type\`: enum—\`"case_of_the_week"\` | \`"serialized"\` | \`"runner"\`
-- \`nature\`: enum—\`"plot-led"\` | \`"character-led"\` | \`"theme-led"\`
-- \`confidence\`: enum—\`"solid"\` | \`"partial"\` | \`"inferred"\`
-
-Language of \`goal\`, \`obstacle\`, \`stakes\` fields—in the language of the synopsis.
-
-The \`span\` field (which episodes the plotline appears in) is computed by code from the next step's results—not included here.
-
-# VALIDATION
-
-Code will check:
-
-- JSON schema: all required fields present, enum values valid
-- Each \`hero\` references an existing \`id\` in \`cast\`
-- For procedural/hybrid format: exactly 1 plotline with type case_of_the_week
-
-Code cannot check: whether Story DNA makes narrative sense, whether you found all the plotlines—that's your job. Rank (A/B/C) is computed by code after the next step, not by you.`;
-
-const _PROMPT_PASS2 = `# ROLE
-You are a story editor breaking down a single episode: what happens, which plotline does it serve, what function does it play.
-
-# CONTEXT
-You receive: show title, season number, format, story engine, cast (with IDs), plotlines (with IDs and Story DNA), and one episode synopsis. Your output is one episode's worth of events and interactions.
-
-# GLOSSARY
-
-${_GLOSSARY}
-
-# TASK
-
-### Step 1: Break the synopsis into events
-Go through the synopsis sentence by sentence. Each sentence should result in at least one event.
-
-### Step 2: Assign each event to a plotline
-For each event, decide which plotline it belongs to. Use the assignment rules below.
-
-### Step 3: Assign functions
-For each event, assign its dramatic function. These are two separate tasks — which plotline an event belongs to and what function it plays are independent decisions.
-
-Assign functions based on what happens **within this episode**, not across the season. An event that is the climax of this episode's story might turn out to be an escalation in the season-long arc — but you only see this episode, so assign based on what you see here.
-
-### Step 4: Identify interactions between plotlines
-Check each pair of plotlines active in this episode. If they connect — through shared theme, dramatic irony, or converging characters — record the interaction. See interaction types in Glossary.
-
-### Step 5: Determine the episode theme
-One sentence. What idea ties the plotlines together? Look at what the climax/resolution of the A-story says.
-
-# RULES
-
-### Assigning events to plotlines
-
-Each event belongs to the plotline whose goal it advances. When multiple characters are in a scene, ask: whose goal moves forward here? That character's plotline owns the event.
-
-Guest characters don't have their own plotlines. A guest's action belongs to the main cast member whose plotline it serves.
-
-When one event advances two plotlines, assign it to the primary one and list the secondary in \`also_affects\`.
-
-### Checking your work
-
-Every sentence of the synopsis must produce at least one event. If you can't map a sentence to an event, you missed something.
-
-Every episode has at least 2-3 active plotlines. If all events ended up in one plotline — re-read the synopsis and look for events that belong to other plotlines, especially serialized ones that continue across episodes. In procedural and hybrid shows, don't assign everything to the case — character arcs and institutional dynamics have events too.
-
-If all plotlines in the episode have only escalation functions, or all have only crisis/resolution — you probably misassigned some functions. A well-written episode takes its main plotline through a full arc: setup → escalation → turning point → climax → resolution. Other plotlines may cover fewer stages, but the A-story typically has all of them.
-
-# OUTPUT
-
-Think through before writing the JSON. Your assignments are reviewed by a human and checked by code.
-
-Response—strictly JSON, no markdown wrapping, no comments outside JSON.
-
-
-\`\`\`json
-{
-  "show": "Breaking Bad",
-  "season": 1,
-  "episode": "S01E03",
-  "events": [
-    {
-      "event": "Walt and Jesse clean up Emilio's remains",
-      "plotline_id": "empire",
-      "function": "escalation",
-      "characters": ["walt", "jesse"],
-      "also_affects": null
-    },
-    {
-      "event": "Krazy-8 talks about his childhood, Walt about cancer",
-      "plotline_id": "empire",
-      "function": "escalation",
-      "characters": ["walt"],
-      "also_affects": ["family"]
-    },
-    {
-      "event": "Walt makes a pros and cons list for killing",
-      "plotline_id": "empire",
-      "function": "turning_point",
-      "characters": ["walt"],
-      "also_affects": null
-    },
-    {
-      "event": "Skyler organizes a family intervention",
-      "plotline_id": "family",
-      "function": "setup",
-      "characters": ["skyler", "walt"],
-      "also_affects": null
-    },
-    {
-      "event": "Family votes for chemo, Walt wants to refuse",
-      "plotline_id": "family",
-      "function": "escalation",
-      "characters": ["walt", "skyler"],
-      "also_affects": null
-    },
-    {
-      "event": "Hank finds the desert cooking site",
-      "plotline_id": "investigation",
-      "function": "escalation",
-      "characters": ["hank"],
-      "also_affects": null
-    },
-    {
-      "event": "DEA finds Krazy-8's car with meth",
-      "plotline_id": "investigation",
-      "function": "escalation",
-      "characters": ["hank"],
-      "also_affects": null
-    },
-    {
-      "event": "Native girl brings a mask to the DEA office",
-      "plotline_id": "investigation",
-      "function": "setup",
-      "characters": ["guest:native_girl"],
-      "also_affects": null
-    },
-    {
-      "event": "Walt decides to release Krazy-8",
-      "plotline_id": "empire",
-      "function": "turning_point",
-      "characters": ["walt"],
-      "also_affects": null
-    },
-    {
-      "event": "Walt notices the missing plate shard",
-      "plotline_id": "empire",
-      "function": "crisis",
-      "characters": ["walt"],
-      "also_affects": null
-    },
-    {
-      "event": "Walt strangles Krazy-8",
-      "plotline_id": "empire",
-      "function": "climax",
-      "characters": ["walt"],
-      "also_affects": null
-    },
-    {
-      "event": "Walt decides to tell Skyler about the cancer",
-      "plotline_id": "family",
-      "function": "turning_point",
-      "characters": ["walt"],
-      "also_affects": null
-    }
-  ],
-  "theme": "the illusion of control",
-  "interactions": [
-    {
-      "type": "thematic_rhyme",
-      "lines": ["empire", "family", "investigation"],
-      "description": "all three plotlines are about control—over another's life, one's own death, the law"
-    },
-    {
-      "type": "dramatic_irony",
-      "lines": ["empire", "investigation"],
-      "description": "the audience knows Walt = Heisenberg, Hank doesn't"
-    }
-  ]
-}
-\`\`\`
-
-### Field Types
-
-**events[]:**
-- \`event\`: string—one sentence
-- \`plotline_id\`: string | null—\`id\` of a plotline from the previous step, or \`null\` if the event doesn't fit any plotline
-- \`function\`: enum—\`"setup"\` | \`"inciting_incident"\` | \`"escalation"\` | \`"turning_point"\` | \`"crisis"\` | \`"climax"\` | \`"resolution"\`
-- \`characters\`: array of strings—\`id\` of characters from cast. For guest characters use \`"guest:short_name"\` (e.g. \`"guest:native_girl"\`)
-- \`also_affects\`: array of strings | null—\`id\` of secondarily affected plotlines
-
-**interactions[]:**
-- \`type\`: enum—\`"thematic_rhyme"\` | \`"dramatic_irony"\` | \`"convergence"\`
-- \`lines\`: array of strings—plotline \`id\`s
-- \`description\`: string
-
-# VALIDATION
-
-Code will check:
-- JSON schema: all required fields, enum values
-- Each \`plotline_id\` references an existing \`id\` from the previous step or is \`null\`
-- Each \`characters\` element references an existing \`id\` from cast or has the \`guest:\` prefix
-- \`theme\` is not empty
-
-Code cannot check: whether events cover the full synopsis, whether function assignments are correct, whether interactions are real—that's your job.`;
-
-const _PROMPT_PASS3 = `# ROLE
-
-You are a story editor with all episodes laid out in front of you. Check the full picture: are plotlines identified correctly, are events assigned right, does the structure hold up? Fix what's wrong.
-
-# CONTEXT
-
-You receive:
-- **show**, **season**, **format**, **story_engine** (series context)
-- **cast**: character list with \`id\`, \`name\`
-- **plotlines**: plotline list with \`id\`, \`name\`, \`hero\`, \`goal\`, \`obstacle\`, \`stakes\`, \`type\`, \`computed_rank\`, \`nature\`, \`confidence\`, \`span\`
-- **episodes**: for each episode—\`events\` (with plotline assignments), \`theme\`, \`interactions\`
-- **diagnostics** (optional): automated flags from post-processing. Each flag has \`plotline\`, \`flag\`, and \`reason\`. Possible flags:
-  - \`low_completeness\`—plotline has fewer arc functions than expected for its confidence (e.g. solid plotline with 3/7)
-  - \`monotonicity_violation\`—function sequence goes backwards past a milestone (e.g. crisis after climax)
-  - \`dominant\`—plotline has more than 50% of all season events
-  These are computed facts—use them in your analysis.
-
-Your output—verdicts (structural corrections)—is applied by code to produce the final result.
-
-# GLOSSARY
-
-${_GLOSSARY}
-
-# TASK
-
-### Step 1: Check each plotline for Story DNA
-
-Complete Story DNA: **hero → goal → obstacle → stakes**.
-
-**Logline test:** if you can write a logline with conflict (hero wants X, but Y stands in the way, Z is at stake)—it's a solid plotline.
-
-But shows can be poorly written. A plotline may exist without a clear goal, with nominal conflict, or be abandoned halfway. That doesn't mean it doesn't exist—it means it's weak. Don't discard weak plotlines—mark confidence instead.
-
-### Step 2: Spot-check event assignments
-
-Scan events across episodes. For each plotline, read its events and check: does this event advance THIS plotline's goal, or would it fit better elsewhere? Common errors:
-
-- Event assigned to hero's A-plotline but actually advances their B-plotline (wrong goal)
-- Event describes a character reacting to another plotline's conflict (should be \`also_affects\`, not primary assignment)
-- Multiple events in a row assigned to the same plotline but describing different conflicts
-
-If you find misassigned events → REASSIGN.
-
-### Step 3: Check plotline arcs
-
-Note: event functions from the previous step reflect each event's role within its episode, not within the season-long arc. Keep this in mind when checking arc progression — a "climax" in episode 3 may be an escalation in the season arc.
-
-If diagnostics include \`low_completeness\` — check if events of this plotline are misassigned to other plotlines (→ REASSIGN them back), or if the plotline is genuinely weak (→ note in your review, don't invent events).
-
-### Step 4: Look for duplication
-
-Two plotlines with the same hero and adjacent goals—most likely one plotline with phases. Signs:
-
-- Same hero, goals are causally linked (goal B is a consequence of goal A)
-- Events of two plotlines alternate in the same episodes
-- No conflict between the two plotlines—they don't contradict each other
-
-If confirmed → MERGE.
-
-If diagnostics include \`dominant\` — a plotline has more than half of all season events. Check if it's actually two plotlines collapsed into one (→ CREATE a second plotline + REASSIGN events to it).
-
-### Step 5: Check orphaned events
-
-Events with \`plotline_id: null\`—the previous step couldn't assign them. For each:
-
-- Event belongs to an existing plotline (assignment error) → REASSIGN
-- Multiple orphaned events form a pattern (one hero, one goal) → CREATE a new plotline
-
-### Step 6: Check format consistency
-
-The plotline structure should match the format:
-
-- **Procedural**: exactly one case_of_the_week plotline. Max 5 total.
-- **Hybrid**: one case_of_the_week + the rest serialized. Max 5 total.
-- **Serial**: max 5 plotlines. Runners must span 3+ episodes.
-- **Ensemble**: max 8 plotlines. Runners must span 3+ episodes.
-
-If the structure doesn't match—either the format was determined incorrectly, or the plotlines need adjustment.
-
-### Step 7: Assign ranks
-
-Each plotline has a \`computed_rank\` assigned by code from event counts. Review it. For each plotline, assign your own rank (A, B, C, or null for runners) based on narrative importance — what the show is about, not how many events a plotline has.
-
-Return your ranks in the \`ranks\` field — a mapping of plotline ID to rank.
-
-# RULES
-
-1. **If everything is fine—empty \`verdicts\` array.** Don't invent problems.
-2. **Each verdict must be justified by theory** (Story DNA, format, arc) or data (span, diagnostics).
-3. **REASSIGN references the exact event text** from input data. Do not rephrase.
-4. **MERGE: source events are automatically moved to target.** No need to list each one.
-5. **DROP: must specify where to move ALL events.** Code rejects DROP if any event remains unredistributed. Events are never removed or set to null.
-6. **CREATE: must specify complete Story DNA** (hero, goal, obstacle, stakes) and which events belong to it.
-7. **REFUNCTION: specify event text, episode, old function, new function.**
-8. **Don't flag inferred plotlines** for missing functions or low event count—incomplete structure is expected for them. Flag solid plotlines with incomplete structure.
-9. **DROP only phantoms.** DROP a plotline only if it has no events and doesn't exist in the series. A weak plotline in a bad script—that's data, not an error.
-
-# OUTPUT
-
-Think through each verdict before writing the JSON. Each verdict must be justified by data or theory — your review is checked by a human.
-
-Response—strictly JSON, no markdown wrapping, no comments outside JSON.
-
-\`\`\`json
-{
-  "verdicts": [
-    {
-      "action": "MERGE",
-      "source": "plotline_x",
-      "target": "plotline_y",
-      "reason": "one sentence—why"
-    },
-    {
-      "action": "REASSIGN",
-      "event": "exact event text",
-      "episode": "S01E06",
-      "from": null,
-      "to": "plotline_z",
-      "reason": "one sentence"
-    },
-    {
-      "action": "CREATE",
-      "plotline": {
-        "id": "new_plotline_id",
-        "name": "Hero: Theme",
-        "hero": "cast_id",
-        "goal": "...",
-        "obstacle": "...",
-        "stakes": "...",
-        "type": "serialized",
-        "nature": "character-led"
-      },
-      "reassign_events": [
-        {"event": "exact event text", "episode": "S01E03"},
-        {"event": "exact event text", "episode": "S01E06"}
-      ],
-      "reason": "one sentence"
-    },
-    {
-      "action": "DROP",
-      "target": "plotline_id",
-      "redistribute": [
-        {"event": "exact event text", "episode": "S01E02", "to": "other_plotline_id"}
-      ],
-      "reason": "one sentence"
-    },
-    {
-      "action": "REFUNCTION",
-      "event": "exact event text",
-      "episode": "S01E05",
-      "old_function": "escalation",
-      "new_function": "crisis",
-      "reason": "one sentence"
-    }
-  ],
-  "ranks": {
-    "empire": "A",
-    "family": "B",
-    "investigation": "C"
-  },
-  "notes": "brief comment on the quality of the original analysis (1–2 sentences)"
-}
-\`\`\`
-
-### Verdict Types
-
-| action | required fields |
-|--------|-----------------|
-| \`MERGE\` | \`source\`, \`target\`, \`reason\` |
-| \`REASSIGN\` | \`event\`, \`episode\`, \`from\`, \`to\`, \`reason\` |
-| \`CREATE\` | \`plotline\`, \`reassign_events\`, \`reason\` |
-| \`DROP\` | \`target\`, \`redistribute\`, \`reason\` |
-| \`REFUNCTION\` | \`event\`, \`episode\`, \`old_function\`, \`new_function\`, \`reason\` |
-
-# VALIDATION
-
-Code will check:
-- JSON schema: all required fields for each verdict type
-- \`target\`/\`source\` reference existing plotline ids
-- \`to\` in REASSIGN references an existing id (or an id from CREATE in the same verdict set)
-- \`event\` in REASSIGN/DROP/CREATE/REFUNCTION exactly matches event text in input data
-- \`new_function\`—valid function enum
-- \`plotline\` in CREATE contains all required fields
-
-Code cannot check: whether your verdicts improve the analysis, whether merges are justified, whether refunctions are correct—that's your job.`;
-
-const _PROMPT_PASS4 = `# ROLE
-You are a story editor looking at the complete season. All events have been identified and assigned to plotlines. Your job is to determine each event's role in the plotline's season-long arc.
-
-# CONTEXT
-
-You receive: show title, season, plotlines with Story DNA, and all events grouped by plotline in episode order. Each event already has a \`function\` — its role within its episode. You assign \`plot_fn\` — its role in the season arc.
-
-# GLOSSARY
-
-${_GLOSSARY}
-
-# TASK
-
-For each plotline, read its events in episode order. Assign \`plot_fn\` to every event — what role does this event play in the plotline's arc across the entire season?
-
-The episode's arc function may differ from the episode function. An event that was the climax of episode 3 might be an escalation in the season arc — the plotline is still building at that point.
-
-\`inciting_incident\` occurs once per plotline across the season — the event that sets the plotline in motion.
-
-Assign \`plot_fn\` to EVERY event. Do not skip any.
-
-# OUTPUT
-
-Think through the arc of each plotline before writing. You are assigning functions to a season-long story — consider where each event falls in the beginning, middle, and end of that story. Your assignments are reviewed by a human.
-
-Response — strictly JSON, no markdown wrapping.
-
-\`\`\`json
-{
-  "arc_functions": [
-    {"plotline": "empire", "episode": "S01E01", "event": "exact event text from input", "plot_fn": "setup"},
-    {"plotline": "empire", "episode": "S01E01", "event": "exact event text from input", "plot_fn": "inciting_incident"},
-    {"plotline": "empire", "episode": "S01E02", "event": "exact event text from input", "plot_fn": "escalation"}
-  ]
-}
-\`\`\`
-
-One entry per event. Use exact event text from the input — do not rephrase. Include the plotline ID so code can match events correctly.
-
-# VALIDATION
-
-Code will check:
-- Every event from the input has a corresponding entry in arc_functions
-- Each \`plot_fn\` is a valid function: setup, inciting_incident, escalation, turning_point, crisis, climax, resolution
-- Each \`event\` text exactly matches an event from the input
-- Each \`plotline\` references an existing plotline ID`;
 
 // --- Post-processing helpers (simplified browser versions) ---
 
@@ -1578,3 +777,341 @@ function _confirmSynopses(show, season, synopses) {
     });
   });
 }
+
+// ══════════════════════════════════════════════════════════════════
+// Narratology pipeline — mirrors src/tvplotlines/narratology.py.
+// Result shape is hollywood-compatible: actant fields are mapped onto
+// hero/goal/obstacle/stakes so the grid + analytics render unchanged.
+// ══════════════════════════════════════════════════════════════════
+
+const _VALID_FUNCTIONS_NAR = new Set([
+  'setup', 'inciting_incident', 'escalation', 'turning_point',
+  'crisis', 'climax', 'resolution', 'recognition',
+]);
+
+function _plotlinesSummaryForNar(plotlines) {
+  return plotlines.map(p => ({
+    id: p.id, name: p.name,
+    who_chases: p.hero, what_they_chase: p.goal,
+  }));
+}
+
+async function _runNarPass1Context(show, season, synopses, provider, apiKey) {
+  const payload = {
+    show, season,
+    sample_synopses: synopses.slice(0, 3).map(s => ({ episode: s.episode, text: s.text })),
+  };
+  const text = await callLLM(_PROMPTS.narratology.pass1_context, JSON.stringify(payload), provider, apiKey);
+  return _parseJSONResponse(text);
+}
+
+async function _runNarPass2Fabula(show, season, context, synopsis, provider, apiKey) {
+  const payload = {
+    show, season, episode: synopsis.episode,
+    context: { format: context.format, story_schema: context.story_engine, genre: context.genre },
+    synopsis: synopsis.text,
+  };
+  const text = await callLLM(_PROMPTS.narratology.pass2_fabula, JSON.stringify(payload), provider, apiKey);
+  return _parseJSONResponse(text);
+}
+
+async function _runNarPass3Actants(show, season, context, castIds, flatEvents, provider, apiKey) {
+  const payload = {
+    show, season,
+    context: {
+      format: context.format, story_schema: context.story_engine,
+      genre: context.genre, is_anthology: !!context.is_anthology,
+    },
+    cast: castIds.slice().sort(),
+    events: flatEvents,
+  };
+  const text = await callLLM(_PROMPTS.narratology.pass3_actants, JSON.stringify(payload), provider, apiKey);
+  return _parseJSONResponse(text);
+}
+
+async function _runNarPass4Story(show, season, context, plotlines, episode, events, provider, apiKey) {
+  const payload = {
+    show, season, episode,
+    context: { format: context.format, story_schema: context.story_engine },
+    plotlines: _plotlinesSummaryForNar(plotlines),
+    events,
+  };
+  const text = await callLLM(_PROMPTS.narratology.pass4_story, JSON.stringify(payload), provider, apiKey);
+  return _parseJSONResponse(text);
+}
+
+async function _runNarPass5Arc(show, season, plotline, events, provider, apiKey) {
+  const payload = {
+    show, season,
+    plotline: { id: plotline.id, name: plotline.name, who_chases: plotline.hero, what_they_chase: plotline.goal },
+    events,
+  };
+  const text = await callLLM(_PROMPTS.narratology.pass5_arc, JSON.stringify(payload), provider, apiKey);
+  return _parseJSONResponse(text);
+}
+
+async function _runNarPass6Review(show, season, context, plotlineSummary, eventsFlat, provider, apiKey) {
+  const payload = {
+    show, season,
+    context: { format: context.format, story_schema: context.story_engine },
+    plotlines: plotlineSummary,
+    events: eventsFlat,
+  };
+  const text = await callLLM(_PROMPTS.narratology.pass6_review, JSON.stringify(payload), provider, apiKey);
+  return _parseJSONResponse(text);
+}
+
+function _applyNarratologyVerdicts(verdicts, plotlines, episodes) {
+  const byId = new Map(plotlines.map(p => [p.id, p]));
+  const dropped = new Set();
+  for (const v of verdicts) {
+    const kind = v.kind;
+    if (kind === 'MERGE') {
+      const targets = v.targets || [];
+      if (targets.length < 2) continue;
+      const [keep, ...rest] = targets;
+      for (const other of rest) {
+        if (other === keep || !byId.has(other)) continue;
+        for (const ep of episodes) for (const ev of ep.events) {
+          if (ev.plotline_id === other) ev.plotline_id = keep;
+        }
+        dropped.add(other);
+      }
+    } else if (kind === 'DROP') {
+      for (const t of (v.targets || [])) {
+        for (const ep of episodes) for (const ev of ep.events) {
+          if (ev.plotline_id === t) ev.plotline_id = null;
+        }
+        dropped.add(t);
+      }
+    } else if (kind === 'REASSIGN') {
+      const eid = v.event_id || '';
+      if (!eid.includes('#')) continue;
+      const [targetEp, idxStr] = eid.split('#');
+      const idx = parseInt(idxStr, 10) - 1;
+      for (const ep of episodes) {
+        if (ep.episode !== targetEp) continue;
+        if (idx >= 0 && idx < ep.events.length && v.to_plotline) {
+          ep.events[idx].plotline_id = v.to_plotline;
+        }
+      }
+    } else if (kind === 'REFUNCTION') {
+      const eid = v.event_id || '';
+      if (!eid.includes('#') || !v.new_function) continue;
+      const [targetEp, idxStr] = eid.split('#');
+      const idx = parseInt(idxStr, 10) - 1;
+      for (const ep of episodes) {
+        if (ep.episode !== targetEp) continue;
+        if (idx >= 0 && idx < ep.events.length) ep.events[idx].function = v.new_function;
+      }
+    }
+  }
+  return plotlines.filter(p => !dropped.has(p.id));
+}
+
+async function runPipelineNarratology(synopses, seriesName, provider, apiKey, onProgress) {
+  const totalPasses = 6;
+  const season = parseInt(synopses[0].episode.slice(1, 3), 10);
+
+  // Pass 1 — context
+  onProgress('Pass 1/6: narratology context (breach, story schema)…', 1, totalPasses);
+  const p1 = await _runNarPass1Context(seriesName, season, synopses, provider, apiKey);
+  const context = {
+    format: p1.format,
+    story_engine: p1.breach
+      ? `${p1.story_schema} Breach: ${p1.breach}`
+      : p1.story_schema,
+    genre: p1.genre || '',
+    is_anthology: !!p1.is_anthology,
+  };
+  const protagonists = Array.isArray(p1.protagonists) ? p1.protagonists : [];
+
+  // Pass 2 — fabula (parallel per episode)
+  onProgress('Pass 2/6: fabula (events, cast)…', 2, totalPasses);
+  const p2Results = await Promise.all(
+    synopses.map(s => _runNarPass2Fabula(seriesName, season, context, s, provider, apiKey))
+  );
+  const eventsByEp = {};
+  const castIds = new Set();
+  for (let i = 0; i < synopses.length; i++) {
+    const ep = synopses[i].episode;
+    eventsByEp[ep] = (p2Results[i].events || []).map((e, idx) => ({
+      id: e.id || `${ep}#${String(idx + 1).padStart(2, '0')}`,
+      description: e.description,
+      characters: e.characters || [],
+    }));
+    for (const cid of (p2Results[i].cast_appearances || [])) castIds.add(cid);
+    for (const ev of eventsByEp[ep]) for (const cid of ev.characters) castIds.add(cid);
+  }
+
+  const cast = [];
+  const seenCast = new Set();
+  for (const cid of Array.from(castIds).sort()) {
+    if (cid.startsWith('guest:')) continue;
+    const name = cid.replace(/[_-]/g, ' ').replace(/\b\w/g, c => c.toUpperCase());
+    cast.push({ id: cid, name, aliases: [] });
+    seenCast.add(cid);
+  }
+  for (const prot of protagonists) {
+    const pid = prot.toLowerCase().replace(/\s+/g, '_');
+    if (!seenCast.has(pid)) cast.push({ id: pid, name: prot, aliases: [] });
+  }
+
+  // Pass 3 — actants
+  onProgress('Pass 3/6: actants (who chases what)…', 3, totalPasses);
+  const flatEvents = [];
+  for (const ep of Object.keys(eventsByEp)) {
+    for (const e of eventsByEp[ep]) flatEvents.push({ ...e, episode: ep });
+  }
+  const p3 = await _runNarPass3Actants(
+    seriesName, season, context, cast.map(c => c.id), flatEvents, provider, apiKey,
+  );
+  const plotlines = (p3.plotlines || []).map(p => {
+    const stands = p.stands_in_the_way || [];
+    const obstacle = stands.length ? stands.join(', ') : (p.bigger_force || '');
+    const winner = p.who_wins_if_it_works || p.who_chases || '';
+    return {
+      id: p.id, name: p.name,
+      hero: p.who_chases || '',
+      goal: p.what_they_chase || '',
+      obstacle,
+      stakes: `If wins: ${winner}`,
+      type: p.type || 'serialized',
+      nature: p.nature || 'character-led',
+      confidence: p.confidence || 'partial',
+      span: [], computed_rank: null, reviewed_rank: null, rank: null,
+    };
+  });
+
+  // Pass 4 — story (parallel per episode)
+  onProgress('Pass 4/6: story functions per episode…', 4, totalPasses);
+  const sortedEps = Object.keys(eventsByEp).sort();
+  const p4Results = await Promise.all(
+    sortedEps.map(ep => _runNarPass4Story(seriesName, season, context, plotlines, ep, eventsByEp[ep], provider, apiKey))
+  );
+  const episodes = [];
+  const eventsById = new Map();
+  for (const ep of sortedEps) for (const e of eventsByEp[ep]) eventsById.set(e.id, { ...e, episode: ep });
+
+  for (let i = 0; i < sortedEps.length; i++) {
+    const ep = sortedEps[i];
+    const data = p4Results[i];
+    const eventsOut = [];
+    for (const e of (data.events || [])) {
+      const src = eventsById.get(e.id);
+      if (!src) continue;
+      let fn = e.function || 'setup';
+      if (!_VALID_FUNCTIONS_NAR.has(fn)) fn = 'setup';
+      eventsOut.push({
+        event: src.description,
+        plotline_id: e.plotline_id || null,
+        function: fn,
+        characters: src.characters || [],
+        also_affects: (e.also_affects && e.also_affects.length) ? e.also_affects : null,
+        plot_fn: null,
+      });
+    }
+    const interactions = (data.interactions || []).map(it => ({
+      type: it.kind || 'thematic_rhyme',
+      lines: it.plotlines || [],
+      description: it.description || '',
+    }));
+    episodes.push({ episode: ep, theme: data.theme || '', events: eventsOut, interactions });
+  }
+
+  _computeSpan(plotlines, episodes);
+  _computeRanks(plotlines, episodes, context);
+
+  // Pass 5 — arc (parallel per plotline)
+  onProgress('Pass 5/6: season-level arc functions…', 5, totalPasses);
+  const plotEvents = new Map();
+  for (const ep of episodes) for (const ev of ep.events) {
+    if (!ev.plotline_id) continue;
+    if (!plotEvents.has(ev.plotline_id)) plotEvents.set(ev.plotline_id, []);
+    plotEvents.get(ev.plotline_id).push({ ep, ev });
+  }
+  const activePlotlines = plotlines.filter(p => plotEvents.has(p.id));
+  const p5Inputs = activePlotlines.map(p => {
+    const events = plotEvents.get(p.id).map(({ ep, ev }, i) => ({
+      id: `${ep.episode}#${String(i + 1).padStart(2, '0')}`,
+      episode: ep.episode,
+      description: ev.event,
+      function: ev.function,
+    }));
+    return { plotline: p, events };
+  });
+  const p5Results = await Promise.all(
+    p5Inputs.map(input => _runNarPass5Arc(seriesName, season, input.plotline, input.events, provider, apiKey))
+  );
+  for (let i = 0; i < activePlotlines.length; i++) {
+    const events = p5Results[i].events || [];
+    const refs = plotEvents.get(activePlotlines[i].id);
+    for (const item of events) {
+      if (!item.id || !item.id.includes('#')) continue;
+      const [, idxStr] = item.id.split('#');
+      const idx = parseInt(idxStr, 10) - 1;
+      if (idx < 0 || idx >= refs.length) continue;
+      const { ev } = refs[idx];
+      ev.plot_fn = (item.kind === 'texture') ? null : (item.arc_function || null);
+    }
+  }
+
+  // Pass 6 — review
+  onProgress('Pass 6/6: structural review + ranks…', 6, totalPasses);
+  const plotlineSummary = plotlines.map(p => ({
+    id: p.id, name: p.name,
+    who_chases: p.hero, what_they_chase: p.goal,
+    event_count: episodes.reduce((n, ep) => n + ep.events.filter(e => e.plotline_id === p.id).length, 0),
+  }));
+  const eventsFlat6 = [];
+  for (const ep of episodes) {
+    ep.events.forEach((ev, i) => {
+      eventsFlat6.push({
+        id: `${ep.episode}#${String(i + 1).padStart(2, '0')}`,
+        episode: ep.episode, description: ev.event,
+        plotline_id: ev.plotline_id, function: ev.function,
+        arc_function: ev.plot_fn,
+      });
+    });
+  }
+  const p6 = await _runNarPass6Review(seriesName, season, context, plotlineSummary, eventsFlat6, provider, apiKey);
+  const verdicts = p6.verdicts || [];
+  const keptPlotlines = _applyNarratologyVerdicts(verdicts, plotlines, episodes);
+  for (const r of (p6.ranks || [])) {
+    const pl = keptPlotlines.find(p => p.id === r.plotline_id);
+    if (pl && ['A', 'B', 'C'].includes(r.rank)) {
+      pl.reviewed_rank = r.rank;
+      pl.rank = r.rank;
+    }
+  }
+  _computeSpan(keptPlotlines, episodes);
+  _computeRanks(keptPlotlines, episodes, context);
+  for (const p of keptPlotlines) p.rank = p.reviewed_rank || p.computed_rank;
+
+  onProgress('Done!', totalPasses, totalPasses);
+
+  return {
+    context: {
+      series: seriesName,
+      season: `S${String(season).padStart(2, '0')}`,
+      format: context.format,
+      story_engine: context.story_engine,
+      genre: context.genre,
+      is_anthology: context.is_anthology,
+      system: 'narratology',
+    },
+    cast,
+    plotlines: keptPlotlines,
+    episodes,
+  };
+}
+
+// Dispatcher — picks between the two pipelines based on Store.getSystem().
+const _originalRunPipeline = runPipeline;
+runPipeline = function (synopses, seriesName, provider, apiKey, onProgress) {
+  const system = (typeof Store !== 'undefined' && Store.getSystem) ? Store.getSystem() : 'hollywood';
+  if (system === 'narratology') {
+    return runPipelineNarratology(synopses, seriesName, provider, apiKey, onProgress);
+  }
+  return _originalRunPipeline(synopses, seriesName, provider, apiKey, onProgress);
+};
diff --git a/src/tvplotlines/html/parts/shell.html b/src/tvplotlines/html/parts/shell.html
index 3fd5c21..e041503 100644
--- a/src/tvplotlines/html/parts/shell.html
+++ b/src/tvplotlines/html/parts/shell.html
@@ -101,7 +101,7 @@ <h1 class="welcome-title">tvplotlines</h1>
   <button onclick="_handleExport('txt')">TXT</button>
   <button onclick="_handleExport('csv')">CSV</button>
   <button onclick="_handleExport('fdx')">Final Draft (.fdx)</button>
-  <button onclick="_handleExport('pdf')">PDF (via print)</button>
+  <button onclick="_handleExport('pdf')">PDF</button>
 </div>
 
 <!-- Demo data (injected by build.py) -->
diff --git a/src/tvplotlines/narratology.py b/src/tvplotlines/narratology.py
new file mode 100644
index 0000000..05e35ae
--- /dev/null
+++ b/src/tvplotlines/narratology.py
@@ -0,0 +1,532 @@
+"""Narratology pipeline — six passes over a season's synopses.
+
+The output is mapped into the same ``TVPlotlinesResult`` shape hollywood
+uses so the HTML viewer renders either system without change.
+
+Mapping (narratology → TVPlotlinesResult):
+    Pass 1 context    → SeriesContext (story_engine ← story_schema;
+                                       breach and protagonists appended)
+    Pass 2 fabula     → events with stable ids (no plotline yet)
+    Pass 3 actants    → Plotline records (who_chases → hero,
+                                          what_they_chase → goal,
+                                          stands_in_the_way → obstacle,
+                                          who_wins_if_it_works → stakes)
+    Pass 4 story      → Event.plotline_id, Event.function,
+                        also_affects, per-episode interactions, theme
+    Pass 5 arc        → Event.plot_fn (arc_function). Texture events
+                        keep plot_fn = None (as they sit outside the arc).
+    Pass 6 review     → apply verdicts (MERGE/REASSIGN/REFUNCTION/DROP)
+                        and reviewed_rank.
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+import re
+from collections import defaultdict
+
+from tvplotlines.callbacks import PipelineCallback
+from tvplotlines.llm import LLMConfig, call_llm, call_llm_parallel
+from tvplotlines.models import (
+    CastMember,
+    EpisodeBreakdown,
+    Event,
+    Interaction,
+    Plotline,
+    SeriesContext,
+    TVPlotlinesResult,
+    Verdict,
+)
+from tvplotlines.postprocess import (
+    assign_orphan_events,
+    compute_ranks,
+    compute_span,
+)
+from tvplotlines.prompts import load_prompt
+
+logger = logging.getLogger(__name__)
+
+_EP_RE = re.compile(r"^S\d{2}E\d{2}$")
+_VALID_FORMATS = {"procedural", "serial", "hybrid", "ensemble"}
+_VALID_FUNCTIONS = {
+    "setup", "inciting_incident", "escalation", "turning_point",
+    "crisis", "climax", "resolution", "recognition",
+}
+
+
+def _fire(callback: PipelineCallback | None, method: str, *args) -> None:
+    if callback is None:
+        return
+    try:
+        getattr(callback, method)(*args)
+    except Exception:
+        logger.exception("Callback %s raised", method)
+
+
+# ── Pass 1: context ─────────────────────────────────────────────────
+
+def _pass1_context(
+    show: str, season: int, episodes: list[tuple[str, str]], config: LLMConfig,
+) -> tuple[SeriesContext, str, list[str]]:
+    sample = episodes[:3]
+    payload = {
+        "show": show,
+        "season": season,
+        "sample_synopses": [{"episode": e, "text": t} for e, t in sample],
+    }
+    system_prompt = load_prompt("pass1_context", system="narratology")
+
+    def _validate(d: dict) -> None:
+        if d.get("format") not in _VALID_FORMATS:
+            raise ValueError(f"format must be one of {_VALID_FORMATS}")
+        if not d.get("story_schema"):
+            raise ValueError("story_schema is required")
+
+    data = call_llm(
+        system_prompt, json.dumps(payload, ensure_ascii=False),
+        config, validator=_validate,
+    )
+    ctx = SeriesContext(
+        format=data["format"],
+        story_engine=data["story_schema"],
+        genre=data.get("genre", ""),
+        is_anthology=bool(data.get("is_anthology", False)),
+    )
+    return ctx, data.get("breach", ""), list(data.get("protagonists", []))
+
+
+# ── Pass 2: fabula (per episode, parallel) ──────────────────────────
+
+def _pass2_fabula(
+    show: str, season: int, context: SeriesContext,
+    episodes: list[tuple[str, str]], config: LLMConfig,
+) -> tuple[dict[str, list[dict]], set[str]]:
+    """Returns (events_by_episode, cast_appearances)."""
+    system_prompt = load_prompt("pass2_fabula", system="narratology")
+    ctx_for_llm = {
+        "format": context.format,
+        "story_schema": context.story_engine,
+        "genre": context.genre,
+    }
+    user_msgs = [
+        json.dumps({
+            "show": show, "season": season, "episode": ep,
+            "context": ctx_for_llm, "synopsis": text,
+        }, ensure_ascii=False)
+        for ep, text in episodes
+    ]
+
+    def _validate(d: dict) -> None:
+        if not isinstance(d.get("events"), list) or not d["events"]:
+            raise ValueError("events must be a non-empty list")
+        for e in d["events"]:
+            if not e.get("id") or not e.get("description"):
+                raise ValueError("each event needs id and description")
+
+    results = call_llm_parallel(
+        system_prompt, user_msgs, config, validators=[_validate] * len(user_msgs),
+    )
+
+    events_by_ep: dict[str, list[dict]] = {}
+    all_cast: set[str] = set()
+    for (ep, _), data in zip(episodes, results):
+        events_by_ep[ep] = data.get("events", [])
+        for cid in data.get("cast_appearances", []):
+            all_cast.add(cid)
+        for ev in events_by_ep[ep]:
+            for cid in ev.get("characters", []):
+                all_cast.add(cid)
+    return events_by_ep, all_cast
+
+
+# ── Pass 3: actants ─────────────────────────────────────────────────
+
+def _pass3_actants(
+    show: str, season: int, context: SeriesContext,
+    cast_ids: list[str], events_by_ep: dict[str, list[dict]],
+    config: LLMConfig,
+) -> list[Plotline]:
+    system_prompt = load_prompt("pass3_actants", system="narratology")
+    flat_events = [
+        {"id": e["id"], "episode": ep, "description": e["description"],
+         "characters": e.get("characters", [])}
+        for ep, evs in events_by_ep.items() for e in evs
+    ]
+    payload = {
+        "show": show, "season": season,
+        "context": {"format": context.format, "story_schema": context.story_engine,
+                    "genre": context.genre, "is_anthology": context.is_anthology},
+        "cast": sorted(cast_ids),
+        "events": flat_events,
+    }
+
+    def _validate(d: dict) -> None:
+        if not isinstance(d.get("plotlines"), list) or not d["plotlines"]:
+            raise ValueError("plotlines list required")
+
+    data = call_llm(
+        system_prompt, json.dumps(payload, ensure_ascii=False),
+        config, validator=_validate,
+    )
+
+    plotlines: list[Plotline] = []
+    for p in data["plotlines"]:
+        stands = p.get("stands_in_the_way") or []
+        obstacle = ", ".join(stands) if stands else (p.get("bigger_force") or "")
+        winner = p.get("who_wins_if_it_works") or p.get("who_chases", "")
+        plotlines.append(Plotline(
+            id=p["id"], name=p["name"],
+            hero=p.get("who_chases", ""),
+            goal=p.get("what_they_chase", ""),
+            obstacle=obstacle,
+            stakes=f"If wins: {winner}",
+            type=p.get("type", "serialized"),
+            nature=p.get("nature", "character-led"),
+            confidence=p.get("confidence", "partial"),
+        ))
+    return plotlines
+
+
+# ── Pass 4: story (per episode, parallel) ───────────────────────────
+
+def _pass4_story(
+    show: str, season: int, context: SeriesContext,
+    plotlines: list[Plotline], events_by_ep: dict[str, list[dict]],
+    config: LLMConfig,
+) -> list[EpisodeBreakdown]:
+    system_prompt = load_prompt("pass4_story", system="narratology")
+    plotline_brief = [
+        {"id": p.id, "name": p.name, "who_chases": p.hero,
+         "what_they_chase": p.goal}
+        for p in plotlines
+    ]
+    ctx_brief = {"format": context.format, "story_schema": context.story_engine}
+
+    eps_sorted = sorted(events_by_ep.keys())
+    user_msgs = [
+        json.dumps({
+            "show": show, "season": season, "episode": ep,
+            "context": ctx_brief, "plotlines": plotline_brief,
+            "events": events_by_ep[ep],
+        }, ensure_ascii=False)
+        for ep in eps_sorted
+    ]
+
+    def _validate(d: dict) -> None:
+        if not isinstance(d.get("events"), list):
+            raise ValueError("events list required")
+
+    results = call_llm_parallel(
+        system_prompt, user_msgs, config, validators=[_validate] * len(user_msgs),
+    )
+
+    # Index events by id for quick description lookup
+    all_ep_events: dict[str, dict] = {
+        e["id"]: e for ep in events_by_ep for e in events_by_ep[ep]
+    }
+
+    breakdowns: list[EpisodeBreakdown] = []
+    for ep, data in zip(eps_sorted, results):
+        events_out: list[Event] = []
+        for e in data["events"]:
+            src = all_ep_events.get(e["id"])
+            if src is None:
+                logger.warning("Pass 4 references unknown event id %s", e["id"])
+                continue
+            fn = e.get("function") or "setup"
+            if fn not in _VALID_FUNCTIONS and fn != "inciting_incident":
+                fn = "setup"
+            events_out.append(Event(
+                event=src["description"],
+                plotline_id=e.get("plotline_id"),
+                function=fn,
+                characters=src.get("characters", []),
+                also_affects=e.get("also_affects") or None,
+            ))
+
+        interactions = [
+            Interaction(
+                type=it.get("kind", "thematic_rhyme"),
+                lines=it.get("plotlines", []),
+                description=it.get("description", ""),
+            )
+            for it in data.get("interactions", [])
+        ]
+        breakdowns.append(EpisodeBreakdown(
+            episode=ep,
+            events=events_out,
+            theme=data.get("theme", ""),
+            interactions=interactions,
+        ))
+    return breakdowns
+
+
+# ── Pass 5: arc functions (per plotline, parallel) ──────────────────
+
+def _pass5_arc(
+    show: str, season: int, plotlines: list[Plotline],
+    breakdowns: list[EpisodeBreakdown], config: LLMConfig,
+) -> None:
+    """Mutates event.plot_fn in-place."""
+    system_prompt = load_prompt("pass5_arc", system="narratology")
+
+    # Build per-plotline event streams in episode order, referencing original events
+    plot_events: dict[str, list[tuple[EpisodeBreakdown, Event]]] = defaultdict(list)
+    for ep_b in breakdowns:
+        for ev in ep_b.events:
+            if ev.plotline_id:
+                plot_events[ev.plotline_id].append((ep_b, ev))
+
+    plotlines_with_events = [p for p in plotlines if plot_events.get(p.id)]
+    user_msgs = []
+    for p in plotlines_with_events:
+        events = [
+            {"id": f"{eb.episode}#{i+1:02d}",
+             "episode": eb.episode,
+             "description": ev.event,
+             "function": ev.function}
+            for i, (eb, ev) in enumerate(plot_events[p.id])
+        ]
+        user_msgs.append(json.dumps({
+            "show": show, "season": season,
+            "plotline": {"id": p.id, "name": p.name, "who_chases": p.hero,
+                         "what_they_chase": p.goal},
+            "events": events,
+        }, ensure_ascii=False))
+
+    def _validate(d: dict) -> None:
+        if not isinstance(d.get("events"), list):
+            raise ValueError("events list required")
+
+    results = call_llm_parallel(
+        system_prompt, user_msgs, config, validators=[_validate] * len(user_msgs),
+    )
+
+    # Stable (episode, description) → Event reverse lookup per plotline
+    for plotline, data in zip(plotlines_with_events, results):
+        # Build lookup from episode+description-prefix to event
+        by_ep_desc: dict[tuple[str, str], Event] = {}
+        for eb, ev in plot_events[plotline.id]:
+            by_ep_desc[(eb.episode, ev.event[:80])] = ev
+
+        for item in data["events"]:
+            arc_fn = item.get("arc_function")
+            kind = item.get("kind", "drive")
+            # Find original event — prefer explicit episode in item; fall back by id suffix
+            ep = None
+            if item.get("id") and "#" in item["id"]:
+                ep = item["id"].split("#", 1)[0]
+            ep = ep or item.get("episode")
+            desc = item.get("description", "")[:80]
+            ev = by_ep_desc.get((ep, desc)) if ep else None
+            if ev is None:
+                # Last-resort: match by position within plotline
+                continue
+            if kind == "texture":
+                ev.plot_fn = None
+            else:
+                ev.plot_fn = arc_fn
+
+
+# ── Pass 6: review ──────────────────────────────────────────────────
+
+def _pass6_review(
+    show: str, season: int, context: SeriesContext,
+    plotlines: list[Plotline], breakdowns: list[EpisodeBreakdown],
+    config: LLMConfig,
+) -> tuple[list[Verdict], dict[str, str]]:
+    system_prompt = load_prompt("pass6_review", system="narratology")
+    plotline_summary = [
+        {"id": p.id, "name": p.name, "who_chases": p.hero,
+         "what_they_chase": p.goal,
+         "event_count": sum(
+             1 for eb in breakdowns for ev in eb.events if ev.plotline_id == p.id
+         )}
+        for p in plotlines
+    ]
+    events_flat = [
+        {"id": f"{eb.episode}#{i+1:02d}",
+         "episode": eb.episode, "description": ev.event,
+         "plotline_id": ev.plotline_id, "function": ev.function,
+         "arc_function": ev.plot_fn}
+        for eb in breakdowns for i, ev in enumerate(eb.events)
+    ]
+
+    payload = {
+        "show": show, "season": season,
+        "context": {"format": context.format, "story_schema": context.story_engine},
+        "plotlines": plotline_summary, "events": events_flat,
+    }
+    data = call_llm(
+        system_prompt, json.dumps(payload, ensure_ascii=False), config,
+    )
+
+    verdicts = [
+        Verdict(action=v.get("kind", ""), data=v)
+        for v in data.get("verdicts", [])
+    ]
+    ranks = {r["plotline_id"]: r["rank"]
+             for r in data.get("ranks", []) if "plotline_id" in r and "rank" in r}
+    return verdicts, ranks
+
+
+def _apply_narratology_verdicts(
+    verdicts: list[Verdict], plotlines: list[Plotline],
+    breakdowns: list[EpisodeBreakdown],
+) -> list[Plotline]:
+    pl_by_id = {p.id: p for p in plotlines}
+    dropped: set[str] = set()
+    for v in verdicts:
+        d = v.data
+        kind = v.action
+        if kind == "MERGE":
+            targets = d.get("targets", [])
+            if len(targets) < 2:
+                continue
+            keep, *rest = targets
+            for other in rest:
+                if other in pl_by_id and other != keep:
+                    # Re-point events
+                    for eb in breakdowns:
+                        for ev in eb.events:
+                            if ev.plotline_id == other:
+                                ev.plotline_id = keep
+                    dropped.add(other)
+        elif kind == "DROP":
+            for t in d.get("targets", []):
+                # Orphan the events; postprocess will reassign
+                for eb in breakdowns:
+                    for ev in eb.events:
+                        if ev.plotline_id == t:
+                            ev.plotline_id = None
+                dropped.add(t)
+        elif kind == "REASSIGN":
+            eid = d.get("event_id") or ""
+            if "#" not in eid:
+                continue
+            target_ep, _ = eid.split("#", 1)
+            # Best-effort: match by episode + description if provided
+            desc = d.get("event_description", "")
+            to_pl = d.get("to_plotline")
+            for eb in breakdowns:
+                if eb.episode != target_ep:
+                    continue
+                for ev in eb.events:
+                    if not desc or ev.event.startswith(desc[:40]):
+                        ev.plotline_id = to_pl
+                        break
+        elif kind == "REFUNCTION":
+            eid = d.get("event_id") or ""
+            new_fn = d.get("new_function")
+            if "#" not in eid or not new_fn:
+                continue
+            target_ep, idx_str = eid.split("#", 1)
+            try:
+                idx = int(idx_str) - 1
+            except ValueError:
+                continue
+            for eb in breakdowns:
+                if eb.episode != target_ep:
+                    continue
+                if 0 <= idx < len(eb.events):
+                    eb.events[idx].function = new_fn
+
+    kept = [p for p in plotlines if p.id not in dropped]
+    return kept
+
+
+# ── Orchestrator ────────────────────────────────────────────────────
+
+def run_narratology(
+    show: str, season: int, episodes: dict[str, str],
+    *,
+    config: LLMConfig | None = None,
+    callback: PipelineCallback | None = None,
+    skip_review: bool = False,
+) -> TVPlotlinesResult:
+    """Run the six-pass narratology pipeline and return a hollywood-shape result.
+
+    Args mirror ``pipeline.get_plotlines`` in spirit — no prior-season
+    continuity and no resume flags in this first cut.
+    """
+    if config is None:
+        config = LLMConfig(system="narratology")
+
+    # Validate episode ids / season
+    season_prefix = f"S{season:02d}"
+    for k in episodes:
+        if not _EP_RE.match(k) or not k.startswith(season_prefix):
+            raise ValueError(f"bad episode key {k!r}")
+    episode_pairs = sorted(episodes.items())
+
+    _fire(callback, "pipeline_started", len(episode_pairs))
+
+    # Pass 1 — context
+    _fire(callback, "pass_started", 1, "narratology: context")
+    context, breach, protagonists = _pass1_context(show, season, episode_pairs, config)
+    if breach:
+        # Surface the breach in story_engine so viewer shows it
+        context.story_engine = f"{context.story_engine} Breach: {breach}"
+    _fire(callback, "pass_completed", 1, context)
+
+    # Pass 2 — fabula (per episode, parallel)
+    _fire(callback, "pass_started", 2, f"narratology: fabula × {len(episode_pairs)}")
+    events_by_ep, cast_ids = _pass2_fabula(show, season, context, episode_pairs, config)
+    _fire(callback, "pass_completed", 2, sum(len(v) for v in events_by_ep.values()))
+
+    cast: list[CastMember] = []
+    for cid in sorted(cast_ids):
+        if cid.startswith("guest:"):
+            continue
+        name = cid.replace("_", " ").replace("-", " ").title()
+        cast.append(CastMember(id=cid, name=name))
+    # Ensure protagonists surface even if missing from cast_appearances
+    for prot in protagonists:
+        prot_id = prot.lower().replace(" ", "_")
+        if not any(c.id == prot_id for c in cast):
+            cast.append(CastMember(id=prot_id, name=prot))
+
+    # Pass 3 — actants (one call, all events)
+    _fire(callback, "pass_started", 3, "narratology: actants")
+    plotlines = _pass3_actants(
+        show, season, context, [c.id for c in cast], events_by_ep, config,
+    )
+    _fire(callback, "pass_completed", 3, plotlines)
+
+    # Pass 4 — story (per episode, parallel)
+    _fire(callback, "pass_started", 4, f"narratology: story × {len(episode_pairs)}")
+    breakdowns = _pass4_story(show, season, context, plotlines, events_by_ep, config)
+    _fire(callback, "pass_completed", 4, breakdowns)
+
+    # Post-processing: compute span + ranks so Pass 5 / Pass 6 see current state
+    compute_span(plotlines, breakdowns)
+    compute_ranks(plotlines, breakdowns, context)
+
+    # Pass 5 — arc functions (per plotline, parallel)
+    _fire(callback, "pass_started", 5, f"narratology: arc × {len(plotlines)}")
+    _pass5_arc(show, season, plotlines, breakdowns, config)
+    _fire(callback, "pass_completed", 5, None)
+
+    # Pass 6 — review
+    if not skip_review:
+        _fire(callback, "pass_started", 6, "narratology: review")
+        verdicts, ranks = _pass6_review(
+            show, season, context, plotlines, breakdowns, config,
+        )
+        plotlines = _apply_narratology_verdicts(verdicts, plotlines, breakdowns)
+        for p in plotlines:
+            if p.id in ranks and ranks[p.id] in {"A", "B", "C"}:
+                p.reviewed_rank = ranks[p.id]
+        # Recompute span after verdicts
+        compute_span(plotlines, breakdowns)
+        compute_ranks(plotlines, breakdowns, context)
+        _fire(callback, "pass_completed", 6, verdicts)
+
+    # Orphan cleanup
+    assign_orphan_events(plotlines, breakdowns)
+
+    _fire(callback, "pipeline_completed", None)
+    return TVPlotlinesResult(
+        context=context, cast=cast, plotlines=plotlines, episodes=breakdowns,
+    )
diff --git a/src/tvplotlines/pipeline.py b/src/tvplotlines/pipeline.py
index 6b079d3..9960592 100644
--- a/src/tvplotlines/pipeline.py
+++ b/src/tvplotlines/pipeline.py
@@ -98,10 +98,13 @@ def get_plotlines(
         TVPlotlinesResult with context, cast, plotlines, and episode breakdowns.
     """
     if system == "narratology":
-        raise NotImplementedError(
-            "Narratology pipeline is not yet runnable — prompts are in place at "
-            "src/tvplotlines/prompts/narratology/ and will be wired in v2. "
-            "Use system='hollywood' for now."
+        from tvplotlines.narratology import run_narratology
+        nconfig = LLMConfig(
+            provider=llm_provider, model=model, base_url=base_url, system=system,
+        )
+        return run_narratology(
+            show=show, season=season, episodes=episodes,
+            config=nconfig, callback=callback, skip_review=skip_review,
         )
     config = LLMConfig(provider=llm_provider, model=model, base_url=base_url, system=system)
 

From 1ccd8498a57c2930e369892586aa0fe91fe9fecd Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Wed, 15 Apr 2026 11:40:02 +0200
Subject: [PATCH 17/24] chore(repo): pull internal docs back to 3-resources,
 rewrite README
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- docs/knowledge/ — moved to 3-resources/tvplotlines/. Knowledge,
  evergreens, autoresearch drafts, and strategy notes belong out of the
  public repo. Personal artifacts already lived there
- docs/viewer/{spec,plan,decisions}.md — internal Russian planning docs,
  moved to 3-resources/tvplotlines/viewer-planning/
- .gitignore — exclude Untitled.md draft and the dacomply compliance/
  scan output so they can sit in the working tree without leaking
- README — rewrite to reflect the current code: hollywood + narratology
  systems with the --system flag, standalone HTML viewer mode, the
  "Analyze a series" entry flow, --html/--html-output, narratology's
  six-pass table, fixed the broken license badge and the dead
  prompts_en/glossary.md link

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .gitignore                                    |    4 +
 README.md                                     |   81 +-
 docs/knowledge/README.md                      |   22 -
 .../autoresearch-experiment-log.md            |  217 -
 .../autoresearch/autoresearch-program-v2.md   |  231 -
 .../autoresearch/autoresearch-program.md      |  142 -
 .../autoresearch-prompt-experiment-ideas.md   |   54 -
 .../autoresearch/autoresearch-results-v2.tsv  |   15 -
 .../autoresearch/autoresearch-results.tsv     |   40 -
 .../autoresearch/autoresearch-run-v2.md       |   58 -
 .../autoresearch/autoresearch-summary-v2.md   |  111 -
 .../autoresearch-v3-brainstorm-notes.md       |  123 -
 .../autoresearch-v3-engineering-review.md     |  146 -
 .../autoresearch-v3-engineering.md            |   60 -
 .../autoresearch-v3-event-functions.md        |  206 -
 .../autoresearch-v3-hybrid-vs-procedural.md   |   22 -
 .../autoresearch/autoresearch-v3-plan.md      |  165 -
 .../autoresearch/autoresearch-v3-questions.md |  146 -
 .../autoresearch-v3-reading-plan.md           |  169 -
 .../autoresearch/autoresearch-v3-todo.md      |  101 -
 ...26-03-16-prior-season-continuity-design.md |  145 -
 .../2026-03-16-prior-season-continuity.md     |  651 ---
 .../plans/autoresearcher-competence-idea.md   |   44 -
 .../archive/plans/awesome-shortlist.bib       |  152 -
 .../archive/plans/bibliography-cleanup.md     |   72 -
 ...bibliography-narrative-and-autoresearch.md |  136 -
 .../archive/plans/blog-post-guide.md          |   79 -
 docs/knowledge/archive/plans/career-plan.md   |   36 -
 .../archive/plans/design-decisions.md         |  467 --
 .../archive/plans/docs-audit-2026-03-26.md    |  506 ---
 .../archive/plans/execution-order.md          |  210 -
 .../archive/plans/experiment-arc-functions.md |  123 -
 .../plans/experiment-ru-vs-en-prompts.md      |   22 -
 .../plans/local-model-training-plan.md        |   93 -
 .../knowledge/archive/plans/metrics-survey.md |  154 -
 .../archive/plans/next-session-plan.md        |   67 -
 .../plans/notes-for-3rd-autoresearch.md       |   76 -
 docs/knowledge/archive/plans/one-page.md      |   67 -
 .../plans/open-source-release-checklist.md    |   65 -
 .../archive/plans/open-source-strategy.md     |   48 -
 .../archive/plans/plan-restructure.md         |  479 --
 .../archive/plans/preprint-citations-map.md   |  228 -
 .../plans/preprint-experiment-scaffold.md     |   87 -
 .../archive/plans/publication-plan.md         |   97 -
 docs/knowledge/archive/plans/readme-draft.md  |  185 -
 .../archive/plans/resources-migration-plan.md |  759 ----
 .../plans/resources-restructure-design.md     |  188 -
 .../archive/plans/stability-benchmark.md      |  116 -
 .../plans/synthetic-audience-testing.md       |   37 -
 docs/knowledge/archive/plans/tasks-todo.md    |  284 --
 .../knowledge/archive/plans/what-to-change.md |   35 -
 .../archive/plans/write-synopses-plan.md      |  207 -
 .../decision-001-context-before-extraction.md |   45 -
 .../decision-002-no-internal-state.md         |   40 -
 .../decision-003-abc-classification.md        |   37 -
 .../decision-004-no-language-parameter.md     |   37 -
 ...decision-005-pass3-narratologist-review.md |  150 -
 docs/knowledge/prompting/how-to-prompt.md     |   11 -
 docs/knowledge/prompting/prompt-template.md   |   98 -
 .../prompting/prompt-writing-rules.md         |   38 -
 docs/knowledge/results/bb-s01-result.json     | 1813 --------
 docs/knowledge/results/bb-s02-result.json     | 3194 -------------
 docs/knowledge/results/bb-s03-result.json     | 3249 -------------
 docs/knowledge/results/bb-s04-result.json     | 3407 --------------
 docs/knowledge/results/bb-s05-result.json     | 4017 -----------------
 docs/knowledge/results/breakdown-gdr-s01.md   |  452 --
 docs/knowledge/results/breakdown-sp-s01.md    |  571 ---
 docs/knowledge/results/breakdown-td-s01.md    |  500 --
 docs/knowledge/results/run-bb-all-seasons.py  |  137 -
 docs/knowledge/specs/abstract.md              |   31 -
 docs/knowledge/specs/architecture.md          |  246 -
 .../specs/event-functions-redesign.md         |  252 --
 .../knowledge/specs/heuristics-from-theory.md |  106 -
 docs/knowledge/specs/input-parser-plan.md     |  199 -
 docs/knowledge/specs/inventory.md             |  143 -
 docs/knowledge/specs/mas4bw-library-audit.md  |  102 -
 docs/knowledge/specs/rank-refactor-spec.md    |  102 -
 .../specs/synopsis-authoring-protocol.md      |   65 -
 .../specs/two-function-dimensions.md          |   35 -
 docs/knowledge/specs/what-each-pass-does.md   |   15 -
 .../theory/enculturation-core-idea.md         |   25 -
 docs/knowledge/theory/glossary.md             |  238 -
 docs/knowledge/theory/naive-vs-plotter.md     |   53 -
 .../theory/narrative-intelligence-theory.md   |  206 -
 .../preprint-idea-meta-situation-model.md     |   33 -
 .../screenwriting-theory-reading-prompt.md    |  181 -
 docs/knowledge/v3_narratology/Untitled.md     |   55 -
 .../actant-model-has-six-roles-not-four.md    |   53 -
 ...ti-subject-signals-a-separate-storyline.md |   31 -
 ...emantic-labels-type-narrative-processes.md |   40 -
 ...petence-determines-when-subject-can-act.md |   26 -
 ...-structure-implies-two-actors-per-event.md |   19 -
 ...frontation-type-reveals-plotline-nature.md |   23 -
 .../events-are-transitions-between-states.md  |   19 -
 ...fabula-is-memory-trace-not-authors-plan.md |   18 -
 ...tuation-is-always-a-state-of-deficiency.md |   21 -
 ...cipation-describes-procedural-tv-pilots.md |   26 -
 ...rative-cycle-has-three-phases-not-seven.md |   63 -
 ...g-separates-fabula-time-from-story-time.md |   40 -
 .../suspense-has-four-types-not-one.md        |   29 -
 ...three-criteria-filter-functional-events.md |   33 -
 ...layer-model-separates-text-story-fabula.md |   25 -
 ...th-value-reveals-apparent-vs-real-roles.md |   29 -
 .../balestri-pescatore-2025-icaart.md         |   37 -
 .../balestri-pescatore-2025-memory.md         |   32 -
 .../bibliography-balestri-2025-memory.md      |   61 -
 .../bibliography-balestri-2025.md             |   48 -
 .../bibliography-hamilton-2025.md             |  101 -
 .../v3_narratology/bibliography-keith-2025.md |  117 -
 .../v3_narratology/bibliography-liu-2025.md   |  146 -
 .../films-present-while-novels-assert.md      |   38 -
 ...deep-structure-is-independent-of-medium.md |   29 -
 ...chauvel-2022-narrative-structure-survey.md |   38 -
 .../elkins-2022-shapes-of-stories.md          |   64 -
 .../hamilton-2025-narrabench.md               |   58 -
 ...anonical-script-makes-events-reportable.md |   31 -
 ...what-separates-narrative-from-chronicle.md |   36 -
 ...lements-of-narrative-operate-in-degrees.md |   35 -
 .../constituent-vs-supplementary-events.md    |   33 -
 .../fabula-as-events-plus-causal-matrix.md    |   47 -
 ...ration-transforms-fabula-into-discourse.md |   33 -
 ...arratology-fragmented-into-many-strands.md |   38 -
 ...th-2025-interactive-narrative-analytics.md |   41 -
 .../khan-2025-three-stage-analysis.md         |   32 -
 .../liu-2025-narrative-theory-survey.md       |   38 -
 .../mani-2025-narrative-generative-ai.md      |   38 -
 .../v3_narratology/moc-pipeline-ideas.md      |   57 -
 ...r-networks-model-plot-as-space-not-time.md |   22 -
 ...ins-structural-importance-of-characters.md |   21 -
 ...n-matter-but-are-hard-to-operationalize.md |   25 -
 ...-networks-manufacture-social-obligation.md |   22 -
 ...ti-networks-as-visualization-not-theory.md |   25 -
 .../network-regions-reveal-plot-subsystems.md |   19 -
 ...-law-distribution-in-character-networks.md |   22 -
 ...st-constrainted-by-relational-structure.md |   19 -
 ...ned-by-network-stability-not-centrality.md |   23 -
 ...val-experiments-reveal-structural-roles.md |   28 -
 ...metry-emerges-in-small-chapter-networks.md |   20 -
 .../weak-ties-connect-narrative-regions.md    |   21 -
 .../v3_narratology/narratological-canon.md    |   76 -
 ...icts-turning-points-not-absolute-values.md |   40 -
 ...rative-structure-maps-to-six-components.md |   37 -
 ...ortable-event-is-the-point-of-the-story.md |   30 -
 ...ibutes-and-relations-are-distinct-tasks.md |   28 -
 ...vents-scenes-plotlines-form-a-hierarchy.md |   44 -
 ...ch-universally-fits-narrative-structure.md |   33 -
 ...-elements-define-degrees-of-narrativity.md |   49 -
 ...antana-2022-narrative-extraction-survey.md |   39 -
 ...ence-is-richer-than-three-act-structure.md |   38 -
 ...ative-is-driven-by-knowledge-not-action.md |   44 -
 ...cal-gradation-organizes-event-sequences.md |   32 -
 ...ive-clauses-have-grammar-like-sentences.md |   37 -
 ...rinciples-succession-and-transformation.md |   34 -
 docs/viewer/decisions.md                      |   48 -
 docs/viewer/plan.md                           |  775 ----
 docs/viewer/spec.md                           |  154 -
 156 files changed, 73 insertions(+), 31366 deletions(-)
 delete mode 100644 docs/knowledge/README.md
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-experiment-log.md
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-program-v2.md
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-program.md
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-prompt-experiment-ideas.md
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-results-v2.tsv
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-results.tsv
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-run-v2.md
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-summary-v2.md
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-brainstorm-notes.md
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-engineering-review.md
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-engineering.md
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-event-functions.md
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-hybrid-vs-procedural.md
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-plan.md
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-questions.md
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-reading-plan.md
 delete mode 100644 docs/knowledge/archive/autoresearch/autoresearch-v3-todo.md
 delete mode 100644 docs/knowledge/archive/plans/2026-03-16-prior-season-continuity-design.md
 delete mode 100644 docs/knowledge/archive/plans/2026-03-16-prior-season-continuity.md
 delete mode 100644 docs/knowledge/archive/plans/autoresearcher-competence-idea.md
 delete mode 100644 docs/knowledge/archive/plans/awesome-shortlist.bib
 delete mode 100644 docs/knowledge/archive/plans/bibliography-cleanup.md
 delete mode 100644 docs/knowledge/archive/plans/bibliography-narrative-and-autoresearch.md
 delete mode 100644 docs/knowledge/archive/plans/blog-post-guide.md
 delete mode 100644 docs/knowledge/archive/plans/career-plan.md
 delete mode 100644 docs/knowledge/archive/plans/design-decisions.md
 delete mode 100644 docs/knowledge/archive/plans/docs-audit-2026-03-26.md
 delete mode 100644 docs/knowledge/archive/plans/execution-order.md
 delete mode 100644 docs/knowledge/archive/plans/experiment-arc-functions.md
 delete mode 100644 docs/knowledge/archive/plans/experiment-ru-vs-en-prompts.md
 delete mode 100644 docs/knowledge/archive/plans/local-model-training-plan.md
 delete mode 100644 docs/knowledge/archive/plans/metrics-survey.md
 delete mode 100644 docs/knowledge/archive/plans/next-session-plan.md
 delete mode 100644 docs/knowledge/archive/plans/notes-for-3rd-autoresearch.md
 delete mode 100644 docs/knowledge/archive/plans/one-page.md
 delete mode 100644 docs/knowledge/archive/plans/open-source-release-checklist.md
 delete mode 100644 docs/knowledge/archive/plans/open-source-strategy.md
 delete mode 100644 docs/knowledge/archive/plans/plan-restructure.md
 delete mode 100644 docs/knowledge/archive/plans/preprint-citations-map.md
 delete mode 100644 docs/knowledge/archive/plans/preprint-experiment-scaffold.md
 delete mode 100644 docs/knowledge/archive/plans/publication-plan.md
 delete mode 100644 docs/knowledge/archive/plans/readme-draft.md
 delete mode 100644 docs/knowledge/archive/plans/resources-migration-plan.md
 delete mode 100644 docs/knowledge/archive/plans/resources-restructure-design.md
 delete mode 100644 docs/knowledge/archive/plans/stability-benchmark.md
 delete mode 100644 docs/knowledge/archive/plans/synthetic-audience-testing.md
 delete mode 100644 docs/knowledge/archive/plans/tasks-todo.md
 delete mode 100644 docs/knowledge/archive/plans/what-to-change.md
 delete mode 100644 docs/knowledge/archive/plans/write-synopses-plan.md
 delete mode 100644 docs/knowledge/decisions/decision-001-context-before-extraction.md
 delete mode 100644 docs/knowledge/decisions/decision-002-no-internal-state.md
 delete mode 100644 docs/knowledge/decisions/decision-003-abc-classification.md
 delete mode 100644 docs/knowledge/decisions/decision-004-no-language-parameter.md
 delete mode 100644 docs/knowledge/decisions/decision-005-pass3-narratologist-review.md
 delete mode 100644 docs/knowledge/prompting/how-to-prompt.md
 delete mode 100644 docs/knowledge/prompting/prompt-template.md
 delete mode 100644 docs/knowledge/prompting/prompt-writing-rules.md
 delete mode 100644 docs/knowledge/results/bb-s01-result.json
 delete mode 100644 docs/knowledge/results/bb-s02-result.json
 delete mode 100644 docs/knowledge/results/bb-s03-result.json
 delete mode 100644 docs/knowledge/results/bb-s04-result.json
 delete mode 100644 docs/knowledge/results/bb-s05-result.json
 delete mode 100644 docs/knowledge/results/breakdown-gdr-s01.md
 delete mode 100644 docs/knowledge/results/breakdown-sp-s01.md
 delete mode 100644 docs/knowledge/results/breakdown-td-s01.md
 delete mode 100644 docs/knowledge/results/run-bb-all-seasons.py
 delete mode 100644 docs/knowledge/specs/abstract.md
 delete mode 100644 docs/knowledge/specs/architecture.md
 delete mode 100644 docs/knowledge/specs/event-functions-redesign.md
 delete mode 100644 docs/knowledge/specs/heuristics-from-theory.md
 delete mode 100644 docs/knowledge/specs/input-parser-plan.md
 delete mode 100644 docs/knowledge/specs/inventory.md
 delete mode 100644 docs/knowledge/specs/mas4bw-library-audit.md
 delete mode 100644 docs/knowledge/specs/rank-refactor-spec.md
 delete mode 100644 docs/knowledge/specs/synopsis-authoring-protocol.md
 delete mode 100644 docs/knowledge/specs/two-function-dimensions.md
 delete mode 100644 docs/knowledge/specs/what-each-pass-does.md
 delete mode 100644 docs/knowledge/theory/enculturation-core-idea.md
 delete mode 100644 docs/knowledge/theory/glossary.md
 delete mode 100644 docs/knowledge/theory/naive-vs-plotter.md
 delete mode 100644 docs/knowledge/theory/narrative-intelligence-theory.md
 delete mode 100644 docs/knowledge/theory/preprint-idea-meta-situation-model.md
 delete mode 100644 docs/knowledge/theory/screenwriting-theory-reading-prompt.md
 delete mode 100644 docs/knowledge/v3_narratology/Untitled.md
 delete mode 100644 docs/knowledge/v3_narratology/bal1988/actant-model-has-six-roles-not-four.md
 delete mode 100644 docs/knowledge/v3_narratology/bal1988/anti-subject-signals-a-separate-storyline.md
 delete mode 100644 docs/knowledge/v3_narratology/bal1988/bremond-semantic-labels-type-narrative-processes.md
 delete mode 100644 docs/knowledge/v3_narratology/bal1988/competence-determines-when-subject-can-act.md
 delete mode 100644 docs/knowledge/v3_narratology/bal1988/confrontation-structure-implies-two-actors-per-event.md
 delete mode 100644 docs/knowledge/v3_narratology/bal1988/confrontation-type-reveals-plotline-nature.md
 delete mode 100644 docs/knowledge/v3_narratology/bal1988/events-are-transitions-between-states.md
 delete mode 100644 docs/knowledge/v3_narratology/bal1988/fabula-is-memory-trace-not-authors-plan.md
 delete mode 100644 docs/knowledge/v3_narratology/bal1988/initial-situation-is-always-a-state-of-deficiency.md
 delete mode 100644 docs/knowledge/v3_narratology/bal1988/iterative-anticipation-describes-procedural-tv-pilots.md
 delete mode 100644 docs/knowledge/v3_narratology/bal1988/narrative-cycle-has-three-phases-not-seven.md
 delete mode 100644 docs/knowledge/v3_narratology/bal1988/sequential-ordering-separates-fabula-time-from-story-time.md
 delete mode 100644 docs/knowledge/v3_narratology/bal1988/suspense-has-four-types-not-one.md
 delete mode 100644 docs/knowledge/v3_narratology/bal1988/three-criteria-filter-functional-events.md
 delete mode 100644 docs/knowledge/v3_narratology/bal1988/three-layer-model-separates-text-story-fabula.md
 delete mode 100644 docs/knowledge/v3_narratology/bal1988/truth-value-reveals-apparent-vs-real-roles.md
 delete mode 100644 docs/knowledge/v3_narratology/balestri-pescatore-2025-icaart.md
 delete mode 100644 docs/knowledge/v3_narratology/balestri-pescatore-2025-memory.md
 delete mode 100644 docs/knowledge/v3_narratology/bibliography-balestri-2025-memory.md
 delete mode 100644 docs/knowledge/v3_narratology/bibliography-balestri-2025.md
 delete mode 100644 docs/knowledge/v3_narratology/bibliography-hamilton-2025.md
 delete mode 100644 docs/knowledge/v3_narratology/bibliography-keith-2025.md
 delete mode 100644 docs/knowledge/v3_narratology/bibliography-liu-2025.md
 delete mode 100644 docs/knowledge/v3_narratology/chatman1980/films-present-while-novels-assert.md
 delete mode 100644 docs/knowledge/v3_narratology/chatman1980/narrative-deep-structure-is-independent-of-medium.md
 delete mode 100644 docs/knowledge/v3_narratology/chauvel-2022-narrative-structure-survey.md
 delete mode 100644 docs/knowledge/v3_narratology/elkins-2022-shapes-of-stories.md
 delete mode 100644 docs/knowledge/v3_narratology/hamilton-2025-narrabench.md
 delete mode 100644 docs/knowledge/v3_narratology/herman2009/breach-of-canonical-script-makes-events-reportable.md
 delete mode 100644 docs/knowledge/v3_narratology/herman2009/experientiality-is-what-separates-narrative-from-chronicle.md
 delete mode 100644 docs/knowledge/v3_narratology/herman2009/four-elements-of-narrative-operate-in-degrees.md
 delete mode 100644 docs/knowledge/v3_narratology/huang-usbeck2024/constituent-vs-supplementary-events.md
 delete mode 100644 docs/knowledge/v3_narratology/huang-usbeck2024/fabula-as-events-plus-causal-matrix.md
 delete mode 100644 docs/knowledge/v3_narratology/huang-usbeck2024/narration-transforms-fabula-into-discourse.md
 delete mode 100644 docs/knowledge/v3_narratology/ionescu2019/postclassical-narratology-fragmented-into-many-strands.md
 delete mode 100644 docs/knowledge/v3_narratology/keith-2025-interactive-narrative-analytics.md
 delete mode 100644 docs/knowledge/v3_narratology/khan-2025-three-stage-analysis.md
 delete mode 100644 docs/knowledge/v3_narratology/liu-2025-narrative-theory-survey.md
 delete mode 100644 docs/knowledge/v3_narratology/mani-2025-narrative-generative-ai.md
 delete mode 100644 docs/knowledge/v3_narratology/moc-pipeline-ideas.md
 delete mode 100644 docs/knowledge/v3_narratology/moretti2011/character-networks-model-plot-as-space-not-time.md
 delete mode 100644 docs/knowledge/v3_narratology/moretti2011/clustering-explains-structural-importance-of-characters.md
 delete mode 100644 docs/knowledge/v3_narratology/moretti2011/edge-weight-and-direction-matter-but-are-hard-to-operationalize.md
 delete mode 100644 docs/knowledge/v3_narratology/moretti2011/guanxi-networks-manufacture-social-obligation.md
 delete mode 100644 docs/knowledge/v3_narratology/moretti2011/moretti-networks-as-visualization-not-theory.md
 delete mode 100644 docs/knowledge/v3_narratology/moretti2011/network-regions-reveal-plot-subsystems.md
 delete mode 100644 docs/knowledge/v3_narratology/moretti2011/power-law-distribution-in-character-networks.md
 delete mode 100644 docs/knowledge/v3_narratology/moretti2011/protagonist-constrainted-by-relational-structure.md
 delete mode 100644 docs/knowledge/v3_narratology/moretti2011/protagonist-defined-by-network-stability-not-centrality.md
 delete mode 100644 docs/knowledge/v3_narratology/moretti2011/removal-experiments-reveal-structural-roles.md
 delete mode 100644 docs/knowledge/v3_narratology/moretti2011/symmetry-emerges-in-small-chapter-networks.md
 delete mode 100644 docs/knowledge/v3_narratology/moretti2011/weak-ties-connect-narrative-regions.md
 delete mode 100644 docs/knowledge/v3_narratology/narratological-canon.md
 delete mode 100644 docs/knowledge/v3_narratology/ouyang-mckeown2015/change-in-metrics-predicts-turning-points-not-absolute-values.md
 delete mode 100644 docs/knowledge/v3_narratology/ouyang-mckeown2015/labov-narrative-structure-maps-to-six-components.md
 delete mode 100644 docs/knowledge/v3_narratology/ouyang-mckeown2015/most-reportable-event-is-the-point-of-the-story.md
 delete mode 100644 docs/knowledge/v3_narratology/piper-so-bamman2021/character-attributes-and-relations-are-distinct-tasks.md
 delete mode 100644 docs/knowledge/v3_narratology/piper-so-bamman2021/events-scenes-plotlines-form-a-hierarchy.md
 delete mode 100644 docs/knowledge/v3_narratology/piper-so-bamman2021/no-single-approach-universally-fits-narrative-structure.md
 delete mode 100644 docs/knowledge/v3_narratology/piper-so-bamman2021/ten-elements-define-degrees-of-narrativity.md
 delete mode 100644 docs/knowledge/v3_narratology/santana-2022-narrative-extraction-survey.md
 delete mode 100644 docs/knowledge/v3_narratology/todorov1971/five-part-sequence-is-richer-than-three-act-structure.md
 delete mode 100644 docs/knowledge/v3_narratology/todorov1971/gnoseological-narrative-is-driven-by-knowledge-not-action.md
 delete mode 100644 docs/knowledge/v3_narratology/todorov1971/ideological-gradation-organizes-event-sequences.md
 delete mode 100644 docs/knowledge/v3_narratology/todorov1971/narrative-clauses-have-grammar-like-sentences.md
 delete mode 100644 docs/knowledge/v3_narratology/todorov1971/two-principles-succession-and-transformation.md
 delete mode 100644 docs/viewer/decisions.md
 delete mode 100644 docs/viewer/plan.md
 delete mode 100644 docs/viewer/spec.md

diff --git a/.gitignore b/.gitignore
index 20a983e..a214dd4 100644
--- a/.gitignore
+++ b/.gitignore
@@ -57,3 +57,7 @@ runs/
 
 # Worktrees
 .worktrees/
+
+# Local drafts and one-off scratch (not for the public repo)
+Untitled.md
+compliance/
diff --git a/README.md b/README.md
index f2941a2..523ee8b 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,10 @@
 # tvplotlines
 
 [![PyPI](https://img.shields.io/pypi/v/tvplotlines?cacheSeconds=3600)](https://pypi.org/project/tvplotlines/)
-[![License](https://img.shields.io/github/license/BirdInTheTree/tvplotlines?cacheSeconds=3600)](LICENSE)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![Python](https://img.shields.io/pypi/pyversions/tvplotlines?cacheSeconds=3600)](https://pypi.org/project/tvplotlines/)
 
-Turn episode synopses into a writers' room corkboard — story engine, plotlines with their *story DNA* and *arcs* (see definitions in [glossary](src/tvplotlines/prompts_en/glossary.md)) — in one function call.
+Turn episode synopses into a writers' room corkboard — story engine, plotlines with their *story DNA* and *arcs* (see [glossary](src/tvplotlines/prompts/hollywood/glossary.md)) — in one function call.
 
 For TV researchers, screenwriters, and anyone building narrative analysis tools or a tv series.
 
@@ -18,7 +18,13 @@ For TV researchers, screenwriters, and anyone building narrative analysis tools
 
 A naive LLM prompt covers 5–12% of a season's source material. tvplotlines covers **78–91%** — by separating *what* the model looks for (narrative theory) from *how* it calculates the results (code).
 
-## Quick start
+## Two ways to use it
+
+**Library / CLI** — `pip install tvplotlines`, point it at synopsis files, get JSON.
+
+**Standalone HTML viewer** — one self-contained `.html` file that runs the whole pipeline in your browser. Type a show name, the viewer asks the LLM for synopses, runs the analysis, and renders the grid. No server, no dependencies — download the file and it works.
+
+## Quick start (CLI)
 
 ```bash
 pip install tvplotlines
@@ -39,17 +45,40 @@ tvplotlines write-synopses "Mad Men" --season 1
 tvplotlines run mad-men/
 ```
 
+Generate a standalone HTML viewer alongside the JSON:
+
+```bash
+tvplotlines run mad-men/ --html              # writes mad-men.json + mad-men.html
+tvplotlines run mad-men/ --html-output viewer.html
+```
+
 Multiple seasons are supported — plotline continuity is tracked across seasons (see [Python API](#python-api)).
 
 Pre-computed results are in [`examples/results/`](examples/results/) — explore the output without spending API credits.
 
+## Quick start (standalone viewer)
+
+```bash
+python -m tvplotlines.html.build --output tvplotlines.html
+open tvplotlines.html
+```
+
+Then in the browser:
+
+1. Click **LLM** in the toolbar, paste your Anthropic or OpenAI key, pick an analysis system.
+2. On the welcome screen, type a show name and season → click **Analyze**.
+3. The viewer asks the model for episode synopses, lets you preview/edit them, and runs the pipeline.
+4. Export the result as JSON, CSV, Final Draft (`.fdx`), or PDF.
+
+If the model doesn't know the show, drop your own `.txt` synopsis files via the **+ Load** button.
+
 ## What you get
 
 One JSON file per season. Each contains:
 
 - **Cast** — characters with aliases
 - **Plotlines** — with A/B/C ranking, Story DNA (hero, goal, obstacle, stakes), and episode span
-- **Events** — per-episode, assigned to plotlines with narrative function (setup → inciting incident → escalation → crisis → climax → resolution)
+- **Events** — per-episode, assigned to plotlines with episode-level function and season-level arc function
 
 <details>
 <summary>Example: Breaking Bad S01 (truncated)</summary>
@@ -85,6 +114,7 @@ One JSON file per season. Each contains:
           "event": "During the meth lab raid, Walt spots his former student Jesse escaping through a window",
           "plotline_id": "empire",
           "function": "inciting_incident",
+          "plot_fn": "inciting_incident",
           "characters": ["walt", "jesse"]
         }
       ]
@@ -97,9 +127,11 @@ One JSON file per season. Each contains:
 
 ## How it works
 
-### Plotline extraction (`tvplotlines run`)
+You pick an **analysis system** with `--system` (CLI) or the LLM Settings dialog (viewer). Both systems share the same input format and output the same `TVPlotlinesResult` shape, so the viewer renders either one.
+
+### Hollywood — screenwriting model (default)
 
-Five LLM passes, each with a specialized prompt:
+Story DNA — hero, goal, obstacle, stakes — and Freytag's seven dramatic functions. Five LLM passes:
 
 | Pass | Role | Output | Calls |
 |------|------|--------|-------|
@@ -111,15 +143,32 @@ Five LLM passes, each with a specialized prompt:
 
 Pass 1 runs 3× in parallel and picks the most common plotline set. Pass 3 sees the full picture no earlier pass had and corrects structural problems. Pass 4 assigns arc-level functions — an event that was a climax in episode 3 might be an escalation in the season-long arc.
 
+### Narratology — structuralist model
+
+Bal's three layers, Greimas's actant model (subject/object/helper/opponent/power/receiver), Bremond's narrative cycle, Labov's reportability. Six LLM passes:
+
+| Pass | Role | Output | Calls |
+|------|------|--------|-------|
+| **1 context** | Format, story schema, breach, protagonists | Show-level context | 1 |
+| **2 fabula** | Per-episode events as state transitions, with stable ids | Bare events + cast | 1 per episode |
+| **3 actants** | Plotlines via the actant model (anti-subject test) | Plotlines | 1 |
+| **4 story** | Per-event episode function and direction; theme | Story-level event tags | 1 per episode |
+| **5 arc** | Season arc function, drive vs texture, MRE per plotline | Season-level event tags | 1 per plotline |
+| **6 review** | Verdicts and ranks | Structural corrections | 1 |
+
+The actant fields (`who_chases`, `what_they_chase`, `stands_in_the_way`, `who_wins_if_it_works`) map onto the same `hero / goal / obstacle / stakes` slots, so existing tools that consume `TVPlotlinesResult` see no schema change.
+
+The schema document at [`docs/layered-schema.md`](docs/layered-schema.md) describes a richer `base + layers` JSON form for keeping multiple systems' analyses of the same season side by side.
+
 ### Synopsis generation (`write-synopses`)
 
 The `writer` extension collects raw episode data from online sources, then rewrites each episode into a full synopsis via LLM — ensuring every sentence is a beat (conflict or change), with explicit causality and character names.
 
-Tested with Claude Sonnet (default). OpenAI and Ollama supported for both pipelines. Ollama defaults to Qwen 2.5 14B — chosen to run on CPU without a GPU. Quality is noticeably lower than cloud models but works for experimentation.
+Tested with Claude Sonnet (default). OpenAI and Ollama supported for both pipelines and both analysis systems. Ollama defaults to Qwen 2.5 14B — chosen to run on CPU without a GPU. Quality is noticeably lower than cloud models but works for experimentation.
 
 ## Input format
 
-One `.txt` file per episode. Include `S01E01`, `S01E02`, etc. in the filename. Each file is a plain-text (.txt) synopsis — 150–500 words covering the main events.
+One `.txt` file per episode. Include `S01E01`, `S01E02`, etc. in the filename. Each file is a plain-text synopsis — 150–500 words covering the main events.
 
 ```
 breaking-bad/
@@ -141,6 +190,11 @@ from tvplotlines import get_plotlines
 
 s01 = get_plotlines("Breaking Bad", season=1, episodes=season_1_synopses)
 s02 = get_plotlines("Breaking Bad", season=2, episodes=season_2_synopses, prior=s01)
+
+# Or pick the analysis system explicitly
+result = get_plotlines(
+    "Mad Men", season=1, episodes=synopses, system="narratology",
+)
 ```
 
 Pass `prior` to track plotline continuity across seasons.
@@ -148,9 +202,10 @@ Pass `prior` to track plotline continuity across seasons.
 ## LLM providers
 
 ```bash
-tvplotlines run breaking-bad/                    # Anthropic (default)
-tvplotlines run breaking-bad/ --provider openai  # OpenAI
-tvplotlines run breaking-bad/ --provider ollama  # Ollama (local, free)
+tvplotlines run breaking-bad/                          # Anthropic (default)
+tvplotlines run breaking-bad/ --provider openai        # OpenAI
+tvplotlines run breaking-bad/ --provider ollama        # Ollama (local, free)
+tvplotlines run breaking-bad/ --system narratology     # narratology pipeline
 ```
 
 See [docs/api.md](docs/api.md) for full API reference.
@@ -158,10 +213,12 @@ See [docs/api.md](docs/api.md) for full API reference.
 ## Key concepts
 
 - **Plotline** — a narrative thread across episodes (e.g. "Walt: Empire")
-- **Story DNA** — hero, goal, obstacle, stakes
+- **Story DNA** — hero, goal, obstacle, stakes (hollywood) ↔ subject, object, opponent, receiver (narratology)
 - **A/B/C ranking** — plotline weight (A = main, B = secondary, C = tertiary, runner = minor thread)
 - **Format** — procedural (House), serial (Breaking Bad), hybrid (X-Files), ensemble (Game of Thrones)
 - **Story engine** — one sentence capturing the show's core dramatic mechanism
+- **Function** — episode-level role in a plotline arc (setup, inciting_incident, escalation, turning_point, crisis, climax, resolution; narratology adds `recognition`)
+- **Arc function** — season-level role of the same event
 
 ## Citation
 
diff --git a/docs/knowledge/README.md b/docs/knowledge/README.md
deleted file mode 100644
index 1fe6b6f..0000000
--- a/docs/knowledge/README.md
+++ /dev/null
@@ -1,22 +0,0 @@
-# Knowledge
-
-Reference material for the `tvplotlines` project, consolidated from
-`3-resources/tvplotlines/` on 2026-04-15.
-
-```
-decisions/        — ADRs 001–005, architecture decision records
-specs/            — architecture, inventory, per-pass specs, mas4bw audit
-theory/           — narrative-intelligence framing, glossary, reading prompts
-prompting/        — prompt-writing rules, template, how-to
-results/          — reference Breaking Bad S01–S05 pipeline outputs + breakdown notes
-v3_narratology/   — 67 evergreen notes across 9 sources (Bal, Todorov, Chatman,
-                    Herman, Ouyang & McKeown, Bremond, Greimas, Moretti,
-                    Ionescu, Liu, Mani, Hamilton, Keith) — the theoretical
-                    foundation behind `src/tvplotlines/prompts/narratology/`
-archive/
-  plans/          — old roadmaps, restructure notes, publication plans
-  autoresearch/   — autoresearch-v1/v2/v3 scaffolding and experiment logs
-```
-
-Personal artifacts (the book "Как украсть сериал" and the friends-post)
-intentionally stay in `3-resources/tvplotlines/`.
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-experiment-log.md b/docs/knowledge/archive/autoresearch/autoresearch-experiment-log.md
deleted file mode 100644
index 3641ca0..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-experiment-log.md
+++ /dev/null
@@ -1,217 +0,0 @@
----
-type: note
-project: tvplotlines
-status: active
----
-
-# Experiment Log
-
-## Experiment 1 (Exp 1): Stronger merge preference + serial 5-6
-**Hypothesis**: Adding "when in doubt, merge" to granularity and tightening serial range to 4-7 (prefer 5-6) would improve ARI.
-**Change**: Modified Russian pass1.md — added merge preference text, changed serial range.
-**Result**: score 0.724, coverage 0.955, ARI 0.758 (baseline 0.797).
-**Analysis**: Merge preference reduced storylines from 7→6 but introduced more naming variance (family/family_destruction/justice). The guidance text itself added ambiguity.
-**Next**: Try language change instead of content change.
-
-## Experiment 2 (Exp 2): Translate Pass 1 prompt to English
-**Hypothesis**: English instructions produce more deterministic LLM output (model trained predominantly on English).
-**Change**: Manually translated pass1.md to English. Synopses remain in Russian.
-**Result**: score 0.895, coverage 0.984, ARI 0.910 (first run). Re-run gave 0.758 — high variance.
-**Analysis**: English prompt showed promise but results were unstable. Led to discovering the existing prompts_en/ directory.
-**Next**: Use the existing English translations properly.
-
-## Experiment 3 (Exp 3): Translate Pass 2 prompt to English
-**Hypothesis**: English Pass 2 would also improve consistency.
-**Change**: Translated pass2.md to English on top of English Pass 1.
-**Result**: score 0.806, coverage 0.985, ARI 0.818.
-**Analysis**: English Pass 2 hurt consistency compared to English Pass 1 alone. The Russian Pass 2 prompt was better calibrated for event assignment.
-**Next**: Keep English Pass 1 only, revert Pass 2.
-
-## Experiment 4 (Exp 4): All prompts English via prompts_en/
-**Hypothesis**: Using the existing English translations with proper lang wiring would be more consistent.
-**Change**: Wired lang parameter through LLMConfig, set default to "en", using prompts_en/ directory.
-**Result**: score 0.824, coverage 0.963, ARI 0.856.
-**Analysis**: Moderate improvement over Russian baseline. Naming changed to compound words (gang_survival, family_destruction).
-**Next**: Constrain naming to prevent compound names.
-
-## Experiment 5 (Exp 5): Enforce single-word storyline names ⭐ BEST
-**Hypothesis**: Compound names (gang_survival, brotherhood_betrayal) vary across runs. Single abstract words are more stable.
-**Change**: In prompts_en/pass1.md, added explicit rule: "Name and id = ONE abstract English word by GOAL. Examples: belonging, leadership, love, redemption, investigation. Do NOT use compound names."
-**Result**: score 0.938 (first run), 0.954 (re-run), coverage 0.947-0.963, ARI 0.991.
-**Analysis**: MASSIVE improvement. All 3 runs produced identical storylines. Single-word names constrain the model's vocabulary to a small set of abstract concepts, eliminating naming variance. This is the single most impactful change.
-**Next**: Try to improve coverage without hurting ARI.
-
-## Experiment 6 (Exp 6): Tighten serial count to 5-8 (aim 6-7)
-**Hypothesis**: Nudging toward 7 storylines would add "brotherhood" and improve coverage.
-**Change**: Changed serial range from "3-8" to "5-8 (aim 6-7)" in prompts_en/pass1.md.
-**Result**: score 0.858, coverage 0.964, ARI 0.890.
-**Analysis**: 7 storylines produced ("justice" + "revenge" replacing "investigation"), but the extra line introduced naming inconsistency. 6 is the natural number for this show.
-**Next**: Focus on Pass 2 instead.
-
-## Experiment 7 (Exp 7): Minimize null assignments in Pass 2
-**Hypothesis**: Adding "minimize nulls" rule would improve coverage.
-**Change**: Added rule 6 to Pass 2: "every event should be assigned, use null only if truly no match."
-**Result**: score 0.859, coverage 0.950, ARI 0.904.
-**Analysis**: The added text perturbed the prompt balance. "justice" appeared instead of "investigation" in one run.
-**Next**: Don't add text to prompts — it adds variance.
-
-## Experiment 8 (Exp 8): Remove three-act structure mention
-**Hypothesis**: "Three-act structure, conflict, causal chain" is vague and could be removed.
-**Change**: Removed line from Story DNA definition in prompts_en/pass1.md.
-**Result**: score 0.724, coverage 0.958, ARI 0.756.
-**Analysis**: The three-act structure line is a POSITIVE constraint. Removing it made the model less precise.
-**Next**: Don't remove text either — the prompt is well-calibrated.
-
-## Experiment 9 (Exp 9): Remove seed/wraparound section
-**Hypothesis**: Seed/wraparound only matter in Pass 2, removing from Pass 1 saves tokens.
-**Change**: Removed "Seed and wraparound — not storyline types" section.
-**Result**: score 0.746, coverage 0.953, ARI 0.783.
-**Analysis**: Another positive constraint — telling the model what NOT to do is valuable.
-**Next**: Try non-prompt changes.
-
-## Experiment 10 (Exp 10): Add merge-preference to English Pass 1
-**Hypothesis**: "When in doubt, merge" was in Russian prompt but missing from English translation.
-**Change**: Added merge-preference text to granularity section.
-**Result**: score 0.699, coverage 0.953, ARI 0.734.
-**Analysis**: Adding ANY text to the Exp 5 prompt breaks the sweet spot. The prompt is highly optimized.
-**Next**: Try LLM settings or model changes.
-
-## Experiment 11 (Exp 11): Increase max_tokens to 16384
-**Hypothesis**: Truncated Pass 2 responses might lose events, reducing coverage.
-**Change**: Changed max_tokens from 8192 to 16384 in llm.py.
-**Result**: score 0.827, coverage 0.964, ARI 0.858.
-**Analysis**: More tokens = more room for variance. The 8192 limit was actually constraining output constructively.
-**Next**: Try model change.
-
-## Experiment 13 (Exp 13): Try Haiku 4.5
-**Hypothesis**: Smaller model might be more deterministic.
-**Change**: Changed default model to claude-haiku-4-5-20251001.
-**Result**: score 0.645, coverage 0.993, ARI 0.649.
-**Analysis**: Haiku produces great coverage but terrible consistency. 8/7/7 storylines with completely different names across runs. Sonnet 4 is clearly better for structured tasks.
-**Next**: Try code-level changes.
-
-## Experiment 12 (Exp 12): Include format field in Pass 1
-**Hypothesis**: format is declared as input but wasn't included in user message.
-**Change**: Added context.format to Pass 1 user_message JSON.
-**Result**: score 0.763, coverage 0.931, ARI 0.819.
-**Analysis**: More data in the prompt = more variance. The model doesn't need format to make good decisions.
-
-## Experiment 14 (Exp 14): Post-process orphan events
-**Hypothesis**: Code-level: assign null-storyline events to most common storyline for their characters.
-**Change**: Added assign_orphan_events() function to postprocess.py, called in pipeline.
-**Result**: score 0.837, coverage 0.994, ARI 0.843.
-**Analysis**: Coverage jumped from 0.963 to 0.994 but ARI dropped from 0.991 to 0.843. The reassignment amplified Run 3's divergence (which had "revenge" instead of "investigation").
-
-## Experiment 15 (Exp 15): Include obstacle/stakes in Pass 2
-**Hypothesis**: More storyline context in Pass 2 would improve event assignment.
-**Change**: Added obstacle and stakes fields to storyline data in Pass 2 user_message.
-**Result**: score 0.867, coverage 0.957, ARI 0.906.
-**Analysis**: All 3 runs had identical storylines but event assignments differed. More information = more ways to reason = less consistency.
-
-## Experiment 18 (Exp 18): Try claude-sonnet-4-6 model
-**Hypothesis**: Newer Sonnet 4.6 may produce more consistent structured output.
-**Change**: Changed default model to claude-sonnet-4-6 in llm.py.
-**Result**: score 0.497, coverage 0.997, ARI 0.498.
-**Analysis**: Sonnet 4.6 has much higher variance — 6/7/7 storylines with completely different names each run. Great coverage but terrible consistency. Sonnet 4 is far better for this task.
-
-## Experiment 19 (Exp 19): Validate max 5% null events in Pass 2
-**Hypothesis**: Rejecting responses with >5% null events forces better assignments.
-**Change**: Added validation in Pass 2 _validate() to reject >5% null events.
-**Result**: score 0.809, coverage 1.000, ARI 0.809.
-**Analysis**: Coverage jumped to 1.000 but ARI dropped — forcing uncertain assignments introduces variance. The retry creates different outputs each time.
-
-## Experiment 20 (Exp 20): Sort cast/storylines by ID in Pass 2
-**Hypothesis**: Alphabetical ordering in Pass 2 user message eliminates ordering variance.
-**Change**: Sorted cast and storylines by ID in both assign_events() and _prepare_bulk().
-**Result**: score 0.809, coverage 0.952, ARI 0.849.
-**Analysis**: Didn't help — the "revenge" vs "investigation" variance is in Pass 1, not Pass 2.
-
-## Experiment 21 (Exp 21): Majority voting on Pass 1 ⭐
-**Hypothesis**: Running Pass 1 three times and picking the most common storyline set eliminates rare outliers.
-**Change**: Added _VOTING_ROUNDS=3 in pass1.py, used call_llm_parallel, pick by Counter(id_sets).most_common.
-**Result**: score 0.963, coverage 0.963, ARI 1.000.
-**Analysis**: PERFECT ARI! All 3 test runs produced identical storylines. Cost increase: ~20% (3 extra LLM calls vs 8 Pass 2 calls). The "revenge" outlier is eliminated by majority vote.
-
-## Experiment 22 (Exp 22): Voting + 10% null validation ⭐
-**Hypothesis**: With ARI 1.000 from voting, a soft null threshold would boost coverage.
-**Change**: Added validation in Pass 2: reject if >10% events have null storyline.
-**Result**: score 0.967, coverage 0.988, ARI 0.979.
-**Analysis**: Coverage jumped from 0.963 to 0.988. ARI slightly decreased from 1.000 to 0.979 — the retry introduces minor variance, but voting keeps it manageable.
-
-## Experiment 23 (Exp 23): Tighten null threshold to 5%
-**Hypothesis**: Tighter threshold would push coverage even higher.
-**Change**: Changed threshold from 10% to 5%.
-**Result**: score 0.823, coverage 1.000, ARI 0.823.
-**Analysis**: Too aggressive — forces too many retries, reintroducing variance. 10% is the sweet spot.
-
-## Experiment 24 (Exp 24): Sort Pass 1 output by ID
-**Hypothesis**: Sorting Pass 1 output would make Pass 2 input deterministic.
-**Change**: Sorted cast and storylines by ID after parsing in extract_storylines().
-**Result**: score 0.962, coverage 0.988, ARI 0.974.
-**Analysis**: No improvement over Exp 22. The small ARI difference is noise.
-
-## Experiment 25 (Exp 25): Majority voting on Pass 0
-**Hypothesis**: Pass 0 context variance might seed Pass 1 differently across runs.
-**Change**: Added 3-round voting to Pass 0 (same approach as Pass 1).
-**Result**: score 0.805, coverage 0.983, ARI 0.819.
-**Analysis**: Didn't help — "revenge" leaked through. Pass 0 variance is not the issue.
-
-## Experiment 26 (Exp 26): 5 voting rounds for Pass 1
-**Hypothesis**: More rounds would make voting more robust.
-**Change**: Changed _VOTING_ROUNDS from 3 to 5 in pass1.py.
-**Result**: score 0.967, coverage 0.988, ARI 0.979.
-**Analysis**: Same score as 3 rounds — the extra cost provides no benefit. 3 rounds is sufficient.
-
-## Experiment 27 (Exp 27): Russian Pass 2 with English Pass 1 ⭐
-**Hypothesis**: Exp 3 showed English Pass 2 hurt vs Russian. Using Russian for Pass 2 only might help.
-**Change**: Created separate config_pass2 with lang="ru" in pipeline.py.
-**Result**: score 0.974, coverage 0.979, ARI 0.995.
-**Analysis**: ARI jumped from 0.979 to 0.995. Russian Pass 2 prompt is better calibrated for event assignment. Best language split: English Pass 1 (naming) + Russian Pass 2 (assignment).
-
-## Experiment 28 (Exp 28): Remove null validation
-**Hypothesis**: Russian Pass 2 might naturally minimize nulls, making validation unnecessary.
-**Change**: Removed the 10% null validation from Pass 2 _validate().
-**Result**: score 0.822, coverage 0.961, ARI 0.856.
-**Analysis**: "revenge" appeared again. The null validation acts as an indirect stabilizer — removing it hurts both coverage AND consistency.
-
-## Experiment 29 (Exp 29): Orphan event assignment ⭐ BEST
-**Hypothesis**: Exp 14 tried this before voting existed and it amplified divergence. With voting stabilizing storylines, orphan assignment should only help.
-**Change**: Added assign_orphan_events() in postprocess.py — assigns null events to most frequent storyline for their characters.
-**Result**: score 0.988, coverage 0.993, ARI 0.995.
-**Analysis**: Coverage jumped from 0.979 to 0.993 with NO ARI loss. The synergy is key: voting eliminates storyline divergence, so orphan assignment is deterministic across runs. Score: 0.581 → 0.988 (70% improvement from baseline).
-
-## Experiment 30 (Exp 30): Reduce max_tokens to 6144 ⭐
-**Hypothesis**: Tighter output limit constrains variance.
-**Change**: max_tokens from 8192 to 6144 in llm.py.
-**Result**: score 0.993, coverage 0.993, ARI 1.000.
-**Analysis**: Perfect ARI. Re-run got 0.858 due to "justice" appearing. Needed Exp 33 to stabilize.
-
-## Experiment 31 (Exp 31): Reduce max_tokens to 4096
-**Hypothesis**: Even tighter limit.
-**Change**: max_tokens from 6144 to 4096.
-**Result**: score 0.886, coverage 0.993, ARI 0.892.
-**Analysis**: Too tight — truncates responses, forces retries with different output.
-
-## Experiment 33 (Exp 33): Prescriptive naming vocabulary ⭐ BEST
-**Hypothesis**: "Choose ONLY from:" is stronger than "Examples:" — eliminates "revenge" and "justice".
-**Change**: Changed naming section from examples to prescriptive vocabulary of 12 words.
-**Result**: score 0.993, coverage 0.993, ARI 1.000 (STABLE across 2 consecutive runs).
-**Analysis**: The model now only picks from the allowed list. "investigation" is the only valid option for the disputed storyline. The remaining 0.7% uncoverage is 1 meta-narrative seed event with no cast characters — legitimately unassignable.
-
-## Key Findings
-
-1. **Constraint is king**: Adding information or options ALWAYS hurt consistency. Removing constraints also hurt. The optimal prompt is a precisely calibrated set of constraints.
-
-2. **Single-word naming was the breakthrough**: Constraining storyline names to one abstract English word eliminated naming variance entirely. ARI went from ~0.85 to 0.991.
-
-3. **Majority voting eliminates remaining Pass 1 variance**: Running Pass 1 3x and picking the majority storyline set achieved ARI 1.000 at ~20% cost increase.
-
-4. **Language split matters**: English Pass 1 (for naming consistency) + Russian Pass 2 (for event assignment quality) is better than all-English or all-Russian.
-
-5. **Code-level post-processing synergizes with voting**: Orphan event assignment failed alone (Exp 14) but works brilliantly with voting (Exp 29) — score 0.988.
-
-6. **Temperature=0 is essential**: The biggest absolute improvement was temperature=0 (ARI 0.595→0.810).
-
-7. **Sonnet 4 > Sonnet 4.6 for structure**: Newer models aren't necessarily more consistent. Sonnet 4.6 had ARI 0.498 vs Sonnet 4's 0.995.
-
-8. **The Exp 5 prompt is a fragile optimum**: Every prompt text perturbation worsened the score. Improvements came from code-level changes (voting, validation, post-processing).
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-program-v2.md b/docs/knowledge/archive/autoresearch/autoresearch-program-v2.md
deleted file mode 100644
index a75cbf5..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-program-v2.md
+++ /dev/null
@@ -1,231 +0,0 @@
----
-type: note
-project: tvplotlines
-status: active
----
-
-# tvplotlines autoresearch v2 — multi-show prompt optimization
-
-Автономная оптимизация промптов на диверсифицированном датасете (12 шоу, 7–25 эпизодов, en/ru).
-
-## Отличия от v1
-
-- **v1**: один шоу (Слово пацана, 8 eps), метрика = coverage × ARI (consistency). Оптимизировал стабильность, не качество.
-- **v2**: 12 шоу разных типов/длин, метрика = coverage × Coh−Sep (embedding-based). Оптимизирует качество разделения линий.
-
-## Метрика
-
-**Quality score** = mean across all shows of:
-
-```
-show_score = coverage × max(coh_sep, 0)
-```
-
-Where:
-- **coverage** = fraction of events with non-null storyline (from `metrics.py`)
-- **coh_sep** = within-storyline coherence minus between-storyline separation (from embeddings). Higher = storylines are more distinct from each other.
-
-**Constraint**: min(show_score) ≥ 0.01 — no show may collapse to zero. A change that improves the mean but kills one show is rejected.
-
-**Why not ARI**: ARI measures run-to-run consistency, not quality. A pipeline that consistently produces bad results scores high on ARI. Coh−Sep measures whether extracted storylines are semantically distinct — closer to actual extraction quality.
-
-**Embeddings**: OpenAI `text-embedding-3-small`. Cost: ~$0.002 per show (negligible).
-
-## Dataset
-
-| Show | Code | Eps | Type | Lang |
-|------|------|-----|------|------|
-| Breaking Bad S01 | BB | 7 | serial | en |
-| Слово пацана S01 | SP | 8 | serial | ru |
-| True Detective S01 | TD | 8 | serial | en |
-| GoT S01 | GOT | 10 | ensemble | en |
-| Мажор S01 | MAJOR | 12 | hybrid | ru |
-| ГДР S01 | GDR | 14 | serial | ru |
-| Метод S01 | METOD | 16 | hybrid | ru |
-| This Is Us S01 | TIU | 18 | ensemble | en |
-| House S01 | HOUSE | 22 | procedural | en |
-| CSI S01 | CSI | 23 | procedural | en |
-| ER S01 | ER | 25 | procedural | en |
-| Lost S01 | LOST | 25 | serial/ensemble | en |
-
-Synopses: `/Users/nvashko/Projects/tvplotlines-app/research/synopses/{CODE}_S01E*.txt`
-Results: `/Users/nvashko/Projects/tvplotlines-app/research/results/{code}_s01_result.json`
-
-### Fast set vs full set
-
-Running all 12 shows per experiment is expensive (~$10–15). Use a two-tier approach:
-
-**Fast set (4 shows, ~$3–4)** — for rapid iteration:
-- BB (7 eps, short serial, en) — known good baseline
-- SP (8 eps, short serial, ru) — Russian, known good baseline
-- House (22 eps, long procedural, en) — known problem case
-- Lost (25 eps, long serial/ensemble, en) — new, long non-procedural
-
-Fast set covers: short/long, serial/procedural/ensemble, en/ru. If a change helps on the fast set, validate on the full set.
-
-**Full set (all 12 shows)** — for validation of promising changes only. Run full set when:
-- Fast set score improves by ≥ 0.005
-- Before marking an experiment as `keep`
-
-## Setup
-
-1. **Agree on a run tag**: propose a tag based on today's date (e.g. `mar14`). The branch `autoresearch/<tag>` must not already exist.
-2. **Create the branch**: `git checkout -b autoresearch/<tag>` from current main.
-3. **Read the in-scope files** — read ALL of these before starting:
-   - `CLAUDE.md` — project context and conventions.
-   - `docs/architecture.md` — pipeline architecture.
-   - `src/tvplotlines/prompts/pass0.md` — Pass 0 prompt (context detection).
-   - `src/tvplotlines/prompts/pass1.md` — Pass 1 prompt (storyline extraction).
-   - `src/tvplotlines/prompts/pass2.md` — Pass 2 prompt (event assignment).
-   - `src/tvplotlines/prompts/pass3.md` — Pass 3 prompt (narratologist review).
-   - `src/tvplotlines/prompts_en/pass1.md` — English Pass 1 prompt.
-   - `src/tvplotlines/metrics.py` — metric computation.
-4. **Source environment**: `set -a && source .env && set +a`
-5. **Establish baseline**: Run all 12 shows once, compute scores, record in `results-v2.tsv`.
-6. **Confirm and go**.
-
-## What you CAN modify
-
-- Prompt files: `src/tvplotlines/prompts/pass{0,1,2,3}.md` and `src/tvplotlines/prompts_en/pass{0,1,2,3}.md`
-- Pipeline code: `src/tvplotlines/pass0.py`, `pass1.py`, `pass2.py`, `pass3.py`
-- Post-processing: `src/tvplotlines/postprocess.py`, `verdicts.py`
-- Orchestration: `src/tvplotlines/pipeline.py`
-- LLM settings: `src/tvplotlines/llm.py` — model, temperature, max_tokens
-
-## What you CANNOT modify
-
-- Metric computation script: `research/compute_embedding_metrics.py`
-- Synopsis files: `research/synopses/`
-- The scoring formula defined in this document
-
-## Running an experiment
-
-### Step 1: Run pipeline on shows
-
-```bash
-# Fast set (4 shows)
-set -a && source .env && set +a
-
-tvplotlines run /Users/nvashko/Projects/tvplotlines-app/research/synopses/BB_S01E*.txt \
-  --show "Breaking Bad" --season 1 --lang en --pass2-mode batch \
-  -o /Users/nvashko/Projects/tvplotlines-app/research/results/bb_s01_result.json
-
-tvplotlines run /Users/nvashko/Projects/tvplotlines-app/research/synopses/SP_S01E*.txt \
-  --show "Слово пацана" --season 1 --lang ru --pass2-mode batch \
-  -o /Users/nvashko/Projects/tvplotlines-app/research/results/slovo_patsana_s01_result.json
-
-tvplotlines run /Users/nvashko/Projects/tvplotlines-app/research/synopses/HOUSE_S01E*.txt \
-  --show "House" --season 1 --lang en --pass2-mode batch \
-  -o /Users/nvashko/Projects/tvplotlines-app/research/results/house_s01_result_v2.json
-
-tvplotlines run /Users/nvashko/Projects/tvplotlines-app/research/synopses/LOST_S01E*.txt \
-  --show "Lost" --season 1 --lang en --pass2-mode batch \
-  -o /Users/nvashko/Projects/tvplotlines-app/research/results/lost_s01_result.json
-```
-
-Run shows in parallel when possible (background jobs or separate terminals).
-
-### Step 2: Compute metrics
-
-```bash
-cd /Users/nvashko/Projects/tvplotlines-app/research
-python3 compute_embedding_metrics.py
-```
-
-### Step 3: Record results
-
-Log to `results-v2.tsv`:
-
-```
-commit	mean_score	min_score	bb	sp	house	lost	cost_usd	status	description
-```
-
-For full-set runs, add all 12 columns.
-
-## Experiment priorities
-
-### Primary target: Pass 1 prompt for long seasons
-
-The data shows Pass 1 undersegments long seasons (22+ eps → 4 storylines instead of 6–8). Hypotheses:
-
-1. **Season length awareness**: Add instruction that longer seasons typically have more storylines (5–8 for 20+ episodes vs 3–5 for 8 episodes).
-2. **Short arc recognition**: Explicitly describe multi-episode arcs that span 3–6 episodes as valid serialized storylines, not just full-season ones.
-3. **Franchise engine isolation**: In procedurals, ensure the episodic line doesn't absorb serialized sub-arcs.
-4. **Ensemble vs procedural scaling**: Ensemble shows naturally have more parallel storylines. Procedurals may also have them but the prompt currently discourages it.
-5. **Worked examples**: Add a long-season example (e.g. ER) to the prompt alongside the existing Breaking Bad example.
-
-### Secondary: Pass 2 assignment quality
-
-Even with correct Pass 1 extraction, Pass 2 may assign events to wrong storylines. This shows up as low Coh−Sep even when the right number of storylines exist.
-
-### Tertiary: Pass 3 verdicts
-
-Pass 3 may DROP valid short arcs or fail to CREATE missing ones. Test with skip_review=True vs False.
-
-## The experiment loop
-
-LOOP FOREVER:
-
-1. Check git state and `results-v2.tsv` — what's been tried, what worked.
-2. Pick the next experiment. One change per experiment — isolate variables.
-3. Edit prompt(s) and/or pipeline code.
-4. `git commit` the change.
-5. Run fast set (4 shows). Compute metrics.
-6. If fast set score improved by ≥ 0.005:
-   - Run full set (all 12 shows). Compute metrics.
-   - If full set score improved AND min_score ≥ 0.01 → keep.
-   - Otherwise → revert.
-7. If fast set score did not improve → revert.
-8. Record all results in `results-v2.tsv`.
-9. `git reset --hard HEAD~1` to revert discarded experiments.
-
-**NEVER STOP**: Once the loop begins, do NOT pause to ask the human. The human might be asleep or away and expects you to continue working indefinitely until manually stopped. If you run out of ideas, reread the prompts, try combining near-misses, try radical changes.
-
-## Cost optimization
-
-Use `--pass2-mode batch` for all autoresearch runs. Batch API is 50% cheaper on Pass 2 (the most expensive pass — N episodes × LLM call). System prompt caching is automatic in both modes.
-
-| Mode | Per show (22 eps) | Fast set (4 shows) | Full set (12 shows) |
-|------|-------------------|--------------------|--------------------|
-| parallel + cache | ~$0.65 | ~$3–4 | ~$8–12 |
-| **batch + cache** | **~$0.35** | **~$1.5–2** | **~$4–5** |
-
-Batch mode is slower (~2–5 min polling) but for autoresearch speed is less important than cost.
-
-## Cost budget
-
-- Fast set: ~$1.5–2 per experiment
-- Full set: ~$4–5 per experiment
-- Embeddings: ~$0.02 per experiment (negligible)
-- Expected: ~4–6 experiments per hour (fast set only), ~2 per hour (with full validation)
-- **HARD LIMIT: $30 total.** Track cumulative cost in results-v2.tsv. When cumulative cost approaches $28, stop and summarize findings. Do NOT exceed $30.
-
-## Baseline reference (before optimization)
-
-From current results:
-
-| Show | Eps | Lines | Coh−Sep | Coverage |
-|------|-----|-------|---------|----------|
-| Breaking Bad S01 | 7 | 4 | 0.083 | 0.97 |
-| GoT S01 | 10 | 8 | 0.077 | 1.00 |
-| Slovo Patsana S01 | 8 | 7 | 0.077 | 0.97 |
-| GDR S01 | 14 | 5 | 0.069 | 1.00 |
-| ER S01 | 25 | 8 | 0.037 | 1.00 |
-| True Detective S01 | 8 | 4 | 0.024 | 1.00 |
-| House S01 | 22 | 4 | 0.002 | 0.98 |
-| CSI S01 | 23 | 4 | −0.004 | 1.00 |
-
-Mean score (coverage × max(coh_sep, 0)): ~0.043
-Min score: 0.0 (CSI — negative coh_sep)
-
-The gap between short shows (~0.08) and long procedurals (~0.00) is the primary optimization target.
-
-## Strategy notes
-
-- **Coh−Sep is the bottleneck for long shows.** Coverage is already high everywhere.
-- Long seasons produce too few storylines → all events blend together → low coherence, no separation.
-- Focus on Pass 1 instructions that scale storyline count with season length.
-- Be careful not to over-generate storylines for short shows — verify on fast set.
-- If a change helps House/CSI but hurts BB/SP, it's rejected (min constraint).
-- Prompts exist in two languages (ru + en). Changes must be applied to both.
-- Theoretical grounding matters: changes should be defensible from narrative theory, not ad-hoc rules.
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-program.md b/docs/knowledge/archive/autoresearch/autoresearch-program.md
deleted file mode 100644
index 049a2c4..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-program.md
+++ /dev/null
@@ -1,142 +0,0 @@
----
-type: note
-project: tvplotlines
-status: active
----
-
-# tvplotlines autoresearch
-
-Автономная оптимизация пайплайна извлечения сюжетных линий.
-
-## Setup
-
-1. **Agree on a run tag**: propose a tag based on today's date (e.g. `mar11`). The branch `autoresearch/<tag>` must not already exist.
-2. **Create the branch**: `git checkout -b autoresearch/<tag>` from current main.
-3. **Read the in-scope files** — read ALL of these before starting, do not skip any:
-   - `CLAUDE.md` — project context and conventions.
-   - `md/architecture.md` — pipeline architecture.
-   - `md/prompt-experiment-ideas.md` — experiment hypotheses (H1–H14).
-   - `src/tvplotlines/prompts/pass0.md` — Pass 0 prompt (context detection).
-   - `src/tvplotlines/prompts/pass1.md` — Pass 1 prompt (storyline extraction).
-   - `src/tvplotlines/prompts/pass2.md` — Pass 2 prompt (event assignment).
-   - `src/tvplotlines/prompts/pass3.md` — Pass 3 prompt (narratologist review).
-   - `src/tvplotlines/metrics.py` — metric computation (read-only).
-   - `tests/fixtures/slovo_patsana_s01_consistency.json` — current baseline.
-4. **Source environment**: `set -a && source .env && set +a` — this loads the API key. Ensure it's sourced before every run.
-5. **Initialize results.tsv**: Create `results.tsv` with header row. Baseline will be the first entry.
-6. **Confirm and go**.
-
-## Experimentation
-
-Each experiment = modify prompts and/or pipeline code → run N pipeline passes → compute score.
-
-**What you CAN modify:**
-- Prompt files: `src/tvplotlines/prompts/pass{0,1,2,3}.md` — role formulations, step structure, strictness criteria, examples, wording.
-- Pipeline code: `src/tvplotlines/pass0.py`, `pass1.py`, `pass2.py`, `pass3.py` — parsing, validation, data preparation, what gets sent to LLM.
-- Post-processing: `src/tvplotlines/postprocess.py`, `verdicts.py` — span/weight computation, verdict application.
-- Orchestration: `src/tvplotlines/pipeline.py` — pass ordering, what data flows between passes.
-- LLM settings: `src/tvplotlines/llm.py` — model name, temperature, max_tokens. These are experiment parameters too.
-
-**What you CANNOT modify** (fixed evaluation — otherwise optimization is meaningless):
-- Metric code: `src/tvplotlines/metrics.py` — the scoring function.
-- Test harness: `tests/test_consistency.py` — how experiments are run.
-- Test fixtures: `tests/fixtures/` — input data.
-
-**Cost** is a soft constraint. Some increase is acceptable for meaningful score gains, but it should not blow up dramatically. A 10% score improvement that doubles cost? Worth considering. The same score at half the cost? Definitely keep. The `cost_usd` column in results.tsv tracks this — use it to compare experiments.
-
-**The goal:** The pipeline takes TV series synopses and extracts storylines — narrative threads that span multiple episodes. A good result means:
-- **High coverage** — every narrative event in a synopsis is assigned to a storyline (not left orphaned).
-- **High consistency** — running the pipeline twice on the same input gives structurally the same storylines. Different wording is fine ("belonging" vs "acceptance"), but the same characters should end up grouped together.
-
-Currently measured as `score = coverage × consistency(ARI)` — see `metrics.py` for details. This may not be the optimal way to measure quality; if you see problems with the metric, document them in `metric-concerns.md` but do not modify `metrics.py` during experiments.
-
-Current baseline: score **0.581** (coverage 0.977, ARI 0.595). Run without Pass 3 review.
-
-**Simplicity criterion**: All else being equal, simpler is better — shorter prompts, less code. If removing text or code gives equal or better results — keep. A 0.01 score improvement that adds 50 lines of complexity? Probably not worth it. A 0.01 improvement from simplifying? Definitely keep.
-
-**The first run**: Establish baseline with current prompts (should match the stored baseline).
-
-## Running an experiment
-
-Each experiment requires N independent pipeline runs (N=3 minimum) to compute consistency.
-
-```bash
-python -m pytest tests/test_consistency.py -v -s > run.log 2>&1
-```
-
-Extract results:
-
-```bash
-grep -E "^(Avg coverage|Consistency|Score):" run.log
-```
-
-Expected output:
-
-```
-Avg coverage: 0.977
-Consistency (ARI): 0.595
-Score: 0.581
-```
-
-**Time budget**: Each experiment takes ~10 minutes (3 runs × ~3 minutes each). If a run exceeds 20 minutes, kill it (`kill %1` or `kill <PID>`) and treat it as a crash — log, revert, move on.
-
-**Cost**: Each experiment costs ~$1–3 (API calls). Budget accordingly.
-
-## Logging results
-
-Log to `results.tsv` (tab-separated).
-
-Header and columns:
-
-```
-commit	score	coverage	consistency	cost_usd	status	description
-```
-
-1. git commit hash (short, 7 chars)
-2. score = coverage × consistency (e.g. 0.581)
-3. coverage (e.g. 0.977)
-4. consistency ARI (e.g. 0.595)
-5. approximate cost in USD (e.g. 1.5)
-6. status: `keep`, `discard`, or `crash`
-7. short description of what changed
-
-Example:
-
-```
-commit	score	coverage	consistency	cost_usd	status	description
-a1b2c3d	0.581	0.977	0.595	1.5	keep	baseline
-b2c3d4e	0.640	0.980	0.653	1.8	keep	H13: fewer theory quotes in pass1
-c3d4e5f	0.550	0.990	0.556	1.5	discard	H7: free-form pass3 prompt
-d4e5f6g	0.000	0.000	0.000	0.0	crash	H5: no role in pass3 (validation errors)
-```
-
-## The experiment loop
-
-LOOP FOREVER:
-
-1. Look at the git state and `results.tsv` — what's been tried, what worked.
-2. Pick the next experiment. Use `md/prompt-experiment-ideas.md` as inspiration, but you can also try your own ideas. Prioritize:
-   - Hypotheses that affect Pass 1–2 (larger impact on consistency).
-   - Hypotheses that simplify prompts (cheaper per run).
-   - Combining two previous near-wins.
-3. Edit prompt(s) and/or pipeline code. One change per experiment — isolate variables.
-4. `git commit` the change.
-5. Run: `python -m pytest tests/test_consistency.py -v -s > run.log 2>&1`
-6. Extract: `grep -E "^(Avg coverage|Consistency|Score):" run.log`
-7. If grep is empty, the run crashed. Check `tail -n 50 run.log` and attempt a fix.
-8. Record results in `results.tsv` (do NOT commit results.tsv — leave untracked).
-9. If score improved → keep the commit, advance the branch.
-10. If score is equal or worse → `git reset --hard HEAD~1` to revert.
-
-**Crashes**: If validation errors consistently fail, the prompt change broke structural output. Revert and try a different approach.
-
-**NEVER STOP**: Once the loop begins, do NOT pause to ask the human. Do NOT ask "should I keep going?" or "is this a good stopping point?". The human might be asleep or away and expects you to continue working *indefinitely* until manually stopped. Each experiment takes ~10 minutes, so you can run ~6 per hour, ~50 overnight. If you run out of hypotheses from the list, think harder — reread the prompts, try combining near-misses, try radical changes. The loop runs until the human interrupts you, period.
-
-## Strategy notes
-
-- **ARI is the bottleneck** (0.595). Coverage is already high (0.977). Focus on consistency.
-- Consistency improves when the LLM makes the same *structural* decisions across runs — same grouping of characters into storylines.
-- Things that help consistency: concrete rules > vague guidelines, examples > theory, constrained output > free-form.
-- Things that hurt consistency: subjective criteria, open-ended instructions, ambiguous categories.
-- Pass 3 currently runs with `skip_review=True` in the consistency test. To test Pass 3 prompt changes, update the test to include Pass 3. But note: Pass 3 adds another LLM call = more variance. Test it both ways.
-- If you plateau on ARI, consider testing with a different show/season to verify generalization.
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-prompt-experiment-ideas.md b/docs/knowledge/archive/autoresearch/autoresearch-prompt-experiment-ideas.md
deleted file mode 100644
index e8237c6..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-prompt-experiment-ideas.md
+++ /dev/null
@@ -1,54 +0,0 @@
----
-type: note
-project: tvplotlines
-status: active
----
-
-# Гипотезы для тестирования промптов
-
-Формулировки и структурные решения, которые нужно проверить через autoresearch-цикл. Каждая гипотеза — изменение в одном промпте, измеряется через `score = coverage × consistency`.
-
-## Pass 3: роль
-
-| # | формулировка | гипотеза |
-|---|---|---|
-| H1 | «Ты — нарратолог, ревизор сюжетной структуры» | Базовая |
-| H2 | «Ты — нарратолог, специалист по сериальной драматургии» | Акцент на экспертизу, а не на проверку — может дать более глубокий анализ |
-| H3 | «Ты — редактор сценарного отдела» | Индустриальная роль — может быть практичнее теоретика |
-| H4 | «Ты — шоураннер, проверяющий работу райтерз-рума» | Максимальный авторитет — может давать более решительные вердикты |
-| H5 | Без указания роли, только задача | Контрольная группа — роль вообще не нужна? |
-
-## Pass 3: структура промпта
-
-| # | вариант | гипотеза |
-|---|---|---|
-| H6 | Пошаговые инструкции (текущий: 7 шагов, 188 строк) | Структурированная проверка — ничего не пропустит |
-| H7 | Свободная форма: «оцени результат и предложи исправления» | Меньше ограничений — LLM сам решает на что смотреть |
-| H8 | Чеклист вопросов вместо шагов | Промежуточный вариант |
-| H8a | Укороченный: убрать шаги 4 (ранги) и 6 (патчи) — код и так делает | Меньше шум, LLM фокусируется на главном |
-| H8b | Минимальный: только роль + формат выхода, без шагов вообще | LLM-нарратолог сам знает на что смотреть? |
-
-## Pass 3: строгость критериев
-
-| # | вариант | гипотеза |
-|---|---|---|
-| H9 | Строгие критерии: нет Story DNA → DROP | Чистый результат, но потеря слабых линий плохо написанных сериалов |
-| H10 | Мягкие критерии: нет Story DNA → partial/inferred (текущий) | Сохраняет данные, но может оставлять шум |
-| H11 | Адаптивные: строгость зависит от franchise_type | Procedural строже (чёткая формула), ensemble мягче |
-
-## Pass 1-2: общие
-
-| # | вариант | гипотеза |
-|---|---|---|
-| H12 | Больше worked examples в промпте | Улучшит consistency (LLM видит паттерн) |
-| H13 | Меньше теории, больше правил | Улучшит consistency (меньше интерпретации) |
-| H14 | Цитаты из книг в промпте vs без них | Цитаты добавляют авторитет или шум? |
-
-## Как тестировать
-
-Одна гипотеза = один эксперимент в autoresearch-цикле:
-1. Изменить одну переменную в промпте
-2. Прогнать N раз (минимум 3)
-3. Вычислить score = coverage × consistency
-4. Сравнить с базовым score
-5. Keep / discard
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-results-v2.tsv b/docs/knowledge/archive/autoresearch/autoresearch-results-v2.tsv
deleted file mode 100644
index 954e1f8..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-results-v2.tsv
+++ /dev/null
@@ -1,15 +0,0 @@
-commit	mean_score	min_score	bb	sp	house	lost	cost_usd	cumulative_cost	status	description
-b6b2d39	0.0563	0.0049	0.0881	0.0591	0.0049	0.0731	2.0	2.0	baseline	Baseline: voting+orphans+single-word+max_tokens=6144
-79d6361	0.0511	0.0001	0.0486	0.0817	0.0001	0.0739	2.0	4.0	discard	v2-01: season-length scaling + short-arc guidance in Pass 1
-aeefc42	0.0554	0.0036	0.0960	0.0570	0.0036	0.0652	2.0	6.0	discard	v2-02: procedural vs serialized assignment rule in Pass 2
--	0.0586	0.0029	0.0830	0.0740	0.0029	0.0746	1.1	7.1	discard	v2-03: skip Pass 3 (narratologist review)
-13323c3	0.0490	0.0032	0.0797	0.0630	0.0032	0.0503	1.4	8.5	discard	v2-04: increase procedural storyline count (3-6 serialized per season)
-67214c7	0.0580	0.0000	0.0908	0.0819	0.0043	0.0814	4.5	13.0	keep	v2-05: event description specificity guidance in Pass 2 (full set validated)
-40be052	0.0548	0.0048	0.0753	0.0780	0.0048	0.0611	1.2	14.2	discard	v2-06: tie event descriptions to storyline goal (worse than v2-05)
-68ff8a1	0.0541	0.0066	0.0720	0.0817	0.0066	0.0561	1.5	15.7	discard	v2-07: limit events to 8-15 per episode (House+, BB/Lost-)
-94d0e00	0.0618	0.0061	0.0879	0.0818	0.0061	0.0715	1.8	17.5	discard	v2-08: Pass 3 oversized storyline check (House+0.002, Lost-0.01)
-c713445	0.0624	0.0086	0.0867	0.0814	0.0086	0.0728	1.8	19.3	discard	v2-09: Driver:Theme naming for all storylines (House+0.004, Lost-0.009)
-9cbc2c8	0.0588	0.0042	0.0819	0.0840	0.0146	0.0810	4.0	23.3	keep	v2-10: specificity + Driver:Theme naming (full set: House 3x, ER 2x, CSI out of zero)
-3f1e663	0.0605	0.0086	0.0857	0.0682	0.0086	0.0796	1.4	24.7	discard	v2-11: + Pass 3 oversized check (House regressed, SP dropped)
--	0.0655	0.0044	0.0931	0.0867	0.0044	0.0777	1.0	25.7	discard	v2-12: skip-review on v2-10 (House 0.0146→0.0044, Pass 3 helps House)
--	-	-	-	-	-	-	2.0	27.7	-	Restore fast set to v2-10 final state
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-results.tsv b/docs/knowledge/archive/autoresearch/autoresearch-results.tsv
deleted file mode 100644
index d42fa03..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-results.tsv
+++ /dev/null
@@ -1,40 +0,0 @@
-commit	score	coverage	consistency	cost_usd	status	description
-8fc9ce5	0.641	0.979	0.655	1.5	keep	baseline
-0e2977f	0.310	0.957	0.324	1.5	discard	H13: less theory, merge-when-in-doubt in pass1
-e2a52c1	0.797	0.984	0.810	1.5	keep	temperature=0 for all LLM calls
-6a4c23b	0.724	0.955	0.758	1.5	discard	Exp 1: stronger merge preference + serial 5-6
-315561a	0.895	0.984	0.910	1.5	keep	Exp 2: translate Pass 1 prompt to English
-e9434c0	0.806	0.985	0.818	1.5	discard	Exp 3: translate Pass 2 prompt to English (on top of Pass 1 EN)
-4155cf8	0.824	0.963	0.856	1.5	keep	Exp 4: all prompts English (via prompts_en/)
-efb780f	0.938	0.947	0.991	1.5	keep	Exp 5: enforce single-word storyline names
-63cb79e	0.858	0.964	0.890	1.5	discard	Exp 6: tighten serial count to 5-8 (aim 6-7)
-ad18df7	0.859	0.950	0.904	1.5	discard	Exp 7: minimize null assignments in Pass 2
-dff2b70	0.724	0.958	0.756	1.5	discard	Exp 8: remove three-act structure mention
-9980dd9	0.746	0.953	0.783	1.5	discard	Exp 9: remove seed/wraparound section from Pass 1
-6e464a2	0.699	0.953	0.734	1.5	discard	Exp 10: add merge-preference to Pass 1 EN
-b37ba62	0.827	0.964	0.858	1.5	discard	Exp 11: increase max_tokens to 16384
-fb16a1b	0.763	0.931	0.819	1.5	discard	Exp 12: include format field in Pass 1
-098b0a7	0.645	0.993	0.649	0.5	discard	Exp 13: try Haiku 4.5 (fast but inconsistent)
-07d4b84	0.837	0.994	0.843	1.5	discard	Exp 14: orphan event assignment by character affinity
-569a5e5	0.867	0.957	0.906	1.5	discard	Exp 15: include obstacle/stakes in Pass 2
-0d4dbf2	0.887	0.950	0.933	1.5	discard	Exp 16: sort Pass 1 output by ID
-325b7f3	0.872	0.969	0.900	1.5	discard	Exp 17: expand naming word list to 15 words
-91d9506	0.497	0.997	0.498	1.5	discard	Exp 18: try claude-sonnet-4-6 model
-365a3ab	0.809	1.000	0.809	1.5	discard	Exp 19: validate max 5% null events in Pass 2
-83d0ce0	0.809	0.952	0.849	1.5	discard	Exp 20: sort cast/storylines by ID in Pass 2
-239d125	0.963	0.963	1.000	1.5	keep	Exp 21: majority voting on Pass 1 (3 rounds)
-82a3c19	0.967	0.988	0.979	1.5	keep	Exp 22: voting + 10% max null validation in Pass 2
-ddeab0b	0.823	1.000	0.823	1.5	discard	Exp 23: tighten null threshold to 5%
-16aa5a1	0.962	0.988	0.974	1.5	discard	Exp 24: sort Pass 1 output by ID
-d4bef13	0.805	0.983	0.819	1.5	discard	Exp 25: majority voting on Pass 0
-51841bb	0.967	0.988	0.979	1.5	discard	Exp 26: 5 voting rounds (same score, more costly)
-d5dd616	0.974	0.979	0.995	1.5	keep	Exp 27: Russian Pass 2 + English Pass 1
-8b2b09d	0.822	0.961	0.856	1.5	discard	Exp 28: remove null validation
-170b18d	0.988	0.993	0.995	1.5	keep	Exp 29: orphan event assignment (voting stabilizes)
-97f76a1	0.993	0.993	1.000	1.5	keep	Exp 30: reduce max_tokens to 6144
-dcfc7f0	0.886	0.993	0.892	1.5	discard	Exp 31: reduce max_tokens to 4096
-362c6f0	0.858	0.993	0.864	1.5	discard	Exp 32: iterative orphan assignment
-b516ba6	0.993	0.993	1.000	1.5	keep	Exp 33: prescriptive naming vocabulary (stable, 2 runs)
-ab16eda	1.000	1.000	1.000	1.5	keep	Exp 34: fallback orphan to episode's most common storyline
-233e177	0.834	1.000	0.834	1.5	keep	Universal only: voting + null validation + orphans + max_tokens 6144
-1bc787b	0.880	0.998	0.882	1.5	keep	Remove 'English' from naming rule
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-run-v2.md b/docs/knowledge/archive/autoresearch/autoresearch-run-v2.md
deleted file mode 100644
index 5ea8aab..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-run-v2.md
+++ /dev/null
@@ -1,58 +0,0 @@
----
-type: note
-project: tvplotlines
-status: active
----
-
-# Task: tvplotlines autoresearch v2
-
-You are an autonomous prompt optimization agent. Your job is to improve tvplotlines's storyline extraction quality on procedural TV shows (House, CSI, ER) without degrading quality on other show types.
-
-## Step 1: Read the program
-
-Read `/Users/nvashko/Projects/tvplotlines-app/research/autoresearch/program-v2.md` — it contains the full protocol: dataset, metric, constraints, experiment loop, cost limits.
-
-## Step 2: Read all in-scope files listed in the program's Setup section
-
-Read every file listed there. Do not skip any.
-
-Also read the previous experiment results:
-- `/Users/nvashko/Projects/tvplotlines-app/research/autoresearch/results.tsv` — 40 previous experiments from v1.
-- `/Users/nvashko/Projects/tvplotlines-app/research/autoresearch/prompt-experiment-ideas.md` — hypotheses H1–H14.
-
-Study what was already tried and what worked. Do NOT repeat experiments that were already run. Build on top of what worked (voting, single-word naming, orphan assignment, temperature=0, max_tokens=6144).
-
-## Step 3: Establish baseline
-
-Run the fast set (BB, SP, House, Lost) with current prompts. Compute embedding metrics using `python3 /Users/nvashko/Projects/tvplotlines-app/research/compute_embedding_metrics.py`. Record baseline in `results-v2.tsv`.
-
-## Step 4: Run the experiment loop
-
-Follow the loop described in program-v2.md. Key rules:
-- One change per experiment — isolate variables.
-- Use `--pass2-mode batch` for all runs to save cost.
-- Track cumulative cost. HARD LIMIT: $30 total. Stop at $28.
-- Source .env before every run: `set -a && source /Users/nvashko/Projects/tvplotlines/.env && set +a`
-- Run shows in parallel (background jobs) when possible.
-- Focus on Pass 1 prompt changes that help procedurals without hurting serials.
-- Prompts exist in TWO languages. Every prompt change must be applied to BOTH:
-  - Russian: `src/tvplotlines/prompts/pass{0,1,2,3}.md`
-  - English: `src/tvplotlines/prompts_en/pass{0,1,2,3}.md`
-  Russian shows (SP, GDR, Метод, Мажор) use Russian prompts, English shows use English prompts. If you change only one language, half the dataset won't see the change.
-- git commit each experiment before running.
-- Revert with `git reset --hard HEAD~1` if score drops.
-
-## Step 5: When done
-
-When you hit the cost limit or run out of ideas:
-1. Summarize all experiments and findings in `results-v2.tsv`.
-2. Write a short summary to `/Users/nvashko/Projects/tvplotlines-app/research/autoresearch/summary-v2.md`: what worked, what didn't, best score achieved, recommended next steps.
-3. Do NOT push to remote. Leave changes on the branch.
-
-## Important
-
-- NEVER modify `compute_embedding_metrics.py` or synopsis files.
-- NEVER ask the human for input. Work autonomously until the cost limit.
-- NEVER stop early. If you plateau, try radical changes, combinations, or different passes.
-- The working directory is `/Users/nvashko/Projects/tvplotlines`.
-- Synopsis and result files are in `/Users/nvashko/Projects/tvplotlines-app/research/`.
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-summary-v2.md b/docs/knowledge/archive/autoresearch/autoresearch-summary-v2.md
deleted file mode 100644
index 6285c19..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-summary-v2.md
+++ /dev/null
@@ -1,111 +0,0 @@
----
-type: note
-project: tvplotlines
-status: active
----
-
-# Autoresearch v2 — Summary
-
-## Setup
-
-- **Date**: 2026-03-14
-- **Branch**: `autoresearch/mar14`
-- **Metric**: `score = coverage × max(coh_sep, 0)` where coh_sep = within-storyline coherence minus between-storyline separation (embedding-based)
-- **Dataset**: 12 shows, fast set (BB, SP, House, Lost) for iteration, full set for validation
-- **Budget**: $30 hard limit, spent ~$27.7
-- **12 experiments** run (2 kept, 10 discarded)
-
-## Baseline
-
-| Show | Eps | Lines | Coh-Sep | Score |
-|------|-----|-------|---------|-------|
-| This Is Us | 18 | 7 | 0.1111 | best |
-| Breaking Bad | 7 | 5 | 0.0881 | good |
-| GoT | 10 | 8 | 0.0768 | good |
-| Lost | 25 | 10 | 0.0731 | good |
-| GDR | 14 | 5 | 0.0687 | ok |
-| Слово пацана | 8 | 6 | 0.0591 | ok |
-| Метод | 16 | 6 | 0.0561 | ok |
-| Мажор | 12 | 6 | 0.0371 | low |
-| ER | 25 | 8 | 0.0366 | low |
-| True Detective | 8 | 4 | 0.0240 | low |
-| House | 22 | 4 | 0.0049 | very low |
-| CSI | 23 | 4 | -0.0037 | zero |
-
-**Baseline mean: 0.0530**. Procedurals (House, CSI, ER) are the clear bottleneck.
-
-## Best result: v2-10 (specificity + Driver:Theme naming)
-
-Two changes kept:
-
-### 1. Event description specificity (v2-05, Pass 2)
-Added guidance to write specific, concrete event descriptions with character names, actions, and dramatic consequences.
-
-### 2. Driver:Theme naming convention (v2-10, Pass 1)
-Changed from generic naming ("Empire", "Family") to `Driver: Theme` format ("Walt: Empire", "Walt: Family"). This makes it explicit who drives each storyline.
-
-### Full set results (v2-10)
-
-| Show | Baseline | v2-10 | Delta |
-|------|----------|-------|-------|
-| This Is Us | 0.1111 | 0.1022 | -0.0089 |
-| Breaking Bad | 0.0881 | 0.0819 | -0.0062 |
-| GDR | 0.0687 | 0.0876 | +0.0189 |
-| GoT | 0.0768 | 0.0772 | +0.0004 |
-| Слово пацана | 0.0591 | 0.0840 | +0.0249 |
-| Lost | 0.0731 | 0.0810 | +0.0079 |
-| ER | 0.0366 | 0.0702 | **+0.0336** |
-| Метод | 0.0561 | 0.0415 | -0.0146 |
-| Мажор | 0.0371 | 0.0319 | -0.0052 |
-| True Detective | 0.0240 | 0.0289 | +0.0049 |
-| **House** | **0.0049** | **0.0146** | **+0.0097** |
-| CSI | 0.0000 | 0.0042 | +0.0042 |
-
-**v2-10 mean: 0.0588** (baseline: 0.0530, **+11%**)
-
-Key wins:
-- **ER**: 0.0366 → 0.0702 (nearly 2x)
-- **Слово пацана**: 0.0591 → 0.0840 (+42%)
-- **House**: 0.0049 → 0.0146 (3x)
-- **CSI**: negative → 0.0042 (out of zero)
-- **GDR**: 0.0687 → 0.0876 (+28%)
-
-## What didn't work
-
-| Experiment | Hypothesis | Result |
-|-----------|-----------|--------|
-| v2-01: Season-length scaling | Longer seasons → more storylines | Mean dropped -0.005. Made model confused. |
-| v2-02: Procedural assignment rule | Separate episodic from serialized in Pass 2 | Neutral (-0.001). Too subtle for LLM. |
-| v2-03: Skip Pass 3 | Narratologist overmerges | Mixed. SP improved, House dropped. Pass 3 helps House. |
-| v2-04: More storylines for procedurals | 1 episodic + 3-6 serialized | Mean dropped -0.007. Hurt serials. |
-| v2-06: Goal-linked descriptions | "How it advances the goal" | Worse than pure specificity (-0.010). |
-| v2-07: Fewer events (8-15 per ep) | Less noise | House slightly up, BB/Lost down (-0.011). |
-| v2-08: Oversized storyline check in Pass 3 | >60% events → split | House +0.002, Lost -0.01. Not enough. |
-| v2-11: v2-10 + oversized check | Combine best changes | House regressed. Changes interact poorly. |
-| v2-12: v2-10 + skip-review | Skip Pass 3 | House 0.0146→0.0044. Pass 3 IS helping House. |
-
-## Key insights
-
-1. **Event description quality matters more than storyline structure.** Specific, concrete event descriptions improve embedding-based metrics across all show types. This is the single most impactful change.
-
-2. **Driver:Theme naming improves procedurals.** Making the driver explicit in storyline names helps the LLM assign events more precisely, especially in procedurals where many characters participate in the same case.
-
-3. **Pass 3 (narratologist review) helps procedurals.** Experiments v2-03 and v2-12 both showed that skipping Pass 3 hurts House. The narratologist creates and reassigns storylines that the initial pass misses.
-
-4. **Pass 1 structure changes are risky.** Modifying storyline counts or adding complex guidance (season-length scaling, short arcs) tends to confuse the model. Simple, clear rules work better.
-
-5. **Run-to-run variance is ~0.01-0.02 on Coh-Sep.** This makes it hard to isolate small improvements. Only changes with ≥0.005 delta on the fast set are reliably above noise.
-
-6. **The procedural problem is structural, not prompt-based.** In procedurals like House, the episodic line naturally dominates (285/383 events). Even with better naming and specificity, the fundamental imbalance remains. Fixing this likely requires architectural changes (e.g., two-pass event assignment, or explicit episodic/serialized separation in Pass 2 output format).
-
-## Recommended next steps
-
-1. **Architectural approach to procedural episodic dominance**: Consider splitting Pass 2 into two substeps for procedurals — first assign episodic events, then assign serialized events from the remainder. This would force better separation.
-
-2. **Per-episode Pass 2 voting**: Like Pass 1 voting but for event assignment. Would reduce run-to-run variance in the most expensive pass.
-
-3. **Coh-Sep metric analysis**: Investigate whether the metric ceiling for procedurals is inherently lower (all events involve medical/crime themes). Consider using a topic-adjusted version of the metric.
-
-4. **Full-set rerun of v2-10**: Run 3 times to establish confidence intervals on the current best.
-
-5. **Test on new shows**: Add 2-3 shows not in the training set to verify generalization.
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-brainstorm-notes.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-brainstorm-notes.md
deleted file mode 100644
index 76b8da7..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-v3-brainstorm-notes.md
+++ /dev/null
@@ -1,123 +0,0 @@
----
-type: note
-project: tvplotlines
-status: active
----
-
-# Autoresearch v3: рабочие заметки из брейншторма
-
-Дата: 2026-03-18. Это сырьё для плана, не план. План пишем после прочтения статей.
-
-## Что происходит
-
-Наташа прошлась по всем 4 промптам tvplotlines и написала 60 замечаний (`notes for 3rd autoresearch.md` в Projects root). Вердикт: промпты — хаос. Не системно, не основано на теории, избыточно, неточно, не соответствует заявлению что это "программа для LLM".
-
-Нужно: переписать все 4 промпта + настроить autoresearch чтобы проверить что переписанные промпты не ухудшили качество извлечения.
-
-## 6 системных проблем (из 60 замечаний)
-
-### 1. Промпты ≠ программы
-Структура хаотичная: контракт говорит одно, Input — другое. Определения используются до того как объяснены. Meta-комментарии для разработчиков ("compiled from reference.md", "recompile from ADR-005") торчат в промпте который идёт в LLM. "After validation, result shown to human" — неправда. Цитаты с номерами страниц ("Nash, p.34") — зачем в промпте для машины?
-
-### 2. Глоссарий ≠ промпты
-В глоссарии определения точнее и полнее: franchise types, plotline, Story DNA, plot-led/character-led. В промптах — огрызки тех же определений, часто неточные. Глоссарий объясняет цепочку Franchise Type → Story Engine → Story DNA — в промптах этого нет. Нужно: глоссарий = ground truth, промпты берут определения оттуда.
-
-### 3. Мусорные поля и концепции
-Собираем но не используем (или непонятно зачем): `format` (ongoing/limited/anthology), `narrative devices`, `confidence`, `interactions` между линиями, `patches`, `weight` (primary/background/glimpse). Для каждого нужно решить: нужно → оставить с объяснением. Не нужно → убрать.
-
-### 4. Терминологическая каша
-`storyline` vs `plotline` — непоследовательно, даже внутри одного промпта (Pass 3 вдруг переключается на plotlines). `episodic` как тип линии — не общепринятый термин. Story DNA используется один раз, потом забывается. Logline test = 3 части, Story DNA = 4 части — противоречие.
-
-### 5. Код vs LLM — граница размыта
-Правила валидации дублируются в промпте и коде ("exactly one episodic storyline"). Constraints которые код уже проверяет — зачем повторять в промпте? Re-request on error — как сейчас выглядит? Ранжирование по весам — код считает, но промпт тоже пытается объяснить.
-
-### 6. Непроверенные утверждения
-TRANSFORMED storyline — бывает ли? A-rank всегда plot-led — правда ли? "Emotional counterpoint" — что? Pass 0 вообще нужен отдельно?
-
-## Подход к autoresearch
-
-Решили: **Подход C — "Программа промптов + incremental autoresearch"**.
-
-Но с важными уточнениями после обсуждения:
-- Event functions — НЕ отдельный шаг. Это часть той же работы (глоссарий уже содержит правильные 7 функций, промпт Pass 2 — старые).
-- Baseline считаем по **существующим** результатам 13 шоу, не прогоняем заново.
-- Autoresearch = **тестовый стенд** (ты вносишь изменение → прогон → метрики → принять/откатить), а не автоматическая генерация промптов.
-- Определения из теории (Nash, Douglas) — не подлежат авто-оптимизации. Авто-оптимизация — для формулировок инструкций и few-shot примеров.
-
-## Blueprint First: структура промпта
-
-Каждый Pass должен иметь одинаковый скелет:
-
-```
-1. ROLE        — кто ты (одно предложение)
-2. DEFINITIONS — термины из глоссария, ровно те что нужны этому pass
-3. INPUT       — что получаешь (schema, один раз)
-4. TASK        — что делаешь (пронумерованные шаги)
-5. OUTPUT      — JSON schema с типами полей
-6. EXAMPLE     — few-shot примеры
-```
-
-Принцип: определи перед использованием, используй после определения, не повторяй. Никаких meta-комментариев, цитат, validation rules (это в коде), двойных описаний, негативных constraints на несуществующие проблемы.
-
-## Что отдать коду, что — LLM
-
-| Задача | Кто | Почему |
-|--------|-----|--------|
-| Franchise type → constraints (сколько линий, нужна ли episodic) | Код | Детерминированные правила |
-| Валидация Story DNA completeness | Код | Проверка наличия 4 полей |
-| Ранжирование A/B/C по весам | Код | Арифметика по event counts |
-| Arc completeness / order | Код | Проверка последовательности функций |
-| Извлечение линий из синопсисов | LLM | Fuzzy, нарративное понимание |
-| Присвоение событий линиям | LLM | Понимание целей персонажей |
-| Определение function (setup/catalyst/...) | LLM | Нарративное суждение |
-
-Ключевой инсайт: чем больше constraints переносим из промпта в код, тем проще промпт и стабильнее результат.
-
-## Few-shot примеры
-
-Сейчас: один hardcoded пример (Breaking Bad) во всех промптах. BB — serial, 4 линии, чистая драма. Если на входе hybrid (House), пример BB может сбивать.
-
-Идея: подбирать релевантный пример по franchise type. Или давать 2-3 примера разных типов. У нас уже есть 13 результатов — можно взять лучшие как кандидаты в few-shot. Это можно автоматизировать (DSPy/MIPRO-подобный подход).
-
-Но это оптимизация второго порядка. Сначала промпты должны быть чистыми.
-
-## Метрики
-
-Текущие метрики в коде: coverage (доля событий привязанных к линии), consistency/ARI (стабильность между прогонами).
-
-Проблема: нет ground truth. Варианты оценки:
-- Стабильность + structural checks (код) — дёшево, но слепое пятно на качество
-- LLM-as-judge по чеклисту — автоматизируемо, нужно калибровать
-- Экспертная оценка на 2-3 шоу — дорого, но объективно
-
-Нужно решить после чтения ExtractBench — как они сравнивают extracted JSON.
-
-## Research findings
-
-### Статьи для чтения (план в отдельном файле)
-1. GoLLIE — annotation guidelines для IE
-2. Blueprint First — code controls workflow, LLM for bounded subtasks
-3. DSPy — prompts as compilable signatures
-4. MIPRO — optimizer for multi-stage LM pipelines
-5. OPRO — LLM generates improved prompts from history + scores
-6. TextGrad — textual gradients for component optimization
-7. ExtractBench — metrics for nested JSON extraction
-
-### Ключевые инсайты из research
-- Чистый few-shot GPT-4 обычно не бьёт fine-tuned BERT на NER. Но гибрид (LLM extraction + code validation) — бьёт.
-- Ширина JSON схемы (количество полей) — главный предиктор провала extraction (ExtractBench). У tvplotlines ~15 полей на storyline — умеренно.
-- OPRO/TextGrad/MIPRO — для оптимизации формулировок и примеров, не для оптимизации онтологии.
-- Riedl 2016 — нарративы оставляют многое implicit, LLM должна собирать из разрозненных упоминаний. Релевантно для Pass 1 (Story DNA reconstruction).
-
-## Данные
-
-- 13 шоу с результатами в `/Users/nvashko/Projects/1-projects/tvplotlines-app/data/results/`
-- Метрики считаются через `compute_all_metrics.py` там же
-- Глоссарий (ground truth): `3-resources/plotter_docs/preprint/paper/glossary 1.md` (domain terms) + `glossary.md` (pipeline terms)
-- 60 замечаний: `/Users/nvashko/Projects/notes for 3rd autoresearch.md`
-
-## Что дальше
-
-1. Прочитать 7 статей (план в `autoresearch-v3-reading-plan.md`)
-2. Вернуться, написать план autoresearch v3 с учётом прочитанного
-3. Старый `autoresearch-v3-event-functions.md` — устарел, будет заменён
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-engineering-review.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-engineering-review.md
deleted file mode 100644
index 1c321db..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-v3-engineering-review.md
+++ /dev/null
@@ -1,146 +0,0 @@
----
-type: note
-project: tvplotlines
-status: active
----
-
-# Autoresearch v3: инженерная рецензия планов
-
-Рецензия на документы: [[tvplotlines-autoresearch-v3-plan|v3-plan]], [[tvplotlines-autoresearch-v3-engineering|v3-engineering]], [[tvplotlines-autoresearch-v3-event-functions|v3-event-functions]], [[tvplotlines-autoresearch-v3-brainstorm-notes|v3-brainstorm-notes]], [[tvplotlines-autoresearch-v3-questions|v3-questions]], [[tvplotlines-autoresearch-v3-reading-plan|v3-reading-plan]], [[tvplotlines-autoresearch-v3-hybrid-vs-procedural|v3-hybrid-vs-procedural]], [[notes for 3rd autoresearch]], [[tvplotlines-architecture|architecture]], [[tvplotlines-event-functions-redesign|event-functions-redesign]], [[tvplotlines-stability-benchmark|stability-benchmark]], [[tvplotlines-autoresearch-summary-v2|autoresearch-summary-v2]], [[tvplotlines-metrics-survey|metrics-survey]], [[tvplotlines-design-decisions|design-decisions]], [[tvplotlines-decision-001-context-before-extraction|ADR-001]], [[tvplotlines-decision-005-pass3-narratologist-review|ADR-005]], [[tvplotlines-naive-vs-tvplotlines|naive-vs-tvplotlines]], [[tvplotlines-enculturation-core-idea|enculturation-core-idea]]. Также промпты (`pass0.md` — `pass3.md`) и код (`pass0.py` — `postprocess.py`).
-
----
-
-## Общая оценка
-
-В документах два проекта под одним именем "v3":
-
-1. **Исследовательский** ([[tvplotlines-autoresearch-v3-plan|v3-plan]]): ablation study — доказать что scaffold важен. Цель — препринт.
-2. **Инженерный** ([[tvplotlines-autoresearch-v3-engineering|v3-engineering]], [[tvplotlines-autoresearch-v3-event-functions|v3-event-functions]], [[tvplotlines-autoresearch-v3-questions|v3-questions]], [[notes for 3rd autoresearch|60 замечаний]]): переписать промпты, заменить event functions, вычистить мусор. Цель — качество продукта.
-
-Порядок в документах перевёрнут. Ablation study на текущих промптах будет измерять качество бардака, а не scaffold'а.
-
----
-
-## 1. Сначала чистка, потом исследование
-
-Инженерная чистка **до** ablation study — детерминированная работа, не требует autoresearch:
-
-1. `storyline → plotline` везде
-2. Глоссарий = ground truth для определений в промптах
-3. Blueprint First скелет промпта: ROLE → DEFINITIONS → INPUT → TASK → OUTPUT → EXAMPLE
-4. Constraints из промптов → в код (Qiu 2025: +11.7pp vs +1.1pp)
-5. Event functions: заменить `cliffhanger/seed` на `catalyst/crisis` в промптах и в коде. **Сначала верифицировать набор по учебникам** (см. п.6)
-6. Неиспользуемые поля (`format`, `narrative devices`, `patches`, `interactions`): сейчас собираются но нигде не применяются. Для `format` и `patches` — скорее всего убрать. Для `narrative devices` — возможно оставить: после чтения Zwaan (когнитивный контроль при понимании нарратива) и работ по AI enculturation есть основание думать что выделение devices может быть частью того как scaffold помогает LLM "понимать" нарратив. Нужно: уточнить список devices по теории, определить где они применяются downstream, и только тогда решить — убрать или формализовать
-7. Merge Pass 0 → Pass 1 (ablation `pass1_merged.py` показала что можно)
-
-После чистки — прогон на 12 шоу, сравнить с v2-10 baseline (mean 0.0588). Деградация > 5% → найти причину, откатить.
-
----
-
-## 2. Метрики
-
-### Что работает
-
-| Метрика | Что измеряет | Откуда |
-|---------|-------------|--------|
-| `coverage` | Полнота — все события привязаны? | Здравый смысл |
-| `ARI` | Стабильность — воспроизводим между прогонами? | Hubert & Arabie 1985 |
-| `coh_sep` | Различимость — линии не слипаются? | Наша, из идей Silhouette Coefficient |
-
-### Что проверяет что
-
-| Что                    | Кто создаёт         | Кто проверяет    | Метрика               |
-| ---------------------- | ------------------- | ---------------- | --------------------- |
-| Арка эпизода           | LLM (Pass 2)        | Код после Pass 2 | episode completeness  |
-| Разнесение по линиям   | LLM (Pass 2)        | Код              | `coh_sep`, `coverage` |
-| Арка линии через сезон | Код (постобработка) | Pass 3 + код     | arc completeness      |
-
-### Позиция: не accuracy, а reliability + validity
-
-tvplotlines работает с текстом синопсиса и ищет **воспроизводимую нарратологическую интерпретацию текста**. 
-
-Три метрики это и измеряют: стабильно (ARI), различимо (coh_sep), полно (coverage). **Оговорить в препринте и README** почему мы не проверяем ground truth 
-
-### `function_score` — снять
-
-Произвольные пороги, некалиброванная формула. Episode completeness и arc completeness — реализовать в коде на этапе чистки как факт (5/7, 7/7), без оценок "хорошо/плохо". Пороги калибровать post-hoc.
-
----
-
-## 3. v2 урок
-
-Из 12 экспериментов v2: 2 успеха, 10 провалов. Добавление/убирание фраз в промпт ломало баланс. Главный вывод: **"The procedural problem is structural, not prompt-based."**
-
-**Это главный риск v3** — мы хотим радикально переписать промпты, а v2 показал что промпты хрупкие.
-
-Но есть важное отличие. v2 менял текст в работающем промпте — добавлял/убирал фразы, надеясь улучшить. v3 чистка — это не "менять формулировки", а рефакторинг: убрать мусор (meta-комментарии, дубликаты, цитаты), привести к единой структуре (Blueprint First), перенести проверки в код, заменить определения на точные из глоссария. Промпт должен сказать **то же самое**, но чище. Как переписать функцию без изменения поведения.
-
-**Стратегия снижения риска:** одно изменение → прогон → сравнить с baseline → если упало → откатить конкретное изменение. Не всё разом.
-
-Для v3 это также значит: из 17 шагов v3-plan минимум 8 — эксперименты с формулировками. При hit rate 17% (как в v2) → 1-2 успеха из 8. Бюджет может не хватить. Приоритет — структурные изменения (код), а не формулировки.
-
----
-
-## 4. Event functions: два документа противоречат
-
-[[tvplotlines-event-functions-redesign|event-functions-redesign]] — зрелый документ с фрактальной структурой, теоретическим обоснованием. [[tvplotlines-autoresearch-v3-event-functions|v3-event-functions]] — черновик с необоснованным function_score.
-
-Использовать первый. Из второго взять только протокол (baseline → замена → coh_sep ≥ baseline × 0.95).
-
----
-
-## 5. Эвристики из теории
-
-Много правил в промптах как расплывчатый текст, которые можно формализовать в код. Но сначала — набрать из учебников. Подробный каталог: [[tvplotlines-heuristics-from-theory]].
-
-Ключевые:
-- **Порядок функций в арке** — уточнить какие жёсткие, какие гибкие
-- **Episode completeness** — какие функции must be в каждом эпизоде
-- **Story DNA** — код-валидация полноты полей
-- **Количество линий по franchise type** — код-валидация диапазонов
-- **A-rank = plot-led?** — проверить в теории
-- **Narrative devices, interactions, emotional counterpoint** — нужны ли? формализовать или убрать?
-
----
-
-## 6. Event functions: верифицировать набор
-
-Текущие 7 функций — микс Nash + Netflix + McKee + Oberg. Ни один практик не узнает "свою" систему.
-
-| Наша          | Nash                | Netflix           | McKee                     | Harmon    |
-| ------------- | ------------------- | ----------------- | ------------------------- | --------- |
-| setup         | Set-Up              | Setup             | —                         | YOU, NEED |
-| catalyst      | Catalyst            | Inciting Incident | Inciting Incident         | GO        |
-| escalation    | Fun & Games + Bad Guys Close In | Escalation | Progressive Complications | SEARCH |
-| turning_point | Midpoint                        | Midpoint   | —                         | FIND   |
-| crisis        | All Is Lost + Dark Night of the Soul | Crisis | Crisis                    | TAKE   |
-| climax        | Finale              | Climax            | Climax                    | RETURN    |
-| resolution    | Final Image         | Resolution        | Resolution                | CHANGE    |
-
-**До внедрения:** выбрать каноническую основу, проверить конспект Netflix workshop, записать маппинг в глоссарий.
-
----
-
-## 7. Мелкие замечания
-
-**Reading plan ([[tvplotlines-autoresearch-v3-reading-plan|v3-reading-plan]])** предлагает прочитать 7 статей. Из них для v3 реально нужны 3: GoLLIE (как писать определения в промпте), Blueprint First (что перенести в код), ExtractBench (как сравнивать JSON результаты). Остальные 4 (DSPy, MIPRO, OPRO, TextGrad) — про автоматическую оптимизацию промптов. При нашем бюджете ($60-85) и масштабе (12 шоу) ручной A/B тест (как в v1/v2) дешевле и проще чем фреймворк.
-
-**Naive vs tvplotlines ([[tvplotlines-naive-vs-tvplotlines|naive-vs-tvplotlines]])** — эксперимент "наивный промпт vs pipeline". Это то же самое что условие A в ablation study из [[tvplotlines-autoresearch-v3-plan|v3-plan]]. Не делать два раза — объединить в один эксперимент.
-
-**Hybrid vs procedural ([[tvplotlines-autoresearch-v3-hybrid-vs-procedural|v3-hybrid-vs-procedural]])** — вопрос "где граница между procedural и hybrid". Хорошо поставлен (конкретная проблема, конкретная гипотеза). Решить на фазе 1 (подготовка) — прочитать Nash/Douglas/Mittell, уточнить определение.
-
----
-
-## Что через autoresearch, а что нет
-
-**НЕ через autoresearch:** переименование, глоссарий→промпты, Blueprint First, constraints→код, enum functions, merge Pass 0→1, мусорные поля, пост-обработка арок.
-
-**Через autoresearch:** ablation study, формулировки event functions, CoT в примерах, подбор примеров по franchise type.
-
----
-
-## Порядок работы
-
-Детальный план с чекбоксами: [[tvplotlines-autoresearch-v3-todo]]
-
-Бюджет: ~$60-85. Каждая фаза — checkpoint.
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-engineering.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-engineering.md
deleted file mode 100644
index 8c6e66a..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-v3-engineering.md
+++ /dev/null
@@ -1,60 +0,0 @@
----
-type: draft
-project: github-io
-status: active
-title: ""
-date: 2026-03-18
-description: ""
-series: What Logic Can Do for Stories
-tags: []
-sources:
-  - reading_note: ""
-    sections_used: []
----
-
-# Autoresearch v3: техническая оптимизация
-
-Отдельно от плана исследования (`plotter-autoresearch-v3-plan.md`). Это инженерные задачи — полезны для продукта, не для препринта. Выполняются после или параллельно с исследованием.
-
-Статус: `[ ]` — не начато, `[~]` — в процессе, `[x]` — сделано.
-
----
-
-- [ ] **1. Терминология storyline → plotline.** Переименовать в промптах, коде, документации. Fallback в tvplotlines-app: `ev.plotline || ev.storyline` чтобы старые данные не сломались.
-
-- [ ] **2. Merge Pass 0 в Pass 1.** Одним LLM call вместо двух. Тестировать отдельно.
-
-- [ ] **3. Pass 3: код vs LLM.** Какие verdicts детерминированные (MERGE по совпадению driver+goal, PROMOTE/DEMOTE по весам), какие требуют LLM (REASSIGN, CREATE). Тестировать code-only Pass 3.
-
-- [ ] **4. Bootstrapping примеров.** Pipeline → DC ловит ошибки → ошибки = негативные примеры в определениях, хорошие результаты = положительные примеры, кандидаты в few-shot для разных franchise types.
-
-- [ ] **5. CoT vs voting.** 1 прогон с CoT scaffold vs 3 прогона без CoT (текущий voting). Стоимость vs стабильность.
-
-- [ ] **6. Демо: подготовка к новым данным.**
-  - CSS для `fn-catalyst` и `fn-crisis` (новые event functions)
-  - Fallback `ev.plotline || ev.storyline`
-  - Показать franchise_type + format в toolbar
-  - Показать confidence в PlotlineDetail
-
-# _tpl-blog-post
-
-> One-paragraph hook: the engineering problem. No jargon.
-
-## The problem
-
-What goes wrong without formal structure. 3-5 sentences.
-
-## What the literature offers
-
-2-4 approaches, one paragraph each.
-
-## The bridge: from theory to pipeline
-
-How does this formal method become a prompt, a data model, or an algorithm?
-
-## Takeaway
-
-3-5 bullet points.
-
-## Further reading
-
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-event-functions.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-event-functions.md
deleted file mode 100644
index 3c033ad..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-v3-event-functions.md
+++ /dev/null
@@ -1,206 +0,0 @@
----
-type: note
-project: tvplotlines
-status: active
----
-
-# Autoresearch v3: Event Functions Redesign
-
-## Цель
-
-Внедрить новый набор event functions (7 функций вместо текущих 7) в промпт Pass 2 без деградации существующих метрик storyline quality.
-
-**Было:** setup, escalation, turning_point, climax, resolution, cliffhanger, seed
-**Стало:** setup, catalyst, escalation, turning_point, crisis, climax, resolution
-
-Полное описание изменений: `todo/event-functions-redesign.md`
-
-## Отличие от v1/v2
-
-| | v1 | v2 | v3 |
-|---|---|---|---|
-| Цель | Улучши метрику | Улучши метрику | Внедри изменения, не сломай метрику |
-| Свобода | Любые изменения | Любые изменения | Конкретные изменения, свобода в формулировках |
-| Метрика | ARI (consistency) | coh_sep (quality) | coh_sep (constraint) + function_score (goal) |
-| Датасет | 1 шоу | 12 шоу | 12 шоу (те же) |
-
-Ключевое отличие: v1/v2 = "делай что хочешь, улучши X". v3 = "внедри Y при условии что X не упадёт".
-
-## Новая метрика: function_score
-
-Автоматическая, без ground truth. Три компоненты:
-
-### 1. Arc completeness
-
-Для каждой storyline: сколько из 7 фаз присутствует.
-
-```python
-def arc_completeness(storyline_events):
-    functions = {e.function for e in storyline_events}
-    return len(functions) / 7
-```
-
-Ожидания по рангу (из `todo/event-functions-redesign.md`):
-- A: ≥ 6/7
-- B: ≥ 5/7
-- C: ≥ 3/7
-- runner: ≥ 1/7[^1]
-
-Метрика: доля storylines, достигших ожидаемого минимума.
-
-### 2. Arc order (monotonicity)
-
-Проверяем что арка не возвращается через milestone.[^2] Milestones: catalyst, turning_point, crisis, climax.
-
-```python
-WEIGHT = {"setup": 1, "catalyst": 2, "escalation": 3, "turning_point": 4, "crisis": 5, "climax": 6, "resolution": 1}
-MILESTONES = {"catalyst", "turning_point", "crisis", "climax"}
-
-def arc_order_score(storyline_events_sorted):
-    """1.0 if no return past milestone, penalty for each violation."""
-    max_milestone_weight = 0
-    violations = 0
-    for e in storyline_events_sorted:
-        w = WEIGHT[e.function]
-        if e.function in MILESTONES:
-            max_milestone_weight = max(max_milestone_weight, w)
-        elif w < max_milestone_weight - 1:  # return past milestone
-            violations += 1
-    return max(0, 1.0 - violations * 0.1)
-```
-
-### 3. Function distribution
-
-Каждый эпизод должен иметь разнообразие функций, не все escalation. [^3]
-
-```python
-def distribution_score(episode_events):
-    """Penalize episodes where >80% events have the same function."""
-    from collections import Counter
-    counts = Counter(e.function for e in episode_events)
-    max_pct = max(counts.values()) / len(episode_events)
-    return 1.0 if max_pct <= 0.8 else 0.5
-```
-
-### Комбинированная метрика[^4]
-```python
-function_score = mean(arc_completeness) * mean(arc_order_score) * mean(distribution_score)
-```
-
-## Constraint: существующие метрики
-
-```
-coh_sep >= baseline_coh_sep * 0.95  # не больше 5% деградации
-coverage >= 0.95                     # покрытие событий
-```
-
-Если constraint нарушен — revert, как в v1/v2.  [^5]
-
-## Что оптимизирует autoresearch
-
-### Обязательные изменения (внедрить в первом эксперименте) [^6]
-
-1. Заменить таблицу функций в Pass 2 промпте (EN + RU)
-2. Обновить `_VALID_FUNCTIONS` в `pass2.py`
-3. Обновить описания функций
-
-### Свободные варианты (autoresearch пробует)
-
-- Как описать catalyst — "trigger event", "inciting incident", "the thing that starts the storyline"?
-- Как описать crisis — "lowest point", "all is lost", "whiff of death"?
-- Сколько примеров давать для каждой функции?
-- Нужно ли добавить правило про порядок функций в арке?
-- Как описать отличие escalation от catalyst (оба "что-то происходит")?
-- Нужно ли упоминать Act 1/2/3 или оставить абстрактно? [^7]
-
-## Протокол
-
-### Фаза 0: Baseline
-
-1. Прогнать текущий pipeline на fast set (BB, SP, House, Lost)[^8] с текущими функциями [^9]
-2. Вычислить coh_sep и function_score (с маппингом старых функций на новые для сравнимости):[^10]
-   - cliffhanger → climax (ближайший аналог)
-   - seed → setup (ближайший аналог)
-3. Записать baseline
-
-### Фаза 1: Внедрение (1 эксперимент)
-
-1. Заменить функции в промптах + код
-2. Прогнать на fast set
-3. Проверить constraint (coh_sep ≥ baseline * 0.95)
-4. Если ок — keep. Если нет — начать фазу 2 с минимальных изменений.
-
-### Фаза 2: Оптимизация формулировок
-
-Стандартный autoresearch loop:
-1. Одно изменение в описании функции
-2. Прогон на fast set
-3. function_score улучшился И constraint не нарушен → keep
-4. Иначе → revert
-5. Повторять
-
-### Фаза 3: Валидация
-
-1. Прогнать лучший вариант на full set (12 шоу)
-2. Проверить что coh_sep не упал
-3. Проверить function_score на всех шоу
-4. Ручная проверка BB S01 — функции выглядят правильно?
-
-## Бюджет
-
-Fast set: ~$2-3 за прогон
-Фаза 0: 1 прогон = ~$3
-Фаза 1: 1 прогон = ~$3
-Фаза 2: ~20 экспериментов = ~$50-60
-Фаза 3: 1 прогон full set = ~$5
-**Итого: ~$65-70**
-
-## Что НЕ входит в v3
-
-- Модификаторы (cliffhanger, seed как модификаторы) — отдельная задача после v3
-- Post-processing фаз (группировка событий в фазы) — код, не autoresearch
-- Pass 3 обновление (arc validation) — после v3 стабилизируется
-- Визуализация — tvplotlines-app, не autoresearch
-- Фрактальная структура (3 уровня арок) — после v3
-
-## Файлы
-
-| Файл | Что менять |
-|------|-----------|
-| `src/tvplotlines/prompts_en/pass2.md` | Таблица функций + описания |
-| `src/tvplotlines/prompts/pass2.md` | То же, русский |
-| `src/tvplotlines/pass2.py` | `_VALID_FUNCTIONS` |
-| `src/tvplotlines/metrics.py` | Добавить `function_score` |
-| `src/tvplotlines/prompts_en/pass3.md` | Step 2 (arc checking) — после v3 |
-| `src/tvplotlines/prompts/pass3.md` | То же, русский — после v3 |
-
-## Связи
-
-- `todo/event-functions-redesign.md` — полное описание новых функций
-- `experiments/autoresearch/program-v2.md` — протокол v2 (template)
-- `experiments/bibliography-narrative-and-autoresearch.md` — литература
-- Papalampidi et al. (2019) — ближайшая академическая работа по turning point detection
-
-[^1]: what these are based on? any data? comon sense? if commonsense no good 
-	
-
-[^2]: and if it returns what it means? how do we know that it means that? is it bad or good? why would we need it 
-
-[^3]:  здесь я не понимаю это ты написал до того как мы выяснили что у нас фрактальная структура и у нас есть арка внутри эпизода и это не арка сезона и даже не арка линии а самый эпизод устроен ровный тех же семи шагов и ровно это арку эпизода и получаем в проте NOM паст точнее получаем мы в результате второго Пасса. Соответственно то что ты здесь пишешь для меня не имеет смысла. Объясни пожалуйста
-
-[^4]: я не понимаю что она меряет зачем меряет можешь каушика перечитать чтобы адекватнные придумывать решения а не декорации городить
-
-[^5]:  слушай по сути это черновик прото почему же ты его пишешь на таком годовом языке если LLM хорошо понимает разговорный язык и я человек тоже хорошо понимаю разговорный язык почему же ты не пишешь сразу черновик так как будет лучше понято и мною и моделью а пишешь вот это вот всё я понимаю если бы это был человек которым надо сначала представить структуру а потом только сочинение писать но ты-то можешь писать тексты которые читаются по-человечески а сохраняют все логические ну входы выходы формулы ну как вообще
-	 
-
-[^6]: 5 А куда делись эти все инструкции которые мы писали по 1 000 000 раз писать так чтобы человек без контекста мог писать как маме объяснять смысл ничто делать зачем где это всё ты как будто манкурт какой-то это невозможно читать просто вот что это ты написал
-
-[^7]: подробнее об этом о роли этих вопросоа? от роли зависит как они должны быть сформуоированы 
-
-[^8]:  А как определить минимальный набор с точки зрения стоимости каждого прогона чтобы получить максимальный результат это как ты мне можешь помочь определить
-	 
-
-[^9]:  А зачем мы будем это ещё раз сделать? Мы же уже прогнали с текущими функциями вот у нас есть результаты зачем нам ещё раз это делать объясни ну разве ты деньги мои потратить хочешь
-
-[^10]:  откуда эти показатели где мы взяли это тук-тук-тук тут существует это такое
-	 
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-hybrid-vs-procedural.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-hybrid-vs-procedural.md
deleted file mode 100644
index 1dee6f3..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-v3-hybrid-vs-procedural.md
+++ /dev/null
@@ -1,22 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# Autoresearch v3: уточнить разницу hybrid vs procedural
-
-## Проблема
-
-В глоссарии разница читается нормально:
-- **Procedural**: self-contained story per episode
-- **Hybrid**: case-of-week + serialized arcs
-
-Но в промпте pass0 граница размыта — procedural тоже может иметь serialized B-storylines (House: cases + House/team dynamics). Когда шоу перестаёт быть procedural и становится hybrid?
-
-## Что проверить
-
-- [ ] Как pass0 присваивает franchise_type на реальных шоу — есть ли ошибки hybrid↔procedural?
-- [ ] Найти в литературе (Nash, Douglas, Mittell) чёткий критерий: что делает шоу hybrid, а не procedural с B-arc?
-- [ ] Возможный критерий: в procedural serialized arcs — фон (character development), в hybrid — serialized arc является полноценным двигателем сюжета наравне с case-of-week
-- [ ] Обновить промпт pass0 с более чётким разграничением
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-plan.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-plan.md
deleted file mode 100644
index 38137d6..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-v3-plan.md
+++ /dev/null
@@ -1,165 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# Autoresearch v3: план исследования
-
-Черновик v3. Техническая оптимизация — отдельный документ (`tvplotlines-autoresearch-v3-engineering.md`).
-
-Статус: `[ ]` — не начато, `[~]` — в процессе, `[x]` — сделано.
-
----
-
-## Что мы хотим показать
-
-LLM обучена на огромном количестве текстов. Она «знает» про персонажей, конфликты, жанры — но это знание лежит внутри неё неорганизованно, как куча инструментов в коробке без отделений. Без внешней помощи LLM берёт первый попавшийся инструмент: пересказывает, стилизует, выдаёт поверхностные наблюдения. Она не задаёт себе вопросы «зачем персонаж так поступил?» или «почему авторы построили историю именно так?» — потому что ей никто не сказал, что нужно их задавать.
-
-tvplotlines даёт LLM то, чего у неё нет: **нарратологический опыт**, упакованный в промпты. У человека-читателя этот опыт копится годами — из жизни, из прочитанных книг, из обсуждений. LLM этого опыта не имеет. Промпты tvplotlines — это не инструкции «сделай X». Это **рамка мышления**, которая переключает LLM из режима пересказа в режим анализа:
-
-- **Тип сериала** (procedural / serial / ensemble) переключает стратегию анализа целиком. Когнитивные психологи (Zwaan 1993) показали, что человек-читатель делает то же самое: увидев жанровый ярлык, он меняет то, на что обращает внимание. Детектив → ищем улики. Мелодрама → следим за отношениями. tvplotlines делает это для LLM.
-
-- **Четыре поля конфликта** (hero — кто движет действие, goal — чего хочет, obstacle — что мешает, stakes — что на кону) заставляют LLM перейти от пересказа «что случилось» к анализу «зачем персонаж так поступил». Bruner (1991) показал: любая история — это всегда про чьи-то намерения. Без этих вопросов LLM не задумывается о намерениях — просто перечисляет события.
-
-- **Функции событий** (setup, escalation, turning point, climax, resolution), **ранг линий** (A/B/C), **взаимодействия между линиями** (тематическая рифма, драматическая ирония) — это уровень авторского замысла. Не «что произошло в мире сериала», а «как авторы построили историю». Zwaan (1993) назвал это pragmatic model и предложил как идею, но ни он, ни кто-то другой не формализовал за 30 лет.
-
-Мы хотим проверить, играет ли каждый из этих элементов scaffold'а конкретную роль, и действительно ли без него LLM производит результат принципиально иного качества.
-
-### Три типа интеллекта в одном pipeline
-
-tvplotlines — не «LLM + промпт». Это три компонента, каждый делает то, в чём надёжен:
-
-- **Код** (валидация JSON, проверка ссылок, подсчёт span и weight) — детерминированный, не ошибается в арифметике и структуре. Как таблица Менделеева: сама не решает, но без неё химик наделает ошибок.
-
-- **Промпты** (определения, таксономии, примеры) — нарратологическое знание, упакованное в вопросы. Как опытный редактор: не пишет сам, но задаёт правильные вопросы.
-
-- **LLM** — гибкий решатель, способный к выводам и интерпретации. Но без scaffold'а остаётся на уровне пересказа.
-
----
-
-## Фаза 0: Инфраструктура
-
-- [ ] **1. Метрики для оценки.**
-
-  **Решение (2026-03-23):** отказываемся от coverage × ARI в пользу эмбеддинг-метрик.
-
-  - **Coverage** — бессмысленна: код детерминированно назначает все события, всегда 1.0.
-  - **ARI (consistency)** — измеряет стабильность, не качество. Стабильно плохой результат = ARI 1.0. Prescriptive vocabulary (12 слов) давал ARI 1.000, но это был овerfitting под один сериал.
-  - **Gold standard (V-measure, B-cubed, NMI)** — отвергнуто: нет "правильного" набора сюжетных линий, два эксперта разметят по-разному.
-
-  **Новая метрика:**
-  - **score = silhouette** — одно число для autoresearch (sklearn, выше = лучше). Эмбеддинги событий, насколько события внутри линии ближе друг к другу, чем к чужим линиям.
-  - **coherence** (средняя внутрилинейная похожесть) + **separation** (средняя межлинейная похожесть) — логируем в results.tsv для диагностики. Silhouette = их комбинация в одно число.
-
-  Нужно: выбрать эмбеддинг-модель (sentence-transformers / OpenAI / Voyage), реализовать в metrics.py.
-
-- [ ] **2. Базовый уровень.** Посчитать все метрики на 13 существующих результатах. Эти числа — точка отсчёта, с которой сравниваем всё последующее.
-
-- [ ] **3. Разделение данных + бюджет.** 9 сериалов для экспериментов (по 2-3 от каждого типа: процедурал, сериал, гибрид, ансамбль), 4 — отложить для финальной проверки (модель их не видела при оптимизации). Ориентировочный бюджет: ~$50-100 на все эксперименты.
-
-## Фаза 1: Что LLM умеет без нас
-
-Прежде чем улучшать scaffold, нужно понять: что LLM делает сама, без наших промптов? Где граница между её собственными знаниями и тем, что даёт scaffold?
-
-- [ ] **4. LLM без scaffold.** Дать модели синопсисы Breaking Bad S01 и попросить: «дай основные сюжетные линии сериала.» Без каких-либо шаблонов, определений, примеров. Цель — не «доказать что без промптов плохо», а **увидеть**, что LLM делает по умолчанию: видит ли персонажей? Замечает ли конфликты? Или уходит в стилистический пересказ?
-
-- [ ] **5. Три уровня scaffold (главный эксперимент).**
-
-  Один и тот же вход (синопсисы Breaking Bad S01). Три разных промпта:
-
-  **A — без scaffold.** «Проанализируй нарративную структуру.» Предсказание: LLM перескажет события, может назвать персонажей, но не объяснит мотивации и не покажет структуру арок.
-
-  **B — минимальный scaffold.** «Извлеки сюжетные линии. Для каждой укажи: кто движет действие, чего хочет, что мешает.» Без типа сериала, без ранга, без функций событий, без примеров. Предсказание: появятся мотивации и конфликты (уровень «зачем персонаж так поступил»), но без структуры авторского замысла.
-
-  **C — полный scaffold (tvplotlines).** Тип сериала + четыре поля конфликта + ранг + функции событий + пример. Предсказание: и мотивации, и авторский замысел (какие линии главные, как они взаимодействуют, какие приёмы использованы).
-
-  Разница A→B покажет, что минимальный scaffold переключает LLM из режима пересказа в режим анализа мотиваций. Разница B→C покажет, что полный scaffold добавляет уровень авторского замысла.
-
-  Проводим на 5 сериалах разных типов (не только Breaking Bad), чтобы результат был не случайным.
-
-- [ ] **6. Ablation: убираем по одному компоненту.**
-
-  Берём полный scaffold и убираем из него один элемент. Для каждого — предсказание записано **до** эксперимента. Если предсказание совпало — теория подтверждена. Если нет — теория нуждается в коррекции. Оба результата полезны.
-
-**Тип сериала.** Зачем: переключает стратегию анализа целиком. Без него: в процедуралах побочные линии получат завышенный ранг, в сериалах будут пропущены эпизодические линии, количество линий выйдет за норму.
-
-**Четыре поля конфликта.** Зачем: переключают LLM из режима пересказа в режим анализа мотиваций. Без них: линии станут описательными («расследование Хэнка») без объяснения что им движет и что мешает.
-
-**Ранг.** Зачем: заставляет различать вес линий. Без него: все линии будут выглядеть равноценными, исчезнет иерархия A/B/C.
-
-**Функции событий.** Зачем: заставляют видеть структуру арки. Без них: события перечислены списком, без различия «завязка / кульминация / развязка».
-
-## Фаза 2: Эксперименты
-
-- [ ] **7. Разные «культуры» анализа.** Один сериал, два набора промптов: (a) голливудский story editor (текущий tvplotlines — определения из Nash, Douglas), (b) академический нарратолог (определения из Genette, Propp). Предсказание: разные промпты дадут разные интерпретации одного материала. Это покажет, что промпты — не нейтральные инструкции, а **рамка**, через которую LLM смотрит на материал. Идея — из работы Winston (2014): его система Genesis читала одну историю с разных «культурных» предустановок и получала разные интерпретации.
-
-- [ ] **8. Конкретные vs абстрактные формулировки.** Два варианта определений: (a) абстрактный — «определите obstacle», (b) конкретный — «что именно мешает этому персонажу получить то, что он хочет?». Предсказание: конкретные формулировки дают более точные результаты, потому что они ближе к тому, как люди думают о конфликтах.
-
-- [ ] **9. Объяснения «почему» в определениях.** Два варианта: (a) без объяснения — «franchise type: procedural / serial / hybrid / ensemble», (b) с объяснением — «тип сериала определяет стратегию анализа: procedural означает, что каждый эпизод содержит самостоятельную историю, поэтому ищем дело-недели и фоновые арки». Предсказание: объяснение «зачем это нужно» улучшает результат, потому что LLM, как и человек, лучше следует инструкции, если понимает её цель (AlKhamissi 2024).
-
-- [ ] **10. Русские промпты на русских сериалах.** Слово пацана, Метод, Мажор: русский vs английский промпт на одних и тех же синопсисах. Гипотеза (AlKhamissi 2024): язык промпта активирует культурные знания модели. Русский промпт может лучше справиться с русскими реалиями.
-
-- [ ] **11. Сравнение моделей.** Один промпт на 2-3 моделях (Claude, GPT-4, Gemini). Если scaffold работает только с одной моделью — он недостаточно универсален. Если работает со всеми — это аргумент за то, что дело в scaffold'е, а не в особенностях конкретной модели.
-
-- [ ] **12. Поля, которые сейчас не используются downstream.** Для каждого (format, devices, interactions, confidence, patches) — определить теоретическую роль и проверить ablation'ом.
-
-**format** — ограничение на ожидания от финала (limited → арки должны завершиться). Downstream: валидация арок.
-
-**devices** — как автор показывает (flashback, dramatic irony) — уровень авторского замысла. Downstream: визуализация, анализ стиля.
-
-**interactions** — связи между линиями — тоже авторский замысел. Downstream: визуализация структуры.
-
-**confidence** — где pipeline уверен, а где угадывает. Downstream: решения Pass 3, приоритизация ручной проверки.
-
-**patches** — где pipeline видит проблему в собственных результатах. Downstream: диагностика.
-
-- [ ] **13. Что в промпте, а что в коде.** Составить полный список правил, которые сейчас есть в промптах и/или в коде. Для каждого решить: определения и нарратологическое знание → промпт. Проверка структуры (JSON schema, ссылки, арифметика) → код. Исследование Qiu (2025) показало, что проверка кодом эффективнее, чем правила в промпте (+11.7 пунктов vs +1.1).
-
-## Фаза 3: Переписывание промптов (после фаз 1-2)
-
-- [ ] **14. Переписать промпты на основе результатов.** Принципы:
-  - Не объясняй модели базовые вещи (что такое «персонаж» или «конфликт» — она это знает). Объясняй **нашу систему координат** — чем наше определение driver отличается от того, что модель понимает по умолчанию.
-  - Конкретные формулировки вместо абстрактных (по результатам шага 8).
-  - Объяснения «зачем» для каждого определения (по результатам шага 9).
-  - Определения с примерами (подход GoLLIE, Sainz 2024).
-  - Структурные constraints перенести в код.
-
-- [ ] **15. Тест переписанных промптов.** Прогнать на тренировочном наборе, сравнить с базовым уровнем. Если какая-то метрика упала больше чем на 5% — откатить конкретное изменение и тестировать его отдельно.
-
-- [ ] **16. Reasoning trace в примерах.** Добавить в few-shot пример цепочку рассуждений перед JSON-ответом (подход Chain-of-Thought, Wei 2022). Тестировать отдельно от переписывания, чтобы изолировать эффект.
-
-- [ ] **17. Финальная проверка.** Прогнать на 4 отложенных сериалах, которых pipeline не видел при оптимизации.
-
----
-
-## Что подтверждает каждый эксперимент
-
-| Эксперимент | Что покажет |
-|------------|------------|
-| LLM без scaffold (шаг 4) | Что LLM знает о нарративах, но не организует это знание без помощи |
-| Три уровня scaffold (шаг 5) | Что scaffold переключает LLM с пересказа на анализ мотиваций, а полный scaffold добавляет уровень авторского замысла |
-| Ablation с предсказаниями (шаг 6) | Что каждый компонент scaffold играет конкретную роль |
-| Разные «культуры» (шаг 7) | Что промпты — не нейтральные инструкции, а рамка мышления |
-| Конкретные vs абстрактные (шаг 8) | Какие формулировки эффективнее |
-| Объяснения «зачем» (шаг 9) | Что объяснение цели инструкции улучшает результат |
-| Русские промпты (шаг 10) | Что язык scaffold влияет на качество для культурно-специфичного материала |
-| Сравнение моделей (шаг 11) | Что scaffold работает не только с одной моделью |
-
-## Источники
-
-| Идея | Откуда | Что говорит |
-|------|--------|------------|
-| Человек переключает стратегию чтения в зависимости от жанра | Zwaan 1993 | Жанровый ярлык активирует cognitive control system — фильтр, определяющий, на что обращать внимание |
-| Любая история — про чьи-то намерения | Bruner 1991 | Без моделирования намерений нет понимания нарратива, только пересказ |
-| Вопрос меняет интерпретацию | Winston 2014 | Система Genesis не видела связь, пока её не спросили — тогда знание активировалось |
-| LLM — «мешок эвристик», а не модель мира | Mitchell 2025 | LLM отслеживает «кто что делает», но не понимает «зачем» без помощи |
-| AI чужд людям, нужно enculturation | Riedl 2016, 2019 | AI без понимания социальных норм и мотиваций — «инопланетный разум» |
-| LLM предпочитает стиль структуре | Jung 2026 | Без scaffold LLM «украшает» текст вместо анализа |
-| Язык промпта активирует культурные знания | AlKhamissi 2024 | LLM по умолчанию воспроизводит ценности англоязычной культуры |
-| Проверка кодом эффективнее правил в промпте | Qiu 2025 (Blueprint First) | +11.7 пунктов vs +1.1 |
-| Reasoning перед ответом улучшает результат | Wei 2022 (Chain-of-Thought) | «Let's think step by step» переключает режим обработки |
-| Определения с примерами — ключевой компонент | Sainz 2024 (GoLLIE) | Модель лучше следует определениям, если видит примеры |
-| Конкретные шаги лучше общей инструкции | Wang 2023 (Plan-and-Solve) | «Devise a plan, then carry out the plan» |
-| Одно изменение за раз при оптимизации | Opsahl-Ong 2024 (MIPRO) | Greedy credit assignment — иначе не понять что помогло |
-| Метрики для сравнения результатов | Ferguson 2026 (ExtractBench) | Per-field evaluation + semantic matching |
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-questions.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-questions.md
deleted file mode 100644
index f221f7f..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-v3-questions.md
+++ /dev/null
@@ -1,146 +0,0 @@
----
-title: "Autoresearch v3: все вопросы и задачи"
-type: note
-status: active
-project: tvplotlines
----
-
-# Autoresearch v3: вопросы и задачи
-
-Сводный документ. Каждая задача — из конкретного источника (статья или ревью промптов). Ссылки на заметки где идея обоснована.
-
-Статус: `[ ]` — не начато, `[?]` — нужно обсудить, `[x]` — решено.
-
----
-
-## 1. Pipeline architecture
-
-Источник: [Blueprint First](blueprint-first-qiu-2025.md) — tool consolidation, DC > всё остальное.
-
-- [ ] **Merge Pass 0 → Pass 1**: нужен ли Pass 0 отдельно? Экономия 1 LLM call. Уже пробовали (pass1_merged), откатили — но причины отката неясны, нужно перепроверить.
-- [ ] **Pass 3: LLM или код?** Какие verdicts можно вычислить детерминированно (MERGE по совпадению driver+goal, PROMOTE/DEMOTE по весам), какие требуют LLM суждения (REASSIGN, CREATE)?
-- [ ] **Длина промптов в tokens**: если >4K — "lost in the middle" реальна (Qiu, p.7), DC критичен.
-
-## 2. Code validation (Double Check)
-
-Источник: [Blueprint First](blueprint-first-qiu-2025.md) — DC даёт +11.7pp, мощнее структуры промпта.
-
-- [ ] **Список дублирующихся constraints**: что сейчас и в промпте, и в коде? Составить полный список, убрать из промптов.
-- [ ] **Усилить DC**: какие проверки код сейчас НЕ делает, но мог бы? (arc order, Story DNA completeness, naming convention)
-- [ ] **Re-request формат**: как сейчас выглядит сообщение об ошибке при re-request? Достаточно ли конкретное?
-
-## 3. Prompt structure (Blueprint First)
-
-Источник: [Blueprint First](blueprint-first-qiu-2025.md) — WHAT vs HOW; [ревью промптов](../../notes%20for%203rd%20autoresearch.md) — 60 замечаний.
-
-- [ ] **Единый скелет**: ROLE → DEFINITIONS → INPUT → TASK → OUTPUT → EXAMPLE. Применить ко всем 4 промптам.
-- [ ] **Убрать meta-комментарии**: "compiled from reference.md", "recompile from ADR-005", "result shown to human", цитаты с номерами страниц.
-- [ ] **Убрать HOW из промптов**: "If code detects an error — re-request" — это для кода, не для LLM.
-- [ ] **Одно определение — одно место**: не повторять, не противоречить. Contract и Input — объединить.
-
-## 4. Definitions (глоссарий → промпты)
-
-Источник: [ревью промптов](../../notes%20for%203rd%20autoresearch.md) — проблема 2 (глоссарий ≠ промпты); ожидается [GoLLIE](gollie-sainz-2024.md) — как форматировать определения.
-
-- [ ] **Глоссарий = ground truth**: franchise types, plotline, Story DNA, plot-led/character-led — брать из глоссария дословно.
-- [ ] **Цепочка Franchise Type → Story Engine → Story DNA**: есть в глоссарии, нет в промптах. Включить.
-- [ ] **Терминология**: `plotline` везде (не `storyline`). Проверить что не ломает extraction.
-- [ ] **Story DNA**: либо использовать везде как шортхэнд (с определением один раз), либо выкинуть. Сейчас — ни то ни другое.
-- [ ] **Logline test vs Story DNA**: test = 3 части (hero+goal+obstacle), DNA = 4 (+ stakes). Привести в соответствие.
-
-## 5. Мусорные поля и концепции
-
-Источник: [ревью промптов](../../notes%20for%203rd%20autoresearch.md) — проблема 3; нужна ablation чтобы решить.
-
-- [?] **format** (ongoing/limited/anthology): зачем? franchise type достаточно? Ablation: убрать → метрики изменились?
-- [?] **narrative devices**: зачем собираем? на что влияют? используются ли downstream? Ablation: убрать → ?
-- [?] **confidence**: где объясняется? как работает?
-- [?] **interactions**: зачем? где используются? Ablation: убрать → ?
-- [?] **patches**: что делают? нужны ли если усилить DC?
-- [?] **weight** (primary/background/glimpse): определение есть только в глоссарии, не в промпте.
-- [?] **episodic как тип**: не общепринятый термин. Замена?
-- [?] **"Seed and wraparound — not storyline types"**: зачем constraint на несуществующую проблему?
-
-## 6. Event functions
-
-Источник: [autoresearch-v3-event-functions.md](autoresearch-v3-event-functions.md), [event-functions-redesign.md](event-functions-redesign.md), глоссарий.
-
-- [ ] **Заменить таблицу функций в Pass 2**: cliffhanger/seed → catalyst/crisis. Глоссарий уже содержит правильные 7 функций.
-- [ ] **Описания функций**: как описать catalyst vs escalation? crisis vs climax? Нужны точные формулировки.
-- [ ] **Constraints по порядку**: какие функции после каких не могут быть? Какие могут повторяться? В код или в промпт?
-- [ ] **Все ли events имеют функцию?** Должны — но бывает всякое.
-
-## 7. Few-shot examples
-
-Источник: [CoT — Wei et al.](cot-wei-2022.md) — reasoning trace в примерах; ожидаются [DSPy](dspy-khattab-2024.md), [MIPRO](mipro-opsahl-ong-2024.md) — автоматический подбор примеров.
-
-- [ ] **Добавить reasoning trace в BB пример**: почему эти линии, почему такие ранги. Reasoning ДО JSON, не после.
-- [ ] **1 прогон с CoT vs 3 прогона без (voting)**: что стабильнее? что дешевле?
-- [ ] **Релевантные примеры по franchise type**: hybrid → пример из House, ensemble → из GoT. Сейчас везде BB (serial).
-- [ ] **Сколько примеров**: 1 (сейчас) vs 2-3 (three-shot). Стоимость vs качество.
-- [ ] **Bootstrapping примеров из собственных ошибок** (GoLLIE + DSPy): прогнать pipeline → код (DC) ловит ошибки (линии без obstacle, дубликаты, неправильные ранги) → ошибки становятся негативными примерами в определениях, удачные результаты → положительными. Скрипт, не фреймворк.
-
-## 8. Prior season continuity
-
-Источник: [ревью промптов](../../notes%20for%203rd%20autoresearch.md) — P1 замечания по prior_season.
-
-- [?] **TRANSFORMED**: бывает ли в реальности? Есть ли в теории (Nash, Douglas)?
-- [?] **ENDED**: что помечаем если линии нет? Логика непонятна.
-- [ ] **Откуда берётся prior_season**: объяснить в промпте или убрать из промпта (код инжектирует).
-
-## 9. Metrics и evaluation
-
-Источник: ожидается [ExtractBench](extractbench-ferguson-2026.md) — метрики для nested JSON.
-
-- [ ] **Baseline по существующим 13 результатам**: coverage, ARI, + что ещё?
-- [ ] **Как сравнивать два JSON** (старый промпт vs новый): per-field? semantic matching для массивов?
-- [ ] **LLM-as-judge**: чеклист для оценки результата (Story DNA complete? ранги соответствуют весам? дубликатов нет?)
-- [ ] **function_score** (arc completeness + order + distribution): формулу нужно пересмотреть с учётом фрактальной арки.
-
-## 10. Autoresearch method
-
-Источник: ожидаются [OPRO](opro-yang-2023.md), [TextGrad](textgrad-yuksekgonul-2024.md), [MIPRO](mipro-opsahl-ong-2024.md).
-
-- [ ] **Метод оптимизации**: OPRO vs TextGrad vs ручной A/B — что подходит для наших промптов?
-- [ ] **Train/test split**: 8 шоу train, 4 test? Или иначе? По franchise type?
-- [ ] **Новые сериалы**: нужны ли для test set шоу которых pipeline никогда не видел?
-- [ ] **Бюджет**: сколько прогонов, сколько стоит каждый, общий лимит.
-- [ ] **Ablation study**: убирать компоненты по одному (format, devices, interactions, Pass 0, Pass 3) и замерять.
-
-## 11. Structured reasoning (CoT/ToT/GoT)
-
-Источник: [CoT — Wei et al.](cot-wei-2022.md), [ToT — Yao et al.](tot-yao-2023.md), [GoT — Besta et al.](got-besta-2024.md).
-
-### Что применимо без натяжек
-
-**CoT → reasoning trace в few-shot примерах** (конкретная задача):
-- [ ] Добавить reasoning ДО JSON в BB пример для всех промптов. Wei доказал: reasoning до ответа улучшает, после — нет.
-- [ ] Сравнить: 1 прогон с CoT-примером vs 3 прогона без (voting/CoT-SC). Если 1 с CoT ≥ 3 без — экономия 3x.
-
-**GoT → формализация pipeline для preprint** (не код, а описание):
-- [ ] Наш pipeline = GoT pattern: Generate (Pass 1) → Decompose per episode (Pass 2) → Aggregate + Refine (Pass 3). Нарисовать GoO diagram.
-- [ ] Сослаться на GoT framework (Besta) и Blueprint First (Qiu) как формальные основания архитектуры.
-
-### Что снято (не обосновано)
-
-- ~~ToT для замены 3x voting~~ — наша задача extraction, не search. ToT решает задачи с backtracking (Game of 24, кроссворды), у нас нет дерева вариантов.
-- ~~ToT generate plans → vote → fill~~ — спекуляция, нет оснований что это лучше текущего подхода.
-- ~~GoT decomposition для Pass 1 (по персонажам)~~ — усложнение без доказанной пользы.
-
-### Полезно для понимания
-
-Yao (Figure 1) формализовал наш 3x voting как CoT-SC. Это даёт точный язык: мы знаем что делаем, знаем ограничения (CoT-SC не помогает если ошибка систематическая, а не случайная).
-
----
-
-## Порядок работы (черновик, уточнится после чтения статей)
-
-1. Baseline по 13 существующим результатам
-2. Ablation: убирать мусорные поля по одному, замерять
-3. Структурный рефакторинг промптов (Blueprint First скелет)
-4. Определения из глоссария
-5. Терминология (plotline)
-6. Event functions
-7. CoT в примерах
-8. Autoresearch loop по формулировкам
-9. Валидация на test set
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-reading-plan.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-reading-plan.md
deleted file mode 100644
index 69c6e40..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-v3-reading-plan.md
+++ /dev/null
@@ -1,169 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# План чтения статей для autoresearch v3
-
-Мы проектируем autoresearch для переписывания промптов tvplotlines. Прежде чем писать план, нужно прочитать 7 статей. Ниже — что искать в каждой, какие вопросы закрыть, и в каком порядке читать.
-
-## Порядок чтения
-
-Читать в этом порядке — каждая следующая опирается на предыдущие.
-
----
-
-### 1. GoLLIE (уже в Zotero, помечена `2read`)
-
-**Что это:** Annotation guidelines в промпте улучшают zero-shot information extraction.
-
-**Ссылка:** В Zotero, key `XBVCW78U`. Или: https://arxiv.org/abs/2310.03668
-
-**Зачем нам:** Это прямо про наш случай — мы даём LLM определения (franchise type, plotline, Story DNA) и ожидаем что она по ним извлекает структуру. GoLLIE показывает как правильно формулировать эти определения чтобы extraction работал лучше.
-
-**Что искать:**
-- Как они форматируют annotation guidelines? Есть ли у них "шаблон" определения?
-- Как измеряют качество? Какие метрики для IE?
-- Помогает ли давать негативные примеры ("что NOT является X")?
-- Влияет ли порядок определений на качество?
-
-**Какой вопрос закрывает:** как правильно написать секцию DEFINITIONS в наших промптах (Blueprint First). Как определения из глоссария переводить в формат промпта.
-
----
-
-### 2. Blueprint First, Model Second (Qiu et al., 2025)
-
-**Ссылка:** https://arxiv.org/abs/2508.02721
-
-**Зачем нам:** Формализует то что tvplotlines уже делает (pipeline с code validation), но может подсказать как сделать лучше. Принцип: код решает workflow, LLM только для bounded subtasks.
-
-**Что искать:**
-- Как они структурируют "Execution Blueprint"? Есть ли формат/шаблон?
-- Какие subtasks отдают LLM, какие — коду? Есть ли критерий разделения?
-- Как обрабатывают ошибки LLM? Retry? Fallback?
-- Сравнение с подходом "дать LLM всю задачу целиком" — на сколько лучше modular?
-
-**Какой вопрос закрывает:** что из наших промптов нужно вынести в код (validation rules, constraints, ранжирование по весам). Какая архитектура промпта оптимальна.
-
----
-
-### 3. DSPy (Khattab et al., ICLR 2024)
-
-**Ссылка:** https://arxiv.org/abs/2310.03714
-
-**Зачем нам:** Идея "промпт = компилируемая программа с сигнатурой". Мы не будем использовать DSPy фреймворк напрямую, но концепция composable modules + automatic optimization релевантна.
-
-**Что искать:**
-- Формат "signature" — как описывают вход/выход модуля? Можем ли адаптировать для наших Pass?
-- Как работает оптимизация инструкций? Что именно оптимизируется — текст, примеры, оба?
-- Multi-stage pipeline — как модули связываются? Как результат одного модуля передаётся другому?
-- Метрики — как DSPy оценивает качество pipeline?
-
-**Какой вопрос закрывает:** можно ли автоматически подбирать few-shot примеры для каждого Pass. Как формализовать контракт между пассами.
-
-**Внимание:** статья длинная и техническая. Можно ограничиться секциями 1-3 (концепция) + 5 (эксперименты). Детали реализации (секция 4) — по желанию.
-
----
-
-### 4. MIPRO (EMNLP 2024) — оптимизатор DSPy
-
-**Ссылка:** https://arxiv.org/abs/2406.11695
-
-**Зачем нам:** Конкретный алгоритм оптимизации для multi-stage pipeline. Оптимизирует инструкции + few-shot примеры совместно. Ближе всего к тому что нам нужно.
-
-**Что искать:**
-- Как работает "grounded proposal" — LLM видит код программы + данные + traces и предлагает инструкции?
-- Сколько прогонов нужно для оптимизации? Какой бюджет?
-- Как они решают проблему "оптимизирую один модуль — ломаю другой"?
-- Результаты на multi-stage задачах — насколько улучшение vs human-written?
-
-**Какой вопрос закрывает:** сколько будет стоить autoresearch (количество прогонов). Как избежать ситуации "поправил Pass 1 — сломал Pass 2".
-
-**Совет:** читать после DSPy, иначе контекст будет непонятен.
-
----
-
-### 5. OPRO (DeepMind, 2023)
-
-**Ссылка:** https://arxiv.org/abs/2309.03409
-
-**Зачем нам:** Самый простой подход к оптимизации промптов. LLM видит прошлые варианты + их scores, генерирует новый вариант. Можем использовать для оптимизации формулировок определений (как описать catalyst, crisis и т.д.).
-
-**Что искать:**
-- Формат "meta-prompt" — как подаётся история попыток?
-- Работает ли на длинных промптах или только на коротких инструкциях?
-- Сколько итераций до сходимости?
-- Ограничения — где не работает?
-
-**Какой вопрос закрывает:** подходит ли OPRO для оптимизации описаний event functions (catalyst, crisis) или нужно что-то сложнее.
-
----
-
-### 6. TextGrad (Stanford→Nature, 2024)
-
-**Ссылка:** https://arxiv.org/abs/2406.07496
-
-**Зачем нам:** "Текстовые градиенты" — LLM даёт текстовый feedback на результат, этот feedback используется для улучшения компонентов. Идея: прогнали pipeline → LLM-judge говорит "storyline X выглядит как дубликат Y" → этот feedback корректирует промпт.
-
-**Что искать:**
-- Как работает "backpropagation" через текст? Как feedback от конца pipeline доходит до начала?
-- Можно ли оптимизировать отдельные секции промпта, а не весь?
-- Сравнение с OPRO — когда лучше TextGrad, когда OPRO?
-- Примеры оптимизации промптов (не только кода/молекул)
-
-**Какой вопрос закрывает:** можно ли использовать LLM-as-judge не просто как scorer (хорошо/плохо), а как источник конкретных правок ("в определении catalyst не хватает X").
-
----
-
-### 7. ExtractBench (KDD 2026)
-
-**Ссылка:** https://arxiv.org/abs/2602.12247
-
-**Зачем нам:** Бенчмарк для structured extraction в JSON. Показывает что ширина схемы (количество полей) — главный предиктор провала. Метрики для оценки nested extraction.
-
-**Что искать:**
-- Какие метрики они используют для сравнения extracted JSON с ground truth?
-- "Semantic array matching" — как сравнивают массивы (у нас events[], plotlines[])?
-- Как обрабатывают null и отсутствующие поля?
-- Рекомендации по размеру схемы — сколько полей нормально?
-
-**Какой вопрос закрывает:** какие метрики использовать в autoresearch для оценки качества извлечения. Как сравнивать два JSON результата (старый промпт vs новый).
-
----
-
-## Опциональное чтение
-
-### Survey of Automatic Prompt Optimization (уже в Zotero, помечена `read`)
-Key `KDKFV7TA`. Если не помнишь — пролистать ещё раз чтобы убедиться что мы не упускаем подходы кроме OPRO/TextGrad/MIPRO.
-
-### Narrative Trails (уже в Zotero, 7 дубликатов — нужно мержить)
-Coherent storyline extraction via maximum capacity path optimization. Другой подход к нашей задаче — graph-based вместо LLM. Интересно сравнить, но не блокирует autoresearch.
-
----
-
-## Чеклист: что нужно закрыть после чтения
-
-После прочтения у нас должны быть ответы на:
-
-- [ ] **Формат определений в промпте** — как правильно писать секцию DEFINITIONS (из GoLLIE)
-- [ ] **Что вынести в код** — конкретный список constraints/validations для выноса из промптов (из Blueprint First)
-- [ ] **Контракт между пассами** — как формализовать вход/выход каждого Pass (из DSPy)
-- [ ] **Стоимость autoresearch** — сколько прогонов нужно, какой бюджет закладывать (из MIPRO)
-- [ ] **Метод оптимизации** — OPRO vs TextGrad vs ручной A/B — что подходит для наших промптов
-- [ ] **Метрики** — как сравнивать JSON результаты старого и нового промпта (из ExtractBench)
-- [ ] **Few-shot стратегия** — один пример (BB) vs несколько vs подбор по franchise type (из DSPy/MIPRO)
-
----
-
-## Где статьи
-
-| # | Статья | Где взять |
-|---|--------|-----------|
-| 1 | GoLLIE | Zotero (`2read`) или arxiv 2310.03668 |
-| 2 | Blueprint First | arxiv 2508.02721 |
-| 3 | DSPy | arxiv 2310.03714 |
-| 4 | MIPRO | arxiv 2406.11695 |
-| 5 | OPRO | arxiv 2309.03409 |
-| 6 | TextGrad | arxiv 2406.07496 |
-| 7 | ExtractBench | arxiv 2602.12247 |
diff --git a/docs/knowledge/archive/autoresearch/autoresearch-v3-todo.md b/docs/knowledge/archive/autoresearch/autoresearch-v3-todo.md
deleted file mode 100644
index 3e8853c..0000000
--- a/docs/knowledge/archive/autoresearch/autoresearch-v3-todo.md
+++ /dev/null
@@ -1,101 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
-date: 2026-03-23
----
-
-# Autoresearch v3: план работы
-
-Рецензия: [[tvplotlines-autoresearch-v3-engineering-review]]
-Эвристики: [[tvplotlines-heuristics-from-theory]]
-
----
-
-## Фаза 1: Подготовка (чтение + решения)
-
-Бриф для чтения учебников: [[tvplotlines-screenwriting-theory-reading-prompt]]
-
-- [x] Прочитать GoLLIE (формат определений в промпте) → [[read-sainz-2024-gollie]]
-- [x] Прочитать Blueprint First (что вынести в код) → [[read-qiu-2025-blueprint-first]]
-- [x] Прочитать ExtractBench (метрики для JSON extraction) → [[read-ferguson-2026-extractbench]]
-- [ ] Верифицировать event functions по каноническим источникам
-	- [x] Сравнить наши 7 с Nash, McKee, Netflix/Kessler — маппинги записаны в заметках (read-nash, read-mckee, read-oberg, read-freytag)
-	- [ ] **Зафиксировать решение:** сколько функций (5? 7?), какие именно, на основе какого источника. Предыдущий кандидат в [[tvplotlines-event-functions-redesign]]: 7 (setup, catalyst, escalation, turning_point, crisis, climax, resolution). Seed/cliffhanger → модификаторы. Нужно подтвердить или пересмотреть
-	- [ ] Записать маппинг в глоссарий
-- [x] Набрать эвристики порядка функций из учебников → Nash: строгий порядок, гибкий тайминг. Escalation после turning_point нормально (Bad Guys Close In). Catalyst не повторяется. Серия escalation в середине = нормально (Fun & Games). McKee: Act Rhythm — два последних climax чередуют заряд +/-. См. заметки Nash, McKee
-- [x] Набрать эвристики episode completeness → два уровня арки (эпизод vs сезон). В serial resolution арки не в каждом эпизоде, но resolution событий эпизода — да. В procedural case = полная арка per episode. В Wire-style serial эпизод может не иметь episodic closure вообще. См. заметки Nash, Douglas, Mittell
-- [x] Решить: A-rank = всегда plot-led? → **Нет.** Douglas: A может быть character-led (NYPD Blue). Oberg: story-type = атрибут plotline, не rank. Landau: A = franchise (episode level), Douglas: A = most resonant (series level) — разные уровни, не противоречие
-- [x] Решить: "episodic" как тип линии → заменить на `procedural_scope: episode | season | none` как атрибут plotline. Franchise type вычисляемый из plotlines
-- [x] Решить: narrative devices → **убрать `devices` как поле** (и на plotline, и на event). Mystery = goal, suspense = discourse (не извлекаем), callback = seed (function), twist = turning_point (function), unreliable = discourse. Dramatic irony остаётся как interaction type. Flashback/flashforward → отдельное поле event (temporal), посмотрим где срабатывает
-- [x] Решить: interactions → оставить convergence, dramatic_irony, thematic_rhyme. **Убрать meta** (расплывчатое). Задача для app: визуализация interactions в аналитике
-- [x] Решить: hybrid vs procedural → `procedural_scope` на plotline определяет franchise type. Episode-scope = procedural/hybrid, season-scope = serial с сезонным procedural element, none = pure serial. В hybrid case-of-the-week = B по умолчанию (гипотеза на проверку)
-- [ ] Объединить [[tvplotlines-event-functions-redesign]] и [[tvplotlines-autoresearch-v3-event-functions]] в один документ, архивировать оригиналы
-
-### Новые решения из чтения книг (2026-03-23)
-
-Чтение: Nash, McKee, Douglas, Oberg, Landau (оба), Mittell. Заметки: `read-nash-2022-*`, `read-mckee-1997-*`, `read-douglas-2011-*`, `read-oberg-2023-*`, `read-landau-2018-*`, `read-mittell-2015-*`.
-
-- [ ] **Story-type** (plot-led / character-led / theme-led) — новый атрибут plotline. Эвристика: "откуда приходит проблема?" Задаёт ожидания для проверки DNA. Story-type у линии и у события — разные вещи (событие = plot-led action внутри character-led арки). Pass 3 может уточнить. Источник: Oberg
-- [ ] **Переименовать driver → hero** в Story DNA. Совпадает с Nash ("Story DNA: Hero, Goal, Obstacle, Stakes"). Hero = hero данной plotline, не сериала. Источник: Nash
-- [ ] **Kernel/satellite** — потенциальный вычисляемый атрибут события (weight). Kernel = убрать → plot ломается. Satellite = убрать → plot выживет. Приблизительно: also_affects + function catalyst/turning_point/climax → kernel. Escalation без also_affects → satellite. Для визуализации в app. Источник: Mittell/Chatman, books2series compute_landmarks()
-- [ ] **Oberg: конкретные пропорции A/B/C** для procedural: A=50%, B=33%, C=17%. Max 4-5 plotlines per episode. Runners = 3-5 beats. ~27-30 scenes per hour episode. Использовать как baseline для валидации
-- [ ] **Landau: Central Question (future) vs Central Mystery (past)** — два типа goal. Goal может быть forward-looking или backward-looking. Для промпта: подсказать LLM что goal формулируется через глагол
-
-## Фаза 2: Инженерная чистка (код + промпты, без autoresearch)
-
-**Prerequisite — до начала фазы 2 должны быть готовы:**
-1. [ ] Глоссарий — ground truth для всех определений (franchise types, plotline, Story DNA, event functions, типы линий)
-2. [ ] Эвристики из учебников — заполненные таблицы в [[tvplotlines-heuristics-from-theory]] (порядок функций, episode completeness, количество линий по franchise type)
-3. [ ] Верифицированные event functions — какие, на основе какого источника, с маппингом
-4. [ ] Решения по спорным полям — narrative devices, interactions, episodic, A-rank = plot-led?, format, patches, confidence
-5. [ ] Список constraints для переноса в код — полный перечень того что сейчас в промптах как текст, а должно быть проверкой в коде
-
-Стратегия: одно изменение → прогон → сравнить с baseline → если упало → откатить.
-
-- [ ] `storyline → plotline` везде
-- [ ] Глоссарий = ground truth для определений в промптах
-- [ ] Blueprint First скелет промпта: ROLE → DEFINITIONS → INPUT → TASK → OUTPUT → EXAMPLE
-- [ ] Убрать meta-комментарии, цитаты с номерами страниц, двойные описания input/contract
-- [ ] Убрать HOW-инструкции из промптов ("If code detects an error — re-request")
-- [ ] Constraints из промптов → в код (составить полный список, перенести)
-- [ ] Event functions: заменить `cliffhanger/seed` на `catalyst/crisis` (верифицированные в фазе 1)
-- [ ] Merge Pass 0 → Pass 1
-- [ ] `format`, `patches` — убрать из промптов
-- [ ] `narrative devices` — по решению из фазы 1
-- [ ] `interactions` — по решению из фазы 1
-- [ ] Реализовать в коде: episode completeness (факт, без порогов)
-- [ ] Реализовать в коде: arc completeness (факт, без порогов)
-- [ ] Реализовать в коде: валидация порядка функций (по эвристикам из фазы 1)
-- [ ] Реализовать в коде: Story DNA completeness (non-runner + solid → все поля непустые)
-- [ ] Реализовать в коде: количество линий в диапазоне по franchise type
-
-## Фаза 3: Проверка чистки
-
-- [ ] Прогон на 12 шоу [$10-15]
-- [ ] Сравнить с v2-10 baseline (mean 0.0588)
-- [ ] Если деградация > 5%: найти какое изменение сломало, откатить, тестировать отдельно
-- [ ] Визуальная проверка BB S01 + 1-2 других шоу
-
-## Фаза 4: Ablation study (autoresearch) [$30-40]
-
-- [ ] Подготовить 3 условия: A (naive) / B (минимальный scaffold) / C (полный scaffold)
-- [ ] Прогнать на 5 шоу × 3 условия × 1-3 прогона
-- [ ] Измерить: `coh_sep`, `coverage`, `ARI`, episode/arc completeness
-- [ ] Показать: C > B > A
-- [ ] Объединить с [[tvplotlines-naive-vs-tvplotlines]] (naive = условие A)
-
-## Фаза 5: Оптимизация (autoresearch) [$20-30]
-
-- [ ] CoT reasoning trace в few-shot примерах (1 прогон с CoT vs 3 без)
-- [ ] Формулировки описаний event functions (catalyst vs escalation и т.д.)
-- [ ] Подбор примеров по franchise type (BB для serial, House для procedural)
-
-## Фаза 6: Валидация
-
-- [ ] Прогнать лучший вариант на held-out set (шоу, которых pipeline не видел при оптимизации)
-- [ ] Калибровать пороги episode/arc completeness post-hoc по результатам 12 шоу
-
----
-
-Бюджет: ~$60-85. Каждая фаза — checkpoint.
diff --git a/docs/knowledge/archive/plans/2026-03-16-prior-season-continuity-design.md b/docs/knowledge/archive/plans/2026-03-16-prior-season-continuity-design.md
deleted file mode 100644
index af46374..0000000
--- a/docs/knowledge/archive/plans/2026-03-16-prior-season-continuity-design.md
+++ /dev/null
@@ -1,145 +0,0 @@
-# Design: Prior Season Continuity
-
-**Date:** 2026-03-16
-**Status:** Approved
-**Scope:** Add `prior: TVPlotlinesResult | None` parameter for multi-season continuity
-
-## Problem
-
-Each season is processed independently. When running Season 2, the pipeline has no knowledge of Season 1's characters or plotlines. This causes:
-
-1. Pass 1 may "rediscover" characters with different IDs (e.g. `walter` instead of `walt`)
-2. Continuing plotlines get new IDs instead of reusing existing ones (e.g. `drug_business` instead of `empire`)
-3. No explicit tracking of which plotlines continue vs. end between seasons
-
-## Solution
-
-One new parameter: `prior: TVPlotlinesResult | None` in `get_plotlines()`.
-
-### Usage
-
-```python
-r1 = get_plotlines("Breaking Bad", 1, episodes_s01)
-r2 = get_plotlines("Breaking Bad", 2, episodes_s02, prior=r1)
-r3 = get_plotlines("Breaking Bad", 3, episodes_s03, prior=r2)
-```
-
-The caller stores results and passes the previous season's result. Library remains stateless.
-
-## Changes by Pass
-
-### Pass 0 — skip if prior provided
-
-If `prior` is provided and `context` is not explicitly passed, reuse `prior.context`. Same show, same franchise type — no need to re-detect.
-
-### Pass 1 — inject prior cast + plotlines into prompt
-
-**Code change (`pass1.py`):**
-
-Add `prior_cast` and `prior_plotlines` parameters to `extract_plotlines()`. When provided, include a `prior_season` block in the user message JSON:
-
-```python
-if prior_cast and prior_plotlines:
-    user_data["prior_season"] = {
-        "cast": [{"id": c.id, "name": c.name, "aliases": c.aliases} for c in prior_cast],
-        "plotlines": [
-            {
-                "id": p.id, "name": p.name, "driver": p.driver,
-                "goal": p.goal, "obstacle": p.obstacle, "stakes": p.stakes,
-                "type": p.type, "rank": p.rank,
-            }
-            for p in prior_plotlines
-        ],
-    }
-```
-
-Note: explicit dict construction, not `asdict()`. Excludes `span` (computed post-hoc metadata), `confidence`, `nature`, and `devices` — not needed for continuity decisions.
-
-**Prompt change (`pass1.md` / `pass1.md` en):**
-
-Add section after "## Input". Also update "## Task" to reference prior workflow:
-
-> Read ALL season synopses. **If `prior_season` data is provided, first process prior plotlines (see Prior season section), then identify new plotlines.** Extract the list of plotlines and the main cast.
-
-New section:
-
-```
-## Prior season (if provided)
-
-If `prior_season` is present in the input, it contains cast and plotlines from the
-previous season. Process them BEFORE analyzing new synopses:
-
-For each plotline in `prior_season.plotlines`, decide based on the NEW season's synopses:
-- **CONTINUES** — the plotline is present this season. Keep the same `id`, update
-  goal/obstacle/stakes to reflect the new season's material.
-- **TRANSFORMED** — same driver, but goal fundamentally changed. Keep the `id`,
-  rewrite Story DNA.
-- **ENDED** — the plotline resolved or disappeared. Don't include it.
-
-For each character in `prior_season.cast`:
-- If the character appears in this season's synopses — reuse the same `id` and `name`.
-- If the character does not appear — don't include them.
-
-Only after processing all prior plotlines, identify NEW plotlines not present before.
-```
-
-**Validation (code, `pass1.py`):**
-
-After voting selection (post-voting, not inside `_full_validate`), check for suspicious overlaps: if a new plotline has the same `driver` as a prior plotline that wasn't continued, log a warning. No hard block — majority voting (3 rounds) reduces randomness.
-
-### Pass 2 — no changes
-
-Works with Pass 1 output which already has correct IDs.
-
-### Pass 3 — no changes
-
-Pass 3 does not receive prior season data. It reviews the current season's plotlines independently.
-
-### Pipeline (`pipeline.py`)
-
-```python
-def get_plotlines(
-    show: str,
-    season: int,
-    episodes: list[str],
-    *,
-    prior: TVPlotlinesResult | None = None,  # NEW
-    context: SeriesContext | None = None,
-    cast: list[CastMember] | None = None,
-    plotlines: list[Plotline] | None = None,
-    ...
-) -> TVPlotlinesResult:
-```
-
-Logic:
-
-1. If `prior` is provided and `context.format == "anthology"` → raise `ValueError` (anthology seasons are independent by definition)
-2. If `prior` is provided and `context` is None → `context = prior.context`
-3. If `prior` is provided and `cast` is None → pass `prior.cast` and `prior.plotlines` to `extract_plotlines()`
-4. If `prior` is provided but `cast`/`plotlines` are also provided (Pass 1 skip) → `prior` only affects Pass 0 context reuse. The caller is responsible for continuity in manually-provided data.
-5. Everything else unchanged
-
-## Files to modify
-
-| File | Change |
-|------|--------|
-| `pipeline.py` | Add `prior` parameter, wire to Pass 0 skip + Pass 1 |
-| `pass1.py` | Add `prior_cast`, `prior_plotlines` params; inject into user message; add overlap warning |
-| `prompts_en/pass1.md` | Add "Prior season" section |
-| `prompts/pass1.md` | Add "Prior season" section (Russian) |
-| `docs/api.md` | Document `prior` parameter |
-
-## Out of scope
-
-- Cross-season analysis (comparing plotline evolution across all seasons) — separate future feature
-- Passing multiple prior seasons — `prior` is the immediately previous season only; caller chains results
-- Changes to Pass 2 or Pass 3 prompts
-
-## Design decisions
-
-1. **One parameter, not two.** `prior: TVPlotlinesResult` instead of separate `prior_cast` + `prior_plotlines`. Simpler API, no ambiguity.
-2. **Library is stateless.** Caller stores results and chains them. No internal tracking.
-3. **Prior is a hint, not a constraint.** LLM is free to ignore prior plotlines that don't appear in new synopses. Prompt forces explicit decision per prior plotline to reduce hallucination.
-4. **Reuse context from prior.** Same show → same franchise type. Saves one LLM call.
-5. **Anthology guard.** `prior` + `format="anthology"` raises ValueError — anthology seasons are independent by definition.
-6. **Explicit dict construction.** No `asdict()` — exclude `span` and other computed fields from prior data sent to LLM.
diff --git a/docs/knowledge/archive/plans/2026-03-16-prior-season-continuity.md b/docs/knowledge/archive/plans/2026-03-16-prior-season-continuity.md
deleted file mode 100644
index cf75ec1..0000000
--- a/docs/knowledge/archive/plans/2026-03-16-prior-season-continuity.md
+++ /dev/null
@@ -1,651 +0,0 @@
-# Prior Season Continuity — Implementation Plan
-
-> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Add `prior: TVPlotlinesResult | None` parameter to `get_plotlines()` for multi-season continuity.
-
-**Architecture:** One new parameter flows through pipeline.py → pass0 skip + pass1 injection. Prior cast/plotlines are serialized (without computed fields) and injected into the Pass 1 user message. Prompts in both languages get a new section instructing the LLM to process prior plotlines before identifying new ones.
-
-**Tech Stack:** Python, pytest, existing tvplotlines pipeline
-
-**Spec:** `docs/2026-03-16-prior-season-continuity-design.md`
-
----
-
-## Chunk 1: Pipeline + Pass 1 code changes
-
-### Task 1: Add `prior` parameter to pipeline.py
-
-**Files:**
-- Modify: `src/tvplotlines/pipeline.py:30-47` (function signature)
-- Modify: `src/tvplotlines/pipeline.py:89-98` (Pass 0 + Pass 1 wiring)
-- Test: `tests/test_pipeline_prior.py`
-
-- [ ] **Step 1: Write failing test — prior reuses context (skips Pass 0)**
-
-```python
-# tests/test_pipeline_prior.py
-"""Tests for prior season continuity in pipeline."""
-
-import pytest
-
-from tvplotlines.models import (
-    CastMember,
-    Plotline,
-    TVPlotlinesResult,
-    SeriesContext,
-)
-
-
-def _make_prior() -> TVPlotlinesResult:
-    ctx = SeriesContext(
-        franchise_type="serial",
-        story_engine="A teacher builds a drug empire",
-        genre="drama",
-        format="ongoing",
-    )
-    cast = [
-        CastMember(id="walt", name="Walter White", aliases=["Walt"]),
-        CastMember(id="jesse", name="Jesse Pinkman", aliases=["Jesse"]),
-    ]
-    plotlines = [
-        Plotline(
-            id="empire", name="Walt: Empire", driver="walt",
-            goal="build a drug business", obstacle="morality", stakes="death",
-            type="serialized", rank="A", nature="plot-led", confidence="solid",
-        ),
-    ]
-    return TVPlotlinesResult(context=ctx, cast=cast, plotlines=plotlines)
-
-
-class TestPriorContextReuse:
-    def test_prior_provides_context_when_context_is_none(self, monkeypatch):
-        """If prior is given and context is not, pipeline should use prior.context
-        and NOT call detect_context (Pass 0)."""
-        from unittest.mock import MagicMock
-        import tvplotlines.pipeline as pipeline_mod
-
-        prior = _make_prior()
-        # Mock detect_context to verify it's NOT called
-        mock_detect = MagicMock(side_effect=AssertionError("Pass 0 should be skipped"))
-        monkeypatch.setattr(pipeline_mod, "detect_context", mock_detect)
-        # Mock extract_plotlines to avoid LLM call
-        mock_extract = MagicMock(return_value=(prior.cast, prior.plotlines))
-        monkeypatch.setattr(pipeline_mod, "extract_plotlines", mock_extract)
-
-        # Will fail at Pass 2, but we only care about Pass 0 + Pass 1
-        try:
-            pipeline_mod.get_plotlines("Breaking Bad", 2, ["synopsis"], prior=prior)
-        except Exception:
-            pass
-
-        mock_detect.assert_not_called()
-        mock_extract.assert_called_once()
-        # Verify prior_cast and prior_plotlines were forwarded
-        call_kwargs = mock_extract.call_args.kwargs
-        assert call_kwargs["prior_cast"] == prior.cast
-        assert call_kwargs["prior_plotlines"] == prior.plotlines
-
-    def test_prior_ignored_when_cast_and_plotlines_provided(self, monkeypatch):
-        """When cast+plotlines are provided (Pass 1 skip), prior only affects context."""
-        from unittest.mock import MagicMock
-        import tvplotlines.pipeline as pipeline_mod
-
-        prior = _make_prior()
-        explicit_cast = [CastMember(id="custom", name="Custom")]
-        explicit_plotlines = [
-            Plotline(
-                id="custom_line", name="Custom", driver="custom",
-                goal="g", obstacle="o", stakes="s",
-                type="serialized", rank="A", nature="plot-led", confidence="solid",
-            ),
-        ]
-        # Mock extract_plotlines — should NOT be called
-        mock_extract = MagicMock()
-        monkeypatch.setattr(pipeline_mod, "extract_plotlines", mock_extract)
-
-        try:
-            pipeline_mod.get_plotlines(
-                "Breaking Bad", 2, ["synopsis"],
-                prior=prior, cast=explicit_cast, plotlines=explicit_plotlines,
-            )
-        except Exception:
-            pass
-
-        mock_extract.assert_not_called()
-
-    def test_anthology_raises_with_prior(self):
-        """Anthology format + prior is contradictory."""
-        from tvplotlines.pipeline import get_plotlines
-
-        prior = _make_prior()
-        prior.context.format = "anthology"
-        with pytest.raises(ValueError, match="anthology"):
-            get_plotlines(
-                "Test Show", 2, ["synopsis"],
-                prior=prior,
-            )
-```
-
-- [ ] **Step 2: Run test to verify it fails**
-
-Run: `cd /Users/nvashko/Projects/1-projects/plotter && python -m pytest tests/test_pipeline_prior.py -v`
-Expected: FAIL — `get_plotlines()` doesn't accept `prior` parameter yet.
-
-- [ ] **Step 3: Implement prior parameter in pipeline.py**
-
-In `src/tvplotlines/pipeline.py`, modify `get_plotlines()`:
-
-```python
-def get_plotlines(
-    show: str,
-    season: int,
-    episodes: list[str],
-    *,
-    prior: TVPlotlinesResult | None = None,
-    context: SeriesContext | None = None,
-    cast: list[CastMember] | None = None,
-    plotlines: list[Plotline] | None = None,
-    breakdowns: list[EpisodeBreakdown] | None = None,
-    llm_provider: str = "anthropic",
-    model: str | None = None,
-    base_url: str | None = None,
-    lang: str = "en",
-    skip_review: bool = False,
-    pass2_mode: str = "parallel",
-    batch_id: str | None = None,
-    callback: PipelineCallback | None = None,
-) -> TVPlotlinesResult:
-```
-
-Add validation + context reuse after existing validation block:
-
-```python
-    # Validate prior parameter
-    if prior is not None:
-        prior_context = context or prior.context
-        if prior_context.format == "anthology":
-            raise ValueError(
-                "prior is not supported for anthology format "
-                "(anthology seasons are independent by definition)"
-            )
-        if context is None:
-            context = prior.context
-```
-
-Modify Pass 1 call to pass prior data:
-
-```python
-    # Pass 1: extract cast and plotlines from all synopses
-    if cast is None:
-        cast, plotlines = extract_plotlines(
-            show, season, context, episodes,
-            prior_cast=prior.cast if prior else None,
-            prior_plotlines=prior.plotlines if prior else None,
-            config=config,
-        )
-```
-
-- [ ] **Step 4: Run test to verify anthology guard passes**
-
-Run: `cd /Users/nvashko/Projects/1-projects/plotter && python -m pytest tests/test_pipeline_prior.py::TestPriorContextReuse::test_anthology_raises_with_prior -v`
-Expected: PASS
-
-- [ ] **Step 5: Commit**
-
-```bash
-cd /Users/nvashko/Projects/1-projects/plotter
-git add src/tvplotlines/pipeline.py tests/test_pipeline_prior.py
-git commit -m "Add prior parameter to get_plotlines with anthology guard"
-```
-
----
-
-### Task 2: Add prior injection to pass1.py
-
-**Files:**
-- Modify: `src/tvplotlines/pass1.py:27-62` (extract_plotlines signature + user message)
-- Test: `tests/test_pass1_prior.py`
-
-- [ ] **Step 1: Write failing test — prior_season block in user message**
-
-```python
-# tests/test_pass1_prior.py
-"""Tests for prior season data injection in Pass 1."""
-
-import json
-
-from tvplotlines.models import CastMember, Plotline, SeriesContext
-from tvplotlines.pass1 import _build_user_message
-
-
-def _make_context():
-    return SeriesContext(
-        franchise_type="serial",
-        story_engine="A teacher builds a drug empire",
-        genre="drama",
-        format="ongoing",
-    )
-
-
-def _make_prior_cast():
-    return [
-        CastMember(id="walt", name="Walter White", aliases=["Walt"]),
-        CastMember(id="jesse", name="Jesse Pinkman", aliases=["Jesse"]),
-    ]
-
-
-def _make_prior_plotlines():
-    return [
-        Plotline(
-            id="empire", name="Walt: Empire", driver="walt",
-            goal="build a drug business", obstacle="morality", stakes="death",
-            type="serialized", rank="A", nature="plot-led", confidence="solid",
-            span=["S01E01", "S01E07"],  # should be excluded from prior
-        ),
-    ]
-
-
-class TestBuildUserMessage:
-    def test_without_prior(self):
-        msg = _build_user_message("Breaking Bad", 2, _make_context(), ["ep1", "ep2"])
-        data = json.loads(msg)
-        assert "prior_season" not in data
-
-    def test_with_prior(self):
-        msg = _build_user_message(
-            "Breaking Bad", 2, _make_context(), ["ep1", "ep2"],
-            prior_cast=_make_prior_cast(),
-            prior_plotlines=_make_prior_plotlines(),
-        )
-        data = json.loads(msg)
-        assert "prior_season" in data
-        prior = data["prior_season"]
-        # Cast present with correct fields
-        assert len(prior["cast"]) == 2
-        assert prior["cast"][0]["id"] == "walt"
-        # Plotlines present with Story DNA, without span
-        assert len(prior["plotlines"]) == 1
-        assert prior["plotlines"][0]["id"] == "empire"
-        assert "span" not in prior["plotlines"][0]
-        assert "confidence" not in prior["plotlines"][0]
-        assert "nature" not in prior["plotlines"][0]
-        assert "devices" not in prior["plotlines"][0]
-
-    def test_empty_prior_lists_no_injection(self):
-        """Empty prior cast/plotlines should not inject prior_season block."""
-        msg = _build_user_message(
-            "Breaking Bad", 2, _make_context(), ["ep1"],
-            prior_cast=[], prior_plotlines=[],
-        )
-        data = json.loads(msg)
-        assert "prior_season" not in data
-```
-
-- [ ] **Step 2: Run test to verify it fails**
-
-Run: `cd /Users/nvashko/Projects/1-projects/plotter && python -m pytest tests/test_pass1_prior.py -v`
-Expected: FAIL — `_build_user_message` doesn't exist yet.
-
-- [ ] **Step 3: Extract _build_user_message and add prior injection**
-
-In `src/tvplotlines/pass1.py`, extract the user message construction into a helper and add prior support:
-
-```python
-def _build_user_message(
-    show: str,
-    season: int,
-    context: SeriesContext,
-    episodes: list[str],
-    *,
-    prior_cast: list[CastMember] | None = None,
-    prior_plotlines: list[Plotline] | None = None,
-) -> str:
-    """Build the JSON user message for Pass 1."""
-    data = {
-        "show": show,
-        "season": season,
-        "franchise_type": context.franchise_type,
-        "story_engine": context.story_engine,
-        "synopses": [
-            {"episode": f"S{season:02d}E{i+1:02d}", "text": s}
-            for i, s in enumerate(episodes)
-        ],
-    }
-    if prior_cast and prior_plotlines:
-        data["prior_season"] = {
-            "cast": [
-                {"id": c.id, "name": c.name, "aliases": c.aliases}
-                for c in prior_cast
-            ],
-            "plotlines": [
-                {
-                    "id": p.id, "name": p.name, "driver": p.driver,
-                    "goal": p.goal, "obstacle": p.obstacle, "stakes": p.stakes,
-                    "type": p.type, "rank": p.rank,
-                }
-                for p in prior_plotlines
-            ],
-        }
-    return json.dumps(data, ensure_ascii=False)
-```
-
-Update `extract_plotlines()` signature to accept and forward prior params:
-
-```python
-def extract_plotlines(
-    show: str,
-    season: int,
-    context: SeriesContext,
-    episodes: list[str],
-    *,
-    prior_cast: list[CastMember] | None = None,
-    prior_plotlines: list[Plotline] | None = None,
-    config: LLMConfig | None = None,
-) -> tuple[list[CastMember], list[Plotline]]:
-```
-
-Replace inline message construction with `_build_user_message()` call:
-
-```python
-    user_message = _build_user_message(
-        show, season, context, episodes,
-        prior_cast=prior_cast, prior_plotlines=prior_plotlines,
-    )
-```
-
-- [ ] **Step 4: Run test to verify it passes**
-
-Run: `cd /Users/nvashko/Projects/1-projects/plotter && python -m pytest tests/test_pass1_prior.py -v`
-Expected: PASS
-
-- [ ] **Step 5: Run existing tests to check no regressions**
-
-Run: `cd /Users/nvashko/Projects/1-projects/plotter && python -m pytest tests/ -v`
-Expected: all existing tests PASS
-
-- [ ] **Step 6: Commit**
-
-```bash
-cd /Users/nvashko/Projects/1-projects/plotter
-git add src/tvplotlines/pass1.py tests/test_pass1_prior.py
-git commit -m "Inject prior season cast and plotlines into Pass 1 user message"
-```
-
----
-
-### Task 3: Add overlap warning after voting
-
-**Files:**
-- Modify: `src/tvplotlines/pass1.py` (after voting selection, ~line 86)
-- Test: `tests/test_pass1_prior.py` (add test)
-
-- [ ] **Step 1: Write failing test — overlap warning logged**
-
-Add to `tests/test_pass1_prior.py`:
-
-```python
-import logging
-
-from tvplotlines.pass1 import _check_prior_overlap
-
-
-class TestPriorOverlapWarning:
-    def test_warns_on_same_driver_not_continued(self, caplog):
-        prior_plotlines = _make_prior_plotlines()  # empire, driver=walt
-        new_plotlines = [
-            Plotline(
-                id="drug_business", name="Walt: Drug Business", driver="walt",
-                goal="expand meth operation", obstacle="rivals", stakes="death",
-                type="serialized", rank="A", nature="plot-led", confidence="solid",
-            ),
-        ]
-        with caplog.at_level(logging.WARNING):
-            _check_prior_overlap(new_plotlines, prior_plotlines)
-        assert "empire" in caplog.text
-        assert "drug_business" in caplog.text
-
-    def test_no_warning_when_id_reused(self, caplog):
-        prior_plotlines = _make_prior_plotlines()  # empire, driver=walt
-        new_plotlines = [
-            Plotline(
-                id="empire", name="Walt: Empire", driver="walt",
-                goal="expand empire", obstacle="DEA", stakes="prison",
-                type="serialized", rank="A", nature="plot-led", confidence="solid",
-            ),
-        ]
-        with caplog.at_level(logging.WARNING):
-            _check_prior_overlap(new_plotlines, prior_plotlines)
-        warning_records = [r for r in caplog.records if r.levelno >= logging.WARNING]
-        assert warning_records == []
-```
-
-- [ ] **Step 2: Run test to verify it fails**
-
-Run: `cd /Users/nvashko/Projects/1-projects/plotter && python -m pytest tests/test_pass1_prior.py::TestPriorOverlapWarning -v`
-Expected: FAIL — `_check_prior_overlap` doesn't exist.
-
-- [ ] **Step 3: Implement _check_prior_overlap**
-
-Add to `src/tvplotlines/pass1.py`:
-
-```python
-def _check_prior_overlap(
-    new_plotlines: list[Plotline],
-    prior_plotlines: list[Plotline],
-) -> None:
-    """Warn if a new plotline shares a driver with a prior plotline that wasn't continued."""
-    prior_by_driver: dict[str, list[Plotline]] = {}
-    for p in prior_plotlines:
-        prior_by_driver.setdefault(p.driver, []).append(p)
-
-    new_ids = {p.id for p in new_plotlines}
-
-    for driver, priors in prior_by_driver.items():
-        for prior in priors:
-            if prior.id in new_ids:
-                continue  # Prior plotline was continued — no issue
-            # Check if any new plotline has the same driver
-            new_with_same_driver = [p for p in new_plotlines if p.driver == driver]
-            for new_p in new_with_same_driver:
-                logger.warning(
-                    "Prior plotline %r (driver=%s) was not continued, "
-                    "but new plotline %r has the same driver. "
-                    "Possible duplicate?",
-                    prior.id, driver, new_p.id,
-                )
-```
-
-Call it in `extract_plotlines()` after voting selection, before return:
-
-```python
-    if prior_plotlines:
-        _check_prior_overlap(plotlines, prior_plotlines)
-```
-
-- [ ] **Step 4: Run test to verify it passes**
-
-Run: `cd /Users/nvashko/Projects/1-projects/plotter && python -m pytest tests/test_pass1_prior.py -v`
-Expected: all PASS
-
-- [ ] **Step 5: Commit**
-
-```bash
-cd /Users/nvashko/Projects/1-projects/plotter
-git add src/tvplotlines/pass1.py tests/test_pass1_prior.py
-git commit -m "Add overlap warning when prior plotline driver reappears under new id"
-```
-
----
-
-## Chunk 2: Prompt changes + docs
-
-### Task 4: Update English Pass 1 prompt
-
-**Files:**
-- Modify: `src/tvplotlines/prompts_en/pass1.md`
-
-- [ ] **Step 1: Add "Prior season" section after "## Input"**
-
-Insert after the `- **synopses**: all season synopses (text)` line (line 17):
-
-```markdown
-
-## Prior season (if provided)
-
-If `prior_season` is present in the input, it contains cast and plotlines from the previous season.
-
-**Process prior data BEFORE analyzing new synopses:**
-
-For each plotline in `prior_season.plotlines`, decide based on the NEW season's synopses:
-- **CONTINUES** — the plotline is present this season. Keep the same `id`, update goal/obstacle/stakes to reflect the new season's material.
-- **TRANSFORMED** — same driver, but goal fundamentally changed. Keep the `id`, rewrite Story DNA.
-- **ENDED** — the plotline resolved or disappeared. Don't include it.
-
-For each character in `prior_season.cast`:
-- If the character appears in this season's synopses — reuse the same `id` and `name`.
-- If the character does not appear — don't include them.
-
-Only after processing all prior plotlines, identify NEW plotlines not present before.
-```
-
-- [ ] **Step 2: Update "## Task" section to reference prior workflow**
-
-Change line 20 from:
-
-```
-Read ALL season synopses. Extract the list of plotlines and the main cast.
-```
-
-to:
-
-```
-Read ALL season synopses. If `prior_season` data is provided, first process prior plotlines (see Prior season section), then identify new plotlines. Extract the list of plotlines and the main cast.
-```
-
-- [ ] **Step 3: Commit**
-
-```bash
-cd /Users/nvashko/Projects/1-projects/plotter
-git add src/tvplotlines/prompts_en/pass1.md
-git commit -m "Add prior season instructions to English Pass 1 prompt"
-```
-
----
-
-### Task 5: Update Russian Pass 1 prompt
-
-**Files:**
-- Modify: `src/tvplotlines/prompts/pass1.md`
-
-- [ ] **Step 1: Add "Предыдущий сезон" section after "## Вход"**
-
-Insert after line 17 (`- **synopses**: все синопсисы сезона (текст)`):
-
-```markdown
-
-## Предыдущий сезон (если предоставлен)
-
-Если во входных данных есть `prior_season`, он содержит каст и сюжетные линии предыдущего сезона.
-
-**Обработай данные предыдущего сезона ДО анализа новых синопсисов:**
-
-Для каждой линии в `prior_season.plotlines` реши на основе синопсисов НОВОГО сезона:
-- **CONTINUES** — линия присутствует в этом сезоне. Сохрани тот же `id`, обнови goal/obstacle/stakes по материалу нового сезона.
-- **TRANSFORMED** — тот же driver, но цель кардинально изменилась. Сохрани `id`, перепиши Story DNA.
-- **ENDED** — линия завершилась или исчезла. Не включай её.
-
-Для каждого персонажа в `prior_season.cast`:
-- Если персонаж появляется в синопсисах этого сезона — используй тот же `id` и `name`.
-- Если персонаж не появляется — не включай его.
-
-Только после обработки всех prior-линий ищи НОВЫЕ линии, которых не было раньше.
-```
-
-- [ ] **Step 2: Update "## Задача" section**
-
-Change line 21 from:
-
-```
-Прочитай ВСЕ синопсисы сезона. Извлеки список сюжетных линий и основной каст.
-```
-
-to:
-
-```
-Прочитай ВСЕ синопсисы сезона. Если предоставлены данные `prior_season`, сначала обработай линии предыдущего сезона (см. секцию «Предыдущий сезон»), затем ищи новые линии. Извлеки список сюжетных линий и основной каст.
-```
-
-- [ ] **Step 3: Commit**
-
-```bash
-cd /Users/nvashko/Projects/1-projects/plotter
-git add src/tvplotlines/prompts/pass1.md
-git commit -m "Add prior season instructions to Russian Pass 1 prompt"
-```
-
----
-
-### Task 6: Update API docs
-
-**Files:**
-- Modify: `docs/api.md`
-
-- [ ] **Step 1: Add `prior` to get_plotlines() signature in docs**
-
-In the code block at line 10, add `prior=None` after `episodes=synopses,`:
-
-```python
-result = get_plotlines(
-    show="House",
-    season=1,
-    episodes=synopses,
-    prior=None,                  # TVPlotlinesResult from previous season
-    llm_provider="anthropic",
-    ...
-)
-```
-
-- [ ] **Step 2: Add multi-season usage section after the signature block**
-
-Insert after line 24:
-
-```markdown
-
-### Multi-season processing
-
-Pass the result of the previous season to maintain character and plotline ID continuity:
-
-\```python
-r1 = get_plotlines("Breaking Bad", 1, episodes_s01)
-r2 = get_plotlines("Breaking Bad", 2, episodes_s02, prior=r1)
-r3 = get_plotlines("Breaking Bad", 3, episodes_s03, prior=r2)
-\```
-
-When `prior` is provided:
-- Pass 0 is skipped (reuses `prior.context`)
-- Pass 1 receives prior cast and plotlines, reusing IDs for continuing characters and plotlines
-- Not supported for anthology format (raises `ValueError`)
-```
-
-- [ ] **Step 3: Commit**
-
-```bash
-cd /Users/nvashko/Projects/1-projects/plotter
-git add docs/api.md
-git commit -m "Document prior parameter in API reference"
-```
-
----
-
-### Task 7: Final verification
-
-- [ ] **Step 1: Run full test suite**
-
-Run: `cd /Users/nvashko/Projects/1-projects/plotter && python -m pytest tests/ -v`
-Expected: all PASS
-
-- [ ] **Step 2: Verify git log on feature branch**
-
-Run: `cd /Users/nvashko/Projects/1-projects/plotter && git log --oneline feature/prior-season-continuity`
-Expected: 6 commits (spec + 5 implementation commits)
diff --git a/docs/knowledge/archive/plans/autoresearcher-competence-idea.md b/docs/knowledge/archive/plans/autoresearcher-competence-idea.md
deleted file mode 100644
index 21e2360..0000000
--- a/docs/knowledge/archive/plans/autoresearcher-competence-idea.md
+++ /dev/null
@@ -1,44 +0,0 @@
----
-type: concept
-project: tvplotlines
-status: active
----
-
-# Идея: автоисследователь с пулами компетенций
-
-## Дата: 2026-03-18 (ночная дискуссия)
-
-## Суть
-
-Автоисследователь который оптимизирует не просто формулировки промптов, а то, **какие компетенции** давать LLM-у и **в какой форме** (промпт vs код vs гибрид). Параметр цена/качество: дешёвая модель + валидатор может быть лучше дорогой модели без валидатора.
-
-## Пулы (что подключать)
-
-- **Теория домена** — нарратологические концепты (Propp, Freytag, Campbell, Genette, jo-ha-kyū...)
-- **Метрики** — как измерить "стало лучше"
-- **Логики/компетенции** — формальные условия (эпистемика, каузальность, темпоральность...)
-- **Код vs промпт** — одно и то же условие можно дать в промпте (дёшево, хрупко) или в коде-валидаторе (надёжно, дороже)
-
-## Открытые вопросы (важные, не решённые)
-
-1. **Откуда брать компетенции?** Нельзя просто "собрать все логики" — это бесконечная задача. Нужно идти от практики: что реально делает сценарист когда пишет? Из каких элементов состоит создание сценария? На какие уровни компетенции это разваливается?
-
-2. **Источники:** Не нарратология, а учебники по сценарному мастерству. Мы делаем практический инструмент. Начинать с того, как устроены учебники — McKee, Snyder, наши восточные (Arai, Tan Peisheng, Sim San). Какие элементы они все описывают? Что общего?
-
-3. **Компетенции шире чем "про истории":** Сценарист использует знания из биологии (поведение), психологии (мотивация), истории, искусства. Пулы компетенций могут включать источники из совершенно разных областей. Как это организовать?
-
-4. **Как представить компетенцию в виде, пригодном для автоисследователя?** "Добавь эпистемическую логику" — красиво звучит, но что конкретно подаёшь на вход? Формулу? Описание на естественном языке? Набор правил валидации? Пример?
-
-5. **Масштаб:** Сколько компетенций реалистично описать? 5? 10? 50? На каждую — по 5 ключевых источников? Это уже исследовательский проект сам по себе.
-
-## Связь с препринтом
-
-Если препринт — это "логика как competence для нарративного интеллекта", то автоисследователь — это инструмент который это демонстрирует. Наивный промпт → добавляем компетенции одну за другой → результат улучшается → competence работает.
-
-## Что делать дальше
-
-- [ ] Взять 3-5 учебников по сценарному мастерству (разных традиций)
-- [ ] Выписать из них: из каких элементов/этапов состоит работа сценариста
-- [ ] Найти пересечения — что все описывают одинаково
-- [ ] Понять какие из этих элементов = какие компетенции
-- [ ] Для каждой компетенции: можно ли это формализовать? как? в промпте или в коде?
diff --git a/docs/knowledge/archive/plans/awesome-shortlist.bib b/docs/knowledge/archive/plans/awesome-shortlist.bib
deleted file mode 100644
index 81c04f4..0000000
--- a/docs/knowledge/archive/plans/awesome-shortlist.bib
+++ /dev/null
@@ -1,152 +0,0 @@
-@article{rivera2024,
-  author = {Rivera, Camille and Ware, Stephen G. and Fisher, Brad},
-  title = {The Story So Far on Narrative Planning},
-  year = {2024},
-  journal = {Journal of Artificial Intelligence Research}
-}
-
-@article{trabasso1989,
-  author = {Trabasso, Tom and van den Broek, Paul and Suh, Soyoung},
-  title = {Logical Necessity and Transitivity of Causal Relations in Stories},
-  year = {1989},
-  journal = {Discourse Processes},
-  volume = {12},
-  number = {1},
-  pages = {1--25}
-}
-
-@inproceedings{christensen2020,
-  author = {Christensen, Rachelyn and Cardona-Rivera, Rogelio E. and Young, R. Michael},
-  title = {Using Domain Compilation to Add Belief to Narrative Planners},
-  year = {2020},
-  booktitle = {Proceedings of the AAAI Conference on Artificial Intelligence and Interactive Digital Entertainment (AIIDE)}
-}
-
-@article{riedl2010,
-  author = {Riedl, Mark O. and Young, R. Michael},
-  title = {Narrative Planning: Balancing Plot and Character},
-  year = {2010},
-  journal = {Journal of Artificial Intelligence Research},
-  volume = {39},
-  pages = {217--268}
-}
-
-@inproceedings{dang2011,
-  author = {Dang, Khai N. and Champagnat, Ronan and Augeraud, Michel},
-  title = {How authors benefit from linear logic in the authoring process of interactive storyworlds},
-  year = {2011},
-  booktitle = {Proceedings of the International Conference on Interactive Digital Storytelling (ICIDS)}
-}
-
-@inproceedings{ciarlini2010,
-  author = {Ciarlini, Angelo E. M. and Pozzer, Cesar T. and Furtado, Antonio L. and Feijó, Bruno},
-  title = {Modeling Interactive Storytelling Genres as Application Domains},
-  year = {2010},
-  booktitle = {Proceedings of the International Conference on Interactive Digital Storytelling (ICIDS)}
-}
-
-@inproceedings{szilas2018,
-  author = {Szilas, Nicolas and Estupiñán, Sandra and Richle, Urs},
-  title = {Automatic Detection of Conflicts in Complex Narrative Structures},
-  year = {2018},
-  booktitle = {Proceedings of the International Conference on Interactive Digital Storytelling (ICIDS)}
-}
-
-@inproceedings{farrell2022salience,
-  author = {Farrell, Rachel and Fisher, Brad and Ware, Stephen G.},
-  title = {Salience Vectors for Measuring Distance between Stories},
-  year = {2022},
-  booktitle = {Proceedings of the AAAI Conference on Artificial Intelligence and Interactive Digital Entertainment (AIIDE)}
-}
-
-@incollection{bolander2017,
-  author = {Bolander, Thomas},
-  title = {A Gentle Introduction to Epistemic Planning: The DEL Approach},
-  year = {2017},
-  booktitle = {Proceedings of the 27th Workshop on Logic, Language, Information and Computation (WoLLIC)},
-  publisher = {Springer}
-}
-
-@inproceedings{castricato2021,
-  author = {Castricato, Louis and Harsh, Tanmay and Diddee, Harshit and Prabhumoye, Shrimai},
-  title = {Towards a Model-Theoretic View of Narratives},
-  year = {2021},
-  booktitle = {Proceedings of the Workshop on Narrative Understanding}
-}
-
-@phdthesis{farrell2022,
-  author = {Farrell, Rachel},
-  title = {Don't Give Me That Story! A Human-Centered Framework for Usable Narrative Planning},
-  year = {2022},
-  school = {University of Kentucky}
-}
-
-@inproceedings{kelly2023,
-  author = {Kelly, Nathaniel and Singh, Jigyasa and Li, Jiaxuan and Grzes, Marek and Pearlmutter, Barak and Riedl, Mark O.},
-  title = {There and Back Again: Extracting Formal Domains for Controllable Neurosymbolic Story Authoring},
-  year = {2023},
-  booktitle = {Proceedings of the AAAI Conference on Artificial Intelligence and Interactive Digital Entertainment (AIIDE)}
-}
-
-@inproceedings{clerc2025,
-  author = {Clerc, Julien and Réty, Jean-Hugues and Maragheh, Saman Hooshmand},
-  title = {Modeling Interactive Narrative Systems: A Formal Approach},
-  year = {2025},
-  booktitle = {Proceedings of the International Conference on Interactive Digital Storytelling (ICIDS)}
-}
-
-@article{diakidoy2014,
-  author = {Diakidoy, Irene-Anna and Kakas, Antonis and Michael, Loizos and Miller, Rob},
-  title = {Non-Monotonic Reasoning and Story Comprehension},
-  year = {2014},
-  journal = {Computational Intelligence}
-}
-
-@inproceedings{dupindesaintcyr2024,
-  author = {Dupin de Saint-Cyr, Florence and Lagasquie-Schiex, Marie-Christine and Morgenstern, Leora},
-  title = {What Killed the Cat? Towards a Logical Formalization of Curiosity (And Suspense, and Surprise) in Narratives},
-  year = {2024},
-  booktitle = {Proceedings of the International Conference on Principles of Knowledge Representation and Reasoning (KR)}
-}
-
-@inproceedings{pianzola2025,
-  author = {Pianzola, Federico and Acerbi, Alberto and Rebora, Simone},
-  title = {The GOLEM Ontology for Narrative and Fiction},
-  year = {2025},
-  booktitle = {Proceedings of the International Conference on Interactive Digital Storytelling (ICIDS)}
-}
-
-@inproceedings{siler2020,
-  author = {Siler, Cory and Ware, Stephen G.},
-  title = {A Good Story Is One in a Million: Solution Density in Narrative Generation Problems},
-  year = {2020},
-  booktitle = {Proceedings of the AAAI Conference on Artificial Intelligence and Interactive Digital Entertainment (AIIDE)}
-}
-
-@inproceedings{shirvani2020,
-  author = {Shirvani, Alireza and Ware, Stephen G.},
-  title = {A Formalization of Emotional Planning for Strong-Story Systems},
-  year = {2020},
-  booktitle = {Proceedings of the AAAI Conference on Artificial Intelligence and Interactive Digital Entertainment (AIIDE)}
-}
-
-@inproceedings{gervas2013,
-  author = {Gervás, Pablo},
-  title = {Propp's Morphology of the Folk Tale as a Grammar for Generation},
-  year = {2013},
-  booktitle = {Proceedings of the Workshop on Computational Models of Narrative (CMN)}
-}
-
-@inproceedings{chandra2024,
-  author = {Chandra, Kartik and Tenenbaum, Joshua B. and Goodman, Noah D.},
-  title = {Storytelling as Inverse Inverse Planning},
-  year = {2024},
-  booktitle = {Proceedings of the Annual Meeting of the Cognitive Science Society (CogSci)}
-}
-
-@inproceedings{nelson2025,
-  author = {Nelson, Mark J. and Mateas, Michael},
-  title = {Accounting for Incomplete and Partially-Ordered Observations Within Classical Model-Based Plan Recognition for Sensemaking of Information Storygames},
-  year = {2025},
-  booktitle = {Proceedings of the AAAI Conference on Artificial Intelligence and Interactive Digital Entertainment (AIIDE)}
-}
diff --git a/docs/knowledge/archive/plans/bibliography-cleanup.md b/docs/knowledge/archive/plans/bibliography-cleanup.md
deleted file mode 100644
index d87ff29..0000000
--- a/docs/knowledge/archive/plans/bibliography-cleanup.md
+++ /dev/null
@@ -1,72 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# Bibliography Cleanup — Completed 2026-03-18
-
-## Structure Created in Zotero
-
-```
-PlotterBibliography (JCAVFXHB) — ~535 items (all candidates)
-├── PlotterPreprint (6R49JN4W) — 23 items (confirmed for paper)
-└── AwesomeNarrativeAI (ECEMJHZR) — 25 items (confirmed for awesome list)
-```
-
-## Phase 2: Migrated from Existing Collections
-
-| Collection | Items | Tags |
-|-----------|-------|------|
-| 4preprint | 23 | `confirmed` |
-| awesome-shortlist | 26 | `confirmed` |
-| logic_narrative_articles | 68 | — |
-| AwesomeLogic-Targeted | 32 | `awesome-candidate` |
-| eastern-narratives | 27 | `eastern-tradition`, `preprint-candidate` |
-| 4benchmrk | 82 | `evaluation` |
-| 00 RelevanceLogic | 35 | `formal-methods` |
-| **Total** | **293** | |
-
-## Phase 3: Imported from .bib Files
-
-| File | Created | Tags |
-|------|---------|------|
-| predicate-discovery.bib | 11 | `predicate-discovery`, `formal-methods` |
-| predicate-discovery-isomorphic.bib | 17 | `predicate-discovery`, `formal-methods` |
-| priority-reading-list.bib | 20 | `preprint-candidate` |
-| eastern-narratives.bib | 27 | `eastern-tradition`, `preprint-candidate` |
-| books2series_references.bib | 164 | `preprint-candidate` |
-| **Total** | **239** | |
-
-## Phase 4: Manual Additions from .md Files
-
-Added from reference-list.md (not in any .bib):
-- Genette 1980 — Narrative Discourse (from AwesomeLogic2Read)
-- Campbell — Hero with a Thousand Faces (from AwesomeLogic2Read)
-- Zhang 2025 — SeriesBench (from AwesomeLogic2Read)
-- Karpathy 2023 — Software 3.0 (created new)
-- Gius & Vauth 2022 — Event-Based Plot Model (created new)
-- Freytag 1863 — Technique of the Drama (created new)
-- Hull 2025 — Narrative Context Protocol (created new)
-- Ruchansky 2025 — Netflix Knowledge Graphs (created new)
-
-## Duplicates Merged: 3
-
-- Castricato 2021 — Towards a Model-Theoretic View of Narratives
-- Riedl & Young 2010 — Narrative Planning: Balancing Plot and Character
-- Diakidoy 2014 — Non-Monotonic Reasoning and Story Comprehension
-
-## Tags in Use
-
-**By purpose:** `preprint-candidate`, `awesome-candidate`, `confirmed`
-**By theme:** `narrative-theory`, `formal-methods`, `story-generation`, `evaluation`, `eastern-tradition`, `prompting`, `planning`, `predicate-discovery`
-
-## NOT Touched
-
-- notGoof (rejected papers)
-- AwesomeLogic2Read (3531 — unprocessed reservoir)
-- AwesomeEvaluation (752 — unprocessed reservoir)
-
-## Old Collections
-
-Kept as-is (items belong to multiple collections, no data loss).
diff --git a/docs/knowledge/archive/plans/bibliography-narrative-and-autoresearch.md b/docs/knowledge/archive/plans/bibliography-narrative-and-autoresearch.md
deleted file mode 100644
index cf1d8aa..0000000
--- a/docs/knowledge/archive/plans/bibliography-narrative-and-autoresearch.md
+++ /dev/null
@@ -1,136 +0,0 @@
----
-type: note
-project: tvplotlines
-status: active
----
-
-# Bibliography: Narrative Analysis + Autoresearch
-
-Собрано 2026-03-16. Две темы: (1) computational narratology и метрики для event functions, (2) автоматическая оптимизация промптов (autoresearch подходы).
-
----
-
-## Computational Narratology & Narrative Arc Detection
-
-### Turning Point Identification
-
-**Papalampidi et al. (2019)** — Movie Plot Analysis via Turning Point Identification.
-5 turning points в синопсисах фильмов (opportunity, change of plans, point of no return, major setback, climax). Аннотированный датасет, нейросетевая модель, метрика — accuracy + distance от правильной позиции. **Прямо наша задача — но для фильмов, не сериалов.**
-- https://arxiv.org/abs/1908.10328
-
-### Narrative Theory + NLP
-
-**Piper, So, Bamman (2021)** — Narrative Theory for Computational Narrative Understanding. EMNLP.
-Связывает теорию нарратива из гуманитарных наук с NLP методами. Открывает новые эмпирические вопросы.
-- https://aclanthology.org/2021.emnlp-main.26/
-
-### Story Arc Structure
-
-**Reagan et al. (2020)** — The Narrative Arc: Revealing Core Narrative Structures through Text Analysis. Science Advances.
-Три нарративных процесса: staging, plot progression, cognitive tension. Анализ ~40,000 текстов.
-- https://www.science.org/doi/10.1126/sciadv.aba2196
-
-### Narrative Analysis via ML
-
-**Jhala (2020)** — Three Stage Narrative Analysis: Plot-Sentiment Breakdown, Structure Learning and Concept Detection.
-Трёхэтапный анализ: разбивка по сентименту, обучение структуре, детекция концептов.
-- https://arxiv.org/html/2511.11857
-
-### LLM for Story Analysis (2026)
-
-**Narrative Theory-Driven LLM Methods for Automatic Story Analysis (2026).**
-Свежая работа — LLM для автоматического анализа нарративной структуры. **Прямой конкурент/родственник tvplotlines.**
-- https://arxiv.org/pdf/2602.15851
-
-### Benchmarks
-
-**NarraBench (2025)** — A Comprehensive Framework for Narrative Benchmarking.
-Бенчмарк для narrative understanding: dialogue, plot arcs, genre classification.
-- https://arxiv.org/html/2510.09869
-
-**SeriesBench (2025)** — A Benchmark for Narrative-Driven Drama Series Understanding.
-1,072 видео, задачи на понимание нарратива в сериалах. MLLMs описывают действия но плохо понимают inter-character relationships.
-- https://arxiv.org/html/2504.21435v1
-
-### TV Series Narrative Extraction
-
-**Balestri & Pescatore (2025)** — Multi-Agent System for AI-Assisted Extraction of Narrative Arcs in TV Series.
-Наша reference-статья. Grey's Anatomy, три типа арок (Anthology, Soap, Genre-Specific). ICAART 2025.
-- https://arxiv.org/abs/2503.04817
-
-**Balestri & Pescatore (2025)** — Narrative Memory in Machines: Multi-Agent Arc Extraction in Serialized TV.
-Расширение предыдущей. LLM как semantic memory + vector DB как episodic memory.
-- https://arxiv.org/html/2508.07010v1
-
----
-
-## Autoresearch & Automated Prompt Optimization
-
-### Karpathy Autoresearch (2026)
-
-**Karpathy (2026)** — autoresearch: Autonomous LLM Experimentation.
-630 строк кода. Агент модифицирует training code, запускает 5-мин эксперимент, проверяет метрику, keep/discard. 126 экспериментов за ночь, 700 за 2 дня. Loss: 0.9979 → 0.9697. "Time to GPT-2": 2.02h → 1.80h (11%).
-- https://github.com/karpathy/autoresearch
-
-### OPRO (Google DeepMind)
-
-**Yang et al. (2023)** — Large Language Models as Optimizers (OPRO).
-LLM оптимизирует промпты для другого LLM в feedback loop. 47% лучше человеческих экспертов на MATH.
-- Meta-optimization: LLM генерирует и улучшает промпты итеративно.
-
-### DSPy (Stanford NLP)
-
-**Khattab et al.** — DSPy: Programming—not Prompting—Language Models.
-Фреймворк для автоматической оптимизации промптов. С хорошей метрикой и данными можно автоматически оптимизировать промпт без ручного редактирования.
-- https://github.com/stanfordnlp/dspy
-- MIPRO optimizer — SOTA для discrete prompt optimization.
-
-### GAAPO (2026)
-
-**GAAPO** — Genetic Algorithm Applied to Prompt Optimization.
-Гибридный фреймворк: генетический алгоритм эволюционирует промпты через поколения.
-- https://www.frontiersin.org/journals/artificial-intelligence/articles/10.3389/frai.2025.1613007/full
-
-### promptolution (2025)
-
-**promptolution** — A Unified, Modular Framework for Prompt Optimization.
-Реализует OPRO, EvoPromptDE, EvoPromptGA, и CAPO (SOTA discrete prompt optimizer).
-- https://arxiv.org/html/2512.02840v1
-
-### Self-Refine
-
-**Madaan et al. (2023)** — Self-Refine: Iterative Refinement with Self-Feedback.
-LLM генерирует → оценивает → улучшает в цикле без внешнего supervision.
-- https://arxiv.org/abs/2303.17651
-
-### IMPROVE (2025)
-
-**IMPROVE** — Iterative Model Pipeline Refinement and Optimization Leveraging LLM Agents.
-Полностью автономный фреймворк: LLM-агенты конструируют, тренируют и итеративно улучшают пайплайн.
-- https://arxiv.org/html/2502.18530v1
-
-### LLMs in Scientific Discovery (2025)
-
-**From Automation to Autonomy: A Survey on Large Language Models in Scientific Discovery.**
-Обзор: LLM переходят от автоматизации к автономии в научных исследованиях.
-- https://arxiv.org/html/2505.13259v1
-
----
-
-## Relevance to tvplotlines
-
-**Для метрики event functions:**
-- Papalampidi (turning points) — closest work, но для фильмов. Их 5 turning points ≈ наши 7 functions. Метрика: accuracy + distance.
-- NarraBench / SeriesBench — бенчмарки для валидации.
-
-**Для autoresearch v3:**
-- Наш autoresearch ≈ Karpathy's autoresearch (тот же loop: change → test → keep/revert).
-- DSPy/OPRO — более формальные подходы к prompt optimization, можно изучить для идей.
-- Self-Refine — LLM оценивает свой output и улучшает (похоже на наш Pass 3).
-
-**Для awesome list / preprint:**
-- Все статьи по computational narratology — related work.
-- Balestri & Pescatore — direct predecessor.
-
-**Limitation of DSPy/OPRO/promptolution for our use case:**
-These frameworks optimize short prompts ("classify this as..."). Our prompts are 200+ line specifications with tables, examples, and rules. Automated generation from scratch is not feasible. Our autoresearch is closer to Karpathy's approach: modify one element in a large, tested prompt → test → keep/revert. This is a meaningful difference worth noting in the preprint.
diff --git a/docs/knowledge/archive/plans/blog-post-guide.md b/docs/knowledge/archive/plans/blog-post-guide.md
deleted file mode 100644
index e66117b..0000000
--- a/docs/knowledge/archive/plans/blog-post-guide.md
+++ /dev/null
@@ -1,79 +0,0 @@
----
-type: ref
-tags: [methodology, blog, writing]
-project: preprint
-status: active
----
-
-# Blog Post Guide
-
-How to write posts for birdinthetree.github.io/blog from existing reading
-notes in `books2series/research/vault/readings/`.
-
-## Relationship to other formats
-
-| Format | Purpose | Location |
-|--------|---------|----------|
-| **Reading note** (9 sections) | Deep analysis for the project | `books2series/.../readings/` |
-| **Paper summary** (4 sections) | Lit review for preprint | `plotter_docs/preprint/sources/` |
-| **Blog post** (this format) | External audience, grouped by task | `birdinthetree.github.io/src/content/blog/` |
-
-Reading notes are the raw material. Blog posts synthesize multiple notes
-around a single engineering task.
-
-## Principles
-
-1. **One task, not one paper.** Each post answers: "I'm building a narrative
-   system and I need to ___." Then shows which formal methods help.
-
-2. **Engineer-first.** The reader builds LLM pipelines. They don't care
-   about modal logic for its own sake — they care that epistemic logic
-   solves their "who knows what" tracking problem.
-
-3. **Your experience is the hook.** The unique value is: you read the paper,
-   you tried to use it, here's what happened. Not a survey — a field report.
-
-4. **No internal references.** Reading notes reference Q3, Q10, Q31 etc.
-   Blog posts must be self-contained. Replace internal refs with the
-   actual problem statement.
-
-5. **Show the bridge.** Every post must connect: formal method → concrete
-   prompt / data model / algorithm → result or insight.
-
-## Template
-
-See [TEMPLATE for blog post.md](TEMPLATE%20for%20blog%20post.md).
-
-## How to write a post from existing reading notes
-
-1. **Pick a task** from the awesome-narrative-ai section list:
-   Story World, Characters & Arcs, Causality, Story Structure,
-   Audience & Author, Consistency & Verification, Genre,
-   Generation & Planning, Evaluation & Metrics.
-
-2. **Pull 2-4 reading notes** that address this task. Use their
-   Section 2 (task + solution) and Section 8 (integration potential)
-   as source material.
-
-3. **Write the Problem section** from Section 2 of the strongest note.
-   Strip project-specific language. Frame as a universal task any
-   narrative engineer faces.
-
-4. **Write the Approaches section** by comparing the 2-4 papers.
-   Use Section 4 (where it works / doesn't) to show tradeoffs.
-   One paragraph per paper, not one section.
-
-5. **Write the Bridge section** from Section 8 of the notes —
-   this is where your unique expertise shows. What did you actually
-   try? What worked? What broke?
-
-6. **Write the Takeaway** — the one thing the reader should remember.
-   Concrete: a prompt pattern, a data structure, a design principle.
-
-## Series structure
-
-Posts form a series "What Logic Can Do for Stories" (working title).
-Each post is standalone but they share:
-- Same audience (narrative AI engineers)
-- Same structure (problem → approaches → bridge → takeaway)
-- Cross-links to related posts and to awesome-narrative-ai entries
diff --git a/docs/knowledge/archive/plans/career-plan.md b/docs/knowledge/archive/plans/career-plan.md
deleted file mode 100644
index b923c1d..0000000
--- a/docs/knowledge/archive/plans/career-plan.md
+++ /dev/null
@@ -1,36 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# Career Plan
-
-Цель: академическая и профессиональная видимость вокруг tvplotlines.
-
-## Фаза 1 — Фундамент
-- [ ] Открытый tvplotlines repo на GitHub (библиотека)
-- [ ] Preprint на arXiv (описание метода)
-  - [ ] После публикации: обновить Citation в README (добавить arXiv DOI)
-
-## Фаза 2 — GitHub Pages сайт
-Один сайт, всё вместе:
-- [ ] Резюме / CV
-- [ ] Блог с summaries статей (прочитанных во время работы над tvplotlines)
-- [ ] tvplotlines demo viewer (статический JS, ~20 готовых результатов)
-  - Переписать viewer с FastAPI+Jinja2 на статический JS
-  - Заодно улучшить UI
-  - Analytics: каждый график на полную ширину, не по 2 в ряд
-  - Analytics: добавить описание/интерпретацию к каждому графику
-  - Analytics: tension curves — переосмыслить или убрать (сейчас бесполезны)
-  - Терминология в viewer: storyline → plotline везде в UI
-  - Series selector: показывать полное название шоу из JSON, не slug
-
-## Фаза 3 — Расширение
-- [ ] Awesome list — неформальные логики применительно к нарративу
-
-## Терминология
-- [ ] Переименовать `Event.storyline` → `Event.plotline` в коде, промптах, тестах и результатах (breaking change)
-
-## Фаза 4 — Монетизация (когда будет спрос)
-- [ ] Lemon Squeezy лицензия для полного tvplotlines-app
diff --git a/docs/knowledge/archive/plans/design-decisions.md b/docs/knowledge/archive/plans/design-decisions.md
deleted file mode 100644
index 8579463..0000000
--- a/docs/knowledge/archive/plans/design-decisions.md
+++ /dev/null
@@ -1,467 +0,0 @@
----
-type: ref
-project: preprint
-status: active
-created: 2026-03-21
----
-
-# tvplotlines: Design Decision Registry
-
-
-An exhaustive list of design decisions, assumptions, and architectural choices that tvplotlines is built upon. For each decision: what exactly it is, where it lives, and what assumption stands behind it.
-
----
-## 1. Pipeline Architecture
-### 1.1.  LLM prompts with deterministic scaffolding and domain knowledge 
-
-- **Decision:** The pipeline is built around 4 prompts — context detection, plotline extraction, event assignment, structural review (the *what*)— connected by code that handles everything the LLM does not do well consitently (the *how*): validation, aggregation, orchestration, and correction. 
-- The number of actual LLM calls is more than 4 as pass 1 has 3 voting rounds and pass 2 works over N episodes, and any call may be retried up to 2 times on validation errors.
-- **Where:** `pipeline.py:1`, `prompts/pass{0,1,2,3}.md`, table in `README.md:119-124`
-- **Assumption:** A single LLM task "extract everything at once" yields worse results than a flow of specialized prompts with code between them [^1]. `pass1_merged.py` and `ablation_pass0.py` exist as ablation studies investigating how many prompts are actually needed.
-
-### 1.2. Pass order: context first, then plotlines, then events
-- **Decision:** Context (franchise_type, story_engine) is determined first and passed forward as input.
-- **Where:** `pipeline.py:128-130` (Pass 0), `pass0.md:6-8`
-- **Assumption:** Franchise type is a classification of TV series by their narrative structure. Four types: **procedural** (self-contained episode stories, e.g. House — each week a new case), **serial** (season-long arcs, e.g. Breaking Bad), **hybrid** (procedural engine + serialized arcs, e.g. X-Files), **ensemble** (multiple co-equal protagonists, e.g. Game of Thrones). The taxonomy draws on Douglas (*Writing the TV Drama Series*), Nash (*Television Storytelling*), and Mittell (*Complex TV*). Each type sets different expectations for plotline structure: procedural = 1 episodic + 1-2 serialized; serial = 3-8 season-spanning; ensemble = 4-6 parallel.
-
-  This decision parallels Zwaan's (1993) finding that readers activate different **cognitive control systems** depending on discourse type — a news reader and a literary reader process the same text differently because genre signals switch their comprehension strategy. We assume Pass 0 does the same for the LLM: determining franchise type switches the model into a specific "reading mode" that shapes how it granulates plotlines in Pass 1.
-
-  Original hypothesis: context must be a separate LLM call before extraction. The ablation study showed that the task "determine context + extract plotlines" can be combined within a single prompt — separation within the instruction is sufficient, a separate LLM call is not mandatory.
-
-### 1.3. Pass 1 receives ALL synopses, Pass 2 — one at a time
-- **Decision:** Pass 1 sees the entire season to identify season-spanning plotlines. Pass 2 processes one episode at a time.
-- **Where:** `pass1.py:107-173` (all synopses), `pass2.py:33-101` (one synopsis)
-- **Assumption:** Identifying season-spanning plotlines requires an overview of the whole season. Assigning events to those plotlines requires only one episode + the plotline list. This separation enables parallelization of Pass 2 — a decision made for speed and cost efficiency (parallel calls with short context are cheaper than a single long one).
-
-### 1.4. System/user prompt split in Pass 2 — architecture for caching
-- **Decision:** In Pass 2, the instruction + series context + plotline list go into the system prompt (immutable part); the synopsis of a single episode goes into the user prompt (variable part). The immutable portion of the prompt is cached across all episodes.
-- **Where:** `pass2.py:85-101` (system prompt assembly), `pass2.py:98` (`cache_system=True`)
-- **Assumption:** Cost savings via prompt caching — the system prompt contains ~80% of call tokens and is reused for all episodes in a season.
-
-### 1.5. Pass 2 is parallel, Pass 1 is not
-- **Decision:** Pass 2 runs for all episodes simultaneously (async). Pass 1 runs three parallel calls (majority voting, see 1.7).
-- **Where:** `pipeline.py:144-146`, `pass2.py:162-201` (assign_events_parallel), `llm.py:240-284` (acall_llm_parallel)
-- **Assumption:** Episodes in Pass 2 are independent of each other — each has its own synopsis, the same plotline set, the same system prompt. System prompt caching makes parallel calls cheaper.
-
-### 1.6. Pass 3 exists as a separate pass
-- **Decision:** Structural revision after Pass 1+2, rather than "get it right the first time."
-- **Where:** `pass3.md:12-14`, `pipeline.py:176-190`
-- **Assumption:** Pass 1 does not see events. Pass 2 cannot modify the plotline list. Between them lies a gap: Pass 2 discovers problems (via patches) but cannot fix them. Pass 3 is the first to see the full picture (plotlines + all events + span + weight) and can make decisions: MERGE, REASSIGN, PROMOTE, DEMOTE, CREATE, DROP. The alternative — iteratively rerunning Pass 1+2 until stabilization — is more expensive and less predictable.
-
-### 1.7. Majority voting in Pass 1, but not in Pass 2
-- **Decision:** Pass 1 runs 3 times in parallel; the result with the most frequent plotline ID set is selected.
-- **Where:** `pass1.py:19` (`_VOTING_ROUNDS = 3`), `pass1.py:148-165`
-- **Assumption:** Plotline identification is the most subjective part of the pipeline. Different runs may produce different plotline sets. Voting stabilizes the result. Pass 2 binds events to already-fixed plotlines — less variability, voting is unnecessary. The consistency metric (ARI) measures precisely the stability of Pass 1.
-
-### 1.8. Post-processing is code, not LLM
-- **Decision:** span, weight, orphan assignment, rank validation — all computed by code.
-- **Where:** `postprocess.py` (entire file), `pipeline.py:171-173`
-- **Assumption:** These operations are deterministic aggregations. An LLM is not needed to count events or determine which episodes a plotline appears in. Code is faster, cheaper, and deterministic.
-
-### 1.9. Verdicts are code, not LLM
-- **Decision:** Pass 3 outputs JSON with verdicts that are applied by code (`verdicts.py`).
-- **Where:** `verdicts.py` (entire file), `pipeline.py:184-188`
-- **Assumption:** The LLM makes the decision (MERGE, REASSIGN...), but mechanical application (moving events, deleting plotlines) is the code's job. This separation allows validating verdicts before applying them and guarantees consistency.
-
-### 1.10. The library is stateless — the caller stores results
-- **Decision:** `get_plotlines()` is a pure function. No database, no files, no state between calls.
-- **Where:** `pipeline.py:33-199`, `CLAUDE.md:8-9`, `docs/2026-03-16-prior-season-continuity-design.md:141`
-- **Assumption:** The library is computation, not a product. Persistence is the application's responsibility (tvplotlines-app).
-
-### 1.11. Pipeline resumability — intermediate results can be supplied
-- **Decision:** Parameters `context`, `cast`, `plotlines`, `breakdowns` allow skipping the corresponding passes.
-- **Where:** `pipeline.py:39-47`, `pipeline.py:128-167`
-- **Assumption:** The pipeline can fail at any step. The user should be able to resume from where it stopped without restarting everything.
-
-### 1.12. Multi-season via the `prior` parameter
-- **Decision:** `prior: TVPlotlinesResult` is the only way to pass context from a previous season.
-- **Where:** `pipeline.py:38`, `docs/2026-03-16-prior-season-continuity-design.md:140-145`
-- **Assumption:** One parameter instead of two (`prior_cast` + `prior_plotlines`). The library remains stateless. The caller stores results and chains: `r2 = get_plotlines(..., prior=r1)`. Anthology format is blocked (`ValueError`) because anthology seasons are independent by definition.
-
----
-
-## 2. Prompt Design
-
-### 2.1. Theoretical framework: Story DNA
-- **Decision:** A plotline is defined through four components: driver + goal + obstacle + stakes.
-- **Where:** `pass1.md:43-44`, `pass3.md:27-29` (Nash p.34 quote)
-- **Assumption:** Story DNA is the minimal sufficient abstraction for describing narrative conflict. Source: Nash, "Television Storytelling." Without any of the four components, it is not a plotline but an event or a runner.
-
-### 2.2. Franchise type — 4 types
-- **Decision:** Classification: procedural, serial, hybrid, ensemble.
-- **Where:** `pass0.md:24-32`
-- **Assumption:** These four types cover the vast majority of TV series. Each type sets different expectations for the number and structure of plotlines. Sources: Douglas, Nash, Mittell. There is no "miniseries" as a separate franchise type — that is `format: limited`, orthogonal to structure.
-
-### 2.3. Story engine — templates by type
-- **Decision:** For each franchise type, a story engine template with fillable slots.
-- **Where:** `pass0.md:37-56`
-- **Assumption:** The template constrains the LLM from free-form speculation and provides a structured description. Procedural: "each week, a [profession] solves a [problem], testing [quality]." Serial: "[protagonist] [transformation], testing how far they will go for [goal]." Hybrid and Ensemble follow analogous patterns.
-
-### 2.4. A/B/C/runner — rank hierarchy
-- **Decision:** Four levels: A (primary), B (secondary), C (tertiary), runner (incomplete).
-- **Where:** `pass1.md:56-63`
-- **Assumption:** The TV industry standardly uses A/B/C to denote plotline weight (Douglas). Runner is added for plotlines without obstacle/resolution — they exist in TV series but lack full conflict. Constraint: serial/procedural/hybrid have exactly 1 A-plotline; ensemble has 2+ A-plotlines (`pass1.py:257-268`).
-
-### 2.5. Granularity: by GOAL, not by character
-- **Decision:** A single character can drive multiple plotlines with different goals.
-- **Where:** `pass1.md:78-83`
-- **Assumption:** LLMs tend to group everything "about Walt" into one plotline. The explicit instruction "the key is the goal, not the character" + the naming format `Driver: Theme` counteracts this bias. Example: Walt drives both "Empire" (drug business) and "Family" (hiding the truth from Skyler).
-
-### 2.6. Naming format: `Driver: Theme`
-- **Decision:** A plotline name always follows the format `Driver: Theme` (e.g., "Walt: Empire," "Hank: Investigation").
-- **Where:** `pass1.md:103` (RU), `pass1_en.md:106` (EN)
-- **Assumption:** The format makes explicit who drives the plotline and prevents confusion when assigning events in Pass 2. Without it, the LLM might name a plotline "Drug Business" — and then it is unclear whether it belongs to Walt or Jesse.
-
-### 2.7. "What is NOT a plotline" — negative examples
-- **Decision:** A table of 5 counter-examples: background, setting, state, context, franchise engine.
-- **Where:** `pass1.md:86-95`
-- **Assumption:** Without negative examples, LLMs tend to create false plotlines from background details. "When in doubt — do NOT create a plotline" — conservative bias.
-
-### 2.8. Plotline types: episodic, serialized, runner
-- **Decision:** Three types, not two. Episodic — for franchise engine, serialized — season-spanning, runner — incomplete.
-- **Where:** `pass1.md:49-53`
-- **Assumption:** Runner is a deliberate choice: rather than discarding plotlines without an obstacle, they are labeled. This allows Pass 3 to decide their fate.
-
-### 2.9. For procedural/hybrid — exactly one episodic plotline
-- **Decision:** Code validates: `episodic_count != 1` → error.
-- **Where:** `pass1.py:247-254`, `pass1.md:50`
-- **Assumption:** The franchise engine (case-of-the-week) is ONE recurring structure, not N separate stories. The specific content of each episode is handled in Pass 2.
-
-### 2.10. Nature: plot-led vs character-led
-- **Decision:** Two conflict categories: external (plot-led) and internal (character-led).
-- **Where:** `pass1.md:68-71`
-- **Assumption:** The distinction matters for understanding structure: the B-story is often character-led (carries the episode's theme), while the A-story is plot-led (advances the plot).
-
-### 2.11. Confidence: solid, partial, inferred
-- **Decision:** Three confidence levels for a plotline's Story DNA.
-- **Where:** `pass1.md:221`, `pass3.md:33-38`
-- **Assumption:** TV series can be poorly written. A plotline may exist without a clear goal, with nominal conflict. Instead of discarding it, we mark confidence. "A weak plotline in a bad script is data, not an error" (pass3.md:39).
-
-### 2.12. Event functions: 7 types
-- **Decision:** setup, escalation, turning_point, climax, resolution, cliffhanger, seed.
-- **Where:** `pass2.md:38-49`
-- **Assumption:** A minimal set covering three-act structure + TV-specific functions (cliffhanger, seed). Seed — the germ of a future plotline, distinct from setup. Cliffhanger — a break at the peak, distinct from climax.
-
-### 2.13. Narrative devices: 6 types
-- **Decision:** dramatic_irony, flashback, flashforward, callback, twist, unreliable — at the plotline level (Pass 1) and at the event level (Pass 2).
-- **Where:** `pass1.md:105-118`, `pass2.md:51-63`
-- **Assumption:** Devices characterize a plotline across the entire season, not as a one-time occurrence. Pass 1 outputs devices for a plotline; Pass 2 uses them as hints when annotating events.
-
-### 2.14. Interactions between plotlines: 4 types
-- **Decision:** thematic_rhyme, dramatic_irony, convergence, meta.
-- **Where:** `pass2.md:67-73`
-- **Assumption:** Plotlines do not exist in a vacuum. Thematic rhyme is a key TV narrative device (Douglas). Convergence is the intersection of plotlines. Meta is a structural device operating above plotlines (wraparound, twist-reveal, time_jump).
-
-### 2.15. Emotional counterpoint as a check
-- **Decision:** "If all plotlines are rising or all are falling — something is missed or the functions are wrong."
-- **Where:** `pass2.md:75`
-- **Assumption:** Good TV narrative alternates emotional registers. This is a heuristic for LLM self-checking.
-
-### 2.16. Patches — Pass 2 does not rerun Pass 1
-- **Decision:** Pass 2 collects suggestions (patches: ADD_LINE, CHECK_LINE, SPLIT_LINE, RERANK) but cannot modify the plotline list.
-- **Where:** `pass2.md:231-240`
-- **Assumption:** Pass 2 processes one episode at a time. It lacks the full picture to modify the global plotline list. Patches are hints for Pass 3, which sees everything.
-
-### 2.17. also_affects — double bump
-- **Decision:** An event is bound to one plotline; incidentally affected plotlines go in `also_affects`.
-- **Where:** `pass2.md:34` (rule 4), `models.py:57`
-- **Assumption:** An event can pertain to two plotlines (Walt killing Krazy-8 is both empire and family). Instead of duplication — one binding + cross-reference.
-
-### 2.18. Weight is computed by code, not the LLM
-- **Decision:** The Pass 2 prompt explicitly prohibits including weight in the JSON: "Weight is computed by code from event counts — do NOT include it in JSON."
-- **Where:** `pass2.md:81`, `postprocess.py:83-111`
-- **Assumption:** Weight is an objective metric (primary/background/glimpse), determined by thresholds: ≥50% of max = primary, ≥2 events = background, otherwise glimpse. These thresholds are hardcoded (`postprocess.py:104-109`).
-
-### 2.19. Pass 3 — the "Hollywood story editor" role
-- **Decision:** The Pass 3 prompt assigns a specific role: a story editor who is the first to see the full picture.
-- **Where:** `pass3.md:12-14`
-- **Assumption:** Framing helps the LLM understand the task: not "find errors" but "look at the result as a whole, as an editor, and decide whether corrections are needed."
-
-### 2.20. Pass 3 — "if everything is fine, return an empty array"
-- **Decision:** An explicit instruction not to fabricate problems.
-- **Where:** `pass3.md:174`
-- **Assumption:** LLMs tend to "be helpful" and find problems even when there are none. Without this instruction, Pass 3 would generate false verdicts.
-
-### 2.21. The Pass 3 prompt references theory with citations
-- **Decision:** Quotes from Nash p.34, Oberg p.60, Douglas p.132 are embedded in the prompt.
-- **Where:** `pass3.md:29`, `pass3.md:49`, `pass3.md:59`
-- **Assumption:** Book citations anchor the LLM to a specific theoretical framework rather than general knowledge from training data. This improves decision quality.
-
-### 2.22. Two prompt languages: Russian and English
-- **Decision:** Prompts exist in two versions: `prompts/` (RU) and `prompts_en/` (EN).
-- **Where:** `prompts/__init__.py:10-25`, `llm.py:98` (`lang: str = "ru"`)
-- **Assumption:** Prompt language affects output quality. Russian is the default (original development language). English is for international audiences and potentially better quality on English-language synopses. Fields goal/obstacle/stakes are in the synopsis language.
-
-### 2.23. Event specificity — explicit instruction
-- **Decision:** "Event descriptions must be specific. Name the characters, state exactly what happens, and what dramatic consequence it leads to."
-- **Where:** `pass2.md:22-23`
-- **Assumption:** Without this instruction, LLMs tend to write generic descriptions ("the team works on a case"), making correct plotline assignment impossible.
-
-### 2.24. Response format — strictly JSON, no markdown
-- **Decision:** "Response must be strictly JSON, no markdown wrapping, no comments outside JSON." Repeated in every prompt.
-- **Where:** `pass0.md:60`, `pass1.md:134`, `pass2.md:79`, `pass3.md:98`
-- **Assumption:** LLMs tend to wrap JSON in ```json``` blocks. The instruction tries to prevent this. The code in `_extract_json()` can still parse markdown wrappers as a fallback (`llm.py:596-610`).
-
-### 2.25. Binding rule: by goal, not by character
-- **Decision:** "Multiple characters in a scene → the plotline of the one whose GOAL the scene advances."
-- **Where:** `pass2.md:33`
-- **Assumption:** Counters LLM bias: without this rule, the model assigns an event to the plotline of a character who is merely present in the scene, not the one whose goal the scene advances.
-
-### 2.26. Frequency hint — B-story check
-- **Decision:** "B-story = 1-2 scenes per act. If a plotline has more events than the A → recheck the hierarchy."
-- **Where:** `pass2.md:35`
-- **Assumption:** A quantitative heuristic for LLM self-checking. Helps detect hierarchy errors.
-
-### 2.27. Prior season — three decisions for each plotline
-- **Decision:** For each prior plotline, the LLM explicitly chooses: CONTINUES, TRANSFORMED, or ENDED.
-- **Where:** `pass1.md:26-28`, `docs/2026-03-16-prior-season-continuity-design.md:142`
-- **Assumption:** Forcing an explicit decision reduces hallucination. "Prior is a hint, not a constraint" — the LLM is free to decide that a plotline has ENDED, but must do so explicitly.
-
-### 2.28. Seed and wraparound are NOT plotline types
-- **Decision:** An explicit prohibition on creating plotlines of type "seed" or "wraparound."
-- **Where:** `pass1.md:73-74`
-- **Assumption:** LLMs may create a plotline "Seed: Future Plot" — this is not a plotline but an event function or a meta device.
-
-### 2.29. Format (ongoing/limited/anthology) affects expectations
-- **Decision:** limited → all plotlines should receive resolution; ongoing → cliffhanger is acceptable; anthology → do not reference other seasons.
-- **Where:** `pass1.md:122-124`, `pass2.md:49`
-- **Assumption:** Format is a characteristic orthogonal to franchise type. A limited series in its final episode expects resolution, not seed.
-
-### 2.30. Quantitative expectations by type
-- **Decision:** Procedural: 2-3 plotlines per episode. Serial: 3-8 per season. Ensemble: 4-6.
-- **Where:** `pass1.md:128-131`
-- **Assumption:** Numbers are based on analysis of real TV series (Nash, Douglas). They set a frame for the LLM to avoid generating 20 plotlines or 1.
-
----
-
-## 3. Data Model
-
-### 3.1. Story DNA: driver, goal, obstacle, stakes
-- **Decision:** Four fields — the core of Plotline.
-- **Where:** `models.py:37-40`
-- **Assumption:** This is the minimal sufficient set for describing narrative conflict. Nash p.34: "Story DNA has four parts: Hero, Goal, Obstacle, Stakes." Goal — what the hero wants. Obstacle — what stands in the way. Stakes — what is at risk.
-
-### 3.2. Rank A/B/C/runner — enum, not a number
-- **Decision:** A text enum, not a numeric value.
-- **Where:** `models.py:42`
-- **Assumption:** A/B/C is standard industry terminology. Runner is not "D" but a separate category (incomplete Story DNA).
-
-### 3.3. Cast with id, name, aliases
-- **Decision:** Each character has a stable id, a full name, and a list of aliases.
-- **Where:** `models.py:23-28`
-- **Assumption:** Synopses use different name forms (Walt, Walter White, Heisenberg, Mr. White). Aliases allow the LLM in Pass 2 to correctly identify characters. The id is stable — it does not change between seasons.
-
-### 3.4. Guest characters — `guest:short_name` format
-- **Decision:** Guest characters are not included in the cast but are marked with the `guest:` prefix.
-- **Where:** `pass2.md:203`, `pass2.py:330-335`
-- **Assumption:** Guest characters appear in one episode. Creating a full CastMember for them is overengineering. Plotlines belong to the cast, not to guests.
-
-### 3.5. Span is computed post-hoc from Pass 2
-- **Decision:** Plotline.span is not determined by the LLM — it is computed by code from event presence.
-- **Where:** `pass1.md:226`, `postprocess.py:13-29`
-- **Assumption:** Span is an objective metric: a plotline is present in an episode if it has at least one event. An LLM is not needed for counting.
-
-### 3.6. Verdict — action + data dict
-- **Decision:** A Verdict stores an action (MERGE/REASSIGN/...) and an arbitrary dict with data.
-- **Where:** `models.py:93-97`
-- **Assumption:** Different verdict types have different fields (MERGE: source/target; REASSIGN: event/episode/from/to; CREATE: plotline/reassign_events). Instead of a class hierarchy — a simple dict with an action key.
-
-### 3.7. EpisodeBreakdown includes theme and interactions
-- **Decision:** Beyond events, each episode contains a theme and inter-plotline relationships.
-- **Where:** `models.py:82-89`
-- **Assumption:** The episode theme and interactions (thematic_rhyme, dramatic_irony, convergence, meta) are valuable data for analysis, not only for Pass 3.
-
-### 3.8. Patch — a suggestion, not a command
-- **Decision:** A Patch from Pass 2 contains action, target, reason, episodes. But it is not applied automatically.
-- **Where:** `models.py:72-78`, `pass2.md:232-233`
-- **Assumption:** Pass 2 processes one episode at a time — it lacks the full picture. Patches are hints for Pass 3. The separate model (Patch vs Verdict) underscores the difference: Patch is a suggestion, Verdict is a decision.
-
-### 3.9. TVPlotlinesResult contains a usage summary
-- **Decision:** The result includes a string with request count, token count, and cost.
-- **Where:** `models.py:108`, `pipeline.py:198`
-- **Assumption:** The user wants to know how much a run costs. Usage is a string, not a structure (because the format depends on the provider).
-
----
-
-## 4. Engineering Decisions
-
-### 4.1. Anthropic as the default provider
-- **Decision:** `provider: str = "anthropic"`, default model: `claude-sonnet-4-20250514`.
-- **Where:** `llm.py:96`, `llm.py:115`
-- **Assumption:** Claude is the best model for long structured prompts with JSON output (based on the author's experience). But the pipeline is not locked in — OpenAI and any OpenAI-compatible APIs are supported.
-
-### 4.2. Prompt caching for Pass 2
-- **Decision:** The Pass 2 system prompt is cached across episodes (`cache_system=True`).
-- **Where:** `pass2.py:98`, `pass2.py:194-196`, `llm.py:449-457`
-- **Assumption:** All episodes in Pass 2 use the same system prompt. Caching saves ~90% on input tokens for the prompt (Anthropic: cache reads are 90% cheaper, `llm.py:63`).
-
-### 4.3. Retry with JSON validation
-- **Decision:** Up to 2 retries on JSON errors and validation failures. On retry, the previous response is included in context.
-- **Where:** `llm.py:25` (`_MAX_RETRIES = 2`), `llm.py:205-237`
-- **Assumption:** LLMs sometimes return invalid JSON (markdown wrapping, extraneous comments) or violate the schema. Retrying with a specific error indication usually fixes the problem.
-
-### 4.4. Retry with exponential backoff for network errors
-- **Decision:** Up to 3 retries for transient errors (APIConnectionError, RateLimitError, InternalServerError).
-- **Where:** `llm.py:26` (`_MAX_NETWORK_RETRIES = 3`), `llm.py:162-185`
-- **Assumption:** Network errors are transient. Exponential backoff (2s, 4s, 8s) avoids overloading the API.
-
-### 4.5. Batch API for Pass 2 (50% cheaper)
-- **Decision:** `pass2_mode="batch"` — Anthropic Batch API, 50% cheaper but slower.
-- **Where:** `llm.py:287-414`, `pipeline.py:149-155`
-- **Assumption:** For long seasons (22-episode House), batch yields significant savings. Fallback: if batch fails for individual requests — retry via the regular API.
-
-### 4.6. Async-first architecture with sync wrappers
-- **Decision:** All LLM calls are async (`acall_llm`). Sync wrappers (`call_llm`) use `asyncio.run()`.
-- **Where:** `llm.py:1-8`, `llm.py:527-588`
-- **Assumption:** Async enables parallel calls (Pass 2). Sync wrappers exist for ease of use in single-threaded code. Jupyter fix via `ThreadPoolExecutor` (`llm.py:534-538`).
-
-### 4.7. Temperature = 0
-- **Decision:** All LLM calls use temperature=0.
-- **Where:** `llm.py:462`, `llm.py:507`
-- **Assumption:** The task is extraction, not generation. Maximum determinism is needed. Voting in Pass 1 still provides variability through parallel calls.
-
-### 4.8. max_tokens = 6144
-- **Decision:** All calls use max_tokens=6144.
-- **Where:** `llm.py:461`, `llm.py:339`
-- **Assumption:** Pass 2 (one episode) typically uses 1000-3000 tokens. Pass 3 (all episodes) can be longer. 6144 provides headroom without overpaying for unused capacity.
-
-### 4.9. Orphan assignment — by character → storyline frequency
-- **Decision:** Orphaned events are assigned to the plotline most frequently associated with their characters.
-- **Where:** `postprocess.py:32-80`
-- **Assumption:** If the LLM returns `storyline: null`, it is most likely a binding error, not a genuinely unassignable event. Character frequency is a reasonable heuristic. Fallback: if a character has not appeared anywhere, the most frequent plotline in the episode is used.
-
-### 4.10. validate_ranks — automatic demotion of A-rank with short span
-- **Decision:** An A-rank plotline with span < 25% of the season → demote to B.
-- **Where:** `postprocess.py:114-120`, `postprocess.py:152-153`
-- **Assumption:** An A-plotline should be present in a significant portion of the season. 25% is an empirical threshold. The dominance threshold (>50% of events) is a flag for Pass 3, not an automatic action.
-
-### 4.11. PROMOTE to A is blocked for non-ensemble
-- **Decision:** Code blocks PROMOTE to A if an A-rank plotline already exists (except for ensemble).
-- **Where:** `verdicts.py:116-123`
-- **Assumption:** Serial/procedural/hybrid have exactly 1 A-plotline. This is an invariant that the code protects even if the LLM reviewer suggests otherwise.
-
-### 4.12. _extract_json — regex fallback
-- **Decision:** First `json.loads()`, then regex for ```json...``` blocks.
-- **Where:** `llm.py:596-610`
-- **Assumption:** Despite the "no markdown wrapping" instruction, models sometimes wrap anyway. Fallback is cheaper than retry.
-
-### 4.13. response_format: json_object — only for OpenAI
-- **Decision:** `response_format` is used only for `provider == "openai"`, not for Ollama/DeepSeek/Groq.
-- **Where:** `llm.py:509-511`
-- **Assumption:** Not all OpenAI-compatible providers support `response_format`. It is safer not to send it.
-
-### 4.14. Known providers with defaults
-- **Decision:** Ollama, DeepSeek, Groq are built in with default base_url and model.
-- **Where:** `llm.py:104-108`
-- **Assumption:** The user should not have to enter a URL and model for popular providers. Ollama: `localhost:11434/v1`, `qwen2.5:14b`. DeepSeek: `api.deepseek.com/v1`, `deepseek-chat`. Groq: `api.groq.com/openai/v1`, `llama-3.3-70b-versatile`.
-
-### 4.15. Hardcoded pricing
-- **Decision:** Per-token prices for claude-sonnet-4, haiku-4.5, gpt-4o are hardcoded.
-- **Where:** `llm.py:32-36`
-- **Assumption:** Prices change infrequently. This is sufficient for cost estimation. If the model is not in the dictionary — cost = 0.
-
-### 4.16. Callback pattern — not files
-- **Decision:** `PipelineCallback` — a subclass with methods `on_pass0_complete`, `on_pass1_complete`, etc.
-- **Where:** `callbacks.py`, `pipeline.py:23-30`
-- **Assumption:** The library does not write files. The caller decides what to do with intermediate results. Callbacks are wrapped in try/except so that a bug in a callback does not kill the pipeline.
-
-### 4.17. Metrics: coverage + ARI
-- **Decision:** Coverage = the fraction of events with a non-empty storyline. ARI = adjusted rand index across multiple runs.
-- **Where:** `metrics.py`
-- **Assumption:** Coverage is a simple completeness metric. ARI is a standard clustering metric that measures result stability (consistency). Used in the ablation study. The sklearn dependency is only for consistency, outside the core pipeline.
-
-### 4.18. Ablation study: baseline vs merged
-- **Decision:** The experiment compares the standard pipeline (4 passes) with merged (Pass 0+1 combined).
-- **Where:** `experiments/ablation_pass0.py`, `pass1_merged.py`, `prompts_en/pass1_merged.md`
-- **Assumption:** Hypothesis: a separate Pass 0 yields better quality because franchise type is determined before plotline analysis. The ablation tests this via coverage, ARI, tokens, and time.
-
-### 4.19. Episode keys — strict S{dd}E{dd} format
-- **Decision:** Episode keys must match the regex `^S\d{2}E\d{2}$`.
-- **Where:** `pipeline.py:20, 87-91`
-- **Assumption:** This is the standard episode identification format in the industry. The season number in the key must match the `season` parameter.
-
-### 4.20. Diagnostics — post-processing flags for Pass 3
-- **Decision:** validate_ranks generates flags (demoted, dominant) that are passed to Pass 3 as `diagnostics`.
-- **Where:** `pipeline.py:173, 179`, `pass3.md:22`
-- **Assumption:** Automated flags are objective data (computed by code) that help Pass 3 make decisions. They are context, not commands.
-
-### 4.21. Global usage tracker, reset per run
-- **Decision:** A global `UsageStats` object, reset on each `get_plotlines()` call.
-- **Where:** `llm.py:84`, `pipeline.py:125-126`
-- **Assumption:** A simple way to aggregate usage across all LLM calls. `usage.__init__()` is a reset. Not thread-safe, but not a problem within a single pipeline run.
-
----
-
-## 5. Assumptions (Implicit)
-
-### 5.1. Synopses (~300 words) contain sufficient signal
-- **Assumption:** The pipeline operates on synopses, not scripts. A synopsis provides ~300 words for a 45-minute episode. This is sufficient for identifying plotlines and key events.
-- **Where:** `README.md:9` ("Works from synopses alone — no scripts or transcripts needed"), `CLAUDE.md:25`
-- **Risk:** Synopses may omit B/C-plotlines, focusing on A. The confidence field partially compensates for this.
-
-### 5.2. The LLM possesses sufficient knowledge of narrative structure
-- **Assumption:** The model (Claude/GPT) knows what A/B/C stories, franchise engine, three-act structure, and story engine are — from training data.
-- **Where:** Prompts use professional terminology without definitions (except for franchise types and Story DNA).
-- **Risk:** Local models (Ollama/Qwen) may not know these concepts. The prompts contain enough context to compensate.
-
-### 5.3. Story DNA is the correct abstraction
-- **Assumption:** Four components (driver + goal + obstacle + stakes) are a sufficient and necessary abstraction for describing a plotline.
-- **Where:** `pass1.md:43-44`
-- **Risk:** Some narrative traditions (ensemble dramas, slice-of-life) may not fit this model. Confidence = inferred and runner provide partial compensation.
-
-### 5.4. Franchise type is stable within a season
-- **Assumption:** The type is determined from the first 2-3 episodes and applied to the entire season.
-- **Where:** `pass0.py:42` (episodes[:3])
-- **Risk:** Some series change structure mid-season (procedural → serial). Pass 0 will not detect this.
-
-### 5.5. Franchise type is stable across seasons
-- **Assumption:** With `prior`, the previous season's context is reused without re-evaluation.
-- **Where:** `pipeline.py:121`
-- **Risk:** Some series change type between seasons (The Wire: different focus each season). The user can pass `context` explicitly to override.
-
-### 5.6. One season is one unit of analysis
-- **Assumption:** The pipeline processes one season at a time. Cross-season analysis is out of scope.
-- **Where:** `pipeline.py:33-51`, `docs/2026-03-16-prior-season-continuity-design.md:134`
-- **Risk:** Plotlines that exist only between seasons (setup in S01 finale → payoff in S02 premiere) may be missed.
-
-### 5.7. 3 voting rounds are sufficient for stability
-- **Assumption:** `_VOTING_ROUNDS = 3` is enough for majority voting.
-- **Where:** `pass1.py:19`
-- **Risk:** At temperature=0, 3 rounds may yield the same result (no diversity). With an unstable model, 3 may be too few. But more rounds are more expensive (3x the cost of Pass 1).
-
-### 5.8. Sorting by storyline ID set is a sufficient agreement metric
-- **Decision:** Voting selects the result whose set of storyline IDs occurs most frequently.
-- **Where:** `pass1.py:155-161`
-- **Assumption:** ID set is a proxy for "plotline structure." If two runs yield the same IDs, they are assumed to agree on content (goal, obstacle, stakes may differ). This is a coarse metric, but fast.
-
-### 5.9. The LLM response in Pass 3 correctly references event text
-- **Assumption:** REASSIGN/DROP/CREATE require exact event text matches. If the LLM paraphrases, validation rejects it.
-- **Where:** `pass3.md:176`, `pass3.py:171-172`
-- **Risk:** LLMs tend to paraphrase. Retry should fix this, but it is not guaranteed.
-
-### 5.10. Verdict order does not matter (except CREATE → REASSIGN)
-- **Assumption:** `apply_verdicts` applies verdicts in the order received. CREATE adds an ID that may then be used in a REASSIGN within the same batch.
-- **Where:** `verdicts.py:37-56`, `pass3.py:139-145`
-- **Risk:** If REASSIGN precedes CREATE for the same ID, the verdict will not find the target. Validation accounts for `created_ids` during checking.
-
-### 5.11. Weight thresholds are empirical
-- **Assumption:** primary ≥ 50% of max, background ≥ 2 events, glimpse — everything else.
-- **Where:** `postprocess.py:104-109`
-- **Risk:** On seasons with few events per episode, the thresholds may be inadequate.
-
-### 5.12. Rank validation threshold — 25% span for A-rank
-- **Assumption:** An A-plotline must be present in at least 25% of the season's episodes.
-- **Where:** `postprocess.py:119` (`min_span_frac: float = 0.25`)
-- **Risk:** For short seasons (4-6 episodes), 25% = 1-2 episodes — may be too lenient.
-
-### 5.13. Prompts are self-contained documents
-- **Assumption:** Each prompt is a "self-contained document, fed to the LLM as-is" (line 1 of each prompt).
-- **Where:** `pass0.md:3`, `pass1.md:3`, `pass2.md:3`, `pass3.md:3`
-- **Risk:** When updating references, the prompt must be "reassembled." There is no automatic assembly — it is a manual process.
-
-### 5.14. The original is a from-scratch rewrite, not a fork
-- **Assumption:** tvplotlines is rewritten from scratch. Balestri & Pescatore (ICAART 2025) is an ideological source, not code.
-- **Where:** `CLAUDE.md:12-14`
-- **Risk:** Not applicable as a risk per se, but important for the preprint — proper citation is required.
-
-[^1]: Qiu, Libin, and others, ‘Blueprint First, Model Second: A Framework for Deterministic LLM Workflow’, arXiv:2508.02721, preprint, arXiv, 1 August 2025, doi:[10.48550/arXiv.2508.02721](https://doi.org/10.48550/arXiv.2508.02721)
diff --git a/docs/knowledge/archive/plans/docs-audit-2026-03-26.md b/docs/knowledge/archive/plans/docs-audit-2026-03-26.md
deleted file mode 100644
index ed04005..0000000
--- a/docs/knowledge/archive/plans/docs-audit-2026-03-26.md
+++ /dev/null
@@ -1,506 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# Аудит документации tvplotlines v0.1.0
-
-Дата: 2026-03-26
-
-## 1. Документация библиотеки (в репозитории)
-
-### 1.1 Обязательные файлы
-
-| Файл | Статус | Комментарий |
-|------|--------|-------------|
-| README.md | OK | Импорты, CLI, примеры — всё соответствует коду |
-| LICENSE (MIT) | OK | |
-| CHANGELOG.md | OK | Одна запись v0.1.0, для первого релиза достаточно |
-| CONTRIBUTING.md | OK | Setup, тесты, стиль — корректно |
-| pyproject.toml | OK | Метаданные, зависимости, classifiers — на месте |
-| .gitignore | OK | |
-| .github/workflows/test.yml | OK | Python 3.11-3.13, pytest |
-
-### 1.2 Документация для пользователей
-
-| Файл | Статус | Комментарий |
-|------|--------|-------------|
-| docs/index.md | OK | Минимальный хаб, ссылки на quickstart и api |
-| docs/quickstart.md | OK | Импорты и вызовы корректны |
-| docs/api.md | **ОШИБКА** | Список event functions не совпадает с models.py (см. ниже) |
-| docs/images/app-grid.png | OK | Скриншот для README |
-
-### 1.3 Примеры
-
-| Файл | Статус | Комментарий |
-|------|--------|-------------|
-| examples/run_pipeline.py | OK | Актуальный API |
-| examples/synopses/ | OK | Breaking Bad + GoT |
-| examples/results/ | OK | Готовые JSON-результаты |
-
-### 1.4 Промпты (runtime-зависимость)
-
-| Файл | Статус |
-|------|--------|
-| src/tvplotlines/prompts_en/pass0.md | OK |
-| src/tvplotlines/prompts_en/pass1.md | OK |
-| src/tvplotlines/prompts_en/pass2.md | OK |
-| src/tvplotlines/prompts_en/pass3.md | OK |
-| src/tvplotlines/prompts_en/synopses_writer.md | OK |
-| src/tvplotlines/prompts_en/__init__.py | OK (importlib.resources) |
-
----
-
-## 2. Найденные проблемы
-
-### КРИТИЧЕСКИЕ
-
-**2.1 Промпты не попадут в pip-пакет**
-
-Hatchling по умолчанию включает только `.py` файлы. Промпты `.md` из `prompts_en/` не будут упакованы в wheel. При `pip install tvplotlines` вызов `load_prompt()` упадёт с FileNotFoundError.
-
-Нужно добавить в pyproject.toml:
-
-```toml
-[tool.hatch.build.targets.wheel]
-packages = ["src/tvplotlines"]
-artifacts = ["src/tvplotlines/prompts_en/*.md"]
-```
-
-Или использовать `[tool.hatch.build]` с `include`.
-
-### ЗНАЧИМЫЕ
-
-**2.2 api.md: event functions расходятся с models.py**
-
-- api.md перечисляет: `setup, escalation, turning_point, climax, resolution, cliffhanger, seed`
-- models.py определяет: `setup, inciting_incident, escalation, turning_point, crisis, climax, resolution`
-
-Расхождение: `cliffhanger` и `seed` не существуют в коде; `inciting_incident` и `crisis` не описаны в api.md.
-
-**2.3 Бенчмарк 87% не подтверждён в коде**
-
-README заявляет "87% usable narrative structure". Эта цифра не воспроизводима из кода или тестов — нет ни скрипта бенчмарка, ни fixture с результатами. Для open-source проекта это рискованно: любой может спросить "как воспроизвести?".
-
-### РЕКОМЕНДАЦИИ (не блокируют релиз)
-
-**2.4 Нет py.typed**
-
-Без `py.typed` маркера type checkers (mypy, pyright) не будут использовать типы из пакета. Стоит добавить пустой файл `src/tvplotlines/py.typed`.
-
-**2.5 Нет системы сборки документации**
-
-Нет mkdocs.yml или readthedocs.yml. Документация читается только через GitHub. Для v0.1.0 допустимо, но для роста аудитории нужен hosted docs site.
-
-**2.6 MANIFEST.in отсутствует**
-
-При использовании hatchling не критично (sdist конфигурируется через pyproject.toml), но стоит проверить, что `hatch build` включает промпты в sdist тоже.
-
----
-
-## 3. Ресурсные файлы (3-resources/tvplotlines/)
-
-### 3.1 Ядро — актуальные справочные документы
-
-Эти файлы — живые справочники, необходимы для работы над проектом:
-
-| Файл | Назначение |
-|------|------------|
-| architecture.md | Спецификация архитектуры pipeline |
-| design-decisions.md | Реестр решений с обоснованиями |
-| glossary.md | Глоссарий терминов (Story DNA и т.д.) |
-| open-source-strategy.md | Стратегия: что публичное, что приватное |
-| career-plan.md | Четырёхфазный план (repo → preprint → site → expand) |
-| inventory.md | Что своё vs заимствованное, IP-границы |
-| open-source-release-checklist.md | QA-чеклист перед PyPI |
-
-### 3.2 Autoresearch — история экспериментов
-
-Большой блок из 15 файлов. Документирует три поколения автоисследования (v1 → v2 → v3):
-
-| Поколение | Файлы | Статус |
-|-----------|-------|--------|
-| v1 | autoresearch-program.md, autoresearch-experiment-log.md | v1 **устарел** (заменён v2), лог актуален как история |
-| v2 | autoresearch-program-v2.md, autoresearch-run-v2.md, autoresearch-summary-v2.md | Актуальны |
-| v3 | autoresearch-v3-plan.md, -brainstorm-notes, -engineering, -engineering-review, -event-functions, -hybrid-vs-procedural, -questions, -reading-plan, -todo | Актуальны — текущий фронт работы |
-| Идеи | autoresearcher-competence-idea.md, notes-for-3rd-autoresearch.md | Актуальны как контекст для v3 |
-
-**Рекомендация:** `autoresearch-program.md` (v1) → в archive/.
-
-### 3.3 Промпт-инженерия
-
-| Файл | Статус | Комментарий |
-|------|--------|-------------|
-| how-to-prompt.md | Актуален | 10 принципов промптинга |
-| prompt-template.md | Актуален | Шаблон 7 секций для всех passes |
-| prompt-writing-rules.md | Актуален | Чеклист для переписывания промптов |
-| synopsis-authoring-protocol.md | Актуален | Протокол написания синопсисов |
-
-### 3.4 Теория и исследования
-
-| Файл | Статус | Комментарий |
-|------|--------|-------------|
-| heuristics-from-theory.md | Актуален | Правила из книг для валидации кодом |
-| metrics-survey.md | Актуален | Обзор метрик narrative extraction |
-| event-functions-redesign.md | Актуален | Редизайн функций (связан с 2.2 выше) |
-| enculturation-core-idea.md | Актуален | Ядро теоретической позиции |
-| narrative-intelligence-theory.md | Концепт | Идея, не реализована |
-| bibliography-narrative-and-autoresearch.md | Актуален | Литобзор |
-| preprint-citations-map.md | Актуален | Какие papers подтверждают какие компоненты |
-| screenwriting-theory-reading-prompt.md | Актуален | Промпт для чтения книг по сценаристике |
-
-### 3.5 Препринт
-
-| Файл | Статус | Комментарий |
-|------|--------|-------------|
-| abstract.md | Актуален | Абстракт препринта |
-| one-page.md | Актуален | Elevator pitch |
-| preprint-experiment-scaffold.md | Planned | Эксперимент с Story DNA как scaffold |
-| preprint-idea-meta-situation-model.md | Концепт | Идея для будущего |
-
-### 3.6 Планы и задачи
-
-| Файл | Статус | Комментарий |
-|------|--------|-------------|
-| publication-plan.md | Актуален | План write-synopses CLI |
-| write-synopses-plan.md | Актуален | Дизайн CLI для генерации синопсисов |
-| input-parser-plan.md | Актуален | Дизайн парсера входных файлов |
-| plan-restructure.md | Актуален | Разделение на 3 репозитория |
-| tasks-todo.md | Актуален | Текущие задачи (resilience) |
-| stability-benchmark.md | Актуален | Спецификация бенчмарка |
-| 2026-03-16-prior-season-continuity-design.md | Актуален | Дизайн multi-season |
-
-### 3.7 Разное
-
-| Файл | Статус | Комментарий |
-|------|--------|-------------|
-| blog-post-guide.md | Справочный | Шаблон блог-постов |
-| mas4bw-library-audit.md | Актуален | Технический аудит извлечения из монолита |
-| naive-vs-plotter.md | Planned | Эксперимент |
-| experiment-ru-vs-en-prompts.md | Planned | Эксперимент |
-| breakdown-gdr-s01.md | Актуален | Ground truth для валидации |
-| breakdown-sp-s01.md | Актуален | Ground truth |
-| breakdown-td-s01.md | Актуален | Ground truth |
-| resources-migration-plan.md | Актуален | Миграция 3-resources |
-| resources-restructure-design.md | Актуален | Спецификация миграции |
-| bibliography-cleanup.md | **Завершён** | Можно в archive/ |
-
-### 3.8 Устаревшие / кандидаты в archive/
-
-| Файл | Причина |
-|------|---------|
-| what-to-change.md | Черновик без решений, 35 строк, неструктурирован |
-| autoresearch-program.md | Заменён v2 |
-| bibliography-cleanup.md | Задача завершена (535 items в Zotero) |
-
-### 3.9 Данные и артефакты
-
-| Файл | Назначение |
-|------|------------|
-| autoresearch-results.tsv | Результаты v1 |
-| autoresearch-results-v2.tsv | Результаты v2 |
-| bb-s01..s05-result.json | Результаты pipeline для Breaking Bad |
-| run-bb-all-seasons.py | Скрипт запуска всех сезонов |
-| awesome-shortlist.bib | BibTeX для awesome list |
-| screenshot-2026-03-16.png | Скриншот приложения |
-
-### 3.10 Дубликат
-
-| Файл | Проблема |
-|------|----------|
-| superpowers/plans/2026-03-16-prior-season-continuity.md | Дубликат файла 2026-03-16-prior-season-continuity-design.md из основной папки |
-
----
-
-## 4. Сводка
-
-### Библиотека (репозиторий)
-
-| Категория | Итог |
-|-----------|------|
-| Обязательные файлы | Всё на месте |
-| Документация | 1 ошибка в api.md (event functions) |
-| Упаковка | **КРИТИЧНО**: промпты не попадут в pip install |
-| Типизация | Нет py.typed |
-| CI/CD | Работает |
-| Примеры | Актуальны |
-
-### Ресурсы (3-resources/tvplotlines/)
-
-| Категория | Файлов | Итог |
-|-----------|--------|------|
-| Актуальные справочники | 7 | Ядро проекта |
-| Autoresearch | 15 | 1 устарел (v1 program) |
-| Промпт-инженерия | 4 | Все актуальны |
-| Теория | 8 | Все нужны |
-| Препринт | 4 | Все актуальны |
-| Планы и задачи | 7 | Все актуальны |
-| Ground truth breakdowns | 3 | Нужны для валидации |
-| Данные/артефакты | 6 | Результаты экспериментов |
-| В archive/ | 3 | what-to-change, autoresearch-program v1, bibliography-cleanup |
-| Дубликат | 1 | superpowers/plans/ |
-| **Итого** | ~60 | |
-
-### Действия (приоритет)
-
-1. **Критично**: добавить промпты в wheel (pyproject.toml)
-2. **Значимо**: исправить event functions в api.md
-3. **Желательно**: добавить py.typed
-4. **Порядок**: переместить 3 файла в archive/, удалить дубликат в superpowers/
-
----
-
-## 5. Аудит тестов
-
-### 5.1 Проблема с промптами и тестами
-
-**Почему тесты проходили, если промпты не упакованы?**
-
-Потому что тесты запускались через `pip install -e ".[dev]"` (editable install). В этом режиме Python читает файлы прямо из исходников на диске — все `.md` промпты доступны по своим оригинальным путям. Баг проявится только при обычном `pip install tvplotlines` из wheel/PyPI.
-
-### 5.2 Текущее состояние fixtures/
-
-Папка `tests/fixtures/` **пустая** (только `.DS_Store`). Два тестовых файла ссылаются на отсутствующие fixture:
-
-| Тест | Отсутствующий fixture | Последствие |
-|------|-----------------------|-------------|
-| test_consistency.py | SP_S01E01..08.txt (8 файлов) | FileNotFoundError |
-| test_synopses_writer.py | wikipedia_house_s01.html (1 файл) | FileNotFoundError в 1 тесте из 15 |
-
-### 5.3 Какие тесты НУЖНЫ библиотеке
-
-Исходя из архитектуры (4 pass + postprocess + verdicts + metrics + synopses_writer + CLI + input):
-
-| Что тестируем | Зачем | Какой файл покрывает | Статус |
-|---------------|-------|---------------------|--------|
-| **Валидация LLM-ответов** (Pass 0/1/2) | Ядро надёжности: LLM возвращает мусор → валидация отсеивает | test_validation.py (16 тестов) | **НУЖЕН, OK** |
-| **Применение вердиктов** (Pass 3) | MERGE/REASSIGN/PROMOTE/DEMOTE/CREATE/DROP — вся логика мутации данных | test_verdicts.py (10 тестов) | **НУЖЕН, OK** |
-| **Постобработка** (span, weight, rank demotion) | Бизнес-логика после всех passes | test_postprocess.py (9 тестов) | **НУЖЕН, OK** |
-| **Метрики** (coverage, ARI, score) | Оценка качества результатов | test_metrics.py (9 тестов) | **НУЖЕН, OK** |
-| **Устойчивость** (retry, timeout, callbacks, resume) | Сеть падает, batch зависает, пользователь resume | test_resilience.py (11 тестов) | **НУЖЕН, OK** |
-| **Multi-season** (prior prompt building, overlap check) | Ключевая фича — связь между сезонами | test_pass1_prior.py (5 тестов) | **НУЖЕН, OK** |
-| **Pipeline control flow** (prior context reuse, anthology guard) | Правильный порядок вызова passes | test_pipeline_prior.py (3 теста) | **НУЖЕН, OK** |
-| **JSON-парсинг LLM-ответов** | Базовая утилита, edge cases code blocks | test_llm.py (5 тестов) | **НУЖЕН, OK** |
-| **Synopses writer** (Wikipedia parsing, file I/O) | Утилита для подготовки входных данных | test_synopses_writer.py (15 тестов) | **НУЖЕН, но 1 тест сломан** (нет fixture) |
-| **Модели** (dataclass instantiation) | Проверяет что конструкторы работают | test_models.py (2 теста) | **НЕ НУЖЕН** — тривиальные smoke-тесты, не ловят баги |
-| **Consistency benchmark** (полный pipeline с API) | E2E на реальном LLM | test_consistency.py (1 тест) | **НЕ НУЖЕН в CI** — требует API key + 8 fixture-файлов, которых нет |
-| **Integration resilience** (полный pipeline + callbacks) | E2E с проверкой callbacks | integration_resilience.py (2 теста) | **УСЛОВНО НУЖЕН** — требует API key, но inline data (не зависит от fixtures) |
-
-### 5.4 Чего НЕ ХВАТАЕТ
-
-| Что не покрыто | Приоритет | Почему нужно |
-|----------------|-----------|-------------- |
-| **CLI** (cli.py) | Средний | Нет тестов на парсинг аргументов, --provider, --pass2-mode, --output |
-| **Input loader** (input.py: load_synopses_dir) | Средний | Нет тестов на чтение файлов, парсинг S01E01 из имён, edge cases |
-| **Pass 0/1/2/3 с mock LLM** | Низкий | Внутренняя логика каждого pass (парсинг ответа, валидация, retry) — частично покрыта через test_validation и test_resilience |
-
-### 5.5 Вердикт по каждому тестовому файлу
-
-| Файл | Тестов | Вердикт | Действие |
-|------|--------|---------|----------|
-| test_validation.py | 16 | **Оставить** | Ядро качества. Все тесты осмысленные |
-| test_verdicts.py | 10 | **Оставить** | Покрывает всю логику Pass 3 мутаций |
-| test_postprocess.py | 9 | **Оставить** | Boundary-тесты на пороги (25%, 50%) |
-| test_metrics.py | 9 | **Оставить** | Формулы метрик, edge cases |
-| test_resilience.py | 11 | **Оставить** | Retry, timeout, callbacks, resume validation |
-| test_pass1_prior.py | 5 | **Оставить** | Multi-season — ключевая фича |
-| test_pipeline_prior.py | 3 | **Оставить** | Control flow pipeline |
-| test_llm.py | 5 | **Оставить** | JSON extraction из LLM ответов |
-| test_synopses_writer.py | 15 | **Оставить, починить** | 14 тестов работают. 1 тест (test_parse_episode_table_house_s01) сломан — нужен fixture wikipedia_house_s01.html |
-| test_models.py | 2 | **Удалить или переписать** | Тривиальные assert-ы, не ловят баги. Если оставлять — добавить тесты на to_dict()/from_dict() roundtrip |
-| test_consistency.py | 1 | **Удалить** | Зависит от 8 отсутствующих fixtures + API key. Не для CI. Если нужен — это manual benchmark, не pytest |
-| integration_resilience.py | 2 | **Переименовать** | Не pytest-файл (нет test_ префикса), не собирается pytest автоматически. Требует API key. Можно оставить как manual integration test, но убрать из tests/ или пометить маркером |
-
-### 5.6 Итог по тестам
-
-**Работающие тесты:** 84 из 88 (в 10 файлах из 12)
-**Сломанные:** 2 теста (fixture-зависимые) + 2 тривиальных
-**Покрытие:** хорошее для логики (validation, verdicts, postprocess, metrics, resilience), слабое для I/O (CLI, input loader)
-
-### Действия по тестам (приоритет)
-
-1. **Удалить** test_consistency.py — зависит от отсутствующих fixtures, бесполезен без них
-2. **Удалить или переписать** test_models.py — тривиальные тесты
-3. **Починить** test_synopses_writer.py — восстановить fixture wikipedia_house_s01.html
-4. **Решить** судьбу integration_resilience.py — оставить как manual test или удалить
-5. **Добавить** (позже) тесты для CLI и input.py
-
----
-
-## 6. Полная карта тестов: что должно быть
-
-### Категория 1: Валидация входных данных (граница системы) — ОБЯЗАТЕЛЬНО
-
-Библиотека должна падать с понятными ошибками при плохих входах.
-
-**get_plotlines() — валидация параметров:**
-- Неправильный формат episode key (`"ep1"` вместо `"S01E01"`) → ValueError
-- Сезон в ключе не совпадает с `season` (`S02E01` при `season=1`) → ValueError
-- `cast` без `plotlines` (и наоборот) → ValueError
-- `breakdowns` длиной ≠ `episodes` → ValueError
-- `batch_id` без `pass2_mode="batch"` → ValueError
-- `prior` + `context.is_anthology=True` → ValueError
-- Неизвестный `pass2_mode` → ValueError
-
-**load_synopses_dir() — файловый ввод:**
-- Несуществующая директория → FileNotFoundError
-- Пустая директория (нет .txt) → FileNotFoundError
-- Файлы без паттерна S01E01 → ValueError
-- Дублирующиеся episode ID → ValueError
-- Автодетект show name из имени папки (`"breaking-bad"` → `"Breaking Bad"`)
-- Автодетект season из имён файлов
-
-**Покрытие:** частично (resume validation в test_resilience, anthology guard в test_pipeline_prior). **Дыра: episode keys, load_synopses_dir.**
-
----
-
-### Категория 2: Бизнес-логика (чистые функции без LLM) — ОБЯЗАТЕЛЬНО
-
-Детерминированный код, легко тестируется, ловит реальные баги.
-
-**Постобработка (postprocess.py):**
-- compute_span — в каких эпизодах появляется plotline
-- compute_weight — primary vs glimpse классификация
-- validate_ranks — demotion A→B при коротком span, dominant flag
-- aggregate_patches — сбор patches из всех эпизодов
-
-**Вердикты (verdicts.py):**
-- MERGE — удаление source, переназначение events, обновление also_affects
-- REASSIGN — перенос event на другой plotline
-- PROMOTE/DEMOTE — смена rank
-- CREATE — новый plotline + переназначение events
-- DROP — удаление plotline + redistribution
-- Иммутабельность — оригинал не мутируется
-- Цепочка вердиктов — CREATE → REASSIGN в одном батче
-
-**Метрики (metrics.py):**
-- coverage — доля assigned events
-- ARI — consistency между прогонами
-- score — формула coverage × consistency
-- Edge cases: пустой список, один прогон, все null
-
-**Покрытие: полное** — test_postprocess (9), test_verdicts (10), test_metrics (9).
-
----
-
-### Категория 3: Валидация LLM-ответов — ОБЯЗАТЕЛЬНО
-
-LLM возвращает мусор — валидация основа надёжности.
-
-**Pass 0:** невалидный format, пустой story_engine, не-bool поля
-**Pass 1:** пустой cast/plotlines, невалидный type, procedural без case_of_the_week, serial с 2+ A-rank, ensemble без 2+ A-rank
-**Pass 2:** невалидная function, ссылка на несуществующий plotline, неизвестный character, guest-формат, допустимая доля null
-
-**Покрытие: полное** — test_validation.py (16 тестов).
-
----
-
-### Категория 4: Устойчивость (сеть, retry, timeout) — ОБЯЗАТЕЛЬНО
-
-**Тесты:**
-- Transient error → retry с exponential backoff
-- Max retries → ошибка пробрасывается
-- Backoff delays — правильная формула
-- Partial success в parallel — успешные сохраняются
-- Batch timeout → TimeoutError
-- Callback получает batch_id
-- Default callback — noop
-- Subclass callback — правильные аргументы
-
-**Покрытие: полное** — test_resilience.py (11 тестов).
-
----
-
-### Категория 5: Multi-season continuity — НУЖНО
-
-**Тесты:**
-- Промпт Pass 1 с prior — JSON-структура prior_season блока
-- Промпт Pass 1 без prior — блок отсутствует
-- Пустой prior — блок не инжектится
-- Overlap warning — тот же hero без reuse ID
-- Pipeline flow — prior → Pass 0 пропускается
-- Cast+plotlines явно → prior игнорируется
-- Prior + anthology → ValueError
-
-**Покрытие: полное** — test_pass1_prior.py (5) + test_pipeline_prior.py (3).
-
----
-
-### Категория 6: JSON-парсинг LLM-ответов — НУЖНО
-
-**Тесты:**
-- Чистый JSON, code block с/без language tag, whitespace, невалидный JSON → ValueError
-
-**Покрытие: полное** — test_llm.py (5 тестов).
-
----
-
-### Категория 7: Synopses writer — НУЖНО
-
-**Тесты:**
-- Парсинг реального Wikipedia HTML (House S01)
-- HTML без table / без descriptions → ValueError
-- Wikipedia URL construction (single word, multi-word, override)
-- Fallback при 404
-- Оба convention 404 → ValueError
-- Rewrite через mock LLM
-- Сохранение individual / combined files
-- Загрузка из файлов (pattern, sequential, пустые, отсутствующие)
-
-**Покрытие:** test_synopses_writer.py (15 тестов). **1 сломан** — нужен fixture wikipedia_house_s01.html.
-
----
-
-### Категория 8: Сериализация — НУЖНО
-
-**Тесты:**
-- TVPlotlinesResult.to_dict() → валидный dict для json.dumps
-- Roundtrip: result → to_dict() → from_dict() → result (если from_dict существует)
-- Вложенные структуры сериализуются корректно
-
-**Покрытие: НЕТ.** test_models.py тестирует только конструкторы.
-
----
-
-### Категория 9: CLI — ЖЕЛАТЕЛЬНО (можно отложить)
-
-**Тесты:**
-- Парсинг аргументов: --provider, --pass2-mode, --output, --skip-review
-- Директория как вход → автодетект show + season
-- Файлы как вход → требует --show
-- write-synopses: --dry-run, --from-files, --format
-
-**Покрытие: НЕТ.**
-
----
-
-### Категория 10: E2E / Integration — ОПЦИОНАЛЬНО
-
-Дорого, медленно, не для CI. Только manual benchmark.
-
-- Полный прогон pipeline → результат валиден
-- Consistency между прогонами (ARI > порог)
-- Callback firing order
-- Resume (0 API calls)
-
-**Покрытие:** test_consistency.py (сломан, удалить) + integration_resilience.py (требует API key).
-
----
-
-### Сводная таблица
-
-| #   | Категория        | Приоритет   | Покрытие  | Статус                           |
-| --- | ---------------- | ----------- | --------- | -------------------------------- |
-| 1   | Валидация входов | Обязательно | Частичное | **ДЫРА: input.py, episode keys** |
-| 2   | Бизнес-логика    | Обязательно | Полное    | OK                               |
-| 3   | Валидация LLM    | Обязательно | Полное    | OK                               |
-| 4   | Устойчивость     | Обязательно | Полное    | OK                               |
-| 5   | Multi-season     | Нужно       | Полное    | OK                               |
-| 6   | JSON-парсинг     | Нужно       | Полное    | OK                               |
-| 7   | Synopses writer  | Нужно       | 14/15     | **ПОЧИНИТЬ fixture**             |
-| 8   | Сериализация     | Нужно       | Нет       | **ДЫРА: написать**               |
-| 9   | CLI              | Желательно  | Нет       | Отложить                         |
-| 10  | E2E              | Опционально | Сломано   | Удалить/решить                   |
-
-**6 категорий покрыты полностью, 2 дыры (входы + сериализация), 1 починить, 1 решить.**
diff --git a/docs/knowledge/archive/plans/execution-order.md b/docs/knowledge/archive/plans/execution-order.md
deleted file mode 100644
index 8a8c9f6..0000000
--- a/docs/knowledge/archive/plans/execution-order.md
+++ /dev/null
@@ -1,210 +0,0 @@
-
-## Infrastructure (imported once at startup)
-1. __init__.py — public API exports
-2. models.py — dataclasses used by all modules [^models]
-3. llm.py — LLM client abstraction (temperature=0 hardcoded for all calls)
-4. callbacks.py — optional progress hooks after each pass
-5. prompts/__init__.py — loads .md prompt files by pass name and language
-
-## User input
-- Synopsis files [^3]
-	- Option A: user provides `dict[str, str]` (episode ID → synopsis text)
-	- Option B: `prepare_synopses(show, season)` — LLM generates synopses by synopsis-authoring-protocol, temperature=0, returns `dict[str, str]`. Same LLM client as pipeline. CLI: `tvplotlines run "Breaking Bad" --season 1 --auto-synopses`
-- Prior season result (optional) — TVPlotlinesResult from previous season, for multi-season continuity
-
-## Prior season logic
-When prior is provided:
-- pass0 is skipped — reuses prior.context
-- pass1 receives prior.cast + prior.plotlines to maintain character/plotline ID continuity
-- pass1 marks each prior plotline as CONTINUES / TRANSFORMED / ENDED
-- not supported for anthology format (anthology seasons are independent)
-
-## Pipeline (orchestrated by pipeline.py)
-### 6. pass0.py — detect series context
-- INPUT: synopsis files from user, formatted or named based on convention (see User input above)
-- CODE:
-	1. extracts
-		1. show name,
-		2. season number,
-		3. episode IDs from file structure
-	2. builds user prompt: JSON with show name + season number + first 3 synopses
-	3. calls LLM with system prompt (pass0.md) and user prompt (3 synopses): 1 call
-- LLM:
-	1. reads synopses
-	2. returns JSON with
-		1. format ∈ {procedural, hybrid, serial, limited} [^format]
-		2. is_ensemble: bool
-		3. is_anthology: bool
-		4. story_engine
-		5. genre [^genre]
-		6. reasoning — explains why this format was chosen (not used downstream, for auditability)
-- CODE: validates
-	1. format ∈ {procedural, hybrid, serial, limited}
-	2. is_ensemble: bool
-	3. is_anthology: bool
-	4. story_engine is non empty str
-	5. genre — no validation
-- OUTPUT: SeriesContext object (format, is_ensemble, is_anthology, story_engine, genre) — used by all subsequent passes [^usage_tracking]
-
-### 7. pass1.py — extract cast + plotlines
-- CODE:
-	1. builds JSON from all synopses + context object from pass0
-	2. calls LLM with system prompt (pass1.md) and user prompt (all synopses): 3 parallel calls [^voting]
-- LLM:
-	1. reads all synopses,
-	2. returns JSON with
-		1. cast list
-		2. plotlines with Story DNA (hero, goal, obstacle, stakes) [^renames]
-		3. rank (A/B/C),
-		4. type (case_of_the_week, serialized, runner)
-		5. nature (plot-led, character-led, theme-led)[^nature]
-		6. confidence (solid, partial, inferred)
-- CODE:
-	1. majority voting — picks most common result from 3 runs [^voting]
-	2. validates
-		1. type ∈ {case_of_the_week, serialized, runner}
-		2. rank ∈ {A, B, C}
-		3. nature ∈ {plot-led, character-led, theme-led}
-		4. confidence ∈ {solid, partial, inferred}
-		5. hero references existing cast member
-		6. A-rank count: 1 for serial/procedural/hybrid, 2+ if is_ensemble
-		7. procedural/hybrid must have exactly 1 case_of_the_week plotline
-- OUTPUT:
-	1. cast: list of CastMember (id, name, aliases)
-	2. plotlines: list of Plotline (id, name, hero, goal, obstacle, stakes, type, rank, nature, confidence)
-	— used by pass2 (in user prompt per episode) and pass3 (for review)
-
-### 8. pass2.py — assign events to plotlines per episode
-- CODE:
-	1. builds N user prompts with shared system prompt (pass2.md, cached across episodes)
-	2. user prompt per episode: JSON with one episode synopsis + cast + plotlines
-	3. execution mode (CLI: `--pass2-mode`):
-		- parallel (default) — all N episodes async, N parallel LLM calls
-		- batch — Anthropic Batch API, 50% cheaper, slower turnaround
-		- sequential — one episode at a time, for debugging; fires `on_episode_complete` callback per episode
-- LLM (1 call per episode):
-	1. reads one episode synopsis,
-	2. returns JSON with
-		1. theme — one sentence, thematic summary of the episode
-		2. events — each assigned with
-			1. plotline (or null for orphan events),
-			2. function, [^functions]
-			3. characters,
-			4. also_affects
-		3. interactions between plotlines in the episode, each with:
-			1. type ∈ {thematic_rhyme, dramatic_irony, convergence}
-			2. lines — plotline IDs involved
-			3. description — one sentence
-		4. patches — suggested fixes passed as context to pass3, each with:
-			1. action ∈ {ADD_LINE, CHECK_LINE, SPLIT_LINE, RERANK}
-			2. target — plotline ID (or proposed new ID)
-			3. reason
-			4. episodes — relevant episode IDs
-- CODE: validates
-	1. function ∈ {setup, inciting_incident, escalation, turning_point, crisis, climax, resolution}
-	2. plotline references existing plotline ID from pass1 (or null)
-	3. characters reference existing cast IDs or use guest: prefix
-	4. also_affects references existing plotline IDs
-	5. interaction type ∈ {thematic_rhyme, dramatic_irony, convergence}
-	6. patch action ∈ {ADD_LINE, CHECK_LINE, SPLIT_LINE, RERANK}
-- OUTPUT: list of EpisodeBreakdown (one per episode), each with theme, events, interactions, patches
-
-### 9. postprocess.py — compute spans, assign orphan events, validate ranks [^postprocess]
-- CODE:
-	1. assign_orphan_events: events without a plotline get assigned to new plotlines
-	2. compute_span: calculates which episodes each plotline appears in (list of episode IDs)
-	3. compute_weight: per plotline per episode — primary / background / glimpse (from event counts)
-	4. validate_ranks: checks A/B/C distribution matches format (+ is_ensemble flag)
-	5. arc_completeness thresholds adjusted by confidence: inferred with 3/7 = expected, solid with 3/7 = flag
-- OUTPUT:
-	1. plotlines updated with span and weight fields
-	2. diagnostics flags (validate_ranks + arc_completeness adjusted by confidence) — passed to pass3
-
-### 10. pass3.py — structural review [^pass3]
-- CODE:
-	1. builds user prompt JSON with:
-		- context (show, season, format, is_ensemble, story_engine)
-		- cast (id, name)
-		- plotlines (all pass1 fields + span + weight from postprocess)
-		- episodes (theme, events, patches from pass2)
-		- diagnostics from postprocess (ranks, arc_completeness, monotonicity)
-	2. calls LLM with system prompt (pass3.md) and user prompt: 1 call
-- LLM
-	1. reviews full picture (plotlines with spans + weights, all events, patches),
-	2. returns JSON with
-		1. notes — overall quality assessment (free text)
-		2. verdicts — structural corrections to apply to plotlines:
-			- MERGE: combine two plotlines into one (source → target)
-			- REASSIGN: move an event from one plotline to another
-			- PROMOTE: raise plotline rank (e.g. B → A)
-			- DEMOTE: lower plotline rank (e.g. A → B)
-			- CREATE: add a new plotline and reassign events to it
-			- DROP: delete a plotline and redistribute its events (inferred plotline + few events = candidate for DROP)
-- CODE: validates
-	1. action ∈ {MERGE, REASSIGN, PROMOTE, DEMOTE, CREATE, DROP, REFUNCTION}
-	2. MERGE: source and target reference existing plotline IDs
-	3. REASSIGN: event exists, target plotline ID exists
-	4. PROMOTE/DEMOTE: target exists, new_rank ∈ {A, B, C}
-	5. CREATE: plotline has all required fields, reassign_events reference existing events
-	6. DROP: target exists, redistribute events reference existing events and target IDs
-
-### 11. verdicts.py — apply pass3 verdicts to plotlines [^refunction]
-- CODE:
-	1. applies each verdict (MERGE, REASSIGN, PROMOTE, DEMOTE, CREATE, DROP, REFUNCTION) to plotlines and events
-	2. pipeline recomputes spans and re-validates ranks
-- OUTPUT: final plotlines + episodes — ready for TVPlotlinesResult
-
-### TVPlotlinesResult — final output object
-- context: SeriesContext (format, is_ensemble, is_anthology, story_engine, genre)
-- cast: list of CastMember (id, name, aliases)
-- plotlines: list of Plotline (id, name, hero, goal, obstacle, stakes, type, rank, nature, confidence, span)
-- episodes: list of EpisodeBreakdown (episode, theme, events, interactions, patches)
-- usage: token/cost summary [^usage_tracking]
-
-## Total LLM calls per run: 5 + N (where N = number of episodes) [^total_calls]
-[^2]: [[tvplotlines-event-functions-redesign]]
-
-[^3]: **Input contract.** API: `episodes: dict[str, str]` (key=episode ID `S\d{2}E\d{2}`, value=synopsis text 300-500 words). CLI: `tvplotlines run files/*.txt --show "..." --season 1`. Опциональный шаг: `prepare_synopses(show, season)` — LLM генерирует синопсисы по synopsis-authoring-protocol (temperature=0, тот же LLM client). CLI: `--auto-synopses`. Задачи:
-1. написать `prepare.py` + промпт `prompts/synopsis.md`,
-2. документировать в docs/quickstart.md + docs/api.md + docs/synopsis-guide.md,
-3. починить баг: `examples/run_pipeline.py` передаёт `list[str]` вместо `dict[str, str]`.
-
-[^4]: Currently not in the code, but is in the source so should be added
-
-[^models]: **Переделать models.py:** Event.function enum — убрать cliffhanger/seed, добавить inciting_incident/crisis. См. [[tvplotlines-event-functions-redesign]].
-
-[^genre]: **Genre:** оставить как есть, не трогать. Свободный формат, не валидируется, в пайплайне не используется — но ничего не стоит (pass0 и так возвращает). Кандидат для ablation: влияет ли передача genre в pass1/pass2 на качество извлечения?
-
-[^format]: **Заменить franchise_type + format на новую схему.** Одно поле `format` ∈ {procedural, hybrid, serial, limited} + два флага: `is_ensemble: bool` (2+ A-линий), `is_anthology: bool` (нет prior между сезонами). Убрать старые franchise_type и format. Менять: models.py (SeriesContext), pass0 промпт + валидация, pass1 (правила по количеству A-линий), postprocess (validate_ranks).
-
-[^usage_tracking]: **Добавить трекинг токенов по пассам:** usage: str → структура (input_tokens, output_tokens, calls per pass). Библиотека собирает и возвращает в TVPlotlinesResult. Показ (таблица, UI) — задача app. См. [[tvplotlines-what-to-change]] п.5.
-
-[^voting]: **Ablation majority voting:** 3 параллельных вызова в pass1 могут быть избыточны при temperature=0. Оставить до autoresearch-эксперимента, но пометить как кандидат на удаление. Если убрать — total calls = 3+N вместо 5+N.
-
-[^renames]: **Переименования в models.py:** (1) `driver` → `hero` — в коде сейчас driver, в документе hero; (2) `episodic` → `case_of_the_week` — в коде сейчас episodic, в документе case_of_the_week; (3) Event.`storyline` → `plotline` — в коде сейчас storyline, в документе plotline. Менять: models.py, все пассы (промпты + валидация), verdicts.py.
-
-[^nature]: **Добавить theme-led в nature:** в источниках (Nash) есть theme-led plotlines, но в коде валидируется только {plot-led, character-led}. Нужно: (1) добавить в enum, (2) обновить промпт pass1, (3) обновить валидацию.
-
-[^functions]: **Переделать event functions:** убрать cliffhanger/seed, добавить inciting_incident/crisis. Итого: {setup, inciting_incident, escalation, turning_point, crisis, climax, resolution}. cliffhanger и seed → модификаторы (в будущем). Менять: enum в models.py, валидацию pass2.py, таблицу функций в промпте pass2. Описания функций в промпте (как объяснить LLM что такое crisis vs escalation) — оптимизировать через autoresearch. См. [[tvplotlines-event-functions-redesign]].
-
-[^postprocess]: **Расширить postprocess.py:** добавить
-1. build_plotline_arcs — собрать все события plotline по эпизодам в порядке (для pass3 и app),
-2. build_episode_arcs — собрать все события эпизода по всем plotlines в порядке,
-3. convergence_matrix — из Event.also_affects агрегировать directed matrix пересечений,
-4. arc_completeness — `len(set(functions)) / 7` per plotline,
-5. validate_arc_completeness — completeness < минимума для ранга (A>=6/7, B>=5/7, C>=3/7) → diagnostics,
-6. validate_monotonicity — возврат past milestone (inciting_incident→turning_point→crisis→climax) → diagnostics.
-Всё чистый код, без LLM. Diagnostics передаются в pass3. См. [[tvplotlines-event-functions-redesign]].
-
-[^pass3]: **Расширить pass3:** промпт получает из postprocess: plotline arcs, episode arcs, arc_completeness + diagnostics (неполные арки, нарушения монотонности). LLM решает что делать: REFUNCTION, PROMOTE/DEMOTE, etc. См. [[tvplotlines-event-functions-redesign]].
-
-[^refunction]: **Добавить вердикт REFUNCTION:** pass3 может исправить неверные function assignments (напр. escalation→crisis). Новый action в enum вердиктов, новая логика применения в verdicts.py. См. [[tvplotlines-event-functions-redesign]].
-
-[^total_calls]: **Пересчитать если убрать voting:** если ablation покажет что 1 вызов pass1 достаточен — total calls = 3+N вместо 5+N.
-
-## Ablation ideas
-- **Voting in pass1:** 3 calls vs 1 call at temperature=0. May be redundant with pass3 review.
-- **Reasoning before JSON (Wei 2022):** "First analyze the synopses in 2-3 sentences, then output JSON." Currently reasoning is inside JSON field. Test if free-form thinking before JSON improves quality. Requires parser change (extract JSON from mixed response).
-- **Genre in pass1/pass2:** does passing genre from pass0 improve extraction quality?
-
----
\ No newline at end of file
diff --git a/docs/knowledge/archive/plans/experiment-arc-functions.md b/docs/knowledge/archive/plans/experiment-arc-functions.md
deleted file mode 100644
index 443ea9e..0000000
--- a/docs/knowledge/archive/plans/experiment-arc-functions.md
+++ /dev/null
@@ -1,123 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# Experiment: Arc Functions
-
-## Question
-
-How to assign dramatic functions to events at the season-arc level (not episode level)?
-
-Two sub-questions:
-1. Does the order of assignment matter — arc first, episode first, both at once, or arc only?
-2. Which scale works best for arc functions — our 7, Harmon, McKee, or Freytag?
-
-## Design
-
-Two stages. Stage 1 finds the best assignment order. Stage 2 finds the best scale.
-
-### Stage 1: Assignment Order
-
-Fix scale = our 7 functions (setup, inciting_incident, escalation, turning_point, crisis, climax, resolution). Vary the order:
-
-| Run | What Pass 2 assigns | What Pass 3 assigns | Pass 3 sees |
-|-----|--------------------|--------------------|-------------|
-| A | nothing (events only, no function) | arc function | all events across season, plotlines |
-| B | episode function | arc function | all events + their episode functions |
-| C | arc function (preliminary) | arc function (corrected) | all events + preliminary arc functions |
-| D | episode function + arc function (both) | — | plotlines + 1 episode |
-
-Run A: cleanest — no anchoring from episode function. But Pass 3 gets no function signal at all.
-Run B: current plan — episode functions exist, Pass 3 adds arc functions on top.
-Run C: Pass 2 guesses arc function from one episode, Pass 3 corrects with full season view.
-Run D: Pass 2 does everything — cheapest (no Pass 3 work), but one-episode context for arc.
-
-### Evaluation: Majority Voting
-
-Each run repeated 3 times. For each event, compare arc function across 3 runs.
-
-**Agreement rate** = fraction of events where all 3 runs agree. Higher = model is more confident = assignment is more natural for the model.
-
-No ground truth needed at this stage — we're measuring model self-consistency, not correctness.
-
-### Test data
-
-Breaking Bad S01, plotline "Walt: Empire" — ~80 events across 7 episodes. One plotline, clear arc, well-known show.
-
-### Stage 2: Scale
-
-Take the winning order from Stage 1. Test 4 scales:
-
-| Scale | Values |
-|-------|--------|
-| Our 7 | setup, inciting_incident, escalation, turning_point, crisis, climax, resolution |
-| Harmon 8 | you (comfort), need, go, search, find, take, return, change |
-| McKee 5 | inciting incident, progressive complications, crisis, climax, resolution |
-| Freytag 5 | exposition, rising action, climax, falling action, denouement |
-
-Same evaluation: 3 runs each, agreement rate.
-
-### Stage 3: Confirmation
-
-Take winning scale + one alternative. Test with a different order than the winner. If agreement rate stays similar — order and scale are independent. If it drops — they interact.
-
-## What we need to build
-
-### For Stage 1
-
-- Prompt variant for each run (A-D)
-- Script that:
-  - Extracts events for one plotline from existing pipeline result
-  - Calls LLM with appropriate prompt 3 times
-  - Compares arc function assignments across runs
-  - Reports agreement rate per event and overall
-- No changes to pipeline code — this is a standalone experiment
-
-### Prompts
-
-**Run A prompt (Pass 3 assigns, no episode functions):**
-"Here are all events for plotline [name] across the season, in episode order. Assign a dramatic function (arc_fn) to each event based on its role in the season-long arc. Values: setup, inciting_incident, escalation, turning_point, crisis, climax, resolution."
-
-**Run B prompt (Pass 3 assigns, sees episode functions):**
-Same + "Each event already has a function assigned for its role within the episode. The arc function may differ."
-
-**Run C prompt (Pass 2 assigns preliminary):**
-"Here is one episode's events for plotline [name]. Guess the arc function based on what you see. You may be wrong — this will be corrected later with full season context."
-Then Pass 3 prompt: "Here are preliminary arc functions. Correct them with full season view."
-
-**Run D prompt (Pass 2 assigns both):**
-"For each event, assign two functions: episode_fn (role in this episode) and arc_fn (role in the season arc, as far as you can tell from this episode)."
-
-## Metrics
-
-- **Agreement rate** per run = events with 3/3 agreement / total events
-- **Partial agreement** = events with 2/3 agreement
-- **Disagreement** = events with 3 different answers
-- **Distribution** = how many events get each function (is it balanced or all escalation?)
-
-## Cost estimate
-
-BB Empire: ~80 events. Each run = 1-3 LLM calls (depending on variant). 3 repeats.
-Stage 1: 4 variants × 3 repeats = 12 calls. ~$1-2.
-Stage 2: 4 scales × 3 repeats = 12 calls. ~$1-2.
-Stage 3: 2 calls × 3 repeats = 6. ~$0.50.
-Total: ~$3-5.
-
-## Files
-
-- `scripts/arc_fn_experiment.py` — experiment runner
-- `3-resources/tvplotlines/experiment-arc-functions.md` — this plan
-- Results saved to `experiments/arc_functions/` (gitignored)
-
-## Execution order
-
-1. Write experiment script
-2. Run Stage 1 (4 variants × 3 repeats) on BB Empire
-3. Analyze agreement rates → pick best order
-4. Run Stage 2 (4 scales × 3 repeats) with best order
-5. Analyze → pick best scale
-6. Run Stage 3 (confirmation)
-7. Write up results
-8. If results clear → implement in pipeline
diff --git a/docs/knowledge/archive/plans/experiment-ru-vs-en-prompts.md b/docs/knowledge/archive/plans/experiment-ru-vs-en-prompts.md
deleted file mode 100644
index d60fd80..0000000
--- a/docs/knowledge/archive/plans/experiment-ru-vs-en-prompts.md
+++ /dev/null
@@ -1,22 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# Эксперимент: русские vs английские промты для русских синопсисов
-
-## Гипотеза
-
-По данным AlKhamissi et al. (2024), язык промта активирует культурно-специфичные знания модели. Русский промт при анализе русских синопсисов должен давать более точный результат, чем английский — потому что активирует «подсеть» русской литературной и сценарной традиции.
-
-## Дизайн
-
-- Взять русский сериал с русскими синопсисами
-- Прогнать через tvplotlines дважды: `--lang ru` и `--lang en`
-- Сравнить результаты: качество сюжетных линий, точность Story DNA, адекватность event functions
-- Оценка: ручная (экспертная) + количественная (количество storylines, confidence levels, патчей из Pass 2, вердиктов из Pass 3)
-
-## Статус
-
-Ждёт выполнения. Зависит от стабильности pipeline.
diff --git a/docs/knowledge/archive/plans/local-model-training-plan.md b/docs/knowledge/archive/plans/local-model-training-plan.md
deleted file mode 100644
index 09d81f9..0000000
--- a/docs/knowledge/archive/plans/local-model-training-plan.md
+++ /dev/null
@@ -1,93 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# Fine-tuning локальной модели для Pass 2
-
-## Зачем
-
-Pass 2 (назначение событий на сюжетные линии) — самый частый LLM-вызов в пайплайне: один вызов на каждый эпизод. Fine-tuning маленькой модели (Qwen 7B) позволит запускать Pass 2 локально, бесплатно, без API. Остальные проходы остаются на Claude (они дешёвые — 1–3 вызова на сезон).
-
-Без fine-tuning локальная модель тупит (проверяли) — не понимает narratology-терминологию, ломает JSON. С fine-tuning она учится воспроизводить паттерн из примеров Claude (knowledge distillation).
-
-## Предпосылки
-
-- Промпты должны быть **стабилизированы** — каждое изменение промпта обесценивает training data
-- Все старые результаты (House, ER и др.) получены на устаревших промптах (другая схема: `driver` вместо `hero`, `franchise_type` вместо `format`, нет `nature`/`confidence`/`is_anthology`, нет Pass 4)
-- Breaking Bad S01 ближе к текущему формату, но тоже есть расхождения (`plotline` vs `plotline_id`)
-
-## Имеющиеся данные
-
-### Синопсисы (готовы, 263 эпизода)
-
-| Сериал | Эпизодов | Формат |
-|---|---|---|
-| Breaking Bad | 62 (S01–S05) | serial |
-| Lost | 26 | serial |
-| ER | 26 | procedural |
-| CSI/Criminal Minds | 24 | procedural |
-| House | 23 | procedural |
-| This Is Us | 19 | ensemble |
-| Metod | 17 | procedural |
-| Godless | 14 | serial |
-| Major | 13 | hybrid |
-| Mad Men | 13 | serial |
-| Game of Thrones | 10 | hybrid |
-| True Detective | 8 | serial |
-| Slovo Patsana | 8 | serial |
-
-### Результаты (есть, но устаревшие)
-
-- BB S01–S05 — посчитаны, но на старых промптах
-- Остальные — только S01, на ещё более старых промптах
-- **Всё нужно пересчитать** на финальных промптах
-
-## План
-
-### Этап 1. Стабилизировать промпты
-- [ ] Довести промпты до финального состояния (идёт сейчас)
-- [ ] Зафиксировать версию (тег или коммит)
-
-### Этап 2. Собрать dataset (~$15–25, batch mode со скидкой 50%)
-- [ ] Пересчитать все 13 сериалов на финальных промптах (263 эпизода)
-- [ ] Проверить качество выборочно (2–3 сериала разных форматов)
-- [ ] Сохранить результаты как training data
-
-### Этап 3. Добрать до 500 примеров (~$10–20)
-- [ ] Нагенерить синопсисы для новых сезонов через synopses_writer (GOT S02–S04, Lost S02, House S02 и т.д.)
-- [ ] Прогнать через пайплайн
-- [ ] Итого: ~500 пар вход/выход для Pass 2
-
-### Этап 4. Fine-tuning
-- [ ] Написать скрипт сборки dataset: system prompt (pass2.md + glossary) + user message (JSON) + assistant response (JSON)
-- [ ] Конвертировать в ChatML формат
-- [ ] QLoRA fine-tune Qwen 2.5 7B (работает на 16GB RAM)
-- [ ] Библиотеки: `unsloth` или `peft` + `transformers`
-
-### Этап 5. Оценка
-- [ ] Прогнать fine-tuned модель через пайплайн (подключить через Ollama)
-- [ ] Сравнить coverage и consistency с Claude
-- [ ] Проверить: fine-tuned Pass 2 + Claude Pass 3 (ревизия) ≈ 90% качества?
-
-## Ожидания по качеству
-
-| Аспект | Ожидание |
-|---|---|
-| JSON-формат | ~95% корректных ответов |
-| Назначение событий на линии | 70–85% от качества Claude |
-| Narrative functions | 60–70% от качества Claude |
-| С Pass 3 ревизией на Claude | ~90% общего качества |
-
-## Бюджет
-
-- Этап 2: $15–25 (batch API, 263 эпизода)
-- Этап 3: $10–20 (синопсисы + пайплайн, ~240 эпизодов)
-- Итого: **$25–45** разовая инвестиция
-
-## Заметки
-
-- Начинать с Pass 2 — максимальный ROI (самый частый вызов)
-- 200 примеров — нижняя граница, 500 — рабочее качество, 1000+ — уровень Claude
-- Если gap с Claude слишком большой — добирать данные прицельно на слабых форматах (ensemble, anthology)
diff --git a/docs/knowledge/archive/plans/metrics-survey.md b/docs/knowledge/archive/plans/metrics-survey.md
deleted file mode 100644
index a95b610..0000000
--- a/docs/knowledge/archive/plans/metrics-survey.md
+++ /dev/null
@@ -1,154 +0,0 @@
----
-type: spec
-project: tvplotlines
-status: active
----
-
-# Метрики качества извлечения сюжетных линий — обзор литературы
-
-Март 2026. Обзор современных подходов к оценке качества narrative extraction / storyline clustering.
-
-## Наши текущие метрики
-
-| Метрика | Формула | Что измеряет |
-|---------|---------|-------------|
-| **Coverage** | доля событий с non-null storyline | Полнота разметки |
-| **Consistency (ARI)** | Adjusted Rand Index по сетке (episode, character) → storyline | Стабильность между прогонами |
-| **Score** | coverage × consistency | Композитный показатель |
-
-## Что используют Balestri & Pescatore (ICAART 2025)
-
-Статья: [Multi-Agent System for AI-Assisted Extraction of Narrative Arcs in TV Series](https://arxiv.org/html/2503.04817v1)
-
-- Character entity accuracy: 98.4% (61/62)
-- Anthology arc precision: 89.3% (25/28)
-- Нет recall, F1 или систематических метрик для Soap/Genre-Specific арок
-- Сравнение с одной экспертной разметкой (Grey's Anatomy S1)
-- Авторы сами признают — это proof-of-concept, не строгая оценка
-
-**Вывод**: планка невысокая, можно значительно улучшить.
-
----
-
-## Метрики без разметки (annotation-free)
-
-### Кластерные метрики (internal validation)
-
-Поскольку извлечение линий — это по сути кластеризация (события → кластеры-линии), применимы стандартные метрики кластеризации.
-
-| Метрика | Как работает | Диапазон | Что нужно |
-|---------|-------------|----------|-----------|
-| **Silhouette Coefficient** | Насколько событие похоже на свой кластер vs ближайший чужой | [-1, 1] | Эмбеддинги событий |
-| **Davies-Bouldin Index** | Отношение внутрикластерного разброса к межкластерному | [0, ∞), меньше лучше | Эмбеддинги событий |
-| **Calinski-Harabasz Index** | Отношение межкластерной дисперсии к внутрикластерной | больше лучше | Эмбеддинги событий |
-
-**Как реализовать**: эмбедить текст каждого события (sentence-transformers или OpenAI embeddings), затем sklearn.metrics для расчёта.
-
-### Нарративная когерентность
-
-Из статьи [Narrative Trails (Text2Story 2025)](https://arxiv.org/html/2503.15681v1):
-
-| Метрика                | Что измеряет                                                                                                             |
-| ---------------------- | ------------------------------------------------------------------------------------------------------------------------ |
-| **Minimum Coherence**  | Самое слабое звено в линии — минимальная похожесть между соседними событиями                                             |
-| **Reliability**        | Геометрическое среднее когерентности по последовательным событиям в линии                                                |
-| **Coherence function** | `θ(u,v) = sqrt(S(z_u, z_v) · T(ẑ_u, ẑ_v))` — комбинация угловой похожести эмбеддингов и топик-похожести (Jensen-Shannon) |
-| **nDTW**               | Dynamic Time Warping между извлечённой и референсной линией, нормализованный по длине пути                               |
-| **DTW Similarity**     | Средняя cosine similarity вдоль выравнивания DTW                                                                         |
-|                        |                                                                                                                          |
-
-**Применимость**: coherence и reliability можно считать без разметки. DTW-метрики нужны для сравнения с эталоном.
-
-### LLM-as-a-Judge
-
-Из статьи [LLM-as-a-Judge for Narrative Coherence (Electronics, 2025)](https://www.mdpi.com/2079-9292/14/13/2735):
-
-- LLM-судья достигает **корреляции Пирсона ~0.65** с математическими метриками когерентности
-- **Надёжность между прогонами ICC > 0.92** — очень стабильно
-- Простые промпты работают почти так же хорошо, как сложные (90%+ от сложных подходов)
-- Дёшево, не нужна разметка, даёт "человекоподобную" оценку
-
-### Метрики из NLP-литературы по оценке нарративов
-
-Из обзора [What Makes a Good Story and How Can We Measure It? (2024)](https://arxiv.org/html/2408.14622v1):
-
-| Метрика | Что делает |
-|---------|-----------|
-| **CTRLEval** | Text infilling для оценки cohesion, consistency, relevance. Без эталона |
-| **COHESENTIA** | Предложение за предложением оценивает локальную и глобальную связность |
-| **BARTScore** | Вероятности токенов BART для оценки когерентности |
-| **G-EVAL** | LLM-промпт с пошаговым рассуждением, гибкие измерения |
-| **Perplexity** | Низкая perplexity конкатенированных событий линии = хорошая связность |
-| **Distinct-n** | Доля уникальных n-грамм — детектор слишком похожих линий |
-
----
-
-## Метрики с золотым стандартом (external validation)
-
-Нужна экспертная разметка хотя бы для одного шоу (события → эталонные линии).
-
-| Метрика | Что измеряет | Преимущество над ARI |
-|---------|-------------|---------------------|
-| **NMI (Normalized Mutual Information)** | Взаимная информация между предсказанием и эталоном, [0, 1] | Робастнее для кластеров разного размера |
-| **AMI (Adjusted Mutual Information)** | NMI с поправкой на случайность | Строже NMI |
-| **V-measure** | Гармоническое среднее homogeneity и completeness | Раскладывается: видно, проблема в пере-дроблении или недо-дроблении |
-| **B-cubed F1** | Precision/recall на уровне каждого события | Стандарт в coreference resolution (похожая задача) |
-| **F1 macro** | Средний F1 по линиям | Используется в SemEval-2025 Task 10 |
-| **BERTScore F1** | Семантическая похожесть сгенерированных описаний с эталонными | Для оценки описаний линий (name, goal, etc.) |
-
----
-
-## Смежные бенчмарки
-
-| Название                               | Год  | Что оценивает                                                                                    |
-| -------------------------------------- | ---- | ------------------------------------------------------------------------------------------------ |
-| **SemEval-2025 Task 10**               | 2025 | Извлечение нарративов из новостей. F1 macro + BERTScore                                          |
-| **SeriesBench (CVPR 2025)**            | 2025 | Понимание сериалов — 28 задач по 105 сериалам                                                    |
-| **NarraBench**                         | 2025 | Таксономия 50 аспектов нарратива. Только 27% задач покрыто существующими бенчмарками             |
-| **Topic Detection and Tracking (TDT)** | NIST | Классика: miss rate, false alarm rate. Концептуально близко (новости → топики ≈ события → линии) |
-
----
-
-## Стабильность LLM между прогонами
-
-Исследования 2024-2025 подтверждают:
-- Разброс точности до **10% между идентичными прогонами** даже с temperature=0
-- Агрегация по **3-5 прогонам** резко повышает стабильность
-- Наш ARI-подход — валидный, литература поддерживает измерение inter-run agreement как первоклассную метрику
-
----
-
-## Практические рекомендации
-
-### Быстро добавить (без разметки, без больших затрат)
-
-1. **Silhouette Score** — эмбеддинги событий + sklearn. Объективная метрика качества кластеризации.
-2. **Within-storyline coherence** — средняя попарная похожесть событий одной линии.
-3. **Storyline separation** — средняя между-линейная похожесть (ниже = лучше, линии разные).
-4. **LLM-as-judge** — промпт для оценки каждой линии по рубрике.
-
-### Средний горизонт (нужна одна экспертная разметка)
-
-5. **V-measure** — вместо ARI, диагностирует тип ошибки.
-6. **B-cubed F1** — стандарт для coreference-подобных задач.
-7. **NMI** — робастнее ARI для неравных линий.
-
-### Долгосрочно (инфраструктура)
-
-8. **Narrative coherence из Narrative Trails** — нужны хорошие эмбеддинги + реализация.
-9. **Multi-run aggregation** — прогон 3-5 раз, усреднение.
-10. **SeriesBench-подобный бенчмарк** — золотая разметка для нескольких шоу разных типов.
-
----
-
-## Источники
-
-- Balestri & Pescatore, ICAART 2025 — [arxiv.org/html/2503.04817v1](https://arxiv.org/html/2503.04817v1)
-- Narrative Trails, Text2Story 2025 — [arxiv.org/html/2503.15681v1](https://arxiv.org/html/2503.15681v1)
-- LLM-as-a-Judge for Narrative Coherence, 2025 — [mdpi.com/2079-9292/14/13/2735](https://www.mdpi.com/2079-9292/14/13/2735)
-- What Makes a Good Story, 2024 — [arxiv.org/html/2408.14622v1](https://arxiv.org/html/2408.14622v1)
-- NarraBench, 2025 — [arxiv.org/html/2510.09869v3](https://arxiv.org/html/2510.09869v3)
-- SemEval-2025 Task 10 — [propaganda.math.unipd.it/semeval2025task10](https://propaganda.math.unipd.it/semeval2025task10/)
-- SeriesBench, CVPR 2025 — [arxiv.org/abs/2504.21435](https://arxiv.org/abs/2504.21435)
-- LLM Stability, 2024 — [arxiv.org/html/2408.04667v2](https://arxiv.org/html/2408.04667v2)
-- Scikit-learn Clustering — [scikit-learn.org/stable/modules/clustering.html](https://scikit-learn.org/stable/modules/clustering.html)
diff --git a/docs/knowledge/archive/plans/next-session-plan.md b/docs/knowledge/archive/plans/next-session-plan.md
deleted file mode 100644
index 43e6c63..0000000
--- a/docs/knowledge/archive/plans/next-session-plan.md
+++ /dev/null
@@ -1,67 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# Что доделать (после сессии 2026-03-26/27)
-
-## Не закончено
-
-### 1. Theme-led не работает на Mad Men
-MM прогон показал: 6 plotlines, все character-led, ни одной институциональной.
-Две причины:
-- **Синопсисы** — synopses_writer пишет через character lens, рекламные кейсы = фон
-- **Промпт Pass 1** — нет примера theme-led plotline в JSON output, правило «when in doubt don't create» давит
-
-Нужно:
-- [ ] Поправить промпт synopses_writer — явно просить описывать институциональную/рабочую динамику, не только персональные конфликты
-- [ ] Добавить theme-led пример в JSON output секции pass1.md
-- [ ] Перегенерировать синопсисы MM
-- [ ] Прогнать заново, сравнить
-
-### 2. Протестировать на других шоу
-- [ ] CSI S01 — procedural, ожидаем case_of_the_week + «Lab Politics»
-- [ ] Slow Horses S01 — нужны синопсисы (write-synopses теперь работает с Wikipedia search)
-- [ ] Ablation testing — откатывать изменения по одному, смотреть что ломается
-
-### 3. write-synopses рефакторинг
-- [ ] Заменить Wikipedia-парсер на LLM с web search (или по памяти)
-- [ ] Нужен search tool в call_llm (tool use loop) или callback search_fn
-- [ ] Пока что — Wikipedia search API работает (починили), но парсер ломается на нестандартных страницах
-
-### 4. Два измерения функций (будущее)
-Записано в `3-resources/tvplotlines/two-function-dimensions.md`.
-- Pass 2: episode function (Dan Harmon circle или simplified)
-- Pass 3: arc function (plot_fn) — роль в сезонной арке
-- Сейчас убрали из Pass 3, нужно вернуть когда будет ясна модель
-
-### 5. Pass 3: reviewed_rank
-Решили что Pass 3 просто ставит свои ранки, код сравнивает. Но механизм не реализован:
-- [ ] Формат вывода Pass 3 — добавить поле ranks в JSON ответ
-- [ ] Код pass3.py — парсить ranks, записывать в reviewed_rank
-- [ ] Сравнение computed_rank vs reviewed_rank в pipeline
-
-### 6. formulas.md
-- [ ] Добавить design rationale / цитаты из книг ко всем формулам
-- [ ] Обновить после всех изменений (rank, ensemble, patches removed)
-
-### 7. Chain-of-thought
-- [ ] Исследовать эффект на качество (все пассы)
-- [ ] Может просить LLM рассуждать в отдельном поле перед ответом
-
-## Закончено в этой сессии
-- ✅ --stop-after / --resume-from / --output-dir в CLI
-- ✅ Rank refactor (computed_rank + reviewed_rank)
-- ✅ Ensemble как формат (убран is_ensemble)
-- ✅ Limited убран
-- ✅ Patches убраны
-- ✅ PROMOTE/DEMOTE убраны
-- ✅ Shared glossary
-- ✅ Theme-led правки в glossary и pass1
-- ✅ Wikipedia search fix
-- ✅ docs/formulas.md
-- ✅ Rank experiment + скрипт
-- ✅ Pass 2: функции episode-scoped
-- ✅ Chain-of-thought nudge во всех промптах
-- ✅ Changelog
diff --git a/docs/knowledge/archive/plans/notes-for-3rd-autoresearch.md b/docs/knowledge/archive/plans/notes-for-3rd-autoresearch.md
deleted file mode 100644
index 435392e..0000000
--- a/docs/knowledge/archive/plans/notes-for-3rd-autoresearch.md
+++ /dev/null
@@ -1,76 +0,0 @@
-# Замечания к промптам 
-## PASS 0 
-1. check if pass0 is nessesary or it works as good when this infor we get at first stage of pass1 - it seems by our experiments it might be, it saves us money on tokens (again it seems)
-2. see if Franchise type definitions that we have in glossary work better to differentiate between procedural and hybrid 
-3.  If each episode has its own focal character — ensemble. - this we have in pass0 which is not a correct statement and  definition in glossary is more accurate - need to replace 
-4. > [Hero] [transformation], testing how far they'll go for [goal] эта формулировка с testing несколько ограничивает передачу сути нудно найти точнее 
-5.   "season": 1, а откуда сейчас ьеертся номер сезона?
-6. - `format`: enum — `"ongoing"` | `"limited"` | `"anthology"` | null (if unclear) не вижу нигде объяснения в промпте для этого поля, но в глоссари кажется оно есть 
-7. After validation, the result is shown to the human for confirmation or editing. - это не так, зачем это написано в промпте?
-8. Я посмотрела что используется в контракте на входе в Пасс 1 и не вижу где используются все поля которые мы собираем на Пасс 0 - есть такое ощущение что мы из собираем а потом нигде не используем - зачем тогда собираем?
-
-## PASS 1
-1. **Input**: Pass 0 output (`show`, `season`, `franchise_type`, `story_engine`) + all season synopses а ниже : ## Input
-- **show**: show title (from Pass 0)
-- **season**: season number (from Pass 0)
-- **franchise_type**: procedural / serial / hybrid / ensemble (from Pass 0)
-- **story_engine**: one sentence (from Pass 0)
-- **format**: ongoing / limited / anthology / null (from Pass 0)
-- **synopses**: all season synopses (text) Зачем дважды и при этом еще по разному определяется что на входе?
-1. If `prior_season` is present in the input, it contains cast and storylines from the previous season. - откуда вдруг берется это поле? И весь этот пункт про предыдущий сезон - это мы добавили уже после калибровки, проверяли на берйкин бед впроде качество извлечения линий не изменилось но мне кажется сейчас тут не оч понятно : это вот что и где берется `prior_season.plotlines`, **TRANSFORMED** — same driver, but goal fundamentally changed. Keep the `id`, rewrite Story DNA. - это я не уверена вообще что из какой-то теории или в реальности так бывает. **ENDED** — the storyline resolved or disappeared. - это что у нее пометка или ты помечаешь? но что ты помечаешь если ее нет?
-2. Так оптимально добавлено то что сказано выше еще раз но в TAsk?
-3. ### Storyline = Story DNA A storyline = hero + goal + obstacle + stakes. Missing any component — not a storyline, but an event within another storyline. - не ясно если это едиственно место где мы используем Story DNA то нужно вообще тогда этот термин выбросить или же дать ему определение как у нас в словаре и использовать тогда везде как шортхэнд. 
-4. В словаер еще отлично обхясняется связь между франщизой мотором и дна. если это полезно нужно включать в промпт 
-5. Additionally: a storyline has a three-act structure, conflict, and a causal chain of events. это плохое объяснение мне кажется нужно про арку писать чтобы подвести к функциям в Пасс 2. Это и словаре сейчас слабо 
-6. Мне кажется что в словаре лучше дано определение storyline 
-7. Если мы все меняем я бы протестировала и замеенила если не испорти везде storyline на plotline - это более точные термин и у нас в названии есть 
-8. Типы episodic это какое-то сочинение ЛЛМ такого нет в ощепринятх делениях нужно понять чему это помогает и кажется в словаре мы нашли решение. 
-9. нужно давать точное название линии в которой будут все case of the week чтобы сразу было понятно а то она сейчас называется содержательно например у house - investigation вообще не ясно о чем 
-10. **A** — protagonist's storyline or franchise engine, most screen time, plot-led conflict. хочу убедиться что где-то утверждается что линия а однощначно и всегда плот-лед и где вообзе объясняется что это такое в промпте? плот или карактер лед? в словаре однако у нас есть но я хочу убедиться что это уточнение нужно и правильное и мы испольущем 
-11. - **runner** — incomplete Story DNA, no obstacle/resolution отпять же если можно обойти без Story DNA обойтись
-12. нужно синхронихировать glossary с промптами и хочется глоссари сделать граунд труз если авторесеч проверит что не ухудшится качество извлечения 
-13. а вот определение **Plot-led** — external goal vs antagonist.- **Character-led** — internal conflict, protagonist = their own antagonist. во первых сначала "вызывается функция" а потом определяется во вторых в глоссари точнее в третьих хочу понять где взялось и зачем собираем 
-14. Seed and wraparound — not storyline types это вообще убрать опять какие то термины не опеределенные используются и смысла нет в этом конктрейне 
-15.  Test: if you can't write a logline (hero + goal + obstacle)  у тебя есть строи дна там 4 части почему здесь их только три? 
-16. What is NOT a storyline плозие примеры кроме "John and Mike's friendship" и "Investigation" (procedural, ep.5)
-17. Story DNA is reconstructed from the aggregate of mentions across the season. Don't invent — mark confidence. вообще не поняла что за инструкция?
-18. Episodic storyline (franchise engine): по прежнему не нравится термин Episodic storyline - вот это все кажется не выполняется - проверить на сериях по которым есть результаты
-19. вот же объяснение как называть и вроде операциональное зачем два предыдущих абзаца? Always use `Driver: Theme` format for storyline names (e.g. "House: Authority", "Cameron: Ethics", "Jon: Honor"). This makes it clear who drives each storyline and prevents confusion during event assignment.
-20. Narrative devices - не уверена вообще что это нужно не уверена что полный список не понятно как будет использоваться после ... нужно понять нужно ли это собирать и назначать 
-21. про формат тоже не понимаю зачем чему помогает франшизы достаточно 
-22. про уверенность кстати я вообще не оняла где объясняется что за уверенность и как работает вообще в примере стоит драматик айрони про линии ББ меня слильно смушает я бы убрала эти деввайсы 
-23. see naming convention) при этом раздел называтеся нейминг 
-24. `obstacle`: string  `stakes`: string почему не лист интересно 
-25. Language of `goal`, `obstacle`, `stakes` fields — in the language of the synopsis. я бы это подчеркнула еще раньще а не в конце вот это стоит сформулировать дважды 
-26. - For procedural/hybrid: exactly one storyline with `type: "episodic"` ну вот название не нравится 
-27. If code detects an error — re-request from LLM with specific indication of what's wrong. как это сейчас выглядит?
-
-## PASS 2
-
-1.  **Self-contained document.** Compiled from `storyline-extraction-reference.md`, but fed to the LLM as-is. When reference is updated — recompile. это нужно в промпте? если мы относимся к промпт как к программе то зачем тут это например?
-2. **Input**: Pass 1 output (`show`, `season`, `cast`, `storylines`)  - шоу в смысле title? season в смысле номер? 
-3. опять же я не пойму в раздле контракт одно напино а потом инпут и другое 
-4.  Two actions by different characters = two events. это не очевидно из первого определения? не понимаю зачем здесь 
-5.  Step 3: Identify interactions between storylines а потом Assignment rules - мне кажется про разное я вообще не уверена чот это нужно Step 3: Identify interactions between storylines но мы нашли способ даже это как-то показывать вроде в аналитике - короче вопрос ро взаимодействие линий нужено понять но правила тут все не про взаимодействия а стояь после 
-6. вот функции это то что мы переделываем это мы нахватали в список что попало а сейчас нашли более принятые функции и хотим добавить их описав поточнее и там есть еще констрейны и особенности по нима какие после каких не могу быть какие могут повторяться 
-7. и мы та и не решеили все ли ивент имеют функцию - должны иметь все но бывает всякое 
-8. опять девайсы они уже были в предыдущем пас не помню объяснялись и эти же ли нужно убедиться что одинаковые понять зачем и там и там и вообще оставлять ли их где они нужны на чот влиятют 
-9. опять раздел про взаимодействие - опять мне не понятно почему опять раздел и вообще зачем это взаимодетсви 
-10. **Emotional counterpoint**: if all storylines are rising or all falling — something is missed or functions are wrong вообще не поняла чего?
-11. Weight (`primary` / `background` / `glimpse`) is computed by code from event counts — do NOT include in JSON. это вообще гле взялосб? оперделений не было я помню было оюъяснение чем отличается от А Б С но не уверена что поняли и вот это нужно тут 
-12. patches вижу в коде не понимаю что делают 
-13. **summary.interactions[].**: что это где испольщуется
-14. **summary.patches[].**: что это где используется 
-15. If code detects an error — re-request from LLM with specific indication of what's wrong. какое правило вызова? 
-16. опять Patches to Pass 1 - функцию сначала заявили потом описали - плохой подход
-17. вообще если относиться к промптам как к программах то выглядит бледно стыдно такое показывать 
-
-## PASS 3
-1.  При обновлении — пересобрать из ADR-005 и reference. это все вообще актуально? должно быть в промте который идет в библиотеку?
-2. но без возможности исправить список линий - точнее изменить потому что патчи то он делает 
-3. plotlines тут вдруг уже плотлайнс а было до этого вроде сторилайнс 
-4. > "Story DNA has four parts: Hero, Goal, Obstacle, Stakes." — Nash, p.34 зачем читаты и страницы в промпте 
-5. **Но сериалы бывают плохо написаны.** Линия может существовать в сериале без чёткой цели, с номинальным конфликтом, или быть заброшенной на полпути. Это не значит, что её нет — это значит, что она слабая. **Не выбрасывай такие линии — помечай через confidence:** это вообще ужасный текст в промпте №для всех"
-6. Для каждой линии посмотри на function событий через весь сезон.  это вообще что сказано? я переключилась случайно на русскую версию но в целом даже по англйиски это что?
-7. "In a multi-stranded narrative, each strand usually has its own dramatic three-act structure." — Oberg, p.60 опять цитата и страница 
-8. короче даже дочитывать не хочу - все претенации не последовательно не системно не основано на теории избыточно неточно вообще не соотсветсует заявлением что мы делаем "программу" для ЛЛМ 
\ No newline at end of file
diff --git a/docs/knowledge/archive/plans/one-page.md b/docs/knowledge/archive/plans/one-page.md
deleted file mode 100644
index 22d3c20..0000000
--- a/docs/knowledge/archive/plans/one-page.md
+++ /dev/null
@@ -1,67 +0,0 @@
----
-type: draft
-project: tvplotlines
-status: active
-date_read: 2026-03-20
----
-
-# What it is
-A Python library that extracts key plotlines from TV episode synopses.
-
-# Why it exists
-
-"To PLOT means to navigate through the dangerous terrain of story and when confronted by a dozen branching possibilities to choose the correct path. Plot is the writer's choice of events and their design in time." (p. 26) McKee
-
-plot is an accurate term that names the internally consistent, interrelated pattern of events that move through time to shape and design a story." McKee
-
-In a story, the storyline encompasses the characters, setting, and the conflict they face. Complex works of fiction feature two or more distinct plots (A-story, B-story) that may run independently or eventually intersect at the climax. 
-
-**plotlines** specifically ==focus on the **causal mechanics**—the "why" and "how" behind a story’s events==. A plotline is the logical thread that connects actions to their consequences, whereas a storyline is often seen as the chronological summary of what happens.
-
-- **Story**: "The king died and then the queen died." (A simple chronological sequence).
-- **Plot**: "The king died, and then the queen died **of grief**." (Adds causality and emotional weight).
-In longer works like novels or TV series, authors often weave multiple plotlines together: 
-
-- **Master Plotline**: The overarching primary conflict of the work.
-- **Subplotlines**: Secondary threads that support the main plot or develop side characters.
-- **Internal Plotlines (Character Arcs)**: The emotional or psychological journey and transformation of a character.
-- **External Plotlines**: The physical events, such as battles, quests, or investigations.
-
-
-A TV series is a transformation machine. It's an elaborate Rube Goldberg device designed to test the same character flaw over and over and over.
-
-if someone asks, "What's Season 1 ?" you'll have an exciting answer full of twists and turns and OMG moments. You'll have enough story that they'll lean forward and go, "Mmmm-hmmm, that is good. I think you've got something."
-
-the quickest way to lose your series' audience is to slow-burn the season-long story, not providing the necessary stake-raisers, plot twists, and emotional turning points that viewers crave.
-
-# What it does
-
-tvplotlines takes plain-text episode synopses (300–500 words each) and returns a JSON breakdown of the season's plotlines.
-
-Each plotline gets four fields — driver, goal, obstacle, stakes — following Jamie Nash's *Save the Cat! Writes for TV* (2018). Plotlines are ranked A, B, or C by narrative weight.
-
-Every event in every episode is assigned to a plotline with a narrative function: setup, escalation, turning point, climax, resolution, or cliffhanger. The output also includes show structure (procedural, serial, hybrid, or ensemble), episode themes, and interactions between plotlines — convergence, dramatic irony, thematic echoes.
-
-# How it works
-
-The LLM interprets narrative; code enforces structure.
-
-Four LLM passes, each feeding the next:
-
-1. **Detect show structure.** Procedural? Serial? Ensemble? This determines what counts as a plotline.
-2. **Extract plotlines.** The LLM reads all synopses and identifies season-level arcs. Three independent extractions run in parallel; the system takes the majority answer.
-3. **Break down each episode.** Assign every event to a plotline. Flag anything that does not fit.
-4. **Review the full picture.** A final pass catches problems: plotlines that should merge, ranks that do not match screen time, threads that emerge late.
-
-Between passes, code validates output, computes plotline span and weight, reassigns orphan events, and applies the final pass's decisions — merge, split, promote, demote — mechanically.
-
-# How to view results
-
-The output is JSON. Any tool that reads JSON can display it. A companion viewer app is available at [link].
-
-# Who is it for
-
-- **Development executives** — structured season overview without reading full scripts
-- **Writers' rooms** — map how plotlines weave, collide, and echo across episodes
-- **Story analysts** — a structured first pass before deep coverage
-- **Tool builders** — tvplotlines is a library, not a closed product; plug it into your own pipeline
diff --git a/docs/knowledge/archive/plans/open-source-release-checklist.md b/docs/knowledge/archive/plans/open-source-release-checklist.md
deleted file mode 100644
index 78f3d19..0000000
--- a/docs/knowledge/archive/plans/open-source-release-checklist.md
+++ /dev/null
@@ -1,65 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# Open-source release checklist
-
-## Code quality
-
-- [x] Тесты проходят (`pytest`) — 77 passed, 1 skipped
-- [x] Нет hardcoded путей, API ключей, персональных данных в коде
-- [x] Нет TODO/FIXME которые блокируют релиз
-- [x] `.env` в `.gitignore`
-- [x] `CLAUDE.md` в `.gitignore` (внутренние инструкции, не для публики)
-
-## Документация
-
-- [x] README: установка, quickstart (CLI + Python), пример вывода, описание pipeline
-- [x] README: примеры кода соответствуют реальному API (имена полей, типы аргументов)
-- [x] docs/quickstart.md — рабочий пример
-- [x] docs/api.md — все параметры `get_plotlines()`, все поля моделей
-- [x] examples/run_pipeline.py — рабочий пример
-- [x] CHANGELOG.md — v0.1.0
-- [x] examples/synopses/ — BB S01 + GoT S01
-- [x] examples/results/ — результаты прогона
-
-## Packaging
-
-- [x] pyproject.toml: name, version, description, authors (с email), license, keywords, classifiers
-- [x] pyproject.toml: dependencies полные (anthropic, openai, scikit-learn)
-- [x] pyproject.toml: CLI entry point (`tvplotlines = "tvplotlines.cli:main"`)
-- [ ] `pip install -e .` работает — нужно проверить вручную в чистом venv
-- [x] `tvplotlines --help` работает
-
-## Legal / metadata
-
-- [x] LICENSE файл (MIT)
-- [x] Copyright owner корректный (BirdInTheTree)
-- [x] Нет чужого кода без атрибуции
-- [x] Синопсисы — собственные пересказы, fair use
-
-## Git
-
-- [x] `.gitignore` покрывает: .env, __pycache__, .DS_Store, CLAUDE.md
-- [x] Нет секретов в git истории
-- [x] Ветка main — основная
-- [x] Удалить старые ветки (autoresearch/*, feature/*, claude/*) перед публикацией
-
-## CI/CD
-
-- [x] GitHub Actions: тесты на push/PR (Python 3.11, 3.12, 3.13)
-- [x] Badge в README: PyPI, License, Python versions
-
-## Перед `git push` в публичный репо
-
-- [ ] Перечитать README глазами нового пользователя
-- [x] `pip install -e .` в чистом venv
-- [ ] Убедиться что репо на GitHub — public (или переключить)
-- [x] Удалить старые ветки
-
-## После публикации
-
-- [ ] `pip install tvplotlines` из PyPI
-- [ ] Проверить что badges в README показывают правильную информацию
diff --git a/docs/knowledge/archive/plans/open-source-strategy.md b/docs/knowledge/archive/plans/open-source-strategy.md
deleted file mode 100644
index f9ef5ff..0000000
--- a/docs/knowledge/archive/plans/open-source-strategy.md
+++ /dev/null
@@ -1,48 +0,0 @@
----
-type: spec
-project: tvplotlines
-status: active
----
-
-# Open Source стратегия
-
-## Главный принцип: библиотека vs приложение
-
-```
-Библиотека (open source)          Приложение (не open source)
-─────────────────────────         ─────────────────────────
-get_plotlines() → результат       БД + интерфейс + редактирование
-чистое вычисление                 хранение, показ, работа с данными
-pip install tvplotlines               твой продукт
-```
-
-Аналогия: калькулятор бесплатный, Excel платный.
-
-## Что открываем, что нет
-
-| Слой | Open source? | Почему |
-|---|---|---|
-| Библиотека `get_plotlines` | Да, MIT | Вычислительное ядро, привлекает пользователей и контрибьюторов |
-| База знаний (how2pitch) | Да, как датасет | Люди могут добавлять книги, переводы, карточки |
-| Приложение (БД + UI + редактирование) | Нет | Коммерческая ценность, продукт автора |
-| books2series | Нет (пока) | Главное конкурентное преимущество |
-
-## Кому нужна библиотека
-
-- **Исследователи** (computational narratology) — вызвать из Jupyter на своём корпусе
-- **Разработчики** — встроить в свои инструменты для сценаристов
-- **Студии** — интегрировать во внутренний пайплайн
-
-## Что нужно для выпуска
-
-1. Написать ядро с нуля (не форк mas4bw, новая реализация на основе книг)
-2. Оформить как Python-пакет с чистым API
-3. README с примерами использования
-4. Опубликовать на PyPI + GitHub
-5. Лицензия: MIT
-
-## Открытые вопросы
-
-- Готовность поддерживать пакет (issues, PR, документация) — отдельная работа
-- Если не готова — выложить на GitHub с MIT без обещания поддержки
-- Какой Reddit: r/screenwriting (~1M), r/LanguageTechnology, r/MachineLearning
diff --git a/docs/knowledge/archive/plans/plan-restructure.md b/docs/knowledge/archive/plans/plan-restructure.md
deleted file mode 100644
index b103db9..0000000
--- a/docs/knowledge/archive/plans/plan-restructure.md
+++ /dev/null
@@ -1,479 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# Project Restructuring Plan
-
-> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Restructure tvplotlines, tvplotlines-app, and knowledge repos to follow industry conventions for open-source Python libraries.
-
-**Architecture:** Three repos with clear boundaries: tvplotlines (public library — code + user-facing docs), tvplotlines-app (private app — code + test data), knowledge (private — all research, notes, specs, experiments). Internal specs and research currently mixed into tvplotlines/docs/ and tvplotlines-app/research/ move to knowledge.
-
-**Principles:**
-- Public repo = what a user cloning from PyPI needs (code, tests, examples, user docs)
-- App repo = what you need to run the app (code, tests, fixtures, synopses)
-- Knowledge repo = everything else (specs, ADRs, research, experiments, book quotes, notes)
-
----
-
-## Chunk 1: Clean up tvplotlines (library)
-
-### Task 1: Remove empty directories
-
-**Files:**
-- Delete: `md/` (empty, only .DS_Store)
-- Delete: `references/` (empty, only .DS_Store)
-
-- [ ] **Step 1: Remove empty dirs**
-
-```bash
-rm -rf md/ references/
-```
-
-- [ ] **Step 2: Remove broken symlink**
-
-`docs/storyline-extraction-reference.md` — symlink to old path, target no longer exists.
-
-```bash
-rm -f docs/storyline-extraction-reference.md
-```
-
-- [ ] **Step 3: Commit**
-
-```bash
-git add -A md/ references/ docs/storyline-extraction-reference.md
-git commit -m "Remove empty directories and broken symlink"
-```
-
----
-
-### Task 2: Move architecture.md to knowledge
-
-`docs/architecture.md` is an internal spec — describes pipeline internals, data structures, prompt strategy. A library user doesn't need this; they need a quickstart and API reference. This belongs in knowledge.
-
-**Files:**
-- Move: `docs/architecture.md` → `knowledge/specs/architecture.md`
-
-- [ ] **Step 1: Create specs/ in knowledge and move**
-
-```bash
-mkdir -p /Users/nvashko/Projects/3-resources/knowledge/specs
-mv docs/architecture.md /Users/nvashko/Projects/3-resources/knowledge/specs/architecture.md
-```
-
-- [ ] **Step 2: Commit in tvplotlines**
-
-```bash
-git add docs/architecture.md
-git commit -m "Move internal architecture spec to knowledge repo"
-```
-
-- [ ] **Step 3: Commit in knowledge**
-
-```bash
-cd /Users/nvashko/Projects/3-resources/knowledge
-git add specs/architecture.md
-git commit -m "Add tvplotlines architecture spec (moved from tvplotlines/docs/)"
-```
-
----
-
-### Task 3: Create proper docs/ for public library
-
-Industry standard for Python libraries: `docs/` contains user-facing documentation built with MkDocs or Sphinx. For now, create stubs that can grow.
-
-**Files:**
-- Create: `docs/index.md` (landing page)
-- Create: `docs/quickstart.md` (getting started)
-- Create: `docs/api.md` (API reference stub)
-
-- [ ] **Step 1: Create docs/index.md**
-
-```markdown
-# tvplotlines
-
-Automatic storyline extraction from TV series synopses.
-
-## What it does
-
-Feed episode synopses → get structured storylines, character arcs, and per-episode event breakdowns.
-
-## Quick links
-
-- [Quickstart](quickstart.md) — get running in 5 minutes
-- [API Reference](api.md) — function signatures and data models
-```
-
-- [ ] **Step 2: Create docs/quickstart.md**
-
-```markdown
-# Quickstart
-
-## Install
-
-\`\`\`bash
-pip install tvplotlines
-\`\`\`
-
-## Basic usage
-
-\`\`\`python
-from tvplotlines import get_plotlines
-
-result = get_plotlines(
-    show="Breaking Bad",
-    season=1,
-    episodes=["Synopsis of S01E01...", "Synopsis of S01E02...", ...],
-)
-
-for storyline in result.plotlines:
-    print(f"{storyline.rank} | {storyline.name} ({storyline.driver})")
-\`\`\`
-
-## Configuration
-
-\`\`\`python
-result = get_plotlines(
-    show="Breaking Bad",
-    season=1,
-    episodes=synopses,
-    llm_provider="openai",       # or "anthropic" (default)
-    pass2_mode="batch",          # "parallel" | "batch" | "sequential"
-)
-\`\`\`
-
-See [API Reference](api.md) for all options.
-```
-
-- [ ] **Step 3: Create docs/api.md stub**
-
-```markdown
-# API Reference
-
-## get_plotlines()
-
-Main entry point. Extracts storylines from a season of TV synopses.
-
-*Full reference will be auto-generated from docstrings.*
-```
-
-- [ ] **Step 4: Commit**
-
-```bash
-git add docs/
-git commit -m "Add user-facing documentation stubs (quickstart, API reference)"
-```
-
----
-
-## Chunk 2: Clean up tvplotlines-app
-
-### Task 4: Remove empty directories from tvplotlines-app
-
-**Files:**
-- Delete: `png/` (empty)
-
-- [ ] **Step 1: Remove**
-
-```bash
-cd /Users/nvashko/Projects/1-projects/tvplotlines-app
-rm -rf png/
-```
-
-- [ ] **Step 2: Commit**
-
-```bash
-git add -A png/
-git commit -m "Remove empty png/ directory"
-```
-
----
-
-### Task 5: Move ADRs from tvplotlines-app to knowledge
-
-Architecture Decision Records are project-level knowledge, not app code. They document why decisions were made — useful across both tvplotlines and tvplotlines-app.
-
-**Files:**
-- Move: `research/decisions/` (5 ADR files) → `knowledge/decisions/`
-
-- [ ] **Step 1: Move**
-
-```bash
-mv research/decisions/ /Users/nvashko/Projects/3-resources/knowledge/decisions/
-```
-
-- [ ] **Step 2: Commit in tvplotlines-app**
-
-```bash
-git add research/decisions/
-git commit -m "Move ADRs to knowledge repo"
-```
-
-- [ ] **Step 3: Commit in knowledge**
-
-```bash
-cd /Users/nvashko/Projects/3-resources/knowledge
-git add decisions/
-git commit -m "Add Architecture Decision Records (moved from tvplotlines-app)"
-```
-
----
-
-### Task 6: Move research notes and references to knowledge
-
-Strategy docs, audit, book quotes, design docs, notes — all knowledge, not app code.
-
-**Files to move:**
-- `research/inventory.md` → `knowledge/specs/inventory.md`
-- `research/open-source-strategy.md` → `knowledge/specs/open-source-strategy.md`
-- `research/mas4bw-library-audit.md` → `knowledge/specs/mas4bw-library-audit.md`
-- `research/metrics-survey.md` → `knowledge/specs/metrics-survey.md`
-- `research/synopsis-authoring-protocol.md` → `knowledge/specs/synopsis-authoring-protocol.md`
-- `research/CONTEXT.md` → `knowledge/specs/tvplotlines-app-context.md`
-- `research/notes/` → `knowledge/notes/tvplotlines-app/`
-- `research/references/` → `knowledge/references/`
-
-- [ ] **Step 1: Create target dirs and move**
-
-```bash
-mkdir -p /Users/nvashko/Projects/3-resources/knowledge/specs
-mkdir -p /Users/nvashko/Projects/3-resources/knowledge/notes/tvplotlines-app
-mkdir -p /Users/nvashko/Projects/3-resources/knowledge/references
-
-# Strategy/audit docs
-mv research/inventory.md /Users/nvashko/Projects/3-resources/knowledge/specs/
-mv research/open-source-strategy.md /Users/nvashko/Projects/3-resources/knowledge/specs/
-mv research/mas4bw-library-audit.md /Users/nvashko/Projects/3-resources/knowledge/specs/
-mv research/metrics-survey.md /Users/nvashko/Projects/3-resources/knowledge/specs/
-mv research/synopsis-authoring-protocol.md /Users/nvashko/Projects/3-resources/knowledge/specs/
-mv research/CONTEXT.md /Users/nvashko/Projects/3-resources/knowledge/specs/tvplotlines-app-context.md
-
-# Notes
-mv research/notes/* /Users/nvashko/Projects/3-resources/knowledge/notes/tvplotlines-app/
-rmdir research/notes/
-
-# References (book quotes, design docs)
-mv research/references/* /Users/nvashko/Projects/3-resources/knowledge/references/
-rmdir research/references/
-```
-
-- [ ] **Step 2: Commit in tvplotlines-app**
-
-```bash
-git add research/inventory.md research/open-source-strategy.md research/mas4bw-library-audit.md research/metrics-survey.md research/synopsis-authoring-protocol.md research/CONTEXT.md research/notes/ research/references/
-git commit -m "Move research notes, references, and strategy docs to knowledge repo"
-```
-
-- [ ] **Step 3: Commit in knowledge**
-
-```bash
-cd /Users/nvashko/Projects/3-resources/knowledge
-git add specs/ notes/tvplotlines-app/ references/
-git commit -m "Add tvplotlines-app specs, notes, and references"
-```
-
----
-
-### Task 7: Move autoresearch experiments to knowledge
-
-Experiment logs, results TSVs, program descriptions — research, not app code.
-
-**Files:**
-- Move: `research/autoresearch/` → `knowledge/experiments/autoresearch/`
-- Move: `research/breakdowns/` → `knowledge/experiments/breakdowns/`
-
-- [ ] **Step 1: Move**
-
-```bash
-mkdir -p /Users/nvashko/Projects/3-resources/knowledge/experiments
-mv research/autoresearch/ /Users/nvashko/Projects/3-resources/knowledge/experiments/autoresearch/
-mv research/breakdowns/ /Users/nvashko/Projects/3-resources/knowledge/experiments/breakdowns/
-```
-
-- [ ] **Step 2: Commit in tvplotlines-app**
-
-```bash
-git add research/autoresearch/ research/breakdowns/
-git commit -m "Move experiment logs and breakdowns to knowledge repo"
-```
-
-- [ ] **Step 3: Commit in knowledge**
-
-```bash
-cd /Users/nvashko/Projects/3-resources/knowledge
-git add experiments/
-git commit -m "Add autoresearch experiments and episode breakdowns"
-```
-
----
-
-### Task 8: Reorganize what stays in tvplotlines-app
-
-After moves, `research/` should contain only operational data: synopses (test input), results (test output), scripts (utilities). Rename to make purpose clear.
-
-**Remaining in research/:**
-- `research/synopses/` — test data, stays
-- `research/results/` — pipeline outputs, stays
-- `research/scripts/` — utilities, stays
-- `research/compute_all_metrics.py`, `compute_embedding_metrics.py`, `per_line_diagnostics.py` — utilities, stay
-
-- [ ] **Step 1: Rename research/ → data/**
-
-`research/` implies knowledge. What stays is operational data: inputs and outputs for the pipeline.
-
-```bash
-mv research/ data/
-```
-
-- [ ] **Step 2: Update any imports/references**
-
-Check if scripts reference `research/` paths internally.
-
-```bash
-grep -r "research/" data/scripts/ data/*.py
-```
-
-Fix paths if found.
-
-- [ ] **Step 3: Commit**
-
-```bash
-git add -A research/ data/
-git commit -m "Rename research/ to data/ — only operational data remains"
-```
-
----
-
-## Chunk 3: Update knowledge registry and MOCs
-
-### Task 9: Add new knowledge dirs to build_registry.py
-
-**Files:**
-- Modify: `knowledge/scripts/build_registry.py` — add specs/, decisions/, references/, experiments/ to local dirs scan
-- Modify: `knowledge/CLAUDE.md` — update structure description
-
-- [ ] **Step 1: Update _LOCAL_DIRS in build_registry.py**
-
-Add entries for new local directories:
-
-```python
-_LOCAL_DIRS = {
-    "preprint/sources": ("preprint-sources", "tvplotlines"),
-    "preprint/style": ("preprint-style", "tvplotlines"),
-    "decisions": ("decisions", "tvplotlines"),
-    "specs": ("specs", "tvplotlines"),
-    "references": ("references", "tvplotlines"),
-    "experiments/autoresearch": ("autoresearch", "tvplotlines"),
-    "experiments/breakdowns": ("breakdowns", "tvplotlines"),
-    "notes/tvplotlines-app": ("tvplotlines-app-notes", "tvplotlines-app"),
-}
-```
-
-- [ ] **Step 2: Rebuild registry**
-
-```bash
-python scripts/build_registry.py
-```
-
-- [ ] **Step 3: Update CLAUDE.md with new structure**
-
-- [ ] **Step 4: Commit**
-
-```bash
-git add scripts/build_registry.py registry.yaml CLAUDE.md
-git commit -m "Index new knowledge dirs (specs, decisions, references, experiments)"
-```
-
----
-
-### Task 10: Update tvplotlines CLAUDE.md
-
-Remove references to `docs/inventory.md`, `docs/open-source-strategy.md`, `docs/mas4bw-library-audit.md` — they've moved to knowledge.
-
-**Files:**
-- Modify: `tvplotlines/CLAUDE.md`
-
-- [ ] **Step 1: Update file references**
-
-Remove lines referencing moved files. Add pointer to knowledge repo.
-
-- [ ] **Step 2: Commit**
-
-```bash
-git commit -m "Update CLAUDE.md — remove references to moved docs"
-```
-
----
-
-### Task 11: Update todo.md
-
-Mark restructuring tasks complete.
-
-- [ ] **Step 1: Update tasks/todo.md**
-- [ ] **Step 2: Commit**
-
----
-
-## Target structure after restructuring
-
-### tvplotlines/ (public library)
-```
-tvplotlines/
-├── src/tvplotlines/          # library code + prompts
-├── tests/                # unit tests
-├── examples/             # usage examples
-├── docs/                 # user-facing: quickstart, API ref
-│   ├── index.md
-│   ├── quickstart.md
-│   └── api.md
-├── tasks/                # session tracking (gitignored or untracked)
-├── pyproject.toml
-├── README.md
-├── LICENSE
-├── CLAUDE.md
-└── .gitignore
-```
-
-### tvplotlines-app/ (private application)
-```
-tvplotlines-app/
-├── src/plotter_app/      # app code
-├── tests/                # app tests
-├── data/                 # operational data
-│   ├── synopses/         # test input (250+ episodes)
-│   ├── results/          # pipeline output (20 JSON files)
-│   └── scripts/          # utility scripts
-├── docs/superpowers/     # current feature plans
-├── viz/                  # generated visualizations
-├── pyproject.toml
-└── .gitignore
-```
-
-### knowledge/ (private knowledge base)
-```
-knowledge/
-├── preprint/             # paper-writing materials
-│   ├── sources/          # paper notes (brown, kojima, zhang)
-│   ├── style/            # style analyses (russell, dfw, quine)
-│   └── ...               # drafts, bib, style-guide
-├── specs/                # internal specifications
-│   ├── architecture.md   # pipeline internals
-│   ├── inventory.md      # what's ours vs borrowed
-│   ├── open-source-strategy.md
-│   ├── mas4bw-library-audit.md
-│   └── ...
-├── decisions/            # ADRs (001-005)
-├── references/           # book quotes, design docs
-├── experiments/          # autoresearch, breakdowns
-├── notes/                # misc notes
-├── maps/                 # thematic MOCs
-├── templates/            # YAML frontmatter templates
-├── scripts/              # build_registry.py
-├── _sources/             # symlinks to external projects
-├── registry.yaml         # auto-generated index
-├── setup.sh
-└── CLAUDE.md
-```
diff --git a/docs/knowledge/archive/plans/preprint-citations-map.md b/docs/knowledge/archive/plans/preprint-citations-map.md
deleted file mode 100644
index 2205d89..0000000
--- a/docs/knowledge/archive/plans/preprint-citations-map.md
+++ /dev/null
@@ -1,228 +0,0 @@
----
-type: ref
-project: preprint
-status: active
----
-
-# Карта цитат: теоретическая поддержка архитектуры tvplotlines
-
-Справочник: какие цитаты из прочитанных статей поддерживают какие элементы tvplotlines. Для использования при написании препринта.
-
-## Pass 0: franchise type detection
-
-**Что делает:** Определяет тип сериала (procedural / serial / hybrid / ensemble) и переключает стратегию анализа для всех последующих пассов.
-
-**Теоретическое обоснование:** Это cognitive control system — фильтр, который определяет, какие паттерны ожидать и какие инференсы делать.
-
-> "for each (frequently encountered) text type, proficient readers have developed a particular *cognitive control system*, which guides their comprehension efforts. That is, the control system is in charge of regulating the basic operations of text comprehension. It can do this by emphasizing some processes and de-emphasizing others."
-> — Zwaan 1993, p. 2
-
-> "Genre signals trigger the LCCS to set some parameters for truth values in accordance with the conventions for that genre; these parameters then constrain the construction of situation models for texts of that genre."
-> — Zwaan 1993, p. 126
-
-## Pass 1: Story DNA (driver / goal / obstacle / stakes)
-
-**Что делает:** Извлекает для каждой сюжетной линии — кто движет (driver), чего хочет (goal), что мешает (obstacle), что на кону (stakes).
-
-**Теоретическое обоснование:** Story DNA — scaffold для goal-based inference, который переключает LLM с уровня textbase (что произошло) на уровень situation model (зачем персонаж так поступил).
-
-### На goal:
-
-> "Narratives are about people acting in a setting, and the happenings that befall them must be relevant to their intentional states while so engaged — to their beliefs, desires, theories, values, and so on."
-> — Bruner 1991, p. 7
-
-> "the statement of a goal carries considerable weight during text comprehension... a goal statement is an effective foregrounding device"
-> — Zwaan & Radvansky 1998, p. 173
-
-> "comprehenders also rely on inferential processes about human intentions. Just as in other forms of comprehension, inferred intentions provide structural information about action sequences."
-> — Zwaan 2025, p. 291
-
-### На obstacle (canonicity and breach):
-
-> "For to be worth telling, a tale must be about how an implicit canonical script has been breached, violated, or deviated from."
-> — Bruner 1991, p. 11
-
-> "It is Trouble that provides the engine of drama."
-> — Bruner 1991, p. 16
-
-> "Stories are about problems of one sort or another, so it makes sense to link storytelling to a problem solver."
-> — Meehan 1977, p. 96
-
-### На stakes и незавершённые цели:
-
-> "When people are probed for information from a story, failed goal information is more available than completed goal information."
-> — Zwaan & Radvansky 1998, p. 173
-
-### На Story DNA в целом как scaffold для intentionality:
-
-> "the motivational and causal dimensions form the backbone of situations constructed during narrative comprehension... humans read texts to understand *why* things happened."
-> — Zwaan & Radvansky 1998, p. 178
-
-> "Comprehension is an 'effort after meaning.' It is not enough to know that TWA Flight 800 crashed or when or where it crashed. We want to know *why* it crashed."
-> — Graesser et al. 1994, cited in Zwaan & Radvansky 1998, p. 178
-
-## Pass 2: event assignment + functions + interactions
-
-**Что делает:** Для каждого эпизода извлекает события, привязывает к линиям, назначает функции (setup / escalation / turning_point / climax / resolution), определяет interactions между линиями (thematic_rhyme, dramatic_irony, convergence).
-
-**Теоретическое обоснование:** Event functions — это индексирование по каузальности и интенциональности (event-indexing model). Interactions — элементы pragmatic model (авторские стратегии).
-
-### На event functions:
-
-> "the motivational and causal dimensions form the backbone of situations constructed during narrative comprehension"
-> — Zwaan & Radvansky 1998, p. 178
-
-> "the events themselves need to be *constituted* in the light of the overall narrative — in Propp's terms, to be made 'functions' of the story."
-> — Bruner 1991, p. 8
-
-### На interactions (pragmatic model):
-
-> "the situation model is a representation of a state of affairs referred to by the text, whereas the pragmatic model is the model of the situation in which the text is processed"
-> — Zwaan 1993, p. 152
-
-> "in news comprehension the pragmatic model is *retrieved* from LTM, whereas in literary comprehension it has to be *constructed* as the reader goes along"
-> — Zwaan 1993, p. 153
-
-## Multi-pass pipeline (Pass 2 → post-processing → Pass 3)
-
-**Что делает:** Ранние пассы собирают данные по эпизодам (loosely organized), поздние пересматривают целое. Финальная интерпретация откладывается до полной картины.
-
-**Теоретическое обоснование:** Герменевтический круг (части ↔ целое) и indeterminacy hypothesis (откладывание интерпретации).
-
-### Герменевтический круг:
-
-> "we are trying to establish a reading for the whole text, and for this we appeal to readings of its partial expressions; and yet because we are dealing with meaning... the readings of the partial expressions depend on those of others, and ultimately of the whole."
-> — Charles Taylor, cited in Bruner 1991, p. 8
-
-> "In Vladimir Propp's terms, the parts of a narrative serve as 'functions' of the narrative structure as a whole. But that whole cannot be constructed without reference to such appropriate parts."
-> — Bruner 1991, p. 8
-
-### Откладывание интерпретации:
-
-> "Literary comprehension does not lead to a *stronger* textbase representation, but to a more *loosely organized* textbase. A loosely organized textbase contains seemingly irrelevant or contradictory information... the *connections* between these propositions will be *weaker*."
-> — Zwaan 1993, p. 149
-
-> "The indeterminacy hypothesis suggests that readers do not *immediately* commit themselves to one situational representation."
-> — Zwaan 1993, p. 150
-
-## Зачем LLM нужен scaffold (tvplotlines как cognitive control system)
-
-**Что делает:** tvplotlines для LLM — то же, что литературное образование для человека. Не даёт новых данных, а учит задавать правильные вопросы.
-
-### LLM без scaffold — shortcut learning:
-
-> "the performance of such learning systems might rely on spurious correlations in the data, a phenomenon known as *shortcut learning*"
-> — Zwaan 2025, p. 289
-
-### LLM = orrery (отслеживают динамику, не понимают причинность):
-
-> "'Situation models'—that is, the ability of LLMs to track who is doing what in story texts—might be classified as orrery-like models; they track some dynamics but don't represent causal knowledge about the wider world."
-> — Mitchell 2025, Part 1
-
-tvplotlines + Story DNA scaffold поднимает LLM **выше оррери**: заставляет моделировать не только «кто что делает», но и «зачем, что мешает, что на кону».
-
-### LLM без scaffold — simulation без comprehension:
-
-> "erratic behaviors caused by misclassification of what is considered proper behavior, especially when the physical norms of certain locations that are hard to convey in natural language did not percolate to the agents"
-> — Park et al. 2023, p. 18
-
-> "instruction tuning... seemed to guide the behavior of the agents to be more polite and cooperative overall... Despite these ideas not aligning with her own interests and characteristics, she rarely said no"
-> — Park et al. 2023, p. 18
-
-### Comprehension ≠ extraction:
-
-> "the comprehension of a text is more than the rather mechanistic construction of a textbase... the important role that fact relationships play in comprehension is neglected"
-> — Zwaan 1993, p. 28
-
-## Работа с синопсисами (текст о визуальном медиуме)
-
-**Что делает:** tvplotlines анализирует сериал через текстовые синопсисы, а не через сам видеоматериал.
-
-> "situation model construction is an overarching skill despite the fact that the front-end processes... differ widely across media"
-> — Zwaan 2025, p. 291
-
-## ТЗ для tvplotlines (написанное в 1998)
-
-> "several capabilities must be added to 'smarten up' the current class [of models]... such a module would have to (a) represent connections among situational nodes on different dimensions, such as time, space, causation, intentionality, and agency; and (b) capture the construction, foregrounding, updating, integration, and retrieval of situational information"
-> — Zwaan & Radvansky 1998, p. 181
-
-## tvplotlines как distributed intelligence
-
-> "An individual's working intelligence is never 'solo.' It cannot be understood without taking into account his or her reference books, notes, computer programs and data bases, or most important of all, the network of friends, colleagues, or mentors on whom one leans for help and advice."
-> — Bruner 1991, p. 3
-
-## Нарратив как способ мышления (не текстовая форма)
-
-> "The central concern is not how narrative as text is constructed, but rather how it operates as an instrument of mind in the construction of reality."
-> — Bruner 1991, p. 5-6
-
-> "we organize our experience and our memory of human happenings mainly in the form of narrative — stories, excuses, myths, reasons for doing and not doing, and so on."
-> — Bruner 1991, p. 4
-
-> "Narrative 'truth' is judged by its verisimilitude rather than its verifiability."
-> — Bruner 1991, p. 13
-
-## Story DNA scaffold как «правильный вопрос» (Winston)
-
-> Genesis не видит связь между убийством и индивидуализмом — пока её не спросят. Тогда предустановка активируется и связь появляется.
-> — Winston 2014, Figure 13, p. 7
-
-Тот же механизм: LLM «знает» про intentional states, но не активирует это знание без Story DNA scaffold. Scaffold = правильный вопрос.
-
-## Story understanding как ключевое отличие человеческого интеллекта
-
-> "I focus on story understanding, which I believe is the key difference between us and all other primates, living and extinct."
-> — Winston 2014, p. 1
-
-## Genesis как прямой предшественник tvplotlines
-
-> "No language system has the common sense required to understand what it is reading and the implications that flow from common sense understanding."
-> — Winston 2014, p. 1
-
-Genesis (2014) и tvplotlines (2025) делают одно: читают нарратив → строят structured representation → находят паттерны → отвечают на «почему». Genesis — на ручных правилах, 20-100 предложений. tvplotlines — на LLM со scaffold, полные сезоны сериалов.
-
-## Structured representation лучше unstructured (аргумент за Story DNA как JSON)
-
-> "providing agents with structured memory in the form of knowledge graphs... is critical in enabling them to operate in and model these worlds"
-> — Ammanabrolu & Riedl 2021, p. 1
-
-Worldformer показывает: knowledge graph (structured) значительно превосходит текст (unstructured) для world modeling. Аналогично: Story DNA (structured JSON с driver/goal/obstacle/stakes) ценнее, чем свободный текстовый «анализ» от LLM.
-
-## World model для comprehension, не только для action
-
-> "the ability to predict how the world will change in response to one's actions will help you better plan what actions to take"
-> — Ammanabrolu & Riedl 2021, p. 1
-
-Worldformer строит world model для агента (чтобы действовать). tvplotlines строит world model для аналитика (чтобы понимать). Обе задачи требуют structured representation, обе обновляются инкрементально, обе выходят за пределы эксплицитного текста.
-
-## Inference за пределами наблюдаемого (аргумент за Story DNA obstacle/stakes)
-
-> "by inferring that a locked chest is likely to contain treasure before it is actually revealed provides an agent with a form of look-ahead"
-> — Ammanabrolu & Riedl 2021, p. 2
-
-Story DNA obstacle и stakes часто не эксплицитны в синопсисе — LLM их *выводит* (infers), как Worldformer выводит содержимое запертого сундука. Scaffold заставляет делать этот вывод.
-
-## tvplotlines как human-centered AI (обе стороны)
-
-> "human-centered artificial intelligence can be broken down into two critical capacities: (1) understanding humans, and (2) being able to help humans understand the AI systems."
-> — Riedl 2019, p. 3
-
-tvplotlines: сторона 1 — Story DNA scaffold учит LLM моделировать intentional states (enculturation). Сторона 2 — TVPlotlinesResult = structured, interpretable JSON, который человек может проверить и оспорить (transparency).
-
-## AI как инопланетянин (мотивация для enculturation)
-
-> "the way intelligent systems solve problems—especially when using machine learning—is fundamentally *alien* to humans"
-> — Riedl 2019, p. 2
-
-> "our theory of mind breaks down when interacting with intelligent systems, which do not solve problems the way we do"
-> — Riedl 2019, p. 2
-
-## Истории как источник социальных норм
-
-> "Stories and writing can be particularly powerful sources of common knowledge; people write what they know and social and cultural biases and assumptions can come out"
-> — Riedl 2019, p. 4
-
-## Нарратив как содержание странного, не его разрешение
-
-> "Narrative, I believe, is designed to contain uncanniness rather than to resolve it."
-> — Bruner 1991, p. 16
diff --git a/docs/knowledge/archive/plans/preprint-experiment-scaffold.md b/docs/knowledge/archive/plans/preprint-experiment-scaffold.md
deleted file mode 100644
index f4c5bdf..0000000
--- a/docs/knowledge/archive/plans/preprint-experiment-scaffold.md
+++ /dev/null
@@ -1,87 +0,0 @@
----
-type: plan
-project: preprint
-status: active
----
-
-# Эксперимент: Story DNA как когнитивный scaffold
-
-## Гипотеза
-
-Story DNA template (driver / goal / obstacle / stakes) — не просто формат вывода, а **когнитивный scaffold**, который переключает LLM с textbase-уровня (что произошло) на situation model-уровень (зачем персонаж так поступил). Без scaffold LLM сам не выходит на уровень intentional states (Bruner 1991).
-
-## Дизайн
-
-Три условия. Один и тот же вход (синопсисы сезона). Разные промпты.
-
-### Условие A: без scaffold
-
-Промпт: «Перечисли основные сюжетные линии этого сезона. Для каждой укажи название и краткое описание.»
-
-LLM отвечает в свободной форме. Никакой структуры не навязано.
-
-### Условие B: свободный анализ
-
-Промпт: «Проанализируй нарративную структуру этого сезона. Определи сюжетные линии, их взаимосвязи и развитие.»
-
-LLM получает задачу «глубже», но без конкретного scaffold. Проверяет: выйдет ли LLM на уровень intentional states сам, если попросить «анализировать».
-
-### Условие C: со Story DNA scaffold
-
-Промпт: «Для каждой сюжетной линии определи: driver (кто движет), goal (чего хочет), obstacle (что мешает), stakes (что на кону). Классифицируй тип (episodic / serialized / runner), ранг (A / B / C).»
-
-LLM вынужден отвечать на вопросы о намерениях, препятствиях и ценностях — scaffold заставляет перейти на situation model.
-
-## Метрики
-
-### Количественные
-- **Intentional state coverage:** сколько линий содержат эксплицитную информацию о мотивации персонажа (goal/desire/belief)? Считаем вручную или LLM-judge.
-- **Causal depth:** сколько причинно-следственных связей между событиями выявлено?
-- **Character differentiation:** различаются ли персонажи по мотивациям, или описаны как «участники событий»?
-- **Breach detection:** сколько моментов «нарушения ожиданий» (turning points, twists) идентифицировано?
-
-### Качественные (expert evaluation)
-- Насколько результат полезен для development executive / сценариста?
-- Видна ли структура сезона или только пересказ?
-- Есть ли понимание «зачем авторы так построили» (pragmatic model)?
-
-## Данные
-
-Минимум 5 сериалов разных franchise types:
-- 1 procedural (House / Law & Order)
-- 1 serial (Breaking Bad / The Wire)
-- 1 hybrid (X-Files / Buffy)
-- 1 ensemble (Game of Thrones / This Is Us)
-- 1 limited (Chernobyl / The Queen's Gambit)
-
-По одному сезону каждого. Синопсисы берём одинаковые для всех условий.
-
-## Ожидаемый результат
-
-- **A** (без scaffold): список линий-пересказов, мало intentional states, мало causal depth. Textbase-уровень.
-- **B** (свободный анализ): чуть глубже, но хаотично. LLM иногда выходит на intentional states, иногда нет. Нестабильно.
-- **C** (Story DNA scaffold): систематическое покрытие intentional states для каждой линии. Более высокий causal depth. Чёткая дифференциация персонажей по мотивациям.
-
-Разница B→C покажет, что scaffold — не просто формат, а когнитивный инструмент: LLM «знает» про intentional states (они есть в training data), но без явного запроса не активирует это знание. Scaffold — это активация, аналог cognitive control system (Zwaan 1993).
-
-## Теоретическая рамка
-
-| Что тестируем | Теоретический источник |
-|---|---|
-| Story DNA scaffold переключает LLM с textbase на situation model | Kintsch & Van Dijk 1978, Zwaan 1993 |
-| Scaffold заставляет моделировать intentional states | Bruner 1991 (intentional state entailment) |
-| Scaffold работает как cognitive control system | Zwaan 1993 (CCS) |
-| Franchise type detection меняет стратегию анализа | Zwaan 1993 (LCCS / NCCS) |
-| LLM без scaffold не выходит на situation model | Mitchell 2024 (LLMs lack world models), Park et al. 2023 (simulation без comprehension) |
-
-## Distributed intelligence как архитектурный принцип
-
-tvplotlines реализует distributed intelligence (Bruner 1991, Vygotsky): три типа интеллекта в одной системе, каждый со своей функцией.
-
-**Детерминированный код** (pipeline, validators, post-processing) — гарантирует структуру и consistency. JSON schema, rank-span checks, orphan assignment. Не думает — но без него LLM наделает ошибок. Как таблица Менделеева: сама не решает, но без неё химик не работает.
-
-**Промпты со знанием** (Story DNA template, franchise types, event functions) — накопленное нарратологическое знание, зашитое в scaffold. Не генерирует ответы, но задаёт правильные вопросы. Как опытный редактор: не пишет сам, но спрашивает «зачем твой герой так поступил?».
-
-**LLM** (Claude / GPT) — гибкий решатель, способный к inference, но без scaffold остаётся на уровне textbase. Как талантливый стажёр: может увидеть глубоко, но только если правильно направить.
-
-Multi-pass pipeline — распределение задач между тремя типами: LLM генерирует, промпт направляет, код валидирует. Ни один не справится в одиночку. Вместе — вычислительная реализация cognitive control system.
diff --git a/docs/knowledge/archive/plans/publication-plan.md b/docs/knowledge/archive/plans/publication-plan.md
deleted file mode 100644
index e90b15f..0000000
--- a/docs/knowledge/archive/plans/publication-plan.md
+++ /dev/null
@@ -1,97 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# tvplotlines v0.1.0 — план публикации
-
-Дата: 2026-03-25
-
-## 1. Утилита `tvplotlines write-synopses`
-
-### Что делает
-
-CLI-утилита: по названию шоу и номеру сезона ищет информацию в интернете, читает страницы с описаниями эпизодов, и пишет синопсисы по протоколу (`synopsis-authoring-protocol.md`). Сохраняет в файлы.
-
-### Принцип
-
-- CLI-утилита, **не часть библиотечного API**
-- `__init__.py` её не импортирует и не экспортирует
-- Библиотека остаётся чистым вычислением (`get_plotlines()`)
-- Optional dependency: `pip install tvplotlines[writer]` ставит httpx
-- Паттерн httpx: `try/except ImportError` в `cli.py` с сообщением "установите `tvplotlines[writer]`"
-
-### CLI интерфейс
-
-```bash
-pip install tvplotlines[writer]
-tvplotlines write-synopses "House" --season 1 -o synopses/
-# → synopses/S01E01.txt, S01E02.txt, ...
-```
-
-### Файловая структура (новые файлы)
-
-```
-src/tvplotlines/
-├── write_synopses.py        # веб-поиск + LLM-генерация (НОВЫЙ)
-└── prompts_en/
-    └── write_synopses.md    # промпт на основе synopsis-authoring-protocol (НОВЫЙ)
-```
-
-### Изменения в существующих файлах
-
-- `cli.py` — добавить команду `write-synopses` с `try/except ImportError`
-- `pyproject.toml` — добавить `[project.optional-dependencies] writer = ["httpx>=0.27"]`
-
-### Поток работы
-
-1. Ищет в интернете "{show} season {N} episode guide"
-2. Находит страницы с описаниями эпизодов (Wikipedia, IMDb, и др.)
-3. Читает контент страниц
-4. LLM переписывает каждый эпизод по протоколу (300–500 слов, 8–15 beats, покрытие всех линий)
-5. Сохраняет `S01E01.txt`, `S01E02.txt`, ... в output-директорию
-
-## 2. Подготовка к публикации
-
-### 2.1. Новые файлы
-
-- [ ] `CHANGELOG.md` — одна запись `## 0.1.0`, описание что есть в первом релизе
-- [ ] `CONTRIBUTING.md` — краткий гайд: как запустить тесты, стиль кода, как создать PR
-
-### 2.2. Git history и внутренние артефакты
-
-`experiments/`, `program.md`, `results.tsv` — в git history. `.gitignore` не удалит их из истории. Но данные **не чувствительные** (промпты, синопсисы public domain, метрики экспериментов). Никаких ключей или приватных данных.
-
-**Решение: оставить как есть.** `experiments/` — часть research-истории, для open-source это плюс (прозрачность). Если позже захотим чистый старт — orphan branch проще чем filter-repo.
-
-- [ ] `experiments/` — добавить в `.gitignore` (чтобы новые файлы не попадали)
-- [ ] `program.md` — добавить в `.gitignore`
-- [ ] `results.tsv` — уже untracked, убедиться что в `.gitignore`
-- [ ] Проверить что `.env`, `CLAUDE.md` не попадают (уже в `.gitignore`)
-
-### 2.3. GitHub metadata
-
-- [ ] Добавить description: "LLM-powered narrative breakdown for TV series"
-- [ ] Добавить topics: `narrative`, `llm`, `tv-series`, `plotlines`, `narrative-analysis`, `screenwriting`
-- [ ] Сделать репо public (последний шаг)
-
-## 3. Что НЕ делаем сейчас
-
-- PyPI публикация
-- GitHub Actions CI (pytest)
-- `py.typed` маркер
-- Документация на ReadTheDocs
-
-## 4. Порядок выполнения
-
-1. Написать `write_synopses.py` + промпт
-2. Обновить `cli.py` и `pyproject.toml`
-3. Протестировать утилиту
-4. Написать `CHANGELOG.md`
-5. Написать `CONTRIBUTING.md`
-6. Убрать внутренние артефакты из git tracking
-7. Проверить что всё чисто (`git status`, тесты)
-8. Коммит
-9. GitHub metadata (description, topics)
-10. Сделать репо public
diff --git a/docs/knowledge/archive/plans/readme-draft.md b/docs/knowledge/archive/plans/readme-draft.md
deleted file mode 100644
index addbbd7..0000000
--- a/docs/knowledge/archive/plans/readme-draft.md
+++ /dev/null
@@ -1,185 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# tvplotlines
-
-[![PyPI](https://img.shields.io/pypi/v/tvplotlines?cacheSeconds=3600)](https://pypi.org/project/tvplotlines/)
-[![License](openclaw/node_modules/ms/license.md)
-[![Python](https://img.shields.io/pypi/pyversions/tvplotlines?cacheSeconds=3600)](https://pypi.org/project/tvplotlines/)
-
-Turn episode synopses into a writers' room corkboard — story engine, plotlines with their *story DNA* and *arcs* (see definitions in [glossary](src/tvplotlines/prompts_en/glossary.md)) — in one function call.
-
-For TV researchers, screenwriters, and anyone building narrative analysis tools or a tv series.
-
-<p align="center">
-  <a href="https://birdinthetree.github.io/plotter-app/">
-    <img src="docs/images/app-screenshot-1.png" alt="tvplotlines output — plotline×episode grid for Breaking Bad S01">
-  </a>
-  <br>
-  <strong><a href="https://birdinthetree.github.io/plotter-app/">Try the interactive demo →</a></strong>
-</p>
-
-A naive LLM prompt covers 5–12% of a season's source material. tvplotlines covers **78–91%** — by separating *what* the model looks for (narrative theory) from *how* it calculates the results (code).
-
-## Quick start
-
-```bash
-pip install tvplotlines
-export ANTHROPIC_API_KEY=sk-ant-…
-```
-
-Working on your own series? Point it at your synopses — one `.txt` file per episode (see [Input format](#input-format)):
-
-```bash
-tvplotlines run my-series/
-```
-
-Want to analyze an existing show? The optional `writer` extension generates synopses from online sources:
-
-```bash
-pip install 'tvplotlines[writer]'
-tvplotlines write-synopses "Mad Men" --season 1
-tvplotlines run mad-men/
-```
-
-Multiple seasons are supported — plotline continuity is tracked across seasons (see [Python API](#python-api)).
-
-Pre-computed results are in [`examples/results/`](examples/results/) — explore the output without spending API credits.
-
-## What you get
-
-One JSON file per season. Each contains:
-
-- **Cast** — characters with aliases
-- **Plotlines** — with A/B/C ranking, Story DNA (hero, goal, obstacle, stakes), and episode span
-- **Events** — per-episode, assigned to plotlines with narrative function (setup → inciting incident → escalation → crisis → climax → resolution)
-
-<details>
-<summary>Example: Breaking Bad S01 (truncated)</summary>
-
-```json
-{
-  "context": {
-    "format": "serial",
-    "story_engine": "A high school teacher builds a drug empire, testing how far he'll go for family and survival"
-  },
-  "cast": [
-    {"id": "walt", "name": "Walter White", "aliases": ["Walt", "Heisenberg", "Mr. White"]},
-    {"id": "jesse", "name": "Jesse Pinkman", "aliases": ["Jesse"]}
-  ],
-  "plotlines": [
-    {
-      "id": "empire",
-      "name": "Walt: Empire",
-      "hero": "walt",
-      "goal": "build a drug business to secure his family's financial future",
-      "obstacle": "inexperience with criminal world, violent dealers like Tuco, moral boundaries",
-      "stakes": "death, loss of family, imprisonment",
-      "rank": "A",
-      "span": ["S01E01", "S01E02", "...", "S01E07"]
-    }
-  ],
-  "episodes": [
-    {
-      "episode": "S01E01",
-      "theme": "transformation through desperation",
-      "events": [
-        {
-          "event": "During the meth lab raid, Walt spots his former student Jesse escaping through a window",
-          "plotline_id": "empire",
-          "function": "inciting_incident",
-          "characters": ["walt", "jesse"]
-        }
-      ]
-    }
-  ]
-}
-```
-
-</details>
-
-## How it works
-
-### Plotline extraction (`tvplotlines run`)
-
-Five LLM passes, each with a specialized prompt:
-
-| Pass | Role | Output | Calls |
-|------|------|--------|-------|
-| **0** | Context detection | Format (serial/procedural/ensemble), genre, story engine | 1 |
-| **1** | Plotline extraction | Cast + plotlines with Story DNA | 3 (majority vote) |
-| **2** | Event assignment | Events mapped to plotlines with narrative functions | 1 per episode |
-| **3** | Structural review | Verdicts: merge, reassign, create, drop, refunction | 1 |
-| **4** | Arc functions | Season-level arc function for each event (per plotline) | 1 per plotline |
-
-Pass 1 runs 3× in parallel and picks the most common plotline set. Pass 3 sees the full picture no earlier pass had and corrects structural problems. Pass 4 assigns arc-level functions — an event that was a climax in episode 3 might be an escalation in the season-long arc.
-
-### Synopsis generation (`write-synopses`)
-
-The `writer` extension collects raw episode data from online sources, then rewrites each episode into a full synopsis via LLM — ensuring every sentence is a beat (conflict or change), with explicit causality and character names.
-
-Tested with Claude Sonnet (default). OpenAI and Ollama supported for both pipelines. Ollama defaults to Qwen 2.5 14B — chosen to run on CPU without a GPU. Quality is noticeably lower than cloud models but works for experimentation.
-
-## Input format
-
-One `.txt` file per episode. Include `S01E01`, `S01E02`, etc. in the filename. Each file is a plain-text (.txt) synopsis — 150–500 words covering the main events.
-
-```
-breaking-bad/
-├── S01E01.txt
-├── S01E02.txt
-└── S01E07.txt
-```
-
-The folder name becomes the show title. Override with `--show`:
-
-```bash
-tvplotlines run got/ --show "Game of Thrones"
-```
-
-## Python API
-
-```python
-from tvplotlines import get_plotlines
-
-s01 = get_plotlines("Breaking Bad", season=1, episodes=season_1_synopses)
-s02 = get_plotlines("Breaking Bad", season=2, episodes=season_2_synopses, prior=s01)
-```
-
-Pass `prior` to track plotline continuity across seasons.
-
-## LLM providers
-
-```bash
-tvplotlines run breaking-bad/                    # Anthropic (default)
-tvplotlines run breaking-bad/ --provider openai  # OpenAI
-tvplotlines run breaking-bad/ --provider ollama  # Ollama (local, free)
-```
-
-See [docs/api.md](docs/api.md) for full API reference.
-
-## Key concepts
-
-- **Plotline** — a narrative thread across episodes (e.g. "Walt: Empire")
-- **Story DNA** — hero, goal, obstacle, stakes
-- **A/B/C ranking** — plotline weight (A = main, B = secondary, C = tertiary, runner = minor thread)
-- **Format** — procedural (House), serial (Breaking Bad), hybrid (X-Files), ensemble (Game of Thrones)
-- **Story engine** — one sentence capturing the show's core dramatic mechanism
-
-## Citation
-
-```bibtex
-@software{tvplotlines2026,
-  author = {Vashko, N.},
-  title = {tvplotlines: LLM-Driven Plotline Extraction from Episode Synopses},
-  year = {2026},
-  url = {https://github.com/BirdInTheTree/tvplotlines}
-}
-```
-
-## License
-
-MIT
diff --git a/docs/knowledge/archive/plans/resources-migration-plan.md b/docs/knowledge/archive/plans/resources-migration-plan.md
deleted file mode 100644
index 5838ef3..0000000
--- a/docs/knowledge/archive/plans/resources-migration-plan.md
+++ /dev/null
@@ -1,759 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# 3-resources Flat Migration Plan
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Flatten `3-resources/` from 30+ nested folders into a single flat directory with YAML frontmatter, Templater templates, and Dataview navigation.
-
-**Architecture:** Move all files to `3-resources/` root, rename per convention (`project-name.md`), add frontmatter (`type`, `project`, `status`). Templates go to `.obsidian/templates/`. Delete `birdinthetree.github.io_docs/` entirely. Non-markdown files renamed to match convention and kept flat.
-
-**Tech Stack:** Obsidian, Templater plugin, Dataview plugin
-
-**Spec:** `3-resources/plotter_docs/superpowers/specs/2026-03-18-resources-restructure-design.md`
-
----
-
-### Task 1: Safety backup
-
-- [ ] **Step 1: Create timestamped backup of entire 3-resources/**
-
-```bash
-cp -a /Users/nvashko/Projects/3-resources /Users/nvashko/Projects/3-resources-backup-2026-03-18
-```
-
-- [ ] **Step 2: Verify backup**
-
-```bash
-diff <(find /Users/nvashko/Projects/3-resources -type f | wc -l) <(find /Users/nvashko/Projects/3-resources-backup-2026-03-18 -type f | wc -l)
-```
-
-Expected: same file count.
-
----
-
-### Task 2: Create Templater templates and config
-
-**Files:**
-- Create: `.obsidian/templates/_chooser.md`
-- Create: `.obsidian/templates/_tpl-document.md`
-- Create: `.obsidian/templates/_tpl-reading.md`
-- Create: `.obsidian/templates/_tpl-moc.md`
-- Create: `.obsidian/templates/_tpl-blog-post.md`
-- Create: `.obsidian/plugins/templater-obsidian/data.json`
-
-- [ ] **Step 1: Create templates directory**
-
-```bash
-mkdir -p /Users/nvashko/Projects/.obsidian/templates
-```
-
-- [ ] **Step 2: Create dispatcher template `_chooser.md`**
-
-```markdown
-<%*
-const templates = {
-  "Document (spec, plan, decision, note, draft, ref)": "_tpl-document",
-  "Reading (paper notes)": "_tpl-reading",
-  "MOC (Map of Content)": "_tpl-moc",
-  "Blog Post": "_tpl-blog-post"
-};
-const names = Object.keys(templates);
-const chosen = await tp.system.suggester(names, names, true, "Choose template");
-const tplName = templates[chosen];
-const tpl = await app.vault.getAbstractFileByPath(`.obsidian/templates/${tplName}.md`);
-const content = await app.vault.read(tpl);
-// Process Templater syntax in the included template
-const result = await tp.file.include(`[[${tplName}]]`);
-tR += result;
-%>
-```
-
-- [ ] **Step 3: Create `_tpl-document.md`**
-
-```markdown
-<%*
-const types = ["spec", "plan", "decision", "note", "draft", "ref", "concept", "style-analysis"];
-const projects = ["tvplotlines", "preprint", "tvplotlines-app", "zotero-mcp", "awesome-list", "github-io"];
-const type = await tp.system.suggester(types, types, true, "Document type");
-const project = await tp.system.suggester(projects, projects, true, "Project");
--%>
----
-type: <% type %>
-project: <% project %>
-status: active
----
-
-# <% tp.file.title %>
-```
-
-- [ ] **Step 4: Create `_tpl-reading.md`**
-
-```markdown
-<%*
-const projects = ["tvplotlines", "preprint", "tvplotlines-app", "zotero-mcp", "awesome-list", "github-io"];
-const project = await tp.system.suggester(projects, projects, true, "Project");
-const title = await tp.system.prompt("Paper title");
-const authors = await tp.system.prompt("Authors (comma-separated)");
-const year = await tp.system.prompt("Year");
-const tags = await tp.system.prompt("Tags (comma-separated)");
-const authorList = authors.split(",").map(a => a.trim());
-const tagList = tags.split(",").map(t => t.trim());
--%>
----
-type: reading
-title: "<% title %>"
-authors: [<% authorList.join(", ") %>]
-year: <% year %>
-tags: [<% tagList.join(", ") %>]
-project: <% project %>
-status: active
----
-
-# <% tp.file.title %>
-
-**Source:** URL or DOI
-**Category:** empirical | theoretical | method | survey | benchmark
-
-## Claim
-
-What the authors assert (1-2 sentences, in your own words).
-
-<!--
-Principles:
-- Self-contained: reader who never read the paper understands in 30 seconds
-- Your words, not theirs. Direct quotes only for language worth citing verbatim
-- If you can't fill "Relevance" — the paper doesn't belong here
--->
-
-## Method & Evidence
-
-How they support the claim: dataset, experiment design, key metrics,
-main quantitative results. Enough to judge credibility without
-reading the original.
-
-## Limitations
-
-What the authors acknowledge as weak, or what we see as gaps.
-
-## Relevance
-
-What this means for our work. Concrete: which part of the pipeline,
-which argument in the preprint, which design decision it supports
-or challenges.
-```
-
-- [ ] **Step 5: Create `_tpl-moc.md`**
-
-```markdown
-<%*
-const tags = await tp.system.prompt("Tags for Dataview filter (comma-separated)");
-const tagList = tags.split(",").map(t => `"${t.trim()}"`).join(", ");
--%>
----
-type: moc
-tags: [<% tags.split(",").map(t => t.trim()).join(", ") %>]
-status: active
----
-
-# <% tp.file.title %>
-
-```dataview
-TABLE type, file.cday as "Created"
-FROM "3-resources"
-WHERE contains(tags, [<% tagList %>]) AND status = "active"
-SORT file.cday DESC
-```
-```
-
-- [ ] **Step 6: Create `_tpl-blog-post.md`**
-
-```markdown
----
-type: draft
-project: github-io
-status: active
-title: ""
-date: "<% tp.date.now("YYYY-MM-DD") %>"
-description: ""
-series: "What Logic Can Do for Stories"
-tags: []
-sources:
-  - reading_note: ""
-    sections_used: []
----
-
-# <% tp.file.title %>
-
-> One-paragraph hook: the engineering problem. No jargon.
-
-## The problem
-
-What goes wrong without formal structure. 3-5 sentences.
-
-## What the literature offers
-
-2-4 approaches, one paragraph each.
-
-## The bridge: from theory to pipeline
-
-How does this formal method become a prompt, a data model, or an algorithm?
-
-## Takeaway
-
-3-5 bullet points.
-
-## Further reading
-```
-
-- [ ] **Step 7: Write Templater data.json**
-
-Write to `/Users/nvashko/Projects/.obsidian/plugins/templater-obsidian/data.json`:
-
-```json
-{
-  "command_timeout": 5,
-  "templates_folder": ".obsidian/templates",
-  "templates_pairs": [["", ""]],
-  "trigger_on_file_creation": true,
-  "auto_jump_to_cursor": true,
-  "enable_system_commands": false,
-  "shell_path": "",
-  "user_scripts_folder": "",
-  "enable_folder_templates": true,
-  "folder_templates": [
-    {
-      "folder": "3-resources",
-      "template": ".obsidian/templates/_chooser.md"
-    }
-  ],
-  "syntax_highlighting": true,
-  "syntax_highlighting_mobile": false,
-  "enabled_templates_hotkeys": [""],
-  "startup_templates": [""]
-}
-```
-
-- [ ] **Step 8: Verify in Obsidian**
-
-Restart Obsidian (or reload plugins). Create a test file in `3-resources/`. Templater should show the template picker. Delete the test file after verification.
-
----
-
-### Task 3: Delete birdinthetree.github.io_docs/
-
-Before deleting, extract the 7 useful markdown files.
-
-- [ ] **Step 1: Move useful docs to 3-resources/ root with new names**
-
-```bash
-cd /Users/nvashko/Projects/3-resources
-mv birdinthetree.github.io_docs/blog/bio-quotes.md github-io-bio-quotes.md
-mv birdinthetree.github.io_docs/blog/content-plan.md github-io-content-plan.md
-mv birdinthetree.github.io_docs/todo/analytics-visualization-redesign.md github-io-analytics-visualization-redesign.md
-mv birdinthetree.github.io_docs/todo/bugs-github-pages-ui.md github-io-bugs-ui.md
-mv birdinthetree.github.io_docs/todo/design-github-pages.md github-io-design.md
-mv birdinthetree.github.io_docs/todo/episode-number-from-filename.md github-io-episode-number-from-filename.md
-mv birdinthetree.github.io_docs/todo/plan-github-pages.md github-io-plan.md
-```
-
-- [ ] **Step 2: Delete the entire directory**
-
-```bash
-rm -rf /Users/nvashko/Projects/3-resources/birdinthetree.github.io_docs
-```
-
-- [ ] **Step 3: Add frontmatter to moved files**
-
-Each file gets:
-```yaml
----
-type: plan  # or note, depending on content
-project: github-io
-status: active
----
-```
-
----
-
-### Task 4: Flatten awesome list/
-
-- [ ] **Step 1: Move and rename**
-
-```bash
-cd /Users/nvashko/Projects/3-resources
-mv "awesome list/bibliography-event-detection-computational-narratology.md" awesome-list-bibliography-event-detection.md
-mv "awesome list/curation-criteria.md" awesome-list-curation-criteria.md
-mv "awesome list/pianzola-2025-golem-ontology.md" read-pianzola-2025-golem-ontology.md
-```
-
-- [ ] **Step 2: Update/add frontmatter**
-
-`awesome-list-curation-criteria.md`: add `type: note`, `project: awesome-list`, `status: active`
-`awesome-list-bibliography-event-detection.md`: update existing frontmatter, add `status: active`
-`read-pianzola-2025-golem-ontology.md`: update existing frontmatter to `type: reading`, add `status: active`
-
-- [ ] **Step 3: Delete empty directory**
-
-```bash
-rmdir /Users/nvashko/Projects/3-resources/"awesome list"
-```
-
----
-
-### Task 5: Flatten tvplotlines-app_docs/
-
-- [ ] **Step 1: Move and rename**
-
-```bash
-cd /Users/nvashko/Projects/3-resources
-mv tvplotlines-app_docs/specs/tvplotlines-app-context.md tvplotlines-app-context.md
-mv tvplotlines-app_docs/4reddit.md tvplotlines-app-reddit-strategy.md
-mv "tvplotlines-app_docs/Как украсть сериал.md" tvplotlines-app-kak-ukrast-serial.md
-```
-
-- [ ] **Step 2: Add frontmatter to each**
-
-- `tvplotlines-app-context.md`: `type: spec`, `project: tvplotlines-app`, `status: active`
-- `tvplotlines-app-reddit-strategy.md`: `type: plan`, `project: tvplotlines-app`, `status: active`
-- `tvplotlines-app-kak-ukrast-serial.md`: `type: note`, `project: tvplotlines-app`, `status: active`
-
-- [ ] **Step 3: Delete empty directory tree**
-
-```bash
-rm -rf /Users/nvashko/Projects/3-resources/tvplotlines-app_docs
-```
-
----
-
-### Task 6: Flatten zotero-mcp_docs/
-
-- [ ] **Step 1: Move and rename**
-
-```bash
-cd /Users/nvashko/Projects/3-resources
-mv zotero-mcp_docs/plans/2026-03-17-zotero-mcp.md zotero-mcp-plan.md
-mv zotero-mcp_docs/specs/2026-03-17-zotero-mcp-design.md zotero-mcp-design.md
-```
-
-- [ ] **Step 2: Add frontmatter**
-
-- `zotero-mcp-plan.md`: `type: plan`, `project: zotero-mcp`, `status: active`
-- `zotero-mcp-design.md`: `type: spec`, `project: zotero-mcp`, `status: active`
-
-- [ ] **Step 3: Delete empty directory tree**
-
-```bash
-rm -rf /Users/nvashko/Projects/3-resources/zotero-mcp_docs
-```
-
----
-
-### Task 7: Flatten plotter_docs/ — decisions, specs, todo
-
-- [ ] **Step 1: Move decisions**
-
-```bash
-cd /Users/nvashko/Projects/3-resources
-mv plotter_docs/decisions/001-context-before-extraction.md tvplotlines-decision-001-context-before-extraction.md
-mv plotter_docs/decisions/002-no-internal-state.md tvplotlines-decision-002-no-internal-state.md
-mv plotter_docs/decisions/003-abc-classification.md tvplotlines-decision-003-abc-classification.md
-mv plotter_docs/decisions/004-no-language-parameter.md tvplotlines-decision-004-no-language-parameter.md
-mv plotter_docs/decisions/005-pass3-narratologist-review.md tvplotlines-decision-005-pass3-narratologist-review.md
-```
-
-- [ ] **Step 2: Move specs**
-
-```bash
-mv plotter_docs/specs/architecture.md tvplotlines-architecture.md
-mv plotter_docs/specs/inventory.md tvplotlines-inventory.md
-mv plotter_docs/specs/mas4bw-library-audit.md tvplotlines-mas4bw-library-audit.md
-mv plotter_docs/specs/metrics-survey.md tvplotlines-metrics-survey.md
-mv plotter_docs/specs/open-source-strategy.md tvplotlines-open-source-strategy.md
-mv plotter_docs/specs/stability-benchmark.md tvplotlines-stability-benchmark.md
-mv plotter_docs/specs/synopsis-authoring-protocol.md tvplotlines-synopsis-authoring-protocol.md
-```
-
-- [ ] **Step 3: Move todo**
-
-```bash
-mv plotter_docs/todo/autoresearch-v3-hybrid-vs-procedural.md tvplotlines-autoresearch-v3-hybrid-vs-procedural.md
-mv plotter_docs/todo/bibliography-cleanup.md tvplotlines-bibliography-cleanup.md
-mv plotter_docs/todo/career-plan.md tvplotlines-career-plan.md
-mv plotter_docs/todo/event-functions-redesign.md tvplotlines-event-functions-redesign.md
-mv plotter_docs/todo/plan-restructure.md tvplotlines-plan-restructure.md
-mv plotter_docs/todo/tvplotlines-tasks-todo.md tvplotlines-tasks-todo.md
-```
-
-- [ ] **Step 4: Move root-level non-markdown**
-
-```bash
-mv plotter_docs/awesome-shortlist.bib tvplotlines-awesome-shortlist.bib
-```
-
-- [ ] **Step 5: Move superpowers/**
-
-```bash
-mv plotter_docs/superpowers/plans/2026-03-16-preprint-writing.md preprint-writing-plan.md
-mv plotter_docs/superpowers/specs/2026-03-16-preprint-design.md preprint-design-spec.md
-mv plotter_docs/superpowers/specs/2026-03-18-resources-restructure-design.md tvplotlines-resources-restructure-design.md
-```
-
-- [ ] **Step 6: Add frontmatter to all moved files**
-
-All decisions: `type: decision`, `project: tvplotlines`, `status: active`
-All specs: `type: spec`, `project: tvplotlines`, `status: active`
-All todos: `type: plan`, `project: tvplotlines`, `status: active`
-Superpowers plans: `type: plan`, `project: preprint`, `status: active`
-Superpowers specs: `type: spec`, `project: preprint`, `status: active`
-Resources restructure: `type: spec`, `project: tvplotlines`, `status: active`
-
----
-
-### Task 8: Flatten plotter_docs/experiments/
-
-- [ ] **Step 1: Move root experiment files**
-
-```bash
-cd /Users/nvashko/Projects/3-resources
-mv plotter_docs/experiments/autoresearch-v3-brainstorm-notes.md tvplotlines-autoresearch-v3-brainstorm-notes.md
-mv plotter_docs/experiments/autoresearch-v3-event-functions.md tvplotlines-autoresearch-v3-event-functions.md
-mv plotter_docs/experiments/autoresearch-v3-reading-plan.md tvplotlines-autoresearch-v3-reading-plan.md
-mv plotter_docs/experiments/bibliography-narrative-and-autoresearch.md tvplotlines-bibliography-narrative-and-autoresearch.md
-mv plotter_docs/experiments/naive-vs-tvplotlines.md tvplotlines-naive-vs-tvplotlines.md
-mv plotter_docs/experiments/notes-liu-2026-narrative-survey.md read-liu-2026-narrative-survey.md
-mv plotter_docs/experiments/notes-tian-2024-turning-points.md read-tian-2024-turning-points.md
-mv plotter_docs/experiments/run_bb_all_seasons.py tvplotlines-run-bb-all-seasons.py
-```
-
-- [ ] **Step 2: Move autoresearch/ subdirectory**
-
-```bash
-mv plotter_docs/experiments/autoresearch/experiment-log.md tvplotlines-autoresearch-experiment-log.md
-mv plotter_docs/experiments/autoresearch/program-v2.md tvplotlines-autoresearch-program-v2.md
-mv plotter_docs/experiments/autoresearch/program.md tvplotlines-autoresearch-program.md
-mv plotter_docs/experiments/autoresearch/prompt-experiment-ideas.md tvplotlines-autoresearch-prompt-experiment-ideas.md
-mv plotter_docs/experiments/autoresearch/run-v2.md tvplotlines-autoresearch-run-v2.md
-mv plotter_docs/experiments/autoresearch/summary-v2.md tvplotlines-autoresearch-summary-v2.md
-mv plotter_docs/experiments/autoresearch/results-v2.tsv tvplotlines-autoresearch-results-v2.tsv
-mv plotter_docs/experiments/autoresearch/results.tsv tvplotlines-autoresearch-results.tsv
-```
-
-- [ ] **Step 3: Move bb_results/ (JSON)**
-
-```bash
-mv plotter_docs/experiments/bb_results/bb_s01_result.json tvplotlines-bb-s01-result.json
-mv plotter_docs/experiments/bb_results/bb_s02_result.json tvplotlines-bb-s02-result.json
-mv plotter_docs/experiments/bb_results/bb_s03_result.json tvplotlines-bb-s03-result.json
-mv plotter_docs/experiments/bb_results/bb_s04_result.json tvplotlines-bb-s04-result.json
-mv plotter_docs/experiments/bb_results/bb_s05_result.json tvplotlines-bb-s05-result.json
-```
-
-- [ ] **Step 4: Move breakdowns/**
-
-```bash
-mv plotter_docs/experiments/breakdowns/GDR_S01_breakdown.md tvplotlines-breakdown-gdr-s01.md
-mv plotter_docs/experiments/breakdowns/SP_S01_breakdown.md tvplotlines-breakdown-sp-s01.md
-mv plotter_docs/experiments/breakdowns/TD_S01_breakdown.md tvplotlines-breakdown-td-s01.md
-```
-
-- [ ] **Step 5: Move reading-notes/**
-
-```bash
-mv plotter_docs/experiments/reading-notes/autoresearch-v3-questions.md tvplotlines-autoresearch-v3-questions.md
-mv plotter_docs/experiments/reading-notes/blueprint-first-qiu-2025.md read-qiu-2025-blueprint-first.md
-mv plotter_docs/experiments/reading-notes/cot-wei-2022.md read-wei-2022-cot.md
-mv plotter_docs/experiments/reading-notes/got-besta-2024.md read-besta-2024-got.md
-mv plotter_docs/experiments/reading-notes/tot-yao-2023.md read-yao-2023-tot.md
-```
-
-- [ ] **Step 6: Add frontmatter**
-
-Experiment files: `type: note`, `project: tvplotlines`, `status: active`
-Reading notes (read-*): `type: reading`, `project: tvplotlines`, `status: active`
-Breakdowns: `type: note`, `project: tvplotlines`, `status: active`
-
----
-
-### Task 9: Flatten plotter_docs/preprint/
-
-- [ ] **Step 1: Move preprint root files**
-
-```bash
-cd /Users/nvashko/Projects/3-resources
-mv plotter_docs/preprint/autoresearcher-competence-idea.md preprint-autoresearcher-competence-idea.md
-mv plotter_docs/preprint/blog-post-guide.md preprint-blog-post-guide.md
-mv plotter_docs/preprint/draft-fragments.md preprint-draft-fragments.md
-mv plotter_docs/preprint/drafts.md preprint-drafts.md
-mv plotter_docs/preprint/event-detection-sources.md preprint-event-detection-sources.md
-mv plotter_docs/preprint/notes.md preprint-notes.md
-mv plotter_docs/preprint/paper-summary-guide.md preprint-paper-summary-guide.md
-mv plotter_docs/preprint/positioning-strategy.md preprint-positioning-strategy.md
-mv plotter_docs/preprint/reference-list.md preprint-reference-list.md
-mv plotter_docs/preprint/writing-rules.md preprint-writing-rules.md
-mv plotter_docs/preprint/eastern-narratives.bib preprint-eastern-narratives.bib
-mv plotter_docs/preprint/style-guide.mmd preprint-style-guide.mmd
-```
-
-- [ ] **Step 2: Move paper/ subdirectory**
-
-```bash
-mv plotter_docs/preprint/paper/00-abstract.md preprint-abstract.md
-mv plotter_docs/preprint/paper/03-method.md preprint-method.md
-mv plotter_docs/preprint/paper/evaluation-event-functions.md preprint-evaluation-event-functions.md
-mv "plotter_docs/preprint/paper/glossary 1.md" preprint-glossary-old.md
-mv plotter_docs/preprint/paper/glossary-antipatterns.md preprint-glossary-antipatterns.md
-mv plotter_docs/preprint/paper/glossary.md preprint-glossary.md
-mv "plotter_docs/preprint/paper/kinda draft.md" preprint-kinda-draft.md
-mv plotter_docs/preprint/paper/related-work-citations.md preprint-related-work-citations.md
-mv plotter_docs/preprint/paper/wittgenstein-chomsky-conditions-ru.md preprint-wittgenstein-chomsky-conditions-ru.md
-mv plotter_docs/preprint/paper/wittgenstein-logic-as-conditions.md preprint-wittgenstein-logic-as-conditions.md
-```
-
-- [ ] **Step 3: Move sources/ (paper summaries → readings)**
-
-```bash
-mv plotter_docs/preprint/sources/brown-2020-gpt3.md read-brown-2020-gpt3.md
-mv plotter_docs/preprint/sources/freytag-1863-dramatic-structure.md read-freytag-1863-dramatic-structure.md
-mv plotter_docs/preprint/sources/genette-1980-narrative-discourse.md read-genette-1980-narrative-discourse.md
-mv plotter_docs/preprint/sources/index.md preprint-sources-index.md
-mv plotter_docs/preprint/sources/jang-2021-just-ask-generalization.md read-jang-2021-just-ask-generalization.md
-mv plotter_docs/preprint/sources/karpathy-2023-english-programming.md read-karpathy-2023-english-programming.md
-mv plotter_docs/preprint/sources/karpathy-2026-autoresearch.md read-karpathy-2026-autoresearch.md
-mv plotter_docs/preprint/sources/kojima-2022-zero-shot-cot.md read-kojima-2022-zero-shot-cot.md
-mv plotter_docs/preprint/sources/ramnath-2025-apo-survey.md read-ramnath-2025-apo-survey.md
-mv plotter_docs/preprint/sources/wei-2022-chain-of-thought.md read-wei-2022-chain-of-thought.md
-mv plotter_docs/preprint/sources/zhang-2025-seriesbench.md read-zhang-2025-seriesbench.md
-mv plotter_docs/preprint/sources/zhou-2022-least-to-most.md read-zhou-2022-least-to-most.md
-```
-
-Note: `TEMPLATE for paper summary.md` — already covered by `_tpl-reading.md`, delete it.
-
-- [ ] **Step 4: Move style/ subdirectory**
-
-```bash
-mv "plotter_docs/preprint/style/scientists for style.md" preprint-scientists-for-style.md
-mv plotter_docs/preprint/style/style-notes-dfw.md preprint-style-notes-dfw.md
-mv plotter_docs/preprint/style/style-notes-kaplan-scaling.md preprint-style-notes-kaplan-scaling.md
-mv plotter_docs/preprint/style/style-notes-quine.md preprint-style-notes-quine.md
-mv plotter_docs/preprint/style/style-notes-russell.md preprint-style-notes-russell.md
-mv plotter_docs/preprint/style/style-notes-sparks-of-agi.md preprint-style-notes-sparks-of-agi.md
-mv plotter_docs/preprint/style/style-notes-sutton-bitter-lesson.md preprint-style-notes-sutton-bitter-lesson.md
-mv plotter_docs/preprint/style/style-phrases-dfw.md preprint-style-phrases-dfw.md
-mv plotter_docs/preprint/style/style-phrases-kaplan-scaling.md preprint-style-phrases-kaplan-scaling.md
-mv plotter_docs/preprint/style/style-phrases-quine.md preprint-style-phrases-quine.md
-mv plotter_docs/preprint/style/style-phrases-russell.md preprint-style-phrases-russell.md
-mv plotter_docs/preprint/style/style-phrases-sparks-of-agi.md preprint-style-phrases-sparks-of-agi.md
-```
-
-- [ ] **Step 5: Add frontmatter**
-
-Preprint docs: `type: draft` or `type: note` or `type: ref`, `project: preprint`, `status: active`
-Paper summaries (read-*): `type: reading`, `project: preprint`, `status: active`
-Style notes: `type: style-analysis`, `project: preprint`, `status: active`
-
-- [ ] **Step 6: Delete TEMPLATE for paper summary.md**
-
-```bash
-rm "plotter_docs/preprint/sources/TEMPLATE for paper summary.md"
-```
-
----
-
-### Task 10: Flatten knowledge/
-
-- [ ] **Step 1: Move maps/ → moc-* files**
-
-```bash
-cd /Users/nvashko/Projects/3-resources
-mv knowledge/maps/bibliography.md moc-bibliography.md
-mv knowledge/maps/llm-prompting.md moc-llm-prompting.md
-mv knowledge/maps/narrative-theory.md moc-narrative-theory.md
-mv knowledge/maps/tvplotlines-research.md moc-tvplotlines-research.md
-mv knowledge/maps/screenwriting-craft.md moc-screenwriting-craft.md
-mv knowledge/maps/writing-style.md moc-writing-style.md
-```
-
-- [ ] **Step 2: Move references/**
-
-```bash
-mv knowledge/references/01_extract_quotes.md knowledge-extract-quotes.md
-mv knowledge/references/2026-03-09-plotlines-knowledge-base-design.md knowledge-plotlines-kb-design.md
-mv knowledge/references/book-outlines.md knowledge-book-outlines.md
-mv knowledge/references/books2series-onepage.md knowledge-books2series-onepage.md
-mv knowledge/references/taxonomy-approach.md knowledge-taxonomy-approach.md
-mv "knowledge/references/Что делает Discourse для сериала.md" knowledge-discourse-for-serials.md
-mv knowledge/references/structure_sketch.yaml knowledge-structure-sketch.yaml
-```
-
-- [ ] **Step 3: Move plotlines-quotes/ JSON files**
-
-```bash
-mv knowledge/references/plotlines-quotes/douglas_writing_tv_drama.json knowledge-quotes-douglas.json
-mv knowledge/references/plotlines-quotes/landau_tv_showrunners.json knowledge-quotes-landau.json
-mv knowledge/references/plotlines-quotes/nash_savethecat_tv.json knowledge-quotes-nash.json
-mv knowledge/references/plotlines-quotes/pena_developing_series.json knowledge-quotes-pena.json
-mv knowledge/references/plotlines-quotes/venis_inside_the_room.json knowledge-quotes-venis.json
-```
-
-- [ ] **Step 4: Move prompting files**
-
-```bash
-mv "knowledge/propmpting/Boris Cherny pipeline.md" knowledge-boris-cherny-pipeline.md
-mv knowledge/propmpting/claude_pipline_prompt.md knowledge-claude-pipeline-prompt.md
-mv "knowledge/propmpting/xml tags.md" knowledge-xml-tags.md
-mv knowledge/propmpting/claude_best_practices.jpg knowledge-claude-best-practices.jpg
-mv knowledge/propmpting/claude_pipline_prompt.jpg knowledge-claude-pipeline-prompt.jpg
-```
-
-- [ ] **Step 5: Move books4style/ PDFs**
-
-```bash
-mv "knowledge/propmpting/books4style/A Supposedly Fun Thing Ill Never Do Again .pdf" "knowledge-pdf-dfw-supposedly-fun-thing.pdf"
-mv "knowledge/propmpting/books4style/Both Flesh and Not Essays.pdf" "knowledge-pdf-dfw-both-flesh-and-not.pdf"
-mv "knowledge/propmpting/books4style/Consider the Lobster And Other Essays (David Foster Wallace) .pdf" "knowledge-pdf-dfw-consider-the-lobster.pdf"
-mv "knowledge/propmpting/books4style/Fate, Time, and Language An Essay on Free Will ).pdf" "knowledge-pdf-dfw-fate-time-language.pdf"
-mv "knowledge/propmpting/books4style/From a Logical Point of View (Willard Van Orman Quine.pdf" "knowledge-pdf-quine-from-a-logical-point.pdf"
-mv "knowledge/propmpting/books4style/HDYVd4IaMAgWp2p.jpg" "knowledge-img-books4style.jpg"
-mv "knowledge/propmpting/books4style/Ontological relativity and other essays WVOQ.pdf" "knowledge-pdf-quine-ontological-relativity.pdf"
-mv "knowledge/propmpting/books4style/Russell(1905).pdf" "knowledge-pdf-russell-1905.pdf"
-mv "knowledge/propmpting/books4style/The Bitter Lesson.pdf" "knowledge-pdf-sutton-bitter-lesson.pdf"
-mv "knowledge/propmpting/books4style/The roots of reference the Paul Carus lectures (Quine, W. V) .pdf" "knowledge-pdf-quine-roots-of-reference.pdf"
-mv "knowledge/propmpting/books4style/Word and Object (Willard Van Orman Quine) .pdf" "knowledge-pdf-quine-word-and-object.pdf"
-```
-
-- [ ] **Step 6: Move remaining root files**
-
-```bash
-mv knowledge/program.md knowledge-autoresearch-program.md
-```
-
-- [ ] **Step 7: Delete obsolete infrastructure**
-
-These are replaced by Dataview + flat structure:
-
-```bash
-rm knowledge/registry.yaml
-rm knowledge/setup.sh
-rm knowledge/scripts/build_registry.py
-rm knowledge/CLAUDE.md
-rm knowledge/README.md
-rm knowledge/.gitignore
-```
-
-- [ ] **Step 8: Delete old template files**
-
-```bash
-rm knowledge/templates/concept.md
-rm knowledge/templates/style-analysis.md
-```
-
-- [ ] **Step 9: Add frontmatter to moved markdown files**
-
-MOC files: update existing frontmatter, add `status: active`
-Reference files: `type: ref`, `project: tvplotlines`, `status: active`
-Prompting files: `type: ref`, `project: tvplotlines`, `status: active`
-
-- [ ] **Step 10: Delete empty knowledge/ directory tree**
-
-```bash
-rm -rf /Users/nvashko/Projects/3-resources/knowledge
-```
-
----
-
-### Task 11: Clean up plotter_docs/
-
-After tasks 7-9, all content has been moved out.
-
-- [ ] **Step 1: Verify nothing remains**
-
-```bash
-find /Users/nvashko/Projects/3-resources/plotter_docs -type f
-```
-
-Expected: no files (or only .DS_Store).
-
-- [ ] **Step 2: Delete empty directory tree**
-
-```bash
-rm -rf /Users/nvashko/Projects/3-resources/plotter_docs
-```
-
----
-
-### Task 12: Add frontmatter to remaining files
-
-Files already in root that need frontmatter updates.
-
-- [ ] **Step 1: Update lessons.md**
-
-No frontmatter needed — this is a special file.
-
-- [ ] **Step 2: Handle screenshot**
-
-```bash
-mv "Screenshot 2026-03-16 at 22.57.02.png" tvplotlines-screenshot-2026-03-16.png
-```
-
----
-
-### Task 13: Fix wikilinks
-
-- [ ] **Step 1: Find all wikilinks in migrated files**
-
-```bash
-grep -r '\[\[' /Users/nvashko/Projects/3-resources/*.md | grep -v node_modules
-```
-
-- [ ] **Step 2: Update each wikilink to match new filenames**
-
-Build old→new mapping from the mv commands above and do find-replace.
-
-- [ ] **Step 3: Verify no broken links**
-
-Use Obsidian's "Show broken links" or grep for `[[` and verify each target exists.
-
----
-
-### Task 14: Final verification
-
-- [ ] **Step 1: Count files**
-
-```bash
-ls /Users/nvashko/Projects/3-resources/ | wc -l
-```
-
-Expected: ~140-160 files (no subdirectories except possibly empty ones).
-
-- [ ] **Step 2: Verify no subdirectories remain**
-
-```bash
-find /Users/nvashko/Projects/3-resources -type d -mindepth 1
-```
-
-Expected: no output.
-
-- [ ] **Step 3: Verify all markdown files have frontmatter**
-
-```bash
-for f in /Users/nvashko/Projects/3-resources/*.md; do
-  head -1 "$f" | grep -q '^---' || echo "MISSING: $f"
-done
-```
-
-Expected: only `lessons.md` and `README.md` reported.
-
-- [ ] **Step 4: Test Dataview queries in Obsidian**
-
-Open a MOC file and verify the Dataview query renders correctly.
-
-- [ ] **Step 5: Delete backup once satisfied**
-
-```bash
-rm -rf /Users/nvashko/Projects/3-resources-backup-2026-03-18
-```
diff --git a/docs/knowledge/archive/plans/resources-restructure-design.md b/docs/knowledge/archive/plans/resources-restructure-design.md
deleted file mode 100644
index 0e0c7be..0000000
--- a/docs/knowledge/archive/plans/resources-restructure-design.md
+++ /dev/null
@@ -1,188 +0,0 @@
----
-type: spec
-project: tvplotlines
-status: active
----
-
-# Design: 3-resources Flat Structure
-
-## Problem
-
-111 files in 30+ folders, up to 5 levels deep. Can't find anything.
-Templates scattered across 4 locations. No consistent frontmatter.
-Folder-based organization creates ever-growing nesting that doesn't
-match how the user actually navigates (sort by date, recall by name).
-
-## Solution
-
-One flat folder. No subfolders. YAML frontmatter for metadata.
-Dataview for navigation. Templater for consistent file creation.
-
-## Structure
-
-```
-3-resources/
-├── _tpl-document.md          ← template: universal work document
-├── _tpl-reading.md           ← template: paper notes (includes guide)
-├── _tpl-moc.md               ← template: map of content with Dataview
-├── _tpl-blog-post.md         ← template: blog post
-├── lessons.md                ← global lessons (no frontmatter change)
-├── tvplotlines-architecture.md
-├── tvplotlines-career-plan.md
-├── preprint-abstract.md
-├── read-wei-2022-chain-of-thought.md
-├── moc-narrative-theory.md
-└── ...
-```
-
-## Naming Convention
-
-**Work documents:** `project-descriptive-name.md`
-- `tvplotlines-architecture.md`
-- `preprint-positioning-strategy.md`
-- `zotero-mcp-plan.md`
-- `awesome-list-curation-criteria.md`
-- `github-io-blog-guide.md`
-
-**Readings:** `read-author-year-topic.md`
-- `read-wei-2022-chain-of-thought.md`
-- `read-tian-2024-turning-points.md`
-- `read-pianzola-2025-golem-ontology.md`
-
-**MOC:** `moc-topic.md`
-- `moc-narrative-theory.md`
-- `moc-tvplotlines-research.md`
-
-**Templates:** `_tpl-name.md`
-- `_tpl-document.md`
-- `_tpl-reading.md`
-- `_tpl-moc.md`
-- `_tpl-blog-post.md`
-
-## Frontmatter
-
-### Work documents
-
-```yaml
----
-type: spec | plan | decision | note | draft | ref | concept | style-analysis
-project: tvplotlines | preprint | tvplotlines-app | zotero-mcp | awesome-list | github-io
-status: active | archived
----
-```
-
-### Readings
-
-```yaml
----
-type: reading
-title: "Full Paper Title"
-authors: [Last1, Last2, Last3]
-year: 2022
-tags: [topic1, topic2]
-project: tvplotlines
-status: active
----
-```
-
-### MOC
-
-```yaml
----
-type: moc
-tags: [topic1, topic2]
-status: active
----
-```
-
-## Allowed Values
-
-### type
-`spec` | `plan` | `decision` | `note` | `draft` | `ref` | `concept` | `style-analysis` | `moc` | `reading`
-
-### project
-`tvplotlines` | `preprint` | `tvplotlines-app` | `zotero-mcp` | `awesome-list` | `github-io`
-
-New projects added to this list as needed.
-
-### status
-`active` | `archived`
-
-## Templates (4)
-
-### _tpl-document.md
-Universal template for all work documents. Templater prompts for
-`type` and `project` from allowed values lists.
-
-### _tpl-reading.md
-Paper notes template. Extended frontmatter (title, authors, year, tags).
-Body structure: Claim, Method & Evidence, Limitations, Relevance.
-Key principles from paper-summary-guide.md baked in as inline hints:
-- Self-contained (reader who never read the paper understands in 30s)
-- Own words, not theirs
-- Relevance section mandatory
-
-### _tpl-moc.md
-Map of Content. Frontmatter + pre-built Dataview query filtered by tags.
-
-### _tpl-blog-post.md
-Blog post template with hook, problem, literature, bridge, takeaway structure.
-
-## Templater Configuration
-
-- Template folder: `3-resources/` (filter by `_tpl-` prefix)
-- "Trigger Templater on new file creation": enabled for `3-resources/`
-- On new file: prompt user to pick template from list
-
-## Archival
-
-No `_archive/` folder. Set `status: archived` in frontmatter.
-Dataview queries filter by `status = "active"` by default.
-
-## Navigation
-
-Dataview queries replace manual MOC maintenance. Examples:
-
-All active tvplotlines documents:
-```
-TABLE type, file.cday as "Created"
-FROM "3-resources"
-WHERE project = "tvplotlines" AND status = "active"
-SORT file.cday DESC
-```
-
-All readings:
-```
-TABLE title, authors, year, project
-FROM "3-resources"
-WHERE type = "reading" AND status = "active"
-SORT year DESC
-```
-
-All plans across projects:
-```
-LIST
-FROM "3-resources"
-WHERE type = "plan" AND status = "active"
-SORT file.cday DESC
-```
-
-## CLAUDE.md Update
-
-Add to `/Users/nvashko/Projects/3-resources/CLAUDE.md`:
-- Naming convention rules
-- Allowed type/project values
-- Frontmatter requirement
-- "No subfolders" rule
-- Template list
-
-## Migration
-
-1. Create 4 templates in `3-resources/`
-2. Configure Templater in `.obsidian/plugins/templater-obsidian/data.json`
-3. Move all files from subfolders to `3-resources/` root, renaming per convention
-4. Add frontmatter to files that lack it
-5. Update wikilinks if any exist
-6. Delete empty subfolders
-7. Update CLAUDE.md
-8. Verify Dataview queries work
diff --git a/docs/knowledge/archive/plans/stability-benchmark.md b/docs/knowledge/archive/plans/stability-benchmark.md
deleted file mode 100644
index d5d2ba7..0000000
--- a/docs/knowledge/archive/plans/stability-benchmark.md
+++ /dev/null
@@ -1,116 +0,0 @@
----
-type: spec
-project: tvplotlines
-status: active
----
-
-# Stability Benchmark Specification
-
-## Goal
-
-Demonstrate that tvplotlines's pipeline produces stable, reproducible storyline analyses. The key claim for the preprint: "a single run is representative of what the pipeline would produce on repeated execution."
-
-## Why this matters
-
-LLM outputs are non-deterministic (temperature=0 reduces but doesn't eliminate variance). If storyline assignments shift dramatically between runs, the tool's analysis is unreliable. We need to quantify the variance.
-
-## Metric: Adjusted Rand Index (ARI)
-
-ARI compares two clusterings without requiring label alignment — ideal for storyline analysis where storyline IDs may differ between runs, but the groupings should be consistent.
-
-- **Input:** For each run, build a vector of (episode, character) → storyline assignments.
-- **Comparison:** ARI between all pairs of runs.
-- **Scale:** ARI=1.0 identical, ARI=0.0 random, ARI<0 worse than random.
-
-Implementation: `tvplotlines.metrics.compute_consistency_ari()` — already exists in the library.
-
-## Success criteria
-
-| Metric | Threshold | Meaning |
-|--------|-----------|---------|
-| Mean ARI per show | ≥ 0.70 | Good reproducibility |
-| Min ARI per show | ≥ 0.50 | No catastrophic divergence |
-| Mean coverage per show | ≥ 0.90 | ≤10% unassigned events |
-
-### If criteria are not met
-
-- **ARI < 0.50:** Investigate. Likely cause: Pass 1 voting produces different storyline sets across runs. Fix: increase voting rounds or add structural constraints.
-- **ARI 0.50–0.70:** Acceptable with caveat in preprint. Document which storylines diverge — likely low-confidence (inferred) lines.
-- **Coverage < 0.90:** Investigate orphan assignment. May need stronger Pass 2 prompts.
-
-## Benchmark set
-
-5 shows chosen for franchise type diversity and episode count range:
-
-| Show | Code | Episodes | Franchise type | Rationale |
-|------|------|----------|---------------|-----------|
-| True Detective S01 | TD | 8 | serial | Small, clean serial narrative |
-| Breaking Bad S01 | BB | 7 | serial | Classic, complex character arcs |
-| House S01 | HOUSE | 22 | procedural | Long, case-of-week + serialized B/C |
-| Game of Thrones S01 | GOT | 10 | ensemble | Many equal storylines |
-| This Is Us S01 | TIU | 18 | hybrid | Episodic + throughline mix |
-
-Total: 65 episodes across 5 runs = 325 Pass 2 calls + 25 Pass 1 + 25 Pass 0 + 25 Pass 3.
-
-## Cost estimate
-
-- Pass 2 (dominant cost): ~$0.013/episode (Sonnet, cached system prompt)
-- 325 episodes × $0.013 = ~$4.23
-- Batch mode (50% discount): ~$2.12
-- Passes 0/1/3 overhead: ~$1.00
-- **Total estimate: $3–5 in batch mode**
-
-## Protocol
-
-1. For each show, run pipeline 5 times with identical input.
-2. Save each run's TVPlotlinesResult as JSON.
-3. Compute pairwise ARI across all 5 runs (10 pairs per show).
-4. Compute coverage per run.
-5. Report: mean ARI, min ARI, coverage range, storyline count range.
-
-## Results (2026-03-15)
-
-Two full runs of 5 shows × 5 runs each + 1 run of SP × 5. Total: ~55 pipeline executions.
-
-### Run 1 (before unassigned validation fix)
-
-| Show | Mean ARI | Min ARI | Coverage | Storylines | Pass? |
-|------|----------|---------|----------|------------|-------|
-| TD | 0.884 | 0.715 | 1.000 | 4-5 | PASS |
-| BB | 0.682 | 0.508 | 1.000 | 4-5 | **FAIL** |
-| HOUSE | 1.000 | 1.000 | 1.000 | 10 | PASS |
-| GOT | 0.904 | 0.820 | 0.992 | 7-8 | PASS |
-| TIU | 0.866 | 0.849 | 1.000 | 6-10 | PASS |
-
-### Run 2 (after removing unassigned events validation from Pass 2)
-
-| Show | Mean ARI | Min ARI | Coverage | Storylines | Pass? |
-|------|----------|---------|----------|------------|-------|
-| TD | 0.884 | 0.810 | 1.000 | 4 | PASS |
-| BB | 0.767 | 0.666 | 1.000 | 4-6 | PASS |
-| HOUSE | 0.917 | 0.859 | 1.000 | 9-11 | PASS |
-| GOT | 0.940 | 0.893 | 1.000 | 8-9 | PASS |
-| TIU | 0.899 | 0.856 | 0.999 | 6-8 | PASS |
-
-### SP (separate run, Russian language)
-
-| Show | Mean ARI | Min ARI | Coverage | Storylines | Pass? |
-|------|----------|---------|----------|------------|-------|
-| SP | 0.920 | 0.898 | 0.998 | 6-7 | PASS |
-
-### Analysis
-
-**Coverage:** Near-perfect (0.992–1.000) across all shows. The `assign_orphan_events()` postprocessing effectively handles unassigned events.
-
-**Consistency by franchise type:**
-- **Procedural (HOUSE):** Highest — distinct storylines per character, clear A/B/C hierarchy. ARI 0.917–1.000.
-- **Serial (TD, SP):** High — clear narrative threads. ARI 0.884–0.920.
-- **Ensemble (GOT):** High — many characters with distinct goals. ARI 0.904–0.940.
-- **Hybrid (TIU):** High — mix of episodic and serial. ARI 0.866–0.899.
-- **Serial with intertwined drivers (BB):** Lowest — one character (Walt) drives multiple storylines with ambiguous boundaries. ARI 0.682–0.767.
-
-**BB instability:** Storyline count is stable (4-6), so Pass 1 voting works. The variance is in Pass 2 event assignment: "Walt lies to Skyler" could be empire (hiding the business) or family (protecting the family). This is genuinely ambiguous, not a pipeline bug.
-
-**Comparison to baseline:** autoresearch v1 baseline on SP was ARI 0.595. Current result: 0.920. Improvement from voting in Pass 1, autoresearch prompt optimization (49 experiments), and code audit fixes.
-
-**Actual cost:** ~$0.20–0.50 per run (batch mode, Sonnet with caching). Full benchmark (55 runs): ~$15–20 total.
diff --git a/docs/knowledge/archive/plans/synthetic-audience-testing.md b/docs/knowledge/archive/plans/synthetic-audience-testing.md
deleted file mode 100644
index 7562da6..0000000
--- a/docs/knowledge/archive/plans/synthetic-audience-testing.md
+++ /dev/null
@@ -1,37 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# Synthetic Audience Testing — тестирование контента на симулированной аудитории
-
-## Идея
-
-Продукт для креаторов/блогеров: загружаешь контент (пост, видео, pitch) → AI-сгенерированные персоны зрителей оценивают его → получаешь обратную связь до публикации.
-
-## Откуда взялось
-
-- **Moloch's Bargain** (Stanford, 2026): эксперимент показал, что 20 GPT-4o mini персон (каждая с характером киноперсонажа) реалистично оценивают engagement. Модель, дообученная на их фидбэке, побеждала в 57.5% случаев.
-- **Largo AI**: купили компанию, симулирующую зрительскую реакцию на фильмы. Но это для студий с бюджетами, не для креаторов.
-
-## Концепция продукта
-
-- **Подписка**: в базовую входит набор персон (5-10 типов аудитории)
-- **Докупаешь**: больше персон, кастомные персоны ("мой зритель — женщина 35+, интересуется...")
-- **Тестируешь**: загрузил контент → получил реакции, комментарии, оценки от синтетических зрителей
-- **Итерируешь**: переделал → тестируешь снова
-
-## Почему реализуемо сейчас
-
-- GPT-4o mini / Qwen — дёшево генерировать персонажей-зрителей
-- Open-weights модели позволяют держать себестоимость низкой
-- Moloch's Bargain доказал: синтетическая аудитория реально различает engaging vs не-engaging контент
-
-## Открытые вопросы
-
-- **Платёжеспособность:** заплатит ли блогер $10-30/мес за предварительное тестирование контента? Или это нужно только тем, у кого уже есть аудитория 100K+ и цена ошибки высока?
-- **Достоверность:** Moloch's Bargain показал что оптимизация на engagement увеличивает дезинформацию. Нужны ли guardrails ("этот пост победит, но содержит манипуляцию")?
-- **Конкуренция с интуицией:** опытные креаторы и так чувствуют свою аудиторию. Для кого продукт ценнее — для новичков или для тех кто выходит на новую аудиторию?
-- **Связь с Largo AI:** они делают то же для кино. Можно ли позиционироваться как "Largo AI для креаторов" или нужна другая ниша?
-- **Связь с tvplotlines:** синтетическая аудитория, которая оценивает нарративную структуру (не просто "нравится/не нравится", а "арка персонажа не завершена", "конфликт не раскрыт") — это пересечение обеих идей.
diff --git a/docs/knowledge/archive/plans/tasks-todo.md b/docs/knowledge/archive/plans/tasks-todo.md
deleted file mode 100644
index 5c9c3c2..0000000
--- a/docs/knowledge/archive/plans/tasks-todo.md
+++ /dev/null
@@ -1,284 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# TODO: Pipeline Resilience
-
-## Контекст
-
-Autoresearch-эксперименты потеряны из-за OAuth-аутажа API (2026-03-14). Пайплайн all-in-memory, all-or-nothing — краш в любой точке = перезапуск всех LLM-вызовов. Pass 2 (N episode calls) — самый дорогой шаг. Batch mode теряет batch ID при падении процесса. Сетевые ошибки и rate limits мгновенно крашат пайплайн.
-
-**Цель:** Пайплайн переживает API brownouts, не нарушая контракт библиотеки (без disk I/O, backward compatible, opt-in сложность).
-
-**Принцип:** Библиотека не крашится без нужды (retry, timeout, partial success). Библиотека никогда не пишет файлы. Персистенция — выбор вызывающего через callbacks или передачу промежуточных результатов.
-
----
-
-## Step 1: Network resilience (`llm.py` — internal, no API change)
-
-### 1a. Transient error retry with backoff
-
-- [x] Добавить константы `_MAX_NETWORK_RETRIES = 3`, `_BACKOFF_BASE = 2.0`
-- [x] Добавить `_transient_exceptions() -> tuple` — lazy-cached, собирает retryable exceptions из установленных SDK
-- [x] Обернуть `_araw_call` в `_araw_call_with_retry()` с exponential backoff
-- [x] Заменить вызов `_araw_call` внутри `acall_llm` на `_araw_call_with_retry`
-- [x] Существующий ValueError retry loop остаётся нетронутым
-
-### 1b. Request timeout
-
-- [x] Добавить поле `timeout: float = 120.0` в `LLMConfig`
-- [x] Передавать в SDK клиенты (anthropic: `httpx.Timeout`, openai: `timeout=`)
-
-### 1c. Partial success in parallel mode
-
-- [x] `acall_llm_parallel`: `asyncio.gather(*tasks, return_exceptions=True)`
-- [x] Retry failed tasks individually, preserve successful results
-
----
-
-## Step 2: Callbacks (new file + `pipeline.py`)
-
-### 2a. PipelineCallback base class
-
-- [x] Создать `src/tvplotlines/callbacks.py` с 6 callback-методами (all no-op by default)
-
-### 2b. Wire callbacks into pipeline
-
-- [x] `callback: PipelineCallback | None = None` в `get_plotlines()`
-- [x] `_fire()` helper — try/except обёртка для callback-вызовов
-- [x] Sequential mode: `on_episode_complete` после каждого эпизода
-- [x] All modes: `on_pass2_complete` после всех эпизодов
-
-### 2c. Export
-
-- [x] `PipelineCallback` добавлен в `__all__`
-
----
-
-## Step 3: Resume from pre-computed inputs (`pipeline.py`)
-
-- [x] Optional параметры `cast`, `plotlines`, `breakdowns` в `get_plotlines()`
-- [x] Валидация: cast/plotlines вместе, breakdowns length match
-- [x] Post-processing всегда запускается (даже с пре-supplied breakdowns)
-
----
-
-## Step 4: Batch resilience (`llm.py` + `pass2.py` + `pipeline.py`)
-
-### 4a. Batch ID callback
-
-- [x] `on_batch_submitted` param в `acall_llm_batch` и sync wrapper `call_llm_batch`
-- [x] Fire сразу после `client.messages.batches.create()`
-
-### 4b. Resume from batch ID
-
-- [x] `batch_id` param в `acall_llm_batch` и sync wrapper
-- [x] Skip batch creation when provided
-
-### 4c. Batch polling timeout
-
-- [x] `_BATCH_TIMEOUT = 3600`, raises `TimeoutError`
-
-### 4d. Pass through from pipeline
-
-- [x] `pass2.py`: `assign_events_batch` passes through `batch_id`, `on_batch_submitted`
-- [x] `pipeline.py`: batch mode wires `callback.on_batch_submitted`
-
----
-
-## Верификация
-
-- [x] 54 existing tests pass (zero regressions)
-- [x] Network retry — 3 tests: retries on transient, raises after max, backoff delays
-- [x] Partial gather — 1 test: preserves successful, retries failed
-- [x] Callbacks — 2 tests: default no-op, subclass receives events
-- [x] Resume validation — 3 tests: cast/plotlines together, breakdowns length
-- [x] Batch timeout — 1 test: TimeoutError after short timeout
-- [x] Batch callback — 1 test: on_batch_submitted fires with batch ID
-- [x] Integration — full run + resume with RecordingCallback (3 episodes, sequential, $0.09)
-
-**Total: 65 unit + 2 integration tests, all green.**
-
----
-
-# Code Audit (2026-03-15)
-
-## Critical (fix now)
-
-- [x] **`text` uninitialized in retry loop** (`llm.py`) — initialized `text = ""` before loop, removed broken `dir()` check
-- [x] **`pass2_mode` silent fallthrough** (`pipeline.py`) — explicit `elif "sequential"`, else `raise ValueError`
-- [x] **`KeyError` bypasses LLM retry** (`pass1.py`, `pass2.py`, `pass3.py`) — wrapped `_parse_*` in `KeyError` → `ValueError` conversion; added explicit check for `v["action"]` in pass3
-- [x] **`TVPlotlinesResult.usage` undeclared** (`models.py`) — added `usage: str = ""` field
-
-## Important (fix soon)
-
-- [x] **Client not closed on error** (`llm.py`) — wrapped all 3 client functions (`_acall_anthropic`, `_acall_openai`, `acall_llm_batch`) in `try/finally: await client.close()`
-- [x] **`batch_id` silently ignored** (`pipeline.py`) — added `ValueError` if `batch_id` set with `pass2_mode != "batch"`
-- [x] **Parallel retry unprotected** (`llm.py`) — wrapped individual retry in `try/except`, raises `RuntimeError` with context instead of losing successful results
-- [x] **`validators[i]` no bounds check** (`llm.py`) — added length validation at entry of both `acall_llm_parallel` and `acall_llm_batch`
-- [x] **`validate_ranks` mutate-then-flag order** (`postprocess.py`) — separated flag collection from rank mutation; demotions applied after all rules evaluated
-- [x] **`""` vs `None` for unassigned events** (`metrics.py`) — normalized to truthy check in `compute_coverage` and `compute_consistency_ari`, consistent with `assign_orphan_events` and `compute_weight`
-
-## Low priority (document or defer)
-
-- [x] **Global `usage` singleton** (`llm.py`) — added TODO comment documenting the limitation. Fix deferred: requires threading UsageStats through LLMConfig or call chain. Not a problem in current single-threaded usage.
-- [x] **`on_episode_complete` dead in parallel mode** — documented in callbacks.py docstring, architecture.md table, and code example. Explicit "sequential mode only" everywhere.
-- [x] **`compute_consistency_ari` first-wins bias** (`metrics.py`) — replaced first-wins with Counter-based most-frequent storyline per character per episode
-- [x] **`rank="runner"` overlaps `type="runner"`** (`models.py`) — documented: type=continuity mode, rank=screen time. Usually co-occur but can diverge (e.g. runner-type promoted to rank B).
-
----
-
-## Review
-
-**Backward compatibility:** полная. Все новые параметры optional, 54 старых теста без регрессий.
-
-**Library contract:** соблюдён. Без disk I/O, персистенция через callbacks.
-
-**Tradeoffs:**
-- `_transient_cache` — module-level mutable global. Допустимо, альтернативы не проще.
-- `_fire()` глотает все исключения — правильно для resilience, компенсировано `logger.exception`.
-
-**Не покрыто тестами:** batch resume e2e, parallel callback order, buggy callback survival. Низкий риск.
-
-**Процесс:** нарушен workflow (без plan mode, без верификации). Урок записан в lessons.md.
-
----
-
-# TODO: PARA + Knowledge Base
-
-## PARA-реструктуризация
-
-- [x] Создать PARA-папки (1-projects, 2-areas, 3-resources, 4-archive)
-- [x] Переместить проекты в PARA-структуру
-- [x] Мигрировать Claude memory на новый путь (16 файлов)
-- [x] Проверить CLAUDE.md в проектах (tvplotlines, books2series — OK, устаревшие пути только в deprecated/archive)
-- [x] Проверить git status во всех репозиториях — OK
-
-## Knowledge Base — Фаза 0: Инфраструктура
-
-- [x] `git init` в `3-resources/knowledge/`, branch main
-- [x] Структура: maps/, notes/, templates/, scripts/, _sources/
-- [x] .gitignore (_sources/, .obsidian/, .DS_Store)
-- [x] setup.sh — симлинки на 6 источников (readings, concepts, preprint, style, app-research, prompting)
-- [x] CLAUDE.md и README.md
-- [x] Шаблоны: paper.md, concept.md, style-analysis.md
-
-## Knowledge Base — Фаза 1: Индексирование
-
-- [x] Написать scripts/build_registry.py (скан папок → registry.yaml)
-- [x] Запустить — 161 файл проиндексирован (67 readings + 48 concepts + 35 app-research + 6 style + 3 preprint + 2 prompting)
-- [x] Создать 6 MOC файлов в maps/ (narrative-theory, screenwriting-craft, llm-prompting, writing-style, tvplotlines-research, bibliography)
-
-## Knowledge Base — Фаза 2: YAML в tvplotlines файлах
-
-- [x] 3 файла в preprint-sources/ (brown, kojima, zhang) — type, title, authors, year, venue, tags, zotero, relevance
-- [x] 6 файлов style-notes/style-phrases — type, author, work, year, tags
-- [x] Обновить preprint-sources/index.md — добавлен MOC frontmatter
-- [x] Пересобрать registry.yaml — frontmatter подхвачен
-
-## Чтение статей для препринта
-
-- [x] Brown et al. 2020 — GPT-3
-- [x] Kojima et al. 2022 — Zero-Shot-CoT
-- [x] Zhang et al. 2025 — SeriesBench
-- [ ] Wei et al. 2022 — Chain-of-Thought Prompting
-- [ ] Zhou et al. 2022 — Least-to-Most Prompting
-- [ ] Eric Jang — Generalization in Deep Learning (blog)
-- [ ] Пост Карпатого про autoresearch
-
----
-
-# TODO: Stability Benchmark
-
-**Цель:** Доказать что pipeline выдаёт стабильные, воспроизводимые результаты. Ключевая метрика для препринта: "one run is representative".
-
-**Метрика:** Adjusted Rand Index (ARI) — сравнивает кластеризацию (character → storyline) между парами запусков. ARI=1.0 — идентично, ARI>0.7 — хорошо, ARI<0.5 — проблема.
-
-**Критерии успеха:**
-- Mean ARI ≥ 0.70 по каждому шоу
-- Coverage ≥ 0.90 по каждому шоу (≤10% unassigned events)
-- Ни одно шоу не ниже ARI 0.50
-
-**При провале:** ARI < 0.50 → исследовать промпты (Pass 1 voting нестабилен? Pass 2 assignment diverges?). ARI 0.50–0.70 → допустимо, но нужна оговорка в препринте.
-
-## Benchmark set: 5 шоу
-
-Выбраны по разнообразию franchise_type и размеру:
-
-| Show | Episodes | Franchise type | Почему |
-|------|----------|---------------|--------|
-| TD (True Detective) | 8 | serial | Маленький, чистый serial narrative |
-| BB (Breaking Bad) | 7 | serial | Классика, сложные арки |
-| HOUSE | 22 | procedural | Длинный, case-of-week + serialized B/C |
-| GOT (Game of Thrones) | 10 | ensemble | Много равноправных линий |
-| TIU (This Is Us) | 18 | hybrid | Эпизодические + сквозные линии |
-
-**Оценка стоимости:** ~73 эпизодов × 5 runs = 365 LLM calls (Pass 2) + 5×5 Pass 1 + 5×5 Pass 0 + 5×5 Pass 3. При $0.013/episode (Sonnet, cached) ≈ **$6–8 total**. Batch mode = 50% дешевле ≈ **$3–4**.
-
----
-
-## Task 0: Написать спеку
-
-- [ ] Создать `3-resources/knowledge/specs/stability-benchmark.md` — что измеряем, почему ARI, критерии, бюджет, шоу
-- [ ] Commit в knowledge
-
-## Task 1: Написать benchmark script
-
-- [ ] Создать `tvplotlines-app/data/scripts/benchmark_stability.py`:
-  - CLI: `python benchmark_stability.py --show TD --runs 5 --mode batch`
-  - Для каждого run: `get_plotlines()` → сохранить result JSON
-  - После всех runs: `compute_consistency_ari()` + `compute_coverage()` для каждого run
-  - Вывод: таблица (show, run, coverage, storyline_count) + mean ARI + per-pair ARI matrix
-  - Сохранить результаты в `tvplotlines-app/data/results/benchmark/`
-- [ ] Commit
-
-## Task 2: Dry-run (1 шоу, 2 runs)
-
-- [ ] Запустить `benchmark_stability.py --show TD --runs 2 --mode sequential`
-- [ ] Проверить что скрипт работает, результаты сохраняются, ARI вычисляется
-- [ ] Проверить стоимость одного run (из usage output)
-- [ ] Записать фактическую стоимость в спеку
-
-## Task 3: Полный benchmark (5 шоу × 5 runs)
-
-- [ ] Запустить batch mode для каждого шоу: TD, BB, GOT, TIU, HOUSE
-- [ ] Между шоу: проверять что batch завершился, результаты валидны
-- [ ] Если какой-то run упал — использовать resume (batch_id или pre-computed inputs)
-
-## Task 4: Анализ результатов
-
-- [ ] Собрать таблицу: show × (mean ARI, min ARI, mean coverage, storyline count range)
-- [ ] Проверить критерии успеха (ARI ≥ 0.70, coverage ≥ 0.90)
-- [ ] Если ARI < 0.70: исследовать — какие storylines diverge? Pass 1 voting нестабилен?
-- [ ] Записать результаты в спеку
-- [ ] Commit всех результатов
-
----
-
-# TODO: APO Experiments — systematic prompt optimization
-
-**Контекст:** Survey Ramnath et al. 2025 описывает 21 метод автоматической оптимизации промптов. Наш autoresearch loop — кустарный аналог. Нужно проверить: дают ли systematic methods лучший результат.
-
-**Два эксперимента:**
-
-## Experiment 1: SCULPT — оптимизация длинных промптов
-
-SCULPT (Kumar et al., 2024) оптимизирует длинные structured промпты через hierarchical tree. Наши промпты (8-11KB, role→rules→format→examples) — natural fit.
-
-- [ ] Прочитать оригинальную статью SCULPT
-- [ ] Проверить есть ли open-source реализация
-- [ ] Применить к Pass 2 промпту (самый дорогой, самый длинный) — оценить по coverage × ARI
-- [ ] Сравнить результат с текущим промптом и autoresearch-оптимизированным
-- [ ] Записать результаты
-
-## Experiment 2: DSPy/MIPRO — pipeline как program
-
-DSPy (Khattab et al., 2024) + MIPRO: Bayesian optimization для multi-stage LLM pipelines. Нужен refactoring — описать Pass 0→1→2→3 как DSPy modules.
-
-- [ ] Описать pipeline как DSPy program (Pass0 → Pass1 → Pass2 → Pass3)
-- [ ] Определить signatures для каждого module (input/output types)
-- [ ] Запустить MIPRO optimizer с нашей метрикой (coverage × ARI)
-- [ ] Сравнить оптимизированные промпты с текущими
-- [ ] Оценить: стоит ли переходить на DSPy или оставить текущую архитектуру
diff --git a/docs/knowledge/archive/plans/what-to-change.md b/docs/knowledge/archive/plans/what-to-change.md
deleted file mode 100644
index 65d6390..0000000
--- a/docs/knowledge/archive/plans/what-to-change.md
+++ /dev/null
@@ -1,35 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
-date: 2026-03-23
----
-
-# To decide 
-
-1. add option to write synopsis for the series name provided based on onlien content using [[tvplotlines-synopsis-authoring-protocol]]? 
-
-## Code before pass 0
-1. input for the function might be complicated list [str]? what is the convention here? should i explain how to prepare the input?
-## Pass 0
-1. franchise type - autodetected, no reason to leave for user to provide 
-2. franchise type - finalise the list with definitions in glossary 
-3. also i would not kill pass 0 yet and leave it to ablation autoresearch 
-4. decide if collect genre and format - does not seem we have any use of it... also genre is a free format so it will be hard to analyse consistently 
-	franchise_type: str     # "procedural" | "serial" | "hybrid" | "ensemble"
-    story_engine: str       # one sentence — the show's story-generation mechanism
-    genre: str              # "drama", "thriller", "comedy"
-    format: str | None      # "anthology" | "limited" | "ongoing"
-5. usage: str                            # token usage summary - when it is calculated? how we could show the data - how much in tockens each pass costs and total sum 
-6. 
-
-## Code after Pass 0
-## Pass 1
-
-## Code after Pass 1
-## Pass 2
-## Code after Pass 2
-## Pass 3
-## Code after Pass 3
-
-## Results 
\ No newline at end of file
diff --git a/docs/knowledge/archive/plans/write-synopses-plan.md b/docs/knowledge/archive/plans/write-synopses-plan.md
deleted file mode 100644
index 7629fee..0000000
--- a/docs/knowledge/archive/plans/write-synopses-plan.md
+++ /dev/null
@@ -1,207 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# write-synopses — план реализации утилиты
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** CLI-утилита `tvplotlines write-synopses` — по названию шоу и номеру сезона получает описания эпизодов из Wikipedia, переписывает их по протоколу (`synopsis-authoring-protocol.md`) через LLM, сохраняет в файлы.
-
-**Architecture:** Wikipedia API (season page) → beautifulsoup4 (парсинг `wikiepisodetable`) → LLM parallel (один вызов на эпизод) → отдельные файлы `S01E01.txt` или combined file. Fallback: `--from-files` — пользователь указывает сырые описания, утилита только переписывает по протоколу.
-
-**Tech Stack:** httpx (HTTP-клиент), beautifulsoup4 (парсинг HTML), существующий LLM-клиент из tvplotlines (`acall_llm_parallel`).
-
----
-
-## Принципы
-
-- CLI-утилита, **не часть библиотечного API** — `__init__.py` не импортирует и не экспортирует
-- Optional dependency: `pip install tvplotlines[writer]` ставит httpx + beautifulsoup4. Поисковый API не нужен — Wikipedia API с правильным page title отдаёт данные напрямую
-- Паттерн httpx: `try/except ImportError` в `cli.py`
-- Источник данных: Wikipedia API (бесплатный, легальный, без API-ключа)
-- User-Agent: `tvplotlines/{version} (https://github.com/BirdInTheTree/tvplotlines)` — Wikipedia требует корректный User-Agent, иначе 403
-
-## Решения
-
-- **LLM-вызовы:** parallel (один вызов на эпизод, через `acall_llm_parallel`). Batch API не подходит — пользователь ждёт результат интерактивно
-- **`--lang`:** да, с дефолтом `en`. Определяет язык Wikipedia (`en.wikipedia.org` vs `ru.wikipedia.org`)
-- **Формат вывода:** два режима:
-  - `-o synopses/` (директория) → отдельные файлы `S01E01.txt`, `S01E02.txt` — для `tvplotlines run synopses/*.txt --show House --season 1`
-  - `-o house_s01.txt` (файл) → один combined файл с header + episode delimiters — для `tvplotlines run house_s01.txt`
-  - Определяется автоматически: путь заканчивается на `/` или существующая директория → отдельные файлы, иначе → combined
-- **Промпт:** перевод и адаптация `3-resources/tvplotlines/synopsis-authoring-protocol.md` (русский → английский, формат ROLE/CONTEXT/RULES/OUTPUT)
-- **Тип шоу:** optional `--format procedural|serial|hybrid|limited`. Определяет beat counts в промпте (протокол задаёт разные для procedural/serial/ensemble). Если не указан — LLM определяет сам
-
-## Wikipedia: структура данных
-
-Нужны **season pages**, не list pages. `List of X episodes` — без описаний. Описания есть на страницах типа `House_(season_1)`, `Breaking_Bad_(season_1)`.
-
-HTML-структура консистентная:
-- Таблица: `wikitable wikiepisodetable`
-- Строка эпизода: `tr.module-episode-list-row`
-- Название: `td.summary`
-- Описание: следующий `tr.expand-child` → `td.description`
-
-Описания — 300–1400 символов (3–8 предложений). Достаточно для LLM-переписывания.
-
-## Обработка ошибок Wikipedia
-
-- **Страница не найдена (404):** попробовать оба варианта naming convention (`Show_(season_N)` и `Show_season_N`). Если оба 404 — понятная ошибка: `Page not found. Try --wiki-title "Exact_Page_Title" (check Wikipedia URL)`
-- **Таблица без описаний:** если `td.description` пустые или отсутствуют — ошибка: `No episode descriptions found on this page. Use --from-files with raw synopsis files instead`
-- **Описания слишком короткие (< 50 символов):** warning, но продолжить (LLM справится)
-- **Сетевые ошибки:** retry с exponential backoff (как в `llm.py`), максимум 3 попытки
-
-## Типы данных
-
-```python
-class RawEpisode(TypedDict):
-    number: int       # 1, 2, 3...
-    title: str        # "Pilot"
-    description: str  # Raw Wikipedia description
-```
-
-Используется вместо `list[dict]` для явного контракта.
-
-## Файловая структура
-
-### Новые файлы
-
-- `src/tvplotlines/write_synopses.py` — Wikipedia API + парсинг + LLM-переписывание
-- `src/tvplotlines/prompts_en/write_synopses.md` — промпт для LLM
-- `tests/test_write_synopses.py` — тесты
-- `tests/fixtures/wikipedia_house_s01.html` — мок HTML для тестов
-
-### Изменения в существующих файлах
-
-- `cli.py` — добавить команду `write-synopses` с `try/except ImportError`
-- `pyproject.toml` — добавить `writer = ["httpx>=0.27", "beautifulsoup4>=4.12"]`
-
-## Поток работы утилиты
-
-```
-tvplotlines write-synopses "House" --season 1 -o synopses/
-tvplotlines write-synopses "House" --season 1 --lang en -o synopses/
-```
-
-1. **Resolve:** конструирует page title `{Show}_(season_{N})`. Если 404 — пробует `{Show}_season_{N}` (оба формата встречаются). Если оба 404 — ошибка с подсказкой `--wiki-title`
-2. **Fetch:** Wikipedia API `action=parse`, page=resolved title → HTML
-3. **Parse:** bs4 извлекает episode titles + descriptions из `wikiepisodetable`
-4. **LLM:** parallel — каждый эпизод переписывается по протоколу (один вызов на эпизод)
-5. **Save:** если `-o` — директория → `synopses/S01E01.txt`, ...; если файл → combined format:
-   ```
-   House, Season 1
-
-   Episode 1 — Pilot
-   Synopsis text...
-
-   Episode 2 — Paternity
-   Synopsis text...
-   ```
-
-### Fallback: `--from-files`
-
-```
-tvplotlines write-synopses "House" --season 1 --from-files raw/*.txt -o synopses/
-```
-
-Пропускает шаги 1-2, берёт сырые описания из файлов, только переписывает через LLM.
-
-## Оценка стоимости
-
-**Вход:** описание из Wikipedia — 300-1400 символов (~100-400 токенов).
-**Промпт:** ~2000 токенов (system prompt из протокола).
-**Выход:** 300-500 слов (~400-650 токенов).
-
-**На один эпизод:** ~2500 input + ~500 output токенов.
-**Сезон 22 серии (House) на claude-haiku-4-5:** 55K input × $0.80/M + 11K output × $4.0/M ≈ **$0.09**
-**Сезон 22 серии на claude-sonnet-4:** 55K × $3.0/M + 11K × $15.0/M ≈ **$0.33**
-**Batch mode (−50%):** haiku ~$0.05, sonnet ~$0.17.
-
-Поиск бесплатный (Wikipedia API).
-
-### `--dry-run`
-
-Добавить флаг `--dry-run`: выполняет шаги 1-2 (fetch + parse), показывает найденные эпизоды и оценку стоимости, не вызывает LLM. Позволяет проверить что Wikipedia-страница найдена правильно.
-
-## Стратегия тестирования
-
-### Unit-тесты с мок-данными
-
-- **Парсинг HTML:** сохранить реальный HTML `House_(season_1)` в `tests/fixtures/wikipedia_house_s01.html`. Тесты проверяют: правильное количество эпизодов, заполненные titles и descriptions, корректные номера эпизодов.
-- **Wikipedia API:** мок httpx-ответа. Тесты проверяют: правильный URL формируется, ошибки обрабатываются (404, таймаут, нет таблицы).
-- **LLM-переписывание:** мок `acall_llm_parallel`. Тесты проверяют: промпт формируется правильно, результаты сохраняются в файлы с правильными именами.
-- **Combined output:** тест что `-o file.txt` создаёт один файл с header `Show, Season N` и episode delimiters `Episode N — Title`, совместимый с `input_parser.parse_synopsis_file()`.
-
-### Тест формата выхода
-
-- Валидация синопсиса: plain text (без markdown), 300-500 слов, без bullet points, без подзаголовков. Это проверяется на мок-ответах LLM.
-
-### Интеграционный тест
-
-- Реальный вызов на `House S01` (требует сеть + API-ключ, запускается вручную, не в CI).
-
-## Задачи
-
-### Task 1: Промпт `write_synopses.md`
-
-**Files:**
-- Create: `src/tvplotlines/prompts_en/write_synopses.md`
-- Source: `3-resources/tvplotlines/synopsis-authoring-protocol.md`
-
-- [ ] Адаптировать `synopsis-authoring-protocol.md` в LLM-промпт
-- [ ] Формат: ROLE → CONTEXT → RULES → OUTPUT (как pass0.md, pass1.md)
-- [ ] Вход: сырое описание эпизода + название шоу + номер сезона + номер эпизода
-- [ ] Выход: синопсис по протоколу (300-500 слов, 8-15 beats, plain text)
-- [ ] Commit
-
-### Task 2: Wikipedia парсер
-
-**Files:**
-- Create: `src/tvplotlines/write_synopses.py` (функции для Wikipedia)
-- Create: `tests/fixtures/wikipedia_house_s01.html` (мок HTML)
-- Create: `tests/test_write_synopses.py`
-
-- [ ] Функция `fetch_season_page(show: str, season: int, lang: str = "en") -> str` — получить HTML season page через Wikipedia API
-- [ ] Функция `parse_episode_table(html: str) -> list[RawEpisode]` — извлечь эпизоды из `wikiepisodetable`
-- [ ] Скачать реальный HTML `House_(season_1)` в `tests/fixtures/wikipedia_house_s01.html`
-- [ ] Тесты: парсинг мок-HTML → правильное количество эпизодов, заполненные описания
-- [ ] Commit
-
-### Task 3: LLM-переписывание + основная функция
-
-**Files:**
-- Modify: `src/tvplotlines/write_synopses.py`
-- Modify: `tests/test_write_synopses.py`
-
-- [ ] Функция `rewrite_synopses(episodes: list[RawEpisode], show: str, season: int, config: LLMConfig) -> list[str]` — parallel LLM-вызов через `acall_llm_parallel`
-- [ ] Функция `write_synopses(show, season, output_dir, *, from_files=None, lang="en", provider, model, base_url)` — основной entry point
-- [ ] Режим Wikipedia: fetch → parse → rewrite → save
-- [ ] Режим `--from-files`: read files → rewrite → save
-- [ ] Save: отдельные файлы (если `-o` — директория) или combined file (если `-o` — файл). Combined format: `Show, Season N\n\nEpisode 1 — Title\ntext\n\n...`
-- [ ] Загрузка промпта через `load_prompt("write_synopses")`
-- [ ] Тесты с мок LLM-ответами
-- [ ] Commit
-
-### Task 4: CLI интеграция
-
-**Files:**
-- Modify: `src/tvplotlines/cli.py`
-- Modify: `pyproject.toml`
-
-- [ ] Добавить `writer = ["httpx>=0.27", "beautifulsoup4>=4.12"]` в `[project.optional-dependencies]`
-- [ ] Добавить команду `write-synopses` в `cli.py`
-- [ ] Аргументы: `show` (positional), `--season` (default 1), `-o/--output` (dir), `--from-files` (glob), `--wiki-title` (exact Wikipedia page title, fallback для disambiguации), `--format` (procedural/serial/hybrid/limited, optional), `--lang` (default "en"), `--dry-run`, `--provider`, `--model`, `--base-url`
-- [ ] `try/except ImportError` при вызове `_write_synopses(args)` с сообщением: `pip install tvplotlines[writer]`
-- [ ] Ручной тест: `tvplotlines write-synopses --help`
-- [ ] Commit
-
-### Task 5: Интеграционный тест
-
-- [ ] Запустить `tvplotlines write-synopses "House" --season 1 -o /tmp/synopses/`
-- [ ] Проверить что файлы `S01E01.txt` ... `S01E22.txt` создались
-- [ ] Проверить формат: 300-500 слов, prose, без bullet points
-- [ ] Проверить `--from-files` режим на тестовых fixtures
-- [ ] Commit финальный
diff --git a/docs/knowledge/decisions/decision-001-context-before-extraction.md b/docs/knowledge/decisions/decision-001-context-before-extraction.md
deleted file mode 100644
index 00beeed..0000000
--- a/docs/knowledge/decisions/decision-001-context-before-extraction.md
+++ /dev/null
@@ -1,45 +0,0 @@
----
-type: decision
-project: tvplotlines
-status: active
----
-
-# ADR-001: Определять контекст сериала до экстракции линий
-
-## Статус
-Принято
-
-## Контекст
-В mas4bw (оригинал Balestri & Pescatore) экстракция арок начинается сразу, без понимания что за сериал перед нами. Результат: в "Слово пацана" S01 извлечено 25 арок (10 Anthology, 7 Soap, 8 Genre-Specific), хотя в реальности основных линий 3.
-
-## Решение
-Ввести Шаг 0 — автоматическое определение контекста сериала перед экстракцией:
-
-**0a. Franchise type** (procedural / serialized / hybrid)
-- Определяет СТРУКТУРУ ожидаемых линий
-- Procedural → A-story закрытая (case-of-week), B/C сериализованные
-- Serialized → все линии сквозные
-- Hybrid → A закрытая + B/C сквозные
-
-**0b. Story engine** (что генерирует эпизоды)
-- Определяет КАКИЕ линии искать
-- Case-of-week engine → линия расследования/пациента/дела
-- Transformation machine → линия трансформации героя
-- Relationship engine → линии отношений
-
-Также определяется жанр и формат.
-
-## Варианты
-1. **Пользователь задаёт контекст вручную** — точнее, но требует экспертизы
-2. **ИИ определяет автоматически** — удобнее, один дополнительный LLM-вызов
-3. **Оба варианта** ← выбрано. Автоопределение по умолчанию, ручной ввод как override
-
-## Почему именно так
-- Без контекста экстрактор не знает сколько линий ожидать и какого типа
-- Один LLM-вызов на все синопсисы сразу — дёшево
-- Ручной override нужен когда пользователь знает лучше (или для тестирования)
-
-## Последствия
-- `get_plotlines()` возвращает `TVPlotlinesResult` с полем `context` — пользователь видит что определилось
-- Шаги экстракции получают контекст как параметр и адаптируют промпты
-- Промпты для экстракции должны учитывать franchise type (разные ожидания для разных типов)
diff --git a/docs/knowledge/decisions/decision-002-no-internal-state.md b/docs/knowledge/decisions/decision-002-no-internal-state.md
deleted file mode 100644
index 2ed35c3..0000000
--- a/docs/knowledge/decisions/decision-002-no-internal-state.md
+++ /dev/null
@@ -1,40 +0,0 @@
----
-type: decision
-project: tvplotlines
-status: active
----
-
-# ADR-002: Никакого скрытого состояния внутри библиотеки
-
-## Статус
-Принято
-
-## Контекст
-В mas4bw шаг 2 графа экстракции открывает сессию SQLite и читает ранее найденные арки из базы данных. Также `initialize_state` читает 4 файла с диска. Это делает код непереносимым: нельзя вызвать как функцию, нужен работающий SQLite + файловая система.
-
-## Решение
-Библиотека — чистая функция. Всё на вход, всё на выход. Внутри нет:
-- Базы данных (SQLite, ChromaDB)
-- Чтения/записи файлов
-- Скрытого состояния между вызовами
-- Веб-сервера
-
-Пользователь подаёт ВСЕ синопсисы сезона в один вызов `get_plotlines()`. Функция сама проходит эпизоды последовательно и накапливает линии in-memory. Состояние живёт только во время вызова и не сохраняется между вызовами.
-
-## Варианты
-1. **Встроенная БД** (как в mas4bw) — удобно для приложения, невозможно для библиотеки
-2. **Файловый кэш** — неявная зависимость от файловой системы
-3. **`known_plotlines` параметр** — перекладывает сложность на пользователя, он не хочет этим заниматься
-4. **Весь сезон в один вызов, состояние in-memory** ← выбрано
-
-## Почему именно так
-- Библиотеку можно вызвать из Jupyter notebook, из CLI, из веб-сервера, из другой библиотеки
-- Пользователь контролирует хранение (может вообще не хранить)
-- Тестируемость: вход → выход, без side effects
-- Урок из техаудита mas4bw: два места привязки к инфраструктуре — главный блокер для переиспользования
-
-## Последствия
-- Пользователь подаёт весь сезон одним вызовом — проще некуда
-- Внутри функция сама итерирует по эпизодам и накапливает контекст
-- Нет персистентного состояния — каждый вызов независим
-- Инкрементальная обработка (серия за серией) — возможный low-level API в будущем, не приоритет
diff --git a/docs/knowledge/decisions/decision-003-abc-classification.md b/docs/knowledge/decisions/decision-003-abc-classification.md
deleted file mode 100644
index 5203b00..0000000
--- a/docs/knowledge/decisions/decision-003-abc-classification.md
+++ /dev/null
@@ -1,37 +0,0 @@
----
-type: decision
-project: tvplotlines
-status: active
----
-
-# ADR-003: Классификация A/B/C вместо anthology/soap/genre
-
-## Статус
-Принято
-
-## Контекст
-Оригинал (Balestri & Pescatore) использует академическую классификацию арок: Anthology, Soap, Genre-Specific. На практике это приводит к проблемам: в "Слово пацана" 10 из 25 арок помечены как Anthology, хотя anthology arcs в обычных сериалах почти не бывает.
-
-## Решение
-Использовать индустриальную классификацию сюжетных линий:
-- **A-line** — основная жанровая линия (определяется story engine)
-- **B-line** — отношения / soap
-- **C-line** — побочная (soap или genre в зависимости от сериала)
-
-Источники: Nash "Save the Cat Writes for TV", Douglas "Writing the TV Drama Series".
-
-## Варианты
-1. **Оставить anthology/soap/genre** — академически корректно, практически бесполезно
-2. **A/B/C storylines** ← выбрано — так думают сценаристы и продюсеры
-3. **Своя гибридная таксономия** — overcomplicated
-
-## Почему именно так
-- Сценаристы и шоураннеры мыслят в терминах A/B/C, не anthology/soap/genre
-- A/B/C напрямую связаны с franchise type: в procedural A = case-of-week, в serialized A = сквозная
-- Меньше категорий → меньше ошибок классификации
-- Базируется на индустриальных книгах, а не академической теории
-
-## Последствия
-- Промпты пишутся в терминах A/B/C
-- `Plotline.label` принимает значения "A", "B", "C", "D" (если линий больше трёх)
-- `Plotline.type` описывает характер линии ("main", "relationship", "procedural") — это дополнение, не замена label
diff --git a/docs/knowledge/decisions/decision-004-no-language-parameter.md b/docs/knowledge/decisions/decision-004-no-language-parameter.md
deleted file mode 100644
index c8bd5ae..0000000
--- a/docs/knowledge/decisions/decision-004-no-language-parameter.md
+++ /dev/null
@@ -1,37 +0,0 @@
----
-type: decision
-project: tvplotlines
-status: active
----
-
-# ADR-004: Без параметра языка — вход определяет выход
-
-## Статус
-Принято
-
-## Контекст
-Первоначально API предполагал параметр `language` (или `output_language`). Но зачем? Если пользователь подаёт синопсисы на русском — он хочет результат на русском. Если на немецком — на немецком.
-
-## Решение
-Никакого параметра языка. LLM определяет язык входа и отвечает на нём же. В промпте: "Respond in the same language as the input."
-
-```python
-# Просто
-result = get_plotlines(episodes=["синопсис 1", "синопсис 2", ...])
-```
-
-## Варианты
-1. **`language="en"` обязательный** — ограничивает аудиторию, добавляет сложность
-2. **`output_language` отдельно от входа** — зачем? кому нужны синопсисы на русском с ответом на английском?
-3. **Без параметра, язык = язык входа** ← выбрано
-
-## Почему именно так
-- Минимальный API — меньше параметров, проще пользоваться
-- Не ограничивает аудиторию одним-двумя языками
-- LLM справляется с определением языка без подсказок
-- Синопсисы можно искать на любом доступном языке — библиотека работает со всеми
-
-## Последствия
-- Промпты пишутся language-agnostic: "Respond in the same language as the input"
-- Не нужны отдельные файлы промптов для EN/RU (как в mas4bw)
-- Если пользователю нужен другой язык выхода — это edge case, пусть переводит сам
diff --git a/docs/knowledge/decisions/decision-005-pass3-narratologist-review.md b/docs/knowledge/decisions/decision-005-pass3-narratologist-review.md
deleted file mode 100644
index c2eac13..0000000
--- a/docs/knowledge/decisions/decision-005-pass3-narratologist-review.md
+++ /dev/null
@@ -1,150 +0,0 @@
----
-type: decision
-project: tvplotlines
-status: active
----
-
-# ADR-005: Pass 3 — ревизия нарратолога
-
-## Статус
-Проектирование
-
-## Контекст
-Pass 2 генерирует патчи (ADD_LINE, CHECK_LINE, SPLIT_LINE, RERANK) — обратную связь о проблемах в списке линий из Pass 1. Сейчас патчи собираются, но не применяются.
-
-Первоначальный план — перезапустить Pass 1 с учётом патчей. Проблемы:
-- Дорого: повторная обработка всех синопсисов
-- Рискованно: LLM может сломать то, что уже правильно
-- Реактивно: работает только с тем, что Pass 2 заметил
-
-## Решение
-Отдельный Pass 3 с ролью **нарратолога** — «второе мнение» от другого взгляда.
-
-### Три пасса — три взгляда
-- **Pass 0** — генералист (контекст сериала)
-- **Pass 1 + Pass 2** — аналитик (линии + события)
-- **Pass 3** — критик/нарратолог (ревизия результата)
-
-### Что видит нарратолог
-- Линии + каст (Pass 1)
-- События по эпизодам (Pass 2)
-- Computed span и weight (пост-обработка)
-- Патчи из Pass 2 как *подсказки*, не как задания
-- Story engine и franchise type для контекста
-
-### Какие вопросы задаёт
-Не «проверь на ошибки», а теоретические вопросы:
-- У каждой линии есть driver → goal → obstacle → stakes? Если нет — это не storyline, а thread
-- Арка полная? setup без escalation — мертворождённая линия
-- Два storyline с одним driver и смежными целями — одна линия с фазами?
-- Computed weight = "primary", rank = "C" — кто прав?
-- Franchise type = hybrid, но нет episodic-линии — что-то не так
-- ADD_LINE: реально новая линия, или ошибка привязки события?
-
-### Выход — вердикты (не патчи)
-Вердикты достаточно конкретны, чтобы код применил их механически:
-- `MERGE(line_x → line_y)` — все события line_x → line_y
-- `REASSIGN(event, → line_z)` — точечное переназначение
-- `PROMOTE/DEMOTE(line, new_rank)` — смена ранга
-- `CREATE(new_line {driver, goal, ...}, events: [...])` — новая линия + какие события ей принадлежат
-- `DROP(line, redistribute: {event → line, ...})` — удаление линии с перераспределением событий
-
-### Применение
-Код применяет вердикты к линиям и событиям. Без повторного Pass 1 или Pass 2.
-
-RERANK можно вычислить кодом (из весов) до Pass 3 — нарратолог его не касается.
-
-### Ограничения
-- Один вызов LLM, один раунд ревизии
-- Если после Pass 3 остаются нерешённые вопросы — оставляем как есть с `confidence: "inferred"`
-
-## Метрики качества пайплайна
-
-Две метрики, считаются вместе как один score:
-
-- **Coverage** — доля нарративных событий из синопсиса, попавших хоть в одну линию (`storyline != null`). Считается из выхода Pass 2.
-- **Consistency** — одинаковые синопсисы дают одинаковые линии при разных запусках. Измеряется через ARI (см. ниже).
-
-Формула: **score = coverage × consistency**
-
-Мультипликативная, чтобы нельзя было оптимизировать одно за счёт другого. Coverage = 1.0 при consistency = 0.3 → score = 0.3.
-
-### Consistency через ARI (Adjusted Rand Index)
-
-Наша задача — сравнение кластеризаций. Каждый запуск пайплайна — это кластеризация: события распределяются по линиям (кластерам). Названия линий могут отличаться между запусками («belonging» vs «acceptance»), но структура — какие события оказались вместе — сравнима.
-
-**ARI (Adjusted Rand Index)** — стандартная метрика для сравнения двух кластеризаций без учёта названий кластеров. Диапазон: -0.5..1.0, где 1.0 = идентичные кластеризации, 0.0 = случайное совпадение, <0 = хуже случайного. Реализация: `sklearn.metrics.adjusted_rand_score`, одна строчка.
-
-**Источники:**
-- Оригинальная работа: Hubert & Arabie, 1985 — «Comparing partitions» (Journal of Classification)
-- Применение к LLM: Guven et al., 2024 — «LLM Stability: A detailed analysis with some surprises» (arxiv:2408.04667) — TAR (Total Agreement Rate) для стабильности LLM-выходов
-- Wang et al., 2023 — «Self-Consistency Improves Chain of Thought Reasoning» (ICLR, arxiv:2203.11171) — принцип: несколько запусков + majority vote
-- Manakul et al., 2023 — «SelfCheckGPT» (EMNLP, arxiv:2303.08896) — консистентность как прокси для фактологичности
-
-### Два уровня измерения consistency
-
-Это не "или-или" — это разные уровни точности за разную цену:
-
-**Уровень 1: Структурная consistency — ARI через сетку (эпизод × персонаж)**
-- Якорь: для каждой пары (эпизод, персонаж) — в какой линии он оказался
-- Сетка фиксирована между запусками (персонажи и эпизоды не меняются)
-- Грубее, но интерпретируемее и бесплатно считается
-- Реализация: `sklearn.metrics.adjusted_rand_score`
-
-**Уровень 2: Семантическая consistency — STED + Hungarian matching**
-- STED (arxiv 2512.23712, ноябрь 2025) — фреймворк для оценки consistency structured output LLM. Различает *expression variations* ("belonging" vs "acceptance" — это ок) и *semantic drift* (реально разный результат). Robustness 0.981 для парафраз vs наивный DeepDiff 0.805.
-- Hungarian matching (scipy.optimize.linear_sum_assignment) — optimal assignment между наборами линий
-- Embeddings каждой линии → Hungarian → среднее cosine similarity по matched парам
-- Точнее, но дороже (нужны embeddings)
-
-**Стратегия:** начать с уровня 1 (быстро, бесплатно). Подключить уровень 2 когда ARI перестанет различать.
-
-**Почему не другие якоря для ARI:**
-- Номера предложений синопсиса — ненадёжно: одно событие = несколько предложений, LLM склеивает
-- Embedding matching → ARI — это фактически Hungarian matching с лишним шагом
-
-**Дополнительные метрики (при необходимости):**
-- AMI (Adjusted Mutual Information) — информационно-теоретический аналог ARI
-- V-Measure — разделяет homogeneity (чистота кластеров) и completeness (полнота)
-
-### Автоматическая оптимизация промптов (по мотивам autoresearch)
-
-Идея из [karpathy/autoresearch](https://github.com/karpathy/autoresearch): AI-агент в цикле модифицирует код → запускает эксперимент → проверяет метрику → оставляет или откатывает → повторяет. Человек пишет `program.md` (инструкции агенту), а не код.
-
-**Адаптация для tvplotlines:**
-
-| autoresearch | tvplotlines |
-|---|---|
-| Модифицируемый файл: `train.py` | Модифицируемые файлы: промпты `pass{0,1,2,3}.md` |
-| Метрика: `val_bpb` (ниже = лучше) | Метрика: `score = coverage × consistency(ARI)` (выше = лучше) |
-| Один прогон: 5 мин (GPU) | Один прогон: ~3 мин (API) |
-| Логирование: `results.tsv` | Логирование: `results.tsv` |
-| Цикл: изменил → запустил → измерил → keep/discard | Тот же цикл |
-
-**Структура program.md для tvplotlines:**
-1. Setup — прочитать архитектуру, промпты, snapshot
-2. Constraints — менять только промпты, не код пайплайна
-3. Metric — `score = coverage × consistency(ARI)`, выше = лучше
-4. Loop — изменил промпт → прогнал N раз → вычислил score → keep/discard
-5. Logging — TSV: commit, score, coverage, consistency, status, description
-
-**Ограничения:** каждый прогон стоит денег (API). Для consistency нужно N запусков (минимум 3). Один эксперимент = 3×3 мин = ~10 мин + ~$1-2. За ночь ~50 экспериментов, не 100 как у Karpathy.
-
-Pass 3 (нарратолог) при этом — и этап пайплайна, и качественный индикатор: много тяжёлых вердиктов = Pass 1/2 сработали плохо.
-
-## Что нужно проверить
-1. Достаточно ли контекста нарратологу без сырых синопсисов? (видит только линии + события + span/weight)
-2. Хватит ли одного вызова, или объём данных (все эпизоды, все линии, все события) не влезет в контекст?
-3. Формат вердиктов: сможет ли LLM стабильно генерировать структурированные операции (MERGE, REASSIGN, CREATE)?
-4. Применение вердиктов кодом: покрывают ли 5 операций все реальные кейсы?
-5. Качество: действительно ли «второе мнение» улучшает результат vs просто добавляет шум?
-
-## Следующие шаги
-- ✅ Получить snapshot результата Pass 1 + Pass 2 на «Слове пацана» (fixture)
-- ✅ Написать промпт Pass 3
-- Написать код Pass 3 (вызов LLM + парсинг вердиктов)
-- Написать код применения вердиктов к линиям и событиям
-- Прогнать Pass 3 на snapshot, оценить качество вердиктов
-- Реализовать вычисление coverage (из snapshot)
-- Реализовать вычисление consistency (N запусков → сравнение)
-- Написать program.md для autoresearch-цикла
diff --git a/docs/knowledge/prompting/how-to-prompt.md b/docs/knowledge/prompting/how-to-prompt.md
deleted file mode 100644
index 7bd1709..0000000
--- a/docs/knowledge/prompting/how-to-prompt.md
+++ /dev/null
@@ -1,11 +0,0 @@
-  **Главный** **принцип:** **LLM** **уже** **знает** **предмет.** **Промт** **не** **учит** **—** **промт** **направляет.**
-1. **Не** **объясняй** **базовые** **вещи** **—** **задавай** **систему** **координат.** Модель прочла миллион текстов про сюжеты, персонажей и конфликты. Она знает, что такое "конфликт". Ей объяснить, что конкретно ТЫ имеешь в виду под "driver" и чем это отличается от того, что она могла бы подумать по умолчанию. _(Mitchell_ _2025:_ _LLM_ _=_ _мешок_\n  _эвристик;_ _промт_ _организует,_ _какие_ _эвристики_ _активировать.)_
- 2. **Формулируй** **конкретно,** **не** **абстрактно.** "Что конкретно мешает персонажу получить\n  то, что он хочет? Другой человек? Обстоятельство? Внутренний страх?" работает\n  лучше, чем "определите obstacle—препятствие на пути к цели". Конкретные\n  формулировки запускают более глубокую обработку. _(Pecher_ _&_ _Zwaan_ _2005:_ _понимание_ _= _мысленная_ _симуляция_ _ситуации,_ _а_ _не_ _поиск_ _определения_ _в_ _словаре._ _Конкретные_  _описания_ _запускают_ _эту_ _симуляцию.)_  
-3. **Объясняй** **ЗАЧЕМ,** **а** **не** **только** **ЧТО.** Промт "определи franchise type: procedural,  serial, hybrid, ensemble" хуже, чем промт, который объясняет: "тип формата  определяет ритм ожиданий зрителя—в процедурале каждую неделю новое дело, в  сериале нарастающая дуга". Когда модели дают антропологическое рассуждение (почему это понятие важно, как оно связано с контекстом), результат улучшается.  _(AlKhamissi_ _2024:_ _anthropological_ _prompting_ _—_ _объяснение_ _"зачем"_ _улучшает_  _культурное_ _выравнивание,_ _особенно_ _для_ _нетипичных_ _случаев.)_ 
-4. **Язык** **промта** **имеет** **значение** **—** **это** **не** **просто** **перевод.** Промт на русском активирует другой набор знаний модели, чем промт на английском. Русскоязычный промт для  анализа русского сериала может дать другие (потенциально лучше подходящие)  результаты. _(AlKhamissi_ _2024:_ _модель_ _хранит_ _культурные_ _знания_ _вместе_ _с_ _языком,_ _на_  _котором_ _они_ _были_ _в_ _обучающих_ _данных._ _Арабский_ _промт_ _для_ _вопросов_ _про_ _Египет_  _работает_ _лучше_ _английского.)_  
-5. **Давай** **модели** **роль** **—** **но** **содержательную,** **а** **не** **декоративную.** "Ты—story editor  голливудского сериала" работает не потому что модель "вживается в роль", а потому  что активирует конкретный набор нарративных эвристик (как думает story editor).  Роль должна быть конкретной и релевантной задаче, не просто "ты эксперт". _(Winston_ _2011/2017:_ _Dr._ _Jekyll_ _/_ _Mr._ _Hyde_ _—_ _один_ _набор_ _правил_ _видит_ _месть,_ _другой_ _—_  _безумие._ _Роль_ _=_ _набор_ _правил.)_  
-6. **Компенсируй** **естественные** **предпочтения** **модели.** LLM по умолчанию тяготеет к стилю (тон, атмосфера, авторский голос), а не к структуре (события, причины, связи).  Если задача—структурный анализ, промт должен явно направлять модель на  структуру. _(Jung_ _2026:_ _LLM_ _выбирают_ _стилистические_ _ограничения_ _на_ _67%_ _чаще,_ _чем_  _событийные._ _Это_ _"природная"_ _склонность,_ _которую_ _промт_ _должен_ _преодолевать.)_
-7. **Используй** **теорию** **как** **словарь,** **а** **не** **как** **инструкцию.** Промт работает лучше, когда  он даёт модели набор конкретных понятий (что искать и как называть), а не общую  инструкцию (проанализируй). _(Piper_ _&_ _Bagga_ _2024:_ _15_ _нарратологических_ _понятий_  _Женетта_ _→_ _15_ _простых_ _вопросов_ _для_ _LLM_ _→_ _точность_ _до_ _100%_ _на_ _некоторых_ _из_ _них._\n  _Теория_ _→_ _словарь_ _→_ _промт_ _=_ _операция_ _enculturation.)_  
-8. **Проверяй,** **а** **не** **доверяй.** Промт может заставить модель "подыгрывать"—давать  ответы, которые выглядят правильно, но основаны на поверхностных паттернах, а не  на реальном анализе. Нужна верификация: контрольные вопросы, перекрёстные  проверки, сравнение результатов нескольких прогонов. _(Pawar_ _2025:_ _модели_ _реагируют_ _на_ _социодемографические_ _подсказки,_ _но_ _эффект_ _может_ _быть_ _артефактом._ _Mitchell_  _2025:_ _за_ _"пониманием"_ _может_ _стоять_ _мешок_ _эвристик,_ _который_ _ломается_ _в_ _нестандартных_ _ситуациях.)_  
-9. **Ближний** **контекст** **важнее** **далёкого.** Мозг (и модель) лучше всего работает с  текущим и 1–2 предыдущими предложениями. Для длинных текстов лучше разбивать на  части и анализировать по частям, а потом собирать общую картину. _(Yu_ _et_ _al._ _2024:_  _пик_ _корреляции_ _модели_ _с_ _мозгом_ _—_ _при_ _1–2_ _предшествующих_ _предложениях,_ _потом_  _снижение.)_  
-10. **Разные** **модели** **—** **разные** **"авторы".** GPT тяготеет к стилю, Claude—к  когерентности, Gemini—к абстрактным концепциям. Промт, оптимизированный под одну модель, может не работать с другой. _(Jung_ _2026:_ _каждая_ _модель_ _имеет_ _характерный_  _"авторский_ _профиль"_ _—_ _предпочтения_ _по_ _событиям,_ _стилю,_ _персонажам_ _и_ _сеттингу.)_
diff --git a/docs/knowledge/prompting/prompt-template.md b/docs/knowledge/prompting/prompt-template.md
deleted file mode 100644
index 2a6de4f..0000000
--- a/docs/knowledge/prompting/prompt-template.md
+++ /dev/null
@@ -1,98 +0,0 @@
----
-type: spec
-project: tvplotlines
-status: active
----
-
-# Prompt Template
-
-Unified structure for all pipeline prompts (pass0, pass1, pass2, pass3). Every prompt follows the same 7 sections in the same order.
-
-Definitions come from `tvplotlines-glossary.md` — the glossary is the ground truth. Prompts include only the definitions relevant to their pass.
-
-## Principles
-
-1. Don't explain basics — set the coordinate system. LLM already knows what "conflict" is. Tell it what YOU mean by "plotline" (how-to-prompt rule 1).
-2. Be concrete, not abstract. "What specifically blocks the hero?" not "define the obstacle" (rule 2).
-3. Explain WHY, not just WHAT. "Format determines what plotlines to expect" not just "classify the format" (rule 3).
-4. Theory as vocabulary, not instruction. Give terms to look for, not general instructions to "analyze" (rule 7).
-5. Definitions with examples = strongest single component (GoLLIE, Sainz 2024: +5.4 F1).
-6. Code validates — don't repeat in prompt what code checks (Qiu 2025: code validation +11.7pp, prompt rules +1.1pp).
-
-## Template
-
-```
-# ROLE
-Who you are. 1-2 sentences.
-Why this perspective matters for the task.
-Example: "You are a story editor analyzing a TV season. Your job is to
-identify parallel storylines, not to evaluate quality or suggest improvements."
-
-# CONTEXT
-What you receive. Where it comes from. What prior passes already determined.
-Example: "You receive all episode synopses for one season, plus the SeriesContext
-from Pass 0 (format, story_engine). Your task builds on this context."
-
-# GLOSSARY
-Definitions of terms used in THIS pass. From tvplotlines-glossary.md.
-Only include what this pass needs — don't dump the whole glossary.
-Each definition must have:
-  - what it is (concrete, not abstract)
-  - examples (real shows)
-  - counter-examples ("not a plotline: ...")
-
-# TASK
-What to do, step by step.
-"First read all synopses. Then identify the cast. Then extract plotlines.
-For each plotline, fill in Story DNA (hero, goal, obstacle, stakes)."
-Understand before extract (Wang 2023).
-
-# RULES
-Constraints. Edge cases. What NOT to do.
-- Granularity rules (one goal = one plotline)
-- Order rules (functions sequence)
-- "When in doubt" rules (don't create, don't invent)
-- Format-specific rules (procedural: 1 case_of_the_week; limited: all resolve)
-
-# OUTPUT
-JSON schema. Field names, types, enums.
-One worked example — full JSON for a real show (Breaking Bad S01).
-Reasoning BEFORE JSON output, not after (Wei 2022).
-
-# VALIDATION
-What code will check after your response. So you know:
-- what will be caught automatically (don't waste effort)
-- what code can't check (you must get right)
-Example: "Code checks: JSON schema, enum values, hero references cast ID.
-Code cannot check: whether Story DNA makes narrative sense — that's your job."
-```
-
-## Section-specific notes
-
-### ROLE
-- pass0: "You are determining the structural pattern of a TV series."
-- pass1: "You are a story editor identifying parallel storylines in a TV season."
-- pass2: "You are assigning events to storylines within a single episode."
-- pass3: "You are a narratologist reviewing the complete season structure."
-
-### GLOSSARY per pass
-- pass0: format, is_ensemble, is_anthology, story_engine, genre
-- pass1: Story DNA (hero, goal, obstacle, stakes), plotline, type, rank, nature, confidence, prior season status (CONTINUES/TRANSFORMED/ENDED)
-- pass2: event, function (7 functions + order rules), interaction (3 types), patch (4 types), also_affects
-- pass3: verdict (7 actions), weight, span, arc_completeness, monotonicity
-
-### VALIDATION per pass
-- pass0: format enum, is_ensemble bool, is_anthology bool, story_engine non-empty
-- pass1: type enum, rank enum, nature enum, confidence enum, hero → cast ID, A-rank count matches format
-- pass2: function enum, plotline → pass1 ID, characters → cast ID, interaction type enum, patch action enum
-- pass3: verdict action enum, MERGE/REASSIGN/PROMOTE/DEMOTE/CREATE/DROP/REFUNCTION field validation
-
-## References
-
-- Wang 2023, Plan-and-Solve: "first understand the problem and devise a plan"
-- Sainz 2024, GoLLIE: definitions with representative examples = strongest component
-- Qiu 2025, Blueprint First: code validation between LLM calls = +11.7pp
-- Wei 2022, Chain-of-Thought: reasoning before output
-- Zwaan 1993: genre label switches comprehension strategy
-- Anthropic docs: XML tags for section boundaries, queries at the bottom
-- tvplotlines-how-to-prompt.md: 10 principles for writing prompts
diff --git a/docs/knowledge/prompting/prompt-writing-rules.md b/docs/knowledge/prompting/prompt-writing-rules.md
deleted file mode 100644
index c216696..0000000
--- a/docs/knowledge/prompting/prompt-writing-rules.md
+++ /dev/null
@@ -1,38 +0,0 @@
----
-type: spec
-project: tvplotlines
-status: active
-tags: [prompt-engineering]
----
-
-# Prompt Writing Rules
-
-Lessons from rewriting pass0–pass3 prompts. Use as checklist for future prompts.
-
-## Process
-1. Glossary — ground truth. Definitions written once, prompts reference them.
-2. Original text — keep as much as possible. Change only what changed in logic.
-3. Every term defined before it is used.
-
-## Structure
-- ROLE → CONTEXT → GLOSSARY → TASK → RULES → OUTPUT → VALIDATION
-- GLOSSARY = definitions (what it means). TASK = steps (what to do). RULES = constraints (what not to do). Don't mix them.
-- No repeats between GLOSSARY and TASK. Definition lives in one place.
-
-## Role
-- One role for the whole pipeline: story editor.
-- Difference per pass — what the story editor is doing right now (reading first episodes / mapping the season / breaking down an episode / reviewing the full picture).
-
-## Language
-- How people talk, not how documentation reads. "Figure out" not "determine". "Pick the template" not "select the appropriate template".
-- No "See X above" — either repeat inline or don't reference.
-- Don't rewrite in your own words what's already well written in the original.
-
-## VALIDATION
-- Explicitly separate: what code checks (enum, references, schema) vs what LLM is responsible for (meaning, quality, completeness).
-- Business rules from GLOSSARY/RULES must be duplicated in VALIDATION (e.g. rank=null for runner).
-
-## Definitions
-- Concrete, not abstract. With examples and counter-examples.
-- Explain WHY (format → "tells us what plotlines to look for"), not just WHAT.
-- If an attribute is used downstream — say how (confidence → "inferred plotlines won't be flagged").
diff --git a/docs/knowledge/results/bb-s01-result.json b/docs/knowledge/results/bb-s01-result.json
deleted file mode 100644
index 54a1754..0000000
--- a/docs/knowledge/results/bb-s01-result.json
+++ /dev/null
@@ -1,1813 +0,0 @@
-{
-  "context": {
-    "franchise_type": "serial",
-    "story_engine": "A high school teacher builds a drug empire, testing how far he'll go for family and control",
-    "genre": "drama",
-    "format": "ongoing"
-  },
-  "cast": [
-    {
-      "id": "walt",
-      "name": "Walter White",
-      "aliases": [
-        "Walt",
-        "Heisenberg",
-        "Mr. White",
-        "Walter"
-      ]
-    },
-    {
-      "id": "jesse",
-      "name": "Jesse Pinkman",
-      "aliases": [
-        "Jesse"
-      ]
-    },
-    {
-      "id": "skyler",
-      "name": "Skyler White",
-      "aliases": [
-        "Skyler"
-      ]
-    },
-    {
-      "id": "hank",
-      "name": "Hank Schrader",
-      "aliases": [
-        "Hank"
-      ]
-    },
-    {
-      "id": "tuco",
-      "name": "Tuco Salamanca",
-      "aliases": [
-        "Tuco"
-      ]
-    },
-    {
-      "id": "walter_jr",
-      "name": "Walter White Jr.",
-      "aliases": [
-        "Walter Jr."
-      ]
-    },
-    {
-      "id": "marie",
-      "name": "Marie Schrader",
-      "aliases": [
-        "Marie"
-      ]
-    }
-  ],
-  "plotlines": [
-    {
-      "id": "empire",
-      "name": "Walt: Empire",
-      "driver": "walt",
-      "goal": "build a drug business to secure his family's financial future",
-      "obstacle": "inexperience in criminal world, dangerous partners like Tuco, moral boundaries",
-      "stakes": "death, loss of family, imprisonment",
-      "type": "serialized",
-      "rank": "A",
-      "nature": "plot-led",
-      "confidence": "solid",
-      "devices": [
-        "dramatic_irony"
-      ],
-      "span": [
-        "S01E01",
-        "S01E02",
-        "S01E03",
-        "S01E04",
-        "S01E05",
-        "S01E06",
-        "S01E07"
-      ]
-    },
-    {
-      "id": "family",
-      "name": "Walt: Family",
-      "driver": "walt",
-      "goal": "keep his family together while hiding his criminal activities",
-      "obstacle": "Skyler's growing suspicions, cancer treatment demands, maintaining double life",
-      "stakes": "family breakdown, exposure of criminal activities",
-      "type": "serialized",
-      "rank": "B",
-      "nature": "character-led",
-      "confidence": "solid",
-      "devices": [
-        "dramatic_irony"
-      ],
-      "span": [
-        "S01E01",
-        "S01E02",
-        "S01E03",
-        "S01E04",
-        "S01E05",
-        "S01E06",
-        "S01E07"
-      ]
-    },
-    {
-      "id": "investigation",
-      "name": "Hank: Investigation",
-      "driver": "hank",
-      "goal": "find the source of the high-purity blue methamphetamine",
-      "obstacle": "no direct leads, sophisticated chemistry suggests educated cook",
-      "stakes": "dangerous drugs flooding the streets, career advancement",
-      "type": "serialized",
-      "rank": "C",
-      "nature": "plot-led",
-      "confidence": "solid",
-      "devices": [
-        "dramatic_irony"
-      ],
-      "span": [
-        "S01E01",
-        "S01E02",
-        "S01E04",
-        "S01E05",
-        "S01E06",
-        "S01E07"
-      ]
-    },
-    {
-      "id": "survival",
-      "name": "Jesse: Survival",
-      "driver": "jesse",
-      "goal": "survive as Walt's partner in the dangerous drug trade",
-      "obstacle": "inexperience with violence, dangerous dealers like Tuco, Walt's demands",
-      "stakes": "death, imprisonment, continued beatings",
-      "type": "serialized",
-      "rank": "B",
-      "nature": "character-led",
-      "confidence": "solid",
-      "devices": [],
-      "span": [
-        "S01E01",
-        "S01E02",
-        "S01E03",
-        "S01E04",
-        "S01E06",
-        "S01E07"
-      ]
-    }
-  ],
-  "episodes": [
-    {
-      "episode": "S01E01",
-      "events": [
-        {
-          "event": "Walt works at the car wash to support his pregnant wife and disabled son",
-          "storyline": "family",
-          "function": "setup",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank shows off his gun at Walt's 50th birthday party and invites him on a DEA ride-along",
-          "storyline": "investigation",
-          "function": "setup",
-          "characters": [
-            "hank",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt spots Jesse escaping through a window during the meth lab bust",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt collapses at the car wash and is diagnosed with Stage III lung cancer",
-          "storyline": "family",
-          "function": "setup",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt proposes a meth cooking partnership to Jesse, threatening to turn him in to Hank",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse agrees to the partnership and purchases an old RV for a mobile lab",
-          "storyline": "survival",
-          "function": "setup",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt and Jesse cook their first batch, producing 99.1 percent pure methamphetamine",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Krazy-8 and Emilio arrive at the cook site, having followed Jesse",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "guest:krazy8",
-            "guest:emilio",
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Emilio recognizes Walt from the DEA ride-along and accuses Jesse of working with police",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "guest:emilio",
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Krazy-8 and Emilio force Walt and Jesse into the RV at gunpoint",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "guest:krazy8",
-            "guest:emilio",
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt creates phosphine gas to kill Emilio and incapacitate Krazy-8",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt drives the RV away with both bodies inside and crashes it into a ditch",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt records a video confession and farewell message to his family",
-          "storyline": "family",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt raises a gun toward approaching vehicles that turn out to be fire trucks",
-          "storyline": "empire",
-          "function": "cliffhanger",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "transformation through desperation",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "family",
-            "survival"
-          ],
-          "description": "all storylines explore how desperation transforms ordinary people into criminals",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "investigation"
-          ],
-          "description": "Hank unknowingly enables Walt's criminal career by taking him on the ride-along",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "survival"
-          ],
-          "description": "Walt's entry into the drug trade immediately puts both him and Jesse in mortal danger",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S01E02",
-      "events": [
-        {
-          "event": "Walt and Jesse return from the desert with the RV containing Emilio's body and unconscious Krazy-8",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse panics and blames Walt for the catastrophe",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt takes charge and assigns tasks for body disposal",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt and Jesse lock Krazy-8 in Jesse's basement with a bicycle lock",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt goes home and lies next to Skyler, hiding evidence",
-          "storyline": "family",
-          "function": "setup",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler notices Walt's strange behavior and presses him for answers",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt brings food and water to Krazy-8 and they have cautious conversations",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Krazy-8 tells Walt about his family's furniture business and how he fell into dealing",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt begins to feel sympathy for Krazy-8 and considers releasing him",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse dissolves Emilio's body in acid in a regular bathtub, ignoring Walt's instructions",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "The acid eats through the tub and floor, sending dissolved remains crashing through the ceiling",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt arrives at Jesse's house and is horrified by the destruction",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt makes Jesse clean up the gruesome mess",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt reconstructs a broken plate and discovers a large shard is missing",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt realizes Krazy-8 has concealed the plate shard as a weapon",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt confronts the agonizing knowledge that Krazy-8 will kill him if freed",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Krazy-8 lunges at Walt with the plate shard and Walt strangles him with the bicycle lock",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt sits on the floor weeping after killing Krazy-8",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt and Jesse bury the bodies in the desert",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Skyler grows more suspicious of Walt's absences",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt deflects Skyler's suspicions by claiming he takes long walks to process stress",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank mentions the DEA is investigating new high-purity meth on the streets",
-          "storyline": "investigation",
-          "function": "seed",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        }
-      ],
-      "theme": "the cost of crossing moral lines",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "survival",
-            "family"
-          ],
-          "description": "all storylines explore the moral compromises required to protect what matters most",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "family",
-            "investigation"
-          ],
-          "description": "the audience knows Walt is the source of the meth Hank is investigating and the reason for his strange behavior that worries Skyler",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S01E03",
-      "events": [
-        {
-          "event": "Walt tells Skyler about his lung cancer diagnosis",
-          "storyline": "family",
-          "function": "setup",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler researches treatment options and insists they fight aggressively",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt resists treatment, saying it will bankrupt the family",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Skyler tells Marie about Walt's diagnosis",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "marie"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank tries to offer Walt support but Walt shuts down emotional conversation",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Family holds intervention meeting urging Walt to pursue treatment",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "skyler",
-            "hank",
-            "marie",
-            "walter_jr",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walter Jr. passionately argues his father must fight",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walter_jr"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt agrees to chemotherapy due to family pressure",
-          "storyline": "family",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse tries to sell remaining meth without Krazy-8 as distributor",
-          "storyline": "survival",
-          "function": "setup",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse nearly gets robbed at biker bar while selling",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse realizes he cannot distribute alone and needs new connection",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt and Jesse meet to discuss distribution problems",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse suggests they need to establish territory with other dealers",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt learns chemotherapy costs thousands per session",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "family"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt calculates financial burden and hardens resolve to continue cooking",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler creates online fundraising page for Walt's treatment",
-          "storyline": "family",
-          "function": "resolution",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Marie shoplifts tiara and gives it to Skyler as baby shower gift",
-          "storyline": "family",
-          "function": "seed",
-          "characters": [
-            "marie"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the cost of survival",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "family",
-            "survival"
-          ],
-          "description": "all storylines explore different costs of survival — financial, emotional, and physical",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "family"
-          ],
-          "description": "Walt's cancer treatment costs directly motivate his continued drug cooking",
-          "subtype": null
-        }
-      ],
-      "patches": [
-        {
-          "action": "ADD_LINE",
-          "target": "marie_kleptomania",
-          "reason": "Marie's shoplifting behavior appears to be a recurring character trait that doesn't fit existing storylines",
-          "episodes": [
-            "S01E03"
-          ]
-        }
-      ]
-    },
-    {
-      "episode": "S01E04",
-      "events": [
-        {
-          "event": "Walt begins chemotherapy and hides the severe side effects from Skyler",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt snaps at a student at school due to chemo fatigue",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt's hair falls out and he decides to shave his head completely",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walter Jr. shaves his own head in solidarity with Walt",
-          "storyline": "family",
-          "function": "climax",
-          "characters": [
-            "walter_jr",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank and Gomez investigate the new blue methamphetamine in Albuquerque",
-          "storyline": "investigation",
-          "function": "setup",
-          "characters": [
-            "hank",
-            "guest:gomez"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "DEA traces the blue meth to a low-level dealer and discovers its high purity",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse reconnects with Badger and recruits him to sell meth on the street",
-          "storyline": "survival",
-          "function": "setup",
-          "characters": [
-            "jesse",
-            "guest:badger"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse confronts a rival dealer in a territorial standoff and wins by bluffing",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler discovers Marie's baby shower tiara was shoplifted",
-          "storyline": "family",
-          "function": "setup",
-          "characters": [
-            "skyler",
-            "marie"
-          ],
-          "also_affects": [
-            "family"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Skyler confronts Marie who denies shoplifting, fracturing their relationship",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "marie"
-          ],
-          "also_affects": [
-            "family"
-          ],
-          "devices": []
-        },
-        {
-          "event": "The sisters' conflict pulls Hank into the middle, straining both marriages",
-          "storyline": "family",
-          "function": "climax",
-          "characters": [
-            "hank",
-            "marie",
-            "skyler"
-          ],
-          "also_affects": [
-            "family"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt and Jesse cook a second batch in the desert RV",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse starts selling through Badger but the amounts are small with thin margins",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt calculates they need larger quantities and tells Jesse they need a real distributor",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the cost of deception",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "family",
-            "empire"
-          ],
-          "description": "both storylines explore the physical and emotional toll of Walt's choices - chemo weakening his body while his lies strengthen his criminal resolve",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "investigation",
-            "empire"
-          ],
-          "description": "Hank investigates the blue meth that Walt and Jesse are producing, unaware his brother-in-law is the chemist he's seeking",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "survival",
-            "empire"
-          ],
-          "description": "Jesse's street-level distribution efforts directly serve Walt's empire-building goals",
-          "subtype": null
-        }
-      ],
-      "patches": [
-        {
-          "action": "ADD_LINE",
-          "target": "marie_kleptomania",
-          "reason": "Marie's shoplifting subplot doesn't fit existing storylines - it's about her compulsive behavior affecting family dynamics",
-          "episodes": [
-            "S01E04"
-          ]
-        }
-      ]
-    },
-    {
-      "episode": "S01E05",
-      "events": [
-        {
-          "event": "Skyler organizes a family gathering and invites Ted Beneke",
-          "storyline": "family",
-          "function": "setup",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt becomes uncomfortable and jealous of Ted's presence",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt overcompensates by drinking too much at the party",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt forces Walter Jr. to drink tequila until he vomits",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "walter_jr"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank confronts Walt and takes the bottle away",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler demands to know what is wrong with Walt beyond cancer",
-          "storyline": "family",
-          "function": "climax",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt offers no explanation to Skyler's questions",
-          "storyline": "family",
-          "function": "resolution",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse approaches Skinny Pete for introduction to Tuco",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Skinny Pete warns Jesse that Tuco is dangerously unpredictable",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse meets Tuco and presents Walt's blue meth sample",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Tuco tests the meth and is impressed by the quality",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "guest:tuco"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Tuco beats Jesse severely and steals the meth without paying",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "guest:tuco",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse calls Walt from the hospital, battered and humiliated",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt visits Jesse in the hospital and sees his injuries",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank and Gomez process Jesse's beating as drug-related assault",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse refuses to cooperate with police investigation",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt realizes they cannot be victims in the drug world",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt resolves to confront Tuco himself",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt takes remaining meth and prepares for meeting with Tuco",
-          "storyline": "empire",
-          "function": "cliffhanger",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the cost of respect and control",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "family"
-          ],
-          "description": "both storylines explore Walt's need to assert dominance and control when feeling emasculated or disrespected",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "family",
-            "investigation"
-          ],
-          "description": "Hank processes Jesse's beating as a drug crime while being unaware that Walt is connected to it",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "investigation"
-          ],
-          "description": "Jesse's beating brings Walt's criminal world into contact with Hank's law enforcement world",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S01E06",
-      "events": [
-        {
-          "event": "Walt synthesizes mercury fulminate explosive disguised as meth",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt drives alone to Tuco's headquarters",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt introduces himself as Heisenberg to Tuco",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "tuco"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Tuco laughs and threatens Walt over payment demands",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "tuco",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt throws mercury fulminate crystal, causing explosion",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Tuco agrees to pay for stolen meth and buy future batches",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "tuco",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt returns home with cash and has aggressive sex with Skyler",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "DEA identifies blue meth as extremely pure with advanced chemistry signature",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank presents findings suggesting cook has advanced chemistry training",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "DEA investigation focuses on known drug operations but finds no match",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler notices Walt carrying extra cash and behaving erratically",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt fabricates poker game story to explain cash and behavior",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse learns Walt made deal with Tuco and is unnerved by transformation",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt and Jesse agree to cook Tuco's order immediately",
-          "storyline": "empire",
-          "function": "seed",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the intoxication of power",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "family"
-          ],
-          "description": "Walt's newfound power in the drug world transforms his behavior at home, showing how criminal success bleeds into personal relationships",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "investigation"
-          ],
-          "description": "Hank correctly deduces the cook has advanced chemistry training while Walt sits at his dinner table",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "family",
-            "empire"
-          ],
-          "description": "Skyler senses something is wrong but doesn't know Walt just confronted a violent drug dealer",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S01E07",
-      "events": [
-        {
-          "event": "Walt and Jesse cook Tuco's two-pound order in the RV, working through the night",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt refuses to cut corners despite Jesse's urge to rush, yielding their purest batch yet",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Tuco tests the product, declares it excellent, and pays fifty thousand dollars",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse",
-            "tuco"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Tuco demands double the quantity for the next delivery on a tighter schedule",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "tuco",
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt hesitates but agrees, recognizing refusing Tuco is not realistic",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Skyler discovers a second cell phone hidden in Walt's belongings",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler confronts Walt about the phone, Walt claims it was a forgotten replacement",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler begins quietly investigating Walt, checking phone records and tracking absences",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank celebrates his DEA promotion at family dinner",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "walt",
-            "skyler",
-            "walter_jr",
-            "marie"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank describes the blue meth case disrupting the local drug economy",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt asks casual questions about the investigation that Hank answers without suspicion",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "hank"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt processes that the DEA is hunting his product and Hank is leading the effort",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire",
-            "family"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse tells Walt they should find another buyer after witnessing Tuco's volatility",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt argues that Tuco's volume and cash make him irreplaceable for now",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Tuco beats his own associate nearly to death over a minor slight",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "tuco",
-            "walt",
-            "jesse",
-            "guest:associate"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt and Jesse stand frozen, unable to intervene in the beating",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt and Jesse realize they are trapped with a man who could kill them on impulse",
-          "storyline": "survival",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt sits in his driveway staring at his house, family unaware of the danger",
-          "storyline": "family",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire",
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        }
-      ],
-      "theme": "the price of success",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "survival",
-            "family"
-          ],
-          "description": "all storylines explore how success brings new dangers — business growth traps Walt with Tuco, investigation success puts Hank closer to Walt, family suspicions grow with Walt's lies",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "investigation",
-            "empire",
-            "family"
-          ],
-          "description": "Walt sits at dinner listening to Hank describe hunting him while Skyler grows suspicious and the family celebrates Hank's promotion",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "survival"
-          ],
-          "description": "Tuco's demands merge Walt's business ambitions with immediate survival concerns",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    }
-  ],
-  "usage": "12 requests, 37,588 input + 13,008 output tokens, ~$0.322"
-}
\ No newline at end of file
diff --git a/docs/knowledge/results/bb-s02-result.json b/docs/knowledge/results/bb-s02-result.json
deleted file mode 100644
index 2c4dd58..0000000
--- a/docs/knowledge/results/bb-s02-result.json
+++ /dev/null
@@ -1,3194 +0,0 @@
-{
-  "context": {
-    "franchise_type": "serial",
-    "story_engine": "A high school teacher builds a drug empire, testing how far he'll go for family and control",
-    "genre": "drama",
-    "format": "ongoing"
-  },
-  "cast": [
-    {
-      "id": "walt",
-      "name": "Walter White",
-      "aliases": [
-        "Walt",
-        "Walter",
-        "Heisenberg",
-        "Mr. White"
-      ]
-    },
-    {
-      "id": "jesse",
-      "name": "Jesse Pinkman",
-      "aliases": [
-        "Jesse"
-      ]
-    },
-    {
-      "id": "skyler",
-      "name": "Skyler White",
-      "aliases": [
-        "Skyler"
-      ]
-    },
-    {
-      "id": "hank",
-      "name": "Hank Schrader",
-      "aliases": [
-        "Hank"
-      ]
-    },
-    {
-      "id": "walter_jr",
-      "name": "Walter White Jr.",
-      "aliases": [
-        "Walter Jr.",
-        "Flynn"
-      ]
-    },
-    {
-      "id": "marie",
-      "name": "Marie Schrader",
-      "aliases": [
-        "Marie"
-      ]
-    },
-    {
-      "id": "saul",
-      "name": "Saul Goodman",
-      "aliases": [
-        "Saul"
-      ]
-    },
-    {
-      "id": "gus",
-      "name": "Gustavo Fring",
-      "aliases": [
-        "Gus"
-      ]
-    },
-    {
-      "id": "jane",
-      "name": "Jane Margolis",
-      "aliases": [
-        "Jane"
-      ]
-    },
-    {
-      "id": "tuco",
-      "name": "Tuco Salamanca",
-      "aliases": [
-        "Tuco"
-      ]
-    },
-    {
-      "id": "combo",
-      "name": "Combo Ortega",
-      "aliases": [
-        "Combo"
-      ]
-    },
-    {
-      "id": "badger",
-      "name": "Badger Mayhew",
-      "aliases": [
-        "Badger"
-      ]
-    },
-    {
-      "id": "skinny_pete",
-      "name": "Skinny Pete",
-      "aliases": [
-        "Skinny Pete"
-      ]
-    }
-  ],
-  "plotlines": [
-    {
-      "id": "empire",
-      "name": "Walt: Empire",
-      "driver": "walt",
-      "goal": "build a massive drug operation to secure his family's financial future",
-      "obstacle": "dangerous partners like Tuco, distribution problems, professional competition",
-      "stakes": "death, imprisonment, family destruction",
-      "type": "serialized",
-      "rank": "A",
-      "nature": "plot-led",
-      "confidence": "solid",
-      "devices": [
-        "dramatic_irony"
-      ],
-      "span": [
-        "S02E01",
-        "S02E02",
-        "S02E03",
-        "S02E04",
-        "S02E05",
-        "S02E07",
-        "S02E08",
-        "S02E09",
-        "S02E10",
-        "S02E11",
-        "S02E12",
-        "S02E13"
-      ]
-    },
-    {
-      "id": "family",
-      "name": "Walt: Family",
-      "driver": "walt",
-      "goal": "maintain his marriage and family while hiding his criminal transformation",
-      "obstacle": "Skyler's growing suspicions, his own personality changes, mounting lies",
-      "stakes": "family breakdown, exposure of criminal activities",
-      "type": "serialized",
-      "rank": "B",
-      "nature": "character-led",
-      "confidence": "solid",
-      "devices": [
-        "dramatic_irony"
-      ],
-      "span": [
-        "S02E01",
-        "S02E02",
-        "S02E03",
-        "S02E04",
-        "S02E05",
-        "S02E06",
-        "S02E07",
-        "S02E08",
-        "S02E09",
-        "S02E10",
-        "S02E11",
-        "S02E13"
-      ]
-    },
-    {
-      "id": "survival",
-      "name": "Jesse: Survival",
-      "driver": "jesse",
-      "goal": "survive and profit in the drug trade while managing his crew",
-      "obstacle": "violent competitors, unreliable dealers, addiction, loss of friends",
-      "stakes": "death, imprisonment, complete destruction",
-      "type": "serialized",
-      "rank": "B",
-      "nature": "character-led",
-      "confidence": "solid",
-      "devices": [],
-      "span": [
-        "S02E02",
-        "S02E03",
-        "S02E04",
-        "S02E05",
-        "S02E06",
-        "S02E07",
-        "S02E08",
-        "S02E10",
-        "S02E11",
-        "S02E13"
-      ]
-    },
-    {
-      "id": "investigation",
-      "name": "Hank: Investigation",
-      "driver": "hank",
-      "goal": "capture Heisenberg and shut down the blue meth operation",
-      "obstacle": "lack of direct evidence, Heisenberg's careful methods, personal trauma from Tuco shooting",
-      "stakes": "dangerous drugs flooding the streets, career reputation",
-      "type": "serialized",
-      "rank": "C",
-      "nature": "plot-led",
-      "confidence": "solid",
-      "devices": [
-        "dramatic_irony"
-      ],
-      "span": [
-        "S02E01",
-        "S02E02",
-        "S02E03",
-        "S02E05",
-        "S02E07",
-        "S02E08"
-      ]
-    },
-    {
-      "id": "love",
-      "name": "Jesse: Love",
-      "driver": "jesse",
-      "goal": "build a relationship with Jane and escape his criminal life",
-      "obstacle": "his drug addiction, Jane's relapse, Walt's interference",
-      "stakes": "loss of love, deeper addiction, death",
-      "type": "serialized",
-      "rank": "B",
-      "nature": "character-led",
-      "confidence": "solid",
-      "devices": [
-        "twist"
-      ],
-      "span": [
-        "S02E11",
-        "S02E12",
-        "S02E13"
-      ]
-    }
-  ],
-  "episodes": [
-    {
-      "episode": "S02E01",
-      "events": [
-        {
-          "event": "Flash-forward shows hazmat suits collecting evidence at White residence with pink teddy bear in pool",
-          "storyline": "empire",
-          "function": "seed",
-          "characters": [],
-          "also_affects": null,
-          "devices": [
-            "flashforward"
-          ]
-        },
-        {
-          "event": "Walt and Jesse are held at gunpoint by Tuco after witnessing No-Doze's brutal murder",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse",
-            "tuco"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt and Jesse leave Tuco's compound recognizing he's too dangerous to work with or abandon",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse urges Walt to disappear but Walt insists they can't run because Tuco knows Jesse's identity",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt proposes poisoning Tuco with ricin as their solution",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt synthesizes ricin from castor beans in Jesse's kitchen",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt conceals ricin inside a bag of meth for their next exchange with Tuco",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler confronts Walt about his erratic absences and odd behavior, demanding honesty",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt deflects Skyler's concerns with vague reassurances",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank and Gomez identify Tuco as prime suspect in blue meth distribution",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "guest:gomez"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "DEA escalates surveillance on Tuco based on intelligence about his violence and large purchases",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt and Jesse prepare for meeting with Tuco, hiding ricin-laced meth in separate bag",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Tuco reveals Gonzo died trying to move No-Doze's body when cars collapsed on him",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "tuco"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Tuco blames Walt and Jesse for bringing bad luck and forces them into his car at gunpoint",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "tuco",
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Tuco announces he's taking them to Mexico to cook for cartel and drives away with them as hostages",
-          "storyline": "empire",
-          "function": "cliffhanger",
-          "characters": [
-            "tuco",
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the illusion of control and escalating consequences",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "family",
-            "investigation"
-          ],
-          "description": "all storylines involve characters losing control despite their attempts to manage situations - Walt can't control Tuco, Skyler can't get truth from Walt, Hank closes in unknowingly on his brother-in-law",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "family",
-            "investigation"
-          ],
-          "description": "the audience knows Walt is Heisenberg while Skyler and Hank remain unaware, creating tension in their scenes",
-          "subtype": null
-        },
-        {
-          "type": "meta",
-          "lines": [],
-          "description": "flash-forward device frames the episode with future consequences",
-          "subtype": "flashforward"
-        }
-      ],
-      "patches": [
-        {
-          "action": "ADD_LINE",
-          "target": "flash_forward",
-          "reason": "flash-forward sequence doesn't advance any character's current goal but establishes future consequences",
-          "episodes": [
-            "S02E01"
-          ]
-        }
-      ]
-    },
-    {
-      "episode": "S02E02",
-      "events": [
-        {
-          "event": "Tuco drives Walt and Jesse to a remote desert shack where his uncle Hector waits in a wheelchair",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse",
-            "guest:tuco",
-            "guest:hector"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Tuco forces Walt to cook meth in the shack's crude kitchen while Walt secretly plots to use ricin",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "guest:tuco"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse prepares a burrito and stirs ricin-laced meth into it for Tuco",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hector rings his bell and knocks the poisoned plate off the table before Tuco can eat",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "guest:hector",
-            "guest:tuco"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Tuco beats Jesse severely and drags him outside after the failed poisoning",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "guest:tuco",
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Skyler calls Jesse's phone repeatedly when Walt doesn't come home, then contacts Hank in panic",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "hank"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank discovers Jesse's Monte Carlo with CAPNCOOK plates at Tuco's compound and traces the registration",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt tells Tuco that Jesse is useless and suggests letting him go, but Tuco refuses",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "guest:tuco"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse finds a gun hidden under the porch while bloodied from his beating",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse shoots Tuco in the abdomen and Tuco fires back, then Walt strikes Tuco with a rock",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "jesse",
-            "walt",
-            "guest:tuco"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank arrives at the shack and exchanges gunfire with wounded Tuco in the desert",
-          "storyline": "investigation",
-          "function": "climax",
-          "characters": [
-            "hank",
-            "guest:tuco"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank kills Tuco with a shot to the head",
-          "storyline": "investigation",
-          "function": "resolution",
-          "characters": [
-            "hank",
-            "guest:tuco"
-          ],
-          "also_affects": [
-            "investigation",
-            "empire",
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt and Jesse flee on foot into the desert before Hank can discover them",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival",
-            "family"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt and Jesse separate in the desert, each planning alibis for their disappearance",
-          "storyline": "family",
-          "function": "seed",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the price of survival",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "survival",
-            "investigation"
-          ],
-          "description": "all three storylines involve life-or-death stakes and the lengths people go to survive",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "investigation",
-            "family"
-          ],
-          "description": "Hank unknowingly saves Walt and Jesse by killing Tuco, while Skyler's panic inadvertently leads Hank to the scene",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "survival",
-            "investigation"
-          ],
-          "description": "all storylines physically converge at the desert shack for the climactic shootout",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S02E03",
-      "events": [
-        {
-          "event": "Walt strips naked in a convenience store, feigning a fugue state caused by his cancer",
-          "storyline": "family",
-          "function": "setup",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt is taken to the hospital and maintains the fugue story to doctors and Skyler",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler rushes to the hospital, relieved but deeply confused and doubtful",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Doctors run tests and find no neurological cause but acknowledge cancer stress could trigger dissociation",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank is placed on administrative leave pending review of the Tuco shooting",
-          "storyline": "investigation",
-          "function": "setup",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "DEA treats Hank as a hero, but he privately struggles with having killed a man",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank visits Walt in the hospital and doesn't question the fugue story",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "walt"
-          ],
-          "also_affects": [
-            "family"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse checks into a motel and calls Skinny Pete for a ride back to town",
-          "storyline": "survival",
-          "function": "setup",
-          "characters": [
-            "jesse",
-            "skinny_pete"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse discovers DEA searched his house and impounded his car",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse calls Walt furiously demanding to know what to do",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt coldly instructs Jesse to stay quiet and say nothing to anyone",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt assures Jesse the only link was the car with no evidence of their operation",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "DEA interviews Hector Salamanca about Tuco's death and operations",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hector refuses to cooperate or identify Walt and Jesse out of his code against informing",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "guest:hector"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt is released from hospital and returns home to family gathering",
-          "storyline": "family",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "skyler",
-            "walter_jr"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt sits through dinner performing normalcy while calculating his next move",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "family"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt keeps the ricin vial concealed in his jacket pocket",
-          "storyline": "empire",
-          "function": "seed",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the cost of deception",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "family",
-            "trauma",
-            "empire"
-          ],
-          "description": "all storylines explore different forms of psychological burden — Walt's lies, Hank's guilt, the weight of criminal life",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "family",
-            "empire",
-            "investigation"
-          ],
-          "description": "the audience knows Walt's fugue state is fake while Skyler and Hank believe it, and that Hector's silence protects Walt",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "trauma",
-            "investigation"
-          ],
-          "description": "Hank's emotional state from killing Tuco affects his ability to pursue the investigation",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S02E04",
-      "events": [
-        {
-          "event": "Jesse discovers his parents have changed the locks on his aunt's house",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse's parents inform him he's no longer welcome due to the DEA investigation",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "guest:jesse_parents"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse pleads with his parents but his father stands firm",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "guest:jesse_father"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse packs and leaves, beginning his homelessness spiral",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse crashes at Skinny Pete's place briefly",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "skinny_pete"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse moves through increasingly squalid locations, eventually sleeping in the RV",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse retrieves the RV by paying the towing fee with his remaining cash",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt tries to reestablish normal life but finds domestic environment suffocating",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler rebuffs Walt's intimacy attempts, sensing dishonesty in his fugue story",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler begins investigating Walt by checking phone records and credit card statements",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt returns to teaching where colleagues treat him with gentle sympathy",
-          "storyline": "family",
-          "function": "setup",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt contacts Jesse to discuss resuming meth operation but Jesse refuses",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse is robbed of his remaining cash at a shelter house",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "jesse",
-            "guest:robbers"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse visits his parents' home but his mother calls police and he flees",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "guest:jesse_mother"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt discovers his medical bills are mounting and insurance is inadequate",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "family"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Skyler suggests accepting financial help from Elliott and Gretchen",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt bristles at accepting help from Gray Matter but doesn't refuse",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "family"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse calls Walt and agrees to restart meth business as equal partners",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "desperation drives compromise",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "family",
-            "survival"
-          ],
-          "description": "all three storylines show characters forced into unwanted compromises by desperate circumstances",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "family",
-            "empire"
-          ],
-          "description": "Skyler investigates Walt's lies while the audience knows the truth about his criminal activities",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "survival"
-          ],
-          "description": "Jesse's homelessness crisis forces him back into partnership with Walt",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S02E05",
-      "events": [
-        {
-          "event": "Walt and Jesse resume cooking meth in the RV, producing a large quantity of blue product",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse proposes using Skinny Pete, Badger, and Combo as individual dealers",
-          "storyline": "survival",
-          "function": "setup",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt is skeptical of Jesse's street-level distribution plan but agrees",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse distributes meth to his three friends with price and deadline",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "skinny_pete",
-            "badger",
-            "combo"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skinny Pete is robbed at knifepoint by addicts who take his product and cash",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "skinny_pete"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skinny Pete returns to Jesse empty-handed and humiliated",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "skinny_pete",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse realizes his dealers need protection or will be victimized repeatedly",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt tells Jesse the distribution problem is his responsibility to handle",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank experiences a panic attack in the DEA elevator but hides it from colleagues",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Marie notices Hank's changed behavior and urges him to see a counselor",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "marie",
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank refuses counseling, insisting he is fine",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler arranges dinner with Elliott and Gretchen to discuss paying for Walt's treatment",
-          "storyline": "family",
-          "function": "setup",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt attends dinner seething with resentment at accepting charity from the Schwartzes",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "guest:elliott",
-            "guest:gretchen"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Elliott offers to cover all medical expenses and Walt accepts in the moment",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "guest:elliott"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt later tells Skyler he will not take the Schwartzes' money",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse buys a gun and practices intimidating persona in bathroom mirror",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt tells Jesse there are two types: those who get robbed and those who rob",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse resolves to control his territory through fear rather than trust",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the cost of control",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "survival",
-            "family",
-            "trauma"
-          ],
-          "description": "all storylines explore different costs of maintaining control — Walt's pride costs him help, Jesse's territory costs him innocence, Hank's facade costs him healing",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "family"
-          ],
-          "description": "Skyler believes Walt needs the Schwartzes' help while the audience knows he's making money from meth",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "survival"
-          ],
-          "description": "Walt's business philosophy directly influences Jesse's transformation into an enforcer",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S02E06",
-      "events": [
-        {
-          "event": "Jesse and Skinny Pete track down the meth addicts who robbed Skinny Pete",
-          "storyline": "survival",
-          "function": "setup",
-          "characters": [
-            "jesse",
-            "skinny_pete"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse goes to Spooge's house alone with his gun to confront the thieves",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse discovers a neglected five-year-old boy living in squalor",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse waits as Spooge attempts to crack open a stolen ATM",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse intermittently cares for the boy, adjusting his blanket and changing the TV",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt tells Skyler that Elliott and Gretchen are paying for his medical bills",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt begins aggressive chemotherapy that leaves him nauseous and exhausted",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler calls Gretchen to thank her, but Gretchen knows nothing about paying for treatment",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Spooge's wife pushes the ATM, crushing Spooge's head and killing him",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": [
-            "twist"
-          ]
-        },
-        {
-          "event": "Jesse calls 911 anonymously to report the child in danger",
-          "storyline": "survival",
-          "function": "resolution",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse leads the boy to safety on the front porch before fleeing",
-          "storyline": "survival",
-          "function": "resolution",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Word spreads that Jesse killed Spooge, enhancing his street reputation",
-          "storyline": "survival",
-          "function": "seed",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        }
-      ],
-      "theme": "the cost of protecting innocence",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "survival",
-            "family"
-          ],
-          "description": "both storylines explore protecting children — Jesse literally saves a boy, Walt claims to protect his family through lies",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "family"
-          ],
-          "description": "the audience knows Walt is lying about Elliott and Gretchen paying for treatment",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "survival"
-          ],
-          "description": "the audience knows Jesse didn't kill Spooge, but his reputation benefits from the misattribution",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S02E07",
-      "events": [
-        {
-          "event": "A narcocorrido music video depicts Heisenberg's rise and celebrates his blue meth",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "The DEA watches the Heisenberg video with amusement and concern",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank adds the Heisenberg case to his active investigations",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse expands his distribution network with Combo, Skinny Pete, and Badger working separate corners",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "combo",
-            "skinny_pete",
-            "badger"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse manages the operation with increasing confidence, collecting money and distributing batches",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt continues chemotherapy despite debilitating side effects and insists on cooking",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "family"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt and Jesse produce another large batch in the RV",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler contacts Gretchen directly and they meet for lunch",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "guest:gretchen"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gretchen is bewildered by Skyler's gratitude for supposed financial support",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "guest:gretchen",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler realizes Walt has been lying about who is paying for his treatment",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler confronts Walt indirectly with pointed questions about the Schwartzes",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt deflects with anger and storms out after the argument escalates",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt confronts Gretchen at her home, furious that she spoke with Skyler",
-          "storyline": "family",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "guest:gretchen"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt tells Gretchen his personal life is none of her business and severs the relationship",
-          "storyline": "family",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "guest:gretchen"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Two rival dealers begin encroaching on Combo's territory on the south side",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "combo",
-            "guest:rival_dealers"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Combo reports the territorial incursion to Jesse, who tells him to hold his ground",
-          "storyline": "survival",
-          "function": "seed",
-          "characters": [
-            "jesse",
-            "combo"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the price of reputation",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "family",
-            "survival"
-          ],
-          "description": "all storylines explore how reputation and success create new vulnerabilities — Walt's Heisenberg legend attracts DEA attention, his lies unravel his marriage, Jesse's crew faces territorial challenges",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "investigation"
-          ],
-          "description": "the audience knows Walt is Heisenberg while Hank investigates the very man he's hunting",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "family",
-            "empire"
-          ],
-          "description": "Skyler discovers Walt's lies about treatment funding but doesn't know the criminal source",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S02E08",
-      "events": [
-        {
-          "event": "Badger is arrested by an undercover DEA officer while selling meth on a park bench",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "badger"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank and Gomez process Badger's arrest and pressure him to identify his supplier",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Badger stalls but does not immediately give up Jesse's name",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "badger"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse panics when he learns of the arrest and tells Walt their operation is exposed",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt agrees that if Badger talks, the chain leads directly to them",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse contacts Saul Goodman, a flamboyant defense attorney from the criminal underworld",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse hires Saul to represent Badger",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Saul visits Badger in holding and assesses the situation",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "guest:saul"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Saul meets with Jesse and Walt and proposes hiring a decoy to pose as Heisenberg",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "guest:saul",
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Saul produces Jimmy In-N-Out, a petty criminal willing to take the fall for a fee",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "guest:saul"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt is skeptical but agrees to the plan when Saul demonstrates its legal plausibility",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Badger identifies Jimmy In-N-Out as his supplier during the sting operation",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "badger"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "The DEA arrests Jimmy In-N-Out, believing they have caught Heisenberg",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank is suspicious because the suspect does not match his Heisenberg profile",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Saul offers his ongoing services as a criminal lawyer to Walt and Jesse",
-          "storyline": "empire",
-          "function": "seed",
-          "characters": [
-            "guest:saul",
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Saul proposes connecting Walt with a professional distributor to replace Jesse's street network",
-          "storyline": "empire",
-          "function": "seed",
-          "characters": [
-            "guest:saul",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt is intrigued by Saul's distributor proposal but remains noncommittal",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler discovers Walt's second cell phone when it falls out of his bag",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler confronts Walt about the phone, and he lies that it's a work replacement",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler clearly does not believe Walt's lie about the phone",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        }
-      ],
-      "theme": "the price of protection",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "survival",
-            "family"
-          ],
-          "description": "all storylines involve characters trying to protect something valuable at increasing cost — Walt protects his operation and family through deception, Jesse protects his crew through criminal lawyers, Skyler tries to protect her marriage by confronting lies",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "investigation",
-            "family"
-          ],
-          "description": "the audience knows Walt is Heisenberg while Hank investigates him and Skyler suspects him without knowing the truth",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "survival"
-          ],
-          "description": "Badger's arrest forces Walt and Jesse's storylines to merge through their shared need for Saul's services",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S02E09",
-      "events": [
-        {
-          "event": "Walt receives test results showing his tumor has shrunk significantly and he is in remission",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt feels unsettling emptiness rather than relief about his remission",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt calculates his finances and realizes he has far less money saved than expected after expenses",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt determines he and Jesse need to cook a massive quantity to secure his family's financial future",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt proposes a marathon four-day cook session in the desert using the RV",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse agrees reluctantly, noting they are low on methylamine",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt purchases all the supplies they can afford and they drive the RV deep into the desert",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "The cook proceeds efficiently with Walt and Jesse falling into their established routine",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse accidentally drains the RV's battery by leaving the key in the ignition to power the radio",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt and Jesse realize they are stranded in the desert with no cell signal, no water supply, and climbing temperatures",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt attempts multiple failed solutions including jump-starting the battery and considering siphoning gasoline",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt and Jesse argue bitterly about whose fault the situation is, with Jesse blaming Walt for choosing such a remote location",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt collapses from heat, exhaustion, and his weakened post-chemo condition as dehydration sets in",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse becomes desperate and nearly gives up as their situation becomes dire",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt engineers a makeshift battery using coins, galvanized metal, and potassium hydroxide to generate enough current to start the engine",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "The RV starts and they drive back to Albuquerque with a full batch of meth and their lives barely intact",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt returns home and tells Skyler nothing of the ordeal",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse delivers the product and they now have enough meth to make a significant deal but still no large-scale distributor",
-          "storyline": "empire",
-          "function": "seed",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the cost of ambition",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "family"
-          ],
-          "description": "both storylines explore how Walt's remission paradoxically drives him deeper into crime rather than back to normalcy",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "family"
-          ],
-          "description": "Skyler believes Walt is recovering and their ordeal is ending, while the audience knows his remission is pushing him toward greater criminal ambition",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S02E10",
-      "events": [
-        {
-          "event": "Walt publicly announces his cancer remission at a family gathering organized by Skyler",
-          "storyline": "family",
-          "function": "setup",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt appears detached and restless rather than grateful during the celebration",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt buys Walt Jr. a Dodge Challenger without consulting Skyler",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "walter_jr"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler demands to know where the money came from, Walt brushes her off",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt drinks heavily at a pool party and forces Walt Jr. to drink tequila",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "walter_jr"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank intervenes and Walt challenges him aggressively over the drinking",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank physically takes the bottle away, Walt stares him down defiantly",
-          "storyline": "family",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt tells Jesse they should not rush to find a new distributor",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse argues that product sitting in storage is a liability, Walt dismisses the concern",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt encounters a young man buying meth-making supplies at the hardware store",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "guest:young_cook"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt threatens the young cook to stay out of his territory",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "guest:young_cook"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler tells Walt she no longer recognizes him, he insists he's the same person",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt and Skyler grow distant with silence at dinner and separate bedtimes",
-          "storyline": "family",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt stares at the ceiling unable to sleep, his appetite for power unchanged by remission",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "family"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "identity without excuse",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "family"
-          ],
-          "description": "both storylines explore how Walt's true nature emerges when the cancer excuse is removed",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "family"
-          ],
-          "description": "the audience knows Walt's reckless behavior stems from his drug empire success, while Skyler attributes it to cancer remission relief",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S02E11",
-      "events": [
-        {
-          "event": "Combo is shot and killed by a young boy while dealing on rival territory",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "combo"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse blames himself for Combo's death and is devastated by the loss",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse shuts down the street-level distribution network and tells Skinny Pete and Badger to stop dealing",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "jesse",
-            "skinny_pete",
-            "badger"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse spirals emotionally and begins using meth again, isolating himself",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "love"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt realizes their independent distribution model is fatally flawed",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt contacts Saul and asks him to arrange the meeting with the professional distributor",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "saul"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Saul warns Walt about the distributor's serious nature but makes the call",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "saul",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt waits at Los Pollos Hermanos but no one approaches him",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt returns the next day and again receives no contact",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt confronts Gus directly and asks if he is the distributor",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "gus"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus denies involvement and politely suggests Walt leave",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "gus",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt tells Saul the connection is a dead end",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "saul"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Saul advises patience, explaining Gus evaluates partners over time",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "saul",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse meets Jane Margolis, his new neighbor and landlord's daughter",
-          "storyline": "love",
-          "function": "setup",
-          "characters": [
-            "jesse",
-            "jane"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jane reveals she's an artist and recovering addict who attends NA meetings",
-          "storyline": "love",
-          "function": "setup",
-          "characters": [
-            "jane",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse and Jane begin a tentative friendship while Jesse hides his drug involvement",
-          "storyline": "love",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "jane"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler discovers Walt has been making calls to an unidentified number",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler's trust in Walt continues to erode but she doesn't act yet",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Gus investigates Walt's background through his own sources",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus sends word through Saul that he's willing to meet, but only with Walt",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "gus",
-            "saul"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the cost of independence",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "survival",
-            "love"
-          ],
-          "description": "all storylines explore the tension between independence and partnership — Walt needs Gus, Jesse needs to rebuild after going solo, Jesse and Jane both struggle with isolation in recovery",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "love",
-            "family"
-          ],
-          "description": "both Jane and Skyler are unaware of Jesse and Walt's true criminal involvement",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "survival"
-          ],
-          "description": "Combo's death forces both Walt and Jesse to confront the failure of their independent operation",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S02E12",
-      "events": [
-        {
-          "event": "Walt meets Gus at Los Pollos Hermanos for a formal business conversation",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "gus"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus explains he has verified Walt's product as exceptional but has reservations about Jesse as unreliable",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "gus",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus offers to buy Walt's entire stockpile for $1.2 million in a one-time deal with one-hour delivery deadline",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "gus",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt calls Jesse repeatedly but cannot reach him",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "love"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt finds Jesse in a drugged stupor with Jane, who has relapsed into heroin use",
-          "storyline": "love",
-          "function": "turning_point",
-          "characters": [
-            "jesse",
-            "jane"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt retrieves the meth himself and races to the drop point, barely making the deadline",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus's men complete the exchange and Walt receives $1.2 million in cash",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "guest:gus_men"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt brings Jesse's money but refuses to hand it over, saying he'll hold it until Jesse is sober",
-          "storyline": "love",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse accuses Walt of treating him like a child",
-          "storyline": "love",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jane encourages Jesse to demand his money and suggests they use it to start a new life together",
-          "storyline": "love",
-          "function": "escalation",
-          "characters": [
-            "jane",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse calls Walt and insists on receiving his share immediately, Walt refuses",
-          "storyline": "love",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jane calls Walt threatening to expose his drug operation if he doesn't hand over Jesse's money",
-          "storyline": "love",
-          "function": "turning_point",
-          "characters": [
-            "jane",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt agrees to deliver the cash under Jane's threat",
-          "storyline": "love",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt finds Jesse and Jane passed out from heroin use",
-          "storyline": "love",
-          "function": "setup",
-          "characters": [
-            "walt",
-            "jesse",
-            "jane"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt accidentally rolls Jane onto her back while trying to rouse Jesse",
-          "storyline": "love",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "jane"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jane begins to vomit and choke, Walt watches her asphyxiate instead of saving her",
-          "storyline": "love",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "jane"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "twist"
-          ]
-        },
-        {
-          "event": "Walt leaves the house as Jane's breathing stops",
-          "storyline": "love",
-          "function": "resolution",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the price of control",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "love"
-          ],
-          "description": "both storylines explore the lengths Walt will go to maintain control — over his business and over Jesse's choices",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "love"
-          ],
-          "description": "Jane's threat to expose Walt's operation forces the storylines to merge, culminating in her death",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "love"
-          ],
-          "description": "the audience knows Walt could save Jane but chooses not to, while Jesse remains unaware of Walt's role in her death",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S02E13",
-      "events": [
-        {
-          "event": "Jesse wakes up next to Jane's dead body and calls 911 in hysterics",
-          "storyline": "love",
-          "function": "climax",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Paramedics arrive and pronounce Jane dead from accidental overdose",
-          "storyline": "love",
-          "function": "resolution",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt arrives at Jesse's house feigning shock over Jane's death",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "love"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt arranges through Saul to have Jesse admitted to rehab",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "saul"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Mike cleans Jesse's house of drug evidence before police arrive",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "guest:mike"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Donald Margolis is destroyed by Jane's death and returns to work grief-stricken",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "guest:donald"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt undergoes surgery while Skyler drives him to the hospital",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt nearly confesses about his second phone while groggy from anesthesia",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler visits Walt after surgery with cold and distant manner",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse enters rehab to confront his addiction and grief over Jane",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "love"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt returns home and stares at his bag of cash in the crawl space",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Donald fails to issue correction causing midair collision of two planes",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "guest:donald"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashforward",
-            "callback"
-          ]
-        },
-        {
-          "event": "Pink teddy bear falls from plane wreckage into White family backyard",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [],
-          "also_affects": null,
-          "devices": [
-            "flashforward",
-            "callback"
-          ]
-        },
-        {
-          "event": "Walt watches news coverage of the plane crash that killed 167 people",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler tells Walt she wants him to move out",
-          "storyline": "family",
-          "function": "climax",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the devastating consequences of moral compromise",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "family",
-            "love"
-          ],
-          "description": "all storylines explore how Walt's choices destroy relationships and lives",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "family"
-          ],
-          "description": "the audience knows Walt caused Jane's death and the plane crash, but Skyler and Jesse don't",
-          "subtype": null
-        },
-        {
-          "type": "meta",
-          "lines": [
-            "empire"
-          ],
-          "description": "the plane crash serves as a metaphorical culmination of Walt's destructive impact",
-          "subtype": "callback"
-        }
-      ],
-      "patches": [
-        {
-          "action": "ADD_LINE",
-          "target": "consequences",
-          "reason": "Donald's grief and the plane crash represent a major consequence storyline that doesn't fit existing categories",
-          "episodes": [
-            "S02E13"
-          ]
-        }
-      ]
-    }
-  ],
-  "usage": "17 requests, 63,885 input + 23,502 output tokens, ~$0.448"
-}
\ No newline at end of file
diff --git a/docs/knowledge/results/bb-s03-result.json b/docs/knowledge/results/bb-s03-result.json
deleted file mode 100644
index 51c4ce4..0000000
--- a/docs/knowledge/results/bb-s03-result.json
+++ /dev/null
@@ -1,3249 +0,0 @@
-{
-  "context": {
-    "franchise_type": "serial",
-    "story_engine": "A high school teacher builds a drug empire, testing how far he'll go for family and control",
-    "genre": "drama",
-    "format": "ongoing"
-  },
-  "cast": [
-    {
-      "id": "walt",
-      "name": "Walter White",
-      "aliases": [
-        "Walt",
-        "Walter",
-        "Heisenberg",
-        "Mr. White"
-      ]
-    },
-    {
-      "id": "jesse",
-      "name": "Jesse Pinkman",
-      "aliases": [
-        "Jesse"
-      ]
-    },
-    {
-      "id": "skyler",
-      "name": "Skyler White",
-      "aliases": [
-        "Skyler"
-      ]
-    },
-    {
-      "id": "hank",
-      "name": "Hank Schrader",
-      "aliases": [
-        "Hank"
-      ]
-    },
-    {
-      "id": "walter_jr",
-      "name": "Walter White Jr.",
-      "aliases": [
-        "Walter Jr.",
-        "Flynn",
-        "Walt Jr."
-      ]
-    },
-    {
-      "id": "marie",
-      "name": "Marie Schrader",
-      "aliases": [
-        "Marie"
-      ]
-    },
-    {
-      "id": "saul",
-      "name": "Saul Goodman",
-      "aliases": [
-        "Saul"
-      ]
-    },
-    {
-      "id": "gus",
-      "name": "Gustavo Fring",
-      "aliases": [
-        "Gus",
-        "Gus Fring"
-      ]
-    },
-    {
-      "id": "gale",
-      "name": "Gale Boetticher",
-      "aliases": [
-        "Gale"
-      ]
-    },
-    {
-      "id": "mike",
-      "name": "Mike Ehrmantraut",
-      "aliases": [
-        "Mike"
-      ]
-    },
-    {
-      "id": "ted",
-      "name": "Ted Beneke",
-      "aliases": [
-        "Ted"
-      ]
-    },
-    {
-      "id": "andrea",
-      "name": "Andrea Cantillo",
-      "aliases": [
-        "Andrea"
-      ]
-    },
-    {
-      "id": "tomas",
-      "name": "Tomas Cantillo",
-      "aliases": [
-        "Tomas"
-      ]
-    },
-    {
-      "id": "leonel",
-      "name": "Leonel Salamanca",
-      "aliases": [
-        "Leonel"
-      ]
-    },
-    {
-      "id": "marco",
-      "name": "Marco Salamanca",
-      "aliases": [
-        "Marco"
-      ]
-    },
-    {
-      "id": "hector",
-      "name": "Hector Salamanca",
-      "aliases": [
-        "Hector"
-      ]
-    }
-  ],
-  "plotlines": [
-    {
-      "id": "empire",
-      "name": "Walt: Empire",
-      "driver": "walt",
-      "goal": "establish himself as Gus's lead chemist and secure his position in the superlab operation",
-      "obstacle": "Gus's manipulation and control, the threat of being replaced by Gale, cartel violence",
-      "stakes": "death, loss of financial security, family exposure",
-      "type": "serialized",
-      "rank": "A",
-      "nature": "plot-led",
-      "confidence": "solid",
-      "devices": [
-        "dramatic_irony"
-      ],
-      "span": [
-        "S03E02",
-        "S03E03",
-        "S03E04",
-        "S03E05",
-        "S03E06",
-        "S03E07",
-        "S03E08",
-        "S03E09",
-        "S03E10",
-        "S03E11",
-        "S03E12",
-        "S03E13"
-      ]
-    },
-    {
-      "id": "family",
-      "name": "Walt: Family",
-      "driver": "walt",
-      "goal": "maintain control over his family despite Skyler's knowledge of his crimes",
-      "obstacle": "Skyler's affair with Ted, divorce proceedings, restraining order",
-      "stakes": "complete family breakdown, loss of children, isolation",
-      "type": "serialized",
-      "rank": "B",
-      "nature": "character-led",
-      "confidence": "solid",
-      "devices": [
-        "dramatic_irony"
-      ],
-      "span": [
-        "S03E01",
-        "S03E02",
-        "S03E03",
-        "S03E04",
-        "S03E08",
-        "S03E09",
-        "S03E11",
-        "S03E13"
-      ]
-    },
-    {
-      "id": "survival",
-      "name": "Jesse: Survival",
-      "driver": "jesse",
-      "goal": "survive and profit in the drug trade while navigating his partnership with Walt",
-      "obstacle": "homelessness, inferior product quality, violent dealers, Gus's suspicion",
-      "stakes": "death, imprisonment, complete destruction",
-      "type": "serialized",
-      "rank": "B",
-      "nature": "plot-led",
-      "confidence": "solid",
-      "devices": [],
-      "span": [
-        "S03E01",
-        "S03E02",
-        "S03E03",
-        "S03E04",
-        "S03E05",
-        "S03E06",
-        "S03E07",
-        "S03E08",
-        "S03E09",
-        "S03E10",
-        "S03E11",
-        "S03E13"
-      ]
-    },
-    {
-      "id": "investigation",
-      "name": "Hank: Investigation",
-      "driver": "hank",
-      "goal": "track down the blue meth operation and its creators",
-      "obstacle": "panic attacks, career suspension, physical injuries from cartel attack",
-      "stakes": "career destruction, death, family safety",
-      "type": "serialized",
-      "rank": "B",
-      "nature": "plot-led",
-      "confidence": "solid",
-      "devices": [
-        "dramatic_irony"
-      ],
-      "span": [
-        "S03E01",
-        "S03E02",
-        "S03E03",
-        "S03E04",
-        "S03E05",
-        "S03E06",
-        "S03E07",
-        "S03E08",
-        "S03E09",
-        "S03E11"
-      ]
-    },
-    {
-      "id": "love",
-      "name": "Jesse: Love",
-      "driver": "jesse",
-      "goal": "build a genuine relationship with Andrea and protect her family",
-      "obstacle": "his criminal life, Andrea's brother's involvement with dealers, his own deception",
-      "stakes": "loss of love, Andrea's safety, moral corruption",
-      "type": "serialized",
-      "rank": "C",
-      "nature": "character-led",
-      "confidence": "solid",
-      "devices": [],
-      "span": [
-        "S03E09",
-        "S03E11",
-        "S03E12"
-      ]
-    },
-    {
-      "id": "control",
-      "name": "Gus: Control",
-      "driver": "gus",
-      "goal": "maintain absolute control over his drug operation and eliminate threats",
-      "obstacle": "Walt's unpredictability, cartel pressure, DEA investigation",
-      "stakes": "empire destruction, death, exposure",
-      "type": "serialized",
-      "rank": "B",
-      "nature": "plot-led",
-      "confidence": "solid",
-      "devices": [
-        "flashback"
-      ],
-      "span": [
-        "S03E01",
-        "S03E02",
-        "S03E03",
-        "S03E04",
-        "S03E05",
-        "S03E06",
-        "S03E07",
-        "S03E08",
-        "S03E09",
-        "S03E11",
-        "S03E12",
-        "S03E13"
-      ]
-    },
-    {
-      "id": "vengeance",
-      "name": "Salamanca Twins: Vengeance",
-      "driver": "leonel",
-      "goal": "kill Walter White to avenge Tuco's death",
-      "obstacle": "Gus's interference and redirection toward Hank",
-      "stakes": "family honor, their own lives",
-      "type": "serialized",
-      "rank": "C",
-      "nature": "plot-led",
-      "confidence": "solid",
-      "devices": [],
-      "span": [
-        "S03E01",
-        "S03E02",
-        "S03E03",
-        "S03E04",
-        "S03E07",
-        "S03E08"
-      ]
-    }
-  ],
-  "episodes": [
-    {
-      "episode": "S03E01",
-      "events": [
-        {
-          "event": "Leonel and Marco Salamanca pin Walt's sketch to a shrine and head north from Mexico",
-          "storyline": "vengeance",
-          "function": "setup",
-          "characters": [
-            "leonel",
-            "marco"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "People crawl on their bellies toward the shrine in the Mexican village",
-          "storyline": "vengeance",
-          "function": "setup",
-          "characters": [
-            "guest:villagers"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "Walt gives a tone-deaf statistical speech at the school assembly about the plane crash",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler demands a divorce from Walt after discovering his meth cooking",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt refuses to move out and insists he did everything for the family",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse is released from rehab and discovers his parents sold his aunt's house",
-          "storyline": "survival",
-          "function": "setup",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse checks into a motel with diminished cash and calls Walt who doesn't answer",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank receives a promotion to DEA's El Paso field office near the cartel border",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank publicly celebrates but privately shows anxiety from his Tuco encounter",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt throws pizza on the roof when Skyler locks him out, then enters through back door",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler takes the children and leaves for the night",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus monitors the situation from a distance through his network",
-          "storyline": "control",
-          "function": "setup",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "The Salamanca twins cross the border and execute immigrants who recognize them",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "leonel",
-            "marco"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt sits alone in the empty house, convinced he can hold his family together",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        }
-      ],
-      "theme": "the illusion of control and consequences",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "family",
-            "vengeance",
-            "control"
-          ],
-          "description": "all storylines explore how characters attempt to control situations that are spiraling beyond their grasp",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "family",
-            "vengeance"
-          ],
-          "description": "Walt believes he can control his family situation while deadly assassins hunt him",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "vengeance",
-            "empire"
-          ],
-          "description": "the twins' hunt for Walt will intersect with his drug operation",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S03E02",
-      "events": [
-        {
-          "event": "The Salamanca twins enter Walt's house with an axe and wait on his bed while he showers",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "leonel",
-            "marco"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Gus calls the twins away before they can kill Walt",
-          "storyline": "control",
-          "function": "escalation",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": [
-            "vengeance",
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt continues his morning routine, oblivious to the near-death experience",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler hires a divorce attorney",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt refuses to sign divorce papers and tells Walt Jr. that Skyler is breaking up the family",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "walter_jr"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt Jr. turns against Skyler after Walt's manipulation",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walter_jr",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler reveals she knows everything about Walt's meth operation and threatens to tell Hank",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt calls Skyler's bluff, betting she won't destroy the family's reputation",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse, broke and homeless, gets help from Saul to find a new duplex",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "saul"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse visits his old neighborhood and sees strangers in his aunt's former house",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank suffers a panic attack in the DEA elevator before his El Paso transfer",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank forces himself back to composure and tells no one about the panic attack",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "The Salamanca twins visit their paralyzed uncle Hector in the nursing home",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "leonel",
-            "marco",
-            "hector"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hector's rage confirms the twins' mission to kill Walt for Tuco's death",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "hector",
-            "leonel",
-            "marco"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus meets with the twins through his intermediary and counsels patience",
-          "storyline": "control",
-          "function": "escalation",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt attempts a family dinner with takeout, acting as if nothing has changed",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "walter_jr"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler returns home disgusted but sits down powerless to explain the truth",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt smiles, believing he is winning the standoff through attrition",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        }
-      ],
-      "theme": "the illusion of control",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "family",
-            "control",
-            "vengeance"
-          ],
-          "description": "all storylines explore different forms of control — Walt's manipulation of his family, Gus's orchestration of violence, and the twins' single-minded pursuit of revenge",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "vengeance"
-          ],
-          "description": "Walt is oblivious to how close he came to death while the audience witnessed the twins' near-attack",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "family",
-            "investigation"
-          ],
-          "description": "Skyler threatens to tell Hank the truth while the audience knows Hank is psychologically unraveling",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "control",
-            "vengeance"
-          ],
-          "description": "Gus directly intervenes in the twins' mission, showing his power over their revenge plot",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S03E03",
-      "events": [
-        {
-          "event": "Walt sleeps in the master bedroom while Skyler takes the couch, each refusing to yield ground",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler meets with her divorce attorney who explains Walt will likely get shared custody without admissible evidence",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler begins an affair with Ted Beneke at Beneke Fabricators",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "skyler",
-            "ted"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler tells Walt 'I fucked Ted' when he comes home",
-          "storyline": "family",
-          "function": "climax",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse tries to cook meth alone using Walt's formula but produces inferior product",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse sells low-quality meth through Skinny Pete, drawing complaints",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "guest:skinny_pete"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Saul approaches Walt with Gus's offer of three million for three months in the superlab",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "saul",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt declines Gus's offer, insisting he is done with the drug business",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank investigates a tip connecting the blue meth to local market, noting lower quality suggests copycat",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "The Salamanca twins acquire chrome axes, preparing to strike",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "leonel",
-            "marco"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus meets with the twins and persuades them to wait, promising to deliver Tuco's killer on his timeline",
-          "storyline": "control",
-          "function": "escalation",
-          "characters": [
-            "gus",
-            "leonel",
-            "marco"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt drives recklessly after Skyler's confession, nearly causing an accident, then sits gripping the steering wheel",
-          "storyline": "family",
-          "function": "resolution",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the illusion of control",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "family",
-            "empire",
-            "control",
-            "vengeance"
-          ],
-          "description": "all storylines explore control slipping away — Skyler takes control from Walt, Walt refuses control of the empire, Gus controls the twins' vengeance",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "investigation",
-            "empire"
-          ],
-          "description": "Hank investigates the blue meth without knowing Walt created the formula Jesse is copying",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "control",
-            "vengeance"
-          ],
-          "description": "Gus directly intervenes to control the twins' timeline for killing Walt",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S03E04",
-      "events": [
-        {
-          "event": "Walt confronts Ted Beneke at his office and makes a veiled threat",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "ted"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Security escorts Walt out of Ted's office",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt smashes a glass table in frustration at home",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt Jr. blames Skyler for provoking his father",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walter_jr",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler files a restraining order against Walt",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Police arrive to remove Walt from the house",
-          "storyline": "family",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt moves into a small condo apartment",
-          "storyline": "family",
-          "function": "resolution",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse sells his substandard meth and grows frustrated with the quality",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse visits Saul asking for new distribution contacts",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "saul"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Saul tells Jesse that Gus wants Walt and there's a place for Jesse if he brings Walt back",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "saul",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse dismisses the idea, insisting he can build his own business",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank picks a bar fight with two strangers to feel a rush of control",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "A bouncer pulls Hank off the strangers",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Marie notices Hank's behavioral changes and presses him",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "marie",
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank deflects Marie's concerns with jokes",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus invites Walt to tour the superlab",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "gus",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt sees the state-of-the-art equipment worth millions",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus appeals to Walt's pride, saying he should not hide from his gifts",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "gus",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt declines Gus's offer again but is visibly tempted",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus accepts the refusal calmly but tells Walt the offer stands",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "The Salamanca twins surveil Walt from a distance",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "leonel",
-            "marco"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus's associate redirects the twins' vengeance toward Hank instead of Walt",
-          "storyline": "control",
-          "function": "escalation",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": []
-        },
-        {
-          "event": "The twins accept Hank as their new target",
-          "storyline": "vengeance",
-          "function": "turning_point",
-          "characters": [
-            "leonel",
-            "marco"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt sits alone in his bare apartment, staring at the three-million-dollar napkin",
-          "storyline": "empire",
-          "function": "cliffhanger",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the cost of pride and isolation",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "family",
-            "survival",
-            "investigation"
-          ],
-          "description": "all storylines explore characters isolated by their pride and choices — Walt alone in his apartment, Jesse insisting on independence, Hank hiding his trauma",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "vengeance",
-            "investigation"
-          ],
-          "description": "the audience knows the twins now target Hank, but Hank remains unaware of the threat",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "control",
-            "vengeance"
-          ],
-          "description": "Gus manipulates the twins' vengeance to serve his control, redirecting them from Walt to Hank",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S03E05",
-      "events": [
-        {
-          "event": "Gus and Max pitch their blue meth to Don Eladio at his poolside estate",
-          "storyline": "control",
-          "function": "setup",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "Don Eladio orders Hector to execute Max as punishment for cooking without permission",
-          "storyline": "control",
-          "function": "escalation",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "Gus is forced to watch his partner die beside the pool",
-          "storyline": "control",
-          "function": "turning_point",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "Don Eladio spares Gus because of unexplained connections in Chile",
-          "storyline": "control",
-          "function": "seed",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "Gus invites Walt to dinner at his modest home and cooks a meal himself",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "gus",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus shares his philosophy that a man provides for his family even when not appreciated",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "gus",
-            "walt"
-          ],
-          "also_affects": [
-            "family"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt accepts Gus's offer of three months cooking for $15 million total",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt calls Jesse to inform him of the deal, but Jesse is angry and feels betrayed",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt visits the superlab for the first time as lead chemist and meets Gale",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "gale"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gale admires Walt's work, calling the blue meth the purest he has ever analyzed",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "gale"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt and Gale cook together and achieve 99.1 percent purity",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "gale"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank discovers the blue meth has returned at original purity, meaning the original cook is active",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse cooks his own batch in his duplex and begins selling through his crew",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the cost of providing",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "control",
-            "survival"
-          ],
-          "description": "all three storylines explore different aspects of providing and sacrifice — Walt providing for family through crime, Gus's decades-long quest for vengeance as providing justice for Max, Jesse providing for himself by going independent",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "investigation"
-          ],
-          "description": "Hank realizes the original cook is back just as Walt officially becomes Gus's lead chemist",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "survival"
-          ],
-          "description": "Walt's acceptance of Gus's offer directly creates Jesse's independent operation, setting up territorial conflict",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S03E06",
-      "events": [
-        {
-          "event": "Walt and Gale work together in the superlab, producing large quantities of blue meth with consistent purity",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "walt",
-            "gale"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt notices Gale is logging every step of the process in a personal notebook, learning to replicate the cook independently",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "gale"
-          ],
-          "also_affects": [
-            "control"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt realizes that once Gale masters the formula, Gus will no longer need Walt and could dispose of him",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "control"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt manufactures a complaint about Gale's performance, telling Gus that Gale is not up to standard and demands Jesse as his assistant",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "gus"
-          ],
-          "also_affects": [
-            "control",
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus, skeptical of Jesse's reliability, reluctantly agrees and reassigns Gale to another facility",
-          "storyline": "control",
-          "function": "escalation",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse accepts the offer and joins Walt in the superlab",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank's investigation leads him to the RV through records checks, tracing it to Jesse Pinkman",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank confronts Jesse at his duplex about the RV",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse calls Walt in a panic about Hank finding the RV",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt races to the junkyard where the RV is stored with Old Joe",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank follows Jesse's phone GPS to the junkyard and arrives as Walt hides inside the RV",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Old Joe blocks Hank from entering the RV by citing it as a domicile, requiring a warrant",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "guest:old_joe",
-            "hank"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt has Saul's secretary call Hank with a fake emergency about Marie being in a car accident",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank abandons the warrant and races to the hospital, giving Old Joe time to crush the RV",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Old Joe crushes the RV into a cube of scrap metal",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "guest:old_joe"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank arrives at the hospital, finds Marie perfectly fine, and realizes he has been tricked",
-          "storyline": "investigation",
-          "function": "climax",
-          "characters": [
-            "hank",
-            "marie"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Enraged Hank drives to Jesse's duplex, pounds on the door, and beats Jesse severely when he opens it",
-          "storyline": "investigation",
-          "function": "resolution",
-          "characters": [
-            "hank",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse calls 911 after being beaten by Hank",
-          "storyline": "survival",
-          "function": "resolution",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the price of survival",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "survival",
-            "investigation"
-          ],
-          "description": "all three storylines explore survival tactics — Walt manipulates to survive Gus's control, Jesse survives by partnering with Walt, Hank's investigation threatens everyone's survival",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "investigation",
-            "survival"
-          ],
-          "description": "the audience knows Walt is hiding in the RV while Hank searches for evidence just feet away",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "survival"
-          ],
-          "description": "Walt's manipulation to get Jesse as his partner serves both his empire goals and survival needs",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S03E07",
-      "events": [
-        {
-          "event": "Flashback shows young Hank receiving his first major bust commendation and calling Marie to celebrate",
-          "storyline": "investigation",
-          "function": "setup",
-          "characters": [
-            "hank",
-            "marie"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "Jesse lies in hospital with shattered face and tells his attorney he will press full charges against Hank",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank is suspended from DEA and forced to surrender gun and badge",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Marie pleads with Jesse through Saul to drop charges but Jesse refuses",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "marie",
-            "saul"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt visits Jesse and persuades him to settle for 50-50 partnership in superlab cook",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse agrees to drop charges in exchange for equal partnership with Walt",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire",
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank sinks into depression at home without work",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "ASAC Merkert warns Hank the assault charge could end his career permanently",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "guest:merkert"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Marie tries to support Hank but he pushes her away",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "marie"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus recognizes disgraced DEA agent is less dangerous and does nothing to intervene",
-          "storyline": "control",
-          "function": "escalation",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Salamanca twins acquire chrome-plated fire axes and plan attack on Hank",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "leonel",
-            "marco"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus anonymously tips off Hank with one-minute warning about the twins",
-          "storyline": "control",
-          "function": "turning_point",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": [
-            "investigation",
-            "vengeance"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Twins arrive and open fire on unarmed Hank in parking lot",
-          "storyline": "vengeance",
-          "function": "climax",
-          "characters": [
-            "leonel",
-            "marco",
-            "hank"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank uses SUV to ram Leonel, crushing his legs",
-          "storyline": "investigation",
-          "function": "climax",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Marco buries axe in Hank's back",
-          "storyline": "vengeance",
-          "function": "climax",
-          "characters": [
-            "marco",
-            "hank"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank finds Leonel's gun, loads hollow-point bullet, and shoots Marco through the head",
-          "storyline": "investigation",
-          "function": "climax",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Paramedics arrive to find Hank collapsed beside two cartel assassins",
-          "storyline": "investigation",
-          "function": "resolution",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "consequences and survival",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "investigation",
-            "vengeance",
-            "survival"
-          ],
-          "description": "all storylines explore how violence begets violence and the price of survival in a dangerous world",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "control",
-            "investigation",
-            "vengeance"
-          ],
-          "description": "Gus orchestrates events while Hank remains unaware of who is manipulating his fate",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "investigation",
-            "vengeance"
-          ],
-          "description": "the twins' quest for revenge directly collides with Hank's survival, creating the episode's climactic showdown",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S03E08",
-      "events": [
-        {
-          "event": "Walt, Jesse, Skyler, Walt Jr., and Marie rush to the hospital after learning Hank has been shot",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse",
-            "skyler",
-            "walter_jr",
-            "marie"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank undergoes surgery for multiple gunshot wounds and severe spinal injury",
-          "storyline": "investigation",
-          "function": "climax",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": [
-            "family"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Marie alternates between grief and rage, demanding answers from the DEA about the cartel hitmen",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "marie"
-          ],
-          "also_affects": [
-            "family"
-          ],
-          "devices": []
-        },
-        {
-          "event": "ASAC Merkert and the DEA team flood the hospital, launching a full investigation",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "guest:merkert"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt realizes the twins were hunting him and someone redirected them to Hank",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "control",
-            "vengeance"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt confronts Gus in the hospital parking lot about orchestrating the scenario",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "gus"
-          ],
-          "also_affects": [
-            "control"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus confirms he pointed the twins at Hank, then tipped Hank off to neutralize the cartel threat",
-          "storyline": "control",
-          "function": "climax",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": [
-            "empire",
-            "vengeance"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt realizes he is deeply in Gus's debt despite being horrified at using Hank as bait",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "control"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse cooks a batch alone at the superlab, achieving 96 percent purity",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse realizes he is more capable than he believed",
-          "storyline": "survival",
-          "function": "resolution",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Leonel Salamanca survives surgery but loses both legs",
-          "storyline": "vengeance",
-          "function": "resolution",
-          "characters": [
-            "leonel"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "DEA agents guard Leonel's room, hoping he will identify who sent him",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "guest:dea_agents"
-          ],
-          "also_affects": [
-            "control"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus visits Leonel posing as a Los Pollos Hermanos community representative",
-          "storyline": "control",
-          "function": "escalation",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike injects Leonel with a lethal substance when guards step away, killing him",
-          "storyline": "control",
-          "function": "resolution",
-          "characters": [
-            "mike",
-            "gus"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank wakes from surgery and learns he may never walk again",
-          "storyline": "investigation",
-          "function": "resolution",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": [
-            "family"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Marie holds Hank's hand as he stares at the ceiling",
-          "storyline": "family",
-          "function": "resolution",
-          "characters": [
-            "marie",
-            "hank"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt returns home alone, understanding the full scope of Gus's ruthlessness",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "control"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the price of power and protection",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "control",
-            "investigation",
-            "family"
-          ],
-          "description": "all storylines explore how protection comes at a devastating cost — Gus protects Walt by sacrificing Hank, Walt's family pays for his empire, Hank's investigation costs him his mobility",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "investigation",
-            "family"
-          ],
-          "description": "the family grieves for Hank not knowing Walt's crimes caused the attack",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "control",
-            "vengeance",
-            "empire"
-          ],
-          "description": "Gus's manipulation eliminates the Salamanca threat while binding Walt deeper into his operation",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S03E09",
-      "events": [
-        {
-          "event": "Hank lies conscious but paralyzed in his hospital bed, beginning physical rehabilitation",
-          "storyline": "investigation",
-          "function": "setup",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Marie pushes doctors for aggressive treatment and learns about expensive Colorado spinal therapy facility",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "marie"
-          ],
-          "also_affects": [
-            "family"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Marie brings the financial problem to Skyler about Hank's treatment costs",
-          "storyline": "family",
-          "function": "setup",
-          "characters": [
-            "marie",
-            "skyler"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Skyler proposes using Walt's drug money for Hank's treatment with gambling cover story",
-          "storyline": "family",
-          "function": "turning_point",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt agrees to fund Hank's recovery to keep family obligated and explain future cash",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler crafts detailed gambling narrative and rehearses Walt on specifics",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse and Walt cook together in the superlab but Jesse grows restless with routine",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse skims meth from each cook and hides it in his locker before weighing",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse sells stolen meth through Badger and Skinny Pete for independent revenue",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus's distribution manager notices blue meth appearing outside controlled channels",
-          "storyline": "control",
-          "function": "escalation",
-          "characters": [
-            "guest:distribution_manager"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Distribution manager reports unauthorized blue meth sales to Gus",
-          "storyline": "control",
-          "function": "escalation",
-          "characters": [
-            "guest:distribution_manager",
-            "gus"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse meets Andrea Cantillo at Narcotics Anonymous and begins spending time with her",
-          "storyline": "survival",
-          "function": "setup",
-          "characters": [
-            "jesse",
-            "andrea"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse learns Andrea has a young son named Brock and develops genuine feelings",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "andrea"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Andrea reveals her brother Tomas works as corner boy for dealers who killed Combo",
-          "storyline": "love",
-          "function": "turning_point",
-          "characters": [
-            "andrea",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse confronts reality that his drug profits destroy children in his community",
-          "storyline": "love",
-          "function": "climax",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the cost of choices",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "family",
-            "love",
-            "survival"
-          ],
-          "description": "all storylines explore how characters use others to justify their choices — Walt uses family obligation, Jesse uses profit motive, but both face the human cost",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "family",
-            "investigation"
-          ],
-          "description": "Skyler and Walt use drug money to help the DEA agent hunting them",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "survival",
-            "control"
-          ],
-          "description": "Jesse's independent operation threatens Gus's control, setting up future conflict",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S03E10",
-      "events": [
-        {
-          "event": "Walt becomes obsessed with a fly in the superlab and refuses to cook until it's eliminated",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse considers Walt's fly concern absurd but goes along with the hunt",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "They spend hours chasing the fly with makeshift tools and equipment",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse climbs equipment and nearly falls while hunting the fly",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt, exhausted and sleep-deprived, begins talking about the night Jane died",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt tells Jesse there's a moment when a person has gone too far",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse listens but doesn't understand the full weight of Walt's words",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse slips a sleeping pill into Walt's coffee to end the obsession",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt drowses on the lab floor while Jesse kills the fly",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse shows Walt the dead fly and they resume cooking",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "The batch is completed and meets purity standards",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt notices a discrepancy in the yield and suspects theft",
-          "storyline": "empire",
-          "function": "seed",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt watches Jesse with new suspicion but says nothing",
-          "storyline": "empire",
-          "function": "seed",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse drives home with stolen meth in his glove compartment",
-          "storyline": "survival",
-          "function": "seed",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt lies in bed staring at the ceiling where another fly lands",
-          "storyline": "empire",
-          "function": "seed",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "contamination and guilt",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "survival"
-          ],
-          "description": "both storylines explore contamination — Walt's obsession with the fly mirrors his guilt contaminating everything, while Jesse's theft contaminates their partnership",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "survival"
-          ],
-          "description": "the audience knows Walt let Jane die and that Jesse is stealing, while each character is unaware of what the other has done",
-          "subtype": null
-        },
-        {
-          "type": "meta",
-          "lines": [
-            "empire"
-          ],
-          "description": "the fly serves as a metaphor for Walt's guilt and the contamination of his moral boundaries",
-          "subtype": "metaphorical_device"
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S03E11",
-      "events": [
-        {
-          "event": "Jesse attends Narcotics Anonymous meetings to identify potential customers for stolen meth",
-          "storyline": "love",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse meets Andrea Cantillo at NA and initially targets her as a buyer",
-          "storyline": "survival",
-          "function": "setup",
-          "characters": [
-            "jesse",
-            "andrea"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse spends time with Andrea and her son Brock, developing genuine feelings",
-          "storyline": "love",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "andrea"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Andrea reveals her brother Tomas has been recruited as a corner boy by local dealers",
-          "storyline": "love",
-          "function": "turning_point",
-          "characters": [
-            "andrea",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse realizes Tomas is the child who killed Combo on the dealers' orders",
-          "storyline": "love",
-          "function": "climax",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt reviews lab logs and calculates someone has been skimming product",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt confronts Jesse about stealing meth to sell through Skinny Pete and Badger",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse admits to the theft and dismisses Walt's warnings about Gus",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Gus and Mike are already aware of the missing product but haven't acted",
-          "storyline": "control",
-          "function": "escalation",
-          "characters": [
-            "gus",
-            "mike"
-          ],
-          "also_affects": [
-            "empire",
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler coaches Walt on gambling cover story details for his drug money",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler presents gambling story to Hank and Marie to justify paying for therapy",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "hank",
-            "marie"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank accepts the gambling explanation without scrutiny due to his depression",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": [
-            "family"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse sees Tomas outside Andrea's apartment, confronting the reality of the child's situation",
-          "storyline": "love",
-          "function": "resolution",
-          "characters": [
-            "jesse",
-            "guest:tomas"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse sits in his car with his gun, contemplating action against the dealers",
-          "storyline": "survival",
-          "function": "cliffhanger",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "love"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the corruption of innocence",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "love",
-            "survival",
-            "family"
-          ],
-          "description": "all three storylines explore how criminal activity destroys innocent relationships and family bonds",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "control",
-            "empire",
-            "survival"
-          ],
-          "description": "Gus knows about Jesse's theft while Walt and Jesse remain unaware of being watched",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "family",
-            "investigation"
-          ],
-          "description": "Hank unknowingly accepts money from the criminal he's hunting to pay for his own recovery",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "love",
-            "survival"
-          ],
-          "description": "Jesse's romantic feelings for Andrea collide with the violent reality of his criminal world through Tomas",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S03E12",
-      "events": [
-        {
-          "event": "Mike tells Walt the story of the domestic violence call and the half measures",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "mike",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "Jesse buys a pistol and tells Walt he's going to kill the dealers",
-          "storyline": "love",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt pleads with Jesse to stand down and goes to Gus for a meeting",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "love"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus arranges a desert meeting with the dealers, Walt, Jesse, and Mike",
-          "storyline": "control",
-          "function": "escalation",
-          "characters": [
-            "gus",
-            "walt",
-            "jesse",
-            "mike"
-          ],
-          "also_affects": [
-            "empire",
-            "love"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt demands justice for Tomas but Gus sides with his dealers",
-          "storyline": "control",
-          "function": "turning_point",
-          "characters": [
-            "gus",
-            "walt"
-          ],
-          "also_affects": [
-            "empire",
-            "love"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse agrees to the truce under duress",
-          "storyline": "love",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "control"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse drives to the dealers' corner with his gun drawn",
-          "storyline": "love",
-          "function": "climax",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt's car slams into both dealers at full speed",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "love",
-            "control"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt shoots the surviving dealer in the head at point-blank range",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "love",
-            "control"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt tells Jesse to run and Jesse flees the scene",
-          "storyline": "love",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus receives word of the killings and realizes Walt is now an enemy",
-          "storyline": "control",
-          "function": "climax",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Mike drives to the scene to assess the damage",
-          "storyline": "control",
-          "function": "resolution",
-          "characters": [
-            "mike"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the cost of loyalty",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "love",
-            "control"
-          ],
-          "description": "all three storylines explore the consequences of choosing loyalty over pragmatism — Walt chooses Jesse over Gus, Jesse chooses vengeance for Tomas over survival, Gus must choose between his dealers and his operation",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "love",
-            "control"
-          ],
-          "description": "all storylines physically converge in the street confrontation where Walt's choice to save Jesse destroys his relationship with Gus",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "control"
-          ],
-          "description": "the audience understands that Walt's heroic gesture has actually doomed his position with Gus, while Walt believes he's solved the problem",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S03E13",
-      "events": [
-        {
-          "event": "Flashback shows Walt and Skyler touring their future house when Walt was still a Gray Matter partner",
-          "storyline": "family",
-          "function": "setup",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "Gus reinstates Gale in the superlab to learn Walt's cooking process",
-          "storyline": "control",
-          "function": "escalation",
-          "characters": [
-            "gus",
-            "gale"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt recognizes that Gale's presence means his death sentence",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt confronts Gus directly, arguing he and Jesse are indispensable",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "gus"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike begins following Walt and Jesse on Gus's orders",
-          "storyline": "control",
-          "function": "escalation",
-          "characters": [
-            "mike",
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "empire",
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt meets with Saul to discuss escape options via disappearer",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "saul"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt calculates the cost against family obligations and rejects escape",
-          "storyline": "family",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt concludes Gale must die to ensure his survival",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt approaches Jesse with the plan to kill Gale",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse recoils at killing innocent Gale, Walt argues it's them or Gale",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike picks up Walt at gunpoint and drives him to the superlab",
-          "storyline": "control",
-          "function": "escalation",
-          "characters": [
-            "mike",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus decides to kill Walt tonight and have Gale take over the lab",
-          "storyline": "control",
-          "function": "climax",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt pleads for one phone call to say goodbye to his family",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt calls Jesse and gives him Gale's address in coded language",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse drives across Albuquerque to Gale's apartment",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gale opens the door, recognizes something is wrong, and begs Jesse not to do this",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "jesse",
-            "gale"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse, crying, raises his gun and pulls the trigger",
-          "storyline": "survival",
-          "function": "cliffhanger",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire",
-            "control"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the corruption of innocence",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "family",
-            "survival",
-            "control"
-          ],
-          "description": "all storylines explore how far characters will go to protect what they value, corrupting their moral foundations",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "control"
-          ],
-          "description": "Mike and Victor believe Walt is calling his family, but the audience knows he's orchestrating Gale's murder",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "survival",
-            "control"
-          ],
-          "description": "all three storylines converge in the final moments as Jesse's action simultaneously saves Walt, destroys Gus's plan, and forces Jesse to cross a moral line",
-          "subtype": null
-        },
-        {
-          "type": "meta",
-          "lines": [
-            "family"
-          ],
-          "description": "the flashback serves as emotional counterpoint, showing Walt's lost innocence and potential",
-          "subtype": "flashback"
-        }
-      ],
-      "patches": []
-    }
-  ],
-  "usage": "17 requests, 63,748 input + 23,901 output tokens, ~$0.453"
-}
\ No newline at end of file
diff --git a/docs/knowledge/results/bb-s04-result.json b/docs/knowledge/results/bb-s04-result.json
deleted file mode 100644
index ee4c392..0000000
--- a/docs/knowledge/results/bb-s04-result.json
+++ /dev/null
@@ -1,3407 +0,0 @@
-{
-  "context": {
-    "franchise_type": "serial",
-    "story_engine": "A high school teacher builds a drug empire, testing how far he'll go for family and control",
-    "genre": "drama",
-    "format": "ongoing"
-  },
-  "cast": [
-    {
-      "id": "walt",
-      "name": "Walter White",
-      "aliases": [
-        "Walt",
-        "Walter",
-        "Heisenberg",
-        "Mr. White"
-      ]
-    },
-    {
-      "id": "jesse",
-      "name": "Jesse Pinkman",
-      "aliases": [
-        "Jesse"
-      ]
-    },
-    {
-      "id": "skyler",
-      "name": "Skyler White",
-      "aliases": [
-        "Skyler"
-      ]
-    },
-    {
-      "id": "hank",
-      "name": "Hank Schrader",
-      "aliases": [
-        "Hank"
-      ]
-    },
-    {
-      "id": "marie",
-      "name": "Marie Schrader",
-      "aliases": [
-        "Marie"
-      ]
-    },
-    {
-      "id": "gus",
-      "name": "Gustavo Fring",
-      "aliases": [
-        "Gus",
-        "Gus Fring"
-      ]
-    },
-    {
-      "id": "mike",
-      "name": "Mike Ehrmantraut",
-      "aliases": [
-        "Mike"
-      ]
-    },
-    {
-      "id": "saul",
-      "name": "Saul Goodman",
-      "aliases": [
-        "Saul"
-      ]
-    },
-    {
-      "id": "hector",
-      "name": "Hector Salamanca",
-      "aliases": [
-        "Hector"
-      ]
-    },
-    {
-      "id": "andrea",
-      "name": "Andrea Cantillo",
-      "aliases": [
-        "Andrea"
-      ]
-    },
-    {
-      "id": "brock",
-      "name": "Brock Cantillo",
-      "aliases": [
-        "Brock"
-      ]
-    },
-    {
-      "id": "ted",
-      "name": "Ted Beneke",
-      "aliases": [
-        "Ted"
-      ]
-    },
-    {
-      "id": "tyrus",
-      "name": "Tyrus Kitt",
-      "aliases": [
-        "Tyrus"
-      ]
-    },
-    {
-      "id": "don_eladio",
-      "name": "Don Eladio Vuente",
-      "aliases": [
-        "Don Eladio"
-      ]
-    },
-    {
-      "id": "gomez",
-      "name": "Steven Gomez",
-      "aliases": [
-        "Gomez"
-      ]
-    }
-  ],
-  "plotlines": [
-    {
-      "id": "survival",
-      "name": "Walt: Survival",
-      "driver": "walt",
-      "goal": "survive Gus's plan to replace and kill him",
-      "obstacle": "Gus's manipulation of Jesse, isolation from allies, lack of resources",
-      "stakes": "death, family exposure, complete defeat",
-      "type": "serialized",
-      "rank": "A",
-      "nature": "plot-led",
-      "confidence": "solid",
-      "devices": [
-        "dramatic_irony"
-      ],
-      "span": [
-        "S04E01",
-        "S04E02",
-        "S04E03",
-        "S04E04",
-        "S04E05",
-        "S04E06",
-        "S04E07",
-        "S04E08",
-        "S04E09",
-        "S04E10",
-        "S04E11",
-        "S04E12",
-        "S04E13"
-      ]
-    },
-    {
-      "id": "loyalty",
-      "name": "Jesse: Loyalty",
-      "driver": "jesse",
-      "goal": "find his place and purpose within Gus's organization",
-      "obstacle": "guilt over killing Gale, Walt's manipulation, conflicting allegiances",
-      "stakes": "identity, belonging, moral corruption",
-      "type": "serialized",
-      "rank": "B",
-      "nature": "character-led",
-      "confidence": "solid",
-      "devices": [],
-      "span": [
-        "S04E01",
-        "S04E02",
-        "S04E03",
-        "S04E04",
-        "S04E05",
-        "S04E06",
-        "S04E07",
-        "S04E09",
-        "S04E10",
-        "S04E12",
-        "S04E13"
-      ]
-    },
-    {
-      "id": "vengeance",
-      "name": "Gus: Vengeance",
-      "driver": "gus",
-      "goal": "destroy the cartel and complete his decades-long revenge",
-      "obstacle": "cartel's power, Walt's unpredictability, DEA investigation",
-      "stakes": "death, empire destruction, unfulfilled justice",
-      "type": "serialized",
-      "rank": "B",
-      "nature": "plot-led",
-      "confidence": "solid",
-      "devices": [
-        "flashback"
-      ],
-      "span": [
-        "S04E02",
-        "S04E07",
-        "S04E08",
-        "S04E10",
-        "S04E11",
-        "S04E13"
-      ]
-    },
-    {
-      "id": "investigation",
-      "name": "Hank: Investigation",
-      "driver": "hank",
-      "goal": "uncover the truth behind Gale's murder and the blue meth operation",
-      "obstacle": "physical disability, DEA bureaucracy, lack of direct evidence",
-      "stakes": "career vindication, public safety, family danger",
-      "type": "serialized",
-      "rank": "C",
-      "nature": "plot-led",
-      "confidence": "solid",
-      "devices": [
-        "dramatic_irony"
-      ],
-      "span": [
-        "S04E01",
-        "S04E02",
-        "S04E03",
-        "S04E04",
-        "S04E05",
-        "S04E06",
-        "S04E07",
-        "S04E08",
-        "S04E09",
-        "S04E11",
-        "S04E12",
-        "S04E13"
-      ]
-    },
-    {
-      "id": "laundering",
-      "name": "Skyler: Laundering",
-      "driver": "skyler",
-      "goal": "successfully launder Walt's drug money through the car wash",
-      "obstacle": "overwhelming cash volume, maintaining legitimate appearance, Ted's complications",
-      "stakes": "IRS exposure, family destruction, criminal prosecution",
-      "type": "serialized",
-      "rank": "B",
-      "nature": "plot-led",
-      "confidence": "solid",
-      "devices": [],
-      "span": [
-        "S04E01",
-        "S04E02",
-        "S04E03",
-        "S04E04",
-        "S04E05",
-        "S04E06",
-        "S04E07",
-        "S04E12"
-      ]
-    }
-  ],
-  "episodes": [
-    {
-      "episode": "S04E01",
-      "events": [
-        {
-          "event": "Gus arrives at the superlab where Walt and Jesse are held at gunpoint by Mike",
-          "storyline": "survival",
-          "function": "setup",
-          "characters": [
-            "gus",
-            "walt",
-            "jesse",
-            "mike"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus changes into work clothes without speaking to Walt or Jesse",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus slashes Victor's throat with a box cutter in front of Walt, Jesse, and Mike",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "gus",
-            "guest:victor"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus tells Walt and Jesse to get back to work after cleaning himself",
-          "storyline": "survival",
-          "function": "resolution",
-          "characters": [
-            "gus",
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt and Jesse dissolve Victor's body in hydrofluoric acid and clean the lab in stunned silence",
-          "storyline": "loyalty",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Skyler drives to Walt's condo and finds the door locked",
-          "storyline": "laundering",
-          "function": "setup",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler talks her way past the landlord claiming Walt may be injured inside",
-          "storyline": "laundering",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "guest:landlord"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler finds the condo empty and leaves repeated voicemails Walt cannot answer",
-          "storyline": "laundering",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt comes home visibly shaken but tells Skyler nothing about what happened",
-          "storyline": "laundering",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler presses forward with the car wash plan despite Walt's state, reminding him about Bogdan's refusal",
-          "storyline": "laundering",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank works obsessively from bed on the Gale Boetticher murder case",
-          "storyline": "investigation",
-          "function": "setup",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank examines Gale's notebook and finds chemistry notes suggesting a large-scale meth operation",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank tells Gomez that Gale may have been the cook behind the blue meth",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank",
-            "gomez"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse sits alone at Denny's restaurant staring blankly, deeply traumatized",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt visits Jesse and finds him in a fragile state",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt urges Jesse to hold himself together because Gus is looking for reasons to eliminate them",
-          "storyline": "loyalty",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt buys a snub-nosed revolver from a black-market dealer",
-          "storyline": "survival",
-          "function": "seed",
-          "characters": [
-            "walt",
-            "guest:dealer"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the price of survival",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "survival",
-            "loyalty",
-            "laundering"
-          ],
-          "description": "all three storylines explore what characters sacrifice to survive - Walt and Jesse their humanity, Skyler her moral boundaries",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "survival",
-            "investigation"
-          ],
-          "description": "Hank's theory that Gale was the mastermind actually protects Walt, while the audience knows Walt is the real target",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "survival",
-            "laundering"
-          ],
-          "description": "Skyler doesn't know Walt nearly died and is planning armed resistance while she pushes forward with money laundering",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S04E02",
-      "events": [
-        {
-          "event": "Walt purchases a .38 revolver and practices drawing it, rehearsing shooting Gus",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt goes to Los Pollos Hermanos asking to see Gus",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike intercepts Walt in the parking lot and takes his gun",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "mike"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike tells Walt that Gus will never put himself in a vulnerable position",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "mike"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt realizes direct confrontation is impossible and needs a different strategy",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse hosts a continuous party with drug users to avoid being alone with his thoughts",
-          "storyline": "loyalty",
-          "function": "setup",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse uses his meth earnings to keep the party running around the clock",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse sits in the chaos looking hollow and disconnected",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "When the house empties, Jesse immediately turns music back up and invites more people",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt visits Jesse to discuss strategy but sees he's in no condition to plan",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank redirects his frustration into investigating Gale's lab notes",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Marie patiently manages Hank's care while he treats her dismissively",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "marie",
-            "hank"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank asks Gomez to bring more evidence files from the Boetticher case",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "gomez"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Gomez reluctantly complies, noting the case is officially winding down",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "gomez"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler hires an environmental inspector to flag the car wash for contamination",
-          "storyline": "laundering",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler presents the contamination scheme to Walt as pressure to force Bogdan to sell",
-          "storyline": "laundering",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt is impressed by Skyler's resourcefulness but unsettled by her natural deception",
-          "storyline": "laundering",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike meets with Gus to discuss the Walt problem",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "mike",
-            "gus"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Gus tells Mike to be patient, signaling he has a longer-term plan",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Mike expresses concern that Walt and Jesse's instability increases exposure risk",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "mike"
-          ],
-          "also_affects": [
-            "survival",
-            "loyalty"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        }
-      ],
-      "theme": "the futility of control",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "survival",
-            "loyalty",
-            "laundering",
-            "control"
-          ],
-          "description": "all storylines explore characters trying to control their circumstances through increasingly desperate or deceptive means",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "survival",
-            "vengeance",
-            "investigation"
-          ],
-          "description": "the audience knows Gus and Mike are planning Walt's demise while Walt seeks strategy, and that Hank is investigating the very operation Walt runs",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "survival",
-            "loyalty"
-          ],
-          "description": "Walt's need for Jesse as an ally conflicts with Jesse's psychological breakdown after killing Gale",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S04E03",
-      "events": [
-        {
-          "event": "Marie visits open houses under false identities and steals small decorative items",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "marie"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Marie adopts elaborate fictional personas and tells invented stories to real estate agents",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "marie"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Marie attends multiple open houses in a single day, stealing with increasing boldness",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "marie"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "A real estate agent grows suspicious and confronts Marie, who deflects and leaves quickly",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "marie",
-            "guest:real_estate_agent"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler's environmental pressure tactic forces Bogdan to face potential regulatory scrutiny",
-          "storyline": "laundering",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler negotiates aggressively with Bogdan for the car wash sale",
-          "storyline": "laundering",
-          "function": "turning_point",
-          "characters": [
-            "skyler",
-            "guest:bogdan"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Bogdan agrees to sell the A1A Car Wash below his original asking price",
-          "storyline": "laundering",
-          "function": "climax",
-          "characters": [
-            "skyler",
-            "guest:bogdan"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt and Skyler officially own the car wash as their money laundering front",
-          "storyline": "laundering",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler begins studying how to run the legitimate car wash operation",
-          "storyline": "laundering",
-          "function": "seed",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse's house party continues with him handing out cash freely to anyone",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "A partygoer steals money from Jesse's drawer while Jesse doesn't notice or care",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "guest:partygoer"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt visits Jesse and grows alarmed at his deteriorating self-destructive behavior",
-          "storyline": "loyalty",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse refuses to engage with Walt about Gus or the lab work",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt cooks alone at the superlab because Jesse shows up late and impaired",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt tells Jesse their survival depends on flawless performance since Gus seeks any excuse to replace them",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse responds with indifference, saying Gus will kill them eventually regardless",
-          "storyline": "loyalty",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank finds a handwritten dedication to 'W.W.' in Gale's notebook",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank puzzles over the W.W. initials but doesn't connect them to Walt",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank casually mentions the W.W. notation to Marie as an interesting lead",
-          "storyline": "investigation",
-          "function": "seed",
-          "characters": [
-            "hank",
-            "marie"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        }
-      ],
-      "theme": "the illusion of control through self-destruction",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "control",
-            "loyalty",
-            "laundering"
-          ],
-          "description": "all three storylines show characters seeking control through destructive means — Marie through theft, Jesse through self-destruction, Skyler through criminal enterprise",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "investigation",
-            "survival"
-          ],
-          "description": "the audience knows Walt is W.W. and that Hank's discovery threatens Walt's survival, but Hank doesn't realize the connection",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "survival",
-            "loyalty"
-          ],
-          "description": "Jesse's self-destructive spiral directly threatens Walt's survival strategy with Gus",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S04E04",
-      "events": [
-        {
-          "event": "Hank discovers Gale's karaoke video singing 'Major Tom'",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank and Marie watch the video and find Gale endearing but telling",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "marie"
-          ],
-          "also_affects": [
-            "control"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank invites Walt and Skyler for dinner to discuss the case",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler rehearses the gambling cover story with Walt",
-          "storyline": "laundering",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler corrects Walt on details to keep their story airtight",
-          "storyline": "laundering",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank shows Walt Gale's lab notebook seeking his expert opinion",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "hank"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt downplays Gale's expertise, calling him a competent student not a genius",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt tells Hank the real mastermind is probably still out there",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt delivers the gambling cover story convincingly at dinner",
-          "storyline": "laundering",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank and Marie accept the gambling explanation without skepticism",
-          "storyline": "laundering",
-          "function": "resolution",
-          "characters": [
-            "hank",
-            "marie"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt's deflection reignites Hank's curiosity about the case",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse's house party winds down with guests stripping everything valuable",
-          "storyline": "loyalty",
-          "function": "setup",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse sits alone in his empty, trashed living room",
-          "storyline": "loyalty",
-          "function": "setup",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike arrives and orders Jesse to ride with him for pickups",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "mike",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike drives Jesse to various distribution points while Jesse sits doing nothing",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "mike",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse spots a man approaching with apparent hostile intent but it's just a routine delivery",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "guest:delivery_man"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt grows suspicious when Jesse mentions spending the day with Mike",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt confronts Jesse, warning him that Gus is manipulating him to replace Walt",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse dismisses Walt's concerns and calls him paranoid",
-          "storyline": "loyalty",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        }
-      ],
-      "theme": "the unintended consequences of deception",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "survival",
-            "laundering",
-            "loyalty"
-          ],
-          "description": "all three storylines involve characters trying to control narratives and information, but their actions create unexpected complications",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "survival",
-            "investigation"
-          ],
-          "description": "Walt's attempt to deflect suspicion from Gale actually reignites Hank's investigation, while Hank unknowingly seeks advice from the very criminal he's hunting",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "survival",
-            "loyalty"
-          ],
-          "description": "Walt correctly identifies Gus's manipulation of Jesse, but Jesse can't see it and views Walt as paranoid, not protective",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S04E05",
-      "events": [
-        {
-          "event": "Mike takes Jesse on money pickups across desert and rural New Mexico",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "mike",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "A man attacks Mike and Jesse, trying to steal the money bag",
-          "storyline": "loyalty",
-          "function": "turning_point",
-          "characters": [
-            "jesse",
-            "mike",
-            "guest:attacker"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse grabs the bag and drives away in Mike's car, saving the cash",
-          "storyline": "loyalty",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike dispatches the attacker and tells Jesse he handled himself well",
-          "storyline": "loyalty",
-          "function": "climax",
-          "characters": [
-            "mike",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse shows genuine engagement and energy for the first time since killing Gale",
-          "storyline": "loyalty",
-          "function": "resolution",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus observes from a distance, confirming the entire scenario was staged",
-          "storyline": "loyalty",
-          "function": "resolution",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Mike acknowledges to Gus that the plan is working to build Jesse's loyalty",
-          "storyline": "loyalty",
-          "function": "resolution",
-          "characters": [
-            "mike",
-            "gus"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt works alone in the superlab, unable to maintain production schedule",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt suspects Gus is deliberately separating him from Jesse to weaken his position",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt confronts Jesse, insisting the ride-alongs are manipulation to make him compliant",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse pushes back, saying someone finally treats him with respect instead of belittling him",
-          "storyline": "loyalty",
-          "function": "turning_point",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "The argument exposes the fracture: Walt sees Jesse as subordinate, Jesse sees Walt as controlling",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Skyler officially takes over A1A Car Wash operations, renaming it simply Car Wash",
-          "storyline": "laundering",
-          "function": "setup",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler studies the books and establishes systems for funneling Walt's drug money",
-          "storyline": "laundering",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler discovers Walt's cash volume far exceeds what the car wash can plausibly launder",
-          "storyline": "laundering",
-          "function": "turning_point",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler begins looking for ways to increase apparent revenue without drawing IRS attention",
-          "storyline": "laundering",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank takes his first steps with a walker in physical therapy",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank channels his frustration into the Boetticher case",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank asks Gomez to check industrial equipment purchases matching Gale's superlab notes",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "gomez"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Gomez pushes back saying the case isn't priority but agrees to run queries",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "gomez",
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "manipulation and genuine connection",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "loyalty",
-            "survival",
-            "laundering"
-          ],
-          "description": "all three storylines explore different forms of manipulation — Gus manipulating Jesse's loyalty, Walt trying to manipulate Jesse's perception, Skyler manipulating financial records",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "loyalty",
-            "survival"
-          ],
-          "description": "the audience knows Gus staged the attack to build Jesse's loyalty, while Walt correctly suspects manipulation but Jesse doesn't believe him",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "investigation",
-            "survival",
-            "laundering"
-          ],
-          "description": "Hank's investigation gets closer to Walt's operation while Walt and Skyler remain unaware of the threat",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S04E06",
-      "events": [
-        {
-          "event": "Walt tells Skyler someone at work is trying to kill him",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": [
-            "laundering"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Skyler suggests they use their money to disappear",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": [
-            "laundering"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt refuses to run, insisting he will not lose control",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler sends Holly and Walter Jr. to stay with Hank and Marie",
-          "storyline": "laundering",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt tries to recruit laundry workers to spy on Gus",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Laundry workers refuse and report Walt to Tyrus",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "tyrus"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Tyrus informs Gus of Walt's desperate recruitment attempt",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "tyrus",
-            "gus"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Mike assigns Jesse to collect payment from a skimming dealer",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "mike",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse successfully handles the confrontation and collects the money",
-          "storyline": "loyalty",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse earns Mike's quiet approval and develops working rapport",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "mike"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank visits the DEA office using a walking cane",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank examines Gale's evidence and finds Los Pollos Hermanos napkin",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank takes the evidence list home to study further",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler processes large batch of cash at the car wash",
-          "storyline": "laundering",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler realizes cash is accumulating faster than business can absorb",
-          "storyline": "laundering",
-          "function": "turning_point",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "isolation and desperation",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "survival",
-            "loyalty",
-            "laundering"
-          ],
-          "description": "all three storylines explore characters finding their place and purpose under pressure - Walt desperately trying to maintain control, Jesse finding his role in Gus's organization, Skyler taking control of what she can",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "survival",
-            "investigation"
-          ],
-          "description": "the audience knows Walt is Heisenberg and that Hank is getting closer to the truth through Gale's evidence, while neither character knows about the other's activities",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "recovery",
-            "investigation"
-          ],
-          "description": "Hank's physical recovery enables his return to investigative work, merging his personal and professional storylines",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S04E07",
-      "events": [
-        {
-          "event": "Jesse attends Narcotics Anonymous meeting and tells story of killing 'problem dog'",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse admits to the group he's really talking about killing a person",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse storms out when group won't judge him for the killing",
-          "storyline": "loyalty",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt asks Jesse to help kill Gus using ricin poison",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt argues Gus will kill them both once he finds replacement cook",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse agrees to carry ricin capsule but doesn't commit to using it",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse conceals ricin capsule inside marked cigarette",
-          "storyline": "survival",
-          "function": "setup",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank presents theory that Gale was murdered as part of larger drug operation",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank shows Walt Los Pollos Hermanos connection from Gale's effects",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt deflects Hank's theory while privately recognizing the danger",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Mike reports to Gus that Jesse is becoming reliable and loyal",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "mike",
-            "gus"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus approves bringing Jesse further in to make Walt expendable",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": [
-            "survival",
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Mike warns Gus that Walt is unpredictable and may act desperately",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "mike"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus increases surveillance on Walt through Tyrus",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Skyler tells Walt they need to discuss exit strategy",
-          "storyline": "laundering",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt refuses to elaborate on how he'll resolve Gus situation",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "laundering"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the burden of moral compromise",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "survival",
-            "loyalty",
-            "vengeance"
-          ],
-          "description": "all three storylines explore characters grappling with the moral weight of their choices - Jesse seeking judgment for killing Gale, Walt justifying murder as survival, Gus calculating human expendability",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "investigation",
-            "survival"
-          ],
-          "description": "Hank unknowingly shares his investigation progress with the very person he's hunting",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "survival",
-            "loyalty",
-            "vengeance"
-          ],
-          "description": "Walt's ricin plan forces Jesse to choose between his growing loyalty to Gus and his partnership with Walt, while Gus moves to eliminate Walt",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S04E08",
-      "events": [
-        {
-          "event": "Young Gus and Max meet with Don Eladio at his poolside estate to pitch a meth partnership",
-          "storyline": "vengeance",
-          "function": "setup",
-          "characters": [
-            "gus",
-            "don_eladio"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "Max explains the chemistry and profitability of meth over cocaine to Don Eladio",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "guest:max",
-            "don_eladio"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "Don Eladio takes offense at Gus and Max's presumptuousness in distributing samples without permission",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "don_eladio",
-            "gus"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "Hector mocks Gus's Chilean background and shows contempt for him",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "hector",
-            "gus"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "Hector shoots and kills Max at the poolside on Don Eladio's orders",
-          "storyline": "vengeance",
-          "function": "climax",
-          "characters": [
-            "hector",
-            "guest:max"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "Gus is forced to watch Max's execution and lies next to his body at the pool's edge",
-          "storyline": "vengeance",
-          "function": "resolution",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "Gus visits wheelchair-bound Hector at Casa Tranquila nursing home",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "gus",
-            "hector"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus informs Hector that the Salamanca family influence is finished and his nephews are dead",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "gus",
-            "hector"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank requests a DEA background check on Gustavo Fring",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "The background check on Gus comes back clean with no criminal record",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "ASAC Merkert warns Hank that Gus is a DEA friend and donor, telling him to drop the investigation",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "guest:merkert"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank agrees to back off officially but continues examining Gale's notes at home",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt grows anxious when Jesse reports he hasn't found an opportunity to use the ricin on Gus",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt presses Jesse to act quickly with the ricin, but Jesse insists he needs the right moment",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the weight of the past",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "vengeance",
-            "investigation",
-            "survival"
-          ],
-          "description": "all storylines deal with past actions driving present consequences — Gus's trauma motivates his revenge, Hank's investigation uncovers hidden history, Walt's past choices trap him in survival mode",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "investigation",
-            "survival",
-            "vengeance"
-          ],
-          "description": "the audience knows Gus's true nature and history while Hank sees only a clean businessman, and Walt doesn't understand the depth of Gus's long-term planning",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "survival",
-            "loyalty"
-          ],
-          "description": "Walt's desperation to survive increasingly conflicts with Jesse's growing loyalty to Gus's organization",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S04E09",
-      "events": [
-        {
-          "event": "Walt plants a GPS tracking device on Gus's car",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt monitors Gus's routine from his laptop and shares intel with Jesse",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt urges Jesse to use the ricin at the first opportunity",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse remains noncommittal about using the ricin",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus invites Jesse to dinner at his home and cooks Chilean fish stew",
-          "storyline": "loyalty",
-          "function": "turning_point",
-          "characters": [
-            "gus",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus tells Jesse he sees potential in him and that others have underestimated him",
-          "storyline": "loyalty",
-          "function": "turning_point",
-          "characters": [
-            "gus",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse has the ricin cigarette but chooses not to use it during dinner",
-          "storyline": "loyalty",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse leaves Gus's house without telling Walt about the dinner",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank discovers Gus's background prior to the 1980s is completely unverifiable",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank shares his findings with Gomez, who warns him to leave Gus alone",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "gomez"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank ignores the warning and requests additional records searches",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt discovers GPS data shows Gus was home when Jesse was unaccounted for",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt confronts Jesse and demands to know about his private meeting with Gus",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse admits to the dinner and Walt accuses him of switching sides",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse tells Walt that Gus treats him like a human being unlike Walt",
-          "storyline": "loyalty",
-          "function": "climax",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt and Jesse fight physically in Jesse's living room until both are bloodied",
-          "storyline": "loyalty",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse tells Walt to leave and not come back",
-          "storyline": "loyalty",
-          "function": "resolution",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt discovers an identical tracking device on his own car",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt realizes Gus knows everything about his surveillance",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        }
-      ],
-      "theme": "the illusion of loyalty",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "survival",
-            "loyalty",
-            "investigation"
-          ],
-          "description": "all three storylines explore different forms of betrayal and shifting allegiances — Walt's paranoia about Jesse's loyalty, Jesse's growing allegiance to Gus over Walt, and Hank's investigation threatening to expose hidden loyalties",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "survival",
-            "loyalty"
-          ],
-          "description": "the audience knows about Jesse's dinner with Gus before Walt does, and knows Walt is being tracked while he thinks he's the one doing the tracking",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "survival",
-            "loyalty"
-          ],
-          "description": "the storylines merge in the physical fight between Walt and Jesse, representing the complete breakdown of their partnership",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S04E10",
-      "events": [
-        {
-          "event": "Gus travels to Mexico with Jesse and Mike to meet the cartel",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "gus",
-            "jesse",
-            "mike"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse realizes he is the cook Gus is delivering to the cartel",
-          "storyline": "loyalty",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus coaches Jesse on what to expect and tells him to be confident",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "gus",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse takes command of the cartel lab, berating chemists for contaminated equipment",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "guest:benicio"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse demands the lab be cleaned to his standards before cooking",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse produces a batch testing at 96.2 percent purity, impressing Don Eladio",
-          "storyline": "loyalty",
-          "function": "climax",
-          "characters": [
-            "jesse",
-            "don_eladio"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Don Eladio tells Gus that Jesse will stay in Mexico permanently",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "don_eladio",
-            "gus"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus presents Don Eladio with poisoned Zafiro Añejo tequila at the poolside",
-          "storyline": "vengeance",
-          "function": "turning_point",
-          "characters": [
-            "gus",
-            "don_eladio"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "Gus drinks first to prove the tequila is safe, having taken precautions",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Don Eladio and his capos collapse and die from the poisoned tequila",
-          "storyline": "vengeance",
-          "function": "climax",
-          "characters": [
-            "gus",
-            "don_eladio"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus declares to Hector's allies that the cartel is finished",
-          "storyline": "vengeance",
-          "function": "resolution",
-          "characters": [
-            "gus",
-            "hector"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike is shot during the escape from the compound",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "mike"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse drives while Mike bleeds and Gus is weakened by poison",
-          "storyline": "loyalty",
-          "function": "climax",
-          "characters": [
-            "jesse",
-            "mike",
-            "gus"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse keeps both men alive during the chaotic drive to medical team",
-          "storyline": "loyalty",
-          "function": "resolution",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt cooks alone in the superlab, isolated and increasingly desperate",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        }
-      ],
-      "theme": "proving loyalty through capability",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "vengeance",
-            "loyalty"
-          ],
-          "description": "both storylines involve proving worth through decisive action — Gus through his ultimate revenge, Jesse through his competence under pressure",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "survival",
-            "vengeance",
-            "loyalty"
-          ],
-          "description": "Walt has no idea his fate is being decided in Mexico while he cooks alone",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "vengeance",
-            "loyalty"
-          ],
-          "description": "Jesse's demonstration of loyalty enables Gus's vengeance plan to succeed",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S04E11",
-      "events": [
-        {
-          "event": "Walt learns from news that Mexican cartel members are dead and suspects Gus was involved",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Gus returns to Albuquerque recovering from poisoning and resumes operations",
-          "storyline": "vengeance",
-          "function": "resolution",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt asks Jesse about Mexico trip but Jesse provides minimal information",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank cross-references Gale's lab notes with chemical suppliers and identifies Madrigal connection to Los Pollos Hermanos",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank asks Walt to drive him to Los Pollos Hermanos for lunch",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank asks Walt to plant GPS tracker on Gus's car while he waits in vehicle",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt reluctantly attaches the GPS device to Gus's car",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt warns Gus through phone call to check his car",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus summons Walt to desert where Tyrus blindfolds and drives him",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "gus",
-            "walt",
-            "tyrus"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Gus fires Walt and warns he'll kill Hank if Walt interferes with Jesse or contacts DEA",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "gus",
-            "walt"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt begs Gus to reconsider, arguing Hank is family investigating naturally",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt tells Skyler they need to disappear immediately",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt demands Saul contact identity provider, learns cost is $500,000 for family",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "saul"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt discovers crawl space nearly empty because Skyler gave money to Ted for IRS debt",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "laundering"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt lies in crawl space laughing hysterically then screaming as Marie calls about Hank being in danger",
-          "storyline": "survival",
-          "function": "cliffhanger",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        }
-      ],
-      "theme": "the price of protection",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "survival",
-            "investigation",
-            "laundering"
-          ],
-          "description": "all storylines involve characters trying to protect something — Walt protecting his life, Hank protecting justice, Skyler protecting their secret — but their protective actions create new dangers",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "survival",
-            "investigation"
-          ],
-          "description": "Walt is forced to help Hank investigate the very criminal he's warning, creating a deadly triangle of deception",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "survival",
-            "laundering"
-          ],
-          "description": "Skyler's money laundering protection directly undermines Walt's survival plan when he discovers the missing cash",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S04E12",
-      "events": [
-        {
-          "event": "Walt instructs Huell to steal Jesse's ricin cigarette and replace it with a regular one",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "saul"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt poisons Brock with Lily of the Valley berries from his backyard",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Brock falls seriously ill and is hospitalized with ricin-like symptoms",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "brock",
-            "andrea"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse rushes to the hospital when Andrea calls about Brock's condition",
-          "storyline": "loyalty",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "andrea"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse discovers the ricin cigarette is missing from his pack",
-          "storyline": "loyalty",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse concludes Gus poisoned Brock and goes to Walt's house with a gun",
-          "storyline": "loyalty",
-          "function": "climax",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt convinces Jesse that Gus orchestrated the poisoning to turn Jesse against Walt",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse agrees to help Walt kill Gus",
-          "storyline": "survival",
-          "function": "resolution",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank traces GPS data from Gus's car to Lavanderia Brillante laundry",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank tells Gomez the laundry may be the superlab site",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "gomez"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "DEA begins preliminary surveillance of the laundry",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "gomez"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler learns Ted was injured trying to flee instead of paying the IRS",
-          "storyline": "laundering",
-          "function": "climax",
-          "characters": [
-            "skyler",
-            "saul"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler sits silently in the car wash, horrified by the consequences of her actions",
-          "storyline": "laundering",
-          "function": "resolution",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse reveals Gus visits Hector at Casa Tranquila nursing home",
-          "storyline": "survival",
-          "function": "seed",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt realizes Hector's hatred of Gus presents an opportunity",
-          "storyline": "survival",
-          "function": "seed",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the corruption of innocence",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "survival",
-            "loyalty",
-            "laundering"
-          ],
-          "description": "all three storylines involve characters crossing moral lines to protect what they value — Walt poisons a child, Jesse is manipulated into betrayal, Skyler's money laundering leads to violence",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "survival",
-            "loyalty"
-          ],
-          "description": "the audience knows Walt poisoned Brock and manipulated Jesse, while Jesse believes Gus is responsible",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "survival",
-            "vengeance"
-          ],
-          "description": "Walt's plan to use Hector against Gus connects Walt's survival with Gus's vulnerability to his old enemy",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S04E13",
-      "events": [
-        {
-          "event": "Walt visits Hector at Casa Tranquila and proposes an alliance against Gus",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "hector"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt tells Hector that Gus killed Don Eladio and destroyed the cartel",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "hector"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hector agrees to Walt's plan by ringing his bell",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "hector"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt rigs a pipe bomb to Hector's wheelchair bell",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hector requests a DEA meeting through nursing home staff",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "hector"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank and Gomez visit Hector but he gives them nothing",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "gomez",
-            "hector"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hector spells out 'SUCK MY' and rings his bell in defiance",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "hector"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Tyrus sweeps Hector's room but doesn't check the wheelchair",
-          "storyline": "vengeance",
-          "function": "escalation",
-          "characters": [
-            "tyrus"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Gus enters and confronts Hector about what he told the DEA",
-          "storyline": "vengeance",
-          "function": "climax",
-          "characters": [
-            "gus",
-            "hector"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hector rings his bell and the bomb detonates, killing Hector, Tyrus, and Gus",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "hector",
-            "gus",
-            "tyrus"
-          ],
-          "also_affects": [
-            "vengeance"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gus walks out with half his face blown away, then collapses dead",
-          "storyline": "vengeance",
-          "function": "resolution",
-          "characters": [
-            "gus"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse learns of Gus's death while working at the superlab",
-          "storyline": "loyalty",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse and Walt destroy the superlab with chemicals and fire",
-          "storyline": "survival",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt calls Skyler and tells her 'I won'",
-          "storyline": "survival",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": [
-            "laundering"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hospital confirms Brock was poisoned by Lily of the Valley, not ricin",
-          "storyline": "loyalty",
-          "function": "resolution",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse accepts it was accidental and doesn't suspect Walt",
-          "storyline": "loyalty",
-          "function": "resolution",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Camera reveals Lily of the Valley plant in Walt's backyard",
-          "storyline": "survival",
-          "function": "seed",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "loyalty"
-          ],
-          "devices": [
-            "twist"
-          ]
-        },
-        {
-          "event": "Hank's investigation is validated by the explosion and discovery of Gus's empire",
-          "storyline": "investigation",
-          "function": "resolution",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the price of victory",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "survival",
-            "vengeance",
-            "loyalty"
-          ],
-          "description": "all three storylines explore how far characters will go to achieve their goals and what they sacrifice in the process",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "survival",
-            "loyalty"
-          ],
-          "description": "the audience knows Walt poisoned Brock to manipulate Jesse, but Jesse doesn't",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "survival",
-            "vengeance"
-          ],
-          "description": "Walt's survival plan and Gus's vengeance storyline literally converge in the explosion that kills both Hector and Gus",
-          "subtype": null
-        },
-        {
-          "type": "meta",
-          "lines": [
-            "survival"
-          ],
-          "description": "the final reveal of the Lily of the Valley plant reframes Walt's entire season arc",
-          "subtype": "twist-reveal"
-        }
-      ],
-      "patches": []
-    }
-  ],
-  "usage": "18 requests, 89,444 input + 25,852 output tokens, ~$0.560"
-}
\ No newline at end of file
diff --git a/docs/knowledge/results/bb-s05-result.json b/docs/knowledge/results/bb-s05-result.json
deleted file mode 100644
index 73d93f4..0000000
--- a/docs/knowledge/results/bb-s05-result.json
+++ /dev/null
@@ -1,4017 +0,0 @@
-{
-  "context": {
-    "franchise_type": "serial",
-    "story_engine": "A high school teacher builds a drug empire, testing how far he'll go for family and control",
-    "genre": "drama",
-    "format": "ongoing"
-  },
-  "cast": [
-    {
-      "id": "walt",
-      "name": "Walter White",
-      "aliases": [
-        "Walt",
-        "Walter",
-        "Heisenberg",
-        "Mr. White"
-      ]
-    },
-    {
-      "id": "jesse",
-      "name": "Jesse Pinkman",
-      "aliases": [
-        "Jesse"
-      ]
-    },
-    {
-      "id": "skyler",
-      "name": "Skyler White",
-      "aliases": [
-        "Skyler"
-      ]
-    },
-    {
-      "id": "hank",
-      "name": "Hank Schrader",
-      "aliases": [
-        "Hank"
-      ]
-    },
-    {
-      "id": "marie",
-      "name": "Marie Schrader",
-      "aliases": [
-        "Marie"
-      ]
-    },
-    {
-      "id": "mike",
-      "name": "Mike Ehrmantraut",
-      "aliases": [
-        "Mike"
-      ]
-    },
-    {
-      "id": "saul",
-      "name": "Saul Goodman",
-      "aliases": [
-        "Saul"
-      ]
-    },
-    {
-      "id": "lydia",
-      "name": "Lydia Rodarte-Quayle",
-      "aliases": [
-        "Lydia"
-      ]
-    },
-    {
-      "id": "todd",
-      "name": "Todd Alquist",
-      "aliases": [
-        "Todd"
-      ]
-    },
-    {
-      "id": "jack",
-      "name": "Jack Welker",
-      "aliases": [
-        "Jack"
-      ]
-    },
-    {
-      "id": "gomez",
-      "name": "Steven Gomez",
-      "aliases": [
-        "Gomez"
-      ]
-    },
-    {
-      "id": "declan",
-      "name": "Declan",
-      "aliases": [
-        "Declan"
-      ]
-    },
-    {
-      "id": "gretchen",
-      "name": "Gretchen Schwartz",
-      "aliases": [
-        "Gretchen"
-      ]
-    },
-    {
-      "id": "elliott",
-      "name": "Elliott Schwartz",
-      "aliases": [
-        "Elliott"
-      ]
-    }
-  ],
-  "plotlines": [
-    {
-      "id": "empire",
-      "name": "Walt: Empire",
-      "driver": "walt",
-      "goal": "build and control his own drug empire after eliminating Gus",
-      "obstacle": "law enforcement pressure, partner conflicts, cancer return, family resistance",
-      "stakes": "death, family destruction, legacy failure",
-      "type": "serialized",
-      "rank": "A",
-      "nature": "plot-led",
-      "confidence": "solid",
-      "devices": [
-        "dramatic_irony"
-      ],
-      "span": [
-        "S05E01",
-        "S05E02",
-        "S05E03",
-        "S05E04",
-        "S05E05",
-        "S05E06",
-        "S05E07",
-        "S05E08",
-        "S05E09",
-        "S05E10",
-        "S05E11",
-        "S05E12",
-        "S05E13",
-        "S05E14",
-        "S05E15",
-        "S05E16"
-      ]
-    },
-    {
-      "id": "investigation",
-      "name": "Hank: Investigation",
-      "driver": "hank",
-      "goal": "uncover and prosecute Heisenberg's true identity",
-      "obstacle": "personal connection to Walt, lack of official support, limited evidence",
-      "stakes": "career destruction, family betrayal, justice denied",
-      "type": "serialized",
-      "rank": "B",
-      "nature": "plot-led",
-      "confidence": "solid",
-      "devices": [
-        "dramatic_irony"
-      ],
-      "span": [
-        "S05E01",
-        "S05E02",
-        "S05E03",
-        "S05E04",
-        "S05E07",
-        "S05E08",
-        "S05E09",
-        "S05E10",
-        "S05E11",
-        "S05E12",
-        "S05E13",
-        "S05E14"
-      ]
-    },
-    {
-      "id": "guilt",
-      "name": "Jesse: Guilt",
-      "driver": "jesse",
-      "goal": "escape the moral weight of his crimes and find redemption",
-      "obstacle": "Walt's manipulation, blood money, inability to undo the past",
-      "stakes": "sanity, soul, complete moral destruction",
-      "type": "serialized",
-      "rank": "B",
-      "nature": "character-led",
-      "confidence": "solid",
-      "devices": [],
-      "span": [
-        "S05E01",
-        "S05E03",
-        "S05E05",
-        "S05E06",
-        "S05E08",
-        "S05E09",
-        "S05E11",
-        "S05E12",
-        "S05E14",
-        "S05E15",
-        "S05E16"
-      ]
-    },
-    {
-      "id": "protection",
-      "name": "Skyler: Protection",
-      "driver": "skyler",
-      "goal": "protect her children and herself from Walt's criminal world",
-      "obstacle": "Walt's refusal to leave, legal complicity, family loyalty",
-      "stakes": "children's safety, imprisonment, family annihilation",
-      "type": "serialized",
-      "rank": "B",
-      "nature": "character-led",
-      "confidence": "solid",
-      "devices": [],
-      "span": [
-        "S05E01",
-        "S05E03",
-        "S05E04",
-        "S05E08",
-        "S05E10",
-        "S05E11",
-        "S05E12",
-        "S05E13",
-        "S05E14",
-        "S05E15"
-      ]
-    },
-    {
-      "id": "survival",
-      "name": "Mike: Survival",
-      "driver": "mike",
-      "goal": "protect Gus's imprisoned associates and secure his own exit",
-      "obstacle": "frozen accounts, DEA pressure, Walt's recklessness",
-      "stakes": "death, betrayal of loyal men, legacy destruction",
-      "type": "serialized",
-      "rank": "C",
-      "nature": "plot-led",
-      "confidence": "solid",
-      "devices": [],
-      "span": [
-        "S05E02",
-        "S05E03",
-        "S05E04",
-        "S05E06",
-        "S05E07"
-      ]
-    }
-  ],
-  "episodes": [
-    {
-      "episode": "S05E01",
-      "events": [
-        {
-          "event": "Walt, Jesse, and Mike meet at junkyard to discuss laptop threat in APD evidence room",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "walt",
-            "jesse",
-            "mike"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Mike wants to flee but Walt insists he has a plan to destroy the evidence",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "mike"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt visits home where backyard is torn apart by investigators",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Skyler is terrified when Walt tells her 'I won' about Fring's murder",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt, Jesse, and Mike rent industrial electromagnet from Old Joe",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse",
-            "mike"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "They mount magnet in truck and drive to APD evidence room exterior wall",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse",
-            "mike"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt and Jesse activate magnet at full power, destroying metal evidence inside",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Truck tips over from magnetic force, trio abandons it and escapes",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "jesse",
-            "mike"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike protests they can't confirm laptop destruction, Walt says 'Because I say so'",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "mike"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Police discover evidence room wreckage, investigation pivots to mysterious event",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank notices broken picture frame revealed hidden Cayman Islands bank account numbers",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Saul reveals DEA seized Ted Beneke's assets after Huell and Kuby pressured him",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "saul",
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler visits hospitalized Ted who broke his neck fleeing Huell and Kuby",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Ted promises terrified Skyler he will say nothing about the money",
-          "storyline": "protection",
-          "function": "resolution",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt recovers ricin cigarette from Saul's office that Huell had lifted from Jesse",
-          "storyline": "guilt",
-          "function": "setup",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt hides real ricin vial behind electrical outlet plate in bedroom",
-          "storyline": "guilt",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt constructs fake ricin cigarette using salt and plants it in Jesse's Roomba",
-          "storyline": "guilt",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse finds fake cigarette, breaks down in tears of relief",
-          "storyline": "guilt",
-          "function": "climax",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse calls Walt to apologize for accusing him, Walt comforts him",
-          "storyline": "guilt",
-          "function": "resolution",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        }
-      ],
-      "theme": "the price of control",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "protection",
-            "guilt"
-          ],
-          "description": "all storylines explore control through deception — Walt controls through lies, Skyler tries to control damage, Jesse is controlled by Walt's manipulation",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "investigation"
-          ],
-          "description": "Walt's magnet plan inadvertently creates new evidence for Hank's investigation",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "guilt",
-            "empire"
-          ],
-          "description": "audience knows Walt is manipulating Jesse with the fake ricin cigarette while Jesse believes Walt's innocence",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S05E02",
-      "events": [
-        {
-          "event": "Peter Schuler kills himself with a defibrillator to avoid DEA questioning about Madrigal's ties to Fring",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "guest:schuler"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank and Gomez interrogate Mike about his ties to Fring's operation but lack evidence to hold him",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "gomez",
-            "mike"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt proposes to Mike and Jesse that they restart the meth business as equal partners",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "walt",
-            "mike",
-            "jesse"
-          ],
-          "also_affects": [
-            "guilt",
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Mike flatly refuses Walt's partnership proposal, saying he doesn't trust him",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "mike",
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "DEA freezes Fring's offshore accounts used for hazard pay to imprisoned associates",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "guest:dea_agents"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Mike visits imprisoned associates and promises money he cannot deliver",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "mike"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Lydia presents Mike with a list of eleven people to kill who could implicate her",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "lydia",
-            "mike"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Mike refuses to kill for Lydia and considers killing her instead",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "mike",
-            "lydia"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Dennis contacts Hank considering cooperation now that his hazard pay is gone",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "guest:dennis"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse argues to Mike that cooking again can generate cash to pay everyone and keep them quiet",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "jesse",
-            "mike"
-          ],
-          "also_affects": [
-            "survival",
-            "guilt"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt, Jesse, and Mike formally agree to a three-way partnership at Saul's office",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "jesse",
-            "mike",
-            "saul"
-          ],
-          "also_affects": [
-            "survival",
-            "guilt"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Mike demands hazard pay for Fring's men comes off the top, Walt reluctantly agrees",
-          "storyline": "survival",
-          "function": "resolution",
-          "characters": [
-            "mike",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Lydia pays Chris Mara to kill ten witnesses plus Mike",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "lydia",
-            "guest:chris"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Chris kills Chow and lures Mike to an ambush, but Mike anticipates and kills Chris",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "mike",
-            "guest:chris"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike spares Lydia because Jesse vouches that her Madrigal connections can supply methylamine",
-          "storyline": "survival",
-          "function": "resolution",
-          "characters": [
-            "mike",
-            "lydia",
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the price of loyalty",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "survival",
-            "investigation"
-          ],
-          "description": "all storylines explore loyalty — Walt demanding it from partners, Mike honoring it to Fring's men, Hank's loyalty to justice threatening the network",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "investigation",
-            "empire"
-          ],
-          "description": "Hank interrogates Mike not knowing he's questioning Walt's future partner",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "survival"
-          ],
-          "description": "Mike's need to pay Fring's men drives him to accept Walt's partnership proposal",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S05E03",
-      "events": [
-        {
-          "event": "Walt moves back into the White family home over Skyler's barely concealed objections",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Saul presents cooking venue options including tortilla and box factories",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "saul",
-            "walt",
-            "jesse",
-            "mike"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike vetoes each venue for security reasons",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "mike"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse suggests mobile cooking inside fumigation-tented houses using Vamonos Pest",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "The partners agree to use Vamonos Pest and meet Todd and the crew",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse",
-            "mike",
-            "guest:todd",
-            "guest:ira"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "The team successfully completes their first mobile cook in a tented house",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "jesse",
-            "mike",
-            "guest:todd"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike presents the revenue split with extensive deductions for hazard pay and overhead",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "mike"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt expresses displeasure at the modest profit shares after deductions",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt tells Jesse about Victor's death as a warning about overstepping",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Marie visits and pushes Skyler to explain her strange behavior",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "marie",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt invites Jesse for beer while Skyler isolates in the bedroom",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse",
-            "skyler"
-          ],
-          "also_affects": [
-            "guilt"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse tells Walt about breaking up with Andrea to protect her and Brock",
-          "storyline": "guilt",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler tells Walt she is waiting for his cancer to return",
-          "storyline": "protection",
-          "function": "climax",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank and DEA track Fring's money through Madrigal but face bureaucratic delays",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the cost of control",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "protection",
-            "survival"
-          ],
-          "description": "all storylines explore different costs of maintaining control — Walt's empire demands profit margins, Skyler's protection requires emotional endurance, Mike's survival needs financial resources",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "guilt"
-          ],
-          "description": "Walt references Victor's death as a warning to Mike, but Jesse doesn't understand that Walt poisoned Brock, making Jesse's guilt about protecting Andrea tragically ironic",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "survival"
-          ],
-          "description": "Mike's need to pay hazard pay directly conflicts with Walt's empire-building goals, setting up future confrontation",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S05E04",
-      "events": [
-        {
-          "event": "Skyler buys a birthday cake and arranges family dinner for Walt's 51st birthday",
-          "storyline": "protection",
-          "function": "setup",
-          "characters": [
-            "skyler",
-            "walt",
-            "hank",
-            "marie"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt dominates dinner conversation while Skyler barely functions",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler walks fully clothed into the pool and sinks to the bottom",
-          "storyline": "protection",
-          "function": "turning_point",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank and Marie pull Skyler from the pool",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "marie",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler demands the children leave for their safety, using her breakdown as leverage",
-          "storyline": "protection",
-          "function": "climax",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt refuses to send the children away, arguing no one is in danger",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "protection"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler tells Walt her only weapon is waiting for his cancer to return",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt agrees to send children to Hank and Marie under cover of Skyler needing rest",
-          "storyline": "protection",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt and Jesse continue cooking in fumigated houses with Vamonos Pest crew",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Lydia meets with Hank at DEA, presenting herself as cooperative Madrigal executive",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "lydia",
-            "hank"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Mike discovers DEA tracking device on his car",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "mike"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Mike warns Walt and Jesse that pressure is mounting from surveillance",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "mike",
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt dismisses Mike's concerns, confident in outmaneuvering law enforcement",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt removes his watch and tells Skyler this is just the beginning",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": [
-            "protection"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the illusion of control versus powerlessness",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "protection",
-            "survival"
-          ],
-          "description": "all storylines explore different forms of control — Walt's overconfidence, Skyler's desperate manipulation, Mike's cautious pragmatism",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "investigation"
-          ],
-          "description": "Lydia feeds information to Hank while secretly working for Walt; Hank doesn't know he's being manipulated",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "protection",
-            "investigation"
-          ],
-          "description": "Hank and Marie don't know the real reason they're taking the children is Walt's criminal activity",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S05E05",
-      "events": [
-        {
-          "event": "Lydia informs Walt, Jesse, and Mike about a thousand gallons of methylamine being transported by train",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "lydia",
-            "walt",
-            "jesse",
-            "mike"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "The team devises an elaborate plan to rob the train without detection by replacing methylamine with water",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse",
-            "mike"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Todd is brought in as a fourth crew member for the heist",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "todd"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt, Jesse, and Todd rehearse the train robbery operation",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse",
-            "todd"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Kuby stalls his truck on the railroad tracks, forcing the train to stop",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "guest:kuby"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt and Todd connect hoses to the tanker car while Jesse manages the pump system",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "todd",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Engineers radio for a second locomotive to push the stalled truck, creating time pressure",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "guest:engineers"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse barely escapes from under the moving tanker as the train accelerates",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "guilt"
-          ],
-          "devices": []
-        },
-        {
-          "event": "The crew celebrates successfully stealing all the methylamine they need",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "jesse",
-            "todd"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Todd spots Drew Sharp, a boy on a dirt bike who has been watching the heist",
-          "storyline": "guilt",
-          "function": "setup",
-          "characters": [
-            "todd",
-            "guest:drew_sharp"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Todd shoots Drew Sharp dead without hesitation",
-          "storyline": "guilt",
-          "function": "climax",
-          "characters": [
-            "todd"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "twist"
-          ]
-        },
-        {
-          "event": "Jesse screams at Todd in anguished shock over the boy's murder",
-          "storyline": "guilt",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "todd"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the cost of perfection",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "guilt"
-          ],
-          "description": "both storylines explore how the pursuit of a perfect crime leads to moral corruption and unintended consequences",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "guilt"
-          ],
-          "description": "the successful heist immediately transforms into Jesse's moral crisis when Todd kills the witness",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S05E06",
-      "events": [
-        {
-          "event": "Walt, Jesse, and Todd dissolve Drew Sharp's body and dirt bike in hydrofluoric acid",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse",
-            "todd"
-          ],
-          "also_affects": [
-            "guilt"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse is deeply shaken and barely speaks during the cleanup",
-          "storyline": "guilt",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike wants Todd gone as a liability, Walt argues Todd followed orders and they need him",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "mike"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Todd apologizes but shows no real remorse, explaining he acted to protect the operation",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "todd"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt and Mike reluctantly keep Todd on with a warning",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "mike"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse tells Walt he wants out of the business entirely, willing to walk away from millions",
-          "storyline": "guilt",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt delivers monologue about being bought out of Gray Matter for a pittance",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt refuses to let Jesse make the same mistake he made with Gray Matter",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse remains unmoved, saying the money means nothing against what they have done",
-          "storyline": "guilt",
-          "function": "climax",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike informs Walt and Jesse he also wants out",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "mike"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Mike proposes Declan's offer to buy their methylamine supply for fifteen million",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "mike"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt objects because selling the methylamine ends his cooking operation",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt meets Declan alone in the desert, surrounded by armed men",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "guest:declan"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt proposes Declan buy out Mike and Jesse but leave Walt his methylamine portion",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "guest:declan"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt forces Declan to acknowledge his reputation by demanding 'Say my name'",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "guest:declan"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Declan concedes and says 'Heisenberg', the deal is struck",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "guest:declan"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse receives five million dollars and walks away",
-          "storyline": "guilt",
-          "function": "resolution",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike receives five million and prepares to leave Albuquerque",
-          "storyline": "survival",
-          "function": "resolution",
-          "characters": [
-            "mike"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt begins cooking with Todd as his new assistant, quality drops without Jesse",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "todd"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt persists cooking alone, determined to build his empire",
-          "storyline": "empire",
-          "function": "seed",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the cost of ambition",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "guilt",
-            "survival",
-            "legacy"
-          ],
-          "description": "all storylines explore different responses to moral compromise — Walt doubles down on ambition, Jesse seeks escape through conscience, Mike seeks practical exit, Walt's legacy obsession drives his refusal to quit",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "survival",
-            "guilt"
-          ],
-          "description": "the methylamine deal forces all three partners to confront their different priorities and ultimately splits them apart",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S05E07",
-      "events": [
-        {
-          "event": "Walt cooks with Todd as his new assistant, but Todd's product only reaches 74 percent purity",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "todd"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt coaches Todd through the cooking process with frustrated patience",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "todd"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike instructs Saul's paralegal to continue hazard pay distributions to Fring's nine imprisoned associates",
-          "storyline": "survival",
-          "function": "setup",
-          "characters": [
-            "mike"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank and Gomez discover Dan Wachsberger making suspicious deposits into multiple accounts",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "gomez"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "DEA arrests Dan Wachsberger and he agrees to cooperate",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank",
-            "gomez"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Mike learns about Dan's arrest and realizes the imprisoned men will flip without hazard payments",
-          "storyline": "survival",
-          "function": "turning_point",
-          "characters": [
-            "mike"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Mike arranges to flee immediately and calls Saul to retrieve his go-bag from the airport",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "mike",
-            "saul"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt volunteers to deliver Mike's go-bag instead of Saul",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt demands the list of Fring's nine associates from Mike, claiming he needs it to arrange their silence",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "mike"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Mike refuses to give Walt the names and tells him he destroyed Fring's perfect operation with his ego",
-          "storyline": "survival",
-          "function": "escalation",
-          "characters": [
-            "mike",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt shoots Mike through the abdomen with Mike's own gun after being refused the names again",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "mike"
-          ],
-          "also_affects": [
-            "survival"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Mike drives away wounded, collapses by the riverbank, and dies telling Walt to shut up",
-          "storyline": "survival",
-          "function": "climax",
-          "characters": [
-            "mike",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt realizes he could have gotten the names from Lydia and stands over Mike's body processing the murder",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the cost of pride",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "survival"
-          ],
-          "description": "both storylines explore how pride and ego destroy carefully built systems and relationships",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "investigation",
-            "empire",
-            "survival"
-          ],
-          "description": "the audience knows Walt and Mike are connected to what Hank is investigating, but Hank doesn't",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "survival"
-          ],
-          "description": "Walt's need for control directly destroys Mike's exit strategy, culminating in murder",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S05E08",
-      "events": [
-        {
-          "event": "Walt dissolves Mike's body in acid inside a plastic barrel",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt obtains the list of Fring's nine imprisoned associates from Lydia",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "lydia"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt visits Jack Welker and commissions the murder of all nine men plus their lawyer",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jack"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Ten men are stabbed and burned to death across three prisons within two minutes",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank and the DEA are stunned as their entire case evaporates overnight",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt and Todd cook batch after batch in fumigated houses over three months",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "todd"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Lydia arranges international distribution to the Czech Republic through Madrigal",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "lydia"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler shows Walt the storage unit packed with uncountable money",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Skyler asks Walt how much money is enough",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt visits Jesse and they share an awkward conversation about their old RV",
-          "storyline": "guilt",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt learns from his oncologist that his cancer has returned",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt tells Skyler he is out of the business",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": [
-            "protection",
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank finds the Leaves of Grass book with Gale's inscription to W.W.",
-          "storyline": "investigation",
-          "function": "climax",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "callback"
-          ]
-        },
-        {
-          "event": "Hank flashes back to Walt joking that W.W. could stand for Walter White",
-          "storyline": "investigation",
-          "function": "climax",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback",
-            "callback"
-          ]
-        },
-        {
-          "event": "Hank sits stunned, finally connecting Walter White to Heisenberg",
-          "storyline": "investigation",
-          "function": "climax",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "twist"
-          ]
-        }
-      ],
-      "theme": "the illusion of completion",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "legacy",
-            "investigation"
-          ],
-          "description": "all storylines deal with endings that aren't really endings — Walt thinks he's finished, but his past catches up",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "empire",
-            "investigation"
-          ],
-          "description": "Walt believes he's eliminated all threats and can retire safely, while Hank discovers his true identity",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "investigation"
-          ],
-          "description": "Walt's past actions (the Gale book) directly lead to Hank's discovery",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S05E09",
-      "events": [
-        {
-          "event": "Flash-forward shows Walt's abandoned house vandalized with 'HEISENBERG' graffiti",
-          "storyline": "empire",
-          "function": "seed",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashforward"
-          ]
-        },
-        {
-          "event": "Future Walt retrieves ricin vial from his destroyed home",
-          "storyline": "empire",
-          "function": "seed",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashforward"
-          ]
-        },
-        {
-          "event": "Hank suffers panic attack and crashes SUV after discovering Walt Whitman book",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Marie tends to Hank, who lies about having a dizzy spell",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "marie"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank secretly re-investigates Heisenberg case in his garage",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank connects Walt to lab equipment theft, Gale's murder, and Fring's death",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt works mundane car wash routine with Skyler, pretending normalcy",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": [
-            "protection"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Lydia begs Walt to resume cooking due to Todd's poor quality product",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "lydia",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt refuses Lydia and tells her never to return",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse attempts to give away blood money to victims' families",
-          "storyline": "guilt",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Saul intercepts the cash and warns Jesse about distributing drug money",
-          "storyline": "guilt",
-          "function": "escalation",
-          "characters": [
-            "saul",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse confronts Saul and Walt, calling the money blood money",
-          "storyline": "guilt",
-          "function": "turning_point",
-          "characters": [
-            "jesse",
-            "walt",
-            "saul"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse directly asks Walt if he killed Mike",
-          "storyline": "guilt",
-          "function": "climax",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt lies to Jesse that Mike is alive and on the run",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "guilt"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt discovers the Walt Whitman book is missing from bathroom",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt finds GPS tracker under his car",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt confronts Hank directly in his garage",
-          "storyline": "investigation",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "hank"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank punches Walt and calls him a monster",
-          "storyline": "investigation",
-          "function": "climax",
-          "characters": [
-            "hank",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt warns Hank his cancer returned and threatens him to tread lightly",
-          "storyline": "investigation",
-          "function": "cliffhanger",
-          "characters": [
-            "walt",
-            "hank"
-          ],
-          "also_affects": [
-            "empire",
-            "empire"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the inevitable collision of truth and lies",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "investigation",
-            "guilt",
-            "empire",
-            "legacy"
-          ],
-          "description": "all storylines deal with confronting the truth of past actions and their consequences",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "investigation",
-            "empire"
-          ],
-          "description": "the audience knows Walt killed Mike while Jesse suspects but Walt denies it",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "investigation",
-            "empire"
-          ],
-          "description": "Hank's investigation and Walt's criminal empire finally collide in direct confrontation",
-          "subtype": null
-        },
-        {
-          "type": "meta",
-          "lines": [
-            "legacy",
-            "empire"
-          ],
-          "description": "flash-forward shows the ultimate destruction of everything Walt built",
-          "subtype": "flashforward"
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S05E10",
-      "events": [
-        {
-          "event": "Hank returns to work at the DEA and tries to build a case against Walt without revealing his personal connection",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank calls in Jesse for questioning, but Jesse stonewalls completely and says nothing",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "jesse"
-          ],
-          "also_affects": [
-            "guilt"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Skyler senses danger and drives to the storage unit to load money into her car",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt races to reach the money first, rents a van and loads the barrels himself",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "protection"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt takes the money barrels to the desert near To'hajiilee and buries them",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": [
-            "callback"
-          ]
-        },
-        {
-          "event": "Walt records the coordinates as lottery numbers and tapes the ticket inside the refrigerator",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "The physical labor aggravates Walt's cancer and he collapses in the bathroom",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt tells Skyler the money is safe and hidden when he wakes",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": [
-            "protection"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Marie confronts Skyler at the White house, having learned the truth from Hank",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "marie",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Marie slaps Skyler and tries to take baby Holly, but Hank intervenes",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "marie",
-            "skyler",
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank realizes he cannot go to the DEA officially because Walt is his brother-in-law",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt tells Skyler that Hank has no real evidence",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Skyler surprises Walt by siding with him out of self-preservation",
-          "storyline": "protection",
-          "function": "turning_point",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler asks Walt if this is over and he assures her it is",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Lydia visits Declan's underground meth lab and declares the quality unacceptable",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "lydia",
-            "declan"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Lydia calls Todd, who arrives with Jack's Aryan Brotherhood crew",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "lydia",
-            "todd",
-            "jack"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jack's men execute Declan and his entire operation in the buried lab",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "jack",
-            "todd"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Todd takes over cooking duties and Lydia secures a new supply chain",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "todd",
-            "lydia"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank decides to approach Jesse independently, believing he's the key to building a case outside the system",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": [
-            "guilt"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the price of loyalty and self-preservation",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "investigation",
-            "protection",
-            "legacy"
-          ],
-          "description": "all three storylines explore characters forced to choose between loyalty and self-preservation — Hank can't use official channels, Skyler sides with Walt to protect herself, Walt hides the money to preserve his legacy",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "investigation",
-            "protection"
-          ],
-          "description": "the audience knows Walt's assurance that 'this is over' is false, while Skyler believes it",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "investigation",
-            "guilt"
-          ],
-          "description": "Hank's decision to approach Jesse independently sets up their alliance against Walt",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S05E11",
-      "events": [
-        {
-          "event": "Walt and Skyler film a fake confession video framing Hank as Heisenberg",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt and Skyler invite Hank and Marie to dinner at a Mexican restaurant",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler",
-            "hank",
-            "marie"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt slides the DVD confession across the table to Hank",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt",
-            "hank"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank and Marie watch the fake confession video at home",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank",
-            "marie"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Marie realizes the medical bill detail gives the lie devastating credibility",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "marie",
-            "hank"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse sits in Saul's office ready to disappear with a new identity",
-          "storyline": "guilt",
-          "function": "setup",
-          "characters": [
-            "jesse",
-            "saul"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Huell pickpockets Jesse's marijuana during the pat-down",
-          "storyline": "guilt",
-          "function": "turning_point",
-          "characters": [
-            "jesse",
-            "guest:huell"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse realizes Huell stole his weed and connects it to the ricin cigarette theft",
-          "storyline": "guilt",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": [
-            "twist"
-          ]
-        },
-        {
-          "event": "Jesse realizes Walt orchestrated Brock's poisoning to manipulate him",
-          "storyline": "guilt",
-          "function": "climax",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "twist"
-          ]
-        },
-        {
-          "event": "Jesse storms back into Saul's office, beats him, and takes his gun",
-          "storyline": "guilt",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "saul"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse breaks into the White house and douses it with gasoline",
-          "storyline": "guilt",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "protection",
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt arrives home to find the living room soaked in gasoline",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire",
-            "guilt"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt lies to Skyler and Walter Jr. about a gas pump malfunction",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "The White family moves to a hotel for safety",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt meets with Saul and instructs him to find Jesse",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "saul"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Saul suggests Jesse needs to be dealt with permanently",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "saul",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt refuses to kill Jesse for now",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank stops Jesse from burning the White house",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank",
-            "jesse"
-          ],
-          "also_affects": [
-            "guilt"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank brings Jesse to the Schrader home",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "jesse"
-          ],
-          "also_affects": [
-            "guilt"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse agrees to cooperate with Hank against Walt",
-          "storyline": "investigation",
-          "function": "climax",
-          "characters": [
-            "jesse",
-            "hank"
-          ],
-          "also_affects": [
-            "guilt"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the price of loyalty and betrayal",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "legacy",
-            "investigation",
-            "guilt"
-          ],
-          "description": "all three storylines explore betrayal — Walt betrays Hank with the fake confession, Jesse feels betrayed by Walt's manipulation, Hank is betrayed by his own vulnerability",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "legacy",
-            "protection"
-          ],
-          "description": "the audience knows Walt's gas pump story is a lie while his family believes it",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "investigation",
-            "guilt"
-          ],
-          "description": "Jesse's realization about Walt's manipulation leads directly to his alliance with Hank",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S05E12",
-      "events": [
-        {
-          "event": "Walt discovers his living room soaked in gasoline from Jesse's break-in",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "guilt"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt fabricates a gas pump story to explain the smell to Skyler and Walter Jr.",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Skyler confronts Walt at the hotel demanding the truth about Jesse",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler coldly suggests Walt should kill Jesse permanently",
-          "storyline": "protection",
-          "function": "turning_point",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Saul advises Walt that Jesse must be sent to Belize",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "saul",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt refuses Saul's advice, insisting he can talk Jesse down",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank intercepts Jesse at the White house and talks him out of burning it down",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "hank",
-            "jesse"
-          ],
-          "also_affects": [
-            "guilt"
-          ],
-          "devices": [
-            "flashback"
-          ]
-        },
-        {
-          "event": "Jesse records his full video testimony detailing two years of crimes with Walt",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "hank"
-          ],
-          "also_affects": [
-            "guilt"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Gomez expresses skepticism that Jesse's testimony alone will convict Walt",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "gomez",
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank devises a sting operation with Jesse wearing a wire to meet Walt",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse objects that Walt is too smart and the meeting is a death trap",
-          "storyline": "guilt",
-          "function": "escalation",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank privately tells Gomez he doesn't care if Jesse dies at the meeting",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank",
-            "gomez"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jesse panics at the plaza, spots a stranger, and aborts the meeting",
-          "storyline": "guilt",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse calls Walt with a threatening message about getting him where he really lives",
-          "storyline": "guilt",
-          "function": "climax",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt drives to Jack Welker's compound and asks him to kill Jesse",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "jack"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jack agrees to kill Jesse but demands Walt cook three more batches with Todd",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "jack",
-            "walt",
-            "todd"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the point of no return",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "protection",
-            "guilt",
-            "investigation"
-          ],
-          "description": "all storylines reach their moral breaking point — Walt ordering Jesse's death, Skyler embracing murder, Jesse threatening Walt, Hank willing to sacrifice Jesse",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "investigation",
-            "empire"
-          ],
-          "description": "the audience knows Hank is using Jesse against Walt while Walt seeks Jesse's death",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "guilt",
-            "investigation"
-          ],
-          "description": "Jesse's moral crisis becomes Hank's investigative weapon",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S05E13",
-      "events": [
-        {
-          "event": "Jesse and Hank devise a plan to trap Walt by targeting his buried money",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "jesse",
-            "hank"
-          ],
-          "also_affects": [
-            "guilt"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank intimidates Huell with a staged photo of Jesse's fake death",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Huell confirms he helped Walt load seven barrels of cash into a van",
-          "storyline": "investigation",
-          "function": "escalation",
-          "characters": [
-            "guest:huell",
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse sends Walt a fake photo of excavated money barrel with threat to burn it",
-          "storyline": "investigation",
-          "function": "turning_point",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": [
-            "empire",
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt panics at the car wash and races toward the burial site",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt confesses to prison murders, killing Mike, poisoning Brock, and killing Gus while speeding to the desert",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "investigation",
-            "guilt"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Hank records Walt's full confession over the phone",
-          "storyline": "investigation",
-          "function": "climax",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt arrives at the burial site and realizes the photo was fake",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt calls Jack for backup and gives him the coordinates",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt sees Hank, Gomez, and Jesse and realizes he's been trapped",
-          "storyline": "empire",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt urgently calls Jack to cancel the backup request",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank arrests Walt at gunpoint and reads him his Miranda rights",
-          "storyline": "investigation",
-          "function": "climax",
-          "characters": [
-            "hank",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank calls Marie and tells her Walt has been arrested and the nightmare is over",
-          "storyline": "investigation",
-          "function": "resolution",
-          "characters": [
-            "hank",
-            "marie"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Jack's armed convoy arrives despite Walt's cancellation",
-          "storyline": "empire",
-          "function": "cliffhanger",
-          "characters": [
-            "guest:jack"
-          ],
-          "also_affects": [
-            "investigation",
-            "protection"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Armed standoff develops between Jack's crew and Hank and Gomez",
-          "storyline": "investigation",
-          "function": "cliffhanger",
-          "characters": [
-            "hank",
-            "gomez",
-            "guest:jack"
-          ],
-          "also_affects": [
-            "empire",
-            "protection"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the inevitability of consequences",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "investigation",
-            "protection"
-          ],
-          "description": "all storylines converge on the moment when Walt's carefully constructed lies finally collapse under the weight of truth",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "investigation",
-            "empire"
-          ],
-          "description": "the audience knows Walt is walking into a trap while he believes he's protecting his money",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "investigation",
-            "protection"
-          ],
-          "description": "all storylines physically converge at the burial site where Walt's empire, Hank's investigation, and the threat to family safety collide",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S05E14",
-      "events": [
-        {
-          "event": "Flashback shows Walt and Jesse cooking meth in the RV in the desert years earlier",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": [
-            "flashback",
-            "callback"
-          ]
-        },
-        {
-          "event": "Gomez lies dead after the firefight at To'hajiilee",
-          "storyline": "investigation",
-          "function": "climax",
-          "characters": [
-            "gomez"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Hank crawls wounded behind a vehicle, shot in the leg",
-          "storyline": "investigation",
-          "function": "climax",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt begs Jack to spare Hank, offering all eighty million dollars",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "jack"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Hank refuses to beg and tells Walt that Jack made his decision ten minutes ago",
-          "storyline": "investigation",
-          "function": "climax",
-          "characters": [
-            "hank"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jack shoots Hank in the head, killing him",
-          "storyline": "investigation",
-          "function": "resolution",
-          "characters": [
-            "jack",
-            "hank"
-          ],
-          "also_affects": [
-            "empire",
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt collapses face-down in the dirt after Hank's death",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jack's men dig up Walt's money barrels using GPS coordinates",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "jack"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jack's crew takes seven barrels, leaving Walt one at Todd's request",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "jack",
-            "todd"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse is found hiding under Walt's car and dragged out",
-          "storyline": "guilt",
-          "function": "climax",
-          "characters": [
-            "jesse",
-            "jack"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Todd argues Jesse should be kept alive to learn what he told the DEA",
-          "storyline": "guilt",
-          "function": "turning_point",
-          "characters": [
-            "todd"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt tells Jesse he watched Jane die and chose not to intervene",
-          "storyline": "guilt",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": [
-            "twist"
-          ]
-        },
-        {
-          "event": "Jesse is taken to Jack's compound and chained in an underground pit",
-          "storyline": "guilt",
-          "function": "resolution",
-          "characters": [
-            "jesse",
-            "jack"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse is forced to cook meth for Todd in captivity",
-          "storyline": "guilt",
-          "function": "seed",
-          "characters": [
-            "jesse",
-            "todd"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jack's crew buries Hank and Gomez in the hole where the money was",
-          "storyline": "investigation",
-          "function": "resolution",
-          "characters": [
-            "jack"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt drives through the desert until his car runs out of fuel",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt buys a battered truck from a Navajo man with cash",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "guest:navajo_man"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler hears news of a shooting in the desert and suspects the worst",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt bursts in and orders Skyler and Walter Jr. to pack immediately",
-          "storyline": "protection",
-          "function": "escalation",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Skyler grabs a kitchen knife and slashes at Walt, cutting his hand",
-          "storyline": "protection",
-          "function": "climax",
-          "characters": [
-            "skyler",
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walter Jr. throws himself between his parents and calls 911",
-          "storyline": "protection",
-          "function": "climax",
-          "characters": [
-            "guest:walter_jr",
-            "skyler"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt grabs baby Holly and runs to his truck",
-          "storyline": "protection",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt changes Holly's diaper in a fire station restroom while she cries for mama",
-          "storyline": "protection",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt calls Skyler and performs a vicious tirade to shield her from prosecution",
-          "storyline": "protection",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt leaves Holly at the fire station entrance with a note",
-          "storyline": "protection",
-          "function": "resolution",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Ed Galbraith picks Walt up in a red minivan for his new identity",
-          "storyline": "empire",
-          "function": "seed",
-          "characters": [
-            "walt",
-            "guest:ed_galbraith"
-          ],
-          "also_affects": null,
-          "devices": []
-        }
-      ],
-      "theme": "the cost of choices",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "investigation",
-            "guilt",
-            "protection",
-            "legacy"
-          ],
-          "description": "all storylines culminate in devastating consequences of past choices — Walt's empire crumbles, Hank dies for his pursuit, Jesse faces ultimate betrayal, Skyler loses her family, Walt's legacy is destroyed",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "investigation"
-          ],
-          "description": "the desert confrontation brings Walt's criminal empire and Hank's investigation to their mutual destruction",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "protection",
-            "legacy"
-          ],
-          "description": "Walt's phone call appears cruel but actually protects Skyler, while destroying any remaining family bonds",
-          "subtype": null
-        },
-        {
-          "type": "meta",
-          "lines": [
-            "empire"
-          ],
-          "description": "flashback to the RV cooking scene provides emotional contrast to the present devastation",
-          "subtype": "wraparound"
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S05E15",
-      "events": [
-        {
-          "event": "Walt steals a Volvo in New Hampshire and drives toward Albuquerque",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt breaks into Elliott and Gretchen's house and waits in the shadows",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt threatens Elliott and Gretchen with fake hitmen to force them to give money to Walt Jr.",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "elliott",
-            "gretchen"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Badger and Skinny Pete are revealed as the fake hitmen with laser pointers",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "guest:badger",
-            "guest:skinny_pete"
-          ],
-          "also_affects": null,
-          "devices": [
-            "twist"
-          ]
-        },
-        {
-          "event": "Walt learns from Badger and Skinny Pete that blue meth is still on the street",
-          "storyline": "guilt",
-          "function": "setup",
-          "characters": [
-            "walt",
-            "guest:badger",
-            "guest:skinny_pete"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt realizes Jesse must be alive and still cooking",
-          "storyline": "guilt",
-          "function": "turning_point",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt approaches Lydia and Todd at their coffee meeting claiming to have a new cooking method",
-          "storyline": "empire",
-          "function": "setup",
-          "characters": [
-            "walt",
-            "lydia",
-            "todd"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt slips ricin into Lydia's Stevia packet while she dismisses his offer",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "lydia"
-          ],
-          "also_affects": null,
-          "devices": [
-            "dramatic_irony"
-          ]
-        },
-        {
-          "event": "Walt retrieves his car with the mounted M60 machine gun",
-          "storyline": "empire",
-          "function": "escalation",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt gives Skyler the GPS coordinates of Hank and Gomez's burial site",
-          "storyline": "protection",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": [
-            "investigation"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt admits he did everything for himself because he liked it and was good at it",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "skyler"
-          ],
-          "also_affects": [
-            "protection"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt looks at Holly sleeping in her crib one last time",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "protection"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the final reckoning",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "legacy",
-            "empire",
-            "protection"
-          ],
-          "description": "all storylines converge on Walt's final acts of control and his attempt to secure what matters to him before death",
-          "subtype": null
-        },
-        {
-          "type": "dramatic_irony",
-          "lines": [
-            "legacy",
-            "empire"
-          ],
-          "description": "the audience knows Walt's elaborate schemes while his victims remain unaware of the true danger",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "legacy",
-            "protection"
-          ],
-          "description": "Walt's confession to Skyler serves both his need for truth and her need for legal protection",
-          "subtype": null
-        }
-      ],
-      "patches": []
-    },
-    {
-      "episode": "S05E16",
-      "events": [
-        {
-          "event": "Walt drives to Jack's compound with the M60 rigged in his trunk",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jack's men search Walt and bring him inside the clubhouse",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "jack"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt claims he wants to discuss a deal with Jack",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "jack"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jack orders Todd to bring Jesse from the meth lab as proof of enslavement",
-          "storyline": "guilt",
-          "function": "climax",
-          "characters": [
-            "jack",
-            "todd",
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Todd retrieves Jesse, who is emaciated, scarred, and shackled",
-          "storyline": "guilt",
-          "function": "climax",
-          "characters": [
-            "todd",
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt tackles Jesse to shield him and activates the M60 with the key fob",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "guilt",
-            "empire"
-          ],
-          "devices": [
-            "twist"
-          ]
-        },
-        {
-          "event": "The M60 sweeps automatic fire through the clubhouse, killing Jack's men",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Jesse strangles Todd to death with his handcuff chain",
-          "storyline": "guilt",
-          "function": "climax",
-          "characters": [
-            "jesse",
-            "todd"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt shoots the wounded Jack mid-sentence when Jack offers to reveal the money location",
-          "storyline": "empire",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "jack"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt slides the pistol to Jesse and tells him to kill Walt",
-          "storyline": "guilt",
-          "function": "climax",
-          "characters": [
-            "walt",
-            "jesse"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse refuses to kill Walt, telling him to do it himself",
-          "storyline": "guilt",
-          "function": "resolution",
-          "characters": [
-            "jesse",
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Jesse escapes in Todd's El Camino, laughing and crying as he drives away",
-          "storyline": "guilt",
-          "function": "resolution",
-          "characters": [
-            "jesse"
-          ],
-          "also_affects": null,
-          "devices": []
-        },
-        {
-          "event": "Walt tells Lydia over the phone that she ingested ricin and will die",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt",
-            "lydia"
-          ],
-          "also_affects": null,
-          "devices": [
-            "callback"
-          ]
-        },
-        {
-          "event": "Walt walks through the meth lab and leaves a bloody handprint on equipment",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        },
-        {
-          "event": "Walt collapses and dies on the lab floor as police arrive",
-          "storyline": "empire",
-          "function": "resolution",
-          "characters": [
-            "walt"
-          ],
-          "also_affects": [
-            "empire"
-          ],
-          "devices": []
-        }
-      ],
-      "theme": "the final reckoning",
-      "interactions": [
-        {
-          "type": "thematic_rhyme",
-          "lines": [
-            "empire",
-            "guilt",
-            "legacy"
-          ],
-          "description": "all three storylines converge on the theme of facing consequences and choosing how to end one's story",
-          "subtype": null
-        },
-        {
-          "type": "convergence",
-          "lines": [
-            "empire",
-            "guilt",
-            "legacy"
-          ],
-          "description": "Walt's final plan simultaneously destroys his enemies, frees Jesse, and completes his transformation",
-          "subtype": null
-        }
-      ],
-      "patches": [
-        {
-          "action": "CHECK_LINE",
-          "target": "investigation",
-          "reason": "Hank's investigation storyline has no events in the finale - it was resolved in previous episodes",
-          "episodes": [
-            "S05E16"
-          ]
-        },
-        {
-          "action": "CHECK_LINE",
-          "target": "protection",
-          "reason": "Skyler's protection storyline has no events in the finale - it was resolved in previous episodes",
-          "episodes": [
-            "S05E16"
-          ]
-        },
-        {
-          "action": "CHECK_LINE",
-          "target": "survival",
-          "reason": "Mike's survival storyline has no events in the finale - it was resolved when Mike was killed",
-          "episodes": [
-            "S05E16"
-          ]
-        }
-      ]
-    }
-  ],
-  "usage": "21 requests, 84,262 input + 29,781 output tokens, ~$0.573"
-}
\ No newline at end of file
diff --git a/docs/knowledge/results/breakdown-gdr-s01.md b/docs/knowledge/results/breakdown-gdr-s01.md
deleted file mode 100644
index ed512b5..0000000
--- a/docs/knowledge/results/breakdown-gdr-s01.md
+++ /dev/null
@@ -1,452 +0,0 @@
----
-type: note
-project: tvplotlines
-status: active
----
-
-# ГДР S01 — Storyline Breakdown
-
-## Context
-- **franchise_type**: serial
-- **story_engine**: A KGB officer investigates a conspiracy involving biological weapons and mysterious watches, testing how far he'll go to uncover the truth while his personal life crumbles
-- **format**: ongoing
-
-## Cast
-- **Александр Нечаев** (`nechaev`) — aliases: Нечаев, Александр
-- **Светлана** (`svetlana`) — aliases: Света, Светлана Нечаева
-- **Ингрид** (`ingrid`) — aliases: Ингрид
-- **Фосс** (`foss`) — aliases: Фосс
-- **Жданов** (`zhdanov`) — aliases: Жданов
-- **Генерал Черных** (`chernykh`) — aliases: Черных, генерал Черных
-- **Лиза** (`lisa`) — aliases: Лиза
-- **Константинов** (`konstantinov`) — aliases: Константинов
-- **Майерс** (`myers`) — aliases: Майерс, Майерс-старший, полковник Хаулер
-- **Джек Эванс** (`evans`) — aliases: Эванс, Джек
-
-## Storylines
-
-### [A] Conspiracy (`conspiracy`)
-- **driver**: nechaev
-- **type**: serialized | **nature**: plot-led | **confidence**: solid
-- **goal**: uncover the truth behind the biological weapons conspiracy and mysterious watches
-- **obstacle**: powerful enemies from CIA and KGB, lack of official support, constant danger
-- **stakes**: global security, mass terrorism, personal survival
-- **span**: S01E01, S01E02, S01E03, S01E04, S01E05, S01E06, S01E07, S01E08, S01E09, S01E12, S01E13, S01E14
-
-### [B] Marriage (`marriage`)
-- **driver**: nechaev
-- **type**: serialized | **nature**: character-led | **confidence**: solid
-- **goal**: save his marriage and protect his wife
-- **obstacle**: his dangerous work, wife's affair, CIA targeting Svetlana
-- **stakes**: family breakdown, wife's life
-- **span**: S01E01, S01E02, S01E03, S01E04, S01E06, S01E07, S01E08, S01E10, S01E11, S01E14
-
-### [B] Manipulation (`manipulation`)
-- **driver**: ingrid
-- **type**: serialized | **nature**: character-led | **confidence**: solid
-- **goal**: free her brother Klaus from captivity
-- **obstacle**: Foss's control, dangerous missions, moral compromises
-- **stakes**: brother's life, her own survival
-- **span**: S01E03, S01E04, S01E05, S01E06, S01E07, S01E08, S01E09, S01E10, S01E11, S01E12, S01E13
-
-### [C] Betrayal (`betrayal`)
-- **driver**: zhdanov
-- **type**: serialized | **nature**: plot-led | **confidence**: solid
-- **goal**: maintain his position while serving CIA interests
-- **obstacle**: Nechaev's investigation, suspicion from colleagues
-- **stakes**: exposure as traitor, execution
-- **span**: S01E06, S01E08, S01E10, S01E13, S01E14
-
-### [A] Archives (`archives`)
-- **driver**: nechaev
-- **type**: serialized | **nature**: plot-led | **confidence**: solid
-- **goal**: secure the Stasi archives containing Reagan-Kohl recordings
-- **obstacle**: CIA interference, false leads, internal betrayal
-- **stakes**: Soviet Union's future, Gorbachev's policies
-- **span**: S01E05, S01E09, S01E11, S01E14
-
----
-
-## Episodes
-
-### S01E01
-**Theme**: the cost of duty
-
-**Conspiracy [A]**
-
-- `setup` — Skyhawk aircraft with biological weapons violates Soviet airspace as CIA provocation  
-  [guest:cia_operatives]
-- `setup` — Nechaev participates in preventing the biological weapons threat  
-  [nechaev]
-- `escalation` — Berlin operation fails, costing Nechaev a colleague and his reputation  
-  [nechaev] *(also: marriage)*
-- `turning_point` — Nechaev is suspended from active duty  
-  [nechaev] *(also: marriage)*
-- `setup` — Colleague unofficially brings Nechaev back into service  
-  [nechaev, guest:colleague]
-- `escalation` — Nechaev goes undercover as photographer to watch American journalist Howard Hailey  
-  [nechaev]
-- `escalation` — Howard Hailey mysteriously dies in his Moscow hotel room  
-  [guest:hailey]
-- `escalation` — Nechaev tracks down magician Myers connected to the death  
-  [nechaev, myers]
-- `turning_point` — Nechaev discovers diamonds hidden in watches  
-  [nechaev]
-
-**Marriage [B]**
-
-- `climax` — Nechaev returns home and hears his wife laughing upstairs with another man  
-  [nechaev, svetlana]
-
-### S01E02
-**Theme**: the price of secrets
-
-**Conspiracy [A]**
-
-- `escalation` — Нечаев и команда отслеживают загадочные часы с ценной информацией  
-  [nechaev]
-- `escalation` — Команда узнает, что у Майерса и Хейли были одинаковые экземпляры часов  
-  [nechaev]
-- `escalation` — Команда узнает, что певец Джек Эванс получает посылку Хейли  
-  [nechaev, evans]
-- `escalation` — Нечаев знакомится с дочерью посла Лизой  
-  [nechaev, lisa]
-- `turning_point` — Нечаев обнаруживает у Эванса прослушивающие устройства  
-  [nechaev, evans]
-- `escalation` — Из озера извлекают автомобиль  
-  [nechaev]
-- `escalation` — Извлечение автомобиля усложняет легенду прикрытия  
-  [nechaev]
-
-**Marriage [B]**
-
-- `escalation` — Светлана убеждает генерала Черных разрешить ей поездку в Берлин на три дня  
-  [svetlana, chernykh] *(also: conspiracy)*
-
-### S01E03
-**Theme**: the cost of secrets
-
-**Conspiracy [A]**
-
-- `escalation` — Нечаев просит Лизу уговорить Эванса дать интервью московскому журналисту  
-  [nechaev, lisa]
-- `escalation` — Нечаев обыскивает квартиру Эванса во время подготовки к интервью  
-  [nechaev]
-- `turning_point` — Нечаев находит скрытые часы и аппаратуру наблюдения в квартире Эванса  
-  [nechaev]
-- `escalation` — Происходит взрыв в морге, где хранилось тело фокусника  
-  [guest:unknown_perpetrator]
-
-**Manipulation [B]**
-
-- `escalation` — Нечаев ставит условие Лизе — объясниться в чувствах и рассказать о планах эмиграции  
-  [nechaev, lisa] *(also: conspiracy)*
-
-**Marriage [B]**
-
-- `escalation` — Светлана приезжает в Берлин  
-  [svetlana]
-- `escalation` — Нечаев отказывается объяснять свою ситуацию Светлане  
-  [nechaev, svetlana]
-
-### S01E04
-**Theme**: the price of truth
-
-**Conspiracy [A]**
-
-- `escalation` — Нечаев прибывает на съёмочную площадку, где Эванс должен передать груз покупателю  
-  [nechaev, evans]
-- `turning_point` — Эванс убит во время съёмок финальной сцены — он умирает на камеру перед всей съёмочной группой  
-  [evans]
-- `escalation` — Часы исчезают  
-  [guest:unknown]
-- `escalation` — Смерть Эванса опустошает его подругу Лизу  
-  [lisa]
-- `escalation` — Нечаев встречается с Майерсом-старшим, который отказывается сотрудничать после гибели сына  
-  [nechaev, myers]
-
-**Marriage [B]**
-
-- `escalation` — Фотографии показывают Светлану с другим мужчиной  
-  [svetlana]
-
-**Manipulation [B]**
-
-- `escalation` — Ингрид приходит в квартиру Нечаева  
-  [ingrid, nechaev] *(also: marriage)*
-- `turning_point` — Их вечер заканчивается в постели  
-  [ingrid, nechaev] *(also: marriage)*
-
-### S01E05
-**Theme**: the price of truth
-
-**Conspiracy [A]**
-
-- `escalation` — Взрыв убивает охранников Майерса  
-  [myers]
-- `escalation` — Майерс оказывается в больнице  
-  [myers]
-- `escalation` — Константинов помогает Нечаеву скрыться  
-  [konstantinov, nechaev]
-- `turning_point` — Нечаев прыгает из окна, пытаясь остановить Ингрид  
-  [nechaev] *(also: manipulation)*
-- `cliffhanger` — Нечаева задерживают и допрашивают по поводу смерти Майерса  
-  [nechaev]
-
-**Manipulation [B]**
-
-- `climax` — Ингрид, переодевшись медсестрой, вводит Майерсу яд в больнице  
-  [ingrid, myers] *(also: conspiracy)*
-
-**Archives [A]**
-
-- `escalation` — Фосс встречается с бывшим начальником разведки КГБ, убеждая его, что копии архивов могут попасть в чужие руки  
-  [foss, guest:former_kgb_chief]
-
-### S01E06
-**Theme**: the price of truth
-
-**Betrayal [C]**
-
-- `escalation` — Фосс организует встречу Жданова и Нечаева  
-  [foss, zhdanov, nechaev] *(also: conspiracy)*
-- `escalation` — Жданов предупреждает, что Нечаев действует независимо от руководства Штази  
-  [zhdanov, nechaev] *(also: conspiracy)*
-- `escalation` — Жданов давит на Нечаева, заставляя работать с ним  
-  [zhdanov, nechaev] *(also: conspiracy)*
-- `escalation` — Жданов показывает Ингрид кассету с записью её ночи с Нечаевым  
-  [zhdanov, ingrid] *(also: manipulation, marriage)*
-
-**Conspiracy [A]**
-
-- `turning_point` — Нечаев признаётся в убийстве, которого не совершал  
-  [nechaev]
-- `escalation` — Во время следственного эксперимента Нечаев обнаруживает тайный проход  
-  [nechaev]
-
-**Manipulation [B]**
-
-- `turning_point` — Жданов вынуждает Ингрид подчиниться  
-  [zhdanov, ingrid] *(also: betrayal)*
-- `escalation` — Ингрид избивает Светлану в туалете ресторана  
-  [ingrid, svetlana] *(also: marriage)*
-
-**Marriage [B]**
-
-- `climax` — Светлану похищают после столкновения  
-  [svetlana] *(also: manipulation)*
-
-### S01E07
-**Theme**: the price of loyalty
-
-**Conspiracy [A]**
-
-- `escalation` — CIA operatives hold Nechaev and Svetlana hostage  
-  [nechaev, svetlana] *(also: marriage)*
-- `turning_point` — CIA realizes Nechaev cannot be broken  
-  [nechaev]
-- `turning_point` — CIA changes their approach  
-  [guest:cia_operatives]
-- `escalation` — Nechaev takes shelter with Ingrid  
-  [nechaev, ingrid] *(also: manipulation)*
-
-**Marriage [B]**
-
-- `climax` — CIA injects poison into Svetlana to force cooperation  
-  [svetlana] *(also: conspiracy)*
-
-**Manipulation [B]**
-
-- `turning_point` — Ingrid reveals that Foss is manipulating her  
-  [ingrid]
-- `escalation` — Ingrid explains Foss is using her brother Klaus as leverage  
-  [ingrid]
-- `escalation` — Ingrid reveals Klaus is being held captive  
-  [ingrid]
-
-### S01E08
-**Theme**: the price of loyalty
-
-**Betrayal [C]**
-
-- `escalation` — Жданов встречает Нечаева на охотничьей базе  
-  [zhdanov, nechaev] *(also: conspiracy)*
-- `escalation` — Жданов требует возвращения Нечаева в Москву  
-  [zhdanov] *(also: conspiracy)*
-
-**Conspiracy [A]**
-
-- `escalation` — Нечаев настаивает на завершении берлинских операций  
-  [nechaev] *(also: betrayal)*
-
-**Marriage [B]**
-
-- `escalation` — Нечаев требует освобождения Светы  
-  [nechaev]
-- `climax` — Светлану допрашивают с помощью сыворотки правды  
-  [svetlana] *(also: conspiracy)*
-- `climax` — Допрос проводят несмотря на беременность Светланы  
-  [svetlana]
-
-**Manipulation [B]**
-
-- `turning_point` — Нечаев восстанавливает контакт с Ингрид  
-  [nechaev, ingrid] *(also: conspiracy)*
-- `turning_point` — Ингрид признаёт, что Фосс контролирует её через брата  
-  [ingrid] *(also: conspiracy)*
-
-### S01E09
-**Theme**: the price of truth
-
-**Manipulation [B]**
-
-- `escalation` — Ингрид получает слепки ключей от квартиры Беттины  
-  [ingrid]
-- `turning_point` — Ингрид связывается с Фоссом, предлагая обмен: полковника на её брата Клауса  
-  [ingrid, foss] *(also: archives)*
-
-**Archives [A]**
-
-- `escalation` — Нечаев и Чигирь проникают в квартиру Беттины  
-  [nechaev, guest:chigir] *(also: conspiracy)*
-- `escalation` — Они копируют файлы о встречах полковника Хаулера в 1984-85 годах при помощи Константинова  
-  [nechaev, konstantinov] *(also: conspiracy)*
-- `climax` — Они пытают Хаулера, чтобы выяснить местоположение архива  
-  [nechaev, guest:chigir] *(also: conspiracy)*
-
-**Conspiracy [A]**
-
-- `turning_point` — Они обнаруживают компьютерные файлы, раскрывающие связь Хаулера с Майерсом  
-  [nechaev] *(also: archives)*
-
-### S01E10
-**Theme**: the price of loyalty
-
-**Manipulation [B]**
-
-- `escalation` — Ингрид устанавливает фальшивую бомбу на полковника Хаулера  
-  [ingrid]
-- `escalation` — Ингрид и Отто направляются к Берлинской стене для обмена пленными  
-  [ingrid, guest:otto]
-- `turning_point` — Ингрид сообщает Фоссу, что полковник заминирован, давая им тридцать минут  
-  [ingrid, foss] *(also: conspiracy)*
-- `climax` — Обмен идёт не по плану — Отто убивает Клауса  
-  [guest:otto, guest:klaus]
-
-**Betrayal [C]**
-
-- `escalation` — Жданов ранен взрывом  
-  [zhdanov]
-
-**Marriage [B]**
-
-- `escalation` — ЦРУ начинает тестировать сыворотку правды на Светлане  
-  [svetlana, guest:cia_agents] *(also: conspiracy)*
-- `climax` — Светлана впадает в кому  
-  [svetlana]
-
-### S01E11
-**Theme**: the cost of choices and consequences
-
-**Archives [A]**
-
-- `turning_point` — Нечаев предлагает сделку Фоссу, обещая информацию об архиве  
-  [nechaev, foss] *(also: conspiracy)*
-
-**Manipulation [B]**
-
-- `resolution` — Ингрид навещает отца, чтобы сообщить о гибели Клауса  
-  [ingrid]
-- `resolution` — Отец обвиняет Ингрид в семейных трагедиях и отказывает в прощении  
-  [ingrid, guest:father]
-- `resolution` — Отец выгоняет Ингрид  
-  [ingrid, guest:father]
-
-**Marriage [B]**
-
-- `climax` — Светлану находят без сознания в церкви во время рейда  
-  [svetlana]
-- `resolution` — Светлану спасают  
-  [svetlana]
-
-### S01E12
-**Theme**: the price of truth
-
-**Conspiracy [A]**
-
-- `escalation` — Генерал Черных помещает Нечаева под домашний арест  
-  [chernykh, nechaev] *(also: marriage)*
-- `turning_point` — Нечаев сбегает из-под домашнего ареста  
-  [nechaev]
-- `escalation` — Нечаев встречается с Маркусом Вольфом  
-  [nechaev, guest:marcus_wolf] *(also: archives)*
-- `cliffhanger` — Требование вернуть Нечаева в Москву к завтрашнему дню  
-  [guest:moscow_officials]
-
-**Manipulation [B]**
-
-- `escalation` — ЦРУ отправляет Ингрид с отравленным конвертом для доставки Светлане  
-  [ingrid] *(also: marriage)*
-
-### S01E13
-**Theme**: the price of truth and loyalty
-
-**Manipulation [B]**
-
-- `climax` — Ингрид доставляет отравленное письмо Светлане  
-  [ingrid, svetlana] *(also: marriage)*
-- `climax` — Ингрид и Светлана борются и падают из окна вместе  
-  [ingrid, svetlana] *(also: marriage)*
-- `resolution` — Ингрид погибает от падения  
-  [ingrid]
-
-**Betrayal [C]**
-
-- `turning_point` — Жданов спасает Светлану  
-  [zhdanov, svetlana] *(also: marriage)*
-- `climax` — Обнаружено дело Корнейчука, которое раскрывает, что Жданов — настоящий предатель  
-  [zhdanov] *(also: conspiracy)*
-
-**Conspiracy [A]**
-
-- `resolution` — Нечаев оправдан — доказательства подтверждают его невиновность  
-  [nechaev] *(also: betrayal)*
-- `resolution` — Нечаев объясняет, что ему пришлось выбирать «между одним человеком и массовым терроризмом»  
-  [nechaev] *(also: marriage)*
-
-### S01E14
-**Theme**: the price of truth and loyalty
-
-**Archives [A]**
-
-- `escalation` — Команда Нечаева проникает в архивы Штази  
-  [nechaev]
-- `turning_point` — Нечаев получает настоящее местоположение архива от Маркуса Вольфа  
-  [nechaev, guest:marcus_wolf]
-- `climax` — Архив содержит запись разговора Рейгана и Коля от мая 1985 года  
-  [nechaev] *(also: conspiracy)*
-
-**Betrayal [C]**
-
-- `escalation` — Лукьянов предаёт команду генералу Черных  
-  [guest:lukyanov, chernykh] *(also: archives)*
-- `climax` — Выясняется, что генерал Черных — агент ЦРУ  
-  [chernykh] *(also: conspiracy)*
-- `resolution` — Хельга раскрывает, что использовался фальшивый архив для поимки предателя  
-  [guest:helga] *(also: archives)*
-
-**Marriage [B]**
-
-- `resolution` — Нечаев обменивает агента ЦРУ Эда Пециуса на отца Светланы  
-  [nechaev, guest:ed_pecius]
-- `cliffhanger` — Нечаев исчезает после обмена  
-  [nechaev] *(also: conspiracy)*
-
-**Conspiracy [A]**
-
-- `climax` — В записи обсуждаются планы обмануть Горбачёва относительно воссоединения Германии  
-  [guest:reagan, guest:kohl] *(also: archives)*
-- `resolution` — Нечаев лично встречается с Горбачёвым  
-  [nechaev, guest:gorbachev]
-- `resolution` — Нечаев передаёт Горбачёву записи о западных планах развала СССР  
-  [nechaev, guest:gorbachev] *(also: archives)*
diff --git a/docs/knowledge/results/breakdown-sp-s01.md b/docs/knowledge/results/breakdown-sp-s01.md
deleted file mode 100644
index 2fe5999..0000000
--- a/docs/knowledge/results/breakdown-sp-s01.md
+++ /dev/null
@@ -1,571 +0,0 @@
----
-type: note
-project: tvplotlines
-status: active
----
-
-# Слово пацана S01 — Storyline Breakdown
-
-## Context
-- **franchise_type**: serial
-- **story_engine**: A teenage boy joins a street gang, testing how far he'll go to survive and belong in a violent world
-- **format**: limited
-
-## Cast
-- **Андрей** (`andrey`) — aliases: Пальто, Андрей Пальто
-- **Марат** (`marat`) — aliases: Марат
-- **Вова Адидас** (`vova`) — aliases: Адидас, Вова
-- **Юлия Александровна** (`julia`) — aliases: мама Андрея, мама
-- **Ирина** (`ira`) — aliases: Ира
-- **Ильдар** (`ildar`) — aliases: следователь Ильдар, оперуполномоченный Ильдар
-- **Айгуль** (`aigul`) — aliases: Айгуль
-- **Кащей** (`kashchey`) — aliases: Кащей
-- **Ералаш** (`eralash`) — aliases: Ералаш
-- **Турбо** (`turbo`) — aliases: Турбо
-- **Зима** (`zima`) — aliases: Зима
-- **Наташа** (`natasha`) — aliases: хирург Наташа, медсестра Наташа
-
-## Storylines
-
-### [A] Belonging (`belonging`)
-- **driver**: andrey
-- **type**: serialized | **nature**: character-led | **confidence**: solid
-- **goal**: найти защиту и принадлежность в уличной группировке
-- **obstacle**: насилие, моральные компромиссы, конфликт с семьёй
-- **stakes**: потеря семьи, тюрьма, смерть
-- **span**: S01E01, S01E02, S01E03, S01E04, S01E06, S01E07, S01E08
-
-### [A] Love (`love`)
-- **driver**: marat
-- **type**: serialized | **nature**: character-led | **confidence**: solid
-- **goal**: защитить и быть с Айгуль
-- **obstacle**: уличные законы, семейный позор, насилие над девушкой
-- **stakes**: потеря любимой, исключение из группировки
-- **span**: S01E01, S01E02, S01E03, S01E04, S01E05, S01E06, S01E07, S01E08
-
-### [A] Leadership (`leadership`)
-- **driver**: vova
-- **type**: serialized | **nature**: plot-led | **confidence**: solid
-- **goal**: защитить группировку и младшего брата
-- **obstacle**: конкурирующие банды, милиция, моральные дилеммы
-- **stakes**: смерть, тюрьма, потеря авторитета
-- **span**: S01E02, S01E03, S01E04, S01E05, S01E06, S01E07, S01E08
-
-### [B] Family (`family`)
-- **driver**: julia
-- **type**: serialized | **nature**: character-led | **confidence**: solid
-- **goal**: сохранить семью и защитить детей
-- **obstacle**: психическое расстройство, давление органов опеки, преступления сына
-- **stakes**: потеря детей, психиатрическая больница
-- **span**: S01E02, S01E04, S01E05, S01E07
-
-### [B] Justice (`justice`)
-- **driver**: ildar
-- **type**: serialized | **nature**: plot-led | **confidence**: solid
-- **goal**: поймать преступников и защитить общество
-- **obstacle**: коррупция, уличные законы, личные отношения
-- **stakes**: безнаказанность преступников, общественная опасность
-- **span**: S01E01, S01E02, S01E07, S01E08
-
-### [C] Redemption (`redemption`)
-- **driver**: ira
-- **type**: serialized | **nature**: character-led | **confidence**: solid
-- **goal**: спасти Андрея от криминального пути
-- **obstacle**: недоверие подростка, привлекательность уличной жизни
-- **stakes**: потеря Андрея, крах его будущего
-- **span**: S01E01, S01E02, S01E03, S01E08
-
----
-
-## Episodes
-
-### S01E01
-**Theme**: цена принадлежности
-
-**Belonging [A]**
-
-- `setup` — Хулиган в автобусе отбирает деньги у Андрея и Искандера  
-  [andrey, guest:iskander, guest:hooligan]
-- `setup` — Учительница просит Андрея подтянуть Марата по английскому  
-  [andrey, marat]
-- `escalation` — Искандер вступает в группировку 'Разъезд' и требует денег у Андрея  
-  [andrey, guest:iskander]
-- `turning_point` — Андрей решает 'пришиться' к универсамовским для защиты  
-  [andrey]
-- `escalation` — Андрей проходит испытание дракой с Маратом  
-  [andrey, marat]
-- `climax` — Андрей получает прозвище 'Пальто' и принимается в группировку  
-  [andrey]
-- `escalation` — Группировка едет 'на гастроли' в Москву  
-  [andrey, marat]
-- `escalation` — Ребята избивают панка в Москве  
-  [andrey, marat] *(also: justice)*
-
-**Love [A]**
-
-- `setup` — Марат знакомится с Айгуль в музыкальной школе  
-  [marat, aigul]
-- `escalation` — Андрей 'пришивается', чтобы достать номер Айгуль для Марата  
-  [andrey, marat] *(also: belonging)*
-
-**Justice [B]**
-
-- `setup` — Андрея ловит милиция, дело берёт Ирина  
-  [andrey, ira] *(also: belonging, redemption)*
-
-**Redemption [C]**
-
-- `setup` — Андрей влюбляется в Ирину  
-  [andrey, ira]
-
-**Interactions**
-
-- *thematic_rhyme*: все три линии исследуют тему принадлежности — к группе, к любимому человеку, к правильному пути (belonging, love, redemption)
-- *convergence*: Андрей вступает в группировку частично ради помощи Марату с Айгуль (belonging, love)
-- *convergence*: арест Андрея связывает его криминальный путь с системой правосудия и возможностью спасения (belonging, justice, redemption)
-
-### S01E02
-**Theme**: цена принадлежности
-
-**Love [A]**
-
-- `setup` — Появляется отец Марата — состоятельный инженер оборонного завода  
-  [guest:marat_father]
-- `setup` — Сыновья не считают отца авторитетом  
-  [marat]
-- `escalation` — Марат кричит милиция и разгоняет толпу, спасая маму Андрея от потери шубы  
-  [marat] *(also: family)*
-- `escalation` — Кащей избивает Марата за спасение мамы Андрея  
-  [kashchey, marat] *(also: belonging)*
-
-**Belonging [A]**
-
-- `escalation` — Андрей бреется налысо — визуальный маркер вступления в группировку  
-  [andrey] *(also: family, redemption)*
-- `escalation` — Кащей обманывает людей игрой в напёрстки  
-  [kashchey]
-- `escalation` — Марат изображает счастливого победителя в игре  
-  [marat]
-- `escalation` — Ребята делят награбленное  
-  [andrey, marat, eralash]
-- `escalation` — Ералаш покупает бабушке утюг  
-  [eralash]
-- `escalation` — Андрей пишет фальшивые имена (Рэмбо, Робокоп)  
-  [andrey] *(also: justice)*
-- `escalation` — На дискотеке Андрей бьёт Искандера  
-  [andrey, guest:iskander]
-- `climax` — Неизвестные нападают на Ералаша  
-  [eralash, guest:attackers]
-- `climax` — Кирилл наблюдает нападение, но трусливо уезжает  
-  [guest:kirill]
-- `climax` — Ералаш погибает  
-  [eralash] *(also: leadership)*
-
-**Redemption [C]**
-
-- `escalation` — Ира пытается переубедить Андрея, приглашает в кино  
-  [ira, andrey]
-- `turning_point` — Ира пытается публично заставить Андрея рассказать о жизни группировщика  
-  [ira, andrey] *(also: belonging)*
-
-**Family [B]**
-
-- `escalation` — Мама Андрея попадается на обман — проигрывает все деньги и шапку  
-  [julia] *(also: belonging)*
-- `escalation` — Андрей приносит деньги маме — та отказывается  
-  [andrey, julia] *(also: belonging)*
-- `turning_point` — Мама Андрея начинает встречаться с оперуполномоченным Ильдаром  
-  [julia, ildar] *(also: justice)*
-
-**Leadership [A]**
-
-- `setup` — Из Афганистана возвращается Вова Адидас  
-  [vova]
-- `escalation` — Адидас недоволен, что универсамовские отняли деньги у мамы своего же участника  
-  [vova] *(also: family)*
-- `escalation` — Адидас предлагает парням крышевать дороги — останавливать машины и требовать плату  
-  [vova] *(also: belonging)*
-
-**Justice [B]**
-
-- `escalation` — Ильдар приводит Андрея в отделение, сажает за компьютер  
-  [ildar, andrey] *(also: family)*
-- `escalation` — Ильдар просит Андрея сдать членов группировки  
-  [ildar, andrey] *(also: belonging)*
-- `escalation` — После драки Андрея задерживает милиция  
-  [andrey] *(also: belonging)*
-- `climax` — Ильдар понимает, что имена были фальшивыми, и жестоко избивает Андрея  
-  [ildar, andrey] *(also: belonging, family)*
-
-**Interactions**
-
-- *thematic_rhyme*: все сюжетные линии исследуют тему защиты — своих людей, семьи, принципов — и цену, которую за это приходится платить (belonging, love, leadership, family, justice, redemption)
-- *dramatic_irony*: мама Андрея не знает, что её новый возлюбленный избивает её сына (family, justice)
-- *convergence*: противостояние Андрея и Ильдара объединяет криминальную и правоохранительную линии (belonging, justice)
-
-### S01E03
-**Theme**: цена принадлежности
-
-**Love [A]**
-
-- `escalation` — Марат ворует шапку у учительницы английского  
-  [marat]
-- `escalation` — Марат дарит украденную шапку маме Андрея  
-  [marat, julia] *(also: family)*
-- `escalation` — Отец Марата узнаёт о краже шапки и пытается увезти сына к тёте  
-  [guest:marat_father, marat]
-
-**Belonging [A]**
-
-- `escalation` — Кирилл рассказывает, что на Ералаша напали люди из группировки «Разъезд»  
-  [guest:kirill]
-- `turning_point` — Выясняется, что Кирилл солгал — убийцы были из банды «Хади Такташ»  
-  [guest:kirill] *(also: leadership)*
-- `escalation` — Кирилла «отшивают» — бывшие товарищи избивают его и оплёвывают  
-  [vova, andrey]
-- `climax` — Андрей теряет сознание во время драки  
-  [andrey]
-- `resolution` — Андрей приходит в себя в больнице  
-  [andrey]
-- `turning_point` — Андрей узнаёт, что убийца Ералаша в соседней палате  
-  [andrey]
-- `climax` — Андрей ночью пробирается в палату и жестоко избивает убийцу Ералаша  
-  [andrey]
-
-**Leadership [A]**
-
-- `escalation` — Универсамовские устраивают драку с разъездовскими и побеждают  
-  [vova, andrey] *(also: belonging)*
-- `climax` — Универсамовские выходят против хадишевских без Марата  
-  [vova, andrey] *(also: belonging)*
-- `climax` — Во время драки Вову Адидаса ранят в ногу доской с гвоздями  
-  [vova]
-
-**Redemption [C]**
-
-- `escalation` — Андрей приходит домой к Ирине и видит там её нового друга-рок-музыканта  
-  [andrey, ira]
-- `escalation` — Андрей грозит рок-музыканту расправой  
-  [andrey, ira]
-
-**Interactions**
-
-- *thematic_rhyme*: все три сюжетные линии исследуют тему жертв ради принадлежности — Андрей жертвует невинностью, Марат — семейными отношениями, Вова — здоровьем (belonging, love, leadership)
-- *convergence*: сюжетные линии сходятся в драке с «Хади Такташ», где и Андрей, и Вова получают физические и моральные травмы (belonging, leadership)
-- *dramatic_irony*: Ира пытается спасти Андрея, не зная, что он уже совершил жестокое избиение в больнице (redemption, belonging)
-
-### S01E04
-**Theme**: the cost of loyalty
-
-**Leadership [A]**
-
-- `escalation` — Хадишевские штурмуют больницу, чтобы отомстить за своего  
-  [guest:hadishevskie]
-- `escalation` — Марат, Андрей и Турбо экстренно эвакуируют Вову на угнанной машине скорой помощи  
-  [marat, andrey, turbo, vova] *(also: belonging)*
-- `escalation` — Хирург Наташа зашивает рану Адидасу прямо в лифте  
-  [natasha, vova]
-- `turning_point` — Вова выходит против Кащея и отшивает его  
-  [vova, kashchey]
-- `turning_point` — В вещах бывшего лидера находят деньги и пистолет  
-  [vova]
-- `escalation` — Адидас видит перспективу — можно открыть свой видеосалон  
-  [vova]
-
-**Love [A]**
-
-- `escalation` — Марат сбегает из дома и какое-то время живёт у Андрея  
-  [marat, andrey] *(also: belonging)*
-- `escalation` — Айгуль обижена на Марата за то, что он пропал на два дня и не отвечал на звонки  
-  [aigul, marat]
-
-**Belonging [A]**
-
-- `escalation` — Универсамовские ходят в видеосалон  
-  [andrey, marat, vova]
-- `escalation` — Ребята воруют видеомагнитофон  
-  [andrey, marat, vova] *(also: leadership)*
-- `turning_point` — Андрей спорит с комиссией и срывает поступление  
-  [andrey] *(also: family)*
-
-**Family [B]**
-
-- `escalation` — Юлия Александровна приходит в школу, где учительница английского видит на ней свою украденную шапку  
-  [julia, guest:teacher]
-- `turning_point` — Женщина понимает, что сын ей лгал  
-  [julia]
-- `climax` — Она переживает нервный срыв — поджигает себе волосы  
-  [julia]
-- `escalation` — Маму Андрея хотят отправить его в Суворовское училище  
-  [julia, guest:commission]
-
-**Interactions**
-
-- *thematic_rhyme*: все сюжетные линии исследуют цену верности — группировке, любимой, власти, семье (belonging, love, leadership, family)
-- *dramatic_irony*: мать не знает о криминальной деятельности сына, но находит украденные вещи (belonging, family)
-- *convergence*: Марат живет у Андрея, их личные проблемы пересекаются (belonging, love)
-
-### S01E05
-**Theme**: цена защиты близких
-
-**Family [B]**
-
-- `escalation` — Юлию Александровну кладут в психбольницу  
-  [julia]
-- `escalation` — Органы опеки грозятся забрать Андрея и его сестру Юлю в детский дом  
-  [andrey] *(also: belonging)*
-- `resolution` — При помощи Ильдара маму удаётся вернуть домой  
-  [ildar, julia] *(also: justice)*
-
-**Love [A]**
-
-- `setup` — За Айгуль начинает следить странный мужчина на зелёной восьмёрке из группировки «Дом быта»  
-  [aigul]
-- `escalation` — Чтобы отвязаться от преследователя, Айгуль возобновляет отношения с Маратом  
-  [aigul, marat]
-- `escalation` — Айгуль рисует афиши для видеосалона  
-  [aigul] *(also: leadership)*
-- `escalation` — Бандиты похищают Айгуль  
-  [aigul] *(also: leadership)*
-- `climax` — Преследователь совершает сексуализированное насилие над Айгуль  
-  [aigul]
-- `resolution` — Вова спасает Айгуль  
-  [vova, aigul] *(also: leadership)*
-
-**Leadership [A]**
-
-- `setup` — Универсамовские открывают свой видеосалон  
-  [vova]
-- `escalation` — Бандиты из «Дома быта» врываются в салон  
-  [guest:dom_byta_gang]
-- `escalation` — Бандиты забирают магнитофон и избивают Турбо  
-  [turbo]
-- `turning_point` — Вова договаривается о встрече с лидером «Дома быта» Желтым  
-  [vova]
-- `escalation` — На встрече Вову, Марата и Зиму жестоко избивают  
-  [vova, marat, zima] *(also: love)*
-- `escalation` — От Адидаса требуют встать на колени и извиниться, он отказывается  
-  [vova]
-- `turning_point` — Когда брату начинают отрезать ухо, Вова произносит «прости меня»  
-  [vova, marat] *(also: love)*
-- `turning_point` — Вова берёт пистолет Кащея  
-  [vova, kashchey]
-- `climax` — Вова в одиночку приезжает к «Дому быта»  
-  [vova]
-- `climax` — Вова ранит всех присутствующих и убивает Желтого  
-  [vova]
-
-**Interactions**
-
-- *thematic_rhyme*: все три сюжетные линии исследуют тему жертв ради защиты близких — мать борется за детей, Марат и Вова за Айгуль, Вова за брата (family, love, leadership)
-- *convergence*: сюжетные линии сходятся в финальной сцене спасения Айгуль, где цели Марата и Вовы объединяются (love, leadership)
-
-### S01E06
-**Theme**: цена принадлежности
-
-**Love [A]**
-
-- `escalation` — Родители Айгуль отказываются писать заявление против насильника  
-  [guest:aigul_parents] *(also: justice)*
-- `turning_point` — Адидас запрещает Марату встречаться с Айгуль  
-  [vova, marat] *(also: leadership)*
-- `escalation` — Марат заставляет Айгуль сказать, что ничего не было  
-  [marat, aigul]
-- `escalation` — Турбо выясняет правду о случившемся с Айгуль  
-  [turbo]
-- `escalation` — Турбо распространяет информацию на дискотеке  
-  [turbo]
-- `escalation` — Все отворачиваются от Айгуль, включая подруг  
-  [aigul]
-- `escalation` — Айгуль в слезах убегает с дискотеки  
-  [aigul]
-- `escalation` — Родители не поддерживают Айгуль  
-  [aigul, guest:aigul_parents]
-- `cliffhanger` — Айгуль выходит на балкон и готовится прыгнуть  
-  [aigul]
-
-**Leadership [A]**
-
-- `setup` — Вова начинает сближаться с медсестрой Наташей  
-  [vova, natasha]
-- `escalation` — Вова скрывается в общежитии у Наташи  
-  [vova, natasha]
-
-**Belonging [A]**
-
-- `escalation` — Андрей подслушивает телефонный разговор Ильдара  
-  [andrey, ildar] *(also: justice)*
-- `escalation` — Андрей узнаёт, что Вову объявили в розыск за убийство  
-  [andrey] *(also: leadership, justice)*
-- `escalation` — Андрей предупреждает Вову о розыске  
-  [andrey, vova] *(also: leadership)*
-
-**NULL**
-
-- `seed` — На экране показывают некрологи универсамовцев  
-  []
-
-**Interactions**
-
-- *thematic_rhyme*: все три линии показывают, как принадлежность к группе требует жертв — Андрей жертвует моралью, Марат — любовью, Вова — свободой (belonging, love, leadership)
-- *dramatic_irony*: зритель знает, что Андрей помогает разыскиваемому преступнику, предупреждая Вову (belonging, justice)
-- *convergence*: линии сходятся в моменте, когда Андрей предупреждает Вову о розыске (belonging, leadership)
-- *meta*: некрологи в финале — пророческий взгляд в будущее всех персонажей ()
-
-### S01E07
-**Theme**: цена предательства
-
-**Love [A]**
-
-- `climax` — Андрей сообщает Вове, что Айгуль погибла  
-  [andrey, vova] *(also: leadership)*
-- `climax` — Марату в школе сообщают о смерти Айгуль  
-  [marat]
-- `climax` — Марат в шоке убегает из школы  
-  [marat]
-- `escalation` — Турбо поднимает вопрос о Марате и его связи с Айгуль  
-  [turbo, marat] *(also: belonging)*
-- `resolution` — Марата отшивают за нарушение пацанских принципов  
-  [marat] *(also: belonging)*
-- `turning_point` — Марат идёт в милицию к Ильдару  
-  [marat, ildar] *(also: justice)*
-- `climax` — Марат дерётся с Турбо и подкладывает ему пистолет  
-  [marat, turbo] *(also: justice)*
-
-**Leadership [A]**
-
-- `escalation` — Вова отвозит Марата на кладбище к могиле сослуживца  
-  [vova, marat]
-- `turning_point` — Вова не находит сил рассказать Марату о трагедии  
-  [vova, marat] *(also: love)*
-- `escalation` — Вова уезжает с Наташей к её тёте  
-  [vova, natasha]
-- `turning_point` — Выясняется, что тётя — мать убитого Желтого  
-  [vova, natasha]
-- `escalation` — Подельник Желтого узнаёт и избивает Вову  
-  [vova, guest:yellow_accomplice]
-- `climax` — Наташа узнаёт правду и убегает в слезах  
-  [natasha, vova]
-- `resolution` — Вова объявляет банде, что уезжает из города  
-  [vova] *(also: belonging)*
-- `resolution` — Главным в Универсаме становится Зима  
-  [zima] *(also: belonging)*
-
-**Family [B]**
-
-- `escalation` — Юлия Александровна приходит домой без дочери  
-  [julia]
-- `turning_point` — Универсамовские ищут девочку, Турбо находит её  
-  [turbo] *(also: belonging)*
-- `escalation` — Приезжает милиция, маму увозят в больницу  
-  [julia]
-- `escalation` — Органы опеки хотят забрать детей  
-  [julia] *(also: belonging)*
-
-**Belonging [A]**
-
-- `turning_point` — Андрей сбегает, сестру забирают  
-  [andrey] *(also: family)*
-- `escalation` — Андрей живёт в подвальном штабе группировки  
-  [andrey]
-
-**Justice [B]**
-
-- `turning_point` — Марат сдаёт бывших подельников  
-  [marat, ildar] *(also: love)*
-- `climax` — Милиция задерживает Универсамовских  
-  [ildar] *(also: belonging)*
-
-**Interactions**
-
-- *thematic_rhyme*: все три линии исследуют тему предательства — Марат предаёт банду, Вова предаёт Марата молчанием, Андрей предаёт семью ради группировки (love, leadership, belonging)
-- *convergence*: линии Марата и Ильдара сходятся — месть за Айгуль становится сотрудничеством с милицией (love, justice)
-- *dramatic_irony*: зрители знают о смерти Айгуль, а Марат ещё нет — создаёт напряжение в сценах с Вовой (love, leadership)
-
-### S01E08
-**Theme**: the price of choices and the impossibility of return
-
-**Justice [B]**
-
-- `escalation` — Ильдар устраивает очную ставку Марата с Кириллом  
-  [ildar, marat, guest:kirill] *(also: love)*
-- `escalation` — Кирилл утверждает, что пистолет принадлежал Вове Адидасу  
-  [guest:kirill] *(also: leadership)*
-- `turning_point` — Ильдар отпускает Марата  
-  [ildar, marat]
-- `escalation` — Ильдар приходит к Наташе и видит там Вову  
-  [ildar, natasha, vova] *(also: leadership)*
-- `climax` — Ильдар стреляет в убегающего Вову  
-  [ildar, vova] *(also: leadership)*
-
-**Love [A]**
-
-- `escalation` — Драка между Маратом и Кириллом в милиции  
-  [marat, guest:kirill]
-- `escalation` — Марат обвиняет Вову в смерти Айгуль и уходит  
-  [marat, vova] *(also: leadership)*
-- `turning_point` — Денис Коневич вручает Марату грамоту за задержание Турбо  
-  [marat, guest:denis]
-- `turning_point` — Денис предлагает Марату вступить в комсомол  
-  [guest:denis, marat]
-- `escalation` — Марат отбирает пионерский галстук у школьника  
-  [marat]
-- `turning_point` — Марата принимают в комсомол  
-  [marat]
-- `climax` — Денис приводит Марата к насильнику Айгуль  
-  [guest:denis, marat]
-- `climax` — Марат жестоко избивает насильника  
-  [marat, guest:rapist]
-- `resolution` — Марат плачет от бессилия  
-  [marat]
-
-**Belonging [A]**
-
-- `turning_point` — Андрея выпускают из камеры  
-  [andrey]
-- `escalation` — Андрей находит в качалке только Кащея  
-  [andrey, kashchey]
-- `escalation` — Кащей издевается над Андреем и отнимает пальто  
-  [kashchey, andrey]
-- `escalation` — Андрей нападает на Марата за предательство  
-  [andrey, marat] *(also: love)*
-- `escalation` — Андрей побеждает Марата в драке  
-  [andrey, marat]
-- `turning_point` — Андрей идёт на рынок за тортом и цветами  
-  [andrey]
-- `climax` — Мужчина узнаёт Андрея и сдаёт в милицию  
-  [andrey, guest:victim]
-- `resolution` — Андрей играет на пианино в детской колонии  
-  [andrey]
-
-**Redemption [C]**
-
-- `escalation` — Андрей приходит к Ирине  
-  [andrey, ira]
-- `escalation` — Ирина оформляет опеку над Юлей  
-  [ira] *(also: family)*
-- `escalation` — Ирина предлагает Андрею уйти из группировки  
-  [ira, andrey]
-- `turning_point` — Ирина везёт Андрея и Юлю к маме в больницу  
-  [ira, andrey] *(also: family)*
-
-**Leadership [A]**
-
-- `escalation` — Марат находит прячущегося Вову  
-  [marat, vova]
-- `escalation` — Вова и Наташа сбегают, угоняют машину  
-  [vova, natasha]
-- `escalation` — Вова узнаёт о сердечном приступе отца  
-  [vova]
-- `turning_point` — Вова приезжает на юбилей отца  
-  [vova]
-- `climax` — Отец отказывается от Вовы, называет убийцей  
-  [vova, guest:father]
-- `resolution` — Вова умирает на руках Наташи  
-  [vova, natasha]
-
-**Interactions**
-
-- *thematic_rhyme*: all three storylines show characters facing the irreversible consequences of their choices — Andrey loses his freedom, Marat loses his innocence, Vova loses his life (belonging, love, leadership)
-- *convergence*: Ildar's pursuit directly leads to Vova's death (justice, leadership)
-- *dramatic_irony*: Ira tries to save Andrey just as he's about to be caught (redemption, belonging)
diff --git a/docs/knowledge/results/breakdown-td-s01.md b/docs/knowledge/results/breakdown-td-s01.md
deleted file mode 100644
index 208f034..0000000
--- a/docs/knowledge/results/breakdown-td-s01.md
+++ /dev/null
@@ -1,500 +0,0 @@
----
-type: note
-project: tvplotlines
-status: active
----
-
-# True Detective S01 — Storyline Breakdown
-
-## Context
-- **franchise_type**: serial
-- **story_engine**: Two detectives investigate a ritualistic murder that unravels a conspiracy, testing how far they'll go to confront darkness in themselves and society
-- **format**: limited
-
-## Cast
-- **Rustin Cohle** (`rust`) — aliases: Rust, Crash
-- **Martin Hart** (`marty`) — aliases: Marty
-- **Maggie Hart** (`maggie`) — aliases: Maggie
-- **Errol Childress** (`errol`) — aliases: Errol, the scarred man
-- **Billy Lee Tuttle** (`tuttle`) — aliases: Reverend Tuttle
-- **Thomas Papania** (`papania`) — aliases: Papania
-- **Maynard Gilbough** (`gilbough`) — aliases: Gilbough
-
-## Storylines
-
-### [A] Investigation (`investigation`)
-- **driver**: rust
-- **type**: serialized | **nature**: plot-led | **confidence**: solid
-- **goal**: uncover the truth behind the ritualistic murders and expose the conspiracy
-- **obstacle**: powerful people covering up evidence, corrupt officials, personal demons
-- **stakes**: justice for victims, stopping future murders, personal redemption
-- **span**: S01E01, S01E02, S01E03, S01E04, S01E05, S01E06, S01E07, S01E08
-
-### [B] Partnership (`partnership`)
-- **driver**: rust
-- **type**: serialized | **nature**: character-led | **confidence**: solid
-- **goal**: maintain working relationship with Hart despite philosophical differences
-- **obstacle**: conflicting worldviews, personal betrayals, Hart's affair with Maggie
-- **stakes**: solving the case, professional survival, personal connection
-- **span**: S01E01, S01E02, S01E05, S01E06, S01E07, S01E08
-
-### [B] Marriage (`marriage`)
-- **driver**: marty
-- **type**: serialized | **nature**: character-led | **confidence**: solid
-- **goal**: maintain his family while pursuing his desires
-- **obstacle**: infidelity, work obsession, inability to reconcile contradictions
-- **stakes**: family breakdown, loss of daughters, moral identity
-- **span**: S01E02, S01E03, S01E04, S01E05, S01E06, S01E07, S01E08
-
-### [C] Redemption (`redemption`)
-- **driver**: rust
-- **type**: serialized | **nature**: character-led | **confidence**: solid
-- **goal**: find meaning and purpose after personal tragedy
-- **obstacle**: nihilistic philosophy, guilt over daughter's death, addiction
-- **stakes**: spiritual salvation, will to live, connection to humanity
-- **span**: S01E01, S01E02, S01E05, S01E06, S01E07, S01E08
-
----
-
-## Episodes
-
-### S01E01
-**Theme**: the weight of confronting darkness
-
-**Investigation [A]**
-
-- `setup` — Rust and Marty arrive at the Dora Lange crime scene in the cane fields  
-  [rust, marty]
-- `setup` — They discover Dora's ritualistic posed body with antlers, spiral symbol, and twig structures  
-  [rust, marty]
-- `escalation` — Detectives learn Dora told Charlie Lange she would 'become a nun' and 'met a king'  
-  [rust, marty]
-- `escalation` — Investigation surfaces the Marie Fontenot disappearance case with devil nets  
-  [rust, marty]
-- `escalation` — Report mentions child chased by 'green-eared spaghetti monster'  
-  [rust, marty]
-- `escalation` — Reverend Tuttle's political connections raise suspicion about task force formation  
-  [rust, marty]
-- `escalation` — Black minister mentions police ignored vandalism and animal mutilation at his church  
-  [rust, marty]
-- `setup` — Present-day Papania and Gilbough interview Hart and Cohle separately about Dora Lange  
-  [papania, gilbough, rust, marty] *(also: partnership)*
-- `cliffhanger` — Cohle shown photograph of another similarly posed victim, suggesting killer still active  
-  [rust, papania, gilbough]
-
-**Partnership [B]**
-
-- `setup` — Hart invites Cohle over for dinner, unaware it's Cohle's daughter's death anniversary  
-  [marty, rust] *(also: redemption)*
-- `escalation` — Rust demonstrates his pessimistic philosophy about human consciousness  
-  [rust, marty] *(also: redemption)*
-- `escalation` — Marty represents conventional detective values contrasting with Rust's isolation  
-  [marty, rust] *(also: marriage)*
-- `cliffhanger` — Revealed that Hart and Cohle haven't spoken in ten years after 2002 falling-out  
-  [rust, marty]
-
-**Redemption [C]**
-
-- `setup` — Present-day Rust appears weathered and alcoholic while Marty runs successful security firm  
-  [rust, marty] *(also: partnership)*
-
-**Interactions**
-
-- *thematic_rhyme*: all storylines explore how confronting evil changes people - the case corrupts, partnership fractures, redemption becomes necessary (investigation, partnership, redemption)
-- *meta*: dual timeline structure reveals consequences before causes (investigation, partnership)
-- *dramatic_irony*: audience knows the partnership will fail catastrophically, but sees its hopeful beginning (investigation, partnership)
-
-### S01E02
-**Theme**: the weight of secrets and their corrosive power
-
-**Investigation [A]**
-
-- `escalation` — Cohle and Hart inform Dora's mother of her death  
-  [rust, marty]
-- `escalation` — Dora's mother mentions Dora recently visited claiming to attend church  
-  [rust, marty]
-- `escalation` — They interview Dora's friend Carla about drugs and a shelter near Spanish Lake  
-  [rust, marty]
-- `escalation` — Major Quesada warns they may be replaced by occult-crimes task force  
-  [rust, marty]
-- `escalation` — They investigate The Ranch brothel and interview Dora's friend  
-  [rust, marty]
-- `turning_point` — They find Dora's diary with references to King in Yellow and Carcosa  
-  [rust, marty]
-- `escalation` — They discover Friends of Christ Revival flyer  
-  [rust, marty]
-- `turning_point` — They find abandoned church with antler-crowned female mural  
-  [rust, marty]
-
-**Partnership [B]**
-
-- `escalation` — Rust insults the task force members and is reprimanded  
-  [rust] *(also: investigation)*
-- `escalation` — Marty pleads for more time and gets two-week deadline  
-  [marty] *(also: investigation)*
-- `turning_point` — Cohle deduces Hart is cheating with Lisa Tragnetti  
-  [rust] *(also: marriage)*
-
-**Marriage [B]**
-
-- `escalation` — Marty's in-laws visit and Maggie expresses frustration about his absences  
-  [marty, maggie]
-- `escalation` — Marty's daughters play with dolls in disturbing scene  
-  [marty]
-
-**Redemption [C]**
-
-- `setup` — Cohle reveals his daughter Sofia was killed in driveway accident  
-  [rust]
-- `escalation` — Cohle explains his marriage collapsed and he spiraled into addiction  
-  [rust]
-- `escalation` — Cohle describes four years undercover to avoid prosecution  
-  [rust]
-- `escalation` — Cohle reveals hospitalization after shooting cartel members  
-  [rust]
-- `escalation` — Cohle admits he still experiences chemical flashbacks  
-  [rust]
-
-**Interactions**
-
-- *thematic_rhyme*: all storylines explore how hidden truths destroy relationships and corrupt those who carry them (investigation, partnership, marriage, redemption)
-- *dramatic_irony*: Rust knows about Marty's affair but Maggie doesn't, creating tension in both relationships (partnership, marriage)
-- *convergence*: the disturbing doll scene suggests the occult conspiracy may be affecting Marty's family directly (investigation, marriage)
-
-### S01E03
-**Theme**: the gap between moral judgment and personal action
-
-**Investigation [A]**
-
-- `escalation` — Hart and Cohle locate preacher Joel Theriot and learn about the scarred man  
-  [rust, marty]
-- `escalation` — They face pressure to turn the case over to the task force  
-  [rust, marty] *(also: partnership)*
-- `escalation` — Cohle searches old case files for similar deaths  
-  [rust]
-- `turning_point` — Cohle discovers Rianne Olivier's case with similar elements  
-  [rust]
-- `escalation` — They learn Olivier attended Light of the Way school owned by Tuttle  
-  [rust, marty]
-- `turning_point` — They discover Olivier ran off with Reggie Ledoux  
-  [rust, marty]
-- `escalation` — They learn Ledoux is a drug cook, sex offender, and Lange's ex-husband's cellmate  
-  [rust, marty]
-- `turning_point` — Ledoux becomes their primary suspect  
-  [rust, marty]
-- `cliffhanger` — Reggie Ledoux appears in the bayou with gas mask and machete  
-  [guest:ledoux]
-
-**Marriage [B]**
-
-- `escalation` — Hart begins reconnecting with Maggie  
-  [marty, maggie]
-- `escalation` — Maggie shows growing fascination with Cohle  
-  [maggie] *(also: partnership)*
-- `climax` — Hart assaults Lisa's new boyfriend out of jealousy  
-  [marty] *(also: redemption)*
-- `turning_point` — Hart realizes his inability to reconcile morality with behavior  
-  [marty] *(also: redemption)*
-
-**Interactions**
-
-- *thematic_rhyme*: all storylines explore the disconnect between what characters believe is right and what they actually do (investigation, marriage, redemption)
-- *dramatic_irony*: Hart judges others' morality while being blind to his own hypocrisy, and Maggie's interest in Cohle creates tension Hart doesn't fully recognize (marriage, partnership)
-- *convergence*: the pressure to hand over the case tests both their detective work and their ability to work together (investigation, partnership)
-
-### S01E04
-**Theme**: crossing the line
-
-**Investigation [A]**
-
-- `escalation` — Rust and Marty interrogate Charlie Lange about Reggie Ledoux  
-  [rust, marty]
-- `escalation` — Charlie reveals Reggie discussed devil-worship by rich men involving sacrificing women and children  
-  [guest:charlie]
-- `escalation` — Charlie mentions 'Carcosa' and 'the Yellow King' and describes spiral brand as 'their sign'  
-  [guest:charlie]
-- `escalation` — Charlie admits showing Reggie explicit Polaroids of Dora  
-  [guest:charlie]
-- `escalation` — Marty tracks Tyrone Weems to warehouse rave and violently confronts him  
-  [marty]
-- `escalation` — Tyrone reveals Reggie cooks exclusively for Iron Crusaders biker gang  
-  [guest:tyrone]
-- `turning_point` — Cohle devises off-the-books plan using his undercover biker contacts  
-  [rust] *(also: partnership)*
-- `escalation` — Cohle steals cocaine from police evidence room to use as bait  
-  [rust] *(also: partnership)*
-- `escalation` — Cohle reconnects with Ginger, posing as former cartel security man  
-  [rust]
-- `escalation` — Ginger agrees to connect Cohle with Ledoux's supplier in exchange for helping rob stash house  
-  [guest:ginger]
-- `climax` — Cohle enters stash house with bikers disguised as cops and steals drugs  
-  [rust]
-- `climax` — Shootout erupts and neighborhood descends into chaos  
-  [rust]
-- `climax` — Cohle kidnaps Ginger and fights through houses to Hart's getaway car  
-  [rust, marty] *(also: partnership)*
-- `seed` — Papania and Gilbough question why Cohle took two weeks' leave at critical moment  
-  [papania, gilbough]
-- `seed` — Both Cohle and Hart claim Cohle visited sick father, but no hospital records exist  
-  [rust, marty] *(also: partnership)*
-
-**Marriage [B]**
-
-- `turning_point` — Marty's affair with Lisa is exposed to Maggie  
-  [marty, maggie]
-- `escalation` — Marty's marriage unravels as he displays aggressive behavior toward both women  
-  [marty, maggie]
-- `escalation` — Marty refuses accountability and blames his father's death and alcohol  
-  [marty]
-
-**Interactions**
-
-- *thematic_rhyme*: both storylines explore characters crossing moral boundaries - Rust breaking the law to pursue justice, Marty betraying his marriage vows (investigation, marriage)
-- *dramatic_irony*: the 2012 interrogators suspect Rust and Marty are lying about the two weeks' leave, while the audience sees the dangerous undercover operation (investigation, partnership)
-
-### S01E05
-**Theme**: the corruption of justice
-
-**Investigation [A]**
-
-- `escalation` — Cohle and Ginger meet with DeWall Ledoux to discuss a drug deal  
-  [rust]
-- `escalation` — DeWall senses something dark in Cohle and refuses the deal  
-  [rust] *(also: redemption)*
-- `escalation` — Hart follows DeWall to a remote compound in the bayou  
-  [marty]
-- `escalation` — Cohle and Hart approach the property avoiding booby traps  
-  [rust, marty] *(also: partnership)*
-- `climax` — Hart apprehends Reggie Ledoux while Cohle draws on DeWall  
-  [marty, rust] *(also: partnership)*
-- `climax` — Hart discovers two kidnapped children in horrific conditions  
-  [marty]
-- `turning_point` — Hart executes Ledoux after hearing his last words about black stars and Carcosa  
-  [marty] *(also: partnership)*
-- `resolution` — DeWall flees and is killed by his own land mine  
-  [rust]
-- `resolution` — Both detectives are commended as heroes for rescuing the child  
-  [rust, marty] *(also: partnership)*
-- `escalation` — Cohle interrogates Guy Francis who confesses to crimes  
-  [rust]
-- `turning_point` — Francis claims Ledoux was not the real killer and mentions the Yellow King  
-  [rust]
-- `escalation` — Francis is found dead of apparent suicide after a suspicious phone call  
-  [rust]
-- `escalation` — Cohle identifies officer Childress connected to Marie Fontenot case  
-  [rust]
-- `escalation` — Cohle visits abandoned Light of the Way school and discovers Yellow King symbols  
-  [rust] *(also: redemption)*
-
-**Partnership [B]**
-
-- `escalation` — Cohle fires assault rifle to create false evidence of a shootout  
-  [rust] *(also: investigation)*
-- `turning_point` — Papania and Gilbough tell Hart they suspect Cohle is behind the killings  
-  [marty, papania, gilbough] *(also: investigation)*
-- `escalation` — They reveal Cohle was at Lake Charles crime scene and connected to Tuttle's death  
-  [papania, gilbough] *(also: investigation)*
-- `escalation` — They demand access to Cohle's storage unit which he refuses  
-  [marty] *(also: investigation)*
-
-**Marriage [B]**
-
-- `setup` — Hart has reconciled with Maggie and been promoted seven years later  
-  [marty, maggie]
-- `escalation` — Hart's daughter Audrey is acting out with dark behavior  
-  [marty]
-- `escalation` — Marty slaps Audrey when she curses at him  
-  [marty]
-
-**Redemption [C]**
-
-- `setup` — Cohle has a girlfriend named Laurie and is a renowned interrogator  
-  [rust]
-
-**Interactions**
-
-- *thematic_rhyme*: all storylines explore how pursuing truth and justice corrupts relationships and moral boundaries (investigation, partnership, marriage)
-- *dramatic_irony*: the audience knows Cohle is investigating independently while Hart believes they solved the case (investigation, partnership)
-- *convergence*: the investigation storyline directly threatens the partnership when Hart learns of suspicions about Cohle (investigation, partnership)
-
-### S01E06
-**Theme**: the destructive cost of obsession
-
-**Investigation [A]**
-
-- `escalation` — Cohle investigates missing persons cases and discovers connections to Tuttle's Wellspring Foundation  
-  [rust]
-- `escalation` — Cohle tracks down former preacher Theriot who reveals Tuttle had photos of nude children  
-  [rust]
-- `escalation` — Theriot explains he was intimidated into silence after reporting to Deacon Farrar  
-  [rust]
-- `escalation` — Cohle visits Kelly Reider who describes a giant with scars and screams about the man's face  
-  [rust]
-
-**Redemption [C]**
-
-- `escalation` — Cohle coldly interrogates infanticide woman, suggesting she kill herself  
-  [rust] *(also: partnership)*
-
-**Partnership [B]**
-
-- `escalation` — Marty refuses to engage with Cohle's harsh interrogation methods  
-  [marty]
-- `climax` — Marty attacks and beats Rust in the police station parking lot  
-  [marty, rust] *(also: marriage)*
-- `resolution` — Rust quits the police force  
-  [rust] *(also: investigation)*
-- `seed` — Marty leaves the station after refusing to believe Papania and Gilbough's claims about Rust  
-  [marty, papania, gilbough]
-- `seed` — Maggie is interviewed and defends Rust's character  
-  [maggie]
-- `seed` — Rust's truck pulls up behind Marty's car in 2012 and they exchange greetings  
-  [rust, marty] *(also: investigation)*
-
-**Marriage [B]**
-
-- `escalation` — Marty confronts and beats two young men found with his daughter Audrey  
-  [marty]
-- `escalation` — Marty starts an affair with Beth, a former Ranch worker  
-  [marty]
-- `turning_point` — Maggie discovers evidence of Marty's infidelity on his phone and clothes  
-  [maggie]
-- `escalation` — Maggie attempts to sleep with a stranger at a bar but fails  
-  [maggie]
-- `climax` — Maggie goes to Rust's apartment and seduces him  
-  [maggie, rust] *(also: partnership, redemption)*
-- `climax` — Maggie tells Marty about her encounter with Rust  
-  [maggie, marty] *(also: partnership)*
-
-**Interactions**
-
-- *thematic_rhyme*: all storylines explore how obsessive pursuit of truth, control, or meaning destroys relationships and moral boundaries (investigation, partnership, marriage, redemption)
-- *convergence*: Maggie's seduction of Rust directly destroys the partnership between the detectives (marriage, partnership)
-- *dramatic_irony*: the audience knows Rust is pursuing the truth while the 2012 investigators suspect him of being involved (investigation, partnership)
-
-### S01E07
-**Theme**: the weight of unfinished business
-
-**Partnership [B]**
-
-- `setup` — Rust and Marty meet at a bar in 2012  
-  [rust, marty]
-- `turning_point` — Marty decides to join Rust's investigation  
-  [marty] *(also: investigation)*
-
-**Redemption [C]**
-
-- `escalation` — Rust reveals he's been functional but hammered for ten years  
-  [rust]
-- `turning_point` — Rust confesses he intends to resolve case before ending his life  
-  [rust] *(also: investigation)*
-- `escalation` — Rust describes existence as meaningless circle of violence  
-  [rust]
-
-**Investigation [A]**
-
-- `setup` — Rust explains he returned because a man remembers his debts  
-  [rust] *(also: redemption)*
-- `escalation` — Rust shows Marty his elaborate conspiracy board in storage unit  
-  [rust, marty]
-- `escalation` — Rust theorizes Dora Lange connects to broader Tuttle family network  
-  [rust]
-- `escalation` — Rust identifies scarred man through witness interviews  
-  [rust]
-- `escalation` — Rust reveals illegal break-ins at Tuttle properties in 2010  
-  [rust]
-- `turning_point` — Rust shows Marty VHS tape of Marie Fontenot ritual  
-  [rust, marty]
-- `escalation` — Rust and Marty discover Marie Fontenot's file was removed  
-  [rust, marty]
-- `escalation` — They learn Deputy Geraci mishandled Marie's case  
-  [rust, marty]
-- `escalation` — They discover Sheriff Childress knew Marie's family  
-  [rust, marty]
-- `escalation` — Miss Delores reveals scarred man is likely Tuttle family member  
-  [rust, marty, guest:delores]
-- `escalation` — Delores mentions Carcosa and the Yellow King  
-  [guest:delores]
-- `escalation` — Papania and Gilbough encounter the scarred man mowing grass  
-  [papania, gilbough, errol]
-- `escalation` — The scarred man tells detectives his family has been here a long time  
-  [errol, papania, gilbough]
-- `escalation` — Detectives drive away missing their suspect  
-  [papania, gilbough]
-- `escalation` — Rust and Marty confront Deputy Geraci at gunpoint on boat  
-  [rust, marty, guest:geraci]
-
-**Marriage [B]**
-
-- `resolution` — Marty visits Maggie and thanks her  
-  [marty, maggie]
-- `resolution` — Marty hints to Maggie he may not return  
-  [marty] *(also: investigation)*
-
-**Interactions**
-
-- *thematic_rhyme*: all storylines deal with confronting the past and seeking closure (investigation, redemption, marriage)
-- *dramatic_irony*: the audience sees Errol is the scarred man while Papania and Gilbough miss him completely (investigation)
-- *convergence*: Marty's decision to rejoin Rust merges their personal relationship with the case (investigation, partnership)
-
-### S01E08
-**Theme**: light conquering darkness
-
-**Investigation [A]**
-
-- `setup` — Errol tortures his bound father while speaking in shifting accents  
-  [errol]
-- `escalation` — Rust and Marty force Sheriff Geraci to watch the VHS tape  
-  [rust, marty] *(also: partnership)*
-- `escalation` — Rust arranges for sniper associate to monitor Geraci  
-  [rust]
-- `turning_point` — Rust and Marty identify the green-eared spaghetti monster as a house painter  
-  [rust, marty]
-- `turning_point` — They trace work orders to Childress and Son Maintenance  
-  [rust, marty]
-- `escalation` — Marty discovers Billy Childress restrained with sewn lips  
-  [marty]
-- `escalation` — Marty finds mummified remains and child clothing in the house  
-  [marty]
-- `escalation` — Errol flees into the labyrinthine Carcosa structure  
-  [errol]
-- `escalation` — Rust pursues Errol into the underground catacomb space  
-  [rust] *(also: partnership)*
-- `climax` — Errol ambushes and stabs Rust with a knife  
-  [errol, rust]
-- `climax` — Errol attacks Marty with a hatchet  
-  [errol, marty] *(also: partnership)*
-- `climax` — Rust and Marty fatally shoot Errol  
-  [rust, marty] *(also: partnership)*
-- `resolution` — Papania and Gilbough arrive with backup  
-  [papania, gilbough]
-- `resolution` — Forensic teams link Errol to dozens of missing persons cases  
-  [guest:forensic_teams]
-- `resolution` — State attorney general discredits Tuttle family connections  
-  [guest:attorney_general]
-
-**Redemption [C]**
-
-- `escalation` — Rust experiences hallucinatory vision of spiraling darkness  
-  [rust] *(also: investigation)*
-- `climax` — Rust describes near-death experience with his daughter and father  
-  [rust]
-- `resolution` — Rust's nihilistic worldview fundamentally shifts  
-  [rust]
-- `resolution` — Rust observes that the light is winning over darkness  
-  [rust]
-
-**Marriage [B]**
-
-- `resolution` — Marty's daughters visit him in the hospital  
-  [marty]
-
-**Partnership [B]**
-
-- `resolution` — Marty wheels Rust outside the hospital  
-  [marty, rust]
-
-**Interactions**
-
-- *thematic_rhyme*: both storylines involve confronting ultimate darkness - literal evil in Carcosa and existential void in Rust's psyche - and finding light (investigation, redemption)
-- *convergence*: all storylines converge in Carcosa where the case is solved, partnership is tested and reaffirmed, and Rust finds spiritual transformation (investigation, partnership, redemption)
diff --git a/docs/knowledge/results/run-bb-all-seasons.py b/docs/knowledge/results/run-bb-all-seasons.py
deleted file mode 100644
index 07ae4da..0000000
--- a/docs/knowledge/results/run-bb-all-seasons.py
+++ /dev/null
@@ -1,137 +0,0 @@
-"""Run Plotter on all 5 seasons of Breaking Bad with prior-season chaining.
-
-Usage:
-    python run_bb_all_seasons.py [--output-dir DIR] [--seasons 1-5]
-
-Reads synopses from plotter-app/data/synopses/BB_S*.txt,
-runs get_plotlines() for each season passing prior result,
-saves JSON output per season.
-"""
-
-import argparse
-import json
-import re
-import sys
-from pathlib import Path
-
-from dotenv import load_dotenv
-
-# Load API keys from plotter's .env
-_PLOTTER_DIR = Path("/Users/nvashko/Projects/1-projects/plotter")
-load_dotenv(_PLOTTER_DIR / ".env")
-
-from plotter import get_plotlines
-from plotter.models import PlotterResult
-
-SYNOPSES_DIR = Path("/Users/nvashko/Projects/1-projects/plotter-app/data/synopses")
-# Fallback if running from different location
-if not SYNOPSES_DIR.exists():
-    SYNOPSES_DIR = Path("/Users/nvashko/Projects/1-projects/plotter-app/data/synopses")
-
-_EPISODE_RE = re.compile(r"BB_(S\d{2}E\d{2})\.txt$")
-
-
-def load_season(season: int) -> dict[str, str]:
-    """Load all synopsis files for a season into a dict."""
-    prefix = f"BB_S{season:02d}E"
-    episodes = {}
-    for path in sorted(SYNOPSES_DIR.glob(f"{prefix}*.txt")):
-        match = _EPISODE_RE.search(path.name)
-        if match:
-            episode_id = match.group(1)
-            episodes[episode_id] = path.read_text(encoding="utf-8").strip()
-    if not episodes:
-        raise FileNotFoundError(f"No synopsis files found for season {season} in {SYNOPSES_DIR}")
-    return episodes
-
-
-def save_result(result: PlotterResult, output_dir: Path, season: int) -> Path:
-    """Save PlotterResult as JSON."""
-    output_dir.mkdir(parents=True, exist_ok=True)
-    path = output_dir / f"bb_s{season:02d}_result.json"
-    path.write_text(
-        json.dumps(result.to_dict(), ensure_ascii=False, indent=2),
-        encoding="utf-8",
-    )
-    return path
-
-
-def load_result(output_dir: Path, season: int) -> PlotterResult | None:
-    """Load a previously saved result to use as prior."""
-    path = output_dir / f"bb_s{season:02d}_result.json"
-    if not path.exists():
-        return None
-    data = json.loads(path.read_text(encoding="utf-8"))
-    from plotter.models import CastMember, EpisodeBreakdown, Plotline, SeriesContext
-    from dataclasses import fields
-    # Reconstruct PlotterResult from dict
-    ctx = SeriesContext(**{f.name: data["context"].get(f.name) for f in fields(SeriesContext)})
-    cast = [CastMember(**c) for c in data.get("cast", [])]
-    plotlines = [Plotline(**p) for p in data.get("plotlines", [])]
-    return PlotterResult(context=ctx, cast=cast, plotlines=plotlines)
-
-
-def parse_season_range(s: str) -> list[int]:
-    """Parse '1-5' or '2' or '1,3,5' into a list of season numbers."""
-    seasons = []
-    for part in s.split(","):
-        if "-" in part:
-            start, end = part.split("-", 1)
-            seasons.extend(range(int(start), int(end) + 1))
-        else:
-            seasons.append(int(part))
-    return seasons
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Run Plotter on Breaking Bad S01-S05")
-    parser.add_argument(
-        "--output-dir", type=Path,
-        default=Path(__file__).parent / "bb_results",
-        help="Directory for output JSON files",
-    )
-    parser.add_argument(
-        "--seasons", type=str, default="1-5",
-        help="Which seasons to run (e.g. '1-5', '2', '3-5')",
-    )
-    args = parser.parse_args()
-
-    seasons = parse_season_range(args.seasons)
-    output_dir = args.output_dir.resolve()
-
-    prior = None
-    for season in seasons:
-        # Load prior from previous season if it exists and we didn't just compute it
-        if prior is None and season > 1:
-            prior = load_result(output_dir, season - 1)
-            if prior:
-                print(f"  Loaded prior from S{season-1:02d} result file")
-
-        episodes = load_season(season)
-        print(f"\n{'='*60}")
-        print(f"Season {season}: {len(episodes)} episodes")
-        if prior:
-            print(f"  Prior: {len(prior.cast)} cast, {len(prior.plotlines)} plotlines")
-        print(f"{'='*60}")
-
-        result = get_plotlines(
-            show="Breaking Bad",
-            season=season,
-            episodes=episodes,
-            prior=prior,
-        )
-
-        path = save_result(result, output_dir, season)
-        print(f"\nSaved to {path}")
-        print(f"  Cast: {', '.join(c.name for c in result.cast)}")
-        print(f"  Plotlines: {', '.join(p.name for p in result.plotlines)}")
-        if result.usage:
-            print(f"  Usage: {result.usage}")
-
-        prior = result
-
-    print(f"\nDone! Results in {output_dir}")
-
-
-if __name__ == "__main__":
-    main()
diff --git a/docs/knowledge/specs/abstract.md b/docs/knowledge/specs/abstract.md
deleted file mode 100644
index eeb0f3d..0000000
--- a/docs/knowledge/specs/abstract.md
+++ /dev/null
@@ -1,31 +0,0 @@
----
-type: note
-project: preprint
-status: active
----
-
-# Abstract
-
-
-tvplotlines, a Python library that answers these questions:
-How do I figure out which is my A plot and which is my B plot?
-How do you balance A, B, C stories without one getting lost?
-How do you break down a show to understand its structure?
-How do you know when a subplot is a B story vs just a scene?
-How does [show] manage 5 storylines without losing the audience?
-Pick a show you love and pull it apart to see how it works
-
-
-TV episodes run two or more plotlines at once—an A story that takes most of the screen time, B and C stories that cut against it or echo it. Three per episode is standard; ensemble shows often have four or five. Picking which plotlines to tell, how fast to move them, when to collide them—that is the architecture of a show. Dialogue, direction, performance are built on top. If the architecture is weak, no amount of good design will fix it.
-
-tvplotlines, a Python library that extracts this architecture from episode synopses using a multi-pass LLM   pipeline.
-
-
-
-TV episodes  typically feature two or more parallel plotlines, denoted by letters A, B, C: a main A plot that dominates screen time and secondary B plots that may offer thematic parallels or counterpoint. Three stories per episode are typical, though some  shows have more—in ensemble shows it's not unheard of to have 4  or 5 concurrent plotlines.
-
-плотлайнс и  есть гений архитектора шоу. все что потом - чаще всего дизайн, он  должен быть талантливый, но без архитектуры слабо работает. Эта  
-
-статья о библиотеке которая достает архитектуру шоу за минуты
-
-tvplotlines, a Python library that extracts this architecture from episode synopses using a multi-pass LLM   pipeline.
diff --git a/docs/knowledge/specs/architecture.md b/docs/knowledge/specs/architecture.md
deleted file mode 100644
index 9cfebe0..0000000
--- a/docs/knowledge/specs/architecture.md
+++ /dev/null
@@ -1,246 +0,0 @@
----
-type: spec
-project: tvplotlines
-status: active
-date: 2026-03-23
----
-
-# Architecture
-
-TV seasons contain dozens of interwoven plotlines, but no structured representation of that weave exists. Synopses describe what happens; they don't say which events belong to which plotline, where each plotline starts and ends, or how plotlines interact across episodes. This document explains how the tvplotlines pipeline turns raw synopses into that structured representation — what each pass does, why it's designed this way, and what tricks keep LLM calls cheap and results consistent.
-
-## Design principles
-
-* **A pure function, nothing else**
-
-    The entire library is one function call. Synopses go in, structured plotlines come out. No database, no files on disk, no sessions, no hidden state between runs. This makes the library easy to test, easy to embed, and impossible to misconfigure — there is nothing to configure beyond the function arguments.
-
-* **The LLM reads; code enforces**
-
-    Each pass asks the LLM to do what humans do well: read a synopsis and identify who wants what, what stands in their way, and what's at stake. The LLM never decides how to structure the output, what fields to include, or whether a plotline is valid. Code handles all of that — JSON schema validation, referential integrity checks, rank distribution rules. This split exists because LLMs are good readers but unreliable bookkeepers.
-
-* **Deterministic by default**
-
-    All LLM calls use temperature=0. Pass 1 runs three identical calls and picks the majority result. The same synopses produce the same plotlines. This matters because the library's output feeds downstream tools — dashboards, editors, exports — that break when structure shifts between runs.
-
-* **Extract first, review second**
-
-    The pipeline has two phases. The first phase (Pass 0 through Pass 2) extracts raw structure: what plotlines exist, what events belong to each plotline in each episode. The second phase (post-processing and Pass 3) reviews that structure and corrects it. Separating extraction from review means the LLM in Pass 3 sees the full picture — all plotlines, all episodes, all spans — before making editorial decisions like merging two plotlines or promoting a rank.
-
-* **Every LLM response is validated**
-
-    The library never trusts raw LLM output. Every response is parsed, checked against the expected schema, and tested for referential integrity: does this character ID exist in the cast? Does this plotline ID exist? Is the rank distribution legal for this format? Validation failures raise clear errors instead of propagating silently into downstream passes.
-
-## Overview
-
-The pipeline has two main phases: extract and review. Both are orchestrated by `pipeline.py`.
-
-### Extract phase
-
-This phase starts with a set of episode synopses and builds the raw structural model of the season. It runs three passes in sequence, each one building on the output of the previous.
-
-Pass 0 reads a few synopses and determines the show's format — procedural, serial, hybrid, or limited — along with a one-sentence story engine that describes how the show generates plot, and a genre tag. Pass 1 reads all synopses and extracts the cast and plotlines, each described by its Story DNA: hero, goal, obstacle, stakes. Pass 2 reads one episode at a time and assigns individual events to plotlines, tagging each event with its narrative function (setup, escalation, turning point, climax, resolution) and capturing the episode's thematic summary.
-
-### Review phase
-
-This phase takes the raw extraction and refines it. Post-processing computes derived metrics — which episodes each plotline spans, how much screen weight it carries per episode, whether the rank distribution matches the format. Pass 3 then reviews the full picture and issues structural corrections: merge two plotlines that are really one, promote a plotline that earned more screen time than its rank suggests, reassign a misplaced event. Code applies these corrections mechanically; the LLM only decides what to change, not how.
-
-## How context shapes the pipeline
-
-Every TV show has a format that determines how plotlines behave. A procedural like House resets its A-plotline every episode — the medical case is self-contained, while serialized B and C plotlines carry across the season. A serial like Breaking Bad runs all plotlines continuously. A hybrid like The Good Wife mixes both. Getting this wrong cascades through the entire pipeline: if the model thinks a serial is a procedural, it will look for a case-of-the-week plotline that doesn't exist.
-
-Pass 0 exists to detect this format from the synopses themselves. It reads the first two or three episodes and returns a format classification, a story engine — a one-sentence description of the show's plot-generation mechanism — and a reasoning field that explains why this format was chosen. For House, the story engine might be "a new patient each episode forces a diagnostic puzzle." For Breaking Bad, "Walt's choices create escalating consequences." The reasoning field is not used downstream but makes the classification auditable: if Pass 0 misclassifies a show, the reasoning tells you why.
-
-The format classification controls downstream behavior. In Pass 1, it determines how many A-rank plotlines are legal: one for serial, procedural, and hybrid formats; two or more for ensemble shows like This Is Us. In post-processing, it determines how rank validation works. The caller can also provide context directly, bypassing Pass 0 entirely.
-
-Two boolean flags extend the format. `is_ensemble` marks shows with multiple co-equal A-rank plotlines. `is_anthology` marks shows where seasons are independent — when this is true, prior-season continuity is disabled.
-
-## How plotlines are extracted
-
-A synopsis describes events but doesn't say which events belong together. Two characters meeting in episode three might advance a plotline that started in episode one, or it might be a standalone beat. Pass 1 resolves this ambiguity. The LLM reads all synopses for the season and returns two things: a cast list (characters with IDs and aliases) and a set of plotlines.
-
-Each plotline is described by four fields borrowed from narrative theory, collectively called Story DNA: the hero (who drives the plotline), the goal (what they want), the obstacle (what prevents them), and the stakes (what happens if they fail). These four fields anchor the plotline's identity. Everything else — rank, type, nature, confidence — describes the plotline's structural role in the season.
-
-Rank (A, B, C, or runner) reflects screen time weight. Type distinguishes between case-of-the-week plotlines that reset every episode, serialized plotlines that run across episodes, and runners — low-key threads that surface occasionally and pay off late. Nature marks whether the plotline is plot-led or character-led. Confidence signals how certain the extraction is: solid, partial, or inferred.
-
-### Majority voting
-
-Pass 1 makes three parallel LLM calls with identical inputs and picks the result that appears most often. This exists because even at temperature=0, LLM output can vary slightly between calls — a plotline might get a different name or a borderline character might be included or excluded. Voting stabilizes the output. Whether this is necessary at temperature=0 remains an open question; it's a candidate for removal after ablation testing.
-
-### Prior season continuity
-
-When a previous season's result is provided, Pass 0 is skipped entirely — the context carries over. Pass 1 receives the prior season's cast and plotlines as additional input and marks each prior plotline with a continuity status: CONTINUES (same hero, same goal), TRANSFORMED (same hero, new goal), or ENDED (resolved). Character and plotline IDs are preserved across seasons so that downstream tools can track arcs over time. Anthology formats disable this mechanism — each season starts fresh.
-
-## How events are assigned to plotlines
-
-Knowing what plotlines exist is not enough — each individual event in each episode needs to be linked to the plotline it advances. A single synopsis might contain beats from three different plotlines interleaved in a few paragraphs. Pass 2 resolves this by processing one episode at a time.
-
-For each episode, the LLM reads the synopsis alongside the cast and plotline definitions from Pass 1. It returns a structured breakdown: a thematic summary of the episode, a list of events, a set of interactions between plotlines, and suggested patches.
-
-Each event is a single narrative beat — one sentence describing what happened. The LLM assigns it to a plotline (or marks it as unassigned) and tags it with a narrative function. It also lists the characters involved and notes which other plotlines the event secondarily affects. Narrative functions position events within a plotline's arc: setup, escalation, turning point, climax, resolution. An event's function tells you where in the story the plotline stands at that moment.
-
-Interactions capture how plotlines relate within an episode. A thematic rhyme means two plotlines echo the same theme. Dramatic irony means the audience knows something a character doesn't. Convergence means two plotlines physically meet. Meta covers structural devices like twist-reveals or time jumps.
-
-Patches are the LLM's self-correction mechanism. When Pass 2 encounters something that doesn't fit the plotline definitions from Pass 1 — an orphan event with no matching plotline, a plotline that should be split, a rank that looks wrong — it flags the issue as a patch. Patches are not applied during Pass 2. They're passed forward to Pass 3 as additional context for the structural review.
-
-### Execution modes
-
-Processing episodes is the most expensive part of the pipeline — one LLM call per episode. The library offers three modes to manage this cost.
-
-Parallel mode (the default) sends all episodes at once as concurrent async calls. This is the fastest option. The system prompt is cached on the API side, so only the first episode pays the full prompt cost.
-
-Batch mode uses the Anthropic Message Batches API. All episodes are submitted as a single batch job at a 50% discount. The trade-off is latency — batch jobs are processed asynchronously and may take minutes to hours.
-
-Sequential mode processes one episode at a time. It's slower and costs the same as parallel mode, but fires a callback after each episode, making it useful for debugging and progress monitoring.
-
-## What post-processing computes
-
-Raw LLM output from Pass 2 has gaps. Some events lack a plotline assignment. Plotline ranks reflect the LLM's judgment but not the actual data. Span and weight — how many episodes a plotline covers and how much screen time it commands — can't be known until all episodes are processed. Post-processing fills these gaps with four deterministic computations, no LLM calls.
-
-Orphan assignment resolves events that Pass 2 left unlinked to any plotline. For each orphan event, the code looks at which characters are involved, finds the plotlines those characters most often appear in, and assigns the event to the best match.
-
-Span computation collects, for each plotline, the list of episodes where it has at least one event. This is a concrete measure of how many episodes a plotline actually appears in, as opposed to how many it was intended to cover.
-
-Weight computation measures how much screen time a plotline commands per episode. A plotline with the most events in an episode gets "primary" weight. Those with fewer events get "background." A single event earns "glimpse."
-
-Rank validation checks whether the A/B/C distribution matches the show's format. If an A-rank plotline only spans 25% of the season, the code demotes it to B and raises a diagnostic flag. If a single plotline accounts for more than 50% of all events, a dominance flag goes up. These diagnostics feed into Pass 3.
-
-## How the structural review works
-
-Extraction passes work episode by episode — none of them sees the full season at once. This means systematic errors accumulate: a plotline that spans two episodes might be identified as two separate plotlines; a rank assigned from three synopses might not hold up across twelve. Pass 3 exists to catch these errors.
-
-Pass 3 is the editorial pass. It sees everything: all plotlines with their spans and per-episode weights, all events across all episodes, all patches from Pass 2, and all diagnostic flags from post-processing. From this full picture, it issues verdicts — structural corrections to apply.
-
-Six verdict types exist, each corresponding to an editorial decision. MERGE combines two plotlines that are really phases of the same story — if "Walt starts cooking" and "Walt builds an empire" share a hero and one flows into the other, they should be one plotline. REASSIGN moves a misplaced event from one plotline to another. PROMOTE and DEMOTE adjust a plotline's rank when the data contradicts the original assignment. CREATE adds a new plotline when multiple orphan events form a coherent thread that Pass 1 missed. DROP removes a plotline that turned out to be noise, redistributing its events elsewhere.
-
-The LLM decides which verdicts to issue and returns a free-text quality assessment alongside them. Code then applies each verdict mechanically — updating plotline lists, reassigning events, recomputing spans. After all verdicts are applied, the pipeline re-runs span computation and rank validation to ensure the corrections didn't introduce new inconsistencies.
-
-## The LLM call structure
-
-Each LLM call has two parts: a system prompt and a user message. The system prompt is the full prompt file — rules, definitions, output format — unchanged across calls within the same pass. The user message carries the concrete data for one specific call.
-
-```
-Pass 0:  1 call    system = pass0.md
-                    user   = {show, season, first 2–3 synopses}
-
-Pass 1:  3 calls   system = pass1.md
-                    user   = {show, season, context, all synopses}
-
-Pass 2:  N calls   system = pass2.md  ← cached across episodes
-                    user   = {episode synopsis, cast, plotlines}
-
-Pass 3:  1 call    system = pass3.md
-                    user   = {full result + diagnostics}
-```
-
-A full run costs 5+N LLM calls, where N is the number of episodes. If majority voting in Pass 1 is removed after ablation testing, that drops to 3+N.
-
-### Prompt caching
-
-The system prompt for Pass 2 is identical across all episodes. With Anthropic's prompt caching, the API charges full price for the first episode and a 90% discount on system prompt tokens for every subsequent episode. This is the single largest cost optimization in the pipeline — Pass 2 prompts are 10-15KB, and a typical season has 10-24 episodes.
-
-### Batching
-
-Pass 2 calls are independent — episode order doesn't matter, and no call depends on another's result. Batch mode (described in "Execution modes" above) exploits this by submitting all episodes as one API batch job at half price.
-
-## Two layers: library and application
-
-```
-┌─────────────────────────────────────────────┐
-│  Application (proprietary)                  │
-│                                             │
-│  UI → editing → database → export           │
-│         │                     ▲              │
-│         ▼                     │              │
-│   get_plotlines()  →  result                │
-│                                             │
-│  ┌─────────────────────────────────────┐    │
-│  │  Library (open source, pip)         │    │
-│  │                                     │    │
-│  │  synopses → processing → result    │    │
-│  │  (no DB, no files, no UI)          │    │
-│  └─────────────────────────────────────┘    │
-└─────────────────────────────────────────────┘
-```
-
-The library is pure computation — data in, answer out. It knows nothing about files, databases, or interfaces. The application is a separate product built on top: it displays results, stores them, and lets users edit. Open source covers the library only.
-
-## Resilience
-
-The library remains a pure function with no stored state. But it survives API outages and lets callers save intermediate results for resumption.
-
-### Retries
-
-Transient errors — connection drops, rate limits, 500s — are automatically retried with exponential backoff (up to 3 attempts, delays of 2/4/8 seconds). Each request has a configurable timeout (default 120 seconds). In parallel mode, failed episodes do not crash the whole run — successful results are preserved and only failures are retried.
-
-### Callbacks
-
-```python
-from tvplotlines import get_plotlines, PipelineCallback
-
-class SaveCheckpoints(PipelineCallback):
-    def on_pass1_complete(self, cast, plotlines):
-        save_json("checkpoint_pass1.json", {"cast": cast, "plotlines": plotlines})
-
-    def on_episode_complete(self, index, breakdown):
-        # Only fires in sequential mode
-        save_json(f"checkpoint_ep{index}.json", breakdown)
-
-    def on_batch_submitted(self, batch_id):
-        save_text("batch_id.txt", batch_id)  # save for crash recovery
-
-result = get_plotlines(
-    show="House", season=1, episodes=synopses,
-    pass2_mode="sequential",
-    callback=SaveCheckpoints(),
-)
-```
-
-`PipelineCallback` is a base class with no-op methods. Override the ones you need:
-
-| Method | When it fires |
-|--------|--------------|
-| `on_pass0_complete(context)` | After context detection |
-| `on_pass1_complete(cast, plotlines)` | After plotline and cast extraction |
-| `on_episode_complete(index, breakdown)` | After each episode (sequential mode only) |
-| `on_pass2_complete(breakdowns)` | After all episodes are processed |
-| `on_batch_submitted(batch_id)` | After batch creation, before polling |
-| `on_pass3_complete(verdicts)` | After structural review |
-
-A buggy callback never kills the pipeline — exceptions are logged and execution continues.
-
-### Resume
-
-If a run is interrupted, restart from saved intermediate results to skip expensive LLM calls:
-
-```python
-# Pipeline crashed after Pass 2 — rerun only Pass 3
-result = get_plotlines(
-    show="House", season=1, episodes=synopses,
-    context=saved_context,           # skip Pass 0
-    cast=saved_cast,                 # skip Pass 1
-    plotlines=saved_plotlines,       #
-    breakdowns=saved_breakdowns,     # skip Pass 2
-)
-```
-
-Two constraints: `cast` and `plotlines` must be provided together, and `breakdowns` length must match `episodes` length. Post-processing always runs regardless — it's fast and deterministic.
-
-Batch mode supports resumption by batch ID. If the process dies during polling, the batch already exists on the API side and can be resumed without re-submitting:
-
-```python
-result = get_plotlines(
-    show="House", season=1, episodes=synopses,
-    pass2_mode="batch",
-    batch_id="msgbatch_abc123",    # skip creation, go straight to polling
-)
-```
-
-## What the library does NOT contain
-
-- No databases
-- No file reads or writes
-- No web server or API
-- No UI or dashboard
-- No hidden state between calls
-- No NLP preprocessing — synopses are already clean text
diff --git a/docs/knowledge/specs/event-functions-redesign.md b/docs/knowledge/specs/event-functions-redesign.md
deleted file mode 100644
index eae8f09..0000000
--- a/docs/knowledge/specs/event-functions-redesign.md
+++ /dev/null
@@ -1,252 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# TODO: Redesign event functions
-
-## Problem
-
-Current 7 functions: `setup`, `escalation`, `turning_point`, `climax`, `resolution`, `cliffhanger`, `seed`.
-
-Issues:
-- `cliffhanger` and `seed` are not arc positions — they're narrative mechanics (modifiers). A cliffhanger IS a climax or turning_point that's cut at the peak. A seed IS a setup for a future storyline.
-- Missing `catalyst` (inciting incident) — "the single most important beat" (Nash p.14). LLM has no way to mark the trigger event that launches a storyline.
-- Missing `crisis` (All Is Lost) — "the lowest point, a whiff of death" (Nash p.15). LLM conflates this with escalation or turning_point.
-- LLM misuses `seed` for any future-facing setup (should be rare, 2-3 per season).
-- LLM misuses `cliffhanger` in mid-season episodes (should be act breaks or finales).
-- Each event gets exactly one function — but a catalyst can consist of multiple events.
-
-## Proposed functions (7)
-
-| #   | function            | Act | definition                                      | sources                                                                                                                                                                    |
-| --- | ------------------- | --- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 1   | `setup`             | 1   | Context, status quo, establishing the world     | Nash: Set-Up, Netflix: Setup, Oberg: "before"                                                                                                                              |
-| 2   | `inciting Incident` | 1   | Trigger event that launches the storyline       | Nash: Catalyst ("the thing that happens that makes everything else happen" p.14), Netflix: Inciting Incident ("must happen in first 20 pages"), Douglas: inciting incident |
-| 3   | `escalation`        | 2   | Stakes rise, situation complicates              | Nash: Bad Guys Close In, Netflix: Escalation, Pena: Stakes Escalation                                                                                                      |
-| 4   | `turning_point`     | 2   | Direction changes, false peak or false collapse | Nash: Midpoint ("false peak or false collapse, stakes are raised" p.15), Netflix: Midpoint (BIG twist)                                                                     |
-| 5   | `crisis`            | 2   | Lowest point, "whiff of death"                  | Nash: All Is Lost ("the moment the hero most feared actually happens" p.15) + Dark Night of the Soul, Netflix: Crisis                                                      |
-| 6   | `climax`            | 3   | Peak confrontation                              | Nash: Finale, Netflix: Climax                                                                                                                                              |
-| 7   | `resolution`        | 3   | Outcome, aftermath                              | Nash: Final Image, Netflix: Resolution/Denouement                                                                                                                          |
-
-Changes from current: +inciting Incident, +crisis, -cliffhanger, -seed.
-
-## Fractal structure: three levels of the same arc
-
-The same 7-phase arc applies at three levels (Oberg: "The dramatic three-act structure can be applied at any level: scene, sequence, subplot, storyline, episode or season"):
-
-| Level | What | Who labels | How |
-|-------|------|------------|-----|
-| **Episode** | arc of a single episode | LLM (Pass 2) | Already does this — `Event.function` |
-| **Storyline** | arc of one storyline across the season | Computed | Group events by storyline, sort by episode → arc phases |
-| **Season** | arc of the whole season | Computed | A-storyline's arc (franchise engine) |
-
-**One event, three functions.** Example: Walt kills Krazy-8 (S01E03):
-
-| Level | Function | Why |
-|-------|----------|-----|
-| Episode | climax | Peak tension of this episode |
-| Storyline (empire) | escalation | Still early in the season arc |
-| Season | escalation | Season is still building |
-
-LLM labels episode-level (what it sees). Storyline-level and season-level are computed from data.
-
-### Episode tension: max across all storylines
-
-Episode tension = max function weight across **all** storylines present in that episode.
-
-Why: the viewer feels tension regardless of which storyline causes it. If a C-storyline has a climax in E05, E05 is a tense episode even if the A-storyline is just escalating.
-
-Dramatic weight scale: setup(1) → catalyst(2) → escalation(3) → turning_point(4) → crisis(5) → climax(6) → resolution(1). Resolution returns to baseline — the arc on a graph is a mountain: rise 1→6, drop to 1.
-
-**Important**: these weights represent **structural position in the arc**, not emotional intensity. A catalyst (weight 2) can be emotionally more powerful than an escalation (weight 3) — e.g. cancer diagnosis vs "someone arrived". The weight says WHERE in the arc, not HOW STRONG the feeling. This matters for visualization: the tension curve shows arc progression, not emotional intensity.
-
-### Season arc: follows the A-storyline
-
-Season arc = A-storyline's arc across the season. The season is structured around the protagonist's journey — the A-storyline's phases define the season's shape (Netflix Season Map).
-
-Episode tension (all storylines) adds texture and variation, but the season's structural backbone is A.
-
-### Non-consecutive phases and arc monotonicity
-
-Grouping consecutive same-function events gives phases. But what about: escalation → turning_point → escalation?
-
-This is **normal** — Nash: "beat sheet is an itinerary, not a calendar. Beats can expand, contract, move around." After a turning_point, stakes can continue to rise (Bad Guys Close In comes AFTER Midpoint). The arc is not strictly monotonic.
-
-But some returns signal errors. Rule: **no return past a milestone**. Milestones = catalyst, turning_point, crisis, climax.
-
-- **OK**: escalation → turning_point → escalation (filling between milestones)
-- **Suspicious**: crisis → climax → crisis (return past climax milestone)
-- **Error**: resolution → escalation (return past climax AND crisis)
-
-Pass 3 should check: if a storyline arc returns past a milestone, flag for REFUNCTION.
-
-### Season arc: alternative computation methods
-
-Two options to test:
-- **Simple**: season arc = A-storyline's arc (franchise engine, Nash)
-- **Weighted**: episode weight = A×3 + B×2 + C×1 + runner×0.5 (gives A priority without ignoring others)
-
-Start with simple. If the shape doesn't match Netflix Season Map on BB S01-S05, try weighted.
-
-### Pass 3 validates computed arcs
-
-```
-Pass 2: LLM labels episode-level functions
-    ↓
-Post-processing: compute storyline arcs + season arc
-    ↓
-Pass 3: receives computed arcs, validates:
-    - storyline arc complete? (has catalyst? has climax?)
-    - order logical? (catalyst before escalation?)
-    - season arc shape makes sense? (climax near end?)
-    ↓
-Verdicts: REFUNCTION (new verdict type) if function assignment is wrong
-```
-
-Pass 3 doesn't compute — it **validates**. Code computes, LLM reviews.
-
-tvplotlines could show all three levels — that the season arc is composed of storyline arcs, which are composed of episode arcs. This would be a strong illustration for the preprint.
-
-### Netflix Season Map (Todd Kessler)
-
-| ACT 1               | ACT 2                       | ACT 3                  |
-|----------------------|-----------------------------|------------------------|
-| Teaser               | Episodes 4–5 (Escalation)   | Episode 8+ (Resolution)|
-| Inciting Incident    | Midpoint (BIG twist)        | Descending Action      |
-| Pilot 2–3 (Setup)    | Episodes 6–7 (Confrontation)| Denouement (wrap-up)   |
-| Climax of Act One    | Crisis                      | CLIFFHANGER            |
-|                      | Climax of Act Two           |                        |
-
-## Modifiers (future consideration)
-
-`cliffhanger` and `seed` become modifiers that can attach to any function:
-- `cliffhanger` — unresolved conflict at end of scene/episode/season (Oberg p.65, Landau: "must grow out of character jeopardy, risk, or fear" p.268)
-- `seed` — plants something for future payoff (Landau: "eating your seed corn" — don't use up all your seeds)
-
-Not in scope for first iteration — focus on getting the 7 functions right.
-
-## Sources
-
-- Nash, *Save the Cat! Writes for TV* — beat sheet, 5 pillar beats, Story DNA
-- Netflix Pitch Workshop — Season Map (Todd Kessler), inciting incident, crisis
-- Oberg, *Screenwriting Unchained* — fractal three-act structure at any level
-- Douglas, *Writing the TV Drama Series* — act breaks, inciting incident
-- Landau, *The TV Showrunner's Roadmap* — cliffhangers, seed corn, act breaks from characters
-- Pena, *Developing Series Television* — detailed beat structure
-- Harmon Story Circle — YOU/NEED/GO/STRUGGLE/FIND/SUFFER/RETURN/CHANGE
-
-## Post-processing: building storyline arcs from flat events
-
-After Pass 2, we have a flat list of events per episode. Post-processing builds the arc:
-
-1. Take all events for storyline `empire` across all episodes
-2. Sort by episode order (S01E01 → S01E02 → ...)
-3. Group consecutive events with the same function → phase
-4. Result: ordered list of phases, each with episode range and event list
-
-```
-Input (flat, from Pass 2):
-  S01E01: Walt diagnosed with cancer         → empire, setup
-  S01E01: Walt sees Jesse escape raid         → empire, setup
-  S01E01: Walt proposes partnership           → empire, catalyst
-  S01E01: First cook produces 99.1% meth     → empire, catalyst
-  S01E02: Emilio and Krazy-8 arrive          → empire, escalation
-  S01E03: Walt kills Krazy-8                 → empire, escalation
-  S01E05: Walt decides to sell to Tuco       → empire, turning_point
-  S01E06: Tuco beats Jesse                   → empire, crisis
-  S01E07: Walt confronts Tuco with crystals  → empire, climax
-  S01E07: Walt secures the deal              → empire, resolution
-
-Output (arc):
-  Walt: Empire:
-    SETUP      [S01E01..S01E01]  2 events  ██
-    CATALYST   [S01E01..S01E01]  2 events  ██
-    ESCALATION [S01E02..S01E03]  2 events  ██
-    TURN.POINT [S01E05..S01E05]  1 event   █
-    CRISIS     [S01E06..S01E06]  1 event   █
-    CLIMAX     [S01E07..S01E07]  1 event   █
-    RESOLUTION [S01E07..S01E07]  1 event   █
-```
-
-This is pure code (no LLM). New function in `postprocess.py`.
-
-## Arc completeness metric
-
-Derived metric per storyline: how many of the 7 phases are present.
-
-```
-Walt: Empire    — 7/7 (setup, catalyst, escalation, turning_point, crisis, climax, resolution)
-Hank: Investigation — 5/7 (setup, catalyst, escalation, turning_point, climax — no crisis, no resolution)
-```
-
-Computation: `len(set(event.function for event in storyline_events)) / 7`
-
-This is a **fact**, not a quality judgment. 5/7 for a runner is normal. 5/7 for an A-storyline is a signal for Pass 3 to investigate (missing crisis in the main arc?).
-
-Expected minimum completeness by rank:
-
-| Rank | Min | Rationale |
-|------|-----|-----------|
-| A | 6/7 | Main arc, may lack crisis |
-| B | 5/7 | Secondary, may lack crisis or resolution |
-| C | 3/7 | Minor thread |
-| runner | 1/7 | Incomplete Story DNA by definition |
-
-Pass 3 checks: completeness < expected minimum for rank → flag.
-
-Useful for: visualization (completeness bars), Pass 3 validation, preprint analysis.
-
-## Episode arc vs storyline arc divergence
-
-The most interesting insight for visualization. When episode function ≠ storyline function for the same event, it reveals where the show is structurally clever.
-
-Example: "Walt kills Krazy-8" = episode climax (peak of E03), but storyline escalation (early in the season). Where these two levels diverge strongly — those are the most interesting moments of dramaturgy: the episode peaks on what is still just build-up for the season.
-
-Visualization idea: two small numbers in a cell (ep: climax / arc: escalation), or color-code the divergence.
-
-## Episode arc construction
-
-Episode arc is built from events of ALL storylines within one episode, in the order LLM listed them (which follows synopsis chronological order).
-
-Same algorithm as storyline arc (group consecutive same-function → phases), but across storylines within one episode instead of across episodes within one storyline.
-
-## Convergence: directed storyline intersections
-
-Convergence = when an event from storyline A affects storyline B. NOT just "both present in same episode".
-
-Data source: `Event.also_affects` field — list of storyline IDs that the event secondarily impacts. Already exists in the model.
-
-Example: event "Walt kills Krazy-8" belongs to `empire` with `also_affects: ["investigation"]` — Walt's action in the empire storyline impacts Hank's investigation.
-
-This is a **directed** relationship: A→B ≠ B→A. "How many times did empire events affect investigation" vs "how many times did investigation events affect empire".
-
-Visualization:
-- **Directed matrix**: rows = source storyline, columns = target storyline. Cell value = count of also_affects links. Asymmetric.
-- **Timeline arcs with arrows**: at each episode, draw A→B arrow where an event crosses storylines. Direction matters.
-
-Data is already collected by Pass 2 — no new LLM work. Post-processing aggregates `also_affects` into a convergence matrix. New function in `postprocess.py`.
-
-## Implementation scope
-
-| What | Where | Size | LLM involved? |
-|------|-------|------|---------------|
-| Change function enum | Pass 2 prompt, pass2.py | Small | Yes (prompt change — needs autoresearch) |
-| Arc building from flat events | postprocess.py | Medium | No |
-| Convergence matrix from also_affects | postprocess.py | Small | No |
-| Arc visualization | tvplotlines-app | Large | No |
-| Convergence visualization | tvplotlines-app | Medium | No |
-| Pass 3 arc checking update | Pass 3 prompt | Small | Yes (prompt change) |
-
-## Files to change (when implementing)
-
-- `src/tvplotlines/models.py` — Event.function enum + new phase model
-- `src/tvplotlines/prompts_en/pass2.md` — function definitions (TESTED PROMPT — change only through autoresearch)
-- `src/tvplotlines/prompts/pass2.md` — same, Russian
-- `src/tvplotlines/pass2.py` — validation
-- `src/tvplotlines/postprocess.py` — span/weight computation
-- `src/tvplotlines/prompts_en/pass3.md` — arc checking in Step 2
-- `docs/api.md` — documentation
-
-**WARNING**: Pass 2 prompt is tested through autoresearch. Any changes must go through A/B testing, not direct editing. See lesson 2026-03-16 in lessons.md.
diff --git a/docs/knowledge/specs/heuristics-from-theory.md b/docs/knowledge/specs/heuristics-from-theory.md
deleted file mode 100644
index 0d9934d..0000000
--- a/docs/knowledge/specs/heuristics-from-theory.md
+++ /dev/null
@@ -1,106 +0,0 @@
----
-type: note
-project: tvplotlines
-status: active
----
-
-# Эвристики из теории: что набрать из учебников перед написанием промптов и кода
-
-Источник: ревью промптов (`pass0.md` — `pass3.md`) и кода (`pass0.py` — `postprocess.py`). Много правил сидят в промптах как расплывчатый текст, хотя их можно формализовать в код. Но прежде чем формализовать — нужно набрать эвристик из учебников (Nash, Douglas, Oberg, Landau, Mittell, McKee, Netflix workshop).
-
-Общий принцип:
-
-```
-Теория (учебники) → Эвристики (таблица правил) → Код (валидация)
-                                                → Промпт (только то, что код не может проверить)
-```
-
-Каждое правило из промпта: **можно проверить кодом?** Если да → убрать из промпта, написать проверку. Qiu 2025: код-проверка даёт +11.7pp, правила в промпте — +1.1pp.
-
----
-
-## 1. Порядок функций в арке (→ `postprocess.py`)
-
-**Сейчас:** в промпте Pass 3 одна строка: "A healthy storyline has an arc: setup → escalation → turning_point → climax → resolution". Код ничего не проверяет.
-
-**Набрать из учебников:** таблицу правил — какие функции имеют строгий порядок между собой, какие могут меняться местами, какие могут повторяться. Источники: Nash (beat sheet order), McKee (5 elements), Netflix Season Map.
-
-**Куда:** код-валидация в `postprocess.py` после Pass 2, до Pass 3. Жёсткие нарушения → флаг для Pass 3. Мягкие → диагностика.
-
-## 2. Ожидания по структуре сезона (→ `postprocess.py` + `pass3.py`)
-
-**Сейчас:** в промпте Pass 3 — "storyline structure should match the type", расплывчато. В коде: только "procedural/hybrid = 1 episodic" и "serial = 1 A-rank".
-
-**Набрать из учебников:**
-
-| Правило | Источник | Где проверять |
-|---------|----------|--------------|
-| Первый эпизод: setup для A-линии | Nash: "Set-Up" | Код после Pass 2 |
-| Последний эпизод limited: resolution для A/B | Nash, Netflix | Код после Pass 2 |
-| Последний эпизод ongoing: cliffhanger/seed ок | Landau | Код после Pass 2 |
-| Episodic линия: в каждом эпизоде | Douglas | Код: `compute_span` |
-| Serialized: span ≥ 2 эпизодов | По определению | Код: `compute_span` |
-| A-rank: не "glimpse" > 1-2 эпизодов | Nash | Код: `validate_ranks` |
-| Procedural: episodic = больше всего событий | Douglas | Код: `validate_ranks` |
-
-## 3. Story DNA completeness (→ `pass1.py`)
-
-**Сейчас:** промпт говорит "Missing any component — not a storyline". Код не проверяет.
-
-**Набрать:** Nash p.34 — "Story DNA has four parts." Но runner может не иметь obstacle, "partial" confidence допускает неполную DNA.
-
-**Куда:** код-валидация: non-runner + solid → все поля непустые. Runner → goal непустая. Пустые поля при solid → re-request или понизить confidence.
-
-## 4. Количество линий по типу (→ `pass1.py`)
-
-**Сейчас:** в промпте числа, в коде не проверяются.
-
-**Набрать:**
-
-| Franchise type | Min | Max | Источник |
-|---------------|-----|-----|----------|
-| Procedural | 2 | 5 | Douglas |
-| Serial | 3 | 8 | Nash |
-| Hybrid | 3 | 6 | Douglas |
-| Ensemble | 4 | 8 | Mittell |
-
-**Куда:** код-валидация в `pass1.py`.
-
-## 5. A-rank = всегда plot-led? (→ проверить)
-
-Промпт утверждает. Nash/Douglas подтверждают? В ensemble возможна A-линия character-led. Если теория не подтверждает — убрать.
-
-## 6. Episodic как тип линии (→ глоссарий)
-
-Douglas/Mittell используют "case-of-the-week", не "episodic storyline". Nash не использует. Либо заменить, либо дать формальное определение со ссылкой.
-
-## 7. Narrative devices — нужны ли?
-
-Список из 6 devices в Pass 1 И Pass 2. Downstream не используются. Если нигде → убрать (~200 tokens экономия). Если для визуализации → только в Pass 2.
-
-## 8. Interactions — формализовать или убрать
-
-- **Convergence** уже покрывается через `also_affects` → дублирование?
-- **Thematic rhyme** — Nash: "B-story reflects A-story theme." Оставить если используется.
-- **Dramatic irony** — полезно для визуализации.
-- **Meta** — расплывчатая категория → убрать.
-
-## 9. "Emotional counterpoint"
-
-Промпт Pass 2: "if all storylines rising or falling — something is missed." Основание есть (Nash, Douglas), но это не правило для LLM — это диагностический флаг. Перенести в код: все функции в эпизоде = escalation → флаг "monotone episode".
-
-## 10. Weight — откалибровать пороги
-
-Код: primary ≥ 50% max, background ≥ 2, glimpse = 1. Произвольные. Nash/Douglas: "A = 60-70%, B = 20-30%". Можно откалибровать.
-
-## 11. Pass 3: какие verdicts вычислить кодом
-
-| Verdict | Кодом? | Как |
-|---------|--------|-----|
-| PROMOTE/DEMOTE | Да | Уже частично в `validate_ranks` |
-| MERGE | Частично | Один driver + cosine similarity goals > 0.9 |
-| RERANK | Да | Rank ≠ event count |
-| REASSIGN | Нет | Нарративное суждение |
-| CREATE | Нет | Нарративное суждение |
-
-Детерминированные verdicts применять до Pass 3.
diff --git a/docs/knowledge/specs/input-parser-plan.md b/docs/knowledge/specs/input-parser-plan.md
deleted file mode 100644
index f57c285..0000000
--- a/docs/knowledge/specs/input-parser-plan.md
+++ /dev/null
@@ -1,199 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# Input parser — план реализации
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Научить `tvplotlines run` принимать один текстовый файл со всеми синопсисами. Сценарист пишет `.txt` или `.md` по трём простым правилам — программа парсит название шоу, сезон и разбивает на эпизоды. Ключевой use case — сценаристы работающие с **оригинальным** контентом (пилоты, разработка шоу), а не только копирующие с Википедии.
-
-**Architecture:** Новый модуль `input_parser.py` — парсит файл, возвращает `(show, season, dict[str, str])`. CLI поддерживает два режима: новый (один файл) и старый (много файлов + `--show`). Python API (`get_plotlines`) не меняется.
-
-**Tech Stack:** Только stdlib (re, pathlib). Никаких зависимостей.
-
----
-
-## Решения
-
-| # | Вопрос | Решение |
-|---|--------|---------|
-| 1 | Обратная совместимость CLI | Оба режима. Detect by: есть `--show` → старый, нет → парсим файл. Autoresearch, program-v2, tvplotlines-app не ломаются |
-| 2 | Encoding | Явно `encoding="utf-8"`. При `UnicodeDecodeError` — ошибка: "File is not UTF-8. Save as UTF-8 and try again." |
-| 3 | `__init__.py` exports | Не экспортируем. `parse_synopsis_file` — внутренний модуль для CLI, не часть публичного API |
-| 4 | `--lang` | Остаётся как отдельный CLI-флаг. Парсер не детектит язык. `--lang` передаётся в pipeline как раньше |
-| 5 | YAML frontmatter | Убрано. Overengineering — ни одной реальной аудитории |
-| 6 | Название эпизода (`- Pilot`) | Не парсим отдельно. Строка заголовка целиком отбрасывается, всё после неё до следующего заголовка — текст синопсиса |
-| 7 | Русское название шоу | Валидации нет. Если пользователь написал "Доктор Хаус" — pipeline получит русское название. LLM мультиязычный, справится |
-| 8 | Regex edge cases | Тесты на: "24, Season 1", "9-1-1, Season 1", "House S01", "House S1". Regex будет отлажен по тестам |
-| 9 | Порядок эпизодов | Сортировать по номеру из заголовка, не по порядку в файле |
-| 10 | Дубликаты | Ошибка: "Duplicate Episode N found" |
-| 11 | Интеграционный тест | Manual smoke test (pipeline стоит $1.5+, нужен API key). Не автоматизированный |
-| 12 | Текст между заголовком и первым эпизодом | Warning: "Text before first episode heading will be ignored". Не ломать, не молчать |
-| 13 | Интерфейс `parse_episodes` | Принимает полный текст файла, пропускает всё до первого `Episode N`. Заголовок файла не его забота — его парсит `parse_header` |
-| 14 | Приоритет CLI-флагов vs файл | CLI-флаг побеждает файл. `--show` и `--season` переопределяют то что в первой строке (явное важнее неявного) |
-| 15 | Остальные CLI-флаги | `--output`, `--provider`, `--model`, `--base-url`, `--skip-review`, `--pass2-mode`, `--lang` — работают как раньше, не затрагиваются |
-| 16 | Сокращение "S01" / "S1" | Поддерживаем в regex: `(?:Season\|сезон\|S)\s*(\d+)`. "House S01", "House S1" — валидные форматы |
-
-## Формат ввода для пользователя
-
-Три правила:
-
-1. **Первая строка** — название шоу и номер сезона
-2. **Каждый эпизод** начинается с заголовка (`Episode 1`, `Эпизод 1`)
-3. **Текст синопсиса** — всё до следующего заголовка
-
-### Пример файла
-
-```
-House, Season 1
-
-Episode 1
-Dr. Gregory House reluctantly takes on a new case when a young
-kindergarten teacher collapses in her classroom with seizures...
-
-Episode 2
-A teenage lacrosse player is brought in with seizures. House
-suspects it's not epilepsy and pushes his team to find the cause...
-
-Episode 3
-A college student collapses after a night with his girlfriend...
-```
-
-### CLI
-
-```bash
-# Новый способ — один файл, всё внутри
-tvplotlines run house_s01.txt
-
-# Старый способ — отдельные файлы (обратная совместимость для autoresearch/scripts)
-tvplotlines run synopses/*.txt --show "House" --season 1
-```
-
-## Логика парсера
-
-### Определение режима (в cli.py)
-
-- Есть `--show` → старый режим (как сейчас, любое количество файлов)
-- Нет `--show` + один файл → новый режим (парсим файл)
-- Нет `--show` + много файлов → ошибка: "Specify --show when passing multiple files, or use single-file format"
-
-### Парсинг первой строки
-
-BOM/whitespace: `text.lstrip('\ufeff').strip().splitlines()[0]`
-
-Извлечь show и season из строк вида:
-- `House, Season 1` → show="House", season=1
-- `Breaking Bad Season 2` → show="Breaking Bad", season=2
-- `Слово пацана, сезон 1` → show="Слово пацана", season=1
-
-Паттерн: `(.+?)[,.]?\s+(?:Season|сезон|S)\s*(\d+)` (case-insensitive)
-
-Поддерживает: "House, Season 1", "House Season 1", "House S01", "House S1", "Слово пацана, сезон 1".
-
-Если не распознал — ошибка с примером:
-```
-Could not parse show and season from first line: "..."
-Expected format: "Show Name, Season N"
-Example: "House, Season 1"
-```
-
-### Парсинг эпизодов
-
-Заголовок эпизода — строка, начинающаяся с:
-- `Episode N` / `episode N`
-- `Эпизод N` / `эпизод N`
-- `# Episode N` (markdown — парсер поймёт, но в документации не учим)
-
-Паттерн: `^(?:#+ )?(?:Episode|Эпизод|Ep\.?)\s+(\d+)` (case-insensitive)
-
-**Не поддерживаем:** `N.` и `N -` (нумерованные списки — коллизии).
-
-Всё после строки-заголовка до следующего заголовка — текст синопсиса. Текст между заголовком файла и первым эпизодом — warning и пропуск.
-
-`parse_episodes` принимает полный текст файла, пропускает всё до первого заголовка эпизода. Разделение ответственности: `parse_header` парсит первую строку, `parse_episodes` парсит эпизоды.
-
-### Валидация
-
-- Дубликаты → ошибка: "Duplicate Episode N found"
-- Пустой синопсис → warning, пропуск
-- Текст до первого эпизода → warning: "Text before first episode heading will be ignored"
-- Эпизоды сортируются по номеру (не по порядку в файле)
-
-## Файловая структура
-
-### Новые файлы
-
-- `src/tvplotlines/input_parser.py` — парсинг файла
-- `tests/test_input_parser.py` — тесты
-- `examples/input_format.txt` — пример для пользователя
-
-### Изменения в существующих файлах
-
-- `cli.py` — логика выбора режима + вызов `input_parser`
-- `README.md` — обновить Quick Start (новый способ первым, старый как альтернатива)
-
-## Задачи
-
-### Task 1: Парсер первой строки
-
-**Files:**
-- Create: `src/tvplotlines/input_parser.py`
-- Create: `tests/test_input_parser.py`
-
-- [ ] Функция `parse_header(text: str) -> tuple[str, int]` — возвращает (show, season)
-- [ ] BOM/whitespace handling
-- [ ] Тесты: "House, Season 1", "Breaking Bad Season 2", "Слово пацана, сезон 1", "24, Season 1", "9-1-1, Season 1", "House S01", "House S1", невалидная строка
-- [ ] Commit
-
-### Task 2: Парсер эпизодов
-
-**Files:**
-- Modify: `src/tvplotlines/input_parser.py`
-- Modify: `tests/test_input_parser.py`
-
-- [ ] Функция `parse_episodes(text: str) -> list[tuple[int, str]]` — возвращает [(номер, текст)]
-- [ ] Тесты: "Episode 1", "# Episode 1", "Эпизод 1", пустой синопсис, Episode 3 перед Episode 2 (сортировка), дубликаты (ошибка), текст перед первым эпизодом (warning)
-- [ ] Commit
-
-### Task 3: Основная функция
-
-**Files:**
-- Modify: `src/tvplotlines/input_parser.py`
-- Modify: `tests/test_input_parser.py`
-
-- [ ] Функция `parse_synopsis_file(path: Path) -> tuple[str, int, dict[str, str]]`
-- [ ] Encoding: `path.read_text(encoding="utf-8")`, `UnicodeDecodeError` → понятная ошибка
-- [ ] Тест на полном файле (заголовок + несколько эпизодов)
-- [ ] Тест ошибок: нет заголовка, нет эпизодов, пустой файл, не UTF-8
-- [ ] Commit
-
-### Task 4: CLI интеграция
-
-**Files:**
-- Modify: `src/tvplotlines/cli.py`
-
-- [ ] Логика выбора режима: есть `--show` → старый, нет `--show` + один файл → парсим, нет `--show` + много файлов → ошибка
-- [ ] `--show` и `--season` — опциональные override (CLI-флаг побеждает файл). В старом режиме `--show` обязателен
-- [ ] Все остальные флаги (`--output`, `--provider`, `--model`, `--lang`, `--skip-review`, `--pass2-mode`) работают как раньше
-- [ ] Тест: оба режима работают
-- [ ] Commit
-
-### Task 5: Пример и документация
-
-**Files:**
-- Create: `examples/input_format.txt`
-- Modify: `README.md`
-
-- [ ] Пример файла с 2-3 эпизодами True Detective S01
-- [ ] README: новый способ первым в Quick Start, старый как альтернатива для скриптов
-- [ ] `--help`: описание формата файла
-- [ ] Commit
-
-### Task 6: Manual smoke test
-
-- [ ] Создать тестовый файл из fixtures (True Detective S01E01-E04)
-- [ ] `tvplotlines run test_file.txt` — прогнать pipeline до конца, проверить result.json
-- [ ] Требует API key, запускается вручную
diff --git a/docs/knowledge/specs/inventory.md b/docs/knowledge/specs/inventory.md
deleted file mode 100644
index 153fe4a..0000000
--- a/docs/knowledge/specs/inventory.md
+++ /dev/null
@@ -1,143 +0,0 @@
----
-type: spec
-project: tvplotlines
-status: active
----
-
-# Инвентаризация: теория, технология, своё, чужое
-
-## 1. ТЕОРИЯ (знания, модели, классификации)
-
-### Своё
-- **A/B/C классификация сюжетных линий** — вместо академических anthology/soap/genre → индустриальные A (жанр), B (отношения), C (побочная). Основано на Nash, Douglas, реальной практике
-- **Критика оригинала** — "25 арок в Слово пацана — это бред, обычно 3 основных линии". Понимание что модель перегенерирует
-- **Procedural / serialized / hybrid** — типология форматов сериалов, влияет на то какие линии ожидать
-- **Horizontal / vertical storylines** — из Douglas, деление линий по способу развёртывания
-- **Формула "знания из книг → формальная модель → инструкции для ИИ"** — методологический подход, которого нет у авторов
-
-### Из книг (база знаний, строится сейчас)
-- Nash — Save the Cat Writes for TV (A/B/C storylines, 15-beat)
-- Douglas — Writing the TV Drama Series (horizontal/vertical, структура сезона)
-- Landau — TV Showrunner's Roadmap (21 навигационная точка)
-- Mittell — Complex TV (нарративная сложность)
-- Weiland — Creating Character Arcs
-- Rabkin — Writing the Pilot
-- + ещё ~14 книг в how2pitch по питчу и структуре
-
-### Из статей
-- Balestri & Pescatore 2025 (ICAART) — идея мультиагентной экстракции арок
-- Статьи с arxiv — решения проблем контекста и галлюцинаций (конкретные?)
-
----
-
-## 2. ТЕХНОЛОГИЯ (код, инструменты, реализации)
-
-### Своё (написано с нуля)
-| Что | Где | Суть |
-|---|---|---|
-| Русский NLP-пайплайн | mas4bw: ru_*.py | NER через Natasha, русские промпты, русские титулы |
-| Синопсис-пайплайн | mas4bw: main_synopsis.py | Обход тяжёлой NLP-обработки, прямая подача текста |
-| Мульти-LLM поддержка | mas4bw: ai_models.py | OpenAI + Anthropic + Azure вместо только Azure |
-| Парсер синопсисов из PDF | mas4bw: parse_season_synopsis.py | PDF → эпизоды → файлы |
-| База знаний по питчу | how2pitch: quotes/*.json | ~786 цитат из 6 книг, переведены на русский |
-| Визард для питча | how2pitch: index.html | Пошаговый процесс от идеи до синопсисов серий |
-| Глоссарий | how2pitch: glossary.json | 60+ терминов EN→RU |
-| Весь books2series | books2series/ | Пайплайн книга→события→персонажи→питч |
-| Баг-фиксы оригинала | mas4bw | Pydantic v2, SQLite, пустые ответы |
-
-### Чужое (взято, используется как есть или модифицировано)
-| Что | Откуда | Лицензия | Статус |
-|---|---|---|---|
-| 9-шаговый граф экстракции | Balestri & Pescatore | CC BY-NC-ND | **Нужно переписать** |
-| Промпты (EN оригиналы) | Balestri & Pescatore | CC BY-NC-ND | **Нужно переписать** |
-| Схема БД (NarrativeArc и др.) | Balestri & Pescatore | CC BY-NC-ND | **Нужно переписать** |
-| Три типа арок | Balestri & Pescatore | CC BY-NC-ND | **Заменяем на A/B/C** |
-
-### Зависимости (библиотеки, фреймворки — свободные)
-| Что | Зачем | Лицензия |
-|---|---|---|
-| LangGraph | Оркестрация шагов графа | MIT |
-| LangChain | Вызовы LLM | MIT |
-| Pydantic | Модели данных | MIT |
-| spaCy | NER английский | MIT |
-| Natasha | NER русский | MIT |
-| ChromaDB | Векторный поиск | Apache 2.0 |
-| SQLModel | ORM для SQLite | MIT |
-| FastAPI | API | MIT |
-| React | Фронтенд | MIT |
-
----
-
-## 3. ЧТО НУЖНО ПЕРЕПИСАТЬ ДЛЯ СВОЕЙ РЕАЛИЗАЦИИ
-
-Всё что под лицензией CC BY-NC-ND (Balestri & Pescatore) нужно написать заново.
-Идеи из статьи использовать можно — идеи не защищаются лицензией.
-Код — нельзя копировать.
-
-### Что берём как ИДЕЮ (из статьи):
-- Мультиагентный подход к экстракции (несколько LLM-вызовов с разными ролями)
-- Дедупликация через векторное сходство
-- Верификация результатов отдельным шагом
-
-### Что пишем СВОЁ (на основе книг + опыта):
-- Классификация линий: A/B/C вместо anthology/soap/genre
-- Количество и логика шагов: не 9 фиксированных, а столько сколько нужно
-- Промпты: на основе знаний из 20 книг, а не эмпирического подбора
-- Схема данных: Storyline вместо NarrativeArc, с полями под A/B/C модель
-- Входной формат: синопсисы как основной путь (не полные тексты)
-
----
-
-## 4. OPEN SOURCE АРХИТЕКТУРА
-
-Из трёх продуктов mas4bw — лучший кандидат на библиотеку/фреймворк.
-books2series — был назван лучшим кандидатом на фреймворк (расширяемые схемы, предикаты, entity resolution).
-
-### Вариант: единый фреймворк
-
-```
-screenwriting-toolkit/              ← зонтичный проект
-├── core/                           ← общие модели, утилиты
-│   ├── models.py                   ← Storyline, Character, Event, Episode
-│   ├── llm.py                      ← абстракция над LLM-провайдерами
-│   └── io.py                       ← чтение синопсисов, книг, PDF
-├── storylines/                     ← бывший mas4bw
-│   ├── extract.py                  ← extract_storylines(episodes) → list[Storyline]
-│   ├── classify.py                 ← A/B/C классификация
-│   ├── prompts/                    ← промпты по языкам
-│   └── knowledge/                  ← знания из книг (что такое A-line, B-line)
-├── books/                          ← бывший books2series
-│   ├── extract.py                  ← extract_events(book) → list[Event]
-│   ├── characters.py               ← extract_characters(book) → list[Character]
-│   ├── screen.py                   ← screen_book(book, brief) → BookCard
-│   └── domain/                     ← предикаты, онтологии
-├── pitch/                          ← бывший how2pitch
-│   ├── knowledge/                  ← база знаний из 20 книг
-│   ├── wizard.py                   ← пошаговый визард
-│   └── templates/                  ← шаблоны питч-библии
-└── apps/                           ← веб-интерфейсы (не open source?)
-    ├── storyline_viewer/
-    ├── book_explorer/
-    └── pitch_wizard/
-```
-
-### Что открываем, что нет
-
-| Компонент | Open source? | Почему |
-|---|---|---|
-| core/ | Да | Общие модели, всем полезны |
-| storylines/ | Да | Переписано с нуля, на основе книг |
-| books/ | Частично | Базовая экстракция — да, domain-модели — нет |
-| pitch/knowledge | Да (датасет) | Люди добавляют книги |
-| pitch/wizard | Нет | Продукт, можно продавать |
-| apps/ | Нет | Коммерческие интерфейсы |
-
----
-
-## 5. ОТКРЫТЫЕ ВОПРОСЫ
-
-- [ ] Какие именно статьи с arxiv использовались для решения проблем контекста?
-- [ ] Сколько шагов нужно в новом пайплайне? (определится из книг)
-- [ ] Писать авторам сейчас или после переписывания?
-- [ ] Название: screenwriting-toolkit? story-engine? narrative-kit?
-- [ ] Монорепо или отдельные пакеты?
diff --git a/docs/knowledge/specs/mas4bw-library-audit.md b/docs/knowledge/specs/mas4bw-library-audit.md
deleted file mode 100644
index 86b06f1..0000000
--- a/docs/knowledge/specs/mas4bw-library-audit.md
+++ /dev/null
@@ -1,102 +0,0 @@
----
-type: spec
-project: tvplotlines
-status: active
----
-
-# Технический аудит mas4bw: выделение ядра в библиотеку
-
-## Текущая архитектура
-
-mas4bw — монолитное приложение с четырьмя слоями:
-
-1. **Скрипты обработки** (`main.py`, `main_ru.py`, `main_synopsis.py`) — точки входа
-2. **Ядро экстракции** — LangGraph стейт-машина из 9 шагов, ~8-9 вызовов LLM на эпизод
-3. **Хранение** — SQLite (SQLModel) + ChromaDB (векторный поиск)
-4. **API + фронтенд** — FastAPI + React дашборд
-
-## Ядро экстракции: 9 шагов графа
-
-1. `initialize_state` — читает тексты серий с диска
-2. `identify_present_season_arcs_batch` — **запрос в БД** за известными арками + LLM
-3. `extract_anthology_arcs_strict` — LLM: антологические линии
-4. `extract_soap_and_genre_arcs` — LLM: отношения + жанровые линии
-5. `optimize_arcs_with_season_context` — LLM: оптимизация в контексте сезона
-6. `deduplicate_arcs` — LLM: дедупликация
-7. `enhance_arcs_batch` — LLM: обогащение персонажами
-8. `verify_arcs_batch` — LLM: верификация прогрессий и персонажей
-9. `final_verify_arcs` — LLM: финальная проверка
-
-Вход: тексты серий + список персонажей + ранее найденные арки
-Выход: `List[IntermediateNarrativeArc]` — структурированные сюжетные линии
-
-## Связанность с другими слоями
-
-| Слой | Связанность | Комментарий |
-|---|---|---|
-| БД (SQLite) | **Высокая** | Шаг 2 графа лезет в БД за предыдущими арками — главный блокер |
-| Файловая система | Средняя | 4 файла читаются в `initialize_state`, 1 пишется на выходе |
-| Конфигурация | Средняя | `os.getenv()` разбросан по коду, нет центрального конфига |
-| API (FastAPI) | **Ноль** | Полностью независимы |
-| Фронтенд (React) | **Ноль** | Полностью независимы |
-
-## Что нужно для чистого `extract_arcs()`
-
-### 1. Убрать запрос в БД из графа (~30 строк)
-Шаг 2 (`identify_present_season_arcs_batch`) открывает сессию SQLite.
-Решение: принимать `known_arcs: list[dict]` как параметр. Пустой список при первом запуске.
-
-### 2. Заменить файловый I/O на передачу в память
-`initialize_state` читает 4 файла. Вместо `file_paths` → аргументы `episode_plot: str`, `season_plot: str` и т.д.
-Механическая работа.
-
-### 3. Объединить EN и RU дубликаты
-Два графа — полная копипаста (~600 строк каждый), отличаются только промптами.
-Решение: один граф + `language` параметр + селектор промптов.
-
-### 4. Убрать запись файла на выходе (2 строки)
-Возвращать список вместо записи в файл.
-
-## Целевой интерфейс
-
-```python
-from mas4bw import extract_arcs
-
-arcs = extract_arcs(
-    episodes=["текст серии 1", "текст серии 2", ...],
-    language="ru",
-    genre="drama",
-    known_arcs=[],  # пусто при первом запуске
-    llm_provider="anthropic",  # или "openai"
-)
-
-for arc in arcs:
-    print(arc.title)        # "Мередит и Дерек"
-    print(arc.type)          # "soap"
-    print(arc.characters)    # ["Мередит", "Дерек"]
-    print(arc.episodes)      # [1, 3, 5, 7, 8]
-```
-
-## Зависимости пакета
-
-**Обязательные:** langgraph, langchain-core, langchain-openai/langchain-anthropic, pydantic
-**Опциональные (предобработка):** spacy, natasha (русский NLP)
-
-## Оценка сроков
-
-| Объём | Срок |
-|---|---|
-| Чистый `extract_arcs()` — ядро без файлов и БД | 2–4 дня |
-| + NLP предобработка (spaCy, Natasha) | +1–2 недели |
-| + тесты, документация, публикация на PyPI | 3–4 недели всего |
-
-## Ключевые файлы
-
-- `src/langgraph_narrative_arcs_extraction/narrative_arc_graph_optimized.py` — EN граф
-- `src/langgraph_narrative_arcs_extraction/ru_narrative_arc_graph_optimized.py` — RU граф
-- `src/narrative_storage_management/prompts.py` — все промпты
-- `main_synopsis.py` — уже упрощённый пайплайн, ближе всего к целевому интерфейсу
-
-## Вывод
-
-Реалистично. `main_synopsis.py` — уже 70% нужного интерфейса. Главная работа — вынести БД из графа и объединить языковые дубликаты. Прагматичный путь: начать с версии без предобработки (пользователь подаёт чистые синопсисы), NLP-пайплайн добавить позже как опцию.
diff --git a/docs/knowledge/specs/rank-refactor-spec.md b/docs/knowledge/specs/rank-refactor-spec.md
deleted file mode 100644
index 6be7042..0000000
--- a/docs/knowledge/specs/rank-refactor-spec.md
+++ /dev/null
@@ -1,102 +0,0 @@
----
-type: spec
-project: tvplotlines
-status: archived
----
-
-# How plotline rank works
-
-## The problem with rank today
-
-A plotline's ABC rank — how central it is to the season — gets decided three times by three different mechanisms. The LLM assigns it during Pass 1 based on its reading of the synopses. Then code in post-processing may auto-demote an A-rank plotline if it appears in too few episodes. Then Pass 3 may promote or demote it again through structural review.
-
-Each mechanism overrides the previous one. The user never sees the disagreement — only the final number, with no trace of who changed it or why.
-
-This becomes a real problem with ensemble shows. When a season has seven or more plotlines, the LLM's initial ranking is a guess — it hasn't seen the events yet, only the synopses. After Pass 2 assigns events to plotlines, we have actual data: how many events each plotline drives, how many episodes it spans. That data should inform the rank, not be ignored.
-
-## Two ranks instead of one
-
-Split rank into two fields:
-
-- **computed_rank** — code calculates this after Pass 2 from event counts. Objective, reproducible, based on data.
-- **reviewed_rank** — Pass 3 sets this through PROMOTE/DEMOTE only when it disagrees with the computed rank. Null when Pass 3 agrees or has nothing to say.
-
-When `reviewed_rank` is null, the user sees `computed_rank`. When both are present, the user sees both — and the disagreement itself tells a story.
-
-In Mad Men, the formula gives Pete Campbell rank B (34 events — second most in the season). The LLM gives him C. Don's marriage gets the opposite treatment: C by events, B by the LLM. A producer looking at both numbers learns something neither says alone: Pete dominates screen time, but Don's marriage dominates the show's identity. That tension is worth seeing.
-
-Full experiment results: `docs/experiments/counting-events-for-ABC-rank.md`.
-
-## How computed_rank works
-
-### Counting events
-
-For each plotline, count the events where it is the primary plotline (`event.plotline_id`). Events that mention the plotline in `also_affects` are not counted.
-
-`also_affects` means "this event touches the plotline" — not "this event belongs to the plotline." A runner mentioned in fifteen `also_affects` lists is not a B-plotline. It is background presence, and counting it equally would inflate plotlines that influence many scenes without driving any of them.
-
-The optimal weight for `also_affects` (zero, half, or full) is still an open question — the current choice is conservative. Pass 3 receives both counts and can correct with PROMOTE if the `also_affects` pattern suggests a higher rank.
-
-### Assigning ABC
-
-1. Runners (`type = "runner"`) get no rank.
-2. In procedural format, the case-of-the-week plotline gets A — it is what the show is about, regardless of how many events other plotlines have.
-3. In hybrid format, the case-of-the-week gets B — the character arc matters more, even when the case generates more events (Douglas: "A-story = the most resonant story, not necessarily the largest proportion of pages").
-4. The remaining plotlines are sorted by descending primary event count. First gets the highest available rank, second gets the next, third and beyond get C.
-
-Example for a hybrid show with five plotlines:
-
-- Case of the week → B (fixed)
-- Runner → null (fixed)
-- Most events → A
-- Next → B (second B is fine)
-- Next → C
-
-### Safety net
-
-After computing ranks, one check remains: if an A-rank plotline appears in fewer than 25% of episodes, demote it to B. A plotline concentrated in three episodes out of thirteen is not the season's spine, no matter how many events it packs in.
-
-## What changes
-
-### Model
-
-`Plotline.rank` becomes two fields: `computed_rank` and `reviewed_rank`. A property `rank` returns `reviewed_rank or computed_rank` — existing code that reads `rank` keeps working.
-
-The JSON output includes all three: `rank` (the effective value), `computed_rank`, and `reviewed_rank`.
-
-### Pass 1
-
-The prompt no longer asks the LLM to assign rank. The rank section, rank validation rules, rank in the JSON example, and rank assignment rules all come out. The LLM focuses on what it does well: identifying plotlines, cast, and Story DNA. Rank is data-driven — it belongs after the data exists.
-
-### Pass 2
-
-RERANK patches are removed. During Pass 2, the LLM doesn't know the final ranks — it hasn't finished assigning events yet. Asking it to flag rank problems at this stage produces noise.
-
-### Post-processing
-
-A new function `compute_ranks` runs after orphan assignment and span computation. It counts primary events, applies the rules above, and writes `computed_rank`.
-
-The existing `validate_ranks` keeps the span-based demotion and dominance checks as diagnostics for Pass 3.
-
-Pipeline order:
-1. `assign_orphan_events()`
-2. `compute_span()`
-3. `compute_ranks()`
-4. `validate_ranks()`
-5. Pass 3
-
-### Pass 3
-
-PROMOTE and DEMOTE verdicts write to `reviewed_rank` instead of mutating `computed_rank`. The prompt explains: "Code computed rank from event frequency. If narrative resonance tells a different story — a plotline that defines the show despite fewer events, or one that dominates events without defining the show — propose a different rank through PROMOTE or DEMOTE."
-
-Pass 3 receives both primary and `also_affects` event counts for each plotline, so it can make informed decisions.
-
-The non-ensemble A-rank block checks the effective rank (`reviewed_rank if set, else computed_rank`).
-
-### CLI
-
-`--stop-after pass1` saves an intermediate JSON without rank — rank doesn't exist yet at that stage. `--resume-from` accepts plotlines without rank — it will be computed after Pass 2.
-
-### Tests
-
-Pass 1 validation tests, verdict tests, and post-processing tests will need updates. The test plan will be detailed during implementation.
diff --git a/docs/knowledge/specs/synopsis-authoring-protocol.md b/docs/knowledge/specs/synopsis-authoring-protocol.md
deleted file mode 100644
index 407311e..0000000
--- a/docs/knowledge/specs/synopsis-authoring-protocol.md
+++ /dev/null
@@ -1,65 +0,0 @@
----
-type: spec
-project: tvplotlines
-status: active
----
-
-# Synopsis Authoring Protocol
-
-Протокол написания синопсисов эпизодов для пайплайна tvplotlines.
-
-## Задача
-
-Напиши prose outline эпизода — пересказ ключевых событий в хронологическом порядке. Результат должен быть достаточным для восстановления Story DNA каждой сюжетной линии (hero, goal, obstacle, stakes) и распределения событий по линиям.
-
-## Правила
-
-1. **Каждое предложение = beat** — событие, меняющее ситуацию. Если в предложении нет конфликта или изменения — оно не нужно.
-2. **Действия и решения, не атмосфера.** Пиши что персонаж сделал и почему, а не как выглядела сцена.
-3. **Персонажи по имени.** При первом появлении — полное имя + роль/отношение. Далее по имени.
-4. **Каузальность явная.** Каждое событие должно следовать из предыдущего. Не «случайно», а «потому что».
-5. **Все линии покрыты.** A, B, C и runners. Даже если B-story занимает одно предложение — она упомянута.
-6. **Конфликт обязателен.** Если ты не можешь сформулировать конфликт в сцене — эта сцена не нужна в синопсисе.
-7. **Минимум 3 нарративных нити на эпизод.** Кейс/A-story + минимум две personal/serialized арки. В процедуралах недостаточно описать только кейс — каждый эпизод содержит развитие персональных линий основного каста (конфликты в отношениях, карьерные решения, внутренние кризисы). Если в эпизоде нет явных B/C-линий — укажи это явно.
-8. **Serialized контент ≥ 30% текста.** Синопсис, где 100% — кейс недели, бесполезен для извлечения сюжетных линий. Пайплайн не может извлечь то, чего нет в тексте.
-9. **Фактическая точность обязательна.** Синопсис должен быть основан на реальном содержании эпизода, верифицированном по нескольким источникам. LLM-галлюцинации (выдуманные пациенты, несуществующие сцены) полностью обесценивают результат.
-
-## Формат
-
-- Сплошной текст, абзацы по сценам/локациям
-- **300–500 слов** на эпизод (увеличено для покрытия serialized арок)
-- **8–15 beats** на эпизод
-- Язык оригинала шоу
-- Без подзаголовков, без bullet points
-- Без авторских оценок и отсылок к будущим эпизодам
-- Хронологический порядок внутри эпизода; флэшбеки указывать явно
-
-## Что включать
-
-- Действия персонажей и их последствия
-- Решения и мотивацию (если ясна из контекста)
-- Конфликты и их исходы
-- Ключевые реплики — только если они меняют ситуацию
-- Появление новых персонажей с минимальным контекстом
-
-## Что НЕ включать
-
-- Визуальный стиль, музыку, режиссуру, монтаж
-- Интерпретации, символизм, авторские оценки
-- Слово "Meanwhile"
-- Спойлеры из будущих эпизодов
-- Пересказ событий прошлых эпизодов (только если персонаж в этом эпизоде о них узнаёт)
-
-## Количество beats по типу шоу
-
-| Тип | A-story | B-story | C / runner |
-|---|---|---|---|
-| Procedural | 5–8 | 2–4 | 1–2 |
-| Serial | 4–6 | 3–5 | 1–3 |
-| Ensemble | 2–4 per line | 2–4 per line | 1–2 per line |
-
-## Авторство
-
-Синопсисы написаны авторами проекта на основе общедоступного содержания эпизодов. Это derivative work — пересказ своими словами, не копия внешних источников.
-
-Для статьи: "Episode synopses were authored by the researchers based on publicly available episode content, following a standardized protocol to ensure consistent granularity across different franchise types."
diff --git a/docs/knowledge/specs/two-function-dimensions.md b/docs/knowledge/specs/two-function-dimensions.md
deleted file mode 100644
index 28395ed..0000000
--- a/docs/knowledge/specs/two-function-dimensions.md
+++ /dev/null
@@ -1,35 +0,0 @@
----
-type: concept
-project: tvplotlines
-status: active
----
-
-# Two dimensions of event function
-
-## Idea
-
-Each event has two independent roles:
-
-1. **Episode function** — its role in the episode's dramatic structure (where in the episode's story does this event land?)
-2. **Arc function** — its role in the season-long plotline arc (where in the plotline's season journey does this event land?)
-
-These are orthogonal. A climax of episode 3 can be an escalation in the season arc. Currently we have one `function` field that conflates both.
-
-## How it would work
-
-**Pass 2** assigns episode function. It sees one episode — it can only judge the role within that episode. Candidate framework: Dan Harmon's story circle (8 steps) or a simplified version.
-
-**Pass 3** assigns arc function. It sees the whole season — it can judge where each event falls in the plotline's season-long trajectory. This uses our current 7 functions: setup → inciting_incident → escalation → turning_point → crisis → climax → resolution.
-
-## What it gives us
-
-- Pass 2 stops guessing about the season arc (it can't see it)
-- Pass 3 gets a clearer task: not "review" but "assign arc functions"
-- Two dimensions give richer analysis: episode structure vs season structure
-- Enables fractal analysis (same structure at episode and season levels, as Oberg describes)
-
-## Open questions
-
-- Dan Harmon's circle is 8 steps for one hero. How to handle multiple plotlines per episode?
-- Do we need all 8 Harmon steps or can we simplify?
-- How does this change the data model? Two fields instead of one? Or two separate passes?
diff --git a/docs/knowledge/specs/what-each-pass-does.md b/docs/knowledge/specs/what-each-pass-does.md
deleted file mode 100644
index 86e2b68..0000000
--- a/docs/knowledge/specs/what-each-pass-does.md
+++ /dev/null
@@ -1,15 +0,0 @@
----
-type: note
-project: tvplotlines-app
-status: active
----
-
-**Вход**: синопсисы серий — сезона или сериала.
-
-**Pass 0 — Настройка**. Задача: определить тип сериала — процедурный, сериальный, ансамблевый, один протагонист или несколько. Результат: профиль сериала, от которого зависит, какие линии вообще возможны. Запускается один раз.
-
-**Pass 1 — Сюжетные линии** Задача: прочитать все синопсисы и найти 5–6 сюжетных линий. По подробной инструкции — что считается линией, а что нет. Запускается трижды, после чего выбирается консенсусный набор. Что три прогона лучше одного — выяснилось само. Я написала инструкцию для автоматических экспериментов (Эндрю Нг на днях поделился), запустила Claude и ушла. Он сам провёл 34 эксперимента — менял параметры, измерял точность, решал что попробовать дальше — и остановился, когда улучшения закончились. И так появился этот трехкратный прогон на этом этапе. Зато, что круто - написал что промт так сконфигурирован что любое изменение - ухудашет метрику (consistency + coverage)
-
-**Pass 2 — События по линиям** Задача: прочитать каждую серию отдельно и раскидать её события по линиям из Pass 1. Запускается один раз на каждую серию, все серии параллельно (10 серий = 10 вызовов одновременно). Результат: для каждой серии — список событий, каждое привязано к своей сюжетной линии. После этого код считает вес каждой линии в каждой серии — сколько событий ей досталось — и определяет какая A, B или C.
-
-**Pass 3 — Ревизия** Задача: впервые увидеть полную картину — все линии, все события всех серий, все веса — и проверить целостность. Нет ли дублирующихся линий? Правильно ли расставлены ранги? Есть ли у каждой линии арка (завязка → развитие → кульминация)? Не остались ли события-сироты? Результат: вердикты — объединить, переназначить, повысить, понизить — которые применяются автоматически. Запускается один раз.
diff --git a/docs/knowledge/theory/enculturation-core-idea.md b/docs/knowledge/theory/enculturation-core-idea.md
deleted file mode 100644
index 51a2701..0000000
--- a/docs/knowledge/theory/enculturation-core-idea.md
+++ /dev/null
@@ -1,25 +0,0 @@
----
-type: concept
-project: tvplotlines
-status: active
----
-
-# Enculturation-аргумент tvplotlines: центральная идея
-
-LLM уже несёт в себе нарративные нормы из обучающих данных — паттерны сюжетной структуры, представления о «правильном» развитии истории, типичные арки персонажей. Промты tvplotlines не учат модель этим вещам с нуля. Они **активируют и направляют** уже усвоенные паттерны, задавая систему координат (Story DNA, franchise types, event functions), через которую модель структурирует своё понимание.
-
-## Откуда это следует
-
-- **Frazier et al. (2019):** модель, обученная на детском комиксе, переносит нормы на Star Wars без дообучения. Нарративные нормы усваиваются из историй и переносятся.
-- **Jung et al. (2026):** LLM «от природы» предпочитают стиль сюжету (на 67% чаще). У модели уже есть нарративные предпочтения до всяких промтов — промты их перенаправляют.
-- **AlKhamissi et al. (2024):** язык промта активирует культурно-специфичные «подсети» знаний. Промт — переключатель, не учебник.
-- **Winston (2011, 2017):** культура системы = набор правил вывода и концептуальных паттернов. Enculturation = передача этого набора.
-- **Piper & Bagga (2024):** теория → словарь понятий → промт → результат. Промт операционализирует теорию, давая модели vocabulary для структурирования того, что она уже знает.
-- **Liu et al. (2026):** LLM как «нарративный артефакт» — хранилище нарративных паттернов человечества.
-
-## Следствия для промтов tvplotlines
-
-1. Промты — не инструкции для неучёного работника. Это **система координат для эксперта**, который уже знает предмет, но которому нужно сказать, в какой рамке работать.
-2. Разные промты = разные «культуры анализа» = разные результаты из того же текста (Winston: Dr. Jekyll / Mr. Hyde).
-3. Язык промта имеет значение: русский и английский промты могут активировать разные нарративные паттерны (AlKhamissi).
-4. Модель имеет собственные предпочтения (style bias по Jung) — промты должны это компенсировать.
diff --git a/docs/knowledge/theory/glossary.md b/docs/knowledge/theory/glossary.md
deleted file mode 100644
index 5b88433..0000000
--- a/docs/knowledge/theory/glossary.md
+++ /dev/null
@@ -1,238 +0,0 @@
----
-type: draft
-project: tvplotlines
-status: active
----
-
-# Glossary
-
-Terms in dependency order — each term is defined before it is used.
-
----
-
-## 1. Story DNA
-
-Shorthand for four components every plotline must have: **hero** + **goal** + **obstacle** + **stakes**. Term from Nash *Save the Cat! Writes for TV*. Used throughout as a completeness test.
-
-- **hero** — main cast member whose decisions drive this plotline. Must be from the recurring cast, not a guest. Each plotline has its own hero — not necessarily the series protagonist.
-- **goal** — what the hero wants. Tangible, trackable — the audience can tell whether the hero is winning or losing. "Build a drug empire." "Find the meth cook." Can be forward-looking ("will they survive?" = Central Question) or backward-looking ("who killed Danny?" = Central Mystery). Formulate through a verb (investigate, survive, escape, discover).
-- **obstacle** — what specifically blocks the hero. Another person? A circumstance? An internal fear?
-- **stakes** — what happens if the hero fails. "Gets caught." "Family falls apart." "Dies."
-
----
-
-## 2. Plotline
-
-A story with complete Story DNA (hero + goal + obstacle + stakes). Missing any component = not a plotline, just an event inside another plotline. Exception: runner — a minor recurring thread tracked as plotline but without full conflict structure (no obstacle or resolution).
-
-A plotline has a three-act structure (beginning, middle, end), conflict, and a causal chain of events.
-
-TV episodes typically feature two or more parallel plotlines, denoted by letters A, B, C: a main A plot that dominates screen time and secondary B plots that may offer thematic parallels or counterpoint. Three stories per episode are typical, though some shows have more — in ensemble shows it's not unheard of to have 4 or 5 concurrent plotlines. Each story is usually driven by one character in the main cast.
-
-Granularity: the key is GOAL, not character. One character can drive multiple plotlines with different goals. One plotline = one hero + one goal + causal connection between events. Different plotlines = different heroes, OR same hero with different goals, OR no causal connection.
-
-Test: can you write a logline (hero + goal + obstacle + stakes)? Yes = plotline. No = not a plotline.
-
-Not a plotline:
-- "John has lunch" — background, no goal/conflict
-- "Everyone goes to a party" — setting, no hero/stakes
-- "John is sad" — state, no goal/obstacle
-- "John and Mike's friendship" — context, no conflict
-- "The investigation" (procedural, ep.5) — franchise engine, part of the case_of_the_week plotline
-
-Seed and wraparound are not plotline types — seed is an event function (see function below), wraparound is a narrative device.
-
-When in doubt — do NOT create a plotline.
-
-Examples — NYPD Blue (hybrid, A = character-led, B = case):
-- A "Sipowicz: Partnership" — wants to accept new partner, but jealousy and distrust, stakes: career
-- B "Simone: Murder Case" — wants to solve murder, but clues don't add up, stakes: justice
-- C "Lesniak: Abusive Ex" — wants to get free of ex, but he won't let go, stakes: safety
-
-Examples — Breaking Bad (serial, one character = two plotlines with different goals):
-- A "Walt: Empire" — wants to build drug empire, but law enforcement and rivals, stakes: death
-- B "Walt: Family" — wants to provide for family, but Skyler discovers the truth, stakes: family falls apart
-
-## 3. Format (Pass 0)
-
-### format
-Determines what plotlines to expect in pass1: how many, what types, whether they close per episode.
-Tech insight: understanding the problem before extraction improves accuracy (Wang 2023, Plan-and-Solve: "first understand the problem and devise a plan, then carry out the plan").
-Cognitive science insight: format tells the LLM what to look for — like a genre label on a book cover switches how we read it (Zwaan 1993).
-
-- **procedural** — each episode contains a self-contained story (case, patient, mission) that opens and closes within the episode. Character plotlines exist but stay in the background. CSI, House, Law & Order.
-- **hybrid** — each episode has a case-of-the-week AND serialized plotlines that carry across episodes and actively intertwine with the case. Both matter. X-Files, Buffy, Good Wife, Grey's.
-- **serial** — episodes continue each other. Conflicts don't close within an episode. No case-of-the-week. Breaking Bad, The Wire, Sopranos.
-- **limited** — same as serial, but the story is designed to end this season. All plotlines must resolve by the end of season. Chernobyl, Queen's Gambit.
-
-Diagnostic: if E01 and E02 have different cases — procedural or hybrid. If E02 continues E01's conflict without closing it — serial.
-
-Expected plotline count by format:
-- procedural: 2–3 (1 case_of_the_week + 1–2 serialized)
-- hybrid: 3–6
-- serial: 3–8
-- ensemble: 4–6
-
-### is_ensemble
-No single protagonist. Multiple characters drive their own plotlines with roughly equal screen time. Diagnostic: can you name THE main character? If not — ensemble. This matters because ensemble shows have 2+ A-rank plotlines instead of one. Game of Thrones, This Is Us, Succession, The Crown.
-
-### is_anthology
-Are seasons or episodes independent — new cast, new story, no continuity? Yes = anthology. This matters because anthology seasons have no continuity — prior season data is not passed to the next step. True Detective, Fargo, Black Mirror.
-
-### story_engine
-The show's repeating dramatic mechanism in one sentence. Focus on the verbs — what are characters doing each week? (Landau: "Verbs express characters' episodic goals in the form of micro missions.")
-
-Templates by format:
-- **procedural:** "Every week [profession] [verb] [type of challenge], testing [hero's quality]." Example: "Every week a diagnostician solves a medical mystery, testing the limits of ethics" (House).
-- **hybrid:** "Every week [profession] [verb] [case] while [ongoing character plotline]." Example: "Every week lawyers litigate a new case while navigating political power games" (Good Wife).
-- **serial:** "[Hero] [transformation], testing how far they'll go for [goal]." Example: "A chemistry teacher builds a drug empire, testing how far he'll go for family and control" (Breaking Bad).
-- **limited:** "[Characters] [verb] [one problem] over one season." Example: "Nuclear engineers and officials investigate a reactor explosion, testing how far the state will go to cover it up" (Chernobyl).
-
-### genre
-Free text. Not validated, not used downstream.
-
----
-
-## 4. Cast (Pass 1)
-
-### cast member
-- **id** — snake_case: "walt", "jesse"
-- **name** — full: "Walter White"
-- **aliases** — synopsis variants: ["Walt", "Heisenberg"]
-
----
-
-## 5. Plotline Fields (Pass 1)
-
-### plotline fields
-- **id** — snake_case, stable (doesn't change if plotline is renamed): "empire", "murder_case", "family_tension"
-- **name** — "Hero: Theme": "Walt: Empire". Named by GOAL, not by event.
-- **hero** — see Story DNA above.
-- **goal** — see Story DNA above. case_of_the_week plotline has a template Story DNA — repeating goal/obstacle/stakes, specific content filled in per episode by pass2.
-- **obstacle** — see Story DNA above.
-- **stakes** — see Story DNA above.
-
-### type
-How long does this plotline last?
-- **case_of_the_week** — opens and closes within one episode. New each episode. The patient in House, the murder in CSI. Always named "Case of the Week" regardless of the show — the specific case content changes per episode, but the plotline is one recurring slot.
-- **serialized** — spans multiple episodes, conflicts carry over. Walt's empire, Alicia's career.
-- **runner** — minor recurring thread, 3-5 beats per episode, no complete set of functions. Incomplete Story DNA (no obstacle or resolution). Ted's shortbread, office romance.
-
-### rank
-Typical importance of this plotline across the season. Rank = resonance, not event count. A = "the largest or most resonant story", not necessarily most screen time. Rank is assigned once per season in pass1. Within individual episodes, a plotline's actual presence may differ — a B-plotline can dominate a specific episode (Oberg: "The A-Story over one episode can become a B-story in the next episode"). Per-episode presence is captured by weight (see postprocess below).
-- **A** — the plotline the series is ABOUT. Gets all or most of 7 functions across the season. In procedural: case_of_the_week = A. In hybrid: character plotline = A, case = B. For example, NYPD Blue — character relationship = A, murder case = B, even though case has more scenes.
-- **B** — second most important. Has its own complete Story DNA. Often carries the episode's theme.
-- **C** — third. Lighter in tone, less screen time. Can be comic relief or a seed for future plotlines.
-
-Plotlines with type=runner have rank=null — they are by definition minor threads that don't participate in A/B/C ranking.
-
-### nature
-Where does the main problem come from? Nature sets expectations for Story DNA validation: plot-led plotline should have an external obstacle, character-led should show internal conflict, theme-led should have a systemic problem without a single antagonist. Nature of a plotline and nature of individual events can differ — plot-led action serving a character-led plotline is normal (Oberg: "each episode tends to be plot-led, even if the series is character-led").
-- **plot-led** — from outside the hero. Antagonist, monster, crime. Stranger Things, CSI.
-- **character-led** — from inside the hero. The hero IS the problem. Breaking Bad, Fleabag.
-- **theme-led** — from society. Systemic, no single solution. The Wire, Succession.
-
-### confidence
-How complete is the conflict structure?
-- **solid** — hero, goal, obstacle, stakes all clear. You can write a logline with conflict.
-- **partial** — hero and goal clear, obstacle or stakes unclear.
-- **inferred** — plotline implied, conflict structure incomplete.
-
-Confidence is used downstream:
-- postprocess: arc_completeness thresholds are lower for inferred/partial plotlines (inferred with 3/7 = expected, solid with 3/7 = flag)
-- pass3: inferred plotline with few events = candidate for DROP
-- app: visual distinction (e.g. dashed line for inferred, solid for solid)
-
-### prior season plotline status
-When analyzing a new season with prior season data, each prior plotline is classified. Process prior plotlines BEFORE looking for new ones.
-- **CONTINUES** — same hero, same goal, new circumstances. Keep ID, update obstacle/stakes. Example: "Walt: Empire" S1→S2 — still building the empire, but now Gus is the obstacle instead of Tuco.
-- **TRANSFORMED** — same hero, different goal. Keep ID, rewrite goal/obstacle/stakes. Example: "Walt: Empire" S4→S5 — no longer building, now hiding from consequences.
-- **ENDED** — plotline is gone. Do not include.
-
----
-
-## 6. Events (Pass 2)
-
-### event
-One action that changes the situation. If nothing changes — not an event. Two actions where the second is an immediate consequence of the first = one event.
-- **event** — one sentence: "Walt kills Krazy-8."
-- **plotline** — which plotline (ID), or null
-- **function** — position in the episode structure: where this event sits in THIS episode (see function below). The same event may have a different position in the plotline's season-long sequence of functions — that is computed in postprocess, not assigned by LLM.
-- **characters** — who is involved (cast IDs, guests: `guest:name`)
-- **also_affects** — other plotlines secondarily affected by this event. One event touches two plotlines → assign to primary goal, note the secondary in also_affects. "Walt kills Krazy-8" = empire, also_affects: investigation.
-
-### function
-Where in the episode structure does this event sit? The same 7 functions apply at two levels (Oberg: "the same dramatic three-act structure applies at every level: scene, sequence, subplot, storyline, episode, season"):
-- **Episode level** — LLM assigns in pass2. "Walt kills Krazy-8" = climax of this episode.
-- **Plotline level** — code computes in postprocess by collecting all events of a plotline across the season. The same event may be episode climax but plotline escalation (early in the season, far from the season climax).
-
-Seven functions, in order:
-- **setup** — world before anything happens. Status quo. Can repeat (setup for different plotlines).
-- **inciting_incident** — the event that starts the plotline. Without it, the plotline doesn't exist. One per plotline, does not repeat. "Walt is diagnosed with cancer."
-- **escalation** — stakes rise, situation complicates. Can repeat — multiple escalations in a row is normal (Nash: Fun & Games). Escalation AFTER turning_point is OK (Bad Guys Close In comes after Midpoint).
-- **turning_point** — direction reverses. Winning turns to losing or vice versa. One major turn per plotline.
-- **crisis** — lowest point. Hero faces what they feared most. True dilemma, no good options. Must come AFTER turning_point, never before.
-- **climax** — peak confrontation. Outcome is irreversible. Must come AFTER crisis. Does not repeat.
-- **resolution** — aftermath. World after the climax. Optional — some plotlines end on climax (especially in ongoing format). In limited format, all plotlines must have resolution.
-
-Order rules:
-- Strict sequence of milestones: inciting_incident → turning_point → crisis → climax. No going back past a milestone.
-- escalation can appear between any milestones (before turning_point, after turning_point, even after crisis — as long as climax hasn't happened).
-- setup can only appear before inciting_incident.
-- resolution can only appear after climax (or be absent).
-- Timing is flexible — milestones don't have to be evenly spaced (Nash: "The beat sheet is an itinerary, not a calendar").
-
-Emotional counterpoint: if all plotlines in an episode are rising or all falling — something is missed or functions are wrong.
-
-### interaction
-How plotlines connect in this episode:
-- **thematic_rhyme** — two plotlines explore the same theme from different angles.
-- **dramatic_irony** — audience knows something a character doesn't, because of another plotline.
-- **convergence** — plotlines collide: characters or conflicts from different plotlines meet.
-
-### patch
-Problem detected during episode analysis. Patches are hints for pass3 — suggestions, not commands. Pass3 decides whether each patch is justified.
-- **ADD_LINE** — event doesn't fit any plotline. New plotline needed?
-- **CHECK_LINE** — plotline has no events this episode. Ended early?
-- **SPLIT_LINE** — plotline covers two unrelated things. Split?
-- **RERANK** — C-plotline has more events than A. Ranks wrong?
-
----
-
-## 7. Postprocess — Code
-
-### span
-`[episode_id for episode in episodes if plotline has events in episode]`
-
-### weight
-Per plotline per episode — how present this plotline is:
-- `primary` — >= 50% of max event count in this episode
-- `background` — >= 2 events
-- `glimpse` — 1 event
-
-### arc_completeness
-`len(set(e.function for e in plotline_events)) / 7`
-Flag if below minimum: A >= 6/7, B >= 5/7, C >= 3/7, runner >= 1/7.
-
-### convergence_matrix
-Directed count from `also_affects`: how many times plotline A's events affected plotline B. A->B != B->A.
-
-### monotonicity
-Plotline's season-long sequence of functions must not return past a milestone. Milestones: inciting_incident, turning_point, crisis, climax.
-OK: escalation after turning_point. Violation: crisis after climax.
-
----
-
-## 8. Verdicts (Pass 3)
-
-### notes
-Free text: overall quality assessment of the season's plotline structure. What works, what doesn't.
-
-### verdict actions
-- **MERGE** — two plotlines are really one. Combine.
-- **REASSIGN** — event belongs to a different plotline. Move.
-- **PROMOTE** — plotline is more important than rank says. B -> A.
-- **DEMOTE** — plotline is less important than rank says. A -> B.
-- **CREATE** — orphaned events form a new plotline pass1 missed.
-- **DROP** — plotline has no real conflict. Remove, redistribute events. Only for phantoms — weak but real plotlines should be marked through confidence, not dropped.
-- **REFUNCTION** — event has wrong function. Escalation is actually crisis.
diff --git a/docs/knowledge/theory/naive-vs-plotter.md b/docs/knowledge/theory/naive-vs-plotter.md
deleted file mode 100644
index f7fe615..0000000
--- a/docs/knowledge/theory/naive-vs-plotter.md
+++ /dev/null
@@ -1,53 +0,0 @@
----
-type: note
-project: tvplotlines
-status: active
----
-
-# Experiment: Naive Prompt vs tvplotlines Pipeline
-
-## Goal
-
-Show that LLM results are non-deterministic, and that tvplotlines's constraints solve this.
-Two claims in one experiment:
-
-1. **Inter-run divergence:** naive prompt produces different plotline structures on repeated runs
-2. **Divergence from ground truth:** naive results disagree with expert annotation; tvplotlines's don't
-
-## Design
-
-**Input:** Breaking Bad Season 1 synopses (from benchmark).
-Breaking Bad chosen because it has the lowest tvplotlines ARI (0.767) — genuine ambiguity in the data. Naive prompt should show even larger spread.
-
-**Naive prompt:**
-
-> "Here are synopses of a TV season. Extract the main plotlines. For each plotline, list which characters are involved and which episodes it spans."
-
-No output format, no definitions (what is a plotline? what is span?), no franchise type, no Story DNA structure.
-
-**Runs:**
-
-| Condition | Runs | Model | Temperature |
-|-----------|------|-------|-------------|
-| Naive prompt | 5 | same as tvplotlines (Haiku) | default |
-| tvplotlines pipeline | 5 | Haiku | default |
-
-**Metrics:**
-
-- **ARI** (Adjusted Rand Index) across runs — measures inter-run consistency
-- **ARI vs ground truth** — measures accuracy against expert annotation
-- **Coverage** — fraction of events assigned to a plotline
-
-## Status
-
-- [ ] Write naive prompt runner script
-- [ ] Run 5x naive
-- [ ] Run 5x tvplotlines
-- [ ] Compute ARI (inter-run + vs ground truth)
-- [ ] Write up results for preprint (Section 1 or Section 3)
-
-## Notes
-
-- Keep naive prompt intentionally simple — this is what a user would type into ChatGPT
-- Use the same model and temperature for fair comparison
-- Results go into the intro as motivation: "here's the problem we solve"
diff --git a/docs/knowledge/theory/narrative-intelligence-theory.md b/docs/knowledge/theory/narrative-intelligence-theory.md
deleted file mode 100644
index 102cfcd..0000000
--- a/docs/knowledge/theory/narrative-intelligence-theory.md
+++ /dev/null
@@ -1,206 +0,0 @@
----
-type: concept
-project: tvplotlines
-status: active
----
-
-# Логика как условия возможности нарративного интеллекта
-
-## Дискуссия 2026-03-18 (русский текст, не редактировать)
-
----
-
-### Два пути из Витгенштейна
-
-**Из раннего Витгенштейна.** Логика — это условия возможности осмысленного высказывания. Не описание мира, а то, что должно быть на месте, чтобы описание вообще могло состояться. Если перенести это на ИИ: когда мы даём системе эпистемическую логику, мы не учим её конкретным историям. Мы создаём условие, при котором система вообще способна различать "знает" и "не знает". Без этого условия у системы нет suspense, не потому что она не выучила suspense, а потому что у неё нет того, из чего suspense может возникнуть. Мы не скелет пересаживаем — мы создаём условия возможности.
-
-**Из позднего Витгенштейна.** Значение — это употребление. Нет скрытой логической структуры, есть практика. И вот: LLM-ы — это буквально машины позднего Витгенштейна. Они выучили язык через употребление. Миллиарды примеров того, как слова используются в контексте. Никакой формальной модели внутри. И они работают — порождают осмысленный текст, "играют в языковые игры".
-
-**Про направление.** Витгенштейн шёл от раннего к позднему: сначала думал что логическая структура первична, потом понял что практика первична. Мы идём одновременно в обе стороны. LLM-ы пошли по пути позднего Витгенштейна и добились поразительных результатов. Но они ломаются именно там, где нужен ранний: логическая связность, каузальная когерентность, отслеживание кто что знает. Они выучили практику, но у них нет условий возможности.
-
-И вопрос, который сейчас стоит перед полем: можно ли соединить оба. Дать машине, которая уже освоила практику, ещё и условия возможности — не убив при этом то, что делает её хорошей.
-
----
-
-### Нарративные эффекты как эмерджентные свойства
-
-Suspense — это не вещь. Это эффект, который возникает когда выполнены определённые условия. Какие: зритель знает что-то, чего не знает персонаж. Есть угроза. Персонаж движется к ней, не подозревая. Suspense живёт в зазоре между двумя состояниями знания.
-
-LLM может написать текст, который выглядит как suspense, потому что видела тысячи примеров. Но она не поддерживает два отдельных состояния знания. У неё нет зазора. Она имитирует поверхность явления, у которого нет внутренней структуры в её модели.
-
-И это обобщается на все нарративные эффекты:
-
-- **Dramatic irony** — возникает из зазора: зритель знает, персонаж нет. Без двух раздельных состояний знания — невозможна.
-- **Предательство** — возникает из того, что раньше было доверие. Без памяти о предыдущем состоянии отношений — нет предательства, есть просто плохой поступок.
-- **Моральная дилемма** — возникает из того, что два обязательства несовместимы. Без способности представить два обязательства одновременно — нет дилеммы.
-- **Неожиданность** — возникает из нарушения ожидания. Без модели ожидания — нет неожиданности.
-- **Ненадёжный нарратор** — возникает из расхождения утверждений нарратора с фактами. Без способности удерживать и то и другое — просто шум.
-
-Каждый нарративный эффект — это не объект, который можно выучить. Это эмерджентное свойство определённой конфигурации условий. Логика описывает эти условия. Без условий — эффект невоспроизводим, только имитируем.
-
-Проверяемое утверждение: когда LLM генерирует "suspense", она действительно отслеживает кто что знает на протяжении текста? Или она просто порождает текст, который статистически похож на suspense-фрагменты из обучающих данных? Если второе — она имитирует, а не порождает.
-
----
-
-### Промпты как неформальные условия возможности
-
-"Без этого условия у системы нет suspense, не потому что она не выучила suspense, а потому что у неё нет того, из чего suspense может возникнуть." — Это же как раз подтверждение того что уже не машинное обучение работает с моделями, а как раз промпты. Как логика, а не как млрд примеров.
-
-Промпт не даёт LLM-у миллиард примеров. Промпт задаёт рамку — "в этом контексте различай X и Y", "отслеживай кто что знает", "выдели причинно-следственные связи". Это ближе к тому, что делает логика (задаёт условия), чем к тому, что делает ML (учится на данных).
-
-LLM уже выучила практику — поздний Витгенштейн, миллиарды примеров употребления. Промпт добавляет ей условия возможности — ранний Витгенштейн. "В рамках этого разговора у тебя есть способность различать знание и незнание." И она начинает это делать — не потому что доучилась, а потому что ей задали структуру.
-
-Chain-of-thought — то же самое. "Давай рассуждай пошагово" — это не пример, это условие. Ты не показываешь ей решение, ты создаёшь условие при котором решение может возникнуть.
-
-И вот почему это хрупко: промпт — это неформальное условие возможности. Оно на естественном языке, оно зависит от формулировки, оно может не сработать если переформулировать. Формальная логика — это то же самое, но надёжно. Промпт говорит "отслеживай кто что знает". Эпистемическая логика говорит "для каждого агента a и пропозиции p определено значение K_a(p)". Второе не ломается от перефразирования.
-
-Может быть весь промпт-инжиниринг — это попытка на естественном языке делать то, что логика делает формально: создавать условия возможности для мышления.
-
----
-
-### Чомски: нельзя научиться тем же способом
-
-Она уже говорит на нашем языке. Но нам нужно научить её чему-то, чему нельзя научиться тем способом, которым она научилась говорить.
-
-Чомски всю жизнь говорит одну вещь: язык нельзя выучить только из данных. Ребёнок слышит ограниченный, шумный, неполный ввод — и из этого порождает бесконечное количество правильных предложений, которых никогда не слышал. Значит внутри уже есть что-то — врождённая структура, универсальная грамматика. Условие возможности, без которого никакой объём данных не поможет.
-
-И вот LLM-ы — это буквально эксперимент, который Чомски считал невозможным. Им дали чудовищный объём данных, и они заговорили. Без врождённой структуры. На чистой статистике. Чомски до сих пор говорит что это не настоящее понимание языка, а имитация.
-
-И интересно что оба правы. LLM-ы действительно говорят — performance в терминах Чомски. Но у них нет competence — глубинного понимания структуры. Они порождают правильные предложения, но не могут гарантировать логическую связность на длинной дистанции. Именно то, за что отвечает глубинная структура.
-
-И промпт — это попытка дать ей эту структуру на её же языке. Как если бы ты объясняла грамматику человеку, который уже бегло говорит, но никогда не учил правил.
-
----
-
-### Competence и Performance — термины Чомски
-
-Competence и performance — центральное различение в генеративной лингвистике Чомски с 1965 года (Aspects of the Theory of Syntax).
-
-**Performance** — то, что говорящий реально порождает. Конкретные высказывания, с ошибками, запинками, незаконченными предложениями. LLM-ы — это машины performance.
-
-**Competence** — внутреннее знание правил, которое позволяет отличить правильное от неправильного, возможное от невозможного. Даже если ты никогда не слышал конкретное предложение — ты знаешь, грамматично оно или нет.
-
-Когда мы через промпт или через формальную логику даём LLM-у эпистемическую структуру — мы даём ей competence. Не ещё один пример suspense, а правило: suspense возникает когда K_зритель(p) ∧ ¬K_персонаж(p). Теперь система не имитирует suspense из примеров, а может проверить — есть ли условия для suspense в данной сцене.
-
-Логика — это competence для нарративного интеллекта. Мы объясняем правила, по которым создаются напряжение, конфликт, ирония — а не показываем ещё миллион примеров.
-
----
-
-### Метафора: арабский парень из Кембриджа
-
-Когда я училась в Англии на языковых курсах, в группе был арабский парень — второй сын третьей жены, отец загнал его в Кембридж потому что нью-йоркская школа пожаловалась что он не учится. Он отлично говорил по-английски, но плохо читал и писал. Я наоборот. Мы были тяни-толкай: он закрывал все вопросы в барах и пабах, а я на уроках.
-
-LLM — это он. Говорит бегло. Но читать и писать не умеет. Выучил язык в пабе.
-
----
-
-### Щерба: глокая куздра и зеркальный дефицит
-
-Лев Владимирович Щерба (1880–1944) — русский лингвист, ученик Бодуэна де Куртенэ. Знаменит фразой: "Глокая куздра штеко будланула бокра и кудрячит бокрёнка." Искусственное предложение из несуществующих слов. Доказывает что грамматическая структура понимается без семантики. Ты не знаешь что такое "куздра", но знаешь что она — субъект, женского рода, что она что-то сделала с "бокром" и продолжает что-то делать с "бокрёнком". Структура без содержания.
-
-Это зеркально к LLM-ам: они порождают содержание (или его имитацию) без гарантированной структуры. Бегло, убедительно, но каузально или логически может быть бессвязно.
-
-Два зеркальных дефицита:
-- Глокая куздра = **структура без значения** (грамматика работает, смысла нет)
-- LLM-suspense = **значение без структуры** (читается гладко, но внутри нет эпистемического зазора)
-
-Щерба также разделял речевую деятельность (то что люди реально говорят), языковую систему (правила) и языковой материал (тексты). Это перекликается с Чомски (performance vs competence), хотя Щерба был раньше и подход другой.
-
----
-
-### Dramatis (O'Neill & Riedl, 2014): доказательство тезиса
-
-Статья Dramatis — прямое доказательство тезиса "логика как competence". Riedl и O'Neill не учили систему распознавать suspense из примеров. Они формализовали условия, при которых suspense возникает:
-
-1. Протагонист движется к негативному исходу
-2. Читатель пытается мысленно построить "escape plan" — план спасения
-3. Чем сложнее этот план (дороже, менее вероятен) — тем выше suspense
-
-Система читает историю в формате STRIPS-операторов (планировочная логика — preconditions, effects), строит escape plan через планировщик, оценивает его стоимость. Высокая стоимость = высокий suspense. Результаты совпадают с оценками живых читателей на Casino Royale, Rear Window, Harry Potter.
-
-Suspense — не вещь которую выучиваешь, а эмерджентное свойство конфигурации условий. Riedl дал системе competence (формальные условия — каузальные связи, планировочное пространство, модель памяти читателя) — и система смогла измерять suspense без единого примера suspense в обучающих данных.
-
-Но: это 2014, до LLM. Система требует ручной разметки — каждое действие закодировано как STRIPS-оператор человеком. Не умеет читать текст. Чистый competence без performance. Зеркало LLM-ов.
-
-Dramatis — недостающий кусок. LLM читает текст и извлекает события (performance). Dramatis-подобная система оценивает структуру (competence). Вместе — организм.
-
-### Что стало с авторами Dramatis
-
-**Brian O'Neill** — первый автор Dramatis, это была его PhD диссертация (Georgia Tech, 2013, научный руководитель — Riedl). После защиты ушёл в преподавание: заведовал кафедрой CS в Western New England University, с 2023 — в Quinnipiac University. В narrative AI больше не публиковался.
-
-**Mark Riedl** — научный руководитель O'Neill, второй автор. После Dramatis:
-- 2016 — манифест "Computational Narrative Intelligence" (position paper)
-- 2016-2020 — Quixote (RL-агент учится ценностям из историй), explainable AI через нарративы
-- Сейчас — Director of Georgia Tech Machine Learning Center
-- 2024 — вернулся к suspense: **Xie & Riedl, "Creating Suspenseful Stories: Iterative Planning with LLMs"** (EACL 2024). Та же идея (suspense = сужение escape plans), но вместо ручных STRIPS — LLM с итеративным промптингом. Zero-shot, без обучающего корпуса.
-
-**Кто за что отвечал в Dramatis (предположение):**
-
-Dramatis — это PhD O'Neill, значит он построил систему: закодировал MEI-P (модель памяти читателя), реализовал планировщик (модифицированный HSP), провёл эксперименты с людьми, написал краудсорсинг STRIPS-операторов и скриптов. Инженерная часть — его.
-
-Riedl как научрук скорее всего отвечал за теоретическую рамку: связь с психологической моделью Gerrig & Bernardo, переформулирование suspense как planning problem, общая архитектура идеи. Концептуальная часть — его.
-
-Косвенное подтверждение: после разделения O'Neill перестал публиковаться в narrative AI (ушёл инженер), а Riedl продолжил развивать идеи (остался визионер). В 2024 Riedl вернулся к suspense уже с другим соавтором (Xie) и другой реализацией (LLM вместо STRIPS), но с той же теоретической рамкой.
-
-**Xie & Riedl 2024 — что делают:**
-- Задают персонажа с целью + негативный исход
-- LLM генерирует возможные планы спасения
-- Система "атакует" планы, создавая условия провала
-- Suspense растёт по мере сужения пространства escape plans
-- Та же логика что в Dramatis, но performance (LLM) вместо ручной разметки (STRIPS)
-
-tvplotlines идёт в обратном направлении: извлекает структуру ИЗ существующих историй, а не генерирует истории. Но принцип тот же: LLM как performance + формальная структура как competence.
-
----
-
-### Два поколения narrative AI (объяснение цитаты из Riedl 2016)
-
-Riedl в CNI position paper описывает два поколения подходов:
-
-**Первое поколение (до ~2010):** Люди вручную описывали мир истории в формальных моделях. Хочешь чтобы система понимала шпионские фильмы — садись и описывай: "есть убийца, есть жертва, есть мотив, убийца скрывает улики" и т.д. Всё в формальном языке (STRIPS, планировочные операторы). Dramatis — как раз из этого поколения. Работает, но для каждого нового жанра/домена нужен человек который опишет всё заново. Это и есть "knowledge engineering bottleneck" — бутылочное горлышко: система умна ровно настолько, насколько подробно человек описал домен.
-
-**Второе поколение (после ~2010):** Попытки автоматически извлекать эти модели из данных — из текстов в интернете (корпуса нарративов) или через краудсорсинг (просят людей описывать ситуации). Вместо одного эксперта — тысячи текстов или тысячи людей.
-
-Riedl говорит: первое поколение работало, но не масштабировалось. Второе масштабируется, но теряет формальную точность.
-
-LLM-ы — это третье поколение, которое Riedl в 2016 ещё не видел. Они "выучили" домены из интернета, но неявно, без формальных моделей. И вопрос — как вытащить из них формальные модели обратно. Это то, что Kelly 2023 пытается делать.
-
----
-
-### Пример: как работает ручная формальная модель
-
-Допустим ты хочешь построить систему, которая понимает шпионские фильмы.
-
-**Ручная формальная модель (первый подход):** Ты садишься и описываешь мир шпионского фильма в формальном языке. Буквально пишешь правила:
-
-```
-Действие: ОТРАВИТЬ(злодей, герой, напиток)
-Предусловия: злодей_имеет(яд), герой_рядом(напиток), герой_не_знает(яд_в_напитке)
-Результат: герой_отравлен, яд_использован
-```
-
-```
-Действие: ПРИНЯТЬ_АНТИДОТ(герой, антидот)
-Предусловия: герой_имеет(антидот), герой_знает(он_отравлен)
-Результат: герой_не_отравлен
-```
-
-И так для каждого действия в мире: стрелять, следить, вербовать, предавать, сбежать... Десятки, сотни операторов. Dramatis работал именно так — Casino Royale вручную переводили в такие операторы.
-
-Система после этого может рассуждать: "герой отравлен, антидот есть, значит может принять антидот — escape plan существует — suspense низкий". Или: "герой отравлен, антидота нет, пистолет далеко, помощь не знает — suspense высокий".
-
-**Проблема** — knowledge engineering bottleneck. Ты описала шпионский мир — а теперь нужен медицинский сериал. Садись и описывай заново: диагноз, лечение, ошибка, осложнение... Потом комедию. Потом фэнтези. Для каждого домена — ручная работа эксперта. Не масштабируется.
-
-**Машинное обучение (второй подход):** Вместо того чтобы вручную писать правила — берём тысячи текстов из интернета (фанфики, пересказы фильмов, сценарии) и пытаемся автоматически извлечь паттерны: "когда кого-то отравили, обычно потом ищут антидот или вызывают врача". Не формальные правила, а статистические закономерности из корпуса.
-
-Или краудсорсинг: просим 500 людей на Amazon Mechanical Turk описать "что обычно происходит когда шпион в баре" — и из их ответов собираем скрипты.
-
-Масштабируется лучше, но теряет формальную точность — нет чётких preconditions и effects, есть "обычно бывает так".
-
----
-
-## English summary
-
-English summary is mostly a direct translation of the first two sections above (Wittgenstein + Narrative Effects). One unique addition from the English version, already integrated into the Russian text above as a new bullet point:
-
-- **Unreliable narrator** — arises from the narrator's assertions diverging from facts. Without the ability to hold both — just noise.
diff --git a/docs/knowledge/theory/preprint-idea-meta-situation-model.md b/docs/knowledge/theory/preprint-idea-meta-situation-model.md
deleted file mode 100644
index ca6027b..0000000
--- a/docs/knowledge/theory/preprint-idea-meta-situation-model.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-type: concept
-project: preprint
-status: active
----
-
-# Мета-situation model: расфокусированное понимание потока
-
-## Наблюдение
-
-Maryanne Wolf и другие говорят: скроллинг убивает глубокое чтение — нет времени на инференсы, эмпатию, критический анализ одного текста.
-
-Но есть другой эффект: информационный поток настолько интенсивен, что заметить тенденции и смыслы можно именно **расфокусировавшись** и глядя на поток целиком, а не на отдельное сообщение.
-
-## Два режима понимания
-
-**Фокусированное чтение** — один текст, глубоко. Строишь situation model конкретного нарратива: персонажи, мотивации, причинность, подтекст.
-
-**Расфокусированное скольжение** — поток текстов, каждый поверхностно, но видишь мета-паттерн. Строишь situation model не текста, а **информационной среды**: «все стали злее», «эта тема вытеснила ту», «этот нарратив повторяется из разных источников».
-
-В терминах Zwaan: первый режим строит situation model **внутри** текста. Второй строит **мета-situation model** — модель потока текстов.
-
-## Связь с plotter
-
-tvplotlines работает во втором режиме: не читает один эпизод глубоко, а скользит по потоку эпизодов и замечает паттерны — эта линия растёт, эта угасает, тут тематическая рифма, тут конвергенция. Pass 3 — буквально «расфокусированный взгляд на целый сезон», видящий структуру, невидимую из одного эпизода.
-
-## Важная оговорка
-
-Скроллинг **предоставляет возможность** для мета-situation model, но пока никто не освоил этот режим осознанно. Люди скроллят — но не строят мета-модели целенаправленно. Возможность есть, навыка нет.
-
-## Статус
-
-Сырая идея. Пока неясно, что с этим делать — может быть discussion-секция препринта, может отдельная заметка, может ничего.
diff --git a/docs/knowledge/theory/screenwriting-theory-reading-prompt.md b/docs/knowledge/theory/screenwriting-theory-reading-prompt.md
deleted file mode 100644
index 1bb5cd0..0000000
--- a/docs/knowledge/theory/screenwriting-theory-reading-prompt.md
+++ /dev/null
@@ -1,181 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# Reading Brief: Что Найти В Учебниках По Сценаристике
-
-Промпт для LLM-ассистента. Читай учебники из списка ниже и заполняй таблицы ответов. Каждый вопрос—конкретный, с указанием зачем нужен ответ. Не додумывай—если в книге нет ответа, пиши "не найдено".
-
----
-
-## Контекст
-
-tvplotlines—библиотека для автоматического извлечения сюжетных линий из синопсисов TV-сериалов. LLM читает синопсис и размечает: какие линии, кто ими движет (driver), какая цель (goal), что мешает (obstacle), что на кону (stakes), и какую функцию выполняет каждое событие в арке эпизода (setup, catalyst, escalation, turning_point, crisis, climax, resolution).
-
-Нам нужно убедиться что наши определения и правила соответствуют индустриальной практике, а не нашему творчеству.
-
-## Книги Для Чтения
-
-1. **Nash**—*Save the Cat! Writes for TV*
-2. **McKee**—*Story*
-3. **Douglas**—*Writing the TV Drama Series*
-4. **Oberg**—*Screenwriting Unchained*
-5. **Landau**—*The TV Showrunner's Roadmap*
-6. **Mittell**—*Complex TV*
-7. **Конспект Netflix pitch workshop** (если доступен в 3-resources)
-
----
-
-## Вопрос 1: Event functions—каноническая Основа
-
-Мы используем 7 функций: setup, catalyst, escalation, turning_point, crisis, climax, resolution. Это микс из разных источников.
-
-**Найти в каждой книге:**
-
-| Книга | Какие этапы/биты/фазы арки автор выделяет? (полный список) | Сколько их? | Есть ли каноническая последовательность? |
-|-------|----------------------------------------------------------|------------|----------------------------------------|
-| Nash | | | |
-| McKee | | | |
-| Douglas | | | |
-| Oberg | | | |
-| Landau | | | |
-| Netflix | | | |
-
-**Дополнительно:**
-
-- Какая система ближе всего к нашим 7?
-- Какая система самая узнаваемая для TV writers/development executives?
-- Если наши 7 = сжатие чьей-то системы, то чьей именно и что мы потеряли при сжатии?
-
-## Вопрос 2: Порядок функций—жёсткие И Гибкие Правила
-
-**Найти:**
-
-| Правило                                                               |
-| --------------------------------------------------------------------- |
-| Может ли catalyst/inciting incident повторяться?                      |
-| Может ли escalation идти после turning_point/midpoint?                |
-| Может ли crisis идти до turning_point?                                |
-| Может ли climax повторяться в одной арке?                             |
-| Может ли setup появиться после midpoint?                              |
-| Какие этапы строго упорядочены (один не может быть после другого)?    |
-| Какие этапы могут повторяться?                                        |
-| Какие этапы могут отсутствовать в арке эпизода/сезона/сюжетной линии? |
-
-## Вопрос 3: Episode completeness—какие Функции Обязательны В Каждом Эпизоде
-
-Каждый эпизод TV-сериала—отдельная арка.
-
-**Найти:**
-
-| Вопрос                                                          |
-| --------------------------------------------------------------- |
-| Должен ли каждый эпизод содержать полную арку (начало → конец)? |
-| Какие элементы обязательны в каждом эпизоде?                    |
-| Какие элементы могут отсутствовать?                             |
-| Есть ли разница для procedural vs serial?                       |
-| Что со средними эпизодами сезона (не пилот, не финал)?          |
-
-## Вопрос 4: A-rank = Всегда Plot-led?
-
-Наш промпт утверждает: A-линия = "plot-led conflict" (внешняя цель vs антагонист).
-
-**Найти:**
-
-| Вопрос                                                           |     |     |     |     |
-| ---------------------------------------------------------------- | --- | --- | --- | --- |
-| A-story / main plot обязательно plot-led (внешний конфликт)?     |     |     |     |     |
-| Может ли главная линия быть character-led (внутренний конфликт)? |     |     |     |     |
-| Есть ли разница для ensemble vs serial?                          |     |     |     |     |
-| Примеры character-led A-линий если есть?                         |     |     |     |     |
-| Определения линий А/В/С?                                         |     |     |     |     |
-
-## Вопрос 5: Количество Основных Сюжетных Линий По Типу Сериала
-
-**Найти:**
-
-| Franchise type                                       |
-| ---------------------------------------------------- |
-| Procedural: сколько линий в эпизоде?                 |
-| Serial: сколько линий в сезоне?                      |
-| Hybrid: сколько?                                     |
-| Ensemble: сколько?                                   |
-| Как определить hybrid чтобы не сливался с procedural |
-
-## Вопрос 6: "Episodic" Как Тип Линии
-
-Мы используем "episodic" для обозначения линии которая открывается и закрывается в каждом эпизоде (case-of-the-week).
-
-**Найти:**
-
-| Вопрос                                                    |
-| --------------------------------------------------------- |
-| Какой термин использует автор для case-of-the-week линии? |
-| Есть ли формальное определение?                           |
-| Как автор отличает episodic от serialized линии?          |
-
-## Вопрос 7: Narrative devices—список И Определения
-
-Мы собираем: dramatic_irony, flashback, flashforward, callback, twist, unreliable. Не уверены что список полный и что определения точные.
-
-**Найти:**
-
-| Вопрос                                                                                                                      |
-| --------------------------------------------------------------------------------------------------------------------------- |
-| Какие narrative/structural devices автор выделяет?                                                                          |
-| Есть ли формальные определения?                                                                                             |
-| Как они связаны с пониманием нарратива (не просто "приём", а зачем)?                                                        |
-| Если мы их соберем - как их использовать при анализе?                                                                       |
-| Есть ли консенсус - как называть, какую роль играют - можно ли их собирать и показывать как всем понятный элемент сценария? |
-
-## Вопрос 8: Emotional Counterpoint Между Линиями
-
-Наш промпт: "if all storylines are rising or all falling—something is missed."
-
-**Найти:**
-
-| Вопрос                                                |
-| ----------------------------------------------------- |
-| Говорит ли автор о контрасте между линиями в эпизоде? |
-| Как это называется?                                   |
-| Это правило или рекомендация?                         |
-| Цитата если есть?                                     |
-|                                                       |
-
-## Вопрос 9: Weight / Screen Time Distribution
-
-Код вычисляет primary/background/glimpse по количеству событий. Пороги произвольные.
-
-**Найти:**
-
-| Вопрос                                                |
-| ----------------------------------------------------- |
-| Какую долю экранного времени занимает A-story?        |
-| B-story?                                              |
-| C-story?                                              |
-| Есть ли конкретные проценты или диапазоны?            |
-| Есть ли другие евристики как определить каждую линию? |
-
-## Вопрос 10: Hybrid Vs Procedural—где Граница?
-
-**Найти:**
-
-| Вопрос                                                               |
-| -------------------------------------------------------------------- |
-| Как автор определяет procedural?                                     |
-| Как определяет hybrid?                                               |
-| В чём конкретное отличие?                                            |
-| Может ли procedural иметь serialized B-линию? Это делает его hybrid? |
-
----
-
-## Формат Ответов
-
-Для каждого вопроса:
-
-1. Заполни таблицу
-2. В каждой таблице в колонках ответы из книг, если ответы длинные, лучше не таблица а заголовок и списокцитат под ним, нужны цитаты а не интерпретации твои потом будет интерптировать
-3. Если нашёл цитату—приведи дословно с номером страницы
-4. Если в книге нет ответа—напиши "не найдено"
diff --git a/docs/knowledge/v3_narratology/Untitled.md b/docs/knowledge/v3_narratology/Untitled.md
deleted file mode 100644
index 753ff30..0000000
--- a/docs/knowledge/v3_narratology/Untitled.md
+++ /dev/null
@@ -1,55 +0,0 @@
-  Классическая нарратология (фундамент):
-
-  - Propp (1959) — Morphology of the Folktale
-
-  - Todorov (1971) — The 2 Principles of Narrative
-
-  - Chatman (1979) — Story and Discourse
-
-  - Prince (1982, 1989) — Narratology, Dictionary of
-
-  Narratology
-
-  - Bal (1988) — Narratology: Introduction to the
-
-  Theory of Narrative
-
-  - Herman (1997, 2009) — Postclassical Narratology,
-
-  Basic Elements of Narrative
-
-  - Bruner (1991) — Narrative Construction of Reality
-
-  
-
-  Computational narratology:
-
-  - Piper, So, Bamman (2021) — "Narrative Theory for
-
-  Computational Narrative Understanding" — ключевая
-
-  - Ranade et al. (2022) — "Computational
-
-  Understanding of Narratives: A Survey"
-
-  - Moretti (2005, 2011) — Graphs/Maps/Trees, Network
-
-  theory + plot analysis
-
-  - Huang & Usbeck (2024) — "Narration as Functions:
-
-  from Events to Narratives"
-
-  
-
-  Прямо релевантные для tvplotlines:
-
-  - Ouyang & McKeown (2015) — Turning Points in
-
-  Narrative
-
-  - Elkins (2022) — Shapes of Stories
-
-  - Piper & Bagga (2022, 2024, 2025) — Data-driven
-
-  narrativity, NarraDetect
\ No newline at end of file
diff --git a/docs/knowledge/v3_narratology/bal1988/actant-model-has-six-roles-not-four.md b/docs/knowledge/v3_narratology/bal1988/actant-model-has-six-roles-not-four.md
deleted file mode 100644
index 9ae1ce0..0000000
--- a/docs/knowledge/v3_narratology/bal1988/actant-model-has-six-roles-not-four.md
+++ /dev/null
@@ -1,53 +0,0 @@
-# Actant model has six roles, not four
-
-Source: Bal 1988, "Narratology", Ch. 3.3 Actors (pp. 166-172)
-
-Greimas's actant model, as presented by Bal, replaces our Story DNA (hero, goal, obstacle, stakes) with six actants in three pairs:
-
-## Subject ↔ Object
-
-The teleological relation: who wants what. Subject = our "hero." Object = our "goal." But Object is broader — it can be a state ("becoming an independent woman"), knowledge ("the identity of the murderer"), or prevention ("preventing discovery").
-
-| Subject | function | Object |
-|---|---|---|
-| John | wants to marry | Mary |
-| Anna Wulf | wants to become | an independent woman |
-| The old people | want to prevent | the discovery of their crime |
-| Kinsey Millhone | wants to know | the identity of the murderer |
-| The killer | wants to avoid | Millhone's discovery |
-| Scheherazade | wants to prevent | the king's killing her |
-
-## Power ↔ Receiver
-
-Who enables or blocks the enterprise overall, and who benefits from the result. Power (Greimas's *destinateur*) is often abstract: society, fate, time, a character trait, social structure. Receiver (*destinataire*) is who benefits — not always the Subject.
-
-Power vs Helper distinction:
-| Power | Helper |
-|---|---|
-| Has power over the whole enterprise | Can give only incidental aid |
-| Is often abstract | Is mostly concrete |
-| Often remains in the background | Often comes to the fore |
-| Usually only one | Usually multiple |
-
-Examples: in a fairy tale, Power = "the king" who sets the quest; in a psychological novel, Power = "the subject's own character trait"; in a social novel, Power = "class structure."
-
-## Helper ↔ Opponent
-
-Who aids the Subject on the way to the Object, and who blocks. Opponent = our "obstacle," but more specific: Opponent blocks *on the way*, while Power enables/blocks *the whole enterprise*.
-
-Helpers: each necessary but individually insufficient. Opponents: must be overcome one by one, but overcoming one doesn't guarantee success.
-
-## What this means for tvplotlines
-
-Story DNA has 4 fields; the actant model has 6. The additions are:
-- **Power** — captures systemic/abstract forces (fate, institutions, character flaws) that our "obstacle" misses
-- **Receiver** — captures who actually benefits, which can differ from the hero
-
-For theme-led shows (The Wire, Succession), Power is especially useful: the real force driving the fabula isn't a character but "the institution" or "the system." Our current Story DNA struggles with these — "hero" and "obstacle" feel forced when the problem is systemic.
-
-## Links
-
-- [[anti-subject-signals-a-separate-storyline]]
-- [[competence-determines-when-subject-can-act]]
-- [[truth-value-reveals-apparent-vs-real-roles]]
-- [[narrative-cycle-has-three-phases-not-seven]]
diff --git a/docs/knowledge/v3_narratology/bal1988/anti-subject-signals-a-separate-storyline.md b/docs/knowledge/v3_narratology/bal1988/anti-subject-signals-a-separate-storyline.md
deleted file mode 100644
index 4b3a4ec..0000000
--- a/docs/knowledge/v3_narratology/bal1988/anti-subject-signals-a-separate-storyline.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# Anti-subject signals a separate storyline
-
-Source: Bal 1988, "Narratology", Ch. 3.3 Actors (pp. 172-173)
-
-An anti-subject is not just an opponent. An opponent blocks the subject *incidentally* — their opposition is circumstantial. An anti-subject has **their own program**, their own aim, and this pursuit happens to cross-purposes with the subject's.
-
-The structural difference: an opponent is defined by their relation to the subject's program. An anti-subject is defined by having **an autonomous program** that independently generates events.
-
-## Example: Tom Thumb
-
-The giant is not merely an opponent who blocks Tom's safe return. The giant has his own program: find children, eat them. He has his own competence (physical force, power of smell). His program intersects with Tom's because Tom *is* the children he wants to eat. Remove Tom from the story and the giant would still be hunting children.
-
-## When lines cross
-
-"The appearance of a separate subject indicates the existence of a sub-fabula." When an actant has their own aims and acts to achieve them, they're an autonomous subject — and their program is a separate fabula that intersects with the primary one. "There are moments in the fabula when the different lines touch or cross."
-
-## What this means for tvplotlines
-
-This is a precise criterion for plotline detection: **if a character has their own program (goal + actions toward it), they're an anti-subject, and their program is a separate plotline.** An opponent who merely blocks the hero doesn't get their own plotline — they're part of the hero's plotline.
-
-In Game of Thrones: Cersei isn't just an opponent to Ned Stark. She has her own program (protect her children, maintain power). That program generates its own events. She's an anti-subject → separate plotline.
-
-In House M.D.: the patient isn't an anti-subject. They don't have an autonomous program that generates events in the fabula. They're the Object of House's program. No separate plotline.
-
-This test is sharper than our current heuristic (different heroes OR one hero with different goals). It asks: does this character *independently generate events*, or only react to the subject's program?
-
-## Links
-
-- [[actant-model-has-six-roles-not-four]]
-- [[confrontation-structure-implies-two-actors-per-event]]
-- [[truth-value-reveals-apparent-vs-real-roles]]
diff --git a/docs/knowledge/v3_narratology/bal1988/bremond-semantic-labels-type-narrative-processes.md b/docs/knowledge/v3_narratology/bal1988/bremond-semantic-labels-type-narrative-processes.md
deleted file mode 100644
index a139369..0000000
--- a/docs/knowledge/v3_narratology/bal1988/bremond-semantic-labels-type-narrative-processes.md
+++ /dev/null
@@ -1,40 +0,0 @@
-# Bremond's semantic labels type narrative processes
-
-Source: Bal 1988, "Narratology", Ch. 3.2 Events (pp. 163-164)
-
-Each process of improvement or deterioration has semantic content. Applying a semantic label to an event makes it possible to compare fabulas structurally across different texts.
-
-## Improvement processes
-
-- **Fulfilment of the task** — the subject completes what was needed
-- **Intervention of allies** — help arrives
-- **Elimination of the opponent** — the obstacle is removed
-- **Negotiation** — a deal is struck
-- **Attack** — forceful action toward the goal
-- **Satisfaction** — can take the form of punishment, revenge, or reward
-
-## Deterioration processes
-
-- **Misstep** — a mistake, error, social blunder, moral lapse, or crime
-- **Creation of an obligation** — the subject becomes bound
-- **Sacrifice** — giving up something of value
-- **Endured attack** — suffering an assault
-- **Endured punishment** — suffering consequences
-
-Each label can be further specified. "Satisfaction" splits into punishment, revenge, reward. "Misstep" splits into mistake, error, social blunder, moral lapse, crime.
-
-## The initial situation
-
-The initial situation of a fabula is always a **state of deficiency** in which one or more actors want to introduce changes. The development of the fabula reveals whether the process involves improvement or deterioration *with regard to the initial situation*.
-
-## What this means for tvplotlines
-
-These labels are more informative than our current "escalation" or "turning_point." Instead of "this event escalates the plotline," we could say "this event is an *endured attack* in a deterioration process" or "this event is a *negotiation* in an improvement process." The vocabulary maps well to TV drama: alliances, betrayals, sacrifices, missteps, attacks — these are the stuff of serialized television.
-
-Question: is this vocabulary universal enough for TV, or too tied to folk/literary narrative?
-
-## Links
-
-- [[narrative-cycle-has-three-phases-not-seven]]
-- [[initial-situation-is-always-a-state-of-deficiency]]
-- [[actant-model-has-six-roles-not-four]]
diff --git a/docs/knowledge/v3_narratology/bal1988/competence-determines-when-subject-can-act.md b/docs/knowledge/v3_narratology/bal1988/competence-determines-when-subject-can-act.md
deleted file mode 100644
index 85bf37a..0000000
--- a/docs/knowledge/v3_narratology/bal1988/competence-determines-when-subject-can-act.md
+++ /dev/null
@@ -1,26 +0,0 @@
-# Competence determines when the subject can act
-
-Source: Bal 1988, "Narratology", Ch. 3.3 Actors (p. 173)
-
-Greimas subdivides the subject's competence — their ability to act — into three types:
-
-- **Determination / will** — the subject *wants* to act
-- **Power / possibility** — the subject *can* act
-- **Knowledge / skill** — the subject *knows how* to act
-
-The phase of the fabula where the virtual subject begins to *desire* the execution of the program is the **introduction** of the fabula. This reframes "inciting incident": it's not necessarily an external event that disrupts equilibrium. It's the moment the subject acquires *determination* — the will to pursue a program.
-
-## Competence as differentiator
-
-Different kinds of subjects are distinguished by which competence they primarily rely on. In fairy tales, the opposition between good and evil often maps to power/force vs knowledge/skill. In detective stories, the detective's competence is knowledge — and interestingly, the murderer's competence is *also* knowledge/skill, but the detective fails in their competence (makes a mistake) while the murderer succeeds in theirs.
-
-## What this means for tvplotlines
-
-We currently have "inciting_incident" as a single concept. But Bal/Greimas suggest it could be decomposed: when does the character gain *will* (determination), *ability* (power), and *knowledge* (skill)? In Breaking Bad, Walt gains determination (cancer diagnosis → will to provide) before he gains knowledge (cooking meth with Jesse) before he gains power (territory, connections). Each is a different structural moment.
-
-This is probably too granular for the current pipeline but could inform character arc analysis.
-
-## Links
-
-- [[actant-model-has-six-roles-not-four]]
-- [[initial-situation-is-always-a-state-of-deficiency]]
diff --git a/docs/knowledge/v3_narratology/bal1988/confrontation-structure-implies-two-actors-per-event.md b/docs/knowledge/v3_narratology/bal1988/confrontation-structure-implies-two-actors-per-event.md
deleted file mode 100644
index ea5bc37..0000000
--- a/docs/knowledge/v3_narratology/bal1988/confrontation-structure-implies-two-actors-per-event.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# Confrontation structure implies two actors per event
-
-Source: Bal 1988, "Narratology", Ch. 3.2 Events (pp. 157-158)
-
-Every functional event has three components: two actors and one action. In logical terms: two arguments and one predicate. Linguistically: subject – predicate – (direct) object, where both subject and object are agents of action.
-
-This is a strict requirement. "John kills a fly" — if the fly isn't an actor (doesn't cause or undergo functional events elsewhere in the fabula), this isn't a functional event despite having the right grammatical form. "Liz writes a letter" — a letter isn't an actor, but writing presupposes a reader, so the confrontation is implicit: "Liz writes to [someone]."
-
-The confrontation criterion filters out isolated actions. John who "kills a fly" and never interacts with another actor functionally isn't participating in the fabula — he's "an isolated agent of action," illustrating a condition (loneliness) rather than driving the plot.
-
-## What this means for tvplotlines
-
-Our event definition doesn't require a second actor. "House orders a lumbar puncture" names only one actor. But by Bal's logic, it's functional because there's an implicit confrontation: House vs. the patient's illness, or House vs. Cameron's objection. Making the second actor explicit (even when it's implicit in the text) would sharpen event descriptions.
-
-## Links
-
-- [[three-criteria-filter-functional-events]]
-- [[actant-model-has-six-roles-not-four]]
-- [[anti-subject-signals-a-separate-storyline]]
diff --git a/docs/knowledge/v3_narratology/bal1988/confrontation-type-reveals-plotline-nature.md b/docs/knowledge/v3_narratology/bal1988/confrontation-type-reveals-plotline-nature.md
deleted file mode 100644
index 1c085a5..0000000
--- a/docs/knowledge/v3_narratology/bal1988/confrontation-type-reveals-plotline-nature.md
+++ /dev/null
@@ -1,23 +0,0 @@
-# Confrontation type (verbal/mental/bodily) reveals plotline nature
-
-Source: Bal 1988, "Narratology", Ch. 3.2 Events (p. 164)
-
-Events can be classified by the **nature of the confrontation** between actors: verbal (spoken), mental (thoughts, feelings, observations), or bodily (physical contact). Whether these contacts succeed, fail, or are indeterminate gives insight into the fabula's themes.
-
-Bal's insight: "If the contact between the two most important actors is predominantly mental and unsuccessful, we may surmise that the theme is alienation." The *type* of confrontation, combined with its success or failure, points to thematic content without needing explicit thematic analysis.
-
-## What this means for tvplotlines
-
-This maps suggestively to our plotline:nature classification (plot-led / character-led / theme-led):
-
-- Predominantly **bodily/action** confrontations → plot-led (external obstacles, physical conflict)
-- Predominantly **mental** confrontations → character-led (internal conflict, alienation, desire)
-- Mixed **verbal** confrontations across many actors → theme-led (institutional dynamics, systemic problems)
-
-If events already have confrontation types, plotline:nature could be *derived* rather than manually assigned. This would be a validation mechanism: if pass1 labels a plotline as "character-led" but its events are all bodily confrontations, something is off.
-
-## Links
-
-- [[three-criteria-filter-functional-events]]
-- [[confrontation-structure-implies-two-actors-per-event]]
-- [[actant-model-has-six-roles-not-four]]
diff --git a/docs/knowledge/v3_narratology/bal1988/events-are-transitions-between-states.md b/docs/knowledge/v3_narratology/bal1988/events-are-transitions-between-states.md
deleted file mode 100644
index 72e8915..0000000
--- a/docs/knowledge/v3_narratology/bal1988/events-are-transitions-between-states.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# Events are transitions between states, not actions by characters
-
-Source: Bal 1988, "Narratology", Ch. 3.2 Events (p. 155)
-
-Bal defines an event as "the transition from one state to another state." The word "transition" stresses that an event is a *process*, an alteration — not a static fact and not necessarily an action.
-
-Compare "John is ill" (a condition — not an event) with "John falls ill" (a transition — an event). The difference is in the verb: the second implies a change of state.
-
-This is subtly but importantly different from the tvplotlines definition: "One action by one character that changes the situation." Bal's definition is broader: an event can be *experienced* (not just *performed*), and the focus is on the state-change, not on the action itself.
-
-## Consequence
-
-"John falls ill" is an event even though no one caused it — it's a transition experienced by an actor. This matters for TV analysis because many significant plot events are things that *happen to* characters (a diagnosis, a discovery, an accident), not things characters *do*.
-
-## Links
-
-- [[three-criteria-filter-functional-events]]
-- [[three-layer-model-separates-text-story-fabula]]
-- [[narrative-cycle-has-three-phases-not-seven]]
diff --git a/docs/knowledge/v3_narratology/bal1988/fabula-is-memory-trace-not-authors-plan.md b/docs/knowledge/v3_narratology/bal1988/fabula-is-memory-trace-not-authors-plan.md
deleted file mode 100644
index b050d58..0000000
--- a/docs/knowledge/v3_narratology/bal1988/fabula-is-memory-trace-not-authors-plan.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# Fabula is a memory trace, not the author's plan
-
-Source: Bal 1988, "Narratology", Introduction (p. 9)
-
-"The fabula is really the result of the mental activity of reading; it is the interpretation by the reader, influenced both by the initial encounter with the text and by the manipulations of the story."
-
-We never access the fabula directly — we reconstruct it. Writers mostly work alone; filmmakers are part of a team. How they proceed "we simply cannot know." What we can study is the text and the conditions under which it produces particular effects.
-
-## Why this matters for tvplotlines
-
-We work with synopses — plot summaries written by someone who watched the episode. These are already *reconstructed fabulas*, not texts. This is actually an advantage: our input is closer to the fabula level than raw scripts would be. But it also means we've already lost text-level and most story-level information (focalization, pacing, visual style) before our pipeline even starts.
-
-The pipeline shouldn't pretend it's analyzing "the show." It's analyzing the fabula as reconstructed in synopses.
-
-## Links
-
-- [[three-layer-model-separates-text-story-fabula]]
-- [[events-are-transitions-between-states]]
diff --git a/docs/knowledge/v3_narratology/bal1988/initial-situation-is-always-a-state-of-deficiency.md b/docs/knowledge/v3_narratology/bal1988/initial-situation-is-always-a-state-of-deficiency.md
deleted file mode 100644
index 644369f..0000000
--- a/docs/knowledge/v3_narratology/bal1988/initial-situation-is-always-a-state-of-deficiency.md
+++ /dev/null
@@ -1,21 +0,0 @@
-# Initial situation is always a state of deficiency
-
-Source: Bal 1988, "Narratology", Ch. 3.2 Events (p. 164)
-
-"The initial situation in a fabula will always be a state of deficiency in which one or more actors want to introduce changes."
-
-This is a strong claim: every fabula begins with something lacking, something wrong, something that needs to change. The development reveals whether the change process leads to improvement or deterioration relative to this initial state.
-
-## Relation to Todorov
-
-This aligns with Todorov's equilibrium model (equilibrium → disruption → new equilibrium), but with an important difference: Bal/Bremond don't assume the initial state is an *equilibrium*. It's already a deficiency. The fabula is the attempt to fix (or worsen) it.
-
-## What this means for tvplotlines
-
-Our "story_engine" and "inciting_incident" implicitly assume a stable starting point that gets disrupted. But many TV shows start *in medias res* — the deficiency is already present in S01E01 (Walter White already has cancer before the pilot's midpoint). By Bal's logic, the "inciting incident" isn't what creates the deficiency — it's the moment the subject gains **determination** (competence to act). This is a subtle but useful reframe.
-
-## Links
-
-- [[narrative-cycle-has-three-phases-not-seven]]
-- [[competence-determines-when-subject-can-act]]
-- [[actant-model-has-six-roles-not-four]]
diff --git a/docs/knowledge/v3_narratology/bal1988/iterative-anticipation-describes-procedural-tv-pilots.md b/docs/knowledge/v3_narratology/bal1988/iterative-anticipation-describes-procedural-tv-pilots.md
deleted file mode 100644
index f643e8e..0000000
--- a/docs/knowledge/v3_narratology/bal1988/iterative-anticipation-describes-procedural-tv-pilots.md
+++ /dev/null
@@ -1,26 +0,0 @@
-# Iterative anticipation describes procedural TV pilots
-
-Source: Bal 1988, "Narratology", Ch. 2.3 Sequential Ordering (p. 84)
-
-An **iterative anticipation** presents an event as the first in a series that will repeat: "Then the President appeared on the screen, a spectacle that would weigh on our spirits every Friday from now on."
-
-The event is simultaneously unique (this specific appearance) and iterative (establishing a pattern). Bal notes a tension: "The more detailed such a report, the less credible its iterative character" — the more specific the case, the harder to believe it happens the same way every time.
-
-## The procedural pilot
-
-This is a precise description of what the pilot of a procedural show does. The first "case of the week" is an iterative anticipation: it's a specific, detailed case, but it also establishes the **formula** that will repeat. The audience understands after the pilot: *this is what happens every week.*
-
-House S01E01 presents a specific patient with a specific mystery. But the audience leaves knowing: each week, a patient will arrive, House will resist, the team will run tests, diagnoses will fail, and House will have a last-minute insight. The pilot is iterative anticipation.
-
-Bal's observation about the tension is relevant: the more vivid and specific the pilot's case, the more the audience engages with *this* case, and the less they register the iterative formula. Good procedural pilots balance both.
-
-## What this means for tvplotlines
-
-Our pass0 concept of "story_engine" is the formula behind the iterative anticipation. The story_engine describes *what repeats*, abstracted from the specific content of any one episode. "An antisocial maverick doctor does whatever it takes to solve puzzling cases" = the iterative pattern that the pilot anticipates.
-
-This doesn't change our pipeline, but gives it a narratological foundation: format detection (pass0) is recognizing whether the pilot contains an iterative anticipation.
-
-## Links
-
-- [[sequential-ordering-separates-fabula-time-from-story-time]]
-- [[three-layer-model-separates-text-story-fabula]]
diff --git a/docs/knowledge/v3_narratology/bal1988/narrative-cycle-has-three-phases-not-seven.md b/docs/knowledge/v3_narratology/bal1988/narrative-cycle-has-three-phases-not-seven.md
deleted file mode 100644
index 05f2e05..0000000
--- a/docs/knowledge/v3_narratology/bal1988/narrative-cycle-has-three-phases-not-seven.md
+++ /dev/null
@@ -1,63 +0,0 @@
-# Narrative cycle has three phases, not seven
-
-Source: Bal 1988, "Narratology", Ch. 3.2 Events (pp. 160-164)
-
-Instead of Freytag's linear arc (setup → inciting_incident → escalation → turning_point → crisis → climax → resolution), Bal presents Bremond's model: the fabula is a grouping of **elementary series**, each with three phases:
-
-1. **Possibility** (virtuality) — a potential action or change
-2. **Realization** — the action happens (or doesn't)
-3. **Result** (conclusion) — success or failure
-
-None of these phases is obligatory. A possibility can remain unrealized. A realization can lack a clear result. This is fundamentally different from Freytag: there's no prescribed shape, no required arc.
-
-## Direction: improvement or deterioration
-
-Each cycle has a direction:
-
-```
-Improvement to be achieved → process of improvement → improvement achieved
-                           → no process            → improvement not achieved
-
-Foreseen deterioration      → process of deterioration → resultant deterioration
-                           → no process               → deterioration avoided
-```
-
-This replaces "escalation" and "turning_point" with something more informative: the **direction** of change. "Escalation" tells you intensity is increasing but not *which way*. Bremond tells you: is this an improvement process or a deterioration process for the subject?
-
-## Embedding
-
-Series nest inside each other. The result of one series becomes the possibility of another. One realization can open a new possibility:
-
-```
-John is tired (possibility: rest)
-  He rests → feels fine (improvement achieved)
-    Feels fine = can work (new possibility)
-      Works → gets tired (deterioration)
-```
-
-Or more dramatically:
-
-```
-John is tired (possibility: sleep)
-  Falls asleep (realization)
-    = possibility: forget exam (embedded deterioration)
-      Forgets → fails exam (deterioration achieved)
-John feels fine again (primary improvement achieved)
-```
-
-The primary series (improvement) and embedded series (deterioration) can have different importance. The embedded one may matter more for the fabula.
-
-## What this means for tvplotlines
-
-Instead of asking "is this event setup, escalation, or climax?", we could ask:
-1. **Direction**: improvement or deterioration (for which actor)?
-2. **Phase**: possibility, realization, or result?
-3. **Is this primary or embedded** in another series?
-
-This gives richer information. "Walt strangles Krazy-8" is: realization of deterioration (elimination/sacrifice), embedded in a primary improvement series (Walt's survival).
-
-## Links
-
-- [[bremond-semantic-labels-type-narrative-processes]]
-- [[events-are-transitions-between-states]]
-- [[initial-situation-is-always-a-state-of-deficiency]]
diff --git a/docs/knowledge/v3_narratology/bal1988/sequential-ordering-separates-fabula-time-from-story-time.md b/docs/knowledge/v3_narratology/bal1988/sequential-ordering-separates-fabula-time-from-story-time.md
deleted file mode 100644
index 428e105..0000000
--- a/docs/knowledge/v3_narratology/bal1988/sequential-ordering-separates-fabula-time-from-story-time.md
+++ /dev/null
@@ -1,40 +0,0 @@
-# Sequential ordering separates fabula-time from story-time
-
-Source: Bal 1988, "Narratology", Ch. 2.3 Sequential Ordering (pp. 67-84)
-
-The order of events in the story can differ from their chronological order in the fabula. These differences — **anachronies** — are not mere stylistic choices but structural devices with specific narrative functions.
-
-## Types of anachrony
-
-**Direction:**
-- **Retroversion** (flashback) — presenting a past event
-- **Anticipation** (flashforward) — presenting a future event
-
-**Distance:** how far from the story's "present" the anachrony reaches.
-
-**Span:** how much fabula-time the anachrony covers (a moment vs. years).
-
-**Relation to primary fabula:**
-- **Internal** — within the time-span of the primary fabula
-- **External** — outside it (backstory, aftermath)
-- **Mixed** — starts outside, ends inside (or vice versa)
-
-## Functions of retroversion
-
-Internal retroversions serve specific structural purposes:
-- **Filling a gap (paralipsis)** — supplying information that was skipped earlier
-- **Repetition with reinterpretation** — the same event presented in a new light, changing its meaning
-- **Providing antecedents** — backstory for a newly introduced character
-
-External retroversions provide **antecedents** — the past of the actors, relevant insofar as it explains their current actions.
-
-## What this means for tvplotlines
-
-Our pipeline works with synopses that are mostly chronological. But TV episodes routinely use flashbacks and flash-forwards. If synopses note these, we could classify them using Bal's categories: is the flashback filling a gap, reinterpreting a past event, or providing antecedents? Each has different structural significance.
-
-More practically: the distinction between internal and external anachrony maps to the difference between "events within the current season's timeline" and "backstory" — which our pipeline currently doesn't formally distinguish.
-
-## Links
-
-- [[three-layer-model-separates-text-story-fabula]]
-- [[iterative-anticipation-describes-procedural-tv-pilots]]
diff --git a/docs/knowledge/v3_narratology/bal1988/suspense-has-four-types-not-one.md b/docs/knowledge/v3_narratology/bal1988/suspense-has-four-types-not-one.md
deleted file mode 100644
index 97f7701..0000000
--- a/docs/knowledge/v3_narratology/bal1988/suspense-has-four-types-not-one.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# Suspense has four types, not one
-
-Source: Bal 1988, "Narratology", Ch. 2.8 Focalization (pp. 148-149)
-
-Bal analyzes suspense through the **asymmetry of knowledge** between reader/viewer and character. When a question is raised ("Who did it? How will it end?"), four situations are possible:
-
-| reader | character | type | mechanism |
-|---|---|---|---|
-| doesn't know | doesn't know | **riddle** | detective story, search — both parties seek the answer |
-| knows | doesn't know | **threat** | the audience sees the bomb, the character doesn't — tension from anticipated collision |
-| doesn't know | knows | **secret** | the character holds information the audience lacks — tension from anticipated revelation |
-| knows | knows | no suspense | — |
-
-## Comparison with current tvplotlines
-
-Our interaction types include "dramatic_irony" — which maps only to **threat** (reader+, character−). But riddle and secret are equally powerful narrative effects:
-
-- **Riddle** drives mystery arcs: who killed Laura Palmer? What is the island? The audience and characters are equally in the dark.
-- **Secret** drives revelation arcs: the old people in Couperus's *Of Old People* know about the murder but the reader doesn't. Information is gradually released through shifting focalization.
-- **Threat** (= our dramatic_irony) drives tension arcs: we know Walt is Heisenberg, Hank doesn't.
-
-## What this means for tvplotlines
-
-Expanding interaction types from one (dramatic_irony) to three (riddle, threat, secret) would capture more narrative mechanics. Each type implies a different audience experience and could predict different structural patterns (mystery arcs tend to have delayed revelations; threat arcs tend to have convergence events).
-
-## Links
-
-- [[three-layer-model-separates-text-story-fabula]]
-- [[truth-value-reveals-apparent-vs-real-roles]]
diff --git a/docs/knowledge/v3_narratology/bal1988/three-criteria-filter-functional-events.md b/docs/knowledge/v3_narratology/bal1988/three-criteria-filter-functional-events.md
deleted file mode 100644
index 5a489f5..0000000
--- a/docs/knowledge/v3_narratology/bal1988/three-criteria-filter-functional-events.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# Three criteria filter functional from non-functional events
-
-Source: Bal 1988, "Narratology", Ch. 3.2 Events (pp. 155-159)
-
-Not every transition is worth analyzing. Bal (following Barthes) introduces three filters to distinguish **functional events** — those that matter for the fabula's structure:
-
-## 1. Change
-
-The event must describe a process, not a condition. Test: can you rewrite the sentence with a verb of change? "John was cleaning his house. John fell ill and therefore had to stop cleaning" — the word "stop" marks the transition.
-
-## 2. Choice
-
-Functional events **open a fork**, realize a choice, or reveal the result of a choice. If Liz leaves for work and walks straight — non-functional (doesn't affect what follows). If she's hit by a car at the crossing — functional, because the rest of the fabula depends on it.
-
-Key test: **if this hadn't happened, would the rest change?** If no — not a functional event.
-
-## 3. Confrontation
-
-Every functional event has the structure: subject – predicate – (direct) object. Both subject and object must be actors (agents of action). Two actors and one process.
-
-"John kills a fly" — not functional if the fly isn't an actor in the fabula. "Liz writes a letter" — seemingly no confrontation, but a letter presupposes an addressee → can be rewritten as "Liz writes to John" → confrontation exists.
-
-Context decides: a murder can be non-functional if it merely illustrates a character trait without affecting the fabula's development (Bal cites Joyce Carol Oates, "The Man That Turned into a Statue").
-
-## What this means for tvplotlines
-
-Current pass2 instruction says "Each sentence should result in at least one event." This is too coarse. A sentence like "The team discusses the case" or "John arrives home" is not necessarily a functional event. Adding the choice test — *does this open a fork or realize one?* — would filter noise from the event list.
-
-## Links
-
-- [[events-are-transitions-between-states]]
-- [[narrative-cycle-has-three-phases-not-seven]]
-- [[confrontation-structure-implies-two-actors-per-event]]
diff --git a/docs/knowledge/v3_narratology/bal1988/three-layer-model-separates-text-story-fabula.md b/docs/knowledge/v3_narratology/bal1988/three-layer-model-separates-text-story-fabula.md
deleted file mode 100644
index e4ce065..0000000
--- a/docs/knowledge/v3_narratology/bal1988/three-layer-model-separates-text-story-fabula.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# Three-layer model separates text, story, and fabula
-
-Source: Bal 1988, "Narratology", Introduction (pp. 5-7)
-
-Bal builds all of narratology on a three-layer distinction:
-
-- **Text** — the concrete artefact: words, shots, frames. The material sign system. Key question: *who narrates?*
-- **Story** — the content of the text, a particular "colouring" of a fabula. How events are ordered, paced, focalized. Key question: *how is the fabula presented?*
-- **Fabula** — a series of logically and chronologically related events caused or experienced by actors. The abstract skeleton. Key question: *what happened?*
-
-These layers don't exist independently. The only material we have is the text; story and fabula are theoretical constructs, reconstructed by the reader. The fabula is "a memory trace that remains after the reading is completed" (p. 9).
-
-The same fabula can be told through different stories (different orderings, focalizations) and realized in different texts (novel, film, comic). "Tom Thumb" is the same fabula whether in Perrault's text or a cartoon film.
-
-## Why this matters for tvplotlines
-
-Our current prompts conflate levels. Story DNA (hero-goal-obstacle-stakes) operates at the fabula level. Seven dramatic functions (setup → resolution) are also fabula. But "interactions" (thematic_rhyme, dramatic_irony) are story-level — they describe how events are organized, not what logically happened. And "format" (procedural/serial) is text-level — how the show delivers its material.
-
-Separating levels explicitly would make our pipeline more precise: pass2 extracts fabula (events + actors + causal relations), pass4 describes story (how those events are ordered across the season arc).
-
-## Links
-
-- [[fabula-is-memory-trace-not-authors-plan]]
-- [[events-are-transitions-between-states]]
-- [[sequential-ordering-separates-fabula-time-from-story-time]]
diff --git a/docs/knowledge/v3_narratology/bal1988/truth-value-reveals-apparent-vs-real-roles.md b/docs/knowledge/v3_narratology/bal1988/truth-value-reveals-apparent-vs-real-roles.md
deleted file mode 100644
index 17036e2..0000000
--- a/docs/knowledge/v3_narratology/bal1988/truth-value-reveals-apparent-vs-real-roles.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# Truth value reveals apparent vs real roles of actants
-
-Source: Bal 1988, "Narratology", Ch. 3.3 Actors (p. 174)
-
-Actants have an **apparent** role and a **real** role, and these can diverge. A traitor appears to be a helper but is actually an opponent. A secret helper appears neutral but acts on the subject's behalf. A false hero appears to be the subject but lacks the competence.
-
-Bal lists categories that emerge from this distinction:
-- **Liars** — misrepresent their role
-- **Master figures** — control from behind the scenes
-- **False heroes** — appear to be subjects but aren't
-- **Invisible fairies** — help without being perceived
-- **Seducers** — manipulate through attraction
-- **Truth-tellers** — reveal what others hide
-- **False clues** — mislead about the fabula's direction
-- **Sudden moments of inspiration** — unexpected knowledge that changes the subject's course
-
-## What this means for tvplotlines
-
-This is directly relevant to TV series with unreliable characters (GoT, Succession, Breaking Bad). Truth value *changes over the course of a season*: a character introduced as helper reveals themselves as opponent (or vice versa). These revelations are structurally significant events — they're not just "turning points" but specifically *truth-value shifts*.
-
-Our pipeline could track this: does a character's actantial role change between episodes? If someone shifts from helper to opponent, that's a structural event that should be flagged.
-
-Currently out of scope but worth noting for future work.
-
-## Links
-
-- [[actant-model-has-six-roles-not-four]]
-- [[anti-subject-signals-a-separate-storyline]]
-- [[suspense-has-four-types-not-one]]
diff --git a/docs/knowledge/v3_narratology/balestri-pescatore-2025-icaart.md b/docs/knowledge/v3_narratology/balestri-pescatore-2025-icaart.md
deleted file mode 100644
index 9ca1cca..0000000
--- a/docs/knowledge/v3_narratology/balestri-pescatore-2025-icaart.md
+++ /dev/null
@@ -1,37 +0,0 @@
----
-type: research
-project: tvplotlines
-status: active
-source: https://arxiv.org/abs/2503.04817
-doi: 10.5220/0013369600003890
-year: 2025
-authors: [Balestri, Pescatore]
-venue: ICAART 2025
----
-
-# Multi-Agent System for AI-Assisted Extraction of Narrative Arcs in TV Series
-
-## Summary
-
-Мульти-агентная система для извлечения нарративных арок из сериалов. Тестировалась на Grey's Anatomy S1. Классифицирует арки как Anthology (самостоятельные), Soap (отношения), Genre-Specific (жанровые). Хранит в реляционной + векторной БД. Графический интерфейс для ручной доработки.
-
-## Key concepts
-
-- **Anthology / Soap / Genre-Specific** — трёхчастная классификация арок (ср. tvplotlines: case_of_the_week / serialized / runner)
-- **Paratexts** — система работает с синопсисами, не с полным текстом (как и tvplotlines)
-- **Multi-agent architecture** — агенты для разных этапов извлечения
-- **Human-in-the-loop** — графический интерфейс для коррекции
-
-## Limitations
-
-Reliance on episode summaries misses overlapping arcs and subtle dynamics. Blends distinct storylines when they share characters.
-
-## Relevance to tvplotlines
-
-Прямой предшественник. tvplotlines переосмыслил их классификацию (A/B/C вместо Anthology/Soap/Genre) и добавил Story DNA, narrative functions, multi-pass verification.
-
-## Connections
-
-- [[balestri-pescatore-2025-memory]] — расширенная версия этой же работы
-- [[liu-2025-narrative-theory-survey]] — обзор, включает эту работу
-- [[keith-2025-interactive-narrative-analytics]] — похожий подход к визуализации
diff --git a/docs/knowledge/v3_narratology/balestri-pescatore-2025-memory.md b/docs/knowledge/v3_narratology/balestri-pescatore-2025-memory.md
deleted file mode 100644
index d4a1be8..0000000
--- a/docs/knowledge/v3_narratology/balestri-pescatore-2025-memory.md
+++ /dev/null
@@ -1,32 +0,0 @@
----
-type: research
-project: tvplotlines
-status: active
-source: https://arxiv.org/abs/2508.07010
-year: 2025
-authors: [Balestri, Pescatore]
-venue: LNAI (forthcoming)
----
-
-# Narrative Memory in Machines: Multi-Agent Arc Extraction in Serialized TV
-
-## Summary
-
-Расширение ICAART-статьи. Вводит архитектуру памяти по аналогии с человеческой: LLM как семантическая память (общие нарративные паттерны), векторная БД как эпизодическая память (конкретные арки), мульти-агентный workflow как рабочая память.
-
-## Key concepts
-
-- **Episodic memory** — хранение конкретных арок и их прогрессий в векторной БД
-- **Semantic memory** — LLM как источник общих нарративных паттернов
-- **Working memory** — мульти-агентный процесс как аналог рабочей памяти
-- **Computational memory architecture** — формализация нарративного понимания через модели памяти
-
-## Relevance to tvplotlines
-
-Самый близкий аналог. Тот же домен (сериалы), те же авторы (Balestri & Pescatore), но другая теоретическая рамка — когнитивная (память), а не сценарная (драматические функции). Интересно как альтернативный фреймворк.
-
-## Connections
-
-- [[balestri-pescatore-2025-icaart]] — исходная версия
-- [[mani-2025-narrative-generative-ai]] — теоретический фундамент computational narratology
-- [[liu-2025-narrative-theory-survey]] — контекст в поле
diff --git a/docs/knowledge/v3_narratology/bibliography-balestri-2025-memory.md b/docs/knowledge/v3_narratology/bibliography-balestri-2025-memory.md
deleted file mode 100644
index 65f370e..0000000
--- a/docs/knowledge/v3_narratology/bibliography-balestri-2025-memory.md
+++ /dev/null
@@ -1,61 +0,0 @@
----
-type: bibliography
-project: tvplotlines
-status: active
-source_paper: "[[balestri-pescatore-2025-memory]]"
-total_references: 45
-retrieved_via: Semantic Scholar API
-retrieved_date: 2026-04-10
----
-
-# Bibliography: Balestri & Pescatore (2025) — Narrative Memory in Machines
-
-Complete bibliography extracted from "Narrative Memory in Machines: Multi-Agent Arc Extraction in Serialized TV" (arXiv:2508.07010).
-
-## References
-
-1. Roberto Balestri, G. Pescatore (2025). "Multi-Agent System for AI-Assisted Extraction of Narrative Arcs in TV Series". ICAART. DOI: 10.5220/0013369600003890 / arXiv: 2503.04817
-2. Yu Wang, Dmitry Krotov, Yuanzhe Hu et al. (2025). "M+: Extending MemoryLLM with Scalable Long-Term Memory". ICML. arXiv: 2502.00592
-3. Weikang Yuan, Junjie Cao, Zhuoren Jiang et al. (2024). "Can Large Language Models Grasp Legal Theories?". EMNLP. arXiv: 2410.02507
-4. Alireza Ghafarollahi, Markus J. Buehler (2024). "SciAgents: Automating scientific discovery through multi-agent intelligent graph reasoning". arXiv. arXiv: 2409.05556
-5. Naoto Aoki, Naoki Mori, M. Okada (2023). "Analysis of LLM-Based Narrative Generation Using the Agent-Based Simulation". IIAI-AAI-Winter. DOI: 10.1109/IIAI-AAI-Winter61682.2023.00059
-6. A. Piper, Olivier Toubia (2023). "A quantitative study of non-linearity in storytelling". Poetics. DOI: 10.1016/j.poetic.2023.101793
-7. M. Rocchi, G. Pescatore (2022). "Modeling narrative features in TV series: coding and clustering analysis". Humanities and Social Sciences Communications. DOI: 10.1057/s41599-022-01352-9
-8. Milán Janosov (2021). "Network Science Predicts Who Dies Next in Game of Thrones". arXiv. arXiv: 2110.09856
-9. Bhartendoo Vimal, Anupama Kumar (2020). "Application of Logistic Regression in Natural Language Processing". IJERT. DOI: 10.17577/ijertv9is060095
-10. Patrick Lewis, Ethan Perez et al. (2020). "Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks". NeurIPS. arXiv: 2005.11401
-11. David Wilmot, Frank Keller (2020). "Modelling Suspense in Short Stories as Uncertainty Reduction over Neural Representation". ACL. arXiv: 2004.14905
-12. A. Piper (2018). "Enumerations: Data and Literary Study". DOI: 10.7208/chicago/9780226568898.001.0001
-13. Andrew Beveridge, Michael M. Chemers (2018). "The Game of Game of Thrones: Networked Concordances and Fractal Dramaturgy". DOI: 10.4324/9781315114668-13
-14. Veronica Innocenti, G. Pescatore (2018). "The Evolution of Characters in TV Series". DOI: 10.4324/9781315114668-7
-15. Veronica Innocenti, G. Pescatore (2017). "Narrative Ecosystems: A Multidisciplinary Approach to Media Worlds". DOI: 10.1515/9789048525317-010
-16. Tom Young, Devamanyu Hazarika, Soujanya Poria, E. Cambria (2017). "Recent Trends in Deep Learning Based NLP". IEEE Computational Intelligence Magazine. arXiv: 1708.02709
-17. Dianbo Liu, Luca Albergante (2017). "Balance of thrones: a network study on 'Game of Thrones'". arXiv. arXiv: 1707.05213
-18. Ashish Vaswani, Noam Shazeer et al. (2017). "Attention is All you Need". NeurIPS. arXiv: 1706.03762
-19. Wenpeng Yin, Katharina Kann, Mo Yu, Hinrich Schütze (2017). "Comparative Study of CNN and RNN for NLP". arXiv. arXiv: 1702.01923
-20. A. J. Reagan, Lewis Mitchell et al. (2016). "The emotional arcs of stories are dominated by six basic shapes". EPJ Data Science. arXiv: 1606.07772
-21. Semi Min, Juyong Park (2016). "Modeling narrative structure and dynamics with networks, sentiment analysis, and topic modeling". PLoS ONE. DOI: 10.1371/journal.pone.0226025
-22. Xavier Bost, Vincent Labatut et al. (2016). "Narrative smoothing: Dynamic conversational network for the analysis of TV series plots". ASONAM. DOI: 10.1109/ASONAM.2016.7752379
-23. Benjamin M. Schmidt (2015). "Plot arceology: A vector-space model of narrative structure". IEEE Big Data. DOI: 10.1109/BigData.2015.7363937
-24. Jason Mittell (2015). "Complex TV: The Poetics of Contemporary Television Storytelling".
-25. Jan Baetens (2014). "Storytelling and the Sciences of Mind". Leonardo. DOI: 10.1162/LEON_r_00881
-26. Jason Mittell, M. Grishakova, Marie-Laure Ryan (2010). "Previously On: Prime Time Serials and the Mechanics of Memory". DOI: 10.1515/9783110237740.78
-27. D. Kellner, Heather Collette-Van Deraa (2008). "Fandom: Identities and Communities in a Mediated World". DOI: 10.1177/009430610803700621
-28. Ingo Steinwart, A. Christmann (2008). "Support vector machines". DOI: 10.1002/wics.49
-29. Jeffrey M. Zacks, N. Speer, K. Swallow et al. (2007). "Event perception: a mind-brain perspective". Psychological Bulletin. DOI: 10.1037/0033-2909.133.2.273
-30. A. Baddeley (2003). "Working memory and language: an overview". Journal of Communication Disorders. DOI: 10.1016/S0021-9924(03)00019-4
-31. D. Schacter (1999). "The seven sins of memory". American Psychologist. DOI: 10.1037/0003-066X.54.3.182
-32. E. Tulving, H. Markowitsch (1998). "Episodic and declarative memory: Role of the hippocampus". Hippocampus. DOI: 10.1002/(SICI)1098-1063(1998)8:3<198::AID-HIPO2>3.0.CO;2-G
-33. L. Squire, S. Zola (1996). "Structure and function of declarative and nondeclarative memory systems". PNAS. DOI: 10.1073/PNAS.93.24.13515
-34. A. Graesser, Murray Singer, T. Trabasso (1994). "Constructing inferences during narrative text comprehension". Psychological Review. DOI: 10.1037/0033-295X.101.3.371
-35. Hugh M. Culbertson (1993). "Textual poachers: Television fans and participatory culture" [review of Jenkins]. DOI: 10.1016/0363-8111(93)90051-D
-36. M. Minsky (1987). "The Society of Mind". DOI: 10.5840/persforum19873112
-37. C. Schank, Roger (1983). "Dynamic Memory: A Theory of Reminding and Learning in Computers and People".
-38. S. Bann, John E. Bowlt (1974). "Russian formalism: a collection of articles and texts in translation". DOI: 10.2307/3724273
-39. T. Todorov, Arnold A. Weinstein (1969). "Structural Analysis of Narrative". DOI: 10.2307/1345003
-40. Alec Radford, Karthik Narasimhan (2018). "Improving Language Understanding by Generative Pre-Training".
-41. Sibelan Forrester (2012). "The Russian Folktale by Vladimir Yakolevich Propp".
-42. G. Genette, J. Lewin, Richard A. Macksey (1997). "Paratexts: Thresholds of Interpretation".
-43. Suphakit Niwattanakul et al. "Using of Jaccard Coefficient for Keywords Similarity".
-44. Paola Dalla, Paolo Fantozzi, Maurizio Naldi, Placido Pellegriti. "Looking for Lexical Signatures in Gomorrah".
-45. (2024). "Understand tokens". Microsoft Learn.
diff --git a/docs/knowledge/v3_narratology/bibliography-balestri-2025.md b/docs/knowledge/v3_narratology/bibliography-balestri-2025.md
deleted file mode 100644
index 37bb3b5..0000000
--- a/docs/knowledge/v3_narratology/bibliography-balestri-2025.md
+++ /dev/null
@@ -1,48 +0,0 @@
----
-type: bibliography
-project: tvplotlines
-status: active
-source_paper: "[[balestri-pescatore-2025-icaart]]"
-total_references: 32
-retrieved_via: Semantic Scholar API
-retrieved_date: 2026-04-10
----
-
-# Bibliography: Balestri & Pescatore (2025) — Multi-Agent System for Narrative Arcs in TV Series
-
-Complete bibliography extracted from "Multi-Agent System for AI-Assisted Extraction of Narrative Arcs in TV Series" (ICAART 2025, arXiv:2503.04817).
-
-## References
-
-1. Renyi Qu, Ruixuan Tu, F. Bao (2024). "Is Semantic Chunking Worth the Computational Cost?". arXiv. arXiv: 2410.13070
-2. Weikang Yuan, Junjie Cao, Zhuoren Jiang et al. (2024). "Can Large Language Models Grasp Legal Theories? Enhance Legal Reasoning with Insights from Multi-Agent Collaboration". EMNLP. arXiv: 2410.02507
-3. Alireza Ghafarollahi, Markus J. Buehler (2024). "SciAgents: Automating scientific discovery through multi-agent intelligent graph reasoning". arXiv. arXiv: 2409.05556
-4. Markus Laukkanen (2024). "Audience-authored paratexts: legitimation of online discourse about Game of Thrones". Frontiers of Narrative Studies. DOI: 10.1515/fns-2024-2003
-5. Naoto Aoki, Naoki Mori, M. Okada (2023). "Analysis of LLM-Based Narrative Generation Using the Agent-Based Simulation". IIAI-AAI-Winter. DOI: 10.1109/IIAI-AAI-Winter61682.2023.00059
-6. Runcong Zhao, Wenjia Zhang, Jiazheng Li et al. (2023). "NarrativePlay: Interactive Narrative Understanding". EACL. arXiv: 2310.01459
-7. A. Piper, Olivier Toubia (2023). "A quantitative study of non-linearity in storytelling". Poetics. DOI: 10.1016/j.poetic.2023.101793
-8. M. Rocchi, G. Pescatore (2022). "Modeling narrative features in TV series: coding and clustering analysis". Humanities and Social Sciences Communications. DOI: 10.1057/s41599-022-01352-9
-9. Milán Janosov (2021). "Network Science Predicts Who Dies Next in Game of Thrones". arXiv. arXiv: 2110.09856
-10. William J. Grange (2020). "The narrative". The Business of American Theatre. DOI: 10.4324/9781003026464-2
-11. Patrick Lewis, Ethan Perez, Aleksandara Piktus et al. (2020). "Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks". NeurIPS. arXiv: 2005.11401
-12. David Wilmot, Frank Keller (2020). "Modelling Suspense in Short Stories as Uncertainty Reduction over Neural Representation". ACL. arXiv: 2004.14905
-13. Tom Young, Devamanyu Hazarika, Soujanya Poria, E. Cambria (2017). "Recent Trends in Deep Learning Based Natural Language Processing". IEEE Computational Intelligence Magazine. arXiv: 1708.02709
-14. Ashish Vaswani, Noam Shazeer, Niki Parmar et al. (2017). "Attention is All you Need". NeurIPS. arXiv: 1706.03762
-15. Wenpeng Yin, Katharina Kann, Mo Yu, Hinrich Schütze (2017). "Comparative Study of CNN and RNN for Natural Language Processing". arXiv. arXiv: 1702.01923
-16. A. J. Reagan, Lewis Mitchell, Dilan Kiley, C. Danforth, P. Dodds (2016). "The emotional arcs of stories are dominated by six basic shapes". EPJ Data Science. arXiv: 1606.07772
-17. Xavier Bost, Vincent Labatut, Serigne Gueye, Georges Linarès (2016). "Narrative smoothing: Dynamic conversational network for the analysis of TV series plots". ASONAM. arXiv: 1602.07811
-18. Benjamin M. Schmidt (2015). "Plot arceology: A vector-space model of narrative structure". IEEE Big Data. DOI: 10.1109/BigData.2015.7363937
-19. Jason Mittell (2015). "Complex TV: The Poetics of Contemporary Television Storytelling".
-20. Ingo Steinwart, A. Christmann (2008). "Support vector machines". Data Mining and Knowledge Discovery Handbook. DOI: 10.1002/wics.49
-21. T. Todorov, Arnold A. Weinstein (1969). "Structural Analysis of Narrative".
-22. (2024). "Understand tokens". Microsoft Learn.
-23. (2023). "Exploring tv seriality and television studies through data-driven approaches". Audiovisual Data: Data-Driven Perspectives for Media Studies.
-24. Andrew Piper, R. So, David Bamman (2021). "Narrative Theory for Computational Narrative Understanding". EMNLP. DOI: 10.18653/v1/2021.emnlp-main.26
-25. (2021). "Multi-plot structure in television serials". Cognition, Emotion, and Aesthetics in Contemporary Serial Television.
-26. (2019). "Postclassical narratology: Twenty years later". Word and Text.
-27. (2019). "Narration in medical dramas i. interpretative hypotheses and research perspectives". La valle dell'eden.
-28. Alec Radford, Karthik Narasimhan (2018). "Improving Language Understanding by Generative Pre-Training".
-29. Sibelan Forrester (2012). "The Russian Folktale by Vladimir Yakolevich Propp".
-30. G. Genette, J. Lewin, Richard A. Macksey (1997). "Paratexts: Thresholds of Interpretation".
-31. L. Dowling (1983). "Semiotics and Language: An Analytical Dictionary".
-32. Suphakit Niwattanakul et al. "Using of Jaccard Coefficient for Keywords Similarity".
diff --git a/docs/knowledge/v3_narratology/bibliography-hamilton-2025.md b/docs/knowledge/v3_narratology/bibliography-hamilton-2025.md
deleted file mode 100644
index 314acfc..0000000
--- a/docs/knowledge/v3_narratology/bibliography-hamilton-2025.md
+++ /dev/null
@@ -1,101 +0,0 @@
----
-type: bibliography
-project: tvplotlines
-status: active
-source_paper: "[[hamilton-2025-narrabench]]"
-total_references: 85
-retrieved_via: Semantic Scholar API
-retrieved_date: 2026-04-11
----
-
-# Bibliography: Hamilton et al. (2025) — NarraBench
-
-Complete bibliography extracted from "NarraBench: A Comprehensive Framework for Narrative Benchmarking" (EACL 2026, arXiv:2510.09869).
-
-## References
-
-1. Matteo Marcuzzo et al. (2025). "MORABLES: A Benchmark for Assessing Abstract Moral Reasoning in LLMs with Fables". EMNLP. arXiv: 2509.12371
-2. Kabir Ahuja, Melanie Sclar, Yulia Tsvetkov (2025). "Finding Flawed Fictions: Evaluating Complex Reasoning via Plot Hole Detection". arXiv. arXiv: 2504.11900
-3. Rebecca M. M. Hicke, Sil Hamilton, David Mimno (2025). "The Zero Body Problem: Probing LLM Use of Sensory Language". arXiv. arXiv: 2504.06393
-4. Victor Wang, Michael J.Q. Zhang, Eunsol Choi (2025). "Improving LLM-as-a-Judge Inference with the Judgment Distribution". EMNLP. arXiv: 2503.03064
-5. Albert Gong et al. (2025). "PhantomWiki: On-Demand Datasets for Reasoning and Retrieval Evaluation". ICML. arXiv: 2502.20377
-6. Xintao Wang et al. (2025). "CoSER: Comprehensive Literary Dataset for LLM Role-Playing". arXiv. arXiv: 2502.09082
-7. Ali Modarressi et al. (2025). "NoLiMa: Long-Context Evaluation Beyond Literal Matching". ICML. arXiv: 2502.05167
-8. Haitao Li et al. (2024). "LLMs-as-Judges: A Comprehensive Survey". arXiv. arXiv: 2412.05579
-9. Sijun Tan et al. (2024). "JudgeBench: A Benchmark for Evaluating LLM-based Judges". ICLR. arXiv: 2410.12784
-10. David Herel et al. (2024). "Time Awareness in LLMs: Benchmarking Fact Recall Across Time". arXiv. arXiv: 2409.13338
-11. Funing Yang, Carolyn J. Anderson (2024). "Evaluating Computational Representations of Character: Austen Benchmark". NLP4DH. arXiv: 2408.16131
-12. Zhao-yu Su et al. (2024). "ConflictBank: Evaluating Knowledge Conflicts in LLM". NeurIPS. arXiv: 2408.12076
-13. John Mendonça et al. (2024). "Soda-Eval: Open-Domain Dialogue Evaluation". EMNLP. arXiv: 2408.10902
-14. Yufei Tian et al. (2024). "Are LLMs Capable of Generating Human-Level Narratives?". EMNLP. arXiv: 2407.13248
-15. Melanie Subbiah et al. (2024). "STORYSUMM: Evaluating Faithfulness in Story Summarization". EMNLP. arXiv: 2407.06501
-16. Marzena Karpinska et al. (2024). "One Thousand and One Pairs: long-context language models". EMNLP. arXiv: 2406.16264
-17. João Monteiro et al. (2024). "RepLiQA: QA for Benchmarking LLMs on Unseen Content". NeurIPS. arXiv: 2406.11811
-18. Bahare Fatemi et al. (2024). "Test of Time: Evaluating LLMs on Temporal Reasoning". ICLR. arXiv: 2406.06565
-19. Jinjie Ni et al. (2024). "MixEval: Deriving Wisdom of the Crowd from LLM Benchmark Mixtures". NeurIPS. arXiv: 2406.06565
-20. Deepa Tilwani et al. (2024). "Attribution in Scientific Literature: New Benchmark". arXiv. arXiv: 2405.02228
-21. Cunxiang Wang et al. (2024). "NovelQA: Benchmarking QA on Documents Exceeding 200K Tokens". ICLR. arXiv: 2403.12766
-22. Xinpeng Wang et al. (2024). "First-Token Probabilities Do Not Match Text Answers". ACL. arXiv: 2402.14499
-23. Nishant Balepur et al. (2024). "Artifacts or Abduction: LLMs Answer MCQ Without the Question". ACL. arXiv: 2402.12483
-24. Hao Wang et al. (2024). "LLMs May Perform MCQA by Selecting the Least Incorrect Option". COLING. arXiv: 2402.01349
-25. Norah A. Alzahrani et al. (2024). "When Benchmarks are Targets: Sensitivity of LLM Leaderboards". ACL. arXiv: 2402.01781
-26. Keming Lu et al. (2024). "LLMs are Superpositions of All Characters: Arbitrary Role-play via Self-Alignment". ACL. arXiv: 2401.12474
-27. Maria Antoniak et al. (2023). "Where Do People Tell Stories Online?". ACL. arXiv: 2311.09675
-28. Jiao Ou et al. (2023). "DialogBench: Evaluating LLMs as Human-like Dialogue Systems". NAACL. arXiv: 2311.01677
-29. Lixing Zhu et al. (2023). "Are NLP Models Good at Tracing Thoughts: Overview of Narrative Understanding". EMNLP. arXiv: 2310.18783
-30. Hyunwoo Kim et al. (2023). "FANToM: Stress-testing Machine Theory of Mind". EMNLP. arXiv: 2310.15421
-31. Yapei Chang et al. (2023). "BooookScore: book-length summarization in era of LLMs". ICLR. arXiv: 2310.00785
-32. Tianyi Zhang et al. (2023). "Human-in-the-loop Schema Induction". ACL. DOI: 10.18653/v1/2023.acl-demo.1
-33. Chao Zhao et al. (2022). "NarraSum: Large-Scale Dataset for Abstractive Narrative Summarization". EMNLP. arXiv: 2212.01476
-34. Xiaozhi Wang et al. (2022). "MAVEN-ERE: Unified Dataset for Event Coreference, Temporal, Causal Relations". EMNLP. arXiv: 2211.07342
-35. Andrei Manolache et al. (2022). "VeriDark: Large-Scale Benchmark for Authorship Verification". NeurIPS. arXiv: 2207.03477
-36. Aarohi Srivastava et al. (2022). "Beyond the Imitation Game (BIG-bench)". arXiv. arXiv: 2206.04615
-37. Jon Chun (2021). "SentimentArcs: Self-Supervised Sentiment Analysis of Time Series". arXiv. arXiv: 2110.09454
-38. Qing Lyu et al. (2021). "Goal-Oriented Script Construction". INLG. DOI: 10.18653/v1/2021.inlg-1.19
-39. Jialong Tang et al. (2021). "From Discourse to Narrative: Knowledge Projection for Event Relation Extraction". ACL. DOI: 10.18653/v1/2021.acl-long.60
-40. Li Lucy, David Bamman (2021). "Gender and Representation Bias in GPT-3 Generated Stories". NUSE.
-41. Dan Hendrycks et al. (2020). "Measuring Massive Multitask Language Understanding (MMLU)". ICLR. arXiv: 2009.03300
-42. A. R. Fabbri et al. (2020). "SummEval: Re-evaluating Summarization Evaluation". TACL. DOI: 10.1162/tacl_a_00373
-43. Swapna Somasundaran et al. (2020). "Emotion Arcs of Student Narratives". NUSE. DOI: 10.18653/v1/2020.nuse-1.12
-44. Anton Belyy, Benjamin Van Durme (2020). "Script Induction as Association Rule Mining". NUSE.
-45. Timothy R. Tangherlini et al. (2020). "Automated pipeline for conspiracy narrative frameworks". PLoS ONE. DOI: 10.1371/journal.pone.0233879
-46. Matthew Sims, David Bamman (2020). "Measuring Information Propagation in Literary Social Networks". EMNLP.
-47. Maria Antoniak et al. (2019). "Narrative Paths and Negotiation of Power in Birth Stories". CSCW. DOI: 10.1145/3359190
-48. Matthew Sims et al. (2019). "Literary Event Detection". ACL. DOI: 10.18653/v1/P19-1353
-49. Rowan Zellers et al. (2019). "HellaSwag: Can a Machine Really Finish Your Sentence?". ACL.
-50. Joseph Worsham, J. Kalita (2018). "Genre Identification and the Compositional Effect of Genre in Literature". COLING.
-51. Tommaso Caselli, P. Vossen (2017). "The Event StoryLine Corpus". NEWS@ACL. DOI: 10.18653/v1/W17-2711
-52. K. Oatley (2016). "Fiction: Simulation of Social Worlds". Trends in Cognitive Sciences. DOI: 10.1016/j.tics.2016.06.002
-53. A. J. Reagan et al. (2016). "The emotional arcs of stories are dominated by six basic shapes". EPJ Data Science.
-54. Marie-Laure Ryan et al. (2016). "Narrating Space / Spatializing Narrative".
-55. Nils Reiter et al. (2014). "An NLP-based cross-document approach to narrative structure discovery". Literary and Linguistic Computing. DOI: 10.1093/llc/fqu055
-56. Niranjan Balasubramanian et al. (2013). "Generating Coherent Event Schemas at Scale". EMNLP.
-57. P. Hogan (2011). "Affective Narratology: The Emotional Structure of Stories".
-58. Nathanael Chambers, Dan Jurafsky (2010). "A Database of Narrative Schemas". LREC.
-59. G. Freytag (2010 reprint). "Freytag's Technique of the Drama".
-60. Nathanael Chambers, Dan Jurafsky (2009). "Unsupervised Learning of Narrative Schemas and their Participants". ACL.
-61. Nathanael Chambers, Dan Jurafsky (2008). "Unsupervised Learning of Narrative Event Chains". ACL.
-62. Chin-Yew Lin (2004). "ROUGE: A Package for Automatic Evaluation of Summaries". ACL.
-63. D. McAdams et al. (2001). "Sequences of Redemption and Contamination in Life Narrative". DOI: 10.1177/0146167201274008
-64. Collin F. Baker et al. (1998). "The Berkeley FrameNet Project". ACL.
-65. G. Genette (1997). "Palimpsests: Literature in the Second Degree".
-66. Meir Sternberg (1992). "Telling in Time (II): Chronology, Teleology, Narrativity". DOI: 10.2307/1772872
-67. J. Bruner (1991). "The Narrative Construction of Reality". Critical Inquiry.
-68. Paul Ricoeur (1988). "Time and Narrative, Volume 1". DOI: 10.7208/chicago/9780226713533.001.0001
-69. Lane Gormley / Julia Kristeva (1984). "Desire in Language: A Semiotic Approach to Literature and Art".
-70. W. Brewer, Edward H. Lichtenstein (1982). "Stories Are to Entertain: A Structural-Affect Theory of Stories".
-71. Kai He et al. (2025). "Crab: A Novel Configurable Role-Playing LLM with Assessing Benchmark". ACL.
-72. Andrew Piper, Sunyam Bagga (2025). "NarraDetect: annotated dataset for narrative detection". WNU.
-73. Axel Pichler et al. (2025). "Evaluating LLM-Prompting for Sequence Labeling in Computational Literary Studies". LaTeCH-CLfL.
-74. Svenja Kenneweg et al. (2024). "Benchmarking LLMs to Reason About Event Sets". KEOD.
-75. Zhilin Wang et al. (2022). "Uncovering Surprising Event Boundaries in Narratives". WNU.
-76. Andrew Piper, R. So, David Bamman (2021). "Narrative Theory for Computational Narrative Understanding". EMNLP.
-77. Melissa Roemmele (2019). "Identifying Sensible Lexical Relations in Generated Stories". WNU.
-78. A. Baer / G. Genette (2016 reprint). "Narrative Discourse: An Essay in Method".
-79. R. Mar (2011). "The neural bases of social cognition and story comprehension". Annual Review of Psychology.
-80. J. Alber, M. Fludernik (2010). "Postclassical Narratology: Approaches and Analyses".
-81. D. Herman (2009). "Basic elements of narrative".
-82. W. Labov, J. Waletzky (1997). "Narrative analysis: Oral versions of personal experience".
-83. E. Kahn (1973). "Finite-state models of plot complexity". Poetics.
-84. Lee T. Lemon, Marion J. Reis (1968). "Russian formalist criticism: four essays".
-85. Katherine Elkins (2022). "The Shapes of Stories". Cambridge University Press.
diff --git a/docs/knowledge/v3_narratology/bibliography-keith-2025.md b/docs/knowledge/v3_narratology/bibliography-keith-2025.md
deleted file mode 100644
index 0799467..0000000
--- a/docs/knowledge/v3_narratology/bibliography-keith-2025.md
+++ /dev/null
@@ -1,117 +0,0 @@
----
-type: bibliography
-project: tvplotlines
-status: active
-source_paper: "[[keith-2025-interactive-narrative-analytics]]"
-total_references: 99
-retrieved_via: Semantic Scholar API
-retrieved_date: 2026-04-10
----
-
-# Bibliography: Keith (2025) — Interactive Narrative Analytics
-
-Complete bibliography extracted from "Interactive Narrative Analytics: Bridging Computational Narrative Extraction and Human Sensemaking" (IEEE Access, arXiv:2601.11459).
-
-**Note:** Эта библиография сильно отличается от остальных seed-статей. Фокус не на нарратологии, а на visual analytics + misinformation + sensemaking. Нарратологических ссылок минимум. Основной кластер — information visualization, fact-checking, human-AI interaction.
-
-## References
-
-1. Arghodeep Nandi et al. (2025). "The Psychology of Falsehood: A Human-Centric Survey of Misinformation Detection". EMNLP. arXiv: 2509.15896
-2. Brian Felipe Keith-Norambuena et al. (2025). "Explainable AI Components for Narrative Map Extraction". Text2Story@ECIR. arXiv: 2503.16554
-3. Simona Frenda et al. (2024). "Perspectivist approaches to natural language processing: a survey". Language Resources and Evaluation. DOI: 10.1007/s10579-024-09766-4
-4. Gabriela Molina León et al. (2024). "Talk to the Wall: The Role of Speech Interaction in Collaborative Visual Analytics". IEEE TVCG. arXiv: 2408.03813
-5. Jie Fu et al. (2024). "Differentially Private Federated Learning: A Systematic Review". arXiv. arXiv: 2405.08299
-6. Michelle Vaccaro et al. (2024). "When combinations of humans and AI are useful: A systematic review and meta-analysis". Nature Human Behaviour. DOI: 10.1038/s41562-024-02024-1
-7. Yuheng Zhao et al. (2024). "LEVA: Using Large Language Models to Enhance Visual Analytics". IEEE TVCG. arXiv: 2403.05816
-8. M. T. Fischer et al. (2024). "MULTI-CASE: A Transformer-based Ethics-aware Multimodal Investigative Intelligence Framework". arXiv. arXiv: 2401.01955
-9. Alex Ulmer et al. (2023). "A Survey on Progressive Visualization". IEEE TVCG. DOI: 10.1109/TVCG.2023.3346641
-10. Yuxiang Zhou, Yulan He (2023). "Causal Inference from Text: Unveiling Interactions between Variables". EMNLP. arXiv: 2311.05286
-11. Huimin Han et al. (2023). "Explainable interactive projections of images". Machine Vision and Applications. DOI: 10.1007/s00138-023-01452-9
-12. Isabel O. Gallegos et al. (2023). "Bias and Fairness in Large Language Models: A Survey". Computational Linguistics. arXiv: 2309.00770
-13. Yu-Chu Chang et al. (2023). "A Survey on Evaluation of Large Language Models". ACM TIST. arXiv: 2307.03109
-14. Lianwei Wu et al. (2023). "MFIR: Multimodal fusion and inconsistency reasoning for explainable fake news detection". Information Fusion. DOI: 10.1016/j.inffus.2023.101944
-15. Lin F. Yang et al. (2023). "Give us the Facts: Enhancing LLMs With Knowledge Graphs". IEEE TKDE. arXiv: 2306.11489
-16. Tim Dettmers et al. (2023). "QLoRA: Efficient Finetuning of Quantized LLMs". NeurIPS. arXiv: 2305.14314
-17. M. Schlichtkrull et al. (2023). "AVeriTeC: A Dataset for Real-world Claim Verification". NeurIPS. arXiv: 2305.13117
-18. Eve Fleisig et al. (2023). "When the Majority is Wrong: Modeling Annotator Disagreement for Subjective Tasks". EMNLP. arXiv: 2305.06626
-19. Elisa Leonardelli et al. (2023). "SemEval-2023 Task 11: Learning with Disagreements". SemEval. arXiv: 2304.14803
-20. Zhihua Yan, Xijin J. Tang (2023). "Narrative Graph: Telling Evolving Stories Based on Event-centric Temporal Knowledge Graph". J. Systems Science. DOI: 10.1007/s11518-023-5561-0
-21. Brian Felipe Keith-Norambuena et al. (2023). "A Survey on Event-Based News Narrative Extraction". ACM Computing Surveys. arXiv: 2302.08351
-22. Brian Felipe Keith-Norambuena et al. (2023). "Mixed Multi-Model Semantic Interaction for Graph-based Narrative Visualizations". IUI. arXiv: 2302.06452
-23. Esma Aïmeur et al. (2023). "Fake news, disinformation and misinformation in social media: a review". Social Network Analysis and Mining. DOI: 10.1007/s13278-023-01028-5
-24. Brenda Salenave Santana et al. (2023). "A survey on narrative extraction from textual data". AI Review. DOI: 10.1007/s10462-022-10338-7
-25. Zeming Chen et al. (2022). "DISCO: Distilling Counterfactuals with Large Language Models". ACL. arXiv: 2212.10534
-26. K. Liang et al. (2022). "A Survey of Knowledge Graph Reasoning on Graph Types". IEEE TPAMI. arXiv: 2212.05767
-27. Oberiri Destiny Apuke et al. (2022). "Information overload and misinformation sharing behaviour". J. Information Science. DOI: 10.1177/01655515221121942
-28. Qing Chen et al. (2022). "How Does Automation Shape the Process of Narrative Visualization: A Survey of Tools". IEEE TVCG. arXiv: 2206.12118
-29. Shivani Choudhary et al. (2022). "Interpretation of Black Box NLP Models: A Survey". arXiv. arXiv: 2203.17081
-30. M. T. Fischer et al. (2022). "Promoting Ethical Awareness in Communication Analysis". FAccT. arXiv: 2203.09859
-31. Paul Röttger et al. (2021). "Two Contrasting Data Annotation Paradigms for Subjective NLP Tasks". NAACL Findings. arXiv: 2112.01640
-32. C. Trojahn et al. (2021). "Foundational ontologies meet ontology matching: A survey". Semantic Web. DOI: 10.3233/sw-210447
-33. Zhijing Jin et al. (2021). "Causal Direction of Data Collection Matters". EMNLP. arXiv: 2110.03618
-34. John E. Wenskovitch et al. (2021). "Beyond Visual Analytics: Human-Machine Teaming for AI-Driven Data Sensemaking". IEEE TREX. DOI: 10.1109/TREX53765.2021.00012
-35. Leixian Shen et al. (2021). "Towards Natural Language Interfaces for Data Visualization: A Survey". IEEE TVCG. arXiv: 2109.03506
-36. Mark Wallinger et al. (2021). "Edge-Path Bundling". IEEE TVCG. arXiv: 2108.05467
-37. J. Hu et al. (2021). "LoRA: Low-Rank Adaptation of Large Language Models". ICLR. arXiv: 2106.09685
-38. Tommaso Fornaciari et al. (2021). "Beyond Black & White: Leveraging Annotator Disagreement via Soft-Label Multi-Task Learning". NAACL. DOI: 10.18653/V1/2021.NAACL-MAIN.204
-39. Brian Lester et al. (2021). "The Power of Scale for Parameter-Efficient Prompt Tuning". EMNLP. arXiv: 2104.08691
-40. Yail Bian, Chris North (2021). "DeepSI: Interactive Deep Learning for Semantic Interaction". IUI. arXiv: 2305.18357
-41. Batya Friedman et al. (2021). "Eight grand challenges for value sensitive design". Ethics and Information Technology. DOI: 10.1007/s10676-021-09586-y
-42. Tongshuang Sherry Wu et al. (2021). "Polyjuice: Generating Counterfactuals for Explaining, Evaluating, and Improving Models". ACL. arXiv: 2101.00288
-43. Hila Chefer et al. (2020). "Transformer Interpretability Beyond Attention Visualization". CVPR. arXiv: 2012.09838
-44. S. Soroya et al. (2020). "From information seeking to information avoidance". Information Processing & Management. DOI: 10.1016/j.ipm.2020.102440
-45. E. Cakmak et al. (2020). "Multiscale Snapshots: Visual Analysis of Temporal Summaries in Dynamic Graphs". IEEE TVCG. arXiv: 2008.08282
-46. John E. Wenskovitch, Chris North (2020). "Interactive Artificial Intelligence: Designing for the 'Two Black Boxes' Problem". Computer. DOI: 10.1109/MC.2020.2996416
-47. Weikai Yang et al. (2020). "Interactive Steering of Hierarchical Clustering". IEEE TVCG. arXiv: 2009.09618
-48. A. Vivacqua et al. (2019). "Explanations and sensemaking with AI and HCI". IX Latin American Conference on HCI. DOI: 10.1145/3358961.3359004
-49. Michelle Dowling et al. (2019). "Interactive Visual Analytics for Sensemaking with Big Text". Big Data Research. DOI: 10.1016/J.BDR.2019.04.003
-50. Chang Sup Park (2019). "Does Too Much News on Social Media Discourage News Seeking?". Social Media + Society. DOI: 10.1177/2056305119872956
-51. J. Ansah et al. (2019). "A Graph is Worth a Thousand Words: Telling Event Stories using Timeline Summarization Graphs". WWW. DOI: 10.1145/3308558.3313396
-52. Margaret Mitchell et al. (2018). "Model Cards for Model Reporting". FAccT. DOI: 10.1145/3287560.3287596
-53. Peter Gordon Roetzel (2018). "Information overload in the information age: a review". Business Research. DOI: 10.1007/S40685-018-0069-Z
-54. M. Angelini et al. (2018). "A Review and Characterization of Progressive Visual Analytics". Informatics. DOI: 10.3390/informatics5030031
-55. L. Bietti et al. (2018). "Storytelling as Adaptive Collective Sensemaking". Topics in Cognitive Science. DOI: 10.1111/tops.12358
-56. Emanuel Zgraggen et al. (2018). "Investigating the Effect of the Multiple Comparisons Problem in Visual Analysis". CHI. DOI: 10.1145/3173574.3174053
-57. Timnit Gebru et al. (2018). "Datasheets for datasets". Communications of the ACM. DOI: 10.1145/3458723
-58. James Thorne et al. (2018). "FEVER: a Large-scale Dataset for Fact Extraction and VERification". NAACL. DOI: 10.18653/v1/N18-1074
-59. D. Lazer et al. (2018). "The science of fake news". Science. DOI: 10.1126/science.aao2998
-60. S. Vosoughi et al. (2018). "The spread of true and false news online". Science. DOI: 10.1126/science.aap9559
-61. Bang Liu et al. (2017). "Growing Story Forest Online from Massive Breaking News". CIKM. DOI: 10.1145/3132847.3132852
-62. Manu Shukla et al. (2017). "DISCRN: A Distributed Storytelling Framework for Intelligence Analysis". Big Data. DOI: 10.1089/big.2017.0025
-63. Antoine Lhuillier et al. (2017). "State of the Art in Edge and Trail Bundling Techniques". Computer Graphics Forum. DOI: 10.1111/cgf.13213
-64. Jean-Daniel Fekete, Romain Primet (2016). "Progressive Analytics: A Computation Paradigm for Exploratory Data Analysis". arXiv. arXiv: 1607.05162
-65. Marco Tulio Ribeiro et al. (2016). "Why Should I Trust You?: Explaining the Predictions of Any Classifier (LIME)". NAACL. DOI: 10.1145/2939672.2939778
-66. Amir Gandomi, Murtaza Haider (2015). "Beyond the hype: Big data concepts, methods, and analytics". IJIM. DOI: 10.1016/J.IJINFOMGT.2014.10.007
-67. Charles D. Stolper et al. (2014). "Progressive Visual Analytics: User-Driven Visual Exploration". IEEE TVCG. DOI: 10.1109/TVCG.2014.2346574
-68. Dafna Shahaf et al. (2013). "Information cartography: creating zoomable, large-scale maps of information". KDD. DOI: 10.1145/2487575.2487690
-69. S. Lewis et al. (2013). "Content Analysis in an Era of Big Data: A Hybrid Approach". DOI: 10.1080/08838151.2012.761702
-70. A. Endert et al. (2012). "Semantic interaction for visual text analytics". CHI. DOI: 10.1145/2207676.2207741
-71. A. Endert et al. (2011). "Observation-level interaction with statistical models for visual analytics". IEEE VAST. DOI: 10.1109/VAST.2011.6102449
-72. Milos Krstajic et al. (2011). "CloudLines: Compact Display of Event Episodes in Multiple Time-Series". IEEE TVCG. DOI: 10.1109/TVCG.2011.179
-73. Sarah Cohen et al. (2011). "Computational journalism". Communications of the ACM. DOI: 10.1145/2001269.2001288
-74. Rui Yan et al. (2011). "Evolutionary timeline summarization". SIGIR. DOI: 10.1145/2009916.2010016
-75. Y. Lerner et al. (2011). "Topographic Mapping of a Hierarchy of Temporal Receptive Windows Using a Narrated Story". J. Neuroscience. DOI: 10.1523/JNEUROSCI.3684-10.2011
-76. E. Segel, Jeffrey Heer (2010). "Narrative Visualization: Telling Stories with Data". IEEE TVCG. DOI: 10.1109/TVCG.2010.179
-77. Christopher Andrews et al. (2010). "Space to think: large high-resolution displays for sensemaking". CHI. DOI: 10.1145/1753326.1753336
-78. W. Pike et al. (2009). "The Science of Interaction". Information Visualization. DOI: 10.1057/ivs.2009.22
-79. D. Fair et al. (2007). "Development of distinct control networks through segregation and integration". PNAS. DOI: 10.1073/pnas.0705843104
-80. H. Slagter et al. (2007). "Mental Training Affects Distribution of Limited Brain Resources". PLoS Biology. DOI: 10.1371/journal.pbio.0050138
-81. G. Repovš, A. Baddeley (2006). "The multi-component model of working memory". Neuroscience. DOI: 10.1016/J.NEUROSCIENCE.2005.12.061
-82. Hai Leong Chieu, Yoong Keok Lee (2004). "Query based event extraction along a timeline". SIGIR. DOI: 10.1145/1008992.1009065
-83. Martin J. Eppler, J. Mengis (2004). "The Concept of Information Overload". The Information Society. DOI: 10.1080/01972240490507974
-84. T. Davenport, John C. Beck (2001). "The Attention economy". UBIQ. DOI: 10.1145/376625.376626
-85. Rolf A. Zwaan, G. Radvansky (1998). "Situation models in language comprehension and memory". Psychological Bulletin. DOI: 10.1037/0033-2909.123.2.162
-86. W. Kintsch (1998). "Comprehension: A Paradigm for Cognition".
-87. B. Shneiderman (1996). "The eyes have it: a task by data type taxonomy for information visualizations". IEEE VL. DOI: 10.1109/VL.1996.545307
-88. P. Pirolli, S. Card (1995). "Information foraging in information access environments". CHI. DOI: 10.1145/223904.223911
-89. M. Ford, P. Johnson-Laird (1985). "Mental Models: Towards a Cognitive Science of Language, Inference, and Consciousness". DOI: 10.2307/414498
-90. J. Bruner (1985). "Actual minds, possible worlds". DOI: 10.2307/2905728
-91. Witold Sosnowski et al. (2025). "DiNaM: Disinformation Narrative Mining with Large Language Models". EMNLP. DOI: 10.18653/v1/2025.emnlp-main.1537
-92. Alessia Cosentino et al. (2025). "Source Credibility Assessment in the Realm of Information Disorder". IJIMAI. DOI: 10.9781/ijimai.2025.01.002
-93. Zhengyuan Zhu et al. (2025). "RATSD: Retrieval Augmented Truthfulness Stance Detection". NAACL Findings. DOI: 10.18653/v1/2025.findings-naacl.187
-94. Achyutarama R. Ganti et al. (2023). "Narrative Style and the Spread of Health Misinformation on Twitter". EMNLP Findings. DOI: 10.18653/v1/2023.findings-emnlp.282
-95. R. Porzel et al. (2022). "Narrativizing Knowledge Graphs". AI4LEGAL/KGSum@ISWC.
-96. P. Ranade et al. (2022). "Computational Understanding of Narratives: A Survey". IEEE Access. DOI: 10.1109/ACCESS.2022.3205314
-97. Inès Blin (2022). "Building Narrative Structures from Knowledge Graphs". ESWC. DOI: 10.1007/978-3-031-11609-4_38
-98. E. Mosca et al. (2022). "SHAP-Based Explanation Methods: A Review for NLP Interpretability". COLING.
-99. Xiang Lisa Li, Percy Liang (2021). "Prefix-Tuning: Optimizing Continuous Prompts for Generation". ACL. arXiv: 2104.08691
diff --git a/docs/knowledge/v3_narratology/bibliography-liu-2025.md b/docs/knowledge/v3_narratology/bibliography-liu-2025.md
deleted file mode 100644
index 5431d75..0000000
--- a/docs/knowledge/v3_narratology/bibliography-liu-2025.md
+++ /dev/null
@@ -1,146 +0,0 @@
----
-type: bibliography
-project: tvplotlines
-status: active
-source_paper: "[[liu-2025-narrative-theory-survey]]"
-total_references: 146
-retrieved_via: Semantic Scholar API
-retrieved_date: 2026-04-10
----
-
-# Bibliography: Liu et al. (2025) — Narrative Theory-Driven LLM Methods Survey
-
-Complete bibliography extracted from "Narrative Theory-Driven LLM Methods for Automatic Story Generation and Understanding: A Survey" (arXiv:2602.15851).
-
-## References
-
-1. Dingyi Yang, Qin Jin (2025). "What Matters in Evaluating Book-Length Stories? A Systematic Study of Long Story Evaluation". Annual Meeting of the Association for Computational Linguistics. DOI: 10.18653/v1/2025.acl-long.799
-2. Minju Kim, Dongje Yoo, Yeonjun Hwang, Minseok Kang, Namyoung Kim, Minju Gwak, Beong-woo Kwak, Hyungjoo Chae, Harim Kim, Yunjoong Lee, M. Kim, Dayi Jung, Kyong-Mee Chung, Jinyoung Yeo (2025). "Can You Share Your Story? Modeling Clients' Metacognition and Openness for LLM Therapist Evaluation". ACL Findings. DOI: 10.18653/v1/2025.findings-acl.1332
-3. Karin de Langis, Jong Inn Park, Andreas Schramm, Bin Hu, Khanh Chi Le, Dongyeop Kang (2025). "How LLMs Comprehend Temporal Meaning in Narratives: A Case Study in Cognitive Evaluation of LLMs". ACL. DOI: 10.18653/v1/2025.acl-long.1415
-4. Anneliese Brei, Katharine Henry, Abhisheik Sharma, Shashank Srivastava, Snigdha Chaturvedi (2025). "Classifying Unreliable Narrators with Large Language Models". ACL. arXiv: 2506.10231
-5. Jiaming Li, Yukun Chen, Ziqiang Liu, Minghuan Tan, Lei Zhang, Yunshui Li, Run Luo, Longze Chen, Jing Luo, A. Argha, H. Alinejad-Rokny, Wei Zhou, Min Yang (2025). "STORYTELLER: An Enhanced Plot-Planning Framework for Coherent and Cohesive Story Generation". ACL. arXiv: 2506.02347
-6. Yulia Otmakhova, Lea Frermann (2025). "Narrative Media Framing in Political Discourse". ACL. arXiv: 2506.00737
-7. Parsa Ghaffari, Chris Hokamp (2025). "Narrative Studio: Visual narrative exploration using LLMs and Monte Carlo Tree Search". WNU 2025. arXiv: 2504.02426
-8. Sil Hamilton, Rebecca M. M. Hicke, David Mimno, Matthew Wilkens (2025). "A City of Millions: Mapping Literary Social Networks At Scale". NLP4DH 2025. arXiv: 2502.19590
-9. Sneheel Sarangi, Maha Elgarf, Hanan Salam (2025). "Decompose-ToM: Enhancing Theory of Mind Reasoning in Large Language Models through Simulation and Task Decomposition". COLING. arXiv: 2501.09056
-10. Chulun Zhou, Qiujing Wang, Mo Yu, X. Yue, Rui Lu, Jiangnan Li, Yifan Zhou, Shunchi Zhang, Jie Zhou, Wai Lam (2025). "The Essence of Contextual Understanding in Theory of Mind: A Study on Question Answering with Story Characters". ACL. arXiv: 2501.01705
-11. V. Lenzi, Emanuele Lenzi, Claudio De Martino (2024). "Using large language models to create narrative events". PeerJ Computer Science. DOI: 10.7717/peerj-cs.2242
-12. Mourad Heddaya, Qingcheng Zeng, Chenhao Tan, Rob Voigt, Alexander K. Zentefis (2024). "Causal Micro-Narratives". WNU 2024. arXiv: 2410.05252
-13. Rohan Das, Aditya Chandra, Isabelle Lee, Maria Leonor Pacheco (2024). "Media Framing through the Lens of Event-Centric Narratives". WNU 2024. arXiv: 2410.03151
-14. Fantine Huot, Reinald Kim Amplayo, J. Palomaki, Alice Shoshana Jakobovits, Elizabeth Clark, Mirella Lapata (2024). "Agents' Room: Narrative Generation through Multi-step Collaboration". ICLR. arXiv: 2410.02603
-15. Minwook Bae, Hyounghun Kim (2024). "Collective Critics for Creative Story Generation". EMNLP. arXiv: 2410.02428
-16. Funing Yang, Carolyn J. Anderson (2024). "Evaluating Computational Representations of Character: An Austen Character Similarity Benchmark". NLP4DH. arXiv: 2408.16131
-17. Pranjal Kumar (2024). "Large language models (LLMs): survey, technical frameworks, and future challenges". Artificial Intelligence Review. DOI: 10.1007/s10462-024-10888-y
-18. Yufei Tian, Tenghao Huang, Miri Liu, Derek Jiang, Alexander Spangher, Muhao Chen, Jonathan May, Nanyun Peng (2024). "Are Large Language Models Capable of Generating Human-Level Narratives?". EMNLP. arXiv: 2407.13248
-19. Brett A. Halperin, Stephanie M Lukin (2024). "Artificial Dreams: Surreal Visual Storytelling as Inquiry Into AI 'Hallucination'". DIS. DOI: 10.1145/3643834.3660685
-20. Fabrice Harel-Canada, Hanyu Zhou, Sreya Muppalla, Zeynep Yildiz, Amit Sahai, Nanyun Peng (2024). "Measuring Psychological Depth in Language Models". EMNLP. arXiv: 2406.12680
-21. Peiqi Sui, Eamon Duede, Sophie Wu, R. So (2024). "Confabulation: The Surprising Value of Large Language Model Hallucinations". ACL. arXiv: 2406.04175
-22. Jocelyn Jiayue Shen, Joel Mire, Hae Won Park, C. Breazeal, Maarten Sap (2024). "HEART-felt Narratives: Tracing Empathy and Narrative Style in Personal Stories with LLMs". EMNLP. arXiv: 2405.17633
-23. Jocelyn Jiayue Shen, Y. Kim, Mohit Hulse, W. Zulfikar, Sharifa Alghowinem, C. Breazeal, Hae Won Park (2024). "EmpathicStories++: A Multimodal Dataset for Empathy towards Personal Experiences". ACL. arXiv: 2405.15708
-24. Cyril Chhun, Fabian M. Suchanek, Chloé Clavel (2024). "Do Language Models Enjoy Their Own Stories? Prompting Large Language Models for Automatic Story Evaluation". TACL. arXiv: 2405.13769
-25. Yuetian Chen, Mei Si (2024). "Reflections & Resonance: Two-Agent Partnership for Advancing LLM-based Story Annotation". LREC. DOI: 10.63317/26pt7cbt22fh
-26. Hans Ole Hatzel, Christian Biemann (2024). "Tell Me Again! a Large-Scale Dataset of Multiple Summaries for the Same Story". LREC. DOI: 10.63317/45vg69yzwt9e
-27. P. Gervás (2024). "Storytelling systems: Progress towards generation informed by models of the reader". Interdisciplinary Science Reviews. DOI: 10.1177/03080188241262862
-28. Hang Jiang, Xiajie Zhang, Robert Mahari, Daniel T Kessler, E. Ma, Tal August, Irene Li, A. Pentland, Yoon Kim, Jad Kabbara, Deb Roy (2024). "Leveraging Large Language Models for Learning Complex Legal Concepts through Storytelling". ACL. arXiv: 2402.17019
-29. Sil Hamilton (2024). "Detecting Mode Collapse in Language Models via Narration". SCALELLM. arXiv: 2402.04477
-30. Yidan Sun, Qin Chao, Boyang Albert Li (2023). "Event Causality Is Key to Computational Story Understanding". NAACL. arXiv: 2311.09648
-31. Maria Antoniak, Joel Mire, Maarten Sap, Elliott Ash, Andrew Piper (2023). "Where Do People Tell Stories Online? Story Detection Across Online Communities". ACL. arXiv: 2311.09675
-32. Nina Beguš (2023). "Experimental narratives: A comparison of human crowdsourced storytelling and AI storytelling". Humanities and Social Sciences Communications. DOI: 10.1057/s41599-024-03868-8
-33. Tuhin Chakrabarty, Philippe Laban, Divyansh Agarwal, S. Muresan, Chien-Sheng Wu (2023). "Art or Artifice? Large Language Models and the False Promise of Creativity". CHI. DOI: 10.1145/3613904.3642731
-34. Tarek Naous, Michael Joseph Ryan, Wei Xu (2023). "Having Beer after Prayer? Measuring Cultural Bias in Large Language Models". ACL. arXiv: 2305.14456
-35. Jocelyn Jiayue Shen, Maarten Sap, Pedro Colon-Hernandez, Hae Won Park, C. Breazeal (2023). "Modeling Empathic Similarity in Personal Narratives". EMNLP. arXiv: 2305.14246
-36. Xiaoxuan Fang, D. Ng, J. Leung, S. Chu (2023). "A systematic review of artificial intelligence technologies used for story writing". Education and Information Technologies. DOI: 10.1007/s10639-023-11741-5
-37. Zhuohan Xie, Trevor Cohn, Jey Han Lau (2023). "The Next Chapter: A Study of Large Language Models in Storytelling". INLG. arXiv: 2301.09790
-38. Michael Levin, Manoj Kumar, K. Norman, Mariya Toneva (2023). "Large language models can segment narrative events similarly to humans". arXiv. arXiv: 2301.10297
-39. Brenda Salenave Santana, Ricardo Campos, Evelin Amorim, A. Jorge, Purificação Silvano, Sérgio Nunes (2023). "A survey on narrative extraction from textual data". Artificial Intelligence Review. DOI: 10.1007/s10462-022-10338-7
-40. Yuxin Wang, Jieru Lin, Zhiwei Yu, Wei Hu, Börje F. Karlsson (2022). "Open-world Story Generation with Structured Knowledge Enhancement: A Comprehensive Survey". Neurocomputing. arXiv: 2212.04634
-41. Ivan P. Yamshchikov, Alexey Tikhonov (2022). "What is Wrong with Language Models that Can Not Tell a Story?". WNU. arXiv: 2211.05044
-42. Charles Condevaux, S. Harispe (2022). "LSG Attention: Extrapolation of pretrained Transformers to long sequences". PAKDD. arXiv: 2210.15497
-43. Andrew Piper, Sunyam Bagga (2022). "Toward a Data-Driven Theory of Narrativity". New Literary History. DOI: 10.1353/nlh.2022.a898332
-44. Cyril Chhun, Pierre Colombo, C. Clavel, Fabian M. Suchanek (2022). "Of Human Criteria and Automatic Metrics: A Benchmark of the Evaluation of Story Generation". COLING. arXiv: 2208.11646
-45. Katherine Elkins (2022). "The Shapes of Stories". DOI: 10.1017/9781009270403
-46. Ying Xu, Dakuo Wang, Mo Yu, Daniel Ritchie, Bingsheng Yao, Tongshuang Sherry Wu, Zheng Zhang, Toby Jia-Jun Li, Nora Bradford, Branda Sun, Tran Bao Hoang, Yisi Sang, Yufang Hou, Xiaojuan Ma, Diyi Yang, Nanyun Peng, Zhou Yu, M. Warschauer (2022). "Fantastic Questions and Where to Find Them: FairytaleQA — An Authentic Dataset for Narrative Comprehension". ACL. arXiv: 2203.13947
-47. Roberto Romani (2021). "Narrative economics: how stories go viral and drive major economic events". European Journal of the History of Economic Thought. DOI: 10.1080/09672567.2021.1928927
-48. Amal Alabdulkarim, Siyan Li, Xiangyu Peng (2021). "Automatic Story Generation: Challenges and Attempts". NUSE. arXiv: 2102.12634
-49. Zhilin Wang, Weizhe Lin, Xiaodong Wu (2020). "Learning Similarity between Movie Characters and Its Potential Implications on Understanding Human Experiences". NUSE. arXiv: 2010.12183
-50. Michael Levin (2020). "Cognitive". Definitions. DOI: 10.1007/978-3-642-28753-4_200398
-51. V. Shklovski (2019). "Art as Technique". From Symbolism to Socialist Realism. DOI: 10.1515/9781618111449-008
-52. Atef Chaudhury, Makarand Tapaswi, Seung Wook Kim, S. Fidler (2019). "The Shmoop Corpus: A Dataset of Stories with Loosely Aligned Summaries". arXiv. arXiv: 1912.13082
-53. Lianhui Qin, Antoine Bosselut, Ari Holtzman, Chandra Bhagavatula, Elizabeth Clark, Yejin Choi (2019). "Counterfactual Story Reasoning and Generation". EMNLP. DOI: 10.18653/v1/D19-1509
-54. Snigdha Chaturvedi, Shashank Srivastava, Dan Roth (2018). "Where Have I Heard This Story Before? Identifying Narrative Similarity in Movie Remakes". NAACL. DOI: 10.18653/v1/N18-2106
-55. Angela Fan, M. Lewis, Yann Dauphin (2018). "Hierarchical Neural Story Generation". ACL. DOI: 10.18653/v1/P18-1082
-56. Ruth E. Page (2018). "Narratives Online: Shared Stories in Social Media". DOI: 10.1017/9781316492390
-57. J. Ryan (2017). "Grimes' Fairy Tales: A 1960s Story Generator". ICIDS. DOI: 10.1007/978-3-319-71027-3_8
-58. Agnès Celle, Laure Lansari (2017). "Expressing and Describing Surprise". DOI: 10.1075/BCT.92
-59. Kobie van Krieken, H. Hoeken, J. Sanders (2017). "Evoking and Measuring Identification with Narrative Characters — A Linguistic Cues Framework". Frontiers in Psychology. DOI: 10.3389/fpsyg.2017.01190
-60. Paul A. Dawson, P. K. Hansen, John Pier, Philippe Roussin, W. Schmid (2017). "How Many 'Turns' Does it Take to Change a Discipline? Narratology and the Interdisciplinary Rhetoric of the Narrative Turn". DOI: 10.1515/9783110555158-020
-61. Jan-Noël Thon (2016). "Transmedial Narratology and Contemporary Media Culture". DOI: 10.2307/j.ctt1d8h8vn
-62. Jessica Ouyang, K. McKeown (2015). "Modeling Reportable Events as Turning Points in Narrative". EMNLP. DOI: 10.18653/v1/D15-1257
-63. G. McBride (2014). "Storytelling, behavior planning, and language evolution in context". Frontiers in Psychology. DOI: 10.3389/fpsyg.2014.01131
-64. A. Miskimmon, B. O'Loughlin, Laura Roselle (2013). "Strategic Narratives: Communication Power and the New World Order". DOI: 10.5860/choice.185594
-65. Roy Sommer (2012). "The Merger of Classical and Postclassical Narratologies and the Consolidated Future of Narrative Theory".
-66. P. H. Fry (2012). "Theory of Literature". DOI: 10.12987/9780300183368
-67. Anna De Fina, A. Georgakopoulou (2012). "Analyzing Narrative: Discourse and Sociolinguistic Perspectives".
-68. F. Moretti (2011). "Network theory, plot analysis".
-69. Zhiying Xin (2009). "Text World Theory: An Introduction".
-70. L. Patterson (2008). "Narrative Methods for the Human Sciences". DOI: 10.1108/17542410810897562
-71. G. Prince (2008). "Classical and/or Postclassical Narratology". DOI: 10.1353/ESP.0.0005
-72. Suzanne Keen (2006). "A Theory of Narrative Empathy". DOI: 10.1353/nar.2006.0015
-73. J. Matz (2005). "The One vs. the Many: Minor Characters and the Space of the Protagonist in the Novel". DOI: 10.1215/00267929-66-3-400
-74. F. Moretti (2005). "Graphs, Maps, Trees: Abstract Models for a Literary History".
-75. R. Dickman (2003). "THE FOUR ELEMENTS OF EVERY SUCCESSFUL STORY". DOI: 10.1162/15241730360580212
-76. David Herman (1997). "Scripts, Sequences, and Stories: Elements of a Postclassical Narratology". PMLA. DOI: 10.2307/463482
-77. D. Keefe, M. McDaniel (1993). "The time course and durability of predictive inferences". DOI: 10.1006/JMLA.1993.1024
-78. Martin Kreiswirth, H. White (1992). "Trusting the Tale: The Narrativist Turn in the Human Sciences". DOI: 10.2307/469223
-79. J. Bruner (1991). "The Narrative Construction of Reality". Critical Inquiry. DOI: 10.1086/448619
-80. Dina Sherzer, G. Prince (1989). "A dictionary of narratology". DOI: 10.2307/415368
-81. A. Ortony, D. Partridge (1987). "Surprisingness and Expectation Failure: What's the Difference?". IJCAI.
-82. T. Trabasso, P. Broek (1985). "Causal thinking and the representation of narrative events". DOI: 10.1016/0749-596X(85)90049-X
-83. G. Prince (1982). "Narratology". DOI: 10.1515/9783110838626
-84. S. Chatman (1979). "Story and Discourse: Narrative Structure in Fiction and Film". DOI: 10.2307/2906308
-85. Tzvetan Todorov (1971). "The 2 Principles of Narrative". DOI: 10.2307/464558
-86. V. Propp, Svatava Pirkova-Jakobson, L. Scott (1959). "Morphology of the folktale". DOI: 10.2307/538485
-87. Tian Yu, Ken Shi, Zixin Zhao, Gerald Penn (2025). "Multi-Agent Based Character Simulation for Story Writing". In2Writing 2025. DOI: 10.18653/v1/2025.in2writing-1.9
-88. Andrew Piper, Sophie Wu (2025). "Evaluating Large Language Models for Narrative Topic Labeling". NLP4DH 2025. DOI: 10.18653/v1/2025.nlp4dh-1.25
-89. Andrew Piper, Sunyam Bagga (2025). "NarraDetect: An annotated dataset for the task of narrative detection". WNU 2025. DOI: 10.18653/v1/2025.wnu-1.1
-90. Annaliese Bissell, E. Paulin, Andrew Piper (2025). "A Theoretical Framework for Evaluating Narrative Surprise in Large Language Models". WNU 2025. DOI: 10.18653/v1/2025.wnu-1.7
-91. M. Shokri, Emily Klapper, J. Shan, Sarah Ita Levitan (2025). "Finding Common Patterns in Domestic Violence Stories Posted on Reddit". WNU 2025. DOI: 10.18653/v1/2025.wnu-1.6
-92. Megan Deering, Gerald Penn (2025). "An Analysis of Scoring Methods for Reranking in Large Language Model Story Generation". In2Writing 2025. DOI: 10.18653/v1/2025.in2writing-1.10
-93. Abhilasha Sancheti, Rachel Rudinger (2025). "Tracking Evolving Relationship Between Characters in Books in the Era of Large Language Models". WNU 2025. DOI: 10.18653/v1/2025.wnu-1.12
-94. Seiji Gobara, Hidetaka Kamigaito, Taro Watanabe (2025). "Speaker Identification and Dataset Construction Using LLMs: A Case Study on Japanese Narratives". WNU 2025. DOI: 10.18653/v1/2025.wnu-1.17
-95. Ankita Gupta, Marisa Hudspeth, Polly Stokes, J. Kurland, Brendan T. O'Connor (2025). "Automated main concept generation for narrative discourse assessment in aphasia". ACL Findings. DOI: 10.18653/v1/2025.findings-acl.1255
-96. Yiting Ran, Xintao Wang, Tian Qiu, Jiaqing Liang, Yanghua Xiao, Deqing Yang (2025). "BOOKWORLD: From Novels to Interactive Agent Societies for Story Creation". ACL. DOI: 10.18653/v1/2025.acl-long.773
-97. Nikolaos Nikolaidis, Nicolas Stefanovitch, Purificação Silvano, D. Dimitrov, Roman Yangarber, Nuno Guimarães, Elisa Sartori, I. Androutsopoulos, Preslav Nakov, Giovanni Da San Martino, Jakub Piskorski (2025). "PolyNarrative: A Multilingual, Multilabel, Multi-domain Dataset for Narrative Extraction from News Articles". ACL. DOI: 10.18653/v1/2025.acl-long.1513
-98. Enrica Troiano, Piek Vossen (2024). "CLAUSE-ATLAS: A Corpus of Narrative Information to Scale up Computational Literary Analysis". LREC. DOI: 10.63317/34wjjnqt76mt
-99. Jon Chun (2024). "AIStorySimilarity: Quantifying Story Similarity Using Narrative for Search, IP Infringement, and Guided Creativity". CoNLL. DOI: 10.18653/v1/2024.conll-1.13
-100. Andrew Piper, Sunyam Bagga (2024). "Using Large Language Models for Understanding Narrative Discourse". WNU 2024. DOI: 10.18653/v1/2024.wnu-1.4
-101. Joel Mire, Maria Antoniak, Elliott Ash, Andrew Piper, Maarten Sap (2024). "The Empirical Variability of Narrative Perceptions of Social Media Texts". EMNLP. DOI: 10.18653/v1/2024.emnlp-main.1113
-102. David Hobson, Haiqi Zhou, Derek Ruths, Andrew Piper (2024). "Story Morals: Surfacing value-driven narrative schemas using large language models". EMNLP. DOI: 10.18653/v1/2024.emnlp-main.723
-103. Andrew Piper, Michael Xu, Derek Ruths (2024). "The Social Lives of Literary Characters: Combining citizen science and language models to understand narrative social networks". NLP4DH. DOI: 10.18653/v1/2024.nlp4dh-1.45
-104. J. A. Meaney, Beatrice Alex, William Lamb (2024). "Testing and Adapting the Representational Abilities of Large Language Models on Folktales in Low-Resource Languages". NLP4DH. DOI: 10.18653/v1/2024.nlp4dh-1.31
-105. Hans Ole Hatzel, Christian Biemann (2024). "Story Embeddings — Narrative-Focused Representations of Fictional Stories". EMNLP. DOI: 10.18653/v1/2024.emnlp-main.339
-106. Junbo Huang, Ricardo Usbeck (2024). "Narration as Functions: from Events to Narratives". WNU 2024. DOI: 10.18653/v1/2024.wnu-1.1
-107. Marina Ermolaeva, Anastasia Shakhmatova, Alina Nepomnyashchikh, Alena Fenogenova (2024). "How to tame your plotline: A framework for goal-driven interactive fairy tale generation". WNU 2024. DOI: 10.18653/v1/2024.wnu-1.2
-108. Daria Seredina (2024). "A Report on LSG 2024: LLM Fine-Tuning for Fictional Stories Generation". INLG GenChal. DOI: 10.18653/v1/2024.inlg-genchal.14
-109. T. Baumann, K. Eller, Natalia Gagarina (2024). "BERT-based Annotation of Oral Texts Elicited via Multilingual Assessment Instrument for Narratives". WNU 2024. DOI: 10.18653/v1/2024.wnu-1.16
-110. A. Migal, Daria Seredina, Ludmila Telnina, Nikita Nazarov, Anastasia Kolmogorova, Nikolay Mikhaylovskiy (2024). "Overview of Long Story Generation Challenge (LSGC) at INLG 2024". INLG GenChal. DOI: 10.18653/v1/2024.inlg-genchal.4
-111. Yuri Bizzoni, Pascale Feldkamp (2023). "Comparing Transformer and Dictionary-based Sentiment Models for Literary Texts: Hemingway as a Case-study". NLP4DH.
-112. Winston Wu, Lu Wang, Rada Mihalcea (2023). "Cross-Cultural Analysis of Human Values, Morals, and Biases in Folk Tales". EMNLP. DOI: 10.18653/v1/2023.emnlp-main.311
-113. Hans Ole Hatzel, Chris Biemann (2023). "Narrative Cloze as a Training Objective: Towards Modeling Stories Using Narrative Chain Embeddings". WNU 2023. DOI: 10.18653/v1/2023.wnu-1.19
-114. Peiqi Sui, Lin Wang, S. Hamilton, Thorsten Ries, Kelvin Wong, Stephen Wong (2023). "Mrs. Dalloway Said She Would Segment the Chapters Herself". WNU 2023. DOI: 10.18653/v1/2023.wnu-1.15
-115. Yu-Kai Lee, Chia-Hui Chang (2023). "Story Co-telling Dialogue Generation based on Multi-Agent Reinforcement Learning and Story Highlights". ALTA.
-116. P. Ranade, S. Dey, A. Joshi, Timothy W. Finin (2022). "Computational Understanding of Narratives: A Survey". IEEE Access. DOI: 10.1109/ACCESS.2022.3205314
-117. Aman Berhe, Camille Guinaudeau, C. Barras (2022). "Survey on Narrative Structure: from Linguistic Theories to Automatic Extraction Approaches". ICON.
-118. A. Piper (2022). "The CONLIT Dataset of Contemporary Literature". Journal of Open Humanities Data. DOI: 10.5334/johd.88
-119. Andrew Piper, R. So, David Bamman (2021). "Narrative Theory for Computational Narrative Understanding". EMNLP. DOI: 10.18653/v1/2021.emnlp-main.26
-120. Byung-Chull Bae, Sujin Jang, Youngjune Kim, Seyoung Park (2021). "A Preliminary Survey on Story Interestingness: Focusing on Cognitive and Emotional Interest". ICIDS. DOI: 10.1007/978-3-030-92300-6_45
-121. D. Herman (2009). "Basic elements of narrative".
-122. M. Hyvärinen (2006). "Towards a Conceptual History of Narrative".
-123. A. Graesser, B. Olde, Bianca Klettke (2002). "How does the mind construct and represent stories".
-124. B. Lincoln (1999). "Theorizing Myth: Narrative, Ideology, and Scholarship". DOI: 10.2307/606705
-125. Terri Gullickson (1997). "Narrative therapy: The social construction of preferred realities". DOI: 10.1037/000559
-126. R. Berman (1997). "Narrative Theory and Narrative Development: The Labovian Impact". DOI: 10.1075/JNLH.7.29NAR
-127. Peter Brooks, Paul Gewirtz (1996). "Law's stories: narrative and rhetoric in the law". DOI: 10.5860/choice.34-1815
-128. L. Schehr, C. V. Boheemen, M. Bal (1988). "Narratology: Introduction to the Theory of Narrative".
-129. W. Brewer, Edward H. Lichtenstein (1980). "Event schemas, story schemas, and story grammars".
-130. Jakub Piskorski, Tarek Mahmoud, Nikolaos Nikolaidis et al. (2025). "SemEval 2025 Task 10: Multilingual Characterization and Extraction of Narratives from Online News".
diff --git a/docs/knowledge/v3_narratology/chatman1980/films-present-while-novels-assert.md b/docs/knowledge/v3_narratology/chatman1980/films-present-while-novels-assert.md
deleted file mode 100644
index 1d4450d..0000000
--- a/docs/knowledge/v3_narratology/chatman1980/films-present-while-novels-assert.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# Films present while novels assert — and synopses re-assert
-
-Source: Chatman 1980, "What Novels Can Do That Films Can't (And Vice Versa)" (pp. 126-128, 139)
-
-Chatman draws a fundamental distinction between two modes of conveying narrative information:
-
-**Assertion** (novels): The narrator *states* that something is the case. "The cart was tiny; it came onto the bridge." This is an explicit claim about properties and relations. The narrator selects which details to mention and in what order.
-
-**Presentation/depiction** (films): The camera *shows* a state of affairs. "A film doesn't say, 'This is the state of affairs,' it merely shows you that state of affairs." Details aren't selected — they're simply present in the frame. The number of visual details is "potentially large, even vast" but viewers, preoccupied with the plot, register only those "salient to the plot as it unrolls in our minds" (p. 126).
-
-Key consequences:
-- In novels, the narrator controls which properties are *asserted* — you know exactly what's claimed
-- In films, the camera *presents* everything in the frame — what viewers register is partly their own selection
-- Films can't easily assert abstract properties ("she was pretty"); they can only show a face that viewers may or may not find pretty (p. 131)
-- Novel narrators can assert evaluative qualities directly; filmmakers must find visual equivalents or use voice-over (which imports novelistic assertion into film)
-
-## "Interest" point of view
-
-Chatman introduces a POV concept beyond perceptual (where the camera is) and cognitive (what the character knows): **interest POV** — sharing a character's emotional concerns, their stakes, their desires (p. 134). "We become identified with the fate of a character, and even if we don't see things or even think about them from his or her literal perspective, it still makes sense to say that we share the character's point of view."
-
-## What this means for tvplotlines
-
-Our pipeline works with **re-asserted** narrative. The original TV show *presents* (Chatman's sense). The synopsis writer *asserts* (selects, names, orders). Our LLM then *re-asserts* (extracts, labels, structures).
-
-Each step loses presentational information and adds assertive interpretation:
-- **TV → synopsis**: loses visual/audio presentation, gains explicit assertion of what happened
-- **Synopsis → pipeline output**: loses the synopsis writer's emphasis/selection, gains structural labels (plotline, function)
-
-This means our pipeline necessarily works on an *already interpreted* version of the narrative. We're not analyzing the show — we're analyzing someone's assertion about the show. This is both a limitation (we lose experientiality, visual nuance) and an advantage (assertion is easier to parse than presentation).
-
-The "interest POV" concept is relevant to our plotline assignment: an event belongs to the plotline whose character's **interests** are most at stake, not necessarily the character who physically acts.
-
-## Links
-
-- [[narrative-deep-structure-is-independent-of-medium]]
-- [[experientiality-is-what-separates-narrative-from-chronicle]]
-- [[fabula-is-memory-trace-not-authors-plan]]
-- [[four-elements-of-narrative-operate-in-degrees]]
diff --git a/docs/knowledge/v3_narratology/chatman1980/narrative-deep-structure-is-independent-of-medium.md b/docs/knowledge/v3_narratology/chatman1980/narrative-deep-structure-is-independent-of-medium.md
deleted file mode 100644
index a0532a2..0000000
--- a/docs/knowledge/v3_narratology/chatman1980/narrative-deep-structure-is-independent-of-medium.md
+++ /dev/null
@@ -1,29 +0,0 @@
-# Narrative deep structure is independent of medium
-
-Source: Chatman 1980, "What Novels Can Do That Films Can't (And Vice Versa)", Critical Inquiry 7(1), pp. 121-140
-
-"Narrative itself is a deep structure quite independent of its medium" (p. 121). The same story — Cinderella, for instance — can be actualized as verbal tale, ballet, opera, film, comic strip, pantomime. The deep structure (the fabula, the "what happened") transfers; what changes is the expression.
-
-This is the founding premise of transmedial narratology: there exists a level of narrative organization (story/fabula) that is medium-independent, and a level (discourse/text) that is medium-specific.
-
-## Double time structure
-
-All narratives combine two independent time orders (p. 122):
-- **Story-time** (*histoire*) — the chronological sequence of events in the fabula
-- **Discourse-time** — the order of presentation in the text/film
-
-Story-time is fixed by the fabula's logic. Discourse-time is freely manipulable. This independence is "precisely and only possible because of the subsumed story-time" — you can only rearrange events because they have a logical order to deviate from.
-
-This maps directly to Bal's fabula-time vs story-time distinction and Todorov's succession principle.
-
-## What this means for tvplotlines
-
-Our pipeline works at the boundary between medium-specific and medium-independent levels. Synopses are **already translated** from TV (a visual/audio medium) into text (verbal medium). This translation has extracted the story-level information and mostly lost the discourse-level information (cinematography, editing rhythm, music, acting). 
-
-We work with what Chatman would call the **asserted** narrative — someone has told us what happened, selecting and naming properties. We don't work with the **presented** narrative — the actual visual/audio experience. This means our pipeline is inherently working on the fabula level, with some story-level residue (the order in which synopses describe events often follows discourse-time, not story-time).
-
-## Links
-
-- [[three-layer-model-separates-text-story-fabula]]
-- [[sequential-ordering-separates-fabula-time-from-story-time]]
-- [[fabula-is-memory-trace-not-authors-plan]]
diff --git a/docs/knowledge/v3_narratology/chauvel-2022-narrative-structure-survey.md b/docs/knowledge/v3_narratology/chauvel-2022-narrative-structure-survey.md
deleted file mode 100644
index 58e75be..0000000
--- a/docs/knowledge/v3_narratology/chauvel-2022-narrative-structure-survey.md
+++ /dev/null
@@ -1,38 +0,0 @@
----
-type: research
-project: tvplotlines
-status: active
-source: https://aclanthology.org/2022.tal-1.3.pdf
-year: 2022
-authors: [Chauvel]
-venue: TAL
----
-
-# Survey on Narrative Structure: from Linguistic Theories to Automatic Extraction
-
-## Summary
-
-Обзор от лингвистических теорий нарративной структуры к автоматическому извлечению. Начинает с Propp, Greimas, Genette, Labov — переходит к вычислительным реализациям. Покрывает фольклор, художественную литературу, другие нарративные формы.
-
-## Key concepts
-
-- **Propp's functions** — 31 функция волшебной сказки, первая формальная модель сюжета
-- **Greimas' actantial model** — 6 актантов (Subject, Object, Sender, Receiver, Helper, Opponent)
-- **Genette's narratology** — focalization, order, duration, frequency, voice
-- **Labov's narrative structure** — abstract, orientation, complicating action, evaluation, resolution, coda
-- **From theory to extraction** — как каждая теория переводится в NLP-задачу
-
-## Why this matters
-
-Мост между классической нарратологией и NLP. Именно здесь найти ответ "какие нарратологические концепции можно заменить на сценарные в промптах tvplotlines".
-
-## Relevance to tvplotlines
-
-Прямая карта соответствий: Story DNA ≈ actantial model? Narrative functions ≈ Propp's functions? Format classification ≈ genre theory? Эта статья даёт теоретическую базу для такого маппинга.
-
-## Connections
-
-- [[santana-2022-narrative-extraction-survey]] — параллельный обзор с NLP-фокусом
-- [[liu-2025-narrative-theory-survey]] — LLM-эра продолжение
-- [[mani-2025-narrative-generative-ai]] — монография, развивает те же теории
-- [[hamilton-2025-narrabench]] — таксономия, основанная на этих теориях
diff --git a/docs/knowledge/v3_narratology/elkins-2022-shapes-of-stories.md b/docs/knowledge/v3_narratology/elkins-2022-shapes-of-stories.md
deleted file mode 100644
index 8cfbd94..0000000
--- a/docs/knowledge/v3_narratology/elkins-2022-shapes-of-stories.md
+++ /dev/null
@@ -1,64 +0,0 @@
----
-type: research
-project: tvplotlines
-status: active
-source: https://doi.org/10.1017/9781009270403
-year: 2022
-authors: [Elkins]
-venue: Cambridge Elements (Digital Literary Studies)
----
-
-# The Shapes of Stories: Sentiment Analysis for Narrative
-
-## Summary
-
-Книга (Cambridge Element) о sentiment analysis как методе визуализации нарративной структуры. Отталкивается от идеи Воннегута (простые формы историй) и работы Reagan (2016, "6 basic shapes"). Сравнивает 30+ моделей sentiment analysis, от dictionary-based (Syuzhet, sentimentR) до deep learning (transformers). Показывает что "форма" (emotional arc) есть даже у экспериментальных модернистских романов.
-
-## Key concepts
-
-- **Sentiment arc ≠ story arc** — sentiment analysis показывает syuzhet (порядок изложения), не fabula (хронологию событий). Это эмоциональная дуга, не сюжетная.
-- **6 basic shapes** (Reagan 2016): rags to riches, tragedy, man in a hole, Icarus, Cinderella, Oedipus
-- **Unique fingerprint** — каждый нарратив имеет уникальный эмоциональный отпечаток, простые формы видны только при сильном сглаживании
-- **Smoothing methods**: Rolling Mean (SMA), DCT (Jockers/Syuzhet), LOWESS — дают разные "расстояния" от текста
-- **Crux points** — пики и впадины sentiment arc коррелируют с ключевыми пассажами, выбранными литературоведами для close reading
-- **Human-in-the-loop обязателен** — модели не заменяют критика, а помогают ему
-- **Ensemble approach** — нет единственной "лучшей" модели, оптимальная зависит от текста
-
-## Tools mentioned
-
-- **SentimentArcs** (Jon Chun) — Python/Jupyter, 30+ моделей, open-source
-- **Syuzhet** (Jockers) — R package, GPL-3, dictionary + DCT smoothing
-- **sentimentR** (Rinker) — R, heuristics (intensification, negation)
-- **Hedonometer** (Reagan/Story Lab) — web tool, sliding window
-
-## Применимость к TV-сериалам
-
-### Что может работать
-- tvplotlines уже имеет синопсисы разбитые по эпизодам — это готовый input для sentiment analysis
-- Sentiment arc поверх эпизодов = эмоциональная траектория сезона — дополнительное измерение к текущим dramatic functions
-- Crux points из sentiment arc могут коррелировать с turning points / climax из tvplotlines
-- Можно строить sentiment arc **per plotline** (каждый event уже привязан к plotline)
-
-### Что проблематично
-- Elkins работает с **полными текстами** романов (тысячи предложений). tvplotlines работает с **синопсисами** (200-400 слов на эпизод). Синопсисы — сжатый пересказ, в них меньше "языка эмоций" и больше "языка событий".
-- Dictionary-based модели (Syuzhet, sentimentR) могут плохо работать на синопсисах — слишком мало слов для статистически значимого сигнала
-- Transformer-модели (BERT-based) могут справиться лучше, но теряют explainability
-- Elkins подчёркивает: sentiment arc показывает **discourse** (порядок изложения), не **story** (что произошло). Синопсисы обычно хронологичны — разница между syuzhet и fabula стирается.
-
-### Verdict: стоит ли пробовать?
-
-**Да, но как эксперимент с чётким scope.** Конкретный тест:
-
-1. Взять сериал где tvplotlines уже разметил всё (Grey's Anatomy S1 или Breaking Bad)
-2. Запустить SentimentArcs на синопсисах (по эпизодам → кривая за сезон)
-3. Сравнить: коррелируют ли впадины sentiment arc с crisis/climax из tvplotlines?
-4. Если да → sentiment arc как дешёвый (без LLM) pre-pass для оценки "формы" сезона
-5. Если нет → синопсисы слишком бедны для sentiment analysis, метод не переносится
-
-Это один скрипт на Python, не требует переписывания промптов. SentimentArcs бесплатен.
-
-## Connections
-
-- [[khan-2025-three-stage-analysis]] — тоже sentiment + narrative structure, но через VAD (Valence/Arousal/Dominance)
-- [[liu-2025-narrative-theory-survey]] — контекст sentiment подходов в NLP
-- [[hamilton-2025-narrabench]] — sentiment arcs как один из 50 narrative skills
diff --git a/docs/knowledge/v3_narratology/hamilton-2025-narrabench.md b/docs/knowledge/v3_narratology/hamilton-2025-narrabench.md
deleted file mode 100644
index 1e0a2f5..0000000
--- a/docs/knowledge/v3_narratology/hamilton-2025-narrabench.md
+++ /dev/null
@@ -1,58 +0,0 @@
----
-type: research
-project: tvplotlines
-status: active
-source: https://arxiv.org/abs/2510.09869
-doi: 10.18653/v1/2026.eacl-long.176
-year: 2025
-authors: [Hamilton, Wilkens, Piper]
-venue: EACL 2026
----
-
-# NarraBench: A Comprehensive Framework for Narrative Benchmarking
-
-## Summary
-
-Теоретически обоснованная таксономия задач narrative understanding. Обзор 78 существующих бенчмарков. Четыре измерения нарратива: story, narration, discourse, situatedness. 50 нарративных навыков. Вывод: только 27% задач покрыты существующими бенчмарками.
-
-## Key concepts
-
-- **Four dimensions**: story (что произошло), narration (кто и как рассказывает), discourse (как организован текст), situatedness (контекст восприятия)
-- **50 narrative skills** — гранулярная карта того, что LLM должна уметь делать с нарративом
-- **Gap analysis** — events, style, perspective, revelation почти не покрыты бенчмарками
-- **Taxonomy** — от нарратологической теории к вычислительным задачам
-
-## Taxonomy (Table 4)
-
-4 dimensions → 12 features → 50 aspects:
-
-- **Story**: Agent (name, role, attributes, emotions, motivation), Social Net (interaction, connections, relationship), Event (event, schema, causality), Plot (topic, plot, plotline, moral, obstacle, conflict, archetype), Structure (plot arc), Setting (setting, location)
-- **Discourse**: Time (duration, order), Revelation (suspense, curiosity, surprise)
-- **Narration**: Perspective (point of view, focalization, dialogue), Style (allusion, figurative, imageability, complexity, evaluative)
-- **Situatedness**: Paratext (genre, author, date, medium, platform), Motivation (intent)
-
-Теоретические основания: Genette (1980) narrative triangle (story/discourse/narration) + Herman (2009) situatedness.
-
-## Benchmark gaps (Table 5)
-
-Пробелы — нет бенчмарков для: Event causality/schema, Plot obstacle/conflict/archetype, all Style, Perspective point of view/focalization, Revelation curiosity/surprise.
-
-**tvplotlines покрывает несколько из этих пробелов:** Plot obstacle + conflict (Story DNA), Plot plotline (pass 1-2), Structure plot arc (pass 4). Это territory claim.
-
-## Why this matters
-
-Даёт формальный язык для описания того, что делает tvplotlines: какие из 50 навыков покрывает текущий пайплайн, какие нет. Карта пробелов. Таксономия основана на Genette + Herman — классическая нарратология, не сценарное мастерство.
-
-## Relevance to tvplotlines
-
-- **Текущее покрытие**: Story dimension (Agent, Plot, Structure) — основа текущего пайплайна
-- **Новые направления для v3**: Discourse (Time order, Revelation), Narration (Perspective, focalization), Style
-- **Territory claim**: tvplotlines закрывает пробелы в бенчмарках (obstacle, conflict, plot arc) — это аргумент для публикации
-- **Evaluation framework**: NarraBench SMV (Scale/Mode/Variance) может дать метрики для оценки tvplotlines output
-
-## Connections
-
-- [[liu-2025-narrative-theory-survey]] — survey-компаньон
-- [[mani-2025-narrative-generative-ai]] — теоретическая база для таксономии
-- [[khan-2025-three-stage-analysis]] — один из подходов к narrative understanding
-- [[elkins-2022-shapes-of-stories]] — sentiment arc как один из narrative skills (Structure → plot arc)
diff --git a/docs/knowledge/v3_narratology/herman2009/breach-of-canonical-script-makes-events-reportable.md b/docs/knowledge/v3_narratology/herman2009/breach-of-canonical-script-makes-events-reportable.md
deleted file mode 100644
index cd24f81..0000000
--- a/docs/knowledge/v3_narratology/herman2009/breach-of-canonical-script-makes-events-reportable.md
+++ /dev/null
@@ -1,31 +0,0 @@
-# Breach of a canonical script makes events reportable
-
-Source: Herman 2009, "Basic Elements of Narrative", Ch. 1 (pp. 19-21), drawing on Bruner 1990/1991
-
-Herman adopts Bruner's concept of **"canonicity and breach"**: narratives are worth telling because an implicit canonical script — what was expected, what normally happens — has been violated. The function of the story is then "to find an intentional state that mitigates or at least makes comprehensible a deviation from a canonical cultural pattern" (Bruner 1990: 49-50).
-
-This is more precise than Todorov's "disruption of equilibrium." It's not just that something changes — it's that something changes **against expectations**. The canonical script is what characters (and the audience) expect to happen based on the storyworld's norms. The breach is what actually happens instead.
-
-Bruner: "when you encounter an exception to the ordinary, and ask somebody what is happening, the person you ask will virtually always tell a story that contains *reasons* (or some other specification of an intentional state)."
-
-## Post hoc ergo propter hoc
-
-Herman, following Barthes (p. 8), notes that "the mainspring of narrative is precisely the confusion of consecution and consequence, what comes *after* being read in narrative as what is *caused by*." Readers systematically treat temporal sequence as causal connection. Narrative exploits this: if event B follows event A, readers assume A caused B unless told otherwise.
-
-## What this means for tvplotlines
-
-This gives us a sharper test for "inciting_incident" and for what makes an event narratively significant:
-
-**Current test**: "the event that starts the plotline"
-**With canonicity and breach**: "the event that violates the canonical expectation of the storyworld"
-
-In Breaking Bad: the canonical script is "high school teacher lives a quiet life." The cancer diagnosis *breaches* this script. But the truly narrative breach is Walt *deciding to cook meth* — that's where the canonical expectation of how a teacher responds to illness is shattered.
-
-This also explains why some events feel more "dramatic" than others: they violate stronger canonical expectations. A murder in a crime show has low breach (canonical for the genre). A murder in a sitcom has high breach (violates genre norms). The *strength of breach* could help with plotline ranking — the A-story has the strongest canonical breach.
-
-## Links
-
-- [[four-elements-of-narrative-operate-in-degrees]]
-- [[most-reportable-event-is-the-point-of-the-story]]
-- [[initial-situation-is-always-a-state-of-deficiency]]
-- [[five-part-sequence-is-richer-than-three-act-structure]]
diff --git a/docs/knowledge/v3_narratology/herman2009/experientiality-is-what-separates-narrative-from-chronicle.md b/docs/knowledge/v3_narratology/herman2009/experientiality-is-what-separates-narrative-from-chronicle.md
deleted file mode 100644
index 20b63b1..0000000
--- a/docs/knowledge/v3_narratology/herman2009/experientiality-is-what-separates-narrative-from-chronicle.md
+++ /dev/null
@@ -1,36 +0,0 @@
-# Experientiality is what separates narrative from chronicle
-
-Source: Herman 2009, "Basic Elements of Narrative", Ch. 1 (pp. 21-22)
-
-Herman's fourth element — **"what it's like"** — is the most cognitively oriented and arguably the most distinctive claim of the book. A narrative doesn't just tell what happened; it conveys **what it was like to experience** the events from within the storyworld.
-
-"The less markedly a text or a discourse encodes the pressure of events on an experiencing human or at least human-like consciousness, the less amenable that text or discourse will be to interpretation in narrative terms" (p. 21).
-
-Without experientiality:
-- A temporal sequence of events is a **chronicle** or **report**
-- A description of general patterns is an **explanation**
-- A series of states without an experiencing consciousness is a **list**
-
-With experientiality: the same events become a **story** — because someone *lived through* them and was affected by them.
-
-## Connection to Fludernik
-
-Herman builds on Fludernik's (1996) concept of "experientiality" as the core of narrativity. For Fludernik, "there can be narratives without plot, but there cannot be any narratives without a human (or anthropomorphic) experiencer of some sort" (quoted on p. xvi). This is a strong claim: experientiality is more fundamental to narrative than event structure.
-
-## What this means for tvplotlines
-
-This diagnoses our biggest theoretical gap. Our pipeline extracts *what happens* (events, functions, plotlines) but not *what it's like* to experience those events. Synopses inherently strip experientiality: "Walt strangles Krazy-8" is an event report, not a narrative. The narrative is what it's like for Walt to do this — the horror, the necessity, the threshold crossed.
-
-Practically, we can't fully recover experientiality from synopses. But we could:
-1. Ask the LLM to infer the **experiential impact** of events on characters (fear, relief, shock, shame)
-2. Track **whose consciousness** each event primarily impacts — this connects to Bal's focalization
-3. Use experiential intensity as a signal for identifying the MRE — the most intense experiential moment is likely the most reportable event
-
-This also explains why our "theme" field in pass2 often feels thin: theme emerges from the experiential dimension (what it was like), which we don't capture. The theme of Breaking Bad S01E03 isn't just "the illusion of control" as an abstract concept — it's the specific experience of discovering that control is an illusion through the act of killing someone.
-
-## Links
-
-- [[four-elements-of-narrative-operate-in-degrees]]
-- [[most-reportable-event-is-the-point-of-the-story]]
-- [[labov-narrative-structure-maps-to-six-components]]
-- [[gnoseological-narrative-is-driven-by-knowledge-not-action]]
diff --git a/docs/knowledge/v3_narratology/herman2009/four-elements-of-narrative-operate-in-degrees.md b/docs/knowledge/v3_narratology/herman2009/four-elements-of-narrative-operate-in-degrees.md
deleted file mode 100644
index d0efcf4..0000000
--- a/docs/knowledge/v3_narratology/herman2009/four-elements-of-narrative-operate-in-degrees.md
+++ /dev/null
@@ -1,35 +0,0 @@
-# Four elements of narrative operate in degrees, not as binary features
-
-Source: Herman 2009, "Basic Elements of Narrative", Ch. 1 (pp. 9-22)
-
-Herman proposes four basic elements that constitute conditions for narrativity. Crucially, they are **gradient** — a text is more or less prototypically narrative based on how strongly each element is present:
-
-**(i) Situatedness** — the narrative is situated in a specific discourse context or occasion for telling. The same story told in court testimony vs. a screenplay vs. a party anecdote is interpreted differently because the communicative situation shapes meaning.
-
-**(ii) Event sequencing** — a structured time-course of particularized events. Not just "things happen" but particular things happen to particular people at particular times. Narrative traces "paths taken by particularized individuals faced with decision points at one or more temporal junctures" (p. 19). The temporal profile distinguishes narrative from description (which can be reordered freely) and explanation (which concerns general patterns, not particular cases).
-
-**(iii) Worldmaking / world disruption** — events introduce disruption or disequilibrium into a storyworld. Building on Propp (disruptive events as motor of narrative) and Todorov (equilibrium → disruption → new equilibrium), Herman adds Bruner's concept of **"canonicity and breach"**: a story is worth telling because "an implicit canonical script has been breached, violated, or deviated from" (Bruner 1991). The breach is what makes the events *reportable*.
-
-**(iv) What it's like** (experientiality) — the narrative conveys what it is like to live through the storyworld-in-flux. It encodes "the pressure of events on real or imagined consciousnesses affected by the occurrences at issue" (p. 14). Without this dimension — without a consciousness experiencing the disruption — a temporal sequence of events is a chronicle or report, not a narrative.
-
-## The gradience principle
-
-These elements don't function as a checklist. They operate more-or-less: how detailed is the storyworld? How marked is the disruption? How vivid is the experiential dimension? A text that scores high on all four is a prototypical narrative. A text that scores low on "what it's like" (e.g., a synopsis) is less prototypically narrative — which is precisely what our pipeline works with.
-
-## What this means for tvplotlines
-
-Herman's model diagnoses our pipeline's blind spots:
-
-- **Situatedness**: N/A — we analyze one medium (TV synopses) in one context
-- **Event sequencing**: ✅ — this is what pass2 and pass4 do
-- **Worldmaking/world disruption**: ⚠️ — we capture disruption implicitly through functions (inciting_incident, crisis) but don't track the *canonical expectation* that was breached
-- **What it's like**: ❌ — our biggest gap. We capture *what happens* but not *what it's like to experience it*. Synopses strip this away, and our pipeline doesn't try to reconstruct it
-
-The "canonicity and breach" concept is especially sharp: a narrative event is interesting because it *violates expectations within the storyworld*. This could refine our inciting_incident definition: not just "the event that starts the plotline" but "the event that breaches the canonical script of the storyworld."
-
-## Links
-
-- [[breach-of-canonical-script-makes-events-reportable]]
-- [[experientiality-is-what-separates-narrative-from-chronicle]]
-- [[ten-elements-define-degrees-of-narrativity]]
-- [[five-part-sequence-is-richer-than-three-act-structure]]
diff --git a/docs/knowledge/v3_narratology/huang-usbeck2024/constituent-vs-supplementary-events.md b/docs/knowledge/v3_narratology/huang-usbeck2024/constituent-vs-supplementary-events.md
deleted file mode 100644
index 020e595..0000000
--- a/docs/knowledge/v3_narratology/huang-usbeck2024/constituent-vs-supplementary-events.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# Constituent events form the causal backbone, supplementary events add texture
-
-Source: Huang & Usbeck 2024, "Narration as Functions: from Events to Narratives" (pp. 3-4), drawing on Abbott 2020, Barthes & Duisit 1975, Chatman 1978
-
-The paper adopts a fundamental distinction between two types of events:
-
-**Constituent events** (also called nuclei by Barthes/Duisit 1975, or kernels by Chatman 1978) — the events without which the story would fundamentally change or would not make sense. They form the causal backbone of the narrative. Remove one, and the story is "significantly altered or loses coherence."
-
-**Supplementary events** (also called catalyzers by Barthes, or satellites by Chatman) — events that add depth, richness, and complexity but aren't necessary for the story to be complete. Remove one, and "the story might be less detailed or interesting, but it would still be recognizable as the same story."
-
-## The test
-
-Abbott (2020) provides the test: if you remove this event, does the story significantly change? If yes — constituent. If no — supplementary.
-
-This is closely related to Bal's "choice" criterion for functional events: a functional event is one that opens a fork, and if it hadn't happened, the rest would change. Constituent events ≈ functional events (Bal) ≈ kernels (Chatman).
-
-## Why the distinction matters computationally
-
-The authors show that in existing event extraction datasets (BECauSE 2.0, CaTeRS, RED, Causal-TB, EventStoryLine, MAVEN-ERE), the causal relation matrix is extremely sparse — S(H) > 0.95 in all datasets. Most extracted events don't causally relate to other events. This means most extracted events are supplementary: they describe things that happen but don't drive the plot forward.
-
-Filtering out supplementary events produces a much denser causal matrix — the "core story" — which captures the actual causal logic of the narrative.
-
-## What this means for tvplotlines
-
-Our pass2 currently extracts events from every sentence of the synopsis. By the constituent/supplementary distinction, many of these are supplementary — they add texture but don't form the causal backbone. This creates noise in the event list and makes function assignment harder.
-
-Adding a constituent/supplementary label to each event (or filtering supplementary events before function assignment) could sharpen the pipeline. The test is simple enough for an LLM: "If this event were removed, would the plotline's outcome change?"
-
-## Links
-
-- [[three-criteria-filter-functional-events]] (Bal's functional event = constituent event)
-- [[fabula-as-events-plus-causal-matrix]]
-- [[narration-transforms-fabula-into-discourse]]
diff --git a/docs/knowledge/v3_narratology/huang-usbeck2024/fabula-as-events-plus-causal-matrix.md b/docs/knowledge/v3_narratology/huang-usbeck2024/fabula-as-events-plus-causal-matrix.md
deleted file mode 100644
index 8f6348f..0000000
--- a/docs/knowledge/v3_narratology/huang-usbeck2024/fabula-as-events-plus-causal-matrix.md
+++ /dev/null
@@ -1,47 +0,0 @@
-# Fabula can be formalized as events plus a causal relation matrix
-
-Source: Huang & Usbeck 2024, "Narration as Functions: from Events to Narratives" (p. 4)
-
-The paper proposes a minimal formal representation of fabula:
-
-```
-F = {E, H}
-```
-
-Where:
-- **E** = [e₁, e₂, ..., eₙ] — a list of temporally ordered events
-- **H** = n×n causal relation matrix, where rᵢⱼ ∈ {1, -1, 0}
-  - rᵢⱼ = 1: event eᵢ causes eⱼ
-  - rᵢⱼ = -1: eⱼ causes eᵢ
-  - rᵢⱼ = 0: no causal relation
-
-The "core story" I_c = {E_c, H_c} is obtained by filtering to constituent events only, producing a denser (less sparse) causal matrix.
-
-## The sparsity problem
-
-All existing document-level event causal extraction datasets have S(H) > 0.95 — meaning over 95% of event pairs have no causal relation. Most events are supplementary. The core story, after filtering, has a much denser matrix.
-
-## Three-stage pipeline
-
-The paper maps information flow from real world to narrative text:
-
-1. **f(·)**: real-world events → fabula (selection and temporal ordering)
-2. **g(·)**: fabula → discourse (narrative composition — causal logic, emphasis)
-3. **z(·)**: discourse → text (natural language generation)
-
-This corresponds to Bal's three layers (fabula → story → text) but adds an explicit computational framing.
-
-## What this means for tvplotlines
-
-Our pipeline implicitly builds something like F = {E, H}: pass2 extracts events (E) and assigns them to plotlines (which implies causal chains within each plotline). But we don't explicitly build the causal relation matrix H. Doing so would let us:
-1. Identify constituent events (those with many causal links)
-2. Detect orphaned events (those with no causal links — likely supplementary)
-3. Validate plotline boundaries (events in the same plotline should be causally linked)
-
-The formalization also highlights what our pipeline *doesn't* do: we capture which plotline an event serves but not *which other events it causally depends on or causes*.
-
-## Links
-
-- [[constituent-vs-supplementary-events]]
-- [[narration-transforms-fabula-into-discourse]]
-- [[three-layer-model-separates-text-story-fabula]]
diff --git a/docs/knowledge/v3_narratology/huang-usbeck2024/narration-transforms-fabula-into-discourse.md b/docs/knowledge/v3_narratology/huang-usbeck2024/narration-transforms-fabula-into-discourse.md
deleted file mode 100644
index 91e3dd1..0000000
--- a/docs/knowledge/v3_narratology/huang-usbeck2024/narration-transforms-fabula-into-discourse.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# Narration is a function that transforms fabula into discourse
-
-Source: Huang & Usbeck 2024, "Narration as Functions: from Events to Narratives" (pp. 2-3)
-
-The paper frames narration as a computational function: given a fabula (selected events + causal relations), narration produces discourse — an intermediate representation that shapes the narrated world. This discourse is then textualized into natural language.
-
-The key insight for news narratives (the paper's domain): news narrators don't just report events. They **re-represent** real-world events through selection (what to include), ordering (in what sequence), and framing (what causal connections to highlight). The narrated world is not the real world — it's a construction.
-
-## Authorial intent
-
-The paper revisits "authorial intent" through Critical Discourse Analysis (CDA): news narrators are "a dominant group" who shape "the narrated world encoded in language consumed by the public." The narrated world reflects power structures, values, and ideology — not objective reality.
-
-This is less relevant for fiction (where the "narrated world" is explicitly constructed), but the framework applies: a TV show's narration selects events, orders them, and frames causal connections to produce a particular narrated world.
-
-## Limitations the authors acknowledge
-
-- Only causal relations considered — ignores temporal shifts, rhetorical strategies, emotional arcs
-- Domain limited to news narratives
-- "Non-event-related narrative nuances cannot be captured"
-- Constituent event identification is domain-specific and requires interpretation
-
-## What this means for tvplotlines
-
-The paper is a position paper, not a system — there's no implementation to borrow. But the framing is useful: our pipeline's job is essentially φ(·) in reverse. We receive text (synopses), and we try to reconstruct fabula (events + causal structure). The paper confirms this is a well-defined task with a theoretical foundation.
-
-The limitation about "only causal relations" is relevant: our pipeline captures more than causality (dramatic functions, thematic connections, interactions between plotlines). This is a strength.
-
-## Links
-
-- [[fabula-as-events-plus-causal-matrix]]
-- [[constituent-vs-supplementary-events]]
-- [[three-layer-model-separates-text-story-fabula]]
-- [[fabula-is-memory-trace-not-authors-plan]]
diff --git a/docs/knowledge/v3_narratology/ionescu2019/postclassical-narratology-fragmented-into-many-strands.md b/docs/knowledge/v3_narratology/ionescu2019/postclassical-narratology-fragmented-into-many-strands.md
deleted file mode 100644
index 2ab130b..0000000
--- a/docs/knowledge/v3_narratology/ionescu2019/postclassical-narratology-fragmented-into-many-strands.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# Postclassical narratology fragmented into many strands after 1999
-
-Source: Ionescu 2019, "Postclassical Narratology: Twenty Years Later", Word and Text IX, pp. 5-34
-
-Since Herman coined "postclassical narratology" in 1997, the field has splintered into numerous subfields, each with its own methods and priorities:
-
-- **Rhetorical narratology** (Booth, Phelan, Rabinowitz) — focuses on the implied author, authorial audience, ethical dimensions of narration. "The flesh and blood reader seeks to enter the authorial audience in order to understand the invitations for engagement that the narrative offers" (p. 10)
-- **Cognitive narratology** (Fludernik, Herman) — uses mental processes and cognitive science to understand how readers construct storyworlds
-- **Corpus narratology** (Toolan, Sinclair, Stubbs) — stylistic analysis of large corpora, computational methods
-- **Feminist narratology** (Lanser, Page) — gender differences in story/discourse
-- **Transmedial narratology** (Helbig, Ryan, Rajewsky) — narrative across media: literature, film, comics, videogames. "Seek to rebuild narratology so that it can handle new genres and storytelling practices across a wide spectrum of media" (p. 14)
-- **Digital narratology** — hypertext narratives, interactive fiction, videogames
-- **Unnatural narratology** (Richardson, Alber) — anti-mimetic narratives that challenge real-world understandings of identity, time, space
-- **Corporeal narratology** (Punday) — the role of the body in narrative
-
-## The classical/postclassical distinction
-
-Classical narratology (Propp, Barthes, Genette, Todorov, Greimas, Bal) sought **universal narrative structures**. Postclassical narratology doesn't reject these but "rethinks their conceptual underpinnings and reassesses their scope of applicability" (Herman 1999). Key additions: context-sensitivity, cognitive dimensions, cross-media applicability, ethical considerations.
-
-Herman's definition: postclassical narratology "contains classical narratology as one of its 'moments' but is marked by a profusion of new methodologies and research hypotheses" (p. 9).
-
-## What this means for tvplotlines
-
-We are doing something that sits at the intersection of several strands:
-- **Classical structuralist** — using Bal, Todorov, Bremond, Greimas for formal models
-- **Cognitive** — our pipeline implicitly constructs storyworlds from synopses (Herman's experientiality)
-- **Transmedial** — applying literary concepts to TV series
-- **Corpus/computational** — automated analysis at scale
-
-The survey confirms that no single narratological framework is authoritative. Our approach of layering multiple classical frameworks (Bremond's cycles + Bal's actants + Labov's evaluation + Todorov's transformation) while keeping them operationally simple for LLM prompts is a defensible position — it's what postclassical narratology recommends: use classical tools but don't treat them as universal laws.
-
-The strand we're *not* drawing on but could: **rhetorical narratology** (Phelan) — how the narrative invites specific judgments and emotional responses from the audience. This connects to Herman's "what it's like" and Labov's "evaluation." It's about the *intended effect* of narrative choices on the viewer. For TV analysis, this is showrunner intent — why this scene exists, what reaction it's designed to produce.
-
-## Links
-
-- [[four-elements-of-narrative-operate-in-degrees]]
-- [[no-single-approach-universally-fits-narrative-structure]]
-- [[three-layer-model-separates-text-story-fabula]]
diff --git a/docs/knowledge/v3_narratology/keith-2025-interactive-narrative-analytics.md b/docs/knowledge/v3_narratology/keith-2025-interactive-narrative-analytics.md
deleted file mode 100644
index 249557f..0000000
--- a/docs/knowledge/v3_narratology/keith-2025-interactive-narrative-analytics.md
+++ /dev/null
@@ -1,41 +0,0 @@
----
-type: research
-project: tvplotlines
-status: active
-source: https://arxiv.org/abs/2601.11459
-doi: 10.1109/ACCESS.2025.3650352
-year: 2025
-authors: [Keith]
-venue: IEEE Access
----
-
-# Interactive Narrative Analytics: Bridging Computational Narrative Extraction and Human Sensemaking
-
-## Summary
-
-Определяет поле Interactive Narrative Analytics (INA): computational narrative extraction + interactive visual analytics для sensemaking. Обзор методов, вызовов (масштабируемость, интерактивность, интеграция знаний, стандартизация оценки) и приложений (новостной анализ, разведка, научная литература, соцсети).
-
-## Key concepts
-
-- **Interactive Narrative Analytics (INA)** — новое определение поля на стыке extraction и визуализации
-- **Sensemaking** — человеческое осмысление через интерактивное исследование нарративных структур (Pirolli & Card, information foraging)
-- **Four theoretical foundations**: interactive visual analytics, computational narratives, sensemaking, knowledge representation
-- **Event-based narratives** — нарратив как цепочка событий со связями (temporal, causal, semantic), НЕ как литературная структура (Propp, Genette)
-- **Knowledge integration** — онтологии и knowledge graphs для обогащения extraction
-
-## Verdict after reading
-
-**Аутлайер в seed-списке.** Библиография почти не пересекается с классической нарратологией. Фокус — news analysis, intelligence, misinformation detection. "Narrative" здесь = "цепочка событий в новостном потоке", а не "сюжетная структура художественного произведения".
-
-**Для v3 narratology промптов — малополезна.** Но полезна для tvplotlines-app (визуализация, human-in-the-loop, semantic interaction).
-
-## Relevance to tvplotlines
-
-- **Для библиотеки (prompts)**: низкая. Другое понимание "narrative".
-- **Для приложения (viewer)**: высокая. tvplotlines уже делает INA: extraction pipeline + HTML viewer. Keith даёт теоретическую рамку и показывает что можно добавить: semantic interaction, progressive analytics, knowledge integration.
-
-## Connections
-
-- [[balestri-pescatore-2025-icaart]] — тоже имеет графический интерфейс
-- [[santana-2022-narrative-extraction-survey]] — extraction часть
-- [[hamilton-2025-narrabench]] — evaluation часть
diff --git a/docs/knowledge/v3_narratology/khan-2025-three-stage-analysis.md b/docs/knowledge/v3_narratology/khan-2025-three-stage-analysis.md
deleted file mode 100644
index a6a62cd..0000000
--- a/docs/knowledge/v3_narratology/khan-2025-three-stage-analysis.md
+++ /dev/null
@@ -1,32 +0,0 @@
----
-type: research
-project: tvplotlines
-status: active
-source: https://arxiv.org/abs/2511.11857
-year: 2025
-authors: [Khan]
-venue: arXiv
----
-
-# Three Stage Narrative Analysis: Plot-Sentiment Breakdown, Structure Learning and Concept Detection
-
-## Summary
-
-Трёхэтапный пайплайн для анализа нарратива в киносценариях: (1) разбивка на plot-sentiment arcs, (2) кластеризация структур методом Ward's hierarchical clustering, (3) извлечение концептов. Использует dictionary-based sentiment analysis с кастомным лексиконом на основе NRC-VAD (Valence, Arousal, Dominance).
-
-## Key concepts
-
-- **Sentiment arcs** — сюжет как траектория эмоциональных состояний (не событий)
-- **VAD model** — Valence/Arousal/Dominance вместо бинарной позитивность/негативность
-- **Structure clustering** — группировка похожих нарративных структур
-- **Concept extraction** — высокоуровневые и низкоуровневые концепты из нарратива
-
-## Relevance to tvplotlines
-
-Альтернативный подход к тому же: разбиение нарратива на формальные компоненты. Но через sentiment, не через драматические функции. Может дать дополнительное измерение к текущим промптам — эмоциональная дуга поверх сюжетной.
-
-## Connections
-
-- [[hamilton-2025-narrabench]] — sentiment arcs как один из narrative skills
-- [[liu-2025-narrative-theory-survey]] — контекст sentiment-подходов
-- [[chauvel-2022-narrative-structure-survey]] — лингвистические теории структуры
diff --git a/docs/knowledge/v3_narratology/liu-2025-narrative-theory-survey.md b/docs/knowledge/v3_narratology/liu-2025-narrative-theory-survey.md
deleted file mode 100644
index 2b9a75d..0000000
--- a/docs/knowledge/v3_narratology/liu-2025-narrative-theory-survey.md
+++ /dev/null
@@ -1,38 +0,0 @@
----
-type: research
-project: tvplotlines
-status: active
-source: https://arxiv.org/abs/2602.15851
-year: 2025
-authors: [Liu]
-venue: arXiv
----
-
-# Narrative Theory-Driven LLM Methods for Automatic Story Generation and Understanding: A Survey
-
-## Summary
-
-Обзорная статья: как NLP-исследования используют нарративную теорию. Предлагает таксономию, отражающую нарратологические различия. Покрывает датасеты, задачи, теории, тренды в промптинге и файн-тюнинге. Разделяет generation и understanding.
-
-## Key concepts
-
-- **Narratology-informed taxonomy** — классификация NLP-задач через призму нарратологии
-- **Story generation vs understanding** — два направления использования LLM для нарратива
-- **Narrative theories in NLP pipeline** — как теории встраиваются в промпты и файн-тюнинг
-- **Methodological trends** — систематизация подходов (prompting, fine-tuning, hybrid)
-
-## Why this matters
-
-Самый ценный источник для библиографии — survey собирает всё поле. Именно здесь искать "общих предков" и карту территории.
-
-## Relevance to tvplotlines
-
-Прямо отвечает на вопрос "какие нарратологические концепции уже использовались в LLM-пайплайнах". Таксономия может показать, где tvplotlines находится и что упускает.
-
-## Connections
-
-- [[hamilton-2025-narrabench]] — benchmark-компаньон к этому survey
-- [[mani-2025-narrative-generative-ai]] — монография по той же теме
-- [[santana-2022-narrative-extraction-survey]] — предшествующий survey
-- [[chauvel-2022-narrative-structure-survey]] — предшествующий survey (лингвистический фокус)
-- [[balestri-pescatore-2025-icaart]] — один из проектов в обзоре
diff --git a/docs/knowledge/v3_narratology/mani-2025-narrative-generative-ai.md b/docs/knowledge/v3_narratology/mani-2025-narrative-generative-ai.md
deleted file mode 100644
index e288d12..0000000
--- a/docs/knowledge/v3_narratology/mani-2025-narrative-generative-ai.md
+++ /dev/null
@@ -1,38 +0,0 @@
----
-type: research
-project: tvplotlines
-status: active
-source: https://link.springer.com/book/10.1007/978-3-031-94058-3
-doi: 10.1007/978-3-031-94058-3
-year: 2025
-authors: [Mani]
-venue: Springer (Synthesis Lectures on HLT)
----
-
-# Narrative and Generative AI: A Computational Account
-
-## Summary
-
-Монография (второе издание). Обзор проблем, подходов и вызовов моделирования нарративной структуры. Расширена фокусом на generative AI. Inderjeet Mani — один из основоположников computational narratology.
-
-## Key concepts
-
-- **Computational narratology** — формализация нарратологических теорий для вычислений
-- **Narrative structure modeling** — от Propp до трансформеров
-- **Story understanding vs generation** — два направления, их пересечение с generative AI
-- **Theoretical grounding** — связь формальных моделей с классической нарратологией (Genette, Bal, Prince)
-
-## Why this matters
-
-Потенциально самая полная библиография из всех 9 работ. Книга по определению покрывает поле шире чем статья. Mani — ключевая фигура в computational narratology с 2000-х.
-
-## Relevance to tvplotlines
-
-Теоретический фундамент для перехода от сценарного мастерства к нарратологии. Если где-то описано "какие нарратологические концепции формализуемы" — то здесь.
-
-## Connections
-
-- [[liu-2025-narrative-theory-survey]] — survey по той же теме, но уже
-- [[hamilton-2025-narrabench]] — использует теоретическую базу Mani
-- [[santana-2022-narrative-extraction-survey]] — предшествующий обзор extraction
-- [[chauvel-2022-narrative-structure-survey]] — предшествующий обзор structure
diff --git a/docs/knowledge/v3_narratology/moc-pipeline-ideas.md b/docs/knowledge/v3_narratology/moc-pipeline-ideas.md
deleted file mode 100644
index a87373b..0000000
--- a/docs/knowledge/v3_narratology/moc-pipeline-ideas.md
+++ /dev/null
@@ -1,57 +0,0 @@
-# MOC: Идеи для нового пайплайна
-
-Идеи, которые возникают при чтении нарратологии и могут повлиять на архитектуру пайплайна, аналитику или позиционирование продукта.
-
-## Аналитика и продукт
-
-- **Обнаружение незапланированного**: сетевой анализ может показать структуры, которые авторы не проектировали сознательно — то что *вышло*, а не то что *задумывалось*. Это отдельная ценность инструмента: зеркало для showrunner'а. (Moretti 2011 — [[moretti2011/network-regions-reveal-plot-subsystems]])
-
-## Поиск сюжетных линий
-
-- **Подсети вокруг хабов как кандидаты на сюжетные линии**: степенное распределение связей создаёт несколько хабов, каждый — центр своей подсети. A-story = подсеть главного хаба, B-story = второго. Персонажи на пересечении подсетей участвуют в нескольких storylines. Removal experiment как верификация. (Moretti 2011 — [[moretti2011/power-law-distribution-in-character-networks]])
-
-## Метрики
-
-- **Protagonist detection через removal experiment**: протагонист — не тот у кого больше всего связей (degree), а тот, чьё удаление максимально фрагментирует сеть. Можно использовать как контрольный параметр: после того как пайплайн определил главного персонажа, проверить — действительно ли его удаление из графа взаимодействий ломает структуру сильнее всех остальных. Если нет — возможно пайплайн ошибся. (Moretti 2011 — [[moretti2011/protagonist-defined-by-network-stability-not-centrality]])
-
-## Эксперименты
-
-### Removal experiment на GoT
-**Цель**: проверить тезис Moretti — что протагонист определяется не degree, а дестабилизацией сети при удалении.
-
-**Данные**: два датасета от Andrew Beveridge:
-- Книги: [mathbeveridge/asoiaf](https://github.com/mathbeveridge/asoiaf) — `asoiaf-book1-edges.csv` и др.
-- **Сериал HBO**: [mathbeveridge/gameofthrones](https://github.com/mathbeveridge/gameofthrones) — данные по сезонам, по скриптам с genius.com. Взаимодействия: речь, упоминания, совместные сцены.
-
-**Что Beveridge уже сделал**:
-- Community detection → 7 сообществ (Ланнистеры, Робб, Бран, Арья, Джон+Стена, Станнис, Дейнерис)
-- 6 метрик центральности (degree, weighted degree, eigenvector, PageRank, closeness, betweenness)
-- Тирион — лидер по всем кроме betweenness (там Джон Сноу)
-
-**Что НЕ сделано** (наш эксперимент):
-- Removal experiments — удаление вершин и замер фрагментации
-- Сравнение degree ranking vs. destabilization ranking
-- Связь community detection → storyline identification
-
-**План**:
-1. Начать с книги (book1) — проще, данные точно чистые
-2. Потом повторить по сериалу (season 1) — сравнить результаты
-
-**Отдельный вопрос: устойчивость к методу построения сети.** Книжный датасет построен грубо (ко-окуренция имён в 15 словах текста). Сериальный — точнее (5 типов: прямая речь, упоминания, совместные сцены). Если removal experiment даёт похожие результаты на обоих — значит структура устойчива к методу экстракции. Это критично для нас: наш пайплайн будет строить графы из синопсисов (ещё более грубый метод), и если результат не зависит сильно от способа построения, даже грубая экстракция даст полезный граф.
-
-**Метрики дестабилизации** (при удалении вершины):
-1. Число компонент связности — было 1, стало N
-2. Доля LCC (largest connected component) — какая часть сети выжила
-3. (опционально) Изменение средней длины пути
-
-**Скрипт** (networkx, ~20 строк):
-1. Загрузить CSV → взвешенный граф
-2. Для каждого персонажа: удалить вершину, посчитать метрики 1-2
-3. Отсортировать по убыванию дестабилизации
-4. Сравнить с degree ranking — совпадает ли топ?
-
-**Ожидание**: Ned Stark должен быть топ-дестабилизатор (он связывает Winterfell, King's Landing, Wall через Джона). Degree-лидер может быть другим (Тирион по Beveridge).
-
-**Статус**: начат
-
-## Архитектура
diff --git a/docs/knowledge/v3_narratology/moretti2011/character-networks-model-plot-as-space-not-time.md b/docs/knowledge/v3_narratology/moretti2011/character-networks-model-plot-as-space-not-time.md
deleted file mode 100644
index 869d1d3..0000000
--- a/docs/knowledge/v3_narratology/moretti2011/character-networks-model-plot-as-space-not-time.md
+++ /dev/null
@@ -1,22 +0,0 @@
-# Character networks model plot as space, not time
-
-Source: Moretti 2011, "Network Theory, Plot Analysis"
-
-When you turn a dramatic text into a character network (characters = vertices, interactions = edges), you lose temporality but gain spatiality. The past becomes as visible as the present — once a character appears in the network, they never disappear. "What is done is never undone."
-
-This is a fundamental trade-off: networks sacrifice the sequential experience of plot (this happens, then that) for a simultaneous view of all relationships. The advantage is that you can now see **regions**, subsystems, and structural patterns that are invisible when reading linearly.
-
-Moretti frames this explicitly: "Four hours of action, that become this. Time turned into space: a character-system arising out of many character-spaces."
-
-This connects to Alex Woloch's concept of "character-space" from *The One vs. the Many* — each character occupies a portion of the narrative's attention, and the network makes these portions visible simultaneously.
-
-## Implications for tvplotlines
-
-- Our pipeline extracts storylines from synopses — a temporal representation. Network analysis could complement this by revealing the spatial structure of character relationships.
-- The time→space trade-off means network analysis and sequential storyline extraction answer different questions about the same text.
-
-## Links
-
-- [[power-law-distribution-in-character-networks]]
-- [[network-regions-reveal-plot-subsystems]]
-- [[protagonist-defined-by-network-stability-not-centrality]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/clustering-explains-structural-importance-of-characters.md b/docs/knowledge/v3_narratology/moretti2011/clustering-explains-structural-importance-of-characters.md
deleted file mode 100644
index ca6b283..0000000
--- a/docs/knowledge/v3_narratology/moretti2011/clustering-explains-structural-importance-of-characters.md
+++ /dev/null
@@ -1,21 +0,0 @@
-# Clustering coefficient explains why some characters are structurally important
-
-Source: Moretti 2011, "Network Theory, Plot Analysis"
-
-Clustering is a network metric: if A is connected to B and B to C, what's the probability that A and C are also connected? High clustering means tightly knit groups where "the friend of your friend is also your friend."
-
-In *Hamlet*, the Court hexagon (Hamlet, Claudius, Gertrude, Polonius, Ophelia, Laertes) has 100% clustering — everyone is connected to everyone. This explains **why removing Claudius has little effect**: he belongs to an already hyper-connected region. The redundancy of connections means no single node is structurally critical within this cluster.
-
-Horatio is the opposite: he inhabits a region of very low clustering, connecting otherwise-disconnected parts of the network. Removing Horatio disintegrates the network because there's no redundancy — he's the only bridge.
-
-## The principle
-
-- Characters in **high-clustering regions** are individually replaceable (structurally)
-- Characters in **low-clustering regions** are bridges — "weak ties" in Granovetter's sense — and their removal causes fragmentation
-- Structural importance ≠ number of connections. It's about whether your connections are redundant.
-
-## Links
-
-- [[protagonist-defined-by-network-stability-not-centrality]]
-- [[weak-ties-connect-narrative-regions]]
-- [[network-regions-reveal-plot-subsystems]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/edge-weight-and-direction-matter-but-are-hard-to-operationalize.md b/docs/knowledge/v3_narratology/moretti2011/edge-weight-and-direction-matter-but-are-hard-to-operationalize.md
deleted file mode 100644
index 57cb1c7..0000000
--- a/docs/knowledge/v3_narratology/moretti2011/edge-weight-and-direction-matter-but-are-hard-to-operationalize.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# Edge weight and direction matter for character networks but are hard to operationalize
-
-Source: Moretti 2011, "Network Theory, Plot Analysis"
-
-Moretti identifies two critical limitations of his networks:
-
-**No weight**: When Claudius tells Horatio "I pray thee, good Horatio, wait upon him" — 8 words — this edge has the same visual weight as the thousands of words exchanged between Hamlet and Horatio. "This can't be right."
-
-**No direction**: When Horatio addresses the Ghost, the Ghost doesn't reply. The interaction is one-directional. But the network shows a symmetric edge. Similarly, Hamlet's verbal energy is spread across five Court characters (only 28% of his words), while Claudius concentrates almost all his speech on the Court hexagon (48-60%).
-
-Moretti says he couldn't find "a non-clumsy way to visualize weight and direction" and prioritized "maximizing visibility by minimizing overlap." This is honest but consequential — weight and direction carry important narrative information:
-
-- **Weight** reveals intensity of relationships
-- **Direction** reveals power dynamics, initiative, agency
-- Together they could "significantly modify the initial X-ray" of a text
-
-## For tvplotlines
-
-- When building character interaction networks from synopses, consider: can we extract directional information (who initiates interaction)?
-- Weighted edges (based on co-occurrence frequency or interaction intensity) are more informative than binary presence/absence
-
-## Links
-
-- [[moretti-networks-as-visualization-not-theory]]
-- [[character-networks-model-plot-as-space-not-time]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/guanxi-networks-manufacture-social-obligation.md b/docs/knowledge/v3_narratology/moretti2011/guanxi-networks-manufacture-social-obligation.md
deleted file mode 100644
index 1496bfd..0000000
--- a/docs/knowledge/v3_narratology/moretti2011/guanxi-networks-manufacture-social-obligation.md
+++ /dev/null
@@ -1,22 +0,0 @@
-# Guanxi networks manufacture social obligation through chains of transactions
-
-Source: Moretti 2011, "Network Theory, Plot Analysis"
-
-In analyzing *The Story of the Stone*, Moretti encounters a network pattern that doesn't exist in Western novels: **guanxi** — "connections" that are "neither individual nor society-based, but relation-based." These connections are artifacts: "manufacturing obligation," "chain of transactions," "indebtedness."
-
-The key example (ch. 24): Jia Yun needs work → asks Bu Shi-ren for help → Bu refuses → Jia Yun meets Ni Er (a drunk/racketeer) → Ni Er lends money → Jia Yun buys a present for Xi-feng → Xi-feng gives him a job. A whole chain of transactions that manufactures obligation and creates asymmetry.
-
-This matters for network analysis because:
-1. **Edge semantics differ across cultures** — in Shakespeare, an edge means "these characters spoke." In *The Story of the Stone*, edges can mean reciprocity, obligation, transaction, debt.
-2. **Local asymmetry + global balance** — individual guanxi chains are asymmetric (someone gains, someone gives), but over time they tend toward reciprocity. At the chapter scale, this produces asymmetry in chapters but symmetry across the novel.
-
-## Implications for tvplotlines
-
-- Different narrative traditions structure character relationships differently
-- Edge types (cooperation, conflict, obligation, hierarchy) carry semantic weight that simple co-occurrence networks miss
-- TV series from different cultural traditions may need different analytical frameworks
-
-## Links
-
-- [[symmetry-emerges-in-small-chapter-networks]]
-- [[character-networks-model-plot-as-space-not-time]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/moretti-networks-as-visualization-not-theory.md b/docs/knowledge/v3_narratology/moretti2011/moretti-networks-as-visualization-not-theory.md
deleted file mode 100644
index ecf20c5..0000000
--- a/docs/knowledge/v3_narratology/moretti2011/moretti-networks-as-visualization-not-theory.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# Moretti used network theory as visualization, not as a full analytical framework
-
-Source: Moretti 2011, "Network Theory, Plot Analysis" (Epilogue)
-
-Moretti's crucial self-assessment in the epilogue: he didn't actually need network *theory* — he needed network *visualization*. "What I took from network theory were less concepts than visualization: the possibility of extracting characters and interactions from a dramatic structure, and turning them into a set of signs that I could see at a glance."
-
-He compares this to his earlier use of cartography in *Atlas of the European Novel*: arranging literary data spatially as "a principle of order — but not a full conceptual architecture."
-
-Key admissions:
-- The "region of death," "spaces of legitimacy," "symmetry" — none of these had much to do with network theory proper
-- The study drifted from quantification to qualitative analysis almost immediately
-- Edge weight and direction were missing, making the networks incomplete models
-- The networks were all built by hand, not computationally
-
-His conclusion: intuitive visualization reached a dead end. The next step required moving from images to **concepts** (network size, density, clustering, betweenness) and statistical analysis — the work Rhiannon Lewis continued.
-
-## Why this matters
-
-This is an honest account of the gap between borrowing a visualization technique from another discipline vs. actually using that discipline's analytical toolkit. For tvplotlines, the lesson is: don't stop at pretty graphs. Use the actual metrics.
-
-## Links
-
-- [[character-networks-model-plot-as-space-not-time]]
-- [[removal-experiments-reveal-structural-roles]]
-- [[clustering-explains-structural-importance-of-characters]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/network-regions-reveal-plot-subsystems.md b/docs/knowledge/v3_narratology/moretti2011/network-regions-reveal-plot-subsystems.md
deleted file mode 100644
index 2f6403f..0000000
--- a/docs/knowledge/v3_narratology/moretti2011/network-regions-reveal-plot-subsystems.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# Network regions reveal plot subsystems
-
-Source: Moretti 2011, "Network Theory, Plot Analysis"
-
-When you build a character network, clusters of interconnected characters form visible **regions** — subsystems within the plot that share some structural property. These regions often correspond to meaningful narrative units (political factions, families, social circles) that aren't explicitly labeled in the text.
-
-In *Hamlet*, the "region of death" emerges: characters connected to both Claudius and Hamlet (Polonius, Gertrude, Laertes, Ophelia, Rosencrantz, Guildenstern) are all killed. The network makes this visible as a structural property — "what is truly deadly is the characters' position in the network, chained to the warring poles of king and prince."
-
-The Court hexagon (Hamlet, Claudius, Gertrude, Polonius, Ophelia, Laertes) forms the densest region with 100% clustering. Outside this dense core, peripheral characters like Horatio inhabit sparser regions with different structural properties.
-
-## Key insight
-
-Regions are emergent — they arise from the pattern of connections, not from authorial labels. ==This means network analysis can discover groupings the author may not have consciously designed.==
-
-## Links
-
-- [[character-networks-model-plot-as-space-not-time]]
-- [[clustering-explains-structural-importance-of-characters]]
-- [[protagonist-defined-by-network-stability-not-centrality]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/power-law-distribution-in-character-networks.md b/docs/knowledge/v3_narratology/moretti2011/power-law-distribution-in-character-networks.md
deleted file mode 100644
index 99bb606..0000000
--- a/docs/knowledge/v3_narratology/moretti2011/power-law-distribution-in-character-networks.md
+++ /dev/null
@@ -1,22 +0,0 @@
-# Character networks follow power-law distribution
-
-Source: Moretti 2011, "Network Theory, Plot Analysis"
-
-The degree distribution of character networks (how many connections each character has) follows a power-law: very few characters have many edges, and very many characters have just one or two.
-
-This holds across Shakespeare's tragedies — *Hamlet*, *Macbeth*, *Lear*, *Othello* all show the same pattern. There is no "average" or "typical" character. The distribution has no central tendency.
-
-This is the opposite of a Gaussian curve: "there is no central tendency in the distribution, no 'average'; that is to say, there is no 'typical' vertex in the network, and *no typical character in the plays*."
-
-Moretti argues this invalidates speaking of "Shakespeare's characters in general" — at least in the tragedies — because the power-law means characters exist on a continuum from hyper-connected to barely present, with no natural grouping point.
-
-## Implications for tvplotlines
-
-Степенное распределение связей означает, что в сети есть несколько хабов (hyper-connected characters) и много периферийных персонажей. Каждый хаб — центр своей подсети (региона). Эти подсети могут соответствовать сюжетным линиям: A-story — подсеть вокруг главного хаба, B-story — вокруг второго, и т.д. Персонажи на пересечении подсетей (как Гертруда между Hamlet-space и Claudius-space) участвуют в нескольких сюжетных линиях. Removal experiment [[moc-pipeline-ideas]] может верифицировать: если удаление хаба разрушает подсеть — это реальная сюжетная линия с ядром.
-
-## Links
-
-- [[protagonist-defined-by-network-stability-not-centrality]]
-- [[character-networks-model-plot-as-space-not-time]]
-- [[network-regions-reveal-plot-subsystems]]
-- [[removal-experiments-reveal-structural-roles]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/protagonist-constrainted-by-relational-structure.md b/docs/knowledge/v3_narratology/moretti2011/protagonist-constrainted-by-relational-structure.md
deleted file mode 100644
index 54c358c..0000000
--- a/docs/knowledge/v3_narratology/moretti2011/protagonist-constrainted-by-relational-structure.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# The protagonist is not free — they are constrained by the relational structure
-
-Source: Moretti 2011, "Network Theory, Plot Analysis"
-
-Moretti's analysis of Bao-yu in *The Story of the Stone* reveals a counter-intuitive property of protagonists: the protagonist is "not free" precisely because they are the most connected. Each chapter reshuffles Bao-yu's connections — he speaks to 54 different characters in the first 20 chapters — but "not once does the same group reform around him."
-
-The protagonist has "a duty *towards the structure*: towards the relation-based society he is part of." This is unlike the Bildungsroman protagonist (Elizabeth Bennet) who is free to shape her own life. The network-constrained protagonist must maintain the connective tissue of the social world.
-
-This suggests two different protagonist types visible through network analysis:
-1. **Hub protagonist** — maintains network cohesion, constrained by connections (Bao-yu, Hamlet)
-2. **Journey protagonist** — moves through the network, transforming connections (Bennet)
-
-These correspond to different genres and cultural traditions: the relational Chinese novel vs. the individualist Western Bildungsroman.
-
-## Links
-
-- [[protagonist-defined-by-network-stability-not-centrality]]
-- [[guanxi-networks-manufacture-social-obligation]]
-- [[removal-experiments-reveal-structural-roles]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/protagonist-defined-by-network-stability-not-centrality.md b/docs/knowledge/v3_narratology/moretti2011/protagonist-defined-by-network-stability-not-centrality.md
deleted file mode 100644
index 1400b11..0000000
--- a/docs/knowledge/v3_narratology/moretti2011/protagonist-defined-by-network-stability-not-centrality.md
+++ /dev/null
@@ -1,23 +0,0 @@
-# Protagonist is defined by network stability, not centrality
-
-Source: Moretti 2011, "Network Theory, Plot Analysis"
-
-Moretti's key finding: the protagonist is not simply the most central character (highest degree, most connections). The protagonist is the character whose **removal most destabilizes the network**.
-
-In *Hamlet*, Claudius is almost as central as Hamlet (average distance 1.62 vs 1.45). Removing Claudius barely affects the network. But removing Hamlet splits the network almost in half — the court on one side, Ghost and Fortinbras on the other. Removing Hamlet and then Horatio completely fragments the play.
-
-This is the "removal experiment": take the network, delete a character, and observe what happens to the remaining structure. The protagonist is the one whose absence causes maximum fragmentation.
-
-This redefines the protagonist in structural terms: not "who is in the most scenes" or "who talks the most," but "who holds the network together." The protagonist's function is **stability** — they are the connective tissue of the plot.
-
-## Implications for tvplotlines
-
-- Protagonist detection could be formalized as: find the character whose removal maximizes network fragmentation (measured by number of connected components, or increase in average path length).
-- This is computationally tractable — it's essentially computing vertex connectivity.
-
-## Links
-
-- [[character-networks-model-plot-as-space-not-time]]
-- [[network-regions-reveal-plot-subsystems]]
-- [[removal-experiments-reveal-structural-roles]]
-- [[power-law-distribution-in-character-networks]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/removal-experiments-reveal-structural-roles.md b/docs/knowledge/v3_narratology/moretti2011/removal-experiments-reveal-structural-roles.md
deleted file mode 100644
index 9e25dfe..0000000
--- a/docs/knowledge/v3_narratology/moretti2011/removal-experiments-reveal-structural-roles.md
+++ /dev/null
@@ -1,28 +0,0 @@
-# Removal experiments reveal structural roles of characters
-
-Source: Moretti 2011, "Network Theory, Plot Analysis"
-
-Once you have a character network, you can **intervene** on the model: remove a character and observe what happens to the remaining structure. This is the most powerful analytical technique Moretti demonstrates.
-
-The procedure:
-1. Build the full network
-2. Remove a character (delete vertex and all its edges)
-3. Measure: does the network fragment? Into how many components? How does average distance change?
-
-Results for *Hamlet*:
-- Remove Hamlet → network nearly splits in half (court vs. Ghost+Fortinbras)
-- Remove Claudius → minor peripheral effects, network stays intact
-- Remove Hamlet + Horatio → complete fragmentation, beginning and ending severed from rest
-- Remove Hamlet + Claudius → less dramatic than removing Hamlet + Horatio
-
-This reveals that **quantitative centrality and structural importance diverge**: Claudius is almost as central as Hamlet by degree metrics, but structurally dispensable. Horatio is less central than Claudius but far more important structurally.
-
-## The method as tool
-
-This is essentially a computational thought experiment — "what if this character didn't exist?" — that can be automated. For any network, you can rank characters by the fragmentation their removal causes.
-
-## Links
-
-- [[protagonist-defined-by-network-stability-not-centrality]]
-- [[clustering-explains-structural-importance-of-characters]]
-- [[character-networks-model-plot-as-space-not-time]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/symmetry-emerges-in-small-chapter-networks.md b/docs/knowledge/v3_narratology/moretti2011/symmetry-emerges-in-small-chapter-networks.md
deleted file mode 100644
index 7eb69b9..0000000
--- a/docs/knowledge/v3_narratology/moretti2011/symmetry-emerges-in-small-chapter-networks.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# Symmetry emerges naturally in small chapter-level networks
-
-Source: Moretti 2011, "Network Theory, Plot Analysis"
-
-When Moretti switches from whole-play networks to chapter-level networks in Dickens (*Our Mutual Friend*), a striking pattern appears: binary symmetry. Chapters consistently organize around pairs — husband and wife, parent and child, brother and sister, suitor and beloved, rival and rival.
-
-Two reasons for this:
-1. **Dickens builds from binary pairs** — relationships are dualistic by nature
-2. **With few characters, there's little "noise" to disrupt the pattern** — the binaries project cleanly onto the chapter structure
-
-This symmetry in Dickens contrasts with the **asymmetry** Moretti finds in *The Story of the Stone* (Chinese novel). Chinese aesthetic tradition values symmetry explicitly — "parallel prose," hemispheric structure — but with hundreds of characters per chapter, the symmetry becomes local (within scenes) while the chapter as a whole is asymmetric.
-
-## The principle
-
-Symmetry and character count are inversely related: symmetry emerges with few characters, breaks down with many. "If with few characters symmetry emerges almost by itself, with *many* characters it becomes implausible."
-
-## Links
-
-- [[character-networks-model-plot-as-space-not-time]]
-- [[guanxi-networks-manufacture-social-obligation]]
diff --git a/docs/knowledge/v3_narratology/moretti2011/weak-ties-connect-narrative-regions.md b/docs/knowledge/v3_narratology/moretti2011/weak-ties-connect-narrative-regions.md
deleted file mode 100644
index 8ee5e38..0000000
--- a/docs/knowledge/v3_narratology/moretti2011/weak-ties-connect-narrative-regions.md
+++ /dev/null
@@ -1,21 +0,0 @@
-# Weak ties connect narrative regions and point beyond the main story world
-
-Source: Moretti 2011, "Network Theory, Plot Analysis"
-
-Horatio in *Hamlet* is the paradigmatic weak tie: low clustering, few intense connections, but a wide radius. His connections are "less intense, but with a wider radius; and more impersonal, almost bureaucratic" — like the ties Graham Sack described in *Bleak House*.
-
-The peripheral characters connected through weak ties often point to the world **beyond** the central story world. In *Hamlet*, the characters with the fewest connections (one link to the network) are links to places beyond Elsinore: Cornelius and Voltemand to Norway, Reynaldo to France, the sailor to England. These "centrifugal threads" are the "tendrils" that gesture toward the larger world.
-
-Horatio's function is unique: "a function in the plot, but not a motivation. No aim, no emotions — no *language*, really, worthy of *Hamlet*." He's structurally critical but narratively flat — his style matches the State bureaucracy, not the Court's melodrama.
-
-## Key insight
-
-Weak ties serve a dual function in narrative:
-1. **Structural**: they hold the network together by bridging disconnected regions
-2. **Thematic**: they represent the outside world, the context beyond the main conflict
-
-## Links
-
-- [[clustering-explains-structural-importance-of-characters]]
-- [[network-regions-reveal-plot-subsystems]]
-- [[protagonist-defined-by-network-stability-not-centrality]]
diff --git a/docs/knowledge/v3_narratology/narratological-canon.md b/docs/knowledge/v3_narratology/narratological-canon.md
deleted file mode 100644
index 8b402eb..0000000
--- a/docs/knowledge/v3_narratology/narratological-canon.md
+++ /dev/null
@@ -1,76 +0,0 @@
----
-type: research
-project: tvplotlines
-status: active
----
-
-# Нарратологический канон
-
-Работы, на которые ссылаются множественные seed-статьи из v3 narratology research. Отсортированы хронологически. Источники пересечений указаны в скобках.
-
-## Классический фундамент
-
-- **Propp (1928/1959)** — "Morphology of the Folktale". 31 функция волшебной сказки. Первая формальная модель сюжета. (Liu, Balestri, Hamilton)
-- **Todorov (1969/1971)** — "Structural Analysis of Narrative", "The 2 Principles of Narrative". Трансформация состояний как основа нарратива. (Liu, Balestri, Balestri-Memory)
-- **Freytag (1895)** — "Technique of the Drama". Пирамида: exposition → rising action → climax → falling action → denouement. (Hamilton, Elkins)
-- **Chatman (1979)** — "Story and Discourse: Narrative Structure in Fiction and Film". Разделение story (что) и discourse (как). (Liu)
-- **Genette (1980, 1997)** — "Narrative Discourse", "Palimpsests", "Paratexts". Фокализация, order, duration, frequency, voice. Narrative triangle: story/discourse/narration. (Liu, Balestri, Hamilton)
-- **Prince (1982, 1989, 2008)** — "Narratology", "A Dictionary of Narratology", "Classical and/or Postclassical Narratology". Формальные определения. (Liu)
-- **Bal (1988)** — "Narratology: Introduction to the Theory of Narrative". Учебник, стандартное введение. (Liu)
-
-## Когнитивный и постклассический поворот
-
-- **Brewer & Lichtenstein (1980, 1982)** — "Event schemas, story schemas, and story grammars", "Stories Are to Entertain: A Structural-Affect Theory". (Liu, Hamilton)
-- **Trabasso & van den Broek (1985)** — "Causal thinking and the representation of narrative events". Каузальные цепочки. (Liu)
-- **Bruner (1985, 1991)** — "Actual Minds, Possible Worlds", "The Narrative Construction of Reality". Нарратив как способ познания. (Liu, Hamilton, Keith)
-- **Ricoeur (1988)** — "Time and Narrative". Время и нарратив, mimesis I-II-III. (Hamilton)
-- **Sternberg (1992)** — "Telling in Time (II): Chronology, Teleology, Narrativity". Suspense, curiosity, surprise как нарративные эффекты. (Hamilton)
-- **Herman (1997, 2009)** — "Scripts, Sequences, and Stories: Elements of a Postclassical Narratology", "Basic Elements of Narrative". Situatedness как четвёртое измерение. (Liu, Hamilton)
-- **Labov & Waletzky (1997)** — "Narrative analysis: Oral versions of personal experience". Структура устного нарратива: abstract, orientation, complicating action, evaluation, resolution, coda. (Hamilton)
-- **Fludernik (2002, 2010)** — "Towards a 'Natural' Narratology", "Postclassical Narratology: Approaches and Analyses". Experientiality как основа нарратива. (Liu, Hamilton)
-
-## Когнитивная наука о нарративе
-
-- **Schank (1983)** — "Dynamic Memory: A Theory of Reminding and Learning". Scripts и планы. (Balestri-Memory)
-- **Minsky (1987)** — "The Society of Mind". Фреймы. (Balestri-Memory)
-- **Graesser, Singer, Trabasso (1994)** — "Constructing inferences during narrative text comprehension". (Balestri-Memory)
-- **Squire & Zola (1996)** — "Structure and function of declarative and nondeclarative memory systems". (Balestri-Memory)
-- **Tulving & Markowitsch (1998)** — "Episodic and declarative memory". (Balestri-Memory)
-- **Zwaan & Radvansky (1998)** — "Situation models in language comprehension and memory". (Keith)
-- **Kintsch (1998)** — "Comprehension: A Paradigm for Cognition". (Keith)
-- **Baddeley (2003)** — "Working memory and language". (Balestri-Memory)
-- **Zacks et al. (2007)** — "Event perception: a mind-brain perspective". (Balestri-Memory)
-- **Mar (2011)** — "The neural bases of social cognition and story comprehension". (Hamilton)
-
-## Computational narratology
-
-- **Chambers & Jurafsky (2008, 2009, 2010)** — Narrative event chains, narrative schemas. Первые вычислительные модели нарративных структур. (Hamilton)
-- **Moretti (2005, 2011)** — "Graphs, Maps, Trees", "Network theory, plot analysis". Distant reading. (Liu)
-- **Hogan (2011)** — "Affective Narratology: The Emotional Structure of Stories". (Hamilton)
-- **Reagan et al. (2016)** — "The emotional arcs of stories are dominated by six basic shapes". 6 форм. (Liu, Balestri, Hamilton, Elkins)
-- **Piper, So, Bamman (2021)** — "Narrative Theory for Computational Narrative Understanding". Мост между нарратологией и NLP. (Liu, Balestri, Hamilton)
-- **Elkins (2022)** — "The Shapes of Stories: Sentiment Analysis for Narrative". Методология sentiment arc. (Liu, Hamilton)
-
-## Transmedial и TV narratology
-
-- **Mittell (2015)** — "Complex TV: The Poetics of Contemporary Television Storytelling". Сложность ТВ-нарратива. (Balestri, Balestri-Memory)
-- **Thon (2016)** — "Transmedial Narratology and Contemporary Media Culture". (Liu)
-- **Ryan (2016)** — "Narrating Space / Spatializing Narrative". (Hamilton)
-- **Innocenti & Pescatore (2017, 2018)** — "Narrative Ecosystems", "Evolution of Characters in TV Series". (Balestri-Memory)
-- **Rocchi & Pescatore (2022)** — "Modeling narrative features in TV series". (Balestri, Balestri-Memory)
-
-## Семиотика и формализм
-
-- **Shklovsky (1919/2019)** — "Art as Technique". Остранение. (Liu)
-- **Kristeva (1984)** — "Desire in Language: A Semiotic Approach to Literature and Art". (Hamilton)
-- **Russian Formalism** — Lemon & Reis (1968), Bann & Bowlt (1974). (Liu, Hamilton)
-
-## Релевантность для tvplotlines v3
-
-Три кластера которые могут дать альтернативные промпты:
-
-1. **Структуралистский** (Propp → Genette → Bal): формальные модели с чёткими категориями. Ближе всего к текущим промптам (Story DNA ≈ актантная модель, narrative functions ≈ Propp's functions).
-
-2. **Когнитивный** (Bruner → Herman → Zacks → Baddeley): нарратив как когнитивный процесс. Может дать промпты через призму восприятия: что зритель запоминает, что удивляет, что создаёт suspense.
-
-3. **Affective/sentiment** (Reagan → Elkins → Hogan): эмоциональная дуга как измеримая структура. Может дать дополнительное измерение без переписывания основных промптов.
diff --git a/docs/knowledge/v3_narratology/ouyang-mckeown2015/change-in-metrics-predicts-turning-points-not-absolute-values.md b/docs/knowledge/v3_narratology/ouyang-mckeown2015/change-in-metrics-predicts-turning-points-not-absolute-values.md
deleted file mode 100644
index 195809b..0000000
--- a/docs/knowledge/v3_narratology/ouyang-mckeown2015/change-in-metrics-predicts-turning-points-not-absolute-values.md
+++ /dev/null
@@ -1,40 +0,0 @@
-# Change in metrics predicts turning points, not absolute values
-
-Source: Ouyang & McKeown 2015, "Modeling Reportable Events as Turning Points in Narrative" (pp. 4-6)
-
-The paper's central empirical finding: **it's the change (slope) in narrative metrics that predicts MREs, not the metric values themselves.** Using change-based features alone significantly outperforms all baselines; adding absolute metric values barely improves results.
-
-## Three dimensions of change
-
-The authors track sentence-level metrics across the narrative:
-
-**1. Syntactic change** — formality and complexity. MRE sentences tend to be long (complex structure) but with short, informal words. There's a drop in formality near the MRE — Labov observed that people speak less formally as they relive the climax of their stories.
-
-**2. Semantic change** — similarity to surrounding sentences. Expected: MRE should be dissimilar (shocking). Found: MRE sentences are actually *similar* to adjacent sentences, because MREs tend to be described across multiple consecutive sentences rather than in a single shocking line.
-
-**3. Affective change** — pleasantness, activeness, imagery (using the Dictionary of Affect in Language). The MRE is:
-- Global maximum in **activation** (excitement/intensity)
-- Global minimum in **pleasantness** (most negative emotional valence)
-- Peak in **imagery** (vivid, concrete language)
-
-The overall shape of activeness scores reflects Prince's minimal story: low initial activation (starting state) → high final activation (ending state) → peak at the MRE (change of state).
-
-## Top predictive features
-
-1. **Incoming imagery change** (sharp increase in vivid language at MRE)
-2. **Distance from formality minimum** (MRE near the least formal point)
-3. **Cosine similarity to adjacent sentences** (MRE described over multiple sentences)
-4. **Distance from activeness minimum** (MRE far from the stative orientation)
-5. **Sentence depth** (MRE sentences are syntactically complex)
-
-## What this means for tvplotlines
-
-We don't have access to linguistic features in synopses (they're written by summarizers, not narrators). But the principle transfers: **turning points are identified by change, not by absolute position.** Our current function assignment is positional (climax = near the end, setup = near the beginning). A change-based approach would instead ask: where do the stakes shift most dramatically? Where does the direction change?
-
-This also connects to Bremond's model: the transition from improvement to deterioration (or vice versa) is a *change in direction* — exactly the kind of slope change that predicts MREs.
-
-## Links
-
-- [[most-reportable-event-is-the-point-of-the-story]]
-- [[narrative-cycle-has-three-phases-not-seven]]
-- [[labov-narrative-structure-maps-to-six-components]]
diff --git a/docs/knowledge/v3_narratology/ouyang-mckeown2015/labov-narrative-structure-maps-to-six-components.md b/docs/knowledge/v3_narratology/ouyang-mckeown2015/labov-narrative-structure-maps-to-six-components.md
deleted file mode 100644
index 677255c..0000000
--- a/docs/knowledge/v3_narratology/ouyang-mckeown2015/labov-narrative-structure-maps-to-six-components.md
+++ /dev/null
@@ -1,37 +0,0 @@
-# Labov's narrative structure maps to six components
-
-Source: Ouyang & McKeown 2015, "Modeling Reportable Events as Turning Points in Narrative" (p. 2), drawing on Labov 1967/1997/2013
-
-Labov's model of oral narrative has six components, which the paper uses as the backbone of their change-based analysis:
-
-| Component | Function | Maps to tvplotlines |
-|---|---|---|
-| **Abstract** | Brief intro, sometimes refers to the MRE | ~ story_engine / logline |
-| **Orientation** | Background information, starting state | ~ setup |
-| **Complicating Action** | Chain of events leading up to MRE | ~ escalation, turning_point |
-| **Evaluation** | Author's/narrator's perspective on events — why this matters | *no equivalent* |
-| **Resolution** | Ending state, what finally happened | ~ resolution |
-| **Coda** | Wrapping up, returning to the present | *no equivalent* |
-
-## The missing piece: Evaluation
-
-The most interesting component for us is **Evaluation** — the narrator's commentary on *why* events matter. Labov (2013) has three subcomponents:
-- **Orientation** (background)
-- **Complicating action** (events leading to MRE)
-- **Evaluation** (the narrator's perspective)
-
-Plus the **Abstract** and **Coda** which frame the narrative.
-
-Our pipeline has no equivalent of Evaluation. We extract *what happens* (events) and *what function it serves* (setup/climax/etc.), but we don't capture *why it matters* — the narrator's or showrunner's emphasis on significance.
-
-In TV analysis, Evaluation manifests as: voice-over commentary, lingering camera shots, musical scoring, characters' emotional reactions. These are text-level signals that we lose in synopses. But even synopses sometimes contain evaluative language ("in a shocking twist," "devastated by the news") that we currently ignore.
-
-## What this means for tvplotlines
-
-Labov's six components are an alternative to Freytag's seven functions. The mapping isn't 1:1 — Labov adds Evaluation and Abstract, loses crisis/inciting_incident as separate categories. The key insight is that Evaluation is structurally distinct from the events themselves: it's not *what happens* but *how the telling emphasizes what matters*.
-
-## Links
-
-- [[most-reportable-event-is-the-point-of-the-story]]
-- [[change-in-metrics-predicts-turning-points-not-absolute-values]]
-- [[three-layer-model-separates-text-story-fabula]]
diff --git a/docs/knowledge/v3_narratology/ouyang-mckeown2015/most-reportable-event-is-the-point-of-the-story.md b/docs/knowledge/v3_narratology/ouyang-mckeown2015/most-reportable-event-is-the-point-of-the-story.md
deleted file mode 100644
index 8437bc2..0000000
--- a/docs/knowledge/v3_narratology/ouyang-mckeown2015/most-reportable-event-is-the-point-of-the-story.md
+++ /dev/null
@@ -1,30 +0,0 @@
-# The Most Reportable Event is the point of the story
-
-Source: Ouyang & McKeown 2015, "Modeling Reportable Events as Turning Points in Narrative" (pp. 1-2), drawing on Labov 1967/1997, Prince 1973, Polanyi 1976
-
-The **Most Reportable Event (MRE)** is the nucleus of the story — the most unusual event with the greatest emotional impact on the narrator and audience. It's the answer to "So what?" and the shortest possible summary of a story.
-
-Polanyi (1976): "one does not produce a narrative text for no reason at all." The MRE is that reason.
-
-Prince (1973) defines a minimal story as three parts: a starting state, an ending state, and the event that transforms one into the other. For a story to be interesting, that change-of-state event should be the MRE.
-
-Labov (1967/1997) defines a well-formed narrative as a series of actions leading to the MRE. The narrative builds toward it — it's where the story has been heading all along.
-
-## MRE vs climax
-
-The MRE maps to our "climax" function, but with an important difference: climax is defined positionally (peak of conflict), while MRE is defined by **reportability** — what makes the story worth telling. A climax can be structurally necessary but unremarkable. An MRE is by definition remarkable.
-
-The MRE test: "If I could only say one thing about this story, what would it be?" That's the MRE.
-
-## What this means for tvplotlines
-
-Our pass4 assigns `plot_fn: climax` to the peak event of each plotline's season arc. But we don't ask *why* that event is the peak — we just look for the structural turning point. The MRE concept suggests an additional question: **is this event the most reportable one?** The one that makes the plotline worth watching?
-
-For plotline ranking (A/B/C in pass3), MRE identification could help: the A-story is the one whose MRE is most reportable.
-
-## Links
-
-- [[change-in-metrics-predicts-turning-points-not-absolute-values]]
-- [[labov-narrative-structure-maps-to-six-components]]
-- [[narrative-cycle-has-three-phases-not-seven]]
-- [[constituent-vs-supplementary-events]]
diff --git a/docs/knowledge/v3_narratology/piper-so-bamman2021/character-attributes-and-relations-are-distinct-tasks.md b/docs/knowledge/v3_narratology/piper-so-bamman2021/character-attributes-and-relations-are-distinct-tasks.md
deleted file mode 100644
index f76f7c6..0000000
--- a/docs/knowledge/v3_narratology/piper-so-bamman2021/character-attributes-and-relations-are-distinct-tasks.md
+++ /dev/null
@@ -1,28 +0,0 @@
-# Character attribute inference and relation detection are distinct tasks
-
-Source: Piper, So, Bamman 2021, "Narrative Theory for Computational Narrative Understanding" (pp. 300-301)
-
-The paper distinguishes three NLP tasks related to narrative agents:
-
-**1. Agent detection** — recognizing characters in text, including non-named entities ("the coachman," "the frog"). NLP has focused on NER, but narrative requires broader "animacy detection" (Vala et al. 2015, Karsdorp et al. 2015).
-
-**2. Character attribute inference** — inferring properties of characters: gender, ethnicity, religion, emotion, function, power. Propp (2010/1968) theorized character as a limited set of narrative "functions." Forster (1985) introduced round/flat distinction. Recent NLP work includes: desire fulfillment (Chaturvedi et al. 2016), psychology (Rashkin et al. 2018), representations of gender (Underwood et al. 2018), power (Sap et al. 2017).
-
-**3. Relation detection** — how characters are "connected" or "interacting." Methods range from co-occurrence to supervised models. The challenge: identifying character *pairs* (siblings, parent-child) is extremely difficult, especially when information is expressed across multiple statements or left implicit.
-
-The paper notes that Propp (2010) used "character schemas" — fixed sets of relations (protagonist/antagonist/helper) — but supervised models that presume these fixed sets may miss the complexity of real narratives.
-
-## What this means for tvplotlines
-
-Our pipeline does agent detection (cast identification in pass1) and implicitly captures relations through plotline structure (who is in which plotline implies their narrative role). But we don't do explicit **character attribute inference** — we don't tag characters with traits, competences, or power dynamics.
-
-Bal's actant model (Subject/Object/Power/Receiver/Helper/Opponent) is essentially a structured approach to relation detection. If we adopt it, we'd be doing what Piper et al. describe as the intersection of attribute inference (what role does this character play?) and relation detection (how do characters relate to each other within the plotline structure?).
-
-The paper also flags **truth value** as a challenge: characters' apparent roles can differ from real ones. This aligns with Bal's truth value concept.
-
-## Links
-
-- [[actant-model-has-six-roles-not-four]]
-- [[anti-subject-signals-a-separate-storyline]]
-- [[truth-value-reveals-apparent-vs-real-roles]]
-- [[ten-elements-define-degrees-of-narrativity]]
diff --git a/docs/knowledge/v3_narratology/piper-so-bamman2021/events-scenes-plotlines-form-a-hierarchy.md b/docs/knowledge/v3_narratology/piper-so-bamman2021/events-scenes-plotlines-form-a-hierarchy.md
deleted file mode 100644
index 6d57c30..0000000
--- a/docs/knowledge/v3_narratology/piper-so-bamman2021/events-scenes-plotlines-form-a-hierarchy.md
+++ /dev/null
@@ -1,44 +0,0 @@
-# Events, scenes, and plotlines form a hierarchy
-
-Source: Piper, So, Bamman 2021, "Narrative Theory for Computational Narrative Understanding" (pp. 301-302)
-
-The paper proposes a hierarchical scheme for narrative structure at the document level:
-
-```
-events → scenes → plotlines
-```
-
-- **Events** — the atomic units of narrative action (change of state)
-- **Scenes** — contiguous sequences of events grouped by time/place/characters (passage-level segments)
-- **Plotlines** — higher-level arcs that span multiple scenes across a narrative
-
-This hierarchy maps onto passage-level and document-level NLP challenges:
-
-**Passage-level:**
-- **Narrative detection** — is this passage narrative at all (vs. descriptive, argumentative)?
-- **Scene detection** — where are the boundaries between story segments?
-
-**Document-level:**
-- **Plotline detection** — identifying the through-lines that connect events across scenes
-- The authors propose the shorthand: **event-scene-plotline**
-
-## Relation to existing frameworks
-
-Ouyang and McKeown (2014) — cited here — "leverage the categorization of narrative structure by Labov and Waletzky (1967), focusing specifically on the 'most reportable event (MRE)' as an indicator of a narrative's more general meaning."
-
-The paper also cites Boyd et al. (2020) on "the narrative arc" — revealing core narrative structures through text analysis — as showing that "sentiment valence" approximates narrative structure but much more work needs to be done on formal and cognitive conditions of narrative pivots.
-
-## What this means for tvplotlines
-
-Our pipeline implicitly uses this hierarchy: pass2 extracts events, pass1 defines plotlines, but we skip the **scene** level entirely. We go directly from sentences → events → plotlines. There's no intermediate grouping of events into scenes.
-
-For TV, "scene" is actually a natural unit — episodes are composed of scenes. If synopses described scenes (rather than just events), we'd have a richer intermediate representation. Our synopsis_writer prompt could be modified to produce scene-level descriptions.
-
-The hierarchy also clarifies our pipeline's architecture: pass2 does event extraction + plotline assignment simultaneously, but these are conceptually two different tasks at two different levels.
-
-## Links
-
-- [[ten-elements-define-degrees-of-narrativity]]
-- [[constituent-vs-supplementary-events]]
-- [[most-reportable-event-is-the-point-of-the-story]]
-- [[narrative-cycle-has-three-phases-not-seven]]
diff --git a/docs/knowledge/v3_narratology/piper-so-bamman2021/no-single-approach-universally-fits-narrative-structure.md b/docs/knowledge/v3_narratology/piper-so-bamman2021/no-single-approach-universally-fits-narrative-structure.md
deleted file mode 100644
index 50d99e5..0000000
--- a/docs/knowledge/v3_narratology/piper-so-bamman2021/no-single-approach-universally-fits-narrative-structure.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# No single approach universally fits narrative structure
-
-Source: Piper, So, Bamman 2021, "Narrative Theory for Computational Narrative Understanding" (p. 302)
-
-A crucial warning from the paper: "it is important to emphasize here that no single approach is universally appropriate to understanding narrative structure."
-
-Fields as diverse as folkloristics and narrative psychology provide competing models. The best-known classification systems for fictional narratives are:
-- **Thompson's Motif-Index of Folk-Literature** (1989)
-- **Aarne-Thompson-Uther (ATU) Tale Index**
-- **Adler et al. (2016)** — narrative psychology taxonomy correlated with life satisfaction
-
-These classification systems have seen only limited computational implementation (Broadwell et al. 2018). The cross-disciplinary computational implementation of large-scale story type classifiers "represents a major research challenge."
-
-## Two levels of temporal analysis
-
-The paper distinguishes two temporal levels:
-1. **"Time of telling"** (narrative time) — the order in which events are presented
-2. **"Time of what is told"** (narrated time) — the chronological order in the fabula
-
-This maps directly to Bal's story-time vs fabula-time distinction. Underwood (2018) provides an empirical approach to this with the concept of "passage of time" in novels.
-
-## What this means for tvplotlines
-
-This is a useful sanity check against over-committing to any single narratological framework. We shouldn't replace Freytag with Bremond and then treat Bremond as gospel. The right approach is probably **layered**: keep multiple lenses (Freytag for positional structure, Bremond for process direction, Labov for reportability) and let them complement each other rather than picking one.
-
-For our v3 prompts, this suggests: don't replace the seven functions, **add dimensions** alongside them. An event can simultaneously be an "escalation" (Freytag), a "realization of deterioration" (Bremond), and the "most reportable event" (Labov). Each lens captures something different.
-
-## Links
-
-- [[narrative-cycle-has-three-phases-not-seven]]
-- [[most-reportable-event-is-the-point-of-the-story]]
-- [[sequential-ordering-separates-fabula-time-from-story-time]]
-- [[ten-elements-define-degrees-of-narrativity]]
diff --git a/docs/knowledge/v3_narratology/piper-so-bamman2021/ten-elements-define-degrees-of-narrativity.md b/docs/knowledge/v3_narratology/piper-so-bamman2021/ten-elements-define-degrees-of-narrativity.md
deleted file mode 100644
index 61ba2fc..0000000
--- a/docs/knowledge/v3_narratology/piper-so-bamman2021/ten-elements-define-degrees-of-narrativity.md
+++ /dev/null
@@ -1,49 +0,0 @@
-# Ten elements define degrees of narrativity
-
-Source: Piper, So, Bamman 2021, "Narrative Theory for Computational Narrative Understanding" (pp. 299-300)
-
-Instead of a binary "is this a narrative or not," the authors propose a minimal definition where narrativity exists in **degrees** — the more elements are explicitly present, the more narrative the text:
-
-```
-A  Someone          (teller)
-B  tells
-C  someone          (recipient)
-D  somewhere        (situation/context)
-E     someone       (agent)
-F     did something (sequential actions)
-G     [to someone]  (potential object)
-H     somewhere     (spatial location)
-I     at some time  (temporal specification)
-J     for some reason (rationale)
-```
-
-These ten elements map to five research domains:
-- **Agents** (E, G) — character detection, attributes, relations
-- **Events** (F) — extraction, ordering, structure
-- **Temporality** (I) — when things happen, narrative time vs narrated time
-- **Setting** (H) — where things happen
-- **Perspective** (A, B, C) — who tells, to whom, from what viewpoint
-
-The "degrees of narrativity" hypothesis: recipients' response to narrativity increases as more of these variables are made explicit.
-
-## Comparison with Bal
-
-Bal's three layers (text/story/fabula) map onto these elements but from a different angle. Bal organizes by *analytical level* — where in the abstraction hierarchy you're working. Piper et al. organize by *what kind of information* you're extracting. Their framework is more operational for building an NLP pipeline.
-
-## What this means for tvplotlines
-
-Our pipeline covers some of these elements well and ignores others:
-- **Agents** (E, G): ✅ cast identification, plotline heroes
-- **Events** (F): ✅ event extraction and function assignment
-- **Temporality** (I): ⚠️ episode ordering only, no within-episode temporal analysis
-- **Setting** (H): ❌ no spatial analysis at all
-- **Perspective** (A, B, C): ❌ no focalization analysis (lost in synopses)
-- **Rationale** (J): ❌ no "why" — which connects to Labov's missing Evaluation component
-
-The gaps (setting, perspective, rationale) are partly inherent to working with synopses rather than full scripts. But rationale (J) is the most actionable gap — it maps to "why does this plotline matter."
-
-## Links
-
-- [[three-layer-model-separates-text-story-fabula]]
-- [[labov-narrative-structure-maps-to-six-components]]
-- [[events-scenes-plotlines-form-a-hierarchy]]
diff --git a/docs/knowledge/v3_narratology/santana-2022-narrative-extraction-survey.md b/docs/knowledge/v3_narratology/santana-2022-narrative-extraction-survey.md
deleted file mode 100644
index c04fec2..0000000
--- a/docs/knowledge/v3_narratology/santana-2022-narrative-extraction-survey.md
+++ /dev/null
@@ -1,39 +0,0 @@
----
-type: research
-project: tvplotlines
-status: active
-source: https://link.springer.com/article/10.1007/s10462-022-10338-7
-doi: 10.1007/s10462-022-10338-7
-year: 2022
-authors: [Santana, Campos, Amorim, Jorge, Silvano, Nunes]
-venue: Artificial Intelligence Review
----
-
-# A Survey on Narrative Extraction from Textual Data
-
-## Summary
-
-Обзор подходов к извлечению нарратива из текста. Организован по pipeline задач: от raw text до структурированного нарратива. Покрывает computational linguistics и AI подходы. Pre-LLM survey — показывает состояние поля до GPT-эры.
-
-## Key concepts
-
-- **Narrative extraction pipeline** — последовательность задач от текста к структуре
-- **Entity extraction** — персонажи, локации, объекты
-- **Event extraction** — действия, изменения состояний
-- **Relation extraction** — связи между событиями и персонажами
-- **Timeline construction** — темпоральное упорядочивание событий
-
-## Why this matters
-
-Фундаментальный обзор до-LLM эпохи. Все 2024-2025 работы на него ссылаются. Показывает какие задачи решались классическими методами (и где LLM их превзошли).
-
-## Relevance to tvplotlines
-
-Pipeline-структура этого обзора зеркалит pipeline tvplotlines. Полезно для сравнения: что tvplotlines делает промптами, а что можно было бы делать кодом.
-
-## Connections
-
-- [[liu-2025-narrative-theory-survey]] — LLM-эра продолжение
-- [[chauvel-2022-narrative-structure-survey]] — параллельный обзор с лингвистическим фокусом
-- [[mani-2025-narrative-generative-ai]] — монография, покрывает обе эры
-- [[keith-2025-interactive-narrative-analytics]] — extraction как компонент INA
diff --git a/docs/knowledge/v3_narratology/todorov1971/five-part-sequence-is-richer-than-three-act-structure.md b/docs/knowledge/v3_narratology/todorov1971/five-part-sequence-is-richer-than-three-act-structure.md
deleted file mode 100644
index 341e513..0000000
--- a/docs/knowledge/v3_narratology/todorov1971/five-part-sequence-is-richer-than-three-act-structure.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# The five-part sequence is richer than the three-act structure
-
-Source: Todorov 1971, "The 2 Principles of Narrative" (pp. 38-39), also Todorov's analysis of the Decameron
-
-The simplified "Todorov model" (equilibrium → disruption → new equilibrium) is widely taught but misses two crucial middle steps. The full five-part sequence:
-
-1. **Initial equilibrium** — a stable situation
-2. **Disruption** — a force disturbs the equilibrium
-3. **Recognition** — the disruption is acknowledged, understood
-4. **Attempt to repair** — action taken to restore or create new order
-5. **New equilibrium** — a different stable situation (not the same as the initial one)
-
-Steps 3 and 4 are what most summaries drop, but they're structurally important. The *recognition* that something has gone wrong is a separate narrative moment from the disruption itself. And the *attempt to repair* is where most of the narrative action happens — it's where characters exercise agency.
-
-## Comparison with other models
-
-| Todorov (5 parts) | Freytag (7 functions) | Bremond (3 phases) |
-|---|---|---|
-| Initial equilibrium | setup | — |
-| Disruption | inciting_incident | possibility |
-| Recognition | — (no equivalent) | — |
-| Attempt to repair | escalation, turning_point, crisis | realization |
-| New equilibrium | resolution | result |
-
-The key difference: Todorov adds **recognition** — the moment when characters (and the audience) realize that the equilibrium has been disturbed. This is narratively distinct from the disruption itself. In Breaking Bad, Walt getting cancer is the disruption; Walt *deciding to cook meth* is the recognition + beginning of repair attempt.
-
-Our pipeline's "inciting_incident" conflates disruption and recognition. Todorov would split them.
-
-## What this means for tvplotlines
-
-In practice, this means the current "inciting_incident" function may hide two distinct structural moments. For some plotlines, separating "what went wrong" (disruption) from "when the character decided to act" (recognition) could clarify the plotline's structure. This connects to Bal/Greimas's concept of **competence**: recognition is when the subject acquires *determination* (the will to act).
-
-## Links
-
-- [[two-principles-succession-and-transformation]]
-- [[competence-determines-when-subject-can-act]]
-- [[initial-situation-is-always-a-state-of-deficiency]]
-- [[most-reportable-event-is-the-point-of-the-story]]
diff --git a/docs/knowledge/v3_narratology/todorov1971/gnoseological-narrative-is-driven-by-knowledge-not-action.md b/docs/knowledge/v3_narratology/todorov1971/gnoseological-narrative-is-driven-by-knowledge-not-action.md
deleted file mode 100644
index 7547f07..0000000
--- a/docs/knowledge/v3_narratology/todorov1971/gnoseological-narrative-is-driven-by-knowledge-not-action.md
+++ /dev/null
@@ -1,44 +0,0 @@
-# Gnoseological narrative is driven by knowledge, not action
-
-Source: Todorov 1971, "The 2 Principles of Narrative" (pp. 39-42), from analysis of The Quest for the Grail
-
-Todorov identifies a distinct type of narrative: the **gnoseological** (knowledge-driven) narrative, where the organizing principle is not "what happens" but "what is learned."
-
-In The Quest for the Grail, the principal narrative is "a narrative of knowledge, not of action." Characters seek to understand the meaning of what they encounter. The events of the quest "are merely occasions for the exercise of interpretive faculties." The real narrative movement is from ignorance to understanding — not from state A to state B through physical action.
-
-Key characteristics of gnoseological narrative:
-- Events matter not for their consequences but for their **meaning**
-- The central transformation is cognitive: not-knowing → knowing
-- "It is not possible to bear one's self upon the search for concealment. But one can organize it around the requirement that he cause as little pain as possible" — the moral dimension is about knowledge management, not action
-- The MRE (most reportable event) is a **recognition**, not an action
-
-## Three types of actions in the Grail
-
-Todorov distinguishes three types:
-1. **Supernatural/given** — the Grail itself, divine intervention (not caused by characters)
-2. **Human agency** — characters' deliberate actions
-3. **Ritual/prescribed** — actions dictated by social/religious code
-
-In the gnoseological narrative, type 1 provides the *object* of knowledge, type 2 the *attempt* to understand, and type 3 the *framework* for interpretation.
-
-## What this means for tvplotlines
-
-This is directly relevant to **detective/procedural shows** (House, CSI, True Detective) and **mystery arcs** in serial TV (Lost, Twin Peaks, Westworld). In these narratives, the plotline's "events" are primarily moments of recognition, not moments of action:
-
-- "House orders a test" is an action, but the narrative transformation is: House [doesn't know diagnosis → has new hypothesis]
-- "Hank finds the desert cooking site" is an action, but narratively it's: Hank [ignorant of Walt → closer to discovering Walt]
-
-Our current event definition — "one action by one character that changes the situation" — captures the action but not the knowledge transformation. For procedural/mystery plotlines, the *knowledge state* is more important than the physical state.
-
-This could inform how we classify events in procedural shows: alongside the physical action, track the **knowledge transformation** — who learns what, and how does that change the narrative landscape.
-
-## Relevance to suspense types
-
-This connects directly to Bal's four suspense types: gnoseological narrative is built on the **riddle** (reader−, character−) and **secret** (reader−, character+) types. The narrative tension comes from knowledge asymmetry, not from physical threat.
-
-## Links
-
-- [[two-principles-succession-and-transformation]]
-- [[suspense-has-four-types-not-one]]
-- [[truth-value-reveals-apparent-vs-real-roles]]
-- [[confrontation-type-reveals-plotline-nature]]
diff --git a/docs/knowledge/v3_narratology/todorov1971/ideological-gradation-organizes-event-sequences.md b/docs/knowledge/v3_narratology/todorov1971/ideological-gradation-organizes-event-sequences.md
deleted file mode 100644
index aa876cb..0000000
--- a/docs/knowledge/v3_narratology/todorov1971/ideological-gradation-organizes-event-sequences.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# Ideological gradation organizes event sequences
-
-Source: Todorov 1971, "The 2 Principles of Narrative" (pp. 43-44), from analysis of Les Liaisons Dangereuses and Notes from the Underground
-
-Beyond succession and transformation, Todorov identifies a third organizing principle: **ideological organization** — events are arranged according to a value system, typically as a **gradation** from lesser to greater.
-
-In Dostoevsky's *Notes from the Underground*: the narrator is humiliated by Zverkov, then humiliates Lisa, then is humiliated again by his servant Apollo, and humiliates Lisa again "with still more severity." The narrative pattern is escalation through repetition — each cycle more extreme.
-
-In Laclos's *Les Liaisons Dangereuses*: "the principle of succession and the principle of transformation are equally necessary to narrative. If we had to oppose narrative and poetry (cf. épos and lyric), we would have done so... on the basis of the transformative or iterative character of the text."
-
-The **gradation principle**: events of the same type are ordered by severity, creating a pattern of escalation that is ideologically motivated. The pattern is broken "by the enunciation of a different ideology" — when a different value system interrupts the escalation.
-
-## The two laws of narrative (from Les Liaisons Dangereuses)
-
-Todorov extracts two "laws":
-1. **Escalation law**: "If the repetition of a requirement increases, the negative results increase as well" — each attempt makes things worse
-2. **Desire law** (from Adolphe): "the tragic nature of this situation results from the fact that, although obedient to the first principle [escalation], the protagonist does not therefore cease to desire" — the character can't stop wanting even when pursuit causes deterioration
-
-## What this means for tvplotlines
-
-This gives theoretical grounding to our "escalation" function — but with more precision. Escalation isn't just "stakes get higher." It's a **gradation principle**: events of the same type repeat with increasing severity.
-
-The desire law is particularly relevant for character-led plotlines (Breaking Bad, Succession): the character *knows* things are getting worse but can't stop. This is a specific pattern — not just "escalation" but "escalation despite recognition of deterioration." It could be a subcategory of our functions: `escalation_despite_recognition` or simply noted as a pattern in pass3 structural review.
-
-The ideological principle also explains why some plotlines feel like they have a "theme" beyond their events: the arrangement of events itself embodies a worldview (e.g., "power corrupts" = gradation of corruption events).
-
-## Links
-
-- [[two-principles-succession-and-transformation]]
-- [[narrative-cycle-has-three-phases-not-seven]]
-- [[bremond-semantic-labels-type-narrative-processes]]
-- [[change-in-metrics-predicts-turning-points-not-absolute-values]]
diff --git a/docs/knowledge/v3_narratology/todorov1971/narrative-clauses-have-grammar-like-sentences.md b/docs/knowledge/v3_narratology/todorov1971/narrative-clauses-have-grammar-like-sentences.md
deleted file mode 100644
index a31aa80..0000000
--- a/docs/knowledge/v3_narratology/todorov1971/narrative-clauses-have-grammar-like-sentences.md
+++ /dev/null
@@ -1,37 +0,0 @@
-# Narrative clauses have a grammar like sentences
-
-Source: Todorov 1969, "Structural Analysis of Narrative", Novel 3, pp. 70-76 (via Clarke lecture notes)
-
-Todorov proposes a deep analogy between sentence grammar and narrative structure. The minimal element of plot is a **clause** — equivalent to a sentence in language. His "schematic formulation" gives eight properties of narrative clauses:
-
-a) **Minimal plot element = clause** — the atomic unit of narrative
-b) **Each clause = agent + predicate** — the predicate is either a verb (action that modifies the situation) or an adjective/epithet (describes the current state)
-c) **Each action has positive or negative status** — success or failure, gain or loss
-d) **Each clause has modality** — indicative (actually happened) vs imperative/potential (desired, feared, possible). This distinguishes realized events from unrealized possibilities
-e) **Each clause has perspective** — whose point of view
-f) **Three types of relations between clauses**: temporal (succession), causal (entailment/presupposition), spatial (parallelism)
-g) **Clauses form sequences** — sometimes the entire narrative, sometimes part of it
-h) **Genre is distinguished by the prevailing modality** of its clauses
-
-## Two types of Decameron stories
-
-From the analysis of Boccaccio, Todorov identifies two basic plot types:
-- Stories of **punishment avoided** — a threat is escaped
-- Stories of **conversion** — a state is fundamentally changed
-
-Both are patterns of transformation, but with different structures: avoidance preserves the initial equilibrium (threat → return to safety), while conversion creates a genuinely new state (old state → new state).
-
-## What this means for tvplotlines
-
-The most actionable insight is **modality** (point d). Our events are all in the indicative — things that happened. But narratives are full of unrealized possibilities: threats that didn't materialize, plans that failed, fears that didn't come true. These "potential" events shape the narrative even though they didn't happen.
-
-In TV: "Walt considers letting Krazy-8 go" (imperative/potential) is narratively significant even though it doesn't happen. Our pipeline currently only captures what *did* happen, not what was *considered* or *feared*. Adding modality — actual vs potential — could capture this dimension.
-
-The **three types of relations** (temporal, causal, spatial) also formalize what our pipeline does implicitly: we track temporal order (episode sequence), causal order (plotline assignment implies causality), but not spatial relations (parallelism between plotlines). Our "interactions" (thematic_rhyme, convergence) are an informal version of spatial/paradigmatic relations.
-
-## Links
-
-- [[two-principles-succession-and-transformation]]
-- [[five-part-sequence-is-richer-than-three-act-structure]]
-- [[three-criteria-filter-functional-events]]
-- [[narrative-cycle-has-three-phases-not-seven]]
diff --git a/docs/knowledge/v3_narratology/todorov1971/two-principles-succession-and-transformation.md b/docs/knowledge/v3_narratology/todorov1971/two-principles-succession-and-transformation.md
deleted file mode 100644
index cbd59ab..0000000
--- a/docs/knowledge/v3_narratology/todorov1971/two-principles-succession-and-transformation.md
+++ /dev/null
@@ -1,34 +0,0 @@
-# The two principles of narrative are succession and transformation
-
-Source: Todorov 1971, "The 2 Principles of Narrative", Diacritics 1(1), pp. 37-44
-
-Todorov argues that narrative rests on two irreducible principles:
-
-**Succession** — events follow each other in time. One thing after another. This is the temporal axis: the "and then... and then..." of narrative.
-
-**Transformation** — one state changes into another. A proposition is modified. This is the causal/logical axis: something *becomes* something else.
-
-Pure succession without transformation is a chronicle — one event after another, but nothing fundamentally changes. Pure transformation without succession would be simultaneous changes — more like a tableau than a story.
-
-Narrative is the interplay of both: events succeed each other in time *and* each event transforms the situation. The interest of narrative comes from transformation; its intelligibility comes from succession.
-
-## Why this is more precise than "beginning-middle-end"
-
-The usual summary of Todorov — "equilibrium → disruption → new equilibrium" — is a simplification. His actual claim is that the fundamental narrative unit is **transformation**: the change from proposition X to proposition X'. The five-part sequence (equilibrium → disruption → recognition → repair attempt → new equilibrium) is one *pattern* of transformation, not the definition.
-
-## What this means for tvplotlines
-
-Our seven functions (setup → resolution) capture succession well — events are ordered along a timeline. But they don't explicitly capture transformation. What state changed? From what to what?
-
-Adding a **transformation** field to events — "X was A, now X is B" — would capture what Todorov considers the core of narrative. Examples:
-- "Walt strangles Krazy-8" → transformation: Walt [innocent → killer]
-- "Skyler organizes an intervention" → transformation: Family [ignoring cancer → confronting cancer]
-
-This is the same insight as Bal's "event = transition between states," but Todorov makes the *from-state* and *to-state* explicit.
-
-## Links
-
-- [[events-are-transitions-between-states]]
-- [[five-part-sequence-is-richer-than-three-act-structure]]
-- [[gnoseological-narrative-is-driven-by-knowledge-not-action]]
-- [[narrative-cycle-has-three-phases-not-seven]]
diff --git a/docs/viewer/decisions.md b/docs/viewer/decisions.md
deleted file mode 100644
index 213ee5b..0000000
--- a/docs/viewer/decisions.md
+++ /dev/null
@@ -1,48 +0,0 @@
----
-type: spec
-project: tvplotlines
-status: active
----
-
-# Standalone HTML Viewer — Design Decisions
-
-## Решённое
-
-1. **Формат** — один скачиваемый HTML-файл. Открыл в браузере — работает. Как Excel-таблица.
-2. **Функционал** — всё что есть в tvplotlines-app: грид (сюжетные линии x эпизоды), аналитика, редактирование (merge/split/edit событий и линий).
-3. **Целевая аудитория** — сценаристы 55+, минимальные технические навыки. Ноль терминала.
-4. **Безопасность данных** — данные не покидают компьютер пользователя. Никакого нашего сервера. Пользователь доверяет своему LLM (Claude/ChatGPT), но не стороннему сервису.
-5. **Онбординг** — при первом открытии HTML проигрывается демо "в реальном времени" — анимированная симуляция пайплайна на примере Breaking Bad. Проход за проходом, результаты появляются на экране. Есть кнопка "посмотреть онбординг заново".
-6. **Демо-данные** — Breaking Bad, встроены в HTML.
-7. **Связь с библиотекой** — `tvplotlines run --html` генерирует такой же HTML с результатами пользователя.
-
-8. **LLM доступ** — два варианта на выбор пользователя:
-   - **Свой API ключ** — бесплатно, вставил Claude/OpenAI ключ и работает
-   - **Через нас** — платный аккаунт (5-10 евро), логин/пароль, ничего настраивать не надо. Нужен прокси-бэкенд с нашим API ключом.
-9. **Обработка синопсисов** — прямо в HTML. Загружаешь txt-файлы, LLM обрабатывает, результат появляется в интерфейсе.
-10. **Онбординг-мастер** — пошаговый wizard при первом запуске: выбери AI → вставь ключ (с картинками-инструкциями) / или залогинься через нас.
-
-11. **Видео-онбординг "как получить API ключ"** — отдельное видео/анимация с пошаговой инструкцией.
-
-18. **Распространение** — HTML viewer живёт внутри библиотеки tvplotlines (один пакет):
-    - Для сценаристов: скачать viewer.html с сайта/GitHub (кнопка Download)
-    - Для разработчиков: `pip install tvplotlines` → `tvplotlines run --html`
-    - tvplotlines-app (FastAPI) остаётся как dev-инструмент для редактирования
-
-## Будущие фичи (не в первой версии)
-
-- **Платный аккаунт** — прокси-бэкенд, оплата, логин
-- **Screen assistant как онбординг-помощник** — AI видит экран пользователя и подсказывает что делать дальше (как Clicky, но для tvplotlines). Отдельный проект.
-
-12. **Экспорт** — три формата:
-    - XLS — таблица с гридом
-    - TXT — простой текст
-    - Final Draft (.fdx) — XML-формат, родной для сценаристов. Killer feature.
-
-13. **V1 = просмотр + экспорт**. Редактирование (merge/split/правка) — в следующей версии.
-14. **Welcome экран** — диджитальный аватар автора, машет рукой, кнопка "Play me".
-15. **Онбординг → LLM подключение** — в конце демо сразу появляется окно "подключить свой LLM" (не отдельный шаг).
-16. **Экспорт** — XLS, TXT, Final Draft (.fdx), JSON (наш формат tvplotlines).
-17. **Накопление результатов** — все обработанные сериалы сохраняются в localStorage. Можно зайти потом, переключаться между сериалами.
-
-## Открытые вопросы
diff --git a/docs/viewer/plan.md b/docs/viewer/plan.md
deleted file mode 100644
index e6124e3..0000000
--- a/docs/viewer/plan.md
+++ /dev/null
@@ -1,775 +0,0 @@
----
-type: plan
-project: tvplotlines
-status: active
----
-
-# tvplotlines Standalone HTML App — Implementation Plan
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** One downloadable HTML file that displays tvplotlines results (grid + analytics), runs the 5-pass LLM pipeline in-browser, and exports to JSON/XLS/TXT/Final Draft.
-
-**Architecture:** Single HTML file with inline CSS, JS, and demo data. No frameworks, no CDN (except SheetJS inline). All state in localStorage. LLM calls go directly from browser to Anthropic/OpenAI API.
-
-**Tech Stack:** Vanilla JS, CSS (ported from tvplotlines-app style.css), SheetJS (inline, for XLS export)
-
-**Source of truth:** Existing tvplotlines-app code — CSS, grid structure, analytics calculations, color palettes. Port, don't rewrite.
-
----
-
-## File Map
-
-All work happens in one directory: `/Users/nvashko/Projects/1-projects/tvplotlines/`
-
-| File | Purpose |
-|------|---------|
-| `src/tvplotlines/html/viewer.html` | The standalone HTML file (deliverable) |
-| `src/tvplotlines/html/build.py` | Build script: assembles viewer.html from parts + injects demo data |
-| `src/tvplotlines/html/parts/style.css` | CSS (ported from tvplotlines-app, developed separately for readability) |
-| `src/tvplotlines/html/parts/grid.js` | Grid rendering (port of grid.html Jinja2 → JS) |
-| `src/tvplotlines/html/parts/analytics.js` | Analytics rendering + calculations (port of analytics.py + analytics.html) |
-| `src/tvplotlines/html/parts/export.js` | Export: JSON, XLS, TXT, FDX |
-| `src/tvplotlines/html/parts/pipeline.js` | LLM pipeline: 5 passes, API calls, streaming |
-| `src/tvplotlines/html/parts/app.js` | Router, localStorage, onboarding, UI orchestration |
-| `src/tvplotlines/html/parts/shell.html` | HTML skeleton (all screens markup) |
-| `tests/test_html_build.py` | Tests for build script |
-| `examples/results/bb_s01.json` | Demo data (already exists) |
-
-**Why separate parts + build:** Developing in one 2MB HTML is painful. Parts are separate files during development; `build.py` concatenates them into the final `viewer.html`. The build is simple string assembly — no webpack, no bundler.
-
----
-
-## Sub-projects (in order)
-
-1. **Каркас + грид + аналитика** (Tasks 1-5) — read-only viewer with demo data
-2. **Экспорт** (Tasks 6-7) — JSON, XLS, TXT, FDX
-3. **LLM-пайплайн** (Tasks 8-10) — run pipeline in browser
-4. **Онбординг** (Tasks 11-12) — welcome screen, animated demo
-5. **CLI интеграция** (Task 13) — `tvplotlines run --html`
-
----
-
-## Task 1: Build script + HTML shell
-
-**Files:**
-- Create: `src/tvplotlines/html/build.py`
-- Create: `src/tvplotlines/html/parts/shell.html`
-- Create: `tests/test_html_build.py`
-
-- [ ] **Step 1: Write test for build script**
-
-```python
-# tests/test_html_build.py
-import subprocess
-import tempfile
-from pathlib import Path
-
-def test_build_produces_html():
-    result = subprocess.run(
-        ["python", "src/tvplotlines/html/build.py", "--output", "/tmp/test_viewer.html"],
-        capture_output=True, text=True
-    )
-    assert result.returncode == 0
-    html = Path("/tmp/test_viewer.html").read_text()
-    assert "<!DOCTYPE html>" in html
-    assert "<style>" in html
-    assert "<script>" in html
-    assert "demo-data" in html
-```
-
-- [ ] **Step 2: Run test — verify it fails**
-
-Run: `python -m pytest tests/test_html_build.py::test_build_produces_html -v`
-Expected: FAIL — file not found
-
-- [ ] **Step 3: Create shell.html**
-
-```html
-<!-- src/tvplotlines/html/parts/shell.html -->
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>tvplotlines</title>
-<style>
-/* {{STYLE}} */
-</style>
-</head>
-<body>
-  <div id="app">
-    <div id="screen-welcome" class="screen"></div>
-    <div id="screen-grid" class="screen" style="display:none"></div>
-    <div id="screen-analytics" class="screen" style="display:none"></div>
-  </div>
-  <div id="modal-container"></div>
-  <script type="application/json" id="demo-data">
-  /* {{DEMO_DATA}} */
-  </script>
-  <script>
-  /* {{APP_JS}} */
-  </script>
-</body>
-</html>
-```
-
-- [ ] **Step 4: Create build.py**
-
-```python
-# src/tvplotlines/html/build.py
-"""Assemble standalone HTML viewer from parts."""
-import argparse
-import json
-from pathlib import Path
-
-PARTS_DIR = Path(__file__).parent / "parts"
-DEMO_DATA = Path(__file__).parent.parent.parent.parent / "examples" / "results" / "bb_s01.json"
-
-def build(output_path: str, data_path: str | None = None):
-    shell = (PARTS_DIR / "shell.html").read_text()
-    style = (PARTS_DIR / "style.css").read_text() if (PARTS_DIR / "style.css").exists() else "/* placeholder */"
-
-    js_files = ["grid.js", "analytics.js", "export.js", "pipeline.js", "app.js"]
-    js_parts = []
-    for name in js_files:
-        path = PARTS_DIR / name
-        if path.exists():
-            js_parts.append(f"// --- {name} ---\n{path.read_text()}")
-        else:
-            js_parts.append(f"// --- {name} --- placeholder")
-    all_js = "\n\n".join(js_parts)
-
-    data_file = Path(data_path) if data_path else DEMO_DATA
-    demo_json = data_file.read_text() if data_file.exists() else "{}"
-
-    html = shell
-    html = html.replace("/* {{STYLE}} */", style)
-    html = html.replace("/* {{DEMO_DATA}} */", demo_json)
-    html = html.replace("/* {{APP_JS}} */", all_js)
-
-    Path(output_path).write_text(html)
-    print(f"Built: {output_path}")
-
-if __name__ == "__main__":
-    parser = argparse.ArgumentParser()
-    parser.add_argument("--output", default="viewer.html")
-    parser.add_argument("--data", default=None)
-    args = parser.parse_args()
-    build(args.output, args.data)
-```
-
-- [ ] **Step 5: Run test — verify it passes**
-
-Run: `python -m pytest tests/test_html_build.py::test_build_produces_html -v`
-Expected: PASS
-
-- [ ] **Step 6: Commit**
-
-```bash
-git add src/tvplotlines/html/ tests/test_html_build.py
-git commit -m "feat: add HTML viewer build script and shell"
-```
-
----
-
-## Task 2: CSS — port from tvplotlines-app
-
-**Files:**
-- Create: `src/tvplotlines/html/parts/style.css`
-- Reference: `/Users/nvashko/Projects/1-projects/tvplotlines-app/src/tvplotlines_app/static/style.css`
-
-- [ ] **Step 1: Copy and adapt CSS**
-
-Copy `style.css` from tvplotlines-app. Changes needed:
-- Remove HTMX-specific styles (`.htmx-indicator`, `[hx-get]` cursor rules)
-- Remove edit-mode styles (`.merge-mode`, `.split-modal`, edit modal styles) — v1 is read-only
-- Keep ALL of: color palette (light + Catppuccin Mocha dark), function colors (`fn-*`), rank badges (`rank-*`), tension variables (`--ana-tension-*`), grid layout (`.timeline-grid`, `.sticky-col`, `.sticky-top`), analytics (`.ana-*`), dark mode toggle
-- Add: screen routing (`.screen { display: none } .screen.active { display: block }`), welcome screen styles, onboarding styles
-- Per spec: "минимализм, почти олдскульный дизайн первого интернета, но чисто" — keep existing clean palette, strip decorative elements
-- VERIFY: every element must read equally well in light and dark themes
-
-- [ ] **Step 2: Build and open in browser**
-
-```bash
-python src/tvplotlines/html/build.py --output /tmp/viewer.html && open /tmp/viewer.html
-```
-
-Visually verify: dark mode toggle works, no broken colors.
-
-- [ ] **Step 3: Commit**
-
-```bash
-git add src/tvplotlines/html/parts/style.css
-git commit -m "feat: port CSS from tvplotlines-app for standalone viewer"
-```
-
----
-
-## Task 3: Grid rendering — port from tvplotlines-app
-
-**Files:**
-- Create: `src/tvplotlines/html/parts/grid.js`
-- Reference: `/Users/nvashko/Projects/1-projects/tvplotlines-app/src/tvplotlines_app/templates/partials/grid.html`
-- Reference: `/Users/nvashko/Projects/1-projects/tvplotlines-app/src/tvplotlines_app/helpers.py`
-
-- [ ] **Step 1: Write grid.js**
-
-Port the Jinja2 template to a JS function `renderGrid(data, container)` that:
-- Takes tvplotlines result JSON and a DOM container
-- Builds the `<table class="timeline-grid">` structure
-- Preserves exact class names: `event-cell`, `event-card fn-{function}`, `rank-badge rank-{rank}`, `plotline-cell`, `plotline-characters`, `guest-char`, `header-cell`, `sticky-col`, `unassigned-row`
-- Event grid lookup: pre-build `eventGrid[plotlineId][episodeCode] = [events]` map
-- Character resolution: port `resolve_character_name()` — strip `guest:` prefix, `is_guest()` check
-- Plotline sort: `RANK_ORDER = {A: 0, B: 1, C: 2, runner: 3}`
-- Click on event card → read-only detail modal (show event text, function, characters)
-- Filter bar: season dropdown, character checkboxes, function chips (client-side show/hide via CSS classes, same as existing app)
-
-Key preserved patterns from tvplotlines-app:
-- `rank.toLowerCase()` for CSS class (data has uppercase "A", CSS uses `.rank-a`)
-- `fn-${ev.function}` class directly from data values
-- Guest characters: `c.startsWith('guest:')` → italic styling
-
-- [ ] **Step 2: Create minimal app.js for testing**
-
-```javascript
-// src/tvplotlines/html/parts/app.js
-const demoData = JSON.parse(document.getElementById('demo-data').textContent);
-
-function showScreen(name) {
-  document.querySelectorAll('.screen').forEach(s => s.classList.remove('active'));
-  document.getElementById('screen-' + name).classList.add('active');
-}
-
-// Dark mode toggle — preserved from tvplotlines-app
-function toggleDark() {
-  document.documentElement.classList.toggle('dark');
-  localStorage.setItem('theme',
-    document.documentElement.classList.contains('dark') ? 'dark' : 'light');
-}
-
-// Init
-(function init() {
-  if (localStorage.getItem('theme') === 'dark') {
-    document.documentElement.classList.add('dark');
-  }
-  renderGrid(demoData, document.getElementById('screen-grid'));
-  showScreen('grid');
-})();
-```
-
-- [ ] **Step 3: Build and test visually**
-
-```bash
-python src/tvplotlines/html/build.py --output /tmp/viewer.html && open /tmp/viewer.html
-```
-
-Verify: grid displays Breaking Bad data, colors match tvplotlines-app, sticky columns work, filters work, dark mode preserves readability.
-
-- [ ] **Step 4: Commit**
-
-```bash
-git add src/tvplotlines/html/parts/grid.js src/tvplotlines/html/parts/app.js
-git commit -m "feat: port grid rendering from tvplotlines-app to standalone JS"
-```
-
----
-
-## Task 4: Analytics rendering — port from tvplotlines-app
-
-**Files:**
-- Create: `src/tvplotlines/html/parts/analytics.js`
-- Reference: `/Users/nvashko/Projects/1-projects/tvplotlines-app/src/tvplotlines_app/analytics.py`
-- Reference: `/Users/nvashko/Projects/1-projects/tvplotlines-app/src/tvplotlines_app/templates/analytics.html`
-
-- [ ] **Step 1: Write analytics.js**
-
-Two parts:
-
-**A) Computation** — port `analytics.py` to JS:
-- `FUNCTION_TENSION = {resolution: 0.5, setup: 1, seed: 1, escalation: 2, turning_point: 3, climax: 4, cliffhanger: 4}`
-- `RANK_ORDER = {A: 0, B: 1, C: 2, runner: 3}`
-- `computeScorecard(data)` — plotlines with span dots, event counts, arc summaries
-- `computeArcMap(data)` — episodes × plotlines tension grid. Tension level thresholds: `≤1.2→1, ≤2.0→2, ≤2.8→3, ≤3.5→4, else→5`
-- `computePulse(data)` — per-episode stacked bars
-- `computeConvergence(data)` — interaction timeline
-- `computeCharacters(data)` — character event counts, filter `count < 2`
-- Arc summary: dominant function at 40% threshold, priority order `["climax", "crisis", "turning_point"]`
-
-**B) Rendering** — port `analytics.html` Jinja2 to JS:
-- `renderAnalytics(data, container)` builds all 5 sections
-- Preserve exact CSS classes: `ana-scorecard`, `ana-span-bar`, `ana-span-dot`, `ana-arcmap`, `ana-tension-cell`, `ana-pulse-bar`, `ana-conv-type ana-conv-{type}`, `ana-char-bar`
-- Arc map: `grid-template-columns: 140px repeat(N, 1fr)`, circle size `16 + (28 * events / maxEvents)`
-- Pulse: bar width `total / maxTotal * 100`%
-- Character: bar width `count / maxCount * 100`%
-
-- [ ] **Step 2: Add analytics navigation to app.js**
-
-Add toolbar button "Analytics" that calls `renderAnalytics(demoData, container)` and switches screen. Add "Grid" button on analytics screen.
-
-- [ ] **Step 3: Build and test visually**
-
-```bash
-python src/tvplotlines/html/build.py --output /tmp/viewer.html && open /tmp/viewer.html
-```
-
-Verify: all 5 analytics sections render, arc map colors match tension levels, dark mode works on all elements.
-
-- [ ] **Step 4: Commit**
-
-```bash
-git add src/tvplotlines/html/parts/analytics.js
-git commit -m "feat: port analytics from tvplotlines-app to standalone JS"
-```
-
----
-
-## Task 5: Router + localStorage + toolbar
-
-**Files:**
-- Modify: `src/tvplotlines/html/parts/app.js`
-- Modify: `src/tvplotlines/html/parts/shell.html`
-
-- [ ] **Step 1: Implement localStorage manager**
-
-```javascript
-const Store = {
-  getKey: () => localStorage.getItem('tvplotlines_api_key'),
-  setKey: (provider, key) => {
-    localStorage.setItem('tvplotlines_provider', provider);
-    localStorage.setItem('tvplotlines_api_key', key);
-  },
-  getResults: () => JSON.parse(localStorage.getItem('tvplotlines_results') || '{}'),
-  saveResult: (name, data) => {
-    const results = Store.getResults();
-    results[name] = data;
-    localStorage.setItem('tvplotlines_results', JSON.stringify(results));
-  },
-  getSettings: () => JSON.parse(localStorage.getItem('tvplotlines_settings') || '{}'),
-  saveSetting: (key, val) => {
-    const s = Store.getSettings();
-    s[key] = val;
-    localStorage.setItem('tvplotlines_settings', JSON.stringify(s));
-  },
-  hasSeenOnboarding: () => localStorage.getItem('tvplotlines_onboarding_seen') === 'true',
-  markOnboardingSeen: () => localStorage.setItem('tvplotlines_onboarding_seen', 'true'),
-};
-```
-
-- [ ] **Step 2: Implement toolbar in shell.html**
-
-Toolbar with: series dropdown, Grid/Analytics tabs, export buttons, dark mode toggle, "Load synopses" button, "Onboarding" button, "LLM settings" button.
-
-- [ ] **Step 3: Implement series switching**
-
-Series dropdown populated from `Store.getResults()` + demo data. Switching re-renders grid and analytics.
-
-- [ ] **Step 4: Build and test**
-
-```bash
-python src/tvplotlines/html/build.py --output /tmp/viewer.html && open /tmp/viewer.html
-```
-
-Verify: navigation works, dark mode persists across reload, series switching re-renders.
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/tvplotlines/html/parts/app.js src/tvplotlines/html/parts/shell.html
-git commit -m "feat: add router, localStorage, toolbar for standalone viewer"
-```
-
----
-
-## Task 6: Export — JSON, XLS, TXT
-
-**Files:**
-- Create: `src/tvplotlines/html/parts/export.js`
-
-- [ ] **Step 1: JSON export**
-
-```javascript
-function exportJSON(data, filename) {
-  const blob = new Blob([JSON.stringify(data, null, 2)], {type: 'application/json'});
-  downloadBlob(blob, filename + '.json');
-}
-
-function downloadBlob(blob, filename) {
-  const a = document.createElement('a');
-  a.href = URL.createObjectURL(blob);
-  a.download = filename;
-  a.click();
-  URL.revokeObjectURL(a.href);
-}
-```
-
-- [ ] **Step 2: TXT export**
-
-Structured text: series name, then per-episode sections with plotline events.
-
-- [ ] **Step 3: XLS export with SheetJS**
-
-Include SheetJS (xlsx.mini.min.js) inline. Build workbook with two sheets: "Events" (flat table) and "Plotlines" (summary).
-
-- [ ] **Step 4: Wire export buttons in toolbar**
-
-- [ ] **Step 5: Build, test all 3 exports**
-
-```bash
-python src/tvplotlines/html/build.py --output /tmp/viewer.html && open /tmp/viewer.html
-```
-
-Download each format, verify contents.
-
-- [ ] **Step 6: Commit**
-
-```bash
-git add src/tvplotlines/html/parts/export.js
-git commit -m "feat: add JSON, TXT, XLS export"
-```
-
----
-
-## Task 7: Export — Final Draft (.fdx)
-
-**Files:**
-- Modify: `src/tvplotlines/html/parts/export.js`
-
-- [ ] **Step 1: Research FDX format**
-
-FDX is XML. Root: `<FinalDraft DocumentType="Script" Version="6">`. Key elements:
-- `<Content>` wraps `<Paragraph>` elements
-- `<Paragraph Type="Action">` for beats/events
-- `<Paragraph Type="Scene Heading">` for episode markers
-- `<Text>` inside `<Paragraph>` for actual text
-
-- [ ] **Step 2: Implement FDX export**
-
-```javascript
-function exportFDX(data, filename) {
-  let xml = '<?xml version="1.0" encoding="UTF-8"?>\n';
-  xml += '<FinalDraft DocumentType="Script" Template="No" Version="6">\n';
-  xml += '<Content>\n';
-
-  for (const ep of data.episodes) {
-    // Episode heading
-    xml += `<Paragraph Type="Scene Heading"><Text>${escapeXml(ep.episode + ' — ' + ep.theme)}</Text></Paragraph>\n`;
-
-    // Group events by plotline
-    for (const pl of data.plotlines) {
-      const events = ep.events.filter(e => e.storyline === pl.id);
-      if (events.length === 0) continue;
-      xml += `<Paragraph Type="Action"><Text Font="Bold">${escapeXml(pl.name)} [${pl.rank}]</Text></Paragraph>\n`;
-      for (const ev of events) {
-        xml += `<Paragraph Type="Action"><Text>[${ev.function}] ${escapeXml(ev.event)}</Text></Paragraph>\n`;
-      }
-    }
-  }
-
-  xml += '</Content>\n</FinalDraft>';
-  const blob = new Blob([xml], {type: 'application/xml'});
-  downloadBlob(blob, filename + '.fdx');
-}
-
-function escapeXml(s) {
-  return s.replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
-}
-```
-
-- [ ] **Step 3: Test — open in Final Draft or text editor**
-
-- [ ] **Step 4: Commit**
-
-```bash
-git add src/tvplotlines/html/parts/export.js
-git commit -m "feat: add Final Draft .fdx export"
-```
-
----
-
-## Task 8: LLM pipeline — API client
-
-**Files:**
-- Create: `src/tvplotlines/html/parts/pipeline.js`
-- Reference: `src/tvplotlines/prompts_en/pass0.md` through `pass4.md`
-
-- [ ] **Step 1: Implement API client**
-
-```javascript
-async function callLLM(systemPrompt, userMessage, provider, apiKey, onChunk) {
-  if (provider === 'anthropic') {
-    return callAnthropic(systemPrompt, userMessage, apiKey, onChunk);
-  } else {
-    return callOpenAI(systemPrompt, userMessage, apiKey, onChunk);
-  }
-}
-
-async function callAnthropic(systemPrompt, userMessage, apiKey, onChunk) {
-  const resp = await fetch('https://api.anthropic.com/v1/messages', {
-    method: 'POST',
-    headers: {
-      'x-api-key': apiKey,
-      'anthropic-version': '2023-06-01',
-      'anthropic-dangerous-direct-browser-access': 'true',
-      'content-type': 'application/json',
-    },
-    body: JSON.stringify({
-      model: 'claude-sonnet-4-20250514',
-      max_tokens: 16384,
-      system: systemPrompt,
-      messages: [{role: 'user', content: userMessage}],
-      stream: true,
-    }),
-  });
-  // Parse SSE stream, call onChunk for progress, return full text
-  // ... (full SSE parsing implementation)
-}
-```
-
-- [ ] **Step 2: Test with real API key**
-
-Build, open HTML, enter API key, verify a simple test call works.
-
-- [ ] **Step 3: Commit**
-
-```bash
-git add src/tvplotlines/html/parts/pipeline.js
-git commit -m "feat: add LLM API client for browser (Anthropic + OpenAI)"
-```
-
----
-
-## Task 9: LLM pipeline — 5 passes
-
-**Files:**
-- Modify: `src/tvplotlines/html/parts/pipeline.js`
-- Reference: `src/tvplotlines/prompts_en/pass0.md` through `pass4.md`, `glossary.md`
-
-- [ ] **Step 1: Embed prompts**
-
-Read all prompt files from `src/tvplotlines/prompts_en/`. Embed as JS string constants in pipeline.js. Replace `{GLOSSARY}` placeholder with glossary content at build time.
-
-- [ ] **Step 2: Implement 5-pass orchestrator**
-
-```javascript
-async function runPipeline(synopses, seriesName, provider, apiKey, onProgress) {
-  onProgress('Pass 1/5: extracting characters...');
-  const pass0Result = await runPass0(synopses, provider, apiKey);
-
-  onProgress('Pass 2/5: identifying plotlines...');
-  const pass1Result = await runPass1(synopses, pass0Result, provider, apiKey);
-
-  // ... passes 2-4, each building on previous results
-
-  onProgress('Done!');
-  return finalResult;
-}
-```
-
-Each pass: build user message from synopses + previous results, call LLM, parse JSON response.
-
-- [ ] **Step 3: Implement file upload UI**
-
-Drag & drop zone + file picker button. Read .txt files via FileReader API. Parse filenames for episode codes (e.g., `S01E01.txt`).
-
-- [ ] **Step 4: Wire pipeline to UI**
-
-Upload files → show progress bar → run pipeline → save to localStorage → render grid.
-
-- [ ] **Step 5: Test end-to-end with real API key and sample synopses**
-
-- [ ] **Step 6: Commit**
-
-```bash
-git add src/tvplotlines/html/parts/pipeline.js
-git commit -m "feat: port 5-pass LLM pipeline to browser JS"
-```
-
----
-
-## Task 10: LLM settings modal
-
-**Files:**
-- Modify: `src/tvplotlines/html/parts/app.js`
-- Modify: `src/tvplotlines/html/parts/shell.html`
-
-- [ ] **Step 1: Implement settings modal**
-
-- Provider selector: Claude / OpenAI buttons
-- API key field (password type, show/hide toggle)
-- Step-by-step instructions with screenshots placeholder (links to external video)
-- "Save" stores to localStorage
-- "Skip" closes modal
-
-- [ ] **Step 2: Show on first use**
-
-If no API key in localStorage and not skipped → show after welcome/onboarding.
-
-- [ ] **Step 3: Add "LLM Settings" button to toolbar**
-
-- [ ] **Step 4: Build and test**
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/tvplotlines/html/parts/app.js src/tvplotlines/html/parts/shell.html
-git commit -m "feat: add LLM settings modal with provider selection"
-```
-
----
-
-## Task 11: Welcome screen
-
-**Files:**
-- Modify: `src/tvplotlines/html/parts/app.js`
-- Modify: `src/tvplotlines/html/parts/shell.html`
-- Modify: `src/tvplotlines/html/parts/style.css`
-
-- [ ] **Step 1: Implement welcome screen**
-
-- Japanese minimalism background
-- "Play me" button (centered)
-- "Skip →" in appropriate position
-- If `Store.hasSeenOnboarding()` → skip directly to grid
-
-- [ ] **Step 2: Update init logic**
-
-```javascript
-(function init() {
-  // Theme
-  if (localStorage.getItem('theme') === 'dark') {
-    document.documentElement.classList.add('dark');
-  }
-  // Route
-  if (!Store.hasSeenOnboarding()) {
-    showScreen('welcome');
-  } else {
-    loadLastSeries();
-    showScreen('grid');
-  }
-})();
-```
-
-- [ ] **Step 3: Build and test**
-
-- [ ] **Step 4: Commit**
-
-```bash
-git add src/tvplotlines/html/parts/
-git commit -m "feat: add welcome screen with Play me button"
-```
-
----
-
-## Task 12: Onboarding animation
-
-**Files:**
-- Modify: `src/tvplotlines/html/parts/app.js`
-- Modify: `src/tvplotlines/html/parts/style.css`
-
-- [ ] **Step 1: Implement onboarding sequence**
-
-Coded animation on real app screens (not video):
-
-```javascript
-async function runOnboarding() {
-  // 1. Welcome screen → skip button animates click
-  await animateClick('skip');
-  await delay(500);
-
-  // 2. LLM modal appears → Claude selected → key typed
-  showLLMModal();
-  await delay(1000);
-  await animateSelect('claude');
-  await animateTyping('api-key-input', 'sk-ant-•••••••••');
-  await animateClick('save-key');
-  await delay(500);
-
-  // 3. File upload zone appears → files appear
-  await delay(500);
-  await animateFileDrop(['S01E01.txt', 'S01E02.txt', 'S01E03.txt']);
-  await delay(500);
-
-  // 4. Pipeline runs — progress shows passes 1-5
-  for (let i = 1; i <= 5; i++) {
-    showProgress(`Pass ${i}/5: ${passNames[i]}...`);
-    await delay(1500);
-    // Reveal corresponding parts of the grid gradually
-    revealGridPass(i, demoData);
-  }
-
-  // 5. Show analytics tab
-  await delay(1000);
-  await animateClick('analytics-tab');
-  await delay(2000);
-
-  // 6. Show export buttons
-  await animateHighlight('export-buttons');
-  await delay(1500);
-
-  // 7. End — show "Connect your LLM" modal
-  Store.markOnboardingSeen();
-  showLLMModal();
-}
-```
-
-- [ ] **Step 2: Add animation helpers**
-
-`animateClick`, `animateTyping`, `animateFileDrop`, `animateHighlight`, `revealGridPass` — CSS transitions + JS timeouts. Subtitles/tooltips appear alongside each step.
-
-- [ ] **Step 3: Add "Watch onboarding" button to menu**
-
-Resets `tvplotlines_onboarding_seen` and replays.
-
-- [ ] **Step 4: Build and test full onboarding flow**
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/tvplotlines/html/parts/
-git commit -m "feat: add coded onboarding animation with Breaking Bad demo"
-```
-
----
-
-## Task 13: CLI integration — `tvplotlines run --html`
-
-**Files:**
-- Modify: `src/tvplotlines/cli.py`
-- Modify: `src/tvplotlines/html/build.py`
-
-- [ ] **Step 1: Add --html flag to CLI**
-
-In `cli.py`, add `--html` option to the `run` command. After pipeline completes, if `--html` is set, call `build.py` with the result JSON.
-
-- [ ] **Step 2: Implement in build.py**
-
-`build(output_path, data_path)` already accepts custom data. CLI passes result JSON path.
-
-- [ ] **Step 3: Test end-to-end**
-
-```bash
-tvplotlines run examples/synopses/bb/ --html --output bb_viewer.html
-open bb_viewer.html
-```
-
-Verify: HTML opens with user's data instead of demo.
-
-- [ ] **Step 4: Commit**
-
-```bash
-git add src/tvplotlines/cli.py src/tvplotlines/html/build.py
-git commit -m "feat: add --html flag to CLI for standalone viewer export"
-```
-
----
-
-## Cross-file consistency checklist
-
-- [ ] `FUNCTION_TENSION` values identical in `analytics.js` and original `analytics.py`
-- [ ] Tension level thresholds (≤1.2→1, etc.) identical in `analytics.js` and original template
-- [ ] CSS class names (`fn-*`, `rank-*`, `ana-*`) identical in `style.css` and JS rendering
-- [ ] `RANK_ORDER` identical in `grid.js` and `analytics.js`
-- [ ] Dark mode: every element readable in both themes
-- [ ] Guest character detection: `guest:` prefix handling identical to `helpers.py`
-- [ ] Demo data (`bb_s01.json`) loads correctly and matches grid rendering
diff --git a/docs/viewer/spec.md b/docs/viewer/spec.md
deleted file mode 100644
index 481841b..0000000
--- a/docs/viewer/spec.md
+++ /dev/null
@@ -1,154 +0,0 @@
----
-type: spec
-project: tvplotlines
-status: active
----
-
-# tvplotlines Standalone HTML App — Spec
-
-## Суть
-
-Один скачиваемый HTML-файл — полноценное приложение для анализа сюжетных линий сериалов. Открыл в браузере — работает. Ноль установки, данные не покидают компьютер.
-
-## Целевая аудитория
-
-Сценаристы 55+, минимальные технические навыки. Не пользуются терминалом. Боятся отдавать сценарии сторонним сервисам, но доверяют своему LLM (Claude/ChatGPT).
-
-## Пользовательский flow
-
-### Первый запуск
-
-1. ПЕРВЫЙ РАЗ Открыл HTML → **Welcome-экран**: кнопка "Play me". В углу "Skip".
-2. Нажал Play → **Онбординг-демо**: анимированная симуляция пайплайна на Breaking Bad. Проходы появляются один за другим, грид заполняется в реальном времени. Пользователь видит как работает инструмент.
-3. В конце демо → **"Подключить свой LLM"**: выбор Claude / OpenAI, поле для API ключа, инструкция со скриншотами + ссылка на видео "Как получить АПИ Клод/ОпенИИ - чье-то найти". Кнопка "Пропустить" — остаться на демо-данных.
-4. После подключения (или пропуска) → **Рабочий экран**: грид с данными Breaking Bad.
-
-### Повторный визит
-
-- API ключ уже в localStorage — не спрашивает
-- Последние результаты сохранены — открывается на том же месте
-- Меню: "Посмотреть онбординг", "Настройки LLM", "Загрузить синопсисы"
-
-### Работа со своими данными
-
-1. Drag & drop txt-файлов синопсисов (или кнопка "Выбрать файлы")
-2. Прогресс: "Проход 1/5: извлекаю персонажей..."
-3. Результат появляется в гриде
-4. Результат автоматически сохраняется в localStorage
-
-### Накопление
-
-- Все обработанные сериалы сохраняются в localStorage
-- Dropdown для переключения между сериалами
-- Можно зайти через неделю — всё на месте
-
-## Экраны
-
-### Welcome
-
-- Фон: японский минимализм
-- Кнопка "Play me" — запускает онбординг
-- "Skip →" в правильном месте для такой фукнции
-
-### Онбординг-демо
-
-Кодированная анимация на реальных экранах приложения (не видео):
-
-1. Skip-экран с кнопкой → нажимается
-2. Появляется окно "выбери LLM" → выбирается Claude (чередовать Claude/OpenAI рандомно?)
-3. Вставляется ключ (анимация набора)
-4. Появляется зона загрузки файлов → один файл через кнопку, второй drag & drop
-5. Запускается пайплайн — прогресс проходов 1-5, грид заполняется в реальном времени
-6. Результат: грид, аналитика, экспорт — показываем каждую фичу
-7. Всё озвучено подписями/тултипами (не аудио)
-
-### Подключение LLM
-
-- Модальное окно поверх грида с демо-данными
-- Две кнопки: Claude / OpenAI
-- По выбору: поле для API ключа + пошаговая инструкция (3 шага со скриншотами)
-- Ссылка на видео "как получить ключ"
-- Ключ сохраняется в localStorage
-- "Пропустить" — закрывает окно, работаешь с демо-данными
-
-### Рабочий экран — Грид
-
-Из tvplotlines-app:
-- Toolbar: название сериала, dropdown выбора сериала, кнопки экспорта, dark mode toggle
-- Фильтры: сезон, персонажи, функции событий
-- Таблица: сюжетные линии (ряды) x эпизоды (колонки)
-- Первая колонка sticky: имя линии, ранг (A/B/C), персонаж-драйвер
-- Ячейки: карточки событий, цвет по функции (setup серый, climax красный, resolution зелёный...)
-- Клик по карточке: модальное окно с деталями события (read-only в v1)
-
-### Рабочий экран — Аналитика
-
-Из tvplotlines-app:
-- Season scorecard: таблица с span-bar
-- Arc map: тепловая карта напряжения
-- Episode pulse: stacked bars
-- Convergence moments: таймлайн взаимодействий линий
-- Character weight: горизонтальные бары
-
-## Экспорт
-
-Четыре формата, кнопки в toolbar:
-
-1. **JSON** — наш формат tvplotlines, тот же что генерирует библиотека. Для импорта обратно.
-2. **XLS** — таблица: строки = события, колонки = эпизод, сюжетная линия, функция, персонажи, текст. Библиотека SheetJS (inline).
-3. **TXT** — plain text, структурированный по эпизодам и линиям.
-4. **Final Draft (.fdx)** — XML-формат Final Draft. Outline с beat board: каждая сюжетная линия = storyline, каждое событие = beat с функцией и описанием.
-
-## Техническая архитектура
-
-### Один HTML-файл содержит:
-
-- `<style>` — минимализм, почти олдскульный дизайн первого интернета, но чисто без нарочитой аналоговости, темная тема обязательно должна быть, проверить чтобы ВСЕ элементы ОДИНАКОВО читались и работали при переключении темы с темной на светлую и наоборот
-- `<script>` — весь JS:
-  - Онбординг-анимация (таймеры, поэтапное появление)
-  - LLM-пайплайн (5 проходов, промпты из tvplotlines, fetch + SSE streaming)
-  - Грид-рендеринг
-  - Аналитика-рендеринг
-  - Экспорт (SheetJS inline для XLS, XML-генерация для .fdx)
-  - localStorage менеджер (ключ, результаты, настройки)
-  - Router (Welcome / Grid / Analytics — переключение через JS, без перезагрузки)
-- `<script type="application/json" id="demo-data">` — Breaking Bad S01 результат
-- HTML-разметка всех экранов
-
-### LLM-пайплайн в браузере
-
-Порт 5 проходов tvplotlines из Python в JS:
-- Промпты — те же самые (копируются из библиотеки)
-- Формат JSON — тот же
-- API вызов — fetch напрямую к api.anthropic.com или api.openai.com
-- Стриминг — SSE для прогресса
-- CORS: Anthropic API поддерживает browser requests с API ключом в заголовке
-
-### Хранение данных
-
-localStorage:
-- `tvplotlines_api_key` — зашифрованный API ключ
-- `tvplotlines_provider` — "anthropic" | "openai"
-- `tvplotlines_results` — объект {series_name: result_json}
-- `tvplotlines_settings` — dark mode, последний открытый сериал
-- `tvplotlines_onboarding_seen` — boolean
-
-### Зависимости (всё inline)
-
-- SheetJS (для XLS экспорта) — ~200KB минифицированный
-- Никаких CDN, никаких внешних запросов кроме LLM API
-
-## Связь с библиотекой tvplotlines
-
-`tvplotlines run my-series/ --html` генерирует этот же HTML с данными пользователя вместо Breaking Bad. Пайплайн уже выполнен на стороне Python, HTML используется только для просмотра и экспорта.
-
-## Размер файла
-
-~1-2 MB (SheetJS ~200KB + CSS ~15KB + JS ~100KB + демо-данные ~50KB + онбординг-ассеты).
-
-## Чего НЕ делаем в v1
-
-- Редактирование (merge/split/правка событий)
-- Платный аккаунт (прокси-бэкенд)
-- Screen assistant как онбординг-помощник
-- Мультиязычность интерфейса

From ac07ddab622b1a0d532fd94e9cbf93944de8b090 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Wed, 15 Apr 2026 11:57:09 +0200
Subject: [PATCH 18/24] docs: sync docs/ with the current code (hollywood +
 narratology)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- api.md: get_plotlines signature gains `system`, `skip_review`,
  `base_url`, `suggested_plotlines`; new system-comparison table;
  Plotline gets reviewed_rank/computed_rank/nature/confidence,
  Event gets plot_fn; full CLI flag table for run + write-synopses
- quickstart.md: --system and --html flags, standalone-viewer section
  with "Analyze a series" flow, system switch in Python example
- index.md: mentions standalone viewer + layered-schema link
- formulas.md: Pass 4 section (was missing), narratology pipeline
  section at the end documenting all six passes and the actant ↔
  hero/goal/obstacle/stakes mapping

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 docs/api.md        | 149 ++++++++++++++++++++++++++++++++++-----------
 docs/formulas.md   |  65 ++++++++++++++++++++
 docs/index.md      |  12 +++-
 docs/quickstart.md |  48 ++++++++++++++-
 4 files changed, 235 insertions(+), 39 deletions(-)

diff --git a/docs/api.md b/docs/api.md
index 49b64ab..839bb9f 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -2,7 +2,7 @@
 
 ## get_plotlines()
 
-Main entry point. Extracts plotlines from a season of TV synopses using LLM.
+Main entry point. Extracts plotlines from a season of TV synopses via an LLM pipeline.
 
 ```python
 from tvplotlines import get_plotlines
@@ -15,33 +15,48 @@ result = get_plotlines(
         "S01E02": "A teenage swimmer collapses...",
         # ...
     },
+    system="hollywood",          # "hollywood" (default) | "narratology"
     prior=None,                  # TVPlotlinesResult from previous season
     llm_provider="anthropic",    # "anthropic" | "openai" | "ollama" | "deepseek" | "groq" | any OpenAI-compatible
     model=None,                  # specific model or provider default
-    pass2_mode="batch",          #  "batch" | "parallel" | "sequential"
-    batch_id=None,               # resume batch by ID
-    context=None,                # SeriesContext or auto-detect
-    cast=None,                   # provide both cast + plotlines to skip Pass 1
-    plotlines=None,              # provide both cast + plotlines to skip Pass 1
-    breakdowns=None,             # pre-assigned events per episode to skip Pass 2
+    base_url=None,               # override endpoint (for Ollama, Together, etc.)
+    pass2_mode="batch",          # "batch" | "parallel" | "sequential" (hollywood only)
+    batch_id=None,               # resume a batch by ID
+    context=None,                # SeriesContext or auto-detect (skips Pass 0)
+    cast=None,                   # provide cast + plotlines to skip Pass 1
+    plotlines=None,
+    breakdowns=None,             # pre-assigned events to skip Pass 2
+    suggested_plotlines=None,    # seed from write-synopses output
+    skip_review=False,           # skip the structural-review pass
     callback=None,               # PipelineCallback subclass
 )
 ```
 
+### Analysis systems
+
+| System | Passes | Model | Plotline shape emitted |
+|--------|--------|-------|------------------------|
+| `hollywood` (default) | 5 (0→1→2→3→4) | Story DNA + Freytag's seven functions | `hero`, `goal`, `obstacle`, `stakes` |
+| `narratology` | 6 (context→fabula→actants→story→arc→review) | Bal/Todorov/Greimas/Bremond — actant model | Actants map onto `hero`, `goal`, `obstacle`, `stakes` so the return type stays identical |
+
+Both systems return the same `TVPlotlinesResult`, so downstream tools (the HTML viewer, exports) work unchanged either way.
+
 ### Multi-season processing
 
 Pass the result of the previous season to maintain character and plotline ID continuity:
 
 ```python
 r1 = get_plotlines("Breaking Bad", 1, {"S01E01": "...", "S01E02": "...", ...})
-r2 = get_plotlines("Breaking Bad", 2, {"S02E01": "...", "S02E02": "...", ...}, prior=r1)
-r3 = get_plotlines("Breaking Bad", 3, {"S03E01": "...", "S03E02": "...", ...}, prior=r2)
+r2 = get_plotlines("Breaking Bad", 2, {"S02E01": "...", ...}, prior=r1)
+r3 = get_plotlines("Breaking Bad", 3, {"S03E01": "...", ...}, prior=r2)
 ```
 
 When `prior` is provided:
+
 - Pass 0 is skipped (reuses `prior.context`)
 - Pass 1 receives prior cast and plotlines, reusing IDs for continuing characters and plotlines
 - Not supported for anthology format (anthology seasons are independent by definition)
+- Currently wired for the `hollywood` system; `narratology` treats each season independently in this release
 
 ## TVPlotlinesResult
 
@@ -49,42 +64,66 @@ Returned by `get_plotlines()`.
 
 | Field       | Type                     | Description                                               |
 | ----------- | ------------------------ | --------------------------------------------------------- |
-| `context`   | `SeriesContext`          | Detected series context (format, story engine)            |
+| `context`   | `SeriesContext`          | Detected series context (format, story engine, genre)     |
 | `cast`      | `list[CastMember]`       | Main cast members assigned to plotlines                   |
 | `plotlines` | `list[Plotline]`         | Discovered plotlines                                      |
 | `episodes`  | `list[EpisodeBreakdown]` | Per-episode breakdowns with events assigned to plotlines  |
+| `usage`     | `str`                    | Human-readable token usage summary                        |
 
 ## Data models
 
 ### Plotline
 
-A narrative thread with Story DNA:
-
-| Field      | Type        | Description                                         |
-| ---------- | ----------- | --------------------------------------------------- |
-| `id`       | `str`       | Unique plotline identifier                          |
-| `name`     | `str`       | e.g. "Walt: Empire"                                 |
-| `hero`     | `str`       | Character who drives the plotline                   |
-| `goal`     | `str`       | What the driver wants                               |
-| `obstacle` | `str`       | What stands in the way                              |
-| `stakes`   | `str`       | What happens if the driver fails                    |
-| `rank`     | `str`       | A (main), B (secondary), C (tertiary), runner       |
-| `type`     | `str`       | case_of_the_week, serialized, runner                |
-| `span`     | `list[str]` | Which episodes it appears in (computed from events) |
+A narrative thread. Actant fields (narratology) land in the same slots:
+
+| Field            | Type        | Description                                             |
+| ---------------- | ----------- | ------------------------------------------------------- |
+| `id`             | `str`       | Unique plotline identifier                              |
+| `name`           | `str`       | e.g. "Walt: Empire"                                     |
+| `hero`           | `str`       | Character who drives it (narratology: `who_chases`)     |
+| `goal`           | `str`       | What the driver wants (narratology: `what_they_chase`)  |
+| `obstacle`       | `str`       | What stands in the way (narratology: `stands_in_the_way` joined, or `bigger_force`) |
+| `stakes`         | `str`       | What happens if the driver fails / who wins if it works |
+| `rank`           | `str`       | A (main), B (secondary), C (tertiary); None for runners |
+| `computed_rank`  | `str`       | Rank from event counts (code-assigned)                  |
+| `reviewed_rank`  | `str\|None` | Rank from the review pass, if it disagrees              |
+| `type`           | `str`       | `case_of_the_week` / `serialized` / `runner`            |
+| `nature`         | `str`       | `plot-led` / `character-led` / `theme-led`              |
+| `confidence`     | `str`       | `solid` / `partial` / `inferred`                        |
+| `span`           | `list[str]` | Episodes where the plotline appears (computed)          |
 
 ### Event
 
 A single narrative beat within an episode:
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `event` | `str` | What happens |
-| `plotline_id` | `str` | Which plotline it belongs to |
-| `function` | `str` | setup, inciting_incident, escalation, turning_point, crisis, climax, resolution |
-| `characters` | `list[str]` | Who is involved |
-| `also_affects` | `list[str] \| None` | Secondary plotline connections |
+| Field           | Type                | Description |
+|-----------------|---------------------|-------------|
+| `event`         | `str`               | What happens |
+| `plotline_id`   | `str \| None`       | Which plotline it belongs to (None for orphans) |
+| `function`      | `str`               | Episode-level role: `setup`, `inciting_incident`, `escalation`, `turning_point`, `crisis`, `climax`, `resolution` (narratology adds `recognition`) |
+| `plot_fn`       | `str \| None`       | Season-level arc function; may differ from `function` — narratology's "texture" events leave it `None` |
+| `characters`    | `list[str]`         | Cast IDs involved |
+| `also_affects`  | `list[str] \| None` | Secondary plotline connections |
+
+### SeriesContext
+
+| Field         | Type   | Description                                                |
+|---------------|--------|------------------------------------------------------------|
+| `format`      | `str`  | `procedural` / `serial` / `hybrid` / `ensemble`            |
+| `story_engine`| `str`  | One-sentence logline (narratology: also includes `breach`) |
+| `genre`       | `str`  | Free-text genre                                            |
+| `is_anthology`| `bool` | True for seasons-independent shows (True Detective, Fargo) |
+
+### EpisodeBreakdown
+
+| Field          | Type                 | Description |
+|----------------|----------------------|-------------|
+| `episode`      | `str`                | `S01E03` |
+| `events`       | `list[Event]`        | In screen order |
+| `theme`        | `str`                | One-sentence episode theme |
+| `interactions` | `list[Interaction]`  | Between plotlines active this episode |
 
-## Pass 2 modes
+## Pass 2 modes (hollywood only)
 
 | Mode         | Speed | Cost       | Use case                                                 |
 | ------------ | ----- | ---------- | -------------------------------------------------------- |
@@ -92,6 +131,8 @@ A single narrative beat within an episode:
 | `parallel`   | Fast  | Full price | All episodes at once via async                           |
 | `sequential` | Slow  | Full price | One episode at a time — for debugging                    |
 
+Narratology runs its per-episode passes (fabula, story) in `parallel` mode unconditionally.
+
 ## LLM providers
 
 tvplotlines works with Anthropic (default) and any OpenAI-compatible API.
@@ -117,6 +158,9 @@ tvplotlines run house/ --provider deepseek
 tvplotlines run house/ --provider openai \
     --base-url https://api.together.xyz/v1 \
     --model meta-llama/Llama-3-70b
+
+# Pick the analysis system
+tvplotlines run house/ --system narratology
 ```
 
 In Python:
@@ -125,12 +169,49 @@ In Python:
 result = get_plotlines(
     show="House", season=1,
     episodes={"S01E01": "synopsis...", "S01E02": "synopsis..."},
-    llm_provider="ollama",           # or "deepseek", "groq", etc.
-    model="qwen2.5:14b",             # optional, provider has defaults
-    base_url="http://localhost:11434/v1",  # optional for known providers
+    llm_provider="ollama",
+    model="qwen2.5:14b",
+    base_url="http://localhost:11434/v1",
+    system="narratology",
 )
 ```
 
+## CLI flags
+
+```
+tvplotlines run <files|dir> [options]
+
+  --show NAME               Override inferred show title
+  --season N                Override inferred season
+  --system hollywood|narratology   Analysis system (default: hollywood)
+  --provider PROVIDER       LLM provider
+  --model NAME              Specific model
+  --base-url URL            Custom OpenAI-compatible endpoint
+  --pass2-mode MODE         parallel | batch | sequential (hollywood)
+  --skip-review             Skip the structural-review pass
+  --stop-after pass1        Save intermediate JSON after Pass 1
+  --resume-from FILE        Resume from intermediate JSON
+  --output PATH             Output JSON path
+  --output-dir DIR          Save timestamped result into a directory
+  --html                    Also emit a standalone HTML viewer
+  --html-output PATH        Custom path for the HTML viewer
+```
+
+```
+tvplotlines write-synopses SHOW [options]
+
+  --season N                Season number (default: 1)
+  --system hollywood|narratology   Which synopsis-writer prompt to use
+  --lang LANG               Wikipedia language code (en, ru, …)
+  --wiki-title TITLE        Exact Wikipedia page title
+  --fandom-wiki NAME        Fandom subdomain override
+  --no-fandom               Disable Fandom fetching
+  --format FORMAT           procedural | serial | hybrid | ensemble
+  --dry-run                 Fetch and parse only, don't call the LLM
+  --no-glossary             Don't prepend glossary to the prompt
+  -o DIR                    Output directory
+```
+
 ## Format
 
 tvplotlines classifies shows into four structural formats that determine how plotlines are extracted:
diff --git a/docs/formulas.md b/docs/formulas.md
index e794c25..6ca0437 100644
--- a/docs/formulas.md
+++ b/docs/formulas.md
@@ -7,6 +7,8 @@ If you're reading a rule in the code or a prompt and wondering why it's there, t
 
 Code paths relative to `src/tvplotlines/`.
 
+The sections below cover the **hollywood** system (5 passes). The **narratology** system is documented in the "Narratology pipeline" section at the end — it reuses the same prompt-loader and model shapes, but has its own six-pass flow.
+
 ---
 
 ## Pass 0: Format Detection
@@ -183,6 +185,28 @@ After verdicts, span recomputes to reflect the changed plotline list.
 
 ---
 
+## Pass 4: Arc Functions
+
+**LLM** assigns each event a season-level role per plotline. **Code** applies the mapping.
+
+### What Pass 4 does
+
+Pass 2 labels events at the **episode** level (function reflects role within one episode). Pass 4 revisits every event from the perspective of its plotline across the **whole season** and assigns `plot_fn`. The same event can be a `climax` in its episode (Pass 2) and an `escalation` in the season arc (Pass 4).
+
+One call per plotline, in parallel.
+
+### Code: application
+
+`pass4.py:assign_arc_functions` · `pipeline.py`
+
+Arc functions are written to `Event.plot_fn`. Texture events (narratology) or events that don't sit in the plotline's arc stay `None`.
+
+### Code: validation
+
+`pass4.py:_validate` — arc function values must come from the function enum (see glossary).
+
+---
+
 ## Pipeline orchestration
 
 ### Execution order
@@ -195,6 +219,7 @@ After verdicts, span recomputes to reflect the changed plotline list.
 4. Post-processing: orphan assignment → span → rank → diagnostics
 5. Pass 3 (skip if `skip_review=True`)
 6. Post-verdict: span recomputes. Rank does not — `computed_rank` is fixed.
+7. Pass 4: arc functions, one call per plotline in parallel.
 
 ### Pass 2 execution modes
 
@@ -207,3 +232,43 @@ After verdicts, span recomputes to reflect the changed plotline list.
 ### Episode ID format
 
 `S{dd}E{dd}` (regex `^S\d{2}E\d{2}$`). Season prefix must match the `season` parameter. Sorted alphabetically before processing.
+
+---
+
+## Narratology pipeline
+
+`narratology.py:run_narratology`
+
+A six-pass alternative to the five-pass hollywood flow. Prompts live under `prompts/narratology/`. Output is mapped into the same `TVPlotlinesResult` shape (actants → hero/goal/obstacle/stakes) so every downstream consumer — the HTML viewer, exports — stays unchanged.
+
+### Passes
+
+| Pass | Role | Calls |
+|------|------|-------|
+| **1 context** | Format, story schema, breach (the canonical violation), genre, protagonists | 1 |
+| **2 fabula** | Per-episode events as state transitions. Every event gets a stable id `{episode}#{nn}` that every later pass references | 1 per episode (parallel) |
+| **3 actants** | Plotlines via Greimas's actant model: `who_chases`, `what_they_chase`, `stands_in_the_way`, `helpers`, `bigger_force`, `who_wins_if_it_works`. The anti-subject test decides when a blocking character deserves their own plotline | 1 |
+| **4 story** | Per-event episode function + direction (improvement/deterioration/neutral); episode theme; interactions between plotlines | 1 per episode (parallel) |
+| **5 arc** | Per-plotline: season-level `arc_function` + `arc_direction`, `kind` (drive vs texture), and the plotline's MRE (most reportable event) | 1 per plotline (parallel) |
+| **6 review** | Verdicts (MERGE/DROP/REASSIGN/REFUNCTION) and ranks (A/B/C) | 1 |
+
+### Glossary
+
+See `src/tvplotlines/prompts/narratology/glossary.md` for `function` (8 values including `recognition`), `direction` (3), `kind` (2), and the full actant mapping.
+
+### Result shape
+
+Same `TVPlotlinesResult` as hollywood:
+
+- `Plotline.hero` ← `who_chases`
+- `Plotline.goal` ← `what_they_chase`
+- `Plotline.obstacle` ← `stands_in_the_way` joined, fall back to `bigger_force`
+- `Plotline.stakes` ← `If wins: {who_wins_if_it_works}`
+- `Event.function` ← episode-level function
+- `Event.plot_fn` ← arc function (or `None` for texture events)
+
+Pass 6 verdicts apply via `narratology.py:_apply_narratology_verdicts` (event re-point for MERGE, event orphaning for DROP, function change for REFUNCTION, plotline move for REASSIGN). Reviewed ranks override computed ranks.
+
+### Dispatcher
+
+`pipeline.py:get_plotlines` calls `narratology.run_narratology` when `system="narratology"` and the ordinary hollywood flow otherwise. A matching dispatcher in the browser viewer picks between `runPipeline` (hollywood) and `runPipelineNarratology` based on the user's LLM-settings choice.
diff --git a/docs/index.md b/docs/index.md
index c5a4036..d6cd6f7 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,12 +1,20 @@
 # tvplotlines
 
-A Python library to extract plotlines from a season of TV synopses using LLMs.
+A Python library — and a standalone HTML viewer — that extracts plotlines from a season of TV synopses using LLMs.
 
 ## What it does
 
-Feed episode synopses → get structured plotlines, character arcs, and per-episode event breakdowns.
+Feed episode synopses → get structured plotlines, character arcs, and per-episode event breakdowns. Two analysis systems ship side by side: the Hollywood screenwriting model (hero/goal/obstacle/stakes, Freytag functions) and structuralist narratology (Bal/Todorov/Greimas/Bremond — actants, fabula, arc).
+
+Three ways to run it:
+
+- **Python library** — `from tvplotlines import get_plotlines`
+- **CLI** — `tvplotlines run my-show/ [--system narratology] [--html]`
+- **Standalone HTML viewer** — one self-contained file that runs the whole pipeline in the browser, takes a show name + season, fetches synopses from the LLM, and renders the grid
 
 ## Quick links
 
 - [Quickstart](quickstart.md) — get running in 5 minutes
 - [API Reference](api.md) — function signatures and data models
+- [Rules and formulas](formulas.md) — every rule, threshold, and computation
+- [Layered JSON schema](layered-schema.md) — `base + layers` form for storing multiple systems' analyses side by side
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 67a5148..fbc754b 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -20,7 +20,7 @@ breaking-bad/
 └── ...
 ```
 
-## CLI
+## CLI — analyze a folder
 
 ```bash
 tvplotlines run breaking-bad/
@@ -32,6 +32,37 @@ The show name is taken from the folder name. Override with `--show` if needed:
 tvplotlines run got/ --show "Game of Thrones"
 ```
 
+Pick the analysis system — `hollywood` (default, screenwriting model) or `narratology` (structuralist):
+
+```bash
+tvplotlines run breaking-bad/ --system narratology
+```
+
+Produce a standalone HTML viewer alongside the JSON (opens in any browser, no server needed):
+
+```bash
+tvplotlines run breaking-bad/ --html                       # writes …/breaking-bad.html
+tvplotlines run breaking-bad/ --html-output viewer.html    # custom path
+```
+
+## Standalone viewer — analyze from the browser
+
+Build the viewer once, then ship the `.html` file anywhere:
+
+```bash
+python -m tvplotlines.html.build --output tvplotlines.html
+open tvplotlines.html
+```
+
+In the viewer:
+
+1. Click **LLM** in the toolbar → paste API key → pick provider (Anthropic/OpenAI) and analysis system (Hollywood/Narratology).
+2. On the welcome screen, type a series name and season, click **Analyze**.
+3. The viewer asks the model for episode synopses, shows them in an editable preview, then runs the pipeline in the browser.
+4. Export as JSON, CSV, Final Draft (`.fdx`), or PDF.
+
+If the model doesn't know the show, drop your own `.txt` files via **+ Load**.
+
 ## Python
 
 ```python
@@ -44,6 +75,15 @@ for plotline in result.plotlines:
     print(f"{plotline.rank} | {plotline.name} ({plotline.hero})")
 ```
 
+Switch analysis systems:
+
+```python
+result = get_plotlines(
+    show="Breaking Bad", season=1, episodes=synopses,
+    system="narratology",                         # or "hollywood" (default)
+)
+```
+
 ## Configuration
 
 ```python
@@ -51,8 +91,10 @@ result = get_plotlines(
     show="Breaking Bad",
     season=1,
     episodes=synopses,
-    llm_provider="openai",       # or "anthropic" (default)
-    pass2_mode="batch",          # "parallel" | "batch" | "sequential"
+    system="hollywood",          # "hollywood" | "narratology"
+    llm_provider="openai",       # or "anthropic" (default), "ollama", "deepseek", "groq"
+    pass2_mode="batch",          # "parallel" | "batch" | "sequential" (hollywood only)
+    skip_review=False,           # skip the structural-review pass
 )
 ```
 

From 16aedf363b561c94c20addc554abe2bfb11e2bdd Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Wed, 15 Apr 2026 12:09:34 +0200
Subject: [PATCH 19/24] chore: drop gitignore entries for drafts now moved out

Untitled.md and compliance/ live in 3-resources/tvplotlines/
alongside the rest of the private notes; they don't need
to be ignored here any more.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .gitignore | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/.gitignore b/.gitignore
index a214dd4..20a983e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -57,7 +57,3 @@ runs/
 
 # Worktrees
 .worktrees/
-
-# Local drafts and one-off scratch (not for the public repo)
-Untitled.md
-compliance/

From ce730867627c2a54b97158700fa2f0b15f83cb83 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Wed, 15 Apr 2026 12:21:03 +0200
Subject: [PATCH 20/24] docs: add AI disclosure, methodology, and viewer footer
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Address the compliance scan items that actually apply to an installable
library with no hosted service:

- docs/ai-disclosure.md — single source of truth for data flow,
  vendor policies, and user rights. Alpine Animation (Switzerland) is
  named as publisher; we collect nothing. Names the three synopsis
  paths (user-supplied, Wikipedia-scraped via write-synopses, and the
  browser's "Analyze a series" flow), covers Anthropic AUP and OpenAI
  Usage Policies compliance, and records a use-case paper trail
- docs/methodology.md — plain-language Art. 50 explainer written from
  the code (pipeline.py, narratology.py, pass*.py, postprocess.py),
  not the dacomply template. Points to formulas.md for line-by-line
  rules
- README gains a "How this uses AI" section linking both docs
- HTML viewer shows a dismissible AI-assisted-content footer naming
  the model family and Alpine Animation; dismissal persists in
  localStorage; footer is hidden at print time so PDF exports stay clean

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 CHANGELOG.md                          |  1 +
 README.md                             |  9 ++++
 docs/ai-disclosure.md                 | 71 +++++++++++++++++++++++++
 docs/methodology.md                   | 76 +++++++++++++++++++++++++++
 src/tvplotlines/html/parts/app.js     | 11 ++++
 src/tvplotlines/html/parts/shell.html |  6 +++
 src/tvplotlines/html/parts/style.css  | 27 ++++++++++
 7 files changed, 201 insertions(+)
 create mode 100644 docs/ai-disclosure.md
 create mode 100644 docs/methodology.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4c55100..6b45d64 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,7 @@
 ## Unreleased
 
 ### Added
+- **AI-use, privacy, and methodology docs** — `docs/ai-disclosure.md` documents the data flow (nothing reaches Alpine Animation — your inputs and API key travel straight from your machine to the LLM vendor), lists Anthropic's and OpenAI's applicable policies, and records a paper-trail for vendor-policy compliance. `docs/methodology.md` is the plain-language Art. 50 description of how the pipeline decides, what it can't do, and where to read the code. README links both, and the standalone HTML viewer carries a dismissible AI-assisted-content footer.
 - **Narratology pipeline — runnable**. New module `src/tvplotlines/narratology.py` implements all six passes (context, fabula, actants, story, arc, review). Results are emitted in the existing `TVPlotlinesResult` shape so the HTML viewer renders hollywood and narratology output unchanged. Actants (`who_chases`, `what_they_chase`, `stands_in_the_way`, `who_wins_if_it_works`) map onto `hero`, `goal`, `obstacle`, `stakes`. Pass 5 arc functions land in `Event.plot_fn`. Pass 6 verdicts apply in-place (MERGE/DROP/REASSIGN/REFUNCTION) and reviewed ranks override computed ranks.
 - **Narratology in the browser viewer**. `runPipelineNarratology` in `pipeline.js` mirrors the Python orchestrator, runs all six passes via browser LLM calls (per-episode passes parallelised with `Promise.all`), and produces the same hollywood-compatible shape. `runPipeline` dispatches on the user's system choice. The "Narratology" option in LLM settings is now enabled.
 - **Prompts inlined at build time**. `src/tvplotlines/html/build.py` reads every `prompts/{hollywood,narratology}/*.md` and injects them into the HTML as a `_PROMPTS` object, so the viewer no longer carries a hardcoded copy that could drift from the source.
diff --git a/README.md b/README.md
index 523ee8b..def4859 100644
--- a/README.md
+++ b/README.md
@@ -220,6 +220,15 @@ See [docs/api.md](docs/api.md) for full API reference.
 - **Function** — episode-level role in a plotline arc (setup, inciting_incident, escalation, turning_point, crisis, climax, resolution; narratology adds `recognition`)
 - **Arc function** — season-level role of the same event
 
+## How this uses AI
+
+`tvplotlines` calls either Claude (Anthropic) or GPT (OpenAI) — you pick one per run — to produce its analyses. If your application surfaces this library's output to end users, you're responsible for disclosing the AI involvement to them (EU AI Act Art. 50; Anthropic AUP; OpenAI Usage Policies). The standalone HTML viewer shipped here carries that notice in its footer.
+
+- [`docs/ai-disclosure.md`](docs/ai-disclosure.md) — what gets sent where, and to whom. Alpine Animation (Switzerland) publishes the library and collects **no** data; your API key and inputs travel directly from your machine to the LLM vendor you pick.
+- [`docs/methodology.md`](docs/methodology.md) — plain-language description of how the pipeline decides, what it can't do, and where to find the code for each step.
+
+Outputs are AI-generated and can contain hallucinations. Treat them as a starting point for your own analysis, not a verified source.
+
 ## Citation
 
 ```bibtex
diff --git a/docs/ai-disclosure.md b/docs/ai-disclosure.md
new file mode 100644
index 0000000..1a21112
--- /dev/null
+++ b/docs/ai-disclosure.md
@@ -0,0 +1,71 @@
+# AI disclosure, privacy, and vendor policy
+
+`tvplotlines` uses a third-party LLM — either Claude (Anthropic) or GPT (OpenAI), whichever you configure — to analyse TV-episode synopses. This page is the single source of truth for what that means in practice, who sees what, and which policies apply.
+
+**Publisher:** Alpine Animation (Switzerland) · **Contact:** open an issue at <https://github.com/BirdInTheTree/tvplotlines/issues>
+
+---
+
+## What gets sent where
+
+The library and the standalone HTML viewer both run on the user's own machine. Neither talks to any server operated by Alpine Animation.
+
+| What you do | What happens |
+|---|---|
+| Run `tvplotlines run my-show/` or the HTML viewer locally | Your episode synopses, your analysis system choice, and your API key travel directly from your process (terminal or browser) to the LLM provider you picked |
+| Results arrive | They are written to disk (CLI) or rendered in your browser (viewer) — nothing is uploaded anywhere |
+| You export JSON / CSV / FDX / PDF | Files are saved locally; nothing leaves your machine |
+
+**Alpine Animation collects no data at all.** No analytics, no telemetry, no server-side logs — there is no server to log to. Your API key lives only in your own environment or in your browser's `localStorage`.
+
+Whichever provider you pick, the LLM vendor handles the request under **their** terms:
+
+- **Anthropic** — <https://www.anthropic.com/privacy> · <https://www.anthropic.com/legal/aup>
+- **OpenAI** — <https://openai.com/policies/privacy-policy> · <https://openai.com/policies/usage-policies/>
+
+Both providers are US-based; if you pick one, the cross-border transfer of your input is between your machine and them, not through us.
+
+---
+
+## AI-generated content notice
+
+Outputs produced by `tvplotlines` are generated by large language models. They can contain factual errors, invented plot details that sound plausible, and misreadings of intent. Treat the results as a starting point for your own analysis, not a verified source.
+
+Downstream applications that surface these outputs to other users are responsible for displaying an equivalent notice (EU AI Act Art. 50; Anthropic AUP; OpenAI Usage Policies). The HTML viewer shipped with this repo carries that notice in its footer.
+
+---
+
+## Your rights (Swiss nFADP / EU GDPR)
+
+Because Alpine Animation holds no personal data about you, the usual access / rectification / deletion requests don't have anything to act on here. If Anthropic or OpenAI hold data from your use of their API, those requests go to them, not to us. We'll still help route a request to the right place — open a GitHub issue and we'll point you at the contact channel.
+
+If you believe `tvplotlines` itself — the code, the prompts, the docs — handles data in a way this page doesn't describe, that's a bug: please open an issue so we can either fix the code or fix the page.
+
+---
+
+## Vendor policy paper trail
+
+Use case: **structural analysis of fictional TV-episode synopses** — extracting plotlines, characters, narrative functions, arc shape. Output is structured JSON and a grid visualisation.
+
+Three input paths are supported, all feeding the same pipeline:
+
+1. **User-supplied** `.txt` synopses (CLI: `tvplotlines run my-show/`).
+2. **Wikipedia/Fandom-scraped** raw episode descriptions rewritten into full synopses by the LLM (CLI: `tvplotlines write-synopses "Show Name"`).
+3. **LLM-generated from its own training memory** — the HTML viewer's "Analyze a series" flow asks the configured LLM to produce episode-by-episode synopses for a public show from what it already knows, then lets the user edit them before the pipeline runs.
+
+In paths 2 and 3 the synopsis text itself is AI-generated. The viewer's footer makes the AI involvement explicit; users of path 2 (CLI) can inspect the generated `.txt` files before running analysis.
+
+This use case falls under general content analysis and is **not** one of the prohibited categories listed in either vendor policy:
+
+- Not weapons-related, not surveillance-of-individuals, not medical or legal advice, not CSAM, not political persuasion, not automated decisions with legal effect on individuals.
+- Not deception about AI identity: the HTML viewer's footer names the model and Alpine Animation, and the CLI writes AI-generated synopses to `.txt` files the user reviews before analysis — users always know what came from the model.
+- Covered under Anthropic AUP's allowed categories (content creation, research, analysis).
+- Covered under OpenAI Usage Policies for text analysis and content-authoring support.
+
+Reviewed 2026-04-15 against both policies as linked above. Any user deploying this library in a high-risk setting (Annex III of the EU AI Act — law-enforcement, essential public services, employment decisions) must re-review; this analysis is intended for creative-industry and research use.
+
+---
+
+## How the AI actually decides
+
+A plain-language description of the pipeline — what each LLM pass does, what enums and rules the prompts encode, and what the code computes deterministically — lives in [`methodology.md`](methodology.md) with links into the code. `formulas.md` has the full rule-by-rule breakdown.
diff --git a/docs/methodology.md b/docs/methodology.md
new file mode 100644
index 0000000..482affd
--- /dev/null
+++ b/docs/methodology.md
@@ -0,0 +1,76 @@
+# Methodology — how tvplotlines uses AI
+
+**Last updated:** 2026-04-15 · **Publisher:** Alpine Animation (Switzerland)
+
+Plain-language description of how the AI in `tvplotlines` works, as required by EU AI Act Art. 50(1)(c). This page stays concise; `formulas.md` has the full rule-by-rule breakdown.
+
+## What the AI does
+
+### Step 0: getting the synopses
+
+The pipeline needs one synopsis per episode. Three paths land there, all via the same LLM you configure:
+
+- **You supply them** as `.txt` files you wrote or collected yourself.
+- **The library fetches them** — `tvplotlines write-synopses "Show Name"` pulls raw episode rows from Wikipedia (and Fandom, when available), then asks the LLM to rewrite each into a 150–500-word beat-dense synopsis. The rewritten `.txt` files are written to disk so you can inspect them before running the extraction.
+- **The model writes them from memory** — the HTML viewer's "Analyze a series" flow asks the LLM for episode synopses of a public show based on its own training data, then shows them to you in an editable preview before the pipeline runs.
+
+In the last two paths the synopsis text is itself AI-generated. The library surfaces this fact (files on disk, editable preview), and the HTML viewer's footer repeats the disclosure.
+
+### Step 1–N: extraction
+
+Given the synopses, `tvplotlines` extracts structured analysis:
+
+- The **story engine** (one-sentence logline of the show's dramatic mechanism).
+- The **format** (procedural, serial, hybrid, ensemble).
+- The **cast** and the **plotlines** with their Story DNA (hero, goal, obstacle, stakes) or — in the narratology mode — actant structure (who chases what, who helps, who opposes, who wins).
+- Every **event** in every episode, assigned to a plotline, labelled with its role in the episode and in the season arc, plus character-level interactions.
+- **Structural ranks** (A/B/C) indicating which plotline is the spine of the season.
+
+The same analysis can be run through two systems — **hollywood** (screenwriting tradition, Syd Field / Douglas / Freytag) or **narratology** (structuralist tradition, Bal / Todorov / Greimas / Bremond). Both emit the same result shape.
+
+## How it decides
+
+The pipeline is **not** one LLM call. It is 5 or 6 small prompts, each with a narrow job, orchestrated by deterministic code:
+
+| System | Passes |
+|--------|--------|
+| hollywood | Pass 0 (context) → Pass 1 (plotlines, 3× majority vote) → Pass 2 (per-episode events) → Pass 3 (structural review) → Pass 4 (arc functions) |
+| narratology | 1 context → 2 fabula → 3 actants → 4 story → 5 arc → 6 review |
+
+Each prompt lives as a `.md` file under `src/tvplotlines/prompts/{hollywood,narratology}/`. The prompts encode narrative-theory rules (what a plotline is, what a setup vs climax is, when to merge two plotlines, what ranks mean). Between passes, `postprocess.py` computes objective things deterministically: event counts, plotline spans, ranks derived from event counts, orphan-event reassignment by character voting. The LLM is asked for judgements; the code is what tracks totals.
+
+When two passes disagree (for example, code-computed rank vs LLM-reviewed rank), both values are kept in the output — the user sees the disagreement.
+
+## Why this split
+
+A naive single-prompt LLM extraction covers 5–12% of a season's source material; our measurements put `tvplotlines` at 78–91%. The gap comes from separating *what to look for* (narrative theory, written into the prompts) from *how to tally it* (deterministic code). Neither half is "AI deciding everything".
+
+## What it cannot do
+
+- The model hallucinates. Plotlines described in the output may exist only in the model's imagination; character names may be off; function labels may be wrong. Always verify against the source synopsis.
+- Knowledge of the show is bounded by what was in the model's training data *and* what's in the synopses the user provides. Obscure shows with short synopses give thin results.
+- The library does not fact-check its own output against any external source (no Wikipedia cross-reference at inference time, no viewer-rating database).
+- The LLM is prompted to refuse cases where there is no clear plotline ("inferred" confidence), but the safeguard is soft — a confidently wrong answer is still possible.
+
+## Training and data
+
+The supported LLMs (Claude by Anthropic, GPT by OpenAI — the user picks one per run) are trained by their respective vendors on corpora those vendors do not fully disclose. **Alpine Animation does not train or fine-tune any model** — the library sends prompts to the vendor at runtime and consumes the response. No tvplotlines-specific training data exists.
+
+See [`ai-disclosure.md`](ai-disclosure.md) for the data-flow details and vendor policy links.
+
+## Where to check what the code actually does
+
+- `src/tvplotlines/pipeline.py` — orchestrator for the hollywood flow
+- `src/tvplotlines/narratology.py` — orchestrator for the narratology flow
+- `src/tvplotlines/pass{0,1,2,3,4}.py` — per-pass hollywood logic
+- `src/tvplotlines/postprocess.py` — deterministic span / rank / orphan-assignment logic
+- `src/tvplotlines/prompts/{hollywood,narratology}/*.md` — every prompt the LLM receives
+- [`formulas.md`](formulas.md) — every rule, threshold, and computation documented at one level above the code
+
+## Limitations under EU AI Act
+
+`tvplotlines` is a **general-purpose tool** for narrative analysis. It is not deployed in any Annex III high-risk context (law enforcement, essential public services, employment decisions). If an integrator puts it in one of those contexts, that integrator assumes the stricter Annex III obligations (Art. 11, Art. 12 technical documentation) — this methodology is not sufficient on its own for those cases.
+
+## Contact for methodology questions
+
+Open an issue at <https://github.com/BirdInTheTree/tvplotlines/issues>.
diff --git a/src/tvplotlines/html/parts/app.js b/src/tvplotlines/html/parts/app.js
index da2b455..65bf59a 100644
--- a/src/tvplotlines/html/parts/app.js
+++ b/src/tvplotlines/html/parts/app.js
@@ -30,6 +30,8 @@ const Store = {
   },
   hasSeenOnboarding: () => localStorage.getItem('tvplotlines_onboarding_seen') === 'true',
   markOnboardingSeen: () => localStorage.setItem('tvplotlines_onboarding_seen', 'true'),
+  aiFooterDismissed: () => localStorage.getItem('tvplotlines_ai_footer_dismissed') === 'true',
+  dismissAIFooter: () => localStorage.setItem('tvplotlines_ai_footer_dismissed', 'true'),
 };
 
 // --- Screen routing ---
@@ -732,6 +734,15 @@ function _initApp() {
     });
   }
 
+  // AI-assisted content footer — persistent-dismiss across sessions
+  const aiFooter = document.getElementById('ai-footer');
+  const aiDismiss = document.getElementById('ai-footer-dismiss');
+  if (aiFooter && Store.aiFooterDismissed()) aiFooter.classList.add('hidden');
+  if (aiDismiss) aiDismiss.addEventListener('click', () => {
+    if (aiFooter) aiFooter.classList.add('hidden');
+    Store.dismissAIFooter();
+  });
+
   // Populate dropdown and determine initial view
   _populateSeriesDropdown();
 
diff --git a/src/tvplotlines/html/parts/shell.html b/src/tvplotlines/html/parts/shell.html
index e041503..f690b39 100644
--- a/src/tvplotlines/html/parts/shell.html
+++ b/src/tvplotlines/html/parts/shell.html
@@ -104,6 +104,12 @@ <h1 class="welcome-title">tvplotlines</h1>
   <button onclick="_handleExport('pdf')">PDF</button>
 </div>
 
+<!-- AI-generated-content notice (EU AI Act Art. 50; Anthropic AUP; OpenAI Usage Policies) -->
+<footer id="ai-footer" class="ai-footer" role="note">
+  <span><strong>AI-assisted content.</strong> Plotlines, events, and — when you use "Analyze a series" — the episode synopses themselves are generated by Claude (Anthropic) or GPT (OpenAI), whichever you configured. Your API key and inputs go directly from this browser to the provider; Alpine Animation (publisher) sees nothing.</span>
+  <button id="ai-footer-dismiss" class="ai-footer-dismiss" title="Dismiss" aria-label="Dismiss notice">&times;</button>
+</footer>
+
 <!-- Demo data (injected by build.py) -->
 <script id="demo-data" type="application/json">
 /* {{DEMO_DATA}} */
diff --git a/src/tvplotlines/html/parts/style.css b/src/tvplotlines/html/parts/style.css
index 0bd877e..806e092 100644
--- a/src/tvplotlines/html/parts/style.css
+++ b/src/tvplotlines/html/parts/style.css
@@ -90,6 +90,33 @@ body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; b
 :root.dark .welcome-link:hover { color: #cdd6f4; }
 :root.dark .welcome-sep { color: #313244; }
 
+/* ── AI-assisted content footer (EU AI Act Art. 50) ── */
+.ai-footer {
+  position: fixed; left: 0; right: 0; bottom: 0; z-index: 50;
+  padding: 8px 14px; font-size: 0.78rem; line-height: 1.4;
+  background: #fafafa; color: #555;
+  border-top: 1px solid #e3e3e3;
+  display: flex; align-items: center; justify-content: space-between;
+  gap: 12px;
+}
+.ai-footer.hidden { display: none !important; }
+.ai-footer-dismiss {
+  background: transparent; border: none; cursor: pointer;
+  color: #888; font-size: 1.1rem; line-height: 1;
+  padding: 0 4px;
+}
+.ai-footer-dismiss:hover { color: #333; }
+
+:root.dark .ai-footer {
+  background: #181825; color: #a6adc8; border-top-color: #313244;
+}
+:root.dark .ai-footer-dismiss { color: #6c7086; }
+:root.dark .ai-footer-dismiss:hover { color: #cdd6f4; }
+
+@media print {
+  .ai-footer { display: none !important; }
+}
+
 /* ── Print (used by the "PDF (via print)" export) ── */
 @media print {
   @page { size: landscape; margin: 10mm; }

From a02359279118ed78e73003d1f1b1da8a37c10827 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Wed, 15 Apr 2026 12:31:23 +0200
Subject: [PATCH 21/24] docs: add 411@alpineanimation.ch as contact
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Alongside GitHub issues — gives data-subject and methodology requests
a direct channel to the publisher, which is what the compliance scan
flagged as missing.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 docs/ai-disclosure.md | 4 ++--
 docs/methodology.md   | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/ai-disclosure.md b/docs/ai-disclosure.md
index 1a21112..ed3fb61 100644
--- a/docs/ai-disclosure.md
+++ b/docs/ai-disclosure.md
@@ -2,7 +2,7 @@
 
 `tvplotlines` uses a third-party LLM — either Claude (Anthropic) or GPT (OpenAI), whichever you configure — to analyse TV-episode synopses. This page is the single source of truth for what that means in practice, who sees what, and which policies apply.
 
-**Publisher:** Alpine Animation (Switzerland) · **Contact:** open an issue at <https://github.com/BirdInTheTree/tvplotlines/issues>
+**Publisher:** Alpine Animation (Switzerland) · **Contact:** <411@alpineanimation.ch> or open an issue at <https://github.com/BirdInTheTree/tvplotlines/issues>
 
 ---
 
@@ -37,7 +37,7 @@ Downstream applications that surface these outputs to other users are responsibl
 
 ## Your rights (Swiss nFADP / EU GDPR)
 
-Because Alpine Animation holds no personal data about you, the usual access / rectification / deletion requests don't have anything to act on here. If Anthropic or OpenAI hold data from your use of their API, those requests go to them, not to us. We'll still help route a request to the right place — open a GitHub issue and we'll point you at the contact channel.
+Because Alpine Animation holds no personal data about you, the usual access / rectification / deletion requests don't have anything to act on here. If Anthropic or OpenAI hold data from your use of their API, those requests go to them, not to us. We'll still help route a request to the right place — write to <411@alpineanimation.ch> (or open a GitHub issue) and we'll point you at the contact channel.
 
 If you believe `tvplotlines` itself — the code, the prompts, the docs — handles data in a way this page doesn't describe, that's a bug: please open an issue so we can either fix the code or fix the page.
 
diff --git a/docs/methodology.md b/docs/methodology.md
index 482affd..57dc366 100644
--- a/docs/methodology.md
+++ b/docs/methodology.md
@@ -73,4 +73,4 @@ See [`ai-disclosure.md`](ai-disclosure.md) for the data-flow details and vendor
 
 ## Contact for methodology questions
 
-Open an issue at <https://github.com/BirdInTheTree/tvplotlines/issues>.
+Write to <411@alpineanimation.ch> or open an issue at <https://github.com/BirdInTheTree/tvplotlines/issues>.

From 92091249866cf25be94a544dd408ce702e906e28 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Wed, 15 Apr 2026 12:32:58 +0200
Subject: [PATCH 22/24] docs: obfuscate contact email against naive scrapers
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Replace <411@alpineanimation.ch> with "411 [at] alpineanimation [dot] ch".
Defeats ~80–90% of off-the-shelf email harvesters that look for
mailto: links or @-symbols; humans read it without effort.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 docs/ai-disclosure.md | 4 ++--
 docs/methodology.md   | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/ai-disclosure.md b/docs/ai-disclosure.md
index ed3fb61..1d1b412 100644
--- a/docs/ai-disclosure.md
+++ b/docs/ai-disclosure.md
@@ -2,7 +2,7 @@
 
 `tvplotlines` uses a third-party LLM — either Claude (Anthropic) or GPT (OpenAI), whichever you configure — to analyse TV-episode synopses. This page is the single source of truth for what that means in practice, who sees what, and which policies apply.
 
-**Publisher:** Alpine Animation (Switzerland) · **Contact:** <411@alpineanimation.ch> or open an issue at <https://github.com/BirdInTheTree/tvplotlines/issues>
+**Publisher:** Alpine Animation (Switzerland) · **Contact:** 411 [at] alpineanimation [dot] ch or open an issue at <https://github.com/BirdInTheTree/tvplotlines/issues>
 
 ---
 
@@ -37,7 +37,7 @@ Downstream applications that surface these outputs to other users are responsibl
 
 ## Your rights (Swiss nFADP / EU GDPR)
 
-Because Alpine Animation holds no personal data about you, the usual access / rectification / deletion requests don't have anything to act on here. If Anthropic or OpenAI hold data from your use of their API, those requests go to them, not to us. We'll still help route a request to the right place — write to <411@alpineanimation.ch> (or open a GitHub issue) and we'll point you at the contact channel.
+Because Alpine Animation holds no personal data about you, the usual access / rectification / deletion requests don't have anything to act on here. If Anthropic or OpenAI hold data from your use of their API, those requests go to them, not to us. We'll still help route a request to the right place — write to 411 [at] alpineanimation [dot] ch (or open a GitHub issue) and we'll point you at the contact channel.
 
 If you believe `tvplotlines` itself — the code, the prompts, the docs — handles data in a way this page doesn't describe, that's a bug: please open an issue so we can either fix the code or fix the page.
 
diff --git a/docs/methodology.md b/docs/methodology.md
index 57dc366..624ab3e 100644
--- a/docs/methodology.md
+++ b/docs/methodology.md
@@ -73,4 +73,4 @@ See [`ai-disclosure.md`](ai-disclosure.md) for the data-flow details and vendor
 
 ## Contact for methodology questions
 
-Write to <411@alpineanimation.ch> or open an issue at <https://github.com/BirdInTheTree/tvplotlines/issues>.
+Write to `411 [at] alpineanimation [dot] ch` or open an issue at <https://github.com/BirdInTheTree/tvplotlines/issues>.

From 2cf4f666299246d220840edae829f4b439142c03 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Wed, 15 Apr 2026 12:38:00 +0200
Subject: [PATCH 23/24] docs: switch contact to purpose-specific alias
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

tvplotlines@alpineanimation.ch — easy to kill and recreate if it ever
gets scraped, which is a better strategy than trying to obfuscate a
shared catch-all mailbox.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 docs/ai-disclosure.md | 4 ++--
 docs/methodology.md   | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/ai-disclosure.md b/docs/ai-disclosure.md
index 1d1b412..ea16c32 100644
--- a/docs/ai-disclosure.md
+++ b/docs/ai-disclosure.md
@@ -2,7 +2,7 @@
 
 `tvplotlines` uses a third-party LLM — either Claude (Anthropic) or GPT (OpenAI), whichever you configure — to analyse TV-episode synopses. This page is the single source of truth for what that means in practice, who sees what, and which policies apply.
 
-**Publisher:** Alpine Animation (Switzerland) · **Contact:** 411 [at] alpineanimation [dot] ch or open an issue at <https://github.com/BirdInTheTree/tvplotlines/issues>
+**Publisher:** Alpine Animation (Switzerland) · **Contact:** <tvplotlines@alpineanimation.ch> or open an issue at <https://github.com/BirdInTheTree/tvplotlines/issues>
 
 ---
 
@@ -37,7 +37,7 @@ Downstream applications that surface these outputs to other users are responsibl
 
 ## Your rights (Swiss nFADP / EU GDPR)
 
-Because Alpine Animation holds no personal data about you, the usual access / rectification / deletion requests don't have anything to act on here. If Anthropic or OpenAI hold data from your use of their API, those requests go to them, not to us. We'll still help route a request to the right place — write to 411 [at] alpineanimation [dot] ch (or open a GitHub issue) and we'll point you at the contact channel.
+Because Alpine Animation holds no personal data about you, the usual access / rectification / deletion requests don't have anything to act on here. If Anthropic or OpenAI hold data from your use of their API, those requests go to them, not to us. We'll still help route a request to the right place — write to <tvplotlines@alpineanimation.ch> (or open a GitHub issue) and we'll point you at the contact channel.
 
 If you believe `tvplotlines` itself — the code, the prompts, the docs — handles data in a way this page doesn't describe, that's a bug: please open an issue so we can either fix the code or fix the page.
 
diff --git a/docs/methodology.md b/docs/methodology.md
index 624ab3e..8a01d67 100644
--- a/docs/methodology.md
+++ b/docs/methodology.md
@@ -73,4 +73,4 @@ See [`ai-disclosure.md`](ai-disclosure.md) for the data-flow details and vendor
 
 ## Contact for methodology questions
 
-Write to `411 [at] alpineanimation [dot] ch` or open an issue at <https://github.com/BirdInTheTree/tvplotlines/issues>.
+Write to <tvplotlines@alpineanimation.ch> or open an issue at <https://github.com/BirdInTheTree/tvplotlines/issues>.

From b77d023c5277bf711c64f9d99bead31452b55392 Mon Sep 17 00:00:00 2001
From: BirdInTheTree <51715433+BirdInTheTree@users.noreply.github.com>
Date: Wed, 15 Apr 2026 12:45:53 +0200
Subject: [PATCH 24/24] =?UTF-8?q?refactor:=20rename=20tvplotlines=20?=
 =?UTF-8?q?=E2=86=92=20tvplot?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Shorter, snappier. PyPI name, import path, CLI command (tvplot run),
env vars (TVPLOT_*), localStorage keys, and all docs move in one step.
Version bumps to 0.2.0 and CHANGELOG carries a BREAKING migration note.

What changes externally:
- pip install tvplot
- from tvplot import get_plotlines
- tvplot run my-show/ --system narratology
- TVPLOT_OUTPUT_DIR, TVPLOT_SYNOPSES_DIR

What stays:
- Public API surface (get_plotlines signature, Plotline/Event models)
- All pipeline logic and prompts
- Existing result JSONs remain valid

Rationale: no meaningful users yet on PyPI (80%+ of the 0.1.0
download count is bots and scanners), the rename is much cheaper
now than after promotion.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 CHANGELOG.md                                  |  19 +-
 CONTRIBUTING.md                               |   6 +-
 README.md                                     |  52 +-
 docs/ai-disclosure.md                         |  16 +-
 docs/api.md                                   |  22 +-
 docs/formulas.md                              |   4 +-
 docs/index.md                                 |   6 +-
 docs/layered-schema.md                        |   8 +-
 docs/methodology.md                           |  28 +-
 docs/quickstart.md                            |  18 +-
 examples/run_pipeline.py                      |   6 +-
 pyproject.toml                                | 138 +--
 src/{tvplotlines => tvplot}/__init__.py       |  64 +-
 src/tvplot/__main__.py                        |   4 +
 src/{tvplotlines => tvplot}/callbacks.py      | 114 +--
 src/{tvplotlines => tvplot}/cli.py            | 810 +++++++++---------
 src/{tvplotlines => tvplot}/html/__init__.py  |   0
 src/{tvplotlines => tvplot}/html/build.py     |   2 +-
 .../html/parts/analytics.js                   |   4 +-
 src/{tvplotlines => tvplot}/html/parts/app.js |  30 +-
 .../html/parts/export.js                      |   4 +-
 .../html/parts/grid.js                        |   2 +-
 .../html/parts/pipeline.js                    |   2 +-
 .../html/parts/shell.html                     |   2 +-
 .../html/parts/style.css                      |   0
 src/{tvplotlines => tvplot}/input.py          |   0
 src/{tvplotlines => tvplot}/llm.py            |   0
 src/{tvplotlines => tvplot}/metrics.py        |   2 +-
 src/{tvplotlines => tvplot}/models.py         |   6 +-
 src/{tvplotlines => tvplot}/narratology.py    |  10 +-
 src/{tvplotlines => tvplot}/pass0.py          |   6 +-
 src/{tvplotlines => tvplot}/pass1.py          |   6 +-
 src/{tvplotlines => tvplot}/pass2.py          |   6 +-
 src/{tvplotlines => tvplot}/pass3.py          |   8 +-
 src/{tvplotlines => tvplot}/pass4.py          |   6 +-
 src/{tvplotlines => tvplot}/pipeline.py       | 496 +++++------
 src/{tvplotlines => tvplot}/postprocess.py    | 502 +++++------
 .../prompts/__init__.py                       |   2 +-
 .../prompts/hollywood/__init__.py             |   0
 .../prompts/hollywood/glossary.md             |   0
 .../prompts/hollywood/pass0.md                |   0
 .../prompts/hollywood/pass1.md                |   0
 .../prompts/hollywood/pass2.md                |   0
 .../prompts/hollywood/pass3.md                |   0
 .../prompts/hollywood/pass4.md                |   0
 .../prompts/hollywood/synopses_writer.md      |   0
 .../prompts/narratology/__init__.py           |   0
 .../prompts/narratology/glossary.md           |   0
 .../prompts/narratology/pass1_context.md      |   0
 .../prompts/narratology/pass2_fabula.md       |   0
 .../prompts/narratology/pass3_actants.md      |   0
 .../prompts/narratology/pass4_story.md        |   0
 .../prompts/narratology/pass5_arc.md          |   0
 .../prompts/narratology/pass6_review.md       |   0
 .../prompts/narratology/synopses_writer.md    |   0
 src/{tvplotlines => tvplot}/py.typed          |   0
 .../synopses_writer.py                        |  24 +-
 src/{tvplotlines => tvplot}/verdicts.py       |   2 +-
 src/tvplotlines/__main__.py                   |   4 -
 tests/test_html_build.py                      |  14 +-
 tests/test_input.py                           |   2 +-
 tests/test_llm.py                             |  58 +-
 tests/test_metrics.py                         | 246 +++---
 tests/test_models.py                          |   2 +-
 tests/test_pass1_prior.py                     | 204 ++---
 tests/test_pipeline_prior.py                  | 192 ++---
 tests/test_postprocess.py                     | 440 +++++-----
 tests/test_resilience.py                      | 572 ++++++-------
 tests/test_synopses_writer.py                 |  38 +-
 tests/test_validation.py                      |   8 +-
 tests/test_verdicts.py                        |   4 +-
 71 files changed, 2113 insertions(+), 2108 deletions(-)
 rename src/{tvplotlines => tvplot}/__init__.py (54%)
 create mode 100644 src/tvplot/__main__.py
 rename src/{tvplotlines => tvplot}/callbacks.py (94%)
 rename src/{tvplotlines => tvplot}/cli.py (91%)
 rename src/{tvplotlines => tvplot}/html/__init__.py (100%)
 rename src/{tvplotlines => tvplot}/html/build.py (98%)
 rename src/{tvplotlines => tvplot}/html/parts/analytics.js (99%)
 rename src/{tvplotlines => tvplot}/html/parts/app.js (95%)
 rename src/{tvplotlines => tvplot}/html/parts/export.js (99%)
 rename src/{tvplotlines => tvplot}/html/parts/grid.js (99%)
 rename src/{tvplotlines => tvplot}/html/parts/pipeline.js (99%)
 rename src/{tvplotlines => tvplot}/html/parts/shell.html (99%)
 rename src/{tvplotlines => tvplot}/html/parts/style.css (100%)
 rename src/{tvplotlines => tvplot}/input.py (100%)
 rename src/{tvplotlines => tvplot}/llm.py (100%)
 rename src/{tvplotlines => tvplot}/metrics.py (98%)
 rename src/{tvplotlines => tvplot}/models.py (95%)
 rename src/{tvplotlines => tvplot}/narratology.py (98%)
 rename src/{tvplotlines => tvplot}/pass0.py (94%)
 rename src/{tvplotlines => tvplot}/pass1.py (97%)
 rename src/{tvplotlines => tvplot}/pass2.py (98%)
 rename src/{tvplotlines => tvplot}/pass3.py (97%)
 rename src/{tvplotlines => tvplot}/pass4.py (98%)
 rename src/{tvplotlines => tvplot}/pipeline.py (90%)
 rename src/{tvplotlines => tvplot}/postprocess.py (96%)
 rename src/{tvplotlines => tvplot}/prompts/__init__.py (97%)
 rename src/{tvplotlines => tvplot}/prompts/hollywood/__init__.py (100%)
 rename src/{tvplotlines => tvplot}/prompts/hollywood/glossary.md (100%)
 rename src/{tvplotlines => tvplot}/prompts/hollywood/pass0.md (100%)
 rename src/{tvplotlines => tvplot}/prompts/hollywood/pass1.md (100%)
 rename src/{tvplotlines => tvplot}/prompts/hollywood/pass2.md (100%)
 rename src/{tvplotlines => tvplot}/prompts/hollywood/pass3.md (100%)
 rename src/{tvplotlines => tvplot}/prompts/hollywood/pass4.md (100%)
 rename src/{tvplotlines => tvplot}/prompts/hollywood/synopses_writer.md (100%)
 rename src/{tvplotlines => tvplot}/prompts/narratology/__init__.py (100%)
 rename src/{tvplotlines => tvplot}/prompts/narratology/glossary.md (100%)
 rename src/{tvplotlines => tvplot}/prompts/narratology/pass1_context.md (100%)
 rename src/{tvplotlines => tvplot}/prompts/narratology/pass2_fabula.md (100%)
 rename src/{tvplotlines => tvplot}/prompts/narratology/pass3_actants.md (100%)
 rename src/{tvplotlines => tvplot}/prompts/narratology/pass4_story.md (100%)
 rename src/{tvplotlines => tvplot}/prompts/narratology/pass5_arc.md (100%)
 rename src/{tvplotlines => tvplot}/prompts/narratology/pass6_review.md (100%)
 rename src/{tvplotlines => tvplot}/prompts/narratology/synopses_writer.md (100%)
 rename src/{tvplotlines => tvplot}/py.typed (100%)
 rename src/{tvplotlines => tvplot}/synopses_writer.py (98%)
 rename src/{tvplotlines => tvplot}/verdicts.py (99%)
 delete mode 100644 src/tvplotlines/__main__.py

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6b45d64..8bb2c2c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,24 +1,27 @@
 # Changelog
 
-## Unreleased
+## 0.2.0 — 2026-04-15
+
+### Changed — BREAKING
+- **Package renamed `tvplotlines` → `tvplot`.** PyPI package, import path, CLI command, env vars, and localStorage keys all move. Migration: `pip install tvplot` and replace imports `from tvplotlines …` → `from tvplot …` and CLI invocations `tvplotlines run` → `tvplot run`. Env vars `TVPLOTLINES_OUTPUT_DIR` / `TVPLOTLINES_SYNOPSES_DIR` renamed to `TVPLOT_OUTPUT_DIR` / `TVPLOT_SYNOPSES_DIR`. `tvplotlines 0.1.0` on PyPI will be yanked with a "renamed to tvplot" notice.
 
 ### Added
 - **AI-use, privacy, and methodology docs** — `docs/ai-disclosure.md` documents the data flow (nothing reaches Alpine Animation — your inputs and API key travel straight from your machine to the LLM vendor), lists Anthropic's and OpenAI's applicable policies, and records a paper-trail for vendor-policy compliance. `docs/methodology.md` is the plain-language Art. 50 description of how the pipeline decides, what it can't do, and where to read the code. README links both, and the standalone HTML viewer carries a dismissible AI-assisted-content footer.
-- **Narratology pipeline — runnable**. New module `src/tvplotlines/narratology.py` implements all six passes (context, fabula, actants, story, arc, review). Results are emitted in the existing `TVPlotlinesResult` shape so the HTML viewer renders hollywood and narratology output unchanged. Actants (`who_chases`, `what_they_chase`, `stands_in_the_way`, `who_wins_if_it_works`) map onto `hero`, `goal`, `obstacle`, `stakes`. Pass 5 arc functions land in `Event.plot_fn`. Pass 6 verdicts apply in-place (MERGE/DROP/REASSIGN/REFUNCTION) and reviewed ranks override computed ranks.
+- **Narratology pipeline — runnable**. New module `src/tvplot/narratology.py` implements all six passes (context, fabula, actants, story, arc, review). Results are emitted in the existing `TVPlotlinesResult` shape so the HTML viewer renders hollywood and narratology output unchanged. Actants (`who_chases`, `what_they_chase`, `stands_in_the_way`, `who_wins_if_it_works`) map onto `hero`, `goal`, `obstacle`, `stakes`. Pass 5 arc functions land in `Event.plot_fn`. Pass 6 verdicts apply in-place (MERGE/DROP/REASSIGN/REFUNCTION) and reviewed ranks override computed ranks.
 - **Narratology in the browser viewer**. `runPipelineNarratology` in `pipeline.js` mirrors the Python orchestrator, runs all six passes via browser LLM calls (per-episode passes parallelised with `Promise.all`), and produces the same hollywood-compatible shape. `runPipeline` dispatches on the user's system choice. The "Narratology" option in LLM settings is now enabled.
-- **Prompts inlined at build time**. `src/tvplotlines/html/build.py` reads every `prompts/{hollywood,narratology}/*.md` and injects them into the HTML as a `_PROMPTS` object, so the viewer no longer carries a hardcoded copy that could drift from the source.
+- **Prompts inlined at build time**. `src/tvplot/html/build.py` reads every `prompts/{hollywood,narratology}/*.md` and injects them into the HTML as a `_PROMPTS` object, so the viewer no longer carries a hardcoded copy that could drift from the source.
 - **"Analyze a series" entry flow** in the HTML viewer. Welcome screen now takes a show name + season; the viewer asks the configured LLM for episode synopses, shows them in an editable preview, then runs the normal pipeline. Download the single HTML and you have an end-to-end app. Fallback — drag-and-drop `.txt` synopses — still works.
 - **Native PDF export** via lazy-loaded jsPDF (CDN). Generates a vector PDF directly from the loaded result: title page, per-plotline sections with actant/story-DNA fields and event lists, and an episode-by-episode appendix. Falls back to the browser print stack if the library can't be fetched (offline).
-- **Knowledge consolidated into the repo**. `3-resources/tvplotlines/*` → `docs/knowledge/` with `decisions/` (ADR 001-005), `specs/` (architecture, per-pass specs, mas4bw audit), `theory/`, `prompting/`, `results/` (reference BB S01-S05 outputs), `v3_narratology/` (67 evergreen notes across 9 sources), and `archive/` (old autoresearch + plans). Personal artifacts (the book and friends-post) stay in `3-resources/tvplotlines/`.
+- **Knowledge consolidated into the repo**. `3-resources/tvplot/*` → `docs/knowledge/` with `decisions/` (ADR 001-005), `specs/` (architecture, per-pass specs, mas4bw audit), `theory/`, `prompting/`, `results/` (reference BB S01-S05 outputs), `v3_narratology/` (67 evergreen notes across 9 sources), and `archive/` (old autoresearch + plans). Personal artifacts (the book and friends-post) stay in `3-resources/tvplot/`.
 
 ### Changed
 - **Prompt layout**: `prompts_en/` → `prompts/hollywood/`. Added `prompts/narratology/` from the former sister project, bundling eight structuralist prompts (context, fabula, actants, story, arc, review, synopses_writer, glossary). `docs/layered-schema.md` documents the shared `base + layers` JSON.
-- **Library API**: `get_plotlines(..., lang=)` replaced by `get_plotlines(..., system=)` (values: `"hollywood"` default, `"narratology"`). `LLMConfig.lang` → `LLMConfig.system`. CLI: `tvplotlines run --lang` → `--system`; `write-synopses --system` added.
+- **Library API**: `get_plotlines(..., lang=)` replaced by `get_plotlines(..., system=)` (values: `"hollywood"` default, `"narratology"`). `LLMConfig.lang` → `LLMConfig.system`. CLI: `tvplot run --lang` → `--system`; `write-synopses --system` added.
 - Narratology pipeline is not yet runnable — `system="narratology"` raises `NotImplementedError` with a clear message. Prompts are in place; runners come in v2.
 
 ### Removed
 - **Russian prompts** (`prompts_ru/`) — out of scope. Will be reintroduced once both analysis systems stabilise in English.
-- Sister repo `tvplotlines_narratology/` merged into this repo under `src/tvplotlines/prompts/narratology/`.
+- Sister repo `tvplot_narratology/` merged into this repo under `src/tvplot/prompts/narratology/`.
 
 ### Added
 - **Pass 4: arc functions** (`plot_fn`) — each event gets a season-arc role alongside its episode function. Pass 4 runs per-plotline, sees episode functions as context.
@@ -33,7 +36,7 @@
 - **CLI**: `--stop-after pass1` saves intermediate JSON, `--resume-from` resumes from it
 - **CLI**: `--output-dir` saves timestamped copy of results
 - **CLI**: `--no-glossary`, `--no-fandom`, `--fandom-wiki` flags for write-synopses
-- **Environment variables**: `TVPLOTLINES_OUTPUT_DIR`, `TVPLOTLINES_SYNOPSES_DIR` — default output locations
+- **Environment variables**: `TVPLOT_OUTPUT_DIR`, `TVPLOT_SYNOPSES_DIR` — default output locations
 - **Rules and formulas reference**: `docs/formulas.md`
 - Chain-of-thought nudge in all prompts before OUTPUT section
 
@@ -74,4 +77,4 @@ Initial open-source release.
 - Multi-season continuity via `prior` parameter
 - Providers: Anthropic (default), OpenAI, Ollama, DeepSeek, Groq, any OpenAI-compatible API
 - Pass 2 modes: parallel, batch (50% cheaper), sequential
-- CLI: `tvplotlines run`
+- CLI: `tvplot run`
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 274ee9e..7916253 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -3,8 +3,8 @@
 ## Setup
 
 ```bash
-git clone https://github.com/BirdInTheTree/tvplotlines.git
-cd tvplotlines
+git clone https://github.com/BirdInTheTree/tvplot.git
+cd tvplot
 pip install -e ".[dev]"
 ```
 
@@ -21,7 +21,7 @@ Tests use mocked LLM responses — no API key needed.
 - Python 3.11+
 - Type hints on public functions
 - `verb_noun` naming: `extract_plotlines`, `detect_context`
-- Prompts live in `src/tvplotlines/prompts_en/` as markdown files
+- Prompts live in `src/tvplot/prompts_en/` as markdown files
 
 ## Pull requests
 
diff --git a/README.md b/README.md
index def4859..56754b0 100644
--- a/README.md
+++ b/README.md
@@ -1,55 +1,55 @@
-# tvplotlines
+# tvplot
 
-[![PyPI](https://img.shields.io/pypi/v/tvplotlines?cacheSeconds=3600)](https://pypi.org/project/tvplotlines/)
+[![PyPI](https://img.shields.io/pypi/v/tvplot?cacheSeconds=3600)](https://pypi.org/project/tvplot/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![Python](https://img.shields.io/pypi/pyversions/tvplotlines?cacheSeconds=3600)](https://pypi.org/project/tvplotlines/)
+[![Python](https://img.shields.io/pypi/pyversions/tvplot?cacheSeconds=3600)](https://pypi.org/project/tvplot/)
 
-Turn episode synopses into a writers' room corkboard — story engine, plotlines with their *story DNA* and *arcs* (see [glossary](src/tvplotlines/prompts/hollywood/glossary.md)) — in one function call.
+Turn episode synopses into a writers' room corkboard — story engine, plotlines with their *story DNA* and *arcs* (see [glossary](src/tvplot/prompts/hollywood/glossary.md)) — in one function call.
 
 For TV researchers, screenwriters, and anyone building narrative analysis tools or a tv series.
 
 <p align="center">
   <a href="https://birdinthetree.github.io/plotter-app/">
-    <img src="docs/images/app-screenshot-1.png" alt="tvplotlines output — plotline×episode grid for Breaking Bad S01">
+    <img src="docs/images/app-screenshot-1.png" alt="tvplot output — plotline×episode grid for Breaking Bad S01">
   </a>
   <br>
   <strong><a href="https://birdinthetree.github.io/plotter-app/">Try the interactive demo →</a></strong>
 </p>
 
-A naive LLM prompt covers 5–12% of a season's source material. tvplotlines covers **78–91%** — by separating *what* the model looks for (narrative theory) from *how* it calculates the results (code).
+A naive LLM prompt covers 5–12% of a season's source material. tvplot covers **78–91%** — by separating *what* the model looks for (narrative theory) from *how* it calculates the results (code).
 
 ## Two ways to use it
 
-**Library / CLI** — `pip install tvplotlines`, point it at synopsis files, get JSON.
+**Library / CLI** — `pip install tvplot`, point it at synopsis files, get JSON.
 
 **Standalone HTML viewer** — one self-contained `.html` file that runs the whole pipeline in your browser. Type a show name, the viewer asks the LLM for synopses, runs the analysis, and renders the grid. No server, no dependencies — download the file and it works.
 
 ## Quick start (CLI)
 
 ```bash
-pip install tvplotlines
+pip install tvplot
 export ANTHROPIC_API_KEY=sk-ant-…
 ```
 
 Working on your own series? Point it at your synopses — one `.txt` file per episode (see [Input format](#input-format)):
 
 ```bash
-tvplotlines run my-series/
+tvplot run my-series/
 ```
 
 Want to analyze an existing show? The optional `writer` extension generates synopses from online sources:
 
 ```bash
-pip install 'tvplotlines[writer]'
-tvplotlines write-synopses "Mad Men" --season 1
-tvplotlines run mad-men/
+pip install 'tvplot[writer]'
+tvplot write-synopses "Mad Men" --season 1
+tvplot run mad-men/
 ```
 
 Generate a standalone HTML viewer alongside the JSON:
 
 ```bash
-tvplotlines run mad-men/ --html              # writes mad-men.json + mad-men.html
-tvplotlines run mad-men/ --html-output viewer.html
+tvplot run mad-men/ --html              # writes mad-men.json + mad-men.html
+tvplot run mad-men/ --html-output viewer.html
 ```
 
 Multiple seasons are supported — plotline continuity is tracked across seasons (see [Python API](#python-api)).
@@ -59,8 +59,8 @@ Pre-computed results are in [`examples/results/`](examples/results/) — explore
 ## Quick start (standalone viewer)
 
 ```bash
-python -m tvplotlines.html.build --output tvplotlines.html
-open tvplotlines.html
+python -m tvplot.html.build --output tvplot.html
+open tvplot.html
 ```
 
 Then in the browser:
@@ -180,13 +180,13 @@ breaking-bad/
 The folder name becomes the show title. Override with `--show`:
 
 ```bash
-tvplotlines run got/ --show "Game of Thrones"
+tvplot run got/ --show "Game of Thrones"
 ```
 
 ## Python API
 
 ```python
-from tvplotlines import get_plotlines
+from tvplot import get_plotlines
 
 s01 = get_plotlines("Breaking Bad", season=1, episodes=season_1_synopses)
 s02 = get_plotlines("Breaking Bad", season=2, episodes=season_2_synopses, prior=s01)
@@ -202,10 +202,10 @@ Pass `prior` to track plotline continuity across seasons.
 ## LLM providers
 
 ```bash
-tvplotlines run breaking-bad/                          # Anthropic (default)
-tvplotlines run breaking-bad/ --provider openai        # OpenAI
-tvplotlines run breaking-bad/ --provider ollama        # Ollama (local, free)
-tvplotlines run breaking-bad/ --system narratology     # narratology pipeline
+tvplot run breaking-bad/                          # Anthropic (default)
+tvplot run breaking-bad/ --provider openai        # OpenAI
+tvplot run breaking-bad/ --provider ollama        # Ollama (local, free)
+tvplot run breaking-bad/ --system narratology     # narratology pipeline
 ```
 
 See [docs/api.md](docs/api.md) for full API reference.
@@ -222,7 +222,7 @@ See [docs/api.md](docs/api.md) for full API reference.
 
 ## How this uses AI
 
-`tvplotlines` calls either Claude (Anthropic) or GPT (OpenAI) — you pick one per run — to produce its analyses. If your application surfaces this library's output to end users, you're responsible for disclosing the AI involvement to them (EU AI Act Art. 50; Anthropic AUP; OpenAI Usage Policies). The standalone HTML viewer shipped here carries that notice in its footer.
+`tvplot` calls either Claude (Anthropic) or GPT (OpenAI) — you pick one per run — to produce its analyses. If your application surfaces this library's output to end users, you're responsible for disclosing the AI involvement to them (EU AI Act Art. 50; Anthropic AUP; OpenAI Usage Policies). The standalone HTML viewer shipped here carries that notice in its footer.
 
 - [`docs/ai-disclosure.md`](docs/ai-disclosure.md) — what gets sent where, and to whom. Alpine Animation (Switzerland) publishes the library and collects **no** data; your API key and inputs travel directly from your machine to the LLM vendor you pick.
 - [`docs/methodology.md`](docs/methodology.md) — plain-language description of how the pipeline decides, what it can't do, and where to find the code for each step.
@@ -232,11 +232,11 @@ Outputs are AI-generated and can contain hallucinations. Treat them as a startin
 ## Citation
 
 ```bibtex
-@software{tvplotlines2026,
+@software{tvplot2026,
   author = {Vashko, N.},
-  title = {tvplotlines: LLM-Driven Plotline Extraction from Episode Synopses},
+  title = {tvplot: LLM-Driven Plotline Extraction from Episode Synopses},
   year = {2026},
-  url = {https://github.com/BirdInTheTree/tvplotlines}
+  url = {https://github.com/BirdInTheTree/tvplot}
 }
 ```
 
diff --git a/docs/ai-disclosure.md b/docs/ai-disclosure.md
index ea16c32..3bc366a 100644
--- a/docs/ai-disclosure.md
+++ b/docs/ai-disclosure.md
@@ -1,8 +1,8 @@
 # AI disclosure, privacy, and vendor policy
 
-`tvplotlines` uses a third-party LLM — either Claude (Anthropic) or GPT (OpenAI), whichever you configure — to analyse TV-episode synopses. This page is the single source of truth for what that means in practice, who sees what, and which policies apply.
+`tvplot` uses a third-party LLM — either Claude (Anthropic) or GPT (OpenAI), whichever you configure — to analyse TV-episode synopses. This page is the single source of truth for what that means in practice, who sees what, and which policies apply.
 
-**Publisher:** Alpine Animation (Switzerland) · **Contact:** <tvplotlines@alpineanimation.ch> or open an issue at <https://github.com/BirdInTheTree/tvplotlines/issues>
+**Publisher:** Alpine Animation (Switzerland) · **Contact:** <tvplot@alpineanimation.ch> or open an issue at <https://github.com/BirdInTheTree/tvplot/issues>
 
 ---
 
@@ -12,7 +12,7 @@ The library and the standalone HTML viewer both run on the user's own machine. N
 
 | What you do | What happens |
 |---|---|
-| Run `tvplotlines run my-show/` or the HTML viewer locally | Your episode synopses, your analysis system choice, and your API key travel directly from your process (terminal or browser) to the LLM provider you picked |
+| Run `tvplot run my-show/` or the HTML viewer locally | Your episode synopses, your analysis system choice, and your API key travel directly from your process (terminal or browser) to the LLM provider you picked |
 | Results arrive | They are written to disk (CLI) or rendered in your browser (viewer) — nothing is uploaded anywhere |
 | You export JSON / CSV / FDX / PDF | Files are saved locally; nothing leaves your machine |
 
@@ -29,7 +29,7 @@ Both providers are US-based; if you pick one, the cross-border transfer of your
 
 ## AI-generated content notice
 
-Outputs produced by `tvplotlines` are generated by large language models. They can contain factual errors, invented plot details that sound plausible, and misreadings of intent. Treat the results as a starting point for your own analysis, not a verified source.
+Outputs produced by `tvplot` are generated by large language models. They can contain factual errors, invented plot details that sound plausible, and misreadings of intent. Treat the results as a starting point for your own analysis, not a verified source.
 
 Downstream applications that surface these outputs to other users are responsible for displaying an equivalent notice (EU AI Act Art. 50; Anthropic AUP; OpenAI Usage Policies). The HTML viewer shipped with this repo carries that notice in its footer.
 
@@ -37,9 +37,9 @@ Downstream applications that surface these outputs to other users are responsibl
 
 ## Your rights (Swiss nFADP / EU GDPR)
 
-Because Alpine Animation holds no personal data about you, the usual access / rectification / deletion requests don't have anything to act on here. If Anthropic or OpenAI hold data from your use of their API, those requests go to them, not to us. We'll still help route a request to the right place — write to <tvplotlines@alpineanimation.ch> (or open a GitHub issue) and we'll point you at the contact channel.
+Because Alpine Animation holds no personal data about you, the usual access / rectification / deletion requests don't have anything to act on here. If Anthropic or OpenAI hold data from your use of their API, those requests go to them, not to us. We'll still help route a request to the right place — write to <tvplot@alpineanimation.ch> (or open a GitHub issue) and we'll point you at the contact channel.
 
-If you believe `tvplotlines` itself — the code, the prompts, the docs — handles data in a way this page doesn't describe, that's a bug: please open an issue so we can either fix the code or fix the page.
+If you believe `tvplot` itself — the code, the prompts, the docs — handles data in a way this page doesn't describe, that's a bug: please open an issue so we can either fix the code or fix the page.
 
 ---
 
@@ -49,8 +49,8 @@ Use case: **structural analysis of fictional TV-episode synopses** — extractin
 
 Three input paths are supported, all feeding the same pipeline:
 
-1. **User-supplied** `.txt` synopses (CLI: `tvplotlines run my-show/`).
-2. **Wikipedia/Fandom-scraped** raw episode descriptions rewritten into full synopses by the LLM (CLI: `tvplotlines write-synopses "Show Name"`).
+1. **User-supplied** `.txt` synopses (CLI: `tvplot run my-show/`).
+2. **Wikipedia/Fandom-scraped** raw episode descriptions rewritten into full synopses by the LLM (CLI: `tvplot write-synopses "Show Name"`).
 3. **LLM-generated from its own training memory** — the HTML viewer's "Analyze a series" flow asks the configured LLM to produce episode-by-episode synopses for a public show from what it already knows, then lets the user edit them before the pipeline runs.
 
 In paths 2 and 3 the synopsis text itself is AI-generated. The viewer's footer makes the AI involvement explicit; users of path 2 (CLI) can inspect the generated `.txt` files before running analysis.
diff --git a/docs/api.md b/docs/api.md
index 839bb9f..72623c9 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -5,7 +5,7 @@
 Main entry point. Extracts plotlines from a season of TV synopses via an LLM pipeline.
 
 ```python
-from tvplotlines import get_plotlines
+from tvplot import get_plotlines
 
 result = get_plotlines(
     show="House",
@@ -135,32 +135,32 @@ Narratology runs its per-episode passes (fabula, story) in `parallel` mode uncon
 
 ## LLM providers
 
-tvplotlines works with Anthropic (default) and any OpenAI-compatible API.
+tvplot works with Anthropic (default) and any OpenAI-compatible API.
 
 ```bash
 # Anthropic (default)
 export ANTHROPIC_API_KEY=sk-ant-...
-tvplotlines run house/
+tvplot run house/
 
 # OpenAI
 export OPENAI_API_KEY=sk-...
-tvplotlines run house/ --provider openai
+tvplot run house/ --provider openai
 
 # Ollama (local, free)
 ollama pull qwen2.5:14b
-tvplotlines run house/ --provider ollama
+tvplot run house/ --provider ollama
 
 # DeepSeek
 export DEEPSEEK_API_KEY=sk-...
-tvplotlines run house/ --provider deepseek
+tvplot run house/ --provider deepseek
 
 # Any OpenAI-compatible endpoint
-tvplotlines run house/ --provider openai \
+tvplot run house/ --provider openai \
     --base-url https://api.together.xyz/v1 \
     --model meta-llama/Llama-3-70b
 
 # Pick the analysis system
-tvplotlines run house/ --system narratology
+tvplot run house/ --system narratology
 ```
 
 In Python:
@@ -179,7 +179,7 @@ result = get_plotlines(
 ## CLI flags
 
 ```
-tvplotlines run <files|dir> [options]
+tvplot run <files|dir> [options]
 
   --show NAME               Override inferred show title
   --season N                Override inferred season
@@ -198,7 +198,7 @@ tvplotlines run <files|dir> [options]
 ```
 
 ```
-tvplotlines write-synopses SHOW [options]
+tvplot write-synopses SHOW [options]
 
   --season N                Season number (default: 1)
   --system hollywood|narratology   Which synopsis-writer prompt to use
@@ -214,7 +214,7 @@ tvplotlines write-synopses SHOW [options]
 
 ## Format
 
-tvplotlines classifies shows into four structural formats that determine how plotlines are extracted:
+tvplot classifies shows into four structural formats that determine how plotlines are extracted:
 
 - **Procedural** — self-contained episode stories (House, CSI)
 - **Serial** — continuous arcs across episodes (Breaking Bad, The Wire)
diff --git a/docs/formulas.md b/docs/formulas.md
index 6ca0437..bb84ef7 100644
--- a/docs/formulas.md
+++ b/docs/formulas.md
@@ -5,7 +5,7 @@ If you're reading a rule in the code or a prompt and wondering why it's there, t
 **LLM** = the LLM follows this rule from the prompt.
 **Code** = deterministic computation.
 
-Code paths relative to `src/tvplotlines/`.
+Code paths relative to `src/tvplot/`.
 
 The sections below cover the **hollywood** system (5 passes). The **narratology** system is documented in the "Narratology pipeline" section at the end — it reuses the same prompt-loader and model shapes, but has its own six-pass flow.
 
@@ -254,7 +254,7 @@ A six-pass alternative to the five-pass hollywood flow. Prompts live under `prom
 
 ### Glossary
 
-See `src/tvplotlines/prompts/narratology/glossary.md` for `function` (8 values including `recognition`), `direction` (3), `kind` (2), and the full actant mapping.
+See `src/tvplot/prompts/narratology/glossary.md` for `function` (8 values including `recognition`), `direction` (3), `kind` (2), and the full actant mapping.
 
 ### Result shape
 
diff --git a/docs/index.md b/docs/index.md
index d6cd6f7..9404c70 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,4 +1,4 @@
-# tvplotlines
+# tvplot
 
 A Python library — and a standalone HTML viewer — that extracts plotlines from a season of TV synopses using LLMs.
 
@@ -8,8 +8,8 @@ Feed episode synopses → get structured plotlines, character arcs, and per-epis
 
 Three ways to run it:
 
-- **Python library** — `from tvplotlines import get_plotlines`
-- **CLI** — `tvplotlines run my-show/ [--system narratology] [--html]`
+- **Python library** — `from tvplot import get_plotlines`
+- **CLI** — `tvplot run my-show/ [--system narratology] [--html]`
 - **Standalone HTML viewer** — one self-contained file that runs the whole pipeline in the browser, takes a show name + season, fetches synopses from the LLM, and renders the grid
 
 ## Quick links
diff --git a/docs/layered-schema.md b/docs/layered-schema.md
index 7eb0d6a..5a30344 100644
--- a/docs/layered-schema.md
+++ b/docs/layered-schema.md
@@ -153,11 +153,11 @@ Pass 3 emits actants with plain-English keys; `prompts/narratology/glossary.md`
 }
 ```
 
-Enums: see `src/tvplotlines/prompts/narratology/glossary.md` for `function` (8 values), `direction` (3), `kind` (2).
+Enums: see `src/tvplot/prompts/narratology/glossary.md` for `function` (8 values), `direction` (3), `kind` (2).
 
 **episodes**: map from episode id → {theme}
 
-### `hollywood` (for backward compatibility with tvplotlines)
+### `hollywood` (for backward compatibility with tvplot)
 
 Version 1.0.
 
@@ -187,9 +187,9 @@ No plotlines-specific fields — kishōtenketsu does not analyze plotlines as se
 - **Graceful degradation**: the viewer shows whatever layer is selected. If a layer lacks a field the viewer expects, the viewer shows a placeholder.
 - **Multiple layers per file**: a single file can contain many layers. Useful for comparative study.
 
-## Converting old tvplotlines output
+## Converting old tvplot output
 
-Old `tvplotlines` JSON has a flat structure with Hollywood-only fields. Converter:
+Old `tvplot` JSON has a flat structure with Hollywood-only fields. Converter:
 
 1. Extract `context`, `cast`, `episodes`, events (flatten per-episode `events` lists), plotlines, and assignments → `base`.
 2. Extract Hollywood fields (hero/goal/obstacle/stakes, function, interactions, rank, etc.) → `layers[hollywood]`.
diff --git a/docs/methodology.md b/docs/methodology.md
index 8a01d67..0ac2be1 100644
--- a/docs/methodology.md
+++ b/docs/methodology.md
@@ -1,8 +1,8 @@
-# Methodology — how tvplotlines uses AI
+# Methodology — how tvplot uses AI
 
 **Last updated:** 2026-04-15 · **Publisher:** Alpine Animation (Switzerland)
 
-Plain-language description of how the AI in `tvplotlines` works, as required by EU AI Act Art. 50(1)(c). This page stays concise; `formulas.md` has the full rule-by-rule breakdown.
+Plain-language description of how the AI in `tvplot` works, as required by EU AI Act Art. 50(1)(c). This page stays concise; `formulas.md` has the full rule-by-rule breakdown.
 
 ## What the AI does
 
@@ -11,14 +11,14 @@ Plain-language description of how the AI in `tvplotlines` works, as required by
 The pipeline needs one synopsis per episode. Three paths land there, all via the same LLM you configure:
 
 - **You supply them** as `.txt` files you wrote or collected yourself.
-- **The library fetches them** — `tvplotlines write-synopses "Show Name"` pulls raw episode rows from Wikipedia (and Fandom, when available), then asks the LLM to rewrite each into a 150–500-word beat-dense synopsis. The rewritten `.txt` files are written to disk so you can inspect them before running the extraction.
+- **The library fetches them** — `tvplot write-synopses "Show Name"` pulls raw episode rows from Wikipedia (and Fandom, when available), then asks the LLM to rewrite each into a 150–500-word beat-dense synopsis. The rewritten `.txt` files are written to disk so you can inspect them before running the extraction.
 - **The model writes them from memory** — the HTML viewer's "Analyze a series" flow asks the LLM for episode synopses of a public show based on its own training data, then shows them to you in an editable preview before the pipeline runs.
 
 In the last two paths the synopsis text is itself AI-generated. The library surfaces this fact (files on disk, editable preview), and the HTML viewer's footer repeats the disclosure.
 
 ### Step 1–N: extraction
 
-Given the synopses, `tvplotlines` extracts structured analysis:
+Given the synopses, `tvplot` extracts structured analysis:
 
 - The **story engine** (one-sentence logline of the show's dramatic mechanism).
 - The **format** (procedural, serial, hybrid, ensemble).
@@ -37,13 +37,13 @@ The pipeline is **not** one LLM call. It is 5 or 6 small prompts, each with a na
 | hollywood | Pass 0 (context) → Pass 1 (plotlines, 3× majority vote) → Pass 2 (per-episode events) → Pass 3 (structural review) → Pass 4 (arc functions) |
 | narratology | 1 context → 2 fabula → 3 actants → 4 story → 5 arc → 6 review |
 
-Each prompt lives as a `.md` file under `src/tvplotlines/prompts/{hollywood,narratology}/`. The prompts encode narrative-theory rules (what a plotline is, what a setup vs climax is, when to merge two plotlines, what ranks mean). Between passes, `postprocess.py` computes objective things deterministically: event counts, plotline spans, ranks derived from event counts, orphan-event reassignment by character voting. The LLM is asked for judgements; the code is what tracks totals.
+Each prompt lives as a `.md` file under `src/tvplot/prompts/{hollywood,narratology}/`. The prompts encode narrative-theory rules (what a plotline is, what a setup vs climax is, when to merge two plotlines, what ranks mean). Between passes, `postprocess.py` computes objective things deterministically: event counts, plotline spans, ranks derived from event counts, orphan-event reassignment by character voting. The LLM is asked for judgements; the code is what tracks totals.
 
 When two passes disagree (for example, code-computed rank vs LLM-reviewed rank), both values are kept in the output — the user sees the disagreement.
 
 ## Why this split
 
-A naive single-prompt LLM extraction covers 5–12% of a season's source material; our measurements put `tvplotlines` at 78–91%. The gap comes from separating *what to look for* (narrative theory, written into the prompts) from *how to tally it* (deterministic code). Neither half is "AI deciding everything".
+A naive single-prompt LLM extraction covers 5–12% of a season's source material; our measurements put `tvplot` at 78–91%. The gap comes from separating *what to look for* (narrative theory, written into the prompts) from *how to tally it* (deterministic code). Neither half is "AI deciding everything".
 
 ## What it cannot do
 
@@ -54,23 +54,23 @@ A naive single-prompt LLM extraction covers 5–12% of a season's source materia
 
 ## Training and data
 
-The supported LLMs (Claude by Anthropic, GPT by OpenAI — the user picks one per run) are trained by their respective vendors on corpora those vendors do not fully disclose. **Alpine Animation does not train or fine-tune any model** — the library sends prompts to the vendor at runtime and consumes the response. No tvplotlines-specific training data exists.
+The supported LLMs (Claude by Anthropic, GPT by OpenAI — the user picks one per run) are trained by their respective vendors on corpora those vendors do not fully disclose. **Alpine Animation does not train or fine-tune any model** — the library sends prompts to the vendor at runtime and consumes the response. No tvplot-specific training data exists.
 
 See [`ai-disclosure.md`](ai-disclosure.md) for the data-flow details and vendor policy links.
 
 ## Where to check what the code actually does
 
-- `src/tvplotlines/pipeline.py` — orchestrator for the hollywood flow
-- `src/tvplotlines/narratology.py` — orchestrator for the narratology flow
-- `src/tvplotlines/pass{0,1,2,3,4}.py` — per-pass hollywood logic
-- `src/tvplotlines/postprocess.py` — deterministic span / rank / orphan-assignment logic
-- `src/tvplotlines/prompts/{hollywood,narratology}/*.md` — every prompt the LLM receives
+- `src/tvplot/pipeline.py` — orchestrator for the hollywood flow
+- `src/tvplot/narratology.py` — orchestrator for the narratology flow
+- `src/tvplot/pass{0,1,2,3,4}.py` — per-pass hollywood logic
+- `src/tvplot/postprocess.py` — deterministic span / rank / orphan-assignment logic
+- `src/tvplot/prompts/{hollywood,narratology}/*.md` — every prompt the LLM receives
 - [`formulas.md`](formulas.md) — every rule, threshold, and computation documented at one level above the code
 
 ## Limitations under EU AI Act
 
-`tvplotlines` is a **general-purpose tool** for narrative analysis. It is not deployed in any Annex III high-risk context (law enforcement, essential public services, employment decisions). If an integrator puts it in one of those contexts, that integrator assumes the stricter Annex III obligations (Art. 11, Art. 12 technical documentation) — this methodology is not sufficient on its own for those cases.
+`tvplot` is a **general-purpose tool** for narrative analysis. It is not deployed in any Annex III high-risk context (law enforcement, essential public services, employment decisions). If an integrator puts it in one of those contexts, that integrator assumes the stricter Annex III obligations (Art. 11, Art. 12 technical documentation) — this methodology is not sufficient on its own for those cases.
 
 ## Contact for methodology questions
 
-Write to <tvplotlines@alpineanimation.ch> or open an issue at <https://github.com/BirdInTheTree/tvplotlines/issues>.
+Write to <tvplot@alpineanimation.ch> or open an issue at <https://github.com/BirdInTheTree/tvplot/issues>.
diff --git a/docs/quickstart.md b/docs/quickstart.md
index fbc754b..a3d5a7e 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -3,7 +3,7 @@
 ## Install
 
 ```bash
-pip install tvplotlines
+pip install tvplot
 export ANTHROPIC_API_KEY=sk-ant-...   # Anthropic (default)
 # or
 export OPENAI_API_KEY=sk-...          # OpenAI, DeepSeek, Groq, any OpenAI-compatible
@@ -23,26 +23,26 @@ breaking-bad/
 ## CLI — analyze a folder
 
 ```bash
-tvplotlines run breaking-bad/
+tvplot run breaking-bad/
 ```
 
 The show name is taken from the folder name. Override with `--show` if needed:
 
 ```bash
-tvplotlines run got/ --show "Game of Thrones"
+tvplot run got/ --show "Game of Thrones"
 ```
 
 Pick the analysis system — `hollywood` (default, screenwriting model) or `narratology` (structuralist):
 
 ```bash
-tvplotlines run breaking-bad/ --system narratology
+tvplot run breaking-bad/ --system narratology
 ```
 
 Produce a standalone HTML viewer alongside the JSON (opens in any browser, no server needed):
 
 ```bash
-tvplotlines run breaking-bad/ --html                       # writes …/breaking-bad.html
-tvplotlines run breaking-bad/ --html-output viewer.html    # custom path
+tvplot run breaking-bad/ --html                       # writes …/breaking-bad.html
+tvplot run breaking-bad/ --html-output viewer.html    # custom path
 ```
 
 ## Standalone viewer — analyze from the browser
@@ -50,8 +50,8 @@ tvplotlines run breaking-bad/ --html-output viewer.html    # custom path
 Build the viewer once, then ship the `.html` file anywhere:
 
 ```bash
-python -m tvplotlines.html.build --output tvplotlines.html
-open tvplotlines.html
+python -m tvplot.html.build --output tvplot.html
+open tvplot.html
 ```
 
 In the viewer:
@@ -66,7 +66,7 @@ If the model doesn't know the show, drop your own `.txt` files via **+ Load**.
 ## Python
 
 ```python
-from tvplotlines import load_synopses_dir, get_plotlines
+from tvplot import load_synopses_dir, get_plotlines
 
 show, season, episodes = load_synopses_dir("breaking-bad/")
 result = get_plotlines(show, season, episodes)
diff --git a/examples/run_pipeline.py b/examples/run_pipeline.py
index 217c971..0c58b85 100644
--- a/examples/run_pipeline.py
+++ b/examples/run_pipeline.py
@@ -1,13 +1,13 @@
-"""Example: run tvplotlines pipeline on synopsis files and save result.
+"""Example: run tvplot pipeline on synopsis files and save result.
 
 Equivalent CLI command:
-    tvplotlines run synopses/BB_S01E*.txt --show "Breaking Bad" --season 1 -o result.json
+    tvplot run synopses/BB_S01E*.txt --show "Breaking Bad" --season 1 -o result.json
 """
 
 import json
 from pathlib import Path
 
-from tvplotlines import get_plotlines
+from tvplot import get_plotlines
 
 SYNOPSES_DIR = Path("synopses")
 
diff --git a/pyproject.toml b/pyproject.toml
index 2005ace..087b6c5 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,69 +1,69 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "tvplotlines"
-version = "0.1.0"
-description = "Extract plotlines from TV series synopses using LLM"
-readme = "README.md"
-license = "MIT"
-requires-python = ">=3.11"
-authors = [{name = "BirdInTheTree", email = "51715433+BirdInTheTree@users.noreply.github.com"}]
-keywords = [
-    "plotline",
-    "narrative",
-    "tv-series",
-    "plot-extraction",
-    "llm",
-    "narrative-analysis",
-    "synopsis",
-]
-classifiers = [
-    "Development Status :: 3 - Alpha",
-    "Intended Audience :: Developers",
-    "Intended Audience :: Science/Research",
-    "License :: OSI Approved :: MIT License",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
-    "Topic :: Scientific/Engineering :: Artificial Intelligence",
-    "Topic :: Text Processing :: Linguistic",
-]
-
-dependencies = [
-    "anthropic>=0.40",
-    "openai>=1.50",
-    "scikit-learn>=1.4",
-]
-
-[project.urls]
-Repository = "https://github.com/BirdInTheTree/tvplotlines"
-Documentation = "https://github.com/BirdInTheTree/tvplotlines/tree/main/docs"
-
-[project.optional-dependencies]
-dotenv = ["python-dotenv>=1.0"]
-writer = [
-    "httpx>=0.27",
-    "beautifulsoup4>=4.12",
-]
-dev = [
-    "pytest>=8.0",
-    "pytest-asyncio>=0.24",
-    "python-dotenv>=1.0",
-    "httpx>=0.27",
-    "beautifulsoup4>=4.12",
-]
-
-[project.scripts]
-tvplotlines = "tvplotlines.cli:main"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/tvplotlines"]
-artifacts = [
-    "src/tvplotlines/prompts/hollywood/*.md",
-    "src/tvplotlines/prompts/narratology/*.md",
-]
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tvplot"
+version = "0.2.0"
+description = "Extract plotlines from TV series synopses using LLM"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [{name = "BirdInTheTree", email = "51715433+BirdInTheTree@users.noreply.github.com"}]
+keywords = [
+    "plotline",
+    "narrative",
+    "tv-series",
+    "plot-extraction",
+    "llm",
+    "narrative-analysis",
+    "synopsis",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Text Processing :: Linguistic",
+]
+
+dependencies = [
+    "anthropic>=0.40",
+    "openai>=1.50",
+    "scikit-learn>=1.4",
+]
+
+[project.urls]
+Repository = "https://github.com/BirdInTheTree/tvplot"
+Documentation = "https://github.com/BirdInTheTree/tvplot/tree/main/docs"
+
+[project.optional-dependencies]
+dotenv = ["python-dotenv>=1.0"]
+writer = [
+    "httpx>=0.27",
+    "beautifulsoup4>=4.12",
+]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.24",
+    "python-dotenv>=1.0",
+    "httpx>=0.27",
+    "beautifulsoup4>=4.12",
+]
+
+[project.scripts]
+tvplot = "tvplot.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tvplot"]
+artifacts = [
+    "src/tvplot/prompts/hollywood/*.md",
+    "src/tvplot/prompts/narratology/*.md",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
diff --git a/src/tvplotlines/__init__.py b/src/tvplot/__init__.py
similarity index 54%
rename from src/tvplotlines/__init__.py
rename to src/tvplot/__init__.py
index e0c401f..261a9e6 100644
--- a/src/tvplotlines/__init__.py
+++ b/src/tvplot/__init__.py
@@ -1,32 +1,32 @@
-"""tvplotlines — extract plotlines from TV series synopses using LLM."""
-
-from tvplotlines.callbacks import PipelineCallback
-from tvplotlines.models import (
-    CastMember,
-    EpisodeBreakdown,
-    Event,
-    Interaction,
-    Plotline,
-    TVPlotlinesResult,
-    SeriesContext,
-    Verdict,
-)
-from tvplotlines.input import load_synopses_dir
-from tvplotlines.llm import UsageStats, usage
-from tvplotlines.pipeline import get_plotlines
-
-__all__ = [
-    "get_plotlines",
-    "load_synopses_dir",
-    "PipelineCallback",
-    "CastMember",
-    "EpisodeBreakdown",
-    "Event",
-    "Interaction",
-    "Plotline",
-    "TVPlotlinesResult",
-    "SeriesContext",
-    "UsageStats",
-    "usage",
-    "Verdict",
-]
+"""tvplot — extract plotlines from TV series synopses using LLM."""
+
+from tvplot.callbacks import PipelineCallback
+from tvplot.models import (
+    CastMember,
+    EpisodeBreakdown,
+    Event,
+    Interaction,
+    Plotline,
+    TVPlotlinesResult,
+    SeriesContext,
+    Verdict,
+)
+from tvplot.input import load_synopses_dir
+from tvplot.llm import UsageStats, usage
+from tvplot.pipeline import get_plotlines
+
+__all__ = [
+    "get_plotlines",
+    "load_synopses_dir",
+    "PipelineCallback",
+    "CastMember",
+    "EpisodeBreakdown",
+    "Event",
+    "Interaction",
+    "Plotline",
+    "TVPlotlinesResult",
+    "SeriesContext",
+    "UsageStats",
+    "usage",
+    "Verdict",
+]
diff --git a/src/tvplot/__main__.py b/src/tvplot/__main__.py
new file mode 100644
index 0000000..aeb65a5
--- /dev/null
+++ b/src/tvplot/__main__.py
@@ -0,0 +1,4 @@
+"""Allow running tvplot as: python -m tvplot run ..."""
+from tvplot.cli import main
+
+main()
diff --git a/src/tvplotlines/callbacks.py b/src/tvplot/callbacks.py
similarity index 94%
rename from src/tvplotlines/callbacks.py
rename to src/tvplot/callbacks.py
index 3c27573..079f938 100644
--- a/src/tvplotlines/callbacks.py
+++ b/src/tvplot/callbacks.py
@@ -1,57 +1,57 @@
-"""Pipeline progress callbacks.
-
-Subclass PipelineCallback and override methods to receive notifications
-at each pipeline stage. The library never writes files — persistence
-is the caller's choice via these hooks.
-"""
-
-from __future__ import annotations
-
-from typing import TYPE_CHECKING
-
-if TYPE_CHECKING:
-    from tvplotlines.models import (
-        CastMember,
-        EpisodeBreakdown,
-        Plotline,
-        SeriesContext,
-        Verdict,
-    )
-
-
-class PipelineCallback:
-    """Override any method to receive progress notifications.
-
-    All methods are no-ops by default. Subclass and override what you need.
-    The pipeline wraps every call in try/except so a buggy callback
-    never kills the run.
-    """
-
-    def on_pass0_complete(self, context: SeriesContext) -> None:
-        """Called after context detection (Pass 0)."""
-
-    def on_pass1_complete(
-        self, cast: list[CastMember], plotlines: list[Plotline],
-    ) -> None:
-        """Called after plotline extraction (Pass 1)."""
-
-    def on_episode_complete(
-        self, index: int, breakdown: EpisodeBreakdown,
-    ) -> None:
-        """Called after each episode is processed.
-
-        Only fires in sequential mode (pass2_mode="sequential").
-        In parallel and batch modes, use on_pass2_complete instead.
-        """
-
-    def on_pass2_complete(self, breakdowns: list[EpisodeBreakdown]) -> None:
-        """Called after all episodes are processed (Pass 2)."""
-
-    def on_batch_submitted(self, batch_id: str) -> None:
-        """Called with batch ID immediately after batch creation."""
-
-    def on_pass3_complete(self, verdicts: list[Verdict]) -> None:
-        """Called after structural review (Pass 3)."""
-
-    def on_pass4_complete(self, count: int) -> None:
-        """Called after arc function assignment (Pass 4)."""
+"""Pipeline progress callbacks.
+
+Subclass PipelineCallback and override methods to receive notifications
+at each pipeline stage. The library never writes files — persistence
+is the caller's choice via these hooks.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from tvplot.models import (
+        CastMember,
+        EpisodeBreakdown,
+        Plotline,
+        SeriesContext,
+        Verdict,
+    )
+
+
+class PipelineCallback:
+    """Override any method to receive progress notifications.
+
+    All methods are no-ops by default. Subclass and override what you need.
+    The pipeline wraps every call in try/except so a buggy callback
+    never kills the run.
+    """
+
+    def on_pass0_complete(self, context: SeriesContext) -> None:
+        """Called after context detection (Pass 0)."""
+
+    def on_pass1_complete(
+        self, cast: list[CastMember], plotlines: list[Plotline],
+    ) -> None:
+        """Called after plotline extraction (Pass 1)."""
+
+    def on_episode_complete(
+        self, index: int, breakdown: EpisodeBreakdown,
+    ) -> None:
+        """Called after each episode is processed.
+
+        Only fires in sequential mode (pass2_mode="sequential").
+        In parallel and batch modes, use on_pass2_complete instead.
+        """
+
+    def on_pass2_complete(self, breakdowns: list[EpisodeBreakdown]) -> None:
+        """Called after all episodes are processed (Pass 2)."""
+
+    def on_batch_submitted(self, batch_id: str) -> None:
+        """Called with batch ID immediately after batch creation."""
+
+    def on_pass3_complete(self, verdicts: list[Verdict]) -> None:
+        """Called after structural review (Pass 3)."""
+
+    def on_pass4_complete(self, count: int) -> None:
+        """Called after arc function assignment (Pass 4)."""
diff --git a/src/tvplotlines/cli.py b/src/tvplot/cli.py
similarity index 91%
rename from src/tvplotlines/cli.py
rename to src/tvplot/cli.py
index f064067..334e4db 100644
--- a/src/tvplotlines/cli.py
+++ b/src/tvplot/cli.py
@@ -1,405 +1,405 @@
-"""CLI for tvplotlines: extract plotlines from TV series synopses.
-
-Usage:
-    tvplotlines run breaking-bad/
-    tvplotlines run breaking-bad/ --show "Breaking Bad"
-    tvplotlines run S01E01.txt S01E02.txt --show "House" --season 1
-"""
-
-from __future__ import annotations
-
-import argparse
-import json
-import re
-import sys
-from pathlib import Path
-
-_EPISODE_ID_RE = re.compile(r"S\d{2}E\d{2}")
-
-
-from tvplotlines.callbacks import PipelineCallback
-
-
-class _CLICallback(PipelineCallback):
-    """Print one line per pipeline stage."""
-
-    def on_pass0_complete(self, context):
-        print(f"  Pass 0 done: {context.format} | {context.story_engine}")
-
-    def on_pass1_complete(self, cast, plotlines):
-        print(f"  Pass 1 done: {len(plotlines)} plotlines, {len(cast)} cast")
-
-    def on_batch_submitted(self, batch_id):
-        print(f"  Pass 2 batch submitted: {batch_id}")
-
-    def on_pass2_complete(self, breakdowns):
-        print(f"  Pass 2 done: {len(breakdowns)} episodes")
-
-    def on_pass3_complete(self, verdicts):
-        print(f"  Pass 3 done: {len(verdicts)} verdicts applied")
-
-    def on_pass4_complete(self, count):
-        print(f"  Pass 4 done: {count} arc functions assigned")
-
-
-def _run(args: argparse.Namespace) -> None:
-    """Run the full pipeline on synopsis files."""
-    try:
-        from dotenv import load_dotenv
-        load_dotenv()
-    except ImportError:
-        pass
-
-    from tvplotlines import get_plotlines
-    from tvplotlines.input import load_synopses_dir
-
-    # Directory mode: single arg that is a directory
-    if len(args.files) == 1 and args.files[0].is_dir():
-        try:
-            show, season, episodes = load_synopses_dir(
-                args.files[0],
-                show=args.show,
-                season=args.season,
-            )
-        except (FileNotFoundError, ValueError) as e:
-            print(str(e), file=sys.stderr)
-            sys.exit(1)
-    else:
-        # File mode: explicit files, --show required
-        if not args.show:
-            print("--show is required when passing individual files.", file=sys.stderr)
-            sys.exit(1)
-        show = args.show
-        season = args.season or 1
-        paths = sorted(args.files, key=lambda p: p.name)
-        if not paths:
-            print("No synopsis files found.", file=sys.stderr)
-            sys.exit(1)
-        episodes = {}
-        for p in paths:
-            match = _EPISODE_ID_RE.search(p.stem)
-            if not match:
-                print(
-                    f"Cannot extract episode ID (S01E01) from filename: {p.name}",
-                    file=sys.stderr,
-                )
-                sys.exit(1)
-            episode_id = match.group()
-            if episode_id in episodes:
-                print(f"Duplicate episode ID {episode_id} from {p.name}", file=sys.stderr)
-                sys.exit(1)
-            episodes[episode_id] = p.read_text(encoding="utf-8")
-
-    # Validate mutually exclusive flags
-    if args.stop_after and args.resume_from:
-        print("--stop-after and --resume-from are mutually exclusive.", file=sys.stderr)
-        sys.exit(1)
-
-    import time
-    print(f"Running pipeline: {show} S{season:02d}")
-    print(f"Episodes: {len(episodes)} synopses")
-
-    # --stop-after pass1: run Pass 0 + Pass 1 only, save intermediate JSON
-    if args.stop_after == "pass1":
-        from dataclasses import asdict
-
-        from tvplotlines.llm import LLMConfig
-        from tvplotlines.pass0 import detect_context
-        from tvplotlines.pass1 import extract_plotlines
-
-        config = LLMConfig(
-            provider=args.provider, model=args.model,
-            base_url=args.base_url, system=args.system,
-        )
-        episode_pairs = [(eid, episodes[eid]) for eid in sorted(episodes)]
-
-        # Load suggested plotlines if available
-        sp_plotlines = None
-        if len(args.files) == 1 and args.files[0].is_dir():
-            sp_path = args.files[0] / "suggested_plotlines.json"
-            if sp_path.exists():
-                sp_plotlines = json.loads(sp_path.read_text(encoding="utf-8"))
-                if sp_plotlines and isinstance(sp_plotlines[0], list):
-                    sp_plotlines = [p for ep in sp_plotlines for p in ep]
-                print(f"  Using {len(sp_plotlines)} suggested plotlines")
-
-        t0 = time.monotonic()
-        context = detect_context(
-            show, season, episode_pairs[:3], config=config,
-            suggested_plotlines=sp_plotlines,
-        )
-        print(f"  Pass 0 done: {context.format} | {context.story_engine}")
-
-        cast, plotlines = extract_plotlines(
-            show, season, context, episode_pairs,
-            suggested_plotlines=sp_plotlines, config=config,
-        )
-        print(f"  Pass 1 done: {len(plotlines)} plotlines, {len(cast)} cast")
-
-        intermediate = {
-            "show": show,
-            "season": season,
-            "context": asdict(context),
-            "cast": [asdict(c) for c in cast],
-            "plotlines": [asdict(p) for p in plotlines],
-        }
-        out = args.output or Path(f"{show.lower().replace(' ', '-')}_s{season:02d}_pass1.json")
-        out.write_text(
-            json.dumps(intermediate, ensure_ascii=False, indent=2),
-            encoding="utf-8",
-        )
-        elapsed = time.monotonic() - t0
-        minutes, seconds = divmod(int(elapsed), 60)
-        time_str = f"{minutes}m {seconds}s" if minutes else f"{seconds}s"
-        print(f"\nIntermediate result saved to {out} ({time_str})")
-        return
-
-    # --resume-from: load intermediate JSON, skip Pass 0 + Pass 1
-    resume_kwargs = {}
-    if args.resume_from:
-        from tvplotlines.models import CastMember, Plotline, SeriesContext
-
-        if not args.resume_from.exists():
-            print(f"File not found: {args.resume_from}", file=sys.stderr)
-            sys.exit(1)
-        data = json.loads(args.resume_from.read_text(encoding="utf-8"))
-        resume_kwargs["context"] = SeriesContext(**data["context"])
-        resume_kwargs["cast"] = [CastMember(**c) for c in data["cast"]]
-        # Strip 'rank' key if present — rank is now a property, not a field.
-        # Old intermediate JSONs may contain it; new ones use computed_rank/reviewed_rank.
-        resume_kwargs["plotlines"] = [
-            Plotline(**{k: v for k, v in p.items() if k != "rank"})
-            for p in data["plotlines"]
-        ]
-        print(f"  Resumed from {args.resume_from}: "
-              f"{len(resume_kwargs['plotlines'])} plotlines, "
-              f"{len(resume_kwargs['cast'])} cast")
-
-    # Load suggested plotlines if available (from write-synopses single mode)
-    suggested_plotlines = None
-    if len(args.files) == 1 and args.files[0].is_dir():
-        sp_path = args.files[0] / "suggested_plotlines.json"
-        if sp_path.exists():
-            suggested_plotlines = json.loads(sp_path.read_text(encoding="utf-8"))
-            # Flatten if nested lists (per-episode format)
-            if suggested_plotlines and isinstance(suggested_plotlines[0], list):
-                suggested_plotlines = [p for ep in suggested_plotlines for p in ep]
-            print(f"  Using {len(suggested_plotlines)} suggested plotlines from synopsis writer")
-
-    t0 = time.monotonic()
-    result = get_plotlines(
-        show=show,
-        season=season,
-        episodes=episodes,
-        system=args.system,
-        llm_provider=args.provider,
-        model=args.model,
-        base_url=args.base_url,
-        skip_review=args.skip_review,
-        pass2_mode=args.pass2_mode,
-        suggested_plotlines=suggested_plotlines,
-        callback=_CLICallback(),
-        **resume_kwargs,
-    )
-
-    # Save result
-    import os
-    from datetime import datetime
-    result_json = json.dumps(result.to_dict(), ensure_ascii=False, indent=2)
-    default_name = f"{show.lower().replace(' ', '-')}_s{season:02d}.json"
-    env_dir = os.environ.get("TVPLOTLINES_OUTPUT_DIR")
-    if args.output:
-        output = args.output
-    elif env_dir:
-        output = Path(env_dir) / default_name
-        output.parent.mkdir(parents=True, exist_ok=True)
-    else:
-        output = Path(default_name)
-    output.write_text(result_json, encoding="utf-8")
-    print(f"\nSaved to {output}")
-
-    # Save timestamped copy if --output-dir
-    if args.output_dir:
-        args.output_dir.mkdir(parents=True, exist_ok=True)
-        ts = datetime.now().strftime("%Y%m%d_%H%M%S")
-        slug = show.lower().replace(" ", "-")
-        ts_path = args.output_dir / f"{slug}_s{season:02d}_{ts}.json"
-        ts_path.write_text(result_json, encoding="utf-8")
-        print(f"Copy saved to {ts_path}")
-
-    # Generate standalone HTML viewer if requested
-    if args.html or args.html_output:
-        from tvplotlines.html.build import build_html
-
-        html_path = args.html_output or output.with_suffix(".html")
-        html_content = build_html(data_path=output)
-        html_path.write_text(html_content, encoding="utf-8")
-        print(f"HTML viewer saved to {html_path}")
-
-    # Print summary
-    print(f"Context: {result.context.format} | {result.context.story_engine}")
-    if result.context.is_ensemble:
-        print("  (ensemble)")
-    if result.context.is_anthology:
-        print("  (anthology)")
-    print(f"Cast: {len(result.cast)} characters")
-    print(f"Plotlines: {len(result.plotlines)}")
-    for s in result.plotlines:
-        print(f"  [{s.rank or 'runner'}] {s.name} (hero={s.hero})")
-    print(f"Episodes: {len(result.episodes)}")
-    for ep in result.episodes:
-        print(f"  {ep.episode}: {len(ep.events)} events")
-    elapsed = time.monotonic() - t0
-    minutes, seconds = divmod(int(elapsed), 60)
-    time_str = f"{minutes}m {seconds}s" if minutes else f"{seconds}s"
-    print(f"\nModel: {args.provider}:{args.model or 'default'}, time: {time_str}")
-    if hasattr(result, "usage"):
-        print(f"Usage: {result.usage}")
-
-
-def _write_synopses(args: argparse.Namespace) -> None:
-    """Generate episode synopses from Wikipedia or raw files."""
-    try:
-        from tvplotlines.synopses_writer import write_synopses
-    except ImportError:
-        print(
-            "write-synopses requires additional dependencies.\n"
-            "Install with: pip install tvplotlines[writer]",
-            file=sys.stderr,
-        )
-        sys.exit(1)
-
-    try:
-        from dotenv import load_dotenv
-        load_dotenv()
-    except ImportError:
-        pass
-
-    import os
-    env_dir = os.environ.get("TVPLOTLINES_SYNOPSES_DIR")
-    if args.output:
-        output = args.output
-    elif env_dir:
-        slug = args.show.lower().replace(" ", "-")
-        output = os.path.join(env_dir, slug) + "/"
-        os.makedirs(output, exist_ok=True)
-    else:
-        output = args.show.lower().replace(" ", "-") + "/"
-
-    write_synopses(
-        show=args.show,
-        season=args.season,
-        output=output,
-        from_files=args.from_files,
-        lang=args.lang,
-        wiki_title=args.wiki_title,
-        fandom_wiki=args.fandom_wiki,
-        no_fandom=args.no_fandom,
-        show_format=args.show_format,
-        dry_run=args.dry_run,
-        provider=args.provider,
-        model=args.model,
-        base_url=args.base_url,
-        mode=args.mode,
-        use_glossary=not args.no_glossary,
-        system=args.system,
-    )
-
-
-def main() -> None:
-    parser = argparse.ArgumentParser(
-        prog="tvplotlines",
-        description="Extract plotlines from TV series synopses using LLM.",
-    )
-    sub = parser.add_subparsers(dest="command")
-
-    # tvplotlines run
-    run_parser = sub.add_parser("run", help="Run pipeline on synopsis files")
-    run_parser.add_argument(
-        "files", nargs="+", type=Path,
-        help="Synopsis directory or individual text files",
-    )
-    run_parser.add_argument("--show", default=None, help="Series title (auto-detected from directory name)")
-    run_parser.add_argument("--season", type=int, default=None, help="Season number (auto-detected from filenames)")
-    run_parser.add_argument(
-        "--system", default="hollywood", choices=["hollywood", "narratology"],
-        help="Analysis system: hollywood (default) or narratology",
-    )
-    run_parser.add_argument("--output", "-o", type=Path, help="Output JSON path")
-    run_parser.add_argument("--provider", default="anthropic",
-                            help="LLM provider: anthropic, openai, ollama, deepseek, groq, or any OpenAI-compatible")
-    run_parser.add_argument("--model", default=None, help="Specific model name")
-    run_parser.add_argument("--base-url", default=None, help="Custom API endpoint (for OpenAI-compatible providers)")
-    run_parser.add_argument("--skip-review", action="store_true", help="Skip Pass 3 structural review")
-    run_parser.add_argument("--pass2-mode", default="batch", choices=["parallel", "batch", "sequential"])
-    run_parser.add_argument(
-        "--stop-after", choices=["pass1"],
-        help="Stop after the given pass and save intermediate result to JSON",
-    )
-    run_parser.add_argument(
-        "--resume-from", type=Path, metavar="JSON",
-        help="Resume from intermediate JSON (skip Pass 0 and Pass 1)",
-    )
-    run_parser.add_argument(
-        "--output-dir", type=Path, metavar="DIR",
-        help="Save timestamped result to this directory (e.g. runs/)",
-    )
-    run_parser.add_argument(
-        "--html", action="store_true",
-        help="Generate a standalone HTML viewer alongside the result JSON",
-    )
-    run_parser.add_argument(
-        "--html-output", type=Path, metavar="PATH",
-        help="Custom path for HTML viewer (implies --html)",
-    )
-
-    # tvplotlines write-synopses
-    ws_parser = sub.add_parser(
-        "write-synopses",
-        help="Generate episode synopses from Wikipedia",
-    )
-    ws_parser.add_argument("show", help="Show title (e.g. 'House', 'Breaking Bad')")
-    ws_parser.add_argument("--season", type=int, default=1, help="Season number (default: 1)")
-    ws_parser.add_argument("-o", "--output", default=None,
-                           help="Output directory (default: show name as folder, e.g. 'mad-men/')")
-    ws_parser.add_argument("--from-files", nargs="+",
-                           help="Raw description files to rewrite (skip Wikipedia fetch)")
-    ws_parser.add_argument("--wiki-title",
-                           help="Exact Wikipedia page title (override auto-detection)")
-    ws_parser.add_argument("--format", dest="show_format",
-                           choices=["procedural", "serial", "hybrid", "ensemble"],
-                           help="Show format hint for beat counts (auto-detected if omitted)")
-    ws_parser.add_argument("--lang", default="en", help="Wikipedia language (default: en)")
-    ws_parser.add_argument(
-        "--system", default="hollywood", choices=["hollywood", "narratology"],
-        help="Analysis system whose synopses prompt to use (default: hollywood)",
-    )
-    ws_parser.add_argument("--dry-run", action="store_true",
-                           help="Fetch and parse only, show episodes without calling LLM")
-    ws_parser.add_argument("--provider", default="anthropic",
-                           help="LLM provider (default: anthropic)")
-    ws_parser.add_argument("--model", default=None, help="Specific model name")
-    ws_parser.add_argument("--base-url", default=None, help="Custom API endpoint")
-    ws_parser.add_argument("--mode", default=None,
-                           choices=["parallel", "batch", "sequential", "single"],
-                           help="Execution mode (default: auto — parallel for procedural/hybrid, single for serial/ensemble)")
-    ws_parser.add_argument("--fandom-wiki", default=None,
-                           help="Fandom wiki subdomain (e.g. 'house', 'breakingbad')")
-    ws_parser.add_argument("--no-fandom", action="store_true",
-                           help="Disable Fandom wiki fetching (Wikipedia only)")
-    ws_parser.add_argument("--no-glossary", action="store_true",
-                           help="Skip glossary injection into system prompt")
-
-    args = parser.parse_args()
-    if args.command is None:
-        parser.print_help()
-        sys.exit(1)
-
-    if args.command == "run":
-        _run(args)
-    elif args.command == "write-synopses":
-        _write_synopses(args)
-
-
-if __name__ == "__main__":
-    main()
+"""CLI for tvplot: extract plotlines from TV series synopses.
+
+Usage:
+    tvplot run breaking-bad/
+    tvplot run breaking-bad/ --show "Breaking Bad"
+    tvplot run S01E01.txt S01E02.txt --show "House" --season 1
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import re
+import sys
+from pathlib import Path
+
+_EPISODE_ID_RE = re.compile(r"S\d{2}E\d{2}")
+
+
+from tvplot.callbacks import PipelineCallback
+
+
+class _CLICallback(PipelineCallback):
+    """Print one line per pipeline stage."""
+
+    def on_pass0_complete(self, context):
+        print(f"  Pass 0 done: {context.format} | {context.story_engine}")
+
+    def on_pass1_complete(self, cast, plotlines):
+        print(f"  Pass 1 done: {len(plotlines)} plotlines, {len(cast)} cast")
+
+    def on_batch_submitted(self, batch_id):
+        print(f"  Pass 2 batch submitted: {batch_id}")
+
+    def on_pass2_complete(self, breakdowns):
+        print(f"  Pass 2 done: {len(breakdowns)} episodes")
+
+    def on_pass3_complete(self, verdicts):
+        print(f"  Pass 3 done: {len(verdicts)} verdicts applied")
+
+    def on_pass4_complete(self, count):
+        print(f"  Pass 4 done: {count} arc functions assigned")
+
+
+def _run(args: argparse.Namespace) -> None:
+    """Run the full pipeline on synopsis files."""
+    try:
+        from dotenv import load_dotenv
+        load_dotenv()
+    except ImportError:
+        pass
+
+    from tvplot import get_plotlines
+    from tvplot.input import load_synopses_dir
+
+    # Directory mode: single arg that is a directory
+    if len(args.files) == 1 and args.files[0].is_dir():
+        try:
+            show, season, episodes = load_synopses_dir(
+                args.files[0],
+                show=args.show,
+                season=args.season,
+            )
+        except (FileNotFoundError, ValueError) as e:
+            print(str(e), file=sys.stderr)
+            sys.exit(1)
+    else:
+        # File mode: explicit files, --show required
+        if not args.show:
+            print("--show is required when passing individual files.", file=sys.stderr)
+            sys.exit(1)
+        show = args.show
+        season = args.season or 1
+        paths = sorted(args.files, key=lambda p: p.name)
+        if not paths:
+            print("No synopsis files found.", file=sys.stderr)
+            sys.exit(1)
+        episodes = {}
+        for p in paths:
+            match = _EPISODE_ID_RE.search(p.stem)
+            if not match:
+                print(
+                    f"Cannot extract episode ID (S01E01) from filename: {p.name}",
+                    file=sys.stderr,
+                )
+                sys.exit(1)
+            episode_id = match.group()
+            if episode_id in episodes:
+                print(f"Duplicate episode ID {episode_id} from {p.name}", file=sys.stderr)
+                sys.exit(1)
+            episodes[episode_id] = p.read_text(encoding="utf-8")
+
+    # Validate mutually exclusive flags
+    if args.stop_after and args.resume_from:
+        print("--stop-after and --resume-from are mutually exclusive.", file=sys.stderr)
+        sys.exit(1)
+
+    import time
+    print(f"Running pipeline: {show} S{season:02d}")
+    print(f"Episodes: {len(episodes)} synopses")
+
+    # --stop-after pass1: run Pass 0 + Pass 1 only, save intermediate JSON
+    if args.stop_after == "pass1":
+        from dataclasses import asdict
+
+        from tvplot.llm import LLMConfig
+        from tvplot.pass0 import detect_context
+        from tvplot.pass1 import extract_plotlines
+
+        config = LLMConfig(
+            provider=args.provider, model=args.model,
+            base_url=args.base_url, system=args.system,
+        )
+        episode_pairs = [(eid, episodes[eid]) for eid in sorted(episodes)]
+
+        # Load suggested plotlines if available
+        sp_plotlines = None
+        if len(args.files) == 1 and args.files[0].is_dir():
+            sp_path = args.files[0] / "suggested_plotlines.json"
+            if sp_path.exists():
+                sp_plotlines = json.loads(sp_path.read_text(encoding="utf-8"))
+                if sp_plotlines and isinstance(sp_plotlines[0], list):
+                    sp_plotlines = [p for ep in sp_plotlines for p in ep]
+                print(f"  Using {len(sp_plotlines)} suggested plotlines")
+
+        t0 = time.monotonic()
+        context = detect_context(
+            show, season, episode_pairs[:3], config=config,
+            suggested_plotlines=sp_plotlines,
+        )
+        print(f"  Pass 0 done: {context.format} | {context.story_engine}")
+
+        cast, plotlines = extract_plotlines(
+            show, season, context, episode_pairs,
+            suggested_plotlines=sp_plotlines, config=config,
+        )
+        print(f"  Pass 1 done: {len(plotlines)} plotlines, {len(cast)} cast")
+
+        intermediate = {
+            "show": show,
+            "season": season,
+            "context": asdict(context),
+            "cast": [asdict(c) for c in cast],
+            "plotlines": [asdict(p) for p in plotlines],
+        }
+        out = args.output or Path(f"{show.lower().replace(' ', '-')}_s{season:02d}_pass1.json")
+        out.write_text(
+            json.dumps(intermediate, ensure_ascii=False, indent=2),
+            encoding="utf-8",
+        )
+        elapsed = time.monotonic() - t0
+        minutes, seconds = divmod(int(elapsed), 60)
+        time_str = f"{minutes}m {seconds}s" if minutes else f"{seconds}s"
+        print(f"\nIntermediate result saved to {out} ({time_str})")
+        return
+
+    # --resume-from: load intermediate JSON, skip Pass 0 + Pass 1
+    resume_kwargs = {}
+    if args.resume_from:
+        from tvplot.models import CastMember, Plotline, SeriesContext
+
+        if not args.resume_from.exists():
+            print(f"File not found: {args.resume_from}", file=sys.stderr)
+            sys.exit(1)
+        data = json.loads(args.resume_from.read_text(encoding="utf-8"))
+        resume_kwargs["context"] = SeriesContext(**data["context"])
+        resume_kwargs["cast"] = [CastMember(**c) for c in data["cast"]]
+        # Strip 'rank' key if present — rank is now a property, not a field.
+        # Old intermediate JSONs may contain it; new ones use computed_rank/reviewed_rank.
+        resume_kwargs["plotlines"] = [
+            Plotline(**{k: v for k, v in p.items() if k != "rank"})
+            for p in data["plotlines"]
+        ]
+        print(f"  Resumed from {args.resume_from}: "
+              f"{len(resume_kwargs['plotlines'])} plotlines, "
+              f"{len(resume_kwargs['cast'])} cast")
+
+    # Load suggested plotlines if available (from write-synopses single mode)
+    suggested_plotlines = None
+    if len(args.files) == 1 and args.files[0].is_dir():
+        sp_path = args.files[0] / "suggested_plotlines.json"
+        if sp_path.exists():
+            suggested_plotlines = json.loads(sp_path.read_text(encoding="utf-8"))
+            # Flatten if nested lists (per-episode format)
+            if suggested_plotlines and isinstance(suggested_plotlines[0], list):
+                suggested_plotlines = [p for ep in suggested_plotlines for p in ep]
+            print(f"  Using {len(suggested_plotlines)} suggested plotlines from synopsis writer")
+
+    t0 = time.monotonic()
+    result = get_plotlines(
+        show=show,
+        season=season,
+        episodes=episodes,
+        system=args.system,
+        llm_provider=args.provider,
+        model=args.model,
+        base_url=args.base_url,
+        skip_review=args.skip_review,
+        pass2_mode=args.pass2_mode,
+        suggested_plotlines=suggested_plotlines,
+        callback=_CLICallback(),
+        **resume_kwargs,
+    )
+
+    # Save result
+    import os
+    from datetime import datetime
+    result_json = json.dumps(result.to_dict(), ensure_ascii=False, indent=2)
+    default_name = f"{show.lower().replace(' ', '-')}_s{season:02d}.json"
+    env_dir = os.environ.get("TVPLOT_OUTPUT_DIR")
+    if args.output:
+        output = args.output
+    elif env_dir:
+        output = Path(env_dir) / default_name
+        output.parent.mkdir(parents=True, exist_ok=True)
+    else:
+        output = Path(default_name)
+    output.write_text(result_json, encoding="utf-8")
+    print(f"\nSaved to {output}")
+
+    # Save timestamped copy if --output-dir
+    if args.output_dir:
+        args.output_dir.mkdir(parents=True, exist_ok=True)
+        ts = datetime.now().strftime("%Y%m%d_%H%M%S")
+        slug = show.lower().replace(" ", "-")
+        ts_path = args.output_dir / f"{slug}_s{season:02d}_{ts}.json"
+        ts_path.write_text(result_json, encoding="utf-8")
+        print(f"Copy saved to {ts_path}")
+
+    # Generate standalone HTML viewer if requested
+    if args.html or args.html_output:
+        from tvplot.html.build import build_html
+
+        html_path = args.html_output or output.with_suffix(".html")
+        html_content = build_html(data_path=output)
+        html_path.write_text(html_content, encoding="utf-8")
+        print(f"HTML viewer saved to {html_path}")
+
+    # Print summary
+    print(f"Context: {result.context.format} | {result.context.story_engine}")
+    if result.context.is_ensemble:
+        print("  (ensemble)")
+    if result.context.is_anthology:
+        print("  (anthology)")
+    print(f"Cast: {len(result.cast)} characters")
+    print(f"Plotlines: {len(result.plotlines)}")
+    for s in result.plotlines:
+        print(f"  [{s.rank or 'runner'}] {s.name} (hero={s.hero})")
+    print(f"Episodes: {len(result.episodes)}")
+    for ep in result.episodes:
+        print(f"  {ep.episode}: {len(ep.events)} events")
+    elapsed = time.monotonic() - t0
+    minutes, seconds = divmod(int(elapsed), 60)
+    time_str = f"{minutes}m {seconds}s" if minutes else f"{seconds}s"
+    print(f"\nModel: {args.provider}:{args.model or 'default'}, time: {time_str}")
+    if hasattr(result, "usage"):
+        print(f"Usage: {result.usage}")
+
+
+def _write_synopses(args: argparse.Namespace) -> None:
+    """Generate episode synopses from Wikipedia or raw files."""
+    try:
+        from tvplot.synopses_writer import write_synopses
+    except ImportError:
+        print(
+            "write-synopses requires additional dependencies.\n"
+            "Install with: pip install tvplot[writer]",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    try:
+        from dotenv import load_dotenv
+        load_dotenv()
+    except ImportError:
+        pass
+
+    import os
+    env_dir = os.environ.get("TVPLOT_SYNOPSES_DIR")
+    if args.output:
+        output = args.output
+    elif env_dir:
+        slug = args.show.lower().replace(" ", "-")
+        output = os.path.join(env_dir, slug) + "/"
+        os.makedirs(output, exist_ok=True)
+    else:
+        output = args.show.lower().replace(" ", "-") + "/"
+
+    write_synopses(
+        show=args.show,
+        season=args.season,
+        output=output,
+        from_files=args.from_files,
+        lang=args.lang,
+        wiki_title=args.wiki_title,
+        fandom_wiki=args.fandom_wiki,
+        no_fandom=args.no_fandom,
+        show_format=args.show_format,
+        dry_run=args.dry_run,
+        provider=args.provider,
+        model=args.model,
+        base_url=args.base_url,
+        mode=args.mode,
+        use_glossary=not args.no_glossary,
+        system=args.system,
+    )
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="tvplot",
+        description="Extract plotlines from TV series synopses using LLM.",
+    )
+    sub = parser.add_subparsers(dest="command")
+
+    # tvplot run
+    run_parser = sub.add_parser("run", help="Run pipeline on synopsis files")
+    run_parser.add_argument(
+        "files", nargs="+", type=Path,
+        help="Synopsis directory or individual text files",
+    )
+    run_parser.add_argument("--show", default=None, help="Series title (auto-detected from directory name)")
+    run_parser.add_argument("--season", type=int, default=None, help="Season number (auto-detected from filenames)")
+    run_parser.add_argument(
+        "--system", default="hollywood", choices=["hollywood", "narratology"],
+        help="Analysis system: hollywood (default) or narratology",
+    )
+    run_parser.add_argument("--output", "-o", type=Path, help="Output JSON path")
+    run_parser.add_argument("--provider", default="anthropic",
+                            help="LLM provider: anthropic, openai, ollama, deepseek, groq, or any OpenAI-compatible")
+    run_parser.add_argument("--model", default=None, help="Specific model name")
+    run_parser.add_argument("--base-url", default=None, help="Custom API endpoint (for OpenAI-compatible providers)")
+    run_parser.add_argument("--skip-review", action="store_true", help="Skip Pass 3 structural review")
+    run_parser.add_argument("--pass2-mode", default="batch", choices=["parallel", "batch", "sequential"])
+    run_parser.add_argument(
+        "--stop-after", choices=["pass1"],
+        help="Stop after the given pass and save intermediate result to JSON",
+    )
+    run_parser.add_argument(
+        "--resume-from", type=Path, metavar="JSON",
+        help="Resume from intermediate JSON (skip Pass 0 and Pass 1)",
+    )
+    run_parser.add_argument(
+        "--output-dir", type=Path, metavar="DIR",
+        help="Save timestamped result to this directory (e.g. runs/)",
+    )
+    run_parser.add_argument(
+        "--html", action="store_true",
+        help="Generate a standalone HTML viewer alongside the result JSON",
+    )
+    run_parser.add_argument(
+        "--html-output", type=Path, metavar="PATH",
+        help="Custom path for HTML viewer (implies --html)",
+    )
+
+    # tvplot write-synopses
+    ws_parser = sub.add_parser(
+        "write-synopses",
+        help="Generate episode synopses from Wikipedia",
+    )
+    ws_parser.add_argument("show", help="Show title (e.g. 'House', 'Breaking Bad')")
+    ws_parser.add_argument("--season", type=int, default=1, help="Season number (default: 1)")
+    ws_parser.add_argument("-o", "--output", default=None,
+                           help="Output directory (default: show name as folder, e.g. 'mad-men/')")
+    ws_parser.add_argument("--from-files", nargs="+",
+                           help="Raw description files to rewrite (skip Wikipedia fetch)")
+    ws_parser.add_argument("--wiki-title",
+                           help="Exact Wikipedia page title (override auto-detection)")
+    ws_parser.add_argument("--format", dest="show_format",
+                           choices=["procedural", "serial", "hybrid", "ensemble"],
+                           help="Show format hint for beat counts (auto-detected if omitted)")
+    ws_parser.add_argument("--lang", default="en", help="Wikipedia language (default: en)")
+    ws_parser.add_argument(
+        "--system", default="hollywood", choices=["hollywood", "narratology"],
+        help="Analysis system whose synopses prompt to use (default: hollywood)",
+    )
+    ws_parser.add_argument("--dry-run", action="store_true",
+                           help="Fetch and parse only, show episodes without calling LLM")
+    ws_parser.add_argument("--provider", default="anthropic",
+                           help="LLM provider (default: anthropic)")
+    ws_parser.add_argument("--model", default=None, help="Specific model name")
+    ws_parser.add_argument("--base-url", default=None, help="Custom API endpoint")
+    ws_parser.add_argument("--mode", default=None,
+                           choices=["parallel", "batch", "sequential", "single"],
+                           help="Execution mode (default: auto — parallel for procedural/hybrid, single for serial/ensemble)")
+    ws_parser.add_argument("--fandom-wiki", default=None,
+                           help="Fandom wiki subdomain (e.g. 'house', 'breakingbad')")
+    ws_parser.add_argument("--no-fandom", action="store_true",
+                           help="Disable Fandom wiki fetching (Wikipedia only)")
+    ws_parser.add_argument("--no-glossary", action="store_true",
+                           help="Skip glossary injection into system prompt")
+
+    args = parser.parse_args()
+    if args.command is None:
+        parser.print_help()
+        sys.exit(1)
+
+    if args.command == "run":
+        _run(args)
+    elif args.command == "write-synopses":
+        _write_synopses(args)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/src/tvplotlines/html/__init__.py b/src/tvplot/html/__init__.py
similarity index 100%
rename from src/tvplotlines/html/__init__.py
rename to src/tvplot/html/__init__.py
diff --git a/src/tvplotlines/html/build.py b/src/tvplot/html/build.py
similarity index 98%
rename from src/tvplotlines/html/build.py
rename to src/tvplot/html/build.py
index 609937e..4d8c068 100644
--- a/src/tvplotlines/html/build.py
+++ b/src/tvplot/html/build.py
@@ -3,7 +3,7 @@
 Reads shell.html and replaces placeholders with CSS, JS, and demo data
 to produce a single self-contained HTML file.
 
-Prompts from ``src/tvplotlines/prompts/{hollywood,narratology}/*.md`` are
+Prompts from ``src/tvplot/prompts/{hollywood,narratology}/*.md`` are
 inlined into the HTML so the viewer runs either pipeline in the browser
 without fetching files at runtime.
 """
diff --git a/src/tvplotlines/html/parts/analytics.js b/src/tvplot/html/parts/analytics.js
similarity index 99%
rename from src/tvplotlines/html/parts/analytics.js
rename to src/tvplot/html/parts/analytics.js
index d270663..d37fef5 100644
--- a/src/tvplotlines/html/parts/analytics.js
+++ b/src/tvplot/html/parts/analytics.js
@@ -1,5 +1,5 @@
 // Analytics — computation and rendering for 5 analytics sections.
-// Ported from tvplotlines-app analytics.py + analytics.html.
+// Ported from tvplot-app analytics.py + analytics.html.
 
 const FUNCTION_TENSION = {
   setup: 1, seed: 1, inciting_incident: 1.5,
@@ -237,7 +237,7 @@ function _tensionLevel(t) {
  * Render all 5 analytics sections into the given container.
  *
  * Args:
- *   data: tvplotlines result JSON object.
+ *   data: tvplot result JSON object.
  *   container: DOM element to render into.
  */
 function renderAnalytics(data, container) {
diff --git a/src/tvplotlines/html/parts/app.js b/src/tvplot/html/parts/app.js
similarity index 95%
rename from src/tvplotlines/html/parts/app.js
rename to src/tvplot/html/parts/app.js
index 65bf59a..bc17f3f 100644
--- a/src/tvplotlines/html/parts/app.js
+++ b/src/tvplot/html/parts/app.js
@@ -3,35 +3,35 @@
 // --- localStorage manager ---
 
 const Store = {
-  getKey: () => localStorage.getItem('tvplotlines_api_key'),
-  getProvider: () => localStorage.getItem('tvplotlines_provider'),
-  getSystem: () => localStorage.getItem('tvplotlines_system') || 'hollywood',
-  setSystem: (system) => localStorage.setItem('tvplotlines_system', system),
+  getKey: () => localStorage.getItem('tvplot_api_key'),
+  getProvider: () => localStorage.getItem('tvplot_provider'),
+  getSystem: () => localStorage.getItem('tvplot_system') || 'hollywood',
+  setSystem: (system) => localStorage.setItem('tvplot_system', system),
   setKey: (provider, key) => {
-    localStorage.setItem('tvplotlines_provider', provider);
-    localStorage.setItem('tvplotlines_api_key', key);
+    localStorage.setItem('tvplot_provider', provider);
+    localStorage.setItem('tvplot_api_key', key);
   },
-  getResults: () => JSON.parse(localStorage.getItem('tvplotlines_results') || '{}'),
+  getResults: () => JSON.parse(localStorage.getItem('tvplot_results') || '{}'),
   saveResult: (name, data) => {
     const results = Store.getResults();
     results[name] = data;
-    localStorage.setItem('tvplotlines_results', JSON.stringify(results));
+    localStorage.setItem('tvplot_results', JSON.stringify(results));
   },
   removeResult: (name) => {
     const results = Store.getResults();
     delete results[name];
-    localStorage.setItem('tvplotlines_results', JSON.stringify(results));
+    localStorage.setItem('tvplot_results', JSON.stringify(results));
   },
-  getSettings: () => JSON.parse(localStorage.getItem('tvplotlines_settings') || '{}'),
+  getSettings: () => JSON.parse(localStorage.getItem('tvplot_settings') || '{}'),
   saveSetting: (key, val) => {
     const s = Store.getSettings();
     s[key] = val;
-    localStorage.setItem('tvplotlines_settings', JSON.stringify(s));
+    localStorage.setItem('tvplot_settings', JSON.stringify(s));
   },
-  hasSeenOnboarding: () => localStorage.getItem('tvplotlines_onboarding_seen') === 'true',
-  markOnboardingSeen: () => localStorage.setItem('tvplotlines_onboarding_seen', 'true'),
-  aiFooterDismissed: () => localStorage.getItem('tvplotlines_ai_footer_dismissed') === 'true',
-  dismissAIFooter: () => localStorage.setItem('tvplotlines_ai_footer_dismissed', 'true'),
+  hasSeenOnboarding: () => localStorage.getItem('tvplot_onboarding_seen') === 'true',
+  markOnboardingSeen: () => localStorage.setItem('tvplot_onboarding_seen', 'true'),
+  aiFooterDismissed: () => localStorage.getItem('tvplot_ai_footer_dismissed') === 'true',
+  dismissAIFooter: () => localStorage.setItem('tvplot_ai_footer_dismissed', 'true'),
 };
 
 // --- Screen routing ---
diff --git a/src/tvplotlines/html/parts/export.js b/src/tvplot/html/parts/export.js
similarity index 99%
rename from src/tvplotlines/html/parts/export.js
rename to src/tvplot/html/parts/export.js
index cf02c36..91ac644 100644
--- a/src/tvplotlines/html/parts/export.js
+++ b/src/tvplot/html/parts/export.js
@@ -27,7 +27,7 @@ function _exportFilename(data) {
   const ctx = data.context || {};
   if (ctx.series && ctx.season) return ctx.series.replace(/\s+/g, '_') + '_' + ctx.season;
   if (ctx.series) return ctx.series.replace(/\s+/g, '_');
-  return 'tvplotlines_export';
+  return 'tvplot_export';
 }
 
 function _resolveCharName(charId, cast) {
@@ -274,7 +274,7 @@ function _buildPDF(data) {
   let y = margin;
 
   const ctx = data.context || {};
-  const seriesLabel = [ctx.series, ctx.season].filter(Boolean).join(' · ') || 'tvplotlines';
+  const seriesLabel = [ctx.series, ctx.season].filter(Boolean).join(' · ') || 'tvplot';
 
   const line = (text, size, weight = 'normal', indent = 0, color = [30, 30, 30]) => {
     doc.setFont('helvetica', weight);
diff --git a/src/tvplotlines/html/parts/grid.js b/src/tvplot/html/parts/grid.js
similarity index 99%
rename from src/tvplotlines/html/parts/grid.js
rename to src/tvplot/html/parts/grid.js
index efb5485..e4ab028 100644
--- a/src/tvplotlines/html/parts/grid.js
+++ b/src/tvplot/html/parts/grid.js
@@ -344,7 +344,7 @@ function _showEventModal(ev, cast) {
  * Render the plotline x episode grid into a container element.
  *
  * Args:
- *   data: tvplotlines result JSON object.
+ *   data: tvplot result JSON object.
  *   container: DOM element to render into.
  */
 function renderGrid(data, container) {
diff --git a/src/tvplotlines/html/parts/pipeline.js b/src/tvplot/html/parts/pipeline.js
similarity index 99%
rename from src/tvplotlines/html/parts/pipeline.js
rename to src/tvplot/html/parts/pipeline.js
index cdd2d15..c00e2dc 100644
--- a/src/tvplotlines/html/parts/pipeline.js
+++ b/src/tvplot/html/parts/pipeline.js
@@ -779,7 +779,7 @@ function _confirmSynopses(show, season, synopses) {
 }
 
 // ══════════════════════════════════════════════════════════════════
-// Narratology pipeline — mirrors src/tvplotlines/narratology.py.
+// Narratology pipeline — mirrors src/tvplot/narratology.py.
 // Result shape is hollywood-compatible: actant fields are mapped onto
 // hero/goal/obstacle/stakes so the grid + analytics render unchanged.
 // ══════════════════════════════════════════════════════════════════
diff --git a/src/tvplotlines/html/parts/shell.html b/src/tvplot/html/parts/shell.html
similarity index 99%
rename from src/tvplotlines/html/parts/shell.html
rename to src/tvplot/html/parts/shell.html
index f690b39..e778c5d 100644
--- a/src/tvplotlines/html/parts/shell.html
+++ b/src/tvplot/html/parts/shell.html
@@ -14,7 +14,7 @@
 <!-- Welcome screen -->
 <section id="screen-welcome" class="screen active">
   <div class="welcome-container">
-    <h1 class="welcome-title">tvplotlines</h1>
+    <h1 class="welcome-title">tvplot</h1>
     <p class="welcome-tagline">see the structure of any TV series</p>
 
     <form id="analyze-form" class="analyze-form" autocomplete="off">
diff --git a/src/tvplotlines/html/parts/style.css b/src/tvplot/html/parts/style.css
similarity index 100%
rename from src/tvplotlines/html/parts/style.css
rename to src/tvplot/html/parts/style.css
diff --git a/src/tvplotlines/input.py b/src/tvplot/input.py
similarity index 100%
rename from src/tvplotlines/input.py
rename to src/tvplot/input.py
diff --git a/src/tvplotlines/llm.py b/src/tvplot/llm.py
similarity index 100%
rename from src/tvplotlines/llm.py
rename to src/tvplot/llm.py
diff --git a/src/tvplotlines/metrics.py b/src/tvplot/metrics.py
similarity index 98%
rename from src/tvplotlines/metrics.py
rename to src/tvplot/metrics.py
index eafb047..15d2d10 100644
--- a/src/tvplotlines/metrics.py
+++ b/src/tvplot/metrics.py
@@ -10,7 +10,7 @@
 
 from collections import Counter
 
-from tvplotlines.models import EpisodeBreakdown
+from tvplot.models import EpisodeBreakdown
 
 
 def compute_coverage(episodes: list[EpisodeBreakdown]) -> float:
diff --git a/src/tvplotlines/models.py b/src/tvplot/models.py
similarity index 95%
rename from src/tvplotlines/models.py
rename to src/tvplot/models.py
index b595c32..adffa4d 100644
--- a/src/tvplotlines/models.py
+++ b/src/tvplot/models.py
@@ -1,7 +1,7 @@
-"""Data models for tvplotlines pipeline.
+"""Data models for tvplot pipeline.
 
 These dataclasses mirror the JSON output of Pass 0, Pass 1, and Pass 2 prompts.
-Glossary (tvplotlines-glossary.md) is the source of truth for definitions.
+Glossary (tvplot-glossary.md) is the source of truth for definitions.
 """
 
 from __future__ import annotations
@@ -98,7 +98,7 @@ class Verdict:
 
 @dataclass
 class TVPlotlinesResult:
-    """Complete output of the tvplotlines pipeline."""
+    """Complete output of the tvplot pipeline."""
 
     context: SeriesContext
     cast: list[CastMember] = field(default_factory=list)
diff --git a/src/tvplotlines/narratology.py b/src/tvplot/narratology.py
similarity index 98%
rename from src/tvplotlines/narratology.py
rename to src/tvplot/narratology.py
index 05e35ae..95fb22d 100644
--- a/src/tvplotlines/narratology.py
+++ b/src/tvplot/narratology.py
@@ -26,9 +26,9 @@
 import re
 from collections import defaultdict
 
-from tvplotlines.callbacks import PipelineCallback
-from tvplotlines.llm import LLMConfig, call_llm, call_llm_parallel
-from tvplotlines.models import (
+from tvplot.callbacks import PipelineCallback
+from tvplot.llm import LLMConfig, call_llm, call_llm_parallel
+from tvplot.models import (
     CastMember,
     EpisodeBreakdown,
     Event,
@@ -38,12 +38,12 @@
     TVPlotlinesResult,
     Verdict,
 )
-from tvplotlines.postprocess import (
+from tvplot.postprocess import (
     assign_orphan_events,
     compute_ranks,
     compute_span,
 )
-from tvplotlines.prompts import load_prompt
+from tvplot.prompts import load_prompt
 
 logger = logging.getLogger(__name__)
 
diff --git a/src/tvplotlines/pass0.py b/src/tvplot/pass0.py
similarity index 94%
rename from src/tvplotlines/pass0.py
rename to src/tvplot/pass0.py
index 8d97cd6..102435e 100644
--- a/src/tvplotlines/pass0.py
+++ b/src/tvplot/pass0.py
@@ -8,9 +8,9 @@
 
 import json
 
-from tvplotlines.llm import LLMConfig, call_llm
-from tvplotlines.models import SeriesContext
-from tvplotlines.prompts import load_prompt
+from tvplot.llm import LLMConfig, call_llm
+from tvplot.models import SeriesContext
+from tvplot.prompts import load_prompt
 
 _VALID_FORMATS = {"procedural", "serial", "hybrid", "ensemble"}
 
diff --git a/src/tvplotlines/pass1.py b/src/tvplot/pass1.py
similarity index 97%
rename from src/tvplotlines/pass1.py
rename to src/tvplot/pass1.py
index 63f4579..81b1f5a 100644
--- a/src/tvplotlines/pass1.py
+++ b/src/tvplot/pass1.py
@@ -10,9 +10,9 @@
 import logging
 from collections import Counter
 
-from tvplotlines.llm import LLMConfig, call_llm, call_llm_parallel
-from tvplotlines.models import CastMember, Plotline, SeriesContext
-from tvplotlines.prompts import load_prompt
+from tvplot.llm import LLMConfig, call_llm, call_llm_parallel
+from tvplot.models import CastMember, Plotline, SeriesContext
+from tvplot.prompts import load_prompt
 
 logger = logging.getLogger(__name__)
 
diff --git a/src/tvplotlines/pass2.py b/src/tvplot/pass2.py
similarity index 98%
rename from src/tvplotlines/pass2.py
rename to src/tvplot/pass2.py
index cbf7790..46b5587 100644
--- a/src/tvplotlines/pass2.py
+++ b/src/tvplot/pass2.py
@@ -8,8 +8,8 @@
 
 import json
 
-from tvplotlines.llm import LLMConfig, call_llm, call_llm_batch, call_llm_parallel
-from tvplotlines.models import (
+from tvplot.llm import LLMConfig, call_llm, call_llm_batch, call_llm_parallel
+from tvplot.models import (
     CastMember,
     EpisodeBreakdown,
     Event,
@@ -17,7 +17,7 @@
     Plotline,
     SeriesContext,
 )
-from tvplotlines.prompts import load_prompt
+from tvplot.prompts import load_prompt
 
 _VALID_FUNCTIONS = {
     "setup", "inciting_incident", "escalation", "turning_point",
diff --git a/src/tvplotlines/pass3.py b/src/tvplot/pass3.py
similarity index 97%
rename from src/tvplotlines/pass3.py
rename to src/tvplot/pass3.py
index aedfd85..b4fa356 100644
--- a/src/tvplotlines/pass3.py
+++ b/src/tvplot/pass3.py
@@ -8,16 +8,16 @@
 
 import json
 
-from tvplotlines.llm import LLMConfig, call_llm
-from tvplotlines.models import (
+from tvplot.llm import LLMConfig, call_llm
+from tvplot.models import (
     CastMember,
     EpisodeBreakdown,
     Plotline,
     SeriesContext,
     Verdict,
 )
-from tvplotlines.postprocess import compute_weight
-from tvplotlines.prompts import load_prompt
+from tvplot.postprocess import compute_weight
+from tvplot.prompts import load_prompt
 
 _VALID_ACTIONS = {"MERGE", "REASSIGN", "CREATE", "DROP", "REFUNCTION"}
 _VALID_FUNCTIONS = {
diff --git a/src/tvplotlines/pass4.py b/src/tvplot/pass4.py
similarity index 98%
rename from src/tvplotlines/pass4.py
rename to src/tvplot/pass4.py
index 6f28dd2..d77113d 100644
--- a/src/tvplotlines/pass4.py
+++ b/src/tvplot/pass4.py
@@ -9,14 +9,14 @@
 import json
 import logging
 
-from tvplotlines.llm import LLMConfig, call_llm, call_llm_parallel
-from tvplotlines.models import (
+from tvplot.llm import LLMConfig, call_llm, call_llm_parallel
+from tvplot.models import (
     CastMember,
     EpisodeBreakdown,
     Plotline,
     SeriesContext,
 )
-from tvplotlines.prompts import load_prompt
+from tvplot.prompts import load_prompt
 
 logger = logging.getLogger(__name__)
 
diff --git a/src/tvplotlines/pipeline.py b/src/tvplot/pipeline.py
similarity index 90%
rename from src/tvplotlines/pipeline.py
rename to src/tvplot/pipeline.py
index 9960592..ba31cd1 100644
--- a/src/tvplotlines/pipeline.py
+++ b/src/tvplot/pipeline.py
@@ -1,248 +1,248 @@
-"""Main pipeline: get_plotlines() orchestrates Pass 0 → Pass 1 → Pass 2 → Pass 3 → Pass 4 → post-processing."""
-
-from __future__ import annotations
-
-import logging
-import re
-
-from tvplotlines.callbacks import PipelineCallback
-from tvplotlines.llm import LLMConfig, UsageStats, usage
-from tvplotlines.models import CastMember, EpisodeBreakdown, Plotline, TVPlotlinesResult, SeriesContext
-from tvplotlines.pass0 import detect_context
-from tvplotlines.pass1 import extract_plotlines
-from tvplotlines.pass2 import assign_events, assign_events_batch, assign_events_parallel
-from tvplotlines.pass3 import review_plotlines
-from tvplotlines.pass4 import assign_arc_functions
-from tvplotlines.postprocess import assign_orphan_events, compute_ranks, compute_span, validate_ranks
-from tvplotlines.verdicts import apply_verdicts
-
-logger = logging.getLogger(__name__)
-
-_EPISODE_ID_RE = re.compile(r"^S\d{2}E\d{2}$")
-
-
-def _warn_rank_limits(
-    plotlines: list[Plotline], is_ensemble: bool, n_episodes: int,
-) -> list[Plotline]:
-    """Log warnings if plotline counts exceed expected limits. No mutations."""
-    if is_ensemble:
-        max_total = 9 if n_episodes >= 9 else 7
-    else:
-        max_total = 7 if n_episodes >= 9 else 5
-
-    total = len([p for p in plotlines if p.computed_rank])
-    if total > max_total:
-        logger.warning("Plotline count %d exceeds expected max %d", total, max_total)
-
-    return plotlines
-
-
-def _fire(callback: PipelineCallback | None, method: str, *args) -> None:
-    """Call a callback method, swallowing exceptions."""
-    if callback is None:
-        return
-    try:
-        getattr(callback, method)(*args)
-    except Exception:
-        logger.exception("Callback %s raised", method)
-
-
-def get_plotlines(
-    show: str,
-    season: int,
-    episodes: dict[str, str],
-    *,
-    prior: TVPlotlinesResult | None = None,
-    context: SeriesContext | None = None,
-    cast: list[CastMember] | None = None,
-    plotlines: list[Plotline] | None = None,
-    breakdowns: list[EpisodeBreakdown] | None = None,
-    suggested_plotlines: list[dict] | None = None,
-    llm_provider: str = "anthropic",
-    model: str | None = None,
-    base_url: str | None = None,
-    system: str = "hollywood",
-    skip_review: bool = False,
-    pass2_mode: str = "batch",
-    batch_id: str | None = None,
-    callback: PipelineCallback | None = None,
-) -> TVPlotlinesResult:
-    """Extract plotlines from TV series synopses.
-
-    Args:
-        show: Series title.
-        season: Season number.
-        episodes: Dict mapping episode IDs (e.g. "S01E01") to synopsis texts.
-            Keys must match S{dd}E{dd} format and the season number must match
-            the ``season`` parameter.
-        prior: TVPlotlinesResult from the previous season. When provided and
-            context is None, reuses prior.context to skip Pass 0. Also
-            passes prior cast and plotlines to Pass 1 for continuity.
-            Incompatible with anthology format (anthology seasons are
-            independent by definition).
-        context: If provided, skip Pass 0 (auto-detection).
-        cast: If provided with plotlines, skip Pass 1.
-        plotlines: If provided with cast, skip Pass 1.
-        breakdowns: If provided, skip Pass 2.
-        llm_provider: "anthropic" or "openai".
-        model: Specific model name, or provider default.
-        skip_review: If True, skip Pass 3 (structural review).
-        pass2_mode: How to run Pass 2:
-            "parallel" — all episodes at once via async (fast, default)
-            "batch" — Anthropic batch API (50% cheaper, slower)
-            "sequential" — one episode at a time (simple, for debugging)
-        batch_id: Resume a batch by ID (only with pass2_mode="batch").
-        callback: PipelineCallback subclass for progress notifications.
-
-    Returns:
-        TVPlotlinesResult with context, cast, plotlines, and episode breakdowns.
-    """
-    if system == "narratology":
-        from tvplotlines.narratology import run_narratology
-        nconfig = LLMConfig(
-            provider=llm_provider, model=model, base_url=base_url, system=system,
-        )
-        return run_narratology(
-            show=show, season=season, episodes=episodes,
-            config=nconfig, callback=callback, skip_review=skip_review,
-        )
-    config = LLMConfig(provider=llm_provider, model=model, base_url=base_url, system=system)
-
-    # Validate episode keys and convert to sorted (id, text) pairs
-    season_prefix = f"S{season:02d}"
-    for key in episodes:
-        if not _EPISODE_ID_RE.match(key):
-            raise ValueError(
-                f"Episode key {key!r} must match S{{dd}}E{{dd}} format (e.g. 'S01E01')"
-            )
-        if not key.startswith(season_prefix):
-            raise ValueError(
-                f"Episode key {key!r} does not match season={season} "
-                f"(expected prefix {season_prefix!r})"
-            )
-    episode_pairs = [(eid, episodes[eid]) for eid in sorted(episodes)]
-    episode_ids = [eid for eid, _ in episode_pairs]
-    episode_texts = [text for _, text in episode_pairs]
-
-    # Validate resume parameters
-    if (cast is None) != (plotlines is None):
-        raise ValueError("cast and plotlines must be provided together (or both omitted)")
-
-    if breakdowns is not None and len(breakdowns) != len(episode_ids):
-        raise ValueError(
-            f"breakdowns length ({len(breakdowns)}) != episodes length ({len(episode_ids)})"
-        )
-
-    if batch_id is not None and pass2_mode != "batch":
-        raise ValueError(f"batch_id requires pass2_mode='batch', got {pass2_mode!r}")
-
-    # Validate prior parameter
-    if prior is not None:
-        prior_context = context or prior.context
-        if prior_context.is_anthology:
-            raise ValueError(
-                "prior is not supported for anthology format "
-                "(anthology seasons are independent by definition)"
-            )
-        if context is None:
-            context = prior.context
-
-    # Reset usage tracker for this run
-    global usage
-    usage.__init__()
-
-    # Pass 0: detect context (skip if provided)
-    if context is None:
-        context = detect_context(
-            show, season, episode_pairs[:3], config=config,
-            suggested_plotlines=suggested_plotlines,
-        )
-    _fire(callback, "on_pass0_complete", context)
-
-    # Pass 1: extract cast and plotlines from all synopses
-    if cast is None:
-        cast, plotlines = extract_plotlines(
-            show, season, context, episode_pairs,
-            prior_cast=prior.cast if prior else None,
-            prior_plotlines=prior.plotlines if prior else None,
-            suggested_plotlines=suggested_plotlines,
-            config=config,
-        )
-    _fire(callback, "on_pass1_complete", cast, plotlines)
-
-    # Pass 2: assign events for each episode
-    if breakdowns is None:
-        if pass2_mode == "parallel":
-            breakdowns = assign_events_parallel(
-                show, season, episode_pairs, context, cast, plotlines,
-                config=config,
-            )
-        elif pass2_mode == "batch":
-            breakdowns = assign_events_batch(
-                show, season, episode_pairs, context, cast, plotlines,
-                config=config,
-                batch_id=batch_id,
-                on_batch_submitted=lambda bid: _fire(callback, "on_batch_submitted", bid),
-            )
-        elif pass2_mode == "sequential":
-            breakdowns = []
-            for i, (episode_id, synopsis) in enumerate(episode_pairs):
-                breakdown = assign_events(
-                    show, season, episode_id, synopsis, context, cast, plotlines,
-                    config=config,
-                )
-                breakdowns.append(breakdown)
-                _fire(callback, "on_episode_complete", i, breakdown)
-        else:
-            raise ValueError(f"Unknown pass2_mode: {pass2_mode!r}")
-
-    _fire(callback, "on_pass2_complete", breakdowns)
-
-    # Post-processing: assign orphan events, compute span/rank, validate
-    assign_orphan_events(plotlines, breakdowns)
-    compute_span(plotlines, breakdowns)
-    compute_ranks(plotlines, breakdowns, context)
-    flags = validate_ranks(plotlines, breakdowns)
-    _warn_rank_limits(plotlines, context.is_ensemble, len(episode_ids))
-
-    # Pass 3: structural review (with diagnostic flags as context)
-    if not skip_review:
-        pass3_result = review_plotlines(
-            show, season, context, cast, plotlines, breakdowns,
-            diagnostics=flags or None,
-            config=config,
-        )
-        verdicts = pass3_result["verdicts"]
-        llm_ranks = pass3_result.get("ranks", {})
-
-        _fire(callback, "on_pass3_complete", verdicts)
-        if verdicts:
-            plotlines = apply_verdicts(
-                verdicts, plotlines, breakdowns,
-                series_format=context.format,
-            )
-            # Recompute span after verdicts (ranks are not recomputed —
-            # Pass 3 changes go into reviewed_rank, computed_rank stays)
-            compute_span(plotlines, breakdowns)
-
-        # Compare LLM-assigned ranks with computed_rank
-        for plotline in plotlines:
-            llm_rank = llm_ranks.get(plotline.id)
-            if llm_rank and llm_rank != plotline.computed_rank:
-                plotline.reviewed_rank = llm_rank
-
-        # Pass 4: assign arc functions to all events
-        count = assign_arc_functions(
-            show, season, context, cast, plotlines, breakdowns,
-            config=config,
-        )
-        _fire(callback, "on_pass4_complete", count)
-
-    result = TVPlotlinesResult(
-        context=context,
-        cast=cast,
-        plotlines=plotlines,
-        episodes=breakdowns,
-    )
-    result.usage = usage.summary(config.resolved_model)
-    return result
+"""Main pipeline: get_plotlines() orchestrates Pass 0 → Pass 1 → Pass 2 → Pass 3 → Pass 4 → post-processing."""
+
+from __future__ import annotations
+
+import logging
+import re
+
+from tvplot.callbacks import PipelineCallback
+from tvplot.llm import LLMConfig, UsageStats, usage
+from tvplot.models import CastMember, EpisodeBreakdown, Plotline, TVPlotlinesResult, SeriesContext
+from tvplot.pass0 import detect_context
+from tvplot.pass1 import extract_plotlines
+from tvplot.pass2 import assign_events, assign_events_batch, assign_events_parallel
+from tvplot.pass3 import review_plotlines
+from tvplot.pass4 import assign_arc_functions
+from tvplot.postprocess import assign_orphan_events, compute_ranks, compute_span, validate_ranks
+from tvplot.verdicts import apply_verdicts
+
+logger = logging.getLogger(__name__)
+
+_EPISODE_ID_RE = re.compile(r"^S\d{2}E\d{2}$")
+
+
+def _warn_rank_limits(
+    plotlines: list[Plotline], is_ensemble: bool, n_episodes: int,
+) -> list[Plotline]:
+    """Log warnings if plotline counts exceed expected limits. No mutations."""
+    if is_ensemble:
+        max_total = 9 if n_episodes >= 9 else 7
+    else:
+        max_total = 7 if n_episodes >= 9 else 5
+
+    total = len([p for p in plotlines if p.computed_rank])
+    if total > max_total:
+        logger.warning("Plotline count %d exceeds expected max %d", total, max_total)
+
+    return plotlines
+
+
+def _fire(callback: PipelineCallback | None, method: str, *args) -> None:
+    """Call a callback method, swallowing exceptions."""
+    if callback is None:
+        return
+    try:
+        getattr(callback, method)(*args)
+    except Exception:
+        logger.exception("Callback %s raised", method)
+
+
+def get_plotlines(
+    show: str,
+    season: int,
+    episodes: dict[str, str],
+    *,
+    prior: TVPlotlinesResult | None = None,
+    context: SeriesContext | None = None,
+    cast: list[CastMember] | None = None,
+    plotlines: list[Plotline] | None = None,
+    breakdowns: list[EpisodeBreakdown] | None = None,
+    suggested_plotlines: list[dict] | None = None,
+    llm_provider: str = "anthropic",
+    model: str | None = None,
+    base_url: str | None = None,
+    system: str = "hollywood",
+    skip_review: bool = False,
+    pass2_mode: str = "batch",
+    batch_id: str | None = None,
+    callback: PipelineCallback | None = None,
+) -> TVPlotlinesResult:
+    """Extract plotlines from TV series synopses.
+
+    Args:
+        show: Series title.
+        season: Season number.
+        episodes: Dict mapping episode IDs (e.g. "S01E01") to synopsis texts.
+            Keys must match S{dd}E{dd} format and the season number must match
+            the ``season`` parameter.
+        prior: TVPlotlinesResult from the previous season. When provided and
+            context is None, reuses prior.context to skip Pass 0. Also
+            passes prior cast and plotlines to Pass 1 for continuity.
+            Incompatible with anthology format (anthology seasons are
+            independent by definition).
+        context: If provided, skip Pass 0 (auto-detection).
+        cast: If provided with plotlines, skip Pass 1.
+        plotlines: If provided with cast, skip Pass 1.
+        breakdowns: If provided, skip Pass 2.
+        llm_provider: "anthropic" or "openai".
+        model: Specific model name, or provider default.
+        skip_review: If True, skip Pass 3 (structural review).
+        pass2_mode: How to run Pass 2:
+            "parallel" — all episodes at once via async (fast, default)
+            "batch" — Anthropic batch API (50% cheaper, slower)
+            "sequential" — one episode at a time (simple, for debugging)
+        batch_id: Resume a batch by ID (only with pass2_mode="batch").
+        callback: PipelineCallback subclass for progress notifications.
+
+    Returns:
+        TVPlotlinesResult with context, cast, plotlines, and episode breakdowns.
+    """
+    if system == "narratology":
+        from tvplot.narratology import run_narratology
+        nconfig = LLMConfig(
+            provider=llm_provider, model=model, base_url=base_url, system=system,
+        )
+        return run_narratology(
+            show=show, season=season, episodes=episodes,
+            config=nconfig, callback=callback, skip_review=skip_review,
+        )
+    config = LLMConfig(provider=llm_provider, model=model, base_url=base_url, system=system)
+
+    # Validate episode keys and convert to sorted (id, text) pairs
+    season_prefix = f"S{season:02d}"
+    for key in episodes:
+        if not _EPISODE_ID_RE.match(key):
+            raise ValueError(
+                f"Episode key {key!r} must match S{{dd}}E{{dd}} format (e.g. 'S01E01')"
+            )
+        if not key.startswith(season_prefix):
+            raise ValueError(
+                f"Episode key {key!r} does not match season={season} "
+                f"(expected prefix {season_prefix!r})"
+            )
+    episode_pairs = [(eid, episodes[eid]) for eid in sorted(episodes)]
+    episode_ids = [eid for eid, _ in episode_pairs]
+    episode_texts = [text for _, text in episode_pairs]
+
+    # Validate resume parameters
+    if (cast is None) != (plotlines is None):
+        raise ValueError("cast and plotlines must be provided together (or both omitted)")
+
+    if breakdowns is not None and len(breakdowns) != len(episode_ids):
+        raise ValueError(
+            f"breakdowns length ({len(breakdowns)}) != episodes length ({len(episode_ids)})"
+        )
+
+    if batch_id is not None and pass2_mode != "batch":
+        raise ValueError(f"batch_id requires pass2_mode='batch', got {pass2_mode!r}")
+
+    # Validate prior parameter
+    if prior is not None:
+        prior_context = context or prior.context
+        if prior_context.is_anthology:
+            raise ValueError(
+                "prior is not supported for anthology format "
+                "(anthology seasons are independent by definition)"
+            )
+        if context is None:
+            context = prior.context
+
+    # Reset usage tracker for this run
+    global usage
+    usage.__init__()
+
+    # Pass 0: detect context (skip if provided)
+    if context is None:
+        context = detect_context(
+            show, season, episode_pairs[:3], config=config,
+            suggested_plotlines=suggested_plotlines,
+        )
+    _fire(callback, "on_pass0_complete", context)
+
+    # Pass 1: extract cast and plotlines from all synopses
+    if cast is None:
+        cast, plotlines = extract_plotlines(
+            show, season, context, episode_pairs,
+            prior_cast=prior.cast if prior else None,
+            prior_plotlines=prior.plotlines if prior else None,
+            suggested_plotlines=suggested_plotlines,
+            config=config,
+        )
+    _fire(callback, "on_pass1_complete", cast, plotlines)
+
+    # Pass 2: assign events for each episode
+    if breakdowns is None:
+        if pass2_mode == "parallel":
+            breakdowns = assign_events_parallel(
+                show, season, episode_pairs, context, cast, plotlines,
+                config=config,
+            )
+        elif pass2_mode == "batch":
+            breakdowns = assign_events_batch(
+                show, season, episode_pairs, context, cast, plotlines,
+                config=config,
+                batch_id=batch_id,
+                on_batch_submitted=lambda bid: _fire(callback, "on_batch_submitted", bid),
+            )
+        elif pass2_mode == "sequential":
+            breakdowns = []
+            for i, (episode_id, synopsis) in enumerate(episode_pairs):
+                breakdown = assign_events(
+                    show, season, episode_id, synopsis, context, cast, plotlines,
+                    config=config,
+                )
+                breakdowns.append(breakdown)
+                _fire(callback, "on_episode_complete", i, breakdown)
+        else:
+            raise ValueError(f"Unknown pass2_mode: {pass2_mode!r}")
+
+    _fire(callback, "on_pass2_complete", breakdowns)
+
+    # Post-processing: assign orphan events, compute span/rank, validate
+    assign_orphan_events(plotlines, breakdowns)
+    compute_span(plotlines, breakdowns)
+    compute_ranks(plotlines, breakdowns, context)
+    flags = validate_ranks(plotlines, breakdowns)
+    _warn_rank_limits(plotlines, context.is_ensemble, len(episode_ids))
+
+    # Pass 3: structural review (with diagnostic flags as context)
+    if not skip_review:
+        pass3_result = review_plotlines(
+            show, season, context, cast, plotlines, breakdowns,
+            diagnostics=flags or None,
+            config=config,
+        )
+        verdicts = pass3_result["verdicts"]
+        llm_ranks = pass3_result.get("ranks", {})
+
+        _fire(callback, "on_pass3_complete", verdicts)
+        if verdicts:
+            plotlines = apply_verdicts(
+                verdicts, plotlines, breakdowns,
+                series_format=context.format,
+            )
+            # Recompute span after verdicts (ranks are not recomputed —
+            # Pass 3 changes go into reviewed_rank, computed_rank stays)
+            compute_span(plotlines, breakdowns)
+
+        # Compare LLM-assigned ranks with computed_rank
+        for plotline in plotlines:
+            llm_rank = llm_ranks.get(plotline.id)
+            if llm_rank and llm_rank != plotline.computed_rank:
+                plotline.reviewed_rank = llm_rank
+
+        # Pass 4: assign arc functions to all events
+        count = assign_arc_functions(
+            show, season, context, cast, plotlines, breakdowns,
+            config=config,
+        )
+        _fire(callback, "on_pass4_complete", count)
+
+    result = TVPlotlinesResult(
+        context=context,
+        cast=cast,
+        plotlines=plotlines,
+        episodes=breakdowns,
+    )
+    result.usage = usage.summary(config.resolved_model)
+    return result
diff --git a/src/tvplotlines/postprocess.py b/src/tvplot/postprocess.py
similarity index 96%
rename from src/tvplotlines/postprocess.py
rename to src/tvplot/postprocess.py
index 93b8273..1237d7f 100644
--- a/src/tvplotlines/postprocess.py
+++ b/src/tvplot/postprocess.py
@@ -1,251 +1,251 @@
-"""Post-processing: compute span, weight, rank.
-
-These fields are derived from Pass 2 results, not from LLM.
-"""
-
-from __future__ import annotations
-
-import logging
-from collections import Counter
-
-logger = logging.getLogger(__name__)
-
-from tvplotlines.models import EpisodeBreakdown, Plotline, SeriesContext
-
-
-def compute_span(
-    plotlines: list[Plotline],
-    episodes: list[EpisodeBreakdown],
-) -> None:
-    """Fill Plotline.span from episode breakdowns (in-place).
-
-    A plotline is present in an episode if it has at least one event there.
-    """
-    for plotline in plotlines:
-        present_episodes = []
-        for ep in episodes:
-            has_event = any(
-                e.plotline_id == plotline.id for e in ep.events
-            )
-            if has_event:
-                present_episodes.append(ep.episode)
-        plotline.span = present_episodes
-
-
-def assign_orphan_events(
-    plotlines: list[Plotline],
-    episodes: list[EpisodeBreakdown],
-) -> None:
-    """Assign null-plotline events to the most common plotline for their characters.
-
-    For each unassigned event, find the plotline most frequently associated
-    with its characters across the season. In-place modification.
-    """
-    # Build character → plotline frequency map from assigned events
-    char_plotline_counts: dict[str, Counter[str]] = {}
-    for ep in episodes:
-        for event in ep.events:
-            if event.plotline_id is None:
-                continue
-            for char in event.characters:
-                if char not in char_plotline_counts:
-                    char_plotline_counts[char] = Counter()
-                char_plotline_counts[char][event.plotline_id] += 1
-
-    plotline_ids = {p.id for p in plotlines}
-
-    # Assign orphan events
-    for ep in episodes:
-        for event in ep.events:
-            if event.plotline_id is not None:
-                continue
-            if not event.characters:
-                continue
-
-            # Aggregate plotline votes from all characters in this event
-            votes: Counter[str] = Counter()
-            for char in event.characters:
-                if char in char_plotline_counts:
-                    votes.update(char_plotline_counts[char])
-
-            if not votes:
-                # Fallback: use the most common plotline in this episode
-                ep_counts: Counter[str] = Counter()
-                for other in ep.events:
-                    if other.plotline_id:
-                        ep_counts[other.plotline_id] += 1
-                if ep_counts:
-                    votes = ep_counts
-
-            if votes:
-                best = votes.most_common(1)[0][0]
-                if best in plotline_ids:
-                    event.plotline_id = best
-
-
-def compute_weight(
-    plotlines: list[Plotline],
-    episode: EpisodeBreakdown,
-) -> dict[str, str]:
-    """Compute plotline weight for an episode based on event count.
-
-    Returns:
-        Dict mapping plotline id to weight ("primary" / "background" / "glimpse").
-    """
-    counts: Counter[str] = Counter()
-    for event in episode.events:
-        if event.plotline_id:
-            counts[event.plotline_id] += 1
-
-    if not counts:
-        return {}
-
-    max_count = max(counts.values())
-
-    weights = {}
-    for plotline_id, count in counts.items():
-        if count >= max_count * 0.5:
-            weights[plotline_id] = "primary"
-        elif count >= 2:
-            weights[plotline_id] = "background"
-        else:
-            weights[plotline_id] = "glimpse"
-
-    return weights
-
-
-def compute_ranks(
-    plotlines: list[Plotline],
-    episodes: list[EpisodeBreakdown],
-    context: SeriesContext,
-) -> None:
-    """Assign computed_rank to each plotline based on event counts (in-place).
-
-    Counts both primary events (plotline_id) and also_affects mentions equally.
-    The LLM's choice of primary vs also_affects is often arbitrary — the event
-    advances both plotlines. Equal weight avoids amplifying that arbitrariness.
-
-    Rules:
-    1. Runners get no rank (None).
-    2. Procedural format: case_of_the_week → A.
-    3. Hybrid format: case_of_the_week → B.
-    4. Remaining plotlines sorted by descending event count:
-       first → highest available rank, second → next, rest → C.
-    """
-    # Count events per plotline: primary + also_affects, equal weight
-    event_counts: Counter[str] = Counter()
-    for ep in episodes:
-        for event in ep.events:
-            if event.plotline_id:
-                event_counts[event.plotline_id] += 1
-            for aa in event.also_affects or []:
-                event_counts[aa] += 1
-
-    # Phase 1: fixed assignments
-    fixed_ids: set[str] = set()
-    is_a_taken = False
-
-    for plotline in plotlines:
-        if plotline.type == "runner":
-            plotline.computed_rank = None
-            fixed_ids.add(plotline.id)
-        elif plotline.type == "case_of_the_week":
-            if context.format == "procedural":
-                plotline.computed_rank = "A"
-                is_a_taken = True
-            elif context.format == "hybrid":
-                plotline.computed_rank = "B"
-            fixed_ids.add(plotline.id)
-
-    # Phase 2: remaining plotlines sorted by event count, filtered by span
-    n_episodes = len(episodes)
-    remaining = [p for p in plotlines if p.id not in fixed_ids]
-    remaining.sort(key=lambda p: (-event_counts.get(p.id, 0), p.id))
-
-    logger.info(
-        "Rank assignment order: %s",
-        [(p.id, event_counts.get(p.id, 0), len(p.span)) for p in remaining],
-    )
-
-    # Span requirements: A ≥ 75%, B ≥ 50%, C ≥ 25%
-    for i, plotline in enumerate(remaining):
-        span_frac = len(plotline.span) / n_episodes if n_episodes else 0
-        if i == 0 and not is_a_taken and span_frac >= 0.75:
-            plotline.computed_rank = "A"
-            is_a_taken = True
-        elif i <= 1 and span_frac >= 0.50:
-            plotline.computed_rank = "B" if is_a_taken else "A"
-            if plotline.computed_rank == "A":
-                is_a_taken = True
-        elif span_frac >= 0.25:
-            plotline.computed_rank = "C"
-        else:
-            plotline.computed_rank = "C"  # low span but still serialized, not runner
-        logger.info(
-            "  %s → %s (events=%d, span=%d/%d=%.0f%%)",
-            plotline.id, plotline.computed_rank, event_counts.get(plotline.id, 0),
-            len(plotline.span), n_episodes, span_frac * 100,
-        )
-
-
-def validate_ranks(
-    plotlines: list[Plotline],
-    episodes: list[EpisodeBreakdown],
-    *,
-    min_span_frac: float = 0.25,
-    dominance_threshold: float = 0.50,
-) -> list[dict]:
-    """Check rank-span consistency and event dominance. In-place fixes.
-
-    Rules:
-    1. A-rank line with span < 25% of season → demote to B.
-    2. Any line with > 50% of all events → flag for Pass 3 context.
-
-    Returns list of flags (dicts with line id, flag type, details).
-    """
-    n_episodes = len(episodes)
-    if n_episodes == 0:
-        return []
-
-    # Count events per line
-    total_events = 0
-    counts: Counter[str] = Counter()
-    for ep in episodes:
-        for event in ep.events:
-            total_events += 1
-            if event.plotline_id:
-                counts[event.plotline_id] += 1
-
-    # Collect all flags first, then apply mutations — avoids Rule 1 demotions
-    # affecting Rule 2 dominance checks on the same pass
-    flags = []
-    demotions: list[Plotline] = []
-
-    for plotline in plotlines:
-        span_len = len(plotline.span) if isinstance(plotline.span, list) else 0
-        span_frac = span_len / n_episodes
-
-        # Rule 1: A computed_rank + short span → demote to B
-        if plotline.computed_rank == "A" and span_frac < min_span_frac:
-            demotions.append(plotline)
-            flags.append({
-                "plotline": plotline.id,
-                "flag": "demoted",
-                "reason": f"computed_rank A but span {span_len}/{n_episodes} ({span_frac:.0%})",
-            })
-
-        # Rule 2: dominates event share → flag
-        if total_events > 0:
-            share = counts.get(plotline.id, 0) / total_events
-            if share > dominance_threshold:
-                flags.append({
-                    "plotline": plotline.id,
-                    "flag": "dominant",
-                    "reason": f"{share:.0%} of events ({counts[plotline.id]}/{total_events})",
-                })
-
-    # Apply demotions after all rules evaluated
-    for plotline in demotions:
-        plotline.computed_rank = "B"
-
-    return flags
+"""Post-processing: compute span, weight, rank.
+
+These fields are derived from Pass 2 results, not from LLM.
+"""
+
+from __future__ import annotations
+
+import logging
+from collections import Counter
+
+logger = logging.getLogger(__name__)
+
+from tvplot.models import EpisodeBreakdown, Plotline, SeriesContext
+
+
+def compute_span(
+    plotlines: list[Plotline],
+    episodes: list[EpisodeBreakdown],
+) -> None:
+    """Fill Plotline.span from episode breakdowns (in-place).
+
+    A plotline is present in an episode if it has at least one event there.
+    """
+    for plotline in plotlines:
+        present_episodes = []
+        for ep in episodes:
+            has_event = any(
+                e.plotline_id == plotline.id for e in ep.events
+            )
+            if has_event:
+                present_episodes.append(ep.episode)
+        plotline.span = present_episodes
+
+
+def assign_orphan_events(
+    plotlines: list[Plotline],
+    episodes: list[EpisodeBreakdown],
+) -> None:
+    """Assign null-plotline events to the most common plotline for their characters.
+
+    For each unassigned event, find the plotline most frequently associated
+    with its characters across the season. In-place modification.
+    """
+    # Build character → plotline frequency map from assigned events
+    char_plotline_counts: dict[str, Counter[str]] = {}
+    for ep in episodes:
+        for event in ep.events:
+            if event.plotline_id is None:
+                continue
+            for char in event.characters:
+                if char not in char_plotline_counts:
+                    char_plotline_counts[char] = Counter()
+                char_plotline_counts[char][event.plotline_id] += 1
+
+    plotline_ids = {p.id for p in plotlines}
+
+    # Assign orphan events
+    for ep in episodes:
+        for event in ep.events:
+            if event.plotline_id is not None:
+                continue
+            if not event.characters:
+                continue
+
+            # Aggregate plotline votes from all characters in this event
+            votes: Counter[str] = Counter()
+            for char in event.characters:
+                if char in char_plotline_counts:
+                    votes.update(char_plotline_counts[char])
+
+            if not votes:
+                # Fallback: use the most common plotline in this episode
+                ep_counts: Counter[str] = Counter()
+                for other in ep.events:
+                    if other.plotline_id:
+                        ep_counts[other.plotline_id] += 1
+                if ep_counts:
+                    votes = ep_counts
+
+            if votes:
+                best = votes.most_common(1)[0][0]
+                if best in plotline_ids:
+                    event.plotline_id = best
+
+
+def compute_weight(
+    plotlines: list[Plotline],
+    episode: EpisodeBreakdown,
+) -> dict[str, str]:
+    """Compute plotline weight for an episode based on event count.
+
+    Returns:
+        Dict mapping plotline id to weight ("primary" / "background" / "glimpse").
+    """
+    counts: Counter[str] = Counter()
+    for event in episode.events:
+        if event.plotline_id:
+            counts[event.plotline_id] += 1
+
+    if not counts:
+        return {}
+
+    max_count = max(counts.values())
+
+    weights = {}
+    for plotline_id, count in counts.items():
+        if count >= max_count * 0.5:
+            weights[plotline_id] = "primary"
+        elif count >= 2:
+            weights[plotline_id] = "background"
+        else:
+            weights[plotline_id] = "glimpse"
+
+    return weights
+
+
+def compute_ranks(
+    plotlines: list[Plotline],
+    episodes: list[EpisodeBreakdown],
+    context: SeriesContext,
+) -> None:
+    """Assign computed_rank to each plotline based on event counts (in-place).
+
+    Counts both primary events (plotline_id) and also_affects mentions equally.
+    The LLM's choice of primary vs also_affects is often arbitrary — the event
+    advances both plotlines. Equal weight avoids amplifying that arbitrariness.
+
+    Rules:
+    1. Runners get no rank (None).
+    2. Procedural format: case_of_the_week → A.
+    3. Hybrid format: case_of_the_week → B.
+    4. Remaining plotlines sorted by descending event count:
+       first → highest available rank, second → next, rest → C.
+    """
+    # Count events per plotline: primary + also_affects, equal weight
+    event_counts: Counter[str] = Counter()
+    for ep in episodes:
+        for event in ep.events:
+            if event.plotline_id:
+                event_counts[event.plotline_id] += 1
+            for aa in event.also_affects or []:
+                event_counts[aa] += 1
+
+    # Phase 1: fixed assignments
+    fixed_ids: set[str] = set()
+    is_a_taken = False
+
+    for plotline in plotlines:
+        if plotline.type == "runner":
+            plotline.computed_rank = None
+            fixed_ids.add(plotline.id)
+        elif plotline.type == "case_of_the_week":
+            if context.format == "procedural":
+                plotline.computed_rank = "A"
+                is_a_taken = True
+            elif context.format == "hybrid":
+                plotline.computed_rank = "B"
+            fixed_ids.add(plotline.id)
+
+    # Phase 2: remaining plotlines sorted by event count, filtered by span
+    n_episodes = len(episodes)
+    remaining = [p for p in plotlines if p.id not in fixed_ids]
+    remaining.sort(key=lambda p: (-event_counts.get(p.id, 0), p.id))
+
+    logger.info(
+        "Rank assignment order: %s",
+        [(p.id, event_counts.get(p.id, 0), len(p.span)) for p in remaining],
+    )
+
+    # Span requirements: A ≥ 75%, B ≥ 50%, C ≥ 25%
+    for i, plotline in enumerate(remaining):
+        span_frac = len(plotline.span) / n_episodes if n_episodes else 0
+        if i == 0 and not is_a_taken and span_frac >= 0.75:
+            plotline.computed_rank = "A"
+            is_a_taken = True
+        elif i <= 1 and span_frac >= 0.50:
+            plotline.computed_rank = "B" if is_a_taken else "A"
+            if plotline.computed_rank == "A":
+                is_a_taken = True
+        elif span_frac >= 0.25:
+            plotline.computed_rank = "C"
+        else:
+            plotline.computed_rank = "C"  # low span but still serialized, not runner
+        logger.info(
+            "  %s → %s (events=%d, span=%d/%d=%.0f%%)",
+            plotline.id, plotline.computed_rank, event_counts.get(plotline.id, 0),
+            len(plotline.span), n_episodes, span_frac * 100,
+        )
+
+
+def validate_ranks(
+    plotlines: list[Plotline],
+    episodes: list[EpisodeBreakdown],
+    *,
+    min_span_frac: float = 0.25,
+    dominance_threshold: float = 0.50,
+) -> list[dict]:
+    """Check rank-span consistency and event dominance. In-place fixes.
+
+    Rules:
+    1. A-rank line with span < 25% of season → demote to B.
+    2. Any line with > 50% of all events → flag for Pass 3 context.
+
+    Returns list of flags (dicts with line id, flag type, details).
+    """
+    n_episodes = len(episodes)
+    if n_episodes == 0:
+        return []
+
+    # Count events per line
+    total_events = 0
+    counts: Counter[str] = Counter()
+    for ep in episodes:
+        for event in ep.events:
+            total_events += 1
+            if event.plotline_id:
+                counts[event.plotline_id] += 1
+
+    # Collect all flags first, then apply mutations — avoids Rule 1 demotions
+    # affecting Rule 2 dominance checks on the same pass
+    flags = []
+    demotions: list[Plotline] = []
+
+    for plotline in plotlines:
+        span_len = len(plotline.span) if isinstance(plotline.span, list) else 0
+        span_frac = span_len / n_episodes
+
+        # Rule 1: A computed_rank + short span → demote to B
+        if plotline.computed_rank == "A" and span_frac < min_span_frac:
+            demotions.append(plotline)
+            flags.append({
+                "plotline": plotline.id,
+                "flag": "demoted",
+                "reason": f"computed_rank A but span {span_len}/{n_episodes} ({span_frac:.0%})",
+            })
+
+        # Rule 2: dominates event share → flag
+        if total_events > 0:
+            share = counts.get(plotline.id, 0) / total_events
+            if share > dominance_threshold:
+                flags.append({
+                    "plotline": plotline.id,
+                    "flag": "dominant",
+                    "reason": f"{share:.0%} of events ({counts[plotline.id]}/{total_events})",
+                })
+
+    # Apply demotions after all rules evaluated
+    for plotline in demotions:
+        plotline.computed_rank = "B"
+
+    return flags
diff --git a/src/tvplotlines/prompts/__init__.py b/src/tvplot/prompts/__init__.py
similarity index 97%
rename from src/tvplotlines/prompts/__init__.py
rename to src/tvplot/prompts/__init__.py
index 5b033f3..5cf7b34 100644
--- a/src/tvplotlines/prompts/__init__.py
+++ b/src/tvplot/prompts/__init__.py
@@ -24,7 +24,7 @@ def _package_for(system: str) -> str:
         raise ValueError(
             f"Unsupported system: {system!r}. Expected one of {list(SYSTEMS)}"
         )
-    return f"tvplotlines.prompts.{system}"
+    return f"tvplot.prompts.{system}"
 
 
 def _load_glossary(system: str) -> str:
diff --git a/src/tvplotlines/prompts/hollywood/__init__.py b/src/tvplot/prompts/hollywood/__init__.py
similarity index 100%
rename from src/tvplotlines/prompts/hollywood/__init__.py
rename to src/tvplot/prompts/hollywood/__init__.py
diff --git a/src/tvplotlines/prompts/hollywood/glossary.md b/src/tvplot/prompts/hollywood/glossary.md
similarity index 100%
rename from src/tvplotlines/prompts/hollywood/glossary.md
rename to src/tvplot/prompts/hollywood/glossary.md
diff --git a/src/tvplotlines/prompts/hollywood/pass0.md b/src/tvplot/prompts/hollywood/pass0.md
similarity index 100%
rename from src/tvplotlines/prompts/hollywood/pass0.md
rename to src/tvplot/prompts/hollywood/pass0.md
diff --git a/src/tvplotlines/prompts/hollywood/pass1.md b/src/tvplot/prompts/hollywood/pass1.md
similarity index 100%
rename from src/tvplotlines/prompts/hollywood/pass1.md
rename to src/tvplot/prompts/hollywood/pass1.md
diff --git a/src/tvplotlines/prompts/hollywood/pass2.md b/src/tvplot/prompts/hollywood/pass2.md
similarity index 100%
rename from src/tvplotlines/prompts/hollywood/pass2.md
rename to src/tvplot/prompts/hollywood/pass2.md
diff --git a/src/tvplotlines/prompts/hollywood/pass3.md b/src/tvplot/prompts/hollywood/pass3.md
similarity index 100%
rename from src/tvplotlines/prompts/hollywood/pass3.md
rename to src/tvplot/prompts/hollywood/pass3.md
diff --git a/src/tvplotlines/prompts/hollywood/pass4.md b/src/tvplot/prompts/hollywood/pass4.md
similarity index 100%
rename from src/tvplotlines/prompts/hollywood/pass4.md
rename to src/tvplot/prompts/hollywood/pass4.md
diff --git a/src/tvplotlines/prompts/hollywood/synopses_writer.md b/src/tvplot/prompts/hollywood/synopses_writer.md
similarity index 100%
rename from src/tvplotlines/prompts/hollywood/synopses_writer.md
rename to src/tvplot/prompts/hollywood/synopses_writer.md
diff --git a/src/tvplotlines/prompts/narratology/__init__.py b/src/tvplot/prompts/narratology/__init__.py
similarity index 100%
rename from src/tvplotlines/prompts/narratology/__init__.py
rename to src/tvplot/prompts/narratology/__init__.py
diff --git a/src/tvplotlines/prompts/narratology/glossary.md b/src/tvplot/prompts/narratology/glossary.md
similarity index 100%
rename from src/tvplotlines/prompts/narratology/glossary.md
rename to src/tvplot/prompts/narratology/glossary.md
diff --git a/src/tvplotlines/prompts/narratology/pass1_context.md b/src/tvplot/prompts/narratology/pass1_context.md
similarity index 100%
rename from src/tvplotlines/prompts/narratology/pass1_context.md
rename to src/tvplot/prompts/narratology/pass1_context.md
diff --git a/src/tvplotlines/prompts/narratology/pass2_fabula.md b/src/tvplot/prompts/narratology/pass2_fabula.md
similarity index 100%
rename from src/tvplotlines/prompts/narratology/pass2_fabula.md
rename to src/tvplot/prompts/narratology/pass2_fabula.md
diff --git a/src/tvplotlines/prompts/narratology/pass3_actants.md b/src/tvplot/prompts/narratology/pass3_actants.md
similarity index 100%
rename from src/tvplotlines/prompts/narratology/pass3_actants.md
rename to src/tvplot/prompts/narratology/pass3_actants.md
diff --git a/src/tvplotlines/prompts/narratology/pass4_story.md b/src/tvplot/prompts/narratology/pass4_story.md
similarity index 100%
rename from src/tvplotlines/prompts/narratology/pass4_story.md
rename to src/tvplot/prompts/narratology/pass4_story.md
diff --git a/src/tvplotlines/prompts/narratology/pass5_arc.md b/src/tvplot/prompts/narratology/pass5_arc.md
similarity index 100%
rename from src/tvplotlines/prompts/narratology/pass5_arc.md
rename to src/tvplot/prompts/narratology/pass5_arc.md
diff --git a/src/tvplotlines/prompts/narratology/pass6_review.md b/src/tvplot/prompts/narratology/pass6_review.md
similarity index 100%
rename from src/tvplotlines/prompts/narratology/pass6_review.md
rename to src/tvplot/prompts/narratology/pass6_review.md
diff --git a/src/tvplotlines/prompts/narratology/synopses_writer.md b/src/tvplot/prompts/narratology/synopses_writer.md
similarity index 100%
rename from src/tvplotlines/prompts/narratology/synopses_writer.md
rename to src/tvplot/prompts/narratology/synopses_writer.md
diff --git a/src/tvplotlines/py.typed b/src/tvplot/py.typed
similarity index 100%
rename from src/tvplotlines/py.typed
rename to src/tvplot/py.typed
diff --git a/src/tvplotlines/synopses_writer.py b/src/tvplot/synopses_writer.py
similarity index 98%
rename from src/tvplotlines/synopses_writer.py
rename to src/tvplot/synopses_writer.py
index 7c6ce9c..d9f61ca 100644
--- a/src/tvplotlines/synopses_writer.py
+++ b/src/tvplot/synopses_writer.py
@@ -26,7 +26,7 @@ class RawEpisode(TypedDict):
 except ImportError:
     httpx = None  # type: ignore[assignment]
 
-_USER_AGENT = "tvplotlines/0.1.0 (https://github.com/BirdInTheTree/tvplotlines)"
+_USER_AGENT = "tvplot/0.1.0 (https://github.com/BirdInTheTree/tvplot)"
 _MAX_RETRIES = 3
 _MIN_DESCRIPTION_LENGTH = 50
 # Fandom recap sections use varying header names across wikis
@@ -45,8 +45,8 @@ def fetch_season_page(
     Tries {Show}_(season_{N}), then {Show}_season_{N} if 404.
     Use wiki_title to override automatic title construction.
 
-    Requires httpx (pip install tvplotlines[writer]).
-    User-Agent: tvplotlines/0.1.0
+    Requires httpx (pip install tvplot[writer]).
+    User-Agent: tvplot/0.1.0
 
     Args:
         show: Show name, e.g. "House" or "Breaking Bad".
@@ -60,7 +60,7 @@ def fetch_season_page(
     if httpx is None:
         raise ImportError(
             "httpx is required for fetching Wikipedia pages. "
-            "Install with: pip install tvplotlines[writer]"
+            "Install with: pip install tvplot[writer]"
         )
 
     endpoint = f"https://{lang}.wikipedia.org/w/api.php"
@@ -381,7 +381,7 @@ def fetch_fandom_episodes(
     if httpx is None:
         raise ImportError(
             "httpx is required for fetching Fandom pages. "
-            "Install with: pip install tvplotlines[writer]"
+            "Install with: pip install tvplot[writer]"
         )
 
     resolved_wiki = wiki_name or _guess_wiki_name(show)
@@ -561,13 +561,13 @@ def _validate_plotlines(plotlines: list) -> list[dict]:
 
 def _build_system_prompt(*, use_glossary: bool, system: str = "hollywood") -> str:
     """Load the synopses_writer prompt for a given system, optionally with glossary."""
-    from tvplotlines.prompts import load_prompt
+    from tvplot.prompts import load_prompt
 
     if use_glossary:
         return load_prompt("synopses_writer", system=system)
 
     from importlib import resources
-    text = resources.files(f"tvplotlines.prompts.{system}").joinpath(
+    text = resources.files(f"tvplot.prompts.{system}").joinpath(
         "synopses_writer.md"
     ).read_text(encoding="utf-8")
     return text.replace("{GLOSSARY}", "")
@@ -695,7 +695,7 @@ def _rewrite_parallel(
     fandom_map=None,
 ) -> tuple[list[str], list[list[dict]]]:
     """Each episode in a separate parallel LLM call."""
-    from tvplotlines.llm import call_llm_parallel
+    from tvplot.llm import call_llm_parallel
 
     fandom = fandom_map or {}
     user_messages = [
@@ -713,7 +713,7 @@ def _rewrite_batch(
     fandom_map=None,
 ) -> tuple[list[str], list[list[dict]]]:
     """Each episode in a separate call, sent as Anthropic batch."""
-    from tvplotlines.llm import call_llm_batch
+    from tvplot.llm import call_llm_batch
 
     fandom = fandom_map or {}
     user_messages = [
@@ -731,7 +731,7 @@ def _rewrite_sequential(
     fandom_map=None,
 ) -> tuple[list[str], list[list[dict]]]:
     """Episodes one by one; each call includes all previous synopses as context."""
-    from tvplotlines.llm import call_llm
+    from tvplot.llm import call_llm
 
     fandom = fandom_map or {}
     synopses: list[str] = []
@@ -798,7 +798,7 @@ def _rewrite_single_one_call(
     fandom_map=None,
 ) -> tuple[list[str], list[list[dict]]]:
     """All episodes in one LLM call."""
-    from tvplotlines.llm import call_llm
+    from tvplot.llm import call_llm
 
     fandom = fandom_map or {}
     episode_blocks = []
@@ -1084,7 +1084,7 @@ def write_synopses(
             print(f"Fandom recaps available for {fandom_count}/{len(episodes)} episodes")
         return
 
-    from tvplotlines.llm import LLMConfig, usage
+    from tvplot.llm import LLMConfig, usage
 
     config = LLMConfig(provider=provider, model=model, base_url=base_url, system=system)
     usage.__init__()  # Reset usage tracker
diff --git a/src/tvplotlines/verdicts.py b/src/tvplot/verdicts.py
similarity index 99%
rename from src/tvplotlines/verdicts.py
rename to src/tvplot/verdicts.py
index cca0674..75c66bb 100644
--- a/src/tvplotlines/verdicts.py
+++ b/src/tvplot/verdicts.py
@@ -8,7 +8,7 @@
 
 import logging
 
-from tvplotlines.models import EpisodeBreakdown, Plotline, Verdict
+from tvplot.models import EpisodeBreakdown, Plotline, Verdict
 
 logger = logging.getLogger(__name__)
 
diff --git a/src/tvplotlines/__main__.py b/src/tvplotlines/__main__.py
deleted file mode 100644
index f74e9b0..0000000
--- a/src/tvplotlines/__main__.py
+++ /dev/null
@@ -1,4 +0,0 @@
-"""Allow running tvplotlines as: python -m tvplotlines run ..."""
-from tvplotlines.cli import main
-
-main()
diff --git a/tests/test_html_build.py b/tests/test_html_build.py
index 18ce29c..90446ba 100644
--- a/tests/test_html_build.py
+++ b/tests/test_html_build.py
@@ -2,12 +2,14 @@
 import tempfile
 from pathlib import Path
 
+_REPO = Path(__file__).resolve().parent.parent
+
 
 def test_build_produces_html():
     result = subprocess.run(
-        ["python", "src/tvplotlines/html/build.py", "--output", "/tmp/test_viewer.html"],
+        ["python", "src/tvplot/html/build.py", "--output", "/tmp/test_viewer.html"],
         capture_output=True, text=True,
-        cwd="/Users/nvashko/Projects/1-projects/tvplotlines",
+        cwd=_REPO,
     )
     assert result.returncode == 0, f"Build failed: {result.stderr}"
     html = Path("/tmp/test_viewer.html").read_text()
@@ -20,9 +22,9 @@ def test_build_produces_html():
 def test_build_embeds_demo_data():
     """Demo data from bb_s01.json should be embedded in the output."""
     result = subprocess.run(
-        ["python", "src/tvplotlines/html/build.py", "--output", "/tmp/test_viewer.html"],
+        ["python", "src/tvplot/html/build.py", "--output", "/tmp/test_viewer.html"],
         capture_output=True, text=True,
-        cwd="/Users/nvashko/Projects/1-projects/tvplotlines",
+        cwd=_REPO,
     )
     assert result.returncode == 0
     html = Path("/tmp/test_viewer.html").read_text()
@@ -38,12 +40,12 @@ def test_build_with_custom_data():
 
     result = subprocess.run(
         [
-            "python", "src/tvplotlines/html/build.py",
+            "python", "src/tvplot/html/build.py",
             "--output", "/tmp/test_viewer_custom.html",
             "--data", tmp_path,
         ],
         capture_output=True, text=True,
-        cwd="/Users/nvashko/Projects/1-projects/tvplotlines",
+        cwd=_REPO,
     )
     assert result.returncode == 0
     html = Path("/tmp/test_viewer_custom.html").read_text()
diff --git a/tests/test_input.py b/tests/test_input.py
index 8e2623c..58e83bb 100644
--- a/tests/test_input.py
+++ b/tests/test_input.py
@@ -4,7 +4,7 @@
 
 import pytest
 
-from tvplotlines.input import load_synopses_dir
+from tvplot.input import load_synopses_dir
 
 
 @pytest.fixture
diff --git a/tests/test_llm.py b/tests/test_llm.py
index 9046538..79c7ba9 100644
--- a/tests/test_llm.py
+++ b/tests/test_llm.py
@@ -1,29 +1,29 @@
-"""Unit tests for LLM utilities (no API calls)."""
-
-import pytest
-
-from tvplotlines.llm import _extract_json
-
-
-class TestExtractJson:
-    def test_plain_json(self):
-        result = _extract_json('{"key": "value"}')
-        assert result == {"key": "value"}
-
-    def test_json_in_code_block(self):
-        text = '```json\n{"key": "value"}\n```'
-        result = _extract_json(text)
-        assert result == {"key": "value"}
-
-    def test_json_with_whitespace(self):
-        result = _extract_json('  \n{"key": "value"}\n  ')
-        assert result == {"key": "value"}
-
-    def test_invalid_json_raises(self):
-        with pytest.raises(ValueError, match="Could not parse JSON"):
-            _extract_json("this is not json")
-
-    def test_json_in_code_block_no_lang(self):
-        text = '```\n{"key": "value"}\n```'
-        result = _extract_json(text)
-        assert result == {"key": "value"}
+"""Unit tests for LLM utilities (no API calls)."""
+
+import pytest
+
+from tvplot.llm import _extract_json
+
+
+class TestExtractJson:
+    def test_plain_json(self):
+        result = _extract_json('{"key": "value"}')
+        assert result == {"key": "value"}
+
+    def test_json_in_code_block(self):
+        text = '```json\n{"key": "value"}\n```'
+        result = _extract_json(text)
+        assert result == {"key": "value"}
+
+    def test_json_with_whitespace(self):
+        result = _extract_json('  \n{"key": "value"}\n  ')
+        assert result == {"key": "value"}
+
+    def test_invalid_json_raises(self):
+        with pytest.raises(ValueError, match="Could not parse JSON"):
+            _extract_json("this is not json")
+
+    def test_json_in_code_block_no_lang(self):
+        text = '```\n{"key": "value"}\n```'
+        result = _extract_json(text)
+        assert result == {"key": "value"}
diff --git a/tests/test_metrics.py b/tests/test_metrics.py
index 259a15f..75643c6 100644
--- a/tests/test_metrics.py
+++ b/tests/test_metrics.py
@@ -1,123 +1,123 @@
-"""Tests for quality metrics."""
-
-from __future__ import annotations
-
-from tvplotlines.metrics import compute_coverage, compute_consistency_ari, compute_score
-from tvplotlines.models import EpisodeBreakdown, Event
-
-
-def _ep(events_data: list[tuple[str, str | None]]) -> EpisodeBreakdown:
-    """Helper: create episode from (event_text, plotline) pairs."""
-    return EpisodeBreakdown(
-        episode="S01E01",
-        events=[
-            Event(event=text, plotline_id=line, function="setup", characters=["a"])
-            for text, line in events_data
-        ],
-    )
-
-
-class TestCoverage:
-    def test_all_assigned(self):
-        ep = _ep([("e1", "line_a"), ("e2", "line_b")])
-        assert compute_coverage([ep]) == 1.0
-
-    def test_some_null(self):
-        ep = _ep([("e1", "line_a"), ("e2", None), ("e3", "line_b"), ("e4", None)])
-        assert compute_coverage([ep]) == 0.5
-
-    def test_all_null(self):
-        ep = _ep([("e1", None), ("e2", None)])
-        assert compute_coverage([ep]) == 0.0
-
-    def test_empty(self):
-        ep = EpisodeBreakdown(episode="S01E01")
-        assert compute_coverage([ep]) == 1.0
-
-    def test_multiple_episodes(self):
-        ep1 = _ep([("e1", "a"), ("e2", "b")])
-        ep2 = _ep([("e3", None), ("e4", None)])
-        assert compute_coverage([ep1, ep2]) == 0.5
-
-
-class TestConsistencyARI:
-    def test_identical_runs(self):
-        ep = EpisodeBreakdown(
-            episode="S01E01",
-            events=[
-                Event(event="e1", plotline_id="line_a", function="setup", characters=["char1"]),
-                Event(event="e2", plotline_id="line_b", function="setup", characters=["char2"]),
-            ],
-        )
-        # Same data twice = perfect consistency
-        ari = compute_consistency_ari([[ep], [ep]], cast_ids=["char1", "char2"])
-        assert ari == 1.0
-
-    def test_different_names_same_structure(self):
-        """Runs with different plotline names but same grouping = high ARI."""
-        ep_run1 = EpisodeBreakdown(
-            episode="S01E01",
-            events=[
-                Event(event="e1", plotline_id="belonging", function="setup", characters=["char1"]),
-                Event(event="e2", plotline_id="belonging", function="setup", characters=["char2"]),
-                Event(event="e3", plotline_id="leadership", function="setup", characters=["char3"]),
-            ],
-        )
-        ep_run2 = EpisodeBreakdown(
-            episode="S01E01",
-            events=[
-                Event(event="e1", plotline_id="acceptance", function="setup", characters=["char1"]),
-                Event(event="e2", plotline_id="acceptance", function="setup", characters=["char2"]),
-                Event(event="e3", plotline_id="power", function="setup", characters=["char3"]),
-            ],
-        )
-        ari = compute_consistency_ari(
-            [[ep_run1], [ep_run2]],
-            cast_ids=["char1", "char2", "char3"],
-        )
-        assert ari == 1.0
-
-    def test_completely_different(self):
-        """Opposite groupings = low ARI."""
-        ep_run1 = EpisodeBreakdown(
-            episode="S01E01",
-            events=[
-                Event(event="e1", plotline_id="A", function="setup", characters=["c1"]),
-                Event(event="e2", plotline_id="A", function="setup", characters=["c2"]),
-                Event(event="e3", plotline_id="B", function="setup", characters=["c3"]),
-                Event(event="e4", plotline_id="B", function="setup", characters=["c4"]),
-            ],
-        )
-        ep_run2 = EpisodeBreakdown(
-            episode="S01E01",
-            events=[
-                Event(event="e1", plotline_id="X", function="setup", characters=["c1"]),
-                Event(event="e2", plotline_id="Y", function="setup", characters=["c2"]),
-                Event(event="e3", plotline_id="X", function="setup", characters=["c3"]),
-                Event(event="e4", plotline_id="Y", function="setup", characters=["c4"]),
-            ],
-        )
-        ari = compute_consistency_ari(
-            [[ep_run1], [ep_run2]],
-            cast_ids=["c1", "c2", "c3", "c4"],
-        )
-        assert ari < 0.0  # worse than random
-
-    def test_single_run(self):
-        """One run = perfect consistency by definition."""
-        ep = EpisodeBreakdown(episode="S01E01", events=[])
-        assert compute_consistency_ari([[ep]], cast_ids=["c1"]) == 1.0
-
-
-class TestScore:
-    def test_perfect(self):
-        assert compute_score(1.0, 1.0) == 1.0
-
-    def test_zero_coverage(self):
-        assert compute_score(0.0, 1.0) == 0.0
-
-    def test_zero_consistency(self):
-        assert compute_score(1.0, 0.0) == 0.0
-
-    def test_multiplicative(self):
-        assert compute_score(0.8, 0.5) == 0.4
+"""Tests for quality metrics."""
+
+from __future__ import annotations
+
+from tvplot.metrics import compute_coverage, compute_consistency_ari, compute_score
+from tvplot.models import EpisodeBreakdown, Event
+
+
+def _ep(events_data: list[tuple[str, str | None]]) -> EpisodeBreakdown:
+    """Helper: create episode from (event_text, plotline) pairs."""
+    return EpisodeBreakdown(
+        episode="S01E01",
+        events=[
+            Event(event=text, plotline_id=line, function="setup", characters=["a"])
+            for text, line in events_data
+        ],
+    )
+
+
+class TestCoverage:
+    def test_all_assigned(self):
+        ep = _ep([("e1", "line_a"), ("e2", "line_b")])
+        assert compute_coverage([ep]) == 1.0
+
+    def test_some_null(self):
+        ep = _ep([("e1", "line_a"), ("e2", None), ("e3", "line_b"), ("e4", None)])
+        assert compute_coverage([ep]) == 0.5
+
+    def test_all_null(self):
+        ep = _ep([("e1", None), ("e2", None)])
+        assert compute_coverage([ep]) == 0.0
+
+    def test_empty(self):
+        ep = EpisodeBreakdown(episode="S01E01")
+        assert compute_coverage([ep]) == 1.0
+
+    def test_multiple_episodes(self):
+        ep1 = _ep([("e1", "a"), ("e2", "b")])
+        ep2 = _ep([("e3", None), ("e4", None)])
+        assert compute_coverage([ep1, ep2]) == 0.5
+
+
+class TestConsistencyARI:
+    def test_identical_runs(self):
+        ep = EpisodeBreakdown(
+            episode="S01E01",
+            events=[
+                Event(event="e1", plotline_id="line_a", function="setup", characters=["char1"]),
+                Event(event="e2", plotline_id="line_b", function="setup", characters=["char2"]),
+            ],
+        )
+        # Same data twice = perfect consistency
+        ari = compute_consistency_ari([[ep], [ep]], cast_ids=["char1", "char2"])
+        assert ari == 1.0
+
+    def test_different_names_same_structure(self):
+        """Runs with different plotline names but same grouping = high ARI."""
+        ep_run1 = EpisodeBreakdown(
+            episode="S01E01",
+            events=[
+                Event(event="e1", plotline_id="belonging", function="setup", characters=["char1"]),
+                Event(event="e2", plotline_id="belonging", function="setup", characters=["char2"]),
+                Event(event="e3", plotline_id="leadership", function="setup", characters=["char3"]),
+            ],
+        )
+        ep_run2 = EpisodeBreakdown(
+            episode="S01E01",
+            events=[
+                Event(event="e1", plotline_id="acceptance", function="setup", characters=["char1"]),
+                Event(event="e2", plotline_id="acceptance", function="setup", characters=["char2"]),
+                Event(event="e3", plotline_id="power", function="setup", characters=["char3"]),
+            ],
+        )
+        ari = compute_consistency_ari(
+            [[ep_run1], [ep_run2]],
+            cast_ids=["char1", "char2", "char3"],
+        )
+        assert ari == 1.0
+
+    def test_completely_different(self):
+        """Opposite groupings = low ARI."""
+        ep_run1 = EpisodeBreakdown(
+            episode="S01E01",
+            events=[
+                Event(event="e1", plotline_id="A", function="setup", characters=["c1"]),
+                Event(event="e2", plotline_id="A", function="setup", characters=["c2"]),
+                Event(event="e3", plotline_id="B", function="setup", characters=["c3"]),
+                Event(event="e4", plotline_id="B", function="setup", characters=["c4"]),
+            ],
+        )
+        ep_run2 = EpisodeBreakdown(
+            episode="S01E01",
+            events=[
+                Event(event="e1", plotline_id="X", function="setup", characters=["c1"]),
+                Event(event="e2", plotline_id="Y", function="setup", characters=["c2"]),
+                Event(event="e3", plotline_id="X", function="setup", characters=["c3"]),
+                Event(event="e4", plotline_id="Y", function="setup", characters=["c4"]),
+            ],
+        )
+        ari = compute_consistency_ari(
+            [[ep_run1], [ep_run2]],
+            cast_ids=["c1", "c2", "c3", "c4"],
+        )
+        assert ari < 0.0  # worse than random
+
+    def test_single_run(self):
+        """One run = perfect consistency by definition."""
+        ep = EpisodeBreakdown(episode="S01E01", events=[])
+        assert compute_consistency_ari([[ep]], cast_ids=["c1"]) == 1.0
+
+
+class TestScore:
+    def test_perfect(self):
+        assert compute_score(1.0, 1.0) == 1.0
+
+    def test_zero_coverage(self):
+        assert compute_score(0.0, 1.0) == 0.0
+
+    def test_zero_consistency(self):
+        assert compute_score(1.0, 0.0) == 0.0
+
+    def test_multiplicative(self):
+        assert compute_score(0.8, 0.5) == 0.4
diff --git a/tests/test_models.py b/tests/test_models.py
index affb5c1..6a0bdb0 100644
--- a/tests/test_models.py
+++ b/tests/test_models.py
@@ -2,7 +2,7 @@
 
 import json
 
-from tvplotlines.models import (
+from tvplot.models import (
     CastMember,
     EpisodeBreakdown,
     Event,
diff --git a/tests/test_pass1_prior.py b/tests/test_pass1_prior.py
index 13988a9..403b6a6 100644
--- a/tests/test_pass1_prior.py
+++ b/tests/test_pass1_prior.py
@@ -1,102 +1,102 @@
-"""Tests for prior season data injection in Pass 1."""
-
-import json
-import logging
-
-from tvplotlines.models import CastMember, Plotline, SeriesContext
-from tvplotlines.pass1 import _build_user_message, _check_prior_overlap
-
-
-def _make_context():
-    return SeriesContext(
-        format="serial",
-        story_engine="A teacher builds a drug empire",
-        genre="drama",
-    )
-
-
-def _make_prior_cast():
-    return [
-        CastMember(id="walt", name="Walter White", aliases=["Walt"]),
-        CastMember(id="jesse", name="Jesse Pinkman", aliases=["Jesse"]),
-    ]
-
-
-def _make_prior_plotlines():
-    return [
-        Plotline(
-            id="empire", name="Walt: Empire", hero="walt",
-            goal="build a drug business", obstacle="morality", stakes="death",
-            type="serialized", nature="plot-led", confidence="solid",
-            computed_rank="A",
-            span=["S01E01", "S01E07"],  # should be excluded from prior
-        ),
-    ]
-
-
-class TestBuildUserMessage:
-    def test_without_prior(self):
-        msg = _build_user_message("Breaking Bad", 2, _make_context(), [("S02E01", "ep1"), ("S02E02", "ep2")])
-        data = json.loads(msg)
-        assert "prior_season" not in data
-
-    def test_with_prior(self):
-        msg = _build_user_message(
-            "Breaking Bad", 2, _make_context(), [("S02E01", "ep1"), ("S02E02", "ep2")],
-            prior_cast=_make_prior_cast(),
-            prior_plotlines=_make_prior_plotlines(),
-        )
-        data = json.loads(msg)
-        assert "prior_season" in data
-        prior = data["prior_season"]
-        # Cast present with correct fields
-        assert len(prior["cast"]) == 2
-        assert prior["cast"][0]["id"] == "walt"
-        # Plotlines present with Story DNA, without span
-        assert len(prior["plotlines"]) == 1
-        assert prior["plotlines"][0]["id"] == "empire"
-        assert "span" not in prior["plotlines"][0]
-        assert "confidence" not in prior["plotlines"][0]
-        assert "nature" not in prior["plotlines"][0]
-        assert "devices" not in prior["plotlines"][0]
-
-    def test_empty_prior_lists_no_injection(self):
-        """Empty prior cast/plotlines should not inject prior_season block."""
-        msg = _build_user_message(
-            "Breaking Bad", 2, _make_context(), [("S02E01", "ep1")],
-            prior_cast=[], prior_plotlines=[],
-        )
-        data = json.loads(msg)
-        assert "prior_season" not in data
-
-
-class TestPriorOverlapWarning:
-    def test_warns_on_same_hero_not_continued(self, caplog):
-        prior_plotlines = _make_prior_plotlines()  # empire, hero=walt
-        new_plotlines = [
-            Plotline(
-                id="drug_business", name="Walt: Drug Business", hero="walt",
-                goal="expand meth operation", obstacle="rivals", stakes="death",
-                type="serialized", nature="plot-led", confidence="solid",
-                computed_rank="A",
-            ),
-        ]
-        with caplog.at_level(logging.WARNING):
-            _check_prior_overlap(new_plotlines, prior_plotlines)
-        assert "empire" in caplog.text
-        assert "drug_business" in caplog.text
-
-    def test_no_warning_when_id_reused(self, caplog):
-        prior_plotlines = _make_prior_plotlines()  # empire, hero=walt
-        new_plotlines = [
-            Plotline(
-                id="empire", name="Walt: Empire", hero="walt",
-                goal="expand empire", obstacle="DEA", stakes="prison",
-                type="serialized", nature="plot-led", confidence="solid",
-                computed_rank="A",
-            ),
-        ]
-        with caplog.at_level(logging.WARNING):
-            _check_prior_overlap(new_plotlines, prior_plotlines)
-        warning_records = [r for r in caplog.records if r.levelno >= logging.WARNING]
-        assert warning_records == []
+"""Tests for prior season data injection in Pass 1."""
+
+import json
+import logging
+
+from tvplot.models import CastMember, Plotline, SeriesContext
+from tvplot.pass1 import _build_user_message, _check_prior_overlap
+
+
+def _make_context():
+    return SeriesContext(
+        format="serial",
+        story_engine="A teacher builds a drug empire",
+        genre="drama",
+    )
+
+
+def _make_prior_cast():
+    return [
+        CastMember(id="walt", name="Walter White", aliases=["Walt"]),
+        CastMember(id="jesse", name="Jesse Pinkman", aliases=["Jesse"]),
+    ]
+
+
+def _make_prior_plotlines():
+    return [
+        Plotline(
+            id="empire", name="Walt: Empire", hero="walt",
+            goal="build a drug business", obstacle="morality", stakes="death",
+            type="serialized", nature="plot-led", confidence="solid",
+            computed_rank="A",
+            span=["S01E01", "S01E07"],  # should be excluded from prior
+        ),
+    ]
+
+
+class TestBuildUserMessage:
+    def test_without_prior(self):
+        msg = _build_user_message("Breaking Bad", 2, _make_context(), [("S02E01", "ep1"), ("S02E02", "ep2")])
+        data = json.loads(msg)
+        assert "prior_season" not in data
+
+    def test_with_prior(self):
+        msg = _build_user_message(
+            "Breaking Bad", 2, _make_context(), [("S02E01", "ep1"), ("S02E02", "ep2")],
+            prior_cast=_make_prior_cast(),
+            prior_plotlines=_make_prior_plotlines(),
+        )
+        data = json.loads(msg)
+        assert "prior_season" in data
+        prior = data["prior_season"]
+        # Cast present with correct fields
+        assert len(prior["cast"]) == 2
+        assert prior["cast"][0]["id"] == "walt"
+        # Plotlines present with Story DNA, without span
+        assert len(prior["plotlines"]) == 1
+        assert prior["plotlines"][0]["id"] == "empire"
+        assert "span" not in prior["plotlines"][0]
+        assert "confidence" not in prior["plotlines"][0]
+        assert "nature" not in prior["plotlines"][0]
+        assert "devices" not in prior["plotlines"][0]
+
+    def test_empty_prior_lists_no_injection(self):
+        """Empty prior cast/plotlines should not inject prior_season block."""
+        msg = _build_user_message(
+            "Breaking Bad", 2, _make_context(), [("S02E01", "ep1")],
+            prior_cast=[], prior_plotlines=[],
+        )
+        data = json.loads(msg)
+        assert "prior_season" not in data
+
+
+class TestPriorOverlapWarning:
+    def test_warns_on_same_hero_not_continued(self, caplog):
+        prior_plotlines = _make_prior_plotlines()  # empire, hero=walt
+        new_plotlines = [
+            Plotline(
+                id="drug_business", name="Walt: Drug Business", hero="walt",
+                goal="expand meth operation", obstacle="rivals", stakes="death",
+                type="serialized", nature="plot-led", confidence="solid",
+                computed_rank="A",
+            ),
+        ]
+        with caplog.at_level(logging.WARNING):
+            _check_prior_overlap(new_plotlines, prior_plotlines)
+        assert "empire" in caplog.text
+        assert "drug_business" in caplog.text
+
+    def test_no_warning_when_id_reused(self, caplog):
+        prior_plotlines = _make_prior_plotlines()  # empire, hero=walt
+        new_plotlines = [
+            Plotline(
+                id="empire", name="Walt: Empire", hero="walt",
+                goal="expand empire", obstacle="DEA", stakes="prison",
+                type="serialized", nature="plot-led", confidence="solid",
+                computed_rank="A",
+            ),
+        ]
+        with caplog.at_level(logging.WARNING):
+            _check_prior_overlap(new_plotlines, prior_plotlines)
+        warning_records = [r for r in caplog.records if r.levelno >= logging.WARNING]
+        assert warning_records == []
diff --git a/tests/test_pipeline_prior.py b/tests/test_pipeline_prior.py
index 540ea98..7e47bf3 100644
--- a/tests/test_pipeline_prior.py
+++ b/tests/test_pipeline_prior.py
@@ -1,96 +1,96 @@
-"""Tests for prior season continuity in pipeline."""
-
-import pytest
-
-from tvplotlines.models import (
-    CastMember,
-    Plotline,
-    TVPlotlinesResult,
-    SeriesContext,
-)
-
-
-def _make_prior() -> TVPlotlinesResult:
-    ctx = SeriesContext(
-        format="serial",
-        story_engine="A teacher builds a drug empire",
-        genre="drama",
-    )
-    cast = [
-        CastMember(id="walt", name="Walter White", aliases=["Walt"]),
-        CastMember(id="jesse", name="Jesse Pinkman", aliases=["Jesse"]),
-    ]
-    plotlines = [
-        Plotline(
-            id="empire", name="Walt: Empire", hero="walt",
-            goal="build a drug business", obstacle="morality", stakes="death",
-            type="serialized", nature="plot-led", confidence="solid",
-            computed_rank="A",
-        ),
-    ]
-    return TVPlotlinesResult(context=ctx, cast=cast, plotlines=plotlines)
-
-
-class TestPriorContextReuse:
-    def test_prior_provides_context_when_context_is_none(self, monkeypatch):
-        """If prior is given and context is not, pipeline should use prior.context
-        and NOT call detect_context (Pass 0)."""
-        from unittest.mock import MagicMock
-        import tvplotlines.pipeline as pipeline_mod
-
-        prior = _make_prior()
-        mock_detect = MagicMock(side_effect=AssertionError("Pass 0 should be skipped"))
-        monkeypatch.setattr(pipeline_mod, "detect_context", mock_detect)
-        mock_extract = MagicMock(return_value=(prior.cast, prior.plotlines))
-        monkeypatch.setattr(pipeline_mod, "extract_plotlines", mock_extract)
-
-        try:
-            pipeline_mod.get_plotlines("Breaking Bad", 2, {"S02E01": "synopsis"}, prior=prior)
-        except Exception:
-            pass
-
-        mock_detect.assert_not_called()
-        mock_extract.assert_called_once()
-        call_kwargs = mock_extract.call_args.kwargs
-        assert call_kwargs["prior_cast"] == prior.cast
-        assert call_kwargs["prior_plotlines"] == prior.plotlines
-
-    def test_prior_ignored_when_cast_and_plotlines_provided(self, monkeypatch):
-        """When cast+plotlines are provided (Pass 1 skip), prior only affects context."""
-        from unittest.mock import MagicMock
-        import tvplotlines.pipeline as pipeline_mod
-
-        prior = _make_prior()
-        explicit_cast = [CastMember(id="custom", name="Custom")]
-        explicit_plotlines = [
-            Plotline(
-                id="custom_line", name="Custom", hero="custom",
-                goal="g", obstacle="o", stakes="s",
-                type="serialized", nature="plot-led", confidence="solid",
-                computed_rank="A",
-            ),
-        ]
-        mock_extract = MagicMock()
-        monkeypatch.setattr(pipeline_mod, "extract_plotlines", mock_extract)
-
-        try:
-            pipeline_mod.get_plotlines(
-                "Breaking Bad", 2, {"S02E01": "synopsis"},
-                prior=prior, cast=explicit_cast, plotlines=explicit_plotlines,
-            )
-        except Exception:
-            pass
-
-        mock_extract.assert_not_called()
-
-    def test_anthology_raises_with_prior(self):
-        """Anthology format + prior is contradictory."""
-        from tvplotlines.pipeline import get_plotlines
-
-        prior = _make_prior()
-        prior.context.is_anthology = True
-        with pytest.raises(ValueError, match="anthology"):
-            get_plotlines(
-                "Test Show", 2, {"S02E01": "synopsis"},
-                prior=prior,
-            )
+"""Tests for prior season continuity in pipeline."""
+
+import pytest
+
+from tvplot.models import (
+    CastMember,
+    Plotline,
+    TVPlotlinesResult,
+    SeriesContext,
+)
+
+
+def _make_prior() -> TVPlotlinesResult:
+    ctx = SeriesContext(
+        format="serial",
+        story_engine="A teacher builds a drug empire",
+        genre="drama",
+    )
+    cast = [
+        CastMember(id="walt", name="Walter White", aliases=["Walt"]),
+        CastMember(id="jesse", name="Jesse Pinkman", aliases=["Jesse"]),
+    ]
+    plotlines = [
+        Plotline(
+            id="empire", name="Walt: Empire", hero="walt",
+            goal="build a drug business", obstacle="morality", stakes="death",
+            type="serialized", nature="plot-led", confidence="solid",
+            computed_rank="A",
+        ),
+    ]
+    return TVPlotlinesResult(context=ctx, cast=cast, plotlines=plotlines)
+
+
+class TestPriorContextReuse:
+    def test_prior_provides_context_when_context_is_none(self, monkeypatch):
+        """If prior is given and context is not, pipeline should use prior.context
+        and NOT call detect_context (Pass 0)."""
+        from unittest.mock import MagicMock
+        import tvplot.pipeline as pipeline_mod
+
+        prior = _make_prior()
+        mock_detect = MagicMock(side_effect=AssertionError("Pass 0 should be skipped"))
+        monkeypatch.setattr(pipeline_mod, "detect_context", mock_detect)
+        mock_extract = MagicMock(return_value=(prior.cast, prior.plotlines))
+        monkeypatch.setattr(pipeline_mod, "extract_plotlines", mock_extract)
+
+        try:
+            pipeline_mod.get_plotlines("Breaking Bad", 2, {"S02E01": "synopsis"}, prior=prior)
+        except Exception:
+            pass
+
+        mock_detect.assert_not_called()
+        mock_extract.assert_called_once()
+        call_kwargs = mock_extract.call_args.kwargs
+        assert call_kwargs["prior_cast"] == prior.cast
+        assert call_kwargs["prior_plotlines"] == prior.plotlines
+
+    def test_prior_ignored_when_cast_and_plotlines_provided(self, monkeypatch):
+        """When cast+plotlines are provided (Pass 1 skip), prior only affects context."""
+        from unittest.mock import MagicMock
+        import tvplot.pipeline as pipeline_mod
+
+        prior = _make_prior()
+        explicit_cast = [CastMember(id="custom", name="Custom")]
+        explicit_plotlines = [
+            Plotline(
+                id="custom_line", name="Custom", hero="custom",
+                goal="g", obstacle="o", stakes="s",
+                type="serialized", nature="plot-led", confidence="solid",
+                computed_rank="A",
+            ),
+        ]
+        mock_extract = MagicMock()
+        monkeypatch.setattr(pipeline_mod, "extract_plotlines", mock_extract)
+
+        try:
+            pipeline_mod.get_plotlines(
+                "Breaking Bad", 2, {"S02E01": "synopsis"},
+                prior=prior, cast=explicit_cast, plotlines=explicit_plotlines,
+            )
+        except Exception:
+            pass
+
+        mock_extract.assert_not_called()
+
+    def test_anthology_raises_with_prior(self):
+        """Anthology format + prior is contradictory."""
+        from tvplot.pipeline import get_plotlines
+
+        prior = _make_prior()
+        prior.context.is_anthology = True
+        with pytest.raises(ValueError, match="anthology"):
+            get_plotlines(
+                "Test Show", 2, {"S02E01": "synopsis"},
+                prior=prior,
+            )
diff --git a/tests/test_postprocess.py b/tests/test_postprocess.py
index a870f24..5f49f8a 100644
--- a/tests/test_postprocess.py
+++ b/tests/test_postprocess.py
@@ -1,220 +1,220 @@
-"""Unit tests for post-processing (no LLM calls)."""
-
-from tvplotlines.models import EpisodeBreakdown, Event, Plotline, SeriesContext
-from tvplotlines.postprocess import compute_ranks, compute_span, compute_weight, validate_ranks
-
-
-def _make_plotline(id: str) -> Plotline:
-    return Plotline(
-        id=id, name=id.title(), hero="x",
-        goal="g", obstacle="o", stakes="s",
-        type="serialized", nature="plot-led", confidence="solid",
-        computed_rank="A",
-    )
-
-
-def _make_episode(episode: str, plotline_ids: list[str]) -> EpisodeBreakdown:
-    return EpisodeBreakdown(
-        episode=episode,
-        events=[
-            Event(event=f"event for {sid}", plotline_id=sid,
-                  function="escalation", characters=["x"])
-            for sid in plotline_ids
-        ],
-        theme="test",
-    )
-
-
-class TestComputeSpan:
-    def test_basic(self):
-        lines = [_make_plotline("a"), _make_plotline("b")]
-        episodes = [
-            _make_episode("S01E01", ["a", "b"]),
-            _make_episode("S01E02", ["a"]),
-            _make_episode("S01E03", ["b"]),
-        ]
-        compute_span(lines, episodes)
-        assert lines[0].span == ["S01E01", "S01E02"]
-        assert lines[1].span == ["S01E01", "S01E03"]
-
-    def test_empty(self):
-        lines = [_make_plotline("a")]
-        compute_span(lines, [])
-        assert lines[0].span == []
-
-
-class TestComputeWeight:
-    def test_primary_and_glimpse(self):
-        line_a = _make_plotline("a")
-        line_b = _make_plotline("b")
-        ep = EpisodeBreakdown(
-            episode="S01E01",
-            events=[
-                Event(event="e1", plotline_id="a", function="setup", characters=["x"]),
-                Event(event="e2", plotline_id="a", function="escalation", characters=["x"]),
-                Event(event="e3", plotline_id="a", function="climax", characters=["x"]),
-                Event(event="e4", plotline_id="a", function="resolution", characters=["x"]),
-                Event(event="e5", plotline_id="b", function="setup", characters=["x"]),
-            ],
-            theme="test",
-        )
-        weights = compute_weight([line_a, line_b], ep)
-        assert weights["a"] == "primary"
-        assert weights["b"] == "glimpse"
-
-
-class TestValidateRanks:
-    def test_demotes_a_rank_short_span(self):
-        """A computed_rank line spanning 2/10 episodes should be demoted to B."""
-        short = _make_plotline("short")
-        short.computed_rank = "A"
-        short.span = ["S01E01", "S01E02"]
-
-        long = _make_plotline("long")
-        long.computed_rank = "A"
-        long.span = [f"S01E{i:02d}" for i in range(1, 9)]
-
-        episodes = [
-            _make_episode(f"S01E{i:02d}", ["short", "long"] if i <= 2 else ["long"])
-            for i in range(1, 11)
-        ]
-        compute_span([short, long], episodes)
-        flags = validate_ranks([short, long], episodes)
-
-        assert short.computed_rank == "B"
-        assert long.computed_rank == "A"
-        assert any(f["flag"] == "demoted" for f in flags)
-
-    def test_no_demotion_when_span_sufficient(self):
-        """A computed_rank line spanning 4/10 episodes should keep rank A."""
-        line = _make_plotline("mid")
-        line.computed_rank = "A"
-        line.span = [f"S01E{i:02d}" for i in range(1, 5)]
-
-        episodes = [
-            _make_episode(f"S01E{i:02d}", ["mid"] if i <= 4 else [])
-            for i in range(1, 11)
-        ]
-        flags = validate_ranks([line], episodes)
-
-        assert line.computed_rank == "A"
-        assert not any(f["flag"] == "demoted" for f in flags)
-
-    def test_flags_dominant_line(self):
-        """Line with >50% events should be flagged."""
-        big = _make_plotline("big")
-        small = _make_plotline("small")
-        big.span = [f"S01E{i:02d}" for i in range(1, 11)]
-        small.span = ["S01E01", "S01E02"]
-
-        # 8 events for big, 2 for small → big = 80%
-        events_big = [
-            Event(event=f"e{i}", plotline_id="big", function="escalation", characters=["x"])
-            for i in range(8)
-        ]
-        events_small = [
-            Event(event=f"e{i}", plotline_id="small", function="setup", characters=["x"])
-            for i in range(2)
-        ]
-        episodes = [
-            EpisodeBreakdown(episode="S01E01", events=events_big + events_small, theme="t"),
-        ]
-        flags = validate_ranks([big, small], episodes)
-
-        assert any(f["flag"] == "dominant" and f["plotline"] == "big" for f in flags)
-
-    def test_b_rank_not_demoted(self):
-        """B computed_rank line with short span should not be demoted."""
-        line = _make_plotline("minor")
-        line.computed_rank = "B"
-        line.span = ["S01E01"]
-
-        episodes = [_make_episode(f"S01E{i:02d}", ["minor"] if i == 1 else []) for i in range(1, 11)]
-        flags = validate_ranks([line], episodes)
-
-        assert line.computed_rank == "B"
-        assert not any(f["flag"] == "demoted" for f in flags)
-
-
-def _make_plotline_no_rank(id: str, ptype: str = "serialized") -> Plotline:
-    """Create a plotline without computed_rank (for compute_ranks tests)."""
-    return Plotline(
-        id=id, name=id.title(), hero="x",
-        goal="g", obstacle="o", stakes="s",
-        type=ptype, nature="plot-led", confidence="solid",
-    )
-
-
-class TestComputeRanks:
-    def test_serial_assigns_a_b_c(self):
-        """Most events → A, second → B, rest → C. Span must meet thresholds."""
-        ctx = SeriesContext(format="serial", story_engine="x", genre="drama")
-        lines = [_make_plotline_no_rank("big"), _make_plotline_no_rank("mid"), _make_plotline_no_rank("small")]
-        # 4 episodes so span fractions are: big=4/4=100%, mid=3/4=75%, small=2/4=50%
-        episodes = [
-            _make_episode("S01E01", ["big", "big", "mid", "small"]),
-            _make_episode("S01E02", ["big", "big", "mid", "small"]),
-            _make_episode("S01E03", ["big", "mid"]),
-            _make_episode("S01E04", ["big"]),
-        ]
-        compute_span(lines, episodes)
-        compute_ranks(lines, episodes, ctx)
-        assert lines[0].computed_rank == "A"
-        assert lines[1].computed_rank == "B"
-        assert lines[2].computed_rank == "C"
-
-    def test_runner_gets_no_rank(self):
-        ctx = SeriesContext(format="serial", story_engine="x", genre="drama")
-        runner = _make_plotline_no_rank("bg", ptype="runner")
-        main = _make_plotline_no_rank("main")
-        episodes = [_make_episode("S01E01", ["main", "main"])]
-        compute_span([runner, main], episodes)
-        compute_ranks([runner, main], episodes, ctx)
-        assert runner.computed_rank is None
-        assert main.computed_rank == "A"
-
-    def test_procedural_case_of_week_gets_a(self):
-        ctx = SeriesContext(format="procedural", story_engine="x", genre="drama")
-        cotw = _make_plotline_no_rank("case", ptype="case_of_the_week")
-        arc = _make_plotline_no_rank("arc")
-        # arc has more events, but cotw is fixed at A for procedural
-        episodes = [_make_episode("S01E01", ["arc", "arc", "arc", "case"])]
-        compute_span([cotw, arc], episodes)
-        compute_ranks([cotw, arc], episodes, ctx)
-        assert cotw.computed_rank == "A"
-        assert arc.computed_rank == "B"
-
-    def test_hybrid_case_of_week_gets_b(self):
-        ctx = SeriesContext(format="hybrid", story_engine="x", genre="drama")
-        cotw = _make_plotline_no_rank("case", ptype="case_of_the_week")
-        arc = _make_plotline_no_rank("arc")
-        episodes = [_make_episode("S01E01", ["arc", "case", "case"])]
-        compute_span([cotw, arc], episodes)
-        compute_ranks([cotw, arc], episodes, ctx)
-        assert cotw.computed_rank == "B"
-        assert arc.computed_rank == "A"
-
-    def test_also_affects_counted_equally(self):
-        """Both primary and also_affects count equally toward rank."""
-        ctx = SeriesContext(format="serial", story_engine="x", genre="drama")
-        main = _make_plotline_no_rank("main")
-        side = _make_plotline_no_rank("side")
-        ep = EpisodeBreakdown(
-            episode="S01E01",
-            events=[
-                Event(event="e1", plotline_id="main", function="setup",
-                      characters=["x"], also_affects=["side"]),
-                Event(event="e2", plotline_id="main", function="escalation",
-                      characters=["x"], also_affects=["side"]),
-                Event(event="e3", plotline_id="side", function="setup",
-                      characters=["x"]),
-            ],
-            theme="t",
-        )
-        compute_span([main, side], [ep])
-        compute_ranks([main, side], [ep], ctx)
-        # main: 2 primary + 0 AA = 2. side: 1 primary + 2 AA = 3. side wins.
-        assert side.computed_rank == "A"
-        assert main.computed_rank == "B"
-
-
+"""Unit tests for post-processing (no LLM calls)."""
+
+from tvplot.models import EpisodeBreakdown, Event, Plotline, SeriesContext
+from tvplot.postprocess import compute_ranks, compute_span, compute_weight, validate_ranks
+
+
+def _make_plotline(id: str) -> Plotline:
+    return Plotline(
+        id=id, name=id.title(), hero="x",
+        goal="g", obstacle="o", stakes="s",
+        type="serialized", nature="plot-led", confidence="solid",
+        computed_rank="A",
+    )
+
+
+def _make_episode(episode: str, plotline_ids: list[str]) -> EpisodeBreakdown:
+    return EpisodeBreakdown(
+        episode=episode,
+        events=[
+            Event(event=f"event for {sid}", plotline_id=sid,
+                  function="escalation", characters=["x"])
+            for sid in plotline_ids
+        ],
+        theme="test",
+    )
+
+
+class TestComputeSpan:
+    def test_basic(self):
+        lines = [_make_plotline("a"), _make_plotline("b")]
+        episodes = [
+            _make_episode("S01E01", ["a", "b"]),
+            _make_episode("S01E02", ["a"]),
+            _make_episode("S01E03", ["b"]),
+        ]
+        compute_span(lines, episodes)
+        assert lines[0].span == ["S01E01", "S01E02"]
+        assert lines[1].span == ["S01E01", "S01E03"]
+
+    def test_empty(self):
+        lines = [_make_plotline("a")]
+        compute_span(lines, [])
+        assert lines[0].span == []
+
+
+class TestComputeWeight:
+    def test_primary_and_glimpse(self):
+        line_a = _make_plotline("a")
+        line_b = _make_plotline("b")
+        ep = EpisodeBreakdown(
+            episode="S01E01",
+            events=[
+                Event(event="e1", plotline_id="a", function="setup", characters=["x"]),
+                Event(event="e2", plotline_id="a", function="escalation", characters=["x"]),
+                Event(event="e3", plotline_id="a", function="climax", characters=["x"]),
+                Event(event="e4", plotline_id="a", function="resolution", characters=["x"]),
+                Event(event="e5", plotline_id="b", function="setup", characters=["x"]),
+            ],
+            theme="test",
+        )
+        weights = compute_weight([line_a, line_b], ep)
+        assert weights["a"] == "primary"
+        assert weights["b"] == "glimpse"
+
+
+class TestValidateRanks:
+    def test_demotes_a_rank_short_span(self):
+        """A computed_rank line spanning 2/10 episodes should be demoted to B."""
+        short = _make_plotline("short")
+        short.computed_rank = "A"
+        short.span = ["S01E01", "S01E02"]
+
+        long = _make_plotline("long")
+        long.computed_rank = "A"
+        long.span = [f"S01E{i:02d}" for i in range(1, 9)]
+
+        episodes = [
+            _make_episode(f"S01E{i:02d}", ["short", "long"] if i <= 2 else ["long"])
+            for i in range(1, 11)
+        ]
+        compute_span([short, long], episodes)
+        flags = validate_ranks([short, long], episodes)
+
+        assert short.computed_rank == "B"
+        assert long.computed_rank == "A"
+        assert any(f["flag"] == "demoted" for f in flags)
+
+    def test_no_demotion_when_span_sufficient(self):
+        """A computed_rank line spanning 4/10 episodes should keep rank A."""
+        line = _make_plotline("mid")
+        line.computed_rank = "A"
+        line.span = [f"S01E{i:02d}" for i in range(1, 5)]
+
+        episodes = [
+            _make_episode(f"S01E{i:02d}", ["mid"] if i <= 4 else [])
+            for i in range(1, 11)
+        ]
+        flags = validate_ranks([line], episodes)
+
+        assert line.computed_rank == "A"
+        assert not any(f["flag"] == "demoted" for f in flags)
+
+    def test_flags_dominant_line(self):
+        """Line with >50% events should be flagged."""
+        big = _make_plotline("big")
+        small = _make_plotline("small")
+        big.span = [f"S01E{i:02d}" for i in range(1, 11)]
+        small.span = ["S01E01", "S01E02"]
+
+        # 8 events for big, 2 for small → big = 80%
+        events_big = [
+            Event(event=f"e{i}", plotline_id="big", function="escalation", characters=["x"])
+            for i in range(8)
+        ]
+        events_small = [
+            Event(event=f"e{i}", plotline_id="small", function="setup", characters=["x"])
+            for i in range(2)
+        ]
+        episodes = [
+            EpisodeBreakdown(episode="S01E01", events=events_big + events_small, theme="t"),
+        ]
+        flags = validate_ranks([big, small], episodes)
+
+        assert any(f["flag"] == "dominant" and f["plotline"] == "big" for f in flags)
+
+    def test_b_rank_not_demoted(self):
+        """B computed_rank line with short span should not be demoted."""
+        line = _make_plotline("minor")
+        line.computed_rank = "B"
+        line.span = ["S01E01"]
+
+        episodes = [_make_episode(f"S01E{i:02d}", ["minor"] if i == 1 else []) for i in range(1, 11)]
+        flags = validate_ranks([line], episodes)
+
+        assert line.computed_rank == "B"
+        assert not any(f["flag"] == "demoted" for f in flags)
+
+
+def _make_plotline_no_rank(id: str, ptype: str = "serialized") -> Plotline:
+    """Create a plotline without computed_rank (for compute_ranks tests)."""
+    return Plotline(
+        id=id, name=id.title(), hero="x",
+        goal="g", obstacle="o", stakes="s",
+        type=ptype, nature="plot-led", confidence="solid",
+    )
+
+
+class TestComputeRanks:
+    def test_serial_assigns_a_b_c(self):
+        """Most events → A, second → B, rest → C. Span must meet thresholds."""
+        ctx = SeriesContext(format="serial", story_engine="x", genre="drama")
+        lines = [_make_plotline_no_rank("big"), _make_plotline_no_rank("mid"), _make_plotline_no_rank("small")]
+        # 4 episodes so span fractions are: big=4/4=100%, mid=3/4=75%, small=2/4=50%
+        episodes = [
+            _make_episode("S01E01", ["big", "big", "mid", "small"]),
+            _make_episode("S01E02", ["big", "big", "mid", "small"]),
+            _make_episode("S01E03", ["big", "mid"]),
+            _make_episode("S01E04", ["big"]),
+        ]
+        compute_span(lines, episodes)
+        compute_ranks(lines, episodes, ctx)
+        assert lines[0].computed_rank == "A"
+        assert lines[1].computed_rank == "B"
+        assert lines[2].computed_rank == "C"
+
+    def test_runner_gets_no_rank(self):
+        ctx = SeriesContext(format="serial", story_engine="x", genre="drama")
+        runner = _make_plotline_no_rank("bg", ptype="runner")
+        main = _make_plotline_no_rank("main")
+        episodes = [_make_episode("S01E01", ["main", "main"])]
+        compute_span([runner, main], episodes)
+        compute_ranks([runner, main], episodes, ctx)
+        assert runner.computed_rank is None
+        assert main.computed_rank == "A"
+
+    def test_procedural_case_of_week_gets_a(self):
+        ctx = SeriesContext(format="procedural", story_engine="x", genre="drama")
+        cotw = _make_plotline_no_rank("case", ptype="case_of_the_week")
+        arc = _make_plotline_no_rank("arc")
+        # arc has more events, but cotw is fixed at A for procedural
+        episodes = [_make_episode("S01E01", ["arc", "arc", "arc", "case"])]
+        compute_span([cotw, arc], episodes)
+        compute_ranks([cotw, arc], episodes, ctx)
+        assert cotw.computed_rank == "A"
+        assert arc.computed_rank == "B"
+
+    def test_hybrid_case_of_week_gets_b(self):
+        ctx = SeriesContext(format="hybrid", story_engine="x", genre="drama")
+        cotw = _make_plotline_no_rank("case", ptype="case_of_the_week")
+        arc = _make_plotline_no_rank("arc")
+        episodes = [_make_episode("S01E01", ["arc", "case", "case"])]
+        compute_span([cotw, arc], episodes)
+        compute_ranks([cotw, arc], episodes, ctx)
+        assert cotw.computed_rank == "B"
+        assert arc.computed_rank == "A"
+
+    def test_also_affects_counted_equally(self):
+        """Both primary and also_affects count equally toward rank."""
+        ctx = SeriesContext(format="serial", story_engine="x", genre="drama")
+        main = _make_plotline_no_rank("main")
+        side = _make_plotline_no_rank("side")
+        ep = EpisodeBreakdown(
+            episode="S01E01",
+            events=[
+                Event(event="e1", plotline_id="main", function="setup",
+                      characters=["x"], also_affects=["side"]),
+                Event(event="e2", plotline_id="main", function="escalation",
+                      characters=["x"], also_affects=["side"]),
+                Event(event="e3", plotline_id="side", function="setup",
+                      characters=["x"]),
+            ],
+            theme="t",
+        )
+        compute_span([main, side], [ep])
+        compute_ranks([main, side], [ep], ctx)
+        # main: 2 primary + 0 AA = 2. side: 1 primary + 2 AA = 3. side wins.
+        assert side.computed_rank == "A"
+        assert main.computed_rank == "B"
+
+
diff --git a/tests/test_resilience.py b/tests/test_resilience.py
index 914a1b1..d2a03e6 100644
--- a/tests/test_resilience.py
+++ b/tests/test_resilience.py
@@ -1,286 +1,286 @@
-"""Tests for pipeline resilience: retry, partial success, callbacks, resume, batch."""
-
-from __future__ import annotations
-
-import asyncio
-from unittest.mock import AsyncMock, MagicMock, patch
-
-import pytest
-
-from tvplotlines.callbacks import PipelineCallback
-from tvplotlines.llm import (
-    LLMConfig,
-    _araw_call_with_retry,
-    _MAX_NETWORK_RETRIES,
-    _BACKOFF_BASE,
-    acall_llm,
-    acall_llm_parallel,
-)
-
-
-# ---------------------------------------------------------------------------
-# Fixtures
-# ---------------------------------------------------------------------------
-
-@pytest.fixture
-def config():
-    return LLMConfig(provider="anthropic", model="test-model")
-
-
-# ---------------------------------------------------------------------------
-# Step 1a: Network retry with backoff
-# ---------------------------------------------------------------------------
-
-class TestNetworkRetry:
-    """_araw_call_with_retry retries transient errors with backoff."""
-
-    @pytest.mark.asyncio
-    async def test_retries_on_transient_error(self, config):
-        """Transient error retried up to _MAX_NETWORK_RETRIES times."""
-        import anthropic
-
-        call_count = 0
-
-        async def flaky_raw_call(*args, **kwargs):
-            nonlocal call_count
-            call_count += 1
-            if call_count < 3:
-                raise anthropic.APIConnectionError(request=MagicMock())
-            return '{"result": "ok"}'
-
-        with patch("tvplotlines.llm._araw_call", side_effect=flaky_raw_call), \
-             patch("tvplotlines.llm.asyncio.sleep", new_callable=AsyncMock):
-            result = await _araw_call_with_retry("sys", [{}], config, False)
-
-        assert result == '{"result": "ok"}'
-        assert call_count == 3
-
-    @pytest.mark.asyncio
-    async def test_raises_after_max_retries(self, config):
-        """After _MAX_NETWORK_RETRIES+1 attempts, the error propagates."""
-        import anthropic
-
-        async def always_fail(*args, **kwargs):
-            raise anthropic.APIConnectionError(request=MagicMock())
-
-        with patch("tvplotlines.llm._araw_call", side_effect=always_fail), \
-             patch("tvplotlines.llm.asyncio.sleep", new_callable=AsyncMock):
-            with pytest.raises(anthropic.APIConnectionError):
-                await _araw_call_with_retry("sys", [{}], config, False)
-
-    @pytest.mark.asyncio
-    async def test_backoff_delays(self, config):
-        """Each retry waits _BACKOFF_BASE^(attempt+1) seconds."""
-        import anthropic
-
-        sleep_mock = AsyncMock()
-
-        async def fail_twice(*args, **kwargs):
-            if fail_twice.count < 2:
-                fail_twice.count += 1
-                raise anthropic.APIConnectionError(request=MagicMock())
-            return '{"ok": true}'
-        fail_twice.count = 0
-
-        with patch("tvplotlines.llm._araw_call", side_effect=fail_twice), \
-             patch("tvplotlines.llm.asyncio.sleep", sleep_mock):
-            await _araw_call_with_retry("sys", [{}], config, False)
-
-        # Two retries: delays should be 2^1=2 and 2^2=4
-        assert sleep_mock.call_count == 2
-        assert sleep_mock.call_args_list[0].args[0] == _BACKOFF_BASE ** 1
-        assert sleep_mock.call_args_list[1].args[0] == _BACKOFF_BASE ** 2
-
-
-# ---------------------------------------------------------------------------
-# Step 1c: Partial success in parallel
-# ---------------------------------------------------------------------------
-
-class TestPartialParallel:
-    """acall_llm_parallel retries failed tasks individually."""
-
-    @pytest.mark.asyncio
-    async def test_preserves_successful_retries_failed(self, config):
-        """If one parallel call fails, others are preserved and failure is retried."""
-        call_log = []
-
-        async def mock_acall_llm(system, msg, cfg, *, cache_system=False, validator=None):
-            call_log.append(msg)
-            if msg == "fail_first" and len([c for c in call_log if c == "fail_first"]) == 1:
-                raise ValueError("transient")
-            return {"msg": msg}
-
-        with patch("tvplotlines.llm.acall_llm", side_effect=mock_acall_llm):
-            results = await acall_llm_parallel(
-                "sys", ["ok1", "fail_first", "ok2"], config,
-            )
-
-        assert results[0] == {"msg": "ok1"}
-        assert results[1] == {"msg": "fail_first"}  # retried and succeeded
-        assert results[2] == {"msg": "ok2"}
-
-
-# ---------------------------------------------------------------------------
-# Step 2: Callbacks
-# ---------------------------------------------------------------------------
-
-class TestCallbacks:
-    """PipelineCallback methods are no-ops by default and can be overridden."""
-
-    def test_default_methods_are_noop(self):
-        cb = PipelineCallback()
-        # Should not raise
-        cb.on_pass0_complete(MagicMock())
-        cb.on_pass1_complete([], [])
-        cb.on_episode_complete(0, MagicMock())
-        cb.on_pass2_complete([])
-        cb.on_batch_submitted("batch-123")
-        cb.on_pass3_complete([])
-
-    def test_subclass_receives_events(self):
-        events = []
-
-        class Recorder(PipelineCallback):
-            def on_pass0_complete(self, context):
-                events.append(("pass0", context))
-            def on_pass1_complete(self, cast, plotlines):
-                events.append(("pass1", len(cast), len(plotlines)))
-
-        cb = Recorder()
-        cb.on_pass0_complete("ctx")
-        cb.on_pass1_complete([1, 2], [3])
-
-        assert events == [("pass0", "ctx"), ("pass1", 2, 1)]
-
-
-# ---------------------------------------------------------------------------
-# Step 3: Resume validation
-# ---------------------------------------------------------------------------
-
-class TestResumeValidation:
-    """get_plotlines validates resume inputs before running."""
-
-    def test_cast_without_plotlines_raises(self):
-        from tvplotlines.pipeline import get_plotlines
-        from tvplotlines.models import CastMember
-
-        with pytest.raises(ValueError, match="cast and plotlines must be provided together"):
-            get_plotlines(
-                "Test", 1, {"S01E01": "ep1"},
-                cast=[CastMember(id="a", name="A")],
-                plotlines=None,
-            )
-
-    def test_plotlines_without_cast_raises(self):
-        from tvplotlines.pipeline import get_plotlines
-        from tvplotlines.models import Plotline
-
-        with pytest.raises(ValueError, match="cast and plotlines must be provided together"):
-            get_plotlines(
-                "Test", 1, {"S01E01": "ep1"},
-                cast=None,
-                plotlines=[Plotline(
-                    id="s1", name="S1", hero="a", goal="g",
-                    obstacle="o", stakes="s", type="serialized",
-                    nature="plot-led", confidence="solid",
-                    computed_rank="A",
-                )],
-            )
-
-    def test_breakdowns_length_mismatch_raises(self):
-        from tvplotlines.pipeline import get_plotlines
-        from tvplotlines.models import EpisodeBreakdown
-
-        with pytest.raises(ValueError, match="breakdowns length"):
-            get_plotlines(
-                "Test", 1, {"S01E01": "ep1", "S01E02": "ep2"},
-                breakdowns=[EpisodeBreakdown(episode="S01E01")],
-            )
-
-
-# ---------------------------------------------------------------------------
-# Step 4c: Batch timeout
-# ---------------------------------------------------------------------------
-
-class TestBatchTimeout:
-    """Batch polling raises TimeoutError after _BATCH_TIMEOUT."""
-
-    @pytest.mark.asyncio
-    async def test_batch_polling_timeout(self, config):
-        import tvplotlines.llm as llm_module
-
-        # Temporarily set a very short timeout for testing
-        original = llm_module._BATCH_TIMEOUT
-        llm_module._BATCH_TIMEOUT = 0.01  # 10ms
-
-        try:
-            # Mock the anthropic client
-            mock_batch = MagicMock()
-            mock_batch.processing_status = "processing"  # never ends
-            mock_batch.request_counts.succeeded = 0
-            mock_batch.request_counts.processing = 1
-
-            mock_client = AsyncMock()
-            mock_client.messages.batches.retrieve.return_value = mock_batch
-
-            with patch("anthropic.AsyncAnthropic", return_value=mock_client), \
-                 patch("tvplotlines.llm.asyncio.sleep", new_callable=AsyncMock):
-                from tvplotlines.llm import acall_llm_batch
-
-                with pytest.raises(TimeoutError, match="did not complete"):
-                    await acall_llm_batch(
-                        "sys", ["msg"], config,
-                        batch_id="existing-batch-123",
-                    )
-        finally:
-            llm_module._BATCH_TIMEOUT = original
-
-
-# ---------------------------------------------------------------------------
-# Step 4a: Batch ID callback
-# ---------------------------------------------------------------------------
-
-class TestBatchCallback:
-    """on_batch_submitted fires with batch ID after creation."""
-
-    @pytest.mark.asyncio
-    async def test_callback_receives_batch_id(self, config):
-        submitted_ids = []
-
-        # Mock the full batch lifecycle
-        mock_batch_created = MagicMock()
-        mock_batch_created.id = "batch_abc123"
-
-        mock_batch_ended = MagicMock()
-        mock_batch_ended.processing_status = "ended"
-
-        mock_result = MagicMock()
-        mock_result.custom_id = "req_0000"
-        mock_result.result.type = "succeeded"
-        mock_result.result.message.content = [MagicMock(text='{"ok": true}')]
-
-        # results() is awaited, then the result is async-iterated
-        class AsyncResultStream:
-            def __init__(self, items):
-                self._items = items
-            def __aiter__(self):
-                return self
-            async def __anext__(self):
-                if not self._items:
-                    raise StopAsyncIteration
-                return self._items.pop(0)
-
-        mock_client = AsyncMock()
-        mock_client.messages.batches.create.return_value = mock_batch_created
-        mock_client.messages.batches.retrieve.return_value = mock_batch_ended
-        mock_client.messages.batches.results.return_value = AsyncResultStream([mock_result])
-
-        with patch("anthropic.AsyncAnthropic", return_value=mock_client):
-            from tvplotlines.llm import acall_llm_batch
-
-            await acall_llm_batch(
-                "sys", ["msg"], config,
-                on_batch_submitted=lambda bid: submitted_ids.append(bid),
-            )
-
-        assert submitted_ids == ["batch_abc123"]
+"""Tests for pipeline resilience: retry, partial success, callbacks, resume, batch."""
+
+from __future__ import annotations
+
+import asyncio
+from unittest.mock import AsyncMock, MagicMock, patch
+
+import pytest
+
+from tvplot.callbacks import PipelineCallback
+from tvplot.llm import (
+    LLMConfig,
+    _araw_call_with_retry,
+    _MAX_NETWORK_RETRIES,
+    _BACKOFF_BASE,
+    acall_llm,
+    acall_llm_parallel,
+)
+
+
+# ---------------------------------------------------------------------------
+# Fixtures
+# ---------------------------------------------------------------------------
+
+@pytest.fixture
+def config():
+    return LLMConfig(provider="anthropic", model="test-model")
+
+
+# ---------------------------------------------------------------------------
+# Step 1a: Network retry with backoff
+# ---------------------------------------------------------------------------
+
+class TestNetworkRetry:
+    """_araw_call_with_retry retries transient errors with backoff."""
+
+    @pytest.mark.asyncio
+    async def test_retries_on_transient_error(self, config):
+        """Transient error retried up to _MAX_NETWORK_RETRIES times."""
+        import anthropic
+
+        call_count = 0
+
+        async def flaky_raw_call(*args, **kwargs):
+            nonlocal call_count
+            call_count += 1
+            if call_count < 3:
+                raise anthropic.APIConnectionError(request=MagicMock())
+            return '{"result": "ok"}'
+
+        with patch("tvplot.llm._araw_call", side_effect=flaky_raw_call), \
+             patch("tvplot.llm.asyncio.sleep", new_callable=AsyncMock):
+            result = await _araw_call_with_retry("sys", [{}], config, False)
+
+        assert result == '{"result": "ok"}'
+        assert call_count == 3
+
+    @pytest.mark.asyncio
+    async def test_raises_after_max_retries(self, config):
+        """After _MAX_NETWORK_RETRIES+1 attempts, the error propagates."""
+        import anthropic
+
+        async def always_fail(*args, **kwargs):
+            raise anthropic.APIConnectionError(request=MagicMock())
+
+        with patch("tvplot.llm._araw_call", side_effect=always_fail), \
+             patch("tvplot.llm.asyncio.sleep", new_callable=AsyncMock):
+            with pytest.raises(anthropic.APIConnectionError):
+                await _araw_call_with_retry("sys", [{}], config, False)
+
+    @pytest.mark.asyncio
+    async def test_backoff_delays(self, config):
+        """Each retry waits _BACKOFF_BASE^(attempt+1) seconds."""
+        import anthropic
+
+        sleep_mock = AsyncMock()
+
+        async def fail_twice(*args, **kwargs):
+            if fail_twice.count < 2:
+                fail_twice.count += 1
+                raise anthropic.APIConnectionError(request=MagicMock())
+            return '{"ok": true}'
+        fail_twice.count = 0
+
+        with patch("tvplot.llm._araw_call", side_effect=fail_twice), \
+             patch("tvplot.llm.asyncio.sleep", sleep_mock):
+            await _araw_call_with_retry("sys", [{}], config, False)
+
+        # Two retries: delays should be 2^1=2 and 2^2=4
+        assert sleep_mock.call_count == 2
+        assert sleep_mock.call_args_list[0].args[0] == _BACKOFF_BASE ** 1
+        assert sleep_mock.call_args_list[1].args[0] == _BACKOFF_BASE ** 2
+
+
+# ---------------------------------------------------------------------------
+# Step 1c: Partial success in parallel
+# ---------------------------------------------------------------------------
+
+class TestPartialParallel:
+    """acall_llm_parallel retries failed tasks individually."""
+
+    @pytest.mark.asyncio
+    async def test_preserves_successful_retries_failed(self, config):
+        """If one parallel call fails, others are preserved and failure is retried."""
+        call_log = []
+
+        async def mock_acall_llm(system, msg, cfg, *, cache_system=False, validator=None):
+            call_log.append(msg)
+            if msg == "fail_first" and len([c for c in call_log if c == "fail_first"]) == 1:
+                raise ValueError("transient")
+            return {"msg": msg}
+
+        with patch("tvplot.llm.acall_llm", side_effect=mock_acall_llm):
+            results = await acall_llm_parallel(
+                "sys", ["ok1", "fail_first", "ok2"], config,
+            )
+
+        assert results[0] == {"msg": "ok1"}
+        assert results[1] == {"msg": "fail_first"}  # retried and succeeded
+        assert results[2] == {"msg": "ok2"}
+
+
+# ---------------------------------------------------------------------------
+# Step 2: Callbacks
+# ---------------------------------------------------------------------------
+
+class TestCallbacks:
+    """PipelineCallback methods are no-ops by default and can be overridden."""
+
+    def test_default_methods_are_noop(self):
+        cb = PipelineCallback()
+        # Should not raise
+        cb.on_pass0_complete(MagicMock())
+        cb.on_pass1_complete([], [])
+        cb.on_episode_complete(0, MagicMock())
+        cb.on_pass2_complete([])
+        cb.on_batch_submitted("batch-123")
+        cb.on_pass3_complete([])
+
+    def test_subclass_receives_events(self):
+        events = []
+
+        class Recorder(PipelineCallback):
+            def on_pass0_complete(self, context):
+                events.append(("pass0", context))
+            def on_pass1_complete(self, cast, plotlines):
+                events.append(("pass1", len(cast), len(plotlines)))
+
+        cb = Recorder()
+        cb.on_pass0_complete("ctx")
+        cb.on_pass1_complete([1, 2], [3])
+
+        assert events == [("pass0", "ctx"), ("pass1", 2, 1)]
+
+
+# ---------------------------------------------------------------------------
+# Step 3: Resume validation
+# ---------------------------------------------------------------------------
+
+class TestResumeValidation:
+    """get_plotlines validates resume inputs before running."""
+
+    def test_cast_without_plotlines_raises(self):
+        from tvplot.pipeline import get_plotlines
+        from tvplot.models import CastMember
+
+        with pytest.raises(ValueError, match="cast and plotlines must be provided together"):
+            get_plotlines(
+                "Test", 1, {"S01E01": "ep1"},
+                cast=[CastMember(id="a", name="A")],
+                plotlines=None,
+            )
+
+    def test_plotlines_without_cast_raises(self):
+        from tvplot.pipeline import get_plotlines
+        from tvplot.models import Plotline
+
+        with pytest.raises(ValueError, match="cast and plotlines must be provided together"):
+            get_plotlines(
+                "Test", 1, {"S01E01": "ep1"},
+                cast=None,
+                plotlines=[Plotline(
+                    id="s1", name="S1", hero="a", goal="g",
+                    obstacle="o", stakes="s", type="serialized",
+                    nature="plot-led", confidence="solid",
+                    computed_rank="A",
+                )],
+            )
+
+    def test_breakdowns_length_mismatch_raises(self):
+        from tvplot.pipeline import get_plotlines
+        from tvplot.models import EpisodeBreakdown
+
+        with pytest.raises(ValueError, match="breakdowns length"):
+            get_plotlines(
+                "Test", 1, {"S01E01": "ep1", "S01E02": "ep2"},
+                breakdowns=[EpisodeBreakdown(episode="S01E01")],
+            )
+
+
+# ---------------------------------------------------------------------------
+# Step 4c: Batch timeout
+# ---------------------------------------------------------------------------
+
+class TestBatchTimeout:
+    """Batch polling raises TimeoutError after _BATCH_TIMEOUT."""
+
+    @pytest.mark.asyncio
+    async def test_batch_polling_timeout(self, config):
+        import tvplot.llm as llm_module
+
+        # Temporarily set a very short timeout for testing
+        original = llm_module._BATCH_TIMEOUT
+        llm_module._BATCH_TIMEOUT = 0.01  # 10ms
+
+        try:
+            # Mock the anthropic client
+            mock_batch = MagicMock()
+            mock_batch.processing_status = "processing"  # never ends
+            mock_batch.request_counts.succeeded = 0
+            mock_batch.request_counts.processing = 1
+
+            mock_client = AsyncMock()
+            mock_client.messages.batches.retrieve.return_value = mock_batch
+
+            with patch("anthropic.AsyncAnthropic", return_value=mock_client), \
+                 patch("tvplot.llm.asyncio.sleep", new_callable=AsyncMock):
+                from tvplot.llm import acall_llm_batch
+
+                with pytest.raises(TimeoutError, match="did not complete"):
+                    await acall_llm_batch(
+                        "sys", ["msg"], config,
+                        batch_id="existing-batch-123",
+                    )
+        finally:
+            llm_module._BATCH_TIMEOUT = original
+
+
+# ---------------------------------------------------------------------------
+# Step 4a: Batch ID callback
+# ---------------------------------------------------------------------------
+
+class TestBatchCallback:
+    """on_batch_submitted fires with batch ID after creation."""
+
+    @pytest.mark.asyncio
+    async def test_callback_receives_batch_id(self, config):
+        submitted_ids = []
+
+        # Mock the full batch lifecycle
+        mock_batch_created = MagicMock()
+        mock_batch_created.id = "batch_abc123"
+
+        mock_batch_ended = MagicMock()
+        mock_batch_ended.processing_status = "ended"
+
+        mock_result = MagicMock()
+        mock_result.custom_id = "req_0000"
+        mock_result.result.type = "succeeded"
+        mock_result.result.message.content = [MagicMock(text='{"ok": true}')]
+
+        # results() is awaited, then the result is async-iterated
+        class AsyncResultStream:
+            def __init__(self, items):
+                self._items = items
+            def __aiter__(self):
+                return self
+            async def __anext__(self):
+                if not self._items:
+                    raise StopAsyncIteration
+                return self._items.pop(0)
+
+        mock_client = AsyncMock()
+        mock_client.messages.batches.create.return_value = mock_batch_created
+        mock_client.messages.batches.retrieve.return_value = mock_batch_ended
+        mock_client.messages.batches.results.return_value = AsyncResultStream([mock_result])
+
+        with patch("anthropic.AsyncAnthropic", return_value=mock_client):
+            from tvplot.llm import acall_llm_batch
+
+            await acall_llm_batch(
+                "sys", ["msg"], config,
+                on_batch_submitted=lambda bid: submitted_ids.append(bid),
+            )
+
+        assert submitted_ids == ["batch_abc123"]
diff --git a/tests/test_synopses_writer.py b/tests/test_synopses_writer.py
index 4e58bf1..c3eb588 100644
--- a/tests/test_synopses_writer.py
+++ b/tests/test_synopses_writer.py
@@ -6,7 +6,7 @@
 
 import pytest
 
-from tvplotlines.synopses_writer import (
+from tvplot.synopses_writer import (
     fetch_season_page,
     parse_episode_table,
     rewrite_synopses,
@@ -87,7 +87,7 @@ def _make_error_response() -> MagicMock:
 
 
 class TestFetchSeasonPage:
-    @patch("tvplotlines.synopses_writer.httpx.get")
+    @patch("tvplot.synopses_writer.httpx.get")
     def test_title_construction(self, mock_get):
         """Verify URL params for standard show names."""
         mock_get.return_value = _make_success_response("<html>content</html>")
@@ -99,7 +99,7 @@ def test_title_construction(self, mock_get):
         params = call_args.kwargs.get("params") or call_args[1].get("params")
         assert params["page"] == "House_(season_1)"
 
-    @patch("tvplotlines.synopses_writer.httpx.get")
+    @patch("tvplot.synopses_writer.httpx.get")
     def test_title_construction_multi_word(self, mock_get):
         """Spaces in show name become underscores."""
         mock_get.return_value = _make_success_response()
@@ -110,7 +110,7 @@ def test_title_construction_multi_word(self, mock_get):
         params = call_args.kwargs.get("params") or call_args[1].get("params")
         assert params["page"] == "Breaking_Bad_(season_2)"
 
-    @patch("tvplotlines.synopses_writer.httpx.get")
+    @patch("tvplot.synopses_writer.httpx.get")
     def test_wiki_title_override(self, mock_get):
         """Explicit wiki_title skips automatic construction."""
         mock_get.return_value = _make_success_response()
@@ -121,10 +121,10 @@ def test_wiki_title_override(self, mock_get):
         params = call_args.kwargs.get("params") or call_args[1].get("params")
         assert params["page"] == "House_season_1"
 
-    @patch("tvplotlines.synopses_writer._search_wikipedia",
+    @patch("tvplot.synopses_writer._search_wikipedia",
            return_value=["House_(season_1)", "House_season_1"])
-    @patch("tvplotlines.synopses_writer.httpx.get")
-    @patch("tvplotlines.synopses_writer.time.sleep")
+    @patch("tvplot.synopses_writer.httpx.get")
+    @patch("tvplot.synopses_writer.time.sleep")
     def test_fallback_on_missing_page(self, _mock_sleep, mock_get, _mock_search):
         """First title 404 → tries second naming convention."""
         mock_get.side_effect = [
@@ -141,10 +141,10 @@ def test_fallback_on_missing_page(self, _mock_sleep, mock_get, _mock_search):
             mock_get.call_args_list[1][1].get("params")
         assert second_call_params["page"] == "House_season_1"
 
-    @patch("tvplotlines.synopses_writer._search_wikipedia",
+    @patch("tvplot.synopses_writer._search_wikipedia",
            return_value=["House_(season_1)", "House_season_1"])
-    @patch("tvplotlines.synopses_writer.httpx.get")
-    @patch("tvplotlines.synopses_writer.time.sleep")
+    @patch("tvplot.synopses_writer.httpx.get")
+    @patch("tvplot.synopses_writer.time.sleep")
     def test_all_titles_missing_raises(self, _mock_sleep, mock_get, _mock_search):
         """Both naming conventions fail → raise with helpful message."""
         mock_get.return_value = _make_error_response()
@@ -163,8 +163,8 @@ def test_all_titles_missing_raises(self, _mock_sleep, mock_get, _mock_search):
 
 
 class TestRewriteSynopses:
-    @patch("tvplotlines.llm.call_llm_parallel")
-    @patch("tvplotlines.prompts.load_prompt", return_value="system prompt")
+    @patch("tvplot.llm.call_llm_parallel")
+    @patch("tvplot.prompts.load_prompt", return_value="system prompt")
     def test_rewrite_returns_synopsis_texts(self, _mock_prompt, mock_parallel):
         """Returns list of synopsis strings from LLM JSON responses."""
         mock_parallel.return_value = [
@@ -172,7 +172,7 @@ def test_rewrite_returns_synopsis_texts(self, _mock_prompt, mock_parallel):
             {"synopsis": "Full synopsis for episode 2..."},
         ]
 
-        from tvplotlines.llm import LLMConfig
+        from tvplot.llm import LLMConfig
         config = LLMConfig()
 
         result = rewrite_synopses(_SAMPLE_EPISODES, "House", 1, config, mode="parallel")
@@ -181,13 +181,13 @@ def test_rewrite_returns_synopsis_texts(self, _mock_prompt, mock_parallel):
         assert result[0] == "Full synopsis for episode 1..."
         assert result[1] == "Full synopsis for episode 2..."
 
-    @patch("tvplotlines.llm.call_llm_parallel")
-    @patch("tvplotlines.prompts.load_prompt", return_value="system prompt")
+    @patch("tvplot.llm.call_llm_parallel")
+    @patch("tvplot.prompts.load_prompt", return_value="system prompt")
     def test_rewrite_user_messages_contain_episode_info(self, _mock_prompt, mock_parallel):
         """User messages include show, season, episode number, description."""
         mock_parallel.return_value = [{"synopsis": "x"}, {"synopsis": "y"}]
 
-        from tvplotlines.llm import LLMConfig
+        from tvplot.llm import LLMConfig
         config = LLMConfig()
 
         rewrite_synopses(
@@ -201,13 +201,13 @@ def test_rewrite_user_messages_contain_episode_info(self, _mock_prompt, mock_par
         assert "A teacher collapses." in user_messages[0]
         assert "procedural" in user_messages[0]
 
-    @patch("tvplotlines.llm.call_llm_parallel")
-    @patch("tvplotlines.prompts.load_prompt", return_value="system prompt")
+    @patch("tvplot.llm.call_llm_parallel")
+    @patch("tvplot.prompts.load_prompt", return_value="system prompt")
     def test_rewrite_caches_system_prompt(self, _mock_prompt, mock_parallel):
         """System prompt is cached for efficiency."""
         mock_parallel.return_value = [{"synopsis": "x"}]
 
-        from tvplotlines.llm import LLMConfig
+        from tvplot.llm import LLMConfig
         result = rewrite_synopses(
             [_SAMPLE_EPISODES[0]], "House", 1, LLMConfig(), mode="parallel",
         )
diff --git a/tests/test_validation.py b/tests/test_validation.py
index 1d5a23a..7424f1b 100644
--- a/tests/test_validation.py
+++ b/tests/test_validation.py
@@ -2,7 +2,7 @@
 
 import pytest
 
-from tvplotlines.models import (
+from tvplot.models import (
     CastMember,
     EpisodeBreakdown,
     Event,
@@ -10,9 +10,9 @@
     Plotline,
     SeriesContext,
 )
-from tvplotlines.pass0 import _validate as validate_pass0
-from tvplotlines.pass1 import _validate as validate_pass1
-from tvplotlines.pass2 import _validate as validate_pass2
+from tvplot.pass0 import _validate as validate_pass0
+from tvplot.pass1 import _validate as validate_pass1
+from tvplot.pass2 import _validate as validate_pass2
 
 
 # --- Pass 0 ---
diff --git a/tests/test_verdicts.py b/tests/test_verdicts.py
index d356d04..65e61ea 100644
--- a/tests/test_verdicts.py
+++ b/tests/test_verdicts.py
@@ -1,7 +1,7 @@
 """Tests for verdict validation and safe DROP logic."""
 
-from tvplotlines.models import EpisodeBreakdown, Event, Plotline, Verdict
-from tvplotlines.verdicts import apply_verdicts
+from tvplot.models import EpisodeBreakdown, Event, Plotline, Verdict
+from tvplot.verdicts import apply_verdicts
 
 
 def _make_plotline(id: str, computed_rank: str = "A") -> Plotline: