From 18b6f07ce60d11f77188768cc95bdf9a2afbd8bc Mon Sep 17 00:00:00 2001
From: Research Assistant <research@example.com>
Date: Fri, 8 May 2026 13:25:27 +0800
Subject: [PATCH] chore(52-001): align manifest sources, bump minAppVersion to
 1.9.0, add PyYAML dep

- Add clarifying comment in bump.py about canonical version source
- Update root and plugin manifest.json minAppVersion from 1.0.0 to 1.9.0
- Update versions.json compatibility mapping to 1.9.0
- Add pyyaml>=6.0 to pyproject.toml dependencies
---
 manifest.json                   | 4 ++--
 paperforge/plugin/manifest.json | 2 +-
 paperforge/plugin/versions.json | 4 ++--
 pyproject.toml                  | 1 +
 scripts/bump.py                 | 2 ++
 5 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/manifest.json b/manifest.json
index 2ec04d5e..89e1049f 100644
--- a/manifest.json
+++ b/manifest.json
@@ -1,8 +1,8 @@
 {
   "id": "paperforge",
   "name": "PaperForge",
-  "version": "1.4.17rc1",
-  "minAppVersion": "1.0.0",
+  "version": "1.4.17rc2",
+  "minAppVersion": "1.9.0",
   "description": "PaperForge — Zotero literature pipeline. Sync PDFs, run OCR, and read with AI-assisted deep reading.",
   "author": "Lin Zhaoxuan",
   "authorUrl": "https://github.com/LLLin000",
diff --git a/paperforge/plugin/manifest.json b/paperforge/plugin/manifest.json
index 4295fd60..89e1049f 100644
--- a/paperforge/plugin/manifest.json
+++ b/paperforge/plugin/manifest.json
@@ -2,7 +2,7 @@
   "id": "paperforge",
   "name": "PaperForge",
   "version": "1.4.17rc2",
-  "minAppVersion": "1.0.0",
+  "minAppVersion": "1.9.0",
   "description": "PaperForge — Zotero literature pipeline. Sync PDFs, run OCR, and read with AI-assisted deep reading.",
   "author": "Lin Zhaoxuan",
   "authorUrl": "https://github.com/LLLin000",
diff --git a/paperforge/plugin/versions.json b/paperforge/plugin/versions.json
index abfec802..33be1faa 100644
--- a/paperforge/plugin/versions.json
+++ b/paperforge/plugin/versions.json
@@ -1,4 +1,4 @@
 {
-  "1.4.3": "1.0.0",
-  "1.4.17rc2": "1.0.0"
+  "1.4.3": "1.9.0",
+  "1.4.17rc2": "1.9.0"
 }
\ No newline at end of file
diff --git a/pyproject.toml b/pyproject.toml
index c9eeb28a..cc737629 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -31,6 +31,7 @@ dependencies = [
     "tenacity>=8.2.0",
     "tqdm>=4.66.0",
     "filelock>=3.13.0",
+    "pyyaml>=6.0",
 ]
 
 [project.optional-dependencies]
diff --git a/scripts/bump.py b/scripts/bump.py
index cf3849f9..f5f7e9b0 100644
--- a/scripts/bump.py
+++ b/scripts/bump.py
@@ -19,6 +19,8 @@ from pathlib import Path
 
 ROOT = Path(__file__).resolve().parent.parent
 
+# Both root_manifest and plugin_manifest are updated from the canonical __init__.py version —
+# never edit version directly in manifest.json. The source of truth is __version__ in __init__.py.
 FILES_TO_UPDATE = {
     "__init__": ROOT / "paperforge" / "__init__.py",
     "plugin_manifest": ROOT / "paperforge" / "plugin" / "manifest.json",