Improve grep instructions snippet context and formatting (#143)

* Increase grep instructions snippet context to 40 chars and wrap in backtick guards

- Changed context size from 35 to 40 characters before/after match
- Wrapped instruction snippets in backtick guards in human output for clarity
- Normalized fallback snippet length to 90 chars to match increased context
- Updated test bounds accordingly

https://claude.ai/code/session_01D93T3gBkbFFoeiSaK2MG89

* Add changelog entry for grep snippet improvements

https://claude.ai/code/session_01D93T3gBkbFFoeiSaK2MG89

* Use quadruple backtick guards for instructions snippets

Single backticks would break when instructions contain markdown with
backticks. Quadruple backticks are safe even against triple-backtick
code fences commonly found in MCP server instructions.

https://claude.ai/code/session_01D93T3gBkbFFoeiSaK2MG89

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: jancurn

CHANGELOG.md

@@ -16,6 +16,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 
 - Reordered `mcpc --help` to show Commands before Options for better discoverability
+- Increased `grep` instructions snippet context from 35 to 40 characters and wrapped snippets in backtick guards for clearer AI agent consumption
 
 ### Security
 

src/cli/commands/grep.ts

@@ -128,7 +128,7 @@ function buildInstructionsSearchText(instructions: string, sessionName: string):
 
 /**
  * Extract a short snippet from instructions text around the first match.
- * The snippet is at most ~70 chars longer than the matched text, with ellipsis
+ * The snippet is at most ~80 chars longer than the matched text, with ellipsis
  * added when the snippet doesn't reach the start/end of the instructions.
  * Whitespace (including newlines) is normalized to single spaces.
  */
@@ -162,7 +162,7 @@ export function extractInstructionsSnippet(
     matchEnd = matchStart + needle.length;
   }
 
-  const contextSize = 35;
+  const contextSize = 40;
   let snippetStart = Math.max(0, matchStart - contextSize);
   let snippetEnd = Math.min(normalized.length, matchEnd + contextSize);
 
@@ -268,7 +268,7 @@ async function searchClient(
     const snippet = extractInstructionsSnippet(instructionsText, pattern, options);
     // Fallback: if snippet extraction fails (e.g. match was on session name prefix), show truncated text
     matchedInstructions =
-      snippet || instructionsText.replace(/\s+/g, ' ').trim().slice(0, 80) + '…';
+      snippet || instructionsText.replace(/\s+/g, ' ').trim().slice(0, 90) + '…';
   }
 
   return {
@@ -421,7 +421,7 @@ function formatGrepResultHuman(
       pattern && options
         ? highlightMatch(result.instructions, pattern, options)
         : result.instructions;
-    lines.push(`${indent}${chalk.bold('Instructions:')}  ${chalk.dim(snippet)}`);
+    lines.push(`${indent}${chalk.bold('Instructions:')}  ${chalk.dim('````' + snippet + '````')}`);
   }
   lines.push(
     ...formatResultSection('Tools', result.tools, formatToolLine as (item: never) => string, indent)

test/unit/cli/grep.test.ts

@@ -82,7 +82,7 @@ describe('extractInstructionsSnippet', () => {
     expect(result).toContain('mmm');
     expect(result!.startsWith('\u2026')).toBe(true);
     // total length should be roughly pattern.length + 50
-    expect(result!.length).toBeLessThanOrEqual('mmm'.length + 80);
+    expect(result!.length).toBeLessThanOrEqual('mmm'.length + 90);
   });
 
   it('adds trailing ellipsis when match is far from the end', () => {
@@ -101,7 +101,7 @@ describe('extractInstructionsSnippet', () => {
     expect(result).toContain('lazy');
     expect(result!.startsWith('\u2026')).toBe(true);
     expect(result!.endsWith('\u2026')).toBe(true);
-    expect(result!.length).toBeLessThanOrEqual('lazy'.length + 80);
+    expect(result!.length).toBeLessThanOrEqual('lazy'.length + 90);
   });
 
   it('normalizes whitespace including newlines', () => {
@@ -164,8 +164,8 @@ describe('extractInstructionsSnippet', () => {
     const result = extractInstructionsSnippet(text, pattern, {});
     expect(result).toBeTruthy();
     expect(result).toContain(pattern);
-    // Snippet should be at most about pattern.length + 50 + 2 (for ellipsis chars)
-    expect(result!.length).toBeLessThanOrEqual(pattern.length + 80);
+    // Snippet should be at most about pattern.length + 80 + 2 (for ellipsis chars)
+    expect(result!.length).toBeLessThanOrEqual(pattern.length + 90);
   });
 
   it('handles case-insensitive regex', () => {