pyfltr 3.24.2__tar.gz → 3.24.4__tar.gz

{pyfltr-3.24.2 → pyfltr-3.24.4}/.github/workflows/ci.yaml

@@ -46,7 +46,7 @@ jobs:
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
-      - uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
         with:
           python-version: "3.14"
           # 同一pushで先行するDocsと両matrixが同じキーを保存するとreservation警告になるため、
@@ -158,7 +158,7 @@ jobs:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
       - name: Install uv
-        uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
+        uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
         with:
           python-version: "3.15"
           enable-cache: true
@@ -197,7 +197,7 @@ jobs:
           restore-keys: pnpm-store-${{ runner.os }}-
 
       - name: Setup mise
-        uses: jdx/mise-action@82a612c5ab8bcda7cc5db6b7e81a8e7584c3dc6e # v5.2.3
+        uses: jdx/mise-action@6be3c7ed4c21d4f76b208d351d95aac273ebb76d # v5.2.4
 
       - name: 実行アーカイブの保存先を設定
         # `runner`コンテキストはジョブ直下`env`から参照できないため、ステップの`run`内で

{pyfltr-3.24.2 → pyfltr-3.24.4}/.github/workflows/docker-build.yaml

@@ -33,7 +33,7 @@ jobs:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
       - name: Install uv
-        uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
+        uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
         with:
           python-version: "3.14"
           enable-cache: true

{pyfltr-3.24.2 → pyfltr-3.24.4}/.github/workflows/docs.yaml

@@ -32,7 +32,7 @@ jobs:
           fetch-depth: 0
 
       - name: Install uv
-        uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
+        uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
         with:
           python-version: "3.14"
           enable-cache: true

{pyfltr-3.24.2 → pyfltr-3.24.4}/.github/workflows/release.yaml

@@ -129,7 +129,7 @@ jobs:
             GITHUB_TOKEN=${{ github.token }}
 
       - name: Install uv
-        uses: astral-sh/setup-uv@07a047e608db84b3d8c06cd9a7c7dcc9c355c18e # v10.3.2
+        uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
         with:
           python-version: "3.14"
           enable-cache: true

{pyfltr-3.24.2 → pyfltr-3.24.4}/AGENTS.md

