@tastehub/ckb-linux-arm64 7.5.0 → 8.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/bin/LICENSE +25 -25
  2. package/bin/README.md +197 -327
  3. package/bin/ckb +0 -0
  4. package/package.json +1 -1
package/bin/LICENSE CHANGED
@@ -1,40 +1,40 @@
1
1
  CKB License
2
2
 
3
- Copyright (c) 2025 SimplyLiz
3
+ Copyright (c) 2025 TasteHub / SimplyLiz
4
4
 
5
- PERSONAL USE LICENSE
5
+ FREE USE
6
6
 
7
- This software is free to use for personal, non-commercial purposes.
7
+ This software is free to use for:
8
8
 
9
- ENTERPRISE/COMMERCIAL USE
9
+ 1. Personal, non-commercial use
10
+ 2. Open source projects
11
+ 3. Startups and small businesses with less than $25,000 USD in annual revenue
10
12
 
11
- Commercial use, including but not limited to use by corporations, businesses,
12
- government entities, or any organization generating revenue, requires a
13
- separate commercial license.
13
+ COMMERCIAL USE
14
14
 
15
- To acquire a commercial license: Licensing information coming soon.
15
+ Commercial use by organizations with $25,000 USD or more in annual revenue
16
+ requires a paid license. See https://codeknowledge.dev/pricing for plans.
16
17
 
17
18
  TERMS
18
19
 
19
- 1. PERSONAL USE: Individuals may use, copy, and modify this software for
20
- personal, non-commercial projects at no cost.
20
+ 1. FREE USE: Individuals, open source projects, and qualifying small businesses
21
+ may use, copy, and modify this software at no cost under the conditions above.
21
22
 
22
- 2. COMMERCIAL USE PROHIBITED WITHOUT LICENSE: Any use of this software by
23
- or for commercial entities, including internal business tools, products,
24
- or services, requires a paid commercial license.
23
+ 2. COMMERCIAL LICENSE REQUIRED: Organizations with $25,000 USD or more in annual
24
+ revenue must purchase a commercial license for any use, including:
25
+ - Internal business tools
26
+ - Products or services
27
+ - Use by employees or contractors
25
28
 
26
- 3. REDISTRIBUTION: Redistribution of this software, with or without
27
- modification, must retain this license notice and is limited to
28
- non-commercial purposes unless a commercial license is obtained.
29
+ 3. REDISTRIBUTION: Redistribution of this software, with or without modification,
30
+ must retain this license notice. Commercial redistribution requires a license.
29
31
 
30
- 4. NO WARRANTY: This software is provided "as is", without warranty of any
31
- kind, express or implied. The authors are not liable for any damages
32
- arising from its use.
32
+ 4. NO WARRANTY: This software is provided "as is", without warranty of any kind,
33
+ express or implied. The authors are not liable for any damages arising from
34
+ its use.
33
35
 
34
- 5. DEFINITION OF COMMERCIAL USE: Commercial use includes, but is not limited to:
35
- - Use by any for-profit organization
36
- - Use by employees or contractors on behalf of a commercial entity
37
- - Integration into commercial products or services
38
- - Use to generate revenue directly or indirectly
36
+ 5. REVENUE CALCULATION: Annual revenue means gross revenue for the most recent
37
+ fiscal year, including all subsidiaries and affiliated entities.
39
38
 
40
- For licensing inquiries: https://github.com/SimplyLiz/CodeMCP/issues
39
+ For licensing: https://codeknowledge.dev/pricing
40
+ For questions: hello@codeknowledge.dev
package/bin/README.md CHANGED
@@ -1,68 +1,101 @@
1
1
  # CKB — Code Knowledge Backend
2
2
 
