@sk8metal/michi-cli 0.5.0 → 0.8.0

package/scripts/health-check-service.ts

@@ -0,0 +1,171 @@
+/**
+ * ヘルスチェックサービス
+ * 依存サービスの状態を確認してテスト実行前の環境チェックを行う
+ */
+
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { execSync } from 'child_process';
+
+/**
+ * サービスステータス
+ */
+export interface ServiceStatus {
+  serviceName: string;
+  status: 'healthy' | 'unhealthy';
+  message?: string;
+}
+
+/**
+ * ヘルスチェック結果
+ */
+export interface HealthCheckResult {
+  success: boolean;
+  servicesStatus: ServiceStatus[];
+}
+
+/**
+ * execSync実行時のエラー型
+ */
+interface ExecError extends Error {
+  status?: number;
+  stdout?: Buffer | string;
+  stderr?: Buffer | string;
+}
+
+/**
+ * ヘルスチェックサービス
+ */
+export class HealthCheckService {
+  /**
+   * ヘルスチェックを実行
+   *
+   * @param projectName プロジェクト名
+   * @param projectRoot プロジェクトルートディレクトリ（デフォルト: process.cwd()）
+   * @returns ヘルスチェック結果
+   */
+  async runHealthCheck(
+    projectName: string,
+    projectRoot: string = process.cwd()
+  ): Promise<HealthCheckResult> {
+    // 1. ヘルスチェックスクリプトの存在確認
+    const scriptPath = join(
+      projectRoot,
+      'docs',
+      'michi',
+      projectName,
+      'tests',
+      'scripts',
+      'health-check.sh'
+    );
+
+    if (!existsSync(scriptPath)) {
+      console.log(
+        `ℹ️ ヘルスチェックスクリプトが見つかりません: ${scriptPath}。ヘルスチェックをスキップします。`
+      );
+      return {
+        success: true,
+        servicesStatus: [],
+      };
+    }
+
+    // 2. ヘルスチェックスクリプトを実行
+    try {
+      console.log('🔍 ヘルスチェックを実行中...');
+      const output = execSync(scriptPath, {
+        encoding: 'utf-8',
+        timeout: 30000, // 30秒タイムアウト
+      }) as string;
+
+      // 3. スクリプト出力を解析
+      const servicesStatus = this.parseHealthCheckOutput(output);
+
+      // 4. unhealthyなサービスがある場合は失敗
+      const hasUnhealthyServices = servicesStatus.some(
+        (s) => s.status === 'unhealthy'
+      );
+
+      if (hasUnhealthyServices) {
+        console.log('❌ ヘルスチェックが失敗しました');
+        servicesStatus.forEach((s) => {
+          const icon = s.status === 'healthy' ? '✅' : '❌';
+          const message = s.message ? ` - ${s.message}` : '';
+          console.log(`  ${icon} ${s.serviceName}: ${s.status}${message}`);
+        });
+
+        return {
+          success: false,
+          servicesStatus,
+        };
+      }
+
+      console.log('✅ ヘルスチェックが成功しました');
+      servicesStatus.forEach((s) => {
+        console.log(`  ✅ ${s.serviceName}: ${s.status}`);
+      });
+
+      return {
+        success: true,
+        servicesStatus,
+      };
+    } catch (error) {
+      // スクリプト実行エラー
+      const execError = error as ExecError;
+      console.error('❌ ヘルスチェックスクリプトの実行に失敗しました:', execError.message);
+
+      if (execError.status !== undefined && execError.status !== 0) {
+        // 終了コードが非0の場合は失敗
+        const output = execError.stdout || execError.stderr || '';
+        const outputStr = Buffer.isBuffer(output) ? output.toString('utf-8') : String(output);
+        const servicesStatus = this.parseHealthCheckOutput(outputStr);
+
+        return {
+          success: false,
+          servicesStatus,
+        };
+      }
+
+      // その他のエラー（タイムアウト、パーミッションエラーなど）
+      return {
+        success: false,
+        servicesStatus: [],
+      };
+    }
+  }
+
+  /**
+   * ヘルスチェックスクリプトの出力を解析
+   *
+   * 出力形式:
+   * ```
+   * service-name: healthy
+   * service-name: unhealthy - error message
+   * ```
+   *
+   * @param output スクリプト出力
+   * @returns サービスステータス配列
+   */
+  private parseHealthCheckOutput(output: string): ServiceStatus[] {
+    const servicesStatus: ServiceStatus[] = [];
+    const lines = output.trim().split('\n');
+
+    for (const line of lines) {
+      const match = line.match(/^(\S+):\s+(healthy|unhealthy)(?:\s+-\s+(.+))?$/);
+      if (!match) {
+        continue; // 不正な形式の行はスキップ
+      }
+
+      const serviceName = match[1];
+      const status = match[2] as 'healthy' | 'unhealthy';
+      const message = match[3];
+
+      servicesStatus.push({
+        serviceName,
+        status,
+        message,
+      });
+    }
+
+    return servicesStatus;
+  }
+}

