@sk8metal/michi-cli 0.4.0 → 0.5.0

package/docs/user-guide/getting-started/github-token-setup.md

@@ -230,9 +230,10 @@ nano .env
 # GitHub設定
 GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
 GITHUB_ORG=your-organization  # または your-username
-GITHUB_REPO=your-org/your-repo
 ```
 
+> **Note (v0.5.0以降)**: `GITHUB_REPO` 環境変数は廃止されました。リポジトリ情報は `.kiro/project.json` の `repository` フィールドから自動的に取得されます。
+
 **セキュリティ**:
 ```bash
 # .env ファイルのパーミッションを600に設定

package/docs/user-guide/getting-started/new-repository-setup.md

@@ -316,7 +316,7 @@ ATLASSIAN_API_TOKEN=your-token-here
 # GitHub設定
 GITHUB_ORG=your-org
 GITHUB_TOKEN=ghp_xxx
-GITHUB_REPO=your-org/20240115-payment-api
+# Note: リポジトリ情報は .kiro/project.json の repository フィールドで管理されます
 
 # Confluence共有スペース
 CONFLUENCE_PRD_SPACE=PRD

package/docs/user-guide/getting-started/quick-start.md

@@ -76,7 +76,7 @@ cat > .env <<EOF
 # GitHub設定（必須）
 GITHUB_TOKEN=your-github-token
 GITHUB_ORG=your-org
-GITHUB_REPO=your-org/your-repo
+# Note: リポジトリ情報は .kiro/project.json の repository フィールドで管理されます
 
 # JIRA設定（オプション）
 ATLASSIAN_URL=https://your-domain.atlassian.net

package/docs/user-guide/getting-started/setup.md

@@ -230,8 +230,7 @@ ATLASSIAN_API_TOKEN=<ATLASSIANトークン>
 # GitHub設定
 GITHUB_ORG=your-org
 GITHUB_TOKEN=<GitHubトークン>
-# 開発したいリポジトリ
-GITHUB_REPO=your-org/user-auth
+# Note: リポジトリ情報は .kiro/project.json の repository フィールドで管理されます
 
 # Confluence設定
 CONFLUENCE_PRD_SPACE=PRD
@@ -285,15 +284,9 @@ SLACK_WEBHOOK_URL=<SlackWebhook URL>
 - **確認方法**: 3-3セクション「GitHub Token」を参照
 - **使用機能**: すべてのGitHub連携機能で認証に使用（API呼び出し時の認証トークン）
 
-**`GITHUB_REPO`**
-- **確認方法**: GitHubリポジトリのURLから取得
-- **確認手順**:
-  1. リポジトリのページにアクセス（例: `https://github.com/org/repo`）
-  2. URLの `/org/repo` 部分がリポジトリ名
-- **形式**: `組織名/リポジトリ名`
-- **例**: `sk8metalme/michi`
-- **使用機能**:
-  - PR自動作成（`michi github:create-pr`）: 指定されたリポジトリにPull Requestを作成（ワークフロー自動化で使用）
+> **Note**: リポジトリ情報（以前の `GITHUB_REPO` 環境変数）は `.kiro/project.json` の `repository` フィールドで管理されるようになりました。
+> 形式: `https://github.com/org/repo.git` または `git@github.com:org/repo.git`
+> 例: `.kiro/project.json` に `"repository": "https://github.com/sk8metalme/michi.git"` と設定
 
 ##### Confluence設定
 

package/docs/user-guide/hands-on/claude-agent-setup.md

@@ -187,9 +187,10 @@ vim .env
 # GitHub設定（必須）
 GITHUB_TOKEN=ghp_your_token_here
 GITHUB_ORG=your-org
-GITHUB_REPO=your-org/your-repo
 ```
 
+> **Note (v0.5.0以降)**: `GITHUB_REPO` 環境変数は廃止されました。リポジトリ情報は `.kiro/project.json` の `repository` フィールドから自動的に取得されます。
+
 **完全な設定（Confluence/JIRA連携も使用）**:
 
 ```bash
@@ -201,7 +202,6 @@ ATLASSIAN_API_TOKEN=your-token-here
 # GitHub設定
 GITHUB_ORG=your-org
 GITHUB_TOKEN=ghp_xxx
