From 9334ec07fb9b24e8f06b85fef5723147e239a6fb Mon Sep 17 00:00:00 2001
From: Throwing <throwing@ThrowingdeMacBook-Air.local>
Date: Sun, 26 Jul 2026 15:46:03 +0800
Subject: [PATCH] seo: expose structured discovery metadata

---
 index.html               | 12 ++++++++++++
 robots.txt               |  4 ++++
 sitemap.xml              |  7 +++++++
 tools/validate_assets.py |  8 +++++++-
 4 files changed, 30 insertions(+), 1 deletion(-)
 create mode 100644 robots.txt
 create mode 100644 sitemap.xml

diff --git a/index.html b/index.html
index d424a50..f80cef2 100644
--- a/index.html
+++ b/index.html
@@ -21,6 +21,18 @@
   <meta name="twitter:description" content="Ten companions, 90 PNG frames, 30 GIF loops, and game-ready sprite sheets.">
   <meta name="twitter:image" content="https://throwingogo-hub.github.io/DigitalPets/social-preview.png">
   <meta name="twitter:image:alt" content="The ten ShadowPets pixel-art companions arranged beside the ShadowPets title">
+  <script type="application/ld+json">
+  {
+    "@context": "https://schema.org",
+    "@type": "CreativeWork",
+    "name": "ShadowPets",
+    "url": "https://throwingogo-hub.github.io/DigitalPets/",
+    "description": "Ten reusable pixel-art companions with 90 PNG frames, 30 GIF loops, and game-ready sprite sheets.",
+    "license": "https://creativecommons.org/licenses/by/4.0/",
+    "isAccessibleForFree": true,
+    "creator": {"@type": "Person", "name": "Throwingogo", "url": "https://github.com/throwingogo-hub"}
+  }
+  </script>
   <title>ShadowPets Motion Lab</title>
   <style>
     :root {
diff --git a/robots.txt b/robots.txt
new file mode 100644
index 0000000..f7b8fcb
--- /dev/null
+++ b/robots.txt
@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://throwingogo-hub.github.io/DigitalPets/sitemap.xml
diff --git a/sitemap.xml b/sitemap.xml
new file mode 100644
index 0000000..844163e
--- /dev/null
+++ b/sitemap.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://throwingogo-hub.github.io/DigitalPets/</loc>
+    <lastmod>2026-07-26</lastmod>
+  </url>
+</urlset>
diff --git a/tools/validate_assets.py b/tools/validate_assets.py
index 188859e..f84e347 100644
--- a/tools/validate_assets.py
+++ b/tools/validate_assets.py
@@ -248,6 +248,12 @@ def validate_docs_and_site() -> None:
         fail(f"index.html: missing or incorrect social metadata: {wrong}")
     if audit.canonical != LIVE_URL:
         fail(f"index.html: canonical URL must be {LIVE_URL}")
+    if '"@type": "CreativeWork"' not in html or '"isAccessibleForFree": true' not in html:
+        fail("index.html: missing ShadowPets structured discovery metadata")
+    robots = (ROOT / "robots.txt").read_text()
+    sitemap = (ROOT / "sitemap.xml").read_text()
+    if f"Sitemap: {LIVE_URL}sitemap.xml" not in robots or f"<loc>{LIVE_URL}</loc>" not in sitemap:
+        fail("robots.txt and sitemap.xml must expose the canonical Motion Lab URL")
     for pet in PETS:
         if f'{{ name: "{pet}"' not in html:
             fail(f"index.html: gallery roster is missing {pet}")
@@ -392,7 +398,7 @@ def parse_args() -> argparse.Namespace:
         validate_rebuild()
     if args.check_package:
         validate_package()
-    print("Validated 10 pets, 90 PNG frames, 30 GIFs, 10 sheets, links, licensing, and social metadata")
+    print("Validated 10 pets, 90 PNG frames, 30 GIFs, 10 sheets, links, licensing, and discovery metadata")
     if args.check_rebuild:
         print("Rebuild check: pixel- and timing-reproducible; tracked artwork unchanged")
     if args.check_package: