@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
@@ -0,0 +1,233 @@
1
+ import { fileURLToPath as e } from "node:url";
2
+ import { existsSync as t, mkdirSync as n, readFileSync as r, readdirSync as i, rmSync as a, writeFileSync as o } from "node:fs";
3
+ import { dirname as s, join as c } from "node:path";
4
+ //#region src/evidence/types.ts
5
+ var l = "runs", u = "scans", d = "mock-inspections", f = "mutation-score";
6
+ //#endregion
7
+ //#region src/evidence/store.ts
8
+ function p(e) {
9
+ return c(e, "spec", "evidence");
10
+ }
11
+ function m(e) {
12
+ return c(p(e), "bindings.json");
13
+ }
14
+ function h(e) {
15
+ return c(p(e), "baseline.json");
16
+ }
17
+ function g(e, t, n) {
18
+ return c(p(e), l, t, `${y(n)}.json`);
19
+ }
20
+ function _(e, t, n) {
21
+ return c(p(e), u, t, `${y(n)}.json`);
22
+ }
23
+ function v(e, t, n) {
24
+ return c(p(e), d, t, `${y(n)}.json`);
25
+ }
26
+ function y(e) {
27
+ return e.slice(0, 12);
28
+ }
29
+ function b(e) {
30
+ return `${JSON.stringify(x(e), null, 2)}\n`;
31
+ }
32
+ function x(e) {
33
+ if (Array.isArray(e)) return e.map(x);
34
+ if (typeof e != "object" || !e) return e;
35
+ let t = {};
36
+ for (let n of Object.keys(e).sort()) t[n] = x(e[n]);
37
+ return t;
38
+ }
39
+ function S(e, t) {
40
+ n(s(e), { recursive: !0 }), o(e, b(t), "utf8");
41
+ }
42
+ var C = class extends Error {
43
+ path;
44
+ cause;
45
+ constructor(e, t) {
46
+ let n = t instanceof Error ? t.message : String(t);
47
+ super(`${e} exists but is not readable JSON: ${n}. A merge conflict in a checked-in store file is the usual cause — resolve it, or delete the file to start from an empty store.`), this.path = e, this.cause = t, this.name = "StoreReadError";
48
+ }
49
+ };
50
+ function w(e) {
51
+ if (!t(e)) return null;
52
+ try {
53
+ return JSON.parse(r(e, "utf8"));
54
+ } catch (t) {
55
+ throw new C(e, t);
56
+ }
57
+ }
58
+ function T(e, t) {
59
+ try {
60
+ return w(e);
61
+ } catch (n) {
62
+ if (n instanceof C) return t.push(e), null;
63
+ throw n;
64
+ }
65
+ }
66
+ function E(e, t) {
67
+ let n = g(e, t.suite, t.commit);
68
+ return S(n, {
69
+ ...t,
70
+ schemaVersion: 1
71
+ }), n;
72
+ }
73
+ function D(e, t) {
74
+ let n = _(e, t.suite, t.commit);
75
+ return S(n, {
76
+ ...t,
77
+ schemaVersion: 1
78
+ }), n;
79
+ }
80
+ function O(e, t) {
81
+ let n = v(e, t.suite, t.commit);
82
+ return S(n, {
83
+ ...t,
84
+ schemaVersion: 1
85
+ }), n;
86
+ }
87
+ function k(e, t, n) {
88
+ return w(v(e, t, n));
89
+ }
90
+ function A(e, n) {
91
+ let r = c(p(e), u, n);
92
+ return t(r) ? i(r).filter((e) => e.endsWith(".json")).sort() : [];
93
+ }
94
+ function j(e, t, n = []) {
95
+ return A(e, t).map((r) => T(_(e, t, r.replace(/\.json$/, "")), n)).filter((e) => e !== null).sort((e, t) => z(e.timestamp, t.timestamp) || z(e.commit, t.commit));
96
+ }
97
+ function M(e, t, n = []) {
98
+ return j(e, t, n).at(-1) ?? null;
99
+ }
100
+ function N(e) {
101
+ return e.rulesEvaluated === void 0 ? null : e.rulesEvaluated === 0;
102
+ }
103
+ function P(e, n) {
104
+ let r = c(p(e), l, n);
105
+ return t(r) ? i(r).filter((e) => e.endsWith(".json")).sort() : [];
106
+ }
107
+ function F(e, t, n = []) {
108
+ return P(e, t).map((r) => T(g(e, t, r.replace(/\.json$/, "")), n)).filter((e) => e !== null).sort((e, t) => z(e.timestamp, t.timestamp) || z(e.commit, t.commit));
109
+ }
110
+ function I(e, t, n = []) {
111
+ return F(e, t, n).at(-1) ?? null;
112
+ }
113
+ function L(e) {
114
+ return B(e).map((t) => I(e, t)).filter((e) => e !== null);
115
+ }
116
+ function R(e) {
117
+ return B(e).map((t) => M(e, t)).filter((e) => e !== null);
118
+ }
119
+ function z(e, t) {
120
+ return e === t ? 0 : e < t ? -1 : 1;
121
+ }
122
+ function B(e) {
123
+ let n = /* @__PURE__ */ new Set();
124
+ for (let r of [
125
+ l,
126
+ u,
127
+ d
128
+ ]) {
129
+ let a = c(p(e), r);
130
+ if (t(a)) for (let e of i(a, { withFileTypes: !0 })) e.isDirectory() && n.add(e.name);
131
+ }
132
+ return [...n].sort();
133
+ }
134
+ function V(e) {
135
+ return w(m(e)) ?? {
136
+ schemaVersion: 1,
137
+ bindings: []
138
+ };
139
+ }
140
+ function H(e, t) {
141
+ let n = [...t.bindings].sort(K);
142
+ S(m(e), {
143
+ schemaVersion: 1,
144
+ bindings: n
145
+ });
146
+ }
147
+ function U(e) {
148
+ return w(h(e));
149
+ }
150
+ function W(e, t) {
151
+ S(h(e), {
152
+ schemaVersion: 1,
153
+ commit: t.commit,
154
+ accepted: [...t.accepted].sort(z)
155
+ });
156
+ }
157
+ function G(e, t = !1) {
158
+ let n = new Set(V(e).bindings.map((e) => `${e.suite}/${y(e.commit)}.json`)), r = [];
159
+ for (let i of B(e)) {
160
+ let o = P(e, i), s = /* @__PURE__ */ new Set(), d = I(e, i);
161
+ d && s.add(`${y(d.commit)}.json`);
162
+ for (let u of o) {
163
+ if (s.has(u) || n.has(`${i}/${u}`)) continue;
164
+ let o = c(p(e), l, i, u);
165
+ r.push(o), t || a(o);
166
+ }
167
+ let f = A(e, i), m = /* @__PURE__ */ new Set(), h = M(e, i);
168
+ h && m.add(`${y(h.commit)}.json`);
169
+ for (let o of f) {
170
+ if (m.has(o) || n.has(`${i}/${o}`)) continue;
171
+ let s = c(p(e), u, i, o);
172
+ r.push(s), t || a(s);
173
+ }
174
+ }
175
+ return r.sort();
176
+ }
177
+ function K(e, t) {
178
+ return e.obligation === t.obligation ? e.suite === t.suite ? 0 : e.suite < t.suite ? -1 : 1 : e.obligation < t.obligation ? -1 : 1;
179
+ }
180
+ function q(e, t) {
181
+ let n = e.findIndex((e) => e.obligation === t.obligation && e.suite === t.suite);
182
+ if (n === -1) return {
183
+ bindings: [...e, { ...t }],
184
+ created: !0,
185
+ suspect: !1
186
+ };
187
+ let r = e[n], i = r.statementHashAtBinding !== t.statementHashAtBinding, a = {
188
+ ...r,
189
+ commit: t.commit,
190
+ symbols: t.symbols
191
+ }, o = [...e];
192
+ return o[n] = a, {
193
+ bindings: o,
194
+ created: !1,
195
+ suspect: i
196
+ };
197
+ }
198
+ function J(e, t, n, r, i, a, o) {
199
+ let s = e.map((e, t) => [e, t]).filter(([e]) => e.obligation === t && (!o || e.suite === o));
200
+ if (s.length === 0) return {
201
+ bindings: e,
202
+ found: !1
203
+ };
204
+ let c = [...e];
205
+ for (let [e, t] of s) c[t] = {
206
+ ...e,
207
+ statementHashAtBinding: n,
208
+ affirmations: [...e.affirmations ?? [], {
209
+ who: r,
210
+ commit: i,
211
+ note: a
212
+ }]
213
+ };
214
+ return {
215
+ bindings: c,
216
+ found: !0
217
+ };
218
+ }
219
+ //#endregion
220
+ //#region src/change-assurance/schema-assets.ts
221
+ var Y = [
222
+ "change-assurance-record-v1.schema.json",
223
+ "proof-attestation-v1.schema.json",
224
+ "verification-receipt-v1.schema.json"
225
+ ], X = s(e(import.meta.url));
226
+ function Z(e) {
227
+ return c(X, "schemas", e);
228
+ }
229
+ function Q(e) {
230
+ return JSON.parse(r(Z(e), "utf8"));
231
+ }
232
+ //#endregion
233
+ export { E as C, O as S, f as T, k as _, h as a, W as b, b as c, L as d, M as f, V as g, U as h, J as i, G as l, B as m, Z as n, q as o, R as p, Q as r, m as s, Y as t, I as u, N as v, D as w, H as x, p as y };
@@ -0,0 +1,225 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://agent-ix.github.io/quire-rs/schemas/output/assurance-v1.schema.json",
4
+ "title": "Quire source-grounded assurance export v1",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": [
8
+ "format",
9
+ "format_version",
10
+ "source",
11
+ "modules",
12
+ "artifacts",
13
+ "obligations",
14
+ "symbols",
15
+ "relation_kinds",
16
+ "relations",
17
+ "relation_observations"
18
+ ],
19
+ "properties": {
20
+ "format": { "const": "quire-assurance" },
21
+ "format_version": { "const": 1 },
22
+ "source": { "$ref": "#/$defs/sourcePremise" },
23
+ "modules": {
24
+ "type": "array",
25
+ "items": { "$ref": "#/$defs/modulePremise" }
26
+ },
27
+ "artifacts": {
28
+ "type": "array",
29
+ "items": { "$ref": "#/$defs/artifact" }
30
+ },
31
+ "obligations": {
32
+ "type": "array",
33
+ "items": { "$ref": "#/$defs/obligation" }
34
+ },
35
+ "symbols": {
36
+ "type": "array",
37
+ "items": { "$ref": "#/$defs/symbol" }
38
+ },
39
+ "relation_kinds": {
40
+ "type": "array",
41
+ "items": { "$ref": "#/$defs/relationKind" }
42
+ },
43
+ "relations": {
44
+ "type": "array",
45
+ "items": {
46
+ "oneOf": [
47
+ { "$ref": "#/$defs/corpusRelation" },
48
+ { "$ref": "#/$defs/verifiesRelation" },
49
+ { "$ref": "#/$defs/implementsRelation" }
50
+ ]
51
+ }
52
+ },
53
+ "relation_observations": {
54
+ "type": "array",
55
+ "items": { "$ref": "#/$defs/relationObservation" }
56
+ }
57
+ },
58
+ "$defs": {
59
+ "sha256": {
60
+ "type": "string",
61
+ "pattern": "^[0-9a-f]{64}$"
62
+ },
63
+ "sourcePremise": {
64
+ "type": "object",
65
+ "additionalProperties": false,
66
+ "required": ["repository", "revision"],
67
+ "properties": {
68
+ "repository": { "type": "string", "minLength": 1 },
69
+ "revision": { "type": "string", "pattern": "^[0-9a-f]{40}$" }
70
+ }
71
+ },
72
+ "schemaPremise": {
73
+ "type": "object",
74
+ "additionalProperties": false,
75
+ "required": ["archetype", "schema_digest"],
76
+ "properties": {
77
+ "archetype": { "type": "string", "minLength": 1 },
78
+ "schema_digest": { "$ref": "#/$defs/sha256" }
79
+ }
80
+ },
81
+ "modulePremise": {
82
+ "type": "object",
83
+ "additionalProperties": false,
84
+ "required": ["name", "version", "schemas"],
85
+ "properties": {
86
+ "name": { "type": "string", "minLength": 1 },
87
+ "version": { "type": "string", "minLength": 1 },
88
+ "schemas": {
89
+ "type": "array",
90
+ "items": { "$ref": "#/$defs/schemaPremise" }
91
+ }
92
+ }
93
+ },
94
+ "locator": {
95
+ "type": "object",
96
+ "additionalProperties": false,
97
+ "required": ["path", "line", "digest"],
98
+ "properties": {
99
+ "path": { "type": "string", "minLength": 1, "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+$" },
100
+ "line": { "type": "integer", "minimum": 1 },
101
+ "digest": { "$ref": "#/$defs/sha256" }
102
+ }
103
+ },
104
+ "artifact": {
105
+ "type": "object",
106
+ "additionalProperties": false,
107
+ "required": ["id", "artifact_type", "locator"],
108
+ "properties": {
109
+ "id": { "type": "string", "minLength": 1 },
110
+ "uuid": { "type": "string", "format": "uuid" },
111
+ "artifact_type": { "type": "string", "minLength": 1 },
112
+ "locator": { "$ref": "#/$defs/locator" }
113
+ }
114
+ },
115
+ "obligation": {
116
+ "type": "object",
117
+ "additionalProperties": false,
118
+ "required": ["source", "id", "document", "statement", "statement_hash", "target_ids", "locator"],
119
+ "properties": {
120
+ "source": { "type": "string", "minLength": 1 },
121
+ "id": { "type": "string", "minLength": 1 },
122
+ "document": { "type": "string", "minLength": 1 },
123
+ "statement": { "type": "string", "minLength": 1 },
124
+ "statement_hash": { "$ref": "#/$defs/sha256" },
125
+ "method": { "type": "string", "minLength": 1 },
126
+ "parameters": {
127
+ "type": "object",
128
+ "additionalProperties": { "type": "string" }
129
+ },
130
+ "criticality": { "type": "string", "minLength": 1 },
131
+ "target_ids": { "type": "array", "items": { "type": "string", "minLength": 1 } },
132
+ "locator": { "$ref": "#/$defs/locator" }
133
+ }
134
+ },
135
+ "symbol": {
136
+ "type": "object",
137
+ "additionalProperties": false,
138
+ "required": ["id", "language", "kind", "qualified_name", "container", "capabilities", "locator"],
139
+ "properties": {
140
+ "id": { "$ref": "#/$defs/sha256" },
141
+ "language": { "enum": ["rust", "python", "typescript"] },
142
+ "kind": { "enum": ["function", "test_function", "container", "benchmark", "fuzz_target"] },
143
+ "qualified_name": { "type": "string", "minLength": 1 },
144
+ "container": { "type": ["string", "null"] },
145
+ "capabilities": {
146
+ "type": "array",
147
+ "items": { "enum": ["verifies", "implements"] },
148
+ "uniqueItems": true
149
+ },
150
+ "locator": { "$ref": "#/$defs/locator" }
151
+ }
152
+ },
153
+ "freshness": {
154
+ "enum": ["current", "suspect", "unknown", "not_applicable"]
155
+ },
156
+ "relationKind": {
157
+ "type": "object",
158
+ "additionalProperties": false,
159
+ "required": ["kind", "availability", "sources"],
160
+ "properties": {
161
+ "kind": { "type": "string", "minLength": 1 },
162
+ "availability": { "const": "available" },
163
+ "sources": {
164
+ "type": "array",
165
+ "items": { "enum": ["module_vocabulary", "required_relation", "trace_binding", "observed"] },
166
+ "minItems": 1,
167
+ "uniqueItems": true
168
+ }
169
+ }
170
+ },
171
+ "corpusRelation": {
172
+ "type": "object",
173
+ "additionalProperties": false,
174
+ "required": ["kind", "source", "target", "edge_type", "resolution", "locator", "freshness"],
175
+ "properties": {
176
+ "kind": { "const": "corpus" },
177
+ "source": { "type": "string", "minLength": 1 },
178
+ "target": { "type": "string", "minLength": 1 },
179
+ "edge_type": { "type": "string", "minLength": 1 },
180
+ "resolution": { "enum": ["resolved", "dangling"] },
181
+ "locator": { "$ref": "#/$defs/locator" },
182
+ "freshness": { "$ref": "#/$defs/freshness" }
183
+ }
184
+ },
185
+ "verifiesRelation": {
186
+ "type": "object",
187
+ "additionalProperties": false,
188
+ "required": ["kind", "source", "target", "form", "provenance", "locator", "freshness"],
189
+ "properties": {
190
+ "kind": { "const": "verifies" },
191
+ "source": { "$ref": "#/$defs/sha256" },
192
+ "target": { "type": "string", "minLength": 1 },
193
+ "form": { "type": "string", "minLength": 1 },
194
+ "provenance": { "enum": ["canonical", "legacy"] },
195
+ "locator": { "$ref": "#/$defs/locator" },
196
+ "freshness": { "$ref": "#/$defs/freshness" }
197
+ }
198
+ },
199
+ "implementsRelation": {
200
+ "type": "object",
201
+ "additionalProperties": false,
202
+ "required": ["kind", "source", "target", "form", "locator", "freshness"],
203
+ "properties": {
204
+ "kind": { "const": "implements" },
205
+ "source": { "$ref": "#/$defs/sha256" },
206
+ "target": { "type": "string", "minLength": 1 },
207
+ "form": { "type": "string", "minLength": 1 },
208
+ "locator": { "$ref": "#/$defs/locator" },
209
+ "freshness": { "$ref": "#/$defs/freshness" }
210
+ }
211
+ },
212
+ "relationObservation": {
213
+ "type": "object",
214
+ "additionalProperties": false,
215
+ "required": ["declaration", "availability", "freshness"],
216
+ "properties": {
217
+ "declaration": { "type": "string", "minLength": 1 },
218
+ "subject": { "type": "string", "minLength": 1 },
219
+ "availability": { "enum": ["available", "missing", "not_applicable", "unknown"] },
220
+ "freshness": { "$ref": "#/$defs/freshness" },
221
+ "reason": { "type": "string", "minLength": 1 }
222
+ }
223
+ }
224
+ }
225
+ }
@@ -0,0 +1,234 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://agent-ix.github.io/quoin/schemas/change-assurance-record-v1.schema.json",
4
+ "title": "ChangeAssuranceRecordV1",
5
+ "type": "object",
6
+ "required": [
7
+ "schema_version",
8
+ "record_type",
9
+ "record_id",
10
+ "revision",
11
+ "parent_digest",
12
+ "digest",
13
+ "subject",
14
+ "source_connections",
15
+ "impact_snapshot",
16
+ "definition",
17
+ "review_workflow"
18
+ ],
19
+ "properties": {
20
+ "schema_version": { "const": 1 },
21
+ "record_type": { "const": "change_assurance" },
22
+ "record_id": { "$ref": "#/$defs/identity" },
23
+ "revision": { "type": "integer", "minimum": 1 },
24
+ "parent_digest": {
25
+ "anyOf": [{ "$ref": "#/$defs/digest" }, { "type": "null" }]
26
+ },
27
+ "digest": { "$ref": "#/$defs/digest" },
28
+ "subject": {
29
+ "type": "object",
30
+ "required": ["repository", "base_revision", "scope"],
31
+ "properties": {
32
+ "repository": { "type": "string", "minLength": 1 },
33
+ "base_revision": { "type": "string", "minLength": 1 },
34
+ "scope": {
35
+ "type": "array",
36
+ "minItems": 1,
37
+ "uniqueItems": true,
38
+ "items": { "type": "string", "minLength": 1 }
39
+ }
40
+ },
41
+ "additionalProperties": false
42
+ },
43
+ "source_connections": {
44
+ "type": "array",
45
+ "minItems": 1,
46
+ "items": { "$ref": "#/$defs/source_connection" }
47
+ },
48
+ "impact_snapshot": {
49
+ "type": "object",
50
+ "required": [
51
+ "identity",
52
+ "revision",
53
+ "digest",
54
+ "completeness",
55
+ "truncated",
56
+ "gaps"
57
+ ],
58
+ "properties": {
59
+ "identity": { "$ref": "#/$defs/identity" },
60
+ "revision": { "type": "string", "minLength": 1 },
61
+ "digest": { "$ref": "#/$defs/digest" },
62
+ "completeness": {
63
+ "type": "string",
64
+ "enum": ["complete", "incomplete"]
65
+ },
66
+ "truncated": { "type": "boolean" },
67
+ "gaps": {
68
+ "type": "array",
69
+ "items": { "type": "string", "minLength": 1 }
70
+ }
71
+ },
72
+ "additionalProperties": false
73
+ },
74
+ "definition": {
75
+ "type": "object",
76
+ "required": [
77
+ "requirements",
78
+ "preservation_constraints",
79
+ "proof_obligations",
80
+ "unknowns"
81
+ ],
82
+ "properties": {
83
+ "requirements": {
84
+ "type": "array",
85
+ "minItems": 1,
86
+ "items": { "$ref": "#/$defs/requirement" }
87
+ },
88
+ "preservation_constraints": {
89
+ "type": "array",
90
+ "items": { "$ref": "#/$defs/preservation_constraint" }
91
+ },
92
+ "proof_obligations": {
93
+ "type": "array",
94
+ "minItems": 1,
95
+ "items": { "$ref": "#/$defs/proof_obligation" }
96
+ },
97
+ "unknowns": {
98
+ "type": "array",
99
+ "items": { "$ref": "#/$defs/unknown" }
100
+ }
101
+ },
102
+ "additionalProperties": false
103
+ },
104
+ "review_workflow": {
105
+ "type": "object",
106
+ "required": ["run_id", "decision_event_kind"],
107
+ "properties": {
108
+ "run_id": { "$ref": "#/$defs/identity" },
109
+ "decision_event_kind": {
110
+ "const": "change_assurance.review_decided"
111
+ }
112
+ },
113
+ "additionalProperties": false
114
+ }
115
+ },
116
+ "$defs": {
117
+ "identity": {
118
+ "type": "string",
119
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,255}$"
120
+ },
121
+ "digest": {
122
+ "type": "string",
123
+ "pattern": "^[a-f0-9]{64}$"
124
+ },
125
+ "source_connection": {
126
+ "type": "object",
127
+ "required": ["source_id", "kind", "revision", "digest"],
128
+ "properties": {
129
+ "source_id": { "$ref": "#/$defs/identity" },
130
+ "kind": {
131
+ "type": "string",
132
+ "enum": [
133
+ "requirement",
134
+ "test",
135
+ "api",
136
+ "architecture",
137
+ "impact_evidence",
138
+ "recovery_evidence",
139
+ "other"
140
+ ]
141
+ },
142
+ "revision": { "type": "string", "minLength": 1 },
143
+ "digest": { "$ref": "#/$defs/digest" }
144
+ },
145
+ "additionalProperties": false
146
+ },
147
+ "requirement": {
148
+ "type": "object",
149
+ "required": ["id", "statement", "source_ids"],
150
+ "properties": {
151
+ "id": { "$ref": "#/$defs/identity" },
152
+ "statement": { "type": "string", "minLength": 1 },
153
+ "source_ids": {
154
+ "type": "array",
155
+ "minItems": 1,
156
+ "uniqueItems": true,
157
+ "items": { "$ref": "#/$defs/identity" }
158
+ }
159
+ },
160
+ "additionalProperties": false
161
+ },
162
+ "preservation_constraint": {
163
+ "type": "object",
164
+ "required": ["id", "statement", "source_ids"],
165
+ "properties": {
166
+ "id": { "$ref": "#/$defs/identity" },
167
+ "statement": { "type": "string", "minLength": 1 },
168
+ "source_ids": {
169
+ "type": "array",
170
+ "minItems": 1,
171
+ "uniqueItems": true,
172
+ "items": { "$ref": "#/$defs/identity" }
173
+ }
174
+ },
175
+ "additionalProperties": false
176
+ },
177
+ "command": {
178
+ "type": "object",
179
+ "required": ["argv", "working_directory"],
180
+ "properties": {
181
+ "argv": {
182
+ "type": "array",
183
+ "minItems": 1,
184
+ "items": { "type": "string" }
185
+ },
186
+ "working_directory": { "type": "string", "minLength": 1 }
187
+ },
188
+ "additionalProperties": false
189
+ },
190
+ "proof_obligation": {
191
+ "type": "object",
192
+ "required": [
193
+ "proof_id",
194
+ "statement",
195
+ "obligation_ids",
196
+ "evidence_kind",
197
+ "command",
198
+ "tool_identity",
199
+ "configuration_digest"
200
+ ],
201
+ "properties": {
202
+ "proof_id": { "$ref": "#/$defs/identity" },
203
+ "statement": { "type": "string", "minLength": 1 },
204
+ "obligation_ids": {
205
+ "type": "array",
206
+ "minItems": 1,
207
+ "uniqueItems": true,
208
+ "items": { "$ref": "#/$defs/identity" }
209
+ },
210
+ "evidence_kind": { "$ref": "#/$defs/identity" },
211
+ "command": { "$ref": "#/$defs/command" },
212
+ "tool_identity": { "type": "string", "minLength": 1 },
213
+ "configuration_digest": { "$ref": "#/$defs/digest" }
214
+ },
215
+ "additionalProperties": false
216
+ },
217
+ "unknown": {
218
+ "type": "object",
219
+ "required": ["id", "statement", "disposition", "owner"],
220
+ "properties": {
221
+ "id": { "$ref": "#/$defs/identity" },
222
+ "statement": { "type": "string", "minLength": 1 },
223
+ "disposition": {
224
+ "type": "string",
225
+ "enum": ["open", "accepted", "deferred", "resolved"]
226
+ },
227
+ "owner": { "type": "string", "minLength": 1 },
228
+ "resolution": { "type": "string", "minLength": 1 }
229
+ },
230
+ "additionalProperties": false
231
+ }
232
+ },
233
+ "additionalProperties": false
234
+ }