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.
- checksums.yaml +4 -4
- data/README.md +69 -6
- data/lib/supercov.rb +1 -1
- data/libexec/supercov +0 -0
- metadata +2 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 73748b44c6d1b5b9f020a0df7acc0f51cf77d21ad9004e144f241e9656d23694
|
|
4
|
+
data.tar.gz: 910fe5b3111591a25c6e2addefe20c5da12d3fa75fecf13a9c650d53356ad543
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 84290e10ffed3c993f0c121186f8eb3b52768dddc8e10670e6c829df46ba3b40253f251c4bbd932e05ec7f4b3e606947173b2fa4282efcacd48d08fe5166b989
|
|
7
|
+
data.tar.gz: 4144ede9f1489085ccff05718451a71dc92c44d50feeedb6a472311991d20b8abaad0a18cdd679f7fd8ac4339085a410068e0dc61a992db1d88e37af0e7c255e
|
data/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-

|
|
2
2
|
|
|
3
|
-
**
|
|
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
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:
|
|
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:
|
|
47
|
+
summary: Coverage, security and code quality for coding agents
|
|
48
48
|
test_files: []
|