GH#50: Make Beads Dolt history recoverable

[marcusquinn]

Summary

• Track the shared Beads database identity and Dolt remote configuration.
• Keep database/runtime files and JSONL exports out of normal source commits.
• Disable automatic git add because canonical worktrees are intentionally read-only.

Context

The existing Beads database was pushed successfully to the repository's refs/dolt/data, but a clean clone selected the default database name beads and recovered zero issues. Tracking .beads/metadata.json makes bootstrap select the existing buzz database; .beads/config.yaml supplies the existing GitHub origin as the Dolt remote.

Verification

• bash test/package-test.sh
• git diff --check
• Fresh GitHub branch clone: bd bootstrap --yes
• Fresh clone: bd show buzz-ve9 recovered the closed task from refs/dolt/data
• Source branch remains clean; only shared Beads configuration is tracked

Resolves #50

Beads: buzz-ve9

---

aidevops.sh v3.32.209 plugin for OpenCode v1.18.9 with gpt-5.6-sol spent 14h 48m and 2,350,241 tokens on this with the user in an interactive session.

Summary by CodeRabbit

• Chores
  • Added standardized project configuration for shared synchronization and local data handling.
  • Improved repository hygiene by excluding local databases, credentials, temporary files, runtime artifacts, and exported data from version control.
  • Preserved essential project configuration files so setup remains consistent across environments.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 174272a1-e17b-4421-9cb5-b38e3c084887

📥 Commits

Reviewing files that changed from the base of the PR and between 2607442 and ce475b8.

📒 Files selected for processing (4)

• .beads/.gitignore
• .beads/config.yaml
• .beads/metadata.json
• .gitignore

---

📝 Walkthrough

Walkthrough

Changes

Beads Dolt recovery

Layer / File(s)	Summary
Beads bootstrap settings .beads/metadata.json, .beads/config.yaml	The repository now records the buzz embedded Dolt database identity and remote synchronization settings.
Beads tracking rules .gitignore, .beads/.gitignore	Git tracks the shared Beads configuration files and ignores local database state, runtime files, credentials, and JSONL exports.

Estimated code review effort: 1 (Trivial) | ~5 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly identifies the issue and the primary change: making Beads Dolt history recoverable.
Linked Issues check	✅ Passed	The changes add the required Beads metadata, Dolt remote configuration, and ignore rules for recoverable history.
Out of Scope Changes check	✅ Passed	All changes support the linked issue by configuring shared Beads files and excluding local database artifacts.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/auto-20260801-171623

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}