Jev find files
jev_find_filesFind the files that implement a behavior you describe in plain words, ranked by relevance. Use it when you do not know file names or exact identifiers and need a starting point in unfamiliar code.
Instructions
Find the files for a goal you describe in plain words, ranked; known names → your file-name search tool, known strings → your text search tool. Use for: starting a task in unfamiliar code ("where is proration computed", "what handles webhook retries") when you do not know file names or exact identifiers. Not for: known strings, regexes or symbols → your text search tool. Files by name → your file-name search tool. Questions about files you already have → jev_ask_files.
How Jev sees it: names first, then a short passage of the best candidates — never whole files. Write the goal as one behavior sentence of at least 5 words (shorter goals are capped at unsure); prefer a full sentence of behavior over a few keywords. Put identifiers you already know in keywords, where they steer the pre-filter and the passage Jev reads. Jev cannot count or grep.
goal: what you are trying to do or find, as one sentence of at least 5 words. Describe behavior, not a guessed identifier: in our tests a full sentence found the right file in 49 of 51 cases, two or three keywords alone in 16 of 21. keywords: identifiers or terms you already know that should appear in the code; [] if none. They steer the pre-filter and the passage Jev reads. scope: directories to search instead of the whole repo. An empty scope produces no judgment; a judged "none" means no supplied candidate fit, not proof about unseen files. exclude: globs to skip. Excluding tests keeps the entry point but drops the tests and docs from the list. effort: quick searches fewer candidates for a first look, default, thorough searches more (wider net, slower). max_calls: cap on Jev calls; beyond it the search stops at the best-ranked files so far and says so.
Result: the primary entry decision names the file to open with its actual probability and fresh/cache provenance; auxiliary rankings, controls and native read actions remain distinct. Unsure means two files are plausible, the answer depends on candidate order or the goal is short: read the leading candidates. A judged none means nothing supplied fit: inspect the goal or admitted scope before deciding the next action. Empty collection or missing responses are unjudged, never synthetic none probabilities. A goal under 5 content words is capped at unsure. You receive paths and scores, never file contents. Typed diagnostics name limits, omissions and useful next actions. The reading guide defines every mark once.
Use Jev for a bounded semantic judgment when its answer could change an open decision or focus the next inspection, and the relevant evidence is available. Use decisive reading, search or authorized execution directly when it settles the question. Exact lookup, counting and runtime causality belong to native tools. A Jev call is not a prerequisite for a conclusion, a review or task completion; no explanation is needed for choosing native tools.
After an unavailable, refused or out-of-scope result, continue natively within the existing permissions; do not widen sharing or confinement to obtain a judgment. For uncertainty or missing evidence, inspect or obtain the decisive piece, or leave the conclusion open. Revisit Jev only when new evidence, a material context change or a new useful question makes the judgment useful; rewording unchanged evidence is not a reason to retry. There is no retry quota for genuinely changed evidence, and no certification is needed once decisive evidence settles the question. A reached cap or an unjudged result is not evidence of safety or zero affected tests.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | ||
| root | No | ||
| scope | No | ||
| effort | No | ||
| exclude | No | ||
| keywords | No | ||
| max_calls | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |