@sk8metal/michi-cli 0.14.1 → 0.19.0

package/scripts/utils/types/validation.ts

@@ -0,0 +1,92 @@
+/**
+ * 共通 ValidationResult 型定義
+ *
+ * すべてのバリデーション結果を統一的に扱うための Result 型。
+ * Result<T, E> パターンを採用し、型安全性を向上。
+ */
+
+/**
+ * Result<T, E> 型
+ *
+ * @template T - 成功時の値の型
+ * @template E - エラーの型（デフォルトは string）
+ */
+export interface Result<T, E = string> {
+  /**
+   * バリデーションが成功したかどうか
+   */
+  success: boolean;
+
+  /**
+   * 成功時の値（失敗時は undefined）
+   */
+  value: T | undefined;
+
+  /**
+   * エラーメッセージの配列
+   */
+  errors: E[];
+
+  /**
+   * 警告メッセージの配列
+   */
+  warnings: E[];
+}
+
+/**
+ * 成功結果を作成するヘルパー関数
+ */
+export function success<T, E = string>(value: T, warnings: E[] = []): Result<T, E> {
+  return {
+    success: true,
+    value,
+    errors: [],
+    warnings
+  };
+}
+
+/**
+ * 失敗結果を作成するヘルパー関数
+ */
+export function failure<T, E = string>(errors: E[], warnings: E[] = []): Result<T, E> {
+  return {
+    success: false,
+    value: undefined,
+    errors,
+    warnings
+  };
+}
+
+/**
+ * 旧 ValidationResult 互換型（移行期間用）
+ *
+ * @deprecated Use Result<boolean, string> instead
+ */
+export interface LegacyValidationResult {
+  valid: boolean;
+  errors: string[];
+  warnings?: string[];
+}
+
+/**
+ * 旧 ValidationResult を Result に変換
+ */
+export function fromLegacy(legacy: LegacyValidationResult): Result<boolean, string> {
+  return {
+    success: legacy.valid,
+    value: legacy.valid,
+    errors: legacy.errors,
+    warnings: legacy.warnings || []
+  };
+}
+
+/**
+ * Result を 旧 ValidationResult に変換
+ */
+export function toLegacy(result: Result<boolean, string>): LegacyValidationResult {
+  return {
+    valid: result.success,
+    errors: result.errors,
+    warnings: result.warnings
+  };
+}

package/scripts/validate-phase.ts

@@ -3,7 +3,8 @@
  * 各フェーズで必須項目が完了しているかチェック
  */
 
-import { existsSync, readFileSync } from 'fs';
+import { existsSync } from 'fs';
+import { safeReadFileOrThrow, safeReadJsonFile } from './utils/safe-file-reader.js';
 import { join } from 'path';
 import { validateFeatureName } from './utils/feature-name-validator.js';
 import { loadConfig } from './utils/config-loader.js';
@@ -17,9 +18,14 @@ type Phase =
   | 'phase-a'
   | 'phase-b';
 
+/**
+ * Phase validation result type
+ * Based on Result<T, E> pattern but specialized for phase validation
+ */
 interface ValidationResult {
   phase: Phase;
-  valid: boolean;
+  success: boolean;
+  value: void;
   errors: string[];
   warnings: string[];
 }
