refactor: restructure API, deduplicate code, expand test coverage

- Extract shared DeferClose helper, removing 14 duplicate copies
- Rename PlayWright-prefixed types to cleaner names (BrowserOptions,
  BrowserSelection, NewBrowser, etc.)
- Rename fields: ServerAddress, RequireServer (was DontLaunchOnConnectFailure)
- Extract shared initBrowser/mergeOptions into browser_init.go,
  deduplicating ~120 lines between NewBrowser and NewInteractiveBrowser
- Remove unused locator field from document struct
- Add tests for all previously untested packages (archive, aislegopher,
  wegmans, useragents, powerball) and expand existing test suites
- Add MIGRATION.md documenting all breaking API changes

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

sites/useragents/useragents.go

@@ -4,8 +4,6 @@ import (
 	"context"
 	"encoding/json"
 	"fmt"
-	"io"
-
 	"gitea.stevedudenhoeffer.com/steve/go-extractor"
 )
 
@@ -13,12 +11,6 @@ type Config struct{}
 
 var DefaultConfig = Config{}
 
-func deferClose(cl io.Closer) {
-	if cl != nil {
-		_ = cl.Close()
-	}
-}
-
 func GetMostCommonDesktopUserAgent(ctx context.Context, b extractor.Browser) (string, error) {
 	return DefaultConfig.GetMostCommonDesktopUserAgent(ctx, b)
 }
@@ -30,7 +22,7 @@ func (c Config) GetMostCommonDesktopUserAgent(ctx context.Context, b extractor.B
 		return "", fmt.Errorf("failed to open useragents.me: %w", err)
 	}
 
-	defer deferClose(doc)
+	defer extractor.DeferClose(doc)
 	s := doc.Select("#most-common-desktop-useragents-json-csv > div:nth-child(1) > textarea:nth-child(4)")
 
 	text := ""