package/scripts/markdown-to-confluence.ts

@@ -14,14 +14,37 @@ const md = new MarkdownIt({
  * Markdown を Confluence Storage Format (HTML) に変換
  */
 export function convertMarkdownToConfluence(markdown: string): string {
-  // MarkdownIt でHTMLに変換
-  let html = md.render(markdown);
-  
-  // Confluence固有の変換
+  // 1. Mermaidブロックをプレースホルダーに置き換え
+  const mermaidBlocks: string[] = [];
+  const withPlaceholders = markdown.replace(
+    /```mermaid\n([\s\S]*?)```/g,
+    (match, diagram) => {
+      const placeholder = `<!--MERMAID_BLOCK_${mermaidBlocks.length}-->`;
+      mermaidBlocks.push(diagram.trim());
+      return placeholder;
+    }
+  );
+
+  // 2. MarkdownIt でHTMLに変換
+  let html = md.render(withPlaceholders);
+
+  // 3. Confluence固有の変換
   html = convertCodeBlocks(html);
   html = convertTables(html);
   html = convertInfoBoxes(html);
-  
+
+  // 4. プレースホルダーをConfluenceマクロに戻す
+  html = html.replace(
+    /<!--MERMAID_BLOCK_(\d+)-->/g,
+    (match, index) => {
+      const diagram = mermaidBlocks[parseInt(index)];
+      const escapedDiagram = escapeCDATA(diagram);
+      return `<ac:structured-macro ac:name="mermaid">
+  <ac:plain-text-body><![CDATA[${escapedDiagram}]]></ac:plain-text-body>
+</ac:structured-macro>`;
+    }
+  );
+
   return html;
 }
 
@@ -96,12 +119,20 @@ function decodeHtmlEntities(text: string): string {
     '&#39;': '\'',
     '&nbsp;': ' '
   };
-  
+
   return text.replace(/&[a-z]+;|&#\d+;/g, (entity) => {
     return entities[entity] || entity;
   });
 }
 
+/**
+ * CDATA内の ]]> をエスケープ
+ */
+function escapeCDATA(text: string): string {
+  // ]]> を ]]]]><![CDATA[> に置換してエスケープ
+  return text.replace(/]]>/g, ']]]]><![CDATA[>');
+}
+
 /**
  * Confluenceページテンプレートを生成
  */

package/scripts/mermaid-converter.ts