-GITHUB_REPO=your-org/your-repo
 
 # Confluence共有スペース
 CONFLUENCE_PRD_SPACE=PRD

package/docs/user-guide/hands-on/claude-setup.md

@@ -173,9 +173,10 @@ vim .env
 # GitHub設定（必須）
 GITHUB_TOKEN=ghp_your_token_here
 GITHUB_ORG=your-org
-GITHUB_REPO=your-org/your-repo
 ```
 
+> **Note (v0.5.0以降)**: `GITHUB_REPO` 環境変数は廃止されました。リポジトリ情報は `.kiro/project.json` の `repository` フィールドから自動的に取得されます。
+
 **完全な設定（Confluence/JIRA連携も使用）**:
 
 ```bash
@@ -187,7 +188,6 @@ ATLASSIAN_API_TOKEN=your-token-here
 # GitHub設定
 GITHUB_ORG=your-org
 GITHUB_TOKEN=ghp_xxx
-GITHUB_REPO=your-org/your-repo
 
 # Confluence共有スペース
 CONFLUENCE_PRD_SPACE=PRD

package/docs/user-guide/hands-on/cursor-setup.md

@@ -140,9 +140,10 @@ vim .env
 # GitHub設定（必須）
 GITHUB_TOKEN=ghp_your_token_here
 GITHUB_ORG=your-org
-GITHUB_REPO=your-org/your-repo
 ```
 
+> **Note (v0.5.0以降)**: `GITHUB_REPO` 環境変数は廃止されました。リポジトリ情報は `.kiro/project.json` の `repository` フィールドから自動的に取得されます。
+
 **完全な設定（Confluence/JIRA連携も使用）**:
 
 ```bash
@@ -154,7 +155,6 @@ ATLASSIAN_API_TOKEN=your-token-here
 # GitHub設定
 GITHUB_ORG=your-org
 GITHUB_TOKEN=ghp_xxx
-GITHUB_REPO=your-org/your-repo
 
 # Confluence共有スペース
 CONFLUENCE_PRD_SPACE=PRD

package/docs/user-guide/hands-on/workflow-walkthrough.md

@@ -182,7 +182,10 @@ vim .env
 # 最低限、以下を設定:
 # GITHUB_TOKEN=your-token
 # GITHUB_ORG=your-org
-# GITHUB_REPO=your-org/your-repo
+```
+
+> **Note (v0.5.0以降)**: `GITHUB_REPO` 環境変数は廃止されました。リポジトリ情報は `.kiro/project.json` の `repository` フィールドから自動的に取得されます。
+
 ```
 
 詳細: [Cursor IDEセットアップガイド](./cursor-setup.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.5.0",
   "description": "Managed Intelligent Comprehensive Hub for Integration - AI-driven development workflow automation",
   "license": "MIT",
   "type": "module",
@@ -72,7 +72,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__/spec-impl-workflow.test.ts

@@ -32,6 +32,11 @@ vi.mock('../utils/config-loader.js', () => ({
   })),
 }));
 
+// project-metaをモック
+vi.mock('../utils/project-meta.js', () => ({
+  getRepositoryInfo: vi.fn(() => 'owner/repo'),
+}));
+
 // spec-loaderをモック
 const mockGetJiraInfoFromSpec = vi.fn();
 const mockCheckJiraInfoStatus = vi.fn();
