@sk8metal/michi-cli 0.2.1 → 0.4.0

package/docs/user-guide/reference/quick-reference.md

@@ -4,83 +4,65 @@
 
 ## 新規プロジェクト作成
 
-### パターンA: 既存リポジトリにMichi共通ルール・コマンドを追加（最も簡単 ⭐）
+### 推奨: `michi init` コマンド（最も簡単 ⭐）
 
 ```bash
-# 既存プロジェクトに移動
+# 既存リポジトリに移動
 cd /path/to/existing-repo
 
-# Michiの共通ルール・コマンド・テンプレートをコピー
-npx tsx /path/to/michi/scripts/setup-existing-project.ts --michi-path /path/to/michi
+# 1コマンドで初期設定完了
+michi init --michi-path /path/to/michi
 ```
 
-このスクリプトが自動的に：
+このコマンドが自動的に：
 
-- 共通ルール（`.cursor/rules/`）をコピー
-- カスタムコマンド（`.cursor/commands/kiro/`）をコピー
+- プロジェクトメタデータ（`.kiro/project.json`）を作成
+- 環境変数テンプレート（`.env`）を作成
+- 共通ルール・コマンドをコピー（`--michi-path` 指定時）
 - Steeringテンプレート（`.kiro/steering/`）をコピー
 - Specテンプレート（`.kiro/settings/templates/`）をコピー
+- ワークフロー設定（`.michi/config.json`）を作成
+  - グローバル設定（`~/.michi/config.json`）があればコピー
+  - なければ対話的に設定
 
-**次のステップ**:
-
-1. cc-sddを導入: `npx cc-sdd@latest --lang ja --cursor`
-2. 設定を対話的に作成: `npm run setup:interactive`
-
-### パターンB: 新規リポジトリを作成してセットアップ
+**オプション**:
 
 ```bash
-# Michiから実行
-cd /path/to/michi
-
-# 凡例
-npm run create-project -- \
-  --name "<project-id>" \
-  --project-name "<project-name>" \
-  --jira-key "<jira-key>"
-
-# 具体例
-npm run create-project -- \
-  --name "20240115-payment-api" \
-  --project-name "プロジェクトA" \
-  --jira-key "PRJA"
+# 非対話モード（プロジェクト名とJIRAキーを指定）
+michi init \
+  --name "project-id" \
+  --project-name "プロジェクト名" \
+  --jira-key "PRJA" \
+  --michi-path /path/to/michi \
+  -y
+
+# ワークフロー設定をスキップ
+michi init --michi-path /path/to/michi --skip-config
+
+# 環境を指定（デフォルト: Cursor）
+michi init --michi-path /path/to/michi --cursor
+michi init --michi-path /path/to/michi --claude
 ```
 
-**リポジトリ名**: `--name`で指定した値がそのままGitHubリポジトリ名として使用されます。
-
-**例**:
+**次のステップ**:
 
-- `--name "20240115-payment-api"` → GitHubリポジトリ: `org/20240115-payment-api`
-- `--name "payment-api"` → GitHubリポジトリ: `org/payment-api`
+1. `.env` ファイルの内容を確認・編集
+2. `.michi/config.json` の内容を確認（必要に応じて編集）
+3. 開発開始: `/kiro:spec-init <機能説明>`
 
-**注意**: リポジトリ名はkebab-case（小文字、ハイフン区切り）を推奨します。
+### 代替: 個別セットアップ
 
-### パターンC: 完全手動セットアップ
+グローバル設定を先に作成する場合:
 
 ```bash
-# 1. リポジトリ作成・クローン
-gh repo create org/repo-name --private
-jj git clone https://github.com/org/repo-name
-cd repo-name
-
-# 2. cc-sdd導入
-npx cc-sdd@latest --cursor --lang ja --yes
-
-# 3. プロジェクトメタデータ作成
-cat > .kiro/project.json << 'EOF'
-{
-  "projectId": "repo-name",
-  "projectName": "プロジェクト名",
-  "jiraProjectKey": "PRJX",
-  "confluenceLabels": ["project:x", "service:y"]
-}
-EOF
-
-# 4. Michiから共通ルール・コマンド・テンプレートをコピー
-npx tsx /path/to/michi/scripts/setup-existing-project.ts \
-  --michi-path /path/to/michi
-
-# 5. npm install
-# 6. 初期コミット
+# 1. グローバル設定を作成（組織で一度だけ）
+michi config:global
+
+# 2. プロジェクト初期設定
+cd /path/to/project
+michi init --michi-path /path/to/michi
+
+# グローバル設定が自動的にコピーされます
 ```
 
 詳細: [新規リポジトリセットアップガイド](../getting-started/new-repository-setup.md)
