[Agent] Library refresh needs to function properly.

[tomp8628]

Objective

In TVOS when the Library view option is set to TV Media (Drawer), the game library does not refresh when roms are manually added to rom directories.

Acceptance Criteria

When a rom is manually placed in a rom directory, and the library view is set to TV Media (Drawer) Provenance TVOS

• periodically scan rom sub directories for new files
• populate the roms in the library with metadata and cover art.
• no attempt to match the files to a system should be made since the files are already in their correct directory
• this functionality currently exists in UIKit (Default) library view
• if functionality cannot be integrated, a Rescan Library, or Refresh Library button should be added to the TV Nedia Drawer Home Screen.

Affected Modules

• PVLibrary
• ProvenanceTVOS

Constraints

• Do not modify submodule source code
• Do not modify project.pbxproj unless necessary

Test Plan

• swift build passes for affected modules
• swift test passes for affected modules
• swiftlint reports no new violations
• a rom is added to a Roms subdirectory while a Provenance session is in use
• Provenance will either periodically (30- 60 seconds) , scan rom sub directories for new files and populate any new roms with metadata and cover art.
  Or
• Create a new button in the side menu to rescan the rom subdirectories and refresh the library, populating new roms based on new files that are found.

Estimated Scope

< 50 lines

[github-actions]

❌ Claude Code Agent Failed

Progress

• 🚀 Agent started
• ❌ Agent failed (rate limit or auth error)

Fallback: Manual intervention needed — use Cursor or wait for token reset.

Failed: 2026-08-21 00:55 UTC

[github-actions]

⚠️ Claude Code Agent Failed

The Claude Code agent could not complete this task (likely rate-limited or auth error).

Options:

1. Wait for the Claude Code token window to reset (~2 hours)
2. Use Cursor locally or via the Cursor GitHub app
3. Re-trigger by commenting @claude once tokens are available

Cursor fallback: Dispatched automatically via cursor-agent.yml.

Failed: 2026-08-20 22:09 UTC

[github-actions]

Cursor Agent failed

Result

• The workflow could not complete automatically.

Updated: 2026-08-20 22:13 UTC

[github-actions]

⚠️ Claude Code Agent Failed

The Claude Code agent could not complete this task (likely rate-limited or auth error).

Options:

1. Wait for the Claude Code token window to reset (~2 hours)
2. Use Cursor locally or via the Cursor GitHub app
3. Re-trigger by commenting @claude once tokens are available

Cursor fallback: Dispatched automatically via cursor-agent.yml.

Failed: 2026-08-20 22:10 UTC

[JoeMatt]

@claude can you look into this, tvos is only in testflight or sideload so we can assume user is on a somewhat more recent build, though we've been making importer fixes here and there recently

@tomp8628 what build are you on btw?

[tomp8628]

@claude can you look into this, tvos is only in testflight or sideload so we can assume user is on a somewhat more recent build, though we've been making importer fixes here and there recently

@tomp8628 what build are you on btw?

@JoeMatt current tvos test flight. Really only an issue when you upload MAME or some bins/cues that get confused. The delete button on the importer queue is broken as well, and I was gonna submit that next, but don’t wanna use up your tokens

[github-actions]

⚠️ Claude Code Agent Failed

The Claude Code agent could not complete this task (likely rate-limited or auth error).

Options:

1. Wait for the Claude Code token window to reset (~2 hours)
2. Use Cursor locally or via the Cursor GitHub app
3. Re-trigger by commenting @claude once tokens are available

Failed: 2026-08-21 00:55 UTC