Persist file categories on the index and classify archives and unknown types during idle maintenance.

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/Documentation.md

@@ -343,7 +343,22 @@ Classification **suggests** moves. Nothing moves until you Preview and Queue.
 
 Build output names (`node_modules`, `bin`, `obj`, `.vs`, and similar) are never moved. Online-only cloud items are skipped. Old installers (older than one year) still propose a move and show a warning. Destinations may sit *inside* the source folder (Downloads → Downloads\Software). Destinations are remembered in preferences.
 
-Never auto-reorganizes. No MIME/content sniffing (that would hydrate cloud files).
+Organize uses the **indexed category** when one exists (including ZIP contents that are mostly photos, and **Classify as…** overrides). Extension heuristics fill in the rest.
+
+Never auto-reorganizes. A light magic-byte peek for unknown extensions runs only during idle maintenance on local files — never on online-only cloud items.
+
+---
+
+## Classification
+
+The index stores a category on each entry (Photos, Video, Documents, Archive, and so on) plus a short reason.
+
+- Details shows a **Category** column (tooltip has the reason)
+- Search accepts `category:photos` or the category dropdown
+- Storage analysis has **By category** next to **By file type**
+- Context menu **Classify as…** writes a user override that later scans do not replace
+
+ZIP/7z files stay Archive until their contents are indexed; idle maintenance then promotes them when a category dominates.
 
 ---
 
@@ -416,7 +431,7 @@ Left open on purpose:
 - Multi-PC search, sharing, encrypted vaults
 - Robocopy as a second transfer engine
 - Scheduled profiles and folder-watcher triggers
-- MIME/EXIF classification
+- Full EXIF / ffprobe classification
 - Duplicate “backup copy” auto-tagging
 
 ---