claude-dev-env 2.27.0 → 2.28.1

package/hooks/blocking/test_code_rules_enforcer_docstring_length_constant_superlative.py

@@ -1,198 +0,0 @@
-"""Tests for check_docstring_length_constant_superlative_vs_exact_gate.
-
-A config module defines an integer ``*_LENGTH`` constant and its docstring
-describes it with a superlative word ("the longest color string the swatch
-accepts"), while the only consumer treats the constant as an exact-length
-equality gate ("len(hex_color) != COLOR_AARRGGBB_LENGTH") in a sibling module.
-A shorter valid string is rejected, not accepted at a shorter length, so the
-"longest" prose claims a range of accepted lengths the code never allows. This
-is the deterministic exact-gate slice of Category O6/O8
-docstring-vs-implementation drift.
-
-The package trees these tests build live under a neutral OS temp directory
-rather than the pytest ``tmp_path`` fixture: the production check exempts any
-path containing "test", and the pytest fixture root carries that substring, so a
-fixture-rooted package would be skipped as test code and prove nothing.
-"""
-
-from __future__ import annotations
-
-import importlib.util
-import tempfile
-from pathlib import Path
-from types import ModuleType
-
-
-def _load_enforcer_module() -> ModuleType:
-    module_path = Path(__file__).parent / "code_rules_enforcer.py"
-    spec = importlib.util.spec_from_file_location("code_rules_enforcer", module_path)
-    assert spec is not None
-    assert spec.loader is not None
-    module = importlib.util.module_from_spec(spec)
-    spec.loader.exec_module(module)
-    return module
-
-
-code_rules_enforcer = _load_enforcer_module()
-
-
-def check_length_gate(content: str, file_path: str) -> list[str]:
-    return code_rules_enforcer.check_docstring_length_constant_superlative_vs_exact_gate(
-        content, file_path
-    )
-
-
-SUPERLATIVE_SWATCH_MODULE = '''"""Color-swatch rendering constants for the HTML run report.
-
-These constants name the longest color string the swatch accepts and the
-channel maximum the alpha byte is divided by.
-"""
-
-from typing import Final
-
-COLOR_AARRGGBB_LENGTH: Final[int] = 9
-'''
-
-
-def _run_gate_over_package(
-    swatch_content: str, consumer_body: str, swatch_basename: str = "color_swatch.py"
-) -> list[str]:
-    with tempfile.TemporaryDirectory() as temp_root:
-        config_directory = Path(temp_root) / "stp_contrast_fix" / "config"
-        config_directory.mkdir(parents=True)
-        swatch_path = config_directory / swatch_basename
-        swatch_path.write_text(swatch_content, encoding="utf-8")
-        consumer_path = config_directory.parent / "html_report_fragments.py"
-        consumer_path.write_text(consumer_body, encoding="utf-8")
-        return check_length_gate(swatch_content, str(swatch_path))
-
-
-def test_superlative_describing_exact_length_gate_is_flagged() -> None:
-    consumer_body = (
-        "from config.color_swatch import COLOR_AARRGGBB_LENGTH\n\n\n"
-        "def to_css(hex_color: str) -> str | None:\n"
-        '    if not hex_color.startswith("#") or len(hex_color) != '
-        "COLOR_AARRGGBB_LENGTH:\n"
-        "        return None\n"
-        "    return hex_color\n"
-    )
-    issues = _run_gate_over_package(SUPERLATIVE_SWATCH_MODULE, consumer_body)
-    assert len(issues) == 1
-    assert "COLOR_AARRGGBB_LENGTH" in issues[0]
-
-
-def test_ordered_comparison_treated_as_maximum_is_not_flagged() -> None:
-    consumer_body = (
-        "from config.color_swatch import COLOR_AARRGGBB_LENGTH\n\n\n"
-        "def truncated(hex_color: str) -> bool:\n"
-        "    return len(hex_color) <= COLOR_AARRGGBB_LENGTH\n"
-    )
-    assert _run_gate_over_package(SUPERLATIVE_SWATCH_MODULE, consumer_body) == []
-
-
-def test_no_superlative_phrase_is_not_flagged() -> None:
-    plain_module = (
-        '"""The exact required #AARRGGBB length the swatch renders."""\n\n'
-        "from typing import Final\n\n"
-        "COLOR_AARRGGBB_LENGTH: Final[int] = 9\n"
-    )
-    consumer_body = (
-        "from config.color_swatch import COLOR_AARRGGBB_LENGTH\n\n\n"
-        "def to_css(hex_color: str) -> bool:\n"
-        "    return len(hex_color) == COLOR_AARRGGBB_LENGTH\n"
-    )
-    assert _run_gate_over_package(plain_module, consumer_body) == []
-
-
-def test_constant_without_length_suffix_is_not_flagged() -> None:
-    non_length_module = (
-        '"""The longest swatch threshold value used by the renderer."""\n\n'
-        "from typing import Final\n\n"
-        "COLOR_CHANNEL_MAXIMUM: Final[int] = 255\n"
-    )
-    consumer_body = (
-        "from config.color_swatch import COLOR_CHANNEL_MAXIMUM\n\n\n"
-        "def saturated(channel: str) -> bool:\n"
-        "    return len(channel) == COLOR_CHANNEL_MAXIMUM\n"
-    )
-    assert _run_gate_over_package(non_length_module, consumer_body) == []
-
-
-def test_constant_with_no_length_comparison_is_not_flagged() -> None:
-    consumer_body = (
-        "from config.color_swatch import COLOR_AARRGGBB_LENGTH\n\n\n"
-        "def pad(hex_color: str) -> str:\n"
-        "    return hex_color.ljust(COLOR_AARRGGBB_LENGTH)\n"
-    )
-    assert _run_gate_over_package(SUPERLATIVE_SWATCH_MODULE, consumer_body) == []
-
-
-def test_superlative_in_function_docstring_is_not_flagged() -> None:
-    function_docstring_module = (
-        '"""The exact #AARRGGBB length the swatch renders."""\n\n'
-        "from typing import Final\n\n"
-        "COLOR_AARRGGBB_LENGTH: Final[int] = 9\n\n\n"
-        "def describe() -> str:\n"
-        '    """Return the longest color string the swatch accepts."""\n'
-        '    return "swatch"\n'
-    )
-    consumer_body = (
-        "from config.color_swatch import COLOR_AARRGGBB_LENGTH\n\n\n"
-        "def to_css(hex_color: str) -> bool:\n"
-        "    return len(hex_color) == COLOR_AARRGGBB_LENGTH\n"
-    )
-    assert _run_gate_over_package(function_docstring_module, consumer_body) == []
-
-
-def test_superlative_bound_to_other_constant_is_not_flagged() -> None:
-    two_constant_module = (
-        '"""Color-swatch rendering constants for the HTML run report.\n\n'
-        "COLOR_AARRGGBB_LENGTH is the exact #AARRGGBB length the swatch renders.\n"
-        "MAX_NAME_LENGTH is the longest swatch label the legend lays out.\n"
-        '"""\n\n'
-        "from typing import Final\n\n"
-        "COLOR_AARRGGBB_LENGTH: Final[int] = 9\n"
-        "MAX_NAME_LENGTH: Final[int] = 32\n"
-    )
-    consumer_body = (
-        "from config.color_swatch import COLOR_AARRGGBB_LENGTH, MAX_NAME_LENGTH\n\n\n"
-        "def to_css(hex_color: str) -> str | None:\n"
-        "    if len(hex_color) != COLOR_AARRGGBB_LENGTH:\n"
-        "        return None\n"
-        "    return hex_color\n\n\n"
-        "def fits(label: str) -> bool:\n"
-        "    return len(label) <= MAX_NAME_LENGTH\n"
-    )
-    assert _run_gate_over_package(two_constant_module, consumer_body) == []
-
-
-def test_superlative_bound_to_exact_gated_constant_is_flagged() -> None:
-    two_constant_module = (
-        '"""Color-swatch rendering constants for the HTML run report.\n\n'
-        "COLOR_AARRGGBB_LENGTH is the longest #AARRGGBB string the swatch accepts.\n"
-        "MAX_NAME_LENGTH is the exact swatch label width the legend lays out.\n"
-        '"""\n\n'
-        "from typing import Final\n\n"
-        "COLOR_AARRGGBB_LENGTH: Final[int] = 9\n"
-        "MAX_NAME_LENGTH: Final[int] = 32\n"
-    )
-    consumer_body = (
-        "from config.color_swatch import COLOR_AARRGGBB_LENGTH, MAX_NAME_LENGTH\n\n\n"
-        "def to_css(hex_color: str) -> str | None:\n"
-        "    if len(hex_color) != COLOR_AARRGGBB_LENGTH:\n"
-        "        return None\n"
-        "    return hex_color\n\n\n"
-        "def fits(label: str) -> bool:\n"
-        "    return len(label) <= MAX_NAME_LENGTH\n"
-    )
-    issues = _run_gate_over_package(two_constant_module, consumer_body)
-    assert len(issues) == 1
-    assert "COLOR_AARRGGBB_LENGTH" in issues[0]
-    assert "MAX_NAME_LENGTH" not in issues[0]
-
-
-def test_syntax_error_returns_empty() -> None:
-    issues = check_length_gate(
-        "def broken(\n", "/stp_contrast_fix/config/color_swatch.py"
-    )
-    assert issues == []

