a9a7a328e6
Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD across contents and paths, upstream package/repo coordinates -> @golem15/msd-core and golem15com/msd-core. Deep links into upstream history, sibling upstream packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is. Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line, package/plugin identity, regenerated lockfile, install-tree fixtures, derived registries and benchmark baseline; migration checksum baseline re-locked (MSD keeps its own install state, so no install had applied the old sums); sort-order and regex-escaped expectations in tests adjusted.
103 lines
3.3 KiB
JavaScript
103 lines
3.3 KiB
JavaScript
// docs-guard-exempt: docs/adr/NNNN.md below is a sourcePath metadata label passed to parseAdrMarkdown, never read from disk.
|
|
const { test, describe } = require('node:test');
|
|
const assert = require('node:assert/strict');
|
|
|
|
const {
|
|
parseAdrMarkdown,
|
|
shouldRejectAdrStatus,
|
|
} = require('../msd-core/bin/lib/adr-parser.cjs');
|
|
|
|
describe('adr-parser', () => {
|
|
test('maps common ADR header synonyms into canonical fields', () => {
|
|
const markdown = [
|
|
'# ADR-0010: Deepening Roadmap',
|
|
'',
|
|
'## Status',
|
|
'Accepted',
|
|
'',
|
|
'## Background',
|
|
'We need a safer ingest path.',
|
|
'',
|
|
'## Decision',
|
|
'- Add `--ingest` flag.',
|
|
'',
|
|
'## Considered Options',
|
|
'- Keep only `--prd`.',
|
|
'',
|
|
'## Out of Scope',
|
|
'- Remote URL ingest.',
|
|
'',
|
|
'## Future Work',
|
|
'- Add URL ingestion later.',
|
|
'',
|
|
'## Dependencies',
|
|
'- ADR-0002',
|
|
'',
|
|
'## Consequences',
|
|
'- Positive: fewer manual transforms.',
|
|
'- Negative: parser maintenance overhead.',
|
|
].join('\n');
|
|
|
|
const out = parseAdrMarkdown(markdown, { sourcePath: 'docs/adr/0010.md' });
|
|
|
|
assert.equal(out.title, 'ADR-0010: Deepening Roadmap');
|
|
assert.equal(out.status, 'accepted');
|
|
assert.equal(out.source_path, 'docs/adr/0010.md');
|
|
assert.ok(out.context.includes('safer ingest path'));
|
|
assert.deepEqual(out.decisions, ['Add `--ingest` flag.']);
|
|
assert.deepEqual(out.options_considered, ['Keep only `--prd`.']);
|
|
assert.deepEqual(out.out_of_scope, ['Remote URL ingest.']);
|
|
assert.deepEqual(out.deferred, ['Add URL ingestion later.']);
|
|
assert.deepEqual(out.dependencies, ['ADR-0002']);
|
|
});
|
|
|
|
test('splits umbrella consequences into positive and negative streams', () => {
|
|
const markdown = [
|
|
'# ADR',
|
|
'',
|
|
'## Consequences',
|
|
'- Positive: rollout is faster.',
|
|
'- Negative: complexity increases.',
|
|
'- Success: clear metrics.',
|
|
'- Drawback: migration toil.',
|
|
].join('\n');
|
|
|
|
const out = parseAdrMarkdown(markdown, { sourcePath: 'docs/adr/0001.md' });
|
|
|
|
assert.deepEqual(out.consequences_positive, [
|
|
'Positive: rollout is faster.',
|
|
'Success: clear metrics.',
|
|
]);
|
|
assert.deepEqual(out.consequences_negative, [
|
|
'Negative: complexity increases.',
|
|
'Drawback: migration toil.',
|
|
]);
|
|
});
|
|
|
|
test('tracks update/amendment sections as overrides', () => {
|
|
const markdown = [
|
|
'# ADR',
|
|
'',
|
|
'## Decision',
|
|
'- First decision.',
|
|
'',
|
|
'## Update — locked design',
|
|
'- Supersede with second decision.',
|
|
].join('\n');
|
|
|
|
const out = parseAdrMarkdown(markdown, { sourcePath: 'docs/adr/0002.md' });
|
|
assert.ok(out.updates.length >= 1);
|
|
assert.ok(out.updates[0].heading.toLowerCase().includes('update'));
|
|
assert.ok(out.updates[0].entries.includes('Supersede with second decision.'));
|
|
});
|
|
|
|
test('reject-status helper blocks superseded/rejected/deprecated', () => {
|
|
assert.equal(shouldRejectAdrStatus('superseded'), true);
|
|
assert.equal(shouldRejectAdrStatus('rejected'), true);
|
|
assert.equal(shouldRejectAdrStatus('deprecated'), true);
|
|
assert.equal(shouldRejectAdrStatus('accepted'), false);
|
|
assert.equal(shouldRejectAdrStatus('proposed'), false);
|
|
assert.equal(shouldRejectAdrStatus(''), false);
|
|
});
|
|
});
|