lib-cli-exit-tools 1.5.0__tar.gz → 1.6.0__tar.gz

lib_cli_exit_tools-1.6.0/.codacy/cli-config.yaml

@@ -0,0 +1 @@
+mode: local

lib_cli_exit_tools-1.6.0/.codacy/cli.sh

@@ -0,0 +1,149 @@
+#!/usr/bin/env bash
+
+
+set -e +o pipefail
+
+# Set up paths first
+bin_name="codacy-cli-v2"
+
+# Determine OS-specific paths
+os_name=$(uname)
+arch=$(uname -m)
+
+case "$arch" in
+"x86_64")
+  arch="amd64"
+  ;;
+"x86")
+  arch="386"
+  ;;
+"aarch64"|"arm64")
+  arch="arm64"
+  ;;
+esac
+
+if [ -z "$CODACY_CLI_V2_TMP_FOLDER" ]; then
+    if [ "$(uname)" = "Linux" ]; then
+        CODACY_CLI_V2_TMP_FOLDER="$HOME/.cache/codacy/codacy-cli-v2"
+    elif [ "$(uname)" = "Darwin" ]; then
+        CODACY_CLI_V2_TMP_FOLDER="$HOME/Library/Caches/Codacy/codacy-cli-v2"
+    else
+        CODACY_CLI_V2_TMP_FOLDER=".codacy-cli-v2"
+    fi
+fi
+
+version_file="$CODACY_CLI_V2_TMP_FOLDER/version.yaml"
+
+
+get_version_from_yaml() {
+    if [ -f "$version_file" ]; then
+        local version=$(grep -o 'version: *"[^"]*"' "$version_file" | cut -d'"' -f2)
+        if [ -n "$version" ]; then
+            echo "$version"
+            return 0
+        fi
+    fi
+    return 1
+}
+
+get_latest_version() {
+    local response
+    if [ -n "$GH_TOKEN" ]; then
+        response=$(curl -Lq --header "Authorization: Bearer $GH_TOKEN" "https://api.github.com/repos/codacy/codacy-cli-v2/releases/latest" 2>/dev/null)
+    else
+        response=$(curl -Lq "https://api.github.com/repos/codacy/codacy-cli-v2/releases/latest" 2>/dev/null)
+    fi
+
+    handle_rate_limit "$response"
+    local version=$(echo "$response" | grep -m 1 tag_name | cut -d'"' -f4)
+    echo "$version"
+}
+
+handle_rate_limit() {
+    local response="$1"
+    if echo "$response" | grep -q "API rate limit exceeded"; then
+          fatal "Error: GitHub API rate limit exceeded. Please try again later"
+    fi
+}
+
+download_file() {
+    local url="$1"
+
+    echo "Downloading from URL: ${url}"
+    if command -v curl > /dev/null 2>&1; then
+        curl -# -LS "$url" -O
+    elif command -v wget > /dev/null 2>&1; then
+        wget "$url"
+    else
+        fatal "Error: Could not find curl or wget, please install one."
+    fi
+}
+
+download() {
+    local url="$1"
+    local output_folder="$2"
+
+    ( cd "$output_folder" && download_file "$url" )
+}
+
+download_cli() {
+    # OS name lower case
+    suffix=$(echo "$os_name" | tr '[:upper:]' '[:lower:]')
+
+    local bin_folder="$1"
+    local bin_path="$2"
+    local version="$3"
+
+    if [ ! -f "$bin_path" ]; then
+        echo "📥 Downloading CLI version $version..."
+
+        remote_file="codacy-cli-v2_${version}_${suffix}_${arch}.tar.gz"
+        url="https://github.com/codacy/codacy-cli-v2/releases/download/${version}/${remote_file}"
+
+        download "$url" "$bin_folder"
+        tar xzfv "${bin_folder}/${remote_file}" -C "${bin_folder}"
+    fi
+}
+
+# Warn if CODACY_CLI_V2_VERSION is set and update is requested
+if [ -n "$CODACY_CLI_V2_VERSION" ] && [ "$1" = "update" ]; then
+    echo "⚠️  Warning: Performing update with forced version $CODACY_CLI_V2_VERSION"
+    echo "    Unset CODACY_CLI_V2_VERSION to use the latest version"
+fi
+
+# Ensure version.yaml exists and is up to date
+if [ ! -f "$version_file" ] || [ "$1" = "update" ]; then
+    echo "ℹ️  Fetching latest version..."
+    version=$(get_latest_version)
+    mkdir -p "$CODACY_CLI_V2_TMP_FOLDER"
+    echo "version: \"$version\"" > "$version_file"
+fi
+
+# Set the version to use
+if [ -n "$CODACY_CLI_V2_VERSION" ]; then
+    version="$CODACY_CLI_V2_VERSION"
+else
+    version=$(get_version_from_yaml)
+fi
+
+
+# Set up version-specific paths
+bin_folder="${CODACY_CLI_V2_TMP_FOLDER}/${version}"
+
+mkdir -p "$bin_folder"
+bin_path="$bin_folder"/"$bin_name"
+
+# Download the tool if not already installed
+download_cli "$bin_folder" "$bin_path" "$version"
+chmod +x "$bin_path"
+
+run_command="$bin_path"
+if [ -z "$run_command" ]; then
+    fatal "Codacy cli v2 binary could not be found."
+fi
+
+if [ "$#" -eq 1 ] && [ "$1" = "download" ]; then
+    echo "Codacy cli v2 download succeeded"
+else
+    eval "$run_command $*"
+fi

