claude-dev-env 1.42.0 → 1.44.0

package/hooks/blocking/test_question_to_user_enforcer.py

@@ -14,7 +14,7 @@ if _HOOKS_DIR not in sys.path:
     sys.path.insert(0, _HOOKS_DIR)
 if _HOOKS_ROOT not in sys.path:
     sys.path.insert(0, _HOOKS_ROOT)
-from config.messages import USER_FACING_ASKUSERQUESTION_NOTICE
+from hooks_constants.messages import USER_FACING_ASKUSERQUESTION_NOTICE
 
 CLEAN_DECLARATIVE_MESSAGE = "I applied the rename across both files. The tests pass."
 TRAILING_QUESTION_MESSAGE = (

package/hooks/blocking/windows_rmtree_blocker.py

@@ -17,18 +17,12 @@ import re
 import sys
 from pathlib import Path
 
+_hooks_dir = str(Path(__file__).resolve().parent.parent)
+if _hooks_dir not in sys.path:
+    sys.path.insert(0, _hooks_dir)
 
-def _insert_hooks_tree_for_imports() -> None:
-    hooks_tree = Path(__file__).resolve().parent.parent
-    hooks_tree_string = str(hooks_tree)
-    if hooks_tree_string not in sys.path:
-        sys.path.insert(0, hooks_tree_string)
-
-
-_insert_hooks_tree_for_imports()
-
-from config.pre_tool_use_stdin import read_hook_input_dictionary_from_stdin
-from config.windows_rmtree_blocker_constants import PYTHON_FILE_EXTENSION
+from hooks_constants.pre_tool_use_stdin import read_hook_input_dictionary_from_stdin  # noqa: E402
+from hooks_constants.windows_rmtree_blocker_constants import PYTHON_FILE_EXTENSION  # noqa: E402
 
 
 def payload_contains_unsafe_rmtree(payload_text: str) -> bool:

package/hooks/diagnostic/hook_log_extractor.py

@@ -57,7 +57,7 @@ try:
 except ImportError:
     psycopg = None
 
-from config.hook_log_extractor_constants import (
+from hooks_constants.hook_log_extractor_constants import (
     ATTACHMENT_TYPE_HOOK_ADDITIONAL_CONTEXT,
     ATTACHMENT_TYPE_HOOK_BLOCKING_ERROR,
     ATTACHMENT_TYPE_HOOK_SUCCESS,

package/hooks/diagnostic/hook_log_init.py

@@ -22,7 +22,7 @@ try:
 except ImportError:
     psycopg = None
 
-from config.hook_log_extractor_constants import (
+from hooks_constants.hook_log_extractor_constants import (
     CONNECT_TIMEOUT_SECONDS,
     EXIT_CODE_ENVIRONMENT_MISSING,
     EXIT_CODE_SUCCESS,

package/hooks/diagnostic/hook_log_stop_wrapper.py

@@ -37,7 +37,7 @@ from pathlib import Path
 if str(Path(__file__).resolve().parent.parent) not in sys.path:
     sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
 
-from config.hook_log_extractor_constants import (
+from hooks_constants.hook_log_extractor_constants import (
     BWS_ACCESS_TOKEN_ENV_VAR,
     BWS_EXECUTABLE_NAME,
     BWS_RUN_SEPARATOR,

package/hooks/diagnostic/test_hook_log_extractor.py

@@ -25,7 +25,7 @@ if str(_HOOKS_ROOT) not in sys.path:
     sys.path.insert(0, str(_HOOKS_ROOT))
 
 from diagnostic import hook_log_extractor
-from config.hook_log_extractor_constants import (
+from hooks_constants.hook_log_extractor_constants import (
     COMMAND_EXCERPT_MAX_CHARACTERS,
     EXIT_CODE_UNKNOWN_QUERY,
     HOOK_CATEGORY_UNCATEGORIZED,

package/hooks/diagnostic/test_hook_log_init.py

@@ -17,8 +17,8 @@ if str(_HOOKS_ROOT) not in sys.path:
     sys.path.insert(0, str(_HOOKS_ROOT))
 
 from diagnostic import hook_log_init
-from config import hook_log_extractor_constants
-from config.hook_log_extractor_constants import (
+from hooks_constants import hook_log_extractor_constants
+from hooks_constants.hook_log_extractor_constants import (
     EXIT_CODE_ENVIRONMENT_MISSING,
     NEON_DATABASE_URL_ENVIRONMENT_VARIABLE,
     OUTCOME_INIT_PROBE,

package/hooks/diagnostic/test_hook_log_stop_wrapper.py

@@ -15,7 +15,7 @@ if str(_HOOKS_ROOT) not in sys.path:
     sys.path.insert(0, str(_HOOKS_ROOT))
 
 from diagnostic import hook_log_stop_wrapper
-from config.hook_log_extractor_constants import (
+from hooks_constants.hook_log_extractor_constants import (
     BWS_ACCESS_TOKEN_ENV_VAR,
     BWS_EXECUTABLE_NAME,
     FLAG_INCREMENTAL,

package/hooks/git-hooks/gate_utils.py

@@ -6,7 +6,7 @@ import os
 import stat
 from pathlib import Path
 
-from config import (
+from git_hooks_constants import (
     CLAUDE_HOME_DEFAULT_SUBDIRECTORY,
     CLAUDE_HOME_ENV_VAR,
     GATE_PATH_OVERRIDE_ENV_VAR,

package/hooks/git-hooks/pre_commit.py

@@ -17,7 +17,7 @@ import subprocess
 import sys
 from pathlib import Path
 
-from config import (
+from git_hooks_constants import (
     GATE_INFRASTRUCTURE_FAILURE_EXIT_CODE,
     GATE_SCRIPT_NOT_FOUND_MESSAGE,
     INVOKE_GATE_FAILURE_MESSAGE,

package/hooks/git-hooks/pre_push.py

@@ -24,7 +24,7 @@ import subprocess
 import sys
 from pathlib import Path
 
-from config import (
+from git_hooks_constants import (
     ALL_ZEROS_OBJECT_NAME_CHARACTER,
     BASE_REFERENCE_ARGUMENT,
     DEFAULT_REMOTE_BASE_REFERENCE,

package/hooks/git-hooks/test_config.py

@@ -15,17 +15,17 @@ for each_module_name in list(sys.modules):
         del sys.modules[each_module_name]
 importlib.invalidate_caches()
 
-import config
+import git_hooks_constants
 
 
 def test_pre_push_gate_script_not_found_message_contains_path_placeholder() -> None:
-    assert "{path}" in config.PRE_PUSH_GATE_SCRIPT_NOT_FOUND_MESSAGE
+    assert "{path}" in git_hooks_constants.PRE_PUSH_GATE_SCRIPT_NOT_FOUND_MESSAGE
 
 
 def test_no_parseable_stdin_lines_message_exists_and_describes_problem() -> None:
-    assert "no parseable stdin lines" in config.NO_PARSEABLE_STDIN_LINES_MESSAGE
+    assert "no parseable stdin lines" in git_hooks_constants.NO_PARSEABLE_STDIN_LINES_MESSAGE
 
 
 def test_no_parseable_stdin_lines_sentinel_is_distinct_sentinel_value() -> None:
-    assert config.NO_PARSEABLE_STDIN_LINES_SENTINEL is not None
-    assert config.NO_PARSEABLE_STDIN_LINES_SENTINEL != config.DEFAULT_REMOTE_BASE_REFERENCE
+    assert git_hooks_constants.NO_PARSEABLE_STDIN_LINES_SENTINEL is not None
+    assert git_hooks_constants.NO_PARSEABLE_STDIN_LINES_SENTINEL != git_hooks_constants.DEFAULT_REMOTE_BASE_REFERENCE

package/hooks/git-hooks/test_pre_push.py

@@ -19,7 +19,7 @@ for each_module_name in list(sys.modules):
 importlib.invalidate_caches()
 
 import pre_push
-import config
+import git_hooks_constants
 
 
 ALL_ZEROS_OBJECT_NAME: str = "0" * 40
@@ -163,7 +163,7 @@ def test_main_exits_two_when_stdin_raises_ioerror(
 
     exit_code = pre_push.main()
 
-    assert exit_code == config.GATE_INFRASTRUCTURE_FAILURE_EXIT_CODE
+    assert exit_code == git_hooks_constants.GATE_INFRASTRUCTURE_FAILURE_EXIT_CODE
 
 
 def test_main_exits_two_when_invoke_gate_raises_oserror(
@@ -182,7 +182,7 @@ def test_main_exits_two_when_invoke_gate_raises_oserror(
 
     exit_code = pre_push.main()
 
-    assert exit_code == config.GATE_INFRASTRUCTURE_FAILURE_EXIT_CODE
+    assert exit_code == git_hooks_constants.GATE_INFRASTRUCTURE_FAILURE_EXIT_CODE
 
 
 def test_resolve_base_reference_emits_warning_for_malformed_line(
@@ -226,7 +226,7 @@ def test_resolve_base_reference_returns_sentinel_when_only_malformed_lines_prese
 
     base_reference = pre_push.resolve_base_reference_from_stdin(malformed_only_stdin)
 
-    assert base_reference == config.NO_PARSEABLE_STDIN_LINES_SENTINEL
+    assert base_reference == git_hooks_constants.NO_PARSEABLE_STDIN_LINES_SENTINEL
 
 
 def test_main_prints_stderr_when_gate_script_missing(
@@ -253,7 +253,7 @@ def test_resolve_base_reference_exits_two_when_only_malformed_lines_and_no_valid
 
     result = pre_push.resolve_base_reference_from_stdin(malformed_only_stdin)
 
-    assert result == config.NO_PARSEABLE_STDIN_LINES_SENTINEL
+    assert result == git_hooks_constants.NO_PARSEABLE_STDIN_LINES_SENTINEL
 
 
 def test_main_exits_two_when_all_stdin_lines_are_malformed(
@@ -268,7 +268,7 @@ def test_main_exits_two_when_all_stdin_lines_are_malformed(
 
     exit_code = pre_push.main()
 
-    assert exit_code == config.GATE_INFRASTRUCTURE_FAILURE_EXIT_CODE
+    assert exit_code == git_hooks_constants.GATE_INFRASTRUCTURE_FAILURE_EXIT_CODE
     captured = capsys.readouterr()
     assert "no parseable stdin lines" in captured.err
 

package/hooks/{config → hooks_constants}/code_rules_enforcer_constants.py

@@ -4,6 +4,13 @@ Extracted from code_rules_enforcer.py to satisfy the constants-location rule.
 """
 
 import re
+import tokenize
+
+ALL_PYTHON_TOKENIZE_FAILURE_EXCEPTIONS: tuple[type[BaseException], ...] = (
+    tokenize.TokenError,
+    IndentationError,
+    SyntaxError,
+)
 
 ALL_PYTHON_EXTENSIONS = {".py"}
 ALL_JAVASCRIPT_EXTENSIONS = {".js", ".ts", ".tsx", ".jsx"}
@@ -23,7 +30,37 @@ UPPER_SNAKE_CONSTANT_PATTERN = re.compile(r"^[A-Z][A-Z0-9_]*$")
 
 TYPE_CHECKING_BLOCK_PATTERN = re.compile(r"^(?P<indent>\s*)if\s+(typing\.)?TYPE_CHECKING\s*:\s*$")
 ALL_IMPORT_STATEMENT_PREFIXES: tuple[str, ...] = ("import ", "from ")
+ALL_EXEMPT_PYTHON_COMMENT_BODIES: tuple[str, ...] = (
+    "type:",
+    "noqa",
+    "pylint:",
+    "pragma:",
+    "TODO",
+    "FIXME",
+    "HACK",
+    "XXX",
+)
+ALL_JAVASCRIPT_EXEMPT_COMMENT_PREFIXES: tuple[str, ...] = (
+    "// @ts-",
+    "// eslint-",
+    "// prettier-",
+    "/// ",
+    "// TODO",
+    "// FIXME",
+    "// HACK",
+    "// XXX",
+)
+ALL_JAVASCRIPT_EXEMPT_INLINE_COMMENT_PREFIXES: tuple[str, ...] = (
+    "TODO",
+    "FIXME",
+    "HACK",
+    "XXX",
+)
+MAX_COMMENT_ISSUES = 3
 NOT_INSIDE_TYPE_CHECKING_BLOCK = -1
+TRIPLE_QUOTE_PARITY_DIVISOR = 2
+TRIPLE_DOUBLE_QUOTE_DELIMITER = '"""'
+TRIPLE_SINGLE_QUOTE_DELIMITER = "'''"
 FILE_GLOBAL_UPPER_SNAKE_PATTERN = re.compile(r"^_?[A-Z][A-Z0-9_]*$")
 
 ALL_COLLECTION_TYPE_NAMES: frozenset[str] = frozenset({

package/hooks/hooks_constants/code_rules_path_utils_constants.py

@@ -0,0 +1,28 @@
+"""Directory-name allowlist consumed by ``code_rules_path_utils.is_config_file``.
+
+``code_rules_enforcer.py`` and ``validators/exempt_paths.py`` use the
+classifier to decide whether a file is a config file. The classifier
+walks every parent directory segment and returns True when any segment
+matches a name in this set. Keeping the set in ``hooks_constants`` makes
+the classifier importable without a self-exempting hook in the consumer
+module.
+"""
+
+from __future__ import annotations
+
+
+ALL_CONFIG_DIRECTORY_NAMES = frozenset(
+    {
+        "config",
+        "hooks_constants",
+        "git_hooks_constants",
+        "pr_loop_shared_constants",
+        "skills_pr_loop_constants",
+        "pr_converge_skill_constants",
+        "pr_converge_scripts_constants",
+        "bugteam_scripts_constants",
+        "doc_gist_scripts_constants",
+        "implement_scripts_constants",
+        "dev_env_scripts_constants",
+    }
+)

package/hooks/hooks_constants/md_to_html_blocker_constants.py

@@ -0,0 +1,82 @@
+"""Configuration constants for the md_to_html_blocker PreToolUse hook
+and its shared exemption helpers (`md_path_exemptions`)."""
+
+from __future__ import annotations
+
+import os
+import tempfile
+
+
+ALL_CLAUDE_CODE_SOURCE_TOP_DIRECTORIES: frozenset[str] = frozenset(
+    {"agents", "docs", "skills", "rules", "system-prompts", "commands"}
+)
+
+PACKAGES_TOP_LEVEL_SEGMENT: str = "packages"
+CLAUDE_DEV_ENV_REPO_NAME_SEGMENT: str = "claude-dev-env"
+
+MINIMUM_SEGMENT_COUNT_TO_MATCH_INDICATOR: int = 4
+
+ALL_EXEMPT_ANYWHERE_FILENAMES: tuple[str, ...] = ("SKILL.md",)
+ALL_EXEMPT_PLUGIN_DIRECTORY_SEGMENTS: tuple[str, ...] = ("agents", "skills", "commands")
+ALL_EXEMPT_HOME_RELATIVE_DIRECTORIES: tuple[str, ...] = ("SessionLog",)
+ALL_EXEMPT_ROOT_FILENAMES: tuple[str, ...] = ("readme.md", "changelog.md")
+REPO_ROOT_MARKER_NAME: str = ".git"
+CLAUDE_DIRECTORY_NAME: str = ".claude"
+PLUGIN_ROOT_MARKER_DIRECTORY_NAME: str = ".claude-plugin"
+
+CLAUDE_DIRECTORY_SEGMENT_MARKER: str = f"/{CLAUDE_DIRECTORY_NAME}/"
+CLAUDE_DIRECTORY_PATH_PREFIX: str = f"{CLAUDE_DIRECTORY_NAME}/"
+PLUGIN_DIRECTORY_SEGMENT_MARKER: str = f"/{PLUGIN_ROOT_MARKER_DIRECTORY_NAME}/"
+PLUGIN_DIRECTORY_PATH_PREFIX: str = f"{PLUGIN_ROOT_MARKER_DIRECTORY_NAME}/"
+
+ALL_EXEMPT_ANYWHERE_FILENAMES_LOWER: frozenset[str] = frozenset(
+    each_filename.lower() for each_filename in ALL_EXEMPT_ANYWHERE_FILENAMES
+)
+ALL_EXEMPT_ROOT_FILENAMES_LOWER: frozenset[str] = frozenset(
+    each_filename.lower() for each_filename in ALL_EXEMPT_ROOT_FILENAMES
+)
+
+
+def _resolve_canonical_directory_lowercase(directory_path: str) -> str:
+    return (
+        os.path.realpath(directory_path).replace("\\", "/").rstrip("/").lower()
+    )
+
+
+RESOLVED_HOME_DIRECTORY_LOWER: str = _resolve_canonical_directory_lowercase(
+    os.path.expanduser("~")
+)
+RESOLVED_TEMP_DIRECTORY_LOWER: str = _resolve_canonical_directory_lowercase(
+    tempfile.gettempdir()
+)
+
+ALL_EXEMPT_HOME_DIRECTORY_PATH_PREFIXES: tuple[str, ...] = tuple(
+    f"{RESOLVED_HOME_DIRECTORY_LOWER}/{each_relative_directory.lower()}/"
+    for each_relative_directory in ALL_EXEMPT_HOME_RELATIVE_DIRECTORIES
+)
+RESOLVED_TEMP_DIRECTORY_PATH_PREFIX: str = f"{RESOLVED_TEMP_DIRECTORY_LOWER}/"
+
+
+__all__ = [
+    "ALL_CLAUDE_CODE_SOURCE_TOP_DIRECTORIES",
+    "ALL_EXEMPT_ANYWHERE_FILENAMES",
+    "ALL_EXEMPT_ANYWHERE_FILENAMES_LOWER",
+    "ALL_EXEMPT_HOME_DIRECTORY_PATH_PREFIXES",
+    "ALL_EXEMPT_HOME_RELATIVE_DIRECTORIES",
+    "ALL_EXEMPT_PLUGIN_DIRECTORY_SEGMENTS",
+    "ALL_EXEMPT_ROOT_FILENAMES",
+    "ALL_EXEMPT_ROOT_FILENAMES_LOWER",
+    "CLAUDE_DEV_ENV_REPO_NAME_SEGMENT",
+    "CLAUDE_DIRECTORY_NAME",
+    "CLAUDE_DIRECTORY_PATH_PREFIX",
+    "CLAUDE_DIRECTORY_SEGMENT_MARKER",
+    "MINIMUM_SEGMENT_COUNT_TO_MATCH_INDICATOR",
+    "PACKAGES_TOP_LEVEL_SEGMENT",
+    "PLUGIN_DIRECTORY_PATH_PREFIX",
+    "PLUGIN_DIRECTORY_SEGMENT_MARKER",
+    "PLUGIN_ROOT_MARKER_DIRECTORY_NAME",
+    "REPO_ROOT_MARKER_NAME",
+    "RESOLVED_HOME_DIRECTORY_LOWER",
+    "RESOLVED_TEMP_DIRECTORY_LOWER",
+    "RESOLVED_TEMP_DIRECTORY_PATH_PREFIX",
+]

package/hooks/{config → hooks_constants}/pr_converge_bugteam_enforcer_state.py

@@ -14,7 +14,7 @@ import json
 import os
 from pathlib import Path
 
-from config.pr_converge_bugteam_enforcer_constants import (
+from hooks_constants.pr_converge_bugteam_enforcer_constants import (
     CLAUDE_JOB_DIR_ENV_VAR,
     PR_CONVERGE_STATE_FILENAME,
 )

package/hooks/hooks_constants/pr_description_enforcer_constants.py

@@ -0,0 +1,154 @@
+"""Configuration constants for the pr_description_enforcer PreToolUse hook."""
+
+from __future__ import annotations
+
+import os
+import re
+from dataclasses import dataclass
+from pathlib import Path
+
+
+_PLUGIN_ROOT: str = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+PR_GUIDE_PATH: str = os.path.join(_PLUGIN_ROOT, "docs", "PR_DESCRIPTION_GUIDE.md")
+
+MINIMUM_SUBSTANTIVE_PROSE_CHARS: int = 40
+
+FENCED_CODE_BLOCK_PATTERN: re.Pattern[str] = re.compile(r"```.*?```", re.DOTALL)
+INLINE_CODE_PATTERN: re.Pattern[str] = re.compile(r"`[^`]*`")
+HEADING_LINE_PATTERN: re.Pattern[str] = re.compile(r"^#+[ \t].*$", re.MULTILINE)
+BOLD_PAIR_PATTERN: re.Pattern[str] = re.compile(r"\*\*([^*]+?)\*\*")
+BULLET_MARKER_PATTERN: re.Pattern[str] = re.compile(r"^\s*[-*+]\s+", re.MULTILINE)
+BLOCKQUOTE_MARKER_PATTERN: re.Pattern[str] = re.compile(r"^\s*>\s+", re.MULTILINE)
+LINK_TEXT_PATTERN: re.Pattern[str] = re.compile(r"\[([^\]]+)\]\([^)]+\)")
+WHITESPACE_RUN_PATTERN: re.Pattern[str] = re.compile(r"\s+")
+
+SUMMARY_HEADER: str = "## Summary"
+PROBLEM_HEADER: str = "## Problem"
+TEST_PLAN_HEADER: str = "## Test plan"
+TESTS_HEADER: str = "## Tests"
+TESTING_HEADER: str = "## Testing"
+VERIFICATION_HEADER: str = "## Verification"
+VALIDATION_HEADER: str = "## Validation"
+
+ALL_HEAVY_OPENING_HEADERS: frozenset[str] = frozenset({PROBLEM_HEADER, SUMMARY_HEADER})
+ALL_HEAVY_TESTING_HEADERS: frozenset[str] = frozenset(
+    {TEST_PLAN_HEADER, TESTING_HEADER, TESTS_HEADER, VERIFICATION_HEADER, VALIDATION_HEADER}
+)
+GH_PR_COMMAND_MIN_TOKEN_COUNT: int = 3
+ATOMIC_WRITE_TEMP_SUFFIX: str = ".tmp"
+SELF_CLOSING_REFERENCE_MESSAGE_PREFIX: str = "PR body references its own PR number #"
+SELF_CLOSING_REFERENCE_MESSAGE_SUFFIX: str = (
+    " as a self-closing keyword (Fixes/Closes/Resolves) -- remove the self-reference"
+)
+
+SELF_REFERENCE_PATTERN_TEMPLATE: str = (
+    r"\b(?:Close|Closes|Closed|Fix|Fixes|Fixed|Resolve|Resolves|Resolved)"
+    r"\s+#{pr_number}\b"
+)
+
+THIS_PR_OPENING_PATTERN: re.Pattern[str] = re.compile(
+    r"^\s*(?:#[^\n]*\n\s*)*This PR\b",
+    re.IGNORECASE,
+)
+
+TRIVIAL_SHAPE: str = "trivial"
+STANDARD_SHAPE: str = "standard"
+HEAVY_SHAPE: str = "heavy"
+
+TRIVIAL_BODY_CHAR_THRESHOLD: int = 200
+HEAVY_MIN_BODY_CHARS_FOR_CLASSIFICATION: int = 500
+
+READABILITY_MAX_SENTENCE_WORDS: int = 28
+READABILITY_AVG_SENTENCE_WORDS: int = 18
+READABILITY_MIN_FLESCH: int = 50
+READABILITY_STRIKE_THRESHOLD: int = 3
+
+READABILITY_LOOSEN_CAP: int = 3
+READABILITY_MIN_FLESCH_FLOOR: int = 30
+READABILITY_MAX_SENTENCE_WORDS_CEILING: int = 60
+READABILITY_AVG_SENTENCE_WORDS_CEILING: int = 40
+
+READABILITY_FLESCH_LOOSEN_FACTOR: float = 0.9
+READABILITY_SENTENCE_WORDS_LOOSEN_FACTOR: float = 10 / 9
+
+ALL_READABILITY_CLI_FLAG_TOKENS: frozenset[str] = frozenset(
+    {
+        "--readability-loosen",
+        "--readability-reset",
+        "--readability-disable",
+        "--readability-enable",
+    }
+)
+
+FLESCH_BASE_SCORE: float = 206.835
+FLESCH_WORDS_PER_SENTENCE_COEFFICIENT: float = 1.015
+FLESCH_SYLLABLES_PER_WORD_COEFFICIENT: float = 84.6
+FLESCH_PERFECT_SCORE: float = 100.0
+
+READABILITY_STATE_FILE: Path = Path.home() / ".claude" / "state" / "pr_description_readability_strikes.json"
+READABILITY_THRESHOLD_OVERRIDE_FILE: Path = (
+    Path.home() / ".claude" / "state" / "pr_description_readability_overrides.json"
+)
+READABILITY_ENABLED_STATE_FILE: Path = (
+    Path.home() / ".claude" / "state" / "pr_description_readability_enabled.json"
+)
+
+
+@dataclass(frozen=True)
+class ReadabilityThresholds:
+    """Three readability thresholds carried as a single typed structure."""
+
+    flesch_min: int
+    max_sentence_words: int
+    avg_sentence_words: int
+
+
+DEFAULT_READABILITY_THRESHOLDS: ReadabilityThresholds = ReadabilityThresholds(
+    flesch_min=READABILITY_MIN_FLESCH,
+    max_sentence_words=READABILITY_MAX_SENTENCE_WORDS,
+    avg_sentence_words=READABILITY_AVG_SENTENCE_WORDS,
+)
+
+
+__all__ = [
+    "ALL_HEAVY_OPENING_HEADERS",
+    "ALL_HEAVY_TESTING_HEADERS",
+    "ALL_READABILITY_CLI_FLAG_TOKENS",
+    "ATOMIC_WRITE_TEMP_SUFFIX",
+    "BLOCKQUOTE_MARKER_PATTERN",
+    "BOLD_PAIR_PATTERN",
+    "BULLET_MARKER_PATTERN",
+    "DEFAULT_READABILITY_THRESHOLDS",
+    "FENCED_CODE_BLOCK_PATTERN",
+    "FLESCH_BASE_SCORE",
+    "FLESCH_PERFECT_SCORE",
+    "FLESCH_SYLLABLES_PER_WORD_COEFFICIENT",
+    "FLESCH_WORDS_PER_SENTENCE_COEFFICIENT",
+    "GH_PR_COMMAND_MIN_TOKEN_COUNT",
+    "HEADING_LINE_PATTERN",
+    "HEAVY_MIN_BODY_CHARS_FOR_CLASSIFICATION",
+    "HEAVY_SHAPE",
+    "INLINE_CODE_PATTERN",
+    "LINK_TEXT_PATTERN",
+    "MINIMUM_SUBSTANTIVE_PROSE_CHARS",
+    "PR_GUIDE_PATH",
+    "READABILITY_AVG_SENTENCE_WORDS_CEILING",
+    "READABILITY_ENABLED_STATE_FILE",
+    "READABILITY_FLESCH_LOOSEN_FACTOR",
+    "READABILITY_LOOSEN_CAP",
+    "READABILITY_MAX_SENTENCE_WORDS_CEILING",
+    "READABILITY_MIN_FLESCH_FLOOR",
+    "READABILITY_SENTENCE_WORDS_LOOSEN_FACTOR",
+    "READABILITY_STATE_FILE",
+    "READABILITY_STRIKE_THRESHOLD",
+    "READABILITY_THRESHOLD_OVERRIDE_FILE",
+    "ReadabilityThresholds",
+    "SELF_CLOSING_REFERENCE_MESSAGE_PREFIX",
+    "SELF_CLOSING_REFERENCE_MESSAGE_SUFFIX",
+    "SELF_REFERENCE_PATTERN_TEMPLATE",
+    "STANDARD_SHAPE",
+    "THIS_PR_OPENING_PATTERN",
+    "TRIVIAL_BODY_CHAR_THRESHOLD",
+    "TRIVIAL_SHAPE",
+    "WHITESPACE_RUN_PATTERN",
+]

package/hooks/{config → hooks_constants}/pre_tool_use_stdin.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 import json
 import sys
 
-from config.setup_project_paths_constants import (
+from hooks_constants.setup_project_paths_constants import (
     DECODE_ERRORS_POLICY,
     UTF8_BYTE_ORDER_MARK,
     UTF8_ENCODING,

package/hooks/{config → hooks_constants}/project_paths_reader.py

@@ -7,8 +7,8 @@ import logging
 import os
 from pathlib import Path
 
-from config.dynamic_stderr_handler import DynamicStderrHandler
-from config.setup_project_paths_constants import META_KEY, UTF8_ENCODING
+from hooks_constants.dynamic_stderr_handler import DynamicStderrHandler
+from hooks_constants.setup_project_paths_constants import META_KEY, UTF8_ENCODING
 
 
 _logger = logging.getLogger("project_paths_reader")

package/hooks/{config → hooks_constants}/test_banned_identifiers_constants.py

@@ -9,7 +9,7 @@ _HOOKS_ROOT = Path(__file__).resolve().parent.parent
 if str(_HOOKS_ROOT) not in sys.path:
     sys.path.insert(0, str(_HOOKS_ROOT))
 
-from config.banned_identifiers_constants import (
+from hooks_constants.banned_identifiers_constants import (
     ALL_BANNED_IDENTIFIERS,
     BANNED_IDENTIFIER_MESSAGE_SUFFIX,
     BANNED_IDENTIFIER_SKIP_ADVISORY,

package/hooks/{config → hooks_constants}/test_dynamic_stderr_handler.py

@@ -12,7 +12,7 @@ _HOOKS_ROOT = Path(__file__).resolve().parent.parent
 if str(_HOOKS_ROOT) not in sys.path:
     sys.path.insert(0, str(_HOOKS_ROOT))
 
-from config.dynamic_stderr_handler import DynamicStderrHandler
+from hooks_constants.dynamic_stderr_handler import DynamicStderrHandler
 
 
 def _make_logger_with_handler() -> tuple[logging.Logger, DynamicStderrHandler]:

package/hooks/{config → hooks_constants}/test_hardcoded_user_path_constants.py

@@ -9,7 +9,7 @@ _HOOKS_ROOT = Path(__file__).resolve().parent.parent
 if str(_HOOKS_ROOT) not in sys.path:
     sys.path.insert(0, str(_HOOKS_ROOT))
 
-from config.hardcoded_user_path_constants import HARDCODED_USER_PATH_PATTERN
+from hooks_constants.hardcoded_user_path_constants import HARDCODED_USER_PATH_PATTERN
 
 
 def test_pattern_matches_windows_user_home() -> None:

package/hooks/{config → hooks_constants}/test_hook_log_extractor_constants.py

@@ -10,8 +10,8 @@ _HOOKS_ROOT = Path(__file__).resolve().parent.parent
 if str(_HOOKS_ROOT) not in sys.path:
     sys.path.insert(0, str(_HOOKS_ROOT))
 
-from config import hook_log_extractor_constants
-from config.hook_log_extractor_constants import (
+from hooks_constants import hook_log_extractor_constants
+from hooks_constants.hook_log_extractor_constants import (
     EXIT_CODE_ENVIRONMENT_MISSING,
     EXIT_CODE_EXTRACTOR_ENVIRONMENT_MISSING,
     EXIT_CODE_SUCCESS,