@sk8metal/michi-cli 0.0.7 → 0.0.9

package/scripts/utils/project-finder.ts

@@ -0,0 +1,184 @@
+/**
+ * プロジェクト検出ユーティリティ
+ * リポジトリルートを検出し、projects/配下のプロジェクトを検索
+ * 複数プロジェクトが存在する場合、選択機能を提供
+ */
+
+import { existsSync, readdirSync } from 'fs';
+import { resolve, join, dirname } from 'path';
+import { readFileSync } from 'fs';
+import type { ProjectMetadata } from './project-meta.js';
+
+export interface ProjectLocation {
+  path: string;
+  projectId: string;
+  projectName: string;
+  jiraProjectKey: string;
+}
+
+/**
+ * 指定されたディレクトリに.kiro/project.jsonが存在するか確認
+ */
+function hasProjectJson(dir: string): boolean {
+  const projectJsonPath = join(dir, '.kiro', 'project.json');
+  return existsSync(projectJsonPath);
+}
+
+/**
+ * プロジェクトメタデータを読み込む
+ */
+function loadProjectMetadata(dir: string): ProjectMetadata | null {
+  const projectJsonPath = join(dir, '.kiro', 'project.json');
+  
+  if (!existsSync(projectJsonPath)) {
+    return null;
+  }
+  
+  try {
+    const content = readFileSync(projectJsonPath, 'utf-8');
+    const meta = JSON.parse(content) as ProjectMetadata;
+    return meta;
+  } catch (error) {
+    // パースエラーなどは無視
+    return null;
+  }
+}
+
+/**
+ * 現在のディレクトリから親ディレクトリを遡って.kiro/project.jsonを検索
+ */
+export function findCurrentProject(startDir: string = process.cwd()): ProjectLocation | null {
+  let currentDir = resolve(startDir);
+  const root = resolve('/');
+  
+  while (currentDir !== root && currentDir !== dirname(currentDir)) {
+    if (hasProjectJson(currentDir)) {
+      const meta = loadProjectMetadata(currentDir);
+      if (meta) {
+        return {
+          path: currentDir,
+          projectId: meta.projectId,
+          projectName: meta.projectName,
+          jiraProjectKey: meta.jiraProjectKey
+        };
+      }
+    }
+    
+    const parentDir = dirname(currentDir);
+    if (parentDir === currentDir) {
+      break;
+    }
+    currentDir = parentDir;
+  }
+  
+  return null;
+}
+
+/**
+ * リポジトリルートを検出
+ * .gitディレクトリまたはprojects/ディレクトリの存在から判断
+ */
+export function findRepositoryRoot(startDir: string = process.cwd()): string {
+  let currentDir = resolve(startDir);
+  const root = resolve('/');
+  
+  while (currentDir !== root && currentDir !== dirname(currentDir)) {
+    // .gitディレクトリまたはprojects/ディレクトリが存在する場合、リポジトリルートと判断
+    if (existsSync(join(currentDir, '.git')) || existsSync(join(currentDir, 'projects'))) {
+      return currentDir;
+    }
+    
+    const parentDir = dirname(currentDir);
+    if (parentDir === currentDir) {
+      break;
+    }
+    currentDir = parentDir;
+  }
+  
+  // リポジトリルートが見つからない場合、現在のディレクトリを返す
+  return resolve(startDir);
+}
+
+/**
+ * リポジトリルートからprojects/配下の全プロジェクトを検索
+ * 統一されたディレクトリ構成: すべてのプロジェクトはprojects/{project-id}/配下に配置
+ */
+export function findAllProjects(
+  searchDir?: string
+): ProjectLocation[] {
+  const projects: ProjectLocation[] = [];
+  
+  // リポジトリルートを検出
+  const repoRoot = searchDir ? findRepositoryRoot(searchDir) : findRepositoryRoot();
+  const projectsDir = join(repoRoot, 'projects');
+  
+  // projects/ディレクトリが存在しない場合は空配列を返す
+  if (!existsSync(projectsDir)) {
+    return projects;
+  }
+  
+  try {
+    // projects/配下のディレクトリを取得
+    const entries = readdirSync(projectsDir, { withFileTypes: true });
+    
+    for (const entry of entries) {
+      // 隠しディレクトリはスキップ
+      if (entry.name.startsWith('.')) {
+        continue;
+      }
+      
+      if (entry.isDirectory()) {
+        const projectDir = join(projectsDir, entry.name);
+        // プロジェクトディレクトリに.kiro/project.jsonがあるか確認
+        if (hasProjectJson(projectDir)) {
+          const meta = loadProjectMetadata(projectDir);
+          if (meta) {
+            projects.push({
+              path: projectDir,
+              projectId: meta.projectId,
+              projectName: meta.projectName,
+              jiraProjectKey: meta.jiraProjectKey
+            });
+          }
+        }
+      }
+    }
+  } catch (error) {
+    // アクセス権限エラーなどは無視
+  }
+  
+  return projects;
+}
+
+/**
+ * 複数プロジェクトから選択する（対話的）
+ */
+export async function selectProject(
+  projects: ProjectLocation[],
+  question: (prompt: string) => Promise<string>
+): Promise<ProjectLocation | null> {
+  if (projects.length === 0) {
+    return null;
+  }
+  
+  if (projects.length === 1) {
+    return projects[0];
+  }
+  
+  console.log('\n📋 複数のプロジェクトが見つかりました:');
+  projects.forEach((project, index) => {
+    console.log(`  ${index + 1}. ${project.projectName} (${project.projectId}) - ${project.path}`);
+  });
+  
+  const answer = await question(`\n選択してください [1-${projects.length}]: `);
+  const index = parseInt(answer.trim(), 10) - 1;
+  
+  if (index >= 0 && index < projects.length) {
+    return projects[index];
+  }
+  
+  // 無効な入力の場合は最初のプロジェクトを返す
+  console.log('⚠️  無効な選択です。最初のプロジェクトを使用します。');
+  return projects[0];
+}
+

