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

package/lib/dashboardQuickSearch.ts

@@ -1,4 +1,6 @@
 import type { DashboardStrings } from "@/lib/dashboardCopy";
+import type { ParsedTaskTemplateRow } from "@/lib/taskTemplateDraft";
+import { formatTaskTemplateDraftLine } from "@/lib/taskTemplateDraft";
 import type { SessionListEntry } from "@/components/dashboard/SessionListPanel";
 import {
   formatDuration,
@@ -313,13 +315,28 @@ export function buildDashboardQuickSearchItems(opts: {
   dt: DashboardStrings;
   /** Session live (pour l’état actif / pause dans les résultats). */
   liveSearchContext?: SearchLiveContext | null;
+  /** Modèles de tâche (payload `taskTemplates`). */
+  taskTemplates?: ParsedTaskTemplateRow[];
+  /** Applique le texte du modèle au champ « nouvelle tâche » (recherche rapide). */
+  onSelectTaskTemplate?: (draftLine: string) => void;
   onSelectSession: (sessionId: string) => void | Promise<void>;
   scrollToSession: (sessionId: string) => void;
   focusTasksColumn: () => void;
   scrollToTask: (taskId: string) => void;
 }): DashboardSearchItem[] {
-  const { history, historyArchived, sessionCurrent, dt, liveSearchContext, onSelectSession, scrollToSession, focusTasksColumn, scrollToTask } =
-    opts;
+  const {
+    history,
+    historyArchived,
+    sessionCurrent,
+    dt,
+    liveSearchContext,
+    taskTemplates,
+    onSelectTaskTemplate,
+    onSelectSession,
+    scrollToSession,
+    focusTasksColumn,
+    scrollToTask,
+  } = opts;
   const items: DashboardSearchItem[] = [];
   const seenSid = new Set<string>();
 
@@ -472,5 +489,40 @@ export function buildDashboardQuickSearchItems(opts: {
     });
   }
 
+  if (taskTemplates && taskTemplates.length > 0 && onSelectTaskTemplate) {
+    const tmplHayExtra =
+      "template modèle modèle de tâche task template gabarit saved task template";
+    for (const tpl of taskTemplates) {
+      const tid = typeof tpl.id === "string" ? tpl.id.trim() : "";
+      if (!tid) {
+        continue;
+      }
+      const draft = formatTaskTemplateDraftLine(tpl);
+      if (!draft.trim()) {
+        continue;
+      }
+      const rawName = typeof tpl.name === "string" ? tpl.name : "";
+      const idx = buildTaskSearchIndex(rawName, tpl.tags, tpl.project);
+      const displayTitle =
+        taskTitleForDisplay(rawName).trim() || tid.slice(0, 8);
+      const hay = `${rawName} ${displayTitle} ${tid} ${draft} ${idx.haystackFragment} ${tmplHayExtra} ${dt.dataSearchKindTaskTemplate}`
+        .trim()
+        .toLowerCase();
+      items.push({
+        id: `search-task-template-${tid}`,
+        title: displayTitle,
+        subtitle: dt.dataSearchKindTaskTemplate,
+        metaLine: idx.metaLine.trim()
+          ? truncateMetaLine(idx.metaLine, 160)
+          : undefined,
+        haystack: hay,
+        onSelect: () => {
+          focusTasksColumn();
+          onSelectTaskTemplate(draft);
+        },
+      });
+    }
+  }
+
   return dedupeSearchItemsById(items);
 }

package/lib/dashboardTimeZone.ts

@@ -89,3 +89,112 @@ export function calendarDateKeyInTimeZone(iso: string | null | undefined, timeZo
     return null;
   }
 }
