xdrs-core 0.44.0 → 0.46.0

package/lib/lint.test.js

@@ -1733,83 +1733,198 @@ test('reports scope index description exceeding 40 words', () => {
   expect(result.errors.join('\n')).toContain('Scope index frontmatter description must be 40 words or fewer');
 });
 
-test('accepts related-scopes as a list of scope names in scope index frontmatter', () => {
-  const workspaceRoot = createWorkspace('valid-scope-related-scopes-list', {
-    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)', '[sibling-team](sibling-team/index.md)', '[parent-domain](parent-domain/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nrelated-scopes:\n  - sibling-team\n  - parent-domain\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
+test('reports related-scopes as unknown frontmatter field in scope index (field removed)', () => {
+  const workspaceRoot = createWorkspace('scope-related-scopes-unknown-field', {
+    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nrelated-scopes: sibling-team\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
     '.xdrs/myteam/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Team decision']),
     '.xdrs/myteam/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
-    '.xdrs/sibling-team/index.md': '---\nscope-type: standard\nname: sibling-team\ndescription: Sibling team.\napply-to: Sibling team\nvalid-from: 2026-01-01\n---\n\n# sibling-team Scope Overview\n\n[ADRs](adrs/index.md)\n',
-    '.xdrs/sibling-team/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Team decision']),
-    '.xdrs/sibling-team/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
-    '.xdrs/parent-domain/index.md': '---\nscope-type: standard\nname: parent-domain\ndescription: Parent domain.\napply-to: Parent domain\nvalid-from: 2026-01-01\n---\n\n# parent-domain Scope Overview\n\n[ADRs](adrs/index.md)\n',
-    '.xdrs/parent-domain/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Team decision']),
-    '.xdrs/parent-domain/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
   });
 
   const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
 
-  expect(result.errors.join('\n')).not.toContain('Scope index frontmatter related-scopes');
+  expect(result.errors.join('\n')).toContain('unknown field "related-scopes"');
 });
 
-test('accepts related-scopes as a single scope name string in scope index frontmatter', () => {
-  const workspaceRoot = createWorkspace('valid-scope-related-scopes-string', {
-    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)', '[sibling-team](sibling-team/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nrelated-scopes: sibling-team\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
+test('accepts extends: single scope name in scope index frontmatter', () => {
+  const workspaceRoot = createWorkspace('extends-single-scope', {
+    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)', '[shared](shared/index.md)']),
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nextends: shared\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
     '.xdrs/myteam/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Team decision']),
     '.xdrs/myteam/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
-    '.xdrs/sibling-team/index.md': '---\nscope-type: standard\nname: sibling-team\ndescription: Sibling team.\napply-to: Sibling team\nvalid-from: 2026-01-01\n---\n\n# sibling-team Scope Overview\n\n[ADRs](adrs/index.md)\n',
-    '.xdrs/sibling-team/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Team decision']),
-    '.xdrs/sibling-team/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
+    '.xdrs/shared/index.md': '---\nscope-type: standard\nname: shared\ndescription: Shared policies.\napply-to: All teams\nvalid-from: 2026-01-01\n---\n\n# shared Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/shared/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Shared decision']),
+    '.xdrs/shared/adrs/principles/001-team.md': teamXdrDocument('Shared decision.'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.filter((e) => /\[_core-adr-policy-010\.\d+-extends-/.test(e)).join('\n')).toBe('');
+});
+
+test('accepts extends: multiple scopes comma-separated in scope index frontmatter', () => {
+  const workspaceRoot = createWorkspace('extends-multiple-scopes', {
+    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)', '[shared-a](shared-a/index.md)', '[shared-b](shared-b/index.md)']),
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nextends: shared-a, shared-b\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/myteam/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Team decision']),
+    '.xdrs/myteam/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
+    '.xdrs/shared-a/index.md': '---\nscope-type: standard\nname: shared-a\ndescription: Shared A.\napply-to: All teams\nvalid-from: 2026-01-01\n---\n\n# shared-a Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/shared-a/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Shared A decision']),
+    '.xdrs/shared-a/adrs/principles/001-team.md': teamXdrDocument('Shared A decision.'),
+    '.xdrs/shared-b/index.md': '---\nscope-type: standard\nname: shared-b\ndescription: Shared B.\napply-to: All teams\nvalid-from: 2026-01-01\n---\n\n# shared-b Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/shared-b/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Shared B decision']),
+    '.xdrs/shared-b/adrs/principles/001-team.md': teamXdrDocument('Shared B decision.'),
   });
 
   const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
 
