@ngocsangairvds/vsaf 3.1.27 → 3.2.1

package/tools/vds-scripts/scripts/move_audit_artifact_pages.py

@@ -0,0 +1,255 @@
+#!/usr/bin/env python3
+"""
+Move audit artifact pages under an 'Audit History' child page.
+
+Target: Department page 88716694 (Payment department)
+Pages to move:
+  - "Project Analysis - 88718879"
+  - "Project Analysis - 88718884"
+  - "Project Analysis - 88718886"
+  - "Project Analysis - 88718943"
+  - "Project Analysis - 88718977"
+  - "Project Audit - 88718879"
+  - "Project Audit - 88718884"
+  - "Project Audit - 88718886"
+  - "Project Audit - 88718943"
+  - "Project Audit - 88718977"
+
+Usage:
+    uv run --project audit_orchestrator python3 scripts/move_audit_artifact_pages.py
+
+Prerequisites:
+  - ~/.vds/.env must be populated with VDS_USERNAME, VDS_PASSWORD
+  - CONFLUENCE_INTERNAL_URL must be accessible (requires VPN/internal network)
+"""
+
+from __future__ import annotations
+
+import asyncio
+import json
+import sys
+from pathlib import Path
+
+# ---------------------------------------------------------------------------
+# Bootstrap environment
+# ---------------------------------------------------------------------------
+env_path = Path("/Users/vds-ai/.vds/.env")
+if env_path.exists():
+    from dotenv import load_dotenv
+    load_dotenv(env_path)
+
+from vds_audit_orchestrator.clients.confluence_cli_client import ConfluenceCliClient
+
+# ---------------------------------------------------------------------------
+# Configuration
+# ---------------------------------------------------------------------------
+DEPARTMENT_PAGE_ID = "88716694"
+AUDIT_HISTORY_TITLE = "Audit History"
+
+# Pages to move: (title, page_id_in_title) - the IDs embedded in the titles
+ARTIFACT_PAGE_IDS = [
+    "88718879",
+    "88718884",
+    "88718886",
+    "88718943",
+    "88718977",
+]
+
+ARTIFACT_PAGE_TITLES = (
+    [f"Project Analysis - {pid}" for pid in ARTIFACT_PAGE_IDS]
+    + [f"Project Audit - {pid}" for pid in ARTIFACT_PAGE_IDS]
+)
+
+
+async def connectivity_check(client: ConfluenceCliClient) -> bool:
+    """Verify Confluence is reachable by fetching the department page."""
+    try:
+        page = await asyncio.wait_for(
+            client.get_page(DEPARTMENT_PAGE_ID, expand="version,space"),
+            timeout=15,
+        )
+        if page and page.get("title"):
+            print(f"[OK] Connected to Confluence. Department page: {page['title']!r}")
+            return True
+        print(f"[WARN] Page {DEPARTMENT_PAGE_ID} not found or no permission.")
+        return False
+    except asyncio.TimeoutError:
+        print("[ERROR] Confluence connection timed out. Check VPN/network access.")
+        return False
+    except Exception as exc:
+        print(f"[ERROR] Confluence connectivity check failed: {exc}")
+        return False
+
+
+async def find_or_create_audit_history_page(
+    client: ConfluenceCliClient,
+    space_key: str,
+) -> str:
+    """Return the page ID of 'Audit History' under the department page, creating it if absent."""
+    children = await client.get_child_pages(DEPARTMENT_PAGE_ID)
+    for child in children:
+        if child.get("title") == AUDIT_HISTORY_TITLE:
+            page_id = child["id"]
+            print(f"[OK] Found existing 'Audit History' page: {page_id}")
+            return page_id
+
+    print(f"[INFO] 'Audit History' page not found under {DEPARTMENT_PAGE_ID}. Creating...")
+    body_file = Path("/tmp/audit_history_body.html")
+    body_file.write_text(
+        "<p>This page archives historical audit artifacts for the Payment department.</p>",
+        encoding="utf-8",
+    )
+    result = await client.create_page(
+        space_key=space_key,
+        title=AUDIT_HISTORY_TITLE,
+        body_file=body_file,
+        parent_id=DEPARTMENT_PAGE_ID,
+    )
+    new_id = result.get("id") or result.get("page_id")
+    if not new_id:
+        raise RuntimeError(f"Failed to create 'Audit History' page. Response: {result}")
+    print(f"[OK] Created 'Audit History' page: {new_id}")
+    return str(new_id)
+
+
+async def get_pages_to_move(client: ConfluenceCliClient) -> list[dict]:
+    """Get the current children of the department page that match the artifact pattern."""
+    children = await client.get_child_pages(DEPARTMENT_PAGE_ID)
+    pages_to_move = []
+    for child in children:
+        title = child.get("title", "")
+        if title in ARTIFACT_PAGE_TITLES:
+            pages_to_move.append(child)
+            print(f"  Found artifact page: {title!r} (id={child['id']})")
+    return pages_to_move
+
+
+async def move_pages(
+    client: ConfluenceCliClient,
+    pages: list[dict],
+    audit_history_page_id: str,
+    space_key: str,
+) -> dict[str, list[str]]:
+    """Move all artifact pages under the Audit History page."""
+    results: dict[str, list[str]] = {"moved": [], "failed": []}
+
+    for page in pages:
+        page_id = page["id"]
+        title = page.get("title", page_id)
+        try:
+            # Use PUT to update ancestors (move page)
+            # The move_page method uses content.move_page which moves by title
+            # We need to reparent using update_page's ancestor field
+            # Use the REST API approach: update with new ancestors
+            await reparent_page(client, page_id, audit_history_page_id, title)
+            print(f"  [OK] Moved: {title!r} -> Audit History")
+            results["moved"].append(title)
+        except Exception as exc:
+            print(f"  [FAIL] Could not move {title!r}: {exc}")
+            results["failed"].append(f"{title}: {exc}")
+
+    return results
+
+
+async def reparent_page(
+    client: ConfluenceCliClient,
+    page_id: str,
+    new_parent_id: str,
+    title: str,
+) -> None:
+    """Move a page to a new parent by calling atlassian update_page with parent_id."""
+    # Get current page body (required to not wipe content on update)
+    page = await client.get_page(page_id, expand="version,body.storage,space")
+    if not page:
+        raise ValueError(f"Page {page_id} not found")
+
+    body_content = page.get("body", {}).get("storage", {}).get("value", "")
+
+    # Use the atlassian-python-api client directly — it supports parent_id
+    # client._http._client is the atlassian.Confluence instance
+    result = await asyncio.to_thread(
+        client._http._client.update_page,
+        page_id,
+        title,
+        body_content,
+        parent_id=new_parent_id,
+        representation="storage",
+        always_update=True,
+        version_comment="Moved to Audit History archive",
+    )
+    if not result:
+        raise RuntimeError(f"update_page returned falsy result for page {page_id}")
+
+
+async def main() -> int:
+    print("=" * 60)
+    print("Audit Artifact Page Migration")
+    print(f"Department page: {DEPARTMENT_PAGE_ID}")
+    print(f"Target: '{AUDIT_HISTORY_TITLE}' child page")
+    print("=" * 60)
+
+    client = ConfluenceCliClient(timeout=30)
+
+    # Step 1: Connectivity check
+    print("\n[1/4] Checking Confluence connectivity...")
+    if not await connectivity_check(client):
+        print("\nABORTED: Cannot reach Confluence. Ensure you have VPN/network access.")
+        return 1
+
+    # Step 2: Get space key for creating the Audit History page
+    dept_page = await client.get_page(DEPARTMENT_PAGE_ID, expand="space")
+    space_key = dept_page.get("space", {}).get("key", "") if dept_page else ""
+    if not space_key:
+        print("[ERROR] Could not determine space key from department page.")
+        return 1
+    print(f"[OK] Space key: {space_key}")
+
+    # Step 3: Find pages to move
+    print("\n[2/4] Scanning children of department page for artifact pages...")
+    pages_to_move = await get_pages_to_move(client)
+    if not pages_to_move:
+        print("[INFO] No artifact pages found. Already moved or not present.")
+        return 0
+    print(f"Found {len(pages_to_move)} pages to move.")
+
+    # Step 4: Ensure Audit History page exists
+    print("\n[3/4] Ensuring 'Audit History' page exists...")
+    audit_history_id = await find_or_create_audit_history_page(client, space_key)
+
+    # Step 5: Move pages
+    print(f"\n[4/4] Moving {len(pages_to_move)} pages to Audit History ({audit_history_id})...")
+    results = await move_pages(client, pages_to_move, audit_history_id, space_key)
+
+    # Summary
+    print("\n" + "=" * 60)
+    print("MIGRATION SUMMARY")
+    print(f"  Moved:  {len(results['moved'])}")
+    print(f"  Failed: {len(results['failed'])}")
+    if results["moved"]:
+        print("\nSuccessfully moved:")
+        for t in results["moved"]:
+            print(f"  - {t}")
+    if results["failed"]:
+        print("\nFailed:")
+        for t in results["failed"]:
+            print(f"  - {t}")
+    print("=" * 60)
+
+    # Verify final state
+    print("\n[Verify] Remaining children of department page...")
+    remaining = await client.get_child_pages(DEPARTMENT_PAGE_ID)
+    artifact_remaining = [
+        c for c in remaining if c.get("title", "") in ARTIFACT_PAGE_TITLES
+    ]
+    if artifact_remaining:
+        print(f"[WARN] {len(artifact_remaining)} artifact pages still under department page:")
+        for c in artifact_remaining:
+            print(f"  - {c.get('title')} (id={c['id']})")
+    else:
+        print("[OK] No artifact pages remain directly under the department page.")
+
+    return 0 if not results["failed"] else 1
+
+
+if __name__ == "__main__":
+    sys.exit(asyncio.run(main()))

