docs(12.1-02): complete plan 02 summary and state updates

.planning/STATE.md

@@ -5,14 +5,15 @@ milestone_name: Reimagining Cloud Storage integration
 current_phase: 12.1
 current_phase_name: fix-nextcloud-root-listing-and-sync-visibility
 status: executing
-last_updated: "2026-06-22T06:19:49.338Z"
+stopped_at: Completed Phase 12.1 Plan 02 — truthful freshness gate
+last_updated: "2026-06-22T06:37:54.133Z"
 last_activity: 2026-06-22
 last_activity_desc: Phase 12.1 execution started
 progress:
   total_phases: 6
   completed_phases: 1
   total_plans: 10
-  completed_plans: 7
+  completed_plans: 8
   percent: 17
 ---
 
@@ -25,7 +26,7 @@ progress:
 ## Current Position
 
 Phase: 12.1 (fix-nextcloud-root-listing-and-sync-visibility) — EXECUTING
-Plan: 2 of 4
+Plan: 3 of 4
 Status: Ready to execute
 Last activity: 2026-06-22 — Phase 12.1 execution started
 
@@ -49,6 +50,7 @@ Last activity: 2026-06-22 — Phase 12.1 execution started
 | Plans complete | 6 / 10 |
 | Tests at milestone start | 277 |
 | Phase 12.1 P01 | 823 | 4 tasks | 14 files |
+| Phase 12.1 P02 | 2100 | 3 tasks | 13 files |
 
 ## Accumulated Context
 
@@ -86,11 +88,13 @@ None.
 
 ## Session Continuity
 
+**Stopped at:** Completed Phase 12.1 Plan 02 — truthful freshness gate
+
 _Updated at each phase transition._
 
 | Field | Value |
 |---|---|
-| Last session | 2026-06-22T06:19:43.071Z |
+| Last session | 2026-06-22T06:37:54.128Z |
 | Next action | Execute Phase 12.1 Plan 01 |
 | Pending decisions | None |
 | Resume file | None |
@@ -99,3 +103,4 @@ _Updated at each phase transition._
 
 - [Phase ?]: Remove NextcloudBackend.list_folder override — inherit canonical WebDAVBackend method
 - [Phase ?]: OneDrive nextLink restricted to graph.microsoft.com host
+- [Phase ?]: apply_listing_and_finalize is the single freshness gate — callers must not set refresh_state=fresh independently after list_folder