@sk8metal/michi-cli 0.0.8 → 0.0.9

package/docs/reference/quick-reference.md

@@ -4,17 +4,25 @@
 
 ## 新規プロジェクト作成
 
-### パターンA: 既存リポジトリにMichiワークフローを追加（最も簡単 ⭐）
+### パターンA: 既存リポジトリにMichi共通ルール・コマンドを追加（最も簡単 ⭐）
 
 ```bash
 # 既存プロジェクトに移動
 cd /path/to/existing-repo
 
-# 対話式セットアップスクリプト実行
+# Michiの共通ルール・コマンド・テンプレートをコピー
 bash /path/to/michi/scripts/setup-existing.sh
 ```
 
-プロジェクト名、JIRAキーを入力するだけで完了！
+このスクリプトが自動的に：
+- 共通ルール（`.cursor/rules/`）をコピー
+- カスタムコマンド（`.cursor/commands/kiro/`）をコピー
+- Steeringテンプレート（`.kiro/steering/`）をコピー
+- Specテンプレート（`.kiro/settings/templates/`）をコピー
+
+**次のステップ**:
+1. cc-sddを導入: `npx cc-sdd@latest --lang ja --cursor`
+2. 設定を対話的に作成: `npm run setup:interactive`
 
 ### パターンB: 新規リポジトリを作成してセットアップ
 
@@ -64,11 +72,12 @@ cat > .kiro/project.json << 'EOF'
 }
 EOF
 
-# 4. Michiから共通ファイルコピー（自動スクリプト推奨）
+# 4. Michiから共通ルール・コマンド・テンプレートをコピー（自動スクリプト推奨）
+bash /path/to/michi/scripts/setup-existing.sh
+
+# または直接実行
 npx tsx /path/to/michi/scripts/setup-existing-project.ts \
-  --michi-path /path/to/michi \
-  --project-name "プロジェクト名" \
-  --jira-key "PRJX"
+  --michi-path /path/to/michi
 
 # 5. npm install
 # 6. 初期コミット
@@ -87,21 +96,21 @@ npx tsx /path/to/michi/scripts/setup-existing-project.ts \
 /kiro:spec-init <機能説明>
 /kiro:spec-requirements <feature>
 jj commit -m "docs: 要件定義" && jj git push
-npx @michi/cli phase:run <feature> requirements
+npx @sk8metal/michi-cli phase:run <feature> requirements
 ```
 
 **設計**:
 ```bash
 /kiro:spec-design <feature>
 jj commit -m "docs: 設計" && jj git push
-npx @michi/cli phase:run <feature> design
+npx @sk8metal/michi-cli phase:run <feature> design
 ```
 
 **タスク分割**:
 ```bash
 /kiro:spec-tasks <feature>
 jj commit -m "docs: タスク分割" && jj git push
-npx @michi/cli phase:run <feature> tasks
+npx @sk8metal/michi-cli phase:run <feature> tasks
 ```
 
 **実装**:
@@ -110,7 +119,7 @@ npx @michi/cli phase:run <feature> tasks
 jj commit -m "feat: 実装 [<jira-key>-XXX]"
 jj bookmark create <project-id>/feature/<feature> -r '@-'
 jj git push --bookmark <project-id>/feature/<feature> --allow-new
-gh pr create --head <project-id>/feature/<feature> --base init
+gh pr create --head <project-id>/feature/<feature> --base main
 ```
 
 ## コマンド一覧
@@ -132,7 +141,7 @@ gh pr create --head <project-id>/feature/<feature> --base init
 
 ## Michi CLIコマンド一覧
 
-**使用方法**: `npx @michi/cli <command>` または `michi <command>`（グローバルインストール後）
+**使用方法**: `npx @sk8metal/michi-cli <command>` または `michi <command>`（グローバルインストール後）
 
 | コマンド | 説明 |
 |---------|------|
