@sk8metal/michi-cli 0.0.3 → 0.0.5

package/scripts/jira-sync.ts

@@ -23,7 +23,7 @@ import axios from 'axios';
 import { config } from 'dotenv';
 import { loadProjectMeta } from './utils/project-meta.js';
 import { validateFeatureNameOrThrow } from './utils/feature-name-validator.js';
-import { getConfig } from './utils/config-loader.js';
+import { getConfig, getConfigPath } from './utils/config-loader.js';
 import { validateForJiraSync } from './utils/config-validator.js';
 
 config();
@@ -355,7 +355,7 @@ async function syncTasksToJIRA(featureName: string): Promise<void> {
   if (validation.errors.length > 0) {
     console.error('❌ Configuration errors:');
     validation.errors.forEach(error => console.error(`   ${error}`));
-    const configPath = resolve('.kiro/config.json');
+    const configPath = getConfigPath();
     console.error(`\n設定ファイル: ${configPath}`);
     throw new Error('JIRA同期に必要な設定値が不足しています。上記のエラーを確認して設定を修正してください。');
   }
@@ -370,7 +370,7 @@ async function syncTasksToJIRA(featureName: string): Promise<void> {
   if (!storyIssueTypeId) {
     throw new Error(
       'JIRA Story issue type ID is not configured. ' +
-      'Please set JIRA_ISSUE_TYPE_STORY environment variable or configure it in .kiro/config.json. ' +
+      'Please set JIRA_ISSUE_TYPE_STORY environment variable or configure it in .michi/config.json. ' +
       'You can find the issue type ID in JIRA UI (Settings > Issues > Issue types) or via REST API: ' +
       'GET https://your-domain.atlassian.net/rest/api/3/issuetype'
     );
@@ -600,13 +600,13 @@ async function syncTasksToJIRA(featureName: string): Promise<void> {
       
       // JIRA APIエラーの詳細を表示
       if (error.response?.data) {
-        console.error(`  📋 JIRA API Error Details:`, JSON.stringify(error.response.data, null, 2));
+        console.error('  📋 JIRA API Error Details:', JSON.stringify(error.response.data, null, 2));
         
         // Story Pointsフィールドのエラーの場合、警告を表示
         if (error.response.data.errors && Object.keys(error.response.data.errors).some(key => key.includes('customfield'))) {
-          console.error(`  ⚠️  Story Pointsフィールドの設定に失敗しました。`);
-          console.error(`  💡 環境変数 JIRA_STORY_POINTS_FIELD を正しいカスタムフィールドIDに設定してください。`);
-          console.error(`  💡 JIRA管理画面でStory PointsのカスタムフィールドIDを確認してください。`);
+          console.error('  ⚠️  Story Pointsフィールドの設定に失敗しました。');
+          console.error('  💡 環境変数 JIRA_STORY_POINTS_FIELD を正しいカスタムフィールドIDに設定してください。');
+          console.error('  💡 JIRA管理画面でStory PointsのカスタムフィールドIDを確認してください。');
         }
       }
       
@@ -618,7 +618,7 @@ async function syncTasksToJIRA(featureName: string): Promise<void> {
   const newStoryCount = createdStories.filter(key => !existingStoryKeys.has(key)).length;
   const reusedStoryCount = createdStories.filter(key => existingStoryKeys.has(key)).length;
   
-  console.log(`\n✅ JIRA sync completed`);
+  console.log('\n✅ JIRA sync completed');
   console.log(`   Epic: ${epic.key}`);
   console.log(`   Stories: ${createdStories.length} processed (${newStoryCount} new, ${reusedStoryCount} reused)`);
 }

package/scripts/markdown-to-confluence.ts

@@ -93,7 +93,7 @@ function decodeHtmlEntities(text: string): string {
     '>': '>',
     '&': '&',
     '"': '"',
-    ''': "'",
+    ''': '\'',
     ' ': ' '
   };
   

package/scripts/multi-project-estimate.ts

@@ -153,7 +153,7 @@ function parseEstimateFromContent(content: string, featureName: string): Estimat
     
     return estimate;
   } catch (error) {
-    console.warn(`  ⚠️  Failed to parse estimate:`, error instanceof Error ? error.message : error);
+    console.warn('  ⚠️  Failed to parse estimate:', error instanceof Error ? error.message : error);
     return null;
   } finally {
     // 一時ファイルをクリーンアップ

package/scripts/phase-runner.ts

@@ -256,14 +256,14 @@ export async function runPhase(feature: string, phase: Phase): Promise<PhaseRunR
   validateFeatureNameOrThrow(feature);
   
   switch (phase) {
-    case 'requirements':
-      return await runRequirementsPhase(feature);
-    case 'design':
-      return await runDesignPhase(feature);
-    case 'tasks':
-      return await runTasksPhase(feature);
-    default:
-      throw new Error(`Unknown phase: ${phase}`);
+  case 'requirements':
+    return await runRequirementsPhase(feature);
+  case 'design':
+    return await runDesignPhase(feature);
+  case 'tasks':
+    return await runTasksPhase(feature);
+  default:
+    throw new Error(`Unknown phase: ${phase}`);
   }
 }
 

package/scripts/pre-flight-check.ts

@@ -178,7 +178,7 @@ async function checkJiraProject(projectKey: string): Promise<{ errors: string[],
       errors.push(`      現在の設定: "${projectKey}" → 実際に存在するキーに変更`);
     } else if (error.response?.status === 401) {
       errors.push('❌ JIRA認証エラー（.envの認証情報を確認）');
-      errors.push(`   → API Token管理: https://id.atlassian.com/manage-profile/security/api-tokens`);
+      errors.push('   → API Token管理: https://id.atlassian.com/manage-profile/security/api-tokens');
     } else {
       warnings.push(`⚠️  JIRAプロジェクトチェック失敗: ${error.message}`);
     }

package/scripts/setup-existing-project.ts

@@ -30,15 +30,15 @@ function parseArgs(): SetupConfig {
     const value = args[i + 1];
     
     switch (key) {
-      case 'michi-path':
-        config.michiPath = value;
-        break;
-      case 'project-name':
-        config.projectName = value;
-        break;
-      case 'jira-key':
-        config.jiraKey = value;
-        break;
+    case 'michi-path':
+      config.michiPath = value;
+      break;
+    case 'project-name':
+      config.projectName = value;
+      break;
+    case 'jira-key':
+      config.jiraKey = value;
+      break;
     }
   }
   

package/scripts/setup-existing.sh

@@ -30,7 +30,7 @@ echo ""
 echo -e "${YELLOW}プロジェクト情報を入力してください:${NC}"
 echo ""
 
-read -p "プロジェクト名（例: A社 サービス1）: " PROJECT_NAME
+read -p "プロジェクト名（例: プロジェクトA）: " PROJECT_NAME
 read -p "JIRAプロジェクトキー（例: PRJA）: " JIRA_KEY
 
 # 入力値の検証

package/scripts/utils/__tests__/config-loader.test.ts

@@ -0,0 +1,254 @@
+/**
+ * config-loader.ts のユニットテスト
+ */
+
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { existsSync, writeFileSync, unlinkSync, mkdirSync, rmSync } from 'fs';
+import { resolve, join } from 'path';
+import { tmpdir } from 'os';
+import {
+  loadConfig,
+  getConfig,
+  getConfigPath,
+  clearConfigCache
+} from '../config-loader.js';
+
+describe('config-loader', () => {
+  let testProjectRoot: string;
+  let originalEnv: NodeJS.ProcessEnv;
+
+  beforeEach(() => {
+    // テスト用の一時ディレクトリを作成（ランダム要素を追加して衝突を防ぐ）
+    testProjectRoot = resolve(tmpdir(), `michi-test-${Date.now()}-${Math.random().toString(36).substring(7)}`);
+
+    // 既存のディレクトリがあれば削除
+    if (existsSync(testProjectRoot)) {
+      rmSync(testProjectRoot, { recursive: true, force: true });
+    }
+
+    mkdirSync(testProjectRoot, { recursive: true });
+    mkdirSync(join(testProjectRoot, '.michi'), { recursive: true });
+
+    // 環境変数をバックアップ
+    originalEnv = { ...process.env };
+
+    // キャッシュをクリア（クリーンな状態から開始）
+    clearConfigCache();
+  });
+
+  afterEach(() => {
+    // 環境変数を復元
+    process.env = originalEnv;
+
+    // テスト用ディレクトリを削除
+    if (existsSync(testProjectRoot)) {
+      // ファイルを削除
+      const configPath = join(testProjectRoot, '.michi/config.json');
+      if (existsSync(configPath)) {
+        unlinkSync(configPath);
+      }
+      // ディレクトリを削除
+      try {
+        rmSync(testProjectRoot, { recursive: true, force: true });
+      } catch (e) {
+        // 削除失敗は無視
+      }
+    }
+
+    // キャッシュをクリア（ディレクトリ削除後に実行）
+    clearConfigCache();
+  });
+
+  describe('getConfigPath', () => {
+    it('.michi/config.jsonのパスを返す', () => {
+      clearConfigCache();
+      const configPath = getConfigPath(testProjectRoot);
+      expect(configPath).toBe(join(testProjectRoot, '.michi/config.json'));
+    });
+
+    it('設定ファイルが存在しない場合でも.michi/config.jsonのパスを返す', () => {
+      clearConfigCache();
+      const configPath = getConfigPath(testProjectRoot);
+      expect(configPath).toBe(join(testProjectRoot, '.michi/config.json'));
+      expect(existsSync(configPath)).toBe(false);
+    });
+  });
+
+  describe('loadConfig', () => {
+    it('設定ファイルが存在しない場合はデフォルト設定を返す', () => {
+      clearConfigCache();
+      const config = loadConfig(testProjectRoot);
+
+      expect(config).toBeDefined();
+      expect(config.confluence).toBeDefined();
+      expect(config.confluence?.pageCreationGranularity).toBe('single');
+    });
+
+    it('設定ファイルが存在する場合はマージされた設定を返す', () => {
+      clearConfigCache();
+      const configPath = join(testProjectRoot, '.michi/config.json');
+      writeFileSync(configPath, JSON.stringify({
+        confluence: {
+          pageCreationGranularity: 'by-hierarchy',
+          spaces: {
+            requirements: 'TestSpace'
+          }
+        }
+      }));
+
+      const config = loadConfig(testProjectRoot);
+
+      expect(config.confluence?.pageCreationGranularity).toBe('by-hierarchy');
+      expect(config.confluence?.spaces?.requirements).toBe('TestSpace');
+    });
+
+    it('無効なJSONの場合はエラーをスロー', () => {
+      clearConfigCache(); // キャッシュをクリア
+      const configPath = join(testProjectRoot, '.michi/config.json');
+      writeFileSync(configPath, '{ invalid json }');
+
+      expect(() => {
+        loadConfig(testProjectRoot);
+      }).toThrow(/Invalid JSON/);
+
+      // テスト後にファイルを削除して次のテストへの影響を防ぐ
+      if (existsSync(configPath)) {
+        unlinkSync(configPath);
+      }
+    });
+  });
+
+  describe('getConfig (キャッシュ付き)', () => {
+    // キャッシュテストでは、beforeEachでキャッシュをクリアしない
+    // 代わりに、各テストの最後にキャッシュをクリアする
+
+    it('設定ファイルが存在しない場合はデフォルト設定を返す', () => {
+      clearConfigCache(); // テスト開始時にクリア
+      const config = getConfig(testProjectRoot);
+
+      expect(config).toBeDefined();
+      expect(config.confluence).toBeDefined();
+    });
+
+    it('同じ設定ファイルを2回読み込む場合はキャッシュが使用される', () => {
+      clearConfigCache(); // テスト開始時にクリア
+
+      // .kiro/が存在しないことを確認（legacy警告を防ぐ）
+      const legacyDir = join(testProjectRoot, '.kiro');
+      if (existsSync(legacyDir)) {
+        rmSync(legacyDir, { recursive: true, force: true });
+      }
+
+      const configPath = join(testProjectRoot, '.michi/config.json');
+      writeFileSync(configPath, JSON.stringify({
+        confluence: {
+          pageCreationGranularity: 'by-hierarchy'
+        }
+      }));
+
+      const config1 = getConfig(testProjectRoot);
+      const config2 = getConfig(testProjectRoot);
+
+      // 同じオブジェクト参照であることを確認（キャッシュが使用されている）
+      expect(config1).toBe(config2);
+    });
+
+    it('設定ファイルを変更するとキャッシュが無効化される', async () => {
+      clearConfigCache(); // テスト開始時にクリア
+
+      // .michiディレクトリが存在することを確認（前のテストで削除されている可能性）
+      const michiDir = join(testProjectRoot, '.michi');
+      if (!existsSync(michiDir)) {
+        mkdirSync(michiDir, { recursive: true });
+      }
+
+      const configPath = join(testProjectRoot, '.michi/config.json');
+      writeFileSync(configPath, JSON.stringify({
+        confluence: {
+          pageCreationGranularity: 'single'
+        }
+      }));
+
+      const config1 = getConfig(testProjectRoot);
+      expect(config1.confluence?.pageCreationGranularity).toBe('single');
+
+      // ファイルシステムのmtime精度を考慮して少し待つ
+      await new Promise(resolve => setTimeout(resolve, 10));
+
+      // 設定ファイルを更新（ディレクトリが削除されている可能性があるため再確認）
+      if (!existsSync(michiDir)) {
+        mkdirSync(michiDir, { recursive: true });
+      }
+
+      writeFileSync(configPath, JSON.stringify({
+        confluence: {
+          pageCreationGranularity: 'by-hierarchy'
+        }
+      }));
+
+      const config2 = getConfig(testProjectRoot);
+      expect(config2.confluence?.pageCreationGranularity).toBe('by-hierarchy');
+    });
+  });
+
+  describe('警告メッセージ', () => {
+    it('legacyパス（.kiro/config.json）が存在する場合は警告を表示', () => {
+      // .michi/config.jsonが存在しないことを確認（警告が表示される条件）
+      const michiConfigPath = join(testProjectRoot, '.michi/config.json');
+      const michiDir = join(testProjectRoot, '.michi');
+
+      // .michi/config.jsonとディレクトリを削除
+      if (existsSync(michiConfigPath)) {
+        unlinkSync(michiConfigPath);
+      }
+      if (existsSync(michiDir)) {
+        rmSync(michiDir, { recursive: true, force: true });
+      }
+
+      // legacyパスにファイルを作成
+      mkdirSync(join(testProjectRoot, '.kiro'), { recursive: true });
+      const legacyConfigPath = join(testProjectRoot, '.kiro/config.json');
+      writeFileSync(legacyConfigPath, JSON.stringify({
+        confluence: {
+          pageCreationGranularity: 'single'
+        }
+      }));
+
+      // 警告が表示されることを確認（console.warnをモック）
+      const consoleWarnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
+
+      // loadConfigを呼ぶことでresolveConfigPathが実行され、警告が表示される
+      loadConfig(testProjectRoot);
+
+      expect(consoleWarnSpy).toHaveBeenCalled();
+      expect(consoleWarnSpy.mock.calls[0][0]).toContain('Deprecated');
+      expect(consoleWarnSpy.mock.calls[0][0]).toContain('.kiro/config.json');
+
+      consoleWarnSpy.mockRestore();
+
+      // 次のテストのために.michiディレクトリを再作成
+      mkdirSync(michiDir, { recursive: true });
+    });
+
+    it('legacyパスと新規パスの両方が存在する場合は警告を表示しない', () => {
+      // 両方のパスにファイルを作成
+      mkdirSync(join(testProjectRoot, '.kiro'), { recursive: true });
+      const legacyConfigPath = join(testProjectRoot, '.kiro/config.json');
+      const michiConfigPath = join(testProjectRoot, '.michi/config.json');
+      writeFileSync(legacyConfigPath, JSON.stringify({}));
+      writeFileSync(michiConfigPath, JSON.stringify({}));
+
+      // 警告が表示されないことを確認
+      const consoleWarnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
+
+      // loadConfigを呼ぶことでresolveConfigPathが実行される
+      loadConfig(testProjectRoot);
+
+      // 警告は表示されない（新規パスが存在するため）
+      expect(consoleWarnSpy).not.toHaveBeenCalled();
+
+      consoleWarnSpy.mockRestore();
+    });
+  });
+});
+

package/scripts/utils/__tests__/config-validator.test.ts

@@ -12,6 +12,7 @@ import {
   validateForJiraSync,
   validateAndReport
 } from '../config-validator.js';
+import { clearConfigCache } from '../config-loader.js';
 
 describe('config-validator', () => {
   let testProjectRoot: string;
@@ -21,10 +22,13 @@ describe('config-validator', () => {
     // テスト用の一時ディレクトリを作成
     testProjectRoot = resolve(tmpdir(), `michi-test-${Date.now()}`);
     mkdirSync(testProjectRoot, { recursive: true });
-    mkdirSync(join(testProjectRoot, '.kiro'), { recursive: true });
+    mkdirSync(join(testProjectRoot, '.michi'), { recursive: true });
 
     // 環境変数をバックアップ
     originalEnv = { ...process.env };
+    
+    // キャッシュをクリア
+    clearConfigCache();
   });
 
   afterEach(() => {
@@ -34,7 +38,7 @@ describe('config-validator', () => {
     // テスト用ディレクトリを削除
     if (existsSync(testProjectRoot)) {
       // ファイルを削除
-      const configPath = join(testProjectRoot, '.kiro/config.json');
+      const configPath = join(testProjectRoot, '.michi/config.json');
       if (existsSync(configPath)) {
         unlinkSync(configPath);
       }
@@ -49,6 +53,12 @@ describe('config-validator', () => {
 
   describe('validateProjectConfig', () => {
     it('設定ファイルが存在しない場合は情報メッセージを返す', () => {
+      // .michi/config.jsonが存在しないことを確認
+      const michiConfigPath = join(testProjectRoot, '.michi/config.json');
+      if (existsSync(michiConfigPath)) {
+        unlinkSync(michiConfigPath);
+      }
+
       const result = validateProjectConfig(testProjectRoot);
 
       expect(result.valid).toBe(true);
@@ -59,7 +69,13 @@ describe('config-validator', () => {
     });
 
     it('有効な設定ファイルの場合は成功', () => {
-      const configPath = join(testProjectRoot, '.kiro/config.json');
+      // .michiディレクトリが存在することを確認
+      const michiDir = join(testProjectRoot, '.michi');
+      if (!existsSync(michiDir)) {
+        mkdirSync(michiDir, { recursive: true });
+      }
+
+      const configPath = join(testProjectRoot, '.michi/config.json');
       writeFileSync(configPath, JSON.stringify({
         confluence: {
           pageCreationGranularity: 'single',
@@ -76,7 +92,7 @@ describe('config-validator', () => {
     });
 
     it('無効なJSONの場合はエラーを返す', () => {
-      const configPath = join(testProjectRoot, '.kiro/config.json');
+      const configPath = join(testProjectRoot, '.michi/config.json');
       writeFileSync(configPath, '{ invalid json }');
 
       const result = validateProjectConfig(testProjectRoot);
@@ -87,7 +103,7 @@ describe('config-validator', () => {
     });
 
     it('by-hierarchyモードでhierarchy設定がない場合はエラー', () => {
-      const configPath = join(testProjectRoot, '.kiro/config.json');
+      const configPath = join(testProjectRoot, '.michi/config.json');
       writeFileSync(configPath, JSON.stringify({
         confluence: {
           pageCreationGranularity: 'by-hierarchy'
@@ -102,7 +118,7 @@ describe('config-validator', () => {
     });
 
     it('selected-phasesモードでselectedPhases設定がない場合はエラー', () => {
-      const configPath = join(testProjectRoot, '.kiro/config.json');
+      const configPath = join(testProjectRoot, '.michi/config.json');
       writeFileSync(configPath, JSON.stringify({
         jira: {
           storyCreationGranularity: 'selected-phases'
@@ -122,7 +138,7 @@ describe('config-validator', () => {
       // 環境変数をクリア
       delete process.env.CONFLUENCE_PRD_SPACE;
       
-      const configPath = join(testProjectRoot, '.kiro/config.json');
+      const configPath = join(testProjectRoot, '.michi/config.json');
       writeFileSync(configPath, JSON.stringify({
         confluence: {
           pageCreationGranularity: 'single'
@@ -140,7 +156,7 @@ describe('config-validator', () => {
     });
 
     it('spaces設定がある場合は成功', () => {
-      const configPath = join(testProjectRoot, '.kiro/config.json');
+      const configPath = join(testProjectRoot, '.michi/config.json');
       writeFileSync(configPath, JSON.stringify({
         confluence: {
           spaces: {
@@ -158,7 +174,7 @@ describe('config-validator', () => {
     it('by-hierarchyモードでhierarchy設定がない場合はエラー', () => {
       // デフォルト設定を上書きするため、hierarchyキーを削除
       // デフォルト設定にhierarchyがあるため、実際にはエラーにならない可能性がある
-      const configPath = join(testProjectRoot, '.kiro/config.json');
+      const configPath = join(testProjectRoot, '.michi/config.json');
       writeFileSync(configPath, JSON.stringify({
         confluence: {
           pageCreationGranularity: 'by-hierarchy',
@@ -177,7 +193,7 @@ describe('config-validator', () => {
     });
 
     it('manualモードでstructure設定がない場合はエラー', () => {
-      const configPath = join(testProjectRoot, '.kiro/config.json');
+      const configPath = join(testProjectRoot, '.michi/config.json');
       writeFileSync(configPath, JSON.stringify({
         confluence: {
           pageCreationGranularity: 'manual',
@@ -196,7 +212,7 @@ describe('config-validator', () => {
 
     it('環境変数CONFLUENCE_PRD_SPACEがある場合は情報メッセージ', () => {
       process.env.CONFLUENCE_PRD_SPACE = 'Michi';
-      const configPath = join(testProjectRoot, '.kiro/config.json');
+      const configPath = join(testProjectRoot, '.michi/config.json');
       writeFileSync(configPath, JSON.stringify({
         confluence: {
           pageCreationGranularity: 'single'
@@ -216,7 +232,7 @@ describe('config-validator', () => {
 
   describe('validateForJiraSync', () => {
     it('issueTypes.story設定がない場合はエラー', () => {
-      const configPath = join(testProjectRoot, '.kiro/config.json');
+      const configPath = join(testProjectRoot, '.michi/config.json');
       writeFileSync(configPath, JSON.stringify({
         jira: {}
       }));
@@ -229,7 +245,7 @@ describe('config-validator', () => {
     });
 
     it('issueTypes.story設定がある場合は成功', () => {
-      const configPath = join(testProjectRoot, '.kiro/config.json');
+      const configPath = join(testProjectRoot, '.michi/config.json');
       writeFileSync(configPath, JSON.stringify({
         jira: {
           issueTypes: {
@@ -246,7 +262,7 @@ describe('config-validator', () => {
 
     it('環境変数JIRA_ISSUE_TYPE_STORYがある場合は情報メッセージ', () => {
       process.env.JIRA_ISSUE_TYPE_STORY = '10036';
-      const configPath = join(testProjectRoot, '.kiro/config.json');
+      const configPath = join(testProjectRoot, '.michi/config.json');
       writeFileSync(configPath, JSON.stringify({
         jira: {
           createEpic: true
@@ -264,7 +280,7 @@ describe('config-validator', () => {
     });
 
     it('issueTypes.subtask設定がない場合は警告', () => {
-      const configPath = join(testProjectRoot, '.kiro/config.json');
+      const configPath = join(testProjectRoot, '.michi/config.json');
       writeFileSync(configPath, JSON.stringify({
         jira: {
           issueTypes: {
@@ -281,7 +297,7 @@ describe('config-validator', () => {
     });
 
     it('selected-phasesモードでselectedPhases設定がない場合はエラー', () => {
-      const configPath = join(testProjectRoot, '.kiro/config.json');
+      const configPath = join(testProjectRoot, '.michi/config.json');
       writeFileSync(configPath, JSON.stringify({
         jira: {
           storyCreationGranularity: 'selected-phases',

package/scripts/utils/config-loader.ts

@@ -140,11 +140,32 @@ function validateConfigPath(configPath: string, projectRoot: string): boolean {
   return !relativePath.startsWith('..') && !isAbsolute(relativePath);
 }
 
+/**
+ * 設定ファイルのパスを解決
+ * 新規パス: .michi/config.json
+ * legacyパス（.kiro/config.json）が存在する場合は警告のみ表示
+ */
+function resolveConfigPath(projectRoot: string): string {
+  const michiConfigPath = resolve(projectRoot, '.michi/config.json');
+  const legacyConfigPath = resolve(projectRoot, '.kiro/config.json');
+  
+  // legacyパスが存在する場合は警告（移行推奨）
+  if (existsSync(legacyConfigPath) && !existsSync(michiConfigPath)) {
+    console.warn(
+      '⚠️  Deprecated: .kiro/config.json is deprecated.\n' +
+      '   Please migrate to .michi/config.json\n' +
+      '   The legacy path will not be supported in future versions.\n'
+    );
+  }
+  
+  return michiConfigPath;
+}
+
 /**
  * プロジェクト固有設定を読み込む
  */
 function loadProjectConfig(projectRoot: string = process.cwd()): Partial<AppConfig> | null {
-  const projectConfigPath = resolve(projectRoot, '.kiro/config.json');
+  const projectConfigPath = resolveConfigPath(projectRoot);
   
   // パストラバーサル対策: パスを検証
   if (!validateConfigPath(projectConfigPath, projectRoot)) {
@@ -247,7 +268,7 @@ 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 projectConfigPath = resolveConfigPath(projectRoot);
   const currentFileUrl = import.meta.url;
   const currentFilePath = fileURLToPath(currentFileUrl);
   const currentDir = resolve(currentFilePath, '..');
@@ -324,3 +345,10 @@ export function clearConfigCache(): void {
   cachedDefaultConfigMtime = null;
 }
 
+/**
+ * 設定ファイルのパスを解決（外部から使用可能）
+ */
+export function getConfigPath(projectRoot: string = process.cwd()): string {
+  return resolveConfigPath(projectRoot);
+}
+