CKB v8.0.6

What's Changed

SCIP Index Path

• Breaking change: Default SCIP index location changed from .scip/index.scip to index.scip (repository root)
• This aligns with the Sourcegraph standard convention
• Existing .scip/index.scip files are automatically migrated on next ckb index

New Features

• Added ckb config set and ckb config get commands for runtime configuration

  ckb config set scip.indexPath index.scip
  ckb config get scip.indexPath

Bug Fixes

• Fixed --output flag not being passed to scip-typescript and scip-python indexers

Internal

• Refactored index command to use IndexerConfig.BuildCommand()
• Only add --output flag when using non-default index path

CKB v8.0.5

Changelog

Bug Fixes

• e177ef5 fix: set MaxOpenConns(1) for in-memory SQLite test databases

CKB v8.0.3

Fixed

MCP Registry Publishing

• Fixed mcpName casing in npm package.json to match GitHub username (io.github.SimplyLiz/ckb instead of io.github.simplyliz/ckb). The official MCP registry namespace verification is case-sensitive.

Added

MCP Registry server.json

Added server.json for publishing to the official MCP Registry via mcp-publisher. CKB is now listed as io.github.SimplyLiz/ckb.

Install

npm install -g @tastehub/ckb
# or
npx @tastehub/ckb mcp

CKB v8.0.2

Added

Grok Support in ckb setup

Grok is now a supported AI coding tool in the setup wizard:

ckb setup --tool=grok          # project-level (.grok/settings.json)
ckb setup --tool=grok --global # global (~/.grok/user-settings.json)

Uses grok mcp add CLI when available, falls back to file-based configuration.

MCP Registry Support

Added mcpName field to npm package.json for publishing to the official MCP Registry (io.github.simplyliz/ckb).

Compound Tool NFR Scenarios

NFR test suite expanded from 28 to 39 scenarios, adding coverage for v8.0 compound tools:

• explore (small, large)
• understand (small, large)
• prepareChange (small, large)
• batchGet (small, large)
• batchSearch (small, medium, large)

Changed

Dynamic NFR Baselines

NFR tests now compare PR results against the base branch (dynamic baseline) instead of static hardcoded values. Two parallel CI jobs run the tests on both HEAD and base, then a comparison job reports regressions.

NFR Tests Scope

NFR tests now only run on PRs targeting main, reducing CI noise on feature branches.

v8.0.1: UX Enhancements

v8.0.1: UX Enhancements

Improved

Human-Readable Output by Default

All CLI commands now default to --format=human instead of --format=json. This makes the CLI more friendly for interactive use while still supporting --format=json for scripting and automation.

Quieter Indexer Output

External SCIP indexers (scip-go, scip-typescript, etc.) no longer spam stdout during ckb index. Output is now captured and only shown on error or when using -v verbose mode.

Better Error Messages

• ckb dead-code now clearly indicates it's for telemetry-based analysis and suggests using ckb telemetry dead-code
• ckb impact diff no longer shows confusing "Symbol not found: diff" error; instead provides helpful guidance
• Symbol not found errors now suggest using ckb search to find valid symbol IDs

Index Missing Guidance

ckb status now shows helpful guidance when no SCIP index is found:

• Lists commands that work without index (git-based): hotspots, ownership, reviewers, diff-summary, pr-summary
• Lists commands that need SCIP index: search, refs, callgraph, impact, dead-code, trace, explain

Fixed

• Consistent --format=human support for diff-summary, concepts, and impact diff commands

---

Full Changelog: v8.0.0...v8.0.1

CKB v8.0.0

Theme: Reliability, clarity, and compound operations for AI workflows.

See CHANGELOG.md for full release notes.

Key Features in v8.0.0

Compound Operations (5 New Tools)

Reduce AI tool calls by 60-70% with smart aggregation tools:

• explore — Area exploration (file/directory/module)
• understand — Symbol deep-dive with ambiguity handling
• prepareChange — Pre-change impact analysis
• batchGet — Retrieve up to 50 symbols in one call
• batchSearch — Execute up to 10 searches in one call

SSE Streaming

Real-time feedback for long-running operations:

• findReferences and searchSymbols support streaming with stream: true
• Progress updates, chunked results, and error handling

Enhanced getStatus

System health with actionable remediation guidance:

• Health tiers: available, degraded, unavailable
• Index freshness info (commitsBehind, indexAge)
• Backend latency and capability reporting

Code Analysis Tools

