@sk8metal/michi-cli 0.2.1 → 0.4.0

package/scripts/utils/config-sections.ts

@@ -0,0 +1,316 @@
+/**
+ * 設定セクションの対話的取得関数
+ */
+
+import type * as readline from 'readline';
+import { select, confirm, question, multiSelect } from './interactive-helpers.js';
+import type { ProjectMetadata } from './project-meta.js';
+
+/**
+ * Confluence階層設定
+ */
+export interface ConfluenceHierarchyConfig {
+  mode?: 'simple' | 'nested';
+  parentPageTitle?: string;
+  structure?: unknown;
+}
+
+/**
+ * Confluence設定結果
+ */
+export interface ConfluenceConfigResult {
+  pageCreationGranularity: string;
+  pageTitleFormat?: string;
+  hierarchy?: ConfluenceHierarchyConfig;
+}
+
+/**
+ * JIRA設定結果
+ */
+export interface JiraConfigResult {
+  createEpic: boolean;
+  storyCreationGranularity: string;
+  selectedPhases?: string[];
+  storyPoints: string;
+}
+
+/**
+ * ワークフロー設定結果
+ */
+export interface WorkflowConfigResult {
+  enabledPhases: string[];
+  approvalGates?: {
+    requirements?: string[];
+    design?: string[];
+    release?: string[];
+  };
+}
+
+/**
+ * Confluence設定を対話的に取得
+ */
+export async function getConfluenceConfig(
+  rl: readline.Interface,
+  _projectMeta?: ProjectMetadata,
+): Promise<ConfluenceConfigResult> {
+  console.log('\n📄 Confluence設定');
+  console.log('='.repeat(60));
+
+  const granularityChoices = [
+    {
+      value: 'single',
+      label: 'single（1ドキュメント = 1ページ）',
+      description: 'デフォルト・現在の動作',
+    },
+    {
+      value: 'by-section',
+      label: 'by-section（セクションごとにページ分割）',
+      description: '## セクションごとにページを作成',
+    },
+    {
+      value: 'by-hierarchy',
+      label: 'by-hierarchy（階層構造）',
+      description: '親ページ + 子ページの階層構造',
+    },
+    {
+      value: 'manual',
+      label: 'manual（手動指定）',
+      description: '設定ファイルで明示的に指定',
+    },
+  ];
+
+  const granularity = await select(
+    rl,
+    'ページ作成粒度を選択してください:',
+    granularityChoices,
+    'single',
+  );
+
+  const config: ConfluenceConfigResult = {
+    pageCreationGranularity: granularity,
+  };
+
+  // タイトル形式のカスタマイズ
+  const customTitle = await confirm(
+    rl,
+    'ページタイトル形式をカスタマイズしますか？',
+    false,
+  );
+
+  if (customTitle) {
+    const titleFormat = await question(
+      rl,
+      'タイトル形式を入力してください（例: {projectName} - {featureName}）: ',
+    );
+    if (titleFormat) {
+      config.pageTitleFormat = titleFormat;
+    }
+  }
+
+  // 階層構造設定
+  if (granularity === 'by-hierarchy' || granularity === 'manual') {
+    config.hierarchy = {};
+
+    if (granularity === 'by-hierarchy') {
+      const modeChoices = [
+        {
+          value: 'simple',
+          label: 'simple（親ページ + ドキュメントタイプ子ページ）',
+          description: '2階層構造',
+        },
+        {
+          value: 'nested',
+          label:
+            'nested（親ページ → ドキュメントタイプ親 → セクション子ページ）',
+          description: '3階層構造',
+        },
+      ];
+
+      const mode = await select(
+        rl,
+        '階層構造のモードを選択してください:',
+        modeChoices,
+        'simple',
+      );
+
+      config.hierarchy.mode = mode as 'simple' | 'nested';
+    }
+
+    const parentTitle = await question(
+      rl,
+      '親ページのタイトル形式を入力してください（例: [{projectName}] {featureName}）: ',
+    );
+
+    if (parentTitle) {
+      config.hierarchy.parentPageTitle = parentTitle;
+    } else {
+      config.hierarchy.parentPageTitle = '[{projectName}] {featureName}';
+    }
+
+    if (granularity === 'manual') {
+      console.log(
+        '\n⚠️  manualモードでは、設定ファイルを手動で編集する必要があります。',
+      );
+      console.log(
+        '   hierarchy.structure に各ドキュメントタイプのページ構造を定義してください。',
+      );
+    }
+  }
+
+  return config;
+}
+
+/**
+ * JIRA設定を対話的に取得
+ */
+export async function getJiraConfig(rl: readline.Interface): Promise<JiraConfigResult> {
+  console.log('\n📋 JIRA設定');
+  console.log('='.repeat(60));
+
+  const createEpic = await confirm(rl, 'Epicを作成しますか？', true);
+
+  const granularityChoices = [
+    {
+      value: 'all',
+      label: 'all（全Storyを作成）',
+      description: 'デフォルト',
+    },
+    {
+      value: 'by-phase',
+      label: 'by-phase（フェーズごとに作成）',
+      description: 'フェーズごとに個別に作成',
+    },
+    {
+      value: 'selected-phases',
+      label: 'selected-phases（指定フェーズのみ）',
+      description: '選択したフェーズのみ作成',
+    },
+  ];
+
+  const granularity = await select(
+    rl,
+    'Story作成粒度を選択してください:',
+    granularityChoices,
+    'all',
+  );
+
+  const config: JiraConfigResult = {
+    createEpic,
+    storyCreationGranularity: granularity,
+    storyPoints: 'auto',  // デフォルト値（後で上書きされる）
+  };
+
+  if (granularity === 'selected-phases') {
+    const phaseChoices = [
+      // 新ワークフロー構造
+      { value: 'spec-init', label: 'Phase 0.0: プロジェクト初期化' },
+      { value: 'requirements', label: 'Phase 0.1: 要件定義（Requirements）' },
+      { value: 'design', label: 'Phase 0.2: 設計（Design）' },
+      { value: 'test-type-selection', label: 'Phase 0.3: テストタイプ選択' },
+      { value: 'test-spec', label: 'Phase 0.4: テスト仕様書作成' },
+      { value: 'spec-tasks', label: 'Phase 0.5: タスク分割' },
+      { value: 'environment-setup', label: 'Phase 1: 環境構築' },
+      { value: 'implementation', label: 'Phase 2: TDD実装（Implementation）' },
+      { value: 'phase-a', label: 'Phase A: PR前自動テスト' },
+      { value: 'testing', label: 'Phase 3: 追加QA（Testing）' },
+      { value: 'phase-b', label: 'Phase B: リリース準備テスト' },
+      { value: 'release-prep', label: 'Phase 4: リリース準備（Release Preparation）' },
+      { value: 'release', label: 'Phase 5: リリース（Release）' },
+    ];
+
+    const selectedPhases = await multiSelect(
+      rl,
+      '作成するフェーズを選択してください:',
+      phaseChoices,
+      ['implementation', 'testing'],
+    );
+
+    config.selectedPhases = selectedPhases;
+  }
+
+  const storyPointsChoices = [
+    { value: 'auto', label: 'auto（自動抽出）', description: 'デフォルト' },
+    { value: 'manual', label: 'manual（手動設定）' },
+    { value: 'disabled', label: 'disabled（設定しない）' },
+  ];
+
+  const storyPoints = await select(
+    rl,
+    'Story Points設定を選択してください:',
+    storyPointsChoices,
+    'auto',
+  );
+
+  config.storyPoints = storyPoints;
+
+  return config;
+}
+
+/**
+ * ワークフロー設定を対話的に取得
+ */
+export async function getWorkflowConfig(rl: readline.Interface): Promise<WorkflowConfigResult> {
+  console.log('\n⚙️  ワークフロー設定');
+  console.log('='.repeat(60));
+
+  const phaseChoices = [
+    { value: 'requirements', label: '要件定義（Requirements）' },
+    { value: 'design', label: '設計（Design）' },
+    { value: 'tasks', label: 'タスク分割（Tasks）' },
+  ];
+
+  const enabledPhases = await multiSelect(
+    rl,
+    '有効化するフェーズを選択してください:',
+    phaseChoices,
+    ['requirements', 'design', 'tasks'],
+  );
+
+  const config: WorkflowConfigResult = {
+    enabledPhases,
+  };
+
+  const customApprovalGates = await confirm(
+    rl,
+    '承認ゲートをカスタマイズしますか？',
+    false,
+  );
+
+  if (customApprovalGates) {
+    config.approvalGates = {};
+
+    if (enabledPhases.includes('requirements')) {
+      const approvers = await question(
+        rl,
+        '要件定義フェーズの承認者（カンマ区切り、例: pm,director）: ',
+      );
+      if (approvers) {
+        config.approvalGates.requirements = approvers
+          .split(',')
+          .map((s) => s.trim());
+      }
+    }
+
+    if (enabledPhases.includes('design')) {
+      const approvers = await question(
+        rl,
+        '設計フェーズの承認者（カンマ区切り、例: architect,director）: ',
+      );
+      if (approvers) {
+        config.approvalGates.design = approvers.split(',').map((s) => s.trim());
+      }
+    }
+
+    const releaseApprovers = await question(
+      rl,
+      'リリースフェーズの承認者（カンマ区切り、例: sm,director）: ',
+    );
+    if (releaseApprovers) {
+      config.approvalGates.release = releaseApprovers
+        .split(',')
+        .map((s) => s.trim());
+    }
+  }
+
+  return config;
+}