@@ -150,8 +159,8 @@ gh pr create --head <project-id>/feature/<feature> --base init
 | `michi --version` | バージョン表示 |
 
 **インストール方法**:
-- **npx実行（推奨）**: `npx @michi/cli <command>` - 常に最新版を使用
-- **グローバルインストール**: `npm install -g @michi/cli` 後、`michi <command>`
+- **npx実行（推奨）**: `npx @sk8metal/michi-cli <command>` - 常に最新版を使用
+- **グローバルインストール**: `npm install -g @sk8metal/michi-cli` 後、`michi <command>`
 - **ローカル開発**: `npm run michi <command>` または `npx tsx src/cli.ts <command>`
 
 ## npmスクリプト一覧（michiリポジトリ内）
@@ -185,14 +194,14 @@ cat .kiro/project.json
 ```bash
 cd /path/to/michi
 # 全プロジェクトの一覧を表示
-npx @michi/cli project:list
+npx @sk8metal/michi-cli project:list
 ```
 
 ### リソースダッシュボード
 
 ```bash
 # Confluenceにプロジェクト横断ダッシュボードを作成
-npx @michi/cli project:dashboard
+npx @sk8metal/michi-cli project:dashboard
 ```
 
 ### 見積もり集計

package/docs/testing/integration-tests.md