lib_cli_exit_tools-1.6.0/.codacy/codacy.yaml

@@ -0,0 +1,15 @@
+runtimes:
+    - dart@3.7.2
+    - go@1.22.3
+    - java@17.0.10
+    - node@22.2.0
+    - python@3.11.11
+tools:
+    - dartanalyzer@3.7.2
+    - eslint@8.57.0
+    - lizard@1.17.31
+    - pmd@7.11.0
+    - pylint@3.3.6
+    - revive@1.7.0
+    - semgrep@1.78.0
+    - trivy@0.66.0

lib_cli_exit_tools-1.6.0/.codacy/tools-configs/lizard.yaml

@@ -0,0 +1,50 @@
+patterns:
+    Lizard_ccn-medium:
+        category: Complexity
+        description: Checks if the cyclomatic complexity of a function or logic block exceeds the medium threshold (default is 8).
+        explanation: |-
+            # Medium Cyclomatic Complexity control
+
+            Check the Cyclomatic Complexity value of a function or logic block. If the threshold is not met, raise a Medium issue. The default threshold is 7.
+        id: Lizard_ccn-medium
+        level: Warning
+        severityLevel: Warning
+        threshold: 8
+        timeToFix: 10
+        title: Enforce Medium Cyclomatic Complexity Threshold
+    Lizard_file-nloc-medium:
+        category: Complexity
+        description: This rule checks if the number of lines of code (excluding comments) in a file exceeds a medium threshold, typically 500 lines.
+        explanation: ""
+        id: Lizard_file-nloc-medium
+        level: Warning
+        severityLevel: Warning
+        threshold: 500
+        timeToFix: 10
+        title: Enforce Medium File Length Limit Based on Number of Lines of Code
+    Lizard_nloc-medium:
+        category: Complexity
+        description: Checks if the number of lines of code (excluding comments) in a function exceeds a medium threshold (default 50 lines).
+        explanation: |-
+            # Medium NLOC control - Number of Lines of Code (without comments)
+
+            Check the number of lines of code (without comments) in a function. If the threshold is not met, raise a Medium issue. The default threshold is 50.
+        id: Lizard_nloc-medium
+        level: Warning
+        severityLevel: Warning
+        threshold: 50
+        timeToFix: 10
+        title: Enforce Medium Number of Lines of Code (NLOC) Limit
+    Lizard_parameter-count-medium:
+        category: Complexity
+        description: This rule checks the number of parameters passed to a function and raises an issue if it exceeds a medium threshold, which by default is 8 parameters.
+        explanation: |-
+            # Medium Parameter count control
+
+            Check the number of parameters sent to a function. If the threshold is not met, raise a Medium issue. The default threshold is 5.
+        id: Lizard_parameter-count-medium
+        level: Warning
+        severityLevel: Warning
+        threshold: 8
+        timeToFix: 10
+        title: Enforce Medium Parameter Count Limit

