@sk8metal/michi-cli 0.0.2 → 0.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sk8metal/michi-cli",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Managed Intelligent Comprehensive Hub for Integration - AI-driven development workflow automation",
   "license": "MIT",
   "type": "module",
@@ -9,7 +9,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/sk8metalme/michi.git"
+    "url": "git+https://github.com/sk8metalme/michi.git"
   },
   "homepage": "https://github.com/sk8metalme/michi#readme",
   "bugs": {
@@ -29,7 +29,7 @@
     "github"
   ],
   "bin": {
-    "michi": "./dist/src/cli.js"
+    "michi": "dist/src/cli.js"
   },
   "files": [
     "dist",
@@ -64,33 +64,37 @@
     "test": "vitest",
     "test:run": "vitest --run",
     "test:ui": "vitest --ui",
+    "test:coverage": "vitest --run --coverage",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@octokit/rest": "^20.0.2",
+    "@octokit/rest": "^22.0.1",
     "axios": "^1.13.1",
     "commander": "^14.0.2",
     "dotenv": "^16.3.1",
     "exceljs": "^4.4.0",
-    "googleapis": "^126.0.1",
+    "googleapis": "^166.0.0",
     "jira-client": "^8.2.2",
     "markdown-it": "^14.0.0",
     "turndown": "^7.1.2",
-    "zod": "^3.22.4"
+    "zod": "^4.1.12"
   },
   "devDependencies": {
-    "@types/markdown-it": "^13.0.7",
-    "@types/node": "^20.10.6",
+    "@eslint/js": "^9.39.1",
+    "@types/markdown-it": "^14.1.2",
+    "@types/node": "^24.10.1",
     "@types/turndown": "^5.0.4",
-    "@typescript-eslint/eslint-plugin": "^6.17.0",
-    "@typescript-eslint/parser": "^6.17.0",
-    "eslint": "^8.56.0",
+    "@typescript-eslint/eslint-plugin": "^8.46.4",
+    "@typescript-eslint/parser": "^8.46.4",
+    "eslint": "^9.39.1",
     "prettier": "^3.1.1",
     "tsx": "^4.7.0",
     "typescript": "^5.3.3",
-    "vitest": "^1.1.1"
+    "typescript-eslint": "^8.46.4",
+    "vitest": "^4.0.8",
+    "@vitest/coverage-v8": "^4.0.8"
   },
   "engines": {
     "node": ">=20.0.0",

package/scripts/config/config-schema.ts

@@ -86,11 +86,11 @@ export const JiraConfigSchema = z.object({
   createEpic: z.boolean().default(true),
   storyPoints: JiraStoryPointsSchema.default('auto'),
   autoLabels: z.array(z.string()).default(['{projectLabel}', '{featureName}', '{phaseLabel}']),
-    issueTypes: z.object({
-      epic: z.string().default('Epic'),
-      story: z.string().nullish().default(null),  // null | undefined | string
-      subtask: z.string().nullish().default(null)  // null | undefined | string
-    }).optional(),
+  issueTypes: z.object({
+    epic: z.string().default('Epic'),
+    story: z.string().nullish().default(null),  // null | undefined | string
+    subtask: z.string().nullish().default(null)  // null | undefined | string
+  }).optional(),
   selectedPhases: z.array(z.string()).optional()
 });
 

package/scripts/config-interactive.ts

@@ -102,7 +102,7 @@ async function multiSelect(
     console.log(`  ${checked} ${index + 1}. ${choice.label}`);
   });
   
