plex-tui 0.3.0__tar.gz → 0.3.6__tar.gz

{plex_tui-0.3.0 → plex_tui-0.3.6}/.github/workflows/aur.yml

@@ -43,7 +43,7 @@ jobs:
       - name: Generate .SRCINFO
         working-directory: packaging/aur
         run: |
-          sudo -u builder makepkg --printsrcinfo > .SRCINFO.generated
+          sudo -u builder makepkg --printsrcinfo | sudo -u builder tee .SRCINFO.generated > /dev/null
           diff -u .SRCINFO .SRCINFO.generated
 
       - name: Run namcap

plex_tui-0.3.6/.github/workflows/post-release-aur.yml

@@ -0,0 +1,141 @@
+name: Post-release AUR Update
+
+on:
+  workflow_run:
+    workflows: ["Version Bump and Release"]
+    types: ["completed"]
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Release tag to package, such as v0.3.0. Defaults to the latest GitHub Release."
+        required: false
+        type: string
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  aur-pr:
+    if: github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - name: Check packaging PR token
+        env:
+          PACKAGING_PR_TOKEN: ${{ secrets.PACKAGING_PR_TOKEN }}
+        run: |
+          if [ -z "$PACKAGING_PR_TOKEN" ]; then
+            echo "PACKAGING_PR_TOKEN secret is required to create, approve, and auto-merge packaging PRs" >&2
+            exit 1
+          fi
+
+      - name: Determine release tag
+        id: release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          REQUESTED_TAG: ${{ github.event.inputs.tag }}
+        run: |
+          set -euo pipefail
+
+          if [ -n "$REQUESTED_TAG" ]; then
+            tag="$REQUESTED_TAG"
+          else
+            tag="$(gh release list --limit 1 --json tagName --jq '.[0].tagName')"
+          fi
+
+          if ! [[ "$tag" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "Release tag must look like vX.Y.Z: $tag" >&2
+            exit 1
+          fi
+
+          version="${tag#v}"
+          echo "tag=$tag" >> "$GITHUB_OUTPUT"
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+
+      - name: Download source archive and checksum
+        id: archive
+        env:
+          TAG: ${{ steps.release.outputs.tag }}
+        run: |
+          set -euo pipefail
+
+          url="https://github.com/${GITHUB_REPOSITORY}/archive/refs/tags/${TAG}.tar.gz"
+          curl --fail --location --retry 5 --retry-delay 2 --output source.tar.gz "$url"
+          sha256="$(sha256sum source.tar.gz | awk '{print $1}')"
+          echo "sha256=$sha256" >> "$GITHUB_OUTPUT"
+
+      - name: Update PKGBUILD
+        run: |
+          python scripts/update_aur_package.py \
+            "${{ steps.release.outputs.version }}" \
+            "${{ steps.archive.outputs.sha256 }}"
+
+      - name: Regenerate and validate AUR package
+        run: |
+          set -euo pipefail
+
+          docker run --rm \
+            -v "$PWD:/workspace" \
+            -w /workspace/packaging/aur \
+            archlinux:base-devel \
+            bash -lc '
+              set -euo pipefail
+              pacman -Syu --noconfirm git namcap sudo
+              useradd --create-home --shell /bin/bash builder
+              echo "builder ALL=(ALL) NOPASSWD: ALL" > /etc/sudoers.d/builder
+              chown -R builder:builder /workspace/packaging/aur
+              sudo -u builder makepkg --printsrcinfo | sudo -u builder tee .SRCINFO > /dev/null
+              sudo -u builder makepkg --clean --syncdeps --noconfirm --check
+              namcap PKGBUILD ./*.pkg.tar.*
+            '
+
+          sudo chown -R "$(id -u):$(id -g)" packaging/aur
+
+      - name: Remove generated package artifacts
+        run: |
+          rm -f source.tar.gz
+          find packaging/aur -maxdepth 1 -type f \
+            \( -name "*.pkg.tar.*" -o -name "*.tar.gz" \) \
+            -delete
+
+      - name: Create packaging pull request
+        id: create-pr
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.PACKAGING_PR_TOKEN }}
+          branch: automation/aur-${{ steps.release.outputs.tag }}
+          delete-branch: true
+          commit-message: Update AUR package to ${{ steps.release.outputs.tag }}
+          title: Update AUR package to ${{ steps.release.outputs.tag }}
+          body: |
+            Updates Arch AUR packaging metadata for `${{ steps.release.outputs.tag }}`.
+
+            Validation performed by this workflow:
+            - downloaded the release source archive and computed the sha256
+            - regenerated `packaging/aur/.SRCINFO`
+            - ran `makepkg --clean --syncdeps --noconfirm --check`
+            - ran `namcap`
+
+            This is a packaging-only PR and intentionally has no semver bump marker.
+
+      - name: Approve packaging pull request
+        if: steps.create-pr.outputs.pull-request-number != ''
+        env:
+          GH_TOKEN: ${{ secrets.PACKAGING_PR_TOKEN }}
+          PR_NUMBER: ${{ steps.create-pr.outputs.pull-request-number }}
+        run: |
+          gh pr review "$PR_NUMBER" --approve
+
+      - name: Enable packaging pull request auto-merge
+        if: steps.create-pr.outputs.pull-request-number != ''
+        env:
+          GH_TOKEN: ${{ secrets.PACKAGING_PR_TOKEN }}
+          PR_NUMBER: ${{ steps.create-pr.outputs.pull-request-number }}
+        run: |
+          gh pr merge "$PR_NUMBER" --auto --squash --delete-branch

plex_tui-0.3.6/.github/workflows/post-release-homebrew.yml

@@ -0,0 +1,129 @@
+name: Post-release Homebrew Publish
+
+on:
+  workflow_run:
+    workflows: ["Version Bump and Release"]
+    types: ["completed"]
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Release tag to package, such as v0.3.0. Defaults to the latest GitHub Release."
+        required: false
+        type: string
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  publish-tap:
+    if: github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success'
+    runs-on: macos-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Check packaging PR token
+        env:
+          PACKAGING_PR_TOKEN: ${{ secrets.PACKAGING_PR_TOKEN }}
+        run: |
+          if [ -z "$PACKAGING_PR_TOKEN" ]; then
+            echo "PACKAGING_PR_TOKEN secret is required to publish the Homebrew tap" >&2
+            exit 1
+          fi
+
+      - name: Determine release tag
+        id: release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          REQUESTED_TAG: ${{ github.event.inputs.tag }}
+        run: |
+          set -euo pipefail
+
+          if [ -n "$REQUESTED_TAG" ]; then
+            tag="$REQUESTED_TAG"
+          else
+            tag="$(gh release list --limit 1 --json tagName --jq '.[0].tagName')"
+          fi
+
+          if ! [[ "$tag" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "Release tag must look like vX.Y.Z: $tag" >&2
+            exit 1
+          fi
+
+          version="${tag#v}"
+          echo "tag=$tag" >> "$GITHUB_OUTPUT"
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+
+      - name: Tap Homebrew repository
+        id: tap
+        env:
+          PACKAGING_PR_TOKEN: ${{ secrets.PACKAGING_PR_TOKEN }}
+        run: |
+          brew tap so1omon563/plex-tui "https://x-access-token:${PACKAGING_PR_TOKEN}@github.com/so1omon563/homebrew-plex-tui.git"
+          echo "path=$(brew --repo so1omon563/plex-tui)" >> "$GITHUB_OUTPUT"
+
+      - name: Update formula source
+        run: |
+          python scripts/update_homebrew_formula.py \
+            "${{ steps.tap.outputs.path }}/Formula/plex-tui.rb" \
+            "${{ steps.release.outputs.version }}"
+
+      - name: Audit formula
+        working-directory: ${{ steps.tap.outputs.path }}
+        run: |
+          brew audit --strict --online so1omon563/plex-tui/plex-tui
+
+      - name: Commit tap update
+        id: commit
+        working-directory: ${{ steps.tap.outputs.path }}
+        env:
+          VERSION: ${{ steps.release.outputs.version }}
+        run: |
+          set -euo pipefail
+
+          if git diff --quiet -- Formula/plex-tui.rb; then
+            echo "changed=false" >> "$GITHUB_OUTPUT"
+            echo "Homebrew tap is already up to date."
+            exit 0
+          fi
+
+          branch="automation/plex-tui-v${VERSION}"
+          git switch -c "$branch"
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add Formula/plex-tui.rb
+          git commit -m "Update plex-tui to ${VERSION}"
+          git push origin "$branch"
+
+          echo "changed=true" >> "$GITHUB_OUTPUT"
+          echo "branch=$branch" >> "$GITHUB_OUTPUT"
+
+      - name: Open and merge tap pull request
+        if: steps.commit.outputs.changed == 'true'
+        working-directory: ${{ steps.tap.outputs.path }}
+        env:
+          GH_TOKEN: ${{ secrets.PACKAGING_PR_TOKEN }}
+          VERSION: ${{ steps.release.outputs.version }}
+          BRANCH: ${{ steps.commit.outputs.branch }}
+        run: |
+          set -euo pipefail
+
+          pr_url="$(gh pr create \
+            --repo so1omon563/homebrew-plex-tui \
+            --base main \
+            --head "$BRANCH" \
+            --title "Update plex-tui to ${VERSION}" \
+            --body "Automated Homebrew tap update for plex-tui ${VERSION}.")"
+
+          gh pr merge "$pr_url" \
+            --repo so1omon563/homebrew-plex-tui \
+            --squash \
+            --delete-branch

plex_tui-0.3.6/.github/workflows/publish-aur.yml

@@ -0,0 +1,102 @@
+name: Publish AUR Package
+
+on:
+  workflow_run:
+    workflows: ["AUR Package"]
+    types: ["completed"]
+  workflow_dispatch:
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  publish:
+    if: |
+      github.event_name == 'workflow_dispatch' ||
+      (
+        github.event.workflow_run.conclusion == 'success' &&
+        github.event.workflow_run.head_branch == 'main' &&
+        github.event.workflow_run.event == 'push'
+      )
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+        with:
+          ref: ${{ github.event.workflow_run.head_sha || github.sha }}
+
+      - name: Read package version
+        id: package
+        run: |
+          set -euo pipefail
+
+          version="$(sed -n 's/^pkgver=//p' packaging/aur/PKGBUILD)"
+          release="$(sed -n 's/^pkgrel=//p' packaging/aur/PKGBUILD)"
+
+          if ! [[ "$version" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "pkgver must look like X.Y.Z: $version" >&2
+            exit 1
+          fi
+          if ! [[ "$release" =~ ^[0-9]+$ ]]; then
+            echo "pkgrel must be numeric: $release" >&2
+            exit 1
+          fi
+
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+          echo "release=$release" >> "$GITHUB_OUTPUT"
+
+      - name: Configure AUR SSH
+        env:
+          AUR_SSH_PRIVATE_KEY: ${{ secrets.AUR_SSH_PRIVATE_KEY }}
+        run: |
+          set -euo pipefail
+
+          if [ -z "$AUR_SSH_PRIVATE_KEY" ]; then
+            echo "AUR_SSH_PRIVATE_KEY secret is required to publish to AUR" >&2
+            exit 1
+          fi
+
+          install -m 700 -d ~/.ssh
+          printf '%s\n' "$AUR_SSH_PRIVATE_KEY" > ~/.ssh/aur
+          chmod 600 ~/.ssh/aur
+          ssh-keyscan -H aur.archlinux.org >> ~/.ssh/known_hosts
+
+          cat > ~/.ssh/config <<'EOF'
+          Host aur.archlinux.org
+            IdentityFile ~/.ssh/aur
+            IdentitiesOnly yes
+            User aur
+          EOF
+          chmod 600 ~/.ssh/config
+
+      - name: Clone AUR package repository
+        run: |
+          git clone ssh://aur@aur.archlinux.org/plex-tui.git aur-package
+
+      - name: Copy package metadata
+        run: |
+          cp packaging/aur/PKGBUILD aur-package/PKGBUILD
+          cp packaging/aur/.SRCINFO aur-package/.SRCINFO
+
+      - name: Commit and push AUR package
+        working-directory: aur-package
+        env:
+          VERSION: ${{ steps.package.outputs.version }}
+          RELEASE: ${{ steps.package.outputs.release }}
+        run: |
+          set -euo pipefail
+
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+          if git diff --quiet -- PKGBUILD .SRCINFO; then
+            echo "AUR package repository is already up to date."
+            exit 0
+          fi
+
+          git add PKGBUILD .SRCINFO
+          git commit -m "Update to ${VERSION}-${RELEASE}"
+          git push origin master

{plex_tui-0.3.0 → plex_tui-0.3.6}/AGENTS.md

@@ -83,6 +83,20 @@ Use PRs for repository changes. When publishing local commits, branch from
 open a draft PR instead of pushing directly to `main`. Treat `main` as a
 protected branch even before GitHub branch protection or rulesets are enabled.
 
+By default, PR titles or bodies should include exactly one semver bump marker:
+`#patch`, `#minor`, or `#major`. Most changes should advance tags when merged,
+even when they do not publish a GitHub Release. Add `#release` only when the
+merge should create the GitHub Release and publish package channels. Exceptions
+are allowed for packaging-only follow-ups, automation repair, docs-only
+maintenance, or other changes that should not create a new version tag; call out
+the reason in the PR body when omitting a bump marker.
+
+When preparing or estimating a release version, fetch remote tags first with
+`git fetch --tags origin` and base the decision on the latest origin tag, not
+only local tags or the latest GitHub Release. Non-release PRs with `#patch`,
+`#minor`, or `#major` still create tags, so release prep files should match the
+tag that the release PR merge will create.
+
 GitHub CLI notes:
 
 - `gh auth status` may fail inside the sandbox even when the user is logged in

{plex_tui-0.3.0 → plex_tui-0.3.6}/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## Unreleased
 
+## 0.3.6 - 2026-06-12
+
+- Polished grid cards so poster placeholders, cached artwork, titles,
+  subtitles, and selected status align more evenly in the media pane.
+- Improved the details pane hierarchy with clearer playback readiness,
+  explicit empty metadata/stream states, tighter preference rows, and wrapped
+  summaries.
+- Improved Settings detail feedback with consistent controls guidance, clearer
+  armed-confirmation text, and more useful saved-setting summaries.
+- Polished playback diagnostics with clearer active playback status, structured
+  playback error details, and more direct debug-log follow-up guidance.
+- Added shieldcn.dev README badges for CI, release, PyPI, AUR, Homebrew tap,
+  and license status.
+- Documented release-prep guidance for fetching origin tags before deciding the
+  next release version.
+
 ## 0.3.0 - 2026-06-12
 
 - Added `plex-tui --diagnostics` for collecting environment and playback setup details.

{plex_tui-0.3.0 → plex_tui-0.3.6}/PACKAGING.md

@@ -90,13 +90,25 @@ Validation is handled by `.github/workflows/aur.yml`, which runs inside
 For each new app release:
 
 1. Publish and validate PyPI.
-2. Update the Homebrew tap formula URL/hash and Python resources.
-3. Update `packaging/aur/PKGBUILD` and `packaging/aur/.SRCINFO`.
-4. Run packaging validation workflows.
-5. Push the AUR package repo update after the workflow passes.
+2. Let the `Post-release Homebrew Publish` workflow update, validate, and merge
+   the Homebrew tap formula.
+3. Let the `Post-release AUR Update` workflow update AUR metadata, open the
+   packaging PR, approve it, and enable auto-merge.
+4. After the packaging PR merges and the `AUR Package` workflow passes on
+   `main`, the `Publish AUR Package` workflow pushes the validated `PKGBUILD`
+   and `.SRCINFO` to AUR.
+
+The AUR automation requires:
+
+- `PACKAGING_PR_TOKEN`: a token that can create, approve, and auto-merge the
+  generated packaging PR when branch protection requires those actions.
+- `AUR_SSH_PRIVATE_KEY`: the private SSH key for pushing to
+  `ssh://aur@aur.archlinux.org/plex-tui.git`.
+
+The Homebrew automation uses `PACKAGING_PR_TOKEN`; that token must also be able
+to push branches and merge pull requests in `so1omon563/homebrew-plex-tui`.
 
 ## Known Follow-Up
 
-- Automate Homebrew tap updates after PyPI publishing.
 - Investigate faster Homebrew installs without compromising formula quality.
 - Consider standalone artifacts only after the app behavior stabilizes.

{plex_tui-0.3.0 → plex_tui-0.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plex-tui
-Version: 0.3.0
+Version: 0.3.6
 Summary: A small standalone Plex terminal UI.
 Project-URL: Homepage, https://github.com/so1omon563/plex-tui
 Project-URL: Issues, https://github.com/so1omon563/plex-tui/issues
@@ -36,6 +36,13 @@ Description-Content-Type: text/markdown
 
 # plex-tui
 
+[![CI](https://shieldcn.dev/github/so1omon563/plex-tui/ci.png)](https://github.com/so1omon563/plex-tui/actions/workflows/ci.yml)
+[![Release](https://shieldcn.dev/github/so1omon563/plex-tui/release.png)](https://github.com/so1omon563/plex-tui/releases/latest)
+[![PyPI](https://shieldcn.dev/badge/dynamic/json.png?url=https%3A%2F%2Fpypi.org%2Fpypi%2Fplex-tui%2Fjson&query=%24.info.version&label=PyPI&logo=pypi)](https://pypi.org/project/plex-tui/)
+[![AUR](https://shieldcn.dev/badge/dynamic/json.png?url=https%3A%2F%2Faur.archlinux.org%2Frpc%2Fv5%2Finfo%2Fplex-tui&query=%24.results%5B0%5D.Version&label=AUR&logo=archlinux)](https://aur.archlinux.org/packages/plex-tui)
+[![Homebrew](https://shieldcn.dev/badge/Homebrew-tap-blue.png?logo=homebrew)](https://github.com/so1omon563/homebrew-plex-tui)
+[![License](https://shieldcn.dev/github/so1omon563/plex-tui/license.png)](LICENSE)
+
 A standalone Python/Textual terminal UI for browsing Plex and launching playback
 through `mpv`.
 

{plex_tui-0.3.0 → plex_tui-0.3.6}/README.md

@@ -1,5 +1,12 @@
 # plex-tui
 
+[![CI](https://shieldcn.dev/github/so1omon563/plex-tui/ci.png)](https://github.com/so1omon563/plex-tui/actions/workflows/ci.yml)
+[![Release](https://shieldcn.dev/github/so1omon563/plex-tui/release.png)](https://github.com/so1omon563/plex-tui/releases/latest)
+[![PyPI](https://shieldcn.dev/badge/dynamic/json.png?url=https%3A%2F%2Fpypi.org%2Fpypi%2Fplex-tui%2Fjson&query=%24.info.version&label=PyPI&logo=pypi)](https://pypi.org/project/plex-tui/)
+[![AUR](https://shieldcn.dev/badge/dynamic/json.png?url=https%3A%2F%2Faur.archlinux.org%2Frpc%2Fv5%2Finfo%2Fplex-tui&query=%24.results%5B0%5D.Version&label=AUR&logo=archlinux)](https://aur.archlinux.org/packages/plex-tui)
+[![Homebrew](https://shieldcn.dev/badge/Homebrew-tap-blue.png?logo=homebrew)](https://github.com/so1omon563/homebrew-plex-tui)
+[![License](https://shieldcn.dev/github/so1omon563/plex-tui/license.png)](LICENSE)
+
 A standalone Python/Textual terminal UI for browsing Plex and launching playback
 through `mpv`.
 

{plex_tui-0.3.0 → plex_tui-0.3.6}/RELEASE.md

@@ -100,24 +100,41 @@ python -m venv /tmp/plex-tui-pypi
 
 ## 6. Homebrew Tap
 
-Update `so1omon563/homebrew-plex-tui`:
+The `Post-release Homebrew Publish` workflow updates
+`so1omon563/homebrew-plex-tui` after a successful release workflow. It can also
+be run manually with a release tag. The workflow updates:
 
 - Formula URL and sha256.
 - Python resource blocks if dependencies changed.
 - Formula test expectations if version output changed.
 
-Validate:
+It then runs `brew audit --strict --online`, opens a tap PR, and merges it. This
+uses `PACKAGING_PR_TOKEN`, which must have access to the tap repository.
+
+If the automated workflow cannot run, update and validate manually:
 
 ```bash
 brew test so1omon563/plex-tui/plex-tui
 brew audit --strict --online so1omon563/plex-tui/plex-tui
 ```
 
-Open this as a packaging-only PR without a semver bump marker.
+Open tap updates as packaging-only PRs without semver bump markers.
 
 ## 7. Arch AUR
 
-Update `packaging/aur/PKGBUILD` and regenerate `.SRCINFO`:
+The `Post-release AUR Update` workflow opens a packaging-only PR after a
+successful release workflow. It can also be run manually with a release tag. The
+workflow updates `packaging/aur/PKGBUILD`, regenerates `.SRCINFO`, validates the
+package with `makepkg`, runs `namcap`, opens a PR without a semver bump marker,
+approves it, and enables auto-merge.
+
+After that PR merges, the `AUR Package` workflow validates the merged metadata
+on `main`. A successful `AUR Package` run triggers `Publish AUR Package`, which
+pushes `PKGBUILD` and `.SRCINFO` to `ssh://aur@aur.archlinux.org/plex-tui.git`.
+This requires the `AUR_SSH_PRIVATE_KEY` repository secret.
+
+If the automated workflow cannot run, update `packaging/aur/PKGBUILD` and
+regenerate `.SRCINFO` manually:
 
 ```bash
 cd packaging/aur
@@ -136,7 +153,8 @@ git commit -m "Update to X.Y.Z-1"
 git push
 ```
 
-Open this as a packaging-only PR without a semver bump marker.
+Open repository metadata updates as packaging-only PRs without semver bump
+markers.
 
 ## Manual Fallbacks
 

plex_tui-0.3.6/ROADMAP.md

@@ -0,0 +1,57 @@
+# Roadmap
+
+## App UX
+
+- Rework grid view presentation so poster/title blocks feel balanced across
+  terminal sizes. The current grid is functional but visually uneven: poster
+  blocks, titles, and pane content can look lopsided or off-center.
+- Continue tuning focus, row markers, and selection affordances based on real
+  terminal themes.
+- Polish the details pane hierarchy for long summaries, missing metadata, and
+  playback readiness hints.
+- Continue refining Settings ergonomics as new preferences are added, especially
+  grouping, current-value scanning, and change feedback.
+- Tune real-library browsing only when verification shows a specific issue; the
+  latest perf pass showed fast grid rendering and poster fetches dominated by
+  network/cache timing.
+- Tune grid artwork defaults such as `grid_prefetch_pages` only if future logs
+  show the current defaults are too aggressive or too conservative.
+- Consider separate poster-size controls only if density presets are not enough
+  after real-library verification.
+- Continue improving playback diagnostics as real-world `mpv` and Plex stream
+  failures show up in use.
+
+## Packaging & Distribution
+
+- Keep planned releases moving through PRs so merged release PRs drive automatic
+  tagging, GitHub Release creation, PyPI publishing, Homebrew tap publishing,
+  and AUR publishing.
+- Keep `main` protected in both `plex-tui` and `homebrew-plex-tui`; `plex-tui`
+  requires the Python 3.11 and 3.13 checks before merge.
+- Improve Homebrew install time; the current formula works but builds native
+  Python resources such as `pillow` from source.
+- Keep post-release package publishing fully automated across PyPI, Homebrew,
+  and AUR.
+- Consider standalone artifacts only after the app behavior stabilizes.
+
+## Plex Integration Research
+
+- Review the Plex module in
+  [`anthonycaccese/240-MP`](https://github.com/anthonycaccese/240-MP/tree/main)
+  for ideas that fit a terminal-first Plex client. Areas to evaluate include
+  profile switching, selective library display, Continue Watching/Resume, hubs,
+  playlists, collections, categories, movie editions, pre-play audio/subtitle
+  selection, alphabet browsing, show/season browsing, and direct-play versus
+  transcode quality choices.
+
+## Technical Follow-Up
+
+- Use `PLEX_TUI_PERF_LOG=1` for focused regression checks when changing grid,
+  artwork, pagination, or detail-loading behavior.
+- Revisit whether verbose `PLEX_TUI_ARTWORK_LOG=1` should expose more structured artwork counters.
+- Revisit native terminal image support with a Kitty Unicode-placeholder
+  prototype. Direct Kitty graphics protocol placement inside Textual caused UI
+  hangs, so any future implementation should transmit images quietly, render
+  normal placeholder text that Textual can redraw safely, and keep block art as
+  the mandatory fallback.
+- Add focused regression tests for any real-world Plex media edge cases discovered during use.

{plex_tui-0.3.0 → plex_tui-0.3.6}/packaging/aur/.SRCINFO

@@ -1,6 +1,6 @@
 pkgbase = plex-tui
 	pkgdesc = Standalone Plex terminal UI with mpv playback
-	pkgver = 0.2.1
+	pkgver = 0.3.0
 	pkgrel = 1
 	url = https://github.com/so1omon563/plex-tui
 	arch = any
@@ -17,7 +17,7 @@ pkgbase = plex-tui
 	depends = python-plexapi
 	depends = python-rich
 	depends = python-textual
-	source = plex-tui-0.2.1.tar.gz::https://github.com/so1omon563/plex-tui/archive/refs/tags/v0.2.1.tar.gz
-	sha256sums = f1b84354e5a0f7885fb7391d81f6d15ddece55822c8a5d5d08d01b4fadffbbeb
+	source = plex-tui-0.3.0.tar.gz::https://github.com/so1omon563/plex-tui/archive/refs/tags/v0.3.0.tar.gz
+	sha256sums = a8a9e104c97dcd57a1a1fc7e499a5afa32f86f11d14f79245f264335b36c97c0
 
 pkgname = plex-tui

{plex_tui-0.3.0 → plex_tui-0.3.6}/packaging/aur/PKGBUILD

@@ -1,6 +1,6 @@
 # Maintainer: so1omon
 pkgname=plex-tui
-pkgver=0.2.1
+pkgver=0.3.0
 pkgrel=1
 pkgdesc="Standalone Plex terminal UI with mpv playback"
 arch=("any")
@@ -23,7 +23,7 @@ makedepends=(
 )
 checkdepends=("python-pytest")
 source=("$pkgname-$pkgver.tar.gz::$url/archive/refs/tags/v$pkgver.tar.gz")
-sha256sums=("f1b84354e5a0f7885fb7391d81f6d15ddece55822c8a5d5d08d01b4fadffbbeb")
+sha256sums=("a8a9e104c97dcd57a1a1fc7e499a5afa32f86f11d14f79245f264335b36c97c0")
 
 build() {
   cd "$pkgname-$pkgver"

{plex_tui-0.3.0 → plex_tui-0.3.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "plex-tui"
-version = "0.3.0"
+version = "0.3.6"
 description = "A small standalone Plex terminal UI."
 readme = "README.md"
 license = "MIT"