pyfltr 3.22.0__tar.gz → 3.22.2__tar.gz

{pyfltr-3.22.0 → pyfltr-3.22.2}/.claude/agents/tool-compat-checker.md

@@ -16,8 +16,8 @@ pyfltrの対応ツールがバージョンアップで挙動を変えていな
 pyfltrは各ツールのバージョン追従が必要なため、差分の確認を定期的に行う。
 対応ツールの集合は `pyfltr/tools.py` の `BUILTIN_COMMANDS` を典拠とする。
 チェック対象は`BUILTIN_COMMANDS`の各`CommandInfo`にある`defaults`の引数と、
-`diagnostic_pattern`、`parser`、`path_base_parser`が参照する解析処理。
-関数パーサーは`pyfltr/parsing/tools.py`等の登録先を読み、`path_base_parser`にはパス基準の文脈が渡ることも確認する。
+`diagnostic_pattern`、`parser`、`path_resolving_parser`が参照する解析処理。
+関数パーサーは`pyfltr/parsing/tools.py`等の登録先を読み、`path_resolving_parser`には解析境界のパス変換関数が渡ることも確認する。
 
 ## 入力
 
@@ -57,7 +57,7 @@ pyfltrは各ツールのバージョン追従が必要なため、差分の確
 
    - JSON Lines全体を保存し、`header`レコード（`{"kind": "header", "run_id": "..."}`形式）の`run_id`を記録する。`head`等で先頭行だけを読むパイプは使わない
    - `uv run pyfltr show-run <run_id> --commands=<tool> --output --output-format=text`へ記録済みrun IDを明示し、JSON Linesへラップされていない生出力を取得する。`latest`は使わない
-   - 出力が対象`CommandInfo.diagnostic_pattern`、`parser`、`path_base_parser`の登録済み解析処理に対応するか比較する
+   - 出力が対象`CommandInfo.diagnostic_pattern`、`parser`、`path_resolving_parser`の登録済み解析処理に対応するか比較する
    - 必須グループ（`file`、`line`、`message`）が正常に取得されるか確認
 
 5. 報告

{pyfltr-3.22.0 → pyfltr-3.22.2}/.claude/rules/targets.md

@@ -67,10 +67,10 @@ paths:
 外部パス専用の追加実行を行ったうえで結果を`CommandResult.merge`で集約する。
 除外対象ツールでは外部パスを破棄して警告のみ発行する。
 
-`CommandInfo.config_files`は`load_config`の設定不在時の警告とキャッシュキー算出に専用で、
+`CommandInfo.config_files`は設定不在時の警告とキャッシュキー算出に専用で、
 `--config`注入候補（`config_inject_candidates`）とは責務を分離する。
-設定不在時の警告は起点cwd直下のみを判定対象とし、サブプロジェクト別config解決
-（`load_config(for_subproject=True)`）では発行しない。
+設定不在時の警告は実行パイプラインが実行対象の確定後に今回の実行対象だけを判定し、
+起点cwd直下のみを判定対象とする。サブプロジェクトのディレクトリでは判定しない。
 `config_inject_candidates`の解決も起点cwd直下を基準とするため、
 サブプロジェクトのディレクトリを基準にした不在判定は誤検知になる。
 