package/scripts/utils/spec-updater.ts

@@ -0,0 +1,212 @@
+/**
+ * spec.json 更新ユーティリティ
+ * Confluence/JIRA 同期後に spec.json を更新する
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { resolve, dirname } from 'path';
+
+/**
+ * spec.json の型定義
+ */
+export interface SpecJson {
+  featureName?: string;
+  projectName?: string;
+  confluence?: {
+    spaceKey?: string;
+    requirements?: {
+      pageId?: string;
+      url?: string;
+      title?: string;
+    };
+    design?: {
+      pageId?: string;
+      url?: string;
+      title?: string;
+    };
+    tasks?: {
+      pageId?: string;
+      url?: string;
+      title?: string;
+    };
+  };
+  jira?: {
+    projectKey?: string;
+    epicKey?: string;
+    epicUrl?: string;
+    storyKeys?: string[];
+  };
+  milestones?: {
+    requirementsCompleted?: boolean;
+    designCompleted?: boolean;
+    tasksCompleted?: boolean;
+    jiraSyncCompleted?: boolean;
+  };
+  lastUpdated?: string;
+}
+
+/**
+ * spec.json を読み込む
+ */
+export function loadSpecJson(featureName: string, projectRoot: string = process.cwd()): SpecJson {
+  const specPath = resolve(projectRoot, `.kiro/specs/${featureName}/spec.json`);
+
+  if (!existsSync(specPath)) {
+    // 新規作成する場合は最低限の構造を返す
+    return {
+      featureName,
+      confluence: {},
+      jira: {},
+      milestones: {},
+    };
+  }
+
+  try {
+    const content = readFileSync(specPath, 'utf-8');
+    return JSON.parse(content);
+  } catch (error) {
+    console.warn(`⚠️  Failed to load spec.json from ${specPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    return {
+      featureName,
+      confluence: {},
+      jira: {},
+      milestones: {},
+    };
+  }
+}
+
+/**
+ * spec.json を保存する
+ * @param featureName 機能名
+ * @param spec 保存する spec オブジェクト（lastUpdated フィールドが更新されます）
+ * @param projectRoot プロジェクトルート（デフォルト: process.cwd()）
+ */
+export function saveSpecJson(featureName: string, spec: SpecJson, projectRoot: string = process.cwd()): void {
+  const specDir = resolve(projectRoot, `.kiro/specs/${featureName}`);
+  const specPath = resolve(specDir, 'spec.json');
+
+  // ディレクトリが存在しない場合は作成
+  if (!existsSync(specDir)) {
+    mkdirSync(specDir, { recursive: true });
+  }
+
+  // lastUpdated を更新
+  spec.lastUpdated = new Date().toISOString();
+
+  try {
+    writeFileSync(specPath, JSON.stringify(spec, null, 2), 'utf-8');
+    console.log(`✅ Updated spec.json: ${specPath}`);
+  } catch (error) {
+    console.error(`❌ Failed to save spec.json to ${specPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    throw error;
+  }
+}
+
+/**
+ * Confluence 同期後に spec.json を更新
+ */
+export function updateSpecJsonAfterConfluenceSync(
+  featureName: string,
+  docType: 'requirements' | 'design' | 'tasks',
+  pageInfo: {
+    pageId: string;
+    url: string;
+    title: string;
+    spaceKey: string;
+  },
+  projectRoot: string = process.cwd()
+): void {
+  const spec = loadSpecJson(featureName, projectRoot);
+
+  // Confluence 情報を更新
+  if (!spec.confluence) {
+    spec.confluence = {};
+  }
+
+  // スペースキーを設定
+  if (pageInfo.spaceKey) {
+    spec.confluence.spaceKey = pageInfo.spaceKey;
+  }
+
+  // 新形式：ドキュメントタイプごとのページ情報を更新
+  spec.confluence[docType] = {
+    pageId: pageInfo.pageId,
+    url: pageInfo.url,
+    title: pageInfo.title,
+  };
+
+  // 旧形式（後方互換性のため併記）
+  if (docType === 'requirements') {
+    (spec.confluence as any).requirementsPageId = pageInfo.pageId;
+    (spec.confluence as any).requirementsUrl = pageInfo.url;
+  } else if (docType === 'design') {
+    (spec.confluence as any).designPageId = pageInfo.pageId;
+    (spec.confluence as any).designUrl = pageInfo.url;
+  } else if (docType === 'tasks') {
+    (spec.confluence as any).tasksPageId = pageInfo.pageId;
+    (spec.confluence as any).tasksUrl = pageInfo.url;
+  }
+
+  // マイルストーンを更新
+  if (!spec.milestones) {
+    spec.milestones = {};
+  }
+
+  // 新形式：フラットなフィールド
+  if (docType === 'requirements') {
+    spec.milestones.requirementsCompleted = true;
+    // 旧形式（後方互換性のため併記）
+    if (!(spec.milestones as any).requirements) {
+      (spec.milestones as any).requirements = {};
+    }
+    (spec.milestones as any).requirements.completed = true;
+  } else if (docType === 'design') {
+    spec.milestones.designCompleted = true;
+    // 旧形式（後方互換性のため併記）
+    if (!(spec.milestones as any).design) {
+      (spec.milestones as any).design = {};
+    }
+    (spec.milestones as any).design.completed = true;
+  } else if (docType === 'tasks') {
+    spec.milestones.tasksCompleted = true;
+    // 旧形式（後方互換性のため併記）
+    if (!(spec.milestones as any).tasks) {
+      (spec.milestones as any).tasks = {};
+    }
+    (spec.milestones as any).tasks.completed = true;
+  }
+
+  saveSpecJson(featureName, spec, projectRoot);
+}
+
+/**
+ * JIRA 同期後に spec.json を更新
+ */
+export function updateSpecJsonAfterJiraSync(
+  featureName: string,
+  jiraInfo: {
+    projectKey: string;
+    epicKey: string;
+    epicUrl: string;
+    storyKeys: string[];
+  },
+  projectRoot: string = process.cwd()
+): void {
+  const spec = loadSpecJson(featureName, projectRoot);
+
+  // JIRA 情報を更新
+  spec.jira = {
+    projectKey: jiraInfo.projectKey,
+    epicKey: jiraInfo.epicKey,
+    epicUrl: jiraInfo.epicUrl,
+    storyKeys: jiraInfo.storyKeys,
+  };
+
+  // マイルストーンを更新
+  if (!spec.milestones) {
+    spec.milestones = {};
+  }
+  spec.milestones.jiraSyncCompleted = true;
+
+  saveSpecJson(featureName, spec, projectRoot);
+}

package/scripts/utils/template-finder.ts

@@ -0,0 +1,75 @@
+/**
+ * テンプレートファイル検索ユーティリティ
+ * 
+ * Issue #35: cc-sdd準拠のテンプレート検索
+ * Cursor/Claude両環境のテンプレートを優先順位付きで検索
+ */
+
+import { existsSync } from 'fs';
+import { join } from 'path';
+
+/**
+ * templates/ディレクトリからファイルを検索
+ * 
+ * @param michiPath - Michiリポジトリのルートパス
+ * @param relativePath - templates/配下の相対パス（例: 'rules/github-ssot.mdc'）
+ * @returns 見つかったファイルの絶対パス、見つからない場合はnull
+ * 
+ * @example
+ * ```typescript
+ * const path = findTemplateFile('/path/to/michi', 'rules/github-ssot.mdc');
+ * // returns: '/path/to/michi/templates/cursor/rules/github-ssot.mdc'
+ * ```
+ */
+export function findTemplateFile(michiPath: string, relativePath: string): string | null {
+  // 優先順位1: templates/cursor/
+  const cursorPath = join(michiPath, 'templates/cursor', relativePath);
+  if (existsSync(cursorPath)) {
+    return cursorPath;
+  }
+  
+  // 優先順位2: templates/claude/
+  const claudePath = join(michiPath, 'templates/claude', relativePath);
+  if (existsSync(claudePath)) {
+    return claudePath;
+  }
+  
+  return null;
+}
+
+/**
+ * 必須テンプレートファイルのバリデーション
+ * 
+ * @param michiPath - Michiリポジトリのルートパス
+ * @param requiredFiles - 必須ファイルのリスト
+ * @throws Error - 必須ファイルが見つからない場合
+ * 
+ * @example
+ * ```typescript
+ * validateRequiredTemplates('/path/to/michi', [
+ *   'rules/github-ssot.mdc',
+ *   'commands/michi/confluence-sync.md'
+ * ]);
+ * ```
+ */
+export function validateRequiredTemplates(
+  michiPath: string,
+  requiredFiles: string[]
+): void {
+  const missingFiles: string[] = [];
+  
+  for (const file of requiredFiles) {
+    const path = findTemplateFile(michiPath, file);
+    if (!path) {
+      missingFiles.push(file);
+    }
+  }
+  
+  if (missingFiles.length > 0) {
+    throw new Error(
+      `Missing required template files:\n  - ${missingFiles.join('\n  - ')}\n\n` +
+      `Please check that Michi templates are properly installed at: ${michiPath}/templates/`
+    );
+  }
+}
+

package/templates/claude/commands/michi/confluence-sync.md

@@ -0,0 +1,38 @@
+---
+name: /michi:confluence-sync
+description: Sync specifications to Confluence
+---
+
+# Confluence Sync Command
+
+**Important**: Generate output in language specified in {{KIRO_DIR}}/project.json.
+
+## Usage
+
+```
+/michi:confluence-sync <feature_name>
+```
+
+**Parameters**:
+- `feature_name`: Feature name (e.g., user-auth, payment-api)
+
+## Execution Steps
+
+1. Read specifications from {{KIRO_DIR}}/specs/{{FEATURE_NAME}}/
+2. Load project metadata from {{KIRO_DIR}}/project.json
+3. Sync requirements.md to Confluence
+4. Sync design.md to Confluence
+5. Create/update Confluence pages with proper labels
+6. Link pages to JIRA Epic (if exists)
+
+## Language Handling
+
+- Read language from {{KIRO_DIR}}/project.json
+- Generate all output in the specified language
+- Use Confluence labels from project.json for page organization
+
+## Project Metadata
+
+- Project ID: {{PROJECT_ID}}
+- Kiro directory: {{KIRO_DIR}}
+- Agent directory: {{AGENT_DIR}}

package/templates/claude/commands/michi/project-switch.md

@@ -0,0 +1,36 @@
+---
+name: /michi:project-switch
+description: Switch between projects
+---
+
+# Project Switch Command
+
+**Important**: Generate output in language specified in {{KIRO_DIR}}/project.json.
+
+## Usage
+
+```
+/michi:project-switch <project_id>
+```
+
+**Parameters**:
+- `project_id`: Project ID (e.g., customer-a-service-1, michi)
+
+**Examples**:
+```
+/michi:project-switch michi
+/michi:project-switch customer-a-service-1
+```
+
+## Execution Steps
+
+1. Identify GitHub repository corresponding to project ID
+2. Clone locally (if not cloned) or checkout
+3. Load and display {{KIRO_DIR}}/project.json
+4. Display corresponding Confluence project page URL
+
+## Language Handling
+
+- Read language from {{KIRO_DIR}}/project.json
+- Generate all output in the specified language
+- Default to English if language field is missing

package/templates/claude/rules/atlassian-integration.md

@@ -0,0 +1,35 @@
+---
+title: Atlassian Integration
+description: Integration rules for Confluence and JIRA via MCP
+---
+
+# Atlassian Integration
+
+## Development Guidelines
+{{DEV_GUIDELINES}}
+
+## Language
+All generated documents should be in: **{{LANG_CODE}}**
+
+## MCP Integration
+
+### Confluence Sync
+- Sync specifications from {{KIRO_DIR}}/specs/ to Confluence
+- Use MCP server for Confluence operations
+- Project labels: Check {{KIRO_DIR}}/project.json
+
+### JIRA Sync
+- Create Epic and Stories from {{KIRO_DIR}}/specs/{{FEATURE_NAME}}/tasks.md
+- Use JIRA project key: {{PROJECT_ID}}
+- Link Confluence pages automatically
+
+## Project Metadata
+- Project ID: {{PROJECT_ID}}
+- Kiro directory: {{KIRO_DIR}}
+- Agent directory: {{AGENT_DIR}}
+
+## Workflow
+1. Create spec in {{KIRO_DIR}}/specs/{{FEATURE_NAME}}/
+2. Sync to Confluence via MCP
+3. Create JIRA Epic/Stories
+4. Link Confluence pages to JIRA

package/templates/claude/rules/michi-core.md

@@ -0,0 +1,54 @@
+---
+title: Michi Core Principles
+description: Core principles for GitHub SSoT and multi-project management
+---
+
+# Michi Core Principles
+
+## Development Guidelines
+{{DEV_GUIDELINES}}
+
+## Language
+All generated documents should be in: **{{LANG_CODE}}**
+
+Reference the language field in {{KIRO_DIR}}/project.json.
+
+## Single Source of Truth (SSoT)
+
+### GitHub as SSoT
+- **All specifications are managed in GitHub** ({{KIRO_DIR}}/specs/)
+- Confluence is **reference and approval only** (editing is GitHub only)
+- Avoid duplicate management
+
+### Data Flow
+```
+GitHub ({{KIRO_DIR}}/specs/)  ← Source of truth (editable)
+    ↓ sync
+Confluence ← Display and approval (read-only)
+```
+
+## Multi-Project Management
+
+### Project Identification
+- All operations reference {{KIRO_DIR}}/project.json
+- Dynamically use project ID, JIRA key, Confluence labels
+- Project ID: {{PROJECT_ID}}
+
+### Naming Conventions
+
+#### Confluence Pages
+- Format: `[{projectName}] {document_type}`
+- Example: `[{{PROJECT_ID}}] Requirements`
+
+#### JIRA Epic/Story
+- Format: `[{JIRA_KEY}] {title}`
+- Use project metadata from {{KIRO_DIR}}/project.json
+
+## Agent Directory
+- Agent configuration: {{AGENT_DIR}}
+- Rules location: {{AGENT_DIR}}/rules/
+- Commands location: {{AGENT_DIR}}/commands/
+
+## Feature Development
+- Feature name: {{FEATURE_NAME}}
+- Spec location: {{KIRO_DIR}}/specs/{{FEATURE_NAME}}/

package/templates/claude-agent/README.md

@@ -0,0 +1,25 @@
+# Claude Agent Templates
+
+This directory contains templates for Claude Agent configuration.
+
+## Structure
+
+```
+claude-agent/
+├── README.md
+└── (additional templates)
+```
+
+## Usage
+
+These templates are used when setting up Claude Agent for a project.
+Placeholders are replaced with project-specific values during setup.
+
+## Placeholders
+
+- {{LANG_CODE}}: Language code (ja, en, etc.)
+- {{DEV_GUIDELINES}}: Development guidelines
+- {{KIRO_DIR}}: Kiro directory (default: .kiro)
+- {{AGENT_DIR}}: Agent directory (default: .claude)
+- {{PROJECT_ID}}: Project ID
+- {{FEATURE_NAME}}: Feature name