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

package/lib/implementationNotes.ts

@@ -0,0 +1,1188 @@
+import type { Lang } from "./dashboardCopy";
+
+/** User story : ✓ = livré · ✗ = absent ou explicitement hors périmètre · écartée = intention abandonnée volontairement (reste documentée). */
+export type ImplementationUserStory = {
+  implemented: boolean;
+  /** Intention produit volontairement abandonnée ; la ligne reste listée pour éviter les rediscussions. */
+  discarded?: boolean;
+  integrationChecked?: boolean;
+  e2eChecked?: boolean;
+  text: string;
+  /** Précision affichée sous la ligne principale (repliable, police réduite). */
+  detail?: string;
+  /** Exemple concret ; affiché sous le détail avec une étiquette « Exemple ». */
+  example?: string;
+};
+
+export type ImplementationUserStoryGroup = {
+  id: string;
+  title: string;
+  lead?: string;
+  stories: ImplementationUserStory[];
+};
+
+export type ImplementationNotesBundle = {
+  pageTitle: string;
+  pageSubtitle: string;
+  /** Ligne courte sous le sous-titre : sens des coches vert / rouge. */
+  statusKeyLine: string;
+  lastUpdated: string;
+  repositoryDocLabel: string;
+  storyGroupsHeading: string;
+  implementationColumnLabel: string;
+  storyColumnLabel: string;
+  integrationColumnLabel: string;
+  e2eColumnLabel: string;
+  openChangelogAria: string;
+  openChangelogTooltip: string;
+  /** Bouton chevron : états accessibles pour le bloc détail / exemple. */
+  storyDetailsToggleExpand: string;
+  storyDetailsToggleCollapse: string;
+  /** Étiquette devant `example` (ex. « Exemple : »). */
+  storyDetailExampleLabel: string;
+  /** Court texte d’aide sous le titre du tableau des user stories (chevron). */
+  storyExpandHintLine: string;
+  /** Pastille sur une ligne dont l’intention a été écartée volontairement. */
+  storyDiscardedBadge: string;
+  /** Légende : pourquoi ces lignes restent visibles. */
+  storyDiscardedLegendLine: string;
+  storyGroups: ImplementationUserStoryGroup[];
+};
+
+const frBundle: ImplementationNotesBundle = {
+  pageTitle: "User stories — état d’implémentation",
+  pageSubtitle:
+    "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)",
+  repositoryDocLabel: "Document dépôt : docs/IMPLEMENTATION_DETAILS.md",
+  storyGroupsHeading: "Inventaire des user stories",
+  implementationColumnLabel: "Implémentation",
+  storyColumnLabel: "User story",
+  integrationColumnLabel: "Intégration",
+  e2eColumnLabel: "E2E",
+  openChangelogAria: "Ouvrir le changelog usager",
+  openChangelogTooltip: "Ouvrir le changelog",
+  storyDetailsToggleExpand: "Afficher précisions et exemple",
+  storyDetailsToggleCollapse: "Masquer précisions et exemple",
+  storyDetailExampleLabel: "Exemple :",
+  storyExpandHintLine:
+    "Certaines lignes ont un chevron : ouvrez-les pour une précision et un exemple en police réduite.",
+  storyDiscardedBadge: "Écarté",
+  storyDiscardedLegendLine:
+    "Les lignes marquées « Écarté » documentent une intention volontairement abandonnée ; elles restent dans la liste pour éviter qu’on rouvre le même débat par inadvertance.",
+  storyGroups: [
+    {
+      id: "us-shell",
+      title: "Coque, navigation, confort",
+      lead: "Barre d’outils commune, pages principales, thème et langue.",
+      stories: [
+        {
+          implemented: true,
+          text: "Naviguer entre tableau de bord, guide, rapports, paramètres et cette page depuis les icônes du haut.",
+          detail:
+            "Les destinations couvrent le tableau de bord, les rapports (graphiques), les paramètres, le guide in-app, cette page d’implémentation, les journaux d’actions, les licences et le changelog usager ; les icônes sont regroupées dans la barre d’outils.",
+          example:
+            "Sur le tableau de bord, cliquer l’icône livre ouvre /guide tout en conservant le paramètre de session (?session=) lorsqu’il est présent.",
+        },
+        {
+          implemented: true,
+          text: "Voir une horloge murale continue dans la barre d’outils (fuseau et format 12/24 h des paramètres tableau de bord web).",
+        },
+        {
+          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**.",
+        },
+        {
+          implemented: true,
+          text: "Ouvrir la page Licences depuis l’icône document lorsque je suis déjà sur Licences.",
+        },
+        {
+          implemented: true,
+          text: "Basculer entre thème clair et sombre pour le confort visuel.",
+        },
+        {
+          implemented: true,
+          text: "Actualiser l’état serveur sans recharger toute l’application.",
+        },
+        {
+          implemented: true,
+          text: "Choisir la langue d’interface (FR / EN) avec préférence pouvant être mémorisée.",
+        },
+        {
+          implemented: true,
+          text: "Conserver le paramètre de session du tableau de bord (?session=) quand je passe d’une route à l’autre.",
+        },
+      ],
+    },
+    {
+      id: "us-sessions",
+      title: "Sessions — cadre, horloge murale, pause, fin",
+      stories: [
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Créer une nouvelle session maintenant (lancement immédiat) et la voir apparaître dans la liste des sessions.",
+          detail:
+            "La modale « Nouvelle session » propose le timing « Maintenant » ; après confirmation, la ligne apparaît dans la colonne Sessions avec l’état live.",
+          example:
+            "Nouvelle session → « Démarrer la session » : une ligne « Live » remonte en tête de liste avec l’heure de début.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Créer une session passée en saisissant le début et la fin (heure locale), puis la voir apparaître dans la liste des sessions.",
+          detail:
+            "Le mode « Dans le passé » impose début et fin en heure locale ; l’intervalle fermé est historisé sans nécessairement arrêter une session déjà ouverte.",
+          example:
+            "Hier 14:00–16:00 : une ligne terminée s’affiche avec ces bornes pendant qu’une autre session peut rester active.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Créer une session sans limite optionnelle (ni durée max, ni fenêtre calendrier, ni jours/plage horaire).",
+          detail:
+            "La portée « Aucune limite » évite tout plafond mural, toute fenêtre calendaire et tout gabarit hebdomadaire pour cette session.",
+          example:
+            "Laisser « Aucune limite » puis démarrer : seuls des rappels ultérieurs (collecteur / bannières) peuvent signaler un dérapage.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Encadrer une session par une durée maximale d’horloge murale (rappel de cadre).",
+          detail:
+            "La durée maximale s’exprime en heures de mur accumulé ; l’interface peut signaler le dépassement ou le voisinage du seuil selon les paramètres.",
+          example:
+            "4 h max : au-delà, la durée affichée peut passer en alerte visuelle (couleur ou clignotement lent).",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Définir une fenêtre calendrier (dates de début et de fin) pour une session.",
+          detail:
+            "Les dates « Du » et « Au » sont inclusives dans le fuseau / affichage local du tableau de bord ; elles encadrent la session pour les rappels.",
+          example:
+            "Du 3 au 10 du mois pour une série de séances dans une même fenêtre contractuelle.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Définir une semaine avec jours choisis et plage horaire.",
+          detail:
+            "On coche les jours actifs et, au besoin, une fenêtre horaire quotidienne ; les fenêtres overnight (ex. 22:00–06:00) sont prises en charge.",
+          example:
+            "Mar/Jeu + 18:30–21:00 pour des créneaux fixes après la journée bureau.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Utiliser les raccourcis « Aujourd’hui » / « Maintenant » dans les sélecteurs de dates et heures.",
+          detail:
+            "Les boutons posent la date du jour ou l’instant courant dans les champs de la modale sans saisie complète.",
+          example:
+            "« Aujourd’hui » sur une date « Du » ; « Maintenant » comme fin d’une session passée qui vient de se terminer.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Voir la durée de session suivre une horloge murale (temps réel) tant que la session est vivante et non en pause session.",
+          detail:
+            "La carte session affiche une durée murale qui avance tant que la session n’est ni terminée ni en pause session (pause murale).",
+          example:
+            "Sans pause session, la ligne « Durée » suit la seconde ; « Pause session » fige l’affichage jusqu’à reprise.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Mettre la session en pause : le mur cesse de s’accumuler sans confondre avec la pause d’une tâche.",
+          detail:
+            "La pause session agit sur le mur collecteur ; le serveur peut aussi figer les minuteurs de tâches et sous-tâches actifs via un instantané `sessionPauseContext` (reprise ciblée). La pause d’une tâche seule reste sur la carte et n’est pas synonyme de pause globale.",
+          example:
+            "Pause session → bandeau « Session en pause » ; une tâche peut encore avoir été laissée en pause manuelle avant la pause session.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Déclencher une pause globale avec une modale de confirmation qui résume effets, durées et périmètre.",
+          detail:
+            "La pause globale aligne la session live, les minuteurs de tâches et les sous-tâches concernées ; la modale affiche un résumé (mur, temps enregistrés, volumes) avant d’appliquer ou d’annuler.",
+          example:
+            "Barre d’outils → contrôle « Pause session, tâches et sous-tâches dans ce contexte » → lecture du résumé → « Pause maintenant » ou retour en arrière.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Quand la session live est en pause (murale ou pause globale), reconnaître l’état sur la carte Session en cours (pastille), voir un rappel central sur fond voilé tout en gardant la barre du haut utilisable, et repérer le bouton de reprise de pause globale mis en évidence lorsque la pause globale est active.",
+          detail:
+            "Serveur : `setPaused` enregistre `sessionPauseContext` pour les minuteurs actifs et ne restaure à la reprise que ce gel ; une entrée en pause globale efface tout `sessionPauseContext` résiduel. UI : pastilles « En pause » / « Pause globale » (`SelectedSessionSidebarBlock.tsx`), overlay plein écran `DashboardPauseBackdrop` sous l’en-tête (`z-40` vs `z-50`), anneau ambre sur le contrôle pause globale lorsqu’il affiche lecture (`AppShellRouteNav.tsx`).",
+          example:
+            "Après pause globale : pastille « Pause globale », voile « Pause globale active », bouton lecture cerclé dans la barre d’outils.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Terminer une session avec une raison de clôture facultative (dans les temps, avance, dépassement, autre + note).",
+          detail:
+            "La modale de fin propose catégories facultatives et une note libre ; elles sont attachées à l’instantané d’historique avec l’heure de fin courante.",
+          example:
+            "« Fin anticipée » + « livraison reportée » puis « Terminer la session » depuis la barre latérale ou la liste.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Ajouter une note libre à une session et la revoir dans la barre latérale de session.",
+          detail:
+            "Le champ « Note de session » se trouve dans la carte session (colonne Sessions). La valeur est envoyée au serveur lorsque le champ perd le focus et reste visible après rechargement.",
+          example:
+            "Saisir « Point revue client — préparer démo » avant une réunion pour retrouver le contexte dans la même carte.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Voir un aperçu de note de session (icône + extrait) dans la liste des sessions et dans la liste des archives.",
+          detail:
+            "Quand une note existe, la liste affiche une icône et un extrait tronqué à côté du titre de session ; même logique pour les entrées archivées pertinentes.",
+          example:
+            "Une ligne montre « …compte-rendu… » sous le nom lorsque la note contient ce texte.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Voir la session live mise en évidence lorsque l’heure de début officielle est encore dans le futur (cercle d’état et fond distincts dans la liste).",
+          detail:
+            "Tant que l’horloge réelle n’a pas atteint le début officiel enregistré, la ligne live garde un style « pas encore démarrée » (point et fond différents).",
+          example:
+            "Session étiquetée pour 18:00 alors qu’il est 14:00 : la ligne reste visuellement distincte jusqu’à 18:00.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Programmer une heure de fin sur une session live : la session se termine automatiquement à l’échéance (instantané en historique).",
+          detail:
+            "Une échéance de fin session peut être définie ; au passage de l’instant programmé, la session est clôturée : le mur est consolidé jusqu’à cette heure, les tâches ouvertes sont figées comme après une fin de session en mode conserver, sans modale de clôture.",
+          example:
+            "Fin à 17:00 : sans clic supplémentaire, la session live devient une ligne d’historique à 17:00 si elle est encore ouverte.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "À la fermeture d’une session avec tâches encore ouvertes, choisir de les terminer ou de les transposer vers une nouvelle session en pause.",
+          detail:
+            "La modale de fin liste les tâches non terminées et propose de les laisser dans l’instantané (choix par défaut, équivalent « conserver »), de les marquer terminées ou de les déplacer vers une nouvelle session créée en pause. À distinguer : une fin automatique à l’heure planifiée (`scheduledEndAt`) ne passe pas par cette modale ; côté données, le comportement correspond à conserver les tâches ouvertes dans l’instantané (minuteurs figés), comme le premier choix de la modale. Un réglage produit pour imposer un autre mode par défaut à l’échéance n’est pas livré dans cette version.",
+          example:
+            "« Transposer vers une nouvelle session en pause » pour reporter un lot de correctifs sans tout fermer au même titre.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Reprendre une session en pause depuis le bandeau ; reprendre une tâche relance aussi l’accumulation du mur.",
+          detail:
+            "Le bandeau « Session en pause » offre la reprise ; lorsqu’une tâche repasse en suivi actif selon les règles du dashboard, le mur peut à nouveau s’accumuler.",
+          example:
+            "Reprendre depuis le bandeau puis lancer une tâche : la durée murale augmente à nouveau.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Configurer un gabarit de nom de session initial (codes date/heure, %UUID, fuseau aligné sur le tableau de bord).",
+          detail:
+            "Sous Paramètres → tableau de bord, un modèle de nom peut référencer la date, l’heure, un UUID court ou le fuseau utilisé pour l’affichage.",
+          example:
+            "« Session %Y-%m-%d » produit « Session 2026-05-08 » à chaque création.",
+        },
+        {
+          discarded: true,
+          implemented: false,
+          text: "Disposer d’une seule action « pause » identique qui applique le même effet au mur de session et à tous les minuteurs comme une primitive unique.",
+          detail:
+            "Décision : écartée. La pause globale couvre déjà le gel coordonné du mur et des minuteurs du contexte affiché ; la pause minuteur par tâche reste un réglage fin volontairement séparé.",
+          example:
+            "Ne pas fusionner en un seul bouton universel : conserver la pause globale (barre d’outils) et les pauses ciblées selon l’intention.",
+        },
+        {
+          discarded: true,
+          implemented: false,
+          text: "Obtenir la durée murale de session comme somme automatique des durées enregistrées des tâches.",
+          detail:
+            "Décision : écartée. Le mur suit des segments collecteur ; les totaux tâche sont agrégés à part dans les métriques et rapports.",
+          example:
+            "Comparer carte session et colonne Tâches : les deux lectures peuvent diverger — c’est attendu.",
+        },
+      ],
+    },
+    {
+      id: "us-tasks",
+      title: "Tâches, étiquettes, projets, minuteurs",
+      stories: [
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Créer une tâche avec titre et utiliser # pour étiquettes, @ pour projets productifs et ! pour projets personnels, avec aide à la saisie.",
+          detail:
+            "Le champ « sur quoi travaillez-vous » accepte dans le libellé des jetons #étiquette, @projet (travail) et !projet (personnel) ; ils sont interprétés au lancement (`startTask`), alimentent les listes d’étiquettes, `knownProjects` / `knownPersonalProjects`, et s’affichent sur la carte tâche. Depuis **1.0.0-beta.21**, le **`!`** peut être **collé** au mot précédent (sans espace), comme certaines formes de **`#`** — ex. `Courrier!perso#dentiste` ; le **`@`** reste en général après **espace** ou en **début** de segment pour limiter les faux positifs sur les courriels. Les suggestions (modèles, historique) complètent la saisie.",
+          example:
+            "Saisir « Correctifs auth #bugfix @mobile » ou « Repos #repos !perso », lancer le suivi : pastille projet ciel ou rose selon le jeton ; les rubriques connues se mettent à jour pour les prochains choix.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: false,
+          text: "Déclarer un projet personnel avec le jeton `!` (temps de suivi distinct des projets `@`), y compris en tâche passée, au renommage côté serveur et dans les modèles de tâche.",
+          detail:
+            "`lib/taskParsing.ts` (`parseTaskWithAutoTags`, `buildStartTaskFromDraft`, `formatProjectDisplay`, jetons `!p#t`) ; persistance `personalProject` sur les tâches et `knownPersonalProjects` sur le payload ; `server/actionDispatch.ts` et `server/actionTaskSession.ts` (`startTask`, `addHistoricalTask`, `updateTask`, `saveTaskTemplate`, `renameProjectMetadata` avec `personalOnly` côté API) ; UI : `TaskFocusPanel`, `TaskSessionLiveCard`, `SavedProjectPicker`, `taskFieldStyles` (pastilles rose). Tests unitaires : `lib/taskTemplateDraft.test.ts` (modèles `!`).",
+          example:
+            "« Lecture !perso » en session live : la carte affiche le projet en rose ; enregistrer comme modèle conserve `!perso` dans Paramètres → Modèles de tâche.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: false,
+          text: "Utiliser des étiquettes sous portée projet personnel au format `!projet#sous-étiquette` (équivalent de `@projet#code` pour le travail).",
+          detail:
+            "`TagPills`, `formatTagDisplayForTask` et le parsing scoped dans `lib/taskParsing.ts` propagent le contexte `personalProject` pour l’affichage. Le jeton **`!`** de portée peut être **collé** au mot précédent (**1.0.0-beta.21**, `findProjectTokens`).",
+          example:
+            "« Suivi !dentiste#urgent » : l’étiquette scoped s’affiche avec le préfixe `!`.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: false,
+          text: "Sur la modale Gantt d’une tâche, distinguer le temps productif (`@`) et le temps personnel (`!`) : barres de couleurs différentes et totaux séparés.",
+          detail:
+            "`lib/taskTimelineGantt.ts`, `components/dashboard/TaskTimelineGanttModal.tsx`, chaînes `lib/dashboardCopy.ts` (légende et résumés productif / personnel).",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Démarrer, mettre en pause et terminer le minuteur d’une tâche indépendamment du mur de session.",
+          detail:
+            "Le cycle du minuteur sur une tâche (démarrage, pause volontaire sur la ligne, fin) est distinct du temps mural : la pause ou la reprise du mur de session (`setPaused`) ne se confond pas avec la pause du minuteur d’une tâche (`setTaskTimerPaused` / reprise) ; les segments et contextes côté serveur gardent cette séparation. Un scénario Playwright clique sur la pause depuis la carte et vérifie le passage en « Reprendre » (`e2e/task-lifecycle.spec.ts`).",
+          example:
+            "Mettre une tâche en pause depuis sa carte puis reprendre uniquement la session : le minuteur de cette tâche reste en pause jusqu’à une reprise explicite sur la ligne. « Terminer » depuis la carte enregistre la fin du suivi pour cette tâche.",
+        },
+        {
+          implemented: true,
+          text: "Lorsqu’un autre minuteur tourne, choisir pause, fin ou parallélisme et mémoriser le choix pour les prochains lancements.",
+        },
+        {
+          implemented: true,
+          text: "Ajouter des sous-tâches, les cocher et les réordonner par glisser-déposer.",
+        },
+        {
+          implemented: true,
+          text: "Enregistrer un modèle de tâche depuis une tâche en cours, en pause ou terminée, le gérer dans Paramètres, et le retrouver (saisie avec debounce, suggestions « Modèle : », palette Ctrl+K), y compris avec projet personnel `!`.",
+          detail:
+            "`saveTaskTemplate` enregistre `personalProject` ; `lib/taskTemplateDraft.ts` (`formatTaskTemplateDraftLine`, `parseTaskTemplatesFromPayload`, `buildTaskTemplateSignature` avec segment travail/personnel) ; `SettingsTaskTemplatesSection.tsx`.",
+        },
+        {
+          implemented: true,
+          text: "Saisir une tâche en direct ou la reporter dans le passé avec début et fin explicites.",
+        },
+        {
+          implemented: true,
+          text: "Ajouter une note libre sur une tâche (directe ou passée) pour documenter le contexte de l’activité.",
+        },
+        {
+          implemented: true,
+          text: "Afficher la note de tâche avant la liste des sous-tâches pour garder le contexte visible pendant le découpage.",
+        },
+        {
+          implemented: true,
+          text: "Corriger les bornes temporelles d’une tâche en choisissant de conserver la durée système, une durée manuelle ou un recalcul depuis début/fin.",
+        },
+        {
+          implemented: true,
+          text: "Voir les tâches dont le début (non terminée) est encore dans le futur regroupées sous « Planifiées » avec un style distinct, sans minuteur « en direct » ni apparence « terminée barrée » prématurée ; pour une tâche terminée, le même affichage « planifié » seulement si début et fin sont encore tous deux dans le futur.",
+        },
+        {
+          implemented: true,
+          text: "Lorsqu’une tâche sort de « Planifiées » et devient en cours alors qu’un autre minuteur tournait déjà, résoudre pause / terminer / parallèle sur les tâches déjà au minuteur (même préférence mémorisée que pour un lancement manuel) et faire pulser l’icône Tableau de bord hors route pour signaler l’attention.",
+        },
+        {
+          implemented: true,
+          text: "Programmer une heure de fin sur une tâche en cours : la tâche se termine automatiquement à l’échéance (carte passée en terminée à cet instant).",
+        },
+        {
+          implemented: true,
+          text: "Lancer KronoFocus depuis une tâche pour alterner travail et pauses sans perdre le lien avec la tâche.",
+        },
+        {
+          discarded: true,
+          implemented: false,
+          text: "Traiter en rapport le temps mur de session et le temps tâche comme une seule mesure interchangeable sans les distinguer.",
+          detail:
+            "Décision : écartée. Les rapports et agrégats distinguent volontairement le temps mur (segments collecteur) du temps tâche ; les deux lectures complètent une analyse honnête.",
+          example:
+            "Comparer les totaux « mur » et « tâche » dans les vues reporting — les écarts sont informatifs, pas des erreurs à effacer.",
+        },
+      ],
+    },
+    {
+      id: "us-kronofocus",
+      title: "KronoFocus",
+      stories: [
+        {
+          implemented: true,
+          text: "Activer l’affichage du minuteur KronoFocus dans l’en-tête et/ou près des actions de tâche selon les réglages.",
+        },
+        {
+          implemented: true,
+          text: "Enchaîner phases de travail, pause et longue pause avec durée au format HH:MM:SS.",
+        },
+        {
+          implemented: true,
+          text: "Réutiliser une durée depuis l’historique des durées récentes.",
+        },
+        {
+          implemented: true,
+          text: "Attacher le focus à la tâche active pour retrouver le lien dans l’historique.",
+        },
+      ],
+    },
+    {
+      id: "us-search-shortcuts",
+      title: "Recherche dans les données et raccourcis",
+      stories: [
+        {
+          implemented: true,
+          text: "Ouvrir la palette de recherche Spotlight (Ctrl+K / ⌘K) et filtrer sessions, tâches, modèles de tâche, étiquettes et projets ; choisir un modèle remplit le brouillon nouvelle tâche.",
+        },
+        {
+          implemented: true,
+          text: "Filtrer les rubriques du guide utilisateur sur /guide avec le champ en tête de page.",
+        },
+        {
+          implemented: true,
+          text: "Consulter et personnaliser les raccourcis clavier du tableau de bord depuis la modale dédiée.",
+        },
+      ],
+    },
+    {
+      id: "us-reporting",
+      title: "Rapports et agrégats",
+      stories: [
+        {
+          implemented: true,
+          text: "Choisir une plage de dates avec préréglages jour / semaine / mois / année selon ce que l’interface expose.",
+        },
+        {
+          implemented: true,
+          text: "Restreindre les vues par une ou plusieurs étiquettes lorsque les données sont basées sur les tâches.",
+        },
+        {
+          implemented: true,
+          text: "Lire résumés, tableaux par jour, répartition par projet et par étiquette.",
+        },
+        {
+          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 (`!`).",
+          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.",
+        },
+        {
+          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.",
+          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.",
+        },
+        {
+          implemented: true,
+          text: "Voir un total de temps tâche non concurrent (fusion des chevauchements) par jour pour comparaison.",
+        },
+        {
+          implemented: true,
+          text: "Configurer le jour de début de semaine pour les vues calendaires cohérentes avec mon organisation.",
+        },
+        {
+          implemented: true,
+          text: "Relancer la visite guidée des rapports depuis les paramètres.",
+        },
+        {
+          implemented: true,
+          text: "Lorsque l’environnement fournit une heure de début prévue, voir des indicateurs d’assiduité / d’écart sur les sessions.",
+        },
+        {
+          implemented: true,
+          text: "Voir des signaux honnêtes sur le travail encore non finalisé dans la plage sélectionnée.",
+        },
+      ],
+    },
+    {
+      id: "us-settings-data",
+      title: "Paramètres, export, intégrations, danger",
+      stories: [
+        {
+          implemented: true,
+          text: "Adapter le profil d’usage pour masquer des blocs peu pertinents (ex. lignes de code pour un profil non développeur).",
+        },
+        {
+          implemented: true,
+          text: "Configurer horaire de travail, sessions planifiées, collecte et tampons.",
+        },
+        {
+          implemented: true,
+          text: "Gérer étiquettes avancées et migration d’étiquettes entre portée globale et portée projet.",
+        },
+        {
+          implemented: true,
+          text: "Renommer une étiquette ou un projet en inline (crayon, saisie directe, Entrée/Échap), avec avertissement d’impact reporting et option « ne plus afficher ».",
+        },
+        {
+          implemented: false,
+          text: "Gérer et renommer depuis Paramètres la liste des projets personnels connus (`knownPersonalProjects`, jetons `!`) de la même façon que les projets `@`.",
+          detail:
+            "Le payload et les actions serveur maintiennent `knownPersonalProjects` et `renameProjectMetadata` avec `personalOnly` ; la section Projets / étiquettes avancées n’expose pas encore d’inline dédié aux `!` au 2026-05-12.",
+        },
+        {
+          implemented: true,
+          text: "Activer des commutateurs de correction d’horodatage pour les bornes de tâches et de sessions.",
+        },
+        {
+          implemented: true,
+          text: "Brancher Git et MongoDB de façon opt-in.",
+        },
+        {
+          implemented: true,
+          text: "Obtenir une sauvegarde via l’API d’export et les options prévues dans l’interface.",
+        },
+        {
+          implemented: true,
+          text: "Effacer l’historique dans une zone dangereuse protégée par confirmation explicite.",
+        },
+        {
+          implemented: true,
+          text: "En développement local (next dev), utiliser un coffre de données distinct et optionnellement partagé avec la prod.",
+        },
+        {
+          implemented: true,
+          text: "Configurer le Web, l’API et la relance de visites guidées depuis les paramètres.",
+        },
+      ],
+    },
+    {
+      id: "us-architecture-quality",
+      title: "Architecture, qualité, documentation",
+      stories: [
+        {
+          implemented: true,
+          text: "Bénéficier de mutations qui passent par un point d’entrée serveur unique pour les invariants.",
+        },
+        {
+          implemented: true,
+          text: "Recharger la page et retrouver l’état depuis le payload JSON persisté.",
+        },
+        {
+          implemented: true,
+          text: "Disposer de chaînes d’interface en français et en anglais pour les surfaces visibles.",
+        },
+        {
+          implemented: true,
+          text: "S’appuyer sur une suite de tests de bout en bout Playwright pour les parcours critiques.",
+        },
+        {
+          implemented: true,
+          text: "Consulter cette liste de user stories sur /implementation pour suivre le périmètre livré.",
+        },
+        {
+          implemented: false,
+          text: "Remplacer le guide utilisateur (/guide) par cette page pour apprendre le produit.",
+        },
+      ],
+    },
+  ],
+};
+
+const enBundle: ImplementationNotesBundle = {
+  pageTitle: "User stories — implementation status",
+  pageSubtitle:
+    "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)",
+  repositoryDocLabel: "Repository document: docs/IMPLEMENTATION_DETAILS.md",
+  storyGroupsHeading: "User story inventory",
+  implementationColumnLabel: "Implementation",
+  storyColumnLabel: "User story",
+  integrationColumnLabel: "Integration",
+  e2eColumnLabel: "E2E",
+  openChangelogAria: "Open user changelog",
+  openChangelogTooltip: "Open changelog",
+  storyDetailsToggleExpand: "Show details and example",
+  storyDetailsToggleCollapse: "Hide details and example",
+  storyDetailExampleLabel: "Example:",
+  storyExpandHintLine:
+    "Some rows include a chevron — expand for extra detail and a smaller-type example.",
+  storyDiscardedBadge: "Discarded",
+  storyDiscardedLegendLine:
+    "Rows tagged “Discarded” record intents we deliberately closed; they stay listed so the same debate does not reopen by mistake.",
+  storyGroups: [
+    {
+      id: "us-shell",
+      title: "Chrome, navigation, comfort",
+      lead: "Shared toolbar, main routes, theme and language.",
+      stories: [
+        {
+          implemented: true,
+          text: "Move between dashboard, guide, reporting, settings, and this page from the top icons.",
+          detail:
+            "Targets include the dashboard, reporting charts, settings, the in-app guide, this implementation page, action logs, licenses, and the user changelog; icons sit in the shared header toolbar.",
+          example:
+            "From the dashboard, clicking the book icon opens /guide while keeping the session query (?session=) when it is set.",
+        },
+        {
+          implemented: true,
+          text: "See a live-updating wall clock in the header toolbar (time zone and 12/24 h from web dashboard settings).",
+        },
+        {
+          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.",
+        },
+        {
+          implemented: true,
+          text: "Open the Licenses page from the document icon when I am already on Licenses.",
+        },
+        {
+          implemented: true,
+          text: "Switch between light and dark theme for visual comfort.",
+        },
+        {
+          implemented: true,
+          text: "Refresh server state without reloading the whole app.",
+        },
+        {
+          implemented: true,
+          text: "Pick UI language (FR / EN) with an optional persisted preference.",
+        },
+        {
+          implemented: true,
+          text: "Keep the dashboard session query (?session=) when navigating between routes.",
+        },
+      ],
+    },
+    {
+      id: "us-sessions",
+      title: "Sessions — scope, wall clock, pause, end",
+      stories: [
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Create a new session now (immediate start) and see it in the session list.",
+          detail:
+            "The New session modal offers Start now; after confirm, the row appears in the Sessions column as live.",
+          example:
+            "New session → Start session: a Live row appears at the top with your start time.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Create a past session by entering start and end (local time), then see it in the session list.",
+          detail:
+            "In the past mode requires both bounds in browser-local time; the closed interval is saved to history without necessarily stopping an already running session.",
+          example:
+            "Yesterday 2:00–4:00 pm — a completed row shows those bounds while another session can stay active.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Create a session with no optional limits (no max duration, no calendar window, no weekdays/time window).",
+          detail:
+            "No limit skips max wall duration, calendar bounds, and weekday/time-window scope for that session.",
+          example:
+            "Leave No limit checked and start — only later heartbeats/banners may warn if work runs long.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Cap a session with a maximum wall-clock duration (nudge to reframe).",
+          detail:
+            "Max duration is expressed in hours of accumulated wall time; the UI can warn when you approach or exceed the cap depending on settings.",
+          example:
+            "4 h max — beyond that, duration styling may turn alert (color or slow blink).",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Set a calendar window (start and end dates) for a session.",
+          detail:
+            "From / To dates are inclusive in your dashboard display timezone; they frame expectations for reminders.",
+          example:
+            "March 3–10 for a fixed delivery sprint window.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Define a week pattern with selected weekdays and a time window.",
+          detail:
+            "Pick active weekdays and optionally a daily time slot; overnight windows (e.g. 10:00 pm–6:00 am) are supported.",
+          example:
+            "Tue/Thu + 6:30–9:00 pm for after-hours sessions.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Use “Today” / “Now” shortcuts in date and time pickers.",
+          detail:
+            "Buttons stamp today’s date or the current instant into modal fields without full typing.",
+          example:
+            "Today on a From date; Now as the end of a past session that just finished.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "See session duration follow wall-clock time while the session is live and not session-paused.",
+          detail:
+            "The session card shows wall duration advancing while the session is neither ended nor session-paused.",
+          example:
+            "Without session pause, Duration ticks each second; session pause freezes display until resume.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Pause the session so wall time stops accruing, distinct from pausing a task timer.",
+          detail:
+            "Session pause targets the collector wall; the server may also freeze active task and subtask timers using a `sessionPauseContext` snapshot (selective restore). Task-only pause stays on the card and is not the same as global pause.",
+          example:
+            "Session pause → Live session paused banner; a task you left manually paused before session pause stays consistent with the snapshot rules.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Start a global pause with a confirmation modal summarizing effects, durations, and scope.",
+          detail:
+            "Global pause aligns the live session with affected task and subtask timers; the modal summarizes wall time, recorded times, and counts before you confirm or cancel.",
+          example:
+            "Toolbar → “Pause session, tasks, and subtasks in this context” → read the summary → “Pause now” or dismiss.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "When the live session is paused (wall-clock or global pause), recognize it on the Active session card (chip), see a centered reminder on a dimmed overlay while the top bar stays usable, and spot the global resume control highlighted when global pause is active.",
+          detail:
+            "Server: `setPaused` stores `sessionPauseContext` for active timers and restores only that snapshot on resume; starting global pause clears any leftover `sessionPauseContext`. UI: “Paused” / “Global pause” chips (`SelectedSessionSidebarBlock.tsx`), full-screen `DashboardPauseBackdrop` under the header (`z-40` vs `z-50`), amber ring on the global pause control when it shows play (`AppShellRouteNav.tsx`).",
+          example:
+            "After global pause: “Global pause” chip, “Global pause is on” overlay, circled play button in the toolbar.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "End a session with an optional closure reason (on time, early, overrun, other + note).",
+          detail:
+            "The end-session modal offers optional categories and a free-text note; both are stored on the history snapshot with the current end time.",
+          example:
+            "Ended early + “release slipped” then End session from the sidebar or row controls.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Add a free-text note to a session and review it in the session sidebar.",
+          detail:
+            "The “Session note” field lives in the session card (Sessions column). It is saved on blur and survives a full page reload.",
+          example:
+            "Type “Client review checkpoint — prep demo” before a meeting to keep context in the same card.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "See a session-note preview (icon + excerpt) in the sessions list and in archived sessions.",
+          detail:
+            "When a note exists, the list shows an icon and truncated excerpt next to the session title; archived rows follow the same pattern where applicable.",
+          example:
+            "A row shows “…stand-up notes…” under the title when that text is in the note.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "See the live session row highlighted when the official start time is still in the future (status dot and distinct row styling in the list).",
+          detail:
+            "Until real time reaches the recorded official start, the live row keeps a “not yet started” look (dot + background).",
+          example:
+            "Official start at 6:00 pm while it is 2:00 pm — styling stays distinct until 6:00 pm.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Schedule an end time on a live session so it automatically ends when the deadline is reached (snapshot moves to history).",
+          detail:
+            "You can set a scheduled session end time; when real time reaches it, the session closes: wall time is finalized up to that instant, open tasks are frozen like ending with keep (no closure modal).",
+          example:
+            "End at 5:00 pm — without extra clicks, the live session becomes a history row at 5:00 pm if it was still open.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "When closing a session with open tasks, finish them or move them to a new paused session.",
+          detail:
+            "The end-session modal lists unfinished work and lets you keep it in the snapshot (default, same semantics as leaving tasks open), finish it with this session, or move it into a newly created paused session. Contrast: a scheduled automatic end (`scheduledEndAt`) does not show this modal; server-side it matches keep (open tasks stay in the snapshot with timers stopped). A user preference to pick a different default at scheduled end is not shipped in this version.",
+          example:
+            "Move open tasks to a new paused session to carry a bugfix batch without closing every card.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Resume a paused session from the banner; resuming a task also resumes wall accumulation.",
+          detail:
+            "The Live session paused banner offers resume; when a task returns to active tracking under dashboard rules, wall time can accrue again.",
+          example:
+            "Resume from the banner then start a task — wall duration increases again.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Configure an initial session name template (date/time codes, %UUID, timezone aligned with the dashboard).",
+          detail:
+            "Under Settings → web dashboard, a name pattern can include date, time, short UUID, or the display timezone token.",
+          example:
+            "“Session %Y-%m-%d” becomes “Session 2026-05-08” on each create.",
+        },
+        {
+          discarded: true,
+          implemented: false,
+          text: "Have a single “pause” action that applies the same effect to wall time and all task timers as one primitive.",
+          detail:
+            "Decision: discarded. Global pause already freezes the wall and timers for the displayed context together; per-task pause stays a separate fine control on purpose.",
+          example:
+            "We keep global pause (toolbar) and targeted pauses instead of one universal button.",
+        },
+        {
+          discarded: true,
+          implemented: false,
+          text: "Get wall session duration as the automatic sum of recorded task durations.",
+          detail:
+            "Decision: discarded. Wall time follows collector segments; task totals are aggregated separately in metrics and reporting.",
+          example:
+            "Compare the session card with tasks — both views may differ; that is expected.",
+        },
+      ],
+    },
+    {
+      id: "us-tasks",
+      title: "Tasks, tags, projects, timers",
+      stories: [
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Create a task with a title and use # for tags, @ for work projects, and ! for personal projects with typing assistance.",
+          detail:
+            "The “what are you working on” field accepts #tag, @project (work), and !project (personal) tokens in the title; they are parsed on start (`startTask`), feed known tag lists plus `knownProjects` / `knownPersonalProjects`, and render on the task card. Since **1.0.0-beta.21**, **`!`** may be **glued** to the previous word (no space), like some **`#`** forms — e.g. `Errands!me#dentist`; **`@`** still expects **leading whitespace** or **string start** so mid-token emails are not parsed as projects. Templates and suggestions complement typing.",
+          example:
+            "Enter “Auth fixes #bugfix @mobile” or “Rest #rest !me”, start tracking: the project chip is sky or rose depending on the token; known lists update for the next picks.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: false,
+          text: "Declare a personal project with the `!` token (tracking separate from `@` work projects), including past tasks, server rename paths, and task templates.",
+          detail:
+            "`lib/taskParsing.ts` (`parseTaskWithAutoTags`, `buildStartTaskFromDraft`, `formatProjectDisplay`, `!p#t` tokens) ; `personalProject` on tasks and `knownPersonalProjects` on the payload ; `server/actionDispatch.ts` and `server/actionTaskSession.ts` (`startTask`, `addHistoricalTask`, `updateTask`, `saveTaskTemplate`, `renameProjectMetadata` with `personalOnly` on the API) ; UI: `TaskFocusPanel`, `TaskSessionLiveCard`, `SavedProjectPicker`, `taskFieldStyles` (rose chips). Unit tests: `lib/taskTemplateDraft.test.ts` (`!` templates).",
+          example:
+            "“Reading !me” while live: the card shows the rose project chip; saving as a template keeps `!me` under Settings → Task templates.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: false,
+          text: "Use per-personal-project scoped tags in the `!project#subtag` form (same idea as `@project#code` for work).",
+          detail:
+            "`TagPills`, `formatTagDisplayForTask`, and scoped parsing in `lib/taskParsing.ts` carry `personalProject` for display. The scoped **`!`** token may be **glued** to the previous word (**1.0.0-beta.21**, `findProjectTokens`).",
+          example:
+            "“Follow-up !dentist#urgent”: scoped tag renders with the `!` prefix.",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: false,
+          text: "On a task’s Gantt modal, separate productive (`@`) vs personal (`!`) time with distinct bar colors and split totals.",
+          detail:
+            "`lib/taskTimelineGantt.ts`, `components/dashboard/TaskTimelineGanttModal.tsx`, `lib/dashboardCopy.ts` strings (legend and summaries).",
+        },
+        {
+          implemented: true,
+          integrationChecked: true,
+          e2eChecked: true,
+          text: "Start, pause, and finish a task timer independently of session wall time.",
+          detail:
+            "Each task timer cycle (start, manual pause on the row, finish) is separate from wall time: pausing or resuming the session wall (`setPaused`) is not the same as pausing that task’s timer (`setTaskTimerPaused` / resume); server-side segments and pause contexts preserve the distinction. A Playwright scenario clicks pause on the card and checks the resume control (`e2e/task-lifecycle.spec.ts`).",
+          example:
+            "Pause a task from its card, then resume only the session: that task’s timer stays paused until you explicitly resume the row. “Finish” on the card ends tracking for that task.",
+        },
+        {
+          implemented: true,
+          text: "When another timer is running, choose pause, finish, or parallel run and save the default for next time.",
+        },
+        {
+          implemented: true,
+          text: "Add subtasks, check them off, and reorder by drag and drop.",
+        },
+        {
+          implemented: true,
+          text: "Save a task template from a running, paused, or completed task, manage it in Settings, and find it again (debounced input, “Template:” hints, Ctrl+K palette), including personal `!` projects.",
+          detail:
+            "`saveTaskTemplate` stores `personalProject` ; `lib/taskTemplateDraft.ts` (`formatTaskTemplateDraftLine`, `parseTaskTemplatesFromPayload`, `buildTaskTemplateSignature` with work/personal segment) ; `SettingsTaskTemplatesSection.tsx`.",
+        },
+        {
+          implemented: true,
+          text: "Log a task live or backfill it with explicit start and end times.",
+        },
+        {
+          implemented: true,
+          text: "Add a free-text note on a task (live or past entry) to keep activity context.",
+        },
+        {
+          implemented: true,
+          text: "Render task notes before the subtasks block so context stays visible while breaking down work.",
+        },
+        {
+          implemented: true,
+          text: "Edit task time bounds by keeping system duration, entering manual duration, or recalculating from bounds.",
+        },
+        {
+          implemented: true,
+          text: "See not-done tasks whose start is still in the future grouped under Planned with distinct styling, no live-running timer, and no crossed-out completed look too early; for completed tasks, the same Planned styling only when both start and end are still strictly in the future.",
+        },
+        {
+          implemented: true,
+          text: "When a planned task becomes live tracking while another timer was already running, resolve pause/finish/parallel for the previously running tasks (same remembered preference as manual starts) and pulse the dashboard nav icon when attention is needed off-route.",
+        },
+        {
+          implemented: true,
+          text: "Schedule an end time on a running task so it automatically completes when the deadline is reached.",
+        },
+        {
+          implemented: true,
+          text: "Launch KronoFocus from a task to alternate work and breaks without losing task context.",
+        },
+        {
+          discarded: true,
+          implemented: false,
+          text: "Treat wall session time and task time as one interchangeable reporting measure without separating them.",
+          detail:
+            "Decision: discarded. Reporting and aggregates intentionally keep wall time (collector segments) separate from task time; both views support an honest read.",
+          example:
+            "Compare wall vs task totals in reporting — gaps are informative, not mistakes to merge away.",
+        },
+      ],
+    },
+    {
+      id: "us-kronofocus",
+      title: "KronoFocus",
+      stories: [
+        {
+          implemented: true,
+          text: "Show the KronoFocus timer in the header and/or near task actions per settings.",
+        },
+        {
+          implemented: true,
+          text: "Run work, break, and long-break phases with duration in HH:MM:SS.",
+        },
+        {
+          implemented: true,
+          text: "Reuse a duration from recent duration history.",
+        },
+        {
+          implemented: true,
+          text: "Attach focus to the active task so history stays linked.",
+        },
+      ],
+    },
+    {
+      id: "us-search-shortcuts",
+      title: "Data search and shortcuts",
+      stories: [
+        {
+          implemented: true,
+          text: "Open the Spotlight data-search palette (Ctrl+K / ⌘K) and filter sessions, tasks, task templates, tags, and projects; choosing a template fills the new-task draft.",
+        },
+        {
+          implemented: true,
+          text: "Filter user guide sections on /guide with the field at the top of the page.",
+        },
+        {
+          implemented: true,
+          text: "View and customize dashboard keyboard shortcuts in the dedicated modal.",
+        },
+      ],
+    },
+    {
+      id: "us-reporting",
+      title: "Reporting and aggregates",
+      stories: [
+        {
+          implemented: true,
+          text: "Pick a date range with day / week / month / year presets as exposed by the UI.",
+        },
+        {
+          implemented: true,
+          text: "Restrict views by one or more tags when data is task-based.",
+        },
+        {
+          implemented: true,
+          text: "Read summaries, per-day tables, and breakdowns by project and tag.",
+        },
+        {
+          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.",
+          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.",
+        },
+        {
+          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.",
+          detail:
+            "Library aggregates accept `taskProjectScope: \"personal\"` (`aggregateProjectTaskMinutesByDay`, `aggregateReportingByProject`, `aggregateTagTaskMinutesByDayAndWeek`); no second “personal” grid is wired in the UI as of 2026-05-12.",
+        },
+        {
+          implemented: true,
+          text: "See non-overlapping task minutes per day for comparison with raw totals.",
+        },
+        {
+          implemented: true,
+          text: "Set the week start day for calendar views to match how I work.",
+        },
+        {
+          implemented: true,
+          text: "Relaunch the reporting tour from settings.",
+        },
+        {
+          implemented: true,
+          text: "When the host supplies a planned start time, see punctuality / variance indicators on sessions.",
+        },
+        {
+          implemented: true,
+          text: "See honest signals about work not yet finalized in the selected range.",
+        },
+      ],
+    },
+    {
+      id: "us-settings-data",
+      title: "Settings, export, integrations, danger zone",
+      stories: [
+        {
+          implemented: true,
+          text: "Tune usage profile to hide blocks that are not relevant (e.g. lines of code for a non-dev profile).",
+        },
+        {
+          implemented: true,
+          text: "Configure work schedule, planned sessions, collection, and buffers.",
+        },
+        {
+          implemented: true,
+          text: "Manage advanced tags and migrate tags between global and per-project scope.",
+        },
+        {
+          implemented: true,
+          text: "Rename a tag or project inline (pencil, direct edit, Enter/Escape), with a reporting-impact warning and a “don’t show again” option.",
+        },
+        {
+          implemented: false,
+          text: "Manage and rename known personal projects (`knownPersonalProjects`, `!` tokens) from Settings the same way as `@` projects.",
+          detail:
+            "Payload + server actions maintain `knownPersonalProjects` and `renameProjectMetadata` with `personalOnly`; the Settings projects/tags area does not yet expose dedicated `!` inline management as of 2026-05-12.",
+        },
+        {
+          implemented: true,
+          text: "Toggle correction switches for task and session time bounds.",
+        },
+        {
+          implemented: true,
+          text: "Opt in to Git and MongoDB integrations.",
+        },
+        {
+          implemented: true,
+          text: "Download backups via the export API and UI options.",
+        },
+        {
+          implemented: true,
+          text: "Erase history in a danger zone gated by explicit confirmation.",
+        },
+        {
+          implemented: true,
+          text: "In local dev (next dev), use a separate dataset vault and optionally share with prod.",
+        },
+        {
+          implemented: true,
+          text: "Configure web, API, and guided-tour relaunches from settings.",
+        },
+      ],
+    },
+    {
+      id: "us-architecture-quality",
+      title: "Architecture, quality, documentation",
+      stories: [
+        {
+          implemented: true,
+          text: "Rely on mutations going through a single server entry point for invariants.",
+        },
+        {
+          implemented: true,
+          text: "Reload the page and restore state from persisted JSON payload.",
+        },
+        {
+          implemented: true,
+          text: "Use French and English UI strings on visible surfaces.",
+        },
+        {
+          implemented: true,
+          text: "Benefit from Playwright end-to-end tests on critical flows.",
+        },
+        {
+          implemented: true,
+          text: "Open this user-story list on /implementation to track shipped scope.",
+        },
+        {
+          implemented: false,
+          text: "Replace the user guide (/guide) with this page for learning the product.",
+        },
+      ],
+    },
+  ],
+};
+
+export function implementationNotesBundle(lang: Lang): ImplementationNotesBundle {
+  return lang === "fr" ? frBundle : enBundle;
+}