Goosetown Researcher Beads

bd --readonly list ...
bd --readonly show ...

bd --readonly search          # Full-text search across title, description, ID
bd --readonly list            # List issues with filters
bd --readonly show <id>       # View issue details
bd --readonly comments <id>   # List comments on an issue (do NOT use 'comments add')
bd --readonly ready           # Show ready work (no blockers)
bd --readonly blocked         # Show blocked issues
bd --readonly count           # Count issues with filters
bd --readonly status          # Project overview and statistics
bd --readonly stale           # Show stale/forgotten issues
bd --readonly activity        # Event feed of recent changes (do NOT use --follow — streams forever)
bd --readonly graph           # Dependency graph visualization
bd --readonly dep list        # List dependencies of an issue
bd --readonly dep tree        # Dependency tree from an issue
bd --readonly dep cycles      # Detect dependency cycles
bd --readonly epic status     # Epic completion status
bd --readonly lint            # Check issues for missing sections
bd --readonly orphans         # Issues referenced in commits but still open (NO --fix flag!)
bd --readonly duplicates      # Find duplicate issues (NO --auto-merge flag!)
bd --readonly children <id>  # List child issues of a parent (alias for list --parent)
bd --readonly state <id> <dim> # Query state dimension value from labels
bd --readonly state list <id>  # List all state dimensions on an issue
bd --readonly types           # List valid issue types
bd --readonly info            # Database and daemon info
bd --readonly prime           # AI-optimized project context (counts, ready work, recent activity narrative)

# Project overview: counts by status, recent activity
bd --readonly status

# What's ready to work on right now
bd --readonly ready

# What's blocked
bd --readonly blocked

# Basic text search
bd --readonly search "oauth"

# Search with filters
bd --readonly search "authentication" --status open
bd --readonly search "performance" --assignee alice --limit 20
bd --readonly search "security" --priority-min 0 --priority-max 2
bd --readonly search "bug" --created-after 2026-01-01
bd --readonly search "refactor" --type task --sort priority

# Partial ID search
bd --readonly search "bd-5q"

# JSON output
bd --readonly search "oauth" --json

# Alternative: use --query flag instead of positional argument
bd --readonly search --query "oauth" --status open

# All open issues
bd --readonly list

# By status
bd --readonly list --status open
bd --readonly list --status in_progress
bd --readonly list --status blocked

# By priority (0=critical, 1=high, 2=medium, 3=low, 4=backlog)
bd --readonly list --priority 0
bd --readonly list --priority-max 1  # P0 and P1

# By type
bd --readonly list --type bug
bd --readonly list --type epic
bd --readonly list --type feature

# By assignee
bd --readonly list --assignee tlongwell
bd --readonly list --no-assignee  # Unassigned work

# By label
bd --readonly list --label security
bd --readonly list --label-any "urgent,security"  # OR: has at least one

# By text
bd --readonly list --title "oauth"
bd --readonly list --desc-contains "authentication"

# By date
bd --readonly list --created-after 2026-01-01
bd --readonly list --updated-after 2026-02-01

# Children of a parent/epic
bd --readonly list --parent bd-abc

# Sorting
bd --readonly list --sort priority
bd --readonly list --sort updated --reverse

# Tree view (hierarchical)
bd --readonly list --pretty

# Include closed issues
bd --readonly list --all

# JSON output
bd --readonly list --json

# Limit results (default 50, 0 for unlimited)
bd --readonly list --limit 100

# Ready issues only (like bd ready, but with full list filter options)
bd --readonly list --ready --assignee tlongwell --label backend

# Pinned issues
bd --readonly list --pinned

# Overdue issues (past due_at, not closed)
bd --readonly list --overdue

# Full details
bd --readonly show bd-abc

# With children
bd --readonly show bd-abc --children

# Issues that reference this one
bd --readonly show bd-abc --refs

# Compact one-liner
bd --readonly show bd-abc --short

# JSON output
bd --readonly show bd-abc --json

# Multiple issues
bd --readonly show bd-abc bd-def bd-ghi

# Total count
bd --readonly count

# By status
bd --readonly count --status open
bd --readonly count --by-status  # Grouped breakdown

# By priority
bd --readonly count --by-priority

