@nightkatana/kronosys-app 1.0.0-beta.0

package/lib/backupCsvExport.ts

@@ -0,0 +1,392 @@
+import { strToU8, zipSync } from "fflate";
+
+import type { KronosysUpdatePayload } from "@/lib/kronosysApi";
+import { collectTasksDeduped, type LooseSession } from "@/lib/reportingAggregate";
+
+/** Parties CSV téléchargeables (avant effacement complet ou pour archivage). */
+export type CsvBackupTable =
+  | "sessions"
+  | "tasks"
+  | "subtasks"
+  | "tag_project_registry"
+  | "tag_descriptions"
+  | "project_descriptions"
+  | "git_identity"
+  | "store_json_blobs";
+
+export const CSV_BACKUP_TABLES: readonly CsvBackupTable[] = [
+  "sessions",
+  "tasks",
+  "subtasks",
+  "tag_project_registry",
+  "tag_descriptions",
+  "project_descriptions",
+  "git_identity",
+  "store_json_blobs",
+] as const;
+
+export function isCsvBackupTable(s: string): s is CsvBackupTable {
+  return (CSV_BACKUP_TABLES as readonly string[]).includes(s);
+}
+
+export function csvEscapeCell(cell: string): string {
+  if (/[",\n\r]/.test(cell)) {
+    return `"${cell.replace(/"/g, '""')}"`;
+  }
+  return cell;
+}
+
+function csvLine(cells: string[]): string {
+  return cells.map(csvEscapeCell).join(",");
+}
+
+function asSessionRecord(raw: unknown): Record<string, unknown> | null {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+    return null;
+  }
+  const o = raw as Record<string, unknown>;
+  return typeof o.sessionId === "string" && o.sessionId.trim() !== "" ? o : null;
+}
+
+type SessionWalk = {
+  session: Record<string, unknown>;
+  /** Emplacement dans le payload (la session courante peut être `archived: true`). */
+  source: "history" | "historyArchived" | "current";
+  /** Indique si la session est dans la liste archives ou marquée archivée en direct. */
+  archivedList: boolean;
+};
+
+function historyList(payload: KronosysUpdatePayload): unknown[] {
+  return Array.isArray(payload.history) ? payload.history : [];
+}
+
+function historyArchivedList(payload: KronosysUpdatePayload): unknown[] {
+  return Array.isArray(payload.historyArchived) ? payload.historyArchived : [];
+}
+
+function* walkSessions(payload: KronosysUpdatePayload): Generator<SessionWalk> {
+  for (const h of historyList(payload)) {
+    const s = asSessionRecord(h);
+    if (s) {
+      yield { session: s, source: "history", archivedList: false };
+    }
+  }
+  for (const h of historyArchivedList(payload)) {
+    const s = asSessionRecord(h);
+    if (s) {
+      yield { session: s, source: "historyArchived", archivedList: true };
+    }
+  }
+  const cur = asSessionRecord(payload.current);
+  if (cur) {
+    yield {
+      session: cur,
+      source: "current",
+      archivedList: cur.archived === true,
+    };
+  }
+}
+
+function taskCountDeduped(sess: LooseSession): number {
+  return collectTasksDeduped(sess).length;
+}
+
+function jsonCell(v: unknown): string {
+  return csvEscapeCell(JSON.stringify(v ?? null));
+}
+
+export function buildSessionsBackupCsv(payload: KronosysUpdatePayload): string {
+  const headers = [
+    "sessionId",
+    "sessionName",
+    "startAt",
+    "scheduledStartAt",
+    "sessionStartOffsetMinutes",
+    "endAt",
+    "savedAt",
+    "archived",
+    "sessionSource",
+    "sessionDurationMinutes",
+    "sessionEndReasonKind",
+    "sessionEndReasonNote",
+    "codingMinutesSession",
+    "activeMinutes",
+    "linesWrittenTotal",
+    "linesWrittenHuman",
+    "linesWrittenAi",
+    "mongoPushedAt",
+    "mongoLastPushedSavedAt",
+    "kronoFocusSessionsCompleted",
+    "taskCountDeduped",
+    "locByLanguageJson",
+    "sessionJson",
+  ];
+  const lines = [csvLine(headers)];
+  for (const { session: h, source, archivedList } of walkSessions(payload)) {
+    const sess = h as LooseSession;
+    const kf = h.kronoFocus as Record<string, unknown> | undefined;
+    const kfDone = typeof kf?.sessionsCompleted === "number" ? kf.sessionsCompleted : "";
+    lines.push(
+      csvLine([
+        String(h.sessionId ?? ""),
+        String(h.sessionName ?? ""),
+        String(h.startAt ?? ""),
+        String(h.scheduledStartAt ?? ""),
+        typeof h.sessionStartOffsetMinutes === "number" && Number.isFinite(h.sessionStartOffsetMinutes)
+          ? String(h.sessionStartOffsetMinutes)
+          : "",
+        String(h.endAt ?? ""),
+        String(h.savedAt ?? ""),
+        archivedList ? "yes" : "no",
+        source,
+        typeof h.sessionDurationMinutes === "number" && Number.isFinite(h.sessionDurationMinutes)
+          ? String(h.sessionDurationMinutes)
+          : "",
+        String(h.sessionEndReasonKind ?? ""),
+        String(h.sessionEndReasonNote ?? ""),
+        typeof h.codingMinutesSession === "number" && Number.isFinite(h.codingMinutesSession)
+          ? String(h.codingMinutesSession)
+          : "",
+        typeof h.activeMinutes === "number" && Number.isFinite(h.activeMinutes) ? String(h.activeMinutes) : "",
+        typeof h.linesWrittenTotal === "number" && Number.isFinite(h.linesWrittenTotal)
+          ? String(h.linesWrittenTotal)
+          : "",
+        typeof h.linesWrittenHuman === "number" && Number.isFinite(h.linesWrittenHuman)
+          ? String(h.linesWrittenHuman)
+          : "",
+        typeof h.linesWrittenAi === "number" && Number.isFinite(h.linesWrittenAi) ? String(h.linesWrittenAi) : "",
+        String(h.mongoPushedAt ?? ""),
+        String(h.mongoLastPushedSavedAt ?? ""),
+        String(kfDone),
+        String(taskCountDeduped(sess)),
+        JSON.stringify(h.locByLanguage ?? null),
+        JSON.stringify(h),
+      ])
+    );
+  }
+  return lines.join("\n");
+}
+
+export function buildTasksBackupCsv(payload: KronosysUpdatePayload): string {
+  const headers = [
+    "sessionId",
+    "sessionSource",
+    "sessionArchived",
+    "taskId",
+    "name",
+    "project",
+    "tagsJson",
+    "isDone",
+    "durationMs",
+    "startTime",
+    "endTime",
+    "manualTaskTimerPaused",
+    "shouldCommit",
+    "usedKronoFocus",
+    "kronoFocusCycles",
+    "activeSubtaskTimerId",
+    "taskJson",
+  ];
+  const lines = [csvLine(headers)];
+  for (const { session: h, source, archivedList } of walkSessions(payload)) {
+    const sess = h as LooseSession;
+    for (const t of collectTasksDeduped(sess)) {
+      const tr = t as Record<string, unknown>;
+      lines.push(
+        csvLine([
+          String(h.sessionId ?? ""),
+          source,
+          archivedList ? "yes" : "no",
+          String(tr.id ?? ""),
+          String(tr.name ?? ""),
+          tr.project === null || tr.project === undefined ? "" : String(tr.project),
+          JSON.stringify(tr.tags ?? []),
+          tr.isDone === true ? "yes" : tr.isDone === false ? "no" : "",
+          typeof tr.durationMs === "number" && Number.isFinite(tr.durationMs) ? String(tr.durationMs) : "",
+          String(tr.startTime ?? ""),
+          String(tr.endTime ?? ""),
+          tr.manualTaskTimerPaused === true ? "yes" : tr.manualTaskTimerPaused === false ? "no" : "",
+          tr.shouldCommit === true ? "yes" : tr.shouldCommit === false ? "no" : "",
+          tr.usedKronoFocus === true ? "yes" : tr.usedKronoFocus === false ? "no" : "",
+          typeof tr.kronoFocusCycles === "number" && Number.isFinite(tr.kronoFocusCycles)
+            ? String(tr.kronoFocusCycles)
+            : "",
+          String(tr.activeSubtaskTimerId ?? ""),
+          JSON.stringify(tr),
+        ])
+      );
+    }
+  }
+  return lines.join("\n");
+}
+
+export function buildSubtasksBackupCsv(payload: KronosysUpdatePayload): string {
+  const headers = [
+    "sessionId",
+    "sessionSource",
+    "sessionArchived",
+    "parentTaskId",
+    "subtaskId",
+    "title",
+    "done",
+    "durationMs",
+    "subtaskJson",
+  ];
+  const lines = [csvLine(headers)];
+  for (const { session: h, source, archivedList } of walkSessions(payload)) {
+    const sess = h as LooseSession;
+    for (const t of collectTasksDeduped(sess)) {
+      const tr = t as Record<string, unknown>;
+      const tid = String(tr.id ?? "");
+      const subs = Array.isArray(tr.subtasks) ? tr.subtasks : [];
+      for (const raw of subs) {
+        if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+          continue;
+        }
+        const st = raw as Record<string, unknown>;
+        lines.push(
+          csvLine([
+            String(h.sessionId ?? ""),
+            source,
+            archivedList ? "yes" : "no",
+            tid,
+            String(st.id ?? ""),
+            String(st.title ?? st.name ?? ""),
+            st.done === true ? "yes" : st.done === false ? "no" : "",
+            typeof st.durationMs === "number" && Number.isFinite(st.durationMs) ? String(st.durationMs) : "",
+            JSON.stringify(st),
+          ])
+        );
+      }
+    }
+  }
+  return lines.join("\n");
+}
+
+export function buildTagProjectRegistryCsv(payload: KronosysUpdatePayload): string {
+  const headers = ["listKind", "value"];
+  const lines = [csvLine(headers)];
+  const push = (listKind: string, value: string) => {
+    const v = value.trim();
+    if (v) {
+      lines.push(csvLine([listKind, v]));
+    }
+  };
+  for (const t of payload.knownTags || []) {
+    push("known_tag", String(t));
+  }
+  for (const p of payload.knownProjects || []) {
+    push("known_project", String(p));
+  }
+  for (const t of payload.userKnownTags || []) {
+    push("user_known_tag", String(t));
+  }
+  for (const t of payload.excludedSuggestionTags || []) {
+    push("excluded_suggestion_tag", String(t));
+  }
+  return lines.join("\n");
+}
+
+export function buildTagDescriptionsCsv(payload: KronosysUpdatePayload): string {
+  const headers = ["tagKey", "description"];
+  const lines = [csvLine(headers)];
+  const td = payload.tagDescriptions;
+  if (td && typeof td === "object") {
+    for (const [k, v] of Object.entries(td)) {
+      if (typeof v === "string") {
+        lines.push(csvLine([k, v]));
+      }
+    }
+  }
+  return lines.join("\n");
+}
+
+export function buildProjectDescriptionsCsv(payload: KronosysUpdatePayload): string {
+  const headers = ["projectKey", "description"];
+  const lines = [csvLine(headers)];
+  const pd = payload.projectDescriptions;
+  if (pd && typeof pd === "object") {
+    for (const [k, v] of Object.entries(pd)) {
+      if (typeof v === "string") {
+        lines.push(csvLine([k, v]));
+      }
+    }
+  }
+  return lines.join("\n");
+}
+
+export function buildGitIdentityCsv(payload: KronosysUpdatePayload): string {
+  const headers = ["gitUserName", "gitUserEmail", "gitAccountLogin"];
+  const g = payload.gitIdentity;
+  const row =
+    g && typeof g === "object"
+      ? [
+          String(g.gitUserName ?? ""),
+          String(g.gitUserEmail ?? ""),
+          String(g.gitAccountLogin ?? ""),
+        ]
+      : ["", "", ""];
+  return [csvLine(headers), csvLine(row)].join("\n");
+}
+
+export function buildStoreJsonBlobsCsv(payload: KronosysUpdatePayload): string {
+  const headers = ["blobKind", "json"];
+  const lines = [csvLine(headers)];
+  const push = (kind: string, data: unknown) => {
+    lines.push(csvLine([kind, JSON.stringify(data ?? null)]));
+  };
+  push("cfg", payload.cfg ?? null);
+  push("gitStats", payload.gitStats ?? null);
+  push("workspaceCodeSnapshot", payload.workspaceCodeSnapshot ?? null);
+  push(
+    "dashboardTopLevel",
+    {
+      inspectingSessionId: payload.inspectingSessionId ?? null,
+      dismissArchiveSessionConfirm: payload.dismissArchiveSessionConfirm ?? null,
+      dashboardDataOrigin: payload.dashboardDataOrigin ?? null,
+      viewType: payload.viewType ?? null,
+      workspaceFolderPaths: payload.workspaceFolderPaths ?? null,
+    }
+  );
+  return lines.join("\n");
+}
+
+export function buildCsvBackupPart(table: CsvBackupTable, payload: KronosysUpdatePayload): string {
+  switch (table) {
+    case "sessions":
+      return buildSessionsBackupCsv(payload);
+    case "tasks":
+      return buildTasksBackupCsv(payload);
+    case "subtasks":
+      return buildSubtasksBackupCsv(payload);
+    case "tag_project_registry":
+      return buildTagProjectRegistryCsv(payload);
+    case "tag_descriptions":
+      return buildTagDescriptionsCsv(payload);
+    case "project_descriptions":
+      return buildProjectDescriptionsCsv(payload);
+    case "git_identity":
+      return buildGitIdentityCsv(payload);
+    case "store_json_blobs":
+      return buildStoreJsonBlobsCsv(payload);
+    default:
+      throw new Error(`unknown CSV table: ${String(table)}`);
+  }
+}
+
+export function csvBackupFilename(table: CsvBackupTable, stamp: string): string {
+  return `kronosys-${table}-${stamp}.csv`;
+}
+
+/** Archive ZIP contenant les huit exportations CSV (UTF-8), pour un seul téléchargement. */
+export function buildCsvBackupZipSync(payload: KronosysUpdatePayload, stamp: string): Uint8Array {
+  const files: Record<string, Uint8Array> = {};
+  for (const table of CSV_BACKUP_TABLES) {
+    files[csvBackupFilename(table, stamp)] = strToU8(buildCsvBackupPart(table, payload), false);
+  }
+  return zipSync(files, { level: 6 });
+}
+
+export function csvBackupZipFilename(stamp: string): string {
+  return `kronosys-csv-backup-${stamp}.zip`;
+}

