@agent-ix/quoin 0.23.1 → 0.24.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 (516) hide show
  1. package/README.md +8 -258
  2. package/bin/launcher.js +138 -0
  3. package/package.json +22 -123
  4. package/.agents/plugins/marketplace.json +0 -14
  5. package/.claude-plugin/marketplace.json +0 -16
  6. package/.claude-plugin/plugin.json +0 -8
  7. package/.codex-plugin/plugin.json +0 -27
  8. package/.github/plugin/marketplace.json +0 -16
  9. package/bin/quoin.js +0 -21
  10. package/default-modules.yaml +0 -107
  11. package/dist/advisor/advise.d.ts +0 -199
  12. package/dist/advisor/advise.d.ts.map +0 -1
  13. package/dist/advisor/index.d.ts +0 -10
  14. package/dist/advisor/index.d.ts.map +0 -1
  15. package/dist/advisor/methods.d.ts +0 -60
  16. package/dist/advisor/methods.d.ts.map +0 -1
  17. package/dist/advisor-B0rESCx1.js +0 -63
  18. package/dist/assurance/graph.d.ts +0 -87
  19. package/dist/assurance/graph.d.ts.map +0 -1
  20. package/dist/assurance/index.d.ts +0 -9
  21. package/dist/assurance/index.d.ts.map +0 -1
  22. package/dist/assurance/render.d.ts +0 -3
  23. package/dist/assurance/render.d.ts.map +0 -1
  24. package/dist/auditor/audit.d.ts +0 -146
  25. package/dist/auditor/audit.d.ts.map +0 -1
  26. package/dist/auditor/combinatorial.d.ts +0 -53
  27. package/dist/auditor/combinatorial.d.ts.map +0 -1
  28. package/dist/auditor/index.d.ts +0 -9
  29. package/dist/auditor/index.d.ts.map +0 -1
  30. package/dist/auditor-Dd3i9Aqx.js +0 -340
  31. package/dist/base-gAClyCNd.js +0 -137
  32. package/dist/base.d.ts +0 -23
  33. package/dist/base.d.ts.map +0 -1
  34. package/dist/catalog.d.ts +0 -33
  35. package/dist/catalog.d.ts.map +0 -1
  36. package/dist/change-assurance/attestations.d.ts +0 -7
  37. package/dist/change-assurance/attestations.d.ts.map +0 -1
  38. package/dist/change-assurance/index.d.ts +0 -14
  39. package/dist/change-assurance/index.d.ts.map +0 -1
  40. package/dist/change-assurance/integrity.d.ts +0 -11
  41. package/dist/change-assurance/integrity.d.ts.map +0 -1
  42. package/dist/change-assurance/records.d.ts +0 -22
  43. package/dist/change-assurance/records.d.ts.map +0 -1
  44. package/dist/change-assurance/schema-assets.d.ts +0 -8
  45. package/dist/change-assurance/schema-assets.d.ts.map +0 -1
  46. package/dist/change-assurance/store.d.ts +0 -18
  47. package/dist/change-assurance/store.d.ts.map +0 -1
  48. package/dist/change-assurance/types.d.ts +0 -180
  49. package/dist/change-assurance/types.d.ts.map +0 -1
  50. package/dist/change-assurance/verify.d.ts +0 -4
  51. package/dist/change-assurance/verify.d.ts.map +0 -1
  52. package/dist/change-assurance-CyKLPeKa.js +0 -1236
  53. package/dist/cli.d.ts +0 -61
  54. package/dist/cli.d.ts.map +0 -1
  55. package/dist/cli.js +0 -34
  56. package/dist/commands/advise.d.ts +0 -16
  57. package/dist/commands/advise.d.ts.map +0 -1
  58. package/dist/commands/advise.js +0 -234
  59. package/dist/commands/assurance.d.ts +0 -14
  60. package/dist/commands/assurance.d.ts.map +0 -1
  61. package/dist/commands/assurance.js +0 -204
  62. package/dist/commands/catalog/index.d.ts +0 -2
  63. package/dist/commands/catalog/index.d.ts.map +0 -1
  64. package/dist/commands/catalog/index.js +0 -2
  65. package/dist/commands/catalog/list.d.ts +0 -11
  66. package/dist/commands/catalog/list.d.ts.map +0 -1
  67. package/dist/commands/catalog/list.js +0 -22
  68. package/dist/commands/catalog/methods.d.ts +0 -12
  69. package/dist/commands/catalog/methods.d.ts.map +0 -1
  70. package/dist/commands/catalog/methods.js +0 -43
  71. package/dist/commands/catalog/show.d.ts +0 -13
  72. package/dist/commands/catalog/show.d.ts.map +0 -1
  73. package/dist/commands/catalog/show.js +0 -25
  74. package/dist/commands/catalog/validate.d.ts +0 -10
  75. package/dist/commands/catalog/validate.d.ts.map +0 -1
  76. package/dist/commands/catalog/validate.js +0 -27
  77. package/dist/commands/change-assurance/common.d.ts +0 -37
  78. package/dist/commands/change-assurance/common.d.ts.map +0 -1
  79. package/dist/commands/change-assurance/index.d.ts +0 -8
  80. package/dist/commands/change-assurance/index.d.ts.map +0 -1
  81. package/dist/commands/change-assurance/index.js +0 -12
  82. package/dist/commands/change-assurance/intake.d.ts +0 -15
  83. package/dist/commands/change-assurance/intake.d.ts.map +0 -1
  84. package/dist/commands/change-assurance/intake.js +0 -53
  85. package/dist/commands/change-assurance/receipt.d.ts +0 -21
  86. package/dist/commands/change-assurance/receipt.d.ts.map +0 -1
  87. package/dist/commands/change-assurance/receipt.js +0 -99
  88. package/dist/commands/change-assurance/recover.d.ts +0 -13
  89. package/dist/commands/change-assurance/recover.d.ts.map +0 -1
  90. package/dist/commands/change-assurance/recover.js +0 -29
  91. package/dist/commands/change-assurance/schema.d.ts +0 -13
  92. package/dist/commands/change-assurance/schema.d.ts.map +0 -1
  93. package/dist/commands/change-assurance/schema.js +0 -40
  94. package/dist/commands/change-assurance/seal-attestation.d.ts +0 -15
  95. package/dist/commands/change-assurance/seal-attestation.d.ts.map +0 -1
  96. package/dist/commands/change-assurance/seal-attestation.js +0 -58
  97. package/dist/commands/change-assurance/seal-record.d.ts +0 -14
  98. package/dist/commands/change-assurance/seal-record.d.ts.map +0 -1
  99. package/dist/commands/change-assurance/seal-record.js +0 -53
  100. package/dist/commands/change-assurance/verify-receipt.d.ts +0 -13
  101. package/dist/commands/change-assurance/verify-receipt.d.ts.map +0 -1
  102. package/dist/commands/change-assurance/verify-receipt.js +0 -41
  103. package/dist/commands/completeness.d.ts +0 -16
  104. package/dist/commands/completeness.d.ts.map +0 -1
  105. package/dist/commands/completeness.js +0 -49
  106. package/dist/commands/config/doctor.d.ts +0 -7
  107. package/dist/commands/config/doctor.d.ts.map +0 -1
  108. package/dist/commands/config/doctor.js +0 -15
  109. package/dist/commands/config/edit.d.ts +0 -7
  110. package/dist/commands/config/edit.d.ts.map +0 -1
  111. package/dist/commands/config/edit.js +0 -13
  112. package/dist/commands/config/get.d.ts +0 -11
  113. package/dist/commands/config/get.d.ts.map +0 -1
  114. package/dist/commands/config/get.js +0 -20
  115. package/dist/commands/config/index.d.ts +0 -2
  116. package/dist/commands/config/index.d.ts.map +0 -1
  117. package/dist/commands/config/index.js +0 -2
  118. package/dist/commands/config/set.d.ts +0 -12
  119. package/dist/commands/config/set.d.ts.map +0 -1
  120. package/dist/commands/config/set.js +0 -26
  121. package/dist/commands/evidence/affirm.d.ts +0 -17
  122. package/dist/commands/evidence/affirm.d.ts.map +0 -1
  123. package/dist/commands/evidence/affirm.js +0 -65
  124. package/dist/commands/evidence/audit.d.ts +0 -34
  125. package/dist/commands/evidence/audit.d.ts.map +0 -1
  126. package/dist/commands/evidence/audit.js +0 -107
  127. package/dist/commands/evidence/baseline.d.ts +0 -14
  128. package/dist/commands/evidence/baseline.d.ts.map +0 -1
  129. package/dist/commands/evidence/baseline.js +0 -89
  130. package/dist/commands/evidence/gc.d.ts +0 -13
  131. package/dist/commands/evidence/gc.d.ts.map +0 -1
  132. package/dist/commands/evidence/gc.js +0 -35
  133. package/dist/commands/evidence/index.d.ts +0 -8
  134. package/dist/commands/evidence/index.d.ts.map +0 -1
  135. package/dist/commands/evidence/index.js +0 -18
  136. package/dist/commands/evidence/inspect-mocks.d.ts +0 -16
  137. package/dist/commands/evidence/inspect-mocks.d.ts.map +0 -1
  138. package/dist/commands/evidence/inspect-mocks.js +0 -49
  139. package/dist/commands/evidence/record.d.ts +0 -22
  140. package/dist/commands/evidence/record.d.ts.map +0 -1
  141. package/dist/commands/evidence/record.js +0 -144
  142. package/dist/commands/graph/change-impact.d.ts +0 -16
  143. package/dist/commands/graph/change-impact.d.ts.map +0 -1
  144. package/dist/commands/graph/change-impact.js +0 -29
  145. package/dist/commands/graph/churn.d.ts +0 -14
  146. package/dist/commands/graph/churn.d.ts.map +0 -1
  147. package/dist/commands/graph/churn.js +0 -15
  148. package/dist/commands/graph/common.d.ts +0 -16
  149. package/dist/commands/graph/common.d.ts.map +0 -1
  150. package/dist/commands/graph/fan-out.d.ts +0 -14
  151. package/dist/commands/graph/fan-out.d.ts.map +0 -1
  152. package/dist/commands/graph/fan-out.js +0 -15
  153. package/dist/commands/graph/index.d.ts +0 -8
  154. package/dist/commands/graph/index.d.ts.map +0 -1
  155. package/dist/commands/graph/index.js +0 -12
  156. package/dist/commands/matrix.d.ts +0 -14
  157. package/dist/commands/matrix.d.ts.map +0 -1
  158. package/dist/commands/matrix.js +0 -15
  159. package/dist/commands/measurement/index.d.ts +0 -7
  160. package/dist/commands/measurement/index.d.ts.map +0 -1
  161. package/dist/commands/measurement/index.js +0 -11
  162. package/dist/commands/measurement/intervention.d.ts +0 -11
  163. package/dist/commands/measurement/intervention.d.ts.map +0 -1
  164. package/dist/commands/measurement/intervention.js +0 -31
  165. package/dist/commands/measurement/operational-release.d.ts +0 -11
  166. package/dist/commands/measurement/operational-release.d.ts.map +0 -1
  167. package/dist/commands/measurement/operational-release.js +0 -31
  168. package/dist/commands/measurement/record.d.ts +0 -10
  169. package/dist/commands/measurement/record.d.ts.map +0 -1
  170. package/dist/commands/measurement/record.js +0 -36
  171. package/dist/commands/module/ensure-defaults.d.ts +0 -8
  172. package/dist/commands/module/ensure-defaults.d.ts.map +0 -1
  173. package/dist/commands/module/ensure-defaults.js +0 -17
  174. package/dist/commands/module/index.d.ts +0 -2
  175. package/dist/commands/module/index.d.ts.map +0 -1
  176. package/dist/commands/module/index.js +0 -2
  177. package/dist/commands/module/install.d.ts +0 -11
  178. package/dist/commands/module/install.d.ts.map +0 -1
  179. package/dist/commands/module/install.js +0 -22
  180. package/dist/commands/module/list.d.ts +0 -8
  181. package/dist/commands/module/list.d.ts.map +0 -1
  182. package/dist/commands/module/list.js +0 -13
  183. package/dist/commands/module/remove.d.ts +0 -10
  184. package/dist/commands/module/remove.d.ts.map +0 -1
  185. package/dist/commands/module/remove.js +0 -16
  186. package/dist/commands/plugin/deprecation.d.ts +0 -10
  187. package/dist/commands/plugin/deprecation.d.ts.map +0 -1
  188. package/dist/commands/plugin/ensure-defaults.d.ts +0 -8
  189. package/dist/commands/plugin/ensure-defaults.d.ts.map +0 -1
  190. package/dist/commands/plugin/ensure-defaults.js +0 -12
  191. package/dist/commands/plugin/index.d.ts +0 -2
  192. package/dist/commands/plugin/index.d.ts.map +0 -1
  193. package/dist/commands/plugin/index.js +0 -2
  194. package/dist/commands/plugin/install.d.ts +0 -8
  195. package/dist/commands/plugin/install.d.ts.map +0 -1
  196. package/dist/commands/plugin/install.js +0 -12
  197. package/dist/commands/plugin/list.d.ts +0 -8
  198. package/dist/commands/plugin/list.d.ts.map +0 -1
  199. package/dist/commands/plugin/list.js +0 -12
  200. package/dist/commands/plugin/remove.d.ts +0 -8
  201. package/dist/commands/plugin/remove.d.ts.map +0 -1
  202. package/dist/commands/plugin/remove.js +0 -12
  203. package/dist/commands/report.d.ts +0 -19
  204. package/dist/commands/report.d.ts.map +0 -1
  205. package/dist/commands/report.js +0 -96
  206. package/dist/commands/review.d.ts +0 -14
  207. package/dist/commands/review.d.ts.map +0 -1
  208. package/dist/commands/review.js +0 -15
  209. package/dist/commands/to-plan.d.ts +0 -14
  210. package/dist/commands/to-plan.d.ts.map +0 -1
  211. package/dist/commands/to-plan.js +0 -15
  212. package/dist/commands/update.d.ts +0 -13
  213. package/dist/commands/update.d.ts.map +0 -1
  214. package/dist/commands/update.js +0 -34
  215. package/dist/commands/validate.d.ts +0 -13
  216. package/dist/commands/validate.d.ts.map +0 -1
  217. package/dist/commands/validate.js +0 -123
  218. package/dist/commands/write.d.ts +0 -16
  219. package/dist/commands/write.d.ts.map +0 -1
  220. package/dist/commands/write.js +0 -33
  221. package/dist/common-B1ZJ8CSO.js +0 -36
  222. package/dist/common-DTrmnvL-.js +0 -35
  223. package/dist/completeness/assess.d.ts +0 -82
  224. package/dist/completeness/assess.d.ts.map +0 -1
  225. package/dist/completeness/bundle.d.ts +0 -52
  226. package/dist/completeness/bundle.d.ts.map +0 -1
  227. package/dist/completeness/declarations.d.ts +0 -46
  228. package/dist/completeness/declarations.d.ts.map +0 -1
  229. package/dist/completeness/index.d.ts +0 -11
  230. package/dist/completeness/index.d.ts.map +0 -1
  231. package/dist/completeness/run.d.ts +0 -35
  232. package/dist/completeness/run.d.ts.map +0 -1
  233. package/dist/completeness-BzBuNq6w.js +0 -228
  234. package/dist/config-schema-Dp-vlxuR.js +0 -13
  235. package/dist/config-schema.d.ts +0 -52
  236. package/dist/config-schema.d.ts.map +0 -1
  237. package/dist/deprecation-fRxUHoxv.js +0 -4
  238. package/dist/evidence/adapters/agent-eval.d.ts +0 -26
  239. package/dist/evidence/adapters/agent-eval.d.ts.map +0 -1
  240. package/dist/evidence/adapters/audit-script.d.ts +0 -25
  241. package/dist/evidence/adapters/audit-script.d.ts.map +0 -1
  242. package/dist/evidence/adapters/cargo-mutants.d.ts +0 -3
  243. package/dist/evidence/adapters/cargo-mutants.d.ts.map +0 -1
  244. package/dist/evidence/adapters/contract-conformance.d.ts +0 -16
  245. package/dist/evidence/adapters/contract-conformance.d.ts.map +0 -1
  246. package/dist/evidence/adapters/differential-report.d.ts +0 -18
  247. package/dist/evidence/adapters/differential-report.d.ts.map +0 -1
  248. package/dist/evidence/adapters/junit.d.ts +0 -17
  249. package/dist/evidence/adapters/junit.d.ts.map +0 -1
  250. package/dist/evidence/adapters/registry.d.ts +0 -63
  251. package/dist/evidence/adapters/registry.d.ts.map +0 -1
  252. package/dist/evidence/adapters/sarif.d.ts +0 -35
  253. package/dist/evidence/adapters/sarif.d.ts.map +0 -1
  254. package/dist/evidence/adapters/sbom.d.ts +0 -35
  255. package/dist/evidence/adapters/sbom.d.ts.map +0 -1
  256. package/dist/evidence/adapters/types.d.ts +0 -86
  257. package/dist/evidence/adapters/types.d.ts.map +0 -1
  258. package/dist/evidence/index.d.ts +0 -27
  259. package/dist/evidence/index.d.ts.map +0 -1
  260. package/dist/evidence/mock-inspection.d.ts +0 -16
  261. package/dist/evidence/mock-inspection.d.ts.map +0 -1
  262. package/dist/evidence/record.d.ts +0 -58
  263. package/dist/evidence/record.d.ts.map +0 -1
  264. package/dist/evidence/store.d.ts +0 -215
  265. package/dist/evidence/store.d.ts.map +0 -1
  266. package/dist/evidence/types.d.ts +0 -281
  267. package/dist/evidence/types.d.ts.map +0 -1
  268. package/dist/evidence-OyqpqHLS.js +0 -614
  269. package/dist/flow-command-CCRTE5Oe.js +0 -88
  270. package/dist/flow-command.d.ts +0 -25
  271. package/dist/flow-command.d.ts.map +0 -1
  272. package/dist/flows.d.ts +0 -7
  273. package/dist/flows.d.ts.map +0 -1
  274. package/dist/graph-analysis/analysis.d.ts +0 -106
  275. package/dist/graph-analysis/analysis.d.ts.map +0 -1
  276. package/dist/graph-analysis/index.d.ts +0 -6
  277. package/dist/graph-analysis/index.d.ts.map +0 -1
  278. package/dist/graph-analysis/input.d.ts +0 -33
  279. package/dist/graph-analysis/input.d.ts.map +0 -1
  280. package/dist/graph-analysis/load.d.ts +0 -21
  281. package/dist/graph-analysis/load.d.ts.map +0 -1
  282. package/dist/graph-analysis/render.d.ts +0 -4
  283. package/dist/graph-analysis/render.d.ts.map +0 -1
  284. package/dist/graph-analysis-IWaoJJSN.js +0 -657
  285. package/dist/hooks/command-not-found.d.ts +0 -23
  286. package/dist/hooks/command-not-found.d.ts.map +0 -1
  287. package/dist/hooks/command-not-found.js +0 -8
  288. package/dist/index.d.ts +0 -13
  289. package/dist/index.d.ts.map +0 -1
  290. package/dist/index.js +0 -12
  291. package/dist/measurement/agent-eval-intervention.d.ts +0 -6
  292. package/dist/measurement/agent-eval-intervention.d.ts.map +0 -1
  293. package/dist/measurement/atomic-file.d.ts +0 -5
  294. package/dist/measurement/atomic-file.d.ts.map +0 -1
  295. package/dist/measurement/compare.d.ts +0 -4
  296. package/dist/measurement/compare.d.ts.map +0 -1
  297. package/dist/measurement/date-time.d.ts +0 -3
  298. package/dist/measurement/date-time.d.ts.map +0 -1
  299. package/dist/measurement/github-release-operational.d.ts +0 -7
  300. package/dist/measurement/github-release-operational.d.ts.map +0 -1
  301. package/dist/measurement/graph-adapters.d.ts +0 -304
  302. package/dist/measurement/graph-adapters.d.ts.map +0 -1
  303. package/dist/measurement/graph-portfolio-load.d.ts +0 -3
  304. package/dist/measurement/graph-portfolio-load.d.ts.map +0 -1
  305. package/dist/measurement/graph-portfolio.d.ts +0 -158
  306. package/dist/measurement/graph-portfolio.d.ts.map +0 -1
  307. package/dist/measurement/index.d.ts +0 -22
  308. package/dist/measurement/index.d.ts.map +0 -1
  309. package/dist/measurement/intervention-report.d.ts +0 -24
  310. package/dist/measurement/intervention-report.d.ts.map +0 -1
  311. package/dist/measurement/intervention-schema.d.ts +0 -144
  312. package/dist/measurement/intervention-schema.d.ts.map +0 -1
  313. package/dist/measurement/intervention-types.d.ts +0 -105
  314. package/dist/measurement/intervention-types.d.ts.map +0 -1
  315. package/dist/measurement/intervention.d.ts +0 -16
  316. package/dist/measurement/intervention.d.ts.map +0 -1
  317. package/dist/measurement/operational-report.d.ts +0 -17
  318. package/dist/measurement/operational-report.d.ts.map +0 -1
  319. package/dist/measurement/operational-schema.d.ts +0 -461
  320. package/dist/measurement/operational-schema.d.ts.map +0 -1
  321. package/dist/measurement/operational-types.d.ts +0 -121
  322. package/dist/measurement/operational-types.d.ts.map +0 -1
  323. package/dist/measurement/operational.d.ts +0 -13
  324. package/dist/measurement/operational.d.ts.map +0 -1
  325. package/dist/measurement/plans.d.ts +0 -6
  326. package/dist/measurement/plans.d.ts.map +0 -1
  327. package/dist/measurement/portfolio.d.ts +0 -54
  328. package/dist/measurement/portfolio.d.ts.map +0 -1
  329. package/dist/measurement/profiles.d.ts +0 -9
  330. package/dist/measurement/profiles.d.ts.map +0 -1
  331. package/dist/measurement/report.d.ts +0 -48
  332. package/dist/measurement/report.d.ts.map +0 -1
  333. package/dist/measurement/schemas/operational-evidence-v1.schema.json.d.ts +0 -384
  334. package/dist/measurement/store.d.ts +0 -14
  335. package/dist/measurement/store.d.ts.map +0 -1
  336. package/dist/measurement/types.d.ts +0 -85
  337. package/dist/measurement/types.d.ts.map +0 -1
  338. package/dist/measurement/validate.d.ts +0 -9
  339. package/dist/measurement/validate.d.ts.map +0 -1
  340. package/dist/measurement-j8sDSqx5.js +0 -2980
  341. package/dist/modules-DDQkKC4l.js +0 -23
  342. package/dist/modules.d.ts +0 -10
  343. package/dist/modules.d.ts.map +0 -1
  344. package/dist/org.d.ts +0 -61
  345. package/dist/org.d.ts.map +0 -1
  346. package/dist/plugins-CHpYhpEI.js +0 -77
  347. package/dist/plugins.d.ts +0 -13
  348. package/dist/plugins.d.ts.map +0 -1
  349. package/dist/quire/assurance.d.ts +0 -109
  350. package/dist/quire/assurance.d.ts.map +0 -1
  351. package/dist/quire/contract.d.ts +0 -88
  352. package/dist/quire/contract.d.ts.map +0 -1
  353. package/dist/quire/exec.d.ts +0 -66
  354. package/dist/quire/exec.d.ts.map +0 -1
  355. package/dist/quire/index.d.ts +0 -13
  356. package/dist/quire/index.d.ts.map +0 -1
  357. package/dist/quire/types.d.ts +0 -415
  358. package/dist/quire/types.d.ts.map +0 -1
  359. package/dist/quire/validate.d.ts +0 -39
  360. package/dist/quire/validate.d.ts.map +0 -1
  361. package/dist/quire-BsVj1xIR.js +0 -4968
  362. package/dist/schema-assets-HZWo_iFN.js +0 -233
  363. package/dist/schemas/assurance-v1.schema.json +0 -225
  364. package/dist/schemas/change-assurance-record-v1.schema.json +0 -234
  365. package/dist/schemas/coverage-v1.schema.json +0 -1111
  366. package/dist/schemas/operational-evidence-v1.schema.json +0 -381
  367. package/dist/schemas/proof-attestation-v1.schema.json +0 -96
  368. package/dist/schemas/properties-v1.schema.json +0 -159
  369. package/dist/schemas/verification-receipt-v1.schema.json +0 -208
  370. package/dist/validators/gates.d.ts +0 -18
  371. package/dist/validators/gates.d.ts.map +0 -1
  372. package/dist/validators/index.d.ts +0 -2
  373. package/dist/validators/index.d.ts.map +0 -1
  374. package/dist/version-CMxMIh5g.js +0 -17
  375. package/dist/version.d.ts +0 -3
  376. package/dist/version.d.ts.map +0 -1
  377. package/dist/write-CGTI0dRO.js +0 -157
  378. package/dist/write.d.ts +0 -28
  379. package/dist/write.d.ts.map +0 -1
  380. package/skills/assurance-status-report/SKILL.md +0 -135
  381. package/skills/assurance-status-report/references/report-contract.md +0 -110
  382. package/skills/gap-analysis/SKILL.md +0 -111
  383. package/skills/gap-analysis/references/step-1-target-selection.md +0 -53
  384. package/skills/gap-analysis/references/step-2-plan-completion.md +0 -49
  385. package/skills/gap-analysis/references/step-3-matrix-verification.md +0 -147
  386. package/skills/gap-analysis/references/step-4-underspecified-code.md +0 -92
  387. package/skills/gap-analysis/references/step-5-semantic-review.md +0 -51
  388. package/skills/gap-analysis/references/step-6-specreview-artifact.md +0 -108
  389. package/skills/spec-app-review/SKILL.md +0 -51
  390. package/skills/spec-app-review/references/checklist.md +0 -197
  391. package/skills/spec-architecture-evaluation/SKILL.md +0 -30
  392. package/skills/spec-correctness/SKILL.md +0 -96
  393. package/skills/spec-correctness/assets/strategy-table.md +0 -101
  394. package/skills/spec-correctness/assets/templates/fast-check.ts.md +0 -169
  395. package/skills/spec-correctness/assets/templates/hypothesis.py.md +0 -156
  396. package/skills/spec-correctness/assets/templates/proptest.rs.md +0 -147
  397. package/skills/spec-correctness/references/step-0-scope-and-harness.md +0 -94
  398. package/skills/spec-correctness/references/step-1-census.md +0 -53
  399. package/skills/spec-correctness/references/step-2-clause-grounding.md +0 -159
  400. package/skills/spec-correctness/references/step-3-strategy-selection.md +0 -85
  401. package/skills/spec-correctness/references/step-4-generate-tests.md +0 -117
  402. package/skills/spec-correctness/references/step-5-second-pass.md +0 -81
  403. package/skills/spec-correctness/references/step-6-review-artifact.md +0 -134
  404. package/skills/spec-correctness/references/step-7-report-and-handoff.md +0 -102
  405. package/skills/spec-dependency-analysis/SKILL.md +0 -90
  406. package/skills/spec-ears-analysis/SKILL.md +0 -102
  407. package/skills/spec-evidence-analysis/SKILL.md +0 -156
  408. package/skills/spec-failure-domain-analysis/SKILL.md +0 -59
  409. package/skills/spec-fuzz/SKILL.md +0 -133
  410. package/skills/spec-fuzz/assets/templates/atheris.py.md +0 -74
  411. package/skills/spec-fuzz/assets/templates/cargo-fuzz.rs.md +0 -83
  412. package/skills/spec-fuzz/assets/templates/fast-check.ts.md +0 -76
  413. package/skills/spec-fuzz/references/step-0-scope-and-harness.md +0 -51
  414. package/skills/spec-fuzz/references/step-1-select-obligations.md +0 -47
  415. package/skills/spec-fuzz/references/step-2-ground-entry-point.md +0 -55
  416. package/skills/spec-fuzz/references/step-3-emit-targets.md +0 -65
  417. package/skills/spec-fuzz/references/step-4-report.md +0 -56
  418. package/skills/spec-ideation/SKILL.md +0 -46
  419. package/skills/spec-integrity-analysis/SKILL.md +0 -62
  420. package/skills/spec-matrix/SKILL.md +0 -186
  421. package/skills/spec-matrix/assets/test-cases/TC-001.md +0 -35
  422. package/skills/spec-matrix/assets/test-cases/TC-002.md +0 -37
  423. package/skills/spec-matrix/assets/test-cases/TC-006.md +0 -50
  424. package/skills/spec-matrix/assets/test-matrix-example.md +0 -104
  425. package/skills/spec-matrix/assets/test-matrix-template.md +0 -123
  426. package/skills/spec-matrix/workflow-assets/dist/index.d.ts +0 -146
  427. package/skills/spec-matrix/workflow-assets/dist/index.d.ts.map +0 -1
  428. package/skills/spec-matrix/workflow-assets/dist/index.js +0 -7525
  429. package/skills/spec-matrix/workflow-assets/dist/invariants.d.ts +0 -6
  430. package/skills/spec-matrix/workflow-assets/dist/invariants.d.ts.map +0 -1
  431. package/skills/spec-matrix/workflow-assets/skills/matrix/SKILL.md +0 -35
  432. package/skills/spec-matrix/workflow-assets/skills/matrix/scripts/invariants.js +0 -1
  433. package/skills/spec-matrix/workflow-assets/skills/matrix/templates/report/default.md +0 -30
  434. package/skills/spec-matrix/workflow-assets/skills/matrix/workflows/matrix/def.yaml +0 -82
  435. package/skills/spec-object-review/SKILL.md +0 -125
  436. package/skills/spec-object-review/references/object-type-guide.md +0 -118
  437. package/skills/spec-review/SKILL.md +0 -92
  438. package/skills/spec-review/references/checklist.md +0 -50
  439. package/skills/spec-review/workflow-assets/dist/index.d.ts +0 -146
  440. package/skills/spec-review/workflow-assets/dist/index.d.ts.map +0 -1
  441. package/skills/spec-review/workflow-assets/dist/index.js +0 -7525
  442. package/skills/spec-review/workflow-assets/dist/invariants.d.ts +0 -6
  443. package/skills/spec-review/workflow-assets/dist/invariants.d.ts.map +0 -1
  444. package/skills/spec-review/workflow-assets/skills/review/SKILL.md +0 -96
  445. package/skills/spec-review/workflow-assets/skills/review/scripts/invariants.js +0 -61
  446. package/skills/spec-review/workflow-assets/skills/review/workflows/review/def.yaml +0 -68
  447. package/skills/spec-risk-complexity-analysis/SKILL.md +0 -92
  448. package/skills/spec-scope-boundary-analysis/SKILL.md +0 -101
  449. package/skills/spec-security-analysis/SKILL.md +0 -84
  450. package/skills/spec-security-analysis/assets/security-analysis-example.md +0 -89
  451. package/skills/spec-security-analysis/assets/security-analysis-template.md +0 -73
  452. package/skills/spec-security-analysis/references/component-type-mapping.md +0 -161
  453. package/skills/spec-security-analysis/references/gdpr/ChII-Principles.md +0 -58
  454. package/skills/spec-security-analysis/references/gdpr/ChIII-DataSubjectRights.md +0 -84
  455. package/skills/spec-security-analysis/references/gdpr/ChIV-ControllerProcessor.md +0 -83
  456. package/skills/spec-security-analysis/references/gdpr/ChV-DataTransfers.md +0 -62
  457. package/skills/spec-security-analysis/references/gdpr/index.md +0 -54
  458. package/skills/spec-security-analysis/references/iso27001/A5-OrganizationalControls.md +0 -64
  459. package/skills/spec-security-analysis/references/iso27001/A6-PeopleControls.md +0 -30
  460. package/skills/spec-security-analysis/references/iso27001/A7-PhysicalControls.md +0 -35
  461. package/skills/spec-security-analysis/references/iso27001/A8-TechnologicalControls.md +0 -66
  462. package/skills/spec-security-analysis/references/iso27001/index.md +0 -43
  463. package/skills/spec-security-analysis/references/nist-800-53/AC-AccessControl.md +0 -57
  464. package/skills/spec-security-analysis/references/nist-800-53/AU-AuditAccountability.md +0 -49
  465. package/skills/spec-security-analysis/references/nist-800-53/CM-ConfigurationManagement.md +0 -36
  466. package/skills/spec-security-analysis/references/nist-800-53/IA-IdentificationAuthentication.md +0 -44
  467. package/skills/spec-security-analysis/references/nist-800-53/SA-SystemServicesAcquisition.md +0 -50
  468. package/skills/spec-security-analysis/references/nist-800-53/SC-SystemCommunications.md +0 -53
  469. package/skills/spec-security-analysis/references/nist-800-53/SI-SystemInformationIntegrity.md +0 -52
  470. package/skills/spec-security-analysis/references/nist-800-53/index.md +0 -58
  471. package/skills/spec-security-analysis/references/owasp-asvs/V1-Architecture.md +0 -33
  472. package/skills/spec-security-analysis/references/owasp-asvs/V10-MaliciousCode.md +0 -33
  473. package/skills/spec-security-analysis/references/owasp-asvs/V11-BusinessLogic.md +0 -32
  474. package/skills/spec-security-analysis/references/owasp-asvs/V12-Files.md +0 -34
  475. package/skills/spec-security-analysis/references/owasp-asvs/V13-API.md +0 -34
  476. package/skills/spec-security-analysis/references/owasp-asvs/V14-Configuration.md +0 -35
  477. package/skills/spec-security-analysis/references/owasp-asvs/V2-Authentication.md +0 -36
  478. package/skills/spec-security-analysis/references/owasp-asvs/V3-SessionManagement.md +0 -35
  479. package/skills/spec-security-analysis/references/owasp-asvs/V4-AccessControl.md +0 -39
  480. package/skills/spec-security-analysis/references/owasp-asvs/V5-Validation.md +0 -37
  481. package/skills/spec-security-analysis/references/owasp-asvs/V6-Cryptography.md +0 -34
  482. package/skills/spec-security-analysis/references/owasp-asvs/V7-ErrorLogging.md +0 -37
  483. package/skills/spec-security-analysis/references/owasp-asvs/V8-DataProtection.md +0 -34
  484. package/skills/spec-security-analysis/references/owasp-asvs/V9-Communication.md +0 -32
  485. package/skills/spec-security-analysis/references/owasp-asvs/index.md +0 -59
  486. package/skills/spec-security-analysis/references/soc2/CC1-ControlEnvironment.md +0 -31
  487. package/skills/spec-security-analysis/references/soc2/CC2-CommunicationInformation.md +0 -27
  488. package/skills/spec-security-analysis/references/soc2/CC3-RiskAssessment.md +0 -29
  489. package/skills/spec-security-analysis/references/soc2/CC4-MonitoringActivities.md +0 -27
  490. package/skills/spec-security-analysis/references/soc2/CC5-ControlActivities.md +0 -28
  491. package/skills/spec-security-analysis/references/soc2/CC6-LogicalPhysicalAccess.md +0 -45
  492. package/skills/spec-security-analysis/references/soc2/CC7-SystemOperations.md +0 -42
  493. package/skills/spec-security-analysis/references/soc2/CC8-ChangeManagement.md +0 -32
  494. package/skills/spec-security-analysis/references/soc2/CC9-RiskMitigation.md +0 -34
  495. package/skills/spec-security-analysis/references/soc2/index.md +0 -46
  496. package/skills/spec-security-analysis/references/standards-index.md +0 -46
  497. package/skills/spec-to-plan/SKILL.md +0 -88
  498. package/skills/spec-to-plan/references/step-0-plan-selection.md +0 -121
  499. package/skills/spec-to-plan/references/step-1-analysis.md +0 -88
  500. package/skills/spec-to-plan/references/step-2-test-plan.md +0 -43
  501. package/skills/spec-to-plan/references/step-3-execution-plan.md +0 -218
  502. package/skills/spec-to-plan/workflow-assets/dist/index.d.ts +0 -146
  503. package/skills/spec-to-plan/workflow-assets/dist/index.d.ts.map +0 -1
  504. package/skills/spec-to-plan/workflow-assets/dist/index.js +0 -7525
  505. package/skills/spec-to-plan/workflow-assets/dist/invariants.d.ts +0 -6
  506. package/skills/spec-to-plan/workflow-assets/dist/invariants.d.ts.map +0 -1
  507. package/skills/spec-to-plan/workflow-assets/skills/to-plan/SKILL.md +0 -35
  508. package/skills/spec-to-plan/workflow-assets/skills/to-plan/scripts/invariants.js +0 -1
  509. package/skills/spec-to-plan/workflow-assets/skills/to-plan/templates/implementation-plan/default.md +0 -44
  510. package/skills/spec-to-plan/workflow-assets/skills/to-plan/workflows/to-plan/def.yaml +0 -85
  511. package/skills/specify/SKILL.md +0 -154
  512. package/skills/specify/assets/app-spec-template.md +0 -143
  513. package/skills/specify/assets/spec-template.md +0 -299
  514. package/skills/specify/references/integration-tests.md +0 -72
  515. package/skills/specify/references/us-to-fr.md +0 -40
  516. package/skills/specify/references/writing-good-requirements.md +0 -61
