backlog-exporter 0.2.0 → 0.2.1

package/README.md

@@ -59,7 +59,7 @@ $ npm install -g backlog-exporter
 $ backlog-exporter COMMAND
 running command...
 $ backlog-exporter (--version)
-backlog-exporter/0.2.0 linux-x64 node-v23.9.0
+backlog-exporter/0.2.1 linux-x64 node-v23.9.0
 $ backlog-exporter --help [COMMAND]
 USAGE
   $ backlog-exporter COMMAND
@@ -196,9 +196,11 @@ Backlogから課題とWikiを取得してMarkdownファイルとして保存す
 
 ```
 USAGE
-  $ backlog-exporter all --domain <value> --projectIdOrKey <value> [--apiKey <value>] [-o <value>]
+  $ backlog-exporter all --domain <value> --projectIdOrKey <value> [--apiKey <value>] [-m <value>] [-o
+    <value>]
 
 FLAGS
+  -m, --maxCount=<value>        [default: 5000] 一度に取得する課題の最大数（デフォルト: 5000）
   -o, --output=<value>          出力ディレクトリパス
       --apiKey=<value>          Backlog API key (環境変数 BACKLOG_API_KEY からも自動読み取り可能)
       --domain=<value>          (required) Backlog domain (e.g. example.backlog.jp)
@@ -213,9 +215,12 @@ EXAMPLES
 
   $ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-project
   指定したディレクトリに課題とWikiを保存する
+
+  $ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --maxCount 1000
+  最大1000件の課題を取得する（デフォルトは100件）
 ```
 
-_See code: [src/commands/all/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.2.0/src/commands/all/index.ts)_
+_See code: [src/commands/all/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.2.1/src/commands/all/index.ts)_
 
 ## `backlog-exporter help [COMMAND]`
 
@@ -243,13 +248,16 @@ Backlogから課題を取得してMarkdownファイルとして保存する
 
 ```
 USAGE
-  $ backlog-exporter issue --domain <value> --projectIdOrKey <value> [--apiKey <value>] [-o <value>]
+  $ backlog-exporter issue --domain <value> --projectIdOrKey <value> [--apiKey <value>] [-m <value>] [-o
+    <value>] [--statusId <value>]
 
 FLAGS
+  -m, --maxCount=<value>        [default: 5000] 一度に取得する課題の最大数（デフォルト: 5000）
   -o, --output=<value>          出力ディレクトリパス
       --apiKey=<value>          Backlog API key (環境変数 BACKLOG_API_KEY からも自動読み取り可能)
       --domain=<value>          (required) Backlog domain (e.g. example.backlog.jp)
       --projectIdOrKey=<value>  (required) Backlog project ID or key
+      --statusId=<value>        ステータスID（カンマ区切りで複数指定可能）
 
 DESCRIPTION
   Backlogから課題を取得してMarkdownファイルとして保存する
@@ -258,11 +266,17 @@ EXAMPLES
   $ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY
   課題をMarkdownファイルとして保存する
 
-  $ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-project
+  $ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-issues
   指定したディレクトリに課題を保存する
+
+  $ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --statusId 1,2,3
+  指定したステータスIDの課題のみを取得する
+
+  $ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --maxCount 10000
+  最大10000件の課題を取得する（デフォルトは5000件）
 ```
 
-_See code: [src/commands/issue/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.2.0/src/commands/issue/index.ts)_
+_See code: [src/commands/issue/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.2.1/src/commands/issue/index.ts)_
 
 ## `backlog-exporter plugins`
 
@@ -591,7 +605,7 @@ EXAMPLES
   指定したディレクトリの設定を使用して更新する
 ```
 
-_See code: [src/commands/update/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.2.0/src/commands/update/index.ts)_
+_See code: [src/commands/update/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.2.1/src/commands/update/index.ts)_
 
 ## `backlog-exporter wiki`
 
@@ -618,7 +632,7 @@ EXAMPLES
   指定したディレクトリにWikiを保存する
 ```
 
