Files
kite/.planning/research/FEATURES.md
T

2.9 KiB

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.