SpecMem Code - Codebase Search (user)

REQUIRED: Check Arguments First

IF no arguments provided OR args is empty/whitespace/help/-h/--help:

OUTPUT THIS HELP AND STOP:

SpecMem Code - Semantic Codebase Search

USAGE:
  /specmem-code <query>           Search code by meaning
  /specmem-code auth middleware   Find authentication middleware
  /specmem-code --limit 20 error  Search with more results

OPTIONS:
  --limit N            Max results (default: 10, max: 100)
  --threshold N        Min similarity score 0-1 (default: 0.1)
  --lang LANG          Filter by language (typescript, python, go, rust, etc.)
  --file PATTERN       Filter by file pattern (e.g., "src/**/*.ts")
  --type TYPE          Filter by definition type (function, class, method, etc.)
  --zoom N             Zoom level 0-100: 0=signature only, 50=balanced, 100=full (default: 50)
  --no-memory-links    Skip linking code to related memories
  --no-attribution     Skip user/claude attribution
  --summarize          Truncate content for compact view

EXAMPLES:
  /specmem-code websocket handler
  /specmem-code --limit 5 form validation
  /specmem-code --lang python machine learning
  /specmem-code --file "src/api/*" route handlers
  /specmem-code --zoom 0 function signatures
  /specmem-code --type class authentication

DIFFERENCE FROM /specmem-pointers:
  - /specmem-code: Basic code search (NO tracebacks by default)
  - /specmem-pointers: Code search WITH tracebacks (caller/callee analysis)

RELATED:
  /specmem-pointers  Code search WITH tracebacks
  /specmem-find      Search memories (not code)

DO NOT PROCEED WITHOUT A QUERY.

---

Has Query - Execute Search

Parse the arguments:

• --limit N -> limit parameter (default: 10, max: 100)
• --threshold N -> threshold parameter (default: 0.1)
• --lang LANG -> language parameter
• --file PATTERN -> filePattern parameter
• --type TYPE -> definitionTypes parameter (array)
• --zoom N -> zoom parameter (0-100, default: 50)
• --no-memory-links -> includeMemoryLinks: false
• --no-attribution -> includeAttribution: false
• --summarize -> summarize: true
• Remaining text = query

VALIDATION:

• If query is empty after parsing options -> STOP and show help
• If limit < 1 or limit > 100 -> ERROR: "limit must be 1-100"
• If threshold < 0 or threshold > 1 -> ERROR: "threshold must be 0-1"
• If zoom < 0 or zoom > 100 -> ERROR: "zoom must be 0-100"

CALL THIS MCP TOOL NOW (do not just display it, actually invoke it):

Use mcp__specmem__find_code_pointers with these parameters:

• query: the extracted search query (REQUIRED)
• limit: parsed limit or 10
• threshold: parsed threshold or 0.1
• language: if --lang was provided
• filePattern: if --file was provided
• definitionTypes: if --type was provided (as array)
• zoom: parsed zoom or 50
• includeTracebacks: false (DEFAULT for /specmem-code)
• includeMemoryLinks: true unless --no-memory-links
• includeAttribution: false unless explicitly requested
• summarize: true if --summarize provided
• maxContentLength: 0 (no truncation by default)

Format the results:

CODE SEARCH: "<query>"
Found N results (threshold: X.XX)

[1] <file>:<line> | <type> | score: <similarity>
    <code snippet>

    Memory Links: <related memories if available>

[2] <file>:<line> | <type> | score: <similarity>
    <code snippet>
...

TIP: Use /specmem-pointers for traceback analysis (what uses this code)

Show code context and memory links if available.