package/hooks/blocking/test_code_rules_enforcer_docstring_mark_glyph_enumeration.py

@@ -1,262 +0,0 @@
-"""Tests for check_docstring_punctuation_mark_enumeration_coverage — O6 glyph drift.
-
-A module defines a tuple of punctuation-mark glyphs (an em-dash, a spaced
-double-hyphen, a semicolon) and a docstring enumerates those marks by their
-English names while omitting one the tuple holds. The prose names two marks but
-the detection set holds three, so a reader who trusts the enumeration believes a
-mark that is active never triggers the check. This is the deterministic
-glyph-prose slice of Category O6 docstring-prose-vs-implementation drift, the
-companion to check_docstring_tuple_enumeration_match for glyph members named in
-prose rather than identifier members named in inline code.
-"""
-
-from __future__ import annotations
-
-import importlib.util
-from pathlib import Path
-from types import ModuleType
-
-
-def _load_enforcer_module() -> ModuleType:
-    module_path = Path(__file__).parent / "code_rules_enforcer.py"
-    spec = importlib.util.spec_from_file_location("code_rules_enforcer", module_path)
-    assert spec is not None
-    assert spec.loader is not None
-    module = importlib.util.module_from_spec(spec)
-    spec.loader.exec_module(module)
-    return module
-
-
-code_rules_enforcer = _load_enforcer_module()
-
-
-def check_docstring_punctuation_mark_enumeration_coverage(
-    content: str, file_path: str
-) -> list[str]:
-    return code_rules_enforcer.check_docstring_punctuation_mark_enumeration_coverage(
-        content, file_path
-    )
-
-
-def validate_content(content: str, file_path: str, old_content: str) -> list[str]:
-    return code_rules_enforcer.validate_content(content, file_path, old_content)
-
-
-PRODUCTION_FILE_PATH = "/project/src/runon_detector.py"
-TEST_FILE_PATH = "/project/src/test_runon_detector.py"
-HOOK_INFRASTRUCTURE_PATH = "/home/user/.claude/hooks/blocking/code_rules_docstrings.py"
-
-
-def _drifted_two_marks_named_function() -> str:
-    return (
-        'ALL_RUNON_JOINER_MARKERS = ("—", " -- ", ";")\n'
-        "\n"
-        "\n"
-        "def _sentence_carries_joiner(sentence_text: str) -> bool:\n"
-        '    """Report whether the sentence chains clauses with a joiner mark.\n'
-        "\n"
-        "    The run-on marks are an em-dash or a semicolon, the two glyphs that\n"
-        "    fuse independent clauses into one dense sentence.\n"
-        '    """\n'
-        "    return any(each in sentence_text for each in ALL_RUNON_JOINER_MARKERS)\n"
-    )
-
-
-def _complete_three_marks_named_function() -> str:
-    return (
-        'ALL_RUNON_JOINER_MARKERS = ("—", " -- ", ";")\n'
-        "\n"
-        "\n"
-        "def _sentence_carries_joiner(sentence_text: str) -> bool:\n"
-        '    """Report whether the sentence chains clauses with a joiner mark.\n'
-        "\n"
-        "    The run-on marks are an em-dash, a spaced double-hyphen, or a\n"
-        "    semicolon, the glyphs that fuse independent clauses into one\n"
-        "    dense sentence.\n"
-        '    """\n'
-        "    return any(each in sentence_text for each in ALL_RUNON_JOINER_MARKERS)\n"
-    )
-
-
-def _single_mark_named_function() -> str:
-    return (
-        'ALL_RUNON_JOINER_MARKERS = ("—", " -- ", ";")\n'
-        "\n"
-        "\n"
-        "def _sentence_carries_joiner(sentence_text: str) -> bool:\n"
-        '    """Report whether the sentence chains clauses with an em-dash.\n'
-        "\n"
-        "    The em-dash is the glyph that fuses clauses into one sentence.\n"
-        '    """\n'
-        "    return any(each in sentence_text for each in ALL_RUNON_JOINER_MARKERS)\n"
-    )
-
-
-def _non_glyph_tuple_function() -> str:
-    return (
-        'ALL_OUTCOME_LABELS = ("alpha", "beta", "gamma")\n'
-        "\n"
-        "\n"
-        "def describe_outcome(label_text: str) -> bool:\n"
-        '    """Report the outcome named by an em-dash or a semicolon label.\n'
-        "\n"
-        "    The labels carry a semicolon between the segments of each name.\n"
-        '    """\n'
-        "    return label_text in ALL_OUTCOME_LABELS\n"
-    )
-
-
-def test_should_flag_omitted_double_hyphen_mark() -> None:
-    issues = check_docstring_punctuation_mark_enumeration_coverage(
-        _drifted_two_marks_named_function(), PRODUCTION_FILE_PATH
-    )
-    assert any("--" in each for each in issues), (
-        f"The docstring naming em-dash and semicolon but omitting the double-hyphen "
-        f"that ALL_RUNON_JOINER_MARKERS holds must be flagged, got: {issues!r}"
-    )
-
-
-def test_should_report_category_o6_in_the_message() -> None:
-    issues = check_docstring_punctuation_mark_enumeration_coverage(
-        _drifted_two_marks_named_function(), PRODUCTION_FILE_PATH
-    )
-    assert any("O6" in each for each in issues), (
-        f"Expected the Category O6 label in the message, got: {issues!r}"
-    )
-
-
-def test_should_not_flag_complete_enumeration() -> None:
-    issues = check_docstring_punctuation_mark_enumeration_coverage(
-        _complete_three_marks_named_function(), PRODUCTION_FILE_PATH
-    )
-    assert issues == [], f"A docstring naming all three marks must not be flagged, got: {issues!r}"
-
-
-def test_should_not_flag_single_named_mark_below_threshold() -> None:
-    issues = check_docstring_punctuation_mark_enumeration_coverage(
-        _single_mark_named_function(), PRODUCTION_FILE_PATH
-    )
-    assert issues == [], f"A docstring naming a single mark is not an enumeration, got: {issues!r}"
-
-
-def test_should_not_flag_non_glyph_tuple() -> None:
-    issues = check_docstring_punctuation_mark_enumeration_coverage(
-        _non_glyph_tuple_function(), PRODUCTION_FILE_PATH
-    )
-    assert issues == [], f"A tuple of non-punctuation members must not be flagged, got: {issues!r}"
-
-
-def test_should_flag_on_hook_infrastructure_where_the_drift_lives() -> None:
-    issues = check_docstring_punctuation_mark_enumeration_coverage(
-        _drifted_two_marks_named_function(), HOOK_INFRASTRUCTURE_PATH
-    )
-    assert any("--" in each for each in issues), (
-        f"The drift lives in hook modules, so the gate must run there, got: {issues!r}"
-    )
-
-
-def test_should_skip_test_file() -> None:
-    issues = check_docstring_punctuation_mark_enumeration_coverage(
-        _drifted_two_marks_named_function(), TEST_FILE_PATH
-    )
-    assert issues == [], f"Test files exempt, got: {issues!r}"
-
-
-def test_should_handle_syntax_error_gracefully() -> None:
-    unparseable_naming_marks = 'def fetch(\n    """An em-dash and a semicolon."""\n'
-    issues = check_docstring_punctuation_mark_enumeration_coverage(
-        unparseable_naming_marks, PRODUCTION_FILE_PATH
-    )
-    assert issues == [], f"Syntax error must yield no issues, got: {issues!r}"
-
-
-def _drifted_annotated_tuple_function() -> str:
-    return (
-        'ALL_RUNON_JOINER_MARKERS: tuple[str, ...] = ("—", " -- ", ";")\n'
-        "\n"
-        "\n"
-        "def _sentence_carries_joiner(sentence_text: str) -> bool:\n"
-        '    """Report whether the sentence chains clauses with a joiner mark.\n'
-        "\n"
-        "    The run-on marks are an em-dash or a semicolon.\n"
-        '    """\n'
-        "    return any(each in sentence_text for each in ALL_RUNON_JOINER_MARKERS)\n"
-    )
-
-
-def test_should_flag_annotated_same_module_tuple_drift() -> None:
-    issues = check_docstring_punctuation_mark_enumeration_coverage(
-        _drifted_annotated_tuple_function(), PRODUCTION_FILE_PATH
-    )
-    assert any("--" in each for each in issues), (
-        f"An annotated marker tuple in the same module must be checked, got: {issues!r}"
-    )
-
-
-def test_should_flag_drift_against_imported_companion_tuple(tmp_path: Path) -> None:
-    companion_directory = tmp_path / "marks_package"
-    companion_directory.mkdir()
-    (companion_directory / "joiner_marks.py").write_text(
-        'ALL_RUNON_JOINER_MARKERS: tuple[str, ...] = ("—", " -- ", ";")\n',
-        encoding="utf-8",
-    )
-    consumer_directory = tmp_path / "blocking"
-    consumer_directory.mkdir()
-    consumer_source = (
-        "from marks_package.joiner_marks import ALL_RUNON_JOINER_MARKERS\n"
-        "\n"
-        "\n"
-        "def _sentence_carries_joiner(sentence_text: str) -> bool:\n"
-        '    """Report whether the sentence chains clauses with a joiner mark.\n'
-        "\n"
-        "    The run-on marks are an em-dash or a semicolon, the two glyphs that\n"
-        "    fuse independent clauses into one dense sentence.\n"
-        '    """\n'
-        "    return any(each in sentence_text for each in ALL_RUNON_JOINER_MARKERS)\n"
-    )
-    consumer_path = consumer_directory / "runon_consumer.py"
-    consumer_path.write_text(consumer_source, encoding="utf-8")
-    issues = check_docstring_punctuation_mark_enumeration_coverage(
-        consumer_source, str(consumer_path)
-    )
-    assert any("--" in each for each in issues), (
-        f"A docstring drifting from an imported companion marker tuple must be "
-        f"flagged so the split-file shape is caught, got: {issues!r}"
-    )
-
-
-def test_should_not_resolve_companion_when_no_marks_named(tmp_path: Path) -> None:
-    companion_directory = tmp_path / "marks_package"
-    companion_directory.mkdir()
-    (companion_directory / "joiner_marks.py").write_text(
-        'ALL_RUNON_JOINER_MARKERS: tuple[str, ...] = ("—", " -- ", ";")\n',
-        encoding="utf-8",
-    )
-    consumer_directory = tmp_path / "blocking"
-    consumer_directory.mkdir()
-    consumer_source = (
-        "from marks_package.joiner_marks import ALL_RUNON_JOINER_MARKERS\n"
-        "\n"
-        "\n"
-        "def _sentence_carries_joiner(sentence_text: str) -> bool:\n"
-        '    """Report whether the sentence carries any joiner glyph."""\n'
-        "    return any(each in sentence_text for each in ALL_RUNON_JOINER_MARKERS)\n"
-    )
-    consumer_path = consumer_directory / "runon_consumer.py"
-    consumer_path.write_text(consumer_source, encoding="utf-8")
-    issues = check_docstring_punctuation_mark_enumeration_coverage(
-        consumer_source, str(consumer_path)
-    )
-    assert issues == [], (
-        f"A docstring naming no marks must not be flagged, got: {issues!r}"
-    )
-
-
-def test_validate_content_surfaces_mark_glyph_drift() -> None:
-    issues = validate_content(
-        _drifted_two_marks_named_function(), PRODUCTION_FILE_PATH, old_content=""
-    )
-    matching_issues = [each for each in issues if "--" in each and "O6" in each]
-    assert matching_issues, (
-        f"Expected validate_content to surface the O6 mark-glyph drift, got: {issues!r}"
-    )

