Skip to content

Commit fae522f

Browse files
christsochristso
authored
chore(beads): initialize public repo-local tracking (#438)
1 parent dd481d1 commit fae522f

6 files changed

Lines changed: 174 additions & 2 deletions

File tree

‎.beads/.gitignore‎

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
# Dolt database (managed by Dolt, not git)
2+
dolt/
3+
embeddeddolt/
4+
proxieddb/
5+
6+
# Generated local docs/export snapshots
7+
README.md
8+
issues.jsonl
9+
events.jsonl
10+
interactions.jsonl
11+
12+
# Runtime files
13+
bd.sock
14+
bd.sock.startlock
15+
sync-state.json
16+
last-touched
17+
.exclusive-lock
18+
19+
# Daemon runtime (lock, log, pid)
20+
daemon.*
21+
22+
# Push state (runtime, per-machine)
23+
push-state.json
24+
25+
# Lock files (various runtime locks)
26+
*.lock
27+
28+
# Credential key (encryption key for federation peer auth — never commit)
29+
.beads-credential-key
30+
31+
# Local version tracking (prevents upgrade notification spam after git ops)
32+
.local_version
33+
34+
proxied_server_client_info.json
35+
36+
# Worktree redirect file (contains relative path to main repo's .beads/)
37+
# Must not be committed as paths would be wrong in other clones
38+
redirect
39+
40+
# Sync state (local-only, per-machine)
41+
# These files are machine-specific and should not be shared across clones
42+
.sync.lock
43+
export-state/
44+
export-state.json
45+
last_pull
46+
47+
# Ephemeral store (SQLite - wisps/molecules, intentionally not versioned)
48+
ephemeral.sqlite3
49+
ephemeral.sqlite3-journal
50+
ephemeral.sqlite3-wal
51+
ephemeral.sqlite3-shm
52+
53+
# Dolt server management (auto-started by bd)
54+
dolt-server.pid
55+
dolt-server.log
56+
dolt-server.lock
57+
dolt-server.port
58+
dolt-server.activity
59+
60+
# Debug-mode pprof artifacts (written when dolt.debug: true in config.yaml)
61+
dolt-pprof/
62+
63+
# Corrupt backup directories (created by bd doctor --fix recovery)
64+
*.corrupt.backup/
65+
66+
# Backup data (auto-exported JSONL, local-only)
67+
backup/
68+
69+
# Per-project environment file (Dolt connection config, GH#2520)
70+
.env
71+
72+
# Legacy files (from pre-Dolt versions)
73+
*.db
74+
*.db?*
75+
*.db-journal
76+
*.db-wal
77+
*.db-shm
78+
db.sqlite
79+
bd.db
80+
# NOTE: Do NOT add negation patterns here.
81+
# They would override fork protection in .git/info/exclude.
82+
# Config files (metadata.json, config.yaml) are tracked by git by default
83+
# since no pattern above ignores them.

‎.beads/config.yaml‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
# Beads Configuration File
2+
# This file configures default behavior for all bd commands in this repository
3+
# All settings can also be set via environment variables (BD_* prefix)
4+
# or overridden with command-line flags
5+
6+
# Issue prefix for this repository (used by bd init)
7+
# If not set, bd init will auto-detect from directory name
8+
# Example: issue-prefix: "myproject" creates issues like "myproject-1", "myproject-2", etc.
9+
# issue-prefix: ""
10+
11+
# Use no-db mode: JSONL-only, no Dolt database
12+
# When true, .beads/issues.jsonl is the only local store
13+
# no-db: false
14+
15+
# Enable JSON output by default
16+
# json: false
17+
18+
# Feedback title formatting for mutating commands (create/update/close/dep/edit)
19+
# 0 = hide titles, N > 0 = truncate to N characters
20+
# output:
21+
# title-length: 255
22+
23+
# Default actor for audit trails (overridden by BEADS_ACTOR or --actor)
24+
# actor: ""
25+
26+
# Export events (audit trail) to .beads/events.jsonl on each flush/sync
27+
# When enabled, new events are appended incrementally using a high-water mark.
28+
# Use 'bd export --events' to trigger manually regardless of this setting.
29+
# events-export: false
30+
31+
# Multi-repo configuration (experimental - bd-307)
32+
# Allows hydrating from multiple repositories and routing writes to the correct database
33+
# repos:
34+
# primary: "." # Primary repo (where this database lives)
35+
# additional: # Additional repos to hydrate from (read-only)
36+
# - ~/beads-planning # Personal planning repo
37+
# - ~/work-planning # Work planning repo
38+
39+
# Dolt-native backup (periodic backup for off-machine recovery)
40+
# This is full database backup only. Cross-machine sync uses Dolt remotes.
41+
# backup:
42+
# enabled: false # Disable auto-backup entirely
43+
# interval: 15m # Minimum time between auto-backups
44+
# git-push: false # Disable git push (backup locally only)
45+
# git-repo: "" # Separate git repo for backups (default: project repo)
46+
47+
# Optional JSONL auto-export for viewers, interchange, and issue-level migration.
48+
# Disabled by default; enable only when an integration needs fresh .beads/issues.jsonl.
49+
# Use relative paths under .beads/ for JSONL import/export filenames.
50+
# export:
51+
# auto: false
52+
# path: issues.jsonl
53+
# interval: 60s
54+
# git-add: false
55+
# import:
56+
# path: issues.jsonl
57+
58+
# Integration settings (access with 'bd config get/set')
59+
# Non-secret keys (stored in the database):
60+
# - jira.url, jira.project
61+
# - linear.team_id
62+
# - github.org, github.repo
63+
#
64+
# Secret keys (stored in this file but prefer env vars to avoid git exposure):
65+
# - linear.api_key → use LINEAR_API_KEY env var instead
66+
# - github.token → use GITHUB_TOKEN env var instead
67+
68+
sync.remote: "git+https://github.com/EntityProcess/allagents"

‎.beads/metadata.json‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
{
2+
"database": "dolt",
3+
"backend": "dolt",
4+
"dolt_mode": "embedded",
5+
"dolt_database": "allagents",
6+
"project_id": "82b512b7-0232-45ba-94c5-448de92d1afc"
7+
}

‎.gitignore‎

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,8 +41,11 @@ temp/
4141
.worktrees/
4242
allagents.worktrees/
4343

44-
# Beads local Dolt database and runtime files
45-
.beads/
44+
# Beads / Dolt files
45+
.dolt/
46+
*.db
47+
.beads-credential-key
48+
.beads/proxieddb/
4649

4750
# Ralph runtime files (not config)
4851
.ralph/.call_count

‎AGENTS.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,10 @@ bun install
5757
- Temporary plans and design notes may live under `.claude/plans/` while work is in progress.
5858
- Once implementation is complete, delete stale plan files and update durable docs for any user-facing behavior changes.
5959

60+
### Beads
61+
- Run `bd bootstrap` after cloning if the local issue database is missing; do not re-run `bd init` for this already-initialized repository.
62+
- Beads syncs through the public AllAgents GitHub repository. Treat all issue content as public.
63+
6064
## PR & Commit Titles
6165
- Prefer conventional commit style for branch-facing titles: `type(scope): summary`.
6266
- Use the repository's normal types where they fit, such as `feat`, `fix`, `docs`, `style`, `refactor`, `test`, and `chore`.

‎CONTRIBUTING.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,13 @@ bun run dev workspace init test-ws
2727
bun run dev update
2828
```
2929

30+
## Issue Tracking
31+
32+
AllAgents uses repo-local Beads state synced through this public GitHub
33+
repository. After cloning, run `bd bootstrap` to download the issue database;
34+
do not run `bd init`, because the project identity is already tracked. Treat
35+
issue titles, descriptions, comments, and attachments as public data.
36+
3037
## Before Submitting a PR
3138

3239
- PR explains what changed and why

0 commit comments

Comments
 (0)