feat(library): resilient scan for large libraries and better ffprobe errors

- Use a dedicated 10-minute HTTP client for library-sync so libraries
  with hundreds or thousands of items no longer time out
- Show actionable ffprobe-not-found error: detects Docker and suggests
  FFPROBE_PATH env var, config.toml setting, or package install
- Include static ffprobe binary in Docker image (johnvansickle.com)
- Bump version to 0.6.2

internal/agent/client.go

@@ -19,7 +19,10 @@ type Client struct {
 	// wakeClient has no built-in timeout — used exclusively for the long-poll
 	// wake endpoint where the context controls cancellation.
 	wakeClient *http.Client
-	userAgent  string
+	// librarySyncClient has a generous timeout for library-sync calls which can
+	// take several minutes when syncing hundreds or thousands of items.
+	librarySyncClient *http.Client
+	userAgent         string
 }
 
 // NewClient creates an agent API client.
@@ -33,7 +36,11 @@ func NewClient(baseURL, apiKey, userAgent string) *Client {
 		// wakeClient has no built-in timeout — the context controls it.
 		// The server holds the connection for up to 28s before responding.
 		wakeClient: &http.Client{},
-		userAgent:  userAgent,
+		// librarySyncClient uses a 10-minute timeout to handle large libraries
+		// (hundreds or thousands of items) where ffprobe scanning alone can take
+		// several minutes before the HTTP request is even sent.
+		librarySyncClient: &http.Client{Timeout: 10 * time.Minute},
+		userAgent:         userAgent,
 	}
 }
 
@@ -165,9 +172,10 @@ func (c *Client) BatchDownload(ctx context.Context, req BatchDownloadRequest) (*
 }
 
 // SyncLibrary sends scanned library items to the server for matching and upgrade discovery.
+// Uses a 10-minute timeout client to handle large libraries where scanning can take several minutes.
 func (c *Client) SyncLibrary(ctx context.Context, req LibrarySyncRequest) (*LibrarySyncResponse, error) {
 	var resp LibrarySyncResponse
-	if err := c.doPost(ctx, "/api/internal/agent/library-sync", req, &resp); err != nil {
+	if err := c.doPostWith(ctx, c.librarySyncClient, "/api/internal/agent/library-sync", req, &resp); err != nil {
 		return nil, fmt.Errorf("library sync: %w", err)
 	}
 	return &resp, nil
@@ -212,8 +220,14 @@ func (c *Client) WaitForWake(ctx context.Context) (bool, error) {
 	return result.Wake, nil
 }
 
-// doPost sends a JSON POST request and decodes the response.
+// doPost sends a JSON POST request using the default httpClient and decodes the response.
 func (c *Client) doPost(ctx context.Context, path string, body any, dst any) error {
+	return c.doPostWith(ctx, c.httpClient, path, body, dst)
+}
+
+// doPostWith sends a JSON POST request using the provided HTTP client and decodes the response.
+// Use this to override the default timeout for specific operations (e.g. librarySyncClient).
+func (c *Client) doPostWith(ctx context.Context, hc *http.Client, path string, body any, dst any) error {
 	jsonBody, err := json.Marshal(body)
 	if err != nil {
 		return fmt.Errorf("marshal body: %w", err)
@@ -227,7 +241,7 @@ func (c *Client) doPost(ctx context.Context, path string, body any, dst any) err
 	c.setHeaders(req)
 	req.Header.Set("Content-Type", "application/json")
 
-	resp, err := c.httpClient.Do(req)
+	resp, err := hc.Do(req)
 	if err != nil {
 		return fmt.Errorf("request failed: %w", err)
 	}

internal/cmd/version.go

@@ -1,4 +1,4 @@
 package cmd
 
 // Version is the CLI version. Overridden by goreleaser ldflags at release time.
-var Version = "0.6.1"
+var Version = "0.6.2"

internal/library/mediainfo/ffprobe.go

@@ -251,7 +251,29 @@ func ResolveFFprobe(explicit string) (string, error) {
 		return p, nil
 	}
 
-	return "", fmt.Errorf("ffprobe not found. Install ffmpeg or provide --ffprobe path")
+	// Give an actionable error depending on whether we're running in Docker.
+	if isDocker() {
+		return "", fmt.Errorf(
+			"ffprobe not found and auto-download failed (read-only filesystem?).\n" +
+				"Options:\n" +
+				"  • Use the official image: torrentclaw/unarr (includes ffprobe)\n" +
+				"  • Set FFPROBE_PATH env var to point to a pre-installed ffprobe binary\n" +
+				"  • Add to config.toml: [library]\\nffprobe_path = \"/path/to/ffprobe\"",
+		)
+	}
+	return "", fmt.Errorf(
+		"ffprobe not found and auto-download failed.\n" +
+			"Options:\n" +
+			"  • Install ffmpeg: sudo apt install ffmpeg  (or brew install ffmpeg)\n" +
+			"  • Set FFPROBE_PATH env var to point to the ffprobe binary\n" +
+			"  • Add to config.toml: [library]\\nffprobe_path = \"/path/to/ffprobe\"",
+	)
+}
+
+// isDocker reports whether the process is running inside a Docker container.
+func isDocker() bool {
+	_, err := os.Stat("/.dockerenv")
+	return err == nil
 }
 
 // tagValue gets a tag value case-insensitively.