release notes
v1.1.0
Expands generated tier 5 and level 6 coverage from 1979 through 2025, grows club metadata to 375 records, and adds crest asset candidate metadata with provenance, license status, placeholders, and review guidance.
Release
Summary
- Expands generated lower-tier data while preserving the top-four-tier contract: tier 5 and level 6 now cover the modern 1979-2025 lower-tier slice where source pages expose usable tables.
- Grows generated club metadata from 232 to 375 records, reflecting the broader maintained dataset scope.
- Adds club crest asset metadata with candidate provenance, license classification, generated placeholders, and review flags so consumers can choose an asset policy that matches their rights model.
Breaking Changes
None.
Data Changes
-
Keeps
tier1throughtier4season coverage unchanged fromv1.0.0. - Expands generated
tier5coverage from 14 to 47 seasons. -
Expands generated level-six coverage from 5 to 47 seasons, using
tier6.divisions[]for parallel divisions. -
Adds
assets.crestbundles todata/club-metadata.json. The package stores URLs and provenance only; it does not download or redistribute image binaries. -
Classifies crest records as
usable,restricted,placeholder, orneeds-more-research, with review issues captured indata/club-assets-review.json. -
Leaves
Hounslowas the only trueneeds-more-researchcrest/color case, withBridgend Town,Bromsgrove Rovers, andSolihull Boroughstill marked for quality review.
Validation
-
Full local release-readiness checks passed before the pre-release branch:
pnpm test,pnpm test:integration,pnpm typecheck,pnpm -s verify:data,pnpm -s schema:verify,pnpm format:check,pnpm -s docs:check,pnpm -s lint, andpnpm -s release:dry-run-data. - The release dry-run rebuilt the full 1888-2025 generated range into a temporary directory, produced 138 season records and 375 club metadata records, and passed data verification, club-continuity verification, and JSON Schema verification.
-
data/club-metadata-review.jsonis clean withissueCount: 0. - Known club asset review issues are limited to expected restricted-license club marks, one missing research case, and three quality-review candidates.
Consumer Notes
-
trackedFromSeasonandtrackedToSeasonremain observed generated-data bounds, not founded or dissolved dates. -
status.currentremains a current high-level metadata status, not a season-row outcome. -
Consumers should use
usablecrest assets by default, includeplaceholderonly when generated fallback shields are acceptable, and includerestrictedonly when their product can handle club mark licensing and trademark restrictions. -
Treat
needs-review,needs-more-research, andfailedcrest states as non-display states unless the consuming app has its own review workflow.
Known Limitations
- The lower-tier expansion substantially broadens generated coverage, but it is still constrained by Wikipedia source page availability and structure.
- Most discovered club marks are license or trademark restricted, so the new crest metadata is a provenance and filtering layer rather than a blanket permission grant.
- The remaining non-license asset review items are intentionally carried forward rather than filled with weak assertions.