fix(search): recover Meilisearch indexes safely

[shekohex]

Summary

• Remove invalid series.num uniqueness assumption that broke provider refreshes.
• Replace destructive pre-sync index flushing with verified atomic Meilisearch rebuilds after successful catalog sync.
• Add hourly full-catalog fingerprint reconciliation for missing, empty, stale, count-mismatched, or settings-mismatched indexes.
• Serialize forced post-sync rebuilds, bypass redundant health scans, and isolate per-index failures.
• Block destructive Scout index commands in production and tolerate temporary Meilisearch startup outages.
• Align searchable payloads with configured sortable/filterable attributes.

Root Cause

Provider series ordering changed, causing existing records to temporarily share num values during upsert. SQLite rejected refresh with UNIQUE constraint failed: series.num. Search indexes had already been flushed, leaving both indexes empty after database sync aborted.

Recovery

• Build replacement indexes under unique temporary names.
• Apply settings and import documents in chunks.
• Verify replacement document count before atomic swap.
• Keep live index untouched when build or validation fails.
• Compare deterministic fingerprints across every database and indexed document.
• Wait for active reconciliation before forced post-sync rebuilds.
• Attempt both indexes before surfacing per-index failures.
• Reconcile hourly and after successful media refresh.
• Provide php artisan lionz:reconcile-search --force for manual recovery.

Verification

• 337 passed Unit/Feature tests, 2,866 assertions.
• Real Meilisearch integration: 2 passed, 8 assertions.
• Changed PHP files: PHPStan passes.
• Pint, Prettier, TypeScript, ESLint, Composer validation, frontend build pass.
• GitHub Actions: 5/5 checks pass.
• All five review threads addressed and resolved.
• Full-project PHPStan still reports four pre-existing errors in SyncCategories, MediaCategoryAssignment, and UserCategoryPreference.

Related: ZRO-1

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 20f12cc83a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f7317c8cac

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".