universal-dev-standards 5.0.0-beta.5 → 5.0.0-beta.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-dev-standards",
-  "version": "5.0.0-beta.5",
+  "version": "5.0.0-beta.6",
   "description": "CLI tool for adopting Universal Development Standards",
   "keywords": [
     "documentation",

package/src/commands/init.js

@@ -2,7 +2,7 @@ import chalk from 'chalk';
 import ora from 'ora';
 import { execSync } from 'child_process';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
-import { join } from 'path';
+import { basename, join } from 'path';
 import {
   manifestExists as isInitialized
 } from '../core/manifest.js';
@@ -88,6 +88,7 @@ export async function initCommand(options) {
   
   // 1. Install Standards
   const standardsResults = await installStandards(config, projectPath);
+  config.installedStandards = standardsResults.standards.map(s => basename(s));
 
   // 2. Install Integrations
   const integrationResults = await installIntegrations(config, projectPath);

package/src/installers/integration-installer.js

@@ -5,6 +5,7 @@ import {
   integrationFileExists,
   getToolFilePath
 } from '../utils/integration-generator.js';
+import { calculateCategoriesFromStandards } from '../utils/reference-sync.js';
 import { t } from '../i18n/messages.js';
 
 /**
@@ -105,10 +106,15 @@ export async function installIntegrations(config, projectPath) {
     }
 
     // Build enhanced config with installed standards
+    // Filter categories to only those backed by installed standards to avoid orphaned references
+    const requestedCategories = integrationConfigs[tool]?.categories || ['anti-hallucination', 'commit-standards', 'code-review'];
+    const validCategories = installedStandards.length > 0
+      ? requestedCategories.filter(cat => calculateCategoriesFromStandards(installedStandards).includes(cat))
+      : requestedCategories;
     const enhancedConfig = {
       ...integrationConfigs[tool],
       tool,
-      categories: integrationConfigs[tool]?.categories || ['anti-hallucination', 'commit-standards', 'code-review'],
+      categories: validCategories,
       language: integrationConfigs[tool]?.language || commonLanguage,
       installedStandards,
       contentMode,
@@ -200,9 +206,13 @@ export async function generateClaudeMd(config, projectPath) {
 
   const claudeSpinner = ora(msg.generatingClaudeMd).start();
 
+  // Derive categories from installedStandards to avoid referencing non-installed standards
+  const categories = installedStandards.length > 0
+    ? calculateCategoriesFromStandards(installedStandards)
+    : ['anti-hallucination', 'commit-standards', 'code-review'];
   const claudeConfig = {
     tool: 'claude-code',
-    categories: ['anti-hallucination', 'commit-standards', 'code-review'],
+    categories,
     languages: [],
     exclusions: [],
     customRules: [],

package/src/utils/reference-sync.js

@@ -26,7 +26,7 @@ export const CATEGORY_TO_STANDARDS = {
  * Reverse mapping from standard filename to category ID
  */
 export const STANDARD_TO_CATEGORY = {
-  // Core Rules
+  // Core Rules (human .md format)
   'anti-hallucination.md': 'anti-hallucination',
   'commit-message-guide.md': 'commit-standards',
   'code-review-checklist.md': 'code-review',
@@ -40,6 +40,20 @@ export const STANDARD_TO_CATEGORY = {
   'project-structure.md': 'project-structure',
   'refactoring-standards.md': 'refactoring',
   'requirement-engineering.md': 'requirement',
+  // Core Rules (AI .ai.yaml format)
+  'anti-hallucination.ai.yaml': 'anti-hallucination',
+  'commit-message.ai.yaml': 'commit-standards',
+  'code-review.ai.yaml': 'code-review',
+  'checkin-standards.ai.yaml': 'code-review',
+  'spec-driven-development.ai.yaml': 'spec-driven-development',
+  'testing.ai.yaml': 'testing',
+  'documentation-structure.ai.yaml': 'documentation',
+  'git-workflow.ai.yaml': 'git-workflow',
+  'error-codes.ai.yaml': 'error-handling',
+  'logging.ai.yaml': 'error-handling',
+  'project-structure.ai.yaml': 'project-structure',
+  'refactoring-standards.ai.yaml': 'refactoring',
+  'requirement-engineering.ai.yaml': 'requirement',
   // Guides (educational content)
   'anti-hallucination-guide.md': 'anti-hallucination',
   'sdd-guide.md': 'spec-driven-development',
@@ -104,26 +118,43 @@ export function getStandardCategory(sourcePath) {
  *   - syncedRefs: Standards that are properly synced
  */
 export function compareStandardsWithReferences(manifestStandards, integrationReferences) {
-  // Get filenames from manifest standards (only those that have category mappings)
-  const manifestFileNames = new Set();
+  // Compare at category level to handle .md vs .ai.yaml format differences
+  // e.g., manifest has 'anti-hallucination.ai.yaml' but integration references 'anti-hallucination.md'
+  const manifestCategories = new Set();
   for (const std of manifestStandards) {
     const fileName = std.split('/').pop();
-    // Only include standards that are part of the category system
-    if (STANDARD_TO_CATEGORY[fileName]) {
-      manifestFileNames.add(fileName);
+    const category = STANDARD_TO_CATEGORY[fileName];
+    if (category) {
+      manifestCategories.add(category);
     }
   }
 
-  const refSet = new Set(integrationReferences);
-
-  // References in integration file but not in manifest
-  const orphanedRefs = integrationReferences.filter(ref => !manifestFileNames.has(ref));
+  // References in integration file but not backed by any manifest standard (by category)
+  const orphanedRefs = integrationReferences.filter(ref => {
+    const category = STANDARD_TO_CATEGORY[ref];
+    return !category || !manifestCategories.has(category);
+  });
 
-  // Standards in manifest but not referenced
-  const missingRefs = [...manifestFileNames].filter(fileName => !refSet.has(fileName));
+  // Categories in manifest but not referenced in integration file
+  const refCategories = new Set();
+  for (const ref of integrationReferences) {
+    const category = STANDARD_TO_CATEGORY[ref];
+    if (category) {
+      refCategories.add(category);
+    }
+  }
+  const missingCategories = [...manifestCategories].filter(cat => !refCategories.has(cat));
+  // Convert missing categories back to representative filenames for reporting
+  const missingRefs = missingCategories.flatMap(cat => {
+    const paths = CATEGORY_TO_STANDARDS[cat] || [];
+    return paths.map(p => p.split('/').pop());
+  });
 
   // Properly synced references
-  const syncedRefs = integrationReferences.filter(ref => manifestFileNames.has(ref));
+  const syncedRefs = integrationReferences.filter(ref => {
+    const category = STANDARD_TO_CATEGORY[ref];
+    return category && manifestCategories.has(category);
+  });
 
   return { orphanedRefs, missingRefs, syncedRefs };
 }

package/standards-registry.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "version": "5.0.0-beta.5",
+  "version": "5.0.0-beta.6",
   "lastUpdated": "2026-02-04",
   "description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
   "formats": {
@@ -48,14 +48,14 @@
     "standards": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
-      "version": "5.0.0-beta.5"
+      "version": "5.0.0-beta.6"
     },
     "skills": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
       "localPath": "skills",
       "rawUrl": "https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills",
-      "version": "5.0.0-beta.5",
+      "version": "5.0.0-beta.6",
       "note": "Skills are now included in the main repository under skills/"
     }
   },