+
+/**
+ * Décalage `local - utc` (millisecondes) du fuseau au point dans le temps `utcMs`.
+ * Tient compte des transitions DST (le décalage varie en cours d’année).
+ */
+function timeZoneOffsetMsAtUtc(utcMs: number, timeZone: string): number {
+  const fmt = new Intl.DateTimeFormat("en-CA", {
+    timeZone,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hourCycle: "h23",
+  });
+  const parts = fmt.formatToParts(new Date(utcMs));
+  const get = (t: string): number => {
+    const v = parts.find((p) => p.type === t)?.value ?? "0";
+    return Number.parseInt(v, 10) || 0;
+  };
+  const y = get("year");
+  const m = get("month");
+  const d = get("day");
+  const h = get("hour") % 24;
+  const min = get("minute");
+  const s = get("second");
+  const localAsUtc = Date.UTC(y, m - 1, d, h, min, s);
+  return localAsUtc - utcMs;
+}
+
+/**
+ * Instant UTC (ms) correspondant à minuit local (`00:00:00`) du jour calendaire indiqué dans
+ * le fuseau donné. Itère jusqu’à convergence (en pratique 1 ou 2 itérations) pour gérer
+ * correctement les transitions DST : `utc = localMs - offset(utc)`.
+ *
+ * Les valeurs `month`/`day` peuvent dépasser leurs bornes (ex. `day = 32`) ; `Date.UTC` reporte
+ * naturellement sur le mois suivant — pratique pour calculer la borne de fin d’un jour.
+ */
+export function calendarDayStartUtcMsInTimeZone(
+  year: number,
+  month: number,
+  day: number,
+  timeZone: string,
+): number {
+  const tz = timeZone.trim() || DEFAULT_DASHBOARD_TIME_ZONE;
+  if (!isValidIanaTimeZone(tz)) {
+    return Date.UTC(year, month - 1, day, 0, 0, 0, 0);
+  }
+  /** Cible exprimée en « millisecondes locales » (vue UTC d’une horloge locale à minuit). */
+  const localMs = Date.UTC(year, month - 1, day, 0, 0, 0, 0);
+  let guess = localMs;
+  for (let pass = 0; pass < 4; pass += 1) {
+    const off = timeZoneOffsetMsAtUtc(guess, tz);
+    const next = localMs - off;
+    if (next === guess) {
+      return guess;
+    }
+    guess = next;
+  }
+  return guess;
+}
+
+/**
+ * Découpe l’intervalle `[startMs, endMs[` (UTC) par jour calendaire local et renvoie la durée
+ * (minutes) tombant dans chaque jour. Renvoie une map vide si l’intervalle est vide ou invalide.
+ *
+ * Le bord supérieur est exclusif : un événement qui finit pile à minuit est compté entièrement
+ * sur le jour précédent (cas limite peu fréquent en pratique).
+ */
+export function splitMinutesByCalendarDay(
+  startMs: number,
+  endMs: number,
+  timeZone: string,
+): Map<string, number> {
+  const out = new Map<string, number>();
+  if (!Number.isFinite(startMs) || !Number.isFinite(endMs) || endMs <= startMs) {
+    return out;
+  }
+  const tz = timeZone.trim() || DEFAULT_DASHBOARD_TIME_ZONE;
+  /** Garde-fou : on borne le nombre d’itérations pour ne pas boucler sur un fuseau invalide. */
+  const maxDays = 366 * 5;
+  let cursor = startMs;
+  for (let i = 0; i < maxDays && cursor < endMs; i += 1) {
+    const dayKey = calendarDateKeyInTimeZone(new Date(cursor).toISOString(), tz);
+    if (!dayKey) {
+      return new Map();
+    }
+    const [yStr, mStr, dStr] = dayKey.split("-");
+    const y = Number.parseInt(yStr, 10);
+    const m = Number.parseInt(mStr, 10);
+    const d = Number.parseInt(dStr, 10);
+    if (!Number.isFinite(y) || !Number.isFinite(m) || !Number.isFinite(d)) {
+      return new Map();
+    }
+    const nextDayStart = calendarDayStartUtcMsInTimeZone(y, m, d + 1, tz);
+    const sliceEnd = Math.min(endMs, nextDayStart);
+    if (sliceEnd <= cursor) {
+      /** Sécurité : si on n’a pas progressé (fuseau pathologique), on s’arrête. */
+      break;
+    }
+    const minutes = (sliceEnd - cursor) / 60000;
+    if (minutes > 0) {
+      out.set(dayKey, (out.get(dayKey) ?? 0) + minutes);
+    }
+    cursor = sliceEnd;
+  }
+  return out;
+}

