Harden releases and documentation SEO

.github/workflows/release.yml

@@ -10,7 +10,7 @@ on:
       - ".releaserc.json"
       - "package.json"
       - "pnpm-lock.yaml"
-      - "scripts/publish-github-package.mjs"
+      - "scripts/publish-github-package.ts"
 
 permissions:
   contents: write
@@ -35,7 +35,23 @@ jobs:
           registry-url: https://registry.npmjs.org
       - run: pnpm install --frozen-lockfile
       - run: pnpm check
-      - run: pnpm release
+      - name: Check npm publishing credentials
+        id: npm-auth
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          if [[ -n "$NPM_TOKEN" ]]; then
+            echo "available=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "::warning::NPM_TOKEN is not configured; semantic-release will be skipped."
+            echo "available=false" >> "$GITHUB_OUTPUT"
+          fi
+      - name: Run semantic-release
+        if: steps.npm-auth.outputs.available == 'true'
+        run: pnpm release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+      - name: Skip semantic-release without npm credentials
+        if: steps.npm-auth.outputs.available != 'true'
+        run: echo "Release skipped because NPM_TOKEN is not configured."

.releaserc.json

@@ -16,6 +16,7 @@
     [
       "@semantic-release/github",
       {
+        "labels": [],
         "assets": [{ "path": "release/*.tgz", "label": "npm package" }],
         "releaseBodyTemplate": "<%= nextRelease.notes %>\n\nPackage: [@jstn-sdk/agents](https://www.npmjs.com/package/@jstn-sdk/agents)\n\nRepository: https://github.com/JustineDevs/agent-compat"
       }

README.md

@@ -6,6 +6,8 @@
 [![npm version](https://img.shields.io/npm/v/@jstn-sdk/agents)](https://www.npmjs.com/package/@jstn-sdk/agents)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+<a href="https://www.producthunt.com/products/agent-compat?embed=true&amp;utm_source=badge-featured&amp;utm_medium=badge&amp;utm_campaign=badge-agent-compat" target="_blank" rel="noopener noreferrer"><img alt="agent-compat - The compatibility layer for AI agent environments. | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1229506&amp;theme=light&amp;t=1787430161859"></a>
+
 </div>
 
 > [!NOTE]

apps/docs/app/docs/[[...slug]]/page.tsx

@@ -35,5 +35,23 @@ export async function generateMetadata(props: PageProps) {
   const params = await props.params;
   const page = source.getPage(params.slug);
   if (!page) return {};
-  return { title: page.data.title, description: page.data.description };
+  return {
+    title: page.data.title,
+    description: page.data.description,
+    alternates: { canonical: page.url },
+    openGraph: {
+      type: "article",
+      url: page.url,
+      title: page.data.title,
+      description: page.data.description,
+      images: [
+        {
+          url: "/assets/banner.png",
+          width: 2508,
+          height: 627,
+          alt: `${page.data.title} | Agent Compat`,
+        },
+      ],
+    },
+  };
 }

apps/docs/app/layout.tsx

@@ -11,6 +11,46 @@ export const metadata: Metadata = {
   },
   description:
     "Cross-agent environment compatibility SDK: detect, compile, validate.",
+  applicationName: "Agent Compat",
+  keywords: [
+    "agent compatibility",
+    "AI agent SDK",
+    "AGENTS.md",
+    "agent skills",
+    "TypeScript",
+  ],
+  authors: [{ name: "Justine Devs", url: "https://github.com/JustineDevs" }],
+  creator: "Justine Devs",
+  publisher: "Justine Devs",
+  alternates: { canonical: "/docs" },
+  openGraph: {
+    type: "website",
+    siteName: "Agent Compat",
+    title: "Agent Compat | Cross-agent compatibility SDK",
+    description:
+      "Detect, compile, and validate project integrations across AI coding environments.",
+    url: "/docs",
+    images: [
+      {
+        url: "/assets/banner.png",
+        width: 2508,
+        height: 627,
+        alt: "Agent Compat cross-agent environment compatibility SDK",
+      },
+    ],
+  },
+  twitter: {
+    card: "summary_large_image",
+    title: "Agent Compat | Cross-agent compatibility SDK",
+    description:
+      "Detect, compile, and validate project integrations across AI coding environments.",
+    images: ["/assets/banner.png"],
+  },
+  robots: {
+    index: true,
+    follow: true,
+    googleBot: { index: true, follow: true, "max-image-preview": "large" },
+  },
 };
 
 export default function RootLayout({
@@ -21,6 +61,38 @@ export default function RootLayout({
   return (
     <html lang="en" suppressHydrationWarning>
       <body className="flex min-h-screen flex-col">
+        <script
+          type="application/ld+json"
+          dangerouslySetInnerHTML={{
+            __html: JSON.stringify({
+              "@context": "https://schema.org",
+              "@graph": [
+                {
+                  "@type": "Organization",
+                  name: "Justine Devs",
+                  url: "https://github.com/JustineDevs",
+                },
+                {
+                  "@type": "SoftwareApplication",
+                  name: "@jstn-sdk/agents",
+                  applicationCategory: "DeveloperApplication",
+                  operatingSystem: "Cross-platform",
+                  description: metadata.description,
+                  url: "https://agents-compat.jstn.site/docs",
+                  image: "https://agents-compat.jstn.site/assets/banner.png",
+                  codeRepository: "https://github.com/JustineDevs/agent-compat",
+                  programmingLanguage: "TypeScript",
+                  author: { "@type": "Organization", name: "Justine Devs" },
+                },
+                {
+                  "@type": "WebSite",
+                  name: "Agent Compat",
+                  url: "https://agents-compat.jstn.site",
+                },
+              ],
+            }),
+          }}
+        />
         <a
           href="#nd-page"
           className="sr-only focus:not-sr-only focus:fixed focus:left-4 focus:top-4 focus:z-50 focus:rounded-md focus:bg-fd-popover focus:px-3 focus:py-2 focus:text-fd-popover-foreground"

apps/docs/app/robots.ts

@@ -0,0 +1,19 @@
+import type { MetadataRoute } from "next";
+
+export default function robots(): MetadataRoute.Robots {
+  return {
+    rules: [
+      {
+        userAgent: "*",
+        allow: "/",
+        disallow: ["/api/"],
+      },
+      { userAgent: "GPTBot", allow: "/" },
+      { userAgent: "ClaudeBot", allow: "/" },
+      { userAgent: "PerplexityBot", allow: "/" },
+      { userAgent: "Google-Extended", allow: "/" },
+    ],
+    sitemap: "https://agents-compat.jstn.site/sitemap.xml",
+    host: "https://agents-compat.jstn.site",
+  };
+}

apps/docs/app/sitemap.ts

@@ -0,0 +1,11 @@
+import type { MetadataRoute } from "next";
+import { source } from "@/lib/source";
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  return source.getPages().map((page) => ({
+    url: `https://agents-compat.jstn.site${page.url}`,
+    lastModified: new Date(),
+    changeFrequency: "monthly",
+    priority: page.url === "/docs" ? 1 : 0.7,
+  }));
+}

apps/docs/content/docs/index.mdx

@@ -9,6 +9,8 @@ import { Cards, Card } from 'fumadocs-ui/components/card';
 
 `@jstn-sdk/agents` is a pure TypeScript SDK for cross-agent environment compatibility. Define your project once, generate native artifacts for each supported surface, and validate the result.
 
+<img src="/assets/banner.png" alt="Agent Compat cross-agent environment compatibility SDK" width="1254" height="314" style={{ width: '100%', height: 'auto', maxWidth: '760px', borderRadius: '8px' }} />
+
 <Cards>
   <Card title="Quickstart" href="/docs/quickstart" description="Install the package and compile your first manifest." />
   <Card title="Installation" href="/docs/installation" description="Set up npm, pnpm, or the GitHub Packages mirror." />

packages/agents/package.json

@@ -38,8 +38,8 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc --noEmit -p tsconfig.json",
-    "test": "pnpm build && tsc -p tsconfig.test.json && node --test dist-test/test/*.test.js",
-    "verify": "pnpm build && tsc -p tsconfig.test.json && node --test dist-test/test/conformance.test.js"
+    "test": "rm -rf dist-test && pnpm build && tsc -p tsconfig.test.json && node --test dist-test/test/*.test.js",
+    "verify": "rm -rf dist-test && pnpm build && tsc -p tsconfig.test.json && node --test dist-test/test/conformance.test.js"
   },
   "engines": {
     "node": ">=18"

public/googleb24d000c6a1cb7c4.html

@@ -0,0 +1 @@
+google-site-verification: googleb24d000c6a1cb7c4.html