@@ -128,20 +110,31 @@ gh pr create --head <project-id>/feature/<feature> --base main
 
 ## コマンド一覧
 
-| コマンド                                 | 説明                       | 分類       |
-| ---------------------------------------- | -------------------------- | ---------- |
-| `/kiro:spec-init <description>`          | 仕様初期化                 | cc-sdd     |
-| `/kiro:spec-requirements <feature>`      | 要件定義生成               | cc-sdd     |
-| `/kiro:spec-design <feature>`            | 設計生成                   | cc-sdd     |
-| `/kiro:spec-tasks <feature>`             | タスク分割                 | cc-sdd     |
-| `/kiro:spec-impl <feature> <tasks>`      | TDD実装                    | cc-sdd     |
-| `/kiro:spec-status <feature>`            | 進捗確認                   | cc-sdd     |
-| `/kiro:steering`                         | Steering作成/更新          | cc-sdd     |
-| `/kiro:steering-custom`                  | カスタムSteering作成       | cc-sdd     |
-| `/kiro:validate-gap <feature>`           | 既存コードと要件の差異分析 | cc-sdd     |
-| `/kiro:validate-design <feature>`        | 設計の品質レビューと検証   | cc-sdd     |
-| `/kiro:confluence-sync <feature> [type]` | Confluence同期             | Michi only |
-| `/kiro:project-switch <project_id>`      | プロジェクト切り替え       | Michi only |
+### cc-sdd 標準コマンド
+
+| コマンド                                 | 説明                       |
+| ---------------------------------------- | -------------------------- |
+| `/kiro:spec-init <description>`          | 仕様初期化                 |
+| `/kiro:spec-requirements <feature>`      | 要件定義生成               |
+| `/kiro:spec-design <feature>`            | 設計生成（cc-sdd標準版）   |
+| `/kiro:spec-tasks <feature>`             | タスク分割                 |
+| `/kiro:spec-impl <feature> <tasks>`      | TDD実装                    |
+| `/kiro:spec-status <feature>`            | 進捗確認                   |
+| `/kiro:steering`                         | Steering作成/更新          |
+| `/kiro:steering-custom`                  | カスタムSteering作成       |
+| `/kiro:validate-gap <feature>`           | 既存コードと要件の差異分析 |
+| `/kiro:validate-design <feature>`        | 設計の品質レビューと検証   |
+
+### Michi 拡張コマンド
+
+> **注**: これらのコマンドは Michi 独自の拡張機能です。cc-sdd 標準には含まれません。
+
+| コマンド                                 | 説明                                           |
+| ---------------------------------------- | ---------------------------------------------- |
+| `/michi:spec-design <feature>`           | 設計生成（Phase 0.3-0.4 ガイダンス付き）⭐推奨 |
+| `/michi:validate-design <feature>`       | 設計レビュー（テスト計画完了確認付き）         |
+| `/michi:confluence-sync <feature> [type]` | Confluence同期                                 |
+| `/michi:project-switch <project_id>`      | プロジェクト切り替え                           |
 
 ## Michi CLIコマンド一覧
 
@@ -149,6 +142,8 @@ gh pr create --head <project-id>/feature/<feature> --base main
 
 | コマンド                                    | 説明                                              |
 | ------------------------------------------- | ------------------------------------------------- |
+| `michi init`                                | プロジェクト初期設定（推奨）⭐                    |
+| `michi config:global`                       | グローバル設定作成（~/.michi/config.json）        |
 | `michi jira:sync <feature>`                 | JIRA連携（tasks.md → Epic/Stories）               |
 | `michi confluence:sync <feature> [type]`    | Confluence同期（requirements/design）             |
 | `michi phase:run <feature> <phase>`         | フェーズ実行（requirements/design/tasks）         |
@@ -157,7 +152,6 @@ gh pr create --head <project-id>/feature/<feature> --base main
 | `michi project:list`                        | プロジェクト一覧                                  |
 | `michi project:dashboard`                   | リソースダッシュボード生成                        |
 | `michi workflow:run --feature <name>`       | 統合ワークフロー実行                              |
-| `michi config:interactive`                  | 対話式設定ツール（.michi/config.json作成）        |
 | `michi config:validate`                     | 設定ファイルのバリデーション                      |
 | `michi tasks:convert <feature>`             | AI-DLC形式のtasks.mdをMichiワークフロー形式に変換 |
 | `michi jira:transition <issueKey> <status>` | JIRAチケットのステータス変更                      |