package/lib/formatAppShellWallClock.ts

@@ -0,0 +1,66 @@
+import type { Lang } from "./dashboardCopy";
+import { readDashboardUse24HourClockFromCfg } from "./dashboardClockFormat";
+import { readDashboardTimeZoneFromCfg } from "./dashboardTimeZone";
+
+export type AppShellWallClockParts = {
+  timeZone: string;
+  display: string;
+  ariaDatetime: string;
+};
+
+function intlLocale(lang: Lang): string {
+  return lang === "fr" ? "fr-CA" : "en-CA";
+}
+
+/**
+ * Heure murale affichée dans l’en-tête : fuseau et format 12/24 h alignés sur les paramètres tableau de bord.
+ */
+export function formatAppShellWallClock(
+  now: Date,
+  cfg: Record<string, unknown> | undefined,
+  lang: Lang,
+): AppShellWallClockParts {
+  const timeZone = readDashboardTimeZoneFromCfg(cfg);
+  const use24Hour = readDashboardUse24HourClockFromCfg(cfg);
+  const locale = intlLocale(lang);
+  let display: string;
+  let ariaDatetime: string;
+  try {
+    display = new Intl.DateTimeFormat(locale, {
+      timeZone,
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit",
+      hour12: !use24Hour,
+    }).format(now);
+    ariaDatetime = new Intl.DateTimeFormat(locale, {
+      timeZone,
+      weekday: "long",
+      year: "numeric",
+      month: "long",
+      day: "numeric",
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit",
+      hour12: !use24Hour,
+    }).format(now);
+  } catch {
+    display = new Intl.DateTimeFormat(locale, {
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit",
+      hour12: !use24Hour,
+    }).format(now);
+    ariaDatetime = new Intl.DateTimeFormat(locale, {
+      weekday: "long",
+      year: "numeric",
+      month: "long",
+      day: "numeric",
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit",
+      hour12: !use24Hour,
+    }).format(now);
+  }
+  return { timeZone, display, ariaDatetime };
+}

package/lib/formatSessionNameTemplate.ts

