Docusaurus is configured with `trailingSlash: false`, which emits
`installation.html` etc. rather than `installation/index.html`. The
rendered HTML, however, uses extensionless links like
`/beads/getting-started/installation`. In offline mode lychee resolves
those literally against `website/link-check-root/` and reports them as
missing files.
Adding `--fallback-extensions html` tells lychee to retry with the
`.html` suffix when a bare-path target is not found, matching how the
deployed GitHub Pages site actually serves these URLs.
Verified locally: lychee reported 26,877 link errors before this change
and 0 after. Restores the Deploy Documentation workflow which has been
red on main since 2026-04-07.
The previous --remap approach didn't work because lychee resolves file://
URIs directly against the filesystem, ignoring remaps.
Instead, create a wrapper directory with a symlink:
website/link-check-root/beads → website/build
This makes --root-dir website/link-check-root resolve /beads/foo to
website/link-check-root/beads/foo → website/build/foo correctly.
The symlink is outside website/build, so it doesn't affect the Pages
artifact upload.
Amp-Thread-ID: https://ampcode.com/threads/T-019d68c4-3efa-71bf-aa9d-6e25fc48fb9a
Co-authored-by: Amp <amp@ampcode.com>
After the repo transfer, all release, deploy, and publishing workflows
were silently skipped because the repository guards still referenced
the old org. Updates 6 conditional checks across 3 workflow files.
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Guard deploy-docs job to only run in canonical repository
- Guard goreleaser job to only run in canonical repository
- Guard update-homebrew job to only run in canonical repository
- Guard test-pypi job to only run in canonical repository
Prevents fork workflows from attempting to deploy, release, or publish to external services.
Cherry-picked website/, scripts/generate-llms-full.sh, and deploy-docs.yml
from joyshmitz's PR. Fixed workflow to trigger on main branch instead of
docs/docusaurus-site.
Features:
- Docusaurus documentation site with llms.txt support
- Environment-variable driven config (defaults to steveyegge org)
- Automated llms-full.txt generation from docs
- GitHub Pages deployment workflow
Co-authored-by: joyshmitz <joyshmitz@users.noreply.github.com>
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Executed-By: beads/crew/dave
Rig: beads
Role: crew