docs: track work in Gitea issues instead of beads
Every one of the 1709 tracker issues was created in Gitea and checked field by field against its source record: title, body, state, label set, assignee, comments, dependency edges and epic label. All 1729 beads are closed, citing the issue that carries each one, and .beads is removed. Three differences are deliberate: Gitea truncates titles at 253 characters, so three long titles keep their full text in the issue body; Gitea refuses a mutual dependency, so five symmetric relates-to links exist in one direction; issue 497 carries its fix from e3b1103f.
This commit is contained in:
1 parent
dfb37fb4f2
commit
ec9bf5feb2
19 files changed
+42
-471
No files matched your search
@@ -1,89 +0,0 @@
|
|||||||
# Dolt database (managed by Dolt, not git)
|
|
||||||
dolt/
|
|
||||||
embeddeddolt/
|
|
||||||
proxieddb/
|
|
||||||
|
|
||||||
# Runtime files
|
|
||||||
bd.sock
|
|
||||||
bd.sock.startlock
|
|
||||||
sync-state.json
|
|
||||||
last-touched
|
|
||||||
.exclusive-lock
|
|
||||||
|
|
||||||
# Daemon runtime (lock, log, pid)
|
|
||||||
daemon.*
|
|
||||||
|
|
||||||
# Push state (runtime, per-machine)
|
|
||||||
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
|
|
||||||
|
|
||||||
proxied_server_client_info.json
|
|
||||||
|
|
||||||
# Worktree redirect file (contains relative path to main repo's .beads/)
|
|
||||||
# Must not be committed as paths would be wrong in other clones
|
|
||||||
redirect
|
|
||||||
|
|
||||||
# Sync state (local-only, per-machine)
|
|
||||||
# These files are machine-specific and should not be shared across clones
|
|
||||||
.sync.lock
|
|
||||||
|
|
||||||
# Workspace operation gate (internal/workspacegate): physical-root gate
|
|
||||||
# files live beside the guarded root inside .beads (e.g. dolt.gate.lock)
|
|
||||||
*.gate.lock*
|
|
||||||
export-state/
|
|
||||||
export-state.json
|
|
||||||
last_pull
|
|
||||||
|
|
||||||
# Ephemeral store (SQLite - wisps/molecules, intentionally not versioned)
|
|
||||||
ephemeral.sqlite3
|
|
||||||
ephemeral.sqlite3-journal
|
|
||||||
ephemeral.sqlite3-wal
|
|
||||||
ephemeral.sqlite3-shm
|
|
||||||
|
|
||||||
# Dolt server management (auto-started by bd)
|
|
||||||
dolt-server.pid
|
|
||||||
dolt-server.log
|
|
||||||
dolt-server.lock
|
|
||||||
dolt-server.port
|
|
||||||
dolt-server.activity
|
|
||||||
|
|
||||||
# Debug-mode pprof artifacts (written when dolt.debug: true in config.yaml)
|
|
||||||
dolt-pprof/
|
|
||||||
|
|
||||||
# Corrupt backup directories (created by bd doctor --fix recovery)
|
|
||||||
*.corrupt.backup/
|
|
||||||
|
|
||||||
# issues.jsonl is deliberately TRACKED (see export.git-add in config.yaml).
|
|
||||||
# Dolt remains the authoritative store and GitHub the external issue surface;
|
|
||||||
# the tracked export exists so issue state is readable and recoverable from a
|
|
||||||
# plain git clone, without a Dolt server. Removing it from this file is what
|
|
||||||
# tracks it -- do NOT add a "!issues.jsonl" negation, which would override the
|
|
||||||
# fork protection in .git/info/exclude (see the note at the end of this file).
|
|
||||||
#
|
|
||||||
# Backups stay local: they are point-in-time copies of the same data.
|
|
||||||
backup/
|
|
||||||
|
|
||||||
# Per-project environment file (Dolt connection config, GH#2520)
|
|
||||||
.env
|
|
||||||
|
|
||||||
# Legacy files (from pre-Dolt versions)
|
|
||||||
*.db
|
|
||||||
*.db?*
|
|
||||||
*.db-journal
|
|
||||||
*.db-wal
|
|
||||||
*.db-shm
|
|
||||||
db.sqlite
|
|
||||||
bd.db
|
|
||||||
# NOTE: Do NOT add negation patterns here.
|
|
||||||
# They would override fork protection in .git/info/exclude.
|
|
||||||
# Config files (metadata.json, config.yaml) are tracked by git by default
|
|
||||||
# since no pattern above ignores them.
|
|
||||||
# config.yaml
|
|
||||||
@@ -1,85 +0,0 @@
|
|||||||
# Beads - AI-Native Issue Tracking
|
|
||||||
|
|
||||||
Welcome to Beads! This repository uses **Beads** for issue tracking - a modern, AI-native tool designed to live directly in your codebase alongside your code.
|
|
||||||
|
|
||||||
## What is Beads?
|
|
||||||
|
|
||||||
Beads is issue tracking that lives in your repo, making it perfect for AI coding agents and developers who want their issues close to their code. No web UI required - everything works through the CLI and integrates seamlessly with git.
|
|
||||||
|
|
||||||
**Learn more:** [github.com/steveyegge/beads](https://github.com/steveyegge/beads)
|
|
||||||
|
|
||||||
## Quick Start
|
|
||||||
|
|
||||||
### Essential Commands
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Create new issues
|
|
||||||
bd create "Add user authentication"
|
|
||||||
|
|
||||||
# View all issues
|
|
||||||
bd list
|
|
||||||
|
|
||||||
# View issue details
|
|
||||||
bd show <issue-id>
|
|
||||||
|
|
||||||
# Update issue status
|
|
||||||
bd update <issue-id> --claim
|
|
||||||
bd update <issue-id> --status done
|
|
||||||
|
|
||||||
# Sync with Dolt remote
|
|
||||||
bd dolt push
|
|
||||||
```
|
|
||||||
|
|
||||||
### Working with Issues
|
|
||||||
|
|
||||||
Issues in Beads are:
|
|
||||||
|
|
||||||
- **Git-native**: Stored in Dolt database with version control and branching
|
|
||||||
- **AI-friendly**: CLI-first design works perfectly with AI coding agents
|
|
||||||
- **Branch-aware**: Issues can follow your branch workflow
|
|
||||||
- **Sync-ready**: Uses Dolt remotes for backup and team sharing
|
|
||||||
|
|
||||||
## Why Beads?
|
|
||||||
|
|
||||||
✨ **AI-Native Design**
|
|
||||||
|
|
||||||
- Built specifically for AI-assisted development workflows
|
|
||||||
- CLI-first interface works seamlessly with AI coding agents
|
|
||||||
- No context switching to web UIs
|
|
||||||
|
|
||||||
🚀 **Developer Focused**
|
|
||||||
|
|
||||||
- Issues live in your repo, right next to your code
|
|
||||||
- Works offline, syncs when you push
|
|
||||||
- Fast, lightweight, and stays out of your way
|
|
||||||
|
|
||||||
🔧 **Git Integration**
|
|
||||||
|
|
||||||
- Dolt-native sync via bd dolt push / bd dolt pull
|
|
||||||
- Branch-aware issue tracking
|
|
||||||
- Dolt-native three-way merge resolution
|
|
||||||
|
|
||||||
## Get Started with Beads
|
|
||||||
|
|
||||||
Try Beads in your own projects:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Install Beads
|
|
||||||
curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
|
|
||||||
|
|
||||||
# Initialize in your repo
|
|
||||||
bd init
|
|
||||||
|
|
||||||
# Create your first issue
|
|
||||||
bd create "Try out Beads"
|
|
||||||
```
|
|
||||||
|
|
||||||
## Learn More
|
|
||||||
|
|
||||||
- **Documentation**: [github.com/steveyegge/beads/docs](https://github.com/steveyegge/beads/tree/main/docs)
|
|
||||||
- **Quick Start Guide**: Run `bd quickstart`
|
|
||||||
- **Examples**: [github.com/steveyegge/beads/examples](https://github.com/steveyegge/beads/tree/main/examples)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
_Beads: Issue tracking that moves at the speed of thought_ ⚡
|
|
||||||
@@ -1,82 +0,0 @@
|
|||||||
# Beads Configuration File
|
|
||||||
# This file configures default behavior for all bd commands in this repository
|
|
||||||
# All settings can also be set via environment variables (BD_* prefix)
|
|
||||||
# or overridden with command-line flags
|
|
||||||
|
|
||||||
# Issue prefix for this repository (used by bd init)
|
|
||||||
# If not set, bd init will auto-detect from directory name
|
|
||||||
# Example: issue-prefix: "myproject" creates issues like "myproject-1", "myproject-2", etc.
|
|
||||||
# issue-prefix: ""
|
|
||||||
|
|
||||||
# Use no-db mode: JSONL-only, no Dolt database
|
|
||||||
# When true, .beads/issues.jsonl is the only local store
|
|
||||||
# no-db: false
|
|
||||||
|
|
||||||
# Enable JSON output by default
|
|
||||||
# json: false
|
|
||||||
|
|
||||||
# Feedback title formatting for mutating commands (create/update/close/dep/edit)
|
|
||||||
# 0 = hide titles, N > 0 = truncate to N characters
|
|
||||||
# output:
|
|
||||||
# title-length: 255
|
|
||||||
|
|
||||||
# Default actor for audit trails (overridden by BEADS_ACTOR or --actor)
|
|
||||||
# actor: ""
|
|
||||||
|
|
||||||
# Optional JSONL sidecar for explicit agent/tool interaction audit records.
|
|
||||||
# Issue history is always recorded in the database and is visible with
|
|
||||||
# bd history <id> --events; this only controls .beads/interactions.jsonl.
|
|
||||||
# audit:
|
|
||||||
# enabled: false
|
|
||||||
|
|
||||||
# Export events (audit trail) to .beads/events.jsonl on each flush/sync
|
|
||||||
# When enabled, new events are appended incrementally using a high-water mark.
|
|
||||||
# Use 'bd export --events' to trigger manually regardless of this setting.
|
|
||||||
# events-export: false
|
|
||||||
|
|
||||||
# Multi-repo configuration (experimental - bd-307)
|
|
||||||
# Allows hydrating from multiple repositories and routing writes to the correct database
|
|
||||||
# repos:
|
|
||||||
# primary: "." # Primary repo (where this database lives)
|
|
||||||
# additional: # Additional repos to hydrate from (read-only)
|
|
||||||
# - ~/beads-planning # Personal planning repo
|
|
||||||
# - ~/work-planning # Work planning repo
|
|
||||||
|
|
||||||
# Dolt-native backup (periodic backup for off-machine recovery)
|
|
||||||
# This is full database backup only. Cross-machine sync uses Dolt remotes.
|
|
||||||
# backup:
|
|
||||||
# enabled: false # Disable auto-backup entirely
|
|
||||||
# interval: 15m # Minimum time between auto-backups
|
|
||||||
# git-push: false # Disable git push (backup locally only)
|
|
||||||
# git-repo: "" # Separate git repo for backups (default: project repo)
|
|
||||||
|
|
||||||
# Optional JSONL auto-export for viewers, interchange, and issue-level migration.
|
|
||||||
# Disabled by default; enable only when an integration needs fresh .beads/issues.jsonl.
|
|
||||||
# Use relative paths under .beads/ for JSONL import/export filenames.
|
|
||||||
export:
|
|
||||||
auto: false
|
|
||||||
path: issues.jsonl
|
|
||||||
interval: 60s
|
|
||||||
# issues.jsonl/interactions.jsonl are .gitignore'd local-only files --
|
|
||||||
# Dolt (synced via sync.remote) is the source of truth. Leave auto off
|
|
||||||
# and git-add off; do not re-track these in git.
|
|
||||||
git-add: false
|
|
||||||
import:
|
|
||||||
path: issues.jsonl
|
|
||||||
# Integration settings (access with 'bd config get/set')
|
|
||||||
# Non-secret keys (stored in the database):
|
|
||||||
# - jira.url, jira.project
|
|
||||||
# - linear.team_id
|
|
||||||
# - github.org, github.repo
|
|
||||||
#
|
|
||||||
# Secret keys (stored in this file but prefer env vars to avoid git exposure):
|
|
||||||
# - linear.api_key → use LINEAR_API_KEY env var instead
|
|
||||||
# - github.token → use GITHUB_TOKEN env var instead
|
|
||||||
sync.remote: "git+https://github.com/samcharles93/archie-core.git"
|
|
||||||
dolt:
|
|
||||||
shared-server: false
|
|
||||||
auto-commit: "on"
|
|
||||||
audit:
|
|
||||||
enabled: true
|
|
||||||
agent:
|
|
||||||
profile: team-maintainer
|
|
||||||
@@ -1,33 +0,0 @@
|
|||||||
#!/usr/bin/env sh
|
|
||||||
# --- BEGIN BEADS INTEGRATION v1.2.2 ---
|
|
||||||
# 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:-300}
|
|
||||||
_bd_used_perl=0
|
|
||||||
if command -v timeout >/dev/null 2>&1; then
|
|
||||||
timeout "$_bd_timeout" bd hooks run post-checkout "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
elif command -v gtimeout >/dev/null 2>&1; then
|
|
||||||
gtimeout "$_bd_timeout" bd hooks run post-checkout "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
elif command -v perl >/dev/null 2>&1; then
|
|
||||||
_bd_used_perl=1
|
|
||||||
perl -e 'alarm shift; exec @ARGV' "$_bd_timeout" bd hooks run post-checkout "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
else
|
|
||||||
echo >&2 "beads: hook 'post-checkout' running without timeout; install coreutils or perl to enable BEADS_HOOK_TIMEOUT"
|
|
||||||
bd hooks run post-checkout "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
fi
|
|
||||||
if [ $_bd_exit -eq 124 ] || { [ $_bd_used_perl -eq 1 ] && [ $_bd_exit -eq 142 ]; }; then
|
|
||||||
echo >&2 "beads: hook 'post-checkout' timed out after ${_bd_timeout}s — continuing without beads"
|
|
||||||
_bd_exit=0
|
|
||||||
fi
|
|
||||||
if [ $_bd_exit -eq 3 ]; then
|
|
||||||
echo >&2 "beads: database not initialized — skipping hook 'post-checkout'"
|
|
||||||
_bd_exit=0
|
|
||||||
fi
|
|
||||||
if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
|
|
||||||
fi
|
|
||||||
# --- END BEADS INTEGRATION v1.2.2 ---
|
|
||||||
@@ -1,33 +0,0 @@
|
|||||||
#!/usr/bin/env sh
|
|
||||||
# --- BEGIN BEADS INTEGRATION v1.2.2 ---
|
|
||||||
# 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:-300}
|
|
||||||
_bd_used_perl=0
|
|
||||||
if command -v timeout >/dev/null 2>&1; then
|
|
||||||
timeout "$_bd_timeout" bd hooks run post-merge "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
elif command -v gtimeout >/dev/null 2>&1; then
|
|
||||||
gtimeout "$_bd_timeout" bd hooks run post-merge "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
elif command -v perl >/dev/null 2>&1; then
|
|
||||||
_bd_used_perl=1
|
|
||||||
perl -e 'alarm shift; exec @ARGV' "$_bd_timeout" bd hooks run post-merge "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
else
|
|
||||||
echo >&2 "beads: hook 'post-merge' running without timeout; install coreutils or perl to enable BEADS_HOOK_TIMEOUT"
|
|
||||||
bd hooks run post-merge "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
fi
|
|
||||||
if [ $_bd_exit -eq 124 ] || { [ $_bd_used_perl -eq 1 ] && [ $_bd_exit -eq 142 ]; }; then
|
|
||||||
echo >&2 "beads: hook 'post-merge' timed out after ${_bd_timeout}s — continuing without beads"
|
|
||||||
_bd_exit=0
|
|
||||||
fi
|
|
||||||
if [ $_bd_exit -eq 3 ]; then
|
|
||||||
echo >&2 "beads: database not initialized — skipping hook 'post-merge'"
|
|
||||||
_bd_exit=0
|
|
||||||
fi
|
|
||||||
if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
|
|
||||||
fi
|
|
||||||
# --- END BEADS INTEGRATION v1.2.2 ---
|
|
||||||
@@ -1,33 +0,0 @@
|
|||||||
#!/usr/bin/env sh
|
|
||||||
# --- BEGIN BEADS INTEGRATION v1.2.2 ---
|
|
||||||
# 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:-300}
|
|
||||||
_bd_used_perl=0
|
|
||||||
if command -v timeout >/dev/null 2>&1; then
|
|
||||||
timeout "$_bd_timeout" bd hooks run pre-commit "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
elif command -v gtimeout >/dev/null 2>&1; then
|
|
||||||
gtimeout "$_bd_timeout" bd hooks run pre-commit "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
elif command -v perl >/dev/null 2>&1; then
|
|
||||||
_bd_used_perl=1
|
|
||||||
perl -e 'alarm shift; exec @ARGV' "$_bd_timeout" bd hooks run pre-commit "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
else
|
|
||||||
echo >&2 "beads: hook 'pre-commit' running without timeout; install coreutils or perl to enable BEADS_HOOK_TIMEOUT"
|
|
||||||
bd hooks run pre-commit "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
fi
|
|
||||||
if [ $_bd_exit -eq 124 ] || { [ $_bd_used_perl -eq 1 ] && [ $_bd_exit -eq 142 ]; }; then
|
|
||||||
echo >&2 "beads: hook 'pre-commit' timed out after ${_bd_timeout}s — continuing without beads"
|
|
||||||
_bd_exit=0
|
|
||||||
fi
|
|
||||||
if [ $_bd_exit -eq 3 ]; then
|
|
||||||
echo >&2 "beads: database not initialized — skipping hook 'pre-commit'"
|
|
||||||
_bd_exit=0
|
|
||||||
fi
|
|
||||||
if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
|
|
||||||
fi
|
|
||||||
# --- END BEADS INTEGRATION v1.2.2 ---
|
|
||||||
@@ -1,33 +0,0 @@
|
|||||||
#!/usr/bin/env sh
|
|
||||||
# --- BEGIN BEADS INTEGRATION v1.2.2 ---
|
|
||||||
# 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:-300}
|
|
||||||
_bd_used_perl=0
|
|
||||||
if command -v timeout >/dev/null 2>&1; then
|
|
||||||
timeout "$_bd_timeout" bd hooks run pre-push "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
elif command -v gtimeout >/dev/null 2>&1; then
|
|
||||||
gtimeout "$_bd_timeout" bd hooks run pre-push "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
elif command -v perl >/dev/null 2>&1; then
|
|
||||||
_bd_used_perl=1
|
|
||||||
perl -e 'alarm shift; exec @ARGV' "$_bd_timeout" bd hooks run pre-push "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
else
|
|
||||||
echo >&2 "beads: hook 'pre-push' running without timeout; install coreutils or perl to enable BEADS_HOOK_TIMEOUT"
|
|
||||||
bd hooks run pre-push "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
fi
|
|
||||||
if [ $_bd_exit -eq 124 ] || { [ $_bd_used_perl -eq 1 ] && [ $_bd_exit -eq 142 ]; }; then
|
|
||||||
echo >&2 "beads: hook 'pre-push' timed out after ${_bd_timeout}s — continuing without beads"
|
|
||||||
_bd_exit=0
|
|
||||||
fi
|
|
||||||
if [ $_bd_exit -eq 3 ]; then
|
|
||||||
echo >&2 "beads: database not initialized — skipping hook 'pre-push'"
|
|
||||||
_bd_exit=0
|
|
||||||
fi
|
|
||||||
if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
|
|
||||||
fi
|
|
||||||
# --- END BEADS INTEGRATION v1.2.2 ---
|
|
||||||
@@ -1,33 +0,0 @@
|
|||||||
#!/usr/bin/env sh
|
|
||||||
# --- BEGIN BEADS INTEGRATION v1.2.2 ---
|
|
||||||
# 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:-300}
|
|
||||||
_bd_used_perl=0
|
|
||||||
if command -v timeout >/dev/null 2>&1; then
|
|
||||||
timeout "$_bd_timeout" bd hooks run prepare-commit-msg "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
elif command -v gtimeout >/dev/null 2>&1; then
|
|
||||||
gtimeout "$_bd_timeout" bd hooks run prepare-commit-msg "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
elif command -v perl >/dev/null 2>&1; then
|
|
||||||
_bd_used_perl=1
|
|
||||||
perl -e 'alarm shift; exec @ARGV' "$_bd_timeout" bd hooks run prepare-commit-msg "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
else
|
|
||||||
echo >&2 "beads: hook 'prepare-commit-msg' running without timeout; install coreutils or perl to enable BEADS_HOOK_TIMEOUT"
|
|
||||||
bd hooks run prepare-commit-msg "$@"
|
|
||||||
_bd_exit=$?
|
|
||||||
fi
|
|
||||||
if [ $_bd_exit -eq 124 ] || { [ $_bd_used_perl -eq 1 ] && [ $_bd_exit -eq 142 ]; }; then
|
|
||||||
echo >&2 "beads: hook 'prepare-commit-msg' timed out after ${_bd_timeout}s — continuing without beads"
|
|
||||||
_bd_exit=0
|
|
||||||
fi
|
|
||||||
if [ $_bd_exit -eq 3 ]; then
|
|
||||||
echo >&2 "beads: database not initialized — skipping hook 'prepare-commit-msg'"
|
|
||||||
_bd_exit=0
|
|
||||||
fi
|
|
||||||
if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
|
|
||||||
fi
|
|
||||||
# --- END BEADS INTEGRATION v1.2.2 ---
|
|
||||||
@@ -1,8 +0,0 @@
|
|||||||
{
|
|
||||||
"database": "dolt",
|
|
||||||
"backend": "dolt",
|
|
||||||
"dolt_mode": "embedded",
|
|
||||||
"dolt_database": "archie_core",
|
|
||||||
"project_id": "e8a66150-1f5f-42d2-8653-dcf8463cef74",
|
|
||||||
"last_bd_version": "1.3.2"
|
|
||||||
}
|
|
||||||
@@ -10,8 +10,6 @@
|
|||||||
bin/
|
bin/
|
||||||
dist/
|
dist/
|
||||||
docs/
|
docs/
|
||||||
# Issue tracking is a Dolt database, not build input.
|
|
||||||
.beads/
|
|
||||||
tmp/
|
tmp/
|
||||||
.playwright-mcp/
|
.playwright-mcp/
|
||||||
# A trailing-slash pattern matches only the context root, so this is written to
|
# A trailing-slash pattern matches only the context root, so this is written to
|
||||||
|
|||||||
@@ -31,13 +31,8 @@ config.production.toml
|
|||||||
/.air/
|
/.air/
|
||||||
/tmp/
|
/tmp/
|
||||||
|
|
||||||
# Beads / Dolt files (added by bd init)
|
|
||||||
.dolt/
|
.dolt/
|
||||||
.beads-credential-key
|
|
||||||
.beads/proxieddb/
|
|
||||||
*.gate.lock*
|
*.gate.lock*
|
||||||
.beads/issues.jsonl
|
|
||||||
.beads/interactions.jsonl
|
|
||||||
.mcp.json
|
.mcp.json
|
||||||
|
|
||||||
# gh CLI state (~/.local/state/gh) mistakenly created inside the tree
|
# gh CLI state (~/.local/state/gh) mistakenly created inside the tree
|
||||||
|
|||||||
@@ -45,7 +45,7 @@ When sources disagree, the higher one wins:
|
|||||||
1. The maintainer's instruction in this session.
|
1. The maintainer's instruction in this session.
|
||||||
2. This file.
|
2. This file.
|
||||||
3. The code as it is in the tree.
|
3. The code as it is in the tree.
|
||||||
4. Beads issues (`bd show <id>`): the plan for a piece of work.
|
4. Gitea issues (`tea issues view <n>`): the plan for a piece of work.
|
||||||
5. Everything else (memories, comments, old docs) is a hint. Verify it against
|
5. Everything else (memories, comments, old docs) is a hint. Verify it against
|
||||||
the code before acting on it.
|
the code before acting on it.
|
||||||
|
|
||||||
@@ -177,21 +177,32 @@ Requires Go 1.27, Task, golangci-lint, Node, pnpm and Docker. Adopt `task fmt` a
|
|||||||
Nothing in the working tree is read at runtime. Systemd is optional.
|
Nothing in the working tree is read at runtime. Systemd is optional.
|
||||||
- Releases: `RELEASING.md`.
|
- Releases: `RELEASING.md`.
|
||||||
|
|
||||||
## Issues (beads)
|
## Issues (Gitea)
|
||||||
|
|
||||||
Work is tracked in `bd`, never in Markdown TODO files.
|
Work is tracked as issues on the primary remote, never in Markdown TODO files.
|
||||||
|
GitHub is a read-only mirror; do not open, close or comment there.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
bd ready | bd show <id> | bd update <id> --claim | bd close <id>
|
tea issues list -r sam/archie --state open --labels priority::critical
|
||||||
|
tea issues list -r sam/archie --labels epic/<slug> --state open
|
||||||
|
tea issues view 497
|
||||||
|
tea issues edit 497 --add-labels status::in_progress --add-assignees sam
|
||||||
|
tea comment 497 "what changed, and what was run"
|
||||||
|
tea issues close 497
|
||||||
```
|
```
|
||||||
|
|
||||||
- An issue is the plan: what is wrong or wanted, and how you know it is done.
|
- An issue is the plan: what is wrong or wanted, and how you know it is done.
|
||||||
Keep it to that.
|
Keep it to that.
|
||||||
- Bead state syncs through Dolt (`bd dolt push/pull`, only when told), not git.
|
- Labels carry state: `type::`, `priority::`, `status::in_progress` and
|
||||||
Never commit `.beads/` exports.
|
`status::deferred`. Open/closed is the issue state, not a label.
|
||||||
- No host names, IPs, paths, PIDs or credentials in any bead: they are
|
`epic/<slug>` says which epic an issue belongs to.
|
||||||
published.
|
- Cite the issue number in commits and comments.
|
||||||
- File follow-up work you find as a bead. Do not fix it in passing.
|
- `tea issues list --labels` silently ignores an unknown name and returns every
|
||||||
|
issue. Check the count is plausible before trusting a filtered list.
|
||||||
|
- The API caps `limit` at 50 regardless of what you pass.
|
||||||
|
- No host names, IPs, paths, PIDs or credentials in an issue: the text outlives
|
||||||
|
the change that wrote it.
|
||||||
|
- File follow-up work you find as an issue. Do not fix it in passing.
|
||||||
|
|
||||||
## Changing this file
|
## Changing this file
|
||||||
|
|
||||||
|
|||||||
@@ -219,7 +219,7 @@ phase differ.
|
|||||||
The proxy runs in the daemon outside the container, so a shell in the
|
The proxy runs in the daemon outside the container, so a shell in the
|
||||||
container sees only sentinels.
|
container sees only sentinels.
|
||||||
- **Takeover (interactive PTY into a running task) is out of scope for this
|
- **Takeover (interactive PTY into a running task) is out of scope for this
|
||||||
bead.** It needs the dangerous-command authority (`archie-core-sod1`) to
|
issue.** It needs the dangerous-command authority (#1574) to
|
||||||
gate it, and that authority is not wired for it: the harness listener has no
|
gate it, and that authority is not wired for it: the harness listener has no
|
||||||
approval step; `ToolSetOptions.Approval` in `internal/agentexec/modelloop`
|
approval step; `ToolSetOptions.Approval` in `internal/agentexec/modelloop`
|
||||||
is never set by a caller, so task runs never build approval-required tools;
|
is never set by a caller, so task runs never build approval-required tools;
|
||||||
|
|||||||
@@ -3,8 +3,8 @@
|
|||||||
Read this file and `GUIDELINES.md` before running a numbered implementation prompt.
|
Read this file and `GUIDELINES.md` before running a numbered implementation prompt.
|
||||||
The maintainer approved the architecture below. Implement it; do not restart a
|
The maintainer approved the architecture below. Implement it; do not restart a
|
||||||
navigation brainstorming exercise. The initial Antigravity navigation proposal
|
navigation brainstorming exercise. The initial Antigravity navigation proposal
|
||||||
was rejected. A later externally authored design or Bead design field is not
|
was rejected. A later externally authored design or issue description field is
|
||||||
additional approval.
|
not additional approval.
|
||||||
|
|
||||||
## Approved product model
|
## Approved product model
|
||||||
|
|
||||||
@@ -43,14 +43,14 @@ that snapshot is current. Other agents may have worked since this handoff.
|
|||||||
|
|
||||||
## Execution sequence
|
## Execution sequence
|
||||||
|
|
||||||
1. `01-execution-identities.md` — `archie-core-kgxw.13`.
|
1. `01-execution-identities.md` — #300.
|
||||||
2. `02-connections-and-repositories.md` — `archie-core-oygqd`.
|
2. `02-connections-and-repositories.md` — #385.
|
||||||
3. `03-organisation-ownership.md` — `archie-core-3z4fd.8`.
|
3. `03-organisation-ownership.md` — #57.
|
||||||
4. `04-navigation-and-setup.md` — `archie-core-3z4fd.1`.
|
4. `04-navigation-and-setup.md` — #47.
|
||||||
|
|
||||||
Beads is authoritative for progress and dependencies. The parent is
|
Gitea issues are authoritative for progress and dependencies. The parent is
|
||||||
`archie-core-3z4fd`. These files are reusable instructions, not completion records.
|
#1043. These files are reusable instructions, not completion records.
|
||||||
Read each Bead before claiming it. Complete the current slice end to end before
|
Read each issue before claiming it. Complete the current slice end to end before
|
||||||
starting the next. Do not close the parent until all acceptance criteria have
|
starting the next. Do not close the parent until all acceptance criteria have
|
||||||
actual evidence. Do not delegate unless the maintainer explicitly authorises it.
|
actual evidence. Do not delegate unless the maintainer explicitly authorises it.
|
||||||
|
|
||||||
|
|||||||
@@ -63,4 +63,4 @@ actual daemon path. Cover refused human, inactive, unassigned and cross-org
|
|||||||
identities; authority outages; retry rechecks; and absence of root credential
|
identities; authority outages; retry rechecks; and absence of root credential
|
||||||
inheritance. Verify a renamed agent still resolves by ID. Verify existing mapped
|
inheritance. Verify a renamed agent still resolves by ID. Verify existing mapped
|
||||||
identities retain their permissions. Run the project gate and record evidence
|
identities retain their permissions. Run the project gate and record evidence
|
||||||
and any remaining limitations in the Bead before closing it.
|
and any remaining limitations in the issue before closing it.
|
||||||
@@ -51,4 +51,4 @@ loading/error states, keyboard access and a narrow viewport. Capture evidence,
|
|||||||
regenerate embedded UI output and run the exact final tree's project gate.
|
regenerate embedded UI output and run the exact final tree's project gate.
|
||||||
|
|
||||||
Do not claim a successful user journey based solely on mocked screenshots or
|
Do not claim a successful user journey based solely on mocked screenshots or
|
||||||
fixture state. Leave unmet criteria explicitly open in Beads.
|
fixture state. Leave unmet criteria explicitly open in the issue.
|
||||||
@@ -7,9 +7,9 @@ AGENTS.md files first; the maintainer's current instructions take precedence.
|
|||||||
|
|
||||||
- Verify the requested checkout, branch, working tree and other active writers.
|
- Verify the requested checkout, branch, working tree and other active writers.
|
||||||
Preserve unrelated changes. Do not reset, stash or overwrite another agent.
|
Preserve unrelated changes. Do not reset, stash or overwrite another agent.
|
||||||
- Read and claim the named Bead. Create any missing issue before starting its
|
- Read and claim the named issue. Create any missing issue before starting its
|
||||||
work. Record implementation discoveries and remaining work in Beads, never a
|
work. Record implementation discoveries and remaining work in the issue, never
|
||||||
second Markdown task ledger. Do not sync Beads externally unless told.
|
a second Markdown task ledger. Do not post to another tracker unless told.
|
||||||
- Trace the complete affected path: UI, API, service contract, authorisation,
|
- Trace the complete affected path: UI, API, service contract, authorisation,
|
||||||
persistence, runtime consumer, retries, fixtures and generated artifacts.
|
persistence, runtime consumer, retries, fixtures and generated artifacts.
|
||||||
- Name the smallest complete change. Reuse existing resource, secret-reference,
|
- Name the smallest complete change. Reuse existing resource, secret-reference,
|
||||||
@@ -40,7 +40,7 @@ AGENTS.md files first; the maintainer's current instructions take precedence.
|
|||||||
- Remove obsolete paths only after migrating their data and callers. No parallel
|
- Remove obsolete paths only after migrating their data and callers. No parallel
|
||||||
identity authority, duplicated ownership model or indefinite compatibility shim.
|
identity authority, duplicated ownership model or indefinite compatibility shim.
|
||||||
- No new service, binary, generic framework, broad cleanup or speculative feature.
|
- No new service, binary, generic framework, broad cleanup or speculative feature.
|
||||||
File unrelated discoveries as Beads instead of fixing them in passing.
|
File unrelated discoveries as issues instead of fixing them in passing.
|
||||||
|
|
||||||
## Verification and delivery
|
## Verification and delivery
|
||||||
|
|
||||||
@@ -57,9 +57,9 @@ AGENTS.md files first; the maintainer's current instructions take precedence.
|
|||||||
- Regenerate protobuf and embedded UI assets when their sources change; do not
|
- Regenerate protobuf and embedded UI assets when their sources change; do not
|
||||||
hand-edit generated output. Run appropriate targeted checks, then `task check`
|
hand-edit generated output. Run appropriate targeted checks, then `task check`
|
||||||
on the exact final tree before committing. Never run concurrent full gates.
|
on the exact final tree before committing. Never run concurrent full gates.
|
||||||
- Stage only your own paths, never `.beads/`, binaries or scratch output. Commit
|
- Stage only your own paths, never binaries or scratch output. Commit finished
|
||||||
finished work with a short scoped Conventional Commit. Do not push or deploy.
|
work with a short scoped Conventional Commit. Do not push or deploy.
|
||||||
- Close a Bead only when its stated acceptance is demonstrated. If something
|
- Close an issue only when its stated acceptance is demonstrated. If something
|
||||||
remains unverified, record exactly what and why; leave the issue open. Never
|
remains unverified, record exactly what and why; leave the issue open. Never
|
||||||
describe a partial implementation as end-to-end completion.
|
describe a partial implementation as end-to-end completion.
|
||||||
- Report what changed, what was verified and the material remaining limitation.
|
- Report what changed, what was verified and the material remaining limitation.
|
||||||
|
|||||||
@@ -44,9 +44,6 @@ go install "github.com/bufbuild/buf/cmd/buf@$BUF_VERSION"
|
|||||||
go install "google.golang.org/protobuf/cmd/protoc-gen-go@$PROTOC_GEN_GO_VERSION"
|
go install "google.golang.org/protobuf/cmd/protoc-gen-go@$PROTOC_GEN_GO_VERSION"
|
||||||
go install "google.golang.org/grpc/cmd/protoc-gen-go-grpc@$PROTOC_GEN_GO_GRPC_VERSION"
|
go install "google.golang.org/grpc/cmd/protoc-gen-go-grpc@$PROTOC_GEN_GO_GRPC_VERSION"
|
||||||
|
|
||||||
curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash
|
|
||||||
(cd "$HOME" && bd setup claude --global)
|
|
||||||
|
|
||||||
# PostgreSQL 18 for e2e/stack.sh, which runs its own cluster. Never for
|
# PostgreSQL 18 for e2e/stack.sh, which runs its own cluster. Never for
|
||||||
# tests: they use fakes.
|
# tests: they use fakes.
|
||||||
if [ ! -x /usr/lib/postgresql/18/bin/postgres ]; then
|
if [ ! -x /usr/lib/postgresql/18/bin/postgres ]; then
|
||||||
@@ -81,4 +78,3 @@ go version
|
|||||||
node --version
|
node --version
|
||||||
task --version
|
task --version
|
||||||
golangci-lint --version
|
golangci-lint --version
|
||||||
bd --version
|
|
||||||
+3
-3
@@ -1,7 +1,7 @@
|
|||||||
# UI agent rules
|
# UI agent rules
|
||||||
|
|
||||||
These rules supplement the repository root's AGENTS.md. Its authority, service
|
These rules supplement the repository root's AGENTS.md. Its authority, service
|
||||||
boundaries, security invariants, Beads workflow and commit gate still apply.
|
boundaries, security invariants, issue workflow and commit gate still apply.
|
||||||
CLAUDE.md points here so both agents use one policy.
|
CLAUDE.md points here so both agents use one policy.
|
||||||
|
|
||||||
## Scope
|
## Scope
|
||||||
@@ -127,8 +127,8 @@ pnpm audit # after dependency changes
|
|||||||
edit it by hand. Test-only edits do not need new dashboard assets.
|
edit it by hand. Test-only edits do not need new dashboard assets.
|
||||||
- Reuse a running dev server for browser checks. Verify changed interactions,
|
- Reuse a running dev server for browser checks. Verify changed interactions,
|
||||||
not just a screenshot or successful HTTP response.
|
not just a screenshot or successful HTTP response.
|
||||||
- Track work and follow-ups in Beads. Keep rules here only when they change a
|
- Track work and follow-ups as Gitea issues (`tea`). Keep rules here only when
|
||||||
decision; do not add task history or Markdown TODO lists.
|
they change a decision; do not add task history or Markdown TODO lists.
|
||||||
|
|
||||||
## Working with you
|
## Working with you
|
||||||
|
|
||||||
|
|||||||
Reference in new issue
Block a user