backlog-exporter 0.0.6 → 0.1.0

package/README.md

@@ -14,11 +14,31 @@ Backlog のデータをエクスポートするためのコマンドラインツ
 * [課題のエクスポート](#課題のエクスポート)
 * [Wikiのエクスポート](#wikiのエクスポート)
 * [課題とWikiの一括エクスポート](#課題とwikiの一括エクスポート)
+* [データの更新](#データの更新)
+* [npxを使った課題のエクスポート](#npxを使った課題のエクスポート)
+* [npxを使ったデータの更新](#npxを使ったデータの更新)
+* [課題のエクスポート](#課題のエクスポート)
+* [基本的な使用方法](#基本的な使用方法)
+* [出力先を指定](#出力先を指定)
+* [Wiki のエクスポート](#wiki-のエクスポート)
+* [基本的な使用方法](#基本的な使用方法)
+* [出力先を指定](#出力先を指定)
+* [課題と Wiki の一括エクスポート](#課題と-wiki-の一括エクスポート)
+* [基本的な使用方法](#基本的な使用方法)
+* [出力先を指定](#出力先を指定)
+* [データの更新](#データの更新)
+* [カレントディレクトリとそのサブディレクトリのデータを更新](#カレントディレクトリとそのサブディレクトリのデータを更新)
+* [指定したディレクトリとそのサブディレクトリのデータを更新](#指定したディレクトリとそのサブディレクトリのデータを更新)
+* [確認プロンプトをスキップして更新](#確認プロンプトをスキップして更新)
+* [課題のみを更新](#課題のみを更新)
+* [Wikiのみを更新](#wikiのみを更新)
+* [APIキーを指定して更新](#apiキーを指定して更新)
 * [コマンド](#コマンド)
 * [出力形式](#出力形式)
 * [課題のタイトル](#課題のタイトル)
 * [Wiki のタイトル](#wiki-のタイトル)
 * [その他の特徴](#その他の特徴)
+* [最近の変更点](#最近の変更点)
 <!-- tocstop -->
 
 # 概要
@@ -29,6 +49,7 @@ backlog-exporter は、Backlog のデータをローカルにエクスポート
 - **課題（Issue）のエクスポート**：Backlog の課題を Markdown ファイルとして保存
 - **Wiki 記事のエクスポート**：Backlog の Wiki 記事を Markdown ファイルとして保存
 - **一括エクスポート**：課題と Wiki を同時に取得する機能
+- **データの更新**：既存のエクスポートデータを最新の状態に更新する機能
 
 # インストール
 
@@ -38,7 +59,7 @@ $ npm install -g backlog-exporter
 $ backlog-exporter COMMAND
 running command...
 $ backlog-exporter (--version)
-backlog-exporter/0.0.6 linux-x64 node-v23.9.0
+backlog-exporter/0.1.0 linux-x64 node-v23.9.0
 $ backlog-exporter --help [COMMAND]
 USAGE
   $ backlog-exporter COMMAND
@@ -67,99 +88,134 @@ $ backlog-exporter wiki --domain example.backlog.jp --projectIdOrKey PROJECT_KEY
 
 # 課題とWikiの一括エクスポート
 $ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./backlog-data
+
+# データの更新
+$ backlog-exporter update
 ```
 
-# コマンド
+npx を使用する場合は、コマンドの前に`npx`を付けるだけです：
 
-<!-- commands -->
-* [`backlog-exporter all [URL]`](#backlog-exporter-all-url)
-* [`backlog-exporter hello PERSON`](#backlog-exporter-hello-person)
-* [`backlog-exporter hello world`](#backlog-exporter-hello-world)
-* [`backlog-exporter help [COMMAND]`](#backlog-exporter-help-command)
-* [`backlog-exporter issue [URL]`](#backlog-exporter-issue-url)
-* [`backlog-exporter plugins`](#backlog-exporter-plugins)
-* [`backlog-exporter plugins add PLUGIN`](#backlog-exporter-plugins-add-plugin)
-* [`backlog-exporter plugins:inspect PLUGIN...`](#backlog-exporter-pluginsinspect-plugin)
-* [`backlog-exporter plugins install PLUGIN`](#backlog-exporter-plugins-install-plugin)
-* [`backlog-exporter plugins link PATH`](#backlog-exporter-plugins-link-path)
-* [`backlog-exporter plugins remove [PLUGIN]`](#backlog-exporter-plugins-remove-plugin)
-* [`backlog-exporter plugins reset`](#backlog-exporter-plugins-reset)
-* [`backlog-exporter plugins uninstall [PLUGIN]`](#backlog-exporter-plugins-uninstall-plugin)
-* [`backlog-exporter plugins unlink [PLUGIN]`](#backlog-exporter-plugins-unlink-plugin)
-* [`backlog-exporter plugins update`](#backlog-exporter-plugins-update)
-* [`backlog-exporter wiki [URL]`](#backlog-exporter-wiki-url)
+```sh
+# npxを使った課題のエクスポート
+$ npx backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./issues
 
-## `backlog-exporter all [URL]`
+# npxを使ったデータの更新
+$ npx backlog-exporter update
+```
 
-Backlogからissueとwikiを同時に取得する
+# 課題のエクスポート
 
+`issue`コマンドを使用すると、Backlog の課題を Markdown ファイルとしてエクスポートできます。
+
+```sh
+# 基本的な使用方法
+$ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY
+
+# 出力先を指定
+$ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./issues
 ```
-USAGE
-  $ backlog-exporter all [URL] --domain <value> --projectIdOrKey <value> [--apiKey <value>] [-c <value>]
-    [-o <value>] [--statusId <value>]
 
-ARGUMENTS
-  URL  URL to download from
+エクスポートされた課題は、指定したディレクトリ内に Markdown ファイルとして保存されます。ファイル名は課題のキーに基づいて自動的に生成されます。
 
-FLAGS
-  -c, --count=<value>           [default: 100] 一度に取得する課題数
-  -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>        Filter issues by status ID
+# Wiki のエクスポート
 
-DESCRIPTION
-  Backlogからissueとwikiを同時に取得する
+`wiki`コマンドを使用すると、Backlog の Wiki ページを Markdown ファイルとしてエクスポートできます。
 
-EXAMPLES
-  $ backlog-exporter all --domain cm1.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY -o ./output-dir
-  BacklogからAPIキーを使用してissueとwikiを同時に取得する
+```sh
+# 基本的な使用方法
+$ backlog-exporter wiki --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY
+
+# 出力先を指定
+$ backlog-exporter wiki --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./wiki
 ```
 
-_See code: [src/commands/all/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.0.6/src/commands/all/index.ts)_
+エクスポートされた Wiki は、指定したディレクトリ内に Markdown ファイルとして保存されます。Wiki の階層構造は保持され、ディレクトリ構造として再現されます。
+
+# 課題と Wiki の一括エクスポート
 
-## `backlog-exporter hello PERSON`
+`all`コマンドを使用すると、課題と Wiki を一度に取得できます。
 
-Say hello
+```sh
+# 基本的な使用方法
+$ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY
 
+# 出力先を指定
+$ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./backlog-data
 ```
-USAGE
-  $ backlog-exporter hello PERSON -f <value>
 
-ARGUMENTS
-  PERSON  Person to say hello to
+一括エクスポートでは、課題は`issues`ディレクトリに、Wiki は`wiki`ディレクトリに保存されます。
 
-FLAGS
-  -f, --from=<value>  (required) Who is saying hello
+# データの更新
 
-DESCRIPTION
-  Say hello
+`update`コマンドを使用すると、既存のエクスポートデータを最新の状態に更新できます。このコマンドは、ディレクトリ内の`backlog-settings.json`ファイルを探索し、見つかったディレクトリでデータを更新します。
 
-EXAMPLES
-  $ backlog-exporter hello friend --from oclif
-  hello friend from oclif! (./src/commands/hello/index.ts)
+```sh
+# カレントディレクトリとそのサブディレクトリのデータを更新
+$ backlog-exporter update
+
+# 指定したディレクトリとそのサブディレクトリのデータを更新
+$ backlog-exporter update ./my-project
+
+# 確認プロンプトをスキップして更新
+$ backlog-exporter update --force
+
+# 課題のみを更新
+$ backlog-exporter update --issuesOnly
+
+# Wikiのみを更新
+$ backlog-exporter update --wikisOnly
+
+# APIキーを指定して更新
+$ backlog-exporter update --apiKey YOUR_API_KEY
 ```
 
-_See code: [src/commands/hello/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.0.6/src/commands/hello/index.ts)_
+更新コマンドは、各ディレクトリの設定ファイルに基づいて、課題や Wiki を自動的に更新します。設定ファイルが見つかったディレクトリでは、そのディレクトリ内のファイルが直接更新されます（サブフォルダは作成されません）。
 
-## `backlog-exporter hello world`
+# コマンド
 
-Say hello world
+<!-- commands -->
+* [`backlog-exporter all`](#backlog-exporter-all)
+* [`backlog-exporter help [COMMAND]`](#backlog-exporter-help-command)
+* [`backlog-exporter issue`](#backlog-exporter-issue)
+* [`backlog-exporter plugins`](#backlog-exporter-plugins)
+* [`backlog-exporter plugins add PLUGIN`](#backlog-exporter-plugins-add-plugin)
+* [`backlog-exporter plugins:inspect PLUGIN...`](#backlog-exporter-pluginsinspect-plugin)
+* [`backlog-exporter plugins install PLUGIN`](#backlog-exporter-plugins-install-plugin)
+* [`backlog-exporter plugins link PATH`](#backlog-exporter-plugins-link-path)
+* [`backlog-exporter plugins remove [PLUGIN]`](#backlog-exporter-plugins-remove-plugin)
+* [`backlog-exporter plugins reset`](#backlog-exporter-plugins-reset)
+* [`backlog-exporter plugins uninstall [PLUGIN]`](#backlog-exporter-plugins-uninstall-plugin)
+* [`backlog-exporter plugins unlink [PLUGIN]`](#backlog-exporter-plugins-unlink-plugin)
+* [`backlog-exporter plugins update`](#backlog-exporter-plugins-update)
+* [`backlog-exporter update [DIRECTORY]`](#backlog-exporter-update-directory)
+* [`backlog-exporter wiki`](#backlog-exporter-wiki)
+
+## `backlog-exporter all`
+
+Backlogから課題とWikiを取得してMarkdownファイルとして保存する
 
 ```
 USAGE
-  $ backlog-exporter hello world
+  $ backlog-exporter all --domain <value> --projectIdOrKey <value> [--apiKey <value>] [-o <value>]
+
+FLAGS
+  -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
 
 DESCRIPTION
-  Say hello world
+  Backlogから課題とWikiを取得してMarkdownファイルとして保存する
 
 EXAMPLES
-  $ backlog-exporter hello world
-  hello world! (./src/commands/hello/world.ts)
+  $ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY
+  課題とWikiをMarkdownファイルとして保存する
+
+  $ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-project
+  指定したディレクトリに課題とWikiを保存する
 ```
 
-_See code: [src/commands/hello/world.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.0.6/src/commands/hello/world.ts)_
+_See code: [src/commands/all/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.1.0/src/commands/all/index.ts)_
 
 ## `backlog-exporter help [COMMAND]`
 
@@ -181,35 +237,32 @@ DESCRIPTION
 
 _See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.26/src/commands/help.ts)_
 
-## `backlog-exporter issue [URL]`
+## `backlog-exporter issue`
 
-Backlogから課題をダウンロードする
+Backlogから課題を取得してMarkdownファイルとして保存する
 
 ```
 USAGE
-  $ backlog-exporter issue [URL] --domain <value> --projectIdOrKey <value> [--apiKey <value>] [-c <value>]
-    [-o <value>] [--statusId <value>]
-
-ARGUMENTS
-  URL  URL to download from
+  $ backlog-exporter issue --domain <value> --projectIdOrKey <value> [--apiKey <value>] [-o <value>]
 
 FLAGS
-  -c, --count=<value>           [default: 100] 一度に取得する課題数
-  -o, --output=<value>          [default: ./backlog-issues] 出力ディレクトリパス
+  -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>        Filter issues by status ID
 
 DESCRIPTION
-  Backlogから課題をダウンロードする
+  Backlogから課題を取得してMarkdownファイルとして保存する
 
 EXAMPLES
-  $ backlog-exporter issue --domain cm1.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./issue-data
-  BacklogからAPIキーを使用して課題をダウンロードする
+  $ 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
+  指定したディレクトリに課題を保存する
 ```
 
-_See code: [src/commands/issue/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.0.6/src/commands/issue/index.ts)_
+_See code: [src/commands/issue/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.1.0/src/commands/issue/index.ts)_
 
 ## `backlog-exporter plugins`
 
@@ -501,32 +554,71 @@ DESCRIPTION
 
 _See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.34/src/commands/plugins/update.ts)_
 
-## `backlog-exporter wiki [URL]`
+## `backlog-exporter update [DIRECTORY]`
 
-BacklogからWikiコンテンツをダウンロードする
+Backlogから最新データを取得して更新する
 
 ```
 USAGE
-  $ backlog-exporter wiki [URL] --domain <value> --projectIdOrKey <value> [--apiKey <value>] [-o <value>]
+  $ backlog-exporter update [DIRECTORY] [--apiKey <value>] [--domain <value>] [-f] [--issuesOnly]
+    [--projectIdOrKey <value>] [--wikisOnly]
 
 ARGUMENTS
-  URL  URL to download from
+  DIRECTORY  更新対象のディレクトリ（設定ファイルが保存されている場所）
 
 FLAGS
-  -o, --output=<value>          [default: ./backlog-wiki] 出力ディレクトリパス
+  -f, --force                   確認プロンプトをスキップする
+      --apiKey=<value>          Backlog API key (環境変数 BACKLOG_API_KEY からも自動読み取り可能)
+      --domain=<value>          Backlog domain (e.g. example.backlog.jp)
+      --issuesOnly              課題のみを更新する
+      --projectIdOrKey=<value>  Backlog project ID or key
+      --wikisOnly               Wikiのみを更新する
+
+DESCRIPTION
+  Backlogから最新データを取得して更新する
+
+EXAMPLES
+  $ backlog-exporter update
+  カレントディレクトリの設定を使用して更新する
+
+  $ backlog-exporter update --force
+  確認プロンプトをスキップする
+
+  $ backlog-exporter update --apiKey YOUR_API_KEY --domain example.backlog.jp --projectIdOrKey PROJECT_KEY
+  指定したパラメータで更新する（設定ファイルが存在する場合は上書きされます）
+
+  $ backlog-exporter update ./my-project
+  指定したディレクトリの設定を使用して更新する
+```
+
+_See code: [src/commands/update/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.1.0/src/commands/update/index.ts)_
+
+## `backlog-exporter wiki`
+
+Backlogから Wiki を取得してMarkdownファイルとして保存する
+
+```
+USAGE
+  $ backlog-exporter wiki --domain <value> --projectIdOrKey <value> [--apiKey <value>] [-o <value>]
+
+FLAGS
+  -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
 
 DESCRIPTION
-  BacklogからWikiコンテンツをダウンロードする
+  Backlogから Wiki を取得してMarkdownファイルとして保存する
 
 EXAMPLES
-  $ backlog-exporter wiki --domain cm1.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./wiki-data
-  BacklogからAPIキーを使用してWikiコンテンツをダウンロードする
+  $ backlog-exporter wiki --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY
+  Wikiをダウンロードする
+
+  $ backlog-exporter wiki --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-project
+  指定したディレクトリにWikiを保存する
 ```
 
-_See code: [src/commands/wiki/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.0.6/src/commands/wiki/index.ts)_
+_See code: [src/commands/wiki/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.1.0/src/commands/wiki/index.ts)_
 <!-- commandsstop -->
 
 # 出力形式
@@ -591,3 +683,16 @@ Backlog の書式がそのまま保持されます。
 - **並列処理**: 並列処理による高速なダウンロード
 - **ファイル名サニタイズ**: ファイル名の自動サニタイズ（不正な文字の除去）
 - **階層構造の保持**: Wiki の階層構造を保持したエクスポート
+
+# 最近の変更点
+
+## 2023-07-XX - v0.0.7
+
+- `update`コマンドの改善：
+  - ディレクトリ内の`backlog-settings.json`ファイルを再帰的に探索し、見つかったディレクトリでデータを更新
+  - 親フォルダ内のファイルを直接上書きするように変更（サブフォルダを作成しない）
+  - コードの改善：メソッドのパラメータをオブジェクト形式に変更し、コードの可読性を向上
+  - 確認プロンプトの追加：更新前に確認メッセージを表示し、ユーザーの承認を得るように変更
+- ドキュメントの改善：
+  - README に各コマンドの詳細な説明を追加
+  - `npx`を使った実行方法の説明を追加

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

@@ -1,17 +1,12 @@
 import { Command } from '@oclif/core';
-export default class DownloadAll extends Command {
-    static args: {
-        url: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
-    };
+export default class All extends Command {
     static description: string;
     static examples: string[];
     static flags: {
         apiKey: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        count: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         domain: import("@oclif/core/interfaces").OptionFlag<string, 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/all/index.js

@@ -1,19 +1,20 @@
-import { Args, Command, Flags } from '@oclif/core';
+import { Command, Flags } from '@oclif/core';
 import * as dotenv from 'dotenv';
 import path from 'node:path';
 import { downloadIssues, downloadWikis } from '../../utils/backlog-api.js';
 import { validateAndGetProjectId } from '../../utils/backlog.js';
 import { createOutputDirectory, getApiKey } from '../../utils/common.js';
+import { FolderType, updateSettings } from '../../utils/settings.js';
 // .envファイルを読み込む
 dotenv.config();
-export default class DownloadAll extends Command {
-    static args = {
-        url: Args.string({ description: 'URL to download from', required: false }),
-    };
-    static description = 'Backlogからissueとwikiを同時に取得する';
+export default class All extends Command {
+    static description = 'Backlogから課題とWikiを取得してMarkdownファイルとして保存する';
     static examples = [
-        `<%= config.bin %> <%= command.id %> --domain cm1.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY -o ./output-dir
-BacklogからAPIキーを使用してissueとwikiを同時に取得する
+        `<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY
+課題とWikiをMarkdownファイルとして保存する
+`,
+        `<%= config.bin %> <%= command.id %> --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-project
+指定したディレクトリに課題とWikiを保存する
 `,
     ];
     static flags = {
@@ -21,44 +22,68 @@ BacklogからAPIキーを使用してissueとwikiを同時に取得する
             description: 'Backlog API key (環境変数 BACKLOG_API_KEY からも自動読み取り可能)',
             required: false,
         }),
-        count: Flags.integer({ char: 'c', default: 100, description: '一度に取得する課題数', required: false }),
-        domain: Flags.string({ description: 'Backlog domain (e.g. example.backlog.jp)', required: true }),
+        domain: Flags.string({
+            description: 'Backlog domain (e.g. example.backlog.jp)',
+            required: true,
+        }),
         output: Flags.string({
             char: 'o',
-            description: '出力ディレクトリのルートパス（デフォルトはプロジェクトキー）',
+            description: '出力ディレクトリパス',
             required: false,
         }),
-        projectIdOrKey: Flags.string({ description: 'Backlog project ID or key', required: true }),
-        statusId: Flags.string({ description: 'Filter issues by status ID', required: false }),
+        projectIdOrKey: Flags.string({
+            description: 'Backlog project ID or key',
+            required: true,
+        }),
     };
     async run() {
-        const { flags } = await this.parse(DownloadAll);
-        const { count, domain, projectIdOrKey, statusId } = flags;
-        const apiKey = getApiKey(this, flags.apiKey);
-        // 出力ディレクトリのルートパスを設定（デフォルトはプロジェクトキー）
-        const outputRoot = flags.output || projectIdOrKey;
-        this.log(`Backlogから ${domain} のプロジェクト ${projectIdOrKey} の課題とWikiを取得しています...`);
-        this.log(`出力ディレクトリ: ${outputRoot}`);
+        const { flags } = await this.parse(All);
         try {
+            const { domain, projectIdOrKey } = flags;
+            const apiKey = flags.apiKey || getApiKey(this);
+            const outputRoot = flags.output || './backlog-data';
+            // 出力ディレクトリの作成
+            await createOutputDirectory(outputRoot);
             // プロジェクトキーからプロジェクトIDを取得
             const projectId = await validateAndGetProjectId(domain, projectIdOrKey, apiKey);
             this.log(`プロジェクトID: ${projectId} を使用します`);
-            // issueとwikiのサブディレクトリパスを作成
+            // 課題の出力ディレクトリ
             const issueOutput = path.join(outputRoot, 'issues');
-            const wikiOutput = path.join(outputRoot, 'wiki');
-            // 出力ディレクトリの作成
-            await createOutputDirectory(outputRoot);
             await createOutputDirectory(issueOutput);
+            // Wikiの出力ディレクトリ
+            const wikiOutput = path.join(outputRoot, 'wiki');
             await createOutputDirectory(wikiOutput);
-            // 課題とWikiを並列で取得
-            await Promise.all([
-                downloadIssues(this, domain, projectId, apiKey, issueOutput, count, statusId),
-                downloadWikis(this, domain, projectIdOrKey, apiKey, wikiOutput),
-            ]);
-            this.log('すべてのダウンロードが完了しました！');
+            // 課題の取得と保存
+            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,
+                lastUpdated: new Date().toISOString(),
+                outputDir: wikiOutput,
+                projectIdOrKey,
+            });
+            this.log('Wikiの取得が完了しました');
+            this.log('すべてのデータの取得が完了しました！');
         }
         catch (error) {
-            this.error(`ダウンロードに失敗しました: ${error instanceof Error ? error.message : String(error)}`);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.error(`データの取得に失敗しました: ${errorMessage}`);
         }
     }
 }

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

@@ -1,17 +1,12 @@
 import { Command } from '@oclif/core';
-export default class DownloadIssue extends Command {
-    static args: {
-        url: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
-    };
+export default class Issue extends Command {
     static description: string;
     static examples: string[];
     static flags: {
         apiKey: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        count: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         domain: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        output: import("@oclif/core/interfaces").OptionFlag<string, 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

@@ -1,18 +1,19 @@
-import { Args, Command, Flags } from '@oclif/core';
+import { Command, Flags } from '@oclif/core';
 import * as dotenv from 'dotenv';
 import { downloadIssues } from '../../utils/backlog-api.js';
 import { validateAndGetProjectId } from '../../utils/backlog.js';
 import { createOutputDirectory, getApiKey } from '../../utils/common.js';
+import { FolderType, updateSettings } from '../../utils/settings.js';
 // .envファイルを読み込む
 dotenv.config();
-export default class DownloadIssue extends Command {
-    static args = {
-        url: Args.string({ description: 'URL to download from', required: false }),
-    };
-    static description = 'Backlogから課題をダウンロードする';
+export default class Issue extends Command {
+    static description = 'Backlogから課題を取得してMarkdownファイルとして保存する';
     static examples = [
-        `<%= config.bin %> <%= command.id %> --domain cm1.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./issue-data
-BacklogからAPIキーを使用して課題をダウンロードする
+        `<%= 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
+指定したディレクトリに課題を保存する
 `,
     ];
     static flags = {
@@ -20,34 +21,47 @@ BacklogからAPIキーを使用して課題をダウンロードする
             description: 'Backlog API key (環境変数 BACKLOG_API_KEY からも自動読み取り可能)',
             required: false,
         }),
-        count: Flags.integer({ char: 'c', default: 100, description: '一度に取得する課題数', required: false }),
-        domain: Flags.string({ description: 'Backlog domain (e.g. example.backlog.jp)', required: true }),
+        domain: Flags.string({
+            description: 'Backlog domain (e.g. example.backlog.jp)',
+            required: true,
+        }),
         output: Flags.string({
             char: 'o',
-            default: './backlog-issues',
             description: '出力ディレクトリパス',
             required: false,
         }),
-        projectIdOrKey: Flags.string({ description: 'Backlog project ID or key', required: true }),
-        statusId: Flags.string({ description: 'Filter issues by status ID', required: false }),
+        projectIdOrKey: Flags.string({
+            description: 'Backlog project ID or key',
+            required: true,
+        }),
     };
     async run() {
-        const { flags } = await this.parse(DownloadIssue);
-        const { count, domain, output: outputDir, projectIdOrKey, statusId } = flags;
-        const apiKey = getApiKey(this, flags.apiKey);
-        this.log(`Backlogから ${domain} のプロジェクト ${projectIdOrKey} の課題を取得しています...`);
+        const { flags } = await this.parse(Issue);
         try {
+            const { domain, projectIdOrKey } = flags;
+            const apiKey = flags.apiKey || getApiKey(this);
+            const outputDir = flags.output || './issues';
+            // 出力ディレクトリの作成
+            await createOutputDirectory(outputDir);
             // プロジェクトキーからプロジェクトIDを取得
             const projectId = await validateAndGetProjectId(domain, projectIdOrKey, apiKey);
             this.log(`プロジェクトID: ${projectId} を使用します`);
-            // 出力ディレクトリの作成
-            await createOutputDirectory(outputDir);
-            // 課題のダウンロード
-            await downloadIssues(this, domain, projectId, apiKey, outputDir, count, statusId);
-            this.log('ダウンロードが完了しました！');
+            // 課題の取得と保存
+            await downloadIssues(this, domain, projectId, apiKey, outputDir, 100);
+            // 設定ファイルを保存
+            await updateSettings(outputDir, {
+                apiKey,
+                domain,
+                folderType: FolderType.ISSUE,
+                lastUpdated: new Date().toISOString(),
+                outputDir,
+                projectIdOrKey,
+            });
+            this.log('課題の取得が完了しました！');
         }
         catch (error) {
-            this.error(`ダウンロードに失敗しました: ${error instanceof Error ? error.message : String(error)}`);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.error(`課題の取得に失敗しました: ${errorMessage}`);
         }
     }
 }