claude-dev-env 1.49.1 → 1.50.0

package/hooks/blocking/test_md_to_html_blocker.py

@@ -252,6 +252,44 @@ def test_blocks_changelog_not_at_root():
     assert output["hookSpecificOutput"]["permissionDecision"] == "deny"
 
 
+def test_passes_claude_md_at_root():
+    result = _run_hook(
+        "Write",
+        {"file_path": "CLAUDE.md", "content": "# CLAUDE"},
+    )
+    assert result.returncode == 0
+    assert result.stdout == ""
+
+
+def test_passes_agents_md_at_root():
+    result = _run_hook(
+        "Write",
+        {"file_path": "AGENTS.md", "content": "# AGENTS"},
+    )
+    assert result.returncode == 0
+    assert result.stdout == ""
+
+
+def test_blocks_claude_md_not_at_root():
+    result = _run_hook(
+        "Write",
+        {"file_path": "docs/CLAUDE.md", "content": "# CLAUDE"},
+    )
+    assert result.returncode == 0
+    output = json.loads(result.stdout)
+    assert output["hookSpecificOutput"]["permissionDecision"] == "deny"
+
+
+def test_blocks_agents_md_not_at_root():
+    result = _run_hook(
+        "Write",
+        {"file_path": "sub/AGENTS.md", "content": "# AGENTS"},
+    )
+    assert result.returncode == 0
+    output = json.loads(result.stdout)
+    assert output["hookSpecificOutput"]["permissionDecision"] == "deny"
+
+
 def test_blocks_relative_readme_when_cwd_is_not_repo_root():
     sandbox_parent = _get_sandbox_parent_directory()
     non_repo_cwd = os.path.join(sandbox_parent, "not-a-repo")

package/hooks/hooks_constants/blocking_check_limits.py

@@ -16,6 +16,8 @@ MAX_BARE_EXCEPT_ISSUES: int = 3
 MAX_BOUNDARY_TYPE_ISSUES: int = 5
 ALL_BANNED_PREFIX_NAMES: tuple[str, ...] = ("handle_", "process_", "manage_", "do_")
 MAX_DOCSTRING_FORMAT_ISSUES: int = 5
+MAX_DOCSTRING_ARGS_SIGNATURE_ISSUES: int = 5
+MAX_IGNORED_MUST_CHECK_RETURN_ISSUES: int = 5
 MAX_TYPE_ESCAPE_HATCH_ISSUES: int = 5
 MAX_THIN_WRAPPER_ISSUES: int = 1
 DOCSTRING_TRIVIAL_FUNCTION_BODY_LINE_LIMIT: int = 3

package/hooks/hooks_constants/code_rules_enforcer_constants.py

@@ -24,9 +24,23 @@ ALL_MIGRATION_PATH_PATTERNS = {"/migrations/", "\\migrations\\"}
 ADVISORY_LINE_THRESHOLD_SOFT = 400
 ADVISORY_LINE_THRESHOLD_HARD = 1000
 
-ALL_BOOLEAN_NAME_PREFIXES: tuple[str, ...] = ("is_", "has_", "should_", "can_")
+ALL_BOOLEAN_NAME_PREFIXES: tuple[str, ...] = ("is_", "has_", "should_", "can_", "was_", "did_")
 UPPER_SNAKE_CONSTANT_PATTERN = re.compile(r"^[A-Z][A-Z0-9_]*$")
 
+ALL_MUST_CHECK_RETURN_FUNCTION_NAMES: frozenset[str] = frozenset({"find_and_click", "write_outcome"})
+
+DOCSTRING_ARG_ENTRY_PATTERN: re.Pattern[str] = re.compile(r"^([A-Za-z_][A-Za-z0-9_]*)\s*[:(]")
+ALL_DOCSTRING_ARGS_SECTION_HEADERS: tuple[str, ...] = ("Args:", "Arguments:")
+ALL_DOCSTRING_TERMINATING_SECTION_HEADERS: frozenset[str] = frozenset({
+    "Returns:",
+    "Yields:",
+    "Raises:",
+    "Examples:",
+    "Example:",
+    "Note:",
+    "Notes:",
+})
+
 
 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 ")

package/hooks/hooks_constants/md_to_html_blocker_constants.py

@@ -19,7 +19,7 @@ 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")
+ALL_EXEMPT_ROOT_FILENAMES: tuple[str, ...] = ("readme.md", "changelog.md", "claude.md", "agents.md")
 REPO_ROOT_MARKER_NAME: str = ".git"
 CLAUDE_DIRECTORY_NAME: str = ".claude"
 PLUGIN_ROOT_MARKER_DIRECTORY_NAME: str = ".claude-plugin"

package/hooks/hooks_constants/test_md_to_html_blocker_constants.py

@@ -82,10 +82,17 @@ def test_exempt_home_relative_directories_include_session_log() -> None:
     assert "ALL_EXEMPT_HOME_RELATIVE_DIRECTORIES" in constants_module.__all__
 
 
-def test_exempt_root_filenames_cover_readme_and_changelog() -> None:
-    """README.md and CHANGELOG.md at a repo root are universally exempt;
-    every repo with a `.git` marker satisfies the root check."""
-    assert constants_module.ALL_EXEMPT_ROOT_FILENAMES == ("readme.md", "changelog.md")
+def test_exempt_root_filenames_cover_readme_changelog_claude_and_agents() -> None:
+    """README.md, CHANGELOG.md, CLAUDE.md, and AGENTS.md at a repo root are
+    universally exempt; every repo with a `.git` marker satisfies the root
+    check. CLAUDE.md and AGENTS.md are functional agent-instruction files that
+    Claude Code loads by name and must stay Markdown."""
+    assert constants_module.ALL_EXEMPT_ROOT_FILENAMES == (
+        "readme.md",
+        "changelog.md",
+        "claude.md",
+        "agents.md",
+    )
     assert "ALL_EXEMPT_ROOT_FILENAMES" in constants_module.__all__
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "claude-dev-env",
-    "version": "1.49.1",
+    "version": "1.50.0",
     "description": "Claude Code development standards — rules, hooks, agents, commands, and skills",
     "type": "module",
     "bin": {