universal-dev-standards 3.5.1-beta.3 → 3.5.1-beta.5

package/package.json

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

package/src/commands/update.js

@@ -26,6 +26,7 @@ import {
 } from '../utils/skills-installer.js';
 import {
   getAgentDisplayName,
+  getAgentConfig,
   getSkillsDirForAgent,
   getCommandsDirForAgent
 } from '../config/ai-agent-paths.js';
@@ -404,6 +405,83 @@ export async function updateCommand(options) {
     }
   }
 
+  // Check for new features (Skills/Commands) not yet installed
+  if (!options.standardsOnly) {
+    const { missingSkills, missingCommands } = checkNewFeatures(projectPath, manifest);
+
+    if (missingSkills.length > 0 || missingCommands.length > 0) {
+      if (!options.yes) {
+        // Interactive mode: prompt user to install
+        const { installSkills, installCommands } = await promptNewFeatureInstallation(
+          missingSkills,
+          missingCommands
+        );
+
+        // Install Skills if user agreed
+        if (installSkills.length > 0) {
+          const skillSpinner = ora(msg.installingNewSkills || 'Installing Skills...').start();
+          const skillResult = await installSkillsToMultipleAgents(installSkills, null, projectPath);
+
+          // Update manifest
+          if (!manifest.skills) manifest.skills = {};
+          manifest.skills.installed = true;
+          manifest.skills.version = repoInfo.skills.version;
+          manifest.skills.installations = [
+            ...(manifest.skills.installations || []),
+            ...installSkills
+          ];
+
+          if (skillResult.totalErrors === 0) {
+            skillSpinner.succeed((msg.newSkillsInstalled || 'Installed Skills for {count} AI tools')
+              .replace('{count}', installSkills.length));
+          } else {
+            skillSpinner.warn((msg.newSkillsInstalledWithErrors || 'Installed Skills with {errors} errors')
+              .replace('{errors}', skillResult.totalErrors));
+          }
+        }
+
+        // Install Commands if user agreed
+        if (installCommands.length > 0) {
+          const cmdSpinner = ora(msg.installingNewCommands || 'Installing commands...').start();
+          const cmdResult = await installCommandsToMultipleAgents(installCommands, null, projectPath);
+
+          // Update manifest
+          if (!manifest.commands) manifest.commands = {};
+          manifest.commands.installed = true;
+          manifest.commands.installations = [
+            ...(manifest.commands.installations || []),
+            ...installCommands
+          ];
+
+          if (cmdResult.totalErrors === 0) {
+            cmdSpinner.succeed((msg.newCommandsInstalled || 'Installed commands for {count} AI tools')
+              .replace('{count}', installCommands.length));
+          } else {
+            cmdSpinner.warn((msg.newCommandsInstalledWithErrors || 'Installed commands with {errors} errors')
+              .replace('{errors}', cmdResult.totalErrors));
+          }
+        }
+
+        // Write updated manifest if anything was installed
+        if (installSkills.length > 0 || installCommands.length > 0) {
+          writeManifest(manifest, projectPath);
+        }
+      } else {
+        // --yes mode: show hint but don't auto-install (conservative behavior)
+        console.log();
+        console.log(chalk.cyan(msg.newFeaturesAvailableHint || 'Note: New features available for your AI tools'));
+        if (missingSkills.length > 0) {
+          const toolNames = missingSkills.map(s => s.displayName).join(', ');
+          console.log(chalk.gray(`  • Skills (${toolNames}): run "uds update --skills" or "uds init" to install`));
+        }
+        if (missingCommands.length > 0) {
+          const toolNames = missingCommands.map(c => c.displayName).join(', ');
+          console.log(chalk.gray(`  • Commands (${toolNames}): run "uds update --commands" or "uds init" to install`));
+        }
+      }
+    }
+  }
+
   // Skills update reminder
   if (manifest.skills?.installed) {
     const skillsVersion = repoInfo.skills.version;
@@ -835,3 +913,153 @@ async function updateCommandsOnly(projectPath, manifest) {
   console.log();
   process.exit(0);
 }
+
+/**
+ * Check manifest.aiTools and detect missing Skills/Commands
+ * @param {string} projectPath - Project path
+ * @param {Object} manifest - Manifest object
+ * @returns {{missingSkills: Array, missingCommands: Array}}
+ */
+function checkNewFeatures(projectPath, manifest) {
+  const aiTools = manifest.aiTools || [];
+
+  if (aiTools.length === 0) {
+    return { missingSkills: [], missingCommands: [] };
+  }
+
+  const missingSkills = [];
+  const missingCommands = [];
+
+  for (const tool of aiTools) {
+    const config = getAgentConfig(tool);
+    if (!config) continue;
+
+    // Check Skills support
+    if (config.supportsSkills && config.skills) {
+      // Check if skills are installed for this agent
+      const projectInfo = getInstalledSkillsInfoForAgent(tool, 'project', projectPath);
+      const userInfo = getInstalledSkillsInfoForAgent(tool, 'user');
+
+      // Check if already in manifest.skills.installations
+      const existingInstallations = manifest.skills?.installations || [];
+      const isInManifest = existingInstallations.some(
+        inst => inst.agent === tool || (inst.agent === 'claude-code' && tool === 'claude-code')
+      );
+
+      // Check if using marketplace (Claude Code only)
+      const usingMarketplace = manifest.skills?.location === 'marketplace' && tool === 'claude-code';
+
+      const hasSkills = projectInfo?.installed || userInfo?.installed || isInManifest || usingMarketplace;
+
+      if (!hasSkills) {
+        missingSkills.push({
+          agent: tool,
+          displayName: getAgentDisplayName(tool),
+          paths: config.skills
+        });
+      }
+    }
+
+    // Check Commands support
+    if (config.commands !== null && config.commands) {
+      const cmdInfo = getInstalledCommandsForAgent(tool, projectPath);
+
+      // Check if already in manifest.commands.installations
+      const existingCmdInstallations = manifest.commands?.installations || [];
+      const isInCmdManifest = existingCmdInstallations.includes(tool);
+
+      const hasCommands = cmdInfo?.installed || isInCmdManifest;
+
+      if (!hasCommands) {
+        missingCommands.push({
+          agent: tool,
+          displayName: getAgentDisplayName(tool),
+          path: config.commands.project
+        });
+      }
+    }
+  }
+
+  return { missingSkills, missingCommands };
+}
+
+/**
+ * Prompt user to install new features discovered during update
+ * @param {Array} missingSkills - Array of {agent, displayName, paths}
+ * @param {Array} missingCommands - Array of {agent, displayName, path}
+ * @returns {Promise<{installSkills: Array, installCommands: Array}>}
+ */
+async function promptNewFeatureInstallation(missingSkills, missingCommands) {
+  const msg = t().commands.update;
+
+  // If nothing missing, return empty
+  if (missingSkills.length === 0 && missingCommands.length === 0) {
+    return { installSkills: [], installCommands: [] };
+  }
+
+  console.log();
+  console.log(chalk.cyan('━'.repeat(50)));
+  console.log(chalk.cyan.bold(msg.newFeaturesAvailable || 'New Features Available'));
+  console.log(chalk.cyan('━'.repeat(50)));
+  console.log();
+
+  const result = { installSkills: [], installCommands: [] };
+
+  // Handle missing Skills
+  if (missingSkills.length > 0) {
+    console.log(chalk.yellow(msg.skillsNotInstalledFor || 'Skills not yet installed for these AI tools:'));
+    for (const skill of missingSkills) {
+      console.log(chalk.gray(`  • ${skill.displayName}`));
+    }
+    console.log();
+
+    const { shouldInstallSkills } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'shouldInstallSkills',
+      message: msg.installSkillsNow || 'Would you like to install Skills for these AI tools?',
+      default: true
+    }]);
+
+    if (shouldInstallSkills) {
+      // Prompt for installation level
+      const { skillsLevel } = await inquirer.prompt([{
+        type: 'list',
+        name: 'skillsLevel',
+        message: msg.skillsLevelQuestion || 'Where should Skills be installed?',
+        choices: [
+          { name: `${msg.projectLevel || 'Project level'} (.claude/skills/, etc.)`, value: 'project' },
+          { name: `${msg.userLevel || 'User level'} (~/.claude/skills/, etc.)`, value: 'user' }
+        ],
+        default: 'project'
+      }]);
+
+      result.installSkills = missingSkills.map(s => ({
+        agent: s.agent,
+        level: skillsLevel
+      }));
+    }
+    console.log();
+  }
+
+  // Handle missing Commands
+  if (missingCommands.length > 0) {
+    console.log(chalk.yellow(msg.commandsNotInstalledFor || 'Slash commands not yet installed for these AI tools:'));
+    for (const cmd of missingCommands) {
+      console.log(chalk.gray(`  • ${cmd.displayName} → ${cmd.path}`));
+    }
+    console.log();
+
+    const { shouldInstallCommands } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'shouldInstallCommands',
+      message: msg.installCommandsNow || 'Would you like to install slash commands for these AI tools?',
+      default: true
+    }]);
+
+    if (shouldInstallCommands) {
+      result.installCommands = missingCommands.map(c => c.agent);
+    }
+  }
+
+  return result;
+}

