feat: add workflow automation system with category actions, orphan scanner, and hardlink detection (#818)

Author: s0up4200

Makefile

@@ -18,7 +18,7 @@ INTERNAL_WEB_DIR = internal/web
 # Go build flags with Polar credentials
 LDFLAGS = -ldflags "-X github.com/autobrr/qui/internal/buildinfo.Version=$(VERSION) -X main.PolarOrgID=$(POLAR_ORG_ID)"
 
-.PHONY: all build frontend backend dev dev-backend dev-frontend dev-expose clean test help themes-fetch themes-clean
+.PHONY: all build frontend backend dev dev-backend dev-frontend dev-expose clean test help themes-fetch themes-clean lint lint-full lint-json lint-fix fmt modern deps
 
 # Default target
 all: build
@@ -100,7 +100,7 @@ clean: themes-clean
 # Run tests
 test:
 	@echo "Running tests..."
-	go test -race -v ./...
+	go test -race -count=3 -v ./...
 
 # Validate OpenAPI specification
 test-openapi:
@@ -113,12 +113,32 @@ fmt:
 	go fmt ./...
 	cd $(WEB_DIR) && pnpm format
 
-# Lint code
+# Lint code (changed files only - fast feedback for AI iteration)
 lint:
-	@echo "Linting code..."
-	golangci-lint run
+	@echo "Linting changed Go code..."
+	golangci-lint run --new-from-merge-base=main --timeout=5m
+	@echo "Linting frontend..."
 	cd $(WEB_DIR) && pnpm lint
 
+# Full lint (entire codebase - use before commits/PRs)
+lint-full:
+	@echo "Linting entire Go codebase..."
+	golangci-lint run --timeout=10m
+	@echo "Linting frontend..."
+	cd $(WEB_DIR) && pnpm lint
+
+# Lint with JSON output (for AI agent consumption)
+lint-json:
+	@echo "Generating lint report..."
+	golangci-lint run --new-from-merge-base=main --output.json.path=./lint-report.json --timeout=5m || true
+	@echo "Lint report saved to lint-report.json"
+
+# Lint with auto-fix where possible
+lint-fix:
+	@echo "Running linters with auto-fix..."
+	golangci-lint run --fix --timeout=10m
+	cd $(WEB_DIR) && pnpm lint --fix
+
 # Modernize Go code (interface{} -> any, etc)
 modern:
 	@echo "Modernizing Go code..."
@@ -133,20 +153,36 @@ deps:
 # Help
 help:
 	@echo "Available targets:"
-	@echo "  make build        - Build both frontend and backend"
-	@echo "  make frontend     - Build frontend only"
-	@echo "  make backend      - Build backend only"
-	@echo "  make themes-fetch - Fetch premium themes from private repository"
-	@echo "  make themes-clean - Clean premium themes"
-	@echo "  make dev          - Run development servers"
-	@echo "  make dev-backend  - Run backend with hot reload"
-	@echo "  make dev-frontend - Run frontend development server"
-	@echo "  make dev-expose   - Run frontend dev server exposed on 0.0.0.0"
-	@echo "  make clean        - Clean build artifacts"
-	@echo "  make test         - Run all tests"
-	@echo "  make test-openapi - Validate OpenAPI specification"
-	@echo "  make fmt          - Format code"
-	@echo "  make lint         - Lint code"
-	@echo "  make modern       - Modernize Go code (interface{} -> any, etc)"
-	@echo "  make deps         - Install dependencies"
-	@echo "  make help         - Show this help message"
+	@echo ""
+	@echo "Build:"
+	@echo "  make build          - Build both frontend and backend"
+	@echo "  make frontend       - Build frontend only"
+	@echo "  make backend        - Build backend only"
+	@echo "  make build/docker   - Build Docker image"
+	@echo ""
+	@echo "Development:"
+	@echo "  make dev            - Run development servers (air + pnpm dev)"
+	@echo "  make dev-backend    - Run backend with hot reload"
+	@echo "  make dev-frontend   - Run frontend development server"
+	@echo "  make dev-expose     - Run frontend dev server exposed on 0.0.0.0"
+	@echo ""
+	@echo "Testing:"
+	@echo "  make test           - Run all tests with race detection"
+	@echo "  make test-openapi   - Validate OpenAPI specification"
+	@echo ""
+	@echo "Linting:"
+	@echo "  make lint           - Lint changed files only (fast, for iteration)"
+	@echo "  make lint-full      - Lint entire codebase"
+	@echo "  make lint-json      - Generate JSON lint report for AI agents"
+	@echo "  make lint-fix       - Auto-fix linting issues where possible"
+	@echo ""
+	@echo "Formatting:"
+	@echo "  make fmt            - Format Go and frontend code"
+	@echo "  make modern         - Modernize Go code (interface{} -> any)"
+	@echo ""
+	@echo "Other:"
+	@echo "  make themes-fetch   - Fetch premium themes from private repository"
+	@echo "  make themes-clean   - Clean premium themes"
+	@echo "  make clean          - Clean build artifacts"
+	@echo "  make deps           - Install dependencies"
+	@echo "  make help           - Show this help message"

README.md

@@ -40,7 +40,8 @@ A fast, modern web interface for qBittorrent. Supports managing multiple qBittor
 - **OIDC Single Sign-On**: Authenticate through your OpenID Connect provider
 - **External Programs**: Launch custom scripts from the torrent context menu ([guide](internal/api/handlers/EXTERNAL_PROGRAMS.md))
 - **Tracker Reannounce**: Automatically fix stalled torrents when qBittorrent doesn't retry fast enough ([info](internal/services/reannounce/REANNOUNCE.md))
-- **Tracker Rules**: Apply per-tracker speed limits, ratio caps, and seeding time limits automatically ([info](internal/services/trackerrules/TRACKER_RULES.md))
+- **Automations**: Rule-based torrent management with conditions, actions (delete, pause, tag, limit speeds), and cross-seed awareness ([info](internal/services/automations/AUTOMATIONS.md))
+- **Orphan Scan**: Find and remove files not associated with any torrent ([info](internal/services/orphanscan/ORPHANSCAN.md))
 - **Backups & Restore**: Scheduled snapshots with incremental, overwrite, and complete restore modes ([info](#backups--restore-modes))
 - **Cross-Seed**: Automatically find and add matching torrents across trackers with autobrr webhook integration ([info](#cross-seed))
 - **Reverse Proxy**: Transparent qBittorrent proxy for external apps like autobrr, Sonarr, and Radarr—no credential sharing needed ([info](#reverse-proxy-for-external-applications))

cmd/qui/main.go

@@ -32,13 +32,14 @@ import (
 	"github.com/autobrr/qui/internal/models"
 	"github.com/autobrr/qui/internal/polar"
 	"github.com/autobrr/qui/internal/qbittorrent"
+	"github.com/autobrr/qui/internal/services/automations"
 	"github.com/autobrr/qui/internal/services/crossseed"
 	"github.com/autobrr/qui/internal/services/filesmanager"
 	"github.com/autobrr/qui/internal/services/jackett"
 	"github.com/autobrr/qui/internal/services/license"
+	"github.com/autobrr/qui/internal/services/orphanscan"
 	"github.com/autobrr/qui/internal/services/reannounce"
 	"github.com/autobrr/qui/internal/services/trackericons"
-	"github.com/autobrr/qui/internal/services/trackerrules"
 	"github.com/autobrr/qui/internal/update"
 	"github.com/autobrr/qui/pkg/sqlite3store"
 )
@@ -482,7 +483,7 @@ func (app *Application) runServer() {
 		log.Warn().Err(err).Msg("Failed to preload reannounce settings cache")
 	}
 
-	trackerRuleStore := models.NewTrackerRuleStore(db)
+	automationStore := models.NewAutomationStore(db)
 	trackerCustomizationStore := models.NewTrackerCustomizationStore(db)
 	dashboardSettingsStore := models.NewDashboardSettingsStore(db)
 
@@ -556,7 +557,11 @@ func (app *Application) runServer() {
 	instanceCrossSeedCompletionStore := models.NewInstanceCrossSeedCompletionStore(db)
 	crossSeedService := crossseed.NewService(instanceStore, syncManager, filesManagerService, crossSeedStore, jackettService, externalProgramStore, instanceCrossSeedCompletionStore)
 	reannounceService := reannounce.NewService(reannounce.DefaultConfig(), instanceStore, instanceReannounceStore, reannounceSettingsCache, clientPool, syncManager)
-	trackerRuleService := trackerrules.NewService(trackerrules.DefaultConfig(), instanceStore, trackerRuleStore, syncManager)
+	automationActivityStore := models.NewAutomationActivityStore(db)
+	automationService := automations.NewService(automations.DefaultConfig(), instanceStore, automationStore, automationActivityStore, trackerCustomizationStore, syncManager)
+
+	orphanScanStore := models.NewOrphanScanStore(db)
+	orphanScanService := orphanscan.NewService(orphanscan.DefaultConfig(), instanceStore, orphanScanStore, syncManager)
 
 	syncManager.SetTorrentCompletionHandler(crossSeedService.HandleTorrentCompletion)
 
@@ -570,9 +575,13 @@ func (app *Application) runServer() {
 	defer reannounceCancel()
 	reannounceService.Start(reannounceCtx)
 
-	trackerRulesCtx, trackerRulesCancel := context.WithCancel(context.Background())
-	defer trackerRulesCancel()
-	trackerRuleService.Start(trackerRulesCtx)
+	automationsCtx, automationsCancel := context.WithCancel(context.Background())
+	defer automationsCancel()
+	automationService.Start(automationsCtx)
+
+	orphanScanCtx, orphanScanCancel := context.WithCancel(context.Background())
+	defer orphanScanCancel()
+	orphanScanService.Start(orphanScanCtx)
 
 	backupStore := models.NewBackupStore(db)
 	backupService := backups.NewService(backupStore, syncManager, jackettService, backups.Config{DataDir: cfg.GetDataDir()})
@@ -657,11 +666,14 @@ func (app *Application) runServer() {
 		CrossSeedService:                 crossSeedService,
 		JackettService:                   jackettService,
 		TorznabIndexerStore:              torznabIndexerStore,
-		TrackerRuleStore:                 trackerRuleStore,
-		TrackerRuleService:               trackerRuleService,
+		AutomationStore:                  automationStore,
+		AutomationActivityStore:          automationActivityStore,
+		AutomationService:                automationService,
 		TrackerCustomizationStore:        trackerCustomizationStore,
 		DashboardSettingsStore:           dashboardSettingsStore,
 		InstanceCrossSeedCompletionStore: instanceCrossSeedCompletionStore,
+		OrphanScanStore:                  orphanScanStore,
+		OrphanScanService:                orphanScanService,
 	})
 
 	errorChannel := make(chan error)