@sk8metal/michi-cli 0.14.1 → 0.20.0

package/scripts/utils/interactive-helpers.ts

@@ -1,135 +1,27 @@
 /**
- * 対話的設定の共通ヘルパー関数
+ * Interactive Helpers - Entry Point
+ * The actual logic has been moved to src/presentation/interactive/
  */
 
-import * as readline from 'readline';
-
-/**
- * readlineインターフェースを作成
- */
-export function createInterface(): readline.Interface {
-  return readline.createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-}
-
-/**
- * 質問を表示して回答を取得
- */
-export function question(rl: readline.Interface, query: string): Promise<string> {
-  return new Promise((resolve) => {
-    rl.question(query, (answer) => {
-      resolve(answer.trim());
-    });
-  });
-}
-
-/**
- * 選択肢から選択
- */
-export async function select(
-  rl: readline.Interface,
-  prompt: string,
-  choices: Array<{ value: string; label: string; description?: string }>,
-  defaultValue?: string,
-  maxRetries: number = 3,
-): Promise<string> {
-  if (choices.length === 0) {
-    throw new Error('select: choices must contain at least one option');
-  }
-
-  console.log(`\n${prompt}`);
-  choices.forEach((choice, index) => {
-    const defaultMark = defaultValue === choice.value ? ' (デフォルト)' : '';
-    const desc = choice.description ? ` - ${choice.description}` : '';
-    console.log(`  ${index + 1}. ${choice.label}${desc}${defaultMark}`);
-  });
-
-  const answer = await question(
-    rl,
-    `\n選択してください [1-${choices.length}]: `,
-  );
-
-  if (!answer && defaultValue) {
-    return defaultValue;
-  }
-
-  const index = parseInt(answer, 10) - 1;
-  if (index >= 0 && index < choices.length) {
-    return choices[index].value;
-  }
-
-  if (defaultValue) {
-    return defaultValue;
-  }
-
-  // 無効な入力の場合は再試行（最大試行回数まで）
-  if (maxRetries > 0) {
-    console.log(
-      `⚠️  無効な選択です。もう一度入力してください（残り試行回数: ${maxRetries}）。`,
-    );
-    return select(rl, prompt, choices, defaultValue, maxRetries - 1);
-  }
-
-  // 最大試行回数に達した場合はデフォルト値または最初の選択肢を返す
-  // 注: choices.length > 0 は関数冒頭で保証されている
-  const fallbackValue = defaultValue || choices[0].value;
-  console.log(
-    `⚠️  最大試行回数に達しました。デフォルト値を使用します: ${fallbackValue}`,
-  );
-  return fallbackValue;
-}
-
-/**
- * Yes/No質問
- */
-export async function confirm(
-  rl: readline.Interface,
-  prompt: string,
-  defaultValue: boolean = true,
-): Promise<boolean> {
-  const defaultText = defaultValue ? '[Y/n]' : '[y/N]';
-  const answer = await question(rl, `${prompt} ${defaultText}: `);
-
-  if (!answer) {
-    return defaultValue;
-  }
-
-  return answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes';
-}
-
-/**
- * 複数選択
- */
-export async function multiSelect(
-  rl: readline.Interface,
-  prompt: string,
-  choices: Array<{ value: string; label: string }>,
-  defaults: string[] = [],
-): Promise<string[]> {
-  console.log(`\n${prompt}`);
-  choices.forEach((choice, index) => {
-    const checked = defaults.includes(choice.value) ? '[x]' : '[ ]';
-    console.log(`  ${checked} ${index + 1}. ${choice.label}`);
-  });
-
-  const answer = await question(
-    rl,
-    '\n選択してください（カンマ区切り、例: 1,2,3）: ',
-  );
-
-  if (!answer && defaults.length > 0) {
-    return defaults;
-  }
-
-  if (!answer) {
-    return [];
-  }
-
-  const indices = answer
-    .split(',')
-    .map((s) => parseInt(s.trim(), 10) - 1)
-    .filter((i) => i >= 0 && i < choices.length);
-  return indices.map((i) => choices[i].value);
-}
+export {
+  createInterface,
+  question,
+  password,
+  numberInput,
+  textInput,
+} from '../../src/presentation/interactive/prompts.js';
+
+export {
+  confirm,
+  confirmDangerous,
+  confirmMultiple,
+  confirmAll,
+} from '../../src/presentation/interactive/confirmation.js';
+
+export {
+  select,
+  multiSelect,
+  searchableSelect,
+  paginatedSelect,
+  type Choice,
+} from '../../src/presentation/interactive/selection.js';

