@agent-ix/quoin 0.17.0 → 0.20.0
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.
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/default-modules.yaml +15 -6
- package/dist/advisor/advise.d.ts +14 -1
- package/dist/advisor/advise.d.ts.map +1 -1
- package/dist/{advisor-Dhy9S7PS.js → advisor-B7X0YTVo.js} +1 -1
- package/dist/assurance/graph.d.ts +79 -0
- package/dist/assurance/graph.d.ts.map +1 -0
- package/dist/assurance/index.d.ts +9 -0
- package/dist/assurance/index.d.ts.map +1 -0
- package/dist/assurance/render.d.ts +3 -0
- package/dist/assurance/render.d.ts.map +1 -0
- package/dist/auditor/audit.d.ts +23 -2
- package/dist/auditor/audit.d.ts.map +1 -1
- package/dist/auditor/combinatorial.d.ts +53 -0
- package/dist/auditor/combinatorial.d.ts.map +1 -0
- package/dist/auditor-C9dLCmDh.js +188 -0
- package/dist/{base-D_-Jy4cE.js → base-q8brKRlC.js} +1 -1
- package/dist/cli.js +1 -1
- package/dist/combinatorial-Cq01XfhV.js +80 -0
- package/dist/commands/advise.js +35 -32
- package/dist/commands/assurance.d.ts +14 -0
- package/dist/commands/assurance.d.ts.map +1 -0
- package/dist/commands/assurance.js +179 -0
- package/dist/commands/catalog/list.js +2 -2
- package/dist/commands/catalog/methods.js +3 -3
- package/dist/commands/catalog/show.js +2 -2
- package/dist/commands/catalog/validate.js +2 -2
- package/dist/commands/completeness.d.ts +16 -0
- package/dist/commands/completeness.d.ts.map +1 -0
- package/dist/commands/completeness.js +49 -0
- package/dist/commands/config/doctor.js +1 -1
- package/dist/commands/config/edit.js +1 -1
- package/dist/commands/config/get.js +1 -1
- package/dist/commands/config/set.js +1 -1
- package/dist/commands/evidence/affirm.js +3 -3
- package/dist/commands/evidence/audit.d.ts +10 -0
- package/dist/commands/evidence/audit.d.ts.map +1 -1
- package/dist/commands/evidence/audit.js +54 -36
- package/dist/commands/evidence/baseline.js +12 -12
- package/dist/commands/evidence/gc.js +2 -2
- package/dist/commands/evidence/index.js +1 -1
- package/dist/commands/evidence/record.d.ts +2 -0
- package/dist/commands/evidence/record.d.ts.map +1 -1
- package/dist/commands/evidence/record.js +89 -32
- package/dist/commands/matrix.js +1 -1
- package/dist/commands/module/ensure-defaults.js +3 -3
- package/dist/commands/module/install.js +2 -2
- package/dist/commands/module/list.js +2 -2
- package/dist/commands/module/remove.js +2 -2
- package/dist/commands/review.js +1 -1
- package/dist/commands/to-plan.js +1 -1
- package/dist/commands/update.js +2 -2
- package/dist/commands/write.js +3 -3
- package/dist/completeness/assess.d.ts +82 -0
- package/dist/completeness/assess.d.ts.map +1 -0
- package/dist/completeness/bundle.d.ts +52 -0
- package/dist/completeness/bundle.d.ts.map +1 -0
- package/dist/completeness/declarations.d.ts +46 -0
- package/dist/completeness/declarations.d.ts.map +1 -0
- package/dist/completeness/index.d.ts +11 -0
- package/dist/completeness/index.d.ts.map +1 -0
- package/dist/completeness/run.d.ts +35 -0
- package/dist/completeness/run.d.ts.map +1 -0
- package/dist/completeness-Bic6298v.js +228 -0
- package/dist/evidence/adapters/agent-eval.d.ts +26 -0
- package/dist/evidence/adapters/agent-eval.d.ts.map +1 -0
- package/dist/evidence/adapters/audit-script.d.ts +25 -0
- package/dist/evidence/adapters/audit-script.d.ts.map +1 -0
- package/dist/evidence/adapters/cargo-mutants.d.ts +3 -0
- package/dist/evidence/adapters/cargo-mutants.d.ts.map +1 -0
- package/dist/evidence/adapters/junit.d.ts +17 -0
- package/dist/evidence/adapters/junit.d.ts.map +1 -0
- package/dist/evidence/adapters/registry.d.ts +63 -0
- package/dist/evidence/adapters/registry.d.ts.map +1 -0
- package/dist/evidence/adapters/sarif.d.ts +35 -0
- package/dist/evidence/adapters/sarif.d.ts.map +1 -0
- package/dist/evidence/adapters/sbom.d.ts +35 -0
- package/dist/evidence/adapters/sbom.d.ts.map +1 -0
- package/dist/evidence/adapters/types.d.ts +55 -0
- package/dist/evidence/adapters/types.d.ts.map +1 -0
- package/dist/evidence/index.d.ts +10 -0
- package/dist/evidence/index.d.ts.map +1 -1
- package/dist/evidence/record.d.ts.map +1 -1
- package/dist/evidence/store.d.ts +48 -2
- package/dist/evidence/store.d.ts.map +1 -1
- package/dist/evidence/types.d.ts +84 -0
- package/dist/evidence/types.d.ts.map +1 -1
- package/dist/evidence-OIkRqQrU.js +599 -0
- package/dist/{flow-command-B-ZBn9Sd.js → flow-command-k7eYqzBE.js} +1 -1
- package/dist/index.js +6 -6
- package/dist/{modules-DSkUXhHn.js → modules-E0AaYTTp.js} +2 -2
- package/dist/{plugins-DiS0OXoo.js → plugins-xe5e7dMl.js} +1 -1
- package/dist/quire/contract.d.ts +2 -2
- package/dist/quire/contract.d.ts.map +1 -1
- package/dist/quire/types.d.ts +11 -0
- package/dist/quire/types.d.ts.map +1 -1
- package/dist/{quire-D7ra5rUF.js → quire-BS-EW-0Y.js} +2 -2
- package/dist/schemas/coverage-v1.schema.json +6 -1
- package/dist/{version-DmZHxX4n.js → version-0hg-SgVf.js} +1 -1
- package/dist/{write-CPdSNIkF.js → write-Dig0zXLM.js} +1 -1
- package/package.json +2 -1
- package/skills/spec-fuzz/SKILL.md +94 -0
- package/skills/spec-fuzz/assets/templates/atheris.py.md +74 -0
- package/skills/spec-fuzz/assets/templates/cargo-fuzz.rs.md +83 -0
- package/skills/spec-fuzz/assets/templates/fast-check.ts.md +76 -0
- package/skills/spec-fuzz/references/step-0-scope-and-harness.md +51 -0
- package/skills/spec-fuzz/references/step-1-select-obligations.md +47 -0
- package/skills/spec-fuzz/references/step-2-ground-entry-point.md +55 -0
- package/skills/spec-fuzz/references/step-3-emit-targets.md +65 -0
- package/skills/spec-fuzz/references/step-4-report.md +56 -0
- package/dist/audit-CudnEJmh.js +0 -127
- package/dist/evidence-QUw0KyMH.js +0 -209
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/evidence/record.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAsC,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE/E,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wFAAwF;IACxF,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB;;;;;;OAMG;IACH,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;;OAIG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,
|
|
1
|
+
{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/evidence/record.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAsC,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE/E,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wFAAwF;IACxF,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB;;;;;;OAMG;IACH,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;;OAIG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAkG/D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,UAAU,EAAE,CAEpE"}
|
package/dist/evidence/store.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { BaselineFile, Binding, BindingsFile, RunRecord } from './types.js';
|
|
1
|
+
import { BaselineFile, Binding, BindingsFile, FindingRecord, RunRecord } from './types.js';
|
|
2
2
|
/**
|
|
3
3
|
* The store root for a repository.
|
|
4
4
|
*
|
|
@@ -19,6 +19,8 @@ export declare function bindingsPath(repo: string): string;
|
|
|
19
19
|
export declare function baselinePath(repo: string): string;
|
|
20
20
|
/** `runs/<SUITE-N>/<commit12>.json` — one file is one run of one suite. */
|
|
21
21
|
export declare function runPath(repo: string, suite: string, commit: string): string;
|
|
22
|
+
/** `scans/<SUITE-N>/<commit12>.json` — one file is one scan of one suite. */
|
|
23
|
+
export declare function scanPath(repo: string, suite: string, commit: string): string;
|
|
22
24
|
/** The 12-character commit prefix the run filenames use. */
|
|
23
25
|
export declare function short(commit: string): string;
|
|
24
26
|
/**
|
|
@@ -42,6 +44,43 @@ export declare class StoreReadError extends Error {
|
|
|
42
44
|
}
|
|
43
45
|
/** Write one run record. Last-write-wins at the same (suite, commit). */
|
|
44
46
|
export declare function writeRun(repo: string, record: RunRecord): string;
|
|
47
|
+
/**
|
|
48
|
+
* Write one finding-shaped scan. Last-write-wins at the same (suite, commit).
|
|
49
|
+
*
|
|
50
|
+
* Writing the record IS the assertion that the scan executed, so this is only
|
|
51
|
+
* ever called with an envelope an adapter actually read (FR-034).
|
|
52
|
+
*/
|
|
53
|
+
export declare function writeScan(repo: string, record: FindingRecord): string;
|
|
54
|
+
/** Read one scan record, or `null` when that (suite, commit) has none. */
|
|
55
|
+
export declare function readScan(repo: string, suite: string, commit: string): FindingRecord | null;
|
|
56
|
+
/** Every scan file recorded for a suite, in filename order (not time order). */
|
|
57
|
+
export declare function listScans(repo: string, suite: string): string[];
|
|
58
|
+
/**
|
|
59
|
+
* Every scan recorded for a suite, oldest first by `timestamp`.
|
|
60
|
+
*
|
|
61
|
+
* Ordered exactly as `readRuns` is, and for the same reason: a filename is a
|
|
62
|
+
* commit prefix, which is uniformly random hex, so lexical order is not time
|
|
63
|
+
* order. agent-ix/quoin#104 fixed that once for runs; reintroducing it here
|
|
64
|
+
* would rebuild the same defect beside the fix.
|
|
65
|
+
*/
|
|
66
|
+
export declare function readScans(repo: string, suite: string, skipped?: string[]): FindingRecord[];
|
|
67
|
+
/** The newest scan of a suite by timestamp, or `null` when it has none. */
|
|
68
|
+
export declare function latestScan(repo: string, suite: string, skipped?: string[]): FindingRecord | null;
|
|
69
|
+
/**
|
|
70
|
+
* Whether a scan proves nothing — the finding-shaped meaning of vacuity.
|
|
71
|
+
*
|
|
72
|
+
* **Not "found nothing".** A scan that ran every rule and reported no finding
|
|
73
|
+
* is a clean result and is exactly the evidence this record type exists to
|
|
74
|
+
* preserve. What proves nothing is a scan that **evaluated no rules**: it also
|
|
75
|
+
* reports zero findings, and from the findings list alone the two are
|
|
76
|
+
* identical.
|
|
77
|
+
*
|
|
78
|
+
* Returns `null` when the tool did not say how many rules it evaluated. The
|
|
79
|
+
* question cannot be asked, so the auditor says nothing rather than something
|
|
80
|
+
* wrong — the same posture `evidenceKind` takes for method conformance
|
|
81
|
+
* (agent-ix/quoin#105).
|
|
82
|
+
*/
|
|
83
|
+
export declare function scanIsVacuous(record: FindingRecord): boolean | null;
|
|
45
84
|
/** Read one run record, or `null` when that (suite, commit) has none. */
|
|
46
85
|
export declare function readRun(repo: string, suite: string, commit: string): RunRecord | null;
|
|
47
86
|
/**
|
|
@@ -90,7 +129,14 @@ export declare function readBindings(repo: string): BindingsFile;
|
|
|
90
129
|
* serialize the same binding set in different orders and produce a diff nobody
|
|
91
130
|
* made.
|
|
92
131
|
*/
|
|
93
|
-
|
|
132
|
+
/**
|
|
133
|
+
* `Pick<…, "bindings">` and not `BindingsFile`: the version written is always
|
|
134
|
+
* `STORE_SCHEMA_VERSION`, and `file.schemaVersion` was never read. Demanding it
|
|
135
|
+
* made callers supply a value the function discards — which one command did not,
|
|
136
|
+
* and the resulting type error stayed latent until an unrelated entry widened
|
|
137
|
+
* the build graph enough for `tsc` to reach the call site.
|
|
138
|
+
*/
|
|
139
|
+
export declare function writeBindings(repo: string, file: Pick<BindingsFile, "bindings">): void;
|
|
94
140
|
/** The ratchet baseline, or `null` when none has been accepted. */
|
|
95
141
|
export declare function readBaseline(repo: string): BaselineFile | null;
|
|
96
142
|
export declare function writeBaseline(repo: string, file: BaselineFile): void;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/evidence/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,OAAO,
|
|
1
|
+
{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/evidence/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,4DAA4D;AAC5D,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAiBD;;;;;;;GAOG;AACH,qBAAa,cAAe,SAAQ,KAAK;IAErC,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO;gBADd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO;CAU1B;AAgCD,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,CAIhE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAIrE;AAED,0EAA0E;AAC1E,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,aAAa,GAAG,IAAI,CAEtB;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAM/D;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAM,EAAO,GACrB,aAAa,EAAE,CAajB;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAM,EAAO,GACrB,aAAa,GAAG,IAAI,CAEtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,GAAG,IAAI,CAGnE;AAED,yEAAyE;AACzE,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,SAAS,GAAG,IAAI,CAElB;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAM9D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAM,EAAO,GACrB,SAAS,EAAE,CAab;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAM,EAAO,GACrB,SAAS,GAAG,IAAI,CAElB;AAOD,sDAAsD;AACtD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAczD;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAOvD;AAED;;;;;;;;;GASG;AACH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,GACnC,IAAI,CAMN;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAE9D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAMpE;AAED;;;;;;;GAOG;AACH,wBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,MAAM,EAAE,CAwCzD;AAUD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,IAAI,CAClB,QAAQ,EAAE,OAAO,EAAE,EACnB,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,GAClC;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAwB7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CACpB,QAAQ,EAAE,OAAO,EAAE,EACnB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAkBzC"}
|
package/dist/evidence/types.d.ts
CHANGED
|
@@ -24,6 +24,13 @@
|
|
|
24
24
|
*/
|
|
25
25
|
/** Where a suite's run records live, relative to the store root. */
|
|
26
26
|
export declare const RUNS_DIR = "runs";
|
|
27
|
+
/**
|
|
28
|
+
* Where a suite's finding-shaped scan records live, relative to the store root.
|
|
29
|
+
*
|
|
30
|
+
* Separate from `runs/` because the two answer different questions and a reader
|
|
31
|
+
* must not have to open a file to learn which kind it is.
|
|
32
|
+
*/
|
|
33
|
+
export declare const SCANS_DIR = "scans";
|
|
27
34
|
/** Schema version carried by every machine-written file in the store. */
|
|
28
35
|
export declare const STORE_SCHEMA_VERSION = 1;
|
|
29
36
|
/**
|
|
@@ -45,6 +52,14 @@ export interface RunEntry {
|
|
|
45
52
|
score?: number;
|
|
46
53
|
/** Trace ids this symbol carries, as the adapter read them. */
|
|
47
54
|
traceIds?: string[];
|
|
55
|
+
/**
|
|
56
|
+
* The configuration this entry was executed under — dimension name to value.
|
|
57
|
+
*
|
|
58
|
+
* Present only for a run over a declared configuration space (quire-rs
|
|
59
|
+
* FR-061). It is what lets the auditor say WHICH t-way combinations a run
|
|
60
|
+
* reached, rather than only how many entries it contained.
|
|
61
|
+
*/
|
|
62
|
+
config?: Record<string, string>;
|
|
48
63
|
}
|
|
49
64
|
/**
|
|
50
65
|
* One run of ONE suite at ONE commit.
|
|
@@ -84,6 +99,75 @@ export interface RunRecord {
|
|
|
84
99
|
timestamp: string;
|
|
85
100
|
entries: RunEntry[];
|
|
86
101
|
}
|
|
102
|
+
/**
|
|
103
|
+
* One finding a scanner reported.
|
|
104
|
+
*
|
|
105
|
+
* `ruleId` is the join, and it is the reason this record type is worth
|
|
106
|
+
* building: a scanner rule id ⇄ obligation id is a **verification method**
|
|
107
|
+
* discharging a specific obligation, not a generic scan whose output someone
|
|
108
|
+
* reads. The catalog already carries the method (spec-artifacts-process
|
|
109
|
+
* FR-007); this is what discharges it.
|
|
110
|
+
*/
|
|
111
|
+
export interface Finding {
|
|
112
|
+
/** The scanner's rule identifier — `RUSTSEC-2026-0190`, a semgrep rule id. */
|
|
113
|
+
ruleId: string;
|
|
114
|
+
/**
|
|
115
|
+
* The scanner's own severity string, verbatim.
|
|
116
|
+
*
|
|
117
|
+
* NOT normalized to a quoin vocabulary. Scanners disagree about what
|
|
118
|
+
* "high" means and quoin judges nothing (FR-034-CON-2); translating here
|
|
119
|
+
* would invent a comparison the tools never made.
|
|
120
|
+
*/
|
|
121
|
+
severity?: string;
|
|
122
|
+
message?: string;
|
|
123
|
+
/** Repo-relative path the finding is about, when the tool names one. */
|
|
124
|
+
path?: string;
|
|
125
|
+
line?: number;
|
|
126
|
+
/** Obligation ids this rule discharges, as the adapter read them. */
|
|
127
|
+
traceIds?: string[];
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* One finding-shaped scan of ONE suite at ONE commit.
|
|
131
|
+
*
|
|
132
|
+
* **Why this is not a `RunRecord`.** Five of the eight formats quoin means to
|
|
133
|
+
* read emit *findings*, not run outcomes: no symbol, no pass/fail. Forced into
|
|
134
|
+
* `RunEntry`, a clean semgrep run and a semgrep run that never executed are
|
|
135
|
+
* indistinguishable — both have zero failing entries. An evidence store whose
|
|
136
|
+
* whole purpose is telling "verified" from "looks verified" cannot carry that
|
|
137
|
+
* ambiguity; it would be the green-matrix-over-dead-links defect reproduced
|
|
138
|
+
* inside the store built to prevent it.
|
|
139
|
+
*
|
|
140
|
+
* **The distinction lives on the record, not in the findings.** The record's
|
|
141
|
+
* existence IS the proof the scan executed — written only when an adapter read
|
|
142
|
+
* a real report envelope. `findings: []` on a present record means *ran and
|
|
143
|
+
* found nothing*, which is evidence. No record at all means *did not run*,
|
|
144
|
+
* which is not. Real tool output already works this way: `cargo audit --json`
|
|
145
|
+
* emits `vulnerabilities.found: false` beside the `database` and `lockfile` it
|
|
146
|
+
* consulted, and a SARIF `run` with an empty `results` array is still a run.
|
|
147
|
+
*/
|
|
148
|
+
export interface FindingRecord {
|
|
149
|
+
schemaVersion: number;
|
|
150
|
+
suite: string;
|
|
151
|
+
/** Full commit sha the scan was performed at. */
|
|
152
|
+
commit: string;
|
|
153
|
+
/** Tool and version, as the adapter reported them. */
|
|
154
|
+
tool: string;
|
|
155
|
+
evidenceKind?: string;
|
|
156
|
+
/** ISO-8601, supplied by the caller — never read from the clock here. */
|
|
157
|
+
timestamp: string;
|
|
158
|
+
/**
|
|
159
|
+
* What the scan covered, as the tool reported it: a ruleset name, a policy
|
|
160
|
+
* file, an advisory-database revision.
|
|
161
|
+
*
|
|
162
|
+
* Load-bearing for vacuity. A scan that ran with **no rules enabled** also
|
|
163
|
+
* reports zero findings, and is as empty as one that never ran — but it
|
|
164
|
+
* cannot be told apart by the findings list alone.
|
|
165
|
+
*/
|
|
166
|
+
ruleset?: string;
|
|
167
|
+
/** Number of rules the scan actually evaluated, when the tool reports it. */
|
|
168
|
+
rulesEvaluated?: number;
|
|
169
|
+
findings: Finding[];
|
|
170
|
+
}
|
|
87
171
|
/** Someone re-affirming a binding after the statement it was made against changed. */
|
|
88
172
|
export interface Affirmation {
|
|
89
173
|
who: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/evidence/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,oEAAoE;AACpE,eAAO,MAAM,QAAQ,SAAS,CAAC;AAE/B,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACvB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC5C;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/evidence/types.ts"],"names":[],"mappings":"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"}
|