@@ -62,7 +67,6 @@ describe('spec-impl-workflow', () => {
     process.env.ATLASSIAN_EMAIL = 'test@example.com';
     process.env.ATLASSIAN_API_TOKEN = 'test-token';
     process.env.GITHUB_TOKEN = 'github-token';
-    process.env.GITHUB_REPO = 'owner/repo';
   });
 
   afterEach(() => {
@@ -71,7 +75,6 @@ describe('spec-impl-workflow', () => {
     delete process.env.ATLASSIAN_EMAIL;
     delete process.env.ATLASSIAN_API_TOKEN;
     delete process.env.GITHUB_TOKEN;
-    delete process.env.GITHUB_REPO;
   });
 
   // ==========================================================================

package/scripts/config/config-schema.ts

@@ -146,6 +146,31 @@ export const ValidationConfigSchema = z.object({
   weekendExclusion: z.boolean().default(true),
 });
 
+/**
+ * Atlassian設定スキーマ
+ */
+export const AtlassianConfigSchema = z.object({
+  url: z.string().optional(),
+  email: z.string().optional(),
+  apiToken: z.string().optional(),
+});
+
+/**
+ * プロジェクトメタデータスキーマ
+ */
+export const ProjectMetaSchema = z.object({
+  projectId: z.string().min(1),
+  projectName: z.string().min(1),
+  language: z.enum(['ja', 'en']).optional(),
+  jiraProjectKey: z.string().optional(),
+  confluenceLabels: z.array(z.string()).optional(),
+  status: z.string().optional(),
+  team: z.array(z.string()).optional(),
+  stakeholders: z.array(z.string()).optional(),
+  repository: z.string().optional(),
+  description: z.string().optional(),
+});
+
 /**
  * 全体設定スキーマ
  */
@@ -154,6 +179,8 @@ export const AppConfigSchema = z.object({
   jira: JiraConfigSchema.optional(),
   workflow: WorkflowConfigSchema.optional(),
   validation: ValidationConfigSchema.optional(),
+  atlassian: AtlassianConfigSchema.optional(),
+  project: ProjectMetaSchema.optional(),
 });
 
 /**
@@ -177,4 +204,17 @@ export type JiraStatusMapping = z.infer<typeof JiraStatusMappingSchema>;
 export type JiraConfig = z.infer<typeof JiraConfigSchema>;
 export type WorkflowConfig = z.infer<typeof WorkflowConfigSchema>;
 export type ValidationConfig = z.infer<typeof ValidationConfigSchema>;
+export type AtlassianConfig = z.infer<typeof AtlassianConfigSchema>;
+export type ProjectMeta = z.infer<typeof ProjectMetaSchema>;
 export type AppConfig = z.infer<typeof AppConfigSchema>;
+
+/**
+ * 設定の読み込み元
+ */
+export type ConfigSource =
+  | 'default'        // default-config.json
+  | 'global-env'     // ~/.michi/.env
+  | 'global-config'  // ~/.michi/config.json
+  | 'project-meta'   // .kiro/project.json
+  | 'project-config' // .michi/config.json
+  | 'project-env';   // .env

package/scripts/pr-automation.ts

@@ -15,13 +15,23 @@ interface PROptions {
 }
 
 async function createPR(options: PROptions): Promise<void> {
+  const { getRepositoryInfo } = await import('./utils/project-meta.js');
   const token = process.env.GITHUB_TOKEN;
-  const repo = process.env.GITHUB_REPO;
-  
-  if (!token || !repo) {
-    throw new Error('Missing GitHub credentials');
+
+  if (!token) {
+    throw new Error('Missing GitHub credentials. Required: GITHUB_TOKEN');
   }
-  
+
+  // .kiro/project.json から repository 情報を取得
+  let repo: string;
+  try {
+    repo = getRepositoryInfo();
+  } catch (error) {
+    throw new Error(
+      `Failed to get repository info from .kiro/project.json: ${error instanceof Error ? error.message : error}`,
+    );
+  }
+
   const [owner, repoName] = repo.split('/');
   const octokit = new Octokit({ auth: token });
   

package/scripts/spec-impl-workflow.ts

@@ -258,12 +258,20 @@ ${jiraLink}
 *この PR は spec-impl ワークフローで自動作成されました*`;
 
     const { Octokit } = await import('@octokit/rest');
+    const { getRepositoryInfo } = await import('./utils/project-meta.js');
     const token = process.env.GITHUB_TOKEN;
-    const repo = process.env.GITHUB_REPO;
 
-    if (!token || !repo) {
+    if (!token) {
+      throw new Error('Missing GitHub credentials. Required: GITHUB_TOKEN');
+    }
+
+    // .kiro/project.json から repository 情報を取得
+    let repo: string;
+    try {
+      repo = getRepositoryInfo();
+    } catch (error) {
       throw new Error(
-        'Missing GitHub credentials. Required: GITHUB_TOKEN, GITHUB_REPO',
+        `Failed to get repository info from .kiro/project.json: ${error instanceof Error ? error.message : error}`,
       );
     }
 
@@ -393,12 +401,20 @@ export async function onSpecImplEnd(
 
   // PR 作成
   const { Octokit } = await import('@octokit/rest');
+  const { getRepositoryInfo } = await import('./utils/project-meta.js');
   const token = process.env.GITHUB_TOKEN;
-  const repo = process.env.GITHUB_REPO;
 
-  if (!token || !repo) {
+  if (!token) {
+    throw new Error('Missing GitHub credentials. Required: GITHUB_TOKEN');
+  }
+
+  // .kiro/project.json から repository 情報を取得
+  let repo: string;
+  try {
+    repo = getRepositoryInfo();
+  } catch (error) {
     throw new Error(
-      'Missing GitHub credentials. Required: GITHUB_TOKEN, GITHUB_REPO',
+      `Failed to get repository info from .kiro/project.json: ${error instanceof Error ? error.message : error}`,
     );
   }
 

package/scripts/utils/__tests__/config-loader.test.ts

@@ -10,6 +10,7 @@ import {
   loadConfig,
   getConfig,
   getConfigPath,
+  getGlobalEnvPath,
   clearConfigCache
 } from '../config-loader.js';
 
@@ -32,6 +33,9 @@ describe('config-loader', () => {
     // 環境変数をバックアップ
     originalEnv = { ...process.env };
 
+    // HOMEディレクトリをテスト用に変更（グローバル設定の影響を排除）
+    process.env.HOME = testProjectRoot;
+
     // キャッシュをクリア（クリーンな状態から開始）
     clearConfigCache();
   });
@@ -250,5 +254,150 @@ describe('config-loader', () => {
       consoleWarnSpy.mockRestore();
     });
   });
+
+  describe('5層階層対応', () => {
+    describe('getGlobalEnvPath', () => {
+      it('~/.michi/.envのパスを返す', () => {
+        const envPath = getGlobalEnvPath();
+        expect(envPath).toBe(join(process.env.HOME as string, '.michi', '.env'));
+      });
+    });
+
+    describe('グローバル.envからの設定読み込み', () => {
+      it('グローバル.envからAtlassian設定を読み込む', () => {
+        clearConfigCache();
+
+        // ~/.michi/.env を作成
+        const globalEnvPath = join(testProjectRoot, '.michi', '.env');
+        writeFileSync(globalEnvPath, 'ATLASSIAN_URL=https://test.atlassian.net\n');
+
+        const config = loadConfig(testProjectRoot);
+
+        // グローバル.envの値が読み込まれることを確認
+        expect(config).toHaveProperty('atlassian');
+        // 注: 実装後に具体的なアサーションを追加
+      });
+
+      it('グローバル.envが存在しない場合でもエラーにならない', () => {
+        clearConfigCache();
+
+        // ~/.michi/.env を削除
+        const globalEnvPath = join(testProjectRoot, '.michi', '.env');
+        if (existsSync(globalEnvPath)) {
+          unlinkSync(globalEnvPath);
+        }
+
+        expect(() => {
+          loadConfig(testProjectRoot);
+        }).not.toThrow();
+      });
+    });
+
+    describe('project.jsonからの設定読み込み', () => {
+      it('project.jsonからプロジェクトメタデータを読み込む', () => {
+        clearConfigCache();
+
+        // .kiro/project.json を作成
+        const projectJsonPath = join(testProjectRoot, '.kiro', 'project.json');
+        mkdirSync(join(testProjectRoot, '.kiro'), { recursive: true });
+        writeFileSync(projectJsonPath, JSON.stringify({
+          projectId: 'test-project',
+          projectName: 'Test Project',
+          jiraProjectKey: 'TP'
+        }));
+
+        const config = loadConfig(testProjectRoot);
+
+        // project.jsonの値が読み込まれることを確認
+        expect(config).toHaveProperty('project');
+        // 注: 実装後に具体的なアサーションを追加
+      });
+
+      it('project.jsonが存在しない場合でもエラーにならない', () => {
+        clearConfigCache();
+
+        // .kiro/project.json を削除
+        const projectJsonPath = join(testProjectRoot, '.kiro', 'project.json');
+        if (existsSync(projectJsonPath)) {
+          unlinkSync(projectJsonPath);
+        }
+
+        expect(() => {
+          loadConfig(testProjectRoot);
+        }).not.toThrow();
+      });
+    });
+
+    describe('優先順位の検証', () => {
+      it('プロジェクト.envがグローバル.envより優先される', () => {
+        clearConfigCache();
+
+        // グローバル.env
+        const globalEnvPath = join(testProjectRoot, '.michi', '.env');
+        writeFileSync(globalEnvPath, 'CONFLUENCE_PRD_SPACE=GLOBAL\n');
+
+        // プロジェクト.env
+        const projectEnvPath = join(testProjectRoot, '.env');
+        writeFileSync(projectEnvPath, 'CONFLUENCE_PRD_SPACE=PROJECT\n');
+
+        const config = loadConfig(testProjectRoot);
+
+        // プロジェクト.envの値が優先されることを確認
+        expect(config.confluence?.spaces?.requirements).toBe('PROJECT');
+      });
+    });
+
+    describe('キャッシュ無効化', () => {
+      it('グローバル.envを変更するとキャッシュが無効化される', async () => {
+        clearConfigCache();
+
+        // 最初の設定
+        const globalEnvPath = join(testProjectRoot, '.michi', '.env');
+        writeFileSync(globalEnvPath, 'CONFLUENCE_PRD_SPACE=INITIAL\n');
+
+        const config1 = getConfig(testProjectRoot);
+
+        // ファイルシステムのmtime精度を考慮して少し待つ
+        await new Promise(resolve => setTimeout(resolve, 10));
+
+        // 設定を更新
+        writeFileSync(globalEnvPath, 'CONFLUENCE_PRD_SPACE=UPDATED\n');
+
+        const config2 = getConfig(testProjectRoot);
+
+        // 異なる値が返されることを確認（キャッシュが無効化された）
+        expect(config1.confluence?.spaces?.requirements).toBe('INITIAL');
+        expect(config2.confluence?.spaces?.requirements).toBe('UPDATED');
+      });
+
+      it('project.jsonを変更するとキャッシュが無効化される', async () => {
+        clearConfigCache();
+
+        // 最初の設定
+        const projectJsonPath = join(testProjectRoot, '.kiro', 'project.json');
+        mkdirSync(join(testProjectRoot, '.kiro'), { recursive: true });
+        writeFileSync(projectJsonPath, JSON.stringify({
+          projectId: 'initial-id',
+          projectName: 'Initial Name'
+        }));
+
+        const config1 = getConfig(testProjectRoot);
+
+        // ファイルシステムのmtime精度を考慮して少し待つ
+        await new Promise(resolve => setTimeout(resolve, 10));
+
+        // 設定を更新
+        writeFileSync(projectJsonPath, JSON.stringify({
+          projectId: 'updated-id',
+          projectName: 'Updated Name'
+        }));
+
+        const config2 = getConfig(testProjectRoot);
+
+        // 異なるオブジェクトが返されることを確認（キャッシュが無効化された）
+        expect(config1).not.toBe(config2);
+      });
+    });
+  });
 });
 

package/scripts/utils/__tests__/config-validator.test.ts

@@ -393,6 +393,8 @@ describe('config-validator', () => {
       writeFileSync(
         projectJsonPath,
         JSON.stringify({
+          projectId: 'test-project',
+          projectName: 'Test Project',
           jiraProjectKey: 'TEST',
         }),
       );

package/scripts/utils/__tests__/env-config.test.ts

@@ -185,7 +185,6 @@ URL_WITH_PARAMS=https://example.com?param1=value1&param2=value2
         ['ATLASSIAN_API_TOKEN', 'token123'],
         ['GITHUB_ORG', 'myorg'],
         ['GITHUB_TOKEN', 'ghp_xxx'],
-        ['GITHUB_REPO', 'myorg/myrepo'],
         ['CONFLUENCE_PRD_SPACE', 'PRD'],
         ['CONFLUENCE_QA_SPACE', 'QA'],
         ['CONFLUENCE_RELEASE_SPACE', 'RELEASE'],
@@ -217,7 +216,6 @@ ATLASSIAN_API_TOKEN=test_token_123
 # GitHub設定
 GITHUB_ORG=testorg
 GITHUB_TOKEN=ghp_test123
-GITHUB_REPO=testorg/testrepo
 
 # Confluence共有スペース
 CONFLUENCE_PRD_SPACE=PRD