CortexAST v2.0.0

[2.0.0] — Megatool API

Breaking Changes (with shims)

• 10 standalone MCP tools consolidated into 4 Megatools using action enum routing.
  Old tool names are still accepted as compatibility shims via the router but are deprecated.
  All new integrations should use the new API.

  Old Tool Name	New API
  map_repo	cortex_code_explorer + action: map_overview
  get_context_slice	cortex_code_explorer + action: deep_slice
  read_symbol	cortex_symbol_analyzer + action: read_source
  find_usages	cortex_symbol_analyzer + action: find_usages
  call_hierarchy	cortex_symbol_analyzer + action: blast_radius
  propagation_checklist	cortex_symbol_analyzer + action: propagation_checklist
  save_checkpoint	cortex_chronos + action: save_checkpoint
  list_checkpoints	cortex_chronos + action: list_checkpoints
  compare_checkpoint	cortex_chronos + action: compare_checkpoint
  run_diagnostics	run_diagnostics (unchanged)

Added

• Production-quality tool descriptions — all 4 megatools now carry Anthropic-best-practice-compliant descriptions with:
  • DECISION GUIDE blocks mapping user intent → action choice
  • Per-action trigger phrases (when to use, when NOT to use)
  • Required vs optional param callouts inline in enum descriptions
  • Negative anchors ("NEVER use grep/rg when this tool is available")
  • Aim for 5–8 sentences per tool, following Anthropic guideline of ≥3–4 sentences for complex tools
• USE_CASES.md — Agentic Workflow Playbook with 3 killer use cases, Mermaid flowcharts, and agent execution logs
• README.md Agentic Workflow Playbook section — links to USE_CASES.md
• .cortexast/ added to .gitignore — prevents Chronos snapshot files from being committed

Added (v2.0.0 hardening)

• Protocol-first workspace root resolution: MCP initialize (rootUri / rootPath / workspaceFolders) is captured and becomes the canonical repo_root for the session.
• Omni-root bootstraps: --root, CORTEXAST_ROOT, and IDE env vars (VSCODE_WORKSPACE_FOLDER, VSCODE_CWD, IDEA_INITIAL_DIRECTORY, PWD/INIT_CWD guarded) are supported for pre-initialize startup.
• CRITICAL dead-root safeguard: refuses to operate when the resolved root is OS root or $HOME (prevents catastrophic whole-filesystem scans).
• Windows file URI decoding: handles file:///C:/repo by stripping the extra leading slash so paths are valid on Windows.
• cortex_chronos(action=list_checkpoints) surfaces legacy flat checkpoints stored directly under checkpoints/ root (pre-namespace layout) under a (legacy) namespace section.
• cortex_chronos(action=delete_checkpoint):
  • Legacy fallback deletion: if no matches exist in a namespace dir, searches the legacy flat checkpoints/ dir.
  • Self-teaching errors for non-existent namespace purge requests.
• cortex_chronos(compare_checkpoint) supports tag_b="__live__" to compare a saved snapshot against the filesystem (requires path).
• cortex_symbol_analyzer(action=find_implementations) locates Rust/TypeScript implementors of a trait/interface.
• cortex_code_explorer(action=deep_slice) supports skeleton_only: true.
• Chronos namespaces: all Chronos actions accept an optional namespace parameter (default: "default"). Checkpoints are stored under checkpoints/<namespace>/.

Changed

• Recommended agent rules updated across all 5 client templates (VS Code, Cursor, Windsurf, Cline, Claude Desktop) to reference new megatool + action syntax
• MCP Tool Reference in README.md rewritten for megatool API with per-action parameter documentation

Changed (v2.0.0 hardening)

• Root resolution order is now protocol-first and cross-IDE safe: repoPath → MCP initialize → startup bootstrap/env vars → find-up heuristic from tool args → cwd (CRITICAL if dead).
• Output safety defaults to max_chars=8_000 and always truncates inline to prevent IDE spill-to-disk.
• Removed legacy spill-to-/tmp behaviors to keep Windows/macOS/Linux parity.

Fixed (v2.0.0 hardening)

• BUG-C1: $HOME/dead-cwd root resolution now emits a CRITICAL error with an actionable message instead of silently scanning.
• BUG-C4: Chronos lists and manages legacy flat checkpoints for backward compatibility.

---

📥 Download

Platform	Binary
Linux x86_64	cortexast-linux-x86_64
Linux ARM64	cortexast-linux-aarch64
macOS Intel	cortexast-macos-x86_64
macOS Apple Silicon	cortexast-macos-aarch64
Windows x86_64	cortexast-windows-x86_64.exe

