@agent-ix/quoin 0.17.0 → 0.19.2
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-a9axb4Jl.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-W2jFinr6.js +188 -0
- package/dist/{base-D_-Jy4cE.js → base-BE20w0jY.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-BeqcskAI.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/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-FRF9RN77.js +595 -0
- package/dist/{flow-command-B-ZBn9Sd.js → flow-command-BrzzKBo9.js} +1 -1
- package/dist/index.js +6 -6
- package/dist/{modules-DSkUXhHn.js → modules-_FQTZ3gx.js} +2 -2
- package/dist/{plugins-DiS0OXoo.js → plugins-Q1MtCIE5.js} +1 -1
- package/dist/quire/contract.d.ts +1 -1
- package/dist/quire/contract.d.ts.map +1 -1
- package/dist/{quire-D7ra5rUF.js → quire-Dis3ky5t.js} +1 -1
- package/dist/{version-DmZHxX4n.js → version-D0l3nDPZ.js} +1 -1
- package/dist/{write-CPdSNIkF.js → write-CMA6BDUq.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,72 +1,81 @@
|
|
|
1
|
-
import { i as e, n as t, o as n, t as r } from "../../quire-
|
|
2
|
-
import { t as i } from "../../base-
|
|
3
|
-
import { t as a } from "../../advisor-
|
|
4
|
-
import {
|
|
5
|
-
import { r as
|
|
6
|
-
import { Flags as
|
|
7
|
-
import { execFileSync as
|
|
1
|
+
import { i as e, n as t, o as n, t as r } from "../../quire-Dis3ky5t.js";
|
|
2
|
+
import { t as i } from "../../base-BE20w0jY.js";
|
|
3
|
+
import { t as a } from "../../advisor-a9axb4Jl.js";
|
|
4
|
+
import { d as o, f as s, m as c, p as l, u } from "../../evidence-FRF9RN77.js";
|
|
5
|
+
import { r as d, t as f } from "../../auditor-W2jFinr6.js";
|
|
6
|
+
import { Flags as p } from "@oclif/core";
|
|
7
|
+
import { execFileSync as m } from "node:child_process";
|
|
8
8
|
//#region src/commands/evidence/audit.ts
|
|
9
|
-
var
|
|
9
|
+
var h = class o extends i {
|
|
10
10
|
static summary = "Audit the evidence store: suspect links, staleness, vacuity.";
|
|
11
|
-
static description = "Reads the store and reports. RUNS NOTHING (ADR-0011 invariant 1) — the\nconsumer's CI refreshes evidence, and an auditor that could re-run a suite could\nalso make a finding disappear by re-running it.\n\nChecks:\n suspect-link the statement changed after the evidence was bound\n stale-evidence bound to a missing run, or to a run behind HEAD\n vacuous-evidence every bound symbol was skipped or absent from the run\n undischarged no evidence is bound at all\n method-conformance evidence of a kind the declared method does not produce\n unknown-method the declared method is in no catalog\n insufficient-multiplicity criticality demands two independent suites\n\n--ratchet compares against spec/evidence/baseline.json and fails only on NEW\nviolations. A gate that fails on the whole existing backlog gets disabled within\na week. Write that baseline with: quoin evidence baseline";
|
|
11
|
+
static description = "Reads the store and reports. RUNS NOTHING (ADR-0011 invariant 1) — the\nconsumer's CI refreshes evidence, and an auditor that could re-run a suite could\nalso make a finding disappear by re-running it.\n\nChecks:\n suspect-link the statement changed after the evidence was bound\n stale-evidence bound to a missing run, or to a run behind HEAD\n vacuous-evidence every bound symbol was skipped or absent from the run\n undischarged no evidence is bound at all\n method-conformance evidence of a kind the declared method does not produce\n unknown-method the declared method is in no catalog\n insufficient-multiplicity criticality demands two independent suites\n insufficient-mutation-score criticality demands a mutation score it misses\n unmeasured-mutation-score a demanded mutation score, with none recorded\n\n--ratchet compares against spec/evidence/baseline.json and fails only on NEW\nviolations. A gate that fails on the whole existing backlog gets disabled within\na week. Write that baseline with: quoin evidence baseline";
|
|
12
12
|
static examples = [
|
|
13
13
|
"quoin evidence audit",
|
|
14
14
|
"quoin evidence audit --ratchet --strict",
|
|
15
15
|
"quoin evidence audit --json"
|
|
16
16
|
];
|
|
17
17
|
static flags = {
|
|
18
|
-
repo:
|
|
18
|
+
repo: p.string({
|
|
19
19
|
description: "Repository root.",
|
|
20
20
|
default: "."
|
|
21
21
|
}),
|
|
22
|
-
module:
|
|
23
|
-
ratchet:
|
|
24
|
-
strict:
|
|
25
|
-
json:
|
|
26
|
-
"multiplicity-requires":
|
|
22
|
+
module: p.string({ description: "Module directory supplying the traceability model." }),
|
|
23
|
+
ratchet: p.boolean({ description: "Report only violations absent from the baseline." }),
|
|
24
|
+
strict: p.boolean({ description: "Exit 1 when any reported finding remains." }),
|
|
25
|
+
json: p.boolean({ description: "Emit the report as JSON." }),
|
|
26
|
+
"multiplicity-requires": p.string({
|
|
27
27
|
description: "Criticality values demanding two independent suites. Repeatable. Unset by default: no obligation source in the ecosystem declares a criticality column, so a built-in default could never fire.",
|
|
28
28
|
multiple: !0
|
|
29
|
+
}),
|
|
30
|
+
"mutation-floor": p.string({
|
|
31
|
+
description: "Minimum mutation score per criticality, as <criticality>=<0..1>. Repeatable. Unset by default, for the same reason as --multiplicity-requires: a built-in floor is a rule nobody chose.",
|
|
32
|
+
multiple: !0
|
|
29
33
|
})
|
|
30
34
|
};
|
|
31
35
|
async run() {
|
|
32
|
-
let { flags: i } = await this.parse(
|
|
33
|
-
|
|
34
|
-
let
|
|
36
|
+
let { flags: i } = await this.parse(o), s = n(r());
|
|
37
|
+
s && this.error(s.message, { exit: 2 });
|
|
38
|
+
let u = [
|
|
35
39
|
"coverage",
|
|
36
40
|
"--scope",
|
|
37
41
|
i.repo,
|
|
38
42
|
"--json"
|
|
39
43
|
];
|
|
40
|
-
i.module &&
|
|
41
|
-
let p = e(t(
|
|
44
|
+
i.module && u.push("--module", i.module);
|
|
45
|
+
let p = e(t(u));
|
|
42
46
|
p.ok || this.error(p.error.message, { exit: 2 });
|
|
43
|
-
let m =
|
|
47
|
+
let m = f({
|
|
44
48
|
obligations: p.value.obligations ?? [],
|
|
45
|
-
bindings:
|
|
46
|
-
runs:
|
|
49
|
+
bindings: c(i.repo).bindings,
|
|
50
|
+
runs: _(i.repo),
|
|
51
|
+
scans: g(i.repo),
|
|
47
52
|
catalog: a(i.module ? [i.module] : void 0),
|
|
48
|
-
headCommit:
|
|
49
|
-
multiplicityRequires: i["multiplicity-requires"]
|
|
50
|
-
|
|
53
|
+
headCommit: v(i.repo),
|
|
54
|
+
multiplicityRequires: i["multiplicity-requires"],
|
|
55
|
+
mutationFloor: y(i["mutation-floor"], (e) => this.error(e, { exit: 2 }))
|
|
56
|
+
}), h = i.ratchet ? l(i.repo) : null, b = h ? d(m, h) : m.findings;
|
|
51
57
|
if (i.json) this.log(JSON.stringify({
|
|
52
|
-
findings:
|
|
58
|
+
findings: b,
|
|
53
59
|
healthy: m.healthy,
|
|
54
60
|
ratchet: i.ratchet
|
|
55
61
|
}, null, 2));
|
|
56
|
-
else if (
|
|
62
|
+
else if (b.length === 0) this.log(`${m.healthy.length} obligation(s) with healthy evidence; nothing to report`);
|
|
57
63
|
else {
|
|
58
|
-
for (let e of
|
|
59
|
-
this.log(""), this.log(`${
|
|
64
|
+
for (let e of b) this.log(`[${e.severity}] ${e.kind}: ${e.summary}`);
|
|
65
|
+
this.log(""), this.log(`${b.length} finding(s), ${m.healthy.length} healthy` + (i.ratchet ? " (new violations only)" : ""));
|
|
60
66
|
}
|
|
61
|
-
i.strict &&
|
|
67
|
+
i.strict && b.length > 0 && this.exit(1);
|
|
62
68
|
}
|
|
63
69
|
};
|
|
64
|
-
function h(e) {
|
|
65
|
-
return l(e).map((t) => c(e, t)).filter((e) => e !== null);
|
|
66
|
-
}
|
|
67
70
|
function g(e) {
|
|
71
|
+
return s(e).map((t) => o(e, t)).filter((e) => e !== null);
|
|
72
|
+
}
|
|
73
|
+
function _(e) {
|
|
74
|
+
return s(e).map((t) => u(e, t)).filter((e) => e !== null);
|
|
75
|
+
}
|
|
76
|
+
function v(e) {
|
|
68
77
|
try {
|
|
69
|
-
return
|
|
78
|
+
return m("git", [
|
|
70
79
|
"-C",
|
|
71
80
|
e,
|
|
72
81
|
"rev-parse",
|
|
@@ -76,5 +85,14 @@ function g(e) {
|
|
|
76
85
|
return;
|
|
77
86
|
}
|
|
78
87
|
}
|
|
88
|
+
function y(e, t) {
|
|
89
|
+
if (!e || e.length === 0) return;
|
|
90
|
+
let n = {};
|
|
91
|
+
for (let r of e) {
|
|
92
|
+
let [e, i] = r.split("="), a = Number(i);
|
|
93
|
+
(!e || i === void 0 || Number.isNaN(a)) && t(`--mutation-floor expects <criticality>=<score>, got '${r}'. Example: --mutation-floor P0=0.8`), (a < 0 || a > 1) && t(`--mutation-floor score must be a ratio in [0, 1], got '${i}'. 80% is 0.8, not 80.`), n[e] = a;
|
|
94
|
+
}
|
|
95
|
+
return n;
|
|
96
|
+
}
|
|
79
97
|
//#endregion
|
|
80
|
-
export {
|
|
98
|
+
export { h as default, y as parseMutationFloor };
|
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
import { i as e, n as t, o as n, t as r } from "../../quire-
|
|
2
|
-
import { t as i } from "../../base-
|
|
3
|
-
import { t as a } from "../../advisor-
|
|
4
|
-
import {
|
|
5
|
-
import { n as d, t as f } from "../../
|
|
1
|
+
import { i as e, n as t, o as n, t as r } from "../../quire-Dis3ky5t.js";
|
|
2
|
+
import { t as i } from "../../base-BE20w0jY.js";
|
|
3
|
+
import { t as a } from "../../advisor-a9axb4Jl.js";
|
|
4
|
+
import { f as o, g as s, m as c, s as l, u } from "../../evidence-FRF9RN77.js";
|
|
5
|
+
import { n as d, t as f } from "../../auditor-W2jFinr6.js";
|
|
6
6
|
import { Flags as p } from "@oclif/core";
|
|
7
7
|
import { execFileSync as m } from "node:child_process";
|
|
8
8
|
//#region src/commands/evidence/baseline.ts
|
|
9
|
-
var h = class
|
|
9
|
+
var h = class o extends i {
|
|
10
10
|
static summary = "Accept the current findings as the ratchet baseline.";
|
|
11
11
|
static description = "Writes spec/evidence/baseline.json: every finding the audit reports right now,\nas <kind>:<obligation>, plus the commit it was accepted at.\n\n`--ratchet` reads this file and fails only on findings NOT in it. Without it,\na first run of the gate reports the entire existing backlog and gets switched\noff within a week — so accepting a baseline is the deliberate act that makes\nthe ratchet usable, and its diff is the record of what was accepted and by whom.\n\nRe-run this at a release to move the ratchet forward. Never run it to make a\nnew failure go away: the diff is reviewed, and a baseline that grows between\nreleases is the gate quietly being disabled one entry at a time.";
|
|
12
12
|
static examples = ["quoin evidence baseline", "quoin evidence baseline --dry-run"];
|
|
@@ -20,8 +20,8 @@ var h = class c extends i {
|
|
|
20
20
|
json: p.boolean({ description: "Emit the outcome as JSON." })
|
|
21
21
|
};
|
|
22
22
|
async run() {
|
|
23
|
-
let { flags: i } = await this.parse(
|
|
24
|
-
|
|
23
|
+
let { flags: i } = await this.parse(o), u = n(r());
|
|
24
|
+
u && this.error(u.message, { exit: 2 });
|
|
25
25
|
let p = [
|
|
26
26
|
"coverage",
|
|
27
27
|
"--scope",
|
|
@@ -33,12 +33,12 @@ var h = class c extends i {
|
|
|
33
33
|
m.ok || this.error(m.error.message, { exit: 2 });
|
|
34
34
|
let h = f({
|
|
35
35
|
obligations: m.value.obligations ?? [],
|
|
36
|
-
bindings:
|
|
36
|
+
bindings: c(i.repo).bindings,
|
|
37
37
|
runs: g(i.repo),
|
|
38
38
|
catalog: a(i.module ? [i.module] : void 0),
|
|
39
39
|
headCommit: _(i.repo)
|
|
40
40
|
}).findings.map(d).sort(), v = _(i.repo) ?? "";
|
|
41
|
-
if (i["dry-run"] ||
|
|
41
|
+
if (i["dry-run"] || s(i.repo, {
|
|
42
42
|
schemaVersion: 1,
|
|
43
43
|
commit: v,
|
|
44
44
|
accepted: h
|
|
@@ -57,11 +57,11 @@ var h = class c extends i {
|
|
|
57
57
|
}
|
|
58
58
|
this.log(`${i["dry-run"] ? "would accept" : "accepted"} ${h.length} finding(s) at ${v.slice(0, 12) || "an unknown commit"}`);
|
|
59
59
|
for (let [e, t] of [...y].sort()) this.log(` ${e}: ${t}`);
|
|
60
|
-
i["dry-run"] || this.log(
|
|
60
|
+
i["dry-run"] || this.log(l(i.repo));
|
|
61
61
|
}
|
|
62
62
|
};
|
|
63
63
|
function g(e) {
|
|
64
|
-
return
|
|
64
|
+
return o(e).map((t) => u(e, t)).filter((e) => e !== null);
|
|
65
65
|
}
|
|
66
66
|
function _(e) {
|
|
67
67
|
try {
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { t as e } from "../../base-
|
|
2
|
-
import {
|
|
1
|
+
import { t as e } from "../../base-BE20w0jY.js";
|
|
2
|
+
import { l as t } from "../../evidence-FRF9RN77.js";
|
|
3
3
|
import { Flags as n } from "@oclif/core";
|
|
4
4
|
//#region src/commands/evidence/gc.ts
|
|
5
5
|
var r = class r extends e {
|
|
@@ -8,6 +8,8 @@ export default class EvidenceRecord extends QuoinCommand {
|
|
|
8
8
|
commit: import('@oclif/core/interfaces').OptionFlag<string, import('@oclif/core/interfaces').CustomOptions>;
|
|
9
9
|
tool: import('@oclif/core/interfaces').OptionFlag<string, import('@oclif/core/interfaces').CustomOptions>;
|
|
10
10
|
kind: import('@oclif/core/interfaces').OptionFlag<string | undefined, import('@oclif/core/interfaces').CustomOptions>;
|
|
11
|
+
discharges: import('@oclif/core/interfaces').OptionFlag<string | undefined, import('@oclif/core/interfaces').CustomOptions>;
|
|
12
|
+
adapter: import('@oclif/core/interfaces').OptionFlag<string | undefined, import('@oclif/core/interfaces').CustomOptions>;
|
|
11
13
|
results: import('@oclif/core/interfaces').OptionFlag<string, import('@oclif/core/interfaces').CustomOptions>;
|
|
12
14
|
repo: import('@oclif/core/interfaces').OptionFlag<string, import('@oclif/core/interfaces').CustomOptions>;
|
|
13
15
|
module: import('@oclif/core/interfaces').OptionFlag<string | undefined, import('@oclif/core/interfaces').CustomOptions>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../src/commands/evidence/record.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;
|
|
1
|
+
{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../src/commands/evidence/record.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAoB7C,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,YAAY;IACtD,MAAM,CAAC,OAAO,SAAuD;IACrE,MAAM,CAAC,WAAW,SAcc;IAEhC,MAAM,CAAC,QAAQ,WAEb;IAEF,MAAM,CAAC,KAAK;;;;;;;;;;;;MAoDV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAmK3B"}
|
|
@@ -1,72 +1,129 @@
|
|
|
1
|
-
import { i as e, n as t, o as n, t as r } from "../../quire-
|
|
2
|
-
import { t as i } from "../../base-
|
|
3
|
-
import {
|
|
4
|
-
import { readFileSync as
|
|
5
|
-
import { Flags as
|
|
1
|
+
import { i as e, n as t, o as n, t as r } from "../../quire-Dis3ky5t.js";
|
|
2
|
+
import { t as i } from "../../base-BE20w0jY.js";
|
|
3
|
+
import { _ as a, a as o, c as s, i as c, m as l, n as u, r as d, t as f, v as p } from "../../evidence-FRF9RN77.js";
|
|
4
|
+
import { readFileSync as m } from "node:fs";
|
|
5
|
+
import { Flags as h } from "@oclif/core";
|
|
6
6
|
//#region src/commands/evidence/record.ts
|
|
7
|
-
var
|
|
7
|
+
var g = class u extends i {
|
|
8
8
|
static summary = "Transcribe one suite run into the evidence store.";
|
|
9
|
-
static description = "Records ONE run of ONE suite at ONE commit, then binds every obligation that\nrun discharged, stamping the statement hash as it stands now.\n\nquoin transcribes; the consumer's CI executes (ADR-0011 invariant 1). This\ncommand runs no test and judges no result — recording a FAILING run is as\nlegitimate as recording a passing one, and more useful, because a suite that\nstopped passing is exactly what a freshness check needs to see.\n\n--results takes normalized entries:\n\n {\"entries\": [{\"symbol\": \"tests::tc001\", \"outcome\": \"pass\", \"traceIds\": [\"FR-001-AC-1\"]}]}\n\
|
|
9
|
+
static description = "Records ONE run of ONE suite at ONE commit, then binds every obligation that\nrun discharged, stamping the statement hash as it stands now.\n\nquoin transcribes; the consumer's CI executes (ADR-0011 invariant 1). This\ncommand runs no test and judges no result — recording a FAILING run is as\nlegitimate as recording a passing one, and more useful, because a suite that\nstopped passing is exactly what a freshness check needs to see.\n\n--results takes normalized entries:\n\n {\"entries\": [{\"symbol\": \"tests::tc001\", \"outcome\": \"pass\", \"traceIds\": [\"FR-001-AC-1\"]}]}\n\n--adapter selects a format reader. Without it the suite's --tool picks one, and\nfailing that the normalized shape above is assumed. An adapter transcribes; it\nruns nothing and judges nothing.";
|
|
10
10
|
static examples = ["quoin evidence record --suite SUITE-001 --commit $(git rev-parse HEAD) --tool 'cargo test' --results run.json"];
|
|
11
11
|
static flags = {
|
|
12
|
-
suite:
|
|
12
|
+
suite: h.string({
|
|
13
13
|
description: "Suite id from spec/evidence/suites.md (e.g. SUITE-001).",
|
|
14
14
|
required: !0
|
|
15
15
|
}),
|
|
16
|
-
commit:
|
|
16
|
+
commit: h.string({
|
|
17
17
|
description: "Full commit sha the run was performed at.",
|
|
18
18
|
required: !0
|
|
19
19
|
}),
|
|
20
|
-
tool:
|
|
20
|
+
tool: h.string({
|
|
21
21
|
description: "Tool and version, as it identifies itself.",
|
|
22
22
|
required: !0
|
|
23
23
|
}),
|
|
24
|
-
kind:
|
|
25
|
-
|
|
24
|
+
kind: h.string({ description: "Evidence kind this run produced (Unit, Property, Static, Manual, …) — the vocabulary the catalog's `evidence_kind` and the suite registry's `Evidence Kind` column use. Method conformance compares kind to kind; without it the check stays silent rather than guessing." }),
|
|
25
|
+
discharges: h.string({
|
|
26
|
+
description: "Obligation ids this scan discharges, comma-separated. Finding-shaped only. A CLEAN scan is the strongest evidence a scanner produces and carries no finding to bind from, so the obligations it was run to check are stated rather than inferred. A scan that evaluated no rules binds nothing regardless.",
|
|
27
|
+
multiple: !1
|
|
28
|
+
}),
|
|
29
|
+
adapter: h.string({
|
|
30
|
+
description: `Format reader for --results (${f.join(", ")}). Defaults to the adapter claiming --tool, else the normalized shape. An unknown name is an error rather than a silent fall back, so a typo reports itself instead of failing later as a JSON-shape complaint.`,
|
|
31
|
+
options: [...f]
|
|
32
|
+
}),
|
|
33
|
+
results: h.string({
|
|
26
34
|
description: "Normalized run entries as JSON. `-` reads stdin.",
|
|
27
35
|
required: !0
|
|
28
36
|
}),
|
|
29
|
-
repo:
|
|
37
|
+
repo: h.string({
|
|
30
38
|
description: "Repository root. Defaults to the working directory.",
|
|
31
39
|
default: "."
|
|
32
40
|
}),
|
|
33
|
-
module:
|
|
34
|
-
timestamp:
|
|
35
|
-
json:
|
|
41
|
+
module: h.string({ description: "Module directory supplying the traceability model." }),
|
|
42
|
+
timestamp: h.string({ description: "ISO-8601 run time. Defaults to now." }),
|
|
43
|
+
json: h.boolean({ description: "Emit the outcome as JSON." })
|
|
36
44
|
};
|
|
37
45
|
async run() {
|
|
38
|
-
let { flags: i } = await this.parse(
|
|
39
|
-
|
|
40
|
-
let
|
|
46
|
+
let { flags: i } = await this.parse(u), f = n(r());
|
|
47
|
+
f && this.error(f.message, { exit: 2 });
|
|
48
|
+
let h = [
|
|
41
49
|
"coverage",
|
|
42
50
|
"--scope",
|
|
43
51
|
i.repo,
|
|
44
52
|
"--json"
|
|
45
53
|
];
|
|
46
|
-
i.module &&
|
|
47
|
-
let
|
|
48
|
-
|
|
49
|
-
let
|
|
54
|
+
i.module && h.push("--module", i.module);
|
|
55
|
+
let g = t(h), v = e(g);
|
|
56
|
+
v.ok || this.error(`${v.error.message}\n${v.error.errors.slice(0, 10).join("\n")}`, { exit: 2 });
|
|
57
|
+
let y = d({
|
|
58
|
+
adapter: i.adapter,
|
|
59
|
+
tool: i.tool
|
|
60
|
+
});
|
|
61
|
+
if (y) {
|
|
62
|
+
let e = i.results === "-" ? m(0, "utf8") : m(i.results, "utf8"), t = y.parse(e), n = p(i.repo, {
|
|
63
|
+
schemaVersion: 1,
|
|
64
|
+
suite: i.suite,
|
|
65
|
+
commit: i.commit,
|
|
66
|
+
tool: t.tool ?? i.tool,
|
|
67
|
+
...i.kind === void 0 ? {} : { evidenceKind: i.kind },
|
|
68
|
+
timestamp: i.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
|
|
69
|
+
...t.ruleset === void 0 ? {} : { ruleset: t.ruleset },
|
|
70
|
+
...t.rulesEvaluated === void 0 ? {} : { rulesEvaluated: t.rulesEvaluated },
|
|
71
|
+
findings: t.findings
|
|
72
|
+
}), r = t.rulesEvaluated === 0, o = (i.discharges ?? "").split(",").map((e) => e.trim()).filter((e) => e !== ""), u = [], d = [];
|
|
73
|
+
if (o.length > 0 && !r) {
|
|
74
|
+
let e = new Map(c(v.value).map((e) => [e.id, e])), t = l(i.repo).bindings;
|
|
75
|
+
for (let n of [...o].sort()) {
|
|
76
|
+
let r = e.get(n);
|
|
77
|
+
if (!r) {
|
|
78
|
+
d.push(n);
|
|
79
|
+
continue;
|
|
80
|
+
}
|
|
81
|
+
let a = s(t, {
|
|
82
|
+
obligation: n,
|
|
83
|
+
statementHashAtBinding: r.statement_hash,
|
|
84
|
+
suite: i.suite,
|
|
85
|
+
commit: i.commit,
|
|
86
|
+
symbols: []
|
|
87
|
+
});
|
|
88
|
+
t = a.bindings, a.created && u.push(n);
|
|
89
|
+
}
|
|
90
|
+
a(i.repo, { bindings: t });
|
|
91
|
+
}
|
|
92
|
+
if (i.json) {
|
|
93
|
+
this.log(JSON.stringify({
|
|
94
|
+
scanPath: n,
|
|
95
|
+
findings: t.findings,
|
|
96
|
+
bound: u,
|
|
97
|
+
unknown: d
|
|
98
|
+
}, null, 2));
|
|
99
|
+
return;
|
|
100
|
+
}
|
|
101
|
+
this.log(`recorded scan ${i.suite} @ ${i.commit.slice(0, 12)} → ${n}`), this.log(` bound: ${u.length}`), d.length > 0 && this.log(` discharges no such obligation: ${d.sort().join(", ")}`), r && o.length > 0 && this.log(" bound nothing: the scan evaluated no rules, so it found nothing because it looked for nothing"), this.log(` findings: ${t.findings.length}` + (t.rulesEvaluated === void 0 ? " (the tool reported no rule count, so this cannot be told from a scan with no rules enabled)" : ` over ${t.rulesEvaluated} rules evaluated`));
|
|
102
|
+
return;
|
|
103
|
+
}
|
|
104
|
+
let b = _(i.results, {
|
|
105
|
+
adapter: i.adapter,
|
|
106
|
+
tool: i.tool
|
|
107
|
+
}), x = o({
|
|
50
108
|
repo: i.repo,
|
|
51
109
|
suite: i.suite,
|
|
52
110
|
commit: i.commit,
|
|
53
111
|
tool: i.tool,
|
|
54
112
|
evidenceKind: i.kind,
|
|
55
113
|
timestamp: i.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
|
|
56
|
-
entries:
|
|
57
|
-
obligations:
|
|
114
|
+
entries: b,
|
|
115
|
+
obligations: c(v.value)
|
|
58
116
|
});
|
|
59
117
|
if (i.json) {
|
|
60
|
-
this.log(JSON.stringify(
|
|
118
|
+
this.log(JSON.stringify(x, null, 2));
|
|
61
119
|
return;
|
|
62
120
|
}
|
|
63
|
-
this.log(`recorded ${i.suite} @ ${i.commit.slice(0, 12)} → ${
|
|
121
|
+
this.log(`recorded ${i.suite} @ ${i.commit.slice(0, 12)} → ${x.runPath}`), this.log(` bound: ${x.bound.length}`), x.suspect.length > 0 && this.log(` suspect (statement changed since binding, re-affirm to clear): ${x.suspect.join(", ")}`), x.unmatched.length > 0 && this.log(` unmatched trace ids (tagged in the suite, stated by no obligation): ${x.unmatched.join(", ")}`);
|
|
64
122
|
}
|
|
65
123
|
};
|
|
66
|
-
function
|
|
67
|
-
let
|
|
68
|
-
|
|
69
|
-
return n.entries;
|
|
124
|
+
function _(e, t) {
|
|
125
|
+
let n = m(e === "-" ? 0 : e, "utf8");
|
|
126
|
+
return u(t).parse(n).entries;
|
|
70
127
|
}
|
|
71
128
|
//#endregion
|
|
72
|
-
export {
|
|
129
|
+
export { g as default };
|
package/dist/commands/matrix.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { t as e } from "../../base-
|
|
2
|
-
import { r as t } from "../../plugins-
|
|
3
|
-
import { n } from "../../modules-
|
|
1
|
+
import { t as e } from "../../base-BE20w0jY.js";
|
|
2
|
+
import { r as t } from "../../plugins-Q1MtCIE5.js";
|
|
3
|
+
import { n } from "../../modules-_FQTZ3gx.js";
|
|
4
4
|
//#region src/commands/module/ensure-defaults.ts
|
|
5
5
|
var r = class r extends e {
|
|
6
6
|
static summary = "Idempotently install the default spec module set.";
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { t as e } from "../../base-
|
|
2
|
-
import { n as t } from "../../plugins-
|
|
1
|
+
import { t as e } from "../../base-BE20w0jY.js";
|
|
2
|
+
import { n as t } from "../../plugins-Q1MtCIE5.js";
|
|
3
3
|
import { Args as n } from "@oclif/core";
|
|
4
4
|
//#region src/commands/module/install.ts
|
|
5
5
|
var r = class r extends e {
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { t as e } from "../../base-
|
|
2
|
-
import { r as t } from "../../plugins-
|
|
1
|
+
import { t as e } from "../../base-BE20w0jY.js";
|
|
2
|
+
import { r as t } from "../../plugins-Q1MtCIE5.js";
|
|
3
3
|
//#region src/commands/module/list.ts
|
|
4
4
|
var n = class n extends e {
|
|
5
5
|
static summary = "List installed spec modules.";
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { t as e } from "../../base-
|
|
2
|
-
import { a as t } from "../../plugins-
|
|
1
|
+
import { t as e } from "../../base-BE20w0jY.js";
|
|
2
|
+
import { a as t } from "../../plugins-Q1MtCIE5.js";
|
|
3
3
|
import { Args as n } from "@oclif/core";
|
|
4
4
|
//#region src/commands/module/remove.ts
|
|
5
5
|
var r = class r extends e {
|
package/dist/commands/review.js
CHANGED
package/dist/commands/to-plan.js
CHANGED
package/dist/commands/update.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { t as e } from "../version-
|
|
2
|
-
import { t } from "../base-
|
|
1
|
+
import { t as e } from "../version-D0l3nDPZ.js";
|
|
2
|
+
import { t } from "../base-BE20w0jY.js";
|
|
3
3
|
import { runSelfUpdate as n } from "@agent-ix/ix-cli-core";
|
|
4
4
|
import { Flags as r } from "@oclif/core";
|
|
5
5
|
//#region src/commands/update.ts
|
package/dist/commands/write.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { o as e, t } from "../base-
|
|
2
|
-
import { n } from "../modules-
|
|
3
|
-
import { n as r, r as i, t as a } from "../write-
|
|
1
|
+
import { o as e, t } from "../base-BE20w0jY.js";
|
|
2
|
+
import { n } from "../modules-_FQTZ3gx.js";
|
|
3
|
+
import { n as r, r as i, t as a } from "../write-CMA6BDUq.js";
|
|
4
4
|
import { Args as o, Flags as s } from "@oclif/core";
|
|
5
5
|
//#region src/commands/write.ts
|
|
6
6
|
var c = class c extends t {
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
import { VocabularyDeclaration } from './declarations.js';
|
|
2
|
+
export type FindingKind = "unowned" | "unjustified-exclusion" | "undeclared-exclusion";
|
|
3
|
+
export type Severity = "medium" | "high";
|
|
4
|
+
export interface CompletenessFinding {
|
|
5
|
+
/** Declaration this concerns, e.g. `quality-characteristics`. */
|
|
6
|
+
vocabulary: string;
|
|
7
|
+
/** The vocabulary value, e.g. `safety`. */
|
|
8
|
+
value: string;
|
|
9
|
+
kind: FindingKind;
|
|
10
|
+
severity: Severity;
|
|
11
|
+
message: string;
|
|
12
|
+
/** Document carrying the exclusion, for the two exclusion kinds. */
|
|
13
|
+
document?: string;
|
|
14
|
+
}
|
|
15
|
+
export interface VocabularyRollup {
|
|
16
|
+
vocabulary: string;
|
|
17
|
+
/** Values in the declared enum. */
|
|
18
|
+
declared: number;
|
|
19
|
+
/** Values some document claims. */
|
|
20
|
+
owned: number;
|
|
21
|
+
/** Values a document excuses, whether or not the excuse is justified. */
|
|
22
|
+
excused: number;
|
|
23
|
+
/** Values neither claimed nor excused. */
|
|
24
|
+
unowned: number;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* `UNCHECKED` is not a fourth flavour of pass.
|
|
28
|
+
*
|
|
29
|
+
* A bundle whose module set declares no vocabulary has not been assessed, and
|
|
30
|
+
* `PASS` over it is the green-matrix-over-dead-links result this program was
|
|
31
|
+
* created to stop — the first draft of this file printed exactly that, and the
|
|
32
|
+
* criterion written to forbid it caught it.
|
|
33
|
+
*/
|
|
34
|
+
export type Verdict = "PASS" | "CONDITIONAL" | "FAIL" | "UNCHECKED";
|
|
35
|
+
export interface CompletenessReport {
|
|
36
|
+
rollups: VocabularyRollup[];
|
|
37
|
+
findings: CompletenessFinding[];
|
|
38
|
+
verdict: Verdict;
|
|
39
|
+
}
|
|
40
|
+
/** One document's declared-vocabulary frontmatter, as read from the bundle. */
|
|
41
|
+
export interface DocumentClaims {
|
|
42
|
+
/** Path, relative to the bundle root. */
|
|
43
|
+
path: string;
|
|
44
|
+
/** Values this document claims via the declaration's `field`. */
|
|
45
|
+
claims: string[];
|
|
46
|
+
/** Values this document excuses via `justified_absence_field`. */
|
|
47
|
+
excuses: string[];
|
|
48
|
+
/** Raw body text, searched for the written reason behind each excuse. */
|
|
49
|
+
body: string;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Assess one vocabulary declaration against what the bundle's documents say.
|
|
53
|
+
*
|
|
54
|
+
* Note the asymmetry, which is the policy: **`unowned` is medium and an
|
|
55
|
+
* unjustified exclusion is high.** Saying nothing about reliability is an
|
|
56
|
+
* admitted gap that a reader can see. Excusing it without a reason is an
|
|
57
|
+
* assertion of completeness with nothing behind it, and it removes the finding
|
|
58
|
+
* that would have prompted the work.
|
|
59
|
+
*/
|
|
60
|
+
export declare function assessVocabulary(declaration: VocabularyDeclaration, documents: DocumentClaims[]): {
|
|
61
|
+
rollup: VocabularyRollup;
|
|
62
|
+
findings: CompletenessFinding[];
|
|
63
|
+
};
|
|
64
|
+
/**
|
|
65
|
+
* The written reason for excusing `value`, or `null` when there is none.
|
|
66
|
+
*
|
|
67
|
+
* A table row whose first cell names the value and whose remaining cells carry
|
|
68
|
+
* a real sentence. A table is required rather than free prose because the value
|
|
69
|
+
* name will occur in passing — "safety" appears in any document discussing
|
|
70
|
+
* safety — and a mention is not a justification.
|
|
71
|
+
*/
|
|
72
|
+
export declare function writtenReasonFor(value: string, body: string): string | null;
|
|
73
|
+
/**
|
|
74
|
+
* The verdict over every finding.
|
|
75
|
+
*
|
|
76
|
+
* `--strict` promotes an admitted gap to a failure; it does not invent one. The
|
|
77
|
+
* default is advisory because a new check landing as a hard error across a
|
|
78
|
+
* corpus teaches people to disable it, and a disabled check reports nothing
|
|
79
|
+
* forever — which is the outcome this whole area exists to prevent.
|
|
80
|
+
*/
|
|
81
|
+
export declare function verdictFor(findings: CompletenessFinding[], strict: boolean, vocabulariesChecked?: number): Verdict;
|
|
82
|
+
//# sourceMappingURL=assess.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"assess.d.ts","sourceRoot":"","sources":["../../src/completeness/assess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,MAAM,WAAW,GACrB,SAAS,GAAG,uBAAuB,GAAG,sBAAsB,CAAC;AAE/D,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,aAAa,GAAG,MAAM,GAAG,WAAW,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kEAAkE;IAClE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;CACd;AAgCD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,qBAAqB,EAClC,SAAS,EAAE,cAAc,EAAE,GAC1B;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,QAAQ,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAoE/D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe3E;AAQD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,MAAM,EAAE,OAAO,EACf,mBAAmB,SAAI,GACtB,OAAO,CAKT"}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import { VocabularyDeclaration } from './declarations.js';
|
|
2
|
+
import { DocumentClaims } from './assess.js';
|
|
3
|
+
export interface BundleRead {
|
|
4
|
+
documents: DocumentClaims[];
|
|
5
|
+
/** Documents whose frontmatter could not be parsed, and why. */
|
|
6
|
+
unreadable: Array<{
|
|
7
|
+
path: string;
|
|
8
|
+
reason: string;
|
|
9
|
+
}>;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Read every markdown document under `bundleRoot` for one declaration's fields.
|
|
13
|
+
*
|
|
14
|
+
* Both the claim field and the justified-absence field accept a scalar or a
|
|
15
|
+
* list, because `quality_attribute: security` and
|
|
16
|
+
* `quality_attributes_not_applicable: [safety, compliance]` are both ordinary
|
|
17
|
+
* authoring — the same two shapes the engine accepts, for the same reason.
|
|
18
|
+
*/
|
|
19
|
+
export declare function readBundleClaims(bundleRoot: string, declaration: VocabularyDeclaration): BundleRead;
|
|
20
|
+
/**
|
|
21
|
+
* Project already-read documents onto one declaration.
|
|
22
|
+
*
|
|
23
|
+
* Split out from {@link readBundleClaims} so a caller with several declarations
|
|
24
|
+
* walks the bundle **once**. The combined form re-read every file per
|
|
25
|
+
* declaration, which NFR-011-M-2 budgets at one pass per invocation.
|
|
26
|
+
*/
|
|
27
|
+
export declare function claimsFor(read: BundleDocument[], declaration: VocabularyDeclaration): DocumentClaims[];
|
|
28
|
+
/** One document's frontmatter and body, as read from the bundle. */
|
|
29
|
+
export interface BundleDocument {
|
|
30
|
+
/** Path, relative to the bundle root. */
|
|
31
|
+
path: string;
|
|
32
|
+
frontmatter: Record<string, unknown>;
|
|
33
|
+
body: string;
|
|
34
|
+
}
|
|
35
|
+
export interface FrontmatterRead {
|
|
36
|
+
documents: BundleDocument[];
|
|
37
|
+
unreadable: Array<{
|
|
38
|
+
path: string;
|
|
39
|
+
reason: string;
|
|
40
|
+
}>;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Every document under `bundleRoot` that carries parseable frontmatter.
|
|
44
|
+
*
|
|
45
|
+
* One pass and one reader, shared by the completeness sweep (FR-037) and the
|
|
46
|
+
* assurance view (FR-040). Two readers over the same files would drift, and the
|
|
47
|
+
* second would be written by whoever needed a field the first did not expose —
|
|
48
|
+
* which is how a repository ends up with two answers to "what does this
|
|
49
|
+
* document declare".
|
|
50
|
+
*/
|
|
51
|
+
export declare function readBundleFrontmatter(bundleRoot: string): FrontmatterRead;
|
|
52
|
+
//# sourceMappingURL=bundle.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/completeness/bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,gEAAgE;IAChE,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,qBAAqB,GACjC,UAAU,CAGZ;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,cAAc,EAAE,EACtB,WAAW,EAAE,qBAAqB,GACjC,cAAc,EAAE,CAalB;AAED,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAgCzE"}
|