@sk8metal/michi-cli 0.0.9 → 0.2.0

package/scripts/utils/project-detector.ts

@@ -0,0 +1,192 @@
+/**
+ * プロジェクト検出ユーティリティ
+ * 既存ファイルからプロジェクト情報を自動検出
+ */
+
+import { existsSync, readFileSync } from 'fs';
+
+export interface ProjectInfo {
+  language: 'nodejs' | 'java' | 'php' | 'python' | 'go' | 'rust' | 'other';
+  buildTool: string;
+  testFramework?: string;
+  hasCI: boolean;
+  hasDependencies: boolean;
+  packageManager?: string;
+}
+
+/**
+ * プロジェクト情報を自動検出
+ */
+export function detectProject(projectRoot: string = process.cwd()): ProjectInfo {
+  // Node.js/TypeScript
+  if (existsSync(`${projectRoot}/package.json`)) {
+    return detectNodeJsProject(projectRoot);
+  }
+  
+  // Java
+  if (existsSync(`${projectRoot}/build.gradle`) || existsSync(`${projectRoot}/build.gradle.kts`)) {
+    return detectJavaProject(projectRoot, 'gradle');
+  }
+  
+  if (existsSync(`${projectRoot}/pom.xml`)) {
+    return detectJavaProject(projectRoot, 'maven');
+  }
+  
+  // PHP
+  if (existsSync(`${projectRoot}/composer.json`)) {
+    return detectPHPProject(projectRoot);
+  }
+  
+  // Python
+  if (existsSync(`${projectRoot}/requirements.txt`) || 
+      existsSync(`${projectRoot}/pyproject.toml`) ||
+      existsSync(`${projectRoot}/setup.py`)) {
+    return detectPythonProject(projectRoot);
+  }
+  
+  // Go
+  if (existsSync(`${projectRoot}/go.mod`)) {
+    return detectGoProject(projectRoot);
+  }
+  
+  // Rust
+  if (existsSync(`${projectRoot}/Cargo.toml`)) {
+    return detectRustProject(projectRoot);
+  }
+  
+  // 検出できない場合
+  return {
+    language: 'other',
+    buildTool: 'unknown',
+    hasCI: existsSync(`${projectRoot}/.github/workflows`),
+    hasDependencies: false
+  };
+}
+
+/**
+ * Node.jsプロジェクトを検出
+ */
+function detectNodeJsProject(projectRoot: string): ProjectInfo {
+  const packageJson = JSON.parse(readFileSync(`${projectRoot}/package.json`, 'utf-8'));
+  
+  // パッケージマネージャーを検出
+  let packageManager = 'npm';
+  if (existsSync(`${projectRoot}/pnpm-lock.yaml`)) {
+    packageManager = 'pnpm';
+  } else if (existsSync(`${projectRoot}/yarn.lock`)) {
+    packageManager = 'yarn';
+  }
+  
+  // テストフレームワークを検出
+  let testFramework: string | undefined;
+  const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
+  if (deps['vitest']) {
+    testFramework = 'vitest';
+  } else if (deps['jest']) {
+    testFramework = 'jest';
+  } else if (deps['mocha']) {
+    testFramework = 'mocha';
+  }
+  
+  return {
+    language: 'nodejs',
+    buildTool: packageManager,
+    testFramework,
+    hasCI: existsSync(`${projectRoot}/.github/workflows`),
+    hasDependencies: true,
+    packageManager
+  };
+}
+
+/**
+ * Javaプロジェクトを検出
+ */
+function detectJavaProject(projectRoot: string, buildTool: 'gradle' | 'maven'): ProjectInfo {
+  return {
+    language: 'java',
+    buildTool,
+    testFramework: 'junit',
+    hasCI: existsSync(`${projectRoot}/.github/workflows`),
+    hasDependencies: true
+  };
+}
+
+/**
+ * PHPプロジェクトを検出
+ */
+function detectPHPProject(projectRoot: string): ProjectInfo {
+  const composerJson = JSON.parse(readFileSync(`${projectRoot}/composer.json`, 'utf-8'));
+  
+  // テストフレームワークを検出
+  let testFramework: string | undefined;
+  const deps = { ...composerJson.require, ...composerJson['require-dev'] };
+  if (deps['phpunit/phpunit']) {
+    testFramework = 'phpunit';
+  }
+  
+  return {
+    language: 'php',
+    buildTool: 'composer',
+    testFramework,
+    hasCI: existsSync(`${projectRoot}/.github/workflows`),
+    hasDependencies: true
+  };
+}
+
+/**
+ * Pythonプロジェクトを検出
+ */
+function detectPythonProject(projectRoot: string): ProjectInfo {
+  let buildTool = 'pip';
+  let testFramework: string | undefined;
+  
+  if (existsSync(`${projectRoot}/pyproject.toml`)) {
+    buildTool = 'poetry or uv';
+    const pyproject = readFileSync(`${projectRoot}/pyproject.toml`, 'utf-8');
+    if (pyproject.includes('pytest')) {
+      testFramework = 'pytest';
+    } else if (pyproject.includes('unittest')) {
+      testFramework = 'unittest';
+    }
+  } else if (existsSync(`${projectRoot}/requirements.txt`)) {
+    const requirements = readFileSync(`${projectRoot}/requirements.txt`, 'utf-8');
+    if (requirements.includes('pytest')) {
+      testFramework = 'pytest';
+    }
+  }
+  
+  return {
+    language: 'python',
+    buildTool,
+    testFramework,
+    hasCI: existsSync(`${projectRoot}/.github/workflows`),
+    hasDependencies: true
+  };
+}
+
+/**
+ * Goプロジェクトを検出
+ */
+function detectGoProject(projectRoot: string): ProjectInfo {
+  return {
+    language: 'go',
+    buildTool: 'go',
+    testFramework: 'testing',
+    hasCI: existsSync(`${projectRoot}/.github/workflows`),
+    hasDependencies: true
+  };
+}
+
+/**
+ * Rustプロジェクトを検出
+ */
+function detectRustProject(projectRoot: string): ProjectInfo {
+  return {
+    language: 'rust',
+    buildTool: 'cargo',
+    testFramework: 'cargo-test',
+    hasCI: existsSync(`${projectRoot}/.github/workflows`),
+    hasDependencies: true
+  };
+}
+

