<?php

use App\Support\Providers\Boundary\ProviderBoundaryOwner;
use App\Support\Providers\Boundary\ProviderBoundarySeam;

return [
    'seams' => [
        'provider.gateway_runtime' => [
            'owner' => ProviderBoundaryOwner::ProviderOwned->value,
            'description' => 'Provider-owned runtime boundary that translates provider connection identity into Microsoft Graph request options and executes Graph calls.',
            'implementation_paths' => [
                'app/Services/Providers/ProviderGateway.php',
                'app/Services/Providers/MicrosoftGraphOptionsResolver.php',
            ],
            'neutral_terms' => [
                'provider',
                'provider connection',
                'target scope',
                'runtime request context',
            ],
            'retained_provider_semantics' => [
                'Microsoft Graph option keys',
                'client_request_id',
                'tenant',
                'client_id',
                'client_secret',
            ],
            'follow_up_action' => ProviderBoundarySeam::FOLLOW_UP_DOCUMENT_IN_FEATURE,
        ],
        'provider.identity_resolution' => [
            'owner' => ProviderBoundaryOwner::PlatformCore->value,
            'description' => 'Platform-core identity resolution contract that resolves provider connection identity without owning provider transport option shaping.',
            'implementation_paths' => [
                'app/Services/Providers/ProviderIdentityResolution.php',
                'app/Services/Providers/ProviderIdentityResolver.php',
                'app/Services/Providers/PlatformProviderIdentityResolver.php',
            ],
            'neutral_terms' => [
                'provider connection',
                'target scope',
                'credential source',
                'effective client identity',
            ],
            'retained_provider_semantics' => [
                'entra_tenant_id',
                'platform_config',
                'graph.tenant_id',
                'admin.consent.callback',
            ],
            'follow_up_action' => ProviderBoundarySeam::FOLLOW_UP_SPEC,
        ],
        'provider.connection_resolution' => [
            'owner' => ProviderBoundaryOwner::PlatformCore->value,
            'description' => 'Platform-core provider connection selection and validation path that keeps current Microsoft connection details as bounded exception metadata.',
            'implementation_paths' => [
                'app/Services/Providers/ProviderConnectionResolver.php',
                'app/Services/Providers/ProviderConnectionResolution.php',
            ],
            'neutral_terms' => [
                'provider',
                'provider connection',
                'tenant scope',
                'default binding',
                'unsupported combination',
            ],
            'retained_provider_semantics' => [
                'microsoft',
                'entra_tenant_id',
                'consent_status',
            ],
            'follow_up_action' => ProviderBoundarySeam::FOLLOW_UP_SPEC,
        ],
        'provider.operation_registry' => [
            'owner' => ProviderBoundaryOwner::PlatformCore->value,
            'description' => 'Platform-core operation definition catalog with provider binding metadata kept explicit and secondary.',
            'implementation_paths' => [
                'app/Services/Providers/ProviderOperationRegistry.php',
            ],
            'neutral_terms' => [
                'operation type',
                'operation module',
                'required capability',
                'provider binding',
                'unsupported binding',
            ],
            'retained_provider_semantics' => [
                'microsoft',
                'active provider binding',
                'binding_status',
                'handler_notes',
                'exception_notes',
            ],
            'follow_up_action' => ProviderBoundarySeam::FOLLOW_UP_DOCUMENT_IN_FEATURE,
        ],
        'provider.operation_start_gate' => [
            'owner' => ProviderBoundaryOwner::PlatformCore->value,
            'description' => 'Platform-core operation start orchestration that consumes explicit provider bindings and records current Microsoft target-scope exceptions.',
            'implementation_paths' => [
                'app/Services/Providers/ProviderOperationStartGate.php',
            ],
            'neutral_terms' => [
                'operation',
                'provider binding',
                'target scope',
                'execution authority',
                'required capability',
            ],
            'retained_provider_semantics' => [
                'microsoft',
                'target_scope.entra_tenant_id',
            ],
            'follow_up_action' => ProviderBoundarySeam::FOLLOW_UP_SPEC,
        ],
    ],
];