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:
74
website/docs/recovery/sync-failures.md
Normal file
74
website/docs/recovery/sync-failures.md
Normal file
@@ -0,0 +1,74 @@
|
||||
---
|
||||
sidebar_position: 5
|
||||
title: Sync Failures
|
||||
description: Recover from bd sync failures
|
||||
---
|
||||
|
||||
# Sync Failures Recovery
|
||||
|
||||
This runbook helps you recover from `bd sync` failures.
|
||||
|
||||
## Symptoms
|
||||
|
||||
- `bd sync` hangs or times out
|
||||
- Network-related error messages
|
||||
- "failed to push" or "failed to pull" errors
|
||||
- Daemon not responding
|
||||
|
||||
## Diagnosis
|
||||
|
||||
```bash
|
||||
# Check daemon status
|
||||
bd daemon status
|
||||
|
||||
# Check sync state
|
||||
bd status
|
||||
|
||||
# View daemon logs
|
||||
cat .beads/daemon.log | tail -50
|
||||
```
|
||||
|
||||
## Solution
|
||||
|
||||
**Step 1:** Stop the daemon
|
||||
```bash
|
||||
bd daemon stop
|
||||
```
|
||||
|
||||
**Step 2:** Check for lock files
|
||||
```bash
|
||||
ls -la .beads/*.lock
|
||||
# Remove stale locks if daemon is definitely stopped
|
||||
rm -f .beads/*.lock
|
||||
```
|
||||
|
||||
**Step 3:** Force a fresh sync
|
||||
```bash
|
||||
bd doctor --fix
|
||||
```
|
||||
|
||||
**Step 4:** Restart daemon
|
||||
```bash
|
||||
bd daemon start
|
||||
```
|
||||
|
||||
**Step 5:** Verify sync works
|
||||
```bash
|
||||
bd sync
|
||||
bd status
|
||||
```
|
||||
|
||||
## Common Causes
|
||||
|
||||
| Cause | Solution |
|
||||
|-------|----------|
|
||||
| Network timeout | Retry with better connection |
|
||||
| Stale lock file | Remove lock after stopping daemon |
|
||||
| Corrupted state | Use `bd doctor --fix` |
|
||||
| Git conflicts | See [Merge Conflicts](/recovery/merge-conflicts) |
|
||||
|
||||
## Prevention
|
||||
|
||||
- Ensure stable network before sync
|
||||
- Let sync complete before closing terminal
|
||||
- Use `bd daemon stop` before system shutdown
|
||||
Reference in New Issue
Block a user