xdrs-core 0.15.3 → 0.15.4

package/lib/lint.js

@@ -248,7 +248,6 @@ function lintXdrFile(xdrsRoot, scopeName, typeName, filePath, xdrNumbers, errors
   }
 
   const number = match[1];
-  const shortTitle = match[2];
   const previous = xdrNumbers.get(number);
   if (previous) {
     errors.push(`Duplicate XDR number ${number} in ${scopeName}/${typeName}: ${toDisplayPath(previous)} and ${toDisplayPath(filePath)}`);
@@ -267,11 +266,37 @@ function lintXdrFile(xdrsRoot, scopeName, typeName, filePath, xdrNumbers, errors
     errors.push(`XDR title must start with "${expectedHeader}": ${toDisplayPath(filePath)}`);
   }
 
-  const expectedName = `${scopeName}-${TYPE_TO_ID[typeName]}-${number}-${shortTitle}`;
+  const expectedName = extractExpectedXdrNameFromHeading(firstLine)
+    || `${scopeName}-${TYPE_TO_ID[typeName]}-${number}-${match[2]}`;
   lintXdrFrontmatter(content, expectedName, filePath, errors);
   lintDocumentLinks(filePath, errors);
 }
 
+function extractExpectedXdrNameFromHeading(headingLine) {
+  const match = headingLine.match(/^#\s+([a-z0-9_]+-(?:adr|bdr|edr)-\d{3,}):\s+(.+?)\s*$/);
+  if (!match) {
+    return null;
+  }
+
+  const identifier = match[1];
+  const titleSlug = slugifyTitle(match[2]);
+  if (!titleSlug) {
+    return null;
+  }
+
+  return `${identifier}-${titleSlug}`;
+}
+
+function slugifyTitle(title) {
+  return title
+    .normalize('NFKD')
+    .replace(/[\u0300-\u036f]/g, '')
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+    .replace(/--+/g, '-');
+}
+
 function lintXdrFrontmatter(content, expectedName, filePath, errors) {
   const fm = extractFrontmatter(content);
   if (!fm.present) {

package/lib/lint.test.js

@@ -82,6 +82,32 @@ test('skips read-only files by default and checks them when ignoreReadOnly is fa
   expect(allResult.errors.join('\n')).toContain('Broken local link in');
 });
 
+test('derives expected frontmatter name from the markdown heading title', () => {
+  const workspaceRoot = createWorkspace('heading-name-match', {
+    '.xdrs/index.md': rootIndex(),
+    '.xdrs/_local/adrs/index.md': localAdrIndex([
+      '- [002-scope-guidelines](principles/002-xdr-scope-guidelines.md) - Scope guidelines'
+    ]),
+    '.xdrs/_local/adrs/principles/002-xdr-scope-guidelines.md': [
+      '---',
+      'name: _local-adr-002-xdr-scope-guidelines-for-agentme',
+      'description: Test XDR document',
+      '---',
+      '',
+      '# _local-adr-002: XDR scope guidelines for agentme',
+      '',
+      '## Context and Problem Statement',
+      '',
+      'Test body.',
+      ''
+    ].join('\n'),
+  });
+
+  const result = lintWorkspace(workspaceRoot, { ignoreReadOnly: false });
+
+  expect(result.errors.join('\n')).not.toContain('XDR frontmatter name must be');
+});
+
 function createWorkspace(name, files) {
   const workspaceRoot = path.join(tmpRoot, name);
   fs.mkdirSync(workspaceRoot, { recursive: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xdrs-core",
-  "version": "0.15.3",
+  "version": "0.15.4",
   "description": "A standard way to organize Decision Records (XDRs) across scopes, subjects, and teams so that AI agents can reliably query and follow them.",
   "repository": {
     "type": "git",