curo/kite
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(13): add phase 13 planning artifacts — virtual local cloud operations

Browse Source 
Plans 01–11, CONTEXT, PATTERNS, RESEARCH, REVIEW-FIX, and updated
SUMMARY and CONTEXT for the virtual-local-cloud-operations phase.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
curo1305
2026-06-23 20:34:57 +02:00
co-authored by Claude Sonnet 4.6
parent 73328eee0b
commit b67e77dd69
16 changed files with 3114 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.planning/phases/13-virtual-local-cloud-operations/13-CONTEXT.md
+5
View File
@@ -37,6 +37,10 @@ Deliver owner-authorized connection maintenance and the main cloud file-manageme
- **D-15:** A timeout or temporarily unreachable provider is an unhealthy connection state only. Preserve credentials and cached metadata, show an actionable warning, and allow retry/reconnect; never delete data because of transient failure.
- **D-16:** Explicit user-initiated Disconnect requires confirmation, removes credentials and connection-scoped cloud metadata, and leaves all provider files untouched. Phase 13 has no byte cache to migrate.
### Provider access and preview scope
- **D-17:** Phase 13 requests broader Google Drive access rather than retaining the restricted `drive.file` scope, so authorized users can operate on existing Drive items throughout their connected storage. Consent copy and tests must make the expanded scope explicit.
- **D-18:** Phase 13 preview support is limited to supported binary file formats. Google Workspace and Microsoft Office document rendering/editing are excluded; unsupported formats use the ownership-checked authorized download fallback from D-02.
### Codex's Discretion
- Choose exact accessible dialog wording, progress labels, icons, and controlled provider-error translations while preserving the decisions above.
- Choose the bounded retry count for automatic collision suffixing and safe provider-specific mechanics for trash versus permanent delete.
@@ -119,6 +123,7 @@ Deliver owner-authorized connection maintenance and the main cloud file-manageme
## Deferred Ideas
- Phase 14 must place bytes used for in-app cloud preview into DocuVault's temporary cache and remove them through normal cache eviction/clearing; preview must not become a browser-to-device download.
- A future phase will add Office document rendering/editing through Collabora running in a separate internally accessible container; Phase 13 must not introduce Collabora, Google Workspace export preview, or Office-native preview plumbing.
- Future `IMPORT-01`: on explicit disconnect, convert cached/downloaded cloud files into local DocuVault documents under a folder named after the connection's current display name, preserve the cloud hierarchy, continue counting those bytes toward quota, and leave provider files untouched. This is a permanent import capability and remains outside Phase 13 and the current v0.3 scope.
</deferred>