docs: add maintenance guide; fix AppImage version selection; bump to 1.1.0

- Add MAINTENANCE.md (dependency updates, EOL watch, build/smoke-test
  workflows, orientation-fix invariants)
- Remove AGENTS.md; fold its unique context into MAINTENANCE.md
- Add .venv/.posit/appimage to .dockerignore to shrink build context
- Fix build-appimage.sh to select the wheel matching pyproject.toml
  version instead of alphabetically-first (bundled stale 1.0.0 code)
- Bump version 1.0.0 -> 1.1.0 in pyproject.toml, uv.lock, AppImage recipe

packaging/appimage/AppImageBuilder.yml

@@ -6,7 +6,7 @@ AppDir:
     id: scanslicer
     name: ScanSlicer
     icon: scanslicer
-    version: "1.0.0"
+    version: "1.1.0"
     exec: usr/bin/python3
     exec_args: "-m scanslicer $@"
 

packaging/appimage/build-appimage.sh

@@ -28,11 +28,25 @@ uv export \
   --no-emit-project \
   --format requirements-txt \
   --output-file "${BUILD_DIR}/requirements.txt"
+# Remove stale wheels from previous versions so a version-specific lookup
+# below cannot accidentally pick up an outdated build artifact.
+rm -f "${BUILD_DIR}"/scanslicer-*.whl
 uv build --wheel --out-dir "${BUILD_DIR}"
 
-WHEEL_PATH="$(ls -1 "${BUILD_DIR}"/scanslicer-*.whl | head -n 1)"
-if [[ -z "${WHEEL_PATH}" ]]; then
-    echo "Could not find built wheel in ${BUILD_DIR}" >&2
+# Select the wheel matching the project version from pyproject.toml. Listing
+# with `ls` and taking the first result breaks once an older wheel for a
+# previous version is left in the build dir, because `ls` sorts
+# alphabetically and would pick the stale artifact.
+PROJECT_VERSION="$(sed -n 's/^version *= *"\([^"]*\)".*/\1/p' "${ROOT_DIR}/pyproject.toml" | head -n 1)"
+if [[ -z "${PROJECT_VERSION}" ]]; then
+    echo "Could not determine project version from pyproject.toml" >&2
+    exit 1
+fi
+WHEEL_PATH="${BUILD_DIR}/scanslicer-${PROJECT_VERSION}-py3-none-any.whl"
+if [[ ! -f "${WHEEL_PATH}" ]]; then
+    echo "Could not find built wheel for version ${PROJECT_VERSION} in ${BUILD_DIR}" >&2
+    echo "Found wheels:" >&2
+    ls -1 "${BUILD_DIR}"/scanslicer-*.whl >&2 || true
     exit 1
 fi