@sk8metal/michi-cli 0.8.7 → 0.11.0

package/scripts/__tests__/multi-repo-validator.test.ts

@@ -3,12 +3,17 @@
  * Task 11.1: バリデーション関数の単体テスト
  */
 
-import { describe, it, expect } from 'vitest';
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'fs';
+import * as path from 'path';
+import { execSync } from 'child_process';
 import {
   validateProjectName,
   validateJiraKey,
   validateRepositoryUrl,
+  validateLocalPath,
 } from '../utils/multi-repo-validator.js';
+import type { Repository } from '../config/config-schema.js';
 
 describe('validateProjectName', () => {
   describe('正常ケース', () => {
@@ -522,3 +527,226 @@ describe('validateRepositoryUrl', () => {
     });
   });
 });
+
+describe('validateLocalPath', () => {
+  let tempDir: string;
+
+  beforeEach(() => {
+    // テスト用の一時ディレクトリを作成
+    tempDir = fs.mkdtempSync(path.join(process.cwd(), 'test-temp-'));
+  });
+
+  afterEach(() => {
+    // テスト用の一時ディレクトリを削除
+    if (fs.existsSync(tempDir)) {
+      fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+
+  describe('localPath未設定ケース', () => {
+    it('localPathが未設定の場合、警告を返す', () => {
+      const repository: Repository = {
+        name: 'test-repo',
+        url: 'https://github.com/owner/repo',
+        branch: 'main',
+        // localPath: undefined (省略)
+      };
+
+      const result = validateLocalPath(repository);
+
+      expect(result.isValid).toBe(false);
+      expect(result.errors).toHaveLength(0);
+      expect(result.warnings).toHaveLength(1);
+      expect(result.warnings[0]).toContain(
+        "Repository 'test-repo' does not have localPath configured",
+      );
+      expect(result.exists).toBe(false);
+      expect(result.isGitRepository).toBe(false);
+      expect(result.currentBranch).toBeNull();
+      expect(result.branchMatches).toBe(false);
+      expect(result.hasUncommittedChanges).toBe(false);
+    });
+  });
+
+  describe('ディレクトリ存在確認', () => {
+    it('localPathが存在しない場合、エラーを返す', () => {
+      const nonExistentPath = path.join(tempDir, 'non-existent');
+      const repository: Repository = {
+        name: 'test-repo',
+        url: 'https://github.com/owner/repo',
+        branch: 'main',
+        localPath: nonExistentPath,
+      };
+
+      const result = validateLocalPath(repository);
+
+      expect(result.isValid).toBe(false);
+      expect(result.errors).toHaveLength(1);
+      expect(result.errors[0]).toContain('does not exist');
+      expect(result.exists).toBe(false);
+    });
+
+    it('localPathがファイルの場合、エラーを返す', () => {
+      const filePath = path.join(tempDir, 'test-file.txt');
+      fs.writeFileSync(filePath, 'test content');
+
+      const repository: Repository = {
+        name: 'test-repo',
+        url: 'https://github.com/owner/repo',
+        branch: 'main',
+        localPath: filePath,
+      };
+
+      const result = validateLocalPath(repository);
+
+      expect(result.isValid).toBe(false);
+      expect(result.errors).toHaveLength(1);
+      expect(result.errors[0]).toContain('is not a directory');
+      expect(result.exists).toBe(true);
+      expect(result.isGitRepository).toBe(false);
+    });
+  });
+
+  describe('Gitリポジトリ確認', () => {
+    it('Gitリポジトリではないディレクトリの場合、エラーを返す', () => {
+      const nonGitDir = path.join(tempDir, 'non-git-repo');
+      fs.mkdirSync(nonGitDir);
+
+      const repository: Repository = {
+        name: 'test-repo',
+        url: 'https://github.com/owner/repo',
+        branch: 'main',
+        localPath: nonGitDir,
+      };
+
+      const result = validateLocalPath(repository);
+
+      expect(result.isValid).toBe(false);
+      expect(result.errors).toHaveLength(1);
+      expect(result.errors[0]).toContain('is not a Git repository');
+      expect(result.exists).toBe(true);
+      expect(result.isGitRepository).toBe(false);
+    });
+
+    it('Gitリポジトリの場合、基本的なチェックを通過する', () => {
+      const gitDir = path.join(tempDir, 'git-repo');
+      fs.mkdirSync(gitDir);
+
+      // Gitリポジトリを初期化
+      execSync('git init', { cwd: gitDir });
+      execSync('git config user.email "test@example.com"', { cwd: gitDir });
+      execSync('git config user.name "Test User"', { cwd: gitDir });
+
+      // 初回コミットを作成（ブランチが作成されるため）
+      fs.writeFileSync(path.join(gitDir, 'README.md'), '# Test');
+      execSync('git add .', { cwd: gitDir });
+      execSync('git commit -m "Initial commit"', { cwd: gitDir });
+
+      // mainブランチに切り替え（git initでデフォルトブランチ名が異なる可能性があるため）
+      try {
+        execSync('git branch -M main', { cwd: gitDir });
+      } catch {
+        // すでにmainの場合は無視
+      }
+
+      const repository: Repository = {
+        name: 'test-repo',
+        url: 'https://github.com/owner/repo',
+        branch: 'main',
+        localPath: gitDir,
+      };
+
+      const result = validateLocalPath(repository);
+
+      expect(result.isValid).toBe(true);
+      expect(result.errors).toHaveLength(0);
+      expect(result.exists).toBe(true);
+      expect(result.isGitRepository).toBe(true);
+      expect(result.currentBranch).toBe('main');
+      expect(result.branchMatches).toBe(true);
+      expect(result.hasUncommittedChanges).toBe(false);
+    });
+
+    it('ブランチが一致しない場合、警告を返す', () => {
+      const gitDir = path.join(tempDir, 'git-repo-branch-mismatch');
+      fs.mkdirSync(gitDir);
+
+      // Gitリポジトリを初期化
+      execSync('git init', { cwd: gitDir });
+      execSync('git config user.email "test@example.com"', { cwd: gitDir });
+      execSync('git config user.name "Test User"', { cwd: gitDir });
+
+      // 初回コミットを作成
+      fs.writeFileSync(path.join(gitDir, 'README.md'), '# Test');
+      execSync('git add .', { cwd: gitDir });
+      execSync('git commit -m "Initial commit"', { cwd: gitDir });
+
+      // developブランチに切り替え
+      execSync('git checkout -b develop', { cwd: gitDir });
+
+      const repository: Repository = {
+        name: 'test-repo',
+        url: 'https://github.com/owner/repo',
+        branch: 'main', // 実際はdevelopブランチにいる
+        localPath: gitDir,
+      };
+
+      const result = validateLocalPath(repository);
+
+      expect(result.isValid).toBe(true); // 警告のみでエラーではない
+      expect(result.errors).toHaveLength(0);
+      expect(result.warnings.length).toBeGreaterThan(0);
+      expect(result.warnings.some((w) => w.includes('does not match'))).toBe(
+        true,
+      );
+      expect(result.exists).toBe(true);
+      expect(result.isGitRepository).toBe(true);
+      expect(result.currentBranch).toBe('develop');
+      expect(result.branchMatches).toBe(false);
+    });
+
+    it('未コミット変更がある場合、警告を返す', () => {
+      const gitDir = path.join(tempDir, 'git-repo-uncommitted');
+      fs.mkdirSync(gitDir);
+
+      // Gitリポジトリを初期化
+      execSync('git init', { cwd: gitDir });
+      execSync('git config user.email "test@example.com"', { cwd: gitDir });
+      execSync('git config user.name "Test User"', { cwd: gitDir });
+
+      // 初回コミットを作成
+      fs.writeFileSync(path.join(gitDir, 'README.md'), '# Test');
+      execSync('git add .', { cwd: gitDir });
+      execSync('git commit -m "Initial commit"', { cwd: gitDir });
+
+      // mainブランチに切り替え
+      try {
+        execSync('git branch -M main', { cwd: gitDir });
+      } catch {
+        // すでにmainの場合は無視
+      }
+
+      // 未コミットの変更を追加
+      fs.writeFileSync(path.join(gitDir, 'new-file.txt'), 'uncommitted');
+
+      const repository: Repository = {
+        name: 'test-repo',
+        url: 'https://github.com/owner/repo',
+        branch: 'main',
+        localPath: gitDir,
+      };
+
+      const result = validateLocalPath(repository);
+
+      expect(result.isValid).toBe(true); // 警告のみでエラーではない
+      expect(result.errors).toHaveLength(0);
+      expect(result.warnings.length).toBeGreaterThan(0);
+      expect(
+        result.warnings.some((w) => w.includes('uncommitted changes')),
+      ).toBe(true);
+      expect(result.exists).toBe(true);
+      expect(result.isGitRepository).toBe(true);
+      expect(result.hasUncommittedChanges).toBe(true);
+    });
+  });
+});

package/scripts/config/config-schema.ts

@@ -183,6 +183,26 @@ export const RepositorySchema = z.object({
       message: 'GitHub URL must be in format: https://github.com/{owner}/{repo}',
     }),
   branch: z.string().default('main'),
+  localPath: z
+    .string()
+    .optional()
+    .refine(
+      (path) => {
+        // localPath が指定されていない場合は検証スキップ
+        if (path === undefined) return true;
+        // 空文字列はエラー
+        if (path === '') return false;
+        // 絶対パスであることを検証（セキュリティ考慮）
+        // Unix系: '/' で始まる、Windows系: 'C:\' 等で始まる
+        const isUnixAbsolutePath = path.startsWith('/');
+        const isWindowsAbsolutePath = /^[A-Za-z]:\\/.test(path);
+        return isUnixAbsolutePath || isWindowsAbsolutePath;
+      },
+      {
+        message:
+          'localPath must be an absolute path (Unix: /path/to/repo, Windows: C:\\path\\to\\repo)',
+      },
+    ),
 });
 
 /**

package/scripts/phase-runner.ts

@@ -229,7 +229,7 @@ async function checkTasksPrerequisites(
   const tasksPath = join(process.cwd(), '.kiro', 'specs', feature, 'tasks.md');
   if (!existsSync(tasksPath)) {
     errors.push(
-      'tasks.mdが存在しません。先に/kiro:spec-tasks を実行してください',
+      'tasks.mdが存在しません。先に/michi:spec-tasks を実行してください',
     );
     return { valid: false, errors };
   }

package/scripts/utils/__tests__/multi-repo-validator.test.ts

@@ -3,12 +3,19 @@
  * Task 1.2: バリデーション関数の実装
  */
 
-import { describe, it, expect } from 'vitest';
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
 import {
   validateProjectName,
   validateJiraKey,
   validateRepositoryUrl,
+  hasMichiSetup,
+  getMichiSetupCommand,
+  validateLocalPath,
 } from '../multi-repo-validator';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import type { Repository } from '../../config/config-schema';
 
 describe('validateProjectName', () => {
   describe('正常ケース', () => {
@@ -333,3 +340,154 @@ describe('validateRepositoryUrl', () => {
     });
   });
 });
+
+describe('hasMichiSetup', () => {
+  let tempDir: string;
+
+  beforeEach(() => {
+    // 一時ディレクトリを作成
+    tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'michi-test-'));
+  });
+
+  afterEach(() => {
+    // 一時ディレクトリを削除
+    fs.rmSync(tempDir, { recursive: true, force: true });
+  });
+
+  describe('Michi導入済みの場合', () => {
+    it('.kiro/project.json が存在する場合はtrueを返す', () => {
+      // .kiro ディレクトリを作成
+      const kiroDir = path.join(tempDir, '.kiro');
+      fs.mkdirSync(kiroDir);
+
+      // project.json を作成
+      const projectJson = path.join(kiroDir, 'project.json');
+      fs.writeFileSync(projectJson, '{}');
+
+      const result = hasMichiSetup(tempDir);
+      expect(result).toBe(true);
+    });
+  });
+
+  describe('Michi未導入の場合', () => {
+    it('.kiro/project.json が存在しない場合はfalseを返す', () => {
+      // .kiro ディレクトリのみ作成（project.jsonなし）
+      const kiroDir = path.join(tempDir, '.kiro');
+      fs.mkdirSync(kiroDir);
+
+      const result = hasMichiSetup(tempDir);
+      expect(result).toBe(false);
+    });
+
+    it('.kiro ディレクトリ自体が存在しない場合はfalseを返す', () => {
+      // .kiro ディレクトリを作成しない
+      const result = hasMichiSetup(tempDir);
+      expect(result).toBe(false);
+    });
+  });
+});
+
+describe('getMichiSetupCommand', () => {
+  it('正しいセットアップコマンドを生成する（シングルクォートでラップ）', () => {
+    const localPath = '/path/to/repo';
+    const command = getMichiSetupCommand(localPath);
+    expect(command).toBe(
+      "cd '/path/to/repo' && npx @sk8metal/michi-cli@latest init",
+    );
+  });
+
+  it('スペースを含むパスを正しくエスケープする', () => {
+    const localPath = '/path/to/my repo';
+    const command = getMichiSetupCommand(localPath);
+    expect(command).toBe(
+      "cd '/path/to/my repo' && npx @sk8metal/michi-cli@latest init",
+    );
+  });
+
+  it('シングルクォートを含むパスを正しくエスケープする', () => {
+    const localPath = "/path/to/user's repo";
+    const command = getMichiSetupCommand(localPath);
+    expect(command).toBe(
+      "cd '/path/to/user'\\''s repo' && npx @sk8metal/michi-cli@latest init",
+    );
+  });
+
+  it('複数のシングルクォートを含むパスを正しくエスケープする', () => {
+    const localPath = "/path/to/'test'/repo's/dir";
+    const command = getMichiSetupCommand(localPath);
+    expect(command).toBe(
+      "cd '/path/to/'\\''test'\\''/repo'\\''s/dir' && npx @sk8metal/michi-cli@latest init",
+    );
+  });
+
+  it('スペースとシングルクォート両方を含むパスを正しくエスケープする', () => {
+    const localPath = "/path/to/user's test repo";
+    const command = getMichiSetupCommand(localPath);
+    expect(command).toBe(
+      "cd '/path/to/user'\\''s test repo' && npx @sk8metal/michi-cli@latest init",
+    );
+  });
+});
+
+describe('validateLocalPath - Michi導入チェック', () => {
+  let tempDir: string;
+  let repository: Repository;
+
+  beforeEach(() => {
+    // 一時ディレクトリを作成
+    tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'michi-test-'));
+
+    // リポジトリオブジェクトを作成
+    repository = {
+      name: 'test-repo',
+      url: 'https://github.com/test/repo',
+      branch: 'main',
+      localPath: tempDir,
+    };
+  });
+
+  afterEach(() => {
+    // 一時ディレクトリを削除
+    fs.rmSync(tempDir, { recursive: true, force: true });
+  });
+
+  it('Michi導入済みリポジトリの場合、hasMichiSetupがtrueになる', () => {
+    // .git ディレクトリを作成（Gitリポジトリとして認識させる）
+    fs.mkdirSync(path.join(tempDir, '.git'));
+
+    // .kiro/project.json を作成（Michi導入済み）
+    const kiroDir = path.join(tempDir, '.kiro');
+    fs.mkdirSync(kiroDir);
+    fs.writeFileSync(path.join(kiroDir, 'project.json'), '{}');
+
+    const result = validateLocalPath(repository);
+    expect(result.hasMichiSetup).toBe(true);
+    expect(result.michiSetupCommand).toBeNull();
+  });
+
+  it('Michi未導入リポジトリの場合、hasMichiSetupがfalseになり警告が追加される', () => {
+    // .git ディレクトリを作成（Gitリポジトリとして認識させる）
+    fs.mkdirSync(path.join(tempDir, '.git'));
+
+    // .kiro/project.json は作成しない（Michi未導入）
+
+    const result = validateLocalPath(repository);
+    expect(result.hasMichiSetup).toBe(false);
+    expect(result.michiSetupCommand).not.toBeNull();
+    expect(result.warnings).toContain(
+      `Repository 'test-repo' does not have Michi setup (.kiro/project.json not found)`,
+    );
+  });
+
+  it('Gitリポジトリでない場合、hasMichiSetupはfalseでmichiSetupCommandはnull', () => {
+    // .git ディレクトリを作成しない（Gitリポジトリでない）
+
+    const result = validateLocalPath(repository);
+    expect(result.isValid).toBe(false);
+    expect(result.hasMichiSetup).toBe(false);
+    expect(result.michiSetupCommand).toBeNull();
+    expect(result.errors).toContain(
+      `localPath '${tempDir}' is not a Git repository (no .git directory)`,
+    );
+  });
+});

