supercov 2.0.0-x86_64-linux-gnu → 3.0.0-x86_64-linux-gnu

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4505765730c33f2599ed2378eee96df3dbb08be008838476013887d77b8aba41
-  data.tar.gz: 82a4b8d71352cf2f869e8d45c988b1521e54fb9b1539d3dd2c7aeac625075494
+  metadata.gz: 36a6877c46a00019122a51fb411fc380de4d1bc5f31de0b4ee77d4ec82f18638
+  data.tar.gz: 45d37b8fa59186e2439d130d64f2489a0b587123b9793331c1391706023fa818
 SHA512:
-  metadata.gz: cf0d43adebba7b93796728a827cb140d77f9302f84d33e3d669c6cb3f1994a86f01323347b13c7132fbc9545eb480827c17a5fbea4f190aba7ccf2e991902d10
-  data.tar.gz: 3cd157299602fdbd578d4bf9ab07d9414f47cd1c51775c4dd1f0f94b0334ef2782b846f8e88dd539f2f487e0a7a766b7c398e7d684f45ba4a8fdf03b2ad66ed0
+  metadata.gz: 995712aab3244f3ee948f6a737a98cd1a6bebf965f6dbd7eb8045c68752ee6c52a35332792324aac9610e2c2c1562ac933094c0b03dd47d4039b47f3b3881c20
+  data.tar.gz: da8849a7fc5dce3756c4a24328370b2fc82f2fd00421d370a268bedd943e7bc0729d05cbf65440c0ca80f2a56f9450555bfd39fcc26260a9f1a241e30fc459a7

data/README.md

