「Cursor」で「素の議事録」を「要件定義書」に高速でまとめなおした話 #Node.js – Qiita

const https = require('https');
const fs = require('fs').promises;
const path = require('path');

// .envファイルを読み込む関数
function loadEnv() {
  try {
    const envPath = path.join(__dirname, '.env');
    const envFile = require('fs').readFileSync(envPath, 'utf-8');
    
    envFile.split('\n').forEach(line => {
      const trimmedLine = line.trim();
      if (trimmedLine && !trimmedLine.startsWith('#')) {
        const [key, ...valueParts] = trimmedLine.split('=');
        const value = valueParts.join('=');
        if (key && value) {
          process.env[key.trim()] = value.trim();
        }
      }
    });
    console.log('.envファイルを読み込みました');
  } catch (error) {
    console.log('.envファイルが見つからないため、環境変数を使用します');
  }
}

// .envファイルを読み込み
loadEnv();

// 設定
const CONFIG = {
  SPACE_ID: process.env.BACKLOG_SPACE_ID || 'your-space-id', // スペースID
  API_KEY: process.env.BACKLOG_API_KEY || 'your-api-key',     // APIキー
  PROJECT_KEY: process.env.BACKLOG_PROJECT_KEY || 'PROJECT',   // プロジェクトキー
  OUTPUT_DIR: './backlog-issues'                               // 出力ディレクトリ
};

// Backlog API基本設定
const API_BASE_URL = `https://${CONFIG.SPACE_ID}.backlog.com/api/v2`;

/**
 * HTTPS GETリクエストを実行
 */
function httpsGet(url) {
  return new Promise((resolve, reject) => {
    https.get(url, (res) => {
      let data = '';
      res.on('data', (chunk) => data += chunk);
      res.on('end', () => {
        if (res.statusCode >= 200 && res.statusCode  300) {
          resolve(JSON.parse(data));
        } else {
          reject(new Error(`HTTP ${res.statusCode}: ${data}`));
        }
      });
    }).on('error', reject);
  });
}

/**
 * プロジェクト情報を取得
 */
async function getProject(projectKey) {
  const url = `${API_BASE_URL}/projects/${projectKey}?apiKey=${CONFIG.API_KEY}`;
  return await httpsGet(url);
}

/**
 * 課題一覧を取得（ページネーション対応）
 */
async function getAllIssues(projectId) {
  const issues = [];
  let offset = 0;
  const count = 100; // 1ページあたりの取得数（最大100）

  while (true) {
    const url = `${API_BASE_URL}/issues?apiKey=${CONFIG.API_KEY}&projectId[]=${projectId}&count=${count}&offset=${offset}`;
    const batch = await httpsGet(url);
    
    if (batch.length === 0) break;
    
    issues.push(...batch);
    console.log(`取得済み課題数: ${issues.length}`);
    
    if (batch.length  count) break;
    offset += count;
  }

  return issues;
}

/**
 * 課題のコメントを取得
 */
async function getIssueComments(issueId) {
  const url = `${API_BASE_URL}/issues/${issueId}/comments?apiKey=${CONFIG.API_KEY}&order=asc`;
  return await httpsGet(url);
}

/**
 * 添付ファイル情報を取得
 */
async function getAttachmentInfo(issueId, attachmentId) {
  const url = `${API_BASE_URL}/issues/${issueId}/attachments/${attachmentId}?apiKey=${CONFIG.API_KEY}`;
  return await httpsGet(url);
}

/**
 * 課題の種別名を取得
 */
function getIssueTypeName(issue) {
  return issue.issueType?.name || '不明';
}

/**
 * 課題の状態名を取得
 */
function getStatusName(issue) {
  return issue.status?.name || '不明';
}

/**
 * 優先度名を取得
 */
function getPriorityName(issue) {
  return issue.priority?.name || '不明';
}

/**
 * 日付をフォーマット
 */