3
+ **Know your code. Change it safely. Ship with confidence.**
4
+
3
5
  [![npm version](https://img.shields.io/npm/v/@tastehub/ckb.svg)](https://www.npmjs.com/package/@tastehub/ckb)
4
- [![codecov](https://codecov.io/gh/SimplyLiz/CodeMCP/graph/badge.svg)](https://codecov.io/gh/SimplyLiz/CodeMCP)
5
- [![Documentation](https://img.shields.io/badge/docs-wiki-blue.svg)](https://github.com/SimplyLiz/CodeMCP/wiki)
6
+ [![Website](https://img.shields.io/badge/website-codeknowledge.dev-teal.svg)](https://codeknowledge.dev)
7
+ [![Documentation](https://img.shields.io/badge/docs-codeknowledge.dev-blue.svg)](https://codeknowledge.dev/docs)
6
8
 
7
- **The missing link between your codebase and AI assistants.**
9
+ CKB transforms your codebase into a queryable knowledge base. Ask questions, understand impact, find owners, detect dead code—all through CLI, API, or AI assistants.
8
10
 
9
- CKB gives AI assistants deep understanding of your code. Instead of grepping through files, your AI can now *navigate* code like a senior engineer—with knowledge of who owns what, what's risky to change, and how everything connects.
11
+ > Think of it as a senior engineer who knows every line of code, every decision, and every owner—available 24/7 to answer your questions.
10
12
 
11
- > CKB analyzes and explains your code but never modifies it. Think of it as a librarian who knows everything about the books but never rewrites them.
13
+ ---
12
14
 
13
- ## The Problem
15
+ ## Instant Answers to Hard Questions
14
16
 
15
- ### AI Assistants Are Blind to Code Structure
17
+ | Question | Without CKB | With CKB |
18
+ |----------|-------------|----------|
19
+ | "What breaks if I change this?" | Grep and hope | Precise blast radius with risk score |
20
+ | "Who should review this PR?" | Guess from git blame | Data-driven reviewer suggestions |
21
+ | "Is this code still used?" | Delete and see what breaks | Confidence-scored dead code detection |
22
+ | "What tests should I run?" | Run everything (30 min) | Run affected tests only (2 min) |
23
+ | "How does this system work?" | Read code for hours | Query architecture instantly |
24
+ | "Who owns this code?" | Search CODEOWNERS manually | Ownership with drift detection |
25
+ | "Are there exposed secrets?" | Manual grep for patterns | Automated scanning with 26 patterns |
16
26
 
17
- When you ask an AI "what calls this function?", it typically:
18
- 1. Searches for text patterns (error-prone)
19
- 2. Reads random files hoping to find context (inefficient)
20
- 3. Gives up and asks you to provide more context (frustrating)
27
+ ---
21
28
 
22
- ### Existing Tools Don't Talk to Each Other
29
+ ## What You Can Do
23
30
 
24
- Your codebase has valuable intelligence scattered across SCIP indexes, language servers, git history, and CODEOWNERS files. Each speaks a different language. None are optimized for AI consumption.
31
+ 🔍 **Understand** — Semantic search, call graphs, usage tracing, architecture maps
25
32
 
26
- ### Context Windows Are Limited
33
+ ⚡ **Analyze** — Impact analysis, risk scoring, hotspot detection, coupling analysis
27
34
 
28
- Even with 100K+ token context, you can't dump your entire codebase into an LLM. You need relevant information only, properly compressed, with smart truncation.
35
+ 🛡️ **Protect** — Affected test detection, breaking change warnings, PR risk assessment
29
36
 
30
- ## What CKB Gives You
37
+ 🔐 **Secure** — Secret detection, credential scanning, security-sensitive code identification
31
38
 
32
- ```
33
- You: "What's the impact of changing UserService.authenticate()?"
34
-
35
- CKB provides:
36
- ├── Symbol details (signature, visibility, location)
37
- ├── 12 direct callers across 4 modules
38
- ├── Risk score: HIGH (public API, many dependents)
39
- ├── Affected modules: auth, api, admin, tests
40
- ├── Code owners: @security-team, @api-team
41
- └── Suggested drilldowns for deeper analysis
42
- ```
39
+ 👥 **Collaborate** — Ownership lookup, reviewer suggestions, architectural decisions (ADRs)
43
40
 
44
- ```
45
- You: "Show me the architecture of this codebase"
46
-
47
- CKB provides:
48
- ├── Module dependency graph
49
- ├── Key symbols per module
50
- ├── Module responsibilities and ownership
51
- ├── Import/export relationships
52
- └── Compressed to fit LLM context
53
- ```
41
+ 📊 **Improve** — Dead code detection, tech debt tracking, documentation coverage
54
42
 
43
+ 🚀 **Compound Operations** — Single-call tools (`explore`, `understand`, `prepareChange`) reduce AI tool calls by 60-70%
44
+
45
+ 🔗 **Integrate** — CLI, HTTP API, MCP for AI tools, CI/CD pipelines, custom scripts
46
+
47
+ ---
48
+
49
+ ## Try It Now
50
+
51
+ ```bash
52
+ # See what's risky in your codebase
53
+ ckb hotspots --format=human
54
+
55
+ # Check what changed and what might break
56
+ ckb diff-summary --format=human
57
+
58
+ # Scan for exposed secrets
59
+ ckb audit --format=human
60
+
61
+ # Check architecture at a glance
62
+ ckb arch --format=human
63
+
64
+ # Check system status
65
+ ckb status
55
66
  ```
56
- You: "Is it safe to rename this function?"
57
-
58
- CKB provides:
59
- ├── All references (not just text matches)
60
- ├── Cross-module dependencies
61
- ├── Test coverage of affected code
62
- ├── Hotspot risk assessment
63
- └── Breaking change warnings
67
+
68
+ ---
69
+
70
+ ## Works Everywhere
71
+
72
+ | AI Assistants | CI/CD | Your Tools |
73
+ |---------------|-------|------------|
74
+ | Claude Code, Cursor, Windsurf, VS Code | GitHub Actions, GitLab CI | CLI, HTTP API, Scripts |
75
+
76
+ **83% token reduction** with smart presets—load only the tools you need.
77
+
78
+ ```bash
79
+ # One command to connect to Claude Code
80
+ ckb setup
64
81
  ```
65
82
 
83
+ > **Building your own tools?** Use CKB as a backend via CLI, HTTP API, or MCP. See the **[Integration Guide](https://github.com/SimplyLiz/CodeMCP/wiki/Integration-Guide)** for examples in Node.js, Python, Go, and shell scripts.
84
+
85
+ ---
86
+
87
+ ## Learn More
88
+
89
+ | Resource | Description |
90
+ |----------|-------------|
91
+ | 📖 **[Features Guide](https://github.com/SimplyLiz/CodeMCP/wiki/Features)** | Complete feature list with examples |
92
+ | 💬 **[Prompt Cookbook](https://github.com/SimplyLiz/CodeMCP/wiki/Prompt-Cookbook)** | Real prompts for real problems |
93
+ | 🔌 **[Integration Guide](https://github.com/SimplyLiz/CodeMCP/wiki/Integration-Guide)** | Use CKB in your own tools and scripts |
94
+ | ⚡ **[Impact Analysis](https://github.com/SimplyLiz/CodeMCP/wiki/Impact-Analysis)** | Blast radius, affected tests, PR risk |
95
+ | 🔧 **[CI/CD Integration](https://github.com/SimplyLiz/CodeMCP/wiki/CI-CD-Integration)** | GitHub Actions, GitLab CI templates |
96
+
97
+ ---
98
+
66
99
  ## Quick Start
67
100
 
68
101
  ### Option 1: npm (Recommended)
@@ -100,6 +133,14 @@ ckb setup # creates .mcp.json automatically
100
133
  claude mcp add --transport stdio ckb -- npx @tastehub/ckb mcp
101
134
  ```
102
135
 
136
+ **Token efficiency shown at startup:**
137
+ ```
138
+ CKB MCP Server v8.0.0
139
+ Active tools: 14 / 76 (18%)
140
+ Estimated context: ~1k tokens
141
+ Preset: core
142
+ ```
143
+
103
144
  Now Claude can answer questions like:
104
145
  - *"What calls the HandleRequest function?"*
105
146
  - *"How is ProcessPayment reached from the API?"*
@@ -126,315 +167,116 @@ Now Claude can answer questions like:
126
167
  | **[CLI](https://github.com/SimplyLiz/CodeMCP/wiki/User-Guide)** | Quick lookups from terminal, scripting |
127
168
  | **[HTTP API](https://github.com/SimplyLiz/CodeMCP/wiki/API-Reference)** | IDE plugins, CI integration, custom tooling |
128
169
 
129
- ## Features
170
+ ## How Indexing Works
130
171
 
131
- ### Core Intelligence
132
- - **Symbol Navigation** — Find any function, class, or variable in milliseconds
133
- - **Call Flow & Tracing** — Trace how code is reached from API endpoints, CLI commands, or jobs
134
- - **Impact Analysis** — Know exactly what breaks before refactoring, with risk scores
135
- - **Architecture Maps** — Module dependency graphs, responsibilities, domain concepts
136
- - **Dead Code Detection** — Keep/investigate/remove verdicts based on usage analysis
137
-
138
- ### Ownership & Risk
139
- - **Ownership Intelligence** — CODEOWNERS + git blame with time-weighted analysis
140
- - **Hotspot Detection** — Track churn trends, get 30-day risk projections
141
- - **Architectural Decisions** — Record and query ADRs with full-text search
142
-
143
- ### Advanced Capabilities
144
- - **Federation** — Query across multiple repos organization-wide
145
- - **Multi-Repo Management** — Named repo registry with quick MCP context switching
146
- - **Daemon Mode** — Always-on service with HTTP API, scheduled tasks, webhooks
147
- - **Contract Analysis** — Protobuf and OpenAPI discovery with cross-repo impact
148
- - **Runtime Observability** — OpenTelemetry integration for dead code detection
149
- - **Developer Intelligence** — Symbol origins, co-change coupling, risk audit
150
-
151
- ### Fast Indexing
152
- - **Zero-Index Operation** — Tree-sitter fallback works without SCIP index
153
- - **Incremental Updates** — O(changed files) instead of full reindex (Go, TypeScript, Python, Dart, Rust)
154
- - **Smart Caching** — Skip-if-fresh, watch mode, transitive invalidation
155
- - **Auto Index Updates** — Watch mode, daemon file watcher, webhook API for CI/CD
156
-
157
- ### Remote Index Server
158
- - **Index Serving** — Serve symbol indexes over HTTP for federation
159
- - **Index Upload** — Push SCIP indexes with compression (gzip/zstd)
160
- - **Delta Updates** — Upload only changed files
161
- - **API Key Auth** — Scoped keys with rate limiting
162
- - **Remote Federation** — Connect to remote CKB servers and query alongside local repos
163
-
164
- 📋 **[Full Changelog](https://github.com/SimplyLiz/CodeMCP/blob/main/CHANGELOG.md)** — Detailed version history from v5.1 to current
165
-
166
- ### Zero-Friction UX (v7.0+)
167
- - **npm Distribution** — `npm install -g @tastehub/ckb` or `npx @tastehub/ckb`
168
- - **Auto-Setup** — `ckb setup` configures Claude Code integration automatically
169
- - **Update Notifications** — Automatic update check for npm installs (disable with `CKB_NO_UPDATE_CHECK=1`)
170
-
171
- ### Zero-Index Operation (v7.1)
172
- - **Tree-sitter Fallback** — Symbol search works without SCIP index (8 languages)
173
- - **Auto-Index** — `ckb index` detects language and runs the right SCIP indexer
174
- - **Install Guidance** — Shows indexer install commands when missing
175
- - **Universal MCP Docs** — Setup for Claude Code, Cursor, Windsurf, VS Code, OpenCode, Claude Desktop
176
-
177
- ### Smart Indexing & Explicit Tiers (v7.2)
178
- - **Skip-if-Fresh** — `ckb index` automatically skips if index is current with HEAD
179
- - **Freshness Tracking** — Tracks commits behind HEAD + uncommitted changes
180
- - **Index Status** — `ckb status` shows index freshness with commit hash
181
- - **Watch Mode** — `ckb mcp --watch` polls every 30s and auto-reindexes when stale
182
- - **Lock File** — Prevents concurrent indexing with flock-based locking
183
- - **Explicit Tiers** — Control analysis mode: `--tier=fast|standard|full` or `CKB_TIER` env var
184
- - **Tier Diagnostics** — `ckb doctor --tier enhanced` shows exactly what's missing and how to fix it
185
-
186
- ### Doc-Symbol Linking (v7.3)
187
- - **Backtick Detection** — Automatically detect `Symbol.Name` references in markdown
188
- - **Directive Support** — Explicit `<!-- ckb:symbol -->` and `<!-- ckb:module -->` directives
189
- - **Fence Scanning** — Extract symbols from fenced code blocks via tree-sitter (8 languages)
190
- - **Staleness Detection** — Find broken references when symbols are renamed or deleted
191
- - **Rename Awareness** — Suggest new names when documented symbols are renamed
192
- - **CI Enforcement** — `--fail-under` flag for documentation coverage thresholds
193
-
194
- ### Standardized Response Envelope (v7.4)
195
- - **Unified Metadata** — All 76 MCP tool responses now include structured metadata
196
- - **Confidence Tiers** — High/Medium/Low/Speculative tiers based on data freshness and source
197
- - **Provenance Tracking** — Know which backends (SCIP, Git, LSP) contributed to results
198
- - **Truncation Awareness** — Metadata shows when results are truncated and total counts
199
- - **Suggested Next Calls** — Structured drilldown suggestions for follow-up queries
200
-
201
- ### Production Hardening (v7.3)
202
- - **Delta Artifacts** — CI-generated diffs for O(delta) ingestion instead of O(N)
203
- - **FTS5 Search** — SQLite FTS5 for instant search (replaces LIKE scans)
204
- - **Compaction Scheduler** — Automatic snapshot cleanup and database maintenance
205
- - **Prometheus Metrics** — `/metrics` endpoint for monitoring and alerting
206
- - **Load Shedding** — Graceful degradation under load with priority endpoints
207
- - **Health Details** — `/health/detailed` endpoint with per-repo and storage metrics
208
-
209
- ### Language Quality (v7.3)
210
- - **Quality Tiers** — 4-tier classification (Tier 1: Go, Tier 2: TS/Python, Tier 3: Rust/Java, Tier 4: Experimental)
211
- - **Quality Assessment** — Per-language metrics (ref accuracy, callgraph quality)
212
- - **Python Venv Detection** — Auto-detect virtual environments with activation recommendations
213
- - **TypeScript Monorepo** — Detect pnpm, lerna, nx, yarn workspaces with per-package tsconfig status
214
-
215
- ### Auto Index Updates (v7.5)
216
- - **Watch Mode** — `ckb index --watch` and `ckb mcp --watch --watch-interval 15s`
217
- - **Daemon File Watcher** — Automatic incremental refresh on git changes
218
- - **Webhook API** — `POST /api/v1/refresh` for CI/CD integration
219
- - **Index Staleness** — `ckb status` and `getStatus` show commits behind, index age, staleness reasons
220
- - **Token Efficiency Visibility** — Startup banner shows active tools, estimated tokens, preset savings (83% with core)
221
-
222
- ### Multi-Language Incremental (v7.5)
223
- - **Expanded Support** — Go, TypeScript, Python, Dart, Rust (automatic indexer detection)
224
- - **Graceful Degradation** — Install hints when indexer is missing
225
- - **Unified API** — `IndexIncrementalWithLang(ctx, since, lang)` for all languages
226
-
227
- ### Performance Improvements (v7.5)
228
- - **SCIP Backend** — Up to 2,500x faster: FindReferences (136x), SearchSymbols (7x), FindSymbolLocation (2,500x)
229
- - **Git Backend** — 53x faster getHotspots (single git command vs 4 per file)
230
- - **Pre-computed Indexes** — RefIndex, ConvertedSymbols cache, ContainerIndex for O(1) lookups
231
-
232
- ## MCP Tools (76 Available)
233
-
234
- CKB exposes code intelligence through the Model Context Protocol:
172
+ CKB uses **SCIP indexes** to understand your code. Think of it like a database that knows where every function is defined, who calls it, and how everything connects.
235
173
 
236
- <details>
237
- <summary><strong>v5.1 — Core Navigation</strong></summary>
238
-
239
- | Tool | Purpose |
240
- |------|---------|
241
- | `searchSymbols` | Find symbols by name with filtering |
242
- | `getSymbol` | Get symbol details |
243
- | `findReferences` | Find all usages |
244
- | `explainSymbol` | AI-friendly symbol explanation |
245
- | `justifySymbol` | Keep/investigate/remove verdict |
246
- | `getCallGraph` | Caller/callee relationships |
247
- | `getModuleOverview` | Module statistics |
248
- | `analyzeImpact` | Change risk analysis |
249
- | `getStatus` | System health |
250
- | `doctor` | Diagnostics |
251
-
252
- </details>
253
-
254
- <details>
255
- <summary><strong>v5.2 — Discovery & Flow</strong></summary>
256
-
257
- | Tool | Purpose |
258
- |------|---------|
259
- | `traceUsage` | How is this symbol reached? |
260
- | `listEntrypoints` | System entrypoints (API, CLI, jobs) |
261
- | `explainFile` | File-level orientation |
262
- | `explainPath` | Why does this path exist? |
263
- | `summarizeDiff` | What changed, what might break? |
264
- | `getArchitecture` | Module dependency overview |
265
- | `getHotspots` | Volatile areas with trends |
266
- | `listKeyConcepts` | Domain concepts in codebase |
267
- | `recentlyRelevant` | What matters now? |
268
-
269
- </details>
174
+ ### The Basics
270
175
 
271
- <details>
272
- <summary><strong>v6.0 — Architectural Memory</strong></summary>
273
-
274
- | Tool | Purpose |
275
- |------|---------|
276
- | `getOwnership` | Who owns this code? |
277
- | `getModuleResponsibilities` | What does this module do? |
278
- | `recordDecision` | Create an ADR |
279
- | `getDecisions` | Query architectural decisions |
280
- | `annotateModule` | Add module metadata |
281
- | `refreshArchitecture` | Rebuild architectural model |
282
-
283
- </details>
284
-
285
- <details>
286
- <summary><strong>v6.1 — Production Ready</strong></summary>
287
-
288
- | Tool | Purpose |
289
- |------|---------|
290
- | `getJobStatus` | Query background job status |
291
- | `listJobs` | List jobs with filters |
292
- | `cancelJob` | Cancel queued/running job |
293
- | `summarizePr` | PR risk analysis & reviewers |
294
- | `getOwnershipDrift` | CODEOWNERS vs actual ownership |
176
+ ```bash
177
+ # 1. Generate an index (auto-detects language)
178
+ ckb index
295
179
 
296
- </details>
180
+ # 2. Check if your index is fresh
181
+ ckb status
182
+ ```
297
183
 
298
- <details>
299
- <summary><strong>v6.2+ — Federation, Daemon, Contracts, Telemetry, Intelligence</strong></summary>
300
-
301
- | Tool | Purpose |
302
- |------|---------|
303
- | `listFederations` | List all federations |
304
- | `federationStatus` | Get federation status |
305
- | `federationSearchModules` | Cross-repo module search |
306
- | `federationSearchOwnership` | Cross-repo ownership search |
307
- | `federationGetHotspots` | Merged hotspots across repos |
308
- | `daemonStatus` | Daemon health and stats |
309
- | `listSchedules` | List scheduled tasks |
310
- | `listWebhooks` | List configured webhooks |
311
- | `getFileComplexity` | Cyclomatic/cognitive complexity |
312
- | `listContracts` | List contracts in federation |
313
- | `analyzeContractImpact` | Contract change impact |
314
- | `getTelemetryStatus` | Coverage metrics and sync status |
315
- | `getObservedUsage` | Observed usage for a symbol |
316
- | `findDeadCodeCandidates` | Zero runtime call detection |
317
- | `explainOrigin` | Why does this code exist? |
318
- | `analyzeCoupling` | Co-change analysis |
319
- | `exportForLLM` | LLM-friendly export |
320
- | `auditRisk` | Multi-signal risk audit |
184
+ Without an index, CKB still works using tree-sitter parsing (basic mode), but with an index you get:
185
+ - Cross-file references ("who calls this function?")
186
+ - Precise impact analysis
187
+ - Call graph navigation
321
188
 
322
- </details>
189
+ ### Language Support
323
190
 
324
- <details>
325
- <summary><strong>v7.3 — Doc-Symbol Linking</strong></summary>
191
+ Not all languages are equal. CKB classifies languages into **quality tiers** based on indexer maturity:
326
192
 
327
- | Tool | Purpose |
328
- |------|---------|
329
- | `indexDocs` | Scan and index documentation |
330
- | `getDocsForSymbol` | Find docs referencing a symbol |
331
- | `getSymbolsInDoc` | List symbols in a document |
332
- | `getDocsForModule` | Find docs linked to a module |
333
- | `checkDocStaleness` | Check for stale references |
334
- | `getDocCoverage` | Documentation coverage stats |
193
+ | Tier | Quality | Languages |
194
+ |------|---------|-----------|
195
+ | **Tier 1** | Full support, all features | Go |
196
+ | **Tier 2** | Full support, minor edge cases | TypeScript, JavaScript, Python |
197
+ | **Tier 3** | Basic support, call graph may be incomplete | Rust, Java, Kotlin, C++, Ruby, Dart |
198
+ | **Tier 4** | Experimental | C#, PHP |
335
199
 
336
- </details>
200
+ **Key limitations:**
201
+ - **Incremental indexing** is Go-only. Other languages require full reindex.
202
+ - **TypeScript monorepos** may need `--infer-tsconfig` flag
203
+ - **C/C++** requires `compile_commands.json`
204
+ - **Python** works best with activated virtual environment
337
205
 
338
- <details>
339
- <summary><strong>v7.3 — Multi-Repo Management</strong></summary>
206
+ Run `ckb doctor --tier standard` to check if your language tools are properly installed.
340
207
 
341
- | Tool | Purpose |
342
- |------|---------|
343
- | `listRepos` | List registered repos with state |
344
- | `switchRepo` | Switch active repo context |
345
- | `getActiveRepo` | Get current repo info |
208
+ See **[Language Support](https://github.com/SimplyLiz/CodeMCP/wiki/Language-Support)** for indexer installation, known issues, and the full feature matrix.
346
209
 
347
- </details>
210
+ ### Keeping Your Index Fresh
348
211
 
349
- <details>
350
- <summary><strong>v7.3 — Remote Federation</strong></summary>
351
-
352
- | Tool | Purpose |
353
- |------|---------|
354
- | `federationAddRemote` | Add a remote CKB index server |
355
- | `federationRemoveRemote` | Remove a remote server |
356
- | `federationListRemote` | List remote servers in federation |
357
- | `federationSyncRemote` | Sync metadata from remote servers |
358
- | `federationStatusRemote` | Check remote server connectivity |
359
- | `federationSearchSymbolsHybrid` | Search across local + remote |
360
- | `federationListAllRepos` | List repos from local and remote |
212
+ Your index becomes stale when you make commits. CKB offers several ways to stay current:
361
213
 
362
- </details>
214
+ | Method | Command | When to Use |
215
+ |--------|---------|-------------|
216
+ | Manual | `ckb index` | One-off updates, scripts |
217
+ | Watch mode | `ckb index --watch` | Auto-refresh during development |
218
+ | MCP watch | `ckb mcp --watch` | Auto-refresh in AI sessions |
219
+ | CI webhook | `POST /api/v1/refresh` | Trigger from CI/CD |
363
220
 
364
- ## CLI Usage
221
+ **Quick start for AI sessions:**
222
+ ```bash
223
+ ckb mcp --watch # Auto-reindexes every 30s when stale
224
+ ```
365
225
 
226
+ **Check staleness:**
366
227
  ```bash
367
- # System status
368
228
  ckb status
229
+ # Shows: "5 commits behind HEAD" or "Up to date"
230
+ ```
369
231
 
370
- # Search for symbols
371
- ckb search NewServer
372
-
373
- # Find references
374
- ckb refs NewServer
232
+ For Go projects, CKB uses **incremental indexing**—only changed files are processed, making updates fast.
375
233
 
376
- # Get architecture overview
377
- ckb arch
234
+ See the **[Index Management Guide](https://github.com/SimplyLiz/CodeMCP/wiki/Index-Management)** for complete documentation.
378
235
 
379
- # Analyze change impact
380
- ckb impact <symbol-id>
236
+ ## Features
381
237
 
382
- # Query ownership
383
- ckb ownership internal/api/handler.go
238
+ | Feature | Description |
239
+ |---------|-------------|
240
+ | [**Compound Operations**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#compound-operations) | `explore`, `understand`, `prepareChange` — single-call tools that reduce AI overhead by 60-70% |
241
+ | [**Code Navigation**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#code-navigation--discovery) | Semantic search, call graphs, trace usage, find entrypoints |
242
+ | [**Impact Analysis**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#impact-analysis--safety) | Blast radius, risk scoring, affected tests, breaking changes (`compareAPI`) |
243
+ | [**Architecture**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#architectural-understanding) | Module overview, ADRs, dependency graphs, explain origin |
244
+ | [**Ownership**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#ownership--review) | CODEOWNERS + git blame, reviewer suggestions, drift detection |
245
+ | [**Code Quality**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#code-quality--risk) | Dead code detection (`findDeadCode`), coupling analysis, complexity |
246
+ | [**Security**](https://github.com/SimplyLiz/CodeMCP/wiki/Security) | Secret detection, credential scanning, allowlists |
247
+ | [**Documentation**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#documentation-intelligence) | Doc-symbol linking, staleness detection, coverage metrics |
248
+ | [**Multi-Repo**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#multi-repo--federation) | Federation, API contracts, remote index serving |
249
+ | [**Runtime**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#runtime-intelligence) | OpenTelemetry integration, observed usage, production dead code |
250
+ | [**Streaming**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#streaming) | SSE streaming for `findReferences`, `searchSymbols` with real-time progress |
251
+ | [**Automation**](https://github.com/SimplyLiz/CodeMCP/wiki/Features#automation--cicd) | Daemon mode, watch mode, webhooks, incremental indexing |
384
252
 
385
- # List architectural decisions
386
- ckb decisions
253
+ 📖 **[Full Features Guide](https://github.com/SimplyLiz/CodeMCP/wiki/Features)** — Detailed documentation with examples
387
254
 
388
- # Run diagnostics
389
- ckb doctor
255
+ 📋 **[Changelog](https://github.com/SimplyLiz/CodeMCP/blob/main/CHANGELOG.md)** — Version history
390
256
 
391
- # Check tier-specific requirements
392
- ckb doctor --tier enhanced
257
+ ## CLI
393
258
 
394
- # Start MCP server for AI assistants
395
- ckb mcp
259
+ ```bash
260
+ ckb status # System health (with remediation suggestions)
261
+ ckb search Handler # Find symbols
262
+ ckb diff-summary # Analyze what changed
263
+ ckb hotspots # Risky areas
264
+ ckb arch # Architecture overview
265
+ ckb ownership # File/path ownership
266
+ ckb mcp # Start MCP server
396
267
  ```
397
268
 
398
- <details>
399
- <summary><strong>More CLI commands</strong></summary>
400
-
269
+ **v8.0 Compound Operations (via MCP):**
401
270
  ```bash
402
- # Federation (v6.2)
403
- ckb federation create platform --description "Our microservices"
404
- ckb federation add platform --repo-id=api --path=/code/api
405
- ckb federation status platform
406
- ckb federation sync platform
407
-
408
- # Remote Federation (v7.3)
409
- ckb federation add-remote platform prod --url=https://ckb.company.com --token=$CKB_TOKEN
410
- ckb federation list-remote platform
411
- ckb federation sync-remote platform
412
- ckb federation status-remote platform prod
413
-
414
- # Daemon (v6.2.1)
415
- ckb daemon start [--port=9120]
416
- ckb daemon status
417
- ckb daemon logs --follow
418
- ckb daemon stop
419
-
420
- # Contracts (v6.3)
421
- ckb contracts list platform
422
- ckb contracts impact platform --repo=api --path=proto/api/v1/user.proto
423
- ckb contracts deps platform --repo=api
424
-
425
- # Telemetry (v6.4)
426
- ckb telemetry status
427
- ckb telemetry usage --symbol="internal/api/handler.go:HandleRequest"
428
- ckb dead-code --min-confidence=0.7
429
-
430
- # Developer Intelligence (v6.5)
431
- ckb explain internal/api/handler.go:42
432
- ckb coupling internal/query/engine.go --min-correlation=0.5
433
- ckb export --min-complexity=10 --max-symbols=200
434
- ckb audit --min-score=60 --quick-wins
271
+ # These tools combine multiple queries into single calls
272
+ explore # Area exploration: symbols, dependencies, hotspots
273
+ understand # Symbol deep-dive: refs, callers, explanation
274
+ prepareChange # Pre-change analysis: impact, tests, risk
275
+ batchGet # Fetch up to 50 symbols at once
276
+ batchSearch # Run up to 10 searches at once
435
277
  ```
436
278
 
437
- </details>
279
+ 📖 **[User Guide](https://github.com/SimplyLiz/CodeMCP/wiki/User-Guide)** — All CLI commands and options
438
280
 
439
281
  ## HTTP API
440
282
 
@@ -628,9 +470,12 @@ Use `cmd /c` wrapper in any config above:
628
470
  <details>
629
471
  <summary><strong>Presets (Token Optimization)</strong></summary>
630
472
 
631
- CKB exposes 76 tools, but most sessions only need a subset. Use presets to reduce token overhead by up to 83%:
473
+ CKB exposes 80+ tools, but most sessions only need a subset. Use presets to reduce token overhead by up to 83%:
632
474
 
633
475
  ```bash
476
+ # List all available presets with tool counts and token estimates
477
+ ckb mcp --list-presets
478
+
634
479
  # Default: core preset (14 essential tools)
635
480
  ckb mcp
636
481
 
@@ -641,7 +486,7 @@ ckb mcp --preset=refactor # 19 tools - core + coupling, dead code
641
486
  ckb mcp --preset=federation # 28 tools - core + cross-repo
642
487
  ckb mcp --preset=docs # 20 tools - core + doc-symbol linking
643
488
  ckb mcp --preset=ops # 25 tools - core + jobs, webhooks, metrics
644
- ckb mcp --preset=full # 76 tools - all tools (legacy)
489
+ ckb mcp --preset=full # 80+ tools - all tools (legacy)
645
490
  ```
646
491
 
647
492
  In MCP config:
@@ -684,6 +529,24 @@ Persistent knowledge survives across sessions:
684
529
  - **Code reviewers** — See the full picture of changes
685
530
  - **Tech leads** — Track architectural health over time
686
531
 
532
+ ## Limitations (Honest Take)
533
+
534
+ **CKB excels at:**
535
+ - Static code navigation—finding definitions, references, call graphs
536
+ - Impact analysis for safe refactoring
537
+ - Ownership lookup (CODEOWNERS + git blame)
538
+ - Architecture and module understanding
539
+
540
+ **CKB won't help with:**
541
+ - Dynamic dispatch / runtime behavior (use debugger)
542
+ - Generated code that isn't indexed
543
+ - Code generation, linting, or formatting
544
+ - Cross-repo calls (use [federation](https://github.com/SimplyLiz/CodeMCP/wiki/Federation) for this)
545
+
546
+ > CKB is static analysis, not magic. Always verify critical decisions by reading the actual code.
547
+
548
+ 📖 **[Practical Limits](https://github.com/SimplyLiz/CodeMCP/wiki/Practical-Limits)** — Full guide on accuracy, blind spots, and when to trust results
549
+
687
550
  ## Documentation
688
551
 
689
552
  See the **[Full Documentation Wiki](https://github.com/SimplyLiz/CodeMCP/wiki)** for:
@@ -693,14 +556,16 @@ See the **[Full Documentation Wiki](https://github.com/SimplyLiz/CodeMCP/wiki)**
693
556
  - [Language Support](https://github.com/SimplyLiz/CodeMCP/wiki/Language-Support) — SCIP indexers and support tiers
694
557
  - [Practical Limits](https://github.com/SimplyLiz/CodeMCP/wiki/Practical-Limits) — Accuracy notes, blind spots
695
558
  - [User Guide](https://github.com/SimplyLiz/CodeMCP/wiki/User-Guide) — CLI commands and best practices
559
+ - [Index Management](https://github.com/SimplyLiz/CodeMCP/wiki/Index-Management) — How indexing works, auto-refresh methods
696
560
  - [Incremental Indexing](https://github.com/SimplyLiz/CodeMCP/wiki/Incremental-Indexing) — Fast index updates for Go projects
697
561
  - [Doc-Symbol Linking](https://github.com/SimplyLiz/CodeMCP/wiki/Doc-Symbol-Linking) — Symbol detection in docs, staleness checking
698
562
  - [Authentication](https://github.com/SimplyLiz/CodeMCP/wiki/Authentication) — API tokens, scopes, rate limiting
699
- - [MCP Integration](https://github.com/SimplyLiz/CodeMCP/wiki/MCP-Integration) — Claude Code setup, 76 tools
563
+ - [MCP Integration](https://github.com/SimplyLiz/CodeMCP/wiki/MCP-Integration) — Claude Code setup, 80+ tools
700
564
  - [API Reference](https://github.com/SimplyLiz/CodeMCP/wiki/API-Reference) — HTTP API documentation
701
565
  - [Daemon Mode](https://github.com/SimplyLiz/CodeMCP/wiki/Daemon-Mode) — Always-on service with scheduler, webhooks
702
566
  - [Configuration](https://github.com/SimplyLiz/CodeMCP/wiki/Configuration) — All options including MODULES.toml
703
567
  - [Architecture](https://github.com/SimplyLiz/CodeMCP/wiki/Architecture) — System design and components
568
+ - [Security](https://github.com/SimplyLiz/CodeMCP/wiki/Security) — Secret detection, credential scanning
704
569
  - [Telemetry](https://github.com/SimplyLiz/CodeMCP/wiki/Telemetry) — Runtime observability, dead code detection
705
570
  - [Federation](https://github.com/SimplyLiz/CodeMCP/wiki/Federation) — Cross-repository queries
706
571
  - [CI/CD Integration](https://github.com/SimplyLiz/CodeMCP/wiki/CI-CD-Integration) — GitHub Actions, PR analysis
@@ -720,4 +585,9 @@ See the **[Full Documentation Wiki](https://github.com/SimplyLiz/CodeMCP/wiki)**
720
585
 
721
586
  ## License
722
587
 
723
- Free for personal use. Commercial/enterprise use requires a license. See [LICENSE](LICENSE) for details.
588
+ **Free for:**
589
+ - Personal use
590
+ - Open source projects
591
+ - Startups & small businesses under $25k annual revenue
592
+
593
+ **Commercial license required** for organizations with $25k+ annual revenue. See [pricing](https://codeknowledge.dev/pricing) for Team and Enterprise plans, or [LICENSE](LICENSE) for full terms.
package/bin/ckb CHANGED
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tastehub/ckb-linux-arm64",
3
- "version": "7.5.0",
3
+ "version": "8.0.1",
4
4
  "description": "CKB binary for linux-arm64",
5
5
  "os": ["linux"],
6
6
  "cpu": ["arm64"],