package/src/i18n/messages.js

@@ -744,7 +744,23 @@ export const messages = {
         categoriesChanged: 'Categories: {old} → {new}',
         failedToUpdate: '✗ Failed to update {path}: {error}',
         updatedCount: '✓ Updated {count} integration file(s)',
-        skippedCount: 'Skipped {count} file(s) (already in sync or not found)'
+        skippedCount: 'Skipped {count} file(s) (already in sync or not found)',
+        // New features discovery
+        newFeaturesAvailable: 'New Features Available',
+        newFeaturesAvailableHint: 'Note: New features available for your AI tools',
+        skillsNotInstalledFor: 'Skills not yet installed for these AI tools:',
+        commandsNotInstalledFor: 'Slash commands not yet installed for these AI tools:',
+        installSkillsNow: 'Would you like to install Skills for these AI tools?',
+        installCommandsNow: 'Would you like to install slash commands for these AI tools?',
+        skillsLevelQuestion: 'Where should Skills be installed?',
+        projectLevel: 'Project level',
+        userLevel: 'User level',
+        installingNewSkills: 'Installing Skills...',
+        installingNewCommands: 'Installing commands...',
+        newSkillsInstalled: 'Installed Skills for {count} AI tools',
+        newSkillsInstalledWithErrors: 'Installed Skills with {errors} errors',
+        newCommandsInstalled: 'Installed commands for {count} AI tools',
+        newCommandsInstalledWithErrors: 'Installed commands with {errors} errors'
       },
 
       // configure command
