Marketing site rebuild — Astro + languages registry

[corvid-agent]

Summary

• Replaces the mdBook GitHub Pages site with an Astro + MDX marketing site featuring a sky-blue design system, dark background, and spec-sync branding.
• Adds a first-class Languages registry (/languages + /languages/{slug}) backed by 12 hand-authored per-language JSON files with detection rules, test patterns, and example specs.
• Migrates all existing mdBook docs into the new site under /docs (Getting started / Spec format / Reference / Integrations sections).
• Generates 1-step redirects from old mdBook URLs (/spec-sync/quickstart.html etc.) to new doc paths (/spec-sync/docs/quickstart).
• Replaces .github/workflows/docs.yml (mdBook) with pages.yml (Astro, push + workflow_dispatch — no weekly cron since the language registry is first-party data).
• Built using patterns established in fledge#398 with all known code-review findings applied upfront (BASE_URL trailing-slash helper, remark .md-strip plugin, stable cache keys, cross-ref fixes after section moves).

Spec: docs/superpowers/specs/2026-05-17-spec-sync-marketing-site-design.md
Plan: docs/superpowers/plans/2026-05-17-spec-sync-marketing-site.md

Preflight fixes (from fledge review findings)

• BASE_URL trailing-slash bug — site/src/lib/path.ts helper ensures every href gets /spec-sync/ not /spec-sync. All 12 component/page files updated.
• .md cross-links — remark plugin in astro.config.mjs strips .md from internal markdown links at build time.
• Section-move cross-refs — vscode-extension.md, github-action.md, ai-agents.md moved to integrations/; all referencing docs updated.
• Dead CTAs — Footer "Changelog" link updated to point at GitHub CHANGELOG.md (no in-site changelog page exists).
• Stable Pages workflow cache key — uses hashFiles() of language data, not ${{ github.run_id }}.

Test plan

• CI: bun test — all 21 tests pass across validate-languages and generate-doc-redirects suites
• CI: bun run lint — 0 errors, 0 warnings
• CI: bun run build — 34 pages built; 11 redirect files emitted
• Spot-check redirects: /spec-sync/quickstart.html and /spec-sync/cli.html present
• BASE_URL: no href="/spec-sync[a-z]" (no missing trailing slash)
• .md links: no href="[^"]*\.md" in dist/docs/
• Language pages: /languages, /languages/rust, /languages/typescript all render
• Docs navigation: sidebar renders correctly for all doc sections
• Blog and examples pages render
• mdBook tree (docs/src/, docs/book.toml, docs/theme/) is gone
• Old docs.yml workflow removed; new pages.yml present

🤖 Generated with Claude Code

[gemini-code-assist]

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

[github-actions]

✅ Corvin says...

      _
    <(^\  .oO(Caw! ^v^)
     |/(\
      \(\\
      " "\\

"Caw! Your code sparkles like a dropped french fry."

CI Summary

Check	Status
Validate action.yml	✅ Passed
Dependency Audit	✅ Passed
Code Coverage	✅ Passed
Format Check	✅ Passed
Spec Validation	✅ Passed
Tests (build, test, clippy)	✅ Passed

📋 Spec Validation Details

✅ SpecSync: Passed

Metric	Value
Specs checked	57
Passed	57
Errors	0
Warnings	0
File coverage	97% (73/75)
LOC coverage	98% (32592/32952)

Unspecced Files

The following source files have no spec coverage:

• src/exports/ast/tests.rs
• src/util.rs

Run specsync generate to scaffold specs for these files.

---

Generated by specsync · Run specsync check --format github to reproduce

---

_{Powered by corvid-pet}

Superseded by updated review.

[github-actions]

✅ Corvin says...

      _
    <(^\  .oO(Caw! ^v^)
     |/(\
      \(\\
      " "\\

"Looking sharp! Like a beak should be."

CI Summary

Check	Status
Validate action.yml	✅ Passed
Dependency Audit	✅ Passed
Code Coverage	✅ Passed
Format Check	✅ Passed
Spec Validation	✅ Passed
Tests (build, test, clippy)	✅ Passed

📋 Spec Validation Details

✅ SpecSync: Passed

Metric	Value
Specs checked	57
Passed	57
Errors	0
Warnings	0
File coverage	97% (73/75)
LOC coverage	98% (32592/32952)

Unspecced Files

The following source files have no spec coverage:

• src/exports/ast/tests.rs
• src/util.rs

Run specsync generate to scaffold specs for these files.

---

Generated by specsync · Run specsync check --format github to reproduce

---

_{Powered by corvid-pet}

[github-actions]

✅ Corvin says...

      _
    <(^\  .oO(Caw! ^v^)
     |/(\
      \(\\
      " "\\

"Caw! Found a shiny new spec!"

CI Summary

Check	Status
Validate action.yml	✅ Passed
Dependency Audit	✅ Passed
Code Coverage	✅ Passed
Format Check	✅ Passed
Spec Validation	✅ Passed
Tests (build, test, clippy)	✅ Passed

📋 Spec Validation Details

✅ SpecSync: Passed

Metric	Value
Specs checked	57
Passed	57
Errors	0
Warnings	0
File coverage	97% (73/75)
LOC coverage	98% (32592/32952)

Unspecced Files

The following source files have no spec coverage:

• src/exports/ast/tests.rs
• src/util.rs

Run specsync generate to scaffold specs for these files.

---

Generated by specsync · Run specsync check --format github to reproduce

---

_{Powered by corvid-pet}