feat: enhance agent settlement features and improve data access controls

- Added new section in AGENTS.md detailing learned workspace facts for better understanding of settlement processes.
- Updated AgentNodeDestroyController to remove unnecessary checks for admin users.
- Enhanced AgentSettlement controllers to assert permissions for finance adjustments and bill operations.
- Improved query scopes in AgentSettlement services to ensure proper data access based on admin roles.
- Refactored methods in SettlementPartyEnrichment for better bill row enrichment and data handling.
- Introduced new methods in AdminAgentSettlementScope for managing agent node visibility and finance adjustments.

tests/Unit/AgentDefaultRolePermissionsTest.php

@@ -3,12 +3,13 @@
 use App\Models\AgentProfile;
 use App\Support\AgentDefaultRolePermissions;
 
-test('base owner slugs include dashboard and settlement view but not wallet reconcile', function (): void {
+test('base owner slugs include dashboard and settlement view but not wallet reconcile or platform reports', function (): void {
     $slugs = AgentDefaultRolePermissions::baseSlugs();
 
     expect($slugs)
         ->toContain('prd.dashboard.view')
         ->toContain('prd.settlement.agent.view')
+        ->not->toContain('prd.report.view')
         ->not->toContain('prd.wallet_reconcile.view')
         ->not->toContain('prd.wallet_reconcile.view_cs');
 });