feat(p11): temps réel complet (watcher checkout principal + topic settings)

P11-A — branche du checkout principal modifiée hors Arboretum :
- fs-watcher: pin « permanent » non évinçable (pinRepo/unpinRepo, repoPins dans evictIfNeeded)
- worktree-manager: armMainCheckoutWatchers() + arm/désarm sur addRepo/découverte/removeRepo/hidden
- index.ts: armMainCheckoutWatchers() dans runDaemon → git checkout CLI sur le principal → worktree_update <500ms sans watch client

P11-B — réglages en temps réel :
- protocole additif: type SettingsBroadcast (source unique, réutilisé par SettingsResponse), topic 'settings', message settings_update (validés parseClientMessage + gateway)
- core/settings-bus.ts (EventEmitter) ; routes/settings émet après PATCH ; gateway relaie aux abonnés 'settings'
- web: ws-client subscribeSettings + routage ; store settings applySettings/startRealtime ; AppShell abonne globalement ; SettingsView re-sync des drafts scalaires sans écraser une saisie en cours
- tests: protocol (topic settings) + fs-watcher (pinRepo non évincé) ; acceptance-p11.mjs (checkout principal <500ms + settings_update)

packages/shared/src/api.ts

@@ -1,5 +1,5 @@
 // Types REST partagés (préfixe /api/v1).
