107 lines
4.1 KiB
Markdown
107 lines
4.1 KiB
Markdown
---
|
|
gsd_state_version: 1.0
|
|
milestone: v0.3
|
|
milestone_name: Reimagining Cloud Storage integration
|
|
current_phase: 12.1
|
|
current_phase_name: fix-nextcloud-root-listing-and-sync-visibility
|
|
status: executing
|
|
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: 8
|
|
percent: 17
|
|
---
|
|
|
|
# Project State
|
|
|
|
**Project:** DocuVault
|
|
**Status:** Ready to execute
|
|
**Last Updated:** 2026-06-22
|
|
|
|
## Current Position
|
|
|
|
Phase: 12.1 (fix-nextcloud-root-listing-and-sync-visibility) — EXECUTING
|
|
Plan: 3 of 4
|
|
Status: Ready to execute
|
|
Last activity: 2026-06-22 — Phase 12.1 execution started
|
|
|
|
## Phase Status
|
|
|
|
| Phase | Requirements | Status |
|
|
|-------|-------------|--------|
|
|
| 12. Cloud Resource Foundation | CONN-04, CLOUD-01, CLOUD-08, CACHE-01, CACHE-02, SYNC-01 | **Complete** |
|
|
| 12.1 Fix Nextcloud Root Listing and Sync Visibility | CONN-04, CLOUD-01, CACHE-01, SYNC-01 | **Planned** |
|
|
| 13. Virtual-Local Cloud Operations | CONN-01..03, CLOUD-02..07, CLOUD-09 | **Not started** |
|
|
| 14. Selective Analysis and Byte Cache | ANALYZE-01..07, CACHE-03..05 | **Not started** |
|
|
| 15. Unified Smart Search | SEARCH-01..07 | **Not started** |
|
|
| 16. Change Tracking and Reliability | SYNC-02..04 | **Not started** |
|
|
|
|
## Performance Metrics
|
|
|
|
| Metric | Value |
|
|
|---|---|
|
|
| Phases complete | 1 / 6 |
|
|
| Requirements satisfied | 6 / 36 |
|
|
| 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
|
|
|
|
### Key Decisions
|
|
|
|
*(Carries forward from v0.1 — see PROJECT.md for full decision log.)*
|
|
|
|
| Decision | Rationale |
|
|
|---|---|
|
|
| Options API preserved in v0.2 refactor | Composition API migration is scope-creep; refactor within Options API |
|
|
| Admin panel as standalone route subtree | AdminView as tabs-on-user-layout is architecturally wrong; v0.2 fixes this |
|
|
| No rewrites — refactor only | Preserve existing tests and behavior; change internal structure, not contracts |
|
|
| client.js barrel re-export pattern | Zero consumer churn; all 35+ import sites stay unchanged; mocks still work |
|
|
| Sub-routers carry NO prefix | Parent APIRouter prefix propagates — sub-routers with prefix cause double-segment URLs |
|
|
| AdminLayout as route component, not App.vue branch | Router resolves AdminLayout as the /admin component; its router-view renders children |
|
|
| to.matched.some() for requiresAdmin guard | Vue Router 4 does not inherit meta to children; direct to.meta check is a security regression |
|
|
| FastAPI 0.128+ empty-path sub-router restriction | `@router.get("")` on sub-router with empty include prefix fails; register root routes on parent aggregator |
|
|
| Vite 6 upgrade resolves 2 CVEs | CVE-2026-39363/39364 closed; npm audit now clean |
|
|
|
|
### Roadmap Evolution
|
|
|
|
- v0.1 completed: all 7 foundation phases + security hardening (2026-06-06)
|
|
- v0.2 completed: UI overhaul, admin panel rearchitecture, responsive layout, codebase quality (2026-06-17)
|
|
- v0.2 archived to `.planning/milestones/v0.2-ROADMAP.md`
|
|
- v0.3 proposed: virtual-local cloud operations, selective cloud analysis, bounded byte caching, unified smart search, and provider change tracking
|
|
- Phase 12.1 inserted after Phase 12: Fix Nextcloud root listing and sync visibility (URGENT)
|
|
|
|
### Open Questions
|
|
|
|
None.
|
|
|
|
### Blockers
|
|
|
|
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:37:54.128Z |
|
|
| Next action | Execute Phase 12.1 Plan 01 |
|
|
| Pending decisions | None |
|
|
| Resume file | None |
|
|
|
|
## Decisions
|
|
|
|
- [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
|