@@ -132,6 +132,9 @@ format別のlogger stream/level切替の詳細は[docs/development/architecture.
   起点cwd全体を母数として構築した集合をそのまま対象へ渡さない。
   `ExecutionContext`へファイル集合を保持する状態を追加する場合は、
   対象の集合を`all_files`と交差させる処理を持たせる
+- `subproject_aware=True`ツールは複数のサブプロジェクトで同時に起動されうる。
+  ツールを追加・変更するときは、同時起動したプロセス間で共有されうる永続状態（キャッシュ、データベース、設定の書込み先）を
+  同時に使えるかを確かめ、使えないツールは`subproject_concurrent=False`としてサブプロジェクト実行を直列にする
 - subprocess・git・mise・ファイル走査などcwd依存処理はプロセスのcwdに依存しない実装にする。
   `subprocess.Popen(cwd=...)`の引数、または`start_cwd`・`base_cwd`・`cwd`等の
   明示引数でcwdを渡す。`os.chdir()`でグローバル状態を変更しない

{pyfltr-3.24.2 → pyfltr-3.24.4}/PKG-INFO

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

{pyfltr-3.24.2 → pyfltr-3.24.4}/docker/Dockerfile

@@ -92,6 +92,8 @@ ENV DEBIAN_FRONTEND=noninteractive \
 # Debian 公式イメージは ``/etc/apt/apt.conf.d/docker-clean`` で apt キャッシュを
 # 自動削除するため、キャッシュマウント有効時のみそれを除去する。
 # Node.js は mise 管理 (root で導入) に集約し、pnpm はその npm 経由で導入するため APT には含めない。
+# ``libatomic1`` は mise が導入する Node.js 26 系の公式バイナリが実行時に読み込む共有ライブラリであり、
+# 欠けると ``node`` が起動できず後段の ``mise use --global node@lts`` が失敗する。
 # hadolint ignore=DL3008
 RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
     --mount=type=cache,target=/var/lib/apt,sharing=locked \
@@ -103,6 +105,7 @@ RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
         git \
         gnupg \
         jq \
+        libatomic1 \
         shellcheck
 
 # uv を astral 公式インストーラ経由で導入する。

{pyfltr-3.24.2 → pyfltr-3.24.4}/docs/development/architecture.md

@@ -265,6 +265,11 @@ pnpmの設定は呼び出し元のcwdで解決し、値を導入プロセスへ
   プロジェクトローカル設定・モジュール解決・lockfileをcwd起点で読むツール
  （Python系・JS系・Rust系・.NET系のlinter/testerなど）は既定`True`。
   リポジトリ単位で動作するツール（`typos`・`shellcheck`・`shfmt`・`pre-commit`・`prek`）は既定`False`
+- 同一ツールのサブプロジェクト実行は`jobs`から導いた件数まで同時に開始する（`resolve_subproject_workers`）。
+  同時起動したプロセス間で共有されうる永続状態を同時に使えないツールは`CommandInfo.subproject_concurrent=False`とし、
+  サブプロジェクトを1件ずつ順に実行する。`mypy`は同じキャッシュ保存先の同時利用でSQLiteキャッシュの初期化が競合し
+  内部エラーで終了するため、これに該当する。キャッシュ保存先をpyfltrがサブプロジェクトごとに書き換える案は、
+  利用者が指定した共有保存先を無断で分割するため採らない
 - サブプロジェクト別の設定は対象のディレクトリで `load_config(config_dir=cwd)` を解決する。
   `pyproject.toml`を持たないサブプロジェクト（`Cargo.toml`単独・`*.csproj`単独等）は
   `[tool.pyfltr]`の記述先が存在しない。
@@ -912,6 +917,9 @@ grep/replace系ツール（`grep`・`replace`・`replace_undo`・`replace_histor
 完全な引数列は`pyfltr show-run <run_id> --commands=<name>`と実行アーカイブの`tool.json`から取得する。
 
 保存ファイルの全文取得を目的とする`show_run_output`は本方針の対象外とし、`output.log`をそのまま返す。
+大きな出力は`show_run_output`の行範囲と`show_run_diagnostics`の指摘範囲（`offset`・`limit`）で分割取得する。
+範囲を省略した呼び出しは全文・全件を返し、既定の切り詰めは設けない。
+既存の呼び出し側が全文・全件を前提とするためである。
 `show_run`が返す`meta`も対象外とする。
 `meta.json`の`argv`は利用者が起動時に渡した引数を保持し、
 pyfltrが対象ファイルへ展開した結果を含まないためである。

{pyfltr-3.24.2 → pyfltr-3.24.4}/docs/guide/configuration.md

@@ -190,6 +190,7 @@ pyfltr config list --all
 - retry-on-oom : LinuxのOOM killer起因でツールが強制終了された場合に自動リトライするか（既定: `true`。後述）
 - retry-max-attempts : OOM検知時の最大リトライ回数（既定: `1`。`0`でリトライ無効。後述）
 - exclude : 除外するファイル名/ディレクトリ名パターン（既定値あり。ロックファイル・minify済みファイル・source mapも含む）
+  外部パスでは指定名と配下だけに適用（[詳細](usage.md#external-paths)）
 - extend-exclude : 追加で除外するファイル名/ディレクトリ名パターン（既定は空）
 - exclude-fence-under : Markdownの指定H2見出し配下でフェンス内側行を事前チェックから除く（既定は空。[CLIコマンド](usage.md#exclude-fence-under)を参照）
 - respect-gitignore : `.gitignore`に記載されたファイルを除外するか否か（既定: `true`）。
@@ -504,6 +505,9 @@ CLIオプション`-j`でも指定でき、`pyproject.toml`より優先される
 ツール自身のワーカー数との積が`jobs`を超えない。
 
 `jobs`がツール自身のワーカー数の推定値以下になる場合は、サブプロジェクトを1件ずつ順に実行する。
+`mypy`は`jobs`の値によらず、サブプロジェクトを常に1件ずつ順に実行する。
+mypyは同じキャッシュ保存先を複数のmypyプロセスで同時に使う構成に対応せず、
+同時に起動すると内部エラー（`INTERNAL ERROR`）で終了することがあるためである。
 並列化しても報告順はサブプロジェクトの相対パスの昇順で安定する。
 
 ## fastエイリアス

{pyfltr-3.24.2 → pyfltr-3.24.4}/docs/guide/usage.md

@@ -256,8 +256,8 @@ MCPクライアントがstdinを閉じた時点でサーバーが終了する。
 | --- | --- | --- |
 | `list_runs` | `pyfltr list-runs` | run一覧を新しい順で返す。`limit`で件数制御（既定20件） |
 | `show_run` | `pyfltr show-run <run_id>` | 指定runのmetaとツール別サマリを返す。前方一致・`latest`エイリアス可 |
-| `show_run_diagnostics` | `pyfltr show-run <run_id> --commands=<name>` | 指定runのコマンドmeta情報とdiagnostics全件を返す（複数指定可）。チェック対象ファイルの引数列は含めない |
-| `show_run_output` | `pyfltr show-run <run_id> --commands=<name> --output` | 指定runのoutput.log全文を返す（複数指定可） |
+| `show_run_diagnostics` | `pyfltr show-run <run_id> --commands=<name>` | 指定runのコマンドmeta情報とdiagnostics全件を返す（複数指定可）。チェック対象ファイルの引数列は含めない。`offset`・`limit`で指摘の範囲を指定して分割取得できる |
+| `show_run_output` | `pyfltr show-run <run_id> --commands=<name> --output` | 指定runのoutput.log全文を返す（複数指定可）。`offset`・`limit`で行範囲を指定して分割取得できる |
 | `run` | `pyfltr run` / `fast` / `ci` | lint/format/testを実行しrun_id・失敗ツール名・retry_commands・警告（対処を含む）・次の操作の案内等を返す。`mode`で実行モードを選ぶ |
 | `grep` | `pyfltr grep` | ファイル横断の正規表現検索（pyfltr exclude/.gitignore尊重） |
 | `replace` | `pyfltr replace` | 横断置換。`dry_run`の既定値は`True`（CLI既定の`False`と異なりLLM暴発防止） |
@@ -266,6 +266,9 @@ MCPクライアントがstdinを閉じた時点でサーバーが終了する。
 | `command_info` | `pyfltr command-info <command>` | ツール起動方式の解決結果を返す。`check=True`は副作用を伴う |
 | `config` | `pyfltr config <action>` | 設定ファイルを操作する（get / set / delete / list） |
 
+各ツールの引数の意味と選択肢は、MCPクライアントが取得するツール定義（引数スキーマ）に含まれる。
+読み取りだけを行うツールには`readOnlyHint`、ファイルを書き換えうる`run`・`replace`・`replace_undo`・`config`には`destructiveHint`の注釈を付けており、クライアントはこれを承認の判断に使える。
+
 コーディングエージェント側へのMCPサーバー登録例（JSON形式で設定ファイルに記載する場合）:
 
 ```json
@@ -453,6 +456,12 @@ pyfltr generate-shell-completion powershell | Out-String | Invoke-Expression
 ### 外部パス指定時の挙動 {#external-paths}
 
 起点cwd（`--work-dir`適用後の作業ディレクトリ）配下にない絶対パスを「外部パス」と呼ぶ。
+`exclude`・`extend-exclude`・`{command}-exclude`のパターンは、外部ファイルの直接指定ではファイル名だけに適用する。
+外部ディレクトリの指定では、そのディレクトリ名と配下の相対パスに適用する。
+指定引数より上のディレクトリ名は除外の判定に含めないため、`.cache`配下の外部パスも指定できる。
+指定した名前や配下の`.venv`・`*.min.js`などに一致する除外は適用される。
+起点cwd配下のパスと、`..`を含む相対パスには、従来どおり起点cwdからの相対パスにパターンを適用する。
+
 ツールの性質に応じて以下の3分類で扱う。
 
 - `--config`系の明示注入: `markdownlint` ・ `textlint` ・ `bandit`
@@ -947,7 +956,8 @@ pyfltrからprekのhookを呼び出す統合は`prek = true`で有効化する
   そのディレクトリで個別に解決して尊重する。
   CLIオプション（`--jobs`・`--no-exclude`・`--no-gitignore`・`--human-readable`）は起点と同一に再適用する
 - サブプロジェクトの並列実行: 同一ツールのサブプロジェクト実行は、`jobs`をそのツール自身のワーカー数の推定値で割った件数まで同時に開始する。
-  報告順はサブプロジェクトの相対パスの昇順で安定し、実行順に依存しない
+  報告順はサブプロジェクトの相対パスの昇順で安定し、実行順に依存しない。
+  `mypy`は同じキャッシュ保存先を複数のmypyプロセスで同時に使う構成に対応しないため、`jobs`によらずサブプロジェクトを1件ずつ順に実行する
 - 設定ファイルの探索起点: `config-files`（設定ファイル不在の警告）と`--config`系の自動注入は
   常に起点cwd直下を基準に判定する。`.pre-commit-config.yaml`等をリポジトリルートに置く構成で、
   サブプロジェクト側に同名ファイルが無いことを理由に警告することはない

{pyfltr-3.24.2 → pyfltr-3.24.4}/mise.lock

@@ -223,6 +223,53 @@ url = "https://github.com/hadolint/hadolint/releases/download/v2.15.1/hadolint-w
 url_api = "https://api.github.com/repos/hadolint/hadolint/releases/assets/496546508"
 provenance = "github-attestations"
 
+[[tools.pinact]]
+version = "5.0.1"
+backend = "aqua:suzuki-shunsuke/pinact"
+specifiers = ["latest"]
+
+[tools.pinact."platforms.linux-arm64"]
+checksum = "sha256:fc1432004f378ae51d549a356195b4d2e3ee05935dbd20e3bbca66db1cdf6590"
+url = "https://github.com/suzuki-shunsuke/pinact/releases/download/v5.0.1/pinact_linux_arm64.tar.gz"
+url_api = "https://api.github.com/repos/suzuki-shunsuke/pinact/releases/assets/664460182"
+provenance = "github-attestations"
+
+[tools.pinact."platforms.linux-arm64-musl"]
+checksum = "sha256:fc1432004f378ae51d549a356195b4d2e3ee05935dbd20e3bbca66db1cdf6590"
+url = "https://github.com/suzuki-shunsuke/pinact/releases/download/v5.0.1/pinact_linux_arm64.tar.gz"
+url_api = "https://api.github.com/repos/suzuki-shunsuke/pinact/releases/assets/664460182"
+provenance = "github-attestations"
+
+[tools.pinact."platforms.linux-x64"]
+checksum = "sha256:12500c0fff5db94a0155e2e76ed959d1dc0e899056ee168d8fb7b4840e7c04f0"
+url = "https://github.com/suzuki-shunsuke/pinact/releases/download/v5.0.1/pinact_linux_amd64.tar.gz"
+url_api = "https://api.github.com/repos/suzuki-shunsuke/pinact/releases/assets/664460175"
+provenance = "github-attestations"
+
+[tools.pinact."platforms.linux-x64-musl"]
+checksum = "sha256:12500c0fff5db94a0155e2e76ed959d1dc0e899056ee168d8fb7b4840e7c04f0"
+url = "https://github.com/suzuki-shunsuke/pinact/releases/download/v5.0.1/pinact_linux_amd64.tar.gz"
+url_api = "https://api.github.com/repos/suzuki-shunsuke/pinact/releases/assets/664460175"
+provenance = "github-attestations"
+
+[tools.pinact."platforms.macos-arm64"]
+checksum = "sha256:58390ac843b7a14414df79762e2f64051158d00549762b1c49ded3d2f1746007"
+url = "https://github.com/suzuki-shunsuke/pinact/releases/download/v5.0.1/pinact_darwin_arm64.tar.gz"
+url_api = "https://api.github.com/repos/suzuki-shunsuke/pinact/releases/assets/664460145"
+provenance = "github-attestations"
+
+[tools.pinact."platforms.macos-x64"]
+checksum = "sha256:a8eb8dd4daecb7eefa660e1920ff65302714173be9c2f335a0ae77f053fd975a"
+url = "https://github.com/suzuki-shunsuke/pinact/releases/download/v5.0.1/pinact_darwin_amd64.tar.gz"
+url_api = "https://api.github.com/repos/suzuki-shunsuke/pinact/releases/assets/664460144"
+provenance = "github-attestations"
+
+[tools.pinact."platforms.windows-x64"]
+checksum = "sha256:d679bfd3ecb489f3d4242e54016f57181948980bf0ca7b98c6003c8d256c27f2"
+url = "https://github.com/suzuki-shunsuke/pinact/releases/download/v5.0.1/pinact_windows_amd64.zip"
+url_api = "https://api.github.com/repos/suzuki-shunsuke/pinact/releases/assets/664460186"
+provenance = "github-attestations"
+
 [[tools.shellcheck]]
 version = "0.11.0"
 backend = "aqua:koalaman/shellcheck"

{pyfltr-3.24.2 → pyfltr-3.24.4}/mise.toml

@@ -5,6 +5,7 @@ min_version = "2026.9.16"
 gitleaks = "latest"
 glab = "latest"
 hadolint = "latest"
+pinact = "latest"
 shellcheck = "latest"
 shfmt = "latest"
 taplo = "latest"

{pyfltr-3.24.2 → pyfltr-3.24.4}/pyfltr/cli/mcp_models.py

@@ -1,7 +1,7 @@
 """MCPツールスキーマ用Pydanticモデル群。
 
 `mcp_server.py`が公開する11ツールの戻り値スキーマをまとめて定義する。
-入力側は各ツール関数の型注釈とdocstringからJSONスキーマを自動生成する。
+入力側は各ツール関数の型注釈と`pydantic.Field`の説明からJSONスキーマを自動生成する。
 """
 
 from __future__ import annotations
@@ -166,6 +166,36 @@ class CommandDiagnosticsModel(pydantic.BaseModel):
         default=None,
         description="rule ID → 短い修正ヒント文字列の辞書。ヒントを持つruleのみ含める。",
     )