Verify integrity with sha256sums.txt.

🚀 Quick Start

# macOS / Linux
chmod +x cortexast-*
./cortexast-macos-aarch64 --help

# Add to MCP client (Claude Desktop / Cursor)
# Set binary path in your mcpServers config

📋 Changes

• fix : change wrong name [build] (3061e6f)

---

Full docs: https://github.com/DevsHero/CortexAST

Full Changelog: v1.5.0...v2.0.0

NeuroSiphon v1.5.0

🧠 NeuroSiphon v1.5.0

[1.5.0] — 2026-02-20
Added
get_context_slice inline/spill logic — output ≤ 8 KB is returned inline (zero agent round-trip); larger output is written to /tmp/cortexast_slice_{hash}.xml with a read_file hint so agents never get a context window flood
propagation_checklist blast-radius guardrails — hard cap of 50 files and 8 000 chars per call; overflow generates a BLAST RADIUS WARNING line with remaining count; deterministic sort by domain/path
propagation_checklist ignore_gitignore + line numbers — ignore_gitignore: true bypasses .gitignore so generated/stubbed files (e.g. gRPC stubs) are included; AST-extracted line numbers shown per file (max 5, … suffix)
propagation_checklist symbol mode — pass symbol_name for cross-boundary AST tracing grouped by language/domain (Proto → Rust → TS → Python → Other); legacy changed_path mode preserved
map_repo guardrails — did-you-mean path recovery (!target_dir.exists() → lists repo-root top-level entries ≤ 30), regex-ish input warning banner, schema tip descriptions
map_repo search_filter OR support — tokenises on |, per-token substring matching; symbol-aware fallback for repos ≤ 300 files
read_symbol DX — "Symbol not found" error caps available symbol list at 30 (overflow line + count), appends recovery hint pointing to find_usages / map_repo
Changed
Tool descriptions hardened (addresses QA "Why underused" root causes):
call_hierarchy — trigger text changed to "USE BEFORE ANY FUNCTION RENAME, MOVE, OR DELETE"
save_checkpoint — "USE THIS before any non-trivial edit or refactor"
propagation_checklist — "Also USE THIS before changing any shared type, struct, or interface — strictly better than manually searching usages file-by-file"
get_context_slice — documents inline vs spill behaviour in schema description
Fixed (chore)
Renamed all remaining legacy neurosiphon identifiers in source code to cortexast:
#[command(name)] in main.rs
XML root element tag in xml_builder.rs
Debug log prefixes in vector_store.rs and scanner.rs
Updated docs/BUILDING.md to reflect cortexast binary name and current repository URL

📥 Download

Platform	Binary
Linux x86_64	neurosiphon-linux-x86_64
Linux ARM64	neurosiphon-linux-aarch64
macOS Intel	neurosiphon-macos-x86_64
macOS Apple Silicon	neurosiphon-macos-aarch64
Windows x86_64	neurosiphon-windows-x86_64.exe

Verify integrity with sha256sums.txt.

🚀 Quick Start

# macOS / Linux
chmod +x neurosiphon-*
./neurosiphon-macos-aarch64 --help

# Add to MCP client (Claude Desktop / Cursor)
# Set binary path in your mcpServers config

📋 Changes

• chore(v1.5.0): rebrand neurosiphon refs, update README, add CHANGELOG, bump version [build] (846c70d)
• feat(ux): QA feedback — inline/spill for get_context_slice + sharpen tool descriptions (76fff5d)
• feat(read_symbol): cap available symbols + recovery hint (850d239)
• feat(propagation_checklist): blast-radius guardrails (50 files, 8k chars) (cecec02)
• feat(propagation_checklist): ignore_gitignore + line numbers (1bdc4bb)
• feat(mcp): propagation_checklist symbol mode (cross-boundary) (e7a7cec)
• feat(map_repo): guardrails — did-you-mean paths + regex warning + schema tips (6089132)
• feat(map_repo): search_filter OR + symbol-aware fallback + clearer diagnostics (05ff0b8)
• build: rebuild [build] (e590371)
• feat(map_repo): dropped-file diagnostics + strict summary-first (50) + 8k cap (e7c33d7)
• chore(map_repo): improve 0-file diagnostics (supported extensions) (1e1946b)

---

Full docs: https://github.com/DevsHero/NeuroSiphon

Full Changelog: v1.4.1...v1.5.0

NeuroSiphon v1.4.1

