pyfltr 3.3.0__tar.gz → 3.3.2__tar.gz

{pyfltr-3.3.0 → pyfltr-3.3.2}/.pre-commit-config.yaml

@@ -32,3 +32,9 @@ repos:
         types_or: [python, markdown, toml]
         require_serial: true
         language: system
+      - id: mkdocs-build
+        name: mkdocs build --strict
+        entry: uv run --frozen mkdocs build --strict --quiet --site-dir /tmp/mkdocs-check
+        language: system
+        pass_filenames: false
+        files: ^(docs/|mkdocs\.yml|README\.md|CLAUDE\.md)

{pyfltr-3.3.0 → pyfltr-3.3.2}/CLAUDE.md

@@ -4,6 +4,7 @@
 
 - `make update`: 依存更新 + pre-commit autoupdate + pinactアクション更新 + 全テスト実行
   - `make update-actions`: GitHub Actionsのハッシュピン更新のみ（mise経由でpinact実行）
+- リリース手順: [docs/development/development.md](docs/development/development.md) 参照
 - テストコードは`pyfltr/xxx_.py`に対して`tests/xxx_test.py`として配置する
 - コミット前の検証方法: `uv run pyfltr run-for-agent`
   - ドキュメントなどのみの変更の場合は省略可（pre-commitで実行されるため）
@@ -36,13 +37,11 @@ stdout占有は`jsonl` / `sarif` / `code-quality`かつ`--output-file`未指定
 
 ## 注意点
 
-- `uv run mkdocs build --strict`でリンク・nav整合性を検証（ただし日本語アンカーリンク`#見出し日本語`は
-  MkDocs TOCで解決できずINFO通知のみで`--strict`でも検知されないため手動確認要）
-- 内部リンクは英数アンカーを優先する。MkDocs（Material）のslugifyは英数のみを採用してアンカー生成する。
+- 内部リンクは英数アンカーを優先する。MkDocs（Material）のslugifyは英数のみを採用してアンカー生成するため、
+  日本語アンカーリンク`#見出し日本語`はTOCで解決できずINFO通知のみで`--strict`でも検知されない（手動確認要）。
   markdownlint MD051は見出し原文を見るため、`{#id}`記法で明示併設する（例:「### jsonl形式の使い方 {#jsonl}」）
 - `docs/guide/index.md`の対応ツール一覧と`mkdocs.yml`内llmstxt `markdown_description`の「対応ツール」節は
   人手同期（SSOT化しない運用）
 - `mkdocs.yml`内llmstxt `markdown_description`にはLLMが利用する際に有用な情報のみ記載する
  （`run-for-agent`サブコマンド、主要オプションなど）。LLMにとって不要な情報はdocs側をSSOTとし、多重管理を避ける
-- ドキュメント構成変更時は`docs/development/development.md`の「READMEとdocsの役割分担」節を先に参照
 - JSONLスキーマの変更は破壊的変更扱いしない（LLMが読みやすいよう継続的に改善する）