package/tools/vds-scripts/scripts/move_audit_artifact_pages_rest.py

@@ -0,0 +1,165 @@
+#!/usr/bin/env python3
+"""
+Move audit artifact pages under an 'Audit History' child page.
+Uses ConfluenceCliClient (vds-scripts SDK) — no raw HTTP calls.
+
+Usage:
+    uv run --project audit_orchestrator python3 scripts/move_audit_artifact_pages_rest.py
+"""
+
+from __future__ import annotations
+
+import asyncio
+import sys
+import tempfile
+from pathlib import Path
+
+# ---------------------------------------------------------------------------
+# Configuration
+# ---------------------------------------------------------------------------
+DEPARTMENT_PAGE_ID = "88716694"
+AUDIT_HISTORY_TITLE = "Audit History"
+
+ARTIFACT_PAGE_IDS = ["88718879", "88718884", "88718886", "88718943", "88718977"]
+ARTIFACT_PAGE_TITLES = set(
+    [f"Project Analysis - {pid}" for pid in ARTIFACT_PAGE_IDS] + [f"Project Audit - {pid}" for pid in ARTIFACT_PAGE_IDS]
+)
+
+
+async def main() -> int:
+    from vds_audit_orchestrator.clients.confluence_cli_client import ConfluenceCliClient
+
+    print("=" * 60)
+    print("Audit Artifact Page Migration (ConfluenceCliClient SDK)")
+    print(f"  Department page: {DEPARTMENT_PAGE_ID}")
+    print(f"  Target container: '{AUDIT_HISTORY_TITLE}'")
+    print("=" * 60)
+
+    client = ConfluenceCliClient()
+
+    # 1. Connectivity check
+    print("\n[1/4] Checking Confluence connectivity...")
+    reachable, detail = await client.probe_reachable()
+    if not reachable:
+        print(f"  [FAIL] Confluence not reachable: {detail}")
+        print("  Check VPN/credentials in ~/.vds/.env")
+        return 1
+
+    dept_page = await client.get_page(DEPARTMENT_PAGE_ID, expand="version,space")
+    if not dept_page or not dept_page.get("title"):
+        print(f"  [FAIL] Could not fetch department page {DEPARTMENT_PAGE_ID}.")
+        return 1
+
+    space_key = dept_page.get("space", {}).get("key", "")
+    if not space_key:
+        print("[ERROR] Cannot determine space key.")
+        return 1
+    print(f"  [OK] Department page: {dept_page['title']!r} (space: {space_key})")
+
+    # 2. List current children
+    print("\n[2/4] Listing children of department page...")
+    children = await client.list_child_pages(DEPARTMENT_PAGE_ID)
+    print(f"  Total children found: {len(children)}")
+
+    pages_to_move = [c for c in children if c.get("title", "") in ARTIFACT_PAGE_TITLES]
+    audit_history_existing = [c for c in children if c.get("title", "") == AUDIT_HISTORY_TITLE]
+
+    print(f"  Artifact pages to move: {len(pages_to_move)}")
+    for p in pages_to_move:
+        print(f"    - {p.get('title')!r} (id={p['id']})")
+
+    if not pages_to_move:
+        print("  [INFO] No artifact pages found. Already moved or not present.")
+        return 0
+
+    # 3. Get or create Audit History page
+    print("\n[3/4] Getting/creating 'Audit History' page...")
+    if audit_history_existing:
+        audit_history_id = audit_history_existing[0]["id"]
+        print(f"  [OK] Found existing: id={audit_history_id}")
+    else:
+        print("  Creating 'Audit History' page...")
+        body_html = (
+            "<p>This page archives historical audit artifact pages "
+            "for the <strong>3.2.4 Nền tảng thanh toán</strong> department.</p>"
+        )
+        with tempfile.NamedTemporaryFile(mode="w", suffix=".html", delete=False, encoding="utf-8") as tmp:
+            tmp.write(body_html)
+            tmp_path = Path(tmp.name)
+
+        try:
+            new_page = await client.create_page(
+                space_key=space_key,
+                title=AUDIT_HISTORY_TITLE,
+                body_file=tmp_path,
+                parent_id=DEPARTMENT_PAGE_ID,
+            )
+        finally:
+            tmp_path.unlink(missing_ok=True)
+
+        if not new_page or not new_page.get("id"):
+            print(f"  [ERROR] Failed to create 'Audit History' page. Response: {new_page}")
+            return 1
+        audit_history_id = str(new_page["id"])
+        print(f"  [OK] Created: id={audit_history_id}")
+
+    # 4. Move pages using move_page (by target title)
+    print(f"\n[4/4] Moving {len(pages_to_move)} pages to '{AUDIT_HISTORY_TITLE}' ({audit_history_id})...")
+    moved: list[str] = []
+    failed: list[str] = []
+
+    for page_meta in pages_to_move:
+        page_id = page_meta["id"]
+        title = page_meta.get("title", page_id)
+
+        result = await client.move_page(
+            page_id,
+            AUDIT_HISTORY_TITLE,
+            position="append",
+        )
+
+        if result or result == {}:
+            # move_page returns {} on success (no body) or a dict
+            print(f"  [OK] Moved: {title!r}")
+            moved.append(title)
+        else:
+            print(f"  [FAIL] Could not move: {title!r}")
+            failed.append(f"{title}: move_page returned no result")
+
+    # Summary
+    print("\n" + "=" * 60)
+    print("MIGRATION SUMMARY")
+    print(f"  Moved:  {len(moved)}")
+    print(f"  Failed: {len(failed)}")
+    if moved:
+        print("\nSuccessfully moved:")
+        for t in moved:
+            print(f"  - {t}")
+    if failed:
+        print("\nFailed:")
+        for t in failed:
+            print(f"  - {t}")
+    print("=" * 60)
+
+    # Verify
+    print("\n[Verify] Remaining artifact pages under department page...")
+    remaining_children = await client.list_child_pages(DEPARTMENT_PAGE_ID)
+    still_there = [c for c in remaining_children if c.get("title", "") in ARTIFACT_PAGE_TITLES]
+    if still_there:
+        print(f"[WARN] {len(still_there)} artifact pages still directly under department:")
+        for c in still_there:
+            print(f"  - {c.get('title')} (id={c['id']})")
+    else:
+        print("[OK] No artifact pages remain directly under the department page.")
+
+    print(f"\n[Verify] Children of 'Audit History' page ({audit_history_id})...")
+    ah_children = await client.list_child_pages(audit_history_id)
+    print(f"  {len(ah_children)} pages now under 'Audit History':")
+    for c in ah_children:
+        print(f"  - {c.get('title')} (id={c['id']})")
+
+    return 0 if not failed else 1
+
+
+if __name__ == "__main__":
+    sys.exit(asyncio.run(main()))