@@ -185,7 +179,7 @@ gh pr create --head <project-id>/feature/<feature> --base main
 ### 方法1: Cursorコマンド
 
 ```
-/kiro:project-switch <project-id>
+/michi:project-switch <project-id>
 ```
 
 ### 方法2: ターミナル
@@ -303,6 +297,8 @@ npm install
 
 ### Steering
 
+**注意**: `/kiro:steering`コマンドで作成（セットアップ時には自動生成されません）
+
 - `.kiro/steering/product.md`
 - `.kiro/steering/tech.md`
 - `.kiro/steering/structure.md`

package/docs/user-guide/testing/test-planning-flow.md

@@ -1,5 +1,9 @@
 # テスト計画フロー
 
+> **Michi 固有ワークフロー**: このテスト計画フロー（Phase 0.3-0.4, Phase 1, Phase A/B/3）は Michi 独自の拡張機能です。cc-sdd 標準には含まれません。
+>
+> `/michi:spec-design` コマンドを使用すると、設計完了後に自動的に Phase 0.3-0.4 へのガイダンスが表示されます。
+
 このドキュメントでは、michiを使用したプロジェクトでのテスト計画の流れを説明します。
 
 ## Phase 0.3: テストタイプの選択

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sk8metal/michi-cli",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "Managed Intelligent Comprehensive Hub for Integration - AI-driven development workflow automation",
   "license": "MIT",
   "type": "module",
@@ -46,12 +46,10 @@
     "build": "tsc && node scripts/copy-static-assets.js",
     "postbuild": "node scripts/set-permissions.js",
     "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",
     "jira:sync": "tsx scripts/jira-sync.ts",
     "github:create-pr": "tsx scripts/pr-automation.ts",
@@ -66,7 +64,7 @@
     "preflight": "tsx scripts/pre-flight-check.ts",
     "pre-publish": "bash scripts/pre-publish-check.sh",
     "test:package": "bash scripts/test-npm-package.sh",
-    "config:interactive": "tsx scripts/config-interactive.ts",
+    "config:global": "tsx scripts/config-global.ts",
     "config:validate": "tsx scripts/utils/config-validator.ts",
     "test:interactive": "tsx scripts/test-interactive.ts",
     "test": "vitest",

package/scripts/config-global.ts

