pyfltr 3.26.0__tar.gz → 3.26.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (342) hide show
  1. {pyfltr-3.26.0 → pyfltr-3.26.1}/.agents/skills/output-format/SKILL.md +6 -1
  2. {pyfltr-3.26.0 → pyfltr-3.26.1}/PKG-INFO +1 -1
  3. {pyfltr-3.26.0 → pyfltr-3.26.1}/docs/development/architecture.md +10 -1
  4. {pyfltr-3.26.0 → pyfltr-3.26.1}/docs/guide/usage.md +5 -0
  5. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/mcp_models.py +7 -5
  6. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/mcp_server.py +50 -7
  7. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/execution_slot.py +85 -9
  8. pyfltr-3.26.1/tests/cli/mcp_models_test.py +337 -0
  9. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/cli/mcp_server_test.py +39 -8
  10. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/execution_slot_test.py +198 -0
  11. {pyfltr-3.26.0 → pyfltr-3.26.1}/.agents/skills/add-pyfltr-tool/SKILL.md +0 -0
  12. {pyfltr-3.26.0 → pyfltr-3.26.1}/.agents/skills/grep-replace/SKILL.md +0 -0
  13. {pyfltr-3.26.0 → pyfltr-3.26.1}/.agents/skills/implementation-test-constraints/SKILL.md +0 -0
  14. {pyfltr-3.26.0 → pyfltr-3.26.1}/.agents/skills/ssot/SKILL.md +0 -0
  15. {pyfltr-3.26.0 → pyfltr-3.26.1}/.agents/skills/tool-resolution/SKILL.md +0 -0
  16. {pyfltr-3.26.0 → pyfltr-3.26.1}/.claude/agents/error-parser-reviewer.md +0 -0
  17. {pyfltr-3.26.0 → pyfltr-3.26.1}/.claude/agents/tool-compat-checker.md +0 -0
  18. {pyfltr-3.26.0 → pyfltr-3.26.1}/.claude/rules/dogfooding.md +0 -0
  19. {pyfltr-3.26.0 → pyfltr-3.26.1}/.claude/rules/order.md +0 -0
  20. {pyfltr-3.26.0 → pyfltr-3.26.1}/.claude/rules/subprocess.md +0 -0
  21. {pyfltr-3.26.0 → pyfltr-3.26.1}/.claude/rules/targets.md +0 -0
  22. {pyfltr-3.26.0 → pyfltr-3.26.1}/.claude/settings.json +0 -0
  23. {pyfltr-3.26.0 → pyfltr-3.26.1}/.codex/config.toml +0 -0
  24. {pyfltr-3.26.0 → pyfltr-3.26.1}/.editorconfig +0 -0
  25. {pyfltr-3.26.0 → pyfltr-3.26.1}/.editorconfig-checker.json +0 -0
  26. {pyfltr-3.26.0 → pyfltr-3.26.1}/.gitattributes +0 -0
  27. {pyfltr-3.26.0 → pyfltr-3.26.1}/.github/workflows/audit.yaml +0 -0
  28. {pyfltr-3.26.0 → pyfltr-3.26.1}/.github/workflows/ci.yaml +0 -0
  29. {pyfltr-3.26.0 → pyfltr-3.26.1}/.github/workflows/docker-build.yaml +0 -0
  30. {pyfltr-3.26.0 → pyfltr-3.26.1}/.github/workflows/docs.yaml +0 -0
  31. {pyfltr-3.26.0 → pyfltr-3.26.1}/.github/workflows/release.yaml +0 -0
  32. {pyfltr-3.26.0 → pyfltr-3.26.1}/.gitignore +0 -0
  33. {pyfltr-3.26.0 → pyfltr-3.26.1}/.gitlab-ci.yml +0 -0
  34. {pyfltr-3.26.0 → pyfltr-3.26.1}/.gitmessage +0 -0
  35. {pyfltr-3.26.0 → pyfltr-3.26.1}/.markdownlint-cli2.yaml +0 -0
  36. {pyfltr-3.26.0 → pyfltr-3.26.1}/.npmrc +0 -0
  37. {pyfltr-3.26.0 → pyfltr-3.26.1}/.pre-commit-config.yaml +0 -0
  38. {pyfltr-3.26.0 → pyfltr-3.26.1}/.python-version +0 -0
  39. {pyfltr-3.26.0 → pyfltr-3.26.1}/.textlintignore +0 -0
  40. {pyfltr-3.26.0 → pyfltr-3.26.1}/.textlintrc.yaml +0 -0
  41. {pyfltr-3.26.0 → pyfltr-3.26.1}/.vscode/extensions.json +0 -0
  42. {pyfltr-3.26.0 → pyfltr-3.26.1}/.vscode/settings.json +0 -0
  43. {pyfltr-3.26.0 → pyfltr-3.26.1}/.yamllint.yaml +0 -0
  44. {pyfltr-3.26.0 → pyfltr-3.26.1}/AGENTS.md +0 -0
  45. {pyfltr-3.26.0 → pyfltr-3.26.1}/LICENSE +0 -0
  46. {pyfltr-3.26.0 → pyfltr-3.26.1}/Makefile +0 -0
  47. {pyfltr-3.26.0 → pyfltr-3.26.1}/README.md +0 -0
  48. {pyfltr-3.26.0 → pyfltr-3.26.1}/cliff.toml +0 -0
  49. {pyfltr-3.26.0 → pyfltr-3.26.1}/docker/Dockerfile +0 -0
  50. {pyfltr-3.26.0 → pyfltr-3.26.1}/docs/.markdownlint-cli2.yaml +0 -0
  51. {pyfltr-3.26.0 → pyfltr-3.26.1}/docs/development/development.md +0 -0
  52. {pyfltr-3.26.0 → pyfltr-3.26.1}/docs/guide/configuration-tools.md +0 -0
  53. {pyfltr-3.26.0 → pyfltr-3.26.1}/docs/guide/configuration.md +0 -0
  54. {pyfltr-3.26.0 → pyfltr-3.26.1}/docs/guide/custom-commands.md +0 -0
  55. {pyfltr-3.26.0 → pyfltr-3.26.1}/docs/guide/getting-started.md +0 -0
  56. {pyfltr-3.26.0 → pyfltr-3.26.1}/docs/guide/grep-replace.md +0 -0
  57. {pyfltr-3.26.0 → pyfltr-3.26.1}/docs/guide/index.md +0 -0
  58. {pyfltr-3.26.0 → pyfltr-3.26.1}/docs/guide/recommended-nonpython.md +0 -0
  59. {pyfltr-3.26.0 → pyfltr-3.26.1}/docs/guide/recommended.md +0 -0
  60. {pyfltr-3.26.0 → pyfltr-3.26.1}/docs/guide/troubleshooting.md +0 -0
  61. {pyfltr-3.26.0 → pyfltr-3.26.1}/docs/index.md +0 -0
  62. {pyfltr-3.26.0 → pyfltr-3.26.1}/mise.lock +0 -0
  63. {pyfltr-3.26.0 → pyfltr-3.26.1}/mise.toml +0 -0
  64. {pyfltr-3.26.0 → pyfltr-3.26.1}/mkdocs.yml +0 -0
  65. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/__init__.py +0 -0
  66. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/__main__.py +0 -0
  67. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/__init__.py +0 -0
  68. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/command_info.py +0 -0
  69. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/command_selection.py +0 -0
  70. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/config_subcmd.py +0 -0
  71. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/grep_replace_common.py +0 -0
  72. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/grep_subcmd.py +0 -0
  73. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/main.py +0 -0
  74. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/mcp_transport.py +0 -0
  75. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/mcp_worker.py +0 -0
  76. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/output_format.py +0 -0
  77. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/overrides.py +0 -0
  78. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/parser.py +0 -0
  79. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/pipeline.py +0 -0
  80. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/replace_subcmd.py +0 -0
  81. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/runs.py +0 -0
  82. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/shell_completion.py +0 -0
  83. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/cli/subproject_config.py +0 -0
  84. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/colloquial/__init__.py +0 -0
  85. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/colloquial/__main__.py +0 -0
  86. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/colloquial/check.py +0 -0
  87. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/colloquial/cli.py +0 -0
  88. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/colloquial/words.txt +0 -0
  89. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/colloquial/words_allow.txt +0 -0
  90. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/__init__.py +0 -0
  91. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/braces-3.0.3.patch +0 -0
  92. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/cache_policy.py +0 -0
  93. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/completion.py +0 -0
  94. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/core_.py +0 -0
  95. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/dispatcher.py +0 -0
  96. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/env.py +0 -0
  97. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/executor.py +0 -0
  98. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/glab.py +0 -0
  99. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/linter_fix.py +0 -0
  100. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/lychee.py +0 -0
  101. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/markdownlint_env.py +0 -0
  102. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/mise.py +0 -0
  103. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/only_failed.py +0 -0
  104. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/precommit.py +0 -0
  105. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/precommit_guidance.py +0 -0
  106. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/process.py +0 -0
  107. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/runner.py +0 -0
  108. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/slow_tests.py +0 -0
  109. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/snapshot.py +0 -0
  110. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/stage_runner.py +0 -0
  111. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/step_result.py +0 -0
  112. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/structured_output.py +0 -0
  113. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/subproject_loop.py +0 -0
  114. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/subprojects.py +0 -0
  115. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/targets.py +0 -0
  116. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/textlint_fix.py +0 -0
  117. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/tool_parallelism.py +0 -0
  118. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/tool_resolution.py +0 -0
  119. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/two_step/__init__.py +0 -0
  120. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/two_step/base.py +0 -0
  121. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/two_step/prettier.py +0 -0
  122. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/two_step/ruff.py +0 -0
  123. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/command/vitest.py +0 -0
  124. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/config/__init__.py +0 -0
  125. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/config/config.py +0 -0
  126. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/config/editing.py +0 -0
  127. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/config/model.py +0 -0
  128. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/config/operations.py +0 -0
  129. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/config/presets.py +0 -0
  130. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/config/selection.py +0 -0
  131. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/config/validation.py +0 -0
  132. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/diagnostics.py +0 -0
  133. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/file_lock.py +0 -0
  134. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/grep_/__init__.py +0 -0
  135. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/grep_/adaptive.py +0 -0
  136. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/grep_/history.py +0 -0
  137. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/grep_/jsonl_records.py +0 -0
  138. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/grep_/matcher.py +0 -0
  139. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/grep_/operations.py +0 -0
  140. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/grep_/preview.py +0 -0
  141. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/grep_/replacer.py +0 -0
  142. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/grep_/scanner.py +0 -0
  143. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/grep_/text_render.py +0 -0
  144. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/grep_/transaction.py +0 -0
  145. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/grep_/types.py +0 -0
  146. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/link_checks.py +0 -0
  147. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/output/__init__.py +0 -0
  148. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/output/auxiliary.py +0 -0
  149. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/output/code_quality.py +0 -0
  150. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/output/diagnostics.py +0 -0
  151. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/output/formatters.py +0 -0
  152. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/output/github_annotations.py +0 -0
  153. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/output/jsonl.py +0 -0
  154. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/output/logging_.py +0 -0
  155. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/output/positions.py +0 -0
  156. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/output/render.py +0 -0
  157. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/output/sarif.py +0 -0
  158. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/output/ui.py +0 -0
  159. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/parsing/__init__.py +0 -0
  160. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/parsing/common.py +0 -0
  161. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/parsing/entry.py +0 -0
  162. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/parsing/native.py +0 -0
  163. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/parsing/pytest.py +0 -0
  164. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/parsing/tools.py +0 -0
  165. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/paths.py +0 -0
  166. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/rule_urls.py +0 -0
  167. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/run_options.py +0 -0
  168. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/state/__init__.py +0 -0
  169. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/state/archive.py +0 -0
  170. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/state/cache.py +0 -0
  171. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/state/only_failed.py +0 -0
  172. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/state/retention.py +0 -0
  173. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/state/retry.py +0 -0
  174. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/state/runs.py +0 -0
  175. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/text/__init__.py +0 -0
  176. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/text/exclude_fence.py +0 -0
  177. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/text/fences.py +0 -0
  178. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/tools.py +0 -0
  179. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/user_cache.py +0 -0
  180. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyfltr/warnings_.py +0 -0
  181. {pyfltr-3.26.0 → pyfltr-3.26.1}/pyproject.toml +0 -0
  182. {pyfltr-3.26.0 → pyfltr-3.26.1}/scripts/__init__.py +0 -0
  183. {pyfltr-3.26.0 → pyfltr-3.26.1}/scripts/check_distribution.py +0 -0
  184. {pyfltr-3.26.0 → pyfltr-3.26.1}/scripts/check_doc_codeblocks.py +0 -0
  185. {pyfltr-3.26.0 → pyfltr-3.26.1}/scripts/distribution_probe.py +0 -0
  186. {pyfltr-3.26.0 → pyfltr-3.26.1}/scripts/parser_review/__init__.py +0 -0
  187. {pyfltr-3.26.0 → pyfltr-3.26.1}/scripts/parser_review/__main__.py +0 -0
  188. {pyfltr-3.26.0 → pyfltr-3.26.1}/scripts/parser_review/collect.py +0 -0
  189. {pyfltr-3.26.0 → pyfltr-3.26.1}/scripts/parser_review/compare.py +0 -0
  190. {pyfltr-3.26.0 → pyfltr-3.26.1}/scripts/parser_review/parse_worker.py +0 -0
  191. {pyfltr-3.26.0 → pyfltr-3.26.1}/scripts/parser_review/process_tree.py +0 -0
  192. {pyfltr-3.26.0 → pyfltr-3.26.1}/scripts/parser_review/pytest_forms.py +0 -0
  193. {pyfltr-3.26.0 → pyfltr-3.26.1}/scripts/parser_review/samples.py +0 -0
  194. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/__init__.py +0 -0
  195. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/cli/__init__.py +0 -0
  196. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/cli/command_info_test.py +0 -0
  197. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/cli/command_selection_test.py +0 -0
  198. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/cli/grep_subcmd_test.py +0 -0
  199. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/cli/main_test.py +0 -0
  200. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/cli/mcp_transport_test.py +0 -0
  201. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/cli/pipeline_test.py +0 -0
  202. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/cli/replace_subcmd_test.py +0 -0
  203. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/cli/runs_test.py +0 -0
  204. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/cli/shell_completion_test.py +0 -0
  205. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/colloquial/__init__.py +0 -0
  206. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/colloquial/check_test.py +0 -0
  207. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/colloquial/cli_test.py +0 -0
  208. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/__init__.py +0 -0
  209. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/cache_policy_test.py +0 -0
  210. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/completion_test.py +0 -0
  211. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/conftest.py +0 -0
  212. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/core_test.py +0 -0
  213. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/dispatcher_test.py +0 -0
  214. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/env_test.py +0 -0
  215. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/executor_test.py +0 -0
  216. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/glab_test.py +0 -0
  217. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/linter_fix_test.py +0 -0
  218. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/markdownlint_env_test.py +0 -0
  219. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/mise_test.py +0 -0
  220. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/only_failed_test.py +0 -0
  221. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/precommit_guidance_test.py +0 -0
  222. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/precommit_test.py +0 -0
  223. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/process_test.py +0 -0
  224. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/runner_helpers.py +0 -0
  225. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/runner_test.py +0 -0
  226. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/slow_tests_test.py +0 -0
  227. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/stage_runner_test.py +0 -0
  228. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/step_result_test.py +0 -0
  229. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/structured_output_test.py +0 -0
  230. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/subproject_loop_test.py +0 -0
  231. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/subprojects_test.py +0 -0
  232. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/targets_test.py +0 -0
  233. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/textlint_fix_test.py +0 -0
  234. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/tool_parallelism_test.py +0 -0
  235. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/tool_resolution_test.py +0 -0
  236. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/two_step/__init__.py +0 -0
  237. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/two_step/base_test.py +0 -0
  238. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/two_step/prettier_test.py +0 -0
  239. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/two_step/ruff_test.py +0 -0
  240. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/command/vitest_test.py +0 -0
  241. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/config/__init__.py +0 -0
  242. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/config/config_test.py +0 -0
  243. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/conftest.py +0 -0
  244. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/execution_request_helper.py +0 -0
  245. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/grep_/__init__.py +0 -0
  246. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/grep_/adaptive_test.py +0 -0
  247. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/grep_/history_test.py +0 -0
  248. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/grep_/matcher_test.py +0 -0
  249. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/grep_/preview_test.py +0 -0
  250. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/grep_/scanner_test.py +0 -0
  251. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/__init__.py +0 -0
  252. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/archive_retention_test.py +0 -0
  253. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/check_doc_codeblocks_test.py +0 -0
  254. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/cli_option_reference_test.py +0 -0
  255. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/concurrent_runs_helper.py +0 -0
  256. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/cooperative_abort_test.py +0 -0
  257. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/cooperative_execution_slot_test.py +0 -0
  258. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/documentation_test.py +0 -0
  259. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/execution_slot_test.py +0 -0
  260. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/external_excludes_test.py +0 -0
  261. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/external_paths_test.py +0 -0
  262. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/heartbeat_order_test.py +0 -0
  263. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/layers_test.py +0 -0
  264. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/legacy_execution_slot_test.py +0 -0
  265. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/llmstxt_test.py +0 -0
  266. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/lychee_test.py +0 -0
  267. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/module_imports_test.py +0 -0
  268. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/multistep_result_test.py +0 -0
  269. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/only_failed_test.py +0 -0
  270. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/output_format_test.py +0 -0
  271. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/parser_registration_test.py +0 -0
  272. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/parser_review_test.py +0 -0
  273. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/pipeline_always_targets_test.py +0 -0
  274. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/pipeline_config_files_warning_test.py +0 -0
  275. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/pipeline_fast_targets_test.py +0 -0
  276. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/pipeline_monorepo_test.py +0 -0
  277. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/precommit_test.py +0 -0
  278. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/relative_work_dir_test.py +0 -0
  279. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/replace_failure_test.py +0 -0
  280. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/smoke_test.py +0 -0
  281. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/status_consistency_test.py +0 -0
  282. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/test_placement_test.py +0 -0
  283. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/integration/user_state_isolation_test.py +0 -0
  284. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/output/__init__.py +0 -0
  285. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/output/code_quality_test.py +0 -0
  286. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/output/diagnostics_test.py +0 -0
  287. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/output/github_annotations_test.py +0 -0
  288. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/output/jsonl_test.py +0 -0
  289. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/output/positions_test.py +0 -0
  290. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/output/sarif_test.py +0 -0
  291. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/output/ui_test.py +0 -0
  292. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/parsing/__init__.py +0 -0
  293. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/parsing/common_test.py +0 -0
  294. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/parsing/data/pytest_runs.json +0 -0
  295. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/parsing/data/registered_outputs.json +0 -0
  296. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/parsing/entry_test.py +0 -0
  297. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/parsing/native_test.py +0 -0
  298. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/parsing/pytest_test.py +0 -0
  299. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/parsing/tools_test.py +0 -0
  300. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/paths_test.py +0 -0
  301. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/rule_urls_test.py +0 -0
  302. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/basic/.editorconfig +0 -0
  303. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/basic/.github/workflows/ci.yaml +0 -0
  304. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/basic/Dockerfile +0 -0
  305. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/basic/pyproject.toml +0 -0
  306. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/basic/sample.md +0 -0
  307. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/basic/sample.py +0 -0
  308. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/basic/sample.sh +0 -0
  309. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/basic/sample.toml +0 -0
  310. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/basic/sample.txt +0 -0
  311. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/basic/sample.yaml +0 -0
  312. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/basic/sample_test.py +0 -0
  313. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/pinact_workspace/.github/workflows/pinned.yaml +0 -0
  314. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/pinact_workspace/.github/workflows/unpinned.yaml +0 -0
  315. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/pinact_workspace/pyproject.toml +0 -0
  316. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/pre_commit_workspace/.pre-commit-config.yaml +0 -0
  317. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/pre_commit_workspace/pyproject.toml +0 -0
  318. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/pre_commit_workspace/sample.py +0 -0
  319. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/prek_workspace/.pre-commit-config.yaml +0 -0
  320. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/prek_workspace/pyproject.toml +0 -0
  321. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/prek_workspace/sample.py +0 -0
  322. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/textlint_workspace/package.json +0 -0
  323. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/textlint_workspace/pyproject.toml +0 -0
  324. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/textlint_workspace/sample.md +0 -0
  325. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/ts_workspace/eslint.config.js +0 -0
  326. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/ts_workspace/package.json +0 -0
  327. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/ts_workspace/pyproject.toml +0 -0
  328. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/ts_workspace/sample.test.ts +0 -0
  329. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/ts_workspace/sample.ts +0 -0
  330. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/ts_workspace/tsconfig.json +0 -0
  331. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/smoke_data/uv_sort_workspace/pyproject.toml +0 -0
  332. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/state/__init__.py +0 -0
  333. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/state/archive_test.py +0 -0
  334. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/state/cache_test.py +0 -0
  335. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/state/only_failed_test.py +0 -0
  336. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/state/retry_test.py +0 -0
  337. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/state/runs_test.py +0 -0
  338. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/text/__init__.py +0 -0
  339. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/text/exclude_fence_test.py +0 -0
  340. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/user_cache_test.py +0 -0
  341. {pyfltr-3.26.0 → pyfltr-3.26.1}/tests/warnings_test.py +0 -0
  342. {pyfltr-3.26.0 → pyfltr-3.26.1}/uv.lock +0 -0
