every-cli 0.1.0__py3-none-any.whl

every_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: every-cli
+Version: 0.1.0
+Summary: Ask a yes/no question of every function in a codebase. Ranked answers in seconds, for cents.
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/sufianetaouil/every
+Project-URL: Issues, https://github.com/sufianetaouil/every/issues
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: tree-sitter>=0.25
+Requires-Dist: tree-sitter-language-pack>=1.15
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Dynamic: license-file
+
+# every
+
+**Ask a yes/no question of every function in a codebase. Ranked answers in seconds, for cents.**
+
+```
+$ every "catches an exception and then ignores it" ./my-api
+
+scanned 1,842 functions in 214 files ...   3.1s   $0.03   class: body
+
+ 0.93  src/payments/webhook.py:88     handle_stripe_event
+ 0.88  src/auth/session.py:141        refresh_token
+ 0.84  src/jobs/retry.py:22           _run_once
+ 0.79  src/db/pool.py:57              _reconnect
+ 0.52  src/utils/cache.py:19          get                (below 0.75)
+
+ 4 hits >= 0.75 out of 1,842 functions
+```
+
+`every` is grep whose pattern is a question. It is **not** embedding search: it does not
+find code *similar to* your words. It judges the question against **every function** and
+returns the probability that the answer is yes.
+
+It runs on [TypeSafe AI's Jev](https://typesafe.ai), a model that returns typed decisions
+with probabilities instead of generating text. That is what makes judging 5,000 functions
+cost about seven cents and take about fifteen seconds (measured: 1,302 functions of
+`gin-gonic/gin` in 3.7 s for $0.018).
+
+## Install
+
+```
+pip install every-cli          # installs the `every` command
+export TYPESAFE_API_KEY=...      # PowerShell: $env:TYPESAFE_API_KEY="..."
+every --selftest                # 20 labelled functions, one request; prints recall / false positives / AUROC
+```
+
+### No Jev access yet?
+
+`every` needs a Jev API key. If you don't have one, **join the hosted-tier waitlist:**
+https://github.com/sufianetaouil/every/discussions/1 — enough signups and we build the
+hosted version (no key, no setup). Meanwhile, `examples/recorded/` has real runs you can read.
+
+## What leaves your machine
+
+The source of every function in the files `every` scans is sent to TypeSafe's API
+(`api.typesafe.ai`) to be judged. Nothing else is sent. The local cache
+`.every/cache.json` stores only `sha256(question, unit text) -> score`, never source.
+Don't point `every` at code you can't send to a third party.
+
+## Usage
+
+```
+every "<question>" <path> [--above 0.75] [--top 20] [--json] [--yes] [--no-cache]
+```
+
+Questions that work well are about **one function at a time**:
+
+- "builds SQL by string concatenation"
+- "reads request data without checking authentication"
+- "returns a user record that still contains the password hash"
+- "is a test that doesn't assert anything"
+- "retries in a loop with no upper bound"
+
+`every` classifies your question first. If it needs a function's callers and callees, it
+includes them. If it needs whole-program data flow, results are marked
+`coverage: partial` — it will not pretend.
+
+`--json` (automatic when piping) prints `{"results": [...], "meta": {...}}`; `meta` has
+tokens, cost, requests and timing. Scores are cached in `.every/` so a re-run or a
+refined question only pays for what's new.
+
+## Languages
+
+Function-level: Python, JavaScript, TypeScript/TSX, Go, Java, Rust, C#, Ruby, PHP.
+Other source files (C/C++, Kotlin, Swift, Scala, shell, SQL, …) are judged as 150-line chunks.
+
+## How it works
+
+1. `tree-sitter` splits the repo into functions.
+2. Each function goes into **its own** Jev question (never a shared list — positional
+   lookup degrades past ~16 items; embedding per question is flat to 128+).
+3. ~110 questions per request, 4 requests in flight, ~$0.00001 per function
+   (~300 input tokens each, measured on `psf/requests` and `gin-gonic/gin`).
+4. Scores are ranked; anything within ±0.10 of the threshold is asked again and averaged.
+
+Measured against the bundled labelled set (`every --selftest`, 10 functions that swallow
+errors, 10 that don't, live `jev-latest` on 2026-09-16): **recall 10/10, AUROC 1.000**;
+positives scored 0.82–0.98, negatives 0.05–0.29 — except one deliberately borderline
+negative (a retry loop that discards every failure but the last) at 0.68. The default
+`--above 0.75` sits in that gap. This is 20 hand-written functions, not a benchmark; it
+shows the model separates the two sets, not how it will score your question.
+
+## Limits, honestly
+
+- One function at a time. Cross-file questions get callers/callees; whole-program
+  data flow is out of scope for v1 and is labelled partial.
+- The ranking is the reliable part; the absolute numbers move with the question. Broad
+  questions ("makes a network request") put most of an HTTP library above 0.75; narrow
+  ones put a handful. Read the top of the list and set `--above` from that.
+- No explanations. Jev returns a probability, not a sentence.
+
+MIT.

every_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+every/__init__.py,sha256=5XJNnCZ1vIAGvHgkVIbPtc4h557b4Hd4XWHqMQ16QuY,92
+every/cache.py,sha256=Y4N-pAe0Ns1eAiOf9ZQZkS-gW0igIuNBR0xaUHpLZIY,2015
+every/classify.py,sha256=0RHRqcD9wuW7YVWK_T8IUy7Ngd5hwTPM9rQKRYl0e1g,938
+every/cli.py,sha256=jZPmQPAxOX3AA45HMEB79ExfRjIxPYqI2A3FdKPt8O4,9666
+every/discover.py,sha256=hJ4y5uF1EvYIF8VntX3w-dhH_eQ-5eijqqjmPhVM6Lo,3248
+every/extract.py,sha256=HzQE6mqDjf73DkuhpPl5JRWd4_ZqWySv4csN8gHZCSE,5340
+every/judge.py,sha256=TyKQFUyGx8T4n1i2g3r_B3E_NILAhdmXBus8G28eX5U,11436
+every/neighborhood.py,sha256=46gOwvD6CNlhiBSwZVvqj3qwTaja6KuzDKOxQoMPnp4,1536
+every/report.py,sha256=9tH_KJfD6q3Wfqhn9Ly_jx5Jk_dsZEF2JJMgb0DrQdc,2263
+every/selftest.py,sha256=j2at4bsgXbZZPbuyI0mHqajDSZx0ky_R6DWAecH33mI,6196
+every/symbols.py,sha256=pxagjUu5zr3lef6NpvBDKzcvKVIzfO0iJrrK84GzxzM,3971
+every/units.py,sha256=xqndBVzrdCEWh0huoMJm3yW8QgrGtf56iB0h7DaefXM,1685
+every_cli-0.1.0.dist-info/licenses/LICENSE,sha256=1eVii3MWensCEL7qkmbSK6O3hhuKltDxuuQcuyXRVRo,1065
+every_cli-0.1.0.dist-info/METADATA,sha256=psG4MBSIAKBj_Rwlb8IR6f5yvy00_LZWVtMxwLvy7fM,5194
+every_cli-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+every_cli-0.1.0.dist-info/entry_points.txt,sha256=EWdr-huP8bnfWPw5l7lfIM2P0Q25L5g-sfPL4NQEvpY,41
+every_cli-0.1.0.dist-info/top_level.txt,sha256=znBtu6By7ozY5pN0ZQu1aMn-nWbXJb91Gu2yzAAF2UM,6
+every_cli-0.1.0.dist-info/RECORD,,

every_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

every_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+every = every.cli:main

every_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 soufiane
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

every_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+every