@agent-ix/quoin 0.22.5 → 0.23.1
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/dist/{advisor-BkgwDKvQ.js → advisor-B0rESCx1.js} +1 -1
- package/dist/{auditor-C3bSmPD_.js → auditor-Dd3i9Aqx.js} +2 -2
- package/dist/{base-CqKNs2Kd.js → base-gAClyCNd.js} +1 -1
- package/dist/change-assurance/attestations.d.ts +7 -0
- package/dist/change-assurance/attestations.d.ts.map +1 -0
- package/dist/change-assurance/index.d.ts +14 -0
- package/dist/change-assurance/index.d.ts.map +1 -0
- package/dist/change-assurance/integrity.d.ts +11 -0
- package/dist/change-assurance/integrity.d.ts.map +1 -0
- package/dist/change-assurance/records.d.ts +22 -0
- package/dist/change-assurance/records.d.ts.map +1 -0
- package/dist/change-assurance/schema-assets.d.ts +8 -0
- package/dist/change-assurance/schema-assets.d.ts.map +1 -0
- package/dist/change-assurance/store.d.ts +18 -0
- package/dist/change-assurance/store.d.ts.map +1 -0
- package/dist/change-assurance/types.d.ts +180 -0
- package/dist/change-assurance/types.d.ts.map +1 -0
- package/dist/change-assurance/verify.d.ts +4 -0
- package/dist/change-assurance/verify.d.ts.map +1 -0
- package/dist/change-assurance-CyKLPeKa.js +1236 -0
- package/dist/cli.js +1 -1
- package/dist/commands/advise.js +19 -19
- package/dist/commands/assurance.js +20 -20
- 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/change-assurance/common.d.ts +37 -0
- package/dist/commands/change-assurance/common.d.ts.map +1 -0
- package/dist/commands/change-assurance/index.d.ts +8 -0
- package/dist/commands/change-assurance/index.d.ts.map +1 -0
- package/dist/commands/change-assurance/index.js +12 -0
- package/dist/commands/change-assurance/intake.d.ts +15 -0
- package/dist/commands/change-assurance/intake.d.ts.map +1 -0
- package/dist/commands/change-assurance/intake.js +53 -0
- package/dist/commands/change-assurance/receipt.d.ts +21 -0
- package/dist/commands/change-assurance/receipt.d.ts.map +1 -0
- package/dist/commands/change-assurance/receipt.js +99 -0
- package/dist/commands/change-assurance/recover.d.ts +13 -0
- package/dist/commands/change-assurance/recover.d.ts.map +1 -0
- package/dist/commands/change-assurance/recover.js +29 -0
- package/dist/commands/change-assurance/schema.d.ts +13 -0
- package/dist/commands/change-assurance/schema.d.ts.map +1 -0
- package/dist/commands/change-assurance/schema.js +40 -0
- package/dist/commands/change-assurance/seal-attestation.d.ts +15 -0
- package/dist/commands/change-assurance/seal-attestation.d.ts.map +1 -0
- package/dist/commands/change-assurance/seal-attestation.js +58 -0
- package/dist/commands/change-assurance/seal-record.d.ts +14 -0
- package/dist/commands/change-assurance/seal-record.d.ts.map +1 -0
- package/dist/commands/change-assurance/seal-record.js +53 -0
- package/dist/commands/change-assurance/verify-receipt.d.ts +13 -0
- package/dist/commands/change-assurance/verify-receipt.d.ts.map +1 -0
- package/dist/commands/change-assurance/verify-receipt.js +41 -0
- package/dist/commands/completeness.js +2 -2
- 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 +19 -19
- package/dist/commands/evidence/audit.js +26 -26
- package/dist/commands/evidence/baseline.js +21 -21
- package/dist/commands/evidence/gc.js +3 -3
- package/dist/commands/evidence/index.js +1 -1
- package/dist/commands/evidence/inspect-mocks.js +4 -4
- package/dist/commands/evidence/record.d.ts.map +1 -1
- package/dist/commands/evidence/record.js +28 -24
- package/dist/commands/graph/change-impact.d.ts +16 -0
- package/dist/commands/graph/change-impact.d.ts.map +1 -0
- package/dist/commands/graph/change-impact.js +29 -0
- package/dist/commands/graph/churn.d.ts +14 -0
- package/dist/commands/graph/churn.d.ts.map +1 -0
- package/dist/commands/graph/churn.js +15 -0
- package/dist/commands/graph/common.d.ts +16 -0
- package/dist/commands/graph/common.d.ts.map +1 -0
- package/dist/commands/graph/fan-out.d.ts +14 -0
- package/dist/commands/graph/fan-out.d.ts.map +1 -0
- package/dist/commands/graph/fan-out.js +15 -0
- package/dist/commands/graph/index.d.ts +8 -0
- package/dist/commands/graph/index.d.ts.map +1 -0
- package/dist/commands/graph/index.js +12 -0
- package/dist/commands/matrix.js +1 -1
- package/dist/commands/measurement/index.js +1 -1
- package/dist/commands/measurement/intervention.d.ts +11 -0
- package/dist/commands/measurement/intervention.d.ts.map +1 -0
- package/dist/commands/measurement/intervention.js +31 -0
- package/dist/commands/measurement/operational-release.d.ts +11 -0
- package/dist/commands/measurement/operational-release.d.ts.map +1 -0
- package/dist/commands/measurement/operational-release.js +31 -0
- package/dist/commands/measurement/record.d.ts.map +1 -1
- package/dist/commands/measurement/record.js +12 -11
- 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/report.d.ts +4 -0
- package/dist/commands/report.d.ts.map +1 -1
- package/dist/commands/report.js +49 -23
- 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/validate.js +1 -1
- package/dist/commands/write.js +3 -3
- package/dist/common-B1ZJ8CSO.js +36 -0
- package/dist/common-DTrmnvL-.js +35 -0
- package/dist/{completeness-DamWradt.js → completeness-BzBuNq6w.js} +1 -1
- package/dist/evidence/adapters/contract-conformance.d.ts +16 -0
- package/dist/evidence/adapters/contract-conformance.d.ts.map +1 -0
- package/dist/evidence/adapters/differential-report.d.ts +18 -0
- package/dist/evidence/adapters/differential-report.d.ts.map +1 -0
- package/dist/evidence/adapters/registry.d.ts.map +1 -1
- package/dist/evidence/adapters/types.d.ts +31 -0
- package/dist/evidence/adapters/types.d.ts.map +1 -1
- package/dist/evidence/index.d.ts +5 -2
- package/dist/evidence/index.d.ts.map +1 -1
- package/dist/{evidence-DD0CHzJ0.js → evidence-OyqpqHLS.js} +191 -110
- package/dist/{flow-command-BfFNY0Rv.js → flow-command-CCRTE5Oe.js} +7 -7
- package/dist/graph-analysis/analysis.d.ts +106 -0
- package/dist/graph-analysis/analysis.d.ts.map +1 -0
- package/dist/graph-analysis/index.d.ts +6 -0
- package/dist/graph-analysis/index.d.ts.map +1 -0
- package/dist/graph-analysis/input.d.ts +33 -0
- package/dist/graph-analysis/input.d.ts.map +1 -0
- package/dist/graph-analysis/load.d.ts +21 -0
- package/dist/graph-analysis/load.d.ts.map +1 -0
- package/dist/graph-analysis/render.d.ts +4 -0
- package/dist/graph-analysis/render.d.ts.map +1 -0
- package/dist/graph-analysis-IWaoJJSN.js +657 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +11 -9
- package/dist/measurement/agent-eval-intervention.d.ts +6 -0
- package/dist/measurement/agent-eval-intervention.d.ts.map +1 -0
- package/dist/measurement/atomic-file.d.ts +5 -0
- package/dist/measurement/atomic-file.d.ts.map +1 -0
- package/dist/measurement/date-time.d.ts +3 -0
- package/dist/measurement/date-time.d.ts.map +1 -0
- package/dist/measurement/github-release-operational.d.ts +7 -0
- package/dist/measurement/github-release-operational.d.ts.map +1 -0
- package/dist/measurement/graph-adapters.d.ts +304 -0
- package/dist/measurement/graph-adapters.d.ts.map +1 -0
- package/dist/measurement/graph-portfolio-load.d.ts +3 -0
- package/dist/measurement/graph-portfolio-load.d.ts.map +1 -0
- package/dist/measurement/graph-portfolio.d.ts +158 -0
- package/dist/measurement/graph-portfolio.d.ts.map +1 -0
- package/dist/measurement/index.d.ts +15 -2
- package/dist/measurement/index.d.ts.map +1 -1
- package/dist/measurement/intervention-report.d.ts +24 -0
- package/dist/measurement/intervention-report.d.ts.map +1 -0
- package/dist/measurement/intervention-schema.d.ts +144 -0
- package/dist/measurement/intervention-schema.d.ts.map +1 -0
- package/dist/measurement/intervention-types.d.ts +105 -0
- package/dist/measurement/intervention-types.d.ts.map +1 -0
- package/dist/measurement/intervention.d.ts +16 -0
- package/dist/measurement/intervention.d.ts.map +1 -0
- package/dist/measurement/operational-report.d.ts +17 -0
- package/dist/measurement/operational-report.d.ts.map +1 -0
- package/dist/measurement/operational-schema.d.ts +461 -0
- package/dist/measurement/operational-schema.d.ts.map +1 -0
- package/dist/measurement/operational-types.d.ts +121 -0
- package/dist/measurement/operational-types.d.ts.map +1 -0
- package/dist/measurement/operational.d.ts +13 -0
- package/dist/measurement/operational.d.ts.map +1 -0
- package/dist/measurement/plans.d.ts +3 -1
- package/dist/measurement/plans.d.ts.map +1 -1
- package/dist/measurement/portfolio.d.ts +7 -1
- package/dist/measurement/portfolio.d.ts.map +1 -1
- package/dist/measurement/report.d.ts +4 -0
- package/dist/measurement/report.d.ts.map +1 -1
- package/dist/measurement/schemas/operational-evidence-v1.schema.json.d.ts +384 -0
- package/dist/measurement/store.d.ts +7 -0
- package/dist/measurement/store.d.ts.map +1 -1
- package/dist/measurement/types.d.ts +2 -0
- package/dist/measurement/types.d.ts.map +1 -1
- package/dist/measurement-j8sDSqx5.js +2980 -0
- package/dist/{modules-ez9httBA.js → modules-DDQkKC4l.js} +2 -2
- package/dist/{plugins-C-ta0llj.js → plugins-CHpYhpEI.js} +1 -1
- package/dist/quire/assurance.d.ts +109 -0
- package/dist/quire/assurance.d.ts.map +1 -0
- package/dist/quire/contract.d.ts +2 -1
- package/dist/quire/contract.d.ts.map +1 -1
- package/dist/quire/index.d.ts +3 -2
- package/dist/quire/index.d.ts.map +1 -1
- package/dist/quire/validate.d.ts +5 -0
- package/dist/quire/validate.d.ts.map +1 -1
- package/dist/{quire-D8tCpgyA.js → quire-BsVj1xIR.js} +54 -47
- package/dist/schema-assets-HZWo_iFN.js +233 -0
- package/dist/schemas/assurance-v1.schema.json +225 -0
- package/dist/schemas/change-assurance-record-v1.schema.json +234 -0
- package/dist/schemas/operational-evidence-v1.schema.json +381 -0
- package/dist/schemas/proof-attestation-v1.schema.json +96 -0
- package/dist/schemas/verification-receipt-v1.schema.json +208 -0
- package/dist/{version-Dg0e6CZU.js → version-CMxMIh5g.js} +1 -1
- package/dist/{write-DElwS9xc.js → write-CGTI0dRO.js} +1 -1
- package/package.json +5 -1
- package/skills/gap-analysis/references/step-4-underspecified-code.md +36 -7
- package/skills/gap-analysis/references/step-5-semantic-review.md +2 -2
- package/skills/gap-analysis/references/step-6-specreview-artifact.md +6 -5
- package/skills/spec-fuzz/SKILL.md +7 -6
- package/dist/measurement-CzB74Q07.js +0 -595
- package/dist/store--2sAv12X.js +0 -219
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { i as e } from "./base-
|
|
1
|
+
import { i as e } from "./base-gAClyCNd.js";
|
|
2
2
|
import { n as t, r as n, t as r } from "./config-schema-Dp-vlxuR.js";
|
|
3
3
|
import { ConfigService as i } from "@agent-ix/ix-cli-core";
|
|
4
4
|
import { existsSync as a, readFileSync as o, statSync as s } from "node:fs";
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@agent-ix/quoin",
|
|
3
3
|
"description": "Spec-driven development for Claude Code — author validated, ISO/IEC/IEEE 29148-aligned specs, then plan and build against them.",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.23.1",
|
|
5
5
|
"license": "AGPL-3.0-or-later",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"files": [
|
|
@@ -36,6 +36,9 @@
|
|
|
36
36
|
"evidence": {
|
|
37
37
|
"description": "The evidence store — what actually ran, and against which statement (record, affirm, gc)."
|
|
38
38
|
},
|
|
39
|
+
"graph": {
|
|
40
|
+
"description": "Read-only evidence-graph analysis views."
|
|
41
|
+
},
|
|
39
42
|
"measurement": {
|
|
40
43
|
"description": "Record plan-validated QA measurements as atomic producer collections."
|
|
41
44
|
},
|
|
@@ -99,6 +102,7 @@
|
|
|
99
102
|
"@agent-ix/filament-plan-sync": "0.1.0",
|
|
100
103
|
"@agent-ix/ix-cli-core": "0.12.0",
|
|
101
104
|
"@agent-ix/ts-plugin-kit": "0.2.0",
|
|
105
|
+
"@noble/hashes": "2.2.0",
|
|
102
106
|
"@oclif/core": "4.13.3",
|
|
103
107
|
"ajv": "8.20.0",
|
|
104
108
|
"yaml": "2.9.0",
|
|
@@ -5,8 +5,9 @@ requirement**, plus stubs that masquerade as complete. Steps 2–3 verify spec
|
|
|
5
5
|
coverage; this step verifies code→spec, catching scope that was implemented but never
|
|
6
6
|
specified.
|
|
7
7
|
|
|
8
|
-
|
|
9
|
-
|
|
8
|
+
This reference is the authoritative, self-contained reverse-gap procedure. Do not
|
|
9
|
+
consult a private repository, user-home path, or separately installed skill for the
|
|
10
|
+
detection heuristics below.
|
|
10
11
|
|
|
11
12
|
## A. Untraced behavior (code with no requirement)
|
|
12
13
|
|
|
@@ -24,8 +25,7 @@ Reuse the detection heuristics in
|
|
|
24
25
|
|
|
25
26
|
## B. Implied requirements from code patterns
|
|
26
27
|
|
|
27
|
-
Map suspicious patterns to the requirement that *should* exist
|
|
28
|
-
implementation-gap-analysis table):
|
|
28
|
+
Map suspicious patterns to the requirement that *should* exist using the table below:
|
|
29
29
|
|
|
30
30
|
| Code pattern | Missing requirement type |
|
|
31
31
|
| --- | --- |
|
|
@@ -45,17 +45,46 @@ done:
|
|
|
45
45
|
| Stub | Detect | Severity |
|
|
46
46
|
| --- | --- | --- |
|
|
47
47
|
| Tiny file (≤5 lines, excl. `__init__`) | line count | high |
|
|
48
|
-
| `pass` / placeholder return (`{}
|
|
48
|
+
| `pass` / placeholder return (`{}`, `[]`, `""`, `None`, `"not implemented"`) body | grep/AST | high |
|
|
49
49
|
| Protocol/ABC-only with no concrete impl | structure | high |
|
|
50
50
|
| Re-export-only module | structure | medium (may be intentional) |
|
|
51
51
|
| Trivially-covered stub (≤5 lines @ 100% cov) | coverage + size | medium |
|
|
52
52
|
|
|
53
53
|
A stub behind a `done` task or a ✅ matrix row is a `high` finding (false completion).
|
|
54
54
|
|
|
55
|
+
Inspect test files as well as source. A passing test can still be a stub:
|
|
56
|
+
|
|
57
|
+
| Test stub | Detect | Severity |
|
|
58
|
+
| --- | --- | --- |
|
|
59
|
+
| Empty body or unconditional skip | `pass`, empty callback, or skip without a tracked reason | high |
|
|
60
|
+
| No behavioral assertion | no assertion, rejection, snapshot, or observable-effect check | high |
|
|
61
|
+
| Weak-only assertion | only existence/type checks for behavior with a stronger contract | high |
|
|
62
|
+
| Mock-everything | all meaningful collaborators replaced so production behavior is never exercised | high |
|
|
63
|
+
| Import-only smoke test | verifies only that a module imports | medium |
|
|
64
|
+
|
|
65
|
+
Do not flag an abstract declaration, generated file, intentional compatibility re-export,
|
|
66
|
+
or a test whose assertion is expressed through the repository's harness merely because it
|
|
67
|
+
matches a textual pattern. Confirm the behavior is hollow before recording a finding.
|
|
68
|
+
|
|
69
|
+
## D. Coverage inflation
|
|
70
|
+
|
|
71
|
+
Treat coverage as evidence only after checking what the covered lines do:
|
|
72
|
+
|
|
73
|
+
- A source file with five or fewer substantive lines and 100% coverage can still be a
|
|
74
|
+
trivially covered stub.
|
|
75
|
+
- A test that mocks a source module which is itself hollow is circular evidence, not
|
|
76
|
+
implementation coverage.
|
|
77
|
+
- A threshold dominated by imports, declarations, or re-exports does not establish that
|
|
78
|
+
the promised behavior exists.
|
|
79
|
+
|
|
80
|
+
Record these as `high` when they support a `done` task or ✅ matrix claim, otherwise
|
|
81
|
+
`medium`. Cite both the hollow source and the test or coverage artifact.
|
|
82
|
+
|
|
55
83
|
## Output of this step
|
|
56
84
|
|
|
57
|
-
Findings for untraced behavior, implied-but-missing requirements,
|
|
58
|
-
`Refs` = code location
|
|
85
|
+
Findings for untraced behavior, implied-but-missing requirements, source/test stubs, and
|
|
86
|
+
coverage inflation, each with `Refs` = concrete code/test location. Include counts of
|
|
87
|
+
inventoried behaviors, untraced behaviors, source stubs, and test stubs in `## Coverage`.
|
|
59
88
|
|
|
60
89
|
## Notes
|
|
61
90
|
|
|
@@ -21,8 +21,8 @@ code it governs (from Step 4), assess three axes:
|
|
|
21
21
|
requirement describes*, including its acceptance criteria, or only an incidental/trivial
|
|
22
22
|
aspect? A test tagged `FR-007-AC-1` that asserts something unrelated to AC-1 fails here.
|
|
23
23
|
2. **(b) Test exercises the code** — does the test run the real implementation, or is it
|
|
24
|
-
hollow? Reuse
|
|
25
|
-
|
|
24
|
+
hollow? Reuse Step 4's **test-stub / coverage-inflation** heuristics: no assertions,
|
|
25
|
+
weak-only assertions (`is not None`, `isinstance`),
|
|
26
26
|
mock-everything (no real code path), import-only, circular-mock-of-a-stub.
|
|
27
27
|
3. **(c) Code matches intent** — does the implementation actually do what the requirement
|
|
28
28
|
says (semantics, edge cases, error behavior), or has it drifted?
|
|
@@ -3,17 +3,18 @@
|
|
|
3
3
|
**Goal**: Emit the findings from Steps 1–5 as a single **quire-validated `SpecReview`**
|
|
4
4
|
document with a Verdict, at `reviews/YY-MM-DD-<slug>.md`.
|
|
5
5
|
|
|
6
|
-
##
|
|
6
|
+
## Render the template, then author (guardrail)
|
|
7
7
|
|
|
8
|
-
The `SpecReview` archetype lives in `spec-artifacts-process`.
|
|
9
|
-
author, then validate (the ecosystem direct-render-then-validate model):
|
|
8
|
+
The `SpecReview` archetype lives in `spec-artifacts-process`. Render its skeleton first,
|
|
9
|
+
then author, then validate (the ecosystem direct-render-then-validate model):
|
|
10
10
|
|
|
11
11
|
```
|
|
12
12
|
quoin write --types SpecReview
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
If `quoin write` is unavailable
|
|
16
|
-
|
|
15
|
+
If `quoin write` is unavailable, use the complete frontmatter, body, findings-table, and
|
|
16
|
+
validation contract below. Do not consult a private repository, user-home path, or
|
|
17
|
+
separately installed template.
|
|
17
18
|
|
|
18
19
|
## Frontmatter
|
|
19
20
|
|
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: spec-fuzz
|
|
3
|
-
description:
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
3
|
+
description: >-
|
|
4
|
+
Turn Fuzz-kind obligations into runnable fuzz targets. Consumes `quoin advise --json`,
|
|
5
|
+
selects the obligations whose verification method carries `evidence_kind: Fuzz`, grounds
|
|
6
|
+
each one's entry-point symbol in the repository's source, and emits targets in the repo's
|
|
7
|
+
own harness (cargo-fuzz / atheris / fast-check) keyed on the obligation id. Writes nothing
|
|
8
|
+
where the tooling is absent or the entry point cannot be grounded — a finding instead.
|
|
9
|
+
Emits a validated SpecReview recording every obligation it could not serve.
|
|
9
10
|
---
|
|
10
11
|
|
|
11
12
|
# Spec Fuzz
|