@@ -0,0 +1,56 @@
+/**
+ * MermaidダイアグラムをConfluenceマクロ形式に変換
+ */
+
+/**
+ * MermaidConverter
+ * MarkdownテキストからMermaidブロックを検出し、Confluenceマクロ形式に変換
+ */
+export class MermaidConverter {
+  /**
+   * MarkdownテキストからMermaidブロックをConfluenceマクロ形式に変換
+   *
+   * @param markdown Markdownテキスト
+   * @returns 変換後のテキスト
+   */
+  convertMermaidToConfluence(markdown: string): string {
+    // Mermaidブロックを検出する正規表現
+    // ```mermaid\n([\s\S]*?)\n```
+    const mermaidBlockRegex = /```mermaid\n([\s\S]*?)```/g;
+
+    // Mermaidブロックを検出
+    const matches = Array.from(markdown.matchAll(mermaidBlockRegex));
+
+    // Mermaidブロックがない場合は変更なし
+    if (matches.length === 0) {
+      return markdown;
+    }
+
+    // Mermaidブロックを Confluence マクロ形式に変換
+    const converted = markdown.replace(mermaidBlockRegex, (match, diagram) => {
+      // 前後の空白を削除
+      const trimmedDiagram = diagram.trim();
+
+      // CDATA終了マーカー ]]> をエスケープ
+      const escapedDiagram = this.escapeCDATA(trimmedDiagram);
+
+      // Confluenceマクロ形式に変換
+      return `<ac:structured-macro ac:name="mermaid">
+  <ac:plain-text-body><![CDATA[${escapedDiagram}]]></ac:plain-text-body>
+</ac:structured-macro>`;
+    });
+
+    return converted;
+  }
+
+  /**
+   * CDATA内の ]]> をエスケープ
+   *
+   * @param text テキスト
+   * @returns エスケープ後のテキスト
+   */
+  private escapeCDATA(text: string): string {
+    // ]]> を ]]]]><![CDATA[> に置換してエスケープ
+    return text.replace(/]]>/g, ']]]]><![CDATA[>');
+  }
+}

package/scripts/template/__tests__/multi-repo-renderer.test.ts

