diff --git a/.beads/issues.jsonl b/.beads/issues.jsonl index 24903b4a..151c3da1 100644 --- a/.beads/issues.jsonl +++ b/.beads/issues.jsonl @@ -107,7 +107,7 @@ {"id":"bd-195","title":"stress_test_1","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-10-15T01:07:02.011549-07:00","updated_at":"2025-10-15T16:27:21.964657-07:00","closed_at":"2025-10-15T16:26:05.190223-07:00"} {"id":"bd-196","title":"Test2 auto-export","description":"","status":"closed","priority":4,"issue_type":"task","created_at":"2025-10-15T01:07:02.011907-07:00","updated_at":"2025-10-15T16:27:21.966007-07:00","closed_at":"2025-10-15T03:01:29.548276-07:00"} {"id":"bd-197","title":"Add version mismatch warning for outdated binaries","description":"When bd detects that the database was created/modified by a newer version, warn the user that they may be running an outdated binary.\n\n**Problem:** Users may run old bd binaries without realizing it, leading to confusing behavior (e.g., missing features like auto-export).\n\n**Solution:** Store schema version or bd version in metadata table, check on startup, warn if mismatch.\n\n**Implementation:**\n1. Add `schema_version` or `bd_version` to metadata table during init\n2. Check version in PersistentPreRun (cmd/bd/main.go)\n3. Warn if binary version \u003c DB version\n4. Suggest: 'Your bd binary (v0.9.3) is older than this database (v0.9.5). Rebuild: go build -o bd ./cmd/bd'\n\n**Edge cases:**\n- Dev builds (show commit hash?)\n- Backwards compatibility (older DBs should work with newer binaries)\n- Don't warn on every command (maybe once per session?)\n\n**Related:** Fixes confusion from bd-182 (auto-export not working with old binary)","notes":"**Implementation Complete:**\n\n✅ Added version metadata storage during `bd init` (init.go:59-63)\n✅ Added `checkVersionMismatch()` function (main.go:301-345)\n✅ Integrated version check into PersistentPreRun (main.go:98-99)\n✅ Tested both scenarios:\n - Outdated binary: Clear warning with rebuild instructions\n - Newer binary: Info message that DB will be auto-upgraded\n✅ No warnings on subsequent runs (version updated automatically)\n\n**How it works:**\n1. On `bd init`: Stores current version in metadata table\n2. On every command: Checks stored version vs binary version\n3. If mismatch:\n - Binary \u003c DB version → Warn: outdated binary\n - Binary \u003e DB version → Info: auto-upgrading DB\n4. Always updates stored version to current (future-proof)\n\n**Files modified:**\n- cmd/bd/init.go: Store version on init\n- cmd/bd/main.go: checkVersionMismatch() + integration\n\n**Testing:**\n```bash\n# Simulate old binary\nsqlite3 .beads/default.db \"UPDATE metadata SET value='0.9.99' WHERE key='bd_version';\"\nbd ready # Shows warning\n\n# Normal use (versions match)\nbd ready # No warning\n```\n\n**Edge cases handled:**\n- Empty version (old DB): Silently upgrade\n- Metadata errors: Skip check (defensive)\n- Dev builds: String comparison (works for 0.9.5 vs 0.9.6)\n\nFixes bd-182 confusion (users won't run outdated binaries unknowingly).","status":"closed","priority":2,"issue_type":"feature","created_at":"2025-10-15T01:07:02.012291-07:00","updated_at":"2025-10-15T16:27:21.966999-07:00","closed_at":"2025-10-15T03:01:29.548677-07:00","dependencies":[{"issue_id":"bd-197","depends_on_id":"bd-182","type":"discovered-from","created_at":"2025-10-15T01:07:02.078326-07:00","created_by":"auto-import"}]} -{"id":"bd-198","title":"Add label management commands to CLI","description":"Currently labels can only be managed programmatically via the storage API. Add CLI commands to add, remove, and filter by labels.","acceptance_criteria":"Can add/remove/list labels via CLI, can filter issues by label, labels persist to JSONL","status":"open","priority":2,"issue_type":"feature","created_at":"2025-10-15T01:10:48.43357-07:00","updated_at":"2025-10-15T16:27:21.968173-07:00"} +{"id":"bd-198","title":"Add label management commands to CLI","description":"Currently labels can only be managed programmatically via the storage API. Add CLI commands to add, remove, and filter by labels.","acceptance_criteria":"Can add/remove/list labels via CLI, can filter issues by label, labels persist to JSONL","status":"closed","priority":2,"issue_type":"feature","created_at":"2025-10-15T01:10:48.43357-07:00","updated_at":"2025-10-15T17:14:14.451905-07:00","closed_at":"2025-10-15T17:14:14.451905-07:00"} {"id":"bd-199","title":"Investigate and fix import timeout with 208 issues","description":"bd import times out after 2 minutes when importing 208 issues from JSONL. This is unacceptable for a tool designed to scale to 100k+ issues.","design":"\n## Reproduction\n```bash\ncd ~/src/beads\nbd import .beads/issues.jsonl # Hangs/times out after 2 minutes\n```\n\nCurrent database state:\n- 208 issues in bd.db (2MB)\n- 208 lines in issues.jsonl (100KB)\n- WAL mode enabled\n\n## Symptoms\n- Import starts but never completes\n- No error message, just hangs\n- Timeout after 2 minutes (artificially imposed in testing)\n- Happens even when database already contains the issues (idempotent import)\n\n## Likely Causes\n1. **Transaction size** - All 208 issues in one transaction?\n2. **Lock contention** - WAL checkpoint blocking?\n3. **N+1 queries** - Dependency checking for each issue?\n4. **Missing indexes** - Slow lookups during collision detection?\n5. **Auto-flush interaction** - Background flush goroutine conflicting?\n\n## Performance Target\nShould handle:\n- 1000 issues in \u003c 5 seconds\n- 10,000 issues in \u003c 30 seconds \n- 100,000 issues in \u003c 5 minutes\n\n## Investigation Steps\n1. Add timing instrumentation to import phases\n2. Profile the import operation\n3. Check for lock contention in WAL mode\n4. Review collision detection performance\n5. Test with PRAGMA synchronous = NORMAL\n6. Consider batching imports (e.g., 100 issues per transaction)\n","acceptance_criteria":"\n- Can import 208 issues in \u003c 5 seconds\n- Can import 1000 issues in \u003c 30 seconds\n- Add performance logging to identify bottlenecks\n- Add --batch-size flag for tuning\n- Document performance characteristics\n- Integration test with large import\n","notes":"## Profiling Results (2025-10-15)\n\nCreated comprehensive profiling tests in cmd/bd/import_profile_test.go.\n\n### Key Findings\n\nImport performance is actually **very good** for the core phases:\n- 1000 issues: 883ms total (1,132 issues/sec)\n- 208 issues collision detection: 3.2ms (64,915 issues/sec)\n\n### Bottleneck Identified\n\n**Create/Update phase takes 95-98% of total time:**\n- 100 issues: 58ms (87.4%)\n- 500 issues: 214ms (95.8%) \n- 1000 issues: 866ms (98.1%)\n\nThis phase does N*2 individual queries (GetIssue + CreateIssue/UpdateIssue) with no transaction batching.\n\n### Next Steps\n\n1. Profile dependency import phase (not yet measured)\n2. Check for auto-flush lock contention\n3. Investigate WAL checkpoint blocking\n4. Consider transaction batching for bulk imports\n\n### Test Command\n\n```bash\ngo test -v -run TestImportPerformance ./cmd/bd/\n```\n\nSee test file for detailed instrumentation.","status":"closed","priority":0,"issue_type":"bug","created_at":"2025-10-15T01:11:08.998901-07:00","updated_at":"2025-10-15T16:27:21.969079-07:00","closed_at":"2025-10-15T02:49:22.700881-07:00"} {"id":"bd-2","title":"Verify auto-export works","description":"","status":"closed","priority":0,"issue_type":"task","created_at":"2025-10-14T14:43:06.907657-07:00","updated_at":"2025-10-15T16:27:21.970346-07:00","closed_at":"2025-10-15T03:01:29.550886-07:00"} {"id":"bd-20","title":"Add --strict flag for dependency import failures","description":"Currently dependency import errors are warnings (logged to stderr, execution continues). Missing targets or cycles may indicate JSONL corruption. Add --strict flag to fail on any dependency errors for data integrity validation. Location: cmd/bd/import.go:159-164","status":"closed","priority":2,"issue_type":"feature","created_at":"2025-10-14T14:43:06.90826-07:00","updated_at":"2025-10-15T16:27:21.970819-07:00","closed_at":"2025-10-15T03:01:29.551329-07:00"} diff --git a/AGENTS.md b/AGENTS.md index 02767bcd..2b8070da 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -20,6 +20,9 @@ bd create "Issue title" -t bug|feature|task -p 0-4 -d "Description" --json # Create with explicit ID (for parallel workers) bd create "Issue title" --id worker1-100 -p 1 --json +# Create with labels +bd create "Issue title" -t bug -p 1 -l bug,critical --json + # Create multiple issues from markdown file bd create -f feature-plan.md --json @@ -32,6 +35,15 @@ bd dep add --type discovered-from # Create and link in one command (new way) bd create "Issue title" -t bug -p 1 --deps discovered-from: --json +# Label management +bd label add