@@ -29,12 +35,22 @@ interface ValidationResult {
  */
 function loadSpecJson(feature: string): SpecJson {
   const specPath = join(process.cwd(), '.kiro', 'specs', feature, 'spec.json');
-  
+
   if (!existsSync(specPath)) {
     throw new Error(`spec.json not found: ${specPath}`);
   }
-  
-  return JSON.parse(readFileSync(specPath, 'utf-8'));
+
+  const result = safeReadJsonFile<SpecJson>(specPath);
+
+  if (!result.success) {
+    const errorType = result.errors[0].type;
+    const errorMsg = errorType === 'InvalidJSON'
+      ? `Invalid JSON: ${result.errors[0].cause}`
+      : errorType;
+    throw new Error(`spec.json読み込みエラー: ${errorMsg}`);
+  }
+
+  return result.value!;
 }
 
 /**
@@ -46,7 +62,7 @@ function validateRequirements(feature: string): ValidationResult {
   
   // 0. feature名のバリデーション
   const nameValidation = validateFeatureName(feature);
-  if (!nameValidation.valid) {
+  if (!nameValidation.success) {
     errors.push(...nameValidation.errors);
   }
   
@@ -63,7 +79,7 @@ function validateRequirements(feature: string): ValidationResult {
   } catch (error: unknown) {
     const message = error instanceof Error ? error.message : String(error);
     errors.push(`❌ spec.json読み込みエラー: ${message}`);
-    return { phase: 'requirements', valid: false, errors, warnings };
+    return { phase: 'requirements', success: false, value: undefined, errors, warnings };
   }
   
   // 3. Confluenceページ作成チェック（必須）
@@ -84,7 +100,8 @@ function validateRequirements(feature: string): ValidationResult {
   
   return {
     phase: 'requirements',
-    valid: errors.length === 0,
+    success: errors.length === 0,
+    value: undefined,
     errors,
     warnings
   };
@@ -99,7 +116,7 @@ function validateDesign(feature: string): ValidationResult {
   
   // 0. feature名のバリデーション
   const nameValidation = validateFeatureName(feature);
-  if (!nameValidation.valid) {
+  if (!nameValidation.success) {
     errors.push(...nameValidation.errors);
   }
   
@@ -116,7 +133,7 @@ function validateDesign(feature: string): ValidationResult {
   } catch (error: unknown) {
     const message = error instanceof Error ? error.message : String(error);
     errors.push(`❌ spec.json読み込みエラー: ${message}`);
-    return { phase: 'design', valid: false, errors, warnings };
+    return { phase: 'design', success: false, value: undefined, errors, warnings };
   }
   
   // 3. 前提: 要件定義完了チェック
@@ -137,7 +154,8 @@ function validateDesign(feature: string): ValidationResult {
   
   return {
     phase: 'design',
-    valid: errors.length === 0,
+    success: errors.length === 0,
+    value: undefined,
     errors,
     warnings
   };
@@ -152,7 +170,7 @@ function validateTasks(feature: string): ValidationResult {
   
   // 0. feature名のバリデーション
   const nameValidation = validateFeatureName(feature);
-  if (!nameValidation.valid) {
+  if (!nameValidation.success) {
     errors.push(...nameValidation.errors);
   }
   
@@ -171,7 +189,13 @@ function validateTasks(feature: string): ValidationResult {
     }
 
     // 営業日表記チェック（設定で無効化可能）
-    const tasksContent = readFileSync(tasksPath, 'utf-8');
+    let tasksContent: string;
+    try {
+      tasksContent = safeReadFileOrThrow(tasksPath);
+    } catch (_error) {
+      errors.push('❌ tasks.md の読み込みに失敗しました');
+      return { phase: 'tasks', success: false, value: undefined, errors, warnings };
+    }
 
     if (config.validation?.weekdayNotation !== false) {
       // 日本語または英語の曜日表記をチェック
@@ -198,7 +222,7 @@ function validateTasks(feature: string): ValidationResult {
   } catch (error: unknown) {
     const message = error instanceof Error ? error.message : String(error);
     errors.push(`❌ spec.json読み込みエラー: ${message}`);
-    return { phase: 'tasks', valid: false, errors, warnings };
+    return { phase: 'tasks', success: false, value: undefined, errors, warnings };
   }
   
   // 3. 前提: 設計完了チェック
@@ -236,7 +260,8 @@ function validateTasks(feature: string): ValidationResult {
   
   return {
     phase: 'tasks',
-    valid: errors.length === 0,
+    success: errors.length === 0,
+    value: undefined,
     errors,
     warnings
   };
@@ -253,7 +278,7 @@ function validateEnvironmentSetup(feature: string): ValidationResult {
 
   // feature名のバリデーション
   const nameValidation = validateFeatureName(feature);
-  if (!nameValidation.valid) {
+  if (!nameValidation.success) {
     errors.push(...nameValidation.errors);
   }
 
@@ -261,7 +286,8 @@ function validateEnvironmentSetup(feature: string): ValidationResult {
 
   return {
     phase: 'environment-setup',
-    valid: errors.length === 0,
+    success: errors.length === 0,
+    value: undefined,
     errors,
     warnings
   };
@@ -277,7 +303,7 @@ function validatePhaseA(feature: string): ValidationResult {
 
   // feature名のバリデーション
   const nameValidation = validateFeatureName(feature);
-  if (!nameValidation.valid) {
+  if (!nameValidation.success) {
     errors.push(...nameValidation.errors);
   }
 
@@ -285,7 +311,8 @@ function validatePhaseA(feature: string): ValidationResult {
 
   return {
     phase: 'phase-a',
-    valid: errors.length === 0,
+    success: errors.length === 0,
+    value: undefined,
     errors,
     warnings
   };
@@ -301,7 +328,7 @@ function validatePhaseB(feature: string): ValidationResult {
 
   // feature名のバリデーション
   const nameValidation = validateFeatureName(feature);
-  if (!nameValidation.valid) {
+  if (!nameValidation.success) {
     errors.push(...nameValidation.errors);
   }
 
@@ -309,7 +336,8 @@ function validatePhaseB(feature: string): ValidationResult {
 
   return {
     phase: 'phase-b',
-    valid: errors.length === 0,
+    success: errors.length === 0,
+    value: undefined,
     errors,
     warnings
   };
@@ -359,7 +387,7 @@ export function validatePhase(feature: string, phase: Phase): ValidationResult {
     result.warnings.forEach(warn => console.log(`  ${warn}`));
   }
   
-  if (result.valid) {
+  if (result.success) {
     console.log('\n✅ バリデーション成功: すべての必須項目が完了しています');
   } else {
     console.log('\n❌ バリデーション失敗: 上記のエラーを修正してください');
@@ -405,7 +433,7 @@ if (import.meta.url === `file://${process.argv[1]}`) {
   
   try {
     const result = validatePhase(feature, phase as Phase);
-    process.exit(result.valid ? 0 : 1);
+    process.exit(result.success ? 0 : 1);
   } catch (error: unknown) {
     const message = error instanceof Error ? error.message : String(error);
     console.error(`\n❌ Validation error: ${message}`);

package/scripts/workflow-orchestrator.ts

@@ -1,262 +1,29 @@
 /**
- * ワークフローオーケストレーター
- * AI開発フロー全体を統合実行
+ * ワークフローオーケストレーター - Entry Point
+ * The actual logic has been moved to src/presentation/commands/workflow/
  */
 
 import { loadEnv } from './utils/env-loader.js';
-import { loadProjectMeta } from './utils/project-meta.js';
-import { syncToConfluence, getConfluenceConfig } from './confluence-sync.js';
-import { syncTasksToJIRA } from './jira-sync.js';
-import { analyzeLanguage } from './utils/language-detector.js';
-import { executeTests, generateTestReport } from './utils/test-runner.js';
-import { createReleaseNotes } from './utils/release-notes-generator.js';
-import { pollForApproval, waitForManualApproval } from './utils/confluence-approval.js';
+import {
+  WorkflowOrchestrator,
+  workflowRunCommand,
+  type WorkflowConfig,
+  type WorkflowStage,
+} from '../src/presentation/commands/workflow/orchestrator.js';
 
 loadEnv();
 
-export interface WorkflowConfig {
-  feature: string;
-  stages: WorkflowStage[];
-  approvalGates?: {
-    requirements?: string[];
-    design?: string[];
-    release?: string[];
-  };
-}
-
-export type WorkflowStage =
-  | 'requirements'
-  | 'design'
-  | 'tasks'
-  | 'implement'
-  | 'test'
-  | 'release';
-
-export class WorkflowOrchestrator {
-  private config: WorkflowConfig;
-  
-  constructor(config: WorkflowConfig) {
-    this.config = config;
-  }
-  
-  /**
-   * ワークフロー全体を実行
-   */
-  async run(): Promise<void> {
-    console.log(`🚀 Starting workflow for: ${this.config.feature}`);
-    console.log(`Stages: ${this.config.stages.join(' → ')}`);
-    
-    const projectMeta = loadProjectMeta();
-    console.log(`Project: ${projectMeta.projectName}`);
-    
-    for (const stage of this.config.stages) {
-      console.log(`\n📋 Stage: ${stage}`);
-      
-      try {
-        await this.executeStage(stage);
-        
-        // 承認ゲートチェック
-        if (this.hasApprovalGate(stage)) {
-          await this.waitForApproval(stage);
-        }
-        
-        console.log(`✅ Stage completed: ${stage}`);
-      } catch (error: unknown) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(`❌ Stage failed: ${stage}`, message);
-        throw error;
-      }
-    }
-    
-    console.log('\n🎉 Workflow completed successfully!');
-  }
-  
-  /**
-   * 各ステージを実行
-   */
-  private async executeStage(stage: WorkflowStage): Promise<void> {
-    switch (stage) {
-    case 'requirements':
-      console.log('  Syncing requirements to Confluence...');
-      await syncToConfluence(this.config.feature, 'requirements');
-      break;
-        
-    case 'design':
-      console.log('  Syncing design to Confluence...');
-      await syncToConfluence(this.config.feature, 'design');
-      break;
-        
-    case 'tasks':
-      console.log('  Creating JIRA tasks...');
-      await syncTasksToJIRA(this.config.feature);
-      break;
-        
-    case 'implement':
-      console.log('  Implementation phase - manual step');
-      console.log('  Use: /kiro:spec-impl <feature> <tasks>');
-      break;
-        
-    case 'test':
-      console.log('  Test phase - execute tests');
-      await this.executeTestPhase();
-      break;
-
-    case 'release':
-      console.log('  Release preparation');
-      await this.executeReleasePhase();
-      break;
-    }
-  }
-  
-  /**
-   * 承認ゲートがあるかチェック
-   */
-  private hasApprovalGate(stage: WorkflowStage): boolean {
-    const gates = this.config.approvalGates;
-    if (!gates) return false;
-    
-    const gateList =
-      stage === 'requirements' ? gates.requirements :
-        stage === 'design' ? gates.design :
-          stage === 'release' ? gates.release :
-            undefined;
-
-    return Array.isArray(gateList) && gateList.length > 0;
-  }
-  
-  /**
-   * テストフェーズを実行
-   */
-  private async executeTestPhase(): Promise<void> {
-    // プロジェクトの言語を検出
-    const languageInfo = analyzeLanguage(this.config.feature);
-    console.log(`  Detected language: ${languageInfo.language} (${languageInfo.confidence} confidence)`);
-
-    // テストを実行
-    console.log('  Running tests...');
-    const testResult = await executeTests(languageInfo.language);
-
-    // レポートを生成
-    const report = generateTestReport(testResult, this.config.feature);
-
-    // Confluenceにレポートをアップロード
-    try {
-      // レポートをConfluenceに同期（テスト用のページとして）
-      console.log('  Uploading test report to Confluence...');
-
-      // テストレポートをファイルに保存
-      const { writeFileSync, mkdirSync } = await import('fs');
-      const { resolve } = await import('path');
-      const reportDir = resolve(`.kiro/specs/${this.config.feature}`);
-      mkdirSync(reportDir, { recursive: true });
-      const reportPath = resolve(reportDir, 'test-report.md');
-      writeFileSync(reportPath, report, 'utf-8');
-
-      console.log(`  ✅ Test report saved: ${reportPath}`);
-
-      if (!testResult.success) {
-        throw new Error('Tests failed. Please fix the issues before proceeding.');
-      }
-    } catch (error: unknown) {
-      const message = error instanceof Error ? error.message : String(error);
-      console.error('  ❌ Test execution failed:', message);
-      throw error;
-    }
-  }
-
-  /**
-   * リリースフェーズを実行
-   */
-  private async executeReleasePhase(): Promise<void> {
-    // リリースバージョンを決定（環境変数またはデフォルト）
-    const version = process.env.RELEASE_VERSION || 'v1.0.0';
-
-    console.log(`  Generating release notes for ${version}...`);
-
-    // リリースノートを生成
-    const releaseNotes = await createReleaseNotes(version);
-
-    // リリースノートをファイルに保存
-    const { writeFileSync, mkdirSync } = await import('fs');
-    const { resolve } = await import('path');
-    const releaseDir = resolve(`.kiro/specs/${this.config.feature}`);
-    mkdirSync(releaseDir, { recursive: true });
-    const releaseNotesPath = resolve(releaseDir, `release-notes-${version}.md`);
-    writeFileSync(releaseNotesPath, releaseNotes, 'utf-8');
-
-    console.log(`  ✅ Release notes saved: ${releaseNotesPath}`);
-
-    // JIRA Releaseを作成
-    try {
-      console.log('  Creating JIRA Release...');
-
-      // JIRA Release作成APIを呼び出し
-      // Note: JIRAClientにcreateVersionメソッドを追加する必要があります
-      console.log('  ℹ️  JIRA Release creation is pending JIRAClient enhancement');
-      console.log(`  📋 Manual action required: Create release ${version} in JIRA`);
-      console.log(`  📄 Release notes: ${releaseNotesPath}`);
-    } catch (error: unknown) {
-      const message = error instanceof Error ? error.message : String(error);
-      console.warn('  ⚠️  Failed to create JIRA Release:', message);
-      console.log('  📋 Please create the release manually in JIRA');
-    }
-  }
-
-  /**
-   * 承認を待つ
-   */
-  private async waitForApproval(stage: WorkflowStage): Promise<void> {
-    console.log(`\n⏸️  Approval required for: ${stage}`);
-
-    const approvers = this.config.approvalGates?.[stage as keyof typeof this.config.approvalGates];
-    if (approvers) {
-      console.log(`  Approvers: ${approvers.join(', ')}`);
-    }
-
-    console.log('  ✅ Confluence で承認してください');
-    console.log('  ⏳ 承認完了後、次のステージに進みます');
-
-    // Confluence自動ポーリングが有効な場合
-    if (process.env.CONFLUENCE_AUTO_POLL === 'true') {
-      try {
-        const confluenceConfig = getConfluenceConfig();
-
-        // TODO: ステージに応じたページIDを取得する必要があります
-        // 現在は環境変数から取得
-        const pageId = process.env.CONFLUENCE_APPROVAL_PAGE_ID;
-
-        if (!pageId) {
-          console.log('  ℹ️  CONFLUENCE_APPROVAL_PAGE_ID not set, falling back to manual approval');
-          waitForManualApproval('', approvers || []);
-          return;
-        }
-
-        console.log('  🔄 Polling for approval...');
-        const status = await pollForApproval(pageId, confluenceConfig);
-
-        console.log(`  ✅ Approved by: ${status.approvers.join(', ')}`);
-      } catch (error: unknown) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error('  ❌ Approval polling failed:', message);
-        throw error;
-      }
-    } else {
-      // 手動承認
-      waitForManualApproval('', approvers || []);
-      console.log('  （手動で承認を確認してください）');
-    }
-  }
-}
+export { WorkflowOrchestrator, workflowRunCommand, type WorkflowConfig, type WorkflowStage };
 
 // CLI実行
 if (import.meta.url === `file://${process.argv[1]}`) {
   const args = process.argv.slice(2);
-  
+
   if (args.length === 0) {
     console.error('Usage: npm run workflow:run -- --feature <feature_name>');
     process.exit(1);
   }
-  
+
   const featureIndex = args.indexOf('--feature');
   const feature = featureIndex >= 0 ? args[featureIndex + 1] : undefined;
 
@@ -264,20 +31,18 @@ if (import.meta.url === `file://${process.argv[1]}`) {
     console.error('Usage: npm run workflow:run -- --feature <feature_name>');
     process.exit(1);
   }
-  
+
   const workflowConfig: WorkflowConfig = {
     feature,
     stages: ['requirements', 'design', 'tasks', 'implement', 'test', 'release'],
     approvalGates: {
       requirements: ['企画', '部長'],
       design: ['アーキテクト', '部長'],
-      release: ['SM', '部長']
-    }
+      release: ['SM', '部長'],
+    },
   };
