@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.
Files changed (200) hide show
  1. package/dist/{advisor-BkgwDKvQ.js → advisor-B0rESCx1.js} +1 -1
  2. package/dist/{auditor-C3bSmPD_.js → auditor-Dd3i9Aqx.js} +2 -2
  3. package/dist/{base-CqKNs2Kd.js → base-gAClyCNd.js} +1 -1
  4. package/dist/change-assurance/attestations.d.ts +7 -0
  5. package/dist/change-assurance/attestations.d.ts.map +1 -0
  6. package/dist/change-assurance/index.d.ts +14 -0
  7. package/dist/change-assurance/index.d.ts.map +1 -0
  8. package/dist/change-assurance/integrity.d.ts +11 -0
  9. package/dist/change-assurance/integrity.d.ts.map +1 -0
  10. package/dist/change-assurance/records.d.ts +22 -0
  11. package/dist/change-assurance/records.d.ts.map +1 -0
  12. package/dist/change-assurance/schema-assets.d.ts +8 -0
  13. package/dist/change-assurance/schema-assets.d.ts.map +1 -0
  14. package/dist/change-assurance/store.d.ts +18 -0
  15. package/dist/change-assurance/store.d.ts.map +1 -0
  16. package/dist/change-assurance/types.d.ts +180 -0
  17. package/dist/change-assurance/types.d.ts.map +1 -0
  18. package/dist/change-assurance/verify.d.ts +4 -0
  19. package/dist/change-assurance/verify.d.ts.map +1 -0
  20. package/dist/change-assurance-CyKLPeKa.js +1236 -0
  21. package/dist/cli.js +1 -1
  22. package/dist/commands/advise.js +19 -19
  23. package/dist/commands/assurance.js +20 -20
  24. package/dist/commands/catalog/list.js +2 -2
  25. package/dist/commands/catalog/methods.js +3 -3
  26. package/dist/commands/catalog/show.js +2 -2
  27. package/dist/commands/catalog/validate.js +2 -2
  28. package/dist/commands/change-assurance/common.d.ts +37 -0
  29. package/dist/commands/change-assurance/common.d.ts.map +1 -0
  30. package/dist/commands/change-assurance/index.d.ts +8 -0
  31. package/dist/commands/change-assurance/index.d.ts.map +1 -0
  32. package/dist/commands/change-assurance/index.js +12 -0
  33. package/dist/commands/change-assurance/intake.d.ts +15 -0
  34. package/dist/commands/change-assurance/intake.d.ts.map +1 -0
  35. package/dist/commands/change-assurance/intake.js +53 -0
  36. package/dist/commands/change-assurance/receipt.d.ts +21 -0
  37. package/dist/commands/change-assurance/receipt.d.ts.map +1 -0
  38. package/dist/commands/change-assurance/receipt.js +99 -0
  39. package/dist/commands/change-assurance/recover.d.ts +13 -0
  40. package/dist/commands/change-assurance/recover.d.ts.map +1 -0
  41. package/dist/commands/change-assurance/recover.js +29 -0
  42. package/dist/commands/change-assurance/schema.d.ts +13 -0
  43. package/dist/commands/change-assurance/schema.d.ts.map +1 -0
  44. package/dist/commands/change-assurance/schema.js +40 -0
  45. package/dist/commands/change-assurance/seal-attestation.d.ts +15 -0
  46. package/dist/commands/change-assurance/seal-attestation.d.ts.map +1 -0
  47. package/dist/commands/change-assurance/seal-attestation.js +58 -0
  48. package/dist/commands/change-assurance/seal-record.d.ts +14 -0
  49. package/dist/commands/change-assurance/seal-record.d.ts.map +1 -0
  50. package/dist/commands/change-assurance/seal-record.js +53 -0
  51. package/dist/commands/change-assurance/verify-receipt.d.ts +13 -0
  52. package/dist/commands/change-assurance/verify-receipt.d.ts.map +1 -0
  53. package/dist/commands/change-assurance/verify-receipt.js +41 -0
  54. package/dist/commands/completeness.js +2 -2
  55. package/dist/commands/config/doctor.js +1 -1
  56. package/dist/commands/config/edit.js +1 -1
  57. package/dist/commands/config/get.js +1 -1
  58. package/dist/commands/config/set.js +1 -1
  59. package/dist/commands/evidence/affirm.js +19 -19
  60. package/dist/commands/evidence/audit.js +26 -26
  61. package/dist/commands/evidence/baseline.js +21 -21
  62. package/dist/commands/evidence/gc.js +3 -3
  63. package/dist/commands/evidence/index.js +1 -1
  64. package/dist/commands/evidence/inspect-mocks.js +4 -4
  65. package/dist/commands/evidence/record.d.ts.map +1 -1
  66. package/dist/commands/evidence/record.js +28 -24
  67. package/dist/commands/graph/change-impact.d.ts +16 -0
  68. package/dist/commands/graph/change-impact.d.ts.map +1 -0
  69. package/dist/commands/graph/change-impact.js +29 -0
  70. package/dist/commands/graph/churn.d.ts +14 -0
  71. package/dist/commands/graph/churn.d.ts.map +1 -0
  72. package/dist/commands/graph/churn.js +15 -0
  73. package/dist/commands/graph/common.d.ts +16 -0
  74. package/dist/commands/graph/common.d.ts.map +1 -0
  75. package/dist/commands/graph/fan-out.d.ts +14 -0
  76. package/dist/commands/graph/fan-out.d.ts.map +1 -0
  77. package/dist/commands/graph/fan-out.js +15 -0
  78. package/dist/commands/graph/index.d.ts +8 -0
  79. package/dist/commands/graph/index.d.ts.map +1 -0
  80. package/dist/commands/graph/index.js +12 -0
  81. package/dist/commands/matrix.js +1 -1
  82. package/dist/commands/measurement/index.js +1 -1
  83. package/dist/commands/measurement/intervention.d.ts +11 -0
  84. package/dist/commands/measurement/intervention.d.ts.map +1 -0
  85. package/dist/commands/measurement/intervention.js +31 -0
  86. package/dist/commands/measurement/operational-release.d.ts +11 -0
  87. package/dist/commands/measurement/operational-release.d.ts.map +1 -0
  88. package/dist/commands/measurement/operational-release.js +31 -0
  89. package/dist/commands/measurement/record.d.ts.map +1 -1
  90. package/dist/commands/measurement/record.js +12 -11
  91. package/dist/commands/module/ensure-defaults.js +3 -3
  92. package/dist/commands/module/install.js +2 -2
  93. package/dist/commands/module/list.js +2 -2
  94. package/dist/commands/module/remove.js +2 -2
  95. package/dist/commands/report.d.ts +4 -0
  96. package/dist/commands/report.d.ts.map +1 -1
  97. package/dist/commands/report.js +49 -23
  98. package/dist/commands/review.js +1 -1
  99. package/dist/commands/to-plan.js +1 -1
  100. package/dist/commands/update.js +2 -2
  101. package/dist/commands/validate.js +1 -1
  102. package/dist/commands/write.js +3 -3
  103. package/dist/common-B1ZJ8CSO.js +36 -0
  104. package/dist/common-DTrmnvL-.js +35 -0
  105. package/dist/{completeness-DamWradt.js → completeness-BzBuNq6w.js} +1 -1
  106. package/dist/evidence/adapters/contract-conformance.d.ts +16 -0
  107. package/dist/evidence/adapters/contract-conformance.d.ts.map +1 -0
  108. package/dist/evidence/adapters/differential-report.d.ts +18 -0
  109. package/dist/evidence/adapters/differential-report.d.ts.map +1 -0
  110. package/dist/evidence/adapters/registry.d.ts.map +1 -1
  111. package/dist/evidence/adapters/types.d.ts +31 -0
  112. package/dist/evidence/adapters/types.d.ts.map +1 -1
  113. package/dist/evidence/index.d.ts +5 -2
  114. package/dist/evidence/index.d.ts.map +1 -1
  115. package/dist/{evidence-DD0CHzJ0.js → evidence-OyqpqHLS.js} +191 -110
  116. package/dist/{flow-command-BfFNY0Rv.js → flow-command-CCRTE5Oe.js} +7 -7
  117. package/dist/graph-analysis/analysis.d.ts +106 -0
  118. package/dist/graph-analysis/analysis.d.ts.map +1 -0
  119. package/dist/graph-analysis/index.d.ts +6 -0
  120. package/dist/graph-analysis/index.d.ts.map +1 -0
  121. package/dist/graph-analysis/input.d.ts +33 -0
  122. package/dist/graph-analysis/input.d.ts.map +1 -0
  123. package/dist/graph-analysis/load.d.ts +21 -0
  124. package/dist/graph-analysis/load.d.ts.map +1 -0
  125. package/dist/graph-analysis/render.d.ts +4 -0
  126. package/dist/graph-analysis/render.d.ts.map +1 -0
  127. package/dist/graph-analysis-IWaoJJSN.js +657 -0
  128. package/dist/index.d.ts +1 -0
  129. package/dist/index.d.ts.map +1 -1
  130. package/dist/index.js +11 -9
  131. package/dist/measurement/agent-eval-intervention.d.ts +6 -0
  132. package/dist/measurement/agent-eval-intervention.d.ts.map +1 -0
  133. package/dist/measurement/atomic-file.d.ts +5 -0
  134. package/dist/measurement/atomic-file.d.ts.map +1 -0
  135. package/dist/measurement/date-time.d.ts +3 -0
  136. package/dist/measurement/date-time.d.ts.map +1 -0
  137. package/dist/measurement/github-release-operational.d.ts +7 -0
  138. package/dist/measurement/github-release-operational.d.ts.map +1 -0
  139. package/dist/measurement/graph-adapters.d.ts +304 -0
  140. package/dist/measurement/graph-adapters.d.ts.map +1 -0
  141. package/dist/measurement/graph-portfolio-load.d.ts +3 -0
  142. package/dist/measurement/graph-portfolio-load.d.ts.map +1 -0
  143. package/dist/measurement/graph-portfolio.d.ts +158 -0
  144. package/dist/measurement/graph-portfolio.d.ts.map +1 -0
  145. package/dist/measurement/index.d.ts +15 -2
  146. package/dist/measurement/index.d.ts.map +1 -1
  147. package/dist/measurement/intervention-report.d.ts +24 -0
  148. package/dist/measurement/intervention-report.d.ts.map +1 -0
  149. package/dist/measurement/intervention-schema.d.ts +144 -0
  150. package/dist/measurement/intervention-schema.d.ts.map +1 -0
  151. package/dist/measurement/intervention-types.d.ts +105 -0
  152. package/dist/measurement/intervention-types.d.ts.map +1 -0
  153. package/dist/measurement/intervention.d.ts +16 -0
  154. package/dist/measurement/intervention.d.ts.map +1 -0
  155. package/dist/measurement/operational-report.d.ts +17 -0
  156. package/dist/measurement/operational-report.d.ts.map +1 -0
  157. package/dist/measurement/operational-schema.d.ts +461 -0
  158. package/dist/measurement/operational-schema.d.ts.map +1 -0
  159. package/dist/measurement/operational-types.d.ts +121 -0
  160. package/dist/measurement/operational-types.d.ts.map +1 -0
  161. package/dist/measurement/operational.d.ts +13 -0
  162. package/dist/measurement/operational.d.ts.map +1 -0
  163. package/dist/measurement/plans.d.ts +3 -1
  164. package/dist/measurement/plans.d.ts.map +1 -1
  165. package/dist/measurement/portfolio.d.ts +7 -1
  166. package/dist/measurement/portfolio.d.ts.map +1 -1
  167. package/dist/measurement/report.d.ts +4 -0
  168. package/dist/measurement/report.d.ts.map +1 -1
  169. package/dist/measurement/schemas/operational-evidence-v1.schema.json.d.ts +384 -0
  170. package/dist/measurement/store.d.ts +7 -0
  171. package/dist/measurement/store.d.ts.map +1 -1
  172. package/dist/measurement/types.d.ts +2 -0
  173. package/dist/measurement/types.d.ts.map +1 -1
  174. package/dist/measurement-j8sDSqx5.js +2980 -0
  175. package/dist/{modules-ez9httBA.js → modules-DDQkKC4l.js} +2 -2
  176. package/dist/{plugins-C-ta0llj.js → plugins-CHpYhpEI.js} +1 -1
  177. package/dist/quire/assurance.d.ts +109 -0
  178. package/dist/quire/assurance.d.ts.map +1 -0
  179. package/dist/quire/contract.d.ts +2 -1
  180. package/dist/quire/contract.d.ts.map +1 -1
  181. package/dist/quire/index.d.ts +3 -2
  182. package/dist/quire/index.d.ts.map +1 -1
  183. package/dist/quire/validate.d.ts +5 -0
  184. package/dist/quire/validate.d.ts.map +1 -1
  185. package/dist/{quire-D8tCpgyA.js → quire-BsVj1xIR.js} +54 -47
  186. package/dist/schema-assets-HZWo_iFN.js +233 -0
  187. package/dist/schemas/assurance-v1.schema.json +225 -0
  188. package/dist/schemas/change-assurance-record-v1.schema.json +234 -0
  189. package/dist/schemas/operational-evidence-v1.schema.json +381 -0
  190. package/dist/schemas/proof-attestation-v1.schema.json +96 -0
  191. package/dist/schemas/verification-receipt-v1.schema.json +208 -0
  192. package/dist/{version-Dg0e6CZU.js → version-CMxMIh5g.js} +1 -1
  193. package/dist/{write-DElwS9xc.js → write-CGTI0dRO.js} +1 -1
  194. package/package.json +5 -1
  195. package/skills/gap-analysis/references/step-4-underspecified-code.md +36 -7
  196. package/skills/gap-analysis/references/step-5-semantic-review.md +2 -2
  197. package/skills/gap-analysis/references/step-6-specreview-artifact.md +6 -5
  198. package/skills/spec-fuzz/SKILL.md +7 -6
  199. package/dist/measurement-CzB74Q07.js +0 -595
  200. package/dist/store--2sAv12X.js +0 -219
