Common Issues

Common Issues & Solutions

"No files matched"

Problem: sigmap ask "query" returns empty results

Causes & Fixes:

1. No context file generated yet

   sigmap  # Generate context first
   sigmap ask "query"

2. Source directories not configured

   sigmap --init
   # Edit gen-context.config.json to add srcDirs

3. All files excluded

   sigmap --report
   # Check if files are being dropped due to .contextignore

---

"Token budget exceeded"

Problem: Context file is too large, files are being dropped

Solution 1: Reduce budget

{
  "maxTokens": 4000
}

Solution 2: Use per-module strategy

{
  "strategy": "per-module"
}

Solution 3: Be more selective with .contextignore

# Skip test files
*.test.js
*.spec.js

# Skip generated code
*.generated.js
dist/
build/

Check status:

sigmap --report
# Shows token usage and which files were dropped

---

"Stale context file"

Problem: New files aren't being picked up

Solution:

rm .context/context.md
sigmap
# Regenerates from scratch

Or use auto-regeneration:

sigmap --watch
# Regenerates on file changes

---

"Import graph is empty"

Problem: explain_file shows no callers/imports

See: Import Graph Debugging

---

"Can't find module X"

Problem: TypeScript/Python imports not resolving

Causes:

• baseUrl in tsconfig.json not set
• Python __init__.py missing
• Relative import paths too deep

Debug:

sigmap --diagnose-extractors
# Shows extraction details for each file

---

"Performance is slow"

Problem: Generating context takes >30 seconds

See: Performance Tuning

---

Installation Problems

See: Installation Troubleshooting

---

Still Stuck?

1. Check FAQ
2. Search GitHub Issues
3. Run sigmap --health to get diagnostic info
4. Open a new issue with:
   • Output of sigmap --health
   • gen-context.config.json (sanitized)
   • Language and project size