@sk8metal/michi-cli 0.0.1 → 0.0.2

package/scripts/utils/config-loader.ts

@@ -0,0 +1,326 @@
+/**
+ * 設定読み込み・マージ機能
+ * デフォルト設定 + プロジェクト固有設定をマージ
+ */
+
+import { readFileSync, existsSync, statSync } from 'fs';
+import { resolve, relative, isAbsolute } from 'path';
+import { fileURLToPath } from 'url';
+import { config } from 'dotenv';
+import { AppConfigSchema, type AppConfig } from '../config/config-schema.js';
+
+// 環境変数読み込み
+config();
+
+/**
+ * 深いマージ（Deep Merge）
+ * オブジェクトを再帰的にマージする
+ */
+function deepMerge<T extends Record<string, any>>(target: T, source: Partial<T>): T {
+  const result = { ...target };
+  
+  for (const key in source) {
+    if (source[key] && typeof source[key] === 'object' && !Array.isArray(source[key])) {
+      result[key] = deepMerge(result[key] || {} as T[Extract<keyof T, string>], source[key] as Partial<T[Extract<keyof T, string>]>);
+    } else if (source[key] !== undefined) {
+      result[key] = source[key] as T[Extract<keyof T, string>];
+    }
+  }
+  
+  return result;
+}
+
+/**
+ * 許可された環境変数のリスト
+ * セキュリティのため、設定ファイルで展開可能な環境変数を制限
+ */
+const ALLOWED_ENV_VARS = [
+  'CONFLUENCE_PRD_SPACE',
+  'CONFLUENCE_QA_SPACE',
+  'CONFLUENCE_RELEASE_SPACE'
+];
+
+/**
+ * 環境変数を文字列に展開
+ * ${VAR_NAME} 形式のプレースホルダーを環境変数の値に置換
+ * セキュリティのため、許可リストに含まれる環境変数のみ展開
+ */
+function expandEnvVars(str: string): string {
+  return str.replace(/\$\{([^}]+)\}/g, (match, varName) => {
+    if (ALLOWED_ENV_VARS.includes(varName)) {
+      return process.env[varName] || match;
+    }
+    // 許可されていない環境変数は警告を出して展開しない
+    console.warn(`⚠️  Environment variable "${varName}" is not allowed in config. Skipping expansion.`);
+    return match;
+  });
+}
+
+/**
+ * 設定オブジェクト内の文字列値を環境変数で展開
+ * 循環参照を防ぐため、処理済みオブジェクトを追跡
+ */
+function expandEnvVarsInConfig(config: any, visited: WeakSet<object> = new WeakSet()): any {
+  if (typeof config === 'string') {
+    return expandEnvVars(config);
+  }
+  
+  if (Array.isArray(config)) {
+    return config.map(item => expandEnvVarsInConfig(item, visited));
+  }
+  
+  if (config && typeof config === 'object') {
+    // 循環参照のチェック
+    if (visited.has(config)) {
+      console.warn('⚠️  Circular reference detected in config. Skipping expansion.');
+      return config;
+    }
+    
+    visited.add(config);
+    const result: any = {};
+    for (const key in config) {
+      result[key] = expandEnvVarsInConfig(config[key], visited);
+    }
+    visited.delete(config);
+    return result;
+  }
+  
+  return config;
+}
+
+/**
+ * デフォルト設定を読み込む
+ */
+function loadDefaultConfig(): AppConfig {
+  // import.meta.urlからディレクトリパスを取得
+  const currentFileUrl = import.meta.url;
+  const currentFilePath = fileURLToPath(currentFileUrl);
+  const currentDir = resolve(currentFilePath, '..');
+  const defaultConfigPath = resolve(currentDir, '../config/default-config.json');
+  
+  if (!existsSync(defaultConfigPath)) {
+    throw new Error(`Default config file not found: ${defaultConfigPath}\nPlease ensure the file exists in the scripts/config directory.`);
+  }
+  
+  try {
+    const content = readFileSync(defaultConfigPath, 'utf-8');
+    const parsed = JSON.parse(content);
+    
+    // 環境変数を展開
+    const expanded = expandEnvVarsInConfig(parsed);
+    
+    // スキーマでバリデーション
+    return AppConfigSchema.parse(expanded);
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      throw new Error(`Invalid JSON in default config file ${defaultConfigPath}: ${error.message}\nLine: ${(error as any).line}, Column: ${(error as any).column}`);
+    }
+    if (error instanceof Error && error.name === 'ZodError') {
+      throw new Error(`Default config validation failed: ${error.message}\nFile: ${defaultConfigPath}`);
+    }
+    throw new Error(`Failed to load default config from ${defaultConfigPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+  }
+}
+
+/**
+ * パストラバーサル攻撃を防ぐため、パスを検証
+ */
+function validateConfigPath(configPath: string, projectRoot: string): boolean {
+  const resolvedPath = resolve(configPath);
+  const resolvedRoot = resolve(projectRoot);
+  const relativePath = relative(resolvedRoot, resolvedPath);
+
+  // プロジェクトルート自体の場合は許可
+  if (!relativePath) {
+    return true;
+  }
+
+  // 相対パスが '..' で始まる、または絶対パスの場合は拒否
+  // これにより、プロジェクトルート外のパスを防ぐ
+  return !relativePath.startsWith('..') && !isAbsolute(relativePath);
+}
+
+/**
+ * プロジェクト固有設定を読み込む
+ */
+function loadProjectConfig(projectRoot: string = process.cwd()): Partial<AppConfig> | null {
+  const projectConfigPath = resolve(projectRoot, '.kiro/config.json');
+  
+  // パストラバーサル対策: パスを検証
+  if (!validateConfigPath(projectConfigPath, projectRoot)) {
+    throw new Error(`Invalid config path: ${projectConfigPath} is outside project root`);
+  }
+  
+  if (!existsSync(projectConfigPath)) {
+    return null;
+  }
+  
+  try {
+    const content = readFileSync(projectConfigPath, 'utf-8');
+    const parsed = JSON.parse(content);
+    
+    // 環境変数を展開
+    const expanded = expandEnvVarsInConfig(parsed);
+    
+    // 部分的な設定なので、スキーマで厳密にバリデーションしない
+    // ただし、存在するキーについては型チェック
+    return expanded as Partial<AppConfig>;
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      throw new Error(`Invalid JSON in ${projectConfigPath}: ${error.message}`);
+    }
+    if (error instanceof Error && error.message.includes('Invalid config path')) {
+      throw error;
+    }
+    throw new Error(`Failed to load project config from ${projectConfigPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+  }
+}
+
+/**
+ * 設定を読み込んでマージ
+ * 
+ * マージ順序:
+ * 1. デフォルト設定
+ * 2. プロジェクト固有設定（上書き）
+ * 3. 環境変数（最終上書き、既存の動作を維持）
+ */
+export function loadConfig(projectRoot: string = process.cwd()): AppConfig {
+  // デフォルト設定を読み込み
+  const defaultConfig = loadDefaultConfig();
+  
+  // プロジェクト固有設定を読み込み
+  const projectConfig = loadProjectConfig(projectRoot);
+  
+  // マージ（プロジェクト設定がデフォルトを上書き）
+  let mergedConfig: AppConfig = projectConfig
+    ? deepMerge(defaultConfig, projectConfig)
+    : defaultConfig;
+  
+  // 環境変数で最終上書き（条件付き）
+  // 注意: config.jsonにspaces設定がある場合は環境変数を無視（config.jsonを優先）
+  if (process.env.CONFLUENCE_PRD_SPACE) {
+    if (!mergedConfig.confluence) {
+      mergedConfig.confluence = {
+        pageCreationGranularity: 'single',
+        pageTitleFormat: '[{projectName}] {featureName} {docTypeLabel}',
+        autoLabels: ['{projectLabel}', '{docType}', '{featureName}', 'github-sync']
+      };
+    }
+    // spacesオブジェクトを確実に作成
+    if (!mergedConfig.confluence.spaces) {
+      mergedConfig.confluence.spaces = {};
+    }
+    // 各フィールドを個別にチェックし、未定義のフィールドのみ環境変数で設定
+    // 既に定義されている値は変更しない
+    if (!mergedConfig.confluence.spaces.requirements) {
+      mergedConfig.confluence.spaces.requirements = process.env.CONFLUENCE_PRD_SPACE;
+    }
+    if (!mergedConfig.confluence.spaces.design) {
+      mergedConfig.confluence.spaces.design = process.env.CONFLUENCE_PRD_SPACE;
+    }
+    if (!mergedConfig.confluence.spaces.tasks) {
+      mergedConfig.confluence.spaces.tasks = process.env.CONFLUENCE_PRD_SPACE;
+    }
+  }
+  
+  // JIRA issue type IDを環境変数から取得（インスタンス固有の値のため）
+  if (mergedConfig.jira && mergedConfig.jira.issueTypes) {
+    if (process.env.JIRA_ISSUE_TYPE_STORY) {
+      mergedConfig.jira.issueTypes.story = process.env.JIRA_ISSUE_TYPE_STORY;
+    }
+    if (process.env.JIRA_ISSUE_TYPE_SUBTASK) {
+      mergedConfig.jira.issueTypes.subtask = process.env.JIRA_ISSUE_TYPE_SUBTASK;
+    }
+  }
+  
+  // スキーマで最終バリデーション
+  return AppConfigSchema.parse(mergedConfig);
+}
+
+/**
+ * 設定を取得（キャッシュ付き）
+ * 設定ファイルの変更を検知してキャッシュを無効化
+ */
+let cachedConfig: AppConfig | null = null;
+let cachedProjectRoot: string | null = null;
+let cachedConfigMtime: number | null = null;
+let cachedDefaultConfigMtime: number | null = null;
+
+export function getConfig(projectRoot: string = process.cwd()): AppConfig {
+  const projectConfigPath = resolve(projectRoot, '.kiro/config.json');
+  const currentFileUrl = import.meta.url;
+  const currentFilePath = fileURLToPath(currentFileUrl);
+  const currentDir = resolve(currentFilePath, '..');
+  const defaultConfigPath = resolve(currentDir, '../config/default-config.json');
+  
+  // デフォルト設定ファイルの更新時刻をチェック
+  let defaultConfigChanged = false;
+  try {
+    if (existsSync(defaultConfigPath)) {
+      const defaultStats = statSync(defaultConfigPath);
+      if (cachedDefaultConfigMtime !== defaultStats.mtimeMs) {
+        defaultConfigChanged = true;
+        cachedDefaultConfigMtime = defaultStats.mtimeMs;
+      }
+    } else {
+      // ファイルが存在しない場合はキャッシュを無効化
+      if (cachedDefaultConfigMtime !== null) {
+        defaultConfigChanged = true;
+        cachedDefaultConfigMtime = null;
+      }
+    }
+  } catch (error) {
+    // ファイルアクセスエラー（削除された場合など）は変更として扱う
+    defaultConfigChanged = true;
+    cachedDefaultConfigMtime = null;
+  }
+  
+  // プロジェクト設定ファイルの更新時刻をチェック
+  let projectConfigChanged = false;
+  try {
+    if (existsSync(projectConfigPath)) {
+      const projectStats = statSync(projectConfigPath);
+      if (cachedConfigMtime !== projectStats.mtimeMs) {
+        projectConfigChanged = true;
+        cachedConfigMtime = projectStats.mtimeMs;
+      }
+    } else {
+      // ファイルが存在しない場合はキャッシュを無効化
+      if (cachedConfigMtime !== null) {
+        projectConfigChanged = true;
+        cachedConfigMtime = null;
+      }
+    }
+  } catch (error) {
+    // ファイルアクセスエラー（削除された場合など）は変更として扱う
+    projectConfigChanged = true;
+    cachedConfigMtime = null;
+  }
+  
+  // キャッシュが有効で、設定ファイルが変更されていない場合はキャッシュを返す
+  if (
+    cachedConfig &&
+    cachedProjectRoot === projectRoot &&
+    !defaultConfigChanged &&
+    !projectConfigChanged
+  ) {
+    return cachedConfig;
+  }
+  
+  // 設定を再読み込み
+  cachedConfig = loadConfig(projectRoot);
+  cachedProjectRoot = projectRoot;
+  
+  return cachedConfig;
+}
+
+/**
+ * 設定キャッシュをクリア（テスト用）
+ */
+export function clearConfigCache(): void {
+  cachedConfig = null;
+  cachedProjectRoot = null;
+  cachedConfigMtime = null;
+  cachedDefaultConfigMtime = null;
+}
+

package/scripts/utils/config-validator.ts

@@ -0,0 +1,347 @@
+/**
+ * 設定ファイルのバリデーション
+ */
+
+import { existsSync, readFileSync } from 'fs';
+import { resolve } from 'path';
+import { AppConfigSchema } from '../config/config-schema.js';
+import type { AppConfig } from '../config/config-schema.js';
+import { getConfig } from './config-loader.js';
+
+/**
+ * バリデーション結果
+ */
+export interface ValidationResult {
+  valid: boolean;
+  errors: string[];
+  warnings: string[];
+  info: string[];
+}
+
+/**
+ * プロジェクト設定ファイルをバリデーション
+ */
+export function validateProjectConfig(projectRoot: string = process.cwd()): ValidationResult {
+  const errors: string[] = [];
+  const warnings: string[] = [];
+  const info: string[] = [];
+  
+  const configPath = resolve(projectRoot, '.kiro/config.json');
+  
+  if (!existsSync(configPath)) {
+    // 設定ファイルが存在しない場合は情報メッセージ（デフォルト設定を使用）
+    info.push('Project config file not found. Using default configuration.');
+    return {
+      valid: true,
+      errors: [],
+      warnings: [],
+      info
+    };
+  }
+  
+  try {
+    const content = readFileSync(configPath, 'utf-8');
+    const parsed = JSON.parse(content);
+    
+    // スキーマでバリデーション
+    const result = AppConfigSchema.safeParse(parsed);
+    
+    if (!result.success) {
+      result.error.errors.forEach(error => {
+        const path = error.path.join('.');
+        errors.push(`${path}: ${error.message}`);
+      });
+      
+      return {
+        valid: false,
+        errors,
+        warnings: [],
+        info: []
+      };
+    }
+    
+    // 追加のバリデーション
+    const config = result.data;
+    
+    // Confluence設定のバリデーション
+    if (config.confluence) {
+      const confluence = config.confluence;
+      
+      // hierarchy設定の整合性チェック
+      if (confluence.pageCreationGranularity === 'by-hierarchy' || confluence.pageCreationGranularity === 'manual') {
+        if (!confluence.hierarchy) {
+          errors.push('confluence.hierarchy is required when pageCreationGranularity is "by-hierarchy" or "manual"');
+        } else {
+          if (confluence.pageCreationGranularity === 'by-hierarchy' && !confluence.hierarchy.parentPageTitle) {
+            warnings.push('confluence.hierarchy.parentPageTitle is recommended for "by-hierarchy" mode');
+          }
+          
+          if (confluence.pageCreationGranularity === 'manual' && !confluence.hierarchy.structure) {
+            errors.push('confluence.hierarchy.structure is required when pageCreationGranularity is "manual"');
+          }
+        }
+      }
+    }
+    
+    // JIRA設定のバリデーション
+    if (config.jira) {
+      const jira = config.jira;
+      
+      if (jira.storyCreationGranularity === 'selected-phases' && !jira.selectedPhases) {
+        errors.push('jira.selectedPhases is required when storyCreationGranularity is "selected-phases"');
+      }
+      
+      if (jira.selectedPhases && jira.selectedPhases.length === 0) {
+        warnings.push('jira.selectedPhases is empty. No stories will be created.');
+      }
+    }
+    
+    // ワークフロー設定のバリデーション
+    if (config.workflow) {
+      const workflow = config.workflow;
+      
+      if (workflow.enabledPhases && workflow.enabledPhases.length === 0) {
+        warnings.push('workflow.enabledPhases is empty. No phases will be executed.');
+      }
+      
+      const validPhases = ['requirements', 'design', 'tasks'];
+      const invalidPhases = workflow.enabledPhases?.filter(phase => !validPhases.includes(phase));
+      if (invalidPhases && invalidPhases.length > 0) {
+        warnings.push(`Unknown phases in workflow.enabledPhases: ${invalidPhases.join(', ')}`);
+      }
+    }
+    
+    return {
+      valid: errors.length === 0,
+      errors,
+      warnings,
+      info: []
+    };
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      errors.push(`Invalid JSON: ${error.message}`);
+    } else {
+      errors.push(`Error reading config file: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+    
+    return {
+      valid: false,
+      errors,
+      warnings: [],
+      info: []
+    };
+  }
+}
+
+/**
+ * 設定ファイルのバリデーションを実行して結果を表示
+ */
+export function validateAndReport(projectRoot: string = process.cwd()): boolean {
+  const result = validateProjectConfig(projectRoot);
+  
+  if (result.info.length > 0) {
+    console.log('ℹ️  Info:');
+    result.info.forEach(message => {
+      console.log(`   - ${message}`);
+    });
+  }
+  
+  if (result.warnings.length > 0) {
+    console.log('⚠️  Warnings:');
+    result.warnings.forEach(warning => {
+      console.log(`   - ${warning}`);
+    });
+  }
+  
+  if (result.errors.length > 0) {
+    console.error('❌ Validation errors:');
+    result.errors.forEach(error => {
+      console.error(`   - ${error}`);
+    });
+    return false;
+  }
+  
+  if (result.valid) {
+    console.log('✅ Configuration is valid');
+  }
+  
+  return result.valid;
+}
+
+/**
+ * Confluence同期実行前の必須設定値チェック
+ * @param docType ドキュメントタイプ（requirements, design, tasks）
+ * @param projectRoot プロジェクトルート（デフォルト: process.cwd()）
+ * @returns バリデーション結果
+ */
+export function validateForConfluenceSync(
+  docType: 'requirements' | 'design' | 'tasks',
+  projectRoot: string = process.cwd()
+): ValidationResult {
+  const errors: string[] = [];
+  const warnings: string[] = [];
+  const info: string[] = [];
+  
+  const config = getConfig(projectRoot);
+  const configPath = resolve(projectRoot, '.kiro/config.json');
+  
+  // Confluence設定のチェック
+  if (!config.confluence) {
+    warnings.push('confluence設定がありません。デフォルト設定を使用します。');
+  } else {
+    const confluence = config.confluence;
+    
+    // spaces設定のチェック
+    if (!confluence.spaces || !confluence.spaces[docType]) {
+      if (!process.env.CONFLUENCE_PRD_SPACE) {
+        warnings.push(
+          `confluence.spaces.${docType}が設定されていません。` +
+          `環境変数CONFLUENCE_PRD_SPACEも設定されていないため、デフォルト値（PRD）を使用します。` +
+          `\n  推奨: .kiro/config.jsonに以下を追加してください:\n` +
+          `  {\n` +
+          `    "confluence": {\n` +
+          `      "spaces": {\n` +
+          `        "${docType}": "YOUR_SPACE_KEY"\n` +
+          `      }\n` +
+          `    }\n` +
+          `  }`
+        );
+      } else {
+        info.push(`confluence.spaces.${docType}が設定されていませんが、環境変数CONFLUENCE_PRD_SPACE（${process.env.CONFLUENCE_PRD_SPACE}）を使用します。`);
+      }
+    }
+    
+    // hierarchy設定のチェック（by-hierarchyモードの場合）
+    if (confluence.pageCreationGranularity === 'by-hierarchy' || confluence.pageCreationGranularity === 'manual') {
+      if (!confluence.hierarchy) {
+        errors.push(
+          `confluence.hierarchyが設定されていません。` +
+          `pageCreationGranularityが"${confluence.pageCreationGranularity}"の場合、hierarchy設定が必須です。` +
+          `\n  解決方法: .kiro/config.jsonに以下を追加してください:\n` +
+          `  {\n` +
+          `    "confluence": {\n` +
+          `      "hierarchy": {\n` +
+          `        "mode": "simple",\n` +
+          `        "parentPageTitle": "[{projectName}] {featureName}"\n` +
+          `      }\n` +
+          `    }\n` +
+          `  }`
+        );
+      } else if (confluence.pageCreationGranularity === 'by-hierarchy' && confluence.hierarchy && !confluence.hierarchy.parentPageTitle) {
+        warnings.push(
+          `confluence.hierarchy.parentPageTitleが設定されていません。` +
+          `by-hierarchyモードでは推奨されます。`
+        );
+      }
+      
+      if (confluence.pageCreationGranularity === 'manual' && confluence.hierarchy && !confluence.hierarchy.structure) {
+        errors.push(
+          `confluence.hierarchy.structureが設定されていません。` +
+          `pageCreationGranularityが"manual"の場合、structure設定が必須です。`
+        );
+      }
+    }
+  }
+  
+  return {
+    valid: errors.length === 0,
+    errors,
+    warnings,
+    info
+  };
+}
+
+/**
+ * JIRA同期実行前の必須設定値チェック
+ * @param projectRoot プロジェクトルート（デフォルト: process.cwd()）
+ * @returns バリデーション結果
+ */
+export function validateForJiraSync(projectRoot: string = process.cwd()): ValidationResult {
+  const errors: string[] = [];
+  const warnings: string[] = [];
+  const info: string[] = [];
+  
+  const config = getConfig(projectRoot);
+  const configPath = resolve(projectRoot, '.kiro/config.json');
+  
+  // JIRA設定のチェック
+  if (!config.jira) {
+    warnings.push('jira設定がありません。デフォルト設定を使用します。');
+  } else {
+    const jira = config.jira;
+    
+    // issueTypes設定のチェック
+    if (!jira.issueTypes) {
+      if (!process.env.JIRA_ISSUE_TYPE_STORY) {
+        errors.push(
+          `jira.issueTypes.storyが設定されていません。` +
+          `環境変数JIRA_ISSUE_TYPE_STORYも設定されていないため、JIRA同期を実行できません。` +
+          `\n  解決方法1: 環境変数を設定:\n` +
+          `  export JIRA_ISSUE_TYPE_STORY=10036  # JIRAインスタンス固有のID\n` +
+          `\n  解決方法2: .kiro/config.jsonに以下を追加:\n` +
+          `  {\n` +
+          `    "jira": {\n` +
+          `      "issueTypes": {\n` +
+          `        "story": "10036",\n` +
+          `        "subtask": "10037"\n` +
+          `      }\n` +
+          `    }\n` +
+          `  }` +
+          `\n  確認方法: JIRA管理画面（Settings > Issues > Issue types）またはREST API: GET /rest/api/3/issuetype`
+        );
+      } else {
+        info.push(`jira.issueTypes.storyが設定されていませんが、環境変数JIRA_ISSUE_TYPE_STORY（${process.env.JIRA_ISSUE_TYPE_STORY}）を使用します。`);
+      }
+    } else {
+      if (!jira.issueTypes.story) {
+        if (!process.env.JIRA_ISSUE_TYPE_STORY) {
+          errors.push(
+            `jira.issueTypes.storyが設定されていません。` +
+            `環境変数JIRA_ISSUE_TYPE_STORYも設定されていないため、JIRA同期を実行できません。` +
+            `\n  解決方法: .kiro/config.jsonのjira.issueTypes.storyに値を設定するか、` +
+            `環境変数JIRA_ISSUE_TYPE_STORYを設定してください。`
+          );
+        } else {
+          info.push(`jira.issueTypes.storyが設定されていませんが、環境変数JIRA_ISSUE_TYPE_STORY（${process.env.JIRA_ISSUE_TYPE_STORY}）を使用します。`);
+        }
+      }
+      
+      if (!jira.issueTypes.subtask) {
+        if (!process.env.JIRA_ISSUE_TYPE_SUBTASK) {
+          warnings.push(
+            `jira.issueTypes.subtaskが設定されていません。` +
+            `環境変数JIRA_ISSUE_TYPE_SUBTASKも設定されていないため、サブタスクは作成されません。`
+          );
+        } else {
+          info.push(`jira.issueTypes.subtaskが設定されていませんが、環境変数JIRA_ISSUE_TYPE_SUBTASK（${process.env.JIRA_ISSUE_TYPE_SUBTASK}）を使用します。`);
+        }
+      }
+    }
+    
+    // selectedPhases設定のチェック
+    if (jira.storyCreationGranularity === 'selected-phases' && !jira.selectedPhases) {
+      errors.push(
+        `jira.selectedPhasesが設定されていません。` +
+        `storyCreationGranularityが"selected-phases"の場合、selectedPhases設定が必須です。`
+      );
+    }
+    
+    if (jira.selectedPhases && jira.selectedPhases.length === 0) {
+      warnings.push('jira.selectedPhasesが空です。ストーリーは作成されません。');
+    }
+  }
+  
+  return {
+    valid: errors.length === 0,
+    errors,
+    warnings,
+    info
+  };
+}
+
+// CLI実行
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const valid = validateAndReport();
+  process.exit(valid ? 0 : 1);
+}
+