@@ -5,7 +5,7 @@ description: >
5
5
  JSONL公開ヘルパー・logger役割分担・command.hints/summary.guidance・heartbeat段階出力・
6
6
  summaryレコードフィールド順序・effective_runner/runner_sourceなど出力スキーマの設計を集約する。
7
7
  pyfltr/output/配下・pyfltr/cli/output_format.py・pyfltr/cli/pipeline.py・pyfltr/cli/parser.py・
8
- pyfltr/cli/mcp_models.py・pyfltr/command/completion.py・
8
+ pyfltr/cli/mcp_models.py・pyfltr/cli/mcp_server.py・tests/cli/mcp_models_test.py・pyfltr/command/completion.py・
9
9
  pyfltr/command/core_.py・pyfltr/command/dispatcher.py・
10
10
  tests/command/completion_test.py・tests/output/jsonl_test.py・tests/integration/output_format_test.py・tests/cli/pipeline_test.py・tests/cli/main_test.py・
11
11
  tests/cli/main_test.py・tests/output/sarif_test.py・tests/output/code_quality_test.py・tests/integration/llmstxt_test.py・
@@ -56,6 +56,11 @@ JSONLの出力処理は`pyfltr/output/jsonl.py`の公開ヘルパー(`emit_rec
56
56
  - 個別ルールの`command.hints`とパイプライン全体の`summary.guidance`は粒度・性質が異なるため命名を分ける
57
57
  - `command.hints`・`summary.guidance`はLLM入力前提のため英語で記述する。
58
58
  トークン効率と汎用性を優先し、「全文章は日本語」方針より優先する例外として扱う
59
+ - MCP応答へ項目を加えるときは、受信するエージェントがその値で行う判断・操作を確かめ、
60
+ `tests/cli/mcp_models_test.py`の`_FIELD_PURPOSES`へ用途を書く。
61
+ 内部の保存値(保存形式の印・取り消し用の判定ハッシュなど)、人間向けの表示値、実行環境の内部値、他の項目との重複は加えない。
62
+ 保存済みの辞書を応答へ渡す場合は、`pyfltr/cli/mcp_server.py`の`SHOW_RUN_META_KEYS`のように返すキーを限定する。
63
+ 取得できることや内部で保持していることは、エージェントへ露出する理由にならない
59
64
  - JSONL `command.status` 語彙のSSOTは`pyfltr/command/core_.py`の`CommandResult.status`プロパティのdocstring。
60
65
  新規status値追加時は対象のdocstringと判定分岐を併せて更新する
61
66
  - `summary`レコードのフィールド順序仕様のSSOTは`pyfltr/output/jsonl.py`の`_build_summary_record`のdocstring
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: pyfltr
3
- Version: 3.26.0
3
+ Version: 3.26.1
4
4
  Summary: 多言語プロジェクトの品質チェックを一元管理し、コーディングエージェントから扱える形で提供する基盤。
5
5
  Project-URL: Homepage, https://github.com/ak110/pyfltr
6
6
  Author-email: "aki." <aki@tqzh.tk>
@@ -126,6 +126,9 @@ Rich UIへの`call_from_thread`とlock取得の差は画面側に残し、ステ
126
126
  - `command/stage_runner.py`の`run_stages`は待機者がいれば追加起動を止め、起動済みのツールと子プロセスを回収した区切りで譲る。
127
127
  並列段は`jobs`件まで起動し、待機者がいる間は起動済みの全ジョブを回収してから譲る。
128
128
  保持者は待機列の最後へ戻り、残りのツールの実行を再開する。単一ツールの途中では譲らない。
129
+ 譲る相手の判定は`yield_requested`が持つ。
130
+ まだ譲っていない最初の区間の保持者は、取得から`_FIRST_SEGMENT_HOLD_SECONDS`(120秒)の間、待機者が若い取り直し要求だけなら譲らない。
131
+ 若い取り直し要求は、登録から`_REACQUIRE_BYPASS_SECONDS`未満で新規要求が前へ入れる要求を指す
129
132
  CLI・TUI・MCP(要求ごとのworker)とcommit hookからの起動は、いずれもこの関数を通るため個別の接続を要しない。
130
133
  対象ファイルの展開・設定解決・実行アーカイブの初期化は枠の外で先に進め、TUIの結果画面での入力待ちは枠の解放後になる。
131
134
  外部ツールを起動する処理を新設・変更する場合も`run_stages`の内側で起動し、枠の外で長い処理や入力待ちを行わない
@@ -134,7 +137,13 @@ Rich UIへの`call_from_thread`とlock取得の差は画面側に残し、ステ
134
137
  検証コマンドから起動した子のpyfltrやpytest経由のpyfltrが自己待機で止まらないようにするためであり、
135
138
  環境変数を引き継がない子孫にも働くよう、祖先の判定はプロセスツリーで行う
136
139
  - 同じプロセスの別スレッドは待つ。同じスレッドの入れ子は再入する
137
- - 待機要求は短い調停ロックの内側で連番を割り当て、登録順に取得する。
140
+ - 待機要求は短い調停ロックの内側で連番を割り当て、連番の昇順に取得する。
141
+ 最初の取得の要求は、登録から`_REACQUIRE_BYPASS_SECONDS`(600秒)未満の取り直し要求より前の空き番号へ置き、
142
+ 新規要求どうし・取り直し要求どうしは登録順を保つ。
143
+ 2026年11月の実行アーカイブでは、本体数秒の実行が区切りごとに長い検証の取り直しへ譲って数百秒待っていたため、この配分にする。
144
+ 上限を超えた取り直し要求の前へは新規要求を置かず、最初の区間の保持者もその要求へ譲るため、新規要求が続いても長い検証の待ちは上限と前方の区間に抑えられる。
145
+ 取り直し要求のファイル名は連番の後に`R<登録時刻のミリ秒>`の印を持ち、旧版の要求(印なし)の前へは新規要求を置かない。
146
+ 末尾への登録は連番を`2**20`ずつ進め、間に置ける番号が無い場合は末尾へ並べる
138
147
  要求ごとのOSロックで生存を判定し、取消時は回収し、異常終了後は次の走査で回収する。
139
148
  協調参加していない外部APIの`hold()`と祖先継承区間は内部の段実行から譲らない。
140
149
  旧版プロセスも同じ`execution.lock`で排他に参加するが、旧版の全区間終了までは待つ
@@ -826,6 +826,11 @@ MCPを利用できず、エージェントがシェルコマンドを実行で
826
826
  待機者がいる場合、保持者は追加ツールの起動を止め、起動済みのツールと子プロセスの終了・回収後に枠を譲る。
827
827
  保持者は待機列の最後へ戻り、残りのツールの実行を再開する。
828
828
  単一の長いツールが実行中の場合は、その終了まで待つ。
829
+ 新しく起動した実行は、一度譲って取り直しを待ち始めてから一定時間(600秒)未満の実行より先に並ぶ。短いチェックが長い検証の列の後ろで待ち続けないようにするためである。
830
+ 600秒以上待っている取り直しの前へは並ばないため、新しい実行が続いても長い検証は進む。
831
+ まだ一度も譲っていない実行は、取得から一定時間(120秒)の間、待機者が600秒未満の取り直しだけであれば譲らずに続ける。
832
+ 新しく起動した実行や600秒以上待っている取り直しが待機していれば、120秒以内でも区切りで譲る。
833
+ このため、待機者が600秒未満の取り直しだけである間の短いチェックは、途中で待ち直さずに終わる。
829
834
  待機時間はツールのtimeoutに含まない。
830
835
 
831
836
  - 待機をやめる場合は実行を中断する(端末ではCtrl+C、MCPでは要求の取り消し)。中断した実行はツールを実行せず、成功の結果を返さない
@@ -145,7 +145,11 @@ class RunOverviewModel(pydantic.BaseModel):
145
145
  """
146
146
 
147
147
  run_id: str = pydantic.Field(description="runの識別子(ULID)。")
148
- meta: dict[str, typing.Any] = pydantic.Field(description="runのmeta情報(`read_meta`の戻り値)。")
148
+ meta: dict[str, typing.Any] = pydantic.Field(
149
+ description=(
150
+ "runの保存項目のうち、version・cwd・argv・commands・files・exit_code・started_at・finished_atの保存済みのもの。"
151
+ )
152
+ )
149
153
  timing: RunTimingModel = pydantic.Field(description="run全体の経過と実行枠の待機区間の要約。")
150
154
  commands: list[CommandSummaryModel] = pydantic.Field(description="コマンド別サマリ一覧。")
151
155
 
@@ -435,8 +439,6 @@ class ReplaceFileChangeModel(pydantic.BaseModel):
435
439
 
436
440
  file: str = pydantic.Field(description="変更対象ファイルパス。区切りは`/`へ統一するため、Windowsでも`C:/...`形式となる。")
437
441
  count: int = pydantic.Field(description="置換箇所数。")
438
- before_hash: str | None = pydantic.Field(default=None, description="変更前内容のSHA-256ハッシュ。")
439
- after_hash: str | None = pydantic.Field(default=None, description="変更後内容のSHA-256ハッシュ。")
440
442
 
441
443
 
442
444
  class ReplaceChangeRecordModel(pydantic.BaseModel):
@@ -507,7 +509,7 @@ class ReplaceHistoryEntryModel(pydantic.BaseModel):
507
509
  saved_at: str | None = pydantic.Field(default=None, description="保存日時(ISO 8601形式)。")
508
510
  command: dict[str, typing.Any] = pydantic.Field(
509
511
  default_factory=dict,
510
- description="実行時のパターン・置換式・エンコーディング等。",
512
+ description="実行時のパターン(pattern)・置換式(replacement)・固定文字列指定(fixed_strings)・エンコーディング(encoding)。",
511
513
  )
512
514
  files: list[ReplaceHistoryFileModel] = pydantic.Field(
513
515
  default_factory=list,
@@ -531,7 +533,7 @@ class CommandInfoModel(pydantic.BaseModel):
531
533
  command: str = pydantic.Field(description="対象のツール名。")
532
534
  resolved: bool = pydantic.Field(description="起動方式の解決に成功したか否か。")
533
535
  info: dict[str, typing.Any] = pydantic.Field(
534
- description="解決結果の詳細。解決失敗時は`error`キーを含む。",
536
+ description="解決結果の詳細(runner・実行ファイル・最終コマンドラインなど)。解決失敗時は`error`キーを含む。",
535
537
  )
536
538
 
537
539
 
@@ -75,7 +75,6 @@ import pyfltr.grep_.jsonl_records
75
75
  import pyfltr.grep_.matcher
76
76
  import pyfltr.grep_.operations
77
77
  import pyfltr.grep_.preview
78
- import pyfltr.grep_.replacer
79
78
  import pyfltr.grep_.scanner
80
79
  import pyfltr.output.jsonl
81
80
  import pyfltr.paths
@@ -151,6 +150,34 @@ def _resolve_run_id_or_raise(store: pyfltr.state.archive.ArchiveStore, raw: str)
151
150
  # `pydantic.Field`の説明はMCPの`inputSchema`へ載り、モデルが引数を決める唯一の手掛かりとなる。
152
151
  # docstringはクライアントへ送られないため、意味・省略時の動作・組み合わせ条件は説明へ書く。
153
152
 
153
+ SHOW_RUN_META_KEYS: tuple[str, ...] = ("version", "cwd", "argv", "commands", "files", "exit_code", "started_at", "finished_at")
154
+ """`show_run`の`meta`へ返す保存項目。
155
+
156
+ エージェントがrunの対象・起動引数・結果・時刻を判断に使う項目だけを返す。
157
+ `run_id`は応答の最上位、`slot_waits`は`timing.slot_waits`と重複し、`diagnostic_paths`は保存形式の版の判別印、
158
+ `python`・`executable`・`platform`は同じホストで動くエージェントの判断・操作に使わないため返さない。
159
+ 未知のキー(別の版が保存した項目)も返さない。項目を加える場合は受信主体の判断・操作を確かめる。
160
+ """
161
+
162
+ COMMAND_INFO_EXCLUDED_KEYS: frozenset[str] = frozenset({"command", "resolved"})
163
+ """`command_info`の`info`から除くキー。応答最上位の`command`・`resolved`と重複するため。
164
+
165
+ `info`はCLIの`command-info`と共通の解決結果の辞書で、起動方式の解決失敗を切り分けるための項目を持つ。
166
+ キーを加える場合は`tests/cli/mcp_models_test.py`の`_COMMAND_INFO_KEY_PURPOSES`へ用途を書く。
167
+ """
168
+ REPLACE_HISTORY_COMMAND_KEYS: tuple[str, ...] = ("pattern", "replacement", "fixed_strings", "encoding")
169
+ """`replace_history`の`command`へ返す保存項目。
170
+
171
+ `replace_id`は応答の同じ要素の最上位と重複し、`dry_run`は保存される履歴では常に偽のため返さない。
172
+ """
173
+
174
+ GREP_FILE_MATCH_KEYS: frozenset[str] = frozenset(set(GrepMatchModel.model_fields) - {"file"})
175
+ """`grep`の`file_results[].matches`へ返すキー。外側の`file`と重複する`file`を除いた`GrepMatchModel`の項目に限る。
176
+
177
+ 縮約出力の一致は辞書のまま渡るため、生成側(`pyfltr.grep_.jsonl_records.match_payload`)へ加えたキーを
178
+ 用途の対照(`tests/cli/mcp_models_test.py`の`GrepMatchModel`の項目)を経ずに配送しないよう限定する。
179
+ """
180
+
154
181
  RunIdArg = typing.Annotated[
155
182
  str,
156
183
  pydantic.Field(
@@ -250,7 +277,8 @@ async def tool_show_run(run_id: RunIdArg) -> RunOverviewModel:
250
277
  for entry in command_summaries
251
278
  ]
252
279
  timing = RunTimingModel.model_validate(pyfltr.state.runs.summarize_timing(meta))
253
- return RunOverviewModel(run_id=resolved, meta=meta, timing=timing, commands=commands)
280
+ public_meta = {key: meta[key] for key in SHOW_RUN_META_KEYS if key in meta}
281
+ return RunOverviewModel(run_id=resolved, meta=public_meta, timing=timing, commands=commands)
254
282
 
255
283
 
256
284
  async def tool_show_run_diagnostics(
@@ -785,7 +813,18 @@ async def tool_grep(
785
813
  selection = operation.selection
786
814
  files_scanned = len(expanded)
787
815
  matches = [GrepMatchModel.model_validate(payload) for payload in selection.matches]
788
- adaptive_file_results = [GrepFileResultModel.model_validate(result) for result in selection.file_results]
816
+ adaptive_file_results = [
817
+ GrepFileResultModel.model_validate(
818
+ {
819
+ **result,
820
+ "matches": [
821
+ {key: value for key, value in match.items() if key in GREP_FILE_MATCH_KEYS}
822
+ for match in result.get("matches", [])
823
+ ],
824
+ }
825
+ )
826
+ for result in selection.file_results
827
+ ]
789
828
 
790
829
  files_with_matches = (
791
830
  [pyfltr.paths.normalize_separators(file) for file in per_file_counts] if summary_mode == "files_with_matches" else []
@@ -948,8 +987,6 @@ async def tool_replace(
948
987
  ReplaceFileChangeModel(
949
988
  file=pyfltr.paths.normalize_separators(file),
950
989
  count=result.count,
951
- before_hash=pyfltr.grep_.replacer.compute_hash(result.before_content),
952
- after_hash=pyfltr.grep_.replacer.compute_hash(result.after_content),
953
990
  )
954
991
  for file, result in operation.prepared
955
992
  ]
@@ -1058,7 +1095,9 @@ async def tool_replace_history(
1058
1095
  ReplaceHistoryEntryModel(
1059
1096
  replace_id=str(entry["replace_id"]),
1060
1097
  saved_at=entry.get("saved_at"),
1061
- command=dict(entry.get("command", {})),
1098
+ command={
1099
+ key: value for key, value in dict(entry.get("command", {})).items() if key in REPLACE_HISTORY_COMMAND_KEYS
1100
+ },
1062
1101
  files=[
1063
1102
  ReplaceHistoryFileModel(
1064
1103
  file=str(file_entry["file"]),
@@ -1100,7 +1139,11 @@ async def tool_command_info(
1100
1139
  except ValueError as exc:
1101
1140
  _raise_mcp_error(str(exc))
1102
1141
  info = pyfltr.cli.command_info.collect_info(command, config, do_check=check)
1103
- return CommandInfoModel(command=command, resolved=bool(info.get("resolved", True)), info=info)
1142
+ return CommandInfoModel(
1143
+ command=command,
1144
+ resolved=bool(info.get("resolved", True)),
1145
+ info={key: value for key, value in info.items() if key not in COMMAND_INFO_EXCLUDED_KEYS},
1146
+ )
1104
1147
 
1105
1148
 
1106
1149
  async def tool_config(
@@ -42,6 +42,13 @@ pyfltr以外の検証を起動する呼出元(他のツールのスクリプ
42
42
  - それ以外は保持者の解放まで`_POLL_INTERVAL`秒ごとに再試行して待つ。
43
43
  同じプロセスの別スレッドも待つ(長寿命の呼出元が並行して受けた要求を順に実行するため)
44
44
 
45
+ 配分規則:
46
+
47
+ - 最初の取得の要求は、登録から`_REACQUIRE_BYPASS_SECONDS`秒未満の取り直し要求より先に並ぶ
48
+ - まだ譲っていない最初の区間の保持者は、取得から`_FIRST_SEGMENT_HOLD_SECONDS`秒の間、
49
+ 待機者が若い取り直し要求(新規要求が前へ入れる要求)だけなら譲らない
50
+ - 新規要求どうし・取り直し要求どうしは登録順を保ち、上限を過ぎた取り直し要求の前へは置かない
51
+
45
52
  ロックはユーザーキャッシュのルート(`pyfltr.user_cache.default_cache_root`)配下の`locks/`に置く。
46
53
  `PYFLTR_CACHE_DIR`で保存先を変えた実行どうしは別の枠になる。
47
54
  保持者が強制終了した場合はOSがロックを解放する。
@@ -76,6 +83,23 @@ _POLL_INTERVAL = 0.2
76
83
  """待機中の再試行間隔(秒)。解放から次の取得までの遅れと、待機中の負荷の釣り合いで選ぶ。"""
77
84
  _CREATE_TIME_TOLERANCE = 1.0
78
85
  """保持者記録とプロセスの生成時刻を同一とみなす差(秒)。pidの再利用を取り違えないための判定に使う。"""
86
+ _FIRST_SEGMENT_HOLD_SECONDS = 120.0
87
+ """最初の区間の保持者が、若い取り直し要求だけを待機者に持つ間に譲らない時間(秒)。
88
+
89
+ 短い検証が区切りごとに長い検証の取り直しへ譲ると、長い検証の区間を間に置いて待ち直し、本体数秒の実行が数百秒待つ。
90
+ 実行アーカイブの集計(2026年11月の98run)で本体時間の75パーセンタイル(fast約88秒、run約74秒)を上回る値とし、
91
+ 短い検証の大半を1区間で終える。新規の要求には従来どおり譲り、取り直し要求が追加で待つ時間はこの値で抑える。
92
+ """
93
+ _REACQUIRE_BYPASS_SECONDS = 600.0
94
+ """新規の取得要求が前へ入れる取り直し要求の、登録からの経過上限(秒)。
95
+
96
+ 新規要求は既に区間を進めた長い検証の取り直しより先に並び、短い検証が長い検証の列の後ろで待ち続けないようにする。
97
+ 上限を超えた取り直し要求の前へは新規要求を置かず、最初の区間の保持者もその要求へ譲るため、新規要求が続いても長い検証が進む。
98
+ """
99
+ _SEQUENCE_STEP = 2**20
100
+ """末尾へ登録する要求の連番の間隔。新規要求を取り直し要求の前へ置く空き番号を残す。"""
101
+ _REACQUIRE_MARK = "R"
102
+ """取り直し要求のファイル名で、連番の次に置く印。旧版の乱数部は小文字だけのため区別できる。"""
79
103
 
80
104
  _local = threading.local()
81
105
 
@@ -133,6 +157,8 @@ class _Lease:
133
157
  should_abort: collections.abc.Callable[[], bool] | None
134
158
  on_wait_interval: WaitIntervalCallback | None = None
135
159
  acquired: bool = False
160
+ acquired_at: float = 0.0
161
+ """取得(取り直し)した時点の`time.monotonic()`。最低保持時間の判定に使う。"""
136
162
  yields: int = 0
137
163
  coordinator: "SlotCoordinator | None" = None
138
164
  participant: "_Participant | None" = None
@@ -201,6 +227,7 @@ def hold(
201
227
  ),
202
228
  release=lambda: _release(lock, owner_path),
203
229
  )
230
+ lease.acquired_at = time.monotonic()
204
231
  _local.depth = 1
205
232
  _local.lease = lease
206
233
  try:
@@ -216,20 +243,30 @@ def hold(
216
243
 
217
244
 
218
245
  def yield_requested() -> bool:
219
- """呼出スレッドが譲れる保持者で、待機者がいるかを返す。
246
+ """呼出スレッドが譲れる保持者で、譲る相手の待機者がいるかを返す。
220
247
 
221
248
  通常は最外側の`hold`で取得したスレッドだけが真になりうる。
222
249
  協調所有者の入れ子と明示参加した子も待機者を確認できる。
223
250
  非協調の入れ子・継承区間、`hold`の外、別スレッドでは偽を返す。
251
+ まだ譲っていない最初の区間の保持者は、取得から`_FIRST_SEGMENT_HOLD_SECONDS`秒未満の間、
252
+ 待機者が若い取り直し要求(新規要求が前へ入れる要求)だけなら偽を返す。参加した子は所有者の判定に委ねて待機者の有無だけを返す。
224
253
  """
225
254
  lease: _Lease | None = getattr(_local, "lease", None)
226
- if lease is not None and (lease.coordinator is not None or lease.participant is not None):
255
+ if lease is not None and lease.participant is not None:
227
256
  with _queue_guard(lease.owner_path.parent):
228
257
  return bool(_waiters(lease.owner_path.parent))
229
- if getattr(_local, "depth", 0) != 1 or lease is None or not lease.acquired:
258
+ if lease is None or not lease.acquired:
259
+ return False
260
+ if lease.coordinator is None and getattr(_local, "depth", 0) != 1:
230
261
  return False
231
262
  with _queue_guard(lease.owner_path.parent):
232
- return bool(_waiters(lease.owner_path.parent))
263
+ waiters = _waiters(lease.owner_path.parent)
264
+ if not waiters:
265
+ return False
266
+ if lease.yields == 0 and time.monotonic() - lease.acquired_at < _FIRST_SEGMENT_HOLD_SECONDS:
267
+ now_ms = int(time.time() * 1000)
268
+ return not all(_bypassable(waiter, now_ms) for waiter in waiters)
269
+ return True
233
270
 
234
271
 
235
272
  def yield_to_waiters() -> bool:
@@ -239,7 +276,9 @@ def yield_to_waiters() -> bool:
239
276
  子の稼働中に呼ぶと、子の実行中に待機者の処理が始まる。
240
277
  `yield_requested`が偽の場合は何もしない。
241
278
 
242
- 解放より先に待機列の最後へ再登録するため、取り直しの順番は先に並んだ待機者の後、解放後に並んだ待機者の前になる。
279
+ 解放より先に待機列の最後へ再登録するため、取り直しの順番は先に並んだ待機者の後になる。
280
+ 取り直し要求は登録から`_REACQUIRE_BYPASS_SECONDS`秒未満の間、後から並んだ新規の取得要求に後から並んだ新規要求が前へ入る。
281
+ 譲る相手の判定は`yield_requested`に従う。
243
282
  取り直しの待機には`hold`へ渡した`should_abort`を使い、`on_wait`は呼ばない。
244
283
  取り直しの待機を`WaitAborted`や`KeyboardInterrupt`で抜けた場合は、待機要求を回収し、枠を持たない状態で`hold`を抜ける。
245
284
 
@@ -260,7 +299,7 @@ def _yield_lease() -> bool:
260
299
  lease: _Lease = _local.lease
261
300
  lease.yields += 1
262
301
  # 解放より先に列末へ登録し、先行待機者より前へ再取得する競合を防ぐ。
263
- with _request(lease.owner_path.parent) as request:
302
+ with _request(lease.owner_path.parent, reacquire=True) as request:
264
303
  lease.release()
265
304
  lease.acquired = _observe(
266
305
  lease.on_wait_interval,
@@ -276,6 +315,7 @@ def _yield_lease() -> bool:
276
315
  ),
277
316
  release=lambda: _release(lease.lock, lease.owner_path),
278
317
  )
318
+ lease.acquired_at = time.monotonic()
279
319
  return True
280
320
 
281
321
 
@@ -560,13 +600,49 @@ def _waiters(directory: pathlib.Path) -> list[pathlib.Path]:
560
600
  return active
561
601
 
562
602
 
603
+ def _sequence(path: pathlib.Path) -> int:
604
+ return int(path.name.split("-")[1])
605
+
606
+
607
+ def _bypassable(path: pathlib.Path, now_ms: int) -> bool:
608
+ """新規要求が前へ入れる若い取り直し要求かを返す。旧版の要求と印の無い要求の前へは置かない。"""
609
+ parts = path.name.split("-")
610
+ mark = parts[2] if len(parts) > 2 else ""
611
+ if not mark.startswith(_REACQUIRE_MARK) or not mark[1:].isdigit():
612
+ return False
613
+ return now_ms - int(mark[1:]) < _REACQUIRE_BYPASS_SECONDS * 1000
614
+
615
+
616
+ def _allocate_sequence(waiters: list[pathlib.Path], *, reacquire: bool, now_ms: int) -> int:
617
+ """要求の連番を決める。新規要求は末尾側に続く若い取り直し要求の前へ置く。
618
+
619
+ 旧版は末尾の連番に1を足すため、末尾追加は間隔を空けて新規要求を間に置ける番号を残す。
620
+ 間に置ける番号が無い場合は末尾へ追加し、登録順の待ちへ戻す。
621
+ """
622
+ last = _sequence(waiters[-1]) + _SEQUENCE_STEP if waiters else _SEQUENCE_STEP
623
+ if reacquire:
624
+ return last
625
+ index = len(waiters)
626
+ while index > 0 and _bypassable(waiters[index - 1], now_ms):
627
+ index -= 1
628
+ if index == len(waiters):
629
+ return last
630
+ lower = _sequence(waiters[index - 1]) if index > 0 else -1
631
+ upper = _sequence(waiters[index])
632
+ if upper - lower < 2:
633
+ return last
634
+ return (lower + upper) // 2
635
+
636
+
563
637
  @contextlib.contextmanager
564
- def _request(directory: pathlib.Path) -> collections.abc.Generator[pathlib.Path, None, None]:
638
+ def _request(directory: pathlib.Path, *, reacquire: bool = False) -> collections.abc.Generator[pathlib.Path, None, None]:
565
639
  with _queue_guard(directory):
566
640
  waiters = _waiters(directory)
641
+ now_ms = int(time.time() * 1000)
567
642
  # 連番の割当と要求ロック取得を同じ区間で行い、他の走査による未登録要求の回収を防ぐ。
568
- sequence = int(waiters[-1].name.split("-")[1]) + 1 if waiters else 0
569
- with tempfile.NamedTemporaryFile(prefix=f"execution.wait-{sequence:020d}-", dir=directory, delete=False) as file:
643
+ sequence = _allocate_sequence(waiters, reacquire=reacquire, now_ms=now_ms)
644
+ mark = f"{_REACQUIRE_MARK}{now_ms:013d}-" if reacquire else ""
645
+ with tempfile.NamedTemporaryFile(prefix=f"execution.wait-{sequence:020d}-{mark}", dir=directory, delete=False) as file:
570
646
  path = pathlib.Path(file.name)
571
647
  request_lock = pyfltr.file_lock.FileLock(path)
572
648
  if not request_lock.try_acquire():