33 lines
3.0 KiB
Markdown
33 lines
3.0 KiB
Markdown
# Capability Spec Delta: idempotency (spec-conformance)
|
|
|
|
**Package**: `@suaveplan/idempotency`
|
|
**Status**: PROPOSED
|
|
|
|
This delta annotates each existing requirement in `openspec/specs/idempotency/spec.md` with a `**Verified by:**` line and rewrites the heading style from `REQ-IDMP-NNN — name` to `IDMP-NN — name` so the conformance parser ingests them. No requirement semantics change.
|
|
|
|
## MODIFIED Requirements
|
|
|
|
(See `openspec/specs/idempotency/spec.md` for the full requirement bodies; this delta only records the verification mapping.)
|
|
|
|
| Requirement | Verified by |
|
|
|---|---|
|
|
| IDMP-01 — Structured error hierarchy | `src/errors/idempotency-error.test.ts` AND `src/error-codes.test.ts` AND `src/errors/idempotency-error.spec-conformance.test.ts` |
|
|
| IDMP-02 — Zod schemas for all public config types | `src/schemas/idempotency.schemas.spec-conformance.test.ts` |
|
|
| IDMP-03 — Injectable clock and RNG | `src/guard/idempotency-guard.test.ts` AND `src/distributed/distributed-guard.test.ts` AND `src/metrics/idempotency-metrics.test.ts` AND `src/key/key-generator.test.ts` AND `src/guard/idempotency-guard.spec-conformance.test.ts` |
|
|
| IDMP-04 — AbortSignal support throughout | `src/guard/idempotency-guard.test.ts` AND `src/distributed/distributed-guard.test.ts` AND `src/guard/idempotency-guard.spec-conformance.test.ts` |
|
|
| IDMP-05 — OTel instrumentation via `@opentelemetry/api` | `src/metrics/idempotency-metrics.test.ts` AND `src/metrics/idempotency-metrics.spec-conformance.test.ts` |
|
|
| IDMP-06 — Property-based tests with fast-check | `tests/property.test.ts` |
|
|
| IDMP-07 — Benchmarks with mitata | `src/__benchmarks__/idempotency.bench.ts` AND `tests/benchmarks-present.spec-conformance.test.ts` |
|
|
| IDMP-08 — Store adapter extensibility | `src/store/memory-store.test.ts` AND `src/store/database-store.test.ts` AND `src/store/redis-store.test.ts` AND `src/distributed/distributed-guard.test.ts` AND `tests/structural-adapters.spec-conformance.test.ts` |
|
|
| IDMP-09 — Real services for integration tests; no mock stores in unit tests | `tests/no-disallowed.test.ts` AND `src/store/memory-store.test.ts` |
|
|
| IDMP-10 — 100% test coverage | `vitest.config.ts` (Istanbul thresholds 100/100/100/100) plus the `bunx turbo test:coverage --filter=@suaveplan/idempotency` gate |
|
|
|
|
## Newly added tests in this change
|
|
|
|
- `src/errors/idempotency-error.spec-conformance.test.ts` — pins error-hierarchy and namespace invariants.
|
|
- `src/schemas/idempotency.schemas.spec-conformance.test.ts` — pins every required Zod schema export and a representative round-trip.
|
|
- `src/guard/idempotency-guard.spec-conformance.test.ts` — pins clock-driven TTL semantics and AbortSignal mid-flight.
|
|
- `src/metrics/idempotency-metrics.spec-conformance.test.ts` — pins OTel no-op behaviour and the five required instrument labels.
|
|
- `tests/structural-adapters.spec-conformance.test.ts` — pins that plain-object store and lock-provider implementations are accepted.
|
|
- `tests/benchmarks-present.spec-conformance.test.ts` — pins the canonical benchmark suite location and coverage of all four hot paths.
|