lib_cli_exit_tools-1.6.0/.codacy/tools-configs/trivy.yaml

@@ -0,0 +1,10 @@
+severity:
+  - LOW
+  - MEDIUM
+  - HIGH
+  - CRITICAL
+
+scan:
+  scanners:
+    - vuln
+    - secret

lib_cli_exit_tools-1.6.0/.devcontainer/devcontainer.json

@@ -0,0 +1,22 @@
+{
+  "image": "mcr.microsoft.com/devcontainers/python:3.13",
+
+  "postCreateCommand": "bash -lc '\nPY=/usr/local/bin/python;\n$PY -m pip install -U pip && \\\n$PY -m pip install ipykernel && \\\n$PY -m pip install -e . && \\\n# register kernel using this exact interpreter\n$PY -m ipykernel install --name=python3 --display-name=\"Python 3 (3.13)\" --user && \\\n# patch the notebook to point to the python3 kernelspec (VS Code will bind to /usr/local/bin/python)\n$PY - <<\"PY\"\nimport json, pathlib\np = pathlib.Path(\"notebooks/Quickstart.ipynb\")\nif p.exists():\n    nb = json.loads(p.read_text(encoding=\"utf-8\"))\n    md = nb.setdefault(\"metadata\", {})\n    md[\"kernelspec\"] = {\n        \"name\": \"python3\",\n        \"display_name\": \"Python 3 (3.13)\",\n        \"language\": \"python\"\n    }\n    md[\"language_info\"] = {\"name\": \"python\"}\n    p.write_text(json.dumps(nb, ensure_ascii=False, indent=1), encoding=\"utf-8\")\n    print(\"Pinned kernelspec to python3 in\", p)\nelse:\n    print(\"Notebook not found:\", p)\nPY'\n",
+
+  "customizations": {
+    "vscode": {
+      "extensions": ["ms-toolsai.jupyter", "ms-python.python"],
+      "settings": {
+        "workbench.startupEditor": "none",
+        "jupyter.alwaysTrustNotebooks": true,
+        "jupyter.kernelPickerType": "OnlyRecommended",
+        "python.defaultInterpreterPath": "/usr/local/bin/python"
+      }
+    },
+    "codespaces": {
+      "openFiles": ["README.md"]
+    }
+  },
+
+  "postAttachCommand": "bash -lc 'if [ -f notebooks/Quickstart.ipynb ]; then code -r notebooks/Quickstart.ipynb; fi'"
+}

lib_cli_exit_tools-1.6.0/.devcontainer/settings.json

@@ -0,0 +1,6 @@
+{
+  "python.defaultInterpreterPath": "/usr/local/bin/python3.13",
+  "jupyter.alwaysTrustNotebooks": true,
+  "jupyter.kernelPickerType": "OnlyRecommended",
+  "jupyter.askForKernelRestart": false
+}

{lib_cli_exit_tools-1.5.0 → lib_cli_exit_tools-1.6.0}/.github/workflows/ci.yml

