riplex 0.9.7__tar.gz → 0.9.8__tar.gz

riplex-0.9.8/.github/contributors-overrides.json

@@ -0,0 +1,45 @@
+{
+  "include": [
+    {
+      "number": 1,
+      "reason": "Early unlabeled bug report that led to CLI/config handling fixes."
+    },
+    {
+      "number": 5,
+      "reason": "Bug report fixed through the dvdcompare-scraper dependency."
+    },
+    {
+      "number": 6,
+      "reason": "Bug report that led to Windows title sanitization fixes."
+    },
+    {
+      "number": 7,
+      "reason": "Bug report that led to Flet compatibility fixes."
+    },
+    {
+      "number": 8,
+      "reason": "Setup report that led to improved prerequisite documentation."
+    },
+    {
+      "number": 9,
+      "reason": "Bug report that led to dvdcompare caching and rate-limit mitigations."
+    },
+    {
+      "number": 11,
+      "reason": "Setup report that led to a friendlier missing-GUI-extra error."
+    },
+    {
+      "number": 16,
+      "reason": "Bug report that led to packaged-app SSL certificate handling improvements."
+    },
+    {
+      "number": 17,
+      "reason": "Bug report that led to clearer TMDb API credential handling."
+    },
+    {
+      "number": 20,
+      "reason": "Bug report that led to better installed-tool detection after winget installs."
+    }
+  ],
+  "exclude": []
+}

riplex-0.9.8/.github/workflows/update-contributors.yml

@@ -0,0 +1,43 @@
+name: Update Contributors
+
+on:
+  schedule:
+    - cron: "0 12 * * 1"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  update-contributors:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run updater tests
+        run: pytest tests/test_update_contributors.py -v
+
+      - name: Update contributors
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+        run: python scripts/update_contributors.py
+
+      - name: Create pull request
+        uses: peter-evans/create-pull-request@v6
+        with:
+          commit-message: chore: refresh CONTRIBUTORS.md
+          title: chore: refresh CONTRIBUTORS.md
+          body: |
+            Updates the generated Bug Bashers table in CONTRIBUTORS.md from closed issue reports.
+          branch: chore/update-contributors
+          delete-branch: true

riplex-0.9.8/CONTRIBUTORS.md

