SPB Git

Repository Public

10 entries at the root
History

Latest commit docs: 3.0.0 release record 07e7b28

NameLast commitUpdated
Assets Step A: environment audit inputs, core domain layer, brand assets, 82 unit tests
docs docs: 3.0.0 release record
Mobile iOS and iPadOS: AURA integration — floating bar, Orbit and palette, Constellation, Peek on...
scripts Focus Mode floats over the page, constellation spacing, French strings for AURA, PID-safe perf...
SPBrowser 3.0.0: ambient glows at quarter resolution, test report, README, Liquid capture; release...
SPBrowser.xcodeproj Ambient motion runs on the Mac (window activity, not scene phase) at 20 fps; 3.0 doc, Mac...
.gitignore SP Browser for iPhone and iPad (Mobile/), French strings, localization checker covers iOS,...
Package.swift Step A: environment audit inputs, core domain layer, brand assets, 82 unit tests
project.yml Focus Mode floats over the page, constellation spacing, French strings for AURA, PID-safe perf...
README.md 3.0.0: ambient glows at quarter resolution, test report, README, Liquid capture; release...
README.md View source
SP Browser logo



SP Browser icon

# SP Browser

Navigateur web natif pour macOS, iPhone et iPad : Swift 6, SwiftUI (+ AppKit sur Mac), rendu par WebKit. Recherche SP Search intégrée, compte à clés d'accès, synchronisation SP Sync chiffrée de bout en bout — aucune télémétrie.

Author: Simon-Pierre Boucher

service version macOS iOS langues licence author

Swift concurrence SwiftUI AppKit WebKit SQLite CryptoKit passkeys App Intents SwiftPM XcodeGen API privées dépendances télémétrie

commits last commit activity language languages size branches tags clones

fichiers Swift lignes Swift cibles tests du cœur tests macOS tests iOS chaînes localisées moteurs collections documents captures

bundle signature notarisation TestFlight domaine associé universel cibles de déploiement outils


Page de démarrage

# Nouveautés de la 3.0 « AURA »

SP Browser 3.0 fait évoluer la 2.0 sans la réécrire : même moteur, même SP Search, même compte à clés d'accès, même synchronisation chiffrée. S'y ajoutent un design system partagé par le Mac, l'iPhone et l'iPad (AURA UI), un moteur d'animation à jetons, et des surfaces nouvelles : Tab Constellation, Peek (aperçu de lien sans cookies ni scripts), Flow (le parcours entre les pages), Canvas, Command Orbit, Focus Mode avec Focus Trail, Portal (appareils et transfert d'onglets) et Ambient Home.

Document Contenu
docs/SP_BROWSER_3.md ce qui est nouveau, ce qui est amélioré, vie privée, migration, limites
docs/SP_BROWSER_3_AUDIT.md audit de la 2.0 avant travaux
docs/AURA_DESIGN_SYSTEM.md jetons, matériaux, composants, mouvement
docs/TEST_REPORT.md tests, performances mesurées, ce qui n'a pas été vérifié

Ambient Home, thème Cosmos Tab Constellation

# Sommaire


# 🎯 Vue d'ensemble

Navigateur web natif pour macOS, iPhone et iPad : Swift 6, SwiftUI (+ AppKit sur Mac), rendu par WebKit. Interface en français et en anglais.

Version 2.0 : recherche SP Search intégrée (résultats natifs Tout · Images · Vidéos), compte à clés d'accès (Touch ID / Face ID), synchronisation SP Sync chiffrée de bout en bout (historique, signets, favoris, onglets, liste de lecture, recherches) et application iOS native (Mobile/). Vue d'ensemble : docs/SP_BROWSER_2.md.

SP Browser utilise le moteur WebKit du système : la compatibilité des sites est celle de WebKit. Tout le reste — fenêtres, onglets, espaces de travail, profils, signets, historique, téléchargements, bloqueur, palette de commandes — est du code natif propre au projet. SP Browser n'est pas un moteur web et n'utilise aucune API privée.

# Famille SP Browser