@@ -1553,7 +1569,23 @@ export const messages = {
         categoriesChanged: '分類：{old} → {new}',
         failedToUpdate: '✗ 更新 {path} 失敗：{error}',
         updatedCount: '✓ 已更新 {count} 個整合檔案',
-        skippedCount: '已跳過 {count} 個檔案（已同步或找不到）'
+        skippedCount: '已跳過 {count} 個檔案（已同步或找不到）',
+        // New features discovery
+        newFeaturesAvailable: '發現新功能',
+        newFeaturesAvailableHint: '提示：您的 AI 工具有新功能可用',
+        skillsNotInstalledFor: '以下 AI 工具尚未安裝 Skills：',
+        commandsNotInstalledFor: '以下 AI 工具尚未安裝斜線命令：',
+        installSkillsNow: '是否要為這些 AI 工具安裝 Skills？',
+        installCommandsNow: '是否要為這些 AI 工具安裝斜線命令？',
+        skillsLevelQuestion: 'Skills 要安裝到哪裡？',
+        projectLevel: '專案層級',
+        userLevel: '使用者層級',
+        installingNewSkills: '安裝 Skills 中...',
+        installingNewCommands: '安裝斜線命令中...',
+        newSkillsInstalled: '已為 {count} 個 AI 工具安裝 Skills',
+        newSkillsInstalledWithErrors: '安裝 Skills 時發生 {errors} 個錯誤',
+        newCommandsInstalled: '已為 {count} 個 AI 工具安裝斜線命令',
+        newCommandsInstalledWithErrors: '安裝斜線命令時發生 {errors} 個錯誤'
       },
 
       // configure command
@@ -2194,7 +2226,23 @@ export const messages = {
         categoriesChanged: '类别：{old} → {new}',
         failedToUpdate: '✗ 更新 {path} 失败：{error}',
         updatedCount: '✓ 已更新 {count} 个集成文件',
-        skippedCount: '跳过 {count} 个文件（已同步或未找到）'
+        skippedCount: '跳过 {count} 个文件（已同步或未找到）',
+        // New features discovery
+        newFeaturesAvailable: '发现新功能',
+        newFeaturesAvailableHint: '提示：您的 AI 工具有新功能可用',
+        skillsNotInstalledFor: '以下 AI 工具尚未安装 Skills：',
+        commandsNotInstalledFor: '以下 AI 工具尚未安装斜线命令：',
+        installSkillsNow: '是否要为这些 AI 工具安装 Skills？',
+        installCommandsNow: '是否要为这些 AI 工具安装斜线命令？',
+        skillsLevelQuestion: 'Skills 要安装到哪里？',
+        projectLevel: '项目级别',
+        userLevel: '用户级别',
+        installingNewSkills: '正在安装 Skills...',
+        installingNewCommands: '正在安装斜线命令...',
+        newSkillsInstalled: '已为 {count} 个 AI 工具安装 Skills',
+        newSkillsInstalledWithErrors: '安装 Skills 时发生 {errors} 个错误',
+        newCommandsInstalled: '已为 {count} 个 AI 工具安装斜线命令',
+        newCommandsInstalledWithErrors: '安装斜线命令时发生 {errors} 个错误'
       },
 
       // configure command

package/standards-registry.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "version": "3.5.1-beta.3",
+  "version": "3.5.1-beta.5",
   "lastUpdated": "2026-01-15",
   "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": "3.5.1-beta.3"
+      "version": "3.5.1-beta.5"
     },
     "skills": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
       "localPath": "skills/claude-code",
       "rawUrl": "https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills/claude-code",
-      "version": "3.5.1-beta.3",
+      "version": "3.5.1-beta.5",
       "note": "Skills are now included in the main repository under skills/"
     }
   },