@sk8metal/michi-cli 0.0.7 → 0.0.9

package/docs/guides/customization.md

@@ -363,7 +363,7 @@ Confluenceスペース
 
 ```bash
 # 対話式設定ツールを実行
-npx @michi/cli config:interactive
+npx @sk8metal/michi-cli config:interactive
 
 # または
 npm run config:interactive
@@ -371,7 +371,7 @@ npm run config:interactive
 
 ### 使い方
 
-1. **コマンド実行**: `npx @michi/cli config:interactive`
+1. **コマンド実行**: `npx @sk8metal/michi-cli config:interactive`
 2. **設定項目を選択**: 
    - Confluence設定のカスタマイズ
    - JIRA設定のカスタマイズ
@@ -394,7 +394,7 @@ npm run config:interactive
 
 ```bash
 # 設定ファイルのバリデーション
-npx @michi/cli config:validate
+npx @sk8metal/michi-cli config:validate
 
 # または
 npm run config:validate
@@ -474,7 +474,7 @@ npm run config:validate
 ### Michi関連
 - [セットアップガイド](../getting-started/setup.md)
 - [ワークフローガイド](./workflow.md)
-- [新規プロジェクトセットアップ](../getting-started/new-project-setup.md)
+- [新規リポジトリセットアップ](../getting-started/new-repository-setup.md)
 - [設定値リファレンス](../reference/config.md)
 
 ### cc-sdd関連

package/docs/guides/multi-project.md

@@ -10,7 +10,7 @@ Michiは、複数プロジェクト（3-5案件）を同時並行で管理でき
 
 ### プロジェクト構成
 
-**構成**: 1つのリポジトリ内で複数プロジェクトを管理します。各プロジェクトは独立したディレクトリに配置され、それぞれに`.kiro/project.json`を持ちます。
+**構成**: 1つのリポジトリ内で複数プロジェクトを管理します。**すべてのプロジェクト（単一プロジェクトも含む）は`projects/`ディレクトリ配下に配置され、それぞれに`.kiro/project.json`を持ちます。**
 
 ```
 repository/  ← 1つのGitHubリポジトリ
@@ -23,14 +23,17 @@ repository/  ← 1つのGitHubリポジトリ
 │   │   └── .kiro/
 │   └── 20240310-analytics-api/  ← プロジェクトC
 │       └── .kiro/
-└── michi/  ← 統合ハブ（オプション）
-    └── .kiro/
+├── package.json  ← リポジトリルート（共有）
+├── tsconfig.json  ← リポジトリルート（共有）
+└── .gitignore  ← リポジトリルート（共有）
 ```
 
-**プロジェクト識別方法**:
+**重要な原則**:
+- **統一されたディレクトリ構成**: 単一プロジェクトも`projects/{project-id}/`配下に配置
 - 各プロジェクトディレクトリに`.kiro/project.json`を配置
 - 作業ディレクトリ（`process.cwd()`）から`.kiro/project.json`を読み込んでプロジェクトを識別
 - プロジェクト切り替えは、該当ディレクトリに移動するだけ
+- `package.json`や`tsconfig.json`はリポジトリルートに配置（複数プロジェクトで共有）
 
 ### 統合管理
 
@@ -47,7 +50,7 @@ repository/  ← 1つのGitHubリポジトリ
 
 ### 新規プロジェクト追加
 
-詳細な手順は [新規プロジェクトセットアップガイド](../getting-started/new-project-setup.md) を参照してください。
+詳細な手順は [新規リポジトリセットアップガイド](../getting-started/new-repository-setup.md) を参照してください。
 
 **クイックスタート**:
 1. 既存リポジトリに追加: `bash /path/to/michi/scripts/setup-existing.sh`
@@ -62,7 +65,7 @@ repository/  ← 1つのGitHubリポジトリ
 
 ### 環境変数設定
 