function formatDate(dateString) {
  if (!dateString) return '-';
  const date = new Date(dateString);
  return date.toLocaleString('ja-JP', {
    year: 'numeric',
    month: '2-digit',
    day: '2-digit',
    hour: '2-digit',
    minute: '2-digit'
  });
}

/**
 * Markdownエスケープ
 */
function escapeMarkdown(text) {
  if (!text) return '';
  return text
    .replace(/\\/g, '\\\\')
    .replace(/\*/g, '\\*')
    .replace(/_/g, '\\_')
    .replace(/\[/g, '\\[')
    .replace(/\]/g, '\\]')
    .replace(/, '<')
    .replace(/>/g, '>');
}

/**
 * カスタムフィールドの値を取得
 */
function getCustomFieldValue(customField) {
  if (!customField.value) return '-';
  
  // 複数選択の場合
  if (Array.isArray(customField.value)) {
    return customField.value.map(v => v.name || v).join(', ');
  }
  
  // 単一選択の場合
  if (typeof customField.value === 'object') {
    return customField.value.name || JSON.stringify(customField.value);
  }
  
  return String(customField.value);
}

/**
 * 課題をMarkdown形式に変換
 */
async function convertIssueToMarkdown(issue, comments) {
  let markdown = `# ${issue.issueKey}: ${issue.summary}\n\n`;
  
  // 基本情報
  markdown += `## 基本情報\n\n`;
  markdown += `| 項目 | 内容 |\n`;
  markdown += `|------|------|\n`;
  markdown += `| 課題キー | ${issue.issueKey} |\n`;
  markdown += `| 種別 | ${getIssueTypeName(issue)} |\n`;
  markdown += `| 状態 | ${getStatusName(issue)} |\n`;
  markdown += `| 優先度 | ${getPriorityName(issue)} |\n`;
  markdown += `| 担当者 | ${issue.assignee?.name || '-'} |\n`;
  markdown += `| 作成者 | ${issue.createdUser?.name || '-'} |\n`;
  markdown += `| 作成日時 | ${formatDate(issue.created)} |\n`;
  markdown += `| 更新日時 | ${formatDate(issue.updated)} |\n`;
  markdown += `| 期限日 | ${issue.dueDate || '-'} |\n`;
  
  if (issue.startDate) {
    markdown += `| 開始日 | ${issue.startDate} |\n`;
  }
  
  if (issue.estimatedHours !== null) {
    markdown += `| 予定時間 | ${issue.estimatedHours}時間 |\n`;
  }
  
  if (issue.actualHours !== null) {
    markdown += `| 実績時間 | ${issue.actualHours}時間 |\n`;
  }
  
  markdown += `\n`;
  
  // カテゴリー
  if (issue.category && issue.category.length > 0) {
    markdown += `## カテゴリー\n\n`;
    issue.category.forEach(cat => {
      markdown += `- ${cat.name}\n`;
    });
    markdown += `\n`;
  }
  
  // マイルストーン
  if (issue.milestone && issue.milestone.length > 0) {
    markdown += `## マイルストーン\n\n`;
    issue.milestone.forEach(ms => {
      markdown += `- ${ms.name}`;
      if (ms.releaseDueDate) {
        markdown += ` (期限: ${ms.releaseDueDate})`;
      }
      markdown += `\n`;
    });
    markdown += `\n`;
  }
  
  // カスタムフィールド
  if (issue.customFields && issue.customFields.length > 0) {
    markdown += `## カスタムフィールド\n\n`;
    markdown += `| フィールド名 | 値 |\n`;
    markdown += `|-------------|----|\n`;
    issue.customFields.forEach(field => {
      markdown += `| ${field.name} | ${getCustomFieldValue(field)} |\n`;
    });
    markdown += `\n`;
  }
  
  // 詳細
  markdown += `## 詳細\n\n`;
  markdown += issue.description || '（詳細なし）';
  markdown += `\n\n`;
  
  // 添付ファイル
  if (issue.attachments && issue.attachments.length > 0) {
    markdown += `## 添付ファイル\n\n`;
    issue.attachments.forEach(att => {
      markdown += `- ${att.name} (${(att.size / 1024).toFixed(2)} KB)\n`;
    });
    markdown += `\n`;
  }
  
  // コメント
  if (comments && comments.length > 0) {
    markdown += `## コメント\n\n`;
    
    for (const comment of comments) {
      markdown += `### ${comment.createdUser?.name || '不明'} - ${formatDate(comment.created)}\n\n`;
      markdown += comment.content || '（コメント内容なし）';
      markdown += `\n\n`;
      
      // コメントの添付ファイル
      if (comment.attachments && comment.attachments.length > 0) {
        markdown += `**添付ファイル:**\n`;
        comment.attachments.forEach(att => {
          markdown += `- ${att.name}\n`;
        });
        markdown += `\n`;
      }
      
      // 通知先
      if (comment.notifications && comment.notifications.length > 0) {
        markdown += `**通知先:** `;
        markdown += comment.notifications.map(n => n.user?.name || '不明').join(', ');
        markdown += `\n\n`;
      }
      
      markdown += `---\n\n`;
    }
  }
  
  return markdown;
}