@@ -0,0 +1,160 @@
+/**
+ * グローバル設定ツール
+ * ~/.michi/config.json を対話的に作成・更新
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { dirname } from 'path';
+import { createInterface, confirm } from './utils/interactive-helpers.js';
+import {
+  getConfluenceConfig,
+  getJiraConfig,
+  getWorkflowConfig,
+  type ConfluenceConfigResult,
+  type JiraConfigResult,
+  type WorkflowConfigResult,
+} from './utils/config-sections.js';
+import { getGlobalConfigPath } from './utils/config-loader.js';
+import { AppConfigSchema } from './config/config-schema.js';
+
+/**
+ * プロジェクト設定全体
+ */
+interface ProjectConfig {
+  confluence?: ConfluenceConfigResult;
+  jira?: JiraConfigResult;
+  workflow?: WorkflowConfigResult;
+}
+
+/**
+ * メイン処理
+ */
+async function main(): Promise<void> {
+  const rl = createInterface();
+
+  try {
+    console.log('🌐 Michi グローバル設定ツール');
+    console.log('='.repeat(60));
+    console.log('このツールで ~/.michi/config.json を作成・更新できます。');
+    console.log('');
+    console.log('グローバル設定は、すべてのプロジェクトに適用されます。');
+    console.log('プロジェクト固有の設定は .michi/config.json で上書きできます。');
+    console.log('');
+
+    const globalConfigPath = getGlobalConfigPath();
+    const globalConfigDir = dirname(globalConfigPath);
+
+    let existingConfig: ProjectConfig | null = null;
+
+    // 既存の設定ファイルを確認
+    if (existsSync(globalConfigPath)) {
+      console.log(`⚠️  既存のグローバル設定ファイルが見つかりました: ${globalConfigPath}`);
+      const overwrite = await confirm(rl, '上書きしますか？', false);
+
+      if (!overwrite) {
+        console.log('中止しました。');
+        process.exit(0);
+      }
+
+      try {
+        const content = readFileSync(globalConfigPath, 'utf-8');
+        existingConfig = JSON.parse(content) as ProjectConfig;
+        console.log('既存の設定を読み込みました。\n');
+      } catch {
+        console.log(
+          '既存の設定ファイルの読み込みに失敗しました。新規作成します。\n',
+        );
+      }
+    }
+
+    // 設定を対話的に取得
+    const config: ProjectConfig = existingConfig || {};
+
+    // Confluence設定
+    const configureConfluence = await confirm(
+      rl,
+      'Confluence設定をカスタマイズしますか？',
+      false,
+    );
+    if (configureConfluence) {
+      config.confluence = await getConfluenceConfig(rl);
+    }
+
+    // JIRA設定
+    const configureJira = await confirm(
+      rl,
+      'JIRA設定をカスタマイズしますか？',
+      false,
+    );
+    if (configureJira) {
+      config.jira = await getJiraConfig(rl);
+    }
+
+    // ワークフロー設定
+    const configureWorkflow = await confirm(
+      rl,
+      'ワークフロー設定をカスタマイズしますか？',
+      false,
+    );
+    if (configureWorkflow) {
+      config.workflow = await getWorkflowConfig(rl);
+    }
+
+    // 設定の確認
+    console.log('\n📋 設定内容の確認');
+    console.log('='.repeat(60));
+    console.log(JSON.stringify(config, null, 2));
+    console.log('');
+
+    const confirmSave = await confirm(rl, 'この設定を保存しますか？', true);
+
+    if (!confirmSave) {
+      console.log('保存をキャンセルしました。');
+      process.exit(0);
+    }
+
+    // ディレクトリを作成（存在しない場合）
+    if (!existsSync(globalConfigDir)) {
+      mkdirSync(globalConfigDir, { recursive: true });
+      console.log(`\n📁 ディレクトリを作成しました: ${globalConfigDir}`);
+    }
+
+    // 設定ファイルを保存
+    writeFileSync(globalConfigPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    console.log(`\n✅ グローバル設定ファイルを保存しました: ${globalConfigPath}`);
+
+    // バリデーション（スキーマチェックのみ）
+    console.log('\n🔍 設定ファイルのバリデーション...');
+    try {
+      AppConfigSchema.parse(config);
+      console.log('✅ 設定ファイルは有効です。');
+    } catch (error) {
+      console.warn('⚠️  設定ファイルに問題があります:');
+      console.warn(error instanceof Error ? error.message : error);
+      console.warn('   プロジェクト固有の設定で補完することができます。');
+    }
+
+    console.log('\n🎉 グローバル設定が完了しました！');
+    console.log('   この設定はすべてのプロジェクトに適用されます。');
+    console.log('   プロジェクト固有の設定で上書きしたい場合は:');
+    console.log('   グローバル設定をコピーして .michi/config.json として編集してください');
+  } catch (error) {
+    console.error(
+      '❌ エラーが発生しました:',
+      error instanceof Error ? error.message : error,
+    );
+    process.exit(1);
+  } finally {
+    rl.close();
+  }
+}
+
+// CLI実行
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main().catch((error) => {
+    console.error('❌ 予期しないエラー:', error);
+    process.exit(1);
+  });
+}
+
+export { main as configGlobal };

package/scripts/confluence-sync.ts

@@ -17,6 +17,56 @@ import { updateSpecJsonAfterConfluenceSync, loadSpecJson } from './utils/spec-up
 // 環境変数読み込み
 config();
 
+/**
+ * Confluence APIページレスポンス
+ */
+export interface ConfluencePage {
+  id: string;
+  title: string;
+  type: string;
+  version?: {
+    number: number;
+  };
+  _links?: {
+    webui: string;
+  };
+  ancestors?: Array<{ id: string }>;
+  results?: ConfluencePage[];
+}
+
+/**
+ * Confluenceエラーオブジェクト
+ */
+interface ConfluenceError extends Error {
+  response?: {
+    status: number;
+    data: unknown;
+  };
+  config?: {
+    url?: string;
+    params?: unknown;
+  };
+}
+
+/**
+ * Confluenceページ作成ペイロード
+ */
+interface ConfluenceCreatePagePayload {
+  type: 'page';
+  title: string;
+  space: { key: string };
+  body: {
+    storage: {
+      value: string;
+      representation: 'storage';
+    };
+  };
+  metadata: {
+    labels: Array<{ name: string }>;
+  };
+  ancestors?: Array<{ id: string }>;
+}
+
 /**
  * リクエスト間のスリープ処理（レートリミット対策）
  */
