Commit 56f17344 authored by Jan Reimes's avatar Jan Reimes
Browse files

chore: update hooks and documentation for improved integration 

* Update integration version in hooks to v0.62.0
* Increase timeout for hooks execution to 300 seconds
* Modify SKILL.md to clarify version control commands
* Add .beads-credential-key to .gitignore for security
parent 3f6dcca2

.agents/skills/cli-bd/SKILL.md

+9 −8
Original line number Diff line number Diff line
@@ -60,13 +60,13 @@ bd update bd-42 --priority 1 --json 
bd close bd-42 --reason "Completed" --json

```



### Sync (CRITICAL at end of session!)

### Commit (CRITICAL at end of session!)



```bash

bd sync

bd vc commit -m "session changes"

```



Flushes changes to git immediately. Always run at end of work session.

Commits changes to Dolt immediately. Always run at end of work session.



## Why bd?
@@ -100,13 +100,14 @@ Flushes changes to git immediately. Always run at end of work session. 
   - `bd create "Found bug" --description="Details about what was found" -p 1 --deps discovered-from:<parent-id>`

5. **Complete**: `bd close <id> --reason "Done"`



## Auto-Sync

## Version Control



bd automatically syncs via Dolt:

bd uses Dolt for version control:



- **Commit changes:** `bd vc commit -m "message"`

- **Push to remote:** `bd vc push`

- **Pull from remote:** `bd vc pull`

- Each write auto-commits to Dolt history

- Use `bd dolt push`/`bd dolt pull` for remote sync

- No manual export/import needed!



## Important Rules
@@ -114,7 +115,7 @@ bd automatically syncs via Dolt: 
- ✅ Always use `--json` flag for programmatic use

- ✅ Link discovered work with `discovered-from` dependencies

- ✅ Check `bd ready` before asking "what should I work on?"

- ✅ Run `bd sync` at end of session

- ✅ Run `bd vc commit -m "session changes"` at end of session

- ✅ Test with `BEADS_DB=/tmp/test.db` (don't create test issues in production)

- ❌ Do NOT create markdown TODO lists

- ❌ Do NOT use external issue trackers

.beads/.gitignore

+7 −1
Original line number Diff line number Diff line
@@ -8,7 +8,6 @@ bd.sock.startlock 
sync-state.json

last-touched

.exclusive-lock

.beads-credential-key



# Daemon runtime (lock, log, pid)

daemon.*
@@ -22,6 +21,9 @@ push-state.json 
# Lock files (various runtime locks)

*.lock



# Credential key (encryption key for federation peer auth — never commit)

.beads-credential-key



# Local version tracking (prevents upgrade notification spam after git ops)

.local_version
@@ -45,6 +47,7 @@ dolt-server.pid 
dolt-server.log

dolt-server.lock

dolt-server.port

dolt-server.activity



# Corrupt backup directories (created by bd doctor --fix recovery)

*.corrupt.backup/
@@ -52,6 +55,9 @@ dolt-server.port 
# Backup data (auto-exported JSONL, local-only)

backup/



# Per-project environment file (Dolt connection config, GH#2520)

.env



# Legacy files (from pre-Dolt versions)

*.db

*.db?*

.beads/hooks/post-checkout

+3 −3
Original line number Diff line number Diff line 
#!/usr/bin/env sh

# --- BEGIN BEADS INTEGRATION v0.61.0 ---

# --- BEGIN BEADS INTEGRATION v0.62.0 ---

# This section is managed by beads. Do not remove these markers.

if command -v bd >/dev/null 2>&1; then

  export BD_GIT_HOOK=1

  _bd_timeout=${BEADS_HOOK_TIMEOUT:-30}

  _bd_timeout=${BEADS_HOOK_TIMEOUT:-300}

  if command -v timeout >/dev/null 2>&1; then

    timeout "$_bd_timeout" bd hooks run post-checkout "$@"

    _bd_exit=$?
@@ -21,4 +21,4 @@ if command -v bd >/dev/null 2>&1; then 
  fi

  if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi

fi

# --- END BEADS INTEGRATION v0.61.0 ---
 
# --- END BEADS INTEGRATION v0.62.0 ---

.beads/hooks/post-merge

+3 −3
Original line number Diff line number Diff line 
#!/usr/bin/env sh

# --- BEGIN BEADS INTEGRATION v0.61.0 ---

# --- BEGIN BEADS INTEGRATION v0.62.0 ---

# This section is managed by beads. Do not remove these markers.

if command -v bd >/dev/null 2>&1; then

  export BD_GIT_HOOK=1

  _bd_timeout=${BEADS_HOOK_TIMEOUT:-30}

  _bd_timeout=${BEADS_HOOK_TIMEOUT:-300}

  if command -v timeout >/dev/null 2>&1; then

    timeout "$_bd_timeout" bd hooks run post-merge "$@"

    _bd_exit=$?
@@ -21,4 +21,4 @@ if command -v bd >/dev/null 2>&1; then 
  fi

  if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi

fi

# --- END BEADS INTEGRATION v0.61.0 ---
 
# --- END BEADS INTEGRATION v0.62.0 ---

.beads/hooks/pre-commit

+3 −3
Original line number Diff line number Diff line 
#!/usr/bin/env sh

# --- BEGIN BEADS INTEGRATION v0.61.0 ---

# --- BEGIN BEADS INTEGRATION v0.62.0 ---

# This section is managed by beads. Do not remove these markers.

if command -v bd >/dev/null 2>&1; then

  export BD_GIT_HOOK=1

  _bd_timeout=${BEADS_HOOK_TIMEOUT:-30}

  _bd_timeout=${BEADS_HOOK_TIMEOUT:-300}

  if command -v timeout >/dev/null 2>&1; then

    timeout "$_bd_timeout" bd hooks run pre-commit "$@"

    _bd_exit=$?
@@ -21,4 +21,4 @@ if command -v bd >/dev/null 2>&1; then 
  fi

  if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi

fi

# --- END BEADS INTEGRATION v0.61.0 ---
 
# --- END BEADS INTEGRATION v0.62.0 ---