From a12a3200a4d76756667bbf808546f9b7af6c5fda Mon Sep 17 00:00:00 2001 From: Christopher Tso Date: Sun, 21 Jun 2026 05:53:20 +0200 Subject: [PATCH 1/4] fix(beads): track safe workspace defaults --- .beads/.gitignore | 65 ++++++++++++++++++++++++++++++++++++++++++++++ .beads/config.yaml | 6 +++++ .gitignore | 7 +++-- AGENTS.md | 2 ++ 4 files changed, 78 insertions(+), 2 deletions(-) create mode 100644 .beads/.gitignore create mode 100644 .beads/config.yaml diff --git a/.beads/.gitignore b/.beads/.gitignore new file mode 100644 index 0000000..3d7ff10 --- /dev/null +++ b/.beads/.gitignore @@ -0,0 +1,65 @@ +# Dolt database and runtime state managed by bd, not git +dolt/ +embeddeddolt/ +proxieddb/ +dolt-access.lock + +# Checkout-local identity. `bd bootstrap` recreates this per checkout. +metadata.json + +# Generated local docs/export snapshots +README.md +issues.jsonl +events.jsonl + +# Runtime files +bd.sock +bd.sock.startlock +sync-state.json +last-touched +.exclusive-lock +daemon.* +interactions.jsonl +push-state.json +*.lock + +# Credentials and local version tracking +.beads-credential-key +.local_version +proxied_server_client_info.json + +# Worktree redirect and sync state +redirect +.sync.lock +export-state/ +export-state.json + +# Ephemeral store +ephemeral.sqlite3 +ephemeral.sqlite3-journal +ephemeral.sqlite3-wal +ephemeral.sqlite3-shm + +# Dolt server management +dolt-server.pid +dolt-server.log +dolt-server.lock +dolt-server.port +dolt-server.activity +dolt-pprof/ + +# Recovery and backup data +*.corrupt.backup/ +backup/ + +# Per-project environment file +.env + +# Legacy files +*.db +*.db?* +*.db-journal +*.db-wal +*.db-shm +db.sqlite +bd.db diff --git a/.beads/config.yaml b/.beads/config.yaml new file mode 100644 index 0000000..8f3d263 --- /dev/null +++ b/.beads/config.yaml @@ -0,0 +1,6 @@ +# Beads Configuration File +# This file configures default behavior for bd commands in this repository. +# Runtime identity and database state stay checkout-local and ignored. + +federation.remote: "git+https://github.com/EntityProcess/allagents-beads.git" +sync.remote: "git+https://github.com/EntityProcess/allagents-beads.git" diff --git a/.gitignore b/.gitignore index 161f06a..37b6310 100644 --- a/.gitignore +++ b/.gitignore @@ -41,8 +41,11 @@ temp/ .worktrees/ allagents.worktrees/ -# Beads local Dolt database and runtime files -.beads/ +# Beads repo-owned defaults plus ignored runtime files +.beads/* +!.beads/ +!.beads/.gitignore +!.beads/config.yaml # Ralph runtime files (not config) .ralph/.call_count diff --git a/AGENTS.md b/AGENTS.md index fae9b13..d7b0ca2 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -9,6 +9,8 @@ AllAgents should stay predictable, scriptable, and safe for users who manage rea - Prefer straightforward filesystem transforms over hidden state. - Make sync/install/update behavior easy to reason about from CLI output alone. - Preserve user-owned config where ownership boundaries matter. +- AllAgents code lives in `EntityProcess/allagents`; Beads coordination data lives in `EntityProcess/allagents-beads`. +- Track only repo-owned Beads defaults such as `.beads/config.yaml` and `.beads/.gitignore`; never commit `.beads/metadata.json`, embedded Dolt data, JSONL exports, locks, logs, backups, or other checkout-local runtime state. ## Working Style From d65b838e3362ab0a9de622e525eb6571290e1adb Mon Sep 17 00:00:00 2001 From: Christopher Tso Date: Sun, 21 Jun 2026 06:58:58 +0200 Subject: [PATCH 2/4] docs(beads): point agents to global skill --- AGENTS.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index d7b0ca2..dabbf1b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -9,8 +9,7 @@ AllAgents should stay predictable, scriptable, and safe for users who manage rea - Prefer straightforward filesystem transforms over hidden state. - Make sync/install/update behavior easy to reason about from CLI output alone. - Preserve user-owned config where ownership boundaries matter. -- AllAgents code lives in `EntityProcess/allagents`; Beads coordination data lives in `EntityProcess/allagents-beads`. -- Track only repo-owned Beads defaults such as `.beads/config.yaml` and `.beads/.gitignore`; never commit `.beads/metadata.json`, embedded Dolt data, JSONL exports, locks, logs, backups, or other checkout-local runtime state. +- If using Beads, follow the global Beads skill. Commit only repo-owned `.beads/config.yaml` and `.beads/.gitignore`; never commit `.beads/metadata.json` or Beads runtime state. ## Working Style From 636aeb0585db93cfc941add581d6553838cd2b05 Mon Sep 17 00:00:00 2001 From: Christopher Tso Date: Sun, 21 Jun 2026 08:52:16 +0200 Subject: [PATCH 3/4] chore(beads): keep live config local --- .beads/.gitignore | 3 ++- .beads/{config.yaml => config.yaml.example} | 2 ++ .gitignore | 4 ++-- AGENTS.md | 2 +- 4 files changed, 7 insertions(+), 4 deletions(-) rename .beads/{config.yaml => config.yaml.example} (72%) diff --git a/.beads/.gitignore b/.beads/.gitignore index 3d7ff10..b6768db 100644 --- a/.beads/.gitignore +++ b/.beads/.gitignore @@ -4,7 +4,8 @@ embeddeddolt/ proxieddb/ dolt-access.lock -# Checkout-local identity. `bd bootstrap` recreates this per checkout. +# Checkout-local config and identity. Copy config.yaml.example when using Beads. +config.yaml metadata.json # Generated local docs/export snapshots diff --git a/.beads/config.yaml b/.beads/config.yaml.example similarity index 72% rename from .beads/config.yaml rename to .beads/config.yaml.example index 8f3d263..f3386d2 100644 --- a/.beads/config.yaml +++ b/.beads/config.yaml.example @@ -1,4 +1,6 @@ # Beads Configuration File +# Copy this file to .beads/config.yaml when using Beads in this checkout. +# Keep .beads/config.yaml local; do not commit it. # This file configures default behavior for bd commands in this repository. # Runtime identity and database state stay checkout-local and ignored. diff --git a/.gitignore b/.gitignore index 37b6310..2a31875 100644 --- a/.gitignore +++ b/.gitignore @@ -41,11 +41,11 @@ temp/ .worktrees/ allagents.worktrees/ -# Beads repo-owned defaults plus ignored runtime files +# Beads local config and runtime files .beads/* !.beads/ !.beads/.gitignore -!.beads/config.yaml +!.beads/config.yaml.example # Ralph runtime files (not config) .ralph/.call_count diff --git a/AGENTS.md b/AGENTS.md index dabbf1b..b3079b8 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -9,7 +9,7 @@ AllAgents should stay predictable, scriptable, and safe for users who manage rea - Prefer straightforward filesystem transforms over hidden state. - Make sync/install/update behavior easy to reason about from CLI output alone. - Preserve user-owned config where ownership boundaries matter. -- If using Beads, follow the global Beads skill. Commit only repo-owned `.beads/config.yaml` and `.beads/.gitignore`; never commit `.beads/metadata.json` or Beads runtime state. +- If using Beads, follow the global Beads skill. Commit only repo-owned `.beads/config.yaml.example` and `.beads/.gitignore`; keep `.beads/config.yaml`, `.beads/metadata.json`, and Beads runtime state local. ## Working Style From f98675109de14e8f2401df768d4e44687b3e9514 Mon Sep 17 00:00:00 2001 From: Christopher Tso Date: Sun, 21 Jun 2026 09:15:50 +0200 Subject: [PATCH 4/4] docs(beads): keep guidance in shared skill --- AGENTS.md | 1 - 1 file changed, 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index b3079b8..fae9b13 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -9,7 +9,6 @@ AllAgents should stay predictable, scriptable, and safe for users who manage rea - Prefer straightforward filesystem transforms over hidden state. - Make sync/install/update behavior easy to reason about from CLI output alone. - Preserve user-owned config where ownership boundaries matter. -- If using Beads, follow the global Beads skill. Commit only repo-owned `.beads/config.yaml.example` and `.beads/.gitignore`; keep `.beads/config.yaml`, `.beads/metadata.json`, and Beads runtime state local. ## Working Style