supercov 0.0.54-aarch64-linux-gnu → 1.0.0-aarch64-linux-gnu

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 495f92e5c78333324486aeaf7004be6c032271ce1e643a14c66e29b353d5edf8
-  data.tar.gz: f47509b7ab94ed40ffd1dbdfa5828d8a9688e028cf95f83c2bd6784dac47b03e
+  metadata.gz: 781ec55332b0f231df865ebd11ad0db35b009b638b4fe4a812e9fa17da05cf13
+  data.tar.gz: 22896fd9e7ab4021d1a4df704ad0d4c63e135b9132d0c10f2dbaa618a224ed55
 SHA512:
-  metadata.gz: b378ceb3335890c435bcad3c0ad31e3f7dbf2caaa5fc1b2a884f0e50d8ccd9e91c04165a66c4dcd6918f2ae7d45be69378c320f08213480e7c92ae4b831cc4f0
-  data.tar.gz: 65ac4b89a53f52c04f0b5a6ad9632ae73f3e97c1f1a65d8df75f04e67f8fd1b12d0764659e74475eee49aa657db929c15790e229e578c9f491a3eea13387260c
+  metadata.gz: 037fd6d20632905b88c3e868fcb27c1a94078cf343cc8697a4dd33b3577d05795e207db86e229f5787e6ad01c83a93850ddf734df3d6a67a539e6b8ff95a0bf5
+  data.tar.gz: f9f6f88fe7d4cb05dc5964c71917a56b109bce6372c0543c817369661a506cb1fab6a04836b4632d4741d095ef23c8ebdc854fa8f79ca14b05632d9c5809d603

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: aarch64-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: []