Skip to content

Changelog

All notable changes to CKB are documented here.

CKB v8.0.0

v8.0.0

Changelog

Features

  • 3e824e5df0b76ee56e05815964027c064fa82db7 feat(cli): add ckb metrics command for wide-result telemetry
  • e8d13d270a52d3f81e3c25efe07ea3edd995d736 feat(config): add environment variable overrides and config show command (#51)
  • 407cfa775bc496d87116084b766102c1e5663c85 feat(daemon): add auto-index updates via watcher and webhook API (#45)
  • dda68a1e4f72d90b1034d424bb6e49b99cfedeac feat(impact): add Change Impact Analysis with test mapping and CI integration (#56)
  • 250b09ecef28f42492db87bcdbc5b7cbaae5886e feat(impact): add transitive analysis and blast radius summary (#55)
  • dd5e80d7c328fa1253a179fd041a59037b53dcdf feat(incremental): add multi-language support for incremental indexing (#58)
  • 6a4fb70ee4cded53d98c569daed39f30457d2b0e feat(mcp): Add runtime metrics for wide-result tools
  • 644e40e17a24422a9a73137d890026c66cf6b112 feat(mcp): Add tools/list pagination and presets for token optimization
  • c3a546fa159d0c264612eda0b9b043cf59c94123 feat(mcp): add --list-presets flag for preset discoverability (#48)
  • 886a00b8de74bc07bcb4c1ae9c1d45f5e03ea6e5 feat(mcp): add getAffectedTests MCP tool for test coverage mapping (#63)
  • aeb0203ae890f2e4d8dce2e475665c8784a4118c feat(mcp): add token efficiency visibility (#47)
  • fa1629d29a4852141764590f47e08d925d9008a9 feat(mcp): reduce default watch interval from 30s to 10s (#53)
  • 44a07dd1ba6dd2694478ad6a7fb378e1d8e216e8 feat(nfr): Deterministic NFR test infrastructure (#35)
  • 58957ec40180c77c942a8ff028870886da049a04 feat(status): add refresh source visibility to getStatus (#54)
  • 45264e1e229f53e33593fb8fba0670dabe5cce2e feat(update): switch to GitHub Releases API with deferred notifications (#50)
  • 5013c3829d677222f41abe37a4c4bd164680db93 feat: Add `ckb metrics export` for version comparison
  • b8a5df8d027ff347b8bca437c904bcb4771bdbf1 feat: Add byte tracking to wide-result metrics
  • b5104e0573363c1752c3bf84ac5399d21f579c13 feat: Standardized response envelope for all 74 MCP tools
  • 4ee5c66d8ec94384da3f4e069d9b613d8dbbcec0 feat: add SQLite persistence for wide-result metrics
  • c62f5b5e738438f1545b32307488f87a74b0d21e feat: add breaking change detection for API compatibility (#64)
  • b71be2f40dd20132bb57fc26913f479bf466f3da feat: add preset selection to setup wizard and enable tools.listChanged
  • d139a2e267ffc8369d01c2f7e23dab1178dc2149 feat: add static dead code detection (#62)
  • a13894d853f0f8a8620db799713c2d0c08aa323a feat: npx sandbox fix + GitHub Action for PR analysis (#38)
  • 816b0a1d963983503af339f5df3a91543f979e06 feat: wire metrics DB on MCP server creation

    • Bug Fixes

  • 34c307f009e5847c96a7a29eeedb30ef7946e19b fix(ci): correct JSON paths in workflow metric parsing (#40)
  • 72bfc2201b1d7d10b45dabf8988ec627d9d9a076 fix(ci): correct non-existent CKB CLI commands in workflow
  • e0e3b789c90ed36178312009526b8387736b3668 fix(deps): Bump the go-deps group with 2 updates (#42)
  • ed33bcb3dceaca1752173917e29ae57ab97548ac fix(mcp): expose lastRefresh in getStatus response (#57)
  • 6f3a55e3ebbb9e1601ca898625e1b29ccca70c41 fix: Add README/LICENSE to npm package and fix npx sandbox issue
  • 318d5ed46f23c2d874e5e46e1e92d020ea07d175 fix: Add v11 migration for response_bytes column
  • e7393d9e82d106bcf0874d45654841178f3894a1 fix: Resolve all golangci-lint errors
  • 40b88cee3992d21cb87074dcf61b2f82969d8d87 fix: Resolve golangci-lint errors
  • a1736f333b60f0302e599261bbd1080fb75f1afa fix: add getWideResultMetrics to ops preset

    • Documentation

  • f2d6204827ff5bb3964b44f37592b51951cd8f6d docs: Add MCP token baseline metrics for v7.4
  • c256673789b831be6f317097196cf3cf38d42580 docs: Add metrics export to CHANGELOG
  • e7ff6cea41e88e125c5b2ac072e92ff2f90e4e93 docs: Add npm package improvements to CHANGELOG
  • 5e416d49b71c79ef5818dd30e7a4d0b54799f682 docs: Add v7.5 SCIP backend performance improvements to CHANGELOG
  • 7828723100e2c7accb66df20519de19916c847bb docs: Fix version number in CHANGELOG (7.4, not 7.5)
  • b116fd1b110733a4d33891022fa3752a6a0f6a10 docs: Update CHANGELOG with byte tracking and telemetry findings
  • 2a18d7917bc986dc849a9ab18668a72fdc57d630 docs: Update CHANGELOG with v7.4 performance improvements
  • bc75a2bd0d98857fd90aa5b2b34a097cdbeb972c docs: add design note about cursor snapshotId for future consideration
  • e7fdd89f24a2f0b474259bb05282e8e1b68b6906 docs: add v7.4 presets documentation to changelog and README
  • 57a8d08c21eb7dde6cc35f8532cea464dc5f5025 docs: update tool count references from 74 to 76

    • Others

  • 4b83cd86eb326872fd7b810327b6099dfad9ecfb Merge main into develop (dependency updates + golangci-lint v2)
  • 5c76939b893697c9c8ea369bd0296fdea2cc5d3f Release v7.5.0 (#44)
  • 39da02845a3e63552f8a22b9e5486f839b30ca40 Release v8.0.0: Compound Operations, Streaming & Reliability
  • fa5ff4c2b6e75bbd57f43d068f38b2b1cb5f2d61 ci(deps): Bump the actions group with 7 updates (#43)
  • f6e160e5da24d5322e3556b5aff48a4dcb730fe3 ci: Add dedicated NFR test workflow (#37)
  • 9ef110c5860096351874eedfcb9b1cf84975c5c8 data: add v7.4 wide-result metrics baseline
  • f010a7f98369cd0ac3fe2c57d43e2b593e539954 perf: Add ContainerIndex for O(1) containment lookup
  • faf12dc4f8cce9ea9c71e00c8a94d0048520c50a perf: Add inverted index and symbol cache for faster lookups
  • 4c0a169ad9661f5792e58c7231e28f49f3d5dbc3 perf: Optimize GetHotspots from O(n*4) to O(1) git commands
  • 89aa58a1bf7708f049632f2327c14d69b6966c87 style(ci): use green/red colors for added/removed lines badges
  • fd1fecbbf032670d273acba00d18594b60014358 test(daemon): add HTTP handler and freshness integration tests (#46)
  • 4944f494bc4ce3676c4f7e39425b93c9faffdabd test(query): add Engine method tests for GetSymbol, SearchSymbols, FindReferences (#52)


    • View on GitHub

    CKB v7.5.0

    v7.5.0

    Changelog

    Features

  • f32d2fa988e089100a2664f2fe864d2d1b221695 feat(config): add environment variable overrides and config show command (#49)

    • Bug Fixes

  • e0e3b789c90ed36178312009526b8387736b3668 fix(deps): Bump the go-deps group with 2 updates (#42)

    • Others

  • 62c754f383fd574841e016dd87390ba224da553b Release v7.5.0: Auto Index Updates, Token Efficiency & Multi-Language Incremental (#61)
  • fa5ff4c2b6e75bbd57f43d068f38b2b1cb5f2d61 ci(deps): Bump the actions group with 7 updates (#43)


    • View on GitHub

    CKB v7.4.0

    v7.4.0

    Changelog

    Features

  • a934910f9b1989ffed2d1fca1e44e87f4cdde687 feat(retrieval): Add hybrid retrieval with PPR and fusion scoring
  • ce0699ac825e63d078c46fecc1d4cf92a95d0168 feat(retrieval): Improve PPR seed expansion for cross-module dependencies
  • 9d29ed6e583d0ce2fca79c4ab3b8cca5681cc214 feat(security): require auth for index-server mode and exempt health endpoints
  • 56eb1d9f328769e2db915636ac3c6d5d1c5e358a feat(update): Add npm update notifications

    • Bug Fixes

  • 88d8591b0e0378c8a32c41872251d902213ec98e fix(eval): Update expansion-mcp-tools test to use reliable symbols
  • 9d04f64f32a5b0abbae4f866c1b0ed78ac7422d5 fix: Correct v7.4 references to v7.3
  • f213be2bed1ef91f35ec6709af216b430c259018 fix: Resolve all golangci-lint errors

    • Documentation

  • 96f90e3c1827a3b46e2130d260d2e926250bfad0 docs: Add hybrid retrieval to CHANGELOG
  • 42b5fe29110bdd8291c69ce86fb0b4b1d873fa47 docs: Update CHANGELOG with accurate hybrid retrieval results
  • d2ec34786f5f73c028afad3fd9863b0fe23674db docs: Update hybrid retrieval results to 100% recall

    • Others

  • 7b966b5adfd4f34788ae1426bf37278ad926404b Release v7.4: MCP Presets, Pagination & NFR Tests (#36)


    • View on GitHub

    CKB v7.3.0

    v7.3.0

    See CHANGELOG.md for full release notes.


    Key features in v7.3.0:

  • Incremental Indexing v4 (Production-Grade)
  • Language Quality Assessment
  • Remote Federation Client
  • Authentication & API Keys
  • Enhanced Uploads with compression
  • Index Upload & Remote Serving
  • Doc-Symbol Linking
  • Multi-Repo Management

    • 🤖 Generated with [Claude Code](https://claude.com/claude-code)

    View on GitHub

    CKB v7.2.0

    v7.2.0

    What's New in v7.2.0


    `ckb setup` - Multi-Tool MCP Configuration

  • Interactive setup wizard for configuring CKB with AI coding tools
  • Support for 6 AI tools:

    • - **Claude Code** - `.mcp.json` (project) or `claude mcp add` (global)

    - **Cursor** - `.cursor/mcp.json` (project/global)

    - **Windsurf** - `~/.codeium/mcp_config.json` (global only)

    - **VS Code** - `.vscode/mcp.json` (project) or `code --add-mcp` (global)

    - **OpenCode** - `opencode.json` (project/global)

    - **Claude Desktop** - Platform-specific paths (global only)

  • `--tool` flag to skip interactive menu
  • `--npx` flag for portable npx-based setup
  • Windows path support for Windsurf and Claude Desktop

    • `ckb index` - Extended Language Support

  • Added 5 new languages:

    • - **C/C++** via scip-clang with `--compdb` flag for compile_commands.json

    - **Dart** via scip-dart

    - **Ruby** via scip-ruby with sorbet/config validation

    - **C#** via scip-dotnet with *.csproj detection

    - **PHP** via scip-php with vendor/bin check

  • Bounded-depth glob scanning for nested project detection
  • Language-specific validation and prerequisite checks

    • Smart Indexing

  • **Skip-if-fresh**: `ckb index` automatically skips reindexing when index matches current repo state
  • **Freshness tracking**: Detects commits behind HEAD and uncommitted changes to tracked files
  • **Index metadata**: Persists index info to `.ckb/index-meta.json` (commit hash, file count, duration)
  • **Lock file**: Prevents concurrent indexing with flock-based `.ckb/index.lock`

    • `ckb status` - Index Freshness Display

  • New "Index Status" section showing freshness with commit hash
  • Shows stale reasons: "3 commit(s) behind HEAD", "uncommitted changes detected"
  • Displays file count for fresh indexes

    • `ckb mcp --watch` - Auto-Reindex Mode

  • New `--watch` flag for poll-based auto-reindexing
  • Polls every 30 seconds, reindexes when stale
  • Uses lock file to prevent conflicts with manual `ckb index`
  • Logs reindex activity to stderr

    • Explicit Analysis Tiers

  • User-controllable analysis tiers: **fast**, **standard**, **full**
  • CLI flag: `ckb search "foo" --tier=fast`
  • Environment variable: `CKB_TIER=standard`
  • Config file: Add `"tier": "standard"` to `.ckb/config.json`
  • Tier display in `ckb status` shows mode (explicit vs auto-detected)

    • `ckb doctor --tier` - Tier-Aware Diagnostics

  • New `--tier` flag for tier-specific tool requirement checks
  • Shows per-language tool status (installed, version, path)
  • Displays missing tools with OS-specific install commands
  • Validates prerequisites (go.mod, package.json, Cargo.toml, etc.)
  • Capability matrix showing which features are available per language
  • JSON output with `--format json` for scripting

    • Changed

  • Tier names rebranded: Basic → **Fast**, Enhanced → **Standard**, Full → **Full**
  • Multi-language detection now errors instead of silently defaulting to a language

    • Fixed

  • Fixed Kotlin indexer URL in documentation
  • Fixed PHP indexer URL in documentation

    • ---


    Installation


    ```bash

    # npm (recommended)

    npm install -g @tastehub/ckb


    # Or run directly

    npx @tastehub/ckb setup

    ```


    **Full Changelog**: https://github.com/SimplyLiz/CodeMCP/compare/v7.1.0...v7.2.0

    View on GitHub

    CKB v7.1.0

    v7.1.0

    Zero-Friction Operation


    CKB v7.1 enables code intelligence without requiring a SCIP index upfront.


    New Features


    **Tree-sitter Symbol Fallback**

  • Symbol extraction for 8 languages (Go, TypeScript, JavaScript, TSX, Python, Rust, Java, Kotlin)
  • `searchSymbols` works without SCIP index
  • Results include `Source: "treesitter"` and `Confidence: 0.7` for transparency

    • **`ckb index` Command**

  • Auto-detects project language from manifests (go.mod, package.json, Cargo.toml, etc.)
  • Checks if SCIP indexer is installed, shows install instructions if not
  • `--force` flag for re-indexing, `--dry-run` to preview
  • Language-specific troubleshooting tips on failure

    • **Universal MCP Documentation**

  • Setup instructions for Claude Code, Cursor, Windsurf, VS Code, OpenCode, Claude Desktop
  • Windows `cmd /c` wrapper instructions

    • Files Added

  • `internal/symbols/treesitter.go` - Tree-sitter symbol extraction
  • `internal/symbols/treesitter_test.go` - Tests for all 8 languages
  • `internal/project/detect.go` - Language and indexer detection

    • Install


    ```bash

    npm install -g @tastehub/ckb

    # or

    npx @tastehub/ckb --help

    ```

    View on GitHub

    CKB v7.0.0

    v7.0.0

    Changelog

    Features

  • 2da1ebcf5d8dc43aadf47da4b7b6f3c3487c0bbd feat(api): Add HTTP telemetry endpoints for v6.4
  • ef81df145102140cfa166a48525ead17061bcd4f feat(cli): Add CLI commands for all MCP tools
  • 69fb4456cbbe8a7b3fb9e18baeed8fa5ec876088 feat(cli): Add missing CLI commands documented in README
  • c5a217272e7eb2d72828dcd8379a4dd5443346e8 feat(query): Wire annotations into core query tools (v6.5)
  • 4d3e4f16f71d3c873f203cdd20cbaf1c5c152f54 feat: Add v6.2 Federation, v6.2.1 Daemon Mode, v6.2.2 Tree-sitter Complexity
  • 21bf09841cff8a8b52c76eee5658dd558283354c feat: Add v6.3 Contract-Aware Impact Analysis
  • 2c11b55931fe2d39f2d1904947d276af0adfeaea feat: CKB v7.0 - Zero-Friction UX

    • Bug Fixes

  • 0fec67c43c251b3aa15c3c99e84c0a1782856a23 fix: Address multiple bugs from code review
  • c87117060f87496aec373c4dcb40910bfdaeffaf fix: Address v6.3 contract analysis issues
  • b26559aaa348b93fb5e6ff0bac7a2e4c7a950b18 fix: Address v6.3 contract analysis review findings
  • c65b0e55537528ae6658e4bc48277613975850f0 fix: correct GitHub repo name in goreleaser config
  • 7b3632d9804deedd20a01a403213951603e9af60 fix: cross-platform daemon process detachment
  • 30c4e9312afa45973b16b7908622a1b549afff5c fix: include npm bin wrapper in git
  • 8544add1b935a76c8887e9a878b83b734054d85c fix: make tree-sitter optional via CGO build tags
  • 97e438c234156eef9edee077150a7b8cf650bac7 fix: merge release jobs so npm publisher has access to dist
  • 445cbde5076ed8066577c3d4d4b9b4e045383b65 fix: use manual npm publishing instead of broken action

    • Documentation

  • dd0316373b6ba57bd126649ade832930a860a282 docs: Add v6.0 specification document
  • 03b7e17cea35218653225c1697cddf70e4003d23 docs: Improve README with marketing narrative
  • eb06f84210c6bc106913f0679f17f8b25dc879a0 docs: Update README with v6.3 contract analysis features
  • f3cfb6d7a000096eaf60c61b82dfb27472a70e09 docs: Update README with v6.4 telemetry features
  • 7524c23ad4ab314657aae9106c79a64c3cd5295d docs: Update README with v6.5 Developer Intelligence features

    • Others

  • f96936e519a7d14c5fe86fd9d6de46c139b09fd0 Add GitHub Actions CI pipeline
  • 077f9d1e1fed6654b4ec8cc5441ce8a90c18f66f Add Phase 4: Architectural Decision Records (ADRs)
  • c5d6b08280079d4f736c7d033d461be109232479 Add beginner-friendly Quick Start Guide
  • 595ddf053d8cfda5ad668d11ce80bc8edbf07fa8 Add ckb binary to .gitignore
  • a221a8ffe994f7e9579c2b4ba3344984d3d0abcb Add comprehensive MCP documentation
  • eeb605aae6db3c3c30f56ff831187a05db747224 Add comprehensive test coverage for critical packages
  • 07d0cf5dedbec06114582f5a7a60d83832952af1 Add comprehensive tests for Phase 2-4 navigation tools
  • fee62d0432038a3c9486bd82184ed7a2b4901ae8 Add improvements: version pkg, query cache, symbol counts, v5.2 tests
  • 6320c2040b0601b1689aabb1baee4641180d27fa Add performance benchmarks and documentation for v5.2 navigation tools
  • f49c73fb45a21b827165eb0fc2e27dae5004e46e Add project documentation
  • 6e445f850ea4c92b2b7cac02e1ba3afe02d9cda0 Add v5.2 specification and improve README
  • 3404a151f924876ab2b8ae62c64cbb1e679d9608 Add v6.0 Architectural Memory Phase 1 foundation
  • a00ed374e48ffd76283437dc7ba1965d417405c4 Add v6.0 Architectural Memory implementation plan
  • ef7ef45a7d7ee9ae0d874e6e5d39d3d2118f150b Add v6.0 Phase 2: Ownership tracking system
  • c24e1b24e5ddfa09228e29e21e361bfe2459be89 Add v6.0 Phase 3: Intelligence - hotspots and responsibilities
  • bc011d34a00904c68288d5bd98a8afa12278f865 Add v6.0 Phase 5: Integration tests and benchmarks
  • 5e6803db8b67fe775e2d4e7d355834b86a795408 Add v6.1: Background jobs, CI/CD tools, and HTTP API expansion
  • 6edee89f28930de0eef4db5684ae7c6142d79998 Address PR review feedback
  • bbdfe98ad26f346d218b21e2e730f3ba064b27d2 Address v5.2 Phase 1 review feedback
  • 3cb9960c020005fe84bdc592702c25b9cc2395b1 Bump version to 6.0.0
  • 84aa2580ffc7d263565aaae95cdfdf39f89232bf Bump version to 6.3.0 and document contract analysis
  • b22b50fb161b5fc7b5f47927c01ff0eb5491418f Complete v6.2.2 Tree-sitter complexity integration
  • d2da48f78ce45bda66564cea08e6073465f7d207 Fix GetDecision absolute path handling and UpsertAnnotations validation
  • 63ed9d65e8aea22410ef2ebc1663621ed8144215 Fix additional golangci-lint errors
  • f099b80ccdeb58010f1d4c263f935364b0a047f9 Fix all golangci-lint errors
  • c3ce05846da84d37603d817f6bce314e3fd9de6e Fix analyzeImpact SYMBOL_NOT_FOUND error for SCIP symbol IDs
  • 995d2d2489d621d6ff95be9ccb0dfbdd0ef02641 Fix annotateModule and ADR storage issues
  • d6206fef03d575f3244ec9b8ac8626089ef31f45 Fix annotateModule and ADR storage issues (complete fix)
  • 898d98ea129e090b695413928f69583c1d83af6b Fix golangci-lint errors
  • d106fe70388c6bfde175c21619454c08c17a49c2 Fix lint errors for CI pipeline
  • 6e9b4eb5f0708e0fceee20221780c508e3c1f44d Fix remaining golangci-lint errors
  • fc817f43ab074fefc23e2e466f5684a8eeca3eeb Implement AI navigation tools (explainSymbol, justifySymbol, getCallGraph, getModuleOverview)
  • ff522f948c5074c22cd8f594ed98b6437a5a68f2 Implement CKB v5.2 Phase 1 MVP tools
  • e5cb20c0e09e265a835df595d177218f9ea297b7 Implement call graph, module detection, and architecture improvements
  • e9cd36bbf6bbf559645939e94599129c2a1d545a Implement complete CKB system with CLI, API, and MCP server
  • 8291e72c47a84de937d90fbe73038c0587468a3b Implement summarizeDiff tool (v5.2 Phase 2)
  • a9e03efaab494264f1f7582e9ff4318af058b3e4 Implement traceUsage tool for v5.2 Phase 1 MVP
  • 5d260d9cf872905460f30cee481e36ac2dee3aa6 Implement v5.2 Phase 3: getHotspots and getArchitecture enhancements
  • 966d9bd4ff54df842fa31e45b90dbee2687e450e Implement v5.2 Phase 4: explainPath, listKeyConcepts, recentlyRelevant
  • 47e467018562a07dbeb8a1c204ecdccf53b14c92 Implement v6.4 Runtime Telemetry integration
  • f39b05c3b38ccf248237d4839985359cbc7b9b92 Implement v6.5 Developer Intelligence features
  • a6af7cfb2eff5f0c3795e4e935844aee59029135 Initial commit: Phase 1.1 CKB Project Setup
  • 52317c8fcdaead5b847f2aaebe0fe64c4721a978 Update API reference with detailed documentation
  • 2fa6dcad2ee21fd811310592e2c2a14626290940 Update MCP documentation to v5.2 specification
  • bfe9f6763e7f1978b1da9f08bdfa55a966f5fb63 Update README with all features and documentation links
  • a7830ae4e084c389c55d763423181b2bbe0beaba Update documentation to match actual codebase
  • cd02ec7a642787378789cfca681eb6a30d4baa02 updated readme


    • View on GitHub