@nightkatana/kronosys-app 1.0.0-beta.21 → 1.0.0-beta.22

package/lib/dashboardCopy.ts

@@ -9,13 +9,8 @@ export type DashboardStrings = {
   kronoFocusStart: string;
   kronoFocusPause: string;
   kronoFocusReset: string;
-  /** Paragraphe du popover d’aide du panneau KronoFocus ; vide = pas d’aide (le bouton ? est masqué). */
-  kronoFocusStandaloneSubtitle: string;
-  /** Deuxième paragraphe du même popover ; vide = ignoré. */
-  kronoFocusAutoRefreshNote: string;
-  /** aria-label du bouton d’aide à côté du titre KronoFocus. */
-  kronoFocusPanelHelpAriaLabel: string;
-  kronoFocusLiveWhileViewingArchive: string;
+  /** Infobulle des boutons KronoFocus désactivés pendant la consultation d’une archive. */
+  kronoFocusControlsReadOnlyTooltip: string;
   /** Ligne sous KronoFocus quand il a été lancé depuis une tâche (avant le nom cliquable) */
   kronoFocusLinkedTaskIntro: string;
   kronoFocusEditDurationTitle: string;
@@ -712,8 +707,10 @@ export type DashboardStrings = {
   reportingTourStep3Body: string;
   reportingTourStep4Title: string;
   reportingTourStep4Body: string;
-  reportingTourStep5Title: string;
-  reportingTourStep5Body: string;
+  reportingTourStep5aTitle: string;
+  reportingTourStep5aBody: string;
+  reportingTourStep5bTitle: string;
+  reportingTourStep5bBody: string;
   reportingTourStep6Title: string;
   reportingTourStep6Body: string;
   /** Modale « nouvelle session » — titre. */
@@ -766,6 +763,28 @@ export type DashboardStrings = {
   appShellRouteNavGlobalResume: string;
   /** Infobulle lorsque la pause globale est inactive (rien ne tourne). */
   appShellRouteNavGlobalPauseDisabledTooltip: string;
+  /** Infobulle : Gantt du jour uniquement depuis le tableau de bord. */
+  appShellRouteNavGanttDashboardOnlyTooltip: string;
+  /** Infobulle : pause globale uniquement depuis le tableau de bord (session live). */
+  appShellRouteNavGlobalPauseDashboardOnlyTooltip: string;
+  /** Infobulle : pause globale indisponible sur le tableau de bord (archive consultée ou chargement). */
+  appShellRouteNavGlobalPauseNoSessionContextTooltip: string;
+  /** Infobulle : entrée changelog masquée sur cette route (libellé vide). */
+  appShellRouteNavChangelogUnavailableTooltip: string;
+  /** Infobulle : entrée implémentation masquée sur cette route (libellé vide). */
+  appShellRouteNavImplementationUnavailableTooltip: string;
+  /** `aria-label` du bandeau KronoFocus pendant l’absence de charge utile session. */
+  appShellHeaderKronoFocusLoadingAria: string;
+  /** `aria-label` du groupe de navigation : tableau de bord, rapports, paramètres, journaux. */
+  appShellRouteNavGroupAppAria: string;
+  /** `aria-label` du groupe : guide, détails d’implémentation. */
+  appShellRouteNavGroupDocsAria: string;
+  /** `aria-label` du groupe : Gantt du jour, pause globale (ou emplacement réservé). */
+  appShellRouteNavGroupToolsAria: string;
+  /** `aria-label` du groupe : page licences (lecture seule). */
+  appShellRouteNavGroupLegalAria: string;
+  /** `aria-label` du ruban : thème, rafraîchissement, langue. */
+  appShellUtilityToolbarGroupAria: string;
   /** Modale — titre avant d’activer la pause globale. */
   globalPauseConfirmTitle: string;
   /** Modale — texte d’introduction (comportement + liste à suivre). */
@@ -863,12 +882,8 @@ const en: DashboardStrings = {
   kronoFocusStart: "Start",
   kronoFocusPause: "Pause",
   kronoFocusReset: "Reset",
-  kronoFocusStandaloneSubtitle:
-    "KronoFocus is Kronosys’s attention rhythm: one work segment at a time (duration you set), short pauses between segments, and a longer pause after several cycles. The counters and phases belong to Kronosys—they are not a Pomodoro timer clone.",
-  kronoFocusAutoRefreshNote: "",
-  kronoFocusPanelHelpAriaLabel: "KronoFocus panel help",
-  kronoFocusLiveWhileViewingArchive:
-    "While you browse an archived session, this still shows KronoFocus for the active live session (if any).",
+  kronoFocusControlsReadOnlyTooltip:
+    "Read-only while you inspect an archive — these controls target the live session.",
   kronoFocusLinkedTaskIntro: "Started from:",
   kronoFocusEditDurationTitle: "Configure KronoFocus rhythm (timer not started)",
   kronoFocusDurationPickerLabel: "Duration (hours : minutes : seconds)",
@@ -1384,7 +1399,7 @@ const en: DashboardStrings = {
     "This area shows your Git author line and forge account when they are configured in Settings → Git identity, the workspace roots detected for metrics, and a small badge for how session data is stored here: SQLite (default), JSON driver, or MongoDB mirror when enabled.\n\nSQLite keeps the dashboard payload on this machine under your Kronosys data directory; this page reads and writes it through the local API.",
   tourStep8Title: "What is KronoFocus?",
   tourStep8Body:
-    "**KronoFocus** paces your session with a configurable work segment, short breaks, then a long break after several cycles. It is built into Kronosys (counts, phases, how it ties to the session) and is not limited to a fixed Pomodoro-style recipe.\n\nShowing it here or next to task actions is configured under Settings → Dashboard & API (KronoFocus).",
+    "**KronoFocus** paces your session with a configurable work segment, short breaks, then a long break after several cycles. It is built into Kronosys (counts, phases, how it ties to the session) and is not limited to a fixed Pomodoro-style recipe.\n\nThe header toolbar always includes KronoFocus so navigation stays aligned on every page. Whether you also show it next to task actions is configured under Settings → Dashboard & API (KronoFocus).",
   tourStep8LearnMoreUrl: "https://en.wikipedia.org/wiki/Time_management",
   tourStep8LearnMoreLabel: "Further reading — time management (new tab)",
   tourStep8LearnMoreAriaLabel: "Opens the English Wikipedia article on time management in a new tab",
@@ -1432,9 +1447,12 @@ const en: DashboardStrings = {
   reportingTourStep4Title: "Daily charts",
   reportingTourStep4Body:
     "Bar views show sessions, tasks by status, recorded task time, and session wall-clock by calendar day. When several weeks exist, use the week strip to align charts and tag calendars.",
-  reportingTourStep5Title: "Time by tag and by project",
-  reportingTourStep5Body:
-    "Review recorded task minutes grouped by #tags (including the untagged bucket when it applies) and by @project, with weekly grids when data spans multiple days.",
+  reportingTourStep5aTitle: "Time by tag",
+  reportingTourStep5aBody:
+    "Review recorded task minutes grouped by #tags (including the untagged bucket when it applies), with weekly grids when data spans multiple days.",
+  reportingTourStep5bTitle: "Time by project (Work vs Personal)",
+  reportingTourStep5bBody:
+    "The weekly-by-project grid has a Work (@) / Personal (!) toggle under the section title: Work (default) excludes personal-ledger minutes; Personal shows only that ledger (including tasks inferred from a ! token in the title when the saved flag is missing). Tag totals above still mix both ledgers unless you filter by tags.",
   reportingTourStep6Title: "Outline and two-column layout",
   reportingTourStep6Body:
     "This block is the main Reporting layout: your content on the left and, on wide screens, a sticky jump list on the right. On phones, the same anchors appear as chips above the filters.",
@@ -1483,6 +1501,22 @@ const en: DashboardStrings = {
   appShellRouteNavGlobalResume: "Resume everything paused by global pause in this context",
   appShellRouteNavGlobalPauseDisabledTooltip:
     "Nothing is active to pause: the session wall clock is already paused and no task or subtask timer is running.",
+  appShellRouteNavGanttDashboardOnlyTooltip:
+    "Today’s Gantt is available from the dashboard only.",
+  appShellRouteNavGlobalPauseDashboardOnlyTooltip:
+    "Global pause is available from the dashboard when a live session is loaded.",
+  appShellRouteNavGlobalPauseNoSessionContextTooltip:
+    "Global pause is not available while you inspect an archived session or before the live session is loaded.",
+  appShellRouteNavChangelogUnavailableTooltip:
+    "Changelog shortcut is hidden on this screen (no label).",
+  appShellRouteNavImplementationUnavailableTooltip:
+    "Implementation shortcut is hidden on this screen (no label).",
+  appShellHeaderKronoFocusLoadingAria: "KronoFocus — waiting for session data",
+  appShellRouteNavGroupAppAria: "Main app areas",
+  appShellRouteNavGroupDocsAria: "Help and reference",
+  appShellRouteNavGroupToolsAria: "In-session tools",
+  appShellRouteNavGroupLegalAria: "Legal information",
+  appShellUtilityToolbarGroupAria: "Display and language",
   globalPauseConfirmTitle: "Global pause",
   globalPauseConfirmIntro:
     "Global pause freezes the session wall clock when it is running, pauses each task timer that is not already paused, and stops any active subtask timer (recording elapsed time). The next click on this control resumes only what was paused in this operation.\n\nReview what will be affected:",
@@ -1540,12 +1574,8 @@ const fr: DashboardStrings = {
   kronoFocusStart: "Démarrer",
   kronoFocusPause: "Pause",
   kronoFocusReset: "Réinitialiser",
-  kronoFocusStandaloneSubtitle:
-    "KronoFocus est le rythme d’attention intégré à Kronosys : un segment de travail à la fois (durée au choix), des pauses courtes entre segments, puis une pause longue après plusieurs cycles. Les compteurs et phases sont propres à Kronosys — ce n’est pas un clone de minuteur Pomodoro.",
-  kronoFocusAutoRefreshNote: "",
-  kronoFocusPanelHelpAriaLabel: "Aide sur le panneau KronoFocus",
-  kronoFocusLiveWhileViewingArchive:
-    "Pendant la consultation d’une session archivée, ce panneau affiche encore KronoFocus pour la session en cours (s’il y en a une).",
+  kronoFocusControlsReadOnlyTooltip:
+    "Lecture seule pendant l’inspection d’une archive — ces commandes s’appliquent à la session en cours.",
   kronoFocusLinkedTaskIntro: "Lancé depuis :",
   kronoFocusEditDurationTitle: "Configurer le rythme KronoFocus (minuteur non démarré)",
   kronoFocusDurationPickerLabel: "Durée (heures : minutes : secondes)",
@@ -2077,7 +2107,7 @@ const fr: DashboardStrings = {
     "Ici s’affichent la ligne d’auteur Git et le compte forge lorsqu’ils sont renseignés dans Paramètres → Identité Git, les racines de workspace détectées pour les métriques, et une pastille indiquant comment les sessions sont enregistrées ici : SQLite (par défaut), pilote JSON ou miroir MongoDB si activé.\n\nSQLite conserve la charge utile du tableau de bord sur cette machine dans le répertoire de données Kronosys ; cette page lit et écrit via l’API locale.",
   tourStep8Title: "Qu’est-ce que KronoFocus ?",
   tourStep8Body:
-    "**KronoFocus** cadence votre session : un segment de travail dont vous choisissez la durée, des pauses courtes, puis une pause longue après plusieurs cycles. Ce dispositif est intégré à Kronosys (compteurs, phases, lien à la session) ; il ne se résume pas à une méthode Pomodoro figée.\n\nL’affichage dans l’en-tête ou à côté des actions de tâche se règle dans Paramètres → Tableau de bord et API (section KronoFocus).",
+    "**KronoFocus** cadence votre session : un segment de travail dont vous choisissez la durée, des pauses courtes, puis une pause longue après plusieurs cycles. Ce dispositif est intégré à Kronosys (compteurs, phases, lien à la session) ; il ne se résume pas à une méthode Pomodoro figée.\n\nLa barre d’outils affiche toujours KronoFocus pour garder la navigation alignée sur toutes les pages. L’affichage à côté des actions de tâche se règle toujours dans Paramètres → Tableau de bord et API (section KronoFocus).",
   tourStep8LearnMoreUrl: "https://fr.wikipedia.org/wiki/Gestion_du_temps",
   tourStep8LearnMoreLabel: "Pour aller plus loin — gestion du temps (nouvel onglet)",
   tourStep8LearnMoreAriaLabel: "Ouvre l’article Wikipédia sur la gestion du temps dans un nouvel onglet",
@@ -2125,9 +2155,12 @@ const fr: DashboardStrings = {
   reportingTourStep4Title: "Graphiques par jour",
   reportingTourStep4Body:
     "Les barres montrent les sessions, les tâches par état, le temps enregistré sur les tâches et la durée murale des sessions par jour calendaire. Quand plusieurs semaines existent, la bande de navigation aligne graphiques et calendriers par étiquette.",
-  reportingTourStep5Title: "Temps par étiquette et par projet",
-  reportingTourStep5Body:
-    "Consultez les minutes enregistrées sur les tâches regroupées par #étiquettes (y compris le compartiment sans étiquette explicite le cas échéant) et par @projet, avec des grilles hebdomadaires lorsque les données couvrent plusieurs jours.",
+  reportingTourStep5aTitle: "Temps par étiquette",
+  reportingTourStep5aBody:
+    "Consultez les minutes enregistrées sur les tâches regroupées par #étiquettes (y compris le compartiment sans étiquette explicite le cas échéant), avec des grilles hebdomadaires lorsque les données couvrent plusieurs jours.",
+  reportingTourStep5bTitle: "Temps par projet (Travail vs Personnel)",
+  reportingTourStep5bBody:
+    "La grille hebdomadaire par projet propose un sélecteur Travail (@) / Personnel (!) sous le titre de la section : Travail (défaut) exclut le registre personnel ; Personnel n’affiche que celui-ci (y compris les tâches déduites d’un jeton « ! » dans le titre si le drapeau enregistré manque). Les totaux par étiquette au-dessus combinent toujours les deux registres, sauf filtre par étiquettes.",
   reportingTourStep6Title: "Sommaire et mise en page à deux colonnes",
   reportingTourStep6Body:
     "Ce bloc correspond à la disposition principale de Rapports : le contenu à gauche et, sur grand écran, le sommaire fixe à droite. Sur téléphone, les mêmes ancres sont proposées en pastilles au-dessus des filtres.",
@@ -2178,6 +2211,22 @@ const fr: DashboardStrings = {
     "Reprendre uniquement ce qui a été mis en pause globalement dans ce contexte",
   appShellRouteNavGlobalPauseDisabledTooltip:
     "Rien n’est actif à mettre en pause : l’horloge murale est déjà figée et aucun minuteur de tâche ou de sous-tâche ne tourne.",
+  appShellRouteNavGanttDashboardOnlyTooltip:
+    "Le Gantt du jour n’est disponible que depuis le tableau de bord.",
+  appShellRouteNavGlobalPauseDashboardOnlyTooltip:
+    "La pause globale n’est disponible que depuis le tableau de bord lorsqu’une session live est chargée.",
+  appShellRouteNavGlobalPauseNoSessionContextTooltip:
+    "La pause globale n’est pas disponible pendant la consultation d’une archive ou avant le chargement de la session live.",
+  appShellRouteNavChangelogUnavailableTooltip:
+    "Raccourci changelog masqué sur cet écran (libellé vide).",
+  appShellRouteNavImplementationUnavailableTooltip:
+    "Raccourci implémentation masqué sur cet écran (libellé vide).",
+  appShellHeaderKronoFocusLoadingAria: "KronoFocus — attente des données de session",
+  appShellRouteNavGroupAppAria: "Zones principales de l’application",
+  appShellRouteNavGroupDocsAria: "Aide et documentation",
+  appShellRouteNavGroupToolsAria: "Outils de session",
+  appShellRouteNavGroupLegalAria: "Informations légales",
+  appShellUtilityToolbarGroupAria: "Affichage et langue",
   globalPauseConfirmTitle: "Pause globale",
   globalPauseConfirmIntro:
     "La pause globale fige l’horloge murale de la session si elle tourne encore, met en pause chaque minuteur de tâche qui ne l’est pas déjà et arrête tout minuteur de sous-tâche actif (en consolidant le temps écoulé). Le prochain clic sur ce contrôle ne reprend que ce qui a été figé dans cette opération.\n\nVoici ce qui sera concerné :",

package/lib/dashboardQuickSearch.ts

@@ -12,6 +12,7 @@ import {
   normalizeTagKey,
   parseProjectScopedTag,
   parseTaskWithAutoTags,
+  resolvePersonalProjectForTaskUpdate,
   taskTitleForDisplay,
 } from "@/lib/taskParsing";
 
@@ -48,6 +49,7 @@ type TaskLike = {
   name?: string;
   tags?: unknown;
   project?: unknown;
+  personalProject?: boolean;
   isDone?: boolean;
   manualTaskTimerPaused?: boolean;
   /** ISO 8601 côté modèle tâche (début d’enregistrement / entrée passée). */
@@ -100,7 +102,8 @@ function dateHayFromFields(...fields: (string | null | undefined)[]): string {
 function buildTaskSearchIndex(
   rawName: string,
   storedTags: unknown,
-  storedProject: unknown
+  storedProject: unknown,
+  personalProject?: boolean,
 ): { haystackFragment: string; metaLine: string } {
   const storedTagArr = Array.isArray(storedTags)
     ? storedTags.filter((x): x is string => typeof x === "string")
@@ -111,9 +114,22 @@ function buildTaskSearchIndex(
     (typeof storedProject === "string" && storedProject.trim() ? storedProject.trim() : undefined) ??
     parsed.project;
 
+  const personalLedger =
+    personalProject === true || resolvePersonalProjectForTaskUpdate(rawName) === true;
+
   const hayPieces: string[] = [];
   if (projRaw) {
-    hayPieces.push(projRaw, normalizeProjectKey(projRaw), formatProjectDisplay(projRaw), `@${normalizeProjectKey(projRaw)}`);
+    const pkey = normalizeProjectKey(projRaw);
+    hayPieces.push(
+      projRaw,
+      pkey,
+      formatProjectDisplay(projRaw, personalLedger ? { personal: true } : undefined),
+    );
+    if (personalLedger) {
+      hayPieces.push(`!${pkey}`, "personnel", "personal", "registre personnel", "personal ledger");
+    } else {
+      hayPieces.push(`@${pkey}`);
+    }
   }
   for (const tag of tagList) {
     hayPieces.push(tag, normalizeTagKey(tag), formatTagDisplay(tag));
@@ -130,7 +146,7 @@ function buildTaskSearchIndex(
 
   const metaParts: string[] = [];
   if (projRaw) {
-    metaParts.push(formatProjectDisplay(projRaw));
+    metaParts.push(formatProjectDisplay(projRaw, personalLedger ? { personal: true } : undefined));
   }
   for (const tag of tagList) {
     metaParts.push(formatTagDisplay(tag));
@@ -353,7 +369,12 @@ export function buildDashboardQuickSearchItems(opts: {
     const seenMeta = new Set<string>();
     for (const t of tasks) {
       const rawName = typeof t.name === "string" ? t.name : "";
-      const idx = buildTaskSearchIndex(rawName, t.tags, t.project);
+      const idx = buildTaskSearchIndex(
+        rawName,
+        t.tags,
+        t.project,
+        t.personalProject === true,
+      );
       hayFrags.push(idx.haystackFragment);
       if (idx.metaLine) {
         for (const part of idx.metaLine.split(" · ")) {
@@ -438,7 +459,12 @@ export function buildDashboardQuickSearchItems(opts: {
     }
     const rawName = typeof t.name === "string" ? t.name : "";
     const display = taskTitleForDisplay(rawName);
-    const idx = buildTaskSearchIndex(rawName, t.tags, t.project);
+    const idx = buildTaskSearchIndex(
+      rawName,
+      t.tags,
+      t.project,
+      t.personalProject === true,
+    );
     const titleKey = (display || id.slice(0, 8)).trim() || id.slice(0, 8);
     const taskTimeHay = dateHayFromFields(
       readOptionalIsoString(t.startTime),
@@ -502,7 +528,12 @@ export function buildDashboardQuickSearchItems(opts: {
         continue;
       }
       const rawName = typeof tpl.name === "string" ? tpl.name : "";
-      const idx = buildTaskSearchIndex(rawName, tpl.tags, tpl.project);
+      const idx = buildTaskSearchIndex(
+        rawName,
+        tpl.tags,
+        tpl.project,
+        tpl.personalProject === true,
+      );
       const displayTitle =
         taskTitleForDisplay(rawName).trim() || tid.slice(0, 8);
       const hay = `${rawName} ${displayTitle} ${tid} ${draft} ${idx.haystackFragment} ${tmplHayExtra} ${dt.dataSearchKindTaskTemplate}`

package/lib/dashboardUrlSession.ts

@@ -0,0 +1,36 @@
+import type { SessionListEntry } from "@/components/dashboard/SessionListPanel";
+import type { KronosysUpdatePayload } from "@/lib/kronosysApi";
+
+/** Minimal `payload.current` pour la résolution `?session=`. */
+export type UrlSessionLiveShape = { sessionId?: string };
+
+export type UrlSessionResolution =
+  | { mode: "none" }
+  | { mode: "loading" }
+  | { mode: "ok"; id: string }
+  | { mode: "invalid" };
+
+export function resolveUrlSession(
+  urlParam: string | null,
+  payload: KronosysUpdatePayload | null,
+  live: UrlSessionLiveShape | undefined,
+  history: SessionListEntry[],
+  historyArchived: SessionListEntry[],
+): UrlSessionResolution {
+  if (!urlParam) {
+    return { mode: "none" };
+  }
+  if (!payload) {
+    return { mode: "loading" };
+  }
+  const liveSid =
+    typeof live?.sessionId === "string" ? live.sessionId.trim() : "";
+  if (
+    (liveSid !== "" && urlParam === liveSid) ||
+    history.some((s) => s.sessionId === urlParam) ||
+    historyArchived.some((s) => s.sessionId === urlParam)
+  ) {
+    return { mode: "ok", id: urlParam };
+  }
+  return { mode: "invalid" };
+}

package/lib/generatedUserChangelog.ts

@@ -5,6 +5,20 @@ export type UserChangelogEntry = {
 };
 
 export const USER_CHANGELOG_ENTRIES: UserChangelogEntry[] = [
+  {
+    "version": "1.0.0-beta.22",
+    "items": [
+      "**Plus de barre de défilement horizontale** sur la barre d’outils d’en-tête (`lib/appShellHeaderClasses.ts`) : les segments **horloge / KronoFocus / palette de commandes / navigation de routes / utilitaires (thème, actualiser, langue)** passent désormais **à la ligne** (`flex-wrap`) lorsqu’ils ne tiennent plus, en gardant chaque rangée **centrée**, au lieu de produire un ascenseur horizontal sur le conteneur. Le comportement est identique sur **toutes** les routes principales (tableau de bord, rapports, paramètres, journaux, guide, implémentation, changelog, licences).",
+      "**Bandeau « Données actualisées » du bouton actualiser** (`components/dashboard/PageRefreshButton.tsx`) : rendu via **portail** vers `document.body` avec **`position: fixed`** au lieu d’un positionnement absolu sous le bouton. Corrige l’apparition intermittente d’une **barre de défilement verticale** sur la page à chaque clic — l’élément absolu participait au débordement du `<body>` et faisait osciller le `scrollHeight` pendant les ~2,8 s d’affichage du libellé.",
+      "**Popover d’édition de durée KronoFocus** (`components/dashboard/KronoFocusPanel.tsx`) : ouvrir le temps depuis l’en-tête (`variant=\"headerBar\"`) ne déclenche plus l’apparition de **scrollbars sur les deux axes** dans l’alvéole du ruban. La cause était la combinaison `overflow-x-auto` sur l’alvéole + popover en `position: absolute` : selon la spec CSS, dès qu’un axe d’overflow n’est pas `visible`, l’autre est promu en `auto`, donc deux ascenseurs apparaissaient sitôt que le panneau dépassait. Le popover est désormais rendu en **portail** avec `position: fixed` centré sous le bouton du temps. Détection click-outside révisée pour vérifier le **déclencheur** et le **panneau** par leurs `ref` distinctes (ils ne partagent plus de sous-arbre DOM).",
+      "**Surcouche carte « complète »** (variante `default` de `KronoFocusPanel`) alignée sur le même pattern portail pour rester cohérente.",
+      "**`useAnchoredFloatingPortalStyle`** (`components/dashboard/useAnchoredFloatingPortalStyle.ts`) gagne l’alignement **`\"center\"`** en plus de `start` / `end` : le panneau portail peut maintenant être centré horizontalement sous son déclencheur. Les autres consommateurs (`PageRefreshButton`, `PlainHelpPopover`, `TagsHelpTrigger`, `InlineMetricHelpTrigger`) conservent leurs alignements existants ; le hook continue de gérer la contrainte au viewport (marge 10 px) et le **basculement au-dessus** du déclencheur s’il manque de place en bas.",
+      "**Guide utilisateur** : `lib/userGuideCopy.ts` et `docs/USER_GUIDE.md` (FR/EN) — note explicite sur le repli en plusieurs rangées de la barre d’outils sur écran étroit ; en-tête de version pointe **`1.0.0-beta.22`**.",
+      "**Implémentation** : `lib/implementationNotes.ts` (FR + EN, `lastUpdated`) ; `docs/IMPLEMENTATION_DETAILS.md` — date d’en-tête et note sur le pattern « portail + `position: fixed` » pour les surcouches ancrées à des éléments d’en-tête (évite la propagation au `scrollableOverflow` du `<body>`).",
+      "**Dépôt** : `README.md` (référence de version npm).",
+      "Bump applicatif : **`1.0.0-beta.22`** (`package.json`, `package-lock.json`) ; **CHANGELOG** usager régénéré (`npm run changelog:build`)."
+    ]
+  },
   {
     "version": "1.0.0-beta.21",
     "items": [

package/lib/implementationNotes.ts

@@ -55,7 +55,7 @@ const frBundle: ImplementationNotesBundle = {
     "Liste exhaustive des intentions utilisateur·rice·s : chaque ligne indique si la capacité est livrée (✓) ou absente / hors périmètre (✗). Les cases à droite servent à cocher une ligne « revue » sur cet appareil — le détail technique long reste dans le dépôt.",
   statusKeyLine:
     "✓ vert = implémenté dans le produit · ✗ rouge = non livré ou volontairement exclu.",
-  lastUpdated: "Dernière mise à jour : 2026-05-12 (v1.0.0-beta.21)",
+  lastUpdated: "Dernière mise à jour : 2026-05-13 (v1.0.0-beta.22)",
   repositoryDocLabel: "Document dépôt : docs/IMPLEMENTATION_DETAILS.md",
   storyGroupsHeading: "Inventaire des user stories",
   implementationColumnLabel: "Implémentation",
@@ -92,7 +92,7 @@ const frBundle: ImplementationNotesBundle = {
         },
         {
           implemented: true,
-          text: "Pour une livraison donnée (p. ex. 1.0.0-beta.21), valider le comportement en croisant la section correspondante du **CHANGELOG**, les récits marqués livrés sur cette page et `docs/IMPLEMENTATION_DETAILS.md`, puis cocher au besoin **intégration** / **E2E**.",
+          text: "Pour une livraison donnée (p. ex. 1.0.0-beta.22), valider le comportement en croisant la section correspondante du **CHANGELOG**, les récits marqués livrés sur cette page et `docs/IMPLEMENTATION_DETAILS.md`, puis cocher au besoin **intégration** / **E2E**.",
         },
         {
           implemented: true,
@@ -499,15 +499,17 @@ const frBundle: ImplementationNotesBundle = {
           implemented: true,
           integrationChecked: true,
           e2eChecked: false,
-          text: "Sur la page Rapports, consulter les grilles par projet basées sur le temps productif (`@`) sans y mélanger le temps des projets personnels (`!`).",
+          text: "Sur la page Rapports, basculer la grille hebdomadaire par projet entre le registre travail (@) et le registre personnel (!) avec les mêmes filtres de plage et d’étiquettes.",
           detail:
-            "`app/reporting/page.tsx` appelle `aggregateProjectTaskMinutesByDay` avec le scope par défaut `work` (`lib/reportingAggregate.ts`, `taskMatchesReportingProjectScope`) : les minutes des tâches `personalProject: true` sont exclues de ces grilles.",
+            "`app/reporting/page.tsx` appelle `aggregateProjectTaskMinutesByDay` avec le scope `work` ou `personal` selon le sélecteur (`lib/reportingAggregate.ts`, `taskMatchesReportingProjectScope`, `taskIsReportingPersonalLedger`). La vue **Travail** (défaut) exclut le registre personnel ; la vue **Personnel** ne l’inclut qu’elles, avec libellés `!` via `formatProjectDisplay`. Une tâche est **personnelle** pour l’agrégat si `personalProject` est vrai **ou** si le **titre** contient un jeton `!` reconnu (repli lorsque le drapeau manque sur d’anciennes données).",
         },
         {
-          implemented: false,
-          text: "Afficher sur la page Rapports un bloc ou calendrier dédié au temps personnel (`!`), parallèle aux vues projets `@`, avec les mêmes filtres de plage et d’étiquettes.",
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: false,
+          text: "Consulter par défaut les grilles par projet en temps productif (@) sans y mélanger le temps des projets personnels (!).",
           detail:
-            "L’agrégat côté bibliothèque accepte `taskProjectScope: \"personal\"` (`aggregateProjectTaskMinutesByDay`, `aggregateReportingByProject`, `aggregateTagTaskMinutesByDayAndWeek`) ; aucune seconde grille « personnel » n’est branchée dans l’UI au 2026-05-12.",
+            "Au chargement, le sélecteur est sur **Travail (@)** : même comportement qu’auparavant (scope `work` seul).",
         },
         {
           implemented: true,
@@ -622,7 +624,7 @@ const enBundle: ImplementationNotesBundle = {
     "An exhaustive list of user intentions: each row shows whether the capability is shipped (✓) or missing / out of scope (✗). Checkboxes on the right mark a row as reviewed on this device — long technical detail stays in the repo doc.",
   statusKeyLine:
     "Green ✓ = implemented in the product · Red ✗ = not shipped or intentionally excluded.",
-  lastUpdated: "Last updated: 2026-05-12 (v1.0.0-beta.21)",
+  lastUpdated: "Last updated: 2026-05-13 (v1.0.0-beta.22)",
   repositoryDocLabel: "Repository document: docs/IMPLEMENTATION_DETAILS.md",
   storyGroupsHeading: "User story inventory",
   implementationColumnLabel: "Implementation",
@@ -659,7 +661,7 @@ const enBundle: ImplementationNotesBundle = {
         },
         {
           implemented: true,
-          text: "For a given release (e.g. 1.0.0-beta.21), cross-check the matching **CHANGELOG** section, the shipped stories on this page and `docs/IMPLEMENTATION_DETAILS.md`, then tick **Integration** / **E2E** as appropriate.",
+          text: "For a given release (e.g. 1.0.0-beta.22), cross-check the matching **CHANGELOG** section, the shipped stories on this page and `docs/IMPLEMENTATION_DETAILS.md`, then tick **Integration** / **E2E** as appropriate.",
         },
         {
           implemented: true,
@@ -1066,15 +1068,17 @@ const enBundle: ImplementationNotesBundle = {
           implemented: true,
           integrationChecked: true,
           e2eChecked: false,
-          text: "On the Reporting page, read per-project grids that reflect productive (`@`) time without mixing in personal (`!`) project minutes.",
+          text: "On the Reporting page, switch the weekly-by-project grid between the work (@) ledger and the personal (!) ledger with the same date-range and tag filters.",
           detail:
-            "`app/reporting/page.tsx` calls `aggregateProjectTaskMinutesByDay` with the default `work` scope (`lib/reportingAggregate.ts`, `taskMatchesReportingProjectScope`): tasks with `personalProject: true` are excluded from those grids.",
+            "`app/reporting/page.tsx` calls `aggregateProjectTaskMinutesByDay` with scope `work` or `personal` from the toggle (`lib/reportingAggregate.ts`, `taskMatchesReportingProjectScope`, `taskIsReportingPersonalLedger`). **Work** (default) excludes the personal ledger; **Personal** includes only it, with `!` labels via `formatProjectDisplay`. A task is **personal** for aggregates when `personalProject` is true **or** when the **title** contains a recognized `!` token (fallback when the flag is missing on older rows).",
         },
         {
-          implemented: false,
-          text: "Show a dedicated personal-time (`!`) block or calendar on Reporting, parallel to `@` project views, with the same date-range and tag filters.",
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: false,
+          text: "By default, per-project grids show productive (@) time without mixing in personal (!) minutes.",
           detail:
-            "Library aggregates accept `taskProjectScope: \"personal\"` (`aggregateProjectTaskMinutesByDay`, `aggregateReportingByProject`, `aggregateTagTaskMinutesByDayAndWeek`); no second “personal” grid is wired in the UI as of 2026-05-12.",
+            "On first load the toggle is **Work (@)** — same behaviour as before (work scope only).",
         },
         {
           implemented: true,

package/lib/reportingAggregate.ts

@@ -2,9 +2,12 @@ import {
   DEFAULT_FALLBACK_TASK_TAG,
   formatProjectDisplay,
   formatTagDisplay,
+  formatTagDisplayForTask,
   isFallbackTaskTagKey,
   normalizeProjectKey,
   normalizeTagKey,
+  parseProjectScopedTag,
+  resolvePersonalProjectForTaskUpdate,
 } from "./taskParsing";
 import type { KronosysUpdatePayload } from "./kronosysApi";
 import { LEGACY_TASK_CYCLES_KEY, LEGACY_TASK_USED_FLAG_KEY } from "./legacyKronoFocusStorageKeys";
@@ -21,6 +24,8 @@ import { normalizeSessionEndReasonKind } from "./sessionEndReason";
 
 export type LooseTask = {
   id?: string;
+  /** Titre brut ; utilisé pour inférer `!` si `personalProject` est absent ou obsolète. */
+  name?: string;
   startTime?: string;
   endTime?: string;
   durationMs?: number;
@@ -38,11 +43,26 @@ export type LooseTask = {
 /** Filtre les tâches pour les agrégats « @ projet » vs « ! projet personnel ». */
 export type ReportingTaskProjectScope = "all" | "work" | "personal";
 
+/**
+ * Registre personnel pour le reporting : drapeau persisté **ou** jeton `!` déduit du titre
+ * (rattrapage si `personalProject` n’a pas été enregistré sur d’anciennes tâches).
+ */
+export function taskIsReportingPersonalLedger(task: LooseTask): boolean {
+  if (task.personalProject === true) {
+    return true;
+  }
+  const rawName = typeof task.name === "string" ? task.name.trim() : "";
+  if (!rawName) {
+    return false;
+  }
+  return resolvePersonalProjectForTaskUpdate(rawName) === true;
+}
+
 export function taskMatchesReportingProjectScope(
   task: LooseTask,
   scope: ReportingTaskProjectScope,
 ): boolean {
-  const isP = task.personalProject === true;
+  const isP = taskIsReportingPersonalLedger(task);
   if (scope === "all") {
     return true;
   }
@@ -424,6 +444,48 @@ function mergeIntervalsToMinutes(intervals: Array<[number, number]>): number {
   return totalMs / 60000;
 }
 
+/** Entrée d’étiquette pour agrégats : clé canonique (sépare @ / ! sur `projet#suffixe`) + libellé. */
+function taskTagReportingEntry(
+  raw: string,
+  task: LooseTask,
+  fallbackTagDisplay: string,
+): { key: string; display: string } | null {
+  const token = normalizeTagKey(String(raw)).trim();
+  if (!token) {
+    return null;
+  }
+  const lower = token.toLowerCase();
+  if (lower === DEFAULT_FALLBACK_TASK_TAG) {
+    return { key: lower, display: fallbackTagDisplay };
+  }
+
+  const scoped = parseProjectScopedTag(token);
+  const taskPersonal = taskIsReportingPersonalLedger(task);
+  const tpRaw = typeof task.project === "string" ? task.project.trim() : "";
+  const tp = tpRaw ? normalizeProjectKey(tpRaw) : "";
+
+  if (!scoped) {
+    return {
+      key: lower,
+      display: formatTagDisplayForTask(token, undefined, {
+        personalProject: taskPersonal,
+        taskProject: tp || null,
+      }),
+    };
+  }
+
+  const pk = normalizeProjectKey(scoped.projectKey);
+  const loc = scoped.localTag;
+  const sameProject = tp.length > 0 && pk.toLowerCase() === tp.toLowerCase();
+  const sigil: "@" | "!" = sameProject ? (taskPersonal ? "!" : "@") : "@";
+  const key = `${sigil}${pk}#${loc}`.toLowerCase();
+  const display = formatTagDisplayForTask(token, undefined, {
+    personalProject: taskPersonal,
+    taskProject: tp || null,
+  });
+  return { key, display };
+}
+
 function uniqueTaskTagEntries(
   task: LooseTask,
   fallbackTagDisplay: string
@@ -432,18 +494,15 @@ function uniqueTaskTagEntries(
   const seen = new Set<string>();
   const out: Array<{ key: string; display: string }> = [];
   for (const raw of tags) {
-    const token = normalizeTagKey(String(raw)).trim();
-    if (!token) {
+    const one = taskTagReportingEntry(raw, task, fallbackTagDisplay);
+    if (!one) {
       continue;
     }
-    const key = token.toLowerCase();
-    if (seen.has(key)) {
+    if (seen.has(one.key)) {
       continue;
     }
-    seen.add(key);
-    const display =
-      key === DEFAULT_FALLBACK_TASK_TAG ? fallbackTagDisplay : formatTagDisplay(token);
-    out.push({ key, display });
+    seen.add(one.key);
+    out.push({ key: one.key, display: one.display });
   }
   return out;
 }

package/lib/reportingMetricHelp.ts

@@ -220,17 +220,17 @@ export const reportingMetricHelpEn: ReportingMetricHelpBlock = {
     "Sum of attributed task minutes for that tag and period. Minutes are not split across tags: a multi-tag task contributes its full duration to each tag row.",
   metricHelpProjectTitleAria: "Help: recorded time by project",
   metricHelpProjectTitleBody:
-    "Recorded task duration (durationMs) split by each task’s @project, shown as a weekly calendar: one period line per week, then one table with a row per project and seven day columns plus a week total. Same date range, tag filter, archived-session rules, and week navigation as the tag calendar.",
+    "Recorded task duration (durationMs) split by each task’s project field, shown as a weekly calendar: one period line per week, then one table with a row per project and seven day columns plus a week total. Use the Work (@) / Personal (!) control to choose the ledger: Work (default) counts only non-personal tasks; Personal counts tasks marked personal (`personalProject`) and tasks whose title contains a recognized `!` project token (fallback when the flag was not saved), with `!` labels. Same date range, tag filter, archived-session rules, and week navigation as the tag calendar.",
   metricHelpProjectCalendarAria: "Help: project weekly calendar",
   metricHelpProjectCalendarBody:
-    "Same layout as the tag calendar: for each week, the date span appears once; each row is one @project. Column headers show weekday and calendar date; day cells use task day (end or start); hover a header or cell for YYYY-MM-DD.",
+    "Same layout as the tag calendar: for each week, the date span appears once; each row is one project for the selected ledger (Work or Personal). Column headers show weekday and calendar date; day cells use task day (end or start); hover a header or cell for YYYY-MM-DD.",
   metricHelpProjectColProjAria: "Help: project column",
-  metricHelpProjectColProjBody: "Project name from the task, or “no project” when none is set.",
+  metricHelpProjectColProjBody: "Project name from the task (with @ or ! depending on the ledger), or “no project” when none is set.",
   metricHelpProjectColTasksAria: "Help: tasks column",
   metricHelpProjectColTasksBody: "Number of task rows summed into that project row.",
   metricHelpProjectColTimeAria: "Help: recorded time column",
   metricHelpProjectColTimeBody:
-    "Total recorded task minutes for that @project over the seven days of the row (from durationMs).",
+    "Total recorded task minutes for that project over the seven days of the row (from durationMs), for the selected Work or Personal ledger.",
   metricHelpWorkspaceTitleAria: "Help: open folder snapshot",
   metricHelpWorkspaceTitleBody:
     "Snapshot of the first workspace folder: line counts by language from Git-tracked files or a folder walk. Not tied to Kronosys sessions; cached ~5 minutes. See the paragraph below for details.",
@@ -378,17 +378,17 @@ export const reportingMetricHelpFr: ReportingMetricHelpBlock = {
     "Somme des minutes de tâche attribuées à cette étiquette sur la période de la ligne. Les minutes ne sont pas réparties entre les étiquettes : une tâche multi-étiquettes compte sa durée entière sur chaque ligne d’étiquette.",
   metricHelpProjectTitleAria: "Aide : temps enregistré par projet",
   metricHelpProjectTitleBody:
-    "Durée enregistrée sur les tâches (durationMs) ventilée par @projet, sous forme de calendrier hebdomadaire : une ligne de période par semaine, puis un tableau avec une ligne par projet et sept colonnes jour plus le total de la semaine. Mêmes plage de dates, filtre d’étiquettes, règles d’archivage et navigation par semaine que le calendrier par étiquette.",
+    "Durée enregistrée sur les tâches (durationMs) ventilée par le champ projet de chaque tâche, sous forme de calendrier hebdomadaire : une ligne de période par semaine, puis un tableau avec une ligne par projet et sept colonnes jour plus le total de la semaine. Utilisez le sélecteur Travail (@) / Personnel (!) pour choisir le registre : Travail (défaut) ne compte que les tâches non personnelles ; Personnel compte les tâches marquées personnelles (`personalProject`) et celles dont le titre contient un jeton `!` reconnu (repli si le drapeau n’a pas été enregistré), avec libellés « ! ». Mêmes plage de dates, filtre d’étiquettes, règles d’archivage et navigation par semaine que le calendrier par étiquette.",
   metricHelpProjectCalendarAria: "Aide : calendrier hebdomadaire par projet",
   metricHelpProjectCalendarBody:
-    "Même présentation que le calendrier par étiquette : pour chaque semaine, la plage de dates s’affiche une fois ; chaque ligne correspond à un @projet. Les en-têtes de colonnes indiquent le jour de la semaine et la date calendaire ; les cases jour utilisent le jour de la tâche (fin ou début) ; survol d’un en-tête ou d’une case pour AAAA-MM-JJ.",
+    "Même présentation que le calendrier par étiquette : pour chaque semaine, la plage de dates s’affiche une fois ; chaque ligne correspond à un projet pour le registre choisi (Travail ou Personnel). Les en-têtes de colonnes indiquent le jour de la semaine et la date calendaire ; les cases jour utilisent le jour de la tâche (fin ou début) ; survol d’un en-tête ou d’une case pour AAAA-MM-JJ.",
   metricHelpProjectColProjAria: "Aide : colonne projet",
-  metricHelpProjectColProjBody: "Nom du projet sur la tâche, ou « sans projet » si absent.",
+  metricHelpProjectColProjBody: "Nom du projet sur la tâche (avec @ ou ! selon le registre), ou « sans projet » si absent.",
   metricHelpProjectColTasksAria: "Aide : colonne tâches",
   metricHelpProjectColTasksBody: "Nombre de lignes de tâches agrégées pour ce projet.",
   metricHelpProjectColTimeAria: "Aide : colonne temps enregistré",
   metricHelpProjectColTimeBody:
-    "Total des minutes enregistrées sur les tâches pour ce @projet sur les sept jours de la ligne (durationMs).",
+    "Total des minutes enregistrées sur les tâches pour ce projet sur les sept jours de la ligne (durationMs), pour le registre Travail ou Personnel sélectionné.",
   metricHelpWorkspaceTitleAria: "Aide : instantané du dossier ouvert",
   metricHelpWorkspaceTitleBody:
     "Instantané du premier dossier du workspace : lignes par langage à partir des fichiers suivis par Git ou d’un parcours du dossier. Indépendant des sessions Kronosys ; mis en cache ~5 minutes. Voir le paragraphe descriptif sous le titre.",