🧠 NeuroSiphon v1.4.1

[1.4.1] — 2026-02-17
Added
map_repo dropped-file diagnostics — shows which files matched the filter, which were dropped, and why
Strict summary-first threshold (STRICT_SUMMARY_THRESHOLD = 50) — repos above this size always emit a summary header before per-file detail
Hard 8 000-char output cap on map_repo with UTF-8-safe truncation marker
Changed
map_repo progressive disclosure output format — one-liner skeleton for small files, full symbol list for large ones
Improved 0-file diagnostics: lists supported extensions and worked example

📥 Download

Platform	Binary
Linux x86_64	neurosiphon-linux-x86_64
Linux ARM64	neurosiphon-linux-aarch64
macOS Intel	neurosiphon-macos-x86_64
macOS Apple Silicon	neurosiphon-macos-aarch64
Windows x86_64	neurosiphon-windows-x86_64.exe

Verify integrity with sha256sums.txt.

🚀 Quick Start

# macOS / Linux
chmod +x neurosiphon-*
./neurosiphon-macos-aarch64 --help

# Add to MCP client (Claude Desktop / Cursor)
# Set binary path in your mcpServers config

📋 Changes

• build: rebuild [build] (e590371)
• feat(map_repo): dropped-file diagnostics + strict summary-first (50) + 8k cap (e7c33d7)
• chore(map_repo): improve 0-file diagnostics (supported extensions) (1e1946b)

---

Full docs: https://github.com/DevsHero/NeuroSiphon

Full Changelog: v1.4.0...v1.4.1

NeuroSiphon v1.4.0

🧠 NeuroSiphon v1.4.0

[1.4.0] — 2026-02-15
Added
Rebrand: NeuroSiphon → CortexAST v1.4.0; all tool names shortened (cortex_map → map_repo, etc.)
Chronos AST Time Machine: save_checkpoint, list_checkpoints, compare_checkpoint — disk-backed semantic symbol snapshots; structural diff ignores whitespace/line-number noise
propagation_checklist (initial): given a changed file path, generates a cross-language propagation checklist
find_usages categories: Calls / Type References / Field Initializations
read_symbol batch mode via symbol_names: [...]
.proto file support in map_repo, read_symbol, find_usages via ProtoDriver
const, static, type alias support for Rust, TypeScript, Go extractions
Changed
Aggressive prompt-injection descriptions to steer agent tool preference
map_repo search_filter parameter added

📥 Download

Platform	Binary
Linux x86_64	neurosiphon-linux-x86_64
Linux ARM64	neurosiphon-linux-aarch64
macOS Intel	neurosiphon-macos-x86_64
macOS Apple Silicon	neurosiphon-macos-aarch64
Windows x86_64	neurosiphon-windows-x86_64.exe

Verify integrity with sha256sums.txt.

🚀 Quick Start

# macOS / Linux
chmod +x neurosiphon-*
./neurosiphon-macos-aarch64 --help

# Add to MCP client (Claude Desktop / Cursor)
# Set binary path in your mcpServers config

📋 Changes

• build : rebuild [build] (920ab87)
• feat(symbols): const/static/type support for Rust+TS+Go; map_repo max_chars param (3f18773)
• update: readme (601b77d)
• update: readme (d997037)
• feat(mcp): map_repo search_filter, read_symbol batching, find_usages categories, propagation_checklist (ef33a5a)
• feat(proto): add ProtoDriver — map_repo/read_symbol/find_usages now support .proto files [build] (2ecc21c)

---

Full docs: https://github.com/DevsHero/NeuroSiphon

Full Changelog: v1.3.1...v1.4.0

NeuroSiphon v1.3.1

🧠 NeuroSiphon v1.3.1

[1.3.1] — 2026-02-05

Added
repo_map, call_hierarchy, run_diagnostics MCP tools
Auto-detect project type for run_diagnostics (cargo check / tsc --noEmit)
Compiler errors mapped back to 1-line AST source context

[1.3.0] — 2026-02-05

Added

• repo_map, call_hierarchy, run_diagnostics MCP tools
• Auto-detect project type for run_diagnostics (cargo check / tsc --noEmit)
• Compiler errors mapped back to 1-line AST source context

📥 Download

Platform	Binary
Linux x86_64	neurosiphon-linux-x86_64
Linux ARM64	neurosiphon-linux-aarch64
macOS Intel	neurosiphon-macos-x86_64
macOS Apple Silicon	neurosiphon-macos-aarch64
Windows x86_64	neurosiphon-windows-x86_64.exe