package/scripts/utils/project-finder.ts

@@ -38,7 +38,7 @@ function loadProjectMetadata(dir: string): ProjectMetadata | null {
     const content = readFileSync(projectJsonPath, 'utf-8');
     const meta = JSON.parse(content) as ProjectMetadata;
     return meta;
-  } catch (error) {
+  } catch {
     // パースエラーなどは無視
     return null;
   }
@@ -143,7 +143,7 @@ export function findAllProjects(
         }
       }
     }
-  } catch (error) {
+  } catch {
     // アクセス権限エラーなどは無視
   }
   

package/scripts/utils/release-notes-generator.ts

@@ -0,0 +1,210 @@
+/**
+ * リリースノート生成ユーティリティ
+ * git logからコミット履歴を取得してリリースノートを生成
+ */
+
+import { exec } from 'child_process';
+import { promisify } from 'util';
+
+const execAsync = promisify(exec);
+
+/**
+ * コミット情報
+ */
+export interface Commit {
+  hash: string;
+  type: string;
+  scope?: string;
+  subject: string;
+  body?: string;
+  breaking: boolean;
+}
+
+/**
+ * リリースノート
+ */
+export interface ReleaseNotes {
+  version: string;
+  date: string;
+  features: Commit[];
+  fixes: Commit[];
+  breaking: Commit[];
+  others: Commit[];
+}
+
+/**
+ * git logからコミット履歴を取得
+ * @param fromTag 開始タグ (省略時は最新タグから)
+ * @param toTag 終了タグ (デフォルト: HEAD)
+ * @param projectRoot プロジェクトルート
+ * @returns コミット一覧
+ */
+export async function getCommits(
+  fromTag?: string,
+  toTag: string = 'HEAD',
+  projectRoot: string = process.cwd()
+): Promise<Commit[]> {
+  // 開始タグが指定されていない場合、最新タグを取得
+  if (!fromTag) {
+    try {
+      const { stdout } = await execAsync('git describe --tags --abbrev=0', {
+        cwd: projectRoot
+      });
+      fromTag = stdout.trim();
+    } catch {
+      // タグが存在しない場合は全コミットを取得
+      fromTag = '';
+    }
+  }
+
+  // git logコマンドを構築
+  const range = fromTag ? `${fromTag}..${toTag}` : toTag;
+  const command = `git log ${range} --pretty=format:"%H%n%s%n%b%n---END---"`;
+
+  try {
+    const { stdout } = await execAsync(command, { cwd: projectRoot });
+
+    const commits: Commit[] = [];
+    const commitBlocks = stdout.split('---END---').filter(block => block.trim());
+
+    for (const block of commitBlocks) {
+      const lines = block.trim().split('\n');
+      if (lines.length < 2) continue;
+
+      const hash = lines[0];
+      const subject = lines[1];
+      const body = lines.slice(2).join('\n').trim();
+
+      // Conventional Commitsパターンを解析
+      const conventionalPattern = /^(\w+)(\(([^)]+)\))?(!)?:\s*(.+)$/;
+      const match = subject.match(conventionalPattern);
+
+      if (match) {
+        commits.push({
+          hash,
+          type: match[1],
+          scope: match[3],
+          subject: match[5],
+          body: body || undefined,
+          breaking: !!match[4] || body.includes('BREAKING CHANGE')
+        });
+      } else {
+        // Conventional Commitsに従っていない場合はothersに分類
+        commits.push({
+          hash,
+          type: 'other',
+          subject,
+          body: body || undefined,
+          breaking: body.includes('BREAKING CHANGE')
+        });
+      }
+    }
+
+    return commits;
+  } catch (error: any) {
+    console.error('Failed to get commits:', error.message);
+    return [];
+  }
+}
+
+/**
+ * コミット一覧からリリースノートを生成
+ * @param commits コミット一覧
+ * @param version リリースバージョン
+ * @returns リリースノート
+ */
+export function generateReleaseNotes(
+  commits: Commit[],
+  version: string
+): ReleaseNotes {
+  const notes: ReleaseNotes = {
+    version,
+    date: new Date().toISOString().split('T')[0],
+    features: [],
+    fixes: [],
+    breaking: [],
+    others: []
+  };
+
+  for (const commit of commits) {
+    if (commit.breaking) {
+      notes.breaking.push(commit);
+    } else if (commit.type === 'feat') {
+      notes.features.push(commit);
+    } else if (commit.type === 'fix') {
+      notes.fixes.push(commit);
+    } else {
+      notes.others.push(commit);
+    }
+  }
+
+  return notes;
+}
+
+/**
+ * リリースノートをMarkdown形式で出力
+ * @param notes リリースノート
+ * @returns Markdown文字列
+ */
+export function formatReleaseNotes(notes: ReleaseNotes): string {
+  let markdown = `# Release ${notes.version}\n\n`;
+  markdown += `**Release Date**: ${notes.date}\n\n`;
+
+  if (notes.breaking.length > 0) {
+    markdown += '## ⚠️ Breaking Changes\n\n';
+    for (const commit of notes.breaking) {
+      const scope = commit.scope ? `**${commit.scope}**: ` : '';
+      markdown += `- ${scope}${commit.subject} (${commit.hash.substring(0, 7)})\n`;
+      if (commit.body) {
+        markdown += `  ${commit.body.split('\n').join('\n  ')}\n`;
+      }
+    }
+    markdown += '\n';
+  }
+
+  if (notes.features.length > 0) {
+    markdown += '## ✨ Features\n\n';
+    for (const commit of notes.features) {
+      const scope = commit.scope ? `**${commit.scope}**: ` : '';
+      markdown += `- ${scope}${commit.subject} (${commit.hash.substring(0, 7)})\n`;
+    }
+    markdown += '\n';
+  }
+
+  if (notes.fixes.length > 0) {
+    markdown += '## 🐛 Bug Fixes\n\n';
+    for (const commit of notes.fixes) {
+      const scope = commit.scope ? `**${commit.scope}**: ` : '';
+      markdown += `- ${scope}${commit.subject} (${commit.hash.substring(0, 7)})\n`;
+    }
+    markdown += '\n';
+  }
+
+  if (notes.others.length > 0) {
+    markdown += '## 📝 Other Changes\n\n';
+    for (const commit of notes.others) {
+      const scope = commit.scope ? `**${commit.scope}**: ` : '';
+      markdown += `- ${scope}${commit.subject} (${commit.hash.substring(0, 7)})\n`;
+    }
+    markdown += '\n';
+  }
+
+  return markdown;
+}
+
+/**
+ * リリースノートを生成してMarkdown文字列を返す
+ * @param version リリースバージョン
+ * @param fromTag 開始タグ
+ * @param projectRoot プロジェクトルート
+ * @returns Markdown形式のリリースノート
+ */
+export async function createReleaseNotes(
+  version: string,
+  fromTag?: string,
+  projectRoot: string = process.cwd()
+): Promise<string> {
+  const commits = await getCommits(fromTag, 'HEAD', projectRoot);
+  const notes = generateReleaseNotes(commits, version);
+  return formatReleaseNotes(notes);
+}

