@sk8metal/michi-cli 0.0.9 → 0.1.0

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

@@ -0,0 +1,338 @@
+/**
+ * tasks-format-validator.ts のユニットテスト
+ */
+
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { writeFileSync, unlinkSync, mkdirSync, rmdirSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { 
+  validateTasksFormat, 
+  isValidTasksFormat, 
+  countPhases, 
+  countStories 
+} from '../tasks-format-validator.js';
+
+describe('tasks-format-validator', () => {
+  let testDir: string;
+  let testFilePath: string;
+
+  beforeEach(() => {
+    // テスト用一時ディレクトリ作成
+    testDir = join(tmpdir(), `test-tasks-validator-${Date.now()}`);
+    mkdirSync(testDir, { recursive: true });
+    testFilePath = join(testDir, 'tasks.md');
+  });
+
+  afterEach(() => {
+    // クリーンアップ
+    try {
+      if (testFilePath) unlinkSync(testFilePath);
+      if (testDir) rmdirSync(testDir);
+    } catch {
+      // Ignore cleanup errors
+    }
+  });
+
+  describe('validateTasksFormat', () => {
+    it('正しい新ワークフローフォーマットが成功する', () => {
+      const validContent = `# tasks.md
+
+## Phase 0.1: 要件定義
+
+### Story 0.1.1: 要件定義書作成
+
+## Phase 0.2: 設計
+
+### Story 0.2.1: 基本設計
+
+## Phase 1: 環境構築
+
+### Story 1.1: テスト環境セットアップ
+
+## Phase 2: TDD実装
+
+### Story 2.1: プロジェクトセットアップ
+
+## Phase A: PR前自動テスト
+
+### Story A.1: 単体テスト実行
+
+## Phase 3: 追加QA
+
+### Story 3.1: 統合テスト
+
+## Phase B: リリース準備テスト
+
+### Story B.1: E2Eテスト実行
+
+## Phase 4: リリース準備
+
+### Story 4.1: 本番環境構築
+
+## Phase 5: リリース
+
+### Story 5.1: ステージング環境デプロイ
+
+Day 1（月）: 営業日ベース
+`;
+      writeFileSync(testFilePath, validContent, 'utf-8');
+      expect(() => validateTasksFormat(testFilePath)).not.toThrow();
+    });
+
+    it('正しい新ワークフローフォーマット（任意フェーズ省略）が成功する', () => {
+      const validContent = `# tasks.md
+
+## Phase 0.1: 要件定義
+
+### Story 0.1.1: 要件定義書作成
+
+## Phase 0.2: 設計
+
+### Story 0.2.1: 基本設計
+
+## Phase 2: TDD実装
+
+### Story 2.1: プロジェクトセットアップ
+
+## Phase 4: リリース準備
+
+### Story 4.1: 本番環境構築
+
+## Phase 5: リリース
+
+### Story 5.1: ステージング環境デプロイ
+
+Day 1（月）: 営業日ベース
+`;
+      writeFileSync(testFilePath, validContent, 'utf-8');
+      expect(() => validateTasksFormat(testFilePath)).not.toThrow();
+    });
+
+    it('正しい6フェーズフォーマット（レガシー）が成功する', () => {
+      const validContent = `# tasks.md
+
+## Phase 0: 要件定義（Requirements）
+
+### Story 0.1: 要件定義書作成
+
+## Phase 1: 設計（Design）
+
+### Story 1.1: 基本設計
+
+## Phase 2: 実装（Implementation）
+
+### Story 2.1: プロジェクトセットアップ
+
+## Phase 3: 試験（Testing）
+
+### Story 3.1: 結合テスト
+
+## Phase 4: リリース準備（Release Preparation）
+
+### Story 4.1: 本番環境構築
+
+## Phase 5: リリース（Release）
+
+### Story 5.1: ステージング環境デプロイ
+
+Day 1（月）: 営業日ベース
+`;
+      writeFileSync(testFilePath, validContent, 'utf-8');
+      expect(() => validateTasksFormat(testFilePath)).not.toThrow();
+    });
+
+    it('Phase 0が不足している場合エラー', () => {
+      const invalidContent = `# tasks.md
+
+## Phase 1: 設計（Design）
+
+### Story 1.1: 基本設計
+
+## Phase 2: 実装（Implementation）
+
+### Story 2.1: プロジェクトセットアップ
+
+## Phase 3: 試験（Testing）
+
+### Story 3.1: 結合テスト
+
+## Phase 4: リリース準備（Release Preparation）
+
+### Story 4.1: 本番環境構築
+
+## Phase 5: リリース（Release）
+
+### Story 5.1: ステージング環境デプロイ
+`;
+      writeFileSync(testFilePath, invalidContent, 'utf-8');
+      expect(() => validateTasksFormat(testFilePath)).toThrow(/Phase 0: 要件定義（Requirements）/);
+    });
+
+    it('複数のフェーズが不足している場合エラー', () => {
+      const invalidContent = `# tasks.md
+
+## Phase 0: 要件定義（Requirements）
+
+### Story 0.1: 要件定義書作成
+
+## Phase 2: 実装（Implementation）
+
+### Story 2.1: プロジェクトセットアップ
+`;
+      writeFileSync(testFilePath, invalidContent, 'utf-8');
+      expect(() => validateTasksFormat(testFilePath)).toThrow(/Phase 1: 設計（Design）/);
+      expect(() => validateTasksFormat(testFilePath)).toThrow(/Phase 3: 試験（Testing）/);
+    });
+
+    it('新ワークフローで必須フェーズが不足している場合エラー', () => {
+      const invalidContent = `# tasks.md
+
+## Phase 0.1: 要件定義
+
+### Story 0.1.1: 要件定義書作成
+
+## Phase 2: TDD実装
+
+### Story 2.1: プロジェクトセットアップ
+`;
+      writeFileSync(testFilePath, invalidContent, 'utf-8');
+      expect(() => validateTasksFormat(testFilePath)).toThrow(/Phase 0.2:/);
+      expect(() => validateTasksFormat(testFilePath)).toThrow(/does not match either workflow structure/);
+    });
+
+    it('Storyヘッダーがない場合エラー', () => {
+      const invalidContent = `# tasks.md
+
+## Phase 0: 要件定義（Requirements）
+## Phase 1: 設計（Design）
+## Phase 2: 実装（Implementation）
+## Phase 3: 試験（Testing）
+## Phase 4: リリース準備（Release Preparation）
+## Phase 5: リリース（Release）
+`;
+      writeFileSync(testFilePath, invalidContent, 'utf-8');
+      expect(() => validateTasksFormat(testFilePath)).toThrow(/Story headers/);
+    });
+
+    it('AI-DLCフォーマットを検出してエラー', () => {
+      const invalidContent = `# Implementation Plan
+
+## Task Breakdown
+
+- [ ] 1. プロジェクトセットアップ
+- [ ] 2. HealthControllerを実装
+- [ ] 3. HealthServiceを実装
+`;
+      writeFileSync(testFilePath, invalidContent, 'utf-8');
+      expect(() => validateTasksFormat(testFilePath)).toThrow(/AI-DLC format/);
+    });
+
+    it('ファイルが存在しない場合エラー', () => {
+      const nonExistentPath = join(testDir, 'non-existent.md');
+      expect(() => validateTasksFormat(nonExistentPath)).toThrow(/Failed to read/);
+    });
+  });
+
+  describe('isValidTasksFormat', () => {
+    it('正しいフォーマットの場合trueを返す', () => {
+      const validContent = `# tasks.md
+
+## Phase 0: 要件定義（Requirements）
+### Story 0.1: タイトル
+
+## Phase 1: 設計（Design）
+### Story 1.1: タイトル
+
+## Phase 2: 実装（Implementation）
+### Story 2.1: タイトル
+
+## Phase 3: 試験（Testing）
+### Story 3.1: タイトル
+
+## Phase 4: リリース準備（Release Preparation）
+### Story 4.1: タイトル
+
+## Phase 5: リリース（Release）
+### Story 5.1: タイトル
+
+Day 1（月）: 営業日ベース
+`;
+      writeFileSync(testFilePath, validContent, 'utf-8');
+      expect(isValidTasksFormat(testFilePath)).toBe(true);
+    });
+
+    it('不正なフォーマットの場合falseを返す', () => {
+      const invalidContent = `# tasks.md
+
+## Phase 0: 要件定義（Requirements）
+`;
+      writeFileSync(testFilePath, invalidContent, 'utf-8');
+      expect(isValidTasksFormat(testFilePath)).toBe(false);
+    });
+  });
+
+  describe('countPhases', () => {
+    it('正しくフェーズ数をカウントする', () => {
+      const content = `# tasks.md
+
+## Phase 0: 要件定義（Requirements）
+## Phase 1: 設計（Design）
+## Phase 2: 実装（Implementation）
+## Phase 3: 試験（Testing）
+## Phase 4: リリース準備（Release Preparation）
+## Phase 5: リリース（Release）
+`;
+      writeFileSync(testFilePath, content, 'utf-8');
+      expect(countPhases(testFilePath)).toBe(6);
+    });
+
+    it('フェーズが少ない場合正しくカウントする', () => {
+      const content = `# tasks.md
+
+## Phase 0: 要件定義（Requirements）
+## Phase 1: 設計（Design）
+`;
+      writeFileSync(testFilePath, content, 'utf-8');
+      expect(countPhases(testFilePath)).toBe(2);
+    });
+
+    it('ファイルが存在しない場合0を返す', () => {
+      const nonExistentPath = join(testDir, 'non-existent.md');
+      expect(countPhases(nonExistentPath)).toBe(0);
+    });
+  });
+
+  describe('countStories', () => {
+    it('正しくStory数をカウントする', () => {
+      const content = `# tasks.md
+
+## Phase 0: 要件定義（Requirements）
+### Story 0.1: 要件定義書作成
+### Story 0.2: PM承認
+
+## Phase 1: 設計（Design）
+### Story 1.1: 基本設計
+### Story 1.2: 詳細設計
+`;
+      writeFileSync(testFilePath, content, 'utf-8');
+      expect(countStories(testFilePath)).toBe(4);
+    });
+
+    it('Storyがない場合0を返す', () => {
+      const content = `# tasks.md
+
+## Phase 0: 要件定義（Requirements）
+`;
+      writeFileSync(testFilePath, content, 'utf-8');
+      expect(countStories(testFilePath)).toBe(0);
+    });
+
+    it('ファイルが存在しない場合0を返す', () => {
+      const nonExistentPath = join(testDir, 'non-existent.md');
+      expect(countStories(nonExistentPath)).toBe(0);
+    });
+  });
+});
+
+

package/scripts/utils/__tests__/test-runner.test.ts

@@ -0,0 +1,77 @@
+/**
+ * テストランナーのユニットテスト
+ */
+
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { generateTestReport, type TestResult } from '../test-runner.js';
+
+// child_processのモック
+vi.mock('child_process', () => ({
+  exec: vi.fn()
+}));
+
+vi.mock('util', () => ({
+  promisify: vi.fn((fn) => fn)
+}));
+
+describe('test-runner', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  // executeTestsは実際のコマンド実行に依存するため、統合テストとして別途実施
+  // ここでは generateTestReport の単体テストのみ実施
+
+  describe('executeTests', () => {
+    it.skip('Node.js/TypeScriptプロジェクトでnpm testを実行する', async () => {
+      // 統合テストとして別途実施
+    });
+
+    it.skip('Javaプロジェクトでgradle testを実行する', async () => {
+      // 統合テストとして別途実施
+    });
+
+    it.skip('テスト失敗時にエラー情報を返す', async () => {
+      // 統合テストとして別途実施
+    });
+  });
+
+  describe('generateTestReport', () => {
+    it('テスト結果からMarkdownレポートを生成する', () => {
+      const testResult: TestResult = {
+        success: true,
+        language: 'Node.js/TypeScript',
+        command: 'npm test',
+        output: 'Test Suites: 5 passed, 5 total\nTests: 50 passed, 50 total',
+        duration: 15.5,
+        timestamp: '2025-12-03T10:00:00Z'
+      };
+
+      const report = generateTestReport(testResult, 'user-auth');
+
+      expect(report).toContain('# テスト実行レポート: user-auth');
+      expect(report).toContain('✅ 成功');
+      expect(report).toContain('Node.js/TypeScript');
+      expect(report).toContain('npm test');
+      expect(report).toContain('15.5');
+    });
+
+    it('テスト失敗時のレポートを生成する', () => {
+      const testResult: TestResult = {
+        success: false,
+        language: 'Java',
+        command: 'gradle test',
+        output: '',
+        error: 'Test failed',
+        duration: 5.0,
+        timestamp: '2025-12-03T10:00:00Z'
+      };
+
+      const report = generateTestReport(testResult, 'payment');
+
+      expect(report).toContain('# テスト実行レポート: payment');
+      expect(report).toContain('❌ 失敗');
+      expect(report).toContain('Test failed');
+    });
+  });
+});

