docs(seo): improve Open Graph, structured data, and LLM discoverability (#65)

* docs(seo): improve Open Graph, structured data, and LLM discoverability

Add missing OG meta tags (og:type, og:site_name, og:locale), twitter:card
type, hreflang x-default for i18n, and per-page markdown alternate links
pointing to raw GitHub source for LLM agents. Enrich SoftwareApplication
and TechArticle JSON-LD schemas with version, license, author, and
mainEntityOfPage fields.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* docs(seo): generate llms-full.txt with concatenated documentation

Add a build-time script that concatenates all English docs into a single
llms-full.txt file for LLM agents. Strips frontmatter, JSX components,
and Starlight directives, keeping only prose and code blocks. Runs
automatically before `astro build` via the docs build script.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: rhuanbarreto

docs/astro.config.mjs

@@ -105,7 +105,23 @@ export default defineConfig({
             "data-cf-beacon": '{"token": "cee359c05ecc496aabc4f40f05302a03"}',
           },
         },
-        // ── Open Graph image ──────────────────────────────────────
+        // ── Open Graph ────────────────────────────────────────────
+        {
+          tag: "meta",
+          attrs: { property: "og:type", content: "website" },
+        },
+        {
+          tag: "meta",
+          attrs: { property: "og:site_name", content: "Archgate" },
+        },
+        {
+          tag: "meta",
+          attrs: { property: "og:locale", content: "en_US" },
+        },
+        {
+          tag: "meta",
+          attrs: { property: "og:locale:alternate", content: "pt_BR" },
+        },
         {
           tag: "meta",
           attrs: {
@@ -130,6 +146,10 @@ export default defineConfig({
           },
         },
         // ── Twitter / X card ──────────────────────────────────────
+        {
+          tag: "meta",
+          attrs: { name: "twitter:card", content: "summary_large_image" },
+        },
         {
           tag: "meta",
           attrs: {
@@ -177,7 +197,10 @@ export default defineConfig({
             "@type": "SoftwareApplication",
             name: "Archgate CLI",
             applicationCategory: "DeveloperApplication",
+            applicationSubCategory: "Code Governance",
             operatingSystem: "macOS, Linux, Windows",
+            softwareVersion: "0.11.0",
+            license: "https://github.com/archgate/cli/blob/main/LICENSE",
             offers: { "@type": "Offer", price: "0", priceCurrency: "USD" },
             url: "https://cli.archgate.dev",
             downloadUrl: "https://www.npmjs.com/package/archgate",

docs/package.json

@@ -4,7 +4,7 @@
   "type": "module",
   "scripts": {
     "dev": "astro dev",
-    "build": "astro build",
+    "build": "bun run scripts/generate-llms-full.ts && astro build",
     "preview": "astro preview"
   },
   "dependencies": {