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

package/lib/reportingStrings.ts

@@ -15,8 +15,32 @@ export type ReportingNavStrings = {
   guide: string;
   /** Page inventaire des user stories (`/implementation`). */
   implementation: string;
+  /** Journal des versions (`/changelog`). */
+  changelog: string;
   /** Infobulle lorsque l’icône tableau de bord pulse (rappel conflit minuteurs). */
   dashboardAttentionHint?: string;
+  /** Infobulle : Gantt du jour réservé au tableau de bord. */
+  navGanttDashboardOnlyTooltip: string;
+  /** Infobulle : pause globale réservée au tableau de bord (session live). */
+  navGlobalPauseDashboardOnlyTooltip: string;
+  /** Infobulle : pause globale indisponible sur le tableau de bord (archive ou chargement). */
+  navGlobalPauseNoSessionContextTooltip: string;
+  /** Infobulle : changelog indisponible (libellé vide sur cette route). */
+  navChangelogUnavailableTooltip: string;
+  /** Infobulle : implémentation indisponible (libellé vide sur cette route). */
+  navImplementationUnavailableTooltip: string;
+  /** Libellé du bouton Gantt (barre de navigation). */
+  navGanttButtonLabel: string;
+  /** Libellé du bouton pause globale (barre de navigation). */
+  navGlobalPauseButtonLabel: string;
+};
+
+/** Libellés passés à `AppShellRouteNav` (inclut les groupes type ruban pour l’accessibilité). */
+export type AppShellRouteNavLabelBundle = ReportingNavStrings & {
+  navGroupAppAria: string;
+  navGroupDocsAria: string;
+  navGroupToolsAria: string;
+  navGroupLegalAria: string;
 };
 
 export type ReportingStrings = ReportingNavStrings &
@@ -110,6 +134,12 @@ export type ReportingStrings = ReportingNavStrings &
   projectColTime: string;
   projectUnassigned: string;
   projectTableHint: string;
+  /** Légende du sélecteur Travail / Personnel sur la grille par projet. */
+  projectScopeLegend: string;
+  /** aria-label du radiogroupe Travail / Personnel. */
+  projectScopeGroupAria: string;
+  projectScopeWork: string;
+  projectScopePersonal: string;
   /** Temps tâche par #tag — usage type affectation WBS / NWA (SAP). */
   tagTimeSectionTitle: string;
   tagTimeSectionHint: string;
@@ -175,6 +205,18 @@ export type ReportingStrings = ReportingNavStrings &
   weekNavNoProjectDataThisWeek: string;
   /** Section lignes écrites + tableaux par langage (agrégés). */
   tocLocSection: string;
+  /** Sommaire : entrée des trois vues (facturation / rythme / avancé). */
+  tocViewTabs: string;
+  /** Onglet — temps par #tag et @projet pour codifier la facturation. */
+  reportingViewTabBilling: string;
+  /** Onglet — graphiques d’activité par jour. */
+  reportingViewTabRhythm: string;
+  /** Onglet — indicateurs détaillés, tableau journalier, instantané workspace. */
+  reportingViewTabAdvanced: string;
+  /** aria-label du groupe d’onglets sous les filtres. */
+  reportingViewTabGroupAria: string;
+  /** Court texte d’intention sous l’onglet facturation. */
+  reportingViewBillingIntro: string;
   /** Bouton flottant retour en haut de page. */
   scrollToTopAria: string;
   };