package/hooks/blocking/test_code_rules_enforcer_docstring_no_consumer.py

@@ -1,93 +0,0 @@
-"""Tests for check_docstring_no_consumer_claim — Category O8 producer/consumer drift.
-
-A producer docstring claiming "no consumer reads it yet" or "producer-only
-artifact" is a transitional statement that drifts the moment a reader lands and
-contradicts any companion SKILL.md that documents the consumer. This is the
-deterministic slice of Category O8 (docstring / companion-doc producer-consumer
-drift) and a no-transitional-language violation in its own right.
-"""
-
-from __future__ import annotations
-
-import importlib.util
-from pathlib import Path
-from types import ModuleType
-
-
-def _load_enforcer_module() -> ModuleType:
-    module_path = Path(__file__).parent / "code_rules_enforcer.py"
-    spec = importlib.util.spec_from_file_location("code_rules_enforcer", module_path)
-    assert spec is not None
-    assert spec.loader is not None
-    module = importlib.util.module_from_spec(spec)
-    spec.loader.exec_module(module)
-    return module
-
-
-code_rules_enforcer = _load_enforcer_module()
-
-
-def check_docstring_no_consumer_claim(content: str, file_path: str) -> list[str]:
-    return code_rules_enforcer.check_docstring_no_consumer_claim(content, file_path)
-
-
-PRODUCTION_FILE_PATH = "/project/scripts/scan_priority_queue.py"
-TEST_FILE_PATH = "/project/scripts/test_scan_priority_queue.py"
-HOOK_INFRASTRUCTURE_PATH = "/home/user/.claude/hooks/blocking/example.py"
-
-
-def test_flags_producer_only_artifact_claim() -> None:
-    content = (
-        "def write_skip_list(skip_list_path: str) -> int:\n"
-        '    """Merge the at-risk names into the skip-list JSON.\n'
-        "\n"
-        "    This is a producer-only artifact; no submission-run consumer reads it yet.\n"
-        "\n"
-        "    Returns:\n"
-        "        How many names the merged list holds.\n"
-        '    """\n'
-        "    return 0\n"
-    )
-    issues = check_docstring_no_consumer_claim(content, PRODUCTION_FILE_PATH)
-    assert len(issues) == 1
-    assert "write_skip_list" in issues[0]
-
-
-def test_flags_no_submission_run_consumer_phrase() -> None:
-    content = (
-        "def write_skip_list(skip_list_path: str) -> int:\n"
-        '    """Write the JSON. No submission-run consumer reads it yet."""\n'
-        "    return 0\n"
-    )
-    assert len(check_docstring_no_consumer_claim(content, PRODUCTION_FILE_PATH)) == 1
-
-
-def test_passes_when_docstring_names_the_consumer() -> None:
-    content = (
-        "def write_skip_list(skip_list_path: str) -> int:\n"
-        '    """Write the JSON. The new-theme submission run reads it and applies the skip.\n'
-        "\n"
-        "    Returns:\n"
-        "        How many names the merged list holds.\n"
-        '    """\n'
-        "    return 0\n"
-    )
-    assert check_docstring_no_consumer_claim(content, PRODUCTION_FILE_PATH) == []
-
-
-def test_test_files_are_exempt() -> None:
-    content = (
-        "def write_skip_list(skip_list_path: str) -> int:\n"
-        '    """This is a producer-only artifact; no consumer reads it yet."""\n'
-        "    return 0\n"
-    )
-    assert check_docstring_no_consumer_claim(content, TEST_FILE_PATH) == []
-
-
-def test_hook_infrastructure_is_exempt() -> None:
-    content = (
-        "def write_skip_list(skip_list_path: str) -> int:\n"
-        '    """This is a producer-only artifact; no consumer reads it yet."""\n'
-        "    return 0\n"
-    )
-    assert check_docstring_no_consumer_claim(content, HOOK_INFRASTRUCTURE_PATH) == []

