@sk8metal/michi-cli 0.0.9 → 0.1.0

package/scripts/utils/tasks-format-validator.ts

@@ -0,0 +1,193 @@
+/**
+ * tasks.mdフォーマットバリデーター
+ *
+ * Michi Workflow構造に準拠しているかを検証
+ * - 新ワークフロー構造（Phase 0.1-0.2, 1, 2, A, 3, B, 4-5）を推奨
+ * - 旧6-Phase構造（Phase 0-5）も互換性のためサポート
+ */
+
+import { readFileSync } from 'fs';
+
+/**
+ * tasks.mdのフォーマットを検証
+ *
+ * @param tasksPath - tasks.mdファイルのパス
+ * @throws {Error} フォーマットが不正な場合
+ */
+export function validateTasksFormat(tasksPath: string): void {
+  let content: string;
+
+  try {
+    content = readFileSync(tasksPath, 'utf-8');
+  } catch (error) {
+    throw new Error(
+      `Failed to read tasks.md: ${error instanceof Error ? error.message : 'Unknown error'}`,
+    );
+  }
+
+  // 1. AI-DLCフォーマット検出（誤ったフォーマット）を最初にチェック
+  // より具体的なエラーメッセージを優先的に表示
+  // AI-DLCは "- [ ] 1." のようなフォーマットで、Phase構造がない
+  const hasCheckboxPattern = /^- \[ \] \d+\./m.test(content);
+  const hasPhaseStructure = content.includes('Phase 0:') || content.includes('Phase 0.1:');
+
+  if (hasCheckboxPattern && !hasPhaseStructure) {
+    throw new Error(
+      'tasks.md appears to be in AI-DLC format instead of Michi workflow format.\n' +
+        'Detected "- [ ] 1." pattern without Phase structure.\n' +
+        'Please regenerate tasks.md using /kiro:spec-tasks command with correct template.',
+    );
+  }
+
+  // 2. フェーズ構造の検証（新旧両方をサポート）
+
+  // 新ワークフロー構造（推奨）
+  const newWorkflowPhases = [
+    'Phase 0.1:', // 要件定義
+    'Phase 0.2:', // 設計
+    'Phase 1:',   // 環境構築（任意）
+    'Phase 2:',   // TDD実装
+    'Phase A:',   // PR前自動テスト（任意）
+    'Phase 3:',   // 追加QA（任意）
+    'Phase B:',   // リリース準備テスト（任意）
+    'Phase 4:',   // リリース準備
+    'Phase 5:',   // リリース
+  ];
+
+  // 旧6-Phase構造（互換性のためサポート）
+  const legacyPhases = [
+    'Phase 0: 要件定義（Requirements）',
+    'Phase 1: 設計（Design）',
+    'Phase 2: 実装（Implementation）',
+    'Phase 3: 試験（Testing）',
+    'Phase 4: リリース準備（Release Preparation）',
+    'Phase 5: リリース（Release）',
+  ];
+
+  // 新ワークフロー構造の必須フェーズ
+  const newRequiredPhases = ['Phase 0.1:', 'Phase 0.2:', 'Phase 2:', 'Phase 4:', 'Phase 5:'];
+
+  // 旧構造の検証
+  const hasLegacyStructure = legacyPhases.every((phase) => content.includes(phase));
+
+  // 新構造の検証（必須フェーズのみ）
+  const hasNewStructure = newRequiredPhases.every((phase) => content.includes(phase));
+
+  if (!hasLegacyStructure && !hasNewStructure) {
+    const missingNewPhases = newRequiredPhases.filter(
+      (phase) => !content.includes(phase),
+    );
+    const missingLegacyPhases = legacyPhases.filter(
+      (phase) => !content.includes(phase),
+    );
+
+    throw new Error(
+      'tasks.md does not match either workflow structure.\n\n' +
+        `Missing required phases (new workflow):\n${missingNewPhases.map((p) => `  - ${p}`).join('\n')}\n\n` +
+        `Missing phases (legacy workflow):\n${missingLegacyPhases.map((p) => `  - ${p}`).join('\n')}\n\n` +
+        'Please regenerate tasks.md using /kiro:spec-tasks command with the latest template.',
+    );
+  }
+
+  // 旧構造の場合は警告
+  if (hasLegacyStructure && !hasNewStructure) {
+    console.warn(
+      '⚠️  Warning: tasks.md uses legacy 6-phase structure (Phase 0-5).\n' +
+        '   Consider migrating to the new workflow structure:\n' +
+        '   - Phase 0.1: 要件定義\n' +
+        '   - Phase 0.2: 設計\n' +
+        '   - Phase 1: 環境構築（任意）\n' +
+        '   - Phase 2: TDD実装\n' +
+        '   - Phase A: PR前自動テスト（任意）\n' +
+        '   - Phase 3: 追加QA（任意）\n' +
+        '   - Phase B: リリース準備テスト（任意）\n' +
+        '   - Phase 4: リリース準備\n' +
+        '   - Phase 5: リリース\n' +
+        '   See: docs/user-guide/guides/workflow.md',
+    );
+  }
+
+  // 3. Storyヘッダーのフォーマットチェック
+  const storyPattern = /### Story \d+\.\d+:/;
+  if (!storyPattern.test(content)) {
+    throw new Error(
+      'tasks.md does not contain valid Story headers.\n' +
+        'Expected format: "### Story X.Y: Title"\n' +
+        'Please regenerate tasks.md using /kiro:spec-tasks command.',
+    );
+  }
+
+  // 4. 営業日スケジュールのチェック（警告のみ）
+  const hasBusinessDayMention =
+    content.includes('営業日') ||
+    content.includes('business day') ||
+    content.includes('Day 1') ||
+    content.includes('Day 2');
+
+  if (!hasBusinessDayMention) {
+    console.warn(
+      '⚠️  Warning: tasks.md does not mention business days or day numbering.\n' +
+        '   Michi expects tasks to include business day schedule (Day 1, Day 2, etc.).\n' +
+        '   This may cause validation warnings during JIRA sync.',
+    );
+  }
+
+  // 5. フェーズヘッダーのフォーマットチェック（ラベル括弧付き）
+  const phaseHeaderPattern = /## Phase \d+: .+（.+）/;
+  if (!phaseHeaderPattern.test(content)) {
+    console.warn(
+      '⚠️  Warning: Phase headers may not have correct format.\n' +
+        '   Expected format: "## Phase X: Name（Label）"\n' +
+        '   Labels in parentheses are required for JIRA label detection.',
+    );
+  }
+}
+
+/**
+ * tasks.mdが存在し、かつ有効なフォーマットかをチェック
+ *
+ * @param tasksPath - tasks.mdファイルのパス
+ * @returns {boolean} 有効な場合true
+ */
+export function isValidTasksFormat(tasksPath: string): boolean {
+  try {
+    validateTasksFormat(tasksPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * tasks.mdに含まれるフェーズ数を取得
+ *
+ * @param tasksPath - tasks.mdファイルのパス
+ * @returns {number} 検出されたフェーズ数
+ */
+export function countPhases(tasksPath: string): number {
+  try {
+    const content = readFileSync(tasksPath, 'utf-8');
+    const phasePattern = /## Phase \d+:/g;
+    const matches = content.match(phasePattern);
+    return matches ? matches.length : 0;
+  } catch {
+    return 0;
+  }
+}
+
+/**
+ * tasks.mdに含まれるStory数を取得
+ *
+ * @param tasksPath - tasks.mdファイルのパス
+ * @returns {number} 検出されたStory数
+ */
+export function countStories(tasksPath: string): number {
+  try {
+    const content = readFileSync(tasksPath, 'utf-8');
+    const storyPattern = /### Story \d+\.\d+:/g;
+    const matches = content.match(storyPattern);
+    return matches ? matches.length : 0;
+  } catch {
+    return 0;
+  }
+}

package/scripts/utils/template-applier.ts

@@ -0,0 +1,202 @@
+/**
+ * テンプレート適用エンジン
+ * テスト仕様書テンプレートにデータを適用
+ */
+
+import { readFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import type { Component, Flow, Requirement } from './markdown-parser.js';
+
+// ES module で __dirname を取得
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+export interface TestCase {
+  id: string;
+  name: string;
+  description: string;
+  preconditions: string[];
+  steps: string[];
+  expectedResults: string[];
+  type: 'normal' | 'error' | 'edge';
+}
+
+export interface TemplateData {
+  feature: string;
+  testType: string;
+  author?: string;
+  date: string;
+  purpose?: string;
+  scope?: string;
+  tool?: string;
+  version?: string;
+  testCases: TestCase[];
+  components?: Component[];
+  flows?: Flow[];
+  requirements?: Requirement[];
+}
+
+/**
+ * テスト仕様書テンプレートを読み込む
+ */
+export function loadTestSpecTemplate(testType: string, projectRoot: string = process.cwd()): string {
+  const templatePath = join(
+    projectRoot,
+    '.kiro',
+    'settings',
+    'templates',
+    'test-specs',
+    `${testType}-test-spec-template.md`
+  );
+  
+  // プロジェクトのテンプレートが存在しない場合、Michiのテンプレートを使用
+  if (!existsSync(templatePath)) {
+    const michiTemplatePath = join(
+      __dirname,
+      '..',
+      '..',
+      'docs',
+      'user-guide',
+      'templates',
+      'test-specs',
+      `${testType}-test-spec-template.md`
+    );
+    
+    if (existsSync(michiTemplatePath)) {
+      return readFileSync(michiTemplatePath, 'utf-8');
+    }
+    
+    throw new Error(`テンプレートが見つかりません: ${testType}-test-spec-template.md`);
+  }
+  
+  return readFileSync(templatePath, 'utf-8');
+}
+
+/**
+ * テンプレートにデータを適用
+ */
+export function applyTemplate(template: string, data: TemplateData): string {
+  let result = template;
+  
+  // 基本情報の置換
+  result = result.replace(/\{\{TEST_NAME\}\}/g, `${data.feature} ${data.testType}テスト`);
+  result = result.replace(/\{\{AUTHOR\}\}/g, data.author || 'Auto-generated');
+  result = result.replace(/\{\{DATE\}\}/g, data.date);
+  result = result.replace(/\{\{PURPOSE\}\}/g, data.purpose || `${data.feature}の${data.testType}テストを実施する`);
+  result = result.replace(/\{\{SCOPE\}\}/g, data.scope || `${data.feature}の全コンポーネント`);
+  result = result.replace(/\{\{TOOL_NAME\}\}/g, data.tool || 'Vitest');
+  result = result.replace(/\{\{VERSION\}\}/g, data.version || '1.0.0');
+  
+  // 言語・フレームワーク情報
+  result = result.replace(/\{\{LANGUAGE\}\}/g, 'TypeScript');
+  result = result.replace(/\{\{LANGUAGE_VERSION\}\}/g, '5.x');
+  result = result.replace(/\{\{FRAMEWORK\}\}/g, 'Vitest');
+  result = result.replace(/\{\{FRAMEWORK_VERSION\}\}/g, '1.0.0');
+  result = result.replace(/\{\{MOCKING_LIBRARY\}\}/g, 'Vitest (built-in)');
+  result = result.replace(/\{\{DEPENDENCIES\}\}/g, 'Node.js 20+');
+  
+  // テストデータパス
+  result = result.replace(/\{\{MOCK_DATA_PATH\}\}/g, `tests/__mocks__/${data.feature}`);
+  result = result.replace(/\{\{FIXTURES_PATH\}\}/g, `tests/__fixtures__/${data.feature}`);
+  result = result.replace(/\{\{DATA_SETUP_DESCRIPTION\}\}/g, 'モックデータはJSONファイルで管理');
+  
+  // カバレッジ目標
+  result = result.replace(/\{\{TARGET_COVERAGE\}\}/g, '95');
+  result = result.replace(/\{\{MIN_COVERAGE\}\}/g, '80');
+  result = result.replace(/\{\{COVERAGE_REPORT_PATH\}\}/g, 'coverage/lcov.info');
+  result = result.replace(/\{\{HTML_REPORT_PATH\}\}/g, 'coverage/index.html');
+  
+  // コンポーネント一覧テーブルの生成
+  if (data.components && data.components.length > 0) {
+    const componentTable = generateComponentTable(data.components);
+    result = result.replace(/\|\s*\{\{COMPONENT_1\}\}\s*\|.*?\n/, componentTable);
+  }
+  
+  // テストケースセクションの生成
+  if (data.testCases && data.testCases.length > 0) {
+    const testCasesSection = generateTestCasesSection(data.testCases);
+    result = replaceTestCasesSection(result, testCasesSection);
+  }
+  
+  // 残りのプレースホルダーをクリーンアップ
+  result = cleanupPlaceholders(result);
+  
+  return result;
+}
+
+/**
+ * コンポーネント一覧テーブルを生成
+ */
+function generateComponentTable(components: Component[]): string {
+  let table = '';
+  
+  for (const component of components) {
+    const priority = component.requirements.length > 3 ? 'High' : 'Medium';
+    table += `| ${component.name} | Class | ${component.intent} | ${priority} |\n`;
+  }
+  
+  return table;
+}
+
+/**
+ * テストケースセクションを生成
+ */
+function generateTestCasesSection(testCases: TestCase[]): string {
+  let section = '';
+  
+  for (const tc of testCases) {
+    section += `\n### Test Case ${tc.id}: ${tc.name}\n\n`;
+    section += `**Description**: ${tc.description}\n\n`;
+    
+    if (tc.preconditions.length > 0) {
+      section += '**Preconditions**:\n';
+      tc.preconditions.forEach(p => section += `- ${p}\n`);
+      section += '\n';
+    }
+    
+    section += '**Test Steps**:\n';
+    tc.steps.forEach((step, idx) => section += `${idx + 1}. ${step}\n`);
+    section += '\n';
+    
+    section += '**Expected Results**:\n';
+    tc.expectedResults.forEach(r => section += `- ${r}\n`);
+    section += '\n';
+    
+    section += '**Actual Results**:\n';
+    section += '[To be filled during test execution]\n\n';
+    
+    section += '**Status**: [ ] Pass / [ ] Fail / [ ] Blocked\n\n';
+    section += '**Notes**:\n\n';
+    section += '---\n\n';
+  }
+  
+  return section;
+}
+
+/**
+ * テストケースセクションを置換
+ */
+function replaceTestCasesSection(template: string, testCasesSection: string): string {
+  // "## 4. Test Cases"セクションを検索して置換
+  const sectionMatch = template.match(/##\s+4\.\s+Test Cases[\s\S]*?(?=##\s+\d+\.|$)/);
+  
+  if (sectionMatch) {
+    return template.replace(sectionMatch[0], `## 4. Test Cases\n${testCasesSection}`);
+  }
+  
+  // セクションが見つからない場合は末尾に追加
+  return template + `\n\n## 4. Test Cases\n${testCasesSection}`;
+}
+
+/**
+ * プレースホルダーをクリーンアップ
+ */
+function cleanupPlaceholders(content: string): string {
+  // 残っているプレースホルダーを削除または空文字に置換
+  return content
+    .replace(/\{\{[A-Z_0-9]+\}\}/g, '')
+    .replace(/\|\s*\|\s*\|\s*\|/g, '') // 空のテーブル行を削除
+    .replace(/\n{3,}/g, '\n\n'); // 連続する空行を2行に制限
+}
+

package/scripts/utils/test-config-generator.ts

@@ -0,0 +1,210 @@
+/**
+ * テスト設定生成ユーティリティ
+ * プロジェクトの言語に応じてテストフレームワーク設定を生成
+ */
+
+import { writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+
+export interface TestConfig {
+  language: string;
+}
+
+/**
+ * テストフレームワーク設定ファイルを生成
+ */
+export async function generateTestConfig(
+  feature: string,
+  config: TestConfig,
+  projectRoot: string = process.cwd()
+): Promise<void> {
+  const { language } = config;
+  
+  switch (language) {
+  case 'Node.js/TypeScript':
+    await generateVitestConfig(projectRoot);
+    break;
+  case 'Java':
+    await generateJUnitConfig(projectRoot);
+    break;
+  case 'PHP':
+    await generatePHPUnitConfig(projectRoot);
+    break;
+  case 'Python':
+    await generatePytestConfig(projectRoot);
+    break;
+  case 'Go':
+    console.log('   ℹ️  Goは標準のtestingパッケージを使用（設定不要）');
+    break;
+  case 'Rust':
+    console.log('   ℹ️  Rustは標準のcargo testを使用（設定不要）');
+    break;
+  default:
+    console.log('   ⏭️  テスト設定: スキップ（言語不明）');
+  }
+}
+
+/**
+ * Vitest設定を生成（Node.js/TypeScript）
+ */
+async function generateVitestConfig(projectRoot: string): Promise<void> {
+  const outputPath = join(projectRoot, 'vitest.config.ts');
+  
+  // 既存の設定ファイルがある場合はスキップ
+  if (existsSync(outputPath)) {
+    console.log('   ℹ️  vitest.config.ts: 既存（スキップ）');
+    return;
+  }
+  
+  const config = `import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html', 'lcov'],
+      exclude: [
+        'node_modules/',
+        'dist/',
+        '**/*.d.ts',
+        '**/*.config.*',
+        '**/mockData',
+        'tests/fixtures'
+      ],
+      thresholds: {
+        lines: 80,
+        functions: 80,
+        branches: 80,
+        statements: 80
+      }
+    }
+  }
+});
+`;
+  
+  writeFileSync(outputPath, config, 'utf-8');
+  console.log('   ✅ テスト設定: vitest.config.ts');
+}
+
+/**
+ * JUnit設定を生成（Java）
+ */
+async function generateJUnitConfig(projectRoot: string): Promise<void> {
+  const outputPath = join(projectRoot, 'build.gradle');
+  
+  // 既存のbuild.gradleがある場合はスキップ
+  if (!existsSync(outputPath)) {
+    const config = `plugins {
+    id 'java'
+    id 'jacoco'
+}
+
+group = 'com.example'
+version = '1.0.0'
+sourceCompatibility = '17'
+
+repositories {
+    mavenCentral()
+}
+
+dependencies {
+    testImplementation 'org.junit.jupiter:junit-jupiter:5.10.0'
+    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
+}
+
+test {
+    useJUnitPlatform()
+    finalizedBy jacocoTestReport
+}
+
+jacoco {
+    toolVersion = "0.8.11"
+}
+
+jacocoTestReport {
+    dependsOn test
+    reports {
+        xml.required = true
+        html.required = true
+    }
+}
+`;
+    
+    writeFileSync(outputPath, config, 'utf-8');
+    console.log('   ✅ テスト設定: build.gradle');
+  } else {
+    console.log('   ℹ️  build.gradle: 既存（スキップ）');
+  }
+}
+
+/**
+ * PHPUnit設定を生成（PHP）
+ */
+async function generatePHPUnitConfig(projectRoot: string): Promise<void> {
+  const outputPath = join(projectRoot, 'phpunit.xml');
+  
+  // 既存の設定ファイルがある場合はスキップ
+  if (existsSync(outputPath)) {
+    console.log('   ℹ️  phpunit.xml: 既存（スキップ）');
+    return;
+  }
+  
+  const config = `<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
+         bootstrap="vendor/autoload.php"
+         colors="true">
+    <testsuites>
+        <testsuite name="Unit">
+            <directory suffix="Test.php">./tests/Unit</directory>
+        </testsuite>
+        <testsuite name="Feature">
+            <directory suffix="Test.php">./tests/Feature</directory>
+        </testsuite>
+    </testsuites>
+    <coverage>
+        <report>
+            <html outputDirectory="coverage/html"/>
+            <clover outputFile="coverage/clover.xml"/>
+        </report>
+    </coverage>
+</phpunit>
+`;
+  
+  writeFileSync(outputPath, config, 'utf-8');
+  console.log('   ✅ テスト設定: phpunit.xml');
+}
+
+/**
+ * Pytest設定を生成（Python）
+ */
+async function generatePytestConfig(projectRoot: string): Promise<void> {
+  const outputPath = join(projectRoot, 'pytest.ini');
+  
+  // 既存の設定ファイルがある場合はスキップ
+  if (existsSync(outputPath)) {
+    console.log('   ℹ️  pytest.ini: 既存（スキップ）');
+    return;
+  }
+  
+  const config = `[pytest]
+testpaths = tests
+python_files = test_*.py
+python_classes = Test*
+python_functions = test_*
+
+# Coverage settings
+addopts = 
+    --cov=src
+    --cov-report=html
+    --cov-report=xml
+    --cov-report=term-missing
+    --cov-fail-under=80
+`;
+  
+  writeFileSync(outputPath, config, 'utf-8');
+  console.log('   ✅ テスト設定: pytest.ini');
+}
+