-_See code: [src/commands/wiki/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.2.0/src/commands/wiki/index.ts)_
+_See code: [src/commands/wiki/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.2.1/src/commands/wiki/index.ts)_
 <!-- commandsstop -->
 
 # 出力形式

package/dist/commands/all/index.d.ts

@@ -5,6 +5,7 @@ export default class All extends Command {
     static flags: {
         apiKey: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         domain: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        maxCount: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         projectIdOrKey: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };

package/dist/commands/all/index.js

@@ -15,6 +15,9 @@ export default class All extends Command {
 `,
         `<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-project
 指定したディレクトリに課題とWikiを保存する
+`,
+        `<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --maxCount 1000
+最大1000件の課題を取得する（デフォルトは100件）
 `,
     ];
     static flags = {
@@ -26,6 +29,12 @@ export default class All extends Command {
             description: 'Backlog domain (e.g. example.backlog.jp)',
             required: true,
         }),
+        maxCount: Flags.integer({
+            char: 'm',
+            default: 5000,
+            description: '一度に取得する課題の最大数（デフォルト: 5000）',
+            required: false,
+        }),
         output: Flags.string({
             char: 'o',
             description: '出力ディレクトリパス',
@@ -39,7 +48,7 @@ export default class All extends Command {
     async run() {
         const { flags } = await this.parse(All);
         try {
-            const { domain, projectIdOrKey } = flags;
+            const { domain, maxCount, projectIdOrKey } = flags;
             const apiKey = flags.apiKey || getApiKey(this);
             const outputRoot = flags.output || './backlog-data';
             // 出力ディレクトリの作成
@@ -53,23 +62,34 @@ export default class All extends Command {
             // Wikiの出力ディレクトリ
             const wikiOutput = path.join(outputRoot, 'wiki');
             await createOutputDirectory(wikiOutput);
+            // 課題フォルダに設定ファイルを保存
+            await updateSettings(issueOutput, {
+                apiKey,
+                domain,
+                folderType: FolderType.ISSUE,
+                outputDir: issueOutput,
+                projectIdOrKey,
+            });
+            // Wikiフォルダに設定ファイルを保存
+            await updateSettings(wikiOutput, {
+                apiKey,
+                domain,
+                folderType: FolderType.WIKI,
+                outputDir: wikiOutput,
+                projectIdOrKey,
+            });
             // 課題の取得と保存
             this.log('課題の取得を開始します...');
             await downloadIssues(this, {
                 apiKey,
-                count: 100,
+                count: maxCount,
                 domain,
                 outputDir: issueOutput,
                 projectId,
             });
-            // 課題フォルダに設定ファイルを保存
+            // 課題フォルダの最終更新日時を更新
             await updateSettings(issueOutput, {
-                apiKey,
-                domain,
-                folderType: FolderType.ISSUE,
                 lastUpdated: new Date().toISOString(),
-                outputDir: issueOutput,
-                projectIdOrKey,
             });
             this.log('課題の取得が完了しました');
             // Wikiの取得と保存
@@ -80,14 +100,9 @@ export default class All extends Command {
                 outputDir: wikiOutput,
                 projectIdOrKey,
             });
-            // Wikiフォルダに設定ファイルを保存
+            // Wikiフォルダの最終更新日時を更新
             await updateSettings(wikiOutput, {
-                apiKey,
-                domain,
-                folderType: FolderType.WIKI,
                 lastUpdated: new Date().toISOString(),
-                outputDir: wikiOutput,
-                projectIdOrKey,
             });
             this.log('Wikiの取得が完了しました');
             this.log('すべてのデータの取得が完了しました！');

package/dist/commands/issue/index.d.ts

@@ -5,8 +5,10 @@ export default class Issue extends Command {
     static flags: {
         apiKey: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         domain: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        maxCount: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         projectIdOrKey: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        statusId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/issue/index.js

@@ -12,8 +12,14 @@ export default class Issue extends Command {
         `<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY
 課題をMarkdownファイルとして保存する
 `,
-        `<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-project
+        `<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-issues
 指定したディレクトリに課題を保存する
+`,
+        `<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --statusId 1,2,3
+指定したステータスIDの課題のみを取得する
+`,
+        `<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --maxCount 10000
+最大10000件の課題を取得する（デフォルトは5000件）
 `,
     ];
     static flags = {
@@ -25,6 +31,12 @@ export default class Issue extends Command {
             description: 'Backlog domain (e.g. example.backlog.jp)',
             required: true,
         }),
+        maxCount: Flags.integer({
+            char: 'm',
+            default: 5000,
+            description: '一度に取得する課題の最大数（デフォルト: 5000）',
+            required: false,
+        }),
         output: Flags.string({
             char: 'o',
             description: '出力ディレクトリパス',
@@ -34,34 +46,42 @@ export default class Issue extends Command {
             description: 'Backlog project ID or key',
             required: true,
         }),
+        statusId: Flags.string({
+            description: 'ステータスID（カンマ区切りで複数指定可能）',
+            required: false,
+        }),
     };
     async run() {
         const { flags } = await this.parse(Issue);
         try {
-            const { domain, projectIdOrKey } = flags;
+            const { domain, maxCount, projectIdOrKey, statusId } = flags;
             const apiKey = flags.apiKey || getApiKey(this);
-            const outputDir = flags.output || './issues';
+            const outputDir = flags.output || './backlog-issues';
             // 出力ディレクトリの作成
             await createOutputDirectory(outputDir);
             // プロジェクトキーからプロジェクトIDを取得
             const projectId = await validateAndGetProjectId(domain, projectIdOrKey, apiKey);
             this.log(`プロジェクトID: ${projectId} を使用します`);
+            // 設定ファイルを保存
+            await updateSettings(outputDir, {
+                apiKey,
+                domain,
+                folderType: FolderType.ISSUE,
+                outputDir,
+                projectIdOrKey,
+            });
             // 課題の取得と保存
             await downloadIssues(this, {
                 apiKey,
-                count: 100,
+                count: maxCount,
                 domain,
                 outputDir,
                 projectId,
+                statusId,
             });
-            // 設定ファイルを保存
+            // 最終更新日時を更新
             await updateSettings(outputDir, {
-                apiKey,
-                domain,
-                folderType: FolderType.ISSUE,
                 lastUpdated: new Date().toISOString(),
-                outputDir,
-                projectIdOrKey,
             });
             this.log('課題の取得が完了しました！');
         }

package/dist/commands/wiki/index.js

@@ -42,22 +42,25 @@ Wikiをダウンロードする
             const outputDir = flags.output || './wiki';
             // 出力ディレクトリの作成
             await createOutputDirectory(outputDir);
-            // Wikiの取得と保存
-            await downloadWikis(this, {
+            // 設定ファイルを保存
+            await updateSettings(outputDir, {
                 apiKey,
                 domain,
+                folderType: FolderType.WIKI,
                 outputDir,
                 projectIdOrKey,
             });
-            // 設定ファイルを保存
-            await updateSettings(outputDir, {
+            // Wikiの取得と保存
+            await downloadWikis(this, {
                 apiKey,
                 domain,
-                folderType: FolderType.WIKI,
-                lastUpdated: new Date().toISOString(),
                 outputDir,
                 projectIdOrKey,
             });
+            // 最終更新日時を更新
+            await updateSettings(outputDir, {
+                lastUpdated: new Date().toISOString(),
+            });
             this.log('Wikiの取得が完了しました！');
         }
         catch (error) {

package/dist/utils/backlog-api.d.ts

@@ -6,7 +6,7 @@ import { Command } from '@oclif/core';
  */
 export declare function downloadIssues(command: Command, options: {
     apiKey: string;
-    count: number;
+    count?: number;
     domain: string;
     lastUpdated?: string;
     outputDir: string;

package/dist/utils/backlog-api.js

@@ -1,7 +1,9 @@
 import ky from 'ky';
 import * as fs from 'node:fs/promises';
 import path from 'node:path';
+import process from 'node:process';
 import { sanitizeFileName, sanitizeWikiFileName } from './common.js';
+import { RateLimiter } from './sleep.js';
 /**
  * Backlogから課題をダウンロードする
  * @param command コマンドインスタンス
@@ -10,23 +12,56 @@ import { sanitizeFileName, sanitizeWikiFileName } from './common.js';
 export async function downloadIssues(command, options) {
     const baseUrl = `https://${options.domain}/api/v2`;
     command.log('課題の取得を開始します...');
-    // APIパラメータの構築
-    const params = new URLSearchParams({
-        apiKey: options.apiKey,
-        count: options.count.toString(),
-        'projectId[]': options.projectId.toString(),
-    });
-    // ステータスIDが指定されている場合は追加
-    if (options.statusId) {
-        params.append('statusId[]', options.statusId);
-    }
-    const issues = await ky.get(`${baseUrl}/issues?${params.toString()}`).json();
-    command.log(`${issues.length}件の課題が見つかりました。`);
+    // 全ての課題を格納する配列
+    let allIssues = [];
+    // countのデフォルト値を5000に設定
+    const count = options.count ?? 5000;
+    const maxCount = Math.min(count, 100); // APIの制限は100件
+    // APIリクエスト数をカウントするためのRateLimiterを作成
+    const rateLimiter = new RateLimiter(command);
+    // 課題を取得する関数
+    const fetchIssues = async (offset) => {
+        // APIリクエスト数をインクリメント
+        await rateLimiter.increment();
+        // APIパラメータの構築
+        const params = new URLSearchParams({
+            apiKey: options.apiKey,
+            count: maxCount.toString(),
+            offset: offset.toString(),
+            'projectId[]': options.projectId.toString(),
+        });
+        // ステータスIDが指定されている場合は追加
+        if (options.statusId) {
+            params.append('statusId[]', options.statusId);
+        }
+        // 進捗状況を一行で更新
+        process.stdout.write(`\r課題を取得中... (${allIssues.length}件取得済み)`);
+        return ky.get(`${baseUrl}/issues?${params.toString()}`).json();
+    };
+    // 再帰的に全ての課題を取得
+    const fetchAllIssues = async (offset) => {
+        try {
+            const issues = await fetchIssues(offset);
+            // 取得した課題を追加
+            allIssues = [...allIssues, ...issues];
+            // 次のページがあるかどうかを確認
+            if (issues.length === maxCount) {
+                // 次のページを取得
+                await fetchAllIssues(offset + maxCount);
+            }
+        }
+        catch (error) {
+            command.error(`課題の取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    };
+    // 課題取得開始
+    await fetchAllIssues(0);
+    command.log(`\n合計 ${allIssues.length}件の課題が見つかりました。`);
     // 前回の更新日時より新しい課題のみをフィルタリング
-    let filteredIssues = issues;
+    let filteredIssues = allIssues;
     if (options.lastUpdated) {
         const lastUpdatedDate = new Date(options.lastUpdated);
-        filteredIssues = issues.filter((issue) => {
+        filteredIssues = allIssues.filter((issue) => {
             const issueUpdatedDate = new Date(issue.updated);
             return issueUpdatedDate > lastUpdatedDate;
         });
@@ -38,28 +73,29 @@ export async function downloadIssues(command, options) {
     }
     // 各課題の詳細情報を取得して保存
     command.log('課題を保存しています...');
-    // Promise.allを使用して並列処理
-    const issuePromises = filteredIssues.map(async (issue) => {
+    // 並列処理ではなく順次処理に変更
+    for (const issue of filteredIssues) {
         try {
-            // 課題の詳細情報をJSONファイルとして保存
-            const issueFileName = `${sanitizeFileName(issue.summary)}.md`;
-            const issueFilePath = path.join(options.outputDir, issueFileName);
+            // 進捗状況を一行で更新
+            const currentIndex = filteredIssues.indexOf(issue) + 1;
+            process.stdout.write(`\r課題を保存中... (${currentIndex}/${filteredIssues.length}件)`);
             // BacklogのIssueへのリンクを作成
             const backlogIssueUrl = `https://${options.domain}/view/${issue.issueKey}`;
-            // コメント一覧を取得
-            command.log(`課題 ${issue.issueKey} のコメントを取得しています...`);
-            const commentsParams = new URLSearchParams({
+            // コメントを取得する関数を呼び出し
+            // eslint-disable-next-line no-await-in-loop
+            const { comments: allComments } = await fetchAllCommentsForIssue({
                 apiKey: options.apiKey,
-                count: '100', // 最大100件のコメントを取得
-                order: 'asc', // 古い順に取得
+                baseUrl,
+                command,
+                issueKey: issue.issueKey,
+                rateLimiter,
             });
-            const comments = await ky.get(`${baseUrl}/issues/${issue.issueKey}/comments?${commentsParams.toString()}`).json();
             // コメントセクションを作成
             let commentsSection = '';
-            if (comments.length > 0) {
+            if (allComments.length > 0) {
                 commentsSection = '\n\n## コメント\n';
                 let commentIndex = 1;
-                for (const comment of comments) {
+                for (const comment of allComments) {
                     const commentDate = new Date(comment.created).toLocaleString('ja-JP');
                     commentsSection += `\n### コメント ${commentIndex}\n- **投稿者**: ${comment.createdUser.name}\n- **日時**: ${commentDate}\n\n${comment.content || '(内容なし)'}\n\n---\n`;
                     commentIndex++;
@@ -67,6 +103,16 @@ export async function downloadIssues(command, options) {
                 // 最後の区切り線を削除
                 commentsSection = commentsSection.slice(0, -5);
             }
+            // 課題の作成年を取得
+            const createdYear = new Date(issue.created).getFullYear();
+            // 年ごとのフォルダパスを作成
+            const yearDirPath = path.join(options.outputDir, createdYear.toString());
+            // 年ごとのフォルダを作成
+            // eslint-disable-next-line no-await-in-loop
+            await fs.mkdir(yearDirPath, { recursive: true });
+            // 年ごとのフォルダ内にMarkdownファイルを保存
+            const issueFileName = `${sanitizeFileName(issue.summary)}.md`;
+            const issueFilePath = path.join(yearDirPath, issueFileName);
             // Markdownファイルに書き込む
             const assigneeName = issue.assignee ? issue.assignee.name : '未割り当て';
             const markdownContent = `# ${issue.summary}
@@ -82,15 +128,43 @@ export async function downloadIssues(command, options) {
 
 ## 詳細
 ${issue.description || '詳細情報なし'}${commentsSection}`;
+            // eslint-disable-next-line no-await-in-loop
             await fs.writeFile(issueFilePath, markdownContent);
-            command.log(`課題 "${issue.issueKey}: ${issue.summary}" を ${issueFilePath} に保存しました`);
         }
         catch (error) {
             command.warn(`課題 ${issue.issueKey} の保存に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
         }
-    });
-    await Promise.all(issuePromises);
-    command.log('課題のダウンロードが完了しました！');
+    }
+    command.log('\n課題のダウンロードが完了しました！');
+}
+/**
+ * 課題のコメントを全て取得する
+ */
+async function fetchAllCommentsForIssue({ apiKey, baseUrl, command, issueKey, rateLimiter, }) {
+    const allComments = [];
+    const fetchComments = async (minId) => {
+        // APIリクエスト数をインクリメント
+        await rateLimiter.increment();
+        let url = `${baseUrl}/issues/${issueKey}/comments?apiKey=${apiKey}&count=100`;
+        if (minId) {
+            url += `&minId=${minId}`;
+        }
+        const comments = await ky.get(url).json();
+        allComments.push(...comments);
+        if (comments.length === 100) {
+            // 取得したコメントの最後のIDを次のリクエストのminIdとして使用
+            const lastCommentId = comments.at(-1).id;
+            await fetchComments(lastCommentId + 1);
+        }
+    };
+    try {
+        await fetchComments();
+        return { comments: allComments };
+    }
+    catch (error) {
+        command.warn(`課題 ${issueKey} のコメント取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
+        return { comments: allComments };
+    }
 }
 /**
  * BacklogからWikiをダウンロードする
@@ -100,8 +174,12 @@ ${issue.description || '詳細情報なし'}${commentsSection}`;
 export async function downloadWikis(command, options) {
     const baseUrl = `https://${options.domain}/api/v2`;
     command.log('Wikiの取得を開始します...');
+    // APIリクエスト数をカウントするためのRateLimiterを作成
+    const rateLimiter = new RateLimiter(command);
     // Wiki一覧の取得
     command.log('Wiki一覧を取得しています...');
+    // APIリクエスト数をインクリメント
+    await rateLimiter.increment();
     const wikis = await ky
         .get(`${baseUrl}/wikis?apiKey=${options.apiKey}&projectIdOrKey=${options.projectIdOrKey}`)
         .json();
@@ -122,11 +200,17 @@ export async function downloadWikis(command, options) {
     }
     // 各Wikiの詳細情報を取得
     command.log('Wiki詳細を取得しています...');
-    // Promise.allを使用して並列処理
-    const wikiPromises = filteredWikis.map(async (wiki) => {
+    // 並列処理ではなく順次処理に変更
+    for (const wiki of filteredWikis) {
         const wikiId = wiki.id;
-        command.log(`Wiki: ${wiki.name} (ID: ${wikiId}) を取得しています`);
         try {
+            // APIリクエスト数をインクリメント
+            // eslint-disable-next-line no-await-in-loop
+            await rateLimiter.increment();
+            // 進捗状況を一行で更新
+            const currentIndex = filteredWikis.indexOf(wiki) + 1;
+            process.stdout.write(`\rWikiを取得中... (${currentIndex}/${filteredWikis.length}件)`);
+            // eslint-disable-next-line no-await-in-loop
             const wikiDetail = await ky
                 .get(`${baseUrl}/wikis/${wikiId}?projectIdOrKey=${options.projectIdOrKey}&apiKey=${options.apiKey}`)
                 .json();
@@ -139,6 +223,7 @@ export async function downloadWikis(command, options) {
             // ディレクトリ構造を作成（必要な場合）
             const dirPath = path.dirname(wikiFileName);
             if (dirPath !== '.') {
+                // eslint-disable-next-line no-await-in-loop
                 await fs.mkdir(path.join(options.outputDir, dirPath), { recursive: true });
             }
             // Markdownファイルを保存
@@ -149,13 +234,15 @@ export async function downloadWikis(command, options) {
             const backlogWikiUrl = `https://${options.domain}/alias/wiki/${wikiId}`;
             // Markdownファイルに書き込む（タイトルとBacklogリンクを追加）
             const markdownContent = `# ${wiki.name}\n\n[Backlog Wiki Link](${backlogWikiUrl})\n\n${content}`;
+            // eslint-disable-next-line no-await-in-loop
             await fs.writeFile(wikiFilePath, markdownContent);
-            command.log(`Wiki "${wiki.name}" を ${wikiFilePath} に保存しました`);
+            // 進捗状況を一行で更新
+            const wikiIndex = filteredWikis.indexOf(wiki) + 1;
+            process.stdout.write(`\rWikiを保存中... (${wikiIndex}/${filteredWikis.length}件)`);
         }
         catch (error) {
-            command.warn(`Wiki ID ${wikiId} の取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
+            command.warn(`Wiki ${wiki.name} の取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
         }
-    });
-    await Promise.all(wikiPromises);
-    command.log('Wikiのダウンロードが完了しました！');
+    }
+    command.log('\nWikiのダウンロードが完了しました！');
 }

package/dist/utils/sleep.d.ts

@@ -0,0 +1,28 @@
+import { Command } from '@oclif/core';
+/**
+ * 指定したミリ秒だけ待機する
+ * @param ms 待機時間（ミリ秒）
+ */
+export declare const sleep: (ms: number) => Promise<void>;
+/**
+ * APIリクエストのレート制限対策のためのユーティリティ
+ * 100リクエストごとに15秒間待機する
+ */
+export declare class RateLimiter {
+    private readonly command;
+    private requestCount;
+    constructor(command: Command);
+    /**
+     * 現在のリクエスト数を取得する
+     */
+    getCount(): number;
+    /**
+     * APIリクエストをカウントし、必要に応じて待機する
+     * @returns 現在のリクエスト数
+     */
+    increment(): Promise<number>;
+    /**
+     * リクエスト数を設定する
+     */
+    setCount(count: number): void;
+}

package/dist/utils/sleep.js

@@ -0,0 +1,42 @@
+/**
+ * 指定したミリ秒だけ待機する
+ * @param ms 待機時間（ミリ秒）
+ */
+export const sleep = (ms) => new Promise((resolve) => {
+    setTimeout(resolve, ms);
+});
+/**
+ * APIリクエストのレート制限対策のためのユーティリティ
+ * 100リクエストごとに15秒間待機する
+ */
+export class RateLimiter {
+    command;
+    requestCount = 0;
+    constructor(command) {
+        this.command = command;
+    }
+    /**
+     * 現在のリクエスト数を取得する
+     */
+    getCount() {
+        return this.requestCount;
+    }
+    /**
+     * APIリクエストをカウントし、必要に応じて待機する
+     * @returns 現在のリクエスト数
+     */
+    async increment() {
+        this.requestCount++;
+        if (this.requestCount > 1 && this.requestCount % 100 === 0) {
+            this.command.log('レート制限を回避するため15秒間待機します...');
+            await sleep(15_000);
+        }
+        return this.requestCount;
+    }
+    /**
+     * リクエスト数を設定する
+     */
+    setCount(count) {
+        this.requestCount = count;
+    }
+}

package/oclif.manifest.json

@@ -6,7 +6,8 @@
       "description": "Backlogから課題とWikiを取得してMarkdownファイルとして保存する",
       "examples": [
         "<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY\n課題とWikiをMarkdownファイルとして保存する\n",
-        "<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-project\n指定したディレクトリに課題とWikiを保存する\n"
+        "<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-project\n指定したディレクトリに課題とWikiを保存する\n",
+        "<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --maxCount 1000\n最大1000件の課題を取得する（デフォルトは100件）\n"
       ],
       "flags": {
         "apiKey": {
@@ -25,6 +26,16 @@
           "multiple": false,
           "type": "option"
         },
+        "maxCount": {
+          "char": "m",
+          "description": "一度に取得する課題の最大数（デフォルト: 5000）",
+          "name": "maxCount",
+          "required": false,
+          "default": 5000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "output": {
           "char": "o",
           "description": "出力ディレクトリパス",
@@ -65,7 +76,9 @@
       "description": "Backlogから課題を取得してMarkdownファイルとして保存する",
       "examples": [
         "<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY\n課題をMarkdownファイルとして保存する\n",
-        "<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-project\n指定したディレクトリに課題を保存する\n"
+        "<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-issues\n指定したディレクトリに課題を保存する\n",
+        "<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --statusId 1,2,3\n指定したステータスIDの課題のみを取得する\n",
+        "<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --maxCount 10000\n最大10000件の課題を取得する（デフォルトは5000件）\n"
       ],
       "flags": {
         "apiKey": {
@@ -84,6 +97,16 @@
           "multiple": false,
           "type": "option"
         },
+        "maxCount": {
+          "char": "m",
+          "description": "一度に取得する課題の最大数（デフォルト: 5000）",
+          "name": "maxCount",
+          "required": false,
+          "default": 5000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "output": {
           "char": "o",
           "description": "出力ディレクトリパス",
@@ -100,6 +123,14 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "statusId": {
+          "description": "ステータスID（カンマ区切りで複数指定可能）",
+          "name": "statusId",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -258,5 +289,5 @@
       ]
     }
   },
-  "version": "0.2.0"
+  "version": "0.2.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "backlog-exporter",
   "description": "A new CLI generated with oclif",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "author": "ShuntaToda",
   "bin": {
     "backlog-exporter": "bin/run.js"