xdrs-core 0.41.1 → 0.43.0

package/lib/lint.test.js

@@ -109,7 +109,7 @@ test('skips broken links to missing scope directories when ignoring external sco
       '- [001-main](principles/001-main.md) - Main decision'
     ]),
     '.xdrs/_local/adrs/principles/001-main.md': xdrDocument(
-      'See [core doc](../../../_core/adrs/principles/001-xdrs-core.md).'
+      'See [core doc](../../../_core/adrs/principles/001-xdrs-standards.md).'
     ),
   });
 
@@ -995,6 +995,109 @@ test('reports cycle in scope-type inheritance chain', () => {
   expect(result.errors.join('\n')).toContain('my-custom/index.md');
 });
 
+// ─── Companion scope-type file checks ─────────────────────────────────────────
+
+test('accepts companion scope-type file when primary exists in same type folder', () => {
+  const workspaceRoot = createWorkspace('scope-type-companion-valid', {
+    '.xdrs/index.md': rootIndex(['[myarea-core](myarea-core/index.md)', '[my-custom](my-custom/index.md)']),
+    '.xdrs/myarea-core/index.md': '---\nscope-type: core\nname: myarea-core\ndescription: Meta-governance scope.\napply-to: All myarea scopes\nvalid-from: 2026-01-01\n---\n\n# myarea-core Scope Overview\n\nMeta-governance.\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/myarea-core/adrs/index.md': [
+      '# myarea-core ADR Index', '', 'ADRs.', '', '## principles', '',
+      '- [001-core-scope-type](principles/001-core-scope-type.md) - core type',
+      '- [002-custom-scope-type](principles/002-custom-scope-type.md) - custom type primary',
+      '- [003-custom-scope-type-writing-style](principles/003-custom-scope-type-writing-style.md) - custom type companion',
+      ''
+    ].join('\n'),
+    '.xdrs/myarea-core/adrs/principles/001-core-scope-type.md': '---\nname: myarea-core-adr-policy-001-core-scope-type\ndescription: Core type stub.\napply-to: All\nvalid-from: 2026-01-01\n---\n\n## Context and Problem Statement\n\nStub.\n\n## Decision Outcome\n\nStub.\n',
+    '.xdrs/myarea-core/adrs/principles/002-custom-scope-type.md': '---\nname: myarea-core-adr-policy-002-custom-scope-type\ndescription: Defines the custom scope type.\napply-to: All\nvalid-from: 2026-01-01\n---\n\n## Context and Problem Statement\n\nDefines custom type.\n\n## Decision Outcome\n\nUse scope-type: custom.\n',
+    '.xdrs/myarea-core/adrs/principles/003-custom-scope-type-writing-style.md': '---\nname: myarea-core-adr-policy-003-custom-scope-type-writing-style\ndescription: Writing style companion for custom scope type.\napply-to: All custom scopes\nvalid-from: 2026-01-01\n---\n\n## Context and Problem Statement\n\nCompanion writing style rules.\n\n## Decision Outcome\n\nFollow writing style.\n',
+    '.xdrs/my-custom/index.md': '---\nscope-type: custom\nname: my-custom\ndescription: Custom scope.\napply-to: All\nvalid-from: 2026-01-01\n---\n\n# my-custom Scope Overview\n\nCustom.\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/my-custom/adrs/index.md': teamAdrIndex([]),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).not.toContain('companion-requires-primary');
+  expect(result.errors.join('\n')).not.toContain('has no corresponding');
+});
+
+test('reports companion scope-type file with no corresponding primary', () => {
+  const workspaceRoot = createWorkspace('scope-type-companion-no-primary', {
+    '.xdrs/index.md': rootIndex(['[myarea-core](myarea-core/index.md)']),
+    '.xdrs/myarea-core/index.md': '---\nscope-type: core\nname: myarea-core\ndescription: Meta-governance scope.\napply-to: All myarea scopes\nvalid-from: 2026-01-01\n---\n\n# myarea-core Scope Overview\n\nMeta-governance.\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/myarea-core/adrs/index.md': [
+      '# myarea-core ADR Index', '', 'ADRs.', '', '## principles', '',
+      '- [001-core-scope-type](principles/001-core-scope-type.md) - core type',
+      '- [002-custom-scope-type-extra](principles/002-custom-scope-type-extra.md) - companion with no primary',
+      ''
+    ].join('\n'),
+    '.xdrs/myarea-core/adrs/principles/001-core-scope-type.md': '---\nname: myarea-core-adr-policy-001-core-scope-type\ndescription: Core type stub.\napply-to: All\nvalid-from: 2026-01-01\n---\n\n## Context and Problem Statement\n\nStub.\n\n## Decision Outcome\n\nStub.\n',
+    '.xdrs/myarea-core/adrs/principles/002-custom-scope-type-extra.md': '---\nname: myarea-core-adr-policy-002-custom-scope-type-extra\ndescription: Companion file with no primary.\napply-to: All\nvalid-from: 2026-01-01\n---\n\n## Context and Problem Statement\n\nNo primary exists.\n\n## Decision Outcome\n\nNo primary.\n',
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('companion-requires-primary');
+  expect(result.errors.join('\n')).toContain('custom-scope-type');
+});
+
+test('reports companion scope-type file when primary is in a different type folder of same scope', () => {
+  const workspaceRoot = createWorkspace('scope-type-companion-wrong-folder', {
+    '.xdrs/index.md': rootIndex(['[myarea-core](myarea-core/index.md)']),
+    '.xdrs/myarea-core/index.md': '---\nscope-type: core\nname: myarea-core\ndescription: Meta-governance scope.\napply-to: All myarea scopes\nvalid-from: 2026-01-01\n---\n\n# myarea-core Scope Overview\n\nMeta-governance.\n\n[ADRs](adrs/index.md)\n[BDRs](bdrs/index.md)\n',
+    // Primary is in adrs/
+    '.xdrs/myarea-core/adrs/index.md': [
+      '# myarea-core ADR Index', '', 'ADRs.', '', '## principles', '',
+      '- [001-core-scope-type](principles/001-core-scope-type.md) - core type',
+      '- [002-custom-scope-type](principles/002-custom-scope-type.md) - custom type primary',
+      ''
+    ].join('\n'),
+    '.xdrs/myarea-core/adrs/principles/001-core-scope-type.md': '---\nname: myarea-core-adr-policy-001-core-scope-type\ndescription: Core type stub.\napply-to: All\nvalid-from: 2026-01-01\n---\n\n## Context and Problem Statement\n\nStub.\n\n## Decision Outcome\n\nStub.\n',
+    '.xdrs/myarea-core/adrs/principles/002-custom-scope-type.md': '---\nname: myarea-core-adr-policy-002-custom-scope-type\ndescription: Defines the custom scope type.\napply-to: All\nvalid-from: 2026-01-01\n---\n\n## Context and Problem Statement\n\nDefines custom type.\n\n## Decision Outcome\n\nUse scope-type: custom.\n',
+    // Companion is in bdrs/ — different type folder from the primary (adrs/)
+    '.xdrs/myarea-core/bdrs/index.md': [
+      '# myarea-core BDR Index', '', 'BDRs.', '', '## principles', '',
+      '- [001-custom-scope-type-extra](principles/001-custom-scope-type-extra.md) - companion in wrong folder',
+      ''
+    ].join('\n'),
+    '.xdrs/myarea-core/bdrs/principles/001-custom-scope-type-extra.md': '---\nname: myarea-core-bdr-policy-001-custom-scope-type-extra\ndescription: Companion file in wrong type folder.\napply-to: All\nvalid-from: 2026-01-01\n---\n\n## Context and Problem Statement\n\nWrong folder.\n\n## Decision Outcome\n\nWrong folder.\n',
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('companion-requires-primary');
+  expect(result.errors.join('\n')).toContain('custom-scope-type');
+});
+
+test('reports duplicate primary scope-type definitions in two type folders of same scope', () => {
+  const workspaceRoot = createWorkspace('scope-type-duplicate-primary', {
+    '.xdrs/index.md': rootIndex(['[myarea-core](myarea-core/index.md)']),
+    '.xdrs/myarea-core/index.md': '---\nscope-type: core\nname: myarea-core\ndescription: Meta-governance scope.\napply-to: All myarea scopes\nvalid-from: 2026-01-01\n---\n\n# myarea-core Scope Overview\n\nMeta-governance.\n\n[ADRs](adrs/index.md)\n[BDRs](bdrs/index.md)\n',
+    // Primary in adrs/
+    '.xdrs/myarea-core/adrs/index.md': [
+      '# myarea-core ADR Index', '', 'ADRs.', '', '## principles', '',
+      '- [001-core-scope-type](principles/001-core-scope-type.md) - core type',
+      '- [002-custom-scope-type](principles/002-custom-scope-type.md) - custom type (adrs)',
+      ''
+    ].join('\n'),
+    '.xdrs/myarea-core/adrs/principles/001-core-scope-type.md': '---\nname: myarea-core-adr-policy-001-core-scope-type\ndescription: Core type stub.\napply-to: All\nvalid-from: 2026-01-01\n---\n\n## Context and Problem Statement\n\nStub.\n\n## Decision Outcome\n\nStub.\n',
+    '.xdrs/myarea-core/adrs/principles/002-custom-scope-type.md': '---\nname: myarea-core-adr-policy-002-custom-scope-type\ndescription: Defines the custom scope type (adrs).\napply-to: All\nvalid-from: 2026-01-01\n---\n\n## Context and Problem Statement\n\nDefines custom type.\n\n## Decision Outcome\n\nUse scope-type: custom.\n',
+    // Duplicate primary also in bdrs/ — same scope-type name in two type folders
+    '.xdrs/myarea-core/bdrs/index.md': [
+      '# myarea-core BDR Index', '', 'BDRs.', '', '## principles', '',
+      '- [001-custom-scope-type](principles/001-custom-scope-type.md) - custom type duplicate (bdrs)',
+      ''
+    ].join('\n'),
+    '.xdrs/myarea-core/bdrs/principles/001-custom-scope-type.md': '---\nname: myarea-core-bdr-policy-001-custom-scope-type\ndescription: Duplicate primary for custom scope type in bdrs.\napply-to: All\nvalid-from: 2026-01-01\n---\n\n## Context and Problem Statement\n\nDuplicate primary.\n\n## Decision Outcome\n\nDuplicate.\n',
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('02-def-naming');
+  expect(result.errors.join('\n')).toContain('custom');
+  expect(result.errors.join('\n')).toContain('myarea-core');
+});
+
 test('reports scope-type with reserved underscore prefix', () => {
   const workspaceRoot = createWorkspace('scope-type-underscore-prefix', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
@@ -1079,25 +1182,25 @@ test('reports follows list that includes _core', () => {
   expect(result.errors.join('\n')).toContain('follows must not reference "_core" as it is always applied implicitly');
 });
 
-test('reports duplicate scope-local standards policies in same scope', () => {
-  const workspaceRoot = createWorkspace('duplicate-scope-local-standards', {
+test('accepts multiple local meta-policies in same scope', () => {
+  const workspaceRoot = createWorkspace('multiple-local-meta-policies', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
     '.xdrs/myteam/index.md': teamScopeIndex(),
     '.xdrs/myteam/adrs/index.md': teamAdrIndex([
       '- [001-team](principles/001-team.md) - Team decision',
-      '- [002-myteam-core](principles/002-myteam-core.md) - Local standards',
-      '- [003-myteam-core-dup](principles/003-myteam-core-dup.md) - Duplicate local standards',
+      '- [002-core](principles/002-core.md) - Local meta-policy primary',
+      '- [003-core-writing](principles/003-core-writing.md) - Local meta-policy companion',
     ]),
     '.xdrs/myteam/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
-    '.xdrs/myteam/adrs/principles/002-myteam-core.md': [
+    '.xdrs/myteam/adrs/principles/002-core.md': [
       '---',
-      'name: myteam-adr-policy-002-myteam-core',
-      'description: Local standards for myteam.',
+      'name: myteam-adr-policy-002-core',
+      'description: Local meta-policy for myteam.',
       'apply-to: myteam scope',
       'valid-from: 2026-01-01',
       '---',
       '',
-      '# myteam-adr-policy-002: myteam local standards',
+      '# myteam-adr-policy-002: Core',
       '',
       '## Context and Problem Statement',
       '',
@@ -1108,51 +1211,51 @@ test('reports duplicate scope-local standards policies in same scope', () => {
       'Standard outcome.',
       ''
     ].join('\n'),
-    '.xdrs/myteam/adrs/principles/003-myteam-core-dup.md': [
+    '.xdrs/myteam/adrs/principles/003-core-writing.md': [
       '---',
-      'name: myteam-adr-policy-003-myteam-core',
-      'description: Duplicate local standards for myteam.',
+      'name: myteam-adr-policy-003-core-writing',
+      'description: Writing style meta-policy for myteam.',
       'apply-to: myteam scope',
       'valid-from: 2026-01-01',
       '---',
       '',
-      '# myteam-adr-policy-003: myteam local standards duplicate',
+      '# myteam-adr-policy-003: Core writing',
       '',
       '## Context and Problem Statement',
       '',
-      'Duplicate defines local authoring standards.',
+      'Defines writing standards.',
       '',
       '## Decision Outcome',
       '',
-      'Duplicate outcome.',
+      'Writing outcome.',
       ''
     ].join('\n'),
   });
 
   const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
 
-  expect(result.errors.join('\n')).toContain('has more than one scope-local standards policy');
-  expect(result.errors.join('\n')).toContain('myteam-core');
+  expect(result.errors.join('\n')).not.toContain('[_core-adr-policy-010.10');
+  expect(result.errors.join('\n')).not.toContain('[_core-adr-policy-010.09-local-naming]');
 });
 
-test('accepts single scope-local standards policy in a scope', () => {
-  const workspaceRoot = createWorkspace('single-scope-local-standards', {
+test('accepts single local meta-policy in a scope', () => {
+  const workspaceRoot = createWorkspace('single-local-meta-policy', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
     '.xdrs/myteam/index.md': teamScopeIndex(),
     '.xdrs/myteam/adrs/index.md': teamAdrIndex([
       '- [001-team](principles/001-team.md) - Team decision',
-      '- [002-myteam-core](principles/002-myteam-core.md) - Local standards',
+      '- [002-core](principles/002-core.md) - Local meta-policy',
     ]),
     '.xdrs/myteam/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
-    '.xdrs/myteam/adrs/principles/002-myteam-core.md': [
+    '.xdrs/myteam/adrs/principles/002-core.md': [
       '---',
-      'name: myteam-adr-policy-002-myteam-core',
-      'description: Local standards for myteam.',
+      'name: myteam-adr-policy-002-core',
+      'description: Local meta-policy for myteam.',
       'apply-to: myteam scope',
       'valid-from: 2026-01-01',
       '---',
       '',
-      '# myteam-adr-policy-002: myteam local standards',
+      '# myteam-adr-policy-002: Core',
       '',
       '## Context and Problem Statement',
       '',
@@ -1167,7 +1270,224 @@ test('accepts single scope-local standards policy in a scope', () => {
 
   const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
 
-  expect(result.errors.join('\n')).not.toContain('has more than one scope-local standards policy');
+  expect(result.errors.join('\n')).not.toContain('[_core-adr-policy-010.10');
+  expect(result.errors.join('\n')).not.toContain('[_core-adr-policy-010.09-local-naming]');
+});
+
+test('errors when local meta-policy companion exists without primary in same type folder', () => {
+  const workspaceRoot = createWorkspace('companion-without-primary', {
+    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
+    '.xdrs/myteam/index.md': teamScopeIndex(),
+    '.xdrs/myteam/adrs/index.md': teamAdrIndex([
+      '- [001-team](principles/001-team.md) - Team decision',
+      '- [002-core-writing](principles/002-core-writing.md) - Companion without primary',
+    ]),
+    '.xdrs/myteam/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
+    '.xdrs/myteam/adrs/principles/002-core-writing.md': [
+      '---',
+      'name: myteam-adr-policy-002-core-writing',
+      'description: Writing style without primary.',
+      'apply-to: myteam scope',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# myteam-adr-policy-002: Core writing',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'Companion only.',
+      '',
+      '## Decision Outcome',
+      '',
+      'Companion outcome.',
+      ''
+    ].join('\n'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('[_core-adr-policy-010.10b-local-primary-required]');
+});
+
+test('errors when local meta-policy same qualifier appears in two type folders', () => {
+  const workspaceRoot = createWorkspace('duplicate-qualifier-across-types', {
+    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
+    '.xdrs/myteam/index.md': [
+      '---',
+      'scope-type: standard',
+      'name: myteam',
+      'description: Team scope for tests.',
+      'apply-to: Test team only',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# myteam Scope Overview',
+      '',
+      '[ADRs](adrs/index.md)',
+      '[EDRs](edrs/index.md)',
+      ''
+    ].join('\n'),
+    '.xdrs/myteam/adrs/index.md': teamAdrIndex([
+      '- [001-core](principles/001-core.md) - Primary in adrs',
+    ]),
+    '.xdrs/myteam/adrs/principles/001-core.md': [
+      '---',
+      'name: myteam-adr-policy-001-core',
+      'description: Primary in adrs.',
+      'apply-to: myteam scope',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# myteam-adr-policy-001: Core',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'Primary in adrs.',
+      '',
+      '## Decision Outcome',
+      '',
+      'Outcome.',
+      ''
+    ].join('\n'),
+    '.xdrs/myteam/edrs/index.md': '# myteam EDR Index\n\n## principles\n\n- [001-core](principles/001-core.md) - Primary in edrs\n',
+    '.xdrs/myteam/edrs/principles/001-core.md': [
+      '---',
+      'name: myteam-edr-policy-001-core',
+      'description: Primary in edrs.',
+      'apply-to: myteam scope',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# myteam-edr-policy-001: Core',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'Primary in edrs.',
+      '',
+      '## Decision Outcome',
+      '',
+      'Outcome.',
+      ''
+    ].join('\n'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('[_core-adr-policy-010.10c-local-unique-qualifier]');
+});
+
+test('errors when policy filename contains core as word outside principles', () => {
+  const workspaceRoot = createWorkspace('core-word-outside-principles', {
+    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
+    '.xdrs/myteam/index.md': teamScopeIndex(),
+    '.xdrs/myteam/adrs/index.md': '# myteam ADR Index\n\n## application\n\n- [101-some-core-thing](application/101-some-core-thing.md) - Uses core in slug\n',
+    '.xdrs/myteam/adrs/application/101-some-core-thing.md': [
+      '---',
+      'name: myteam-adr-policy-101-some-core-thing',
+      'description: Policy with core in non-principles.',
+      'apply-to: myteam scope',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# myteam-adr-policy-101: Some core thing',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'Uses core in application subject.',
+      '',
+      '## Decision Outcome',
+      '',
+      'Outcome.',
+      ''
+    ].join('\n'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('[_core-adr-policy-010.09-local-naming]');
+});
+
+test('errors when policy filename contains core as non-first word in principles', () => {
+  const workspaceRoot = createWorkspace('core-non-first-in-principles', {
+    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
+    '.xdrs/myteam/index.md': teamScopeIndex(),
+    '.xdrs/myteam/adrs/index.md': teamAdrIndex([
+      '- [001-xdrs-core-like](principles/001-xdrs-core-like.md) - Core not first word',
+    ]),
+    '.xdrs/myteam/adrs/principles/001-xdrs-core-like.md': [
+      '---',
+      'name: myteam-adr-policy-001-xdrs-core-like',
+      'description: Core is not first word.',
+      'apply-to: myteam scope',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# myteam-adr-policy-001: Xdrs core like',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'Core not first.',
+      '',
+      '## Decision Outcome',
+      '',
+      'Outcome.',
+      ''
+    ].join('\n'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('[_core-adr-policy-010.09-local-naming]');
+});
+
+test('accepts NNN-core-scope-type.md in principles without triggering core-word error', () => {
+  const workspaceRoot = createWorkspace('core-scope-type-in-principles', {
+    '.xdrs/index.md': rootIndex(['[myarea-core](myarea-core/index.md)']),
+    '.xdrs/myarea-core/index.md': '---\nscope-type: core\nname: myarea-core\ndescription: Meta-governance.\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': '# myarea-core ADR Index\n\n## principles\n\n- [001-custom-scope-type](principles/001-custom-scope-type.md) - Scope type\n- [002-core-scope-type](principles/002-core-scope-type.md) - Core scope type def\n',
+    '.xdrs/myarea-core/adrs/principles/001-custom-scope-type.md': [
+      '---',
+      'name: myarea-core-adr-policy-001-custom-scope-type',
+      'description: Custom scope type.',
+      'apply-to: myarea-core scope',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# myarea-core-adr-policy-001: Custom scope type',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'Defines custom scope type.',
+      '',
+      '## Decision Outcome',
+      '',
+      'Outcome.',
+      ''
+    ].join('\n'),
+    '.xdrs/myarea-core/adrs/principles/002-core-scope-type.md': [
+      '---',
+      'name: myarea-core-adr-policy-002-core-scope-type',
+      'description: Core scope type definition.',
+      'apply-to: myarea-core scope',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      '# myarea-core-adr-policy-002: Core scope type',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'Defines core scope type.',
+      '',
+      '## Decision Outcome',
+      '',
+      'Outcome.',
+      ''
+    ].join('\n'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).not.toContain('[_core-adr-policy-010.09-local-naming]');
 });
 
 test('reports missing name field in scope index frontmatter', () => {
@@ -1672,6 +1992,355 @@ test('allows nested directories in .assets', () => {
   expect(result.errors.join('\n')).not.toContain('.assets directory must be flat');
 });
 
+// ─── Multi-type scope-type tests ──────────────────────────────────────────────
+
+/**
+ * Create a minimal structured scope-type policy for use in multi-type tests.
+ */
+function structuredScopeTypePolicy(scopeName, num, typeName) {
+  return [
+    '---',
+    `name: ${scopeName}-adr-policy-${num}-${typeName}-scope-type`,
+    `description: Defines the ${typeName} scope type.`,
+    'apply-to: All XDRS scopes',
+    'valid-from: 2026-01-01',
+    '---',
+    '',
+    `# ${scopeName}-adr-policy-${num}: ${typeName} scope type`,
+    '',
+    '## Context and Problem Statement',
+    '',
+    `Defines the ${typeName} scope type.`,
+    '',
+    '## Decision Outcome',
+    '',
+    `Use scope-type: ${typeName} when appropriate.`,
+    '',
+    '### Details',
+    '',
+    '#### 01-rule-example',
+    '',
+    `Scopes of type \`${typeName}\` MUST follow these conventions.`,
+    ''
+  ].join('\n');
+}
+
+/**
+ * Returns file paths → content for a _core scope with structured scope-type policies.
+ */
+function coreWithStructuredScopeTypes(types) {
+  const allTypes = Array.from(new Set(['core', ...types]));
+  const files = {};
+  const policyEntries = allTypes.map((t, i) => {
+    const num = String(i + 1).padStart(3, '0');
+    const fileName = t === '_local' ? `${num}-local-scope-type.md` : `${num}-${t}-scope-type.md`;
+    files[`.xdrs/_core/adrs/principles/${fileName}`] = structuredScopeTypePolicy('_core', num, t);
+    return `- [${num}-${t}-scope-type](principles/${fileName}) - ${t} scope type`;
+  });
+  files['.xdrs/_core/adrs/index.md'] = [
+    '# _core ADR Index', '', 'Core ADRs for tests.', '', '## principles', '',
+    ...policyEntries, ''
+  ].join('\n');
+  files['.xdrs/_core/index.md'] = [
+    '---', 'scope-type: core', 'name: _core', 'description: Core framework scope for tests.',
+    'apply-to: All XDRS scopes', 'valid-from: 2026-01-01', '---', '',
+    '# _core Scope Overview', '', 'Framework scope for tests.', '', '[ADRs](adrs/index.md)', ''
+  ].join('\n');
+  return files;
+}
+
+test('accepts multi-type scope-type array (two types)', () => {
+  const workspaceRoot = createWorkspace('multi-type-valid-two', {
+    '.xdrs/index.md': rootIndex(['[my-scope](my-scope/index.md)']),
+    '.xdrs/my-scope/index.md': [
+      '---', 'scope-type: customa, customb', 'name: my-scope',
+      'description: Multi-type scope.', 'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# my-scope Scope Overview', '', 'Multi-type.', '', '[ADRs](adrs/index.md)', ''
+    ].join('\n'),
+    '.xdrs/my-scope/adrs/index.md': teamAdrIndex([]),
+    ...coreWithStructuredScopeTypes(['customa', 'customb']),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).not.toContain('scope-type');
+});
+
+test('accepts single-type scope-type string (backward compat)', () => {
+  const workspaceRoot = createWorkspace('single-type-compat', {
+    '.xdrs/index.md': rootIndex(['[my-scope](my-scope/index.md)']),
+    '.xdrs/my-scope/index.md': [
+      '---', 'scope-type: customa', 'name: my-scope',
+      'description: Single-type scope.', 'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# my-scope Scope Overview', '', 'Single type.', '', '[ADRs](adrs/index.md)', ''
+    ].join('\n'),
+    '.xdrs/my-scope/adrs/index.md': teamAdrIndex([]),
+    ...coreWithStructuredScopeTypes(['customa']),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).not.toContain('scope-type');
+});
+
+test('reports scope-type with only commas (all empty elements)', () => {
+  const workspaceRoot = createWorkspace('multi-type-empty-elements', {
+    '.xdrs/index.md': rootIndex(['[my-scope](my-scope/index.md)']),
+    '.xdrs/my-scope/index.md': [
+      '---', 'scope-type: ,', 'name: my-scope',
+      'description: Empty elements scope.', 'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# my-scope Scope Overview', '', 'Empty.', '', '[ADRs](adrs/index.md)', ''
+    ].join('\n'),
+    '.xdrs/my-scope/adrs/index.md': teamAdrIndex([]),
+    ...coreWithStructuredScopeTypes([]),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('invalid characters');
+});
+
+test('reports duplicate values in scope-type list', () => {
+  const workspaceRoot = createWorkspace('multi-type-duplicate', {
+    '.xdrs/index.md': rootIndex(['[my-scope](my-scope/index.md)']),
+    '.xdrs/my-scope/index.md': [
+      '---', 'scope-type: customa, customa', 'name: my-scope',
+      'description: Dup-type scope.', 'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# my-scope Scope Overview', '', 'Dup.', '', '[ADRs](adrs/index.md)', ''
+    ].join('\n'),
+    '.xdrs/my-scope/adrs/index.md': teamAdrIndex([]),
+    ...coreWithStructuredScopeTypes(['customa']),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('duplicate value "customa"');
+});
+
+test('reports invalid characters in scope-type list element', () => {
+  const workspaceRoot = createWorkspace('multi-type-invalid-chars', {
+    '.xdrs/index.md': rootIndex(['[my-scope](my-scope/index.md)']),
+    '.xdrs/my-scope/index.md': [
+      '---', 'scope-type: valid-type, bad type!', 'name: my-scope',
+      'description: Invalid char scope.', 'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# my-scope Scope Overview', '', 'Invalid.', '', '[ADRs](adrs/index.md)', ''
+    ].join('\n'),
+    '.xdrs/my-scope/adrs/index.md': teamAdrIndex([]),
+    ...coreWithStructuredScopeTypes(['valid-type']),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('invalid characters');
+});
+
+test('reports when one type in array has no corresponding scope-type policy', () => {
+  const workspaceRoot = createWorkspace('multi-type-missing-one', {
+    '.xdrs/index.md': rootIndex(['[my-scope](my-scope/index.md)']),
+    '.xdrs/my-scope/index.md': [
+      '---', 'scope-type: customa, missing-type', 'name: my-scope',
+      'description: One missing type.', 'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# my-scope Scope Overview', '', 'One missing.', '', '[ADRs](adrs/index.md)', ''
+    ].join('\n'),
+    '.xdrs/my-scope/adrs/index.md': teamAdrIndex([]),
+    ...coreWithStructuredScopeTypes(['customa']),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('missing-type');
+  expect(result.errors.join('\n')).toContain('has no corresponding');
+});
+
+test('detects cross-type cycle in multi-type array via parent chain', () => {
+  // typea's parent is typeb, typeb's parent is typea — cross-type cycle via array
+  const workspaceRoot = createWorkspace('multi-type-cross-cycle', {
+    '.xdrs/index.md': rootIndex(['[my-scope](my-scope/index.md)']),
+    '.xdrs/my-scope/index.md': [
+      '---', 'scope-type: typea, typeb', 'name: my-scope',
+      'description: Cross-cycle scope.', 'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# my-scope Scope Overview', '', 'Cross cycle.', '', '[ADRs](adrs/index.md)', ''
+    ].join('\n'),
+    '.xdrs/my-scope/adrs/index.md': teamAdrIndex([]),
+    '.xdrs/_core/index.md': [
+      '---', 'scope-type: core', 'name: _core', 'description: Core scope.',
+      'apply-to: All', 'valid-from: 2026-01-01', '---', '', '# _core', '', '[ADRs](adrs/index.md)', ''
+    ].join('\n'),
+    '.xdrs/_core/adrs/index.md': [
+      '# _core ADR Index', '', 'Core ADRs.', '', '## principles', '',
+      '- [001-core-scope-type](principles/001-core-scope-type.md) - core type',
+      '- [002-typea-scope-type](principles/002-typea-scope-type.md) - typea',
+      '- [003-typeb-scope-type](principles/003-typeb-scope-type.md) - typeb',
+      ''
+    ].join('\n'),
+    '.xdrs/_core/adrs/principles/001-core-scope-type.md': structuredScopeTypePolicy('_core', '001', 'core'),
+    // typea declares parent typeb
+    '.xdrs/_core/adrs/principles/002-typea-scope-type.md': [
+      '---', 'name: _core-adr-policy-002-typea-scope-type', 'description: typea.',
+      'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# _core-adr-policy-002: typea scope type', '', '## Context and Problem Statement', '',
+      'typea.', '', '## Decision Outcome', '', 'Use typea.', '', '### Details', '',
+      '#### 01-parent-scope-type', '',
+      'Instances inherit all rules from the `typeb` scope type.', ''
+    ].join('\n'),
+    // typeb declares parent typea — creates cycle
+    '.xdrs/_core/adrs/principles/003-typeb-scope-type.md': [
+      '---', 'name: _core-adr-policy-003-typeb-scope-type', 'description: typeb.',
+      'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# _core-adr-policy-003: typeb scope type', '', '## Context and Problem Statement', '',
+      'typeb.', '', '## Decision Outcome', '', 'Use typeb.', '', '### Details', '',
+      '#### 01-parent-scope-type', '',
+      'Instances inherit all rules from the `typea` scope type.', ''
+    ].join('\n'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('cycle');
+});
+
+test('reports scope-type policy missing ### Details section', () => {
+  const workspaceRoot = createWorkspace('scope-type-missing-details', {
+    '.xdrs/index.md': rootIndex(['[my-scope](my-scope/index.md)']),
+    '.xdrs/my-scope/index.md': [
+      '---', 'scope-type: customa', 'name: my-scope',
+      'description: Custom scope.', 'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# my-scope Scope Overview', '', 'Custom.', '', '[ADRs](adrs/index.md)', ''
+    ].join('\n'),
+    '.xdrs/my-scope/adrs/index.md': teamAdrIndex([]),
+    '.xdrs/_core/index.md': [
+      '---', 'scope-type: core', 'name: _core', 'description: Core scope.',
+      'apply-to: All', 'valid-from: 2026-01-01', '---', '', '# _core', '', '[ADRs](adrs/index.md)', ''
+    ].join('\n'),
+    '.xdrs/_core/adrs/index.md': [
+      '# _core ADR Index', '', 'Core ADRs.', '', '## principles', '',
+      '- [001-core-scope-type](principles/001-core-scope-type.md) - core type',
+      '- [002-customa-scope-type](principles/002-customa-scope-type.md) - customa',
+      ''
+    ].join('\n'),
+    '.xdrs/_core/adrs/principles/001-core-scope-type.md': structuredScopeTypePolicy('_core', '001', 'core'),
+    // Missing ### Details section
+    '.xdrs/_core/adrs/principles/002-customa-scope-type.md': [
+      '---', 'name: _core-adr-policy-002-customa-scope-type', 'description: customa.',
+      'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# _core-adr-policy-002: customa scope type', '', '## Context and Problem Statement', '',
+      'Defines customa.', '', '## Decision Outcome', '', 'Use customa.', ''
+    ].join('\n'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('"### Details"');
+  expect(result.errors.join('\n')).toContain('08b-def-scope-type-must-be-structured');
+});
+
+test('reports scope-type policy missing at least one #### NN-rulename block', () => {
+  const workspaceRoot = createWorkspace('scope-type-missing-rule-block', {
+    '.xdrs/index.md': rootIndex(['[my-scope](my-scope/index.md)']),
+    '.xdrs/my-scope/index.md': [
+      '---', 'scope-type: customa', 'name: my-scope',
+      'description: Custom scope.', 'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# my-scope Scope Overview', '', 'Custom.', '', '[ADRs](adrs/index.md)', ''
+    ].join('\n'),
+    '.xdrs/my-scope/adrs/index.md': teamAdrIndex([]),
+    '.xdrs/_core/index.md': [
+      '---', 'scope-type: core', 'name: _core', 'description: Core scope.',
+      'apply-to: All', 'valid-from: 2026-01-01', '---', '', '# _core', '', '[ADRs](adrs/index.md)', ''
+    ].join('\n'),
+    '.xdrs/_core/adrs/index.md': [
+      '# _core ADR Index', '', 'Core ADRs.', '', '## principles', '',
+      '- [001-core-scope-type](principles/001-core-scope-type.md) - core type',
+      '- [002-customa-scope-type](principles/002-customa-scope-type.md) - customa',
+      ''
+    ].join('\n'),
+    '.xdrs/_core/adrs/principles/001-core-scope-type.md': structuredScopeTypePolicy('_core', '001', 'core'),
+    // Has ### Details but no #### NN-rulename blocks
+    '.xdrs/_core/adrs/principles/002-customa-scope-type.md': [
+      '---', 'name: _core-adr-policy-002-customa-scope-type', 'description: customa.',
+      'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# _core-adr-policy-002: customa scope type', '', '## Context and Problem Statement', '',
+      'Defines customa.', '', '## Decision Outcome', '', 'Use customa.', '', '### Details', '',
+      'No rule blocks here — just prose.', ''
+    ].join('\n'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('at least one structured rule block');
+  expect(result.errors.join('\n')).toContain('08b-def-scope-type-must-be-structured');
+});
+
+test('reports local meta-policy missing ### Details section', () => {
+  // Local meta-policy without structured format
+  const workspaceRoot = createWorkspace('local-meta-policy-unstructured', {
+    '.xdrs/index.md': rootIndex(['[my-scope](my-scope/index.md)']),
+    '.xdrs/my-scope/index.md': [
+      '---', 'scope-type: customa', 'name: my-scope',
+      'description: Custom scope.', 'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# my-scope Scope Overview', '', 'Custom.', '', '[ADRs](adrs/index.md)', ''
+    ].join('\n'),
+    '.xdrs/my-scope/adrs/index.md': teamAdrIndex([
+      '- [001-core](principles/001-core.md) - local meta-policy'
+    ]),
+    // Local meta-policy without ### Details
+    '.xdrs/my-scope/adrs/principles/001-core.md': [
+      '---', 'name: my-scope-adr-policy-001-core', 'description: Local meta-policy.',
+      'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# my-scope-adr-policy-001: local meta', '', '## Context and Problem Statement', '',
+      'Local conventions.', '', '## Decision Outcome', '', 'Use local conventions.', ''
+    ].join('\n'),
+    ...coreWithStructuredScopeTypes(['customa']),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('"### Details"');
+  expect(result.errors.join('\n')).toContain('12b-local-must-be-structured');
+});
+
+test('reports policy in non-_core core-type scope missing structured format', () => {
+  const workspaceRoot = createWorkspace('core-scope-policy-unstructured', {
+    '.xdrs/index.md': rootIndex(['[my-core](my-core/index.md)']),
+    '.xdrs/my-core/index.md': [
+      '---', 'scope-type: core', 'name: my-core',
+      'description: Core scope.', 'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# my-core Scope Overview', '', 'Core.', '', '[ADRs](adrs/index.md)', ''
+    ].join('\n'),
+    '.xdrs/my-core/adrs/index.md': [
+      '# my-core ADR Index', '', 'Core ADRs.', '', '## principles', '',
+      '- [001-standard-scope-type](principles/001-standard-scope-type.md) - standard type',
+      ''
+    ].join('\n'),
+    // Policy without ### Details in a core-type scope that is not _core
+    '.xdrs/my-core/adrs/principles/001-standard-scope-type.md': [
+      '---', 'name: my-core-adr-policy-001-standard-scope-type', 'description: Standard type.',
+      'apply-to: All', 'valid-from: 2026-01-01', '---', '',
+      '# my-core-adr-policy-001: standard scope type', '', '## Context and Problem Statement', '',
+      'Defines standard.', '', '## Decision Outcome', '', 'Use standard.', ''
+    ].join('\n'),
+    ...coreWithStructuredScopeTypes([]),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('"### Details"');
+  expect(result.errors.join('\n')).toContain('08c-def-core-scope-policies-must-be-structured');
+});
+
+test('does not require structured format for _core scope policies (exempt)', () => {
+  // _core scope is exempt from rule 08c (all-policies-in-core-type-scope check)
+  // The existing coreWithScopeTypes helper creates unstructured policies in _core
+  // — this test verifies _core is NOT checked for 08c
+  const workspaceRoot = createWorkspace('core-scope-exempt', {
+    '.xdrs/index.md': rootIndex(),
+    ...coreWithScopeTypes([]),  // intentionally unstructured - _core is exempt from 08c
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).not.toContain('08c-def-core-scope-policies-must-be-structured');
+});
+
 function localScopeIndex() {
   return [
     '---',