suaveplan/openspec/archive/2026-04-19-enterprise-api-schemas/tasks.md

Tasks: enterprise-api-schemas

1. Scaffold

• 1.1 universal/docs/api-schemas/; 100/100/100/100; guard tests; CLAUDE/README/FOLDERS.

2. Common group

• 2.1 src/common/pagination.ts, sort.ts, filter.ts, id-param.ts, timestamps.ts, error-envelope.ts.
• 2.2 Co-located .md + unit tests per schema.

3. Auth group

• 3.1 src/auth/login.ts, register.ts, refresh.ts, logout.ts, context.ts.

4. Admin group

• 4.1 src/admin/ping.ts, health.ts, status.ts.

5. Events group

• 5.1 src/events/domain-event.ts, envelope.ts, metadata.ts.

6. Helpers

• 6.1 src/helpers/to-suaveplan-error.ts — ZodError → SuaveplanError lift.
• 6.2 src/helpers/to-json-schema.ts — JSON Schema dump.
• 6.3 src/helpers/to-openapi.ts — OpenAPI path/component fragment generator.

7. Barrel / subpath exports

• 7.1 ./admin, ./auth, ./common, ./events, ./helpers.

8. Property tests

• 8.1 fast-check arbitraries for every top-level schema round-trip.

9. Docs / README / benchmarks

10. Ship gate

• 10.1 Verification sequence; fold + archive.