@@ -0,0 +1,261 @@
+/**
+ * Tests for Multi-Repo template renderer
+ */
+
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import {
+  createMultiRepoTemplateContext,
+  loadMultiRepoTemplate,
+  renderMultiRepoTemplate,
+  loadAndRenderMultiRepoTemplate,
+  renderMultiRepoTemplates,
+  MULTI_REPO_TEMPLATES,
+  type MultiRepoTemplateContext,
+} from '../multi-repo-renderer.js';
+import * as fs from 'fs';
+
+vi.mock('fs');
+
+describe('createMultiRepoTemplateContext', () => {
+  it('必須フィールドを含むコンテキストを作成する', () => {
+    const context = createMultiRepoTemplateContext(
+      'test-project',
+      'TEST',
+      'SPACE'
+    );
+
+    expect(context.PROJECT_NAME).toBe('test-project');
+    expect(context.JIRA_KEY).toBe('TEST');
+    expect(context.CONFLUENCE_SPACE).toBe('SPACE');
+    expect(context.CREATED_AT).toBeDefined();
+  });
+
+  it('CREATED_ATにカスタム値を指定できる', () => {
+    const customDate = '2025-12-14T10:00:00Z';
+    const context = createMultiRepoTemplateContext(
+      'test-project',
+      'TEST',
+      'SPACE',
+      customDate
+    );
+
+    expect(context.CREATED_AT).toBe(customDate);
+  });
+
+  it('CREATED_ATが省略された場合は現在時刻を使用する', () => {
+    const context = createMultiRepoTemplateContext(
+      'test-project',
+      'TEST',
+      'SPACE'
+    );
+
+    // ISO 8601形式であることを確認
+    expect(context.CREATED_AT).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/);
+  });
+});
+
+describe('loadMultiRepoTemplate', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it('テンプレートファイルを読み込む', () => {
+    const mockContent = '# {{PROJECT_NAME}} - Requirements';
+    vi.spyOn(fs, 'readFileSync').mockReturnValue(mockContent);
+
+    const content = loadMultiRepoTemplate('overview/requirements', '/test/root');
+
+    expect(fs.readFileSync).toHaveBeenCalledWith(
+      '/test/root/templates/multi-repo/overview/requirements.md',
+      'utf-8'
+    );
+    expect(content).toBe(mockContent);
+  });
+
+  it('テンプレートが存在しない場合はエラーをスロー', () => {
+    vi.spyOn(fs, 'readFileSync').mockImplementation(() => {
+      throw new Error('ENOENT: no such file or directory');
+    });
+
+    expect(() => loadMultiRepoTemplate('invalid/template', '/test/root')).toThrow(
+      'Multi-Repo template not found: invalid/template.md'
+    );
+  });
+});
+
+describe('renderMultiRepoTemplate', () => {
+  it('プレースホルダーを置換する', () => {
+    const template = '# {{PROJECT_NAME}} - {{JIRA_KEY}}\n\nCreated: {{CREATED_AT}}';
+    const context: MultiRepoTemplateContext = {
+      PROJECT_NAME: 'test-project',
+      JIRA_KEY: 'TEST',
+      CONFLUENCE_SPACE: 'SPACE',
+      CREATED_AT: '2025-12-14T10:00:00Z',
+    };
+
+    const rendered = renderMultiRepoTemplate(template, context);
+
+    expect(rendered).toBe('# test-project - TEST\n\nCreated: 2025-12-14T10:00:00Z');
+  });
+
+  it('すべてのMulti-Repoプレースホルダーを置換する', () => {
+    const template = [
+      '{{PROJECT_NAME}}',
+      '{{JIRA_KEY}}',
+      '{{CONFLUENCE_SPACE}}',
+      '{{CREATED_AT}}',
+    ].join(' / ');
+
+    const context: MultiRepoTemplateContext = {
+      PROJECT_NAME: 'my-project',
+      JIRA_KEY: 'PROJ',
+      CONFLUENCE_SPACE: 'MYSPACE',
+      CREATED_AT: '2025-12-14T10:00:00Z',
+    };
+
+    const rendered = renderMultiRepoTemplate(template, context);
+
+    expect(rendered).toBe('my-project / PROJ / MYSPACE / 2025-12-14T10:00:00Z');
+  });
+
+  it('存在しないプレースホルダーはそのまま残す', () => {
+    const template = '{{PROJECT_NAME}} - {{UNKNOWN_PLACEHOLDER}}';
+    const context: MultiRepoTemplateContext = {
+      PROJECT_NAME: 'test-project',
+      JIRA_KEY: 'TEST',
+      CONFLUENCE_SPACE: 'SPACE',
+      CREATED_AT: '2025-12-14T10:00:00Z',
+    };
+
+    const rendered = renderMultiRepoTemplate(template, context);
+
+    expect(rendered).toBe('test-project - {{UNKNOWN_PLACEHOLDER}}');
+  });
+});
+
+describe('loadAndRenderMultiRepoTemplate', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it('テンプレートを読み込んでレンダリングする', () => {
+    const mockContent = '# {{PROJECT_NAME}} Requirements\n\n**JIRA**: {{JIRA_KEY}}';
+    vi.spyOn(fs, 'readFileSync').mockReturnValue(mockContent);
+
+    const context: MultiRepoTemplateContext = {
+      PROJECT_NAME: 'test-project',
+      JIRA_KEY: 'TEST',
+      CONFLUENCE_SPACE: 'SPACE',
+      CREATED_AT: '2025-12-14T10:00:00Z',
+    };
+
+    const rendered = loadAndRenderMultiRepoTemplate(
+      'overview/requirements',
+      context,
+      '/test/root'
+    );
+
+    expect(rendered).toBe('# test-project Requirements\n\n**JIRA**: TEST');
+  });
+});
+
+describe('renderMultiRepoTemplates', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it('複数のテンプレートを一括レンダリングする', () => {
+    vi.spyOn(fs, 'readFileSync').mockImplementation((path) => {
+      if (path.toString().includes('requirements')) {
+        return '# {{PROJECT_NAME}} Requirements';
+      }
+      if (path.toString().includes('architecture')) {
+        return '# {{PROJECT_NAME}} Architecture';
+      }
+      return 'Template not found';
+    });
+
+    const context: MultiRepoTemplateContext = {
+      PROJECT_NAME: 'test-project',
+      JIRA_KEY: 'TEST',
+      CONFLUENCE_SPACE: 'SPACE',
+      CREATED_AT: '2025-12-14T10:00:00Z',
+    };
+
+    const rendered = renderMultiRepoTemplates(
+      ['overview/requirements', 'overview/architecture'],
+      context,
+      '/test/root'
+    );
+
+    expect(rendered['overview/requirements']).toBe('# test-project Requirements');
+    expect(rendered['overview/architecture']).toBe('# test-project Architecture');
+  });
+
+  it('空の配列を渡した場合は空のオブジェクトを返す', () => {
+    const context: MultiRepoTemplateContext = {
+      PROJECT_NAME: 'test-project',
+      JIRA_KEY: 'TEST',
+      CONFLUENCE_SPACE: 'SPACE',
+      CREATED_AT: '2025-12-14T10:00:00Z',
+    };
+
+    const rendered = renderMultiRepoTemplates([], context, '/test/root');
+
+    expect(rendered).toEqual({});
+  });
+});
+
+describe('MULTI_REPO_TEMPLATES', () => {
+  it('すべてのMulti-Repoテンプレート名を含む', () => {
+    expect(MULTI_REPO_TEMPLATES).toContain('overview/requirements');
+    expect(MULTI_REPO_TEMPLATES).toContain('overview/architecture');
+    expect(MULTI_REPO_TEMPLATES).toContain('overview/sequence');
+    expect(MULTI_REPO_TEMPLATES).toContain('steering/multi-repo');
+    expect(MULTI_REPO_TEMPLATES).toContain('tests/strategy');
+    expect(MULTI_REPO_TEMPLATES).toContain('docs/ci-status');
+    expect(MULTI_REPO_TEMPLATES).toContain('docs/release-notes');
+  });
+
+  it('テンプレート数は7つ', () => {
+    expect(MULTI_REPO_TEMPLATES.length).toBe(7);
+  });
+});
+
+describe('統合テスト', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it('実際のテンプレートファイルをレンダリングできる（モック使用）', () => {
+    const mockRequirementsTemplate = `# {{PROJECT_NAME}} - 要件定義書
+
+## プロジェクト情報
+
+- **プロジェクト名**: {{PROJECT_NAME}}
+- **JIRAキー**: {{JIRA_KEY}}
+- **Confluenceスペース**: {{CONFLUENCE_SPACE}}
+- **作成日時**: {{CREATED_AT}}`;
+
+    vi.spyOn(fs, 'readFileSync').mockReturnValue(mockRequirementsTemplate);
+
+    const context: MultiRepoTemplateContext = {
+      PROJECT_NAME: 'my-awesome-project',
+      JIRA_KEY: 'AWESOME',
+      CONFLUENCE_SPACE: 'PROJ',
+      CREATED_AT: '2025-12-14T10:30:00Z',
+    };
+
+    const rendered = loadAndRenderMultiRepoTemplate(
+      'overview/requirements',
+      context,
+      '/test/root'
+    );
+
+    expect(rendered).toContain('# my-awesome-project - 要件定義書');
+    expect(rendered).toContain('- **プロジェクト名**: my-awesome-project');
+    expect(rendered).toContain('- **JIRAキー**: AWESOME');
+    expect(rendered).toContain('- **Confluenceスペース**: PROJ');
+    expect(rendered).toContain('- **作成日時**: 2025-12-14T10:30:00Z');
+  });
+});