@sk8metal/michi-cli 0.4.0 → 0.7.0

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

@@ -134,7 +134,6 @@ gh pr create --head <project-id>/feature/<feature> --base main
 | `/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,8 +148,8 @@ gh pr create --head <project-id>/feature/<feature> --base main
 | `michi phase:run <feature> <phase>`         | フェーズ実行（requirements/design/tasks）         |
 | `michi validate:phase <feature> <phase>`    | フェーズ完了バリデーション                        |
 | `michi preflight [phase]`                   | プリフライトチェック                              |
-| `michi project:list`                        | プロジェクト一覧                                  |
-| `michi project:dashboard`                   | リソースダッシュボード生成                        |
+| `michi spec:list [--all]`                   | 仕様書一覧（--allでアーカイブも表示）             |
+| `michi spec:archive <feature> [--reason]`   | 完了した仕様書をアーカイブ                        |
 | `michi workflow:run --feature <name>`       | 統合ワークフロー実行                              |
 | `michi config:validate`                     | 設定ファイルのバリデーション                      |
 | `michi tasks:convert <feature>`             | AI-DLC形式のtasks.mdをMichiワークフロー形式に変換 |
@@ -167,51 +166,38 @@ gh pr create --head <project-id>/feature/<feature> --base main
 
 ## npmスクリプト一覧（michiリポジトリ内）
 
-| コマンド                 | 説明                  |
-| ------------------------ | --------------------- |
-| `npm run setup:env`      | .env テンプレート作成 |
-| `npm run create-project` | 新規プロジェクト作成  |
-| `npm run multi-estimate` | 見積もり集計          |
-| `npm run michi`          | ローカルCLIツール実行 |
+| コマンド            | 説明                  |
+| ------------------- | --------------------- |
+| `npm run setup:env` | .env テンプレート作成 |
+| `npm run michi`     | ローカルCLIツール実行 |
 
-## プロジェクト切り替え
+## 仕様書管理
 
-### 方法1: Cursorコマンド
-
-```
-/michi:project-switch <project-id>
-```
-
-### 方法2: ターミナル
+### 仕様書一覧の確認
 
 ```bash
-cd ~/work/projects/<project-name>
-cat .kiro/project.json
-```
-
-## プロジェクト横断操作
+# アクティブな仕様書のみ
+npx @sk8metal/michi-cli spec:list
 
-### すべてのプロジェクトを確認
-
-```bash
-cd /path/to/michi
-# 全プロジェクトの一覧を表示
-npx @sk8metal/michi-cli project:list
+# アーカイブ済みも含む
+npx @sk8metal/michi-cli spec:list --all
 ```
 
-### リソースダッシュボード
+### 完了した仕様書のアーカイブ
 
 ```bash