Dépôt Plateforme Rôle
sp-browser (ce dépôt) macOS 14+ · iOS / iPadOS 18+ Les deux applications natives (cibles SPBrowser et SPBrowserMobile du même projet), cœur partagé SPBrowserCore — version 2.0.0 (2)
sp-browser-backend API web — browser.spboucher.ai SP Search (POST /api/search), SP Identity (clés d'accès WebAuthn, sessions, appareils), SP Sync (flux de changements chiffré de bout en bout)
text
 SP Browser macOS ─┐                       ┌─ Tavily (recherche web, images des pages)
                   ├── HTTPS ── browser.spboucher.ai ──┼─ Wikimedia Commons (images libres)
 SP Browser iOS  ──┘      (sp-browser-backend)         └─ oEmbed YouTube / Vimeo / Dailymotion
                           │
                           ├─ SP Search    POST /api/search
                           ├─ SP Identity  clés d'accès WebAuthn, sessions, appareils
                           └─ SP Sync      flux de changements chiffré de bout en bout

Sans compte, rien n'est synchronisé et SP Browser fonctionne entièrement en local, à l'exception des recherches SP Search que vous lancez (voir docs/PRIVACY.md). Le backend a son propre dépôt et sa propre documentation (README.md, docs/SECURITY.md, docs/OPERATIONS.md).

# Ce que la 2.0 change par rapport à la 1.0

Sujet 1.0.0 2.0.0
Plateformes macOS macOS + iPhone + iPad (Mobile/)
Moteur par défaut DuckDuckGo SP Search, page de résultats native (spsearch://)
Compte aucun facultatif, clés d'accès (WebAuthn), sur code d'invitation
Synchronisation aucune SP Sync chiffré de bout en bout, 8 collections
Page de démarrage 6 sections favoris, fréquents, récents, recherches, autres appareils, liste de lecture, personnalisation, arrière-plans
Tests 82 + 29 110 (cœur) + 35 (macOS) + 7 + 3 (iOS)
Chaînes localisées 624 889 (macOS + iOS)
Identifiant du build Debug macOS ai.spboucher.spbrowser ai.spboucher.spbrowser.debug (cohabite avec l'app installée)

# 📸 Captures

Captures des applications réelles (docs/screenshots/ : macOS pilotée au clavier ; docs/screenshots/ios/ : simulateurs iPhone 17 Pro et iPad Pro 13").

Palette de commandes ⌘K Vue scindée
Palette de commandes Vue scindée
Fenêtre privée Informations sur la page
Fenêtre privée Informations sur la page
Réglages (macOS) Réglages

iPhone

Démarrage SP Search — Tout Images Vidéos
iPhone — démarrage iPhone — résultats iPhone — images iPhone — vidéos
Onglets Navigation privée Compte Réglages
iPhone — onglets iPhone — privé iPhone — compte iPhone — réglages
iPad (7 captures)
Démarrage SP Search — Tout
iPad — démarrage iPad — résultats
Images Vidéos
iPad — images iPad — vidéos
Onglets Compte Réglages
iPad — onglets iPad — compte iPad — réglages

# 💿 Installer

macOS. Ouvrir dist/SPBrowser.dmg (produit par scripts/notarize.sh) et glisser SP Browser dans Applications. L'application est signée Developer ID et notarisée par Apple (voir docs/RELEASE.md). macOS 14 ou ultérieur ; testée sur macOS 27.0 uniquement.

Version Image disque SHA-256
2.0.0 (2) dist/SPBrowser.dmg (4,8 Mo), notarisée et agrafée — pas encore déposée sur spbgit au moment d'écrire ce README 2b6ae7fc9247191e2308cd765c9077e09bda020edbe2a4439ccdec33da227d3f
1.0.0 (1) SPBrowser.dmg (3,6 Mo), tag v1.0.0 641bf0a0c900a1c218a3c5e3459b126dc440195d917e9228a2318186d559058d

iOS / iPadOS. iOS 18 ou ultérieur. Distribution par App Store Connect / TestFlight (fiche « SP Browser », id 6836530354, groupe interne « Interne ») ; aucune soumission à la revue de l'App Store n'a été faite.

Compte (facultatif). La création d'un compte demande un code d'invitation, émis sur le nœud du backend (node scripts/invite.ts create, dépôt sp-browser-backend).

# ✨ Ce qu'il fait

  • Navigation : barre d'adresse et de recherche unifiée, suggestions locales, 9 moteurs et raccourcis de recherche (w montréal) en plus de SP Search, état HTTPS, domaine réel mis en évidence.
  • SP Search (2.0) : moteur par défaut, page de résultats native en trois modes — Tout · Images · Vidéos —, filtre de date, filtre de plateforme vidéo, grille ou liste, résumé par IA du fournisseur (étiqueté comme tel), « Plus de résultats » et chargement à l'approche de la fin.
  • Onglets : horizontaux ou verticaux, épinglés, groupes, vue scindée, recherche, réouverture, suspension automatique des onglets inactifs, restauration de session.
  • Espaces de travail et profils : chaque profil a ses propres cookies, connexions, historique et signets.
  • Compte SP Identity (2.0, facultatif) : clé d'accès Touch ID / Face ID, aucun mot de passe ; appareils, sessions, clés supplémentaires, clé de récupération, suppression du compte.
  • SP Sync (2.0) : historique, signets, favoris, onglets ouverts et fermés, liste de lecture, recherches et préférences, chiffrés sur l'appareil ; file d'attente hors ligne ; onglets des autres appareils.
  • Navigation privée : rien d'écrit sur le disque, session séparée, jamais synchronisée, limites expliquées à l'écran.
  • Confidentialité : bloqueur de traqueurs et de publicités, permissions par site, effacement par site, aucune télémétrie.
  • Outils : palette de commandes ⌘K, lecteur, notes par page, informations de page (certificat, cookies), source et métadonnées, sessions nommées, raccourcis configurables.
  • SP Intelligence (facultatif, désactivé par défaut) : résumé, explication, traduction, questions sur la page avec votre propre modèle — local ou par clé d'API — après validation d'un aperçu de ce qui est envoyé.
  • iPhone et iPad (2.0) : barre d'adresse en bas et vue des onglets sur iPhone ; barre latérale, bande d'onglets, raccourcis clavier et fenêtres multiples sur iPad ; mêmes recherche, compte et synchronisation que sur Mac.

L'état exact de chaque fonction (terminée, implémentée mais non exercée, impossible) est dans docs/FEATURE_MATRIX.md.

# SP Search dans le navigateur

  • Moteur par défaut : SearchEngine.spSearch (spsearch://results?q=%s, raccourci s). Une requête tapée dans la barre d'adresse n'est plus envoyée à DuckDuckGo ; les autres moteurs restent accessibles par leur raccourci (g …, w …) ou comme moteur par défaut choisi dans les réglages. Migration des réglages v2 → v3 : seul l'ancien défaut duckduckgo est remplacé, un choix délibéré est conservé.
  • Page de résultats native : l'onglet charge dans son WKWebView un document vide servi par SearchPlaceholderHandler pour l'adresse spsearch://…, et l'application dessine SearchResultsView (SwiftUI) par-dessus. La page de résultats est ainsi une vraie entrée de l'historique précédent/suivant de l'onglet et se restaure avec la session, sans aucun code de navigation parallèle.
  • Qui peut ouvrir une page de recherche : l'utilisateur (barre d'adresse, page de résultats, précédent/suivant, session restaurée). Le contenu web ne peut pas y naviguer (testé).
  • Suggestions : uniquement depuis l'historique de recherche de l'utilisateur, l'historique de navigation, les signets et les onglets. Le fournisseur n'offre ni autocomplétion, ni recherches associées, ni correction orthographique : l'application n'en invente pas. « Lié à vos recherches » liste d'anciennes requêtes partageant un terme.
  • Ce qui quitte l'appareil : la requête et les filtres, vers browser.spboucher.ai. Les vignettes et favicons sont chargés directement depuis leurs sites (sans cookies, cache en mémoire seulement).
Limite due au fournisseur (vérifiée dans sa documentation le 2026-11-18) Réalité Conséquence dans l'app
Pagination aucun décalage possible, 20 résultats par appel pages suivantes = résultats d'autres domaines
Images pas de recherche d'images dédiée images des pages trouvées + Wikimedia Commons ; dimensions mesurées à l'affichage quand elles ne sont pas fournies
Vidéos aucune recherche vidéo seules les pages de lecture confirmées par l'oEmbed de YouTube, Vimeo ou Dailymotion sont affichées ; durée et date absentes pour YouTube sans clé YouTube Data API

# SP Identity

  • Compte créé et ouvert par clé d'accès (WebAuthn/FIDO2) via AuthenticationServices : Touch ID sur Mac, Face ID / Touch ID sur iPhone et iPad, code de l'appareil quand le système le propose. Aucun mot de passe, aucun protocole biométrique maison : l'application ne reçoit qu'une signature.
  • Domaine de confiance : browser.spboucher.ai (droit com.apple.developer.associated-domains = webcredentials:browser.spboucher.ai, fichier d'association servi par le backend).
  • Écran Compte (identique sur les deux plateformes) : compte, appareils enregistrés, sessions actives, clés d'accès (ajout, retrait après confirmation), dernière synchronisation, retrait d'appareil, déconnexion, déconnexion partout, nouvelle clé de récupération, effacement des données synchronisées, suppression du compte.
  • Secrets dans le trousseau uniquement : jeton de session, clé privée de l'appareil, clé de compte.

# SP Sync

Collections : history, bookmarks, favorites, tabs, closed, reading, searches, prefs.

  1. Miroir local (sync.sqlite) : copie en clair, sur l'appareil, de tout ce qui se synchronise ; chaque modification locale y est marquée « à envoyer ». C'est aussi la file d'attente hors ligne.
  2. Chiffrement : chaque enregistrement est scellé (ChaCha20-Poly1305) avec une clé dérivée de la clé de compte ; l'identifiant envoyé au serveur est un HMAC (une URL ou une requête n'y apparaît jamais). Le serveur ne reçoit jamais la clé de compte.
  3. Cycle : tirer tout ce qui suit le curseur → fusionner → pousser ce qui est marqué. Le serveur refuse une écriture faite sur une version périmée (contrôle optimiste) et renvoie la version gagnante ; le client fusionne puis renvoie si nécessaire.
  4. Fusion : historique et recherches = faits des deux appareils (dernière visite, plus grand compteur) ; le reste = dernière modification gagne ; une suppression distante l'emporte sauf modification locale postérieure.
  5. Suppressions : pierres tombales propagées, puis oubliées localement une fois confirmées.
  6. Nouvel appareil : il se connecte avec une clé d'accès, publie une clé publique et attend. Un appareil déjà synchronisé affiche la demande avec un code à comparer (dérivé de cette clé publique), puis scelle la clé de compte pour lui (HPKE). Autre voie : la clé de récupération, montrée une seule fois à la création.
  7. Planification : peu après un changement local (regroupé), au retour au premier plan, toutes les 5 minutes tant que l'app est active ; reprise après échec à 5 s, 15 s, 1 min, 5 min, 15 min. Rien ne tourne en arrière-plan, déconnecté, ou synchronisation désactivée.

Seul le profil par défaut se synchronise ; les autres profils restent locaux.

Moteurs de recherche intégrés (10) et leurs raccourcis
Moteur Raccourci Remarque
SP Search s par défaut ; résultats natifs via browser.spboucher.ai
DuckDuckGo d
Google g
Bing b
Brave Search br
Startpage sp
Ecosia e
Wikipedia w
GitHub gh
MDN Web Docs mdn

Des moteurs personnalisés peuvent être ajoutés. Rien n'est envoyé pendant la frappe : les suggestions viennent de l'historique de recherche, de l'historique et des signets locaux.

État par fonction — version 2.0 (matrice du 2026-11-18)

Statuts : Terminé = implémenté et vérifié · Implémenté = code complet, interface non exercée à la main · Impossible = API publique absente.

Fonctionnalité macOS iOS / iPadOS Limites
SP Search par défaut, résultats natifs Terminé Terminé (simulateur) Les autres moteurs restent disponibles par raccourci ou par choix
Modes Tout / Images / Vidéos Terminé Terminé (simulateur) Vidéos : plateformes confirmées seulement ; durée YouTube absente
Résumé par IA du fournisseur, filtres date / langue / région / filtrage Terminé Terminé Langue et région non exercées à la main
Suggestions depuis l'historique de recherche, recherches liées Terminé Terminé Aucune suggestion en ligne (fournisseur)
Page de résultats = entrée de l'historique, restaurée avec la session Terminé Terminé —
Aperçu d'image (source, dimensions, copier, enregistrer, partager) Implémenté Implémenté Non exercé à la main
Lecteur vidéo intégré (lecteur de la plateforme) Implémenté Implémenté Non exercé à la main
Page de démarrage 2.0 Terminé (essai réel partiel) Terminé (simulateur) Sections avec données d'autres appareils non vues à l'écran
Compte à clés d'accès, appareils, sessions, clés supplémentaires, récupération, suppression Terminé (logique) / Implémenté (écran) idem Cérémonie Touch ID / Face ID réelle non exécutée
SP Sync chiffré de bout en bout (8 collections) Terminé (logique) Terminé (logique) Jamais exercé entre deux machines physiques
Enrôlement d'un nouvel appareil avec code à comparer, clé de récupération Terminé (logique) / Implémenté (écran) idem —
Navigation privée jamais synchronisée Terminé Terminé Un signet ajouté volontairement en privé rejoint les signets ordinaires
Liste de lecture, favoris synchronisés, onglets des autres appareils Terminé (logique) / Implémenté (panneaux) Terminé (simulateur) —
Interface iPhone (barre d'adresse en bas, vue des onglets, privé) — Terminé (simulateur) Appareil réel non testé
Interface iPad (barre latérale, raccourcis clavier, fenêtres multiples) — Implémenté Largement non exercé
Bloqueur de contenu, lecteur, profils, permissions par site Terminé (1.0) Non fait —
État par fonction — socle 1.0 (macOS), extrait de la matrice
Fonctionnalité Statut
Barre d'adresse unifiée URL / recherche Terminé
Onglets : créer, fermer, rouvrir, dupliquer, épingler Terminé
Suspension des onglets inactifs Terminé
Restauration de session, y compris après plantage Terminé
Vue scindée redimensionnable Terminé
Navigation privée Terminé
Profils à données web séparées Terminé
Bloqueur de contenu, exception par site, listes à la demande Terminé
Palette de commandes ⌘K Terminé
Zoom mémorisé par site Terminé
Localisation français / anglais Terminé (889 / 889 en 2.0)
Groupes d'onglets, historique, signets, notes, sessions nommées Terminé (logique) / Implémenté (interface)
Onglets verticaux, plein écran, glisser-déposer, partage, impression Implémenté
SP Intelligence Implémenté — aucun envoi réel testé
Accessibilité Partiel — aucun audit VoiceOver complet
Arborescence d'onglets, architecture de plugins, mise à jour automatique Non fait
Export HAR Non fait, volontairement (export JSON « Resource Timing » à la place)
Géolocalisation, notifications, presse-papiers, lecture auto par site Impossible
Extensions Chrome / Firefox / Safari Non pris en charge

# 🏗 Architecture

flowchart TB
    subgraph MAC["Application macOS (cible SPBrowser)"]
        V["Features (SwiftUI)<br/>BrowserWindow · Sidebar · CommandBar · StartPage<br/>Library · DeveloperTools · Intelligence · Settings"]
        AD["App (AppKit)<br/>AppDelegate · menus · App Intents (3)"]
        WS["BrowserWindowState<br/>perform(CommandID)"]
        TAB["Core/BrowserEngine<br/>BrowserTab · ProfileContext · DownloadManager"]
        V -->|observent| WS
        AD --> WS
        WS -->|possède| TAB
    end
    subgraph IOS["Application iOS / iPadOS (cible SPBrowserMobile, Mobile/)"]
        MV["Features<br/>BrowserView · TabOverview · MobileStartPage<br/>AddressEditor · LibraryViews · MobileSettingsView"]
        BM["Engine<br/>BrowserModel · MobileTab · MobileDownloads"]
        MV -->|observent| BM
    end
    subgraph SH["SPBrowser/Shared (SwiftUI multiplateforme)"]
        SR["SearchResultsView · SearchMediaViews · SearchPageModel"]
        AV["AccountView · BrowserServices · SystemPasskeyAuthorizer"]
    end
    subgraph CORE["SPBrowser/Core (aussi paquet SwiftPM SPBrowserCore)"]
        ST["Storage · History · Bookmarks · Tabs · Profiles"]
        SEC["Security · Permissions · ContentBlocking"]
        NAV["Navigation · Search · Automation · AI · Settings"]
        NET["Backend · SPSearch · Identity · Sync"]
    end
    V --> SH
    MV --> SH
    WS --> CORE
    BM --> CORE
    SH --> CORE
    TAB --> WK["WKWebView<br/>processus WebKit isolés"]
    BM --> WK
    ST --> SQL[("profile.sqlite<br/>par profil")]
    ST --> JS[("JSON atomique")]
    NET --> SY[("sync.sqlite<br/>miroir + file d'attente")]
    SEC --> KC[("Trousseau")]
    NET -->|HTTPS| BE["browser.spboucher.ai<br/>sp-browser-backend"]
    WK --> DS[("WKWebsiteDataStore<br/>un par profil")]

SP Browser est fait de deux applications natives (Swift 6, concurrence stricte) qui partagent leur cœur : sur Mac, AppKit pour le cycle de vie, les fenêtres et les menus et SwiftUI pour toute l'interface ; sur iPhone et iPad, une application SwiftUI (Mobile/). Dans les deux, WebKit (WKWebView) est le moteur de rendu.

Dossier Contenu Plateformes
SPBrowser/Core/SPSearch modèles, SearchClient, adresse interne spsearch://, surlignage macOS + iOS, paquet SwiftPM SPBrowserCore
SPBrowser/Core/Backend client HTTP JSON commun, erreurs stables idem
SPBrowser/Core/Identity AccountService, protocole PasskeyAuthorizer, JSON WebAuthn idem
SPBrowser/Core/Sync SyncCrypto, SyncDatabase (miroir + file d'attente), SyncEngine, ponts historique/signets, SyncedLibrary, SyncCoordinator idem
SPBrowser/Shared SwiftUI multiplateforme : page de résultats, images, vidéos, écran de compte, BrowserServices, authentificateur système macOS + iOS
SPBrowser/Features, SPBrowser/App, Core/BrowserEngine application macOS (AppKit + SwiftUI) macOS
Mobile/ application iPhone / iPad iOS
  • Injection de dépendances : sur Mac, AppEnvironment construit tout à partir d'un dossier racine et d'un SecretStore ; les tests passent un dossier temporaire et un magasin de secrets en mémoire, et les onglets ne connaissent que les protocoles EngineEnvironment et TabHost. Sur iOS, MobileEnvironment joue le même rôle à partir d'un dossier de données (temporaire pour les tests, -SPBDataDir temp).
  • Une seule voie pour les actions (macOS) : menus, raccourcis, palette ⌘K et App Intents passent tous par BrowserWindowState.perform(_: CommandID) ; l'activation est décidée par isEnabled(_:). Les menus sont construits à partir du catalogue, ils ne peuvent donc pas diverger des raccourcis affichés.
  • Un seul code : Core/ est compilé dans l'application macOS, dans l'application iOS et dans le paquet Package.swift, sans duplication (BrowserEngine/, lié à l'app macOS, est exclu du paquet et de la cible iOS). La cible iOS compile Mobile/ + SPBrowser/Core + SPBrowser/Shared + les deux .lproj.

# Connexion par clé d'accès, puis un cycle SP Sync

sequenceDiagram
    autonumber
    participant U as Utilisateur
    participant A as SP Browser (AccountService)
    participant S as Système (AuthenticationServices)
    participant B as browser.spboucher.ai
    participant M as sync.sqlite (miroir)
    U->>A: « Se connecter avec une clé d'accès »
    A->>B: POST /api/auth/login/options
    B-->>A: défi WebAuthn
    A->>S: demande d'assertion (webcredentials:browser.spboucher.ai)
    S-->>U: Touch ID / Face ID
    S-->>A: signature seulement
    A->>B: POST /api/auth/login/verify
    B-->>A: jeton de session (rangé au trousseau)
    A->>B: GET /api/sync/keys
    alt appareil déjà enrôlé
        B-->>A: enveloppe HPKE de la clé de compte
    else nouvel appareil
        A->>B: publie sa clé publique, attend l'approbation (code à comparer) ou la clé de récupération
    end
    loop à chaque cycle
        A->>B: GET /api/sync/pull?since=curseur
        B-->>A: enregistrements chiffrés
        A->>M: déchiffre, fusionne
        M-->>A: enregistrements marqués « à envoyer »
        A->>B: POST /api/sync/push (ChaCha20-Poly1305, identifiants HMAC)
        B-->>A: acceptés, ou version gagnante si périmé
    end

# Une commande, de la touche à la page

sequenceDiagram
    autonumber
    participant U as Utilisateur
    participant M as Menu · raccourci · palette ⌘K · App Intent
    participant S as BrowserWindowState
    participant T as BrowserTab
    participant G as URLSafety
    participant W as WKWebView
    U->>M: saisit une adresse ou déclenche une commande
    M->>S: perform(CommandID)
    S->>S: isEnabled ? AddressResolver : URL ou recherche
    S->>T: charger
    T->>G: verdict de navigation
    alt schéma dangereux ou adresse trompeuse
        G-->>T: bloqué ou confirmation demandée
    else autorisé
        T->>W: load
        W-->>T: titre, progression, état TLS
        T-->>S: état observé par les vues
    end

# Cycle de vie des vues web

  • Un WKWebView par onglet chargé, possédé par BrowserTab. Changer d'onglet ne recharge rien : la vue hôte SwiftUI (WebViewHost) rattache simplement la vue web existante.
  • Restauration paresseuse : à la relance, seul l'onglet sélectionné de chaque fenêtre crée sa vue web ; les autres attendent d'être affichés (interactionState de WebKit conservé).
  • Suspension : un onglet d'arrière-plan inactif depuis N minutes (réglable, 30 par défaut, jamais les onglets épinglés ni l'onglet visible) libère sa vue web en gardant adresse, titre et interactionState.
  • Pas de cycles de rétention : le délégué WebKit (TabCoordinator) tient l'onglet en weak ; l'onglet tient son hôte en weak ; les observations KVO sont invalidées dans tearDownWebView().
  • Plantage du processus de contenu : page dédiée avec rechargement ; les autres onglets ne sont pas touchés.
  • Fenêtres ouvertes par les pages (window.open, target=_blank) : createWebViewWith crée un onglet avec exactement la configuration fournie par WebKit.

# Profils et isolement

Contexte Magasin WebKit Historique Signets / notes Permissions
Profil WKWebsiteDataStore(forIdentifier: <UUID du profil>), persistant, distinct SQLite du profil SQLite du profil JSON du profil
Fenêtre privée WKWebsiteDataStore.nonPersistent(), neuf à chaque contexte aucun (base en mémoire, jamais écrite) ceux du profil parent (ajout explicite) en mémoire

L'identifiant du profil par défaut est aléatoire et propre à chaque dossier de données : deux dossiers (application réelle, tests, démonstration) ne partagent jamais un magasin WebKit.

Une fenêtre privée n'écrit ni historique ni historique de recherche, n'apparaît pas dans les onglets publiés, et sa base d'historique est en mémoire : rien de ce qu'elle fait ne peut atteindre le miroir, donc le serveur. Les ponts fonctionnent par comparaison avec la base du profil ordinaire (et non par notifications), ce qui rend la fuite structurellement impossible plutôt que simplement évitée. Tests : testPrivateBrowsingNeverReachesTheSyncMirror, testSearchHistoryIsRecordedInRegularWindowsOnly (macOS), testPrivateTabsLeaveNoTraceAndAreNeverPublished (iOS).

# 🧱 Pile technique

Couche Technologie Version Rôle
Langage Swift (SWIFT_VERSION 6.0, swift-tools-version 6.0) 6 concurrence stricte complete
Interface SwiftUI macOS 14+ · iOS 18+ toute l'interface, vues de recherche et de compte partagées (SPBrowser/Shared)
Application Mac AppKit macOS 14+ cycle de vie, fenêtres, menus
Rendu WebKit (WKWebView, WKContentRuleList, WKDownload) système moteur, bloqueur (Mac), téléchargements
Persistance SQLite (-lsqlite3, WAL) · JSON atomique · Trousseau système profile.sqlite, sync.sqlite · réglages, sessions · clés et jetons
Chiffrement CryptoKit (ChaCha20-Poly1305, HKDF-SHA256, HMAC-SHA256, HPKE Curve25519) système SP Sync de bout en bout, enveloppes d'appareil, clé de récupération
Identité AuthenticationServices (clés d'accès WebAuthn), Associated Domains système SP Identity, domaine browser.spboucher.ai
Réseau URLSession (BackendClient, JSON) système SP Search, SP Identity, SP Sync
Automatisation App Intents système 3 intents (Raccourcis, Spotlight) — macOS
Paquet SPBrowserCore (SwiftPM, platforms: macOS 14) — logique sans interface, testée par swift test
Projet XcodeGen (project.yml) ; SPBrowser.xcodeproj généré — 5 cibles, 2 schémas (SPBrowser, SPBrowserMobile)
Distribution Developer ID · notarytool · stapler · DMG ; App Store Connect · TestFlight — macOS ; iOS / iPadOS
Service sp-browser-backend — https://browser.spboucher.ai
Outils constatés Xcode 27.2, Swift 6.4.2, SDK macOS 27.2 ; simulateurs iOS 26.5 — d'après docs/ENVIRONMENT_AUDIT.md et docs/TEST_REPORT.md

Aucune dépendance tierce : ni paquet SwiftPM externe, ni CocoaPods, ni Carthage.

# 🗂 Organisation du dépôt

text
SPBrowser/
  App/            main.swift, AppDelegate (cycle de vie, menus), AppEnvironment (racine de composition), Intents   [macOS]
  Core/           logique métier sans interface — macOS + iOS + paquet SwiftPM pour `swift test`
    Navigation/   AddressResolver (texte saisi → URL ou recherche)
    Search/       moteurs de recherche et raccourcis (SP Search par défaut)
    SPSearch/     client et modèles SP Search, adresse interne spsearch://, surlignage
    Backend/      BackendClient : client HTTP JSON commun, erreurs stables, configuration (production ou remplacée)
    Identity/     AccountService (compte, sessions, appareils, récupération), Passkeys (JSON WebAuthn, PasskeyAuthorizer)
    Sync/         SyncCrypto, SyncDatabase (miroir + file d'attente), SyncEngine, SyncBridges, SyncCoordinator
    Security/     URLSafety (verdict de navigation), signaux d'adresse trompeuse, Keychain
    Storage/      SQLiteDatabase (+ migrations), JSONFileStore (écriture atomique), ProfileDatabase
    History/ Bookmarks/   magasins SQLite, import/export HTML Netscape
    Tabs/         modèles de session, sauvegarde + copie de secours
    Profiles/     profils, journalisation respectueuse de la vie privée
    Permissions/  décisions par site
    ContentBlocking/  génération des règles WKContentRuleList, analyse de listes
    Automation/   catalogue de commandes, raccourcis, scripts utilisateur
    AI/           fournisseurs, requêtes/réponses, construction des invites
    Settings/     AppSettings et sa migration
    BrowserEngine/  (macOS seulement, exclu du paquet et de la cible iOS) BrowserTab, ProfileContext, DownloadManager, PageScripts
  Shared/         SwiftUI multiplateforme — macOS + iOS
    Search/       SearchResultsView, SearchMediaViews, SearchPageModel, SPSearchPreferencesSection
    Account/      AccountView, BrowserServices, SystemPasskeyAuthorizer
    Platform/     Platform.swift (ponts AppKit / UIKit)
  Features/       vues SwiftUI macOS : BrowserWindow, Sidebar (+ SyncedPanels), CommandBar, StartPage, Library,
                  DeveloperTools, Intelligence, Settings
  DesignSystem/   jetons (couleurs, rayons), composants communs
  Resources/      Info.plist, entitlements (dev + Release), Assets.xcassets, en.lproj, fr.lproj (partagés avec iOS)
  Tests/          CoreTests (SwiftPM), AppTests (hébergés dans l'application macOS)
Mobile/           application iPhone / iPad
  App/            SPBrowserMobileApp (scènes, raccourcis clavier), MobileEnvironment
  Engine/         BrowserModel (onglets d'une scène), MobileTab (WKWebView), MobileDownloads
  Features/       BrowserView (iPhone + iPad), TabOverview, AddressEditor, MobileStartPage, LibraryViews, MobileSettingsView
  Resources/      Info.plist, SPBrowserMobile.entitlements, Assets.xcassets
  Tests/          MobileEngineTests (hébergés)          UITests/  BrowserUITests (XCUITest)
Assets/Brand/     sources SVG de l'icône, concepts, rendus et script de génération
scripts/          build, test, backend de test, iOS (build, test, release), provisionnement, release, notarisation,
                  vérification, performance, localisation
docs/             10 documents, captures (macOS + ios/), brand/
Package.swift     paquet SPBrowserCore
project.yml       définition XcodeGen
Dossier Fichiers Swift Lignes
SPBrowser/Core 30 5 911
SPBrowser/Features 14 4 836
Mobile/ (App 2 · Engine 3 · Features 6 · Tests 1 · UITests 1) 13 2 745
SPBrowser/Tests 9 2 475
SPBrowser/Shared 8 1 693
SPBrowser/App 4 758
SPBrowser/DesignSystem 1 180
scripts/window-shot.swift + Package.swift 2 38
Total 81 18 636
Cible (project.yml) Type Plateforme Identifiant
SPBrowser application macOS 14.0 ai.spboucher.spbrowser (Debug : ai.spboucher.spbrowser.debug)
SPBrowserTests tests unitaires hébergés macOS ai.spboucher.spbrowser.tests
SPBrowserMobile application (iPhone + iPad, TARGETED_DEVICE_FAMILY 1,2) iOS 18.0 ai.spboucher.spbrowser
SPBrowserMobileTests tests unitaires hébergés iOS 18.0 ai.spboucher.spbrowser.mobile.tests
SPBrowserMobileUITests tests d'interface iOS 18.0 ai.spboucher.spbrowser.mobile.uitests

# 🚀 Compiler et tester

Prérequis : Xcode 27 (Swift 6), xcodegen (brew install xcodegen).

bash
scripts/build.sh               # build Debug → build/DerivedData/Build/Products/Debug/SPBrowser.app
scripts/test.sh all            # tests du cœur (swift test) + tests d'intégration de l'app macOS (xcodebuild test)
scripts/test-backend.sh up     # serveur jetable pour les tests d'intégration compte/synchro (exporter les variables affichées)
scripts/ios-build.sh           # build iOS pour simulateur ; scripts/ios-test.sh unit|ui
scripts/provision.py           # profil Developer ID avec domaines associés (clés d'accès)
open SPBrowser.xcodeproj       # le projet est généré à partir de project.yml
scripts/build-release.sh       # archive Release signée Developer ID → dist/SPBrowser.app
scripts/notarize.sh            # notarisation, agrafage, image disque
scripts/verify-release.sh      # vérification complète de la version
scripts/perf.sh dist/SPBrowser.app      # lancement et mémoire à 1, 10 et 30 onglets
scripts/check-localization.py  # toutes les chaînes ont-elles leur traduction française ?
Assets/Brand/build-icons.sh    # régénère les icônes à partir des SVG

Lancer avec un dossier de données isolé (démonstration, essais) :

bash
open -n build/DerivedData/Build/Products/Debug/SPBrowser.app --args -SPBDataDir '~/Library/Application Support/SPB-Demo'

Tests d'intégration compte / synchronisation contre un vrai serveur local, puis recherche réelle :

bash
eval "$(scripts/test-backend.sh up)"     # clone/actualise sp-browser-backend, le lance sur 127.0.0.1, affiche les export
swift test                               # les tests d'intégration multi-appareils s'activent avec ces variables
SPB_LIVE_SEARCH=1 swift test --filter LiveSearchTests   # web, images, vidéos par la production (quelques crédits)
scripts/test-backend.sh down
Script Usage
scripts/build.sh [Debug|Release] compile l'app macOS et n'affiche que les erreurs, les avertissements et le résultat
scripts/test.sh [core|app|all] tests du cœur (SwiftPM) et tests d'intégration dans l'application macOS (xcodebuild)
scripts/test-backend.sh up|down backend jetable sur 127.0.0.1 (base temporaire, inscription ouverte, sans clé de fournisseur de recherche — jamais de données de production) ; down arrête par PID du port, jamais par nom
scripts/ios-build.sh [simulateur] build Debug iOS pour simulateur (par défaut « SPBrowser iPhone », créé à partir d'un iPhone 17 Pro s'il manque ; un nom contenant « iPad » crée un iPad Pro 13")
scripts/ios-test.sh unit|ui [simulateur] tests hébergés iOS (pas de réseau au-delà de localhost) ou tests d'interface (le test de recherche interroge SP Search en production)
scripts/ios-release.sh archive|export|upload|all archive Release iOS, IPA App Store Connect en signature automatique, envoi TestFlight (all = archive + export ; upload est explicite)
scripts/ios-ExportOptions.plist options d'export (app-store-connect, signature automatique)
scripts/provision.py enregistre l'identifiant d'app, la capacité Associated Domains et le profil « SP Browser Developer ID » (idempotent, ne crée jamais de certificat)
scripts/asc.py client minimal de l'API App Store Connect utilisé par provision.py et ios-release.sh
scripts/build-release.sh archive Release macOS signée Developer ID avec le profil, exporte dist/SPBrowser.app
scripts/notarize.sh notarise l'app, agrafe, puis construit, signe, notarise et agrafe dist/SPBrowser.dmg
scripts/verify-release.sh signature, entitlements, runtime durci, Gatekeeper, ticket de notarisation
scripts/perf.sh [app] lancement et mémoire à 1, 10 et 30 onglets, dossier de données vide à chaque mesure
scripts/check-localization.py [--list] couverture de la traduction française (sources SPBrowser/ + Mobile/)
scripts/window-shot.swift capture de la fenêtre de l'application

# ⚙️ Configuration

macOS. Tout se règle dans Réglages (⌘,) : démarrage, apparence, moteur de recherche, confidentialité, bloqueur, profils, clavier, SP Intelligence, scripts utilisateur, compte et synchronisation, options avancées. Les données sont dans le conteneur de l'application (~/Library/Containers/ai.spboucher.spbrowser/).

iOS / iPadOS. Réglages de l'app : Recherche, Apparence, Navigation, Confidentialité, et l'écran Compte.

Réglage de build (project.yml) Valeur
MARKETING_VERSION · CURRENT_PROJECT_VERSION 2.0.0 · 2
SWIFT_VERSION · SWIFT_STRICT_CONCURRENCY 6.0 · complete
Cibles de déploiement macOS 14.0 · iOS 18.0
PRODUCT_BUNDLE_IDENTIFIER ai.spboucher.spbrowser (macOS Release et iOS) ; ai.spboucher.spbrowser.debug (macOS Debug)
ENABLE_HARDENED_RUNTIME YES (macOS)
ENABLE_USER_SCRIPT_SANDBOXING · DEAD_CODE_STRIPPING YES · YES
SUPPORTS_MACCATALYST · SUPPORTS_MAC_DESIGNED_FOR_IPHONE_IPAD NO · NO (l'app Mac est la cible native)
Langue de développement en (localisation fr complète)
Argument de lancement Plateforme Rôle
-SPBDataDir <dossier> macOS · iOS dossier de données isolé (temp sur iOS = dossier temporaire)
-SPBBackendURL <url> macOS · iOS remplace l'adresse du backend (tests, développement ; ex. http://127.0.0.1:8710)
-SPBRelyingParty <domaine> macOS · iOS domaine de confiance WebAuthn associé à l'adresse remplacée
-SPBOpenURLs "url1,url2" macOS · iOS ouvre les adresses dans des onglets (iOS : seulement avec un dossier de données jetable)
-SPBShow tabs|settings|account|private|library iOS ouvre un écran au lancement (tests d'interface et captures)
-SPBShowSettings <section> macOS ouvre une section des réglages au lancement
-SPBPerfLog 1 macOS écrit la mesure de lancement (utilisé par scripts/perf.sh)
Variable d'environnement (noms seulement) Utilisée par Rôle
SPB_TEST_BACKEND · SPB_TEST_ORIGIN · SPB_TEST_RP · SPB_TEST_DB swift test activent les tests d'intégration contre le backend jetable (affichées par scripts/test-backend.sh up)
SPB_TEST_BACKEND_DIR · SPB_TEST_PORT scripts/test-backend.sh dossier du clone du backend · port local (8719 par défaut)
SPB_LIVE_SEARCH swift test active le test de recherche réelle par la production
SIGN_IDENTITY scripts de publication macOS identité de signature (par défaut la première « Developer ID Application » du trousseau)
TEAM_ID scripts de publication macOS équipe de développement
NOTARY_PROFILE scripts/notarize.sh profil trousseau de notarytool (par défaut MacLustr-Notarize)
ASC_KEY_ID · ASC_ISSUER_ID · ASC_KEY_PATH scripts/asc.py clé d'API App Store Connect déjà présente sur le Mac (sinon retrouvée dans l'outillage existant)

# ⌨️ Raccourcis et commandes

Raccourcis essentiels (macOS) :

⌘T Nouvel onglet ⌘L Barre d'adresse
⇧⌘N Fenêtre privée ⌘K Palette de commandes
⇧⌘T Rouvrir l'onglet fermé ⇧⌘A Rechercher dans les onglets
⌘\ Vue scindée ⌃⌘S Barre latérale
⌘D Ajouter un signet ⌘Y Historique
⌘F Rechercher dans la page ⌥⌘R Lecteur
⌘I Informations sur la page ⇧⌘F Mode Concentration
⌘1…⌘9 Aller à l'onglet ⌘, Réglages
⌥⌘D Ajouter à la liste de lecture (2.0) ⌃⌘L Afficher la liste de lecture (2.0)

Liste complète : docs/AUTOMATION.md. Tous sont modifiables dans Réglages › Clavier ; les conflits y sont signalés. Dans la palette : > limite aux commandes, @ aux onglets, # aux signets.

Catalogue complet des commandes macOS (SPBrowser/Core/Automation/Commands.swift)
Catégorie Identifiants (raccourci par défaut)
Fichier newTab ⌘T · newWindow ⌘N · newPrivateWindow ⇧⌘N · openFile ⌘O · openLocation ⌘L · closeTab ⌘W · closeWindow ⇧⌘W · savePageAsPDF · capturePage · printPage ⌘P · sharePage · openSettings ⌘, · showAccount (2.0)
Édition findInPage ⌘F · findNext ⌘G · findPrevious ⇧⌘G
Présentation reload ⌘R · hardReload ⇧⌘R · stopLoading ⌘. · zoomIn ⌘= · zoomOut ⌘- · zoomReset ⌘0 · toggleSidebar ⌃⌘S · toggleTabLayout · toggleFocusMode ⇧⌘F · toggleReader ⌥⌘R · toggleFullScreen ⌃⌘F · commandPalette ⌘K · toggleSplitView ⌘\ · swapSplit
Historique goBack ⌘[ · goForward ⌘] · goHome ⇧⌘H · reopenClosedTab ⇧⌘T · showHistory ⌘Y · clearHistory
Onglets nextTab ⇧⌘] · previousTab ⇧⌘[ · searchTabs ⇧⌘A · duplicateTab ⇧⌘D · pinTab · newTabGroup · moveTabToNewWindow · closeOtherTabs ⌥⌘W · suspendTab · nextWorkspace ⌃⌥⌘→ · previousWorkspace ⌃⌥⌘← · showOtherDevices (2.0) · ⌘1…⌘9
Signets addBookmark ⌘D · showBookmarks ⌥⌘B · importBookmarks · exportBookmarks · addToReadingList ⌥⌘D (2.0) · showReadingList ⌃⌘L (2.0) · toggleFavorite (2.0)
Outils showDownloads ⌥⌘L · showNotes · showSessions · saveSession · toggleIntelligence ⇧⌘I · pageInfo ⌘I · toggleBlockerForSite · clearSiteData · viewSource ⌥⌘U · pageMetadata · changeUserAgent · syncNow (2.0)

Clavier matériel sur iPad / iPhone (Mobile/App/SPBrowserMobileApp.swift, calqué sur l'app Mac) :

⌘T Nouvel onglet ⇧⌘N Nouvel onglet privé
⌘W Fermer l'onglet ⇧⌘T Rouvrir l'onglet fermé
⌘L Barre d'adresse ⌘R Recharger
⌘F Rechercher dans la page ⌘[ · ⌘] Précédent · Suivant
⌘D Ajouter un signet ⌘Y Historique
⌥⌘B Signets ⇧⌘] · ⇧⌘[ Onglet suivant · précédent
⇧⌘\ Tous les onglets

# 📱 Écrans iOS / iPadOS

Écran Fichier Contenu
Navigateur Mobile/Features/BrowserView.swift iPhone : barre d'adresse en bas (PhoneAddressBar), barre d'outils, menu de page ; iPad : barre supérieure, bande d'onglets (PadTabStrip), barre latérale (PadSidebar) ; page d'erreur, bannières
Vue des onglets Mobile/Features/TabOverview.swift cartes d'onglets, bascule privé, fermeture
Saisie d'adresse Mobile/Features/AddressEditor.swift adresse ou recherche, suggestions locales
Page de démarrage Mobile/Features/MobileStartPage.swift favoris, fréquents, récents, recherches, autres appareils, liste de lecture
Bibliothèque Mobile/Features/LibraryViews.swift signets (+ éditeur), liste de lecture, historique, téléchargements
Réglages Mobile/Features/MobileSettingsView.swift Recherche, Apparence, Navigation, Confidentialité
Résultats SP Search SPBrowser/Shared/Search/ Tout · Images · Vidéos, aperçu d'image, lecteur vidéo (partagés avec macOS)
Compte SPBrowser/Shared/Account/AccountView.swift compte, appareils, sessions, clés d'accès, récupération (partagé avec macOS)

Comportements propres à iOS : une scène (écran d'iPhone ou fenêtre d'iPad) a ses propres onglets (UIApplicationSupportsMultipleScenes) ; les onglets d'arrière-plan sont suspendus quand l'app passe en arrière-plan ; l'app déclare les schémas http / https et ouvre l'adresse reçue dans un nouvel onglet ; les téléchargements sont exposés à l'app Fichiers (UIFileSharingEnabled, LSSupportsOpeningDocumentsInPlace). L'app iOS n'a ni bloqueur de contenu, ni lecteur, ni profils, ni permissions par site.

# 🔌 API du backend utilisée

Routes de sp-browser-backend appelées par le code de ce dépôt (SPBrowser/Core/{SPSearch,Identity,Sync}), toutes sur https://browser.spboucher.ai.

Domaine Méthode et route Appelant
SP Search POST /api/search SPSearchClient
Inscription POST /api/auth/register/options · POST /api/auth/register/verify AccountService (code d'invitation)
Connexion POST /api/auth/login/options · POST /api/auth/login/verify AccountService
Récupération POST /api/auth/recover/options · POST /api/auth/recover/verify AccountService (clé de récupération)
Confirmation POST /api/auth/reauth/options · POST /api/auth/reauth/verify avant une action destructrice
Clés d'accès POST /api/auth/passkeys/options · POST /api/auth/passkeys/verify · DELETE /api/auth/passkeys/{id} ajout / retrait d'une clé
Session POST /api/auth/logout · POST /api/auth/logout-all déconnexion, déconnexion partout
Compte GET /api/account · PATCH /api/account · DELETE /api/account détails, nom affiché, suppression
Appareils DELETE /api/devices/{id} retrait d'un appareil
Clé de compte GET /api/sync/keys · POST /api/sync/keys/bootstrap · GET /api/sync/keys/pending · POST /api/sync/keys/approve état, premier appareil, demandes en attente, approbation (enveloppe HPKE)
Clé de récupération GET /api/sync/keys/recovery · PUT /api/sync/keys/recovery · POST /api/sync/keys/claim ouverture par la clé de récupération, renouvellement
Synchronisation GET /api/sync/pull?since=…&limit=500 · POST /api/sync/push SyncEngine
Effacement DELETE /api/sync/data (en-tête X-SP-Key-Proof) effacer la copie du serveur

# 🤖 Automatisation

Détail : docs/AUTOMATION.md.

App Intents (app Raccourcis, Spotlight)

Intent Effet
Ouvrir une adresse dans SP Browser Ouvre une adresse http(s) dans un nouvel onglet
Rechercher sur le web dans SP Browser Recherche avec le moteur par défaut
Nouvelle fenêtre privée dans SP Browser Ouvre une fenêtre privée

Ils ne lisent ni contenu de page, ni historique, ni cookies, et n'agissent sur aucun site. Aucune API réseau locale n'est ouverte et aucun schéma d'URL personnalisé n'expose de commandes. Ces intents compilent et sont déclarés dans l'application ; ils n'ont pas été exercés depuis l'app Raccourcis.

Scripts utilisateur — Réglages › Scripts utilisateur. Désactivés par défaut. Chaque script déclare ses sites (exemple.com = ce site et ses sous-domaines ; *.exemple.com = sous-domaines seulement) ; il n'existe pas de joker « tous les sites ». Le code est injecté dans un monde JavaScript isolé, jamais en fenêtre privée. Aucune API privilégiée n'est offerte aux scripts.

Extensions — Chrome, Firefox ou Safari : non prises en charge. La seule voie légitime serait WKWebExtension (macOS 15.4+) ; elle n'est pas utilisée parce que la cible minimale est macOS 14 et parce que charger du code tiers demande un modèle de permissions complet qui n'a pas été conçu ni testé. Une esquisse d'architecture de plugins (non implémentée) figure dans docs/AUTOMATION.md.

# 💾 Données et persistance

Donnée Support Garanties
Historique, signets, notes SQLite par profil (profile.sqlite, tables history, bookmarks, notes), WAL Migrations ajoutées en fin de liste, suivies par PRAGMA user_version, chacune dans une transaction (testé : v1 → v2 sans perte, retour arrière si échec) ; requêtes paramétrées
Miroir de synchronisation et file d'attente hors ligne sync.sqlite (tables records, meta) Copie en clair sur l'appareil seulement ; chaque modification locale marquée dirty jusqu'à acceptation par le serveur ; existe aussi sans compte, pour les favoris, la liste de lecture et l'historique de recherche
Réglages, permissions, espaces, scripts, listes, téléchargements JSON Écriture atomique ; champs absents d'un ancien fichier = valeur par défaut ; fichier illisible renommé .corrupt-<horodatage> ; migration des réglages v2 → v3 (moteur par défaut)
Session Sessions/session.json + session.backup.json Écriture atomique, copie de secours de la dernière version valide, repli automatique, mise à l'écart si tout est illisible
Clés d'API, jeton de session, clé privée de l'appareil, clé de compte SP Sync Trousseau Jamais dans les réglages, journaux ou adresses
Données de sites WebKit Par profil ; effacement par site ou global

Emplacement (macOS) : ~/Library/Containers/ai.spboucher.spbrowser/Data/Library/Application Support/SP Browser/. Sur iOS : dossier SP Browser de l'Application Support de l'app.

Table records de sync.sqlite (SPBrowser/Core/Sync/SyncDatabase.swift) :

Colonne Type Rôle
collection · key TEXT (clé primaire) collection (history, bookmarks, favorites, tabs, closed, reading, searches, prefs) et clé locale
json TEXT contenu en clair, local
modified_at REAL date de dernière modification (règle « dernière modification gagne »)
deleted INTEGER pierre tombale
server_seq INTEGER version connue du serveur (contrôle optimiste)
dirty INTEGER à envoyer (index partiel records_dirty)
remote_id TEXT identifiant opaque (HMAC) vu par le serveur

Favoris, liste de lecture, historique de recherche, préférences et onglets des autres appareils ne vivent que dans ce miroir ; l'historique et les signets y sont pontés depuis la base du profil (SyncBridges).

Journalisation. Log.event écrit dans le journal unifié en développement et, seulement si l'utilisateur l'active, dans diagnostics.log (local). Les adresses sont réduites à schéma://hôte. Aucune télémétrie, aucun envoi.

# 🔐 Sécurité

Détail : docs/SECURITY.md (navigateur) et docs/SECURITY.md du backend (compte et synchronisation). Aucune de ces mesures ne garantit une protection totale contre l'hameçonnage ou les logiciels malveillants.

Isolation (macOS). App Sandbox et Hardened Runtime activés, sans exception. Entitlements : réseau sortant, fichiers choisis par l'utilisateur, dossier Téléchargements, caméra, micro, impression ; en Release s'y ajoutent le domaine associé webcredentials:browser.spboucher.ai et le groupe de trousseau de l'application. Sur iOS, le seul droit déclaré est ce même domaine associé. Le rendu des pages s'exécute dans les processus WebKit du système. Tout JavaScript exécuté par le navigateur lui-même (texte de page, métadonnées, lecteur, favicon) tourne dans un monde de contenu isolé.

Cas de navigation Comportement
javascript: / vbscript: saisi ou suivi Jamais exécuté ; saisi dans la barre d'adresse, il est recherché comme du texte
data: en navigation principale Bloqué et signalé
file: demandé par une page web Bloqué ; permis seulement s'il est ouvert par l'utilisateur ou depuis un fichier local
Schémas d'autres applications (mailto:, zoommtg:…) Confirmation nommant l'application avant d'ouvrir ; refusé depuis un sous-cadre
Adresse contenant un nom d'utilisateur ou mélangeant des alphabets Confirmation montrant la destination réelle (réglable)
Fenêtres surgissantes sans clic Bloquées par défaut, autorisables par site

TLS. La validation des certificats est laissée à macOS. Il n'existe aucun moyen de contourner une erreur de certificat. La mise à niveau HTTPS des hôtes connus et l'avertissement de site frauduleux de WebKit sont activés.

Capacité Contrôle par site
Caméra, micro Oui : demander / autoriser / refuser ; une demande venant d'un cadre tiers est refusée
JavaScript, fenêtres surgissantes, bloqueur de contenu Oui
Géolocalisation, notifications web, lecture du presse-papiers, lecture automatique Non — aucune API publique par site sur macOS ; non proposé plutôt que simulé

Ces contrôles par site sont ceux de l'app macOS ; l'app iOS ne les reprend pas.

Bloqueur de contenu. Règles WKContentRuleList compilées par WebKit : blocage réseau des requêtes tierces vers environ 130 hôtes de pistage et de publicité connus (liste intégrée), plus des listes distantes facultatives. Pas de filtrage cosmétique, pas d'injection de script. Les listes distantes ne sont téléchargées que sur action de l'utilisateur, en HTTPS, sans cookies.

Téléchargements. Nom de fichier nettoyé (aucun composant de chemin, caractères de contrôle et marques bidirectionnelles supprimés), jamais d'écrasement (rapport.pdf devient rapport (2).pdf), attribut de quarantaine posé, confirmation avant ouverture des fichiers pouvant exécuter du code. Rien ne s'ouvre automatiquement.

Secrets. Clés d'API dans le Trousseau (kSecAttrAccessibleWhenUnlockedThisDeviceOnly), envoyées uniquement dans un en-tête HTTP, jamais affichées de nouveau, jamais journalisées. HTTP non chiffré n'est accepté que pour localhost.

Depuis la 2.0, le jeton de session, la clé privée de l'appareil et la clé de compte SP Sync sont eux aussi au Trousseau, et nulle part ailleurs.

SP Intelligence. Désactivé par défaut ; aucun fournisseur préconfiguré. Le contenu d'une page n'est transmis qu'après une action de l'utilisateur et la validation d'un aperçu montrant le texte exact, la destination et le modèle. Défense contre l'injection d'invite : texte de la page entre des marqueurs à frontière aléatoire, marqueurs imités neutralisés — cela réduit le risque sans l'éliminer. L'assistant n'a aucun outil : il ne peut ni naviguer, ni cliquer, ni acheter, ni envoyer.

Compte et synchronisation (2.0).

Sujet Mesure
Authentification Clés d'accès WebAuthn par AuthenticationServices ; aucun mot de passe ; l'application ne reçoit qu'une signature, jamais de donnée biométrique
Domaine de confiance browser.spboucher.ai, lié à l'app par Associated Domains (webcredentials:) ; fichier d'association servi par le backend
Chiffrement des enregistrements ChaCha20-Poly1305, clé dérivée (HKDF-SHA256) de la clé de compte ; données authentifiées liant collection, identifiant et version
Identifiants côté serveur HMAC-SHA256 à clé : une URL ou une requête n'apparaît jamais en clair
Clé de compte Créée sur le premier appareil ; le serveur n'en reçoit qu'un vérificateur ; transmise aux autres appareils dans une enveloppe HPKE (Curve25519, SHA-256, ChaCha20-Poly1305) après comparaison d'un code
Clé de récupération Montrée une seule fois à la création ; en émettre une nouvelle invalide la précédente
Actions destructrices Nouvelle confirmation par clé d'accès (/api/auth/reauth)
Ce que le serveur voit Le nom des collections, des identifiants opaques, la taille et la date des enregistrements, le nom et le modèle des appareils
Limite connue Pas de rotation de clé au retrait d'un appareil (voir docs/SECURITY.md du backend)
Page de recherche Seul l'utilisateur peut ouvrir une adresse spsearch:// ; le contenu web ne peut pas y naviguer (testé sur macOS et iOS)

Signaler un problème : contact@spboucher.ai

# 🕶 Confidentialité

Détail : docs/PRIVACY.md. Aucune télémétrie. Compte et synchronisation facultatifs, chiffrés de bout en bout. Sans compte, rien n'est synchronisé et SP Browser fonctionne entièrement en local, à l'exception des recherches SP Search que vous lancez. Les seules connexions sortantes sont celles que vous déclenchez ou, une fois connecté, la synchronisation que vous avez activée.

Connexion Déclencheur Contenu
Sites web Vous naviguez Ce que WebKit envoie normalement à un site
SP Search (browser.spboucher.ai) Vous validez une recherche (Retour), changez de mode ou demandez plus de résultats La requête et ses filtres (langue, région, date, filtrage). Le serveur interroge le fournisseur de recherche sans y joindre votre compte ni votre adresse, ne journalise pas les requêtes et garde un cache en mémoire seulement. Rien n'est envoyé pendant la frappe
Autre moteur de recherche Vous l'avez choisi comme moteur par défaut ou utilisez son raccourci La requête, directement à ce moteur
Vignettes des résultats Une page de résultats images ou vidéos s'affiche Requêtes des images vers leurs sites d'origine, sans cookies, en mémoire seulement
Lecteur vidéo intégré Vous cliquez « Aperçu ici » Le lecteur de la plateforme (YouTube sans cookies, Vimeo, Dailymotion) dans une vue non persistante
SP Identity Vous créez un compte ou vous connectez Une signature de clé d'accès, le nom et le modèle de l'appareil, une clé publique. Jamais de donnée biométrique
SP Sync Vous êtes connecté et la synchronisation est activée Historique, signets, favoris, onglets ouverts, liste de lecture, historique et préférences de recherche — chiffrés sur l'appareil avec une clé que le serveur ne reçoit jamais
Icônes de sites Chargement d'une page Requête de l'icône, sans cookies, par une session éphémère distincte
Listes de blocage Vous cliquez « Mettre à jour » Téléchargement HTTPS sans cookies
SP Intelligence Vous lancez une action et validez l'aperçu Le texte affiché dans l'aperçu, vers le fournisseur que vous avez configuré

Navigation privée (vérifié par tests) : les pages visitées ne sont pas ajoutées à l'historique ; cookies, cache et stockage vivent en mémoire dans un magasin distinct et disparaissent à la fermeture ; une fenêtre privée ne voit pas les cookies de la session normale, et inversement ; les fenêtres privées ne sont jamais enregistrées dans une session ; les scripts utilisateur n'y tournent pas ; les recherches n'y sont pas ajoutées à l'historique de recherche ; rien de ce qui s'y passe n'est synchronisé (ni pages, ni recherches, ni onglets ouverts ou fermés ; liste de lecture et favoris y sont désactivés). Elle ne vous rend pas invisible : sites, employeur, école et fournisseur d'accès voient toujours votre activité ; les fichiers téléchargés et les signets ajoutés sont conservés — un signet ajouté volontairement depuis une fenêtre privée rejoint vos signets ordinaires et se synchronise comme eux ; une recherche SP Search y est envoyée au serveur comme en fenêtre ordinaire (elle n'y est pas journalisée).

Effacer : historique par visite, par site, par période ou en entier (l'historique de recherche part avec) ; historique de recherche entrée par entrée ou en entier ; copie synchronisée (Réglages → Compte → « Effacer les données synchronisées », le serveur seulement) ou « Supprimer le compte » ; données d'un site ; cookies un par un ; profil complet. Quand la synchronisation est active, les suppressions d'historique sont propagées aux autres appareils. Toute opération destructive demande confirmation.

# ✅ Tests et performance

Rapport complet : docs/TEST_REPORT.md — 2.0.0 (2), 2026-11-18, Apple M5 Max, 48 Go, macOS 27.0, Xcode 27.2, simulateurs iOS 26.5 (iPhone 17 Pro, iPad Pro 13"). Une seule machine. Aucun appareil iOS réel n'a été utilisé.

Suite Commande Résultat
Cœur : unitaires + intégration contre un vrai serveur local + recherche réelle scripts/test-backend.sh up, variables exportées, SPB_LIVE_SEARCH=1 swift test 110 / 110 (101 unitaires, 8 d'intégration multi-appareils, 1 recherche réelle web/images/vidéos par la production)
Application macOS (vrais WKWebView) scripts/test.sh app 35 / 35
Application iOS, tests hébergés (simulateur iPhone) scripts/ios-test.sh unit 7 / 7
Application iOS, tests d'interface (simulateur iPhone) scripts/ios-test.sh ui (xcodebuild … -scheme SPBrowserMobile test) 3 / 3 (dont une recherche réelle Tout → Images → Vidéos → résultat → retour) ; sur iPad : 7 unitaires + 1 test d'interface
Backend npm test sur le nœud 15 / 15 ; npm run test:live réussi
Localisation scripts/check-localization.py 889 clés (macOS + iOS), 889 traductions françaises, 0 problème
Version macOS scripts/verify-release.sh signée, notarisée, agrafée, acceptée par Gatekeeper
Fichier de tests Cible Tests
SPBrowser/Tests/CoreTests/NavigationAndSecurityTests.swift swift test 40
SPBrowser/Tests/CoreTests/StorageTests.swift swift test 28
SPBrowser/Tests/CoreTests/SearchAndSyncTests.swift (2.0) swift test 19
SPBrowser/Tests/CoreTests/AITests.swift swift test 14
SPBrowser/Tests/CoreTests/BackendIntegrationTests.swift (2.0 ; 8 d'intégration + 1 recherche réelle) swift test 9
SPBrowser/Tests/AppTests/EngineIntegrationTests.swift SPBrowserTests 15
SPBrowser/Tests/AppTests/WindowAndPrivacyTests.swift SPBrowserTests 14
SPBrowser/Tests/AppTests/SearchAndSyncAppTests.swift (2.0) SPBrowserTests 6
Mobile/Tests/MobileEngineTests.swift (2.0) SPBrowserMobileTests 7
Mobile/UITests/BrowserUITests.swift (2.0) SPBrowserMobileUITests 3
Total 155

SoftwareAuthenticator.swift (CoreTests) n'est pas une suite : c'est l'authentificateur logiciel (signatures ES256 réelles) qui remplace Touch ID dans les tests d'intégration.

Suite 2.0 Ce qu'elle exerce
Cœur, unitaires classification URL/requête, décodage des trois modes, chiffrement, enveloppes, clé de récupération, miroir, règles de fusion, ponts
Cœur, intégration deux à trois « appareils » contre un vrai serveur local : création de compte, enrôlement, synchro complète, doublons, conflits, hors ligne, révocation, récupération, effacement. Seul l'authentificateur est logiciel
Recherche réelle web, images et vidéos par la production (quelques crédits)
Application macOS recherche native dans de vrais WKWebView, précédent/suivant, refus de navigation depuis une page, isolement privé, commandes
Application iOS page de recherche native et précédent/suivant, refus depuis le contenu web, onglets privés sans trace ni publication, session restaurée paresseusement, fermeture/réouverture, suggestions locales, destinations de téléchargement sûres ; interface : trois modes de recherche, vue des onglets et mode privé, connexion par clé d'accès
Backend npm test, npm run test:live (sur le nœud) : normalisation, cache, plafond, erreurs, WebAuthn, synchro, administration

Les réponses du fournisseur ne sont simulées que pour vérifier la normalisation ; l'intégration réelle a ses propres tests, jamais remplacés par des simulations.

Tests du socle 1.0 par domaine (82 unitaires, toujours exécutés)
Domaine Tests Ce qui est vérifié
Barre d'adresse 11 URL explicites, hôtes nus → HTTPS, hôtes locaux → HTTP, IPv6, ports invalides, raccourcis de recherche, schémas dangereux recherchés et non chargés
Sécurité des URL 8 Verdicts par schéma, avertissements (identifiants intégrés, punycode, alphabets mélangés, IP, HTTP), domaine enregistrable
Téléchargements 5 Nettoyage des noms, unicité, niveau de risque
Bloqueur 8 JSON valide, règles tierces uniquement, exception par site, analyse des listes, HTTPS obligatoire
Permissions et scripts 4 Valeurs par défaut, persistance, zoom par site, correspondance d'hôtes sans joker universel
Commandes 4 Raccourcis par défaut sans conflit, remplacements, détection de conflits
SQLite et migrations 4 Migration v1 → v2 sans perte, retour arrière si échec, requêtes paramétrées
Historique 5 Seules les pages web sont enregistrées, regroupement des rechargements, suppression par site
Signets 5 Dossiers, tags, déplacements sans cycle, aller-retour HTML, fichiers hostiles
Notes 1 Clé sans fragment, suppression par note vide
Sessions 5 Aller-retour, repli sur la copie de secours, session corrompue mise à l'écart
Réglages et profils 8 Valeurs par défaut prudentes, ancien fichier migré, bases indépendantes par profil, journal expurgé
IA 14 Forme des requêtes Anthropic et compatibles OpenAI, clé jamais dans l'URL ni le corps, cloisonnement du contenu de page
Tests d'intégration macOS du socle 1.0 par parcours (29)

Exécutés dans le processus de l'application, avec un dossier de données temporaire et des magasins WebKit créés puis supprimés par chaque test. Les pages sont servies par loadSimulatedRequest / loadHTMLString : aucun serveur local.

Parcours Vérifié
Navigation Titre, adresse, état de sécurité, enregistrement dans l'historique
Garde-fous data: principal et file: depuis le web bloqués ; JavaScript désactivable par site ; fenêtres surgissantes
Erreurs Hôte inexistant → page d'erreur ; plantage du contenu → état « planté », rechargement
Page Recherche dans la page, extraction du lecteur, métadonnées, zoom mémorisé et borné
Bloqueur Règles compilées par WebKit ; requête tierce vers un hôte listé réellement refusée
Téléchargements Fichier enregistré, nom unique sans écrasement, contenu exact ; annulation sans fichier résiduel
Onglets et espaces Création, épinglage, réouverture, duplication, groupes, vue scindée ; onglets propres à chaque espace
Suspension et sessions Vue web libérée puis restaurée ; restauration paresseuse ; fenêtres privées exclues
Navigation privée Magasin non persistant, aucun cookie partagé, aucun historique
Profils Magasins WebKit, cookies et historiques distincts
Vérifications manuelles 2.0 et ce qui n'a pas été vérifié

Vérifié à la main :

  • macOS, build de développement : page de résultats native avec de vrais résultats (résumé, favicons, surlignage), mosaïque d'images, grille de vidéos confirmées, écran Compte en français.
  • macOS, app notarisée installée dans /Applications : lancement avec les données de la 1.0.0 (réglages migrés), feuille système de clé d'accès ouverte au nom de SP Browser puis annulée ; aucun compte créé sur le serveur.
  • iOS, simulateur : 15 captures dans docs/screenshots/ios/.

Non vérifié en 2.0 :

  • Cérémonie réelle de clé d'accès (Touch ID sur Mac, Face ID sur iPhone) : création de compte, connexion, confirmation avant action destructrice. Toute la chaîne est testée avec un authentificateur logiciel contre un vrai serveur ; seule la partie matérielle manque. Sur le simulateur iOS, le bouton de connexion n'a produit ni feuille système ni erreur visible en 12 s.
  • Synchronisation entre deux appareils physiques (Mac ↔ Mac, Mac ↔ iPhone) : vérifiée entre instances du même code dans un seul processus de test, jamais entre machines.
  • iOS sur appareil réel : Face ID, caméra/micro, retour haptique, téléchargements visibles dans Fichiers, comportement en arrière-plan.
  • iOS, écrits mais non exercés : panneaux latéraux iPad, raccourcis clavier matériel, fenêtres multiples, glisser-déposer, tirer pour actualiser, recherche dans la page, page d'erreur, VoiceOver, Dynamic Type.
  • macOS, écrits mais non exercés à la main : panneaux Liste de lecture et Autres appareils avec des données, aperçu d'image plein format, lecteur vidéo intégré, enregistrement d'image, personnalisation de la page de démarrage.
  • Chemin YouTube Data API (durée et date des vidéos) : testé contre un faux serveur seulement, aucune clé fournie.
  • Toujours valables depuis la 1.0 : invite caméra / micro par site, envoi réel SP Intelligence, dialogues d'authentification HTTP, impression, partage, éditeur de signets, glisser-déposer des onglets, onglets verticaux, plein écran, audit VoiceOver, macOS 14 à 26 et Mac Intel.

Performance — mesures de la 1.0.0 (non refaites pour la 2.0) : build Release, scripts/perf.sh dist/SPBrowser.app, dossier de données vide à chaque mesure, échantillon 20 s après le lancement.

Onglets Lancement → première fenêtre Application Processus WebKit Total
1 (page de démarrage, aucune vue web) 439 ms 110 Mo 0 Mo 110 Mo
10 (9 articles Wikipédia) 447 ms 135 Mo 1 022 Mo (11 processus) 1 157 Mo
30 (29 articles Wikipédia) 816 ms 163 Mo 2 939 Mo (31 processus) 3 102 Mo

Environ 100 Mo par page chargée (coût normal d'un processus de contenu WebKit) ; l'application elle-même croît d'environ 2 Mo par onglet. Limites du protocole : une seule série, mémoire mesurée en RSS, tous les onglets chargés d'emblée (cas défavorable). Aucune comparaison avec Safari n'a été faite.

# 📦 Publication

Détail : docs/RELEASE.md.

bash
scripts/provision.py            # identifiant d'app, capacité Associated Domains, profil Developer ID (idempotent ; à relancer si une capacité change)
scripts/build-release.sh        # archive Release signée avec le profil → dist/SPBrowser.app
scripts/notarize.sh             # notarisation + agrafage de l'app, puis de l'image disque
scripts/verify-release.sh       # doit finir par « RELEASE VERIFIED: signed, notarized, stapled » (code 3 = signé mais non notarisé)
scripts/ios-release.sh all      # archive iOS + IPA (augmenter CURRENT_PROJECT_VERSION avant chaque envoi)
scripts/ios-release.sh upload   # TestFlight

# macOS — état au 2026-11-18, version 2.0.0 (2)

Élément État
dist/SPBrowser.app 2.0.0 (2), universel arm64 + x86_64 Signé Developer ID Application avec le profil « SP Browser Developer ID » (droit com.apple.developer.associated-domains = webcredentials:browser.spboucher.ai), Hardened Runtime, App Sandbox, horodatage sécurisé
Notarisation de l'application Acceptée par Apple, ticket agrafé
dist/SPBrowser.dmg (4,8 Mo) Signé, notarisation acceptée, ticket agrafé
Gatekeeper spctl --assess : « Notarized Developer ID » pour l'application et l'image disque
SHA-256 du DMG 2b6ae7fc9247191e2308cd765c9077e09bda020edbe2a4439ccdec33da227d3f
Installation Installée depuis l'image disque dans /Applications/SP Browser.app sur le poste de développement (la 1.0.0 est archivée dans dist/previous/). Lancement vérifié avec les données existantes de la 1.0.0
Clés d'accès Depuis l'app installée, « Se connecter avec une clé d'accès » ouvre la feuille système au nom de SP Browser (défi fourni par le serveur de production, association de domaine reconnue). La cérémonie complète avec Touch ID n'a pas été exécutée : elle demande le propriétaire
Publication sur spbgit Le code 2.0.0 est sur main ; le DMG 2.0.0 n'est pas déposé sur la forge et il n'y a pas de tag v2.0.0 (seul v1.0.0 existe). docs/RELEASE.md note encore le git push comme « non fait » : il date d'avant la mise en ligne du code

# iOS / iPadOS — état au 2026-11-18, version 2.0.0 (2)

Élément État
Identifiant ai.spboucher.spbrowser (le même que l'app macOS), domaines associés activés
Fiche App Store Connect « SP Browser », id 6836530354, SKU spbrowser-ios-001, langue principale fr-CA
Archive scripts/ios-release.sh all → 2.0.0 (2), signature automatique App Store Connect, droit webcredentials:browser.spboucher.ai présent dans l'archive (vérifié par le script, avertissement sinon)
Envoi scripts/ios-release.sh upload → UPLOAD SUCCEEDED
TestFlight Groupe interne « Interne » (accès à tous les builds), titulaire du compte comme testeur

Les apps iOS ne sont pas notarisées : la distribution passe par App Store Connect / TestFlight. Aucune soumission à la revue de l'App Store n'a été faite. ios-release.sh lit la clé d'API App Store Connect déjà présente sur le Mac (scripts/asc.py), n'affiche rien de secret, écrit ses journaux dans build/logs/ et l'IPA dans dist/ios-export/.

# Version 1.0.0 (1) — 2026-11-17

Signée Developer ID, notarisée, agrafée ; SPBrowser.dmg (3,6 Mo) publié sur spbgit avec le tag v1.0.0 : https://git.spboucher.ai/releases/sp-browser/v1.0.0/SPBrowser.dmg. Le fichier a été déposé par SSH dans le dossier des versions de la forge avec son fichier .sha256, faute de jeton d'API sur le poste (spbgit release upload sp-browser v1.0.0 dist/SPBrowser.dmg fait la même chose avec un jeton).

# Ce que font les scripts

  • build-release.sh : régénère le projet (xcodegen), xcodebuild archive en Release avec signature manuelle Developer ID, --timestamp --options=runtime, sans entitlement de débogage ; copie l'application dans dist/ et vérifie la signature. Refuse de continuer sans identité Developer ID (une identité Development ou Mac App Store ne convient pas à la distribution directe).
  • notarize.sh : compresse l'application avec ditto, notarytool submit --wait, n'annonce « notarized » que si le statut renvoyé est Accepted, agrafe et valide ; construit ensuite le DMG à partir de l'application agrafée, le signe, le soumet, l'agrafe. En cas de refus, récupère le journal Apple dans build/ et sort avec un code d'erreur.
  • verify-release.sh : codesign --verify --deep --strict, autorité de signature, runtime, horodatage, entitlements (présence du bac à sable, absence de get-task-allow et d'exceptions), stapler validate, spctl --assess.
  • provision.py : réutilise l'identifiant d'app, la capacité et le certificat Developer ID existants ; aucun certificat n'est jamais créé.

Les scripts n'affichent que le nom de l'identité ; ils ne créent, ne lisent ni ne modifient aucun identifiant.

Versionnement. MARKETING_VERSION et CURRENT_PROJECT_VERSION sont dans project.yml. Incrémenter le numéro de build à chaque soumission (macOS comme TestFlight). L'identifiant ai.spboucher.spbrowser suit la convention des autres applications du poste ; le changer change aussi le conteneur de données de l'application.

Avant une diffusion publique : tester le DMG sur un autre Mac (idéalement macOS 14 et un Mac Intel) ; mener les vérifications manuelles listées « Non vérifié » ; décider d'un canal de mise à jour (il n'y en a aucun — pas de Sparkle ni équivalent, par cohérence avec « aucune connexion non sollicitée »). Mac App Store : non visé (il faudrait une identité et un profil de distribution distincts).

# 🎨 Identité visuelle

Charte complète : docs/BRAND.md. Direction artistique : informatique de précision, verre, navigation spatiale.

Nom Hex Usage
Graphite 900 #0B0E14 Fond de fenêtre (sombre), bas du corps de l'icône
Graphite 800 #151A24 Barre latérale et barre d'outils (sombre)
Graphite 700 #1E2533 Surfaces surélevées, cartes, champ d'adresse (sombre)
Bleu électrique #2F6BFF Accent principal (thème clair), liens, focus, progression
Bleu électrique clair #5B8CFF Accent principal (thème sombre)
Cyan lumineux #22D3EE Signal d'activité : chargement, satellite de l'icône
Violet #7C5CFF Accent secondaire : navigation privée, extrémité des dégradés

Dégradé signature : #7C5CFF → #2F6BFF → #22D3EE. Sources SVG, trois concepts explorés et rendus dans Assets/Brand/ ; Assets/Brand/build-icons.sh régénère les icônes.

# 🩺 Pièges connus

Piège Détail
Notarisation en HTTP 403 — A required agreement is missing or has expired accord à signer par le titulaire du compte développeur ; les deux premières tentatives de la 1.0.0 ont échoué pour cette raison
verify-release.sh sort avec le code 3 l'application est signée mais pas encore notarisée
Droit webcredentials: et profil de provisionnement (macOS) le droit de domaine associé passe par le profil « SP Browser Developer ID » : relancer scripts/provision.py si une capacité change, puis build-release.sh
Build Debug macOS et app installée le build Debug porte ai.spboucher.spbrowser.debug : c'est une autre app pour le système (trousseau, domaines associés, Launch Services) ; il cohabite avec l'app installée sans perturber son association de domaine
Nouvel envoi TestFlight augmenter CURRENT_PROJECT_VERSION dans project.yml avant chaque envoi (manageAppVersionAndBuildNumber est désactivé dans les options d'export)
ios-release.sh affiche « WARNING: associated domains entitlement missing » l'archive n'a pas le droit webcredentials: : les clés d'accès ne fonctionneront pas
Simulateur iOS : le bouton de connexion ne produit ni feuille système ni erreur constaté en 12 s sur le simulateur ; la cérémonie de clé d'accès se valide sur appareil réel
Tests d'intégration compte / synchro ignorés ils ne tournent qu'avec les variables affichées par scripts/test-backend.sh up ; le test de recherche réelle demande SPB_LIVE_SEARCH=1 (consomme quelques crédits du fournisseur)
scripts/ios-test.sh ui consomme des crédits le test de recherche interroge SP Search en production
Port du backend de test occupé scripts/test-backend.sh down arrête ce qui écoute sur le port de test, par PID (jamais par nom)
Pages suivantes de SP Search différentes le fournisseur n'a pas de décalage : les pages suivantes sont des résultats d'autres domaines
Vidéos YouTube sans durée ni date il faut une clé YouTube Data API côté backend ; chemin testé contre un faux serveur seulement
Requête tapée envoyée à DuckDuckGo après mise à jour non : la migration v2 → v3 remplace l'ancien défaut duckduckgo par SP Search ; un autre moteur choisi délibérément est conservé
Fichier HTML local sans ses ressources bac à sable : l'accès est limité au fichier ouvert, ses ressources voisines ne sont pas lisibles
Onglet restauré sans favicon les favicons sont en mémoire seulement : une initiale s'affiche jusqu'au chargement
Reprise d'un téléchargement impossible seulement si le serveur fournit des données de reprise et tant que l'onglet d'origine existe
Pas de compteur d'éléments bloqués WebKit applique les règles sans rien rapporter
Inspecteur web absent désactivé en Release par choix (disponible dans les builds de développement)
XCUITest sur macOS non tenté : inutilisable sur le poste de développement avec Xcode 27.2 / macOS 27.0 (les tests d'interface existent côté iOS)
Deux dossiers de données ne partagent jamais un magasin WebKit (identifiant de profil propre à chaque dossier)

# ⚠️ Limites connues

  • Extensions Chrome, Firefox et Safari non prises en charge.
  • Géolocalisation, notifications web et presse-papiers non réglables par site (aucune API publique).
  • Pas de mise à jour automatique.
  • SP Search dépend de son fournisseur : pas de suggestions en ligne ni de recherches associées, vidéos limitées à YouTube, Vimeo et Dailymotion, durée des vidéos YouTube absente sans clé YouTube Data API.
  • La cérémonie réelle de clé d'accès et la synchronisation entre deux appareils physiques restent à valider par le propriétaire (voir docs/TEST_REPORT.md).
  • L'app iOS n'a ni bloqueur de contenu, ni lecteur, ni profils (ni permissions par site) ; elle n'a été exercée que sur simulateur.
  • Seul le profil par défaut se synchronise ; pas de rotation de la clé de compte au retrait d'un appareil.
  • Plusieurs écrans de l'interface n'ont pas encore été exercés à la main : voir la section « Non vérifié » de docs/TEST_REPORT.md.
  • macOS 14 à 26 et Mac Intel : non testés (le binaire est universel).
  • Le bloqueur n'agit que sur des requêtes tierces vers des domaines listés ; il ne remplace pas un bloqueur complet.
  • Le découpage du domaine enregistrable est une approximation, pas la Public Suffix List complète.

# 📚 Documentation

Document Contenu
docs/SP_BROWSER_2.md SP Search, SP Identity, SP Sync, partage macOS/iOS, tests
docs/ARCHITECTURE.md Couches, cycle de vie des vues web, profils, persistance
docs/SECURITY.md Garde-fous, permissions, limites de WebKit
docs/PRIVACY.md Ce qui sort du Mac, ce qui y reste, navigation privée
docs/FEATURE_MATRIX.md Statut réel de chaque fonctionnalité
docs/TEST_REPORT.md Résultats des tests, mesures, ce qui n'a pas été vérifié
docs/RELEASE.md Signature, notarisation, vérification, TestFlight
docs/AUTOMATION.md Commandes, App Intents, scripts, extensions
docs/BRAND.md Identité visuelle et icône
docs/ENVIRONMENT_AUDIT.md Audit du poste de développement

Dépôt sœur : sp-browser-backend (README.md, docs/SECURITY.md, docs/OPERATIONS.md).

# 👤 Auteur


Simon-Pierre Boucher — conception, développement, exploitation
www.spboucher.ai · git.spboucher.ai · contact@spboucher.ai

# 📄 Licence

Le dépôt ne contient pas de fichier de licence. © 2026 Simon-Pierre Boucher — tous droits réservés.

Clone sp-browser

Anonymous clone and fetch. Pushing requires the owner's personal access token.

Snapshot of main

Files main
Menu

Theme