docs: [verified] move metric contracts under Measurement
Build and publish Eldorado documentation / build (pull_request) Successful in 41s

This commit is contained in:
jarvis-at-skic committed 2026-10-06 23:25:30 +00:00
1 parent b9c2047c61
commit 85852f0744
45 files changed
+1101 -433

No files matched your search

+6 -5
View File
@@ -5,20 +5,21 @@ import {calculate} from './ai-kpi.mjs';
const read = path => readFileSync(path, 'utf8');
test('Skills Measurement is an open adoption collection plan, not a hidden catalogue', () => {
const page = read('docs/strategy/measurement.mdx');
const page = read('docs/strategy/measurement/index.mdx');
assert.match(page, /title: Skills Measurement\nsidebar_label: Measurement/);
for (const heading of ['Establish the baseline', 'Measure the pilot', 'Extend collection as adoption grows', 'Keep the collection running']) assert(page.includes(heading), heading);
assert(!page.includes('<details>'));
assert(page.includes('./reference/measurement-contracts.mdx'));
assert(page.includes('./collection-and-safeguards.mdx'));
assert(!page.includes('Is AI-assisted work worth continuing?'));
for (const word of ['Recommended', 'not installed', 'unknown', 'review', 'CI', 'revision', 'Monthly', 'Weekly']) assert(page.includes(word), word);
});
test('all sixteen metric definitions remain in the reference with explicit implementation limits', () => {
const page = read('docs/strategy/reference/measurement-contracts.mdx');
const manifest = JSON.parse(read('research/ai-adoption/measurement-migration.json'));
const page = read('docs/strategy/measurement/index.mdx') + read('docs/strategy/measurement/collection-and-safeguards.mdx');
const model = JSON.parse(read('research/ai-adoption/strategy-model.json'));
for (const k of model.kpis) {
const section = page.split(`### ${k.name}\n`)[1]?.split('\n### ')[0];
const section = read(`docs/strategy/${manifest.metrics.find(m => m.title === k.name).docId}.mdx`);
assert(section, k.name);
for (const field of ['Numerator','Denominator','Expression','Aggregation','Unit','Eligible population','Exclusions','Events and source','Owner / cadence','Missing evidence','Gaming and limits']) assert(section.includes(`| ${field} |`));
}
@@ -26,7 +27,7 @@ test('all sixteen metric definitions remain in the reference with explicit imple
});
test('published pilot arithmetic matches the executable fixture, including partial cost', () => {
const page = read('docs/strategy/measurement.mdx');
const page = read('docs/strategy/measurement/index.mdx');
const fixture = JSON.parse(read('scripts/fixtures/ai-kpi-synthetic.json'));
const report = calculate(fixture);
const success = report.kpis['validated-task-success'];