SpecMem Pointers - Semantic Code Search with Tracebacks (user)

IMMEDIATE ACTION REQUIRED

Step 1: Check Input Look at what comes after /specmem-pointers:

• If EMPTY, whitespace only, "help", "--help", or "-h" → Show HELP below, STOP
• Otherwise → Continue to Step 2

Step 2: Parse Arguments Extract from input:

• --limit N → set limit (default: 10, max: 100)
• --threshold N → set threshold (default: 0.1, range: 0-1)
• --gallery → galleryMode: true (Mini COT analysis)
• --camera → cameraRollMode: true (drilldown IDs)
• --zoom-level LEVEL → zoomLevel: ultra-wide/wide/normal/close/macro
• --zoom N → zoom: 0-100 (0=signature, 50=balanced, 100=full)
• --lang LANG → set language filter
• --file PATTERN → set filePattern
• --type TYPE → set definitionTypes (function, class, method, etc.)
• --no-tracebacks → includeTracebacks: false
• --no-memory-links → includeMemoryLinks: false
• --with-attribution → includeAttribution: true
• --cot-scoring → useCotScoring: true
• --summarize → summarize: true
• --max-content N → maxContentLength: N
• Everything else = the 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"

Step 3: EXECUTE THIS MCP TOOL NOW

mcp__specmem__find_code_pointers({
  query: "<extracted query>",
  limit: <limit or 10>,
  threshold: <threshold or 0.1>,
  includeTracebacks: <true unless --no-tracebacks>,
  includeMemoryLinks: <true unless --no-memory-links>,
  includeAttribution: <true if --with-attribution>,
  galleryMode: <true if --gallery>,
  cameraRollMode: <true if --camera>,
  useCotScoring: <true if --cot-scoring>,
  zoomLevel: "<zoom level if provided>",
  zoom: <zoom value if provided or 50>,
  language: "<lang if provided>",
  filePattern: "<pattern if provided>",
  definitionTypes: <[type] if provided>,
  summarize: <true if --summarize>,
  maxContentLength: <N if --max-content>
})

Step 4: Display Results Show the tool output formatted as:

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

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

    USED BY (Tracebacks):
    - <caller-file>:<line>
    - <caller-file>:<line>

    Memory Links: <related memories if available>
    Attribution: <user/assistant if enabled>

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

    USED BY:
    - <caller-file>:<line>
...

If --gallery, include Mini COT analysis summary. If --camera, mention drilldown IDs for exploration. If --with-attribution, show who created/modified the code.

---

HELP

SpecMem Pointers - Semantic Code Search with Tracebacks

USAGE:
  /specmem-pointers <query>
  /specmem-pointers authentication flow
  /specmem-pointers --gallery websocket handler
  /specmem-pointers --limit 20 database queries

OPTIONS:
  --limit N              Max results (default: 10, max: 100)
  --threshold N          Min similarity 0-1 (default: 0.1)
  --gallery              Enable Mini COT analysis (deeper insights)
  --camera               Enable camera roll mode (drilldown IDs)
  --zoom-level LEVEL     ultra-wide/wide/normal/close/macro
  --zoom N               Zoom 0-100: 0=sig only, 50=balanced, 100=full
  --lang LANG            Filter by language (typescript, python, etc.)
  --file PATTERN         Filter by file pattern (e.g., "src/**/*.ts")
  --type TYPE            Filter by type (function, class, method, etc.)
  --no-tracebacks        Skip caller/callee analysis
  --no-memory-links      Skip memory attribution
  --with-attribution     Show user/claude attribution
  --cot-scoring          Enable Mini COT relevance scoring
  --summarize            Truncate content for compact view
  --max-content N        Max content length (0=unlimited)

EXAMPLES:
  /specmem-pointers error handling middleware
  /specmem-pointers --gallery api validation
  /specmem-pointers --limit 15 form components
  /specmem-pointers --lang python data processing
  /specmem-pointers --zoom 0 function signatures
  /specmem-pointers --camera --zoom-level wide search patterns
  /specmem-pointers --with-attribution authentication logic

WHAT IT DOES:
  1. Semantic search finds code by MEANING (not keywords)
  2. Shows tracebacks - what files import/use the code
  3. Links code to related memories (context from past work)
  4. Gallery mode adds AI analysis of results
  5. Camera roll mode enables drill-down exploration

TRACEBACKS:
  Shows which files use the found code:
  - Import relationships
  - Function calls
  - Class usage
  - Caller/callee analysis

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

RELATED:
  /specmem-code     Code search WITHOUT tracebacks
  /specmem-find     Search memories (not code)
  /specmem-changes  View file change history