-  expect(result.errors.join('\n')).not.toContain('Scope index frontmatter related-scopes');
+  expect(result.errors.filter((e) => /\[_core-adr-policy-010\.\d+-extends-/.test(e)).join('\n')).toBe('');
 });
 
-test('reports invalid related-scopes value in scope index frontmatter', () => {
-  const workspaceRoot = createWorkspace('invalid-scope-related-scopes', {
+test('accepts extends: YAML list format in scope index frontmatter', () => {
+  const workspaceRoot = createWorkspace('extends-yaml-list', {
+    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)', '[shared-a](shared-a/index.md)', '[shared-b](shared-b/index.md)']),
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nextends:\n  - shared-a\n  - shared-b\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/myteam/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Team decision']),
+    '.xdrs/myteam/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
+    '.xdrs/shared-a/index.md': '---\nscope-type: standard\nname: shared-a\ndescription: Shared A.\napply-to: All teams\nvalid-from: 2026-01-01\n---\n\n# shared-a Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/shared-a/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Shared A decision']),
+    '.xdrs/shared-a/adrs/principles/001-team.md': teamXdrDocument('Shared A decision.'),
+    '.xdrs/shared-b/index.md': '---\nscope-type: standard\nname: shared-b\ndescription: Shared B.\napply-to: All teams\nvalid-from: 2026-01-01\n---\n\n# shared-b Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/shared-b/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Shared B decision']),
+    '.xdrs/shared-b/adrs/principles/001-team.md': teamXdrDocument('Shared B decision.'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.filter((e) => /\[_core-adr-policy-010\.\d+-extends-/.test(e)).join('\n')).toBe('');
+});
+
+test('reports extends: referencing a missing scope', () => {
+  const workspaceRoot = createWorkspace('extends-missing-scope', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nrelated-scopes: 123\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nextends: nonexistent-scope\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
     '.xdrs/myteam/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Team decision']),
     '.xdrs/myteam/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
   });
 
   const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
 
-  expect(result.errors.join('\n')).toContain('Scope index frontmatter related-scopes must be a scope name or list of scope names');
+  expect(result.errors.join('\n')).toContain('[_core-adr-policy-010.32-extends-mandatory-presence]');
+  expect(result.errors.join('\n')).toContain('nonexistent-scope');
 });
 
