# Quickstart — Spec 139 (Verify Access Required Permissions Assist)

## Local run (Sail)

- Start services: `vendor/bin/sail up -d`
- Open the app: `vendor/bin/sail open`

## Where to click

1. Sign in to the admin panel and select a workspace.
2. Open a managed tenant onboarding draft that is on the `Verify access` step.
3. Use a tenant/provider connection combination that produces permission-related blocked or needs-attention verification results.
4. In `Verify access`, confirm `View required permissions` appears near the verification result.
5. Open the assist and verify:
   - summary metadata is visible,
   - missing application and/or delegated permissions render when present,
   - copy actions only appear when a payload exists,
   - the full-page deep dive is visibly secondary.
6. Open the full-page deep dive and confirm it launches in a new tab while the onboarding tab remains usable.
7. Close the assist and rerun verification to confirm normal continuity.
8. Inspect permission-related Verify Access report next steps and confirm they open the in-place assist instead of navigating away.
9. Inside the assist, confirm deep-dive actions clearly communicate their new-tab behavior before activation.

## Expected behavior

- Fully ready verification with no permission guidance: no assist is shown.
- Permission-blocked or permission-relevant needs-attention verification: assist is shown.
- Permission-related remediation controls from Verify Access open the assist in place.
- Internal and external deep-dive links exposed from the assist continue opening in a new tab.
- Assist deep-dive links communicate their new-tab behavior clearly in the UI.
- Closing the assist preserves the current wizard step.

## Targeted tests

- Feature / Livewire:
  - `vendor/bin/sail artisan test --compact tests/Feature/Onboarding/OnboardingVerificationTest.php`
  - `vendor/bin/sail artisan test --compact tests/Feature/Onboarding/OnboardingVerificationClustersTest.php`
  - `vendor/bin/sail artisan test --compact tests/Feature/Onboarding/OnboardingVerificationV1_5UxTest.php`
- Browser:
  - `vendor/bin/sail artisan test --compact tests/Browser/OnboardingDraftVerificationResumeTest.php`

## Formatting

- `vendor/bin/sail bin pint --dirty --format agent`

## Deploy notes

- No new route registration.
- No new Filament asset registration expected.
- If implementation later adds registered assets for the assist, deployment must include `php artisan filament:assets`.
