indexkit 0.6.3__tar.gz → 0.6.4__tar.gz

{indexkit-0.6.3 → indexkit-0.6.4}/.claude-plugin/plugin.json

@@ -1,9 +1,8 @@
 {
-  "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "indexkit",
   "displayName": "Local RAG",
-  "version": "0.6.3",
-  "description": "Local-first semantic and opt-in hybrid search: a bin/indexkit CLI that embeds through a configurable Ollama endpoint (default localhost), indexes with turbovec, and can fuse FTS5/BM25 candidates. Notes-first, corpus-agnostic via pluggable loaders.",
+  "version": "0.6.4",
+  "description": "Local-first semantic and opt-in hybrid search: a scripts/indexkit CLI that embeds through a configurable Ollama endpoint (default localhost), indexes with turbovec, and can fuse FTS5/BM25 candidates. Notes-first, corpus-agnostic via pluggable loaders.",
   "author": {
     "name": "Mark Beacom"
   },

{indexkit-0.6.3 → indexkit-0.6.4}/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.6.4 — 2026-10-25
+
+- **Move the launcher from `bin/indexkit` to `scripts/indexkit`.** The
+  claude.ai-hosted plugin sync (Claude Desktop) skips any plugin that ships a
+  top-level `bin/`, so indexkit was not syncing there at all. The plugin no
+  longer puts anything on `PATH`: the skill calls the launcher by path
+  (`"${CONTEXT_KIT_INDEXKIT_ROOT:-$CLAUDE_PLUGIN_ROOT}/scripts/indexkit"`) or uses
+  an `indexkit` already installed with `pip`. Manual setups that added
+  `plugins/indexkit/bin` to `PATH` should add `plugins/indexkit/scripts` instead.
+- The skill documents one resolution order for the CLI (`PATH`, then
+  `CONTEXT_KIT_INDEXKIT_ROOT`, then the plugin root, then the host's installed
+  plugin directory) that the obsidian bridge and adr-bridge reuse. The bootstrap
+  hook deliberately does not add `scripts/` to `PATH`: that would hide an
+  executable behind a hook the approval surface shows only as a bootstrap.
+- `allowed-tools` still pre-approves `Bash(indexkit:*)` only, so a by-path
+  launcher call asks for permission once instead of running pre-approved.
+- Drop the `$schema` key from `plugin.json`. The claude.ai-hosted plugin sync
+  (Claude Desktop) does not recognize it and stripped it with a warning on
+  every sync. No change to the plugin's behavior.
+
 ## 0.6.3 — 2026-09-24
 
 - Refresh the locked `anyio` (an indirect dependency via `httpx`) from 4.13.0

{indexkit-0.6.3 → indexkit-0.6.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: indexkit
-Version: 0.6.3
+Version: 0.6.4
 Summary: Offline hybrid retrieval: build a local semantic + BM25 index over your files and query it. Local RAG with ollama, turbovec, and SQLite FTS5.
 Project-URL: Homepage, https://github.com/mbeacom/context-kit
 Project-URL: Repository, https://github.com/mbeacom/context-kit
@@ -86,7 +86,7 @@ pip install ./plugins/indexkit    # or: uv tool install ./plugins/indexkit
 
 ### As a context-kit plugin
 
-Claude Code and GitHub Copilot CLI auto-bootstrap the bundled `bin/indexkit`
+Claude Code and GitHub Copilot CLI auto-bootstrap the bundled `scripts/indexkit`
 launcher from the plugin's `SessionStart` hook, into `${CLAUDE_PLUGIN_DATA}/venv`
 — for Copilot, `~/.copilot/plugin-data/<marketplace>/indexkit/venv`. In that
 mode the host controls where indexes live.
@@ -112,7 +112,7 @@ stale — bootstrap it yourself into a neutral data location:
 ```bash
 export CONTEXT_KIT_DATA="$HOME/.local/share/context-kit"
 bash scripts/bootstrap.sh
-export PATH="$PWD/bin:$PATH"
+export PATH="$PWD/scripts:$PATH"
 ```
 
 To check readiness without installing anything:

{indexkit-0.6.3 → indexkit-0.6.4}/README.md

@@ -41,7 +41,7 @@ pip install ./plugins/indexkit    # or: uv tool install ./plugins/indexkit
 
 ### As a context-kit plugin
 
-Claude Code and GitHub Copilot CLI auto-bootstrap the bundled `bin/indexkit`
+Claude Code and GitHub Copilot CLI auto-bootstrap the bundled `scripts/indexkit`
 launcher from the plugin's `SessionStart` hook, into `${CLAUDE_PLUGIN_DATA}/venv`
 — for Copilot, `~/.copilot/plugin-data/<marketplace>/indexkit/venv`. In that
 mode the host controls where indexes live.
@@ -67,7 +67,7 @@ stale — bootstrap it yourself into a neutral data location:
 ```bash
 export CONTEXT_KIT_DATA="$HOME/.local/share/context-kit"
 bash scripts/bootstrap.sh
-export PATH="$PWD/bin:$PATH"
+export PATH="$PWD/scripts:$PATH"
 ```
 
 To check readiness without installing anything:

{indexkit-0.6.3 → indexkit-0.6.4}/apm.yml

@@ -2,14 +2,14 @@
 # Lets APM users install this plugin alongside the Claude Code / GitHub Copilot
 # flows: `apm install indexkit@context-kit`. There is no `.apm/`
 # directory, so the plugin-native layout (.claude-plugin/plugin.json + skills/ +
-# bin/) stays authoritative; APM consumes it as a plugin collection.
+# scripts/) stays authoritative; APM consumes it as a plugin collection.
 # Keep name/version/description in sync with .claude-plugin/plugin.json.
 #
-# APM does not run the Claude SessionStart bootstrap hook, so the bin/indexkit venv
+# APM does not run the Claude SessionStart bootstrap hook, so the scripts/indexkit venv
 # must be bootstrapped manually (same as GitHub Copilot). Config uses the
 # CONTEXT_KIT_* env vars, not Claude userConfig. See docs/APM.md.
 name: indexkit
-version: 0.6.3
+version: 0.6.4
 description: Local-first semantic/hybrid RAG with a configurable Ollama endpoint, turbovec, SQLite FTS5/BM25, and deterministic rank fusion.
 author: Mark Beacom
 license: MIT

{indexkit-0.6.3 → indexkit-0.6.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "indexkit"
-version = "0.6.3"
+version = "0.6.4"
 description = "Offline hybrid retrieval: build a local semantic + BM25 index over your files and query it. Local RAG with ollama, turbovec, and SQLite FTS5."
 requires-python = ">=3.10"
 keywords = [

{indexkit-0.6.3/bin → indexkit-0.6.4/scripts}/indexkit

@@ -32,7 +32,7 @@ if [[ -z "$HOME_DIR" && -x "$HOME/.claude/plugins/data/indexkit/venv/bin/python"
   exec "$HOME/.claude/plugins/data/indexkit/venv/bin/python" -m indexkit "$@"
 fi
 
-# `command -v` would also match this shim if the plugin bin/ is on PATH, which
+# `command -v` would also match this shim if its directory is on PATH, which
 # would re-exec us forever. Resolve the candidate and skip our own path.
 SELF="$(cd "$(dirname "$0")" && pwd)/$(basename "$0")"
 if ON_PATH="$(command -v indexkit 2>/dev/null)" \
@@ -48,7 +48,7 @@ done
 
 echo "indexkit is not runnable: no bootstrapped venv, and no installed indexkit." >&2
 echo "Bootstrap the plugin runtime:" >&2
-echo "  bash \"$(dirname "$0")/../scripts/bootstrap.sh\"" >&2
+echo "  bash \"$(dirname "$0")/bootstrap.sh\"" >&2
 echo "or install the package directly:" >&2
 echo "  pip install indexkit" >&2
 exit 1

{indexkit-0.6.3 → indexkit-0.6.4}/skills/indexkit/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: "Requires the indexkit CLI (pip install indexkit, or auto-bootstrapped via uv in a plugin host) plus a running ollama with an embedding model pulled (default nomic-embed-text)."
 metadata:
   author: Mark Beacom
-  version: "0.3.1"
+  version: "0.3.2"
 allowed-tools: Bash(indexkit:*) Bash(ollama:*) Bash(rg:*) Bash(rtk rg:*) Read Glob Grep
 ---
 
@@ -19,19 +19,41 @@ fuses that with SQLite FTS5/BM25 for opt-in lexical search. A remote
 ## Prerequisites
 
 - `ollama serve` running and the model pulled: `ollama pull nomic-embed-text`.
-- Claude Code and GitHub Copilot CLI: the `indexkit` CLI is bootstrapped
-  automatically on session start (uv venv). If it is missing or stale, run
-  `bash "${CLAUDE_PLUGIN_ROOT}/scripts/bootstrap.sh"`.
-- APM/manual: `pip install indexkit` is enough — the launcher falls back to an
-  `indexkit` on `PATH`. To work from a clone instead, set `CONTEXT_KIT_DATA`, run
-  `plugins/indexkit/scripts/bootstrap.sh`, and add `plugins/indexkit/bin` to
-  `PATH`.
+- Claude Code and GitHub Copilot CLI: the runtime is bootstrapped automatically
+  on session start (uv venv). If it is missing or stale, run
+  `bash "${CONTEXT_KIT_INDEXKIT_ROOT:-$CLAUDE_PLUGIN_ROOT}/scripts/bootstrap.sh"`.
+- APM/manual: `pip install indexkit` is enough. To work from a clone instead,
+  set `CONTEXT_KIT_DATA` and run `plugins/indexkit/scripts/bootstrap.sh`.
+
+## Resolve the CLI
+
+The commands below are written as `indexkit`. The plugin does not put anything
+on `PATH`, so resolve the CLI once, in this order, and use the first that exists:
+
+1. `indexkit` itself, when `command -v indexkit` finds one (a `pip install`, or
+   a manual `PATH` entry).
+2. `"$CONTEXT_KIT_INDEXKIT_ROOT/scripts/indexkit"`, when that variable names the
+   installed plugin directory.
+3. `"${CLAUDE_PLUGIN_ROOT}/scripts/indexkit"` from inside this plugin on Claude
+   Code.
+4. The installed plugin's launcher, from any other plugin or host:
+   `~/.claude/plugins/cache/*/indexkit/*/scripts/indexkit` (Claude Code; pick the
+   highest version) or `~/.copilot/installed-plugins/*/indexkit/scripts/indexkit`
+   (GitHub Copilot CLI).
+
+```bash
+"${CONTEXT_KIT_INDEXKIT_ROOT:-$CLAUDE_PLUGIN_ROOT}/scripts/indexkit" status --name notes
+```
+
+The launcher prefers the bootstrapped venv, then an `indexkit` on `PATH`, then
+an importable module. Other skills that pipe into `indexkit` (the obsidian
+bridge, adr-bridge, retrieval-strategy) use this same resolution.
 
 Check readiness without installing anything — useful on APM, which does not
 deploy hooks, and after an upgrade leaves a stale venv:
 
 ```bash
-bash scripts/bootstrap.sh --check   # exit 0 ready, 3 needs bootstrap
+bash "${CONTEXT_KIT_INDEXKIT_ROOT:-$CLAUDE_PLUGIN_ROOT}/scripts/bootstrap.sh" --check   # exit 0 ready, 3 needs bootstrap
 ```
 
 It prints `status=ready|missing|stale|uv-missing` plus the venv path and the

{indexkit-0.6.3 → indexkit-0.6.4}/src/indexkit/__init__.py

@@ -1,3 +1,3 @@
 """Local semantic and hybrid RAG: ollama, turbovec, and FTS5/BM25."""
 
-__version__ = "0.6.3"
+__version__ = "0.6.4"

{indexkit-0.6.3 → indexkit-0.6.4}/uv.lock

@@ -98,7 +98,7 @@ wheels = [
 
 [[package]]
 name = "indexkit"
-version = "0.6.3"
+version = "0.6.4"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },