find

# Task Find Command

Search and locate tasks across all orchestrations using various criteria.

## Usage

```
/task-find [search-term] [options]
```

## Description

Powerful search functionality to quickly locate tasks by ID, content, status, dependencies, or any other criteria. Supports regex, fuzzy matching, and complex queries.

## Basic Search

### By Task ID
```
/task-find TASK-001
/task-find TASK-*
```

### By Title/Content
```
/task-find "authentication"
/task-find "payment processing"
```

### By Status
```
/task-find --status in_progress
/task-find --status qa,completed
```

## Advanced Search

### Regular Expression
```
/task-find --regex "JWT|OAuth"
/task-find --regex "TASK-0[0-9]{2}"
```

### Fuzzy Search
```
/task-find --fuzzy "autentication"  # finds "authentication"
/task-find --fuzzy "paymnt"         # finds "payment"
```

### Multiple Criteria
```
/task-find --status todos --priority high --type feature
/task-find --agent dev-backend --created-after yesterday
```

## Search Operators

### Boolean Operators
```
/task-find "auth AND login"
/task-find "payment OR billing"
/task-find "security NOT test"
```

### Field-Specific Search
```
/task-find title:"user authentication"
/task-find description:"security vulnerability"
/task-find agent:dev-frontend
/task-find blocks:TASK-001
```

### Date Ranges
```
/task-find --created "2024-03-10..2024-03-15"
/task-find --modified "last 3 days"
/task-find --completed "this week"
```

## Output Formats

### Default List View
```
Found 3 tasks matching "authentication":

TASK-001: Implement JWT authentication
  Status: in_progress | Agent: dev-frontend | Created: 2024-03-15
  Location: /task-orchestration/03_15_2024/auth_system/tasks/in_progress/

TASK-004: Add OAuth2 authentication  
  Status: todos | Priority: high | Blocked by: TASK-001
  Location: /task-orchestration/03_15_2024/auth_system/tasks/todos/

TASK-007: Authentication middleware tests
  Status: todos | Type: test | Depends on: TASK-001
  Location: /task-orchestration/03_15_2024/auth_system/tasks/todos/
```

### Detailed View
```
/task-find TASK-001 --detailed
```
Shows full task content including description, implementation notes, and history.

### Tree View
```
/task-find --tree --root TASK-001
```
Shows task and all its dependencies in tree format.

## Filtering Options

### By Orchestration
```
/task-find --orchestration "03_15_2024/payment_system"
/task-find --orchestration "*/auth_*"
```

### By Properties
```
/task-find --has-dependencies
/task-find --no-dependencies
/task-find --blocking-others
/task-find --effort ">4h"
```

### By Relationships
```
/task-find --depends-on TASK-001
/task-find --blocks TASK-005
/task-find --related-to TASK-003
```

## Special Searches

### Find Circular Dependencies
```
/task-find --circular-deps
```

### Find Orphaned Tasks
```
/task-find --orphaned
```

### Find Duplicate Tasks
```
/task-find --duplicates
```

### Find Stale Tasks
```
/task-find --stale --days 7
```

## Quick Filters

### Ready to Start
```
/task-find --ready
```
Shows todos with no blocking dependencies.

### Critical Path
```
/task-find --critical-path
```
Shows tasks on the critical path.

### High Impact
```
/task-find --high-impact
```
Shows tasks blocking multiple others.

## Export Options

### Copy Results
```
/task-find "auth" --copy
```
Copies results to clipboard.

### Export Paths
```
/task-find --status todos --export paths
```
Exports file paths for batch operations.

### Generate Report
```
/task-find --report
```
Creates detailed search report.

## Examples

### Example 1: Find Work for Agent
```
/task-find --status todos --suitable-for dev-frontend --ready
```

### Example 2: Find Blocking Issues
```
/task-find --status on_hold --show-blockers
```

### Example 3: Security Audit
```
/task-find "security OR auth OR permission" --type "feature,bugfix"
```

### Example 4: Sprint Planning
```
/task-find --status todos --effort "<4h" --no-dependencies
```

## Search Shortcuts

### Recent Tasks
```
/task-find --recent 10
```

### My Tasks
```
/task-find --mine  # Uses current agent context
```

### Modified Today
```
/task-find --modified today
```

## Complex Queries

### Compound Search
```
/task-find '(title:"auth" OR description:"security") AND status:todos AND -blocks:*'
```

### Saved Searches
```
/task-find --save "security-todos"
/task-find --load "security-todos"
```

## Performance Tips

1. **Use Indexes**: Status and ID searches are fastest
2. **Narrow Scope**: Specify orchestration when possible
3. **Cache Results**: Use `--cache` for repeated searches
4. **Limit Results**: Use `--limit 20` for large result sets

## Integration

### With Other Commands
```
/task-find "payment" --status todos | /task-move in_progress
```

### Batch Operations
```
/task-find --filter "priority:low" | /task-update priority:medium
```

## Notes

- Searches across all task files in task-orchestration/
- Case-insensitive by default (use --case for case-sensitive)
- Results sorted by relevance unless specified otherwise
- Supports command chaining with pipe operator
- Search index updated automatically on file changes