suaveplan/openspec/archive/2026-04-19-enterprise-schema-registry/tasks.md

Tasks: enterprise-schema-registry

1. Scaffold

• 1.1 universal/validation/schema-registry/; 100/100/100/100; guard tests; CLAUDE/README/FOLDERS.

2. Errors + schemas

• 2.1 src/error-codes.ts — defineCodes for SCHEMA_REGISTRY.*, metadata export, side-effect auto-register.
• 2.2 Zod schemas for SchemaDefinition, SchemaField, SubjectConfig, SchemaVersion, CompatibilityResult.

3. Utils + constants

• 3.1 src/constants/index.ts — DEFAULT_COMPATIBILITY, DEFAULT_MAX_VERSIONS.
• 3.2 src/utils/utils.ts — canonicalizeSchema, computeFingerprint, djb2Hash, flattenFields, isOptionalOrHasDefault.

4. Diff

• 4.1 src/diff/schema-differ.ts — diffSchemas, formatDiffReport.

5. Compatibility

• 5.1 src/compatibility/compatibility.ts — checkCompatibility, checkTransitiveCompatibility.
• 5.2 src/compatibility/transitive-checker.ts — buildTransitiveReport, checkTransitiveAgainstAll, isTransitiveMode, stripTransitive.

6. Versioning + stores

• 6.1 src/core/versioning/versioning.ts — createSchemaVersion, MemorySchemaStore, resolveCompatibility.
• 6.2 src/store/database-store.ts — DatabaseSchemaStore + DatabaseAdapter contract.

7. Registry

• 7.1 src/core/registry/registry.ts — SchemaRegistry, createSchemaRegistry, SchemaCompatibilityError, createSchemaIncompatibleError.
• 7.2 OTel instrumentation.

8. Docs / barrel / subpath exports / README

9. Benchmarks

• 9.1 Register / compatibility / diff on 1 000-version history.

10. Ship gate

• 10.1 Verification sequence; fold + archive.