/**
 * ファイル名として使用できない文字を置換
 */
function sanitizeFileName(fileName) {
  return fileName.replace(/[:"/\\|?*]/g, '_');
}

/**
 * メイン処理
 */
async function main() {
  try {
    console.log('Backlog課題エクスポートツール');
    console.log('================================\n');
    
    // 設定確認
    if (CONFIG.SPACE_ID === 'your-space-id' || CONFIG.API_KEY === 'your-api-key') {
      console.error('エラー: SPACE_IDとAPI_KEYを設定してください。');
      console.error('環境変数または直接CONFIG内の値を設定してください。');
      process.exit(1);
    }
    
    // 出力ディレクトリ作成
    await fs.mkdir(CONFIG.OUTPUT_DIR, { recursive: true });
    console.log(`出力ディレクトリ: ${CONFIG.OUTPUT_DIR}\n`);
    
    // プロジェクト情報取得
    console.log(`プロジェクト情報を取得中: ${CONFIG.PROJECT_KEY}...`);
    const project = await getProject(CONFIG.PROJECT_KEY);
    console.log(`プロジェクト名: ${project.name}\n`);
    
    // 全課題取得
    console.log('課題一覧を取得中...');
    const issues = await getAllIssues(project.id);
    console.log(`\n取得完了: 全${issues.length}件の課題\n`);
    
    // 各課題の詳細とコメントを取得してMarkdownファイルとして保存
    console.log('各課題の詳細情報を取得してファイルに保存中...\n');
    
    for (let i = 0; i  issues.length; i++) {
      const issue = issues[i];
      const progress = `[${i + 1}/${issues.length}]`;
      
      try {
        console.log(`${progress} ${issue.issueKey}: ${issue.summary}`);
        
        // コメント取得
        const comments = await getIssueComments(issue.id);
        console.log(`  └ コメント数: ${comments.length}`);
        
        // Markdown変換
        const markdown = await convertIssueToMarkdown(issue, comments);
        
        // ファイル名生成
        const fileName = sanitizeFileName(`${issue.issueKey}_${issue.summary}`);
        const filePath = path.join(CONFIG.OUTPUT_DIR, `${fileName}.md`);
        
        // ファイル保存
        await fs.writeFile(filePath, markdown, 'utf-8');
        console.log(`  └ 保存完了: ${fileName}.md`);
        
      } catch (error) {
        console.error(`  └ エラー: ${error.message}`);
      }
      
      // API制限対策（1秒待機）
      if (i  issues.length - 1) {
        await new Promise(resolve => setTimeout(resolve, 1000));
      }
    }
    
    console.log('\n================================');
    console.log('エクスポート完了！');
    console.log(`出力先: ${path.resolve(CONFIG.OUTPUT_DIR)}`);
    
  } catch (error) {
    console.error('\nエラーが発生しました:');
    console.error(error.message);
    process.exit(1);
  }
}

// 実行
if (require.main === module) {
  main();
}