search-threads

Search Threads with Filters

Search: $ARGUMENTS

Filter Syntax

Parse these filters from arguments:

• role:X - Filter by role (planner, implementer, critic, tester, pm, scribe)
• type:X - Filter by entry type (Note, Plan, Decision, PR, Closure)
• after:DATE / before:DATE - Time range (ISO format: 2024-01-15)
• thread:X - Specific thread topic
• status:X - Thread status (OPEN, CLOSED)
• agent:X - Filter by agent name
• or: (flag, no value) - Use OR token matching instead of AND (see below)
• Remaining text becomes the search query

Token matching default is AND. Multi-keyword queries like "decided committed resolved" require ALL tokens present in the same entry — this often returns 0 hits. Add or: to use OR matching: any token qualifies. Use or: whenever searching for any of several keywords.

Parsing Rules

1. Split $ARGUMENTS on whitespace into tokens
2. A token is a filter if it matches ^(role|type|after|before|thread|status|agent):[^\s]+$
3. The or: token (no value) sets query_operator="OR" — consume it as a flag, not query text
4. The filter key is everything before the first :, the value is everything after
5. All non-filter tokens are joined with spaces to form the query text

Edge Cases

• role:planner:advanced → key=role, value=planner:advanced (first colon splits)
• Multiple values for same key → last one wins
• Empty value (role:) → ignore, treat entire token as query text
• No query text → search with filters only (empty query string)

Steps

1. Parse arguments into filters and query text using rules above.

2. Load MCP tool:

   ToolSearch: select:mcp__watercooler__watercooler_search
   

3. Execute search with parsed query and filters. Pass each filter as its own named parameter — omit any filter param that was not explicitly parsed from the arguments. Do NOT use a filters={} dict (no such parameter exists):

   # Example: only role was given
   mcp__watercooler__watercooler_search(
     query="config", mode="entries", role="planner"
   )
   # Example: multiple filters
   mcp__watercooler__watercooler_search(
     query="", mode="entries", role="planner", entry_type="Decision"
   )
   # Example: thread + status filters
   mcp__watercooler__watercooler_search(
     query="", mode="entries", thread_topic="mcp-migration", thread_status="OPEN"
   )
   # Example: no filters, just query text
   mcp__watercooler__watercooler_search(
     query="config migration", mode="entries"
   )
   # Example: OR mode — any of several keywords (use when or: flag is set)
   mcp__watercooler__watercooler_search(
     query="decided resolved committed opted agreed chosen",
     query_operator="OR", mode="entries"
   )