fix(public): disambiguate Tiny Studio identity across every page and llms.txt

.lane/reports/fix-lane1-google-ai-answers-brand-disambiguation.md

@@ -0,0 +1,59 @@
+# Lane report: fix/lane1-google-ai-answers-brand-disambiguation
+
+## Item
+
+Google AI answers confuse Tiny Studio / tinystudio.in with unrelated "tiny studio" brands.
+
+## Root cause
+
+Only the homepage carried the Tiny Studio identity statement. Google AI answers are
+grounded by AI-facing surfaces — every page's Organization JSON-LD and `llms.txt` —
+and those surfaces had no disambiguation. `public/llms.txt` in particular said only
+"Tiny Studio is a small product company behind Promptly, Drishti, and 0509" with no
+`tinystudio.in` home and no not-affiliated statement.
+
+## Fix
+
+Extended the brand identity statement to every public surface:
+
+- Every public page's Organization JSON-LD node now carries `alternateName: tinystudio.in`
+  plus a description: "Tiny Studio is the independent product company at tinystudio.in
+  behind Promptly, Drishti, and 0509. It is not affiliated with other apps or studios
+  that use the name Tiny Studio."
+- `public/llms.txt` and its generator template in
+  `scripts/prepare-static-site-bundle.mjs` state the same identity up front, so LLM
+  clients reading the site corpus get the disambiguation first.
+- `scripts/test-public-brand-disambiguation.mjs` now guards every public page,
+  llms.txt, and the generator template, not just the homepage (92 checks).
+
+## Files changed (14)
+
+- public/contact/index.html — Org JSON-LD alternateName + description
+- public/drishti/index.html — same
+- public/drishti/privacy/index.html — same
+- public/drishti/support/index.html — same
+- public/llms.txt — identity statement up front
+- public/privacy-choices/index.html — Org JSON-LD alternateName + description
+- public/privacy/index.html — same
+- public/promptly/index.html — same
+- public/promptly/privacy/index.html — same
+- public/promptly/support/index.html — same
+- public/support/index.html — Org JSON-LD alternateName + description
+- public/terms/index.html — same
+- scripts/prepare-static-site-bundle.mjs — llms.txt generator template keeps identity
+- scripts/test-public-brand-disambiguation.mjs — guards every page + llms.txt + template
+
+## Verification
+
+- `node scripts/test-public-brand-disambiguation.mjs` — 92 checks, 0 failures
+- `node scripts/test-public-structured-data.mjs` — 127 checks, 0 failures
+- `node scripts/test-public-deploy-bundle.mjs` — 63 checks, 0 failures
+- `node --check` on changed scripts — OK
+- `git diff --check` — OK
+- Full `npm test` — all checks pass except `check-retention-automation.mjs`,
+  which fails identically on clean origin/main (stale canonical-workspace state +
+  checkout ahead of remote main). Pre-existing, unrelated.
+
+## Outcome
+
+Branch pushed and PR opened: fix/lane1-google-ai-answers-brand-disambiguation

public/contact/index.html

@@ -35,7 +35,9 @@
             "@type": "Organization",
             "@id": "https://tinystudio.in/#organization",
             "name": "Tiny Studio",
