[kvlonge]

Why

sqlbuild.com only redirected to the Mintlify docs, and the docs lived in a separate repository. This adds a real landing page for "the refactorable warehouse" and moves the docs into this repository as one site, styled to match the SQLBuild UI.

Changes

• website/: one Astro Starlight site. The homepage is at / (static HTML, real sqb output) and the docs at /docs/, ported from the Mintlify docs with a custom layout, Pagefind search and generated llms.txt.
• Virtual environments removed from the docs; new docs intro; SQLBuild rule conventions for SQBRSQL040 and SQBRSQL041 moved from the old docs/ folder.
• Removed the legacy docs/ folder and internal ticket references; README and runtime READMEs now link to the website docs.
• website/examples/: the projects behind the landing page output.
• CI: website.yml builds the site, checks every internal link and deploys to GitHub Pages from main. verify.yml skips the Python checks and test suites when a pull request only changes website/; ruff excludes website/.

Verification

• npm run build and scripts/check_links.py: 107 pages, 0 broken links.
• Tested the verify.yml scope classification against six changed-path sets and the gate against six result combinations.
• ruff check ., ruff format --check . and uv lock --check pass.
• Compared the docs with Mintlify page by page in both themes and on mobile.