clarify v2 snapshot metadata

Author: yaniv-golan

docs/v2/affinity_api_docs.md

@@ -25,7 +25,7 @@ This markdown version of the Affinity API v2 documentation was generated automat
 > **Note:** The live site renders dynamic multi-language request/response samples in-browser. Because those snippets are generated at runtime and are not embedded in the OpenAPI payload, they cannot be mirrored here. Refer to https://developer.affinity.co/ for the full interactive samples.
 
 **Documentation Version:** This copy is based on the official documentation as it appeared on **November 05, 2025 at 18:08:51 UTC** (Last updated: 11/05/2025 18:08:51 UTC).
-**Snapshot:** `tmp/v2/developer_affinity_co.html`
+**Snapshot:** Captured HTML `developer_affinity_co.html` (archived with the sync artifacts for QA).
 
 > **⚠️ Use at Your Own Risk**
 >

tools/v2_sync_pipeline/markdown_renderer.py

@@ -6,6 +6,7 @@
 import textwrap
 from dataclasses import dataclass
 from datetime import datetime
+from pathlib import Path
 from typing import Any, Dict, Iterable, List, Tuple
 
 from .utils import build_toc, normalize_whitespace, format_description, fix_mojibake, slugify
@@ -241,6 +242,7 @@ def build(self) -> str:
     def _render_header(self, toc: str) -> str:
         long_ts = self.ctx.fetched_at.strftime("%B %d, %Y at %H:%M:%S %Z")
         short_ts = self.ctx.fetched_at.strftime("%m/%d/%Y %H:%M:%S %Z")
+        snapshot_label = Path(self.ctx.snapshot_path).name if self.ctx.snapshot_path else "N/A"
         lines = [
             "# Affinity API v2 Documentation (Auto-synced)",
             "",
@@ -269,7 +271,7 @@ def _render_header(self, toc: str) -> str:
             "> **Note:** The live site renders dynamic multi-language request/response samples in-browser. Because those snippets are generated at runtime and are not embedded in the OpenAPI payload, they cannot be mirrored here. Refer to https://developer.affinity.co/ for the full interactive samples.",
             "",
             f"**Documentation Version:** This copy is based on the official documentation as it appeared on **{long_ts}** (Last updated: {short_ts}).",
-            f"**Snapshot:** `{self.ctx.snapshot_path}`",
+            f"**Snapshot:** Captured HTML `{snapshot_label}` (archived with the sync artifacts for QA).",
             "",
             "> **⚠️ Use at Your Own Risk**",
             ">",