whiskerless 0.1.0__tar.gz

whiskerless-0.1.0/.editorconfig

@@ -0,0 +1,14 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+
+[*.py]
+indent_size = 4
+
+[*.{json,yaml,yml,toml,md}]
+indent_size = 2

whiskerless-0.1.0/.forgejo/workflows/ci.yml

@@ -0,0 +1,56 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*.*.*"]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  quality:
+    name: Lint, type-check, test (library)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.12"
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev,ble]"
+      - name: Ruff
+        run: ruff check src custom_components tests
+      - name: Mypy (library, strict)
+        run: mypy
+      - name: Pytest (library)
+        run: pytest -q
+
+  homeassistant:
+    name: Type-check + test the integration
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev,test-ha]"
+      - name: Mypy (integration, strict)
+        # --python-version 3.13: the integration uses PEP 695 syntax (HA runs 3.13);
+        # override pyproject's 3.11 library pin so the type alias / generic defs parse.
+        # --namespace-packages --explicit-package-bases: check it as
+        # custom_components.whiskerless so `from whiskerless import …` resolves to the
+        # installed library, not the same-named integration package (matches runtime).
+        run: >-
+          mypy --strict --python-version 3.13 --namespace-packages
+          --explicit-package-bases custom_components/whiskerless
+      - name: Pytest (integration)
+        run: pytest tests/integration

whiskerless-0.1.0/.forgejo/workflows/publish.yml

@@ -0,0 +1,87 @@
+name: Publish
+
+# Runs on the Forgejo source when a v* tag lands (from release.yml). It is the
+# only place that can reach everything (Forgejo, the internal NAS, GitHub, PyPI),
+# so it orchestrates the releases. The GitHub mirror's release-macos.yml appends
+# the signed .pkg to the GitHub + public-Forgejo releases; the `nas-pkg` job here
+# then bridges that .pkg over to the internal NAS (which GitHub can't reach).
+on:
+  push:
+    tags: ["v*.*.*"]
+
+permissions:
+  contents: read
+
+jobs:
+  pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.12"
+      - name: Build + upload
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          python -m pip install --upgrade build twine
+          python -m build
+          twine upload dist/*
+
+  releases:
+    name: Create releases + Linux binary (Forgejo, NAS, GitHub)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.12"
+      - name: Build Linux binary
+        run: |
+          python -m pip install --upgrade pip pyinstaller
+          python -m pip install ".[ble]"
+          pyinstaller --onefile --name whiskerless-linux-x86_64 \
+            --collect-all bleak --collect-all aiomqtt packaging/launcher.py
+      - name: Release notes from CHANGELOG
+        run: bash packaging/changelog-section.sh "${GITHUB_REF_NAME#v}" > notes.md
+      - name: Create the three releases with the Linux binary
+        run: |
+          chmod +x packaging/forgejo-release.sh packaging/github-release.sh
+          BIN=dist/whiskerless-linux-x86_64
+          packaging/forgejo-release.sh forgejo.bryantserver.com \
+            "${{ secrets.CLUSTER_FORGEJO_REPO_WRITE_PAT }}" "$GITHUB_REF_NAME" notes.md "$BIN"
+          packaging/forgejo-release.sh forgejo.nas.bryantserver.com \
+            "${{ secrets.NAS_FORGEJO_REPO_WRITE_PAT }}" "$GITHUB_REF_NAME" notes.md "$BIN"
+          packaging/github-release.sh \
+            "${{ secrets.GH_REPO_WRITE_PAT }}" "$GITHUB_REF_NAME" notes.md "$BIN"
+
+  nas-pkg:
+    name: Bridge the macOS .pkg → NAS
+    needs: releases
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - name: Wait for the .pkg on the public Forgejo release, then copy to NAS
+        run: |
+          set -euo pipefail
+          API=https://forgejo.bryantserver.com/api/v1/repos/SisyphusMD/whiskerless
+          # The .pkg is built + notarized on GitHub (slow), then appended to the
+          # public Forgejo release. Wait for it (up to 30 min), then copy to NAS.
+          urls=""
+          for _ in $(seq 1 180); do
+            urls=$(curl -sf "$API/releases/tags/$GITHUB_REF_NAME" \
+              | jq -r '.assets[]? | select(.name | endswith(".pkg")) | .browser_download_url' || true)
+            [ -n "$urls" ] && break
+            sleep 10
+          done
+          if [ -z "$urls" ]; then
+            echo "::warning::no .pkg on the Forgejo release after 30m; NAS release will lack it"
+            exit 0
+          fi
+          echo "$urls" | while read -r u; do [ -n "$u" ] && curl -sSL -O "$u"; done
+          bash packaging/changelog-section.sh "${GITHUB_REF_NAME#v}" > notes.md
+          chmod +x packaging/forgejo-release.sh
+          packaging/forgejo-release.sh forgejo.nas.bryantserver.com \
+            "${{ secrets.NAS_FORGEJO_REPO_WRITE_PAT }}" "$GITHUB_REF_NAME" notes.md *.pkg

whiskerless-0.1.0/.forgejo/workflows/release.yml

@@ -0,0 +1,123 @@
+name: Release
+
+# Cut a release from main: pick the bump in the Forgejo UI. This advances the
+# CHANGELOG, bumps every version string, runs the test gate, then commits + tags.
+# The tag triggers publish.yml (PyPI + Linux binary + the forgejo/nas/github
+# releases) and, on the GitHub mirror, the macOS .pkg job.
+on:
+  workflow_dispatch:
+    inputs:
+      bump:
+        description: "Version bump"
+        required: true
+        type: choice
+        options: [patch, minor, major]
+
+concurrency:
+  group: release
+  cancel-in-progress: false
+
+jobs:
+  release:
+    name: Cut release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Refuse non-main dispatches
+        run: |
+          if [ "${{ github.ref_name }}" != "main" ]; then
+            echo "::error::Release must be dispatched from main; got '${{ github.ref_name }}'"
+            exit 1
+          fi
+
+      - name: Checkout (full history + tags)
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.CLUSTER_FORGEJO_REPO_WRITE_PAT }}
+
+      - name: Configure git identity
+        run: |
+          git config user.name "forgejo-actions[bot]"
+          git config user.email "forgejo-actions[bot]@users.noreply.bryantserver.com"
+
+      - name: Compute next version
+        id: ver
+        env:
+          BUMP: ${{ inputs.bump }}
+        run: |
+          set -euo pipefail
+          PREV_TAG=$(git tag -l 'v*.*.*' --sort=-v:refname | head -n1 || true)
+          CURRENT="${PREV_TAG#v}"; CURRENT="${CURRENT:-0.0.0}"
+          MAJOR=$(echo "$CURRENT" | cut -d. -f1)
+          MINOR=$(echo "$CURRENT" | cut -d. -f2)
+          PATCH=$(echo "$CURRENT" | cut -d. -f3)
+          case "$BUMP" in
+            patch) PATCH=$((PATCH + 1)) ;;
+            minor) MINOR=$((MINOR + 1)); PATCH=0 ;;
+            major) MAJOR=$((MAJOR + 1)); MINOR=0; PATCH=0 ;;
+          esac
+          NEXT="${MAJOR}.${MINOR}.${PATCH}"
+          echo "version=${NEXT}" >> "$GITHUB_OUTPUT"
+          echo "tag=v${NEXT}" >> "$GITHUB_OUTPUT"
+          echo "Releasing ${NEXT} (bump=${BUMP}, previous=${PREV_TAG:-none})"
+
+      - name: Sanity guards
+        env:
+          VERSION: ${{ steps.ver.outputs.version }}
+          TAG: ${{ steps.ver.outputs.tag }}
+        run: |
+          set -euo pipefail
+          grep -qE '^## \[Unreleased\]' CHANGELOG.md || { echo "::error::Missing '## [Unreleased]'"; exit 1; }
+          ! grep -qE "^## \[${VERSION}\]" CHANGELOG.md || { echo "::error::CHANGELOG already has [${VERSION}]"; exit 1; }
+          ! git rev-parse -q --verify "refs/tags/${TAG}" >/dev/null || { echo "::error::Tag ${TAG} exists"; exit 1; }
+
+      - name: Promote [Unreleased] in CHANGELOG
+        env:
+          VERSION: ${{ steps.ver.outputs.version }}
+        run: |
+          set -euo pipefail
+          DATE=$(date -u +%Y-%m-%d)
+          awk -v ver="$VERSION" -v date="$DATE" '
+            /^## \[Unreleased\]/ {
+              print "## [Unreleased]"; print ""; print "## [" ver "] - " date; next
+            }
+            { print }
+          ' CHANGELOG.md > CHANGELOG.md.new
+          mv CHANGELOG.md.new CHANGELOG.md
+
+      - name: Bump version strings
+        env:
+          VERSION: ${{ steps.ver.outputs.version }}
+        run: |
+          set -euo pipefail
+          V='[0-9]+\.[0-9]+\.[0-9]+'
+          sed -i -E "s/^version = \"$V\"/version = \"$VERSION\"/" pyproject.toml
+          sed -i -E "s/^__version__ = \"$V\"/__version__ = \"$VERSION\"/" src/whiskerless/__init__.py
+          sed -i -E "s/\"version\": \"$V\"/\"version\": \"$VERSION\"/" custom_components/whiskerless/manifest.json
+          sed -i -E "s/\"whiskerless==$V\"/\"whiskerless==$VERSION\"/" custom_components/whiskerless/manifest.json
+          git --no-pager diff
+
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.12"
+      - name: Test gate
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev,ble]"
+          ruff check src custom_components tests
+          mypy
+          pytest -q
+
+      - name: Commit, tag, push
+        env:
+          VERSION: ${{ steps.ver.outputs.version }}
+          TAG: ${{ steps.ver.outputs.tag }}
+          TOKEN: ${{ secrets.CLUSTER_FORGEJO_REPO_WRITE_PAT }}
+        run: |
+          set -euo pipefail
+          git add CHANGELOG.md pyproject.toml src/whiskerless/__init__.py custom_components/whiskerless/manifest.json
+          git commit -m "release: ${VERSION}"
+          git tag "${TAG}"
+          AUTH_B64=$(printf 'x-access-token:%s' "$TOKEN" | base64 | tr -d '\n')
+          git -c "http.extraheader=Authorization: Basic ${AUTH_B64}" push origin "HEAD:${{ github.ref_name }}"
+          git -c "http.extraheader=Authorization: Basic ${AUTH_B64}" push origin "${TAG}"

whiskerless-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,38 @@
+name: Bug report
+description: Something isn't working
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: Thanks for reporting! Please include enough detail to reproduce.
+  - type: input
+    id: version
+    attributes:
+      label: whiskerless version
+      placeholder: "0.1.0 (and HA version if relevant)"
+    validations:
+      required: true
+  - type: dropdown
+    id: surface
+    attributes:
+      label: Which part?
+      options:
+        - Home Assistant integration
+        - CLI / library
+        - BLE re-provisioning
+        - Documentation
+    validations:
+      required: true
+  - type: input
+    id: firmware
+    attributes:
+      label: Robot firmware version
+      description: From the "Refresh"/version report, e.g. ESP 1.1.75.
+      placeholder: "1.1.75"
+  - type: textarea
+    id: what
+    attributes:
+      label: What happened?
+      description: What you did, what you expected, what you got. Include logs (redact your serial).
+    validations:
+      required: true

whiskerless-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Documentation
+    url: https://github.com/SisyphusMD/whiskerless/tree/main/docs
+    about: Setup, protocol reference, and recovery guides.

whiskerless-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,22 @@
+---
+name: Feature request
+about: Suggest an improvement or a new capability
+title: "[feature] "
+labels: enhancement
+---
+
+## What would you like?
+
+<!-- A clear description of the feature or improvement. -->
+
+## Why
+
+<!-- The problem it solves or the use case it enables. -->
+
+## Notes
+
+<!--
+If it involves a new device action that isn't supported yet (power, empty, reset),
+please use the "Protocol capture" template instead — a captured payload is what
+unblocks those.
+-->

whiskerless-0.1.0/.github/ISSUE_TEMPLATE/protocol_contribution.yml

@@ -0,0 +1,49 @@
+name: Protocol finding (help crack the missing commands)
+description: Share a captured command or a confirmed register so we can close an open item
+labels: ["protocol"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Some actions are deliberately **not** exposed yet — power on/off, the empty
+        cycle, and the panel/drawer resets — because we couldn't pin their exact
+        register+value to safe, proven confidence (see
+        [compatibility.md](../../docs/devices/litter-robot-4/compatibility.md)).
+
+        The zero-risk way to crack one: subscribe to your own broker's
+        `prod/LR4/<serial>/command` topic, press the button in the **Whisker app**,
+        and capture the literal `{"serial","data":["0x02RRVVVV"]}` it publishes.
+        That gives the register+value with no motor or brick risk. Share it here!
+  - type: dropdown
+    id: action
+    attributes:
+      label: Which action did you capture?
+      options:
+        - powerOn
+        - powerOff
+        - emptyCycle
+        - shortResetPress (panel reset)
+        - reset waste drawer
+        - other / a new register
+    validations:
+      required: true
+  - type: input
+    id: firmware
+    attributes:
+      label: Robot firmware version
+      placeholder: "ESP 1.1.75"
+    validations:
+      required: true
+  - type: textarea
+    id: payload
+    attributes:
+      label: The captured command payload(s)
+      description: The exact `0x...` codes the app published, and how you captured them.
+      placeholder: '{"serial":"LR4Cxxxxxx","data":["0x02300001"]}'
+    validations:
+      required: true
+  - type: textarea
+    id: effect
+    attributes:
+      label: Observed effect
+      description: What the robot did, and any before/after state (e.g. unitPowerStatus, odometer counts).

whiskerless-0.1.0/.github/workflows/hassfest.yml

@@ -0,0 +1,23 @@
+name: Validate (hassfest)
+
+# hassfest is a GitHub-ecosystem action that the Forgejo runner can't fetch (it
+# resolves actions from data.forgejo.org, which has no home-assistant/actions). So
+# it runs only on GitHub; the guard makes Forgejo skip the job — Forgejo reads
+# .github/workflows too, but evaluates the job `if` before fetching the action.
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  hassfest:
+    name: hassfest (HA manifest validation)
+    if: ${{ github.server_url == 'https://github.com' }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: home-assistant/actions/hassfest@f4ca6f671bd429efb108c0f2fa0ae8af0215986c # master

whiskerless-0.1.0/.github/workflows/release-macos.yml

@@ -0,0 +1,100 @@
+name: Release (macOS pkg)
+
+# The one job that needs a Mac, so it lives on the GitHub mirror (free hosted
+# macOS runners). It builds the signed + notarized .pkg and appends it to the
+# GitHub + public-Forgejo releases — the only two it can reach. Forgejo's
+# publish.yml created those releases (with the Linux binary + notes) and bridges
+# the .pkg on to the internal NAS. See packaging/README.md for the secrets.
+on:
+  push:
+    tags: ["v*.*.*"]
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    name: Build signed pkg (${{ matrix.arch }})
+    # Forgejo Actions also reads .github/workflows, but has no macOS runner — so
+    # only run on GitHub (server_url is the Forgejo instance URL on Forgejo).
+    if: ${{ github.server_url == 'https://github.com' }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-14
+            arch: arm64
+          - os: macos-13
+            arch: x86_64
+    env:
+      APP_CERT_P12: ${{ secrets.MACOS_APP_CERT_P12 }}
+      INSTALLER_CERT_P12: ${{ secrets.MACOS_INSTALLER_CERT_P12 }}
+      CERT_PASSWORD: ${{ secrets.MACOS_CERT_PASSWORD }}
+      APP_IDENTITY: ${{ secrets.MACOS_APP_IDENTITY }}
+      INSTALLER_IDENTITY: ${{ secrets.MACOS_INSTALLER_IDENTITY }}
+      NOTARY_KEY_P8: ${{ secrets.MACOS_NOTARY_KEY_P8 }}
+      NOTARY_KEY_ID: ${{ secrets.MACOS_NOTARY_KEY_ID }}
+      NOTARY_ISSUER: ${{ secrets.MACOS_NOTARY_ISSUER }}
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.12"
+      - name: Build the binary
+        run: |
+          python -m pip install --upgrade pip pyinstaller
+          python -m pip install ".[ble]"
+          pyinstaller --onefile --name whiskerless \
+            --collect-all bleak --collect-all aiomqtt packaging/launcher.py
+      - name: Import signing certificates
+        run: |
+          KEYCHAIN="$RUNNER_TEMP/build.keychain"
+          security create-keychain -p "" "$KEYCHAIN"
+          security default-keychain -s "$KEYCHAIN"
+          security unlock-keychain -p "" "$KEYCHAIN"
+          echo "$APP_CERT_P12" | base64 -d > app.p12
+          echo "$INSTALLER_CERT_P12" | base64 -d > installer.p12
+          security import app.p12 -k "$KEYCHAIN" -P "$CERT_PASSWORD" -T /usr/bin/codesign
+          security import installer.p12 -k "$KEYCHAIN" -P "$CERT_PASSWORD" -T /usr/bin/productsign
+          security set-key-partition-list -S apple-tool:,apple: -s -k "" "$KEYCHAIN"
+      - name: Sign, package, notarize, staple
+        run: |
+          set -euo pipefail
+          PKG="whiskerless-macos-${{ matrix.arch }}.pkg"
+          codesign --force --options runtime --timestamp \
+            --entitlements packaging/entitlements.plist --sign "$APP_IDENTITY" dist/whiskerless
+          mkdir -p root/usr/local/bin
+          cp dist/whiskerless root/usr/local/bin/whiskerless
+          pkgbuild --root root --identifier com.sisyphusmd.whiskerless \
+            --version "${GITHUB_REF_NAME#v}" --install-location / unsigned.pkg
+          productsign --sign "$INSTALLER_IDENTITY" unsigned.pkg "$PKG"
+          echo "$NOTARY_KEY_P8" | base64 -d > notary.p8
+          xcrun notarytool submit "$PKG" \
+            --key notary.p8 --key-id "$NOTARY_KEY_ID" --issuer "$NOTARY_ISSUER" --wait
+          xcrun stapler staple "$PKG"
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: pkg-${{ matrix.arch }}
+          path: whiskerless-macos-${{ matrix.arch }}.pkg
+
+  publish:
+    name: Append the signed .pkg to the GitHub + Forgejo releases
+    if: ${{ github.server_url == 'https://github.com' }}
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          path: pkgs
+          merge-multiple: true
+      - name: Release notes from CHANGELOG
+        run: bash packaging/changelog-section.sh "${GITHUB_REF_NAME#v}" > notes.md
+      - name: Append the .pkg to the GitHub + public-Forgejo releases
+        run: |
+          chmod +x packaging/github-release.sh packaging/forgejo-release.sh
+          packaging/github-release.sh "${{ secrets.GITHUB_TOKEN }}" \
+            "$GITHUB_REF_NAME" notes.md pkgs/*.pkg
+          packaging/forgejo-release.sh forgejo.bryantserver.com \
+            "${{ secrets.CLUSTER_FORGEJO_REPO_WRITE_PAT }}" "$GITHUB_REF_NAME" notes.md pkgs/*.pkg

whiskerless-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+
+# Tooling caches
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Local scratch / research notes (not shipped)
+.research/
+
+# Operator-only mirror bootstrap (embeds private Forgejo hostnames) — keep local
+/scripts/setup-mirrors.sh
+
+# Secrets & device-specific material — NEVER commit these
+*.pem
+*.key
+ca.crt
+secrets.yaml
+
+# OS
+.DS_Store

whiskerless-0.1.0/.renovaterc.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": ["config:recommended"],
+  "gitAuthor": "Renovate Bot <renovate@users.noreply.github.com>",
+  "prConcurrentLimit": 0,
+  "prHourlyLimit": 0,
+  "separateMinorPatch": true,
+  "enabledManagers": ["pep621", "github-actions", "pip_requirements"],
+  "packageRules": [
+    {
+      "description": "Automerge patch + digest bumps; minor/major reviewed manually.",
+      "matchUpdateTypes": ["patch", "digest"],
+      "automerge": true
+    },
+    {
+      "description": "Keep the integration's pinned lib requirement in lockstep manually.",
+      "matchFileNames": ["custom_components/whiskerless/manifest.json"],
+      "enabled": false
+    }
+  ]
+}

whiskerless-0.1.0/CHANGELOG.md

@@ -0,0 +1,35 @@
+# 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).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-06-29
+
+### Added
+
+- **`whiskerless` Python library** — fully-local MQTT control + telemetry for the
+  Whisker Litter-Robot 4:
+  - LR4 wire codec, command catalog, and a typed state model that decodes both raw
+    firmware integers and cloud-style strings defensively.
+  - A push-first `LitterRobot4Client` with a self-healing MQTT connection and
+    write → read-back → retry for the firmware's commit-latency registers.
+  - Device-agnostic BLE (esp-idf protocomm) re-provisioning with a self-contained
+    pure-Python protobuf codec (no `protoc` build step).
+  - A `safety` guard that refuses brick/reset-class commands (`0xAC`/`0xA4`/`0xAD`)
+    unconditionally and gates motor / untraced commands.
+- **`whiskerless` CLI** — `provision`, `monitor`, `state`, `read`, `set`,
+  `clean-cycle`, and a guarded raw `send`.
+- **Home Assistant integration** (HACS) built to Platinum standards: fully async,
+  fully typed, `local_push`, with **MQTT discovery** (robots appear as Add/Ignore
+  cards), diagnostics, translations, and per-robot config entries (any number of
+  robots).
+- **Documentation** — protocol reference, register map, command catalog,
+  compatibility matrix, setup guides, recovery guide, and the reverse-engineering
+  writeup.
+- **Standalone CLI binaries** built on release for users who want the BLE
+  re-provisioner without installing Python.
+
+[Unreleased]: https://github.com/SisyphusMD/whiskerless/commits/main