@@ -0,0 +1,141 @@
+import {
+  DEFAULT_DASHBOARD_TIME_ZONE,
+  isValidIanaTimeZone,
+} from "@/lib/dashboardTimeZone";
+
+export const SESSION_NAME_TEMPLATE_MAX_LEN = 500;
+
+/** Nombre maximal de caractères stockés dans `cfg.dashboardDefaultSessionNameTemplate`. */
+export const SESSION_NAME_TEMPLATE_CFG_MAX_LEN = 400;
+
+/** Composantes calendaires / horaires pour le fuseau IANA (`dashboardDisplayTimeZone`). */
+export type ZonedDateTimeAtoms = {
+  year: string;
+  month: string;
+  day: string;
+  hour: string;
+  minute: string;
+  second: string;
+};
+
+export function formatSessionNameAtoms(
+  atMs: number,
+  timeZone: string | undefined | null,
+): ZonedDateTimeAtoms {
+  const tzRaw = typeof timeZone === "string" ? timeZone.trim() : "";
+  const tz =
+    tzRaw.length > 0 && isValidIanaTimeZone(tzRaw) ? tzRaw : DEFAULT_DASHBOARD_TIME_ZONE;
+  const d = new Date(atMs);
+  const dateParts = new Intl.DateTimeFormat("en-CA", {
+    timeZone: tz,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+  }).formatToParts(d);
+  const timeParts = new Intl.DateTimeFormat("en-GB", {
+    timeZone: tz,
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hour12: false,
+    hourCycle: "h23",
+  }).formatToParts(d);
+
+  const pick = (parts: Intl.DateTimeFormatPart[], type: Intl.DateTimeFormatPartTypes): string =>
+    parts.find((p) => p.type === type)?.value ?? "";
+
+  return {
+    year: pick(dateParts, "year"),
+    month: pick(dateParts, "month"),
+    day: pick(dateParts, "day"),
+    hour: pick(timeParts, "hour"),
+    minute: pick(timeParts, "minute"),
+    second: pick(timeParts, "second"),
+  };
+}
+
+export type FormatSessionNameTemplateOpts = Readonly<{
+  sessionId: string;
+  atMs: number;
+  timeZone: string | undefined | null;
+}>;
+
+/**
+ * Remplace `%UUID` et un sous-ensemble inspiré du `strftime()` POSIX (IEEE / Open Group)
+ * pour composer le nom affiché. Le fuseau appliqué est celui des paramètres d’affichage
+ * (identique au tableau de bord / rapports pour les dates agrégées).
+ *
+ * Séquences :
+ * - `%%` → `%`
+ * - `%UUID` → identifiant complet de session (voir action `newSession`)
+ * - `%Y` `%m` `%d` `%H` `%M` `%S` : année quatre chiffres, mois, jour (00–31), heure 24 h, minute, seconde
+ * - `%y` deux derniers chiffres de `%Y`
+ * - `%F` → `%Y-%m-%d` (comme sous GNU date)
+ *
+ * Séquence `%` suivie d’un caractère non reconnu : la paire reste littérale (ex. `%Z` inchangé).
+ *
+ * Référence officielle conversions date/heure POSIX :
+ * https://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html
+ */
+function strftimeSubstitution(spec: string, z: ZonedDateTimeAtoms): string | undefined {
+  switch (spec) {
+    case "Y":
+      return z.year;
+    case "y":
+      return z.year.length >= 2 ? z.year.slice(-2) : z.year;
+    case "m":
+      return z.month;
+    case "d":
+      return z.day;
+    case "H":
+      return z.hour;
+    case "M":
+      return z.minute;
+    case "S":
+      return z.second;
+    case "F":
+      return `${z.year}-${z.month}-${z.day}`;
+    default:
+      return undefined;
+  }
+}
+
+export function formatSessionNameTemplate(
+  template: string,
+  opts: FormatSessionNameTemplateOpts,
+): string {
+  const z = formatSessionNameAtoms(opts.atMs, opts.timeZone);
+  let out = "";
+  let i = 0;
+  while (i < template.length) {
+    const c = template[i];
+    if (c !== "%") {
+      out += c;
+      i += 1;
+      continue;
+    }
+    const j = i + 1;
+    if (j >= template.length) {
+      out += "%";
+      break;
+    }
+    if (template[j] === "%") {
+      out += "%";
+      i = j + 1;
+      continue;
+    }
+    if (template.slice(j).startsWith("UUID")) {
+      out += opts.sessionId;
+      i = j + "UUID".length;
+      continue;
+    }
+    const spec = template.slice(j, j + 1);
+    if (!spec) {
+      break;
+    }
+    i = j + 1;
+    const sub = strftimeSubstitution(spec, z);
+    out += sub ?? `%${spec}`;
+  }
+  return out.trim();
+}

package/lib/generatedUserChangelog.ts