package/scripts/utils/config-validator.ts

@@ -5,7 +5,7 @@
 import { existsSync, readFileSync } from 'fs';
 import { AppConfigSchema } from '../config/config-schema.js';
 import type { ZodIssue } from 'zod';
-import { getConfig, getConfigPath } from './config-loader.js';
+import { getConfig, getConfigPath, getGlobalConfigPath } from './config-loader.js';
 import { loadProjectMeta } from './project-meta.js';
 import {
   getProjectIssueTypes,
@@ -528,6 +528,71 @@ export async function validateForJiraSyncAsync(
   return result;
 }
 
+/**
+ * グローバル設定ファイルをバリデーション
+ */
+export function validateGlobalConfig(): ValidationResult {
+  const errors: string[] = [];
+  const warnings: string[] = [];
+  const info: string[] = [];
+
+  const globalConfigPath = getGlobalConfigPath();
+
+  if (!existsSync(globalConfigPath)) {
+    info.push('Global config file not found. This is optional.');
+    return {
+      valid: true,
+      errors: [],
+      warnings: [],
+      info,
+    };
+  }
+
+  try {
+    const content = readFileSync(globalConfigPath, 'utf-8');
+    const parsed = JSON.parse(content);
+
+    // スキーマでバリデーション
+    const result = AppConfigSchema.safeParse(parsed);
+
+    if (!result.success) {
+      result.error.issues.forEach((error: ZodIssue) => {
+        const path = error.path.map(String).join('.');
+        errors.push(`${path}: ${error.message}`);
+      });
+
+      return {
+        valid: false,
+        errors,
+        warnings: [],
+        info: [],
+      };
+    }
+
+    return {
+      valid: errors.length === 0,
+      errors,
+      warnings,
+      info: [],
+    };
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      errors.push(`Invalid JSON in global config: ${error.message}`);
+    } else {
+      errors.push(
+        `Error reading global config file: ${error instanceof Error ? error.message : 'Unknown error'}`,
+      );
+    }
+
+    return {
+      valid: false,
+      errors,
+      warnings: [],
+      info: [],
+    };
+  }
+}
+
 // CLI実行
 if (import.meta.url === `file://${process.argv[1]}`) {
   const valid = validateAndReport();

package/scripts/utils/confluence-approval.ts

@@ -56,7 +56,7 @@ export async function getApprovalStatus(
     // 承認ラベルをチェック
     // Confluenceでは通常、承認はカスタムラベルやメタデータで管理される
     // ここでは "approved" ラベルの存在で判定
-    const hasApprovedLabel = labels.some((label: any) =>
+    const hasApprovedLabel = labels.some((label: { name: string }) =>
       label.name === 'approved' || label.name === '承認済み'
     );
 
@@ -97,8 +97,9 @@ export async function getApprovalStatus(
       pageId,
       pageTitle
     };
-  } catch (error: any) {
-    console.error('Failed to get approval status:', error.message);
+  } catch (error: unknown) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error('Failed to get approval status:', message);
     throw error;
   }
 }