@@ -14,13 +14,31 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        # Test against Python 3.10 and the latest 3.x available on Actions runners
-        python: ["3.10", "3.x"]
+        # Test against Python 3.13 and the latest 3.x available on Actions runners
+        python: ["3.13", "3.x"]
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python }}
+      - name: Extract project metadata
+        shell: python
+        run: |
+          import os
+          import tomllib
+          from pathlib import Path
+
+          data = tomllib.loads(Path('pyproject.toml').read_text('utf-8'))
+          project = data['project']['name']
+          module = project.replace('-', '_')
+          dash = project.replace('_', '-')
+          scripts = list(data['project'].get('scripts', {}).keys())
+          cli_bin = scripts[0] if scripts else dash
+
+          with open(os.environ['GITHUB_ENV'], 'a', encoding='utf-8') as env:
+              env.write(f"PROJECT_NAME={project}\n")
+              env.write(f"PACKAGE_MODULE={module}\n")
+              env.write(f"CLI_BIN={cli_bin}\n")
       - name: Install make on Windows
         if: runner.os == 'Windows'
         shell: pwsh
@@ -30,8 +48,7 @@ jobs:
       - name: Install dev deps
         shell: bash
         run: |
-          python -m pip install --upgrade pip
-          python -m pip install --upgrade click rich rich-click
+          python -m pip install --upgrade "pip!=25.2"
           pip install -e .[dev]
       - name: Run full test suite (lint, types, tests, coverage, codecov)
         shell: bash
