lib-cli-exit-tools 2.2.2__tar.gz → 2.2.3__tar.gz

{lib_cli_exit_tools-2.2.2 → lib_cli_exit_tools-2.2.3}/.github/workflows/ci.yml

@@ -83,14 +83,14 @@ jobs:
         run: |
           uv pip install pywin32 --system
       - name: Cache ruff
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: .ruff_cache
           key: ruff-${{ runner.os }}-${{ github.sha }}
           restore-keys: |
             ruff-${{ runner.os }}-
       - name: Cache pyright
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: .pyright
           key: pyright-${{ runner.os }}-py${{ matrix.python }}-${{ github.sha }}

{lib_cli_exit_tools-2.2.2 → lib_cli_exit_tools-2.2.3}/.github/workflows/release.yml

@@ -44,7 +44,7 @@ jobs:
           attestations: false
           skip-existing: true
       - name: Upload artifacts
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: dist
           path: dist/*

{lib_cli_exit_tools-2.2.2 → lib_cli_exit_tools-2.2.3}/CHANGELOG.md

@@ -3,6 +3,23 @@
 All notable changes to this project are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [2.2.3] - 2025-12-17
+
+### Fixed
+- Corrected README examples to use `rich_click` instead of plain `click` for consistency with library internals.
+- Fixed Example 2 (cli_session) to avoid nested `run_cli` calls.
+- Fixed Example 3 (multi-command CLI) so `--traceback` flag actually controls traceback display.
+- Added missing blank line in Example 4 (custom signal handlers).
+- Updated `print_exception_message` API reference signature to show `trace_back=None` default.
+
+### Changed
+- Updated CLAUDE.md with correct `docs/system-design/` path and added missing `python_data_architecture_enforcement.md` guideline.
+- Removed irrelevant Documentation & Translations section from CLAUDE.md.
+- Updated INSTALL.md to list all three console script entry points consistently.
+
+### Security
+- Added filelock CVE-2025-68146 to pip-audit ignore list (transitive dev dependency, fix pending upstream).
+
 ## [2.2.2] - 2025-12-12
 
 ### Changed

lib_cli_exit_tools-2.2.3/CLAUDE.md

@@ -0,0 +1,164 @@
+# Claude Code Guidelines for lib_cli_exit_tools
+
+## Session Initialization
+
+When starting a new session, read and apply the following system prompt files from `/media/srv-main-softdev/projects/softwarestack/systemprompts`:
+
+### Core Guidelines (Always Apply)
+- `core_programming_solid.md`
+
+### Bash-Specific Guidelines
+When working with Bash scripts:
+- `core_programming_solid.md`
+- `bash_clean_architecture.md`
+- `bash_clean_code.md`
+- `bash_small_functions.md`
+
+### Python-Specific Guidelines
+When working with Python code:
+- `core_programming_solid.md`
+- `python_solid_architecture_enforcer.md`
+- `python_clean_architecture.md`
+- `python_clean_code.md`
+- `python_small_functions_style.md`
+- `python_libraries_to_use.md`
+- `python_data_architecture_enforcement.md`
+
+### Additional Guidelines
+- `self_documenting.md`
+- `self_documenting_template.md`
+- `python_jupyter_notebooks.md`
+- `python_testing.md`
+
+## Project Structure
+
+```
+lib_cli_exit_tools/
+├── .github/
+│   └── workflows/              # GitHub Actions CI/CD workflows
+├── .devcontainer/              # Dev container configuration
+├── docs/                       # Project documentation
+│   └── system-design/          # System design documents
+├── notebooks/                  # Jupyter notebooks for experiments
+├── scripts/                    # Build and automation scripts
+│   ├── __init__.py            # Package marker
+│   ├── __main__.py            # Module entry point
+│   ├── _utils.py              # Shared utilities
+│   ├── build.py               # Build wheel/sdist
+│   ├── bump.py                # Version bump (generic)
+│   ├── bump_major.py          # Bump major version
+│   ├── bump_minor.py          # Bump minor version
+│   ├── bump_patch.py          # Bump patch version
+│   ├── bump_version.py        # Version bump utilities
+│   ├── clean.py               # Clean build artifacts
+│   ├── cli.py                 # CLI for scripts
+│   ├── dependencies.py        # Dependency management
+│   ├── dev.py                 # Development install
+│   ├── help.py                # Show help
+│   ├── install.py             # Install package
+│   ├── menu.py                # Interactive TUI menu
+│   ├── push.py                # Git push
+│   ├── release.py             # Create releases
+│   ├── run_cli.py             # Run CLI
+│   ├── target_metadata.py     # Metadata generation
+│   ├── test.py                # Run tests with coverage
+│   ├── toml_config.py         # TOML configuration utilities
+│   └── version_current.py     # Print current version
+├── src/
+│   └── lib_cli_exit_tools/    # Main Python package
+│       ├── __init__.py        # Package initialization
+│       ├── __init__conf__.py  # Configuration constants
+│       ├── __main__.py        # CLI entry point
+│       ├── cli.py             # CLI implementation
+│       ├── lib_cli_exit_tools.py  # Core library functions
+│       ├── py.typed           # PEP 561 marker
+│       ├── adapters/          # Adapter layer
+│       │   └── signals.py     # Signal handling adapters
+│       ├── application/       # Application layer
+│       │   └── runner.py      # Application runner
+│       └── core/              # Core domain layer
+│           ├── configuration.py  # Configuration management
+│           └── exit_codes.py     # Exit code definitions
+├── tests/                     # Test suite
+├── .env.example               # Example environment variables
+├── CLAUDE.md                  # Claude Code guidelines (this file)
+├── CHANGELOG.md               # Version history
+├── CONTRIBUTING.md            # Contribution guidelines
+├── DEVELOPMENT.md             # Development setup guide
+├── INSTALL.md                 # Installation instructions
+├── LICENSE                    # MIT License
+├── Makefile                   # Make targets for common tasks
+├── pyproject.toml             # Project metadata & dependencies
+├── codecov.yml                # Codecov configuration
+└── README.md                  # Project overview
+```
+
+## Versioning & Releases
+
+- **Single Source of Truth**: Package version is in `pyproject.toml` (`[project].version`)
+- **Version Bumps**: update `pyproject.toml`, `CHANGELOG.md` and update the constants in `src/lib_cli_exit_tools/__init__conf__.py` according to `pyproject.toml`
+    - Automation rewrites `src/lib_cli_exit_tools/__init__conf__.py` from `pyproject.toml`, so runtime code imports generated constants instead of querying `importlib.metadata`.
+    - After updating project metadata (version, summary, URLs, authors) run `make test` (or `python -m scripts.test`) to regenerate the metadata module before committing.
+- **Release Tags**: Format is `vX.Y.Z` (push tags for CI to build and publish)
+
+## Common Make Targets
+
+| Target            | Description                                                                     |
+|-------------------|---------------------------------------------------------------------------------|
+| `build`           | Build wheel/sdist artifacts                                                     |
+| `bump`            | Bump version (VERSION=X.Y.Z or PART=major\|minor\|patch) and update changelog  |
+| `bump-major`      | Increment major version ((X+1).0.0)                                            |
+| `bump-minor`      | Increment minor version (X.Y.Z → X.(Y+1).0)                                    |
+| `bump-patch`      | Increment patch version (X.Y.Z → X.Y.(Z+1))                                    |
+| `clean`           | Remove caches, coverage, and build artifacts (includes `dist/` and `build/`)   |
+| `dev`             | Install package with dev extras                                                |
+| `help`            | Show make targets                                                              |
+| `install`         | Editable install                                                               |
+| `menu`            | Interactive TUI menu                                                           |
+| `push`            | Commit changes and push to GitHub (no CI monitoring)                           |
+| `release`         | Tag vX.Y.Z, push, sync packaging, run gh release if available                  |
+| `run`             | Run module entry (`python -m ... --help`)                                      |
+| `test`            | Lint, format, type-check, run tests with coverage, upload to Codecov           |
+| `version-current` | Print current version from `pyproject.toml`                                    |
+
+## Coding Style & Naming Conventions
+
+Follow the guidelines in `python_clean_code.md` for all Python code.
+
+## Architecture Overview
+
+This library follows Clean Architecture with three layers:
+- **core/**: Domain layer with exit codes and configuration (no external dependencies)
+- **application/**: Application services and runners
+- **adapters/**: External interfaces (signal handling)
+
+Import rules (enforced by import-linter):
+- `core` cannot import from `application`, `adapters`, or `cli`
+- `application` cannot import from `cli`
+
+Apply principles from `python_clean_architecture.md` when designing and implementing features.
+
+## Security & Configuration
+
+- `.env` files are for local tooling only (CodeCov tokens, etc.)
+- **NEVER** commit secrets to version control
+- Rich logging should sanitize payloads before rendering
+
+## Commit & Push Policy
+
+### Pre-Push Requirements
+- **Always run `make test` before pushing** to avoid lint/test breakage
+- Ensure all tests pass and code is properly formatted
+
+### Post-Push Monitoring
+- Monitor GitHub Actions for errors after pushing
+- Attempt to correct any CI/CD errors that appear
+
+## Claude Code Workflow
+
+When working on this project:
+1. Read relevant system prompts at session start
+2. Apply appropriate coding guidelines based on file type
+3. Run `make test` before commits
+4. Follow versioning guidelines for releases
+5. Monitor CI after pushing changes

{lib_cli_exit_tools-2.2.2 → lib_cli_exit_tools-2.2.3}/INSTALL.md

@@ -126,8 +126,9 @@ We distribute via PyPI only. If you prefer isolated CLI installs, use tools such
 
 After installation the following commands should resolve:
 
-- `lib_cli_exit_tools`
-- `cli-exit-tools`
+- `lib-cli-exit-tools` (default console script)
+- `lib_cli_exit_tools` (alias)
+- `cli-exit-tools` (alias)
 - `python -m lib_cli_exit_tools`
 
 If you installed inside a virtual environment, activate it before running the commands. For user installs, ensure the relevant `bin`/`Scripts` directory is included in your PATH:

{lib_cli_exit_tools-2.2.2 → lib_cli_exit_tools-2.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lib_cli_exit_tools
-Version: 2.2.2
+Version: 2.2.3
 Summary: CLI exit handling helpers: clean signals, exit codes, and error printing
 Project-URL: Homepage, https://github.com/bitranox/lib_cli_exit_tools
 Project-URL: Repository, https://github.com/bitranox/lib_cli_exit_tools.git
@@ -31,7 +31,7 @@ Requires-Dist: pytest-cov>=7.0.0; extra == 'dev'
 Requires-Dist: pytest>=9.0.2; extra == 'dev'
 Requires-Dist: rtoml>=0.13.0; extra == 'dev'
 Requires-Dist: ruff>=0.14.9; extra == 'dev'
-Requires-Dist: textual>=6.8.0; extra == 'dev'
+Requires-Dist: textual>=6.10.0; extra == 'dev'
 Requires-Dist: twine>=6.2.0; extra == 'dev'
 Description-Content-Type: text/markdown
 
@@ -130,7 +130,7 @@ CLI that demonstrates configuration hooks and structured error handling.
 ```python
 from __future__ import annotations
 
-import click
+import rich_click as click
 
 from lib_cli_exit_tools import run_cli
 
@@ -138,7 +138,6 @@ from lib_cli_exit_tools import run_cli
 @click.command()
 def hello() -> None:
     """Say hello with automatic signal-aware exit handling."""
-
     click.echo("Hello from lib_cli_exit_tools!")
 
 
@@ -157,29 +156,32 @@ python hello.py
 ```python
 from __future__ import annotations
 
-import click
-
-from lib_cli_exit_tools import cli_session, run_cli
-
+import rich_click as click
 
-@click.command()
-@click.option("--traceback", is_flag=True, help="Show full tracebacks on error")
-def cli(traceback: bool) -> int:
-    with cli_session(overrides={"traceback": traceback}) as execute:
-        return execute(failable, argv=[])
+from lib_cli_exit_tools import cli_session
 
 
 @click.command()
 def failable() -> None:
+    """Command that always fails to demonstrate traceback handling."""
     raise RuntimeError("toggle --traceback to see the full traceback")
 
 
+def main(*, traceback: bool = False) -> int:
+    """Run failable with optional traceback display."""
+    with cli_session(overrides={"traceback": traceback}) as run:
+        return run(failable)
+
+
 if __name__ == "__main__":
-    raise SystemExit(run_cli(cli))
+    import sys
+
+    enable_traceback = "--traceback" in sys.argv
+    raise SystemExit(main(traceback=enable_traceback))
 ```
 
-Invoking `python cli.py --traceback` enables coloured tracebacks just for that
-run and resets the configuration afterwards.
+Running `python cli.py --traceback` enables coloured tracebacks for that
+session. The `cli_session` context manager restores configuration afterwards.
 
 #### 3. Full-featured multi-command CLI
 
@@ -187,9 +189,10 @@ run and resets the configuration afterwards.
 from __future__ import annotations
 
 import json
+import sys
 from dataclasses import dataclass
 
-import click
+import rich_click as click
 
 from lib_cli_exit_tools import SignalSpec, cli_session, default_signal_specs
 
@@ -197,21 +200,19 @@ from lib_cli_exit_tools import SignalSpec, cli_session, default_signal_specs
 @dataclass(slots=True)
 class Settings:
     pretty: bool
-    traceback: bool
 
 
 @click.group()
 @click.option("--pretty/--no-pretty", default=True)
-@click.option("--traceback", is_flag=True, help="Show full tracebacks on error")
 @click.pass_context
-def cli(ctx: click.Context, pretty: bool, traceback: bool) -> None:
-    ctx.obj = Settings(pretty=pretty, traceback=traceback)
+def cli(ctx: click.Context, pretty: bool) -> None:
+    ctx.obj = Settings(pretty=pretty)
 
 
 @cli.command()
 @click.pass_obj
 def info(settings: Settings) -> None:
-    payload = {"traceback": settings.traceback, "pretty": settings.pretty}
+    payload = {"pretty": settings.pretty}
     click.echo(json.dumps(payload, indent=2 if settings.pretty else None))
 
 
@@ -223,20 +224,24 @@ def fail(settings: Settings) -> None:
 
 
 def main() -> int:
-    overrides = {"traceback": True, "traceback_force_color": True}
+    # Parse --traceback early before entering cli_session
+    traceback = "--traceback" in sys.argv
+    argv = [arg for arg in sys.argv[1:] if arg != "--traceback"]
+
+    overrides = {"traceback": traceback, "traceback_force_color": traceback}
     signals: list[SignalSpec] = default_signal_specs()
     with cli_session(overrides=overrides) as execute:
-        return execute(cli, signal_specs=signals)
+        return execute(cli, argv=argv, signal_specs=signals)
 
 
 if __name__ == "__main__":
     raise SystemExit(main())
 ```
 
-This version wires configuration overrides, custom signal specs, and multiple
-commands into a single composition point—mirroring how a production CLI can
-layer policy logic around Click while still delegating exit-code translation to
-`lib_cli_exit_tools`.
+This version parses `--traceback` early (before Click sees it), then wires
+configuration overrides, custom signal specs, and multiple commands into a
+single composition point—mirroring how a production CLI can layer policy logic
+around Click while still delegating exit-code translation to `lib_cli_exit_tools`.
 
 #### 4. Custom signal handlers
 
@@ -251,7 +256,7 @@ import signal
 from contextlib import ExitStack
 from typing import Callable
 
-import click
+import rich_click as click
 
 from lib_cli_exit_tools import SignalSpec, default_signal_specs, run_cli
 
@@ -271,6 +276,8 @@ def custom_signal_specs() -> list[SignalSpec]:
             )
         )
     return specs
+
+
 def install_custom_signals(specs: list[SignalSpec] | None) -> Callable[[], None]:
     stack = ExitStack()
 
@@ -478,11 +485,11 @@ Compute a platform-aware exit status for arbitrary exceptions (errno mappings on
 Parameters:
 - `exc`: Exception instance to classify.
 
-### `print_exception_message(trace_back=config.traceback, length_limit=500, stream=None) -> None`
+### `print_exception_message(trace_back=None, length_limit=500, stream=None) -> None`
 Emit the active exception using Rich formatting. Produces a coloured traceback when `trace_back` is `True`, otherwise prints a truncated summary in red. Respects `config.traceback_force_color` and mirrors the behaviour of `handle_cli_exception` (tracebacks are rendered before the helper returns an exit status).
 
 Parameters:
-- `trace_back`: Toggle between full traceback rendering (`True`) and short summary (`False`).
+- `trace_back`: Toggle between full traceback rendering (`True`) and short summary (`False`). When `None` (default), uses `config.traceback`.
 - `length_limit`: Maximum characters for summary output.
 - `stream`: Target text stream; defaults to `sys.stderr`.
 
@@ -557,7 +564,8 @@ from __future__ import annotations
 
 from typing import Sequence
 
-import click
+import rich_click as click
+
 import lib_cli_exit_tools
 
 from . import __init__conf__
@@ -614,7 +622,7 @@ def main(argv: Sequence[str] | None = None) -> int:
     )
 ```
 
-When installed, the generated console scripts (`lib-cli-exit-tools`, `cli-exit-tools`, `lib_cli_exit_tools`) will import `your_package.cli:main`, and `python -m your_package` will follow the same code path via `__main__.py`.
+When installed, your package's console scripts (defined in `pyproject.toml`) will import `your_package.cli:main`, and `python -m your_package` will follow the same code path via `__main__.py`.
 
 ## Exit Codes
 
@@ -643,5 +651,4 @@ When installed, the generated console scripts (`lib-cli-exit-tools`, `cli-exit-t
 - [CONTRIBUTING](CONTRIBUTING.md)
 - [DEVELOPMENT](DEVELOPMENT.md)
 - [MODULE REFERENCE](docs/system-design/module_reference.md)
-- [AGENTS_README](AGENTS_README.md)
 - [LICENSE](LICENSE)

{lib_cli_exit_tools-2.2.2 → lib_cli_exit_tools-2.2.3}/README.md

@@ -93,7 +93,7 @@ CLI that demonstrates configuration hooks and structured error handling.
 ```python
 from __future__ import annotations
 
-import click
+import rich_click as click
 
 from lib_cli_exit_tools import run_cli
 
@@ -101,7 +101,6 @@ from lib_cli_exit_tools import run_cli
 @click.command()
 def hello() -> None:
     """Say hello with automatic signal-aware exit handling."""
-
     click.echo("Hello from lib_cli_exit_tools!")
 
 
@@ -120,29 +119,32 @@ python hello.py
 ```python
 from __future__ import annotations
 
-import click
-
-from lib_cli_exit_tools import cli_session, run_cli
-
+import rich_click as click
 
-@click.command()
-@click.option("--traceback", is_flag=True, help="Show full tracebacks on error")
-def cli(traceback: bool) -> int:
-    with cli_session(overrides={"traceback": traceback}) as execute:
-        return execute(failable, argv=[])
+from lib_cli_exit_tools import cli_session
 
 
 @click.command()
 def failable() -> None:
+    """Command that always fails to demonstrate traceback handling."""
     raise RuntimeError("toggle --traceback to see the full traceback")
 
 
+def main(*, traceback: bool = False) -> int:
+    """Run failable with optional traceback display."""
+    with cli_session(overrides={"traceback": traceback}) as run:
+        return run(failable)
+
+
 if __name__ == "__main__":
-    raise SystemExit(run_cli(cli))
+    import sys
+
+    enable_traceback = "--traceback" in sys.argv
+    raise SystemExit(main(traceback=enable_traceback))
 ```
 
-Invoking `python cli.py --traceback` enables coloured tracebacks just for that
-run and resets the configuration afterwards.
+Running `python cli.py --traceback` enables coloured tracebacks for that
+session. The `cli_session` context manager restores configuration afterwards.
 
 #### 3. Full-featured multi-command CLI
 
@@ -150,9 +152,10 @@ run and resets the configuration afterwards.
 from __future__ import annotations
 
 import json
+import sys
 from dataclasses import dataclass
 
-import click
+import rich_click as click
 
 from lib_cli_exit_tools import SignalSpec, cli_session, default_signal_specs
 
@@ -160,21 +163,19 @@ from lib_cli_exit_tools import SignalSpec, cli_session, default_signal_specs
 @dataclass(slots=True)
 class Settings:
     pretty: bool
-    traceback: bool
 
 
 @click.group()
 @click.option("--pretty/--no-pretty", default=True)
-@click.option("--traceback", is_flag=True, help="Show full tracebacks on error")
 @click.pass_context
-def cli(ctx: click.Context, pretty: bool, traceback: bool) -> None:
-    ctx.obj = Settings(pretty=pretty, traceback=traceback)
+def cli(ctx: click.Context, pretty: bool) -> None:
+    ctx.obj = Settings(pretty=pretty)
 
 
 @cli.command()
 @click.pass_obj
 def info(settings: Settings) -> None:
-    payload = {"traceback": settings.traceback, "pretty": settings.pretty}
+    payload = {"pretty": settings.pretty}
     click.echo(json.dumps(payload, indent=2 if settings.pretty else None))
 
 
@@ -186,20 +187,24 @@ def fail(settings: Settings) -> None:
 
 
 def main() -> int:
-    overrides = {"traceback": True, "traceback_force_color": True}
+    # Parse --traceback early before entering cli_session
+    traceback = "--traceback" in sys.argv
+    argv = [arg for arg in sys.argv[1:] if arg != "--traceback"]
+
+    overrides = {"traceback": traceback, "traceback_force_color": traceback}
     signals: list[SignalSpec] = default_signal_specs()
     with cli_session(overrides=overrides) as execute:
-        return execute(cli, signal_specs=signals)
+        return execute(cli, argv=argv, signal_specs=signals)
 
 
 if __name__ == "__main__":
     raise SystemExit(main())
 ```
 
-This version wires configuration overrides, custom signal specs, and multiple
-commands into a single composition point—mirroring how a production CLI can
-layer policy logic around Click while still delegating exit-code translation to
-`lib_cli_exit_tools`.
+This version parses `--traceback` early (before Click sees it), then wires
+configuration overrides, custom signal specs, and multiple commands into a
+single composition point—mirroring how a production CLI can layer policy logic
+around Click while still delegating exit-code translation to `lib_cli_exit_tools`.
 
 #### 4. Custom signal handlers
 
@@ -214,7 +219,7 @@ import signal
 from contextlib import ExitStack
 from typing import Callable
 
-import click
+import rich_click as click
 
 from lib_cli_exit_tools import SignalSpec, default_signal_specs, run_cli
 
@@ -234,6 +239,8 @@ def custom_signal_specs() -> list[SignalSpec]:
             )
         )
     return specs
+
+
 def install_custom_signals(specs: list[SignalSpec] | None) -> Callable[[], None]:
     stack = ExitStack()
 
@@ -441,11 +448,11 @@ Compute a platform-aware exit status for arbitrary exceptions (errno mappings on
 Parameters:
 - `exc`: Exception instance to classify.
 
-### `print_exception_message(trace_back=config.traceback, length_limit=500, stream=None) -> None`
+### `print_exception_message(trace_back=None, length_limit=500, stream=None) -> None`
 Emit the active exception using Rich formatting. Produces a coloured traceback when `trace_back` is `True`, otherwise prints a truncated summary in red. Respects `config.traceback_force_color` and mirrors the behaviour of `handle_cli_exception` (tracebacks are rendered before the helper returns an exit status).
 
 Parameters:
-- `trace_back`: Toggle between full traceback rendering (`True`) and short summary (`False`).
+- `trace_back`: Toggle between full traceback rendering (`True`) and short summary (`False`). When `None` (default), uses `config.traceback`.
 - `length_limit`: Maximum characters for summary output.
 - `stream`: Target text stream; defaults to `sys.stderr`.
 
@@ -520,7 +527,8 @@ from __future__ import annotations
 
 from typing import Sequence
 
-import click
+import rich_click as click
+
 import lib_cli_exit_tools
 
 from . import __init__conf__
@@ -577,7 +585,7 @@ def main(argv: Sequence[str] | None = None) -> int:
     )
 ```
 
-When installed, the generated console scripts (`lib-cli-exit-tools`, `cli-exit-tools`, `lib_cli_exit_tools`) will import `your_package.cli:main`, and `python -m your_package` will follow the same code path via `__main__.py`.
+When installed, your package's console scripts (defined in `pyproject.toml`) will import `your_package.cli:main`, and `python -m your_package` will follow the same code path via `__main__.py`.
 
 ## Exit Codes
 
@@ -606,5 +614,4 @@ When installed, the generated console scripts (`lib-cli-exit-tools`, `cli-exit-t
 - [CONTRIBUTING](CONTRIBUTING.md)
 - [DEVELOPMENT](DEVELOPMENT.md)
 - [MODULE REFERENCE](docs/system-design/module_reference.md)
-- [AGENTS_README](AGENTS_README.md)
 - [LICENSE](LICENSE)

{lib_cli_exit_tools-2.2.2 → lib_cli_exit_tools-2.2.3}/docs/system-design/module_reference.md

@@ -221,6 +221,6 @@ Downstream CLIs and automation pipelines need deterministic exit codes, signal h
 
 ---
 
-**Created:** 2025-10-08 by Codex (automated)  
-**Last Updated:** 2025-10-08 by Codex (automated)  
+**Created:** 2025-10-08 by Codex (automated)
+**Last Updated:** 2025-12-17
 **Review Cycle:** Revisit every 90 days or after major CLI/runtime changes

{lib_cli_exit_tools-2.2.2 → lib_cli_exit_tools-2.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lib_cli_exit_tools"
-version = "2.2.2"
+version = "2.2.3"
 description = "CLI exit handling helpers: clean signals, exit codes, and error printing"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -36,7 +36,7 @@ dev = [
   "pytest-asyncio>=1.3.0",
   "pytest-cov>=7.0.0",
   "ruff>=0.14.9",
-  "textual>=6.8.0",
+  "textual>=6.10.0",
   "rtoml>=0.13.0",
   "twine>=6.2.0"
 ]
@@ -159,10 +159,13 @@ forbidden_modules = [
 # PYSEC-2022-43012, CVE-2024-6345, PYSEC-2025-49: setuptools vulnerabilities
 #   These are build-time dependencies only, not runtime. The virtual environment
 #   setuptools version is managed by the CI environment/pip itself.
+# CVE-2025-68146: filelock <3.20.1 vulnerability, transitive dev dependency
+#   Will be resolved when upstream packages update their dependencies.
 ignore-vulns = [
   "GHSA-4xh5-x5gv-qwph",
   "PYSEC-2022-42969",
   "PYSEC-2022-43012",
   "CVE-2024-6345",
   "PYSEC-2025-49",
+  "CVE-2025-68146",
 ]

{lib_cli_exit_tools-2.2.2 → lib_cli_exit_tools-2.2.3}/src/lib_cli_exit_tools/__init__conf__.py

@@ -24,7 +24,7 @@ name = "lib_cli_exit_tools"
 #: Human-readable summary shown in CLI help output.
 title = "CLI exit handling helpers: clean signals, exit codes, and error printing"
 #: Current release version pulled from ``pyproject.toml`` by automation.
-version = "2.2.2"
+version = "2.2.3"
 #: Repository homepage presented to users.
 homepage = "https://github.com/bitranox/lib_cli_exit_tools"
 #: Author attribution surfaced in CLI output.