feat(preferences): include-paths UI wiring

[buggerman]

follow-up to #187. ships the frontend half so users can actually configure include paths from preferences. targeting v0.1.24 per the comment on the previous PR.

what this does

• new useIncludePaths hook: mirrors useIgnorePaths, persists to localStorage under cardinal.includePaths, defaults to an empty array since include paths are opt-in.
• useAppPreferences reads the new hook, sends includePaths on the start_logic invoke, and ships it through setWatchConfig whenever preferences change. equality check now considers all three fields.
• PreferencesOverlay gains an "Include paths" textarea right under "Ignore paths". same one-path-per-line shape, same absolute-path validation, same save/reset behaviour.
• WatchConfigPayload gained includePaths: string[] so the type forces every call site to ship it.
• i18n: includePaths.label / includePaths.help / includePaths.errors.absolute translated into all 15 locales.

what it lets you do

with /Volumes ignored by default, you can now add /Volumes/media (or whatever) to the include list and that subtree stays indexed even though its parent is ignored. nested override semantics from #187 still apply: a deeper ignore wins over a shallower include.

risks

• the rust side already handles missing includePaths gracefully (it's Option<Vec<String>> on both start_logic and set_watch_config from feat(ignore-paths): allow re-including subpaths of ignored directories #187), so older clients keep working.
• existing users start with an empty include list; behaviour is unchanged until they add something.
• no schema bump on this PR — the on-disk cache version was already bumped to 6 in feat(ignore-paths): allow re-including subpaths of ignored directories #187.

verified

npm test                                         # 244 passed
npm run format:check                             # clean (only pre-existing src-tauri/gen/* warnings remain)
npm run build                                    # ok
cargo check --workspace --all-targets            # ok
cargo check --all-targets   (in cardinal/src-tauri) # ok
cargo fmt --check                                # clean (both nightly-2025-12-11 and CI's nightly-2025-05-09)

new tests:

• useIncludePaths spec: defaults, hydrate, clean+persist, invalid-JSON fallback.
• useAppPreferences: include-paths-only change path drives setIncludePaths and setWatchConfig.
• PreferencesOverlay: save-include-paths, validation-blocks-save, include-paths reset to default.

[Copilot]

Pull request overview

Adds the frontend wiring for the previously introduced Rust include_paths capability, allowing users to configure “include paths” from Preferences and ensuring the config is sent to Tauri commands and persisted locally.

Changes:

• Introduces useIncludePaths (localStorage-backed) and threads includePaths through useAppPreferences into start_logic / set_watch_config.
• Extends PreferencesOverlay with an “Include paths” textarea (parse/validate/save/reset behavior aligned with ignore paths).
• Updates IPC typing (WatchConfigPayload) and adds i18n strings for includePaths across all locales, plus adds/updates related tests.

Reviewed changes

Copilot reviewed 23 out of 23 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
cardinal/src/utils/watchConfig.ts	Extends watch-config payload type to require includePaths.
cardinal/src/hooks/useIncludePaths.ts	New hook to persist/clean include paths in localStorage.
cardinal/src/hooks/useAppPreferences.ts	Reads include paths and sends them through start_logic and setWatchConfig; equality check updated.
cardinal/src/components/PreferencesOverlay.tsx	Adds include-paths textarea with validation + save/reset wiring.
cardinal/src/App.tsx	Passes includePaths/defaultIncludePaths props into PreferencesOverlay.
cardinal/src/hooks/tests/useIncludePaths.test.ts	New unit tests for include-paths persistence/cleanup/fallback behavior.
cardinal/src/hooks/tests/useAppPreferences.test.ts	Updates existing tests + adds include-paths-only change test.
cardinal/src/components/tests/PreferencesOverlay.test.tsx	Adds coverage for include-path save/validation/reset behavior.
cardinal/src/i18n/resources/ar-SA.json	Adds includePaths translations.
cardinal/src/i18n/resources/de-DE.json	Adds includePaths translations.
cardinal/src/i18n/resources/en-US.json	Adds includePaths translations.
cardinal/src/i18n/resources/es-ES.json	Adds includePaths translations.
cardinal/src/i18n/resources/fr-FR.json	Adds includePaths translations.
cardinal/src/i18n/resources/hi-IN.json	Adds includePaths translations.
cardinal/src/i18n/resources/it-IT.json	Adds includePaths translations.
cardinal/src/i18n/resources/ja-JP.json	Adds includePaths translations.
cardinal/src/i18n/resources/ko-KR.json	Adds includePaths translations.
cardinal/src/i18n/resources/pt-BR.json	Adds includePaths translations.
cardinal/src/i18n/resources/ru-RU.json	Adds includePaths translations.
cardinal/src/i18n/resources/tr-TR.json	Adds includePaths translations.
cardinal/src/i18n/resources/uk-UA.json	Adds includePaths translations.
cardinal/src/i18n/resources/zh-CN.json	Adds includePaths translations.
cardinal/src/i18n/resources/zh-TW.json	Adds includePaths translations.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[ldm0]

LGTM, awesome feature addition.

Found several existing issues though, but not related to current PR.