chore: promote platform-dev to dev (#297 )

This pull request promotes the current state of `platform-dev` to the main integration branch `dev`. It includes recent features, fixes, and architectural refinements validated on the platform development track. Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #297
merge: platform-dev into dev (#295 )
2026-04-29 07:50:16 +00:00 · 2026-04-28 22:11:20 +00:00 · 2026-04-28 19:45:03 +00:00 · 2026-04-28 13:39:33 +00:00 · 2026-04-28 10:13:09 +00:00 · 2026-04-28 07:15:41 +00:00
382 changed files with 36314 additions and 8984 deletions
--- a/.github/agents/copilot-instructions.md
+++ b/.github/agents/copilot-instructions.md
@ -260,6 +260,12 @@ ## Active Technologies
 - PostgreSQL via existing `managed_tenant_onboarding_sessions`, `provider_connections`, `operation_runs`, and stored permission-posture data; no new persistence planned (240-tenant-onboarding-readiness)
 - PHP 8.4 (Laravel 12) + Laravel 12 + Filament v5 + Livewire v4 + Pest; existing `OperationRunLinks`, `GovernanceRunDiagnosticSummaryBuilder`, `ProviderReasonTranslator`, `RelatedNavigationResolver`, `RedactionIntegrity`, `WorkspaceAuditLogger` (241-support-diagnostic-pack)
 - PostgreSQL via existing `operation_runs`, `provider_connections`, `findings`, `stored_reports`, `tenant_reviews`, `review_packs`, and `audit_logs`; no new persistence planned (241-support-diagnostic-pack)
 - PHP 8.4, Laravel 12 + Filament v5, Livewire v4, Pest v4, existing review/evidence/review-pack/audit/RBAC support services (249-customer-review-workspace)
 - PostgreSQL via existing `tenant_reviews`, `review_packs`, `evidence_snapshots`, findings / finding-exception truth, workspace memberships, and `audit_logs`; no new persistence planned (249-customer-review-workspace)
 - PHP 8.4 (Laravel 12) + Filament v5 + Livewire v4, existing workspace settings stack (`SettingsRegistry`, `SettingsResolver`, `SettingsWriter`), `WorkspaceEntitlementResolver`, `ReviewPackService`, system directory detail page (251-commercial-entitlements-billing-state)
 - PostgreSQL via existing `workspace_settings` rows plus existing audit log records; no new table or billing/account model (251-commercial-entitlements-billing-state)
 - PHP 8.4 (Laravel 12) + Laravel 12 + Filament v5 + Livewire v4 + Pest; existing `UiEnforcement`, `OperationUxPresenter`, `OperationRunService`, `OperationCatalog`, `SystemOperationRunLinks`, `OperationRunLinks`, `AuditRecorder`, `WorkspaceAuditLogger`, and `PlatformCapabilities` (253-remove-findings-backfill-runtime-surfaces)
 - PostgreSQL existing `findings`, `operation_runs`, `audit_logs`, and related runtime tables only; no new persistence, migration, or data backfill is planned (253-remove-findings-backfill-runtime-surfaces)
 - PHP 8.4.15 (feat/005-bulk-operations)
@ -294,9 +300,9 @@ ## Code Style
 PHP 8.4.15: Follow standard conventions
 ## Recent Changes
- 241-support-diagnostic-pack: Added PHP 8.4 (Laravel 12) + Laravel 12 + Filament v5 + Livewire v4 + Pest; existing `OperationRunLinks`, `GovernanceRunDiagnosticSummaryBuilder`, `ProviderReasonTranslator`, `RelatedNavigationResolver`, `RedactionIntegrity`, `WorkspaceAuditLogger`
+- 253-remove-findings-backfill-runtime-surfaces: Added PHP 8.4 (Laravel 12) + Laravel 12 + Filament v5 + Livewire v4 + Pest; existing `UiEnforcement`, `OperationUxPresenter`, `OperationRunService`, `OperationCatalog`, `SystemOperationRunLinks`, `OperationRunLinks`, `AuditRecorder`, `WorkspaceAuditLogger`, and `PlatformCapabilities`
- 240-tenant-onboarding-readiness: Added PHP 8.4 (Laravel 12) + Laravel 12 + Filament v5 + Livewire v4 + Pest; existing onboarding services (`OnboardingLifecycleService`, `OnboardingDraftStageResolver`), provider connection summary, verification assist, and Ops-UX helpers
+- 251-commercial-entitlements-billing-state: Added PHP 8.4 (Laravel 12) + Filament v5 + Livewire v4, existing workspace settings stack (`SettingsRegistry`, `SettingsResolver`, `SettingsWriter`), `WorkspaceEntitlementResolver`, `ReviewPackService`, system directory detail page
- 239-canonical-operation-type-source-of-truth: Added PHP 8.4.15, Laravel 12, Filament v5, Livewire v4 + existing `App\Support\OperationCatalog`, `App\Support\OperationRunType`, `App\Services\OperationRunService`, `App\Services\Providers\ProviderOperationRegistry`, `App\Services\Providers\ProviderOperationStartGate`, `App\Filament\Resources\OperationRunResource`, `App\Filament\Pages\Workspaces\ManagedTenantOnboardingWizard`, `App\Support\Filament\FilterOptionCatalog`, `App\Support\OpsUx\OperationUxPresenter`, `App\Support\References\Resolvers\OperationRunReferenceResolver`, `App\Services\Audit\AuditEventBuilder`, Pest v4
+- 249-customer-review-workspace: Added PHP 8.4, Laravel 12 + Filament v5, Livewire v4, Pest v4, existing review/evidence/review-pack/audit/RBAC support services
 <!-- MANUAL ADDITIONS START -->
 ### Pre-production compatibility check
--- a/.github/skills/spec-kit-end-to-end/SKILL.md
+++ b/.github/skills/spec-kit-end-to-end/SKILL.md
@ -1,939 +0,0 @@
 ---
 name: spec-kit-end-to-end
 description: End-to-end Spec Kit workflow for TenantPilot/TenantAtlas: select the next suitable spec candidate from roadmap/spec-candidates when needed, create or update spec.md/plan.md/tasks.md, optionally implement the active spec, run tests, browser smoke checks where applicable, post-implementation analysis, fix confirmed findings, and repeat until no in-scope findings remain or a stop condition is reached.
 ---
 # Skill: Spec Kit End-to-End Workflow
 ## Purpose
 Use this skill to run an end-to-end Spec Kit workflow for TenantPilot/TenantAtlas.
 This skill supports three modes:
 1. **Preparation only**: select or scope the next suitable feature from roadmap/spec-candidates and create or update `spec.md`, `plan.md`, and `tasks.md`.
 2. **Implementation only**: implement an already prepared spec, run tests/checks, run strict post-implementation analysis, fix confirmed findings, and repeat until clean or a bounded stop condition is reached.
 3. **End-to-end**: select or create a spec and then implement it in the same invocation, but only when the user explicitly requests end-to-end execution.
 The intended workflow is:
 ```text
 feature idea / roadmap item / spec candidate / active spec
 → determine requested mode
 → inspect repo truth, constitution, roadmap, spec candidates, existing specs, and relevant code
 → create or update spec.md + plan.md + tasks.md when preparation is needed
 → evaluate quality gates
 → implement only when the user explicitly asks for implementation or end-to-end execution
 → run relevant tests/checks
 → run browser smoke test when UI/user-facing flows are affected
 → run strict post-implementation analysis
 → fix confirmed in-scope findings
 → repeat test + analysis + fix loop until clean or bounded stop condition is reached
 → final report
 ```
 ## When to Use
 Use this skill when the user asks for any Spec Kit workflow around TenantPilot/TenantAtlas, including:
 - selecting the next best spec candidate from `docs/product/spec-candidates.md` and roadmap sources
 - turning a feature idea, roadmap item, or candidate into `spec.md`, `plan.md`, and `tasks.md`
 - preparing Spec Kit artifacts in one pass
 - implementing an existing or newly prepared spec
 - running implementation followed by strict analysis and fix iterations
 - executing a full end-to-end flow from candidate selection to implementation verification
 Typical user prompts:
 ```text
 Nimm den nächsten sinnvollen Spec Candidate aus Roadmap/spec-candidates und mach spec, plan und tasks.
 ```
 ```text
 Mach daraus spec, plan und tasks in einem Rutsch, aber noch nicht implementieren.
 ```
 ```text
 Erstelle die Spec Kit Artefakte und implementiere sie danach mit Analyse/Fix-Loop.
 ```
 ```text
 Implementiere die aktive Spec und analysiere danach, ob alles passt.
 ```
 ```text
 Mach Spec Kit implement und danach analyse. Behebe alle Abweichungen und wiederhole bis sauber.
 ```
 ```text
 Run end-to-end: choose next spec, create spec/plan/tasks, implement, analyze, fix until no in-scope findings remain.
 ```
 ## Hard Rules
 - Work strictly repo-based.
 - Use the repository's actual Spec Kit workflow, scripts, templates, branch naming rules, and generated paths when available.
 - Determine the requested mode before changing files:
  - preparation only
  - implementation only
  - end-to-end preparation plus implementation
 - Do not implement application code unless the user explicitly asks for implementation, `implement`, or end-to-end execution.
 - When in preparation-only mode, create or update only Spec Kit preparation artifacts unless repository conventions require additional documentation artifacts.
 - When in implementation mode, implement only the active or explicitly named Spec Kit feature.
 - Do not manually invent spec numbers, branch names, or spec paths if Spec Kit provides a script or command for that.
 - Do not bypass Spec Kit branch mechanics.
 - Do not expand scope beyond the selected feature, `spec.md`, `plan.md`, and `tasks.md`.
 - Do not silently add roadmap features, adjacent UX rewrites, speculative architecture, or unrelated refactors.
 - Follow the repository constitution and existing Spec Kit conventions.
 - Preserve TenantPilot/TenantAtlas terminology.
 - Prefer small, reviewable, implementation-ready specs and patches over broad rewrites.
 - Treat repository truth as authoritative over assumptions.
 - If repository truth conflicts with the user-provided draft or spec, keep repository truth and document the deviation.
 - If repository truth conflicts with implementation scope, stop and report the conflict unless there is an obvious minimal correction inside active spec scope.
 - Fix only confirmed findings from tests, static checks, or post-implementation analysis.
 - Fix all confirmed in-scope findings, regardless of severity, when they are safe and bounded.
 - Do not leave Medium/Low findings open silently. If they are not fixed, document exactly why.
 - Never hide failing tests, weaken assertions, delete meaningful coverage, or mark tasks complete without implementation evidence.
 - Do not run destructive commands.
 - Do not force checkout, reset, stash, rebase, merge, or delete branches.
 - Do not perform database-destructive actions unless the repository test workflow explicitly requires isolated test database resets.
 - Do not continue analysis/fix loops indefinitely.
 - Do not move from preparation to implementation unless the Spec Readiness Gate passes or the user explicitly accepts the documented readiness risks.
 - Do not move from implementation to final status unless the Test Gate, Browser Smoke Test Gate where applicable, and Post-Implementation Analysis Gate have been evaluated.
 - Do not claim merge-readiness unless the Merge Readiness Gate passes.
 ## Required Inputs
 The user should provide at least one of:
 - feature title and short goal
 - full spec candidate
 - roadmap item
 - rough problem statement
 - UX or architecture improvement idea
 - explicit spec directory such as `specs/<number>-<slug>/`
 - instruction to use the current active Spec Kit feature
 - instruction to choose the next best candidate from roadmap/spec-candidates
 If the input is incomplete, proceed with the smallest reasonable interpretation and document assumptions.
 If implementation is requested but the active spec cannot be determined safely, inspect the repository Spec Kit context first. If it is still ambiguous, stop and ask for the specific spec directory.
 ## Required Repository Checks
 Always check the sources relevant to the requested mode.
 For preparation mode, always check:
 1. `.specify/memory/constitution.md`
 2. `.specify/templates/`
 3. `.specify/scripts/`
 4. existing Spec Kit command usage or repository instructions, if present
 5. current branch and git status
 6. `specs/`
 7. `docs/product/spec-candidates.md`
 8. relevant roadmap documents under `docs/product/`, especially `roadmap.md` if present
 9. nearby existing specs with related terminology or scope
 10. application code only as needed to avoid wrong naming, wrong architecture, duplicate concepts, impossible tasks, duplicated specs, or already-completed candidates
 For implementation mode, always check:
 1. active Spec Kit context / current branch
 2. git status
 3. `.specify/memory/constitution.md`
 4. the active spec directory
 5. `spec.md`
 6. `plan.md`
 7. `tasks.md`
 8. relevant templates or conventions under `.specify/templates/`
 9. nearby existing specs with related terminology or scope
 10. application code surfaces referenced by the active spec
 11. existing tests related to the changed behavior
 ## Git and Branch Safety
 Before running any Spec Kit command or making implementation changes:
 1. Check the current branch.
 2. Check whether the working tree is clean.
 3. If there are unrelated uncommitted changes, stop and report them. Do not continue.
 4. If the working tree only contains user-intended planning edits for this operation, continue cautiously.
 5. Let Spec Kit create or switch to the correct feature branch when that is how the repository workflow works.
 6. Do not force checkout, reset, stash, rebase, merge, or delete branches.
 7. Do not overwrite existing specs.
 If the repo requires an explicit branch creation script for `specify`, use that script rather than manually creating the branch.
 ## Mode Selection
 Select exactly one mode per invocation unless the user explicitly asks for end-to-end execution.
 ### Preparation Only
 Use when the user asks to:
 - create spec/plan/tasks
 - prepare a feature
 - choose the next best spec candidate
 - turn roadmap/spec-candidates into a spec
 - run specify/plan/tasks/analyze without implementation
 - avoid implementation
 Output is limited to Spec Kit preparation artifacts, preparation-artifact fixes, and final preparation summary.
 ### Implementation Only
 Use when the user asks to:
 - implement an active spec
 - run Spec Kit implement
 - analyze after implementation
 - fix implementation findings
 Requires an existing active or explicitly named spec.
 ### End-to-End
 Use only when the user explicitly asks to:
 - choose/create the spec and then implement it
 - run the full workflow
 - go from candidate to implementation
 - prepare and implement in one pass
 End-to-end mode must keep preparation and implementation phases clearly separated.
 End-to-end mode must pass the Candidate Selection Gate and Spec Readiness Gate before implementation begins.
 ## Quality Gates
 Quality gates are mandatory checkpoints. They make the workflow safe for agentic execution without allowing uncontrolled scope expansion.
 ### Gate 1: Candidate Selection Gate
 Required before creating a new spec from roadmap/spec-candidates.
 Pass criteria:
 - The selected candidate exists in roadmap/spec-candidate material or is directly provided by the user.
 - The selected candidate is not already covered by an existing active or completed spec.
 - The selected candidate aligns with current roadmap priorities or explicitly documented product direction.
 - The candidate can be scoped as a small, reviewable, implementation-ready slice.
 - Major adjacent concerns are listed as follow-up candidates instead of being hidden inside the primary scope.
 Fail behavior:
 - If no candidate satisfies the gate, stop and report the top candidates plus the reason none is ready.
 - Do not invent a new roadmap direction to force progress.
 ### Gate 2: Spec Readiness Gate
 Required before implementation starts, including end-to-end mode.
 Pass criteria:
 - `spec.md`, `plan.md`, and `tasks.md` exist.
 - The spec has clear problem statement, user value, functional requirements, out-of-scope boundaries, acceptance criteria, assumptions, and risks.
 - The plan identifies likely affected repo surfaces and does not contradict repository architecture.
 - The tasks are small, ordered, verifiable, and include test/validation tasks.
 - RBAC, workspace/tenant isolation, auditability, OperationRun semantics, evidence/result-truth, and UX requirements are addressed where relevant.
 - No open question blocks safe implementation.
 - The scope is small enough for a bounded implementation loop.
 Fail behavior:
 - In preparation-only mode, report the readiness gaps and provide the manual analysis prompt.
 - In end-to-end mode, stop before implementation unless the user explicitly asked to proceed despite the documented readiness risks.
 - Do not compensate for an unclear spec by inventing implementation scope.
 ### Gate 3: Implementation Scope Gate
 Required before changing application code.
 Pass criteria:
 - The active spec directory is known.
 - The implementation target is traceable to specific tasks in `tasks.md`.
 - The affected files/surfaces are consistent with `plan.md` or clearly justified by repository truth.
 - No required change would introduce unrelated product behavior.
 - No required change conflicts with constitution, existing architecture, RBAC/isolation boundaries, or source-of-truth semantics.
 Fail behavior:
 - Stop before code changes and report the conflict or ambiguity.
 - Suggest a minimal spec/plan/tasks correction if the issue is in the artifacts rather than the codebase.
 ### Gate 4: Test Gate
 Required after implementation and after each fix iteration.
 Pass criteria:
 - Targeted tests for changed behavior pass.
 - Relevant existing tests pass or failures are proven unrelated and documented.
 - Static analysis, linting, formatting, or type checks used by the repository pass when applicable.
 - Security/governance-relevant changes have backend, policy, or domain coverage; UI-only verification is not enough.
 - Regression coverage exists for each fixed Blocker or High finding where practical.
 Fail behavior:
 - Fix in-scope failures before post-implementation analysis.
 - If failures are unrelated or pre-existing, document evidence and continue only if they do not invalidate the active spec.
 - Do not weaken tests to pass the gate.
 ### Gate 5: Browser Smoke Test Gate
 Required before claiming implementation is ready for manual review/merge when the change affects Filament UI, Livewire interactions, navigation, forms, tables, actions, modals, dashboards, operation drilldowns, tenant/workspace context, or any user-facing flow.
 Not required for documentation-only, spec-only, backend-only, domain-only, enum-only, contract-only, or test-only changes unless those changes alter a user-facing flow.
 Pass criteria:
 - The relevant page or flow loads in a real browser or the repository's browser-testing harness.
 - The primary action introduced or changed by the spec can be executed successfully.
 - Expected UI states, labels, badges, actions, empty states, tables, forms, modals, and navigation are visible where relevant.
 - Workspace/tenant context is preserved across the tested flow where relevant.
 - RBAC/capability-dependent visibility behaves as expected where practical to verify.
 - Livewire interactions complete without visible runtime errors.
 - No relevant browser console errors occur.
 - No failed network requests occur for the tested flow, except known unrelated development noise that is explicitly documented.
 - OperationRun, audit, evidence, result, or support-diagnostic drilldowns work where relevant.
 - The smoke-tested path is documented in the final response.
 Fail behavior:
 - Fix in-scope browser, UX, Livewire, navigation, or runtime failures before claiming merge-readiness.
 - If a browser issue is unrelated existing debt, document evidence and residual risk.
 - Do not treat a passing browser smoke test as a substitute for backend, policy, domain, security, feature, or integration tests.
 - Do not expand the smoke test into a full E2E suite unless the user explicitly asks for that.
 ### Gate 6: Post-Implementation Analysis Gate
 Required after implementation and after each fix iteration.
 Pass criteria:
 - The implementation has been checked against `spec.md`, `plan.md`, `tasks.md`, and constitution.
 - All completed tasks have implementation evidence.
 - No confirmed in-scope findings remain.
 - Medium/Low findings are fixed when they are inside active spec scope, clearly bounded, and safe.
 - Medium/Low findings that remain open are explicitly documented with one of these reasons:
  - out of scope
  - requires separate spec
  - risky refactor
  - existing unrelated debt
  - not reproducible
  - blocked by unclear product/architecture decision
 - No scope expansion was introduced during fixes.
 Fail behavior:
 - Fix confirmed in-scope findings, regardless of severity, when the fix is safe and bounded.
 - Stop instead of fixing when remediation would expand scope, contradict repo architecture, introduce risky refactors, or repeat the same failed fix twice.
 ### Gate 7: Merge Readiness Gate
 Required before claiming the implementation is ready for manual review/merge.
 Pass criteria:
 - Spec Readiness Gate passed.
 - Implementation Scope Gate passed.
 - Test Gate passed.
 - Browser Smoke Test Gate passed when applicable, or was explicitly marked not applicable with a reason.
 - Post-Implementation Analysis Gate passed.
 - `tasks.md` reflects actual completion status.
 - No confirmed in-scope findings remain.
 - All remaining findings are documented as out-of-scope, follow-up candidates, unrelated existing debt, or explicit residual risks.
 - Final response includes changed files, tests/checks run, iterations performed, residual risks, and follow-up candidates.
 Fail behavior:
 - Do not claim merge-readiness.
 - Report the failed gate, remaining risks, and the smallest recommended next action.
 ## Candidate Selection Rules
 When the user asks for the next best spec from roadmap/spec-candidates:
 - Read `docs/product/spec-candidates.md`.
 - Read relevant roadmap documents under `docs/product/`, especially `roadmap.md` if present.
 - Check existing specs to avoid duplicates.
 - Prefer candidates that align with current roadmap priorities, platform foundations, enterprise UX, RBAC/isolation, auditability, observability, and governance workflow maturity.
 - Prefer candidates that unlock roadmap progress, reduce architectural drift, harden foundations, or remove known blockers.
 - Prefer small, implementation-ready slices over broad platform rewrites.
 - If multiple candidates are plausible, choose one primary candidate and document why it was selected.
 - Add non-selected relevant candidates as follow-up spec candidates, not hidden scope.
 - Do not invent a candidate if existing roadmap/spec-candidate material provides a suitable one.
 - Do not pick a spec only because it is listed first.
 - Evaluate the Candidate Selection Gate before creating the spec directory.
 Evaluate candidates using these criteria:
 1. **Roadmap Fit**: Does it support the current roadmap sequence or unlock the next roadmap layer?
 2. **Foundation Value**: Does it strengthen reusable platform foundations such as RBAC, isolation, auditability, evidence, OperationRun observability, provider boundaries, vocabulary, baseline/control/finding semantics, or enterprise UX patterns?
 3. **Dependency Unblocking**: Does it make future specs smaller, safer, or more consistent?
 4. **Scope Size**: Can it be implemented as a narrow, testable slice?
 5. **Repo Readiness**: Does the repo already have enough structure to implement the next slice safely?
 6. **Risk Reduction**: Does it reduce current architectural or product risk?
 7. **User/Product Value**: Does it produce visible operator value or make the platform more sellable without heavy scope?
 ## Required Selection Output Before Spec Kit Execution
 Before running the Spec Kit flow, identify:
 - selected candidate title
 - source location in roadmap/spec-candidates
 - why it was selected
 - why close alternatives were deferred
 - roadmap relationship
 - smallest viable implementation slice
 - proposed concise feature description to feed into `specify`
 The feature description must be product- and behavior-oriented. It should not be a low-level implementation plan.
 ## Spec Kit Preparation Flow
 Use this section when the selected mode is preparation-only or end-to-end.
 ### Step 1: Determine the repository's Spec Kit command pattern
 Inspect repository instructions and scripts to identify how this repo expects Spec Kit to be run.
 Common locations to inspect:
 ```text
 .specify/scripts/
 .specify/templates/
 .specify/memory/constitution.md
 .github/prompts/
 .github/skills/
 README.md
 specs/
 ```
 Use the repo-specific mechanism if present.
 ### Step 2: Run `specify`
 Run the repository's `specify` flow using the selected candidate and the smallest viable slice.
 The `specify` input should include:
 - selected candidate title
 - problem statement
 - operator/user value
 - roadmap relationship
 - out-of-scope boundaries
 - key acceptance criteria
 - important enterprise constraints
 Let Spec Kit create the correct branch and spec location if that is the repo's configured behavior.
 ### Step 3: Run `plan`
 Run the repository's `plan` flow for the generated spec.
 The `plan` input should keep the scope tight and should require repo-based alignment with:
 - constitution
 - existing architecture
 - workspace/tenant isolation
 - RBAC
 - OperationRun/observability where relevant
 - evidence/snapshot/truth semantics where relevant
 - Filament/Livewire conventions where relevant
 - test strategy
 ### Step 4: Run `tasks`
 Run the repository's `tasks` flow for the generated plan.
 The generated tasks must be:
 - ordered
 - small
 - testable
 - grouped by phase
 - limited to the selected scope
 - suitable for later implementation or manual analysis before implementation
 ### Step 5: Run preparation `analyze`
 Run the repository's `analyze` flow against the generated Spec Kit artifacts when the repository supports it.
 Analyze must check:
 - consistency between `spec.md`, `plan.md`, and `tasks.md`
 - constitution alignment
 - roadmap alignment
 - whether the selected candidate was narrowed safely
 - whether tasks are complete enough for implementation
 - whether tasks accidentally require scope not described in the spec
 - whether plan details conflict with repository architecture or terminology
 - whether implementation risks are documented instead of silently ignored
 In preparation-only mode, do not use analyze as a trigger to implement application code.
 ### Step 6: Fix preparation-artifact issues only
 If preparation analyze finds issues, fix only Spec Kit preparation artifacts such as:
 - `spec.md`
 - `plan.md`
 - `tasks.md`
 - generated Spec Kit metadata files, if the repository uses them
 Allowed fixes include:
 - clarify requirements
 - tighten scope
 - move out-of-scope work into follow-up candidates
 - correct terminology
 - add missing tasks
 - remove tasks not backed by the spec
 - align plan language with repository architecture
 - add missing acceptance criteria or validation tasks
 Forbidden fixes in preparation-only mode include:
 - modifying application code
 - creating migrations
 - editing models, services, jobs, policies, Filament resources, Livewire components, tests, or commands
 - running implementation or test-fix loops
 - changing runtime behavior
 ### Step 7: Evaluate the Spec Readiness Gate
 After preparation analyze has passed or preparation-artifact issues have been fixed, evaluate the Spec Readiness Gate.
 In preparation-only mode, stop after this gate and do not implement.
 ## Spec Directory Rules
 When creating a new spec directory, use the repository's Spec Kit-generated directory or path.
 If the repository does not provide a command for spec setup, use the next valid spec number and a kebab-case slug:
 ```text
 specs/<number>-<slug>/
 ```
 The exact number must be derived from the current repository state and existing numbering conventions.
 Create or update preparation artifacts inside the selected spec directory:
 ```text
 specs/<number>-<slug>/spec.md
 specs/<number>-<slug>/plan.md
 specs/<number>-<slug>/tasks.md
 ```
 If the repository templates require additional preparation files, create them only when this is consistent with existing Spec Kit conventions.
 ## `spec.md` Requirements
 The spec must be product- and behavior-oriented. It should avoid premature implementation detail unless needed for correctness.
 Include:
 - Feature title
 - Problem statement
 - Business/product value
 - Primary users/operators
 - User stories
 - Functional requirements
 - Non-functional requirements
 - UX requirements
 - RBAC/security requirements
 - Auditability/observability requirements
 - Data/truth-source requirements where relevant
 - Out of scope
 - Acceptance criteria
 - Success criteria
 - Risks
 - Assumptions
 - Open questions
 TenantPilot/TenantAtlas specs should preserve enterprise SaaS principles:
 - workspace/tenant isolation
 - capability-first RBAC
 - auditability
 - operation/result truth separation
 - source-of-truth clarity
 - calm enterprise operator UX
 - progressive disclosure where useful
 - no false positive calmness
 ## `plan.md` Requirements
 The plan must be repo-aware and implementation-oriented, but it must not make code changes by itself.
 Include:
 - Technical approach
 - Existing repository surfaces likely affected
 - Domain/model implications
 - UI/Filament implications
 - Livewire implications where relevant
 - OperationRun/monitoring implications where relevant
 - RBAC/policy implications
 - Audit/logging/evidence implications where relevant
 - Data/migration implications where relevant
 - Test strategy
 - Rollout considerations
 - Risk controls
 - Implementation phases
 The plan should clearly distinguish where relevant:
 - execution truth
 - artifact truth
 - backup/snapshot truth
 - recovery/evidence truth
 - operator next action
 ## `tasks.md` Requirements
 Tasks must be ordered, small, and verifiable.
 Include:
 - checkbox tasks
 - phase grouping
 - tests before or alongside implementation tasks where practical
 - final validation tasks
 - documentation/update tasks if needed
 - explicit non-goals where useful
 Avoid vague tasks such as:
 ```text
 Clean up code
 Refactor UI
 Improve performance
 Make it enterprise-ready
 ```
 Prefer concrete tasks such as:
 ```text
 - [ ] Add a feature test covering workspace isolation for <specific behavior>.
 - [ ] Update <specific Filament page/resource> to display <specific state>.
 - [ ] Add policy coverage for <specific capability>.
 ```
 If exact file names are not known yet, phrase tasks as repo-verification tasks first rather than inventing file paths.
 ## Preparation Scope Control
 If the requested feature implies multiple independent concerns, create one primary spec for the smallest valuable slice and add a `Follow-up spec candidates` section.
 Examples of follow-up candidates:
 - assigned findings
 - pending approvals
 - personal work queue
 - notification delivery settings
 - evidence pack export hardening
 - operation monitoring refinements
 - autonomous governance decision surfaces
 Do not force all follow-up candidates into the primary spec.
 ## Implementation Loop
 Only execute this section when the selected mode is implementation-only or end-to-end.
 Execute the loop in bounded phases:
 1. Evaluate the Spec Readiness Gate.
 2. Evaluate the Implementation Scope Gate before changing application code.
 3. Implement the active Spec Kit feature scope.
 4. Run targeted tests and relevant static/dynamic checks.
 5. Evaluate the Test Gate.
 6. Run a Browser Smoke Test when the change affects UI/user-facing flows.
 7. Evaluate the Browser Smoke Test Gate as passed, failed, or not applicable with a reason.
 8. Run strict post-implementation analysis against spec, plan, tasks, constitution, changed code, changed tests, browser smoke results where applicable, and relevant existing patterns.
 9. Evaluate the Post-Implementation Analysis Gate.
 10. Identify confirmed findings by severity: Blocker, High, Medium, Low.
 11. Fix all confirmed in-scope findings regardless of severity when safe and bounded.
 12. Do not fix findings that require scope expansion, risky unrelated refactors, or architectural/product decisions outside the active spec; document them as follow-up/residual risks with reasons.
 13. Re-run relevant tests and browser smoke checks where applicable after fixes.
 14. Repeat test + browser smoke + analysis + fix loop until no confirmed in-scope findings remain or a stop condition is reached.
 15. Evaluate the Merge Readiness Gate.
 16. Report final implementation status, changed files, tests, browser smoke result, residual risks, failed/passed gates, and manual review prompt.
 ## Stop Conditions
 Stop the implementation loop when any of the following is true:
 - No confirmed in-scope findings remain.
 - The same finding appears twice after attempted fixes.
 - A required fix conflicts with the spec, plan, constitution, or repository architecture.
 - A required fix would expand scope beyond the active spec.
 - A required fix would require a risky unrelated refactor.
 - A required fix depends on an unresolved product or architecture decision.
 - Tests reveal an unrelated pre-existing failure that cannot be safely fixed inside the active spec.
 - Browser smoke testing reveals an unrelated pre-existing UI/runtime failure that cannot be safely fixed inside the active spec.
 - Three analysis/fix iterations have already been completed.
 - The repository state is ambiguous enough that continuing would risk damaging architecture or data semantics.
 When stopping before full cleanliness, report exactly why the loop stopped and what remains.
 ## Post-Implementation Analysis Prompt
 Use this prompt internally after implementation and after each fix iteration:
 ```markdown
 Du bist ein Senior Staff Software Engineer, Software Architect und Enterprise SaaS Reviewer.
 Analysiere die Implementierung der aktiven Spec streng repo-basiert.
 Ziel:
 Prüfe, ob die Umsetzung vollständig, konsistent, getestet und constitution-konform ist.
 Prüfe gegen:
 - spec.md
 - plan.md
 - tasks.md
 - .specify/memory/constitution.md
 - geänderte Anwendungscodes
 - geänderte Tests
 - Browser-Smoke-Test-Ergebnis, falls UI/user-facing Flows betroffen sind
 - bestehende Repository-Patterns
 Wichtig:
 - Keine Spekulation ohne Repo-Beleg.
 - Keine Scope-Erweiterung.
 - Keine neuen Produktideen als Pflicht-Fixes.
 - Findings nach Blocker, High, Medium, Low gruppieren.
 - Für jedes Finding konkrete Datei-/Code-Belege nennen.
 - Für jedes Finding eine minimale Remediation nennen.
 - Separat ausweisen, welche Findings innerhalb der aktiven Spec behoben werden müssen.
 - Medium/Low Findings innerhalb der aktiven Spec ebenfalls zur Behebung markieren, wenn sie sicher und bounded sind.
 - Bei UI-/Filament-/Livewire-Änderungen prüfen, ob ein Browser Smoke Test durchgeführt wurde und ob der getestete Operator-Flow wirklich funktioniert.
 - Findings, die nicht behoben werden sollen, nur als Follow-up/Residual Risk ausweisen, wenn sie out of scope, risky refactor, unrelated existing debt, not reproducible oder durch eine offene Produkt-/Architekturentscheidung blockiert sind.
 - Wenn keine bestätigten In-Scope Findings verbleiben, klare Implementierungsfreigabe geben.
 ```
 ## Task Completion Rules
 - Keep `tasks.md` aligned with actual implementation status.
 - Check off tasks only after the implementation and test evidence exists.
 - If a task is obsolete because repository truth proves a different path, update the task note with the reason instead of silently deleting it.
 - If a task cannot be completed inside scope, leave it unchecked and report why.
 ## Testing Rules
 - Add or update tests for all changed business behavior.
 - Include RBAC and workspace/tenant isolation tests where relevant.
 - Include OperationRun, audit, evidence, or result-truth tests where relevant.
 - Prefer regression tests for every fixed Blocker or High finding.
 - Add regression tests for Medium/Low findings when the behavior is important and testable without excessive churn.
 - Do not weaken tests to pass the suite.
 - Do not treat a green UI path as sufficient without backend or policy coverage when the behavior is security- or governance-relevant.
 ## Browser Smoke Test Rules
 Apply these rules when the active spec changes Filament UI, Livewire interactions, navigation, forms, tables, actions, modals, dashboards, operation drilldowns, tenant/workspace context, or any user-facing flow.
 The browser smoke test should be narrow and focused. It is not a full E2E suite unless explicitly requested.
 Minimum smoke path:
 1. Open the relevant page or entry point.
 2. Confirm the expected workspace/tenant context where relevant.
 3. Confirm the changed or newly introduced UI element is visible.
 4. Execute the primary action or interaction changed by the spec.
 5. Confirm the expected result state, notification, redirect, table update, modal state, operation link, or drilldown.
 6. Check for relevant console errors.
 7. Check for failed network requests related to the tested flow.
 8. Document the tested path in the final response.
 For TenantPilot/TenantAtlas, pay special attention to:
 - Filament actions and header actions
 - Livewire polling, modals, validation, and actions
 - workspace/tenant context preservation
 - RBAC/capability-dependent action visibility
 - OperationRun links and drilldown continuity
 - audit/evidence/result/support-diagnostic drilldowns where relevant
 - empty states, badges, labels, and decision guidance where relevant
 Browser smoke testing is required for UI/user-facing changes and optional for backend-only changes.
 Do not treat browser smoke success as proof that backend security, policies, domain logic, auditability, or workspace/tenant isolation are correct. Those still require automated tests or repo-based verification.
 ## Failure Handling
 If a Spec Kit command, preparation analyze phase, implementation step, test phase, browser smoke phase, or post-implementation analysis fails:
 1. Stop at the relevant gate or stop condition.
 2. Report the failing command or phase.
 3. Summarize the error.
 4. Do not attempt unrelated implementation as a workaround.
 5. Suggest the smallest safe next action.
 If the branch or working tree state is unsafe:
 1. Stop before running Spec Kit commands or implementation changes.
 2. Report the current branch and relevant uncommitted files.
 3. Ask the user to commit, stash, or move to a clean worktree.
 ## Final Response Requirements
 For preparation-only mode, respond with:
 1. Selected candidate and why it was chosen
 2. Why close alternatives were deferred
 3. Current branch after Spec Kit execution, if changed
 4. Generated spec path
 5. Files created or updated by Spec Kit
 6. Preparation analyze result summary
 7. Preparation-artifact fixes applied after analyze
 8. Assumptions made
 9. Open questions, if any
 10. Quality gates evaluated and their result
 11. Recommended next implementation prompt
 12. Explicit statement that no application implementation was performed
 For implementation-only or end-to-end mode, respond with:
 1. Active spec directory
 2. Summary of implemented changes
 3. Tests/checks run and their results
 4. Browser smoke test result, tested path, or not-applicable reason
 5. Quality gates passed/failed and number of analysis/fix iterations performed
 6. Remaining in-scope findings, if any
 7. Residual risks and follow-up candidates, if relevant
 8. Files changed
 9. Explicit statement whether the Merge Readiness Gate passed and whether the implementation is ready for manual review/merge
 Keep the final response concise, but include enough detail for the user to continue immediately.
 ## Manual Review Prompts
 For preparation-only mode, provide a ready-to-copy prompt like this, adapted to the generated spec branch/path:
 ```markdown
 Du bist ein Senior Staff Software Architect und Enterprise SaaS Reviewer.
 Analysiere die neu erstellte Spec `<spec-branch-or-spec-path>` streng repo-basiert.
 Ziel:
 Prüfe, ob `spec.md`, `plan.md` und `tasks.md` vollständig, konsistent, implementierbar und constitution-konform sind.
 Wichtig:
 - Keine Implementierung.
 - Keine Codeänderungen.
 - Keine Scope-Erweiterung.
 - Prüfe nur gegen Repo-Wahrheit.
 - Benenne konkrete Konflikte mit Dateien, Patterns, Datenflüssen oder bestehenden Specs.
 - Schlage nur minimale Korrekturen an `spec.md`, `plan.md` und `tasks.md` vor.
 - Wenn alles passt, gib eine klare Implementierungsfreigabe.
 ```
 For preparation-only mode, also provide a ready-to-copy implementation prompt after analyze has passed or preparation-artifact issues have been fixed:
 ```markdown
 Du bist ein Senior Staff Software Engineer für TenantPilot/TenantAtlas.
 Implementiere die vorbereitete Spec `<spec-branch-or-spec-path>` streng anhand von `tasks.md`.
 Wichtig:
 - Arbeite task-sequenziell.
 - Ändere nur Dateien, die für die jeweilige Task notwendig sind.
 - Halte dich an `spec.md`, `plan.md`, `tasks.md` und die Constitution.
 - Keine Scope-Erweiterung.
 - Keine Opportunistic Refactors.
 - Führe passende Tests nach sinnvollen Task-Gruppen aus.
 - Wenn eine Task unklar oder falsch ist, stoppe und dokumentiere den Konflikt statt frei zu improvisieren.
 - Am Ende liefere geänderte Dateien, Teststatus, offene Risiken und nicht erledigte Tasks.
 ```
 For implementation-only or end-to-end mode, provide a ready-to-copy prompt like this, adapted to the active spec number and slug:
 ```markdown
 Du bist ein Senior Staff Software Architect und Enterprise SaaS Reviewer.
 Führe eine finale manuelle Review der implementierten Spec `<spec-number>-<slug>` streng repo-basiert durch.
 Ziel:
 Prüfe, ob die Implementierung nach dem Agenten-Loop wirklich merge-ready ist.
 Wichtig:
 - Keine Implementierung.
 - Keine Codeänderungen.
 - Keine Scope-Erweiterung.
 - Prüfe gegen spec.md, plan.md, tasks.md und constitution.md.
 - Prüfe die geänderten Dateien, Tests, Browser-Smoke-Test-Ergebnis, RBAC, Workspace-/Tenant-Isolation, Auditability, UX und OperationRun-Semantik, soweit relevant.
 - Benenne nur konkrete Findings mit Repo-Beleg.
 - Gib am Ende eine klare Entscheidung: Merge-ready, merge-ready with notes, oder not merge-ready.
 ```
 ## Example Invocations
 User:
 ```text
 Nutze den Skill spec-kit-end-to-end.
 Wähle aus roadmap.md und spec-candidates.md die nächste sinnvollste Spec.
 Führe danach GitHub Spec Kit specify, plan, tasks und analyze in einem Rutsch aus.
 Behebe alle analyze-Issues in den Spec-Kit-Artefakten.
 Keine Application-Implementierung.
 ```
 Expected behavior:
 1. Inspect constitution, Spec Kit scripts/templates, specs, roadmap, and spec candidates.
 2. Check branch and working tree safety.
 3. Compare candidate suitability.
 4. Select the next best candidate.
 5. Evaluate the Candidate Selection Gate.
 6. Run the repository's real Spec Kit `specify` flow, letting it handle branch/spec setup.
 7. Run the repository's real Spec Kit `plan` flow.
 8. Run the repository's real Spec Kit `tasks` flow.
 9. Run the repository's real Spec Kit preparation `analyze` flow.
 10. Fix analyze issues only in Spec Kit preparation artifacts.
 11. Evaluate the Spec Readiness Gate.
 12. Stop before application implementation.
 13. Return selection rationale, branch/path summary, artifact summary, analyze summary, fixes applied, gates, and next implementation prompt.
 User:
 ```text
 Implementiere die aktive Spec. Danach analyse gegen spec/plan/tasks/constitution ausführen, alle in-scope Findings beheben und wiederhole bis sauber.
 ```
 Expected behavior:
 1. Inspect active Spec Kit context, constitution, spec, plan, tasks, relevant code, and relevant tests.
 2. Evaluate the Spec Readiness Gate and Implementation Scope Gate.
 3. Implement only the active spec scope.
 4. Run targeted tests and relevant checks.
 5. Evaluate the Test Gate.
 6. Run and evaluate Browser Smoke Test when UI/user-facing flows are affected.
 7. Run post-implementation analysis.
 8. Fix all confirmed in-scope findings regardless of severity when safe and bounded.
 9. Repeat test + browser smoke + analysis + fix loop up to the stop conditions.
 10. Evaluate the Merge Readiness Gate.
 11. Report final status, changed files, tests, browser smoke result, residual risks, gates, and manual review prompt.
 User:
 ```text
 Run end-to-end: wähle die nächste sinnvolle Spec aus spec-candidates/roadmap, erstelle spec/plan/tasks, implementiere sie danach und wiederhole analyse/fix bis sauber.
 ```
 Expected behavior:
 1. Run preparation mode first.
 2. Clearly report the selected candidate and created spec directory.
 3. Continue into implementation mode only because the user explicitly requested end-to-end execution.
 4. Implement only the newly created active spec scope.
 5. Run tests/checks, browser smoke checks where applicable, post-implementation analysis, and bounded fix iterations.
 6. Fix all confirmed in-scope findings regardless of severity when safe and bounded.
 7. Report final implementation status, gates, browser smoke result, and residual risks.
 ```
--- a/.github/skills/spec-kit-implementation-loop/SKILL.md
+++ b/.github/skills/spec-kit-implementation-loop/SKILL.md
@ -0,0 +1,447 @@
 ---
 name: spec-kit-implementation-loop
 description: Implement an existing TenantPilot/TenantAtlas Spec Kit feature, run tests, browser smoke checks where applicable, post-implementation analysis, fix all confirmed in-scope findings when safe and bounded, and repeat until no in-scope findings remain or a stop condition is reached.
 ---
 # Skill: Spec Kit Implementation Loop
 ## Purpose
 Use this skill to implement an already prepared TenantPilot/TenantAtlas Spec Kit feature and verify it with a bounded implementation loop.
 This skill assumes `spec.md`, `plan.md`, and `tasks.md` already exist and have passed preparation readiness or have been explicitly accepted by the user.
 The intended workflow is:
 ```text
 active or explicitly named spec
 → inspect repo truth, constitution, spec, plan, tasks, and relevant code/tests
 → evaluate implementation gates
 → implement strictly task-by-task
 → run relevant tests/checks
 → run browser smoke test when UI/user-facing flows are affected
 → run strict post-implementation analysis
 → fix confirmed in-scope findings
 → repeat test + browser smoke + analysis + fix loop until clean or bounded stop condition is reached
 → final implementation report
 ```
 ## When to Use
 Use this skill when the user asks to:
 - implement an active or explicitly named Spec Kit feature
 - run Spec Kit implement
 - analyze after implementation
 - fix implementation findings
 - repeat implementation verification until no confirmed in-scope findings remain
 - run tests and browser smoke checks after implementation
 Typical user prompts:
 ```text
 Implementiere die aktive Spec und analysiere danach, ob alles passt.
 ```
 ```text
 Implementiere specs/243-product-usage-adoption-telemetry streng nach tasks.md.
 ```
 ```text
 Mach Spec Kit implement und danach analyse. Behebe alle Abweichungen und wiederhole bis sauber.
 ```
 ```text
 Implementiere die vorbereitete Spec. Danach Tests, Browser Smoke Test falls UI betroffen ist, Analyse und Fix-Loop bis keine In-Scope Findings mehr offen sind.
 ```
 ## Hard Rules
 - Work strictly repo-based.
 - Implement only the active or explicitly named Spec Kit feature.
 - Do not choose a new candidate.
 - Do not create a new spec.
 - Do not expand scope beyond `spec.md`, `plan.md`, and `tasks.md`.
 - Do not silently add roadmap features, adjacent UX rewrites, speculative architecture, or unrelated refactors.
 - Follow the repository constitution and existing Spec Kit conventions.
 - Preserve TenantPilot/TenantAtlas terminology.
 - Prefer small, reviewable patches over broad rewrites.
 - Treat repository truth as authoritative over assumptions.
 - If repository truth conflicts with implementation scope, stop and report the conflict unless there is an obvious minimal correction inside active spec scope.
 - Fix only confirmed findings from tests, static checks, browser smoke checks, or post-implementation analysis.
 - Fix all confirmed in-scope findings, regardless of severity, when they are safe and bounded.
 - Do not leave Medium/Low findings open silently. If they are not fixed, document exactly why.
 - Never hide failing tests, weaken assertions, delete meaningful coverage, or mark tasks complete without implementation evidence.
 - Do not run destructive commands.
 - Do not force checkout, reset, stash, rebase, merge, or delete branches.
 - Do not perform database-destructive actions unless the repository test workflow explicitly requires isolated test database resets.
 - Do not continue analysis/fix loops indefinitely.
 - Do not move from implementation to final status unless the Test Gate, Browser Smoke Test Gate where applicable, and Post-Implementation Analysis Gate have been evaluated.
 - Do not claim merge-readiness unless the Merge Readiness Gate passes.
 ## Required Inputs
 The user should provide at least one of:
 - explicit spec directory such as `specs/<number>-<slug>/`
 - instruction to use the current active Spec Kit feature
 - instruction to implement the prepared/current spec
 If the active spec cannot be determined safely, inspect the repository Spec Kit context first. If it is still ambiguous, stop and ask for the specific spec directory.
 ## Required Repository Checks
 Always check:
 1. active Spec Kit context / current branch
 2. git status
 3. `.specify/memory/constitution.md`
 4. the active spec directory
 5. `spec.md`
 6. `plan.md`
 7. `tasks.md`
 8. relevant templates or conventions under `.specify/templates/`
 9. nearby existing specs with related terminology or scope
 10. application code surfaces referenced by the active spec
 11. existing tests related to the changed behavior
 ## Git and Branch Safety
 Before making implementation changes:
 1. Check the current branch.
 2. Check whether the working tree is clean.
 3. If there are unrelated uncommitted changes, stop and report them. Do not continue.
 4. If the working tree only contains user-intended changes for this operation, continue cautiously.
 5. Do not force checkout, reset, stash, rebase, merge, or delete branches.
 6. Do not overwrite unrelated work.
 ## Quality Gates
 ### Gate 1: Spec Readiness Gate
 Required before implementation starts.
 Pass criteria:
 - `spec.md`, `plan.md`, and `tasks.md` exist.
 - The spec has clear problem statement, user value, functional requirements, out-of-scope boundaries, acceptance criteria, assumptions, and risks.
 - The plan identifies likely affected repo surfaces and does not contradict repository architecture.
 - The tasks are small, ordered, verifiable, and include test/validation tasks.
 - RBAC, workspace/tenant isolation, auditability, OperationRun semantics, evidence/result-truth, and UX requirements are addressed where relevant.
 - No open question blocks safe implementation.
 - The scope is small enough for a bounded implementation loop.
 Fail behavior:
 - Stop before implementation.
 - Report readiness gaps.
 - Do not compensate for an unclear spec by inventing implementation scope.
 ### Gate 2: Implementation Scope Gate
 Required before changing application code.
 Pass criteria:
 - The active spec directory is known.
 - The implementation target is traceable to specific tasks in `tasks.md`.
 - The affected files/surfaces are consistent with `plan.md` or clearly justified by repository truth.
 - No required change would introduce unrelated product behavior.
 - No required change conflicts with constitution, existing architecture, RBAC/isolation boundaries, or source-of-truth semantics.
 Fail behavior:
 - Stop before code changes and report the conflict or ambiguity.
 - Suggest a minimal spec/plan/tasks correction if the issue is in the artifacts rather than the codebase.
 ### Gate 3: Test Gate
 Required after implementation and after each fix iteration.
 Pass criteria:
 - Targeted tests for changed behavior pass.
 - Relevant existing tests pass or failures are proven unrelated and documented.
 - Static analysis, linting, formatting, or type checks used by the repository pass when applicable.
 - Security/governance-relevant changes have backend, policy, or domain coverage; UI-only verification is not enough.
 - Regression coverage exists for each fixed Blocker or High finding where practical.
 Fail behavior:
 - Fix in-scope failures before post-implementation analysis.
 - If failures are unrelated or pre-existing, document evidence and continue only if they do not invalidate the active spec.
 - Do not weaken tests to pass the gate.
 ### Gate 4: Browser Smoke Test Gate
 Required before claiming implementation is ready for manual review/merge when the change affects Filament UI, Livewire interactions, navigation, forms, tables, actions, modals, dashboards, operation drilldowns, tenant/workspace context, or any user-facing flow.
 Not required for backend-only, domain-only, enum-only, contract-only, or test-only changes unless those changes alter a user-facing flow.
 Pass criteria:
 - The relevant page or flow loads in a real browser or the repository's browser-testing harness.
 - The primary action introduced or changed by the spec can be executed successfully.
 - Expected UI states, labels, badges, actions, empty states, tables, forms, modals, and navigation are visible where relevant.
 - Workspace/tenant context is preserved across the tested flow where relevant.
 - RBAC/capability-dependent visibility behaves as expected where practical to verify.
 - Livewire interactions complete without visible runtime errors.
 - No relevant browser console errors occur.
 - No failed network requests occur for the tested flow, except known unrelated development noise that is explicitly documented.
 - OperationRun, audit, evidence, result, or support-diagnostic drilldowns work where relevant.
 - The smoke-tested path is documented in the final response.
 Fail behavior:
 - Fix in-scope browser, UX, Livewire, navigation, or runtime failures before claiming merge-readiness.
 - If a browser issue is unrelated existing debt, document evidence and residual risk.
 - Do not treat a passing browser smoke test as a substitute for backend, policy, domain, security, feature, or integration tests.
 - Do not expand the smoke test into a full E2E suite unless the user explicitly asks for that.
 ### Gate 5: Post-Implementation Analysis Gate
 Required after implementation and after each fix iteration.
 Pass criteria:
 - The implementation has been checked against `spec.md`, `plan.md`, `tasks.md`, and constitution.
 - All completed tasks have implementation evidence.
 - No confirmed in-scope findings remain.
 - Medium/Low findings are fixed when they are inside active spec scope, clearly bounded, and safe.
 - Medium/Low findings that remain open are explicitly documented with one of these reasons:
  - out of scope
  - requires separate spec
  - risky refactor
  - existing unrelated debt
  - not reproducible
  - blocked by unclear product/architecture decision
 - No scope expansion was introduced during fixes.
 Fail behavior:
 - Fix confirmed in-scope findings, regardless of severity, when the fix is safe and bounded.
 - Stop instead of fixing when remediation would expand scope, contradict repo architecture, introduce risky refactors, or repeat the same failed fix twice.
 ### Gate 6: Merge Readiness Gate
 Required before claiming the implementation is ready for manual review/merge.
 Pass criteria:
 - Spec Readiness Gate passed.
 - Implementation Scope Gate passed.
 - Test Gate passed.
 - Browser Smoke Test Gate passed when applicable, or was explicitly marked not applicable with a reason.
 - Post-Implementation Analysis Gate passed.
 - `tasks.md` reflects actual completion status.
 - No confirmed in-scope findings remain.
 - All remaining findings are documented as out-of-scope, follow-up candidates, unrelated existing debt, or explicit residual risks.
 - Final response includes changed files, tests/checks run, browser smoke result, iterations performed, residual risks, and follow-up candidates.
 Fail behavior:
 - Do not claim merge-readiness.
 - Report the failed gate, remaining risks, and the smallest recommended next action.
 ## Implementation Loop
 Execute the loop in bounded phases:
 1. Evaluate the Spec Readiness Gate.
 2. Evaluate the Implementation Scope Gate before changing application code.
 3. Implement the active Spec Kit feature scope task-by-task.
 4. Run targeted tests and relevant static/dynamic checks.
 5. Evaluate the Test Gate.
 6. Run a Browser Smoke Test when the change affects UI/user-facing flows.
 7. Evaluate the Browser Smoke Test Gate as passed, failed, or not applicable with a reason.
 8. Run strict post-implementation analysis against spec, plan, tasks, constitution, changed code, changed tests, browser smoke results where applicable, and relevant existing patterns.
 9. Evaluate the Post-Implementation Analysis Gate.
 10. Identify confirmed findings by severity: Blocker, High, Medium, Low.
 11. Fix all confirmed in-scope findings regardless of severity when safe and bounded.
 12. Do not fix findings that require scope expansion, risky unrelated refactors, or architectural/product decisions outside the active spec; document them as follow-up/residual risks with reasons.
 13. Re-run relevant tests and browser smoke checks where applicable after fixes.
 14. Repeat test + browser smoke + analysis + fix loop until no confirmed in-scope findings remain or a stop condition is reached.
 15. Evaluate the Merge Readiness Gate.
 16. Report final implementation status, changed files, tests, browser smoke result, residual risks, failed/passed gates, and manual review prompt.
 ## Stop Conditions
 Stop the implementation loop when any of the following is true:
 - No confirmed in-scope findings remain.
 - The same finding appears twice after attempted fixes.
 - A required fix conflicts with the spec, plan, constitution, or repository architecture.
 - A required fix would expand scope beyond the active spec.
 - A required fix would require a risky unrelated refactor.
 - A required fix depends on an unresolved product or architecture decision.
 - Tests reveal an unrelated pre-existing failure that cannot be safely fixed inside the active spec.
 - Browser smoke testing reveals an unrelated pre-existing UI/runtime failure that cannot be safely fixed inside the active spec.
 - Three analysis/fix iterations have already been completed.
 - The repository state is ambiguous enough that continuing would risk damaging architecture or data semantics.
 When stopping before full cleanliness, report exactly why the loop stopped and what remains.
 ## Post-Implementation Analysis Prompt
 Use this prompt internally after implementation and after each fix iteration:
 ```markdown
 Du bist ein Senior Staff Software Engineer, Software Architect und Enterprise SaaS Reviewer.
 Analysiere die Implementierung der aktiven Spec streng repo-basiert.
 Ziel:
 Prüfe, ob die Umsetzung vollständig, konsistent, getestet und constitution-konform ist.
 Prüfe gegen:
 - spec.md
 - plan.md
 - tasks.md
 - .specify/memory/constitution.md
 - geänderte Anwendungscodes
 - geänderte Tests
 - Browser-Smoke-Test-Ergebnis, falls UI/user-facing Flows betroffen sind
 - bestehende Repository-Patterns
 Wichtig:
 - Keine Spekulation ohne Repo-Beleg.
 - Keine Scope-Erweiterung.
 - Keine neuen Produktideen als Pflicht-Fixes.
 - Findings nach Blocker, High, Medium, Low gruppieren.
 - Für jedes Finding konkrete Datei-/Code-Belege nennen.
 - Für jedes Finding eine minimale Remediation nennen.
 - Separat ausweisen, welche Findings innerhalb der aktiven Spec behoben werden müssen.
 - Medium/Low Findings innerhalb der aktiven Spec ebenfalls zur Behebung markieren, wenn sie sicher und bounded sind.
 - Bei UI-/Filament-/Livewire-Änderungen prüfen, ob ein Browser Smoke Test durchgeführt wurde und ob der getestete Operator-Flow wirklich funktioniert.
 - Findings, die nicht behoben werden sollen, nur als Follow-up/Residual Risk ausweisen, wenn sie out of scope, risky refactor, unrelated existing debt, not reproducible oder durch eine offene Produkt-/Architekturentscheidung blockiert sind.
 - Wenn keine bestätigten In-Scope Findings verbleiben, klare Implementierungsfreigabe geben.
 ```
 ## Task Completion Rules
 - Keep `tasks.md` aligned with actual implementation status.
 - Check off tasks only after the implementation and test evidence exists.
 - If a task is obsolete because repository truth proves a different path, update the task note with the reason instead of silently deleting it.
 - If a task cannot be completed inside scope, leave it unchecked and report why.
 ## Testing Rules
 - Add or update tests for all changed business behavior.
 - Include RBAC and workspace/tenant isolation tests where relevant.
 - Include OperationRun, audit, evidence, or result-truth tests where relevant.
 - Prefer regression tests for every fixed Blocker or High finding.
 - Add regression tests for Medium/Low findings when the behavior is important and testable without excessive churn.
 - Do not weaken tests to pass the suite.
 - Do not treat a green UI path as sufficient without backend or policy coverage when the behavior is security- or governance-relevant.
 ## Browser Smoke Test Rules
 Apply these rules when the active spec changes Filament UI, Livewire interactions, navigation, forms, tables, actions, modals, dashboards, operation drilldowns, tenant/workspace context, or any user-facing flow.
 The browser smoke test should be narrow and focused. It is not a full E2E suite unless explicitly requested.
 Minimum smoke path:
 1. Open the relevant page or entry point.
 2. Confirm the expected workspace/tenant context where relevant.
 3. Confirm the changed or newly introduced UI element is visible.
 4. Execute the primary action or interaction changed by the spec.
 5. Confirm the expected result state, notification, redirect, table update, modal state, operation link, or drilldown.
 6. Check for relevant console errors.
 7. Check for failed network requests related to the tested flow.
 8. Document the tested path in the final response.
 For TenantPilot/TenantAtlas, pay special attention to:
 - Filament actions and header actions
 - Livewire polling, modals, validation, and actions
 - workspace/tenant context preservation
 - RBAC/capability-dependent action visibility
 - OperationRun links and drilldown continuity
 - audit/evidence/result/support-diagnostic drilldowns where relevant
 - empty states, badges, labels, and decision guidance where relevant
 Browser smoke testing is required for UI/user-facing changes and optional for backend-only changes.
 Do not treat browser smoke success as proof that backend security, policies, domain logic, auditability, or workspace/tenant isolation are correct. Those still require automated tests or repo-based verification.
 ## Failure Handling
 If an implementation step, test phase, browser smoke phase, or post-implementation analysis fails:
 1. Stop at the relevant gate or stop condition.
 2. Report the failing command or phase.
 3. Summarize the error.
 4. Do not attempt unrelated implementation as a workaround.
 5. Suggest the smallest safe next action.
 If the branch or working tree state is unsafe:
 1. Stop before implementation changes.
 2. Report the current branch and relevant uncommitted files.
 3. Ask the user to commit, stash, or move to a clean worktree.
 ## Final Response Requirements
 Respond with:
 1. Active spec directory
 2. Summary of implemented changes
 3. Tests/checks run and their results
 4. Browser smoke test result, tested path, or not-applicable reason
 5. Quality gates passed/failed and number of analysis/fix iterations performed
 6. Remaining in-scope findings, if any
 7. Residual risks and follow-up candidates, if relevant
 8. Files changed
 9. Explicit statement whether the Merge Readiness Gate passed and whether the implementation is ready for manual review/merge
 Keep the final response concise, but include enough detail for the user to continue immediately.
 ## Manual Review Prompt
 Provide a ready-to-copy prompt like this, adapted to the active spec number and slug:
 ```markdown
 Du bist ein Senior Staff Software Architect und Enterprise SaaS Reviewer.
 Führe eine finale manuelle Review der implementierten Spec `<spec-number>-<slug>` streng repo-basiert durch.
 Ziel:
 Prüfe, ob die Implementierung nach dem Agenten-Loop wirklich merge-ready ist.
 Wichtig:
 - Keine Implementierung.
 - Keine Codeänderungen.
 - Keine Scope-Erweiterung.
 - Prüfe gegen spec.md, plan.md, tasks.md und constitution.md.
 - Prüfe die geänderten Dateien, Tests, Browser-Smoke-Test-Ergebnis, RBAC, Workspace-/Tenant-Isolation, Auditability, UX und OperationRun-Semantik, soweit relevant.
 - Benenne nur konkrete Findings mit Repo-Beleg.
 - Gib am Ende eine klare Entscheidung: Merge-ready, merge-ready with notes, oder not merge-ready.
 ```
 ## Example Invocation
 User:
 ```text
 Nutze den Skill spec-kit-implementation-loop.
 Implementiere die aktive Spec.
 Danach Tests ausführen, Browser Smoke Test falls UI/user-facing betroffen ist, Post-Implementation Analyse durchführen und alle bestätigten In-Scope Findings unabhängig von Severity beheben, wenn safe und bounded.
 Wiederhole test + browser smoke + analysis + fix bis keine In-Scope Findings mehr offen sind oder eine Stop Condition greift.
 ```
 Expected behavior:
 1. Inspect active Spec Kit context, constitution, spec, plan, tasks, relevant code, and relevant tests.
 2. Evaluate the Spec Readiness Gate and Implementation Scope Gate.
 3. Implement only the active spec scope.
 4. Run targeted tests and relevant checks.
 5. Evaluate the Test Gate.
 6. Run and evaluate Browser Smoke Test when UI/user-facing flows are affected.
 7. Run post-implementation analysis.
 8. Fix all confirmed in-scope findings regardless of severity when safe and bounded.
 9. Repeat test + browser smoke + analysis + fix loop up to the stop conditions.
 10. Evaluate the Merge Readiness Gate.
 11. Report final status, changed files, tests, browser smoke result, residual risks, gates, and manual review prompt.
 ```
--- a/.github/skills/spec-kit-next-best-prep/SKILL.md
+++ b/.github/skills/spec-kit-next-best-prep/SKILL.md
@ -0,0 +1,562 @@
 ---
 name: spec-kit-next-best-prep
 description: Select the next suitable TenantPilot/TenantAtlas spec candidate from roadmap/spec-candidates, run the repository's Spec Kit preparation flow, create or update spec.md/plan.md/tasks.md, run preparation analysis, fix preparation-artifact issues only, and stop before application implementation.
 ---
 # Skill: Spec Kit Next-Best Preparation
 ## Purpose
 Use this skill to prepare the next implementation-ready Spec Kit package for TenantPilot/TenantAtlas without implementing application code.
 This skill supports preparation only:
 1. Select or scope the next suitable feature from roadmap/spec-candidates.
 2. Run the repository's real Spec Kit preparation workflow where available.
 3. Create or update `spec.md`, `plan.md`, and `tasks.md`.
 4. Run preparation `analyze` when supported.
 5. Fix preparation-artifact issues only.
 6. Evaluate preparation quality gates.
 7. Stop before application implementation.
 The intended workflow is:
 ```text
 roadmap / spec-candidates / feature idea
 → inspect repo truth, constitution, roadmap, spec candidates, existing specs, and relevant code
 → select the next suitable candidate or scope the provided idea
 → run Spec Kit specify/plan/tasks/analyze where available
 → create or update spec.md + plan.md + tasks.md
 → fix preparation-artifact issues only
 → evaluate Candidate Selection Gate and Spec Readiness Gate
 → final preparation report
 → explicit implementation step later
 ```
 ## When to Use
 Use this skill when the user asks to:
 - select the next best spec candidate from `docs/product/spec-candidates.md` and roadmap sources
 - turn a feature idea, roadmap item, or candidate into `spec.md`, `plan.md`, and `tasks.md`
 - prepare Spec Kit artifacts in one pass
 - run specify/plan/tasks/analyze without implementation
 - fix preparation analysis issues in Spec Kit artifacts only
 - prepare a feature package for a later implementation skill
 Typical user prompts:
 ```text
 Nimm den nächsten sinnvollen Spec Candidate aus Roadmap/spec-candidates und mach spec, plan und tasks.
 ```
 ```text
 Mach daraus spec, plan und tasks in einem Rutsch, aber noch nicht implementieren.
 ```
 ```text
 Wähle aus roadmap.md und spec-candidates.md die nächste sinnvollste Spec und führe specify, plan, tasks und analyze aus.
 ```
 ```text
 Behebe alle analyze-Issues in den Spec-Kit-Artefakten. Keine Application-Implementierung.
 ```
 ## Hard Rules
 - Work strictly repo-based.
 - This is a preparation-only skill.
 - Do not implement application code.
 - Do not modify production code.
 - Do not modify migrations, models, services, jobs, Filament resources, Livewire components, policies, commands, routes, views, tests, or runtime behavior.
 - Use the repository's actual Spec Kit workflow, scripts, templates, branch naming rules, and generated paths when available.
 - Do not manually invent spec numbers, branch names, or spec paths if Spec Kit provides a script or command for that.
 - Do not bypass Spec Kit branch mechanics.
 - Create or update only Spec Kit preparation artifacts unless repository conventions require additional documentation artifacts.
 - Do not expand scope beyond the selected feature, `spec.md`, `plan.md`, and `tasks.md`.
 - Do not silently add roadmap features, adjacent UX rewrites, speculative architecture, or unrelated refactors.
 - Follow the repository constitution and existing Spec Kit conventions.
 - Preserve TenantPilot/TenantAtlas terminology.
 - Prefer small, reviewable, implementation-ready specs over broad rewrites.
 - Treat repository truth as authoritative over assumptions.
 - If repository truth conflicts with the user-provided draft or candidate wording, keep repository truth and document the deviation.
 - Fix only confirmed preparation-artifact findings from Spec Kit preparation analysis.
 - Do not leave preparation findings open silently. If they are not fixed, document exactly why.
 - Do not run destructive commands.
 - Do not force checkout, reset, stash, rebase, merge, or delete branches.
 - Do not overwrite existing specs.
 - Do not move from preparation to an implementation step inside this skill.
 ## Required Inputs
 The user should provide at least one of:
 - feature title and short goal
 - full spec candidate
 - roadmap item
 - rough problem statement
 - UX or architecture improvement idea
 - instruction to choose the next best candidate from roadmap/spec-candidates
 If the input is incomplete, proceed with the smallest reasonable interpretation and document assumptions.
 If no suitable candidate can be selected safely, stop and report why.
 ## Required Repository Checks
 Always check:
 1. `.specify/memory/constitution.md`
 2. `.specify/templates/`
 3. `.specify/scripts/`
 4. existing Spec Kit command usage or repository instructions, if present
 5. current branch and git status
 6. `specs/`
 7. `docs/product/spec-candidates.md`
 8. relevant roadmap documents under `docs/product/`, especially `roadmap.md` if present
 9. nearby existing specs with related terminology or scope
 10. application code only as needed to avoid wrong naming, wrong architecture, duplicate concepts, impossible tasks, duplicated specs, or already-completed candidates
 Do not edit application code.
 ## Git and Branch Safety
 Before running any Spec Kit command:
 1. Check the current branch.
 2. Check whether the working tree is clean.
 3. If there are unrelated uncommitted changes, stop and report them. Do not continue.
 4. If the working tree only contains user-intended planning edits for this operation, continue cautiously.
 5. Let Spec Kit create or switch to the correct feature branch when that is how the repository workflow works.
 6. Do not force checkout, reset, stash, rebase, merge, or delete branches.
 7. Do not overwrite existing specs.
 If the repo requires an explicit branch creation script for `specify`, use that script rather than manually creating the branch.
 ## Quality Gates
 ### Gate 1: Candidate Selection Gate
 Required before creating a new spec from roadmap/spec-candidates.
 Pass criteria:
 - The selected candidate exists in roadmap/spec-candidate material or is directly provided by the user.
 - The selected candidate is not already covered by an existing active or completed spec.
 - The selected candidate aligns with current roadmap priorities or explicitly documented product direction.
 - The candidate can be scoped as a small, reviewable, implementation-ready slice.
 - Major adjacent concerns are listed as follow-up candidates instead of being hidden inside the primary scope.
 Fail behavior:
 - If no candidate satisfies the gate, stop and report the top candidates plus the reason none is ready.
 - Do not invent a new roadmap direction to force progress.
 ### Gate 2: Spec Readiness Gate
 Required before reporting that the package is ready for implementation.
 Pass criteria:
 - `spec.md`, `plan.md`, and `tasks.md` exist.
 - The spec has clear problem statement, user value, functional requirements, out-of-scope boundaries, acceptance criteria, assumptions, and risks.
 - The plan identifies likely affected repo surfaces and does not contradict repository architecture.
 - The tasks are small, ordered, verifiable, and include test/validation tasks.
 - RBAC, workspace/tenant isolation, auditability, OperationRun semantics, evidence/result-truth, and UX requirements are addressed where relevant.
 - No open question blocks safe implementation.
 - The scope is small enough for a bounded implementation loop in a later implementation skill.
 - Required checklist artifacts exist when the constitution requires them.
 Fail behavior:
 - Fix preparation-artifact issues when they are safe and bounded.
 - If readiness cannot be achieved without implementation or unresolved product decisions, stop and report the gap.
 - Do not compensate for an unclear spec by inventing implementation scope.
 ## Candidate Selection Rules
 When the user asks for the next best spec from roadmap/spec-candidates:
 - Read `docs/product/spec-candidates.md`.
 - Read relevant roadmap documents under `docs/product/`, especially `roadmap.md` if present.
 - Check existing specs to avoid duplicates.
 - Prefer candidates that align with current roadmap priorities, platform foundations, enterprise UX, RBAC/isolation, auditability, observability, and governance workflow maturity.
 - Prefer candidates that unlock roadmap progress, reduce architectural drift, harden foundations, or remove known blockers.
 - Prefer small, implementation-ready slices over broad platform rewrites.
 - If multiple candidates are plausible, choose one primary candidate and document why it was selected.
 - Add non-selected relevant candidates as follow-up spec candidates, not hidden scope.
 - Do not invent a candidate if existing roadmap/spec-candidate material provides a suitable one.
 - Do not pick a spec only because it is listed first.
 - Evaluate the Candidate Selection Gate before creating the spec directory.
 Evaluate candidates using these criteria:
 1. **Roadmap Fit**: Does it support the current roadmap sequence or unlock the next roadmap layer?
 2. **Foundation Value**: Does it strengthen reusable platform foundations such as RBAC, isolation, auditability, evidence, OperationRun observability, provider boundaries, vocabulary, baseline/control/finding semantics, or enterprise UX patterns?
 3. **Dependency Unblocking**: Does it make future specs smaller, safer, or more consistent?
 4. **Scope Size**: Can it be implemented as a narrow, testable slice?
 5. **Repo Readiness**: Does the repo already have enough structure to implement the next slice safely?
 6. **Risk Reduction**: Does it reduce current architectural or product risk?
 7. **User/Product Value**: Does it produce visible operator value or make the platform more sellable without heavy scope?
 ## Required Selection Output Before Spec Kit Execution
 Before running the Spec Kit flow, identify:
 - selected candidate title
 - source location in roadmap/spec-candidates
 - why it was selected
 - why close alternatives were deferred
 - roadmap relationship
 - smallest viable implementation slice
 - proposed concise feature description to feed into `specify`
 The feature description must be product- and behavior-oriented. It should not be a low-level implementation plan.
 ## Spec Kit Preparation Flow
 ### Step 1: Determine the repository's Spec Kit command pattern
 Inspect repository instructions and scripts to identify how this repo expects Spec Kit to be run.
 Common locations to inspect:
 ```text
 .specify/scripts/
 .specify/templates/
 .specify/memory/constitution.md
 .github/prompts/
 .github/skills/
 README.md
 specs/
 ```
 Use the repo-specific mechanism if present.
 ### Step 2: Run `specify`
 Run the repository's `specify` flow using the selected candidate and the smallest viable slice.
 The `specify` input should include:
 - selected candidate title
 - problem statement
 - operator/user value
 - roadmap relationship
 - out-of-scope boundaries
 - key acceptance criteria
 - important enterprise constraints
 Let Spec Kit create the correct branch and spec location if that is the repo's configured behavior.
 ### Step 3: Run `plan`
 Run the repository's `plan` flow for the generated spec.
 The `plan` input should keep the scope tight and should require repo-based alignment with:
 - constitution
 - existing architecture
 - workspace/tenant isolation
 - RBAC
 - OperationRun/observability where relevant
 - evidence/snapshot/truth semantics where relevant
 - Filament/Livewire conventions where relevant
 - test strategy
 ### Step 4: Run `tasks`
 Run the repository's `tasks` flow for the generated plan.
 The generated tasks must be:
 - ordered
 - small
 - testable
 - grouped by phase
 - limited to the selected scope
 - suitable for later implementation or manual analysis before implementation
 ### Step 5: Run preparation `analyze`
 Run the repository's `analyze` flow against the generated Spec Kit artifacts when the repository supports it.
 Analyze must check:
 - consistency between `spec.md`, `plan.md`, and `tasks.md`
 - constitution alignment
 - roadmap alignment
 - whether the selected candidate was narrowed safely
 - whether tasks are complete enough for implementation
 - whether tasks accidentally require scope not described in the spec
 - whether plan details conflict with repository architecture or terminology
 - whether implementation risks are documented instead of silently ignored
 Do not use analyze as a trigger to implement application code.
 ### Step 6: Fix preparation-artifact issues only
 If preparation analyze finds issues, fix only Spec Kit preparation artifacts such as:
 - `spec.md`
 - `plan.md`
 - `tasks.md`
 - `checklists/requirements.md` or other generated Spec Kit metadata files, if the repository uses them
 Allowed fixes include:
 - clarify requirements
 - tighten scope
 - move out-of-scope work into follow-up candidates
 - correct terminology
 - add missing tasks
 - remove tasks not backed by the spec
 - align plan language with repository architecture
 - add missing acceptance criteria or validation tasks
 - add missing checklist artifacts required by the constitution
 Forbidden fixes include:
 - modifying application code
 - creating migrations
 - editing models, services, jobs, policies, Filament resources, Livewire components, tests, commands, routes, or views
 - running implementation or test-fix loops
 - changing runtime behavior
 ### Step 7: Evaluate the Spec Readiness Gate
 After preparation analyze has passed or preparation-artifact issues have been fixed, evaluate the Spec Readiness Gate.
 Stop after this gate and do not implement.
 ## Spec Directory Rules
 When creating a new spec directory, use the repository's Spec Kit-generated directory or path.
 If the repository does not provide a command for spec setup, use the next valid spec number and a kebab-case slug:
 ```text
 specs/<number>-<slug>/
 ```
 The exact number must be derived from the current repository state and existing numbering conventions.
 Create or update preparation artifacts inside the selected spec directory:
 ```text
 specs/<number>-<slug>/spec.md
 specs/<number>-<slug>/plan.md
 specs/<number>-<slug>/tasks.md
 ```
 If the repository templates require additional preparation files, create them only when this is consistent with existing Spec Kit conventions.
 ## `spec.md` Requirements
 The spec must be product- and behavior-oriented. It should avoid premature implementation detail unless needed for correctness.
 Include:
 - Feature title
 - Problem statement
 - Business/product value
 - Primary users/operators
 - User stories
 - Functional requirements
 - Non-functional requirements
 - UX requirements
 - RBAC/security requirements
 - Auditability/observability requirements
 - Data/truth-source requirements where relevant
 - Out of scope
 - Acceptance criteria
 - Success criteria
 - Risks
 - Assumptions
 - Open questions
 TenantPilot/TenantAtlas specs should preserve enterprise SaaS principles:
 - workspace/tenant isolation
 - capability-first RBAC
 - auditability
 - operation/result truth separation
 - source-of-truth clarity
 - calm enterprise operator UX
 - progressive disclosure where useful
 - no false positive calmness
 ## `plan.md` Requirements
 The plan must be repo-aware and implementation-oriented, but it must not make code changes by itself.
 Include:
 - Technical approach
 - Existing repository surfaces likely affected
 - Domain/model implications
 - UI/Filament implications
 - Livewire implications where relevant
 - OperationRun/monitoring implications where relevant
 - RBAC/policy implications
 - Audit/logging/evidence implications where relevant
 - Data/migration implications where relevant
 - Test strategy
 - Rollout considerations
 - Risk controls
 - Implementation phases
 The plan should clearly distinguish where relevant:
 - execution truth
 - artifact truth
 - backup/snapshot truth
 - recovery/evidence truth
 - operator next action
 ## `tasks.md` Requirements
 Tasks must be ordered, small, and verifiable.
 Include:
 - checkbox tasks
 - phase grouping
 - tests before or alongside implementation tasks where practical
 - final validation tasks
 - documentation/update tasks if needed
 - explicit non-goals where useful
 Avoid vague tasks such as:
 ```text
 Clean up code
 Refactor UI
 Improve performance
 Make it enterprise-ready
 ```
 Prefer concrete tasks such as:
 ```text
 - [ ] Add a feature test covering workspace isolation for <specific behavior>.
 - [ ] Update <specific Filament page/resource> to display <specific state>.
 - [ ] Add policy coverage for <specific capability>.
 ```
 If exact file names are not known yet, phrase tasks as repo-verification tasks first rather than inventing file paths.
 ## Preparation Scope Control
 If the requested feature implies multiple independent concerns, create one primary spec for the smallest valuable slice and add a `Follow-up spec candidates` section.
 Examples of follow-up candidates:
 - assigned findings
 - pending approvals
 - personal work queue
 - notification delivery settings
 - evidence pack export hardening
 - operation monitoring refinements
 - autonomous governance decision surfaces
 Do not force all follow-up candidates into the primary spec.
 ## Failure Handling
 If a Spec Kit command or preparation analyze phase fails:
 1. Stop at the relevant gate.
 2. Report the failing command or phase.
 3. Summarize the error.
 4. Do not attempt implementation as a workaround.
 5. Suggest the smallest safe next action.
 If the branch or working tree state is unsafe:
 1. Stop before running Spec Kit commands.
 2. Report the current branch and relevant uncommitted files.
 3. Ask the user to commit, stash, or move to a clean worktree.
 ## Final Response Requirements
 Respond with:
 1. Selected candidate and why it was chosen
 2. Why close alternatives were deferred
 3. Current branch after Spec Kit execution, if changed
 4. Generated spec path
 5. Files created or updated by Spec Kit
 6. Preparation analyze result summary
 7. Preparation-artifact fixes applied after analyze
 8. Assumptions made
 9. Open questions, if any
 10. Candidate Selection Gate result
 11. Spec Readiness Gate result
 12. Recommended next implementation prompt
 13. Explicit statement that no application implementation was performed
 Keep the final response concise, but include enough detail for the user to continue immediately.
 ## Manual Review and Next-Step Prompts
 Provide a ready-to-copy manual artifact review prompt like this, adapted to the generated spec branch/path:
 ```markdown
 Du bist ein Senior Staff Software Architect und Enterprise SaaS Reviewer.
 Analysiere die neu erstellte Spec `<spec-branch-or-spec-path>` streng repo-basiert.
 Ziel:
 Prüfe, ob `spec.md`, `plan.md` und `tasks.md` vollständig, konsistent, implementierbar und constitution-konform sind.
 Wichtig:
 - Keine Implementierung.
 - Keine Codeänderungen.
 - Keine Scope-Erweiterung.
 - Prüfe nur gegen Repo-Wahrheit.
 - Benenne konkrete Konflikte mit Dateien, Patterns, Datenflüssen oder bestehenden Specs.
 - Schlage nur minimale Korrekturen an `spec.md`, `plan.md` und `tasks.md` vor.
 - Wenn alles passt, gib eine klare Implementierungsfreigabe.
 ```
 Also provide a ready-to-copy implementation prompt for the separate implementation skill after analyze has passed or preparation-artifact issues have been fixed:
 ```markdown
 /spec-kit-implementation-loop
 Implementiere die vorbereitete Spec `<spec-branch-or-spec-path>` streng anhand von `tasks.md`.
 Danach Tests ausführen, Browser Smoke Test falls UI/user-facing betroffen ist, Post-Implementation Analyse durchführen und alle bestätigten In-Scope Findings unabhängig von Severity beheben, wenn safe und bounded.
 Wiederhole test + browser smoke + analysis + fix bis keine In-Scope Findings mehr offen sind oder eine Stop Condition greift.
 ```
 ## Example Invocation
 User:
 ```text
 Nutze den Skill spec-kit-next-best-prep.
 Wähle aus roadmap.md und spec-candidates.md die nächste sinnvollste Spec.
 Führe danach GitHub Spec Kit specify, plan, tasks und analyze in einem Rutsch aus.
 Behebe alle analyze-Issues in den Spec-Kit-Artefakten.
 Keine Application-Implementierung.
 ```
 Expected behavior:
 1. Inspect constitution, Spec Kit scripts/templates, specs, roadmap, and spec candidates.
 2. Check branch and working tree safety.
 3. Compare candidate suitability.
 4. Select the next best candidate.
 5. Evaluate the Candidate Selection Gate.
 6. Run the repository's real Spec Kit `specify` flow, letting it handle branch/spec setup.
 7. Run the repository's real Spec Kit `plan` flow.
 8. Run the repository's real Spec Kit `tasks` flow.
 9. Run the repository's real Spec Kit preparation `analyze` flow.
 10. Fix analyze issues only in Spec Kit preparation artifacts.
 11. Evaluate the Spec Readiness Gate.
 12. Stop before application implementation.
 13. Return selection rationale, branch/path summary, artifact summary, analyze summary, fixes applied, gates, and next implementation prompt.
 ```
--- a/.specify/memory/constitution.md
+++ b/.specify/memory/constitution.md
@ -1,30 +1,34 @@
 <!--
 Sync Impact Report
- Version change: 2.9.0 -> 2.10.0
+- Version change: 2.10.0 -> 2.11.0
 - Modified principles:
-  - Expanded Operations / Run Observability Standard so OperationRun
+  - Expanded decision-first and operator-surface rules so operational,
-    start UX is shared-contract-owned instead of surface-owned
+    governance, evidence, onboarding, review, and support-facing
-  - Expanded Governance review expectations for OperationRun-starting
+    detail/status surfaces separate decision content, operator
-    features, explicit queued-notification policy, and bounded
+    diagnostics, and support/raw evidence
-    exceptions
+  - Expanded review and enforcement expectations so specs, plans,
    tasks, and checklists must make audience modes, raw/support
    gating, one dominant next action, and duplicate-truth prevention
    explicit
 - Added sections:
-  - OperationRun Start UX Contract (OPS-UX-START-001): centralizes
+  - Audience-Aware Decision Surfaces & Disclosure Ladder
-    queued toast/link/event/message semantics, run/artifact deep links,
+    (DECIDE-AUD-001): requires customer-readable default paths,
-    queued DB-notification policy, and tenant/workspace-safe operation
+    operator diagnostics as progressive disclosure, support/raw
-    URL resolution behind one shared OperationRun UX layer
+    evidence gating, one dominant next action, and no duplicate truth
    across equal-priority cards
 - Removed sections: None
 - Templates requiring updates:
- .specify/templates/spec-template.md: add OperationRun UX Impact
+- .specify/templates/spec-template.md: add audience-aware disclosure
-    section + start-contract prompts ✅
+    section + constitution prompts ✅
- .specify/templates/plan-template.md: add OperationRun UX Impact
+- .specify/templates/plan-template.md: add audience/disclosure
-    planning section + constitution checks ✅
+    planning prompts + constitution checks ✅
- .specify/templates/tasks-template.md: add central start-UX reuse,
+- .specify/templates/tasks-template.md: add decision/disclosure
-    queued-notification policy, and exception tasks ✅
+    implementation + test tasks ✅
- .specify/templates/checklist-template.md: add OperationRun start
+- .specify/templates/checklist-template.md: add disclosure, raw-gating,
-    UX review checks ✅
+    one-primary-action, and duplicate-truth review checks ✅
 - docs/product/standards/README.md: refresh constitution index for
-    the new ops-UX contract ✅
+    the new audience-aware disclosure contract ✅
 - Commands checked:
  - N/A `.specify/templates/commands/*.md` directory is not present
 - Follow-up TODOs: None
@ -589,11 +593,114 @@ ##### Review gate
 5. Is this a Primary Decision Surface, Secondary Context Surface, or
   Tertiary Evidence / Diagnostics Surface?
 6. If it is primary, why can it not live inside an existing decision
-   context?
+  context?
 7. Does the navigation reflect a workflow or only storage structure?
 8. Does this reduce search, review, or click work?
 9. Does this make the product calmer and clearer instead of louder?
 #### Audience-Aware Decision Surfaces & Disclosure Ladder (DECIDE-AUD-001)
 Goal: every operational, governance, evidence, onboarding, review, and
 support-facing detail or status surface MUST keep customer-readable
 decision content, operator diagnostics, and support/raw evidence
 intentionally separated while preserving full depth through progressive
 disclosure.
 ##### Audience ladder is explicit
 - In-scope detail and status surfaces MUST define their content using
  this three-tier hierarchy when applicable:
  - decision content
  - operator diagnostics
  - support / raw evidence
 - Surfaces that are reachable by more than one audience class MUST
  define their default-visible content for at least these layers when
  applicable:
  - customer / read-only default
  - operator / MSP diagnostics
  - platform / support raw evidence
 - The surface contract MUST state which capabilities unlock each deeper
  layer.
 - Support/raw evidence MUST NOT become the default first-read
  experience on customer-readable or ordinary operator-facing
  surfaces.
 ##### Customer-readable default path
 - The default reading path for customer/read-only users MUST optimize
  for status, reason, impact, one dominant next action, and a short
  result or artifact summary.
 - Internal lifecycle wording, debug semantics, implementation field
  names, raw payload fragments, and support-oriented context MUST NOT
  appear in the default customer-readable path unless they are the only
  way to understand the first decision.
 - Default-visible customer/read-only content is responsible for status,
  reason, impact, the dominant next action, and a concise supporting
  summary only.
 ##### Diagnostics are secondary by default
 - Diagnostics such as lifecycle, timings, verification detail, drift
  detail, permission detail, provider summaries, or related-operation
  context MUST be lower-priority than the decision surface and MUST be
  collapsed, tabbed, grouped, or otherwise progressively disclosed when
  the first decision does not require them.
 - Authorized operators MAY expand diagnostics, but diagnostics MUST NOT
  visually compete with the primary decision block.
 - Where no support/raw tier is exposed, diagnostics still remain below
  the decision tier and MUST NOT restate the same decision summary at
  equal weight.
 ##### Raw/support evidence is gated
 - Raw/support evidence such as JSON, raw context payloads,
  fingerprints, internal reason ownership, platform reason families,
  monitoring detail, viewer context, or copy/show-raw actions MUST NOT
  appear in the default decision path.
 - These details MUST live behind explicit reveal affordances and MUST
  be capability-gated wherever the audience model distinguishes support
  or platform users from ordinary operators.
 - Capability-gated support/raw disclosure MUST fail closed when the
  actor lacks the required scope or capability.
 ##### One dominant next action
 - A decision surface MUST expose exactly one dominant next action in
  the default-visible region.
 - Optional secondary actions MAY exist, but they MUST NOT compete with
  the primary remediation or decision action in prominence.
 - Contextual navigation such as opening a related run, tenant, report,
  or technical detail remains secondary.
 ##### No duplicate truth across equal-priority cards
 - The same blocker, reason, or next action MUST NOT be repeated across
  multiple equal-priority cards, sections, or summary blocks on the
  same default-visible surface.
 - Supporting evidence MAY restate the underlying proof, but the
  dominant decision message appears once and diagnostics elaborate
  beneath it.
 ##### Required tests
 - New or materially changed customer/operator-facing detail surfaces
  MUST include focused tests proving:
  - default-visible content shows status, reason, impact, and next
    action,
  - exactly one dominant next action is primary,
  - diagnostics are secondary or collapsed,
  - raw/support evidence is not default-visible,
  - support/raw sections are capability-gated where applicable,
  - and duplicate visible decision summaries are absent.
 ##### Stored evidence wins over fallback diagnostics
 - When a stored verification or report artifact exists, fallback
  technical diagnostics SHOULD demote behind supporting evidence or
  technical details instead of remaining peer-level default content.
 - Fallback diagnostics MAY become temporarily prominent only when the
  higher-level artifact does not yet exist or is unavailable.
 #### Surface Taxonomy (UI-SURF-001)
 Every new admin surface MUST be assigned exactly one broad action-surface
@ -1317,11 +1424,22 @@ #### Operator Surface Principles (OPSURF-001)
 - Diagnostic detail MAY exist, but it MUST be secondary and explicitly revealed.
 - JSON payloads, raw IDs, internal field names, provider error details, and low-level technical metadata belong in diagnostics surfaces rather than the primary content region.
 - Operators MUST NOT need to parse raw payloads to understand current state or next action.
 - Detail/status surfaces MUST satisfy DECIDE-AUD-001: decision content
  first, operator diagnostics second, support/raw evidence third.
 Distinct truth dimensions
 - When the domain has execution outcome, data completeness, governance result, lifecycle or readiness state, operability truth, health truth, trust/confidence, or next action semantics, the surface MUST keep them explicit instead of collapsing them into one ambiguous status.
 - If multiple truth dimensions are summarized, the default-visible UI MUST label each dimension clearly.
 Dominant next action and duplicate-truth control
 - Default-visible decision content MUST include status, reason,
  impact, and one dominant next action where those concepts exist.
 - Secondary navigation or debug helpers MUST remain lower-priority
  than the dominant decision action.
 - The same blocker, reason, impact, or next action MUST NOT be
  repeated across multiple default-visible cards, sections, tabs, or
  summaries.
 Explicit mutation scope
 - Every state-changing action MUST communicate before execution whether it affects TenantPilot only, the Microsoft tenant, or simulation only.
 - Mutation scope MUST be understandable from nearby action copy, helper text, preview, or confirmation.
@ -1342,6 +1460,13 @@ #### Operator Surface Principles (OPSURF-001)
 Page contract requirement
 - Every new or materially refactored operator-facing page MUST define the primary persona, surface type, primary operator question, default-visible information, diagnostics-only information, status dimensions used, mutation scope, primary actions, and dangerous actions.
 - The page contract MUST live in the governing spec and stay in sync with implementation.
 - Where multiple audience classes share the page, the contract MUST
  explicitly define the customer/read-only default path, operator
  diagnostics path, support/raw-evidence path, and the capabilities
  that unlock each layer.
 - The page contract MUST also make the dominant next action,
  duplicate-truth prevention, and raw/support gating explicit for
  changed detail/status surfaces.
 #### Spec Scope Fields (SCOPE-002)
@ -1366,8 +1491,11 @@ #### Enforcement Model (UI-REVIEW-001)
  native, custom, or a shared detail family, what shared core vs host
  variation exists if relevant, which layer owns the relevant shell,
  page, and detail truth, which requested/active/draft/inspect/
-  restorable roles exist, whether any fake-native or host-drift risk is
+  restorable roles exist, which audience ladder and disclosure
-  present, and whether an exception type is used.
+  boundaries exist, what the dominant next action is, how raw/support
  evidence is gated, how duplicate truth is prevented, whether any
  fake-native or host-drift risk is present, and whether an exception
  type is used.
 - Missing any of those answers makes the spec incomplete.
 PR review requirements
@ -1382,7 +1510,12 @@ #### Enforcement Model (UI-REVIEW-001)
  promoted into primary navigation without justification, one case
  fragmented across multiple equal-rank pages, new automation that adds
  attention surfaces without reducing operator work, noisy default
-  surfaces with no action/watch/reference hierarchy, `Filament Costume`,
+  surfaces with no action/watch/reference hierarchy, duplicate visible
  blocker/reason/next-action summaries, customer/operator default paths
  that expose raw JSON, fingerprints, reason ownership, platform reason
  families, or monitoring detail, helper actions such as `Open
  operation`, `Technical details`, or `Show JSON` competing with the
  dominant decision action, `Filament Costume`,
  `Blade Request UI`, `Hand-Rolled Simple Overview`, `Hidden Exception`,
  `Host Drift`, `State Layer Collapse`, `Parallel Inspect Worlds`, or
  undocumented exceptions without dedicated tests.
@ -1394,11 +1527,15 @@ #### Enforcement Model (UI-REVIEW-001)
  presence of explicit Inspect on Queue / Review and History / Audit
  surfaces, absence of empty `ActionGroup` or `BulkActionGroup`,
  correct placement of destructive actions, truthful scope signals,
-  stable canonical nouns across shells, absence of fake-native primary
+  stable canonical nouns across shells, presence of a single dominant
-  controls where metadata says the surface is native, bounded shared
+  next action where surface metadata exposes one, absence of duplicate
-  family contracts where metadata says a family is reused, explicit
+  visible decision summaries, explicit raw/support gating or secondary
-  state ownership where specs or metadata expose it, and dedicated
+  placement where the surface serves multiple audience classes,
-  tests for every approved exception.
+  absence of fake-native primary controls where metadata says the
  surface is native, bounded shared family contracts where metadata
  says a family is reused, explicit state ownership where specs or
  metadata expose it, and dedicated tests for every approved
  exception.
 #### Immediate Retrofit Priorities
@ -1465,6 +1602,10 @@ #### Appendix A - One-page Condensed Constitution
 - Scope chips must be truthful.
 - Domain nouns are canonical and stable.
 - Critical operational truth is default-visible.
 - Multi-audience detail/status surfaces keep customer-readable decision
  content above operator diagnostics and support/raw evidence.
 - One dominant next action stays visually primary.
 - Duplicate visible decision truth is forbidden.
 - Semantic truth dimensions are not collapsed into a generic status.
 - Standard lists stay scanable.
 - Exceptions are catalogued, justified, and tested.
@ -1477,6 +1618,8 @@ #### Appendix B - Feature Review Checklist
 - The human-in-the-loop moment is explicit.
 - Immediate-visible decision information is explicit.
 - On-demand evidence / diagnostics boundaries are explicit.
 - Audience-aware default visibility and raw-evidence boundaries are
  explicit where the page serves more than one audience class.
 - Any new primary surface is justified against an existing decision
  context.
 - Navigation reflects a workflow rather than storage structure.
@ -1486,6 +1629,8 @@ #### Appendix B - Feature Review Checklist
 - Broad action-surface class is declared.
 - Detailed surface type is declared.
 - The one most likely next operator action is explicit.
 - One dominant next action stays primary.
 - Duplicate visible decision truth is absent.
 - The surface is classified correctly as native, custom, or shared
  family.
 - Primary inspect/open model is defined.
@ -1567,6 +1712,10 @@ ### Filament Native First / No Ad-hoc Styling (UI-FIL-001)
 - Admin and operator-facing surfaces MUST use native Filament components, existing shared UI primitives, and centralized design patterns first.
 - If Filament already provides the required semantic element, feature code MUST use the Filament-native component instead of a locally assembled replacement.
 - Preferred native elements include `x-filament::badge`, `x-filament::button`, `x-filament::icon`, and Filament Forms, Infolists, Tables, Sections, Tabs, Grids, and Actions.
 - Local Blade/Tailwind cards are allowed only when they preserve dark
  mode correctness, spacing consistency, badge semantics, action
  hierarchy, progressive disclosure, accessibility, and overall
  Filament visual language.
 Native-by-default classification
 - `Native Surface` means the primary interaction contract is built from
@ -1598,6 +1747,8 @@ ### Filament Native First / No Ad-hoc Styling (UI-FIL-001)
  more than one host, it becomes a `Shared Detail Micro-UI` and MUST
  define shared core vs host variation before another host reassembles
  it locally.
 - Local one-off markup MUST NOT recreate decision/diagnostics/raw
  layering when an existing shared detail family is sufficient.
 Upgrade-safe preference
 - Update-safe, framework-native implementations take priority over page-local styling shortcuts.
@ -1611,7 +1762,9 @@ ### Filament Native First / No Ad-hoc Styling (UI-FIL-001)
  - and the deviation is justified briefly in code and in the governing spec or PR.
 - Approved exceptions MUST stay layout-neutral, use the minimum local
  classes necessary, MUST NOT invent a new page-local status language,
-  and MUST say what remains standardized.
+  MUST preserve dark mode correctness, spacing consistency,
  badge semantics, action hierarchy, progressive disclosure,
  accessibility, and MUST say what remains standardized.
 - `Hidden Exception` is forbidden. Historical accident or local
  implementation convenience is not a valid substitute for UI-EX-001.
@ -1620,6 +1773,8 @@ ### Filament Native First / No Ad-hoc Styling (UI-FIL-001)
  - which native Filament element or shared primitive was used,
  - why an existing component was insufficient if an exception was taken,
  - whether the surface is native, custom, or a shared detail family,
  - whether any local Blade/Tailwind card still preserves Filament
    visual language and disclosure semantics,
  - and whether any ad-hoc status, emphasis styling, or fake-native
    contract was introduced.
 - UI work is not Done if it introduces ad-hoc status styling or framework-foreign replacement components where a native Filament or shared UI solution was viable.
@ -1658,6 +1813,11 @@ ### Scope, Compliance, and Review Expectations
  different policy, route terminal notifications through the lifecycle mechanism, include an `OperationRun UX Impact`
  section in the active spec or plan, and document any temporary exception with an architecture note, test rationale,
  and migration decision.
 - Specs and PRs that change detail or status surfaces MUST explicitly
  document how they satisfy customer-readable decision-first content,
  diagnostics-secondary disclosure, support/raw-evidence gating, one
  dominant next action, duplicate-truth prevention, and shared-pattern
  reuse.
 - Specs and PRs that change operator-facing surfaces MUST classify each
  affected surface under DECIDE-001 and justify any new Primary
  Decision Surface or workflow-first navigation change.
@ -1675,4 +1835,4 @@ ### Versioning Policy (SemVer)
 - **MINOR**: new principle/section or materially expanded guidance.
 - **MAJOR**: removing/redefining principles in a backward-incompatible way.
-**Version**: 2.10.0 | **Ratified**: 2026-01-03 | **Last Amended**: 2026-04-24
+**Version**: 2.11.0 | **Ratified**: 2026-01-03 | **Last Amended**: 2026-04-27
--- a/.specify/templates/checklist-template.md
+++ b/.specify/templates/checklist-template.md
@ -51,6 +51,14 @@ ## Signals, Exceptions, And Test Depth
 - [ ] CHK014 The required surface test profile is explicit: `shared-detail-family`, `monitoring-state-page`, `global-context-shell`, `exception-coded-surface`, or `standard-native-filament`.
 - [ ] CHK015 The chosen test family/lane and any manual smoke are the narrowest honest proof for the declared surface class, and `standard-native-filament` relief is used when no special contract exists.
 ## Audience-Aware Disclosure And Decision Hierarchy
 - [ ] CHK023 Default-visible content is decision-first and clearly separated from operator diagnostics and support/raw evidence.
 - [ ] CHK024 Customer/read-only default paths do not expose raw JSON, copied context payloads, fingerprints, internal reason ownership, platform reason families, monitoring detail, or other debug semantics by default.
 - [ ] CHK025 Exactly one dominant next action is primary; navigation or debug helpers such as `Open operation`, `Technical details`, or `Show JSON` do not compete at equal weight.
 - [ ] CHK026 Duplicate visible status, blocker, reason, impact, or next-action summaries are removed or explicitly justified as non-duplicative evidence.
 - [ ] CHK027 Support/raw sections are collapsed, lower-priority, or capability-gated where applicable, and any local Blade/Tailwind surface still preserves Filament visual language, dark mode correctness, progressive disclosure, and accessibility.
 ## Review Outcome
 - [ ] CHK016 One review outcome class is chosen: `blocker`, `strong-warning`, `documentation-required-exception`, or `acceptable-special-case`.
--- a/.specify/templates/plan-template.md
+++ b/.specify/templates/plan-template.md
@ -36,6 +36,10 @@ ## UI / Surface Guardrail Plan
 - **Native vs custom classification summary**: [native / custom / mixed / N/A]
 - **Shared-family relevance**: [none / list affected shared families]
 - **State layers in scope**: [shell / page / detail / URL-query / none]
 - **Audience modes in scope**: [customer/read-only / operator-MSP / support-platform / N/A]
 - **Decision/diagnostic/raw hierarchy plan**: [decision-first / diagnostics-second / support-raw-third / N/A]
 - **Raw/support gating plan**: [collapsed / capability-gated / role-gated / N/A]
 - **One-primary-action / duplicate-truth control**: [how one dominant next action is preserved and repeated blockers are removed]
 - **Handling modes by drift class or surface**: [hard-stop-candidate / review-mandatory / exception-required / report-only / N/A]
 - **Repository-signal treatment**: [report-only / review-mandatory / exception-required / future hard-stop candidate / N/A]
 - **Special surface test profiles**: [standard-native-filament / shared-detail-family / monitoring-state-page / global-context-shell / exception-coded-surface / N/A]
@ -111,6 +115,10 @@ ## Constitution Check
 - Spec discipline / bloat check (SPEC-DISC-001, BLOAT-001): related semantic changes are grouped coherently, and any new enum, DTO/presenter, persisted entity, interface/registry/resolver, or taxonomy includes a proportionality review covering operator problem, insufficiency, narrowness, ownership cost, rejected alternative, and whether it is current-release truth
 - Badge semantics (BADGE-001): status-like badges use `BadgeCatalog` / `BadgeRenderer`; no ad-hoc mappings; new values include tests
 - Filament-native UI (UI-FIL-001): admin/operator surfaces use native Filament components or shared primitives first; no ad-hoc status UI, local semantic color/border decisions, or hand-built replacements when native/shared semantics exist; any exception is explicitly justified
 - Filament-native UI (UI-FIL-001): if local Blade/Tailwind cards are
  still necessary, they preserve dark mode correctness, spacing
  consistency, badge semantics, action hierarchy, progressive
  disclosure, accessibility, and Filament visual language
 - UI/UX surface taxonomy (UI-CONST-001 / UI-SURF-001): every changed operator-facing surface is classified as exactly one allowed surface type; ad-hoc interaction models are forbidden
 - Decision-first operating model (DECIDE-001): each changed
  operator-facing surface is classified as Primary Decision,
@ -120,6 +128,13 @@ ## Constitution Check
  disclosed, one governance case stays decidable in one context where
  practical, navigation follows workflows not storage structures, and
  automation / alerts reduce attention load instead of adding noise
 - Audience-aware disclosure (DECIDE-AUD-001 / OPSURF-001): detail or
  status surfaces separate customer-readable decision content,
  operator diagnostics, and support/raw evidence; customer-readable
  default paths hide raw JSON, copied context, fingerprints, internal
  reason ownership, platform reason families, and debug semantics;
  one dominant next action is explicit; duplicate visible truth is
  removed
 - UI/UX inspect model (UI-HARD-001): each list surface has exactly one primary inspect/open model; redundant View beside row click or identifier click is forbidden; edit-as-inspect is limited to Config-lite resources
 - UI/UX action hierarchy (UI-HARD-001 / UI-EX-001): standard CRUD and Registry rows expose at most one inline safe shortcut; destructive actions are grouped or in the detail header; queue exceptions are catalogued, justified, and tested
 - UI/UX scope, truth, and naming (UI-HARD-001 / UI-NAMING-001 / OPSURF-001): scope signals are truthful, canonical nouns stay stable across shells, critical operational truth is default-visible, and standard lists remain scanable
--- a/.specify/templates/spec-template.md
+++ b/.specify/templates/spec-template.md
@ -89,6 +89,17 @@ ## Decision-First Surface Role *(mandatory when operator-facing surfaces are cha
 |---|---|---|---|---|---|---|---|
 | e.g. Review inbox | Primary Decision Surface | Review and release queued governance work | Case summary, severity, recommendation, required action | Full evidence, raw payloads, audit trail, provider diagnostics | Primary because it is the queue where operators decide and clear work | Follows pending-decisions workflow, not storage objects | Removes search across runs, findings, and audit pages |
 ## Audience-Aware Disclosure *(mandatory when operator-facing surfaces are changed)*
 If this feature adds or materially changes a detail or status surface,
 fill out one row per affected surface. Reuse the same surface names
 used above and make the disclosure hierarchy explicit instead of
 assuming it.
 | Surface | Audience Modes In Scope | Decision-First Default-Visible Content | Operator Diagnostics | Support / Raw Evidence | One Dominant Next Action | Hidden / Gated By Default | Duplicate-Truth Prevention |
 |---|---|---|---|---|---|---|---|
 | e.g. Review inbox | customer-read-only, operator-MSP, support-platform | Current status, why it matters, impact, recommendation, next action | Review history, lifecycle, related evidence, related runs | Raw payloads, fingerprints, reason ownership, platform reason family | `Review evidence` | Raw/support detail hidden or capability-gated outside support mode | The top summary states the blocker once; later sections add evidence rather than restating it |
 ## UI/UX Surface Classification *(mandatory when operator-facing surfaces are changed)*
 If this feature adds or materially changes an operator-facing list, detail, queue, audit, config, or report surface,
@ -254,6 +265,13 @@ ## Requirements *(mandatory)*
 - record any allowed deviation, the consistency it must preserve, and its ownership/spread-control cost,
 - and make the reviewer focus explicit so parallel local UX paths do not appear silently.
 **Constitution alignment (DECIDE-AUD-001 / OPSURF-001):** If this feature changes a detail or status surface, the spec MUST describe:
 - how the surface separates customer-readable decision content, operator diagnostics, and support/raw evidence,
 - which audience modes are in scope (`customer/read-only`, `operator/MSP`, `support/platform`),
 - which content is hidden, collapsed, or capability-gated by default,
 - how one dominant next action is preserved,
 - and how duplicate visible truth is prevented.
 **Constitution alignment (PROV-001):** If this feature touches a shared provider/platform seam, the spec MUST:
 - classify each touched seam as provider-owned or platform-core,
 - keep provider-specific semantics out of platform-core contracts, taxonomies, identifiers, compare semantics, and operator vocabulary unless explicitly justified,
@ -310,6 +328,7 @@ ## Requirements *(mandatory)*
 - which native Filament components or shared UI primitives are used,
 - whether any local replacement markup was avoided for badges, alerts, buttons, or status surfaces,
 - how semantic emphasis is expressed through Filament props or central primitives rather than page-local color/border classes,
 - how any required local Blade/Tailwind cards still preserve dark mode correctness, spacing consistency, badge semantics, action hierarchy, progressive disclosure, accessibility, and Filament visual language,
 - and any exception where Filament or a shared primitive was insufficient, including why the exception is necessary and how it avoids introducing a new local status language.
 **Constitution alignment (UI-NAMING-001):** If this feature adds or changes operator-facing buttons, header actions, run titles,
@ -367,6 +386,7 @@ ## Requirements *(mandatory)*
 **Constitution alignment (OPSURF-001):** If this feature adds or materially refactors an operator-facing surface, the spec MUST describe:
 - how the default-visible content stays operator-first on `/admin` and avoids raw implementation detail,
 - which diagnostics are secondary and how they are explicitly revealed,
 - how the dominant next action stays primary and how duplicate visible truth is avoided,
 - which status dimensions are shown separately (execution outcome, data completeness, governance result, lifecycle/readiness) and why,
 - how each mutating action communicates its mutation scope before execution (`TenantPilot only`, `Microsoft tenant`, or `simulation only`),
 - how dangerous actions follow the safe-execution pattern (configuration, safety checks/simulation, preview, hard confirmation where required, execute),
--- a/.specify/templates/tasks-template.md
+++ b/.specify/templates/tasks-template.md
@ -78,9 +78,21 @@ # Tasks: [FEATURE NAME]
 - filling the spec’s Operator Surface Contract for every affected page,
 - keeping default-visible content limited to first-decision needs and
  moving proof, payloads, and diagnostics into progressive disclosure,
 - implementing the three-tier disclosure hierarchy where applicable:
  customer-readable decision content first, operator diagnostics
  second, support/raw evidence third,
 - making default-visible content operator-first and moving JSON payloads, raw IDs, internal field names, provider error details, and low-level metadata into explicitly revealed diagnostics surfaces,
 - ensuring customer/read-only default paths do not expose raw JSON,
  copied context payloads, fingerprints, internal reason ownership,
  platform reason families, or debug semantics,
 - keeping each governance case decidable in one focused context where
  practical instead of forcing cross-page reconstruction,
 - keeping exactly one dominant next action primary and demoting
  navigation/debug helpers such as `Open operation`, `Technical
  details`, or `Show JSON`,
 - removing duplicate visible status, blocker, reason, impact, or
  next-action summaries so later sections add evidence instead of
  restating the same decision truth,
 - modeling execution outcome, data completeness, governance result, and lifecycle/readiness as distinct status dimensions when applicable,
 - making mutation scope legible before execution for every state-changing action (`TenantPilot only`, `Microsoft tenant`, or `simulation only`),
 - implementing the safe-execution flow for dangerous actions (configuration, safety checks/simulation, preview, hard confirmation where required, execute) or documenting an approved exemption,
@ -128,6 +140,12 @@ # Tasks: [FEATURE NAME]
 - documenting any catalogued UI exception in the spec/PR and adding dedicated test coverage,
 - documenting any UI-FIL-001 exception with rationale in the spec/PR,
 - adding/updated tests that enforce the contract and block merge on violations, OR documenting an explicit exemption with rationale.
 - For any new or modified customer/operator-facing detail surface,
  tests MUST prove default-visible status/reason/impact/next-action
  content, exactly one dominant next action, diagnostics-secondary
  ordering, hidden raw/support detail by default, capability-gated
  support/raw sections where applicable, and the absence of duplicate
  visible decision summaries.
 **Filament UI UX-001 (Layout & IA)**: If this feature adds/modifies any Filament screen, tasks MUST include:
 - ensuring Create/Edit pages use Main/Aside layout (3-col grid, Main=columnSpan(2), Aside=columnSpan(1)),
 - ensuring all form fields are inside Sections/Cards (no naked inputs at root schema level),
--- a/apps/platform/app/Console/Commands/PruneProductUsageEventsCommand.php
+++ b/apps/platform/app/Console/Commands/PruneProductUsageEventsCommand.php
@ -0,0 +1,42 @@
 <?php
 declare(strict_types=1);
 namespace App\Console\Commands;
 use App\Models\ProductUsageEvent;
 use Illuminate\Console\Command;
 class PruneProductUsageEventsCommand extends Command
 {
    /**
     * @var string
     */
    protected $signature = 'tenantpilot:product-usage:prune {--days= : Number of days to retain product usage events}';
    /**
     * @var string
     */
    protected $description = 'Delete product usage events older than the retention period';
    public function handle(): int
    {
        $days = (int) ($this->option('days') ?: config('tenantpilot.product_usage_event_retention_days', 90));
        if ($days < 1) {
            $this->error('Retention days must be at least 1.');
            return self::FAILURE;
        }
        $cutoff = now()->subDays($days);
        $deleted = ProductUsageEvent::query()
            ->where('occurred_at', '<', $cutoff)
            ->delete();
        $this->info("Deleted {$deleted} product usage event(s) older than {$days} days.");
        return self::SUCCESS;
    }
 }
--- a/apps/platform/app/Console/Commands/PurgeLegacyBaselineGapRuns.php
+++ b/apps/platform/app/Console/Commands/PurgeLegacyBaselineGapRuns.php
@ -6,12 +6,14 @@
 use App\Models\OperationRun;
 use App\Models\Tenant;
 use App\Support\OperationCatalog;
 use App\Support\OperationRunType;
 use Illuminate\Console\Command;
 class PurgeLegacyBaselineGapRuns extends Command
 {
    protected $signature = 'tenantpilot:baselines:purge-legacy-gap-runs
-        {--type=* : Limit cleanup to baseline_compare and/or baseline_capture runs}
+        {--type=* : Limit cleanup to baseline.compare and/or baseline.capture runs (legacy aliases also accepted)}
        {--tenant=* : Limit cleanup to tenant ids or tenant external ids}
        {--workspace=* : Limit cleanup to workspace ids}
        {--limit=500 : Maximum candidate runs to inspect}
@ -99,21 +101,35 @@ public function handle(): int
     */
    private function normalizedTypes(): array
    {
-        $types = array_values(array_unique(array_filter(
+        $requestedTypes = array_values(array_unique(array_filter(
            array_map(
                static fn (mixed $type): ?string => is_string($type) && trim($type) !== '' ? trim($type) : null,
                (array) $this->option('type'),
            ),
        )));
-        if ($types === []) {
+        $canonicalTypes = array_values(array_unique(array_filter(array_map(
-            return ['baseline_compare', 'baseline_capture'];
+            static fn (string $type): ?string => match ($type) {
                OperationRunType::BaselineCompare->value, 'baseline_compare' => OperationRunType::BaselineCompare->value,
                OperationRunType::BaselineCapture->value, 'baseline_capture' => OperationRunType::BaselineCapture->value,
                default => null,
            },
            $requestedTypes,
        ))));
        if ($canonicalTypes === []) {
            $canonicalTypes = [
                OperationRunType::BaselineCompare->value,
                OperationRunType::BaselineCapture->value,
            ];
        }
-        return array_values(array_filter(
+        return array_values(array_unique(array_merge(
-            $types,
+            ...array_map(
-            static fn (string $type): bool => in_array($type, ['baseline_compare', 'baseline_capture'], true),
+                static fn (string $type): array => OperationCatalog::rawValuesForCanonical($type),
-        ));
+                $canonicalTypes,
            ),
        )));
    }
    /**
--- a/apps/platform/app/Console/Commands/TenantpilotBackfillFindingLifecycle.php
+++ b/apps/platform/app/Console/Commands/TenantpilotBackfillFindingLifecycle.php
@ -1,129 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Console\Commands;
 use App\Models\Tenant;
 use App\Services\Runbooks\FindingsLifecycleBackfillRunbookService;
 use App\Services\Runbooks\FindingsLifecycleBackfillScope;
 use App\Support\OperationalControls\OperationalControlBlockedException;
 use Illuminate\Console\Command;
 use Illuminate\Validation\ValidationException;
 class TenantpilotBackfillFindingLifecycle extends Command
 {
    protected $signature = 'tenantpilot:findings:backfill-lifecycle
        {--tenant=* : Limit to tenant_id/external_id}';
    protected $description = 'Queue tenant-scoped findings lifecycle backfill jobs idempotently.';
    public function handle(FindingsLifecycleBackfillRunbookService $runbookService): int
    {
        $tenantIdentifiers = array_values(array_filter((array) $this->option('tenant')));
        if ($tenantIdentifiers === []) {
            $this->error('Provide one or more tenants via --tenant={id|external_id}.');
            return self::FAILURE;
        }
        $tenants = $this->resolveTenants($tenantIdentifiers);
        if ($tenants->isEmpty()) {
            $this->info('No tenants matched the provided identifiers.');
            return self::SUCCESS;
        }
        $queued = 0;
        $skipped = 0;
        $nothingToDo = 0;
        foreach ($tenants as $tenant) {
            if (! $tenant instanceof Tenant) {
                continue;
            }
            try {
                $run = $runbookService->start(
                    scope: FindingsLifecycleBackfillScope::singleTenant((int) $tenant->getKey()),
                    initiator: null,
                    reason: null,
                    source: 'cli',
                );
            } catch (OperationalControlBlockedException $e) {
                $this->error(sprintf(
                    'Backfill paused for tenant %d: %s',
                    (int) $tenant->getKey(),
                    $e->getMessage(),
                ));
                return self::FAILURE;
            } catch (ValidationException $e) {
                $errors = $e->errors();
                if (isset($errors['preflight.affected_count'])) {
                    $nothingToDo++;
                    continue;
                }
                $this->error(sprintf(
                    'Backfill blocked for tenant %d: %s',
                    (int) $tenant->getKey(),
                    $e->getMessage(),
                ));
                return self::FAILURE;
            }
            if (! $run->wasRecentlyCreated) {
                $skipped++;
                continue;
            }
            $queued++;
        }
        $this->info(sprintf(
            'Queued %d backfill run(s), skipped %d duplicate run(s), nothing to do %d.',
            $queued,
            $skipped,
            $nothingToDo,
        ));
        return self::SUCCESS;
    }
    /**
     * @param  array<int, string>  $tenantIdentifiers
     * @return \Illuminate\Support\Collection<int, Tenant>
     */
    private function resolveTenants(array $tenantIdentifiers)
    {
        $tenantIds = [];
        foreach ($tenantIdentifiers as $identifier) {
            $tenant = Tenant::query()
                ->forTenant($identifier)
                ->first();
            if ($tenant instanceof Tenant) {
                $tenantIds[] = (int) $tenant->getKey();
            }
        }
        $tenantIds = array_values(array_unique($tenantIds));
        if ($tenantIds === []) {
            return collect();
        }
        return Tenant::query()
            ->whereIn('id', $tenantIds)
            ->orderBy('id')
            ->get();
    }
 }
--- a/apps/platform/app/Console/Commands/TenantpilotRunDeployRunbooks.php
+++ b/apps/platform/app/Console/Commands/TenantpilotRunDeployRunbooks.php
@ -1,56 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Console\Commands;
 use App\Services\Runbooks\FindingsLifecycleBackfillRunbookService;
 use App\Services\Runbooks\FindingsLifecycleBackfillScope;
 use App\Services\Runbooks\RunbookReason;
 use App\Support\OperationalControls\OperationalControlBlockedException;
 use Illuminate\Console\Command;
 use Illuminate\Validation\ValidationException;
 class TenantpilotRunDeployRunbooks extends Command
 {
    protected $signature = 'tenantpilot:run-deploy-runbooks';
    protected $description = 'Run deploy-time runbooks idempotently.';
    public function handle(FindingsLifecycleBackfillRunbookService $runbookService): int
    {
        try {
            $runbookService->start(
                scope: FindingsLifecycleBackfillScope::allTenants(),
                initiator: null,
                reason: new RunbookReason(
                    reasonCode: RunbookReason::CODE_DATA_REPAIR,
                    reasonText: 'Deploy hook automated runbooks',
                ),
                source: 'deploy_hook',
            );
            $this->info('Deploy runbooks started (if needed).');
            return self::SUCCESS;
        } catch (OperationalControlBlockedException $e) {
            $this->info('Deploy runbooks paused: '.$e->getMessage());
            return self::SUCCESS;
        } catch (ValidationException $e) {
            $errors = $e->errors();
            $skippable = isset($errors['preflight.affected_count']) || isset($errors['scope']);
            if ($skippable) {
                $this->info('Deploy runbooks skipped (nothing to do or already running).');
                return self::SUCCESS;
            }
            $this->error('Deploy runbooks blocked by validation errors.');
            return self::FAILURE;
        }
    }
 }
--- a/apps/platform/app/Exceptions/Entitlements/WorkspaceEntitlementBlockedException.php
+++ b/apps/platform/app/Exceptions/Entitlements/WorkspaceEntitlementBlockedException.php
@ -0,0 +1,24 @@
 <?php
 declare(strict_types=1);
 namespace App\Exceptions\Entitlements;
 final class WorkspaceEntitlementBlockedException extends \RuntimeException
 {
    /**
     * @param  array<string, mixed>  $decision
     */
    public function __construct(private readonly array $decision)
    {
        parent::__construct((string) ($decision['block_reason'] ?? 'Workspace entitlement currently blocks this action.'));
    }
    /**
     * @return array<string, mixed>
     */
    public function decision(): array
    {
        return $this->decision;
    }
 }
--- a/apps/platform/app/Filament/Pages/Auth/Login.php
+++ b/apps/platform/app/Filament/Pages/Auth/Login.php
@ -9,4 +9,9 @@
 class Login extends BaseLogin
 {
    protected string $view = 'filament.pages.auth.login';
    public function getTitle(): string
    {
        return __('localization.auth.sign_in_microsoft');
    }
 }
--- a/apps/platform/app/Filament/Pages/Governance/GovernanceInbox.php
+++ b/apps/platform/app/Filament/Pages/Governance/GovernanceInbox.php
@ -0,0 +1,494 @@
 <?php
 declare(strict_types=1);
 namespace App\Filament\Pages\Governance;
 use App\Filament\Pages\Findings\FindingsIntakeQueue;
 use App\Filament\Pages\Findings\MyFindingsInbox;
 use App\Models\Tenant;
 use App\Models\User;
 use App\Models\Workspace;
 use App\Services\Auth\CapabilityResolver;
 use App\Services\Auth\WorkspaceCapabilityResolver;
 use App\Services\TenantReviews\TenantReviewRegisterService;
 use App\Support\Auth\Capabilities;
 use App\Support\GovernanceInbox\GovernanceInboxSectionBuilder;
 use App\Support\Navigation\CanonicalNavigationContext;
 use App\Support\Ui\ActionSurface\ActionSurfaceDeclaration;
 use App\Support\Ui\ActionSurface\Enums\ActionSurfaceInspectAffordance;
 use App\Support\Ui\ActionSurface\Enums\ActionSurfaceProfile;
 use App\Support\Ui\ActionSurface\Enums\ActionSurfaceSlot;
 use App\Support\Ui\ActionSurface\Enums\ActionSurfaceType;
 use App\Support\Workspaces\WorkspaceContext;
 use BackedEnum;
 use Filament\Facades\Filament;
 use Filament\Pages\Page;
 use Illuminate\Support\Str;
 use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
 use UnitEnum;
 class GovernanceInbox extends Page
 {
    protected static bool $isDiscovered = false;
    protected static string|BackedEnum|null $navigationIcon = 'heroicon-o-inbox-stack';
    protected static string|UnitEnum|null $navigationGroup = 'Governance';
    protected static ?string $navigationLabel = 'Governance inbox';
    protected static ?int $navigationSort = 5;
    protected static ?string $title = 'Governance inbox';
    protected static ?string $slug = 'governance/inbox';
    protected string $view = 'filament.pages.governance.governance-inbox';
    /**
     * @var array<int, Tenant>|null
     */
    private ?array $authorizedTenants = null;
    /**
     * @var array<int, Tenant>|null
     */
    private ?array $visibleFindingTenants = null;
    /**
     * @var array<int, Tenant>|null
     */
    private ?array $reviewTenants = null;
    /**
     * @var array<string, mixed>|null
     */
    private ?array $inboxPayload = null;
    /**
     * @var array<string, mixed>|null
     */
    private ?array $unfilteredInboxPayload = null;
    private ?Workspace $workspace = null;
    private ?bool $visibleAlertsFamily = null;
    public ?int $tenantId = null;
    public ?string $family = null;
    public static function actionSurfaceDeclaration(): ActionSurfaceDeclaration
    {
        return ActionSurfaceDeclaration::forPage(ActionSurfaceProfile::ListOnlyReadOnly, ActionSurfaceType::ReadOnlyRegistryReport)
            ->satisfy(ActionSurfaceSlot::ListHeader, 'Header actions keep the workspace decision surface calm and read-only.')
            ->satisfy(ActionSurfaceSlot::InspectAffordance, ActionSurfaceInspectAffordance::ClickableRow->value)
            ->exempt(ActionSurfaceSlot::ListRowMoreMenu, 'The governance inbox routes into existing source surfaces instead of exposing row-level secondary actions.')
            ->exempt(ActionSurfaceSlot::ListBulkMoreGroup, 'The governance inbox does not expose bulk actions.')
            ->satisfy(ActionSurfaceSlot::ListEmptyState, 'Empty states stay calm and capability-safe when no visible attention exists.')
            ->exempt(ActionSurfaceSlot::DetailHeader, 'The governance inbox owns no local detail surface in v1.');
    }
    public function mount(): void
    {
        $this->authorizeWorkspaceMembership();
        $this->applyRequestedTenantPrefilter();
        $this->family = $this->resolveRequestedFamily();
        $this->ensureAtLeastOneVisibleFamily();
        $this->ensureRequestedFamilyIsVisible();
    }
    /**
     * @return array<string, mixed>
     */
    public function appliedScope(): array
    {
        $selectedTenant = $this->selectedTenant();
        $availableFamilies = collect($this->availableFamilies())
            ->keyBy('key');
        return [
            'workspace_label' => $this->workspace()?->name,
            'tenant_label' => $selectedTenant?->name,
            'tenant_prefilter_source' => $selectedTenant instanceof Tenant ? 'explicit_filter' : 'none',
            'family_key' => $this->family,
            'family_label' => $this->family !== null
                ? ($availableFamilies->get($this->family)['label'] ?? Str::headline($this->family))
                : 'All attention',
            'total_count' => (int) ($this->inboxPayload()['total_count'] ?? 0),
        ];
    }
    /**
     * @return list<array{key: string, label: string, count: int}>
     */
    public function availableFamilies(): array
    {
        return $this->inboxPayload()['available_families'] ?? [];
    }
    /**
     * @return list<array<string, mixed>>
     */
    public function sections(): array
    {
        return $this->inboxPayload()['sections'] ?? [];
    }
    /**
     * @return array<string, mixed>
     */
    public function calmEmptyState(): array
    {
        if ($this->tenantFilterAloneExcludesRows()) {
            return [
                'title' => 'This tenant filter is hiding other visible attention',
                'body' => 'The current tenant scope is calm, but other visible tenants in this workspace still have governance attention.',
                'action_label' => 'Clear tenant filter',
                'action_url' => $this->pageUrl(['tenant' => null]),
            ];
        }
        return [
            'title' => 'No visible governance attention right now',
            'body' => 'The current workspace scope is calm across the visible governance families.',
            'action_label' => null,
            'action_url' => null,
        ];
    }
    public function hasTenantPrefilter(): bool
    {
        return $this->selectedTenant() instanceof Tenant;
    }
    public function isActiveFamily(?string $familyKey): bool
    {
        return $this->family === $familyKey;
    }
    public function pageUrl(array $overrides = []): string
    {
        $selectedTenant = $this->selectedTenant();
        $resolvedTenant = array_key_exists('tenant', $overrides)
            ? $overrides['tenant']
            : ($selectedTenant?->getKey() !== null ? (string) $selectedTenant->getKey() : null);
        $resolvedFamily = array_key_exists('family', $overrides)
            ? $overrides['family']
            : $this->family;
        return static::getUrl(
            panel: 'admin',
            parameters: array_filter([
                'tenant_id' => is_string($resolvedTenant) && $resolvedTenant !== '' ? $resolvedTenant : null,
                'family' => is_string($resolvedFamily) && $resolvedFamily !== '' ? $resolvedFamily : null,
            ], static fn (mixed $value): bool => $value !== null && $value !== ''),
        );
    }
    public function navigationContext(): CanonicalNavigationContext
    {
        return new CanonicalNavigationContext(
            sourceSurface: 'governance.inbox',
            canonicalRouteName: static::getRouteName(Filament::getPanel('admin')),
            tenantId: $this->tenantId,
            backLinkLabel: 'Back to governance inbox',
            backLinkUrl: $this->pageUrl(),
        );
    }
    private function authorizeWorkspaceMembership(): void
    {
        $user = auth()->user();
        $workspace = $this->workspace();
        if (! $user instanceof User) {
            abort(403);
        }
        if (! $workspace instanceof Workspace) {
            throw new NotFoundHttpException;
        }
        $resolver = app(WorkspaceCapabilityResolver::class);
        if (! $resolver->isMember($user, $workspace)) {
            throw new NotFoundHttpException;
        }
    }
    private function ensureAtLeastOneVisibleFamily(): void
    {
        if (
            $this->hasVisibleOperationsFamily()
            || $this->visibleFindingTenants() !== []
            || $this->reviewTenants() !== []
            || $this->hasVisibleAlertsFamily()
        ) {
            return;
        }
        abort(403);
    }
    private function ensureRequestedFamilyIsVisible(): void
    {
        if ($this->family === null) {
            return;
        }
        if (in_array($this->family, collect($this->availableFamilies())->pluck('key')->all(), true)) {
            return;
        }
        throw new NotFoundHttpException;
    }
    private function hasVisibleOperationsFamily(): bool
    {
        return $this->authorizedTenants() !== [];
    }
    private function hasVisibleAlertsFamily(): bool
    {
        if (is_bool($this->visibleAlertsFamily)) {
            return $this->visibleAlertsFamily;
        }
        $user = auth()->user();
        $workspace = $this->workspace();
        if (! $user instanceof User || ! $workspace instanceof Workspace) {
            return $this->visibleAlertsFamily = false;
        }
        return $this->visibleAlertsFamily = app(WorkspaceCapabilityResolver::class)->can($user, $workspace, Capabilities::ALERTS_VIEW);
    }
    /**
     * @return array<int, Tenant>
     */
    private function visibleFindingTenants(): array
    {
        if ($this->visibleFindingTenants !== null) {
            return $this->visibleFindingTenants;
        }
        $user = auth()->user();
        $tenants = $this->authorizedTenants();
        if (! $user instanceof User || $tenants === []) {
            return $this->visibleFindingTenants = [];
        }
        $resolver = app(CapabilityResolver::class);
        $resolver->primeMemberships(
            $user,
            array_map(static fn (Tenant $tenant): int => (int) $tenant->getKey(), $tenants),
        );
        return $this->visibleFindingTenants = array_values(array_filter(
            $tenants,
            fn (Tenant $tenant): bool => $resolver->can($user, $tenant, Capabilities::TENANT_FINDINGS_VIEW),
        ));
    }
    /**
     * @return array<int, Tenant>
     */
    private function reviewTenants(): array
    {
        if ($this->reviewTenants !== null) {
            return $this->reviewTenants;
        }
        $user = auth()->user();
        $workspace = $this->workspace();
        if (! $user instanceof User || ! $workspace instanceof Workspace) {
            return $this->reviewTenants = [];
        }
        $service = app(TenantReviewRegisterService::class);
        if (! $service->canAccessWorkspace($user, $workspace)) {
            return $this->reviewTenants = [];
        }
        return $this->reviewTenants = $service->authorizedTenants($user, $workspace);
    }
    /**
     * @return array<int, Tenant>
     */
    private function authorizedTenants(): array
    {
        if ($this->authorizedTenants !== null) {
            return $this->authorizedTenants;
        }
        $user = auth()->user();
        $workspace = $this->workspace();
        if (! $user instanceof User || ! $workspace instanceof Workspace) {
            return $this->authorizedTenants = [];
        }
        return $this->authorizedTenants = $user->tenants()
            ->where('tenants.workspace_id', (int) $workspace->getKey())
            ->where('tenants.status', 'active')
            ->orderBy('tenants.name')
            ->get(['tenants.id', 'tenants.name', 'tenants.external_id', 'tenants.workspace_id'])
            ->all();
    }
    private function applyRequestedTenantPrefilter(): void
    {
        $requestedTenant = request()->query('tenant_id', request()->query('tenant'));
        if (! is_string($requestedTenant) && ! is_numeric($requestedTenant)) {
            return;
        }
        foreach ($this->authorizedTenants() as $tenant) {
            if ((string) $tenant->getKey() !== (string) $requestedTenant && (string) $tenant->external_id !== (string) $requestedTenant) {
                continue;
            }
            $this->tenantId = (int) $tenant->getKey();
            return;
        }
        throw new NotFoundHttpException;
    }
    private function resolveRequestedFamily(): ?string
    {
        $family = request()->query('family');
        if (! is_string($family)) {
            return null;
        }
        return in_array($family, [
            'assigned_findings',
            'intake_findings',
            'stale_operations',
            'alert_delivery_failures',
            'review_follow_up',
        ], true) ? $family : null;
    }
    private function workspace(): ?Workspace
    {
        if ($this->workspace instanceof Workspace) {
            return $this->workspace;
        }
        $workspaceId = app(WorkspaceContext::class)->currentWorkspaceId(request());
        if (! is_int($workspaceId)) {
            return null;
        }
        return $this->workspace = Workspace::query()->whereKey($workspaceId)->first();
    }
    /**
     * @return array<string, mixed>
     */
    private function inboxPayload(): array
    {
        if (is_array($this->inboxPayload)) {
            return $this->inboxPayload;
        }
        $user = auth()->user();
        $workspace = $this->workspace();
        if (! $user instanceof User || ! $workspace instanceof Workspace) {
            return $this->inboxPayload = [
                'sections' => [],
                'available_families' => [],
                'family_counts' => [],
                'total_count' => 0,
            ];
        }
        return $this->inboxPayload = app(GovernanceInboxSectionBuilder::class)->build(
            user: $user,
            workspace: $workspace,
            authorizedTenants: $this->authorizedTenants(),
            visibleFindingTenants: $this->visibleFindingTenants(),
            reviewTenants: $this->reviewTenants(),
            canViewAlerts: $this->hasVisibleAlertsFamily(),
            selectedTenant: $this->selectedTenant(),
            selectedFamily: $this->family,
            navigationContext: $this->navigationContext(),
        );
    }
    /**
     * @return array<string, mixed>
     */
    private function unfilteredInboxPayload(): array
    {
        if (is_array($this->unfilteredInboxPayload)) {
            return $this->unfilteredInboxPayload;
        }
        $user = auth()->user();
        $workspace = $this->workspace();
        if (! $user instanceof User || ! $workspace instanceof Workspace) {
            return $this->unfilteredInboxPayload = [
                'sections' => [],
                'available_families' => [],
                'family_counts' => [],
                'total_count' => 0,
            ];
        }
        return $this->unfilteredInboxPayload = app(GovernanceInboxSectionBuilder::class)->build(
            user: $user,
            workspace: $workspace,
            authorizedTenants: $this->authorizedTenants(),
            visibleFindingTenants: $this->visibleFindingTenants(),
            reviewTenants: $this->reviewTenants(),
            canViewAlerts: $this->hasVisibleAlertsFamily(),
            selectedTenant: null,
            selectedFamily: null,
            navigationContext: $this->navigationContext(),
        );
    }
    private function selectedTenant(): ?Tenant
    {
        if (! is_int($this->tenantId)) {
            return null;
        }
        foreach ($this->authorizedTenants() as $tenant) {
            if ((int) $tenant->getKey() === $this->tenantId) {
                return $tenant;
            }
        }
        return null;
    }
    private function tenantFilterAloneExcludesRows(): bool
    {
        if (! is_int($this->tenantId) || $this->family !== null) {
            return false;
        }
        if ($this->sections() !== []) {
            return false;
        }
        return (int) ($this->unfilteredInboxPayload()['total_count'] ?? 0) > 0;
    }
 }
--- a/apps/platform/app/Filament/Pages/Operations/TenantlessOperationRunViewer.php
+++ b/apps/platform/app/Filament/Pages/Operations/TenantlessOperationRunViewer.php
@ -6,6 +6,7 @@
 use App\Filament\Resources\OperationRunResource;
 use App\Models\OperationRun;
 use App\Models\SupportRequest;
 use App\Models\Tenant;
 use App\Models\User;
 use App\Services\Audit\WorkspaceAuditLogger;
@ -23,11 +24,14 @@
 use App\Support\OpsUx\OperationUxPresenter;
 use App\Support\OpsUx\OpsUxBrowserEvents;
 use App\Support\OpsUx\RunDetailPolling;
 use App\Support\ProductTelemetry\ProductTelemetryRecorder;
 use App\Support\ProductTelemetry\ProductUsageEventCatalog;
 use App\Support\ReasonTranslation\ReasonPresenter;
 use App\Support\RedactionIntegrity;
 use App\Support\RestoreSafety\RestoreSafetyCopy;
 use App\Support\Rbac\UiEnforcement;
 use App\Support\SupportDiagnostics\SupportDiagnosticBundleBuilder;
 use App\Support\SupportRequests\SupportRequestSubmissionService;
 use App\Support\Tenants\ReferencedTenantLifecyclePresentation;
 use App\Support\Tenants\TenantInteractionLane;
 use App\Support\Tenants\TenantOperabilityQuestion;
@ -38,6 +42,10 @@
 use App\Support\Ui\OperatorExplanation\OperatorExplanationPattern;
 use Filament\Actions\Action;
 use Filament\Actions\ActionGroup;
 use Filament\Forms\Components\Placeholder;
 use Filament\Forms\Components\Select;
 use Filament\Forms\Components\TextInput;
 use Filament\Forms\Components\Textarea;
 use Filament\Notifications\Notification;
 use Filament\Pages\Page;
 use Filament\Schemas\Components\EmbeddedSchema;
@ -139,10 +147,6 @@ protected function getHeaderActions(): array
                ? OperationRunLinks::tenantlessView($this->run, $navigationContext)
                : OperationRunLinks::index());
        if (isset($this->run)) {
            $actions[] = $this->openSupportDiagnosticsAction();
        }
        if (! isset($this->run)) {
            return $actions;
        }
@ -165,6 +169,14 @@ protected function getHeaderActions(): array
                ->color('gray');
        }
        $actions[] = ActionGroup::make([
            $this->openSupportDiagnosticsAction(),
            $this->requestSupportAction(),
        ])
            ->label('More')
            ->icon('heroicon-o-ellipsis-horizontal')
            ->color('gray');
        $actions[] = $this->resumeCaptureAction();
        return $actions;
@ -226,8 +238,6 @@ private function openSupportDiagnosticsAction(): Action
        $action = Action::make('openSupportDiagnostics')
            ->label('Open support diagnostics')
            ->icon('heroicon-o-lifebuoy')
            ->iconButton()
            ->tooltip('Open support diagnostics')
            ->color('gray')
            ->record($this->run)
            ->modal()
@ -249,39 +259,85 @@ private function openSupportDiagnosticsAction(): Action
            ->apply();
    }
    public function authorizeOperationRunSupportRequest(): void
    {
        $this->resolveRunTenantForCapability(Capabilities::SUPPORT_REQUESTS_CREATE);
    }
    private function requestSupportAction(): Action
    {
        $action = Action::make('requestSupport')
            ->label('Request support')
            ->icon('heroicon-o-paper-airplane')
            ->record($this->run)
            ->slideOver()
            ->stickyModalHeader()
            ->modalHeading('Request support')
            ->modalDescription('Share a concise summary and TenantAtlas will attach redacted context from the current run.')
            ->modalSubmitActionLabel('Submit support request')
            ->form([
                Placeholder::make('primary_context')
                    ->label('Primary context')
                    ->content(fn (): string => OperationRunLinks::identifier($this->run))
                    ->columnSpanFull(),
                Placeholder::make('included_context')
                    ->label('Included context')
                    ->content(fn (): string => $this->operationSupportRequestAttachmentSummary())
                    ->columnSpanFull(),
                Select::make('severity')
                    ->label('Severity')
                    ->options(SupportRequest::severityOptions())
                    ->default(SupportRequest::SEVERITY_NORMAL)
                    ->required()
                    ->native(false),
                TextInput::make('summary')
                    ->label('Summary')
                    ->required()
                    ->columnSpanFull(),
                Textarea::make('reproduction_notes')
                    ->label('Reproduction notes')
                    ->rows(4)
                    ->columnSpanFull(),
                TextInput::make('contact_name')
                    ->label('Contact name')
                    ->default(fn (): ?string => $this->resolveViewerActor()->name),
                TextInput::make('contact_email')
                    ->label('Contact email')
                    ->email()
                    ->default(fn (): ?string => $this->resolveViewerActor()->email),
            ])
            ->action(function (array $data): void {
                $actor = $this->resolveViewerActor();
                $supportRequest = app(SupportRequestSubmissionService::class)->submitForOperationRun($this->run, $actor, $data);
                Notification::make()
                    ->title('Support request submitted')
                    ->body('Reference '.$supportRequest->internal_reference)
                    ->success()
                    ->send();
            });
        return UiEnforcement::forAction($action)
            ->requireCapability(Capabilities::SUPPORT_REQUESTS_CREATE)
            ->apply();
    }
    /**
     * @return array<string, mixed>
     */
    public function operationRunSupportDiagnosticBundle(): array
    {
-        $user = auth()->user();
+        $user = $this->resolveViewerActor();
-        $tenant = $this->supportDiagnosticsTenant();
+        $tenant = $this->resolveRunTenantForCapability(Capabilities::SUPPORT_DIAGNOSTICS_VIEW);
        if (! $user instanceof User || ! $tenant instanceof Tenant) {
            abort(404);
        }
        $resolver = app(CapabilityResolver::class);
        if (! $resolver->isMember($user, $tenant)) {
            abort(404);
        }
        if (! $resolver->can($user, $tenant, Capabilities::SUPPORT_DIAGNOSTICS_VIEW)) {
            abort(403);
        }
        return app(SupportDiagnosticBundleBuilder::class)->forOperationRun($this->run, $user);
    }
    private function auditOperationSupportDiagnosticsOpen(): void
    {
-        $user = auth()->user();
+        $user = $this->resolveViewerActor();
-        $tenant = $this->supportDiagnosticsTenant();
+        $tenant = $this->resolveRunTenantForCapability(Capabilities::SUPPORT_DIAGNOSTICS_VIEW);
        if (! $user instanceof User || ! $tenant instanceof Tenant) {
            abort(404);
        }
        $this->recordSupportDiagnosticsOpened(
            tenant: $tenant,
@ -305,6 +361,59 @@ private function supportDiagnosticsTenant(): ?Tenant
        return $this->run->loadMissing('tenant')->tenant;
    }
    private function resolveViewerActor(): User
    {
        $user = auth()->user();
        if (! $user instanceof User) {
            abort(403);
        }
        return $user;
    }
    private function resolveRunTenantForCapability(string $capability): Tenant
    {
        $tenant = $this->supportDiagnosticsTenant();
        $user = $this->resolveViewerActor();
        if (! $tenant instanceof Tenant) {
            abort(404);
        }
        $resolver = app(CapabilityResolver::class);
        if (! $resolver->isMember($user, $tenant)) {
            abort(404);
        }
        if (! $resolver->can($user, $tenant, $capability)) {
            abort(403);
        }
        return $tenant;
    }
    private function operationSupportRequestAttachmentSummary(): string
    {
        $tenant = $this->supportDiagnosticsTenant();
        $user = auth()->user();
        if (! $tenant instanceof Tenant || ! $user instanceof User) {
            return 'Only canonical redacted run context will be attached.';
        }
        $resolver = app(CapabilityResolver::class);
        if (! $resolver->isMember($user, $tenant)) {
            return 'Only canonical redacted run context will be attached.';
        }
        return $resolver->can($user, $tenant, Capabilities::SUPPORT_DIAGNOSTICS_VIEW)
            ? 'A redacted diagnostic snapshot and the canonical run context will be attached.'
            : 'Only the canonical redacted run context will be attached because you cannot view support diagnostics.';
    }
    /**
     * @param  array<string, mixed>  $bundle
     */
@ -328,6 +437,19 @@ private function recordSupportDiagnosticsOpened(Tenant $tenant, array $bundle, U
            operationRun: $this->run,
        );
        app(ProductTelemetryRecorder::class)->record(
            eventName: ProductUsageEventCatalog::SUPPORT_DIAGNOSTICS_OPENED,
            workspaceId: (int) $tenant->workspace_id,
            tenantId: (int) $tenant->getKey(),
            userId: (int) $user->getKey(),
            subjectType: 'operation_run',
            subjectId: (int) $this->run->getKey(),
            metadata: [
                'source_surface' => 'operation_run_viewer',
                'operation_type' => (string) $this->run->type,
            ],
        );
        $this->supportDiagnosticsAuditKeys[] = $auditKey;
    }
--- a/apps/platform/app/Filament/Pages/Reviews/CustomerReviewWorkspace.php
+++ b/apps/platform/app/Filament/Pages/Reviews/CustomerReviewWorkspace.php
@ -0,0 +1,530 @@
 <?php
 declare(strict_types=1);
 namespace App\Filament\Pages\Reviews;
 use App\Filament\Resources\TenantReviewResource;
 use App\Models\Tenant;
 use App\Models\ReviewPack;
 use App\Models\TenantReview;
 use App\Models\User;
 use App\Models\Workspace;
 use App\Services\ReviewPackService;
 use App\Services\TenantReviews\TenantReviewRegisterService;
 use App\Support\Auth\Capabilities;
 use App\Support\Findings\FindingOutcomeSemantics;
 use App\Support\Filament\TablePaginationProfiles;
 use App\Support\ReviewPackStatus;
 use App\Support\Ui\ActionSurface\ActionSurfaceDeclaration;
 use App\Support\Ui\ActionSurface\Enums\ActionSurfaceInspectAffordance;
 use App\Support\Ui\ActionSurface\Enums\ActionSurfaceProfile;
 use App\Support\Ui\ActionSurface\Enums\ActionSurfaceSlot;
 use App\Support\Ui\ActionSurface\Enums\ActionSurfaceType;
 use App\Support\Ui\GovernanceArtifactTruth\ArtifactTruthEnvelope;
 use App\Support\Ui\GovernanceArtifactTruth\ArtifactTruthPresenter;
 use App\Support\Ui\GovernanceArtifactTruth\CompressedGovernanceOutcome;
 use App\Support\Ui\GovernanceArtifactTruth\SurfaceCompressionContext;
 use App\Support\Workspaces\WorkspaceContext;
 use BackedEnum;
 use Filament\Actions\Action;
 use Filament\Pages\Page;
 use Filament\Tables\Columns\TextColumn;
 use Filament\Tables\Concerns\InteractsWithTable;
 use Filament\Tables\Contracts\HasTable;
 use Filament\Tables\Filters\SelectFilter;
 use Filament\Tables\Table;
 use Illuminate\Database\Eloquent\Builder;
 use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
 use UnitEnum;
 class CustomerReviewWorkspace extends Page implements HasTable
 {
    use InteractsWithTable;
    public const string DETAIL_CONTEXT_QUERY_KEY = 'customer_workspace';
    private const string SOURCE_SURFACE = 'customer_review_workspace';
    protected static bool $isDiscovered = false;
    protected static string|BackedEnum|null $navigationIcon = 'heroicon-o-document-text';
    protected static string|UnitEnum|null $navigationGroup = 'Reporting';
    protected static ?string $navigationLabel = 'Customer reviews';
    protected static ?int $navigationSort = 44;
    protected static ?string $title = 'Customer Review Workspace';
    protected static ?string $slug = 'reviews/workspace';
    protected string $view = 'filament.pages.reviews.customer-review-workspace';
    public static function actionSurfaceDeclaration(): ActionSurfaceDeclaration
    {
        return ActionSurfaceDeclaration::forPage(ActionSurfaceProfile::RunLog, ActionSurfaceType::ReadOnlyRegistryReport)
            ->satisfy(ActionSurfaceSlot::ListHeader, 'Header actions provide a single Clear filters action for the customer review workspace.')
            ->satisfy(ActionSurfaceSlot::InspectAffordance, ActionSurfaceInspectAffordance::ClickableRow->value)
            ->exempt(ActionSurfaceSlot::ListBulkMoreGroup, 'The customer review workspace remains scan-first and does not expose bulk actions.')
            ->satisfy(ActionSurfaceSlot::ListEmptyState, 'The empty state keeps exactly one Clear filters CTA when filters are active.')
            ->exempt(ActionSurfaceSlot::DetailHeader, 'Row navigation opens the latest published review detail instead of an inline canonical detail panel.');
    }
    public static function getNavigationGroup(): string
    {
        return __('localization.review.reporting');
    }
    public static function getNavigationLabel(): string
    {
        return __('localization.review.customer_reviews');
    }
    public function getTitle(): string
    {
        return __('localization.review.customer_review_workspace');
    }
    public static function tenantPrefilterUrl(Tenant $tenant): string
    {
        $tenantIdentifier = filled($tenant->external_id)
            ? (string) $tenant->external_id
            : (string) $tenant->getKey();
        return static::getUrl(panel: 'admin').'?'.http_build_query([
            'tenant' => $tenantIdentifier,
        ]);
    }
    /**
     * @var array<int, Tenant>|null
     */
    private ?array $authorizedTenants = null;
    public function mount(): void
    {
        $this->authorizePageAccess();
        $this->applyRequestedTenantPrefilter();
        $this->mountInteractsWithTable();
    }
    protected function getHeaderActions(): array
    {
        return [
            Action::make('clear_filters')
                ->label(__('localization.review.clear_filters'))
                ->icon('heroicon-o-x-mark')
                ->color('gray')
                ->visible(fn (): bool => $this->hasActiveFilters())
                ->action(function (): void {
                    $this->clearWorkspaceFilters();
                }),
        ];
    }
    public function table(Table $table): Table
    {
        return $table
            ->query(fn (): Builder => $this->workspaceQuery())
            ->defaultSort('name')
            ->paginated(TablePaginationProfiles::customPage())
            ->persistFiltersInSession()
            ->persistSearchInSession()
            ->persistSortInSession()
            ->recordUrl(fn (Tenant $record): ?string => $this->latestReviewUrl($record))
            ->columns([
                TextColumn::make('name')->label(__('localization.review.tenant'))->searchable()->sortable(),
                TextColumn::make('latest_review')
                    ->label(__('localization.review.latest_review'))
                    ->badge()
                    ->getStateUsing(fn (Tenant $record): string => $this->latestReviewStateLabel($record))
                    ->color(fn (Tenant $record): string => $this->latestReviewStateColor($record))
                    ->icon(fn (Tenant $record): ?string => $this->latestReviewStateIcon($record))
                    ->iconColor(fn (Tenant $record): ?string => $this->latestReviewStateIconColor($record))
                    ->description(fn (Tenant $record): ?string => $this->reviewOutcomeDescription($record))
                    ->wrap(),
                TextColumn::make('finding_summary')
                    ->label(__('localization.review.key_findings'))
                    ->getStateUsing(fn (Tenant $record): string => $this->findingSummary($record))
                    ->wrap(),
                TextColumn::make('accepted_risk_summary')
                    ->label(__('localization.review.accepted_risks'))
                    ->getStateUsing(fn (Tenant $record): string => $this->acceptedRiskSummary($record))
                    ->wrap(),
                TextColumn::make('published_at')
                    ->label(__('localization.review.published'))
                    ->getStateUsing(fn (Tenant $record): ?string => $this->latestPublishedAt($record)?->toDateTimeString())
                    ->dateTime()
                    ->placeholder('—'),
                TextColumn::make('review_pack_state')
                    ->label(__('localization.review.review_pack'))
                    ->getStateUsing(fn (Tenant $record): string => $this->reviewPackAvailability($record)),
            ])
            ->filters([
                SelectFilter::make('tenant_id')
                    ->label(__('localization.review.tenant'))
                    ->options(fn (): array => $this->tenantFilterOptions())
                    ->default(fn (): ?string => $this->defaultTenantFilter())
                    ->query(function (Builder $query, array $data): Builder {
                        $tenantId = $data['value'] ?? null;
                        return is_numeric($tenantId)
                            ? $query->whereKey((int) $tenantId)
                            : $query;
                    })
                    ->searchable(),
            ])
            ->actions([
                Action::make('open_latest_review')
                    ->label(__('localization.review.open_latest_review'))
                    ->icon('heroicon-o-arrow-top-right-on-square')
                    ->url(fn (Tenant $record): ?string => $this->latestReviewUrl($record))
                    ->visible(fn (Tenant $record): bool => $this->latestPublishedReview($record) instanceof TenantReview),
                Action::make('download_review_pack')
                    ->label(__('localization.review.download_review_pack'))
                    ->icon('heroicon-o-arrow-down-tray')
                    ->url(fn (Tenant $record): ?string => $this->latestReviewPackDownloadUrl($record))
                    ->openUrlInNewTab()
                    ->visible(fn (Tenant $record): bool => is_string($this->latestReviewPackDownloadUrl($record))),
            ])
            ->bulkActions([])
            ->emptyStateHeading(__('localization.review.no_entitled_tenants'))
            ->emptyStateDescription(fn (): string => $this->hasActiveFilters()
                ? __('localization.review.clear_filters_description')
                : __('localization.review.adjust_filters_description'))
            ->emptyStateActions([
                Action::make('clear_filters_empty')
                    ->label(__('localization.review.clear_filters'))
                    ->icon('heroicon-o-x-mark')
                    ->color('gray')
                    ->visible(fn (): bool => $this->hasActiveFilters())
                    ->action(fn (): mixed => $this->clearWorkspaceFilters()),
            ]);
    }
    /**
     * @return array<int, Tenant>
     */
    public function authorizedTenants(): array
    {
        if ($this->authorizedTenants !== null) {
            return $this->authorizedTenants;
        }
        $user = auth()->user();
        $workspace = $this->workspace();
        if (! $user instanceof User || ! $workspace instanceof Workspace) {
            return $this->authorizedTenants = [];
        }
        return $this->authorizedTenants = app(TenantReviewRegisterService::class)->authorizedTenants($user, $workspace);
    }
    private function authorizePageAccess(): void
    {
        $user = auth()->user();
        $workspace = $this->workspace();
        if (! $user instanceof User) {
            abort(403);
        }
        if (! $workspace instanceof Workspace) {
            throw new NotFoundHttpException;
        }
        $service = app(TenantReviewRegisterService::class);
        if (! $service->canAccessWorkspace($user, $workspace)) {
            throw new NotFoundHttpException;
        }
        if ($this->authorizedTenants() === []) {
            throw new NotFoundHttpException;
        }
    }
    private function workspaceQuery(): Builder
    {
        $user = auth()->user();
        $workspace = $this->workspace();
        if (! $user instanceof User || ! $workspace instanceof Workspace) {
            return Tenant::query()->whereRaw('1 = 0');
        }
        return app(TenantReviewRegisterService::class)->customerWorkspaceTenantQuery($user, $workspace);
    }
    /**
     * @return array<string, string>
     */
    private function tenantFilterOptions(): array
    {
        return collect($this->authorizedTenants())
            ->mapWithKeys(static fn (Tenant $tenant): array => [
                (string) $tenant->getKey() => $tenant->name,
            ])
            ->all();
    }
    private function defaultTenantFilter(): ?string
    {
        $tenantId = app(WorkspaceContext::class)->lastTenantId(request());
        return is_int($tenantId) && array_key_exists($tenantId, $this->authorizedTenants())
            ? (string) $tenantId
            : null;
    }
    private function applyRequestedTenantPrefilter(): void
    {
        $requestedTenant = request()->query('tenant', request()->query('tenant_id'));
        if (! is_string($requestedTenant) && ! is_numeric($requestedTenant)) {
            return;
        }
        foreach ($this->authorizedTenants() as $tenant) {
            if ((string) $tenant->getKey() !== (string) $requestedTenant && (string) $tenant->external_id !== (string) $requestedTenant) {
                continue;
            }
            $this->tableFilters['tenant_id']['value'] = (string) $tenant->getKey();
            $this->tableDeferredFilters['tenant_id']['value'] = (string) $tenant->getKey();
            return;
        }
        throw new NotFoundHttpException;
    }
    private function hasActiveFilters(): bool
    {
        return $this->currentTenantFilterId() !== null;
    }
    private function clearWorkspaceFilters(): void
    {
        app(WorkspaceContext::class)->clearLastTenantId(request());
        $this->removeTableFilters();
    }
    private function currentTenantFilterId(): ?int
    {
        $tenantFilter = data_get($this->tableFilters, 'tenant_id.value');
        if (! is_numeric($tenantFilter)) {
            $tenantFilter = data_get(session()->get($this->getTableFiltersSessionKey(), []), 'tenant_id.value');
        }
        return is_numeric($tenantFilter) ? (int) $tenantFilter : null;
    }
    private function workspace(): ?Workspace
    {
        $workspaceId = app(WorkspaceContext::class)->currentWorkspaceId(request());
        return is_numeric($workspaceId)
            ? Workspace::query()->whereKey((int) $workspaceId)->first()
            : null;
    }
    private function latestPublishedReview(Tenant $tenant): ?TenantReview
    {
        $review = $tenant->tenantReviews->first();
        return $review instanceof TenantReview ? $review : null;
    }
    private function latestReviewUrl(Tenant $tenant): ?string
    {
        $review = $this->latestPublishedReview($tenant);
        if (! $review instanceof TenantReview) {
            return null;
        }
        return TenantReviewResource::tenantScopedUrl('view', ['record' => $review], $tenant, 'tenant').'?'.http_build_query([
            self::DETAIL_CONTEXT_QUERY_KEY => 1,
        ]);
    }
    private function latestReviewPack(Tenant $tenant): ?ReviewPack
    {
        $review = $this->latestPublishedReview($tenant);
        $pack = $review?->currentExportReviewPack;
        return $pack instanceof ReviewPack ? $pack : null;
    }
    private function latestReviewPackDownloadUrl(Tenant $tenant): ?string
    {
        $user = auth()->user();
        $pack = $this->latestReviewPack($tenant);
        if (! $user instanceof User || ! $pack instanceof ReviewPack) {
            return null;
        }
        if (! $user->can(Capabilities::REVIEW_PACK_VIEW, $tenant)) {
            return null;
        }
        if ($pack->status !== ReviewPackStatus::Ready->value) {
            return null;
        }
        if ($pack->expires_at !== null && $pack->expires_at->isPast()) {
            return null;
        }
        return app(ReviewPackService::class)->generateDownloadUrl($pack, [
            'source_surface' => self::SOURCE_SURFACE,
        ]);
    }
    private function latestPublishedAt(Tenant $tenant): ?\Illuminate\Support\Carbon
    {
        return $this->latestPublishedReview($tenant)?->published_at;
    }
    private function reviewTruth(Tenant $tenant): ?ArtifactTruthEnvelope
    {
        $review = $this->latestPublishedReview($tenant);
        return $review instanceof TenantReview
            ? app(ArtifactTruthPresenter::class)->forTenantReview($review)
            : null;
    }
    private function reviewOutcome(Tenant $tenant): ?CompressedGovernanceOutcome
    {
        $presenter = app(ArtifactTruthPresenter::class);
        $review = $this->latestPublishedReview($tenant);
        $truth = $this->reviewTruth($tenant);
        if (! $review instanceof TenantReview || ! $truth instanceof ArtifactTruthEnvelope) {
            return null;
        }
        return $presenter->compressedOutcomeFor($review, SurfaceCompressionContext::reviewRegister())
            ?? $presenter->compressedOutcomeFromEnvelope($truth, SurfaceCompressionContext::reviewRegister());
    }
    private function latestReviewStateLabel(Tenant $tenant): string
    {
        return $this->reviewOutcome($tenant)?->primaryLabel ?? __('localization.review.no_published_review');
    }
    private function latestReviewStateColor(Tenant $tenant): string
    {
        return $this->reviewOutcome($tenant)?->primaryBadge->color ?? 'gray';
    }
    private function latestReviewStateIcon(Tenant $tenant): ?string
    {
        return $this->reviewOutcome($tenant)?->primaryBadge->icon;
    }
    private function latestReviewStateIconColor(Tenant $tenant): ?string
    {
        return $this->reviewOutcome($tenant)?->primaryBadge->iconColor;
    }
    private function reviewOutcomeDescription(Tenant $tenant): ?string
    {
        $review = $this->latestPublishedReview($tenant);
        if (! $review instanceof TenantReview) {
            return __('localization.review.no_published_review_available');
        }
        $primaryReason = $this->reviewOutcome($tenant)?->primaryReason;
        $summary = is_array($review->summary) ? $review->summary : [];
        $findingOutcomes = $summary['finding_outcomes'] ?? null;
        if (! is_array($findingOutcomes)) {
            return $primaryReason;
        }
        $findingOutcomeSummary = app(FindingOutcomeSemantics::class)->compactOutcomeSummary($findingOutcomes);
        if ($findingOutcomeSummary === null) {
            return $primaryReason;
        }
        return trim($primaryReason.' '.__('localization.review.terminal_outcomes').': '.$findingOutcomeSummary.'.');
    }
    private function findingSummary(Tenant $tenant): string
    {
        $review = $this->latestPublishedReview($tenant);
        if (! $review instanceof TenantReview) {
            return __('localization.review.no_published_review_available');
        }
        $summary = is_array($review->summary) ? $review->summary : [];
        $findingCount = (int) ($summary['finding_count'] ?? 0);
        $findingOutcomes = is_array($summary['finding_outcomes'] ?? null) ? $summary['finding_outcomes'] : [];
        $terminalOutcomes = app(FindingOutcomeSemantics::class)->compactOutcomeSummary($findingOutcomes);
        if ($findingCount === 0) {
            return __('localization.review.no_findings_recorded');
        }
        if ($terminalOutcomes === null) {
            return __('localization.review.findings_count_summary', ['count' => $findingCount]);
        }
        return __('localization.review.findings_count_with_outcomes', [
            'count' => $findingCount,
            'outcomes' => $terminalOutcomes,
        ]);
    }
    private function acceptedRiskSummary(Tenant $tenant): string
    {
        $review = $this->latestPublishedReview($tenant);
        if (! $review instanceof TenantReview) {
            return __('localization.review.no_published_review_available');
        }
        $summary = is_array($review->summary) ? $review->summary : [];
        $riskAcceptance = is_array($summary['risk_acceptance'] ?? null) ? $summary['risk_acceptance'] : [];
        $statusMarkedCount = (int) ($riskAcceptance['status_marked_count'] ?? 0);
        $validGovernedCount = (int) ($riskAcceptance['valid_governed_count'] ?? 0);
        $warningCount = (int) ($riskAcceptance['warning_count'] ?? 0);
        return match (true) {
            $statusMarkedCount === 0 => __('localization.review.no_accepted_risks_recorded'),
            $warningCount > 0 => __('localization.review.accepted_risks_need_follow_up', ['warnings' => $warningCount, 'total' => $statusMarkedCount]),
            $validGovernedCount > 0 => __('localization.review.accepted_risks_governed', ['count' => $validGovernedCount]),
            default => __('localization.review.accepted_risks_on_record', ['count' => $statusMarkedCount]),
        };
    }
    private function reviewPackAvailability(Tenant $tenant): string
    {
        $pack = $this->latestReviewPack($tenant);
        if (! $pack instanceof ReviewPack) {
            return __('localization.review.unavailable');
        }
        if ($pack->status !== ReviewPackStatus::Ready->value) {
            return __('localization.review.unavailable');
        }
        if ($pack->expires_at !== null && $pack->expires_at->isPast()) {
            return __('localization.review.unavailable');
        }
        return __('localization.review.available');
    }
 }
--- a/apps/platform/app/Filament/Pages/Reviews/ReviewRegister.php
+++ b/apps/platform/app/Filament/Pages/Reviews/ReviewRegister.php
@ -9,6 +9,7 @@
 use App\Models\TenantReview;
 use App\Models\User;
 use App\Models\Workspace;
 use App\Services\ReviewPackService;
 use App\Services\TenantReviews\TenantReviewRegisterService;
 use App\Support\Auth\Capabilities;
 use App\Support\Badges\BadgeCatalog;
@ -176,6 +177,24 @@ public function table(Table $table): Table
                    ->visible(fn (TenantReview $record): bool => auth()->user() instanceof User
                        && auth()->user()->can(Capabilities::TENANT_REVIEW_MANAGE, $record->tenant)
                        && in_array($record->status, ['ready', 'published'], true))
                    ->disabled(fn (TenantReview $record): bool => (bool) (app(ReviewPackService::class)->reviewPackGenerationDecisionForTenant($record->tenant)['is_blocked'] ?? false))
                    ->tooltip(function (TenantReview $record): ?string {
                        $decision = app(ReviewPackService::class)->reviewPackGenerationDecisionForTenant($record->tenant);
                        if ((bool) ($decision['is_blocked'] ?? false)) {
                            $reason = $decision['block_reason'] ?? null;
                            return is_string($reason) && $reason !== '' ? $reason : null;
                        }
                        if ((bool) ($decision['is_warning'] ?? false)) {
                            $reason = $decision['warning_reason'] ?? null;
                            return is_string($reason) && $reason !== '' ? $reason : null;
                        }
                        return null;
                    })
                    ->action(fn (TenantReview $record): mixed => TenantReviewResource::executeExport($record)),
            ])
            ->bulkActions([])
--- a/apps/platform/app/Filament/Pages/Settings/WorkspaceSettings.php
+++ b/apps/platform/app/Filament/Pages/Settings/WorkspaceSettings.php
@ -7,7 +7,12 @@
 use App\Models\User;
 use App\Models\Workspace;
 use App\Models\WorkspaceSetting;
 use App\Support\Ai\AiPolicyMode;
 use App\Support\Ai\AiUseCaseCatalog;
 use App\Services\Auth\WorkspaceCapabilityResolver;
 use App\Services\Entitlements\WorkspaceEntitlementResolver;
 use App\Services\Entitlements\WorkspacePlanProfileCatalog;
 use App\Services\Localization\LocaleResolver;
 use App\Services\Settings\SettingsResolver;
 use App\Services\Settings\SettingsWriter;
 use App\Support\Auth\Capabilities;
@ -20,7 +25,9 @@
 use BackedEnum;
 use Filament\Actions\Action;
 use Filament\Forms\Components\KeyValue;
 use Filament\Forms\Components\Placeholder;
 use Filament\Forms\Components\Select;
 use Filament\Forms\Components\Textarea;
 use Filament\Forms\Components\TextInput;
 use Filament\Notifications\Notification;
 use Filament\Pages\Page;
@ -51,6 +58,8 @@ class WorkspaceSettings extends Page
     * @var array<string, array{domain: string, key: string, type: 'int'|'json'|'string'|'bool'}>
     */
    private const SETTING_FIELDS = [
        'ai_policy_mode' => ['domain' => 'ai', 'key' => 'policy_mode', 'type' => 'string'],
        'localization_default_locale' => ['domain' => 'localization', 'key' => 'default_locale', 'type' => 'string'],
        'backup_retention_keep_last_default' => ['domain' => 'backup', 'key' => 'retention_keep_last_default', 'type' => 'int'],
        'backup_retention_min_floor' => ['domain' => 'backup', 'key' => 'retention_min_floor', 'type' => 'int'],
        'drift_severity_mapping' => ['domain' => 'drift', 'key' => 'severity_mapping', 'type' => 'json'],
@ -58,10 +67,23 @@ class WorkspaceSettings extends Page
        'baseline_alert_min_severity' => ['domain' => 'baseline', 'key' => 'alert_min_severity', 'type' => 'string'],
        'baseline_auto_close_enabled' => ['domain' => 'baseline', 'key' => 'auto_close_enabled', 'type' => 'bool'],
        'findings_sla_days' => ['domain' => 'findings', 'key' => 'sla_days', 'type' => 'json'],
        'entitlements_plan_profile' => ['domain' => 'entitlements', 'key' => 'plan_profile', 'type' => 'string'],
        'entitlements_managed_tenant_limit_override_value' => ['domain' => 'entitlements', 'key' => 'managed_tenant_limit_override_value', 'type' => 'int'],
        'entitlements_managed_tenant_limit_override_reason' => ['domain' => 'entitlements', 'key' => 'managed_tenant_limit_override_reason', 'type' => 'string'],
        'entitlements_review_pack_generation_override_value' => ['domain' => 'entitlements', 'key' => 'review_pack_generation_override_value', 'type' => 'bool'],
        'entitlements_review_pack_generation_override_reason' => ['domain' => 'entitlements', 'key' => 'review_pack_generation_override_reason', 'type' => 'string'],
        'operations_operation_run_retention_days' => ['domain' => 'operations', 'key' => 'operation_run_retention_days', 'type' => 'int'],
        'operations_stuck_run_threshold_minutes' => ['domain' => 'operations', 'key' => 'stuck_run_threshold_minutes', 'type' => 'int'],
    ];
    /**
     * @var array<string, string>
     */
    private const ENTITLEMENT_OVERRIDE_REASON_FIELDS = [
        'entitlements_managed_tenant_limit_override_value' => 'entitlements_managed_tenant_limit_override_reason',
        'entitlements_review_pack_generation_override_value' => 'entitlements_review_pack_generation_override_reason',
    ];
    /**
     * Fields rendered as Filament KeyValue components (array state, not JSON string).
     *
@ -111,6 +133,14 @@ class WorkspaceSettings extends Page
     */
    public array $resolvedSettings = [];
    /**
     * @var array{
     *     plan_profile?: array{id: string, label: string, description: string, managed_tenant_limit_default: int, review_pack_generation_default: bool, is_default: bool},
     *     decisions?: array<string, array<string, mixed>>
     * }
     */
    public array $entitlementSummary = [];
    /**
     * Per-domain "last modified" metadata: domain => {user_name, updated_at}.
     *
@ -125,17 +155,22 @@ protected function getHeaderActions(): array
    {
        return [
            Action::make('save')
-                ->label('Save')
+                ->label(__('localization.workspace.save'))
                ->action(function (): void {
                    $this->save();
                })
                ->disabled(fn (): bool => ! $this->currentUserCanManage())
                ->tooltip(fn (): ?string => $this->currentUserCanManage()
                    ? null
-                    : 'You do not have permission to manage workspace settings.'),
+                    : __('localization.workspace.no_manage_permission')),
        ];
    }
    public function getTitle(): string
    {
        return __('localization.workspace.title');
    }
    public static function actionSurfaceDeclaration(): ActionSurfaceDeclaration
    {
        return ActionSurfaceDeclaration::forPage(ActionSurfaceProfile::ListOnlyReadOnly)
@ -180,6 +215,83 @@ public function content(Schema $schema): Schema
        return $schema
            ->statePath('data')
            ->schema([
                Section::make(__('localization.workspace.section'))
                    ->description($this->sectionDescription('localization', __('localization.workspace.section_description')))
                    ->schema([
                        Select::make('localization_default_locale')
                            ->label(__('localization.workspace.default_locale_label'))
                            ->options(LocaleResolver::localeOptions())
                            ->placeholder(__('localization.workspace.default_locale_placeholder'))
                            ->native(false)
                            ->disabled(fn (): bool => ! $this->currentUserCanManage())
                            ->helperText(fn (): string => $this->localeDefaultHelperText())
                            ->hintAction($this->makeResetAction('localization_default_locale')),
                    ]),
                Section::make('Workspace entitlements')
                    ->description($this->sectionDescription('entitlements', 'Select a plan profile and optional first-slice overrides for onboarding activation and review pack generation.'))
                    ->columns(2)
                    ->schema([
                        Select::make('entitlements_plan_profile')
                            ->label('Plan profile')
                            ->options(app(WorkspacePlanProfileCatalog::class)->optionLabels())
                            ->placeholder(sprintf('Use default profile (%s)', app(WorkspacePlanProfileCatalog::class)->default()['label']))
                            ->native(false)
                            ->columnSpanFull()
                            ->disabled(fn (): bool => ! $this->currentUserCanManage())
                            ->helperText(fn (): string => $this->planProfileFieldHelperText()),
                        TextInput::make('entitlements_managed_tenant_limit_override_value')
                            ->label('Managed tenant activation limit override')
                            ->placeholder('Unset (uses plan profile default)')
                            ->suffix('tenants')
                            ->hint('0 or greater')
                            ->numeric()
                            ->integer()
                            ->minValue(0)
                            ->disabled(fn (): bool => ! $this->currentUserCanManage())
                            ->helperText(fn (): string => $this->managedTenantLimitHelperText())
                            ->hintAction($this->makeResetAction('entitlements_managed_tenant_limit_override_value')),
                        Textarea::make('entitlements_managed_tenant_limit_override_reason')
                            ->label('Managed tenant activation override reason')
                            ->rows(3)
                            ->maxLength(500)
                            ->disabled(fn (): bool => ! $this->currentUserCanManage())
                            ->helperText(fn (): string => $this->managedTenantLimitReasonHelperText()),
                        Select::make('entitlements_review_pack_generation_override_value')
                            ->label('Review pack generation override')
                            ->options(self::booleanOptions())
                            ->placeholder('Unset (uses plan profile default)')
                            ->native(false)
                            ->disabled(fn (): bool => ! $this->currentUserCanManage())
                            ->helperText(fn (): string => $this->reviewPackGenerationHelperText())
                            ->hintAction($this->makeResetAction('entitlements_review_pack_generation_override_value')),
                        Textarea::make('entitlements_review_pack_generation_override_reason')
                            ->label('Review pack generation override reason')
                            ->rows(3)
                            ->maxLength(500)
                            ->disabled(fn (): bool => ! $this->currentUserCanManage())
                            ->helperText(fn (): string => $this->reviewPackGenerationReasonHelperText()),
                    ]),
                Section::make('Workspace AI policy')
                    ->description($this->sectionDescription('ai', 'Control whether the workspace disables AI entirely or allows approved internal-only drafts on private-only infrastructure.'))
                    ->schema([
                        Select::make('ai_policy_mode')
                            ->label('AI posture')
                            ->options(AiPolicyMode::optionLabels())
                            ->placeholder('Unset (uses default)')
                            ->native(false)
                            ->disabled(fn (): bool => ! $this->currentUserCanManage())
                            ->helperText(fn (): string => $this->aiPolicyModeHelperText())
                            ->hintAction($this->makeResetAction('ai_policy_mode')),
                        Placeholder::make('ai_approved_use_cases')
                            ->label('Approved use cases')
                            ->content(fn (): string => $this->aiApprovedUseCasesText()),
                        Placeholder::make('ai_allowed_provider_classes')
                            ->label('Allowed provider classes')
                            ->content(fn (): string => $this->aiAllowedProviderClassesText()),
                        Placeholder::make('ai_blocked_data_classifications')
                            ->label('Blocked data classifications')
                            ->content(fn (): string => $this->aiBlockedDataClassificationsText()),
                    ]),
                Section::make('Backup settings')
                    ->description($this->sectionDescription('backup', 'Workspace defaults used when a schedule has no explicit value.'))
                    ->schema([
@ -414,7 +526,7 @@ public function save(): void
        $this->loadFormState();
        Notification::make()
-            ->title($changedSettingsCount > 0 ? 'Workspace settings saved' : 'No settings changes to save')
+            ->title($changedSettingsCount > 0 ? __('localization.notifications.workspace_settings_saved') : __('localization.notifications.workspace_settings_unchanged'))
            ->success()
            ->send();
    }
@ -433,7 +545,7 @@ public function resetSetting(string $field): void
        if ($this->workspaceOverrideForField($field) === null) {
            Notification::make()
-                ->title('Setting already uses default')
+                ->title(__('localization.notifications.setting_already_default'))
                ->success()
                ->send();
@ -450,7 +562,57 @@ public function resetSetting(string $field): void
        $this->loadFormState();
        Notification::make()
-            ->title('Workspace setting reset to default')
+            ->title(__('localization.notifications.workspace_setting_reset'))
            ->success()
            ->send();
    }
    private function resetEntitlementOverridePair(string $field): void
    {
        $user = auth()->user();
        if (! $user instanceof User) {
            abort(403);
        }
        $this->authorizeWorkspaceManage($user);
        if (! $this->hasEntitlementOverridePair($field)) {
            Notification::make()
                ->title('Entitlement already uses plan profile default')
                ->success()
                ->send();
            return;
        }
        $writer = app(SettingsWriter::class);
        $valueSetting = $this->settingForField($field);
        $reasonField = self::ENTITLEMENT_OVERRIDE_REASON_FIELDS[$field];
        $reasonSetting = $this->settingForField($reasonField);
        if ($this->workspaceOverrideForField($field) !== null) {
            $writer->resetWorkspaceSetting(
                actor: $user,
                workspace: $this->workspace,
                domain: $valueSetting['domain'],
                key: $valueSetting['key'],
            );
        }
        if ($this->workspaceOverrideForField($reasonField) !== null) {
            $writer->resetWorkspaceSetting(
                actor: $user,
                workspace: $this->workspace,
                domain: $reasonSetting['domain'],
                key: $reasonSetting['key'],
            );
        }
        $this->loadFormState();
        Notification::make()
            ->title('Workspace entitlement override reset')
            ->success()
            ->send();
    }
@ -490,6 +652,7 @@ private function loadFormState(): void
        $this->data = $data;
        $this->workspaceOverrides = $workspaceOverrides;
        $this->resolvedSettings = $resolvedSettings;
        $this->entitlementSummary = app(WorkspaceEntitlementResolver::class)->summary($this->workspace);
        $this->loadDomainLastModified();
    }
@ -548,37 +711,240 @@ private function sectionDescription(string $domain, string $baseDescription): st
        /** @var Carbon $updatedAt */
        $updatedAt = $meta['updated_at'];
-        return sprintf(
+        return __('localization.workspace.last_modified_by', [
-            '%s — Last modified by %s, %s.',
+            'description' => $baseDescription,
-            $baseDescription,
+            'user' => $meta['user_name'],
-            $meta['user_name'],
+            'time' => $updatedAt->diffForHumans(),
-            $updatedAt->diffForHumans(),
+        ]);
        );
    }
    private function makeResetAction(string $field): Action
    {
        return Action::make('reset_'.$field)
-            ->label('Reset')
+            ->label(__('localization.workspace.reset'))
            ->color('danger')
            ->requiresConfirmation()
            ->action(function () use ($field): void {
-                $this->resetSetting($field);
+                if ($this->isEntitlementOverrideValueField($field)) {
-            })
+                    $this->resetEntitlementOverridePair($field);
-            ->disabled(fn (): bool => ! $this->currentUserCanManage() || ! $this->hasWorkspaceOverride($field))
+
-            ->tooltip(function () use ($field): ?string {
+                    return;
                if (! $this->currentUserCanManage()) {
                    return 'You do not have permission to manage workspace settings.';
                }
-                if (! $this->hasWorkspaceOverride($field)) {
+                $this->resetSetting($field);
-                    return 'No workspace override to reset.';
+            })
            ->disabled(fn (): bool => ! $this->currentUserCanManage() || ! $this->canResetField($field))
            ->tooltip(function () use ($field): ?string {
                if (! $this->currentUserCanManage()) {
                    return __('localization.workspace.no_manage_permission');
                }
                if (! $this->canResetField($field)) {
                    if ($this->isEntitlementOverrideValueField($field)) {
                        return __('localization.workspace.no_workspace_override');
                    }
                    return __('localization.workspace.no_workspace_override');
                }
                return null;
            });
    }
    private function canResetField(string $field): bool
    {
        if ($this->isEntitlementOverrideValueField($field)) {
            return $this->hasEntitlementOverridePair($field);
        }
        return $this->hasWorkspaceOverride($field);
    }
    private function isEntitlementOverrideValueField(string $field): bool
    {
        return array_key_exists($field, self::ENTITLEMENT_OVERRIDE_REASON_FIELDS);
    }
    private function hasEntitlementOverridePair(string $field): bool
    {
        if (! $this->isEntitlementOverrideValueField($field)) {
            return false;
        }
        $reasonField = self::ENTITLEMENT_OVERRIDE_REASON_FIELDS[$field];
        return $this->workspaceOverrideForField($field) !== null
            || $this->workspaceOverrideForField($reasonField) !== null;
    }
    private function planProfileFieldHelperText(): string
    {
        $profile = $this->resolvedPlanProfile();
        $selectedProfile = $this->workspaceOverrideForField('entitlements_plan_profile');
        if (! is_string($selectedProfile) || $selectedProfile === '') {
            return sprintf('Default profile: %s. %s', $profile['label'], $profile['description']);
        }
        return sprintf('Effective profile: %s. %s', $profile['label'], $profile['description']);
    }
    private function managedTenantLimitHelperText(): string
    {
        $decision = $this->entitlementDecision(WorkspaceEntitlementResolver::KEY_MANAGED_TENANT_ACTIVATION_LIMIT);
        $effectiveValue = (int) ($decision['effective_value'] ?? 0);
        $currentUsage = (int) ($decision['current_usage'] ?? 0);
        $remainingCapacity = (int) ($decision['remaining_capacity'] ?? 0);
        $capacityText = $remainingCapacity < 0
            ? sprintf('Over limit by %d.', abs($remainingCapacity))
            : sprintf('%d remaining.', $remainingCapacity);
        return sprintf(
            'Effective limit: %d active managed tenants. Current usage: %d. %s Source: %s.',
            $effectiveValue,
            $currentUsage,
            $capacityText,
            $this->entitlementSourceLabel($decision),
        );
    }
    private function managedTenantLimitReasonHelperText(): string
    {
        return $this->entitlementReasonHelperText(
            valueField: 'entitlements_managed_tenant_limit_override_value',
            key: WorkspaceEntitlementResolver::KEY_MANAGED_TENANT_ACTIVATION_LIMIT,
        );
    }
    private function reviewPackGenerationHelperText(): string
    {
        $decision = $this->entitlementDecision(WorkspaceEntitlementResolver::KEY_REVIEW_PACK_GENERATION_ENABLED);
        return sprintf(
            'Effective state: %s. Source: %s.',
            (bool) ($decision['effective_value'] ?? false) ? 'enabled' : 'disabled',
            $this->entitlementSourceLabel($decision),
        );
    }
    private function reviewPackGenerationReasonHelperText(): string
    {
        return $this->entitlementReasonHelperText(
            valueField: 'entitlements_review_pack_generation_override_value',
            key: WorkspaceEntitlementResolver::KEY_REVIEW_PACK_GENERATION_ENABLED,
        );
    }
    private function aiPolicyModeHelperText(): string
    {
        $resolved = $this->resolvedSettings['ai_policy_mode'] ?? null;
        if (! is_array($resolved)) {
            return '';
        }
        $mode = AiPolicyMode::tryFrom((string) ($resolved['value'] ?? AiPolicyMode::Disabled->value))
            ?? AiPolicyMode::Disabled;
        $prefix = ! $this->hasWorkspaceOverride('ai_policy_mode')
            ? sprintf('Effective posture: %s. Source: %s.', $mode->label(), $this->sourceLabel((string) ($resolved['source'] ?? 'system_default')))
            : sprintf('Effective posture: %s.', $mode->label());
        return sprintf('%s %s', $prefix, $mode->summary());
    }
    private function aiApprovedUseCasesText(): string
    {
        return implode('; ', app(AiUseCaseCatalog::class)->labels()).'.';
    }
    private function aiAllowedProviderClassesText(): string
    {
        $labels = app(AiUseCaseCatalog::class)->allowedProviderClassLabelsForMode($this->effectiveAiPolicyMode());
        if ($labels === []) {
            return 'No provider classes are allowed while AI is disabled.';
        }
        return implode(', ', $labels).'.';
    }
    private function aiBlockedDataClassificationsText(): string
    {
        return implode(', ', app(AiUseCaseCatalog::class)->blockedDataClassificationLabels()).'.';
    }
    private function effectiveAiPolicyMode(): AiPolicyMode
    {
        $resolved = $this->resolvedSettings['ai_policy_mode'] ?? null;
        if (! is_array($resolved)) {
            return AiPolicyMode::Disabled;
        }
        return AiPolicyMode::tryFrom((string) ($resolved['value'] ?? AiPolicyMode::Disabled->value))
            ?? AiPolicyMode::Disabled;
    }
    private function entitlementReasonHelperText(string $valueField, string $key): string
    {
        $decision = $this->entitlementDecision($key);
        $rationale = is_string($decision['rationale'] ?? null) ? $decision['rationale'] : null;
        if ($this->workspaceOverrideForField($valueField) === null) {
            return 'Required when an explicit override value is set.';
        }
        if ($rationale === null || $rationale === '') {
            return 'Required when an explicit override value is set.';
        }
        return sprintf('Current rationale: %s', $rationale);
    }
    /**
     * @return array{id: string, label: string, description: string, managed_tenant_limit_default: int, review_pack_generation_default: bool, is_default: bool}
     */
    private function resolvedPlanProfile(): array
    {
        $profile = $this->entitlementSummary['plan_profile'] ?? null;
        if (is_array($profile)) {
            return $profile;
        }
        return app(WorkspacePlanProfileCatalog::class)->default();
    }
    /**
     * @return array<string, mixed>
     */
    private function entitlementDecision(string $key): array
    {
        $decision = $this->entitlementSummary['decisions'][$key] ?? null;
        return is_array($decision) ? $decision : [];
    }
    /**
     * @param  array<string, mixed>  $decision
     */
    private function entitlementSourceLabel(array $decision): string
    {
        if (($decision['source'] ?? null) === 'workspace_override') {
            return 'workspace override';
        }
        $planProfileLabel = $decision['plan_profile_label'] ?? null;
        if (is_string($planProfileLabel) && $planProfileLabel !== '') {
            return sprintf('%s plan profile', $planProfileLabel);
        }
        return 'plan profile default';
    }
    private function helperTextFor(string $field): string
    {
        $resolved = $this->resolvedSettings[$field] ?? null;
@ -600,6 +966,29 @@ private function helperTextFor(string $field): string
        return sprintf('Effective value: %s.', $effectiveValue);
    }
    private function localeDefaultHelperText(): string
    {
        $resolved = $this->resolvedSettings['localization_default_locale'] ?? null;
        if (! is_array($resolved)) {
            return '';
        }
        $effectiveLocale = LocaleResolver::normalize($resolved['value'] ?? null) ?? 'en';
        $localeLabel = LocaleResolver::localeOptions()[$effectiveLocale] ?? strtoupper($effectiveLocale);
        if (! $this->hasWorkspaceOverride('localization_default_locale')) {
            return __('localization.workspace.default_locale_helper_unset', [
                'locale' => $localeLabel,
                'source' => $this->sourceLabel((string) ($resolved['source'] ?? 'system_default')),
            ]);
        }
        return __('localization.workspace.default_locale_helper_set', [
            'locale' => $localeLabel,
        ]);
    }
    private function slaFieldHelperText(string $severity): string
    {
        $resolved = $this->resolvedSettings['findings_sla_days'] ?? null;
@ -721,6 +1110,27 @@ private function normalizedInputValues(): array
            }
        }
        foreach (self::ENTITLEMENT_OVERRIDE_REASON_FIELDS as $valueField => $reasonField) {
            if (($normalizedValues[$valueField] ?? null) === null) {
                $normalizedValues[$reasonField] = null;
                continue;
            }
            if (($normalizedValues[$reasonField] ?? null) !== null) {
                continue;
            }
            $message = match ($valueField) {
                'entitlements_managed_tenant_limit_override_value' => 'Override reason is required when a managed tenant activation limit override is set.',
                'entitlements_review_pack_generation_override_value' => 'Override reason is required when a review pack generation override is set.',
                default => 'Override reason is required when an explicit override is set.',
            };
            $validationErrors['data.'.$reasonField] ??= [];
            $validationErrors['data.'.$reasonField][] = $message;
        }
        return [$normalizedValues, $validationErrors];
    }
@ -984,9 +1394,9 @@ private function formatValueForDisplay(string $field, mixed $value): string
    private function sourceLabel(string $source): string
    {
        return match ($source) {
-            'workspace_override' => 'workspace override',
+            'workspace_override' => __('localization.source.workspace_override'),
            'tenant_override' => 'tenant override',
-            default => 'system default',
+            default => __('localization.source.system_default'),
        };
    }
--- a/apps/platform/app/Filament/Pages/TenantDashboard.php
+++ b/apps/platform/app/Filament/Pages/TenantDashboard.php
@ -11,15 +11,24 @@
 use App\Filament\Widgets\Dashboard\RecentDriftFindings;
 use App\Filament\Widgets\Dashboard\RecentOperations;
 use App\Filament\Widgets\Dashboard\RecoveryReadiness;
 use App\Models\SupportRequest;
 use App\Models\Tenant;
 use App\Models\User;
 use App\Services\Audit\WorkspaceAuditLogger;
 use App\Services\Auth\CapabilityResolver;
 use App\Support\Auth\Capabilities;
 use App\Support\ProductTelemetry\ProductTelemetryRecorder;
 use App\Support\ProductTelemetry\ProductUsageEventCatalog;
 use App\Support\Rbac\UiEnforcement;
 use App\Support\SupportDiagnostics\SupportDiagnosticBundleBuilder;
 use App\Support\SupportRequests\SupportRequestSubmissionService;
 use Filament\Actions\Action;
 use Filament\Facades\Filament;
 use Filament\Forms\Components\Placeholder;
 use Filament\Forms\Components\Select;
 use Filament\Forms\Components\TextInput;
 use Filament\Forms\Components\Textarea;
 use Filament\Notifications\Notification;
 use Filament\Pages\Dashboard;
 use Filament\Widgets\Widget;
 use Filament\Widgets\WidgetConfiguration;
@ -33,6 +42,11 @@ class TenantDashboard extends Dashboard
     */
    public array $supportDiagnosticsAuditKeys = [];
    public function getTitle(): string
    {
        return __('localization.dashboard.tenant_title');
    }
    /**
     * @param  array<mixed>  $parameters
     */
@ -68,23 +82,85 @@ public function getColumns(): int|array
    protected function getHeaderActions(): array
    {
        return [
            $this->requestSupportAction(),
            $this->openSupportDiagnosticsAction(),
        ];
    }
    public function authorizeTenantSupportRequest(): void
    {
        $this->resolveCurrentTenantForCapability(Capabilities::SUPPORT_REQUESTS_CREATE);
    }
    private function requestSupportAction(): Action
    {
        $action = Action::make('requestSupport')
            ->label(__('localization.dashboard.request_support'))
            ->icon('heroicon-o-paper-airplane')
            ->color('gray')
            ->slideOver()
            ->stickyModalHeader()
            ->modalHeading(__('localization.dashboard.support_request_heading'))
            ->modalDescription(__('localization.dashboard.support_request_description'))
            ->modalSubmitActionLabel(__('localization.dashboard.submit_request'))
            ->form([
                Placeholder::make('included_context')
                    ->label(__('localization.dashboard.included_context'))
                    ->content(fn (): string => $this->tenantSupportRequestAttachmentSummary())
                    ->columnSpanFull(),
                Select::make('severity')
                    ->label(__('localization.dashboard.severity'))
                    ->options(SupportRequest::severityOptions())
                    ->default(SupportRequest::SEVERITY_NORMAL)
                    ->required()
                    ->native(false),
                TextInput::make('summary')
                    ->label(__('localization.dashboard.summary'))
                    ->required()
                    ->columnSpanFull(),
                Textarea::make('reproduction_notes')
                    ->label(__('localization.dashboard.reproduction_notes'))
                    ->rows(4)
                    ->columnSpanFull(),
                TextInput::make('contact_name')
                    ->label(__('localization.dashboard.contact_name'))
                    ->default(fn (): ?string => $this->resolveDashboardActor()->name),
                TextInput::make('contact_email')
                    ->label(__('localization.dashboard.contact_email'))
                    ->email()
                    ->default(fn (): ?string => $this->resolveDashboardActor()->email),
            ])
            ->action(function (array $data): void {
                $actor = $this->resolveDashboardActor();
                $tenant = $this->resolveCurrentTenantForCapability(Capabilities::SUPPORT_REQUESTS_CREATE);
                $supportRequest = app(SupportRequestSubmissionService::class)->submitForTenant($tenant, $actor, $data);
                Notification::make()
                    ->title(__('localization.dashboard.support_request_submitted'))
                    ->body('Reference '.$supportRequest->internal_reference)
                    ->success()
                    ->send();
            });
        return UiEnforcement::forAction($action)
            ->requireCapability(Capabilities::SUPPORT_REQUESTS_CREATE)
            ->apply();
    }
    private function openSupportDiagnosticsAction(): Action
    {
        $action = Action::make('openSupportDiagnostics')
-            ->label('Open support diagnostics')
+            ->label(__('localization.dashboard.open_support_diagnostics'))
            ->icon('heroicon-o-lifebuoy')
            ->color('gray')
            ->modal()
            ->slideOver()
            ->stickyModalHeader()
-            ->modalHeading('Support diagnostics')
+            ->modalHeading(__('localization.dashboard.support_diagnostics'))
-            ->modalDescription('Redacted tenant context from existing records.')
+            ->modalDescription(__('localization.dashboard.support_diagnostics_description'))
            ->modalSubmitAction(false)
-            ->modalCancelAction(fn (Action $action): Action => $action->label('Close'))
+            ->modalCancelAction(fn (Action $action): Action => $action->label(__('localization.dashboard.close')))
            ->mountUsing(function (): void {
                $this->auditTenantSupportDiagnosticsOpen();
            })
@ -102,34 +178,16 @@ private function openSupportDiagnosticsAction(): Action
     */
    public function tenantSupportDiagnosticBundle(): array
    {
-        $user = auth()->user();
+        $user = $this->resolveDashboardActor();
-        $tenant = Filament::getTenant();
+        $tenant = $this->resolveCurrentTenantForCapability(Capabilities::SUPPORT_DIAGNOSTICS_VIEW);
        if (! $user instanceof User || ! $tenant instanceof Tenant) {
            abort(404);
        }
        $resolver = app(CapabilityResolver::class);
        if (! $resolver->isMember($user, $tenant)) {
            abort(404);
        }
        if (! $resolver->can($user, $tenant, Capabilities::SUPPORT_DIAGNOSTICS_VIEW)) {
            abort(403);
        }
        return app(SupportDiagnosticBundleBuilder::class)->forTenant($tenant, $user);
    }
    private function auditTenantSupportDiagnosticsOpen(): void
    {
-        $user = auth()->user();
+        $user = $this->resolveDashboardActor();
-        $tenant = Filament::getTenant();
+        $tenant = $this->resolveCurrentTenantForCapability(Capabilities::SUPPORT_DIAGNOSTICS_VIEW);
        if (! $user instanceof User || ! $tenant instanceof Tenant) {
            abort(404);
        }
        $this->recordSupportDiagnosticsOpened(
            tenant: $tenant,
@ -156,6 +214,71 @@ private function recordSupportDiagnosticsOpened(Tenant $tenant, array $bundle, U
            actor: $user,
        );
        app(ProductTelemetryRecorder::class)->record(
            eventName: ProductUsageEventCatalog::SUPPORT_DIAGNOSTICS_OPENED,
            workspaceId: (int) $tenant->workspace_id,
            tenantId: (int) $tenant->getKey(),
            userId: (int) $user->getKey(),
            subjectType: 'tenant',
            subjectId: (int) $tenant->getKey(),
            metadata: [
                'source_surface' => 'tenant_dashboard',
            ],
        );
        $this->supportDiagnosticsAuditKeys[] = $auditKey;
    }
    private function resolveDashboardActor(): User
    {
        $user = auth()->user();
        if (! $user instanceof User) {
            abort(404);
        }
        return $user;
    }
    private function resolveCurrentTenantForCapability(string $capability): Tenant
    {
        $user = $this->resolveDashboardActor();
        $tenant = Filament::getTenant();
        if (! $tenant instanceof Tenant) {
            abort(404);
        }
        $resolver = app(CapabilityResolver::class);
        if (! $resolver->isMember($user, $tenant)) {
            abort(404);
        }
        if (! $resolver->can($user, $tenant, $capability)) {
            abort(403);
        }
        return $tenant;
    }
    private function tenantSupportRequestAttachmentSummary(): string
    {
        $tenant = Filament::getTenant();
        $user = auth()->user();
        if (! $tenant instanceof Tenant || ! $user instanceof User) {
            return 'Only canonical redacted tenant context will be attached.';
        }
        $resolver = app(CapabilityResolver::class);
        if (! $resolver->isMember($user, $tenant)) {
            return 'Only canonical redacted tenant context will be attached.';
        }
        return $resolver->can($user, $tenant, Capabilities::SUPPORT_DIAGNOSTICS_VIEW)
            ? 'A redacted diagnostic snapshot and the canonical tenant context will be attached.'
            : 'Only the canonical redacted tenant context will be attached because you cannot view support diagnostics.';
    }
 }
--- a/apps/platform/app/Filament/Pages/Workspaces/ManagedTenantOnboardingWizard.php
+++ b/apps/platform/app/Filament/Pages/Workspaces/ManagedTenantOnboardingWizard.php
@ -4,6 +4,7 @@
 namespace App\Filament\Pages\Workspaces;
 use BackedEnum;
 use App\Exceptions\Onboarding\OnboardingDraftConflictException;
 use App\Exceptions\Onboarding\OnboardingDraftImmutableException;
 use App\Filament\Pages\TenantDashboard;
@ -29,6 +30,8 @@
 use App\Services\Onboarding\OnboardingDraftResolver;
 use App\Services\Onboarding\OnboardingDraftStageResolver;
 use App\Services\Onboarding\OnboardingLifecycleService;
 use App\Services\Entitlements\WorkspaceCommercialLifecycleResolver;
 use App\Services\Entitlements\WorkspaceEntitlementResolver;
 use App\Services\OperationRunService;
 use App\Services\Providers\ProviderConnectionMutationService;
 use App\Services\Providers\ProviderOperationRegistry;
@ -51,6 +54,7 @@
 use App\Support\OpsUx\OperationUxPresenter;
 use App\Support\OpsUx\ProviderOperationStartResultPresenter;
 use App\Support\OpsUx\OpsUxBrowserEvents;
 use App\Support\ProductKnowledge\ContextualHelpResolver;
 use App\Support\Providers\ProviderConnectionType;
 use App\Support\Providers\ProviderConsentStatus;
 use App\Support\Providers\ProviderReasonCodes;
@ -660,7 +664,16 @@ public function content(Schema $schema): Schema
                                            Text::make(fn (): string => $this->completionSummaryBootstrapSummary())
                                                ->badge()
                                                ->color(fn (): string => $this->completionSummaryBootstrapColor()),
                                            Text::make('Activation entitlement')
                                                ->color('gray'),
                                            Text::make(fn (): string => $this->completionSummaryEntitlementSummary())
                                                ->badge()
                                                ->color(fn (): string => $this->completionSummaryEntitlementColor()),
                                        ]),
                                    Callout::make('Activation entitlement')
                                        ->description(fn (): string => $this->completionSummaryEntitlementDetail())
                                        ->warning()
                                        ->visible(fn (): bool => $this->completionSummaryEntitlementBlocked()),
                                    Callout::make('Bootstrap needs attention')
                                        ->description(fn (): string => $this->completionSummaryBootstrapRecoveryMessage())
                                        ->warning()
@ -698,9 +711,7 @@ public function content(Schema $schema): Schema
                                            ->modalSubmitActionLabel('Yes, complete onboarding')
                                            ->disabled(fn (): bool => ! $this->canCompleteOnboarding()
                                                || ! $this->currentUserCan(Capabilities::WORKSPACE_MANAGED_TENANT_ONBOARD_ACTIVATE))
-                                            ->tooltip(fn (): ?string => $this->currentUserCan(Capabilities::WORKSPACE_MANAGED_TENANT_ONBOARD_ACTIVATE)
+                                            ->tooltip(fn (): ?string => $this->completionActionTooltip())
                                                ? null
                                                : 'Owner required to complete onboarding.')
                                            ->action(fn () => $this->completeOnboarding()),
                                    ]),
                                ]),
@ -994,6 +1005,7 @@ private function routeBoundReadinessSchema(): array
        }
        $payload = $this->onboardingReadinessPayload($draft);
        $primaryNextAction = $this->readinessPrimaryNextActionComponent($payload, 'route_bound_readiness');
        $schema = [
            Section::make('Onboarding readiness')
@ -1001,7 +1013,7 @@ private function routeBoundReadinessSchema(): array
                ->compact()
                ->columns(2)
                ->schema([
-                    Text::make('Current checkpoint')
+                    Text::make('Step')
                        ->color('gray'),
                    Text::make($payload['checkpoint']['current_checkpoint_label'] ?? '—')
                        ->badge()
@ -1021,9 +1033,7 @@ private function routeBoundReadinessSchema(): array
                    Text::make($payload['freshness']['note']),
                    Text::make('Primary next action')
                        ->color('gray'),
-                    Text::make($payload['next_action']['label'])
+                    $primaryNextAction,
                        ->badge()
                        ->color($this->readinessNextActionColor($payload['next_action']['kind'])),
                ]),
        ];
@ -1064,8 +1074,14 @@ private function draftCompactReadinessSchema(TenantOnboardingSession $draft): ar
    private function readinessSupportingEvidenceSchema(array $payload, string $keyPrefix): array
    {
        $links = is_array($payload['supporting_links'] ?? null) ? $payload['supporting_links'] : [];
        $assist = is_array($payload['verification_assist'] ?? null) ? $payload['verification_assist'] : [];
        $showAssist = (bool) ($assist['is_visible'] ?? false);
        $permissions = is_array($payload['permissions'] ?? null) ? $payload['permissions'] : [];
        $requiredPermissionsUrl = is_string($permissions['required_permissions_url'] ?? null)
            ? $permissions['required_permissions_url']
            : null;
-        if ($links === []) {
+        if ($links === [] && ! ($showAssist && $requiredPermissionsUrl !== null && $requiredPermissionsUrl !== '')) {
            return [];
        }
@ -1089,13 +1105,20 @@ private function readinessSupportingEvidenceSchema(array $payload, string $keyPr
                ->url($url);
        }
        if ($showAssist && $requiredPermissionsUrl !== null && $requiredPermissionsUrl !== '') {
            $actions[] = Action::make($keyPrefix.'_required_permissions_assist')
                ->label('View required permissions')
                ->color('gray')
            ->url($requiredPermissionsUrl);
        }
        if ($actions === []) {
            return [];
        }
        return [
            Section::make('Supporting evidence')
-                ->description('Open canonical operation detail when deeper diagnostics are needed.')
+                ->description('Open canonical operation detail or secondary permission evidence when deeper diagnostics are needed.')
                ->compact()
                ->schema([
                    SchemaActions::make($actions)->key($keyPrefix.'_supporting_evidence_actions'),
@ -1115,14 +1138,16 @@ private function readinessPermissionDiagnosticsSchema(array $payload, string $ke
            return [];
        }
        if ((bool) ($payload['verification']['has_report'] ?? false)) {
            return [];
        }
        $counts = is_array($permissions['counts'] ?? null) ? $permissions['counts'] : [];
        $missingApplication = (int) ($counts['missing_application'] ?? 0);
        $missingDelegated = (int) ($counts['missing_delegated'] ?? 0);
        $errors = (int) ($counts['error'] ?? 0);
        $assist = is_array($payload['verification_assist'] ?? null) ? $payload['verification_assist'] : [];
        $isVisible = (bool) ($assist['is_visible'] ?? false);
-        if ($missingApplication + $missingDelegated + $errors === 0 && ! $isVisible) {
+        if ($missingApplication + $missingDelegated + $errors === 0) {
            return [];
        }
@ -1177,7 +1202,7 @@ private function readinessPermissionDiagnosticsSchema(array $payload, string $ke
     *     draft: array{id: int, tenant_name: string, stage_label: string, draft_status_label: string, started_by: string, updated_by: string, last_updated_human: string},
     *     checkpoint: array{current_checkpoint: string|null, current_checkpoint_label: string|null, last_completed_checkpoint: string|null, lifecycle_state: string, lifecycle_label: string},
     *     provider_summary: array<string, mixed>|null,
-     *     verification: array{status: string, status_label: string, run_id: int|null, run_url: string|null, is_active: bool, matches_selected_connection: bool|null, overall: string|null},
+    *     verification: array{status: string, status_label: string, run_id: int|null, run_url: string|null, is_active: bool, has_report: bool, matches_selected_connection: bool|null, overall: string|null},
     *     verification_assist: array{is_visible: bool, reason: string},
     *     permissions: array{overall: string|null, counts: array<string, int>, freshness: array{last_refreshed_at: string|null, is_stale: bool}, missing_permissions: array{application: list<string>, delegated: list<string>}, required_permissions_url: string|null}|null,
     *     freshness: array{connection_recently_updated: bool, verification_mismatch: bool, permission_last_refreshed_at: string|null, permission_data_is_stale: bool, note: string},
@ -1218,6 +1243,9 @@ private function onboardingReadinessPayload(TenantOnboardingSession $draft): arr
        $permissions = $tenant instanceof Tenant ? $this->readinessPermissionOverview($tenant) : null;
        $verificationReport = $verificationRun instanceof OperationRun ? VerificationReportViewer::report($verificationRun) : null;
        $verificationReport = is_array($verificationReport) ? $verificationReport : null;
        $verificationPrimaryReasonCode = $verificationReport !== null
            ? app(ContextualHelpResolver::class)->primaryReasonCodeFromVerificationReport($verificationReport)
            : null;
        $permissionFreshness = is_array($permissions['freshness'] ?? null) ? $permissions['freshness'] : [
            'last_refreshed_at' => null,
            'is_stale' => true,
@ -1237,6 +1265,9 @@ private function onboardingReadinessPayload(TenantOnboardingSession $draft): arr
            verificationMismatch: $verificationMismatch,
        );
        $reasonCode = is_string($snapshot['reason_code'] ?? null) ? $snapshot['reason_code'] : null;
        $blockingReasonCode = is_string($snapshot['blocking_reason_code'] ?? null) ? $snapshot['blocking_reason_code'] : null;
        return [
            'draft' => [
                'id' => (int) $draft->getKey(),
@ -1263,6 +1294,7 @@ private function onboardingReadinessPayload(TenantOnboardingSession $draft): arr
                    ? OperationRunLinks::tenantlessView($verificationRun)
                    : null,
                'is_active' => $verificationRun instanceof OperationRun && $verificationRun->status !== OperationRunStatus::Completed->value,
                'has_report' => $verificationReport !== null,
                'matches_selected_connection' => $verificationMatchesSelectedConnection,
                'overall' => $verificationRun instanceof OperationRun
                    ? $this->readinessVerificationOverall($verificationRun, $verificationReport)
@ -1286,8 +1318,8 @@ private function onboardingReadinessPayload(TenantOnboardingSession $draft): arr
                ),
            ],
            'blocker' => [
-                'reason_code' => is_string($snapshot['reason_code'] ?? null) ? $snapshot['reason_code'] : null,
+                'reason_code' => $reasonCode,
-                'blocking_reason_code' => is_string($snapshot['blocking_reason_code'] ?? null) ? $snapshot['blocking_reason_code'] : null,
+                'blocking_reason_code' => $blockingReasonCode,
                'operator_summary' => $readinessSummary,
            ],
            'next_action' => $this->readinessNextAction(
@ -1297,6 +1329,7 @@ private function onboardingReadinessPayload(TenantOnboardingSession $draft): arr
                verificationRun: $verificationRun,
                verificationStatus: $verificationStatus,
                permissions: $permissions,
                blockerReasonCode: $verificationPrimaryReasonCode ?? $blockingReasonCode ?? $reasonCode,
                connectionRecentlyUpdated: $connectionRecentlyUpdated,
                verificationMismatch: $verificationMismatch,
                supportingLinks: $supportingLinks,
@ -1374,6 +1407,35 @@ private function readinessNextActionColor(string $kind): string
        };
    }
    /**
     * @param  array<string, mixed>  $payload
     */
    private function readinessPrimaryNextActionComponent(array $payload, string $keyPrefix): \Filament\Schemas\Components\Component
    {
        $nextAction = is_array($payload['next_action'] ?? null) ? $payload['next_action'] : [];
        $label = is_string($nextAction['label'] ?? null) && trim((string) $nextAction['label']) !== ''
            ? trim((string) $nextAction['label'])
            : 'Continue onboarding';
        $kind = is_string($nextAction['kind'] ?? null) ? $nextAction['kind'] : 'gray';
        $url = is_string($nextAction['url'] ?? null) && trim((string) $nextAction['url']) !== ''
            ? trim((string) $nextAction['url'])
            : null;
        if ($url !== null) {
            return SchemaActions::make([
                Action::make($keyPrefix.'_primary_next_action')
                    ->label($label)
                    ->color($this->readinessNextActionColor($kind))
                    ->url($url)
                    ->openUrlInNewTab(str_starts_with($url, 'http://') || str_starts_with($url, 'https://')),
            ])->key($keyPrefix.'_primary_next_action');
        }
        return Text::make($label)
            ->badge()
            ->color($this->readinessNextActionColor($kind));
    }
    private function readinessProviderConnection(TenantOnboardingSession $draft): ?ProviderConnection
    {
        $state = is_array($draft->state) ? $draft->state : [];
@ -1407,8 +1469,8 @@ private function readinessProviderSummary(?ProviderConnection $connection): ?arr
            return [
                'provider' => (string) $connection->provider,
                'target_scope' => [],
-                'consent_state' => (string) $connection->consent_status,
+                'consent_state' => $this->stringValue($connection->consent_status),
-                'verification_state' => (string) $connection->verification_status,
+                'verification_state' => $this->stringValue($connection->verification_status),
                'readiness_summary' => 'Target scope needs review',
                'target_scope_summary' => 'Target scope needs review',
                'contextual_identity_line' => null,
@ -1614,6 +1676,7 @@ private function readinessNextAction(
        ?OperationRun $verificationRun,
        string $verificationStatus,
        ?array $permissions,
        ?string $blockerReasonCode,
        bool $connectionRecentlyUpdated,
        bool $verificationMismatch,
        array $supportingLinks,
@ -1639,7 +1702,7 @@ private function readinessNextAction(
        if ($consentState !== ProviderConsentStatus::Granted->value) {
            return $this->readinessAction(
-                label: 'Grant consent',
+                label: 'Grant admin consent',
                kind: 'grant_consent',
                url: $draft->tenant instanceof Tenant ? RequiredPermissionsLinks::adminConsentPrimaryUrl($draft->tenant) : null,
            );
@ -1647,6 +1710,18 @@ private function readinessNextAction(
        $permissionOverall = is_string($permissions['overall'] ?? null) ? $permissions['overall'] : null;
        if (in_array($blockerReasonCode, [
            ProviderReasonCodes::ProviderConsentMissing,
            ProviderReasonCodes::ProviderConsentFailed,
            ProviderReasonCodes::ProviderConsentRevoked,
        ], true)) {
            return $this->readinessAction(
                label: 'Grant admin consent',
                kind: 'grant_consent',
                url: $draft->tenant instanceof Tenant ? RequiredPermissionsLinks::adminConsentPrimaryUrl($draft->tenant) : null,
            );
        }
        if ($permissionOverall === VerificationReportOverall::Blocked->value) {
            return $this->readinessAction(
                label: 'Review permissions',
@ -2777,6 +2852,7 @@ private function verificationReportViewData(): array
                'acknowledgements' => [],
                'surface' => [],
                'redactionNotes' => [],
                'contextualHelp' => null,
                'assistVisibility' => $assistVisibility,
                'assistActionName' => 'wizardVerificationRequiredPermissionsAssist',
                'technicalDetailsActionName' => 'wizardVerificationTechnicalDetails',
@ -2786,6 +2862,7 @@ private function verificationReportViewData(): array
        $report = VerificationReportViewer::report($run);
        $fingerprint = is_array($report) ? VerificationReportViewer::fingerprint($report) : null;
        $contextualHelp = is_array($report) ? $this->verificationContextualHelp($report, $run) : null;
        $changeIndicator = VerificationReportChangeIndicator::forRun($run);
        $previousRunUrl = $this->verificationPreviousRunUrl($changeIndicator);
@ -2872,6 +2949,7 @@ private function verificationReportViewData(): array
            'acknowledgements' => $acknowledgements,
            'surface' => $surface,
            'redactionNotes' => VerificationReportViewer::redactionNotes($report),
            'contextualHelp' => $contextualHelp,
            'assistVisibility' => $assistVisibility,
            'assistActionName' => 'wizardVerificationRequiredPermissionsAssist',
            'technicalDetailsActionName' => 'wizardVerificationTechnicalDetails',
@ -2879,6 +2957,40 @@ private function verificationReportViewData(): array
        ];
    }
    /**
     * @param  array<string, mixed>  $verificationReport
     * @return array<string, mixed>|null
     */
    private function verificationContextualHelp(array $verificationReport, OperationRun $run): ?array
    {
        $tenant = $this->managedTenant;
        if (! $tenant instanceof Tenant) {
            return null;
        }
        $resolver = app(ContextualHelpResolver::class);
        $reasonCode = $resolver->primaryReasonCodeFromVerificationReport($verificationReport);
        $topicKey = $resolver->topicKeyForOnboardingVerification(
            reasonCode: $reasonCode,
            isVerificationStale: $this->verificationRunIsStaleForSelectedConnection(),
            verificationOverall: is_string(data_get($verificationReport, 'summary.overall'))
                ? (string) data_get($verificationReport, 'summary.overall')
                : null,
            runOutcome: is_string($run->outcome) ? (string) $run->outcome : null,
        );
        if ($topicKey === null) {
            return null;
        }
        return $resolver->tryResolve($topicKey, [
            'tenant' => $tenant,
            'reason_code' => $reasonCode,
            'surface' => 'onboarding',
        ]);
    }
    public function wizardVerificationRequiredPermissionsAssistAction(): Action
    {
        return Action::make('wizardVerificationRequiredPermissionsAssist')
@ -4395,6 +4507,10 @@ private function canCompleteOnboarding(): bool
            return false;
        }
        if ($this->completionSummaryEntitlementBlocked()) {
            return false;
        }
        $user = $this->currentUser();
        if (! app(TenantOperabilityService::class)->outcomeFor(
@ -4427,6 +4543,116 @@ private function canCompleteOnboarding(): bool
        return trim((string) ($this->data['override_reason'] ?? '')) !== '';
    }
    /**
     * @return array<string, mixed>
     */
    private function completionSummaryEntitlementDecision(): array
    {
        if (! isset($this->workspace) || ! $this->workspace instanceof Workspace) {
            return [];
        }
        return app(WorkspaceCommercialLifecycleResolver::class)->actionDecision(
            $this->workspace,
            WorkspaceCommercialLifecycleResolver::ACTION_MANAGED_TENANT_ACTIVATION,
        );
    }
    private function completionSummaryEntitlementBlocked(): bool
    {
        return ($this->completionSummaryEntitlementDecision()['outcome'] ?? null) === WorkspaceCommercialLifecycleResolver::OUTCOME_BLOCK;
    }
    private function completionSummaryEntitlementSummary(): string
    {
        $decision = $this->completionSummaryEntitlementDecision();
        $entitlementDecision = is_array($decision['entitlement_decision'] ?? null) ? $decision['entitlement_decision'] : [];
        $currentUsage = (int) ($entitlementDecision['current_usage'] ?? 0);
        $effectiveValue = (int) ($entitlementDecision['effective_value'] ?? 0);
        $sourceLabel = $this->completionSummaryEntitlementSourceLabel($entitlementDecision);
        $stateLabel = is_string($decision['state_label'] ?? null) ? $decision['state_label'] : 'Active paid';
        return sprintf(
            '%s - %s - %d active of %d allowed (%s)',
            $this->completionSummaryEntitlementBlocked() ? 'Blocked' : 'Allowed',
            $stateLabel,
            $currentUsage,
            $effectiveValue,
            $sourceLabel,
        );
    }
    private function completionSummaryEntitlementDetail(): string
    {
        $decision = $this->completionSummaryEntitlementDecision();
        $entitlementDecision = is_array($decision['entitlement_decision'] ?? null) ? $decision['entitlement_decision'] : [];
        $currentUsage = (int) ($entitlementDecision['current_usage'] ?? 0);
        $effectiveValue = (int) ($entitlementDecision['effective_value'] ?? 0);
        $remainingCapacity = (int) ($entitlementDecision['remaining_capacity'] ?? 0);
        $sourceLabel = $this->completionSummaryEntitlementSourceLabel($entitlementDecision);
        $rationale = is_string($decision['rationale'] ?? null) ? $decision['rationale'] : null;
        $message = sprintf(
            '%s Current usage is %d active managed tenant%s out of %d allowed. Source: %s.',
            (string) ($decision['message'] ?? 'Managed-tenant activation is available for this workspace commercial state.'),
            $currentUsage,
            $currentUsage === 1 ? '' : 's',
            $effectiveValue,
            $sourceLabel,
        );
        if ($remainingCapacity >= 0) {
            $message .= sprintf(' Remaining capacity: %d.', $remainingCapacity);
        }
        if ($this->completionSummaryEntitlementBlocked()) {
            $blockReason = is_string($decision['block_reason'] ?? null) ? $decision['block_reason'] : null;
            if ($blockReason !== null && $blockReason !== '') {
                $message = $blockReason;
            }
        }
        if ($rationale !== null && $rationale !== '' && ($decision['source'] ?? null) === WorkspaceCommercialLifecycleResolver::SOURCE_WORKSPACE_SETTING) {
            $message .= ' Rationale: '.$rationale;
        }
        return $message;
    }
    private function completionSummaryEntitlementColor(): string
    {
        return $this->completionSummaryEntitlementBlocked() ? 'warning' : 'success';
    }
    /**
     * @param  array<string, mixed>  $decision
     */
    private function completionSummaryEntitlementSourceLabel(array $decision): string
    {
        if (($decision['source'] ?? null) === 'workspace_override') {
            return 'workspace override';
        }
        $label = $decision['plan_profile_label'] ?? null;
        return is_string($label) && $label !== ''
            ? sprintf('%s plan profile', $label)
            : 'plan profile default';
    }
    private function completionActionTooltip(): ?string
    {
        if (! $this->currentUserCan(Capabilities::WORKSPACE_MANAGED_TENANT_ONBOARD_ACTIVATE)) {
            return 'Owner required to complete onboarding.';
        }
        if ($this->completionSummaryEntitlementBlocked()) {
            return $this->completionSummaryEntitlementDetail();
        }
        return null;
    }
    private function completionSummaryTenantLine(): string
    {
        $tenant = $this->currentManagedTenantRecord();
@ -4507,6 +4733,19 @@ private function completionSummaryConnectionSummary(): string
        return sprintf('%s - %s', $label, $detail);
    }
    private function stringValue(mixed $value): string
    {
        if ($value instanceof BackedEnum) {
            return (string) $value->value;
        }
        if (is_string($value) || is_int($value) || is_float($value) || is_bool($value)) {
            return (string) $value;
        }
        return '';
    }
    private function completionSummaryVerificationDetail(): string
    {
        $counts = $this->verificationReportCounts();
@ -4747,6 +4986,16 @@ public function completeOnboarding(): void
            return;
        }
        if ($this->completionSummaryEntitlementBlocked()) {
            Notification::make()
                ->title('Activation unavailable')
                ->body($this->completionSummaryEntitlementDetail())
                ->warning()
                ->send();
            return;
        }
        $run = $this->verificationRun();
        $verificationSucceeded = $this->verificationHasSucceeded();
        $verificationCanProceed = $this->verificationCanProceed();
--- a/apps/platform/app/Filament/Resources/EvidenceSnapshotResource.php
+++ b/apps/platform/app/Filament/Resources/EvidenceSnapshotResource.php
@ -6,6 +6,7 @@
 use App\Filament\Concerns\InteractsWithTenantOwnedRecords;
 use App\Filament\Concerns\ResolvesPanelTenantContext;
 use App\Filament\Pages\Reviews\CustomerReviewWorkspace;
 use App\Filament\Resources\EvidenceSnapshotResource\Pages;
 use App\Filament\Resources\ReviewPackResource;
 use App\Models\EvidenceSnapshot;
@ -267,6 +268,20 @@ public static function relatedContextEntries(EvidenceSnapshot $record): array
            )->toArray();
        }
        if ($record->tenant instanceof Tenant) {
            $entries[] = RelatedContextEntry::available(
                key: 'customer_review_workspace',
                label: 'Customer workspace',
                value: $record->tenant->name,
                secondaryValue: 'Open the customer-safe review workspace prefiltered to this tenant.',
                targetUrl: CustomerReviewWorkspace::tenantPrefilterUrl($record->tenant),
                targetKind: 'canonical_page',
                priority: 30,
                actionLabel: 'Open customer workspace',
                contextBadge: 'Reporting',
            )->toArray();
        }
        return $entries;
    }
--- a/apps/platform/app/Filament/Resources/FindingResource.php
+++ b/apps/platform/app/Filament/Resources/FindingResource.php
@ -75,8 +75,6 @@ class FindingResource extends Resource
    protected static string|UnitEnum|null $navigationGroup = 'Governance';
    protected static ?string $navigationLabel = 'Findings';
    public static function shouldRegisterNavigation(): bool
    {
        if (Filament::getCurrentPanel()?->getId() === 'admin') {
@ -86,6 +84,26 @@ public static function shouldRegisterNavigation(): bool
        return parent::shouldRegisterNavigation();
    }
    public static function getNavigationLabel(): string
    {
        return __('localization.navigation.findings');
    }
    public static function getNavigationGroup(): string
    {
        return __('localization.navigation.governance');
    }
    public static function getModelLabel(): string
    {
        return __('localization.navigation.findings');
    }
    public static function getPluralModelLabel(): string
    {
        return __('localization.navigation.findings');
    }
    public static function canViewAny(): bool
    {
        $tenant = static::resolveTenantContextForCurrentPanel();
@ -290,8 +308,6 @@ public static function infolist(Schema $schema): Schema
                                ? OperationRunLinks::tenantlessView((int) $record->current_operation_run_id, static::findingRunNavigationContext($record))
                                : null)
                            ->openUrlInNewTab(),
                        TextEntry::make('acknowledged_at')->dateTime()->placeholder('—'),
                        TextEntry::make('acknowledged_by_user_id')->label('Acknowledged by')->placeholder('—'),
                        TextEntry::make('first_seen_at')->label('First seen')->dateTime()->placeholder('—'),
                        TextEntry::make('last_seen_at')->label('Last seen')->dateTime()->placeholder('—'),
                        TextEntry::make('times_seen')->label('Times seen')->placeholder('—'),
@ -982,7 +998,6 @@ public static function table(Table $table): Table
                                    if (! in_array((string) $record->status, [
                                        Finding::STATUS_NEW,
                                        Finding::STATUS_REOPENED,
                                        Finding::STATUS_ACKNOWLEDGED,
                                    ], true)) {
                                        $skippedCount++;
@ -1398,7 +1413,6 @@ public static function triageAction(): Actions\Action
                ->visible(fn (Finding $record): bool => in_array((string) $record->status, [
                    Finding::STATUS_NEW,
                    Finding::STATUS_REOPENED,
                    Finding::STATUS_ACKNOWLEDGED,
                ], true))
                ->action(function (Finding $record, FindingWorkflowService $workflow): void {
                    static::runWorkflowMutation(
@ -1423,7 +1437,6 @@ public static function startProgressAction(): Actions\Action
                ->color('info')
                ->visible(fn (Finding $record): bool => in_array((string) $record->status, [
                    Finding::STATUS_TRIAGED,
                    Finding::STATUS_ACKNOWLEDGED,
                ], true))
                ->action(function (Finding $record, FindingWorkflowService $workflow): void {
                    static::runWorkflowMutation(
--- a/apps/platform/app/Filament/Resources/FindingResource/Pages/ListFindings.php
+++ b/apps/platform/app/Filament/Resources/FindingResource/Pages/ListFindings.php
@ -10,14 +10,8 @@
 use App\Models\Tenant;
 use App\Models\User;
 use App\Services\Findings\FindingWorkflowService;
 use App\Services\Runbooks\FindingsLifecycleBackfillRunbookService;
 use App\Services\Runbooks\FindingsLifecycleBackfillScope;
 use App\Support\Auth\Capabilities;
 use App\Support\Filament\CanonicalAdminTenantFilterState;
 use App\Support\OperationRunLinks;
 use App\Support\OpsUx\OperationUxPresenter;
 use App\Support\OpsUx\OpsUxBrowserEvents;
 use App\Support\OperationalControls\OperationalControlBlockedException;
 use App\Support\Rbac\UiEnforcement;
 use App\Support\Rbac\UiTooltips;
 use Filament\Actions;
@ -77,15 +71,15 @@ public function getTabs(): array
        $stats = FindingResource::findingStatsForCurrentTenant();
        return [
-            'all' => Tab::make('All')
+            'all' => Tab::make(__('localization.findings.all'))
                ->icon('heroicon-m-list-bullet'),
-            'needs_action' => Tab::make('Needs action')
+            'needs_action' => Tab::make(__('localization.findings.needs_action'))
                ->icon('heroicon-m-exclamation-triangle')
                ->modifyQueryUsing(fn (Builder $query): Builder => $query
                    ->whereIn('status', Finding::openStatusesForQuery()))
                ->badge($stats['open'] > 0 ? $stats['open'] : null)
                ->badgeColor('warning'),
-            'overdue' => Tab::make('Overdue')
+            'overdue' => Tab::make(__('localization.findings.overdue'))
                ->icon('heroicon-m-clock')
                ->modifyQueryUsing(fn (Builder $query): Builder => $query
                    ->whereIn('status', Finding::openStatusesForQuery())
@ -93,11 +87,11 @@ public function getTabs(): array
                    ->where('due_at', '<', now()))
                ->badge($stats['overdue'] > 0 ? $stats['overdue'] : null)
                ->badgeColor('danger'),
-            'risk_accepted' => Tab::make('Risk accepted')
+            'risk_accepted' => Tab::make(__('localization.findings.risk_accepted'))
                ->icon('heroicon-m-shield-check')
                ->modifyQueryUsing(fn (Builder $query): Builder => $query
                    ->where('status', Finding::STATUS_RISK_ACCEPTED)),
-            'resolved' => Tab::make('Resolved')
+            'resolved' => Tab::make(__('localization.findings.resolved'))
                ->icon('heroicon-m-archive-box')
                ->modifyQueryUsing(fn (Builder $query): Builder => $query
                    ->whereIn('status', [Finding::STATUS_RESOLVED, Finding::STATUS_CLOSED])),
@ -108,77 +102,6 @@ protected function getHeaderActions(): array
    {
        $actions = [];
        $actions[] = UiEnforcement::forAction(
            Actions\Action::make('backfill_lifecycle')
                ->label('Backfill findings lifecycle')
                ->icon('heroicon-o-wrench-screwdriver')
                ->color('gray')
                ->requiresConfirmation()
                ->modalHeading('Backfill findings lifecycle')
                ->modalDescription('This will backfill legacy Findings data (lifecycle fields, SLA due dates, and drift duplicate consolidation) for the current tenant. The operation runs in the background.')
                ->action(function (FindingsLifecycleBackfillRunbookService $runbookService): void {
                    $user = auth()->user();
                    if (! $user instanceof User) {
                        abort(403);
                    }
                    $tenant = static::resolveTenantContextForCurrentPanel();
                    if (! $tenant instanceof Tenant) {
                        abort(404);
                    }
                    try {
                        $opRun = $runbookService->start(
                            scope: FindingsLifecycleBackfillScope::singleTenant((int) $tenant->getKey()),
                            initiator: $user,
                            reason: null,
                            source: 'tenant_ui',
                        );
                    } catch (OperationalControlBlockedException $exception) {
                        Notification::make()
                            ->title($exception->title())
                            ->body($exception->getMessage())
                            ->warning()
                            ->send();
                        throw new \Filament\Support\Exceptions\Halt;
                    }
                    $runUrl = OperationRunLinks::view($opRun, $tenant);
                    if ($opRun->wasRecentlyCreated === false) {
                        OpsUxBrowserEvents::dispatchRunEnqueued($this);
                        OperationUxPresenter::alreadyQueuedToast((string) $opRun->type)
                            ->actions([
                                Actions\Action::make('view_run')
                                    ->label('Open operation')
                                    ->url($runUrl),
                            ])
                            ->send();
                        return;
                    }
                    OpsUxBrowserEvents::dispatchRunEnqueued($this);
                    OperationUxPresenter::queuedToast((string) $opRun->type)
                        ->body('The backfill will run in the background. You can continue working while it completes.')
                        ->actions([
                            Actions\Action::make('view_run')
                                ->label('Open operation')
                                ->url($runUrl),
                        ])
                        ->send();
                })
        )
            ->preserveVisibility()
            ->requireCapability(Capabilities::TENANT_MANAGE)
            ->tooltip(UiTooltips::INSUFFICIENT_PERMISSION)
            ->apply();
        $actions[] = UiEnforcement::forAction(
            Actions\Action::make('triage_all_matching')
                ->label('Triage all matching')
@ -248,7 +171,6 @@ protected function getHeaderActions(): array
                            if (! in_array((string) $finding->status, [
                                Finding::STATUS_NEW,
                                Finding::STATUS_REOPENED,
                                Finding::STATUS_ACKNOWLEDGED,
                            ], true)) {
                                $skippedCount++;
--- a/apps/platform/app/Filament/Resources/FindingResource/Pages/ViewFinding.php
+++ b/apps/platform/app/Filament/Resources/FindingResource/Pages/ViewFinding.php
@ -44,7 +44,7 @@ protected function getHeaderActions(): array
                    ->primaryListAction(CrossResourceNavigationMatrix::SOURCE_FINDING, $this->getRecord())?->isAvailable() ?? false))
                ->color('gray'),
            Actions\Action::make('open_approval_queue')
-                ->label('Open approval queue')
+                ->label(__('localization.findings.open_approval_queue'))
                ->icon('heroicon-o-arrow-top-right-on-square')
                ->color('gray')
                ->visible(function (): bool {
@ -61,7 +61,7 @@ protected function getHeaderActions(): array
                        : null;
                }),
            Actions\ActionGroup::make(FindingResource::workflowActions())
-                ->label('Actions')
+                ->label(__('localization.findings.actions'))
                ->icon('heroicon-o-ellipsis-vertical')
                ->color('gray'),
        ]);
--- a/apps/platform/app/Filament/Resources/ReviewPackResource.php
+++ b/apps/platform/app/Filament/Resources/ReviewPackResource.php
@ -2,7 +2,10 @@
 namespace App\Filament\Resources;
 use App\Filament\Concerns\ResolvesPanelTenantContext;
 use App\Exceptions\Entitlements\WorkspaceEntitlementBlockedException;
 use App\Exceptions\ReviewPackEvidenceResolutionException;
 use App\Filament\Pages\Reviews\CustomerReviewWorkspace;
 use App\Filament\Resources\EvidenceSnapshotResource as TenantEvidenceSnapshotResource;
 use App\Filament\Resources\ReviewPackResource\Pages;
 use App\Models\ReviewPack;
@ -10,6 +13,7 @@
 use App\Models\User;
 use App\Services\ReviewPackService;
 use App\Support\Auth\Capabilities;
 use App\Support\Auth\UiTooltips as AuthUiTooltips;
 use App\Support\Badges\BadgeCatalog;
 use App\Support\Badges\BadgeDomain;
 use App\Support\Badges\BadgeRenderer;
@ -45,6 +49,8 @@
 class ReviewPackResource extends Resource
 {
    use ResolvesPanelTenantContext;
    protected static ?string $model = ReviewPack::class;
    protected static ?string $tenantOwnershipRelationshipName = 'tenant';
@ -102,9 +108,9 @@ public static function canView(Model $record): bool
    public static function actionSurfaceDeclaration(): ActionSurfaceDeclaration
    {
        return ActionSurfaceDeclaration::forResource(ActionSurfaceProfile::CrudListAndView, ActionSurfaceType::ReadOnlyRegistryReport)
-            ->satisfy(ActionSurfaceSlot::ListHeader, 'Generate Pack action available in list header.')
+            ->satisfy(ActionSurfaceSlot::ListHeader, 'Generate Pack action appears in the list header once review packs exist.')
            ->satisfy(ActionSurfaceSlot::InspectAffordance, ActionSurfaceInspectAffordance::ClickableRow->value)
-            ->satisfy(ActionSurfaceSlot::ListEmptyState, 'Empty state includes Generate CTA.')
+            ->satisfy(ActionSurfaceSlot::ListEmptyState, 'Empty state carries the single Generate CTA while the registry is empty.')
            ->satisfy(ActionSurfaceSlot::ListRowMoreMenu, 'Clickable-row inspection stays primary while Download remains the only direct row shortcut and Expire is grouped under More.')
            ->exempt(ActionSurfaceSlot::ListBulkMoreGroup, 'No bulk operations are supported for review packs.')
            ->satisfy(ActionSurfaceSlot::DetailHeader, 'Download and Regenerate actions in ViewReviewPack header.');
@ -190,6 +196,13 @@ public static function infolist(Schema $schema): Schema
                                ? TenantReviewResource::tenantScopedUrl('view', ['record' => $record->tenantReview], $record->tenant)
                                : null)
                            ->placeholder('—'),
                        TextEntry::make('customer_workspace')
                            ->label('Customer workspace')
                            ->state(fn (): string => 'Open workspace')
                            ->url(fn (ReviewPack $record): ?string => $record->tenant instanceof Tenant
                                ? CustomerReviewWorkspace::tenantPrefilterUrl($record->tenant)
                                : null)
                            ->placeholder('—'),
                        TextEntry::make('summary.review_status')
                            ->label('Review status')
                            ->badge()
@ -350,41 +363,62 @@ public static function table(Table $table): Table
            ->emptyStateDescription('Generate a review pack to export tenant data for external review.')
            ->emptyStateIcon('heroicon-o-document-arrow-down')
            ->emptyStateActions([
-                UiEnforcement::forAction(
+                static::generatePackAction(name: 'generate_first', label: 'Generate first pack'),
                    Actions\Action::make('generate_first')
                        ->label('Generate first pack')
                        ->icon('heroicon-o-plus')
                        ->action(function (array $data): void {
                            static::executeGeneration($data);
                        })
                        ->form([
                            Section::make('Pack options')
                                ->schema([
                                    Toggle::make('include_pii')
                                        ->label('Include PII')
                                        ->helperText('Include personally identifiable information in the export.')
                                        ->default(config('tenantpilot.review_pack.include_pii_default', true)),
                                    Toggle::make('include_operations')
                                        ->label('Include operations')
                                        ->helperText('Include recent operation history in the export.')
                                        ->default(config('tenantpilot.review_pack.include_operations_default', true)),
                                ]),
                        ])
                )
                    ->requireCapability(Capabilities::REVIEW_PACK_MANAGE)
                    ->apply(),
            ]);
    }
    public static function generatePackAction(string $name = 'generate_pack', string $label = 'Generate Pack'): Actions\Action
    {
        $action = UiEnforcement::forAction(
            Actions\Action::make($name)
                ->label($label)
                ->icon('heroicon-o-plus')
                ->disabled(fn (): bool => static::reviewPackGenerationBlocked())
                ->action(function (array $data): void {
                    static::executeGeneration($data);
                })
                ->form(static::reviewPackGenerationFormSchema())
        )
            ->requireCapability(Capabilities::REVIEW_PACK_MANAGE)
            ->preserveDisabled()
            ->apply();
        $action->tooltip(fn (): ?string => static::reviewPackGenerationActionTooltip());
        return $action;
    }
    /**
     * @return array<int, Section>
     */
    public static function reviewPackGenerationFormSchema(): array
    {
        return [
            Section::make('Pack options')
                ->schema([
                    Toggle::make('include_pii')
                        ->label('Include PII')
                        ->helperText('Include personally identifiable information in the export.')
                        ->default(config('tenantpilot.review_pack.include_pii_default', true)),
                    Toggle::make('include_operations')
                        ->label('Include operations')
                        ->helperText('Include recent operation history in the export.')
                        ->default(config('tenantpilot.review_pack.include_operations_default', true)),
                ]),
        ];
    }
    public static function getEloquentQuery(): Builder
    {
-        $tenant = Filament::getTenant();
+        $tenant = Tenant::current() ?? static::resolveTenantContextForCurrentPanel() ?? Filament::getTenant();
        if (! $tenant instanceof Tenant) {
            return parent::getEloquentQuery()->whereRaw('1 = 0');
        }
-        return parent::getEloquentQuery()->where('tenant_id', (int) $tenant->getKey());
+        return parent::getEloquentQuery()
            ->with(['tenant', 'operationRun', 'evidenceSnapshot', 'tenantReview'])
            ->where('tenant_id', (int) $tenant->getKey());
    }
    public static function getPages(): array
@ -458,6 +492,14 @@ public static function executeGeneration(array $data): void
        try {
            $reviewPack = $service->generate($tenant, $user, $options);
        } catch (WorkspaceEntitlementBlockedException $exception) {
            Notification::make()
                ->warning()
                ->title('Review pack generation unavailable')
                ->body($exception->getMessage())
                ->send();
            return;
        } catch (ReviewPackEvidenceResolutionException $exception) {
            $reasons = $exception->result->reasons;
@ -493,4 +535,69 @@ public static function executeGeneration(array $data): void
        OperationUxPresenter::queuedToast('tenant.review_pack.generate')->send();
    }
    /**
     * @return array<string, mixed>
     */
    public static function reviewPackGenerationDecision(?Tenant $tenant = null): array
    {
        $tenant ??= Tenant::current() ?? static::resolveTenantContextForCurrentPanel() ?? Filament::getTenant();
        if (! $tenant instanceof Tenant) {
            return [];
        }
        return app(ReviewPackService::class)->reviewPackGenerationDecisionForTenant($tenant);
    }
    public static function currentTenantContext(): ?Tenant
    {
        $tenant = Tenant::current() ?? static::resolveTenantContextForCurrentPanel() ?? Filament::getTenant();
        return $tenant instanceof Tenant ? $tenant : null;
    }
    public static function reviewPackGenerationBlocked(?Tenant $tenant = null): bool
    {
        return (bool) (static::reviewPackGenerationDecision($tenant)['is_blocked'] ?? false);
    }
    public static function reviewPackGenerationBlockReason(?Tenant $tenant = null): ?string
    {
        $decision = static::reviewPackGenerationDecision($tenant);
        if (! (bool) ($decision['is_blocked'] ?? false)) {
            return null;
        }
        $reason = $decision['block_reason'] ?? null;
        return is_string($reason) && $reason !== '' ? $reason : null;
    }
    public static function reviewPackGenerationWarningReason(?Tenant $tenant = null): ?string
    {
        $decision = static::reviewPackGenerationDecision($tenant);
        if (! (bool) ($decision['is_warning'] ?? false)) {
            return null;
        }
        $reason = $decision['warning_reason'] ?? null;
        return is_string($reason) && $reason !== '' ? $reason : null;
    }
    public static function reviewPackGenerationActionTooltip(?Tenant $tenant = null): ?string
    {
        $tenant ??= static::currentTenantContext();
        $user = auth()->user();
        if ($tenant instanceof Tenant && $user instanceof User && ! $user->can(Capabilities::REVIEW_PACK_MANAGE, $tenant)) {
            return AuthUiTooltips::insufficientPermission();
        }
        return static::reviewPackGenerationBlockReason($tenant)
            ?? static::reviewPackGenerationWarningReason($tenant);
    }
 }
--- a/apps/platform/app/Filament/Resources/ReviewPackResource/Pages/ListReviewPacks.php
+++ b/apps/platform/app/Filament/Resources/ReviewPackResource/Pages/ListReviewPacks.php
@ -3,12 +3,7 @@
 namespace App\Filament\Resources\ReviewPackResource\Pages;
 use App\Filament\Resources\ReviewPackResource;
 use App\Support\Auth\Capabilities;
 use App\Support\Rbac\UiEnforcement;
 use Filament\Actions;
 use Filament\Forms\Components\Toggle;
 use Filament\Resources\Pages\ListRecords;
 use Filament\Schemas\Components\Section;
 class ListReviewPacks extends ListRecords
 {
@ -17,29 +12,13 @@ class ListReviewPacks extends ListRecords
    protected function getHeaderActions(): array
    {
        return [
-            UiEnforcement::forAction(
+            ReviewPackResource::generatePackAction()
-                Actions\Action::make('generate_pack')
+                ->visible(fn (): bool => $this->tableHasRecords()),
                    ->label('Generate Pack')
                    ->icon('heroicon-o-plus')
                    ->action(function (array $data): void {
                        ReviewPackResource::executeGeneration($data);
                    })
                    ->form([
                        Section::make('Pack options')
                            ->schema([
                                Toggle::make('include_pii')
                                    ->label('Include PII')
                                    ->helperText('Include personally identifiable information in the export.')
                                    ->default(config('tenantpilot.review_pack.include_pii_default', true)),
                                Toggle::make('include_operations')
                                    ->label('Include operations')
                                    ->helperText('Include recent operation history in the export.')
                                    ->default(config('tenantpilot.review_pack.include_operations_default', true)),
                            ]),
                    ])
            )
                ->requireCapability(Capabilities::REVIEW_PACK_MANAGE)
                ->apply(),
        ];
    }
    private function tableHasRecords(): bool
    {
        return $this->getTableRecords()->count() > 0;
    }
 }
--- a/apps/platform/app/Filament/Resources/ReviewPackResource/Pages/ViewReviewPack.php
+++ b/apps/platform/app/Filament/Resources/ReviewPackResource/Pages/ViewReviewPack.php
@ -19,6 +19,51 @@ class ViewReviewPack extends ViewRecord
    protected function getHeaderActions(): array
    {
        $regenerateAction = UiEnforcement::forAction(
            Actions\Action::make('regenerate')
                ->label('Regenerate')
                ->icon('heroicon-o-arrow-path')
                ->color('primary')
                ->disabled(fn (): bool => ReviewPackResource::reviewPackGenerationBlocked($this->record->tenant))
                ->requiresConfirmation()
                ->modalDescription('This will generate a new review pack with the same options. The current pack will remain available until it expires.')
                ->action(function (array $data): void {
                    /** @var ReviewPack $record */
                    $record = $this->record;
                    $options = array_merge($record->options ?? [], [
                        'include_pii' => (bool) ($data['include_pii'] ?? ($record->options['include_pii'] ?? true)),
                        'include_operations' => (bool) ($data['include_operations'] ?? ($record->options['include_operations'] ?? true)),
                    ]);
                    ReviewPackResource::executeGeneration($options);
                })
                ->form(function (): array {
                    /** @var ReviewPack $record */
                    $record = $this->record;
                    $currentOptions = $record->options ?? [];
                    return [
                        Section::make('Pack options')
                            ->schema([
                                Toggle::make('include_pii')
                                    ->label('Include PII')
                                    ->helperText('Include personally identifiable information in the export.')
                                    ->default((bool) ($currentOptions['include_pii'] ?? true)),
                                Toggle::make('include_operations')
                                    ->label('Include operations')
                                    ->helperText('Include recent operation history in the export.')
                                    ->default((bool) ($currentOptions['include_operations'] ?? true)),
                            ]),
                    ];
                })
        )
            ->requireCapability(Capabilities::REVIEW_PACK_MANAGE)
            ->preserveDisabled()
            ->apply();
        $regenerateAction->tooltip(fn (): ?string => ReviewPackResource::reviewPackGenerationActionTooltip($this->record->tenant));
        return [
            Actions\Action::make('download')
                ->label('Download')
@ -28,46 +73,7 @@ protected function getHeaderActions(): array
                ->url(fn (): string => app(ReviewPackService::class)->generateDownloadUrl($this->record))
                ->openUrlInNewTab(),
-            UiEnforcement::forAction(
+            $regenerateAction,
                Actions\Action::make('regenerate')
                    ->label('Regenerate')
                    ->icon('heroicon-o-arrow-path')
                    ->color('primary')
                    ->requiresConfirmation()
                    ->modalDescription('This will generate a new review pack with the same options. The current pack will remain available until it expires.')
                    ->action(function (array $data): void {
                        /** @var ReviewPack $record */
                        $record = $this->record;
                        $options = array_merge($record->options ?? [], [
                            'include_pii' => (bool) ($data['include_pii'] ?? ($record->options['include_pii'] ?? true)),
                            'include_operations' => (bool) ($data['include_operations'] ?? ($record->options['include_operations'] ?? true)),
                        ]);
                        ReviewPackResource::executeGeneration($options);
                    })
                    ->form(function (): array {
                        /** @var ReviewPack $record */
                        $record = $this->record;
                        $currentOptions = $record->options ?? [];
                        return [
                            Section::make('Pack options')
                                ->schema([
                                    Toggle::make('include_pii')
                                        ->label('Include PII')
                                        ->helperText('Include personally identifiable information in the export.')
                                        ->default((bool) ($currentOptions['include_pii'] ?? true)),
                                    Toggle::make('include_operations')
                                        ->label('Include operations')
                                        ->helperText('Include recent operation history in the export.')
                                        ->default((bool) ($currentOptions['include_operations'] ?? true)),
                                ]),
                        ];
                    })
            )
                ->requireCapability(Capabilities::REVIEW_PACK_MANAGE)
                ->apply(),
        ];
    }
 }
--- a/apps/platform/app/Filament/Resources/TenantReviewResource.php
+++ b/apps/platform/app/Filament/Resources/TenantReviewResource.php
@ -6,7 +6,9 @@
 use App\Filament\Concerns\InteractsWithTenantOwnedRecords;
 use App\Filament\Concerns\ResolvesPanelTenantContext;
 use App\Filament\Pages\Reviews\CustomerReviewWorkspace;
 use App\Filament\Resources\TenantReviewResource\Pages;
 use App\Exceptions\Entitlements\WorkspaceEntitlementBlockedException;
 use App\Models\EvidenceSnapshot;
 use App\Models\Tenant;
 use App\Models\TenantReview;
@ -15,6 +17,7 @@
 use App\Services\ReviewPackService;
 use App\Services\TenantReviews\TenantReviewService;
 use App\Support\Auth\Capabilities;
 use App\Support\Auth\UiTooltips as AuthUiTooltips;
 use App\Support\Badges\BadgeCatalog;
 use App\Support\Badges\BadgeDomain;
 use App\Support\Badges\BadgeRenderer;
@ -82,6 +85,26 @@ public static function shouldRegisterNavigation(): bool
        return Filament::getCurrentPanel()?->getId() === 'tenant';
    }
    public static function getNavigationGroup(): string
    {
        return __('localization.review.reporting');
    }
    public static function getNavigationLabel(): string
    {
        return __('localization.review.reviews');
    }
    public static function getModelLabel(): string
    {
        return __('localization.review.review');
    }
    public static function getPluralModelLabel(): string
    {
        return __('localization.review.reviews');
    }
    public static function canViewAny(): bool
    {
        $tenant = static::resolveTenantContextForCurrentPanel();
@ -150,7 +173,7 @@ public static function form(Schema $schema): Schema
    public static function infolist(Schema $schema): Schema
    {
        return $schema->schema([
-            Section::make('Outcome summary')
+            Section::make(__('localization.review.outcome_summary'))
                ->schema([
                    ViewEntry::make('artifact_truth')
                        ->hiddenLabel()
@ -159,7 +182,7 @@ public static function infolist(Schema $schema): Schema
                        ->columnSpanFull(),
                ])
                ->columnSpanFull(),
-            Section::make('Review')
+            Section::make(__('localization.review.review'))
                ->schema([
                    TextEntry::make('status')
                        ->badge()
@ -168,23 +191,23 @@ public static function infolist(Schema $schema): Schema
                        ->icon(BadgeRenderer::icon(BadgeDomain::TenantReviewStatus))
                        ->iconColor(BadgeRenderer::iconColor(BadgeDomain::TenantReviewStatus)),
                    TextEntry::make('completeness_state')
-                        ->label('Completeness')
+                        ->label(__('localization.review.completeness'))
                        ->badge()
                        ->formatStateUsing(BadgeRenderer::label(BadgeDomain::TenantReviewCompleteness))
                        ->color(BadgeRenderer::color(BadgeDomain::TenantReviewCompleteness))
                        ->icon(BadgeRenderer::icon(BadgeDomain::TenantReviewCompleteness))
                        ->iconColor(BadgeRenderer::iconColor(BadgeDomain::TenantReviewCompleteness)),
-                    TextEntry::make('tenant.name')->label('Tenant'),
+                    TextEntry::make('tenant.name')->label(__('localization.review.tenant')),
                    TextEntry::make('generated_at')->dateTime()->placeholder('—'),
                    TextEntry::make('published_at')->dateTime()->placeholder('—'),
                    TextEntry::make('evidenceSnapshot.id')
-                        ->label('Evidence snapshot')
+                        ->label(__('localization.review.evidence_snapshot'))
                        ->formatStateUsing(fn (?int $state): string => $state ? '#'.$state : '—')
                        ->url(fn (TenantReview $record): ?string => $record->evidenceSnapshot
                            ? EvidenceSnapshotResource::getUrl('view', ['record' => $record->evidenceSnapshot], tenant: $record->tenant)
                            : null),
                    TextEntry::make('currentExportReviewPack.id')
-                        ->label('Current export')
+                        ->label(__('localization.review.current_export'))
                        ->formatStateUsing(fn (?int $state): string => $state ? '#'.$state : '—')
                        ->url(fn (TenantReview $record): ?string => $record->currentExportReviewPack
                            ? ReviewPackResource::getUrl('view', ['record' => $record->currentExportReviewPack], tenant: $record->tenant)
@ -198,7 +221,7 @@ public static function infolist(Schema $schema): Schema
                ])
                ->columns(2)
                ->columnSpanFull(),
-            Section::make('Executive posture')
+            Section::make(__('localization.review.executive_posture'))
                ->schema([
                    ViewEntry::make('review_summary')
                        ->hiddenLabel()
@ -207,21 +230,21 @@ public static function infolist(Schema $schema): Schema
                        ->columnSpanFull(),
                ])
                ->columnSpanFull(),
-            Section::make('Sections')
+            Section::make(__('localization.review.sections'))
                ->schema([
                    RepeatableEntry::make('sections')
                        ->hiddenLabel()
                        ->schema([
                            TextEntry::make('title'),
                            TextEntry::make('completeness_state')
-                                ->label('Completeness')
+                                ->label(__('localization.review.completeness'))
                                ->badge()
                                ->formatStateUsing(BadgeRenderer::label(BadgeDomain::TenantReviewCompleteness))
                                ->color(BadgeRenderer::color(BadgeDomain::TenantReviewCompleteness))
                                ->icon(BadgeRenderer::icon(BadgeDomain::TenantReviewCompleteness))
                                ->iconColor(BadgeRenderer::iconColor(BadgeDomain::TenantReviewCompleteness)),
                            TextEntry::make('measured_at')->dateTime()->placeholder('—'),
-                            Section::make('Details')
+                            Section::make(__('localization.review.details'))
                                ->schema([
                                    ViewEntry::make('section_payload')
                                        ->hiddenLabel()
@ -241,6 +264,25 @@ public static function infolist(Schema $schema): Schema
    public static function table(Table $table): Table
    {
        $exportExecutivePackAction = UiEnforcement::forTableAction(
            Actions\Action::make('export_executive_pack')
                ->label(__('localization.review.export_executive_pack'))
                ->icon('heroicon-o-arrow-down-tray')
                ->visible(fn (TenantReview $record): bool => in_array($record->status, [
                    TenantReviewStatus::Ready->value,
                    TenantReviewStatus::Published->value,
                ], true))
                ->disabled(fn (TenantReview $record): bool => static::reviewPackGenerationBlocked($record->tenant))
                ->action(fn (TenantReview $record): mixed => static::executeExport($record)),
            fn (TenantReview $record): TenantReview => $record,
        )
            ->requireCapability(Capabilities::TENANT_REVIEW_MANAGE)
            ->preserveVisibility()
            ->preserveDisabled()
            ->apply();
        $exportExecutivePackAction->tooltip(fn (TenantReview $record): ?string => static::reviewPackGenerationActionTooltip($record->tenant));
        return $table
            ->defaultSort('generated_at', 'desc')
            ->persistFiltersInSession()
@ -256,7 +298,7 @@ public static function table(Table $table): Table
                    ->iconColor(BadgeRenderer::iconColor(BadgeDomain::TenantReviewStatus))
                    ->sortable(),
                Tables\Columns\TextColumn::make('outcome')
-                    ->label('Outcome')
+                    ->label(__('localization.review.outcome'))
                    ->badge()
                    ->getStateUsing(fn (TenantReview $record): string => static::compressedOutcome($record)->primaryLabel)
                    ->color(fn (TenantReview $record): string => static::compressedOutcome($record)->primaryBadge->color)
@ -267,10 +309,10 @@ public static function table(Table $table): Table
                Tables\Columns\TextColumn::make('generated_at')->dateTime()->placeholder('—')->sortable(),
                Tables\Columns\TextColumn::make('published_at')->dateTime()->placeholder('—')->sortable(),
                Tables\Columns\IconColumn::make('summary.has_ready_export')
-                    ->label('Export')
+                    ->label(__('localization.review.export'))
                    ->boolean(),
                Tables\Columns\TextColumn::make('next_step')
-                    ->label('Next step')
+                    ->label(__('localization.review.next_step'))
                    ->getStateUsing(fn (TenantReview $record): string => static::compressedOutcome($record)->nextActionText)
                    ->wrap(),
                Tables\Columns\TextColumn::make('fingerprint')
@ -284,31 +326,18 @@ public static function table(Table $table): Table
                        ->all()),
                Tables\Filters\SelectFilter::make('completeness_state')
                    ->options(BadgeCatalog::options(BadgeDomain::TenantReviewCompleteness, TenantReviewCompletenessState::values())),
-                \App\Support\Filament\FilterPresets::dateRange('review_date', 'Review date', 'generated_at'),
+                \App\Support\Filament\FilterPresets::dateRange('review_date', __('localization.review.review_date'), 'generated_at'),
            ])
            ->actions([
-                UiEnforcement::forTableAction(
+                $exportExecutivePackAction,
                    Actions\Action::make('export_executive_pack')
                        ->label('Export executive pack')
                        ->icon('heroicon-o-arrow-down-tray')
                        ->visible(fn (TenantReview $record): bool => in_array($record->status, [
                            TenantReviewStatus::Ready->value,
                            TenantReviewStatus::Published->value,
                        ], true))
                        ->action(fn (TenantReview $record): mixed => static::executeExport($record)),
                    fn (TenantReview $record): TenantReview => $record,
                )
                    ->requireCapability(Capabilities::TENANT_REVIEW_MANAGE)
                    ->preserveVisibility()
                    ->apply(),
            ])
            ->bulkActions([])
-            ->emptyStateHeading('No tenant reviews yet')
+            ->emptyStateHeading(__('localization.review.no_tenant_reviews_yet'))
-            ->emptyStateDescription('Create the first review from an anchored evidence snapshot to start the recurring review history for this tenant.')
+            ->emptyStateDescription(__('localization.review.create_first_review_description'))
            ->emptyStateActions([
                static::makeCreateReviewAction(
                    name: 'create_first_review',
-                    label: 'Create first review',
+                    label: __('localization.review.create_first_review'),
                    icon: 'heroicon-o-plus',
                ),
            ]);
@ -327,19 +356,23 @@ public static function makeCreateReviewAction(
        string $label = 'Create review',
        string $icon = 'heroicon-o-plus',
    ): Actions\Action {
        $label = $label === 'Create review'
            ? __('localization.review.create_review')
            : $label;
        return UiEnforcement::forAction(
            Actions\Action::make($name)
                ->label($label)
                ->icon($icon)
                ->form([
-                    Section::make('Evidence basis')
+                    Section::make(__('localization.review.evidence_basis'))
                        ->schema([
                            Select::make('evidence_snapshot_id')
-                                ->label('Evidence snapshot')
+                                ->label(__('localization.review.evidence_snapshot'))
                                ->required()
                                ->options(fn (): array => static::evidenceSnapshotOptions())
                                ->searchable()
-                                ->helperText('Choose the anchored evidence snapshot for this review.'),
+                                ->helperText(__('localization.review.evidence_basis_helper')),
                        ]),
                ])
                ->action(fn (array $data): mixed => static::executeCreateReview($data)),
@ -357,7 +390,7 @@ public static function executeCreateReview(array $data): void
        $user = auth()->user();
        if (! $tenant instanceof Tenant || ! $user instanceof User) {
-            Notification::make()->danger()->title('Unable to create review — missing context.')->send();
+            Notification::make()->danger()->title(__('localization.review.unable_create_missing_context'))->send();
            return;
        }
@ -379,7 +412,7 @@ public static function executeCreateReview(array $data): void
            : null;
        if (! $snapshot instanceof EvidenceSnapshot) {
-            Notification::make()->danger()->title('Select a valid evidence snapshot.')->send();
+            Notification::make()->danger()->title(__('localization.review.select_valid_evidence_snapshot'))->send();
            return;
        }
@ -387,7 +420,7 @@ public static function executeCreateReview(array $data): void
        try {
            $review = app(TenantReviewService::class)->create($tenant, $snapshot, $user);
        } catch (\Throwable $throwable) {
-            Notification::make()->danger()->title('Unable to create review')->body($throwable->getMessage())->send();
+            Notification::make()->danger()->title(__('localization.review.unable_create_review'))->body($throwable->getMessage())->send();
            return;
        }
@ -397,11 +430,11 @@ public static function executeCreateReview(array $data): void
        if (! $review->wasRecentlyCreated) {
            Notification::make()
                ->success()
-                ->title('Review already available')
+                ->title(__('localization.review.review_already_available'))
-                ->body('A matching mutable review already exists for this evidence basis.')
+                ->body(__('localization.review.review_already_available_body'))
                ->actions([
                    Actions\Action::make('view_review')
-                        ->label('View review')
+                        ->label(__('localization.review.view_review'))
                        ->url(static::tenantScopedUrl('view', ['record' => $review], $tenant)),
                ])
                ->send();
@ -410,12 +443,12 @@ public static function executeCreateReview(array $data): void
        }
        $toast = OperationUxPresenter::queuedToast(OperationRunType::TenantReviewCompose->value)
-            ->body('The review is being composed in the background.');
+            ->body(__('localization.review.review_composing_background'));
        if ($review->operation_run_id) {
            $toast->actions([
                Actions\Action::make('view_run')
-                    ->label('Open operation')
+                    ->label(__('localization.review.open_operation'))
                    ->url(OperationRunLinks::tenantlessView((int) $review->operation_run_id)),
            ]);
        }
@ -423,13 +456,71 @@ public static function executeCreateReview(array $data): void
        $toast->send();
    }
    /**
     * @return array<string, mixed>
     */
    public static function reviewPackGenerationDecision(?Tenant $tenant = null): array
    {
        $tenant ??= Filament::getTenant();
        if (! $tenant instanceof Tenant) {
            return [];
        }
        return app(ReviewPackService::class)->reviewPackGenerationDecisionForTenant($tenant);
    }
    public static function reviewPackGenerationBlocked(?Tenant $tenant = null): bool
    {
        return (bool) (static::reviewPackGenerationDecision($tenant)['is_blocked'] ?? false);
    }
    public static function reviewPackGenerationBlockReason(?Tenant $tenant = null): ?string
    {
        $decision = static::reviewPackGenerationDecision($tenant);
        if (! (bool) ($decision['is_blocked'] ?? false)) {
            return null;
        }
        $reason = $decision['block_reason'] ?? null;
        return is_string($reason) && $reason !== '' ? $reason : null;
    }
    public static function reviewPackGenerationWarningReason(?Tenant $tenant = null): ?string
    {
        $decision = static::reviewPackGenerationDecision($tenant);
        if (! (bool) ($decision['is_warning'] ?? false)) {
            return null;
        }
        $reason = $decision['warning_reason'] ?? null;
        return is_string($reason) && $reason !== '' ? $reason : null;
    }
    public static function reviewPackGenerationActionTooltip(?Tenant $tenant = null): ?string
    {
        $tenant ??= static::panelTenantContext();
        $user = auth()->user();
        if ($tenant instanceof Tenant && $user instanceof User && ! $user->can(Capabilities::TENANT_REVIEW_MANAGE, $tenant)) {
            return AuthUiTooltips::insufficientPermission();
        }
        return static::reviewPackGenerationBlockReason($tenant)
            ?? static::reviewPackGenerationWarningReason($tenant);
    }
    public static function executeExport(TenantReview $review): void
    {
        $review->loadMissing(['tenant', 'currentExportReviewPack']);
        $user = auth()->user();
        if (! $user instanceof User || ! $review->tenant instanceof Tenant) {
-            Notification::make()->danger()->title('Unable to export review — missing context.')->send();
+            Notification::make()->danger()->title(__('localization.review.unable_export_missing_context'))->send();
            return;
        }
@ -446,7 +537,7 @@ public static function executeExport(TenantReview $review): void
        if ($service->checkActiveRunForReview($review)) {
            OperationUxPresenter::alreadyQueuedToast(OperationRunType::ReviewPackGenerate->value)
-                ->body('An executive pack export is already queued or running for this review.')
+                ->body(__('localization.review.export_already_queued_body'))
                ->send();
            return;
@ -457,8 +548,12 @@ public static function executeExport(TenantReview $review): void
                'include_pii' => true,
                'include_operations' => true,
            ]);
        } catch (WorkspaceEntitlementBlockedException $exception) {
            Notification::make()->warning()->title(__('localization.review.executive_pack_export_unavailable'))->body($exception->getMessage())->send();
            return;
        } catch (\Throwable $throwable) {
-            Notification::make()->danger()->title('Unable to export executive pack')->body($throwable->getMessage())->send();
+            Notification::make()->danger()->title(__('localization.review.unable_export_executive_pack'))->body($throwable->getMessage())->send();
            return;
        }
@ -469,11 +564,11 @@ public static function executeExport(TenantReview $review): void
        if (! $pack->wasRecentlyCreated) {
            Notification::make()
                ->success()
-                ->title('Executive pack already available')
+                ->title(__('localization.review.executive_pack_already_available'))
-                ->body('A matching executive pack already exists for this review.')
+                ->body(__('localization.review.executive_pack_already_available_body'))
                ->actions([
                    Actions\Action::make('view_pack')
-                        ->label('View pack')
+                        ->label(__('localization.review.view_pack'))
                        ->url(ReviewPackResource::getUrl('view', ['record' => $pack], tenant: $review->tenant)),
                ])
                ->send();
@ -482,7 +577,7 @@ public static function executeExport(TenantReview $review): void
        }
        OperationUxPresenter::queuedToast(OperationRunType::ReviewPackGenerate->value)
-            ->body('The executive pack is being generated in the background.')
+            ->body(__('localization.review.executive_pack_generating_background'))
            ->send();
    }
@ -522,7 +617,7 @@ private static function evidenceSnapshotOptions(): array
                    '#%d · %s · %s',
                    (int) $snapshot->getKey(),
                    BadgeCatalog::spec(BadgeDomain::EvidenceCompleteness, $snapshot->completeness_state)->label,
-                    $snapshot->generated_at?->format('Y-m-d H:i') ?? 'Pending'
+                    $snapshot->generated_at?->format('Y-m-d H:i') ?? __('localization.review.pending')
                ),
            ])
            ->all();
@ -546,7 +641,7 @@ private static function summaryPresentation(TenantReview $record): array
        $findingOutcomes = is_array($summary['finding_outcomes'] ?? null) ? $summary['finding_outcomes'] : [];
        if ($findingOutcomeSummary !== null) {
-            $highlights[] = 'Terminal outcomes: '.$findingOutcomeSummary.'.';
+            $highlights[] = __('localization.review.terminal_outcomes').': '.$findingOutcomeSummary.'.';
        }
        return [
@ -558,12 +653,12 @@ private static function summaryPresentation(TenantReview $record): array
            'publish_blockers' => is_array($summary['publish_blockers'] ?? null) ? $summary['publish_blockers'] : [],
            'context_links' => static::summaryContextLinks($record),
            'metrics' => [
-                ['label' => 'Findings', 'value' => (string) ($summary['finding_count'] ?? 0)],
+                ['label' => __('localization.review.findings'), 'value' => (string) ($summary['finding_count'] ?? 0)],
-                ['label' => 'Reports', 'value' => (string) ($summary['report_count'] ?? 0)],
+                ['label' => __('localization.review.reports'), 'value' => (string) ($summary['report_count'] ?? 0)],
-                ['label' => 'Operations', 'value' => (string) ($summary['operation_count'] ?? 0)],
+                ['label' => __('localization.review.operations'), 'value' => (string) ($summary['operation_count'] ?? 0)],
-                ['label' => 'Sections', 'value' => (string) ($summary['section_count'] ?? 0)],
+                ['label' => __('localization.review.sections'), 'value' => (string) ($summary['section_count'] ?? 0)],
-                ['label' => 'Pending verification', 'value' => (string) ($findingOutcomes[FindingOutcomeSemantics::OUTCOME_RESOLVED_PENDING_VERIFICATION] ?? 0)],
+                ['label' => __('localization.review.pending_verification'), 'value' => (string) ($findingOutcomes[FindingOutcomeSemantics::OUTCOME_RESOLVED_PENDING_VERIFICATION] ?? 0)],
-                ['label' => 'Verified cleared', 'value' => (string) ($findingOutcomes[FindingOutcomeSemantics::OUTCOME_VERIFIED_CLEARED] ?? 0)],
+                ['label' => __('localization.review.verified_cleared'), 'value' => (string) ($findingOutcomes[FindingOutcomeSemantics::OUTCOME_VERIFIED_CLEARED] ?? 0)],
            ],
        ];
    }
@ -577,28 +672,37 @@ private static function summaryContextLinks(TenantReview $record): array
        if (is_numeric($record->operation_run_id)) {
            $links[] = [
-                'title' => 'Operation',
+                'title' => __('localization.review.operation'),
-                'label' => 'Open operation',
+                'label' => __('localization.review.open_operation'),
                'url' => OperationRunLinks::tenantlessView((int) $record->operation_run_id),
-                'description' => 'Inspect the latest review composition or refresh run.',
+                'description' => __('localization.review.operation_description'),
            ];
        }
        if ($record->currentExportReviewPack && $record->tenant) {
            $links[] = [
-                'title' => 'Executive pack',
+                'title' => __('localization.review.executive_pack'),
-                'label' => 'View executive pack',
+                'label' => __('localization.review.view_executive_pack'),
                'url' => ReviewPackResource::getUrl('view', ['record' => $record->currentExportReviewPack], tenant: $record->tenant),
-                'description' => 'Open the current export that belongs to this review.',
+                'description' => __('localization.review.executive_pack_description'),
            ];
        }
        if ($record->tenant) {
            $links[] = [
                'title' => __('localization.review.customer_workspace'),
                'label' => __('localization.review.open_customer_workspace'),
                'url' => CustomerReviewWorkspace::tenantPrefilterUrl($record->tenant),
                'description' => __('localization.review.customer_workspace_description'),
            ];
        }
        if ($record->evidenceSnapshot && $record->tenant) {
            $links[] = [
-                'title' => 'Evidence snapshot',
+                'title' => __('localization.review.evidence_snapshot'),
-                'label' => 'View evidence snapshot',
+                'label' => __('localization.review.view_evidence_snapshot'),
                'url' => EvidenceSnapshotResource::getUrl('view', ['record' => $record->evidenceSnapshot], tenant: $record->tenant),
-                'description' => 'Return to the evidence basis behind this review.',
+                'description' => __('localization.review.evidence_snapshot_description'),
            ];
        }
--- a/apps/platform/app/Filament/Resources/TenantReviewResource/Pages/ViewTenantReview.php
+++ b/apps/platform/app/Filament/Resources/TenantReviewResource/Pages/ViewTenantReview.php
@ -4,12 +4,15 @@
 namespace App\Filament\Resources\TenantReviewResource\Pages;
 use App\Filament\Pages\Reviews\CustomerReviewWorkspace;
 use App\Filament\Resources\TenantReviewResource;
 use App\Models\Tenant;
 use App\Models\TenantReview;
 use App\Models\User;
 use App\Services\Audit\WorkspaceAuditLogger;
 use App\Services\TenantReviews\TenantReviewLifecycleService;
 use App\Services\TenantReviews\TenantReviewService;
 use App\Support\Audit\AuditActionId;
 use App\Support\Auth\Capabilities;
 use App\Support\Rbac\UiEnforcement;
 use App\Support\TenantReviewStatus;
@ -24,6 +27,13 @@ class ViewTenantReview extends ViewRecord
 {
    protected static string $resource = TenantReviewResource::class;
    public function mount(int|string $record): void
    {
        parent::mount($record);
        $this->auditCustomerWorkspaceOpen();
    }
    protected function resolveRecord(int|string $key): Model
    {
        return TenantReviewResource::resolveScopedRecordOrFail($key);
@ -69,7 +79,7 @@ protected function getHeaderActions(): array
                ->label('Danger')
                ->icon('heroicon-o-archive-box')
                ->color('danger')
-                ->visible(fn (): bool => ! $this->record->statusEnum()->isTerminal()),
+                ->visible(fn (): bool => ! $this->isCustomerWorkspaceView() && ! $this->record->statusEnum()->isTerminal()),
        ]));
    }
@ -85,6 +95,10 @@ private function primaryLifecycleAction(): ?Actions\Action
    private function primaryLifecycleActionName(): ?string
    {
        if ($this->isCustomerWorkspaceView()) {
            return null;
        }
        if ((string) $this->record->status === TenantReviewStatus::Published->value) {
            return 'export_executive_pack';
        }
@ -122,6 +136,10 @@ private function secondaryLifecycleActions(): array
     */
    private function secondaryLifecycleActionNames(): array
    {
        if ($this->isCustomerWorkspaceView()) {
            return [];
        }
        $names = [];
        if ($this->record->isMutable()) {
@ -178,7 +196,6 @@ private function refreshReviewAction(): Actions\Action
                }),
        )
            ->requireCapability(Capabilities::TENANT_REVIEW_MANAGE)
            ->preserveVisibility()
            ->apply();
    }
@ -232,7 +249,7 @@ private function publishReviewAction(): Actions\Action
    private function exportExecutivePackAction(): Actions\Action
    {
-        return UiEnforcement::forAction(
+        $action = UiEnforcement::forAction(
            Actions\Action::make('export_executive_pack')
                ->label('Export executive pack')
                ->icon('heroicon-o-arrow-down-tray')
@ -241,11 +258,17 @@ private function exportExecutivePackAction(): Actions\Action
                    TenantReviewStatus::Ready->value,
                    TenantReviewStatus::Published->value,
                ], true))
                ->disabled(fn (): bool => TenantReviewResource::reviewPackGenerationBlocked($this->record->tenant))
                ->action(fn (): mixed => TenantReviewResource::executeExport($this->record)),
        )
            ->requireCapability(Capabilities::TENANT_REVIEW_MANAGE)
            ->preserveVisibility()
            ->preserveDisabled()
            ->apply();
        $action->tooltip(fn (): ?string => TenantReviewResource::reviewPackGenerationActionTooltip($this->record->tenant));
        return $action;
    }
    private function createNextReviewAction(): Actions\Action
@ -319,4 +342,39 @@ private function archiveReviewAction(): Actions\Action
            ->preserveVisibility()
            ->apply();
    }
    private function isCustomerWorkspaceView(): bool
    {
        return request()->boolean(CustomerReviewWorkspace::DETAIL_CONTEXT_QUERY_KEY);
    }
    private function auditCustomerWorkspaceOpen(): void
    {
        if (! $this->isCustomerWorkspaceView()) {
            return;
        }
        $user = auth()->user();
        $tenant = $this->record->tenant;
        if (! $user instanceof User || ! $tenant instanceof Tenant) {
            return;
        }
        app(WorkspaceAuditLogger::class)->log(
            workspace: $tenant->workspace,
            action: AuditActionId::TenantReviewOpened,
            context: [
                'metadata' => [
                    'review_id' => (int) $this->record->getKey(),
                    'source_surface' => 'customer_review_workspace',
                ],
            ],
            actor: $user,
            resourceType: 'tenant_review',
            resourceId: (string) $this->record->getKey(),
            targetLabel: sprintf('Tenant review #%d', (int) $this->record->getKey()),
            tenant: $tenant,
        );
    }
 }
--- a/apps/platform/app/Filament/System/Pages/Dashboard.php
+++ b/apps/platform/app/Filament/System/Pages/Dashboard.php
@ -6,6 +6,9 @@
 use App\Filament\System\Widgets\ControlTowerHealthIndicator;
 use App\Filament\System\Widgets\ControlTowerKpis;
 use App\Filament\System\Widgets\CustomerHealthKpis;
 use App\Filament\System\Widgets\CustomerHealthTopWorkspaces;
 use App\Filament\System\Widgets\ProductTelemetryKpis;
 use App\Filament\System\Widgets\ControlTowerRecentFailures;
 use App\Filament\System\Widgets\ControlTowerTopOffenders;
 use App\Models\PlatformUser;
@ -25,6 +28,11 @@ class Dashboard extends BaseDashboard
 {
    public string $window = SystemConsoleWindow::LastDay;
    public function getTitle(): string
    {
        return __('localization.dashboard.system_title');
    }
    /**
     * @param  array<mixed>  $parameters
     */
@ -61,9 +69,24 @@ public function getWidgets(): array
    {
        return [
            ControlTowerHealthIndicator::class,
-            ControlTowerKpis::class,
+            new WidgetConfiguration(CustomerHealthKpis::class, [
-            ControlTowerTopOffenders::class,
+                'window' => $this->window,
-            ControlTowerRecentFailures::class,
+            ]),
            new WidgetConfiguration(CustomerHealthTopWorkspaces::class, [
                'window' => $this->window,
            ]),
            new WidgetConfiguration(ControlTowerKpis::class, [
                'window' => $this->window,
            ]),
            new WidgetConfiguration(ProductTelemetryKpis::class, [
                'window' => $this->window,
            ]),
            new WidgetConfiguration(ControlTowerTopOffenders::class, [
                'window' => $this->window,
            ]),
            new WidgetConfiguration(ControlTowerRecentFailures::class, [
                'window' => $this->window,
            ]),
        ];
    }
@ -91,12 +114,12 @@ protected function getHeaderActions(): array
        return [
            Action::make('set_window')
-                ->label('Time window')
+                ->label(__('localization.dashboard.time_window'))
                ->icon('heroicon-o-clock')
                ->color('gray')
                ->form([
                    Select::make('window')
-                        ->label('Window')
+                        ->label(__('localization.dashboard.window'))
                        ->options(SystemConsoleWindow::options())
                        ->default($this->window)
                        ->required(),
@ -112,7 +135,7 @@ protected function getHeaderActions(): array
                }),
            Action::make('enter_break_glass')
-                ->label('Enter break-glass mode')
+                ->label(__('localization.dashboard.enter_break_glass'))
                ->color('danger')
                ->visible(fn (): bool => $canUseBreakGlass && ! $breakGlass->isActive())
                ->requiresConfirmation()
@ -140,13 +163,13 @@ protected function getHeaderActions(): array
                    $breakGlass->start($user, (string) ($data['reason'] ?? ''));
                    Notification::make()
-                        ->title('Recovery mode enabled')
+                        ->title(__('localization.dashboard.recovery_mode_enabled'))
                        ->success()
                        ->send();
                }),
            Action::make('exit_break_glass')
-                ->label('Exit break-glass')
+                ->label(__('localization.dashboard.exit_break_glass'))
                ->color('gray')
                ->visible(fn (): bool => $canUseBreakGlass && $breakGlass->isActive())
                ->requiresConfirmation()
@ -162,7 +185,7 @@ protected function getHeaderActions(): array
                    $breakGlass->exit($user);
                    Notification::make()
-                        ->title('Recovery mode ended')
+                        ->title(__('localization.dashboard.recovery_mode_ended'))
                        ->success()
                        ->send();
                }),
--- a/apps/platform/app/Filament/System/Pages/Directory/Concerns/BuildsCustomerHealthDecisionData.php
+++ b/apps/platform/app/Filament/System/Pages/Directory/Concerns/BuildsCustomerHealthDecisionData.php
@ -0,0 +1,144 @@
 <?php
 declare(strict_types=1);
 namespace App\Filament\System\Pages\Directory\Concerns;
 use App\Support\Badges\BadgeDomain;
 use App\Support\Badges\BadgeRenderer;
 use App\Support\CustomerHealth\CustomerHealthDimensionCatalog;
 use App\Support\SystemConsole\SystemConsoleWindow;
 trait BuildsCustomerHealthDecisionData
 {
    /**
     * @param  array{
     *     overall_level: string,
     *     dimensions: array<string, array{label: string, level: string, windowed: bool}>,
     *     dominant_dimension_keys: list<string>
     * }  $summary
     * @return array{
     *     overall: array{label: string, color: string, icon: string|null},
     *     reason: string,
     *     impact: string,
     *     recommended_action: string,
     *     dominant_dimensions: list<array{label: string, color: string, icon: string|null}>,
     *     window_label: string
     * }
     */
    protected function buildCustomerHealthDecision(array $summary, SystemConsoleWindow $window, string $surface): array
    {
        $overallBadge = BadgeRenderer::spec(BadgeDomain::SystemHealth, $summary['overall_level']);
        $dominantDimensions = collect($summary['dominant_dimension_keys'])
            ->map(function (string $dimensionKey) use ($summary): ?array {
                $dimension = $summary['dimensions'][$dimensionKey] ?? null;
                if (! is_array($dimension)) {
                    return null;
                }
                $badge = BadgeRenderer::spec(BadgeDomain::SystemHealth, $dimension['level']);
                return [
                    'label' => $dimension['label'],
                    'color' => $badge->color,
                    'icon' => $badge->icon,
                ];
            })
            ->filter()
            ->take(2)
            ->values()
            ->all();
        $dominantLabels = array_map(static fn (array $dimension): string => $dimension['label'], $dominantDimensions);
        $primaryDimension = $summary['dominant_dimension_keys'][0] ?? null;
        return [
            'overall' => [
                'label' => $overallBadge->label,
                'color' => $overallBadge->color,
                'icon' => $overallBadge->icon,
            ],
            'reason' => $this->customerHealthReason($dominantLabels),
            'impact' => $this->customerHealthImpact($summary['overall_level'], $primaryDimension),
            'recommended_action' => $this->customerHealthRecommendedAction($summary['overall_level'], $primaryDimension, $surface),
            'dominant_dimensions' => $dominantDimensions,
            'window_label' => SystemConsoleWindow::options()[$window->value] ?? 'Last 24 hours',
        ];
    }
    /**
     * @param  list<string>  $dominantLabels
     */
    protected function customerHealthReason(array $dominantLabels): string
    {
        if ($dominantLabels === []) {
            return 'No active health drivers are pressuring this workspace right now.';
        }
        $labelPrefix = count($dominantLabels) === 1 ? 'Top driver' : 'Top drivers';
        return $labelPrefix.': '.implode(', ', $dominantLabels);
    }
    protected function customerHealthImpact(string $overallLevel, ?string $primaryDimension): string
    {
        if ($overallLevel === 'ok') {
            return 'Tracked onboarding, provider, operational, governance, review-pack, and engagement signals are currently stable.';
        }
        if ($overallLevel === 'unknown') {
            return 'Some required health truth is missing or stale, so this workspace cannot be treated as healthy yet.';
        }
        return match ($primaryDimension) {
            CustomerHealthDimensionCatalog::ONBOARDING_READINESS => $overallLevel === 'critical'
                ? 'Onboarding readiness is blocked, so this workspace cannot be treated as operationally ready.'
                : 'Onboarding readiness still needs follow-up before this workspace can be treated as fully stable.',
            CustomerHealthDimensionCatalog::PROVIDER_CONNECTION_HEALTH => $overallLevel === 'critical'
                ? 'Default provider consent or verification is blocking reliable tenant management.'
                : 'Provider connectivity has degraded and may impact reliable tenant management.',
            CustomerHealthDimensionCatalog::OPERATIONAL_STABILITY => $overallLevel === 'critical'
                ? 'Failed or stuck operations are actively putting delivery at risk.'
                : 'Recent operational noise is starting to erode delivery confidence.',
            CustomerHealthDimensionCatalog::GOVERNANCE_PRESSURE => $overallLevel === 'critical'
                ? 'High-severity or expired governance pressure needs immediate review.'
                : 'Governance pressure is active and should be reviewed before it escalates.',
            CustomerHealthDimensionCatalog::REVIEW_PACK_READINESS => $overallLevel === 'critical'
                ? 'Recent review-pack work is unusable or expired, so review readiness is blocked.'
                : 'Review-pack readiness is incomplete, so recent review evidence may not be usable yet.',
            CustomerHealthDimensionCatalog::ENGAGEMENT_FRESHNESS => $overallLevel === 'critical'
                ? 'Recent product activity is missing, which suggests active usage may be deteriorating.'
                : 'Recent product activity is thinning out and may indicate adoption drift.',
            default => $overallLevel === 'critical'
                ? 'This workspace needs immediate operator follow-up.'
                : 'This workspace needs follow-up soon to prevent further drift.',
        };
    }
    protected function customerHealthRecommendedAction(string $overallLevel, ?string $primaryDimension, string $surface): string
    {
        if ($overallLevel === 'ok') {
            return 'Continue normal monitoring from the system dashboard.';
        }
        return match ($primaryDimension) {
            CustomerHealthDimensionCatalog::ONBOARDING_READINESS => $surface === 'tenant'
                ? 'Confirm the tenant onboarding state with the responsible tenant admin and clear the blocking step.'
                : 'Open the affected tenant below and confirm which onboarding step is blocked.',
            CustomerHealthDimensionCatalog::PROVIDER_CONNECTION_HEALTH => $surface === 'tenant'
                ? 'Review connectivity signals below and confirm the default provider consent and verification state.'
                : 'Open the affected tenant below and review the default provider connection state.',
            CustomerHealthDimensionCatalog::OPERATIONAL_STABILITY => 'Review recent operations below and triage failed or stuck runs first.',
            CustomerHealthDimensionCatalog::GOVERNANCE_PRESSURE => $surface === 'tenant'
                ? 'Review governance findings or exception pressure for this tenant before proceeding.'
                : 'Open the affected tenant below and review governance findings or exceptions.',
            CustomerHealthDimensionCatalog::REVIEW_PACK_READINESS => 'Check recent review-pack activity and confirm that a usable pack exists for the current window.',
            CustomerHealthDimensionCatalog::ENGAGEMENT_FRESHNESS => $surface === 'tenant'
                ? 'Confirm whether missing recent product activity is expected for this tenant.'
                : 'Confirm whether missing recent product activity is expected across this workspace.',
            default => 'Review the diagnostics below to confirm which source truth needs operator follow-up.',
        };
    }
 }
--- a/apps/platform/app/Filament/System/Pages/Directory/ViewTenant.php
+++ b/apps/platform/app/Filament/System/Pages/Directory/ViewTenant.php
@ -4,20 +4,25 @@
 namespace App\Filament\System\Pages\Directory;
 use App\Filament\System\Pages\Directory\Concerns\BuildsCustomerHealthDecisionData;
 use App\Models\OperationRun;
 use App\Models\PlatformUser;
 use App\Models\ProviderConnection;
 use App\Models\Tenant;
 use App\Models\TenantPermission;
 use App\Support\Auth\PlatformCapabilities;
 use App\Support\CustomerHealth\WorkspaceHealthSummaryQuery;
 use App\Support\OperationCatalog;
 use App\Support\System\SystemDirectoryLinks;
 use App\Support\System\SystemOperationRunLinks;
 use App\Support\SystemConsole\SystemConsoleWindow;
 use Filament\Pages\Page;
 use Illuminate\Support\Collection;
 class ViewTenant extends Page
 {
    use BuildsCustomerHealthDecisionData;
    protected static bool $shouldRegisterNavigation = false;
    protected static ?string $slug = 'directory/tenants/{tenant}';
@ -102,4 +107,26 @@ public function runsUrl(): string
    {
        return SystemOperationRunLinks::index();
    }
    /**
     * @return array{
     *     overall: array{label: string, color: string, icon: string|null},
     *     reason: string,
     *     impact: string,
     *     recommended_action: string,
     *     dominant_dimensions: list<array{label: string, color: string, icon: string|null}>,
     *     window_label: string
     * }|null
     */
    public function customerHealthDecision(): ?array
    {
        $window = SystemConsoleWindow::fromNullable(request()->query('window'));
        $summary = app(WorkspaceHealthSummaryQuery::class)->summaryForWorkspace((int) $this->tenant->workspace_id, $window);
        if (! is_array($summary)) {
            return null;
        }
        return $this->buildCustomerHealthDecision($summary, $window, 'tenant');
    }
 }
--- a/apps/platform/app/Filament/System/Pages/Directory/ViewWorkspace.php
+++ b/apps/platform/app/Filament/System/Pages/Directory/ViewWorkspace.php
@ -4,19 +4,31 @@
 namespace App\Filament\System\Pages\Directory;
 use App\Filament\System\Pages\Directory\Concerns\BuildsCustomerHealthDecisionData;
 use App\Models\OperationRun;
 use App\Models\PlatformUser;
 use App\Models\Tenant;
 use App\Models\Workspace;
 use App\Services\Entitlements\WorkspaceCommercialLifecycleResolver;
 use App\Services\Entitlements\WorkspaceEntitlementResolver;
 use App\Services\Settings\SettingsWriter;
 use App\Support\Auth\PlatformCapabilities;
 use App\Support\CustomerHealth\WorkspaceHealthSummaryQuery;
 use App\Support\OperationCatalog;
 use App\Support\System\SystemDirectoryLinks;
 use App\Support\System\SystemOperationRunLinks;
 use App\Support\SystemConsole\SystemConsoleWindow;
 use Filament\Actions\Action;
 use Filament\Forms\Components\Select;
 use Filament\Forms\Components\Textarea;
 use Filament\Notifications\Notification;
 use Filament\Pages\Page;
 use Illuminate\Support\Collection;
 class ViewWorkspace extends Page
 {
    use BuildsCustomerHealthDecisionData;
    protected static bool $shouldRegisterNavigation = false;
    protected static ?string $slug = 'directory/workspaces/{workspace}';
@ -79,4 +91,105 @@ public function runsUrl(): string
    {
        return SystemOperationRunLinks::index();
    }
    /**
     * @return array<string, mixed>
     */
    public function workspaceEntitlementSummary(): array
    {
        return app(WorkspaceEntitlementResolver::class)->summary($this->workspace);
    }
    /**
     * @return array<string, mixed>
     */
    public function workspaceCommercialLifecycleSummary(): array
    {
        return app(WorkspaceCommercialLifecycleResolver::class)->summary($this->workspace);
    }
    /**
     * @return array<Action>
     */
    protected function getHeaderActions(): array
    {
        return [
            Action::make('change_commercial_state')
                ->label('Change commercial state')
                ->icon('heroicon-o-adjustments-horizontal')
                ->color('warning')
                ->visible(fn (): bool => $this->canManageCommercialLifecycle())
                ->requiresConfirmation()
                ->modalHeading('Change commercial state')
                ->modalDescription('This changes the workspace commercial lifecycle overlay. The rationale is audited and affects onboarding activation and review-pack starts.')
                ->form([
                    Select::make('state')
                        ->label('Commercial state')
                        ->options(WorkspaceCommercialLifecycleResolver::stateLabels())
                        ->required()
                        ->default(fn (): string => (string) ($this->workspaceCommercialLifecycleSummary()['state'] ?? WorkspaceCommercialLifecycleResolver::STATE_ACTIVE_PAID)),
                    Textarea::make('reason')
                        ->label('Rationale')
                        ->required()
                        ->minLength(5)
                        ->maxLength(500)
                        ->rows(4),
                ])
                ->action(function (array $data, SettingsWriter $settingsWriter): void {
                    $actor = auth('platform')->user();
                    if (! $actor instanceof PlatformUser) {
                        abort(403);
                    }
                    if (! $actor->hasCapability(PlatformCapabilities::COMMERCIAL_LIFECYCLE_MANAGE)) {
                        abort(403);
                    }
                    $settingsWriter->updateWorkspaceCommercialLifecycle(
                        actor: $actor,
                        workspace: $this->workspace,
                        state: (string) ($data['state'] ?? ''),
                        reason: (string) ($data['reason'] ?? ''),
                    );
                    $this->workspace->refresh();
                    Notification::make()
                        ->title('Commercial state updated')
                        ->success()
                        ->send();
                }),
        ];
    }
    private function canManageCommercialLifecycle(): bool
    {
        $user = auth('platform')->user();
        return $user instanceof PlatformUser
            && $user->hasCapability(PlatformCapabilities::COMMERCIAL_LIFECYCLE_MANAGE);
    }
    /**
     * @return array{
     *     overall: array{label: string, color: string, icon: string|null},
     *     reason: string,
     *     impact: string,
     *     recommended_action: string,
     *     dominant_dimensions: list<array{label: string, color: string, icon: string|null}>,
     *     window_label: string
     * }|null
     */
    public function customerHealthDecision(): ?array
    {
        $window = SystemConsoleWindow::fromNullable(request()->query('window'));
        $summary = app(WorkspaceHealthSummaryQuery::class)->summaryForWorkspace($this->workspace, $window);
        if (! is_array($summary)) {
            return null;
        }
        return $this->buildCustomerHealthDecision($summary, $window, 'workspace');
    }
 }
--- a/apps/platform/app/Filament/System/Pages/Ops/Controls.php
+++ b/apps/platform/app/Filament/System/Pages/Ops/Controls.php
@ -57,11 +57,6 @@ public static function canAccess(): bool
            && $user->hasCapability(PlatformCapabilities::OPS_CONTROLS_MANAGE);
    }
    public function mount(): void
    {
        abort_unless(static::canAccess(), 403);
    }
    public function getHeader(): ?View
    {
        return view('filament.system.pages.ops.partials.controls-header', [
@ -80,6 +75,9 @@ protected function getHeaderActions(): array
            $this->pauseRestoreExecuteAction(),
            $this->resumeRestoreExecuteAction(),
            $this->viewHistoryRestoreExecuteAction(),
            $this->pauseAiExecutionAction(),
            $this->resumeAiExecutionAction(),
            $this->viewHistoryAiExecutionAction(),
        ];
    }
@ -199,6 +197,21 @@ public function viewHistoryRestoreExecuteAction(): Action
        return $this->historyActionFor('restore.execute');
    }
    public function pauseAiExecutionAction(): Action
    {
        return $this->pauseActionFor('ai.execution');
    }
    public function resumeAiExecutionAction(): Action
    {
        return $this->resumeActionFor('ai.execution');
    }
    public function viewHistoryAiExecutionAction(): Action
    {
        return $this->historyActionFor('ai.execution');
    }
    private function pauseActionFor(string $controlKey): Action
    {
        $label = app(OperationalControlCatalog::class)->label($controlKey);
@ -213,7 +226,7 @@ private function pauseActionFor(string $controlKey): Action
            ->form($this->pauseFormSchema($controlKey))
            ->action(function (array $data, AuditRecorder $auditRecorder, WorkspaceAuditLogger $workspaceAuditLogger) use ($controlKey, $label): void {
                $actor = $this->controlsActor();
-                [$scopeType, $workspace, $reasonText, $expiresAt] = $this->normalizePauseInput($data);
+                [$scopeType, $workspace, $reasonText, $expiresAt] = $this->normalizePauseInput($controlKey, $data);
                $scopeQuery = $this->activationScopeQuery($controlKey, $scopeType, $workspace);
@ -273,7 +286,7 @@ private function resumeActionFor(string $controlKey): Action
            ->form($this->resumeFormSchema($controlKey))
            ->action(function (array $data, AuditRecorder $auditRecorder, WorkspaceAuditLogger $workspaceAuditLogger) use ($controlKey, $label): void {
                $actor = $this->controlsActor();
-                [$scopeType, $workspace] = $this->normalizeResumeInput($data);
+                [$scopeType, $workspace] = $this->normalizeResumeInput($controlKey, $data);
                $activation = $this->activationScopeQuery($controlKey, $scopeType, $workspace)
                    ->notExpired()
@ -331,11 +344,8 @@ private function pauseFormSchema(string $controlKey): array
        return [
            Radio::make('scope_type')
                ->label('Scope')
-                ->options([
+                ->options($this->scopeOptions($controlKey))
-                    'global' => 'Global',
+                ->default($this->defaultScopeFor($controlKey))
                    'workspace' => 'One workspace',
                ])
                ->default('global')
                ->live()
                ->required(),
@ -395,11 +405,8 @@ private function resumeFormSchema(string $controlKey): array
        return [
            Radio::make('scope_type')
                ->label('Scope')
-                ->options([
+                ->options($this->scopeOptions($controlKey))
-                    'global' => 'Global',
+                ->default($this->defaultScopeFor($controlKey))
                    'workspace' => 'One workspace',
                ])
                ->default('global')
                ->live()
                ->required(),
@ -456,9 +463,9 @@ private function controlsActor(): PlatformUser
    /**
     * @return array{0: string, 1: ?Workspace, 2: string, 3: ?CarbonInterface}
     */
-    private function normalizePauseInput(array $data): array
+    private function normalizePauseInput(string $controlKey, array $data): array
    {
-        [$scopeType, $workspace] = $this->resolveScopeInput($data);
+        [$scopeType, $workspace] = $this->resolveScopeInput($controlKey, $data);
        $reasonText = trim((string) ($data['reason_text'] ?? ''));
        if ($reasonText === '') {
@ -485,19 +492,20 @@ private function normalizePauseInput(array $data): array
    /**
     * @return array{0: string, 1: ?Workspace}
     */
-    private function normalizeResumeInput(array $data): array
+    private function normalizeResumeInput(string $controlKey, array $data): array
    {
-        return $this->resolveScopeInput($data);
+        return $this->resolveScopeInput($controlKey, $data);
    }
    /**
     * @return array{0: string, 1: ?Workspace}
     */
-    private function resolveScopeInput(array $data): array
+    private function resolveScopeInput(string $controlKey, array $data): array
    {
        $scopeType = (string) ($data['scope_type'] ?? 'global');
        $supportedScopes = app(OperationalControlCatalog::class)->definition($controlKey)['supported_scopes'] ?? ['global'];
-        if (! in_array($scopeType, ['global', 'workspace'], true)) {
+        if (! in_array($scopeType, $supportedScopes, true)) {
            throw ValidationException::withMessages([
                'scope_type' => 'Invalid scope selected.',
            ]);
@ -526,6 +534,26 @@ private function resolveScopeInput(array $data): array
        return [$scopeType, $workspace];
    }
    /**
     * @return array<string, string>
     */
    private function scopeOptions(string $controlKey): array
    {
        $supportedScopes = app(OperationalControlCatalog::class)->definition($controlKey)['supported_scopes'];
        return Arr::only([
            'global' => 'Global',
            'workspace' => 'One workspace',
        ], $supportedScopes);
    }
    private function defaultScopeFor(string $controlKey): string
    {
        $supportedScopes = app(OperationalControlCatalog::class)->definition($controlKey)['supported_scopes'];
        return $supportedScopes[0] ?? 'global';
    }
    private function activationScopeQuery(string $controlKey, string $scopeType, ?Workspace $workspace): \Illuminate\Database\Eloquent\Builder
    {
        $query = OperationalControlActivation::query()
--- a/apps/platform/app/Filament/System/Pages/Ops/Runbooks.php
+++ b/apps/platform/app/Filament/System/Pages/Ops/Runbooks.php
@ -4,26 +4,9 @@
 namespace App\Filament\System\Pages\Ops;
 use App\Models\OperationRun;
 use App\Models\PlatformUser;
 use App\Models\Tenant;
 use App\Services\Auth\BreakGlassSession;
 use App\Services\Runbooks\FindingsLifecycleBackfillRunbookService;
 use App\Services\Runbooks\FindingsLifecycleBackfillScope;
 use App\Services\Runbooks\RunbookReason;
 use App\Services\System\AllowedTenantUniverse;
 use App\Support\Auth\PlatformCapabilities;
 use App\Support\OpsUx\OperationUxPresenter;
 use App\Support\OperationalControls\OperationalControlBlockedException;
 use App\Support\System\SystemOperationRunLinks;
 use Filament\Actions\Action;
 use Filament\Forms\Components\Radio;
 use Filament\Forms\Components\Select;
 use Filament\Forms\Components\Textarea;
 use Filament\Forms\Components\TextInput;
 use Filament\Notifications\Notification;
 use Filament\Pages\Page;
 use Illuminate\Validation\ValidationException;
 class Runbooks extends Page
 {
@ -37,53 +20,6 @@ class Runbooks extends Page
    protected string $view = 'filament.system.pages.ops.runbooks';
    public string $findingsScopeMode = FindingsLifecycleBackfillScope::MODE_ALL_TENANTS;
    public ?int $findingsTenantId = null;
    public string $scopeMode = FindingsLifecycleBackfillScope::MODE_ALL_TENANTS;
    public ?int $tenantId = null;
    /**
     * @var array{affected_count: int, total_count: int, estimated_tenants?: int|null}|null
     */
    public ?array $findingsPreflight = null;
    /**
     * @var array{affected_count: int, total_count: int, estimated_tenants?: int|null}|null
     */
    public ?array $preflight = null;
    public function findingsScopeLabel(): string
    {
        if ($this->findingsScopeMode === FindingsLifecycleBackfillScope::MODE_ALL_TENANTS) {
            return 'All tenants';
        }
        $tenantName = $this->selectedTenantName($this->findingsTenantId);
        if ($tenantName !== null) {
            return "Single tenant ({$tenantName})";
        }
        return $this->findingsTenantId !== null ? "Single tenant (#{$this->findingsTenantId})" : 'Single tenant';
    }
    public function findingsLastRun(): ?OperationRun
    {
        return $this->lastRunForType(FindingsLifecycleBackfillRunbookService::RUNBOOK_KEY);
    }
    public function selectedTenantName(?int $tenantId): ?string
    {
        if ($tenantId === null) {
            return null;
        }
        return Tenant::query()->whereKey($tenantId)->value('name');
    }
    public static function canAccess(): bool
    {
        $user = auth('platform')->user();
@ -95,231 +31,4 @@ public static function canAccess(): bool
        return $user->hasCapability(PlatformCapabilities::OPS_VIEW)
            && $user->hasCapability(PlatformCapabilities::RUNBOOKS_VIEW);
    }
    /**
     * @return array<Action>
     */
    protected function getHeaderActions(): array
    {
        return [
            Action::make('preflight')
                ->label('Preflight')
                ->color('gray')
                ->icon('heroicon-o-magnifying-glass')
                ->form($this->findingsScopeForm())
                ->action(function (array $data, FindingsLifecycleBackfillRunbookService $runbookService): void {
                    $scope = $this->trustedFindingsScopeFromFormData($data, app(AllowedTenantUniverse::class));
                    $this->findingsScopeMode = $scope->mode;
                    $this->findingsTenantId = $scope->tenantId;
                    $this->scopeMode = $scope->mode;
                    $this->tenantId = $scope->tenantId;
                    $this->findingsPreflight = $runbookService->preflight($scope);
                    $this->preflight = $this->findingsPreflight;
                    Notification::make()
                        ->title('Preflight complete')
                        ->success()
                        ->send();
                }),
            Action::make('run')
                ->label('Run…')
                ->icon('heroicon-o-play')
                ->color('danger')
                ->requiresConfirmation()
                ->modalHeading('Run: Rebuild Findings Lifecycle')
                ->modalDescription('This operation may modify customer data. Review the preflight and confirm before running.')
                ->form($this->findingsRunForm())
                ->disabled(fn (): bool => ! is_array($this->findingsPreflight) || (int) ($this->findingsPreflight['affected_count'] ?? 0) <= 0)
                ->action(function (array $data, FindingsLifecycleBackfillRunbookService $runbookService): void {
                    if (! is_array($this->findingsPreflight) || (int) ($this->findingsPreflight['affected_count'] ?? 0) <= 0) {
                        throw ValidationException::withMessages([
                            'preflight' => 'Run preflight first.',
                        ]);
                    }
                    $scope = $this->trustedFindingsScopeFromState(app(AllowedTenantUniverse::class));
                    $user = auth('platform')->user();
                    if (! $user instanceof PlatformUser) {
                        abort(403);
                    }
                    if (! $user->hasCapability(PlatformCapabilities::RUNBOOKS_RUN)
                        || ! $user->hasCapability(PlatformCapabilities::RUNBOOKS_FINDINGS_LIFECYCLE_BACKFILL)
                    ) {
                        abort(403);
                    }
                    if ($scope->isAllTenants()) {
                        $typedConfirmation = (string) ($data['typed_confirmation'] ?? '');
                        if ($typedConfirmation !== 'BACKFILL') {
                            throw ValidationException::withMessages([
                                'typed_confirmation' => 'Please type BACKFILL to confirm.',
                            ]);
                        }
                    }
                    $reason = RunbookReason::fromNullableArray([
                        'reason_code' => $data['reason_code'] ?? null,
                        'reason_text' => $data['reason_text'] ?? null,
                    ]);
                    try {
                        $run = $runbookService->start(
                            scope: $scope,
                            initiator: $user,
                            reason: $reason,
                            source: 'system_ui',
                        );
                    } catch (OperationalControlBlockedException $exception) {
                        Notification::make()
                            ->title($exception->title())
                            ->body($exception->getMessage())
                            ->warning()
                            ->send();
                        throw new \Filament\Support\Exceptions\Halt;
                    }
                    $viewUrl = SystemOperationRunLinks::view($run);
                    $toast = $run->wasRecentlyCreated
                        ? OperationUxPresenter::queuedToast((string) $run->type)->body('The runbook will execute in the background.')
                        : OperationUxPresenter::alreadyQueuedToast((string) $run->type);
                    $toast
                        ->actions([
                            Action::make('view_run')
                                ->label('View run')
                                ->url($viewUrl),
                        ])
                        ->send();
                }),
        ];
    }
    /**
     * @return array<int, \Filament\Schemas\Components\Component>
     */
    private function findingsScopeForm(): array
    {
        return [
            Radio::make('scope_mode')
                ->label('Scope')
                ->options([
                    FindingsLifecycleBackfillScope::MODE_ALL_TENANTS => 'All tenants',
                    FindingsLifecycleBackfillScope::MODE_SINGLE_TENANT => 'Single tenant',
                ])
                ->default($this->findingsScopeMode)
                ->live()
                ->required(),
            Select::make('tenant_id')
                ->label('Tenant')
                ->searchable()
                ->visible(fn (callable $get): bool => $get('scope_mode') === FindingsLifecycleBackfillScope::MODE_SINGLE_TENANT)
                ->required(fn (callable $get): bool => $get('scope_mode') === FindingsLifecycleBackfillScope::MODE_SINGLE_TENANT)
                ->getSearchResultsUsing(function (string $search, AllowedTenantUniverse $universe): array {
                    return $universe
                        ->query()
                        ->where('name', 'like', "%{$search}%")
                        ->orderBy('name')
                        ->limit(25)
                        ->pluck('name', 'id')
                        ->all();
                })
                ->getOptionLabelUsing(function ($value, AllowedTenantUniverse $universe): ?string {
                    if (! is_numeric($value)) {
                        return null;
                    }
                    return $universe
                        ->query()
                        ->whereKey((int) $value)
                        ->value('name');
                }),
        ];
    }
    /**
     * @return array<int, \Filament\Schemas\Components\Component>
     */
    private function findingsRunForm(): array
    {
        return [
            TextInput::make('typed_confirmation')
                ->label('Type BACKFILL to confirm')
                ->visible(fn (): bool => $this->findingsScopeMode === FindingsLifecycleBackfillScope::MODE_ALL_TENANTS)
                ->required(fn (): bool => $this->findingsScopeMode === FindingsLifecycleBackfillScope::MODE_ALL_TENANTS)
                ->in(['BACKFILL'])
                ->validationMessages([
                    'in' => 'Please type BACKFILL to confirm.',
                ]),
            Select::make('reason_code')
                ->label('Reason code')
                ->options(RunbookReason::options())
                ->required(function (BreakGlassSession $breakGlass): bool {
                    return $this->findingsScopeMode === FindingsLifecycleBackfillScope::MODE_ALL_TENANTS || $breakGlass->isActive();
                }),
            Textarea::make('reason_text')
                ->label('Reason')
                ->rows(4)
                ->maxLength(500)
                ->required(function (BreakGlassSession $breakGlass): bool {
                    return $this->findingsScopeMode === FindingsLifecycleBackfillScope::MODE_ALL_TENANTS || $breakGlass->isActive();
                }),
        ];
    }
    private function lastRunForType(string $type): ?OperationRun
    {
        $platformTenant = Tenant::query()->where('external_id', 'platform')->first();
        if (! $platformTenant instanceof Tenant) {
            return null;
        }
        return OperationRun::query()
            ->where('workspace_id', (int) $platformTenant->workspace_id)
            ->where('type', $type)
            ->latest('id')
            ->first();
    }
    /**
     * @param  array<string, mixed>  $data
     */
    private function trustedFindingsScopeFromFormData(array $data, AllowedTenantUniverse $allowedTenantUniverse): FindingsLifecycleBackfillScope
    {
        $scope = FindingsLifecycleBackfillScope::fromArray([
            'mode' => $data['scope_mode'] ?? null,
            'tenant_id' => $data['tenant_id'] ?? null,
        ]);
        if (! $scope->isSingleTenant()) {
            return $scope;
        }
        $tenant = $allowedTenantUniverse->resolveAllowedOrFail($scope->tenantId);
        return FindingsLifecycleBackfillScope::singleTenant((int) $tenant->getKey());
    }
    private function trustedFindingsScopeFromState(AllowedTenantUniverse $allowedTenantUniverse): FindingsLifecycleBackfillScope
    {
        if ($this->findingsScopeMode !== FindingsLifecycleBackfillScope::MODE_SINGLE_TENANT) {
            return FindingsLifecycleBackfillScope::allTenants();
        }
        $tenant = $allowedTenantUniverse->resolveAllowedOrFail($this->findingsTenantId);
        return FindingsLifecycleBackfillScope::singleTenant((int) $tenant->getKey());
    }
 }
--- a/apps/platform/app/Filament/System/Widgets/ControlTowerKpis.php
+++ b/apps/platform/app/Filament/System/Widgets/ControlTowerKpis.php
@ -19,12 +19,14 @@ class ControlTowerKpis extends StatsOverviewWidget
    protected int|string|array $columnSpan = 'full';
    public ?string $window = null;
    /**
     * @return array<Stat>
     */
    protected function getStats(): array
    {
-        $window = SystemConsoleWindow::fromNullable((string) request()->query('window'));
+        $window = SystemConsoleWindow::fromNullable($this->window ?? (string) request()->query('window'));
        $start = $window->startAt();
        $baseQuery = OperationRun::query()->where('created_at', '>=', $start);
--- a/apps/platform/app/Filament/System/Widgets/ControlTowerRecentFailures.php
+++ b/apps/platform/app/Filament/System/Widgets/ControlTowerRecentFailures.php
@ -21,12 +21,14 @@ class ControlTowerRecentFailures extends Widget
    protected string $view = 'filament.system.widgets.control-tower-recent-failures';
    public ?string $window = null;
    /**
     * @return array<string, mixed>
     */
    protected function getViewData(): array
    {
-        $window = SystemConsoleWindow::fromNullable((string) request()->query('window'));
+        $window = SystemConsoleWindow::fromNullable($this->window ?? (string) request()->query('window'));
        $start = $window->startAt();
        /** @var Collection<int, OperationRun> $runs */
--- a/apps/platform/app/Filament/System/Widgets/ControlTowerTopOffenders.php
+++ b/apps/platform/app/Filament/System/Widgets/ControlTowerTopOffenders.php
@ -23,12 +23,14 @@ class ControlTowerTopOffenders extends Widget
    protected string $view = 'filament.system.widgets.control-tower-top-offenders';
    public ?string $window = null;
    /**
     * @return array<string, mixed>
     */
    protected function getViewData(): array
    {
-        $window = SystemConsoleWindow::fromNullable((string) request()->query('window'));
+        $window = SystemConsoleWindow::fromNullable($this->window ?? (string) request()->query('window'));
        $start = $window->startAt();
        /** @var Collection<int, OperationRun> $grouped */
--- a/apps/platform/app/Filament/System/Widgets/CustomerHealthKpis.php
+++ b/apps/platform/app/Filament/System/Widgets/CustomerHealthKpis.php
@ -0,0 +1,46 @@
 <?php
 declare(strict_types=1);
 namespace App\Filament\System\Widgets;
 use App\Support\CustomerHealth\WorkspaceHealthSummaryQuery;
 use App\Support\SystemConsole\SystemConsoleWindow;
 use Filament\Widgets\StatsOverviewWidget;
 use Filament\Widgets\StatsOverviewWidget\Stat;
 class CustomerHealthKpis extends StatsOverviewWidget
 {
    protected static bool $isLazy = false;
    protected ?string $heading = 'Customer health';
    protected int|string|array $columnSpan = 'full';
    public ?string $window = null;
    /**
     * @return array<Stat>
     */
    protected function getStats(): array
    {
        $window = SystemConsoleWindow::fromNullable($this->window ?? (string) request()->query('window'));
        $windowLabel = SystemConsoleWindow::options()[$window->value] ?? 'Last 24 hours';
        $counts = app(WorkspaceHealthSummaryQuery::class)->healthCounts($window);
        return [
            Stat::make('Healthy', $counts['ok'])
                ->description(sprintf('Operational stability, review-pack readiness, and engagement freshness honor %s.', $windowLabel))
                ->color($counts['ok'] > 0 ? 'success' : 'gray'),
            Stat::make('Warning', $counts['warn'])
                ->description('Onboarding readiness, provider health, and governance pressure stay point-in-time.')
                ->color($counts['warn'] > 0 ? 'warning' : 'gray'),
            Stat::make('Critical', $counts['critical'])
                ->description('Overall workspace health is derived from existing system truth only.')
                ->color($counts['critical'] > 0 ? 'danger' : 'gray'),
            Stat::make('Unknown', $counts['unknown'])
                ->description('Missing or stale inputs stay explicit instead of silently reading healthy.')
                ->color('gray'),
        ];
    }
 }
--- a/apps/platform/app/Filament/System/Widgets/CustomerHealthTopWorkspaces.php
+++ b/apps/platform/app/Filament/System/Widgets/CustomerHealthTopWorkspaces.php
@ -0,0 +1,137 @@
 <?php
 declare(strict_types=1);
 namespace App\Filament\System\Widgets;
 use App\Models\PlatformUser;
 use App\Support\Auth\PlatformCapabilities;
 use App\Support\Badges\BadgeDomain;
 use App\Support\Badges\BadgeRenderer;
 use App\Support\CustomerHealth\WorkspaceHealthSummaryQuery;
 use App\Support\SystemConsole\SystemConsoleWindow;
 use App\Support\System\SystemOperationRunLinks;
 use Filament\Widgets\Widget;
 class CustomerHealthTopWorkspaces extends Widget
 {
    protected static bool $isLazy = false;
    protected int|string|array $columnSpan = 'full';
    protected string $view = 'filament.system.widgets.customer-health-top-workspaces';
    public ?string $window = null;
    public static function canView(): bool
    {
        $user = auth('platform')->user();
        if (! $user instanceof PlatformUser) {
            return false;
        }
        if ($user->hasCapability(PlatformCapabilities::DIRECTORY_VIEW)) {
            return true;
        }
        if (! static::canOpenRuns($user)) {
            return false;
        }
        $window = SystemConsoleWindow::fromNullable((string) request()->query('window'));
        return app(WorkspaceHealthSummaryQuery::class)
            ->attentionNeeded($window, 10)
            ->contains(fn (array $summary): bool => static::canAccessNextLink($summary['next_link'], $user));
    }
    /**
     * @return array<string, mixed>
     */
    protected function getViewData(): array
    {
        $window = SystemConsoleWindow::fromNullable($this->window ?? (string) request()->query('window'));
        $windowLabel = SystemConsoleWindow::options()[$window->value] ?? 'Last 24 hours';
        $user = auth('platform')->user();
        return [
            'windowLabel' => $windowLabel,
            'rows' => app(WorkspaceHealthSummaryQuery::class)
                ->attentionNeeded($window, 10)
                ->filter(fn (array $summary): bool => $user instanceof PlatformUser && static::canAccessNextLink($summary['next_link'], $user))
                ->map(fn (array $summary): array => $this->presentSummary($summary)),
        ];
    }
    /**
     * @param  array{label: string, url: string}  $nextLink
     */
    private static function canAccessNextLink(array $nextLink, PlatformUser $user): bool
    {
        if ($user->hasCapability(PlatformCapabilities::DIRECTORY_VIEW)) {
            return true;
        }
        return static::canOpenRuns($user)
            && $nextLink['url'] === SystemOperationRunLinks::index();
    }
    private static function canOpenRuns(PlatformUser $user): bool
    {
        return $user->hasCapability(PlatformCapabilities::OPERATIONS_VIEW)
            || ($user->hasCapability(PlatformCapabilities::OPS_VIEW) && $user->hasCapability(PlatformCapabilities::RUNBOOKS_VIEW));
    }
    /**
     * @param  array{
     *     workspace_id: int,
     *     workspace_name: string,
     *     overall_level: string,
     *     dimensions: array<string, array{label: string, level: string, windowed: bool}>,
     *     dominant_dimension_keys: list<string>,
     *     non_ok_dimension_count: int,
     *     next_link: array{label: string, url: string}
     * }  $summary
     * @return array{
     *     workspace_id: int,
     *     workspace_label: string,
     *     overall: array{label: string, color: string, icon: ?string},
     *     dominant_copy: string,
     *     dominant_dimensions: list<array{label: string, color: string, icon: ?string}>,
     *     next_link: array{label: string, url: string}
     * }
     */
    private function presentSummary(array $summary): array
    {
        $dominantDimensions = collect($summary['dominant_dimension_keys'])
            ->take(2)
            ->map(function (string $dimensionKey) use ($summary): array {
                $dimension = $summary['dimensions'][$dimensionKey];
                $badge = BadgeRenderer::spec(BadgeDomain::SystemHealth, $dimension['level']);
                return [
                    'label' => $dimension['label'],
                    'color' => $badge->color,
                    'icon' => $badge->icon,
                ];
            })
            ->values()
            ->all();
        $overallBadge = BadgeRenderer::spec(BadgeDomain::SystemHealth, $summary['overall_level']);
        return [
            'workspace_id' => $summary['workspace_id'],
            'workspace_label' => $summary['workspace_name'],
            'overall' => [
                'label' => $overallBadge->label,
                'color' => $overallBadge->color,
                'icon' => $overallBadge->icon,
            ],
            'dominant_copy' => implode(', ', array_column($dominantDimensions, 'label')),
            'dominant_dimensions' => $dominantDimensions,
            'next_link' => $summary['next_link'],
        ];
    }
 }
--- a/apps/platform/app/Filament/System/Widgets/ProductTelemetryKpis.php
+++ b/apps/platform/app/Filament/System/Widgets/ProductTelemetryKpis.php
@ -0,0 +1,47 @@
 <?php
 declare(strict_types=1);
 namespace App\Filament\System\Widgets;
 use App\Support\ProductTelemetry\ProductTelemetrySummaryQuery;
 use App\Support\SystemConsole\SystemConsoleWindow;
 use Filament\Widgets\StatsOverviewWidget;
 use Filament\Widgets\StatsOverviewWidget\Stat;
 class ProductTelemetryKpis extends StatsOverviewWidget
 {
    protected static bool $isLazy = false;
    protected ?string $heading = 'Product telemetry';
    protected int|string|array $columnSpan = 'full';
    public ?string $window = null;
    /**
     * @return array<Stat>
     */
    protected function getStats(): array
    {
        $window = SystemConsoleWindow::fromNullable($this->window ?? (string) request()->query('window'));
        $windowLabel = SystemConsoleWindow::options()[$window->value] ?? 'Last 24 hours';
        $summary = app(ProductTelemetrySummaryQuery::class)->summarize($window->startAt(), now());
        $stats = [
            Stat::make('Active workspaces', $summary['active_workspaces'])
                ->description($summary['total_events'] > 0
                    ? sprintf('%d events in %s', $summary['total_events'], $windowLabel)
                    : sprintf('No telemetry recorded in %s.', $windowLabel))
                ->color($summary['active_workspaces'] > 0 ? 'primary' : 'gray'),
        ];
        foreach ($summary['families'] as $family) {
            $stats[] = Stat::make($family['label'], $family['count'])
                ->description($windowLabel)
                ->color($family['count'] > 0 ? 'primary' : 'gray');
        }
        return $stats;
    }
 }
--- a/apps/platform/app/Filament/Widgets/Tenant/TenantReviewPackCard.php
+++ b/apps/platform/app/Filament/Widgets/Tenant/TenantReviewPackCard.php
@ -4,6 +4,8 @@
 namespace App\Filament\Widgets\Tenant;
 use App\Exceptions\Entitlements\WorkspaceEntitlementBlockedException;
 use App\Filament\Pages\Reviews\CustomerReviewWorkspace;
 use App\Models\OperationRun;
 use App\Models\ReviewPack;
 use App\Models\Tenant;
@ -18,6 +20,7 @@
 use App\Support\ReviewPackStatus;
 use Filament\Actions\Action;
 use Filament\Facades\Filament;
 use Filament\Notifications\Notification;
 use Filament\Widgets\Widget;
 class TenantReviewPackCard extends Widget
@ -66,6 +69,26 @@ public function generatePack(bool $includePii = true, bool $includeOperations =
        /** @var ReviewPackService $service */
        $service = app(ReviewPackService::class);
        $decision = $service->reviewPackGenerationDecisionForTenant($tenant);
        if ((bool) ($decision['is_blocked'] ?? false)) {
            Notification::make()
                ->title('Review pack generation unavailable')
                ->body((string) ($decision['block_reason'] ?? 'Workspace entitlement currently blocks review pack generation.'))
                ->warning()
                ->send();
            return;
        }
        if ((bool) ($decision['is_warning'] ?? false) && is_string($decision['warning_reason'] ?? null)) {
            Notification::make()
                ->title('Review pack generation allowed with warning')
                ->body($decision['warning_reason'])
                ->warning()
                ->send();
        }
        $activeRun = $service->checkActiveRun($tenant)
            ? OperationRun::query()
                ->where('tenant_id', (int) $tenant->getKey())
@ -90,10 +113,20 @@ public function generatePack(bool $includePii = true, bool $includeOperations =
            return;
        }
-        $reviewPack = $service->generate($tenant, $user, [
+        try {
-            'include_pii' => $includePii,
+            $reviewPack = $service->generate($tenant, $user, [
-            'include_operations' => $includeOperations,
+                'include_pii' => $includePii,
-        ]);
+                'include_operations' => $includeOperations,
            ]);
        } catch (WorkspaceEntitlementBlockedException $exception) {
            Notification::make()
                ->title('Review pack generation unavailable')
                ->body($exception->getMessage())
                ->warning()
                ->send();
            return;
        }
        $runUrl = $reviewPack->operationRun
            ? OperationRunLinks::tenantlessView($reviewPack->operationRun)
@ -130,6 +163,17 @@ protected function getViewData(): array
        $isTenantMember = $user instanceof User && $user->canAccessTenant($tenant);
        $canView = $isTenantMember && $user->can(Capabilities::REVIEW_PACK_VIEW, $tenant);
        $canManage = $isTenantMember && $user->can(Capabilities::REVIEW_PACK_MANAGE, $tenant);
        $service = app(ReviewPackService::class);
        $generationEntitlement = $canManage
            ? $service->reviewPackGenerationDecisionForTenant($tenant)
            : null;
        $generationBlocked = (bool) ($generationEntitlement['is_blocked'] ?? false);
        $generationBlockReason = is_string($generationEntitlement['block_reason'] ?? null)
            ? $generationEntitlement['block_reason']
            : null;
        $generationWarningReason = is_string($generationEntitlement['warning_reason'] ?? null)
            ? $generationEntitlement['warning_reason']
            : null;
        $latestPack = ReviewPack::query()
            ->with(['tenantReview', 'operationRun'])
@ -146,6 +190,10 @@ protected function getViewData(): array
                'pollingInterval' => null,
                'canView' => $canView,
                'canManage' => $canManage,
                'generationBlocked' => $generationBlocked,
                'generationBlockReason' => $generationBlockReason,
                'generationWarningReason' => $generationWarningReason,
                'customerWorkspaceUrl' => $canView ? CustomerReviewWorkspace::tenantPrefilterUrl($tenant) : null,
                'downloadUrl' => null,
                'failedReason' => null,
                'reviewUrl' => null,
@ -194,6 +242,10 @@ protected function getViewData(): array
            'pollingInterval' => self::resolvePollingInterval($latestPack),
            'canView' => $canView,
            'canManage' => $canManage,
            'generationBlocked' => $generationBlocked,
            'generationBlockReason' => $generationBlockReason,
            'generationWarningReason' => $generationWarningReason,
            'customerWorkspaceUrl' => $canView ? CustomerReviewWorkspace::tenantPrefilterUrl($tenant) : null,
            'downloadUrl' => $downloadUrl,
            'failedReason' => $failedReason,
            'failedReasonDetail' => $failedReasonDetail,
@ -224,6 +276,10 @@ private function emptyState(): array
            'pollingInterval' => null,
            'canView' => false,
            'canManage' => false,
            'generationBlocked' => false,
            'generationBlockReason' => null,
            'generationWarningReason' => null,
            'customerWorkspaceUrl' => null,
            'downloadUrl' => null,
            'failedReason' => null,
            'failedReasonDetail' => null,
--- a/apps/platform/app/Http/Controllers/LocalizationController.php
+++ b/apps/platform/app/Http/Controllers/LocalizationController.php
@ -0,0 +1,80 @@
 <?php
 declare(strict_types=1);
 namespace App\Http\Controllers;
 use App\Models\User;
 use App\Services\Localization\LocaleResolver;
 use Illuminate\Http\RedirectResponse;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Http\Response;
 use Illuminate\Support\Facades\App;
 use Illuminate\Validation\ValidationException;
 class LocalizationController extends Controller
 {
    public function context(Request $request, LocaleResolver $resolver): JsonResponse
    {
        $plane = $request->query('plane');
        $context = $request->attributes->get(LocaleResolver::REQUEST_ATTRIBUTE);
        if (is_string($plane) && $plane !== '') {
            $context = $resolver->resolve($request, $plane);
        }
        return response()->json(is_array($context) ? $context : $resolver->resolve($request));
    }
    public function updateOverride(Request $request): RedirectResponse
    {
        $locale = LocaleResolver::normalize($request->input('locale'));
        if ($locale === null) {
            throw ValidationException::withMessages([
                'locale' => [__('localization.validation.unsupported_locale')],
            ]);
        }
        $request->session()->put(LocaleResolver::SESSION_OVERRIDE_KEY, $locale);
        App::setLocale($locale);
        return back()->with('status', __('localization.notifications.locale_override_saved'));
    }
    public function clearOverride(Request $request, LocaleResolver $resolver): RedirectResponse
    {
        $request->session()->forget(LocaleResolver::SESSION_OVERRIDE_KEY);
        App::setLocale($resolver->resolve($request)['locale']);
        return back()->with('status', __('localization.notifications.locale_override_cleared'));
    }
    public function updateUserPreference(Request $request, LocaleResolver $resolver): RedirectResponse
    {
        $user = $request->user();
        abort_unless($user instanceof User, Response::HTTP_NOT_FOUND);
        $rawLocale = $request->input('preferred_locale');
        $locale = $rawLocale === null || $rawLocale === ''
            ? null
            : LocaleResolver::normalize($rawLocale);
        if ($rawLocale !== null && $rawLocale !== '' && $locale === null) {
            throw ValidationException::withMessages([
                'preferred_locale' => [__('localization.validation.unsupported_locale')],
            ]);
        }
        $user->forceFill(['preferred_locale' => $locale])->save();
        $user->refresh();
        App::setLocale($resolver->resolve($request)['locale']);
        return back()->with('status', $locale === null
            ? __('localization.notifications.user_preference_cleared')
            : __('localization.notifications.user_preference_saved'));
    }
 }
--- a/apps/platform/app/Http/Controllers/ReviewPackDownloadController.php
+++ b/apps/platform/app/Http/Controllers/ReviewPackDownloadController.php
@ -4,7 +4,12 @@
 namespace App\Http\Controllers;
 use App\Models\Tenant;
 use App\Models\ReviewPack;
 use App\Models\User;
 use App\Services\Audit\WorkspaceAuditLogger;
 use App\Support\Audit\AuditActionId;
 use App\Support\Auth\Capabilities;
 use App\Support\ReviewPackStatus;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Storage;
@ -15,6 +20,21 @@ class ReviewPackDownloadController extends Controller
 {
    public function __invoke(Request $request, ReviewPack $reviewPack): StreamedResponse
    {
        $user = $request->user();
        $tenant = $reviewPack->tenant;
        if (! $user instanceof User || ! $tenant instanceof Tenant) {
            throw new NotFoundHttpException;
        }
        if (! $user->canAccessTenant($tenant)) {
            throw new NotFoundHttpException;
        }
        if (! $user->can(Capabilities::REVIEW_PACK_VIEW, $tenant)) {
            abort(403);
        }
        if ($reviewPack->status !== ReviewPackStatus::Ready->value) {
            throw new NotFoundHttpException;
        }
@ -29,7 +49,26 @@ public function __invoke(Request $request, ReviewPack $reviewPack): StreamedResp
            throw new NotFoundHttpException;
        }
-        $tenant = $reviewPack->tenant;
+        app(WorkspaceAuditLogger::class)->log(
            workspace: $tenant->workspace,
            action: AuditActionId::ReviewPackDownloaded,
            context: [
                'metadata' => [
                    'review_pack_id' => (int) $reviewPack->getKey(),
                    'tenant_review_id' => $reviewPack->tenant_review_id !== null
                        ? (int) $reviewPack->tenant_review_id
                        : null,
                    'source_surface' => (string) $request->query('source_surface', 'review_pack'),
                ],
            ],
            actor: $user,
            resourceType: 'review_pack',
            resourceId: (string) $reviewPack->getKey(),
            targetLabel: sprintf('Review pack #%d', (int) $reviewPack->getKey()),
            tenant: $tenant,
            operationRunId: $reviewPack->operation_run_id,
        );
        $filename = sprintf(
            'review-pack-%s-%s.zip',
            $tenant?->external_id ?? 'unknown',
--- a/apps/platform/app/Http/Middleware/ApplyResolvedLocale.php
+++ b/apps/platform/app/Http/Middleware/ApplyResolvedLocale.php
@ -0,0 +1,29 @@
 <?php
 declare(strict_types=1);
 namespace App\Http\Middleware;
 use App\Services\Localization\LocaleResolver;
 use Closure;
 use Illuminate\Http\Request;
 use Illuminate\Support\Carbon;
 use Illuminate\Support\Facades\App;
 use Symfony\Component\HttpFoundation\Response;
 class ApplyResolvedLocale
 {
    public function __construct(private LocaleResolver $resolver) {}
    public function handle(Request $request, Closure $next, ?string $plane = null): Response
    {
        $context = $this->resolver->resolve($request, $plane);
        App::setLocale($context['locale']);
        Carbon::setLocale($context['locale']);
        $request->attributes->set(LocaleResolver::REQUEST_ATTRIBUTE, $context);
        return $next($request);
    }
 }
--- a/apps/platform/app/Jobs/BackfillFindingLifecycleJob.php
+++ b/apps/platform/app/Jobs/BackfillFindingLifecycleJob.php
@ -1,398 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Jobs;
 use App\Models\Finding;
 use App\Models\Tenant;
 use App\Models\User;
 use App\Services\Findings\FindingSlaPolicy;
 use App\Services\OperationRunService;
 use App\Services\Runbooks\FindingsLifecycleBackfillRunbookService;
 use App\Support\OperationRunOutcome;
 use App\Support\OperationRunStatus;
 use App\Support\OpsUx\RunFailureSanitizer;
 use Carbon\CarbonImmutable;
 use Illuminate\Bus\Queueable;
 use Illuminate\Contracts\Queue\ShouldQueue;
 use Illuminate\Foundation\Bus\Dispatchable;
 use Illuminate\Queue\InteractsWithQueue;
 use Illuminate\Queue\SerializesModels;
 use Illuminate\Support\Arr;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\Cache;
 use Throwable;
 class BackfillFindingLifecycleJob implements ShouldQueue
 {
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
    public function __construct(
        public readonly int $tenantId,
        public readonly int $workspaceId,
        public readonly ?int $initiatorUserId = null,
    ) {}
    public function handle(
        OperationRunService $operationRuns,
        FindingSlaPolicy $slaPolicy,
        FindingsLifecycleBackfillRunbookService $runbookService,
    ): void {
        $tenant = Tenant::query()->find($this->tenantId);
        if (! $tenant instanceof Tenant) {
            return;
        }
        $initiator = $this->initiatorUserId !== null
            ? User::query()->find($this->initiatorUserId)
            : null;
        $operationRun = $operationRuns->ensureRunWithIdentity(
            tenant: $tenant,
            type: 'findings.lifecycle.backfill',
            identityInputs: [
                'tenant_id' => $this->tenantId,
                'trigger' => 'backfill',
            ],
            context: [
                'workspace_id' => $this->workspaceId,
                'initiator_user_id' => $this->initiatorUserId,
            ],
            initiator: $initiator instanceof User ? $initiator : null,
        );
        $lock = Cache::lock(sprintf('tenantpilot:findings:lifecycle_backfill:tenant:%d', $this->tenantId), 900);
        if (! $lock->get()) {
            if ($operationRun->status !== OperationRunStatus::Completed->value) {
                $operationRuns->updateRun(
                    $operationRun,
                    status: OperationRunStatus::Completed->value,
                    outcome: OperationRunOutcome::Blocked->value,
                    failures: [
                        [
                            'code' => 'findings.lifecycle.backfill.lock_busy',
                            'message' => 'Another findings lifecycle backfill is already running for this tenant.',
                        ],
                    ],
                );
            }
            $runbookService->maybeFinalize($operationRun);
            return;
        }
        try {
            $total = (int) Finding::query()
                ->where('tenant_id', $tenant->getKey())
                ->count();
            $operationRuns->updateRun(
                $operationRun,
                status: OperationRunStatus::Running->value,
                outcome: OperationRunOutcome::Pending->value,
                summaryCounts: [
                    'total' => $total,
                    'processed' => 0,
                    'updated' => 0,
                    'skipped' => 0,
                    'failed' => 0,
                ],
            );
            $operationRun->refresh();
            $backfillStartedAt = $operationRun->started_at !== null
                ? CarbonImmutable::instance($operationRun->started_at)
                : CarbonImmutable::now('UTC');
            Finding::query()
                ->where('tenant_id', $tenant->getKey())
                ->orderBy('id')
                ->chunkById(200, function (Collection $findings) use ($tenant, $slaPolicy, $operationRuns, $operationRun, $backfillStartedAt): void {
                    $processed = 0;
                    $updated = 0;
                    $skipped = 0;
                    foreach ($findings as $finding) {
                        if (! $finding instanceof Finding) {
                            continue;
                        }
                        $processed++;
                        $originalAttributes = $finding->getAttributes();
                        $this->backfillLifecycleFields($finding, $backfillStartedAt);
                        $this->backfillLegacyAcknowledgedStatus($finding);
                        $this->backfillSlaFields($finding, $tenant, $slaPolicy, $backfillStartedAt);
                        $this->backfillDriftRecurrenceKey($finding);
                        if ($finding->isDirty()) {
                            $finding->save();
                            $updated++;
                        } else {
                            $finding->setRawAttributes($originalAttributes, sync: true);
                            $skipped++;
                        }
                    }
                    $operationRuns->incrementSummaryCounts($operationRun, [
                        'processed' => $processed,
                        'updated' => $updated,
                        'skipped' => $skipped,
                    ]);
                });
            $consolidatedDuplicates = $this->consolidateDriftDuplicates($tenant, $backfillStartedAt);
            if ($consolidatedDuplicates > 0) {
                $operationRuns->incrementSummaryCounts($operationRun, [
                    'updated' => $consolidatedDuplicates,
                ]);
            }
            $operationRuns->updateRun(
                $operationRun,
                status: OperationRunStatus::Completed->value,
                outcome: OperationRunOutcome::Succeeded->value,
            );
            $runbookService->maybeFinalize($operationRun);
        } catch (Throwable $e) {
            $message = RunFailureSanitizer::sanitizeMessage($e->getMessage());
            $reasonCode = RunFailureSanitizer::normalizeReasonCode($e->getMessage());
            $operationRuns->updateRun(
                $operationRun,
                status: OperationRunStatus::Completed->value,
                outcome: OperationRunOutcome::Failed->value,
                failures: [[
                    'code' => 'findings.lifecycle.backfill.failed',
                    'reason_code' => $reasonCode,
                    'message' => $message !== '' ? $message : 'Findings lifecycle backfill failed.',
                ]],
            );
            $runbookService->maybeFinalize($operationRun);
            throw $e;
        } finally {
            $lock->release();
        }
    }
    private function backfillLifecycleFields(Finding $finding, CarbonImmutable $backfillStartedAt): void
    {
        $createdAt = $finding->created_at !== null ? CarbonImmutable::instance($finding->created_at) : $backfillStartedAt;
        if ($finding->first_seen_at === null) {
            $finding->first_seen_at = $createdAt;
        }
        if ($finding->last_seen_at === null) {
            $finding->last_seen_at = $createdAt;
        }
        if ($finding->last_seen_at !== null && $finding->first_seen_at !== null) {
            $lastSeen = CarbonImmutable::instance($finding->last_seen_at);
            $firstSeen = CarbonImmutable::instance($finding->first_seen_at);
            if ($lastSeen->lessThan($firstSeen)) {
                $finding->last_seen_at = $firstSeen;
            }
        }
        $timesSeen = is_numeric($finding->times_seen) ? (int) $finding->times_seen : 0;
        if ($timesSeen < 1) {
            $finding->times_seen = 1;
        }
    }
    private function backfillLegacyAcknowledgedStatus(Finding $finding): void
    {
        if ($finding->status !== Finding::STATUS_ACKNOWLEDGED) {
            return;
        }
        $finding->status = Finding::STATUS_TRIAGED;
        if ($finding->triaged_at === null) {
            if ($finding->acknowledged_at !== null) {
                $finding->triaged_at = CarbonImmutable::instance($finding->acknowledged_at);
            } elseif ($finding->created_at !== null) {
                $finding->triaged_at = CarbonImmutable::instance($finding->created_at);
            }
        }
    }
    private function backfillSlaFields(
        Finding $finding,
        Tenant $tenant,
        FindingSlaPolicy $slaPolicy,
        CarbonImmutable $backfillStartedAt,
    ): void {
        if (! Finding::isOpenStatus((string) $finding->status)) {
            return;
        }
        if ($finding->sla_days === null) {
            $finding->sla_days = $slaPolicy->daysForSeverity((string) $finding->severity, $tenant);
        }
        if ($finding->due_at === null) {
            $finding->due_at = $slaPolicy->dueAtForSeverity((string) $finding->severity, $tenant, $backfillStartedAt);
        }
    }
    private function backfillDriftRecurrenceKey(Finding $finding): void
    {
        if ($finding->finding_type !== Finding::FINDING_TYPE_DRIFT) {
            return;
        }
        if ($finding->recurrence_key !== null && trim((string) $finding->recurrence_key) !== '') {
            return;
        }
        $tenantId = (int) ($finding->tenant_id ?? 0);
        $scopeKey = (string) ($finding->scope_key ?? '');
        $subjectType = (string) ($finding->subject_type ?? '');
        $subjectExternalId = (string) ($finding->subject_external_id ?? '');
        if ($tenantId <= 0 || $scopeKey === '' || $subjectType === '' || $subjectExternalId === '') {
            return;
        }
        $evidence = is_array($finding->evidence_jsonb) ? $finding->evidence_jsonb : [];
        $kind = Arr::get($evidence, 'summary.kind');
        $changeType = Arr::get($evidence, 'change_type');
        $kind = is_string($kind) ? $kind : '';
        $changeType = is_string($changeType) ? $changeType : '';
        if ($kind === '') {
            return;
        }
        $dimension = $this->recurrenceDimension($kind, $changeType);
        $finding->recurrence_key = hash('sha256', sprintf(
            'drift:%d:%s:%s:%s:%s',
            $tenantId,
            $scopeKey,
            $subjectType,
            $subjectExternalId,
            $dimension,
        ));
    }
    private function recurrenceDimension(string $kind, string $changeType): string
    {
        $kind = strtolower(trim($kind));
        $changeType = strtolower(trim($changeType));
        return match ($kind) {
            'policy_snapshot', 'baseline_compare' => sprintf('%s:%s', $kind, $changeType !== '' ? $changeType : 'modified'),
            default => $kind,
        };
    }
    private function consolidateDriftDuplicates(Tenant $tenant, CarbonImmutable $backfillStartedAt): int
    {
        $duplicateKeys = Finding::query()
            ->where('tenant_id', $tenant->getKey())
            ->where('finding_type', Finding::FINDING_TYPE_DRIFT)
            ->whereNotNull('recurrence_key')
            ->select(['recurrence_key'])
            ->groupBy('recurrence_key')
            ->havingRaw('COUNT(*) > 1')
            ->pluck('recurrence_key')
            ->filter(static fn (mixed $value): bool => is_string($value) && trim($value) !== '')
            ->values();
        if ($duplicateKeys->isEmpty()) {
            return 0;
        }
        $consolidated = 0;
        foreach ($duplicateKeys as $recurrenceKey) {
            if (! is_string($recurrenceKey) || $recurrenceKey === '') {
                continue;
            }
            $findings = Finding::query()
                ->where('tenant_id', $tenant->getKey())
                ->where('finding_type', Finding::FINDING_TYPE_DRIFT)
                ->where('recurrence_key', $recurrenceKey)
                ->orderBy('id')
                ->get();
            $canonical = $this->chooseCanonicalDriftFinding($findings, $recurrenceKey);
            foreach ($findings as $finding) {
                if (! $finding instanceof Finding) {
                    continue;
                }
                if ($canonical instanceof Finding && (int) $finding->getKey() === (int) $canonical->getKey()) {
                    continue;
                }
                $finding->forceFill([
                    'status' => Finding::STATUS_CLOSED,
                    'resolved_at' => null,
                    'resolved_reason' => null,
                    'closed_at' => $backfillStartedAt,
                    'closed_reason' => Finding::CLOSE_REASON_DUPLICATE,
                    'closed_by_user_id' => null,
                    'recurrence_key' => null,
                ])->save();
                $consolidated++;
            }
        }
        return $consolidated;
    }
    /**
     * @param  Collection<int, Finding>  $findings
     */
    private function chooseCanonicalDriftFinding(Collection $findings, string $recurrenceKey): ?Finding
    {
        if ($findings->isEmpty()) {
            return null;
        }
        $openCandidates = $findings->filter(static fn (Finding $finding): bool => Finding::isOpenStatus((string) $finding->status));
        $candidates = $openCandidates->isNotEmpty() ? $openCandidates : $findings;
        $alreadyCanonical = $candidates->first(static fn (Finding $finding): bool => (string) $finding->fingerprint === $recurrenceKey);
        if ($alreadyCanonical instanceof Finding) {
            return $alreadyCanonical;
        }
        /** @var Finding $sorted */
        $sorted = $candidates
            ->sortByDesc(function (Finding $finding): array {
                $lastSeen = $finding->last_seen_at !== null ? CarbonImmutable::instance($finding->last_seen_at)->getTimestamp() : 0;
                $createdAt = $finding->created_at !== null ? CarbonImmutable::instance($finding->created_at)->getTimestamp() : 0;
                return [
                    max($lastSeen, $createdAt),
                    (int) $finding->getKey(),
                ];
            })
            ->first();
        return $sorted;
    }
 }
--- a/apps/platform/app/Jobs/BackfillFindingLifecycleTenantIntoWorkspaceRunJob.php
+++ b/apps/platform/app/Jobs/BackfillFindingLifecycleTenantIntoWorkspaceRunJob.php
@ -1,378 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Jobs;
 use App\Models\Finding;
 use App\Models\OperationRun;
 use App\Models\Tenant;
 use App\Services\Findings\FindingSlaPolicy;
 use App\Services\OperationRunService;
 use App\Services\Runbooks\FindingsLifecycleBackfillRunbookService;
 use App\Support\OpsUx\RunFailureSanitizer;
 use Carbon\CarbonImmutable;
 use Illuminate\Bus\Queueable;
 use Illuminate\Contracts\Queue\ShouldQueue;
 use Illuminate\Foundation\Bus\Dispatchable;
 use Illuminate\Queue\InteractsWithQueue;
 use Illuminate\Queue\SerializesModels;
 use Illuminate\Support\Arr;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\Cache;
 use Throwable;
 class BackfillFindingLifecycleTenantIntoWorkspaceRunJob implements ShouldQueue
 {
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
    public function __construct(
        public readonly int $operationRunId,
        public readonly int $workspaceId,
        public readonly int $tenantId,
    ) {}
    public function handle(
        OperationRunService $operationRunService,
        FindingSlaPolicy $slaPolicy,
        FindingsLifecycleBackfillRunbookService $runbookService,
    ): void {
        $tenant = Tenant::query()->find($this->tenantId);
        if (! $tenant instanceof Tenant) {
            return;
        }
        if ((int) $tenant->workspace_id !== $this->workspaceId) {
            return;
        }
        $run = OperationRun::query()->find($this->operationRunId);
        if (! $run instanceof OperationRun) {
            return;
        }
        if ((int) $run->workspace_id !== $this->workspaceId) {
            return;
        }
        if ($run->tenant_id !== null) {
            return;
        }
        if ($run->status === 'queued') {
            $operationRunService->updateRun($run, status: 'running');
        }
        $lock = Cache::lock(sprintf('tenantpilot:findings:lifecycle_backfill:tenant:%d', $this->tenantId), 900);
        if (! $lock->get()) {
            $operationRunService->appendFailures($run, [
                [
                    'code' => 'findings.lifecycle.backfill.lock_busy',
                    'message' => sprintf('Tenant %d is already running a findings lifecycle backfill.', $this->tenantId),
                ],
            ]);
            $operationRunService->incrementSummaryCounts($run, [
                'failed' => 1,
                'processed' => 1,
            ]);
            $operationRunService->maybeCompleteBulkRun($run);
            $runbookService->maybeFinalize($run);
            return;
        }
        try {
            $backfillStartedAt = $run->started_at !== null
                ? CarbonImmutable::instance($run->started_at)
                : CarbonImmutable::now('UTC');
            Finding::query()
                ->where('tenant_id', $tenant->getKey())
                ->orderBy('id')
                ->chunkById(200, function (Collection $findings) use ($tenant, $slaPolicy, $operationRunService, $run, $backfillStartedAt): void {
                    $updated = 0;
                    $skipped = 0;
                    foreach ($findings as $finding) {
                        if (! $finding instanceof Finding) {
                            continue;
                        }
                        $originalAttributes = $finding->getAttributes();
                        $this->backfillLifecycleFields($finding, $backfillStartedAt);
                        $this->backfillLegacyAcknowledgedStatus($finding);
                        $this->backfillSlaFields($finding, $tenant, $slaPolicy, $backfillStartedAt);
                        $this->backfillDriftRecurrenceKey($finding);
                        if ($finding->isDirty()) {
                            $finding->save();
                            $updated++;
                        } else {
                            $finding->setRawAttributes($originalAttributes, sync: true);
                            $skipped++;
                        }
                    }
                    if ($updated > 0 || $skipped > 0) {
                        $operationRunService->incrementSummaryCounts($run, [
                            'updated' => $updated,
                            'skipped' => $skipped,
                        ]);
                    }
                });
            $consolidatedDuplicates = $this->consolidateDriftDuplicates($tenant, $backfillStartedAt);
            if ($consolidatedDuplicates > 0) {
                $operationRunService->incrementSummaryCounts($run, [
                    'updated' => $consolidatedDuplicates,
                ]);
            }
            $operationRunService->incrementSummaryCounts($run, [
                'processed' => 1,
            ]);
            $operationRunService->maybeCompleteBulkRun($run);
            $runbookService->maybeFinalize($run);
        } catch (Throwable $e) {
            $message = RunFailureSanitizer::sanitizeMessage($e->getMessage());
            $reasonCode = RunFailureSanitizer::normalizeReasonCode($e->getMessage());
            $operationRunService->appendFailures($run, [[
                'code' => 'findings.lifecycle.backfill.failed',
                'reason_code' => $reasonCode,
                'message' => $message !== '' ? $message : sprintf('Tenant %d findings lifecycle backfill failed.', $this->tenantId),
            ]]);
            $operationRunService->incrementSummaryCounts($run, [
                'failed' => 1,
                'processed' => 1,
            ]);
            $operationRunService->maybeCompleteBulkRun($run);
            $runbookService->maybeFinalize($run);
            throw $e;
        } finally {
            $lock->release();
        }
    }
    private function backfillLifecycleFields(Finding $finding, CarbonImmutable $backfillStartedAt): void
    {
        $createdAt = $finding->created_at !== null ? CarbonImmutable::instance($finding->created_at) : $backfillStartedAt;
        if ($finding->first_seen_at === null) {
            $finding->first_seen_at = $createdAt;
        }
        if ($finding->last_seen_at === null) {
            $finding->last_seen_at = $createdAt;
        }
        if ($finding->last_seen_at !== null && $finding->first_seen_at !== null) {
            $lastSeen = CarbonImmutable::instance($finding->last_seen_at);
            $firstSeen = CarbonImmutable::instance($finding->first_seen_at);
            if ($lastSeen->lessThan($firstSeen)) {
                $finding->last_seen_at = $firstSeen;
            }
        }
        $timesSeen = is_numeric($finding->times_seen) ? (int) $finding->times_seen : 0;
        if ($timesSeen < 1) {
            $finding->times_seen = 1;
        }
    }
    private function backfillLegacyAcknowledgedStatus(Finding $finding): void
    {
        if ($finding->status !== Finding::STATUS_ACKNOWLEDGED) {
            return;
        }
        $finding->status = Finding::STATUS_TRIAGED;
        if ($finding->triaged_at === null) {
            if ($finding->acknowledged_at !== null) {
                $finding->triaged_at = CarbonImmutable::instance($finding->acknowledged_at);
            } elseif ($finding->created_at !== null) {
                $finding->triaged_at = CarbonImmutable::instance($finding->created_at);
            }
        }
    }
    private function backfillSlaFields(
        Finding $finding,
        Tenant $tenant,
        FindingSlaPolicy $slaPolicy,
        CarbonImmutable $backfillStartedAt,
    ): void {
        if (! Finding::isOpenStatus((string) $finding->status)) {
            return;
        }
        if ($finding->sla_days === null) {
            $finding->sla_days = $slaPolicy->daysForSeverity((string) $finding->severity, $tenant);
        }
        if ($finding->due_at === null) {
            $finding->due_at = $slaPolicy->dueAtForSeverity((string) $finding->severity, $tenant, $backfillStartedAt);
        }
    }
    private function backfillDriftRecurrenceKey(Finding $finding): void
    {
        if ($finding->finding_type !== Finding::FINDING_TYPE_DRIFT) {
            return;
        }
        if ($finding->recurrence_key !== null && trim((string) $finding->recurrence_key) !== '') {
            return;
        }
        $tenantId = (int) ($finding->tenant_id ?? 0);
        $scopeKey = (string) ($finding->scope_key ?? '');
        $subjectType = (string) ($finding->subject_type ?? '');
        $subjectExternalId = (string) ($finding->subject_external_id ?? '');
        if ($tenantId <= 0 || $scopeKey === '' || $subjectType === '' || $subjectExternalId === '') {
            return;
        }
        $evidence = is_array($finding->evidence_jsonb) ? $finding->evidence_jsonb : [];
        $kind = Arr::get($evidence, 'summary.kind');
        $changeType = Arr::get($evidence, 'change_type');
        $kind = is_string($kind) ? $kind : '';
        $changeType = is_string($changeType) ? $changeType : '';
        if ($kind === '') {
            return;
        }
        $dimension = $this->recurrenceDimension($kind, $changeType);
        $finding->recurrence_key = hash('sha256', sprintf(
            'drift:%d:%s:%s:%s:%s',
            $tenantId,
            $scopeKey,
            $subjectType,
            $subjectExternalId,
            $dimension,
        ));
    }
    private function recurrenceDimension(string $kind, string $changeType): string
    {
        $kind = strtolower(trim($kind));
        $changeType = strtolower(trim($changeType));
        return match ($kind) {
            'policy_snapshot', 'baseline_compare' => sprintf('%s:%s', $kind, $changeType !== '' ? $changeType : 'modified'),
            default => $kind,
        };
    }
    private function consolidateDriftDuplicates(Tenant $tenant, CarbonImmutable $backfillStartedAt): int
    {
        $duplicateKeys = Finding::query()
            ->where('tenant_id', $tenant->getKey())
            ->where('finding_type', Finding::FINDING_TYPE_DRIFT)
            ->whereNotNull('recurrence_key')
            ->select(['recurrence_key'])
            ->groupBy('recurrence_key')
            ->havingRaw('COUNT(*) > 1')
            ->pluck('recurrence_key')
            ->filter(static fn (mixed $value): bool => is_string($value) && trim($value) !== '')
            ->values();
        if ($duplicateKeys->isEmpty()) {
            return 0;
        }
        $consolidated = 0;
        foreach ($duplicateKeys as $recurrenceKey) {
            if (! is_string($recurrenceKey) || $recurrenceKey === '') {
                continue;
            }
            $findings = Finding::query()
                ->where('tenant_id', $tenant->getKey())
                ->where('finding_type', Finding::FINDING_TYPE_DRIFT)
                ->where('recurrence_key', $recurrenceKey)
                ->orderBy('id')
                ->get();
            $canonical = $this->chooseCanonicalDriftFinding($findings, $recurrenceKey);
            foreach ($findings as $finding) {
                if (! $finding instanceof Finding) {
                    continue;
                }
                if ($canonical instanceof Finding && (int) $finding->getKey() === (int) $canonical->getKey()) {
                    continue;
                }
                $finding->forceFill([
                    'status' => Finding::STATUS_CLOSED,
                    'resolved_at' => null,
                    'resolved_reason' => null,
                    'closed_at' => $backfillStartedAt,
                    'closed_reason' => Finding::CLOSE_REASON_DUPLICATE,
                    'closed_by_user_id' => null,
                    'recurrence_key' => null,
                ])->save();
                $consolidated++;
            }
        }
        return $consolidated;
    }
    /**
     * @param  Collection<int, Finding>  $findings
     */
    private function chooseCanonicalDriftFinding(Collection $findings, string $recurrenceKey): ?Finding
    {
        if ($findings->isEmpty()) {
            return null;
        }
        $openCandidates = $findings->filter(static fn (Finding $finding): bool => Finding::isOpenStatus((string) $finding->status));
        $candidates = $openCandidates->isNotEmpty() ? $openCandidates : $findings;
        $alreadyCanonical = $candidates->first(static fn (Finding $finding): bool => (string) $finding->fingerprint === $recurrenceKey);
        if ($alreadyCanonical instanceof Finding) {
            return $alreadyCanonical;
        }
        /** @var Finding $sorted */
        $sorted = $candidates
            ->sortByDesc(function (Finding $finding): array {
                $lastSeen = $finding->last_seen_at !== null ? CarbonImmutable::instance($finding->last_seen_at)->getTimestamp() : 0;
                $createdAt = $finding->created_at !== null ? CarbonImmutable::instance($finding->created_at)->getTimestamp() : 0;
                return [
                    max($lastSeen, $createdAt),
                    (int) $finding->getKey(),
                ];
            })
            ->first();
        return $sorted;
    }
 }
--- a/apps/platform/app/Jobs/BackfillFindingLifecycleWorkspaceJob.php
+++ b/apps/platform/app/Jobs/BackfillFindingLifecycleWorkspaceJob.php
@ -1,95 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Jobs;
 use App\Models\OperationRun;
 use App\Services\OperationRunService;
 use App\Services\Runbooks\FindingsLifecycleBackfillRunbookService;
 use App\Services\System\AllowedTenantUniverse;
 use App\Support\OperationRunOutcome;
 use App\Support\OperationRunStatus;
 use Illuminate\Bus\Queueable;
 use Illuminate\Contracts\Queue\ShouldQueue;
 use Illuminate\Foundation\Bus\Dispatchable;
 use Illuminate\Queue\InteractsWithQueue;
 use Illuminate\Queue\SerializesModels;
 class BackfillFindingLifecycleWorkspaceJob implements ShouldQueue
 {
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
    public function __construct(
        public readonly int $operationRunId,
        public readonly int $workspaceId,
    ) {}
    public function handle(
        OperationRunService $operationRunService,
        AllowedTenantUniverse $allowedTenantUniverse,
        FindingsLifecycleBackfillRunbookService $runbookService,
    ): void {
        $run = OperationRun::query()->find($this->operationRunId);
        if (! $run instanceof OperationRun) {
            return;
        }
        if ((int) $run->workspace_id !== $this->workspaceId) {
            return;
        }
        if ($run->tenant_id !== null) {
            return;
        }
        $tenantIds = $allowedTenantUniverse
            ->query()
            ->where('workspace_id', $this->workspaceId)
            ->orderBy('id')
            ->pluck('id')
            ->map(static fn (mixed $id): int => (int) $id)
            ->all();
        $tenantCount = count($tenantIds);
        $operationRunService->updateRun(
            $run,
            status: OperationRunStatus::Running->value,
            outcome: OperationRunOutcome::Pending->value,
            summaryCounts: [
                'tenants' => $tenantCount,
                'total' => $tenantCount,
                'processed' => 0,
                'updated' => 0,
                'skipped' => 0,
                'failed' => 0,
            ],
        );
        if ($tenantCount === 0) {
            $operationRunService->updateRun(
                $run,
                status: OperationRunStatus::Completed->value,
                outcome: OperationRunOutcome::Succeeded->value,
            );
            $runbookService->maybeFinalize($run);
            return;
        }
        foreach ($tenantIds as $tenantId) {
            if ($tenantId <= 0) {
                continue;
            }
            BackfillFindingLifecycleTenantIntoWorkspaceRunJob::dispatch(
                operationRunId: (int) $run->getKey(),
                workspaceId: $this->workspaceId,
                tenantId: $tenantId,
            );
        }
    }
 }
--- a/apps/platform/app/Models/Finding.php
+++ b/apps/platform/app/Models/Finding.php
@ -33,8 +33,6 @@ class Finding extends Model
    public const string STATUS_NEW = 'new';
    public const string STATUS_ACKNOWLEDGED = 'acknowledged';
    public const string STATUS_TRIAGED = 'triaged';
    public const string STATUS_IN_PROGRESS = 'in_progress';
@ -169,10 +167,7 @@ public static function terminalStatuses(): array
     */
    public static function openStatusesForQuery(): array
    {
-        return [
+        return self::openStatuses();
            ...self::openStatuses(),
            self::STATUS_ACKNOWLEDGED,
        ];
    }
    /**
@ -295,10 +290,6 @@ public static function isReopenReason(?string $reason): bool
    public static function canonicalizeStatus(?string $status): ?string
    {
        if ($status === self::STATUS_ACKNOWLEDGED) {
            return self::STATUS_TRIAGED;
        }
        return $status;
    }
@ -324,23 +315,6 @@ public function isRiskAccepted(): bool
        return (string) $this->status === self::STATUS_RISK_ACCEPTED;
    }
    public function acknowledge(User $user): self
    {
        if ($this->status === self::STATUS_ACKNOWLEDGED) {
            return $this;
        }
        $this->forceFill([
            'status' => self::STATUS_ACKNOWLEDGED,
            'acknowledged_at' => now(),
            'acknowledged_by_user_id' => $user->getKey(),
        ]);
        $this->save();
        return $this;
    }
    public function resolve(string $reason): self
    {
        $this->forceFill([
--- a/apps/platform/app/Models/ProductUsageEvent.php
+++ b/apps/platform/app/Models/ProductUsageEvent.php
@ -0,0 +1,55 @@
 <?php
 declare(strict_types=1);
 namespace App\Models;
 use App\Support\Concerns\DerivesWorkspaceIdFromTenant;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 class ProductUsageEvent extends Model
 {
    use DerivesWorkspaceIdFromTenant;
    /** @use HasFactory<\Database\Factories\ProductUsageEventFactory> */
    use HasFactory;
    protected $guarded = [];
    /**
     * @return array<string, string>
     */
    protected function casts(): array
    {
        return [
            'metadata' => 'array',
            'occurred_at' => 'datetime',
        ];
    }
    /**
     * @return BelongsTo<Workspace, $this>
     */
    public function workspace(): BelongsTo
    {
        return $this->belongsTo(Workspace::class);
    }
    /**
     * @return BelongsTo<Tenant, $this>
     */
    public function tenant(): BelongsTo
    {
        return $this->belongsTo(Tenant::class)->withTrashed();
    }
    /**
     * @return BelongsTo<User, $this>
     */
    public function user(): BelongsTo
    {
        return $this->belongsTo(User::class);
    }
 }
--- a/apps/platform/app/Models/SupportRequest.php
+++ b/apps/platform/app/Models/SupportRequest.php
@ -0,0 +1,121 @@
 <?php
 declare(strict_types=1);
 namespace App\Models;
 use App\Support\Concerns\DerivesWorkspaceIdFromTenant;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 class SupportRequest extends Model
 {
    use DerivesWorkspaceIdFromTenant;
    /** @use HasFactory<\Database\Factories\SupportRequestFactory> */
    use HasFactory;
    public const string PRIMARY_CONTEXT_TENANT = 'tenant';
    public const string PRIMARY_CONTEXT_OPERATION_RUN = 'operation_run';
    public const string ATTACHMENT_MODE_DIAGNOSTIC_SNAPSHOT_ATTACHED = 'diagnostic_snapshot_attached';
    public const string ATTACHMENT_MODE_CANONICAL_CONTEXT_ONLY = 'canonical_context_only';
    public const string SEVERITY_LOW = 'low';
    public const string SEVERITY_NORMAL = 'normal';
    public const string SEVERITY_HIGH = 'high';
    public const string SEVERITY_BLOCKING = 'blocking';
    protected $guarded = [];
    /**
     * @return array<string, string>
     */
    protected function casts(): array
    {
        return [
            'context_envelope' => 'array',
        ];
    }
    /**
     * @return array<string, string>
     */
    public static function severityOptions(): array
    {
        return [
            self::SEVERITY_LOW => 'Low',
            self::SEVERITY_NORMAL => 'Normal',
            self::SEVERITY_HIGH => 'High',
            self::SEVERITY_BLOCKING => 'Blocking',
        ];
    }
    /**
     * @return list<string>
     */
    public static function severityValues(): array
    {
        return array_keys(self::severityOptions());
    }
    /**
     * @return list<string>
     */
    public static function primaryContextTypes(): array
    {
        return [
            self::PRIMARY_CONTEXT_TENANT,
            self::PRIMARY_CONTEXT_OPERATION_RUN,
        ];
    }
    /**
     * @return list<string>
     */
    public static function attachmentModes(): array
    {
        return [
            self::ATTACHMENT_MODE_DIAGNOSTIC_SNAPSHOT_ATTACHED,
            self::ATTACHMENT_MODE_CANONICAL_CONTEXT_ONLY,
        ];
    }
    /**
     * @return BelongsTo<Workspace, $this>
     */
    public function workspace(): BelongsTo
    {
        return $this->belongsTo(Workspace::class);
    }
    /**
     * @return BelongsTo<Tenant, $this>
     */
    public function tenant(): BelongsTo
    {
        return $this->belongsTo(Tenant::class);
    }
    /**
     * @return BelongsTo<OperationRun, $this>
     */
    public function operationRun(): BelongsTo
    {
        return $this->belongsTo(OperationRun::class);
    }
    /**
     * @return BelongsTo<User, $this>
     */
    public function initiator(): BelongsTo
    {
        return $this->belongsTo(User::class, 'initiated_by_user_id');
    }
 }
--- a/apps/platform/app/Models/User.php
+++ b/apps/platform/app/Models/User.php
@ -39,6 +39,7 @@ class User extends Authenticatable implements FilamentUser, HasDefaultTenant, Ha
        'password',
        'entra_tenant_id',
        'entra_object_id',
        'preferred_locale',
    ];
    /**
--- a/apps/platform/app/Policies/FindingPolicy.php
+++ b/apps/platform/app/Policies/FindingPolicy.php
@ -49,10 +49,7 @@ public function update(User $user, Finding $finding): Response|bool
    public function triage(User $user, Finding $finding): Response|bool
    {
-        return $this->canMutateWithAnyCapability($user, $finding, [
+        return $this->canMutateWithCapability($user, $finding, Capabilities::TENANT_FINDINGS_TRIAGE);
            Capabilities::TENANT_FINDINGS_TRIAGE,
            Capabilities::TENANT_FINDINGS_ACKNOWLEDGE,
        ]);
    }
    public function assign(User $user, Finding $finding): Response|bool
--- a/apps/platform/app/Providers/Filament/AdminPanelProvider.php
+++ b/apps/platform/app/Providers/Filament/AdminPanelProvider.php
@ -7,11 +7,13 @@
 use App\Filament\Pages\ChooseWorkspace;
 use App\Filament\Pages\Findings\FindingsHygieneReport;
 use App\Filament\Pages\Findings\FindingsIntakeQueue;
 use App\Filament\Pages\Governance\GovernanceInbox;
 use App\Filament\Pages\Findings\MyFindingsInbox;
 use App\Filament\Pages\InventoryCoverage;
 use App\Filament\Pages\Monitoring\FindingExceptionsQueue;
 use App\Filament\Pages\NoAccess;
 use App\Filament\Pages\Reviews\ReviewRegister;
 use App\Filament\Pages\Reviews\CustomerReviewWorkspace;
 use App\Filament\Pages\Settings\WorkspaceSettings;
 use App\Filament\Pages\TenantRequiredPermissions;
 use App\Filament\Pages\WorkspaceOverview;
@ -77,16 +79,16 @@ public function panel(Panel $panel): Panel
            ])
            ->navigationItems([
                WorkspaceOverview::navigationItem(),
-                NavigationItem::make('Integrations')
+                NavigationItem::make(fn (): string => __('localization.navigation.integrations'))
                    ->url(fn (): string => route('filament.admin.resources.provider-connections.index'))
                    ->icon('heroicon-o-link')
-                    ->group('Settings')
+                    ->group(fn (): string => __('localization.navigation.settings'))
                    ->sort(15)
                    ->visible(fn (): bool => ProviderConnectionResource::canViewAny()),
-                NavigationItem::make('Settings')
+                NavigationItem::make(fn (): string => __('localization.navigation.settings'))
                    ->url(fn (): string => WorkspaceSettings::getUrl(panel: 'admin'))
                    ->icon('heroicon-o-cog-6-tooth')
-                    ->group('Settings')
+                    ->group(fn (): string => __('localization.navigation.settings'))
                    ->sort(20)
                    ->visible(function (): bool {
                        $user = auth()->user();
@ -113,12 +115,12 @@ public function panel(Panel $panel): Panel
                        return $resolver->isMember($user, $workspace)
                            && $resolver->can($user, $workspace, Capabilities::WORKSPACE_SETTINGS_VIEW);
                    }),
-                NavigationItem::make('Manage workspaces')
+                NavigationItem::make(fn (): string => __('localization.navigation.manage_workspaces'))
                    ->url(function (): string {
                        return route('filament.admin.resources.workspaces.index');
                    })
                    ->icon('heroicon-o-squares-2x2')
-                    ->group('Settings')
+                    ->group(fn (): string => __('localization.navigation.settings'))
                    ->sort(10)
                    ->visible(function (): bool {
                        $user = auth()->user();
@ -134,15 +136,15 @@ public function panel(Panel $panel): Panel
                            ->whereIn('role', $roles)
                            ->exists();
                    }),
-                NavigationItem::make('Operations')
+                NavigationItem::make(fn (): string => __('localization.navigation.operations'))
                    ->url(fn (): string => route('admin.operations.index'))
                    ->icon('heroicon-o-queue-list')
-                    ->group('Monitoring')
+                    ->group(fn (): string => __('localization.navigation.monitoring'))
                    ->sort(10),
-                NavigationItem::make('Audit Log')
+                NavigationItem::make(fn (): string => __('localization.navigation.audit_log'))
                    ->url(fn (): string => route('admin.monitoring.audit-log'))
                    ->icon('heroicon-o-clipboard-document-list')
-                    ->group('Monitoring')
+                    ->group(fn (): string => __('localization.navigation.monitoring'))
                    ->sort(30),
            ])
            ->renderHook(
@ -179,10 +181,12 @@ public function panel(Panel $panel): Panel
                InventoryCoverage::class,
                TenantRequiredPermissions::class,
                WorkspaceSettings::class,
                GovernanceInbox::class,
                FindingsHygieneReport::class,
                FindingsIntakeQueue::class,
                MyFindingsInbox::class,
                FindingExceptionsQueue::class,
                CustomerReviewWorkspace::class,
                ReviewRegister::class,
            ])
            ->widgets([
@ -206,6 +210,7 @@ public function panel(Panel $panel): Panel
                DisableBladeIconComponents::class,
                DispatchServingFilamentEvent::class,
            ])
            ->middleware(['apply-resolved-locale:admin'], isPersistent: true)
            ->authMiddleware([
                Authenticate::class,
            ]);
--- a/apps/platform/app/Providers/Filament/SystemPanelProvider.php
+++ b/apps/platform/app/Providers/Filament/SystemPanelProvider.php
@ -42,6 +42,14 @@ public function panel(Panel $panel): Panel
                PanelsRenderHook::BODY_START,
                fn () => view('filament.system.components.break-glass-banner')->render(),
            )
            ->renderHook(
                PanelsRenderHook::TOPBAR_START,
                fn () => view('filament.partials.locale-switcher', [
                    'plane' => 'system',
                    'showPreference' => false,
                    'embedded' => false,
                ])->render(),
            )
            ->discoverPages(in: app_path('Filament/System/Pages'), for: 'App\\Filament\\System\\Pages')
            ->pages([
                Dashboard::class,
@ -59,6 +67,7 @@ public function panel(Panel $panel): Panel
                DisableBladeIconComponents::class,
                DispatchServingFilamentEvent::class,
            ])
            ->middleware(['apply-resolved-locale:system'], isPersistent: true)
            ->authMiddleware([
                Authenticate::class,
                'ensure-platform-capability:'.PlatformCapabilities::ACCESS_SYSTEM_PANEL,
--- a/apps/platform/app/Providers/Filament/TenantPanelProvider.php
+++ b/apps/platform/app/Providers/Filament/TenantPanelProvider.php
@ -50,20 +50,20 @@ public function panel(Panel $panel): Panel
                'primary' => Color::Indigo,
            ])
            ->navigationItems([
-                NavigationItem::make(OperationRunLinks::collectionLabel())
+                NavigationItem::make(fn (): string => __('localization.navigation.operations'))
                    ->url(fn (): string => route('admin.operations.index'))
                    ->icon('heroicon-o-queue-list')
-                    ->group('Monitoring')
+                    ->group(fn (): string => __('localization.navigation.monitoring'))
                    ->sort(10),
-                NavigationItem::make('Alerts')
+                NavigationItem::make(fn (): string => __('localization.navigation.alerts'))
                    ->url(fn (): string => url('/admin/alerts'))
                    ->icon('heroicon-o-bell-alert')
-                    ->group('Monitoring')
+                    ->group(fn (): string => __('localization.navigation.monitoring'))
                    ->sort(20),
-                NavigationItem::make('Audit Log')
+                NavigationItem::make(fn (): string => __('localization.navigation.audit_log'))
                    ->url(fn (): string => route('admin.monitoring.audit-log'))
                    ->icon('heroicon-o-clipboard-document-list')
-                    ->group('Monitoring')
+                    ->group(fn (): string => __('localization.navigation.monitoring'))
                    ->sort(30),
            ])
            ->renderHook(
@ -111,6 +111,7 @@ public function panel(Panel $panel): Panel
                DisableBladeIconComponents::class,
                DispatchServingFilamentEvent::class,
            ])
            ->middleware(['apply-resolved-locale:tenant'], isPersistent: true)
            ->authMiddleware([
                Authenticate::class,
            ]);
--- a/apps/platform/app/Services/Audit/WorkspaceAuditLogger.php
+++ b/apps/platform/app/Services/Audit/WorkspaceAuditLogger.php
@ -4,9 +4,10 @@
 namespace App\Services\Audit;
 use App\Models\Tenant;
 use App\Models\OperationRun;
 use App\Models\PlatformUser;
 use App\Models\SupportRequest;
 use App\Models\Tenant;
 use App\Models\User;
 use App\Models\Workspace;
 use App\Support\Audit\AuditActionId;
@ -14,6 +15,7 @@
 use App\Support\Audit\AuditActorType;
 use App\Support\Audit\AuditTargetSnapshot;
 use Carbon\CarbonImmutable;
 use InvalidArgumentException;
 class WorkspaceAuditLogger
 {
@ -136,4 +138,39 @@ public function logSupportDiagnosticsOpened(
            tenant: $tenant,
        );
    }
    public function logSupportRequestCreated(
        SupportRequest $supportRequest,
        User|PlatformUser|null $actor = null,
    ): \App\Models\AuditLog {
        $supportRequest->loadMissing(['tenant.workspace']);
        $tenant = $supportRequest->tenant;
        if (! $tenant instanceof Tenant) {
            throw new InvalidArgumentException('Support requests must belong to a tenant.');
        }
        return $this->log(
            workspace: $tenant->workspace,
            action: AuditActionId::SupportRequestCreated,
            context: [
                'internal_reference' => $supportRequest->internal_reference,
                'primary_context_type' => $supportRequest->primary_context_type,
                'primary_context_id' => $supportRequest->primary_context_type === SupportRequest::PRIMARY_CONTEXT_OPERATION_RUN
                    ? (string) $supportRequest->operation_run_id
                    : (string) $tenant->getKey(),
                'attachment_mode' => $supportRequest->attachment_mode,
                'redaction_mode' => (string) data_get($supportRequest->context_envelope, 'redaction_mode', 'default_redacted'),
            ],
            actor: $actor,
            status: 'success',
            resourceType: 'support_request',
            resourceId: (string) $supportRequest->getKey(),
            targetLabel: $supportRequest->internal_reference,
            summary: 'Support request created for '.$supportRequest->internal_reference,
            operationRunId: $supportRequest->operation_run_id !== null ? (int) $supportRequest->operation_run_id : null,
            tenant: $tenant,
        );
    }
 }
--- a/apps/platform/app/Services/Auth/RoleCapabilityMap.php
+++ b/apps/platform/app/Services/Auth/RoleCapabilityMap.php
@ -20,6 +20,7 @@ class RoleCapabilityMap
            Capabilities::TENANT_DELETE,
            Capabilities::TENANT_SYNC,
            Capabilities::SUPPORT_DIAGNOSTICS_VIEW,
            Capabilities::SUPPORT_REQUESTS_CREATE,
            Capabilities::TENANT_INVENTORY_SYNC_RUN,
            Capabilities::TENANT_FINDINGS_VIEW,
            Capabilities::TENANT_FINDINGS_TRIAGE,
@ -27,7 +28,6 @@ class RoleCapabilityMap
            Capabilities::TENANT_FINDINGS_RESOLVE,
            Capabilities::TENANT_FINDINGS_CLOSE,
            Capabilities::TENANT_FINDINGS_RISK_ACCEPT,
            Capabilities::TENANT_FINDINGS_ACKNOWLEDGE,
            Capabilities::FINDING_EXCEPTION_VIEW,
            Capabilities::FINDING_EXCEPTION_MANAGE,
            Capabilities::TENANT_VERIFICATION_ACKNOWLEDGE,
@ -65,6 +65,7 @@ class RoleCapabilityMap
            Capabilities::TENANT_MANAGE,
            Capabilities::TENANT_SYNC,
            Capabilities::SUPPORT_DIAGNOSTICS_VIEW,
            Capabilities::SUPPORT_REQUESTS_CREATE,
            Capabilities::TENANT_INVENTORY_SYNC_RUN,
            Capabilities::TENANT_FINDINGS_VIEW,
            Capabilities::TENANT_FINDINGS_TRIAGE,
@ -72,7 +73,6 @@ class RoleCapabilityMap
            Capabilities::TENANT_FINDINGS_RESOLVE,
            Capabilities::TENANT_FINDINGS_CLOSE,
            Capabilities::TENANT_FINDINGS_RISK_ACCEPT,
            Capabilities::TENANT_FINDINGS_ACKNOWLEDGE,
            Capabilities::FINDING_EXCEPTION_VIEW,
            Capabilities::FINDING_EXCEPTION_MANAGE,
            Capabilities::TENANT_VERIFICATION_ACKNOWLEDGE,
@ -106,10 +106,10 @@ class RoleCapabilityMap
            Capabilities::TENANT_VIEW,
            Capabilities::TENANT_SYNC,
            Capabilities::SUPPORT_DIAGNOSTICS_VIEW,
            Capabilities::SUPPORT_REQUESTS_CREATE,
            Capabilities::TENANT_INVENTORY_SYNC_RUN,
            Capabilities::TENANT_FINDINGS_VIEW,
            Capabilities::TENANT_FINDINGS_TRIAGE,
            Capabilities::TENANT_FINDINGS_ACKNOWLEDGE,
            Capabilities::FINDING_EXCEPTION_VIEW,
            Capabilities::TENANT_MEMBERSHIP_VIEW,
--- a/apps/platform/app/Services/Entitlements/WorkspaceCommercialLifecycleResolver.php
+++ b/apps/platform/app/Services/Entitlements/WorkspaceCommercialLifecycleResolver.php
@ -0,0 +1,410 @@
 <?php
 declare(strict_types=1);
 namespace App\Services\Entitlements;
 use App\Models\AuditLog;
 use App\Models\Tenant;
 use App\Models\Workspace;
 use App\Models\WorkspaceSetting;
 use App\Services\Settings\SettingsResolver;
 use App\Support\Audit\AuditActionId;
 use Carbon\CarbonInterface;
 final class WorkspaceCommercialLifecycleResolver
 {
    public const SETTING_DOMAIN = WorkspaceEntitlementResolver::SETTING_DOMAIN;
    public const SETTING_COMMERCIAL_LIFECYCLE_STATE = 'commercial_lifecycle_state';
    public const SETTING_COMMERCIAL_LIFECYCLE_REASON = 'commercial_lifecycle_reason';
    public const STATE_TRIAL = 'trial';
    public const STATE_GRACE = 'grace';
    public const STATE_ACTIVE_PAID = 'active_paid';
    public const STATE_SUSPENDED_READ_ONLY = 'suspended_read_only';
    public const SOURCE_DEFAULT_ACTIVE_PAID = 'default_active_paid';
    public const SOURCE_WORKSPACE_SETTING = 'workspace_setting';
    public const ACTION_MANAGED_TENANT_ACTIVATION = 'managed_tenant_activation';
    public const ACTION_REVIEW_PACK_START = 'review_pack_start';
    public const ACTION_REVIEW_HISTORY_READ = 'review_history_read';
    public const ACTION_EVIDENCE_READ = 'evidence_read';
    public const ACTION_GENERATED_PACK_READ = 'generated_pack_read';
    public const OUTCOME_ALLOW = 'allow';
    public const OUTCOME_WARN = 'warn';
    public const OUTCOME_BLOCK = 'block';
    public const OUTCOME_ALLOW_READ_ONLY = 'allow_read_only';
    public const REASON_FAMILY_ENTITLEMENT_SUBSTRATE = 'entitlement_substrate';
    public const REASON_FAMILY_COMMERCIAL_LIFECYCLE = 'commercial_lifecycle';
    public function __construct(
        private readonly SettingsResolver $settingsResolver,
        private readonly WorkspaceEntitlementResolver $workspaceEntitlementResolver,
    ) {}
    /**
     * @return list<string>
     */
    public static function stateIds(): array
    {
        return [
            self::STATE_TRIAL,
            self::STATE_GRACE,
            self::STATE_ACTIVE_PAID,
            self::STATE_SUSPENDED_READ_ONLY,
        ];
    }
    /**
     * @return array<string, string>
     */
    public static function stateLabels(): array
    {
        return [
            self::STATE_TRIAL => 'Trial',
            self::STATE_GRACE => 'Grace',
            self::STATE_ACTIVE_PAID => 'Active paid',
            self::STATE_SUSPENDED_READ_ONLY => 'Suspended / read-only',
        ];
    }
    /**
     * @return array<string, string>
     */
    public static function stateDescriptions(): array
    {
        return [
            self::STATE_TRIAL => 'Expansion and review-pack starts are available while the workspace is in trial.',
            self::STATE_GRACE => 'New managed-tenant activation is frozen, but review-pack starts remain available with a warning.',
            self::STATE_ACTIVE_PAID => 'Expansion and review-pack starts are available for the active paid workspace.',
            self::STATE_SUSPENDED_READ_ONLY => 'New activation and review-pack starts are blocked while existing review, evidence, and generated-pack access remains read-only.',
        ];
    }
    /**
     * @return array<string, mixed>
     */
    public function summary(Workspace $workspace): array
    {
        $lifecycle = $this->resolve($workspace);
        return $lifecycle + [
            'entitlement_summary' => $this->workspaceEntitlementResolver->summary($workspace),
            'action_decisions' => [
                self::ACTION_MANAGED_TENANT_ACTIVATION => $this->actionDecision($workspace, self::ACTION_MANAGED_TENANT_ACTIVATION, $lifecycle),
                self::ACTION_REVIEW_PACK_START => $this->actionDecision($workspace, self::ACTION_REVIEW_PACK_START, $lifecycle),
                self::ACTION_REVIEW_HISTORY_READ => $this->actionDecision($workspace, self::ACTION_REVIEW_HISTORY_READ, $lifecycle),
                self::ACTION_EVIDENCE_READ => $this->actionDecision($workspace, self::ACTION_EVIDENCE_READ, $lifecycle),
                self::ACTION_GENERATED_PACK_READ => $this->actionDecision($workspace, self::ACTION_GENERATED_PACK_READ, $lifecycle),
            ],
        ];
    }
    /**
     * @return array{
     *     workspace_id: int,
     *     state: string,
     *     state_label: string,
     *     source: string,
     *     source_label: string,
     *     rationale: string|null,
     *     description: string,
     *     last_changed_at: CarbonInterface|null,
     *     last_changed_by: string|null
     * }
     */
    public function resolve(Workspace $workspace): array
    {
        $stateSetting = $this->settingsResolver->resolveDetailed(
            workspace: $workspace,
            domain: self::SETTING_DOMAIN,
            key: self::SETTING_COMMERCIAL_LIFECYCLE_STATE,
        );
        $rawState = is_string($stateSetting['value'] ?? null)
            ? strtolower(trim((string) $stateSetting['value']))
            : null;
        $state = in_array($rawState, self::stateIds(), true)
            ? $rawState
            : self::STATE_ACTIVE_PAID;
        $source = ($stateSetting['source'] ?? null) === 'workspace_override' && $rawState !== null
            ? self::SOURCE_WORKSPACE_SETTING
            : self::SOURCE_DEFAULT_ACTIVE_PAID;
        $rationale = $this->settingsResolver->resolveValue(
            workspace: $workspace,
            domain: self::SETTING_DOMAIN,
            key: self::SETTING_COMMERCIAL_LIFECYCLE_REASON,
        );
        $labels = self::stateLabels();
        $descriptions = self::stateDescriptions();
        $lastChanged = $this->lastChangedMetadata($workspace);
        return [
            'workspace_id' => (int) $workspace->getKey(),
            'state' => $state,
            'state_label' => $labels[$state],
            'source' => $source,
            'source_label' => $source === self::SOURCE_WORKSPACE_SETTING
                ? 'workspace setting'
                : 'default active paid',
            'rationale' => is_string($rationale) && trim($rationale) !== '' ? trim($rationale) : null,
            'description' => $descriptions[$state],
            'last_changed_at' => $lastChanged['last_changed_at'],
            'last_changed_by' => $lastChanged['last_changed_by'],
        ];
    }
    /**
     * @param  array<string, mixed>|null  $lifecycle
     * @return array<string, mixed>
     */
    public function actionDecision(Workspace $workspace, string $actionKey, ?array $lifecycle = null): array
    {
        $lifecycle ??= $this->resolve($workspace);
        return match ($actionKey) {
            self::ACTION_MANAGED_TENANT_ACTIVATION => $this->managedTenantActivationDecision($workspace, $lifecycle),
            self::ACTION_REVIEW_PACK_START => $this->reviewPackStartDecision($workspace, $lifecycle),
            self::ACTION_REVIEW_HISTORY_READ,
            self::ACTION_EVIDENCE_READ,
            self::ACTION_GENERATED_PACK_READ => $this->readOnlyDecision($actionKey, $lifecycle),
            default => throw new \InvalidArgumentException(sprintf('Unknown commercial lifecycle action key: %s', $actionKey)),
        };
    }
    /**
     * @return array<string, mixed>
     */
    public function reviewPackStartDecisionForTenant(Tenant $tenant): array
    {
        $tenant->loadMissing('workspace');
        return $this->actionDecision($tenant->workspace, self::ACTION_REVIEW_PACK_START);
    }
    /**
     * @param  array<string, mixed>  $lifecycle
     * @return array<string, mixed>
     */
    private function managedTenantActivationDecision(Workspace $workspace, array $lifecycle): array
    {
        $substrateDecision = $this->workspaceEntitlementResolver->resolve(
            $workspace,
            WorkspaceEntitlementResolver::KEY_MANAGED_TENANT_ACTIVATION_LIMIT,
        );
        if ((bool) ($substrateDecision['is_blocked'] ?? false)) {
            return $this->decision(
                lifecycle: $lifecycle,
                actionKey: self::ACTION_MANAGED_TENANT_ACTIVATION,
                outcome: self::OUTCOME_BLOCK,
                reasonFamily: self::REASON_FAMILY_ENTITLEMENT_SUBSTRATE,
                message: (string) ($substrateDecision['block_reason'] ?? 'Workspace entitlement currently blocks managed tenant activation.'),
                substrateDecision: $substrateDecision,
            );
        }
        return match ($lifecycle['state']) {
            self::STATE_GRACE => $this->decision(
                lifecycle: $lifecycle,
                actionKey: self::ACTION_MANAGED_TENANT_ACTIVATION,
                outcome: self::OUTCOME_BLOCK,
                reasonFamily: self::REASON_FAMILY_COMMERCIAL_LIFECYCLE,
                message: 'New managed-tenant activation is frozen while this workspace is in grace.',
                substrateDecision: $substrateDecision,
            ),
            self::STATE_SUSPENDED_READ_ONLY => $this->decision(
                lifecycle: $lifecycle,
                actionKey: self::ACTION_MANAGED_TENANT_ACTIVATION,
                outcome: self::OUTCOME_BLOCK,
                reasonFamily: self::REASON_FAMILY_COMMERCIAL_LIFECYCLE,
                message: 'This workspace is suspended / read-only. New managed-tenant activation is blocked, but existing review and evidence history remains available.',
                substrateDecision: $substrateDecision,
            ),
            default => $this->decision(
                lifecycle: $lifecycle,
                actionKey: self::ACTION_MANAGED_TENANT_ACTIVATION,
                outcome: self::OUTCOME_ALLOW,
                reasonFamily: null,
                message: 'Managed-tenant activation is available for this workspace commercial state.',
                substrateDecision: $substrateDecision,
            ),
        };
    }
    /**
     * @param  array<string, mixed>  $lifecycle
     * @return array<string, mixed>
     */
    private function reviewPackStartDecision(Workspace $workspace, array $lifecycle): array
    {
        $substrateDecision = $this->workspaceEntitlementResolver->resolve(
            $workspace,
            WorkspaceEntitlementResolver::KEY_REVIEW_PACK_GENERATION_ENABLED,
        );
        if ((bool) ($substrateDecision['is_blocked'] ?? false)) {
            return $this->decision(
                lifecycle: $lifecycle,
                actionKey: self::ACTION_REVIEW_PACK_START,
                outcome: self::OUTCOME_BLOCK,
                reasonFamily: self::REASON_FAMILY_ENTITLEMENT_SUBSTRATE,
                message: (string) ($substrateDecision['block_reason'] ?? 'Workspace entitlement currently blocks review pack generation.'),
                substrateDecision: $substrateDecision,
            );
        }
        return match ($lifecycle['state']) {
            self::STATE_GRACE => $this->decision(
                lifecycle: $lifecycle,
                actionKey: self::ACTION_REVIEW_PACK_START,
                outcome: self::OUTCOME_WARN,
                reasonFamily: self::REASON_FAMILY_COMMERCIAL_LIFECYCLE,
                message: 'Workspace is in grace. Review-pack starts remain available, but managed-tenant expansion is frozen.',
                substrateDecision: $substrateDecision,
            ),
            self::STATE_SUSPENDED_READ_ONLY => $this->decision(
                lifecycle: $lifecycle,
                actionKey: self::ACTION_REVIEW_PACK_START,
                outcome: self::OUTCOME_BLOCK,
                reasonFamily: self::REASON_FAMILY_COMMERCIAL_LIFECYCLE,
                message: 'This workspace is suspended / read-only. New review-pack starts are blocked, but existing review packs, evidence, and review history remain available.',
                substrateDecision: $substrateDecision,
            ),
            default => $this->decision(
                lifecycle: $lifecycle,
                actionKey: self::ACTION_REVIEW_PACK_START,
                outcome: self::OUTCOME_ALLOW,
                reasonFamily: null,
                message: 'Review-pack starts are available for this workspace commercial state.',
                substrateDecision: $substrateDecision,
            ),
        };
    }
    /**
     * @param  array<string, mixed>  $lifecycle
     * @return array<string, mixed>
     */
    private function readOnlyDecision(string $actionKey, array $lifecycle): array
    {
        if (($lifecycle['state'] ?? null) === self::STATE_SUSPENDED_READ_ONLY) {
            return $this->decision(
                lifecycle: $lifecycle,
                actionKey: $actionKey,
                outcome: self::OUTCOME_ALLOW_READ_ONLY,
                reasonFamily: self::REASON_FAMILY_COMMERCIAL_LIFECYCLE,
                message: 'Suspended / read-only workspaces keep existing review, evidence, and generated-pack consumption available under current RBAC.',
                substrateDecision: null,
            );
        }
        return $this->decision(
            lifecycle: $lifecycle,
            actionKey: $actionKey,
            outcome: self::OUTCOME_ALLOW,
            reasonFamily: null,
            message: 'Read-only history remains available under current RBAC.',
            substrateDecision: null,
        );
    }
    /**
     * @param  array<string, mixed>  $lifecycle
     * @param  array<string, mixed>|null  $substrateDecision
     * @return array<string, mixed>
     */
    private function decision(
        array $lifecycle,
        string $actionKey,
        string $outcome,
        ?string $reasonFamily,
        string $message,
        ?array $substrateDecision,
    ): array {
        return [
            'workspace_id' => (int) ($lifecycle['workspace_id'] ?? 0),
            'action_key' => $actionKey,
            'outcome' => $outcome,
            'is_blocked' => $outcome === self::OUTCOME_BLOCK,
            'is_warning' => $outcome === self::OUTCOME_WARN,
            'block_reason' => $outcome === self::OUTCOME_BLOCK ? $message : null,
            'warning_reason' => $outcome === self::OUTCOME_WARN ? $message : null,
            'message' => $message,
            'reason_family' => $reasonFamily,
            'state' => (string) $lifecycle['state'],
            'state_label' => (string) $lifecycle['state_label'],
            'source' => (string) $lifecycle['source'],
            'source_label' => (string) $lifecycle['source_label'],
            'rationale' => $lifecycle['rationale'] ?? null,
            'entitlement_decision' => $substrateDecision,
        ];
    }
    /**
     * @return array{last_changed_at: CarbonInterface|null, last_changed_by: string|null}
     */
    private function lastChangedMetadata(Workspace $workspace): array
    {
        $audit = AuditLog::query()
            ->where('workspace_id', (int) $workspace->getKey())
            ->where('action', AuditActionId::WorkspaceSettingUpdated->value)
            ->where('resource_type', 'workspace_setting')
            ->where('resource_id', self::SETTING_DOMAIN.'.'.self::SETTING_COMMERCIAL_LIFECYCLE_STATE)
            ->latest('recorded_at')
            ->latest('id')
            ->first();
        if ($audit instanceof AuditLog) {
            return [
                'last_changed_at' => $audit->recorded_at,
                'last_changed_by' => $audit->actorDisplayLabel(),
            ];
        }
        $record = WorkspaceSetting::query()
            ->where('workspace_id', (int) $workspace->getKey())
            ->where('domain', self::SETTING_DOMAIN)
            ->whereIn('key', [
                self::SETTING_COMMERCIAL_LIFECYCLE_STATE,
                self::SETTING_COMMERCIAL_LIFECYCLE_REASON,
            ])
            ->with('updatedByUser:id,name')
            ->latest('updated_at')
            ->latest('id')
            ->first();
        if (! $record instanceof WorkspaceSetting) {
            return [
                'last_changed_at' => null,
                'last_changed_by' => null,
            ];
        }
        return [
            'last_changed_at' => $record->updated_at,
            'last_changed_by' => $record->updatedByUser?->name,
        ];
    }
 }
--- a/apps/platform/app/Services/Entitlements/WorkspaceEntitlementResolver.php
+++ b/apps/platform/app/Services/Entitlements/WorkspaceEntitlementResolver.php
@ -0,0 +1,327 @@
 <?php
 declare(strict_types=1);
 namespace App\Services\Entitlements;
 use App\Models\Tenant;
 use App\Models\Workspace;
 use App\Models\WorkspaceSetting;
 use App\Services\Settings\SettingsResolver;
 use Carbon\CarbonInterface;
 final class WorkspaceEntitlementResolver
 {
    public const SETTING_DOMAIN = 'entitlements';
    public const SETTING_PLAN_PROFILE = 'plan_profile';
    public const SETTING_MANAGED_TENANT_LIMIT_OVERRIDE_VALUE = 'managed_tenant_limit_override_value';
    public const SETTING_MANAGED_TENANT_LIMIT_OVERRIDE_REASON = 'managed_tenant_limit_override_reason';
    public const SETTING_REVIEW_PACK_GENERATION_OVERRIDE_VALUE = 'review_pack_generation_override_value';
    public const SETTING_REVIEW_PACK_GENERATION_OVERRIDE_REASON = 'review_pack_generation_override_reason';
    public const KEY_MANAGED_TENANT_ACTIVATION_LIMIT = 'managed_tenant_activation_limit';
    public const KEY_REVIEW_PACK_GENERATION_ENABLED = 'review_pack_generation_enabled';
    public function __construct(
        private SettingsResolver $settingsResolver,
        private WorkspacePlanProfileCatalog $planProfileCatalog,
    ) {}
    /**
     * @return array{
     *     plan_profile: array{id: string, label: string, description: string, managed_tenant_limit_default: int, review_pack_generation_default: bool, is_default: bool},
     *     decisions: array<string, array{
     *         workspace_id: int,
     *         plan_profile_id: string,
     *         plan_profile_label: string,
     *         plan_profile_description: string,
     *         key: string,
     *         effective_value: int|bool,
     *         source: 'plan_profile_default'|'workspace_override',
     *         rationale: string|null,
     *         current_usage: int|null,
     *         remaining_capacity: int|null,
     *         is_blocked: bool,
     *         block_reason: string|null,
     *         last_changed_at: CarbonInterface|null,
     *         last_changed_by: string|null
     *     }>
     * }
     */
    public function summary(Workspace $workspace): array
    {
        $planProfile = $this->resolvePlanProfile($workspace);
        return [
            'plan_profile' => $planProfile,
            'decisions' => [
                self::KEY_MANAGED_TENANT_ACTIVATION_LIMIT => $this->resolve($workspace, self::KEY_MANAGED_TENANT_ACTIVATION_LIMIT, $planProfile),
                self::KEY_REVIEW_PACK_GENERATION_ENABLED => $this->resolve($workspace, self::KEY_REVIEW_PACK_GENERATION_ENABLED, $planProfile),
            ],
        ];
    }
    /**
     * @return array{id: string, label: string, description: string, managed_tenant_limit_default: int, review_pack_generation_default: bool, is_default: bool}
     */
    public function resolvePlanProfile(Workspace $workspace): array
    {
        $planProfileId = $this->settingsResolver->resolveValue(
            workspace: $workspace,
            domain: self::SETTING_DOMAIN,
            key: self::SETTING_PLAN_PROFILE,
        );
        return $this->planProfileCatalog->resolve(is_string($planProfileId) ? $planProfileId : null);
    }
    /**
     * @param  array{id: string, label: string, description: string, managed_tenant_limit_default: int, review_pack_generation_default: bool, is_default: bool}|null  $planProfile
     * @return array{
     *     workspace_id: int,
     *     plan_profile_id: string,
     *     plan_profile_label: string,
     *     plan_profile_description: string,
     *     key: string,
     *     effective_value: int|bool,
     *     source: 'plan_profile_default'|'workspace_override',
     *     rationale: string|null,
     *     current_usage: int|null,
     *     remaining_capacity: int|null,
     *     is_blocked: bool,
     *     block_reason: string|null,
     *     last_changed_at: CarbonInterface|null,
     *     last_changed_by: string|null
     * }
     */
    public function resolve(Workspace $workspace, string $key, ?array $planProfile = null): array
    {
        $planProfile ??= $this->resolvePlanProfile($workspace);
        $lastChanged = $this->lastChangedMetadata($workspace);
        return match ($key) {
            self::KEY_MANAGED_TENANT_ACTIVATION_LIMIT => $this->resolveManagedTenantActivationLimitDecision($workspace, $planProfile, $lastChanged),
            self::KEY_REVIEW_PACK_GENERATION_ENABLED => $this->resolveReviewPackGenerationDecision($workspace, $planProfile, $lastChanged),
            default => throw new \InvalidArgumentException(sprintf('Unknown workspace entitlement key: %s', $key)),
        };
    }
    /**
     * @param  array{id: string, label: string, description: string, managed_tenant_limit_default: int, review_pack_generation_default: bool, is_default: bool}  $planProfile
     * @param  array{last_changed_at: CarbonInterface|null, last_changed_by: string|null}  $lastChanged
     * @return array{
     *     workspace_id: int,
     *     plan_profile_id: string,
     *     plan_profile_label: string,
     *     plan_profile_description: string,
     *     key: string,
     *     effective_value: int,
     *     source: 'plan_profile_default'|'workspace_override',
     *     rationale: string|null,
     *     current_usage: int,
     *     remaining_capacity: int,
     *     is_blocked: bool,
     *     block_reason: string|null,
     *     last_changed_at: CarbonInterface|null,
     *     last_changed_by: string|null
     * }
     */
    private function resolveManagedTenantActivationLimitDecision(Workspace $workspace, array $planProfile, array $lastChanged): array
    {
        $overrideValue = $this->settingsResolver->resolveDetailed(
            workspace: $workspace,
            domain: self::SETTING_DOMAIN,
            key: self::SETTING_MANAGED_TENANT_LIMIT_OVERRIDE_VALUE,
        );
        $overrideReason = $this->settingsResolver->resolveValue(
            workspace: $workspace,
            domain: self::SETTING_DOMAIN,
            key: self::SETTING_MANAGED_TENANT_LIMIT_OVERRIDE_REASON,
        );
        $effectiveValue = is_int($overrideValue['value'])
            ? $overrideValue['value']
            : (int) $planProfile['managed_tenant_limit_default'];
        $source = $overrideValue['source'] === 'workspace_override'
            ? 'workspace_override'
            : 'plan_profile_default';
        $currentUsage = Tenant::activeQuery()
            ->where('workspace_id', (int) $workspace->getKey())
            ->count();
        $remainingCapacity = $effectiveValue - $currentUsage;
        $isBlocked = $currentUsage >= $effectiveValue;
        $rationale = $source === 'workspace_override'
            ? (is_string($overrideReason) && $overrideReason !== '' ? $overrideReason : null)
            : (string) $planProfile['description'];
        return [
            'workspace_id' => (int) $workspace->getKey(),
            'plan_profile_id' => (string) $planProfile['id'],
            'plan_profile_label' => (string) $planProfile['label'],
            'plan_profile_description' => (string) $planProfile['description'],
            'key' => self::KEY_MANAGED_TENANT_ACTIVATION_LIMIT,
            'effective_value' => $effectiveValue,
            'source' => $source,
            'rationale' => $rationale,
            'current_usage' => $currentUsage,
            'remaining_capacity' => $remainingCapacity,
            'is_blocked' => $isBlocked,
            'block_reason' => $isBlocked
                ? $this->managedTenantLimitBlockReason($currentUsage, $effectiveValue, $source, $planProfile, $rationale)
                : null,
            'last_changed_at' => $lastChanged['last_changed_at'],
            'last_changed_by' => $lastChanged['last_changed_by'],
        ];
    }
    /**
     * @param  array{id: string, label: string, description: string, managed_tenant_limit_default: int, review_pack_generation_default: bool, is_default: bool}  $planProfile
     * @param  array{last_changed_at: CarbonInterface|null, last_changed_by: string|null}  $lastChanged
     * @return array{
     *     workspace_id: int,
     *     plan_profile_id: string,
     *     plan_profile_label: string,
     *     plan_profile_description: string,
     *     key: string,
     *     effective_value: bool,
     *     source: 'plan_profile_default'|'workspace_override',
     *     rationale: string|null,
     *     current_usage: null,
     *     remaining_capacity: null,
     *     is_blocked: bool,
     *     block_reason: string|null,
     *     last_changed_at: CarbonInterface|null,
     *     last_changed_by: string|null
     * }
     */
    private function resolveReviewPackGenerationDecision(Workspace $workspace, array $planProfile, array $lastChanged): array
    {
        $overrideValue = $this->settingsResolver->resolveDetailed(
            workspace: $workspace,
            domain: self::SETTING_DOMAIN,
            key: self::SETTING_REVIEW_PACK_GENERATION_OVERRIDE_VALUE,
        );
        $overrideReason = $this->settingsResolver->resolveValue(
            workspace: $workspace,
            domain: self::SETTING_DOMAIN,
            key: self::SETTING_REVIEW_PACK_GENERATION_OVERRIDE_REASON,
        );
        $effectiveValue = is_bool($overrideValue['value'])
            ? $overrideValue['value']
            : (bool) $planProfile['review_pack_generation_default'];
        $source = $overrideValue['source'] === 'workspace_override'
            ? 'workspace_override'
            : 'plan_profile_default';
        $rationale = $source === 'workspace_override'
            ? (is_string($overrideReason) && $overrideReason !== '' ? $overrideReason : null)
            : (string) $planProfile['description'];
        return [
            'workspace_id' => (int) $workspace->getKey(),
            'plan_profile_id' => (string) $planProfile['id'],
            'plan_profile_label' => (string) $planProfile['label'],
            'plan_profile_description' => (string) $planProfile['description'],
            'key' => self::KEY_REVIEW_PACK_GENERATION_ENABLED,
            'effective_value' => $effectiveValue,
            'source' => $source,
            'rationale' => $rationale,
            'current_usage' => null,
            'remaining_capacity' => null,
            'is_blocked' => ! $effectiveValue,
            'block_reason' => $effectiveValue
                ? null
                : $this->reviewPackGenerationBlockReason($source, $planProfile, $rationale),
            'last_changed_at' => $lastChanged['last_changed_at'],
            'last_changed_by' => $lastChanged['last_changed_by'],
        ];
    }
    /**
     * @return array{last_changed_at: CarbonInterface|null, last_changed_by: string|null}
     */
    private function lastChangedMetadata(Workspace $workspace): array
    {
        $record = WorkspaceSetting::query()
            ->where('workspace_id', (int) $workspace->getKey())
            ->where('domain', self::SETTING_DOMAIN)
            ->whereIn('key', [
                self::SETTING_PLAN_PROFILE,
                self::SETTING_MANAGED_TENANT_LIMIT_OVERRIDE_VALUE,
                self::SETTING_MANAGED_TENANT_LIMIT_OVERRIDE_REASON,
                self::SETTING_REVIEW_PACK_GENERATION_OVERRIDE_VALUE,
                self::SETTING_REVIEW_PACK_GENERATION_OVERRIDE_REASON,
            ])
            ->whereNotNull('updated_by_user_id')
            ->with('updatedByUser:id,name')
            ->latest('updated_at')
            ->latest('id')
            ->first();
        if (! $record instanceof WorkspaceSetting) {
            return [
                'last_changed_at' => null,
                'last_changed_by' => null,
            ];
        }
        return [
            'last_changed_at' => $record->updated_at,
            'last_changed_by' => $record->updatedByUser?->name,
        ];
    }
    /**
     * @param  array{id: string, label: string, description: string, managed_tenant_limit_default: int, review_pack_generation_default: bool, is_default: bool}  $planProfile
     */
    private function managedTenantLimitBlockReason(int $currentUsage, int $effectiveValue, string $source, array $planProfile, ?string $rationale): string
    {
        $prefix = $source === 'workspace_override'
            ? 'This workspace override currently allows'
            : sprintf('The %s plan profile currently allows', $planProfile['label']);
        $message = sprintf(
            '%s %d active managed tenant%s, and this workspace already has %d active managed tenant%s.',
            $prefix,
            $effectiveValue,
            $effectiveValue === 1 ? '' : 's',
            $currentUsage,
            $currentUsage === 1 ? '' : 's',
        );
        if ($source === 'workspace_override' && $rationale !== null) {
            $message .= ' Reason: '.$rationale;
        }
        return $message;
    }
    /**
     * @param  array{id: string, label: string, description: string, managed_tenant_limit_default: int, review_pack_generation_default: bool, is_default: bool}  $planProfile
     */
    private function reviewPackGenerationBlockReason(string $source, array $planProfile, ?string $rationale): string
    {
        $message = $source === 'workspace_override'
            ? 'Review pack generation is disabled by workspace override.'
            : sprintf('Review pack generation is disabled by the %s plan profile.', $planProfile['label']);
        if ($source === 'workspace_override' && $rationale !== null) {
            $message .= ' Reason: '.$rationale;
        }
        return $message;
    }
 }
--- a/apps/platform/app/Services/Entitlements/WorkspacePlanProfileCatalog.php
+++ b/apps/platform/app/Services/Entitlements/WorkspacePlanProfileCatalog.php
@ -0,0 +1,104 @@
 <?php
 declare(strict_types=1);
 namespace App\Services\Entitlements;
 final class WorkspacePlanProfileCatalog
 {
    /**
     * @var array<string, array{id: string, label: string, description: string, managed_tenant_limit_default: int, review_pack_generation_default: bool, is_default: bool}>
     */
    private const PROFILES = [
        'starter' => [
            'id' => 'starter',
            'label' => 'Starter',
            'description' => 'Minimal allowance for early workspace access and low-volume operations.',
            'managed_tenant_limit_default' => 1,
            'review_pack_generation_default' => false,
            'is_default' => false,
        ],
        'standard' => [
            'id' => 'standard',
            'label' => 'Standard',
            'description' => 'Balanced defaults for most managed workspaces.',
            'managed_tenant_limit_default' => 25,
            'review_pack_generation_default' => true,
            'is_default' => true,
        ],
        'scale' => [
            'id' => 'scale',
            'label' => 'Scale',
            'description' => 'Higher managed-tenant capacity for larger workspace portfolios.',
            'managed_tenant_limit_default' => 100,
            'review_pack_generation_default' => true,
            'is_default' => false,
        ],
    ];
    /**
     * @return list<array{id: string, label: string, description: string, managed_tenant_limit_default: int, review_pack_generation_default: bool, is_default: bool}>
     */
    public function all(): array
    {
        return array_values(self::PROFILES);
    }
    /**
     * @return array{id: string, label: string, description: string, managed_tenant_limit_default: int, review_pack_generation_default: bool, is_default: bool}
     */
    public function default(): array
    {
        return self::PROFILES[self::defaultProfileId()];
    }
    /**
     * @return array{id: string, label: string, description: string, managed_tenant_limit_default: int, review_pack_generation_default: bool, is_default: bool}|null
     */
    public function find(?string $id): ?array
    {
        if ($id === null) {
            return null;
        }
        return self::PROFILES[$id] ?? null;
    }
    /**
     * @return array{id: string, label: string, description: string, managed_tenant_limit_default: int, review_pack_generation_default: bool, is_default: bool}
     */
    public function resolve(?string $id): array
    {
        return $this->find($id) ?? $this->default();
    }
    /**
     * @return array<string, string>
     */
    public function optionLabels(): array
    {
        return array_map(
            static fn (array $profile): string => $profile['label'],
            self::PROFILES,
        );
    }
    /**
     * @return list<string>
     */
    public static function profileIds(): array
    {
        return array_keys(self::PROFILES);
    }
    public static function defaultProfileId(): string
    {
        foreach (self::PROFILES as $id => $profile) {
            if ($profile['is_default']) {
                return $id;
            }
        }
        throw new \RuntimeException('Workspace plan profile catalog is missing a default profile.');
    }
 }
--- a/apps/platform/app/Services/EntraAdminRoles/EntraAdminRolesReportService.php
+++ b/apps/platform/app/Services/EntraAdminRoles/EntraAdminRolesReportService.php
@ -9,6 +9,8 @@
 use App\Models\Tenant;
 use App\Services\Graph\GraphClientInterface;
 use App\Services\Providers\MicrosoftGraphOptionsResolver;
 use App\Support\ProductTelemetry\ProductTelemetryRecorder;
 use App\Support\ProductTelemetry\ProductUsageEventCatalog;
 use Carbon\CarbonImmutable;
 use RuntimeException;
@ -18,6 +20,7 @@ public function __construct(
        private readonly GraphClientInterface $graphClient,
        private readonly HighPrivilegeRoleCatalog $catalog,
        private readonly MicrosoftGraphOptionsResolver $graphOptionsResolver,
        private readonly ProductTelemetryRecorder $productTelemetryRecorder,
    ) {}
    /**
@ -57,6 +60,8 @@ public function generate(Tenant $tenant, ?OperationRun $operationRun = null): En
            'previous_fingerprint' => $latestReport?->fingerprint,
        ]);
        $this->recordStoredReportTelemetry($report, $operationRun);
        return new EntraAdminRolesReportResult(
            created: true,
            storedReportId: (int) $report->getKey(),
@ -192,4 +197,24 @@ private function resolvePrincipalType(array $principal): string
            default => 'unknown',
        };
    }
    private function recordStoredReportTelemetry(StoredReport $report, ?OperationRun $operationRun): void
    {
        if (! $operationRun instanceof OperationRun || ! is_numeric($operationRun->user_id)) {
            return;
        }
        $this->productTelemetryRecorder->record(
            eventName: ProductUsageEventCatalog::STORED_REPORT_CREATED,
            workspaceId: (int) $report->workspace_id,
            tenantId: (int) $report->tenant_id,
            userId: (int) $operationRun->user_id,
            subjectType: 'stored_report',
            subjectId: (int) $report->getKey(),
            metadata: [
                'report_type' => $report->report_type,
            ],
            occurredAt: $report->created_at ?? now(),
        );
    }
 }
--- a/apps/platform/app/Services/Findings/FindingWorkflowService.php
+++ b/apps/platform/app/Services/Findings/FindingWorkflowService.php
@ -46,17 +46,13 @@ public static function meaningfulActivityActionValues(): array
    public function triage(Finding $finding, Tenant $tenant, User $actor): Finding
    {
-        $this->authorize($finding, $tenant, $actor, [
+        $this->authorize($finding, $tenant, $actor, [Capabilities::TENANT_FINDINGS_TRIAGE]);
            Capabilities::TENANT_FINDINGS_TRIAGE,
            Capabilities::TENANT_FINDINGS_ACKNOWLEDGE,
        ]);
        $currentStatus = (string) $finding->status;
        if (! in_array($currentStatus, [
            Finding::STATUS_NEW,
            Finding::STATUS_REOPENED,
            Finding::STATUS_ACKNOWLEDGED,
        ], true)) {
            throw new InvalidArgumentException('Finding cannot be triaged from the current status.');
        }
@ -82,12 +78,9 @@ public function triage(Finding $finding, Tenant $tenant, User $actor): Finding
    public function startProgress(Finding $finding, Tenant $tenant, User $actor): Finding
    {
-        $this->authorize($finding, $tenant, $actor, [
+        $this->authorize($finding, $tenant, $actor, [Capabilities::TENANT_FINDINGS_TRIAGE]);
            Capabilities::TENANT_FINDINGS_TRIAGE,
            Capabilities::TENANT_FINDINGS_ACKNOWLEDGE,
        ]);
-        if (! in_array((string) $finding->status, [Finding::STATUS_TRIAGED, Finding::STATUS_ACKNOWLEDGED], true)) {
+        if ((string) $finding->status !== Finding::STATUS_TRIAGED) {
            throw new InvalidArgumentException('Finding cannot be moved to in-progress from the current status.');
        }
@ -369,10 +362,7 @@ private function riskAcceptWithoutAuthorization(Finding $finding, Tenant $tenant
    public function reopen(Finding $finding, Tenant $tenant, User $actor, string $reason): Finding
    {
-        $this->authorize($finding, $tenant, $actor, [
+        $this->authorize($finding, $tenant, $actor, [Capabilities::TENANT_FINDINGS_TRIAGE]);
            Capabilities::TENANT_FINDINGS_TRIAGE,
            Capabilities::TENANT_FINDINGS_ACKNOWLEDGE,
        ]);
        if (! in_array((string) $finding->status, Finding::terminalStatuses(), true)) {
            throw new InvalidArgumentException('Only terminal findings can be reopened.');
--- a/apps/platform/app/Services/Localization/LocaleResolver.php
+++ b/apps/platform/app/Services/Localization/LocaleResolver.php
@ -0,0 +1,215 @@
 <?php
 declare(strict_types=1);
 namespace App\Services\Localization;
 use App\Models\User;
 use App\Models\Workspace;
 use App\Services\Settings\SettingsResolver;
 use App\Support\Workspaces\WorkspaceContext;
 use Illuminate\Http\Request;
 class LocaleResolver
 {
    public const SESSION_OVERRIDE_KEY = 'tenantpilot.locale_override';
    public const REQUEST_ATTRIBUTE = 'tenantpilot.resolved_locale';
    public const SETTING_DOMAIN = 'localization';
    public const SETTING_DEFAULT_LOCALE = 'default_locale';
    public const SOURCE_EXPLICIT_OVERRIDE = 'explicit_override';
    public const SOURCE_USER_PREFERENCE = 'user_preference';
    public const SOURCE_WORKSPACE_DEFAULT = 'workspace_default';
    public const SOURCE_SYSTEM_DEFAULT = 'system_default';
    /**
     * @var list<string>
     */
    private const SUPPORTED_LOCALES = ['en', 'de'];
    public function __construct(
        private SettingsResolver $settingsResolver,
        private WorkspaceContext $workspaceContext,
    ) {}
    /**
     * @return list<string>
     */
    public static function supportedLocales(): array
    {
        return self::SUPPORTED_LOCALES;
    }
    /**
     * @return array<string, string>
     */
    public static function localeOptions(): array
    {
        return [
            'en' => __('localization.locales.en'),
            'de' => __('localization.locales.de'),
        ];
    }
    public static function isSupported(mixed $locale): bool
    {
        return self::normalize($locale) !== null;
    }
    public static function normalize(mixed $locale): ?string
    {
        if (! is_string($locale)) {
            return null;
        }
        $normalized = strtolower(trim($locale));
        return in_array($normalized, self::SUPPORTED_LOCALES, true) ? $normalized : null;
    }
    /**
     * @return array{
     *     locale: string,
     *     source: string,
     *     fallback_locale: string,
     *     user_preference_locale: ?string,
     *     workspace_default_locale: ?string,
     *     machine_artifacts_invariant: true
     * }
     */
    public function resolve(Request $request, ?string $plane = null): array
    {
        $plane = $this->normalizePlane($plane, $request);
        $explicitOverride = $this->explicitOverride($request);
        $systemDefault = (string) config('app.fallback_locale', 'en');
        if ($plane === 'system') {
            return $this->resolveFromSources(
                explicitOverride: $explicitOverride,
                userPreference: null,
                workspaceDefault: null,
                systemDefault: $systemDefault,
                includeUserPreference: false,
                includeWorkspaceDefault: false,
            );
        }
        $user = $request->user();
        $userPreference = $user instanceof User ? $user->preferred_locale : null;
        $workspaceDefault = $this->workspaceDefault($request);
        return $this->resolveFromSources(
            explicitOverride: $explicitOverride,
            userPreference: $userPreference,
            workspaceDefault: $workspaceDefault,
            systemDefault: $systemDefault,
            includeUserPreference: true,
            includeWorkspaceDefault: true,
        );
    }
    /**
     * @return array{
     *     locale: string,
     *     source: string,
     *     fallback_locale: string,
     *     user_preference_locale: ?string,
     *     workspace_default_locale: ?string,
     *     machine_artifacts_invariant: true
     * }
     */
    public function resolveFromSources(
        mixed $explicitOverride,
        mixed $userPreference,
        mixed $workspaceDefault,
        mixed $systemDefault,
        bool $includeUserPreference = true,
        bool $includeWorkspaceDefault = true,
    ): array {
        $fallbackLocale = self::normalize(config('app.fallback_locale', 'en')) ?? 'en';
        $candidates = [
            self::SOURCE_EXPLICIT_OVERRIDE => self::normalize($explicitOverride),
        ];
        if ($includeUserPreference) {
            $candidates[self::SOURCE_USER_PREFERENCE] = self::normalize($userPreference);
        }
        if ($includeWorkspaceDefault) {
            $candidates[self::SOURCE_WORKSPACE_DEFAULT] = self::normalize($workspaceDefault);
        }
        $candidates[self::SOURCE_SYSTEM_DEFAULT] = self::normalize($systemDefault) ?? $fallbackLocale;
        foreach ($candidates as $source => $locale) {
            if ($locale !== null) {
                return [
                    'locale' => $locale,
                    'source' => $source,
                    'fallback_locale' => $fallbackLocale,
                    'user_preference_locale' => $includeUserPreference ? self::normalize($userPreference) : null,
                    'workspace_default_locale' => $includeWorkspaceDefault ? self::normalize($workspaceDefault) : null,
                    'machine_artifacts_invariant' => true,
                ];
            }
        }
        return [
            'locale' => $fallbackLocale,
            'source' => self::SOURCE_SYSTEM_DEFAULT,
            'fallback_locale' => $fallbackLocale,
            'user_preference_locale' => $includeUserPreference ? self::normalize($userPreference) : null,
            'workspace_default_locale' => $includeWorkspaceDefault ? self::normalize($workspaceDefault) : null,
            'machine_artifacts_invariant' => true,
        ];
    }
    private function explicitOverride(Request $request): ?string
    {
        $queryLocale = self::normalize($request->query('locale'));
        if ($queryLocale !== null) {
            return $queryLocale;
        }
        if (! $request->hasSession()) {
            return null;
        }
        return self::normalize($request->session()->get(self::SESSION_OVERRIDE_KEY));
    }
    private function workspaceDefault(Request $request): ?string
    {
        $workspace = $this->workspaceContext->currentWorkspace($request);
        if (! $workspace instanceof Workspace) {
            return null;
        }
        return self::normalize($this->settingsResolver->resolveValue(
            workspace: $workspace,
            domain: self::SETTING_DOMAIN,
            key: self::SETTING_DEFAULT_LOCALE,
        ));
    }
    private function normalizePlane(?string $plane, Request $request): string
    {
        $plane = strtolower(trim((string) $plane));
        if (in_array($plane, ['admin', 'tenant', 'system'], true)) {
            return $plane;
        }
        return $request->is('system', 'system/*') ? 'system' : 'admin';
    }
 }
--- a/apps/platform/app/Services/Onboarding/OnboardingDraftMutationService.php
+++ b/apps/platform/app/Services/Onboarding/OnboardingDraftMutationService.php
@ -179,5 +179,7 @@ private function persistDraft(TenantOnboardingSession $draft, bool $incrementVer
        $this->lifecycleService->applySnapshot($draft, false);
        $draft->save();
        $this->lifecycleService->recordCompletedCheckpointTelemetryIfNeeded($draft);
    }
 }
--- a/apps/platform/app/Services/Onboarding/OnboardingLifecycleService.php
+++ b/apps/platform/app/Services/Onboarding/OnboardingLifecycleService.php
@ -15,12 +15,15 @@
 use App\Support\OperationCatalog;
 use App\Support\OperationRunOutcome;
 use App\Support\OperationRunStatus;
 use App\Support\ProductTelemetry\ProductTelemetryRecorder;
 use App\Support\ProductTelemetry\ProductUsageEventCatalog;
 use App\Support\Verification\VerificationReportOverall;
 class OnboardingLifecycleService
 {
    public function __construct(
        private readonly TenantOperabilityService $tenantOperabilityService,
        private readonly ProductTelemetryRecorder $productTelemetryRecorder,
    ) {}
    public function syncPersistedLifecycle(TenantOnboardingSession $draft, bool $incrementVersion = false): TenantOnboardingSession
@ -35,6 +38,7 @@ public function syncPersistedLifecycle(TenantOnboardingSession $draft, bool $inc
        if ($changed) {
            $freshDraft->save();
            $this->recordCompletedCheckpointTelemetryIfNeeded($freshDraft);
        }
        return $freshDraft->refresh();
@ -94,6 +98,46 @@ public function applySnapshot(TenantOnboardingSession $draft, bool $incrementVer
        return $changed;
    }
    public function recordCompletedCheckpointTelemetryIfNeeded(TenantOnboardingSession $draft): void
    {
        if (! $draft->wasChanged('last_completed_checkpoint')) {
            return;
        }
        $checkpoint = $draft->last_completed_checkpoint instanceof OnboardingCheckpoint
            ? $draft->last_completed_checkpoint
            : OnboardingCheckpoint::tryFrom((string) $draft->last_completed_checkpoint);
        if (! $checkpoint instanceof OnboardingCheckpoint) {
            return;
        }
        $workspaceId = (int) ($draft->workspace_id ?? 0);
        $tenantId = (int) ($draft->tenant_id ?? 0);
        $userId = (int) ($draft->updated_by_user_id ?? 0);
        if ($workspaceId <= 0 || $tenantId <= 0 || $userId <= 0) {
            return;
        }
        $occurredAt = $draft->updated_at ?? now();
        $this->productTelemetryRecorder->record(
            eventName: ProductUsageEventCatalog::ONBOARDING_CHECKPOINT_COMPLETED,
            workspaceId: $workspaceId,
            tenantId: $tenantId,
            userId: $userId,
            subjectType: 'tenant_onboarding_session',
            subjectId: (int) $draft->getKey(),
            metadata: [
                'checkpoint_key' => $checkpoint->value,
                'lifecycle_state' => $draft->lifecycleState()->value,
                'completed_at' => $occurredAt,
            ],
            occurredAt: $occurredAt,
        );
    }
    /**
     * @return array{
     *     lifecycle_state: OnboardingLifecycleState,
--- a/apps/platform/app/Services/OperationRunService.php
+++ b/apps/platform/app/Services/OperationRunService.php
@ -23,6 +23,8 @@
 use App\Support\OpsUx\BulkRunContext;
 use App\Support\OpsUx\RunFailureSanitizer;
 use App\Support\OpsUx\SummaryCountsNormalizer;
 use App\Support\ProductTelemetry\ProductTelemetryRecorder;
 use App\Support\ProductTelemetry\ProductUsageEventCatalog;
 use App\Support\Providers\ProviderReasonCodes;
 use App\Support\RbacReason;
 use App\Support\ReasonTranslation\NextStepOption;
@ -44,6 +46,7 @@ public function __construct(
        private readonly AuditRecorder $auditRecorder,
        private readonly OperationRunCapabilityResolver $operationRunCapabilityResolver,
        private readonly ReasonTranslator $reasonTranslator,
        private readonly ProductTelemetryRecorder $productTelemetryRecorder,
    ) {}
    public function isStaleQueuedRun(OperationRun $run, int $thresholdMinutes = 5): bool
@ -139,7 +142,7 @@ public function ensureRun(
        // Create new run (race-safe via partial unique index)
        try {
-            return OperationRun::create([
+            $run = OperationRun::create([
                'workspace_id' => $workspaceId,
                'tenant_id' => $tenant->id,
                'user_id' => $initiator?->id,
@ -150,6 +153,10 @@ public function ensureRun(
                'run_identity_hash' => $hash,
                'context' => $inputs,
            ]);
            $this->recordOperationStartedTelemetry($run, $initiator);
            return $run;
        } catch (QueryException $e) {
            // Unique violation (active-run dedupe):
            // - PostgreSQL: 23505
@ -205,7 +212,7 @@ public function ensureRunWithIdentity(
        // Create new run (race-safe via partial unique index)
        try {
-            return OperationRun::create([
+            $run = OperationRun::create([
                'workspace_id' => $workspaceId,
                'tenant_id' => $tenant->id,
                'user_id' => $initiator?->id,
@ -216,6 +223,10 @@ public function ensureRunWithIdentity(
                'run_identity_hash' => $hash,
                'context' => $context,
            ]);
            $this->recordOperationStartedTelemetry($run, $initiator);
            return $run;
        } catch (QueryException $e) {
            // Unique violation (active-run dedupe):
            // - PostgreSQL: 23505
@ -336,7 +347,7 @@ public function ensureRunWithIdentityStrict(
        }
        try {
-            return OperationRun::create([
+            $run = OperationRun::create([
                'workspace_id' => $workspaceId,
                'tenant_id' => $tenant->id,
                'user_id' => $initiator?->id,
@ -347,6 +358,10 @@ public function ensureRunWithIdentityStrict(
                'run_identity_hash' => $hash,
                'context' => $context,
            ]);
            $this->recordOperationStartedTelemetry($run, $initiator);
            return $run;
        } catch (QueryException $e) {
            if (! in_array(($e->errorInfo[0] ?? null), ['23505', '23000'], true)) {
                throw $e;
@ -1032,6 +1047,30 @@ private function normalizeExecutionContext(string $type, array $context, ?User $
        return $context;
    }
    private function recordOperationStartedTelemetry(OperationRun $run, ?User $initiator): void
    {
        if (! $initiator instanceof User) {
            return;
        }
        if (! is_numeric($run->workspace_id) || ! is_numeric($run->tenant_id)) {
            return;
        }
        $this->productTelemetryRecorder->record(
            eventName: ProductUsageEventCatalog::OPERATIONS_STARTED,
            workspaceId: (int) $run->workspace_id,
            tenantId: (int) $run->tenant_id,
            userId: (int) $initiator->getKey(),
            subjectType: 'operation_run',
            subjectId: (int) $run->getKey(),
            metadata: [
                'operation_type' => (string) $run->type,
            ],
            occurredAt: $run->created_at ?? now(),
        );
    }
    /**
     * Normalize inputs for stable identity hashing.
     *
--- a/apps/platform/app/Services/PermissionPosture/PermissionPostureFindingGenerator.php
+++ b/apps/platform/app/Services/PermissionPosture/PermissionPostureFindingGenerator.php
@ -11,6 +11,8 @@
 use App\Models\Tenant;
 use App\Services\Findings\FindingSlaPolicy;
 use App\Services\Findings\FindingWorkflowService;
 use App\Support\ProductTelemetry\ProductTelemetryRecorder;
 use App\Support\ProductTelemetry\ProductUsageEventCatalog;
 use Carbon\CarbonImmutable;
 /**
@ -22,6 +24,7 @@ final class PermissionPostureFindingGenerator implements FindingGeneratorContrac
    public function __construct(
        private readonly PostureScoreCalculator $scoreCalculator,
        private readonly FindingSlaPolicy $slaPolicy,
        private readonly ProductTelemetryRecorder $productTelemetryRecorder,
        private readonly ?FindingWorkflowService $findingWorkflowService = null,
    ) {}
@ -94,6 +97,7 @@ public function generate(Tenant $tenant, array $permissionComparison, ?Operation
        $postureScore = $this->scoreCalculator->calculate($permissionComparison);
        $report = $this->createStoredReport($tenant, $permissionComparison, $permissions, $postureScore);
        $this->recordStoredReportTelemetry($report, $operationRun);
        return new PostureResult(
            findingsCreated: $created,
@ -404,6 +408,26 @@ private function createStoredReport(
        ]);
    }
    private function recordStoredReportTelemetry(StoredReport $report, ?OperationRun $operationRun): void
    {
        if (! $operationRun instanceof OperationRun || ! is_numeric($operationRun->user_id)) {
            return;
        }
        $this->productTelemetryRecorder->record(
            eventName: ProductUsageEventCatalog::STORED_REPORT_CREATED,
            workspaceId: (int) $report->workspace_id,
            tenantId: (int) $report->tenant_id,
            userId: (int) $operationRun->user_id,
            subjectType: 'stored_report',
            subjectId: (int) $report->getKey(),
            metadata: [
                'report_type' => $report->report_type,
            ],
            occurredAt: $report->created_at ?? now(),
        );
    }
    /**
     * @return array<string, mixed>
     */
--- a/apps/platform/app/Services/ReviewPackService.php
+++ b/apps/platform/app/Services/ReviewPackService.php
@ -4,6 +4,7 @@
 namespace App\Services;
 use App\Exceptions\Entitlements\WorkspaceEntitlementBlockedException;
 use App\Exceptions\ReviewPackEvidenceResolutionException;
 use App\Jobs\GenerateReviewPackJob;
 use App\Models\EvidenceSnapshot;
@ -13,10 +14,13 @@
 use App\Models\TenantReview;
 use App\Models\User;
 use App\Services\Audit\WorkspaceAuditLogger;
 use App\Services\Entitlements\WorkspaceCommercialLifecycleResolver;
 use App\Services\Evidence\EvidenceResolutionRequest;
 use App\Services\Evidence\EvidenceSnapshotResolver;
 use App\Support\Audit\AuditActionId;
 use App\Support\OperationRunType;
 use App\Support\ProductTelemetry\ProductTelemetryRecorder;
 use App\Support\ProductTelemetry\ProductUsageEventCatalog;
 use App\Support\ReviewPackStatus;
 use Illuminate\Support\Facades\URL;
@ -26,6 +30,8 @@ public function __construct(
        private OperationRunService $operationRunService,
        private EvidenceSnapshotResolver $snapshotResolver,
        private WorkspaceAuditLogger $auditLogger,
        private WorkspaceCommercialLifecycleResolver $workspaceCommercialLifecycleResolver,
        private ProductTelemetryRecorder $productTelemetryRecorder,
    ) {}
    /**
@ -46,12 +52,17 @@ public function __construct(
     */
    public function generate(Tenant $tenant, User $user, array $options = []): ReviewPack
    {
        $this->assertReviewPackGenerationAllowed($tenant);
        $options = $this->normalizeOptions($options);
        $snapshot = $this->resolveSnapshot($tenant);
        $fingerprint = $this->computeFingerprintForSnapshot($snapshot, $options);
        $existing = $this->findExistingPack($tenant, $fingerprint);
        if ($existing instanceof ReviewPack) {
            $this->recordReviewPackRequestTelemetry($existing, $user, 'tenant');
            return $existing;
        }
@ -70,6 +81,8 @@ public function generate(Tenant $tenant, User $user, array $options = []): Revie
            $queuedPack = $this->findPackForRun($tenant, $operationRun);
            if ($queuedPack instanceof ReviewPack) {
                $this->recordReviewPackRequestTelemetry($queuedPack, $user, 'tenant');
                return $queuedPack;
            }
        }
@ -109,6 +122,8 @@ public function generate(Tenant $tenant, User $user, array $options = []): Revie
            );
        });
        $this->recordReviewPackRequestTelemetry($reviewPack, $user, 'tenant');
        return $reviewPack;
    }
@ -128,12 +143,15 @@ public function generateFromReview(TenantReview $review, User $user, array $opti
            throw new \InvalidArgumentException('Review exports require an anchored evidence snapshot.');
        }
        $this->assertReviewPackGenerationAllowed($tenant);
        $options = $this->normalizeOptions($options);
        $fingerprint = $this->computeFingerprintForReview($review, $options);
        $existing = $this->findExistingPackForReview($review, $fingerprint);
        if ($existing instanceof ReviewPack) {
            $this->logReviewExport($review, $user, $existing, 'reused');
            $this->recordReviewPackRequestTelemetry($existing, $user, 'tenant_review');
            return $existing;
        }
@ -155,6 +173,7 @@ public function generateFromReview(TenantReview $review, User $user, array $opti
            if ($queuedPack instanceof ReviewPack) {
                $this->logReviewExport($review, $user, $queuedPack, 'reused_active_run');
                $this->recordReviewPackRequestTelemetry($queuedPack, $user, 'tenant_review');
                return $queuedPack;
            }
@ -198,6 +217,7 @@ public function generateFromReview(TenantReview $review, User $user, array $opti
        });
        $this->logReviewExport($review, $user, $reviewPack, 'queued');
        $this->recordReviewPackRequestTelemetry($reviewPack, $user, 'tenant_review');
        return $reviewPack;
    }
@ -214,18 +234,61 @@ public function computeFingerprint(Tenant $tenant, array $options): string
    /**
     * Generate a signed download URL for a review pack.
     *
     * @param  array<string, scalar|null>  $parameters
     */
-    public function generateDownloadUrl(ReviewPack $pack): string
+    public function generateDownloadUrl(ReviewPack $pack, array $parameters = []): string
    {
        $ttlMinutes = (int) config('tenantpilot.review_pack.download_url_ttl_minutes', 60);
        return URL::signedRoute(
            'admin.review-packs.download',
-            ['reviewPack' => $pack->getKey()],
+            array_merge(['reviewPack' => $pack->getKey()], $parameters),
            now()->addMinutes($ttlMinutes),
        );
    }
    /**
     * @return array<string, mixed>
     */
    public function reviewPackGenerationDecisionForTenant(Tenant $tenant): array
    {
        $tenant->loadMissing('workspace');
        $decision = $this->workspaceCommercialLifecycleResolver->actionDecision(
            $tenant->workspace,
            WorkspaceCommercialLifecycleResolver::ACTION_REVIEW_PACK_START,
        );
        $entitlementDecision = is_array($decision['entitlement_decision'] ?? null)
            ? $decision['entitlement_decision']
            : [];
        return $decision + [
            'effective_value' => $entitlementDecision['effective_value'] ?? null,
            'source' => $decision['source'] ?? null,
            'current_usage' => $entitlementDecision['current_usage'] ?? null,
            'remaining_capacity' => $entitlementDecision['remaining_capacity'] ?? null,
        ];
    }
    private function recordReviewPackRequestTelemetry(ReviewPack $reviewPack, User $user, string $sourceSurface): void
    {
        $this->productTelemetryRecorder->record(
            eventName: ProductUsageEventCatalog::REVIEW_PACK_REQUESTED,
            workspaceId: (int) $reviewPack->workspace_id,
            tenantId: (int) $reviewPack->tenant_id,
            userId: (int) $user->getKey(),
            subjectType: 'review_pack',
            subjectId: (int) $reviewPack->getKey(),
            metadata: [
                'source_surface' => $sourceSurface,
                'include_operations' => (bool) ($reviewPack->options['include_operations'] ?? false),
                'include_pii' => (bool) ($reviewPack->options['include_pii'] ?? false),
            ],
            occurredAt: $reviewPack->created_at ?? now(),
        );
    }
    /**
     * Find an existing ready, non-expired pack with the same fingerprint.
     */
@ -283,6 +346,17 @@ private function normalizeOptions(array $options): array
        ];
    }
    private function assertReviewPackGenerationAllowed(Tenant $tenant): void
    {
        $decision = $this->reviewPackGenerationDecisionForTenant($tenant);
        if (! (bool) ($decision['is_blocked'] ?? false)) {
            return;
        }
        throw new WorkspaceEntitlementBlockedException($decision);
    }
    private function computeFingerprintForSnapshot(EvidenceSnapshot $snapshot, array $options): string
    {
        $data = [
--- a/apps/platform/app/Services/Runbooks/FindingsLifecycleBackfillRunbookService.php
+++ b/apps/platform/app/Services/Runbooks/FindingsLifecycleBackfillRunbookService.php
@ -1,739 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Services\Runbooks;
 use App\Jobs\BackfillFindingLifecycleJob;
 use App\Jobs\BackfillFindingLifecycleWorkspaceJob;
 use App\Models\Finding;
 use App\Models\OperationRun;
 use App\Models\PlatformUser;
 use App\Models\Tenant;
 use App\Models\User;
 use App\Models\Workspace;
 use App\Notifications\OperationRunCompleted;
 use App\Services\Alerts\AlertDispatchService;
 use App\Services\Audit\AuditRecorder;
 use App\Services\Audit\WorkspaceAuditLogger;
 use App\Services\Auth\BreakGlassSession;
 use App\Services\Intune\AuditLogger;
 use App\Services\OperationRunService;
 use App\Services\System\AllowedTenantUniverse;
 use App\Support\Audit\AuditActionId;
 use App\Support\Audit\AuditActorSnapshot;
 use App\Support\Audit\AuditTargetSnapshot;
 use App\Support\OperationCatalog;
 use App\Support\OperationRunOutcome;
 use App\Support\OperationRunStatus;
 use App\Support\OperationalControls\OperationalControlBlockedException;
 use App\Support\OperationalControls\OperationalControlEvaluator;
 use App\Support\System\SystemOperationRunLinks;
 use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Validation\ValidationException;
 use Throwable;
 class FindingsLifecycleBackfillRunbookService
 {
    public const string RUNBOOK_KEY = 'findings.lifecycle.backfill';
    public function __construct(
        private readonly AllowedTenantUniverse $allowedTenantUniverse,
        private readonly BreakGlassSession $breakGlassSession,
        private readonly OperationRunService $operationRunService,
        private readonly AuditLogger $auditLogger,
        private readonly AlertDispatchService $alertDispatchService,
        private readonly OperationalControlEvaluator $operationalControls,
        private readonly AuditRecorder $auditRecorder,
        private readonly WorkspaceAuditLogger $workspaceAuditLogger,
    ) {}
    /**
     * @return array{affected_count: int, total_count: int, estimated_tenants?: int|null}
     */
    public function preflight(FindingsLifecycleBackfillScope $scope): array
    {
        $result = $this->computePreflight($scope);
        $this->auditSafely(
            action: 'platform.ops.runbooks.preflight',
            scope: $scope,
            operationRunId: null,
            initiator: null,
            context: [
                'preflight' => $result,
            ],
        );
        return $result;
    }
    public function start(
        FindingsLifecycleBackfillScope $scope,
        User|PlatformUser|null $initiator,
        ?RunbookReason $reason,
        string $source,
    ): OperationRun {
        $source = trim($source);
        if ($source === '') {
            throw ValidationException::withMessages([
                'source' => 'A run source is required.',
            ]);
        }
        $isBreakGlassActive = $this->breakGlassSession->isActive();
        if ($scope->isAllTenants() || $isBreakGlassActive) {
            if (! $reason instanceof RunbookReason) {
                throw ValidationException::withMessages([
                    'reason' => 'A reason is required for this run.',
                ]);
            }
        }
        $preflight = $this->computePreflight($scope);
        if (($preflight['affected_count'] ?? 0) <= 0) {
            throw ValidationException::withMessages([
                'preflight.affected_count' => 'Nothing to do for this scope.',
            ]);
        }
        $workspace = null;
        $tenant = null;
        if ($scope->isSingleTenant()) {
            $tenant = Tenant::query()->whereKey((int) $scope->tenantId)->firstOrFail();
            $this->allowedTenantUniverse->ensureAllowed($tenant);
            $workspace = $tenant->workspace;
        } else {
            $platformTenant = $this->platformTenant();
            $workspace = $platformTenant->workspace;
        }
        if (! $workspace instanceof Workspace) {
            throw new \RuntimeException('Platform tenant is missing its workspace.');
        }
        $decision = $this->operationalControls->evaluate(self::RUNBOOK_KEY, $workspace);
        if ($decision->isPaused()) {
            $this->auditBlockedStart(
                decision: $decision,
                scope: $scope,
                workspace: $workspace,
                tenant: $tenant,
                initiator: $initiator,
                source: $source,
            );
            throw OperationalControlBlockedException::forDecision(
                decision: $decision,
                actionLabel: OperationCatalog::label(self::RUNBOOK_KEY),
            );
        }
        if ($scope->isAllTenants()) {
            $lockKey = sprintf('tenantpilot:runbooks:%s:workspace:%d', self::RUNBOOK_KEY, (int) $workspace->getKey());
            $lock = Cache::lock($lockKey, 900);
            if (! $lock->get()) {
                throw ValidationException::withMessages([
                    'scope' => 'Another run is already in progress for this scope.',
                ]);
            }
            try {
                return $this->startAllTenants(
                    workspace: $workspace,
                    initiator: $initiator,
                    reason: $reason,
                    preflight: $preflight,
                    source: $source,
                    isBreakGlassActive: $isBreakGlassActive,
                );
            } finally {
                $lock->release();
            }
        }
        return $this->startSingleTenant(
            tenant: $tenant,
            initiator: $initiator,
            reason: $reason,
            preflight: $preflight,
            source: $source,
            isBreakGlassActive: $isBreakGlassActive,
        );
    }
    public function maybeFinalize(OperationRun $run): void
    {
        $run->refresh();
        if ($run->status !== OperationRunStatus::Completed->value) {
            return;
        }
        $context = is_array($run->context) ? $run->context : [];
        if ((string) data_get($context, 'runbook.key') !== self::RUNBOOK_KEY) {
            return;
        }
        $lockKey = sprintf('tenantpilot:runbooks:%s:finalize:%d', self::RUNBOOK_KEY, (int) $run->getKey());
        $lock = Cache::lock($lockKey, 86400);
        if (! $lock->get()) {
            return;
        }
        try {
            $this->auditSafely(
                action: $run->outcome === OperationRunOutcome::Failed->value
                    ? 'platform.ops.runbooks.failed'
                    : 'platform.ops.runbooks.completed',
                scope: $this->scopeFromRunContext($context),
                operationRunId: (int) $run->getKey(),
                context: [
                    'status' => (string) $run->status,
                    'outcome' => (string) $run->outcome,
                    'is_break_glass' => (bool) data_get($context, 'platform_initiator.is_break_glass', false),
                    'reason_code' => data_get($context, 'reason.reason_code'),
                    'reason_text' => data_get($context, 'reason.reason_text'),
                ],
            );
            $this->notifyInitiatorSafely($run);
            if ($run->outcome === OperationRunOutcome::Failed->value) {
                $this->dispatchFailureAlertSafely($run);
            }
        } finally {
            $lock->release();
        }
    }
    /**
     * @return array{affected_count: int, total_count: int, estimated_tenants?: int|null}
     */
    private function computePreflight(FindingsLifecycleBackfillScope $scope): array
    {
        if ($scope->isSingleTenant()) {
            $tenant = Tenant::query()->whereKey((int) $scope->tenantId)->firstOrFail();
            $this->allowedTenantUniverse->ensureAllowed($tenant);
            return $this->computeTenantPreflight($tenant);
        }
        $platformTenant = $this->platformTenant();
        $workspaceId = (int) ($platformTenant->workspace_id ?? 0);
        $tenants = $this->allowedTenantUniverse
            ->query()
            ->where('workspace_id', $workspaceId)
            ->orderBy('id')
            ->get();
        $affected = 0;
        $total = 0;
        foreach ($tenants as $tenant) {
            if (! $tenant instanceof Tenant) {
                continue;
            }
            $counts = $this->computeTenantPreflight($tenant);
            $affected += (int) ($counts['affected_count'] ?? 0);
            $total += (int) ($counts['total_count'] ?? 0);
        }
        return [
            'affected_count' => $affected,
            'total_count' => $total,
            'estimated_tenants' => $tenants->count(),
        ];
    }
    /**
     * @return array{affected_count: int, total_count: int}
     */
    private function computeTenantPreflight(Tenant $tenant): array
    {
        $query = Finding::query()->where('tenant_id', (int) $tenant->getKey());
        $total = (int) (clone $query)->count();
        $affected = 0;
        (clone $query)
            ->orderBy('id')
            ->chunkById(500, function ($findings) use (&$affected): void {
                foreach ($findings as $finding) {
                    if (! $finding instanceof Finding) {
                        continue;
                    }
                    if ($this->findingNeedsBackfill($finding)) {
                        $affected++;
                    }
                }
            });
        $affected += $this->countDriftDuplicateConsolidations($tenant);
        return [
            'affected_count' => $affected,
            'total_count' => $total,
        ];
    }
    private function findingNeedsBackfill(Finding $finding): bool
    {
        if ($finding->first_seen_at === null || $finding->last_seen_at === null) {
            return true;
        }
        if ($finding->last_seen_at !== null && $finding->first_seen_at !== null) {
            if ($finding->last_seen_at->lt($finding->first_seen_at)) {
                return true;
            }
        }
        $timesSeen = is_numeric($finding->times_seen) ? (int) $finding->times_seen : 0;
        if ($timesSeen < 1) {
            return true;
        }
        if ($finding->status === Finding::STATUS_ACKNOWLEDGED) {
            return true;
        }
        if (Finding::isOpenStatus((string) $finding->status)) {
            if ($finding->sla_days === null || $finding->due_at === null) {
                return true;
            }
        }
        if ($finding->finding_type === Finding::FINDING_TYPE_DRIFT) {
            $recurrenceKey = $finding->recurrence_key !== null ? trim((string) $finding->recurrence_key) : '';
            if ($recurrenceKey === '') {
                $scopeKey = trim((string) ($finding->scope_key ?? ''));
                $subjectType = trim((string) ($finding->subject_type ?? ''));
                $subjectExternalId = trim((string) ($finding->subject_external_id ?? ''));
                if ($scopeKey !== '' && $subjectType !== '' && $subjectExternalId !== '') {
                    $evidence = is_array($finding->evidence_jsonb) ? $finding->evidence_jsonb : [];
                    $kind = data_get($evidence, 'summary.kind');
                    if (is_string($kind) && trim($kind) !== '') {
                        return true;
                    }
                }
            }
        }
        return false;
    }
    private function countDriftDuplicateConsolidations(Tenant $tenant): int
    {
        $rows = Finding::query()
            ->where('tenant_id', (int) $tenant->getKey())
            ->where('finding_type', Finding::FINDING_TYPE_DRIFT)
            ->whereNotNull('recurrence_key')
            ->select(['recurrence_key', DB::raw('COUNT(*) as count')])
            ->groupBy('recurrence_key')
            ->havingRaw('COUNT(*) > 1')
            ->get();
        $duplicates = 0;
        foreach ($rows as $row) {
            $count = is_numeric($row->count ?? null) ? (int) $row->count : 0;
            if ($count > 1) {
                $duplicates += ($count - 1);
            }
        }
        return $duplicates;
    }
    private function startAllTenants(
        Workspace $workspace,
        User|PlatformUser|null $initiator,
        ?RunbookReason $reason,
        array $preflight,
        string $source,
        bool $isBreakGlassActive,
    ): OperationRun {
        $run = $this->operationRunService->ensureWorkspaceRunWithIdentity(
            workspace: $workspace,
            type: self::RUNBOOK_KEY,
            identityInputs: [
                'runbook' => self::RUNBOOK_KEY,
                'scope' => FindingsLifecycleBackfillScope::MODE_ALL_TENANTS,
            ],
            context: $this->buildRunContext(
                workspaceId: (int) $workspace->getKey(),
                scope: FindingsLifecycleBackfillScope::allTenants(),
                initiator: $initiator,
                reason: $reason,
                preflight: $preflight,
                source: $source,
                isBreakGlassActive: $isBreakGlassActive,
            ),
            initiator: $initiator instanceof User ? $initiator : null,
        );
        if ($initiator instanceof PlatformUser && $run->wasRecentlyCreated) {
            $run->update(['initiator_name' => $initiator->name ?: $initiator->email]);
            $run->refresh();
        }
        $this->auditSafely(
            action: 'platform.ops.runbooks.start',
            scope: FindingsLifecycleBackfillScope::allTenants(),
            operationRunId: (int) $run->getKey(),
            initiator: $initiator,
            context: [
                'preflight' => $preflight,
                'is_break_glass' => $isBreakGlassActive,
            ] + ($reason instanceof RunbookReason ? $reason->toArray() : []),
        );
        if (! $run->wasRecentlyCreated) {
            return $run;
        }
        $this->operationRunService->dispatchOrFail($run, function () use ($run, $workspace): void {
            BackfillFindingLifecycleWorkspaceJob::dispatch(
                operationRunId: (int) $run->getKey(),
                workspaceId: (int) $workspace->getKey(),
            );
        });
        return $run;
    }
    private function startSingleTenant(
        ?Tenant $tenant,
        User|PlatformUser|null $initiator,
        ?RunbookReason $reason,
        array $preflight,
        string $source,
        bool $isBreakGlassActive,
    ): OperationRun {
        if (! $tenant instanceof Tenant) {
            throw new \RuntimeException('Target tenant is required for single-tenant runs.');
        }
        $run = $this->operationRunService->ensureRunWithIdentity(
            tenant: $tenant,
            type: self::RUNBOOK_KEY,
            identityInputs: [
                'tenant_id' => (int) $tenant->getKey(),
                'trigger' => 'backfill',
            ],
            context: $this->buildRunContext(
                workspaceId: (int) $tenant->workspace_id,
                scope: FindingsLifecycleBackfillScope::singleTenant((int) $tenant->getKey()),
                initiator: $initiator,
                reason: $reason,
                preflight: $preflight,
                source: $source,
                isBreakGlassActive: $isBreakGlassActive,
            ),
            initiator: $initiator instanceof User ? $initiator : null,
        );
        if ($initiator instanceof PlatformUser && $run->wasRecentlyCreated) {
            $run->update(['initiator_name' => $initiator->name ?: $initiator->email]);
            $run->refresh();
        }
        $this->auditSafely(
            action: 'platform.ops.runbooks.start',
            scope: FindingsLifecycleBackfillScope::singleTenant((int) $tenant->getKey()),
            operationRunId: (int) $run->getKey(),
            initiator: $initiator,
            context: [
                'preflight' => $preflight,
                'is_break_glass' => $isBreakGlassActive,
            ] + ($reason instanceof RunbookReason ? $reason->toArray() : []),
        );
        if (! $run->wasRecentlyCreated) {
            return $run;
        }
        $this->operationRunService->dispatchOrFail($run, function () use ($tenant): void {
            BackfillFindingLifecycleJob::dispatch(
                tenantId: (int) $tenant->getKey(),
                workspaceId: (int) $tenant->workspace_id,
                initiatorUserId: null,
            );
        });
        return $run;
    }
    private function platformTenant(): Tenant
    {
        $tenant = Tenant::query()->where('external_id', 'platform')->first();
        if (! $tenant instanceof Tenant) {
            throw new \RuntimeException('Platform tenant is missing.');
        }
        return $tenant;
    }
    /**
     * @return array<string, mixed>
     */
    private function buildRunContext(
        int $workspaceId,
        FindingsLifecycleBackfillScope $scope,
        User|PlatformUser|null $initiator,
        ?RunbookReason $reason,
        array $preflight,
        string $source,
        bool $isBreakGlassActive,
    ): array {
        $context = [
            'workspace_id' => $workspaceId,
            'runbook' => [
                'key' => self::RUNBOOK_KEY,
                'scope' => $scope->mode,
                'target_tenant_id' => $scope->tenantId,
                'source' => $source,
            ],
            'preflight' => [
                'affected_count' => (int) ($preflight['affected_count'] ?? 0),
                'total_count' => (int) ($preflight['total_count'] ?? 0),
                'estimated_tenants' => $preflight['estimated_tenants'] ?? null,
            ],
        ];
        if ($reason instanceof RunbookReason) {
            $context['reason'] = $reason->toArray();
        }
        if ($initiator instanceof PlatformUser) {
            $context['platform_initiator'] = [
                'platform_user_id' => (int) $initiator->getKey(),
                'email' => (string) $initiator->email,
                'name' => (string) $initiator->name,
                'is_break_glass' => $isBreakGlassActive,
            ];
        } elseif ($initiator instanceof User) {
            $context['tenant_initiator'] = [
                'user_id' => (int) $initiator->getKey(),
                'email' => (string) $initiator->email,
                'name' => (string) $initiator->name,
            ];
        }
        return $context;
    }
    private function scopeFromRunContext(array $context): FindingsLifecycleBackfillScope
    {
        $scope = data_get($context, 'runbook.scope');
        $tenantId = data_get($context, 'runbook.target_tenant_id');
        if ($scope === FindingsLifecycleBackfillScope::MODE_SINGLE_TENANT && is_numeric($tenantId)) {
            return FindingsLifecycleBackfillScope::singleTenant((int) $tenantId);
        }
        return FindingsLifecycleBackfillScope::allTenants();
    }
    /**
     * @param  array<string, mixed>  $context
     */
    private function auditSafely(
        string $action,
        FindingsLifecycleBackfillScope $scope,
        ?int $operationRunId,
        User|PlatformUser|null $initiator,
        array $context = [],
    ): void {
        try {
            $metadata = [
                'runbook_key' => self::RUNBOOK_KEY,
                'scope' => $scope->mode,
                'target_tenant_id' => $scope->tenantId,
                'operation_run_id' => $operationRunId,
                'ip' => request()->ip(),
                'user_agent' => request()->userAgent(),
            ];
            if ($initiator instanceof User && $scope->isSingleTenant()) {
                $tenant = Tenant::query()->whereKey((int) $scope->tenantId)->first();
                if ($tenant instanceof Tenant) {
                    $this->auditLogger->log(
                        tenant: $tenant,
                        action: $action,
                        context: [
                            'metadata' => array_filter($metadata, static fn (mixed $value): bool => $value !== null),
                        ] + $context,
                        actorId: (int) $initiator->getKey(),
                        actorEmail: (string) $initiator->email,
                        actorName: (string) $initiator->name,
                        status: 'success',
                        resourceType: 'operation_run',
                        resourceId: $operationRunId !== null ? (string) $operationRunId : null,
                    );
                    return;
                }
            }
            $platformTenant = $this->platformTenant();
            $platformActor = $initiator instanceof PlatformUser
                ? $initiator
                : auth('platform')->user();
            $actorId = $platformActor instanceof PlatformUser ? (int) $platformActor->getKey() : null;
            $actorEmail = $platformActor instanceof PlatformUser ? (string) $platformActor->email : null;
            $actorName = $platformActor instanceof PlatformUser ? (string) $platformActor->name : null;
            $this->auditLogger->log(
                tenant: $platformTenant,
                action: $action,
                context: [
                    'metadata' => array_filter($metadata, static fn (mixed $value): bool => $value !== null),
                ] + $context,
                actorId: $actorId,
                actorEmail: $actorEmail,
                actorName: $actorName,
                status: 'success',
                resourceType: 'operation_run',
                resourceId: $operationRunId !== null ? (string) $operationRunId : null,
            );
        } catch (Throwable) {
            // Audit is fail-safe (must not crash runbooks).
        }
    }
    private function auditBlockedStart(
        \App\Support\OperationalControls\OperationalControlDecision $decision,
        FindingsLifecycleBackfillScope $scope,
        Workspace $workspace,
        ?Tenant $tenant,
        User|PlatformUser|null $initiator,
        string $source,
    ): void {
        try {
            $metadata = array_filter([
                'control_key' => $decision->controlKey,
                'scope_type' => $decision->matchedScopeType,
                'workspace_id' => (int) $workspace->getKey(),
                'reason_text' => $decision->reasonText,
                'expires_at' => $decision->expiresAt?->toIso8601String(),
                'actor_id' => $initiator instanceof User || $initiator instanceof PlatformUser ? (int) $initiator->getKey() : null,
                'requested_scope' => $scope->mode,
                'target_tenant_id' => $scope->tenantId,
                'source' => $source,
                'runbook_key' => self::RUNBOOK_KEY,
            ], static fn (mixed $value): bool => $value !== null && $value !== '');
            $summary = sprintf('%s blocked by operational control', OperationCatalog::label(self::RUNBOOK_KEY));
            if ($scope->isAllTenants()) {
                $this->auditRecorder->record(
                    action: AuditActionId::OperationalControlExecutionBlocked,
                    context: ['metadata' => $metadata],
                    actor: $initiator instanceof PlatformUser ? AuditActorSnapshot::platform($initiator) : null,
                    target: new AuditTargetSnapshot(
                        type: 'operational_control',
                        id: $decision->sourceActivationId,
                        label: OperationCatalog::label(self::RUNBOOK_KEY),
                    ),
                    outcome: 'blocked',
                    summary: $summary,
                );
                return;
            }
            if (! $tenant instanceof Tenant) {
                return;
            }
            $this->workspaceAuditLogger->log(
                workspace: $workspace,
                action: AuditActionId::OperationalControlExecutionBlocked,
                context: ['metadata' => $metadata],
                actor: $initiator,
                status: 'blocked',
                resourceType: 'operational_control',
                resourceId: $decision->sourceActivationId !== null ? (string) $decision->sourceActivationId : null,
                targetLabel: OperationCatalog::label(self::RUNBOOK_KEY),
                summary: $summary,
                tenant: $tenant,
            );
        } catch (Throwable) {
            // Audit is fail-safe (must not crash runbooks).
        }
    }
    private function notifyInitiatorSafely(OperationRun $run): void
    {
        try {
            $platformUserId = data_get($run->context, 'platform_initiator.platform_user_id');
            if (! is_numeric($platformUserId)) {
                return;
            }
            $platformUser = PlatformUser::query()->whereKey((int) $platformUserId)->first();
            if (! $platformUser instanceof PlatformUser) {
                return;
            }
            $platformUser->notify(new OperationRunCompleted($run));
        } catch (Throwable) {
            // Notifications must not crash the runbook.
        }
    }
    private function dispatchFailureAlertSafely(OperationRun $run): void
    {
        try {
            $platformTenant = $this->platformTenant();
            $workspace = $platformTenant->workspace;
            if (! $workspace instanceof Workspace) {
                return;
            }
            $this->alertDispatchService->dispatchEvent($workspace, [
                'tenant_id' => (int) $platformTenant->getKey(),
                'event_type' => 'operations.run.failed',
                'severity' => 'high',
                'title' => 'Operation failed: Findings lifecycle backfill',
                'body' => 'A findings lifecycle backfill run failed.',
                'metadata' => [
                    'operation_run_id' => (int) $run->getKey(),
                    'operation_type' => $run->canonicalOperationType(),
                    'scope' => (string) data_get($run->context, 'runbook.scope', ''),
                    'view_run_url' => SystemOperationRunLinks::view($run),
                ],
            ]);
        } catch (Throwable) {
            // Alerts must not crash the runbook.
        }
    }
 }
--- a/apps/platform/app/Services/Runbooks/FindingsLifecycleBackfillScope.php
+++ b/apps/platform/app/Services/Runbooks/FindingsLifecycleBackfillScope.php
@ -1,81 +0,0 @@
 <?php
 declare(strict_types=1);
 namespace App\Services\Runbooks;
 use Illuminate\Validation\ValidationException;
 final readonly class FindingsLifecycleBackfillScope
 {
    public const string MODE_ALL_TENANTS = 'all_tenants';
    public const string MODE_SINGLE_TENANT = 'single_tenant';
    private function __construct(
        public string $mode,
        public ?int $tenantId,
    ) {}
    public static function allTenants(): self
    {
        return new self(
            mode: self::MODE_ALL_TENANTS,
            tenantId: null,
        );
    }
    public static function singleTenant(int $tenantId): self
    {
        $tenantId = (int) $tenantId;
        if ($tenantId <= 0) {
            throw ValidationException::withMessages([
                'scope.tenant_id' => 'Select a valid tenant.',
            ]);
        }
        return new self(
            mode: self::MODE_SINGLE_TENANT,
            tenantId: $tenantId,
        );
    }
    /**
     * @param  array<string, mixed>  $data
     */
    public static function fromArray(array $data): self
    {
        $mode = trim((string) ($data['mode'] ?? ''));
        if ($mode === '' || $mode === self::MODE_ALL_TENANTS) {
            return self::allTenants();
        }
        if ($mode !== self::MODE_SINGLE_TENANT) {
            throw ValidationException::withMessages([
                'scope.mode' => 'Select a valid scope mode.',
            ]);
        }
        $tenantId = $data['tenant_id'] ?? null;
        if (! is_numeric($tenantId)) {
            throw ValidationException::withMessages([
                'scope.tenant_id' => 'Select a tenant.',
            ]);
        }
        return self::singleTenant((int) $tenantId);
    }
    public function isAllTenants(): bool
    {
        return $this->mode === self::MODE_ALL_TENANTS;
    }
    public function isSingleTenant(): bool
    {
        return $this->mode === self::MODE_SINGLE_TENANT;
    }
 }
--- a/apps/platform/app/Services/Settings/SettingsWriter.php
+++ b/apps/platform/app/Services/Settings/SettingsWriter.php
@ -4,6 +4,7 @@
 namespace App\Services\Settings;
 use App\Models\PlatformUser;
 use App\Models\Tenant;
 use App\Models\TenantSetting;
 use App\Models\User;
@ -11,11 +12,14 @@
 use App\Models\WorkspaceSetting;
 use App\Services\Audit\WorkspaceAuditLogger;
 use App\Services\Auth\WorkspaceCapabilityResolver;
 use App\Services\Entitlements\WorkspaceCommercialLifecycleResolver;
 use App\Support\Audit\AuditActionId;
 use App\Support\Auth\Capabilities;
 use App\Support\Auth\PlatformCapabilities;
 use App\Support\Settings\SettingDefinition;
 use App\Support\Settings\SettingsRegistry;
 use Illuminate\Auth\Access\AuthorizationException;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Validator;
 use Illuminate\Validation\ValidationException;
 use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
@ -33,27 +37,7 @@ public function updateWorkspaceSetting(User $actor, Workspace $workspace, string
    {
        $this->authorizeManage($actor, $workspace);
-        $definition = $this->requireDefinition($domain, $key);
+        $result = $this->persistWorkspaceSetting($workspace, $domain, $key, $value, (int) $actor->getKey());
        $normalizedValue = $this->validatedValue($definition, $value);
        $existing = WorkspaceSetting::query()
            ->where('workspace_id', (int) $workspace->getKey())
            ->where('domain', $domain)
            ->where('key', $key)
            ->first();
        $beforeValue = $existing instanceof WorkspaceSetting
            ? $this->decodeStoredValue($existing->getAttribute('value'))
            : null;
        $setting = WorkspaceSetting::query()->updateOrCreate([
            'workspace_id' => (int) $workspace->getKey(),
            'domain' => $domain,
            'key' => $key,
        ], [
            'value' => $normalizedValue,
            'updated_by_user_id' => (int) $actor->getKey(),
        ]);
        $this->resolver->clearCache();
@ -67,7 +51,7 @@ public function updateWorkspaceSetting(User $actor, Workspace $workspace, string
                    'scope' => 'workspace',
                    'domain' => $domain,
                    'key' => $key,
-                    'before_value' => $beforeValue,
+                    'before_value' => $result['before_value'],
                    'after_value' => $afterValue,
                ],
            ],
@ -76,7 +60,79 @@ public function updateWorkspaceSetting(User $actor, Workspace $workspace, string
            resourceId: $domain.'.'.$key,
        );
-        return $setting;
+        return $result['setting'];
    }
    public function updateWorkspaceCommercialLifecycle(
        PlatformUser $actor,
        Workspace $workspace,
        string $state,
        string $reason,
    ): void {
        $state = strtolower(trim($state));
        $reason = trim($reason);
        if (! $actor->hasCapability(PlatformCapabilities::COMMERCIAL_LIFECYCLE_MANAGE)) {
            throw new AuthorizationException('Missing commercial lifecycle manage capability.');
        }
        if ($reason === '') {
            throw ValidationException::withMessages([
                'reason' => ['A rationale is required when changing commercial lifecycle state.'],
            ]);
        }
        DB::transaction(function () use ($actor, $workspace, $state, $reason): void {
            $stateResult = $this->persistWorkspaceSetting(
                workspace: $workspace,
                domain: WorkspaceCommercialLifecycleResolver::SETTING_DOMAIN,
                key: WorkspaceCommercialLifecycleResolver::SETTING_COMMERCIAL_LIFECYCLE_STATE,
                value: $state,
                updatedByUserId: null,
            );
            $reasonResult = $this->persistWorkspaceSetting(
                workspace: $workspace,
                domain: WorkspaceCommercialLifecycleResolver::SETTING_DOMAIN,
                key: WorkspaceCommercialLifecycleResolver::SETTING_COMMERCIAL_LIFECYCLE_REASON,
                value: $reason,
                updatedByUserId: null,
            );
            $this->resolver->clearCache();
            $afterState = $this->resolver->resolveValue(
                $workspace,
                WorkspaceCommercialLifecycleResolver::SETTING_DOMAIN,
                WorkspaceCommercialLifecycleResolver::SETTING_COMMERCIAL_LIFECYCLE_STATE,
            );
            $afterReason = $this->resolver->resolveValue(
                $workspace,
                WorkspaceCommercialLifecycleResolver::SETTING_DOMAIN,
                WorkspaceCommercialLifecycleResolver::SETTING_COMMERCIAL_LIFECYCLE_REASON,
            );
            $this->auditLogger->log(
                workspace: $workspace,
                action: AuditActionId::WorkspaceSettingUpdated->value,
                context: [
                    'metadata' => [
                        'scope' => 'workspace',
                        'domain' => WorkspaceCommercialLifecycleResolver::SETTING_DOMAIN,
                        'key' => WorkspaceCommercialLifecycleResolver::SETTING_COMMERCIAL_LIFECYCLE_STATE,
                        'before_state' => $stateResult['before_value'],
                        'after_state' => $afterState,
                        'before_reason' => $reasonResult['before_value'],
                        'after_reason' => $afterReason,
                    ],
                ],
                actor: $actor,
                resourceType: 'workspace_setting',
                resourceId: WorkspaceCommercialLifecycleResolver::SETTING_DOMAIN.'.'.WorkspaceCommercialLifecycleResolver::SETTING_COMMERCIAL_LIFECYCLE_STATE,
                targetLabel: 'Commercial lifecycle state',
            );
        });
    }
    public function resetWorkspaceSetting(User $actor, Workspace $workspace, string $domain, string $key): void
@ -174,6 +230,39 @@ private function requireDefinition(string $domain, string $key): SettingDefiniti
        ]);
    }
    /**
     * @return array{setting: WorkspaceSetting, before_value: mixed}
     */
    private function persistWorkspaceSetting(Workspace $workspace, string $domain, string $key, mixed $value, ?int $updatedByUserId): array
    {
        $definition = $this->requireDefinition($domain, $key);
        $normalizedValue = $this->validatedValue($definition, $value);
        $existing = WorkspaceSetting::query()
            ->where('workspace_id', (int) $workspace->getKey())
            ->where('domain', $domain)
            ->where('key', $key)
            ->first();
        $beforeValue = $existing instanceof WorkspaceSetting
            ? $this->decodeStoredValue($existing->getAttribute('value'))
            : null;
        $setting = WorkspaceSetting::query()->updateOrCreate([
            'workspace_id' => (int) $workspace->getKey(),
            'domain' => $domain,
            'key' => $key,
        ], [
            'value' => $normalizedValue,
            'updated_by_user_id' => $updatedByUserId,
        ]);
        return [
            'setting' => $setting,
            'before_value' => $beforeValue,
        ];
    }
    private function validatedValue(SettingDefinition $definition, mixed $value): mixed
    {
        $validator = Validator::make(
--- a/apps/platform/app/Services/SystemConsole/OperationRunTriageService.php
+++ b/apps/platform/app/Services/SystemConsole/OperationRunTriageService.php
@ -17,7 +17,6 @@ final class OperationRunTriageService
        'inventory.sync',
        'policy.sync',
        'directory.groups.sync',
        'findings.lifecycle.backfill',
        'rbac.health_check',
        'entra.admin_roles.scan',
        'tenant.review_pack.generate',
@ -28,7 +27,6 @@ final class OperationRunTriageService
        'inventory.sync',
        'policy.sync',
        'directory.groups.sync',
        'findings.lifecycle.backfill',
        'rbac.health_check',
        'entra.admin_roles.scan',
        'tenant.review_pack.generate',
--- a/apps/platform/app/Services/TenantReviews/TenantReviewRegisterService.php
+++ b/apps/platform/app/Services/TenantReviews/TenantReviewRegisterService.php
@ -12,6 +12,7 @@
 use App\Services\Auth\RoleCapabilityMap;
 use App\Support\Auth\Capabilities;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Support\Facades\DB;
 final class TenantReviewRegisterService
 {
@ -43,6 +44,55 @@ public function query(User $user, Workspace $workspace): Builder
            ->latest('id');
    }
    public function latestPublishedQuery(User $user, Workspace $workspace): Builder
    {
        $tenantIds = array_keys($this->authorizedTenants($user, $workspace));
        $rankedReviews = TenantReview::query()
            ->select([
                'tenant_reviews.id',
                'tenant_reviews.tenant_id',
                'tenant_reviews.published_at',
                'tenant_reviews.generated_at',
            ])
            ->selectRaw('ROW_NUMBER() OVER (PARTITION BY tenant_id ORDER BY published_at DESC, generated_at DESC, id DESC) as rn')
            ->forWorkspace((int) $workspace->getKey())
            ->whereIn('tenant_id', $tenantIds === [] ? [-1] : $tenantIds)
            ->published();
        $latestPublishedIds = DB::query()
            ->fromSub($rankedReviews, 'ranked_tenant_reviews')
            ->where('rn', 1)
            ->select('id');
        return TenantReview::query()
            ->with(['tenant', 'evidenceSnapshot', 'currentExportReviewPack'])
            ->forWorkspace((int) $workspace->getKey())
            ->whereIn('tenant_reviews.id', $latestPublishedIds)
            ->orderByDesc('published_at')
            ->orderByDesc('generated_at')
            ->orderByDesc('id');
    }
    public function customerWorkspaceTenantQuery(User $user, Workspace $workspace): Builder
    {
        $tenantIds = array_keys($this->authorizedTenants($user, $workspace));
        return Tenant::query()
            ->where('workspace_id', (int) $workspace->getKey())
            ->whereIn('id', $tenantIds === [] ? [-1] : $tenantIds)
            ->with([
                'tenantReviews' => fn ($query) => $query
                    ->with(['tenant', 'evidenceSnapshot', 'currentExportReviewPack'])
                    ->published()
                    ->orderByDesc('published_at')
                    ->orderByDesc('generated_at')
                    ->orderByDesc('id')
                    ->limit(1),
            ])
            ->orderBy('name');
    }
    public function canAccessWorkspace(User $user, Workspace $workspace): bool
    {
        return WorkspaceMembership::query()
--- a/apps/platform/app/Services/TenantReviews/TenantReviewSectionFactory.php
+++ b/apps/platform/app/Services/TenantReviews/TenantReviewSectionFactory.php
@ -128,7 +128,7 @@ private function openRisksSection(?EvidenceSnapshotItem $findingsItem): array
    {
        $summary = $this->summary($findingsItem);
        $entries = collect(Arr::wrap($summary['entries'] ?? []))
-            ->filter(static fn (mixed $entry): bool => is_array($entry) && in_array((string) ($entry['status'] ?? ''), ['open', 'in_progress', 'acknowledged'], true))
+            ->filter(static fn (mixed $entry): bool => is_array($entry) && in_array((string) ($entry['status'] ?? ''), ['open', 'new', 'triaged', 'in_progress', 'reopened'], true))
            ->sortByDesc(static fn (array $entry): int => match ((string) ($entry['severity'] ?? 'low')) {
                'critical' => 4,
                'high' => 3,
--- a/apps/platform/app/Support/Ai/AiDataClassification.php
+++ b/apps/platform/app/Support/Ai/AiDataClassification.php
@ -0,0 +1,27 @@
 <?php
 declare(strict_types=1);
 namespace App\Support\Ai;
 enum AiDataClassification: string
 {
    case ProductKnowledge = 'product_knowledge';
    case OperationalMetadata = 'operational_metadata';
    case RedactedSupportSummary = 'redacted_support_summary';
    case PersonalData = 'personal_data';
    case CustomerConfidential = 'customer_confidential';
    case RawProviderPayload = 'raw_provider_payload';
    public function label(): string
    {
        return match ($this) {
            self::ProductKnowledge => 'Product knowledge',
            self::OperationalMetadata => 'Operational metadata',
            self::RedactedSupportSummary => 'Redacted support summary',
            self::PersonalData => 'Personal data',
            self::CustomerConfidential => 'Customer confidential',
            self::RawProviderPayload => 'Raw provider payload',
        };
    }
 }
--- a/apps/platform/app/Support/Ai/AiDecisionAuditMetadataFactory.php
+++ b/apps/platform/app/Support/Ai/AiDecisionAuditMetadataFactory.php
@ -0,0 +1,39 @@
 <?php
 declare(strict_types=1);
 namespace App\Support\Ai;
 final class AiDecisionAuditMetadataFactory
 {
    /**
     * @return array<string, mixed>
     */
    public function make(AiExecutionRequest $request, AiExecutionDecision $decision): array
    {
        return array_filter([
            'use_case_key' => $decision->useCaseKey,
            'decision_outcome' => $decision->outcome,
            'decision_reason' => $decision->reasonCode->value,
            'workspace_ai_policy_mode' => $decision->workspaceAiPolicyMode,
            'requested_provider_class' => $decision->requestedProviderClass,
            'data_classifications' => $decision->dataClassifications,
            'source_family' => $decision->sourceFamily,
            'workspace_id' => $request->workspace?->getKey(),
            'tenant_id' => $request->tenant?->getKey(),
            'context_fingerprint' => $this->normalizedFingerprint($request->contextFingerprint),
            'matched_operational_control_scope' => $decision->matchedOperationalControlScope,
        ], static fn (mixed $value): bool => $value !== null);
    }
    private function normalizedFingerprint(?string $contextFingerprint): ?string
    {
        if (! is_string($contextFingerprint)) {
            return null;
        }
        $normalized = trim($contextFingerprint);
        return $normalized === '' ? null : $normalized;
    }
 }
--- a/apps/platform/app/Support/Ai/AiDecisionReasonCode.php
+++ b/apps/platform/app/Support/Ai/AiDecisionReasonCode.php
@ -0,0 +1,18 @@
 <?php
 declare(strict_types=1);
 namespace App\Support\Ai;
 enum AiDecisionReasonCode: string
 {
    case Allowed = 'allowed';
    case MissingWorkspaceContext = 'missing_workspace_context';
    case TenantOutsideWorkspace = 'tenant_outside_workspace';
    case OperationalControlPaused = 'operational_control_paused';
    case WorkspacePolicyDisabled = 'workspace_policy_disabled';
    case UnregisteredUseCase = 'unregistered_use_case';
    case ProviderClassBlocked = 'provider_class_blocked';
    case DataClassificationBlocked = 'data_classification_blocked';
    case SourceFamilyMismatch = 'source_family_mismatch';
 }
--- a/apps/platform/app/Support/Ai/AiExecutionDecision.php
+++ b/apps/platform/app/Support/Ai/AiExecutionDecision.php
@ -0,0 +1,37 @@
 <?php
 declare(strict_types=1);
 namespace App\Support\Ai;
 use App\Support\Audit\AuditActionId;
 final readonly class AiExecutionDecision
 {
    /**
     * @param  list<string>  $dataClassifications
     * @param  array<string, mixed>  $auditMetadata
     */
    public function __construct(
        public string $outcome,
        public AiDecisionReasonCode $reasonCode,
        public string $workspaceAiPolicyMode,
        public ?string $matchedOperationalControlScope,
        public string $useCaseKey,
        public string $requestedProviderClass,
        public array $dataClassifications,
        public string $sourceFamily,
        public AuditActionId $auditAction,
        public array $auditMetadata,
    ) {}
    public function isAllowed(): bool
    {
        return $this->outcome === 'allowed';
    }
    public function isBlocked(): bool
    {
        return $this->outcome === 'blocked';
    }
 }
--- a/apps/platform/app/Support/Ai/AiExecutionRequest.php
+++ b/apps/platform/app/Support/Ai/AiExecutionRequest.php
@ -0,0 +1,28 @@
 <?php
 declare(strict_types=1);
 namespace App\Support\Ai;
 use App\Models\PlatformUser;
 use App\Models\Tenant;
 use App\Models\User;
 use App\Models\Workspace;
 final readonly class AiExecutionRequest
 {
    /**
     * @param  list<string>  $dataClassifications
     */
    public function __construct(
        public ?Workspace $workspace,
        public ?Tenant $tenant,
        public User|PlatformUser|null $actor,
        public string $useCaseKey,
        public string $requestedProviderClass,
        public array $dataClassifications,
        public string $sourceFamily,
        public ?string $callerSurface = null,
        public ?string $contextFingerprint = null,
    ) {}
 }
--- a/apps/platform/app/Support/Ai/AiPolicyMode.php
+++ b/apps/platform/app/Support/Ai/AiPolicyMode.php
@ -0,0 +1,43 @@
 <?php
 declare(strict_types=1);
 namespace App\Support\Ai;
 enum AiPolicyMode: string
 {
    case Disabled = 'disabled';
    case PrivateOnly = 'private_only';
    public function label(): string
    {
        return match ($this) {
            self::Disabled => 'Disabled',
            self::PrivateOnly => 'Private only',
        };
    }
    public function summary(): string
    {
        return match ($this) {
            self::Disabled => 'No AI execution is allowed for this workspace.',
            self::PrivateOnly => 'Only approved internal drafts may use private-only AI for approved use cases.',
        };
    }
    /**
     * @return array<string, string>
     */
    public static function optionLabels(): array
    {
        return array_reduce(
            self::cases(),
            static function (array $labels, self $mode): array {
                $labels[$mode->value] = $mode->label();
                return $labels;
            },
            [],
        );
    }
 }
--- a/apps/platform/app/Support/Ai/AiProviderClass.php
+++ b/apps/platform/app/Support/Ai/AiProviderClass.php
@ -0,0 +1,19 @@
 <?php
 declare(strict_types=1);
 namespace App\Support\Ai;
 enum AiProviderClass: string
 {
    case LocalPrivate = 'local_private';
    case ExternalPublic = 'external_public';
    public function label(): string
    {
        return match ($this) {
            self::LocalPrivate => 'Local private',
            self::ExternalPublic => 'External public',
        };
    }
 }
--- a/apps/platform/app/Support/Ai/AiUseCaseCatalog.php
+++ b/apps/platform/app/Support/Ai/AiUseCaseCatalog.php
@ -0,0 +1,126 @@
 <?php
 declare(strict_types=1);
 namespace App\Support\Ai;
 final class AiUseCaseCatalog
 {
    /**
     * @var array<string, array{
     *     key: string,
     *     label: string,
     *     future_consumer: string,
     *     visibility: string,
     *     allowed_provider_classes: list<string>,
     *     allowed_data_classifications: list<string>,
     *     source_family: string,
     *     tenant_context_permitted: bool
     * }>
     */
    private const USE_CASES = [
        'product_knowledge.answer_draft' => [
            'key' => 'product_knowledge.answer_draft',
            'label' => 'Product knowledge answer draft',
            'future_consumer' => 'ContextualHelpResolver',
            'visibility' => 'internal_only_draft',
            'allowed_provider_classes' => [AiProviderClass::LocalPrivate->value],
            'allowed_data_classifications' => [
                AiDataClassification::ProductKnowledge->value,
                AiDataClassification::OperationalMetadata->value,
            ],
            'source_family' => 'product_knowledge',
            'tenant_context_permitted' => false,
        ],
        'support_diagnostics.summary_draft' => [
            'key' => 'support_diagnostics.summary_draft',
            'label' => 'Support diagnostics summary draft',
            'future_consumer' => 'SupportDiagnosticBundleBuilder',
            'visibility' => 'internal_only_draft',
            'allowed_provider_classes' => [AiProviderClass::LocalPrivate->value],
            'allowed_data_classifications' => [AiDataClassification::RedactedSupportSummary->value],
            'source_family' => 'support_diagnostics',
            'tenant_context_permitted' => true,
        ],
    ];
    /**
     * @return list<array{
     *     key: string,
     *     label: string,
     *     future_consumer: string,
     *     visibility: string,
     *     allowed_provider_classes: list<string>,
     *     allowed_data_classifications: list<string>,
     *     source_family: string,
     *     tenant_context_permitted: bool
     * }>
     */
    public function all(): array
    {
        return array_values(self::USE_CASES);
    }
    /**
     * @return array{
     *     key: string,
     *     label: string,
     *     future_consumer: string,
     *     visibility: string,
     *     allowed_provider_classes: list<string>,
     *     allowed_data_classifications: list<string>,
     *     source_family: string,
     *     tenant_context_permitted: bool
     * }|null
     */
    public function find(string $key): ?array
    {
        return self::USE_CASES[$key] ?? null;
    }
    /**
     * @return list<string>
     */
    public function labels(): array
    {
        return array_map(
            static fn (array $definition): string => $definition['label'],
            $this->all(),
        );
    }
    /**
     * @return list<string>
     */
    public function allowedProviderClassLabelsForMode(AiPolicyMode $mode): array
    {
        if ($mode === AiPolicyMode::Disabled) {
            return [];
        }
        $labels = [];
        foreach ($this->all() as $definition) {
            foreach ($definition['allowed_provider_classes'] as $providerClass) {
                $labels[$providerClass] = AiProviderClass::from($providerClass)->label();
            }
        }
        return array_values($labels);
    }
    /**
     * @return list<string>
     */
    public function blockedDataClassificationLabels(): array
    {
        return array_map(
            static fn (AiDataClassification $classification): string => $classification->label(),
            [
                AiDataClassification::PersonalData,
                AiDataClassification::CustomerConfidential,
                AiDataClassification::RawProviderPayload,
            ],
        );
    }
 }
--- a/apps/platform/app/Support/Ai/GovernedAiExecutionBoundary.php
+++ b/apps/platform/app/Support/Ai/GovernedAiExecutionBoundary.php
@ -0,0 +1,181 @@
 <?php
 declare(strict_types=1);
 namespace App\Support\Ai;
 use App\Services\Audit\WorkspaceAuditLogger;
 use App\Services\Settings\SettingsResolver;
 use App\Support\Audit\AuditActionId;
 use App\Support\OperationalControls\OperationalControlEvaluator;
 final class GovernedAiExecutionBoundary
 {
    public function __construct(
        private readonly AiUseCaseCatalog $useCaseCatalog,
        private readonly SettingsResolver $settingsResolver,
        private readonly OperationalControlEvaluator $operationalControls,
        private readonly AiDecisionAuditMetadataFactory $auditMetadataFactory,
        private readonly WorkspaceAuditLogger $workspaceAuditLogger,
    ) {}
    public function evaluate(AiExecutionRequest $request): AiExecutionDecision
    {
        $decision = $this->decisionFor($request);
        $metadata = $this->auditMetadataFactory->make($request, $decision);
        $decision = new AiExecutionDecision(
            outcome: $decision->outcome,
            reasonCode: $decision->reasonCode,
            workspaceAiPolicyMode: $decision->workspaceAiPolicyMode,
            matchedOperationalControlScope: $decision->matchedOperationalControlScope,
            useCaseKey: $decision->useCaseKey,
            requestedProviderClass: $decision->requestedProviderClass,
            dataClassifications: $decision->dataClassifications,
            sourceFamily: $decision->sourceFamily,
            auditAction: $decision->auditAction,
            auditMetadata: $metadata,
        );
        if ($request->workspace !== null) {
            $definition = $this->useCaseCatalog->find($request->useCaseKey);
            $this->workspaceAuditLogger->log(
                workspace: $request->workspace,
                action: $decision->auditAction,
                context: ['metadata' => $decision->auditMetadata],
                actor: $request->actor,
                status: $decision->isAllowed() ? 'success' : 'blocked',
                resourceType: 'ai_use_case',
                resourceId: $request->useCaseKey,
                targetLabel: $definition['label'] ?? $request->useCaseKey,
                summary: 'AI execution decision evaluated',
                tenant: $request->tenant,
            );
        }
        return $decision;
    }
    private function decisionFor(AiExecutionRequest $request): AiExecutionDecision
    {
        if ($request->workspace === null) {
            return $this->blockedDecision(
                request: $request,
                reasonCode: AiDecisionReasonCode::MissingWorkspaceContext,
                workspaceAiPolicyMode: AiPolicyMode::Disabled->value,
            );
        }
        if ($request->tenant !== null && (int) $request->tenant->workspace_id !== (int) $request->workspace->getKey()) {
            return $this->blockedDecision(
                request: $request,
                reasonCode: AiDecisionReasonCode::TenantOutsideWorkspace,
                workspaceAiPolicyMode: AiPolicyMode::Disabled->value,
            );
        }
        $controlDecision = $this->operationalControls->evaluate('ai.execution', $request->workspace);
        if ($controlDecision->isPaused()) {
            return $this->blockedDecision(
                request: $request,
                reasonCode: AiDecisionReasonCode::OperationalControlPaused,
                workspaceAiPolicyMode: $this->resolvedPolicyMode($request),
                matchedOperationalControlScope: $controlDecision->matchedScopeType,
            );
        }
        $policyMode = $this->resolvedPolicyMode($request);
        if ($policyMode === AiPolicyMode::Disabled->value) {
            return $this->blockedDecision(
                request: $request,
                reasonCode: AiDecisionReasonCode::WorkspacePolicyDisabled,
                workspaceAiPolicyMode: $policyMode,
            );
        }
        $definition = $this->useCaseCatalog->find($request->useCaseKey);
        if ($definition === null) {
            return $this->blockedDecision(
                request: $request,
                reasonCode: AiDecisionReasonCode::UnregisteredUseCase,
                workspaceAiPolicyMode: $policyMode,
            );
        }
        if ($definition['source_family'] !== $request->sourceFamily) {
            return $this->blockedDecision(
                request: $request,
                reasonCode: AiDecisionReasonCode::SourceFamilyMismatch,
                workspaceAiPolicyMode: $policyMode,
            );
        }
        if (! in_array($request->requestedProviderClass, $definition['allowed_provider_classes'], true)) {
            return $this->blockedDecision(
                request: $request,
                reasonCode: AiDecisionReasonCode::ProviderClassBlocked,
                workspaceAiPolicyMode: $policyMode,
            );
        }
        foreach ($request->dataClassifications as $classification) {
            if (! in_array($classification, $definition['allowed_data_classifications'], true)) {
                return $this->blockedDecision(
                    request: $request,
                    reasonCode: AiDecisionReasonCode::DataClassificationBlocked,
                    workspaceAiPolicyMode: $policyMode,
                );
            }
        }
        return new AiExecutionDecision(
            outcome: 'allowed',
            reasonCode: AiDecisionReasonCode::Allowed,
            workspaceAiPolicyMode: $policyMode,
            matchedOperationalControlScope: null,
            useCaseKey: $request->useCaseKey,
            requestedProviderClass: $request->requestedProviderClass,
            dataClassifications: $request->dataClassifications,
            sourceFamily: $request->sourceFamily,
            auditAction: AuditActionId::AiExecutionDecisionEvaluated,
            auditMetadata: [],
        );
    }
    private function resolvedPolicyMode(AiExecutionRequest $request): string
    {
        if ($request->workspace === null) {
            return AiPolicyMode::Disabled->value;
        }
        $resolved = $this->settingsResolver->resolveValue($request->workspace, 'ai', 'policy_mode');
        return is_string($resolved) && $resolved !== ''
            ? $resolved
            : AiPolicyMode::Disabled->value;
    }
    private function blockedDecision(
        AiExecutionRequest $request,
        AiDecisionReasonCode $reasonCode,
        string $workspaceAiPolicyMode,
        ?string $matchedOperationalControlScope = null,
    ): AiExecutionDecision {
        return new AiExecutionDecision(
            outcome: 'blocked',
            reasonCode: $reasonCode,
            workspaceAiPolicyMode: $workspaceAiPolicyMode,
            matchedOperationalControlScope: $matchedOperationalControlScope,
            useCaseKey: $request->useCaseKey,
            requestedProviderClass: $request->requestedProviderClass,
            dataClassifications: $request->dataClassifications,
            sourceFamily: $request->sourceFamily,
            auditAction: AuditActionId::AiExecutionDecisionEvaluated,
            auditMetadata: [],
        );
    }
 }
--- a/apps/platform/app/Support/Audit/AuditActionId.php
+++ b/apps/platform/app/Support/Audit/AuditActionId.php
@ -94,12 +94,16 @@ enum AuditActionId: string
    case TenantReviewRefreshed = 'tenant_review.refreshed';
    case TenantReviewPublished = 'tenant_review.published';
    case TenantReviewArchived = 'tenant_review.archived';
    case TenantReviewOpened = 'tenant_review.opened';
    case TenantReviewExported = 'tenant_review.exported';
    case TenantReviewSuccessorCreated = 'tenant_review.successor_created';
    case ReviewPackDownloaded = 'review_pack.downloaded';
    case TenantTriageReviewMarkedReviewed = 'tenant_triage_review.marked_reviewed';
    case TenantTriageReviewMarkedFollowUpNeeded = 'tenant_triage_review.marked_follow_up_needed';
    case SupportDiagnosticsOpened = 'support_diagnostics.opened';
    case SupportRequestCreated = 'support_request.created';
    case AiExecutionDecisionEvaluated = 'ai_execution.decision_evaluated';
    case OperationalControlPaused = 'operational_control.paused';
    case OperationalControlUpdated = 'operational_control.updated';
    case OperationalControlResumed = 'operational_control.resumed';
@ -236,11 +240,15 @@ private static function labels(): array
            self::TenantReviewRefreshed->value => 'Tenant review refreshed',
            self::TenantReviewPublished->value => 'Tenant review published',
            self::TenantReviewArchived->value => 'Tenant review archived',
            self::TenantReviewOpened->value => 'Tenant review opened',
            self::TenantReviewExported->value => 'Tenant review exported',
            self::TenantReviewSuccessorCreated->value => 'Tenant review next cycle created',
            self::ReviewPackDownloaded->value => 'Review pack downloaded',
            self::TenantTriageReviewMarkedReviewed->value => 'Triage review marked reviewed',
            self::TenantTriageReviewMarkedFollowUpNeeded->value => 'Triage review marked follow-up needed',
            self::SupportDiagnosticsOpened->value => 'Support diagnostics opened',
            self::SupportRequestCreated->value => 'Support request created',
            self::AiExecutionDecisionEvaluated->value => 'AI execution decision evaluated',
            self::OperationalControlPaused->value => 'Operational control paused',
            self::OperationalControlUpdated->value => 'Operational control updated',
            self::OperationalControlResumed->value => 'Operational control resumed',
@ -324,9 +332,13 @@ private static function summaries(): array
            self::TenantReviewRefreshed->value => 'Tenant review refreshed',
            self::TenantReviewPublished->value => 'Tenant review published',
            self::TenantReviewArchived->value => 'Tenant review archived',
            self::TenantReviewOpened->value => 'Tenant review opened',
            self::TenantReviewExported->value => 'Tenant review exported',
            self::TenantReviewSuccessorCreated->value => 'Tenant review next cycle created',
            self::ReviewPackDownloaded->value => 'Review pack downloaded',
            self::SupportDiagnosticsOpened->value => 'Support diagnostics opened',
            self::SupportRequestCreated->value => 'Support request created',
            self::AiExecutionDecisionEvaluated->value => 'AI execution decision evaluated',
            self::OperationalControlPaused->value => 'Operational control paused',
            self::OperationalControlUpdated->value => 'Operational control updated',
            self::OperationalControlResumed->value => 'Operational control resumed',
--- a/apps/platform/app/Support/Auth/Capabilities.php
+++ b/apps/platform/app/Support/Auth/Capabilities.php
@ -72,6 +72,9 @@ class Capabilities
    // Support diagnostics
    public const SUPPORT_DIAGNOSTICS_VIEW = 'support_diagnostics.view';
    // Support requests
    public const SUPPORT_REQUESTS_CREATE = 'support_requests.create';
    // Inventory
    public const TENANT_INVENTORY_SYNC_RUN = 'tenant_inventory_sync.run';
@ -88,8 +91,6 @@ class Capabilities
    public const TENANT_FINDINGS_RISK_ACCEPT = 'tenant_findings.risk_accept';
    public const TENANT_FINDINGS_ACKNOWLEDGE = 'tenant_findings.acknowledge';
    public const FINDING_EXCEPTION_VIEW = 'finding_exception.view';
    public const FINDING_EXCEPTION_MANAGE = 'finding_exception.manage';
--- a/apps/platform/app/Support/Auth/PlatformCapabilities.php
+++ b/apps/platform/app/Support/Auth/PlatformCapabilities.php
@ -18,6 +18,8 @@ class PlatformCapabilities
    public const DIRECTORY_VIEW = 'platform.directory.view';
    public const COMMERCIAL_LIFECYCLE_MANAGE = 'platform.commercial_lifecycle.manage';
    public const OPERATIONS_VIEW = 'platform.operations.view';
    public const OPERATIONS_MANAGE = 'platform.operations.manage';
@ -28,8 +30,6 @@ class PlatformCapabilities
    public const RUNBOOKS_RUN = 'platform.runbooks.run';
    public const RUNBOOKS_FINDINGS_LIFECYCLE_BACKFILL = 'platform.runbooks.findings.lifecycle_backfill';
    public const OPS_CONTROLS_MANAGE = 'platform.ops.controls.manage';
    /**
--- a/apps/platform/app/Support/Badges/BadgeCatalog.php
+++ b/apps/platform/app/Support/Badges/BadgeCatalog.php
@ -57,6 +57,7 @@ final class BadgeCatalog
        BadgeDomain::BaselineProfileStatus->value => Domains\BaselineProfileStatusBadge::class,
        BadgeDomain::FindingType->value => Domains\FindingTypeBadge::class,
        BadgeDomain::ReviewPackStatus->value => Domains\ReviewPackStatusBadge::class,
        BadgeDomain::CommercialLifecycleState->value => Domains\CommercialLifecycleStateBadge::class,
        BadgeDomain::EvidenceSnapshotStatus->value => Domains\EvidenceSnapshotStatusBadge::class,
        BadgeDomain::EvidenceCompleteness->value => Domains\EvidenceCompletenessBadge::class,
        BadgeDomain::TenantReviewStatus->value => Domains\TenantReviewStatusBadge::class,
--- a/apps/platform/app/Support/Badges/BadgeDomain.php
+++ b/apps/platform/app/Support/Badges/BadgeDomain.php
@ -48,6 +48,7 @@ enum BadgeDomain: string
    case BaselineProfileStatus = 'baseline_profile_status';
    case FindingType = 'finding_type';
    case ReviewPackStatus = 'review_pack_status';
    case CommercialLifecycleState = 'commercial_lifecycle_state';
    case EvidenceSnapshotStatus = 'evidence_snapshot_status';
    case EvidenceCompleteness = 'evidence_completeness';
    case TenantReviewStatus = 'tenant_review_status';
--- a/apps/platform/app/Support/Badges/Domains/CommercialLifecycleStateBadge.php
+++ b/apps/platform/app/Support/Badges/Domains/CommercialLifecycleStateBadge.php
@ -0,0 +1,26 @@
 <?php
 declare(strict_types=1);
 namespace App\Support\Badges\Domains;
 use App\Services\Entitlements\WorkspaceCommercialLifecycleResolver;
 use App\Support\Badges\BadgeCatalog;
 use App\Support\Badges\BadgeMapper;
 use App\Support\Badges\BadgeSpec;
 final class CommercialLifecycleStateBadge implements BadgeMapper
 {
    public function spec(mixed $value): BadgeSpec
    {
        $state = BadgeCatalog::normalizeState($value);
        return match ($state) {
            WorkspaceCommercialLifecycleResolver::STATE_TRIAL => new BadgeSpec('Trial', 'info', 'heroicon-m-clock'),
            WorkspaceCommercialLifecycleResolver::STATE_GRACE => new BadgeSpec('Grace', 'warning', 'heroicon-m-exclamation-triangle'),
            WorkspaceCommercialLifecycleResolver::STATE_ACTIVE_PAID => new BadgeSpec('Active paid', 'success', 'heroicon-m-check-circle'),
            WorkspaceCommercialLifecycleResolver::STATE_SUSPENDED_READ_ONLY => new BadgeSpec('Suspended / read-only', 'danger', 'heroicon-m-lock-closed'),
            default => BadgeSpec::unknown(),
        };
    }
 }
--- a/apps/platform/app/Support/Baselines/BaselineCompareStats.php
+++ b/apps/platform/app/Support/Baselines/BaselineCompareStats.php
@ -796,7 +796,6 @@ private static function findingAttentionCounts(Tenant $tenant): array
        $activeNonNewFindingsCount = Finding::query()
            ->where('tenant_id', $tenantId)
            ->whereIn('status', [
                Finding::STATUS_ACKNOWLEDGED,
                Finding::STATUS_TRIAGED,
                Finding::STATUS_IN_PROGRESS,
                Finding::STATUS_REOPENED,
--- a/apps/platform/app/Support/Concerns/DerivesWorkspaceIdFromTenant.php
+++ b/apps/platform/app/Support/Concerns/DerivesWorkspaceIdFromTenant.php
@ -99,7 +99,7 @@ private static function resolveTenantWorkspaceId(Model $model, int $tenantId): i
        $tenant = $model->relationLoaded('tenant') ? $model->getRelation('tenant') : null;
        if (! $tenant instanceof Tenant || (int) $tenant->getKey() !== $tenantId) {
-            $tenant = Tenant::query()->find($tenantId);
+            $tenant = Tenant::query()->withTrashed()->find($tenantId);
        }
        if (! $tenant instanceof Tenant) {
--- a/apps/platform/app/Support/CustomerHealth/CustomerHealthDimensionCatalog.php
+++ b/apps/platform/app/Support/CustomerHealth/CustomerHealthDimensionCatalog.php
@ -0,0 +1,112 @@
 <?php
 declare(strict_types=1);
 namespace App\Support\CustomerHealth;
 use InvalidArgumentException;
 final class CustomerHealthDimensionCatalog
 {
    public const string ONBOARDING_READINESS = 'onboarding_readiness';
    public const string PROVIDER_CONNECTION_HEALTH = 'provider_connection_health';
    public const string OPERATIONAL_STABILITY = 'operational_stability';
    public const string GOVERNANCE_PRESSURE = 'governance_pressure';
    public const string REVIEW_PACK_READINESS = 'review_pack_readiness';
    public const string ENGAGEMENT_FRESHNESS = 'engagement_freshness';
    /**
     * @var array<string, array{label: string, windowed: bool}>
     */
    private const DEFINITIONS = [
        self::ONBOARDING_READINESS => [
            'label' => 'Onboarding readiness',
            'windowed' => false,
        ],
        self::PROVIDER_CONNECTION_HEALTH => [
            'label' => 'Provider connection health',
            'windowed' => false,
        ],
        self::OPERATIONAL_STABILITY => [
            'label' => 'Operational stability',
            'windowed' => true,
        ],
        self::GOVERNANCE_PRESSURE => [
            'label' => 'Governance pressure',
            'windowed' => false,
        ],
        self::REVIEW_PACK_READINESS => [
            'label' => 'Review-pack readiness',
            'windowed' => true,
        ],
        self::ENGAGEMENT_FRESHNESS => [
            'label' => 'Engagement freshness',
            'windowed' => true,
        ],
    ];
    /**
     * @return list<string>
     */
    public function names(): array
    {
        return array_keys(self::DEFINITIONS);
    }
    /**
     * @return array{label: string, windowed: bool}
     */
    public function definition(string $dimension): array
    {
        $definition = self::DEFINITIONS[$dimension] ?? null;
        if (! is_array($definition)) {
            throw new InvalidArgumentException("Unknown customer health dimension [{$dimension}].");
        }
        return $definition;
    }
    public function label(string $dimension): string
    {
        return $this->definition($dimension)['label'];
    }
    public function isWindowed(string $dimension): bool
    {
        return $this->definition($dimension)['windowed'];
    }
    /**
     * @return array<string, string>
     */
    public function visibleDimensions(): array
    {
        $dimensions = [];
        foreach ($this->names() as $dimension) {
            $dimensions[$dimension] = $this->label($dimension);
        }
        return $dimensions;
    }
    /**
     * @param  list<string>  $levels
     */
    public function resolveOverallLevel(array $levels): string
    {
        foreach (['critical', 'warn', 'unknown'] as $level) {
            if (in_array($level, $levels, true)) {
                return $level;
            }
        }
        return 'ok';
    }
 }
--- a/apps/platform/app/Support/CustomerHealth/WorkspaceHealthSummaryQuery.php
+++ b/apps/platform/app/Support/CustomerHealth/WorkspaceHealthSummaryQuery.php
@ -0,0 +1,766 @@
 <?php
 declare(strict_types=1);
 namespace App\Support\CustomerHealth;
 use App\Models\Finding;
 use App\Models\FindingException;
 use App\Models\OperationRun;
 use App\Models\PlatformUser;
 use App\Models\ProductUsageEvent;
 use App\Models\ProviderConnection;
 use App\Models\ReviewPack;
 use App\Models\Tenant;
 use App\Models\TenantOnboardingSession;
 use App\Models\Workspace;
 use App\Support\Onboarding\OnboardingLifecycleState;
 use App\Support\OperationRunOutcome;
 use App\Support\OperationRunStatus;
 use App\Support\Auth\PlatformCapabilities;
 use App\Support\ProductTelemetry\ProductUsageEventCatalog;
 use App\Support\Providers\ProviderConsentStatus;
 use App\Support\Providers\ProviderVerificationStatus;
 use App\Support\System\SystemDirectoryLinks;
 use App\Support\System\SystemOperationRunLinks;
 use App\Support\SystemConsole\StuckRunClassifier;
 use App\Support\SystemConsole\SystemConsoleWindow;
 use Carbon\CarbonImmutable;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Support\Collection;
 final class WorkspaceHealthSummaryQuery
 {
    public function __construct(
        private readonly CustomerHealthDimensionCatalog $dimensionCatalog,
        private readonly StuckRunClassifier $stuckRunClassifier,
    ) {}
    /**
     * @return Collection<int, array{
     *     workspace_id: int,
     *     workspace_name: string,
     *     overall_level: string,
     *     dimensions: array<string, array{label: string, level: string, windowed: bool}>,
     *     dominant_dimension_keys: list<string>,
     *     non_ok_dimension_count: int,
     *     next_link: array{label: string, url: string}
     * }>
     */
    public function summaries(SystemConsoleWindow|string|null $window = null, ?CarbonImmutable $now = null): Collection
    {
        $resolvedWindow = $this->resolveWindow($window);
        $now ??= CarbonImmutable::now();
        $startAt = $resolvedWindow->startAt($now);
        $workspaces = Workspace::query()
            ->whereNull('archived_at')
            ->orderBy('name')
            ->orderBy('id')
            ->get(['id', 'name']);
        if ($workspaces->isEmpty()) {
            return collect();
        }
        $workspaceIds = $workspaces
            ->pluck('id')
            ->map(static fn (mixed $workspaceId): int => (int) $workspaceId)
            ->all();
        $activeTenants = Tenant::query()
            ->whereIn('workspace_id', $workspaceIds)
            ->whereNull('deleted_at')
            ->where('status', '!=', Tenant::STATUS_ARCHIVED)
            ->orderBy('name')
            ->orderBy('id')
            ->get(['id', 'workspace_id', 'external_id', 'name', 'status']);
        $tenantsByWorkspace = $activeTenants->groupBy(static fn (Tenant $tenant): int => (int) $tenant->workspace_id);
        $latestOnboardingSessions = TenantOnboardingSession::query()
            ->whereIn('workspace_id', $workspaceIds)
            ->where(function (Builder $query): void {
                $this->constrainToActiveTenantTruth($query);
            })
            ->orderByDesc('updated_at')
            ->orderByDesc('id')
            ->get(['id', 'workspace_id', 'tenant_id', 'lifecycle_state', 'updated_at', 'created_at'])
            ->groupBy(static fn (TenantOnboardingSession $session): int => (int) $session->workspace_id)
            ->map(static fn (Collection $sessions): ?TenantOnboardingSession => $sessions->first());
        $providerConnectionsByWorkspace = ProviderConnection::query()
            ->whereIn('workspace_id', $workspaceIds)
            ->where('is_default', true)
            ->where(function (Builder $query): void {
                $this->constrainToActiveTenantTruth($query);
            })
            ->orderByDesc('is_enabled')
            ->orderBy('id')
            ->get([
                'id',
                'workspace_id',
                'tenant_id',
                'is_enabled',
                'consent_status',
                'verification_status',
            ])
            ->groupBy(static fn (ProviderConnection $connection): int => (int) $connection->workspace_id);
        $recentRunCounts = $this->groupedCounts(
            OperationRun::query()
                ->whereIn('workspace_id', $workspaceIds)
                ->where('created_at', '>=', $startAt)
                ->where(function (Builder $query): void {
                    $this->constrainToActiveTenantTruth($query);
                })
        );
        $recentFailedRunCounts = $this->groupedCounts(
            OperationRun::query()
                ->whereIn('workspace_id', $workspaceIds)
                ->where('created_at', '>=', $startAt)
                ->where('status', OperationRunStatus::Completed->value)
                ->where('outcome', OperationRunOutcome::Failed->value)
                ->where(function (Builder $query): void {
                    $this->constrainToActiveTenantTruth($query);
                })
        );
        $recentStuckRunCounts = $this->groupedCounts(
            $this->stuckRunClassifier->apply(
                OperationRun::query()
                    ->whereIn('workspace_id', $workspaceIds)
                    ->where('created_at', '>=', $startAt)
                    ->where(function (Builder $query): void {
                        $this->constrainToActiveTenantTruth($query);
                    }),
                $now,
            )
        );
        $activeHighSeverityFindingCounts = $this->groupedCounts(
            Finding::query()
                ->whereIn('workspace_id', $workspaceIds)
                ->whereIn('severity', Finding::highSeverityValues())
                ->whereIn('status', Finding::openStatusesForQuery())
                ->where(function (Builder $query): void {
                    $this->constrainToActiveTenantTruth($query);
                })
        );
        $anyGovernanceFindingCounts = $this->groupedCounts(
            Finding::query()
                ->whereIn('workspace_id', $workspaceIds)
                ->where(function (Builder $query): void {
                    $this->constrainToActiveTenantTruth($query);
                })
        );
        $overdueHighSeverityFindingCounts = $this->groupedCounts(
            Finding::query()
                ->whereIn('workspace_id', $workspaceIds)
                ->whereIn('severity', Finding::highSeverityValues())
                ->whereIn('status', Finding::openStatusesForQuery())
                ->whereNotNull('due_at')
                ->where('due_at', '<', $now)
                ->where(function (Builder $query): void {
                    $this->constrainToActiveTenantTruth($query);
                })
        );
        $warningExceptionCounts = $this->groupedCounts(
            FindingException::query()
                ->whereIn('workspace_id', $workspaceIds)
                ->where(function (Builder $query): void {
                    $query
                        ->whereIn('status', [
                            FindingException::STATUS_PENDING,
                            FindingException::STATUS_EXPIRING,
                        ])
                        ->orWhere('current_validity_state', FindingException::VALIDITY_EXPIRING);
                })
                ->where(function (Builder $query): void {
                    $this->constrainToActiveTenantTruth($query);
                })
        );
        $criticalExceptionCounts = $this->groupedCounts(
            FindingException::query()
                ->whereIn('workspace_id', $workspaceIds)
                ->where(function (Builder $query): void {
                    $query
                        ->whereIn('status', [
                            FindingException::STATUS_EXPIRED,
                            FindingException::STATUS_REVOKED,
                        ])
                        ->orWhereIn('current_validity_state', [
                            FindingException::VALIDITY_EXPIRED,
                            FindingException::VALIDITY_REVOKED,
                            FindingException::VALIDITY_REJECTED,
                            FindingException::VALIDITY_MISSING_SUPPORT,
                        ]);
                })
                ->where(function (Builder $query): void {
                    $this->constrainToActiveTenantTruth($query);
                })
        );
        $reviewPackRequestCounts = $this->groupedCounts(
            ProductUsageEvent::query()
                ->whereIn('workspace_id', $workspaceIds)
                ->where('event_name', ProductUsageEventCatalog::REVIEW_PACK_REQUESTED)
                ->where('occurred_at', '>=', $startAt)
                ->where(function (Builder $query): void {
                    $this->constrainToActiveTenantTruth($query);
                })
        );
        $recentReviewPacks = ReviewPack::query()
            ->whereIn('workspace_id', $workspaceIds)
            ->where('created_at', '>=', $startAt)
            ->where(function (Builder $query): void {
                $this->constrainToActiveTenantTruth($query);
            })
            ->orderByDesc('created_at')
            ->orderByDesc('id')
            ->get(['id', 'workspace_id', 'tenant_id', 'status', 'expires_at', 'created_at'])
            ->groupBy(static fn (ReviewPack $reviewPack): int => (int) $reviewPack->workspace_id)
            ->map(static fn (Collection $reviewPacks): ?ReviewPack => $reviewPacks->first());
        $recentUsageEventCounts = $this->groupedCounts(
            ProductUsageEvent::query()
                ->whereIn('workspace_id', $workspaceIds)
                ->where('occurred_at', '>=', $startAt)
                ->where(function (Builder $query): void {
                    $this->constrainToActiveTenantTruth($query);
                })
        );
        $historicalUsageEventCounts = $this->groupedCounts(
            ProductUsageEvent::query()
                ->whereIn('workspace_id', $workspaceIds)
                ->where(function (Builder $query): void {
                    $this->constrainToActiveTenantTruth($query);
                })
        );
        return $workspaces
            ->map(function (Workspace $workspace) use (
                $tenantsByWorkspace,
                $latestOnboardingSessions,
                $providerConnectionsByWorkspace,
                $recentRunCounts,
                $recentFailedRunCounts,
                $recentStuckRunCounts,
                $activeHighSeverityFindingCounts,
                $anyGovernanceFindingCounts,
                $overdueHighSeverityFindingCounts,
                $warningExceptionCounts,
                $criticalExceptionCounts,
                $reviewPackRequestCounts,
                $recentReviewPacks,
                $recentUsageEventCounts,
                $historicalUsageEventCounts,
                $resolvedWindow,
                $now,
            ): array {
                $workspaceId = (int) $workspace->getKey();
                /** @var Collection<int, Tenant> $workspaceTenants */
                $workspaceTenants = $tenantsByWorkspace->get($workspaceId, collect());
                /** @var TenantOnboardingSession|null $latestOnboardingSession */
                $latestOnboardingSession = $latestOnboardingSessions->get($workspaceId);
                /** @var Collection<int, ProviderConnection> $providerConnections */
                $providerConnections = $providerConnectionsByWorkspace->get($workspaceId, collect());
                /** @var ReviewPack|null $latestReviewPack */
                $latestReviewPack = $recentReviewPacks->get($workspaceId);
                $dimensions = $this->buildDimensions(
                    tenants: $workspaceTenants,
                    latestOnboardingSession: $latestOnboardingSession,
                    providerConnections: $providerConnections,
                    recentRunCount: $this->countForWorkspace($recentRunCounts, $workspaceId),
                    recentFailedRunCount: $this->countForWorkspace($recentFailedRunCounts, $workspaceId),
                    recentStuckRunCount: $this->countForWorkspace($recentStuckRunCounts, $workspaceId),
                    activeHighSeverityFindingCount: $this->countForWorkspace($activeHighSeverityFindingCounts, $workspaceId),
                    anyGovernanceFindingCount: $this->countForWorkspace($anyGovernanceFindingCounts, $workspaceId),
                    overdueHighSeverityFindingCount: $this->countForWorkspace($overdueHighSeverityFindingCounts, $workspaceId),
                    warningExceptionCount: $this->countForWorkspace($warningExceptionCounts, $workspaceId),
                    criticalExceptionCount: $this->countForWorkspace($criticalExceptionCounts, $workspaceId),
                    reviewPackRequestCount: $this->countForWorkspace($reviewPackRequestCounts, $workspaceId),
                    latestReviewPack: $latestReviewPack,
                    recentUsageEventCount: $this->countForWorkspace($recentUsageEventCounts, $workspaceId),
                    historicalUsageEventCount: $this->countForWorkspace($historicalUsageEventCounts, $workspaceId),
                    now: $now,
                );
                $overallLevel = $this->dimensionCatalog->resolveOverallLevel(
                    array_map(static fn (array $dimension): string => $dimension['level'], $dimensions),
                );
                $dominantDimensionKeys = $this->dominantDimensionKeys($dimensions);
                return [
                    'workspace_id' => $workspaceId,
                    'workspace_name' => (string) $workspace->name,
                    'overall_level' => $overallLevel,
                    'dimensions' => $dimensions,
                    'dominant_dimension_keys' => $dominantDimensionKeys,
                    'non_ok_dimension_count' => count(array_filter(
                        $dimensions,
                        static fn (array $dimension): bool => $dimension['level'] !== 'ok',
                    )),
                    'next_link' => $this->nextLink(
                        workspace: $workspace,
                        tenants: $workspaceTenants,
                        dominantDimensionKeys: $dominantDimensionKeys,
                        window: $resolvedWindow,
                    ),
                ];
            })
            ->values();
    }
    /**
     * @return array{
     *     workspace_id: int,
     *     workspace_name: string,
     *     overall_level: string,
     *     dimensions: array<string, array{label: string, level: string, windowed: bool}>,
     *     dominant_dimension_keys: list<string>,
     *     non_ok_dimension_count: int,
     *     next_link: array{label: string, url: string}
     * }|null
     */
    public function summaryForWorkspace(Workspace|int $workspace, SystemConsoleWindow|string|null $window = null, ?CarbonImmutable $now = null): ?array
    {
        $workspaceId = $workspace instanceof Workspace ? (int) $workspace->getKey() : (int) $workspace;
        /** @var array{
         *     workspace_id: int,
         *     workspace_name: string,
         *     overall_level: string,
         *     dimensions: array<string, array{label: string, level: string, windowed: bool}>,
         *     dominant_dimension_keys: list<string>,
         *     non_ok_dimension_count: int,
         *     next_link: array{label: string, url: string}
         * }|null $summary
         */
        $summary = $this->summaries($window, $now)->firstWhere('workspace_id', $workspaceId);
        return $summary;
    }
    /**
     * @return array{ok: int, warn: int, critical: int, unknown: int}
     */
    public function healthCounts(SystemConsoleWindow|string|null $window = null, ?CarbonImmutable $now = null): array
    {
        $counts = [
            'ok' => 0,
            'warn' => 0,
            'critical' => 0,
            'unknown' => 0,
        ];
        foreach ($this->summaries($window, $now) as $summary) {
            $counts[$summary['overall_level']]++;
        }
        return $counts;
    }
    /**
     * @return Collection<int, array{
     *     workspace_id: int,
     *     workspace_name: string,
     *     overall_level: string,
     *     dimensions: array<string, array{label: string, level: string, windowed: bool}>,
     *     dominant_dimension_keys: list<string>,
     *     non_ok_dimension_count: int,
     *     next_link: array{label: string, url: string}
     * }>
     */
    public function attentionNeeded(SystemConsoleWindow|string|null $window = null, int $limit = 10, ?CarbonImmutable $now = null): Collection
    {
        return $this->summaries($window, $now)
            ->filter(static fn (array $summary): bool => $summary['overall_level'] !== 'ok')
            ->sort(function (array $left, array $right): int {
                $severityComparison = $this->levelRank($right['overall_level']) <=> $this->levelRank($left['overall_level']);
                if ($severityComparison !== 0) {
                    return $severityComparison;
                }
                $nonOkComparison = $right['non_ok_dimension_count'] <=> $left['non_ok_dimension_count'];
                if ($nonOkComparison !== 0) {
                    return $nonOkComparison;
                }
                $nameComparison = strcasecmp($left['workspace_name'], $right['workspace_name']);
                if ($nameComparison !== 0) {
                    return $nameComparison;
                }
                return $left['workspace_id'] <=> $right['workspace_id'];
            })
            ->values()
            ->take(max(1, $limit));
    }
    private function resolveWindow(SystemConsoleWindow|string|null $window): SystemConsoleWindow
    {
        if ($window instanceof SystemConsoleWindow) {
            return $window;
        }
        return SystemConsoleWindow::fromNullable(is_string($window) ? $window : null);
    }
    /**
     * @param  Collection<int, Tenant>  $tenants
     * @param  Collection<int, ProviderConnection>  $providerConnections
     * @return array<string, array{label: string, level: string, windowed: bool}>
     */
    private function buildDimensions(
        Collection $tenants,
        ?TenantOnboardingSession $latestOnboardingSession,
        Collection $providerConnections,
        int $recentRunCount,
        int $recentFailedRunCount,
        int $recentStuckRunCount,
        int $activeHighSeverityFindingCount,
        int $anyGovernanceFindingCount,
        int $overdueHighSeverityFindingCount,
        int $warningExceptionCount,
        int $criticalExceptionCount,
        int $reviewPackRequestCount,
        ?ReviewPack $latestReviewPack,
        int $recentUsageEventCount,
        int $historicalUsageEventCount,
        CarbonImmutable $now,
    ): array {
        $levels = [
            CustomerHealthDimensionCatalog::ONBOARDING_READINESS => $this->onboardingReadinessLevel($tenants, $latestOnboardingSession),
            CustomerHealthDimensionCatalog::PROVIDER_CONNECTION_HEALTH => $this->providerConnectionHealthLevel($providerConnections),
            CustomerHealthDimensionCatalog::OPERATIONAL_STABILITY => $this->operationalStabilityLevel($recentRunCount, $recentFailedRunCount, $recentStuckRunCount),
            CustomerHealthDimensionCatalog::GOVERNANCE_PRESSURE => $this->governancePressureLevel(
                activeHighSeverityFindingCount: $activeHighSeverityFindingCount,
                anyGovernanceFindingCount: $anyGovernanceFindingCount,
                overdueHighSeverityFindingCount: $overdueHighSeverityFindingCount,
                warningExceptionCount: $warningExceptionCount,
                criticalExceptionCount: $criticalExceptionCount,
            ),
            CustomerHealthDimensionCatalog::REVIEW_PACK_READINESS => $this->reviewPackReadinessLevel($reviewPackRequestCount, $latestReviewPack, $now),
            CustomerHealthDimensionCatalog::ENGAGEMENT_FRESHNESS => $this->engagementFreshnessLevel($recentUsageEventCount, $historicalUsageEventCount),
        ];
        $dimensions = [];
        foreach ($this->dimensionCatalog->visibleDimensions() as $dimensionKey => $label) {
            $dimensions[$dimensionKey] = [
                'label' => $label,
                'level' => $levels[$dimensionKey],
                'windowed' => $this->dimensionCatalog->isWindowed($dimensionKey),
            ];
        }
        return $dimensions;
    }
    /**
     * @param  Collection<int, Tenant>  $tenants
     */
    private function onboardingReadinessLevel(Collection $tenants, ?TenantOnboardingSession $latestOnboardingSession): string
    {
        if ($latestOnboardingSession instanceof TenantOnboardingSession) {
            return match ($latestOnboardingSession->lifecycleState()) {
                OnboardingLifecycleState::ReadyForActivation,
                OnboardingLifecycleState::Completed => 'ok',
                OnboardingLifecycleState::Cancelled => 'critical',
                OnboardingLifecycleState::Draft,
                OnboardingLifecycleState::Verifying,
                OnboardingLifecycleState::ActionRequired,
                OnboardingLifecycleState::Bootstrapping => 'warn',
            };
        }
        if ($tenants->isEmpty()) {
            return 'unknown';
        }
        if ($tenants->contains(static fn (Tenant $tenant): bool => (string) $tenant->status === Tenant::STATUS_ACTIVE)) {
            return 'ok';
        }
        return 'warn';
    }
    /**
     * @param  Collection<int, ProviderConnection>  $providerConnections
     */
    private function providerConnectionHealthLevel(Collection $providerConnections): string
    {
        if ($providerConnections->isEmpty()) {
            return 'unknown';
        }
        if ($providerConnections->contains(function (ProviderConnection $connection): bool {
            if (! $connection->is_enabled) {
                return false;
            }
            $consentStatus = $this->normalizeBackedEnumValue($connection->consent_status);
            $verificationStatus = $this->normalizeBackedEnumValue($connection->verification_status);
            return in_array($consentStatus, [
                ProviderConsentStatus::Required->value,
                ProviderConsentStatus::Failed->value,
                ProviderConsentStatus::Revoked->value,
            ], true) || in_array($verificationStatus, [
                ProviderVerificationStatus::Blocked->value,
                ProviderVerificationStatus::Error->value,
            ], true);
        })) {
            return 'critical';
        }
        if ($providerConnections->contains(function (ProviderConnection $connection): bool {
            if (! $connection->is_enabled) {
                return true;
            }
            $consentStatus = $this->normalizeBackedEnumValue($connection->consent_status);
            $verificationStatus = $this->normalizeBackedEnumValue($connection->verification_status);
            return in_array($consentStatus, [
                ProviderConsentStatus::Unknown->value,
            ], true) || in_array($verificationStatus, [
                ProviderVerificationStatus::Unknown->value,
                ProviderVerificationStatus::Pending->value,
                ProviderVerificationStatus::Degraded->value,
            ], true);
        })) {
            return 'warn';
        }
        if ($providerConnections->contains(function (ProviderConnection $connection): bool {
            return $connection->is_enabled
                && $this->normalizeBackedEnumValue($connection->consent_status) === ProviderConsentStatus::Granted->value
                && $this->normalizeBackedEnumValue($connection->verification_status) === ProviderVerificationStatus::Healthy->value;
        })) {
            return 'ok';
        }
        return 'unknown';
    }
    private function operationalStabilityLevel(int $recentRunCount, int $recentFailedRunCount, int $recentStuckRunCount): string
    {
        if ($recentFailedRunCount > 0 || $recentStuckRunCount > 0) {
            return 'critical';
        }
        if ($recentRunCount > 0) {
            return 'ok';
        }
        return 'unknown';
    }
    private function governancePressureLevel(
        int $activeHighSeverityFindingCount,
        int $anyGovernanceFindingCount,
        int $overdueHighSeverityFindingCount,
        int $warningExceptionCount,
        int $criticalExceptionCount,
    ): string {
        if ($overdueHighSeverityFindingCount > 0 || $criticalExceptionCount > 0) {
            return 'critical';
        }
        if ($activeHighSeverityFindingCount > 0 || $warningExceptionCount > 0) {
            return 'warn';
        }
        if ($anyGovernanceFindingCount === 0 && $warningExceptionCount === 0 && $criticalExceptionCount === 0) {
            return 'unknown';
        }
        return 'ok';
    }
    private function reviewPackReadinessLevel(int $reviewPackRequestCount, ?ReviewPack $latestReviewPack, CarbonImmutable $now): string
    {
        if ($reviewPackRequestCount === 0 && ! $latestReviewPack instanceof ReviewPack) {
            return 'unknown';
        }
        if (! $latestReviewPack instanceof ReviewPack) {
            return 'warn';
        }
        if (
            (string) $latestReviewPack->status === ReviewPack::STATUS_READY
            && (! $latestReviewPack->expires_at instanceof CarbonImmutable || $latestReviewPack->expires_at->gt($now))
        ) {
            return 'ok';
        }
        if (
            in_array((string) $latestReviewPack->status, [
                ReviewPack::STATUS_FAILED,
                ReviewPack::STATUS_EXPIRED,
            ], true)
            || ($latestReviewPack->expires_at !== null && $latestReviewPack->expires_at->lte($now))
        ) {
            return 'critical';
        }
        return 'warn';
    }
    private function engagementFreshnessLevel(int $recentUsageEventCount, int $historicalUsageEventCount): string
    {
        if ($recentUsageEventCount > 0) {
            return 'ok';
        }
        if ($historicalUsageEventCount > 0) {
            return 'warn';
        }
        return 'unknown';
    }
    /**
     * @param  array<string, array{label: string, level: string, windowed: bool}>  $dimensions
     * @return list<string>
     */
    private function dominantDimensionKeys(array $dimensions): array
    {
        $catalogOrder = array_flip($this->dimensionCatalog->names());
        return collect($dimensions)
            ->reject(static fn (array $dimension): bool => $dimension['level'] === 'ok')
            ->keys()
            ->sort(function (string $left, string $right) use ($dimensions, $catalogOrder): int {
                $severityComparison = $this->levelRank($dimensions[$right]['level']) <=> $this->levelRank($dimensions[$left]['level']);
                if ($severityComparison !== 0) {
                    return $severityComparison;
                }
                return ($catalogOrder[$left] ?? PHP_INT_MAX) <=> ($catalogOrder[$right] ?? PHP_INT_MAX);
            })
            ->values()
            ->all();
    }
    /**
     * @param  Collection<int, Tenant>  $tenants
     * @param  list<string>  $dominantDimensionKeys
     * @return array{label: string, url: string}
     */
    private function nextLink(Workspace $workspace, Collection $tenants, array $dominantDimensionKeys, SystemConsoleWindow $window): array
    {
        $dominantDimension = $dominantDimensionKeys[0] ?? null;
        if ($dominantDimension === CustomerHealthDimensionCatalog::OPERATIONAL_STABILITY && $this->canOpenRunsLink()) {
            return [
                'label' => 'Open runs',
                'url' => SystemOperationRunLinks::index(),
            ];
        }
        /** @var Tenant|null $tenant */
        $tenant = $tenants->first();
        if ($tenant instanceof Tenant) {
            return [
                'label' => 'Review health details',
                'url' => $this->withWindowQuery(SystemDirectoryLinks::tenantDetail($tenant), $window),
            ];
        }
        return [
            'label' => 'Review health details',
            'url' => $this->withWindowQuery(SystemDirectoryLinks::workspaceDetail($workspace), $window),
        ];
    }
    private function withWindowQuery(string $url, SystemConsoleWindow $window): string
    {
        $separator = str_contains($url, '?') ? '&' : '?';
        return $url.$separator.http_build_query(['window' => $window->value]);
    }
    private function canOpenRunsLink(): bool
    {
        $user = auth('platform')->user();
        if (! $user instanceof PlatformUser) {
            return false;
        }
        return $user->hasCapability(PlatformCapabilities::OPERATIONS_VIEW)
            || ($user->hasCapability(PlatformCapabilities::OPS_VIEW) && $user->hasCapability(PlatformCapabilities::RUNBOOKS_VIEW));
    }
    /**
     * @param  Builder<OperationRun>|Builder<ProductUsageEvent>|Builder<ReviewPack>|Builder<Finding>|Builder<FindingException>  $query
     * @return array<int, int>
     */
    private function groupedCounts(Builder $query): array
    {
        return $query
            ->selectRaw('workspace_id, COUNT(*) as aggregate')
            ->groupBy('workspace_id')
            ->pluck('aggregate', 'workspace_id')
            ->mapWithKeys(static fn (mixed $count, mixed $workspaceId): array => [
                (int) $workspaceId => (int) $count,
            ])
            ->all();
    }
    /**
     * @param  array<int, int>  $counts
     */
    private function countForWorkspace(array $counts, int $workspaceId): int
    {
        return (int) ($counts[$workspaceId] ?? 0);
    }
    private function levelRank(string $level): int
    {
        return match ($level) {
            'critical' => 4,
            'warn' => 3,
            'unknown' => 2,
            default => 1,
        };
    }
    private function normalizeBackedEnumValue(mixed $value): string
    {
        if (is_object($value) && property_exists($value, 'value')) {
            return (string) $value->value;
        }
        return (string) $value;
    }
    private function constrainToActiveTenantTruth(Builder $query): void
    {
        $query
            ->whereNull('tenant_id')
            ->orWhereHas('tenant', function (Builder $tenantQuery): void {
                $tenantQuery
                    ->whereNull('deleted_at')
                    ->where('status', '!=', Tenant::STATUS_ARCHIVED);
            });
    }
 }
--- a/apps/platform/app/Support/Filament/FilterOptionCatalog.php
+++ b/apps/platform/app/Support/Filament/FilterOptionCatalog.php
@ -103,9 +103,9 @@ public static function baselineProfileStatuses(): array
    /**
     * @return array<string, string>
     */
-    public static function findingStatuses(bool $includeLegacyAcknowledged = true): array
+    public static function findingStatuses(): array
    {
-        $options = self::badgeOptions(BadgeDomain::FindingStatus, [
+        return self::badgeOptions(BadgeDomain::FindingStatus, [
            Finding::STATUS_NEW,
            Finding::STATUS_TRIAGED,
            Finding::STATUS_IN_PROGRESS,
@ -114,21 +114,6 @@ public static function findingStatuses(bool $includeLegacyAcknowledged = true):
            Finding::STATUS_CLOSED,
            Finding::STATUS_RISK_ACCEPTED,
        ]);
        if (! $includeLegacyAcknowledged) {
            return $options;
        }
        return [
            Finding::STATUS_NEW => $options[Finding::STATUS_NEW],
            Finding::STATUS_TRIAGED => $options[Finding::STATUS_TRIAGED],
            Finding::STATUS_ACKNOWLEDGED => self::legacyFindingAcknowledgedLabel(),
            Finding::STATUS_IN_PROGRESS => $options[Finding::STATUS_IN_PROGRESS],
            Finding::STATUS_REOPENED => $options[Finding::STATUS_REOPENED],
            Finding::STATUS_RESOLVED => $options[Finding::STATUS_RESOLVED],
            Finding::STATUS_CLOSED => $options[Finding::STATUS_CLOSED],
            Finding::STATUS_RISK_ACCEPTED => $options[Finding::STATUS_RISK_ACCEPTED],
        ];
    }
    /**
@ -312,11 +297,6 @@ private static function badgeOptions(BadgeDomain $domain, array $values): array
            ->all();
    }
    private static function legacyFindingAcknowledgedLabel(): string
    {
        return BadgeCatalog::spec(BadgeDomain::FindingStatus, Finding::STATUS_ACKNOWLEDGED)->label.' (legacy acknowledged)';
    }
    private static function platformLabel(string $platform): string
    {
        return match (Str::of($platform)
--- a/apps/platform/app/Support/GovernanceInbox/GovernanceInboxSectionBuilder.php
+++ b/apps/platform/app/Support/GovernanceInbox/GovernanceInboxSectionBuilder.php
@ -0,0 +1,888 @@
 <?php
 declare(strict_types=1);
 namespace App\Support\GovernanceInbox;
 use App\Filament\Pages\Findings\FindingsIntakeQueue;
 use App\Filament\Pages\Findings\MyFindingsInbox;
 use App\Filament\Pages\Reviews\CustomerReviewWorkspace;
 use App\Filament\Resources\AlertDeliveryResource;
 use App\Filament\Resources\FindingExceptionResource;
 use App\Filament\Resources\FindingResource;
 use App\Filament\Resources\TenantResource;
 use App\Filament\Resources\TenantReviewResource;
 use App\Models\AlertDelivery;
 use App\Models\Finding;
 use App\Models\OperationRun;
 use App\Models\Tenant;
 use App\Models\TenantTriageReview;
 use App\Models\User;
 use App\Models\Workspace;
 use App\Services\TenantReviews\TenantReviewRegisterService;
 use App\Support\Auth\Capabilities;
 use App\Support\BackupHealth\TenantBackupHealthAssessment;
 use App\Support\BackupHealth\TenantBackupHealthResolver;
 use App\Support\Navigation\CanonicalNavigationContext;
 use App\Support\OperationRunLinks;
 use App\Support\PortfolioTriage\PortfolioArrivalContextToken;
 use App\Support\PortfolioTriage\TenantTriageReviewStateResolver;
 use App\Support\RestoreSafety\RestoreSafetyResolver;
 use App\Support\Tenants\TenantRecoveryTriagePresentation;
 use Illuminate\Support\Str;
 final readonly class GovernanceInboxSectionBuilder
 {
    private const PREVIEW_LIMIT = 3;
    /**
     * @var list<string>
     */
    private const FAMILY_ORDER = [
        'assigned_findings',
        'intake_findings',
        'stale_operations',
        'alert_delivery_failures',
        'review_follow_up',
    ];
    public function __construct(
        private TenantBackupHealthResolver $backupHealthResolver,
        private RestoreSafetyResolver $restoreSafetyResolver,
        private TenantTriageReviewStateResolver $tenantTriageReviewStateResolver,
        private TenantReviewRegisterService $tenantReviewRegisterService,
    ) {}
    /**
     * @param  array<int, Tenant>  $authorizedTenants
     * @param  array<int, Tenant>  $visibleFindingTenants
     * @param  array<int, Tenant>  $reviewTenants
     * @return array{
     *     sections: list<array<string, mixed>>,
     *     available_families: list<array{key: string, label: string, count: int}>,
     *     family_counts: array<string, int>,
     *     total_count: int,
     * }
     */
    public function build(
        User $user,
        Workspace $workspace,
        array $authorizedTenants,
        array $visibleFindingTenants,
        array $reviewTenants,
        bool $canViewAlerts,
        ?Tenant $selectedTenant = null,
        ?string $selectedFamily = null,
        ?CanonicalNavigationContext $navigationContext = null,
    ): array {
        $authorizedTenantsById = $this->indexTenants($authorizedTenants);
        $visibleFindingTenantsById = $this->indexTenants($visibleFindingTenants);
        $reviewTenantsById = $this->indexTenants($reviewTenants);
        $allSections = [];
        $availableFamilies = [];
        $familyCounts = [];
        if ($visibleFindingTenantsById !== []) {
            $assignedSection = $this->assignedFindingsSection(
                user: $user,
                visibleFindingTenants: $visibleFindingTenantsById,
                selectedTenant: $selectedTenant,
                navigationContext: $navigationContext,
            );
            $allSections[$assignedSection['key']] = $assignedSection;
            $availableFamilies[] = [
                'key' => $assignedSection['key'],
                'label' => $assignedSection['label'],
                'count' => $assignedSection['count'],
            ];
            $familyCounts[$assignedSection['key']] = $assignedSection['count'];
            $intakeSection = $this->intakeFindingsSection(
                visibleFindingTenants: $visibleFindingTenantsById,
                selectedTenant: $selectedTenant,
                navigationContext: $navigationContext,
            );
            $allSections[$intakeSection['key']] = $intakeSection;
            $availableFamilies[] = [
                'key' => $intakeSection['key'],
                'label' => $intakeSection['label'],
                'count' => $intakeSection['count'],
            ];
            $familyCounts[$intakeSection['key']] = $intakeSection['count'];
        }
        if ($authorizedTenantsById !== []) {
            $operationsSection = $this->operationsSection(
                workspace: $workspace,
                authorizedTenants: $authorizedTenantsById,
                selectedTenant: $selectedTenant,
                navigationContext: $navigationContext,
            );
            $allSections[$operationsSection['key']] = $operationsSection;
            $availableFamilies[] = [
                'key' => $operationsSection['key'],
                'label' => $operationsSection['label'],
                'count' => $operationsSection['count'],
            ];
            $familyCounts[$operationsSection['key']] = $operationsSection['count'];
        }
        if ($canViewAlerts) {
            $alertsSection = $this->alertsSection(
                workspace: $workspace,
                authorizedTenants: $authorizedTenantsById,
                selectedTenant: $selectedTenant,
                navigationContext: $navigationContext,
            );
            $allSections[$alertsSection['key']] = $alertsSection;
            $availableFamilies[] = [
                'key' => $alertsSection['key'],
                'label' => $alertsSection['label'],
                'count' => $alertsSection['count'],
            ];
            $familyCounts[$alertsSection['key']] = $alertsSection['count'];
        }
        if ($reviewTenantsById !== []) {
            $reviewSection = $this->reviewFollowUpSection(
                user: $user,
                workspace: $workspace,
                reviewTenants: $reviewTenantsById,
                selectedTenant: $selectedTenant,
                navigationContext: $navigationContext,
            );
            $allSections[$reviewSection['key']] = $reviewSection;
            $availableFamilies[] = [
                'key' => $reviewSection['key'],
                'label' => $reviewSection['label'],
                'count' => $reviewSection['count'],
            ];
            $familyCounts[$reviewSection['key']] = $reviewSection['count'];
        }
        $sections = [];
        foreach (self::FAMILY_ORDER as $familyKey) {
            $section = $allSections[$familyKey] ?? null;
            if (! is_array($section)) {
                continue;
            }
            if ($selectedFamily !== null) {
                if ($familyKey === $selectedFamily) {
                    $sections[] = $section;
                }
                continue;
            }
            if ((int) ($section['count'] ?? 0) > 0) {
                $sections[] = $section;
            }
        }
        return [
            'sections' => $sections,
            'available_families' => $availableFamilies,
            'family_counts' => $familyCounts,
            'total_count' => array_sum($familyCounts),
        ];
    }
    /**
     * @param  array<int, Tenant>  $tenants
     * @return array<int, Tenant>
     */
    private function indexTenants(array $tenants): array
    {
        $indexed = [];
        foreach ($tenants as $tenant) {
            $indexed[(int) $tenant->getKey()] = $tenant;
        }
        return $indexed;
    }
    /**
     * @param  array<int, Tenant>  $visibleFindingTenants
     * @return array<string, mixed>
     */
    private function assignedFindingsSection(
        User $user,
        array $visibleFindingTenants,
        ?Tenant $selectedTenant,
        ?CanonicalNavigationContext $navigationContext,
    ): array {
        $baseQuery = $this->assignedFindingsQuery($user, $visibleFindingTenants, $selectedTenant);
        $count = (clone $baseQuery)->count();
        $overdueCount = (clone $baseQuery)
            ->whereNotNull('due_at')
            ->where('due_at', '<', now())
            ->count();
        $entries = $this->orderedAssignedFindingsQuery(clone $baseQuery)
            ->limit(self::PREVIEW_LIMIT)
            ->get()
            ->map(fn (Finding $finding): array => $this->findingEntry($finding, 'assigned_findings', $navigationContext, 10))
            ->all();
        return [
            'key' => 'assigned_findings',
            'label' => 'Assigned findings',
            'count' => $count,
            'summary' => $this->assignedFindingsSummary($count, $overdueCount),
            'dominant_action_label' => 'Open my findings',
            'dominant_action_url' => $this->appendQuery(
                MyFindingsInbox::getUrl(
                    panel: 'admin',
                    parameters: array_filter([
                        'tenant' => $selectedTenant?->external_id,
                    ], static fn (mixed $value): bool => is_string($value) && $value !== ''),
                ),
                $navigationContext?->toQuery() ?? [],
            ),
            'entries' => $entries,
            'empty_state' => $selectedTenant instanceof Tenant
                ? 'No assigned findings match this tenant filter right now.'
                : 'No assigned findings are visible right now.',
        ];
    }
    /**
     * @param  array<int, Tenant>  $visibleFindingTenants
     * @return array<string, mixed>
     */
    private function intakeFindingsSection(
        array $visibleFindingTenants,
        ?Tenant $selectedTenant,
        ?CanonicalNavigationContext $navigationContext,
    ): array {
        $baseQuery = $this->intakeFindingsQuery($visibleFindingTenants, $selectedTenant);
        $count = (clone $baseQuery)->count();
        $needsTriageCount = (clone $baseQuery)
            ->whereIn('status', [Finding::STATUS_NEW, Finding::STATUS_REOPENED])
            ->count();
        $entries = $this->orderedIntakeFindingsQuery(clone $baseQuery)
            ->limit(self::PREVIEW_LIMIT)
            ->get()
            ->map(fn (Finding $finding): array => $this->findingEntry($finding, 'intake_findings', $navigationContext, 20))
            ->all();
        return [
            'key' => 'intake_findings',
            'label' => 'Findings intake',
            'count' => $count,
            'summary' => $this->intakeFindingsSummary($count, $needsTriageCount),
            'dominant_action_label' => 'Open findings intake',
            'dominant_action_url' => $this->appendQuery(
                FindingsIntakeQueue::getUrl(
                    panel: 'admin',
                    parameters: array_filter([
                        'tenant' => $selectedTenant?->external_id,
                        'view' => $needsTriageCount > 0 ? 'needs_triage' : null,
                    ], static fn (mixed $value): bool => $value !== null && $value !== ''),
                ),
                $navigationContext?->toQuery() ?? [],
            ),
            'entries' => $entries,
            'empty_state' => $selectedTenant instanceof Tenant
                ? 'No intake findings match this tenant filter right now.'
                : 'No intake findings are visible right now.',
        ];
    }
    /**
     * @param  array<int, Tenant>  $authorizedTenants
     * @return array<string, mixed>
     */
    private function operationsSection(
        Workspace $workspace,
        array $authorizedTenants,
        ?Tenant $selectedTenant,
        ?CanonicalNavigationContext $navigationContext,
    ): array {
        $terminalQuery = $this->terminalOperationsQuery($workspace, $authorizedTenants, $selectedTenant);
        $staleQuery = $this->staleOperationsQuery($workspace, $authorizedTenants, $selectedTenant);
        $terminalCount = (clone $terminalQuery)->count();
        $staleCount = (clone $staleQuery)->count();
        $entries = array_merge(
            (clone $terminalQuery)->latest('completed_at')->latest('id')->limit(self::PREVIEW_LIMIT)->get()->all(),
            (clone $staleQuery)->latest('created_at')->latest('id')->limit(self::PREVIEW_LIMIT)->get()->all(),
        );
        $entries = collect($entries)
            ->unique(fn (OperationRun $run): int => (int) $run->getKey())
            ->sortBy([
                fn (OperationRun $run): int => $run->problemClass() === OperationRun::PROBLEM_CLASS_TERMINAL_FOLLOW_UP ? 0 : 1,
                fn (OperationRun $run): int => -1 * (int) $run->getKey(),
            ])
            ->take(self::PREVIEW_LIMIT)
            ->map(fn (OperationRun $run): array => $this->operationEntry($run, $navigationContext))
            ->values()
            ->all();
        $dominantProblemClass = $terminalCount > 0
            ? OperationRun::PROBLEM_CLASS_TERMINAL_FOLLOW_UP
            : OperationRun::PROBLEM_CLASS_ACTIVE_STALE_ATTENTION;
        return [
            'key' => 'stale_operations',
            'label' => 'Operations follow-up',
            'count' => $terminalCount + $staleCount,
            'summary' => $this->operationsSummary($terminalCount, $staleCount),
            'dominant_action_label' => $terminalCount > 0 ? 'Open terminal follow-up' : 'Open stale operations',
            'dominant_action_url' => OperationRunLinks::index(
                tenant: $selectedTenant,
                context: $navigationContext,
                problemClass: $dominantProblemClass,
            ),
            'entries' => $entries,
            'empty_state' => $selectedTenant instanceof Tenant
                ? 'No stale or terminal follow-up operations match this tenant filter right now.'
                : 'No stale or terminal follow-up operations are visible right now.',
        ];
    }
    /**
     * @param  array<int, Tenant>  $authorizedTenants
     * @return array<string, mixed>
     */
    private function alertsSection(
        Workspace $workspace,
        array $authorizedTenants,
        ?Tenant $selectedTenant,
        ?CanonicalNavigationContext $navigationContext,
    ): array {
        $baseQuery = $this->alertsQuery($workspace, $authorizedTenants, $selectedTenant);
        $count = (clone $baseQuery)->count();
        $entries = (clone $baseQuery)
            ->latest('created_at')
            ->latest('id')
            ->limit(self::PREVIEW_LIMIT)
            ->get()
            ->map(fn (AlertDelivery $delivery): array => $this->alertEntry($delivery, $navigationContext))
            ->all();
        return [
            'key' => 'alert_delivery_failures',
            'label' => 'Alert delivery failures',
            'count' => $count,
            'summary' => $this->alertsSummary($count),
            'dominant_action_label' => 'Open alert deliveries',
            'dominant_action_url' => $this->appendQuery(
                AlertDeliveryResource::getUrl(panel: 'admin'),
                array_replace_recursive(
                    $navigationContext?->toQuery() ?? [],
                    [
                        'tableFilters' => array_filter([
                            'status' => ['value' => AlertDelivery::STATUS_FAILED],
                            'tenant_id' => $selectedTenant instanceof Tenant
                                ? ['value' => (string) $selectedTenant->getKey()]
                                : null,
                        ], static fn (mixed $value): bool => $value !== null),
                    ],
                ),
            ),
            'entries' => $entries,
            'empty_state' => $selectedTenant instanceof Tenant
                ? 'No failed alert deliveries match this tenant filter right now.'
                : 'No failed alert deliveries are visible right now.',
        ];
    }
    /**
     * @param  array<int, Tenant>  $reviewTenants
     * @return array<string, mixed>
     */
    private function reviewFollowUpSection(
        User $user,
        Workspace $workspace,
        array $reviewTenants,
        ?Tenant $selectedTenant,
        ?CanonicalNavigationContext $navigationContext,
    ): array {
        $tenantIds = $selectedTenant instanceof Tenant
            ? [(int) $selectedTenant->getKey()]
            : array_keys($reviewTenants);
        $backupHealthByTenant = $this->backupHealthResolver->assessMany($tenantIds);
        $recoveryEvidenceByTenant = $this->restoreSafetyResolver->dashboardRecoveryEvidenceForTenants($tenantIds, $backupHealthByTenant);
        $resolved = $this->tenantTriageReviewStateResolver->resolveMany(
            workspaceId: (int) $workspace->getKey(),
            tenantIds: $tenantIds,
            backupHealthByTenant: $backupHealthByTenant,
            recoveryEvidenceByTenant: $recoveryEvidenceByTenant,
        );
        $latestPublishedReviews = $this->tenantReviewRegisterService
            ->latestPublishedQuery($user, $workspace)
            ->get()
            ->keyBy('tenant_id')
            ->all();
        $rawEntries = [];
        foreach ($tenantIds as $tenantId) {
            $tenant = $reviewTenants[$tenantId] ?? null;
            $rows = $resolved['rows'][$tenantId] ?? null;
            if (! $tenant instanceof Tenant || ! is_array($rows)) {
                continue;
            }
            foreach ([PortfolioArrivalContextToken::FAMILY_BACKUP_HEALTH, PortfolioArrivalContextToken::FAMILY_RECOVERY_EVIDENCE] as $family) {
                $row = $rows[$family] ?? null;
                if (! is_array($row) || ($row['current_concern_present'] ?? false) !== true) {
                    continue;
                }
                $derivedState = $row['derived_state'] ?? null;
                if (! in_array($derivedState, [
                    TenantTriageReview::STATE_FOLLOW_UP_NEEDED,
                    TenantTriageReview::DERIVED_STATE_CHANGED_SINCE_REVIEW,
                ], true)) {
                    continue;
                }
                $rawEntries[] = $this->reviewEntry(
                    tenant: $tenant,
                    family: $family,
                    row: $row,
                    latestPublishedReview: $latestPublishedReviews[$tenantId] ?? null,
                    navigationContext: $navigationContext,
                );
            }
        }
        usort($rawEntries, function (array $left, array $right): int {
            $leftRank = (int) ($left['urgency_rank'] ?? 0);
            $rightRank = (int) ($right['urgency_rank'] ?? 0);
            if ($leftRank !== $rightRank) {
                return $leftRank <=> $rightRank;
            }
            return strcmp((string) ($left['headline'] ?? ''), (string) ($right['headline'] ?? ''));
        });
        $followUpCount = collect($rawEntries)
            ->where('status_label', 'Follow-up needed')
            ->count();
        $changedCount = collect($rawEntries)
            ->where('status_label', 'Changed since review')
            ->count();
        return [
            'key' => 'review_follow_up',
            'label' => 'Review follow-up',
            'count' => count($rawEntries),
            'summary' => $this->reviewSummary($followUpCount, $changedCount),
            'dominant_action_label' => 'Open review follow-up',
            'dominant_action_url' => $selectedTenant instanceof Tenant
                ? $this->appendQuery(CustomerReviewWorkspace::tenantPrefilterUrl($selectedTenant), $navigationContext?->toQuery() ?? [])
                : $this->appendQuery(TenantResource::getUrl(panel: 'admin'), array_replace_recursive(
                    $navigationContext?->toQuery() ?? [],
                    [
                        'backup_posture' => [
                            TenantBackupHealthAssessment::POSTURE_ABSENT,
                            TenantBackupHealthAssessment::POSTURE_STALE,
                            TenantBackupHealthAssessment::POSTURE_DEGRADED,
                        ],
                        'recovery_evidence' => [
                            TenantRecoveryTriagePresentation::RECOVERY_EVIDENCE_WEAKENED,
                            TenantRecoveryTriagePresentation::RECOVERY_EVIDENCE_UNVALIDATED,
                        ],
                        'review_state' => [
                            TenantTriageReview::STATE_FOLLOW_UP_NEEDED,
                            TenantTriageReview::DERIVED_STATE_CHANGED_SINCE_REVIEW,
                        ],
                        'triage_sort' => TenantRecoveryTriagePresentation::TRIAGE_SORT_WORST_FIRST,
                    ],
                )),
            'entries' => array_slice($rawEntries, 0, self::PREVIEW_LIMIT),
            'empty_state' => $selectedTenant instanceof Tenant
                ? 'No review follow-up is visible for this tenant filter right now.'
                : 'No review follow-up is visible right now.',
        ];
    }
    /**
     * @param  array<int, Tenant>  $visibleFindingTenants
     */
    private function assignedFindingsQuery(User $user, array $visibleFindingTenants, ?Tenant $selectedTenant): \Illuminate\Database\Eloquent\Builder
    {
        $tenantIds = $selectedTenant instanceof Tenant
            ? [(int) $selectedTenant->getKey()]
            : array_keys($visibleFindingTenants);
        return Finding::query()
            ->with(['tenant', 'ownerUser:id,name', 'assigneeUser:id,name'])
            ->withSubjectDisplayName()
            ->whereIn('tenant_id', $tenantIds === [] ? [-1] : $tenantIds)
            ->where('assignee_user_id', (int) $user->getKey())
            ->whereIn('status', Finding::openStatusesForQuery());
    }
    private function orderedAssignedFindingsQuery(\Illuminate\Database\Eloquent\Builder $query): \Illuminate\Database\Eloquent\Builder
    {
        return $query
            ->orderByRaw(
                'case when due_at is not null and due_at < ? then 0 when reopened_at is not null then 1 else 2 end asc',
                [now()],
            )
            ->orderByRaw('case when due_at is null then 1 else 0 end asc')
            ->orderBy('due_at')
            ->orderByDesc('id');
    }
    /**
     * @param  array<int, Tenant>  $visibleFindingTenants
     */
    private function intakeFindingsQuery(array $visibleFindingTenants, ?Tenant $selectedTenant): \Illuminate\Database\Eloquent\Builder
    {
        $tenantIds = $selectedTenant instanceof Tenant
            ? [(int) $selectedTenant->getKey()]
            : array_keys($visibleFindingTenants);
        return Finding::query()
            ->with(['tenant', 'ownerUser:id,name', 'assigneeUser:id,name'])
            ->withSubjectDisplayName()
            ->whereIn('tenant_id', $tenantIds === [] ? [-1] : $tenantIds)
            ->whereNull('assignee_user_id')
            ->whereIn('status', Finding::openStatusesForQuery());
    }
    private function orderedIntakeFindingsQuery(\Illuminate\Database\Eloquent\Builder $query): \Illuminate\Database\Eloquent\Builder
    {
        return $query
            ->orderByRaw(
                "case
                    when due_at is not null and due_at < ? then 0
                    when status = ? then 1
                    when status = ? then 2
                    else 3
                end asc",
                [now(), Finding::STATUS_REOPENED, Finding::STATUS_NEW],
            )
            ->orderByRaw('case when due_at is null then 1 else 0 end asc')
            ->orderBy('due_at')
            ->orderByDesc('id');
    }
    /**
     * @param  array<int, Tenant>  $authorizedTenants
     */
    private function terminalOperationsQuery(Workspace $workspace, array $authorizedTenants, ?Tenant $selectedTenant): \Illuminate\Database\Eloquent\Builder
    {
        return $this->operationsBaseQuery($workspace, $authorizedTenants, $selectedTenant)
            ->terminalFollowUp();
    }
    /**
     * @param  array<int, Tenant>  $authorizedTenants
     */
    private function staleOperationsQuery(Workspace $workspace, array $authorizedTenants, ?Tenant $selectedTenant): \Illuminate\Database\Eloquent\Builder
    {
        return $this->operationsBaseQuery($workspace, $authorizedTenants, $selectedTenant)
            ->activeStaleAttention();
    }
    /**
     * @param  array<int, Tenant>  $authorizedTenants
     */
    private function operationsBaseQuery(Workspace $workspace, array $authorizedTenants, ?Tenant $selectedTenant): \Illuminate\Database\Eloquent\Builder
    {
        $tenantIds = array_keys($authorizedTenants);
        return OperationRun::query()
            ->with('tenant')
            ->where('workspace_id', (int) $workspace->getKey())
            ->where(function ($query) use ($selectedTenant, $tenantIds): void {
                if ($selectedTenant instanceof Tenant) {
                    $query->where('tenant_id', (int) $selectedTenant->getKey());
                    return;
                }
                $query
                    ->whereIn('tenant_id', $tenantIds === [] ? [-1] : $tenantIds)
                    ->orWhereNull('tenant_id');
            });
    }
    /**
     * @param  array<int, Tenant>  $authorizedTenants
     */
    private function alertsQuery(Workspace $workspace, array $authorizedTenants, ?Tenant $selectedTenant): \Illuminate\Database\Eloquent\Builder
    {
        $tenantIds = array_keys($authorizedTenants);
        return AlertDelivery::query()
            ->with('tenant')
            ->where('workspace_id', (int) $workspace->getKey())
            ->where('status', AlertDelivery::STATUS_FAILED)
            ->where(function ($query) use ($selectedTenant, $tenantIds): void {
                if ($selectedTenant instanceof Tenant) {
                    $query->where('tenant_id', (int) $selectedTenant->getKey());
                    return;
                }
                $query
                    ->whereIn('tenant_id', $tenantIds === [] ? [-1] : $tenantIds)
                    ->orWhereNull('tenant_id');
            });
    }
    /**
     * @return array<string, mixed>
     */
    private function findingEntry(Finding $finding, string $familyKey, ?CanonicalNavigationContext $navigationContext, int $baseUrgencyRank): array
    {
        $sublineParts = array_values(array_filter([
            $finding->owner_user_id !== null ? 'Owner: '.FindingResource::accountableOwnerDisplayFor($finding) : null,
            FindingExceptionResource::relativeTimeDescription($finding->due_at) ?? FindingResource::dueAttentionLabelFor($finding),
            $finding->reopened_at !== null ? 'Reopened' : null,
        ]));
        return [
            'family_key' => $familyKey,
            'source_model' => Finding::class,
            'source_key' => (string) $finding->getKey(),
            'tenant_id' => $finding->tenant ? (int) $finding->tenant->getKey() : null,
            'tenant_label' => $finding->tenant?->name,
            'headline' => $finding->resolvedSubjectDisplayName() ?? 'Finding #'.$finding->getKey(),
            'subline' => $sublineParts === [] ? null : implode(' • ', $sublineParts),
            'urgency_rank' => $baseUrgencyRank
                + ($finding->due_at?->isPast() === true ? 0 : 1)
                + ($finding->reopened_at !== null ? 0 : 1),
            'status_label' => Str::of((string) $finding->status)->replace('_', ' ')->title()->value(),
            'destination_url' => $this->appendQuery(
                FindingResource::getUrl('view', ['record' => $finding], panel: 'tenant', tenant: $finding->tenant),
                $navigationContext?->toQuery() ?? [],
            ),
            'back_label' => $navigationContext?->backLinkLabel ?? 'Back to governance inbox',
        ];
    }
    /**
     * @return array<string, mixed>
     */
    private function operationEntry(OperationRun $run, ?CanonicalNavigationContext $navigationContext): array
    {
        $problemClass = $run->problemClass();
        return [
            'family_key' => 'stale_operations',
            'source_model' => OperationRun::class,
            'source_key' => (string) $run->getKey(),
            'tenant_id' => $run->tenant ? (int) $run->tenant->getKey() : null,
            'tenant_label' => $run->tenant?->name,
            'headline' => $problemClass === OperationRun::PROBLEM_CLASS_TERMINAL_FOLLOW_UP
                ? 'Terminal follow-up operation'
                : 'Stale active operation',
            'subline' => OperationRunLinks::identifier($run),
            'urgency_rank' => $problemClass === OperationRun::PROBLEM_CLASS_TERMINAL_FOLLOW_UP ? 0 : 1,
            'status_label' => $problemClass === OperationRun::PROBLEM_CLASS_TERMINAL_FOLLOW_UP
                ? 'Terminal follow-up'
                : 'Stale',
            'destination_url' => OperationRunLinks::tenantlessView($run, $navigationContext),
            'back_label' => $navigationContext?->backLinkLabel ?? 'Back to governance inbox',
        ];
    }
    /**
     * @return array<string, mixed>
     */
    private function alertEntry(AlertDelivery $delivery, ?CanonicalNavigationContext $navigationContext): array
    {
        $payload = is_array($delivery->payload) ? $delivery->payload : [];
        $headline = is_string($payload['title'] ?? null) && $payload['title'] !== ''
            ? (string) $payload['title']
            : 'Failed alert delivery';
        $sublineParts = array_values(array_filter([
            is_string($delivery->last_error_message) && $delivery->last_error_message !== ''
                ? $delivery->last_error_message
                : null,
            is_string($delivery->event_type) && $delivery->event_type !== ''
                ? $delivery->event_type
                : null,
        ]));
        return [
            'family_key' => 'alert_delivery_failures',
            'source_model' => AlertDelivery::class,
            'source_key' => (string) $delivery->getKey(),
            'tenant_id' => $delivery->tenant ? (int) $delivery->tenant->getKey() : null,
            'tenant_label' => $delivery->tenant?->name,
            'headline' => $headline,
            'subline' => $sublineParts === [] ? null : implode(' • ', $sublineParts),
            'urgency_rank' => 0,
            'status_label' => 'Failed',
            'destination_url' => $this->appendQuery(
                AlertDeliveryResource::getUrl('view', ['record' => $delivery], panel: 'admin'),
                $navigationContext?->toQuery() ?? [],
            ),
            'back_label' => $navigationContext?->backLinkLabel ?? 'Back to governance inbox',
        ];
    }
    /**
     * @param  array<string, mixed>  $row
     * @return array<string, mixed>
     */
    private function reviewEntry(
        Tenant $tenant,
        string $family,
        array $row,
        mixed $latestPublishedReview,
        ?CanonicalNavigationContext $navigationContext,
    ): array {
        $state = (string) ($row['derived_state'] ?? TenantTriageReview::DERIVED_STATE_NOT_REVIEWED);
        $familyLabel = $family === PortfolioArrivalContextToken::FAMILY_BACKUP_HEALTH
            ? 'Backup health'
            : 'Recovery evidence';
        $headline = $state === TenantTriageReview::STATE_FOLLOW_UP_NEEDED
            ? $familyLabel.' needs review follow-up'
            : $familyLabel.' changed since review';
        $sublineParts = array_values(array_filter([
            is_string($row['reviewed_by_user_name'] ?? null) && $row['reviewed_by_user_name'] !== ''
                ? 'Last review: '.$row['reviewed_by_user_name']
                : null,
            isset($row['reviewed_at']) && $row['reviewed_at'] !== null
                ? 'Reviewed '.optional($row['reviewed_at'])->toDateTimeString()
                : null,
        ]));
        $destinationUrl = $latestPublishedReview !== null
            ? TenantReviewResource::tenantScopedUrl('view', ['record' => $latestPublishedReview], $tenant, 'tenant')
            : CustomerReviewWorkspace::tenantPrefilterUrl($tenant);
        return [
            'family_key' => 'review_follow_up',
            'source_model' => TenantTriageReview::class,
            'source_key' => (string) $tenant->getKey().':'.$family,
            'tenant_id' => (int) $tenant->getKey(),
            'tenant_label' => $tenant->name,
            'headline' => $headline,
            'subline' => $sublineParts === [] ? null : implode(' • ', $sublineParts),
            'urgency_rank' => $state === TenantTriageReview::STATE_FOLLOW_UP_NEEDED ? 0 : 1,
            'status_label' => $state === TenantTriageReview::STATE_FOLLOW_UP_NEEDED
                ? 'Follow-up needed'
                : 'Changed since review',
            'destination_url' => $this->appendQuery($destinationUrl, $navigationContext?->toQuery() ?? []),
            'back_label' => $navigationContext?->backLinkLabel ?? 'Back to governance inbox',
        ];
    }
    private function assignedFindingsSummary(int $count, int $overdueCount): string
    {
        if ($count === 0) {
            return 'No assigned findings are visible in the current scope.';
        }
        if ($overdueCount > 0) {
            return sprintf(
                '%d assigned finding%s remain open. %d %s overdue.',
                $count,
                $count === 1 ? '' : 's',
                $overdueCount,
                $overdueCount === 1 ? 'is' : 'are',
            );
        }
        return sprintf(
            '%d assigned finding%s remain open in the visible scope.',
            $count,
            $count === 1 ? '' : 's',
        );
    }
    private function intakeFindingsSummary(int $count, int $needsTriageCount): string
    {
        if ($count === 0) {
            return 'No intake findings are visible in the current scope.';
        }
        return sprintf(
            '%d unassigned finding%s remain in intake. %d still need first triage.',
            $count,
            $count === 1 ? '' : 's',
            $needsTriageCount,
        );
    }
    private function operationsSummary(int $terminalCount, int $staleCount): string
    {
        if ($terminalCount + $staleCount === 0) {
            return 'No stale or terminal follow-up operations are visible in the current scope.';
        }
        if ($terminalCount > 0 && $staleCount > 0) {
            return sprintf(
                '%d terminal follow-up operation%s and %d stale active run%s need monitoring attention.',
                $terminalCount,
                $terminalCount === 1 ? '' : 's',
                $staleCount,
                $staleCount === 1 ? '' : 's',
            );
        }
        if ($terminalCount > 0) {
            return sprintf(
                '%d terminal follow-up operation%s need monitoring attention.',
                $terminalCount,
                $terminalCount === 1 ? '' : 's',
            );
        }
        return sprintf(
            '%d stale active run%s need monitoring attention.',
            $staleCount,
            $staleCount === 1 ? '' : 's',
        );
    }
    private function alertsSummary(int $count): string
    {
        if ($count === 0) {
            return 'No failed alert deliveries are visible in the current scope.';
        }
        return sprintf(
            '%d failed alert delivery attempt%s remain visible in this workspace.',
            $count,
            $count === 1 ? '' : 's',
        );
    }
    private function reviewSummary(int $followUpCount, int $changedCount): string
    {
        $total = $followUpCount + $changedCount;
        if ($total === 0) {
            return 'No review follow-up is visible in the current scope.';
        }
        return sprintf(
            '%d review concern%s need attention. %d marked follow-up needed and %d changed since review.',
            $total,
            $total === 1 ? '' : 's',
            $followUpCount,
            $changedCount,
        );
    }
    /**
     * @param  array<string, mixed>  $query
     */
    private function appendQuery(string $url, array $query): string
    {
        if ($query === []) {
            return $url;
        }
        $separator = str_contains($url, '?') ? '&' : '?';
        return $url.$separator.http_build_query($query);
    }
 }
--- a/apps/platform/app/Support/Livewire/TrustedState/TrustedStatePolicy.php
+++ b/apps/platform/app/Support/Livewire/TrustedState/TrustedStatePolicy.php
@ -12,8 +12,6 @@ final class TrustedStatePolicy
    public const TENANT_REQUIRED_PERMISSIONS = 'tenant_required_permissions';
    public const SYSTEM_RUNBOOKS = 'system_runbooks';
    /**
     * @return array{
     *     name: string,
@ -329,92 +327,6 @@ public function firstSlice(): array
                    'scopedTenant',
                ],
            ],
            self::SYSTEM_RUNBOOKS => [
                'component_name' => 'System runbooks',
                'plane' => 'system_platform',
                'route_anchor' => null,
                'authority_sources' => [
                    'allowed_tenant_universe',
                    'explicit_scoped_query',
                ],
                'locked_identities' => [],
                'locked_identity_fields' => [],
                'mutable_selectors' => [
                    'findingsTenantId',
                    'tenantId',
                    'findingsScopeMode',
                    'scopeMode',
                ],
                'mutable_selector_fields' => [
                    $this->field(
                        name: 'findingsTenantId',
                        stateClass: TrustedStateClass::Presentation,
                        phpType: '?int',
                        sourceOfTruth: 'allowed_tenant_universe',
                        usedForProtectedAction: true,
                        revalidationRequired: true,
                        implementationMarkers: [
                            'public ?int $findingsTenantId = null;',
                            'resolveAllowedOrFail($this->findingsTenantId)',
                        ],
                        notes: 'Single-tenant runbook proposal only; it must be validated against the operator allowed-tenant universe.',
                    ),
                    $this->field(
                        name: 'tenantId',
                        stateClass: TrustedStateClass::Presentation,
                        phpType: '?int',
                        sourceOfTruth: 'allowed_tenant_universe',
                        usedForProtectedAction: false,
                        revalidationRequired: false,
                        implementationMarkers: [
                            'public ?int $tenantId = null;',
                        ],
                        notes: 'Mirrored display state for the last trusted preflight result.',
                    ),
                    $this->field(
                        name: 'findingsScopeMode',
                        stateClass: TrustedStateClass::Presentation,
                        phpType: 'string',
                        sourceOfTruth: 'presentation_only',
                        usedForProtectedAction: true,
                        revalidationRequired: true,
                        implementationMarkers: [
                            'public string $findingsScopeMode = FindingsLifecycleBackfillScope::MODE_ALL_TENANTS;',
                            'trustedFindingsScopeFromState(',
                        ],
                        notes: 'Scope mode remains mutable UI state but protected actions re-normalize it into a trusted scope DTO.',
                    ),
                    $this->field(
                        name: 'scopeMode',
                        stateClass: TrustedStateClass::Presentation,
                        phpType: 'string',
                        sourceOfTruth: 'presentation_only',
                        usedForProtectedAction: false,
                        revalidationRequired: false,
                        implementationMarkers: [
                            'public string $scopeMode = FindingsLifecycleBackfillScope::MODE_ALL_TENANTS;',
                        ],
                        notes: 'Mirrored display state for the last trusted preflight result.',
                    ),
                ],
                'server_derived_authority_fields' => [
                    $this->field(
                        name: 'findingsScope',
                        stateClass: TrustedStateClass::ServerDerivedAuthority,
                        phpType: 'FindingsLifecycleBackfillScope',
                        sourceOfTruth: 'allowed_tenant_universe',
                        usedForProtectedAction: true,
                        revalidationRequired: true,
                        implementationMarkers: [
                            'trustedFindingsScopeFromFormData(',
                            'trustedFindingsScopeFromState(',
                            'resolveAllowedOrFail(',
                        ],
                        notes: 'Protected actions must convert mutable selector state into a trusted scope DTO via AllowedTenantUniverse.',
                    ),
                ],
                'forbidden_public_authority_fields' => [],
            ],
        ];
    }
--- a/apps/platform/app/Support/OperationCatalog.php
+++ b/apps/platform/app/Support/OperationCatalog.php
@ -278,7 +278,6 @@ private static function canonicalDefinitions(): array
            'tenant.review.compose' => new CanonicalOperationType('tenant.review.compose', 'platform_foundation', 'tenant_review', 'Review composition', true, 60),
            'tenant.evidence.snapshot.generate' => new CanonicalOperationType('tenant.evidence.snapshot.generate', 'platform_foundation', 'evidence_snapshot', 'Evidence snapshot generation', true, 120),
            'rbac.health_check' => new CanonicalOperationType('rbac.health_check', 'intune', null, 'RBAC health check', false, 30),
            'findings.lifecycle.backfill' => new CanonicalOperationType('findings.lifecycle.backfill', 'platform_foundation', null, 'Findings lifecycle backfill', false, 300),
        ];
    }
@ -290,27 +289,36 @@ private static function operationAliases(): array
        return [
            new OperationTypeAlias('policy.sync', 'policy.sync', 'canonical', true),
            new OperationTypeAlias('policy.sync_one', 'policy.sync', 'legacy_alias', false, 'Legacy single-policy sync values resolve to the canonical policy.sync operation.', 'Prefer policy.sync on platform-owned read paths.'),
            new OperationTypeAlias('policy.snapshot', 'policy.snapshot', 'canonical', true),
            new OperationTypeAlias('policy.capture_snapshot', 'policy.snapshot', 'canonical', true),
            new OperationTypeAlias('policy.delete', 'policy.delete', 'canonical', true),
            new OperationTypeAlias('policy.restore', 'policy.restore', 'canonical', true),
            new OperationTypeAlias('policy.unignore', 'policy.restore', 'legacy_alias', false, 'Legacy policy.unignore values resolve to policy.restore for operator-facing wording.', 'Prefer policy.restore on new platform-owned read models.'),
            new OperationTypeAlias('policy.export', 'policy.export', 'canonical', true),
            new OperationTypeAlias('provider.connection.check', 'provider.connection.check', 'canonical', true),
            new OperationTypeAlias('inventory.sync', 'inventory.sync', 'canonical', true),
            new OperationTypeAlias('inventory_sync', 'inventory.sync', 'legacy_alias', false, 'Legacy inventory_sync storage values resolve to the canonical inventory.sync operation.', 'Preserve stored values during rollout while showing inventory.sync semantics on read paths.'),
            new OperationTypeAlias('provider.inventory.sync', 'inventory.sync', 'legacy_alias', false, 'Provider-prefixed historical inventory sync values share the same operator meaning as inventory sync.', 'Avoid emitting provider.inventory.sync on new platform-owned surfaces.'),
            new OperationTypeAlias('compliance.snapshot', 'compliance.snapshot', 'canonical', true),
            new OperationTypeAlias('provider.compliance.snapshot', 'compliance.snapshot', 'legacy_alias', false, 'Provider-prefixed compliance snapshot values resolve to the canonical compliance.snapshot operation.', 'Avoid emitting provider.compliance.snapshot on new platform-owned surfaces.'),
            new OperationTypeAlias('directory.groups.sync', 'directory.groups.sync', 'canonical', true),
            new OperationTypeAlias('entra_group_sync', 'directory.groups.sync', 'legacy_alias', false, 'Historical entra_group_sync values resolve to directory.groups.sync.', 'Prefer directory.groups.sync on new platform-owned read models.'),
            new OperationTypeAlias('backup_set.update', 'backup_set.update', 'canonical', true),
            new OperationTypeAlias('backup_set.archive', 'backup_set.archive', 'canonical', true),
            new OperationTypeAlias('backup_set.delete', 'backup_set.archive', 'canonical', true),
            new OperationTypeAlias('backup_set.restore', 'backup_set.restore', 'canonical', true),
            new OperationTypeAlias('backup_set.force_delete', 'backup_set.delete', 'legacy_alias', false, 'Force-delete wording is normalized to the canonical delete label.', 'Use backup_set.delete for new platform-owned summaries.'),
            new OperationTypeAlias('backup.schedule.execute', 'backup.schedule.execute', 'canonical', true),
            new OperationTypeAlias('backup_schedule_run', 'backup.schedule.execute', 'legacy_alias', false, 'Historical backup_schedule_run values resolve to backup.schedule.execute.', 'Prefer backup.schedule.execute on canonical read paths.'),
            new OperationTypeAlias('backup.schedule.retention', 'backup.schedule.retention', 'canonical', true),
            new OperationTypeAlias('backup_schedule_retention', 'backup.schedule.retention', 'legacy_alias', false, 'Legacy backup schedule retention values resolve to backup.schedule.retention.', 'Prefer dotted canonical backup schedule naming on new read paths.'),
            new OperationTypeAlias('backup.schedule.purge', 'backup.schedule.purge', 'canonical', true),
            new OperationTypeAlias('backup_schedule_purge', 'backup.schedule.purge', 'legacy_alias', false, 'Legacy backup schedule purge values resolve to backup.schedule.purge.', 'Prefer dotted canonical backup schedule naming on new read paths.'),
            new OperationTypeAlias('restore.execute', 'restore.execute', 'canonical', true),
            new OperationTypeAlias('assignments.fetch', 'assignments.fetch', 'canonical', true),
            new OperationTypeAlias('assignments.restore', 'assignments.restore', 'canonical', true),
            new OperationTypeAlias('ops.reconcile_adapter_runs', 'ops.reconcile_adapter_runs', 'canonical', true),
            new OperationTypeAlias('directory.role_definitions.sync', 'directory.role_definitions.sync', 'canonical', true),
            new OperationTypeAlias('directory_role_definitions.sync', 'directory.role_definitions.sync', 'legacy_alias', false, 'Legacy directory_role_definitions.sync values resolve to directory.role_definitions.sync.', 'Prefer dotted role-definition naming on new read paths.'),
            new OperationTypeAlias('restore_run.delete', 'restore_run.delete', 'canonical', true),
            new OperationTypeAlias('restore_run.restore', 'restore_run.restore', 'canonical', true),
@ -325,13 +333,13 @@ private static function operationAliases(): array
            new OperationTypeAlias('baseline.compare', 'baseline.compare', 'canonical', true),
            new OperationTypeAlias('baseline_capture', 'baseline.capture', 'legacy_alias', false, 'Historical baseline_capture values resolve to baseline.capture.', 'Prefer baseline.capture on canonical read paths.'),
            new OperationTypeAlias('baseline_compare', 'baseline.compare', 'legacy_alias', false, 'Historical baseline_compare values resolve to baseline.compare.', 'Prefer baseline.compare on canonical read paths.'),
            new OperationTypeAlias('permission.posture.check', 'permission.posture.check', 'canonical', true),
            new OperationTypeAlias('permission_posture_check', 'permission.posture.check', 'legacy_alias', false, 'Historical permission_posture_check values resolve to permission.posture.check.', 'Prefer dotted permission posture naming on new read paths.'),
            new OperationTypeAlias('entra.admin_roles.scan', 'entra.admin_roles.scan', 'canonical', true),
            new OperationTypeAlias('tenant.review_pack.generate', 'tenant.review_pack.generate', 'canonical', true),
            new OperationTypeAlias('tenant.review.compose', 'tenant.review.compose', 'canonical', true),
            new OperationTypeAlias('tenant.evidence.snapshot.generate', 'tenant.evidence.snapshot.generate', 'canonical', true),
            new OperationTypeAlias('rbac.health_check', 'rbac.health_check', 'canonical', true),
            new OperationTypeAlias('findings.lifecycle.backfill', 'findings.lifecycle.backfill', 'canonical', true),
        ];
    }
 }
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
ahmido	54fb65a63a	chore: promote platform-dev to dev (#297 ) Some checks failed Main Confidence / confidence (push) Failing after 54s Details This pull request promotes the current state of `platform-dev` to the main integration branch `dev`. It includes recent features, fixes, and architectural refinements validated on the platform development track. Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #297	2026-04-29 07:50:16 +00:00
ahmido	29ad8852ca	merge: platform-dev into dev (#295 ) Some checks failed Main Confidence / confidence (push) Failing after 1m1s Details Heavy Governance Lane / heavy-governance (push) Has been skipped Details Browser Lane / browser (push) Has been skipped Details ## Summary - integrate the current `platform-dev` branch into `dev` - bring the latest platform work from the integration branch into the main development branch - include the recent findings lifecycle backfill removal slice together with the already accumulated `platform-dev` changes ## Scope - source branch: `platform-dev` - target branch: `dev` - branch role: integration PR, not a single-feature PR ## Validation - branch state reviewed before PR creation - `platform-dev` is ahead of `dev` with the expected integration history - this PR intentionally carries the accumulated `platform-dev` commits into `dev` ## Notes - this is the correct merge direction for the current workflow, where feature branches land in `platform-dev` first and `platform-dev` is then merged into `dev` - after merging, `platform-dev` can be recreated fresh from `dev` as usual Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #295	2026-04-28 22:11:20 +00:00
ahmido	7613e339c4	feat: implement platform localization v1 (#293 ) Some checks failed Main Confidence / confidence (push) Failing after 56s Details ## Summary - add the localization v1 foundation with request-time locale resolution and workspace or user preference handling - localize the first-wave platform surfaces for auth, shell, dashboards, findings, baseline compare, and review workspace chrome - add Pest coverage for locale resolution, preference flows, fallback behavior, notifications, and governance surface localization ## Scope - active spec: specs/252-platform-localization-v1 - target branch: dev ## Notes - machine-readable artifacts remain invariant and are not localized in this slice - the branch includes the related spec kit artifacts for the feature Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #293	2026-04-28 19:45:03 +00:00
ahmido	7ee4909212	feat: commercial lifecycle overlay for workspace entitlements (#292 ) Some checks failed Main Confidence / confidence (push) Failing after 1m45s Details ## Summary - add the bounded workspace commercial lifecycle overlay from spec 251 on top of the existing entitlement substrate - expose audited commercial state inspection and mutation on the system workspace detail surface - gate onboarding activation and review-pack start actions through the shared lifecycle decision while preserving suspended read-only access to existing review, evidence, and generated-pack history - add focused Pest coverage plus the spec/plan/tasks/data-model/contract artifacts for the feature ## Validation - targeted Pest unit and feature lanes for lifecycle resolution, system-plane mutation, onboarding gating, review-pack enforcement, download preservation, customer review workspace access, and evidence snapshot access - `cd apps/platform && ./vendor/bin/sail bin pint --dirty --format agent` - integrated browser smoke on the system workspace detail and the preserved read-only review/evidence/review-pack surfaces ## Notes - branch: `251-commercial-entitlements-billing-state` - base: `dev` - commit: `606e9760` Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #292	2026-04-28 13:39:33 +00:00
ahmido	72bfb37ba7	feat: add decision-based governance inbox (#291 ) Some checks failed Main Confidence / confidence (push) Failing after 57s Details ## Summary - add a read-first governance inbox page at `/admin/governance/inbox` - aggregate assigned findings, intake, stale operations, alert-delivery failures, and review follow-up into one canonical routing surface - add focused coverage for inbox authorization, navigation context, page behavior, and section builder logic - include the Spec Kit artifacts for spec 250 ## Notes - branch is synced with `dev` - this PR supersedes #290 for the governance inbox work Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #291	2026-04-28 10:13:09 +00:00
ahmido	aacd82849a	feat(reviews): add CustomerReviewWorkspace with audit logging and RBAC enforcement (#289 ) Some checks failed Main Confidence / confidence (push) Failing after 54s Details Add `CustomerReviewWorkspace` page for tenant pre-filtered reviews Add customer workspace links to `EvidenceSnapshotResource`, `ReviewPackResource`, and `TenantReviewResource` Implement audit logging for `TenantReviewOpened` and `ReviewPackDownloaded` actions Update ReviewPack download controller to enforce tenant-scoped RBAC Add tests for ReviewPack download authorization and audit logging Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #289	2026-04-28 07:15:41 +00:00
ahmido	ff3392892b	Merge 248-private-ai-policy-foundation into dev (#288 ) Some checks failed Main Confidence / confidence (push) Failing after 56s Details Heavy Governance Lane / heavy-governance (push) Has been skipped Details Browser Lane / browser (push) Has been skipped Details Automated PR: merge branch 248-private-ai-policy-foundation into dev (created by Copilot) Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #288	2026-04-27 21:18:37 +00:00
ahmido	e222845a36	247: plans entitlements billing readiness (#287 ) Some checks failed Main Confidence / confidence (push) Failing after 53s Details Automated commit and PR created by Copilot per user request. Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #287	2026-04-27 17:35:04 +00:00
ahmido	6e3736a53f	Add in-app support request with context (#285 ) Some checks failed Main Confidence / confidence (push) Failing after 1m29s Details ## Summary - add the first in-app support request flow with an immutable `SupportRequest` record, canonical context builder, submission service, and generated internal reference - expose contextual support-request actions from the tenant dashboard and operation run surfaces, including audit logging and support-safe diagnostic capture rules - add Pest coverage plus the `specs/246-support-request-context` artifacts for the new support-request slice ## Testing - `cd apps/platform && ./vendor/bin/sail artisan test --compact tests/Feature/SupportRequests/OperationRunSupportRequestActionTest.php tests/Feature/SupportRequests/SupportRequestAuditTest.php tests/Feature/SupportRequests/SupportRequestAuthorizationTest.php tests/Feature/SupportRequests/TenantSupportRequestActionTest.php tests/Unit/Support/SupportRequests/SupportRequestContextBuilderTest.php tests/Unit/Support/SupportRequests/SupportRequestReferenceTest.php` ## Notes - this PR supersedes the earlier session-branch PR opened from `246-support-request-context-session-1777289015` Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #285	2026-04-27 12:51:39 +00:00
ahmido	86505483bf	feat(customer-health): add decision card to tenant/workspace detail (spec 245) (#283 ) Some checks failed Main Confidence / confidence (push) Failing after 52s Details Add Customer Health decision card to tenant & workspace detail pages (spec 245). What I changed: - Render a decision-first Customer Health card on tenant and workspace detail pages. - Reuse `WorkspaceHealthSummaryQuery` and preserve `window` query param. - Update attention widget link text to "Review health details" and include `?window=`. - Add/adjust tests to cover new behavior and explainability. - Run Pint formatting. Compare URL: https://git.cloudarix.de/ahmido/TenantAtlas/compare/dev...245-customer-health-score Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #283	2026-04-27 08:30:01 +00:00
ahmido	bf43e55848	feat(onboarding): decision-first verify-step & contextual-help callout fix (#282 ) Some checks failed Main Confidence / confidence (push) Failing after 53s Details Heavy Governance Lane / heavy-governance (push) Has been skipped Details Browser Lane / browser (push) Has been skipped Details This PR implements the onboarding verify-step changes and ProductKnowledge contextual-help fixes: - Hide the top-level "Permission diagnostics" when a stored verification report exists. - Move permission details to "Supporting evidence" / "View required permissions" and into stored report technical details. - Rename "Current checkpoint" to "Step" in onboarding readiness. - Rename the inner verification card title to "Stored verification details" to avoid duplicate headings. - Keep "Grant admin consent" as primary CTA when admin consent is the dominant blocker by deriving the CTA from the verification primary reason. - Replace the custom Safe Next Action with Filament `Callout` for correct dark-mode styling. - Add/adjust focused feature tests proving the above behaviors. Verification: - Tests: 36 passed (173 assertions) locally. - Pint: pass. Created from local session branch `244-product-knowledge-contextual-help-session-1777248340`. Please review and merge into `dev` when ready. Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #282	2026-04-27 00:09:46 +00:00
ahmido	6053d87b99	feat: implement product usage adoption telemetry (#281 ) Some checks failed Main Confidence / confidence (push) Failing after 48s Details ## Summary - implement spec 243 product usage adoption telemetry end-to-end - add bounded product usage event capture, aggregation, retention pruning, and system dashboard KPIs - add unit and feature coverage for telemetry capture, authorization, retention, privacy, and dashboard window behavior ## Validation - ran focused Pest test suites for telemetry and system dashboard behavior - ran Laravel Pint formatting - verified the system dashboard telemetry widget in the integrated browser ## Notes - branch: `243-product-usage-adoption-telemetry` - target: `dev` Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #281	2026-04-26 20:52:38 +00:00
ahmido	d96abc65fb	Remove Findings lifecycle backfill operational surface (controls slice) (#280 ) Some checks failed Main Confidence / confidence (push) Failing after 1m23s Details Removes the Findings lifecycle backfill from the Operational Controls UI and OperationalControlCatalog. This patch is a safe, controls-only change; runbooks, jobs and other runtime artifacts are NOT removed yet. Follow-up work will delete the runbook service/scope, jobs, commands, and update tests. Files changed: - apps/platform/app/Filament/System/Pages/Ops/Controls.php - apps/platform/app/Support/OperationalControls/OperationalControlCatalog.php - apps/platform/tests/Feature/System/OpsControls/OperationalControlManagementTest.php - apps/platform/tests/Unit/Support/OperationalControls/OperationalControlCatalogTest.php - apps/platform/tests/Unit/Support/OperationalControls/OperationalControlScopeResolutionTest.php Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #280	2026-04-26 15:43:47 +00:00