pbi-rs is the native binary. just install-release <dir> copies that same binary as pbi-rs and pbi into a caller-owned directory. It does not replace /usr/local/bin/pbi.
pbi-rs search prints compact source locations and Okapi BM25 scores; --bm25 adds source blocks from the same bounded native ranker. Both evaluate uppercase Boolean AND/OR/NOT, parentheses, and quoted phrases without a syntax flag. Ordinary keyword bags remain supported. --strict-elastic-syntax retains its additional legacy admission rules; --exact retains literal matching. Search hits are not semantic citations, and neither search mode invokes a model. The historical Probe shell wrapper is archived under archive/shell/ and is not the default command.
Bare positional questions and --message synthesize answers from verified source evidence when a discovered config selects an approved local route. Authentication requires an approved credential environment handle by default. A selected endpoint may explicitly set auth = "no_auth" to use Kit's NoAuth policy without a key, credential lookup, or Authorization header:
primary_model = "abliterated-qwen-latest-27b-none"
[[endpoints]]
model = "abliterated-qwen-latest-27b-none"
base_url = "http://localhost:18317/v1"
auth = "no_auth"Omit auth for the existing credential behavior; other explicit values fail closed. NoAuth is scoped to the selected endpoint/model pair and never inferred from a model name or hostname. Complete base/model environment overrides and explicit --model-route candidates retain authenticated behavior. PBI_RS_ADK_ENABLE=0 disables model use; without configured opt-in, the CLI emits deterministic evidence. Citations must match bounded in-root source spans, and retrieval and synthesis share one deadline. Explicit CLI candidates require PBI_RS_ADK_ENABLE=1 when no config is discovered. See the model seam for selection and acceptance limits.
pbi-rs extract <path>:<line> [--timeout <SECONDS>] [--max-bytes <N>] returns the smallest enclosing Rust item (including attributes/doc comments and nested functions), using the existing syn parser. Locations outside an item and non-Rust files return an explicitly approximate four-line neighbor window. Output carries the source span; oversized blocks say Block: truncated and end with [truncated]. The cap includes headers and is at most 32 KiB; caps too small for the header/marker fail closed.
Paths are relative to the current project root, or absolute inside that root. Parent traversal, ignored/hidden files, symlink components, non-regular files, other devices, files over 2 MiB, invalid positions and expired deadlines are refused without echoing private input. The 16-root-target ceiling applies to explicitly opened root scopes, not the contents of a selected root. Search and extraction traverse the admitted subtree under the 20,000 total-entry and 20,000-file limits, per-file byte cap and shared deadline; exceeding a traversal limit fails closed rather than silently narrowing the root. No model, Probe, shell search, new dependency, or repository write is involved.
Verified search, raw BM25, semantic candidate parsing and extraction use the existing descriptor-relative no-follow/nonblocking opens and 2 MiB bounded regular-file reader. Each operation retains its initially opened project-root directory. Source ancestors, source and .gitignore/.ignore bytes are opened through retained directory owners on that device; policy admission is checked before and after source consumption. The walk supplies candidates and budgets, not authority, and does not independently reopen ignore-policy pathnames. Hidden components remain unconditionally excluded, even when whitelisted.
Named root/ancestor/leaf equality rejects detached owners at the checks. It is not an ABA proof or an atomic filesystem snapshot: authorized files and policies may change in place, and a regular replacement inside the retained root is evaluated under its own retained owners' policies. No historical walk admission alone authorizes a read. Symlink/FIFO substitution or unsafe policy custody fails closed without source output; ordinary visible whitelist and ignore precedence remain supported.
--debug-config reports search_default=native_bounded_bm25_compact_no_probe. Probe overrides are ignored and never printed; credential values are redacted.
All Cargo commands run through just so the repository's idle-I/O and canonical SSD target rules remain active:
just fmt
just test
just build
just clippy
just gate