xdrs-core 0.32.0 → 0.34.2

package/lib/lint.test.js

@@ -588,7 +588,7 @@ test('allows index.md at scope level', () => {
 test('reports scope index missing link to type index', () => {
   const workspaceRoot = createWorkspace('scope-index-missing-type-link', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: domain\nname: myteam\ndescription: Team scope for tests.\napply-to: Test team only\nvalid-from: 2026-01-01\n---\n\n# myteam Scope Overview\n\nNo type links here.\n',
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team scope for tests.\napply-to: Test team only\nvalid-from: 2026-01-01\n---\n\n# myteam Scope Overview\n\nNo type links here.\n',
     '.xdrs/myteam/adrs/index.md': teamAdrIndex([
       '- [001-team](principles/001-team.md) - Team decision'
     ]),
@@ -620,7 +620,7 @@ test('passes when scope index links to all type indexes', () => {
 test('reports broken link in scope index', () => {
   const workspaceRoot = createWorkspace('scope-index-broken-link', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: domain\nname: myteam\ndescription: Team scope for tests.\napply-to: Test team only\nvalid-from: 2026-01-01\n---\n\n# myteam Scope Overview\n\nTeam scope for tests.\n\n[ADRs](adrs/index.md)\n[Missing](missing/index.md)\n',
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team scope for tests.\napply-to: Test team only\nvalid-from: 2026-01-01\n---\n\n# myteam Scope Overview\n\nTeam scope for tests.\n\n[ADRs](adrs/index.md)\n[Missing](missing/index.md)\n',
     '.xdrs/myteam/adrs/index.md': teamAdrIndex([
       '- [001-team](principles/001-team.md) - Team decision'
     ]),
@@ -683,22 +683,24 @@ test('reports missing scope-type field in scope index frontmatter', () => {
 
 test('reports invalid scope-type value in scope index frontmatter', () => {
   const workspaceRoot = createWorkspace('scope-type-invalid-value', {
-    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: invalid-type\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)', '[_core](_core/index.md)']),
+    '.xdrs/myteam/index.md': '---\nscope-type: invalid-type\nname: myteam\ndescription: Team scope for tests.\napply-to: Test team only\nvalid-from: 2026-01-01\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.'),
+    // _core with only 'core' scope-type — no invalid-type-scope-type policy
+    ...coreWithScopeTypes([]),
   });
 
   const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
 
-  expect(result.errors.join('\n')).toContain('scope-type must be one of');
+  expect(result.errors.join('\n')).toContain('has no corresponding invalid-type-scope-type policy');
   expect(result.errors.join('\n')).toContain('myteam/index.md');
 });
 
 test('accepts all valid scope-type values', () => {
-  const workspaceRoot = createWorkspace('valid-domain-type-check', {
+  const workspaceRoot = createWorkspace('valid-standard-type-check', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
     '.xdrs/myteam/index.md': teamScopeIndex(),
     '.xdrs/myteam/adrs/index.md': teamAdrIndex([
@@ -709,7 +711,7 @@ test('accepts all valid scope-type values', () => {
 
   const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
 
-  expect(result.errors.join('\n')).not.toContain('Scope index scope-type must be one of');
+  expect(result.errors.join('\n')).not.toContain('has no corresponding');
   expect(result.errors.join('\n')).not.toContain('Scope index frontmatter must include');
   expect(result.errors.join('\n')).not.toContain('Scope index must start with');
 });
@@ -733,7 +735,7 @@ test('accepts scope-type reference when scope name contains reference', () => {
 
   const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
 
-  expect(result.errors.join('\n')).not.toContain('Scope index scope-type must be one of');
+  expect(result.errors.join('\n')).not.toContain('has no corresponding');
   expect(result.errors.join('\n')).not.toContain('Scope with type "reference"');
   expect(result.errors.join('\n')).not.toContain('Scope index frontmatter must include');
 });
@@ -778,7 +780,7 @@ test('accepts scope-type platform when scope name contains platform', () => {
 
   const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
 
-  expect(result.errors.join('\n')).not.toContain('Scope index scope-type must be one of');
+  expect(result.errors.join('\n')).not.toContain('has no corresponding');
   expect(result.errors.join('\n')).not.toContain('Scope with type "platform"');
   expect(result.errors.join('\n')).not.toContain('Scope index frontmatter must include');
 });
@@ -854,7 +856,7 @@ test('reports scope-type _local used on non-_local scope', () => {
 test('reports _local scope with wrong scope-type', () => {
   const workspaceRoot = createWorkspace('scope-type-local-wrong-type', {
     '.xdrs/index.md': rootIndex(),
-    '.xdrs/_local/index.md': '---\nscope-type: domain\nname: _local\ndescription: Local scope for tests.\napply-to: Test workspace only\nvalid-from: 2026-01-01\n---\n\n# _local Scope Overview\n\nLocal scope for tests.\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/_local/index.md': '---\nscope-type: standard\nname: _local\ndescription: Local scope for tests.\napply-to: Test workspace only\nvalid-from: 2026-01-01\n---\n\n# _local Scope Overview\n\nLocal scope for tests.\n\n[ADRs](adrs/index.md)\n',
     '.xdrs/_local/adrs/index.md': localAdrIndex([
       '- [001-main](principles/001-main.md) - Main decision'
     ]),
@@ -866,10 +868,85 @@ test('reports _local scope with wrong scope-type', () => {
   expect(result.errors.join('\n')).toContain('Scope "_local" must have scope-type "_local"');
 });
 
+test('accepts custom scope-type when policy exists in core-type scope', () => {
+  const workspaceRoot = createWorkspace('custom-scope-type-valid', {
+    '.xdrs/index.md': rootIndex(['[my-custom](my-custom/index.md)']),
+    '.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([
+      '- [001-custom](principles/001-custom.md) - Custom'
+    ]),
+    '.xdrs/my-custom/adrs/principles/001-custom.md': teamXdrDocument('Custom decision.'),
+    ...coreWithScopeTypes(['custom']),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).not.toContain('has no corresponding');
+  expect(result.errors.join('\n')).not.toContain('Scope index frontmatter');
+});
+
+test('reports custom scope-type when no policy exists', () => {
+  const workspaceRoot = createWorkspace('custom-scope-type-missing-policy', {
+    '.xdrs/index.md': rootIndex(['[my-scope](my-scope/index.md)']),
+    '.xdrs/my-scope/index.md': '---\nscope-type: unknown-type\nname: my-scope\ndescription: Unknown type scope.\napply-to: All\nvalid-from: 2026-01-01\n---\n\n# my-scope Scope Overview\n\nUnknown.\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/my-scope/adrs/index.md': teamAdrIndex([]),
+    ...coreWithScopeTypes([]),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('has no corresponding unknown-type-scope-type policy');
+});
+
+test('validates parent scope-type exists in inheritance chain', () => {
+  const workspaceRoot = createWorkspace('scope-type-inheritance-valid', {
+    '.xdrs/index.md': rootIndex(['[my-custom](my-custom/index.md)', '[_core](_core/index.md)']),
+    '.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([]),
+    '.xdrs/_core/index.md': '---\nscope-type: core\nname: _core\ndescription: Core scope.\napply-to: All\nvalid-from: 2026-01-01\n---\n\n# _core\n\n[ADRs](adrs/index.md)\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-standard-scope-type](principles/002-standard-scope-type.md) - standard type',
+      '- [003-custom-scope-type](principles/003-custom-scope-type.md) - custom type',
+      ''
+    ].join('\n'),
+    '.xdrs/_core/adrs/principles/001-core-scope-type.md': '---\nname: _core-adr-policy-001-core-scope-type\ndescription: core 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/_core/adrs/principles/002-standard-scope-type.md': '---\nname: _core-adr-policy-002-standard-scope-type\ndescription: standard 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/_core/adrs/principles/003-custom-scope-type.md': '---\nname: _core-adr-policy-003-custom-scope-type\ndescription: custom type with parent\napply-to: All\nvalid-from: 2026-01-01\n---\n\n## Context and Problem Statement\n\nCustom type.\n\n## Decision Outcome\n\nCustom.\n\n#### 01-parent-scope-type\n\nInstances inherit all rules from the `standard` scope type.\n',
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).not.toContain('declares parent');
+  expect(result.errors.join('\n')).not.toContain('has no corresponding');
+});
+
+test('reports error when parent scope-type in chain does not exist', () => {
+  const workspaceRoot = createWorkspace('scope-type-inheritance-missing-parent', {
+    '.xdrs/index.md': rootIndex(['[my-custom](my-custom/index.md)', '[_core](_core/index.md)']),
+    '.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([]),
+    '.xdrs/_core/index.md': '---\nscope-type: core\nname: _core\ndescription: Core scope.\napply-to: All\nvalid-from: 2026-01-01\n---\n\n# _core\n\n[ADRs](adrs/index.md)\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-custom-scope-type](principles/002-custom-scope-type.md) - custom type',
+      ''
+    ].join('\n'),
+    '.xdrs/_core/adrs/principles/001-core-scope-type.md': '---\nname: _core-adr-policy-001-core-scope-type\ndescription: core 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/_core/adrs/principles/002-custom-scope-type.md': '---\nname: _core-adr-policy-002-custom-scope-type\ndescription: custom type with missing parent\napply-to: All\nvalid-from: 2026-01-01\n---\n\n## Context and Problem Statement\n\nCustom.\n\n## Decision Outcome\n\nCustom.\n\n#### 01-parent-scope-type\n\nInstances inherit from the `nonexistent-parent` scope type.\n',
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('declares parent "nonexistent-parent" but no nonexistent-parent-scope-type policy exists');
+});
+
 test('reports missing name field in scope index frontmatter', () => {
   const workspaceRoot = createWorkspace('scope-index-missing-name', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: domain\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\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.'),
   });
@@ -882,7 +959,7 @@ test('reports missing name field in scope index frontmatter', () => {
 test('reports name mismatch in scope index frontmatter', () => {
   const workspaceRoot = createWorkspace('scope-index-name-mismatch', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: domain\nname: wrong-name\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: wrong-name\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\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.'),
   });
@@ -895,7 +972,7 @@ test('reports name mismatch in scope index frontmatter', () => {
 test('reports missing description field in scope index frontmatter', () => {
   const workspaceRoot = createWorkspace('scope-index-missing-description', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: domain\nname: myteam\napply-to: Test team\nvalid-from: 2026-01-01\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\napply-to: Test team\nvalid-from: 2026-01-01\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.'),
   });
@@ -908,7 +985,7 @@ test('reports missing description field in scope index frontmatter', () => {
 test('reports missing apply-to field in scope index frontmatter', () => {
   const workspaceRoot = createWorkspace('scope-index-missing-apply-to', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: domain\nname: myteam\ndescription: Team.\nvalid-from: 2026-01-01\n---\n\n# myteam Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\nvalid-from: 2026-01-01\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.'),
   });
@@ -921,7 +998,7 @@ test('reports missing apply-to field in scope index frontmatter', () => {
 test('reports missing valid-from field in scope index frontmatter', () => {
   const workspaceRoot = createWorkspace('scope-index-missing-valid-from', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: domain\nname: myteam\ndescription: Team.\napply-to: Test team\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\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.'),
   });
@@ -934,7 +1011,7 @@ test('reports missing valid-from field in scope index frontmatter', () => {
 test('reports invalid valid-from date in scope index frontmatter', () => {
   const workspaceRoot = createWorkspace('scope-index-invalid-valid-from', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: domain\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: not-a-date\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: not-a-date\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.'),
   });
@@ -947,7 +1024,7 @@ test('reports invalid valid-from date in scope index frontmatter', () => {
 test('reports unknown field in scope index frontmatter', () => {
   const workspaceRoot = createWorkspace('scope-index-unknown-field', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: domain\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nunknown-field: value\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\nunknown-field: value\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.'),
   });
@@ -960,7 +1037,7 @@ test('reports unknown field in scope index frontmatter', () => {
 test('accepts all valid scope index frontmatter fields', () => {
   const workspaceRoot = createWorkspace('valid-all-scope-fields', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: domain\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nlicense: MIT\nmetadata:\n  owner: team\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\nlicense: MIT\nmetadata:\n  owner: 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.'),
   });
@@ -973,7 +1050,7 @@ test('accepts all valid scope index frontmatter fields', () => {
 test('accepts follows as a list of core scope names in scope index frontmatter', () => {
   const workspaceRoot = createWorkspace('valid-scope-follows-list', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)', '[myarea-core](myarea-core/index.md)', '[shared-standards-core](shared-standards-core/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: domain\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nfollows:\n  - myarea-core\n  - shared-standards-core\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\nfollows:\n  - myarea-core\n  - shared-standards-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',
@@ -992,7 +1069,7 @@ test('accepts follows as a list of core scope names in scope index frontmatter',
 test('accepts follows as a single core scope name string in scope index frontmatter', () => {
   const workspaceRoot = createWorkspace('valid-scope-follows-string', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)', '[myarea-core](myarea-core/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: domain\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nfollows: myarea-core\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\nfollows: 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',
@@ -1008,7 +1085,7 @@ test('accepts follows as a single core scope name string in scope index frontmat
 test('reports invalid follows value in scope index frontmatter', () => {
   const workspaceRoot = createWorkspace('invalid-scope-follows', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: domain\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nfollows: 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\nfollows: 123\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.'),
   });
@@ -1021,7 +1098,7 @@ test('reports invalid follows value in scope index frontmatter', () => {
 test('reports follows scope that does not exist in workspace', () => {
   const workspaceRoot = createWorkspace('follows-missing-scope', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: domain\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nfollows: nonexistent-core\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\nfollows: nonexistent-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.'),
   });
@@ -1034,7 +1111,7 @@ test('reports follows scope that does not exist in workspace', () => {
 test('accepts follows scope that exists in workspace', () => {
   const workspaceRoot = createWorkspace('follows-existing-scope', {
     '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)', '[myarea-core](myarea-core/index.md)']),
-    '.xdrs/myteam/index.md': '---\nscope-type: domain\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nfollows: myarea-core\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\nfollows: 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',
@@ -1047,6 +1124,125 @@ test('accepts follows scope that exists in workspace', () => {
   expect(result.errors.join('\n')).not.toContain('follows references scope');
 });
 
+test('reports follows scope that is not core-type', () => {
+  const workspaceRoot = createWorkspace('follows-non-core-scope', {
+    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)', '[myarea-domain](myarea-domain/index.md)']),
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: Test team\nvalid-from: 2026-01-01\nfollows: myarea-domain\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-domain/index.md': '---\nscope-type: standard\nname: myarea-domain\ndescription: Domain scope, not a core scope.\napply-to: All domain teams\nvalid-from: 2026-01-01\n---\n\n# myarea-domain Scope Overview\n\n[ADRs](adrs/index.md)\n',
+    '.xdrs/myarea-domain/adrs/index.md': teamAdrIndex(['- [001-team](principles/001-team.md) - Team decision']),
+    '.xdrs/myarea-domain/adrs/principles/001-team.md': teamXdrDocument('Team decision.'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreExternal: false });
+
+  expect(result.errors.join('\n')).toContain('follows references scope "myarea-domain" which is not a core-type scope');
+});
+
+test('reports scope index apply-to exceeding 30 words', () => {
+  const workspaceRoot = createWorkspace('scope-apply-to-too-long', {
+    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: Team.\napply-to: All backend frontend mobile data and infrastructure teams in the organization that build deploy operate or maintain services on the shared platform including external contractors working on integration projects and testing\nvalid-from: 2026-01-01\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 apply-to must be 30 words or fewer');
+});
+
+test('reports scope index description exceeding 40 words', () => {
+  const workspaceRoot = createWorkspace('scope-description-too-long', {
+    '.xdrs/index.md': rootIndex(['[myteam](myteam/index.md)']),
+    '.xdrs/myteam/index.md': '---\nscope-type: standard\nname: myteam\ndescription: This scope description is intentionally too long in order to verify that the linter correctly reports an error when the description field of a scope index frontmatter contains more than forty words in total which is supposed to exceed the enforced word count limit for descriptions\napply-to: Test team\nvalid-from: 2026-01-01\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 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',
+    '.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');
+});
+
+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',
+    '.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('Scope index frontmatter related-scopes');
+});
+
+test('reports invalid related-scopes value in scope index frontmatter', () => {
+  const workspaceRoot = createWorkspace('invalid-scope-related-scopes', {
+    '.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/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');
+});
+
+test('reports related-scopes scope that does not exist in workspace', () => {
+  const workspaceRoot = createWorkspace('related-scopes-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: 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('related-scopes references scope "nonexistent-scope" which does not exist in the workspace');
+});
+
+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',
+    '.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"');
+});
+
 test('reports orphan asset files not referenced by any document', () => {
   const workspaceRoot = createWorkspace('orphan-asset', {
     '.xdrs/index.md': rootIndex(),
@@ -1171,10 +1367,72 @@ function localScopeIndex() {
   ].join('\n');
 }
 
+/**
+ * Returns an object of file paths → content for a minimal `_core` scope containing
+ * stub scope-type definition policies for each listed type name.
+ * Always includes 'core' so _core can validate itself.
+ */
+function coreWithScopeTypes(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');
+    // _local uses 'local' in filename (no underscore allowed in NUMBERED_FILE_RE)
+    const fileName = t === '_local' ? `${num}-local-scope-type.md` : `${num}-${t}-scope-type.md`;
+    files[`.xdrs/_core/adrs/principles/${fileName}`] = [
+      '---',
+      `name: _core-adr-policy-${num}-${t}-scope-type`,
+      `description: Defines the ${t} scope type.`,
+      'apply-to: All XDRS scopes',
+      'valid-from: 2026-01-01',
+      '---',
+      '',
+      `# _core-adr-policy-${num}: ${t} scope type`,
+      '',
+      '## Context and Problem Statement',
+      '',
+      `Defines the ${t} scope type.`,
+      '',
+      '## Decision Outcome',
+      '',
+      `Use scope-type: ${t} when appropriate.`,
+      ''
+    ].join('\n');
+    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;
+}
+
 function teamScopeIndex() {
   return [
     '---',
-    'scope-type: domain',
+    'scope-type: standard',
     'name: myteam',
     'description: Team scope for tests.',
     'apply-to: Test team only',
@@ -1227,6 +1485,24 @@ function createWorkspace(name, files) {
   const workspaceRoot = path.join(tmpRoot, name);
   fs.mkdirSync(workspaceRoot, { recursive: true });
 
+  // Detect all scope-type values used in the files being created.
+  // If any non-_local scope types are present and _core is not already included,
+  // auto-inject a minimal _core scope with the required scope-type policy stubs.
+  const scopeTypeValues = new Set();
+  for (const content of Object.values(files)) {
+    if (typeof content !== 'string') continue;
+    const matches = content.matchAll(/^scope-type:\s*(.+)$/gm);
+    for (const m of matches) {
+      const t = m[1].trim();
+      if (t !== '_local') scopeTypeValues.add(t);
+    }
+  }
+  const hasCoreScope = Object.keys(files).some((p) => p.includes('/_core/'));
+  if (scopeTypeValues.size > 0 && !hasCoreScope) {
+    const coreFiles = coreWithScopeTypes([...scopeTypeValues]);
+    Object.assign(files, coreFiles);
+  }
+
   for (const [relativePath, content] of Object.entries(files)) {
     const filePath = path.join(workspaceRoot, relativePath);
     fs.mkdirSync(path.dirname(filePath), { recursive: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xdrs-core",
-  "version": "0.32.0",
+  "version": "0.34.2",
   "description": "A framework to structure, compile and distribute Architectural (ADR), Business (BDR), and Engineering (EDR) decision records contents so that AI agents and humans can reliably find and use them with hierarchical scopes and controlled rollout in the format of distributable versioned packages.",
   "repository": {
     "type": "git",

package/.xdrs/_core/adrs/principles/010-core-scope-naming.md

@@ -1,71 +0,0 @@
----
-name: _core-adr-policy-010-core-scope-naming-convention
-description: Defines the -core suffix naming convention for XDRS scopes used to hold meta governance content such as writing standards, structural templates, ownership, and process guidance for a domain. Use when designing or evaluating shared scopes.
-apply-to: All XDRS scope authors and maintainers
-valid-from: 2026-06-24
----
-
-# _core-adr-policy-010: Core scope naming convention
-
-## Context and Problem Statement
-
-When teams create shared XDRS scopes (e.g., `security-standards`, `platform-engineering`), they often mix two kinds of content:
-
-- **Consumable policies**: rules and decisions that other teams or repositories must follow.
-- **Meta governance**: writing standards, structural templates, skill guidance, ownership definitions, and process rules that govern how content is authored within the domain.
-
-Mixing both kinds makes shared scopes harder to consume selectively and causes confusion about which content represents actual rules versus internal governance for scope contributors.
-
-How should teams separate meta governance from consumable policies within a scope domain?
-
-## Decision Outcome
-
-**Use a `-core` suffix sibling scope to hold all meta governance content for a domain.**
-
-A scope named `[domain]-core` (e.g., `security-core`, `platform-core`) is reserved for the meta organization of the `[domain]` scope family. It contains content that governs how policies are written and maintained within the domain — not the actual policies themselves.
-
-### Details
-
-#### 01-core-suffix-definition
-
-A scope name ending in `-core` signals that the scope holds meta governance content for scopes sharing the same prefix. It MUST NOT contain policies intended for direct consumption by other teams or repositories.
-
-Content that belongs in a `-core` scope:
-
-- Writing standards and templates specific to the domain.
-- Structural conventions for that domain's policies.
-- Process guidance for authoring or reviewing policies within the domain.
-- Skill files for domain-specific review or authoring workflows.
-- Ownership, contact, and governance information for the domain.
-
-Content that does NOT belong in a `-core` scope:
-
-- Actual rules or constraints for other teams to follow (e.g., security requirements, compliance rules).
-- Any policy intended to be enforced by external teams or repositories.
-
-#### 02-core-governs-same-prefix-scopes
-
-All XDRS scopes sharing the same prefix as a `-core` scope (e.g., `security-standards`, `security-cloud`) are governed by the standards defined in the corresponding `-core` scope (e.g., `security-core`). Authors of those scopes MUST follow the `-core` scope standards when writing, reviewing, or extending policies in any same-prefix scope.
-
-#### 03-core-scope-is-optional-but-recommended
-
-Creating a `-core` scope is optional. It is strongly recommended whenever a domain scope is intended to be shared with multiple teams or repositories. Separating meta governance into a `-core` scope prevents unnecessary internal content from being distributed to consumers and keeps the consumable scope focused on actual rules.
-
-#### 04-core-vs-local-scope
-
-The `-core` suffix is distinct from the `_local` scope:
-
-- `_local` holds project-specific overrides that are never shared and apply only to the current repository. It is implicitly present in every workspace and may contain a mix of local overrides unrelated to any particular domain.
-- A `-core` scope is a formal, named scope scoped to a domain. It can be shared selectively with contributors and is required to be followed by all authors writing content in any same-prefix scope.
-
-Use `_local` when meta governance is relevant only to the current repository. Use a `-core` scope when the governance applies to a named domain shared across teams or repositories.
-
-#### 05-core-scope-distribution
-
-A `-core` scope MAY be distributed to consumers alongside the companion consumable scope, or kept internal to the team that maintains the domain. When distributed, consumers who extend or contribute to the domain scope locally MUST follow its standards. When not distributed, internal contributors must still comply.
-
-## Considered Options
-
-1. **`_local` scope for meta content** — simple to set up, but mixes local project overrides with domain-level governance. Becomes confusing in large teams, especially when `_local` already contains project-specific policies.
-2. **Meta content embedded inside the consumable scope** — makes the shared scope noisier and harder for consumers to parse; no clear separation between governance and rules.
-3. **`-core` sibling scope (chosen)** — cleanly separates meta governance from consumable content, makes the governance explicit and discoverable, and enables selective distribution.