Skip to content

docs: zgodność dokumentacji z kodem (szyfrowanie, release, przykładowy config) - #62

Open
renacode-vps[bot] wants to merge 1 commit into
mainfrom
docs-zgodnosc-2026-11-15
Open

renacode-vps[bot] wants to merge 1 commit into
mainfrom
docs-zgodnosc-2026-11-15

Conversation

@renacode-vps

@renacode-vps renacode-vps Bot commented Nov 15, 2026

Copy link
Copy Markdown

Przegląd dokumentacji i opisów repo pod kątem zgodności z kodem na origin/main (zlecenie właściciela z 15.11.2026).

Dostawca AI: repo nie korzysta z żadnego modelu AI (brak Gemini/Anthropic/OpenAI w kodzie i dokumentacji) — nic do poprawy w tym zakresie. Nie ma tu też polityki prywatności ani tekstów i18n opisujących dostawcę AI.

Poprawki

Plik Było Jest Dowód w kodzie
README.md (Current limitations) „No client-side encryption. … Do not use it for data you may not hand to Google” Szyfrowanie po stronie klienta istnieje, jest opcjonalne i tylko z Terminala: cloudmachine-agent vm-encrypt (setup, copy, switch, delete-plain, rollback), rclone crypt w gdrive:CloudMachine/<folder>-crypt, hasło i sól w Keychain; domyślnie bez szyfrowania; okno aplikacji tego nie oferuje mac-app/Sources/CloudMachineAgent/EncryptCommands.swift, CloudMachineAgent.swift:25 (VMEncrypt.self), CloudMachineCore/DriveEncryption.swift:1-35, 609-655; brak vm-encrypt w CloudMachineApp/
packaging/README.md (Releases) Release wyzwalają mac-app/Sources, Resources, Package.*, VERSION, launchd/, config/, szablon casku Dodane vm/ (szablon maszyny jest w aplikacji) .github/workflows/release.yml on.push.paths zawiera "vm/**"; BuildAppCommand.swift:136 kopiuje vm/ do bundla
packaging/README.md (Releases) „A vX.Y.Z tag pushed by hand releases exactly that version.” …tylko gdy commit z tagiem jest na main, inaczej job się wywraca; „Run workflow” poza main to dry run release.yml:19-24, 103-111 (merge-base --is-ancestor … origin/main)
config/machines.example.json (_comment) „Copy this file to machines.json and adjust it… both Macs…” machines.json w ~/Library/Application Support/CloudMachine/ tworzy aplikacja; używane jest tylko limit_gb, ustawiane set-limit --gb N / kartą, zapisywane pod nazwą folderu Drive tego Maca ConfigStore.swift:81-91 (save(.empty)), CMPaths.swift:71-78, MachineBudget.swift:1-13, 37-45, 66-80
config/machines.example.json (_bwlimit_comment) „Upload speed limit in Mbps… per-Mac” Pole czytane, nieużywane (brak --bwlimit; SMB dławione w maszynie przez vm/smb-throttle.sh); drive_total_gb, safety_margin_percent, remote_name, remote_root_folder też nieużywane — remote jest stały w kodzie (gdrive:CloudMachine) grep .bwLimitMbps/.driveTotalGB/… — użycia tylko w MachinesConfig.swift; DriveFolder.swift:17-19; vm/systemd/rclone-tm.service bez --bwlimit
mac-app/Sources/CloudMachineCore/MachinesConfig.swift (tylko komentarz ///) bwLimitMbps „passed as --bwlimit … CloudArchiveService.bwLimitArgs … Used by the cloud archiving layer” Czytane dla zgodności, nigdzie nieużywane; CloudArchiveService już nie istnieje grep CloudArchiveService — jedyne trafienie to ten komentarz

Klucze i wartości w machines.example.json bez zmian, więc MachinesConfigTests.testDecode_realExampleConfigFileParsesCorrectly nadal przechodzi (zmienione tylko pola _comment, JSON zwalidowany).

Sprawdzone i zgodne (bez zmian)

README.md: wymagania (macOS 14 — Package.swift, Info.plist; Apple silicon — vm/cmsmb.yaml arch: aarch64; dysk 200 GiB, bufor 120G), 22 języki + CM_LANGUAGE, kolejność kroków (SetupPlan.swift), 32 MB bandy, limit 750 GB, kwota 70% i alarm od 90% (MachineBudget.swift), prepare-shutdown 30 min (VMShutdown.swift), wycofane agenty (AgentRepair.swift:34), mac-studio (DriveFolder.swift:22), drive.file, --drive-use-trash=false. vm/README.md: progi guarda 110/40/40 GiB, StartInterval 60, tm-meta-sync co 15 min, ExitTimeOut 120, rc na 127.0.0.1:5572, portForwards ignore. vm/punchfs/README.md, THIRD-PARTY-NOTICES.md (swift-argument-parser 1.8.2, pakiety apt, sumy SHA256 rclone), nagłówki unitów systemd, szablonów launchd i workflowów. Cask desc „Time Machine backups to Google Drive” — aktualny.

Teksty prawne — do akceptacji właściciela

Brak zmian. LICENSE, THIRD-PARTY-NOTICES.md, sekcje Licence i Trademarks w README.md są zgodne z kodem i nie zostały ruszone.

Uwagi

  • Zmiana w config/ i komentarz w mac-app/Sources/ pasują do paths w release.yml, więc scalenie wyda nowy patch release (bez zmian w działaniu). Jeśli to niepożądane, można wyrzucić z PR-a te dwa pliki.
  • Testy: lokalnie .github/test-release-workflow.sh — ALL OK. swift-format lint/swift test wymagają macOS (VPS to Linux) — weryfikuje CI tego PR-a; zmiana Swift dotyczy wyłącznie komentarza.
  • Opis repo na GitHubie (pole description) opisuje stary układ (FUSE-T na Macu) — propozycja nowego przekazana koordynatorowi.

🤖 Generated with Claude Code

- README: client-side encryption exists (vm-encrypt, rclone crypt, CLI only);
  the limitation said there was none.
- packaging/README: vm/ changes are released too (release.yml paths); Run
  workflow off main is a dry run; a tag releases only when its commit is on main.
- machines.example.json / MachinesConfig: only limit_gb is used, keyed by the
  Drive folder; bwlimit_mbps and the other top-level fields are read and unused
  (CloudArchiveService no longer exists).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant