docs: Update CHANGELOG and README for v1.3.0

Author: magifd2

CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.0] - 2025-08-28
+
+### Added
+
+- Added a `--limit` flag to the `run` and `results` commands to control the maximum number of results returned.
+- Added a `limit` field to the `config.json` file to allow setting a default result limit.
+
+### Changed
+
+- The default behavior for result fetching is now to return all results (`limit=0`) unless specified otherwise by the `--limit` flag or in the config file.
+
+### Fixed
+
+- Fixed a display issue where the "Waiting for job to complete..." message was not printed on a new line.
+
 ## [1.2.1] - 2025-08-18
 
 ### Fixed

README.ja.md

@@ -48,7 +48,8 @@ make build
   "token": "your-splunk-token-here",
   "app": "search",
   "insecure": true,
-  "httpTimeout": "60s"
+  "httpTimeout": "60s",
+  "limit": 100
 }
 ```
 
@@ -78,8 +79,8 @@ make build
 
 **使用例**:
 ```bash
-# 過去1時間のデータを検索
-splunk-cli run --spl "index=_internal" --earliest "-1h"
+# 過去1時間のデータを10件に絞って検索
+splunk-cli run --spl "index=_internal" --earliest "-1h" --limit 10
 
 # ファイルからSPLを読み込んで検索
 cat my_query.spl | splunk-cli run -f -
@@ -90,6 +91,7 @@ cat my_query.spl | splunk-cli run -f -
 - `--earliest <time>`: 検索の開始時刻。(-1h, @d, 1672531200など)
 - `--latest <time>`: 検索の終了時刻。(now, @d, 1672617600など)
 - `--timeout <duration>`: ジョブ全体のタイムアウト時間。(10m, 1h30mなど)
+- `--limit <int>`: 最大取得件数 (0を指定すると全件取得)。
 - `--silent`: 進捗メッセージを非表示にします。
 
 > **💡 Ctrl+C の挙動**: `run`の実行中に `Ctrl+C` を押すと、ジョブをキャンセルするか、バックグラウンドで実行し続けるかを選択できます。
@@ -119,9 +121,13 @@ splunk-cli status --sid "$JOB_ID"
 
 **使用例**:
 ```bash
-splunk-cli results --sid "$JOB_ID" --silent | jq .
+# 指定したジョブの結果を50件まで取得
+splunk-cli results --sid "$JOB_ID" --limit 50 --silent | jq .
 ```
 
+- `--sid <string>`: ジョブの検索ID (SID)。
+- `--limit <int>`: 最大取得件数 (0を指定すると全件取得)。
+
 ### 共通フラグ
 
 ほとんどのコマンドで利用できる共通フラグです。
@@ -132,6 +138,7 @@ splunk-cli results --sid "$JOB_ID" --silent | jq .
 - `--password <string>`: パスワード（指定しない場合はプロンプトで入力を求められます）。
 - `--app <string>`: 検索を実行するAppのコンテキスト。
 - `--owner <string>`: App内のナレッジオブジェクトの所有者。デフォルトは`nobody`。
+- `--limit <int>`: 最大取得件数 (0を指定すると全件取得)。デフォルトは0(全件取得)です。
 - `--insecure`: TLS証明書の検証をスキップします。
 - `--http-timeout <duration>`: 個々のAPIリクエストのタイムアウト時間。(30s, 1mなど)
 - `--debug`: 詳細なデバッグ情報を表示します。
@@ -153,4 +160,4 @@ splunk-cli results --sid "$JOB_ID" --silent | jq .
 
 ---
 
-*このツールは、Googleの大規模言語モデルであるGeminiとの対話を通じて初期構築および開発されました。*
+*このツールは、Googleの大規模言語モデルであるGeminiとの対話を通じて初期構築および開発されました。*

README.md

@@ -48,7 +48,8 @@ The most convenient way to use the tool is by creating a configuration file.
   "token": "your-splunk-token-here",
   "app": "search",
   "insecure": true,
-  "httpTimeout": "60s"
+  "httpTimeout": "60s",
+  "limit": 100
 }
 ```
 
@@ -78,8 +79,8 @@ Starts a search, waits for it to complete, and displays the results.
 
 **Examples**:
 ```bash
-# Search data from the last hour
-splunk-cli run --spl "index=_internal" --earliest "-1h"
+# Search data from the last hour, limiting to 10 results
+splunk-cli run --spl "index=_internal" --earliest "-1h" --limit 10
 
 # Read SPL from a file and execute
 cat my_query.spl | splunk-cli run -f -
@@ -90,6 +91,7 @@ cat my_query.spl | splunk-cli run -f -
 - `--earliest <time>`: The earliest time for the search (e.g., -1h, @d, 1672531200).
 - `--latest <time>`: The latest time for the search (e.g., now, @d, 1672617600).
 - `--timeout <duration>`: Total timeout for the job (e.g., 10m, 1h30m).
+- `--limit <int>`: Maximum number of results to return (0 for all).
 - `--silent`: Suppress progress messages.
 
 > **💡 Ctrl+C Behavior**: When you press `Ctrl+C` during a `run` command, you can choose to either cancel the job or let it continue running in the background.
@@ -119,9 +121,13 @@ Fetches the results of a completed job. This is useful in combination with tools
 
 **Example**:
 ```bash
-splunk-cli results --sid "$JOB_ID" --silent | jq .
+# Fetch up to 50 results for a given job
+splunk-cli results --sid "$JOB_ID" --limit 50 --silent | jq .
 ```
 
+- `--sid <string>`: The Search ID (SID) of the job.
+- `--limit <int>`: Maximum number of results to return (0 for all).
+
 ### Common Flags
 
 These flags are available for most commands:
@@ -132,6 +138,7 @@ These flags are available for most commands:
 - `--password <string>`: The password (will be prompted for if not provided).
 - `--app <string>`: The app context for the search.
 - `--owner <string>`: The owner of knowledge objects within the app (defaults to `nobody`).
+- `--limit <int>`: Maximum number of results to return (0 for all). The default is 0 (all results).
 - `--insecure`: Skip TLS certificate verification.
 - `--http-timeout <duration>`: Timeout for individual API requests (e.g., 30s, 1m).
 - `--debug`: Enable detailed debug logging.
@@ -143,8 +150,7 @@ This project uses a `Makefile` for common development tasks.
 
 - `make build`: Build binaries for all target platforms (macOS, Linux, Windows).
 - `make test`: Run tests.
-- `make lint`: Run the linter (`golangci-lint`).
-- `make vulncheck`: Scan for known vulnerabilities (`govulncheck`).
+- `make lint`: Run the linter (`golangci-lint`).n- `make vulncheck`: Scan for known vulnerabilities (`govulncheck`).
 - `make clean`: Clean up build artifacts.
 
 ## License
@@ -153,4 +159,4 @@ This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) f
 
 ---
 
-*This tool was bootstrapped and developed in collaboration with Gemini, a large language model from Google.*
+*This tool was bootstrapped and developed in collaboration with Gemini, a large language model from Google.*