Verify integrity with sha256sums.txt.

🚀 Quick Start

# macOS / Linux
chmod +x neurosiphon-*
./neurosiphon-macos-aarch64 --help

# Add to MCP client (Claude Desktop / Cursor)
# Set binary path in your mcpServers config

📋 Changes

• update: change embedding model [build] (d56c023)
• fix(inspector): show all Rust symbols; better Python attribute calls; add push_str noise (597e489)
• fix: repo_map symbols, Python call_hierarchy, outgoing call noise — v1.3.1 (f38d1e5)
• feat: Symbol Sniper — 2-stage hybrid router, deterministic exact-match ranking (3ef989d)
• feat: repo_map, call_hierarchy, diagnostics tools — v1.3.0 [build] (0444825)

---

Full docs: https://github.com/DevsHero/NeuroSiphon

Full Changelog: v1.2.0...v1.3.1

NeuroSiphon v1.2.0

🧠 NeuroSiphon v1.2.0

[1.2.0] — 2026-01-28

Added

• AST X-Ray (read_symbol) and find_usages tracer tools
• v2 vector index with xxh3 content hashing for JIT incremental updates

📥 Download

Platform	Binary
Linux x86_64	neurosiphon-linux-x86_64
Linux ARM64	neurosiphon-linux-aarch64
macOS Intel	neurosiphon-macos-x86_64
macOS Apple Silicon	neurosiphon-macos-aarch64
Windows x86_64	neurosiphon-windows-x86_64.exe

Verify integrity with sha256sums.txt.

🚀 Quick Start

# macOS / Linux
chmod +x neurosiphon-*
./neurosiphon-macos-aarch64 --help

# Add to MCP client (Claude Desktop / Cursor)
# Set binary path in your mcpServers config

📋 Changes

• feat: AST X-Ray + tracer tools, v2 index [build] (3fb7d75)

---

Full docs: https://github.com/DevsHero/NeuroSiphon

Full Changelog: v1.1.0...v1.2.0

NeuroSiphon v1.1.0

🧠 NeuroSiphon v1.1.0

🏢 Monorepo & Huge-Codebase Support

NeuroSiphon ships production-grade support for the most complex repository structures:

Feature	Details
Auto-detection	Repos with ≥5 declared workspace members activate huge mode automatically
Nested services	Scans up to 3 levels deep by default — handles services/*/, apps/*/, packages/*/ patterns
Budget splitting	Each workspace member gets a proportional token share; no single service crowds out others
Root context	Top-level workspace manifests and READMEs always included at minimal cost
Explicit control	--huge forces huge mode; --list-members shows what was detected

Huge-Codebase Benchmark ( 22 services, 429 files)

Mode	Files Included	Output Size	Est. Tokens	Time
--target . (normal)	~32	~128 KB	~32K	0.57s
--target . --huge	274	314 KB	~78K	0.60s
--target services/core_api	63	83 KB	~21K	0.08s
--query "embedding pipeline"	21	19 KB	~5K	0.25s

All benchmarks: Apple M4 Pro, release build.

.neurosiphon.json — Huge-Codebase Config

{
  "huge_codebase": {
    "enabled": true,
    "member_scan_depth": 3,
    "min_member_budget": 4000,
    "include_members": ["services/*", "shared/*"],
    "exclude_members": ["**/tmp", "**/sample-*"]
  }
}

🛡️ Bulletproof Design

NeuroSiphon is engineered to survive “dirty” enterprise monorepos:

• Binary Safety: Detects null bytes and skips binary/non-UTF8 files safely (no crashes on .exe, encrypted keys, or garbage bytes)
• Resource Guard: Strict 1MB hard limit per file + line-length checks to prevent minified/generated code from hanging the parser
• Self-Healing Index: Detects corrupted vector indices and auto-rebuilds on the next query (no manual cleanup required)
• Chaos Tested: Validated against edge cases (null bytes, massive single-line files, and broken JSON)

---

📥 Download

Platform	Binary
Linux x86_64	neurosiphon-linux-x86_64
Linux ARM64	neurosiphon-linux-aarch64
macOS Intel	neurosiphon-macos-x86_64
macOS Apple Silicon	neurosiphon-macos-aarch64
Windows x86_64	neurosiphon-windows-x86_64.exe

Verify integrity with sha256sums.txt.

🚀 Quick Start

# macOS / Linux
chmod +x neurosiphon-*
./neurosiphon-macos-aarch64 --help

# Add to MCP client (Claude Desktop / Cursor)
# Set binary path in your mcpServers config

