@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.
- package/README.md +8 -258
- package/bin/launcher.js +138 -0
- package/package.json +22 -123
- package/.agents/plugins/marketplace.json +0 -14
- package/.claude-plugin/marketplace.json +0 -16
- package/.claude-plugin/plugin.json +0 -8
- package/.codex-plugin/plugin.json +0 -27
- package/.github/plugin/marketplace.json +0 -16
- package/bin/quoin.js +0 -21
- package/default-modules.yaml +0 -107
- package/dist/advisor/advise.d.ts +0 -199
- package/dist/advisor/advise.d.ts.map +0 -1
- package/dist/advisor/index.d.ts +0 -10
- package/dist/advisor/index.d.ts.map +0 -1
- package/dist/advisor/methods.d.ts +0 -60
- package/dist/advisor/methods.d.ts.map +0 -1
- package/dist/advisor-B0rESCx1.js +0 -63
- package/dist/assurance/graph.d.ts +0 -87
- package/dist/assurance/graph.d.ts.map +0 -1
- package/dist/assurance/index.d.ts +0 -9
- package/dist/assurance/index.d.ts.map +0 -1
- package/dist/assurance/render.d.ts +0 -3
- package/dist/assurance/render.d.ts.map +0 -1
- package/dist/auditor/audit.d.ts +0 -146
- package/dist/auditor/audit.d.ts.map +0 -1
- package/dist/auditor/combinatorial.d.ts +0 -53
- package/dist/auditor/combinatorial.d.ts.map +0 -1
- package/dist/auditor/index.d.ts +0 -9
- package/dist/auditor/index.d.ts.map +0 -1
- package/dist/auditor-Dd3i9Aqx.js +0 -340
- package/dist/base-gAClyCNd.js +0 -137
- package/dist/base.d.ts +0 -23
- package/dist/base.d.ts.map +0 -1
- package/dist/catalog.d.ts +0 -33
- package/dist/catalog.d.ts.map +0 -1
- package/dist/change-assurance/attestations.d.ts +0 -7
- package/dist/change-assurance/attestations.d.ts.map +0 -1
- package/dist/change-assurance/index.d.ts +0 -14
- package/dist/change-assurance/index.d.ts.map +0 -1
- package/dist/change-assurance/integrity.d.ts +0 -11
- package/dist/change-assurance/integrity.d.ts.map +0 -1
- package/dist/change-assurance/records.d.ts +0 -22
- package/dist/change-assurance/records.d.ts.map +0 -1
- package/dist/change-assurance/schema-assets.d.ts +0 -8
- package/dist/change-assurance/schema-assets.d.ts.map +0 -1
- package/dist/change-assurance/store.d.ts +0 -18
- package/dist/change-assurance/store.d.ts.map +0 -1
- package/dist/change-assurance/types.d.ts +0 -180
- package/dist/change-assurance/types.d.ts.map +0 -1
- package/dist/change-assurance/verify.d.ts +0 -4
- package/dist/change-assurance/verify.d.ts.map +0 -1
- package/dist/change-assurance-CyKLPeKa.js +0 -1236
- package/dist/cli.d.ts +0 -61
- package/dist/cli.d.ts.map +0 -1
- package/dist/cli.js +0 -34
- package/dist/commands/advise.d.ts +0 -16
- package/dist/commands/advise.d.ts.map +0 -1
- package/dist/commands/advise.js +0 -234
- package/dist/commands/assurance.d.ts +0 -14
- package/dist/commands/assurance.d.ts.map +0 -1
- package/dist/commands/assurance.js +0 -204
- package/dist/commands/catalog/index.d.ts +0 -2
- package/dist/commands/catalog/index.d.ts.map +0 -1
- package/dist/commands/catalog/index.js +0 -2
- package/dist/commands/catalog/list.d.ts +0 -11
- package/dist/commands/catalog/list.d.ts.map +0 -1
- package/dist/commands/catalog/list.js +0 -22
- package/dist/commands/catalog/methods.d.ts +0 -12
- package/dist/commands/catalog/methods.d.ts.map +0 -1
- package/dist/commands/catalog/methods.js +0 -43
- package/dist/commands/catalog/show.d.ts +0 -13
- package/dist/commands/catalog/show.d.ts.map +0 -1
- package/dist/commands/catalog/show.js +0 -25
- package/dist/commands/catalog/validate.d.ts +0 -10
- package/dist/commands/catalog/validate.d.ts.map +0 -1
- package/dist/commands/catalog/validate.js +0 -27
- package/dist/commands/change-assurance/common.d.ts +0 -37
- package/dist/commands/change-assurance/common.d.ts.map +0 -1
- package/dist/commands/change-assurance/index.d.ts +0 -8
- package/dist/commands/change-assurance/index.d.ts.map +0 -1
- package/dist/commands/change-assurance/index.js +0 -12
- package/dist/commands/change-assurance/intake.d.ts +0 -15
- package/dist/commands/change-assurance/intake.d.ts.map +0 -1
- package/dist/commands/change-assurance/intake.js +0 -53
- package/dist/commands/change-assurance/receipt.d.ts +0 -21
- package/dist/commands/change-assurance/receipt.d.ts.map +0 -1
- package/dist/commands/change-assurance/receipt.js +0 -99
- package/dist/commands/change-assurance/recover.d.ts +0 -13
- package/dist/commands/change-assurance/recover.d.ts.map +0 -1
- package/dist/commands/change-assurance/recover.js +0 -29
- package/dist/commands/change-assurance/schema.d.ts +0 -13
- package/dist/commands/change-assurance/schema.d.ts.map +0 -1
- package/dist/commands/change-assurance/schema.js +0 -40
- package/dist/commands/change-assurance/seal-attestation.d.ts +0 -15
- package/dist/commands/change-assurance/seal-attestation.d.ts.map +0 -1
- package/dist/commands/change-assurance/seal-attestation.js +0 -58
- package/dist/commands/change-assurance/seal-record.d.ts +0 -14
- package/dist/commands/change-assurance/seal-record.d.ts.map +0 -1
- package/dist/commands/change-assurance/seal-record.js +0 -53
- package/dist/commands/change-assurance/verify-receipt.d.ts +0 -13
- package/dist/commands/change-assurance/verify-receipt.d.ts.map +0 -1
- package/dist/commands/change-assurance/verify-receipt.js +0 -41
- package/dist/commands/completeness.d.ts +0 -16
- package/dist/commands/completeness.d.ts.map +0 -1
- package/dist/commands/completeness.js +0 -49
- package/dist/commands/config/doctor.d.ts +0 -7
- package/dist/commands/config/doctor.d.ts.map +0 -1
- package/dist/commands/config/doctor.js +0 -15
- package/dist/commands/config/edit.d.ts +0 -7
- package/dist/commands/config/edit.d.ts.map +0 -1
- package/dist/commands/config/edit.js +0 -13
- package/dist/commands/config/get.d.ts +0 -11
- package/dist/commands/config/get.d.ts.map +0 -1
- package/dist/commands/config/get.js +0 -20
- package/dist/commands/config/index.d.ts +0 -2
- package/dist/commands/config/index.d.ts.map +0 -1
- package/dist/commands/config/index.js +0 -2
- package/dist/commands/config/set.d.ts +0 -12
- package/dist/commands/config/set.d.ts.map +0 -1
- package/dist/commands/config/set.js +0 -26
- package/dist/commands/evidence/affirm.d.ts +0 -17
- package/dist/commands/evidence/affirm.d.ts.map +0 -1
- package/dist/commands/evidence/affirm.js +0 -65
- package/dist/commands/evidence/audit.d.ts +0 -34
- package/dist/commands/evidence/audit.d.ts.map +0 -1
- package/dist/commands/evidence/audit.js +0 -107
- package/dist/commands/evidence/baseline.d.ts +0 -14
- package/dist/commands/evidence/baseline.d.ts.map +0 -1
- package/dist/commands/evidence/baseline.js +0 -89
- package/dist/commands/evidence/gc.d.ts +0 -13
- package/dist/commands/evidence/gc.d.ts.map +0 -1
- package/dist/commands/evidence/gc.js +0 -35
- package/dist/commands/evidence/index.d.ts +0 -8
- package/dist/commands/evidence/index.d.ts.map +0 -1
- package/dist/commands/evidence/index.js +0 -18
- package/dist/commands/evidence/inspect-mocks.d.ts +0 -16
- package/dist/commands/evidence/inspect-mocks.d.ts.map +0 -1
- package/dist/commands/evidence/inspect-mocks.js +0 -49
- package/dist/commands/evidence/record.d.ts +0 -22
- package/dist/commands/evidence/record.d.ts.map +0 -1
- package/dist/commands/evidence/record.js +0 -144
- package/dist/commands/graph/change-impact.d.ts +0 -16
- package/dist/commands/graph/change-impact.d.ts.map +0 -1
- package/dist/commands/graph/change-impact.js +0 -29
- package/dist/commands/graph/churn.d.ts +0 -14
- package/dist/commands/graph/churn.d.ts.map +0 -1
- package/dist/commands/graph/churn.js +0 -15
- package/dist/commands/graph/common.d.ts +0 -16
- package/dist/commands/graph/common.d.ts.map +0 -1
- package/dist/commands/graph/fan-out.d.ts +0 -14
- package/dist/commands/graph/fan-out.d.ts.map +0 -1
- package/dist/commands/graph/fan-out.js +0 -15
- package/dist/commands/graph/index.d.ts +0 -8
- package/dist/commands/graph/index.d.ts.map +0 -1
- package/dist/commands/graph/index.js +0 -12
- package/dist/commands/matrix.d.ts +0 -14
- package/dist/commands/matrix.d.ts.map +0 -1
- package/dist/commands/matrix.js +0 -15
- package/dist/commands/measurement/index.d.ts +0 -7
- package/dist/commands/measurement/index.d.ts.map +0 -1
- package/dist/commands/measurement/index.js +0 -11
- package/dist/commands/measurement/intervention.d.ts +0 -11
- package/dist/commands/measurement/intervention.d.ts.map +0 -1
- package/dist/commands/measurement/intervention.js +0 -31
- package/dist/commands/measurement/operational-release.d.ts +0 -11
- package/dist/commands/measurement/operational-release.d.ts.map +0 -1
- package/dist/commands/measurement/operational-release.js +0 -31
- package/dist/commands/measurement/record.d.ts +0 -10
- package/dist/commands/measurement/record.d.ts.map +0 -1
- package/dist/commands/measurement/record.js +0 -36
- package/dist/commands/module/ensure-defaults.d.ts +0 -8
- package/dist/commands/module/ensure-defaults.d.ts.map +0 -1
- package/dist/commands/module/ensure-defaults.js +0 -17
- package/dist/commands/module/index.d.ts +0 -2
- package/dist/commands/module/index.d.ts.map +0 -1
- package/dist/commands/module/index.js +0 -2
- package/dist/commands/module/install.d.ts +0 -11
- package/dist/commands/module/install.d.ts.map +0 -1
- package/dist/commands/module/install.js +0 -22
- package/dist/commands/module/list.d.ts +0 -8
- package/dist/commands/module/list.d.ts.map +0 -1
- package/dist/commands/module/list.js +0 -13
- package/dist/commands/module/remove.d.ts +0 -10
- package/dist/commands/module/remove.d.ts.map +0 -1
- package/dist/commands/module/remove.js +0 -16
- package/dist/commands/plugin/deprecation.d.ts +0 -10
- package/dist/commands/plugin/deprecation.d.ts.map +0 -1
- package/dist/commands/plugin/ensure-defaults.d.ts +0 -8
- package/dist/commands/plugin/ensure-defaults.d.ts.map +0 -1
- package/dist/commands/plugin/ensure-defaults.js +0 -12
- package/dist/commands/plugin/index.d.ts +0 -2
- package/dist/commands/plugin/index.d.ts.map +0 -1
- package/dist/commands/plugin/index.js +0 -2
- package/dist/commands/plugin/install.d.ts +0 -8
- package/dist/commands/plugin/install.d.ts.map +0 -1
- package/dist/commands/plugin/install.js +0 -12
- package/dist/commands/plugin/list.d.ts +0 -8
- package/dist/commands/plugin/list.d.ts.map +0 -1
- package/dist/commands/plugin/list.js +0 -12
- package/dist/commands/plugin/remove.d.ts +0 -8
- package/dist/commands/plugin/remove.d.ts.map +0 -1
- package/dist/commands/plugin/remove.js +0 -12
- package/dist/commands/report.d.ts +0 -19
- package/dist/commands/report.d.ts.map +0 -1
- package/dist/commands/report.js +0 -96
- package/dist/commands/review.d.ts +0 -14
- package/dist/commands/review.d.ts.map +0 -1
- package/dist/commands/review.js +0 -15
- package/dist/commands/to-plan.d.ts +0 -14
- package/dist/commands/to-plan.d.ts.map +0 -1
- package/dist/commands/to-plan.js +0 -15
- package/dist/commands/update.d.ts +0 -13
- package/dist/commands/update.d.ts.map +0 -1
- package/dist/commands/update.js +0 -34
- package/dist/commands/validate.d.ts +0 -13
- package/dist/commands/validate.d.ts.map +0 -1
- package/dist/commands/validate.js +0 -123
- package/dist/commands/write.d.ts +0 -16
- package/dist/commands/write.d.ts.map +0 -1
- package/dist/commands/write.js +0 -33
- package/dist/common-B1ZJ8CSO.js +0 -36
- package/dist/common-DTrmnvL-.js +0 -35
- package/dist/completeness/assess.d.ts +0 -82
- package/dist/completeness/assess.d.ts.map +0 -1
- package/dist/completeness/bundle.d.ts +0 -52
- package/dist/completeness/bundle.d.ts.map +0 -1
- package/dist/completeness/declarations.d.ts +0 -46
- package/dist/completeness/declarations.d.ts.map +0 -1
- package/dist/completeness/index.d.ts +0 -11
- package/dist/completeness/index.d.ts.map +0 -1
- package/dist/completeness/run.d.ts +0 -35
- package/dist/completeness/run.d.ts.map +0 -1
- package/dist/completeness-BzBuNq6w.js +0 -228
- package/dist/config-schema-Dp-vlxuR.js +0 -13
- package/dist/config-schema.d.ts +0 -52
- package/dist/config-schema.d.ts.map +0 -1
- package/dist/deprecation-fRxUHoxv.js +0 -4
- package/dist/evidence/adapters/agent-eval.d.ts +0 -26
- package/dist/evidence/adapters/agent-eval.d.ts.map +0 -1
- package/dist/evidence/adapters/audit-script.d.ts +0 -25
- package/dist/evidence/adapters/audit-script.d.ts.map +0 -1
- package/dist/evidence/adapters/cargo-mutants.d.ts +0 -3
- package/dist/evidence/adapters/cargo-mutants.d.ts.map +0 -1
- package/dist/evidence/adapters/contract-conformance.d.ts +0 -16
- package/dist/evidence/adapters/contract-conformance.d.ts.map +0 -1
- package/dist/evidence/adapters/differential-report.d.ts +0 -18
- package/dist/evidence/adapters/differential-report.d.ts.map +0 -1
- package/dist/evidence/adapters/junit.d.ts +0 -17
- package/dist/evidence/adapters/junit.d.ts.map +0 -1
- package/dist/evidence/adapters/registry.d.ts +0 -63
- package/dist/evidence/adapters/registry.d.ts.map +0 -1
- package/dist/evidence/adapters/sarif.d.ts +0 -35
- package/dist/evidence/adapters/sarif.d.ts.map +0 -1
- package/dist/evidence/adapters/sbom.d.ts +0 -35
- package/dist/evidence/adapters/sbom.d.ts.map +0 -1
- package/dist/evidence/adapters/types.d.ts +0 -86
- package/dist/evidence/adapters/types.d.ts.map +0 -1
- package/dist/evidence/index.d.ts +0 -27
- package/dist/evidence/index.d.ts.map +0 -1
- package/dist/evidence/mock-inspection.d.ts +0 -16
- package/dist/evidence/mock-inspection.d.ts.map +0 -1
- package/dist/evidence/record.d.ts +0 -58
- package/dist/evidence/record.d.ts.map +0 -1
- package/dist/evidence/store.d.ts +0 -215
- package/dist/evidence/store.d.ts.map +0 -1
- package/dist/evidence/types.d.ts +0 -281
- package/dist/evidence/types.d.ts.map +0 -1
- package/dist/evidence-OyqpqHLS.js +0 -614
- package/dist/flow-command-CCRTE5Oe.js +0 -88
- package/dist/flow-command.d.ts +0 -25
- package/dist/flow-command.d.ts.map +0 -1
- package/dist/flows.d.ts +0 -7
- package/dist/flows.d.ts.map +0 -1
- package/dist/graph-analysis/analysis.d.ts +0 -106
- package/dist/graph-analysis/analysis.d.ts.map +0 -1
- package/dist/graph-analysis/index.d.ts +0 -6
- package/dist/graph-analysis/index.d.ts.map +0 -1
- package/dist/graph-analysis/input.d.ts +0 -33
- package/dist/graph-analysis/input.d.ts.map +0 -1
- package/dist/graph-analysis/load.d.ts +0 -21
- package/dist/graph-analysis/load.d.ts.map +0 -1
- package/dist/graph-analysis/render.d.ts +0 -4
- package/dist/graph-analysis/render.d.ts.map +0 -1
- package/dist/graph-analysis-IWaoJJSN.js +0 -657
- package/dist/hooks/command-not-found.d.ts +0 -23
- package/dist/hooks/command-not-found.d.ts.map +0 -1
- package/dist/hooks/command-not-found.js +0 -8
- package/dist/index.d.ts +0 -13
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js +0 -12
- package/dist/measurement/agent-eval-intervention.d.ts +0 -6
- package/dist/measurement/agent-eval-intervention.d.ts.map +0 -1
- package/dist/measurement/atomic-file.d.ts +0 -5
- package/dist/measurement/atomic-file.d.ts.map +0 -1
- package/dist/measurement/compare.d.ts +0 -4
- package/dist/measurement/compare.d.ts.map +0 -1
- package/dist/measurement/date-time.d.ts +0 -3
- package/dist/measurement/date-time.d.ts.map +0 -1
- package/dist/measurement/github-release-operational.d.ts +0 -7
- package/dist/measurement/github-release-operational.d.ts.map +0 -1
- package/dist/measurement/graph-adapters.d.ts +0 -304
- package/dist/measurement/graph-adapters.d.ts.map +0 -1
- package/dist/measurement/graph-portfolio-load.d.ts +0 -3
- package/dist/measurement/graph-portfolio-load.d.ts.map +0 -1
- package/dist/measurement/graph-portfolio.d.ts +0 -158
- package/dist/measurement/graph-portfolio.d.ts.map +0 -1
- package/dist/measurement/index.d.ts +0 -22
- package/dist/measurement/index.d.ts.map +0 -1
- package/dist/measurement/intervention-report.d.ts +0 -24
- package/dist/measurement/intervention-report.d.ts.map +0 -1
- package/dist/measurement/intervention-schema.d.ts +0 -144
- package/dist/measurement/intervention-schema.d.ts.map +0 -1
- package/dist/measurement/intervention-types.d.ts +0 -105
- package/dist/measurement/intervention-types.d.ts.map +0 -1
- package/dist/measurement/intervention.d.ts +0 -16
- package/dist/measurement/intervention.d.ts.map +0 -1
- package/dist/measurement/operational-report.d.ts +0 -17
- package/dist/measurement/operational-report.d.ts.map +0 -1
- package/dist/measurement/operational-schema.d.ts +0 -461
- package/dist/measurement/operational-schema.d.ts.map +0 -1
- package/dist/measurement/operational-types.d.ts +0 -121
- package/dist/measurement/operational-types.d.ts.map +0 -1
- package/dist/measurement/operational.d.ts +0 -13
- package/dist/measurement/operational.d.ts.map +0 -1
- package/dist/measurement/plans.d.ts +0 -6
- package/dist/measurement/plans.d.ts.map +0 -1
- package/dist/measurement/portfolio.d.ts +0 -54
- package/dist/measurement/portfolio.d.ts.map +0 -1
- package/dist/measurement/profiles.d.ts +0 -9
- package/dist/measurement/profiles.d.ts.map +0 -1
- package/dist/measurement/report.d.ts +0 -48
- package/dist/measurement/report.d.ts.map +0 -1
- package/dist/measurement/schemas/operational-evidence-v1.schema.json.d.ts +0 -384
- package/dist/measurement/store.d.ts +0 -14
- package/dist/measurement/store.d.ts.map +0 -1
- package/dist/measurement/types.d.ts +0 -85
- package/dist/measurement/types.d.ts.map +0 -1
- package/dist/measurement/validate.d.ts +0 -9
- package/dist/measurement/validate.d.ts.map +0 -1
- package/dist/measurement-j8sDSqx5.js +0 -2980
- package/dist/modules-DDQkKC4l.js +0 -23
- package/dist/modules.d.ts +0 -10
- package/dist/modules.d.ts.map +0 -1
- package/dist/org.d.ts +0 -61
- package/dist/org.d.ts.map +0 -1
- package/dist/plugins-CHpYhpEI.js +0 -77
- package/dist/plugins.d.ts +0 -13
- package/dist/plugins.d.ts.map +0 -1
- package/dist/quire/assurance.d.ts +0 -109
- package/dist/quire/assurance.d.ts.map +0 -1
- package/dist/quire/contract.d.ts +0 -88
- package/dist/quire/contract.d.ts.map +0 -1
- package/dist/quire/exec.d.ts +0 -66
- package/dist/quire/exec.d.ts.map +0 -1
- package/dist/quire/index.d.ts +0 -13
- package/dist/quire/index.d.ts.map +0 -1
- package/dist/quire/types.d.ts +0 -415
- package/dist/quire/types.d.ts.map +0 -1
- package/dist/quire/validate.d.ts +0 -39
- package/dist/quire/validate.d.ts.map +0 -1
- package/dist/quire-BsVj1xIR.js +0 -4968
- package/dist/schema-assets-HZWo_iFN.js +0 -233
- package/dist/schemas/assurance-v1.schema.json +0 -225
- package/dist/schemas/change-assurance-record-v1.schema.json +0 -234
- package/dist/schemas/coverage-v1.schema.json +0 -1111
- package/dist/schemas/operational-evidence-v1.schema.json +0 -381
- package/dist/schemas/proof-attestation-v1.schema.json +0 -96
- package/dist/schemas/properties-v1.schema.json +0 -159
- package/dist/schemas/verification-receipt-v1.schema.json +0 -208
- package/dist/validators/gates.d.ts +0 -18
- package/dist/validators/gates.d.ts.map +0 -1
- package/dist/validators/index.d.ts +0 -2
- package/dist/validators/index.d.ts.map +0 -1
- package/dist/version-CMxMIh5g.js +0 -17
- package/dist/version.d.ts +0 -3
- package/dist/version.d.ts.map +0 -1
- package/dist/write-CGTI0dRO.js +0 -157
- package/dist/write.d.ts +0 -28
- package/dist/write.d.ts.map +0 -1
- package/skills/assurance-status-report/SKILL.md +0 -135
- package/skills/assurance-status-report/references/report-contract.md +0 -110
- package/skills/gap-analysis/SKILL.md +0 -111
- package/skills/gap-analysis/references/step-1-target-selection.md +0 -53
- package/skills/gap-analysis/references/step-2-plan-completion.md +0 -49
- package/skills/gap-analysis/references/step-3-matrix-verification.md +0 -147
- package/skills/gap-analysis/references/step-4-underspecified-code.md +0 -92
- package/skills/gap-analysis/references/step-5-semantic-review.md +0 -51
- package/skills/gap-analysis/references/step-6-specreview-artifact.md +0 -108
- package/skills/spec-app-review/SKILL.md +0 -51
- package/skills/spec-app-review/references/checklist.md +0 -197
- package/skills/spec-architecture-evaluation/SKILL.md +0 -30
- package/skills/spec-correctness/SKILL.md +0 -96
- package/skills/spec-correctness/assets/strategy-table.md +0 -101
- package/skills/spec-correctness/assets/templates/fast-check.ts.md +0 -169
- package/skills/spec-correctness/assets/templates/hypothesis.py.md +0 -156
- package/skills/spec-correctness/assets/templates/proptest.rs.md +0 -147
- package/skills/spec-correctness/references/step-0-scope-and-harness.md +0 -94
- package/skills/spec-correctness/references/step-1-census.md +0 -53
- package/skills/spec-correctness/references/step-2-clause-grounding.md +0 -159
- package/skills/spec-correctness/references/step-3-strategy-selection.md +0 -85
- package/skills/spec-correctness/references/step-4-generate-tests.md +0 -117
- package/skills/spec-correctness/references/step-5-second-pass.md +0 -81
- package/skills/spec-correctness/references/step-6-review-artifact.md +0 -134
- package/skills/spec-correctness/references/step-7-report-and-handoff.md +0 -102
- package/skills/spec-dependency-analysis/SKILL.md +0 -90
- package/skills/spec-ears-analysis/SKILL.md +0 -102
- package/skills/spec-evidence-analysis/SKILL.md +0 -156
- package/skills/spec-failure-domain-analysis/SKILL.md +0 -59
- package/skills/spec-fuzz/SKILL.md +0 -133
- package/skills/spec-fuzz/assets/templates/atheris.py.md +0 -74
- package/skills/spec-fuzz/assets/templates/cargo-fuzz.rs.md +0 -83
- package/skills/spec-fuzz/assets/templates/fast-check.ts.md +0 -76
- package/skills/spec-fuzz/references/step-0-scope-and-harness.md +0 -51
- package/skills/spec-fuzz/references/step-1-select-obligations.md +0 -47
- package/skills/spec-fuzz/references/step-2-ground-entry-point.md +0 -55
- package/skills/spec-fuzz/references/step-3-emit-targets.md +0 -65
- package/skills/spec-fuzz/references/step-4-report.md +0 -56
- package/skills/spec-ideation/SKILL.md +0 -46
- package/skills/spec-integrity-analysis/SKILL.md +0 -62
- package/skills/spec-matrix/SKILL.md +0 -186
- package/skills/spec-matrix/assets/test-cases/TC-001.md +0 -35
- package/skills/spec-matrix/assets/test-cases/TC-002.md +0 -37
- package/skills/spec-matrix/assets/test-cases/TC-006.md +0 -50
- package/skills/spec-matrix/assets/test-matrix-example.md +0 -104
- package/skills/spec-matrix/assets/test-matrix-template.md +0 -123
- package/skills/spec-matrix/workflow-assets/dist/index.d.ts +0 -146
- package/skills/spec-matrix/workflow-assets/dist/index.d.ts.map +0 -1
- package/skills/spec-matrix/workflow-assets/dist/index.js +0 -7525
- package/skills/spec-matrix/workflow-assets/dist/invariants.d.ts +0 -6
- package/skills/spec-matrix/workflow-assets/dist/invariants.d.ts.map +0 -1
- package/skills/spec-matrix/workflow-assets/skills/matrix/SKILL.md +0 -35
- package/skills/spec-matrix/workflow-assets/skills/matrix/scripts/invariants.js +0 -1
- package/skills/spec-matrix/workflow-assets/skills/matrix/templates/report/default.md +0 -30
- package/skills/spec-matrix/workflow-assets/skills/matrix/workflows/matrix/def.yaml +0 -82
- package/skills/spec-object-review/SKILL.md +0 -125
- package/skills/spec-object-review/references/object-type-guide.md +0 -118
- package/skills/spec-review/SKILL.md +0 -92
- package/skills/spec-review/references/checklist.md +0 -50
- package/skills/spec-review/workflow-assets/dist/index.d.ts +0 -146
- package/skills/spec-review/workflow-assets/dist/index.d.ts.map +0 -1
- package/skills/spec-review/workflow-assets/dist/index.js +0 -7525
- package/skills/spec-review/workflow-assets/dist/invariants.d.ts +0 -6
- package/skills/spec-review/workflow-assets/dist/invariants.d.ts.map +0 -1
- package/skills/spec-review/workflow-assets/skills/review/SKILL.md +0 -96
- package/skills/spec-review/workflow-assets/skills/review/scripts/invariants.js +0 -61
- package/skills/spec-review/workflow-assets/skills/review/workflows/review/def.yaml +0 -68
- package/skills/spec-risk-complexity-analysis/SKILL.md +0 -92
- package/skills/spec-scope-boundary-analysis/SKILL.md +0 -101
- package/skills/spec-security-analysis/SKILL.md +0 -84
- package/skills/spec-security-analysis/assets/security-analysis-example.md +0 -89
- package/skills/spec-security-analysis/assets/security-analysis-template.md +0 -73
- package/skills/spec-security-analysis/references/component-type-mapping.md +0 -161
- package/skills/spec-security-analysis/references/gdpr/ChII-Principles.md +0 -58
- package/skills/spec-security-analysis/references/gdpr/ChIII-DataSubjectRights.md +0 -84
- package/skills/spec-security-analysis/references/gdpr/ChIV-ControllerProcessor.md +0 -83
- package/skills/spec-security-analysis/references/gdpr/ChV-DataTransfers.md +0 -62
- package/skills/spec-security-analysis/references/gdpr/index.md +0 -54
- package/skills/spec-security-analysis/references/iso27001/A5-OrganizationalControls.md +0 -64
- package/skills/spec-security-analysis/references/iso27001/A6-PeopleControls.md +0 -30
- package/skills/spec-security-analysis/references/iso27001/A7-PhysicalControls.md +0 -35
- package/skills/spec-security-analysis/references/iso27001/A8-TechnologicalControls.md +0 -66
- package/skills/spec-security-analysis/references/iso27001/index.md +0 -43
- package/skills/spec-security-analysis/references/nist-800-53/AC-AccessControl.md +0 -57
- package/skills/spec-security-analysis/references/nist-800-53/AU-AuditAccountability.md +0 -49
- package/skills/spec-security-analysis/references/nist-800-53/CM-ConfigurationManagement.md +0 -36
- package/skills/spec-security-analysis/references/nist-800-53/IA-IdentificationAuthentication.md +0 -44
- package/skills/spec-security-analysis/references/nist-800-53/SA-SystemServicesAcquisition.md +0 -50
- package/skills/spec-security-analysis/references/nist-800-53/SC-SystemCommunications.md +0 -53
- package/skills/spec-security-analysis/references/nist-800-53/SI-SystemInformationIntegrity.md +0 -52
- package/skills/spec-security-analysis/references/nist-800-53/index.md +0 -58
- package/skills/spec-security-analysis/references/owasp-asvs/V1-Architecture.md +0 -33
- package/skills/spec-security-analysis/references/owasp-asvs/V10-MaliciousCode.md +0 -33
- package/skills/spec-security-analysis/references/owasp-asvs/V11-BusinessLogic.md +0 -32
- package/skills/spec-security-analysis/references/owasp-asvs/V12-Files.md +0 -34
- package/skills/spec-security-analysis/references/owasp-asvs/V13-API.md +0 -34
- package/skills/spec-security-analysis/references/owasp-asvs/V14-Configuration.md +0 -35
- package/skills/spec-security-analysis/references/owasp-asvs/V2-Authentication.md +0 -36
- package/skills/spec-security-analysis/references/owasp-asvs/V3-SessionManagement.md +0 -35
- package/skills/spec-security-analysis/references/owasp-asvs/V4-AccessControl.md +0 -39
- package/skills/spec-security-analysis/references/owasp-asvs/V5-Validation.md +0 -37
- package/skills/spec-security-analysis/references/owasp-asvs/V6-Cryptography.md +0 -34
- package/skills/spec-security-analysis/references/owasp-asvs/V7-ErrorLogging.md +0 -37
- package/skills/spec-security-analysis/references/owasp-asvs/V8-DataProtection.md +0 -34
- package/skills/spec-security-analysis/references/owasp-asvs/V9-Communication.md +0 -32
- package/skills/spec-security-analysis/references/owasp-asvs/index.md +0 -59
- package/skills/spec-security-analysis/references/soc2/CC1-ControlEnvironment.md +0 -31
- package/skills/spec-security-analysis/references/soc2/CC2-CommunicationInformation.md +0 -27
- package/skills/spec-security-analysis/references/soc2/CC3-RiskAssessment.md +0 -29
- package/skills/spec-security-analysis/references/soc2/CC4-MonitoringActivities.md +0 -27
- package/skills/spec-security-analysis/references/soc2/CC5-ControlActivities.md +0 -28
- package/skills/spec-security-analysis/references/soc2/CC6-LogicalPhysicalAccess.md +0 -45
- package/skills/spec-security-analysis/references/soc2/CC7-SystemOperations.md +0 -42
- package/skills/spec-security-analysis/references/soc2/CC8-ChangeManagement.md +0 -32
- package/skills/spec-security-analysis/references/soc2/CC9-RiskMitigation.md +0 -34
- package/skills/spec-security-analysis/references/soc2/index.md +0 -46
- package/skills/spec-security-analysis/references/standards-index.md +0 -46
- package/skills/spec-to-plan/SKILL.md +0 -88
- package/skills/spec-to-plan/references/step-0-plan-selection.md +0 -121
- package/skills/spec-to-plan/references/step-1-analysis.md +0 -88
- package/skills/spec-to-plan/references/step-2-test-plan.md +0 -43
- package/skills/spec-to-plan/references/step-3-execution-plan.md +0 -218
- package/skills/spec-to-plan/workflow-assets/dist/index.d.ts +0 -146
- package/skills/spec-to-plan/workflow-assets/dist/index.d.ts.map +0 -1
- package/skills/spec-to-plan/workflow-assets/dist/index.js +0 -7525
- package/skills/spec-to-plan/workflow-assets/dist/invariants.d.ts +0 -6
- package/skills/spec-to-plan/workflow-assets/dist/invariants.d.ts.map +0 -1
- package/skills/spec-to-plan/workflow-assets/skills/to-plan/SKILL.md +0 -35
- package/skills/spec-to-plan/workflow-assets/skills/to-plan/scripts/invariants.js +0 -1
- package/skills/spec-to-plan/workflow-assets/skills/to-plan/templates/implementation-plan/default.md +0 -44
- package/skills/spec-to-plan/workflow-assets/skills/to-plan/workflows/to-plan/def.yaml +0 -85
- package/skills/specify/SKILL.md +0 -154
- package/skills/specify/assets/app-spec-template.md +0 -143
- package/skills/specify/assets/spec-template.md +0 -299
- package/skills/specify/references/integration-tests.md +0 -72
- package/skills/specify/references/us-to-fr.md +0 -40
- 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`.
|