CKB v8.1.0

What's New

New Tools

• findCycles — Detect circular dependencies using Tarjan's SCC algorithm (module/directory/file granularity), with break-edge recommendations
• suggestRefactorings — Proactive refactoring suggestions covering complexity, coupling, dead code, and extract candidates
• prepareChange (move) — Move/relocate analysis with import tracking and conflict detection
• prepareChange (extract) — Tree-sitter flow analysis for extract variable/function with parameter/return detection and signature generation
• planRefactor — Unified refactoring planner combining risk assessment, impact analysis, test gaps, and ordered steps

Improvements

• Coverage configuration via .ckb/config.json (custom paths, auto-detect, max age)
• Orphaned index detection in ckb doctor
• Test mapping via ckb affected-tests
• --include-tests flag wiring for ckb impact diff
• Lazy engine loading and enriched error messages
• switchProject tool for multi-repo workflows

Bug Fixes

• Go 1.24.12 security update
• Improved doctor command error messages
• Disabled patch coverage check on main/develop branches

Stats

• 46 files changed, +6,425 lines
• 102 new tests
• All CI checks passing

Full Changelog: v8.0.6...v8.1.0

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