docs: Homebrew install must use the fully-qualified formula name
Homebrew 6.0 refuses to load formulae from untrusted third-party taps.
The documented two-step install is now broken on a clean machine:
brew tap SimplyLiz/ckb && brew install ckb
-> Error: Refusing to load formula simplyliz/ckb/ckb from untrusted
tap simplyliz/ckb
Installing by fully-qualified name grants trust for that single formula
automatically, so `brew install simplyliz/ckb/ckb` just works — verified
end to end from a cleared trust.json, installing 9.3.0. Once installed
the formula is trusted, so short-name `brew upgrade ckb` still works.
There is no publisher-side fix: per docs.brew.sh/Tap-Trust, trust is
client-side and per-user, with no signing, allowlist or registration for
tap maintainers. Getting the one-line form documented is the whole fix.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
docs: catch wiki up to v9.3
Cartographer.md led with "you need Rust and a source build" to get the
fast structural tier. That stopped being true in v9.3: the release
pipeline now builds darwin/{arm64,amd64} and linux/{amd64,arm64} with
CGo on native runners, linking a pinned checksum-verified Cartographer
v4.0.2. Verified against the shipped Homebrew tarball, which reports
"Cartographer engine linked (v4.0.2) — fast structural tier active".
Windows still ships the pure-Go stub.
- Cartographer.md: new "Do You Already Have It?" section stating what
each channel ships, `ckb doctor` as the way to check, the v9.3
large-repo hardening (256 MB-stack pool, iterative tarjan_scc, depth
ceiling) that fixed the FFI process abort on a kernel-sized tree, and
sync-cartographer.sh replacing the stale git-subtree instruction.
- MCP-Tools.md: header to v9.3; detail sections for symbolExists and
analyzeOutgoingImpact, which were listed in the overview tables but
had no docs; the v9.2 bridge-centrality risk multiplier and LIP
tier-1 caller folding on analyzeImpact; doctor's cartographer check.
- Home.md: What's New in v9.3.
- Impact-Analysis.md: [[examples/README]] was a dead wikilink — no such
wiki page. Points at the repo file on GitHub now.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
docs: catch wiki up to v9.2
The wiki had drifted across releases. Tool/preset counts, token-savings
percentages, LIP version, and review-check counts all referenced older
numbers. Several v9.1/v9.2 features were missing entirely.
Numbers refreshed against running binary (`ckb mcp --list-presets`):
- Preset sizes: core 25, review 42, refactor 42, federation 46, docs 34,
ops 43, full 110 (was 14/19/19/28/20/25/80+)
- Full preset: ~17k tokens / 77% savings (was ~9k / 83%)
- LIP: v2.3+ (was v2.0)
- `ckb review`: 21 checks (was 20 — `unwired` was missing)
Documented features that had no wiki coverage:
- v9.2 MCP tools `analyzeOutgoingImpact`, `symbolExists`, `renderArchitecture`
- Cartographer 3.0.0 graph rendering (Mermaid + Graphviz DOT)
- LIP v2.3 outgoing-impact and semantic-coupling enrichment
- Cartographer.md was authored locally but never committed
docs(v9.0.0): LIP v2.0 integration + correct setup instructions
- Home.md: What's New in v9.0 section with LIP semantic layer bullets
- Hybrid-Retrieval.md: correct LIP daemon startup command, add
LIP_EMBEDDING_URL/LIP_EMBEDDING_MODEL env vars, note context-limit
workaround for large files, update doctor output format
- MCP-Tools.md: mark tools enhanced by LIP (✦) with link to lip docs
- Quick-Start.md: two-mode LIP setup (graph-only vs. with embeddings)
- Architecture.md, Contributing.md, Practical-Limits.md: minor v9 refs
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
docs: add A2A protocol documentation and cross-references
- New page: A2A-Integration.md — full A2A protocol guide with setup,
agent discovery, protocol bindings, skill reference, health/index
status, push notifications, auth, and integration examples
- Home.md: add A2A/agent platforms to "Works With Your Tools" table
- Architecture.md: add A2A Server to interface layer diagram
- Features.md: add "Agent-to-Agent Orchestration" scenario section
- Integration-Guide.md: add "Multi-Agent Systems (A2A)" ideas table
- Quick-Start.md: add A2A server startup section
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
docs: update tool counts across all wiki pages for v8.3
Update stale tool/preset counts in 8 pages:
- core: 14→24, review: 27→40, refactor: 33→39, full: 92→96
- "80+ tools" / "90+ tools" → "96 tools" everywhere
- Token estimates updated to match new preset sizes
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
feat: Add Compliance-Audit wiki page, update Home and Features
- New Compliance-Audit.md with full documentation: 20 frameworks,
126 checks, cross-framework mapping, check details for GDPR/PCI DSS/
HIPAA/SOC 2/safety, configuration, CI/CD integration, CLI reference
- Home.md: added compliance audit entry
- Features.md: added compliance audit section with framework overview
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
docs: Update review docs for v8.3 — 19 checks, new analyzers
- 17→19 checks across all wiki pages
- Add comment-drift and format-consistency to checks table
- Update blast-radius: informational mode when no threshold set
- Add check list to Workflow-Examples
docs: Update review docs for v8.3 — 17 checks, new analyzers, architecture diagram
- 14→17 checks across all pages (Code-Review, CI-CD, Quality-Gates,
Features, Home, User-Guide, Workflow-Examples, MCP-Tools)
- Add dead-code, test-gaps, blast-radius to check table and examples
- Add --staged, --scope, positional arg invocation modes
- Add max-fanout, dead-code-confidence, test-gap-lines config/flags
- Add architecture SVG reference in Code-Review page
- Update concurrency note (mutex-based, not sequential block)
- Update GitHub Action inputs with new analyzer thresholds
docs: Add unified code review documentation (ckb review, reviewPR)
- New Code-Review.md: checks, formats, policy, health, baselines, compliance
- Update Home, Features, User-Guide, MCP-Tools, CI-CD-Integration,
Workflow-Examples, Quality-Gates with cross-references
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
docs: update Home.md for v8.1 release
- Update What's New section from v8.0 to v8.1 with refactoring intelligence features
- Update preset tool counts to match presets.go (core:21, review:27, refactor:33, docs:27, federation:35, full:92)
- Update tool reference count from 80+ to 90+
docs: add Homebrew installation instructions
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: add Grok to supported AI tools across wiki pages
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: update wiki for v8.0 release
- Add compound operations (explore, understand, prepareChange, batchGet, batchSearch)
- Add SSE streaming documentation for findReferences and searchSymbols
- Add reindex MCP tool section to Index-Management
- Add prepareChange tool section to Impact-Analysis
- Add Compound Operations section to Prompt-Cookbook
- Update all tool counts from 76/77/81 to 80+
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: add Security page for secret detection feature
- New Security.md page documenting scanSecrets MCP tool
- Document 26 builtin patterns, scan scopes, and allowlist configuration
- Add CI/CD integration examples (pre-commit, GitHub Actions)
- Update Home.md with v8.0 security features and links
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: add v8.0 compound tools documentation
Add documentation for 5 new compound tools that reduce AI tool calls by 60-70%:
- `explore` - comprehensive area exploration (file/dir/module)
- `understand` - symbol deep-dive with ambiguity handling
- `prepareChange` - pre-change impact + risk assessment
- `batchGet` - retrieve multiple symbols by ID (max 50)
- `batchSearch` - multiple symbol searches (max 10 queries)
Updates:
- MCP-Tools.md: Add compound operations section with full documentation
- Features.md: Add compound tools to v8.0 section and quick reference
- Home.md: Update "What's New in v8.0" to include compound tools
- Tool count updated from 81 to 86
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: add Quality Gates guide and Best Practices section
- Add Quality-Gates.md with comprehensive gate documentation:
- Complexity, Risk, Coupling, Coverage, Contract, Dead Code, Eval gates
- Warn vs fail modes, inline annotations
- Starter/Standard/Strict profiles
- Rollout strategy and troubleshooting
- Add Best Practices section to Workflow-Examples.md:
- Security hardening (SHA pinning, minimal permissions, OIDC)
- Caching strategy (restore-keys, conditional caching)
- Job outputs vs artifacts
- Reusable workflows (secrets inherit, outputs)
- Composite actions (CKB setup action template)
- Performance tips table
- Update cross-references:
- Link Quality Gates from Home.md Integration section
- Link Quality Gates from CI-CD-Integration.md
- Add callout to Workflow-Examples.md
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: add Workflow-Examples wiki page with full documentation
Comprehensive documentation for all CI/CD workflow examples:
- 20+ GitHub Actions workflows with example outputs
- GitLab CI configuration
- Git hooks (pre-commit, pre-push, husky, lint-staged)
- Starter template with customization guide
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs(home): rewrite intro with compelling marketing copy
New tagline: "Know your code. Change it safely. Ship with confidence."
Rewrote "What is CKB?" section:
- Before/after comparison table showing pain points vs solutions
- "More Than Code Search" with 6 capability categories
- "Works With Your Tools" showing AI/CI/IDE integrations
- "Built for Scale" highlighting incremental indexing, federation, token optimization
Better metaphor: "senior engineer who knows every line of code"
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: add Integration Guide for CLI, API, and MCP usage
New comprehensive guide showing how to use CKB in custom tools:
CLI Integration:
- Shell scripts with JSON output
- Node.js and Python examples
- CI/CD patterns
- Useful jq patterns
HTTP API:
- All endpoints with curl examples
- TypeScript, Python, and Go client code
- Authentication handling
MCP Integration:
- Starting the MCP server
- Configuring AI tools (Claude Code, Cursor)
- Building custom MCP clients
- Tool presets and dynamic expansion
Common Patterns:
- Pre-commit hooks
- PR bots
- VS Code extensions
- Best practices (caching, freshness, batching)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: comprehensive Impact Analysis documentation (PR56)
- Create dedicated Impact-Analysis.md with full feature documentation
- Add examples/ directory with CI templates:
- GitHub Actions: impact-comment.yml, impact-analysis.yml, ckb-reusable.yml, ckb-refresh.yml
- GitLab CI: ckb.yml template
- Git hooks: pre-commit, pre-commit-config.yaml, husky integration
- Add coverage file examples for Dart, Rust, Java
- Add --format=list and --coverage flags to affected-tests docs
- Fix config format to JSON (was incorrectly YAML)
- Document ckb doctor orphaned index and optional tools checks
- Consolidate Change-Impact-Analysis.md into new page
- Update CI-CD-Integration.md with template links
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: add Change Impact Analysis documentation (v8.0)
- Create Change-Impact-Analysis.md with full feature documentation
- Update MCP-Tools.md to add analyzeChange tool
- Update Features.md with new feature section and quick reference link
- Update Home.md to include impact diff in key tools
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: add Index-Management wiki page
Document how index refresh works:
- Branch switching detection (daemon ~7s, MCP ~10s)
- Refresh trigger types and visibility
- Daemon file watcher (polling .git/HEAD + .git/index)
- MCP watch mode
- Troubleshooting guide
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: add MCP-Tools reference to Home.md
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: streamline Home.md with prominent Features links
- Add callout after intro directing users to Features page
- Replace verbose Key Features (~175 lines) with concise Key Capabilities table (~30 lines) linking to Features sections
- Slim down MCP Tools section (~150 lines → ~20 lines) with preset summary
- Reorganize documentation links into grouped tables (Getting Started, Integration, Advanced, Reference)
- Reduce total file size from 543 to 276 lines (~50%)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: add Features.md with use-case organized feature overview
Comprehensive feature documentation organized by what users can accomplish:
- Code Navigation & Discovery
- Impact Analysis & Safety
- Architectural Understanding
- Ownership & Review
- Code Quality & Risk
- Documentation Intelligence
- Multi-Repo & Federation
- Runtime Intelligence
- Automation & CI/CD
- MCP Integration
Also added link from Home.md Table of Contents.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: add dedicated Presets page and consolidate documentation
Create Presets.md as the single source of truth for preset documentation:
- Complete tool lists for all 7 presets
- Token estimates and use case descriptions
- Dynamic expansion with expandToolset
- MCP configuration examples
- Choosing the right preset guide
Update other pages to link to Presets.md:
- MCP-Integration.md: Simplified preset section
- User-Guide.md: Brief mention with link
- Quick-Start.md: Link to Presets
- Home.md: Link in section header
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: comprehensive v7.4 presets documentation update
- Add Tool Presets & Token Optimization section to Home.md
- Add --preset flag documentation to User-Guide.md
- Add preset example to Quick-Start.md
- Update tool count references from 74 to 76
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: Update hybrid retrieval results to 100% recall
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
docs: Add Hybrid Retrieval wiki page for v7.4
- New Hybrid-Retrieval.md with full documentation
- Add v7.4 feature section to Home.md
- Add Table of Contents link
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>