Search file contents. Non-summary results return `LINE:HASH` anchors usable directly by `edit`; no follow-up `read` is needed.

## Modes

- Default: matching lines only. Output lines are `path:>>LINE:HASH|content`; `>>` marks matches.
- `context: N`: include N lines before/after each match. Context lines use `path:  LINE:HASH|content`; nearby ranges are merged/deduped.
- `summary: true`: return per-file match counts only — no line content or anchors. Use first for broad searches, then narrow with `path`/`glob`.
- `scope: "symbol"`: group matches by enclosing symbol. By default returns the full symbol block. `scopeContext: N` windows to ±N lines around each match, clipped to the symbol; `0` returns only match lines. Ignored when `summary: true`.

## Parameters

- `pattern` — regex by default; use `literal: true` for exact strings or regex metacharacters.
- `path` — file or directory, default cwd.
- `glob` — file filter, e.g. `'*.ts'` or `'**/*.test.ts'`.
- `ignoreCase` — case-insensitive search.
- `context` — surrounding lines for normal grep.
- `limit` — max matches, default 100.
- `summary` — counts only, no anchors.
- `scope` — only `"symbol"` is supported.
- `scopeContext` — non-negative context within symbol scope; requires `scope: "symbol"`.

## Truncation and guidance

If matches hit `limit`, output appends `[Results truncated at N matches — refine pattern or increase limit]`. Large non-summary results may cap displayed matches per file and/or head-truncate by output budget; narrow with `summary`, `path`, `glob`, or a more specific pattern.

Use `grep` for text search. For structural code patterns such as calls, imports, or JSX, prefer `ast_search`.