feat: add specVersion classification to conformance scenarios (#147)

* feat: add specVersions classification to conformance scenarios

Each scenario declares which spec versions it applies to as a list.
Scenarios that carry forward (e.g. initialize) list all applicable versions
['2025-06-18', '2025-11-25']. Scenarios removed from newer specs (e.g.
backcompat auth) only list their original version ['2025-03-26'].

- specVersions list on Scenario and ClientScenario interfaces
- --spec-version CLI filter uses simple .includes()
- Tier-check conformance matrix (Server / Client: Core / Client: Auth)
  with per-version columns and unique All* count
- 7 unit tests for specVersions helpers
- Updated tier-audit skill docs with matrix format

* fix: fix console output template for tier audit skill

The template had an orphan table header (Check | Value | T2 | T1)
with no rows above the conformance matrix, causing an empty table
to render. The scorecard rows below the matrix also lacked their
own header.

Fix: two self-contained tables with clear labels — 'Conformance:'
for the per-version matrix, 'Scorecard:' for the check rows.

* fix: align skill console template with tier-check script output

Add asterisk footnote ('unique scenarios — a scenario may apply to
multiple spec versions') and rename 'Scorecard' to 'Repository Health'
to match the labels used by the tier-check CLI output.

* fix: add specVersions to CrossAppAccessCompleteFlowScenario

Added in 83c446d on main after this branch diverged.
This commit is contained in:
Felix Weinberger 2026-02-13 18:08:15 +00:00 • committed by GitHub
commit 3f9048a019
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -3,7 +3,11 @@ import { mkdtempSync, readFileSync, existsSync, globSync } from 'fs';
import { join, dirname } from 'path';
import { tmpdir } from 'os';
import { ConformanceResult } from '../types';
import { listScenarios, listActiveClientScenarios } from '../../scenarios';
import {
listScenarios,
listActiveClientScenarios,
getScenarioSpecVersions
} from '../../scenarios';
import { ConformanceCheck } from '../../types';
/**
@ -105,6 +109,15 @@ function reconcileWithExpected(
})
);
// Attach specVersion to existing detail entries
for (const detail of result.details) {
let name = stripTimestamp(detail.scenario);
if (resultPrefix) {
name = name.replace(new RegExp(`^${resultPrefix}-`), '');
}
detail.specVersions = getScenarioSpecVersions(name);
}
for (const expected of expectedScenarios) {
if (!reportedNames.has(expected)) {
result.failed++;
@ -113,7 +126,8 @@ function reconcileWithExpected(
scenario: expected,
passed: false,
checks_passed: 0,
checks_failed: 0
checks_failed: 0,
specVersions: getScenarioSpecVersions(expected)
});
}
}