[AAASM-3759] 🔧 (docs): Point node-sdk canonical/OG URLs to docs.agent-assembly.com

[Chisanan232]

Target

Docs now live at docs.agent-assembly.com, but the node-sdk Docusaurus site still emitted its canonical link and OpenGraph og:url against the old GitHub Pages origin (ai-agent-assembly.github.io/node-sdk/...). Search engines and link unfurlers were being pointed at the legacy mirror origin.

• Task summary:

  Repoint the Docusaurus url from https://ai-agent-assembly.github.io to https://docs.agent-assembly.com. Docusaurus derives the emitted <link rel="canonical"> and og:url from url + baseUrl, so this single change corrects both. baseUrl stays /node-sdk/ (the path the hub serves the module under), and in-site routing is baseUrl-relative, so the GitHub Pages deployment keeps working as a mirror.

• Task tickets:

  • Task ID: AAASM-3759.
  • Relative task IDs:
    • N/A.
  • Relative PRs:
    • N/A.

• Key point change (optional):

  As-is: <link rel=canonical href=https://ai-agent-assembly.github.io/node-sdk/...>
  To-be: <link rel=canonical href=https://docs.agent-assembly.com/node-sdk/...> (same for og:url).

Effecting Scope

• Action Types:
  • ✏️ Modifying existing something
    • 🟢 No breaking change
  • 🔧 Fixing bug
• Scopes:
  • 📚 Documentation
• Additional description:
  Only the docs canonical/OG origin is touched. Navbar/footer cross-SDK links still point at the per-site origins and are intentionally left out of scope.

Description

• website/docusaurus.config.ts: set url: "https://docs.agent-assembly.com" (was https://ai-agent-assembly.github.io); baseUrl unchanged (/node-sdk/).

Validation

• pnpm install --ignore-workspace + pnpm build of the Docusaurus site — build green (onBrokenLinks: "throw", onBrokenAnchors: "throw" both pass; no broken internal links).
• Grepped built HTML: all 249 pages now emit rel=canonical href=https://docs.agent-assembly.com/node-sdk/... and og:url content=https://docs.agent-assembly.com/node-sdk/.... Zero github.io occurrences in any canonical/og:url tag.
• Versioned-docs switcher / routing unaffected (only the absolute origin used for canonical/OG/sitemap changed; routing is baseUrl-driven).

🤖 Generated with Claude Code

https://claude.ai/code/session_01Cc1vBBiNxp9qLKQ5Gq85w8

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[Chisanan232]

✅ Claude Code review — APPROVE-ready

CI: all 18 checks green (build, test 18/20/22/24, napi-build, module-smoke, quality, audit, coverage, CodeQL, SonarCloud). No failures.

Scope vs AAASM-3759: matches exactly. Canonical + og:url now emit under docs.agent-assembly.com/node-sdk/... (all 249 built pages verified; 0 github.io canonical/og tags). Minimal one-line url change — the idiomatic Docusaurus mechanism (canonical/OG derive from url+baseUrl).

Side-effect check: no regression. baseUrl unchanged (/node-sdk/), so all routing stays base-relative and the GitHub Pages deployment keeps working as a mirror. url also feeds sitemap.xml + absolute OG image prefixes — pointing those at the canonical domain is the intended outcome, not a break. Built green under onBrokenLinks: throw / onBrokenAnchors: throw. Versioned-docs switcher untouched.

Out of scope (noted, not blocking): navbar/footer cross-SDK dropdown links still use *.github.io origins — a separate nav concern; can be a micro-follow-up if desired.

Ready to merge. — Claude Code