From c2b1fba6224f5c28847e04fff84a4119b218f07e Mon Sep 17 00:00:00 2001
From: Christopher Tso <christso@gmail.com>
Date: Wed, 3 Jun 2026 10:43:38 +0200
Subject: [PATCH] chore(beads): track shared bead state

---
 .beads/.gitignore    | 40 ++++++++++++++++++++++++++++++++++++++++
 .beads/README.md     | 18 ++++++++++++++++++
 .beads/config.yaml   |  2 ++
 .beads/issues.jsonl  |  0
 .beads/metadata.json |  4 ++++
 .gitignore           |  8 ++++++--
 biome.json           |  1 +
 7 files changed, 71 insertions(+), 2 deletions(-)
 create mode 100644 .beads/.gitignore
 create mode 100644 .beads/README.md
 create mode 100644 .beads/config.yaml
 create mode 100644 .beads/issues.jsonl
 create mode 100644 .beads/metadata.json

diff --git a/.beads/.gitignore b/.beads/.gitignore
new file mode 100644
index 000000000..3c1cd9169
--- /dev/null
+++ b/.beads/.gitignore
@@ -0,0 +1,40 @@
+# SQLite databases
+*.db
+*.db?*
+*.db-journal
+*.db-wal
+*.db-shm
+
+# Local history and recovery
+.br_history/
+.br_recovery/
+
+# Local version tracking
+.local_version
+
+# Runtime files
+*.lock
+*.tmp
+*.sock
+daemon.lock
+daemon.log
+daemon.pid
+last-touched
+redirect
+sync-state.json
+
+# Sync state and merge artifacts
+.sync.lock
+beads.base.jsonl
+beads.base.meta.json
+beads.left.jsonl
+beads.left.meta.json
+beads.right.jsonl
+beads.right.meta.json
+sync_base.jsonl
+
+# bv lock file
+.bv.lock
+
+# NOTE: Do not add negation patterns here.
+# JSONL files and config files are tracked by git by default because no pattern above ignores them.
diff --git a/.beads/README.md b/.beads/README.md
new file mode 100644
index 000000000..e414b5feb
--- /dev/null
+++ b/.beads/README.md
@@ -0,0 +1,18 @@
+# Beads
+
+AgentV uses Beads for repo-local task tracking.
+
+Use `br` for all Beads operations in this repository:
+
+```bash
+br ready --json
+br list --json
+br show <issue-id> --json
+br update <issue-id> --claim --json
+br close <issue-id> --reason "Completed" --json
+br sync --flush-only
+```
+
+The durable task graph is tracked as JSONL in `.beads/issues.jsonl`. Local SQLite
+databases, locks, history, and merge scratch files are ignored and should not be
+committed.
diff --git a/.beads/config.yaml b/.beads/config.yaml
new file mode 100644
index 000000000..d79d13942
--- /dev/null
+++ b/.beads/config.yaml
@@ -0,0 +1,2 @@
+# Beads Project Configuration
+issue_prefix: agentv
diff --git a/.beads/issues.jsonl b/.beads/issues.jsonl
new file mode 100644
index 000000000..e69de29bb
diff --git a/.beads/metadata.json b/.beads/metadata.json
new file mode 100644
index 000000000..f581edc0d
--- /dev/null
+++ b/.beads/metadata.json
@@ -0,0 +1,4 @@
+{
+  "database": "beads.db",
+  "jsonl_export": "issues.jsonl"
+}
diff --git a/.gitignore b/.gitignore
index fe8ad9cf8..dcbed42c7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -30,8 +30,12 @@ agent-orchestrator.yaml
 .opencode/
 .ao/
 
-# Gas Town (added by gt)
-.beads/
+# Gas Town / Beads shared state
+.beads/.br_history/
+.beads/.bv.lock
 .runtime/
 .logs/
 state.json
+
+# bv (beads viewer) local config and caches
+.bv/
diff --git a/biome.json b/biome.json
index 5e9695a97..7d2835426 100644
--- a/biome.json
+++ b/biome.json
@@ -40,6 +40,7 @@
       "**/.agentv/**",
       ".claude/**",
       ".opencode/**",
+      ".beads/**",
       ".entire/**",
       ".worktrees/**",
       "**/.astro/**",