supercov 1.2.0-x86_64-linux-gnu → 2.0.1-x86_64-linux-gnu

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +69 -6
  3. data/lib/supercov.rb +1 -1
  4. data/libexec/supercov +0 -0
  5. metadata +2 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 969173b17a30e27f86d3017cb35022bdaee26bb9726c78157a6022510e8df070
4
- data.tar.gz: 1ccca54e811f1935491f6a88fab9a7f2f5b0c3ceccf8cb3ad87d15e54cf71997
3
+ metadata.gz: 73748b44c6d1b5b9f020a0df7acc0f51cf77d21ad9004e144f241e9656d23694
4
+ data.tar.gz: 910fe5b3111591a25c6e2addefe20c5da12d3fa75fecf13a9c650d53356ad543
5
5
  SHA512:
6
- metadata.gz: 85c57f82f1811e696fd4a5ed3e51a8031027787a7a87f7fc691471021619a0c1ff3e85e460949f1b75c2db76a54f61f4b609e8cd6f007765f5e06fec21e4fbce
7
- data.tar.gz: 4d92eda1cfae461f589787f55ebabd3d09d7d64115a8c168600c17b53692ecd4f976006388e57f374677fcba31dc91903b3f7621858caaafa2219ef302909d49
6
+ metadata.gz: 84290e10ffed3c993f0c121186f8eb3b52768dddc8e10670e6c829df46ba3b40253f251c4bbd932e05ec7f4b3e606947173b2fa4282efcacd48d08fe5166b989
7
+ data.tar.gz: 4144ede9f1489085ccff05718451a71dc92c44d50feeedb6a472311991d20b8abaad0a18cdd679f7fd8ac4339085a410068e0dc61a992db1d88e37af0e7c255e
data/README.md CHANGED
@@ -1,8 +1,8 @@
1
- ![Code quality and coverage for coding agents](https://raw.githubusercontent.com/supercorp-ai/supercov/main/supercov.jpg)
1
+ ![Coverage, security and code quality for coding agents](https://raw.githubusercontent.com/supercorp-ai/supercov/main/supercov.jpg)
2
2
 
3
- **Code quality and coverage for coding agents**
3
+ **Coverage, security and code quality for coding agents**
4
4
 
5
- **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.
5
+ **Supercov tells your coding agent what to fix and what to test.** It scores your code quality and flags security risks 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.
6
6
 
7
7
  Paste this to your coding agent to start:
8
8
 
@@ -16,6 +16,8 @@ Scoring needs a [TypeSafe AI](https://typesafe.ai) API key, and your coding agen
16
16
 
17
17
  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).
18
18
 
19
+ In Claude Code, Codex and Gemini CLI you can also [install it as a plugin](#give-supercov-a-job).
20
+
19
21
  Supported by [Supercorp](https://supercorp.ai).
20
22
 
21
23
  [Agent workflow](https://supercov.com/docs/agent-loop): ask your coding agent
@@ -56,6 +58,18 @@ Jev charges for what it reads and nothing for what it writes, so a megabyte of
56
58
  source costs a little over a cent. Answers are cached by content, so a second
57
59
  run pays only for what changed. See [Understanding quality](docs/quality.md).
58
60
 
61
+ ## Find security risks
62
+
63
+ ```bash
64
+ npx supercov security
65
+ npx supercov security patch # what a change introduced
66
+ ```
67
+
68
+ Twelve security checks asked of every file with the same key, from injection
69
+ and secrets in source to paths and redirects taken from a request. Nothing is
70
+ averaged: a file is clean, or it names what fired, with the line and the code on
71
+ it where Jev confirms one. See [Security surface](docs/security.md).
72
+
59
73
  ## Start with the suite you already have
60
74
 
61
75
  ```bash
@@ -102,6 +116,19 @@ npx supercov -- npm test
102
116
  npx supercov diff <previous-run-id> latest
103
117
  ```
104
118
 
119
+ Want to hand the evidence to a person? Generate one private, interactive file:
120
+
121
+ ```bash
122
+ npx supercov report
123
+ ```
124
+
125
+ The report opens in your browser with up to ten recent runs in a visual history.
126
+ Selecting a run compares it with the previous snapshot automatically. It has no
127
+ server, external assets, account, or file picker. It is written to
128
+ `.supercov/reports/`, where the store's own `.gitignore` keeps it out of git.
129
+ You can attach that one file directly to a pull request; a reviewer downloads
130
+ it and double-clicks it.
131
+
105
132
  Use whichever complete test command the repository already trusts:
106
133
 
107
134
  ```bash
@@ -143,6 +170,37 @@ exports the editor schema; `assertions validate --file <path>` checks JSON synta
143
170
 
144
171
  Paste one of these prompts into Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, or any coding agent that can run terminal commands.
145
172
 
173
+ 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:
174
+
175
+ ```text
176
+ /plugin marketplace add supercorp-ai/supercov
177
+ /plugin install supercov@supercov
178
+ ```
179
+
180
+ In Codex:
181
+
182
+ ```bash
183
+ codex plugin marketplace add supercorp-ai/supercov
184
+ codex plugin add supercov@supercov
185
+ ```
186
+
187
+ In Gemini CLI:
188
+
189
+ ```bash
190
+ gemini extensions install https://github.com/supercorp-ai/supercov
191
+ ```
192
+
193
+ For Cursor, GitHub Copilot and other agents that read skills: `npx skills add supercorp-ai/supercov`.
194
+
195
+ The Claude Code plugin and the Gemini CLI extension also add four commands you can type:
196
+
197
+ | Command | What it does |
198
+ | --- | --- |
199
+ | `/supercov:coverage [test command]` | Writes one test for code no test reaches, and reports coverage before and after |
200
+ | `/supercov:security [patch]` | Scans the repository, or a change, for security vulnerabilities |
201
+ | `/supercov:quality [patch]` | Ranks files by code smells, or checks what a change introduced |
202
+ | `/supercov:review [--base ref]` | Checks a branch or uncommitted change for security and quality problems |
203
+
146
204
  ### Write the first useful test
147
205
 
148
206
  ```text
@@ -286,6 +344,9 @@ npx supercov runs latest line app/checkout/session.ts:64
286
344
 
287
345
  # What changed between two runs
288
346
  npx supercov diff <previous-run-id> latest
347
+
348
+ # A portable interactive report for a person
349
+ npx supercov report
289
350
  ```
290
351
 
291
352
  Collections accept `--limit` and `--offset` and print a copyable next-page command. Machine-readable output is available with `--json` when an integration needs it.
@@ -299,9 +360,9 @@ The Supercov CLI does not contact a Supercov service during a coverage run. Pack
299
360
  Supercov does not rewrite your source files, tests, imports, reporter list, runner configuration, dependency tree, or normal build output. An existing user-created `supercov/` directory is never adopted.
300
361
 
301
362
  ```bash
302
- npx supercov clean --dry-run # preview cleanup
303
- npx supercov clean --keep 20 # keep the 20 newest runs
304
- npx supercov clean # remove all runs and the build cache
363
+ npx supercov runs clean --dry-run # preview cleanup
364
+ npx supercov runs clean --keep 20 # keep the 20 newest runs
365
+ npx supercov runs clean # remove all runs and the build cache
305
366
  ```
306
367
 
307
368
  ## Documentation
@@ -315,6 +376,7 @@ npx supercov clean # remove all runs and the build cache
315
376
  - [Supported languages and test suites](https://supercov.com/docs/supported-suites)
316
377
  - [Understanding coverage](https://supercov.com/docs/coverage-model)
317
378
  - [Runs and evidence](https://supercov.com/docs/evidence)
379
+ - [Portable HTML reports](https://supercov.com/docs/reports)
318
380
  - [Files, privacy, and cleanup](https://supercov.com/docs/workspace-isolation)
319
381
  - [Trusting a result](https://supercov.com/docs/verification)
320
382
  - [Speed and storage](https://supercov.com/docs/performance)
@@ -328,3 +390,4 @@ npx supercov clean # remove all runs and the build cache
328
390
  - [@DaVinciTachyon](https://github.com/DaVinciTachyon)
329
391
  - [@Uhbif2](https://github.com/Uhbif2)
330
392
  - [@maik-intellicoach](https://github.com/maik-intellicoach)
393
+ - [@untitaker](https://github.com/untitaker)
data/lib/supercov.rb CHANGED
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module Supercov
4
- VERSION = "1.2.0"
4
+ VERSION = "2.0.1"
5
5
  end
data/libexec/supercov CHANGED
Binary file
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: supercov
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.2.0
4
+ version: 2.0.1
5
5
  platform: x86_64-linux-gnu
6
6
  authors:
7
7
  - Supercorp
@@ -44,5 +44,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
44
44
  requirements: []
45
45
  rubygems_version: 3.6.9
46
46
  specification_version: 4
47
- summary: Code quality and coverage for coding agents
47
+ summary: Coverage, security and code quality for coding agents
48
48
  test_files: []