refactor: drop legacy aliases and flat config files, add lock file ignores

Author: nikolay-e

src/treemapper/__init__.py

@@ -96,7 +96,3 @@ def to_markdown(tree: dict[str, Any]) -> str:
     buf = io.StringIO()
     write_tree_markdown(buf, tree)
     return buf.getvalue()
-
-
-to_md = to_markdown
-to_txt = to_text

src/treemapper/cli.py

@@ -109,9 +109,9 @@ def _warn_diff_only_flags(args: argparse.Namespace) -> None:
     if args.budget is not None:
         used.append("--budget")
     if abs(args.alpha - 0.60) > 1e-9:
-        used.append("--alpha/--context-precision")
+        used.append("--alpha")
     if abs(args.tau - 0.08) > 1e-9:
-        used.append("--tau/--min-relevance")
+        used.append("--tau")
     if args.full:
         used.append("--full")
     if used:
@@ -147,6 +147,8 @@ class ParsedArgs:
   .git/, .svn/, .hg/    Version control directories
   __pycache__/, *.py[cod], *.so, venv/, .venv/, .tox/, .nox/  Python
   node_modules/, .npm/  JavaScript/Node
+  package-lock.json, yarn.lock, pnpm-lock.yaml  JS lock files
+  Pipfile.lock, poetry.lock, Cargo.lock, Gemfile.lock  Other lock files
   target/, .gradle/     Java/Maven/Gradle
   bin/, obj/            .NET
   vendor/               Go/PHP
@@ -158,12 +160,10 @@ class ParsedArgs:
 
 Ignore files (hierarchical, like git):
   .gitignore            Standard git ignore patterns
-  .treemapper/ignore    TreeMapper-specific patterns (preferred)
-  .treemapperignore     TreeMapper-specific patterns (legacy)
+  .treemapper/ignore    TreeMapper-specific patterns
 
 Whitelist files (auto-discovered):
-  .treemapper/whitelist  Include-only filter (preferred)
-  .treemapperwhitelist   Include-only filter (legacy)
+  .treemapper/whitelist  Include-only filter
 
 Examples:
   treemapper .                    Map current directory to YAML
@@ -212,7 +212,7 @@ def parse_args() -> ParsedArgs:
     parser.add_argument(
         "-f",
         "--format",
-        choices=["yaml", "yml", "json", "txt", "md"],
+        choices=["yaml", "json", "txt", "md"],
         default="yaml",
         help="Output format (default: yaml)",
     )
