Add progress bar to tracker

- Add rich progress bar to run_tracker function with RateColumn showing frames/sec
- Follows same implementation pattern as predictors.py for consistency
- Add logging statements for post-processing steps (culling and connecting single breaks)
- Add scratch/ folder to .gitignore for development notes
- All tests pass locally

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: gitttt-1234

.claude/commands/coverage.md

@@ -2,13 +2,17 @@ Run tests with coverage.
 
 Command to run:
 ```
-pytest -q --maxfail=1 --cov=sleap_nn --cov-branch tests/ && rm -f .coverage.* && python -m coverage annotate
+uv run pytest -q --maxfail=1 --cov --cov-branch && rm .coverage.* && uv run coverage annotate
 ```
 
-The result will be the terminal output and the line-by-line coverage will be in files sitting next to each module with the file naming `{module_name.py},cover`. 
+This generates a coverage annotation file next to each module with the name `{module_name.py},cover`, as well as a simple summary.
 
-If you are working on a PR, figure out which files were changed and look for coverage specifically in those. If you don't know which files to look for coverage in, use this:
+To get the final actionable summary, run this script:
 
 ```
-git diff --name-only $(git merge-base origin/main HEAD) | jq -R . | jq -s .
-```
+uv run python scripts/cov_summary.py --only-pr-diff-lines
+```
+
+This will output one module per line with line number ranges for missing coverage. Importantly, it will filter it by diffs in the PR.
+
+Use this summary together with the corresponding `,cover` file to describe each miss to inform subsequent test development.

.claude/commands/pr-description.md

@@ -2,6 +2,14 @@ Update PR description.
 
 Use the `gh` CLI to fetch the current PR description, then update it with a comprehensive description of the changes made in this PR.
 
+
+Command to fetch PR info:
+
+```
+gh pr view PR_NUMBER --json
+      number,title,body,url,state,closingIssuesReferences
+```
+
 If there is an associated issue (linked in the PR metadata or mentioned in the PR description), then use the `gh` CLI to fetch that too to contextualize the work done in the PR.
 
 Include a summary, example usage (for enhancements), API changes, and other notes for future consideration (including reasoning behind design decisions).

.gitignore

@@ -173,4 +173,7 @@ wandb/
 .serena/
 
 # macOS
-.DS_Store
+.DS_Store
+
+# Development scratch folder
+scratch/

sleap_nn/tracking/tracker.py

@@ -9,6 +9,14 @@
 from datetime import datetime
 from loguru import logger
 import functools
+import rich
+from rich.progress import (
+    Progress,
+    BarColumn,
+    TimeElapsedColumn,
+    TimeRemainingColumn,
+    MofNCompleteColumn,
+)
 
 import sleap_io as sio
 from sleap_nn.evaluation import compute_oks
@@ -712,6 +720,17 @@ def connect_single_breaks(
     return lfs
 
 
+class RateColumn(rich.progress.ProgressColumn):
+    """Renders the progress rate."""
+
+    def render(self, task: "Task") -> rich.progress.Text:
+        """Show progress rate."""
+        speed = task.speed
+        if speed is None:
+            return rich.progress.Text("?", style="progress.data.speed")
+        return rich.progress.Text(f"{speed:.1f} frames/s", style="progress.data.speed")
+
+
 def run_tracker(
     untracked_frames: List[sio.LabeledFrame],
     window_size: int = 5,
@@ -806,35 +825,66 @@ def run_tracker(
         tracking_pre_cull_to_target=tracking_pre_cull_to_target,
         tracking_pre_cull_iou_threshold=tracking_pre_cull_iou_threshold,
     )
-    tracked_lfs = []
-    for lf in untracked_frames:
-        # prefer user instances over predicted instance
-        instances = []
-        if lf.has_user_instances:
-            instances_to_track = lf.user_instances
-            if lf.has_predicted_instances:
-                instances = lf.predicted_instances
-        else:
-            instances_to_track = lf.predicted_instances
 
-        instances.extend(
-            tracker.track(
-                untracked_instances=instances_to_track,
-                frame_idx=lf.frame_idx,
-                image=lf.image,
-            )
-        )
-        tracked_lfs.append(
-            sio.LabeledFrame(
-                video=lf.video, frame_idx=lf.frame_idx, instances=instances
-            )
-        )
+    try:
+        with Progress(
+            "{task.description}",
+            BarColumn(),
+            "[progress.percentage]{task.percentage:>3.0f}%",
+            MofNCompleteColumn(),
+            "ETA:",
+            TimeRemainingColumn(),
+            "Elapsed:",
+            TimeElapsedColumn(),
+            RateColumn(),
+            auto_refresh=False,
+            refresh_per_second=4,
+            speed_estimate_period=5,
+        ) as progress:
+            task = progress.add_task("Tracking...", total=len(untracked_frames))
+            last_report = time()
+
+            tracked_lfs = []
+            for lf in untracked_frames:
+                # prefer user instances over predicted instance
+                instances = []
+                if lf.has_user_instances:
+                    instances_to_track = lf.user_instances
+                    if lf.has_predicted_instances:
+                        instances = lf.predicted_instances
+                else:
+                    instances_to_track = lf.predicted_instances
+
+                instances.extend(
+                    tracker.track(
+                        untracked_instances=instances_to_track,
+                        frame_idx=lf.frame_idx,
+                        image=lf.image,
+                    )
+                )
+                tracked_lfs.append(
+                    sio.LabeledFrame(
+                        video=lf.video, frame_idx=lf.frame_idx, instances=instances
+                    )
+                )
+
+                progress.update(task, advance=1)
+
+                if time() - last_report > 0.25:
+                    progress.refresh()
+                    last_report = time()
+
+    except KeyboardInterrupt:
+        logger.info("Tracking interrupted by user")
+        raise KeyboardInterrupt
 
     if tracking_clean_instance_count > 0:
+        logger.info("Post-processing: Culling instances...")
         tracked_lfs = cull_instances(
             tracked_lfs, tracking_clean_instance_count, tracking_clean_iou_threshold
         )
         if not post_connect_single_breaks:
+            logger.info("Post-processing: Connecting single breaks...")
             tracked_lfs = connect_single_breaks(
                 tracked_lfs, tracking_clean_instance_count
             )