-  
-  const orchestrator = new WorkflowOrchestrator(workflowConfig);
-  
-  orchestrator.run()
+
+  workflowRunCommand(workflowConfig)
     .then(() => process.exit(0))
     .catch((error: unknown) => {
       const message = error instanceof Error ? error.message : String(error);

package/dist/scripts/mermaid-converter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mermaid-converter.d.ts","sourceRoot":"","sources":["../../scripts/mermaid-converter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B;;;;;OAKG;IACH,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IA8BpD;;;;;OAKG;IACH,OAAO,CAAC,WAAW;CAIpB"}

package/dist/scripts/mermaid-converter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mermaid-converter.js","sourceRoot":"","sources":["../../scripts/mermaid-converter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;;;;OAKG;IACH,0BAA0B,CAAC,QAAgB;QACzC,uBAAuB;QACvB,8BAA8B;QAC9B,MAAM,iBAAiB,GAAG,4BAA4B,CAAC;QAEvD,iBAAiB;QACjB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAEjE,wBAAwB;QACxB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,mCAAmC;QACnC,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YACvE,WAAW;YACX,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAEtC,yBAAyB;YACzB,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;YAExD,qBAAqB;YACrB,OAAO;iCACoB,cAAc;uBACxB,CAAC;QACpB,CAAC,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACK,WAAW,CAAC,IAAY;QAC9B,mCAAmC;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/scripts/resource-dashboard.d.ts

@@ -1,7 +0,0 @@
-/**
- * リソースダッシュボード生成
- * プロジェクト横断のリソース管理ダッシュボードをConfluenceに作成
- */
-declare function createResourceDashboard(): Promise<void>;
-export { createResourceDashboard };
-//# sourceMappingURL=resource-dashboard.d.ts.map

package/dist/scripts/resource-dashboard.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resource-dashboard.d.ts","sourceRoot":"","sources":["../../scripts/resource-dashboard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6BH,iBAAe,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4ItD;AAeD,OAAO,EAAE,uBAAuB,EAAE,CAAC"}