@@ -45,7 +62,14 @@ jobs:
           python -m venv .venv_wheel
           . .venv_wheel/bin/activate 2>/dev/null || . .venv_wheel/Scripts/activate 2>/dev/null
           pip install dist/*.whl
-          lib_cli_exit_tools --version || python -m lib_cli_exit_tools --version
+          "$CLI_BIN" --version 2>/dev/null || python -m "$PACKAGE_MODULE" --version
+      - name: Verify sdist install in clean env
+        shell: bash
+        run: |
+          python -m venv .venv_sdist
+          . .venv_sdist/bin/activate 2>/dev/null || . .venv_sdist/Scripts/activate 2>/dev/null
+          pip install dist/*.tar.gz
+          "$CLI_BIN" --version 2>/dev/null || python -m "$PACKAGE_MODULE" --version
 
   pipx-uv:
     name: pipx/uv verification (ubuntu)
@@ -54,22 +78,43 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: "3.13"
+      - name: Extract project metadata
+        shell: python
+        run: |
+          import os
+          import tomllib
+          from pathlib import Path
+
+          data = tomllib.loads(Path('pyproject.toml').read_text('utf-8'))
+          project = data['project']['name']
+          module = project.replace('-', '_')
+          dash = project.replace('_', '-')
+          scripts = list(data['project'].get('scripts', {}).keys())
+          cli_bin = scripts[0] if scripts else dash
+
+          with open(os.environ['GITHUB_ENV'], 'a', encoding='utf-8') as env:
+              env.write(f"PROJECT_NAME={project}\n")
+              env.write(f"PACKAGE_MODULE={module}\n")
+              env.write(f"CLI_BIN={cli_bin}\n")
       - name: Build wheel
         run: |
-          python -m pip install --upgrade pip build
+          python -m pip install --upgrade "pip!=25.2"
+          python -m pip install --upgrade build
           python -m build
       - name: pipx install from wheel
         run: |
           python -m pip install pipx
           pipx install dist/*.whl
-          lib_cli_exit_tools --version
+          "$CLI_BIN" --version 2>/dev/null || python -m "$PACKAGE_MODULE" --version
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
       - name: uv tool install
         run: |
-          curl -LsSf https://astral.sh/uv/install.sh | sh
-          export PATH="$HOME/.local/bin:$HOME/.cargo/bin:$HOME/.local/share/uv/bin:$PATH"
           uv tool install .
-          lib_cli_exit_tools --version
+          "$CLI_BIN" --version 2>/dev/null || python -m "$PACKAGE_MODULE" --version
 
   # nix and conda packaging builds are disabled for now to keep CI green.
   nix:
@@ -78,7 +123,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Install Nix (flakes)
-        uses: cachix/install-nix-action@v27
+        uses: cachix/install-nix-action@v31
         with:
           extra_nix_config: |
             experimental-features = nix-command flakes
@@ -97,7 +142,7 @@ jobs:
         uses: conda-incubator/setup-miniconda@v3
         with:
           auto-update-conda: true
-          python-version: "3.12"
+          python-version: "3.13"
       - name: Build conda recipe (local source, no test)
         shell: bash -l {0}
         env:
@@ -109,16 +154,16 @@ jobs:
           conda build packaging/conda/recipe --no-test -c conda-forge -c defaults
 
   notebooks:
-    name: Execute notebooks (ubuntu, Python 3.10)
+    name: Execute notebooks (ubuntu, Python 3.13)
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.10"
+          python-version: "3.13"
       - name: Install notebook runner deps
         run: |
-          python -m pip install --upgrade pip
+          python -m pip install --upgrade "pip!=25.2"
           pip install nbclient nbformat ipykernel jupyter_client
           python -m ipykernel install --user --name python3 --display-name "Python 3"
       - name: Execute Quickstart notebook
@@ -178,21 +223,21 @@ jobs:
       - name: Verify packaging matches pyproject
         run: |
           python - << 'PY'
-          import re, sys
+          import re, sys, tomllib
           from pathlib import Path
 
-          py = Path('pyproject.toml').read_text(encoding='utf-8')
-          m_ver = re.search(r'^version\s*=\s*"([^"]+)"', py, re.M)
-          m_req = re.search(r'^requires-python\s*=\s*"([^"]+)"', py, re.M)
-          if not (m_ver and m_req):
-            print('pyproject missing version or requires-python'); sys.exit(1)
-          version = m_ver.group(1)
-          requires = m_req.group(1)
-          m_min = re.search(r'>=\s*(3\.[0-9]+)', requires)
-          if not m_min:
-            print('requires-python must be like ">=3.X"'); sys.exit(1)
-          min_py = m_min.group(1)
+          data = tomllib.loads(Path('pyproject.toml').read_text(encoding='utf-8'))
+          project = data['project']['name']
+          version = data['project']['version']
+          requires = data['project']['requires-python']
+
+          min_match = re.search(r'([0-9]+\.[0-9]+)', requires)
+          if not min_match:
+            print('requires-python must declare a minimum like ">=3.X"'); sys.exit(1)
+          min_py = min_match.group(1)
           min_digits = min_py.replace('.', '')
+          project_dash = project.replace('_', '-')
+          project_module = project.replace('-', '_')
 
           # Conda
           conda = Path('packaging/conda/recipe/meta.yaml').read_text(encoding='utf-8')
@@ -202,7 +247,10 @@ jobs:
             print('conda/meta.yaml: python constraint not aligned (host/run)'); sys.exit(1)
 
           # Brew
-          brew = Path('packaging/brew/Formula/lib-cli-exit-tools.rb').read_text(encoding='utf-8')
+          brew_path = Path(f'packaging/brew/Formula/{project_dash}.rb')
+          if not brew_path.exists():
+            print(f'brew formula missing: {brew_path}'); sys.exit(1)
+          brew = brew_path.read_text(encoding='utf-8')
           if f"refs/tags/v{version}.tar.gz" not in brew:
             print('brew formula: url tag mismatch'); sys.exit(1)
           if f'"python@{min_py}"' not in brew:
@@ -210,7 +258,7 @@ jobs:
 
           # Nix
           nix = Path('packaging/nix/flake.nix').read_text(encoding='utf-8')
-          if not re.search(r'pname\s*=\s*"lib_cli_exit_tools";\s*[^}]*?version\s*=\s*"' + re.escape(version) + r'";', nix, re.S):
+          if not re.search(r'pname\s*=\s*"' + re.escape(project_module) + r'";\s*[^}]*?version\s*=\s*"' + re.escape(version) + r'";', nix, re.S):
             print('nix flake: version mismatch'); sys.exit(1)
           if not re.search(r'pypkgs\s*=\s*pkgs\.python' + re.escape(min_digits) + r'Packages', nix):
             print('nix flake: python package set not aligned'); sys.exit(1)

{lib_cli_exit_tools-1.5.0 → lib_cli_exit_tools-1.6.0}/.github/workflows/release.yml

@@ -24,7 +24,7 @@ jobs:
           fi
       - uses: actions/setup-python@v5
         with:
-          python-version: '3.12'
+          python-version: '3.13'
       - name: Build artifacts
         run: |
           python -m pip install --upgrade pip build

lib_cli_exit_tools-1.6.0/.qlty/qlty.toml

@@ -0,0 +1,2 @@
+exclude_patterns = ["scripts/**"]
+test_patterns = ["tests/**"]

lib_cli_exit_tools-1.6.0/.snyk

@@ -0,0 +1,5 @@
+# Snyk (https://snyk.io) policy file
+exclude:
+ global:
+   - scripts/**
+   - tests/**

{lib_cli_exit_tools-1.5.0 → lib_cli_exit_tools-1.6.0}/AGENTS.md

@@ -2,6 +2,10 @@
 
 ## On session start
 
+whenever You wait for user input or finished, execute "paplay /usr/share/sounds/codex/ready.wav"
+whenever You have a question, execute "paplay /usr/share/sounds/codex/ready.wav"
+whenever You have an error, execute "paplay /usr/share/sounds/codex/error.wav"
+
 Review the system prompt files in `/media/srv-main/softdev/*/projects/softwarestack/systemprompts` and keep their guidance in working memory:
 
 - core_programming_solid.md
@@ -16,6 +20,7 @@ Review the system prompt files in `/media/srv-main/softdev/*/projects/softwarest
 - python_jupyter_notebooks.md
 - python_testing.md
 
+
 always apply those Rules :
 
 - core_programming_solid.md
@@ -47,7 +52,7 @@ when writing or refracturing Python scripts, apply those Rules :
 
 - Single source of truth for the package version is `pyproject.toml` (`[project].version`).
 - Runtime code reads metadata via `importlib.metadata`; do not duplicate the version in code files.
-- On a version bump, update only `pyproject.toml` and the `CHANGELOG.md` entry; do not edit `src/lib_cli_exit_tools/__init__conf__.py` for versioning.
+- On a version bump, update only `pyproject.toml` and the `CHANGELOG.md` entry; runtime code should continue to read the version via `importlib.metadata` (no separate `__init__conf__` file).
 - Tag releases `vX.Y.Z` and push tags; CI will build artifacts and publish when configured.
 
 ### Common Make Targets (Alphabetical)
@@ -73,6 +78,7 @@ when writing or refracturing Python scripts, apply those Rules :
 
 
 ## Coding Style & Naming Conventions
+  - apply python_clean_code.md
 
 ## Commit & Pull Request Guidelines
 
@@ -88,23 +94,20 @@ when writing or refracturing Python scripts, apply those Rules :
 ## Translations (App UI Strings)
 
 ## Changes in WEB Documentation
-
 - when asked to update documentation - only do that in the english docs under /website/docs because other languages will be translated automatically,
   unless stated otherwise by the user. In doubt - ask the user
 
 ## Changes in APP Strings
-
 - when i18 strings are changed, only to that in sources/\_locales/en because other languages will be translated automatically,
   unless stated otherwise by the user. In doubt - ask the user
 
 ## commit/push/GitHub policy
-
 - run "make test" before any push to avoid lint/test breakage.
 - after push, monitor errors in the github actions and try to correct the errors
 
----
+--- 
 
-# ONLY ON USER REQEST !!!! :
+# ONLY ON USER REQEST !!!! : 
 
 # 📘 Documentation Review & Enhancement Prompt
 

lib_cli_exit_tools-1.6.0/CHANGELOG.md

@@ -0,0 +1,110 @@
+# Changelog
+
+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).
+
+
+## [1.6.0] - 2025-10-08
+
+### Added
+- Property-based (Hypothesis) tests covering `SystemExit` payload handling and configurable broken-pipe exit codes.
+- POSIX integration test that drives a subprocess through a SIGINT to assert real signal handling behaviour.
+
+### Changed
+- Local `make test` runs skip packaging-sync enforcement unless running in CI or with `ENFORCE_PACKAGING_SYNC=1`, reducing friction for contributors.
+- CLI rich-click styling now preserves coloured tracebacks when stderr supports UTF/TTY output even if stdout is piped.
+- Centralised public API exports so `lib_cli_exit_tools` and its facade share a single authoritative symbol list.
+
+### Security
+- Suppress pip-audit false positive for GHSA-4xh5-x5gv-qwph until an official fixed pip build is published.
+
+## [1.5.0] - 2025-10-08
+
+### Added
+- Configuration helpers `config_overrides` and `reset_config` so embedders can
+  safely tweak and restore global CLI settings without bespoke fixtures.
+- Expanded OS-aware test coverage (sysexits mappings, signal restoration, CLI
+  behaviours) and rewritten specs that no longer rely on private helpers.
+- CI job that executes the Quickstart notebook on Python 3.13 and validations that ensure packaging metadata stays in sync at tag time.
+- Automation that keeps Conda, Homebrew, and Nix specs aligned with `pyproject.toml`, including a dedicated `--sync-packaging` mode.
+- Regression tests covering `SystemExit` variants, tolerant output rendering, English signal messages, and ValueError mappings on Windows.
+
+### Changed
+- Hardened `get_system_exit_code` handling for non-integer payloads and switched OS detection to `os.name`.
+- Updated `_print_output` to decode both `bytes` and `str`, trimming assertions in favour of resilient diagnostics.
+- Standardised signal messages (“Aborted (SIGINT).”, etc.) and cached metadata lookups in `__init__conf__`.
+- Enforced an 85% coverage threshold (in line with `pyproject.toml` and Codecov settings) and removed spurious coverage pragmas to reflect the new test suite.
+- Repartitioned the library into `core`, `adapters`, and `application` layers with `lib_cli_exit_tools` acting as the facade.
+- `run_cli` now accepts injectable `exception_handler` and `signal_installer` hooks, and rich-click configuration is applied lazily from `main()`.
+
+### Fixed
+- Restored Pyright compatibility by typing metadata helpers against a minimal protocol.
+- Removed a Ruff F401 false positive on the Quickstart notebook via per-file ignore.
+
+### Documentation
+- Expanded the README with packaging sync guidance and notebook usage notes.
+- Clarified release steps in CONTRIBUTING and refreshed developer docs.
+
+## [1.4.0] - 2025-09-26
+
+### Changed
+- Refactored packaging automation and broadened the pytest suite to cover new CLI flows.
+
+## [1.3.1] - 2025-09-26
+
+### Fixed
+- Adjusted coloured traceback behaviour to address regressions introduced in 1.3.0.
+
+## [1.3.0] - 2025-09-25
+
+### Added
+- Introduced Rich-powered traceback rendering for CLI failures.
+
+## [1.2.0] - 2025-09-25
+
+### Changed
+- Switched the CLI stack to rich-click and delivered associated fixes.
+
+## [1.1.1] - 2025-09-18
+
+### Added
+- Documentation and doctest updates for newly exposed helpers.
+
+## [1.1.0] - 2025-09-16
+
+### Added
+- `lib_cli_exit_tools.run_cli` helper to reduce Click boilerplate (see `cli.py`).
+
+## [1.0.3] - 2025-09-16
+
+### Added
+- `make menu` target for the Textual-powered maintenance UI.
+
+## [1.0.2] - 2025-09-15
+
+### Changed
+- Miscellaneous internal improvements.
+
+## [1.0.1] - 2025-09-15
+
+### Changed
+- Miscellaneous internal improvements.
+
+## [1.0.0] - 2025-09-15
+
+### Added
+- Initial public release.
+
+## [0.1.1] - 2025-09-15
+
+### Added
+- Placeholder for early internal work.
+
+## [0.1.0] - 2025-09-14
+
+### Added
+- Unified package naming, tightened public API exports, and added tests for exit-code mapping and CLI behaviour.
+
+## [0.0.1] - 2025-09-13
+
+### Added
+- Initial internal release.