@@ -0,0 +1,23 @@
+# Contributors
+
+Thank you to everyone who helps make riplex better!
+
+## Bug Bashers
+
+These users have gone out of their way to report bugs, provide logs, and help
+us track down issues. We really appreciate it.
+
+> **Rank:** 🧪 Bug Spotter (1+) · 🐛 Bug Hunter (4+) · 🔍 Bug Detective (8+) · 🛡️ Bug Slayer (15+) · 💎 Legend (25+)
+
+<!-- BUG_BASHERS:START -->
+| User | Issues |
+|------|--------|
+| 🐛 [@JelloEmperor](https://github.com/JelloEmperor) | [#1](https://github.com/AnyCredit5518/riplex/issues/1), [#5](https://github.com/AnyCredit5518/riplex/issues/5), [#6](https://github.com/AnyCredit5518/riplex/issues/6), [#7](https://github.com/AnyCredit5518/riplex/issues/7), [#12](https://github.com/AnyCredit5518/riplex/issues/12) |
+| 🧪 [@titanzeonprime-lab](https://github.com/titanzeonprime-lab) | [#8](https://github.com/AnyCredit5518/riplex/issues/8), [#11](https://github.com/AnyCredit5518/riplex/issues/11) |
+| 🧪 [@bigswannyd](https://github.com/bigswannyd) | [#16](https://github.com/AnyCredit5518/riplex/issues/16) |
+| 🧪 [@darsovit](https://github.com/darsovit) | [#17](https://github.com/AnyCredit5518/riplex/issues/17) |
+| 🧪 [@LtKaneDagger](https://github.com/LtKaneDagger) | [#20](https://github.com/AnyCredit5518/riplex/issues/20) |
+| 🧪 [@nathanpyoung](https://github.com/nathanpyoung) | [#21](https://github.com/AnyCredit5518/riplex/issues/21) |
+| 🧪 [@nerdguy1338](https://github.com/nerdguy1338) | [#9](https://github.com/AnyCredit5518/riplex/issues/9) |
+| 🧪 [@TallGeekyCool](https://github.com/TallGeekyCool) | [#22](https://github.com/AnyCredit5518/riplex/issues/22) |
+<!-- BUG_BASHERS:END -->

{riplex-0.9.7/src/riplex.egg-info → riplex-0.9.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: riplex
-Version: 0.9.7
+Version: 0.9.8
 Summary: Automates the tedious manual work around MakeMKV: figuring out what to rip, which MKV files are actually what, and organizing everything into Plex-compatible folder structures.
 License: MIT
 Requires-Python: >=3.11

{riplex-0.9.7 → riplex-0.9.8}/issues/planned-features.md

@@ -117,35 +117,51 @@ subtitle tracks differ, we should:
 ## Automated Contributors List Updater
 
 `CONTRIBUTORS.md` lists community members who have helped riplex by reporting
-bugs (and eventually other contribution categories). Today it's hand-edited,
-which means it goes stale fast and we forget to credit people.
+bugs (and eventually other contribution categories). The Bug Bashers table used
+to be hand-edited, which meant it went stale fast and we forgot to credit
+people.
 
-### Plan
+### Status
+
+Implemented by `scripts/update_contributors.py`,
+`.github/contributors-overrides.json`, and
+`.github/workflows/update-contributors.yml`.
+
+The updater owns only the generated Bug Bashers table between
+`<!-- BUG_BASHERS:START -->` and `<!-- BUG_BASHERS:END -->`, while the
+surrounding prose stays hand-editable.
+
+### Implemented behavior
 
 1. **Script** — `scripts/update_contributors.py` that:
-   - Uses the GitHub REST API (via `requests` or `PyGithub`) to enumerate
-     closed issues in `AnyCredit5518/riplex` labeled `bug`.
+   - Uses the GitHub REST API (via `httpx`) to enumerate closed issues in
+     `AnyCredit5518/riplex`.
    - For each issue, checks whether it was referenced by a merged commit
      on the default branch (search commit messages for `#N`, `fixes #N`,
-     `closes #N`, etc.) — only counts issues that led to an actual fix.
+     `closes #N`, etc.) and counts closed issues labeled `bug` that led to an
+     actual fix.
+   - Supports manual include/exclude overrides for valid reports that the
+     strict commit-reference signal cannot infer, such as early unlabeled
+     reports or fixes made in a sibling dependency.
    - Tallies issues per opener, excluding `AnyCredit5518` and any account
      ending in `[bot]`.
-   - Maps tally to rank: 🐛 4+, 🔍 8+, 🛡️ 15+, 💎 25+ (matches existing
-     thresholds in `CONTRIBUTORS.md`).
+   - Maps tally to rank: 🧪 1+, 🐛 4+, 🔍 8+, 🛡️ 15+, 💎 25+ (matches
+     existing thresholds in `CONTRIBUTORS.md`).
    - Renders the "Bug Bashers" table between two HTML comment markers
      (`<!-- BUG_BASHERS:START -->` / `<!-- BUG_BASHERS:END -->`) so the
      surrounding prose stays hand-editable.
    - Sorts by issue count (desc), then username (asc) for stable diffs.
    - Reads token from `GITHUB_TOKEN` env var; falls back to unauthenticated
      requests (lower rate limit) for local runs without a token.
-   - Has unit tests covering the rank-mapping, exclusion list, marker
-     replacement, and the "referenced by merged commit" detection (with
-     mocked API responses).
+   - Has unit tests covering rank mapping, exclusion rules, marker
+     replacement, overrides, dry-run behavior, issue-reference detection, and
+     mocked API responses.
 
 2. **Workflow** — `.github/workflows/update-contributors.yml`:
    - Triggers: `schedule: cron '0 12 * * 1'` (every Monday 12:00 UTC) +
      `workflow_dispatch` for on-demand runs.
-   - Runs `python scripts/update_contributors.py`, then uses
+   - Runs `pytest tests/test_update_contributors.py -v` and
+     `python scripts/update_contributors.py`, then uses
      `peter-evans/create-pull-request` to open a PR titled
      `chore: refresh CONTRIBUTORS.md` if there's a diff.
    - Uses the built-in `GITHUB_TOKEN` — no extra secrets needed.

riplex-0.9.8/scripts/__init__.py

@@ -0,0 +1 @@
+"""Repository maintenance scripts."""

riplex-0.9.8/scripts/update_contributors.py

@@ -0,0 +1,365 @@
+from __future__ import annotations
+
+import argparse
+import difflib
+import json
+import os
+import re
+import subprocess
+import sys
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any, Iterable, Sequence
+
+import httpx
+
+
+DEFAULT_REPO = "AnyCredit5518/riplex"
+DEFAULT_CONTRIBUTORS_FILE = Path("CONTRIBUTORS.md")
+DEFAULT_OVERRIDES_FILE = Path(".github/contributors-overrides.json")
+DEFAULT_GIT_REF = "origin/main"
+START_MARKER = "<!-- BUG_BASHERS:START -->"
+END_MARKER = "<!-- BUG_BASHERS:END -->"
+OWNER_LOGIN = "AnyCredit5518"
+ISSUE_REF_RE = re.compile(
+    r"(?i)(?:fix(?:e[sd])?|close[sd]?|resolve[sd]?|issue|issues)?\s*#(\d+)"
+)
+
+
+@dataclass(frozen=True)
+class Issue:
+    number: int
+    author: str
+    labels: frozenset[str]
+    url: str
+
+    @property
+    def is_bug(self) -> bool:
+        return any(label.lower() == "bug" for label in self.labels)
+
+
+@dataclass(frozen=True)
+class Overrides:
+    include: frozenset[int]
+    exclude: frozenset[int]
+
+    @classmethod
+    def empty(cls) -> "Overrides":
+        return cls(include=frozenset(), exclude=frozenset())
+
+
+@dataclass(frozen=True)
+class Contributor:
+    username: str
+    issue_numbers: tuple[int, ...]
+    issue_urls: dict[int, str]
+
+
+def rank_for_count(count: int) -> str:
+    if count >= 25:
+        return "💎"
+    if count >= 15:
+        return "🛡️"
+    if count >= 8:
+        return "🔍"
+    if count >= 4:
+        return "🐛"
+    return "🧪"
+
+
+def parse_issue(item: dict[str, Any]) -> Issue | None:
+    if "pull_request" in item:
+        return None
+
+    user = item.get("user") or {}
+    login = user.get("login")
+    if not login:
+        return None
+
+    labels = item.get("labels") or []
+    label_names = frozenset(
+        label.get("name", "") if isinstance(label, dict) else str(label)
+        for label in labels
+    )
+    return Issue(
+        number=int(item["number"]),
+        author=str(login),
+        labels=label_names,
+        url=str(item.get("html_url") or ""),
+    )
+
+
+def fetch_closed_issues(repo: str, token: str | None = None) -> list[Issue]:
+    headers = {
+        "Accept": "application/vnd.github+json",
+        "X-GitHub-Api-Version": "2022-11-28",
+    }
+    if token:
+        headers["Authorization"] = f"Bearer {token}"
+
+    issues: list[Issue] = []
+    page = 1
+    per_page = 100
+    with httpx.Client(headers=headers, timeout=30.0, follow_redirects=True) as client:
+        while True:
+            response = client.get(
+                f"https://api.github.com/repos/{repo}/issues",
+                params={"state": "closed", "per_page": per_page, "page": page},
+            )
+            response.raise_for_status()
+            items = response.json()
+            if not items:
+                break
+
+            for item in items:
+                issue = parse_issue(item)
+                if issue is not None:
+                    issues.append(issue)
+
+            if len(items) < per_page:
+                break
+            page += 1
+
+    return issues
+
+
+def extract_issue_references(text: str) -> frozenset[int]:
+    return frozenset(int(match.group(1)) for match in ISSUE_REF_RE.finditer(text))
+
+
+def git_ref_exists(repo_root: Path, git_ref: str) -> bool:
+    result = subprocess.run(
+        ["git", "rev-parse", "--verify", "--quiet", git_ref],
+        cwd=repo_root,
+        capture_output=True,
+        text=True,
+    )
+    return result.returncode == 0
+
+
+def find_referenced_issues(repo_root: Path, git_ref: str = DEFAULT_GIT_REF) -> frozenset[int]:
+    log_ref = git_ref if git_ref_exists(repo_root, git_ref) else "HEAD"
+    result = subprocess.run(
+        ["git", "log", log_ref, "--format=%B"],
+        cwd=repo_root,
+        check=True,
+        capture_output=True,
+        text=True,
+        encoding="utf-8",
+        errors="replace",
+    )
+    return extract_issue_references(result.stdout)
+
+
+def load_overrides(path: Path) -> Overrides:
+    if not path.exists():
+        return Overrides.empty()
+
+    data = json.loads(path.read_text(encoding="utf-8"))
+    return Overrides(
+        include=frozenset(_parse_override_numbers(data.get("include", []), "include")),
+        exclude=frozenset(_parse_override_numbers(data.get("exclude", []), "exclude")),
+    )
+
+
+def _parse_override_numbers(entries: Any, field_name: str) -> list[int]:
+    if not isinstance(entries, list):
+        raise ValueError(f"overrides field {field_name!r} must be a list")
+
+    numbers: list[int] = []
+    for entry in entries:
+        if isinstance(entry, int):
+            numbers.append(entry)
+            continue
+        if isinstance(entry, dict) and isinstance(entry.get("number"), int):
+            numbers.append(entry["number"])
+            continue
+        raise ValueError(
+            f"overrides field {field_name!r} must contain issue numbers or objects with a number"
+        )
+    return numbers
+
+
+def should_exclude_author(username: str, owner_login: str = OWNER_LOGIN) -> bool:
+    return username.lower() == owner_login.lower() or username.lower().endswith("[bot]")
+
+
+def eligible_issues(
+    issues: Iterable[Issue], referenced_issue_numbers: set[int] | frozenset[int], overrides: Overrides
+) -> list[Issue]:
+    selected: list[Issue] = []
+    for issue in issues:
+        if issue.number in overrides.exclude:
+            continue
+        if should_exclude_author(issue.author):
+            continue
+
+        has_strict_signal = issue.is_bug and issue.number in referenced_issue_numbers
+        has_manual_signal = issue.number in overrides.include
+        if has_strict_signal or has_manual_signal:
+            selected.append(issue)
+    return selected
+
+
+def build_contributors(issues: Iterable[Issue]) -> list[Contributor]:
+    grouped: dict[str, dict[int, str]] = {}
+    display_names: dict[str, str] = {}
+    for issue in issues:
+        key = issue.author.lower()
+        display_names.setdefault(key, issue.author)
+        grouped.setdefault(key, {})[issue.number] = issue.url
+
+    contributors = [
+        Contributor(
+            username=display_names[key],
+            issue_numbers=tuple(sorted(issue_urls)),
+            issue_urls=issue_urls,
+        )
+        for key, issue_urls in grouped.items()
+    ]
+    return sorted(
+        contributors,
+        key=lambda contributor: (-len(contributor.issue_numbers), contributor.username.lower()),
+    )
+
+
+def render_table(contributors: Sequence[Contributor]) -> str:
+    lines = ["| User | Issues |", "|------|--------|"]
+    for contributor in contributors:
+        rank = rank_for_count(len(contributor.issue_numbers))
+        user = f"{rank} [@{contributor.username}](https://github.com/{contributor.username})"
+        issue_links = ", ".join(
+            f"[#{number}]({contributor.issue_urls[number]})"
+            for number in contributor.issue_numbers
+        )
+        lines.append(f"| {user} | {issue_links} |")
+    return "\n".join(lines)
+
+
+def replace_marker_block(content: str, replacement: str) -> str:
+    start = content.find(START_MARKER)
+    end = content.find(END_MARKER)
+    if start == -1 or end == -1 or end < start:
+        raise ValueError(
+            f"Could not find ordered {START_MARKER!r} and {END_MARKER!r} markers"
+        )
+
+    block_start = start + len(START_MARKER)
+    before = content[:block_start]
+    after = content[end:]
+    return f"{before}\n{replacement.rstrip()}\n{after}"
+
+
+def unified_diff(original: str, updated: str, path: Path) -> str:
+    return "".join(
+        difflib.unified_diff(
+            original.splitlines(keepends=True),
+            updated.splitlines(keepends=True),
+            fromfile=f"a/{path.as_posix()}",
+            tofile=f"b/{path.as_posix()}",
+        )
+    )
+
+
+def update_contributors_file(
+    contributors_file: Path, table: str, dry_run: bool = False
+) -> tuple[bool, str]:
+    original = contributors_file.read_text(encoding="utf-8")
+    updated = replace_marker_block(original, table)
+    if original == updated:
+        return False, ""
+
+    diff = unified_diff(original, updated, contributors_file)
+    if not dry_run:
+        contributors_file.write_text(updated, encoding="utf-8")
+    return True, diff
+
+
+def generate_table(
+    repo: str,
+    repo_root: Path,
+    overrides_file: Path,
+    token: str | None,
+    git_ref: str = DEFAULT_GIT_REF,
+) -> str:
+    issues = fetch_closed_issues(repo, token=token)
+    referenced_issue_numbers = find_referenced_issues(repo_root, git_ref=git_ref)
+    overrides = load_overrides(overrides_file)
+    selected_issues = eligible_issues(issues, referenced_issue_numbers, overrides)
+    contributors = build_contributors(selected_issues)
+    return render_table(contributors)
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        description="Update the generated Bug Bashers table in CONTRIBUTORS.md."
+    )
+    parser.add_argument("--repo", default=DEFAULT_REPO, help="GitHub repo as owner/name.")
+    parser.add_argument(
+        "--contributors-file",
+        type=Path,
+        default=DEFAULT_CONTRIBUTORS_FILE,
+        help="Path to CONTRIBUTORS.md.",
+    )
+    parser.add_argument(
+        "--overrides-file",
+        type=Path,
+        default=DEFAULT_OVERRIDES_FILE,
+        help="Path to the manual include/exclude override JSON file.",
+    )
+    parser.add_argument(
+        "--repo-root",
+        type=Path,
+        default=Path("."),
+        help="Repository root used for local git history scanning.",
+    )
+    parser.add_argument(
+        "--git-ref",
+        default=DEFAULT_GIT_REF,
+        help="Git ref to scan for issue references. Falls back to HEAD if missing.",
+    )
+    parser.add_argument(
+        "--token",
+        default=None,
+        help="GitHub token. Defaults to GITHUB_TOKEN when omitted.",
+    )
+    parser.add_argument(
+        "--dry-run",
+        action="store_true",
+        help="Print the diff without writing CONTRIBUTORS.md.",
+    )
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    repo_root = args.repo_root.resolve()
+    contributors_file = (repo_root / args.contributors_file).resolve()
+    overrides_file = (repo_root / args.overrides_file).resolve()
+    token = args.token or os.environ.get("GITHUB_TOKEN")
+
+    if not token:
+        print(
+            "GITHUB_TOKEN is not set; using unauthenticated GitHub API requests with a lower rate limit.",
+            file=sys.stderr,
+        )
+
+    table = generate_table(
+        args.repo, repo_root, overrides_file, token=token, git_ref=args.git_ref
+    )
+    changed, diff = update_contributors_file(
+        contributors_file, table=table, dry_run=args.dry_run
+    )
+    if args.dry_run:
+        print(diff or "CONTRIBUTORS.md is already up to date.")
+    elif changed:
+        print(f"Updated {contributors_file.relative_to(repo_root)}")
+    else:
+        print("CONTRIBUTORS.md is already up to date.")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

{riplex-0.9.7 → riplex-0.9.8/src/riplex.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: riplex
-Version: 0.9.7
+Version: 0.9.8
 Summary: Automates the tedious manual work around MakeMKV: figuring out what to rip, which MKV files are actually what, and organizing everything into Plex-compatible folder structures.
 License: MIT
 Requires-Python: >=3.11

{riplex-0.9.7 → riplex-0.9.8}/src/riplex.egg-info/SOURCES.txt

@@ -4,12 +4,14 @@ LICENSE
 README.md
 mkdocs.yml
 pyproject.toml
+.github/contributors-overrides.json
 .github/copilot-instructions.md
 .github/ISSUE_TEMPLATE/bug_report.yml
 .github/ISSUE_TEMPLATE/crash_report.yml
 .github/agents/riplex.agent.md
 .github/workflows/publish.yml
 .github/workflows/release.yml
+.github/workflows/update-contributors.yml
 .vscode/settings.json
 docs/architecture.md
 docs/changelog.md
@@ -35,6 +37,8 @@ screenshots/3_Metadata_Lookup_BTTF.png
 screenshots/4_Disc_Release_BTTF.png
 screenshots/5_Multi_Disc_Overview_BTTF.png
 screenshots/5_Select_Title_to_RIP_BTTF.png
+scripts/__init__.py
+scripts/update_contributors.py
 src/riplex/__init__.py
 src/riplex/cache.py
 src/riplex/config.py
@@ -127,6 +131,7 @@ tests/test_splitter.py
 tests/test_tagger.py
 tests/test_tmdb_provider.py
 tests/test_ui.py
+tests/test_update_contributors.py
 tests/test_updater.py
 tests/test_welcome_screen.py
 tests/fixtures/chernobyl_disc1.json

{riplex-0.9.7 → riplex-0.9.8}/src/riplex.egg-info/scm_file_list.json

@@ -10,6 +10,8 @@
     "issues/orchestrate-dvdcompare-fallback.md",
     "issues/manual-rip-and-organize-escape-hatch.md",
     "issues/planned-features.md",
+    "scripts/__init__.py",
+    "scripts/update_contributors.py",
     ".vscode/settings.json",
     "docs/naming-rules.md",
     "docs/troubleshooting.md",
@@ -92,6 +94,7 @@
     "tests/test_detect.py",
     "tests/test_dedup.py",
     "tests/test_app_main.py",
+    "tests/test_update_contributors.py",
     "tests/test_scanner.py",
     "tests/test_metadata_screen.py",
     "tests/test_cli_utils.py",
@@ -127,11 +130,13 @@
     "screenshots/3_Metadata_Lookup_BTTF.png",
     "screenshots/1_Welcome_Screen.png",
     "screenshots/2_Disc_Detection_BTTF.png",
+    ".github/contributors-overrides.json",
     ".github/copilot-instructions.md",
     ".github/agents/riplex.agent.md",
     ".github/ISSUE_TEMPLATE/crash_report.yml",
     ".github/ISSUE_TEMPLATE/bug_report.yml",
     ".github/workflows/release.yml",
-    ".github/workflows/publish.yml"
+    ".github/workflows/publish.yml",
+    ".github/workflows/update-contributors.yml"
   ]
 }

riplex-0.9.8/src/riplex.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.9.8",
+  "distance": 0,
+  "node": "g42cfaf8eae6632de91f8bc13a6e3ede4248255e3",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-07-01"
+}

{riplex-0.9.7 → riplex-0.9.8}/src/riplex_app/screens/progress.py

@@ -205,10 +205,17 @@ class ProgressScreen:
         # Brief pause then navigate
         time.sleep(1)
 
+        # Navigation must run on the Flet event loop, not this bg thread,
+        # or the client won't receive the new screen until the next OS event
+        # (e.g. the user moving the window). See _update() note.
         if self.app.state.get("workflow") == "orchestrate":
-            self._advance_orchestrate(results)
+            async def _nav_next():
+                self._advance_orchestrate(results)
+            self.app.page.run_task(_nav_next)
         else:
-            self.app.navigate("done")
+            async def _nav_done():
+                self.app.navigate("done")
+            self.app.page.run_task(_nav_done)
 
     def _write_snapshots(self, results: list[RipResult]):
         """Write debug snapshots to _riplex/ folder after rip."""
@@ -384,8 +391,17 @@ class ProgressScreen:
         self._update()
 
     def _update(self):
-        """Safe page update."""
-        try:
+        """Push a page update from a background thread.
+
+        page.update() called directly from a non-loop thread mutates state but
+        doesn't flush to the Flutter client until something else wakes the
+        event loop (e.g. the user moves the window). Scheduling via
+        page.run_task() runs the update on Flet's own loop via
+        asyncio.run_coroutine_threadsafe, which does trigger the flush.
+        """
+        async def _do_update():
             self.app.page.update()
+        try:
+            self.app.page.run_task(_do_update)
         except Exception:
             pass