Skip to content

Commit 1ff66a2

Browse files
committed
updates to the latest zero svelte
1 parent 70a44a8 commit 1ff66a2

46 files changed

Lines changed: 2926 additions & 2494 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.ai/GITHUB.md

Lines changed: 0 additions & 6 deletions
This file was deleted.

.ai/SVELTE.md

Lines changed: 0 additions & 22 deletions
This file was deleted.

.beads/.gitignore

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# SQLite databases
2+
*.db
3+
*.db?*
4+
*.db-journal
5+
*.db-wal
6+
*.db-shm
7+
8+
# Daemon runtime files
9+
daemon.lock
10+
daemon.log
11+
daemon.pid
12+
bd.sock
13+
14+
# Legacy database files
15+
db.sqlite
16+
bd.db
17+
18+
# Merge artifacts (temporary files from 3-way merge)
19+
beads.base.jsonl
20+
beads.base.meta.json
21+
beads.left.jsonl
22+
beads.left.meta.json
23+
beads.right.jsonl
24+
beads.right.meta.json
25+
26+
# Keep JSONL exports and config (source of truth for git)
27+
!issues.jsonl
28+
!metadata.json
29+
!config.json

.beads/.local_version

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
0.29.0

.beads/README.md

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
# Beads - AI-Native Issue Tracking
2+
3+
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.
4+
5+
## What is Beads?
6+
7+
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.
8+
9+
**Learn more:** [github.com/steveyegge/beads](https://github.com/steveyegge/beads)
10+
11+
## Quick Start
12+
13+
### Essential Commands
14+
15+
```bash
16+
# Create new issues
17+
bd create "Add user authentication"
18+
19+
# View all issues
20+
bd list
21+
22+
# View issue details
23+
bd show <issue-id>
24+
25+
# Update issue status
26+
bd update <issue-id> --status in_progress
27+
bd update <issue-id> --status done
28+
29+
# Sync with git remote
30+
bd sync
31+
```
32+
33+
### Working with Issues
34+
35+
Issues in Beads are:
36+
- **Git-native**: Stored in `.beads/issues.jsonl` and synced like code
37+
- **AI-friendly**: CLI-first design works perfectly with AI coding agents
38+
- **Branch-aware**: Issues can follow your branch workflow
39+
- **Always in sync**: Auto-syncs with your commits
40+
41+
## Why Beads?
42+
43+
**AI-Native Design**
44+
- Built specifically for AI-assisted development workflows
45+
- CLI-first interface works seamlessly with AI coding agents
46+
- No context switching to web UIs
47+
48+
🚀 **Developer Focused**
49+
- Issues live in your repo, right next to your code
50+
- Works offline, syncs when you push
51+
- Fast, lightweight, and stays out of your way
52+
53+
🔧 **Git Integration**
54+
- Automatic sync with git commits
55+
- Branch-aware issue tracking
56+
- Intelligent JSONL merge resolution
57+
58+
## Get Started with Beads
59+
60+
Try Beads in your own projects:
61+
62+
```bash
63+
# Install Beads
64+
curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
65+
66+
# Initialize in your repo
67+
bd init
68+
69+
# Create your first issue
70+
bd create "Try out Beads"
71+
```
72+
73+
## Learn More
74+
75+
- **Documentation**: [github.com/steveyegge/beads/docs](https://github.com/steveyegge/beads/tree/main/docs)
76+
- **Quick Start Guide**: Run `bd quickstart`
77+
- **Examples**: [github.com/steveyegge/beads/examples](https://github.com/steveyegge/beads/tree/main/examples)
78+
79+
---
80+
81+
*Beads: Issue tracking that moves at the speed of thought*

.beads/config.yaml

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
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: load from JSONL, no SQLite, write back after each command
12+
# When true, bd will use .beads/issues.jsonl as the source of truth
13+
# instead of SQLite database
14+
# no-db: false
15+
16+
# Disable daemon for RPC communication (forces direct database access)
17+
# no-daemon: false
18+
19+
# Disable auto-flush of database to JSONL after mutations
20+
# no-auto-flush: false
21+
22+
# Disable auto-import from JSONL when it's newer than database
23+
# no-auto-import: false
24+
25+
# Enable JSON output by default
26+
# json: false
27+
28+
# Default actor for audit trails (overridden by BD_ACTOR or --actor)
29+
# actor: ""
30+
31+
# Path to database (overridden by BEADS_DB or --db)
32+
# db: ""
33+
34+
# Auto-start daemon if not running (can also use BEADS_AUTO_START_DAEMON)
35+
# auto-start-daemon: true
36+
37+
# Debounce interval for auto-flush (can also use BEADS_FLUSH_DEBOUNCE)
38+
# flush-debounce: "5s"
39+
40+
# Git branch for beads commits (bd sync will commit to this branch)
41+
# IMPORTANT: Set this for team projects so all clones use the same sync branch.
42+
# This setting persists across clones (unlike database config which is gitignored).
43+
# Can also use BEADS_SYNC_BRANCH env var for local override.
44+
# If not set, bd sync will require you to run 'bd config set sync.branch <branch>'.
45+
# sync-branch: "beads-sync"
46+
47+
# Multi-repo configuration (experimental - bd-307)
48+
# Allows hydrating from multiple repositories and routing writes to the correct JSONL
49+
# repos:
50+
# primary: "." # Primary repo (where this database lives)
51+
# additional: # Additional repos to hydrate from (read-only)
52+
# - ~/beads-planning # Personal planning repo
53+
# - ~/work-planning # Work planning repo
54+
55+
# Integration settings (access with 'bd config get/set')
56+
# These are stored in the database, not in this file:
57+
# - jira.url
58+
# - jira.project
59+
# - linear.url
60+
# - linear.api-key
61+
# - github.org
62+
# - github.repo

.beads/issues.jsonl

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
{"id":"battle_mode-0dx","title":"Prevent submissions after time stopped","description":"","status":"open","priority":2,"issue_type":"bug","created_at":"2025-12-11T17:07:13.386735-07:00","updated_at":"2025-12-11T17:07:13.386735-07:00"}
2+
{"id":"battle_mode-5cc","title":"Fix BetterAuth JWKS decryption error","description":"Session error: Failed to decrypt private key. The BETTER_AUTH_SECRET may have changed or JWKS needs to be cleaned up.","status":"closed","priority":1,"issue_type":"bug","created_at":"2025-12-12T09:50:03.166659-07:00","updated_at":"2025-12-12T10:07:34.01619-07:00","closed_at":"2025-12-12T10:07:34.01619-07:00"}
3+
{"id":"battle_mode-5zu","title":"Breakout reset styles","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-11T17:07:15.090383-07:00","updated_at":"2025-12-11T17:07:15.090383-07:00"}
4+
{"id":"battle_mode-731","title":"Test Tailwind CDN","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-11T17:26:55.268726-07:00","updated_at":"2025-12-11T17:26:55.268726-07:00"}
5+
{"id":"battle_mode-7fu","title":"Redesign homepage to be more of a real website instead of video game","description":"","status":"open","priority":2,"issue_type":"feature","created_at":"2025-12-11T17:21:20.431908-07:00","updated_at":"2025-12-11T17:21:20.431908-07:00"}
6+
{"id":"battle_mode-8v5","title":"Revealing mechanism","description":"","status":"open","priority":2,"issue_type":"feature","created_at":"2025-12-11T17:07:14.10418-07:00","updated_at":"2025-12-11T17:07:14.10418-07:00"}
7+
{"id":"battle_mode-bn7","title":"Upload code feature","description":"","status":"open","priority":2,"issue_type":"feature","created_at":"2025-12-11T17:07:13.861615-07:00","updated_at":"2025-12-11T17:07:13.861615-07:00"}
8+
{"id":"battle_mode-c49","title":"Prevent voting for anon users","description":"","status":"open","priority":2,"issue_type":"bug","created_at":"2025-12-11T17:07:13.622885-07:00","updated_at":"2025-12-11T17:07:13.622885-07:00"}
9+
{"id":"battle_mode-iwh","title":"Code based targets","description":"","status":"open","priority":2,"issue_type":"feature","created_at":"2025-12-11T17:07:14.597012-07:00","updated_at":"2025-12-11T17:07:14.597012-07:00"}
10+
{"id":"battle_mode-jbi","title":"AI avatars from GitHub","description":"","status":"open","priority":2,"issue_type":"feature","created_at":"2025-12-11T17:07:14.843567-07:00","updated_at":"2025-12-11T17:07:14.843567-07:00"}
11+
{"id":"battle_mode-jji","title":"Remove default padding and margin on battle view","description":"Remove default padding and margin in src/routes/(blank)/battle/[id]/code/","status":"open","priority":2,"issue_type":"bug","created_at":"2025-12-11T17:26:55.496068-07:00","updated_at":"2025-12-11T17:26:55.496068-07:00"}
12+
{"id":"battle_mode-lpt","title":"Improve 2 person referee view with larger code","description":"","status":"open","priority":2,"issue_type":"feature","created_at":"2025-12-11T17:21:20.670372-07:00","updated_at":"2025-12-11T17:21:20.670372-07:00"}
13+
{"id":"battle_mode-otf","title":"Animations","description":"","status":"open","priority":2,"issue_type":"feature","created_at":"2025-12-11T17:06:36.455234-07:00","updated_at":"2025-12-11T17:06:36.455234-07:00"}
14+
{"id":"battle_mode-owa","title":"Add percentage completed via diff during battle","description":"Show real-time percentage completion by diffing user code against target as people work and save. Requires significant planning - need to determine diff algorithm, UI placement, performance considerations for real-time updates.","status":"open","priority":2,"issue_type":"epic","created_at":"2025-12-11T17:26:55.721812-07:00","updated_at":"2025-12-11T17:26:55.721812-07:00"}
15+
{"id":"battle_mode-pip","title":"Find all todos in codebase","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-11T17:06:52.169884-07:00","updated_at":"2025-12-11T17:06:52.169884-07:00"}
16+
{"id":"battle_mode-qi9","title":"Move to synced queries for all Zero data queries","description":"Migrate to https://zero.rocicorp.dev/docs/synced-queries for all Zero data queries","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-11T17:21:20.93689-07:00","updated_at":"2025-12-11T17:21:20.93689-07:00"}
17+
{"id":"battle_mode-u05","title":"Update zero-svelte code to latest syntax","description":"Update Zero Svelte integration to latest syntax as documented in https://github.com/stolinski/zero-svelte/ README","status":"closed","priority":1,"issue_type":"task","created_at":"2025-12-11T17:34:36.00375-07:00","updated_at":"2025-12-12T10:42:39.800563-07:00","closed_at":"2025-12-12T10:42:39.800563-07:00"}
18+
{"id":"battle_mode-wad","title":"Move to custom mutators for all Zero data mutations","description":"Migrate to https://zero.rocicorp.dev/docs/custom-mutators for all data mutations with Zero","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-11T17:21:21.212238-07:00","updated_at":"2025-12-11T17:21:21.212238-07:00"}
19+
{"id":"battle_mode-z66","title":"Video based targets","description":"","status":"open","priority":2,"issue_type":"feature","created_at":"2025-12-11T17:07:14.343889-07:00","updated_at":"2025-12-11T17:07:14.343889-07:00"}

.beads/metadata.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
{
2+
"database": "beads.db",
3+
"jsonl_export": "issues.jsonl"
4+
}

.gitattributes

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
2+
# Use bd merge for beads JSONL files
3+
.beads/issues.jsonl merge=beads

.github/copilot-instructions.md

Lines changed: 139 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,139 @@
1+
# GitHub Copilot Instructions for Beads
2+
3+
## Project Overview
4+
5+
**beads** (command: `bd`) is a Git-backed issue tracker designed for AI-supervised coding workflows. We dogfood our own tool for all task tracking.
6+
7+
**Key Features:**
8+
- Dependency-aware issue tracking
9+
- Auto-sync with Git via JSONL
10+
- AI-optimized CLI with JSON output
11+
- Built-in daemon for background operations
12+
- MCP server integration for Claude and other AI assistants
13+
14+
## Tech Stack
15+
16+
- **Language**: Go 1.21+
17+
- **Storage**: SQLite (internal/storage/sqlite/)
18+
- **CLI Framework**: Cobra
19+
- **Testing**: Go standard testing + table-driven tests
20+
- **CI/CD**: GitHub Actions
21+
- **MCP Server**: Python (integrations/beads-mcp/)
22+
23+
## Coding Guidelines
24+
25+
### Testing
26+
- Always write tests for new features
27+
- Use `BEADS_DB=/tmp/test.db` to avoid polluting production database
28+
- Run `go test -short ./...` before committing
29+
- Never create test issues in production DB (use temporary DB)
30+
31+
### Code Style
32+
- Run `golangci-lint run ./...` before committing
33+
- Follow existing patterns in `cmd/bd/` for new commands
34+
- Add `--json` flag to all commands for programmatic use
35+
- Update docs when changing behavior
36+
37+
### Git Workflow
38+
- Always commit `.beads/issues.jsonl` with code changes
39+
- Run `bd sync` at end of work sessions
40+
- Install git hooks: `bd hooks install` (ensures DB ↔ JSONL consistency)
41+
42+
## Issue Tracking with bd
43+
44+
**CRITICAL**: This project uses **bd** for ALL task tracking. Do NOT create markdown TODO lists.
45+
46+
### Essential Commands
47+
48+
```bash
49+
# Find work
50+
bd ready --json # Unblocked issues
51+
bd stale --days 30 --json # Forgotten issues
52+
53+
# Create and manage
54+
bd create "Title" -t bug|feature|task -p 0-4 --json
55+
bd create "Subtask" --parent <epic-id> --json # Hierarchical subtask
56+
bd update <id> --status in_progress --json
57+
bd close <id> --reason "Done" --json
58+
59+
# Search
60+
bd list --status open --priority 1 --json
61+
bd show <id> --json
62+
63+
# Sync (CRITICAL at end of session!)
64+
bd sync # Force immediate export/commit/push
65+
```
66+
67+
### Workflow
68+
69+
1. **Check ready work**: `bd ready --json`
70+
2. **Claim task**: `bd update <id> --status in_progress`
71+
3. **Work on it**: Implement, test, document
72+
4. **Discover new work?** `bd create "Found bug" -p 1 --deps discovered-from:<parent-id> --json`
73+
5. **Complete**: `bd close <id> --reason "Done" --json`
74+
6. **Sync**: `bd sync` (flushes changes to git immediately)
75+
76+
### Priorities
77+
78+
- `0` - Critical (security, data loss, broken builds)
79+
- `1` - High (major features, important bugs)
80+
- `2` - Medium (default, nice-to-have)
81+
- `3` - Low (polish, optimization)
82+
- `4` - Backlog (future ideas)
83+
84+
## Project Structure
85+
86+
```
87+
beads/
88+
├── cmd/bd/ # CLI commands (add new commands here)
89+
├── internal/
90+
│ ├── types/ # Core data types
91+
│ └── storage/ # Storage layer
92+
│ └── sqlite/ # SQLite implementation
93+
├── integrations/
94+
│ └── beads-mcp/ # MCP server (Python)
95+
├── examples/ # Integration examples
96+
├── docs/ # Documentation
97+
└── .beads/
98+
├── beads.db # SQLite database (DO NOT COMMIT)
99+
└── issues.jsonl # Git-synced issue storage
100+
```
101+
102+
## Available Resources
103+
104+
### MCP Server (Recommended)
105+
Use the beads MCP server for native function calls instead of shell commands:
106+
- Install: `pip install beads-mcp`
107+
- Functions: `mcp__beads__ready()`, `mcp__beads__create()`, etc.
108+
- See `integrations/beads-mcp/README.md`
109+
110+
### Scripts
111+
- `./scripts/bump-version.sh <version> --commit` - Update all version files atomically
112+
- `./scripts/release.sh <version>` - Complete release workflow
113+
- `./scripts/update-homebrew.sh <version>` - Update Homebrew formula
114+
115+
### Key Documentation
116+
- **AGENTS.md** - Comprehensive AI agent guide (detailed workflows, advanced features)
117+
- **AGENT_INSTRUCTIONS.md** - Development procedures, testing, releases
118+
- **README.md** - User-facing documentation
119+
- **docs/CLI_REFERENCE.md** - Complete command reference
120+
121+
## CLI Help
122+
123+
Run `bd <command> --help` to see all available flags for any command.
124+
For example: `bd create --help` shows `--parent`, `--deps`, `--assignee`, etc.
125+
126+
## Important Rules
127+
128+
- ✅ Use bd for ALL task tracking
129+
- ✅ Always use `--json` flag for programmatic use
130+
- ✅ Run `bd sync` at end of sessions
131+
- ✅ Test with `BEADS_DB=/tmp/test.db`
132+
- ✅ Run `bd <cmd> --help` to discover available flags
133+
- ❌ Do NOT create markdown TODO lists
134+
- ❌ Do NOT create test issues in production DB
135+
- ❌ Do NOT commit `.beads/beads.db` (JSONL only)
136+
137+
---
138+
139+
**For detailed workflows and advanced features, see [AGENTS.md](../AGENTS.md)**

0 commit comments

Comments
 (0)