-import type { GroupSummary, PostCreateHook, RepoSummary, SessionSummary, WorktreeSummary } from './protocol.js';
+import type { GroupSummary, PostCreateHook, RepoSummary, SessionSummary, SettingsBroadcast, WorktreeSummary } from './protocol.js';
 
 export interface ApiError {
   error: { code: string; message: string; details?: unknown };
@@ -413,21 +413,8 @@ export interface ClaudeBinDiagnostic {
   ok: boolean;
 }
 export interface SettingsResponse {
-  /** réglages modifiables à chaud (allow-list serveur — jamais les secrets). */
-  settings: {
-    /** racines absolues scannées pour la découverte auto des repos (défaut : aucune → pas de scan). */
-    scanRoots: string[];
-    /** intervalle du re-scan périodique en minutes ; 0 = périodique désactivé. */
-    scanIntervalMin: number;
-    /** chemin explicite du binaire `claude` ; null = auto-détection via PATH. Effet : prochaine session. */
-    claudeBinPath: string | null;
-    /** override de la racine ~/.claude ; null = défaut. Effet : au redémarrage du daemon. */
-    claudeHome: string | null;
-    /** rétention des sessions terminées : auto-archivage après N jours ; 0 = jamais (P10). */
-    retentionDays: number;
-    /** purge définitive après N jours ; 0 = désactivée (conçue mais off par défaut). */
-    purgeDays: number;
-  };
+  /** réglages modifiables à chaud (allow-list serveur — jamais les secrets). Cf. SettingsBroadcast. */
+  settings: SettingsBroadcast;
   server: ServerInfo;
 }
 export interface UpdateSettingsRequest {

packages/shared/src/protocol.ts

@@ -207,6 +207,24 @@ export interface GroupSummary {
   updatedAt: string;
 }
 
+// ---- Réglages diffusables (P11) ----
+// Sous-ensemble NON sensible des réglages, transporté tel quel par `settings_update` et par la
+// réponse REST GET /settings (source de vérité unique du type). JAMAIS de secret ici.
+export interface SettingsBroadcast {
+  /** racines absolues scannées pour la découverte auto des repos (défaut : aucune → pas de scan). */
+  scanRoots: string[];
+  /** intervalle du re-scan périodique en minutes ; 0 = périodique désactivé. */
+  scanIntervalMin: number;
+  /** chemin explicite du binaire `claude` ; null = auto-détection via PATH. */
+  claudeBinPath: string | null;
+  /** override de la racine ~/.claude ; null = défaut. */
+  claudeHome: string | null;
+  /** rétention des sessions terminées : auto-archivage après N jours ; 0 = jamais (P10). */
+  retentionDays: number;
+  /** purge définitive après N jours ; 0 = désactivée. */
+  purgeDays: number;
+}
+
 // ---- Messages client → serveur ----
 export type ClientMessage =
   | { type: 'hello'; protocol: number }
@@ -219,7 +237,7 @@ export type ClientMessage =
   | { type: 'answer'; channel: number; action: 'select' | 'confirm' | 'deny'; optionN?: number }
   | { type: 'resize'; channel: number; cols: number; rows: number }
   | { type: 'ack'; channel: number; bytes: number }
-  | { type: 'sub'; topics: Array<'sessions' | 'worktrees' | 'groups'> }
+  | { type: 'sub'; topics: Array<'sessions' | 'worktrees' | 'groups' | 'settings'> }
   // P7 — abonnement ciblé au détail d'un worktree (diff/statut fin) : on ne pousse le détail
   // qu'aux connexions qui « regardent » ce worktree (clé = repoId + path), indépendamment du
   // topic global 'worktrees' (qui ne transporte que les compteurs légers).
@@ -238,6 +256,9 @@ export type ServerMessage =
   // P10 — une session managée vient d'être archivée (auto par ancienneté ou manuellement). Signal
   // léger : le client met à jour son row (badge archived) et le retire si « Show archived » est off.
   | { type: 'session_archived'; sessionId: string }
+  // P11 — un réglage a changé (PATCH /settings) : on diffuse le snapshot non sensible aux abonnés
+  // du topic 'settings' pour que tous les clients (et onglets) se synchronisent sans polling.
+  | { type: 'settings_update'; settings: SettingsBroadcast }
   | { type: 'repo_update'; repo: RepoSummary }
   | { type: 'repo_removed'; repoId: string }
   | { type: 'worktree_update'; repoId: string; worktree: WorktreeSummary }
@@ -305,8 +326,8 @@ export function parseClientMessage(raw: string): ClientMessage | null {
         ? { type: 'ack', channel: m.channel, bytes: m.bytes }
         : null;
     case 'sub':
-      return Array.isArray(m.topics) && m.topics.every((t) => t === 'sessions' || t === 'worktrees' || t === 'groups')
-        ? { type: 'sub', topics: m.topics as Array<'sessions' | 'worktrees' | 'groups'> }
+      return Array.isArray(m.topics) && m.topics.every((t) => t === 'sessions' || t === 'worktrees' || t === 'groups' || t === 'settings')
+        ? { type: 'sub', topics: m.topics as Array<'sessions' | 'worktrees' | 'groups' | 'settings'> }
         : null;
     case 'watch':
     case 'unwatch':

packages/shared/test/protocol.test.ts

@@ -62,7 +62,7 @@ function assertInvariants(msg: ClientMessage): void {
       expect(msg.bytes).toBeGreaterThanOrEqual(0);
       break;
     case 'sub':
-      expect(msg.topics.every((t) => t === 'sessions' || t === 'worktrees' || t === 'groups')).toBe(true);
+      expect(msg.topics.every((t) => t === 'sessions' || t === 'worktrees' || t === 'groups' || t === 'settings')).toBe(true);
       break;
     case 'ping':
       break;
@@ -128,6 +128,12 @@ describe('parseClientMessage — cas valides', () => {
     expect(parseClientMessage('{"type":"sub","topics":[]}')).toEqual({ type: 'sub', topics: [] });
   });
 
+  it('sub accepte le topic settings (P11) et rejette un topic inconnu', () => {
+    expect(parseClientMessage('{"type":"sub","topics":["settings"]}')).toEqual({ type: 'sub', topics: ['settings'] });
+    expect(parseClientMessage('{"type":"sub","topics":["sessions","settings"]}')).toEqual({ type: 'sub', topics: ['sessions', 'settings'] });
+    expect(parseClientMessage('{"type":"sub","topics":["bogus"]}')).toBeNull();
+  });
+
   it('watch / unwatch (P7) avec repoId + path', () => {
     expect(parseClientMessage('{"type":"watch","repoId":"r1","path":"/home/u/wt"}')).toEqual({ type: 'watch', repoId: 'r1', path: '/home/u/wt' });
     expect(parseClientMessage('{"type":"unwatch","repoId":"r1","path":"/home/u/wt"}')).toEqual({ type: 'unwatch', repoId: 'r1', path: '/home/u/wt' });