-各プロジェクトで`.env`ファイルを設定します。詳細は [新規プロジェクトセットアップガイド](../getting-started/new-project-setup.md#step-5-環境変数設定) を参照してください。
+各プロジェクトで`.env`ファイルを設定します。詳細は [新規リポジトリセットアップガイド](../getting-started/new-repository-setup.md#step-5-環境変数設定) を参照してください。
 
 ### 動作確認
 
@@ -75,7 +78,7 @@ cat .kiro/project.json
 # テスト機能で確認（オプション）
 /kiro:spec-init テスト機能
 /kiro:spec-requirements test-feature
-npx @michi/cli phase:run test-feature requirements
+npx @sk8metal/michi-cli phase:run test-feature requirements
 ```
 
 ## プロジェクト切り替え
@@ -210,7 +213,7 @@ ls -la .kiro/specs/
 
 **解決方法**:
 1. プロジェクトディレクトリが正しいか確認
-2. `.kiro/project.json`を作成（[新規プロジェクトセットアップガイド](../getting-started/new-project-setup.md)を参照）
+2. `.kiro/project.json`を作成（[新規リポジトリセットアップガイド](../getting-started/new-repository-setup.md)を参照）
 
 ## プロジェクト横断操作
 
@@ -322,7 +325,7 @@ shared-infrastructure/
 **Confluenceラベル**: `project:{projectId}, service:{service}`
 - 例: `project:20240115-payment-api, service:payment`
 
-**ラベル生成ロジック**: 詳細は [新規プロジェクトセットアップガイド](../getting-started/new-project-setup.md#ラベル生成ロジック) を参照してください。
+**ラベル生成ロジック**: 詳細は [新規リポジトリセットアップガイド](../getting-started/new-repository-setup.md#ラベル生成ロジック) を参照してください。
 ### チーム構成の明確化
 
 各プロジェクトの `team` フィールドに担当者を記載：

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,17 +72,18 @@ 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. 初期コミット
 ```
 
-詳細: [新規プロジェクトセットアップガイド](./new-project-setup.md)
+詳細: [新規リポジトリセットアップガイド](../getting-started/new-repository-setup.md)
 
 ## 開発フロー
 
@@ -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
 ```
 
 ### 見積もり集計
@@ -287,7 +296,7 @@ npm install
 ## 参考リンク
 
 - [セットアップガイド](./setup.md)
-- [新規プロジェクトセットアップ](./new-project-setup.md)
+- [新規リポジトリセットアップ](../getting-started/new-repository-setup.md)
 - [ワークフローガイド](./workflow.md)
 - [マルチプロジェクト管理](./multi-project.md)
 - [テスト・検証](./testing.md)

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/docs/testing-strategy.md

@@ -0,0 +1,87 @@
+# テスト戦略とカバレッジ計画
+
+## テストカバレッジ目標
+
+最終目標: **95%以上**（AGENTS.mdに定義）
+
+## 段階的引き上げ計画
+
+### Phase 1: 基盤整備（現在）
+- **目標カバレッジ**: 30%
+- **期間**: 2025年1月
+- **対象**:
+  - CLI コマンド登録テスト
+  - config-loader の基本機能テスト
+  - spec-updater の統合テスト
+  - validate-phase の主要パステスト
+
+### Phase 2: コア機能の拡充
+- **目標カバレッジ**: 60%
+- **期間**: 2025年2月
+- **対象**:
+  - Confluence 同期ロジックのモックテスト
+  - JIRA 同期ロジックのモックテスト
+  - project-meta, feature-name-validator の完全カバー
+  - エラーハンドリングパスの追加
+
+### Phase 3: 統合テストの強化
+- **目標カバレッジ**: 80%
+- **期間**: 2025年3月
+- **対象**:
+  - confluence-hierarchy の全パターンテスト
+  - PR自動化のE2Eテスト
+  - マルチプロジェクト機能の統合テスト
+  - エッジケース・エラーケースの網羅
+
+### Phase 4: 最終完成
+- **目標カバレッジ**: 95%
+- **期間**: 2025年4月
+- **対象**:
+  - すべての未カバー分岐の追加
+  - リグレッションテストの整備
+  - パフォーマンステストの追加
+  - セキュリティテストの追加
+
+## 現在の除外項目
+
+以下のファイルはカバレッジ計測から除外されています（`vitest.config.ts`）:
+
+- `node_modules/`
+- `dist/`
+- `**/*.test.ts`, `**/*.spec.ts`
+- `**/__tests__/**`
+- `**/*.d.ts`
+- `**/*.config.ts`
+- `**/scripts/setup-*.ts`
+- `**/scripts/setup-*.sh`
+
+## CI/CDでの扱い
+
+### 現在のアプローチ
+- ローカル開発: カバレッジ閾値30%で実行
+- CI: 同じ閾値を適用し、段階的に引き上げ
+
+### 推奨事項
+- 新規コードには必ずテストを追加
+- PRマージ時にカバレッジ低下を許可しない
+- 月次でカバレッジ改善タスクを計画
+
+## テスト実行コマンド
+
+```bash
+# すべてのテストを実行
+npm run test
+
+# テストを1回だけ実行（CI用）
+npm run test:run
+
+# カバレッジレポート付きで実行
+npm run test:coverage
+
+# UI付きでテストを実行（開発用）
+npm run test:ui
+```
+
+## 参照
+- [vitest.config.ts](../vitest.config.ts) - カバレッジ閾値設定
+- [AGENTS.md](../AGENTS.md) - 最終目標（95%）の定義

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sk8metal/michi-cli",
-  "version": "0.0.7",
+  "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",
@@ -42,10 +43,13 @@
     "mcp.json.example"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node scripts/copy-static-assets.js",
     "postbuild": "node scripts/set-permissions.js",
-    "prepare": "npm run build",
-    "setup:env": "bash scripts/setup-env.sh",
+    "prepare": "husky",
+    "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",
@@ -66,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 .",
@@ -90,16 +96,27 @@
     "@types/turndown": "^5.0.4",
     "@typescript-eslint/eslint-plugin": "^8.46.4",
     "@typescript-eslint/parser": "^8.46.4",
+    "@vitest/coverage-v8": "^4.0.8",
     "eslint": "^9.39.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.6",
     "prettier": "^3.1.1",
     "tsx": "^4.7.0",
     "typescript": "^5.3.3",
     "typescript-eslint": "^8.46.4",
-    "vitest": "^4.0.8",
-    "@vitest/coverage-v8": "^4.0.8"
+    "vitest": "^4.0.8"
   },
   "engines": {
     "node": ">=20.0.0",
     "npm": ">=10.0.0"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json,md,yml,yaml}": [
+      "prettier --write"
+    ]
   }
 }