@@ -6,21 +6,192 @@ export type UserChangelogEntry = {
 
 export const USER_CHANGELOG_ENTRIES: UserChangelogEntry[] = [
   {
-    "version": "3.0.0",
+    "version": "1.0.0-beta.21",
     "items": [
-      "aefaf9e: Première version officielle publiée."
+      "**Parsing** : `findProjectTokens` (`lib/taskParsing.ts`) reconnaît désormais **`!projet`** et **`!projet#sous-étiquette`** lorsque le **`!`** suit **directement** un caractère autorisé (sans espace avant le sigil), sur le même principe que les **`#étiquettes`** « collées » au mot précédent. Les jetons **`@`** restent limités à une **frontière début de chaîne ou espace** afin d’éviter les faux positifs (ex. adresses courriel du type `contact@domaine`).",
+      "**Effet** : la modification d’un libellé du type `Courrier!perso#dentiste` met correctement à jour **`project`**, **`personalProject`** et les **étiquettes** persistées (y compris via **`updateTask`**), ce qui aligne le **reporting** (étiquettes, ventilation par projet selon le scope) sur l’intention utilisateur.",
+      "**Guide utilisateur** : `lib/userGuideCopy.ts` et `docs/USER_GUIDE.md` (FR/EN) — précision sur l’espace optionnel avant **`!`** ; en-tête et exemples de livraison pointent **`1.0.0-beta.21`**.",
+      "**Implémentation** : `docs/IMPLEMENTATION_DETAILS.md` (règle de frontière `!` / `@`) ; `lib/implementationNotes.ts` (version affichée et détail parsing scoped `!`).",
+      "**Dépôt** : `README.md` (référence de version npm).",
+      "**Tests** : `lib/taskParsing.test.ts` — cas `Courrier!perso#dentiste` ; attentes **`personalProject`** pour `parseQuickAddTagOrProjectLine` / `buildStartTaskFromInput` lorsqu’un projet est présent.",
+      "Bump applicatif : **`1.0.0-beta.21`** (`package.json`, `package-lock.json`) ; **CHANGELOG** usager régénéré (`npm run changelog:build`)."
     ]
   },
   {
-    "version": "2.0.0",
+    "version": "1.0.0-beta.20",
     "items": [
-      "aefaf9e: Première version officielle publiée."
+      "**Dépendances runtime** : `@types/node`, `@types/react` et `@types/react-dom` passées en **`dependencies`** avec `typescript` — Next.js 16 exige ces paquets pour la phase « Running TypeScript » du `next build` ; une installation **`npm install --omit=dev`** ne les omet plus (évite le message *It looks like you're trying to use TypeScript…* hors environnement de développement complet).",
+      "**Contenu du tarball publié** : suppression du champ **`files`** dans `package.json` (il neutralisait **`.npmignore`**, comportement **npm-packlist**) ; filtrage du paquet via **`.npmignore`** (fichiers `*.test.*` / `*.spec.*`, dossiers `e2e/`, `test/`, `docs/`, outils CI, etc.) en conservant les sources nécessaires au build.",
+      "Bump applicatif : **`1.0.0-beta.20`** (`package.json`, `package-lock.json`) ; **CHANGELOG** usager régénéré (`npm run changelog:build`)."
     ]
   },
   {
-    "version": "1.0.0",
+    "version": "1.0.0-beta.19",
     "items": [
-      "aefaf9e: Première version officielle publiée."
+      "**Affichage planifié** : regroupement sous **Planifiées**, styles distincts (section, fond, point d’état) ; **suppression des pastilles texte** « planifié » sur les cartes tâche et les lignes de session. Tâche **non terminée** dont le **début** (`startTime`) est encore **futur** : pas de minuteur « en direct ». Tâche **terminée** : regroupement planifié seulement si **début et fin** parseables sont **tous deux** strictement futurs — une **fin** future seule ne retient plus la carte sous Planifiées lorsque le début est déjà passé (`isTaskDisplayPlanned`). Session live à **startAt** futur : ligne distincte dans la liste ; décompte planifiées sur la carte session ; tiroir AppShell sans ces entrées comme suivi actif.",
+      "**Frontière planifié → en cours** : lorsqu’une tâche rejoint les minuteurs **en cours** alors qu’**au moins un** autre minuteur était déjà visible comme en cours, une **modale** (pause / terminer / parallèle, même mémorisation que le démarrage manuel) s’applique aux tâches déjà au minuteur ; hors route `/`, l’icône **Tableau de bord** peut **pulser**.",
+      "**Modales globales** : correction d’un décalage de positionnement lors des transitions de route ; l’animation de conteneur ne transporte plus de `transform`, ce qui rétablit l’ancrage viewport des modales en `position: fixed`.",
+      "**Horloge murale** permanente dans la barre d’outils : fuseau IANA et format 12/24 h des paramètres **Tableau de bord web**, tick chaque seconde ; correctif d’**hydratation** SSR/CSR sur les secondes au premier rendu.",
+      "**Sélecteurs date/heure** : bouton **crochet** pour valider et fermer le calendrier ; préremplissage **début** avec minutes `:00` (bouton **Today** idem) ; **Now** à l’instant exact ; champs de **fin** arrondis à la **demi-heure** suivante (**Today** inclus).",
+      "**Heure de fin planifiée** (tâche ou session) : clignotement doux entre 15 et 5 minutes restantes, puis plus rapide jusqu’à 0.",
+      "**Colonne tâches** : suppression d’une troncature visuelle pendant l’animation d’ouverture ; défilement correct sur les listes longues.",
+      "**Installation desktop / PWA** : priorité **512x512** + rôle `maskable` pour l’icône installée.",
+      "**Jeton `!`** : en parallèle de `@projet`, le libellé de tâche accepte **`!projet`** et les étiquettes sous portée **`!projet#sous-étiquette`** ; le moteur distingue **`personalProject`** sur les tâches et maintient **`knownPersonalProjects`** sur le payload (liste distincte de `knownProjects`).",
+      "**Actions** : `startTask`, `addHistoricalTask`, `updateTask`, `saveTaskTemplate` ; renommage serveur avec **`renameProjectMetadata`** et **`personalOnly`** (pas encore d’inline Paramètres dédié aux listes `!`).",
+      "**UI** : pastilles et suggestions **rose** pour le personnel (`taskFieldStyles`, `TaskFocusPanel`, `TaskSessionLiveCard`, `SavedProjectPicker`, `TagPills`) ; **Gantt** d’une tâche : barres et **totaux séparés** temps productif (`@`) vs personnel (`!`).",
+      "**Rapports** : les grilles « par projet » utilisent par défaut le scope **`work`** (`aggregateProjectTaskMinutesByDay`) — le temps `!` n’y est pas mélangé ; les scopes **`personal`** / **`all`** existent dans `lib/reportingAggregate.ts` pour une future vue UI dédiée.",
+      "**Qualité** : tests unitaires sur les modèles avec projet personnel (`lib/taskTemplateDraft.test.ts`) ; pas de parcours E2E Playwright dédié aux jetons `!` dans cette version.",
+      "**Guide utilisateur** : `lib/userGuideCopy.ts` et `docs/USER_GUIDE.md` (FR/EN) — convention **`#` / `@` / `!`**, rapports (grilles projet `@` sans mélanger `!`), limite actuelle côté Paramètres pour les projets personnels.",
+      "**Implémentation** : `lib/implementationNotes.ts` (user stories et coches intégration/E2E) ; **`docs/IMPLEMENTATION_DETAILS.md`** — section projets personnels et scopes reporting.",
+      "**Changelog usager** : régénération via `npm run changelog:build` (`lib/generatedUserChangelog.ts`).",
+      "**Paquet npm** : version **`1.0.0-beta.19`** ; script **`prepublishOnly`** = `npm run build` avant `npm publish` sur `@nightkatana/kronosys-app`."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.18",
+    "items": [
+      "Nouveautés — Sauvegarde/restauration: ajout de l’API `POST /api/restore` (import `json` ou `sqlite`) avec couverture d’intégration dédiée.",
+      "Nouveautés — User stories in-app: ajout de la page **Implémentation** (`/implementation`) avec inventaire exhaustif ✓/✗, checklist locale « revue » et accès direct au changelog usager.",
+      "Nouveautés — Modèles de tâche: section dédiée dans Paramètres, création depuis une tâche, suggestions « Modèle : » dans la saisie, disponibilité dans la palette **Spotlight**.",
+      "Nouveautés — Vue **Gantt du jour**: modal timeline globale des intervalles de tâches sur les sessions de la journée.",
+      "Nouveautés — Pause globale contextuelle: modal de confirmation enrichie avec résumé détaillé (murale, temps actifs/codage, compteurs tâches/sous-tâches, ventilation minuteurs).",
+      "Nouveautés — Nom de session par défaut: gabarit configurable (`%UUID` + tokens `strftime`) appliqué à la création de session.",
+      "Améliorations — Tableau de bord: en-tête AppShell consolidé (métadonnées de session, placeholder commande, navigation), transitions de route et cohérence inter-pages accrues.",
+      "Améliorations — Reporting: ajout du temps non concurrent par jour, ventilation des sessions par type de clôture, aides métriques et précision accrue des agrégats.",
+      "Améliorations — Sessions/tâches: consolidation des statistiques latérales, gestion des notes et meilleure continuité live/historique.",
+      "Améliorations — Paramètres: évolution des sections Étiquettes/Projets/Modèles et meilleure ergonomie des flux de configuration.",
+      "Qualité — Tests: renforcement substantiel de la couverture (unitaires + intégration + E2E) sur restore API, templates, Gantt, pause globale, agrégats reporting et flux session/tâche.",
+      "Documentation — Guide utilisateur synchronisé pour `beta.18` sur les deux surfaces (`/guide` et `docs/USER_GUIDE.md`), Spotlight harmonisé, page `/implementation` et `docs/IMPLEMENTATION_DETAILS.md` alignés.",
+      "Maintenance — Bump applicatif vers `1.0.0-beta.18` (`package.json`, `package-lock.json`) et régénération du changelog usager (`lib/generatedUserChangelog.ts`)."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.17",
+    "items": [
+      "Nouveautés — Notes libres: ajout d’une **note de tâche** et d’une **note de session** (texte libre) pour documenter le contexte de travail directement sur l’activité concernée.",
+      "Améliorations — Tableau de bord: la note de tâche est affichée **avant** la liste des sous-tâches pour garder le contexte visible pendant la décomposition.",
+      "Améliorations — Sessions et archives: aperçu de note de session (icône + extrait) dans la liste des sessions et dans la liste des sessions archivées.",
+      "Qualité — Tests: ajout de tests unitaires UI pour l’ordre d’affichage note/sous-tâches et la présence de l’aperçu de note en liste de sessions, en plus des tests serveur sur la persistance des notes.",
+      "Documentation — Mise à jour du guide utilisateur (in-app + dépôt) et des détails d’implémentation pour les notes de tâches/sessions.",
+      "Nouveautés — Planification d’heure de fin sur les **tâches en cours** : définir une heure de fin programme l’échéance et met automatiquement le minuteur en pause lorsqu’elle est atteinte.",
+      "Nouveautés — Planification d’heure de fin sur la **session live** : définir une heure de fin agit comme échéance de session et met automatiquement en pause la durée murale à l’instant prévu.",
+      "Améliorations — Tableau de bord : le sélecteur **Fin** est disponible aussi sur tâches/sessions en cours (plus seulement sur les éléments déjà terminés), avec affichage de l’échéance planifiée.",
+      "Qualité — Tests : renforcement de la couverture (dispatch + hydratation minuteurs/session) pour les scénarios planifiés et les cas d’échéance dépassée.",
+      "Documentation — Guide utilisateur et détails d’implémentation mis à jour pour expliciter la différence « fin réelle » vs « fin planifiée (auto-pause) ».",
+      "Nouveautés — Étiquettes et projets : renommage **inline** dans la colonne droite du tableau de bord (édition en place, validation **Entrée**, annulation **Échap**).",
+      "Améliorations — Confirmation de renommage : avertissement explicite sur l’impact reporting + option « ne plus afficher » mémorisée localement.",
+      "Qualité — UX : suppression des ambiguïtés d’actions (pas de bouton de sauvegarde en double pendant le renommage inline)."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.16",
+    "items": [
+      "Nouveautés — Page Implémentation (`/implementation`) avec inventaire exhaustif des user stories (✓ livré · ✗ absent/hors périmètre), checklist locale « revue » et accès direct au changelog usager.",
+      "Nouveautés — Documentation technique d’implémentation ajoutée dans `docs/IMPLEMENTATION_DETAILS.md` (modèle temps session murale vs minuteurs de tâches, pauses, reporting, architecture et maintenance).",
+      "Nouveautés — Modèles de tâche: sauvegarde depuis une tâche, suggestions « Modèle: » dans la saisie, présence dans la palette `Ctrl+K`, gestion dédiée dans Paramètres.",
+      "Nouveautés — Pause globale contextuelle avec modale de confirmation et aperçu détaillé (murale, temps actif/codage, compteurs tâches/sous-tâches, ventilation des minuteurs).",
+      "Nouveautés — Vue Gantt du jour: frise des intervalles de tâches sur l’ensemble des sessions de la journée.",
+      "Nouveautés — Nom de session par défaut avec gabarit configurable (`%UUID` + tokens `strftime`) dans les paramètres.",
+      "Nouveautés — Restauration locale via `POST /api/restore` (`json` ou `sqlite`) en complément de `GET /api/backup`.",
+      "Améliorations — Reporting: ajout du temps non concurrent par jour, ventilation des sessions par type de clôture, métriques d’assiduité quand une heure prévue est fournie.",
+      "Améliorations — Spotlight: la palette de recherche rapide est désormais explicitement nommée « Spotlight » dans l’interface.",
+      "Qualité — Tests: ajout/renforcement des parcours E2E et tests unitaires (implémentation, templates, pause globale, restauration API, agrégats).",
+      "Documentation — Guide utilisateur: mise à jour complète in-app + dépôt, et alignement des chaînes FR/EN (dashboard, reporting, paramètres, licences, implémentation)."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.15",
+    "items": [
+      "Ajout de la commande de version CLI: `kronosys --version` affiche désormais la version installée.",
+      "Ajout des alias `kronosys -v` et `kronosys version` pour afficher la version installée."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.14",
+    "items": [
+      "Ajout de la page **Implémentation** (`/implementation`) avec inventaire exhaustif des user stories livrées ou hors périmètre.",
+      "Ajout des **modèles de tâche** (création depuis une tâche, gestion dans Paramètres, recherche rapide Ctrl+K).",
+      "Ajout d’une **pause globale contextuelle** avec modale de confirmation et aperçu des durées associées.",
+      "Ajout de la vue **Gantt du jour** pour visualiser les intervalles de tâches de la session affichée."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.13",
+    "items": [
+      "Version intermédiaire de stabilisation (pas de nouveauté utilisateur majeure documentée)."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.12",
+    "items": [
+      "Correctif du runtime CLI: installation des dépendances avec `--ignore-scripts` pour éviter les erreurs Husky hors dépôt."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.11",
+    "items": [
+      "Correctif Windows du lanceur CLI (PowerShell + installation runtime locale).",
+      "Rebuild explicite de `better-sqlite3` dans le runtime local."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.10",
+    "items": [
+      "Correctif de dispatch des commandes Windows pour le runtime CLI."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.9",
+    "items": [
+      "Correctif de quoting des commandes Windows dans le lanceur CLI."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.8",
+    "items": [
+      "Correctif initial Windows du launcher (`npm.cmd`/`npx.cmd`)."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.7",
+    "items": [
+      "Stabilisation du packaging bêta et génération des archives de distribution."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.6",
+    "items": [
+      "Correctif de résolution d’alias d’import (`@/...`) pour le build de production."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.5",
+    "items": [
+      "Retour temporaire au mode build à la première exécution pour améliorer la compatibilité multiplateforme."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.4",
+    "items": [
+      "Ajustements de packaging et de lancement CLI pour la série bêta."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.2",
+    "items": [
+      "Correctif des dépendances de build nécessaires au runtime CLI."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.1",
+    "items": [
+      "`kronosys` lance maintenant le build de production automatiquement si `.next` est absent."
+    ]
+  },
+  {
+    "version": "1.0.0-beta.0",
+    "items": [
+      "Première version bêta publiée."
     ]
   },
   {