@zvec/zvec-grep 0.1.6 → 0.1.7

package/skills/zvec-grep/SKILL.md

@@ -1,61 +0,0 @@
----
-name: zvec-grep
-description: Repository code search and indexing with zvec-grep. Use when exploring a codebase, locating symbols, references, or exact text, creating or inspecting a repository index, diagnosing the daemon, or whenever repository investigation would otherwise use grep, rg, or broad file reads.
----
-
-# zvec-grep
-
-## Select the transport
-
-Use zvec-grep indexed search for conceptual repository investigation. Use native
-`grep` or `rg` for exact lexical searches unless the optional managed-rg MCP tool
-is explicitly available.
-
-Use the public native HTTP MCP search tools as the primary interface when the matching `zvec_grep_*` tool is present. Call them directly; do not run `zg`, probe the daemon through shell, or choose CLI for convenience.
-
-Use CLI fallback only when one of these conditions is true:
-
-- The task requires index lifecycle or daemon diagnostics, which are intentionally
-  kept out of the default agent MCP toolset.
-- An available MCP search tool cannot perform the required operation.
-- MCP initialization, authentication, connection, or the required search call has
-  failed.
-- The repository has no index, the user has not authorized indexing, and an explicit no-index lexical search is needed.
-
-Do not retry a submitted indexing write through another transport after a connection interruption.
-
-## Use the MCP workflow
-
-Pass the repository's daemon-visible absolute path as `root` on every repository call.
-
-1. Use native `grep` or `rg` when an exact keyword, text, symbol, filename,
-   path, configuration key, error message, source fragment, literal, or regex
-   anchor is known and locating it is sufficient to answer the question.
-2. Call `zvec_grep_search` when the answer requires conceptual discovery,
-   architecture, lifecycle, data or control flow, comparison, design rationale,
-   or performance analysis. Search defaults to `freshness: "eventual"`; use
-   `freshness: "wait_for_fresh"` only when the result must include all pending
-   changes. Use hybrid `queries` for concepts plus known lexical constraints,
-   `fts` for indexed lexical-only intent, and `vector` for semantic-only intent.
-3. When exact symbols are present but the answer spans multiple components,
-   files, stages, or implementations, call `zvec_grep_search` first with the
-   concept and known symbols, then use native `grep` or `rg` for focused follow-up.
-4. Read the indexed search response's `freshness` and `indexing` fields. Use
-   `possibly_stale` results immediately when they are sufficient; do not call
-   status merely because a background update is active.
-5. Apply focused path and file-type filters early. Exclude dependencies,
-   generated output, caches, build artifacts, fixtures, and logs unless the
-   task concerns them.
-
-The default public MCP endpoint intentionally exposes only indexed search. If the
-index is missing, explain that indexed search requires an index and ask before
-creating one. After authorization, use the CLI lifecycle workflow; never silently
-create, rebuild, or drop an index. The optional full MCP toolset exposes
-`zvec_grep_rg`; the CLI `zg query --rg` route remains available for explicit
-managed-ripgrep fallback.
-
-Use multiple queries when comparing related concepts.
-
-## Use CLI fallback
-
-Read [references/cli-fallback.md](references/cli-fallback.md) only after a fallback condition above is satisfied. Leave CLI mode unset for status, fallback search, and authorized indexing commands so the default Auto mode can select Server or Direct; do not probe forced Server mode and then retry forced Direct mode. Keep the selected transport consistent for the investigation unless its availability changes.

package/skills/zvec-grep/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "zvec-grep"
-  short_description: "Repository search with explicit index lifecycle"
-  default_prompt: "Use $zvec-grep to investigate this repository before raw grep or rg. Prefer the public MCP search tools, and use the zg CLI only for authorized index lifecycle or daemon diagnostics."

package/skills/zvec-grep/references/cli-fallback.md

@@ -1,85 +0,0 @@
-# CLI fallback
-
-Use these commands only when the native MCP tools are unavailable or when an explicit no-index lexical search is required.
-
-## Choose the route
-
-Leave `--mode` unset for ordinary status and query commands. The default Auto mode uses the daemon when reachable and Direct mode otherwise:
-
-```bash
-zg status
-zg query "authentication flow" --fts "AuthService" -g "src/**" -g "!tests/**" -g "!dist/**"
-```
-
-Do not probe with `--mode server` and then retry with `--mode direct`. Use an explicit mode only when diagnosing routing or when the user requests one. Do not force Direct writes while a daemon lease is active.
-
-## Check index state
-
-Check status once per repository investigation and reuse it:
-
-```bash
-zg status
-```
-
-If the index is missing, do not build it automatically. Mention `zg index` and wait for the user to authorize persistent indexing.
-
-## Search an existing index
-
-Start with indexed hybrid search, then add exact or semantic routes as needed:
-
-```bash
-zg query "request validation" "error handling" -g "src/**" -g "!tests/**" -g "!dist/**" --limit 10 --preview short
-zg query "authentication flow" --fts "AuthService" --fts "ForbiddenError" -g "src/**"
-zg query --vector "where incoming requests are authorized" -g "src/**"
-zg query "changes that must be indexed before search" --refresh wait
-```
-
-When Auto selects Server, queries return the current index and refresh stale data in the background by default. Direct queries do not refresh by default. Add `--refresh wait` when the query must wait for pending index changes, or `--refresh off` to disable refresh explicitly. Use `--preview none` for broad candidate scans, `--preview short` for a small deterministic window, and `--preview full` only after narrowing.
-
-## Recover from a Direct model failure
-
-Direct mode already attempts CPU fallback when local GPU initialization fails. Do not repeat the query with an explicit CPU override.
-
-If the local model or embedding context remains unavailable and exact anchors are available, remove positional hybrid and vector queries and search those anchors through the existing indexed FTS route. Indexed FTS does not require an embedding model:
-
-```bash
-zg query --fts "AuthService" --fts "ForbiddenError" -g "src/**" --limit 20 --preview short
-```
-
-Do not switch to managed ripgrep merely because semantic search is unavailable. Use it only when the task requires exhaustive literal or regex matching, or when no index exists and the user has not authorized creating one.
-
-## Search exhaustively with managed ripgrep
-
-Use managed ripgrep only for exhaustive literal or regex matching; it does not require an index:
-
-```bash
-zg query --rg "SymbolName|LogMessage"
-zg query --rg -F "ExactSymbolOrText" src
-zg query --rg -i -C 2 -g "*.ts" -g "!dist/**" "needle text" src
-```
-
-Managed ripgrep always runs locally. It remains available while the daemon is running or an index writer is active; do not stop the daemon or switch client mode before using it.
-
-Use `-e` or `--regexp` when the pattern begins with `-`. Common ripgrep flags include `-n`, `-H`, `-F`, `-i`, `-w`, `-A`, `-B`, `-C`, `-g`, `--hidden`, `--type`, `--type-not`, `--no-ignore`, `--smart-case`, and `--pcre2`.
-
-## Index only with authorization
-
-When a server default model is known, let Auto submit the index without repeating the model:
-
-```bash
-zg index
-```
-
-Otherwise, use the embedding model selected by the user:
-
-```bash
-zg index --embedding local/embeddinggemma-300m
-```
-
-Use focused path filters for a new index:
-
-```bash
-zg index --embedding local/embeddinggemma-300m -g "src/**" -g "docs/**" -g "test/**" -g "!dist/**" -g "!node_modules/**" -g "!coverage/**"
-```
-
-Rebuild only when an incompatible embedding schema or index version requires it. Existing indexes reuse their stored embedding schema unless the user intentionally changes it.