{pyfltr-3.22.0 → pyfltr-3.22.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pyfltr
-Version: 3.22.0
+Version: 3.22.2
 Summary: 多言語プロジェクトの品質チェックを一元管理し、コーディングエージェントから扱える形で提供する基盤。
 Project-URL: Homepage, https://github.com/ak110/pyfltr
 Author-email: "aki." <aki@tqzh.tk>

{pyfltr-3.22.0 → pyfltr-3.22.2}/docs/development/architecture.md

@@ -20,6 +20,12 @@ TUI/非TUIの分岐はこの関数の内側で行い、パイプライン共通
 各ステージの結果は`CommandResult`に集約され、ステージ完了ごとに`archive_hook`へ渡される。
 ステージ間の中断（`--fail-fast`時の打ち切りなど）は`stage_runner`の共通ヘルパーで吸収する。
 
+fixステージの結果は同じツールの通常ステージと重複するため、成功時は最終結果へ含めず保存だけを行う。
+fixステージが失敗した場合は、同じツールの通常ステージの結果（成功・スキップを含む）へ失敗と出力を統合した1件を
+最終結果とし、表示・終了コード・`retry_command`・アーカイブへ同じ結果を渡す。
+`--fail-fast`で停止する場合もfixステージの失敗を記録し、同じツールのスキップ結果を重ねない。
+通常ステージの成功でfixステージの失敗が消えると、修正処理の失敗が利用者へ届かないためである。
+
 ## 層順とサブパッケージの責務 {#modules}
 
 依存は次の下位から上位への7層に整理する。同じ層または下位だけをimportし、
@@ -234,6 +240,22 @@ python-runnerへ委譲せず`uvx <bin>`で別環境へ解決する。
 - 出力スキーマは現行を維持する（JSONL・SARIF・archive・MCP読み取り系APIでサブプロジェクト
   識別フィールドを新設しない）。サブプロジェクト境界をまたぐ実行結果は `CommandResult.merge` で
   1件に集約し、人間向け `output` には `# subproject: <相対パス>` の区切り行のみ挿入する
+- 診断の`file`は解析境界（`pyfltr.parsing.entry.parse_errors`）で起点相対へ揃え、統合時には付け替えない。
+  通常・fix・2段階などの各実行処理は`ExecutionRequest.parse_errors`を通じてツールの実行cwd（`path_base`）と実行起点（`start_cwd`）を渡し、
+  `pyfltr.paths.to_start_relative`が相対パスを実行cwd基準で絶対化してから起点相対へ変換する。
+  起点外を指すパスは`../`相対を含めて`/`区切りの絶対パスで返し、対象集合が保持する外部パスと同じ表現に揃える。
+  各パーサーはツール出力のパスを区切りの統一だけで返し、基準変換を持たない。
+  診断メッセージにもパスを埋め込むaridは`CommandInfo.path_resolving_parser`として同じ変換関数を受け取る。
+  一時ファイルから元ファイルへの付け替え（`file_path_remap`）は変換の後に適用し、付け替え後の値は再変換しない。
+  `--only-failed`と`retry_command`は起点相対の対象集合と診断の`file`を文字列で突合するため、
+  基準が子プロジェクト相対のまま残ると失敗ファイルを選べない
+- 診断を起点相対へ揃える前の版が保存したpytestのアーカイブは、子プロジェクト相対の診断を持つ。
+  `ArchiveStore.read_tool_diagnostics`は保存済み生出力の`# subproject:`区間ごとに解析をやり直し、
+  `file`・行・メッセージが一致する区間が1件だけの診断を起点相対へ補正して返す。
+  区間を一意に決められない診断は変えず、保存ファイルも書き換えない。
+  新しい版はrunの`meta.json`へ`diagnostic_paths: start-relative`を書き、このキーを持たないrunだけを補正の対象にする。
+  新しい版のrunを補正すると、起点直下の診断を同じ位置・メッセージを持つ子の診断と取り違えるためである。
+  診断のbasenameや末尾一致で所属を推測する案は、子プロジェクト間で同じ相対名を持つファイルを誤選択するため採らない
 - `subprocess.Popen` へのcwd切り替えは引数渡しのみで実現する。`os.chdir()` を
   サブプロジェクトループで使うとプロセスcwdが並列実行中の他ツールへ干渉するため、
   cwd依存処理（mise・git・ファイル走査・snapshot等）は明示引数で起点cwdを取得する形に統一する
@@ -404,7 +426,7 @@ CLI JSONLはシェルしか使えない消費側向けの代替手段として
 対象はJSON Lines出力・CLIテキスト出力・CLIのJSON出力・MCPツール応答・SARIF・Code Quality・
 GitHub Annotationsの各出力で返すファイルパスである。
 除外対象や欠落対象として警告へ載せるパスも含む。
-生成時は`pyfltr.paths.normalize_separators`または`pyfltr.paths.to_cwd_relative`を経由する。
+生成時は`pyfltr.paths.normalize_separators`・`pyfltr.paths.to_cwd_relative`・`pyfltr.paths.to_start_relative`のいずれかを経由する。
 公開値を`str()`で直接文字列化しない。
 pyfltr自身が実装するツール（`colloquial-check`など）の標準出力に含めるファイル位置も、
 生成時点で同じ正規化を経由する。これらのツールの生標準出力は`show-run --commands <name> --output`と
@@ -736,6 +758,8 @@ subparsersを`required=True`で必須化し、引数なし実行時のフォー
 
 アーカイブの保存キーはツール名固定のため、同一ツール名のfixステージと通常ステージは
 通常ステージで上書きされる。
+fixステージが失敗した場合は通常ステージの結果へ統合した1件を保存するため、
+`show-run`からfixステージの失敗と出力を取得できる（本書「実行パイプライン」を参照）。
 `show-run`は各ツールの最終保存結果のみを参照可能で、ステージ別保存への拡張は対象外とする。
 
 run_id解決は完全一致に加えて前方一致と`latest`エイリアスを許容する。
@@ -856,9 +880,9 @@ worker方式は起動費用を持つが、共有状態を分離し、子孫を
 プロセスグローバルなcwdに干渉しないため、`ThreadPoolExecutor`によるツールの並列実行や
 MCPクライアントからの並行ツール呼び出しでも実行起点を呼び出し単位で維持できる。
 
-`work_dir`指定時は診断のファイルパスが絶対パスで返る場合がある。
-`pyfltr.paths.to_cwd_relative()`はプロセスのcwdだけを相対化の基準とし、
-`work_dir`を基準ディレクトリとして注入する仕組みを持たないためである。
+診断のファイルパスは解析境界で`start_cwd`（`work_dir`）を基準に相対化する（本書「モノレポ対応」を参照）。
+`pyfltr.paths.to_cwd_relative()`はプロセスのcwdだけを相対化の基準とするため、
+診断以外でこの関数を経由する値は`work_dir`指定時に絶対パスで返る場合がある。
 
 #### `run_pipeline()`戻り値
 

{pyfltr-3.22.0 → pyfltr-3.22.2}/docs/guide/configuration-tools.md

@@ -411,6 +411,15 @@ fix段では、pyfltrはtextlintを2段階で実行する（fix適用 → lint
 `--format` ペアを自動除去するためクラッシュしない。
 `--format` 指定は `textlint-lint-args`（lintモード専用）に書くことを推奨する。
 
+`textlint-args`へ`--cache`を書くと、lint段と後段のlintチェックはtextlintのキャッシュを使う。
+fixステップでは、pyfltrが起動コマンドの末尾へ`--no-cache`を加えてキャッシュを無効化する。
+textlintはキャッシュに一致したファイルを修正しようとすると例外で終了する場合があるためである。
+`command-info textlint`の`fix_commandline`にも同じ引数が現れる。
+
+fixステップが失敗した場合（終了コード1の例外を含む）は、後段のlintチェックが成功しても
+textlintを`failed`として扱い、fixステップの出力を結果へ残す。
+`show-run`やMCPの`show_run_output`でfixステップの出力を確認できる。
+
 ### prettier の 2 段階実行
 
 `prettier`は`--check`（読み取り専用）と`--write`（書き込み）が排他のため、pyfltrは2段階で実行する。

{pyfltr-3.22.0 → pyfltr-3.22.2}/docs/guide/custom-commands.md

@@ -43,7 +43,8 @@ fast = true
 - `pass-filenames`: ファイル引数をコマンドに渡すか否か（省略時は`true`）。
   プロジェクト全体を一括チェックするツールでは`false`に設定する
 - `config-files`: このコマンドの設定ファイル候補のリスト（省略時は空）。globパターン可。
-  有効化時にどれもプロジェクトルート直下に見つからないとpyfltrが警告を発行する（ツール自体は実行する）。
+  有効化したコマンドを実行するときに、どれもプロジェクトルート直下に見つからないとpyfltrが警告を発行する（ツール自体は実行する）。
+  `--commands`などで実行対象から外したコマンドは判定しない。
   pre-commit・prekなどの「設定ファイル無しでは機能しないツール」の設定不備を可視化する用途。
   判定はモノレポでも起点cwd直下のみを対象とし、サブプロジェクトのディレクトリでは行わない
 - `severity`: `"error"`（既定）または`"warning"`。

{pyfltr-3.22.0 → pyfltr-3.22.2}/docs/guide/recommended.md

@@ -735,6 +735,9 @@ textlint-lint-args = ["--format", "compact"]
 pyfltrはfix段の起動コマンドから`--format`ペアを自動除去するため。
 ただし新規設定では`textlint-lint-args`に書くことを推奨する。
 
+lint段を高速化するために`textlint-args`へ`--cache`を設定してよい。
+pyfltrはfix段の起動コマンドへ`--no-cache`を加えるため、自動修正ではtextlintのキャッシュを使わない。
+
 ## 呼び出し方の使い分け {#calling-style}
 
 状況に応じて`pyfltr`の呼び出し方を以下のいずれかから選ぶ。

{pyfltr-3.22.0 → pyfltr-3.22.2}/pyfltr/cli/mcp_server.py

@@ -410,7 +410,6 @@ async def tool_run(
             commands_list,
             config,
             start_cwd=base,
-            original_cwd=str(work_dir_path) if work_dir_path is not None else None,
             original_sys_args=args.retry_arguments(for_mcp=True),
             force_text_on_stderr=True,
             jsonl_warnings_reach_consumer=False,

{pyfltr-3.22.0 → pyfltr-3.22.2}/pyfltr/cli/pipeline.py

@@ -38,6 +38,7 @@ import pyfltr.command.targets
 import pyfltr.config.config
 import pyfltr.config.model
 import pyfltr.config.selection
+import pyfltr.config.validation
 import pyfltr.output.formatters
 import pyfltr.output.jsonl
 import pyfltr.output.logging_
@@ -248,7 +249,7 @@ def _make_attach_retry_command(
     *,
     retry_args_template: list[str],
     launcher_prefix: list[str],
-    original_cwd: str,
+    target_base_cwd: str,
 ) -> typing.Callable[[pyfltr.command.core_.CommandResult], None]:
     """retry_command付与フックを生成する。
 
@@ -261,7 +262,7 @@ def _make_attach_retry_command(
             result,
             retry_args_template=retry_args_template,
             launcher_prefix=launcher_prefix,
-            original_cwd=original_cwd,
+            target_base_cwd=target_base_cwd,
         )
 
     return _hook
@@ -295,8 +296,9 @@ def run_commands_with_cli(
     JSONL stdoutモードでのストリーミング出力に使用する。
 
     `archive_hook`が指定されている場合、各コマンド完了時に実行アーカイブへ書き込む。
-    fixステージの結果はsummaryに含めないが、アーカイブには通常ステージ以外も含めて
-    全実行を保存するためfixステージからも`archive_hook`を呼び出す。
+    成功したfixステージの結果はsummaryに含めず、アーカイブへの保存だけを行う。
+    失敗したfixステージの結果は同じツールの通常ステージの結果へ統合して
+    summary・`on_result`・アーカイブへ渡す（`pyfltr.command.stage_runner.run_stages`を参照）。
 
     `base_ctx`はパイプライン全体で不変のコンテキスト（config・all_files・cache_store・
     cache_run_idを含む）。各コマンド実行前に`ExecutionContext`を組み立てて渡す。
@@ -389,7 +391,6 @@ def run_pipeline(
     config: pyfltr.config.model.Config,
     *,
     start_cwd: pathlib.Path | None = None,
-    original_cwd: str | None = None,
     original_sys_args: list[str] | None = None,
     force_text_on_stderr: bool = False,
     jsonl_warnings_reach_consumer: bool = True,
@@ -402,7 +403,6 @@ def run_pipeline(
                 commands,
                 config,
                 start_cwd=start_cwd,
-                original_cwd=original_cwd,
                 original_sys_args=original_sys_args,
                 force_text_on_stderr=force_text_on_stderr,
                 jsonl_warnings_reach_consumer=jsonl_warnings_reach_consumer,
@@ -412,7 +412,6 @@ def run_pipeline(
         commands,
         config,
         start_cwd=start_cwd,
-        original_cwd=original_cwd,
         original_sys_args=original_sys_args,
         force_text_on_stderr=force_text_on_stderr,
         jsonl_warnings_reach_consumer=jsonl_warnings_reach_consumer,
@@ -425,7 +424,6 @@ def _run_pipeline(
     config: pyfltr.config.model.Config,
     *,
     start_cwd: pathlib.Path | None = None,
-    original_cwd: str | None = None,
     original_sys_args: list[str] | None = None,
     force_text_on_stderr: bool = False,
     jsonl_warnings_reach_consumer: bool = True,
@@ -470,7 +468,6 @@ def _run_pipeline(
     if isinstance(prepared, PipelineOutcome):
         return prepared
 
-    effective_cwd = original_cwd if original_cwd is not None else os.getcwd()
     effective_sys_args = list(original_sys_args) if original_sys_args is not None else list(sys.argv[1:])
     launcher_prefix = pyfltr.state.retry.detect_launcher_prefix()
     retry_args_template = pyfltr.state.retry.build_retry_args_template(effective_sys_args)
@@ -481,7 +478,8 @@ def _run_pipeline(
     attach_retry_command = _make_attach_retry_command(
         retry_args_template=retry_args_template,
         launcher_prefix=launcher_prefix,
-        original_cwd=effective_cwd,
+        # 対象ファイルは実行起点相対で保持されるため、起動時のcwdではなく実行起点を基準に絶対化する。
+        target_base_cwd=str(start_cwd_path),
     )
     base_ctx = _prepare_execution_context(config, prepared, start_cwd_path, cache_store, run_id)
     ctx = _prepare_run_output(
@@ -867,6 +865,8 @@ def _prepare_execution_targets(
         commands = _add_subproject_fast_pytest(commands, args, config, subproject_configs)
     requested_commands = list(commands)
     commands = [c for c in commands if pyfltr.config.selection.is_command_enabled_anywhere(c, config, subproject_configs)]
+    # 設定ファイル欠落の警告は確定した実行対象だけを判定する（未選択コマンドの警告を返さない）。
+    pyfltr.config.validation.warn_config_files(config, start_cwd_path, commands)
     unmet: list[str] = []
     if getattr(args, "commands", None) is not None:
         unmet = pyfltr.cli.command_selection.compute_unmet_commands(
@@ -1314,7 +1314,6 @@ def run_impl(
         commands,
         config,
         start_cwd=options.work_dir if options.work_dir is not None else pathlib.Path(original_cwd),
-        original_cwd=original_cwd,
         original_sys_args=options.retry_arguments(),
     )
     return outcome.exit_code

{pyfltr-3.22.0 → pyfltr-3.22.2}/pyfltr/command/core_.py

@@ -10,6 +10,7 @@ import pyfltr.command.slow_tests
 import pyfltr.config.config
 import pyfltr.config.model
 import pyfltr.diagnostics
+import pyfltr.parsing.entry
 import pyfltr.tools
 
 FAILED_STATUSES: frozenset[str] = frozenset({"failed", "resolution_failed"})
@@ -26,7 +27,6 @@ if typing.TYPE_CHECKING:
     import pyfltr.command.only_failed
     import pyfltr.command.process
     import pyfltr.command.subprojects
-    import pyfltr.parsing.entry
 
     Subproject = pyfltr.command.subprojects.Subproject
 
@@ -711,6 +711,21 @@ class ExecutionRequest:
         """同じ実行設定のOOM再試行条件を返す。"""
         return pyfltr.config.model.resolve_retry_kwargs(self.ctx.config.values)
 
+    def parse_errors(self, output: str, error_pattern: str | None) -> "list[pyfltr.diagnostics.ErrorLocation]":
+        """実行cwdと実行起点を基準にしてツール出力を診断へ変換する。
+
+        各実行経路（通常・fix・2段階・個別実行モジュール）が同じパス基準を
+        `pyfltr.parsing.entry.parse_errors`へ渡すための入口である。
+        """
+        return pyfltr.parsing.entry.parse_errors(
+            self.command,
+            output,
+            error_pattern,
+            file_path_remap=self.params.file_path_remap,
+            path_base=self.cwd,
+            start_cwd=self.ctx.base.start_cwd,
+        )
+
 
 def overall_status(results: "typing.Iterable[CommandResult]") -> typing.Literal["SUCCESS", "FORMATTED", "FAILED"]:
     """失敗、書き換え、成功の優先順で実行全体の状態を決める。"""

{pyfltr-3.22.0 → pyfltr-3.22.2}/pyfltr/command/dispatcher.py

@@ -32,7 +32,6 @@ import pyfltr.command.vitest
 import pyfltr.config.config
 import pyfltr.config.model
 import pyfltr.config.selection
-import pyfltr.parsing.entry
 import pyfltr.parsing.pytest
 import pyfltr.paths
 import pyfltr.run_options
@@ -486,13 +485,7 @@ def _run_plain_command(request: pyfltr.command.core_.ExecutionRequest) -> pyfltr
 
     output = proc.stdout.strip()
     elapsed = time.perf_counter() - request.start_time
-    errors = pyfltr.parsing.entry.parse_errors(
-        request.command,
-        output,
-        request.params.command_info.error_pattern,
-        file_path_remap=request.params.file_path_remap,
-        path_base=request.cwd,
-    )
+    errors = request.parse_errors(output, request.params.command_info.error_pattern)
     # pytestは設定ファイル競合をヘッダー1行で通知するだけで終了コードへ反映しない。
     # 拾わないと設定が適用されないまま完走した実行を成功として報告してしまう。
     slow_tests: list[pyfltr.command.slow_tests.SlowTest] = []

{pyfltr-3.22.0 → pyfltr-3.22.2}/pyfltr/command/glab.py

@@ -9,7 +9,6 @@ import pyfltr.command.core_
 import pyfltr.command.process
 import pyfltr.config.config
 import pyfltr.config.model
-import pyfltr.parsing.entry
 import pyfltr.tools
 import pyfltr.warnings_
 from pyfltr.command.core_ import CommandResult
@@ -76,7 +75,7 @@ def execute_glab_ci_lint(request: pyfltr.command.core_.ExecutionRequest) -> pyfl
             elapsed=elapsed,
         )
 
-    errors = pyfltr.parsing.entry.parse_errors(request.command, output, request.params.command_info.error_pattern)
+    errors = request.parse_errors(output, request.params.command_info.error_pattern)
     result = CommandResult.from_run(
         command=request.command,
         command_info=request.params.command_info,

{pyfltr-3.22.0 → pyfltr-3.22.2}/pyfltr/command/linter_fix.py

@@ -6,7 +6,6 @@ import pyfltr.command.core_
 import pyfltr.command.process
 import pyfltr.config.config
 import pyfltr.config.model
-import pyfltr.parsing.entry
 from pyfltr.command.core_ import CommandResult
 from pyfltr.command.snapshot import changed_files, snapshot_file_digests
 
@@ -46,7 +45,7 @@ def execute_linter_fix(request: pyfltr.command.core_.ExecutionRequest) -> pyfltr
     else:
         result_command_type = "linter"
 
-    errors = pyfltr.parsing.entry.parse_errors(request.command, output, None)
+    errors = request.parse_errors(output, None)
 
     result = CommandResult.from_run(
         command=request.command,

{pyfltr-3.22.0 → pyfltr-3.22.2}/pyfltr/command/runner.py

@@ -973,7 +973,8 @@ def build_invocation_argv(
     `commandline_prefix` 側（`{command}-path` 由来）の展開は `build_commandline` で済ませている。
 
     textlintのfix段は `execute_textlint_fix` のStep1と同じ規則
-    （`--format` ペアを除去したargs + fix-args、auto_args / 構造化出力引数なし）を適用する。
+    （`--format` ペアを除去したargs + fix-args + additional_args + `--no-cache`、
+    auto_args / 構造化出力引数なし）を適用する。
     実行本体（`_prepare_execution_params` / `execute_textlint_fix`）と
     `command-info` 表示の双方から本ヘルパーへ集約することで、組み立て規則の重複定義を避ける。
     """
@@ -983,6 +984,9 @@ def build_invocation_argv(
     # textlintのfix Step1はfixer-formatterがcompact系をサポートしないため、
     # ユーザー指定の `--format` ペアを一律で除去したうえでfix-argsを結合する特殊経路。
     # auto_args・構造化出力引数も適用しない（fixer出力の解析は本ステップでは行わないため）。
+    # 末尾の`--no-cache`は修正段だけtextlintのキャッシュを無効化する。textlint 15.8.0はキャッシュヒット時に
+    # 修正後の本文を持たない結果を修正処理へ渡して例外終了するため、利用者が通常lint向けに`--cache`を
+    # 設定していても修正段では使わない。後勝ちで適用されるよう利用者引数の結合後に置き、通常段の引数は変えない。
     if fix_stage and command == "textlint":
         fix_args: list[str] = expanduser_args(list(pyfltr.config.model.command_setting(config.values, command, "fix-args", [])))
         return [
@@ -990,6 +994,7 @@ def build_invocation_argv(
             *_strip_format_option(user_args),
             *fix_args,
             *extra,
+            "--no-cache",
         ]
 
     fix_args_value: list[str] | None = None

{pyfltr-3.22.0 → pyfltr-3.22.2}/pyfltr/command/stage_runner.py

@@ -76,7 +76,13 @@ def run_stages(
     callbacks: StageCallbacks | None = None,
     results: list[pyfltr.command.core_.CommandResult] | None = None,
 ) -> list[pyfltr.command.core_.CommandResult]:
-    """fix、直列formatter、LPT順の並列lint・testを共通の制御で実行する。"""
+    """fix、直列formatter、LPT順の並列lint・testを共通の制御で実行する。
+
+    fix段の結果は通常段の結果と同じツールの実行であり、成功時は保存だけを行い最終結果へ含めない。
+    fix段が失敗した場合は、同じツールの通常段の結果（成功・スキップを含む）へ失敗と出力を統合した
+    1件を最終結果とし、`collected`・`on_result`・`archive`へ同じ結果を渡す。
+    fail-fastで停止する場合もfix段の失敗結果を記録し、同じツールのスキップ結果を重ねない。
+    """
     hooks = callbacks if callbacks is not None else StageCallbacks()
     collected = results if results is not None else []
     config = base_ctx.config
@@ -92,9 +98,15 @@ def run_stages(
         if hooks.archive is not None and not result.cached:
             hooks.archive(result)
 
+    # fix段で失敗したツールの結果。通常段の結果を記録するときに統合する。
+    fix_failures: dict[str, pyfltr.command.core_.CommandResult] = {}
+
     def record(result: pyfltr.command.core_.CommandResult, stage: str) -> None:
         if hooks.replace_result is not None:
             result = hooks.replace_result(result, stage)
+        fix_failure = fix_failures.pop(result.command, None)
+        if fix_failure is not None:
+            result = merge_fix_failure(fix_failure, result)
         collected.append(result)
         archive(result)
         if hooks.on_result is not None:
@@ -108,16 +120,26 @@ def run_stages(
             if hooks.on_skipped is not None:
                 hooks.on_skipped(command)
 
+    def flush_fix_failures() -> None:
+        # 通常段の対象に含まれないツールのfix段失敗も最終結果へ残す。
+        for command in list(fix_failures):
+            record(make_skipped_result(command, config, reason=""), "skipped")
+
     for command in fixers:
         result = execute(command, True)
-        archive(result)
+        if result.failed:
+            fix_failures[command] = result
+        else:
+            archive(result)
         if hooks.is_interrupted():
             if hooks.on_interrupted is not None:
                 hooks.on_interrupted(command)
             skip([*formatters, *parallel])
+            flush_fix_failures()
             return collected
         if fail_fast and result.failed:
             skip([*formatters, *parallel])
+            flush_fix_failures()
             return collected
 
     for index, command in enumerate(formatters):
@@ -148,4 +170,26 @@ def run_stages(
                     cancel_pending_futures(future_to_command, aborted_commands)
         if aborted_commands:
             skip(list(aborted_commands))
+    flush_fix_failures()
     return collected
+
+
+def merge_fix_failure(
+    fix_result: pyfltr.command.core_.CommandResult,
+    result: pyfltr.command.core_.CommandResult,
+) -> pyfltr.command.core_.CommandResult:
+    """fix段の失敗を同じツールの通常段の結果へ統合する。
+
+    状態と終了コードは`CommandResult.merge`の規則で集約し、fix段の失敗を保持する。
+    再実行コマンドなど通常段で確定した値は通常段の結果から引き継ぐため、通常段を先頭にして集約する。
+    出力は実行順にfix段、通常段の順で連結する。対象件数は同じ対象を2段で数えないよう通常段の値を使う。
+    通常段が診断を出力した場合は通常段の診断だけを使う。fix段の診断は修正後の残存違反であり、通常段の診断と重複するためである。
+    通常段が診断を出力しなかった場合（スキップや診断0件）はfix段の診断を残し、失敗を指すファイルと位置を保持する。
+    """
+    fix_part = dataclasses.replace(fix_result, errors=[]) if result.errors else fix_result
+    merged = pyfltr.command.core_.CommandResult.merge([result, fix_part])
+    return dataclasses.replace(
+        merged,
+        output="\n".join(output for output in (fix_result.output, result.output) if output),
+        files=result.files or fix_result.files,
+    )

{pyfltr-3.22.0 → pyfltr-3.22.2}/pyfltr/command/subproject_loop.py

@@ -103,6 +103,8 @@ def run_subproject_loop(
     実行順が非決定になっても報告順を変えないよう、`relative` の昇順で並べてから集約する。
 
     結果は `CommandResult.merge` で集約する（1件のみならそのまま返す）。
+    各結果の診断の`file`は解析時点（`ExecutionRequest.parse_errors`）で起点相対へ変換済みのため、
+    集約時にパスを付け替えない。
     いずれのサブプロジェクトでも実行されず、設定による無効スキップが発生したか起点でも無効な場合は、
     起点cwdでの全ファイル誤実行を避けて skipped 結果を返す。
     全件ファイル0件かつ起点で有効なときのみ通常経路の0件結果を返す（`dispatch_fn` 経由）。

{pyfltr-3.22.0 → pyfltr-3.22.2}/pyfltr/command/textlint_fix.py

@@ -9,7 +9,6 @@ import pyfltr.command.core_
 import pyfltr.command.process
 import pyfltr.config.config
 import pyfltr.config.model
-import pyfltr.parsing.entry
 import pyfltr.paths
 import pyfltr.tools
 from pyfltr.command.core_ import CommandResult
@@ -40,16 +39,22 @@ def execute_textlint_fix(request: pyfltr.command.core_.ExecutionRequest) -> pyfl
 
     Step1: fix適用
         commandline_prefix + （textlint-argsから--formatペアを除去） + fix-args
-        + additional_args + targets
+        + additional_args + `--no-cache` + targets
+        （textlintのキャッシュヒット結果は修正後の本文を持たず修正処理が例外終了するため、
+        修正段だけキャッシュを無効化する。通常lint段は利用者のキャッシュ指定を保つ）
 
     Step2: lintチェック （残存違反を取得）
         commandline_prefix + textlint-args + textlint-lint-args + additional_args + targets
 
     ステータス判定:
-    -いずれかのステップがrc>=2 （致命的エラー） → failed
+    - いずれかのステップがrc>=2 （致命的エラー） → failed
     - Step2 rc != 0 （残存違反あり） → failed （Errorsタブに反映される）
-    - Step2 rc == 0かつStep1で内容ハッシュに変化あり → formatted
-    - Step2 rc == 0かつ変化なし → succeeded
+    - Step1 rc != 0かつStep2 rc == 0 → failed （returncodeはStep1の値）。
+      textlintの終了1は残存違反に加えて予期しない例外も表し、修正段に違反が残れば
+      Step2も非0になるため、この組合せは修正処理の失敗を示す
+    - いずれもrc == 0かつStep1で内容ハッシュに変化あり → formatted
+    - いずれもrc == 0かつ変化なし → succeeded
+    修正段とlint段の出力はいずれも`output`へ保持する。
 
     textlint --fixは残存違反がなくても対象ファイルを書き戻すことがあり、
     mtimeベースの比較では偽陽性になる。このため内容ハッシュ
@@ -91,7 +96,7 @@ def execute_textlint_fix(request: pyfltr.command.core_.ExecutionRequest) -> pyfl
 
     step1_proc = pyfltr.command.process.run_process(dataclasses.replace(request, verbose=False), step1_commandline)
     step1_rc = step1_proc.returncode
-    # rc=0 （違反なし） / rc=1 （違反残存） は通常終了、rc>=2は致命的エラー扱い
+    # rc>=2は致命的エラー扱い。rc=1はStep2の結果と併せて判定する（docstringのステータス判定を参照）
     step1_fatal = step1_rc >= 2
     digests_after_step1 = snapshot_file_digests(request.params.targets, base_cwd=request.ctx.base.start_cwd)
     step1_changed = digests_after_step1 != digests_before
@@ -127,7 +132,7 @@ def execute_textlint_fix(request: pyfltr.command.core_.ExecutionRequest) -> pyfl
     elapsed = time.perf_counter() - request.start_time
 
     # Step2出力から残存違反をパースする
-    errors = pyfltr.parsing.entry.parse_errors(request.command, output, request.params.command_info.error_pattern)
+    errors = request.parse_errors(output, request.params.command_info.error_pattern)
 
     # ステータス判定
     timeout_exceeded = step1_proc.timeout_exceeded or step2_proc.timeout_exceeded
@@ -139,6 +144,10 @@ def execute_textlint_fix(request: pyfltr.command.core_.ExecutionRequest) -> pyfl
         step_failed = True
         returncode = step2_rc
         result_command_type = "linter"
+    elif step1_rc != 0:
+        step_failed = True
+        returncode = step1_rc
+        result_command_type = "linter"
     elif step1_changed:
         # fix適用済み、残存違反なし → formatted扱いにする
         step_failed = False

{pyfltr-3.22.0 → pyfltr-3.22.2}/pyfltr/command/two_step/base.py

@@ -17,7 +17,6 @@ import pyfltr.command.process
 import pyfltr.command.runner
 import pyfltr.config.config
 import pyfltr.config.model
-import pyfltr.parsing.entry
 import pyfltr.paths
 import pyfltr.tools
 from pyfltr.command.core_ import CommandResult
@@ -218,11 +217,7 @@ def _run_fix_mode(
         formatter_failed = False
         returncode = 0
 
-    errors = (
-        pyfltr.parsing.entry.parse_errors(request.command, output, request.params.command_info.error_pattern)
-        if parse_errors
-        else []
-    )
+    errors = request.parse_errors(output, request.params.command_info.error_pattern) if parse_errors else []
 
     resolved_type = (
         command_type_override(formatter_failed, returncode)

{pyfltr-3.22.0 → pyfltr-3.22.2}/pyfltr/command/two_step/prettier.py

@@ -7,7 +7,6 @@ import pyfltr.command.core_
 import pyfltr.command.process
 import pyfltr.config.config
 import pyfltr.config.model
-import pyfltr.parsing.entry
 import pyfltr.tools
 from pyfltr.command.core_ import CommandResult
 from pyfltr.command.snapshot import changed_files, snapshot_file_digests
@@ -89,7 +88,7 @@ def _run_prettier_check_then_write(
     if step1_rc == 0:
         output = step1_proc.stdout.strip()
         elapsed = time.perf_counter() - request.start_time
-        errors = pyfltr.parsing.entry.parse_errors(request.command, output, request.params.command_info.error_pattern)
+        errors = request.parse_errors(output, request.params.command_info.error_pattern)
         return CommandResult.from_run(
             command=request.command,
             command_info=request.params.command_info,
@@ -108,7 +107,7 @@ def _run_prettier_check_then_write(
         # timeout超過は同じハングが再現する確率が高く、検証時間を浪費するためStep2を実行しない。
         output = step1_proc.stdout.strip()
         elapsed = time.perf_counter() - request.start_time
-        errors = pyfltr.parsing.entry.parse_errors(request.command, output, request.params.command_info.error_pattern)
+        errors = request.parse_errors(output, request.params.command_info.error_pattern)
         return CommandResult.from_run(
             command=request.command,
             command_info=request.params.command_info,
@@ -137,7 +136,7 @@ def _run_prettier_check_then_write(
         formatter_failed = True
         returncode = step2_rc
 
-    errors = pyfltr.parsing.entry.parse_errors(request.command, output, request.params.command_info.error_pattern)
+    errors = request.parse_errors(output, request.params.command_info.error_pattern)
     result = CommandResult.from_run(
         command=request.command,
         command_info=request.params.command_info,

{pyfltr-3.22.0 → pyfltr-3.22.2}/pyfltr/command/two_step/ruff.py

@@ -8,7 +8,6 @@ import pyfltr.command.process
 import pyfltr.command.runner
 import pyfltr.config.config
 import pyfltr.config.model
-import pyfltr.parsing.entry
 import pyfltr.tools
 from pyfltr.command.core_ import CommandResult
 from pyfltr.command.snapshot import changed_files, snapshot_file_digests
@@ -78,7 +77,7 @@ def _run_ruff_two_step(request: pyfltr.command.core_.ExecutionRequest, *, check_
     else:
         returncode = 0
 
-    errors = pyfltr.parsing.entry.parse_errors(request.command, output, request.params.command_info.error_pattern)
+    errors = request.parse_errors(output, request.params.command_info.error_pattern)
 
     # commandlineは代表として「最後に実行したステップ」（= ruff format）を格納。
     # 両ステップ分のcommandlineはverbose出力で確認可能。