[thesammykins]

Summary

• New Feature: Implement queue-remediation CLI tool for managing Sonarr/Radarr queue issues including stuck downloads, stalled imports, and media unavailability scenarios
• Critical Bug Fix: Fixed 26+ instances of ignored error handling in media-requests tool's readKeystroke() calls with proper error propagation
• Build System Fix: Corrected Makefile shell syntax in build-all target (broken string concatenation and ternary operator logic)
• Documentation: Comprehensive implementation guides, API research, and status message routing documentation

Changes

New Tool Implementation

• queue-remediation.go: Complete CLI tool with direct API integration, queue status analysis, and recovery strategies
• Full error handling, configurable timeouts, and retry logic

Quality Improvements

• media-requests.go: Enhanced error handling with explicit error checks on all keystroke input operations
• Makefile: Fixed shell syntax for Windows executable extensions and build matrix variables
• AGENTS.md: Refined guidelines reflecting expanded toolkit

Testing & Documentation

• queue-remediation_test.go: Full table-driven test suite with happy path and failure scenarios
• docs/README_QUEUEFIX.md: Complete usage guide with examples
• Implementation and research guides for API integration patterns

Features

• Automatically identifies and categorizes queue issues (stuck, stalled, failed imports)
• Recovers from transient API failures with configurable retry logic
• Provides detailed status reporting and suggested remediation actions
• Supports both dry-run analysis and actual remediation operations

Testing

✓ All existing tests pass: make test
✓ New queue-remediation tests fully implemented
✓ Manual testing of error handling paths
✓ Build verification for all target platforms

[calmcacil]

Looks good to me, needs testing to make sure everything works but overall good additions.

[calmcacil]

Converted to draft as its still being enhanced and worked on.

[calmcacil]

This PR needs to be updated to match the current repo structure.

Changes on main affecting this PR

Since this PR was opened, the repository has been restructured from flat package main files with build tags to a standard Go multi-binary layout:

• Before: queue-remediation.go at root level (package main, build tag)
• After: Logic goes in internal/remediation/ package, entry point in cmd/queue-remediation/main.go

Required updates

1. Move core logic from queue-remediation.go → internal/remediation/ (similar to internal/feed/, internal/requests/)
2. Create cmd/queue-remediation/main.go as a thin entry point
3. Import shared types from internal/config instead of defining new config structs
4. Import ANSI constants from internal/colors instead of defining new ones
5. Remove build-tag directive (//go:build)
6. Update Makefile to build from ./cmd/queue-remediation/
7. Rebase on latest main to resolve merge conflicts

See PR #19 for the exact pattern used for the other tools.

[calmcacil]

This PR's rendering should conform to the project's terminal UX conventions documented in docs/UX_DESIGN.md (just added to main). Key requirements:

• Use Unicode box-drawing characters (─│├┼┤└┴┘) for borders and containers
• Use golang.org/x/term for terminal-width-aware proportional sizing
• Use visibleLen/ padRight helpers for ANSI-safe text padding
• Follow the color convention table for actions, statuses, and server labels
• Buffer output through bytes.Buffer + bufio.Writer

See docs/UX_DESIGN.md for full details.

[calmcacil]

Superseded by the unified CLI architecture in #37; closing before the public-history sanitization.