google-drive-backup

Maintain Google Drive backups for durable Zustand user data in MSD Tracker. Use when adding, changing, renaming, or removing durable store fields; changing backup selection or legacy normalization; updating backup timestamps; or changing sync-conflict metadata and UI.

Jump to install

Repository: iamdevlinph/msd-tracker
Last source activity: July 29, 2026 at 02:40
Detected SKILL.md language: English
Stars: 1
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/iamdevlinph/msd-tracker --skill google-drive-backup

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

2 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

Google Drive Backup

Treat Google Drive backup as an explicit allowlist. Zustand persistence does not add fields to Drive automatically.

Decide Eligibility

Sync user-created or configured data expected to survive device changes or local-storage loss.

Keep transient UI state, hydration flags, authentication/session data, and rebuildable caches out of the backup.

Ask the user before including or omitting a durable field when intent is unclear.

Update the Contract

Read the owning store slice, src/stores/app-store.ts, src/components/account/google/utils/drive-sync.ts, and the sync-conflict components and tests before editing.

Add a backward-compatible initial value for new durable state. Preserve existing persisted and remote backups when fields are missing.

Update every user mutation, deletion, and reset for the field to set backupUpdatedAt: Date.now(). Do not bump the timestamp for hydration, remote restore, or transient sync state.

Add the field to Backup and select(...) in drive-sync.ts. Keep auth tokens, sync flags, and actions out of the payload.

Normalize missing legacy download data to a safe default. Treat field removal or renaming as a compatibility change and provide an explicit migration path.

Extend StoreState["syncConflict"], both local and remote metadata builders, and SyncCopyCard with a useful summary when the new data should help users choose a copy.

Verify that keeping the remote copy restores the field and keeping the local copy uploads it.

Verify Behavior

Test that select(...) includes the field and excludes unrelated state.

Test legacy downloads with the field absent.

Test create, edit, delete, and reset actions update backupUpdatedAt.

Test local and remote conflict metadata plus conflict-card rendering when changed.

Mock Google Drive, session storage, timers, and browser boundaries; never use live tokens or remote files in tests.

Run the smallest affected Vitest files first, then the repository's broader pnpm test, pnpm run check, and pnpm build checks for shared-state changes.

Keep database, dependency, deployment, secret-handling, and destructive-operation restrictions in AGENTS.md authoritative.