@@ -1,169 +0,0 @@
1
- # TypeScript / fast-check templates
2
-
3
- File: `tests/props/fr-NNN.prop.test.ts`.
4
- Runner: whichever the repo already uses — read `vitest.config.*`, `jest.config.*`, or
5
- `package.json#scripts.test`. The imports below assume vitest; swap for `@jest/globals`
6
- where the repo uses jest.
7
-
8
- ## Anatomy
9
-
10
- ```ts
11
- // tests/props/fr-012.prop.test.ts
12
- import fc from "fast-check";
13
- import { describe, it, expect } from "vitest";
14
- import { detectDuplicates, type Entry } from "../../src/catalog.js";
15
-
16
- // grounded in step 2 from `## Inputs` + the signature at src/catalog.ts:88
17
- const entryArb: fc.Arbitrary<Entry> = fc.record({
18
- kind: fc.stringMatching(/^[a-z]{1,12}$/),
19
- name: fc.stringMatching(/^[a-z]{1,12}$/),
20
- });
21
-
22
- describe("FR-012-AC-1 duplicate modules are sorted", () => {
23
- /**
24
- * Trace: FR-012-AC-1 — declaring modules are listed in sorted order.
25
- * spec-correctness: row=FR-012-AC-1 property=ordering extraction=extractable origin=regex review=none
26
- */
27
- it("holds for any catalog", () => {
28
- fc.assert(
29
- fc.property(fc.array(entryArb, { maxLength: 32 }), (entries) => {
30
- for (const d of detectDuplicates(entries).duplicates) {
31
- expect(d.modules).toEqual([...d.modules].sort());
32
- }
33
- }),
34
- );
35
- });
36
- });
37
- ```
38
-
39
- Both tag carriers: `Trace:` on its own JSDoc line, and `FR-012-AC-1` inside the `describe`
40
- title.
41
-
42
- **The `Trace:` block goes immediately above the `it(` / `test(` registration — never above
43
- the enclosing `describe`.** A tag binds to the symbol whose source span encloses it, and
44
- `describe(…)` groups tests but *registers none itself* (quire-rs
45
- `src/symbols/typescript.rs`, `registration`). A tag above a `describe` therefore attaches
46
- to nothing: it reads fine, greps fine, and is invisible to `quire coverage`. That is the
47
- whole of agent-ix/quoin#61 — measured, one tag moved from its `describe` to its `test(`
48
- took `FR-005` from 0/3 to 1/3 with no other change.
49
-
50
- Python and Rust are unaffected: a symbol's span covers its annotation block, declaration
51
- **and body**, so a docstring inside the function and an attribute above `#[test] fn` both
52
- land inside a real test symbol. Only the TS placement can fall outside one.
53
-
54
- ## Family bodies
55
-
56
- ```ts
57
- // round-trip
58
- expect(parse(render(x))).toEqual(x);
59
-
60
- // round-trip, lossy
61
- expect(normalize(parse(render(x)))).toEqual(normalize(x));
62
-
63
- // idempotence — seed with f's own outputs
64
- const seeded = fc.oneof(rawConfigArb, rawConfigArb.map(normalize));
65
- expect(normalize(normalize(x))).toEqual(normalize(x));
66
-
67
- // invariant
68
- expect(resolve(x).length).toBeLessThanOrEqual(MAX_MODULES);
69
-
70
- // ordering, order-independence
71
- expect(summarize(xs)).toEqual(summarize([...xs].reverse()));
72
- ```
73
-
74
- ## error-case — negative domain
75
-
76
- ```ts
77
- describe("FR-005-AC-1 unknown commands error", () => {
78
- /**
79
- * Trace: FR-005-AC-1 — an unknown command raises an error that names the usage.
80
- * spec-correctness: row=FR-005-AC-1 property=error-case extraction=extractable origin=regex review=none
81
- */
82
- it("rejects any command outside the known set", () => {
83
- fc.assert(
84
- fc.property(fc.stringMatching(/^[a-z]{1,12}$/), (cmd) => {
85
- fc.pre(!KNOWN.has(cmd));
86
- expect(() => run([cmd])).toThrow(UnknownCommandError); // class, from src
87
- expect(() => run([cmd])).toThrow(/Usage:/); // payload, from ## Outputs
88
- }),
89
- );
90
- });
91
- });
92
- ```
93
-
94
- ## lifecycle — fc.commands / modelRun
95
-
96
- ```ts
97
- describe("FR-040-AC-2 session lifecycle", () => {
98
- /**
99
- * Trace: FR-040-AC-2 — a session accepts exactly the ops its state allows.
100
- * spec-correctness: row=FR-040-AC-2 property=lifecycle extraction=extractable origin=regex review=none
101
- */
102
- it("matches the model over any op sequence", () => {
103
- fc.assert(
104
- fc.property(fc.commands(allCommands, { maxCommands: 24 }), (cmds) =>
105
- fc.modelRun(() => ({ model: newModel(), real: new Session() }), cmds),
106
- ),
107
- );
108
- });
109
- });
110
- ```
111
-
112
- Each command's `check(model)` is the precondition; its `run(model, real)` carries the
113
- assertion. That split *is* the precondition/oracle split from step 2.
114
-
115
- ## concurrency — deterministic scheduler
116
-
117
- ```ts
118
- describe("FR-050-AC-1 concurrent writes", () => {
119
- /**
120
- * Trace: FR-050-AC-1 — concurrent writers never lose an entry.
121
- * spec-correctness: row=FR-050-AC-1 property=concurrency extraction=extractable origin=regex review=none
122
- */
123
- it("linearizes under any interleaving", async () => {
124
- await fc.assert(
125
- fc.asyncProperty(fc.scheduler(), async (s) => {
126
- const store = new Store();
127
- s.scheduleSequence([
128
- { label: "a", builder: () => store.put("a", 1) },
129
- { label: "b", builder: () => store.put("b", 2) },
130
- ]);
131
- await s.waitAll();
132
- expect(store.size).toBe(2);
133
- }),
134
- );
135
- });
136
- });
137
- ```
138
-
139
- `fc.scheduler()` is deterministic and shrinkable — never use real timers or `Promise.all`
140
- races for a concurrency property.
141
-
142
- ## A `candidate` record
143
-
144
- Same file, same path, and it **runs**. `extraction: candidate` means the metamorphic label
145
- was not corroborated structurally — something for a reviewer to read, not a reason to
146
- disable a test:
147
-
148
- ```ts
149
- describe("FR-018-AC-3 source maps to one root", () => {
150
- /**
151
- * Trace: FR-018-AC-3 — a plugin source maps to exactly one resolved root.
152
- * spec-correctness: row=FR-018-AC-3 property=invariant extraction=candidate origin=regex-candidate
153
- */
154
- it("holds for any plugin source", () => { … });
155
- });
156
- ```
157
-
158
- What marks it for review is a `medium` finding in the review artifact (step 6), not an
159
- `it.skip` in the tree.
160
-
161
- ## Notes
162
-
163
- - `fc.assert(fc.property(…))` synchronous, `await fc.assert(fc.asyncProperty(…))` async.
164
- A forgotten `await` makes the test pass vacuously.
165
- - Bound every `fc.array` with `maxLength`.
166
- - `fc.pre(...)` inside the property, not around it.
167
- - Return `void` or `boolean` from a property predicate — an assertion that throws is fine;
168
- a returned truthy non-boolean is not.
169
- - Reuse the repo's existing arbitraries and factories before writing new ones.
@@ -1,156 +0,0 @@
1
- # Python / hypothesis templates
2
-
3
- File: `tests/props/test_fr_NNN.py`.
4
- Every emitted test runs — there is no inert form.
5
-
6
- ## Anatomy
7
-
8
- ```python
9
- # tests/props/test_fr_012.py
10
- from hypothesis import given, strategies as st
11
-
12
- from quoin.catalog import Entry, detect_duplicates
13
-
14
- # grounded in step 2 from `## Inputs` + the signature at src/quoin/catalog.py:88
15
- entries = st.builds(
16
- Entry,
17
- kind=st.from_regex(r"\A[a-z]{1,12}\Z"),
18
- name=st.from_regex(r"\A[a-z]{1,12}\Z"),
19
- )
20
-
21
-
22
- @given(catalog=st.lists(entries, max_size=32))
23
- def test_fr_012_ac_1_duplicate_modules_sorted(catalog):
24
- """Trace: FR-012-AC-1 — declaring modules are listed in sorted order.
25
-
26
- spec-correctness: row=FR-012-AC-1 property=ordering extraction=extractable origin=regex review=none
27
- """
28
- for dup in detect_duplicates(catalog).duplicates:
29
- assert dup.modules == sorted(dup.modules)
30
- ```
31
-
32
- Both tag carriers: `Trace:` on its own docstring line, and `fr_012_ac_1_` in the function
33
- name.
34
-
35
- ## Family bodies
36
-
37
- ```python
38
- # round-trip
39
- assert parse(render(x)) == x
40
-
41
- # round-trip, lossy
42
- assert normalize(parse(render(x))) == normalize(x)
43
-
44
- # idempotence — seed with f's own outputs
45
- seeded = st.one_of(raw_configs, raw_configs.map(normalize))
46
- assert normalize(normalize(x)) == normalize(x)
47
-
48
- # invariant
49
- assert len(resolve(x)) <= MAX_MODULES
50
-
51
- # ordering, permutation preservation
52
- assert Counter(reorder(xs)) == Counter(xs)
53
- ```
54
-
55
- ## error-case — negative domain
56
-
57
- ```python
58
- from hypothesis import assume
59
- import pytest
60
-
61
-
62
- @given(cmd=st.from_regex(r"\A[a-z]{1,12}\Z"))
63
- def test_fr_005_ac_1_unknown_command_errors(cmd):
64
- """Trace: FR-005-AC-1 — an unknown command raises an error that names the usage.
65
-
66
- spec-correctness: row=FR-005-AC-1 property=error-case extraction=extractable origin=regex review=none
67
- """
68
- assume(cmd not in KNOWN)
69
- with pytest.raises(UnknownCommandError, match="Usage:"):
70
- run([cmd])
71
- ```
72
-
73
- `pytest.raises(Class, match=...)` carries both required assertions — the error class from
74
- the code, the payload from `## Outputs` — in one line.
75
-
76
- Prefer `st.sampled_from` over a broad regex plus `assume` when the negative domain is small;
77
- too many `assume` rejections trip hypothesis's health checks.
78
-
79
- ## lifecycle — RuleBasedStateMachine
80
-
81
- ```python
82
- from hypothesis.stateful import RuleBasedStateMachine, invariant, precondition, rule
83
-
84
-
85
- class SessionMachine(RuleBasedStateMachine):
86
- """Trace: FR-040-AC-2 — a session accepts exactly the ops its state allows.
87
-
88
- spec-correctness: row=FR-040-AC-2 property=lifecycle extraction=extractable origin=regex review=none
89
- """
90
-
91
- def __init__(self):
92
- super().__init__()
93
- self.sut = Session()
94
- self.model = []
95
-
96
- @rule()
97
- def open(self):
98
- self.sut.open()
99
-
100
- @rule(data=st.text(max_size=64))
101
- @precondition(lambda self: self.sut.is_open)
102
- def write(self, data):
103
- self.sut.write(data)
104
- self.model.append(data)
105
-
106
- @invariant()
107
- def buffer_matches_model(self):
108
- assert self.sut.buffer == "".join(self.model)
109
-
110
-
111
- TestSessionLifecycle = SessionMachine.TestCase
112
- ```
113
-
114
- `@precondition` is the step-2 precondition; `@invariant` is the step-2 oracle.
115
-
116
- ## concurrency — always a downgrade
117
-
118
- hypothesis ships no interleaving scheduler, so a Python concurrency criterion never gets
119
- real interleaving coverage. Emit a `RuleBasedStateMachine` over the async model, and record
120
- the downgrade as a finding:
121
-
122
- ```python
123
- class TestConcurrentWrites(RuleBasedStateMachine):
124
- """Trace: FR-050-AC-1 — concurrent writers never lose an entry.
125
-
126
- spec-correctness: row=FR-050-AC-1 property=concurrency extraction=not-extractable origin=llm-second-pass confidence=low
127
- """
128
- ```
129
-
130
- The finding says the interleaving is not exhaustively explored. That is what needs a
131
- person — the test itself is fine to run.
132
-
133
- ## A `candidate` record
134
-
135
- Same file, same path, and it runs:
136
-
137
- ```python
138
- @given(src=plugin_sources)
139
- def test_fr_018_ac_3_source_maps_to_one_root(src):
140
- """Trace: FR-018-AC-3 — a plugin source maps to exactly one resolved root.
141
-
142
- spec-correctness: row=FR-018-AC-3 property=invariant extraction=candidate origin=regex-candidate
143
- """
144
- ```
145
-
146
- What marks it for review is a `medium` finding in the review artifact (step 6), not a skip
147
- marker in the tree.
148
-
149
- ## Notes
150
-
151
- - `@given` outermost, `@pytest.mark.*` above it; hypothesis and pytest fixtures do not mix
152
- freely — pass state through the strategy, not through a function-scoped fixture.
153
- - Bound every `st.lists` with `max_size`, every `st.text` with `max_size`.
154
- - Never `@seed(...)` a generated test, and never `@settings(derandomize=True)` — both hide
155
- the failures the property exists to find.
156
- - Raise `max_examples` only with a reason recorded as a finding.
@@ -1,147 +0,0 @@
1
- # Rust / proptest templates
2
-
3
- File: `tests/props_fr_NNN.rs`.
4
- Every emitted test runs — there is no inert form.
5
-
6
- Paths are **flat**: cargo auto-discovers integration tests only at `tests/*.rs`. A file
7
- under `tests/props/` compiles as a helper module and never runs. See step 4.
8
-
9
- ## Anatomy
10
-
11
- ```rust
12
- // tests/props_fr_012.rs
13
- use proptest::prelude::*;
14
- use quoin::catalog::{detect_duplicates, Entry};
15
-
16
- fn entry() -> impl Strategy<Value = Entry> {
17
- // grounded in step 2 from `## Inputs` + the signature at src/catalog.rs:88
18
- ("[a-z]{1,12}", "[a-z]{1,12}").prop_map(|(kind, name)| Entry::new(kind, name))
19
- }
20
-
21
- proptest! {
22
- /// Trace: FR-012-AC-1 — declaring modules are listed in sorted order.
23
- /// spec-correctness: row=FR-012-AC-1 property=ordering extraction=extractable origin=regex review=none
24
- #[test]
25
- fn fr_012_ac_1_duplicate_modules_sorted(entries in prop::collection::vec(entry(), 0..32)) {
26
- for dup in detect_duplicates(&entries).duplicates {
27
- let mut sorted = dup.modules.clone();
28
- sorted.sort();
29
- prop_assert_eq!(dup.modules, sorted);
30
- }
31
- }
32
- }
33
- ```
34
-
35
- Both tag carriers are present: `Trace:` on its own doc-comment line, and `fr_012_ac_1_` in
36
- the function name.
37
-
38
- ## Family bodies
39
-
40
- Same `proptest! { #[test] fn … }` wrapper; only the assertion changes.
41
-
42
- ```rust
43
- // round-trip
44
- prop_assert_eq!(parse(&render(&x))?, x);
45
-
46
- // round-trip, lossy (cite the FR line stating the loss)
47
- prop_assert_eq!(normalize(&parse(&render(&x))?), normalize(&x));
48
-
49
- // idempotence — seed with f's own outputs
50
- fn seeded() -> impl Strategy<Value = Config> {
51
- prop_oneof![raw_config(), raw_config().prop_map(|c| normalize(&c))]
52
- }
53
- prop_assert_eq!(normalize(&normalize(&x)), normalize(&x));
54
-
55
- // invariant
56
- prop_assert!(resolve(&x).len() <= MAX_MODULES);
57
- ```
58
-
59
- ## error-case — negative domain
60
-
61
- ```rust
62
- proptest! {
63
- /// Trace: FR-005-AC-1 — an unknown command raises an error that names the usage.
64
- /// spec-correctness: row=FR-005-AC-1 property=error-case extraction=extractable origin=regex review=none
65
- #[test]
66
- fn fr_005_ac_1_unknown_command_errors(
67
- cmd in "[a-z]{1,12}".prop_filter("must be unknown", |c| !KNOWN.contains(&c.as_str()))
68
- ) {
69
- let err = run(&[cmd.as_str()]).unwrap_err();
70
- prop_assert!(matches!(err, Error::UnknownCommand(_))); // class, from the error enum
71
- prop_assert!(err.to_string().contains("Usage:")); // payload, from ## Outputs
72
- }
73
- }
74
- ```
75
-
76
- ## lifecycle — model vs SUT
77
-
78
- ```rust
79
- proptest! {
80
- /// Trace: FR-040-AC-2 — a session accepts exactly the ops its state allows.
81
- /// spec-correctness: row=FR-040-AC-2 property=lifecycle extraction=extractable origin=regex review=none
82
- #[test]
83
- fn fr_040_ac_2_session_lifecycle(ops in prop::collection::vec(any_op(), 1..24)) {
84
- let (mut model, mut sut) = (Model::default(), Session::new());
85
- for op in ops {
86
- let legal = model.allows(&op);
87
- prop_assert_eq!(sut.apply(&op).is_ok(), legal);
88
- if legal { model.apply(&op); }
89
- prop_assert!(sut.invariant_holds());
90
- }
91
- prop_assert_eq!(sut.state(), model.state());
92
- }
93
- }
94
- ```
95
-
96
- ## concurrency — loom
97
-
98
- Not a `proptest!` block; `loom` enumerates interleavings itself.
99
-
100
- ```rust
101
- /// Trace: FR-050-AC-1 — concurrent writers never lose an entry.
102
- /// spec-correctness: row=FR-050-AC-1 property=concurrency extraction=extractable origin=regex review=none
103
- #[test]
104
- fn fr_050_ac_1_concurrent_writes_linearizable() {
105
- loom::model(|| {
106
- let store = loom::sync::Arc::new(Store::new());
107
- let handles: Vec<_> = (0..2)
108
- .map(|i| { let s = store.clone(); loom::thread::spawn(move || s.put(i, i)) })
109
- .collect();
110
- for h in handles { h.join().unwrap(); }
111
- assert_eq!(store.len(), 2);
112
- });
113
- }
114
- ```
115
-
116
- Keep the loom model tiny — two threads, two ops. Interleavings explode.
117
-
118
- ## A `candidate` record
119
-
120
- Same file, same path, and it **runs** — `extraction: candidate` means the metamorphic label
121
- was not corroborated structurally, which is something for a reviewer to read, not a reason
122
- to disable a test:
123
-
124
- ```rust
125
- proptest! {
126
- /// Trace: FR-018-AC-3 — a plugin source maps to exactly one resolved root.
127
- /// spec-correctness: row=FR-018-AC-3 property=invariant extraction=candidate origin=regex-candidate
128
- #[test]
129
- fn fr_018_ac_3_source_maps_to_one_root(src in plugin_source()) { … }
130
- }
131
- ```
132
-
133
- What marks it for review is a `medium` finding in the review artifact (step 6), not an
134
- `#[ignore]` in the tree.
135
-
136
- ## Notes
137
-
138
- - **Import by the `[lib] name`, not the package name.** They differ often —
139
- `package.name = "quire-rs"` but `lib.name = "quire_rs"`, so an integration test writes
140
- `use quire_rs::…`. Read `[lib] name` in `Cargo.toml`; fall back to the package name with
141
- `-` replaced by `_` only when no `[lib]` block declares one.
142
- - `prop_assert*` inside `proptest!`, plain `assert*` inside `loom::model`.
143
- - Bound every `prop::collection::vec` — `0..32` unless the FR states a bound.
144
- - Prefer building a negative domain directly over `prop_filter` when the filter rejects
145
- most values; proptest gives up after too many rejections.
146
- - Do not set `ProptestConfig { cases, .. }` above the default without recording why as a
147
- finding.
@@ -1,94 +0,0 @@
1
- # Step 0: Scope and Harness
2
-
3
- **Goal**: know what you are classifying, what harness you are writing into, and what
4
- tracking-tag form the repo already uses.
5
-
6
- ## 1. Resolve scope
7
-
8
- Repo root = the directory holding the spec tree. Default glob `spec/**/*.md`; a multi-repo
9
- layout uses `specs/<category>/<component>/spec/**/*.md`.
10
-
11
- ## 2. Run the classifier
12
-
13
- ```
14
- quire properties --scope <repo> --json 'spec/**/*.md'
15
- ```
16
-
17
- Requires quire-cli ≥ 0.12.0 (`quire --version`). Output shape:
18
-
19
- ```json
20
- {"documents": [{
21
- "document": "<abs path>",
22
- "archetype": "FR",
23
- "criteria": [{
24
- "row_id": "FR-027-AC-1",
25
- "statement": "A stored organization is used ahead of the `origin` remote…",
26
- "line": 74,
27
- "shape": "assertion",
28
- "property": "universal",
29
- "extractable": true,
30
- "extraction": "extractable",
31
- "domain": null, "precondition": null, "oracle": null,
32
- "signals": ["universal:determiner"]
33
- }]
34
- }]}
35
- ```
36
-
37
- Field notes that matter:
38
-
39
- - `row_id` — the only identifier shared with the matrix and with `gap-analysis`. Never
40
- synthesize one, never alter one. A record with `row_id: null` cannot be tagged, so it
41
- yields no test and one finding with reason `no-row-id`.
42
- - `line` is 1-based and **file**-relative. Span `start`/`end` are **statement**-relative
43
- byte offsets into `statement`. Do not mix them.
44
- - Spans are usually `null` (they reach ~4% of the ecosystem corpus). Their absence says
45
- nothing about the criterion; step 2 grounds the clauses regardless.
46
- - `signals` is an audit trail, useful for diagnosis. `span:refused-weak-boundary` means the
47
- engine declined to guess a boundary — read it as "the oracle must come from the code."
48
-
49
- Add `--pretty` while developing. Stderr carries module diagnostics (`DuplicateArchetype`
50
- etc.); they are noise for this skill, not findings.
51
-
52
- ## 3. Detect the harness
53
-
54
- Probe the repo root, in this order. Record harness, generator library presence, test dir,
55
- and runner.
56
-
57
- | Harness | Manifest | Generator library | Test path |
58
- | --- | --- | --- | --- |
59
- | Rust / proptest | `Cargo.toml` | `proptest`, `proptest-state-machine`, `loom`, `arbitrary` in `[dev-dependencies]` | `tests/props_fr_NNN.rs` (flat — cargo discovers only `tests/*.rs`) |
60
- | TypeScript / fast-check | `package.json` | `fast-check` in `devDependencies`; runner from `vitest.config.*`, `jest.config.*`, or `package.json#scripts.test` | `tests/props/fr-NNN.prop.test.ts` |
61
- | Python / hypothesis | `pyproject.toml`, `setup.cfg`, `requirements*.txt` | `hypothesis`; runner from `pytest.ini` / `tox.ini` / `conftest.py` | `tests/props/test_fr_NNN.py` |
62
-
63
- Rules:
64
-
65
- - **Manifest present, generator library absent** — install nothing, and **write no test
66
- files**. A file that imports a missing generator library breaks the suite at collection
67
- time, before a single test runs. Record one `high` finding per affected criterion naming
68
- the missing library, and report one line:
69
- `harness <lib> not installed — add <lib> to <dev-deps>, then re-run to emit these`.
70
- Adding a dependency is the user's call, not this skill's.
71
- - **Polyglot repo** — resolve per-FR from the AC table's `Verification` column, which names
72
- the test file (`Test (org.test.ts)` → TypeScript). If that column is absent, use the tree
73
- holding the symbol step 2 grounded. Never pick one harness repo-wide by guessing.
74
- - **No harness at all** — stop after steps 1 and 2. Record the grounded strategies as
75
- findings in the review artifact. Write no test files.
76
-
77
- ## 4. Detect the existing tag style
78
-
79
- Grep the existing test tree for the four forms `gap-analysis` accepts
80
- (`skills/gap-analysis/references/step-3-matrix-verification.md`):
81
-
82
- ```
83
- Trace: FR-
84
- FR-[0-9]{3}-AC-
85
- TC-[0-9]{3}
86
- Tests for FR-
87
- ```
88
-
89
- Mimic the dominant form. The tags in step 4 are additive to it, never a replacement — if
90
- this repo writes `// FR-025-AC-7:` line comments, keep writing those too.
91
-
92
- ## Output of this step
93
-
94
- `{repo, glob, records[], harness, generator_lib_present, test_dir, runner, tag_style}`.
@@ -1,53 +0,0 @@
1
- # Step 1: Census
2
-
3
- **Goal**: state what the classifier found, as counts, so the rest of the run has a
4
- denominator. Nothing in this step is a judgement.
5
-
6
- ## Bucket
7
-
8
- Cross-tabulate the records two ways:
9
-
10
- - `property` × `extraction` — this drives routing and volume.
11
- - `archetype` × `extraction` — this tells you where the properties live (FR? StR? NFR?).
12
-
13
- Report the totals plainly:
14
-
15
- ```
16
- Criteria: 118
17
- extraction extractable 51 · candidate 0 · not-extractable 67
18
- property universal 43 · example 59 · error-case 9 · unclassified 5 · ordering 2
19
- archetype FR 84 · NFR 21 · StR 13
20
- spans present domain 4 · precondition 2 · oracle 5
21
- ```
22
-
23
- ## What this step must never emit
24
-
25
- - A threshold, a target, a percentage framed as a score, or a grade of any kind.
26
- - A pass/fail, a verdict, or a severity. The classification carries no severity key and no
27
- promotion path by design (quire-rs FR-052-CON-1).
28
- - A suggestion to reword, split, or "improve" any criterion. Not as a recommendation, not
29
- as a note, not as a parenthetical. If a criterion is a concrete example, the correct
30
- response is an example-based test, not an edit to the spec.
31
- - A comparison of this repo against another repo's ratio.
32
-
33
- Phrase counts as facts: "59 criteria are concrete examples" — not "only 43% are
34
- extractable" and never "consider rewriting the 59 example criteria as properties."
35
-
36
- ## What is worth flagging (as information)
37
-
38
- - Records with `row_id: null` — they cannot be tagged, so they cannot be reconciled. Route
39
- recorded as a finding with reason `no-row-id`.
40
- - Documents that produced zero criteria — usually the archetype binds no `ac` grammar
41
- (US and IT are unbound), which is expected, not a gap.
42
- - A `candidate` count above zero — rare (0.4% of the corpus). Worth naming because every
43
- one of them is review-gated by construction.
44
-
45
- ## Archetype note
46
-
47
- Do **not** down-weight StR. The measured ranking is StR 29.1% > NFR 28.9% > FR 19.2%
48
- (quire-rs CR-029, which falsified the earlier CR-020 prediction that StR would score low).
49
- Stakeholder criteria produce good properties.
50
-
51
- ## Output of this step
52
-
53
- The census tables, plus the working set for step 2: every record with a `row_id`.