brand: document searchi identity and add reusable logo masters

docs/BRAND.md

@@ -0,0 +1,45 @@
+# searchi identity
+
+Approved direction, 2026-10-12: lowercase **searchi**. Positioning: a fast,
+private, cross-platform desktop search application. Tagline:
+**Find what matters. Locally.**
+
+| Token | Value | Use |
+| --- | --- | --- |
+| Brand blue | `#2563FF` | Mark, focus, primary action, selection accents |
+| Dark | `#0B0F14` | Dark base and dark wordmark |
+| Light | `#F8FAFC` | Light base and reversed wordmark |
+| Typography | Inter / Geist | Locally bundled UI font; system fallback |
+| Style | Flat, geometric, minimal | Restrained surfaces and clear hierarchy |
+
+The S-shaped search symbol is the recognizable identity. Reuse the master assets
+from assets/brand rather than approximating the mark with text or a search glyph.
+Use a symbol-only icon at small sizes; pair it with the lowercase wordmark when
+space permits. Keep clear space, preserve proportions, and avoid decorative
+gradients, shadows inside the mark, or stretching. OS icon masks and window
+materials may add platform-specific presentation around the flat identity.
+
+## Desktop direction
+
+The user selected the first search-and-preview concept and requested a mix with
+Raycast: compact, keyboard-first search with a grouped result list on the left
+and a readable passage preview on the right. Search is dominant; settings,
+filters, and model details use progressive disclosure. Use native window chrome,
+dialogs, theme behavior, and platform shortcut labels.
+
+Apply brief selection/preview transitions without delaying retrieval or input.
+Respect reduced motion and forced colors. Preserve focus, selection, and scroll
+when semantic results arrive. Preview only real extracted content and supported
+locations; do not fabricate document pages, confidence percentages, or metadata.
+
+## Distribution and copy
+
+Use the same master icon for Tauri app icons and repository avatar. The wordmark
+and symbol can also be reused on a future website; no website publication is
+authorized by adding these assets. CLI output remains readable plain text with
+the lowercase searchi name, without mandatory color or ASCII logo art.
+
+The brand board's example `searchi winter.pdf` is illustrative. Documentation
+must show the actual supported CLI syntax. Model downloads require networking;
+file extraction, inference, and search remain local. Never turn visual marketing
+copy into unsupported performance or production-readiness claims.

docs/VALIDATION.md

@@ -3,6 +3,26 @@
 Development host: Windows VM, x86_64 MSVC, Rust stable 1.99.0.
 All local tests run on CPU; no GPU provider is configured.
 
+## Current integration checkpoint (2026-10-12)
+
+- `cargo test --workspace --locked`: 39 default tests passed. Four asset-dependent
+  or explicit benchmark tests remain opt-in; a default pass does not run them.
+- Native desktop tests: 7 passed with SEARCHI_FORCE_CPU=1 and WebView2 GPU disabled.
+- Frontend: 7 async-state tests passed, Prettier passed, TypeScript/Vite build passed.
+- Genuine Google CPU reference/window test passed separately: five DigUp reference
+  vectors had cosine similarity above 0.999; actual multilingual retrieval and
+  tokenizer tail-window coverage passed. MiniLM evidence below is historical.
+- Repository description/topics were read back after update; the branded avatar
+  upload returned HTTP 204 and the repository API returned its avatar URL.
+- New desktop styling is in progress. `design-qa.md` records the visual gate as
+  blocked because browser bootstrap and native screen capture are unavailable.
+  No visual match or complete UI interaction verification is claimed.
+
+The active parallel development branches of work may add tests or change counts
+after this checkpoint. Run the documented checks again after integration.
+
+## Historical foundation evidence
+
 Initial foundation checks (2026-10-12):
 - `cargo test --workspace`: CLI parser/executable checks and engine retrieval,
   lifecycle, exclusions, filters, migration and concurrent-reader checks passed.