Refine OpenClaw payloads and reorganize docs

scripts/pull_freshrss_items.py

@@ -1,4 +1,4 @@
-from __future__ import annotations
+from __future__ import annotations
 
 import argparse
 import json
@@ -10,6 +10,8 @@ from typing import Any
 
 REPO_ROOT = Path(__file__).resolve().parents[1]
 SRC_ROOT = REPO_ROOT / "src"
+OUTPUT_ROOT = REPO_ROOT / "outputs"
+FRESHRSS_OUTPUT_ROOT = OUTPUT_ROOT / "freshrss"
 
 if str(SRC_ROOT) not in sys.path:
     sys.path.insert(0, str(SRC_ROOT))
@@ -46,13 +48,13 @@ def main() -> None:
     parser.add_argument(
         "--raw-output",
         type=Path,
-        default=REPO_ROOT / "outputs" / "freshrss.raw.json",
+        default=FRESHRSS_OUTPUT_ROOT / "raw" / "freshrss.raw.json",
         help="Where to save the raw FreshRSS response",
     )
     parser.add_argument(
         "--items-output",
         type=Path,
-        default=REPO_ROOT / "outputs" / "freshrss.items.json",
+        default=FRESHRSS_OUTPUT_ROOT / "items" / "freshrss.items.json",
         help="Where to save the mapped item list",
     )
     parser.add_argument("--timeout", type=float, default=20.0, help="Request timeout in seconds")
@@ -89,4 +91,4 @@ def main() -> None:
 
 
 if __name__ == "__main__":
-    main()
+    main()