cocoindex-code 0.2.40__tar.gz → 0.2.42__tar.gz

{cocoindex_code-0.2.40 → cocoindex_code-0.2.42}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: cocoindex-code
-Version: 0.2.40
+Version: 0.2.42
 Summary: MCP server for indexing and querying codebases using CocoIndex
 Project-URL: Homepage, https://github.com/cocoindex-io/cocoindex-code
 Project-URL: Repository, https://github.com/cocoindex-io/cocoindex-code
@@ -141,7 +141,7 @@ For [Grok](https://github.com/xai-org/grok) users, install via Grok's plugin sys
 | Component | Purpose |
 |-----------|---------|
 | **Skill** (`skills/ccc/`) | Agent runs `ccc search` / `ccc index` via the CLI (same as Claude Code above) |
-| **Hook** (`hooks/hooks.json`) | `SessionStart` → incremental `ccc index` when `.cocoindex_code/` exists |
+| **Hook** (`hooks/hooks.json`) | `SessionStart` + `PostToolUse` (Edit/Write/…) → incremental `ccc index` when `.cocoindex_code/` exists |
 | **MCP** (`.mcp.json`) | `ccc mcp` stdio server — `search` tool with `refresh_index=true` by default |
 
 Grok does **not** import Claude's `enabledPlugins` or plugin cache; install separately even if you already use cocoindex in Claude Code.
@@ -162,7 +162,7 @@ Prefer the GitHub shorthand (`cocoindex-io/cocoindex-code`) for install — `gro
 
 Install and enable as above, then disable the optional components:
 
-1. **Hooks** — open `/hooks`, select the `SessionStart` hook from `cocoindex-code`, press `Space` to disable.
+1. **Hooks** — open `/hooks`, select the `SessionStart` / `PostToolUse` hooks from `cocoindex-code`, press `Space` to disable.
 2. **MCP** — open `/mcps`, select `cocoindex-code`, press `Space` to disable; or persist in `~/.grok/config.toml`:
 
 ```toml
@@ -182,6 +182,27 @@ mcps = false
 mcps = false
 ```
 
+#### Oh My Pi plugin
+
+[Oh My Pi](https://github.com/can1357/oh-my-pi) reads `.omp-plugin/marketplace.json` (preferred) and falls back to `.claude-plugin/marketplace.json`.
+
+```bash
+omp plugin marketplace add cocoindex-io/cocoindex-code
+omp plugin install cocoindex-code@cocoindex-code --scope project
+```
+
+Then restart the session (`/reload-plugins` does not reload extensions). Requires `ccc` on `PATH` (`uv tool install --upgrade 'cocoindex-code[full]'`).
+
+| Component | Purpose |
+|-----------|---------|
+| **Skill** (`skills/ccc/`) | Agent runs `ccc search` / `ccc index` via the CLI |
+| **Hook** (`extensions/ccc-index.ts` via `package.json#omp.extensions`) | `session_start` + post-edit `tool_result` → incremental `ccc index` when `.cocoindex_code/` exists |
+| **MCP** (`.mcp.json`) | `ccc mcp` stdio server |
+
+OMP does **not** execute Claude `hooks/hooks.json` command hooks. The TypeScript extension is the OMP equivalent of the Claude/Grok SessionStart + PostToolUse pair.
+
+Skill-only (no MCP, no auto-index): install the skill via `npx skills add cocoindex-io/cocoindex-code`, or run `ccc search` / `ccc index` from the shell.
+
 ### MCP Server
 
 Alternatively, use `ccc mcp` to run as an MCP server:
@@ -246,6 +267,23 @@ Add a local MCP server in `~/.config/kilo/kilo.jsonc`, `kilo.jsonc`, or `.kilo/k
 ```
 </details>
 
+<details>
+<summary>Oh My Pi</summary>
+
+Prefer the marketplace install above. Manual project MCP (`.omp/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "cocoindex-code": {
+      "command": "ccc",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+</details>
+
 Once configured, the agent automatically decides when semantic code search is helpful — finding code by description, exploring unfamiliar codebases, fuzzy/conceptual matches, or locating implementations without knowing exact names.
 
 > **Note:** The `cocoindex-code` command (without subcommand) still works as an MCP server for backward compatibility. It auto-creates settings from environment variables on first run.
@@ -850,6 +888,7 @@ embedding:
 | css | | `.css`, `.scss` |
 | dart | | `.dart` |
 | dtd | | `.dtd` |
+| elixir | | `.ex`, `.exs` |
 | fortran | f, f90, f95, f03 | `.f`, `.f90`, `.f95`, `.f03` |
 | go | golang | `.go` |
 | html | | `.html`, `.htm` |

{cocoindex_code-0.2.40 → cocoindex_code-0.2.42}/README.md

@@ -97,7 +97,7 @@ For [Grok](https://github.com/xai-org/grok) users, install via Grok's plugin sys
 | Component | Purpose |
 |-----------|---------|
 | **Skill** (`skills/ccc/`) | Agent runs `ccc search` / `ccc index` via the CLI (same as Claude Code above) |
-| **Hook** (`hooks/hooks.json`) | `SessionStart` → incremental `ccc index` when `.cocoindex_code/` exists |
+| **Hook** (`hooks/hooks.json`) | `SessionStart` + `PostToolUse` (Edit/Write/…) → incremental `ccc index` when `.cocoindex_code/` exists |
 | **MCP** (`.mcp.json`) | `ccc mcp` stdio server — `search` tool with `refresh_index=true` by default |
 
 Grok does **not** import Claude's `enabledPlugins` or plugin cache; install separately even if you already use cocoindex in Claude Code.
@@ -118,7 +118,7 @@ Prefer the GitHub shorthand (`cocoindex-io/cocoindex-code`) for install — `gro
 
 Install and enable as above, then disable the optional components:
 
-1. **Hooks** — open `/hooks`, select the `SessionStart` hook from `cocoindex-code`, press `Space` to disable.
+1. **Hooks** — open `/hooks`, select the `SessionStart` / `PostToolUse` hooks from `cocoindex-code`, press `Space` to disable.
 2. **MCP** — open `/mcps`, select `cocoindex-code`, press `Space` to disable; or persist in `~/.grok/config.toml`:
 
 ```toml
@@ -138,6 +138,27 @@ mcps = false
 mcps = false
 ```
 
+#### Oh My Pi plugin
+
+[Oh My Pi](https://github.com/can1357/oh-my-pi) reads `.omp-plugin/marketplace.json` (preferred) and falls back to `.claude-plugin/marketplace.json`.
+
+```bash
+omp plugin marketplace add cocoindex-io/cocoindex-code
+omp plugin install cocoindex-code@cocoindex-code --scope project
+```
+
+Then restart the session (`/reload-plugins` does not reload extensions). Requires `ccc` on `PATH` (`uv tool install --upgrade 'cocoindex-code[full]'`).
+
+| Component | Purpose |
+|-----------|---------|
+| **Skill** (`skills/ccc/`) | Agent runs `ccc search` / `ccc index` via the CLI |
+| **Hook** (`extensions/ccc-index.ts` via `package.json#omp.extensions`) | `session_start` + post-edit `tool_result` → incremental `ccc index` when `.cocoindex_code/` exists |
+| **MCP** (`.mcp.json`) | `ccc mcp` stdio server |
+
+OMP does **not** execute Claude `hooks/hooks.json` command hooks. The TypeScript extension is the OMP equivalent of the Claude/Grok SessionStart + PostToolUse pair.
+
+Skill-only (no MCP, no auto-index): install the skill via `npx skills add cocoindex-io/cocoindex-code`, or run `ccc search` / `ccc index` from the shell.
+
 ### MCP Server
 
 Alternatively, use `ccc mcp` to run as an MCP server:
@@ -202,6 +223,23 @@ Add a local MCP server in `~/.config/kilo/kilo.jsonc`, `kilo.jsonc`, or `.kilo/k
 ```
 </details>
 
+<details>
+<summary>Oh My Pi</summary>
+
+Prefer the marketplace install above. Manual project MCP (`.omp/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "cocoindex-code": {
+      "command": "ccc",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+</details>
+
 Once configured, the agent automatically decides when semantic code search is helpful — finding code by description, exploring unfamiliar codebases, fuzzy/conceptual matches, or locating implementations without knowing exact names.
 
 > **Note:** The `cocoindex-code` command (without subcommand) still works as an MCP server for backward compatibility. It auto-creates settings from environment variables on first run.
@@ -806,6 +844,7 @@ embedding:
 | css | | `.css`, `.scss` |
 | dart | | `.dart` |
 | dtd | | `.dtd` |
+| elixir | | `.ex`, `.exs` |
 | fortran | f, f90, f95, f03 | `.f`, `.f90`, `.f95`, `.f03` |
 | go | golang | `.go` |
 | html | | `.html`, `.htm` |

{cocoindex_code-0.2.40 → cocoindex_code-0.2.42}/src/cocoindex_code/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.2.40'
-__version_tuple__ = version_tuple = (0, 2, 40)
+__version__ = version = '0.2.42'
+__version_tuple__ = version_tuple = (0, 2, 42)
 
 __commit_id__ = commit_id = None

{cocoindex_code-0.2.40 → cocoindex_code-0.2.42}/src/cocoindex_code/client.py

@@ -228,6 +228,19 @@ def _handle_vanished_daemon() -> None:
     )
 
 
+def _daemon_error(resp: ErrorResponse) -> RuntimeError:
+    """Build the exception for an ``ErrorResponse`` from the daemon.
+
+    The daemon-side traceback is appended when present: without it the caller
+    only ever sees the client's own re-raise frames, which says nothing about
+    where the failure actually happened (issue #270).
+    """
+    detail = f"Daemon error: {resp.message}"
+    if resp.traceback:
+        detail += f"\n{resp.traceback}"
+    return RuntimeError(detail)
+
+
 class _HandshakeResult(NamedTuple):
     conn: Connection
     resp: HandshakeResponse
@@ -261,7 +274,7 @@ def _raw_connect_and_handshake() -> _HandshakeResult:
         raise DaemonProtocolError(f"Undecodable handshake reply from daemon: {e}") from e
     if isinstance(resp, ErrorResponse):
         conn.close()
-        raise RuntimeError(f"Daemon error: {resp.message}")
+        raise _daemon_error(resp)
     if not isinstance(resp, HandshakeResponse):
         conn.close()
         raise RuntimeError(f"Unexpected handshake response: {type(resp).__name__}")
@@ -340,7 +353,7 @@ def _send(req: Request) -> Response:
         conn.close()
     resp = decode_response(data)
     if isinstance(resp, ErrorResponse):
-        raise RuntimeError(f"Daemon error: {resp.message}")
+        raise _daemon_error(resp)
     return resp
 
 
@@ -366,7 +379,7 @@ def index(
                 raise RuntimeError("Connection to daemon lost during indexing")
             resp = decode_response(data)
             if isinstance(resp, ErrorResponse):
-                raise RuntimeError(f"Daemon error: {resp.message}")
+                raise _daemon_error(resp)
             if isinstance(resp, IndexWaitingNotice):
                 if on_waiting is not None:
                     on_waiting()
@@ -419,7 +432,7 @@ def search(
                 raise RuntimeError("Connection to daemon lost during search")
             resp = decode_response(data)
             if isinstance(resp, ErrorResponse):
-                raise RuntimeError(f"Daemon error: {resp.message}")
+                raise _daemon_error(resp)
             if isinstance(resp, IndexWaitingNotice):
                 if on_waiting is not None:
                     on_waiting()
@@ -496,10 +509,7 @@ def doctor(
                 raise RuntimeError("Connection to daemon lost during doctor checks")
             resp = decode_response(data)
             if isinstance(resp, ErrorResponse):
-                detail = f"Daemon error: {resp.message}"
-                if resp.traceback:
-                    detail += f"\n{resp.traceback}"
-                raise RuntimeError(detail)
+                raise _daemon_error(resp)
             if isinstance(resp, DoctorResponse):
                 results.append(resp.result)
                 if on_result is not None:

{cocoindex_code-0.2.40 → cocoindex_code-0.2.42}/src/cocoindex_code/daemon.py

@@ -346,7 +346,8 @@ async def _search_with_wait(
             offset=req.offset,
         )
     except Exception as e:
-        yield ErrorResponse(message=str(e))
+        logger.exception("Error handling search request")
+        yield ErrorResponse(message=str(e), traceback=traceback.format_exc())
 
 
 async def _handle_doctor(
@@ -605,7 +606,7 @@ async def _dispatch(
         return ErrorResponse(message=f"Unknown request type: {type(req).__name__}")
     except Exception as e:
         logger.exception("Error dispatching request")
-        return ErrorResponse(message=str(e))
+        return ErrorResponse(message=str(e), traceback=traceback.format_exc())
 
 
 # ---------------------------------------------------------------------------

{cocoindex_code-0.2.40 → cocoindex_code-0.2.42}/src/cocoindex_code/query.py

@@ -16,6 +16,33 @@ def _l2_to_score(distance: float) -> float:
     return 1.0 - distance * distance / 2.0
 
 
+def _checked(rows: list[tuple[Any, ...]], query_shape: str) -> list[tuple[Any, ...]]:
+    """Return *rows*, failing loudly if any of them carries a NULL distance.
+
+    ``code_chunks_vec`` is a vec0 virtual table whose ``distance`` is a *hidden*
+    column: sqlite-vec populates it only under the KNN query plan and yields
+    NULL for it on a plain full scan.  A NULL therefore means the plan we asked
+    for is not the plan we got, which is a bug worth reporting rather than a
+    result worth ranking.  Left unchecked, the NULL flows into ``_l2_to_score``
+    and surfaces as an unrelated-looking ``TypeError: unsupported operand
+    type(s) for *: 'NoneType' and 'NoneType'`` (issue #270).
+
+    Only KNN queries need this guard: ``_full_scan_query`` computes its own
+    ``vec_distance_L2(...)``, which works under any plan and raises (never
+    returns NULL) on bad input.
+    """
+    bad = next((row for row in rows if row[5] is None), None)
+    if bad is not None:
+        raise RuntimeError(
+            f"Vector index returned a row with no distance ({query_shape}, "
+            f"file_path={bad[0]!r}) — the sqlite-vec KNN query plan was not "
+            "used. Please report this at "
+            "https://github.com/cocoindex-io/cocoindex-code/issues along with "
+            "the output of `ccc doctor`."
+        )
+    return rows
+
+
 def _knn_query(
     conn: sqlite3.Connection,
     embedding_bytes: bytes,
@@ -24,24 +51,30 @@ def _knn_query(
 ) -> list[tuple[Any, ...]]:
     """Run a vec0 KNN query, optionally constrained to a language partition."""
     if language is not None:
-        return conn.execute(
+        return _checked(
+            conn.execute(
+                """
+                SELECT file_path, language, content, start_line, end_line, distance
+                FROM code_chunks_vec
+                WHERE embedding MATCH ? AND k = ? AND language = ?
+                ORDER BY distance
+                """,
+                (embedding_bytes, k, language),
+            ).fetchall(),
+            f"knn language={language!r}",
+        )
+    return _checked(
+        conn.execute(
             """
             SELECT file_path, language, content, start_line, end_line, distance
             FROM code_chunks_vec
-            WHERE embedding MATCH ? AND k = ? AND language = ?
+            WHERE embedding MATCH ? AND k = ?
             ORDER BY distance
             """,
-            (embedding_bytes, k, language),
-        ).fetchall()
-    return conn.execute(
-        """
-        SELECT file_path, language, content, start_line, end_line, distance
-        FROM code_chunks_vec
-        WHERE embedding MATCH ? AND k = ?
-        ORDER BY distance
-        """,
-        (embedding_bytes, k),
-    ).fetchall()
+            (embedding_bytes, k),
+        ).fetchall(),
+        "knn unfiltered",
+    )
 
 
 def _full_scan_query(

{cocoindex_code-0.2.40 → cocoindex_code-0.2.42}/src/cocoindex_code/settings.py

@@ -38,6 +38,8 @@ DEFAULT_INCLUDED_PATTERNS: list[str] = [
     "**/*.hh",  # C++ headers
     "**/*.cs",  # C#
     "**/*.dart",  # Dart
+    "**/*.ex",  # Elixir
+    "**/*.exs",  # Elixir scripts
     "**/*.sql",  # SQL
     "**/*.sh",  # Shell
     "**/*.bash",  # Bash