package/hooks/blocking/test_code_rules_enforcer_docstring_no_network.py

@@ -1,115 +0,0 @@
-"""Tests for check_docstring_no_network_claim_with_metadata_access — Category O6.
-
-A docstring promising a code path returns "without touching the network" drifts
-when the body calls a path-metadata method (``is_file``, ``stat``, ...): on a
-network share each metadata call is a round-trip over the wire, so the no-network
-claim is false. This is the deterministic slice of Category O6 (docstring prose
-versus implementation drift) for a no-network claim.
-"""
-
-from __future__ import annotations
-
-import importlib.util
-from pathlib import Path
-from types import ModuleType
-
-
-def _load_enforcer_module() -> ModuleType:
-    module_path = Path(__file__).parent / "code_rules_enforcer.py"
-    spec = importlib.util.spec_from_file_location("code_rules_enforcer", module_path)
-    assert spec is not None
-    assert spec.loader is not None
-    module = importlib.util.module_from_spec(spec)
-    spec.loader.exec_module(module)
-    return module
-
-
-code_rules_enforcer = _load_enforcer_module()
-
-
-def check_docstring_no_network_claim(content: str, file_path: str) -> list[str]:
-    return code_rules_enforcer.check_docstring_no_network_claim_with_metadata_access(
-        content, file_path
-    )
-
-
-PRODUCTION_FILE_PATH = "/project/shared_utils/bws/secret_fetch.py"
-TEST_FILE_PATH = "/project/shared_utils/bws/tests/test_secret_fetch.py"
-HOOK_INFRASTRUCTURE_PATH = "/home/user/.claude/hooks/blocking/example.py"
-
-
-def test_flags_no_network_claim_with_is_file_and_stat() -> None:
-    content = (
-        "def _ensure_local_bws_cache() -> str:\n"
-        '    """Return the local cache path, repopulating when stale.\n'
-        "\n"
-        "    An existing cache is returned without touching the network; a\n"
-        "    missing or size-mismatched cache is repopulated from the bundled\n"
-        "    executable.\n"
-        '    """\n'
-        "    if BUNDLED_BWS_EXECUTABLE_PATH.is_file():\n"
-        "        bundled_size = BUNDLED_BWS_EXECUTABLE_PATH.stat().st_size\n"
-        "        return str(LOCAL_BWS_CACHE_PATH)\n"
-        "    return str(LOCAL_BWS_CACHE_PATH)\n"
-    )
-    issues = check_docstring_no_network_claim(content, PRODUCTION_FILE_PATH)
-    assert len(issues) == 1
-    assert "_ensure_local_bws_cache" in issues[0]
-    assert "without touching the network" in issues[0]
-
-
-def test_flags_no_network_access_phrase_with_exists() -> None:
-    content = (
-        "def read_warm_cache(cache_path) -> str:\n"
-        '    """Serve the warm cache with no network access."""\n'
-        "    if cache_path.exists():\n"
-        "        return cache_path.read_text()\n"
-        "    return ''\n"
-    )
-    assert len(check_docstring_no_network_claim(content, PRODUCTION_FILE_PATH)) == 1
-
-
-def test_passes_when_claim_present_but_no_metadata_access() -> None:
-    content = (
-        "def read_warm_cache(cache_path) -> str:\n"
-        '    """Serve the warm cache without touching the network."""\n'
-        "    return cache_path.read_text()\n"
-    )
-    assert check_docstring_no_network_claim(content, PRODUCTION_FILE_PATH) == []
-
-
-def test_passes_when_metadata_access_but_no_network_claim() -> None:
-    content = (
-        "def _ensure_local_bws_cache(share_path) -> str:\n"
-        '    """Return the local cache path, repopulating when stale.\n'
-        "\n"
-        "    The bundled share is stat-checked on every call to validate the\n"
-        "    cache against the bundled executable size.\n"
-        '    """\n'
-        "    if share_path.is_file():\n"
-        "        return str(share_path)\n"
-        "    return ''\n"
-    )
-    assert check_docstring_no_network_claim(content, PRODUCTION_FILE_PATH) == []
-
-
-def test_test_files_are_exempt() -> None:
-    content = (
-        "def _ensure_local_bws_cache(share_path) -> str:\n"
-        '    """Return the cache without touching the network."""\n'
-        "    if share_path.is_file():\n"
-        "        return str(share_path)\n"
-        "    return ''\n"
-    )
-    assert check_docstring_no_network_claim(content, TEST_FILE_PATH) == []
-
-
-def test_hook_infrastructure_is_exempt() -> None:
-    content = (
-        "def _ensure_local_bws_cache(share_path) -> str:\n"
-        '    """Return the cache without touching the network."""\n'
-        "    if share_path.is_file():\n"
-        "        return str(share_path)\n"
-        "    return ''\n"
-    )
-    assert check_docstring_no_network_claim(content, HOOK_INFRASTRUCTURE_PATH) == []