package/lib/changelogCopy.ts

@@ -0,0 +1,34 @@
+import type { Lang } from "@/lib/dashboardCopy";
+import { USER_CHANGELOG_ENTRIES } from "@/lib/generatedUserChangelog";
+
+type ChangelogEntry = {
+  version: string;
+  items: string[];
+};
+
+export type ChangelogBundle = {
+  title: string;
+  subtitle: string;
+  empty: string;
+  entries: ChangelogEntry[];
+};
+
+const enBundle: ChangelogBundle = {
+  title: "User CHANGELOG",
+  subtitle:
+    "This page lists user-visible changes after each software update.",
+  empty: "No changelog entry is available yet.",
+  entries: USER_CHANGELOG_ENTRIES,
+};
+
+const frBundle: ChangelogBundle = {
+  title: "CHANGELOG usager",
+  subtitle:
+    "Cette page liste les changements visibles côté utilisateur après chaque mise à jour du logiciel.",
+  empty: "Aucune entrée de changelog n’est encore disponible.",
+  entries: USER_CHANGELOG_ENTRIES,
+};
+
+export function changelogBundle(lang: Lang): ChangelogBundle {
+  return lang === "fr" ? frBundle : enBundle;
+}

package/lib/concurrentTaskStartPreference.ts

@@ -0,0 +1,29 @@
+const STORAGE_KEY = "kronosys.concurrentTaskStartPreference";
+
+export type ConcurrentTaskStartPreference = "pause" | "finish" | "parallel";
+
+export function readConcurrentTaskStartPreference(): ConcurrentTaskStartPreference | null {
+  if (typeof window === "undefined") {
+    return null;
+  }
+  try {
+    const v = window.localStorage.getItem(STORAGE_KEY);
+    if (v === "pause" || v === "finish" || v === "parallel") {
+      return v;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+export function writeConcurrentTaskStartPreference(mode: ConcurrentTaskStartPreference): void {
+  if (typeof window === "undefined") {
+    return;
+  }
+  try {
+    window.localStorage.setItem(STORAGE_KEY, mode);
+  } catch {
+    // quota / private mode
+  }
+}

package/lib/dashboardClockFormat.ts

@@ -0,0 +1,13 @@
+const CFG_KEY = "dashboardUse24HourClock";
+
+/** `true` : affichage sur 24 h ; `false` : horloge 12 h (AM/PM). Défaut : 24 h. */
+export function readDashboardUse24HourClockFromCfg(cfg: Record<string, unknown> | undefined): boolean {
+  const v = cfg?.[CFG_KEY];
+  if (v === false) {
+    return false;
+  }
+  if (v === true) {
+    return true;
+  }
+  return true;
+}

package/lib/dashboardColumnChrome.ts

@@ -0,0 +1,3 @@
+/** Rangée des titres de colonnes (Sessions / Tâches / Étiquettes) : hauteur et alignement homogènes. */
+export const dashboardColumnTitleRowClassName =
+  "flex min-h-[2.75rem] flex-wrap items-center gap-x-2 gap-y-1.5";

package/lib/dashboardColumnHintsStorage.ts

@@ -0,0 +1,57 @@
+/** L’utilisateur a replié l’aide des colonnes du tableau de bord (ne plus l’afficher par défaut). */
+export const DASHBOARD_COLUMN_HINTS_CLOSED_KEY = "kronosys.dashboard.columnHints.closed.v1";
+
+/** L’utilisateur a masqué tout le bandeau d’aide (ne plus l’afficher du tout). */
+export const DASHBOARD_COLUMN_HINTS_DISMISSED_KEY = "kronosys.dashboard.columnHints.dismissed.v1";
+
+export function readDashboardColumnHintsClosed(): boolean {
+  if (typeof window === "undefined") {
+    return false;
+  }
+  try {
+    return window.localStorage.getItem(DASHBOARD_COLUMN_HINTS_CLOSED_KEY) === "1";
+  } catch {
+    return false;
+  }
+}
+
+export function writeDashboardColumnHintsClosed(closed: boolean): void {
+  if (typeof window === "undefined") {
+    return;
+  }
+  try {
+    if (closed) {
+      window.localStorage.setItem(DASHBOARD_COLUMN_HINTS_CLOSED_KEY, "1");
+    } else {
+      window.localStorage.removeItem(DASHBOARD_COLUMN_HINTS_CLOSED_KEY);
+    }
+  } catch {
+    /* ignore */
+  }
+}
+
+export function readDashboardColumnHintsDismissed(): boolean {
+  if (typeof window === "undefined") {
+    return false;
+  }
+  try {
+    return window.localStorage.getItem(DASHBOARD_COLUMN_HINTS_DISMISSED_KEY) === "1";
+  } catch {
+    return false;
+  }
+}
+
+export function writeDashboardColumnHintsDismissed(dismissed: boolean): void {
+  if (typeof window === "undefined") {
+    return;
+  }
+  try {
+    if (dismissed) {
+      window.localStorage.setItem(DASHBOARD_COLUMN_HINTS_DISMISSED_KEY, "1");
+    } else {
+      window.localStorage.removeItem(DASHBOARD_COLUMN_HINTS_DISMISSED_KEY);
+    }
+  } catch {
+    /* ignore */
+  }
+}