package/scripts/utils/multi-repo-validator.ts

@@ -2,9 +2,14 @@
  * multi-repo-validator.ts
  * Multi-Repo機能のバリデーションユーティリティ
  *
- * プロジェクト名、JIRAキー、リポジトリURLのバリデーションとセキュリティチェックを行います。
+ * プロジェクト名、JIRAキー、リポジトリURL、localPathのバリデーションとセキュリティチェックを行います。
  */
 
+import * as fs from 'fs';
+import * as path from 'path';
+import { execSync } from 'child_process';
+import type { Repository } from '../config/config-schema.js';
+
 /**
  * バリデーション結果
  */
@@ -14,6 +19,19 @@ export interface ValidationResult {
   warnings: string[];
 }
 
+/**
+ * LocalPathバリデーション結果（詳細情報付き）
+ */
+export interface LocalPathValidationResult extends ValidationResult {
+  exists: boolean;
+  isGitRepository: boolean;
+  currentBranch: string | null;
+  branchMatches: boolean;
+  hasUncommittedChanges: boolean;
+  hasMichiSetup: boolean;
+  michiSetupCommand: string | null;
+}
+
 /**
  * プロジェクト名のバリデーション
  * セキュリティ対策: パストラバーサル、相対パス、制御文字をチェック
@@ -139,3 +157,194 @@ export function validateRepositoryUrl(url: string): ValidationResult {
     warnings,
   };
 }
+
+/**
+ * Michi導入状況をチェック
+ * .kiro/project.json の存在でMichi導入済みと判定
+ *
+ * @param localPath - 子リポジトリのlocalPath
+ * @returns Michi導入済みかどうか
+ */
+export function hasMichiSetup(localPath: string): boolean {
+  const projectJsonPath = path.join(localPath, '.kiro', 'project.json');
+  return fs.existsSync(projectJsonPath);
+}
+
+/**
+ * Michi導入コマンドを生成
+ * パスに空白やシングルクォートが含まれる場合に対応
+ *
+ * @param localPath - 子リポジトリのlocalPath
+ * @returns セットアップコマンド文字列
+ */
+export function getMichiSetupCommand(localPath: string): string {
+  // シングルクォートをエスケープ: ' → '\''
+  // eslint-disable-next-line quotes
+  const escapedPath = localPath.replace(/'/g, "'\\''");
+  return `cd '${escapedPath}' && npx @sk8metal/michi-cli@latest init`;
+}
+
+/**
+ * LocalPathのバリデーション
+ * ディレクトリ存在、Gitリポジトリ、ブランチ、未コミット変更をチェック
+ *
+ * @param repository - リポジトリ設定
+ * @returns バリデーション結果（詳細情報付き）
+ */
+export function validateLocalPath(
+  repository: Repository,
+): LocalPathValidationResult {
+  const errors: string[] = [];
+  const warnings: string[] = [];
+
+  // 初期値
+  let exists = false;
+  let isGitRepository = false;
+  let currentBranch: string | null = null;
+  let branchMatches = false;
+  let hasUncommittedChanges = false;
+  let hasMichiSetupResult = false;
+  let michiSetupCommand: string | null = null;
+
+  // 1. localPath設定確認
+  if (!repository.localPath) {
+    warnings.push(
+      `Repository '${repository.name}' does not have localPath configured`,
+    );
+    return {
+      isValid: false,
+      errors,
+      warnings,
+      exists,
+      isGitRepository,
+      currentBranch,
+      branchMatches,
+      hasUncommittedChanges,
+      hasMichiSetup: hasMichiSetupResult,
+      michiSetupCommand,
+    };
+  }
+
+  const localPath = repository.localPath;
+
+  // 2. ディレクトリ存在確認
+  try {
+    const stats = fs.statSync(localPath);
+    if (!stats.isDirectory()) {
+      errors.push(
+        `localPath '${localPath}' exists but is not a directory`,
+      );
+      return {
+        isValid: false,
+        errors,
+        warnings,
+        exists: true,
+        isGitRepository,
+        currentBranch,
+        branchMatches,
+        hasUncommittedChanges,
+        hasMichiSetup: hasMichiSetupResult,
+        michiSetupCommand,
+      };
+    }
+    exists = true;
+  } catch (_error) {
+    errors.push(`localPath '${localPath}' does not exist`);
+    return {
+      isValid: false,
+      errors,
+      warnings,
+      exists,
+      isGitRepository,
+      currentBranch,
+      branchMatches,
+      hasUncommittedChanges,
+      hasMichiSetup: hasMichiSetupResult,
+      michiSetupCommand,
+    };
+  }
+
+  // 3. Gitリポジトリ確認
+  const gitDir = path.join(localPath, '.git');
+  if (!fs.existsSync(gitDir)) {
+    errors.push(
+      `localPath '${localPath}' is not a Git repository (no .git directory)`,
+    );
+    return {
+      isValid: false,
+      errors,
+      warnings,
+      exists,
+      isGitRepository,
+      currentBranch,
+      branchMatches,
+      hasUncommittedChanges,
+      hasMichiSetup: hasMichiSetupResult,
+      michiSetupCommand,
+    };
+  }
+  isGitRepository = true;
+
+  // 4. ブランチ確認
+  try {
+    currentBranch = execSync('git branch --show-current', {
+      cwd: localPath,
+      encoding: 'utf-8',
+    }).trim();
+
+    if (currentBranch !== repository.branch) {
+      warnings.push(
+        `Current branch '${currentBranch}' does not match configured branch '${repository.branch}'`,
+      );
+      branchMatches = false;
+    } else {
+      branchMatches = true;
+    }
+  } catch (error) {
+    warnings.push(
+      `Failed to get current branch: ${error instanceof Error ? error.message : String(error)}`,
+    );
+  }
+
+  // 5. 未コミット変更確認
+  try {
+    const statusOutput = execSync('git status --porcelain', {
+      cwd: localPath,
+      encoding: 'utf-8',
+    }).trim();
+
+    if (statusOutput.length > 0) {
+      warnings.push(
+        `Repository '${repository.name}' has uncommitted changes`,
+      );
+      hasUncommittedChanges = true;
+    }
+  } catch (error) {
+    warnings.push(
+      `Failed to check uncommitted changes: ${error instanceof Error ? error.message : String(error)}`,
+    );
+  }
+
+  // 6. Michi導入状況確認
+  hasMichiSetupResult = hasMichiSetup(localPath);
+
+  if (!hasMichiSetupResult) {
+    michiSetupCommand = getMichiSetupCommand(localPath);
+    warnings.push(
+      `Repository '${repository.name}' does not have Michi setup (.kiro/project.json not found)`,
+    );
+  }
+
+  return {
+    isValid: errors.length === 0,
+    errors,
+    warnings,
+    exists,
+    isGitRepository,
+    currentBranch,
+    branchMatches,
+    hasUncommittedChanges,
+    hasMichiSetup: hasMichiSetupResult,
+    michiSetupCommand,
+  };
+}