From 9618ab060abbd996656e6c330e9823764c79aa82 Mon Sep 17 00:00:00 2001 From: Luis Betancourt <225334064+LueBangs-coder@users.noreply.github.com> Date: Sun, 14 Jun 2026 14:22:58 -0400 Subject: [PATCH] docs: add Scope & limitations and clarify license ownership Adds a "Scope & limitations" section stating plainly that `nemesis eval` exercises all 20 detectors on synthetic known-truth runs, while `nemesis check` currently fires the subset observable from read-only git state plus provided run context. This keeps the public claim matched to reality. Expands the License section: MIT, copyright retained by the author, free for the community (including commercial use) provided the notice is kept. Co-Authored-By: Claude Opus 4.8 --- README.md | 30 +++++++++++++++++++++++++++++- 1 file changed, 29 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 870ae94..6f572ad 100644 --- a/README.md +++ b/README.md @@ -181,6 +181,29 @@ or set it (e.g. `"0.2.0"`) to install that release from PyPI. --- +## Scope & limitations + +Nemesis has two surfaces, and they cover different ground today: + +- **`nemesis eval`** exercises **all 20 detectors** against *synthetic* + known-truth runs — a closed test bed where each failure is injected on + purpose. This is how the detectors are validated (true-positive and + false-positive rates), and why every detector scores well there. +- **`nemesis check`** runs against a **real** repository, but it can only act + on signals that are observable from read-only git state — worktree + cleanliness, branch, HEAD, upstream parity — plus the run context you pass in + (`--claimed-success`, `--tests-passing`, `--transcript`). Today that means a + **subset** of the catalog fires on real repos (for example + `agent_declared_success_too_early` and `dirty_worktree_after_closeout`); the + remaining detectors depend on richer run context that the collector does not + yet derive. + +In short: the catalog and the synthetic eval are complete; broadening what +`nemesis check` can observe on real repositories is active, ongoing work. This +project does not over-claim what it verifies — that honesty is the point. + +--- + ## Part of something larger Nemesis is one guardian in a growing **pantheon** — a body of harnesses built to keep AI systems honest, bounded, and safe. Each guardian owns one part of the problem: @@ -225,7 +248,12 @@ Founder & Operator, Onslaught Gaming LLC · U.S. Army veteran (Armored Crewman) ## License -MIT. See [`LICENSE`](./LICENSE). +Released under the **MIT License** — see [`LICENSE`](./LICENSE). + +Copyright © 2026 Luis A. Betancourt. You're free to use, modify, and +distribute Nemesis — including commercially — at no cost, for the community. +The only condition is keeping the copyright and license notice. Ownership of +the work stays with the author; the freedom to use it is yours. ---