From f887e2fbfe9be0cc812ab01bb2360bb122ba3e14 Mon Sep 17 00:00:00 2001 From: denfry Date: Wed, 24 Jun 2026 09:41:35 +0300 Subject: [PATCH] release: v1.6.0 Snippet skeletonization + content-aware rendering, ported from headroom: - focus skeletons (signatures + matched line kept, bodies elided) so more ranked results fit the token budget; content-aware (code/markdown/config) - reversible via recommended_reads; raw-fallback safe; --raw / raw to disable - new skeletonized / elided_lines fields; retrieval.compact_snippets + compact_min_reduction config knobs (no reindex) Bump __version__, plugin.json, requirements.lock pin, skill .skill_version stamps, and doc install snippets to v1.6.0; move CHANGELOG [Unreleased] -> [1.6.0]. Co-Authored-By: Claude Opus 4.8 (1M context) --- .claude-plugin/plugin.json | 2 +- .claude/skills/codebase-index/.skill_version | 2 +- .codex/skills/codebase-index/.skill_version | 2 +- .../skills/codebase-index/.skill_version | 2 +- CHANGELOG.md | 2 ++ README.md | 20 +++++++++---------- docs/ARCHITECTURE.md | 2 +- docs/FAQ.md | 6 +++--- docs/INSTALLATION.md | 20 +++++++++---------- docs/MCP.md | 2 +- docs/QUICKSTART.md | 2 +- docs/SEO.md | 4 ++-- docs/installer.md | 4 ++-- requirements.lock | 2 +- src/codebase_index/__init__.py | 2 +- 15 files changed, 38 insertions(+), 36 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 4e16bc7..1635e02 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -3,7 +3,7 @@ "name": "codebase-index", "displayName": "Codebase Index", "description": "Local-first hybrid codebase index. Auto-provisions its Python CLI on first session start; the skill searches the index so Claude reads only the most relevant files.", - "version": "1.5.0", + "version": "1.6.0", "author": { "name": "codebase-index contributors" }, diff --git a/.claude/skills/codebase-index/.skill_version b/.claude/skills/codebase-index/.skill_version index bc80560..dc1e644 100644 --- a/.claude/skills/codebase-index/.skill_version +++ b/.claude/skills/codebase-index/.skill_version @@ -1 +1 @@ -1.5.0 +1.6.0 diff --git a/.codex/skills/codebase-index/.skill_version b/.codex/skills/codebase-index/.skill_version index bc80560..dc1e644 100644 --- a/.codex/skills/codebase-index/.skill_version +++ b/.codex/skills/codebase-index/.skill_version @@ -1 +1 @@ -1.5.0 +1.6.0 diff --git a/.opencode/skills/codebase-index/.skill_version b/.opencode/skills/codebase-index/.skill_version index bc80560..dc1e644 100644 --- a/.opencode/skills/codebase-index/.skill_version +++ b/.opencode/skills/codebase-index/.skill_version @@ -1 +1 @@ -1.5.0 +1.6.0 diff --git a/CHANGELOG.md b/CHANGELOG.md index c0cb476..6f1446e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,8 @@ All notable changes to this project are documented here. The format is based on ## [Unreleased] +## [1.6.0] - 2026-06-24 + ### Added - **Snippet skeletonization & content-aware rendering.** `search`/`explain` snippets are now focus skeletons — import/signature/class lines and the query-matching line are kept while diff --git a/README.md b/README.md index 13ded7a..e6ca87b 100644 --- a/README.md +++ b/README.md @@ -64,7 +64,7 @@ If you are opening this repository for the first time, follow this order: If you only need the shortest path, run: ```bash -pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.5.0" +pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.6.0" cd your-project codebase-index init # prompts for Claude Code / Codex CLI / OpenCode codebase-index index @@ -73,13 +73,13 @@ codebase-index search "where is authentication implemented?" ## Project Status -**`1.5.0` is released.** The current release includes repository discovery, +**`1.6.0` is released.** The current release includes repository discovery, SQLite FTS5 storage, Tree-sitter symbols and references, hybrid ranking, graph impact analysis, token-budgeted retrieval packets, optional local embeddings, hooks/watch support, multi-CLI installation, MCP server support, and a tested GitHub-only `pipx` install path. -The `1.5.0` release turns the dependency graph into a navigable map: every edge +The `1.6.0` release turns the dependency graph into a navigable map: every edge carries a `confidence` audit trail (`extracted`/`inferred`/`ambiguous`, surfaced in `refs`/`impact`); a new zero-dependency analytics pass computes modules (communities), god nodes, and surprising cross-module links, exposed via the @@ -128,7 +128,7 @@ For most users, install the package from the tagged GitHub release and run `init` inside the repository you want to index: ```bash -pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.5.0" +pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.6.0" cd your-project codebase-index init # choose Claude Code, Codex CLI, OpenCode, or all codebase-index index @@ -166,7 +166,7 @@ fetch the package; later sessions are offline. The skill builds its index on your first codebase question, so there is no manual `index` step. **Distribution note:** the plugin bootstrap installs the pinned requirement from -`requirements.lock`. In `1.5.0`, that lock points at the tagged GitHub release +`requirements.lock`. In `1.6.0`, that lock points at the tagged GitHub release instead of PyPI. You can override it with `CBX_INSTALL_SPEC` when testing a local checkout or a different Git ref. @@ -303,7 +303,7 @@ irm https://raw.githubusercontent.com/denfry/codebase-index/main/install.ps1 | i ```bash cd your-project -pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.5.0" +pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.6.0" codebase-index init codebase-index index ``` @@ -323,13 +323,13 @@ the `pipx` environment was likely created with an older Python version. Reinstal ```powershell pipx uninstall codebase-index py -0p -pipx install --python "\python.exe" "git+https://github.com/denfry/codebase-index.git@v1.5.0" +pipx install --python "\python.exe" "git+https://github.com/denfry/codebase-index.git@v1.6.0" ``` For example: ```powershell -pipx install --python "C:\Users\you\AppData\Local\Programs\Python\Python312\python.exe" "git+https://github.com/denfry/codebase-index.git@v1.5.0" +pipx install --python "C:\Users\you\AppData\Local\Programs\Python\Python312\python.exe" "git+https://github.com/denfry/codebase-index.git@v1.6.0" ``` Then run initialization again: @@ -343,7 +343,7 @@ codebase-index index ### Option 2: Install with pipx from GitHub ```bash -pipx install "git+https://github.com/denfry/codebase-index.git@v1.5.0" +pipx install "git+https://github.com/denfry/codebase-index.git@v1.6.0" cd your-project codebase-index init --target auto codebase-index index @@ -361,7 +361,7 @@ pip install -e ".[dev]" PyPI, `uvx`, Homebrew, signed release checksums, and SBOMs are important for a tool that reads entire repositories, but they are not all verified as shipped in -`1.5.0`. Target install story: +`1.6.0`. Target install story: ```bash uvx codebase-index init diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 45d0041..32b0000 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -2,7 +2,7 @@ ## 1. Overview -`codebase-index` is a **local-first** code intelligence layer for AI coding agents. In `1.5.0` +`codebase-index` is a **local-first** code intelligence layer for AI coding agents. In `1.6.0` it has two shipped faces: 1. **A Claude Code Skill** (`.claude/skills/codebase-index/SKILL.md`) that Claude auto-invokes for diff --git a/docs/FAQ.md b/docs/FAQ.md index 4d88c9a..d95d0b1 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -10,7 +10,7 @@ This page answers the most common questions about installing, running, and trust with `pipx` (isolated) or `pip`, pinned to a release tag for reproducibility: ```bash -pipx install "git+https://github.com/denfry/codebase-index.git@v1.5.0" +pipx install "git+https://github.com/denfry/codebase-index.git@v1.6.0" ``` Then run `codebase-index init` inside your project and `codebase-index index` to build @@ -158,8 +158,8 @@ Yes. Use any of these methods: ## Is it production-ready? -Yes — `codebase-index` is released as **v1.5.0**. The core indexing and search -functionality is implemented and tested. The current `1.5.0` package includes: +Yes — `codebase-index` is released as **v1.6.0**. The core indexing and search +functionality is implemented and tested. The current `1.6.0` package includes: - Hybrid FTS/path/symbol/vector retrieval - Import/call/reference graph expansion and `impact` diff --git a/docs/INSTALLATION.md b/docs/INSTALLATION.md index a7f35cb..aea01ee 100644 --- a/docs/INSTALLATION.md +++ b/docs/INSTALLATION.md @@ -3,7 +3,7 @@ This page explains how to install `codebase-index` and make it available in Claude Code, Codex CLI, or OpenCode. > **Distribution:** `codebase-index` is **not on PyPI**. It is installed directly -> from GitHub via `git+https://...@`. Pin to a release tag (e.g. `@v1.5.0`) +> from GitHub via `git+https://...@`. Pin to a release tag (e.g. `@v1.6.0`) > for reproducible installs; use `@main` to track the latest. ## Choose Your Path @@ -28,7 +28,7 @@ Install the tagged GitHub release and scaffold the skill into your project: ```bash cd your-project -pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.5.0" +pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.6.0" codebase-index init codebase-index index ``` @@ -62,13 +62,13 @@ ln -s ~/codebase-index/skill ~/.claude/skills/codebase-index ```bash # Using pip from the tagged GitHub release -pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.5.0" +pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.6.0" # Using pipx from GitHub (isolated environment) -pipx install "git+https://github.com/denfry/codebase-index.git@v1.5.0" +pipx install "git+https://github.com/denfry/codebase-index.git@v1.6.0" # Using uv from GitHub -uv tool install "git+https://github.com/denfry/codebase-index.git@v1.5.0" +uv tool install "git+https://github.com/denfry/codebase-index.git@v1.6.0" # From source (editable mode) git clone https://github.com/denfry/codebase-index.git @@ -91,7 +91,7 @@ pip install -e ".[embeddings-local,watch,dev]" ### PyPI / uvx / Homebrew status -As of `1.5.0`, this documentation treats GitHub tag installs as the verified +As of `1.6.0`, this documentation treats GitHub tag installs as the verified path. PyPI, `uvx codebase-index init`, Homebrew tap installation, signed checksums, and SBOMs are distribution targets for a more complete release story. @@ -108,7 +108,7 @@ brew install denfry/tap/codebase-index On a machine with only Python + pipx: ```bash -pipx install "git+https://github.com/denfry/codebase-index.git@v1.5.0" +pipx install "git+https://github.com/denfry/codebase-index.git@v1.6.0" cd /path/to/your/repo codebase-index init # writes .claude/skills/codebase-index/ + .gitignore rules codebase-index index # builds .claude/cache/codebase-index/index.sqlite @@ -131,7 +131,7 @@ Expected output: === codebase-index Doctor === [OK] Python 3.12 (requires 3.11+) -[OK] codebase-index package installed (v1.5.0) +[OK] codebase-index package installed (v1.6.0) [OK] tree-sitter is available [INFO] Cache directory not yet created: ... [INFO] Skill not installed in .claude/skills/ @@ -188,7 +188,7 @@ Use `codebase-index doctor` to verify which hooks are enabled. For heavy editing For heavy editing sessions, `watch` mode keeps the index fresh via a debounced filesystem observer. Requires the `[watch]` extra: ```bash -pip install "codebase-index[watch] @ git+https://github.com/denfry/codebase-index.git@v1.5.0" +pip install "codebase-index[watch] @ git+https://github.com/denfry/codebase-index.git@v1.6.0" codebase-index watch --debounce 500 ``` @@ -278,7 +278,7 @@ Set `allow_external` to `false` to disable external API calls. ## Recommended Flow for First-Time Users ```bash -pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.5.0" +pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.6.0" cd your-project codebase-index init codebase-index index diff --git a/docs/MCP.md b/docs/MCP.md index b5c08da..19c1b63 100644 --- a/docs/MCP.md +++ b/docs/MCP.md @@ -3,7 +3,7 @@ `codebase-index` ships a stdio MCP server powered by the optional `mcp` extra: ```bash -pip install "codebase-index[mcp] @ git+https://github.com/denfry/codebase-index.git@v1.5.0" +pip install "codebase-index[mcp] @ git+https://github.com/denfry/codebase-index.git@v1.6.0" codebase-index mcp --root /path/to/repo ``` diff --git a/docs/QUICKSTART.md b/docs/QUICKSTART.md index 17d460e..02c161e 100644 --- a/docs/QUICKSTART.md +++ b/docs/QUICKSTART.md @@ -11,7 +11,7 @@ Use this guide if you are new to `codebase-index` and want the fastest path to y ## Step 1: Install ```bash -pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.5.0" +pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.6.0" ``` Or from source: diff --git a/docs/SEO.md b/docs/SEO.md index 67af63f..6e0919e 100644 --- a/docs/SEO.md +++ b/docs/SEO.md @@ -177,7 +177,7 @@ Features: - Secret redaction - Respects .gitignore -Install: pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.5.0" +Install: pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.6.0" GitHub: https://github.com/denfry/codebase-index ``` @@ -192,5 +192,5 @@ codebase-index builds a local hybrid index so Claude finds the right files witho - No network by default - Token-efficient output -pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.5.0" +pip install "codebase-index @ git+https://github.com/denfry/codebase-index.git@v1.6.0" ``` diff --git a/docs/installer.md b/docs/installer.md index c2e630f..0c54c1b 100644 --- a/docs/installer.md +++ b/docs/installer.md @@ -108,7 +108,7 @@ pwsh ./install.ps1 -Target claude -InstallDir "D:\skills\codebase-index" **Pinning по ветке/тегу** (воспроизводимость и безопасность): ```sh -sh install.sh --branch v1.5.0 +sh install.sh --branch v1.6.0 ``` --- @@ -151,7 +151,7 @@ sh install.sh --branch v1.5.0 ```json { "skill_name": "codebase-index", - "version": "1.5.0", + "version": "1.6.0", "installed_at": "2026-05-29T12:00:00Z", "target": "claude", "os": "linux", diff --git a/requirements.lock b/requirements.lock index fbee19f..6b38098 100644 --- a/requirements.lock +++ b/requirements.lock @@ -1,3 +1,3 @@ -codebase-index @ https://github.com/denfry/codebase-index/archive/refs/tags/v1.5.0.tar.gz +codebase-index @ https://github.com/denfry/codebase-index/archive/refs/tags/v1.6.0.tar.gz tree-sitter==0.25.2 tree-sitter-language-pack==1.8.1 diff --git a/src/codebase_index/__init__.py b/src/codebase_index/__init__.py index 9df4c05..77addf7 100644 --- a/src/codebase_index/__init__.py +++ b/src/codebase_index/__init__.py @@ -4,4 +4,4 @@ See docs/ARCHITECTURE.md for the module map. """ -__version__ = "1.5.0" +__version__ = "1.6.0"