feat: add llms.txt standard support for AI agent discoverability (#784)
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
This commit is contained in:
45
website/docs/recovery/index.md
Normal file
45
website/docs/recovery/index.md
Normal file
@@ -0,0 +1,45 @@
|
||||
---
|
||||
sidebar_position: 1
|
||||
title: Recovery Overview
|
||||
description: Diagnose and resolve common Beads issues
|
||||
---
|
||||
|
||||
# Recovery Overview
|
||||
|
||||
This section provides step-by-step recovery procedures for common Beads issues. Each runbook follows a consistent format: Symptoms, Diagnosis, Solution (5 steps max), and Prevention.
|
||||
|
||||
## Common Issues
|
||||
|
||||
| Issue | Symptoms | Runbook |
|
||||
|-------|----------|---------|
|
||||
| Database Corruption | SQLite errors, missing data | [Database Corruption](/recovery/database-corruption) |
|
||||
| Merge Conflicts | JSONL conflicts during sync | [Merge Conflicts](/recovery/merge-conflicts) |
|
||||
| Circular Dependencies | Cycle detection errors | [Circular Dependencies](/recovery/circular-dependencies) |
|
||||
| Sync Failures | `bd sync` errors | [Sync Failures](/recovery/sync-failures) |
|
||||
|
||||
## Quick Diagnostic
|
||||
|
||||
Before diving into specific runbooks, try these quick checks:
|
||||
|
||||
```bash
|
||||
# Check Beads status
|
||||
bd status
|
||||
|
||||
# Verify daemon is running
|
||||
bd daemon status
|
||||
|
||||
# Check for blocked issues
|
||||
bd blocked
|
||||
```
|
||||
|
||||
:::tip
|
||||
Most issues can be diagnosed with `bd status`. Start there before following specific runbooks.
|
||||
:::
|
||||
|
||||
## Getting Help
|
||||
|
||||
If these runbooks don't resolve your issue:
|
||||
|
||||
1. Check the [FAQ](/reference/faq)
|
||||
2. Search [existing issues](https://github.com/steveyegge/beads/issues)
|
||||
3. Open a new issue with diagnostic output
|
||||
Reference in New Issue
Block a user