papycli 0.5.2__tar.gz → 0.6.0__tar.gz

papycli-0.6.0/.github/workflows/release.yml

@@ -0,0 +1,152 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Verify tag version matches pyproject.toml
+        run: |
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+          PKG_VERSION=$(python3 -c "
+          import tomllib
+          with open('pyproject.toml', 'rb') as f:
+              print(tomllib.load(f)['project']['version'])
+          ")
+          if [ "$TAG_VERSION" != "$PKG_VERSION" ]; then
+            echo "::error::Version mismatch: tag=$TAG_VERSION, pyproject.toml=$PKG_VERSION"
+            exit 1
+          fi
+          echo "Version OK: $PKG_VERSION"
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Build wheel and sdist
+        run: uv build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  github-release:
+    name: Create GitHub Release (draft)
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      models: read
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # full history needed for git log
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Get previous release tag
+        id: prev-tag
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPO: ${{ github.repository }}
+          TAG: ${{ github.ref_name }}
+        run: |
+          # Exclude drafts, pre-releases, and the current tag to get the true previous release
+          PREV_TAG=$(gh release list --repo "$REPO" --limit 20 \
+            --json tagName,isDraft,isPrerelease \
+            --jq 'map(select((.isDraft | not) and (.isPrerelease | not) and (.tagName != env.TAG))) | .[0].tagName // ""')
+          echo "prev_tag=$PREV_TAG" >> "$GITHUB_OUTPUT"
+
+      - name: Collect commits since previous release
+        id: commits
+        env:
+          TAG: ${{ github.ref_name }}
+          PREV_TAG: ${{ steps.prev-tag.outputs.prev_tag }}
+        run: |
+          set -euo pipefail
+          if [ -n "${PREV_TAG}" ]; then
+            RANGE="${PREV_TAG}..${TAG}"
+          else
+            RANGE="${TAG}"
+          fi
+          # Validate that the range resolves before proceeding
+          if ! git rev-parse "${RANGE}" > /dev/null 2>&1; then
+            echo "Error: git range '${RANGE}' does not resolve." >&2
+            exit 1
+          fi
+          # Collect up to 100 subject lines; exclude merge commits
+          # Use --max-count instead of | head to avoid SIGPIPE under set -euo pipefail
+          COMMITS=$(git log "${RANGE}" --no-merges --max-count=100 --pretty=format:"%s")
+          # Use a unique delimiter to avoid collision with commit message content
+          DELIM=$(uuidgen)
+          {
+            echo "commits<<${DELIM}"
+            echo "${COMMITS}"
+            echo "${DELIM}"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Generate release notes with GitHub Models
+        id: ai
+        uses: actions/ai-inference@v1
+        with:
+          model: openai/gpt-4o-mini
+          system-prompt: |
+            You are a technical writer generating GitHub release notes from git commit messages.
+
+            Rules:
+            - Classify each commit subject into one of three sections:
+                ## Features   — commits starting with "feat:"
+                ## Bug Fixes  — commits starting with "fix:"
+                ## Maintenance — all other commits (refactor:, ci:, test:, perf:, etc.)
+            - IGNORE commits starting with "docs:" or "chore:" — do not include them at all.
+            - Rewrite each item as a concise, user-friendly bullet point (do not copy the raw commit subject verbatim).
+            - Omit any section that has no entries.
+            - Always output sections in this exact order when present: ## Features, then ## Bug Fixes, then ## Maintenance.
+            - Output valid Markdown only. No preamble, no explanation outside the Markdown.
+          prompt: |
+            Generate release notes for ${{ github.ref_name }} from the following commit messages:
+
+            ${{ steps.commits.outputs.commits }}
+
+      - name: Write release notes to file
+        env:
+          NOTES: ${{ steps.ai.outputs.response }}
+        run: printf '%s' "$NOTES" > release_notes.md
+
+      - name: Create draft release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPO: ${{ github.repository }}
+          TAG: ${{ github.ref_name }}
+        run: |
+          gh release create "$TAG" \
+            --repo "$REPO" \
+            --title "$TAG" \
+            --notes-file release_notes.md \
+            --draft \
+            dist/*
+
+  pypi-publish:
+    name: Publish to PyPI
+    needs: github-release
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

{papycli-0.5.2 → papycli-0.6.0}/CLAUDE.md

@@ -39,18 +39,22 @@ papycli/
 │       ├── main.py          # エントリポイント・引数パース
 │       ├── init_cmd.py      # config add コマンド（spec の変換・保存）
 │       ├── api_call.py      # HTTP リクエスト実行
+│       ├── checker.py       # --check / --check-strict のパラメータ検証
 │       ├── completion.py    # シェル補完スクリプト生成
 │       ├── config.py        # 設定ファイルの読み書き
 │       ├── i18n.py          # 日英ヘルプテキストの切り替えユーティリティ
+│       ├── request_filter.py # リクエストフィルタープラグイン機構
 │       ├── spec_loader.py   # OpenAPI spec の読み込み・$ref 解決
 │       └── summary.py       # summary コマンド・CSV 出力
 ├── tests/
 │   ├── test_api_call.py
+│   ├── test_checker.py
 │   ├── test_completion.py
 │   ├── test_config.py
 │   ├── test_i18n.py
 │   ├── test_init_cmd.py
 │   ├── test_main.py
+│   ├── test_request_filter.py
 │   ├── test_spec_loader.py
 │   └── test_summary.py
 ├── examples/
@@ -66,7 +70,7 @@ papycli/
 ### 主要モジュール
 
 **`main.py`** — CLI エントリポイント
-引数をパースし、各コマンド（`config add`/`use`/`remove`/`list`/`completion-script`、`summary`、メソッド呼び出し）に処理を委譲する。シェル補完用の `_complete` 内部コマンドもここで定義する。
+引数をパースし、各コマンド（`config add`/`use`/`remove`/`list`/`completion-script`、`spec`、`summary`、メソッド呼び出し）に処理を委譲する。シェル補完用の `_complete` 内部コマンドもここで定義する。
 
 **`init_cmd.py`** — API 初期化（`config add` コマンドの実処理）
 OpenAPI spec ファイルを受け取り、`$ref` を解決した上で papycli 内部の API 定義フォーマットに変換し、`$PAPYCLI_CONF_DIR/apis/<name>.json` に保存する。設定ファイル (`papycli.conf`) も更新する。
@@ -75,13 +79,19 @@ OpenAPI spec ファイルを受け取り、`$ref` を解決した上で papycli
 OpenAPI spec の JSON/YAML を読み込み、`$ref` を再帰的に解決して、papycli の内部フォーマット（後述）に変換する。Python 標準ライブラリのみ（または最小限の依存）で実装する。
 
 **`api_call.py`** — HTTP リクエスト実行
-メソッド・リソースパス・オプションを受け取り、`requests` ライブラリで HTTP リクエストを実行する。パステンプレート（`/pet/{petId}`）のマッチングと値の埋め込みも担当する。
+メソッド・リソースパス・オプションを受け取り、`requests` ライブラリで HTTP リクエストを実行する。パステンプレート（`/pet/{petId}`）のマッチングと値の埋め込みも担当する。リクエストフィルタープラグインの適用と、リクエスト/レスポンスのファイルログ記録も行う。
+
+**`checker.py`** — パラメータ検証
+`--check` / `--check-strict` オプション用のリクエスト前バリデーションロジック。必須パラメータの存在確認、型チェック（integer / boolean）、enum 値の検証を行い、警告メッセージのリストを返す。
 
 **`completion.py`** — シェル補完
 bash / zsh 向けの補完スクリプトを生成する。補完の候補はメソッド、リソースパス、パラメータ名、enum 値の順にコンテキストに応じて提供する。
 
 **`config.py`** — 設定管理
-`papycli.conf` の読み書きと、`PAPYCLI_CONF_DIR` 環境変数の解決を行う。
+`papycli.conf` の読み書きと、`PAPYCLI_CONF_DIR` 環境変数の解決を行う。ログファイルパスの取得・設定・削除も担当する。
+
+**`request_filter.py`** — リクエストフィルタープラグイン機構
+エントリポイントグループ `papycli.request_filters` に登録されたフィルター関数をプラグイン名の昇順で呼び出し、リクエスト送信前に URL・クエリパラメータ・ボディ・ヘッダーを変換できるようにする。`RequestContext` データクラスと `load_filters()` / `apply_filters()` 関数を提供する。
 
 **`summary.py`** — サマリー表示
 登録済み API のエンドポイント一覧を整形して出力する。`--summary-csv` では CSV 形式で出力する。
@@ -154,7 +164,9 @@ papycli config add <spec-file>
 papycli config use <api-name>
 papycli config remove <api-name>
 papycli config list
+papycli config log [PATH] [--unset]
 papycli config completion-script <bash|zsh>
+papycli spec [resource]
 papycli summary [resource] [--csv]
 papycli --version
 papycli --help / -h
@@ -171,6 +183,8 @@ papycli --help / -h
 - `-p <name.subname> <value>` — ドット記法で 1 レベルのネストオブジェクトを構築する
 - `-d <json>` — 生の JSON 文字列。`-p` オプションを上書きする
 - `-H <header: value>` — カスタム HTTP ヘッダー
+- `--check` — 送信前にパラメータを検証する（警告を stderr に出力、リクエストは送信）
+- `--check-strict` — 送信前にパラメータを検証する（警告を stderr に出力、問題があればリクエスト中止・exit 1）
 
 ### パステンプレートのマッチング
 

{papycli-0.5.2 → papycli-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: papycli
-Version: 0.5.2
+Version: 0.6.0
 Summary: A CLI tool to call REST APIs defined in OpenAPI 3.0 specs
 Project-URL: Homepage, https://github.com/tmonj1/papycli
 Project-URL: Repository, https://github.com/tmonj1/papycli
@@ -34,6 +34,11 @@ Description-Content-Type: text/markdown
 - Auto-generates a CLI from any OpenAPI 3.0 spec
 - Shell completion for bash and zsh
 - Register and switch between multiple APIs
+- Inspect API specs with `papycli spec`
+- Validate request parameters before sending with `--check` / `--check-strict`
+- Automatically coerces `-p` values to the correct JSON type (integer, number, boolean) based on the API spec
+- Log requests and responses to a file with `papycli config log`
+- Extend request processing with request filter plugins (`papycli.request_filters` entry point)
 
 ## Requirements
 
@@ -124,13 +129,13 @@ Once shell completion is enabled, tab completion is available:
 
 ```
 $ papycli <TAB>
-  get  post  put  patch  delete  config  summary
+  get  post  put  patch  delete  config  spec  summary
 
 $ papycli get <TAB>
   /pet/findByStatus  /pet/{petId}  /store/inventory  ...
 
 $ papycli get /pet/findByStatus <TAB>
-  -q  -p  -H  -d  --summary  --verbose
+  -q  -p  -H  -d  --summary  --verbose  --check  --check-strict
 
 $ papycli get /pet/findByStatus -q <TAB>
   status
@@ -206,12 +211,18 @@ papycli config add <spec-file>             Register an API from an OpenAPI spec
 papycli config remove <api-name>           Remove a registered API
 papycli config use <api-name>              Switch the active API
 papycli config list                        List registered APIs and current configuration
+papycli config log                         Show the current log file path
+papycli config log <path>                  Set the log file path
+papycli config log --unset                 Disable logging
 papycli config completion-script <bash|zsh>  Print a shell completion script
 
-# API call commands
+# Inspection commands
+papycli spec [resource]             Show the raw internal API spec (filter by resource path)
 papycli summary [resource]          List available endpoints (filter by resource prefix)
                                       Required params marked with *, array params with []
 papycli summary --csv               Output endpoints in CSV format
+
+# API call commands
 papycli <method> <resource> [options]
 
 Methods:
@@ -221,6 +232,9 @@ Options:
   -H <header: value>      Custom HTTP header (repeatable)
   -q <name> <value>       Query parameter (repeatable)
   -p <name> <value>       Body parameter (repeatable)
+                            - Values are coerced to the correct JSON type
+                              (integer, number, boolean) based on the API spec.
+                              Strings are passed as-is.
                             - Repeat the same key to build a JSON array:
                               -p tags foo -p tags bar  →  {"tags":["foo","bar"]}
                             - Use dot notation to build a nested object:
@@ -228,6 +242,9 @@ Options:
                               →  {"category":{"id":"1","name":"Dogs"}}
   -d <json>               Raw JSON body (overrides -p)
   --summary               Show endpoint info without sending a request
+  --check                 Validate params before sending (warn on stderr, request is still sent)
+  --check-strict          Validate params before sending (warn on stderr, abort with exit 1 on failure)
+  --verbose / -v          Show HTTP status line
   --version               Show version
   --help / -h             Show help
 
@@ -240,6 +257,42 @@ Environment variables:
 
 ---
 
+## Request Filter Plugins
+
+You can intercept and transform outgoing requests by writing a request filter plugin.
+
+A filter is a callable that receives a `RequestContext` and returns a modified `RequestContext`:
+
+```python
+# my_plugin.py
+from papycli.request_filter import RequestContext
+
+def request_filter(ctx: RequestContext) -> RequestContext:
+    ctx.headers["X-Request-ID"] = "my-id"
+    return ctx
+```
+
+Register it in your package's `pyproject.toml`:
+
+```toml
+[project.entry-points."papycli.request_filters"]
+my-filter = "my_plugin:request_filter"
+```
+
+Install the package and filters are applied automatically on every request, sorted by plugin name.
+
+`RequestContext` fields:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `method` | `str` | HTTP method (lowercase). Do not modify. |
+| `url` | `str` | Full URL with path parameters expanded. |
+| `query_params` | `list[tuple[str, str]]` | Query parameters. |
+| `body` | `dict \| list \| str \| int \| float \| bool \| None` | JSON request body. |
+| `headers` | `dict[str, str]` | Custom HTTP headers. |
+
+---
+
 ## Limitations
 
 - Request bodies are `application/json` only

{papycli-0.5.2 → papycli-0.6.0}/README.ja.md

@@ -7,6 +7,11 @@
 - OpenAPI 3.0 仕様から CLI を自動生成
 - シェル補完（bash / zsh）対応
 - 複数 API の登録・切り替え
+- `papycli spec` による API スペックの確認
+- `--check` / `--check-strict` によるリクエスト前のパラメータ検証
+- API 仕様に基づいて `-p` の値を適切な JSON 型（integer / number / boolean）に自動変換
+- `papycli config log` によるリクエスト/レスポンスのファイルログ
+- リクエストフィルタープラグイン（`papycli.request_filters` エントリポイント）によるリクエスト処理の拡張
 
 ## 必要環境
 
@@ -97,13 +102,13 @@ papycli delete /pet/1
 
 ```
 $ papycli <TAB>
-  get  post  put  patch  delete  config  summary
+  get  post  put  patch  delete  config  spec  summary
 
 $ papycli get <TAB>
   /pet/findByStatus  /pet/{petId}  /store/inventory  ...
 
 $ papycli get /pet/findByStatus <TAB>
-  -q  -p  -H  -d  --summary  --verbose
+  -q  -p  -H  -d  --summary  --verbose  --check  --check-strict
 
 $ papycli get /pet/findByStatus -q <TAB>
   status
@@ -179,12 +184,18 @@ papycli config add <spec-file>             OpenAPI spec ファイルから API
 papycli config remove <api-name>           登録済み API を削除する
 papycli config use <api-name>              アクティブな API を切り替える
 papycli config list                        登録済み API と現在の設定を一覧表示する
+papycli config log                         現在のログファイルパスを表示する
+papycli config log <path>                  ログファイルパスを設定する
+papycli config log --unset                 ログを無効化する
 papycli config completion-script <bash|zsh>  シェル補完スクリプトを出力する
 
-# API 呼び出しコマンド
+# 確認コマンド
+papycli spec [resource]             内部 API スペックを表示する（リソースパスでフィルタ可能）
 papycli summary [resource]          利用可能なエンドポイントを表示する（リソースでフィルタ可能）
                                       必須パラメータは * 付き、配列パラメータは [] 付きで表示
 papycli summary --csv               CSV フォーマットでエンドポイントを表示する
+
+# API 呼び出しコマンド
 papycli <method> <resource> [options]
 
 メソッド:
@@ -194,6 +205,8 @@ papycli <method> <resource> [options]
   -H <header: value>      カスタム HTTP ヘッダー（繰り返し可）
   -q <name> <value>       クエリパラメータ（繰り返し可）
   -p <name> <value>       ボディパラメータ（繰り返し可）
+                            - API 仕様に基づいて値を適切な JSON 型（integer / number /
+                              boolean）に自動変換する。文字列はそのまま送信される。
                             - 同じキーを繰り返すと JSON 配列を構築する:
                               -p tags foo -p tags bar  →  {"tags":["foo","bar"]}
                             - ドット記法でネストしたオブジェクトを構築する:
@@ -201,6 +214,9 @@ papycli <method> <resource> [options]
                               →  {"category":{"id":"1","name":"Dogs"}}
   -d <json>               生の JSON ボディ（-p を上書きする）
   --summary               リクエストを送らずにエンドポイント情報を表示する
+  --check                 送信前にパラメータを検証する（警告を stderr に出力、リクエストは送信）
+  --check-strict          送信前にパラメータを検証する（警告を stderr に出力、問題があればリクエスト中止・exit 1）
+  --verbose / -v          HTTP ステータス行を表示する
   --version               バージョンを表示する
   --help / -h             使い方を表示する
 
@@ -213,6 +229,42 @@ papycli <method> <resource> [options]
 
 ---
 
+## リクエストフィルタープラグイン
+
+リクエストフィルタープラグインを作成することで、送信前のリクエストを加工できます。
+
+フィルターは `RequestContext` を受け取り、変更した `RequestContext` を返す callable です：
+
+```python
+# my_plugin.py
+from papycli.request_filter import RequestContext
+
+def request_filter(ctx: RequestContext) -> RequestContext:
+    ctx.headers["X-Request-ID"] = "my-id"
+    return ctx
+```
+
+パッケージの `pyproject.toml` にエントリポイントを登録します：
+
+```toml
+[project.entry-points."papycli.request_filters"]
+my-filter = "my_plugin:request_filter"
+```
+
+パッケージをインストールすると、すべてのリクエストに対してフィルターがプラグイン名の昇順で自動適用されます。
+
+`RequestContext` のフィールド：
+
+| フィールド | 型 | 説明 |
+|-----------|-----|------|
+| `method` | `str` | HTTP メソッド（小文字）。変更不可。 |
+| `url` | `str` | パスパラメータ展開済みの完全 URL。 |
+| `query_params` | `list[tuple[str, str]]` | クエリパラメータ。 |
+| `body` | `dict \| list \| str \| int \| float \| bool \| None` | JSON リクエストボディ。 |
+| `headers` | `dict[str, str]` | カスタム HTTP ヘッダー。 |
+
+---
+
 ## 制限事項
 
 - リクエストボディは `application/json` のみ対応

{papycli-0.5.2 → papycli-0.6.0}/README.md

@@ -7,6 +7,11 @@
 - Auto-generates a CLI from any OpenAPI 3.0 spec
 - Shell completion for bash and zsh
 - Register and switch between multiple APIs
+- Inspect API specs with `papycli spec`
+- Validate request parameters before sending with `--check` / `--check-strict`
+- Automatically coerces `-p` values to the correct JSON type (integer, number, boolean) based on the API spec
+- Log requests and responses to a file with `papycli config log`
+- Extend request processing with request filter plugins (`papycli.request_filters` entry point)
 
 ## Requirements
 
@@ -97,13 +102,13 @@ Once shell completion is enabled, tab completion is available:
 
 ```
 $ papycli <TAB>
-  get  post  put  patch  delete  config  summary
+  get  post  put  patch  delete  config  spec  summary
 
 $ papycli get <TAB>
   /pet/findByStatus  /pet/{petId}  /store/inventory  ...
 
 $ papycli get /pet/findByStatus <TAB>
-  -q  -p  -H  -d  --summary  --verbose
+  -q  -p  -H  -d  --summary  --verbose  --check  --check-strict
 
 $ papycli get /pet/findByStatus -q <TAB>
   status
@@ -179,12 +184,18 @@ papycli config add <spec-file>             Register an API from an OpenAPI spec
 papycli config remove <api-name>           Remove a registered API
 papycli config use <api-name>              Switch the active API
 papycli config list                        List registered APIs and current configuration
+papycli config log                         Show the current log file path
+papycli config log <path>                  Set the log file path
+papycli config log --unset                 Disable logging
 papycli config completion-script <bash|zsh>  Print a shell completion script
 
-# API call commands
+# Inspection commands
+papycli spec [resource]             Show the raw internal API spec (filter by resource path)
 papycli summary [resource]          List available endpoints (filter by resource prefix)
                                       Required params marked with *, array params with []
 papycli summary --csv               Output endpoints in CSV format
+
+# API call commands
 papycli <method> <resource> [options]
 
 Methods:
@@ -194,6 +205,9 @@ Options:
   -H <header: value>      Custom HTTP header (repeatable)
   -q <name> <value>       Query parameter (repeatable)
   -p <name> <value>       Body parameter (repeatable)
+                            - Values are coerced to the correct JSON type
+                              (integer, number, boolean) based on the API spec.
+                              Strings are passed as-is.
                             - Repeat the same key to build a JSON array:
                               -p tags foo -p tags bar  →  {"tags":["foo","bar"]}
                             - Use dot notation to build a nested object:
@@ -201,6 +215,9 @@ Options:
                               →  {"category":{"id":"1","name":"Dogs"}}
   -d <json>               Raw JSON body (overrides -p)
   --summary               Show endpoint info without sending a request
+  --check                 Validate params before sending (warn on stderr, request is still sent)
+  --check-strict          Validate params before sending (warn on stderr, abort with exit 1 on failure)
+  --verbose / -v          Show HTTP status line
   --version               Show version
   --help / -h             Show help
 
@@ -213,6 +230,42 @@ Environment variables:
 
 ---
 
+## Request Filter Plugins
+
+You can intercept and transform outgoing requests by writing a request filter plugin.
+
+A filter is a callable that receives a `RequestContext` and returns a modified `RequestContext`:
+
+```python
+# my_plugin.py
+from papycli.request_filter import RequestContext
+
+def request_filter(ctx: RequestContext) -> RequestContext:
+    ctx.headers["X-Request-ID"] = "my-id"
+    return ctx
+```
+
+Register it in your package's `pyproject.toml`:
+
+```toml
+[project.entry-points."papycli.request_filters"]
+my-filter = "my_plugin:request_filter"
+```
+
+Install the package and filters are applied automatically on every request, sorted by plugin name.
+
+`RequestContext` fields:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `method` | `str` | HTTP method (lowercase). Do not modify. |
+| `url` | `str` | Full URL with path parameters expanded. |
+| `query_params` | `list[tuple[str, str]]` | Query parameters. |
+| `body` | `dict \| list \| str \| int \| float \| bool \| None` | JSON request body. |
+| `headers` | `dict[str, str]` | Custom HTTP headers. |
+
+---
+
 ## Limitations
 
 - Request bodies are `application/json` only

{papycli-0.5.2 → papycli-0.6.0}/design_doc.md

@@ -37,16 +37,20 @@ papycli/
 │       ├── spec_loader.py   # OpenAPI spec 読み込み・$ref 解決・内部形式変換
 │       ├── init_cmd.py      # config add コマンドの処理
 │       ├── api_call.py      # HTTP リクエスト実行・パステンプレートマッチング
+│       ├── checker.py       # --check / --check-strict のパラメータ検証
 │       ├── summary.py       # summary コマンドの出力
 │       ├── completion.py    # bash / zsh 補完スクリプト生成
+│       ├── request_filter.py # リクエストフィルタープラグイン機構
 │       └── i18n.py          # 日英ヘルプテキストの切り替えユーティリティ
 ├── tests/
 │   ├── test_api_call.py
+│   ├── test_checker.py
 │   ├── test_completion.py
 │   ├── test_config.py
 │   ├── test_i18n.py
 │   ├── test_init_cmd.py
 │   ├── test_main.py
+│   ├── test_request_filter.py
 │   ├── test_spec_loader.py
 │   └── test_summary.py
 ├── examples/
@@ -174,12 +178,19 @@ papycli/
   - `requests` による HTTP 実行
   - レスポンスの出力（JSON は整形表示、それ以外はそのまま）
 - `main.py` に `papycli <method> <resource>` コマンド追加
-- テスト: `test_api_call.py`
+- `main.py` に `papycli spec [resource]` コマンド追加（内部 API 定義の JSON 表示）
+- `checker.py`
+  - `--check` / `--check-strict` オプション用のパラメータ検証ロジック
+  - 必須パラメータの存在確認、型チェック（integer / boolean）、enum 値の検証
+  - `--check`: 問題があっても警告を出力してリクエストを送信する
+  - `--check-strict`: 問題があれば警告を出力してリクエストを中止し exit 1
+- テスト: `test_api_call.py`、`test_checker.py`
   - パステンプレートマッチングの各ケース
   - `-p` による JSON 構築（配列、ネスト）
   - `responses` ライブラリで HTTP をモックしたエンドツーエンドテスト
+  - `check_request()` の各検証ケース（必須・型・enum・raw body）
 
-**完了条件**: `papycli get /store/inventory`、`papycli post /pet -p name "My Dog" -p status available` 等が Petstore サーバーに対して動作する。テストがパスする。
+**完了条件**: `papycli get /store/inventory`、`papycli post /pet -p name "My Dog" -p status available` 等が Petstore サーバーに対して動作する。`papycli spec` で内部 API 定義が表示される。`--check` / `--check-strict` でパラメータ検証が動作する。テストがパスする。
 
 ---
 
@@ -217,9 +228,67 @@ papycli/
     4. パラメータ名補完: `-q <TAB>` → クエリパラメータ名の候補
     5. enum 値補完: `-q status <TAB>` → `available pending sold` 等
 - `main.py` に `--completion-script <bash|zsh>` コマンド追加
+- 補完候補の強化（`spec` コマンド、`summary --csv`、`--check`/`--check-strict` オプションを追加）
+- Windows 対応: `_complete` の出力を binary stream（LF のみ）に変更
 - 手動テスト手順をドキュメント化
 
-**完了条件**: `eval "$(papycli config completion-script zsh)"` 後にタブ補完が動作する。メソッド・リソース・クエリパラメータ名・ボディパラメータ名・enum 値が補完候補として表示される。
+**完了条件**: `eval "$(papycli config completion-script zsh)"` 後にタブ補完が動作する。メソッド・リソース・クエリパラメータ名・ボディパラメータ名・enum 値が補完候補として表示される。`spec`・`summary`・`--check`・`--check-strict` も補完候補に含まれる。
+
+---
+
+### Milestone 6 — リクエストフィルタープラグイン機構
+
+**目的**: サードパーティプラグインがリクエスト送信前に URL・クエリ・ボディ・ヘッダーを変換できる拡張ポイントを提供する。
+
+**実装内容**:
+- `request_filter.py`
+  - `RequestContext` データクラス（`method`, `url`, `query_params`, `body`, `headers`）
+  - `load_filters()`: `papycli.request_filters` エントリポイントグループからフィルターをロードし、callable 検証後にプラグイン名の昇順で返す
+  - `apply_filters()`: フィルターを順番に適用。各フィルター呼び出し前にスナップショットを作成し（body は deepcopy、他はシャローコピー）、例外・戻り値不正の場合は警告して前の ctx を維持する
+- `api_call.py` の `call_api()` でフィルターを適用するよう更新
+  - フィルター適用後の `method` は使用しない（API 定義マッチング時に確定した元の値を使う）
+- テスト: `test_request_filter.py`
+  - フィルターの読み込み・適用・例外処理・戻り値型検証など
+
+**プラグイン登録例** (`pyproject.toml`):
+
+```toml
+[project.entry-points."papycli.request_filters"]
+my-filter = "my_plugin:request_filter"
+```
+
+**完了条件**: `papycli.request_filters` エントリポイントに登録したフィルターが全リクエストで自動適用される。フィルターが例外を送出してもリクエスト送信に影響しない。テストがパスする。
+
+---
+
+### Milestone 7 — `config log` コマンドとリクエスト/レスポンスログ
+
+**目的**: リクエストとレスポンスの内容をファイルに記録できるようにし、デバッグや監査を容易にする。
+
+**実装内容**:
+- `config.py`
+  - `get_logfile()` / `set_logfile()` / `unset_logfile()`: ログファイルパスの取得・設定・削除
+  - `load_current_apidef()` に `conf` オプション引数を追加し、設定ファイルの二重読み込みを防止
+- `api_call.py`
+  - `_SENSITIVE_HEADERS`: ログに記録する際にマスクするヘッダー名の集合（Authorization, Cookie 等）
+  - `_LOG_BODY_MAX_CHARS`: ログに記録するボディの最大文字数（10,000 文字）。超過時は `...[truncated]` を付与
+  - `_write_log()`: フィルター適用前の URL・クエリ・ボディ・ヘッダーをログに記録。エラー時は警告のみでリクエストには影響しない
+  - `call_api()` に `logfile` 引数を追加。`~` 展開に `Path.expanduser()` を使用
+- `main.py` に `papycli config log [PATH] [--unset]` コマンド追加
+- テスト: `test_config.py`、`test_api_call.py`、`test_main.py`
+
+**ログフォーマット例**:
+
+```
+[2026-03-10T12:34:56+00:00] GET https://example.com/pet/99
+  Query: (none)
+  Body: (none)
+  Headers: {"Authorization": "***"}
+  Status: 200
+  Response: {"id": 99, "name": "My Dog"}
+```
+
+**完了条件**: `papycli config log ~/papycli.log` 設定後、リクエストごとにログファイルへ追記される。機密ヘッダーはマスクされる。大きなボディは切り詰められる。テストがパスする。
 
 ---