# v0.3 Research: Features

**Milestone:** v0.3 Reimagining Cloud Storage integration
**Date:** 2026-06-17

## Table Stakes

### Cloud-as-Local File Management

- Browse connected cloud folders with local-like row actions.
- Open/preview files through DocuVault authorization.
- Upload files into the visible cloud folder.
- Rename files and folders where provider supports it.
- Move files/folders within the same provider connection.
- Delete files/folders with explicit confirmation and audit logging.
- Create folders where provider supports it.
- Show unsupported actions disabled with a provider-aware reason.

### Provider Health and Maintenance

- Show connection health per provider.
- Detect expired/revoked credentials and guide reconnect.
- Invalidate folder/index caches after reconnect, delete, move, rename, or upload.
- Preserve credentials encryption and never expose secrets.
- Surface provider errors as actionable user-facing messages.

### Analyze Cloud Documents

- Analyze a selected file, selected folder, or whole provider connection.
- Track analysis progress: queued, downloading/caching, extracting, classifying, indexed, failed.
- Avoid duplicate analysis when provider item version/etag has not changed.
- Allow retry of failed items.
- Keep analysis non-destructive: analyzing a cloud file must not move or rewrite it.

### Smart Search Across Local and Cloud

- Search should cover local documents plus analyzed cloud documents.
- Keyword/sentence search uses extracted text.
- Idea/semantic search should be supported through embeddings if v0.3 includes semantic indexing.
- Search results identify source: local, OneDrive, Google Drive, Nextcloud, WebDAV.
- Opening a cloud result should hydrate bytes on demand if not cached.

### Storage Minimization

- Store provider metadata, extracted text, topics, and embeddings in DocuVault.
- Cache full file bytes only while needed for preview/extraction/open.
- Evict cached bytes by quota/TTL/LRU and never count transient cache bytes as user-owned imported storage.
- Keep an explicit user action for permanent import/copy to local DocuVault storage if implemented later.

## Differentiators

- Virtual-local status indicators: online-only, cached, analyzing, indexed, stale, error.
- Folder-level analyze action with recursive selection preview.
- Change detection via provider deltas where available, falling back to scheduled metadata refresh for WebDAV.
- Unified local/cloud search with filters for source, provider, folder, topics, status, and analyzed/not analyzed.
- Conflict-aware operations when provider etag/version changes between list and mutate.

## Anti-Features for v0.3

- Native desktop sync client.
- Offline-first web app for entire cloud drives.
- Cross-provider move/copy as a seamless operation.
- Real-time collaborative editing.
- Public link sharing.
- Automatic whole-cloud analysis without explicit user opt-in and cost warning.
