@sk8metal/michi-cli 0.14.1 → 0.20.0

package/docs/guides/interactive-config.md

@@ -0,0 +1,285 @@
+# 対話的設定ガイド
+
+このガイドでは、Michiの対話的設定機能を使って、各種設定ファイルを作成する方法を説明します。
+
+## 目次
+
+1. [コマンド一覧](#コマンド一覧)
+2. [設定ファイルの種類](#設定ファイルの種類)
+3. [使い方](#使い方)
+4. [3層設定アーキテクチャ](#3層設定アーキテクチャ)
+5. [セキュリティ](#セキュリティ)
+
+---
+
+## コマンド一覧
+
+| コマンド | 作成ファイル | 説明 |
+|---------|-------------|------|
+| `michi init` | `.kiro/`, `.env`(テンプレート), `.michi/config.json` | プロジェクト全体の初期化 |
+| `michi config:init` | すべての設定ファイル（`--all`オプション時） | 対話的に設定ファイルを作成 |
+| `michi config:init --global` | `~/.michi/config.json` | グローバル設定を対話的に作成 |
+| `michi config:init --global-env` | `~/.michi/.env` | グローバル.envを対話的に作成 |
+| `michi config:init --project` | `.michi/config.json` | プロジェクト設定を対話的に作成 |
+| `michi config:init --env` | `.env` | プロジェクト.envを対話的に作成 |
+| `michi config:init --all` | 上記すべて | 全設定ファイルを作成 |
+
+### michi init と michi config:init の違い
+
+- **`michi init`**: プロジェクトの初期化（.kiroディレクトリ構造、プロジェクトメタデータ作成）
+  - `.env`はテンプレートのみ（値の入力なし）
+  - `.michi/config.json`はグローバル設定をコピー、またはデフォルト値を使用
+
+- **`michi config:init`**: 設定ファイルの対話的作成（値を入力）
+  - `.env`の各項目を対話的に入力（APIトークンはパスワード非表示）
+  - `.michi/config.json`も対話的に作成可能
+
+---
+
+## 設定ファイルの種類
+
+### 1. グローバル設定 (`~/.michi/config.json`)
+
+すべてのプロジェクトに適用される共通設定です。
+
+**含まれる内容:**
+- Confluence設定（ページ作成粒度）
+- JIRA設定（Epic作成、ストーリー作成粒度、ストーリーポイント）
+- ワークフロー設定（有効なフェーズ）
+
+**作成方法:**
+```bash
+michi config:init --global
+```
+
+### 2. グローバル環境変数 (`~/.michi/.env`)
+
+すべてのプロジェクトで使用する環境変数です（機密情報）。
+
+**含まれる内容:**
+- Atlassian連携（URL、Email、APIトークン）
+- GitHub連携（Organization、Personalトークン）
+- Confluence Space設定
+- JIRAプロジェクトキー
+
+**作成方法:**
+```bash
+michi config:init --global-env
+```
+
+### 3. プロジェクト設定 (`.michi/config.json`)
+
+プロジェクト固有の設定です。グローバル設定を上書きできます。
+
+**作成方法:**
+```bash
+michi config:init --project
+```
+
+### 4. プロジェクト環境変数 (`.env`)
+
+プロジェクト固有の環境変数です。グローバル環境変数を上書きできます。
+
+**作成方法:**
+```bash
+michi config:init --env
+```
+
+---
+
+## 使い方
+
+### 基本的な使い方
+
+#### 1. プロジェクト初期化時
+
+プロジェクト新規作成時は、まず `michi init` でプロジェクト構造を作成します。
+
+```bash
+cd your-project
+michi init
+```
+
+`.env` と `.michi/config.json` はテンプレートまたはデフォルト値で作成されます。
+
+#### 2. 機密情報を含む .env の作成
+
+APIトークンなどの機密情報を対話的に入力して、`.env` を作成します。
+
+```bash
+michi config:init --env
+```
+
+**入力例:**
+```
+========================================
+ .env Interactive Setup
+========================================
+
+設定ファイル: /path/to/your-project/.env
+
+=== Atlassian連携設定 ===
+
+Atlassian URL (空白でスキップ): https://your-domain.atlassian.net
+Atlassian Email: your-email@company.com
+Atlassian API Token: ********** (入力は非表示)
+
+=== Confluence Space設定 ===
+
+PRD Space Key (空白でスキップ): PRD
+QA Space Key (空白でスキップ): QA
+Release Space Key (空白でスキップ): RELEASE
+
+=== JIRA設定 ===
+
+JIRA Project Keys (カンマ区切り、空白でスキップ): PROJ1,PROJ2
+
+=== GitHub連携設定 ===
+
+GitHub Organization (空白でスキップ): your-org
+GitHub Personal Access Token: ********** (入力は非表示)
+
+✅ .envファイルを作成しました:
+   /path/to/your-project/.env
+```
+
+#### 3. グローバル設定の作成
+
+複数のプロジェクトで共通の設定を使う場合、グローバル設定を作成します。
+
+```bash
+michi config:init --global
+```
+
+#### 4. すべての設定ファイルを一度に作成
+
+```bash
+michi config:init --all
+```
+
+上記コマンドは、以下の順序で実行されます:
+1. `~/.michi/.env` 作成
+2. `.env` 作成
+3. `~/.michi/config.json` 作成
+4. `.michi/config.json` 作成
+
+---
+
+## 3層設定アーキテクチャ
+
+Michiは、3層の設定アーキテクチャを採用しています。
+
+### 読み込み優先順位（低 → 高）
+
+1. **デフォルト設定**（内蔵）
+2. **グローバル設定** (`~/.michi/config.json`)
+3. **グローバル環境変数** (`~/.michi/.env`)
+4. **プロジェクト設定** (`.michi/config.json`)
+5. **プロジェクト環境変数** (`.env`)
+
+**例:**
+- グローバル設定で `ATLASSIAN_URL=https://global.atlassian.net` を設定
+- プロジェクト環境変数で `ATLASSIAN_URL=https://project.atlassian.net` を設定
+- → プロジェクト環境変数の値 (`https://project.atlassian.net`) が使用される
+
+### 設定の上書きルール
+
+- 上位の設定（番号が大きい）が下位の設定を上書きします
+- プロジェクト固有の設定が必要な場合は、プロジェクト設定/環境変数で上書き
+- 共通設定はグローバル設定/環境変数で管理
+
+---
+
+## セキュリティ
+
+### .envファイルの機密情報入力
+
+APIトークンなどの機密情報は、入力時に非表示になります（`@inquirer/prompts`使用）。
+
+```bash
+Atlassian API Token: ********** (入力は見えません)
+GitHub Personal Access Token: ********** (入力は見えません)
+```
+
+### ファイルパーミッション
+
+`.env` ファイルは、セキュリティのため、所有者のみ読み書き可能な権限（`0o600`）で作成されます。
+
+```bash
+ls -la .env
+-rw------- 1 user user 512 Jan  1 12:00 .env
+```
+
+### .gitignore
+
+`.env` ファイルは機密情報を含むため、必ず `.gitignore` に追加してください。
+
+```
+# .gitignore
+.env
+```
+
+**注意:** `.env.example` はGitで管理しても問題ありませんが、実際の値は含めないでください。
+
+---
+
+## 既存機能との関係
+
+### `michi init` との使い分け
+
+| タイミング | コマンド | 目的 |
+|-----------|---------|------|
+| プロジェクト新規作成時 | `michi init` | プロジェクト構造の初期化 |
+| .envに値を入力したい | `michi config:init --env` | 機密情報を対話的に入力 |
+| グローバル設定を作成 | `michi config:init --global` | 複数プロジェクトで共通設定 |
+
+### 過去の `npm run config:global` との関係
+
+以前は `npm run config:global` を使用していましたが、`michi config:init --global` に統合されました。
+
+**移行方法:**
+```bash
+# 旧コマンド
+npm run config:global
+
+# 新コマンド
+michi config:init --global
+```
+
+---
+
+## トラブルシューティング
+
+### Q1. `.env` ファイルが既に存在する場合は？
+
+上書き確認が表示されます。
+
+```
+⚠️  既存の.envファイルが見つかりました。上書きしますか？ (y/N):
+```
+
+- `y` を入力すると上書き
+- `N` または Enter で中止
+
+### Q2. グローバル設定とプロジェクト設定の違いは？
+
+- **グローバル設定** (`~/.michi/config.json`): すべてのプロジェクトに適用
+- **プロジェクト設定** (`.michi/config.json`): プロジェクト固有の設定（グローバル設定を上書き）
+
+### Q3. パスワード入力時、入力が見えない
+
+セキュリティのため、APIトークンやパスワードは入力時に非表示になります。
+
+入力後、Enterを押してください。
+
+---
+
+## 関連ドキュメント
+
+- [Atlassian連携ガイド](./atlassian-integration.md)
+- [アーキテクチャガイド](../architecture.md)
+- [設定ファイルリファレンス](../reference/config.md)
+
+---
+
+**更新日:** 2026-01-04

package/docs/onion-architecture-phase0-complete.md

@@ -0,0 +1,91 @@
+# オニオンアーキテクチャ Phase 0 完了レポート
+
+**日付**: 2025-12-28
+**タスク**: Task 1.6 - コード削減効果の検証
+**ステータス**: ✅ 完了
+
+---
+
+## 📊 Phase 0 成果サマリー
+
+### コード削減
+- **純削減行数**: 1,132行
+- **目標**: 約1,600行
+- **達成率**: 71%
+
+### 変更統計
+- 変更ファイル数: 67
+- 追加行数: 2,410
+- 削除行数: 3,542
+
+---
+
+## ✅ 完了タスク一覧
+
+### Task 1.1: 非推奨コマンドと完全未使用ファイルの削除
+- setup-existing.ts (794行) 削除
+- 未使用ファイル5件削除 (~400行)
+- コミット: 419347b
+
+### Task 1.2: 未使用エクスポートの削除
+- 5つの未使用関数を削除
+- コミット: 419347b
+
+### Task 1.3: ValidationResult インターフェースの統合
+- Result<T, E>型に統一
+- PR #148 マージ完了
+
+### Task 1.4: project検出系ユーティリティの統合
+- ProjectAnalyzer クラスに統合
+- PR #149 マージ完了
+
+### Task 1.5: ファイル読み込み処理の統合
+- 31ファイルをsafeReadFileOrThrowに移行
+- PR #150 マージ完了
+
+### Task 1.6: コード削減効果の検証
+- ✅ 削減行数測定: 1,132行
+- ✅ 全テスト合格: 816 passed, 5 skipped
+- ✅ Multi-Repo機能確認: 正常動作
+- ✅ Phase 0 検証完了
+
+---
+
+## 🎯 品質指標
+
+### テスト結果
+```
+Test Files: 48 passed | 1 skipped (49)
+Tests: 816 passed | 5 skipped (821)
+Duration: 4.63s
+```
+
+### ビルド結果
+- TypeScript compilation: ✅ Success
+- Static assets copy: ✅ Success
+- Permissions: ✅ Success
+
+### Multi-Repo機能
+- Multi-Repo テスト: ✅ 全合格
+- Multi-Repo コマンド: ✅ ビルド成功
+- セキュリティテスト: ✅ 全合格
+
+---
+
+## 📋 次のステップ
+
+**Phase 1: 基盤整備 + scripts/分類（Week 2-3）**
+
+準備完了。以下のタスクに進めます：
+- Task 2.1: 新ディレクトリ構造の作成
+- Task 2.2: パスエイリアスの追加
+- Task 2.3: ts-archのインストールと基本設定
+
+---
+
+## 📝 備考
+
+Phase 0の全タスクが完了し、コードベース簡素化の基盤が整いました。
+次のフェーズでオニオンアーキテクチャの層構造を構築します。
+
+詳細な検証レポートは `.kiro/specs/onion-architecture/phase0-verification.md` を参照してください。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sk8metal/michi-cli",
-  "version": "0.14.1",
+  "version": "0.20.0",
   "description": "Managed Intelligent Comprehensive Hub for Integration - AI-driven development workflow automation",
   "license": "MIT",
   "type": "module",
@@ -42,11 +42,9 @@
     "mcp.json.example"
   ],
   "scripts": {
-    "build": "tsc && node scripts/copy-static-assets.js",
-    "postbuild": "node scripts/set-permissions.js",
+    "build": "tsc && node scripts/build/copy-static-assets.js",
+    "postbuild": "node scripts/build/set-permissions.js",
     "prepare": "husky",
-    "michi:setup:claude": "tsx src/cli.ts setup-existing --claude",
-    "michi:setup:claude-agent": "tsx src/cli.ts setup-existing --claude-agent",
     "confluence:sync": "tsx scripts/confluence-sync.ts",
     "jira:sync": "tsx scripts/jira-sync.ts",
     "github:create-pr": "tsx scripts/pr-automation.ts",
@@ -61,11 +59,12 @@
     "test:package": "bash scripts/test-npm-package.sh",
     "config:global": "tsx scripts/config-global.ts",
     "config:validate": "tsx scripts/utils/config-validator.ts",
-    "test:interactive": "tsx scripts/test-interactive.ts",
+    "test:interactive": "tsx scripts/dev-tools/test-interactive.ts",
     "test": "vitest",
     "test:run": "vitest --run",
     "test:ui": "vitest --ui",
     "test:coverage": "vitest --run --coverage",
+    "test:arch": "vitest --run src/__tests__/arch/",
     "test:integration:setup": "vitest --run src/__tests__/integration/setup",
     "test:coverage:setup": "vitest --run --coverage --coverage.thresholds.lines=0 --coverage.thresholds.functions=0 --coverage.thresholds.branches=0 --coverage.thresholds.statements=0 src/__tests__/integration/setup",
     "lint": "eslint .",
@@ -97,6 +96,7 @@
     "husky": "^9.1.7",
     "lint-staged": "^16.2.6",
     "prettier": "^3.1.1",
+    "ts-arch-kit": "^2.4.0",
     "tsx": "^4.7.0",
     "typescript": "^5.3.3",
     "typescript-eslint": "^8.46.4",

package/scripts/README.md

@@ -0,0 +1,148 @@
+# scripts/ - Build and Development Tools
+
+このディレクトリはビルドツールおよび開発ツール専用です。プロダクションコードは含めないでください。
+
+## ディレクトリ構造
+
+```
+scripts/
+├── build/              # ビルド関連スクリプト
+│   ├── copy-static-assets.js    # 静的ファイルコピー
+│   └── set-permissions.js       # 実行権限設定
+├── dev-tools/          # 開発支援ツール
+│   ├── test-interactive.ts      # 対話型テスト
+│   └── mermaid-converter.ts     # Mermaid図変換ユーティリティ
+├── utils/              # 共通ユーティリティ
+│   ├── env-loader.js            # 環境変数読み込み
+│   ├── config-loader.ts         # 設定ファイル読み込み
+│   ├── safe-file-reader.ts      # 安全なファイル読み込み
+│   └── ...
+├── config/             # 設定ファイル・スキーマ
+└── constants/          # 定数定義
+```
+
+## スクリプト分類
+
+### Entry Points（エントリーポイント）
+
+プロダクションコード（`src/`）へのCLIエントリーポイント。実装本体は`src/`に配置されています。
+
+- `confluence-sync.ts` → `src/presentation/commands/confluence/`
+- `jira-sync.ts` → `src/presentation/commands/jira/`
+- `workflow-orchestrator.ts` → `src/presentation/commands/workflow/`
+- `github-actions-client.ts` → `src/infrastructure/external-apis/github/`
+
+**使用例:**
+```bash
+npm run confluence:sync <feature-name> [docType]
+npm run jira:sync <feature-name>
+npm run workflow:run -- --feature <feature-name>
+```
+
+### Development Tools（開発ツール）
+
+開発・テスト支援のためのスタンドアロンツール。
+
+- `config-global.ts` - グローバル設定ファイル作成・更新
+- `pre-flight-check.ts` - 実行前環境チェック
+- `validate-phase.ts` - フェーズ完了バリデーション
+- `test-workflow-stages.ts` - ワークフロー新規ステージテスト
+- `health-check-service.ts` - 依存サービス状態確認
+- `test-execution-generator.ts` - テスト実行ファイル生成
+- `test-script-runner.ts` - Multi-Repoテストスクリプト実行
+
+**使用例:**
+```bash
+npm run config:global
+npm run preflight
+npm run validate:phase <feature-name> <phase>
+npm run test:interactive
+```
+
+### Workflow Automation（ワークフロー自動化）
+
+開発ワークフロー自動化のためのツール。
+
+- `phase-runner.ts` - フェーズ実行オーケストレーション
+- `spec-impl-workflow.ts` - spec-impl統合ワークフロー管理
+- `pr-automation.ts` - GitHub PR自動作成
+- `multi-project-estimate.ts` - マルチプロジェクト見積もり集計
+
+**使用例:**
+```bash
+npm run phase:run -- --feature <feature-name> --phase <phase>
+npm run github:create-pr
+npm run multi-estimate
+```
+
+### Utilities（ユーティリティ）
+
+変換・フォーマット処理。
+
+- `markdown-to-confluence.ts` - Markdown → Confluence Storage Format変換
+
+**使用例:**
+```bash
+npm run markdown:convert <input.md> <output.html>
+```
+
+## 重要な原則
+
+### ❌ scripts/に配置してはいけないもの
+
+- **プロダクションコード**: ビジネスロジック、ドメインモデル、アプリケーションサービス
+  - → `src/domain/`、`src/application/`、`src/infrastructure/`、`src/presentation/` に配置
+- **再利用可能なライブラリコード**: 複数の機能で使われる共通コード
+  - → `src/` の適切な層に配置
+
+### ✅ scripts/に配置すべきもの
+
+- **ビルドツール**: コンパイル、アセットコピー、パーミッション設定など
+- **開発ツール**: テストヘルパー、対話型ツール、デバッグユーティリティ
+- **自動化スクリプト**: CI/CD、ワークフロー、デプロイメント
+- **Entry Points**: 本体が`src/`にある機能へのCLIラッパー
+
+## 実装ガイドライン
+
+### 新しいスクリプトを追加する場合
+
+1. **配置場所を決定**:
+   - ビルドツール → `scripts/build/`
+   - 開発ツール → `scripts/dev-tools/`
+   - 共通ユーティリティ → `scripts/utils/`
+
+2. **ファイルヘッダーを記載**:
+   ```typescript
+   /**
+    * スクリプト名
+    * 簡潔な説明（1-2行）
+    */
+   ```
+
+3. **Entry Pointの場合**:
+   ```typescript
+   /**
+    * 機能名 - Entry Point
+    * The actual logic has been moved to src/path/to/implementation/
+    */
+   ```
+
+4. **package.jsonにスクリプトを追加**:
+   ```json
+   "scripts": {
+     "your-script": "tsx scripts/path/to/script.ts"
+   }
+   ```
+
+### コーディング規約
+
+- **環境変数**: `loadEnv()`を使用
+- **ファイル読み込み**: `safeReadFileOrThrow()`を使用
+- **設定読み込み**: `loadConfig()`を使用
+- **エラーハンドリング**: 適切なエラーメッセージとexit code
+
+## 関連ドキュメント
+
+- [Onion Architecture設計書](../.kiro/specs/onion-architecture/design.md)
+- [プロジェクト構成](../.kiro/steering/structure.md)
+- [開発ワークフロー](../.kiro/steering/workflow.md)