-  const answer = await question(rl, `\n選択してください（カンマ区切り、例: 1,2,3）: `);
+  const answer = await question(rl, '\n選択してください（カンマ区切り、例: 1,2,3）: ');
   
   if (!answer && defaults.length > 0) {
     return defaults;
@@ -204,13 +204,13 @@ async function getConfluenceConfig(rl: readline.Interface, projectMeta: any): Pr
     
     const parentTitle = await question(
       rl,
-      `親ページのタイトル形式を入力してください（例: [{projectName}] {featureName}）: `
+      '親ページのタイトル形式を入力してください（例: [{projectName}] {featureName}）: '
     );
     
     if (parentTitle) {
       config.hierarchy.parentPageTitle = parentTitle;
     } else {
-      config.hierarchy.parentPageTitle = `[{projectName}] {featureName}`;
+      config.hierarchy.parentPageTitle = '[{projectName}] {featureName}';
     }
     
     if (granularity === 'manual') {

package/scripts/confluence-sync.ts

@@ -107,7 +107,7 @@ class ConfluenceClient {
         }
         
         // CQLクエリで見つからない場合、従来の方法で検索（親ページIDでフィルタリング）
-        console.log(`  Falling back to standard search (may find pages in different parent)`);
+        console.log('  Falling back to standard search (may find pages in different parent)');
         return null;
       }
       
@@ -388,7 +388,7 @@ async function syncToConfluence(
   } else if (process.env.CONFLUENCE_PRD_SPACE) {
     console.log(`📝 Config source: environment variable (CONFLUENCE_PRD_SPACE = ${process.env.CONFLUENCE_PRD_SPACE})`);
   } else {
-    console.log(`📝 Config source: default config`);
+    console.log('📝 Config source: default config');
   }
   
   // Markdownファイル読み込み
@@ -446,7 +446,7 @@ async function syncToConfluence(
   console.log(`✅ Sync completed: ${result.pages.length} page(s) created/updated`);
   
   if (result.pages.length > 1) {
-    console.log(`📄 Created pages:`);
+    console.log('📄 Created pages:');
     result.pages.forEach((page, index) => {
       console.log(`   ${index + 1}. ${page.title} - ${page.url}`);
     });

package/scripts/create-project.ts

@@ -38,22 +38,22 @@ function parseArgs(): ProjectConfig {
     const value = args[i + 1];
     
     switch (key) {
-      case 'name':
-        config.name = value;
-        break;
-      case 'project-name':
-        config.projectName = value;
-        break;
-      case 'jira-key':
-        config.jiraKey = value;
-        break;
-      case 'org':
-        config.org = value;
-        break;
-      case 'labels':
-        // カンマ区切りでラベル配列に変換
-        config.labels = value.split(',').map(l => l.trim());
-        break;
+    case 'name':
+      config.name = value;
+      break;
+    case 'project-name':
+      config.projectName = value;
+      break;
+    case 'jira-key':
+      config.jiraKey = value;
+      break;
+    case 'org':
+      config.org = value;
+      break;
+    case 'labels':
+      // カンマ区切りでラベル配列に変換
+      config.labels = value.split(',').map(l => l.trim());
+      break;
     }
   }
   
@@ -133,7 +133,7 @@ async function createProject(config: ProjectConfig): Promise<void> {
     
     // ハイフンが存在する場合のみサービスラベルを生成
     if (repoName.includes('-')) {
-    const parts = repoName.split('-');
+      const parts = repoName.split('-');
       const servicePart = parts[parts.length - 1];
       const serviceLabel = servicePart.toLowerCase().replace(/[^a-z0-9-]/g, '');
     

package/scripts/jira-sync.ts

@@ -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/utils/config-loader.ts

@@ -192,7 +192,7 @@ export function loadConfig(projectRoot: string = process.cwd()): AppConfig {
   const projectConfig = loadProjectConfig(projectRoot);
   
   // マージ（プロジェクト設定がデフォルトを上書き）
-  let mergedConfig: AppConfig = projectConfig
+  const mergedConfig: AppConfig = projectConfig
     ? deepMerge(defaultConfig, projectConfig)
     : defaultConfig;
   

package/scripts/utils/config-validator.ts

@@ -5,6 +5,7 @@
 import { existsSync, readFileSync } from 'fs';
 import { resolve } from 'path';
 import { AppConfigSchema } from '../config/config-schema.js';
+import type { ZodIssue } from 'zod';
 import type { AppConfig } from '../config/config-schema.js';
 import { getConfig } from './config-loader.js';
 
@@ -47,8 +48,8 @@ export function validateProjectConfig(projectRoot: string = process.cwd()): Vali
     const result = AppConfigSchema.safeParse(parsed);
     
     if (!result.success) {
-      result.error.errors.forEach(error => {
-        const path = error.path.join('.');
+      result.error.issues.forEach((error: ZodIssue) => {
+        const path = error.path.map(String).join('.');
         errors.push(`${path}: ${error.message}`);
       });
       
@@ -196,15 +197,15 @@ export function validateForConfluenceSync(
       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` +
+          '環境変数CONFLUENCE_PRD_SPACEも設定されていないため、デフォルト値（PRD）を使用します。' +
+          '\n  推奨: .kiro/config.jsonに以下を追加してください:\n' +
+          '  {\n' +
+          '    "confluence": {\n' +
+          '      "spaces": {\n' +
           `        "${docType}": "YOUR_SPACE_KEY"\n` +
-          `      }\n` +
-          `    }\n` +
-          `  }`
+          '      }\n' +
+          '    }\n' +
+          '  }'
         );
       } else {
         info.push(`confluence.spaces.${docType}が設定されていませんが、環境変数CONFLUENCE_PRD_SPACE（${process.env.CONFLUENCE_PRD_SPACE}）を使用します。`);
@@ -215,29 +216,29 @@ export function validateForConfluenceSync(
     if (confluence.pageCreationGranularity === 'by-hierarchy' || confluence.pageCreationGranularity === 'manual') {
       if (!confluence.hierarchy) {
         errors.push(
-          `confluence.hierarchyが設定されていません。` +
+          '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` +
-          `  }`
+          '\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モードでは推奨されます。`
+          'confluence.hierarchy.parentPageTitleが設定されていません。' +
+          'by-hierarchyモードでは推奨されます。'
         );
       }
       
       if (confluence.pageCreationGranularity === 'manual' && confluence.hierarchy && !confluence.hierarchy.structure) {
         errors.push(
-          `confluence.hierarchy.structureが設定されていません。` +
-          `pageCreationGranularityが"manual"の場合、structure設定が必須です。`
+          'confluence.hierarchy.structureが設定されていません。' +
+          'pageCreationGranularityが"manual"の場合、structure設定が必須です。'
         );
       }
     }
@@ -274,20 +275,20 @@ export function validateForJiraSync(projectRoot: string = process.cwd()): Valida
     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`
+          '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}）を使用します。`);
@@ -296,10 +297,10 @@ export function validateForJiraSync(projectRoot: string = process.cwd()): Valida
       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を設定してください。`
+            '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}）を使用します。`);
@@ -309,8 +310,8 @@ export function validateForJiraSync(projectRoot: string = process.cwd()): Valida
       if (!jira.issueTypes.subtask) {
         if (!process.env.JIRA_ISSUE_TYPE_SUBTASK) {
           warnings.push(
-            `jira.issueTypes.subtaskが設定されていません。` +
-            `環境変数JIRA_ISSUE_TYPE_SUBTASKも設定されていないため、サブタスクは作成されません。`
+            'jira.issueTypes.subtaskが設定されていません。' +
+            '環境変数JIRA_ISSUE_TYPE_SUBTASKも設定されていないため、サブタスクは作成されません。'
           );
         } else {
           info.push(`jira.issueTypes.subtaskが設定されていませんが、環境変数JIRA_ISSUE_TYPE_SUBTASK（${process.env.JIRA_ISSUE_TYPE_SUBTASK}）を使用します。`);
@@ -321,8 +322,8 @@ export function validateForJiraSync(projectRoot: string = process.cwd()): Valida
     // selectedPhases設定のチェック
     if (jira.storyCreationGranularity === 'selected-phases' && !jira.selectedPhases) {
       errors.push(
-        `jira.selectedPhasesが設定されていません。` +
-        `storyCreationGranularityが"selected-phases"の場合、selectedPhases設定が必須です。`
+        'jira.selectedPhasesが設定されていません。' +
+        'storyCreationGranularityが"selected-phases"の場合、selectedPhases設定が必須です。'
       );
     }
     

package/scripts/utils/confluence-hierarchy.ts

@@ -401,7 +401,7 @@ export async function createByHierarchySimplePages(
   
   // タイトルに機能名が含まれていない場合、自動的に追加（重複を避けるため）
   if (!childPageTitle.includes(featureName)) {
-    console.warn(`⚠️  Warning: pageTitleFormat does not include {featureName}. Adding feature name to ensure uniqueness.`);
+    console.warn('⚠️  Warning: pageTitleFormat does not include {featureName}. Adding feature name to ensure uniqueness.');
     childPageTitle = `[${featureName}] ${childPageTitle}`;
   }
   
@@ -423,7 +423,7 @@ export async function createByHierarchySimplePages(
   
   // CQLクエリで見つからない場合、親ページIDなしで検索（既存ページが別の親の下にある可能性）
   if (!existingChild) {
-    console.log(`  CQL search found nothing, trying search without parent filter`);
+    console.log('  CQL search found nothing, trying search without parent filter');
     existingChild = await client.searchPage(spaceKey, childPageTitle);
     if (existingChild) {
       console.log(`  ⚠️  Found page with same title: ${existingChild.id}, verifying parent page ID`);
@@ -436,14 +436,14 @@ export async function createByHierarchySimplePages(
         console.log(`  ✅ Parent page ID matches (${parentPageId}), proceeding with update`);
       } else {
         // 親ページIDが一致しない場合、エラーをスロー
-        console.error(`  ❌ Parent page ID mismatch!`);
+        console.error('  ❌ Parent page ID mismatch!');
         console.error(`     Expected parent: ${parentPageId}`);
         console.error(`     Actual parent: ${actualParentId || 'root (no parent)'}`);
         console.error(`     Page ID: ${existingChild.id}`);
         throw new Error(
           `Page conflict: Found page "${childPageTitle}" (ID: ${existingChild.id}) ` +
           `under different parent (expected: ${parentPageId}, actual: ${actualParentId || 'root'}). ` +
-          `Cannot update foreign page. Please rename or delete the conflicting page.`
+          'Cannot update foreign page. Please rename or delete the conflicting page.'
         );
       }
     }
@@ -523,7 +523,7 @@ export async function createByHierarchyNestedPages(
   
   // タイトルに機能名が含まれていない場合、自動的に追加（重複を避けるため）
   if (!docTypeParentTitle.includes(featureName)) {
-    console.warn(`⚠️  Warning: pageTitleFormat does not include {featureName}. Adding feature name to ensure uniqueness.`);
+    console.warn('⚠️  Warning: pageTitleFormat does not include {featureName}. Adding feature name to ensure uniqueness.');
     docTypeParentTitle = `[${featureName}] ${docTypeParentTitle}`;
   }
   
@@ -569,7 +569,7 @@ export async function createByHierarchyNestedPages(
     
     // タイトルに機能名が含まれていない場合、自動的に追加（重複を避けるため）
     if (!sectionPageTitle.includes(featureName)) {
-      console.warn(`⚠️  Warning: pageTitleFormat does not include {featureName}. Adding feature name to ensure uniqueness.`);
+      console.warn('⚠️  Warning: pageTitleFormat does not include {featureName}. Adding feature name to ensure uniqueness.');
       sectionPageTitle = `[${featureName}] ${sectionPageTitle}`;
     }
     const confluenceContent = convertMarkdownToConfluence(section.content);
@@ -697,7 +697,7 @@ export async function createManualPages(
       
       // タイトルに機能名が含まれていない場合、自動的に追加（重複を避けるため）
       if (!pageTitle.includes(featureName)) {
-        console.warn(`⚠️  Warning: Manual page title does not include {featureName}. Adding feature name to ensure uniqueness.`);
+        console.warn('⚠️  Warning: Manual page title does not include {featureName}. Adding feature name to ensure uniqueness.');
         pageTitle = `[${featureName}] ${pageTitle}`;
       }
       
@@ -785,20 +785,34 @@ export async function createPagesByGranularity(
   const granularity = config.pageCreationGranularity || 'single';
   
   switch (granularity) {
-    case 'single':
-      return await createSinglePage(
-        client,
-        spaceKey,
-        markdown,
-        config,
-        projectMeta,
-        featureName,
-        docType,
-        githubUrl
-      );
+  case 'single':
+    return await createSinglePage(
+      client,
+      spaceKey,
+      markdown,
+      config,
+      projectMeta,
+      featureName,
+      docType,
+      githubUrl
+    );
     
-    case 'by-section':
-      return await createBySectionPages(
+  case 'by-section':
+    return await createBySectionPages(
+      client,
+      spaceKey,
+      markdown,
+      config,
+      projectMeta,
+      featureName,
+      docType,
+      githubUrl
+    );
+    
+  case 'by-hierarchy': {
+    const hierarchyMode = config.hierarchy?.mode || 'simple';
+    if (hierarchyMode === 'nested') {
+      return await createByHierarchyNestedPages(
         client,
         spaceKey,
         markdown,
@@ -808,35 +822,8 @@ export async function createPagesByGranularity(
         docType,
         githubUrl
       );
-    
-    case 'by-hierarchy':
-      const hierarchyMode = config.hierarchy?.mode || 'simple';
-      if (hierarchyMode === 'nested') {
-        return await createByHierarchyNestedPages(
-          client,
-          spaceKey,
-          markdown,
-          config,
-          projectMeta,
-          featureName,
-          docType,
-          githubUrl
-        );
-      } else {
-        return await createByHierarchySimplePages(
-          client,
-          spaceKey,
-          markdown,
-          config,
-          projectMeta,
-          featureName,
-          docType,
-          githubUrl
-        );
-      }
-    
-    case 'manual':
-      return await createManualPages(
+    } else {
+      return await createByHierarchySimplePages(
         client,
         spaceKey,
         markdown,
@@ -846,9 +833,23 @@ export async function createPagesByGranularity(
         docType,
         githubUrl
       );
+    }
+  }
+    
+  case 'manual':
+    return await createManualPages(
+      client,
+      spaceKey,
+      markdown,
+      config,
+      projectMeta,
+      featureName,
+      docType,
+      githubUrl
+    );
     
-    default:
-      throw new Error(`Unknown page creation granularity: ${granularity}`);
+  default:
+    throw new Error(`Unknown page creation granularity: ${granularity}`);
   }
 }