chore: import upstream snapshot with attribution

scripts/sync_docs.py

@@ -0,0 +1,71 @@
+#!/usr/bin/env python3
+"""
+Sync documentation from asset/docs to docs folder.
+
+NOTE: This script is for MIGRATION ONLY.
+After migration, write all docs directly in docs/ folder.
+
+The docs/ folder is the single source of truth.
+"""
+
+import shutil
+from pathlib import Path
+
+# Paths
+PROJECT_ROOT = Path(__file__).parent.parent
+ASSET_DOCS = PROJECT_ROOT / "asset" / "docs"
+DOCS_DIR = PROJECT_ROOT / "docs"
+
+
+def sync_docs():
+    """
+    Sync documentation files from asset/docs to docs/.
+
+    Priority: docs/ files take precedence over asset/docs/ files.
+    Only copies files that don't exist in docs/.
+    """
+
+    # Files that already exist in docs/ (these take priority)
+    existing_files = set()
+    for path in DOCS_DIR.rglob("*"):
+        if path.is_file():
+            existing_files.add(path.relative_to(DOCS_DIR))
+
+    copied_count = 0
+    skipped_count = 0
+
+    # Copy files from asset/docs to docs/ (only if not exists)
+    for src_path in ASSET_DOCS.rglob("*"):
+        if src_path.is_file():
+            rel_path = src_path.relative_to(ASSET_DOCS)
+            dst_path = DOCS_DIR / rel_path
+
+            if rel_path in existing_files:
+                # Skip - docs/ version takes priority
+                print(f"Skipped (exists in docs/): {rel_path}")
+                skipped_count += 1
+            else:
+                # Copy from asset/docs
+                dst_path.parent.mkdir(parents=True, exist_ok=True)
+                shutil.copy2(src_path, dst_path)
+                print(f"Copied: {rel_path}")
+                copied_count += 1
+
+    # Copy logo to docs/assets
+    logo_src = PROJECT_ROOT / "asset" / "logo.png"
+    logo_dst = DOCS_DIR / "assets" / "logo.png"
+    if logo_src.exists() and not logo_dst.exists():
+        logo_dst.parent.mkdir(parents=True, exist_ok=True)
+        shutil.copy2(logo_src, logo_dst)
+        print(f"Copied: logo.png -> assets/logo.png")
+        copied_count += 1
+
+    print(f"\n✅ Sync complete!")
+    print(f"   Copied: {copied_count} files")
+    print(f"   Skipped: {skipped_count} files (already exist in docs/)")
+    print(f"\n📝 NOTE: docs/ is the source of truth.")
+    print(f"   Edit files in docs/, not asset/docs/")
+
+
+if __name__ == "__main__":
+    sync_docs()