@@ -265,15 +265,13 @@ def parse_args() -> ParsedArgs:
     )
     diff_group.add_argument(
         "--alpha",
-        "--context-precision",
         type=float,
         default=0.60,
         metavar="F",
         help="How tightly context clusters around changes, 0-1 (default: 0.60, higher = more focused)",
     )
     diff_group.add_argument(
         "--tau",
-        "--min-relevance",
         type=float,
         default=0.08,
         metavar="F",
@@ -295,7 +293,7 @@ def parse_args() -> ParsedArgs:
     _warn_diff_only_flags(args)
 
     root_dir = _resolve_root_dir(args.directory)
-    output_format = "yaml" if args.format == "yml" else args.format
+    output_format = args.format
     output_file, force_stdout = _resolve_output_file(args.output_file, args.save, output_format)
     ignore_file = _resolve_ignore_file(args.ignore_file)
     whitelist_file = _resolve_whitelist_file(args.whitelist_file)

src/treemapper/ignore.py

@@ -225,6 +225,15 @@ def _collect_parent_ignore_patterns(root: Path, ignore_filenames: list[str]) ->
     # JavaScript/Node
     "**/node_modules/",
     "**/.npm/",
+    # Lock files (large, auto-generated, low signal for LLM analysis)
+    "**/package-lock.json",
+    "**/yarn.lock",
+    "**/pnpm-lock.yaml",
+    "**/Pipfile.lock",
+    "**/poetry.lock",
+    "**/Cargo.lock",
+    "**/composer.lock",
+    "**/Gemfile.lock",
     # Java/JVM
     "**/target/",
     "**/.gradle/",
@@ -247,7 +256,6 @@ def _collect_parent_ignore_patterns(root: Path, ignore_filenames: list[str]) ->
     # TreeMapper config and output files
     "**/.treemapper/",
     "**/tree.yaml",
-    "**/tree.yml",
     "**/tree.json",
     "**/tree.md",
     "**/tree.txt",
@@ -264,8 +272,8 @@ def get_ignore_specs(
 
     if not no_default_ignores:
         patterns.extend(DEFAULT_IGNORE_PATTERNS)
-        patterns.extend(_collect_parent_ignore_patterns(root_dir, [".gitignore", ".treemapperignore"]))
-        patterns.extend(_aggregate_all_ignore_patterns(root_dir, [".gitignore", ".treemapperignore"]))
+        patterns.extend(_collect_parent_ignore_patterns(root_dir, [".gitignore"]))
+        patterns.extend(_aggregate_all_ignore_patterns(root_dir, [".gitignore"]))
 
     if custom_ignore_file:
         patterns.extend(read_ignore_file(custom_ignore_file))
@@ -287,19 +295,12 @@ def should_ignore(relative_path_str: str, combined_spec: pathspec.PathSpec) -> b
     return is_ignored
 
 
-DEFAULT_WHITELIST_FILENAME = ".treemapperwhitelist"
-
-
 def get_whitelist_spec(whitelist_file: Path | None, root_dir: Path | None = None) -> pathspec.PathSpec | None:
     effective_file = whitelist_file
     if not effective_file and root_dir:
         config_whitelist = root_dir / TREEMAPPER_CONFIG_DIR / TREEMAPPER_DIR_WHITELIST
         if config_whitelist.is_file():
             effective_file = config_whitelist
-        else:
-            default = root_dir / DEFAULT_WHITELIST_FILENAME
-            if default.is_file():
-                effective_file = default
     if not effective_file:
         return None
     patterns = read_ignore_file(effective_file)

src/treemapper/writer.py

@@ -47,12 +47,9 @@
 
 _FORMAT_ALIASES = {
     "yaml": "yaml",
-    "yml": "yaml",
     "json": "json",
     "txt": "txt",
-    "text": "txt",
     "md": "md",
-    "markdown": "md",
 }
 
 PLACEHOLDER_PATTERNS = [

tests/conftest.py

@@ -70,9 +70,7 @@ def _verify_no_garbage_in_context(context: dict) -> None:
 PROJECT_ROOT = Path(__file__).parent.parent
 SRC_DIR = PROJECT_ROOT / "src"
 
-# Constants for ignore file names
 GITIGNORE = ".gitignore"
-TREEMAPPERIGNORE = ".treemapperignore"
 
 # WSL detection with proper file handle cleanup (shared across test files)
 _PROC_VERSION = Path("/proc/version")
@@ -94,7 +92,9 @@ def temp_project(tmp_path):
     (temp_dir / ".git").mkdir()
     (temp_dir / ".git" / "config").write_text("git config file", encoding="utf-8")
     (temp_dir / GITIGNORE).write_text("*.pyc\n__pycache__/\n", encoding="utf-8")
-    (temp_dir / TREEMAPPERIGNORE).write_text("output/\n.git/\n", encoding="utf-8")
+    config_dir = temp_dir / ".treemapper"
+    config_dir.mkdir()
+    (config_dir / "ignore").write_text("output/\n.git/\n", encoding="utf-8")
     yield temp_dir
 
 
@@ -241,8 +241,10 @@ def add_gitignore(self, patterns: list[str], subdir: str = "") -> Path:
             path.write_text("\n".join(patterns) + "\n", encoding="utf-8")
             return path
 
-        def add_treemapperignore(self, patterns: list[str]) -> Path:
-            path = self.root / TREEMAPPERIGNORE
+        def add_treemapper_ignore(self, patterns: list[str]) -> Path:
+            config_dir = self.root / ".treemapper"
+            config_dir.mkdir(exist_ok=True)
+            path = config_dir / "ignore"
             path.write_text("\n".join(patterns) + "\n", encoding="utf-8")
             return path
 

tests/test_basic.py

@@ -23,7 +23,7 @@ def test_basic_mapping(temp_project, run_mapper):
     assert "main.py" in all_files
     assert "test.py" in all_files
     assert "docs" in all_files
-    assert ".git" not in all_files, ".git should be ignored by default .treemapperignore"
+    assert ".git" not in all_files, ".git should be ignored by default .treemapper/ignore"
     assert "output" not in all_files
     assert "directory_tree.yaml" not in all_files
 

tests/test_coverage_gaps.py

@@ -46,7 +46,9 @@ def test_map_directory_with_no_default_ignores_param(tmp_path):
     (project / "__pycache__" / "module.pyc").write_text("bytecode")
     (project / "regular.txt").write_text("content")
     (project / ".gitignore").write_text("*.pyc\n")
-    (project / ".treemapperignore").write_text(".git/\n__pycache__/\n")
+    config_dir = project / ".treemapper"
+    config_dir.mkdir()
+    (config_dir / "ignore").write_text(".git/\n__pycache__/\n")
 
     tree_with_defaults = map_directory(project)
     names_with_defaults = get_all_files_in_tree(tree_with_defaults)
@@ -73,7 +75,9 @@ def test_no_default_ignores_still_respects_custom_ignore(tmp_path):
     (project / "keep.txt").write_text("keep this")
     (project / "ignore_me.log").write_text("should be ignored")
     (project / ".gitignore").write_text("*.pyc\n")
-    (project / ".treemapperignore").write_text(".git/\n__pycache__/\n")
+    config_dir2 = project / ".treemapper"
+    config_dir2.mkdir()
+    (config_dir2 / "ignore").write_text(".git/\n__pycache__/\n")
 
     custom_ignore = tmp_path / "custom.ignore"
     custom_ignore.write_text("*.log\n")

tests/test_ignore.py

@@ -71,7 +71,9 @@ def test_symlinks_and_special_files(temp_project, run_mapper):
             logging.warning(f"Could not create symlink: {e}, skipping symlink part.")
             can_symlink = False
 
-    (temp_project / ".treemapperignore").write_text(".*\n!.gitignore\n")
+    config_dir = temp_project / ".treemapper"
+    config_dir.mkdir(exist_ok=True)
+    (config_dir / "ignore").write_text(".*\n!.gitignore\n")
     assert run_mapper([".", "-o", "directory_tree.yaml"])
     result = load_yaml(temp_project / "directory_tree.yaml")
     all_files = get_all_files_in_tree(result)
@@ -85,7 +87,9 @@ def test_symlinks_and_special_files(temp_project, run_mapper):
 
 def test_empty_and_invalid_ignores(temp_project, run_mapper):
     (temp_project / ".gitignore").write_text("")
-    (temp_project / ".treemapperignore").write_text("\n\n# Just comments\n\n")
+    config_dir = temp_project / ".treemapper"
+    config_dir.mkdir(exist_ok=True)
+    (config_dir / "ignore").write_text("\n\n# Just comments\n\n")
     (temp_project / "empty.ignore").write_text("")
     (temp_project / "invalid.ignore").write_text("[\ninvalid\npattern\n")
     assert run_mapper([".", "-o", "out_empty.yaml"])
@@ -204,7 +208,7 @@ def test_no_default_ignores_flag(temp_project, run_mapper):
     assert "treemapper_ignored" in all_files, "'treemapper_ignored/' should NOT be ignored with --no-default-ignores"
     assert "file.txt" in all_files
     assert ".gitignore" in all_files
-    assert ".treemapperignore" in all_files
+    assert ".treemapper" in all_files
     assert treemapper_ignore.name in all_files
     assert custom_ignore.name in all_files
     assert (
@@ -217,7 +221,8 @@ def test_no_default_ignores_flag(temp_project, run_mapper):
     reason="os.chmod limited on Windows/WSL",
 )
 def test_unreadable_ignore_file(temp_project, run_mapper, set_perms, caplog):
-    ignore_file = temp_project / ".treemapperignore"
+    config_dir = temp_project / ".treemapper"
+    ignore_file = config_dir / "ignore"
     ignore_file.write_text(".git/\n")
     set_perms(ignore_file, 0o000)
 
@@ -232,7 +237,8 @@ def test_unreadable_ignore_file(temp_project, run_mapper, set_perms, caplog):
 
 
 def test_bad_encoding_ignore_file(temp_project, run_mapper, caplog):
-    ignore_file = temp_project / ".treemapperignore"
+    config_dir = temp_project / ".treemapper"
+    ignore_file = config_dir / "ignore"
     try:
         # Cyrillic text intentional for CP1251 encoding test
         ignore_file.write_text(".git/\nпапка_игнор/\n", encoding="cp1251")  # noqa: RUF001
@@ -280,7 +286,9 @@ def test_ignore_precedence_subdir_over_root(temp_project, run_mapper):
 
 def test_ignore_precedence_treemapper_over_git(temp_project, run_mapper):
     (temp_project / ".gitignore").write_text("*.pyc\n")
-    (temp_project / ".treemapperignore").write_text("*.log\n.git/\n")
+    config_dir = temp_project / ".treemapper"
+    config_dir.mkdir(exist_ok=True)
+    (config_dir / "ignore").write_text("*.log\n.git/\n")
     (temp_project / "file.pyc").touch()
     (temp_project / "file.log").touch()
     (temp_project / "file.txt").touch()
@@ -296,7 +304,9 @@ def test_ignore_precedence_treemapper_over_git(temp_project, run_mapper):
 
 def test_ignore_precedence_custom_over_defaults(temp_project, run_mapper):
     (temp_project / ".gitignore").write_text("*.pyc\n")
-    (temp_project / ".treemapperignore").write_text("*.log\n.git/\n")
+    config_dir = temp_project / ".treemapper"
+    config_dir.mkdir(exist_ok=True)
+    (config_dir / "ignore").write_text("*.log\n.git/\n")
     custom_ignore = temp_project / "custom.ignore"
     custom_ignore.write_text("*.tmp\n")
 
@@ -422,12 +432,16 @@ def test_combined_patterns(temp_project, run_mapper):
     assert find_node_by_path(result, ["subdir", "regular.txt"]) is not None
 
 
-def test_hierarchical_treemapperignore(temp_project, run_mapper):
+def test_hierarchical_dir_ignore(temp_project, run_mapper):
     from .utils import find_node_by_path
 
-    (temp_project / ".treemapperignore").write_text("*.tmp\n")
+    config_dir = temp_project / ".treemapper"
+    config_dir.mkdir(exist_ok=True)
+    (config_dir / "ignore").write_text("*.tmp\n")
     (temp_project / "subdir").mkdir()
-    (temp_project / "subdir" / ".treemapperignore").write_text("*.bak\n!important.bak\n")
+    sub_config = temp_project / "subdir" / ".treemapper"
+    sub_config.mkdir()
+    (sub_config / "ignore").write_text("*.bak\n!important.bak\n")
     (temp_project / "root.tmp").touch()
     (temp_project / "root.bak").touch()
     (temp_project / "subdir" / "nested.tmp").touch()
@@ -486,7 +500,9 @@ def test_parent_ignore_integration(tmp_path, run_mapper):
     subdir = parent / "packages" / "app"
     subdir.mkdir(parents=True)
 
-    (parent / ".treemapperignore").write_text("packages/app/ignored_dir/\npackages/app/data/\n")
+    parent_config = parent / ".treemapper"
+    parent_config.mkdir()
+    (parent_config / "ignore").write_text("packages/app/ignored_dir/\npackages/app/data/\n")
     (subdir / "ignored_dir").mkdir()
     (subdir / "ignored_dir" / "secret.txt").write_text("secret")
     (subdir / "data").mkdir()
@@ -511,12 +527,16 @@ def test_parent_ignore_stops_at_git_root(tmp_path, run_mapper):
 
     grandparent = tmp_path / "grandparent"
     grandparent.mkdir()
-    (grandparent / ".treemapperignore").write_text("packages/app/beyond_git_root/\n")
+    grandparent_config = grandparent / ".treemapper"
+    grandparent_config.mkdir()
+    (grandparent_config / "ignore").write_text("packages/app/beyond_git_root/\n")
 
     parent = grandparent / "parent"
     parent.mkdir()
     (parent / ".git").mkdir()
-    (parent / ".treemapperignore").write_text("packages/app/from_parent/\n")
+    parent_config = parent / ".treemapper"
+    parent_config.mkdir()
+    (parent_config / "ignore").write_text("packages/app/from_parent/\n")
 
     child = parent / "packages" / "app"
     child.mkdir(parents=True)
@@ -557,26 +577,6 @@ def test_treemapper_dir_ignore(temp_project, run_mapper):
     assert find_node_by_path(result, ["keep.txt"]) is not None
 
 
-def test_treemapper_dir_ignore_combined_with_legacy(temp_project, run_mapper):
-    from .utils import find_node_by_path
-
-    (temp_project / ".treemapperignore").write_text("*.tmp\n")
-    config_dir = temp_project / ".treemapper"
-    config_dir.mkdir(exist_ok=True)
-    (config_dir / "ignore").write_text("*.bak\n")
-    (temp_project / "file.tmp").touch()
-    (temp_project / "file.bak").touch()
-    (temp_project / "file.txt").touch()
-
-    output_path = temp_project / "combined_dir_output.yaml"
-    assert run_mapper([".", "-o", str(output_path)])
-    result = load_yaml(output_path)
-
-    assert find_node_by_path(result, ["file.tmp"]) is None
-    assert find_node_by_path(result, ["file.bak"]) is None
-    assert find_node_by_path(result, ["file.txt"]) is not None
-
-
 def test_treemapper_dir_ignore_hierarchical(temp_project, run_mapper):
     from .utils import find_node_by_path
 
@@ -654,18 +654,3 @@ def test_treemapper_dir_hidden_from_output(temp_project, run_mapper):
     assert ".treemapper" not in all_files
     assert "ignore" not in all_files
     assert "whitelist" not in all_files
-
-
-def test_treemapper_dir_whitelist_over_legacy(temp_project, run_mapper):
-    (temp_project / ".treemapperwhitelist").write_text("docs/**\n")
-    config_dir = temp_project / ".treemapper"
-    config_dir.mkdir(exist_ok=True)
-    (config_dir / "whitelist").write_text("src/**/*.py\n")
-
-    output_path = temp_project / "wl_precedence_output.yaml"
-    assert run_mapper([".", "-o", str(output_path)])
-    result = load_yaml(output_path)
-    all_files = get_all_files_in_tree(result)
-
-    assert "main.py" in all_files
-    assert "readme.md" not in all_files