feat(#2182): implement community capability registry validation + generation

Implements the three pure functions in registry-schema.cjs (isValidGsdRange,
validateEntries, renderMarkdown) that were stubbed in the previous commit, turning
the red suite green: strict per-type schema validation (capability + eos), a
self-contained engines.gsd range validator (no semver dep), and deterministic
Markdown generation with shields.io release badges + per-entry Discussion links.
Regenerates docs/registries/capability-registry.md and adds the Added changeset.

Also hardens the isValidGsdRange fast-check property (letters-only major) so it
cannot intermittently generate a valid prerelease range and flake.

Closes #2182

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Tom Boucher
2026-07-11 14:26:23 -04:00
parent 60e3c4988a
commit bcf1376727
4 changed files with 338 additions and 18 deletions

View File

@@ -363,12 +363,20 @@ describe('isValidGsdRange', () => {
);
});
test('fast-check property: strings with letters where digits are expected are invalid', () => {
test('fast-check property: a non-numeric major segment is always invalid', () => {
// Replacing a numeric segment with letters can never be a well-formed range.
// Letters-only (not arbitrary garbage) keeps the generator from accidentally
// producing a valid semver-with-prerelease like `1.2.3-rc` — `>=1.2.3-rc.0.0`
// IS a legitimate prerelease range the validator accepts, which would make an
// "always invalid" assertion intermittently fail (a hidden flake).
fc.assert(
fc.property(
fc.string({ minLength: 1, maxLength: 8 }).filter((s) => /[A-Za-z]/.test(s) && !/^\s*$/.test(s)),
(garbage) => {
assert.equal(isValidGsdRange(`>=${garbage}.0.0`), false, garbage);
fc.constantFrom('', '>=', '>', '<=', '<', '=', '^', '~'),
fc
.array(fc.constantFrom(...'abcdefghijklmnopqrstuvwxyz'.split('')), { minLength: 1, maxLength: 6 })
.map((chars) => chars.join('')),
(op, letters) => {
assert.equal(isValidGsdRange(`${op}${letters}.0.0`), false, `${op}${letters}.0.0`);
},
),
);