feat: add hidden files configuration with per-vault settings for includeHidden and hiddenWhitelist, supporting environment variables and UI controls for selective indexing of dot-prefixed files and folders

backend/main.py

@@ -44,6 +44,12 @@ from backend.indexer import (
 from backend.search import search, get_all_tags, advanced_search, suggest_titles, suggest_tags
 from backend.image_processor import preprocess_images
 from backend.attachment_indexer import rescan_vault_attachments, get_attachment_stats
+from backend.vault_settings import (
+    get_vault_setting,
+    update_vault_setting,
+    get_all_vault_settings,
+    delete_vault_setting,
+)
 
 logging.basicConfig(
     level=logging.INFO,
@@ -1385,6 +1391,104 @@ async def api_attachment_stats(vault: Optional[str] = Query(None, description="V
     return {"vaults": stats}
 
 
+# ---------------------------------------------------------------------------
+# Vault Settings API — Hidden files configuration
+# ---------------------------------------------------------------------------
+
+@app.get("/api/vaults/{vault_name}/settings")
+async def api_get_vault_settings(vault_name: str, current_user=Depends(require_auth)):
+    """Get settings for a specific vault including hidden files configuration.
+    
+    Args:
+        vault_name: Name of the vault.
+        
+    Returns:
+        Dict with vault settings including includeHidden and hiddenWhitelist.
+    """
+    if vault_name not in index:
+        raise HTTPException(status_code=404, detail=f"Vault '{vault_name}' not found")
+    
+    # Get current vault config from environment
+    vault_cfg = vault_config.get(vault_name, {})
+    
+    # Get persisted settings
+    persisted = get_vault_setting(vault_name) or {}
+    
+    # Merge with defaults
+    settings = {
+        "includeHidden": vault_cfg.get("includeHidden", False),
+        "hiddenWhitelist": vault_cfg.get("hiddenWhitelist", []),
+    }
+    settings.update(persisted)
+    
+    return settings
+
+
+@app.post("/api/vaults/{vault_name}/settings")
+async def api_update_vault_settings(vault_name: str, body: dict = Body(...), current_user=Depends(require_admin)):
+    """Update settings for a specific vault.
+    
+    Args:
+        vault_name: Name of the vault.
+        body: Dict with settings to update (includeHidden, hiddenWhitelist).
+        
+    Returns:
+        Updated settings dict.
+    """
+    if vault_name not in index:
+        raise HTTPException(status_code=404, detail=f"Vault '{vault_name}' not found")
+    
+    # Validate settings
+    settings_to_update = {}
+    
+    if "includeHidden" in body:
+        if not isinstance(body["includeHidden"], bool):
+            raise HTTPException(status_code=400, detail="includeHidden must be a boolean")
+        settings_to_update["includeHidden"] = body["includeHidden"]
+    
+    if "hiddenWhitelist" in body:
+        if not isinstance(body["hiddenWhitelist"], list):
+            raise HTTPException(status_code=400, detail="hiddenWhitelist must be a list")
+        # Validate each item is a string
+        if not all(isinstance(item, str) for item in body["hiddenWhitelist"]):
+            raise HTTPException(status_code=400, detail="All hiddenWhitelist items must be strings")
+        settings_to_update["hiddenWhitelist"] = body["hiddenWhitelist"]
+    
+    # Update persisted settings
+    updated = update_vault_setting(vault_name, settings_to_update)
+    
+    # Update in-memory vault config
+    if vault_name in vault_config:
+        vault_config[vault_name].update(settings_to_update)
+    
+    logger.info(f"Updated settings for vault '{vault_name}': {settings_to_update}")
+    
+    return updated
+
+
+@app.get("/api/vaults/settings/all")
+async def api_get_all_vault_settings(current_user=Depends(require_auth)):
+    """Get settings for all vaults.
+    
+    Returns:
+        Dict mapping vault names to their settings.
+    """
+    all_settings = {}
+    
+    for vault_name in index.keys():
+        vault_cfg = vault_config.get(vault_name, {})
+        persisted = get_vault_setting(vault_name) or {}
+        
+        settings = {
+            "includeHidden": vault_cfg.get("includeHidden", False),
+            "hiddenWhitelist": vault_cfg.get("hiddenWhitelist", []),
+        }
+        settings.update(persisted)
+        all_settings[vault_name] = settings
+    
+    return all_settings
+
+
 # ---------------------------------------------------------------------------
 # Configuration API
 # ---------------------------------------------------------------------------