package/scripts/utils/language-detector.ts

@@ -3,7 +3,8 @@
  * design.md、requirements.mdから実装言語を自動推論
  */
 
-import { readFileSync, existsSync } from 'fs';
+import { existsSync } from 'fs';
+import { safeReadFileOrThrow } from './safe-file-reader.js';
 import { join } from 'path';
 import { extractSection } from './markdown-parser.js';
 
@@ -30,7 +31,7 @@ export function analyzeLanguage(feature: string, projectRoot: string = process.c
   // design.mdを解析
   const designPath = join(projectRoot, '.kiro', 'specs', feature, 'design.md');
   if (existsSync(designPath)) {
-    const design = readFileSync(designPath, 'utf-8');
+    const design = safeReadFileOrThrow(designPath, 'utf-8');
     
     // Technology Stackセクションを確認
     const techStack = extractSection(design, 'Technology Stack');
@@ -94,7 +95,7 @@ export function analyzeLanguage(feature: string, projectRoot: string = process.c
   // requirements.mdを解析
   const requirementsPath = join(projectRoot, '.kiro', 'specs', feature, 'requirements.md');
   if (existsSync(requirementsPath)) {
-    const requirements = readFileSync(requirementsPath, 'utf-8');
+    const requirements = safeReadFileOrThrow(requirementsPath, 'utf-8');
     
     // APIやWebアプリケーションの言及
     if (requirements.match(/REST API|GraphQL API/i)) {

package/scripts/utils/markdown-parser.ts

@@ -1,376 +1,21 @@
 /**
- * Markdown解析ユーティリティ
- * requirements.mdとdesign.mdから構造化データを抽出
+ * Markdownパーサー
+ *
+ * このファイルは後方互換性のための再エクスポートです。
+ * 実装は src/infrastructure/parsers/markdown-parser.ts に移行されました。
  */
 
-export interface Component {
-  name: string;
-  domain: string;
-  intent: string;
-  requirements: string[];
-  methods: Method[];
-}
-
-export interface Method {
-  name: string;
-  signature: string;
-  parameters: Parameter[];
-  returnType: string;
-  description?: string;
-}
-
-export interface Parameter {
-  name: string;
-  type: string;
-}
-
-export interface Flow {
-  name: string;
-  type: 'sequence' | 'process' | 'data';
-  mermaidCode: string;
-  description?: string;
-}
-
-export interface Requirement {
-  id: string;
-  title: string;
-  objective: string;
-  acceptanceCriteria: string[];
-}
-
-/**
- * Markdownから特定の見出しセクションを抽出
- */
-export function extractSection(content: string, heading: string): string {
-  const lines = content.split('\n');
-  const headingRegex = new RegExp(`^#+\\s+${heading}`, 'i');
-  
-  let startIndex = -1;
-  let endIndex = lines.length;
-  let headingLevel = 0;
-  
-  // 開始位置を検索
-  for (let i = 0; i < lines.length; i++) {
-    if (headingRegex.test(lines[i])) {
-      startIndex = i;
-      const match = lines[i].match(/^(#+)/);
-      headingLevel = match ? match[1].length : 0;
-      break;
-    }
-  }
-  
-  if (startIndex === -1) {
-    return '';
-  }
-  
-  // 同じレベルまたは上位レベルの見出しまで抽出
-  for (let i = startIndex + 1; i < lines.length; i++) {
-    const match = lines[i].match(/^(#+)\s/);
-    if (match && match[1].length <= headingLevel) {
-      endIndex = i;
-      break;
-    }
-  }
-  
-  return lines.slice(startIndex, endIndex).join('\n');
-}
-
-/**
- * design.mdからコンポーネント情報を抽出
- */
-export function extractComponents(designMd: string): Component[] {
-  const components: Component[] = [];
-  const componentsSection = extractSection(designMd, 'Components and Interfaces');
-  
-  if (!componentsSection) {
-    return components;
-  }
-  
-  // コンポーネントサマリーテーブルを解析
-  const summaryTableMatch = componentsSection.match(/\|\s*Component\s*\|.*?\n\|[-\s|]+\n((?:\|.*?\n)+)/i);
-  if (summaryTableMatch) {
-    const rows = summaryTableMatch[1].trim().split('\n');
-    for (const row of rows) {
-      const cells = row.split('|').map(c => c.trim()).filter(c => c);
-      if (cells.length >= 3) {
-        components.push({
-          name: cells[0],
-          domain: cells[1] || '',
-          intent: cells[2] || '',
-          requirements: [],
-          methods: []
-        });
-      }
-    }
-  }
-  
-  // 各コンポーネントの詳細セクションからインターフェースを抽出
-  const lines = componentsSection.split('\n');
-  let currentComponent: Component | null = null;
-  
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    
-    // コンポーネント見出しを検索（#### Component Name）
-    const componentMatch = line.match(/^####\s+(.+)/);
-    if (componentMatch) {
-      const componentName = componentMatch[1].trim();
-      currentComponent = components.find(c => c.name === componentName) || null;
-      continue;
-    }
-    
-    // Service Interfaceセクションを検索
-    if (line.includes('##### Service Interface') && currentComponent) {
-      // TypeScriptコードブロックを抽出
-      let inCodeBlock = false;
-      let codeContent = '';
-      
-      for (let j = i + 1; j < lines.length; j++) {
-        if (lines[j].startsWith('```typescript') || lines[j].startsWith('```ts')) {
-          inCodeBlock = true;
-          continue;
-        }
-        if (lines[j].startsWith('```') && inCodeBlock) {
-          break;
-        }
-        if (inCodeBlock) {
-          codeContent += lines[j] + '\n';
-        }
-      }
-      
-      // インターフェースからメソッドを抽出
-      const methods = extractMethodsFromInterface(codeContent);
-      currentComponent.methods = methods;
-    }
-  }
-  
-  return components;
-}
-
-/**
- * TypeScriptインターフェースからメソッドを抽出
- */
-function extractMethodsFromInterface(interfaceCode: string): Method[] {
-  const methods: Method[] = [];
-  const lines = interfaceCode.split('\n');
-  
-  for (const line of lines) {
-    // メソッドシグネチャを検索（例: methodName(param: Type): ReturnType）
-    const methodMatch = line.match(/^\s*(\w+)\s*\(([^)]*)\)\s*:\s*(.+?)\s*;?\s*$/);
-    if (methodMatch) {
-      const methodName = methodMatch[1];
-      const paramsStr = methodMatch[2];
-      const returnType = methodMatch[3];
-      
-      // パラメータを解析
-      const parameters: Parameter[] = [];
-      if (paramsStr.trim()) {
-        const paramParts = paramsStr.split(',');
-        for (const part of paramParts) {
-          const paramMatch = part.trim().match(/(\w+)\??:\s*(.+)/);
-          if (paramMatch) {
-            parameters.push({
-              name: paramMatch[1],
-              type: paramMatch[2].trim()
-            });
-          }
-        }
-      }
-      
-      methods.push({
-        name: methodName,
-        signature: line.trim(),
-        parameters,
-        returnType: returnType.trim()
-      });
-    }
-  }
-  
-  return methods;
-}
-
-/**
- * design.mdからシステムフローを抽出
- */
-export function extractFlows(designMd: string): Flow[] {
-  const flows: Flow[] = [];
-  const flowsSection = extractSection(designMd, 'System Flows');
-  
-  if (!flowsSection) {
-    return flows;
-  }
-  
-  const lines = flowsSection.split('\n');
-  let currentFlowName = '';
-  let currentFlowType: 'sequence' | 'process' | 'data' = 'sequence';
-  
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    
-    // フロー見出しを検索（### Flow Name）
-    const flowMatch = line.match(/^###\s+(.+)/);
-    if (flowMatch) {
-      currentFlowName = flowMatch[1].trim();
-      continue;
-    }
-    
-    // Mermaidコードブロックを検索
-    if (line.startsWith('```mermaid') && currentFlowName) {
-      let mermaidCode = '';
-      
-      for (let j = i + 1; j < lines.length; j++) {
-        if (lines[j].startsWith('```')) {
-          break;
-        }
-        mermaidCode += lines[j] + '\n';
-      }
-      
-      // フロータイプを判定
-      if (mermaidCode.includes('sequenceDiagram')) {
-        currentFlowType = 'sequence';
-      } else if (mermaidCode.includes('graph') || mermaidCode.includes('flowchart')) {
-        currentFlowType = 'process';
-      }
-      
-      flows.push({
-        name: currentFlowName,
-        type: currentFlowType,
-        mermaidCode: mermaidCode.trim()
-      });
-      
-      currentFlowName = '';
-    }
-  }
-  
-  return flows;
-}
-
-/**
- * requirements.mdから要件を抽出
- */
-export function extractRequirements(requirementsMd: string): Requirement[] {
-  const requirements: Requirement[] = [];
-  const lines = requirementsMd.split('\n');
-  
-  let currentRequirement: Requirement | null = null;
-  let inAcceptanceCriteria = false;
-  
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    
-    // 要件見出しを検索（### Requirement N: Title）
-    const reqMatch = line.match(/^###\s+Requirement\s+(\d+):\s+(.+)/i);
-    if (reqMatch) {
-      // 前の要件を保存
-      if (currentRequirement) {
-        requirements.push(currentRequirement);
-      }
-      
-      currentRequirement = {
-        id: reqMatch[1],
-        title: reqMatch[2].trim(),
-        objective: '',
-        acceptanceCriteria: []
-      };
-      inAcceptanceCriteria = false;
-      continue;
-    }
-    
-    // NFR（非機能要件）も同様に抽出
-    const nfrMatch = line.match(/^###\s+(NFR-\d+):\s+(.+)/i);
-    if (nfrMatch) {
-      if (currentRequirement) {
-        requirements.push(currentRequirement);
-      }
-      
-      currentRequirement = {
-        id: nfrMatch[1],
-        title: nfrMatch[2].trim(),
-        objective: '',
-        acceptanceCriteria: []
-      };
-      inAcceptanceCriteria = false;
-      continue;
-    }
-    
-    // Objectiveを抽出
-    if (currentRequirement && line.includes('**Objective:**')) {
-      const objectiveMatch = line.match(/\*\*Objective:\*\*\s*(.+)/);
-      if (objectiveMatch) {
-        currentRequirement.objective = objectiveMatch[1].trim();
-      }
-      continue;
-    }
-    
-    // Acceptance Criteriaセクションの開始
-    if (currentRequirement && line.includes('#### Acceptance Criteria')) {
-      inAcceptanceCriteria = true;
-      continue;
-    }
-    
-    // Acceptance Criteriaを抽出
-    if (currentRequirement && inAcceptanceCriteria) {
-      const criteriaMatch = line.match(/^\d+\.\s+(.+)/);
-      if (criteriaMatch) {
-        currentRequirement.acceptanceCriteria.push(criteriaMatch[1].trim());
-      }
-      
-      // 次のセクションに到達したら終了
-      if (line.match(/^##[#]?\s+/)) {
-        inAcceptanceCriteria = false;
-      }
-    }
-  }
-  
-  // 最後の要件を保存
-  if (currentRequirement) {
-    requirements.push(currentRequirement);
-  }
-  
-  return requirements;
-}
-
-/**
- * design.mdからインターフェース定義を抽出
- */
-export function extractInterfaces(designMd: string): Record<string, string> {
-  const interfaces: Record<string, string> = {};
-  const lines = designMd.split('\n');
-  
-  let inCodeBlock = false;
-  let currentInterface = '';
-  let interfaceCode = '';
-  
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    
-    if (line.startsWith('```typescript') || line.startsWith('```ts')) {
-      inCodeBlock = true;
-      interfaceCode = '';
-      continue;
-    }
-    
-    if (line.startsWith('```') && inCodeBlock) {
-      inCodeBlock = false;
-      if (currentInterface && interfaceCode) {
-        interfaces[currentInterface] = interfaceCode.trim();
-      }
-      currentInterface = '';
-      interfaceCode = '';
-      continue;
-    }
-    
-    if (inCodeBlock) {
-      interfaceCode += line + '\n';
-      
-      // インターフェース名を抽出
-      const interfaceMatch = line.match(/interface\s+(\w+)/);
-      if (interfaceMatch && !currentInterface) {
-        currentInterface = interfaceMatch[1];
-      }
-    }
-  }
-  
-  return interfaces;
-}
-
+export type {
+  Requirement,
+  Component,
+  Method,
+  Parameter,
+  Flow,
+} from '../../src/infrastructure/parsers/markdown-parser.js';
+
+export {
+  extractSection,
+  extractRequirements,
+  extractComponents,
+  extractFlows,
+} from '../../src/infrastructure/parsers/markdown-parser.js';

package/scripts/utils/multi-repo-validator.ts

@@ -9,20 +9,19 @@ import * as fs from 'fs';
 import * as path from 'path';
 import { execSync } from 'child_process';
 import type { Repository } from '../config/config-schema.js';
+import type { Result } from './types/validation.js';
+import { success, failure } from './types/validation.js';
 
 /**
- * バリデーション結果
+ * LocalPathバリデーション結果（詳細情報付き）
+ *
+ * Note: This is a specialized validation result type for local path validation.
+ * It includes additional metadata beyond the standard Result<T, E> pattern.
  */
-export interface ValidationResult {
+export interface LocalPathValidationResult {
   isValid: boolean;
   errors: string[];
   warnings: string[];
-}
-
-/**
- * LocalPathバリデーション結果（詳細情報付き）
- */
-export interface LocalPathValidationResult extends ValidationResult {
   exists: boolean;
   isGitRepository: boolean;
   currentBranch: string | null;
@@ -36,7 +35,7 @@ export interface LocalPathValidationResult extends ValidationResult {
  * プロジェクト名のバリデーション
  * セキュリティ対策: パストラバーサル、相対パス、制御文字をチェック
  */
-export function validateProjectName(name: string): ValidationResult {
+export function validateProjectName(name: string): Result<boolean, string> {
   const errors: string[] = [];
   const warnings: string[] = [];
 
@@ -66,18 +65,18 @@ export function validateProjectName(name: string): ValidationResult {
     errors.push('Project name must not contain control characters');
   }
 
-  return {
-    isValid: errors.length === 0,
-    errors,
-    warnings,
-  };
+  if (errors.length > 0) {
+    return failure(errors, warnings);
+  }
+
+  return success(true, warnings);
 }
 
 /**
  * JIRAキーのバリデーション
  * 2-10文字の大文字英字のみ許可
  */
-export function validateJiraKey(key: string): ValidationResult {
+export function validateJiraKey(key: string): Result<boolean, string> {
   const errors: string[] = [];
   const warnings: string[] = [];
 
@@ -88,25 +87,25 @@ export function validateJiraKey(key: string): ValidationResult {
     errors.push('JIRA key must be 2-10 uppercase letters');
   }
 
-  return {
-    isValid: errors.length === 0,
-    errors,
-    warnings,
-  };
+  if (errors.length > 0) {
+    return failure(errors, warnings);
+  }
+
+  return success(true, warnings);
 }
 
 /**
  * リポジトリURLのバリデーション
  * GitHub HTTPS URL形式のみ許可
  */
-export function validateRepositoryUrl(url: string): ValidationResult {
+export function validateRepositoryUrl(url: string): Result<boolean, string> {
   const errors: string[] = [];
   const warnings: string[] = [];
 
   // 空文字列チェック
   if (!url || url.trim() === '') {
     errors.push('Repository URL is empty');
-    return { isValid: false, errors, warnings };
+    return failure(errors, warnings);
   }
 
   // SSH URL検出（git@github.com:形式）
@@ -114,7 +113,7 @@ export function validateRepositoryUrl(url: string): ValidationResult {
     errors.push(
       'Repository URL must be in GitHub format: https://github.com/{owner}/{repo}',
     );
-    return { isValid: false, errors, warnings };
+    return failure(errors, warnings);
   }
 
   // URL形式チェック
@@ -151,11 +150,11 @@ export function validateRepositoryUrl(url: string): ValidationResult {
     errors.push('Repository URL format is invalid');
   }
 
-  return {
-    isValid: errors.length === 0,
-    errors,
-    warnings,
-  };
+  if (errors.length > 0) {
+    return failure(errors, warnings);
+  }
+
+  return success(true, warnings);
 }
 
 /**