@@ -75,7 +125,7 @@ class ConfluenceClient {
    * @param title ページタイトル
    * @param parentId 親ページID（オプション）。指定された場合、その親ページの子ページのみを検索
    */
-  async searchPage(spaceKey: string, title: string, parentId?: string): Promise<any | null> {
+  async searchPage(spaceKey: string, title: string, parentId?: string): Promise<ConfluencePage | null> {
     // レートリミット対策: リクエスト前に待機
     await sleep(this.requestDelay);
     
@@ -129,27 +179,34 @@ class ConfluenceClient {
       }
       
       return null;
-    } catch (error: any) {
+    } catch (error: unknown) {
+      const isAxiosError = axios.isAxiosError(error);
+
       // 404エラーは既存ページがないことを意味するので、nullを返す
-      if (error.response?.status === 404) {
+      if (isAxiosError && error.response?.status === 404) {
         return null;
       }
-      
+
       // その他のエラーは詳細をログ出力
-      console.error('Error searching page:', error.message);
-      if (error.response) {
+      const message = error instanceof Error ? error.message : String(error);
+      console.error('Error searching page:', message);
+
+      if (isAxiosError && error.response) {
         console.error('  Status:', error.response.status);
         console.error('  Data:', JSON.stringify(error.response.data, null, 2));
       }
-      
+
       // 404以外のエラーは再スロー（認証、権限、ネットワーク、サーバーエラーなど）
       // エラーの詳細情報を含めて再スロー
-      if (error.response) {
+      if (isAxiosError && error.response) {
         // HTTPレスポンスがある場合（4xx/5xxエラー）
-        const enhancedError = new Error(
-          `Confluence API error: ${error.message} (status: ${error.response.status})`
+        const enhancedError: ConfluenceError = new Error(
+          `Confluence API error: ${message} (status: ${error.response.status})`
         );
-        (enhancedError as any).response = error.response;
+        enhancedError.response = {
+          status: error.response.status,
+          data: error.response.data
+        };
         throw enhancedError;
       } else {
         // ネットワークエラーなど、レスポンスがない場合
@@ -161,11 +218,11 @@ class ConfluenceClient {
   /**
    * ページを作成
    */
-  async createPage(spaceKey: string, title: string, content: string, labels: string[] = [], parentId?: string): Promise<any> {
+  async createPage(spaceKey: string, title: string, content: string, labels: string[] = [], parentId?: string): Promise<ConfluencePage> {
     // レートリミット対策: リクエスト前に待機
     await sleep(this.requestDelay);
-    
-    const payload: any = {
+
+    const payload: ConfluenceCreatePagePayload = {
       type: 'page',
       title,
       space: { key: spaceKey },
@@ -204,14 +261,14 @@ class ConfluenceClient {
     content: string,
     labels: string[] = [],
     parentId: string
-  ): Promise<any> {
+  ): Promise<ConfluencePage> {
     return this.createPage(spaceKey, title, content, labels, parentId);
   }
   
   /**
    * ページを更新
    */
-  async updatePage(pageId: string, title: string, content: string, version: number): Promise<any> {
+  async updatePage(pageId: string, title: string, content: string, version: number): Promise<ConfluencePage> {
     // レートリミット対策: リクエスト前に待機
     await sleep(this.requestDelay);
     
@@ -264,25 +321,32 @@ class ConfluenceClient {
       }
       
       return null; // ルートページ
-    } catch (error: any) {
+    } catch (error: unknown) {
+      const isAxiosError = axios.isAxiosError(error);
+
       // 404エラーはページが存在しないことを意味する
-      if (error.response?.status === 404) {
+      if (isAxiosError && error.response?.status === 404) {
         return null;
       }
-      
+
       // その他のエラーは詳細をログ出力
-      console.error('Error getting page parent:', error.message);
-      if (error.response) {
+      const message = error instanceof Error ? error.message : String(error);
+      console.error('Error getting page parent:', message);
+
+      if (isAxiosError && error.response) {
         console.error('  Status:', error.response.status);
         console.error('  Data:', JSON.stringify(error.response.data, null, 2));
       }
-      
+
       // 404以外のエラーは再スロー
-      if (error.response) {
-        const enhancedError = new Error(
-          `Confluence API error: ${error.message} (status: ${error.response.status})`
+      if (isAxiosError && error.response) {
+        const enhancedError: ConfluenceError = new Error(
+          `Confluence API error: ${message} (status: ${error.response.status})`
         );
-        (enhancedError as any).response = error.response;
+        enhancedError.response = {
+          status: error.response.status,
+          data: error.response.data
+        };
         throw enhancedError;
       } else {
         throw error;
@@ -454,7 +518,7 @@ if (import.meta.url === `file://${process.argv[1]}`) {
   }
   
   const featureName = args[0];
-  const docType = (args[1] as any) || 'requirements';
+  const docType = (args[1] as 'requirements' | 'design' | 'tasks' | undefined) || 'requirements';
   
   syncToConfluence(featureName, docType)
     .then(() => {