-# Confluenceにプロジェクト横断ダッシュボードを作成
-npx @sk8metal/michi-cli project:dashboard
-```
+# 基本的な使い方
+npx @sk8metal/michi-cli spec:archive <feature>
 
-### 見積もり集計
-
-```bash
-npm run multi-estimate
+# 理由を付けてアーカイブ
+npx @sk8metal/michi-cli spec:archive <feature> --reason "v1.0.0としてリリース済み"
 ```
 
+**アーカイブ条件**:
+- Phase が `implementation-complete`
+- `release-notes-*.md` ファイルが存在する
+- まだアーカイブされていない
+
 ## Git/Jujutsuコマンド
 
 ### 基本フロー
@@ -308,5 +294,4 @@ npm install
 - [セットアップガイド](./setup.md)
 - [新規リポジトリセットアップ](../getting-started/new-repository-setup.md)
 - [ワークフローガイド](./workflow.md)
-- [マルチプロジェクト管理](./multi-project.md)
 - [テスト・検証](./testing.md)

package/env.example

@@ -6,7 +6,7 @@ ATLASSIAN_API_TOKEN=your-atlassian-api-token-here
 # GitHub設定
 GITHUB_ORG=your-github-org
 GITHUB_TOKEN=your-github-token-here
-GITHUB_REPO=your-org/your-repo
+# Note: GITHUB_REPO is deprecated. Use .kiro/project.json's repository field instead.
 
 # Confluence設定
 CONFLUENCE_PRD_SPACE=PRD

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sk8metal/michi-cli",
-  "version": "0.4.0",
+  "version": "0.7.0",
   "description": "Managed Intelligent Comprehensive Hub for Integration - AI-driven development workflow automation",
   "license": "MIT",
   "type": "module",
@@ -49,12 +49,9 @@
     "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",
     "confluence:sync": "tsx scripts/confluence-sync.ts",
     "jira:sync": "tsx scripts/jira-sync.ts",
     "github:create-pr": "tsx scripts/pr-automation.ts",
-    "project:list": "tsx scripts/list-projects.ts",
-    "project:dashboard": "tsx scripts/resource-dashboard.ts",
     "multi-estimate": "tsx scripts/multi-project-estimate.ts",
     "markdown:convert": "tsx scripts/markdown-to-confluence.ts",
     "michi": "tsx src/cli.ts",
@@ -72,7 +69,7 @@
     "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",
+    "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 .",
     "lint:fix": "eslint . --fix",
     "format": "prettier --write .",

package/scripts/__tests__/config-loader-multi-repo.test.ts

@@ -0,0 +1,342 @@
+/**
+ * Config Loader - Multi-Repo機能のテスト
+ * Task 1.3: 設定管理APIの拡張
+ */
+
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdirSync, rmSync, writeFileSync, existsSync } from 'fs';
+import { resolve } from 'path';
+import {
+  addMultiRepoProject,
+  addRepositoryToProject,
+  findProject,
+  clearConfigCache,
+} from '../utils/config-loader';
+
+// テスト用の一時ディレクトリ
+const TEST_PROJECT_ROOT = resolve(__dirname, '../__test-tmp__/multi-repo-test');
+
+describe('Multi-Repo Config Management', () => {
+  beforeEach(() => {
+    // テスト用ディレクトリを作成
+    mkdirSync(resolve(TEST_PROJECT_ROOT, '.michi'), { recursive: true });
+    clearConfigCache();
+  });
+
+  afterEach(() => {
+    // テスト用ディレクトリをクリーンアップ
+    if (existsSync(TEST_PROJECT_ROOT)) {
+      rmSync(TEST_PROJECT_ROOT, { recursive: true, force: true });
+    }
+    clearConfigCache();
+  });
+
+  describe('addMultiRepoProject', () => {
+    it('新しいプロジェクトを追加できる', () => {
+      const project = {
+        name: 'test-project',
+        jiraKey: 'TEST',
+        confluenceSpace: 'SPACE',
+        createdAt: '2025-12-14T10:00:00Z',
+        repositories: [],
+      };
+
+      const result = addMultiRepoProject(project, TEST_PROJECT_ROOT);
+
+      expect(result.success).toBe(true);
+      expect(result.project).toEqual(project);
+
+      // 設定ファイルが作成されたことを確認
+      const configPath = resolve(TEST_PROJECT_ROOT, '.michi/config.json');
+      expect(existsSync(configPath)).toBe(true);
+    });
+
+    it('既存のプロジェクトに新しいプロジェクトを追加できる', () => {
+      // 1つ目のプロジェクトを追加
+      const project1 = {
+        name: 'project1',
+        jiraKey: 'PROJA',
+        confluenceSpace: 'SPACE1',
+        createdAt: '2025-12-14T10:00:00Z',
+        repositories: [],
+      };
+      addMultiRepoProject(project1, TEST_PROJECT_ROOT);
+
+      // 2つ目のプロジェクトを追加
+      const project2 = {
+        name: 'project2',
+        jiraKey: 'PROJB',
+        confluenceSpace: 'SPACE2',
+        createdAt: '2025-12-14T11:00:00Z',
+        repositories: [],
+      };
+      const result = addMultiRepoProject(project2, TEST_PROJECT_ROOT);
+
+      expect(result.success).toBe(true);
+      expect(result.project).toEqual(project2);
+
+      // 両方のプロジェクトが存在することを確認
+      const found1 = findProject('project1', TEST_PROJECT_ROOT);
+      const found2 = findProject('project2', TEST_PROJECT_ROOT);
+
+      expect(found1).toEqual(project1);
+      expect(found2).toEqual(project2);
+    });
+
+    it('重複するプロジェクト名の場合はエラー', () => {
+      const project = {
+        name: 'duplicate-project',
+        jiraKey: 'DUP',
+        confluenceSpace: 'SPACE',
+        createdAt: '2025-12-14T10:00:00Z',
+        repositories: [],
+      };
+
+      // 1回目は成功
+      addMultiRepoProject(project, TEST_PROJECT_ROOT);
+
+      // 2回目は失敗
+      const result = addMultiRepoProject(project, TEST_PROJECT_ROOT);
+
+      expect(result.success).toBe(false);
+      expect(result.error).toContain('already exists');
+    });
+
+    it('無効なプロジェクト情報の場合はエラー', () => {
+      const invalidProject = {
+        name: '../etc/passwd', // パストラバーサル
+        jiraKey: 'TEST',
+        confluenceSpace: 'SPACE',
+        createdAt: '2025-12-14T10:00:00Z',
+        repositories: [],
+      };
+
+      const result = addMultiRepoProject(invalidProject, TEST_PROJECT_ROOT);
+
+      expect(result.success).toBe(false);
+      expect(result.error).toBeDefined();
+    });
+
+    it('無効なJIRAキーの場合はエラー', () => {
+      const invalidProject = {
+        name: 'test-project',
+        jiraKey: 'abc', // 小文字は不可
+        confluenceSpace: 'SPACE',
+        createdAt: '2025-12-14T10:00:00Z',
+        repositories: [],
+      };
+
+      const result = addMultiRepoProject(invalidProject, TEST_PROJECT_ROOT);
+
+      expect(result.success).toBe(false);
+      expect(result.error).toBeDefined();
+    });
+  });
+
+  describe('addRepositoryToProject', () => {
+    beforeEach(() => {
+      // テスト用プロジェクトを作成
+      const project = {
+        name: 'test-project',
+        jiraKey: 'TEST',
+        confluenceSpace: 'SPACE',
+        createdAt: '2025-12-14T10:00:00Z',
+        repositories: [],
+      };
+      addMultiRepoProject(project, TEST_PROJECT_ROOT);
+    });
+
+    it('プロジェクトにリポジトリを追加できる', () => {
+      const repository = {
+        name: 'repo1',
+        url: 'https://github.com/owner/repo1',
+        branch: 'main',
+      };
+
+      const result = addRepositoryToProject(
+        'test-project',
+        repository,
+        TEST_PROJECT_ROOT,
+      );
+
+      expect(result.success).toBe(true);
+      expect(result.repository).toEqual(repository);
+
+      // プロジェクトにリポジトリが追加されたことを確認
+      const project = findProject('test-project', TEST_PROJECT_ROOT);
+      expect(project?.repositories).toHaveLength(1);
+      expect(project?.repositories[0]).toEqual(repository);
+    });
+
+    it('複数のリポジトリを追加できる', () => {
+      const repo1 = {
+        name: 'repo1',
+        url: 'https://github.com/owner/repo1',
+        branch: 'main',
+      };
+      const repo2 = {
+        name: 'repo2',
+        url: 'https://github.com/owner/repo2',
+        branch: 'develop',
+      };
+
+      addRepositoryToProject('test-project', repo1, TEST_PROJECT_ROOT);
+      const result = addRepositoryToProject(
+        'test-project',
+        repo2,
+        TEST_PROJECT_ROOT,
+      );
+
+      expect(result.success).toBe(true);
+
+      const project = findProject('test-project', TEST_PROJECT_ROOT);
+      expect(project?.repositories).toHaveLength(2);
+      expect(project?.repositories).toContainEqual(repo1);
+      expect(project?.repositories).toContainEqual(repo2);
+    });
+
+    it('存在しないプロジェクトの場合はエラー', () => {
+      const repository = {
+        name: 'repo1',
+        url: 'https://github.com/owner/repo1',
+        branch: 'main',
+      };
+
+      const result = addRepositoryToProject(
+        'non-existent',
+        repository,
+        TEST_PROJECT_ROOT,
+      );
+
+      expect(result.success).toBe(false);
+      expect(result.error).toContain('not found');
+    });
+
+    it('無効なリポジトリURLの場合はエラー', () => {
+      const invalidRepo = {
+        name: 'repo1',
+        url: 'https://gitlab.com/owner/repo1', // GitLabは非対応
+        branch: 'main',
+      };
+
+      const result = addRepositoryToProject(
+        'test-project',
+        invalidRepo,
+        TEST_PROJECT_ROOT,
+      );
+
+      expect(result.success).toBe(false);
+      expect(result.error).toBeDefined();
+    });
+
+    it('重複するリポジトリ名の場合はエラー', () => {
+      const repository = {
+        name: 'duplicate-repo',
+        url: 'https://github.com/owner/repo1',
+        branch: 'main',
+      };
+
+      // 1回目は成功
+      addRepositoryToProject('test-project', repository, TEST_PROJECT_ROOT);
+
+      // 2回目は失敗
+      const result = addRepositoryToProject(
+        'test-project',
+        repository,
+        TEST_PROJECT_ROOT,
+      );
+
+      expect(result.success).toBe(false);
+      expect(result.error).toContain('already exists');
+    });
+  });
+
+  describe('findProject', () => {
+    beforeEach(() => {
+      // テスト用プロジェクトを複数作成
+      const project1 = {
+        name: 'project1',
+        jiraKey: 'PROJA',
+        confluenceSpace: 'SPACE1',
+        createdAt: '2025-12-14T10:00:00Z',
+        repositories: [
+          {
+            name: 'repo1',
+            url: 'https://github.com/owner/repo1',
+            branch: 'main',
+          },
+        ],
+      };
+      const project2 = {
+        name: 'project2',
+        jiraKey: 'PROJB',
+        confluenceSpace: 'SPACE2',
+        createdAt: '2025-12-14T11:00:00Z',
+        repositories: [],
+      };
+
+      addMultiRepoProject(project1, TEST_PROJECT_ROOT);
+      addMultiRepoProject(project2, TEST_PROJECT_ROOT);
+    });
+
+    it('プロジェクト名で検索できる', () => {
+      const project = findProject('project1', TEST_PROJECT_ROOT);
+
+      expect(project).toBeDefined();
+      expect(project?.name).toBe('project1');
+      expect(project?.jiraKey).toBe('PROJA');
+      expect(project?.repositories).toHaveLength(1);
+    });
+
+    it('存在しないプロジェクトの場合はnullを返す', () => {
+      const project = findProject('non-existent', TEST_PROJECT_ROOT);
+
+      expect(project).toBeNull();
+    });
+
+    it('設定ファイルが存在しない場合はnullを返す', () => {
+      const emptyRoot = resolve(__dirname, '../__test-tmp__/empty-project');
+      mkdirSync(emptyRoot, { recursive: true });
+
+      const project = findProject('project1', emptyRoot);
+
+      expect(project).toBeNull();
+
+      rmSync(emptyRoot, { recursive: true, force: true });
+    });
+  });
+
+  describe('アトミック更新', () => {
+    it('設定ファイルの更新中にエラーが発生しても既存の設定が破損しない', () => {
+      // 初期設定を作成
+      const configPath = resolve(TEST_PROJECT_ROOT, '.michi/config.json');
+      const initialConfig = {
+        multiRepoProjects: [
+          {
+            name: 'existing-project',
+            jiraKey: 'EXIST',
+            confluenceSpace: 'SPACE',
+            createdAt: '2025-12-14T10:00:00Z',
+            repositories: [],
+          },
+        ],
+      };
+      writeFileSync(configPath, JSON.stringify(initialConfig, null, 2));
+
+      // 無効なプロジェクトを追加しようとする（失敗するはず）
+      const invalidProject = {
+        name: '../etc/passwd',
+        jiraKey: 'TEST',
+        confluenceSpace: 'SPACE',
+        createdAt: '2025-12-14T11:00:00Z',
+        repositories: [],
+      };
+      addMultiRepoProject(invalidProject, TEST_PROJECT_ROOT);
+
+      // 既存の設定が破損していないことを確認
+      const existingProject = findProject('existing-project', TEST_PROJECT_ROOT);
+      expect(existingProject).toBeDefined();
+      expect(existingProject?.name).toBe('existing-project');
+    });
+  });
+});