@sk8metal/michi-cli 0.3.0 → 0.5.0

package/scripts/utils/test-runner.ts

@@ -53,15 +53,16 @@ export async function executeTests(
       duration,
       timestamp
     };
-  } catch (error: any) {
+  } catch (error: unknown) {
     const duration = (Date.now() - startTime) / 1000;
+    const errorObj = error as { stdout?: string; message?: string };
 
     return {
       success: false,
       language,
       command,
-      output: error.stdout || '',
-      error: error.message || String(error),
+      output: errorObj.stdout || '',
+      error: errorObj.message || String(error),
       duration,
       timestamp
     };

package/scripts/validate-phase.ts

@@ -7,12 +7,11 @@ import { existsSync, readFileSync } from 'fs';
 import { join } from 'path';
 import { validateFeatureName } from './utils/feature-name-validator.js';
 import { loadConfig } from './utils/config-loader.js';
+import { type SpecJson } from './utils/spec-updater.js';
 
 type Phase =
   | 'requirements'
   | 'design'
-  | 'test-type-selection'
-  | 'test-spec'
   | 'tasks'
   | 'environment-setup'
   | 'phase-a'
@@ -28,7 +27,7 @@ interface ValidationResult {
 /**
  * spec.jsonを読み込み
  */
-function loadSpecJson(feature: string): any {
+function loadSpecJson(feature: string): SpecJson {
   const specPath = join(process.cwd(), '.kiro', 'specs', feature, 'spec.json');
   
   if (!existsSync(specPath)) {
@@ -58,11 +57,12 @@ function validateRequirements(feature: string): ValidationResult {
   }
   
   // 2. spec.json読み込み
-  let spec: any;
+  let spec: SpecJson;
   try {
     spec = loadSpecJson(feature);
-  } catch (error: any) {
-    errors.push(`❌ spec.json読み込みエラー: ${error.message}`);
+  } catch (error: unknown) {
+    const message = error instanceof Error ? error.message : String(error);
+    errors.push(`❌ spec.json読み込みエラー: ${message}`);
     return { phase: 'requirements', valid: false, errors, warnings };
   }
   
@@ -110,11 +110,12 @@ function validateDesign(feature: string): ValidationResult {
   }
   
   // 2. spec.json読み込み
-  let spec: any;
+  let spec: SpecJson;
   try {
     spec = loadSpecJson(feature);
-  } catch (error: any) {
-    errors.push(`❌ spec.json読み込みエラー: ${error.message}`);
+  } catch (error: unknown) {
+    const message = error instanceof Error ? error.message : String(error);
+    errors.push(`❌ spec.json読み込みエラー: ${message}`);
     return { phase: 'design', valid: false, errors, warnings };
   }
   
@@ -191,11 +192,12 @@ function validateTasks(feature: string): ValidationResult {
   }
   
   // 2. spec.json読み込み
-  let spec: any;
+  let spec: SpecJson;
   try {
     spec = loadSpecJson(feature);
-  } catch (error: any) {
-    errors.push(`❌ spec.json読み込みエラー: ${error.message}`);
+  } catch (error: unknown) {
+    const message = error instanceof Error ? error.message : String(error);
+    errors.push(`❌ spec.json読み込みエラー: ${message}`);
     return { phase: 'tasks', valid: false, errors, warnings };
   }
   
@@ -214,7 +216,7 @@ function validateTasks(feature: string): ValidationResult {
   // spec.jira.storyKeys 配列をチェック（新フォーマット）
   // または spec.jira.stories.created（旧フォーマット）をチェック
   const hasStories = spec.jira?.storyKeys && Array.isArray(spec.jira.storyKeys) && spec.jira.storyKeys.length > 0;
-  const hasLegacyStories = spec.jira?.stories && spec.jira.stories.created > 0;
+  const hasLegacyStories = spec.jira?.stories && spec.jira.stories.created !== undefined && spec.jira.stories.created > 0;
   
   if (!hasStories && !hasLegacyStories) {
     errors.push('❌ JIRA Storyが1つも作成されていません');
@@ -222,7 +224,7 @@ function validateTasks(feature: string): ValidationResult {
   } else if (spec.jira?.storyKeys && spec.jira.storyKeys.length > 0) {
     // 新フォーマット: storyKeys配列が存在する場合
     // 成功として扱う（警告なし）
-  } else if (spec.jira?.stories && spec.jira.stories.created < spec.jira.stories.total) {
+  } else if (spec.jira?.stories && spec.jira.stories.created !== undefined && spec.jira.stories.total !== undefined && spec.jira.stories.created < spec.jira.stories.total) {
     // 旧フォーマット: 一部未作成の場合のみ警告
     warnings.push(`⚠️  JIRA Storyが一部未作成: ${spec.jira.stories.created}/${spec.jira.stories.total}`);
   }
@@ -240,59 +242,6 @@ function validateTasks(feature: string): ValidationResult {
   };
 }
 
-/**
- * テストタイプ選択フェーズのバリデーション（Phase 0.3）
- * マニュアル対応フェーズ - バリデーション不要（常に成功）
- */
-function validateTestTypeSelection(feature: string): ValidationResult {
-  const errors: string[] = [];
-  const warnings: string[] = [];
-
-  // feature名のバリデーション
-  const nameValidation = validateFeatureName(feature);
-  if (!nameValidation.valid) {
-    errors.push(...nameValidation.errors);
-  }
-
-  warnings.push('⚠️  このフェーズはマニュアル対応です。ガイダンスに従ってテストタイプを選択してください');
-
-  return {
-    phase: 'test-type-selection',
-    valid: errors.length === 0,
-    errors,
-    warnings
-  };
-}
-
-/**
- * テスト仕様書作成フェーズのバリデーション（Phase 0.4）
- * マニュアル対応フェーズ - バリデーション不要（常に成功）
- */
-function validateTestSpec(feature: string): ValidationResult {
-  const errors: string[] = [];
-  const warnings: string[] = [];
-
-  // feature名のバリデーション
-  const nameValidation = validateFeatureName(feature);
-  if (!nameValidation.valid) {
-    errors.push(...nameValidation.errors);
-  }
-
-  // テスト仕様書ディレクトリの存在チェック（任意）
-  const testSpecDir = join(process.cwd(), 'docs', 'testing', 'specs', feature);
-  if (!existsSync(testSpecDir)) {
-    warnings.push('⚠️  テスト仕様書ディレクトリがありません: docs/testing/specs/' + feature);
-  }
-
-  warnings.push('⚠️  このフェーズはマニュアル対応です。テンプレートを使用してテスト仕様書を作成してください');
-
-  return {
-    phase: 'test-spec',
-    valid: errors.length === 0,
-    errors,
-    warnings
-  };
-}
 
 /**
  * 環境構築フェーズのバリデーション（Phase 1）
@@ -381,12 +330,6 @@ export function validatePhase(feature: string, phase: Phase): ValidationResult {
   case 'design':
     result = validateDesign(feature);
     break;
-  case 'test-type-selection':
-    result = validateTestTypeSelection(feature);
-    break;
-  case 'test-spec':
-    result = validateTestSpec(feature);
-    break;
   case 'tasks':
     result = validateTasks(feature);
     break;
@@ -435,12 +378,11 @@ if (import.meta.url === `file://${process.argv[1]}`) {
     console.error('\nAvailable Phases:');
     console.error('  requirements       - Phase 0.1: 要件定義');
     console.error('  design             - Phase 0.2: 設計');
-    console.error('  test-type-selection- Phase 0.3: テストタイプ選択（任意）');
-    console.error('  test-spec          - Phase 0.4: テスト仕様書作成（任意）');
     console.error('  tasks              - Phase 0.5-0.6: タスク分割・JIRA同期');
     console.error('  environment-setup  - Phase 1: 環境構築（任意）');
     console.error('  phase-a            - Phase A: PR前自動テスト（任意）');
     console.error('  phase-b            - Phase B: リリース準備テスト（任意）');
+    console.error('\nNote: For test planning (Phase 0.3-0.4), use /michi:test-planning AI command');
     process.exit(1);
   }
 
@@ -449,8 +391,6 @@ if (import.meta.url === `file://${process.argv[1]}`) {
   const validPhases = [
     'requirements',
     'design',
-    'test-type-selection',
-    'test-spec',
     'tasks',
     'environment-setup',
     'phase-a',
@@ -459,15 +399,16 @@ if (import.meta.url === `file://${process.argv[1]}`) {
 
   if (!validPhases.includes(phase)) {
     console.error(`Invalid phase: ${phase}`);
-    console.error('Must be one of: requirements, design, test-type-selection, test-spec, tasks, environment-setup, phase-a, phase-b');
+    console.error('Must be one of: requirements, design, tasks, environment-setup, phase-a, phase-b');
     process.exit(1);
   }
   
   try {
     const result = validatePhase(feature, phase as Phase);
     process.exit(result.valid ? 0 : 1);
-  } catch (error: any) {
-    console.error(`\n❌ Validation error: ${error.message}`);
+  } catch (error: unknown) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`\n❌ Validation error: ${message}`);
     process.exit(1);
   }
 }

package/scripts/workflow-orchestrator.ts

@@ -6,7 +6,7 @@
 import { config } from 'dotenv';
 import { loadProjectMeta } from './utils/project-meta.js';
 import { syncToConfluence, getConfluenceConfig } from './confluence-sync.js';
-import { syncTasksToJIRA, JIRAClient } from './jira-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';
@@ -61,8 +61,9 @@ export class WorkflowOrchestrator {
         }
         
         console.log(`✅ Stage completed: ${stage}`);
-      } catch (error: any) {
-        console.error(`❌ Stage failed: ${stage}`, error.message);
+      } catch (error: unknown) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`❌ Stage failed: ${stage}`, message);
         throw error;
       }
     }
@@ -140,10 +141,6 @@ export class WorkflowOrchestrator {
 
     // Confluenceにレポートをアップロード
     try {
-      const confluenceConfig = getConfluenceConfig();
-      const projectMeta = loadProjectMeta();
-      const spaceKey = confluenceConfig.space;
-
       // レポートをConfluenceに同期（テスト用のページとして）
       console.log('  Uploading test report to Confluence...');
 
@@ -160,8 +157,9 @@ export class WorkflowOrchestrator {
       if (!testResult.success) {
         throw new Error('Tests failed. Please fix the issues before proceeding.');
       }
-    } catch (error: any) {
-      console.error('  ❌ Test execution failed:', error.message);
+    } catch (error: unknown) {
+      const message = error instanceof Error ? error.message : String(error);
+      console.error('  ❌ Test execution failed:', message);
       throw error;
     }
   }
@@ -170,8 +168,6 @@ export class WorkflowOrchestrator {
    * リリースフェーズを実行
    */
   private async executeReleasePhase(): Promise<void> {
-    const projectMeta = loadProjectMeta();
-
     // リリースバージョンを決定（環境変数またはデフォルト）
     const version = process.env.RELEASE_VERSION || 'v1.0.0';
 
@@ -192,14 +188,6 @@ export class WorkflowOrchestrator {
 
     // JIRA Releaseを作成
     try {
-      const jiraConfig = {
-        url: process.env.ATLASSIAN_URL || '',
-        email: process.env.ATLASSIAN_EMAIL || '',
-        apiToken: process.env.ATLASSIAN_API_TOKEN || ''
-      };
-
-      const jiraClient = new JIRAClient(jiraConfig);
-
       console.log('  Creating JIRA Release...');
 
       // JIRA Release作成APIを呼び出し
@@ -207,8 +195,9 @@ export class WorkflowOrchestrator {
       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: any) {
-      console.warn('  ⚠️  Failed to create JIRA Release:', error.message);
+    } 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');
     }
   }
@@ -246,8 +235,9 @@ export class WorkflowOrchestrator {
         const status = await pollForApproval(pageId, confluenceConfig);
 
         console.log(`  ✅ Approved by: ${status.approvers.join(', ')}`);
-      } catch (error: any) {
-        console.error('  ❌ Approval polling failed:', error.message);
+      } catch (error: unknown) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error('  ❌ Approval polling failed:', message);
         throw error;
       }
     } else {
@@ -289,8 +279,9 @@ if (import.meta.url === `file://${process.argv[1]}`) {
   
   orchestrator.run()
     .then(() => process.exit(0))
-    .catch((error) => {
-      console.error('❌ Workflow failed:', error.message);
+    .catch((error: unknown) => {
+      const message = error instanceof Error ? error.message : String(error);
+      console.error('❌ Workflow failed:', message);
       process.exit(1);
     });
 }

package/templates/claude/commands/kiro/kiro-spec-impl.md

@@ -1,5 +1,9 @@
 # kiro:spec-impl - Spec Implementation Command
 
+## Development Guidelines
+
+{{DEV_GUIDELINES}}
+
 ## Overview
 
 This command implements the specifications defined in `tasks.md` following TDD (Test-Driven Development) practices with automatic JIRA integration.
@@ -25,7 +29,7 @@ This command implements the specifications defined in `tasks.md` following TDD (
    - `ATLASSIAN_EMAIL`: JIRA user email
    - `ATLASSIAN_API_TOKEN`: JIRA API token
    - `GITHUB_TOKEN`: GitHub API token
-   - `GITHUB_REPO`: GitHub repository (owner/repo format)
+   - ~~`GITHUB_REPO`: GitHub repository (owner/repo format)~~ **Deprecated (v0.5.0+)**: Repository info is now automatically loaded from `.kiro/project.json`
 
 ## Execution Flow
 

package/templates/claude/commands/kiro/kiro-spec-tasks.md

@@ -5,7 +5,9 @@ description: Generate tasks.md from design specification in Michi workflow forma
 
 # Generate Tasks from Design Specification
 
-**Important**: Generate output in the language specified in `{{KIRO_DIR}}/project.json`.
+## Development Guidelines
+
+{{DEV_GUIDELINES}}
 
 ## Overview
 

package/templates/claude/commands/michi/confluence-sync.md

@@ -1,11 +1,17 @@
 ---
 name: /michi:confluence-sync
-description: Sync specifications to Confluence
+description: Sync specifications to Confluence (Michi-specific feature)
 ---
 
 # Confluence Sync Command
 
-**Important**: Generate output in language specified in {{KIRO_DIR}}/project.json.
+> **Michi 固有機能**: このコマンドは Michi 独自の機能です。cc-sdd 標準には含まれません。
+>
+> 仕様書（requirements.md, design.md）を Confluence に同期し、承認ワークフローを実現します。
+
+## Development Guidelines
+
+{{DEV_GUIDELINES}}
 
 ## Usage
 

package/templates/claude/commands/michi/design-review.md

@@ -5,6 +5,10 @@ description: UIコンポーネントのデザイン品質をレビューする
 
 # デザインレビュー
 
+## Development Guidelines
+
+{{DEV_GUIDELINES}}
+
 このコマンドは、UIコンポーネントやフロントエンドコードのデザイン品質をレビューします。
 
 ## サブエージェント呼び出し

package/templates/claude/commands/michi/e2e-plan.md

@@ -5,6 +5,10 @@ description: E2Eファースト方式でタスク分割を計画する
 
 # E2Eプランニング
 
+## Development Guidelines
+
+{{DEV_GUIDELINES}}
+
 このコマンドは、E2Eファースト方式でタスク分割を計画し、早期に動作確認可能な実装計画を策定します。
 
 ## サブエージェント呼び出し

package/templates/claude/commands/michi/license-check.md

@@ -5,6 +5,10 @@ description: 依存パッケージのOSSライセンスを確認する
 
 # ライセンス確認
 
+## Development Guidelines
+
+{{DEV_GUIDELINES}}
+
 このコマンドは、プロジェクトの依存パッケージのOSSライセンスを確認し、ライセンス互換性をチェックします。
 
 ## サブエージェント呼び出し

package/templates/claude/commands/michi/pr-resolve.md

@@ -5,6 +5,10 @@ description: PRレビューコメントへの対応を支援する
 
 # PRコメント対応
 
+## Development Guidelines
+
+{{DEV_GUIDELINES}}
+
 このコマンドは、プルリクエストのレビューコメントへの対応を支援し、すべてのコメントが適切に解決されているか確認します。
 
 ## サブエージェント呼び出し

package/templates/claude/commands/michi/project-switch.md

@@ -1,11 +1,17 @@
 ---
 name: /michi:project-switch
-description: Switch between projects
+description: Switch between projects (Michi-specific feature)
 ---
 
 # Project Switch Command
 
-**Important**: Generate output in language specified in {{KIRO_DIR}}/project.json.
+> **Michi 固有機能**: このコマンドは Michi 独自の機能です。cc-sdd 標準には含まれません。
+>
+> マルチプロジェクト環境で、異なるプロジェクト間を切り替えるための機能です。
+
+## Development Guidelines
+
+{{DEV_GUIDELINES}}
 
 ## Usage
 

package/templates/claude/commands/michi/spec-design.md

@@ -0,0 +1,78 @@
+---
+name: /michi:spec-design
+description: Create comprehensive technical design for a specification (Michi version with test planning flow)
+allowed-tools: Bash, Glob, Grep, LS, Read, Write, Edit, MultiEdit, Update, WebSearch, WebFetch
+argument-hint: <feature-name> [-y]
+---
+
+# Michi: Spec Design with Test Planning Flow
+
+## Base Command Reference
+@.claude/commands/kiro/spec-design.md
+
+## Development Guidelines
+
+{{DEV_GUIDELINES}}
+
+## Michi Extension: Next Phase Guidance
+
+設計ドキュメント生成完了後、以下のフローを案内:
+
+### Next Phase: Phase 0.3 - テストタイプの選択
+
+設計が完了したら、タスク生成前に **Phase 0.3-0.4: テスト計画** を実施してください。
+
+#### 1. Phase 0.3: テストタイプの選択
+
+設計書の Testing Strategy セクションを基に、必要なテストタイプを決定します。
+
+**実行方法:**
+
+**推奨: 統合AIコマンド**
+```bash
+/michi:test-planning {feature-name}
+```
+Phase 0.3とPhase 0.4を統合的に実行します。AIが対話的にテストタイプを選択し、テスト仕様書を作成します。
+
+**選択可能なテストタイプ:**
+- 単体テスト (Unit Test)
+- 統合テスト (Integration Test)
+- E2Eテスト (End-to-End Test)
+- パフォーマンステスト (Performance Test)
+- セキュリティテスト (Security Test)
+
+**参照ドキュメント**: `docs/user-guide/testing/test-planning-flow.md`
+
+#### 2. Phase 0.4: テスト仕様書の作成
+
+Phase 0.3で選択したテストタイプに基づいて、テスト仕様書を作成します。
+
+**実行方法:**
+
+`/michi:test-planning` を使用した場合、Phase 0.4も自動的に実行されます。
+
+**テンプレート:**
+- 単体テスト: `docs/user-guide/templates/test-specs/unit-test-spec-template.md`
+- 統合テスト: `docs/user-guide/templates/test-specs/integration-test-spec-template.md`
+- E2Eテスト: `docs/user-guide/templates/test-specs/e2e-test-spec-template.md`
+- パフォーマンステスト: `docs/user-guide/templates/test-specs/performance-test-spec-template.md`
+- セキュリティテスト: `docs/user-guide/templates/test-specs/security-test-spec-template.md`
+
+**出力先**: `.kiro/specs/{feature}/test-specs/`
+
+### After Test Planning: Task Generation
+
+Phase 0.3-0.4 完了後、以下のステップに進んでください:
+
+**推奨フロー**:
+1. `/michi:validate-design {feature}` で設計レビューを実施（任意）
+2. `/kiro:spec-tasks {feature}` でタスク生成
+
+**クイックフロー**:
+- `/kiro:spec-tasks {feature} -y` で自動承認してタスク生成
+
+**重要**: テスト計画（Phase 0.3-0.4）を完了してからタスク生成することで、実装タスクにテスト実装が適切に含まれます。
+
+---
+
+**Michi 固有機能**: このコマンドは cc-sdd 標準の `/kiro:spec-design` を拡張し、Michi 固有のテスト計画フロー（Phase 0.3-0.4）を Next Phase として案内します。