@@ -134,13 +135,14 @@ export async function pollForApproval(
 
       // 次のチェックまで待機
       await new Promise(resolve => setTimeout(resolve, interval));
-    } catch (error: any) {
+    } catch (error: unknown) {
       // エラーがタイムアウト以外の場合はリトライ
-      if (error.message.includes('timeout')) {
+      const message = error instanceof Error ? error.message : String(error);
+      if (message.includes('timeout')) {
         throw error;
       }
 
-      console.warn('Error checking approval status, will retry:', error.message);
+      console.warn('Error checking approval status, will retry:', message);
       await new Promise(resolve => setTimeout(resolve, interval));
     }
   }

package/scripts/utils/confluence-hierarchy.ts

@@ -3,7 +3,7 @@
  * 各パターン（single, by-section, by-hierarchy, manual）に対応
  */
 
-import type { ConfluenceClient } from '../confluence-sync.js';
+import type { ConfluenceClient, ConfluencePage } from '../confluence-sync.js';
 import { convertMarkdownToConfluence, createConfluencePage } from '../markdown-to-confluence.js';
 import type { ProjectMetadata } from './project-meta.js';
 import type { ConfluenceConfig } from '../config/config-schema.js';
@@ -262,26 +262,26 @@ export async function createSinglePage(
   
   // 既存ページを検索
   const existingPage = await client.searchPage(spaceKey, pageTitle);
-  
-  let page: any;
+
+  let page: ConfluencePage;
   if (existingPage) {
     page = await client.updatePage(
       existingPage.id,
       pageTitle,
       fullContent,
-      existingPage.version.number
+      existingPage.version!.number
     );
     console.log(`✅ Page updated: ${pageTitle}`);
   } else {
     page = await client.createPage(spaceKey, pageTitle, fullContent, labels);
     console.log(`✅ Page created: ${pageTitle}`);
   }
-  
+
   const baseUrl = process.env.ATLASSIAN_URL || '';
   return {
     pages: [{
       id: page.id,
-      url: `${baseUrl}/wiki${page._links.webui}`,
+      url: `${baseUrl}/wiki${page._links!.webui}`,
       pageId: page.id,
       title: pageTitle
     }]
@@ -334,25 +334,25 @@ export async function createBySectionPages(
     
     // 既存ページを検索
     const existingPage = await client.searchPage(spaceKey, pageTitle);
-    
-    let page: any;
+
+    let page: ConfluencePage;
     if (existingPage) {
       page = await client.updatePage(
         existingPage.id,
         pageTitle,
         fullContent,
-        existingPage.version.number
+        existingPage.version!.number
       );
       console.log(`✅ Page updated: ${pageTitle}`);
     } else {
       page = await client.createPage(spaceKey, pageTitle, fullContent, labels);
       console.log(`✅ Page created: ${pageTitle}`);
     }
-    
+
     const baseUrl = process.env.ATLASSIAN_URL || '';
     pages.push({
       id: page.id,
-      url: `${baseUrl}/wiki${page._links.webui}`,
+      url: `${baseUrl}/wiki${page._links!.webui}`,
       pageId: page.id,
       title: pageTitle
     });
@@ -449,15 +449,15 @@ export async function createByHierarchySimplePages(
       }
     }
   }
-  
-  let childPage: any;
+
+  let childPage: ConfluencePage;
   if (existingChild) {
-    console.log(`📄 Found existing child page: ${existingChild.id} (version ${existingChild.version.number})`);
+    console.log(`📄 Found existing child page: ${existingChild.id} (version ${existingChild.version!.number})`);
     childPage = await client.updatePage(
       existingChild.id,
       childPageTitle,
       fullContent,
-      existingChild.version.number
+      existingChild.version!.number
     );
     console.log(`✅ Child page updated: ${childPageTitle}`);
   } else {
@@ -471,12 +471,12 @@ export async function createByHierarchySimplePages(
     );
     console.log(`✅ Child page created: ${childPageTitle} (under ${parentTitle})`);
   }
-  
+
   const baseUrl = process.env.ATLASSIAN_URL || '';
   return {
     pages: [{
       id: childPage.id,
-      url: `${baseUrl}/wiki${childPage._links.webui}`,
+      url: `${baseUrl}/wiki${childPage._links!.webui}`,
       pageId: childPage.id,
       title: childPageTitle
     }],
@@ -588,14 +588,14 @@ export async function createByHierarchyNestedPages(
     // 既存のセクションページを検索（docTypeParentIdで絞り込んで検索）
     // これにより、同じタイトルでも別機能のページがヒットすることを防ぐ
     const existingSectionPage = await client.searchPage(spaceKey, sectionPageTitle, docTypeParentId);
-    
-    let sectionPage: any;
+
+    let sectionPage: ConfluencePage;
     if (existingSectionPage) {
       sectionPage = await client.updatePage(
         existingSectionPage.id,
         sectionPageTitle,
         fullContent,
-        existingSectionPage.version.number
+        existingSectionPage.version!.number
       );
       console.log(`✅ Section page updated: ${sectionPageTitle}`);
     } else {
@@ -608,11 +608,11 @@ export async function createByHierarchyNestedPages(
       );
       console.log(`✅ Section page created: ${sectionPageTitle} (under ${docTypeParentTitle})`);
     }
-    
+
     const baseUrl = process.env.ATLASSIAN_URL || '';
     pages.push({
       id: sectionPage.id,
-      url: `${baseUrl}/wiki${sectionPage._links.webui}`,
+      url: `${baseUrl}/wiki${sectionPage._links!.webui}`,
       pageId: sectionPage.id,
       title: sectionPageTitle
     });
@@ -731,14 +731,14 @@ export async function createManualPages(
       
       // 既存ページを検索（親ページIDが指定されている場合は絞り込んで検索）
       const existingPage = await client.searchPage(spaceKey, pageTitle, parentPageId);
-      
-      let page: any;
+
+      let page: ConfluencePage;
       if (existingPage) {
         page = await client.updatePage(
           existingPage.id,
           pageTitle,
           fullContent,
-          existingPage.version.number
+          existingPage.version!.number
         );
         console.log(`✅ Page updated: ${pageTitle}`);
       } else {
@@ -756,11 +756,11 @@ export async function createManualPages(
           console.log(`✅ Page created: ${pageTitle}`);
         }
       }
-      
+
       const baseUrl = process.env.ATLASSIAN_URL || '';
       pages.push({
         id: page.id,
-        url: `${baseUrl}/wiki${page._links.webui}`,
+        url: `${baseUrl}/wiki${page._links!.webui}`,
         pageId: page.id,
         title: pageTitle
       });