universal-dev-standards 4.2.0 → 5.0.0-beta.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-dev-standards",
-  "version": "4.2.0",
+  "version": "5.0.0-beta.10",
   "description": "CLI tool for adopting Universal Development Standards",
   "keywords": [
     "documentation",
@@ -65,7 +65,10 @@
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.16",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
     "eslint": "^8.56.0",
+    "glob": "^13.0.1",
     "husky": "^9.1.7",
     "lint-staged": "^15.2.10",
     "vitest": "^4.0.16"

package/src/commands/check.js

@@ -30,106 +30,54 @@ import {
   parseReferences,
   compareStandardsWithReferences
 } from '../utils/reference-sync.js';
-import {
-  extractMarkedContent,
-  getToolFilePath
-} from '../utils/integration-generator.js';
+import { extractMarkedContent, getToolFilePath } from '../utils/integration-generator.js';
 import { getToolFormat } from '../core/constants.js';
 import { checkForUpdates } from '../utils/npm-registry.js';
+import { StandardValidator } from '../utils/standard-validator.js';
 import { t, getLanguage, setLanguage, isLanguageExplicitlySet } from '../i18n/messages.js';
 
 /**
- * Check command - verify adoption status
- * @param {Object} options - Command options
+ * Display the summary of file integrity status
  */
-export async function checkCommand(options = {}) {
-  const projectPath = process.cwd();
-  // Get initial messages (before language is set from manifest)
-  let msg = t().commands.check;
-  let common = t().commands.common;
-
-  // Handle --summary option (compact status for other commands)
-  if (options.summary) {
-    await displaySummary(projectPath, options);
-    return;
+function displayFileIntegritySummary(fileStatus, msg) {
+  if (fileStatus.unchanged.length > 0) {
+    for (const file of fileStatus.unchanged) {
+      console.log(chalk.green(`  ✓ ${file} (${msg.unchanged})`));
+    }
   }
 
-  console.log();
-  console.log(chalk.bold(msg.title));
-  console.log(chalk.gray('─'.repeat(50)));
-
-  // Check if initialized
-  if (!isInitialized(projectPath)) {
-    console.log(chalk.red(common.notInitialized));
-    console.log(chalk.gray(`  ${common.runInit}`));
-    console.log();
-    return;
+  if (fileStatus.modified.length > 0) {
+    for (const file of fileStatus.modified) {
+      console.log(chalk.yellow(`  ⚠ ${file} (${msg.modified})`));
+    }
   }
 
-  // Read manifest
-  const manifest = readManifest(projectPath);
-  if (!manifest) {
-    console.log(chalk.red(common.couldNotReadManifest));
-    console.log(chalk.gray('  The .standards/manifest.json may be corrupted.'));
-    console.log();
-    return;
+  if (fileStatus.missing.length > 0) {
+    for (const file of fileStatus.missing) {
+      console.log(chalk.red(`  ✗ ${file} (${msg.missing})`));
+    }
   }
 
-  // Set UI language based on commit_language setting
-  // Only override if user didn't explicitly set --ui-lang flag
-  if (!isLanguageExplicitlySet()) {
-    const langMap = {
-      'traditional-chinese': 'zh-tw',
-      'simplified-chinese': 'zh-cn',
-      english: 'en',
-      bilingual: 'en'
-    };
-    const uiLang = langMap[manifest.options?.commit_language] || 'en';
-    setLanguage(uiLang);
+  if (fileStatus.noHash.length > 0) {
+    for (const file of fileStatus.noHash) {
+      console.log(chalk.gray(`  ? ${file} (${msg.existsNoHash})`));
+    }
   }
 
-  // Re-get localized messages with correct language
-  msg = t().commands.check;
-  common = t().commands.common;
-
-  // Display adoption info
-  const levelInfo = getLevelInfo(manifest.level);
-  const repoInfo = getRepositoryInfo();
-
-  console.log(chalk.green(msg.standardsInitialized));
   console.log();
-  console.log(chalk.cyan(msg.adoptionStatus));
-  const lang = getLanguage();
-  const zhName = lang === 'zh-cn' ? levelInfo.nameZhCn : levelInfo.nameZh;
-  const levelDisplay = lang === 'en'
-    ? `${manifest.level} - ${levelInfo.name}`
-    : `${manifest.level} - ${levelInfo.name} (${zhName})`;
-  console.log(chalk.gray(`  ${common.level}: ${levelDisplay}`));
-  console.log(chalk.gray(`  ${msg.installed}: ${manifest.upstream.installed}`));
-  console.log(chalk.gray(`  ${common.version}: ${manifest.upstream.version}`));
+  console.log(chalk.gray(`  ${msg.summary
+    .replace('{unchanged}', fileStatus.unchanged.length)
+    .replace('{modified}', fileStatus.modified.length)
+    .replace('{missing}', fileStatus.missing.length)}` +
+    (fileStatus.noHash.length > 0 ? `, ${fileStatus.noHash.length} no hash` : '')));
   console.log();
+}
 
-  // Check for updates (bundled registry)
-  if (manifest.upstream.version !== repoInfo.standards.version) {
-    console.log(chalk.yellow(msg.updateAvailable.replace('{current}', manifest.upstream.version).replace('{latest}', repoInfo.standards.version)));
-    console.log(chalk.gray(`  ${msg.runUpdate}`));
-    console.log();
-  }
-
-  // Check for CLI updates from npm registry (unless --offline)
-  if (!options.offline) {
-    await checkCliVersion(repoInfo.standards.version);
-  }
-
-  // Handle --migrate option
-  if (options.migrate) {
-    await migrateToHashBasedTracking(projectPath, manifest);
-    return;
-  }
-
-  // Check file integrity
-  console.log(chalk.cyan(msg.fileIntegrity));
-
+/**
+ * Perform integrity check for standards and integration files
+ * @returns {Object} File status object
+ */
+function performFileIntegrityCheck(projectPath, manifest, msg) {
   const fileStatus = {
     unchanged: [],
     modified: [],
@@ -192,38 +140,164 @@ export async function checkCommand(options = {}) {
     }
   }
 
-  // Display file status
-  if (fileStatus.unchanged.length > 0) {
-    for (const file of fileStatus.unchanged) {
-      console.log(chalk.green(`  ✓ ${file} (${msg.unchanged})`));
-    }
+  return fileStatus;
+}
+
+/**
+ * Initialize context for the check command (manifest, language, messages)
+ * @returns {Object|null} Context object or null if initialization failed
+ */
+function initializeCheckContext(projectPath) {
+  // Get initial messages (before language is set from manifest)
+  let common = t().commands.common;
+
+  // Check if initialized
+  if (!isInitialized(projectPath)) {
+    console.log(chalk.red(common.notInitialized));
+    console.log(chalk.gray(`  ${common.runInit}`));
+    console.log();
+    return null;
   }
 
-  if (fileStatus.modified.length > 0) {
-    for (const file of fileStatus.modified) {
-      console.log(chalk.yellow(`  ⚠ ${file} (${msg.modified})`));
-    }
+  // Read manifest
+  const manifest = readManifest(projectPath);
+  if (!manifest) {
+    console.log(chalk.red(common.couldNotReadManifest));
+    console.log(chalk.gray('  The .standards/manifest.json may be corrupted.'));
+    console.log();
+    return null;
   }
 
-  if (fileStatus.missing.length > 0) {
-    for (const file of fileStatus.missing) {
-      console.log(chalk.red(`  ✗ ${file} (${msg.missing})`));
-    }
+  // Set UI language based on commit_language setting
+  // Only override if user didn't explicitly set --ui-lang flag
+  if (!isLanguageExplicitlySet()) {
+    const langMap = {
+      'traditional-chinese': 'zh-tw',
+      'simplified-chinese': 'zh-cn',
+      english: 'en',
+      bilingual: 'en'
+    };
+    const uiLang = langMap[manifest.options?.commit_language] || 'en';
+    setLanguage(uiLang);
   }
 
-  if (fileStatus.noHash.length > 0) {
-    for (const file of fileStatus.noHash) {
-      console.log(chalk.gray(`  ? ${file} (${msg.existsNoHash})`));
+  // Re-get localized messages with correct language
+  return {
+    manifest,
+    repoInfo: getRepositoryInfo(),
+    msg: t().commands.check,
+    common: t().commands.common
+  };
+}
+
+/**
+ * Display standards adoption status and update information
+ */
+function displayAdoptionStatus(manifest, msg, common, repoInfo) {
+  const levelInfo = getLevelInfo(manifest.level);
+
+  console.log(chalk.green(msg.standardsInitialized));
+  console.log();
+  console.log(chalk.cyan(msg.adoptionStatus));
+  const lang = getLanguage();
+  const zhName = lang === 'zh-cn' ? levelInfo.nameZhCn : levelInfo.nameZh;
+  const levelDisplay = lang === 'en'
+    ? `${manifest.level} - ${levelInfo.name}`
+    : `${manifest.level} - ${levelInfo.name} (${zhName})`;
+  console.log(chalk.gray(`  ${common.level}: ${levelDisplay}`));
+  console.log(chalk.gray(`  ${msg.installed}: ${manifest.upstream.installed}`));
+  console.log(chalk.gray(`  ${common.version}: ${manifest.upstream.version}`));
+  console.log();
+
+  // Check for updates (bundled registry)
+  if (manifest.upstream.version !== repoInfo.standards.version) {
+    console.log(chalk.yellow(msg.updateAvailable.replace('{current}', manifest.upstream.version).replace('{latest}', repoInfo.standards.version)));
+    console.log(chalk.gray(`  ${msg.runUpdate}`));
+    console.log();
+  }
+}
+
+/**
+ * Check command - verify adoption status
+ * @param {Object} options - Command options
+ */
+export async function checkCommand(options = {}) {
+  const projectPath = process.cwd();
+
+  // Handle --standard option (validate specific standard physical spec)
+  if (options.standard) {
+    const validator = new StandardValidator(projectPath);
+    const result = await validator.validate(options.standard);
+    
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+      // Optionally exit with 1 if failed, but ensure JSON is printed first
+      if (!result.success) process.exitCode = 1;
+      return;
     }
+
+    console.log();
+    console.log(chalk.bold(`Checking compliance with standard: ${options.standard}`));
+    console.log(chalk.gray('─'.repeat(50)));
+    
+    if (result.success) {
+      if (result.skipped) {
+        console.log(chalk.yellow(`⚠  ${result.message}`));
+      } else {
+        console.log(chalk.green('✓  Validation Passed'));
+        console.log(chalk.gray(`   ${result.message}`));
+        if (result.details) console.log(chalk.gray(`   ${result.details}`));
+      }
+    } else {
+      console.log(chalk.red('✗  Validation Failed'));
+      console.log(chalk.red(`   ${result.message}`));
+      if (result.details) console.log(chalk.gray(`   ${result.details}`));
+      process.exitCode = 1;
+    }
+    console.log();
+    return;
   }
 
+  // Handle --summary option (compact status for other commands)
+  if (options.summary) {
+    await displaySummary(projectPath, options);
+    return;
+  }
+
+  // Phase 0: Initialization
+  const context = initializeCheckContext(projectPath);
+  if (!context) return;
+
+  const { manifest, msg, common, repoInfo } = context;
+
   console.log();
-  console.log(chalk.gray(`  ${msg.summary
-    .replace('{unchanged}', fileStatus.unchanged.length)
-    .replace('{modified}', fileStatus.modified.length)
-    .replace('{missing}', fileStatus.missing.length)}` +
-    (fileStatus.noHash.length > 0 ? `, ${fileStatus.noHash.length} no hash` : '')));
-  console.log();
+  console.log(chalk.bold(msg.title));
+  console.log(chalk.gray('─'.repeat(50)));
+
+  // Display adoption info
+  displayAdoptionStatus(manifest, msg, common, repoInfo);
+
+  // Check for CLI updates from npm registry (unless --offline)
+
+  // Check for CLI updates from npm registry (unless --offline)
+  if (!options.offline) {
+    await checkCliVersion(repoInfo.standards.version);
+  }
+
+  // Handle --migrate option
+  if (options.migrate) {
+    await migrateToHashBasedTracking(projectPath, manifest);
+    return;
+  }
+
+  // Check file integrity
+  console.log(chalk.cyan(msg.fileIntegrity));
+  const fileStatus = performFileIntegrityCheck(projectPath, manifest, msg);
+
+  // Display file status
+  displayFileIntegritySummary(fileStatus, msg);
+
+  // === Enhanced Integrity Checks (v3.3.0+) ===
 
   // === Enhanced Integrity Checks (v3.3.0+) ===
 
@@ -820,8 +894,8 @@ function displaySkillsStatus(manifest, projectPath, msg) {
 
   if (manifest.commands?.installations?.length > 0) {
     console.log(chalk.gray(`  ${msg.trackedCommandInstallations || 'Tracked command installations'}:`));
-    for (const agent of manifest.commands.installations) {
-      console.log(chalk.gray(`    - ${agent}`));
+    for (const inst of manifest.commands.installations) {
+      console.log(chalk.gray(`    - ${inst.agent}: ${inst.level}`));
     }
   }
 
@@ -981,39 +1055,34 @@ function checkReferenceSync(manifest, projectPath, msg) {
     return;
   }
 
-  console.log(chalk.cyan(msg.refSyncStatus));
-
-  let hasIssues = false;
-  let checkedCount = 0;
-
+  // Pre-scan: collect results for files that have references
+  const results = [];
   for (const integrationPath of manifest.integrations) {
     const fullPath = join(projectPath, integrationPath);
 
-    // Skip if file doesn't exist
-    if (!existsSync(fullPath)) {
-      continue;
-    }
+    if (!existsSync(fullPath)) continue;
 
-    // Read integration file content
     let content;
     try {
       content = readFileSync(fullPath, 'utf-8');
     } catch {
-      console.log(chalk.yellow(`  ⚠ ${integrationPath}: ${msg.couldNotRead}`));
       continue;
     }
 
-    // Parse references from integration file
     const references = parseReferences(content);
+    if (references.length === 0) continue;
 
-    // Skip if no references found (might be a static file or custom content)
-    if (references.length === 0) {
-      console.log(chalk.gray(`  ℹ ${integrationPath}: ${msg.noRefsFound}`));
-      continue;
-    }
+    results.push({ integrationPath, references });
+  }
 
-    checkedCount++;
+  // Skip entire section if no files have references
+  if (results.length === 0) return;
 
+  console.log(chalk.cyan(msg.refSyncStatus));
+
+  let hasIssues = false;
+
+  for (const { integrationPath, references } of results) {
     // Compare with manifest standards
     const { orphanedRefs, missingRefs, syncedRefs } = compareStandardsWithReferences(
       manifest.standards,
@@ -1044,10 +1113,6 @@ function checkReferenceSync(manifest, projectPath, msg) {
     }
   }
 
-  if (checkedCount === 0) {
-    console.log(chalk.gray(`  ${msg.noIntegrationRefs}`));
-  }
-
   if (hasIssues) {
     console.log();
     console.log(chalk.yellow(`  ${msg.runSyncRefs}`));
@@ -1195,7 +1260,7 @@ function checkCommandsIntegrity(manifest, projectPath, msg) {
     const filename = keyParts.slice(1).join('/');
 
     // Get actual file path
-    const commandsDir = getCommandsDirForAgent(agent, projectPath);
+    const commandsDir = getCommandsDirForAgent(agent, 'project', projectPath);
     if (!commandsDir) {
       status.missing.push(hashKey);
       continue;