@@ -185,10 +227,24 @@ const en: ReportingStrings = {
   settings: "Settings",
   logs: "Action logs",
   guide: "User guide",
+  changelog: "Changelog",
   implementation: "User stories — implementation",
+  navGanttDashboardOnlyTooltip:
+    "Today’s Gantt is available from the dashboard only.",
+  navGlobalPauseDashboardOnlyTooltip:
+    "Global pause is available from the dashboard when a live session is loaded.",
+  navGlobalPauseNoSessionContextTooltip:
+    "Global pause is not available while you inspect an archived session or before the live session is loaded.",
+  navChangelogUnavailableTooltip:
+    "Changelog shortcut is hidden on this screen (no label).",
+  navImplementationUnavailableTooltip:
+    "Implementation shortcut is hidden on this screen (no label).",
+  navGanttButtonLabel: "Open today timeline (Gantt)",
+  navGlobalPauseButtonLabel:
+    "Pause session, tasks, and subtasks in this context",
   title: "Reporting",
   subtitle:
-    "Aggregates from Kronosys history (local API). Filter by date range and tags. Task time by @project is included.",
+    "See where time was allocated on the range (tags, projects) to help encode billing lines. Filters apply to history below; the workspace snapshot (if shown) is under Advanced.",
   archivedSessionsReportingNote:
     "Archived sessions: task rows, recorded task time, time by project, and per-task KronoFocus counts include only tasks marked done with every subtask checked. Session-level coding and active time still cover the whole session.",
   reportingArchivedExcludedAside:
@@ -210,9 +266,11 @@ const en: ReportingStrings = {
   filtersHelpAriaLabel: "How reporting filters apply",
   filtersHelpBody: `Where dates and tags apply on this page
 
-• Workspace folder snapshot (lines in the open project): ignores filters — not Kronosys history.
+• Three tabs under the filters: Billing allocation (#tags and @projects), Rhythm (per-day charts), Advanced (summary KPIs, day table, lines/signals, workspace snapshot when enabled).
 
-• Summary KPIs, charts, day-by-day table: filters apply. Session-day side: session count, session coding/active/wall time, KronoFocus sessions completed, lines written, breakdown of sessions by closure type when the host saved one at session end, and (when the host stored a planned start) punctuality aggregates: reference count, late session count, cumulative and average late minutes. Task-day side: task rows, recorded task time, done/in-progress counts, task KronoFocus used/cycles.
+• Workspace folder snapshot (lines in the open project): under Advanced when code metrics are on; ignores filters — not Kronosys history.
+
+• Summary KPIs, day-by-day table: filters apply. Session-day side: session count, session coding/active/wall time, KronoFocus sessions completed, lines written, breakdown of sessions by closure type when the host saved one at session end, and (when the host stored a planned start) punctuality aggregates: reference count, late session count, cumulative and average late minutes. Task-day side: task rows, recorded task time, done/in-progress counts, task KronoFocus used/cycles.
 
 • “Lines by language” and “Coding signals” tables: session day within the range; with tags selected, a whole session is dropped if no task matches (same rule as elsewhere).
 
@@ -277,7 +335,11 @@ Archived sessions: task-based metrics only count fully completed tasks (subtasks
   projectColTime: "Recorded time",
   projectUnassigned: "(no project)",
   projectTableHint:
-    "One line per calendar week, then one table: each @project on its own row, seven day columns and a week total — same week navigation and week-start setting as the tag calendar above.",
+    "One line per calendar week, then one table: each project on its own row, seven day columns and a week total — same week navigation and week-start setting as the tag calendar above. Use the Work (@) / Personal (!) control under the title to switch ledgers: Work is the default and excludes the personal ledger; Personal lists only that ledger (tasks flagged personal, or a recognized ! token in the title if the flag was not saved), with ! labels.",
+  projectScopeLegend: "Project ledger",
+  projectScopeGroupAria: "Recorded time by project: work or personal ledger",
+  projectScopeWork: "Work (@)",
+  projectScopePersonal: "Personal (!)",
   tagTimeSectionTitle: "Recorded task time by tag",
   tagTimeSectionHint:
     "Map each #tag to an external key (e.g. SAP WBS or NWA). A task’s full recorded time is counted under every tag on that task (tag totals can overlap). In the by-day table and the weekly calendar, several `project#code` tags for the same project (same day or same week) appear under one @project row—expand to see each tag line.",
@@ -337,6 +399,13 @@ Archived sessions: task-based metrics only count fully completed tasks (subtasks
   weekNavNoTagDataThisWeek: "No recorded task time for this week.",
   weekNavNoProjectDataThisWeek: "No recorded task time by project for this week.",
   tocLocSection: "Lines & coding signals",
+  tocViewTabs: "Views (tabs)",
+  reportingViewTabBilling: "Billing allocation",
+  reportingViewTabRhythm: "Rhythm",
+  reportingViewTabAdvanced: "Advanced",
+  reportingViewTabGroupAria: "Reporting views",
+  reportingViewBillingIntro:
+    "Map recorded time to #tags and @projects for your billing codes. Totals follow the same filters as above; open work is flagged in Filters when relevant.",
   scrollToTopAria: "Back to top",
   ...reportingMetricHelpEn,
 };
@@ -347,10 +416,24 @@ const fr: ReportingStrings = {
   settings: "Paramètres",
   logs: "Journal des actions",
   guide: "Guide d’utilisation",
+  changelog: "Journal des versions",
   implementation: "User stories — implémentation",
+  navGanttDashboardOnlyTooltip:
+    "Le Gantt du jour n’est disponible que depuis le tableau de bord.",
+  navGlobalPauseDashboardOnlyTooltip:
+    "La pause globale n’est disponible que depuis le tableau de bord lorsqu’une session live est chargée.",
+  navGlobalPauseNoSessionContextTooltip:
+    "La pause globale n’est pas disponible pendant la consultation d’une archive ou avant le chargement de la session live.",
+  navChangelogUnavailableTooltip:
+    "Raccourci changelog masqué sur cet écran (libellé vide).",
+  navImplementationUnavailableTooltip:
+    "Raccourci implémentation masqué sur cet écran (libellé vide).",
+  navGanttButtonLabel: "Ouvrir le fil de la journée (vue Gantt)",
+  navGlobalPauseButtonLabel:
+    "Mettre en pause la session, les tâches et les sous-tâches dans ce contexte",
   title: "Rapports",
   subtitle:
-    "Agrégats à partir de l’historique Kronosys (API locale). Filtrez par plage de dates et par étiquettes. Le temps par @projet est inclus.",
+    "Voir où le temps s’est réparti sur la période (#étiquettes, @projets) pour aider à coder les lignes de facturation. Les filtres s’appliquent à l’historique ci-dessous ; l’instantané du workspace (s’il est affiché) est sous Avancé.",
   archivedSessionsReportingNote:
     "Sessions archivées : les lignes de tâches, le temps enregistré sur les tâches, le temps par projet et les comptes KronoFocus par tâche ne retiennent que les tâches marquées terminées dont toutes les sous-tâches sont cochées. Les temps de codage et d’activité au niveau session restent ceux de la session entière.",
   reportingArchivedExcludedAside:
@@ -373,9 +456,11 @@ const fr: ReportingStrings = {
   filtersHelpAriaLabel: "Comment s’appliquent les filtres des rapports",
   filtersHelpBody: `Où agissent les dates et les étiquettes sur cette page
 
-• Instantané « Dossier ouvert » (lignes par langage du workspace) : hors filtres — ce n’est pas l’historique Kronosys.
+• Trois volets sous les filtres : Allocation facturation (#étiquettes et @projets), Rythme (graphiques par jour), Avancé (indicateurs de synthèse, tableau journalier, lignes / signaux, instantané workspace si activé).
+
+• Instantané « Dossier ouvert » : sous **Avancé** lorsque les métriques code sont activées ; hors filtres — ce n’est pas l’historique Kronosys.
 
-• Indicateurs de synthèse, graphiques, tableau par jour : la plage et les étiquettes s’appliquent. Côté jour de session : nombre de sessions, temps de codage et d’activité, durée murale, KronoFocus « sessions terminées », lignes écrites, ventilation des sessions par type de clôture lorsque l’hôte en a enregistré un à la fin de session, et (si l’hôte a enregistré un début prévu) indicateurs d’assiduité : sessions avec référence, sessions en retard, retard cumulé, retard moyen lorsqu’en retard. Côté jour de tâche : lignes de tâches, temps enregistré, tâches terminées / en cours, KronoFocus côté tâches.
+• Indicateurs de synthèse, tableau par jour : la plage et les étiquettes s’appliquent. Côté jour de session : nombre de sessions, temps de codage et d’activité, durée murale, KronoFocus « sessions terminées », lignes écrites, ventilation des sessions par type de clôture lorsque l’hôte en a enregistré un à la fin de session, et (si l’hôte a enregistré un début prévu) indicateurs d’assiduité : sessions avec référence, sessions en retard, retard cumulé, retard moyen lorsqu’en retard. Côté jour de tâche : lignes de tâches, temps enregistré, tâches terminées / en cours, KronoFocus côté tâches.
 
 • Tableaux « Lignes par langage » et « Signaux de codage » : jour de session dans la plage ; avec étiquettes sélectionnées, toute la session est exclue si aucune tâche ne correspond (même règle qu’ailleurs).
 
@@ -441,7 +526,11 @@ Sessions archivées : pour les métriques basées sur les tâches, seules les t
   projectColTime: "Temps enregistré",
   projectUnassigned: "(sans projet)",
   projectTableHint:
-    "Une ligne par semaine calendaire, puis un tableau : chaque @projet sur sa propre ligne, sept colonnes jour et le total de la semaine — même navigation par semaine et même premier jour de semaine que le calendrier par étiquette ci-dessus.",
+    "Une ligne par semaine calendaire, puis un tableau : chaque projet sur sa propre ligne, sept colonnes jour et le total de la semaine — même navigation par semaine et même premier jour de semaine que le calendrier par étiquette ci-dessus. Utilisez le contrôle Travail (@) / Personnel (!) sous le titre pour changer de registre : Travail (défaut) exclut le registre personnel ; Personnel n’affiche que celui-ci (tâches marquées personnelles, ou titre avec jeton ! reconnu si le drapeau n’a pas été enregistré), avec le préfixe « ! ».",
+  projectScopeLegend: "Registre projet",
+  projectScopeGroupAria: "Temps par projet : registre travail ou personnel",
+  projectScopeWork: "Travail (@)",
+  projectScopePersonal: "Personnel (!)",
   tagTimeSectionTitle: "Temps enregistré par étiquette",
   tagTimeSectionHint:
     "Chaque #tag peut correspondre à une clé externe (ex. poste WBS ou NWA dans SAP). La durée enregistrée complète d’une tâche est comptée pour chaque étiquette associée (les totaux par étiquette peuvent se chevaucher). Dans le tableau par jour et le calendrier hebdomadaire, plusieurs étiquettes `projet#code` pour un même projet (même jour ou même semaine) sont regroupées sous une ligne @projet : développez-la pour voir chaque ligne d’étiquette.",
@@ -502,6 +591,13 @@ Sessions archivées : pour les métriques basées sur les tâches, seules les t
   weekNavNoTagDataThisWeek: "Aucun temps de tâche enregistré pour cette semaine.",
   weekNavNoProjectDataThisWeek: "Aucun temps de tâche par projet pour cette semaine.",
   tocLocSection: "Lignes et signaux de codage",
+  tocViewTabs: "Vues (onglets)",
+  reportingViewTabBilling: "Allocation facturation",
+  reportingViewTabRhythm: "Rythme",
+  reportingViewTabAdvanced: "Avancé",
+  reportingViewTabGroupAria: "Vues des rapports",
+  reportingViewBillingIntro:
+    "Associez le temps enregistré aux #étiquettes et aux @projets pour vos codes de facturation. Les totaux suivent les mêmes filtres qu’en haut ; le travail encore ouvert est rappelé dans Filtres le cas échéant.",
   scrollToTopAria: "Retour en haut de la page",
   ...reportingMetricHelpFr,
 };
@@ -510,7 +606,7 @@ export function reportingStrings(lang: Lang): ReportingStrings {
   return lang === "fr" ? fr : en;
 }
 
-export function reportingNav(lang: Lang): ReportingNavStrings {
+export function reportingNav(lang: Lang): AppShellRouteNavLabelBundle {
   const s = reportingStrings(lang);
   const d = dashboardStrings(lang);
   return {
@@ -520,6 +616,19 @@ export function reportingNav(lang: Lang): ReportingNavStrings {
     logs: s.logs,
     guide: s.guide,
     implementation: s.implementation,
+    changelog: s.changelog,
     dashboardAttentionHint: d.navDashboardPlannedConflictPulseHint,
+    navGanttDashboardOnlyTooltip: s.navGanttDashboardOnlyTooltip,
+    navGlobalPauseDashboardOnlyTooltip: s.navGlobalPauseDashboardOnlyTooltip,
+    navGlobalPauseNoSessionContextTooltip:
+      s.navGlobalPauseNoSessionContextTooltip,
+    navChangelogUnavailableTooltip: s.navChangelogUnavailableTooltip,
+    navImplementationUnavailableTooltip: s.navImplementationUnavailableTooltip,
+    navGanttButtonLabel: s.navGanttButtonLabel,
+    navGlobalPauseButtonLabel: s.navGlobalPauseButtonLabel,
+    navGroupAppAria: d.appShellRouteNavGroupAppAria,
+    navGroupDocsAria: d.appShellRouteNavGroupDocsAria,
+    navGroupToolsAria: d.appShellRouteNavGroupToolsAria,
+    navGroupLegalAria: d.appShellRouteNavGroupLegalAria,
   };
 }

package/lib/reportingTagWeekBreakdown.ts

@@ -8,11 +8,28 @@ import {
   parseProjectScopedTag,
 } from "@/lib/taskParsing";
 
+/** Registre projet pour une clé d’étiquette `…#…` déjà canonique (`@` / `!`). */
+function reportingScopedTagLedgerFromKey(tagKey: string): "p" | "w" {
+  return tagKey.trim().toLowerCase().startsWith("!") ? "p" : "w";
+}
+
+function scopedRollupBucketId(tagKey: string): string | null {
+  const scoped = parseProjectScopedTag(tagKey);
+  if (!scoped) {
+    return null;
+  }
+  const pk = normalizeProjectKey(scoped.projectKey).toLowerCase();
+  return `${pk}:::${reportingScopedTagLedgerFromKey(tagKey)}`;
+}
+
 export type TagWeekDisplayLeaf = { kind: "leaf"; row: TagWeekCalendarRow };
 
 export type TagWeekDisplayRollup = {
   kind: "rollup";
+  /** Projet normalisé (sans @ / !), pour descriptions et clés métier. */
   projectKeyLower: string;
+  /** Clef stable pour l’état replié (registre @ vs ! séparés). */
+  rollupStableKey: string;
   displayProject: string;
   weekStart: string;
   parentSlots: number[];
@@ -34,7 +51,7 @@ function sumSlots(rows: readonly TagWeekCalendarRow[]): number[] {
 
 /**
  * Prépare les lignes du calendrier hebdo par étiquette : étiquettes globales et sans étiquette telles quelles ;
- * les étiquettes `projet#suffixe` (plusieurs pour le même projet) deviennent un bloc repliable avec total par projet.
+ * les étiquettes `projet#suffixe` deviennent un bloc repliable avec total par projet **et par registre** (`@` vs `!` : pas de fusion entre travail et personnel pour le même nom de projet).
  */
 export function buildTagWeekDisplayBlocks(rows: readonly TagWeekCalendarRow[]): TagWeekDisplayBlock[] {
   const scopedBuckets = new Map<string, TagWeekCalendarRow[]>();
@@ -51,10 +68,14 @@ export function buildTagWeekDisplayBlocks(rows: readonly TagWeekCalendarRow[]):
       globals.push(row);
       continue;
     }
-    const pk = normalizeProjectKey(scoped.projectKey).toLowerCase();
-    const list = scopedBuckets.get(pk) ?? [];
+    const bucketId = scopedRollupBucketId(row.tagKey);
+    if (!bucketId) {
+      globals.push(row);
+      continue;
+    }
+    const list = scopedBuckets.get(bucketId) ?? [];
     list.push(row);
-    scopedBuckets.set(pk, list);
+    scopedBuckets.set(bucketId, list);
   }
 
   globals.sort((a, b) => normalizeTagKey(a.tagKey).localeCompare(normalizeTagKey(b.tagKey)));
@@ -65,20 +86,28 @@ export function buildTagWeekDisplayBlocks(rows: readonly TagWeekCalendarRow[]):
   }
 
   const projKeys = [...scopedBuckets.keys()].sort((a, b) => a.localeCompare(b));
-  for (const pk of projKeys) {
-    const children = [...scopedBuckets.get(pk)!].sort((a, b) =>
+  for (const rollupStableKey of projKeys) {
+    const children = [...scopedBuckets.get(rollupStableKey)!].sort((a, b) =>
       normalizeTagKey(a.tagKey).localeCompare(normalizeTagKey(b.tagKey))
     );
+    const pk =
+      rollupStableKey.includes(":::")
+        ? rollupStableKey.slice(0, rollupStableKey.indexOf(":::"))
+        : rollupStableKey;
     if (children.length === 1) {
       blocks.push({ kind: "leaf", row: children[0] });
       continue;
     }
     const first = parseProjectScopedTag(children[0].tagKey);
-    const displayProject = first ? formatProjectDisplay(first.projectKey) : pk;
+    const personalRollup = reportingScopedTagLedgerFromKey(children[0].tagKey) === "p";
+    const displayProject = first
+      ? formatProjectDisplay(first.projectKey, personalRollup ? { personal: true } : undefined)
+      : pk;
     const weekStart = children[0].weekStart;
     blocks.push({
       kind: "rollup",
       projectKeyLower: pk,
+      rollupStableKey,
       displayProject,
       weekStart,
       parentSlots: sumSlots(children),
@@ -99,6 +128,7 @@ export type TagDayDisplayLeaf = { kind: "leaf"; row: ReportingTagTimeDayRow };
 export type TagDayDisplayRollup = {
   kind: "rollup";
   projectKeyLower: string;
+  rollupStableKey: string;
   displayProject: string;
   day: string;
   parentMinutes: number;
@@ -122,10 +152,14 @@ function buildTagDaySegmentBlocks(segment: readonly ReportingTagTimeDayRow[]): T
       globals.push(row);
       continue;
     }
-    const pk = normalizeProjectKey(scoped.projectKey).toLowerCase();
-    const list = scopedBuckets.get(pk) ?? [];
+    const bucketId = scopedRollupBucketId(row.tagKey);
+    if (!bucketId) {
+      globals.push(row);
+      continue;
+    }
+    const list = scopedBuckets.get(bucketId) ?? [];
     list.push(row);
-    scopedBuckets.set(pk, list);
+    scopedBuckets.set(bucketId, list);
   }
 
   globals.sort((a, b) => normalizeTagKey(a.tagKey).localeCompare(normalizeTagKey(b.tagKey)));
@@ -136,21 +170,29 @@ function buildTagDaySegmentBlocks(segment: readonly ReportingTagTimeDayRow[]): T
   }
 
   const projKeys = [...scopedBuckets.keys()].sort((a, b) => a.localeCompare(b));
-  for (const pk of projKeys) {
-    const children = [...scopedBuckets.get(pk)!].sort((a, b) =>
+  for (const rollupStableKey of projKeys) {
+    const children = [...scopedBuckets.get(rollupStableKey)!].sort((a, b) =>
       normalizeTagKey(a.tagKey).localeCompare(normalizeTagKey(b.tagKey))
     );
+    const pk =
+      rollupStableKey.includes(":::")
+        ? rollupStableKey.slice(0, rollupStableKey.indexOf(":::"))
+        : rollupStableKey;
     if (children.length === 1) {
       blocks.push({ kind: "leaf", row: children[0] });
       continue;
     }
     const first = parseProjectScopedTag(children[0].tagKey);
-    const displayProject = first ? formatProjectDisplay(first.projectKey) : pk;
+    const personalRollup = reportingScopedTagLedgerFromKey(children[0].tagKey) === "p";
+    const displayProject = first
+      ? formatProjectDisplay(first.projectKey, personalRollup ? { personal: true } : undefined)
+      : pk;
     const day = children[0].day;
     const parentMinutes = children.reduce((s, c) => s + c.minutes, 0);
     blocks.push({
       kind: "rollup",
       projectKeyLower: pk,
+      rollupStableKey,
       displayProject,
       day,
       parentMinutes,

package/lib/settingsCopy.ts

@@ -34,8 +34,8 @@ export type SettingsCopy = {
   sectionPrivacy: string;
   /** Tableau de bord web : affichage du KronoFocus. */
   sectionKronoFocus: string;
-  kronoFocusShowInHeader: string;
-  kronoFocusShowInHeaderDesc: string;
+  /** KronoFocus dans la barre d’outils : toujours affiché (navigation stable). */
+  kronoFocusHeaderPinnedNote: string;
   kronoFocusShowInTaskOps: string;
   kronoFocusShowInTaskOpsDesc: string;
   /** Comportement des tâches sans étiquette explicite (#). */
@@ -491,8 +491,8 @@ const en: SettingsCopy = {
   sectionGeneral: "General",
   sectionPrivacy: "Privacy",
   sectionKronoFocus: "KronoFocus (dashboard)",
-  kronoFocusShowInHeader: "Show in the header",
-  kronoFocusShowInHeaderDesc: "KronoFocus timer and controls in the top bar of the browser dashboard.",
+  kronoFocusHeaderPinnedNote:
+    "The KronoFocus timer and controls always stay in the app header toolbar (next to the clock and command palette) so the navigation bar keeps the same width on every page. While you inspect an archive, the controls stay visible but target the live session.",
   kronoFocusShowInTaskOps: "Show in task action buttons",
   kronoFocusShowInTaskOpsDesc:
     "KronoFocus start on active tasks and the optional “start KronoFocus with new task” toggle in the task launcher.",
@@ -975,9 +975,8 @@ const fr: SettingsCopy = {
   sectionGeneral: "Général",
   sectionPrivacy: "Confidentialité",
   sectionKronoFocus: "KronoFocus (tableau de bord)",
-  kronoFocusShowInHeader: "Afficher dans l’en-tête",
-  kronoFocusShowInHeaderDesc:
-    "Minuteur KronoFocus et contrôles dans la barre du haut du tableau de bord dans le navigateur.",
+  kronoFocusHeaderPinnedNote:
+    "Le minuteur KronoFocus et ses contrôles restent toujours dans la barre d’outils de l’application (à côté de l’horloge et de la palette de commandes), afin que la barre de navigation garde la même largeur sur toutes les pages. En consultation d’archive, les contrôles restent visibles mais ciblent la session live.",
   kronoFocusShowInTaskOps: "Afficher dans les boutons opérationnels des tâches",
   kronoFocusShowInTaskOpsDesc:
     "Bouton pour lancer le KronoFocus depuis une tâche suivie et option « lancer aussi le KronoFocus » lors de la création d’une tâche.",

package/lib/userGuideCopy.ts

@@ -50,7 +50,7 @@ function frBundle(): UserGuideBundle {
     searchNoResults: "Aucune rubrique ne correspond à votre recherche. Essayez un autre mot-clé ou effacez le filtre.",
     tocHeading: "Sur cette page",
     tocNavAria: "Sommaire du guide d’utilisation",
-    lastUpdated: "Dernière mise à jour : 12 mai 2026",
+    lastUpdated: "Dernière mise à jour : 13 mai 2026",
     sections: [
       {
         id: "ug-essence",
@@ -64,7 +64,7 @@ function frBundle(): UserGuideBundle {
         optionsTitle: "Trois « pièces » pour trois gestes",
         options: [
           "**Tableau de bord** — l’*atelier* (sessions, tâches, minuteur, raccourcis **#étiquettes** / **@projets** travail / **!projets** personnels).",
-          "**Rapports** — le *regard en hauteur* (période, thèmes, graphiques, sans refabriquer les chiffres).",
+          "**Rapports** — la période en **trois vues** (allocation facturation, rythme, avancé) à partir de l’historique déjà enregistré.",
           "**Paramètres** — l’*arrière-boutique* (habitudes, raccordements, zone où l’on *efface* l’histoire *avec prudence*). [Ouvrir Paramètres](/settings#settings-usage-profile).",
         ],
         stepsTitle: "Premier contact en cinq pas (sans tout maîtriser le jour 1)",
@@ -79,9 +79,10 @@ function frBundle(): UserGuideBundle {
       {
         id: "ug-nav-theme",
         title: "Barre d’outils, thème et langue",
-        searchIndex: "thème clair sombre mode violet zinc langue fr en",
+        searchIndex: "thème clair sombre mode violet zinc langue fr en ruban groupe navigation repli plusieurs rangées",
         paragraphs: [
-          "La **barre du haut** est *toujours* la même famille : mêmes outils, même **ton** (zinc, accents **violet**), pour ne pas recharger le cerveau *à chaque page*. L’icône **roue** mène à [Paramètres](/settings#settings-usage-profile) (raccourci **Alt+Shift+S** depuis le tableau de bord).",
+          "La **barre du haut** est *toujours* la même famille : mêmes outils, même **ton** (zinc, accents **violet**), pour ne pas recharger le cerveau *à chaque page*. Les **raccourcis** de pages sont **regroupés** en **petits blocs** par **contexte** (zones principales, aide et documentation, outils de session ou informations légales), sur le modèle d’un **ruban** léger. L’icône **roue** mène à [Paramètres](/settings#settings-usage-profile) (raccourci **Alt+Shift+S** depuis le tableau de bord).",
+          "Sur **écran étroit** (petit portable, fenêtre réduite, **PWA** côté tablette), la rangée se **replie** en **plusieurs lignes centrées** au lieu d’afficher une **barre de défilement horizontale** — les **blocs** (horloge, KronoFocus, navigation, utilitaires) restent **groupés** et accessibles **sans glisser** latéralement.",
         ],
         steps: [
           "En **tableau de bord** : l’icône **Livre** mène ici, puis **Rapports** (graphe), **Paramètres** (roue) et **Implémentation** (code — inventaire des user stories).",
@@ -106,10 +107,10 @@ function frBundle(): UserGuideBundle {
         ],
         options: [
           "**Tableau de bord** — à gauche la **file des sessions** ; au centre les **tâches** (minuteurs, détail) ; à droite les raccourcis d’**étiquettes** et de **projets** (**@** travail, **!** personnel) pour ne pas retaper les mêmes mots. C’est l’usage **quotidien**.",
-          "**Rapports** — choisir une **plage de dates** et, si besoin, des **#étiquettes** ; lire résumés et graphiques. Une **visite guidée** est proposée la première fois sur l’écran.",
+          "**Rapports** — choisir une **plage de dates** et, si besoin, des **#étiquettes** ; puis les **onglets** (allocation facturation, rythme, avancé). Une **visite guidée** est proposée la première fois sur l’écran.",
           "**Paramètres** — profil, collecte, planification, étiquettes avancées, **Git** ou miroir en **option** ; la **zone dangereuse** supprime l’historique (avec saisie de confirmation). [Sommaire des paramètres](/settings#settings-usage-profile) · [zone de danger](/settings#settings-danger-zone). N’y entrez **que** quand vous le **décidez**.",
           "**Licences** — textes MIT, logiciels tiers, polices ; icône **document** **uniquement** sur cette page.",
-          "Une **horloge murale** (fuseau et format 12/24 h des paramètres **Tableau de bord web**) tourne en permanence dans la **barre d’outils** de l’en-tête, à gauche des icônes de navigation."
+          "Une **horloge murale** (fuseau et format 12/24 h des paramètres **Tableau de bord web**) tourne en permanence dans la **barre d’outils** de l’en-tête ; le **KronoFocus** se place **juste à côté**, avant les icônes de navigation — il reste **toujours** visible pour garder la barre stable. En consultation d’**archive**, ses **boutons** restent **visibles** mais **désactivés** : ils reflètent toujours la **session live**. La **palette données** (Ctrl+K / ⌘K), le **Gantt du jour** et la **pause globale** sont **les mêmes** sur **toutes** les pages (tableau de bord, rapports, paramètres, journaux, guide, implémentation, changelog, licences) ; hors tableau de bord, certaines actions **vous y ramènent** pour terminer (ex. ouvrir un résultat de recherche)."
         ],
       },
       {
@@ -178,7 +179,7 @@ function frBundle(): UserGuideBundle {
         ],
         optionsTitle: "Où c’est proposé, quoi cliquer",
         options: [
-          "Section [KronoFocus (tableau de bord)](/settings#settings-kronoFocus) dans **Paramètres** : minuteur **dans l’en-tête** et/ou **près des actions de tâche** — cocher selon l’encombrement (le **profil** d’usage peut **masquer** d’autres blocs ailleurs).",
+          "Section [KronoFocus (tableau de bord)](/settings#settings-kronoFocus) dans **Paramètres** : le minuteur reste **dans la barre d’outils** ; vous choisissez encore s’il apparaît **près des actions de tâche** (le **profil** d’usage peut **masquer** d’autres blocs ailleurs).",
           "Sur le **panneau** : **Démarrer**, **Pause**, reprise ; **durée** en `HH:MM:SS` ; **durée par défaut** (p. ex. 25 min) d’un clic ; **historique** des durées pour **réappliquer** la même mesure **sans** la retaper.",
           "Lier le KronoFocus **à** la tâche **active** : utile pour **retrouver** dans l’historique **quelle** tâche portait ce **bloc** de focus."
         ],
@@ -224,23 +225,24 @@ function frBundle(): UserGuideBundle {
       {
         id: "ug-reporting",
         title: "Rapports : la mémoire qui tient, quand on doit la raconter",
-        searchIndex: "agregats kpi plage date étiquette semaine assiduité retard heure planifiée",
+        searchIndex: "agregats kpi plage date étiquette semaine assiduité retard heure planifiée onglets allocation facturation rythme avancé",
         paragraphs: [
           "Les **rapports** ne jaugent pas votre humanité : ils aident à **répondre** à *est-ce qu’on peut, ensemble, s’y retrouver sur une période ?* Ce qui n’est **pas** **encore** fini reste **indiqué** (brouillon **honnête**, pas punition).",
-          "L’appli **agrège** ce que **vous** avez **déjà** posé (durées, tags, projets) ; parfois des **lignes** / **signaux** côté code et un **aperçu** de dossier **si** c’est **activé** chez vous. Une **visite** sur l’écran adoucit le **premier** tour.",
-          "Lorsque l’**hôte** d’enregistrement a **fourni** l’heure de **début prévue** à l’ouverture d’une session (p. ex. moteur lié à l’[horaire](/settings#settings-schedule) ou aux [sessions planifiées](/settings#settings-planned-sessions)), l’**écart** (retard ou avance) est **sauvegardé** sur la session et des **indicateurs d’assiduité** apparaissent dans le **résumé** des **Rapports** : ce n’est en général **pas** rempli par le seul bouton *Nouvelle session* du navigateur, sauf intégration explicite."
+          "Sous les filtres, **trois vues** orientent la lecture : **Allocation facturation** (#étiquettes, @projets) pour le temps à mapper vers vos lignes de facturation ; **Rythme** (graphiques par jour) ; **Avancé** (synthèse, tableau journalier, lignes de code / signaux et instantané workspace **si** le profil l’expose). L’appli **agrège** ce que vous avez **déjà** enregistré ; une **visite** sur l’écran adoucit le **premier** tour.",
+          "Lorsque l’**hôte** d’enregistrement a **fourni** l’heure de **début prévue** à l’ouverture d’une session (p. ex. moteur lié à l’[horaire](/settings#settings-schedule) ou aux [sessions planifiées](/settings#settings-planned-sessions)), l’**écart** (retard ou avance) est **sauvegardé** sur la session et des **indicateurs d’assiduité** apparaissent dans le **résumé** (vue **Avancé**) : ce n’est en général **pas** rempli par le seul bouton *Nouvelle session* du navigateur, sauf intégration explicite."
         ],
         stepsTitle: "Parcours type sur l’écran Rapports",
         steps: [
           "Ouvrir **Rapports** (icône **graphe** ou raccourci **Alt+Shift+G** sur le tableau de bord).",
           "Choisir une **plage** : champs **Du** / **Au**, bouton **Aujourd’hui**, ou préréglages **jour** / **semaine** / **mois** / **année** (selon ce que l’UI expose).",
           "Optionnel : **sélectionner** une ou plusieurs **#étiquettes** pour **restreindre** les tâches (les **sessions** **sans** tâche **correspondante** **disparaissent** des **vues** **basées** **tâches**).",
-          "Lire les **blocs** : **résumé**, **tableaux** par **jour**, temps par **@projet** / **!projet** / **#tag** (les grilles **par projet** du tableau **Rapports** comptent par défaut le temps **@** sans y mélanger le temps **!**) ; **navigation** de **semaine** **le** **cas** **échéant** ; **lancer** la **visite** **guidée** **si** la **pancarte** **le** **propose**.",
+          "Choisir une **vue** sous les filtres : **Allocation facturation** pour le temps par #étiquette et @projet (grilles hebdo, navigation de semaine, début de semaine) ; **Rythme** pour les graphiques par jour ; **Avancé** pour les indicateurs de synthèse, le tableau journalier, les lignes de code (si activées) et l’instantané workspace.",
+          "**Lancer** la **visite** **guidée** **si** la **pancarte** **le** **propose**.",
         ],
         options: [
           "**Indicateurs non finaux** (pastilles) : rappellent le **travail encore ouvert** dans la plage — lire prudemment, pas de chiffrage *figé* tant que des tâches *bougent* encore.",
-          "Sous le **résumé**, une **ventilation** peut compter les **sessions** par **type de clôture** enregistré à la fin de session (lorsque l’hôte en a choisi un) ; les sessions **sans** catégorie y figurent à part.",
-          "Le **tableau par jour** inclut aussi un total de temps tâche **non concurrent** (sans chevauchement des intervalles horodatés) pour comparer avec le temps enregistré brut.",
+          "Sous le **résumé** (vue **Avancé**), une **ventilation** peut compter les **sessions** par **type de clôture** enregistré à la fin de session (lorsque l’hôte en a choisi un) ; les sessions **sans** catégorie y figurent à part.",
+          "Le **tableau par jour** (vue **Avancé**) inclut aussi un total de temps tâche **non concurrent** (sans chevauchement des intervalles horodatés) pour comparer avec le temps enregistré brut.",
           "**Début de semaine** (lundi, dimanche ou samedi) : réglage souvent près des **calendriers** hebdo des rapports — choisissez **ce** qui coïncide avec **votre** semaine réelle.",
           "Relancer la visite **Rapports** (aide **premier pas** sur l’écran) : [Paramètres — visite Rapports](/settings#settings-reporting-tour).",
           "Une **deuxième grille** dédiée au seul temps personnel (`!`), **miroir** de celle des projets `@`, **n’est pas** encore dans l’interface ; les agrégats côté moteur prévoient déjà les filtres pour une version ultérieure.",
@@ -286,7 +288,7 @@ function enBundle(): UserGuideBundle {
     searchNoResults: "No section matches. Try another keyword or clear the filter.",
     tocHeading: "On this page",
     tocNavAria: "User guide table of contents",
-    lastUpdated: "Last updated: 12 May 2026",
+    lastUpdated: "Last updated: 13 May 2026",
     sections: [
       {
         id: "ug-essence",
@@ -300,7 +302,7 @@ function enBundle(): UserGuideBundle {
         optionsTitle: "Three “rooms” for three moves",
         options: [
           "**Dashboard** — the workbench (sessions, tasks, focus timer, **#** tags, **@** work projects, and **!** personal projects).",
-          "**Reports** — the look back (range, themes, charts: numbers come from what you **already** logged).",
+          "**Reports** — the span in **three tabs** (billing allocation, rhythm, advanced) from what you **already** logged.",
           "**Settings** — the back room (habits, connections, the **danger** zone where you wipe history **carefully**). [Open Settings](/settings#settings-usage-profile).",
         ],
         stepsTitle: "A calm first run (day one need not be perfect)",
@@ -315,9 +317,10 @@ function enBundle(): UserGuideBundle {
       {
         id: "ug-nav-theme",
         title: "Toolbar, theme, and language",
-        searchIndex: "theme light dark language fr en brand",
+        searchIndex: "theme light dark language fr en ribbon group navigation wrap multiple rows narrow screen",
         paragraphs: [
-          "The top bar reuses the **same** **family** of controls (zinc, **violet** accents) on every page so **navigation** stays **light** on the brain. The **cog** icon opens [Settings](/settings#settings-usage-profile) (shortcut **Alt+Shift+S** from the dashboard).",
+          "The top bar reuses the **same** **family** of controls (zinc, **violet** accents) on every page so **navigation** stays **light** on the brain. **Page shortcuts** sit in **small grouped blocks** by **context** (main areas, help and docs, in-session tools or legal info when shown), like a **lightweight ribbon**. The **cog** icon opens [Settings](/settings#settings-usage-profile) (shortcut **Alt+Shift+S** from the dashboard).",
+          "On a **narrow screen** (small laptop, shrunk window, tablet **PWA**), the row **wraps** into **multiple centered lines** instead of showing a **horizontal scrollbar** — the **blocks** (clock, KronoFocus, navigation, utilities) stay **grouped** and reachable **without side-scrolling**.",
         ],
         steps: [
           "On the **dashboard**: **Book** → this guide; **chart** → **Reports**; **cog** → **Settings**; **code** → user stories (implementation status).",
@@ -342,10 +345,10 @@ function enBundle(): UserGuideBundle {
         ],
         options: [
           "**Dashboard** — **sessions** on the left, **tasks** in the **centre**, **tag** and **project** shortcuts (**@** work, **!** personal) on the right so you stop retyping the same words.",
-          "**Reports** — pick a **date range** and, if needed, **#** tags; read **summaries** and **charts**; the **tour** may offer itself the first time you land there.",
+          "**Reports** — pick a **date range** and, if needed, **#** tags; then use the **tabs** (billing allocation, rhythm, advanced); the **tour** may offer itself the first time you land there.",
           "**Settings** — profile, collection, scheduling, **advanced** tags, optional **Git** or **remote**; the **danger zone** can **delete** all **history** (type-to-confirm). [Settings overview](/settings#settings-usage-profile) · [danger zone](/settings#settings-danger-zone).",
           "**Licenses** — MIT, third parties, **fonts**; the **file** icon **only** on that page.",
-          "A **wall clock** (time zone and 12/24 h from **Web dashboard** settings) stays visible in the header **toolbar**, left of the navigation icons."
+          "A **wall clock** (time zone and 12/24 h from **Web dashboard** settings) stays visible in the header **toolbar**; **KronoFocus** sits **right beside it**, before the navigation icons — it is **always** shown so the bar stays stable. While you **inspect an archive**, its **buttons** stay **visible but disabled** — they still reflect the **live session**. The **data palette** (Ctrl+K / ⌘K), **Today Gantt**, and **global pause** are the **same** on **every** main page (dashboard, reporting, settings, logs, guide, implementation, changelog, licenses); off the **dashboard**, some actions **return** there to **finish** (e.g. open a search hit)."
         ],
       },
       {
@@ -413,7 +416,7 @@ function enBundle(): UserGuideBundle {
         ],
         optionsTitle: "Where to find it, what the controls do",
         options: [
-          "In **Settings**: the [KronoFocus (dashboard)](/settings#settings-kronoFocus) section — show the timer in the **header** and/or **on** the **task** (your **usage** profile can hide other panels elsewhere in the app).",
+          "In **Settings**: the [KronoFocus (dashboard)](/settings#settings-kronoFocus) section — the timer **stays in the header**; you can still choose whether it also appears **on** **task** actions (your **usage** profile can hide other panels elsewhere in the app).",
           "On the **card**: **Start**, **Pause**, resume; **duration** as `HH:MM:SS`; a **one-tap** default (e.g. 25 min); **history** of durations to **reapply** without retyping.",
           "Link the timer to the **active** **task** so you can later see **which** **task** carried that focus block in the **archive**.",
         ],
@@ -459,11 +462,11 @@ function enBundle(): UserGuideBundle {
       {
         id: "ug-reporting",
         title: "Reports: memory you can read back, not a verdict on you",
-        searchIndex: "filter date tag week kpi punctuality late schedule planned",
+        searchIndex: "filter date tag week kpi punctuality late schedule planned tabs billing rhythm advanced",
         paragraphs: [
           "Reports are for a **calm** read of a time span, not a moral tally. They help answer: can we, together, make sense of this **period**? Unfinished work stays **indicated** where the UI does — honest draft, not **punishment**.",
-          "The app **aggregates** what you **already** recorded (durations, tags, projects), sometimes with code-related lines and a **folder** peek if that is **on** in your **setup**; a **guided** **tour** may soften the **first** visit.",
-          "If the **recording** **host** **passed** a **planned** start instant when a session was opened (for example a worker tied to your [work schedule](/settings#settings-schedule) or [planned sessions](/settings#settings-planned-sessions)), the app stores the **offset** in minutes and shows **punctuality** **summary** KPIs on **Reporting** — a browser-only **New session** usually does **not** set this by itself, unless a connector does.",
+          "Under the filters, **three tabs** steer the page: **Billing allocation** (#tags, @projects) for time you map to billing lines; **Rhythm** (per-day charts); **Advanced** (summary KPIs, day table, code lines / signals, and a **workspace** snapshot when your profile exposes it). The app **aggregates** what you **already** logged; a **guided** **tour** may soften the **first** visit.",
+          "If the **recording** **host** **passed** a **planned** start instant when a session was opened (for example a worker tied to your [work schedule](/settings#settings-schedule) or [planned sessions](/settings#settings-planned-sessions)), the app stores the **offset** in minutes and shows **punctuality** **summary** KPIs under **Advanced** — a browser-only **New session** usually does **not** set this by itself, unless a connector does.",
         ],
         stepsTitle: "A typical run on the Reports page",
         steps: [
@@ -471,13 +474,13 @@ function enBundle(): UserGuideBundle {
           "Set **from** and **to** (or a day / week / month / year **preset**, depending on what the UI offers).",
           "Use **Today** / **Now** quick actions in date/time pickers whenever available to jump to the current value.",
           "Optionally pick one or more **#** **tags** (sessions with **no** **matching** task may **disappear** from some **task**-based **views**).",
-          "Scroll the **summary**, per-day **tables**, **@** / **!** / **#** **breakdowns** (the **per-project** grids on **Reports** default to **@** work time and **exclude** **!** personal minutes from those rows), and the week nudger when your data has **enough** **weeks** to flip through.",
+          "Pick a **tab** under the filters: **Billing allocation** for time by #tag and @project (weekly grids, week nudger, week start); **Rhythm** for per-day charts; **Advanced** for summary KPIs, the day table, lines-of-code (when on), and the workspace snapshot.",
           "Start the **guided** **tour** if a prompt appears the **first** time.",
         ],
         options: [
           "**Non-final** chips mark work that is not **closed** in the **range** you are looking at: read them gently; the **draft** is not a **failure**.",
-          "Below the **summary** KPIs, a **breakdown** may count **sessions** by **closure type** saved when a session ended (when the host picked one); sessions **without** a stored category are grouped separately.",
-          "The **day table** now includes a **non-concurrent** task-time total (timestamped overlap removed) so you can compare it against raw recorded task time.",
+          "Under **Advanced**, below the **summary** KPIs, a **breakdown** may count **sessions** by **closure type** saved when a session ended (when the host picked one); sessions **without** a stored category are grouped separately.",
+          "The **day table** (under **Advanced**) includes a **non-concurrent** task-time total (timestamped overlap removed) so you can compare it against raw recorded task time.",
           "**Week** starts on (Monday, Sunday, or Saturday) — often next to the tag-week **grids**; pick the one that **matches** how you read a week.",
           "Re-launch the **Reports** first-time **tour** from [Settings — Reporting tour](/settings#settings-reporting-tour).",
           "A **second** grid that shows **only** personal (`!`) project time, **parallel** to the `@` project grid, is **not** in the UI yet; the aggregation layer already has filters for a future release.",