@@ -0,0 +1,297 @@
+# 統合テストガイド
+
+## 概要
+
+Michiプロジェクトの統合テストは、`setup-existing`コマンドの動作を検証するために作成されています。
+
+## テスト構造
+
+```
+src/__tests__/integration/setup/
+├── helpers/
+│   ├── test-project.ts      # テストプロジェクト作成ヘルパー
+│   └── fs-assertions.ts     # ファイルシステムアサーション
+├── cursor.test.ts           # Cursor環境テスト
+├── claude.test.ts           # Claude環境テスト
+├── claude-agent.test.ts     # Claude Agent環境テスト
+└── validation.test.ts       # 引数バリデーションテスト
+```
+
+## テストケース
+
+### 1. 環境別テスト
+
+#### Cursor環境 (`cursor.test.ts`)
+
+- ✅ `.cursor/rules/` ディレクトリ作成
+- ✅ `.cursor/commands/` ディレクトリ作成
+- ✅ `.kiro/` ディレクトリ構造作成
+- ✅ `project.json` 作成とメタデータ検証
+- ✅ `.env` テンプレート作成
+- ✅ テンプレートレンダリング
+- ✅ 言語サポート（ja, en）
+- ✅ Git統合（リモートURL検出）
+- ✅ エラーハンドリング
+
+#### Claude環境 (`claude.test.ts`)
+
+- ✅ `.claude/rules/` ディレクトリ作成
+- ✅ `.kiro/` ディレクトリ構造作成
+- ✅ `project.json` 作成
+- ✅ `.env` テンプレート作成
+- ✅ Cursor固有ディレクトリが作成されないことを確認
+- ✅ 言語サポート
+
+#### Claude Agent環境 (`claude-agent.test.ts`)
+
+- ✅ `.claude/subagents/` ディレクトリ作成
+- ✅ `.kiro/` ディレクトリ構造作成
+- ✅ `project.json` 作成
+- ✅ `.env` テンプレート作成
+- ✅ 他の環境固有ディレクトリが作成されないことを確認
+- ✅ 言語サポート（ja, en, zh-TW）
+
+### 2. バリデーションテスト (`validation.test.ts`)
+
+#### 環境選択
+
+- ✅ デフォルト環境（cursor）
+- ✅ `--cursor` フラグ
+- ✅ `--claude` フラグ
+- ✅ `--claude-agent` フラグ
+
+#### 言語バリデーション
+
+- ✅ サポート言語: `ja`, `en`, `zh-TW`
+- ✅ 非サポート言語でエラー
+
+#### プロジェクト名バリデーション
+
+**正常系:**
+- ✅ 有効なプロジェクト名
+- ✅ 日本語文字を含むプロジェクト名
+- ✅ 前後の空白はトリム
+
+**異常系:**
+- ❌ 空文字列
+- ❌ パストラバーサル文字 (`/`, `\`, `..`)
+- ❌ 制御文字
+- ❌ 100文字超
+
+#### JIRAキーバリデーション
+
+**正常系:**
+- ✅ 2-10文字の大文字英字
+- ✅ 小文字は自動的に大文字に変換
+
+**異常系:**
+- ❌ 1文字以下
+- ❌ 11文字以上
+- ❌ 数字を含む
+- ❌ 特殊文字を含む
+
+#### Gitリポジトリバリデーション
+
+- ❌ `.git` ディレクトリがない場合エラー
+
+## テスト実行方法
+
+### すべてのテスト実行
+
+```bash
+npm test
+```
+
+### 統合テストのみ実行
+
+```bash
+npm run test:integration:setup
+```
+
+### カバレッジ付き実行
+
+```bash
+npm run test:coverage:setup
+```
+
+### 監視モード
+
+```bash
+npm test -- --watch
+```
+
+### UI モード
+
+```bash
+npm run test:ui
+```
+
+## CI/CD
+
+GitHub Actionsワークフローが `.github/workflows/test-setup.yml` に定義されています。
+
+**実行タイミング:**
+- `main`, `develop`, `feature/**` ブランチへのプッシュ
+- `main`, `develop` ブランチへのプルリクエスト
+
+**マトリクス戦略:**
+- Node.js 18.x
+- Node.js 20.x
+
+**ステップ:**
+1. コードチェックアウト
+2. Node.js セットアップ
+3. 依存関係インストール
+4. 統合テスト実行
+5. カバレッジ生成
+6. カバレッジアップロード（Codecov）
+7. Lint実行
+8. TypeScript型チェック
+
+## トラブルシューティング
+
+### テストが失敗する場合
+
+**症状:** テストプロジェクトの作成に失敗
+
+**原因:** 一時ディレクトリの権限問題
+
+**解決策:**
+```bash
+# 一時ディレクトリの権限を確認
+ls -la /tmp
+
+# 手動でクリーンアップ
+rm -rf /tmp/test-project-*
+```
+
+---
+
+**症状:** Git初期化エラー
+
+**原因:** Gitがインストールされていない
+
+**解決策:**
+```bash
+# Gitインストール確認
+git --version
+
+# macOS
+brew install git
+
+# Ubuntu
+sudo apt-get install git
+```
+
+---
+
+**症状:** TypeScriptコンパイルエラー
+
+**原因:** 型定義の不一致
+
+**解決策:**
+```bash
+# 型チェック
+npm run type-check
+
+# node_modulesを再インストール
+rm -rf node_modules package-lock.json
+npm install
+```
+
+### カバレッジが低い場合
+
+**目標:** 95%以上のカバレッジ
+
+**確認方法:**
+```bash
+npm run test:coverage:setup
+open coverage/lcov-report/index.html
+```
+
+**改善策:**
+1. 未テストのエッジケースを追加
+2. エラーハンドリングのテストを追加
+3. モックが不十分な箇所を特定
+
+### CI/CDが失敗する場合
+
+**症状:** GitHub Actionsでテストが失敗
+
+**原因1:** ローカルとCI環境の違い
+
+**解決策:**
+```bash
+# ローカルでCI環境を再現
+docker run -it -v $(pwd):/app node:20 bash
+cd /app
+npm ci
+npm run test:integration:setup
+```
+
+**原因2:** タイムアウト
+
+**解決策:** `.github/workflows/test-setup.yml` でタイムアウトを延長
+```yaml
+- name: Run integration tests
+  run: npm run test:integration:setup
+  timeout-minutes: 10  # デフォルト: 360分
+```
+
+## ベストプラクティス
+
+### テスト作成時
+
+1. **TDD原則を守る**
+   - テストを先に書く
+   - 最小限の実装で通す
+   - リファクタリング
+
+2. **テストは独立させる**
+   - 各テストは他のテストに依存しない
+   - `beforeEach`, `afterEach` でクリーンアップ
+
+3. **意味のあるテスト名**
+   ```typescript
+   // ❌ Bad
+   it('test 1', () => {});
+   
+   // ✅ Good
+   it('should create .cursor/rules directory', () => {});
+   ```
+
+4. **アサーションは明確に**
+   ```typescript
+   // ❌ Bad
+   expect(result).toBe(true);
+   
+   // ✅ Good
+   assertDirectoryExists(
+     join(testProject.path, '.cursor/rules'),
+     'Expected .cursor/rules directory to exist'
+   );
+   ```
+
+### テスト保守時
+
+1. **テストが壊れたら**
+   - 実装の変更が正しいか確認
+   - テストの期待値を更新
+   - リグレッションを防ぐ
+
+2. **新機能追加時**
+   - 必ずテストを追加
+   - カバレッジを確認
+   - エッジケースを考慮
+
+3. **リファクタリング時**
+   - テストが通ることを確認
+   - テストコードもリファクタリング
+   - 重複を削除
+
+## 参考資料
+
+- [Vitest公式ドキュメント](https://vitest.dev/)
+- [テスト戦略](../testing-strategy.md)
+- [開発ガイド](../contributing/development.md)
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sk8metal/michi-cli",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "Managed Intelligent Comprehensive Hub for Integration - AI-driven development workflow automation",
   "license": "MIT",
   "type": "module",
@@ -34,6 +34,7 @@
   "files": [
     "dist",
     "scripts",
+    "templates",
     "docs",
     "README.md",
     "CHANGELOG.md",
@@ -45,8 +46,10 @@
     "build": "tsc && node scripts/copy-static-assets.js",
     "postbuild": "node scripts/set-permissions.js",
     "prepare": "husky",
-    "setup:env": "bash scripts/setup-env.sh",
     "setup:interactive": "tsx scripts/setup-interactive.ts",
+    "michi:setup:cursor": "tsx src/cli.ts setup-existing --cursor",
+    "michi:setup:claude": "tsx src/cli.ts setup-existing --claude",
+    "michi:setup:claude-agent": "tsx src/cli.ts setup-existing --claude-agent",
     "create-project": "tsx scripts/create-project.ts",
     "setup-existing": "tsx scripts/setup-existing-project.ts",
     "confluence:sync": "tsx scripts/confluence-sync.ts",
@@ -67,6 +70,8 @@
     "test:run": "vitest --run",
     "test:ui": "vitest --ui",
     "test:coverage": "vitest --run --coverage",
+    "test:integration:setup": "vitest --run src/__tests__/integration/setup",
+    "test:coverage:setup": "vitest --run --coverage src/__tests__/integration/setup",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "format": "prettier --write .",

package/scripts/__tests__/setup-existing-project.test.ts

@@ -8,14 +8,36 @@ vi.mock('fs', () => ({
   mkdirSync: vi.fn(),
   cpSync: vi.fn(),
   writeFileSync: vi.fn(),
-  readFileSync: vi.fn(() => '{}')
+  readFileSync: vi.fn(() => '{}'),
+  readdirSync: vi.fn(() => []),
+  statSync: vi.fn()
 }));
 vi.mock('child_process', () => ({
   execSync: vi.fn()
 }));
-vi.mock('./utils/project-finder.js', () => ({
+vi.mock('../utils/project-finder.js', () => ({
   findRepositoryRoot: vi.fn(() => '/test/repo')
 }));
+vi.mock('../constants/environments.js', () => ({
+  getEnvironmentConfig: vi.fn(() => ({
+    rulesDir: '.cursor/rules',
+    commandsDir: '.cursor/commands/kiro',
+    templateSource: 'cursor'
+  })),
+  isSupportedEnvironment: vi.fn(() => true)
+}));
+vi.mock('../constants/languages.js', () => ({
+  isSupportedLanguage: vi.fn(() => true)
+}));
+vi.mock('../template/renderer.js', () => ({
+  createTemplateContext: vi.fn(() => ({
+    LANG_CODE: 'ja',
+    DEV_GUIDELINES: '- Think in English, but generate responses in Japanese',
+    KIRO_DIR: '.kiro',
+    AGENT_DIR: '.cursor'
+  })),
+  renderTemplate: vi.fn((content: string) => content)
+}));
 
 describe('setup-existing-project.ts 修正内容のテスト', () => {
   beforeEach(() => {
@@ -58,12 +80,14 @@ describe('setup-existing-project.ts 修正内容のテスト', () => {
   it('完了メッセージに scripts/ ディレクトリが含まれていない', () => {
     const projectDir = '/test/repo/projects/test-project';
     const repoRoot = '/test/repo';
+    const envConfigRulesDir = '.cursor/rules';
+    const envConfigCommandsDir = '.cursor/commands/kiro';
     
-    // 実際に作成されるファイルのリスト
+    // 実際に作成されるファイルのリスト（環境別）
     const createdFiles = [
       `${projectDir}/.kiro/project.json`,
-      `${projectDir}/.cursor/rules/ (3ファイル)`,
-      `${projectDir}/.cursor/commands/kiro/ (2ファイル)`,
+      `${projectDir}/${envConfigRulesDir}/`,
+      `${projectDir}/${envConfigCommandsDir}/`,
       `${projectDir}/.kiro/steering/ (3ファイル)`,
       `${projectDir}/.kiro/settings/templates/ (3ファイル)`,
       `${repoRoot}/package.json (新規の場合)`,
@@ -75,5 +99,49 @@ describe('setup-existing-project.ts 修正内容のテスト', () => {
     const hasScriptsDir = createdFiles.some(file => file.includes('scripts/'));
     expect(hasScriptsDir).toBe(false);
   });
+
+  it('project.jsonにlanguageフィールドが含まれる', () => {
+    const projectJson = {
+      projectId: 'test-project',
+      projectName: 'Test Project',
+      language: 'ja',
+      jiraProjectKey: 'TEST',
+      confluenceLabels: ['project:test-project'],
+      status: 'active',
+      team: [],
+      stakeholders: ['@企画', '@部長'],
+      repository: 'https://github.com/org/test',
+      description: 'Test Projectの開発'
+    };
+
+    expect(projectJson).toHaveProperty('language');
+    expect(projectJson.language).toBe('ja');
+  });
+
+  it('環境別のディレクトリマッピングが正しい', () => {
+    const envConfig = {
+      rulesDir: '.cursor/rules',
+      commandsDir: '.cursor/commands/kiro',
+      templateSource: 'cursor'
+    };
+
+    expect(envConfig.rulesDir).toBe('.cursor/rules');
+    expect(envConfig.commandsDir).toBe('.cursor/commands/kiro');
+    expect(envConfig.templateSource).toBe('cursor');
+  });
+
+  it('テンプレートコンテキストが正しく作成される', () => {
+    const context = {
+      LANG_CODE: 'ja',
+      DEV_GUIDELINES: '- Think in English, but generate responses in Japanese',
+      KIRO_DIR: '.kiro',
+      AGENT_DIR: '.cursor'
+    };
+
+    expect(context).toHaveProperty('LANG_CODE');
+    expect(context).toHaveProperty('DEV_GUIDELINES');
+    expect(context).toHaveProperty('KIRO_DIR');
+    expect(context).toHaveProperty('AGENT_DIR');
+  });
 });
 

package/scripts/constants/__tests__/environments.test.ts

@@ -0,0 +1,110 @@
+import { describe, it, expect } from 'vitest';
+import {
+  ENV_CONFIG,
+  getEnvironmentConfig,
+  isSupportedEnvironment,
+  getSupportedEnvironments,
+  type Environment,
+  type EnvironmentConfig
+} from '../environments.js';
+
+describe('environments', () => {
+  describe('ENV_CONFIG', () => {
+    it('should have entries for all environments', () => {
+      expect(ENV_CONFIG.claude).toBeDefined();
+      expect(ENV_CONFIG['claude-agent']).toBeDefined();
+      expect(ENV_CONFIG.cursor).toBeDefined();
+    });
+
+    it('should have correct structure for claude', () => {
+      const config = ENV_CONFIG.claude;
+      expect(config.rulesDir).toBe('.claude/rules');
+      expect(config.commandsDir).toBe('.claude/commands/kiro');
+      expect(config.templateSource).toBe('claude');
+    });
+
+    it('should have correct structure for claude-agent', () => {
+      const config = ENV_CONFIG['claude-agent'];
+      expect(config.rulesDir).toBe('.claude/rules');
+      expect(config.commandsDir).toBe('.claude/commands/kiro');
+      expect(config.templateSource).toBe('claude-agent');
+    });
+
+    it('should have correct structure for cursor', () => {
+      const config = ENV_CONFIG.cursor;
+      expect(config.rulesDir).toBe('.cursor/rules');
+      expect(config.commandsDir).toBe('.cursor/commands/kiro');
+      expect(config.templateSource).toBe('cursor');
+    });
+
+    it('should have all required properties for each environment', () => {
+      for (const env of Object.keys(ENV_CONFIG) as Environment[]) {
+        const config = ENV_CONFIG[env];
+        expect(config).toHaveProperty('rulesDir');
+        expect(config).toHaveProperty('commandsDir');
+        expect(config).toHaveProperty('templateSource');
+        expect(typeof config.rulesDir).toBe('string');
+        expect(typeof config.commandsDir).toBe('string');
+        expect(typeof config.templateSource).toBe('string');
+      }
+    });
+  });
+
+  describe('getEnvironmentConfig', () => {
+    it('should return config for valid environment', () => {
+      const config = getEnvironmentConfig('claude');
+      expect(config).toBe(ENV_CONFIG.claude);
+    });
+
+    it('should return config for all supported environments', () => {
+      const environments: Environment[] = ['claude', 'claude-agent', 'cursor'];
+      for (const env of environments) {
+        const config = getEnvironmentConfig(env);
+        expect(config).toBeDefined();
+        expect(config).toBe(ENV_CONFIG[env]);
+      }
+    });
+  });
+
+  describe('isSupportedEnvironment', () => {
+    it('should return true for supported environments', () => {
+      expect(isSupportedEnvironment('claude')).toBe(true);
+      expect(isSupportedEnvironment('claude-agent')).toBe(true);
+      expect(isSupportedEnvironment('cursor')).toBe(true);
+    });
+
+    it('should return false for unsupported environments', () => {
+      expect(isSupportedEnvironment('invalid')).toBe(false);
+      expect(isSupportedEnvironment('vscode')).toBe(false);
+      expect(isSupportedEnvironment('')).toBe(false);
+    });
+
+    it('should work as type guard', () => {
+      const env: string = 'cursor';
+      if (isSupportedEnvironment(env)) {
+        // TypeScript should recognize env as Environment here
+        const config: EnvironmentConfig = ENV_CONFIG[env];
+        expect(config).toBeDefined();
+      }
+    });
+  });
+
+  describe('getSupportedEnvironments', () => {
+    it('should return all supported environments', () => {
+      const environments = getSupportedEnvironments();
+      expect(environments).toHaveLength(3);
+      expect(environments).toContain('claude');
+      expect(environments).toContain('claude-agent');
+      expect(environments).toContain('cursor');
+    });
+
+    it('should return array with correct type', () => {
+      const environments = getSupportedEnvironments();
+      expect(Array.isArray(environments)).toBe(true);
+      environments.forEach(env => {
+        expect(isSupportedEnvironment(env)).toBe(true);
+      });
+    });
+  });
+});
+