Skip to content

code-kb v1.0.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 15 Sep 01:45
· 157 commits to main since this release
v1.0.0
84dd5ad

Release Notes: code-kb v1.0.0

code-kb v1.0.0 is the foundational milestone release of the lightweight, agent-facing code-intelligence engine and Model Context Protocol (MCP) server.

Designed specifically for AI coding agents (such as Claude Code, Codex, Antigravity, Gemini, and Cursor), code-kb provides progressive disclosure, semantic symbol search, and surgical context slicing with minimal token consumption, zero background daemon bloat, and sub-15 MB retained memory.

Highlights & Key Capabilities

1. Zero-Workspace MCP Architecture (Invariant 1)

  • MCP tool schemas never expose workspace, repo_path, or root_dir parameters.
  • Workspaces bind automatically via IDE handshake roots, per-project .mcp.json CWD, or path inspection on tool calls.
  • Eliminates context-token burn, slash-separator mismatches, and agent path hallucination.

2. Dual-Distribution & Pinned Extractor Bundling (Invariant 7)

  • Ships standalone precompiled archives bundling code-kb and the pinned julie-extract (v2.42.3) binary side-by-side.
  • Zero-dependency installation: users download a single archive and execute immediately without installing external AST parsers or runtimes.
  • Supported targets:
    • Linux x86_64 (x86_64-unknown-linux-gnu)
    • macOS Apple Silicon (aarch64-apple-darwin)
    • macOS Intel (x86_64-apple-darwin)
    • Windows x86_64 (x86_64-pc-windows-msvc)

3. Complete 11-Tool Agent Catalog with Exact 1:1 CLI Parity

Every MCP capability has an exact 1:1 CLI command for direct terminal verification:

  1. codebase_outline: Hierarchical directory & architecture outline without listing ignored files.
  2. file_skeleton: Stripped symbol outline with types and signatures (bodies removed to save context tokens).
  3. lookup_symbol: Exact or prefix symbol lookup with optional path scoping.
  4. search_symbols: Natural-language concept and keyword search backed by SQLite FTS5 BM25.
  5. get_symbol_body: Surgical extraction of a specific symbol body without reading entire source files.
  6. get_symbol_context: Surgical context slice returning the target body, immediate callee signatures, parameter types, and test locations in a single turn.
  7. find_references: Callers and callees reference analysis with workspace-symbol filtering.
  8. find_structural_facts: Framework and architectural facts (routes, queries, models, configurations).
  9. blast_radius: Multi-hop reverse reachability analysis using recursive SQLite CTEs with automated test target prediction.
  10. replace_symbol_body: Single-turn atomic AST-validated code replacement with tree-sitter pre-flight syntax checks and concurrency body hashing.
  11. telemetry_summary: Session tool usage, token savings, and efficiency diagnostics.

4. Worktree Isolation & Index Retargeting

  • Automatic index retargeting (retarget_artifact_root) when cloning or using git worktrees.
  • Isolated SQLite database at <root>/.code-kb/artifact.db per workspace and worktree; self-cleans on workspace removal.

5. Windows NTFS First-Class Support

  • Full normalization of Windows verbatim paths (\\?\C:\...) via dunce::simplified.
  • Strict forward-slash (/) output contracts across all JSON and terminal outputs.
  • Comprehensive lock release discipline and verified compatibility on Windows 11 NTFS.

6. Cross-Platform Agent Hooks

  • code-kb hook [SessionStart|SubagentStart|PreInvocation] provides native routing directives for agent harnesses without requiring Node.js, Python, or bash wrappers.

7. Centralized Telemetry

  • Durable, anonymous tool performance and token efficiency history tracked locally at ~/.code-kb/telemetry.db.

Assets & Checksums

Archive Platform SHA256 Checksum
code-kb-v1.0.0-x86_64-unknown-linux-gnu.tar.gz Linux x86_64 0898320f63a0265ee16b33e160e1d51a6db1bc79a77e5c94d03e3a4794e63f96
code-kb-v1.0.0-aarch64-apple-darwin.tar.gz macOS Apple Silicon a80f3220ace2dc19b1884e03f5ceb873dd9cbbfa77884d46c8b9d6288647c087
code-kb-v1.0.0-x86_64-apple-darwin.tar.gz macOS Intel 9491e8dc29da8b258b019463c2c199859f518e380295171a0670d30ec0c85b59
code-kb-v1.0.0-x86_64-pc-windows-msvc.zip Windows x86_64 efd7b20cb6c475969a03395d985aee5c93e4bf43f550bc78d5914a84e27f9999
Assets 10
Loading