package/scripts/utils/spec-loader.ts

@@ -0,0 +1,125 @@
+/**
+ * spec.json から JIRA 情報を読み込むユーティリティ
+ *
+ * kiro:spec-impl ワークフローで使用され、spec.json から
+ * Epic/Story のキーを自動取得する
+ */
+
+import { loadSpecJson } from './spec-updater.js';
+
+/**
+ * spec.json から抽出された JIRA 情報
+ */
+export interface JiraInfo {
+  /** Epic キー (例: "PROJ-123") */
+  epicKey: string | null;
+  /** Story キーの配列 */
+  storyKeys: string[];
+  /** 最初の Story キー（実装時のメインターゲット） */
+  firstStoryKey: string | null;
+  /** JIRA プロジェクトキー (例: "PROJ") */
+  projectKey: string | null;
+  /** Epic の URL */
+  epicUrl: string | null;
+}
+
+/**
+ * JIRA 情報の存在状態
+ */
+export interface JiraInfoStatus {
+  /** JIRA 情報が存在するか */
+  hasJiraInfo: boolean;
+  /** Epic キーが存在するか */
+  hasEpic: boolean;
+  /** Story が存在するか */
+  hasStories: boolean;
+  /** 不足している情報のリスト */
+  missing: string[];
+}
+
+/**
+ * spec.json から JIRA 情報を取得
+ *
+ * @param featureName 機能名
+ * @param projectRoot プロジェクトルート（デフォルト: process.cwd()）
+ * @returns JIRA 情報
+ *
+ * @example
+ * ```typescript
+ * const jiraInfo = getJiraInfoFromSpec('user-auth');
+ * if (jiraInfo.epicKey) {
+ *   await transitionToInProgress(jiraInfo.epicKey);
+ * }
+ * if (jiraInfo.firstStoryKey) {
+ *   await transitionToInProgress(jiraInfo.firstStoryKey);
+ * }
+ * ```
+ */
+export function getJiraInfoFromSpec(
+  featureName: string,
+  projectRoot: string = process.cwd(),
+): JiraInfo {
+  const spec = loadSpecJson(featureName, projectRoot);
+
+  return {
+    epicKey: spec.jira?.epicKey || null,
+    storyKeys: spec.jira?.storyKeys || [],
+    firstStoryKey: spec.jira?.storyKeys?.[0] || null,
+    projectKey: spec.jira?.projectKey || null,
+    epicUrl: spec.jira?.epicUrl || null,
+  };
+}
+
+/**
+ * JIRA 情報の存在状態をチェック
+ *
+ * @param featureName 機能名
+ * @param projectRoot プロジェクトルート（デフォルト: process.cwd()）
+ * @returns JIRA 情報の存在状態
+ *
+ * @example
+ * ```typescript
+ * const status = checkJiraInfoStatus('user-auth');
+ * if (!status.hasJiraInfo) {
+ *   console.log('JIRA 情報がありません:', status.missing.join(', '));
+ *   // ユーザーに確認: "JIRA連携をスキップしますか？"
+ * }
+ * ```
+ */
+export function checkJiraInfoStatus(
+  featureName: string,
+  projectRoot: string = process.cwd(),
+): JiraInfoStatus {
+  const jiraInfo = getJiraInfoFromSpec(featureName, projectRoot);
+  const missing: string[] = [];
+
+  if (!jiraInfo.epicKey) {
+    missing.push('Epic');
+  }
+  if (jiraInfo.storyKeys.length === 0) {
+    missing.push('Story');
+  }
+
+  return {
+    hasJiraInfo: jiraInfo.epicKey !== null || jiraInfo.storyKeys.length > 0,
+    hasEpic: jiraInfo.epicKey !== null,
+    hasStories: jiraInfo.storyKeys.length > 0,
+    missing,
+  };
+}
+
+/**
+ * JIRA 連携に必要な情報が揃っているかチェック
+ *
+ * @param featureName 機能名
+ * @param projectRoot プロジェクトルート
+ * @returns true: JIRA 連携可能, false: 不可
+ */
+export function canIntegrateWithJira(
+  featureName: string,
+  projectRoot: string = process.cwd(),
+): boolean {
+  const status = checkJiraInfoStatus(featureName, projectRoot);
+  // Epic があれば JIRA 連携可能（Story がなくても Epic のみ更新）
+  return status.hasEpic;
+}

package/scripts/utils/spec-updater.ts

@@ -4,7 +4,7 @@
  */
 
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
-import { resolve, dirname } from 'path';
+import { resolve } from 'path';
 
 /**
  * spec.json の型定義
@@ -36,6 +36,13 @@ export interface SpecJson {
     epicUrl?: string;
     storyKeys?: string[];
   };
+  environmentSetup?: {
+    completed?: boolean;
+    language?: string;
+    ciTool?: string;
+    dockerCompose?: boolean;
+    completedAt?: string;
+  };
   milestones?: {
     requirementsCompleted?: boolean;
     designCompleted?: boolean;