@@ -12,10 +12,12 @@ Measure code quality with npx supercov.
 
 Scoring needs a [TypeSafe AI](https://typesafe.ai) API key, and your coding agent will usually ask you for it. It costs about a cent per megabyte of source. Coverage needs no account, config file, import, custom reporter, or hosted service. Supercov is local, free, open source, and MIT licensed.
 
-[Website](https://supercov.com) · [Documentation](https://supercov.com/docs) · [npm](https://www.npmjs.com/package/supercov) · [GitHub](https://github.com/supercorp-ai/supercov)
+[Website](https://supercov.com) · [Documentation](https://supercov.com/docs) · [npm](https://www.npmjs.com/package/supercov) · [GitHub](https://github.com/supercorp-ai/supercov) · [Discord](https://discord.gg/CudcAH53yF)
 
 Supported languages: [JavaScript](https://supercov.com/docs/javascript) · [TypeScript](https://supercov.com/docs/javascript) · [Rust](https://supercov.com/docs/rust) · [Python](https://supercov.com/docs/python) · [Ruby](https://supercov.com/docs/ruby) · [Go](https://supercov.com/docs/go) · [Java](https://supercov.com/docs/java) · [Kotlin](https://supercov.com/docs/kotlin).
 
+In Claude Code, Codex and Gemini CLI you can also [install it as a plugin](#give-supercov-a-job).
+
 Supported by [Supercorp](https://supercorp.ai).
 
 [Agent workflow](https://supercov.com/docs/agent-loop): ask your coding agent
@@ -139,35 +141,57 @@ npx supercov -- python -m unittest
 npx supercov -- bundle exec rspec
 ```
 
-## Map what assertions check
+## See what the tests assert
 
-Each normal test run creates an assertion map automatically. An agent can
-optionally fill in what the assertions check:
+Coverage says which code ran; assertion coverage says which of it the tests
+would catch breaking. Supercov asks [Jev](https://typesafe.ai), test by test,
+whether changing each statement the test ran would make it fail:
 
 ```sh
-npx supercov runs latest assertions --json
-# Pin the returned run ID. Inspect assertions and the source that ran:
-npx supercov runs <run> assertion <assertion-id>
-npx supercov runs <run> source src/example.ts
-# Edit assertions.json, then validate and acknowledge:
-npx supercov runs <run> assertions validate --json
-# Copy examined expectedBasis tokens into assertions.json; save again.
-npx supercov runs <run> assertions check --require-mappings --json
-npx supercov runs <run>  # includes the assertion percentage in the regular report
+npx supercov -- npm test
+TYPESAFE_API_KEY=... npx supercov runs latest assertions assess
+npx supercov runs latest assertions   # the share asserted and what is not
 ```
 
-After code or tests change, run the same test command again. Supercov reuses the
-newest available map for that command and language and identifies dirty flows. Rust owns
-validation, change tracking and reporting; the agent supplies semantic reasoning.
-The score is agent-assessed and separate from MC/DC. See
-[assertion maps](docs/assertion-maps.md) for the format and JS/TS limits, or run
-`supercov docs assertion-agent` for the agent workflow. `supercov assertions schema`
-exports the editor schema; `assertions validate --file <path>` checks JSON syntax.
+Answers are reused across runs whenever the question is the same, so after a
+commit only what changed is asked again. Every language Supercov measures. See
+[assertion coverage](docs/assertions.md).
 
 ## Give Supercov a job
 
 Paste one of these prompts into Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, or any coding agent that can run terminal commands.
 
+Or install the agent skill, and your agent reaches for Supercov on its own when you ask for tests, coverage, refactoring or a security scan. In Claude Code:
+
+```text
+/plugin marketplace add supercorp-ai/supercov
+/plugin install supercov@supercov
+```
+
+In Codex:
+
+```bash
+codex plugin marketplace add supercorp-ai/supercov
+codex plugin add supercov@supercov
+```
+
+In Gemini CLI:
+
+```bash
+gemini extensions install https://github.com/supercorp-ai/supercov
+```
+
+For Cursor, GitHub Copilot and other agents that read skills: `npx skills add supercorp-ai/supercov`.
+
+The Claude Code plugin and the Gemini CLI extension also add four commands you can type:
+
+| Command | What it does |
+| --- | --- |
+| `/supercov:coverage [test command]` | Writes one test for code no test reaches, and reports coverage before and after |
+| `/supercov:security [patch]` | Scans the repository, or a change, for security vulnerabilities |
+| `/supercov:quality [patch]` | Ranks files by code smells, or checks what a change introduced |
+| `/supercov:review [--base ref]` | Checks a branch or uncommitted change for security and quality problems |
+
 ### Write the first useful test
 
 ```text
@@ -280,9 +304,11 @@ Supercov uses exact per-test attribution where an adapter is available. For othe
 | --- | --- |
 | Playwright | Exact per test, worker, retry, outcome, action, and assertion phase |
 | Vitest | Exact per test, with setup execution kept separate |
-| Jest | Exact per test, including parameterized tests; exact `expect` occurrence identity for assertion maps |
+| Jest | Exact per test, including parameterized tests |
 | `node:test` | Exact per test |
-| AVA and Mocha | Aggregate structural coverage |
+| Mocha | Exact per test and retry, `--parallel` included |
+| AVA | Exact per test, concurrent tests included |
+| node-tap 15 and newer | Exact per subtest |
 | Cargo's standard libtest runner | Exact test, attempt, and passing-assertion identity |
 | rustdoc doctests | Exact per doctest |
 | cargo-nextest | Exact test, attempt, retry, and binary identity |
@@ -352,6 +378,10 @@ npx supercov runs clean             # remove all runs and the build cache
 
 [MIT licensed](LICENSE). Inspect, extend, and run it anywhere.
 
+## Community
+
+Ask questions, share what you measured, and talk to the people building Supercov on [Discord](https://discord.gg/CudcAH53yF).
+
 ## Contributors
 
 - [@DaVinciTachyon](https://github.com/DaVinciTachyon)

data/lib/supercov.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: supercov
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 3.0.0
 platform: x86_64-linux-gnu
 authors:
 - Supercorp
@@ -9,7 +9,8 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: The platform-native Supercov CLI, powered by the single Rust engine.
+description: Runs the project's existing tests, measures line, branch and MC/DC coverage,
+  and points coding agents at untested code, security risks and code smells.
 email:
 - hello@supercorp.ai
 executables: