@sk8metal/michi-cli 0.3.0 → 0.5.0

package/scripts/utils/config-loader.ts

@@ -6,27 +6,53 @@
 import { readFileSync, existsSync, statSync } from 'fs';
 import { resolve, relative, isAbsolute } from 'path';
 import { fileURLToPath } from 'url';
-import { config } from 'dotenv';
+import { homedir } from 'os';
+import { config, parse as dotenvParse } from 'dotenv';
 import { AppConfigSchema, type AppConfig } from '../config/config-schema.js';
 
 // 環境変数読み込み
 config();
 
+/**
+ * グローバル設定ファイルのパス定数
+ */
+const GLOBAL_CONFIG_DIR = '.michi';
+const GLOBAL_CONFIG_FILE = 'config.json';
+
+/**
+ * グローバル設定ファイルのパスを取得
+ */
+export function getGlobalConfigPath(): string {
+  const home = homedir();
+  return resolve(home, GLOBAL_CONFIG_DIR, GLOBAL_CONFIG_FILE);
+}
+
+/**
+ * グローバル.envファイルのパスを取得
+ */
+export function getGlobalEnvPath(): string {
+  const home = process.env.HOME || homedir();
+  return resolve(home, GLOBAL_CONFIG_DIR, '.env');
+}
+
 /**
  * 深いマージ（Deep Merge）
  * オブジェクトを再帰的にマージする
  */
-function deepMerge<T extends Record<string, any>>(target: T, source: Partial<T>): T {
+function deepMerge<T extends Record<string, unknown>>(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>]>);
+      result[key] = deepMerge(
+        (result[key] || {}) as Record<string, unknown>,
+        source[key] as Record<string, unknown>
+      ) as T[Extract<keyof T, string>];
     } else if (source[key] !== undefined) {
       result[key] = source[key] as T[Extract<keyof T, string>];
     }
   }
-  
+
   return result;
 }
 
@@ -60,7 +86,7 @@ function expandEnvVars(str: string): string {
  * 設定オブジェクト内の文字列値を環境変数で展開
  * 循環参照を防ぐため、処理済みオブジェクトを追跡
  */
-function expandEnvVarsInConfig(config: any, visited: WeakSet<object> = new WeakSet()): any {
+function expandEnvVarsInConfig(config: unknown, visited: WeakSet<object> = new WeakSet()): unknown {
   if (typeof config === 'string') {
     return expandEnvVars(config);
   }
@@ -77,9 +103,9 @@ function expandEnvVarsInConfig(config: any, visited: WeakSet<object> = new WeakS
     }
     
     visited.add(config);
-    const result: any = {};
-    for (const key in config) {
-      result[key] = expandEnvVarsInConfig(config[key], visited);
+    const result: Record<string, unknown> = {};
+    for (const key in config as Record<string, unknown>) {
+      result[key] = expandEnvVarsInConfig((config as Record<string, unknown>)[key], visited);
     }
     visited.delete(config);
     return result;
@@ -113,7 +139,8 @@ function loadDefaultConfig(): AppConfig {
     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}`);
+      // SyntaxErrorには標準的なlineやcolumnプロパティはないため、messageのみ使用
+      throw new Error(`Invalid JSON in default config file ${defaultConfigPath}: ${error.message}`);
     }
     if (error instanceof Error && error.name === 'ZodError') {
       throw new Error(`Default config validation failed: ${error.message}\nFile: ${defaultConfigPath}`);
@@ -166,23 +193,23 @@ function resolveConfigPath(projectRoot: string): string {
  */
 function loadProjectConfig(projectRoot: string = process.cwd()): Partial<AppConfig> | null {
   const projectConfigPath = resolveConfigPath(projectRoot);
-  
+
   // パストラバーサル対策: パスを検証
   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>;
@@ -198,62 +225,199 @@ function loadProjectConfig(projectRoot: string = process.cwd()): Partial<AppConf
 }
 
 /**
- * 設定を読み込んでマージ
- * 
- * マージ順序:
- * 1. デフォルト設定
- * 2. プロジェクト固有設定（上書き）
- * 3. 環境変数（最終上書き、既存の動作を維持）
+ * グローバル設定を読み込む
  */
-export function loadConfig(projectRoot: string = process.cwd()): AppConfig {
-  // デフォルト設定を読み込み
-  const defaultConfig = loadDefaultConfig();
-  
-  // プロジェクト固有設定を読み込み
-  const projectConfig = loadProjectConfig(projectRoot);
-  
-  // マージ（プロジェクト設定がデフォルトを上書き）
-  const 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;
+function loadGlobalConfig(): Partial<AppConfig> | null {
+  const globalConfigPath = getGlobalConfigPath();
+
+  if (!existsSync(globalConfigPath)) {
+    return null;
+  }
+
+  try {
+    const content = readFileSync(globalConfigPath, 'utf-8');
+    const parsed = JSON.parse(content);
+
+    // 環境変数を展開
+    const expanded = expandEnvVarsInConfig(parsed);
+
+    return expanded as Partial<AppConfig>;
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      console.warn(`⚠️  Invalid JSON in global config ${globalConfigPath}: ${error.message}`);
+    } else {
+      console.warn(`⚠️  Failed to load global config: ${error instanceof Error ? error.message : 'Unknown error'}`);
     }
-    if (!mergedConfig.confluence.spaces.tasks) {
-      mergedConfig.confluence.spaces.tasks = process.env.CONFLUENCE_PRD_SPACE;
+    return null;
+  }
+}
+
+/**
+ * グローバル.envを読み込み
+ * ~/.michi/.env から組織共通の環境変数を読み込む
+ */
+function loadGlobalEnv(): Record<string, string> {
+  const globalEnvPath = getGlobalEnvPath();
+
+  if (!existsSync(globalEnvPath)) {
+    return {};
+  }
+
+  try {
+    const content = readFileSync(globalEnvPath, 'utf-8');
+    return dotenvParse(content);
+  } catch (error) {
+    console.warn(`⚠️  Failed to load global env from ${globalEnvPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    return {};
+  }
+}
+
+/**
+ * プロジェクト.envを読み込み
+ * .env からプロジェクト固有の環境変数を読み込む
+ */
+function loadProjectEnv(projectRoot: string): Record<string, string> {
+  const projectEnvPath = resolve(projectRoot, '.env');
+
+  if (!existsSync(projectEnvPath)) {
+    return {};
+  }
+
+  try {
+    const content = readFileSync(projectEnvPath, 'utf-8');
+    return dotenvParse(content);
+  } catch (error) {
+    console.warn(`⚠️  Failed to load project env from ${projectEnvPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    return {};
+  }
+}
+
+/**
+ * プロジェクトメタデータを読み込み
+ * .kiro/project.json からプロジェクト情報を読み込む
+ */
+function loadProjectMetadata(projectRoot: string): Partial<AppConfig> | null {
+  const projectJsonPath = resolve(projectRoot, '.kiro/project.json');
+
+  if (!existsSync(projectJsonPath)) {
+    return null;
+  }
+
+  try {
+    const content = readFileSync(projectJsonPath, 'utf-8');
+    const meta = JSON.parse(content);
+
+    // project フィールドとして返す
+    return { project: meta } as Partial<AppConfig>;
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      console.warn(`⚠️  Invalid JSON in ${projectJsonPath}: ${error.message}`);
+    } else {
+      console.warn(`⚠️  Failed to load project metadata from ${projectJsonPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
     }
+    return null;
   }
-  
-  // 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;
+}
+
+/**
+ * 環境変数から設定へのマッピング
+ */
+const ENV_TO_CONFIG_MAPPING: Record<string, string> = {
+  'ATLASSIAN_URL': 'atlassian.url',
+  'ATLASSIAN_EMAIL': 'atlassian.email',
+  'ATLASSIAN_API_TOKEN': 'atlassian.apiToken',
+  'GITHUB_ORG': 'github.org',
+  'GITHUB_TOKEN': 'github.token',
+  'CONFLUENCE_PRD_SPACE': 'confluence.spaces.requirements',
+  'CONFLUENCE_QA_SPACE': 'confluence.spaces.qa',
+  'CONFLUENCE_RELEASE_SPACE': 'confluence.spaces.release',
+  'JIRA_ISSUE_TYPE_STORY': 'jira.issueTypes.story',
+  'JIRA_ISSUE_TYPE_SUBTASK': 'jira.issueTypes.subtask',
+  'JIRA_PROJECT_KEYS': 'jira.projectKeys',
+};
+
+/**
+ * ドットパスでオブジェクトの値を設定
+ * 例: setValueByPath(obj, 'a.b.c', value) => obj.a.b.c = value
+ */
+function setValueByPath(obj: Record<string, unknown>, path: string, value: string): void {
+  const keys = path.split('.');
+  let current: Record<string, unknown> = obj;
+
+  for (let i = 0; i < keys.length - 1; i++) {
+    const key = keys[i];
+    if (!current[key] || typeof current[key] !== 'object') {
+      current[key] = {};
     }
-    if (process.env.JIRA_ISSUE_TYPE_SUBTASK) {
-      mergedConfig.jira.issueTypes.subtask = process.env.JIRA_ISSUE_TYPE_SUBTASK;
+    current = current[key] as Record<string, unknown>;
+  }
+
+  current[keys[keys.length - 1]] = value;
+}
+
+/**
+ * 環境変数を設定オブジェクトに適用
+ */
+function applyEnvVarsToConfig(
+  config: AppConfig,
+  envVars: Record<string, string>
+): AppConfig {
+  const result = { ...config } as Record<string, unknown>;
+
+  for (const [envKey, configPath] of Object.entries(ENV_TO_CONFIG_MAPPING)) {
+    if (envVars[envKey]) {
+      setValueByPath(result, configPath, envVars[envKey]);
     }
   }
-  
+
+  return result as AppConfig;
+}
+
+/**
+ * 設定を読み込んでマージ
+ *
+ * マージ順序（優先度: 低 → 高）:
+ * 1. デフォルト設定
+ * 2. グローバル.env（~/.michi/.env）
+ * 3. グローバル設定（~/.michi/config.json）
+ * 4. プロジェクトメタデータ（.kiro/project.json）
+ * 5. プロジェクト設定（.michi/config.json）
+ * 6. プロジェクト.env（.env）- 最高優先度
+ */
+export function loadConfig(projectRoot: string = process.cwd()): AppConfig {
+  // 1. デフォルト設定を読み込み（最低優先度）
+  let mergedConfig: AppConfig = loadDefaultConfig();
+
+  // 2. グローバル.envを読み込み
+  const globalEnvVars = loadGlobalEnv();
+  if (Object.keys(globalEnvVars).length > 0) {
+    mergedConfig = applyEnvVarsToConfig(mergedConfig, globalEnvVars);
+  }
+
+  // 3. グローバル設定を読み込み
+  const globalConfig = loadGlobalConfig();
+  if (globalConfig) {
+    mergedConfig = deepMerge(mergedConfig, globalConfig);
+  }
+
+  // 4. プロジェクトメタデータを読み込み
+  const projectMeta = loadProjectMetadata(projectRoot);
+  if (projectMeta) {
+    mergedConfig = deepMerge(mergedConfig, projectMeta);
+  }
+
+  // 5. プロジェクト固有設定を読み込み
+  const projectConfig = loadProjectConfig(projectRoot);
+  if (projectConfig) {
+    mergedConfig = deepMerge(mergedConfig, projectConfig);
+  }
+
+  // 6. プロジェクト.envを読み込み（最高優先度）
+  const projectEnvVars = loadProjectEnv(projectRoot);
+  if (Object.keys(projectEnvVars).length > 0) {
+    mergedConfig = applyEnvVarsToConfig(mergedConfig, projectEnvVars);
+  }
+
   // スキーマで最終バリデーション
   return AppConfigSchema.parse(mergedConfig);
 }
@@ -266,14 +430,22 @@ let cachedConfig: AppConfig | null = null;
 let cachedProjectRoot: string | null = null;
 let cachedConfigMtime: number | null = null;
 let cachedDefaultConfigMtime: number | null = null;
+let cachedGlobalConfigMtime: number | null = null;
+let cachedGlobalEnvMtime: number | null = null;
+let cachedProjectMetaMtime: number | null = null;
+let cachedProjectEnvMtime: number | null = null;
 
 export function getConfig(projectRoot: string = process.cwd()): AppConfig {
   const projectConfigPath = resolveConfigPath(projectRoot);
+  const globalConfigPath = getGlobalConfigPath();
+  const globalEnvPath = getGlobalEnvPath();
+  const projectMetaPath = resolve(projectRoot, '.kiro/project.json');
+  const projectEnvPath = resolve(projectRoot, '.env');
   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 {
@@ -295,7 +467,27 @@ export function getConfig(projectRoot: string = process.cwd()): AppConfig {
     defaultConfigChanged = true;
     cachedDefaultConfigMtime = null;
   }
-  
+
+  // グローバル設定ファイルの更新時刻をチェック
+  let globalConfigChanged = false;
+  try {
+    if (existsSync(globalConfigPath)) {
+      const globalStats = statSync(globalConfigPath);
+      if (cachedGlobalConfigMtime !== globalStats.mtimeMs) {
+        globalConfigChanged = true;
+        cachedGlobalConfigMtime = globalStats.mtimeMs;
+      }
+    } else {
+      if (cachedGlobalConfigMtime !== null) {
+        globalConfigChanged = true;
+        cachedGlobalConfigMtime = null;
+      }
+    }
+  } catch {
+    globalConfigChanged = true;
+    cachedGlobalConfigMtime = null;
+  }
+
   // プロジェクト設定ファイルの更新時刻をチェック
   let projectConfigChanged = false;
   try {
@@ -317,13 +509,77 @@ export function getConfig(projectRoot: string = process.cwd()): AppConfig {
     projectConfigChanged = true;
     cachedConfigMtime = null;
   }
-  
+
+  // グローバル.envファイルの更新時刻をチェック
+  let globalEnvChanged = false;
+  try {
+    if (existsSync(globalEnvPath)) {
+      const globalEnvStats = statSync(globalEnvPath);
+      if (cachedGlobalEnvMtime !== globalEnvStats.mtimeMs) {
+        globalEnvChanged = true;
+        cachedGlobalEnvMtime = globalEnvStats.mtimeMs;
+      }
+    } else {
+      if (cachedGlobalEnvMtime !== null) {
+        globalEnvChanged = true;
+        cachedGlobalEnvMtime = null;
+      }
+    }
+  } catch {
+    globalEnvChanged = true;
+    cachedGlobalEnvMtime = null;
+  }
+
+  // プロジェクトメタデータファイルの更新時刻をチェック
+  let projectMetaChanged = false;
+  try {
+    if (existsSync(projectMetaPath)) {
+      const projectMetaStats = statSync(projectMetaPath);
+      if (cachedProjectMetaMtime !== projectMetaStats.mtimeMs) {
+        projectMetaChanged = true;
+        cachedProjectMetaMtime = projectMetaStats.mtimeMs;
+      }
+    } else {
+      if (cachedProjectMetaMtime !== null) {
+        projectMetaChanged = true;
+        cachedProjectMetaMtime = null;
+      }
+    }
+  } catch {
+    projectMetaChanged = true;
+    cachedProjectMetaMtime = null;
+  }
+
+  // プロジェクト.envファイルの更新時刻をチェック
+  let projectEnvChanged = false;
+  try {
+    if (existsSync(projectEnvPath)) {
+      const projectEnvStats = statSync(projectEnvPath);
+      if (cachedProjectEnvMtime !== projectEnvStats.mtimeMs) {
+        projectEnvChanged = true;
+        cachedProjectEnvMtime = projectEnvStats.mtimeMs;
+      }
+    } else {
+      if (cachedProjectEnvMtime !== null) {
+        projectEnvChanged = true;
+        cachedProjectEnvMtime = null;
+      }
+    }
+  } catch {
+    projectEnvChanged = true;
+    cachedProjectEnvMtime = null;
+  }
+
   // キャッシュが有効で、設定ファイルが変更されていない場合はキャッシュを返す
   if (
     cachedConfig &&
     cachedProjectRoot === projectRoot &&
     !defaultConfigChanged &&
-    !projectConfigChanged
+    !globalConfigChanged &&
+    !globalEnvChanged &&
+    !projectConfigChanged &&
+    !projectMetaChanged &&
+    !projectEnvChanged
   ) {
     return cachedConfig;
   }
@@ -343,6 +599,10 @@ export function clearConfigCache(): void {
   cachedProjectRoot = null;
   cachedConfigMtime = null;
   cachedDefaultConfigMtime = null;
+  cachedGlobalConfigMtime = null;
+  cachedGlobalEnvMtime = null;
+  cachedProjectMetaMtime = null;
+  cachedProjectEnvMtime = null;
 }
 
 /**