72 lines
3.5 KiB
Markdown
72 lines
3.5 KiB
Markdown
# Phase 12: Cloud Resource Foundation - Discussion Log
|
|
|
|
> **Audit trail only.** Do not use as input to planning, research, or execution agents.
|
|
> Decisions are captured in CONTEXT.md; this log preserves the alternatives considered.
|
|
|
|
**Date:** 2026-06-18
|
|
**Phase:** 12-cloud-resource-foundation
|
|
**Areas discussed:** Cloud navigation identity, Unsupported actions, Metadata freshness, Cloud item presentation
|
|
|
|
---
|
|
|
|
## Cloud Navigation Identity
|
|
|
|
| Question | Options considered | Selected |
|
|
|----------|--------------------|----------|
|
|
| First Cloud Storage screen | All connections as roots; provider picker; last-used connection | All connections as roots |
|
|
| Connection naming | Customizable name; provider and account; provider only | Customizable, defaulting to provider |
|
|
| Breadcrumb identity | Connection first; Cloud then connection; provider then connection | Connection first |
|
|
| Reopening a connection | Last visited; root; remember during session | Remember during session |
|
|
|
|
**Notes:** Multiple accounts from the same provider must be supported. Each account is a separate customizable root. A new browser session starts at that connection's root.
|
|
|
|
---
|
|
|
|
## Unsupported Actions
|
|
|
|
| Question | Options considered | Selected |
|
|
|----------|--------------------|----------|
|
|
| Unsupported action visibility | Disabled in place; hidden; limitations menu | Disabled in place |
|
|
| Touch explanation | Tap; adjacent info marker; long press | Tap |
|
|
| Explanation detail | Exact reason/remedy; provider-level reason; generic | Exact dynamic reason/remedy |
|
|
| Temporary versus permanent limits | Different states; same state; hide temporary | Different states |
|
|
|
|
**Notes:** Capability detection must be dynamic per connection. Use provider features, permissions, and safe checks; never mutate user files to test support. A future documentation link from tooltips was deferred.
|
|
|
|
---
|
|
|
|
## Metadata Freshness
|
|
|
|
| Question | Options considered | Selected |
|
|
|----------|--------------------|----------|
|
|
| Previously visited folder | Cached-first background refresh; wait for provider; manual refresh | Cached-first |
|
|
| Refresh visibility | Subtle folder indicator; silent unless failed; mark every row | Subtle folder indicator |
|
|
| External changes | Update with notice; update silently; ask before apply | Update silently |
|
|
| Refresh failure | Keep cached with warning; replace with error; hide warning | Keep cached with warning |
|
|
|
|
**Notes:** Show the last successful refresh time after failures and keep retrying with bounded, increasing delays.
|
|
|
|
---
|
|
|
|
## Cloud Item Presentation
|
|
|
|
| Question | Options considered | Selected |
|
|
|----------|--------------------|----------|
|
|
| Source repetition | Contextual only; provider icon per row; connection badge per row | Contextual only |
|
|
| Normal row metadata | Match local rows; analysis column; technical details | Match local rows |
|
|
| Byte availability | Compact status icon; text label; dedicated column | Compact status icon |
|
|
| Breadcrumb sync state | Three states; binary; activity only | Three states |
|
|
|
|
**Notes:** The breadcrumb shows refreshing, up-to-date, or warning state. Metadata does not consume document quota. Actual file bytes retained by DocuVault do consume quota until evicted; transient in-memory streaming does not.
|
|
|
|
---
|
|
|
|
## Claude's Discretion
|
|
|
|
- Exact iconography, accessible tooltip wording, warning styling, retry intervals, and duplicate-name disambiguation.
|
|
|
|
## Deferred Ideas
|
|
|
|
- Link capability tooltips to DocuVault documentation after a documentation flow exists.
|
|
- Permanent offline/downloaded copies remain a future phase rather than Phase 12 scope.
|