feat(diffctx): restore domain stopwords, add JS forward import discovery

Restore ~550 domain-specific stopwords (React hooks, IaC terms, OOP
keywords, SQL, networking, etc.) that were removed in the stopwords
rewrite. Add forward import resolution to JS/TS edge builder so
changed files discover their own import targets, not just importers.

Raises quality floor from 83% to 87% (avg 87.2%, 524 perfect).

Author: nikolay-e

.gitignore

@@ -405,3 +405,6 @@ benchmarks/results/
 *.prof
 *.lprof
 profile_*.txt
+
+# Quality score tracking
+.scores/

.gitleaks.toml

@@ -16,4 +16,6 @@ paths = [
     '''tests/cases/diff/fragments/fragments_020_config_json_top_level_keys\.yaml''',
     '''tests/cases/diff/helm/helm_025_template_secret\.yaml''',
     '''tests/cases/diff/kubernetes/kubernetes_002_replicas_change\.yaml''',
+    '''tests/cases/diff/kubernetes/kubernetes_026_ingress_rules\.yaml''',
+    '''tests/cases/diff/kubernetes/kubernetes_027_ingress_tls\.yaml''',
 ]

.pre-commit-config.yaml

@@ -164,16 +164,6 @@ repos:
           ]
         files: ^src/
 
-  # ============================================================================
-  # SPELL CHECKING
-  # ============================================================================
-  - repo: https://github.com/codespell-project/codespell
-    rev: v2.4.1
-    hooks:
-      - id: codespell
-        args: ["--write-changes", "--ignore-words-list=crate,nd,ser,llm,async,cli,theses,datas,hel,afterall,aftereach"]
-        exclude: ^(\.git/|\.venv/|venv/)
-
   # ============================================================================
   # YAML LINTING
   # ============================================================================

.treemapper/review-ux.whitelist

@@ -0,0 +1,12 @@
+# UX / Usability Review
+# CLI interface, output formatting, user feedback, error handling
+
+src/treemapper/cli.py
+src/treemapper/writer.py
+src/treemapper/logger.py
+src/treemapper/clipboard.py
+src/treemapper/tokens.py
+src/treemapper/version.py
+src/treemapper/diffctx/render.py
+src/treemapper/__init__.py
+README.md

PAPER_DEVIATIONS.md

@@ -0,0 +1,43 @@
+# Deviations from Paper
+
+This document tracks implementation deviations from the research
+paper [Context-Selection for Git Diff](https://nikolay-eremeev.com/blog/context-selection-git-diff/).
+
+## 1. Caller Importance Weighting for Impact Needs
+
+**Paper reference:** Section 4.2.1 (Impact need scoring)
+
+**Problem:** The paper's `m(f, n)` assigns a flat 0.8 to any
+fragment that mentions a symbol for `impact` needs. This cannot
+distinguish production callers (`handler.ts`) from peripheral
+code (`examples/parsing.ts`) — both receive identical scores.
+
+**Extension:** For impact needs only, the match strength is
+scaled by a file importance factor:
+
+```text
+m'(f, n) = m(f, n) * I(f)    where n.type == "impact"
+```
+
+`I(f)` is computed from three layers:
+
+| Layer | Signal | Importance |
+|-------|--------|------------|
+| Path patterns | `examples/`, `demo/`, `vendor/`, etc. | 0.15 |
+| Generated code | `generated/`, `__generated__/` paths | 0.10 |
+| Script dirs | `scripts/`, `tools/`, `bin/` | 0.40 |
+| Graph topology | Leaf node (in=0, out>0) | 0.25 |
+| Graph topology | Isolated (in=0, out=0) | 0.50 |
+| Graph topology | Production (in>0) | min(1.0, 0.7 + 0.1*in) |
+
+Path-based layers take priority over graph topology.
+
+**Submodularity preservation:** Since `I(f) in [0, 1]` is a
+constant per-fragment multiplier, `m'(f, n) <= m(f, n)`. The
+augmented score `a(f, n) = m'(f, n) + eta * R(f)` remains
+monotone submodular — scaling a nonneg input to `phi(max(...))` by
+a constant in [0, 1] preserves concavity of the max-of-concave
+composition.
+
+**Scope:** Only impact needs are affected. Definition, signature,
+test, invariant, and background needs use unmodified `m(f, n)`.

src/treemapper/__init__.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import io
+import logging
 from pathlib import Path
 from typing import Any
 
@@ -10,19 +11,35 @@
 from .version import __version__
 from .writer import write_tree_json, write_tree_markdown, write_tree_text, write_tree_yaml
 
+logging.getLogger("treemapper").addHandler(logging.NullHandler())
+
 __all__ = [
     "__version__",
     "build_diff_context",
     "map_directory",
     "to_json",
     "to_markdown",
-    "to_md",
     "to_text",
-    "to_txt",
     "to_yaml",
 ]
 
 
+def _root_display_name(user_path: str | Path, resolved: Path) -> str:
+    original_name = Path(user_path).name
+    if original_name:
+        return original_name
+    return str(resolved)
+
+
+def _resolve_path_if_exists(path: str | Path | None, label: str) -> Path | None:
+    if path is None:
+        return None
+    resolved = Path(path).resolve()
+    if not resolved.is_file():
+        raise FileNotFoundError(f"{label} '{path}' does not exist")
+    return resolved
+
+
 def map_directory(
     path: str | Path,
     *,
@@ -37,8 +54,8 @@ def map_directory(
     if not root_dir.is_dir():
         raise ValueError(f"'{path}' is not a directory")
 
-    ignore_path = Path(ignore_file).resolve() if ignore_file else None
-    whitelist_path = Path(whitelist_file).resolve() if whitelist_file else None
+    ignore_path = _resolve_path_if_exists(ignore_file, "Ignore file")
+    whitelist_path = _resolve_path_if_exists(whitelist_file, "Whitelist file")
 
     ctx = TreeBuildContext(
         base_dir=root_dir,
@@ -51,7 +68,7 @@ def map_directory(
     )
 
     return {
-        "name": root_dir.name,
+        "name": _root_display_name(path, root_dir),
         "type": "directory",
         "children": build_tree(root_dir, ctx),
     }