# By type
bd --readonly count --by-type

# By assignee
bd --readonly count --by-assignee

# By label
bd --readonly count --by-label

# Combined filters
bd --readonly count --assignee alice --by-status
bd --readonly count --status open --by-priority

# Ready to work on (open, no blockers) — default limit is 10, not 50!
bd --readonly ready
bd --readonly ready --limit 0  # All ready work (unlimited)

# Ready work by assignee
bd --readonly ready --assignee tlongwell

# Ready work by priority
bd --readonly ready --priority 1

# Ready work by type
bd --readonly ready --type bug

# Unassigned ready work
bd --readonly ready --unassigned

# Blocked issues
bd --readonly blocked

# Blocked within an epic
bd --readonly blocked --parent bd-abc

# What blocks this issue (dependencies going down)
bd --readonly dep list bd-abc

# What this issue blocks (dependents going up)
bd --readonly dep list bd-abc --direction=up

# Dependency tree (visual)
bd --readonly dep tree bd-abc
bd --readonly dep tree bd-abc --direction=up    # What this blocks
bd --readonly dep tree bd-abc --direction=both  # Full graph

# Filter tree by status
bd --readonly dep tree bd-abc --status=open

# Detect cycles
bd --readonly dep cycles

# Full dependency graph for all open issues
bd --readonly graph --all

# Graph for a specific issue/epic
bd --readonly graph bd-abc

# Compact graph (one line per issue)
bd --readonly graph bd-abc --compact

# Epic completion status
bd --readonly epic status

# Epics eligible for closure (all children done)
bd --readonly epic status --eligible-only

# Stale issues (not updated in 30 days)
bd --readonly stale

# Stale in-progress work (likely abandoned)
bd --readonly stale --status in_progress

# Stale with custom threshold
bd --readonly stale --days 14

# Orphaned issues (in commits but still open)
bd --readonly orphans

# Lint issues for missing sections
bd --readonly lint
bd --readonly lint --type bug

# Valid issue types
bd --readonly types

# Project overview
bd --readonly status
bd --readonly status --assigned  # Your issues only

# List children of a parent/epic (alias for list --parent)
bd --readonly children bd-abc
bd --readonly children bd-abc --json
bd --readonly children bd-abc --pretty  # Tree format

# Query state dimension from labels (e.g., patrol:active → "active")
bd --readonly state bd-abc patrol
bd --readonly state bd-abc mode
bd --readonly state bd-abc health

# List all state dimensions on an issue
bd --readonly state list bd-abc

# List comments on an issue (read-only — do NOT use 'comments add')
bd --readonly comments bd-abc
bd --readonly comments bd-abc --json
bd --readonly comments bd-abc --local-time  # Local timestamps

# Recent activity feed
bd --readonly activity
bd --readonly activity --since 1h          # Last hour
bd --readonly activity --since 5m          # Last 5 minutes
bd --readonly activity --type update       # Only updates
bd --readonly activity --limit 50          # Last 50 events
bd --readonly activity --details --json    # Full details in JSON

# Find duplicate issues
bd --readonly duplicates
bd --readonly duplicates --dry-run  # Preview only (safe)

# Database info
bd --readonly info

## Research Brief: [Topic]

**Date**: YYYY-MM-DD
**Commands Run**: [bd commands you executed]

### Executive Summary
- Key finding 1 [Source: bd-abc]
- Key finding 2 [Source: bd-def]

### Project Status
- Open: N | In Progress: N | Blocked: N | Closed: N
- Ready work: N issues
- Stale issues: N

### Relevant Issues
1. **bd-abc: [Title]** (Status: in_progress, Priority: P1)
   - Type: [bug/task/feature/epic]
   - Assignee: [name]
   - Labels: [labels]
   - Summary: [description excerpt]

### Blockers & Dependencies
- bd-abc is blocked by bd-def (status: open)
- bd-ghi blocks bd-jkl and bd-mno

### Epic Progress
- **bd-epic1: [Title]** — 5/12 children closed (42%)

### Stale Work
- bd-xyz: In progress since [date], no updates in N days

### Recommendations
- [What to do based on findings]

### Gaps
- [What you looked for but didn't find]