📋 Changes

• feat: v1.1.0 - support monorepo & nested huge codebase [build] (9e5e21f)
• update: remove println and add bench test (fdc6d78)
• fix: resolve RustSec ring advisory (abd4fd1)
• update: readme (5d5aaa4)
• update: add benchmark result (efdc868)
• build: Github action [build] (7a31aab)
• ci: fix macOS runners + sha256 checksum step (f4ade00)
• build: v.1.0.0 [build] (8c288e6)

---

Full docs: https://github.com/DevsHero/NeuroSiphon

Full Changelog: v1.0.0...v1.1.0

NeuroSiphon v1.0.0

🧠 NeuroSiphon v1.0.0

"Extract the Signal. Discard the Noise."

We are proud to announce the first stable release of NeuroSiphon (formerly context-slicer). This release marks a complete re-architecture to Pure Rust, delivering a context optimization engine that is strictly God Tier in performance, quality, and resilience.

🚀 Key Highlights

1. ☢️ Nuclear Optimization

We don't just "read" files; we refine them. NeuroSiphon uses AST-based analysis (Tree-sitter) to strip 100% of the fat:

• Import Nuking: Collapses massive import lists into single-line hints (// ... (20 imports)).
• Indentation Flattening: Strips leading whitespace from brace-based languages, saving huge amounts of tokens.
• Smart Skeletonization: Preserves core logic signatures while pruning implementation details.
• Result: Up to 60% reduction in token usage compared to raw text.

2. ⚡️ JIT Hybrid Search (Zero Latency)

Say goodbye to stale indexes and heavy background watchers.

• Just-In-Time Indexing: Checks file timestamps and updates the vector index milliseconds before you search.
• Local Hybrid RAG: Combines Model2Vec (Pure Rust, no ONNX runtime) with Graph Ranking to find exactly what you need.
• Performance: Scans and indexes typical codebases in < 0.1 seconds.

3. 🛡️ Bulletproof Resilience (Chaos Tested)

Engineered to survive "dirty" enterprise repositories.

• Binary Safety: Automatically detects and skips binary/non-UTF8 files.
• Resource Guards: Hard limits on file size (1MB) and line length to prevent parser hangs on minified code.
• Self-Healing: Automatically detects and rebuilds corrupted indices silently.

4. 🔌 Native MCP Support

Drop-in integration for Claude Desktop and Cursor. No plugins, no API keys, just pure local context.

---

🏆 NeuroSiphon v1.0.0: Official Benchmarks

Target: NeuroSiphon Source Code (10+ Rust Files, Core Logic)

Hardware: Apple M4 pro / 14CPU 20GPU 24GB RAM

Metric	Raw Source (Baseline)	🧠 NeuroSiphon (Nuclear)	Improvement
Total Size	127,536 Bytes	9,842 Bytes	92.3% Smaller
Est. Tokens (≈ bytes/4)	~31,884 tokens	~2,460 tokens	29,424 Tokens Saved
Processing Time	N/A	0.07 Seconds	Instant (JIT)
Information Density	Low (Noise Heavy)	God Tier (Pure Logic)	Refined
LLM Context Space	100% Full	7.7% Used	92.3% Free Space

---

📦 Installation

Build from Source

git clone [https://github.com/DevsHero/NeuroSiphon](https://github.com/DevsHero/NeuroSiphon)
cd NeuroSiphon
cargo build --release

### 📥 Download

| Platform | Binary |
|---|---|
| Linux x86_64 | `neurosiphon-linux-x86_64` |
| Linux ARM64  | `neurosiphon-linux-aarch64` |
| macOS Intel  | `neurosiphon-macos-x86_64` |
| macOS Apple Silicon | `neurosiphon-macos-aarch64` |
| Windows x86_64 | `neurosiphon-windows-x86_64.exe` |

Verify integrity with `sha256sums.txt`.

### 🚀 Quick Start

```bash
# macOS / Linux
chmod +x neurosiphon-*
./neurosiphon-macos-aarch64 --help

# Add to MCP client (Claude Desktop / Cursor)
# Set binary path in your mcpServers config

###Quick MCP Setup
Add to your claude_desktop_config.json or mcp.json (vscode):

{
  "mcpServers": {
    "neurosiphon": {
      "command": "/absolute/path/to/neurosiphon",
      "args": ["mcp"]
    }
  }
}

Full docs: https://github.com/DevsHero/NeuroSiphon

Full Changelog: https://github.com/DevsHero/NeuroSiphon/commits/v1.0.0