• findDeadCode — Static dead code detection
• getAffectedTests — Test coverage mapping
• compareAPI — Breaking change detection between commits/branches

Structured Error Codes

All MCP errors now include actionable remediation:

• AMBIGUOUS_QUERY, PARTIAL_RESULT, INVALID_PARAMETER
• RESOURCE_NOT_FOUND, PRECONDITION_FAILED, OPERATION_FAILED

Response Metadata

All tool responses include structured metadata:

• ConfidenceFactor — Score explanation with weighted factors
• CacheInfo — Cache hit/miss transparency

Golden Test Suite

Multi-language test fixtures for regression testing across Go, TypeScript, Python, and Rust.

🤖 Generated with Claude Code

CKB v7.5.0

See CHANGELOG.md for full release notes.

Key Features in v7.5.0

Change Impact Analysis

Analyze the impact of code changes from git diffs before committing:

ckb impact diff                # Analyze working tree changes
ckb impact diff --staged       # Analyze only staged changes
ckb impact diff --base=main    # Compare against a branch

Features:

• Git diff parsing with symbol mapping
• Confidence levels (1.0 exact definition → 0.3 file-level)
• Aggregated risk scoring
• Actionable recommendations

Token Efficiency Visibility

See CKB's token savings compared to bloated MCP servers:

• Startup banner shows active tools and estimated context
• getStatus response includes token savings percentage (83% reduction with core preset)
• --list-presets flag for preset discoverability

Auto Index Updates

Automatic index maintenance across all CKB interfaces:

ckb index --watch              # Watch and auto-reindex (standalone)
ckb mcp --watch                # Watch during MCP session
curl -X POST localhost:9120/api/v1/refresh  # Webhook trigger

Staleness Visibility:

• ckb status shows commits behind HEAD and index age
• MCP getStatus includes freshness info

Multi-Language Incremental Indexing

Incremental indexing now supports 5 languages:

• Go (scip-go)
• TypeScript/JavaScript (scip-typescript)
• Python (scip-python)
• Dart (scip_dart)
• Rust (rust-analyzer)

Real Transitive Impact Analysis

The analyzeImpact tool now provides real transitive caller analysis:

• Transitive callers up to depth 4
• Blast radius summary (module count, file count, risk level)
• Confidence decay with depth

🤖 Generated with Claude Code

CKB v7.4.0

See CHANGELOG.md for full release notes.

Key Features in v7.4.0

Tool Presets & Pagination

Token-optimized tool discovery reducing context overhead by up to 83%:

Preset	Tools	Tokens	Use Case
core (default)	14	~1,531	Essential navigation and analysis
review	19	~2,294	Code review: PR summary, ownership
refactor	19	~2,216	Refactoring: coupling, dead code
docs	20	~2,093	Documentation: coverage, staleness
ops	25	~2,366	Operations: jobs, webhooks, metrics
federation	28	~3,122	Multi-repo: cross-repo search
full	76	~9,043	All tools (legacy behavior)

Features:

• MCP-compliant cursor-based pagination
• Core-first ordering for non-paginating clients
• expandToolset meta-tool for dynamic preset expansion
• tools.listChanged capability for dynamic updates

Wide-Result Metrics Tracking

Infrastructure for monitoring tool output sizes:

• getWideResultMetrics tool for statistics
• SQLite persistence for historical tracking
• ckb metrics CLI with export support

SCIP Backend Optimizations

Major performance improvements:

Operation	Before	After	Improvement
FindReferences	340μs	2.5μs	136x faster
SearchSymbols	930μs	136μs	7x faster
FindSymbolLocation	70μs	28ns	2,500x faster

Git Backend Optimizations

getHotspots improved from 26.7s to 498ms (53x faster).

Standardized Response Envelope

All 76 MCP tools now include structured metadata:

• Confidence tiers (high/medium/low/speculative)
• Provenance tracking (which backends contributed)
• Truncation metadata with drilldown suggestions

Update Notifications

Automatic update checking for all installation methods:

• Deferred notification at command start
• 24-hour cache with background refresh
• Smart upgrade message (npm vs GitHub releases)

Hybrid Retrieval with PPR

Graph-based retrieval using Personalized PageRank:

• Recall@10: 62.1% → 100% (+61%)
• MRR: 0.546 → 0.914 (+67%)

🤖 Generated with Claude Code

CKB 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

CKB 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

# npm (recommended)
npm install -g @tastehub/ckb

# Or run directly
npx @tastehub/ckb setup

Full Changelog: v7.1.0...v7.2.0