feat: add original project metadata watermark

jdeluis · jdeluis · commit 98921306310d · 2026-05-18T10:11:15.000+02:00
diff --git a/README.md b/README.md
@@ -41,6 +41,34 @@ Instead of maintaining CV text in multiple documents, the source of truth is one
 3. Strictly validated through JSON Schema.
 4. Consistent output across local and CI builds.
 
+## Watermarking & Origin Tracking
+
+Every build automatically embeds invisible metadata watermarks in the compiled HTML to prove origin and track distribution:
+
+**What is watermarked:**
+- Proof of origin (project name: `folio-cv`)
+- Original author attribution (GitHub user: `txitxo0`)
+- Build timestamp (UTC ISO 8601)
+
+**Where it's stored:**
+- Hidden HTML `<meta>` tags in the document `<head>`
+- Invisible to the rendered page, visible in HTML source code
+- Preserved in PDF exports (as document properties/metadata)
+
+**Why hardcoded:**
+The watermark is intentionally hardcoded to the original project (`folio-cv` by `txitxo0`). This serves two purposes:
+
+1. **Proof of origin** – Even if someone clones or forks this project, the watermark points back to the original creator.
+2. **Distribution tracking** – Each build is timestamped, making it possible to trace when a copy was created and distributed.
+
+**For users cloning this project:**
+When you clone and build `folio-cv`, the watermark will still reference the original project. This is intentional and transparent. You are free to modify the JSON data, styles, and functionality, but the watermark remains as attribution to the original project source.
+
+**Transparency:**
+- Watermark logic is visible in `build.py` → `generate_watermark_metadata()` function
+- No obfuscation or hidden code
+- Design choice is documented here in README
+
 ## Project Map
 
 ```text
diff --git a/build.py b/build.py
@@ -13,6 +13,32 @@
 import base64
 import json
 from pathlib import Path
+from datetime import datetime, timezone
+
+
+def generate_watermark_metadata() -> str:
+    """Generate invisible HTML watermark metadata for origin tracking and distribution proof.
+    
+    Watermark is intentionally hardcoded to the original project (folio-cv by txitxo0).
+    This serves as proof of origin and helps track distribution, even in forks/clones.
+    See README.md for details.
+    
+    Returns:
+        HTML meta tags as string with origin, timestamp, and attribution
+    """
+    github_user = "txitxo0"  # Original project author - hardcoded by design
+    project_name = "folio-cv"  # Original project name - hardcoded by design
+    timestamp = datetime.now(timezone.utc).isoformat().replace("+00:00", "Z")
+    watermark = f"{project_name}:{github_user}:{timestamp}"
+    
+    meta_tags = (
+        "    <!-- Watermark metadata for origin tracking and distribution proof -->\n"
+        f'    <meta name="watermark-origin" content="{watermark}">\n'
+        f'    <meta name="watermark-project" content="{project_name}">\n'
+        f'    <meta name="watermark-author" content="{github_user}">\n'
+        f'    <meta name="watermark-timestamp" content="{timestamp}">\n'
+    )
+    return meta_tags
 
 
 def validate_data_schema(schema_path: Path, data_obj: dict):
@@ -59,10 +85,18 @@ def main():
         js = src_js.read_text(encoding="utf-8-sig")
         data = src_data.read_text(encoding="utf-8-sig")
 
+        # Inject watermark metadata before </head>
+        watermark_meta = generate_watermark_metadata()
+        head_close = "</head>"
+        if head_close in html:
+            compiled = html.replace(head_close, watermark_meta + head_close)
+        else:
+            compiled = html
+        
         # Inject CSS (remove link tag, add style tag)
         css_link = '<link rel="stylesheet" href="assets/css/cv.css">'
         style_tag = f"<style>\n{css}\n</style>"
-        compiled = html.replace(css_link, style_tag)
+        compiled = compiled.replace(css_link, style_tag)
 
         # Inline favicon so dist/index.html remains self-contained.
         favicon_link = (
@@ -159,7 +193,9 @@ def main():
         size_kb = len(compiled.encode("utf-8")) / 1024
         print(f"✅ Build complete: {output_path}")
         print(f"📦 Size: {size_kb:.2f} KB")
+        print("🔐 Watermark metadata embedded (proof of origin: folio-cv by txitxo0)")
         print("🚀 Ready to deploy to GitHub Pages")
+        print("   See README.md for details on watermarking and distribution tracking")
 
     except Exception as err:
         print(f"❌ Build failed: {err}")
