@sk8metal/michi-cli 0.14.1 → 0.20.0

package/scripts/utils/aidlc-parser.ts

@@ -1,289 +1,20 @@
 /**
- * AI-DLC形式のtasks.mdパーサー
+ * AIDLC (AI Development Life Cycle) パーサー
  *
- * AI-DLC形式:
- * - `## 1. Category Name` のようなカテゴリヘッダー
- * - `- [ ] 1.1 Task description` のようなタスク形式
- * - 任意の `_Requirements: X.X, Y.Y_` タグ
- * - 任意の `(P)` 並列実行マーカー
- */
-
-import { readFileSync } from 'fs';
-
-/**
- * AI-DLC形式のタスク
- */
-export interface AIDLCTask {
-  id: string; // "1.1", "2.3" など
-  title: string; // タスクのタイトル
-  description: string[]; // インデントされた詳細行
-  requirements: string[]; // 関連する要件ID
-  isParallel: boolean; // (P)マーカーがあるか
-  completed: boolean; // チェックボックスの状態
-}
-
-/**
- * AI-DLC形式のカテゴリ
- */
-export interface AIDLCCategory {
-  id: string; // "1", "2" など
-  title: string; // カテゴリ名
-  tasks: AIDLCTask[];
-}
-
-/**
- * AI-DLC形式のドキュメント
- */
-export interface AIDLCDocument {
-  title: string; // ドキュメントタイトル
-  categories: AIDLCCategory[];
-  summary?: AIDLCSummary; // オプショナルなサマリーセクション
-  rawContent: string; // 元のコンテンツ
-}
-
-/**
- * AI-DLC形式のサマリー情報
- */
-export interface AIDLCSummary {
-  majorTasks?: number;
-  subTasks?: number;
-  estimatedHours?: string;
-  requirementsCoverage?: Map<string, string[]>; // 要件ID -> タスクID[]
-}
-
-/**
- * AI-DLC形式かどうかを判定
- *
- * 判定基準:
- * 1. `- [ ] X.Y` 形式のチェックボックスパターンが存在
- * 2. Phase構造（Phase 0.1:, Phase 2: など）が存在しない
- *
- * @param content - 検証するコンテンツ
- * @returns AI-DLC形式の場合true
- */
-export function isAIDLCFormat(content: string): boolean {
-  // AI-DLCパターン: "- [ ] 1." or "- [x] 1." (数字.で始まるタスク)
-  const hasAIDLCPattern = /^- \[[ x]\] \d+\./m.test(content);
-
-  // Michiワークフロー形式のPhase構造
-  const hasPhaseStructure =
-    content.includes('Phase 0:') ||
-    content.includes('Phase 0.1:') ||
-    content.includes('Phase 2:') ||
-    content.includes('## Phase');
-
-  // Story構造もチェック
-  const hasStoryStructure = /### Story \d+\.\d+:/.test(content);
-
-  return hasAIDLCPattern && !hasPhaseStructure && !hasStoryStructure;
-}
-
-/**
- * AI-DLC形式のコンテンツをパース
- *
- * @param content - パースするコンテンツ
- * @returns パースされたドキュメント
- */
-export function parseAIDLCFormat(content: string): AIDLCDocument {
-  const lines = content.split('\n');
-  const document: AIDLCDocument = {
-    title: '',
-    categories: [],
-    rawContent: content,
-  };
-
-  // タイトル抽出（最初の # で始まる行）
-  const titleMatch = content.match(/^# (.+)$/m);
-  if (titleMatch) {
-    document.title = titleMatch[1].trim();
-  }
-
-  let currentCategory: AIDLCCategory | null = null;
-  let currentTask: AIDLCTask | null = null;
-  let inSummarySection = false;
-
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    const trimmedLine = line.trim();
-
-    // サマリーセクションの検出
-    if (
-      trimmedLine.startsWith('## 要件カバレッジ') ||
-      trimmedLine.startsWith('## Requirements Coverage') ||
-      trimmedLine.startsWith('## 並列実行可能') ||
-      trimmedLine.startsWith('## Parallel') ||
-      trimmedLine.startsWith('## タスク見積') ||
-      trimmedLine.startsWith('## Task Estimate') ||
-      trimmedLine === '---'
-    ) {
-      inSummarySection = true;
-      // 現在のタスクを保存
-      if (currentTask && currentCategory) {
-        currentCategory.tasks.push(currentTask);
-        currentTask = null;
-      }
-      continue;
-    }
-
-    if (inSummarySection) {
-      // サマリーセクションの解析（オプション）
-      parseSummaryLine(document, trimmedLine);
-      continue;
-    }
-
-    // カテゴリヘッダー: ## 1. Category Name
-    const categoryMatch = trimmedLine.match(/^## (\d+)\. (.+)$/);
-    if (categoryMatch) {
-      // 前のタスクを保存
-      if (currentTask && currentCategory) {
-        currentCategory.tasks.push(currentTask);
-        currentTask = null;
-      }
-      // 前のカテゴリを保存
-      if (currentCategory) {
-        document.categories.push(currentCategory);
-      }
-
-      currentCategory = {
-        id: categoryMatch[1],
-        title: categoryMatch[2].trim(),
-        tasks: [],
-      };
-      continue;
-    }
-
-    // タスク行: - [ ] 1.1 Task description または - [x] 1.1 Task description
-    const taskMatch = trimmedLine.match(
-      /^- \[([ x])\] (\d+\.\d+\*?) (?:\(P\) )?(.+)$/,
-    );
-    if (taskMatch && currentCategory) {
-      // 前のタスクを保存
-      if (currentTask) {
-        currentCategory.tasks.push(currentTask);
-      }
-
-      const isParallel =
-        trimmedLine.includes('(P)') || taskMatch[2].endsWith('*');
-      const taskId = taskMatch[2].replace('*', '');
-
-      currentTask = {
-        id: taskId,
-        title: taskMatch[3].trim(),
-        description: [],
-        requirements: [],
-        isParallel,
-        completed: taskMatch[1] === 'x',
-      };
-      continue;
-    }
-
-    // タスクの詳細行（インデントされた行）
-    if (currentTask && line.startsWith('  ') && trimmedLine) {
-      // Requirements タグの抽出
-      const reqMatch = trimmedLine.match(/_Requirements?: (.+)_|_要件: (.+)_/i);
-      if (reqMatch) {
-        const reqString = reqMatch[1] || reqMatch[2];
-        const requirements = reqString.split(',').map((r) => r.trim());
-        currentTask.requirements.push(...requirements);
-      } else {
-        // 通常の詳細行
-        currentTask.description.push(trimmedLine.replace(/^- /, ''));
-      }
-    }
-  }
-
-  // 最後のタスクとカテゴリを保存
-  if (currentTask && currentCategory) {
-    currentCategory.tasks.push(currentTask);
-  }
-  if (currentCategory) {
-    document.categories.push(currentCategory);
-  }
-
-  return document;
-}
-
-/**
- * サマリー行を解析
- */
-function parseSummaryLine(document: AIDLCDocument, line: string): void {
-  if (!document.summary) {
-    document.summary = {};
-  }
-
-  // Major Tasks
-  const majorMatch = line.match(/Major Tasks.*?(\d+)/i);
-  if (majorMatch) {
-    document.summary.majorTasks = parseInt(majorMatch[1], 10);
-  }
-
-  // Sub-Tasks
-  const subMatch = line.match(/Sub-?Tasks.*?(\d+)/i);
-  if (subMatch) {
-    document.summary.subTasks = parseInt(subMatch[1], 10);
-  }
-
-  // Estimated hours
-  const hoursMatch = line.match(
-    /総工数見積.*?[:：]?\s*(.+)|Estimated.*?[:：]?\s*(.+)/i,
-  );
-  if (hoursMatch) {
-    document.summary.estimatedHours = (hoursMatch[1] || hoursMatch[2]).trim();
-  }
-}
-
-/**
- * ファイルからAI-DLC形式をパース
- *
- * @param filePath - ファイルパス
- * @returns パースされたドキュメント
- * @throws ファイルが存在しない、またはAI-DLC形式でない場合
- */
-export function parseAIDLCFile(filePath: string): AIDLCDocument {
-  const content = readFileSync(filePath, 'utf-8');
-
-  if (!isAIDLCFormat(content)) {
-    throw new Error(
-      `File is not in AI-DLC format: ${filePath}\n` +
-        'Expected format: "- [ ] X.Y Task description" without Phase structure',
-    );
-  }
-
-  return parseAIDLCFormat(content);
-}
-
-/**
- * AI-DLCドキュメントの統計情報を取得
- *
- * @param doc - AI-DLCドキュメント
- * @returns 統計情報
- */
-export function getAIDLCStats(doc: AIDLCDocument): {
-  totalCategories: number;
-  totalTasks: number;
-  completedTasks: number;
-  parallelTasks: number;
-  tasksWithRequirements: number;
-} {
-  let totalTasks = 0;
-  let completedTasks = 0;
-  let parallelTasks = 0;
-  let tasksWithRequirements = 0;
-
-  for (const category of doc.categories) {
-    for (const task of category.tasks) {
-      totalTasks++;
-      if (task.completed) completedTasks++;
-      if (task.isParallel) parallelTasks++;
-      if (task.requirements.length > 0) tasksWithRequirements++;
-    }
-  }
-
-  return {
-    totalCategories: doc.categories.length,
-    totalTasks,
-    completedTasks,
-    parallelTasks,
-    tasksWithRequirements,
-  };
-}
+ * このファイルは後方互換性のための再エクスポートです。
+ * 実装は src/infrastructure/parsers/aidlc-parser.ts に移行されました。
+ */
+
+export type {
+  AIDLCTask,
+  AIDLCCategory,
+  AIDLCSummary,
+  AIDLCDocument,
+} from '../../src/infrastructure/parsers/aidlc-parser.js';
+
+export {
+  parseAIDLCFormat,
+  isAIDLCFormat,
+  parseAIDLCFile,
+  getAIDLCStats,
+} from '../../src/infrastructure/parsers/aidlc-parser.js';

package/scripts/utils/ci-generator.ts

@@ -3,7 +3,8 @@
  * プロジェクトの言語/ツールに応じてCI/CD設定を生成
  */
 
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { writeFileSync, existsSync, mkdirSync } from 'fs';
+import { safeReadFileOrThrow } from './safe-file-reader.js';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 
@@ -52,7 +53,7 @@ export async function generateCIConfig(
     return;
   }
   
-  const template = readFileSync(templatePath, 'utf-8');
+  const template = safeReadFileOrThrow(templatePath, 'utf-8');
   
   // GitHub Actionsの場合
   if (ciTool === 'GitHub Actions') {
@@ -74,7 +75,7 @@ export async function generateCIConfig(
     const screwdriverTemplatePath = join(__dirname, '..', '..', 'templates', 'ci', 'screwdriver', screwdriverFile);
     
     if (existsSync(screwdriverTemplatePath)) {
-      const screwdriverTemplate = readFileSync(screwdriverTemplatePath, 'utf-8');
+      const screwdriverTemplate = safeReadFileOrThrow(screwdriverTemplatePath, 'utf-8');
       const outputPath = join(projectRoot, 'screwdriver.yaml');
       writeFileSync(outputPath, screwdriverTemplate, 'utf-8');
       console.log('   ✅ CI/CD設定: screwdriver.yaml');

package/scripts/utils/config-loader.ts

@@ -3,12 +3,13 @@
  * デフォルト設定 + プロジェクト固有設定をマージ
  */
 
-import { readFileSync, writeFileSync, existsSync, statSync, renameSync, unlinkSync, mkdirSync } from 'fs';
+import { writeFileSync, existsSync, statSync, renameSync, unlinkSync, mkdirSync } from 'fs';
 import { resolve, relative, isAbsolute, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { homedir } from 'os';
 import { parse as dotenvParse } from 'dotenv';
 import { loadEnv } from './env-loader.js';
+import { safeReadFileOrThrow, safeReadJsonFile } from './safe-file-reader.js';
 import {
   AppConfigSchema,
   MultiRepoProjectSchema,
@@ -136,20 +137,26 @@ function loadDefaultConfig(): AppConfig {
     throw new Error(`Default config file not found: ${defaultConfigPath}\nPlease ensure the file exists in the scripts/config directory.`);
   }
   
+  const readResult = safeReadJsonFile(defaultConfigPath);
+
+  if (!readResult.success) {
+    const error = readResult.errors[0];
+    if (error.type === 'FileNotFound') {
+      throw new Error(`Default config file not found: ${defaultConfigPath}\nPlease ensure the file exists in the scripts/config directory.`);
+    }
+    if (error.type === 'InvalidJSON') {
+      throw new Error(`Invalid JSON in default config file ${defaultConfigPath}: ${error.cause}`);
+    }
+    throw new Error(`Failed to load default config from ${defaultConfigPath}: ${error.type}`);
+  }
+
   try {
-    const content = readFileSync(defaultConfigPath, 'utf-8');
-    const parsed = JSON.parse(content);
-    
     // 環境変数を展開
-    const expanded = expandEnvVarsInConfig(parsed);
-    
+    const expanded = expandEnvVarsInConfig(readResult.value);
+
     // スキーマでバリデーション
     return AppConfigSchema.parse(expanded);
   } catch (error) {
-    if (error instanceof SyntaxError) {
-      // SyntaxErrorには標準的なlineやcolumnプロパティはないため、messageのみ使用
-      throw new Error(`Invalid JSON in default config file ${defaultConfigPath}: ${error.message}`);
-    }
     if (error instanceof Error && error.name === 'ZodError') {
       throw new Error(`Default config validation failed: ${error.message}\nFile: ${defaultConfigPath}`);
     }
@@ -211,25 +218,22 @@ function loadProjectConfig(projectRoot: string = process.cwd()): Partial<AppConf
     return null;
   }
 
-  try {
-    const content = readFileSync(projectConfigPath, 'utf-8');
-    const parsed = JSON.parse(content);
-
-    // 環境変数を展開
-    const expanded = expandEnvVarsInConfig(parsed);
+  const readResult = safeReadJsonFile(projectConfigPath);
 
-    // 部分的な設定なので、スキーマで厳密にバリデーションしない
-    // ただし、存在するキーについては型チェック
-    return expanded as Partial<AppConfig>;
-  } catch (error) {
-    if (error instanceof SyntaxError) {
-      throw new Error(`Invalid JSON in ${projectConfigPath}: ${error.message}`);
+  if (!readResult.success) {
+    const error = readResult.errors[0];
+    if (error.type === 'InvalidJSON') {
+      throw new Error(`Invalid JSON in ${projectConfigPath}: ${error.cause}`);
     }
-    if (error instanceof Error && error.message.includes('Invalid config path')) {
-      throw error;
-    }
-    throw new Error(`Failed to load project config from ${projectConfigPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    throw new Error(`Failed to load project config from ${projectConfigPath}: ${error.type}`);
   }
+
+  // 環境変数を展開
+  const expanded = expandEnvVarsInConfig(readResult.value);
+
+  // 部分的な設定なので、スキーマで厳密にバリデーションしない
+  // ただし、存在するキーについては型チェック
+  return expanded as Partial<AppConfig>;
 }
 
 /**
@@ -242,22 +246,22 @@ function loadGlobalConfig(): Partial<AppConfig> | null {
     return null;
   }
 
-  try {
-    const content = readFileSync(globalConfigPath, 'utf-8');
-    const parsed = JSON.parse(content);
-
-    // 環境変数を展開
-    const expanded = expandEnvVarsInConfig(parsed);
+  const readResult = safeReadJsonFile(globalConfigPath);
 
-    return expanded as Partial<AppConfig>;
-  } catch (error) {
-    if (error instanceof SyntaxError) {
-      console.warn(`⚠️  Invalid JSON in global config ${globalConfigPath}: ${error.message}`);
+  if (!readResult.success) {
+    const error = readResult.errors[0];
+    if (error.type === 'InvalidJSON') {
+      console.warn(`⚠️  Invalid JSON in global config ${globalConfigPath}: ${error.cause}`);
     } else {
-      console.warn(`⚠️  Failed to load global config: ${error instanceof Error ? error.message : 'Unknown error'}`);
+      console.warn(`⚠️  Failed to load global config: ${error.type}`);
     }
     return null;
   }
+
+  // 環境変数を展開
+  const expanded = expandEnvVarsInConfig(readResult.value);
+
+  return expanded as Partial<AppConfig>;
 }
 
 /**
@@ -272,10 +276,10 @@ function loadGlobalEnv(): Record<string, string> {
   }
 
   try {
-    const content = readFileSync(globalEnvPath, 'utf-8');
+    const content = safeReadFileOrThrow(globalEnvPath);
     return dotenvParse(content);
   } catch (error) {
-    console.warn(`⚠️  Failed to load global env from ${globalEnvPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    console.warn(`⚠️  Failed to load global env from ${globalEnvPath}: ${error instanceof Error ? error.message : String(error)}`);
     return {};
   }
 }
@@ -292,10 +296,10 @@ function loadProjectEnv(projectRoot: string): Record<string, string> {
   }
 
   try {
-    const content = readFileSync(projectEnvPath, 'utf-8');
+    const content = safeReadFileOrThrow(projectEnvPath);
     return dotenvParse(content);
   } catch (error) {
-    console.warn(`⚠️  Failed to load project env from ${projectEnvPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    console.warn(`⚠️  Failed to load project env from ${projectEnvPath}: ${error instanceof Error ? error.message : String(error)}`);
     return {};
   }
 }
@@ -311,20 +315,20 @@ function loadProjectMetadata(projectRoot: string): Partial<AppConfig> | null {
     return null;
   }
 
-  try {
-    const content = readFileSync(projectJsonPath, 'utf-8');
-    const meta = JSON.parse(content);
+  const readResult = safeReadJsonFile(projectJsonPath);
 
-    // project フィールドとして返す
-    return { project: meta } as Partial<AppConfig>;
-  } catch (error) {
-    if (error instanceof SyntaxError) {
-      console.warn(`⚠️  Invalid JSON in ${projectJsonPath}: ${error.message}`);
+  if (!readResult.success) {
+    const error = readResult.errors[0];
+    if (error.type === 'InvalidJSON') {
+      console.warn(`⚠️  Invalid JSON in ${projectJsonPath}: ${error.cause}`);
     } else {
-      console.warn(`⚠️  Failed to load project metadata from ${projectJsonPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+      console.warn(`⚠️  Failed to load project metadata from ${projectJsonPath}: ${error.type}`);
     }
     return null;
   }
+
+  // project フィールドとして返す
+  return { project: readResult.value } as Partial<AppConfig>;
 }
 
 /**