gws-sync

gws-sync: local → Drive one-way proposal-based sync

Design principles: (1) One-way (local → Drive) only, never pull Drive-side changes back to local. (2) Proposal-based: every write happens only after a diff report plus user approval. (3) Never delete automatically (proposal only). (4) Updating a Drive file is a content update of the existing file, not a new-file creation (the file ID is kept, so share links and version history survive).

0. Prerequisite check (every run)

1. gws --version: if missing, stop and print install guidance: "gws CLI가 필요합니다. 설치: npm install -g @googleworkspace/cli 또는 공식 문서 github.com/googleworkspace/cli 참조. 설치 후 첫 사용이면 gws auth setup(1회) → gws auth login으로 인증하세요(gcloud 미설치 환경은 공식 README의 수동 OAuth 설정 참조)." (Do not install automatically, propose only.)
2. Confirm auth and scope: if a light read call (gws drive files list --params '{"pageSize": 1}') fails, print auth guidance and stop: gws auth setup on first use, gws auth login thereafter. A successful read does not guarantee write scope: if the upload/update step hits a permission error, guide the user to re-authenticate with the drive write scope (e.g. gws auth login --scopes drive; confirm the exact flag with gws auth --help). Never assume write access from a read check alone.
3. Suggest useful skills (optional): if the task matches another gws skill/recipe in the catalog (e.g. share with the team after upload → recipe-share-folder-with-team), find it in references/gws-skills-llms.txt and print an install-suggestion line alongside. Confirm the exact install command form with the current skills CLI before presenting it (use the form in references/gws-skills-llms.txt verbatim, or if unconfirmed just say "설치 방법은 skills CLI로 확인하세요"). Suggest only, never force.

1. Mapping config file: .gws-sync.json

Remember the mapping at the local repo root (or a user-specified location):

{
  "mappings": [
    {
      "local": "projects/deck-a/exports",
      "driveFolderId": "1aQthLJ...",
      "driveFolderPath": "강의교안/exports",
      "include": ["*.pptx", "*.pdf"],
      "files": { "deck.pptx": "1eon6SX..." }
    }
  ]
}