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

package/README.md

@@ -99,7 +99,7 @@ Sinon : `NODE_EXTRA_CA_CERTS` pointant vers le PEM racine de l’organisation, o
 
 ## Publication npm (`@nightkatana/kronosys-app`)
 
-La version est définie dans `package.json` (référence actuelle : **`1.0.0-beta.20`**). Avant la première publication : créer le scope **@nightkatana** sur [npmjs.com](https://www.npmjs.com/) si besoin, puis `npm login`. Depuis ce dossier :
+La version est définie dans `package.json` (référence actuelle : **`1.0.0-beta.21`**). Avant la première publication : créer le scope **@nightkatana** sur [npmjs.com](https://www.npmjs.com/) si besoin, puis `npm login`. Depuis ce dossier :
 
 ```bash
 npm publish --access public

package/lib/generatedUserChangelog.ts

@@ -5,6 +5,18 @@ export type UserChangelogEntry = {
 };
 
 export const USER_CHANGELOG_ENTRIES: UserChangelogEntry[] = [
+  {
+    "version": "1.0.0-beta.21",
+    "items": [
+      "**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": "1.0.0-beta.20",
     "items": [

package/lib/implementationNotes.ts

@@ -55,7 +55,7 @@ const frBundle: ImplementationNotesBundle = {
     "Liste exhaustive des intentions utilisateur·rice·s : chaque ligne indique si la capacité est livrée (✓) ou absente / hors périmètre (✗). Les cases à droite servent à cocher une ligne « revue » sur cet appareil — le détail technique long reste dans le dépôt.",
   statusKeyLine:
     "✓ vert = implémenté dans le produit · ✗ rouge = non livré ou volontairement exclu.",
-  lastUpdated: "Dernière mise à jour : 2026-05-12 (v1.0.0-beta.20)",
+  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",
@@ -92,7 +92,7 @@ const frBundle: ImplementationNotesBundle = {
         },
         {
           implemented: true,
-          text: "Pour une livraison donnée (p. ex. 1.0.0-beta.20), valider le comportement en croisant la section correspondante du **CHANGELOG**, les récits marqués livrés sur cette page et `docs/IMPLEMENTATION_DETAILS.md`, puis cocher au besoin **intégration** / **E2E**.",
+          text: "Pour une livraison donnée (p. ex. 1.0.0-beta.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,
@@ -340,7 +340,7 @@ const frBundle: ImplementationNotesBundle = {
           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. Les suggestions (modèles, historique) complètent la saisie.",
+            "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.",
         },
@@ -360,7 +360,7 @@ const frBundle: ImplementationNotesBundle = {
           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.",
+            "`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 `!`.",
         },
@@ -622,7 +622,7 @@ const enBundle: ImplementationNotesBundle = {
     "An exhaustive list of user intentions: each row shows whether the capability is shipped (✓) or missing / out of scope (✗). Checkboxes on the right mark a row as reviewed on this device — long technical detail stays in the repo doc.",
   statusKeyLine:
     "Green ✓ = implemented in the product · Red ✗ = not shipped or intentionally excluded.",
-  lastUpdated: "Last updated: 2026-05-12 (v1.0.0-beta.20)",
+  lastUpdated: "Last updated: 2026-05-12 (v1.0.0-beta.21)",
   repositoryDocLabel: "Repository document: docs/IMPLEMENTATION_DETAILS.md",
   storyGroupsHeading: "User story inventory",
   implementationColumnLabel: "Implementation",
@@ -659,7 +659,7 @@ const enBundle: ImplementationNotesBundle = {
         },
         {
           implemented: true,
-          text: "For a given release (e.g. 1.0.0-beta.20), cross-check the matching **CHANGELOG** section, the shipped stories on this page and `docs/IMPLEMENTATION_DETAILS.md`, then tick **Integration** / **E2E** as appropriate.",
+          text: "For a given release (e.g. 1.0.0-beta.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,
@@ -907,7 +907,7 @@ const enBundle: ImplementationNotesBundle = {
           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. Templates and suggestions complement typing.",
+            "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.",
         },
@@ -927,7 +927,7 @@ const enBundle: ImplementationNotesBundle = {
           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.",
+            "`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.",
         },

package/lib/taskParsing.ts

@@ -22,31 +22,59 @@ type ProjectTokenMatch = {
 
 /**
  * Repère les jetons `@projet`, `!projet`, `@p#t` et `!p#t` (ordre d’apparition dans la chaîne).
+ *
+ * - `@` : uniquement après début de chaîne ou un espace (évite `courriel@domaine`).
+ * - `!` : idem **ou** collé au caractère précédent (comme les `#tags`), ex. `Courrier!perso#dentiste`.
  */
 export function findProjectTokens(raw: string): ProjectTokenMatch[] {
   const norm = raw.replace(/\s+/g, " ").trim();
-  const re = /(?:^|\s)([@!])([^\s@!#]+)(?:#([^\s#]+))?/g;
-  const out: ProjectTokenMatch[] = [];
-  let m: RegExpExecArray | null;
-  while ((m = re.exec(norm)) !== null) {
-    const sigil = m[1] as "@" | "!";
-    const projRaw = (m[2] || "").trim();
-    const locRaw = m[3];
-    const full = m[0];
-    const start = m.index;
-    const end = start + full.length;
-    if (!projRaw) {
-      continue;
+  /** Jetons `@` / `!` précédés d’une frontière « début ou espace ». */
+  const reBoundary = /(?:^|\s)([@!])([^\s@!#]+)(?:#([^\s#]+))?/g;
+  /** `!` seul : autorisé après un caractère non blanc, non `!`, non `#` (aligné sur les `#tags` collés). */
+  const reBangGlued = /(?<=[^\s!#])(!)([^\s@!#]+)(?:#([^\s#]+))?/g;
+
+  const pushMatch = (
+    out: ProjectTokenMatch[],
+    sigil: "@" | "!",
+    projRaw: string,
+    locRaw: string | undefined,
+    start: number,
+    fullLen: number,
+  ) => {
+    const end = start + fullLen;
+    const proj = projRaw.trim();
+    if (!proj) {
+      return;
     }
     if (locRaw !== undefined && locRaw.length > 0) {
       const loc = locRaw.trim();
       if (!loc || loc.includes("#")) {
-        continue;
+        return;
       }
-      out.push({ start, end, plain: false, sigil, projRaw, loc });
-    } else if (!projRaw.includes("#")) {
-      out.push({ start, end, plain: true, sigil, projRaw });
+      out.push({ start, end, plain: false, sigil, projRaw: proj, loc });
+    } else if (!proj.includes("#")) {
+      out.push({ start, end, plain: true, sigil, projRaw: proj });
+    }
+  };
+
+  const buf: ProjectTokenMatch[] = [];
+  let m: RegExpExecArray | null;
+  while ((m = reBoundary.exec(norm)) !== null) {
+    pushMatch(buf, m[1] as "@" | "!", m[2], m[3], m.index, m[0].length);
+  }
+  while ((m = reBangGlued.exec(norm)) !== null) {
+    pushMatch(buf, "!", m[2], m[3], m.index, m[0].length);
+  }
+
+  buf.sort((a, b) => a.start - b.start || b.end - a.end);
+  const out: ProjectTokenMatch[] = [];
+  let lastEnd = -1;
+  for (const t of buf) {
+    if (t.start < lastEnd) {
+      continue;
     }
+    out.push(t);
+    lastEnd = t.end;
   }
   return out;
 }

package/lib/userGuideCopy.ts

@@ -130,9 +130,9 @@ function frBundle(): UserGuideBundle {
         id: "ug-sessions-tasks",
         title: "Sessions, tâches, étiquettes et projets",
         searchIndex:
-          "session live archiver terminer tâche minuteur pause sous-tâche historique liste résumé planifiée pastille badge conflit navigation projet personnel !perso",
+          "session live archiver terminer tâche minuteur pause sous-tâche historique liste résumé planifiée pastille badge conflit navigation projet personnel !perso jeton collé courriel",
         paragraphs: [
-          "La **session** est le **sac** où vient s’additionner le travail sur une période ; la **tâche** est le fil conducteur du moment. **#mot** = thème ; **@nom** = projet **productif** ; **!nom** = projet **personnel** (suivi hors travail facturable, pastille souvent **rose**) — c’est de la **classification**, pas un examen d’orthographe.",
+          "La **session** est le **sac** où vient s’additionner le travail sur une période ; la **tâche** est le fil conducteur du moment. **#mot** = thème ; **@nom** = projet **productif** ; **!nom** = projet **personnel** (suivi hors travail facturable, pastille souvent **rose**) — c’est de la **classification**, pas un examen d’orthographe. Le **`!`** (y compris **`!projet#sous-étiquette`**) peut être **collé** au mot précédent **sans espace** — ex. `Courrier!perso#dentiste` ; le **`@`** reste en principe **après un espace** ou en **début** de segment pour limiter les faux positifs sur les courriels.",
         ],
         optionsTitle: "Nouvelle session — le cadre, au choix",
         options: [
@@ -366,9 +366,9 @@ function enBundle(): UserGuideBundle {
         id: "ug-sessions-tasks",
         title: "Sessions, tasks, tags, and projects",
         searchIndex:
-          "session archive end task timer pause subtask history list summary planned badge chip conflict navigation personal project",
+          "session archive end task timer pause subtask history list summary planned badge chip conflict navigation personal project glued bang email",
         paragraphs: [
-          "A **session** is the **bag** work piles into; a **task** is the **thread** of a moment. **#** tags themes; **@** marks a **work** project; **!** marks a **personal** project (often a **rose** chip) — naming helpers, not a grammar test.",
+          "A **session** is the **bag** work piles into; a **task** is the **thread** of a moment. **#** tags themes; **@** marks a **work** project; **!** marks a **personal** project (often a **rose** chip) — naming helpers, not a grammar test. **`!`** (including **`!project#subtag`**) may be **glued** to the previous word with **no space** — e.g. `Errands!personal#dentist`; **`@`** still expects **whitespace before** or **start of field** so emails like `user@host` are not parsed as projects.",
         ],
         optionsTitle: "New session — the frame, your choice",
         options: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nightkatana/kronosys-app",
-  "version": "1.0.0-beta.20",
+  "version": "1.0.0-beta.21",
   "description": "Kronosys — application Next.js (UI + API + SQLite).",
   "license": "MIT",
   "author": "nightkatana",