@sk8metal/michi-cli 0.8.6 → 0.10.1

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,17 @@ export interface ValidationResult {
   warnings: string[];
 }
 
+/**
+ * LocalPathバリデーション結果（詳細情報付き）
+ */
+export interface LocalPathValidationResult extends ValidationResult {
+  exists: boolean;
+  isGitRepository: boolean;
+  currentBranch: string | null;
+  branchMatches: boolean;
+  hasUncommittedChanges: boolean;
+}
+
 /**
  * プロジェクト名のバリデーション
  * セキュリティ対策: パストラバーサル、相対パス、制御文字をチェック
@@ -139,3 +155,146 @@ export function validateRepositoryUrl(url: string): ValidationResult {
     warnings,
   };
 }
+
+/**
+ * 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;
+
+  // 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,
+    };
+  }
+
+  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,
+      };
+    }
+    exists = true;
+  } catch (_error) {
+    errors.push(`localPath '${localPath}' does not exist`);
+    return {
+      isValid: false,
+      errors,
+      warnings,
+      exists,
+      isGitRepository,
+      currentBranch,
+      branchMatches,
+      hasUncommittedChanges,
+    };
+  }
+
+  // 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,
+    };
+  }
+  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)}`,
+    );
+  }
+
+  return {
+    isValid: errors.length === 0,
+    errors,
+    warnings,
+    exists,
+    isGitRepository,
+    currentBranch,
+    branchMatches,
+    hasUncommittedChanges,
+  };
+}

package/templates/claude/agents/mermaid-validator/AGENT.md

@@ -0,0 +1,257 @@
+---
+name: mermaid-validator
+description: |
+  Mermaid図の構文検証と自動修正を行う実行エージェント。
+  architecture.md生成時やドキュメント編集時に PROACTIVELY 使用してください。
+allowed-tools: Bash, Read, Grep, Glob, Edit, Write, WebFetch
+---
+
+# Mermaid Validator Agent
+
+## 目的
+
+Markdownファイル内のMermaid図を検証し、構文エラーを検出して自動修正する。
+
+## 前提条件
+
+- Mermaid図を含むMarkdownファイルが存在
+- 検証対象: `docs/**/*.md`, `*.md`
+
+## 参照すべきスキル
+
+実行前に必ず `.claude/skills/mermaid-validator/SKILL.md` を確認し、そのガイドラインに従ってMermaid図を検証してください。
+
+## 実行フロー
+
+### Step 1: Mermaid図の検出
+
+```bash
+# Mermaid図を含むMarkdownファイルを検索
+echo "=== Mermaid diagrams found in: ==="
+find . -name "*.md" -exec grep -l '```mermaid' {} \; | head -20
+```
+
+### Step 2: Mermaid図の抽出と検証
+
+各ファイルから Mermaid ブロックを抽出し、構文チェックを実行:
+
+```bash
+# ファイルからMermaid図を抽出
+FILE="docs/michi/project/overview/architecture.md"
+
+# Mermaidブロックを抽出
+sed -n '/```mermaid/,/```/p' "$FILE" > /tmp/extracted-mermaid.txt
+
+# 抽出結果を確認
+cat /tmp/extracted-mermaid.txt
+```
+
+### Step 3: 構文エラーの検出
+
+以下の項目をチェック:
+
+#### 3.1 C4モデルの検証
+
+```bash
+# C4モデルの構文チェック
+grep -E 'C4(Context|Container|Component)' /tmp/extracted-mermaid.txt
+
+# タイトル行のチェック（コロンが含まれていないか）
+grep -E '^\s*title:' /tmp/extracted-mermaid.txt && echo "ERROR: 'title:' should be 'title' (no colon)"
+
+# Rel()の引数チェック（4つの引数が必須）
+grep -E 'Rel\(' /tmp/extracted-mermaid.txt | grep -v 'Rel([^,]+,[^,]+,[^,]+,[^,]+)' && echo "WARNING: Rel() requires 4 arguments"
+```
+
+#### 3.2 シーケンス図の検証
+
+```bash
+# シーケンス図の矢印記法チェック
+grep -E 'sequenceDiagram' /tmp/extracted-mermaid.txt && {
+    # 不正な矢印記法を検出（->, -->, -x ではなく ->>, -->>, ->> を使用すべき）
+    grep -E '([A-Za-z]+)->([A-Za-z]+):' /tmp/extracted-mermaid.txt && echo "WARNING: Use '->' instead of '->'"
+}
+```
+
+#### 3.3 グラフの検証
+
+```bash
+# サブグラフのインデントチェック
+grep -E 'subgraph' /tmp/extracted-mermaid.txt && {
+    # サブグラフの直後の行がインデントされていない場合
+    grep -A 1 'subgraph' /tmp/extracted-mermaid.txt | grep -v '^\s\+' && echo "WARNING: Subgraph content should be indented"
+}
+```
+
+#### 3.4 ER図の検証
+
+```bash
+# ER図のリレーションシップ記法チェック
+grep -E 'erDiagram' /tmp/extracted-mermaid.txt && {
+    # 不正なリレーションシップ記法を検出
+    grep -E '([A-Z_]+)\s*->\s*([A-Z_]+)' /tmp/extracted-mermaid.txt && echo "ERROR: Use proper ER relationship notation (e.g., ||--o{)"
+}
+```
+
+### Step 4: 自動修正
+
+検出されたエラーを自動修正:
+
+#### 修正ルール1: C4モデルのタイトル修正
+
+```bash
+# "title: System Context" → "title System Context"
+sed -i 's/^\s*title:\s*/    title /g' "$FILE"
+```
+
+#### 修正ルール2: シーケンス図の矢印記法修正
+
+```bash
+# "->" → "->>"（同期呼び出し）
+# ただし、既に "-->" の場合は修正しない
+sed -i 's/\([A-Za-z]\+\)->\([A-Za-z]\+\):/\1->>\2:/g' "$FILE"
+```
+
+#### 修正ルール3: サブグラフのインデント修正
+
+```bash
+# サブグラフ内のインデントを自動追加（簡易版）
+# 実際の実装では、構文解析が必要
+# ここではガイダンスのみ提供
+```
+
+#### 修正ルール4: ER図のリレーションシップ記法修正
+
+```bash
+# 簡易的な修正例（実際にはコンテキストに応じて調整が必要）
+# 1対多の場合
+sed -i 's/\([A-Z_]\+\)\s*->\s*\([A-Z_]\+\)/\1 ||--o{ \2/g' "$FILE"
+```
+
+### Step 5: 検証レポート出力
+
+修正内容をレポート形式で出力:
+
+```markdown
+# Mermaid検証レポート
+
+## 検証日時
+YYYY-MM-DD HH:MM:SS
+
+## 検証対象ファイル
+- `docs/michi/project/overview/architecture.md`
+- `docs/michi/project/overview/sequence.md`
+
+## 検出されたエラー
+
+### Critical（即時修正必要）
+
+#### architecture.md:15 - C4モデル: タイトル記法エラー
+- **エラー内容**: `title: System Context Diagram`
+- **修正内容**: `title System Context Diagram`
+- **ステータス**: ✅ 自動修正済み
+
+#### sequence.md:8 - シーケンス図: 矢印記法エラー
+- **エラー内容**: `User->Frontend: リクエスト`
+- **修正内容**: `User->>Frontend: リクエスト`
+- **ステータス**: ✅ 自動修正済み
+
+### Warning（推奨修正）
+
+#### architecture.md:45 - グラフ: サブグラフのインデント不足
+- **エラー内容**: サブグラフ内の要素がインデントされていない
+- **推奨修正**: 4スペースでインデント
+- **ステータス**: ⚠️ 手動修正を推奨
+
+### Info（任意対応）
+
+#### design.md:30 - Rel()の引数が3つのみ
+- **警告内容**: `Rel(user, system, "Uses")`
+- **推奨修正**: プロトコル情報を追加 `Rel(user, system, "Uses", "HTTPS")`
+- **ステータス**: 🟢 動作するが推奨形式ではない
+
+## サマリー
+
+- **検証ファイル数**: 3
+- **検出エラー数**: 5
+  - Critical: 2（自動修正済み）
+  - Warning: 2（要手動修正）
+  - Info: 1（任意対応）
+
+## 修正済みファイル
+
+以下のファイルが自動修正されました：
+- `docs/michi/project/overview/architecture.md`
+- `docs/michi/project/overview/sequence.md`
+
+## 次のステップ
+
+1. 修正内容を確認: `git diff docs/michi/project/overview/architecture.md`
+2. 残りのWarningを手動修正
+3. Mermaid Live Editorで最終確認: https://mermaid.live/
+```
+
+## 安全性ルール
+
+### 自動修正の範囲
+
+- ✅ 明らかな構文エラー（タイトル記法、矢印記法）
+- ✅ インデントの正規化
+- ❌ **構造的な変更は行わない**（ノード追加、削除、関係性変更）
+
+### 必須確認ケース
+
+1. **修正前のバックアップ**: 元のファイルを`.backup`として保存
+2. **修正内容の報告**: どのような修正を行ったかを明示
+3. **手動確認推奨**: 複雑な図は手動確認を推奨
+
+### 禁止事項
+
+- ❌ ユーザー確認なしでの構造的変更
+- ❌ 図の意味を変える修正
+- ❌ ノードやリレーションシップの追加・削除
+
+### 推奨パターン
+
+```
+AIエージェント:
+「Mermaid図の検証結果:
+
+🔴 Critical (2件)
+- architecture.md:15 - C4モデルのタイトル記法エラー → 自動修正済み
+- sequence.md:8 - シーケンス図の矢印記法エラー → 自動修正済み
+
+⚠️ Warning (1件)
+- architecture.md:45 - サブグラフのインデント不足 → 手動修正を推奨
+
+修正内容を確認しますか？
+A) git diffで差分確認
+B) Mermaid Live Editorで動作確認
+C) そのまま続行」
+```
+
+## Mermaid Live Editorでの検証
+
+修正後、Mermaid Live Editorで最終確認を推奨:
+
+```bash
+# 修正後のMermaid図を抽出
+sed -n '/```mermaid/,/```/p' architecture.md | sed '1d;$d' > /tmp/diagram.mmd
+
+echo "以下のURLで図を確認してください:"
+echo "https://mermaid.live/"
+echo ""
+echo "下記のコードをエディタに貼り付けてください:"
+cat /tmp/diagram.mmd
+```
+
+## CI/CD統合
+
+バージョン管理に組み込む場合、`ci-cd` スキル（`.claude/skills/ci-cd/SKILL.md`）を参照してください。
+
+## 参考資料
+
+- [Mermaid公式ドキュメント](https://mermaid.js.org/)
+- [Mermaid Live Editor](https://mermaid.live/)
+- [C4モデルガイド](https://c4model.com/)
+- [Mermaid CLI](https://github.com/mermaid-js/mermaid-cli)

package/templates/claude/commands/michi-multi-repo/impl-all.md

@@ -0,0 +1,264 @@
+---
+description: Multi-Repoプロジェクトの全リポジトリで実装を並行実行
+allowed-tools: Task, Bash, Read, Write, Glob, Grep
+argument-hint: <project-name> [--tasks <task-numbers>]
+---
+
+# Multi-Repo Implementation (All Repositories)
+
+<background_information>
+- **Mission**: Multi-Repoプロジェクトの全リポジトリで実装を並行実行
+- **Success Criteria**:
+  - 全リポジトリでTDD実装サイクルが完了
+  - テストカバレッジ95%以上
+  - 品質自動化（Lint/Type-check）パス
+  - PR作成可能な状態
+</background_information>
+
+<instructions>
+## Core Task
+Multi-Repoプロジェクト **$1** の全リポジトリで `/michi:spec-impl` を並行実行します。
+
+## 引数解析
+
+引数の形式:
+```
+/michi-multi-repo:impl-all <project-name> [--tasks <task-numbers>]
+```
+
+パラメータ:
+- **$1**: プロジェクト名（必須）
+- **--tasks**: 実行するタスク番号（オプション）
+  - 例: `--tasks 1,2,3` → タスク1-3のみ実行
+  - 省略時: 全タスクを実行
+
+## Execution Steps
+
+### Step 1: 前提条件確認
+
+1. `docs/michi/$1/reviews/` に最新のレビューレポートが存在するか確認
+
+2. 最新レビューの品質ゲート判定を確認
+   ```bash
+   grep "品質ゲート判定" docs/michi/$1/reviews/cross-repo-review-*.md | tail -1
+   ```
+
+3. **判定が「不合格」の場合**:
+   ```
+   ❌ エラー: 品質ゲート不合格
+
+   BLOCK問題が未解決です。実装を開始できません。
+
+   次のアクション:
+   1. BLOCK問題を修正
+   2. `/michi-multi-repo:spec-review $1` を再実行
+   3. 合格後に再度このコマンドを実行
+   ```
+
+4. **判定が「条件付き合格」の場合**:
+   ```
+   ⚠️ 警告: 品質ゲート条件付き合格
+
+   WARN問題が検出されています。このまま実装を開始しますか？ (y/n)
+
+   推奨: WARN問題を修正してから実装開始
+   ```
+
+### Step 2: コンテキスト読み込み
+
+1. `.michi/config.json` からプロジェクト情報取得
+
+2. 登録リポジトリの一覧を取得
+
+3. 各リポジトリの `localPath` を取得
+
+4. 各リポジトリのタスクファイル確認
+   - `{localPath}/.kiro/specs/{feature}/tasks.md`
+
+### Step 3: チェックポイント確認
+
+`docs/michi/$1/.checkpoint-impl.json` の存在を確認
+
+存在する場合:
+```
+⚠️ チェックポイントファイルが見つかりました
+
+前回の実装が中断された可能性があります。
+
+次のアクション:
+A) チェックポイントから再開（未完了リポジトリのみ処理）
+B) 最初から実行（チェックポイント削除）
+C) キャンセル
+
+選択 (A/B/C): _
+```
+
+### Step 4: サブエージェント並行起動
+
+**並行実行数**: 最大3並列
+
+repo-spec-executorサブエージェントを使用して、以下のリポジトリで実装を並行実行してください：
+
+**Repository 1**: {repo1.name}
+- LOCAL_PATH: {repo1.localPath}
+- PARENT_PROJECT: $1
+- FEATURE_NAME: {feature}
+- OPERATION: impl
+- TASKS: {指定されたtask-numbers または "all"}
+
+**Repository 2**: {repo2.name}
+- LOCAL_PATH: {repo2.localPath}
+- PARENT_PROJECT: $1
+- FEATURE_NAME: {feature}
+- OPERATION: impl
+- TASKS: {指定されたtask-numbers または "all"}
+
+（以下、登録されている全リポジトリ）
+
+**重要**: 各サブエージェントの完了を待ち、結果を集約してください。
+
+### Step 5: 結果集約とレポート
+
+各リポジトリの実行結果を集約:
+
+| リポジトリ | タスク進捗 | カバレッジ | Lint | Build | ステータス |
+|-----------|----------|-----------|------|-------|----------|
+| frontend  | 5/5      | 96%       | ✅   | ✅    | ✅ 完了  |
+| backend   | 8/8      | 98%       | ✅   | ✅    | ✅ 完了  |
+| shared    | 3/3      | 95%       | ✅   | ✅    | ✅ 完了  |
+
+**成功件数**: 3/3
+**全体カバレッジ**: 96.3%
+
+### Step 6: チェックポイント保存（失敗時）
+
+失敗したリポジトリがある場合、チェックポイントを保存:
+
+```json
+{
+  "projectName": "$1",
+  "operation": "impl",
+  "repositories": {
+    "frontend": {
+      "status": "completed",
+      "tasksCompleted": 5,
+      "tasksTotal": 5,
+      "coverage": 96,
+      "completedAt": "2025-12-23T11:00:00Z"
+    },
+    "backend": {
+      "status": "failed",
+      "tasksCompleted": 3,
+      "tasksTotal": 8,
+      "error": "Test failed: auth.test.ts",
+      "failedAt": "2025-12-23T11:10:00Z"
+    }
+  },
+  "savedAt": "2025-12-23T11:11:00Z"
+}
+```
+
+保存先: `docs/michi/$1/.checkpoint-impl.json`
+
+### Step 7: 次のアクション案内
+
+**全成功時**:
+```markdown
+🎉 全リポジトリで実装が完了しました
+
+### 実装サマリー
+
+| 指標 | 結果 |
+|------|------|
+| 完了リポジトリ | 3/3 |
+| 全体カバレッジ | 96.3% |
+| Lint/Build | ✅ All Pass |
+
+### 次のステップ
+
+1. 各リポジトリでPR作成:
+   各リポジトリで `/pr` コマンドを実行
+
+2. CI結果を監視:
+   `michi multi-repo:ci-status $1`
+
+3. PRマージ後、リリース準備:
+   - Confluenceリリース手順書作成
+   - JIRAリリースチケット起票
+```
+
+**一部失敗時**:
+```markdown
+⚠️ 一部のリポジトリで失敗しました
+
+### 失敗したリポジトリ
+- backend: Test failed: auth.test.ts (タスク3/8完了)
+
+### 対処方法
+
+1. 失敗箇所を確認:
+   ```bash
+   cd {backend.localPath}
+   npm test auth.test.ts
+   ```
+
+2. 修正後、チェックポイントから再開:
+   `/michi-multi-repo:impl-all $1`
+   （失敗したリポジトリのみ処理されます）
+```
+
+## Important Constraints
+- spec-review合格が前提（BLOCK問題がないこと）
+- 並行実行は最大3リポジトリ
+- TDDサイクル（RED-GREEN-REFACTOR）を遵守
+- テストカバレッジ95%以上を維持
+- 各リポジトリは独立して処理（依存関係なし）
+
+</instructions>
+
+## Tool Guidance
+- **Task**: repo-spec-executorサブエージェント起動に使用
+- **Read**: config.json、レビューレポート、タスクファイル読み込み
+- **Write**: チェックポイント保存
+- **Bash**: Git操作、カバレッジ確認
+
+## Output Description
+
+日本語で以下の情報を出力してください:
+
+1. **処理対象リポジトリ一覧**: 各リポジトリのタスク進捗
+2. **実行結果サマリー**: 成功/失敗件数、全体カバレッジ
+3. **各リポジトリの詳細結果**: カバレッジ、Lint/Build結果、エラー内容
+4. **次のアクション**: 成功時/失敗時の推奨ステップ
+
+## Safety & Fallback
+
+### Error Scenarios
+
+- **品質ゲート不合格**:
+  ```
+  エラー: 品質ゲート不合格のため、実装を開始できません。
+
+  `/michi-multi-repo:spec-review $1` を実行し、BLOCK問題を解決してください。
+  ```
+
+- **タスクファイル不存在**:
+  ```
+  エラー: リポジトリ '{name}' にタスクファイルがありません: .kiro/specs/{feature}/tasks.md
+
+  タスクを生成してください:
+  cd {localPath}
+  /kiro:spec-tasks {feature}
+  ```
+
+- **localPath未設定**:
+  ```
+  警告: リポジトリ '{name}' の localPath が未設定です。スキップします。
+  ```
+
+### Fallback Strategy
+- localPath未設定: 該当リポジトリをスキップし、他のリポジトリで処理続行
+- サブエージェント失敗: チェックポイント保存し、リトライ可能にする
+- テスト失敗: 自動修正を試行（最大3回）、失敗時はチェックポイント保存
+
+think hard