secondbrain-search

# Semantic Search

Search your secondbrain knowledge base using semantic similarity (meaning-based) and full-text search.

## Prerequisites

1. **qmd installed**: Check with `which qmd`
   - Install: `bun install -g qmd` or `npm install -g qmd`
   - First run downloads ~1.5GB models

2. **Search initialized**: Check for `.claude/search/` directory
   - If not initialized, suggest running `/secondbrain-search-init`

## Usage

```
/secondbrain-search "your natural language query"
/secondbrain-search --entity=adrs "database migration"
/secondbrain-search --recent=30d "authentication"
/secondbrain-search --status=active --tag=kubernetes "deployment"
```

## Workflow

### Step 1: Validate Environment

```bash
# Check qmd is installed
which qmd

# Check search is initialized
ls .claude/search/
```

If qmd not installed:
```
qmd is not installed. Install it with:
  bun install -g qmd
  # or
  npm install -g qmd

Then initialize search with: /secondbrain-search-init
```

If search not initialized:
```
Search not initialized for this project.
Run: /secondbrain-search-init
```

### Step 2: Parse Query and Filters

Extract from user input:

| Filter | Syntax | Example |
|--------|--------|---------|
| Entity | `--entity=<type>` | `--entity=adrs,notes` |
| Recent | `--recent=<period>` | `--recent=7d`, `--recent=2w`, `--recent=1m` |
| Date from | `--from=<date>` | `--from=2025-01-01` |
| Date to | `--to=<date>` | `--to=2025-12-31` |
| Status | `--status=<status>` | `--status=active`, `--status=!archived` |
| Tag | `--tag=<tag>` | `--tag=kubernetes` |
| Limit | `--limit=<n>` | `--limit=10` (default: 5) |
| Format | `--format=<fmt>` | `--format=brief`, `--format=detailed`, `--format=json` |

### Step 3: Execute Search

Run qmd search command:

```bash
cd <project_root>
qmd query "<user_query>" --json --limit=<limit>
```

Parse JSON output:
```json
{
  "results": [
    {
      "id": "docs/adrs/ADR-0012-kubernetes-deployment.md",
      "score": 0.92,
      "title": "Kubernetes Deplo