# 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.