+    total_diagnostics: int | None = pydantic.Field(
+        default=None,
+        description="範囲指定時だけ返す、対象コマンドの個別指摘の総数。",
+    )
+    next_offset: int | None = pydantic.Field(
+        default=None,
+        description="範囲指定時だけ返す、続きを取得する`offset`。続きが無ければnull。",
+    )
+
+    @pydantic.model_serializer(mode="wrap")
+    def _omit_range_fields_without_range(
+        self,
+        handler: pydantic.SerializerFunctionWrapHandler,
+    ) -> dict[str, typing.Any]:
+        """範囲指定の無い呼び出しでは範囲項目を省き、従来と同じ応答を保つ。"""
+        serialized = typing.cast(dict[str, typing.Any], handler(self))
+        for field_name in ("total_diagnostics", "next_offset"):
+            if field_name not in self.model_fields_set:
+                serialized.pop(field_name, None)
+        return serialized
+
+
+class OutputRangeModel(pydantic.BaseModel):
+    """`show_run_output`へ範囲を指定した場合の、コマンド1件分の出力ログ。"""
+
+    text: str = pydantic.Field(description="範囲内の行を改行込みで連結した文字列。")
+    offset: int = pydantic.Field(description="返した最初の行の位置（0始まり）。")
+    returned_lines: int = pydantic.Field(description="返した行数。")
+    total_lines: int = pydantic.Field(description="出力ログ全体の行数。")
+    next_offset: int | None = pydantic.Field(description="続きを取得する`offset`。続きが無ければnull。")
 
 
 class RunWarningModel(pydantic.BaseModel):