* docs: publish community tools on website
Mirror docs/COMMUNITY_TOOLS.md into Docusaurus so the Pages build publishes it for the default released docs and unreleased docs without relying on manual copy steps.
Agent-Signature: codex-gpt-5.5-high on behalf of matt wilkie
* docs: publish core support docs on website
Mirror Sync Concepts, Labels, Metadata, Uninstalling, and Antivirus docs into Docusaurus and include them in the default released snapshot and LLM bundle.
Clarify that agent execution and verification metadata are examples of metadata as a schema extension point, not native issue fields.
Agent-Signature: codex-gpt-5.5-high on behalf of matt wilkie
* docs: clarify metadata examples
Replace local verification queue metadata with a tracker round-trip example so public metadata docs show upstream-aligned schema extension patterns.
Agent-Signature: codex-gpt-5.5-high on behalf of matt wilkie
---------
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