rename-refs

# Rename Refs Renames a Python symbol or module atomically. Coverage: - Definition site (`def`/`class` line) - `__all__` re-exports in `__init__.py` files - Import call sites across all callers (`fn-rdeps` + symbol line-range narrowing) - Sphinx docstring cross-refs across `.py` and `.rst` - Optional `@deprecated` alias via pyDeprecate (`--deprecate`; requires `pyDeprecate` installed) - Optional hard-delete when the caller graph is exhaustive and callers = 0 **Subcommands**: - `symbol <old_qname> <new_qname>` — function, class, or method. qname = bare (`MyClass`), qualified (`MyClass.method`), or full (`mypackage.auth::validate_token`) - `module <old_module_path> <new_module_path>` — dotted path (`mypackage.old_name`). Renames the file and every import line. **Flags**: - `--dry-run` — print sites that would change; no edits - `--deprecate[=<decorator>]` — symbol only: keep the old name as a pyDeprecate `@deprecated` wrapper → new name; requires `pyDeprecate` - `--since <ver>` / `--removed-in <ver>` — passed to the deprecation decorator; default `"?"` - `--remove-if-no-callers` — symbol only: delete the definition when the caller graph is exhaustive and callers = 0 `--deprecate` and `--remove-if-no-callers` are incompatible (one aliases, the other deletes) — reject the combination before doing any analysis. **Hard limits** (static-analysis boundary — not fixable): - `getattr(obj, "old_name")` — string not statically bound; emit a search advisory in the final sum...