feat(cli): keep codeanalyzer as a deprecated alias for canpy

Re-add the `codeanalyzer` console script for backwards compatibility. It points
to a thin shim that prints a one-line deprecation notice to stderr (so piped
stdout — e.g. `--emit schema`) stays clean) and then runs the CLI unchanged.
To be removed in a future release.

Author: rahlk

CHANGELOG.md

@@ -20,7 +20,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **`schema-uml.drawio`** — a clean UML of the `analysis.json` schema (the `PyApplication` containment tree).
 
 ### Changed
-- **The CLI command is now `canpy`** (was `codeanalyzer`), matching the `cants` (TypeScript) sibling. The PyPI package name is unchanged (`codeanalyzer-python`), as is the importable `codeanalyzer` module.
+- **The CLI command is now `canpy`** (was `codeanalyzer`), matching the `cants` (TypeScript) sibling. The PyPI package name is unchanged (`codeanalyzer-python`), as is the importable `codeanalyzer` module. The old `codeanalyzer` command is retained as a **deprecated alias** that prints a notice (to stderr) and then runs unchanged; it will be removed in a future release.
 - The README `canpy --help` block is now generated from the live CLI (`scripts/update_readme.py`, between `<!-- BEGIN/END canpy-help -->` markers) so it can't drift from the code.
 - The release workflow now installs the `[neo4j]` extra, syncs both the README `--help` block and `schema.neo4j.json` from source before publishing, and uploads the schema contract (`schema.json`) and installer script as GitHub Release assets.
 

codeanalyzer/__main__.py

@@ -229,5 +229,20 @@ def _write_output(artifacts, output_dir: Path, format: OutputFormat):
     pretty_exceptions_show_locals=False,
 )
 
+def deprecated_main() -> None:
+    """Entry point for the legacy ``codeanalyzer`` command. Prints a one-line
+    deprecation notice to stderr (so piped stdout — e.g. ``--emit schema`` — stays
+    clean) and then runs the CLI unchanged. Kept for backwards compatibility; will
+    be removed in a future release."""
+    import sys
+
+    print(
+        "codeanalyzer: this command has been renamed to `canpy`. The `codeanalyzer` "
+        "alias is deprecated and will be removed in a future release — please use `canpy`.",
+        file=sys.stderr,
+    )
+    app()
+
+
 if __name__ == "__main__":
     app()

pyproject.toml

@@ -69,6 +69,8 @@ dev = [
 
 [project.scripts]
 canpy = "codeanalyzer.__main__:app"
+# Deprecated alias kept for backwards compatibility — warns, then delegates to canpy.
+codeanalyzer = "codeanalyzer.__main__:deprecated_main"
 
 [build-system]
 requires = ["hatchling"]