-            "url": "https://tinystudio.in/"
+            "alternateName": "tinystudio.in",
+            "url": "https://tinystudio.in/",
+            "description": "Tiny Studio is the independent product company at tinystudio.in behind Promptly, Drishti, and 0509. It is not affiliated with other apps or studios that use the name Tiny Studio."
           },
           {
             "@type": "ContactPage",

public/drishti/index.html

@@ -35,7 +35,9 @@
             "@type": "Organization",
             "@id": "https://tinystudio.in/#organization",
             "name": "Tiny Studio",
-            "url": "https://tinystudio.in/"
+            "alternateName": "tinystudio.in",
+            "url": "https://tinystudio.in/",
+            "description": "Tiny Studio is the independent product company at tinystudio.in behind Promptly, Drishti, and 0509. It is not affiliated with other apps or studios that use the name Tiny Studio."
           },
           {
             "@type": "WebPage",

public/drishti/privacy/index.html

@@ -35,7 +35,9 @@
             "@type": "Organization",
             "@id": "https://tinystudio.in/#organization",
             "name": "Tiny Studio",
-            "url": "https://tinystudio.in/"
+            "alternateName": "tinystudio.in",
+            "url": "https://tinystudio.in/",
+            "description": "Tiny Studio is the independent product company at tinystudio.in behind Promptly, Drishti, and 0509. It is not affiliated with other apps or studios that use the name Tiny Studio."
           },
           {
             "@type": "WebPage",

public/drishti/support/index.html

@@ -35,7 +35,9 @@
             "@type": "Organization",
             "@id": "https://tinystudio.in/#organization",
             "name": "Tiny Studio",
-            "url": "https://tinystudio.in/"
+            "alternateName": "tinystudio.in",
+            "url": "https://tinystudio.in/",
+            "description": "Tiny Studio is the independent product company at tinystudio.in behind Promptly, Drishti, and 0509. It is not affiliated with other apps or studios that use the name Tiny Studio."
           },
           {
             "@type": "ContactPage",

public/llms.txt

@@ -1,6 +1,6 @@
 # Tiny Studio
 
-Tiny Studio is a small product company behind Promptly, Drishti, and 0509.
+Tiny Studio is the independent product company at tinystudio.in behind Promptly, Drishti, and 0509. It is not affiliated with any other app or studio that uses the name Tiny Studio.
 
 ## Public pages
 

public/privacy-choices/index.html

@@ -35,7 +35,9 @@
             "@type": "Organization",
             "@id": "https://tinystudio.in/#organization",
             "name": "Tiny Studio",
-            "url": "https://tinystudio.in/"
+            "alternateName": "tinystudio.in",
+            "url": "https://tinystudio.in/",
+            "description": "Tiny Studio is the independent product company at tinystudio.in behind Promptly, Drishti, and 0509. It is not affiliated with other apps or studios that use the name Tiny Studio."
           },
           {
             "@type": "WebPage",

public/privacy/index.html

@@ -35,7 +35,9 @@
             "@type": "Organization",
             "@id": "https://tinystudio.in/#organization",
             "name": "Tiny Studio",
-            "url": "https://tinystudio.in/"
+            "alternateName": "tinystudio.in",
+            "url": "https://tinystudio.in/",
+            "description": "Tiny Studio is the independent product company at tinystudio.in behind Promptly, Drishti, and 0509. It is not affiliated with other apps or studios that use the name Tiny Studio."
           },
           {
             "@type": "WebPage",

public/promptly/index.html

@@ -35,7 +35,9 @@
             "@type": "Organization",
             "@id": "https://tinystudio.in/#organization",
             "name": "Tiny Studio",
-            "url": "https://tinystudio.in/"
+            "alternateName": "tinystudio.in",
+            "url": "https://tinystudio.in/",
+            "description": "Tiny Studio is the independent product company at tinystudio.in behind Promptly, Drishti, and 0509. It is not affiliated with other apps or studios that use the name Tiny Studio."
           },
           {
             "@type": "WebPage",

public/promptly/privacy/index.html

@@ -35,7 +35,9 @@
             "@type": "Organization",
             "@id": "https://tinystudio.in/#organization",
             "name": "Tiny Studio",
-            "url": "https://tinystudio.in/"
+            "alternateName": "tinystudio.in",
+            "url": "https://tinystudio.in/",
+            "description": "Tiny Studio is the independent product company at tinystudio.in behind Promptly, Drishti, and 0509. It is not affiliated with other apps or studios that use the name Tiny Studio."
           },
           {
             "@type": "WebPage",

public/promptly/support/index.html

@@ -35,7 +35,9 @@
             "@type": "Organization",
             "@id": "https://tinystudio.in/#organization",
             "name": "Tiny Studio",
-            "url": "https://tinystudio.in/"
+            "alternateName": "tinystudio.in",
+            "url": "https://tinystudio.in/",
+            "description": "Tiny Studio is the independent product company at tinystudio.in behind Promptly, Drishti, and 0509. It is not affiliated with other apps or studios that use the name Tiny Studio."
           },
           {
             "@type": "ContactPage",

public/support/index.html

@@ -35,7 +35,9 @@
                         "@type": "Organization",
                         "@id": "https://tinystudio.in/#organization",
                         "name": "Tiny Studio",
+                        "alternateName": "tinystudio.in",
                         "url": "https://tinystudio.in/",
+                        "description": "Tiny Studio is the independent product company at tinystudio.in behind Promptly, Drishti, and 0509. It is not affiliated with other apps or studios that use the name Tiny Studio.",
                         "contactPoint": {
                               "@type": "ContactPoint",
                               "contactType": "customer support",

public/terms/index.html

@@ -35,7 +35,9 @@
             "@type": "Organization",
             "@id": "https://tinystudio.in/#organization",
             "name": "Tiny Studio",
-            "url": "https://tinystudio.in/"
+            "alternateName": "tinystudio.in",
+            "url": "https://tinystudio.in/",
+            "description": "Tiny Studio is the independent product company at tinystudio.in behind Promptly, Drishti, and 0509. It is not affiliated with other apps or studios that use the name Tiny Studio."
           },
           {
             "@type": "WebPage",

scripts/prepare-static-site-bundle.mjs

@@ -55,7 +55,7 @@ const supportSchema = {
 
 const llmsTxt = `# Tiny Studio
 
-Tiny Studio is a small product company behind Promptly, Drishti, and 0509.
+Tiny Studio is the independent product company at tinystudio.in behind Promptly, Drishti, and 0509. It is not affiliated with any other app or studio that uses the name Tiny Studio.
 
 ## Public pages
 

scripts/test-public-brand-disambiguation.mjs

@@ -1,4 +1,4 @@
-import { readFileSync } from "node:fs"
+import { readFileSync, readdirSync } from "node:fs"
 import { fileURLToPath } from "node:url"
 import { dirname, join } from "node:path"
 
@@ -45,6 +45,16 @@ const bodyText = (html) =>
     .replace(/\s+/g, " ")
     .trim()
 
+// Every deployed HTML page (index.html under public/, mirroring the
+// structured-data test).
+const publicHtmlFiles = (dir = "public") =>
+  readdirSync(join(ROOT, dir), { withFileTypes: true }).flatMap((entry) => {
+    const path = join(dir, entry.name)
+    if (entry.isDirectory()) return publicHtmlFiles(path)
+    if (entry.isFile() && entry.name === "index.html") return [path]
+    return []
+  })
+
 console.log("test-public-brand-disambiguation: Tiny Studio entity stays distinct from unrelated tiny studio brands")
 
 console.log("A. the homepage says plainly what Tiny Studio is and is not")
@@ -58,32 +68,54 @@ ok(
   "homepage copy states Tiny Studio is not affiliated with other apps or studios using the name"
 )
 
-console.log("B. the homepage Organization entity carries distinguishing identity")
-const org = orgNode(HOME)
-ok(org !== null, "homepage JSON-LD carries the Tiny Studio organization node")
-if (org) {
-  ok(org.name === "Tiny Studio", "organization name is Tiny Studio")
-  ok(org.alternateName === "tinystudio.in", "organization alternateName is tinystudio.in")
-  ok(org.url === "https://tinystudio.in/", "organization url is the tinystudio.in home")
+console.log("B. every public page's Organization entity carries distinguishing identity")
+for (const file of publicHtmlFiles()) {
+  const html = read(file)
+  const org = orgNode(html)
+  ok(org !== null, `${file} carries the Tiny Studio organization node`)
+  if (!org) continue
+  ok(org.name === "Tiny Studio", `${file} organization name is Tiny Studio`)
+  ok(org.alternateName === "tinystudio.in", `${file} organization alternateName is tinystudio.in`)
+  ok(org.url === "https://tinystudio.in/", `${file} organization url is the tinystudio.in home`)
   ok(
     typeof org.description === "string" && org.description.length > 0,
-    "organization carries a description"
+    `${file} organization carries a description`
   )
   ok(
     org.description &&
       org.description.includes("tinystudio.in") &&
       org.description.includes("Promptly") &&
       org.description.includes("Drishti") &&
       org.description.includes("0509"),
-    "organization description names the unique products and home so the entity cannot be mistaken for another tiny studio"
+    `${file} organization description names the unique products and home so the entity cannot be mistaken for another tiny studio`
   )
   ok(
     org.description && org.description.includes("not affiliated"),
-    "organization description states it is not affiliated with other tiny studio brands"
+    `${file} organization description states it is not affiliated with other tiny studio brands`
   )
 }
 
-console.log("C. npm test/ci wiring")
+console.log("C. the AI-facing llms.txt carries the same identity statement")
+const llmsTxt = read("public/llms.txt")
+ok(
+  llmsTxt.includes("independent product company at tinystudio.in"),
+  "llms.txt identifies Tiny Studio as the independent product company at tinystudio.in"
+)
+ok(
+  llmsTxt.includes("not affiliated with any other app or studio that uses the name Tiny Studio"),
+  "llms.txt states Tiny Studio is not affiliated with other apps or studios using the name"
+)
+const bundle = read("scripts/prepare-static-site-bundle.mjs")
+ok(
+  bundle.includes("independent product company at tinystudio.in"),
+  "the llms.txt generator template keeps the independent-company identity"
+)
+ok(
+  bundle.includes("not affiliated with any other app or studio that uses the name Tiny Studio"),
+  "the llms.txt generator template keeps the non-affiliation statement"
+)
+
+console.log("D. npm test/ci wiring")
 const pkg = JSON.parse(read("package.json"))
 ok(
   pkg.scripts.test.includes("test-public-brand-disambiguation.mjs"),