@sk8metal/michi-cli 0.0.7 → 0.0.9

package/scripts/create-project.ts

@@ -2,6 +2,10 @@
 /**
  * 新規プロジェクト自動セットアップスクリプト
  * 
+ * Issue #35: cc-sdd準拠の多環境対応基盤
+ * - templates/ディレクトリから読み込み
+ * - プレースホルダーはそのまま（実行時にAIが解釈）
+ * 
  * 使い方:
  * npm run create-project -- \
  *   --name "20240115-payment-api" \
@@ -11,9 +15,10 @@
 
 import { execSync } from 'child_process';
 import { writeFileSync, mkdirSync, cpSync, existsSync } from 'fs';
-import { resolve, join, dirname } from 'path';
+import { resolve, join, dirname, basename } from 'path';
 import { fileURLToPath } from 'url';
 import { config as loadDotenv } from 'dotenv';
+import { findTemplateFile, validateRequiredTemplates } from './utils/template-finder.js';
 
 // ESモジュール対応: __dirnameの代替
 const __filename = fileURLToPath(import.meta.url);
@@ -67,6 +72,25 @@ function parseArgs(): ProjectConfig {
   return config as ProjectConfig;
 }
 
+/**
+ * jj/git の依存性をチェックし、利用可能なVCSを返す
+ */
+function checkDependencies(): { vcs: 'jj' | 'git'; version: string } {
+  try {
+    const jjVersion = execSync('jj --version', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+    return { vcs: 'jj', version: jjVersion };
+  } catch {
+    try {
+      const gitVersion = execSync('git --version', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+      return { vcs: 'git', version: gitVersion };
+    } catch {
+      console.error('❌ Neither jj nor git is installed');
+      console.error('   Please install jj (https://github.com/martinvonz/jj) or git');
+      process.exit(1);
+    }
+  }
+}
+
 async function createProject(config: ProjectConfig): Promise<void> {
   const org = config.org || process.env.GITHUB_ORG;
   
@@ -79,10 +103,14 @@ async function createProject(config: ProjectConfig): Promise<void> {
   const repoName = config.name;
   const repoUrl = `https://github.com/${org}/${repoName}`;
   const projectDir = resolve(`../${repoName}`);
-  
+
+  // VCS依存性チェック
+  const deps = checkDependencies();
+
   console.log(`🚀 Creating new project: ${config.projectName}`);
   console.log(`   Repository: ${org}/${repoName}`);
   console.log(`   JIRA: ${config.jiraKey}`);
+  console.log(`   VCS: ${deps.vcs} (${deps.version})`);
   console.log('');
   
   // Step 1: GitHubリポジトリ作成
@@ -93,16 +121,20 @@ async function createProject(config: ProjectConfig): Promise<void> {
       { stdio: 'inherit' }
     );
     console.log('   ✅ Repository created');
-  } catch (error) {
+  } catch {
     console.log('   ⚠️  Repository may already exist');
   }
   
   // Step 2: リポジトリクローン
   console.log('\n📥 Step 2: Cloning repository...');
   try {
-    execSync(`jj git clone ${repoUrl} ${projectDir}`, { stdio: 'inherit' });
+    if (deps.vcs === 'jj') {
+      execSync(`jj git clone ${repoUrl} ${projectDir}`, { stdio: 'inherit' });
+    } else {
+      execSync(`git clone ${repoUrl} ${projectDir}`, { stdio: 'inherit' });
+    }
     console.log('   ✅ Repository cloned');
-  } catch (error) {
+  } catch {
     console.log('   ⚠️  Clone failed, checking if directory exists...');
   }
   
@@ -113,175 +145,236 @@ async function createProject(config: ProjectConfig): Promise<void> {
     process.exit(1);
   }
   
-  process.chdir(projectDir);
-  console.log(`   📂 Working directory: ${projectDir}`);
-  
-  // Step 4: cc-sdd導入
-  console.log('\n⚙️  Step 4: Installing cc-sdd...');
-  execSync('npx cc-sdd@latest --cursor --lang ja --yes', { stdio: 'inherit' });
-  console.log('   ✅ cc-sdd installed');
+  // 元の作業ディレクトリを保存
+  const originalCwd = process.cwd();
   
-  // Step 5: .kiro/project.json 作成
-  console.log('\n📝 Step 5: Creating project metadata...');
-  mkdirSync('.kiro', { recursive: true });
-  
-  // ラベル生成（安全なフォールバック付き）
-  const labels = config.labels || (() => {
-    // プロジェクトIDからプロジェクトラベル生成
-    const projectLabel = repoName.toLowerCase().replace(/[^a-z0-9-]/g, '');
-    const labelSet = new Set([`project:${projectLabel}`]);
-    
-    // ハイフンが存在する場合のみサービスラベルを生成
-    if (repoName.includes('-')) {
-      const parts = repoName.split('-');
-      const servicePart = parts[parts.length - 1];
-      const serviceLabel = servicePart.toLowerCase().replace(/[^a-z0-9-]/g, '');
+  try {
+    process.chdir(projectDir);
+    console.log(`   📂 Working directory: ${projectDir}`);
+
+    // Step 4: projects/ディレクトリとプロジェクトディレクトリを作成
+    console.log('\n📁 Step 4: Creating project directory structure...');
+    const projectsDir = join(projectDir, 'projects');
+    const actualProjectDir = join(projectsDir, repoName);
+    mkdirSync(actualProjectDir, { recursive: true });
+    console.log(`   ✅ Project directory created: ${actualProjectDir}`);
+
+    // Step 5: プロジェクトディレクトリに移動
+    process.chdir(actualProjectDir);
+    console.log(`   📂 Working directory: ${actualProjectDir}`);
+
+    // Step 6: cc-sdd導入
+    console.log('\n⚙️  Step 6: Installing cc-sdd...');
+    execSync('npx cc-sdd@latest --cursor --lang ja --yes', { stdio: 'inherit' });
+    console.log('   ✅ cc-sdd installed');
+
+    // Step 7: .kiro/project.json 作成
+    console.log('\n📝 Step 7: Creating project metadata...');
+    mkdirSync('.kiro', { recursive: true });
     
-      // サービスラベルがプロジェクトラベルと異なる場合のみ追加
-      if (serviceLabel !== projectLabel) {
-        labelSet.add(`service:${serviceLabel}`);
+    // ラベル生成（安全なフォールバック付き）
+    const labels = config.labels || (() => {
+      // プロジェクトIDからプロジェクトラベル生成
+      const projectLabel = repoName.toLowerCase().replace(/[^a-z0-9-]/g, '');
+      const labelSet = new Set([`project:${projectLabel}`]);
+      
+      // ハイフンが存在する場合のみサービスラベルを生成
+      if (repoName.includes('-')) {
+        const parts = repoName.split('-');
+        const servicePart = parts[parts.length - 1];
+        const serviceLabel = servicePart.toLowerCase().replace(/[^a-z0-9-]/g, '');
+        
+        // サービスラベルがプロジェクトラベルと異なる場合のみ追加
+        if (serviceLabel !== projectLabel) {
+          labelSet.add(`service:${serviceLabel}`);
+        }
       }
-    }
+      
+      return Array.from(labelSet);
+    })();
     
-    return Array.from(labelSet);
-  })();
-  
-  const projectJson = {
-    projectId: repoName,
-    projectName: config.projectName,
-    jiraProjectKey: config.jiraKey,
-    confluenceLabels: labels,
-    status: 'active',
-    team: [],
-    stakeholders: ['@企画', '@部長'],
-    repository: repoUrl,
-    description: `${config.projectName}の開発`
-  };
-  
-  writeFileSync('.kiro/project.json', JSON.stringify(projectJson, null, 2));
-  console.log('   ✅ project.json created');
-  
-  // Step 6: Michiから共通ファイルをコピー
-  console.log('\n📋 Step 6: Copying common files from Michi...');
-  const michiPath = resolve(__dirname, '..');
-  
-  // コピー先ディレクトリを事前に作成
-  mkdirSync('.cursor/rules', { recursive: true });
-  mkdirSync('.cursor/commands/kiro', { recursive: true });
-  mkdirSync('.kiro/steering', { recursive: true });
-  mkdirSync('.kiro/settings/templates', { recursive: true });
-  mkdirSync('scripts/utils', { recursive: true });
-  
-  // ルールファイル
-  const rulesToCopy = [
-    'multi-project.mdc',
-    'github-ssot.mdc',
-    'atlassian-mcp.mdc'
-  ];
-  
-  for (const rule of rulesToCopy) {
-    const src = join(michiPath, '.cursor/rules', rule);
-    const dest = join(projectDir, '.cursor/rules', rule);
-    if (existsSync(src)) {
-      cpSync(src, dest);
-      console.log(`   ✅ Copied: .cursor/rules/${rule}`);
+    const projectJson = {
+      projectId: repoName,
+      projectName: config.projectName,
+      jiraProjectKey: config.jiraKey,
+      confluenceLabels: labels,
+      status: 'active',
+      team: [],
+      stakeholders: ['@企画', '@部長'],
+      repository: repoUrl,
+      description: `${config.projectName}の開発`
+    };
+    
+    writeFileSync('.kiro/project.json', JSON.stringify(projectJson, null, 2));
+    console.log('   ✅ project.json created');
+
+    // Step 8: Michiから共通ファイルをコピー（templates/から）
+    console.log('\n📋 Step 8: Copying common files from Michi templates...');
+    console.log('   ℹ️  Issue #35: cc-sdd compliant approach (placeholders preserved)');
+    const michiPath = resolve(__dirname, '..');
+    
+    // 必須テンプレートのバリデーション
+    const requiredTemplates = [
+      'rules/github-ssot.mdc',
+      'rules/multi-project.mdc',
+      'commands/michi/confluence-sync.md',
+      'commands/michi/project-switch.md'
+    ];
+    
+    try {
+      validateRequiredTemplates(michiPath, requiredTemplates);
+    } catch (error) {
+      console.error('\n❌ Template validation failed:');
+      console.error(`   ${error instanceof Error ? error.message : String(error)}`);
+      process.exit(1);
     }
-  }
-  
-  // カスタムコマンド
-  const commandsToCopy = [
-    'confluence-sync.md',
-    'project-switch.md'
-  ];
-  
-  for (const cmd of commandsToCopy) {
-    const src = join(michiPath, '.cursor/commands/kiro', cmd);
-    const dest = join(projectDir, '.cursor/commands/kiro', cmd);
-    if (existsSync(src)) {
-      cpSync(src, dest);
-      console.log(`   ✅ Copied: .cursor/commands/kiro/${cmd}`);
+    
+    // コピー先ディレクトリを事前に作成（actualProjectDir 配下に作成）
+    console.log(`   📂 Copying to: ${actualProjectDir}`);
+    mkdirSync(join(actualProjectDir, '.cursor/rules'), { recursive: true });
+    mkdirSync(join(actualProjectDir, '.cursor/commands/michi'), { recursive: true });
+    mkdirSync(join(actualProjectDir, '.kiro/steering'), { recursive: true });
+    mkdirSync(join(actualProjectDir, '.kiro/settings/templates'), { recursive: true });
+    mkdirSync(join(actualProjectDir, 'scripts/utils'), { recursive: true });
+    
+    // ルールファイル（templates/から）
+    const rulesToCopy = [
+      'rules/multi-project.mdc',
+      'rules/github-ssot.mdc',
+      'rules/atlassian-mcp.mdc'
+    ];
+    
+    for (const rulePath of rulesToCopy) {
+      const src = findTemplateFile(michiPath, rulePath);
+      const fileName = basename(rulePath);
+      const dest = join(actualProjectDir, '.cursor/rules', fileName);
+      
+      if (src) {
+        cpSync(src, dest);
+        console.log(`   ✅ Copied: .cursor/rules/${fileName} (from templates/)`);
+      } else {
+        console.log(`   ⚠️  ${fileName} not found in templates/`);
+      }
     }
-  }
-  
-  // Steering
-  const steeringDir = join(michiPath, '.kiro/steering');
-  if (existsSync(steeringDir)) {
-    mkdirSync('.kiro/steering', { recursive: true });
-    cpSync(steeringDir, '.kiro/steering', { recursive: true });
-    console.log('   ✅ Copied: .kiro/steering/');
-  }
-  
-  // Scripts（必要なスクリプトのみコピー）
-  const scriptsDir = join(michiPath, 'scripts');
-  if (existsSync(scriptsDir)) {
-    const scriptsToCopy = [
-      'confluence-sync.ts',
-      'jira-sync.ts',
-      'pr-automation.ts',
-      'markdown-to-confluence.ts',
-      'workflow-orchestrator.ts',
-      'list-projects.ts',
-      'resource-dashboard.ts',
-      'multi-project-estimate.ts',
-      'utils/project-meta.ts'
+    
+    // カスタムコマンド（templates/から）
+    const commandsToCopy = [
+      'commands/michi/confluence-sync.md',
+      'commands/michi/project-switch.md'
     ];
     
-    for (const script of scriptsToCopy) {
-      const src = join(scriptsDir, script);
-      const dest = join(projectDir, 'scripts', script);
-      if (existsSync(src)) {
-        // ディレクトリが必要な場合は作成
-        const destDir = dirname(dest);
-        mkdirSync(destDir, { recursive: true });
+    for (const cmdPath of commandsToCopy) {
+      const src = findTemplateFile(michiPath, cmdPath);
+      const fileName = basename(cmdPath);
+      const dest = join(actualProjectDir, '.cursor/commands/michi', fileName);
+      
+      if (src) {
         cpSync(src, dest);
-        console.log(`   ✅ Copied: scripts/${script}`);
+        console.log(`   ✅ Copied: .cursor/commands/michi/${fileName} (from templates/)`);
+      } else {
+        console.log(`   ⚠️  ${fileName} not found in templates/`);
       }
     }
-  }
-  
-  // package.json, tsconfig.json
-  ['package.json', 'tsconfig.json'].forEach(file => {
-    const src = join(michiPath, file);
-    if (existsSync(src)) {
-      cpSync(src, file);
-      console.log(`   ✅ Copied: ${file}`);
+    
+    // Steering
+    const steeringDir = join(michiPath, '.kiro/steering');
+    if (existsSync(steeringDir)) {
+      const destSteeringDir = join(actualProjectDir, '.kiro/steering');
+      mkdirSync(destSteeringDir, { recursive: true });
+      cpSync(steeringDir, destSteeringDir, { recursive: true });
+      console.log('   ✅ Copied: .kiro/steering/');
     }
-  });
-  
-  // Step 7: .env テンプレート作成
-  console.log('\n🔐 Step 7: Creating .env template...');
-  execSync('npm run setup:env', { stdio: 'inherit' });
-  console.log('   ✅ .env created');
-  
-  // Step 8: npm install
-  console.log('\n📦 Step 8: Installing dependencies...');
-  execSync('npm install', { stdio: 'inherit' });
-  console.log('   ✅ Dependencies installed');
-  
-  // Step 9: 初期コミット
-  console.log('\n💾 Step 9: Creating initial commit...');
-  execSync(`jj commit -m "chore: プロジェクト初期化
+    
+    // Scripts（必要なスクリプトのみコピー）
+    const scriptsDir = join(michiPath, 'scripts');
+    if (existsSync(scriptsDir)) {
+      const scriptsToCopy = [
+        'confluence-sync.ts',
+        'jira-sync.ts',
+        'pr-automation.ts',
+        'markdown-to-confluence.ts',
+        'workflow-orchestrator.ts',
+        'list-projects.ts',
+        'resource-dashboard.ts',
+        'multi-project-estimate.ts',
+        'utils/project-meta.ts'
+      ];
+      
+      for (const script of scriptsToCopy) {
+        const src = join(scriptsDir, script);
+        const dest = join(actualProjectDir, 'scripts', script);
+        if (existsSync(src)) {
+          // ディレクトリが必要な場合は作成
+          const destDir = dirname(dest);
+          mkdirSync(destDir, { recursive: true });
+          cpSync(src, dest);
+          console.log(`   ✅ Copied: scripts/${script}`);
+        }
+      }
+    }
+    
+    // package.json, tsconfig.jsonをリポジトリルートにコピー
+    ['package.json', 'tsconfig.json'].forEach(file => {
+      const src = join(michiPath, file);
+      const dest = join(projectDir, file); // リポジトリルートにコピー
+      if (existsSync(src)) {
+        cpSync(src, dest);
+        console.log(`   ✅ Copied: ${file} (to repository root)`);
+      }
+    });
+
+    // Step 9: npm install（リポジトリルートで実行）
+    // 注意: setup:env は bash スクリプトなので依存関係不要だが、
+    // 将来的に setup:env が tsx やローカルスクリプトに依存する場合は
+    // npm install を先に実行する必要があるため、順序を入れ替え
+    console.log('\n📦 Step 9: Installing dependencies...');
+    process.chdir(projectDir);
+    execSync('npm install', { stdio: 'inherit' });
+    console.log('   ✅ Dependencies installed');
+
+    // Step 10: .env テンプレート作成（プロジェクトディレクトリで実行）
+    console.log('\n🔐 Step 10: Creating .env template...');
+    // package.jsonはprojectDirにあるため、そこで実行
+    execSync('npm run setup:env', { cwd: actualProjectDir, stdio: 'inherit' });
+    console.log('   ✅ .env created');
+
+    // Step 11: 初期コミット
+    console.log('\n💾 Step 11: Creating initial commit...');
+
+    const commitMessage = `chore: プロジェクト初期化
 
 - cc-sdd導入
 - プロジェクトメタデータ設定（${config.jiraKey}）
 - 自動化スクリプト追加
-- Confluence/JIRA連携設定"`, { stdio: 'inherit' });
-  
-  execSync('jj bookmark create main -r "@-"', { stdio: 'inherit' });
-  console.log('   ✅ Initial commit created');
-  
-  // 完了メッセージ
-  console.log('\n');
-  console.log('🎉 プロジェクトセットアップ完了！');
-  console.log('');
-  console.log('次のステップ:');
-  console.log(`  1. cd ${projectDir}`);
-  console.log('  2. .env ファイルを編集して認証情報を設定');
-  console.log('  3. jj git push --bookmark main --allow-new');
-  console.log('  4. Cursor で開く: cursor .');
-  console.log('  5. /kiro:spec-init <機能説明> で開発開始');
-  console.log('');
-  console.log('詳細: docs/new-project-setup.md');
+- Confluence/JIRA連携設定`;
+
+    if (deps.vcs === 'jj') {
+      execSync(`jj commit -m "${commitMessage}"`, { stdio: 'inherit' });
+      execSync('jj bookmark create main -r "@-"', { stdio: 'inherit' });
+    } else {
+      execSync('git add .', { stdio: 'inherit' });
+      execSync(`git commit -m "${commitMessage}"`, { stdio: 'inherit' });
+      execSync('git branch -M main', { stdio: 'inherit' });
+    }
+    console.log('   ✅ Initial commit created');
+    
+    // 完了メッセージ
+    console.log('\n');
+    console.log('🎉 プロジェクトセットアップ完了！');
+    console.log('');
+    console.log('次のステップ:');
+    console.log(`  1. cd ${actualProjectDir}`);
+    console.log('  2. .env ファイルを編集して認証情報を設定');
+    console.log('  3. jj git push --bookmark main --allow-new');
+    console.log('  4. Cursor で開く: cursor .');
+    console.log('  5. /kiro:spec-init <機能説明> で開発開始');
+    console.log('');
+    console.log('詳細: docs/getting-started/new-repository-setup.md');
+    
+  } finally {
+    // 元の作業ディレクトリに戻る
+    process.chdir(originalCwd);
+  }
 }
 
 // 実行

package/scripts/jira-sync.ts

@@ -25,6 +25,7 @@ import { loadProjectMeta } from './utils/project-meta.js';
 import { validateFeatureNameOrThrow } from './utils/feature-name-validator.js';
 import { getConfig, getConfigPath } from './utils/config-loader.js';
 import { validateForJiraSync } from './utils/config-validator.js';
+import { updateSpecJsonAfterJiraSync } from './utils/spec-updater.js';
 
 config();
 
@@ -617,10 +618,24 @@ async function syncTasksToJIRA(featureName: string): Promise<void> {
   // 新規作成数と再利用数を正確に計算
   const newStoryCount = createdStories.filter(key => !existingStoryKeys.has(key)).length;
   const reusedStoryCount = createdStories.filter(key => existingStoryKeys.has(key)).length;
-  
+
   console.log('\n✅ JIRA sync completed');
   console.log(`   Epic: ${epic.key}`);
   console.log(`   Stories: ${createdStories.length} processed (${newStoryCount} new, ${reusedStoryCount} reused)`);
+
+  // spec.json を更新
+  const jiraBaseUrl = process.env.ATLASSIAN_URL || '';
+  try {
+    updateSpecJsonAfterJiraSync(featureName, {
+      projectKey: projectMeta.jiraProjectKey,
+      epicKey: epic.key,
+      epicUrl: `${jiraBaseUrl}/browse/${epic.key}`,
+      storyKeys: createdStories
+    });
+  } catch (error) {
+    console.warn(`⚠️  Failed to update spec.json after JIRA sync: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    // spec.json更新の失敗はスクリプト全体の失敗とはしない（JIRA同期は成功しているため）
+  }
 }
 
 // CLI実行

package/scripts/list-projects.ts

@@ -5,7 +5,6 @@
 
 import { Octokit } from '@octokit/rest';
 import { config } from 'dotenv';
-import axios from 'axios';
 
 config();
 
@@ -20,42 +19,70 @@ interface ProjectInfo {
 async function listProjects(): Promise<void> {
   const token = process.env.GITHUB_TOKEN;
   const org = process.env.GITHUB_ORG;
-  
+
   if (!token || !org) {
     throw new Error('Missing GitHub credentials');
   }
-  
+
   const octokit = new Octokit({ auth: token });
-  
+
   console.log(`Fetching projects for organization: ${org}`);
-  
-  const { data: repos } = await octokit.repos.listForOrg({ org });
-  
+
+  // ページネーション対応：全リポジトリを取得
+  const repos = await octokit.paginate(octokit.repos.listForOrg, {
+    org,
+    per_page: 100
+  });
+
+  console.log(`Found ${repos.length} repositories`);
+
   const projects: ProjectInfo[] = [];
-  
+
   for (const repo of repos) {
     try {
-      // .kiro/project.json を取得
-      const { data } = await octokit.repos.getContent({
+      // ページネーション対応：projects/ディレクトリの全コンテンツを取得
+      const projectsDir = await octokit.paginate('GET /repos/{owner}/{repo}/contents/{path}', {
         owner: org,
         repo: repo.name,
-        path: '.kiro/project.json'
+        path: 'projects',
+        per_page: 100
       });
-      
-      if ('content' in data) {
-        const content = Buffer.from(data.content, 'base64').toString('utf-8');
-        const projectMeta = JSON.parse(content);
-        
-        projects.push({
-          name: projectMeta.projectName,
-          projectId: projectMeta.projectId,
-          status: projectMeta.status,
-          jiraKey: projectMeta.jiraProjectKey,
-          team: projectMeta.team
-        });
+
+      if (Array.isArray(projectsDir)) {
+        // projects/配下の各プロジェクトディレクトリを処理
+        for (const projectEntry of projectsDir) {
+          if (typeof projectEntry === 'object' && projectEntry !== null && 'type' in projectEntry && projectEntry.type === 'dir' && 'name' in projectEntry) {
+            try {
+              // projects/{project-id}/.kiro/project.json を取得
+              const { data } = await octokit.repos.getContent({
+                owner: org,
+                repo: repo.name,
+                path: `projects/${(projectEntry as any).name}/.kiro/project.json`
+              });
+
+              if ('content' in data) {
+                const content = Buffer.from(data.content, 'base64').toString('utf-8');
+                const projectMeta = JSON.parse(content);
+
+                projects.push({
+                  name: projectMeta.projectName,
+                  projectId: projectMeta.projectId,
+                  status: projectMeta.status,
+                  jiraKey: projectMeta.jiraProjectKey,
+                  team: projectMeta.team
+                });
+              }
+            } catch (error) {
+              // プロジェクトディレクトリに.kiro/project.jsonがない場合はスキップ
+              console.warn(`⚠️  Skipping project ${(projectEntry as any).name} in ${repo.name}:`, error instanceof Error ? error.message : 'Unknown error');
+              continue;
+            }
+          }
+        }
       }
     } catch (error) {
-      // .kiro/project.json が存在しない場合はスキップ
+      // projects/ディレクトリが存在しない、または API エラーの場合はスキップ
+      console.warn(`⚠️  Skipping ${repo.name}:`, error instanceof Error ? error.message : 'Unknown error');
       continue;
     }
   }