@sk8metal/michi-cli 0.0.1 → 0.0.3

package/scripts/phase-runner.ts

@@ -0,0 +1,303 @@
+/**
+ * フェーズランナー
+ * 各フェーズを実行し、Confluence/JIRA作成を確実に実行
+ */
+
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { syncToConfluence } from './confluence-sync.js';
+import { syncTasksToJIRA } from './jira-sync.js';
+import { validatePhase } from './validate-phase.js';
+import { runPreFlightCheck } from './pre-flight-check.js';
+import { validateFeatureNameOrThrow } from './utils/feature-name-validator.js';
+
+type Phase = 'requirements' | 'design' | 'tasks';
+
+interface PhaseRunResult {
+  phase: Phase;
+  success: boolean;
+  confluenceCreated: boolean;
+  jiraCreated: boolean;
+  validationPassed: boolean;
+  errors: string[];
+}
+
+/**
+ * 要件定義フェーズを実行
+ */
+async function runRequirementsPhase(feature: string): Promise<PhaseRunResult> {
+  console.log('\n📋 Phase: Requirements（要件定義）');
+  console.log('='.repeat(60));
+  
+  const errors: string[] = [];
+  let confluenceCreated = false;
+  let confluenceUrl: string | null = null;
+  
+  // Step 1: requirements.md存在確認
+  const requirementsPath = join(process.cwd(), '.kiro', 'specs', feature, 'requirements.md');
+  if (!existsSync(requirementsPath)) {
+    errors.push('requirements.mdが存在しません。先に/kiro:spec-requirements を実行してください');
+    return {
+      phase: 'requirements',
+      success: false,
+      confluenceCreated: false,
+      jiraCreated: false,
+      validationPassed: false,
+      errors
+    };
+  }
+  
+  console.log('✅ requirements.md 存在確認');
+  
+  // Step 2: Confluenceページ作成
+  console.log('\n📤 Confluenceページ作成中...');
+  try {
+    confluenceUrl = await syncToConfluence(feature, 'requirements');
+    confluenceCreated = true;
+    console.log('✅ Confluenceページ作成成功');
+  } catch (error: any) {
+    errors.push(`Confluenceページ作成失敗: ${error.message}`);
+    console.error('❌ Confluenceページ作成失敗:', error.message);
+  }
+  
+  // Step 3: バリデーション
+  console.log('\n🔍 バリデーション実行中...');
+  const validation = validatePhase(feature, 'requirements');
+  errors.push(...validation.errors);
+  
+  // Step 4: 結果サマリー
+  console.log('\n' + '='.repeat(60));
+  console.log('📊 要件定義フェーズ完了チェック:');
+  console.log('  ✅ requirements.md: 作成済み');
+  console.log(`  ${confluenceCreated ? '✅' : '❌'} Confluenceページ: ${confluenceCreated ? '作成済み' : '未作成'}`);
+  console.log(`  ${validation.valid ? '✅' : '❌'} バリデーション: ${validation.valid ? '成功' : '失敗'}`);
+  
+  if (validation.valid && confluenceCreated) {
+    console.log('\n🎉 要件定義フェーズが完了しました！');
+    console.log('📢 PMや部長にConfluenceでレビューを依頼してください');
+    if (confluenceUrl) {
+      console.log(`📄 Confluence: ${confluenceUrl}`);
+    } else {
+      const baseUrl = process.env.ATLASSIAN_URL || 'https://your-site.atlassian.net';
+      console.log(`📄 Confluence: ${baseUrl}/wiki/spaces/（URLは上記のログを参照）`);
+    }
+  }
+  
+  return {
+    phase: 'requirements',
+    success: validation.valid && confluenceCreated,
+    confluenceCreated,
+    jiraCreated: false,
+    validationPassed: validation.valid,
+    errors
+  };
+}
+
+/**
+ * 設計フェーズを実行
+ */
+async function runDesignPhase(feature: string): Promise<PhaseRunResult> {
+  console.log('\n🏗️  Phase: Design（設計）');
+  console.log('='.repeat(60));
+  
+  const errors: string[] = [];
+  let confluenceCreated = false;
+  let confluenceUrl: string | null = null;
+  
+  // Step 1: design.md存在確認
+  const designPath = join(process.cwd(), '.kiro', 'specs', feature, 'design.md');
+  if (!existsSync(designPath)) {
+    errors.push('design.mdが存在しません。先に/kiro:spec-design を実行してください');
+    return {
+      phase: 'design',
+      success: false,
+      confluenceCreated: false,
+      jiraCreated: false,
+      validationPassed: false,
+      errors
+    };
+  }
+  
+  console.log('✅ design.md 存在確認');
+  
+  // Step 2: Confluenceページ作成
+  console.log('\n📤 Confluenceページ作成中...');
+  try {
+    confluenceUrl = await syncToConfluence(feature, 'design');
+    confluenceCreated = true;
+    console.log('✅ Confluenceページ作成成功');
+  } catch (error: any) {
+    errors.push(`Confluenceページ作成失敗: ${error.message}`);
+    console.error('❌ Confluenceページ作成失敗:', error.message);
+  }
+  
+  // Step 3: バリデーション
+  console.log('\n🔍 バリデーション実行中...');
+  const validation = validatePhase(feature, 'design');
+  errors.push(...validation.errors);
+  
+  // Step 4: 結果サマリー
+  console.log('\n' + '='.repeat(60));
+  console.log('📊 設計フェーズ完了チェック:');
+  console.log('  ✅ design.md: 作成済み');
+  console.log(`  ${confluenceCreated ? '✅' : '❌'} Confluenceページ: ${confluenceCreated ? '作成済み' : '未作成'}`);
+  console.log(`  ${validation.valid ? '✅' : '❌'} バリデーション: ${validation.valid ? '成功' : '失敗'}`);
+  
+  if (validation.valid && confluenceCreated) {
+    console.log('\n🎉 設計フェーズが完了しました！');
+    console.log('📢 PMや部長にConfluenceでレビューを依頼してください');
+    if (confluenceUrl) {
+      console.log(`📄 Confluence: ${confluenceUrl}`);
+    } else {
+      const baseUrl = process.env.ATLASSIAN_URL || 'https://your-site.atlassian.net';
+      console.log(`📄 Confluence: ${baseUrl}/wiki/spaces/（URLは上記のログを参照）`);
+    }
+  }
+  
+  return {
+    phase: 'design',
+    success: validation.valid && confluenceCreated,
+    confluenceCreated,
+    jiraCreated: false,
+    validationPassed: validation.valid,
+    errors
+  };
+}
+
+/**
+ * タスク分割フェーズを実行
+ */
+async function runTasksPhase(feature: string): Promise<PhaseRunResult> {
+  console.log('\n📝 Phase: Tasks（タスク分割）');
+  console.log('='.repeat(60));
+  
+  const errors: string[] = [];
+  let jiraCreated = false;
+  
+  // Step 0: プリフライトチェック
+  console.log('\n🔍 プリフライトチェック...');
+  const preFlightResult = await runPreFlightCheck('jira');
+  
+  if (!preFlightResult.valid) {
+    console.log('\n❌ プリフライトチェック失敗:');
+    preFlightResult.errors.forEach(e => console.log(`  ${e}`));
+    return {
+      phase: 'tasks',
+      success: false,
+      confluenceCreated: false,
+      jiraCreated: false,
+      validationPassed: false,
+      errors: preFlightResult.errors
+    };
+  }
+  
+  console.log('✅ プリフライトチェック成功');
+  
+  // Step 1: tasks.md存在確認
+  const tasksPath = join(process.cwd(), '.kiro', 'specs', feature, 'tasks.md');
+  if (!existsSync(tasksPath)) {
+    errors.push('tasks.mdが存在しません。先に/kiro:spec-tasks を実行してください');
+    return {
+      phase: 'tasks',
+      success: false,
+      confluenceCreated: false,
+      jiraCreated: false,
+      validationPassed: false,
+      errors
+    };
+  }
+  
+  console.log('✅ tasks.md 存在確認');
+  
+  // Step 2: JIRA Epic/Story作成
+  console.log('\n📤 JIRA Epic/Story作成中...');
+  try {
+    await syncTasksToJIRA(feature);
+    jiraCreated = true;
+    console.log('✅ JIRA Epic/Story作成成功');
+  } catch (error: any) {
+    errors.push(`JIRA作成失敗: ${error.message}`);
+    console.error('❌ JIRA作成失敗:', error.message);
+  }
+  
+  // Step 3: バリデーション
+  console.log('\n🔍 バリデーション実行中...');
+  const validation = validatePhase(feature, 'tasks');
+  errors.push(...validation.errors);
+  
+  // Step 4: 結果サマリー
+  console.log('\n' + '='.repeat(60));
+  console.log('📊 タスク分割フェーズ完了チェック:');
+  console.log('  ✅ tasks.md: 作成済み');
+  console.log(`  ${jiraCreated ? '✅' : '❌'} JIRA Epic/Story: ${jiraCreated ? '作成済み' : '未作成'}`);
+  console.log(`  ${validation.valid ? '✅' : '❌'} バリデーション: ${validation.valid ? '成功' : '失敗'}`);
+  
+  if (validation.valid && jiraCreated) {
+    console.log('\n🎉 タスク分割フェーズが完了しました！');
+    console.log('📢 開発チームに実装開始を通知してください');
+    console.log('🚀 次のステップ: /kiro:spec-impl <feature>');
+  }
+  
+  return {
+    phase: 'tasks',
+    success: validation.valid && jiraCreated,
+    confluenceCreated: false,
+    jiraCreated,
+    validationPassed: validation.valid,
+    errors
+  };
+}
+
+/**
+ * フェーズを実行
+ */
+export async function runPhase(feature: string, phase: Phase): Promise<PhaseRunResult> {
+  // feature名のバリデーション（必須）
+  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}`);
+  }
+}
+
+// CLI実行
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const args = process.argv.slice(2);
+  
+  if (args.length < 2) {
+    console.error('Usage: npm run phase:run <feature> <phase>');
+    console.error('Example: npm run phase:run calculator-app requirements');
+    console.error('Phases: requirements, design, tasks');
+    process.exit(1);
+  }
+  
+  const [feature, phase] = args;
+  
+  if (!['requirements', 'design', 'tasks'].includes(phase)) {
+    console.error('Invalid phase. Must be: requirements, design, or tasks');
+    process.exit(1);
+  }
+  
+  runPhase(feature, phase as Phase)
+    .then((result) => {
+      if (result.success) {
+        console.log('\n✅ フェーズ完了');
+        process.exit(0);
+      } else {
+        console.log('\n❌ フェーズ未完了（エラーを確認してください）');
+        process.exit(1);
+      }
+    })
+    .catch((error) => {
+      console.error(`\n❌ フェーズ実行エラー: ${error.message}`);
+      process.exit(1);
+    });
+}
+

package/scripts/pr-automation.ts

@@ -0,0 +1,67 @@
+/**
+ * GitHub PR自動化スクリプト
+ */
+
+import { Octokit } from '@octokit/rest';
+import { config } from 'dotenv';
+import { loadProjectMeta } from './utils/project-meta.js';
+
+config();
+
+interface PROptions {
+  branch: string;
+  title: string;
+  body: string;
+  base?: string;
+}
+
+async function createPR(options: PROptions): Promise<void> {
+  const token = process.env.GITHUB_TOKEN;
+  const repo = process.env.GITHUB_REPO;
+  
+  if (!token || !repo) {
+    throw new Error('Missing GitHub credentials');
+  }
+  
+  const [owner, repoName] = repo.split('/');
+  const octokit = new Octokit({ auth: token });
+  
+  const { branch, title, body, base = 'main' } = options;
+  
+  console.log(`Creating PR: ${title}`);
+  
+  const pr = await octokit.pulls.create({
+    owner,
+    repo: repoName,
+    title,
+    body,
+    head: branch,
+    base
+  });
+  
+  console.log(`✅ PR created: ${pr.data.html_url}`);
+}
+
+// CLI実行
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const args = process.argv.slice(2);
+  
+  if (args.length === 0) {
+    console.error('Usage: npm run github:create-pr <branch> [title]');
+    process.exit(1);
+  }
+  
+  const branch = args[0];
+  const title = args[1] || `feat: ${branch}`;
+  const body = 'Auto-generated PR';
+  
+  createPR({ branch, title, body })
+    .then(() => process.exit(0))
+    .catch((error) => {
+      console.error('❌ PR creation failed:', error.message);
+      process.exit(1);
+    });
+}
+
+export { createPR };
+

package/scripts/pre-flight-check.ts

@@ -0,0 +1,285 @@
+/**
+ * プリフライトチェック
+ * スクリプト実行前に必要な設定が揃っているか確認
+ */
+
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import axios from 'axios';
+import { config } from 'dotenv';
+
+config();
+
+interface PreFlightResult {
+  valid: boolean;
+  errors: string[];
+  warnings: string[];
+}
+
+/**
+ * .env設定をチェック
+ */
+function checkEnvConfig(): { errors: string[], warnings: string[] } {
+  const errors: string[] = [];
+  const warnings: string[] = [];
+  
+  // .envファイル存在チェック
+  if (!existsSync('.env')) {
+    errors.push('❌ .envファイルが存在しません');
+    errors.push('   → テンプレートからコピー: cp .env.example .env');
+    errors.push('   → 編集: vim .env（認証情報を設定）');
+    errors.push('   → API Token取得: https://id.atlassian.com/manage-profile/security/api-tokens');
+    return { errors, warnings };
+  }
+  
+  // 必須環境変数チェック
+  const required = [
+    'ATLASSIAN_URL',
+    'ATLASSIAN_EMAIL',
+    'ATLASSIAN_API_TOKEN'
+  ];
+  
+  const missing = required.filter(key => !process.env[key]);
+  
+  if (missing.length > 0) {
+    errors.push(`❌ .envに必須項目が設定されていません: ${missing.join(', ')}`);
+    errors.push('   → 編集: vim .env');
+    errors.push('   → API Token取得: https://id.atlassian.com/manage-profile/security/api-tokens');
+    errors.push('');
+    errors.push('   必須項目:');
+    errors.push('     ATLASSIAN_URL=https://your-site.atlassian.net');
+    errors.push('     ATLASSIAN_EMAIL=your-email@example.com');
+    errors.push('     ATLASSIAN_API_TOKEN=your-api-token');
+  }
+  
+  // オプション環境変数の警告
+  if (!process.env.CONFLUENCE_PRD_SPACE) {
+    warnings.push('⚠️  CONFLUENCE_PRD_SPACEが未設定（デフォルト: PRD）');
+    warnings.push(`   → スペース一覧: ${process.env.ATLASSIAN_URL}/wiki/spaces`);
+  }
+  
+  return { errors, warnings };
+}
+
+/**
+ * project.jsonをチェック
+ */
+function checkProjectJson(): { errors: string[], warnings: string[] } {
+  const errors: string[] = [];
+  const warnings: string[] = [];
+  
+  const projectJsonPath = join(process.cwd(), '.kiro', 'project.json');
+  
+  if (!existsSync(projectJsonPath)) {
+    errors.push('❌ .kiro/project.json が存在しません');
+    errors.push('   → このディレクトリはMichiプロジェクトではありません');
+    errors.push('   → セットアップ: npm run setup-existing（michi-practice1の場合）');
+    errors.push('   → または、Michiプロジェクトのディレクトリに移動してください');
+    return { errors, warnings };
+  }
+  
+  let projectMeta: any;
+  try {
+    projectMeta = JSON.parse(readFileSync(projectJsonPath, 'utf-8'));
+  } catch (error) {
+    errors.push('❌ project.json のパースに失敗しました');
+    return { errors, warnings };
+  }
+  
+  // 必須フィールドチェック
+  const required = ['projectId', 'projectName', 'jiraProjectKey'];
+  const missing = required.filter(key => !projectMeta[key]);
+  
+  if (missing.length > 0) {
+    errors.push(`❌ project.jsonに必須項目がありません: ${missing.join(', ')}`);
+  }
+  
+  return { errors, warnings };
+}
+
+/**
+ * Confluenceスペース存在チェック（API呼び出し）
+ */
+async function checkConfluenceSpace(spaceKey: string): Promise<{ errors: string[], warnings: string[] }> {
+  const errors: string[] = [];
+  const warnings: string[] = [];
+  
+  const url = process.env.ATLASSIAN_URL;
+  const email = process.env.ATLASSIAN_EMAIL;
+  const apiToken = process.env.ATLASSIAN_API_TOKEN;
+  
+  if (!url || !email || !apiToken) {
+    errors.push('❌ .env設定が不完全なため、Confluenceスペースチェックをスキップ');
+    return { errors, warnings };
+  }
+  
+  try {
+    const auth = Buffer.from(`${email}:${apiToken}`).toString('base64');
+    const response = await axios.get(`${url}/wiki/rest/api/space/${spaceKey}`, {
+      headers: {
+        'Authorization': `Basic ${auth}`,
+        'Content-Type': 'application/json'
+      }
+    });
+    
+    if (response.data) {
+      console.log(`  ✅ Confluenceスペース確認: ${spaceKey} (${response.data.name})`);
+    }
+  } catch (error: any) {
+    if (error.response?.status === 404) {
+      errors.push(`❌ Confluenceスペースが存在しません: ${spaceKey}`);
+      errors.push(`   → Confluenceで新しいスペースを作成: ${url}/wiki/spaces`);
+      errors.push('   → または、.envのCONFLUENCE_PRD_SPACEを修正してください');
+    } else if (error.response?.status === 401) {
+      errors.push('❌ Confluence認証エラー（.envの認証情報を確認）');
+      errors.push(`   → API Token管理: ${url.replace('atlassian.net', 'atlassian.net/manage/profile/security/api-tokens')}`);
+    } else {
+      warnings.push(`⚠️  Confluenceスペースチェック失敗: ${error.message}`);
+    }
+  }
+  
+  return { errors, warnings };
+}
+
+/**
+ * JIRAプロジェクト存在チェック（API呼び出し）
+ */
+async function checkJiraProject(projectKey: string): Promise<{ errors: string[], warnings: string[] }> {
+  const errors: string[] = [];
+  const warnings: string[] = [];
+  
+  const url = process.env.ATLASSIAN_URL;
+  const email = process.env.ATLASSIAN_EMAIL;
+  const apiToken = process.env.ATLASSIAN_API_TOKEN;
+  
+  if (!url || !email || !apiToken) {
+    errors.push('❌ .env設定が不完全なため、JIRAプロジェクトチェックをスキップ');
+    return { errors, warnings };
+  }
+  
+  try {
+    const auth = Buffer.from(`${email}:${apiToken}`).toString('base64');
+    const response = await axios.get(`${url}/rest/api/3/project/${projectKey}`, {
+      headers: {
+        'Authorization': `Basic ${auth}`,
+        'Content-Type': 'application/json'
+      }
+    });
+    
+    if (response.data) {
+      console.log(`  ✅ JIRAプロジェクト確認: ${projectKey} (${response.data.name})`);
+    }
+  } catch (error: any) {
+    if (error.response?.status === 404) {
+      errors.push(`❌ JIRAプロジェクトが存在しません: ${projectKey}`);
+      errors.push(`   → JIRAプロジェクト作成: ${url}/jira/projects/create`);
+      errors.push(`   → プロジェクト一覧: ${url}/jira/settings/projects`);
+      errors.push('   → または、.kiro/project.jsonのjiraProjectKeyを修正してください');
+      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`);
+    } else {
+      warnings.push(`⚠️  JIRAプロジェクトチェック失敗: ${error.message}`);
+    }
+  }
+  
+  return { errors, warnings };
+}
+
+/**
+ * プリフライトチェック実行
+ */
+export async function runPreFlightCheck(phase: 'confluence' | 'jira' | 'all'): Promise<PreFlightResult> {
+  console.log('\n🔍 プリフライトチェック実行中...\n');
+  
+  const allErrors: string[] = [];
+  const allWarnings: string[] = [];
+  
+  // 1. .env設定チェック
+  console.log('📋 Step 1: .env設定チェック');
+  const envCheck = checkEnvConfig();
+  allErrors.push(...envCheck.errors);
+  allWarnings.push(...envCheck.warnings);
+  
+  if (envCheck.errors.length === 0) {
+    console.log('  ✅ .env設定OK');
+  }
+  
+  // 2. project.jsonチェック
+  console.log('\n📋 Step 2: project.json設定チェック');
+  const projectCheck = checkProjectJson();
+  allErrors.push(...projectCheck.errors);
+  allWarnings.push(...projectCheck.warnings);
+  
+  if (projectCheck.errors.length === 0) {
+    console.log('  ✅ project.json設定OK');
+  }
+  
+  // .envまたはproject.jsonエラーがあれば、ここで中断
+  if (allErrors.length > 0) {
+    return { valid: false, errors: allErrors, warnings: allWarnings };
+  }
+  
+  // 3. Confluenceスペースチェック（API呼び出し）
+  if (phase === 'confluence' || phase === 'all') {
+    console.log('\n📋 Step 3: Confluenceスペース存在チェック');
+    const spaceKey = process.env.CONFLUENCE_PRD_SPACE || 'PRD';
+    const spaceCheck = await checkConfluenceSpace(spaceKey);
+    allErrors.push(...spaceCheck.errors);
+    allWarnings.push(...spaceCheck.warnings);
+  }
+  
+  // 4. JIRAプロジェクトチェック（API呼び出し）
+  if (phase === 'jira' || phase === 'all') {
+    console.log('\n📋 Step 4: JIRAプロジェクト存在チェック');
+    const projectJsonPath = join(process.cwd(), '.kiro', 'project.json');
+    const projectMeta = JSON.parse(readFileSync(projectJsonPath, 'utf-8'));
+    const jiraCheck = await checkJiraProject(projectMeta.jiraProjectKey);
+    allErrors.push(...jiraCheck.errors);
+    allWarnings.push(...jiraCheck.warnings);
+  }
+  
+  return {
+    valid: allErrors.length === 0,
+    errors: allErrors,
+    warnings: allWarnings
+  };
+}
+
+// CLI実行
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const args = process.argv.slice(2);
+  const phase = (args[0] as 'confluence' | 'jira' | 'all') || 'all';
+  
+  if (!['confluence', 'jira', 'all'].includes(phase)) {
+    console.error('Usage: npm run preflight [confluence|jira|all]');
+    process.exit(1);
+  }
+  
+  runPreFlightCheck(phase)
+    .then((result) => {
+      console.log('\n' + '='.repeat(60));
+      
+      if (result.warnings.length > 0) {
+        console.log('\n⚠️  警告:');
+        result.warnings.forEach(w => console.log(`  ${w}`));
+      }
+      
+      if (result.errors.length > 0) {
+        console.log('\n❌ エラー:');
+        result.errors.forEach(e => console.log(`  ${e}`));
+        console.log('\n❌ プリフライトチェック失敗');
+        process.exit(1);
+      } else {
+        console.log('\n✅ プリフライトチェック成功');
+        console.log('   すべての設定が正しく構成されています');
+        process.exit(0);
+      }
+    })
+    .catch((error) => {
+      console.error(`\n❌ チェックエラー: ${error.message}`);
+      process.exit(1);
+    });
+}
+