package/scripts/utils/aidlc-parser.ts

@@ -0,0 +1,289 @@
+/**
+ * AI-DLC形式のtasks.mdパーサー
+ *
+ * AI-DLC形式:
+ * - `## 1. Category Name` のようなカテゴリヘッダー
+ * - `- [ ] 1.1 Task description` のようなタスク形式
+ * - 任意の `_Requirements: X.X, Y.Y_` タグ
+ * - 任意の `(P)` 並列実行マーカー
+ */
+
+import { readFileSync } from 'fs';
+
+/**
+ * AI-DLC形式のタスク
+ */
+export interface AIDLCTask {
+  id: string; // "1.1", "2.3" など
+  title: string; // タスクのタイトル
+  description: string[]; // インデントされた詳細行
+  requirements: string[]; // 関連する要件ID
+  isParallel: boolean; // (P)マーカーがあるか
+  completed: boolean; // チェックボックスの状態
+}
+
+/**
+ * AI-DLC形式のカテゴリ
+ */
+export interface AIDLCCategory {
+  id: string; // "1", "2" など
+  title: string; // カテゴリ名
+  tasks: AIDLCTask[];
+}
+
+/**
+ * AI-DLC形式のドキュメント
+ */
+export interface AIDLCDocument {
+  title: string; // ドキュメントタイトル
+  categories: AIDLCCategory[];
+  summary?: AIDLCSummary; // オプショナルなサマリーセクション
+  rawContent: string; // 元のコンテンツ
+}
+
+/**
+ * AI-DLC形式のサマリー情報
+ */
+export interface AIDLCSummary {
+  majorTasks?: number;
+  subTasks?: number;
+  estimatedHours?: string;
+  requirementsCoverage?: Map<string, string[]>; // 要件ID -> タスクID[]
+}
+
+/**
+ * AI-DLC形式かどうかを判定
+ *
+ * 判定基準:
+ * 1. `- [ ] X.Y` 形式のチェックボックスパターンが存在
+ * 2. Phase構造（Phase 0.1:, Phase 2: など）が存在しない
+ *
+ * @param content - 検証するコンテンツ
+ * @returns AI-DLC形式の場合true
+ */
+export function isAIDLCFormat(content: string): boolean {
+  // AI-DLCパターン: "- [ ] 1." or "- [x] 1." (数字.で始まるタスク)
+  const hasAIDLCPattern = /^- \[[ x]\] \d+\./m.test(content);
+
+  // Michiワークフロー形式のPhase構造
+  const hasPhaseStructure =
+    content.includes('Phase 0:') ||
+    content.includes('Phase 0.1:') ||
+    content.includes('Phase 2:') ||
+    content.includes('## Phase');
+
+  // Story構造もチェック
+  const hasStoryStructure = /### Story \d+\.\d+:/.test(content);
+
+  return hasAIDLCPattern && !hasPhaseStructure && !hasStoryStructure;
+}
+
+/**
+ * AI-DLC形式のコンテンツをパース
+ *
+ * @param content - パースするコンテンツ
+ * @returns パースされたドキュメント
+ */
+export function parseAIDLCFormat(content: string): AIDLCDocument {
+  const lines = content.split('\n');
+  const document: AIDLCDocument = {
+    title: '',
+    categories: [],
+    rawContent: content,
+  };
+
+  // タイトル抽出（最初の # で始まる行）
+  const titleMatch = content.match(/^# (.+)$/m);
+  if (titleMatch) {
+    document.title = titleMatch[1].trim();
+  }
+
+  let currentCategory: AIDLCCategory | null = null;
+  let currentTask: AIDLCTask | null = null;
+  let inSummarySection = false;
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const trimmedLine = line.trim();
+
+    // サマリーセクションの検出
+    if (
+      trimmedLine.startsWith('## 要件カバレッジ') ||
+      trimmedLine.startsWith('## Requirements Coverage') ||
+      trimmedLine.startsWith('## 並列実行可能') ||
+      trimmedLine.startsWith('## Parallel') ||
+      trimmedLine.startsWith('## タスク見積') ||
+      trimmedLine.startsWith('## Task Estimate') ||
+      trimmedLine === '---'
+    ) {
+      inSummarySection = true;
+      // 現在のタスクを保存
+      if (currentTask && currentCategory) {
+        currentCategory.tasks.push(currentTask);
+        currentTask = null;
+      }
+      continue;
+    }
+
+    if (inSummarySection) {
+      // サマリーセクションの解析（オプション）
+      parseSummaryLine(document, trimmedLine);
+      continue;
+    }
+
+    // カテゴリヘッダー: ## 1. Category Name
+    const categoryMatch = trimmedLine.match(/^## (\d+)\. (.+)$/);
+    if (categoryMatch) {
+      // 前のタスクを保存
+      if (currentTask && currentCategory) {
+        currentCategory.tasks.push(currentTask);
+        currentTask = null;
+      }
+      // 前のカテゴリを保存
+      if (currentCategory) {
+        document.categories.push(currentCategory);
+      }
+
+      currentCategory = {
+        id: categoryMatch[1],
+        title: categoryMatch[2].trim(),
+        tasks: [],
+      };
+      continue;
+    }
+
+    // タスク行: - [ ] 1.1 Task description または - [x] 1.1 Task description
+    const taskMatch = trimmedLine.match(
+      /^- \[([ x])\] (\d+\.\d+\*?) (?:\(P\) )?(.+)$/,
+    );
+    if (taskMatch && currentCategory) {
+      // 前のタスクを保存
+      if (currentTask) {
+        currentCategory.tasks.push(currentTask);
+      }
+
+      const isParallel =
+        trimmedLine.includes('(P)') || taskMatch[2].endsWith('*');
+      const taskId = taskMatch[2].replace('*', '');
+
+      currentTask = {
+        id: taskId,
+        title: taskMatch[3].trim(),
+        description: [],
+        requirements: [],
+        isParallel,
+        completed: taskMatch[1] === 'x',
+      };
+      continue;
+    }
+
+    // タスクの詳細行（インデントされた行）
+    if (currentTask && line.startsWith('  ') && trimmedLine) {
+      // Requirements タグの抽出
+      const reqMatch = trimmedLine.match(/_Requirements?: (.+)_|_要件: (.+)_/i);
+      if (reqMatch) {
+        const reqString = reqMatch[1] || reqMatch[2];
+        const requirements = reqString.split(',').map((r) => r.trim());
+        currentTask.requirements.push(...requirements);
+      } else {
+        // 通常の詳細行
+        currentTask.description.push(trimmedLine.replace(/^- /, ''));
+      }
+    }
+  }
+
+  // 最後のタスクとカテゴリを保存
+  if (currentTask && currentCategory) {
+    currentCategory.tasks.push(currentTask);
+  }
+  if (currentCategory) {
+    document.categories.push(currentCategory);
+  }
+
+  return document;
+}
+
+/**
+ * サマリー行を解析
+ */
+function parseSummaryLine(document: AIDLCDocument, line: string): void {
+  if (!document.summary) {
+    document.summary = {};
+  }
+
+  // Major Tasks
+  const majorMatch = line.match(/Major Tasks.*?(\d+)/i);
+  if (majorMatch) {
+    document.summary.majorTasks = parseInt(majorMatch[1], 10);
+  }
+
+  // Sub-Tasks
+  const subMatch = line.match(/Sub-?Tasks.*?(\d+)/i);
+  if (subMatch) {
+    document.summary.subTasks = parseInt(subMatch[1], 10);
+  }
+
+  // Estimated hours
+  const hoursMatch = line.match(
+    /総工数見積.*?[:：]?\s*(.+)|Estimated.*?[:：]?\s*(.+)/i,
+  );
+  if (hoursMatch) {
+    document.summary.estimatedHours = (hoursMatch[1] || hoursMatch[2]).trim();
+  }
+}
+
+/**
+ * ファイルからAI-DLC形式をパース
+ *
+ * @param filePath - ファイルパス
+ * @returns パースされたドキュメント
+ * @throws ファイルが存在しない、またはAI-DLC形式でない場合
+ */
+export function parseAIDLCFile(filePath: string): AIDLCDocument {
+  const content = readFileSync(filePath, 'utf-8');
+
+  if (!isAIDLCFormat(content)) {
+    throw new Error(
+      `File is not in AI-DLC format: ${filePath}\n` +
+        'Expected format: "- [ ] X.Y Task description" without Phase structure',
+    );
+  }
+
+  return parseAIDLCFormat(content);
+}
+
+/**
+ * AI-DLCドキュメントの統計情報を取得
+ *
+ * @param doc - AI-DLCドキュメント
+ * @returns 統計情報
+ */
+export function getAIDLCStats(doc: AIDLCDocument): {
+  totalCategories: number;
+  totalTasks: number;
+  completedTasks: number;
+  parallelTasks: number;
+  tasksWithRequirements: number;
+} {
+  let totalTasks = 0;
+  let completedTasks = 0;
+  let parallelTasks = 0;
+  let tasksWithRequirements = 0;
+
+  for (const category of doc.categories) {
+    for (const task of category.tasks) {
+      totalTasks++;
+      if (task.completed) completedTasks++;
+      if (task.isParallel) parallelTasks++;
+      if (task.requirements.length > 0) tasksWithRequirements++;
+    }
+  }
+
+  return {
+    totalCategories: doc.categories.length,
+    totalTasks,
+    completedTasks,
+    parallelTasks,
+    tasksWithRequirements,
+  };
+}