# GOOGLE.md — Alignement Google ecosystem > **Statut :** 2026-05-17 — aligned production-grade cross-platform. > Ce document remplace l'ancienne version « God Mode » par une description factuelle > des points d'alignement avec les écosystèmes Android, Chromium et Fuchsia. --- ## 1. Alignement Canary Le projet suit officiellement les branches **Canary** des écosystèmes Google : - **Chrome Canary** (`Google.Chrome.Canary` via WinGet) — référence pour le rendu web. - **Android Studio Canary** (`Google.AndroidStudio`) — IDE de référence. - **Cloud SDK** (`gcloud`, `gsutil`, `bq`) — déploiement. - **Rust nightly** (mirror du canal Chromium `tools/rust/` (not in repo)) — toolchain unique. Catalogue Google complet : voir `google.json`. ## 2. Trinity Architecture (HISTORIQUE — abandonnée) > **OBSOLÈTE.** La « Trinity Architecture » (God Mode / Google OS / kernel > hybride NT + fork C++ de Windows Terminal) a été **abandonnée au pivot > 2026-05-17** (cf. [`SOURCE_OF_TRUTH.md`](./SOURCE_OF_TRUTH.md) §7). Les crates > `bun_ffi`, `gui` et `google_os` ont été supprimés/archivés. État réel : un > cœur 100 % Rust cross-platform (`crates/infra/aphrody`, `base`, `backend`, …) + une > bibliothèques Material Design 3 en Bun/TS (`packages/*`). Table > conservée pour mémoire historique uniquement. | Pilier (historique) | Tech | Rôle (abandonné) | |---|---|---| | **I. Rust Core** | `crates/infra/aphrody`, `base`, `backend` (`bun_ffi`/`gui`/`google_os` supprimés) | Binaire principal cross-platform, FFI zero-copy | | **II. Native Terminal** | C++ `Microsoft.WindowsTerminalCanary` (Windows uniquement) | ❌ fork abandonné — terminal LLM-first en Rust pur | | **III. Bun + MD3** | `packages/*` (`@aphrody-code/*`) | Bibliothèques UI du monorepo M3 Bun + Turborepo | **Axe principal cross-platform actuel** : le cœur Rust (`crates/infra/aphrody`) — voir [`docs/reference/ai/cargo/CROSS_PLATFORM.md`](./cargo/CROSS_PLATFORM.md). ## 3. Patterns adoptés depuis Google | Source | Pattern | Notre implémentation | |---|---|---| | **Android Soong** | `rust_library` + `rustlibs:` | `[workspace.dependencies]` + workspace inheritance | | **Android Soong** | `rust_ffi` (cdylib+rlib) | `crate-type = ["cdylib", "rlib"]` | | **Android Soong** | `lints: "android"` | Preset `android-strict` opt-in per-crate | | **Android NDK** | Cross-compile pour Android | `cargo ndk` + 4 targets Android dans `rust-toolchain.toml` | | **Chromium** | Memory-safe untrusted-data handling | Tout nouveau code en Rust (cf. CLAUDE.md) | | **Chromium** | `cxx` primary FFI | `cxx` + `bindgen` dans `[workspace.dependencies]` | | **Chromium** | Pinned toolchain (`tools/rust/` (not in repo)) | `rust-toolchain.toml` nightly pinné | | **Fuchsia** | `cargo-vet` + critères `ub-risk-*` | `supply-chain/audits.toml` avec ub-risk-0/1/2/3 | | **Fuchsia** | `safe-to-deploy` default | `cargo deny check` requis avant merge | | **ChromeOS** | Imports d'audits cross-project | `supply-chain/config.toml` import Google/Mozilla/Fuchsia/ChromeOS | Détails : [`docs/reference/ai/cargo/CHROMIUM_ANDROID_PATTERNS.md`](./cargo/CHROMIUM_ANDROID_PATTERNS.md). ## 4. Hardware acceleration - **Rust UI surfaces** (Pilier I) : backed by native Direct3D 11/12 sur Windows via `windows-rs Win32_Graphics_*`. Sur Linux/macOS, fallback CPU pour `cli` (pas de rendu graphique). - **Web tier** (Pilier III) : Chromium GPU Process via `Chrome SxS\chrome.exe (Canary)`, WebGPU + WebGL forced active. ## 5. Privilèges système (Windows-only, `google_os`) Le crate `google_os` (Windows-only, `#![cfg(windows)]`) expose les capacités suivantes via `windows-rs` : - **Firewall bypass** : `HNetCfg.FwPolicy2` COM injection. - **Token privileges** : `SeDebugPrivilege`, `SeTakeOwnershipPrivilege`, `SeBackupPrivilege`, `SeRestorePrivilege`. - **DPAPI decryption** : extraction des cookies/passwords Chromium (cf. `crates/aphrody-backend/src/chromium.rs` (not in repo)). - **NTDLL direct** : `NtSetInformationFile` (FileDispositionInformation) pour suppression atomique (cf. `docs/google-os-plan/ntdll_bypass.md` (not in repo)). **Politique :** ces capacités sont disponibles UNIQUEMENT sur Windows et UNIQUEMENT depuis du code Rust auditté. Pas d'exposition au tier Bun/JS. ## 6. Workflow contributeurs Ordre de lecture pour tout nouveau contributeur : 1. [`README.md`](../../products/ai/README.md) — entrée du projet. 2. [`CLAUDE.md`](./CLAUDE.md) — directives techniques Rust/C/FFI. 3. [`GEMINI.md`](./GEMINI.md) — directives stratégiques. 5. [`docs/reference/ai/cargo/CHROMIUM_ANDROID_PATTERNS.md`](./cargo/CHROMIUM_ANDROID_PATTERNS.md) — alignement Google. 6. [`docs/reference/ai/cargo/CROSS_PLATFORM.md`](./cargo/CROSS_PLATFORM.md) — axe principal. ## 7. Typography (UI Pilier III) - **`Google Sans Flex`** (variable, opsz, wght) — UI principale. - **`Google Sans Mono`** — code et terminal. - **`Google Sans Text`** — long-form reading. Source : Material Design 3 + Google Workspace Sans guidelines. ## 8. Outils Google externes utilisés Liste exhaustive dans `google.json`. Synthèse : | CLI | Provider | Rôle dans le projet | |---|---|---| | `gcloud` | Google Cloud SDK | Auth GCP, déploiement | | `dart` | Dart SDK | Compilateur AOT (référence) | | `firebase` | Firebase CLI | Backend services | | `protoc` | Protocol Buffers | Sérialisation IPC (cf. `a2a-pb`) | | `flatc` | FlatBuffers | Sérialisation zero-copy | | `adb`, `fastboot` | Android Platform-Tools | Android debugging | | `osv-scanner` | Google OSV | Audit vulnérabilités SBOM (post-`cargo-auditable`) | | `perfetto` | Google Perfetto | Tracing système | | `magika` | Google Magika | File type detection (build pipeline) | --- *Pour la trajectoire complète et les phases livrées, voir [`docs/PLAN.md` (not in repo)](../../plans/ai/PLAN.md).*