@@ -1,4 +1,4 @@
1
- import { i as e } from "./base-CqKNs2Kd.js";
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.22.5",
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
- Reuse the detection heuristics in
9
- `~/dev/agent_skills/implementation-gap-analysis/SKILL.md` — don't reinvent them.
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 (per the
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 (`{}`,`[]`,`None`,`"not implemented"`) body | grep/AST | high |
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, and stubs, each with
58
- `Refs` = code location, plus a count of untraced behaviors/stubs for `## Coverage`.
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 the implementation-gap-analysis **test-stub / coverage-inflation**
25
- heuristics: no assertions, weak-only assertions (`is not None`, `isinstance`),
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
- ## Fetch the template, then author (guardrail)
6
+ ## Render the template, then author (guardrail)
7
7
 
8
- The `SpecReview` archetype lives in `spec-artifacts-process`. Fetch its skeleton first, then
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 in the working tree, read the skeleton directly from
16
- `~/.ix/filament/modules/spec-artifacts-process/skeletons/SpecReview.md`.
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: Turn Fuzz-kind obligations into runnable fuzz targets. Consumes `quoin advise
4
- --json`, selects the obligations whose verification method carries `evidence_kind: Fuzz`,
5
- grounds each one's entry-point symbol in the repository's source, and emits targets in the
6
- repo's own harness (cargo-fuzz / atheris / fast-check) keyed on the obligation id. Writes
7
- nothing where the tooling is absent or the entry point cannot be grounded — a finding
8
- instead. Emits a validated SpecReview recording every obligation it could not serve.
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