-test('reports related-scopes scope that does not exist in workspace', () => {
-  const workspaceRoot = createWorkspace('related-scopes-missing-scope', {
+test('reports extends: self-reference in scope index frontmatter', () => {
+  const workspaceRoot = createWorkspace('extends-self-reference', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nrelated-scopes: nonexistent-scope\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nextends: myteam\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
     '.xdrs/myteam/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Team decision']),
     '.xdrs/myteam/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
   });
 
   const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
 
-  expect(result.errors.join('\n')).toContain('related-scopes references scope "nonexistent-scope" which does not exist in the workspace');
+  expect(result.errors.join('\n')).toContain('[_core-adr-policy-010.30-extends-no-self]');
 });
 
-test('accepts related-scopes scope that exists in workspace', () => {
-  const workspaceRoot = createWorkspace('related-scopes-existing-scope', {
-    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)', '[sibling-team](sibling-team/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nrelated-scopes: sibling-team\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
+test('reports extends: referencing reserved scope _local', () => {
+  const workspaceRoot = createWorkspace('extends-reserved-local', {
+    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nextends: _local\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
     '.xdrs/myteam/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Team decision']),
     '.xdrs/myteam/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
-    '.xdrs/sibling-team/index.md': '---\nscope-type: standard\nname: sibling-team\ndescription: Sibling team.\napply-to: Sibling team\nvalid-from: 2026-01-01\n---\n\n# sibling-team Scope Overview\n\n[ADRs](adrs/index.md)\n',
-    '.xdrs/sibling-team/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Team decision']),
-    '.xdrs/sibling-team/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
   });
 
   const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
 
-  expect(result.errors.join('\n')).not.toContain('related-scopes references scope "sibling-team"');
+  expect(result.errors.join('\n')).toContain('[_core-adr-policy-010.29-extends-reserved-scopes]');
+});
+
+test('reports extends: referencing reserved scope _core', () => {
+  const workspaceRoot = createWorkspace('extends-reserved-core', {
+    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nextends: _core\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/myteam/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Team decision']),
+    '.xdrs/myteam/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('[_core-adr-policy-010.29-extends-reserved-scopes]');
+});
+
+test('reports extends: cycle between two scopes', () => {
+  const workspaceRoot = createWorkspace('extends-cycle', {
+    '.xdrs/index.md': rootIndex(['[scope-a](scope-a/index.md)', '[scope-b](scope-b/index.md)']),
+    '.xdrs/scope-a/index.md': '---\nscope-type: standard\nname: scope-a\ndescription: Scope A.\napply-to: Scope A\nvalid-from: 2026-01-01\nextends: scope-b\n---\n\n# scope-a Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/scope-a/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - A decision']),
+    '.xdrs/scope-a/adrs/principles/001-team.md': teamXdrDocument('A decision.'),
+    '.xdrs/scope-b/index.md': '---\nscope-type: standard\nname: scope-b\ndescription: Scope B.\napply-to: Scope B\nvalid-from: 2026-01-01\nextends: scope-a\n---\n\n# scope-b Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/scope-b/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - B decision']),
+    '.xdrs/scope-b/adrs/principles/001-team.md': teamXdrDocument('B decision.'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('[_core-adr-policy-010.31-extends-no-cycle]');
 });
 
+test('reports extends: and follows: referencing same scope (disjoint violation)', () => {
+  const workspaceRoot = createWorkspace('extends-follows-overlap', {
+    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)', '[myarea-core](myarea-core/index.md)']),
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nfollows: myarea-core\nextends: myarea-core\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/myteam/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Team decision']),
+    '.xdrs/myteam/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
+    '.xdrs/myarea-core/index.md': '---\nscope-type: core\nname: myarea-core\ndescription: Meta-governance for myarea.\napply-to: All myarea scopes\nvalid-from: 2026-01-01\n---\n\n# myarea-core Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/myarea-core/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Core decision']),
+    '.xdrs/myarea-core/adrs/principles/001-team.md': teamXdrDocument('Core decision.'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('[_core-adr-policy-010.28-extends-disjoint]');
+});
+
+test('extends-only scope not in root index is exempt from missing link error', () => {
+  const workspaceRoot = createWorkspace('extends-only-scope-not-in-index', {
+    // shared-policies is NOT linked in the root index — it is only referenced via extends:
+    '.xdrs/index.md': rootIndex(['[_core](_core/index.md)', '[myteam](myteam/index.md)']),
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nextends: shared-policies\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/myteam/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Team decision']),
+    '.xdrs/myteam/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
+    '.xdrs/shared-policies/index.md': '---\nscope-type: standard\nname: shared-policies\ndescription: Shared policies.\napply-to: All teams\nvalid-from: 2026-01-01\n---\n\n# shared-policies Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/shared-policies/adrs/index.md': teamAdrIndex(['- [001-shared](principles/001-shared.md) - Shared decision']),
+    '.xdrs/shared-policies/adrs/principles/001-shared.md': teamXdrDocument('Shared decision.'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  // shared-policies should NOT trigger "missing root index link" since it is extends-only
+  expect(result.errors.filter((e) => e.includes('Root index is missing scope index link') && e.includes('shared-policies')).length).toBe(0);
+  // No extends: validation errors should fire for the extends: field
+  expect(result.errors.filter((e) => /\[_core-adr-policy-010\.\d+-extends-/.test(e)).join('\n')).toBe('');
+});
+
+test('warns when extends-referenced scope also appears in root index', () => {
+  const workspaceRoot = createWorkspace('extends-scope-in-root-index', {
+    '.xdrs/index.md': rootIndex(['[_core](_core/index.md)', '[myteam](myteam/index.md)', '[shared-policies](shared-policies/index.md)']),
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nextends: shared-policies\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/myteam/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Team decision']),
+    '.xdrs/myteam/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
+    '.xdrs/shared-policies/index.md': '---\nscope-type: standard\nname: shared-policies\ndescription: Shared policies.\napply-to: All teams\nvalid-from: 2026-01-01\n---\n\n# shared-policies Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/shared-policies/adrs/index.md': teamAdrIndex(['- [001-shared](principles/001-shared.md) - Shared decision']),
+    '.xdrs/shared-policies/adrs/principles/001-shared.md': teamXdrDocument('Shared decision.'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).not.toContain('[_core-adr-policy-010.35-extends-index]');
+  expect(result.warnings.join('\n')).toContain('[_core-adr-policy-010.35-extends-index]');
+  expect(result.warnings.join('\n')).toContain('shared-policies');
+});
+
+
+
 test('reports duplicate entries in follows list', () => {
   const workspaceRoot = createWorkspace('follows-duplicate-entries', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)', '[myarea-core](myarea-core/index.md)']),
@@ -1842,7 +1957,7 @@ test('reports duplicate entries in follows comma-separated list', () => {
   expect(result.errors.join('\n')).toContain('follows has duplicate entry "myarea-core"');
 });
 
-test('reports related-scopes that references the scope itself', () => {
+test('reports related-scopes that references the scope itself (field now removed, reports unknown field)', () => {
   const workspaceRoot = createWorkspace('related-scopes-self-reference', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
     '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nrelated-scopes: myteam\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
@@ -1852,10 +1967,10 @@ test('reports related-scopes that references the scope itself', () => {
 
   const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
 
-  expect(result.errors.join('\n')).toContain('related-scopes must not reference the scope itself');
+  expect(result.errors.join('\n')).toContain('unknown field "related-scopes"');
 });
 
-test('reports duplicate entries in related-scopes list', () => {
+test('reports duplicate entries in related-scopes list (field now removed, reports unknown field)', () => {
   const workspaceRoot = createWorkspace('related-scopes-duplicate-entries', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)', '[sibling-team](sibling-team/index.md)']),
     '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nrelated-scopes:\n  - sibling-team\n  - sibling-team\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
@@ -1868,10 +1983,10 @@ test('reports duplicate entries in related-scopes list', () => {
 
   const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
 
-  expect(result.errors.join('\n')).toContain('related-scopes has duplicate entry "sibling-team"');
+  expect(result.errors.join('\n')).toContain('unknown field "related-scopes"');
 });
 
-test('reports related-scopes entry that is already declared in follows', () => {
+test('reports related-scopes entry already in follows (field now removed, reports unknown field)', () => {
   const workspaceRoot = createWorkspace('related-scopes-follows-overlap', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)', '[myarea-core](myarea-core/index.md)']),
     '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nfollows: myarea-core\nrelated-scopes: myarea-core\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
@@ -1884,7 +1999,7 @@ test('reports related-scopes entry that is already declared in follows', () => {
 
   const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
 
-  expect(result.errors.join('\n')).toContain('related-scopes must not repeat scope "myarea-core" already declared in follows');
+  expect(result.errors.join('\n')).toContain('unknown field "related-scopes"');
 });
 
 test('reports orphan asset files not referenced by any document', () => {
@@ -2341,6 +2456,509 @@ test('does not require structured format for _core scope policies (exempt)', ()
   expect(result.errors.join('\n')).not.toContain('08c-def-core-scope-policies-must-be-structured');
 });
 
+// ─── compiled scope-type checks ───────────────────────────────────────────────
+
+function compiledScopeIndex() {
+  return [
+    '---',
+    'scope-type: compiled',
+    'name: my-compiled',
+    'description: Compiled scope for tests.',
+    'apply-to: All consumers of compiled content',
+    'valid-from: 2026-01-01',
+    '---',
+    '',
+    '# my-compiled Scope Overview',
+    '',
+    'Compiled scope for tests.',
+    '',
+    '[ADRs](adrs/index.md)',
+    ''
+  ].join('\n');
+}
+
+function compiledAdrIndex(entries) {
+  return [
+    '# my-compiled ADR Index',
+    '',
+    'Compiled ADRs for tests.',
+    '',
+    '## principles',
+    '',
+    ...entries,
+    ''
+  ].join('\n');
+}
+
+function validCompiledPolicy() {
+  return [
+    '---',
+    'name: my-compiled-adr-policy-001-a01',
+    'description: Compiled test policy.',
+    'apply-to: All teams',
+    'valid-from: 2026-01-01',
+    '---',
+    '',
+    '# my-compiled-adr-policy-001: A01',
+    '',
+    '## Context and Problem Statement',
+    '',
+    'External source defines this requirement.',
+    '',
+    '## Decision Outcome',
+    '',
+    'Follow the rule.',
+    '',
+    '### Details',
+    '',
+    '#### 01-rule',
+    '',
+    'MUST comply.',
+    '',
+    '## Source',
+    '',
+    '- source-1/standards/a01.md',
+    ''
+  ].join('\n');
+}
+
+function validCompiledMetaPolicy() {
+  return [
+    '---',
+    'name: my-compiled-adr-policy-001-core',
+    'description: Compilation meta-policy for adrs.',
+    'apply-to: Compilation process for this scope',
+    'valid-from: 2026-01-01',
+    '---',
+    '',
+    '# my-compiled-adr-policy-001: core',
+    '',
+    '## Context and Problem Statement',
+    '',
+    'Defines compilation configuration.',
+    '',
+    '## Decision Outcome',
+    '',
+    'Use the configured sources.',
+    '',
+    '### Details',
+    '',
+    '#### 01-rule',
+    '',
+    'MUST use configured sources.',
+    '',
+    '## Sources',
+    '',
+    '- [web] https://example.com/standards',
+    '',
+    '## Selectors',
+    '',
+    '- Include all requirement sections.',
+    ''
+  ].join('\n');
+}
+
+test('reports policy in compiled scope missing structured format', () => {
+  const workspaceRoot = createWorkspace('compiled-scope-policy-unstructured', {
+    '.xdrs/index.md': rootIndex(['[my-compiled](my-compiled/index.md)']),
+    '.xdrs/my-compiled/index.md': compiledScopeIndex(),
+    '.xdrs/my-compiled/adrs/index.md': compiledAdrIndex([
+      '- [001-a01](principles/001-a01.md) - A01'
+    ]),
+    '.xdrs/my-compiled/adrs/principles/001-a01.md': [
+      '---',
+      'name: my-compiled-adr-policy-001-a01',
+      'description: Compiled test policy.',
+      'apply-to: All teams',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# my-compiled-adr-policy-001: A01',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'External source.',
+      '',
+      '## Decision Outcome',
+      '',
+      'Follow rule.',
+      '',
+      '## Source',
+      '',
+      '- source-1/a01.md',
+      ''
+    ].join('\n'),
+  });
+
+  const result = lintWorkspace(workspaceRoot);
+
+  expect(result.errors.join('\n')).toContain('"### Details"');
+  expect(result.errors.join('\n')).toContain('019.04-structured-format-required');
+});
+
+test('reports compiled policy missing ## Source section', () => {
+  const workspaceRoot = createWorkspace('compiled-scope-missing-source', {
+    '.xdrs/index.md': rootIndex(['[my-compiled](my-compiled/index.md)']),
+    '.xdrs/my-compiled/index.md': compiledScopeIndex(),
+    '.xdrs/my-compiled/adrs/index.md': compiledAdrIndex([
+      '- [001-a01](principles/001-a01.md) - A01'
+    ]),
+    '.xdrs/my-compiled/adrs/principles/001-a01.md': [
+      '---',
+      'name: my-compiled-adr-policy-001-a01',
+      'description: Compiled test policy.',
+      'apply-to: All teams',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# my-compiled-adr-policy-001: A01',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'External source.',
+      '',
+      '## Decision Outcome',
+      '',
+      'Follow rule.',
+      '',
+      '### Details',
+      '',
+      '#### 01-rule',
+      '',
+      'MUST comply.',
+      ''
+    ].join('\n'),
+  });
+
+  const result = lintWorkspace(workspaceRoot);
+
+  expect(result.errors.join('\n')).toContain('Compiled policy must include a "## Source" section');
+  expect(result.errors.join('\n')).toContain('019.10-source-section');
+});
+
+test('reports compiled policy with markdown links in ## Source section', () => {
+  const workspaceRoot = createWorkspace('compiled-scope-source-md-links', {
+    '.xdrs/index.md': rootIndex(['[my-compiled](my-compiled/index.md)']),
+    '.xdrs/my-compiled/index.md': compiledScopeIndex(),
+    '.xdrs/my-compiled/adrs/index.md': compiledAdrIndex([
+      '- [001-a01](principles/001-a01.md) - A01'
+    ]),
+    '.xdrs/my-compiled/adrs/principles/001-a01.md': [
+      '---',
+      'name: my-compiled-adr-policy-001-a01',
+      'description: Compiled test policy.',
+      'apply-to: All teams',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# my-compiled-adr-policy-001: A01',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'External source.',
+      '',
+      '## Decision Outcome',
+      '',
+      'Follow rule.',
+      '',
+      '### Details',
+      '',
+      '#### 01-rule',
+      '',
+      'MUST comply.',
+      '',
+      '## Source',
+      '',
+      '- [source-1/a01.md](source-1/a01.md)',
+      ''
+    ].join('\n'),
+  });
+
+  const result = lintWorkspace(workspaceRoot);
+
+  expect(result.errors.join('\n')).toContain('"## Source" section must not use markdown links');
+  expect(result.errors.join('\n')).toContain('019.10-source-section');
+});
+
+test('accepts valid compiled policy with ## Source section and no markdown links', () => {
+  const workspaceRoot = createWorkspace('compiled-scope-valid', {
+    '.xdrs/index.md': rootIndex(['[my-compiled](my-compiled/index.md)']),
+    '.xdrs/my-compiled/index.md': compiledScopeIndex(),
+    '.xdrs/my-compiled/adrs/index.md': compiledAdrIndex([
+      '- [001-a01](principles/001-a01.md) - A01'
+    ]),
+    '.xdrs/my-compiled/adrs/principles/001-a01.md': validCompiledPolicy(),
+  });
+
+  const result = lintWorkspace(workspaceRoot);
+
+  expect(result.errors.join('\n')).not.toContain('019');
+});
+
+test('reports compiled scope meta-policy missing ## Sources section', () => {
+  const workspaceRoot = createWorkspace('compiled-meta-missing-sources', {
+    '.xdrs/index.md': rootIndex(['[my-compiled](my-compiled/index.md)']),
+    '.xdrs/my-compiled/index.md': compiledScopeIndex(),
+    '.xdrs/my-compiled/adrs/index.md': compiledAdrIndex([
+      '- [001-core](principles/001-core.md) - meta-policy',
+      '- [002-a01](principles/002-a01.md) - A01'
+    ]),
+    '.xdrs/my-compiled/adrs/principles/001-core.md': [
+      '---',
+      'name: my-compiled-adr-policy-001-core',
+      'description: Compilation meta-policy.',
+      'apply-to: Compilation process',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# my-compiled-adr-policy-001: core',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'Defines compilation config.',
+      '',
+      '## Decision Outcome',
+      '',
+      'Use configured sources.',
+      '',
+      '### Details',
+      '',
+      '#### 01-rule',
+      '',
+      'MUST use configured sources.',
+      '',
+      '## Selectors',
+      '',
+      '- Include requirement sections.',
+      ''
+    ].join('\n'),
+    '.xdrs/my-compiled/adrs/principles/002-a01.md': [
+      '---',
+      'name: my-compiled-adr-policy-002-a01',
+      'description: Compiled test policy.',
+      'apply-to: All teams',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# my-compiled-adr-policy-002: A01',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'External source.',
+      '',
+      '## Decision Outcome',
+      '',
+      'Follow rule.',
+      '',
+      '### Details',
+      '',
+      '#### 01-rule',
+      '',
+      'MUST comply.',
+      '',
+      '## Source',
+      '',
+      '- source-1/a01.md',
+      ''
+    ].join('\n'),
+  });
+
+  const result = lintWorkspace(workspaceRoot);
+
+  expect(result.errors.join('\n')).toContain('"## Sources" section');
+  expect(result.errors.join('\n')).toContain('019.07-compilation-meta-policy');
+});
+
+test('reports compiled scope meta-policy missing ## Selectors section', () => {
+  const workspaceRoot = createWorkspace('compiled-meta-missing-selectors', {
+    '.xdrs/index.md': rootIndex(['[my-compiled](my-compiled/index.md)']),
+    '.xdrs/my-compiled/index.md': compiledScopeIndex(),
+    '.xdrs/my-compiled/adrs/index.md': compiledAdrIndex([
+      '- [001-core](principles/001-core.md) - meta-policy',
+      '- [002-a01](principles/002-a01.md) - A01'
+    ]),
+    '.xdrs/my-compiled/adrs/principles/001-core.md': [
+      '---',
+      'name: my-compiled-adr-policy-001-core',
+      'description: Compilation meta-policy.',
+      'apply-to: Compilation process',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# my-compiled-adr-policy-001: core',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'Defines compilation config.',
+      '',
+      '## Decision Outcome',
+      '',
+      'Use configured sources.',
+      '',
+      '### Details',
+      '',
+      '#### 01-rule',
+      '',
+      'MUST use configured sources.',
+      '',
+      '## Sources',
+      '',
+      '- [web] https://example.com/standards',
+      ''
+    ].join('\n'),
+    '.xdrs/my-compiled/adrs/principles/002-a01.md': [
+      '---',
+      'name: my-compiled-adr-policy-002-a01',
+      'description: Compiled test policy.',
+      'apply-to: All teams',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# my-compiled-adr-policy-002: A01',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'External source.',
+      '',
+      '## Decision Outcome',
+      '',
+      'Follow rule.',
+      '',
+      '### Details',
+      '',
+      '#### 01-rule',
+      '',
+      'MUST comply.',
+      '',
+      '## Source',
+      '',
+      '- source-1/a01.md',
+      ''
+    ].join('\n'),
+  });
+
+  const result = lintWorkspace(workspaceRoot);
+
+  expect(result.errors.join('\n')).toContain('"## Selectors" section');
+  expect(result.errors.join('\n')).toContain('019.07-compilation-meta-policy');
+});
+
+test('accepts valid compiled scope meta-policy with required sections', () => {
+  const workspaceRoot = createWorkspace('compiled-meta-valid', {
+    '.xdrs/index.md': rootIndex(['[my-compiled](my-compiled/index.md)']),
+    '.xdrs/my-compiled/index.md': compiledScopeIndex(),
+    '.xdrs/my-compiled/adrs/index.md': compiledAdrIndex([
+      '- [001-core](principles/001-core.md) - meta-policy',
+      '- [002-a01](principles/002-a01.md) - A01'
+    ]),
+    '.xdrs/my-compiled/adrs/principles/001-core.md': validCompiledMetaPolicy(),
+    '.xdrs/my-compiled/adrs/principles/002-a01.md': [
+      '---',
+      'name: my-compiled-adr-policy-002-a01',
+      'description: Compiled test policy.',
+      'apply-to: All teams',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# my-compiled-adr-policy-002: A01',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'External source.',
+      '',
+      '## Decision Outcome',
+      '',
+      'Follow rule.',
+      '',
+      '### Details',
+      '',
+      '#### 01-rule',
+      '',
+      'MUST comply.',
+      '',
+      '## Source',
+      '',
+      '- source-1/a01.md',
+      ''
+    ].join('\n'),
+  });
+
+  const result = lintWorkspace(workspaceRoot);
+
+  expect(result.errors.join('\n')).not.toContain('019');
+});
+
+test('skips ## Source check for local meta-policy files in compiled scope', () => {
+  const workspaceRoot = createWorkspace('compiled-meta-no-source-required', {
+    '.xdrs/index.md': rootIndex(['[my-compiled](my-compiled/index.md)']),
+    '.xdrs/my-compiled/index.md': compiledScopeIndex(),
+    '.xdrs/my-compiled/adrs/index.md': compiledAdrIndex([
+      '- [001-core](principles/001-core.md) - meta-policy'
+    ]),
+    '.xdrs/my-compiled/adrs/principles/001-core.md': validCompiledMetaPolicy(),
+  });
+
+  const result = lintWorkspace(workspaceRoot);
+
+  expect(result.errors.join('\n')).not.toContain('Compiled policy must include a "## Source" section');
+});
+
+test('enforces compiled scope checks when scope-type is comma-separated with compiled', () => {
+  const workspaceRoot = createWorkspace('compiled-multi-type-checks', {
+    '.xdrs/index.md': rootIndex(['[my-compiled-scope](my-compiled-scope/index.md)']),
+    '.xdrs/my-compiled-scope/index.md': [
+      '---',
+      'scope-type: compiled, standard',
+      'name: my-compiled-scope',
+      'description: Compiled standard scope for tests.',
+      'apply-to: All consumers',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# my-compiled-scope Scope Overview',
+      '',
+      'Compiled standard.',
+      '',
+      '[ADRs](adrs/index.md)',
+      ''
+    ].join('\n'),
+    '.xdrs/my-compiled-scope/adrs/index.md': [
+      '# my-compiled-scope ADR Index', '', 'ADRs.', '', '## principles', '',
+      '- [001-a01](principles/001-a01.md) - A01', ''
+    ].join('\n'),
+    '.xdrs/my-compiled-scope/adrs/principles/001-a01.md': [
+      '---',
+      'name: my-compiled-scope-adr-policy-001-a01',
+      'description: Compiled test policy.',
+      'apply-to: All teams',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# my-compiled-scope-adr-policy-001: A01',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'External source.',
+      '',
+      '## Decision Outcome',
+      '',
+      'Follow rule.',
+      '',
+      '## Source',
+      '',
+      '- source-1/a01.md',
+      ''
+    ].join('\n'),
+    ...coreWithStructuredScopeTypes(['standard', 'compiled']),
+  });
+
+  const result = lintWorkspace(workspaceRoot);
+
+  expect(result.errors.join('\n')).toContain('"### Details"');
+  expect(result.errors.join('\n')).toContain('019.04-structured-format-required');
+});
+
+
 function localScopeIndex() {
   return [
     '---',