package/tools/vds-scripts/scripts/move_wrong_dept_pages.py

@@ -0,0 +1,216 @@
+#!/usr/bin/env python3
+"""
+Move 14 wrong-department pages from Payment dept (88716694) to their correct
+department parent pages. Also renames pages with '- 88716694' suffix and
+archives a duplicate.
+
+Usage:
+    uv run --project audit_orchestrator python3 scripts/move_wrong_dept_pages.py
+"""
+
+from __future__ import annotations
+
+import asyncio
+import sys
+
+# ---------------------------------------------------------------------------
+# Move plan: (page_id, target_parent_id)
+# ---------------------------------------------------------------------------
+PAGES_TO_MOVE = [
+    # Admin Products (88716677)
+    ("93487312", "88716677"),  # Project Analysis - 88718856
+    ("93487308", "88716677"),  # Project Audit - 88718856
+    ("93487326", "88716677"),  # Project Analysis - 88718889
+    ("93487285", "88716677"),  # Project Audit - 88718884 - 88716694
+    ("93487290", "88716677"),  # Project Audit - 88718886 - 88716694
+    ("93487294", "88716677"),  # Project Audit - 88718879 - 88716694
+    ("93487299", "88716677"),  # Project Audit - 88718877 - 88716694
+    # App Platform (88716679)
+    ("93487303", "88716679"),  # Project Audit - 88718882 - 88716694
+    # Finance (88716692)
+    ("93487316", "88716692"),  # Project Analysis - 88718866
+    ("93487321", "88716692"),  # Project Analysis - 88718868
+    ("93487314", "88716692"),  # Project Audit - 88718866
+    ("93487319", "88716692"),  # Project Audit - 88718868
+    # Core Tech (88718815)
+    ("93487328", "88718815"),  # Project Analysis - 88718983
+    ("93127125", "88718815"),  # Project Audit - 88718940 - 88716694
+]
+
+# ---------------------------------------------------------------------------
+# Rename plan: (page_id, new_title)
+# ---------------------------------------------------------------------------
+PAGES_TO_RENAME = [
+    ("93126787", "Project Audit - 88718943"),
+    ("93127090", "Project Audit - 88718975"),
+    ("93126805", "Project Audit - 88718977"),
+    ("93126810", "Project Audit - 88719105"),
+    ("93487279", "Project Audit - 91335346"),
+]
+
+# ---------------------------------------------------------------------------
+# Archive duplicate: (page_id, new_title, target_parent_id)
+# ---------------------------------------------------------------------------
+ARCHIVE_PAGE = ("93487283", "[ARCHIVED] Project Analysis - 91335346 (duplicate)", "88727274")
+
+SLEEP_BETWEEN_OPS = 5  # seconds
+
+
+async def main() -> int:
+    from vds_audit_orchestrator.clients.confluence_cli_client import ConfluenceCliClient
+
+    print("=" * 70)
+    print("Wrong-Department Page Migration & Cleanup")
+    print("=" * 70)
+
+    client = ConfluenceCliClient()
+
+    # 1. Connectivity check — use get_page on a known page instead of probe_reachable
+    # (probe_reachable calls get_all_groups which times out on this server)
+    print("\n[Step 1] Checking Confluence connectivity via get_page(88716694)...")
+    test_page = await client.get_page("88716694", expand="version,space")
+    if not test_page or not test_page.get("title"):
+        print("  [FAIL] Could not fetch Payment dept page 88716694.")
+        print("  Check VPN/LAN and credentials in ~/.vds/.env")
+        return 1
+    space_key = test_page.get("space", {}).get("key", "")
+    print(f"  [OK] Reachable — page: {test_page['title']!r} (space: {space_key})")
+
+    # 2. Resolve target parent titles (needed by move_page which takes a title)
+    print("\n[Step 2] Resolving target parent page titles...")
+    unique_parent_ids = list({parent_id for _, parent_id in PAGES_TO_MOVE} | {ARCHIVE_PAGE[2]})
+    parent_titles: dict[str, str] = {}
+
+    for pid in unique_parent_ids:
+        page = await client.get_page(pid, expand="version")
+        if page and page.get("title"):
+            parent_titles[pid] = page["title"]
+            print(f"  [OK] {pid} -> {page['title']!r}")
+        else:
+            print(f"  [FAIL] Could not fetch parent page {pid}")
+            return 1
+
+    # 3. Move pages
+    print(f"\n[Step 3] Moving {len(PAGES_TO_MOVE)} pages to correct departments...")
+    move_success = 0
+    move_fail = 0
+
+    for page_id, target_parent_id in PAGES_TO_MOVE:
+        target_title = parent_titles[target_parent_id]
+
+        # Get current page info for logging
+        page_info = await client.get_page(page_id, expand="version")
+        current_title = page_info.get("title", page_id) if page_info else page_id
+
+        print(f"\n  Moving: {current_title!r}")
+        print(f"    page_id={page_id}  -> parent={target_parent_id} ({target_title!r})")
+
+        try:
+            result = await client.move_page(page_id, target_title, position="append")
+            # move_page returns {} on success (empty body from Confluence REST)
+            print(f"    [OK] Moved successfully (result={result!r})")
+            move_success += 1
+        except Exception as exc:
+            print(f"    [FAIL] Exception: {exc}")
+            # Retry once after 30s
+            print("    Waiting 30s and retrying once...")
+            await asyncio.sleep(30)
+            try:
+                result = await client.move_page(page_id, target_title, position="append")
+                print(f"    [OK] Moved on retry (result={result!r})")
+                move_success += 1
+            except Exception as exc2:
+                print(f"    [FAIL] Retry also failed: {exc2}")
+                move_fail += 1
+                continue
+
+        await asyncio.sleep(SLEEP_BETWEEN_OPS)
+
+    # 4. Rename pages (remove '- 88716694' suffix)
+    print(f"\n[Step 4] Renaming {len(PAGES_TO_RENAME)} pages (remove '- 88716694' suffix)...")
+    rename_success = 0
+    rename_fail = 0
+
+    for page_id, new_title in PAGES_TO_RENAME:
+        page_info = await client.get_page(page_id, expand="version")
+        current_title = page_info.get("title", page_id) if page_info else page_id
+
+        print(f"\n  Renaming: {current_title!r}")
+        print(f"    page_id={page_id}  -> new title: {new_title!r}")
+
+        try:
+            result = await client.rename_page(page_id, new_title)
+            print(f"    [OK] Renamed successfully (result keys={list(result.keys()) if result else result!r})")
+            rename_success += 1
+        except Exception as exc:
+            print(f"    [FAIL] Exception: {exc}")
+            print("    Waiting 30s and retrying once...")
+            await asyncio.sleep(30)
+            try:
+                result = await client.rename_page(page_id, new_title)
+                print("    [OK] Renamed on retry")
+                rename_success += 1
+            except Exception as exc2:
+                print(f"    [FAIL] Retry also failed: {exc2}")
+                rename_fail += 1
+                continue
+
+        await asyncio.sleep(SLEEP_BETWEEN_OPS)
+
+    # 5. Archive duplicate
+    print(f"\n[Step 5] Archiving duplicate page {ARCHIVE_PAGE[0]}...")
+    archive_id, archive_new_title, archive_parent_id = ARCHIVE_PAGE
+    archive_parent_title = parent_titles[archive_parent_id]
+
+    page_info = await client.get_page(archive_id, expand="version")
+    current_title = page_info.get("title", archive_id) if page_info else archive_id
+    print(f"  Current title: {current_title!r}")
+    print(f"  New title: {archive_new_title!r}")
+    print(f"  Target parent: {archive_parent_id} ({archive_parent_title!r})")
+
+    archive_success = True
+
+    # Step 5a: Rename first
+    try:
+        result = await client.rename_page(archive_id, archive_new_title)
+        print("  [OK] Renamed archive page")
+    except Exception as exc:
+        print(f"  [FAIL] Could not rename archive page: {exc}")
+        archive_success = False
+
+    if archive_success:
+        await asyncio.sleep(SLEEP_BETWEEN_OPS)
+        # Step 5b: Move to archive parent
+        try:
+            result = await client.move_page(archive_id, archive_parent_title, position="append")
+            print(f"  [OK] Moved archive page to {archive_parent_title!r}")
+        except Exception as exc:
+            print(f"  [FAIL] Could not move archive page: {exc}")
+            print("  Waiting 30s and retrying once...")
+            await asyncio.sleep(30)
+            try:
+                result = await client.move_page(archive_id, archive_parent_title, position="append")
+                print("  [OK] Moved archive page on retry")
+            except Exception as exc2:
+                print(f"  [FAIL] Retry also failed: {exc2}")
+                archive_success = False
+
+    # 6. Summary
+    print("\n" + "=" * 70)
+    print("SUMMARY")
+    print("=" * 70)
+    print(f"  Moves:   {move_success} succeeded, {move_fail} failed (of {len(PAGES_TO_MOVE)})")
+    print(f"  Renames: {rename_success} succeeded, {rename_fail} failed (of {len(PAGES_TO_RENAME)})")
+    print(f"  Archive: {'OK' if archive_success else 'FAILED'}")
+
+    total_failures = move_fail + rename_fail + (0 if archive_success else 1)
+    if total_failures > 0:
+        print(f"\n[WARN] {total_failures} operation(s) failed. Review output above.")
+    else:
+        print("\n[OK] All operations completed successfully.")
+
+    return 0 if total_failures == 0 else 1
+
+
+if __name__ == "__main__":
+    sys.exit(asyncio.run(main()))