backlog-exporter 0.1.1 → 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.1.1 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.1.1/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.1.1/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.1.1/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.1.1/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,31 +62,48 @@ export default class All extends Command {
             // Wikiの出力ディレクトリ
             const wikiOutput = path.join(outputRoot, 'wiki');
             await createOutputDirectory(wikiOutput);
-            // 課題の取得と保存
-            this.log('課題の取得を開始します...');
-            await downloadIssues(this, domain, projectId, apiKey, issueOutput, 100);
             // 課題フォルダに設定ファイルを保存
             await updateSettings(issueOutput, {
                 apiKey,
                 domain,
                 folderType: FolderType.ISSUE,
-                lastUpdated: new Date().toISOString(),
                 outputDir: issueOutput,
                 projectIdOrKey,
             });
-            this.log('課題の取得が完了しました');
-            // Wikiの取得と保存
-            this.log('Wikiの取得を開始します...');
-            await downloadWikis(this, domain, projectIdOrKey, apiKey, wikiOutput);
             // Wikiフォルダに設定ファイルを保存
             await updateSettings(wikiOutput, {
                 apiKey,
                 domain,
                 folderType: FolderType.WIKI,
+                outputDir: wikiOutput,
+                projectIdOrKey,
+            });
+            // 課題の取得と保存
+            this.log('課題の取得を開始します...');
+            await downloadIssues(this, {
+                apiKey,
+                count: maxCount,
+                domain,
+                outputDir: issueOutput,
+                projectId,
+            });
+            // 課題フォルダの最終更新日時を更新
+            await updateSettings(issueOutput, {
                 lastUpdated: new Date().toISOString(),
+            });
+            this.log('課題の取得が完了しました');
+            // Wikiの取得と保存
+            this.log('Wikiの取得を開始します...');
+            await downloadWikis(this, {
+                apiKey,
+                domain,
                 outputDir: wikiOutput,
                 projectIdOrKey,
             });
+            // Wikiフォルダの最終更新日時を更新
+            await updateSettings(wikiOutput, {
+                lastUpdated: new Date().toISOString(),
+            });
             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,29 +46,43 @@ 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 downloadIssues(this, domain, projectId, apiKey, outputDir, 100);
             // 設定ファイルを保存
             await updateSettings(outputDir, {
                 apiKey,
                 domain,
                 folderType: FolderType.ISSUE,
-                lastUpdated: new Date().toISOString(),
                 outputDir,
                 projectIdOrKey,
             });
+            // 課題の取得と保存
+            await downloadIssues(this, {
+                apiKey,
+                count: maxCount,
+                domain,
+                outputDir,
+                projectId,
+                statusId,
+            });
+            // 最終更新日時を更新
+            await updateSettings(outputDir, {
+                lastUpdated: new Date().toISOString(),
+            });
             this.log('課題の取得が完了しました！');
         }
         catch (error) {

package/dist/commands/update/index.js

@@ -207,7 +207,16 @@ export default class Update extends Command {
     // 課題の更新
     async updateIssues(options) {
         this.log('課題の更新を開始します...');
-        await downloadIssues(this, options.domain, options.projectId, options.apiKey, options.targetDir, 100);
+        // 設定ファイルから前回の更新日時を取得
+        const { lastUpdated } = await loadSettings(options.targetDir);
+        await downloadIssues(this, {
+            apiKey: options.apiKey,
+            count: 100,
+            domain: options.domain,
+            lastUpdated,
+            outputDir: options.targetDir,
+            projectId: options.projectId,
+        });
         // 設定ファイルを更新
         await updateSettings(options.targetDir, {
             apiKey: options.apiKey,
@@ -222,7 +231,15 @@ export default class Update extends Command {
     // Wikiの更新
     async updateWikis(options) {
         this.log('Wikiの更新を開始します...');
-        await downloadWikis(this, options.domain, options.projectIdOrKey, options.apiKey, options.targetDir);
+        // 設定ファイルから前回の更新日時を取得
+        const { lastUpdated } = await loadSettings(options.targetDir);
+        await downloadWikis(this, {
+            apiKey: options.apiKey,
+            domain: options.domain,
+            lastUpdated,
+            outputDir: options.targetDir,
+            projectIdOrKey: options.projectIdOrKey,
+        });
         // 設定ファイルを更新
         await updateSettings(options.targetDir, {
             apiKey: options.apiKey,

package/dist/commands/wiki/index.js

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

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

@@ -2,20 +2,26 @@ import { Command } from '@oclif/core';
 /**
  * Backlogから課題をダウンロードする
  * @param command コマンドインスタンス
- * @param domain Backlogドメイン
- * @param projectId プロジェクトID
- * @param apiKey APIキー
- * @param outputDir 出力ディレクトリ
- * @param count 一度に取得する課題数
- * @param statusId ステータスID（オプション）
+ * @param options 課題ダウンロードのオプション
  */
-export declare function downloadIssues(command: Command, domain: string, projectId: number, apiKey: string, outputDir: string, count: number, statusId?: string): Promise<void>;
+export declare function downloadIssues(command: Command, options: {
+    apiKey: string;
+    count?: number;
+    domain: string;
+    lastUpdated?: string;
+    outputDir: string;
+    projectId: number;
+    statusId?: string;
+}): Promise<void>;
 /**
  * BacklogからWikiをダウンロードする
  * @param command コマンドインスタンス
- * @param domain Backlogドメイン
- * @param projectIdOrKey プロジェクトIDまたはキー
- * @param apiKey APIキー
- * @param outputDir 出力ディレクトリ
+ * @param options Wikiダウンロードのオプション
  */
-export declare function downloadWikis(command: Command, domain: string, projectIdOrKey: string, apiKey: string, outputDir: string): Promise<void>;
+export declare function downloadWikis(command: Command, options: {
+    apiKey: string;
+    domain: string;
+    lastUpdated?: string;
+    outputDir: string;
+    projectIdOrKey: string;
+}): Promise<void>;

package/dist/utils/backlog-api.js

@@ -1,56 +1,101 @@
 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 コマンドインスタンス
- * @param domain Backlogドメイン
- * @param projectId プロジェクトID
- * @param apiKey APIキー
- * @param outputDir 出力ディレクトリ
- * @param count 一度に取得する課題数
- * @param statusId ステータスID（オプション）
+ * @param options 課題ダウンロードのオプション
  */
-export async function downloadIssues(command, domain, projectId, apiKey, outputDir, count, statusId) {
-    const baseUrl = `https://${domain}/api/v2`;
+export async function downloadIssues(command, options) {
+    const baseUrl = `https://${options.domain}/api/v2`;
     command.log('課題の取得を開始します...');
-    // APIパラメータの構築
-    const params = new URLSearchParams({
-        apiKey,
-        count: count.toString(),
-        'projectId[]': projectId.toString(),
-    });
-    // ステータスIDが指定されている場合は追加
-    if (statusId) {
-        params.append('statusId[]', statusId);
+    // 全ての課題を格納する配列
+    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 = allIssues;
+    if (options.lastUpdated) {
+        const lastUpdatedDate = new Date(options.lastUpdated);
+        filteredIssues = allIssues.filter((issue) => {
+            const issueUpdatedDate = new Date(issue.updated);
+            return issueUpdatedDate > lastUpdatedDate;
+        });
+        command.log(`前回の更新日時(${options.lastUpdated})以降に更新された${filteredIssues.length}件の課題を処理します。`);
+    }
+    if (filteredIssues.length === 0) {
+        command.log('更新が必要な課題はありません。');
+        return;
     }
-    const issues = await ky.get(`${baseUrl}/issues?${params.toString()}`).json();
-    command.log(`${issues.length}件の課題が見つかりました。`);
     // 各課題の詳細情報を取得して保存
     command.log('課題を保存しています...');
-    // Promise.allを使用して並列処理
-    const issuePromises = issues.map(async (issue) => {
+    // 並列処理ではなく順次処理に変更
+    for (const issue of filteredIssues) {
         try {
-            // 課題の詳細情報をJSONファイルとして保存
-            const issueFileName = `${sanitizeFileName(issue.summary)}.md`;
-            const issueFilePath = path.join(outputDir, issueFileName);
+            // 進捗状況を一行で更新
+            const currentIndex = filteredIssues.indexOf(issue) + 1;
+            process.stdout.write(`\r課題を保存中... (${currentIndex}/${filteredIssues.length}件)`);
             // BacklogのIssueへのリンクを作成
-            const backlogIssueUrl = `https://${domain}/view/${issue.issueKey}`;
-            // コメント一覧を取得
-            command.log(`課題 ${issue.issueKey} のコメントを取得しています...`);
-            const commentsParams = new URLSearchParams({
-                apiKey,
-                count: '100', // 最大100件のコメントを取得
-                order: 'asc', // 古い順に取得
+            const backlogIssueUrl = `https://${options.domain}/view/${issue.issueKey}`;
+            // コメントを取得する関数を呼び出し
+            // eslint-disable-next-line no-await-in-loop
+            const { comments: allComments } = await fetchAllCommentsForIssue({
+                apiKey: options.apiKey,
+                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++;
@@ -58,6 +103,16 @@ export async function downloadIssues(command, domain, projectId, apiKey, outputD
                 // 最後の区切り線を削除
                 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}
@@ -73,42 +128,91 @@ export async function downloadIssues(command, domain, projectId, apiKey, outputD
 
 ## 詳細
 ${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をダウンロードする
  * @param command コマンドインスタンス
- * @param domain Backlogドメイン
- * @param projectIdOrKey プロジェクトIDまたはキー
- * @param apiKey APIキー
- * @param outputDir 出力ディレクトリ
+ * @param options Wikiダウンロードのオプション
  */
-export async function downloadWikis(command, domain, projectIdOrKey, apiKey, outputDir) {
-    const baseUrl = `https://${domain}/api/v2`;
+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=${apiKey}&projectIdOrKey=${projectIdOrKey}`)
+        .get(`${baseUrl}/wikis?apiKey=${options.apiKey}&projectIdOrKey=${options.projectIdOrKey}`)
         .json();
     command.log(`${wikis.length}件のWikiが見つかりました。`);
+    // 前回の更新日時より新しいWikiのみをフィルタリング
+    let filteredWikis = wikis;
+    if (options.lastUpdated) {
+        const lastUpdatedDate = new Date(options.lastUpdated);
+        filteredWikis = wikis.filter((wiki) => {
+            const wikiUpdatedDate = new Date(wiki.updated);
+            return wikiUpdatedDate > lastUpdatedDate;
+        });
+        command.log(`前回の更新日時(${options.lastUpdated})以降に更新された${filteredWikis.length}件のWikiを処理します。`);
+    }
+    if (filteredWikis.length === 0) {
+        command.log('更新が必要なWikiはありません。');
+        return;
+    }
     // 各Wikiの詳細情報を取得
     command.log('Wiki詳細を取得しています...');
-    // Promise.allを使用して並列処理
-    const wikiPromises = wikis.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=${projectIdOrKey}&apiKey=${apiKey}`)
+                .get(`${baseUrl}/wikis/${wikiId}?projectIdOrKey=${options.projectIdOrKey}&apiKey=${options.apiKey}`)
                 .json();
             // Wikiの名前をファイルパスとして使用
             const wikiName = wiki.name;
@@ -119,23 +223,26 @@ export async function downloadWikis(command, domain, projectIdOrKey, apiKey, out
             // ディレクトリ構造を作成（必要な場合）
             const dirPath = path.dirname(wikiFileName);
             if (dirPath !== '.') {
-                await fs.mkdir(path.join(outputDir, dirPath), { recursive: true });
+                // eslint-disable-next-line no-await-in-loop
+                await fs.mkdir(path.join(options.outputDir, dirPath), { recursive: true });
             }
             // Markdownファイルを保存
-            const wikiFilePath = path.join(outputDir, wikiFileName);
+            const wikiFilePath = path.join(options.outputDir, wikiFileName);
             // JSONからcontentフィールドを取得
             const content = wikiDetail.content || '';
             // BacklogのWikiへのリンクを作成
-            const backlogWikiUrl = `https://${domain}/alias/wiki/${wikiId}`;
+            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": "出力ディレクトリパス",
@@ -59,21 +70,15 @@
         "index.js"
       ]
     },
-    "update": {
+    "issue": {
       "aliases": [],
-      "args": {
-        "directory": {
-          "description": "更新対象のディレクトリ（設定ファイルが保存されている場所）",
-          "name": "directory",
-          "required": false
-        }
-      },
-      "description": "Backlogから最新データを取得して更新する",
+      "args": {},
+      "description": "Backlogから課題を取得してMarkdownファイルとして保存する",
       "examples": [
-        "<%= config.bin %> <%= command.id %>\nカレントディレクトリの設定を使用して更新する\n",
-        "<%= config.bin %> <%= command.id %> --force\n確認プロンプトをスキップする\n",
-        "<%= config.bin %> <%= command.id %> --apiKey YOUR_API_KEY --domain example.backlog.jp --projectIdOrKey PROJECT_KEY\n指定したパラメータで更新する（設定ファイルが存在する場合は上書きされます）\n",
-        "<%= config.bin %> <%= command.id %> ./my-project\n指定したディレクトリの設定を使用して更新する\n"
+        "<%= 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-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": {
@@ -87,45 +92,50 @@
         "domain": {
           "description": "Backlog domain (e.g. example.backlog.jp)",
           "name": "domain",
-          "required": false,
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "force": {
-          "char": "f",
-          "description": "確認プロンプトをスキップする",
-          "name": "force",
+        "maxCount": {
+          "char": "m",
+          "description": "一度に取得する課題の最大数（デフォルト: 5000）",
+          "name": "maxCount",
           "required": false,
-          "allowNo": false,
-          "type": "boolean"
+          "default": 5000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "issuesOnly": {
-          "description": "課題のみを更新する",
-          "name": "issuesOnly",
+        "output": {
+          "char": "o",
+          "description": "出力ディレクトリパス",
+          "name": "output",
           "required": false,
-          "allowNo": false,
-          "type": "boolean"
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
         "projectIdOrKey": {
           "description": "Backlog project ID or key",
           "name": "projectIdOrKey",
-          "required": false,
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "wikisOnly": {
-          "description": "Wikiのみを更新する",
-          "name": "wikisOnly",
+        "statusId": {
+          "description": "ステータスID（カンマ区切りで複数指定可能）",
+          "name": "statusId",
           "required": false,
-          "allowNo": false,
-          "type": "boolean"
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "update",
+      "id": "issue",
       "pluginAlias": "backlog-exporter",
       "pluginName": "backlog-exporter",
       "pluginType": "core",
@@ -135,17 +145,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "update",
+        "issue",
         "index.js"
       ]
     },
-    "issue": {
+    "update": {
       "aliases": [],
-      "args": {},
-      "description": "Backlogから課題を取得してMarkdownファイルとして保存する",
+      "args": {
+        "directory": {
+          "description": "更新対象のディレクトリ（設定ファイルが保存されている場所）",
+          "name": "directory",
+          "required": false
+        }
+      },
+      "description": "Backlogから最新データを取得して更新する",
       "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 %>\nカレントディレクトリの設定を使用して更新する\n",
+        "<%= config.bin %> <%= command.id %> --force\n確認プロンプトをスキップする\n",
+        "<%= config.bin %> <%= command.id %> --apiKey YOUR_API_KEY --domain example.backlog.jp --projectIdOrKey PROJECT_KEY\n指定したパラメータで更新する（設定ファイルが存在する場合は上書きされます）\n",
+        "<%= config.bin %> <%= command.id %> ./my-project\n指定したディレクトリの設定を使用して更新する\n"
       ],
       "flags": {
         "apiKey": {
@@ -159,32 +177,45 @@
         "domain": {
           "description": "Backlog domain (e.g. example.backlog.jp)",
           "name": "domain",
-          "required": true,
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "output": {
-          "char": "o",
-          "description": "出力ディレクトリパス",
-          "name": "output",
+        "force": {
+          "char": "f",
+          "description": "確認プロンプトをスキップする",
+          "name": "force",
           "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "issuesOnly": {
+          "description": "課題のみを更新する",
+          "name": "issuesOnly",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
         },
         "projectIdOrKey": {
           "description": "Backlog project ID or key",
           "name": "projectIdOrKey",
-          "required": true,
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "wikisOnly": {
+          "description": "Wikiのみを更新する",
+          "name": "wikisOnly",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "issue",
+      "id": "update",
       "pluginAlias": "backlog-exporter",
       "pluginName": "backlog-exporter",
       "pluginType": "core",
@@ -194,7 +225,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "issue",
+        "update",
         "index.js"
       ]
     },
@@ -258,5 +289,5 @@
       ]
     }
   },
-  "version": "0.1.1"
+  "version": "0.2.1"
 }

package/package.json

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