supercov 0.0.54-x86_64-linux-gnu → 1.0.0-x86_64-linux-gnu

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 81deedfe9090d8dd1df07aae2b4fe5ed6bd67334ada587cd68135fc6176386ad
-  data.tar.gz: 863c34aa7ec83432bd5a00cc0216ae14741a0178690256c2af982d333620c91e
+  metadata.gz: f640ef823273344b4a027529d43f1f03282648ac0e360ee2a75252fd74ee3350
+  data.tar.gz: 59698f655f6bff745a988e5d3ad9732eb7aa33994b62dcc1593546c1b9012601
 SHA512:
-  metadata.gz: 4cdac62dce21ddfc297a692c0c0ea43c42a9583f75c8c5dd6df9108d2a15dc1ff269b31209f08d23640ca9248f634df80e2f7c53de10aa7288148cf2c990bdc7
-  data.tar.gz: 1d67226b02bd1fcd0435f28c944c1501bd10c7171af2919e0c5a6354395052dc566228bca66e33b915f38a0b4e3bb3e2ad67e65d0790fb50ee676b7b73f68bfc
+  metadata.gz: ed5be167a40605598c81183e9739524daef6f37ab0c182f63e99bd149736e16b7e00e319adb541aaf15031d2a521d483e0f6dfd16b19050218f0acc5731f37a2
+  data.tar.gz: 80efabb80c5312f0ccf25439800e88e7b97bac29a3df22cf9c089ec39450f8a55ec8bb8740c1dc57d70b9868c94c8e6578d635518340f6d773912ee3eba86391

data/README.md

@@ -1,10 +1,10 @@
-![Coverage for coding agents and software factories 🌙](https://raw.githubusercontent.com/supercorp-ai/supercov/main/supercov.jpg)
+![Code quality and coverage for coding agents](https://raw.githubusercontent.com/supercorp-ai/supercov/main/supercov.jpg)
 
-**Coverage for coding agents and software factories 🌙**
+**Code quality and coverage for coding agents**
 
-**Supercov gives your coding agent the next useful test to write.** It runs the test command you already use, records local coverage evidence, and turns uncovered paths into small, actionable queries. Your agent writes a focused test, reruns the suite, proves what improved, and keeps going while useful gaps remain.
+**Supercov tells your coding agent what to fix and what to test.** It scores your code quality with [Jev](https://typesafe.ai), runs the test command you already use, and turns uncovered paths into small, actionable queries. Your agent picks a target, writes a focused test or a focused refactor, proves what improved, and keeps going.
 
-No account, config file, import, custom reporter, or hosted service is required. Supercov is local, free, open source, and MIT licensed.
+Coverage needs no account, config file, import, custom reporter, or hosted service. Supercov is local, free, open source, and MIT licensed. Quality uses [Jev](https://typesafe.ai) and needs a key.
 
 [Website](https://supercov.com) · [Documentation](https://supercov.com/docs) · [npm](https://www.npmjs.com/package/supercov) · [GitHub](https://github.com/supercorp-ai/supercov)
 
@@ -13,6 +13,41 @@ Supported by [Supercorp](https://supercorp.ai).
 [Agent workflow](https://supercov.com/docs/agent-loop): ask your coding agent
 to add a test in your own project, with a recorded example to follow along.
 
+## Score your code
+
+```bash
+export TYPESAFE_API_KEY=...   # get one at https://typesafe.ai
+npx supercov quality
+```
+
+No arguments and no configuration. It finds your source, asks Jev a set of
+yes/no questions about each file, and does the arithmetic itself, so every part
+of a score is a claim you can check against the file.
+
+```
+Quality weak (3.8/10) over 163 files.
+  11 good, 52 fair, 100 weak.
+
+Weakest:
+  weak  runtime/python/supercov_runtime.py
+        long_method 0.96, deep_nesting 0.92, complex_conditional 0.89, +9 more
+  weak  crates/supercov-engine/src/assertion_store.rs
+        long_method 0.96, deep_nesting 0.91, complex_conditional 0.86, +8 more
+```
+
+Narrow to what fired, read one file in full, or review a change:
+
+```bash
+npx supercov quality gaps
+npx supercov quality file src/server.ts
+npx supercov quality patch                    # your uncommitted work, or your branch
+npx supercov quality patch --annotate github  # workflow annotations, no token
+```
+
+Jev charges for what it reads and nothing for what it writes, so a megabyte of
+source costs a little over a cent. Answers are cached by content, so a second
+run pays only for what changed. See [Understanding quality](docs/quality.md).
+
 ## Start with the suite you already have
 
 ```bash
@@ -25,12 +60,33 @@ github.com/supercorp-ai/supercov/cmd/supercov@latest`.
 
 Everything after `--` is your test command. Supercov runs it without changing your source, tests, runner configuration, or normal build output.
 
-Then ask what is still uncovered:
+Then read the result and ask what is still uncovered:
+
+```bash
+npx supercov runs latest
+```
+
+```
+run run_7fc676ba671d42be
+command: npm test
+
+Coverage
+  Lines      100.00% (5/5)
+  Branches   66.67% (4/6)
+  MC/DC      33.33% (1/3)
+```
 
 ```bash
 npx supercov runs latest gaps --limit 10
 ```
 
+```
+Coverage gaps — only files with unresolved obligations
+
+src/pricing.js
+  uncovered: lines 0  statements 1  functions 0  branch outcomes 0  MC/DC conditions 2
+```
+
 After your agent adds a test, rerun the complete suite and prove the gain:
 
 ```bash
@@ -243,6 +299,7 @@ npx supercov clean             # remove all runs and the build cache
 ## Documentation
 
 - [Getting started](https://supercov.com/docs/getting-started)
+- [Understanding quality](https://supercov.com/docs/quality)
 - [Agent workflow](https://supercov.com/docs/agent-loop)
 - [Understanding assertions](docs/assertions.md)
 - [Troubleshooting](https://supercov.com/docs/troubleshooting)

data/lib/supercov.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Supercov
-  VERSION = "0.0.54"
+  VERSION = "1.0.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: supercov
 version: !ruby/object:Gem::Version
-  version: 0.0.54
+  version: 1.0.0
 platform: x86_64-linux-gnu
 authors:
 - Supercorp
@@ -44,5 +44,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: "Coverage for coding agents and software factories \U0001F319"
+summary: Code quality and coverage for coding agents
 test_files: []