{pyfltr-3.3.0 → pyfltr-3.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyfltr
-Version: 3.3.0
+Version: 3.3.2
 Summary: Python Formatters, Linters, and Testers Runner.
 Project-URL: Homepage, https://github.com/ak110/pyfltr
 Author-email: "aki." <mark@aur.ll.to>

{pyfltr-3.3.0 → pyfltr-3.3.2}/docs/development/development.md

@@ -34,22 +34,6 @@ CI/`make`などの自動実行環境で`uv sync`/`uv run`が依存解決を再
 `uv add`/`uv remove`/`uv lock --upgrade-package`を使えばよい。
 `make update`も内部で自動的にUV_FROZENを外すため、そのまま実行してよい。
 
-## READMEとdocsの役割分担
-
-本プロジェクトのドキュメントは以下の構成で配置している。
-
-- README.md: 概要・特徴・インストール手順・ドキュメントへのリンクを網羅する「玄関」。
-  README.mdだけを読めばプロジェクトの目的と使い始めるための入口が把握できる状態を保つ
-- docs/guide/: 利用者向けの詳細情報（対応ツール一覧・コンセプト・設定リファレンス・使い方など）
-- docs/development/: 開発者向けの情報（セットアップ・リリース手順など）
-
-README.mdとdocs側で概要・特徴・インストール手順が部分的に重複する場合があるが、README.mdはGitHubトップとして、
-docs側は公開ドキュメントの入口としてそれぞれ自己完結する必要があるため、この重複は許容する。
-本プロジェクトの`docs/index.md`はREADMEへの参照のみに留めており、インストール手順の重複は発生させていない。
-
-変更頻度が低いため二重管理のコストより一貫性・可読性のメリットが上回ると判断した。
-変更時は、docs側で同じ情報を再掲している箇所があれば同じコミット内で合わせて更新する。
-
 ## ドキュメント
 
 ドキュメントはMkDocsで管理し、GitHub Pagesでホスティングしている。
@@ -72,10 +56,6 @@ uv run mkdocs serve
 
 masterブランチへのpush時にdocs/配下やmkdocs.ymlの変更があると自動デプロイされる。
 
-## コミットメッセージ（Conventional Commits）
-
-Conventional Commits形式に従う。ただし記述の方向性があまり変わらないような軽微な修正は`chore`などにしてよい。
-
 ## リリース手順
 
 事前に`gh`コマンドをインストールして`gh auth login`でログインしておき、以下のコマンドのいずれかを実行。

{pyfltr-3.3.0 → pyfltr-3.3.2}/docs/development/jsonl-output.md

@@ -7,7 +7,7 @@ LLMエージェントとCIシステム向けに提供するJSONL出力（およ
 
 | `kind` | 役割 |
 | --- | --- |
-| `header` | 先頭1行。実行環境情報。`commands_count`/`schema_hints`は既定で短縮され、`-v`指定時にフル`commands`配列とフル`schema_hints`へ切り替わる |
+| `header` | 先頭1行。実行環境情報。`commands`は実行対象（有効化された）コマンド名配列。`schema_hints`は既定で短縮版、`-v`指定時にフル版へ切り替わる |
 | `warning` | pyfltrが検出した設定・実行時の警告（`source`で発生元を識別） |
 | `diagnostic` | `(command, file)`単位で集約された診断。個別指摘は`messages[]`配列に格納 |
 | `command` | 1コマンド1レコードの実行メタ情報。rule→URL辞書`hint-urls`をオプションで含む |
@@ -29,10 +29,11 @@ JSONLはLLMエージェントが入力として読むケースが多いため、
 英語にするのはトークン効率（日本語より短くなりやすい）と汎用性（LLMの入力として標準的）のため。
 
 - `header.schema_hints`: 毎runに付与する英語の辞書。既定はLLMが読み違いやすい非自明フィールドのみに絞った短縮版を出す。
-  実装は`_SCHEMA_HINTS_COMPACT`で約420文字。
+  実装は`_SCHEMA_HINTS_COMPACT`で約400文字。
   `-v` / `--verbose`指定時はフル版`_SCHEMA_HINTS`（約1,500文字）に切り替わり、
   `diagnostic.messages` / `diagnostic.messages.fix` / `diagnostic.messages.severity` /
-  `command.hint-urls` / `command.retry_command` / `command.cached` / `command.truncated` / `header.run_id`
+  `command.hint-urls` / `command.retry_command` / `command.cached` / `command.cached_elapsed` /
+  `command.truncated` / `header.run_id`
   などフィールド単位の詳細を英文で説明する。
   短縮版には`_note`キーでフル版の取得方法を案内する。
   公開窓口は`pyfltr/llm_output.py`の`get_schema_hints(full=...)`

{pyfltr-3.3.0 → pyfltr-3.3.2}/docs/guide/configuration-tools.md

@@ -349,6 +349,25 @@ GitHub ActionsでCIを実行する場合は[jdx/mise-action](https://github.com/
 
 miseを使わず、PATH上のバイナリを直接使う場合は`bin-runner = "direct"`を設定する。
 
+### mise-auto-trust
+
+`mise`モードでは、worktreeやdotfiles配下のディレクトリなど、`mise.toml`が未信頼扱いになっている場合に
+事前チェックが失敗することがある。
+既定では`mise-auto-trust = true`となっており、未信頼configを検出すると`mise trust --yes --all`を自動実行して
+信頼を確立してからリトライする。
+`--all`オプションはcwdおよびその親ディレクトリにある全configを対象とするため、
+プロジェクト外の親ディレクトリに`mise.toml`が存在する場合もまとめて信頼される点に注意する。
+
+`mise-auto-trust`が不要な場合は無効化できる。
+
+```toml
+[tool.pyfltr]
+mise-auto-trust = false
+```
+
+無効化した場合、未信頼configが原因の失敗はmise由来のエラーメッセージとともに`failed`扱いとなる。
+手動で`mise trust`を実行して対処する。
+
 ### バージョン指定
 
 `{command}-version`でbin-runner対応ツールのバージョンを指定できる。既定は`"latest"`。

{pyfltr-3.3.0 → pyfltr-3.3.2}/docs/guide/configuration.md

@@ -245,4 +245,4 @@ Claude Codeなど末尾だけを読み取るツールでも実行結果を把握
 ---
 
 個別のツール設定（2段階実行、ファイルパターン、直接実行 / js-runner / bin-runnerのカテゴリ別設定、
-カスタムコマンド等）の詳細は[ツール別設定](configuration-tools.md)を参照。
+`mise-auto-trust`によるmise未信頼の自動対応、カスタムコマンド等）の詳細は[ツール別設定](configuration-tools.md)を参照。

{pyfltr-3.3.0 → pyfltr-3.3.2}/docs/guide/usage.md

@@ -222,6 +222,8 @@ pyfltr ci --commands=ruff-check,markdownlint [files and/or directories ...]
 ```
 
 カンマ区切りで実行するツールだけ指定する。全サブコマンドで使用可能。
+`--commands`は複数回指定も可能で、カンマ区切りと併用できる。
+例えば`--commands=mypy --commands=pyright,ruff-check`は`--commands=mypy,pyright,ruff-check`と同じになる。
 
 以下のエイリアスも使用可能。(例: `--commands=format`)
 
@@ -330,10 +332,9 @@ CLIオプション`--output-format`が指定されている場合は環境変数
 出力は以下5種別のレコードからなる。`kind`フィールドでレコード種別を判別する。
 
 - `header`: 先頭1行。実行環境情報
- （`version` / `run_id` / `python` / `executable` / `platform` / `cwd` / `commands_count` / `files` / `schema_hints`）。
-  既定では`commands_count`（整数）と短縮版`schema_hints`（約400文字）のみを出してヘッダーサイズを抑える。
-  `-v` / `--verbose`指定時はフル`commands`配列とフル`schema_hints`を出す。
-  フル`commands`配列は実行アーカイブの`meta.json`に常時保存されるため、短縮時も`show-run <run_id>`で参照できる
+ （`version` / `run_id` / `python` / `executable` / `platform` / `cwd` / `commands` / `files` / `schema_hints`）。
+  `commands`は実行対象（有効化された、`--only-failed`適用後の）コマンド名配列。
+  既定は短縮版`schema_hints`（約400文字）。`-v` / `--verbose`指定時は`schema_hints`をフル版（約1,500文字）へ切り替える
 - `warning`: pyfltrが検出した設定・実行時の警告（`source`で発生元を識別）
 - `diagnostic`: `(command, file)`単位で集約された診断。個別指摘は`messages[]`配列に格納
 - `command`: 1コマンド1レコードの実行メタ情報
@@ -343,7 +344,7 @@ CLIオプション`--output-format`が指定されている場合は環境変数
 [`pyfltr show-run`](#show-run) / [`pyfltr list-runs`](#list-runs)で該当runの詳細を参照できる。
 
 ```json
-{"kind":"header","version":"3.0.0","run_id":"01HXYZ...","python":"3.12.0 ...","executable":"/usr/bin/python3","platform":"linux","cwd":"/work","commands_count":2,"files":12,"schema_hints":{"header":"...","_note":"full schema available with -v / --verbose ..."}}
+{"kind":"header","version":"3.0.0","run_id":"01HXYZ...","python":"3.12.0 ...","executable":"/usr/bin/python3","platform":"linux","cwd":"/work","commands":["mypy","ruff-format"],"files":12,"schema_hints":{"header":"...","_note":"full schema available with -v / --verbose ..."}}
 {"kind":"warning","source":"config","msg":"pre-commit が有効化されていますが、設定ファイルが見つかりません: .pre-commit-config.yaml"}
 {"kind":"diagnostic","command":"mypy","file":"src/a.py","messages":[{"line":42,"col":5,"msg":"Incompatible return value type"}]}
 {"kind":"command","command":"mypy","type":"linter","status":"failed","files":12,"elapsed":0.8,"diagnostics":1,"rc":1}

{pyfltr-3.3.0 → pyfltr-3.3.2}/mkdocs.yml

@@ -72,10 +72,10 @@ plugins:
 
         `--output-format=jsonl`でJSON Lines形式の構造化出力が得られる。レコードは5種類。
 
-        - `header`: 先頭1行。実行環境情報（`version` / `run_id` / `python` / `executable` / `platform` / `cwd` / `commands_count` / `files` / `schema_hints`）。既定では `commands_count`（整数）と短縮版 `schema_hints` のみを出力してヘッダーサイズを抑え、`-v` / `--verbose` 指定時にフル `commands` 配列とフル `schema_hints` へ切り替わる。`schema_hints` は各フィールドの意味を英語で補足する LLM 向けガイド
+        - `header`: 先頭1行。実行環境情報（`version` / `run_id` / `python` / `executable` / `platform` / `cwd` / `commands` / `files` / `schema_hints`）。`commands` は実行対象（有効化された）コマンド名配列。既定では短縮版 `schema_hints` を出し、`-v` / `--verbose` 指定時にフル `schema_hints` へ切り替わる。`schema_hints` は各フィールドの意味を英語で補足する LLM 向けガイド
         - `warning`: pyfltr が検出した設定・実行時の警告（`source` で発生元を識別）
         - `diagnostic`: `(command, file)` 単位で1行に集約される診断。個別指摘は `messages[]` 配列（各要素は `line` / `col` / `rule` / `severity` / `fix` / `msg` / `hint`）として格納される。`fix` は `"safe"` / `"unsafe"` / `"suggested"` / `"none"` の4値を取り、ツールが自動修正情報を返さない場合はフィールドごと省略。`hint` は textlint の頻出ルールなど、pyfltr 側でヒントを事前登録したルールにのみ付与される
-        - `command`: ツールごとの実行結果サマリ（`status` / `elapsed` / `diagnostics` / `rc` / `retry_command` / `truncated` / `cached` / `cached_from` / `hint-urls`）。`hint-urls` は rule→ドキュメントURLの辞書
+        - `command`: ツールごとの実行結果サマリ（`status` / `elapsed` / `diagnostics` / `rc` / `retry_command` / `truncated` / `cached` / `cached_from` / `cached_elapsed` / `hint-urls`）。`cached=true` のとき `elapsed` は省略され前回実行時の計測値を `cached_elapsed` として提示する。`hint-urls` は rule→ドキュメントURLの辞書
         - `summary`: 最終1行の全体集計（`succeeded` / `formatted` / `failed` / `skipped` / `diagnostics` / `exit`）。`failed > 0` のとき英語の `guidance` 配列を付与し、再実行コマンドや `show-run` の案内を返す。直接指定ファイルが `exclude` / `.gitignore` で全除外された場合は `fully_excluded_files` にパス一覧を付与する（非空時のみ）
 
         stdoutモード（`--output-file`未指定）の出力順は`header`→ツール完了順に`diagnostic`+`command`→`warning`→`summary`。stdoutへJSONLのみを書き、進捗ログやTUIは無音化される。`--output-file`指定時はファイルへJSONLを書き、stdoutには従来どおりのテキスト出力を並行出力する（ローカル実行で進捗を追える）。

{pyfltr-3.3.0 → pyfltr-3.3.2}/pyfltr/command.py

@@ -300,15 +300,32 @@ def _resolve_bin_commandline(
             raise FileNotFoundError("mise")
         tool_name = spec.mise_backend or spec.bin_name
         tool_spec = f"{tool_name}@{version}"
-        # バージョン指定込みでツールの利用可否を事前チェック
-        check = subprocess.run(
-            ["mise", "exec", tool_spec, "--", spec.bin_name, "--version"],
-            capture_output=True,
-            text=True,
-            check=False,
-        )
-        if check.returncode != 0:
-            raise FileNotFoundError(f"mise exec {tool_spec} -- {spec.bin_name}")
+        check_args = ["mise", "exec", tool_spec, "--", spec.bin_name, "--version"]
+        trusted = False
+        while True:
+            # バージョン指定込みでツールの利用可否を事前チェック
+            check = subprocess.run(
+                check_args,
+                capture_output=True,
+                text=True,
+                check=False,
+            )
+            if check.returncode == 0:
+                break
+            stderr = check.stderr
+            # config未信頼が原因かつ自動trust有効なら1回だけ信頼してリトライ
+            if not trusted and config["mise-auto-trust"] and "not trusted" in stderr:
+                trust = subprocess.run(
+                    ["mise", "trust", "--yes", "--all"],
+                    capture_output=True,
+                    text=True,
+                    check=False,
+                )
+                if trust.returncode == 0:
+                    trusted = True
+                    continue
+                raise FileNotFoundError(f"mise trust --yes --all: {trust.stderr.strip()}")
+            raise FileNotFoundError(f"mise exec {tool_spec} -- {spec.bin_name}: {stderr.strip()}")
         return "mise", ["exec", tool_spec, "--", spec.bin_name]
 
     raise ValueError(f"bin-runnerの設定値が正しくありません: {runner=}")

{pyfltr-3.3.0 → pyfltr-3.3.2}/pyfltr/config.py

@@ -110,6 +110,11 @@ DEFAULT_CONFIG: dict[str, typing.Any] = {
     # - mise: mise exec <tool>@<version> -- <cmd>（既定）
     # - direct: PATH 上のバイナリを直接実行
     "bin-runner": "mise",
+    # mise 実行時に対象ディレクトリの config が未信頼だった場合、
+    # 自動で ``mise trust --yes --all`` を実行して再試行するか。
+    # worktree や dotfiles 配下など mise.toml が未信頼扱いになりやすい
+    # 環境での手動介入を不要にするための opt-out 設定（既定は有効）。
+    "mise-auto-trust": True,
     # コマンド毎に有効無効、パス、追加の引数を設定
     # 言語カテゴリ (python / javascript / rust / dotnet) に属するツールは v3.0.0 で
     # opt-in 化したため、既定値は False。preset で推奨ツールが True になり、

{pyfltr-3.3.0 → pyfltr-3.3.2}/pyfltr/llm_output.py

@@ -154,8 +154,8 @@ def build_lines(
     ``warnings``は``pyfltr.warnings_.collected_warnings()``の返り値を想定する。
     ``run_id``が指定されていればheaderレコードに埋め込む。
     ``launcher_prefix``が指定されていれば``summary.guidance``内の起動コマンド表記に反映する。
-    ``verbose=True`` でheaderへフル``commands``配列とフル``schema_hints``を埋め込む
-    (既定は``commands_count``と短縮``schema_hints``)。
+    ``verbose=True`` でheaderの``schema_hints``をフル版に切り替える
+    (既定は短縮版。``commands`` 配列は常に出力する)。
     """
     ordered = sorted(results, key=lambda r: _command_index(config, r.command))
 
@@ -198,8 +198,7 @@ def write_jsonl_header(commands: list[str], files: int, *, run_id: str | None =
     headerレコードに含める (アーカイブ参照時の識別キー)。
     出力先は ``pyfltr.cli.configure_structured_output()`` が設定した handler に従う
     （stdout もしくは `--output-file` の FileHandler）。
-    ``verbose=True`` でフル``commands``配列とフル``schema_hints``を埋め込む
-    (既定は``commands_count``と短縮``schema_hints``でヘッダーサイズを抑制)。
+    ``verbose=True`` でheaderの``schema_hints``をフル版に切り替える（既定は短縮版）。
     """
     with _write_lock:
         pyfltr.cli.structured_logger.info(_dump(_build_header_record(commands, files, run_id=run_id, verbose=verbose)))
@@ -258,8 +257,8 @@ def _dump(record: dict[str, typing.Any]) -> str:
 
 _SCHEMA_HINTS_COMPACT: dict[str, str] = {
     "_note": "non-obvious fields only; -v or get_schema_hints(full=True) for full schema",
-    "header.commands_count": "integer count; -v emits the full commands array (also archived)",
     "command.retry_command": "shell to re-run only failing files; failure runs only",
+    "command.cached_elapsed": "previous-run elapsed seconds restored with cached=true; this run skipped execution",
     "command.hint-urls": "rule id -> docs URL map; omitted when no URLs resolved",
     "messages[].fix": "safe/unsafe/suggested = auto-fixable; none = no fix; omitted = no info",
 }
@@ -296,6 +295,10 @@ _SCHEMA_HINTS: dict[str, str] = {
         "shell command to re-run only this command on failing files; populated only when the command failed"
     ),
     "command.cached": "true = result restored from file-hash cache; rerun with --no-cache to force",
+    "command.cached_elapsed": (
+        "previous-run elapsed seconds (seconds) restored alongside cached=true; this run skipped execution."
+        " elapsed is omitted when cached=true so only this key represents timing"
+    ),
     "command.truncated": ("diagnostics or message were trimmed; full content is in the archive directory (see header.run_id)"),
     "header.run_id": "ULID identifying this run; use 'pyfltr show-run <run_id>' to fetch full output",
     "warning.hint": (
@@ -331,11 +334,9 @@ def _build_header_record(
 ) -> dict[str, typing.Any]:
     """実行環境の基本情報を header レコード dict として返す。
 
-    既定 (``verbose=False``) では ``commands`` フィールドを ``commands_count`` (整数) に
-    置換し、``schema_hints`` も短縮版にしてヘッダーサイズを抑える。
-    ``verbose=True`` でフル ``commands`` 配列とフル ``schema_hints`` を埋め込む。
-    フル ``commands`` 配列は実行アーカイブの ``meta.json`` に常時保存されるため、
-    短縮時も ``show-run`` 経由で参照できる。
+    ``commands`` は「実際に実行されるツール集合」（``--only-failed`` や disabled ツール除外後）を
+    前提とする。呼び出し側で絞り込み済みの配列を渡すこと。
+    ``verbose`` は ``schema_hints`` のフル／短縮切替のみに効く。
     """
     record: dict[str, typing.Any] = {
         "kind": "header",
@@ -345,11 +346,8 @@ def _build_header_record(
         "platform": sys.platform,
         "cwd": os.getcwd(),
         "files": files,
+        "commands": commands,
     }
-    if verbose:
-        record["commands"] = commands
-    else:
-        record["commands_count"] = len(commands)
     if run_id is not None:
         record["run_id"] = run_id
     # LLM 向けフィールド補足。毎回出力する (header は各 run の先頭 1 行のみ)。
@@ -408,6 +406,8 @@ def _build_command_record(
     メッセージ切り詰めまたは diagnostic 切り詰めが発生した場合は ``truncated`` メタを
     添付する。retry_command は ``CommandResult.retry_command`` が設定されていれば含める。
     ``hint_urls`` が非空なら ``hint-urls`` キー（ハイフン区切り）で埋め込む。
+    ``result.cached`` が真のときは ``elapsed`` ではなく ``cached_elapsed`` キーに
+    リネームして出力する（実行をスキップした前回値である旨を LLM に明示するため）。
     """
     record: dict[str, typing.Any] = {
         "kind": "command",
@@ -415,9 +415,13 @@ def _build_command_record(
         "type": result.command_type,
         "status": result.status,
         "files": result.files,
-        "elapsed": round(result.elapsed, 2),
         "diagnostics": diagnostics,
     }
+    # cached=True のときは実行をスキップしているため ``elapsed`` は出力せず
+    # 前回実行時の計測値を ``cached_elapsed`` として提示する。LLM が「今回の実行時間」と
+    # 誤解するのを避けるため両者を同時に出さない設計。
+    elapsed_key = "cached_elapsed" if result.cached else "elapsed"
+    record[elapsed_key] = round(result.elapsed, 2)
     if result.returncode is not None:
         record["rc"] = result.returncode
 

{pyfltr-3.3.0 → pyfltr-3.3.2}/pyfltr/main.py

@@ -137,7 +137,10 @@ def _make_common_parent(custom_commands: collections.abc.Iterable[str] = ()) ->
     common.add_argument(
         "--commands",
         default=None,
-        help="カンマ区切りのコマンド一覧を指定します。"
+        action="append",
+        help="対象のコマンド一覧を指定します。複数回指定可能で、各値はカンマ区切りも併用可能です。"
+        "例: --commands=mypy --commands=pyright,ruff-check は"
+        " --commands=mypy,pyright,ruff-check と同等です。"
         "(既定: ビルトイン + カスタムコマンドを含む、pyproject.toml で有効な全コマンド)",
     )
     common.add_argument("--ui", default=None, action="store_true", help="Textual UI を強制的に有効化します。")
@@ -358,7 +361,8 @@ def _apply_subcommand_defaults(args: argparse.Namespace) -> None:
     if subcommand in ("run", "fast", "run-for-agent"):
         args.exit_zero_even_if_formatted = True
     if subcommand == "fast" and args.commands is None:
-        args.commands = "fast"
+        # ``--commands`` は ``action="append"`` 化によりリストで保持する。
+        args.commands = ["fast"]
     if subcommand == "run-for-agent" and args.output_format is None:
         args.output_format = "jsonl"
 
@@ -432,6 +436,26 @@ def run(sys_args: typing.Sequence[str] | None = None) -> int:
             os.chdir(original_cwd)
 
 
+def _flatten_commands_arg(values: list[str] | None, config: pyfltr.config.Config) -> list[str]:
+    """``--commands`` で渡されたリスト（複数回指定の集合）をコマンド名配列に展開する。
+
+    各要素にはカンマ区切りで複数のコマンドを含められるため、split した上で
+    先頭出現を優先した重複除去を行う。``None`` の場合は設定上の全登録コマンド
+    （ビルトイン + custom-commands）を返す。
+    """
+    if values is None:
+        return list(config.command_names)
+    seen: set[str] = set()
+    result: list[str] = []
+    for raw in values:
+        for name in raw.split(","):
+            if name == "" or name in seen:
+                continue
+            seen.add(name)
+            result.append(name)
+    return result
+
+
 _OUTPUT_FORMAT_ENV = "PYFLTR_OUTPUT_FORMAT"
 _VALID_OUTPUT_FORMATS: frozenset[str] = frozenset(pyfltr.formatters.FORMATTERS.keys())
 
@@ -534,8 +558,9 @@ def _run_impl(
     # ビルトインのみの default を返すと custom-commands が常にスキップされる。
     # load_config 後に実体を決定することで、ユーザーが登録した custom-commands
     # (例: svelte-check) も `run` / `ci` サブコマンドのデフォルト動作で走るようにする。
-    commands_arg: str = args.commands if args.commands is not None else ",".join(config.command_names)
-    commands: list[str] = pyfltr.config.resolve_aliases(commands_arg.split(","), config)
+    # ``--commands`` は ``action="append"`` によりリストで渡るため、各要素を
+    # カンマ区切りで再分割して平坦化する。重複は先出を優先して除去する。
+    commands: list[str] = pyfltr.config.resolve_aliases(_flatten_commands_arg(args.commands, config), config)
     for command in commands:
         if command not in config.values:
             parser.error(f"コマンドが見つかりません: {command}")
@@ -608,6 +633,11 @@ def run_pipeline(
     if only_failed_exit_early:
         return 0, None
 
+    # 実行対象として有効化されていないコマンドはパイプラインから除外する。
+    # split_commands_for_execution と同じ条件 (``config.values.get(cmd) is True``) で絞り込み、
+    # JSONL header・実行アーカイブ・formatter ctx へ渡す commands を「実際に実行されるもの」に統一する。
+    commands = [c for c in commands if config.values.get(c) is True]
+
     # retry_command 再構成用のベース情報を確定する。original_cwd は run() が保存した
     # --work-dir 適用前の cwd、original_sys_args は起動時の sys.argv[1:] のコピー。
     effective_cwd = original_cwd if original_cwd is not None else os.getcwd()

{pyfltr-3.3.0 → pyfltr-3.3.2}/tests/command_core_test.py

@@ -604,7 +604,7 @@ def test_resolve_bin_commandline_mise_not_installed(mocker) -> None:
 
 
 def test_resolve_bin_commandline_mise_tool_not_installed(mocker) -> None:
-    """miseモードでツールが未インストールの場合、FileNotFoundErrorを送出する。"""
+    """miseモードでツールが未インストールの場合、FileNotFoundErrorをstderr付きで送出する。"""
     mocker.patch("shutil.which", return_value="/usr/local/bin/mise")
     mocker.patch(
         "subprocess.run",
@@ -619,10 +619,169 @@ def test_resolve_bin_commandline_mise_tool_not_installed(mocker) -> None:
     config = pyfltr.config.create_default_config()
     config.values["bin-runner"] = "mise"
 
-    with pytest.raises(FileNotFoundError, match="mise exec"):
+    with pytest.raises(FileNotFoundError, match="tool not found"):
         pyfltr.command._resolve_bin_commandline("ec", config)
 
 
+def test_resolve_bin_commandline_mise_untrusted_auto_trust_success(mocker) -> None:
+    """未信頼エラー → trust成功 → 再チェック成功の3段で最終的に通常成功扱いになる。"""
+    mocker.patch("shutil.which", return_value="/usr/local/bin/mise")
+    mock_run = mocker.patch(
+        "subprocess.run",
+        side_effect=[
+            # 1回目の事前チェック: config未信頼で失敗
+            subprocess.CompletedProcess(
+                ["mise", "exec"],
+                returncode=1,
+                stdout="",
+                stderr="mise ERROR Config files in /path/to/mise.toml are not trusted.",
+            ),
+            # mise trust --yes --all: 成功
+            subprocess.CompletedProcess(
+                ["mise", "trust", "--yes", "--all"],
+                returncode=0,
+                stdout="",
+                stderr="",
+            ),
+            # 2回目の事前チェック（リトライ）: 成功
+            subprocess.CompletedProcess(
+                ["mise", "exec"],
+                returncode=0,
+                stdout="typos 1.0.0",
+                stderr="",
+            ),
+        ],
+    )
+
+    config = pyfltr.config.create_default_config()
+    config.values["bin-runner"] = "mise"
+    config.values["mise-auto-trust"] = True
+
+    path, prefix = pyfltr.command._resolve_bin_commandline("typos", config)
+
+    assert path == "mise"
+    assert prefix == ["exec", "typos@latest", "--", "typos"]
+    # 事前チェック → trust → リトライの3回が実際に発生したことを確認
+    assert mock_run.call_count == 3
+
+
+def test_resolve_bin_commandline_mise_untrusted_auto_trust_disabled(mocker) -> None:
+    """mise-auto-trust=False のとき trust が呼ばれず、stderr含むエラーメッセージで失敗する。"""
+    mocker.patch("shutil.which", return_value="/usr/local/bin/mise")
+    mock_run = mocker.patch(
+        "subprocess.run",
+        return_value=subprocess.CompletedProcess(
+            ["mise", "exec"],
+            returncode=1,
+            stdout="",
+            stderr="mise ERROR Config files in /path/to/mise.toml are not trusted.",
+        ),
+    )
+
+    config = pyfltr.config.create_default_config()
+    config.values["bin-runner"] = "mise"
+    config.values["mise-auto-trust"] = False
+
+    with pytest.raises(FileNotFoundError, match="not trusted"):
+        pyfltr.command._resolve_bin_commandline("typos", config)
+
+    # trust コマンドは呼ばれていないことを確認（subprocess.run の呼び出しは1回のみ）
+    assert mock_run.call_count == 1
+
+
+def test_resolve_bin_commandline_mise_other_error_no_retry(mocker) -> None:
+    """未信頼以外のエラー（plugin not found等）ではtrustを呼ばずそのまま失敗する。"""
+    mocker.patch("shutil.which", return_value="/usr/local/bin/mise")
+    mock_run = mocker.patch(
+        "subprocess.run",
+        return_value=subprocess.CompletedProcess(
+            ["mise", "exec"],
+            returncode=1,
+            stdout="",
+            stderr="mise ERROR plugin not found: typos",
+        ),
+    )
+
+    config = pyfltr.config.create_default_config()
+    config.values["bin-runner"] = "mise"
+    config.values["mise-auto-trust"] = True
+
+    with pytest.raises(FileNotFoundError, match="plugin not found"):
+        pyfltr.command._resolve_bin_commandline("typos", config)
+
+    # trust コマンドは呼ばれていないことを確認（subprocess.run の呼び出しは1回のみ）
+    assert mock_run.call_count == 1
+
+
+def test_resolve_bin_commandline_mise_untrusted_auto_trust_retry_failure(mocker) -> None:
+    """trust後の再チェックも失敗する場合、リトライが1回で打ち切られ通常失敗扱いになる。"""
+    mocker.patch("shutil.which", return_value="/usr/local/bin/mise")
+    mocker.patch(
+        "subprocess.run",
+        side_effect=[
+            # 1回目の事前チェック: config未信頼で失敗
+            subprocess.CompletedProcess(
+                ["mise", "exec"],
+                returncode=1,
+                stdout="",
+                stderr="mise ERROR Config files in /path/to/mise.toml are not trusted.",
+            ),
+            # mise trust --yes --all: 成功
+            subprocess.CompletedProcess(
+                ["mise", "trust", "--yes", "--all"],
+                returncode=0,
+                stdout="",
+                stderr="",
+            ),
+            # 2回目の事前チェック（リトライ）: 再度失敗
+            subprocess.CompletedProcess(
+                ["mise", "exec"],
+                returncode=1,
+                stdout="",
+                stderr="mise ERROR some other failure after trust",
+            ),
+        ],
+    )
+
+    config = pyfltr.config.create_default_config()
+    config.values["bin-runner"] = "mise"
+    config.values["mise-auto-trust"] = True
+
+    with pytest.raises(FileNotFoundError, match="some other failure after trust"):
+        pyfltr.command._resolve_bin_commandline("typos", config)
+
+
+def test_resolve_bin_commandline_mise_untrusted_auto_trust_trust_failure(mocker) -> None:
+    """mise trust コマンド自体が失敗した場合、trust.stderr を含むエラーで即座に失敗する。"""
+    mocker.patch("shutil.which", return_value="/usr/local/bin/mise")
+    mocker.patch(
+        "subprocess.run",
+        side_effect=[
+            # 事前チェック: config未信頼で失敗
+            subprocess.CompletedProcess(
+                ["mise", "exec"],
+                returncode=1,
+                stdout="",
+                stderr="mise ERROR Config files in /path/to/mise.toml are not trusted.",
+            ),
+            # mise trust --yes --all: 失敗（権限不足等）
+            subprocess.CompletedProcess(
+                ["mise", "trust", "--yes", "--all"],
+                returncode=1,
+                stdout="",
+                stderr="mise ERROR permission denied: /path/to/mise.toml",
+            ),
+        ],
+    )
+
+    config = pyfltr.config.create_default_config()
+    config.values["bin-runner"] = "mise"
+    config.values["mise-auto-trust"] = True
+
+    with pytest.raises(FileNotFoundError, match="permission denied"):
+        pyfltr.command._resolve_bin_commandline("typos", config)
+
+
 def test_failed_resolution_result() -> None:
     """_failed_resolution_resultが失敗用のCommandResultを返す。"""
     command_info = pyfltr.config.CommandInfo(type="linter")

{pyfltr-3.3.0 → pyfltr-3.3.2}/tests/config_test.py

@@ -852,6 +852,26 @@ bin-runner = "bogus"
         pyfltr.config.load_config(config_dir=tmp_path)
 
 
+def test_mise_auto_trust_default() -> None:
+    """mise-auto-trust の既定値は True。"""
+    config = pyfltr.config.create_default_config()
+    assert config["mise-auto-trust"] is True
+
+
+def test_mise_auto_trust_disable(tmp_path: pathlib.Path) -> None:
+    """pyproject.toml で mise-auto-trust を False に設定できる。"""
+    (tmp_path / "pyproject.toml").write_text("[tool.pyfltr]\nmise-auto-trust = false\n")
+    config = pyfltr.config.load_config(config_dir=tmp_path)
+    assert config["mise-auto-trust"] is False
+
+
+def test_mise_auto_trust_invalid_type_rejected(tmp_path: pathlib.Path) -> None:
+    """mise-auto-trust に bool 以外の値を指定するとエラーになる。"""
+    (tmp_path / "pyproject.toml").write_text('[tool.pyfltr]\nmise-auto-trust = "yes"\n')
+    with pytest.raises(ValueError, match="mise-auto-trust"):
+        pyfltr.config.load_config(config_dir=tmp_path)
+
+
 def test_preset_latest_suppresses_language_categories(tmp_path: pathlib.Path) -> None:
     """preset = "latest" 単独 (カテゴリキー全 False) では全言語のツールが False に押し戻される。"""
     (tmp_path / "pyproject.toml").write_text('[tool.pyfltr]\npreset = "latest"\n')