living-ai-documentation 1.3.0 → 1.6.0

package/dist/src/frontend/documents.js

@@ -60,6 +60,10 @@ function _wireDocContent(html) {
     wrapper.appendChild(t);
   });
 
+  if (typeof initInlineSnippetEditing === "function") {
+    initInlineSnippetEditing(contentEl);
+  }
+
   const notice = document.getElementById("search-notice");
   const isMetaQuery =
     typeof searchQuery === "string" &&
@@ -429,6 +433,44 @@ async function confirmDeleteDocument() {
 }
 
 // ── Save (in-place edit) ─────────────────────────────────────────────────────
+async function saveCurrentDocumentContent(content) {
+  if (!currentDocId) return;
+  const res = await fetch("/api/documents/" + currentDocId, {
+    method: "PUT",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ content }),
+  });
+  if (!res.ok) throw new Error(await res.text());
+
+  currentDocContent = content;
+
+  // Re-fetch rendered HTML and update view
+  const doc = await fetch("/api/documents/" + currentDocId).then((r) =>
+    r.json(),
+  );
+  _lastDocHtml = doc.html;
+  _lastDocIdRendered = currentDocId;
+  _wireDocContent(doc.html);
+
+  if (typeof applyAnnotationHighlights === "function") {
+    applyAnnotationHighlights();
+  }
+  if (typeof renderElevator === "function") renderElevator();
+
+  const fileLinkMatches = content.match(/\]\(\s*\.?\/files\/[^)\s]+/g);
+  const fileLinkCount = fileLinkMatches ? fileLinkMatches.length : 0;
+  if (fileLinkCount > 0) fileAttachmentCounts[currentDocId] = fileLinkCount;
+  else delete fileAttachmentCounts[currentDocId];
+  refreshSidebar();
+
+  if (typeof updateValidateButtonForCurrentDoc === "function") {
+    updateValidateButtonForCurrentDoc();
+  }
+  if (typeof loadMetadataReport === "function") {
+    loadMetadataReport(currentDocId);
+  }
+}
+
 async function saveDocument() {
   if (!currentDocId) return;
   const content = document.getElementById("doc-editor").value;
@@ -437,31 +479,7 @@ async function saveDocument() {
   msgEl.className = "text-xs text-gray-400";
 
   try {
-    const res = await fetch("/api/documents/" + currentDocId, {
-      method: "PUT",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ content }),
-    });
-    if (!res.ok) throw new Error(await res.text());
-
-    currentDocContent = content;
-
-    // Re-fetch rendered HTML and update view
-    const doc = await fetch("/api/documents/" + currentDocId).then((r) =>
-      r.json(),
-    );
-    _lastDocHtml = doc.html;
-    _lastDocIdRendered = currentDocId;
-    _wireDocContent(doc.html);
-
-    applyAnnotationHighlights();
-    renderElevator();
-
-    const fileLinkMatches = content.match(/\]\(\s*\.?\/files\/[^)\s]+/g);
-    const fileLinkCount = fileLinkMatches ? fileLinkMatches.length : 0;
-    if (fileLinkCount > 0) fileAttachmentCounts[currentDocId] = fileLinkCount;
-    else delete fileAttachmentCounts[currentDocId];
-    refreshSidebar();
+    await saveCurrentDocumentContent(content);
 
     exitEditMode();
   } catch (err) {

package/dist/src/frontend/i18n/en.json

@@ -70,6 +70,7 @@
   "doc.validate_btn": "Validate",
   "doc.validate_title": "Validate this document?",
   "doc.validate_message": "The frontmatter status will change from \"To be validated\" to \"Accepted\".",
+  "doc.validate_worklog_message": "The frontmatter status will change from \"To be validated\" to \"Done\".",
   "doc.validate_detail_low_accuracy": "Reliability is currently {accuracy}. Confirming will also re-baseline source-file hashes, bringing reliability back to 100%.",
   "doc.validate_confirm": "Validate",
   "doc.validate_failed": "Validation failed: ",
@@ -282,8 +283,16 @@
   "snippet.link_anchor_select_hint": "(pick a heading from the document)",
   "snippet.link_anchor_no_headings": "No headings detected in this document",
   "snippet.link_target_doc_label": "Target document",
+  "snippet.ordered_list_content_label": "Items",
+  "snippet.ordered_list_content_placeholder": "One item per line…",
+  "snippet.unordered_list_content_label": "Items",
+  "snippet.unordered_list_content_placeholder": "One item per line…",
   "snippet.code_lang_label": "Language",
   "snippet.code_lang_hint": "(e.g. javascript, python, bash…)",
+  "snippet.code_content_label": "Code",
+  "snippet.code_content_placeholder": "Paste or edit code here…",
+  "snippet.blockquote_content_label": "Quote",
+  "snippet.blockquote_content_placeholder": "Quote text…",
   "snippet.image_alt_label": "Alt text",
   "snippet.image_alt_placeholder": "Image description",
   "snippet.image_url_label": "Image URL",
@@ -295,6 +304,16 @@
   "snippet.tree_add_btn": "+ Add item",
   "snippet.markdown_preview_label": "Markdown preview",
   "snippet.insert_btn": "Insert",
+  "snippet.inline_edit_btn": "Edit inline",
+  "snippet.inline_modal_title": "Edit inline snippet",
+  "snippet.inline_save_btn": "Save",
+  "snippet.inline_save_failed": "Inline edit failed: ",
+  "snippet.inline_delete_btn": "Delete block",
+  "snippet.inline_delete_title": "Delete block",
+  "snippet.inline_delete_message": "Delete this block from the document?",
+  "snippet.inline_delete_detail": "This action will remove the selected Markdown block.",
+  "snippet.inline_delete_confirm_btn": "Delete",
+  "snippet.inline_delete_failed": "Inline block deletion failed: ",
   "snippet.diagram_existing": "Existing diagram",
   "snippet.diagram_new": "New diagram",
   "snippet.diagram_select_label": "Select diagram",

package/dist/src/frontend/i18n/fr.json

@@ -70,6 +70,7 @@
   "doc.validate_btn": "Valider",
   "doc.validate_title": "Valider ce document ?",
   "doc.validate_message": "Le statut frontmatter va passer de « To be validated » à « Accepted ».",
+  "doc.validate_worklog_message": "Le statut frontmatter va passer de « To be validated » à « Done ».",
   "doc.validate_detail_low_accuracy": "La fiabilité actuelle est de {accuracy}. Confirmer va aussi réinitialiser les hashes des fichiers source, ramenant la fiabilité à 100 %.",
   "doc.validate_confirm": "Valider",
   "doc.validate_failed": "Échec de la validation : ",
@@ -282,8 +283,16 @@
   "snippet.link_anchor_select_hint": "(choisissez un titre du document)",
   "snippet.link_anchor_no_headings": "Aucun titre détecté dans ce document",
   "snippet.link_target_doc_label": "Document cible",
+  "snippet.ordered_list_content_label": "Éléments",
+  "snippet.ordered_list_content_placeholder": "Un élément par ligne…",
+  "snippet.unordered_list_content_label": "Éléments",
+  "snippet.unordered_list_content_placeholder": "Un élément par ligne…",
   "snippet.code_lang_label": "Langage",
   "snippet.code_lang_hint": "(ex : javascript, python, bash…)",
+  "snippet.code_content_label": "Code",
+  "snippet.code_content_placeholder": "Collez ou modifiez le code ici…",
+  "snippet.blockquote_content_label": "Citation",
+  "snippet.blockquote_content_placeholder": "Texte de la citation…",
   "snippet.image_alt_label": "Texte alternatif",
   "snippet.image_alt_placeholder": "Description de l'image",
   "snippet.image_url_label": "URL de l'image",
@@ -295,6 +304,16 @@
   "snippet.tree_add_btn": "+ Ajouter un élément",
   "snippet.markdown_preview_label": "Aperçu du markdown",
   "snippet.insert_btn": "Insérer",
+  "snippet.inline_edit_btn": "Édition inline",
+  "snippet.inline_modal_title": "Modifier le snippet inline",
+  "snippet.inline_save_btn": "Enregistrer",
+  "snippet.inline_save_failed": "Échec de l'édition inline : ",
+  "snippet.inline_delete_btn": "Supprimer le bloc",
+  "snippet.inline_delete_title": "Supprimer le bloc",
+  "snippet.inline_delete_message": "Supprimer ce bloc du document ?",
+  "snippet.inline_delete_detail": "Cette action retirera le bloc Markdown sélectionné.",
+  "snippet.inline_delete_confirm_btn": "Supprimer",
+  "snippet.inline_delete_failed": "Échec de la suppression inline : ",
   "snippet.diagram_existing": "Diagramme existant",
   "snippet.diagram_new": "Nouveau diagramme",
   "snippet.diagram_select_label": "Sélectionner un diagramme",

package/dist/src/frontend/index.html

@@ -48,6 +48,7 @@
     <script defer src="/documents.js"></script>
     <script defer src="/misc.js"></script>
     <script defer src="/snippets.js"></script>
+    <script defer src="/inline-snippet-edit.js"></script>
     <script defer src="/annotations.js"></script>
     <script defer src="/metadata.js"></script>
     <script defer src="/accuracy-gauge.js"></script>
@@ -1425,12 +1426,13 @@
     <div
       id="snippets-modal"
       class="hidden fixed inset-0 z-50 flex items-center justify-center bg-black/50"
-    >
+      >
       <div
+        id="snippet-modal-card"
         class="bg-white dark:bg-gray-900 rounded-xl shadow-xl w-full max-w-lg mx-4 p-6 space-y-5 max-h-[90vh] overflow-y-auto"
       >
         <h3 class="text-base font-semibold text-gray-900 dark:text-gray-50">
-          <span data-i18n="snippet.modal_title">🧩 Insert a snippet</span>
+          <span id="snippet-modal-title" data-i18n="snippet.modal_title">🧩 Insert a snippet</span>
         </h3>
 
         <div
@@ -1636,6 +1638,44 @@
           </div>
         </div>
 
+        <!-- Panel: ordered-list -->
+        <div id="snip-panel-ordered-list" class="hidden space-y-3">
+          <div class="space-y-1.5">
+            <label
+              data-i18n="snippet.ordered_list_content_label"
+              class="block text-xs font-medium text-gray-500 dark:text-gray-400"
+              >Items</label
+            >
+            <textarea
+              id="snip-ordered-list-content"
+              rows="10"
+              data-i18n-placeholder="snippet.ordered_list_content_placeholder"
+              placeholder="One item per line…"
+              oninput="snippetUpdatePreview()"
+              class="w-full px-3 py-2 text-sm rounded-lg border border-gray-300 dark:border-gray-600 bg-gray-50 dark:bg-gray-800 text-gray-900 dark:text-gray-100 focus:outline-none focus:ring-2 focus:ring-blue-500 resize-y leading-relaxed"
+            ></textarea>
+          </div>
+        </div>
+
+        <!-- Panel: unordered-list -->
+        <div id="snip-panel-unordered-list" class="hidden space-y-3">
+          <div class="space-y-1.5">
+            <label
+              data-i18n="snippet.unordered_list_content_label"
+              class="block text-xs font-medium text-gray-500 dark:text-gray-400"
+              >Items</label
+            >
+            <textarea
+              id="snip-unordered-list-content"
+              rows="10"
+              data-i18n-placeholder="snippet.unordered_list_content_placeholder"
+              placeholder="One item per line…"
+              oninput="snippetUpdatePreview()"
+              class="w-full px-3 py-2 text-sm rounded-lg border border-gray-300 dark:border-gray-600 bg-gray-50 dark:bg-gray-800 text-gray-900 dark:text-gray-100 focus:outline-none focus:ring-2 focus:ring-blue-500 resize-y leading-relaxed"
+            ></textarea>
+          </div>
+        </div>
+
         <!-- Panel: code-block -->
         <div id="snip-panel-code-block" class="hidden space-y-3">
           <div class="space-y-1.5">
@@ -1654,6 +1694,40 @@
               class="w-full px-3 py-2 text-sm rounded-lg border border-gray-300 dark:border-gray-600 bg-gray-50 dark:bg-gray-800 text-gray-900 dark:text-gray-100 focus:outline-none focus:ring-2 focus:ring-blue-500"
             />
           </div>
+          <div class="space-y-1.5">
+            <label
+              data-i18n="snippet.code_content_label"
+              class="block text-xs font-medium text-gray-500 dark:text-gray-400"
+              >Code</label
+            >
+            <textarea
+              id="snip-code-content"
+              rows="12"
+              data-i18n-placeholder="snippet.code_content_placeholder"
+              placeholder="Paste or edit code here…"
+              oninput="snippetUpdatePreview()"
+              class="w-full px-3 py-2 text-sm rounded-lg border border-gray-300 dark:border-gray-600 bg-gray-50 dark:bg-gray-800 text-gray-900 dark:text-gray-100 focus:outline-none focus:ring-2 focus:ring-blue-500 resize-y font-mono leading-relaxed"
+            ></textarea>
+          </div>
+        </div>
+
+        <!-- Panel: blockquote -->
+        <div id="snip-panel-blockquote" class="hidden space-y-3">
+          <div class="space-y-1.5">
+            <label
+              data-i18n="snippet.blockquote_content_label"
+              class="block text-xs font-medium text-gray-500 dark:text-gray-400"
+              >Quote</label
+            >
+            <textarea
+              id="snip-blockquote-content"
+              rows="8"
+              data-i18n-placeholder="snippet.blockquote_content_placeholder"
+              placeholder="Quote text…"
+              oninput="snippetUpdatePreview()"
+              class="w-full px-3 py-2 text-sm rounded-lg border border-gray-300 dark:border-gray-600 bg-gray-50 dark:bg-gray-800 text-gray-900 dark:text-gray-100 focus:outline-none focus:ring-2 focus:ring-blue-500 resize-y leading-relaxed"
+            ></textarea>
+          </div>
         </div>
 
         <!-- Panel: image -->
@@ -2045,7 +2119,7 @@
         </div>
 
         <!-- Markdown preview -->
-        <div class="space-y-1.5">
+        <div id="snippet-preview-wrap" class="space-y-1.5">
           <label
             data-i18n="snippet.markdown_preview_label"
             class="block text-xs font-medium text-gray-500 dark:text-gray-400"
@@ -2066,8 +2140,17 @@
           >
             Cancel
           </button>
+          <button
+            onclick="deleteInlineSnippetBlock()"
+            id="snippet-delete-btn"
+            data-i18n="snippet.inline_delete_btn"
+            class="hidden text-sm px-4 py-2 rounded-lg border border-red-200 dark:border-red-800 text-red-600 dark:text-red-300 hover:bg-red-50 dark:hover:bg-red-900/30 font-semibold transition-colors"
+          >
+            Delete block
+          </button>
           <button
             onclick="insertSnippet()"
+            id="snippet-submit-btn"
             data-i18n="snippet.insert_btn"
             class="text-sm px-4 py-2 rounded-lg bg-blue-600 hover:bg-blue-700 text-white font-semibold transition-colors"
           >

package/dist/src/frontend/inline-snippet-edit.js

@@ -0,0 +1,219 @@
+// ── Inline snippet editing from rendered viewer ─────────────────────────────
+// Right-clicking a rendered fragment that maps to a known snippet offers an
+// inline edit action. The actual form stays the Snippets modal; this file only
+// maps rendered DOM elements back to source Markdown ranges.
+
+const _INLINE_SNIPPET_TYPES = new Set([
+  "anchor-doc-link",
+  "doc-link",
+  "anchor-link",
+  "image",
+  "link",
+  "collapsible",
+  "colored-text",
+  "colored-section",
+  "tree",
+  "code-block",
+  "table",
+  "blockquote",
+  "separator",
+  "ordered-list",
+  "unordered-list",
+]);
+
+const _INLINE_TYPE_SELECTORS = [
+  { types: ["collapsible"], selector: "details" },
+  { types: ["colored-section"], selector: 'div[style*="border-left"]' },
+  { types: ["colored-text"], selector: 'span[style*="color"]' },
+  { types: ["tree", "code-block"], selector: "pre" },
+  { types: ["table"], selector: "table" },
+  { types: ["blockquote"], selector: "blockquote" },
+  { types: ["separator"], selector: "hr" },
+  { types: ["ordered-list"], selector: "ol" },
+  { types: ["unordered-list"], selector: "ul" },
+  { types: ["image"], selector: "img" },
+  {
+    types: ["anchor-doc-link", "doc-link", "anchor-link", "link"],
+    selector: "a[href]",
+  },
+];
+
+let _inlineSnippetPopup = null;
+
+function _inlineRangesOverlap(a, b) {
+  return a.start < b.end && b.start < a.end;
+}
+
+function _inlineAddRange(ranges, start, raw) {
+  if (!raw || !raw.trim()) return;
+  const type = detectSnippetType(raw);
+  if (!type || !_INLINE_SNIPPET_TYPES.has(type)) return;
+  const end = start + raw.length;
+  const candidate = { start, end, type };
+  if (ranges.some((existing) => _inlineRangesOverlap(existing, candidate))) {
+    return;
+  }
+  ranges.push(candidate);
+}
+
+function _inlineAddRegexRanges(ranges, content, regex, groupIndex = 0) {
+  let match;
+  while ((match = regex.exec(content))) {
+    const raw = match[groupIndex];
+    const start =
+      match.index + (groupIndex > 0 ? match[0].indexOf(raw) : 0);
+    _inlineAddRange(ranges, start, raw);
+    if (match[0].length === 0) regex.lastIndex += 1;
+  }
+}
+
+function _inlineCollectSnippetRanges(content) {
+  const ranges = [];
+
+  _inlineAddRegexRanges(ranges, content, /```[\s\S]*?```/g);
+  _inlineAddRegexRanges(ranges, content, /<details[\s\S]*?<\/details>/gi);
+  _inlineAddRegexRanges(
+    ranges,
+    content,
+    /<div\b[^>]*border-left[^>]*>[\s\S]*?<\/div>/gi,
+  );
+  _inlineAddRegexRanges(
+    ranges,
+    content,
+    /<span\b[^>]*color:[^>]*>[\s\S]*?<\/span>/gi,
+  );
+  _inlineAddRegexRanges(
+    ranges,
+    content,
+    /(?:^|\n)((?:\|[^\n]*\|\n)\|[ \t:|-]*\|(?:\n\|[^\n]*\|)*)/g,
+    1,
+  );
+  _inlineAddRegexRanges(ranges, content, /^> .*(?:\n>.*)*/gm);
+  _inlineAddRegexRanges(ranges, content, /^1\. .*(?:\n(?:\d+\.| {3,}\d+\.) .*)*/gm);
+  _inlineAddRegexRanges(ranges, content, /^- .*(?:\n(?:- | {2,}- ).*)*/gm);
+  _inlineAddRegexRanges(ranges, content, /!\[[^\]\n]*\]\([^)]+\)/g);
+  _inlineAddRegexRanges(ranges, content, /\[[^\]\n]+\]\([^)]+\)/g);
+
+  const frontmatter = content.match(/^---\s*\n[\s\S]*?\n---/);
+  _inlineAddRegexRanges(ranges, content, /^---$/gm);
+  return ranges
+    .filter((range) => {
+      if (range.type !== "separator") return true;
+      return !frontmatter || range.start > frontmatter[0].length;
+    })
+    .sort((a, b) => a.start - b.start);
+}
+
+function _inlineTopLevelListElements(contentEl, selector) {
+  return Array.from(contentEl.querySelectorAll(selector)).filter(
+    (el) => !el.parentElement.closest("ol, ul"),
+  );
+}
+
+function _inlineAssignElements(contentEl, candidates) {
+  contentEl
+    .querySelectorAll("[data-inline-snippet-index]")
+    .forEach((el) => {
+      el.removeAttribute("data-inline-snippet-index");
+      el.classList.remove("ld-inline-snippet-target");
+    });
+
+  for (const { types, selector } of _INLINE_TYPE_SELECTORS) {
+    const matching = candidates.filter((candidate) =>
+      types.includes(candidate.type),
+    );
+    if (!matching.length) continue;
+    const elements =
+      selector === "ol" || selector === "ul"
+        ? _inlineTopLevelListElements(contentEl, selector)
+        : Array.from(contentEl.querySelectorAll(selector));
+    const limit = Math.min(matching.length, elements.length);
+    for (let i = 0; i < limit; i += 1) {
+      elements[i].dataset.inlineSnippetIndex = String(
+        candidates.indexOf(matching[i]),
+      );
+      elements[i].classList.add("ld-inline-snippet-target");
+    }
+  }
+}
+
+function _inlineClosePopup() {
+  if (_inlineSnippetPopup) {
+    _inlineSnippetPopup.remove();
+    _inlineSnippetPopup = null;
+  }
+}
+
+function _inlineShowPopup(event, range) {
+  _inlineClosePopup();
+  const popup = document.createElement("div");
+  popup.id = "inline-snippet-popup";
+  popup.className =
+    "fixed z-50 rounded-lg border border-blue-200 dark:border-blue-800 bg-white dark:bg-gray-900 shadow-lg p-1";
+  const btn = document.createElement("button");
+  btn.type = "button";
+  btn.className =
+    "inline-flex items-center gap-2 rounded-md px-3 py-2 text-sm font-semibold text-blue-700 dark:text-blue-300 hover:bg-blue-50 dark:hover:bg-blue-900/30";
+  const icon = document.createElement("i");
+  icon.className = "fa-solid fa-pen-to-square";
+  icon.setAttribute("aria-hidden", "true");
+  const label = document.createElement("span");
+  label.textContent = window.t("snippet.inline_edit_btn");
+  btn.append(icon, label);
+  btn.addEventListener("click", (e) => {
+    e.preventDefault();
+    e.stopPropagation();
+    _inlineClosePopup();
+    openSnippetsModalForInlineEdit(range);
+  });
+  popup.appendChild(btn);
+  document.body.appendChild(popup);
+
+  const margin = 8;
+  const rect = popup.getBoundingClientRect();
+  const left = Math.min(
+    window.innerWidth - rect.width - margin,
+    Math.max(margin, event.clientX),
+  );
+  const top = Math.max(margin, event.clientY - rect.height - margin);
+  popup.style.left = `${left}px`;
+  popup.style.top = `${top}px`;
+  _inlineSnippetPopup = popup;
+}
+
+function initInlineSnippetEditing(contentEl) {
+  if (!contentEl || typeof currentDocContent !== "string") return;
+  const candidates = _inlineCollectSnippetRanges(currentDocContent);
+  _inlineAssignElements(contentEl, candidates);
+
+  if (contentEl._inlineSnippetContextHandler) {
+    contentEl.removeEventListener(
+      "contextmenu",
+      contentEl._inlineSnippetContextHandler,
+    );
+  }
+  contentEl._inlineSnippetContextHandler = (event) => {
+    const target = event.target.closest("[data-inline-snippet-index]");
+    if (!target || !contentEl.contains(target)) return;
+    const range = candidates[Number(target.dataset.inlineSnippetIndex)];
+    if (!range) return;
+    event.preventDefault();
+    _inlineShowPopup(event, range);
+  };
+  contentEl.addEventListener(
+    "contextmenu",
+    contentEl._inlineSnippetContextHandler,
+  );
+}
+
+document.addEventListener("click", (event) => {
+  if (_inlineSnippetPopup && !_inlineSnippetPopup.contains(event.target)) {
+    _inlineClosePopup();
+  }
+});
+
+document.addEventListener("keydown", (event) => {
+  if (event.key === "Escape") _inlineClosePopup();
+});
+
+window.initInlineSnippetEditing = initInlineSnippetEditing;

package/dist/src/frontend/snippets.js

@@ -6,13 +6,17 @@
 
 let _snippetSelStart = 0;
 let _snippetSelEnd = 0;
+let _snippetInlineEdit = false;
 const _SNIPPET_PANELS = [
   "collapsible",
   "link",
   "doc-link",
   "anchor-link",
   "anchor-doc-link",
+  "ordered-list",
+  "unordered-list",
   "code-block",
+  "blockquote",
   "image",
   "table",
   "tree",
@@ -626,11 +630,38 @@ async function snippetAnchorDocChanged() {
   snippetUpdatePreview();
 }
 
-function openSnippetsModal() {
-  const editor = document.getElementById("doc-editor");
-  _snippetSelStart = editor.selectionStart;
-  _snippetSelEnd = editor.selectionEnd;
+function _setSnippetModalMode(isInlineEdit) {
+  _snippetInlineEdit = !!isInlineEdit;
+  const title = document.getElementById("snippet-modal-title");
+  if (title) {
+    title.textContent = window.t(
+      _snippetInlineEdit ? "snippet.inline_modal_title" : "snippet.modal_title",
+    );
+  }
+  const submit = document.getElementById("snippet-submit-btn");
+  if (submit) {
+    submit.textContent = window.t(
+      _snippetInlineEdit ? "snippet.inline_save_btn" : "snippet.insert_btn",
+    );
+  }
+  const typeSelect = document.getElementById("snippet-type");
+  if (typeSelect) {
+    typeSelect.disabled = _snippetInlineEdit;
+    typeSelect.classList.toggle("cursor-not-allowed", _snippetInlineEdit);
+    typeSelect.classList.toggle("opacity-70", _snippetInlineEdit);
+  }
+  const deleteBtn = document.getElementById("snippet-delete-btn");
+  if (deleteBtn) {
+    deleteBtn.classList.toggle("hidden", !_snippetInlineEdit);
+  }
+  const card = document.getElementById("snippet-modal-card");
+  if (card) {
+    card.classList.toggle("max-w-lg", !_snippetInlineEdit);
+    card.classList.toggle("max-w-5xl", _snippetInlineEdit);
+  }
+}
 
+function _openSnippetsModalForText(selectedText, detectedOverride = null) {
   const docOpts = allDocs
     .map((d) => `<option value="${d.id}">${d.title}</option>`)
     .join("");
@@ -640,13 +671,9 @@ function openSnippetsModal() {
   snippetAnchorDocChanged();
 
   const msgEl = document.getElementById("snippet-detect-msg");
-  const selectedText = editor.value.slice(
-    _snippetSelStart,
-    _snippetSelEnd,
-  );
 
   if (selectedText) {
-    const detected = detectSnippetType(selectedText);
+    const detected = detectedOverride || detectSnippetType(selectedText);
     if (detected) {
       document.getElementById("snippet-type").value = detected;
       snippetTypeChanged();
@@ -688,8 +715,26 @@ function openSnippetsModal() {
   document.getElementById("snippets-modal").classList.remove("hidden");
 }
 
+function openSnippetsModal() {
+  const editor = document.getElementById("doc-editor");
+  _snippetSelStart = editor.selectionStart;
+  _snippetSelEnd = editor.selectionEnd;
+  _setSnippetModalMode(false);
+  _openSnippetsModalForText(editor.value.slice(_snippetSelStart, _snippetSelEnd));
+}
+
+function openSnippetsModalForInlineEdit(range) {
+  if (!range || typeof currentDocContent !== "string") return;
+  _snippetSelStart = range.start;
+  _snippetSelEnd = range.end;
+  _setSnippetModalMode(true);
+  const selectedText = currentDocContent.slice(_snippetSelStart, _snippetSelEnd);
+  _openSnippetsModalForText(selectedText, range.type || null);
+}
+
 function closeSnippetsModal() {
   document.getElementById("snippets-modal").classList.add("hidden");
+  _setSnippetModalMode(false);
 }
 
 function snippetTypeChanged() {
@@ -698,8 +743,21 @@ function snippetTypeChanged() {
     const panel = document.getElementById("snip-panel-" + p);
     if (panel) panel.classList.toggle("hidden", p !== type);
   });
-  const previewWrap = document.getElementById("snippet-preview")?.parentElement;
-  if (previewWrap) previewWrap.classList.toggle("hidden", type === "attachment");
+  const previewWrap = document.getElementById("snippet-preview-wrap");
+  if (previewWrap) {
+    previewWrap.classList.toggle(
+      "hidden",
+      type === "attachment" ||
+        type === "table" ||
+        type === "code-block" ||
+        type === "blockquote" ||
+        type === "ordered-list" ||
+        type === "unordered-list" ||
+        type === "colored-section" ||
+        type === "colored-text" ||
+        type === "tree",
+    );
+  }
 
   if (type === "table") tableInit();
   else if (type === "tree") treeInit();
@@ -821,32 +879,70 @@ function buildSnippetMarkdown() {
         window.t('snippet.link_anchor_placeholder');
       return `[${text}](?doc=${encodeURIComponent(docId)}#${anchor})`;
     }
-    case "ordered-list":
-      return [
-        "1. Élément 1",
-        "2. Élément 2",
-        "   1. Sous-élément 2.1",
-        "   2. Sous-élément 2.2",
-        "3. Élément 3",
-        "   1. Sous-élément 3.1",
-        "      1. Sous-sous-élément 3.1.1",
-      ].join("\n");
-    case "unordered-list":
-      return [
-        "- Élément 1",
-        "- Élément 2",
-        "  - Sous-élément 2.1",
-        "  - Sous-élément 2.2",
-        "- Élément 3",
-        "  - Sous-élément 3.1",
-        "    - Sous-sous-élément 3.1.1",
-      ].join("\n");
+    case "ordered-list": {
+      const content =
+        document.getElementById("snip-ordered-list-content").value ||
+        [
+          "Élément 1",
+          "Élément 2",
+          "   Sous-élément 2.1",
+          "   Sous-élément 2.2",
+          "Élément 3",
+          "   Sous-élément 3.1",
+          "      Sous-sous-élément 3.1.1",
+        ].join("\n");
+      const countersByIndent = new Map();
+      return content
+        .split("\n")
+        .filter((line) => line.trim())
+        .map((line) => {
+          const indent = line.match(/^\s*/)[0];
+          const indentLength = indent.length;
+          for (const knownIndent of Array.from(countersByIndent.keys())) {
+            if (knownIndent > indentLength) countersByIndent.delete(knownIndent);
+          }
+          const next = (countersByIndent.get(indentLength) || 0) + 1;
+          countersByIndent.set(indentLength, next);
+          return `${indent}${next}. ${line.trim()}`;
+        })
+        .join("\n");
+    }
+    case "unordered-list": {
+      const content =
+        document.getElementById("snip-unordered-list-content").value ||
+        [
+          "Élément 1",
+          "Élément 2",
+          "  Sous-élément 2.1",
+          "  Sous-élément 2.2",
+          "Élément 3",
+          "  Sous-élément 3.1",
+          "    Sous-sous-élément 3.1.1",
+        ].join("\n");
+      return content
+        .split("\n")
+        .filter((line) => line.trim())
+        .map((line) => {
+          const indent = line.match(/^\s*/)[0];
+          return `${indent}- ${line.trim()}`;
+        })
+        .join("\n");
+    }
     case "code-block": {
       const lang = document.getElementById("snip-code-lang").value || "";
-      return `\`\`\`${lang}\n// code ici\n\`\`\``;
+      const code =
+        document.getElementById("snip-code-content").value || "// code ici";
+      return `\`\`\`${lang}\n${code}\n\`\`\``;
+    }
+    case "blockquote": {
+      const content =
+        document.getElementById("snip-blockquote-content").value ||
+        "Citation ici\n\n— Auteur";
+      return content
+        .split("\n")
+        .map((line) => (line.trim() ? `> ${line}` : ">"))
+        .join("\n");
     }
-    case "blockquote":
-      return `> Citation ici\n>\n> — Auteur`;
     case "separator":
       return `\n---\n`;
     case "image": {
@@ -903,8 +999,11 @@ function snippetUpdatePreview() {
     buildSnippetMarkdown();
 }
 
-function insertSnippet() {
+async function insertSnippet() {
   const type = document.getElementById("snippet-type").value;
+  if (_snippetInlineEdit && (type === "diagram" || type === "attachment")) {
+    return;
+  }
   if (type === "diagram") {
     insertDiagramSnippet();
     return;
@@ -915,7 +1014,21 @@ function insertSnippet() {
     return;
   }
   const text = buildSnippetMarkdown();
+  const wasInlineEdit = _snippetInlineEdit;
   closeSnippetsModal();
+  if (wasInlineEdit) {
+    const before = currentDocContent.slice(0, _snippetSelStart);
+    const after = currentDocContent.slice(_snippetSelEnd);
+    try {
+      await saveCurrentDocumentContent(before + text + after);
+    } catch (err) {
+      alert(
+        window.t("snippet.inline_save_failed") +
+          (err && err.message ? err.message : String(err)),
+      );
+    }
+    return;
+  }
   const editor = document.getElementById("doc-editor");
   const before = editor.value.slice(0, _snippetSelStart);
   const after = editor.value.slice(_snippetSelEnd);
@@ -925,6 +1038,34 @@ function insertSnippet() {
   editor.focus();
 }
 
+async function deleteInlineSnippetBlock() {
+  if (!_snippetInlineEdit) return;
+  const ok =
+    typeof showConfirm === "function"
+      ? await showConfirm({
+          title: window.t("snippet.inline_delete_title"),
+          message: window.t("snippet.inline_delete_message"),
+          detail: window.t("snippet.inline_delete_detail"),
+          confirmLabel: window.t("snippet.inline_delete_confirm_btn"),
+          danger: true,
+          detailTone: "warning",
+        })
+      : confirm(window.t("snippet.inline_delete_message"));
+  if (!ok) return;
+
+  const before = currentDocContent.slice(0, _snippetSelStart);
+  const after = currentDocContent.slice(_snippetSelEnd);
+  closeSnippetsModal();
+  try {
+    await saveCurrentDocumentContent(before + after);
+  } catch (err) {
+    alert(
+      window.t("snippet.inline_delete_failed") +
+        (err && err.message ? err.message : String(err)),
+    );
+  }
+}
+
 async function insertDiagramSnippet() {
   const isNew = document.getElementById("snip-diag-mode-new").checked;
   const imgName =
@@ -979,6 +1120,22 @@ async function insertDiagramSnippet() {
 }
 
 // ── Snippet parsing (detection lives in /snippet-detect.js) ────────────────
+function _parseMarkdownTableCells(line) {
+  return line
+    .trim()
+    .split("|")
+    .slice(1, -1)
+    .map((cell) => cell.trim());
+}
+
+function _isMarkdownTableSeparatorLine(line) {
+  const cells = _parseMarkdownTableCells(line);
+  return (
+    cells.length > 0 &&
+    cells.every((cell) => /^:?-{3,}:?$/.test(cell.replace(/\s+/g, "")))
+  );
+}
+
 function parseAndFillSnippet(text, type) {
   const t = text.trim();
   switch (type) {
@@ -1065,9 +1222,31 @@ function parseAndFillSnippet(text, type) {
       }
       break;
     }
+    case "ordered-list": {
+      document.getElementById("snip-ordered-list-content").value = t
+        .split("\n")
+        .map((line) => line.replace(/^(\s*)\d+\.\s?/, "$1"))
+        .join("\n");
+      break;
+    }
+    case "unordered-list": {
+      document.getElementById("snip-unordered-list-content").value = t
+        .split("\n")
+        .map((line) => line.replace(/^(\s*)[-*+]\s?/, "$1"))
+        .join("\n");
+      break;
+    }
     case "code-block": {
-      const m = t.match(/^```(\w*)\n/);
-      document.getElementById("snip-code-lang").value = m ? m[1] : "";
+      const m = t.match(/^```\s*([^\n]*)\n([\s\S]*?)\n```$/);
+      document.getElementById("snip-code-lang").value = m ? m[1].trim() : "";
+      document.getElementById("snip-code-content").value = m ? m[2] : "";
+      break;
+    }
+    case "blockquote": {
+      document.getElementById("snip-blockquote-content").value = t
+        .split("\n")
+        .map((line) => line.replace(/^>\s?/, ""))
+        .join("\n");
       break;
     }
     case "image": {
@@ -1083,14 +1262,9 @@ function parseAndFillSnippet(text, type) {
         .split("\n")
         .filter((l) => /^\|.*\|$/.test(l.trim()));
       const dataLines = allLines.filter(
-        (l) => !/^\| *[-: ][-| :]*\|/.test(l),
-      );
-      _tableData = dataLines.map((line) =>
-        line
-          .split("|")
-          .slice(1, -1)
-          .map((c) => c.trim()),
+        (l) => !_isMarkdownTableSeparatorLine(l),
       );
+      _tableData = dataLines.map(_parseMarkdownTableCells);
       const maxCols = Math.max(..._tableData.map((r) => r.length));
       _tableData.forEach((row) => {
         while (row.length < maxCols) row.push("");

package/dist/src/frontend/validate.js

@@ -5,15 +5,21 @@
 // below 100%, the confirmation modal also warns that source-file hashes will be
 // re-baselined, and POST /api/metadata/:id/refresh is called after the PUT.
 
-// Frontmatter on this project is a `---`-fenced block of `**key:** value` lines
-// (not standard YAML). The status line is the only field this module touches.
-const _STATUS_LINE_RE = /^(\*\*status:\*\*\s*).+?\s*$/m;
+// Frontmatter may use this project's historical `**key:** value` convention or
+// regular YAML-style `key: value` lines. The status line is the only field this
+// module touches.
+const _STATUS_LINE_RE = /^(\s*(?:\*\*status:\*\*|status:)\s*).+?\s*$/im;
+
+function isWorklogDocument(docId) {
+  if (/%5BWORKLOG%5D/i.test(docId)) return true;
+  return false;
+}
 
 function getDocStatus(content) {
   if (typeof content !== "string") return null;
   const fence = content.match(/^---\s*\n([\s\S]*?)\n---/);
   if (!fence) return null;
-  const m = fence[1].match(/^\*\*status:\*\*\s*(.+?)\s*$/m);
+  const m = fence[1].match(/^\s*(?:\*\*status:\*\*|status:)\s*(.+?)\s*$/im);
   return m ? m[1].trim() : null;
 }
 
@@ -27,7 +33,7 @@ function updateValidateButtonForCurrentDoc() {
   const status = getDocStatus(
     typeof currentDocContent !== "undefined" ? currentDocContent : "",
   );
-  if (status === "To be validated") {
+  if (status && status.toUpperCase() === "TO BE VALIDATED") {
     btn.classList.remove("hidden");
   } else {
     btn.classList.add("hidden");
@@ -53,12 +59,18 @@ async function validateCurrentDoc() {
   const pct = Math.round(accuracy * 100);
   const lowAccuracy = pct < 100;
   const detail = lowAccuracy
-    ? window.t("doc.validate_detail_low_accuracy").replace("{accuracy}", pct + "%")
+    ? window
+        .t("doc.validate_detail_low_accuracy")
+        .replace("{accuracy}", pct + "%")
     : "";
 
   const ok = await window.showConfirm({
     title: window.t("doc.validate_title"),
-    message: window.t("doc.validate_message"),
+    message: window.t(
+      isWorklogDocument(currentDocId)
+        ? "doc.validate_worklog_message"
+        : "doc.validate_message",
+    ),
     detail,
     detailTone: lowAccuracy ? "warning" : undefined,
     confirmLabel: window.t("doc.validate_confirm"),
@@ -69,7 +81,10 @@ async function validateCurrentDoc() {
   if (btn) btn.disabled = true;
 
   try {
-    const newContent = _replaceStatus(currentDocContent, "Accepted");
+    const newContent = _replaceStatus(
+      currentDocContent,
+      isWorklogDocument(currentDocId) ? "Done" : "Accepted",
+    );
     if (newContent === currentDocContent) {
       throw new Error("status line not found in frontmatter");
     }

package/dist/src/lib/status.js

@@ -16,7 +16,7 @@ exports.assertNotSuperSeeded = assertNotSuperSeeded;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const config_1 = require("./config");
-const STATUS_LINE_RE = /^\*\*status:\*\*\s*(.+?)\s*$/m;
+const STATUS_LINE_RE = /^\s*(?:\*\*status:\*\*|status:)\s*(.+?)\s*$/im;
 const FRONTMATTER_FENCE_RE = /^---\s*\n([\s\S]*?)\n---/;
 function parseDocStatus(content) {
     if (typeof content !== "string")

package/dist/src/lib/status.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/lib/status.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,8EAA8E;AAC9E,+EAA+E;AAC/E,0EAA0E;;;;;;AAS1E,wCAMC;AAmBD,sCAYC;AAiBD,oDAQC;AArED,4CAAoB;AACpB,gDAAwB;AACxB,qCAAsC;AAEtC,MAAM,cAAc,GAAG,+BAA+B,CAAC;AACvD,MAAM,oBAAoB,GAAG,0BAA0B,CAAC;AAExD,SAAgB,cAAc,CAAC,OAAe;IAC5C,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACzC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAChC,CAAC;AAED,8EAA8E;AAC9E,6EAA6E;AAC7E,6EAA6E;AAC7E,SAAS,kBAAkB,CACzB,QAAgB,EAChB,YAAoB,EACpB,UAAoB;IAEpB,IAAI,cAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,YAAY,GAAG,KAAK,CAAC;QACvC,OAAO,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3D,CAAC;IACD,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,KAAK,CAAC,CAAC;IAC9D,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,cAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,aAAa,CAC3B,QAAgB,EAChB,YAAoB,EACpB,UAAoB;IAEpB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IACxE,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,CAAC;QACH,OAAO,cAAc,CAAC,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAEY,QAAA,kBAAkB,GAAG,aAAa,CAAC;AAEhD,2EAA2E;AAC3E,8EAA8E;AAC9E,gEAAgE;AAChE,MAAa,wBAAyB,SAAQ,KAAK;IAEjD,YACE,OAAO,GAAG,iDAAiD;QAE3D,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAG,sBAAsB,CAAC;QAKrC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AARD,4DAQC;AAED,SAAgB,oBAAoB,CAClC,QAAgB,EAChB,YAAoB;IAEpB,MAAM,EAAE,UAAU,GAAG,EAAE,EAAE,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,KAAK,0BAAkB,EAAE,CAAC;QAC7E,MAAM,IAAI,wBAAwB,EAAE,CAAC;IACvC,CAAC;AACH,CAAC"}
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/lib/status.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,8EAA8E;AAC9E,+EAA+E;AAC/E,0EAA0E;;;;;;AAS1E,wCAMC;AAmBD,sCAYC;AAiBD,oDAQC;AArED,4CAAoB;AACpB,gDAAwB;AACxB,qCAAsC;AAEtC,MAAM,cAAc,GAAG,+CAA+C,CAAC;AACvE,MAAM,oBAAoB,GAAG,0BAA0B,CAAC;AAExD,SAAgB,cAAc,CAAC,OAAe;IAC5C,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACzC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAChC,CAAC;AAED,8EAA8E;AAC9E,6EAA6E;AAC7E,6EAA6E;AAC7E,SAAS,kBAAkB,CACzB,QAAgB,EAChB,YAAoB,EACpB,UAAoB;IAEpB,IAAI,cAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,YAAY,GAAG,KAAK,CAAC;QACvC,OAAO,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3D,CAAC;IACD,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,KAAK,CAAC,CAAC;IAC9D,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,cAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,aAAa,CAC3B,QAAgB,EAChB,YAAoB,EACpB,UAAoB;IAEpB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IACxE,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,CAAC;QACH,OAAO,cAAc,CAAC,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAEY,QAAA,kBAAkB,GAAG,aAAa,CAAC;AAEhD,2EAA2E;AAC3E,8EAA8E;AAC9E,gEAAgE;AAChE,MAAa,wBAAyB,SAAQ,KAAK;IAEjD,YACE,OAAO,GAAG,iDAAiD;QAE3D,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAG,sBAAsB,CAAC;QAKrC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AARD,4DAQC;AAED,SAAgB,oBAAoB,CAClC,QAAgB,EAChB,YAAoB;IAEpB,MAAM,EAAE,UAAU,GAAG,EAAE,EAAE,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,KAAK,0BAAkB,EAAE,CAAC;QAC7E,MAAM,IAAI,wBAAwB,EAAE,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/starter-doc/AI/PROJECT-INSTRUCTIONS.md

@@ -54,8 +54,11 @@ Do not create durable documentation for trivial fixes, mechanical renames, or fo
 ## Progress Tracking
 
 The `DOCS_FOLDER/WORKLOG/` folder holds the operational state of in-progress tasks and the resume points between AI assistants. It does not replace ADRs.
+The `DOCS_FOLDER/WORKLOG/` folder contains three complementary kinds of files; none of them replaces the durable ADRs that live under `DOCS_FOLDER/ADRS/`.
 
-`DOCS_FOLDER/WORKLOG/current-task.md` is the shared resume point. Every assistant must read it before resuming a task and update it before handing over when it has started, finished, interrupted, or left a known follow-up.
+### 1. `DOCS_FOLDER/WORKLOG/current-task.md` — shared resume point
+
+Every assistant must read it before resuming a task and update it before handing over when it has started, finished, interrupted, or left a known follow-up.
 
 The worklog must stay factual and useful for the next agent:
 
@@ -67,7 +70,50 @@ The worklog must stay factual and useful for the next agent:
 - remaining verifications;
 - next recommended action.
 
-Create a dedicated document under `DOCS_FOLDER/WORKLOG/` for an MVP ticket when more detailed tracking becomes necessary. Durable decisions stay in ADRs.
+### 2. `DOCS_FOLDER/WORKLOG/ROADMAP.md` — ticket backlog
+
+Ordered list of tickets needed to ship the product (or a major milestone). Format close to an ADR: frontmatter (`date`, `status`, `description`, `tags`) + Markdown body.
+
+The starter ships an example roadmap — the user must replace it with the project's real tickets.
+
+When a ticket is done, the agent:
+
+1. checks and strikes through the ticket's line in `ROADMAP.md`;
+2. creates a dedicated document under `DOCS_FOLDER/WORKLOG/` recording the realization (see section 3).
+
+Checking convention inside the "Recommended order" section:
+
+- `[ ]` or `[]` — ticket not started;
+- `[x] ~~Ticket XX - ...~~` — ticket done, struck through for quick scanning.
+
+### 3. `DOCS_FOLDER/WORKLOG/YYYY_MM_DD_HH_mm_[WORKLOG]_ticket_XX_<slug>.md` — per-ticket realization record
+
+Every time a roadmap ticket is completed, create a dedicated document under `DOCS_FOLDER/WORKLOG/`. The format looks like an ADR (same frontmatter) but the **semantics differ**:
+
+- ADRs (`DOCS_FOLDER/ADRS/`) document the project's **durable decisions**: architecture, public contracts, structural conventions. They describe the **WHAT** and the **WHY**.
+- per-ticket WORKLOG documents record the **realization** of a roadmap ticket: what was done, what choices were made during execution, what verifications were run. They describe **WHAT THE AGENT DID** for that specific ticket.
+
+If a durable choice is made during a ticket (for example, picking a folder-structure convention), create an architectural ADR under `DOCS_FOLDER/ADRS/` and point the WORKLOG document to that ADR — do not duplicate the reasoning.
+
+Recommended frontmatter for a per-ticket WORKLOG document:
+
+```markdown
+---
+**date:** YYYY-MM-DD
+**status:** To Be Validated
+**description:** One sentence summarizing what was done for this ticket.
+**tags:** worklog, ticket, <domain slugs>
+---
+```
+
+Recommended sections in the body:
+
+- **Context** — short reminder of the ticket and its goal (one paragraph, link to `ROADMAP.md`);
+- **Realization** — factual list of what was done;
+- **Choices made** — technical decisions taken during the ticket. Point to an ADR if the decision is durable;
+- **Verifications** — tests passed, manual validations;
+- **Follow-ups** — points of attention for the next tickets;
+- **Related documents** — link to `ROADMAP.md` and any ADR(s).
 
 ## ADRs
 

package/dist/starter-doc/AI/default/AGENTS.md

@@ -9,7 +9,7 @@ Before making changes:
 3. Read `DOCS_FOLDER/AI/PROJECT-USEFUL-COMMANDS.md` to know the development, build, test, lint, and setup commands.
 4. Read `memory/MEMORY.md` and load only useful memory files.
 5. Read rules in `DOCS_FOLDER/AI/rules/*.md`.
-6. Read `DOCS_FOLDER/WORKLOG/current-task.md` if present to resume the state of the current task.
+6. Read `DOCS_FOLDER/WORKLOG/current-task.md` if present to resume the state of the current task, and `DOCS_FOLDER/WORKLOG/ROADMAP.md` if present to know which ticket to pick up next.
 7. Inspect ADRs in `DOCS_FOLDER/ADRS/` by reading `description` and `tags` first, then open the full ADR only when relevant.
 8. Check whether the `living-ai-documentation` MCP is available and use it to create, update, and keep documentation reliable when the task touches a decision, rule, command, stack, or technical document.
 

package/dist/starter-doc/AI/default/CLAUDE.md

@@ -9,7 +9,7 @@ Before making changes:
 3. Read `DOCS_FOLDER/AI/PROJECT-USEFUL-COMMANDS.md` to know the development, build, test, lint, and setup commands.
 4. Read `memory/MEMORY.md` and load only useful memory files.
 5. Read rules in `DOCS_FOLDER/AI/rules/*.md`.
-6. Read `DOCS_FOLDER/WORKLOG/current-task.md` if present to resume the state of the current task.
+6. Read `DOCS_FOLDER/WORKLOG/current-task.md` if present to resume the state of the current task, and `DOCS_FOLDER/WORKLOG/ROADMAP.md` if present to know which ticket to pick up next.
 7. Inspect ADRs in `DOCS_FOLDER/ADRS/` by reading `description` and `tags` first, then open the full ADR only when relevant.
 8. Check whether the `living-ai-documentation` MCP is available and use it to create, update, and keep documentation reliable when the task touches a decision, rule, command, stack, or technical document.
 

package/dist/starter-doc/WORKLOG/ROADMAP.md

@@ -0,0 +1,41 @@
+---
+**date:** 2026-01-01
+**description:** Example ticket roadmap — an ordered backlog used to deliver the product incrementally, with a visible acceptance criterion per ticket. This roadmap is written by the user; it is shipped only as an example.
+**tags:** roadmap, tickets, mvp, planning
+---
+
+# Tickets (example)
+
+> This is an example roadmap shipped by the Living Documentation starter. Replace the tickets below with the project's real backlog. AI agents must rely on this roadmap to decide which ticket to pick up next.
+
+## Checking convention
+
+- `[ ]` or `[]` — ticket not started;
+- `[x] ~~Ticket XX - ...~~` — ticket done, struck through for quick scanning.
+
+## Recommended order
+
+1. [x] ~~Ticket 01 - Initialize the project~~
+2. [ ] Ticket 02 - First screen of the nominal flow
+
+> This is an example ticket for the user (remove this line once the real roadmap is written)
+
+## Ticket 01 - Initialize the project
+
+Goal: lay down the application foundations, ready to evolve.
+
+Tasks:
+
+- create the project structure (folder layout, baseline dependencies);
+- configure linting and formatting;
+- add a minimal layout and a routing system;
+- verify that the application starts locally.
+
+Acceptance criteria:
+
+- the application starts locally without errors;
+- the main routes exist;
+- the code is typed if the stack allows it;
+- no backend is required at this stage.
+
+## Ticket 02 - Complete me ...

package/dist/starter-doc-fr/AI/PROJECT-INSTRUCTIONS.md

@@ -54,8 +54,11 @@ Ne pas créer de documentation durable pour les corrections triviales, renommage
 ## Suivi de progression
 
 Le dossier `DOCS_FOLDER/WORKLOG/` contient l'état opérationnel des tâches en cours et les points de reprise entre assistants IA. Il ne remplace pas les ADR.
+Le dossier `DOCS_FOLDER/WORKLOG/` contient trois types de fichiers complémentaires, aucun d'entre eux ne remplace les ADR durables qui vivent dans `DOCS_FOLDER/ADRS/`.
 
-`DOCS_FOLDER/WORKLOG/current-task.md` est le point de reprise partagé. Tout assistant doit le lire avant de reprendre une tâche et le mettre à jour avant de rendre la main lorsqu'il a commencé, terminé, interrompu ou laissé une suite connue.
+### 1. `DOCS_FOLDER/WORKLOG/current-task.md` — point de reprise partagé
+
+Tout assistant doit le lire avant de reprendre une tâche et le mettre à jour avant de rendre la main lorsqu'il a commencé, terminé, interrompu ou laissé une suite connue.
 
 Le worklog doit rester factuel et utile pour l'agent suivant :
 
@@ -67,7 +70,50 @@ Le worklog doit rester factuel et utile pour l'agent suivant :
 - vérifications restantes ;
 - prochaine action recommandée.
 
-Créer un document dédié dans `DOCS_FOLDER/WORKLOG/` pour un ticket MVP lorsqu'un suivi plus détaillé devient nécessaire. Les décisions durables restent dans les ADR.
+### 2. `DOCS_FOLDER/WORKLOG/ROADMAP.md` — backlog de tickets
+
+Liste ordonnée des tickets à réaliser pour livrer le produit (ou une grande étape). Format proche d'un ADR : frontmatter (`date`, `status`, `description`, `tags`) + corps Markdown.
+
+Le starter livre une roadmap d'exemple — l'utilisateur doit la remplacer par les tickets réels du projet.
+
+Quand un ticket est terminé, l'agent :
+
+1. coche et barre la ligne du ticket dans `ROADMAP.md` ;
+2. crée un document dédié dans `DOCS_FOLDER/WORKLOG/` qui consigne la réalisation (voir point 3).
+
+Convention de cochage dans la section « Ordre recommandé » :
+
+- `[ ]` ou `[]` — ticket non démarré ;
+- `[x] ~~Ticket XX - ...~~` — ticket terminé, barré pour visualisation rapide.
+
+### 3. `DOCS_FOLDER/WORKLOG/YYYY_MM_DD_HH_mm_[WORKLOG]_ticket_XX_<slug>.md` — trace de réalisation par ticket
+
+À chaque fois qu'un ticket de roadmap est terminé, créer un document dédié dans `DOCS_FOLDER/WORKLOG/`. Le format ressemble à un ADR (même frontmatter) mais la **sémantique est différente** :
+
+- les ADR (`DOCS_FOLDER/ADRS/`) documentent les **décisions durables** du projet : architecture, contrats publics, conventions structurantes. Ils décrivent le **QUOI** et le **POURQUOI**.
+- les documents WORKLOG par ticket documentent la **réalisation** d'un ticket de roadmap : ce qui a été fait, les choix retenus pendant l'exécution, les vérifications passées. Ils décrivent **CE QUE L'AGENT A FAIT** pour ce ticket précis.
+
+Si un choix durable est pris pendant la réalisation d'un ticket (par exemple, le choix d'une convention de structure de dossiers), créer un ADR architectural dans `DOCS_FOLDER/ADRS/` et faire pointer le document WORKLOG vers cet ADR — ne pas dupliquer le raisonnement.
+
+Frontmatter recommandé du document WORKLOG par ticket :
+
+```markdown
+---
+**date:** YYYY-MM-DD
+**status:** To Be Validated
+**description:** Une phrase qui résume ce qui a été fait pour ce ticket.
+**tags:** worklog, ticket, <slugs métiers>
+---
+```
+
+Sections recommandées dans le corps :
+
+- **Contexte** — rappel du ticket et de son objectif (un paragraphe court, lien vers `ROADMAP.md`) ;
+- **Réalisation** — liste factuelle de ce qui a été fait ;
+- **Choix retenus** — décisions techniques prises pendant le ticket. Pointer vers un ADR si la décision est durable ;
+- **Vérifications** — tests passés, validations manuelles ;
+- **Suites éventuelles** — points de vigilance pour les tickets suivants ;
+- **Documents liés** — lien vers `ROADMAP.md` et ADR(s) éventuel(s).
 
 ## ADR
 

package/dist/starter-doc-fr/AI/default/AGENTS.md

@@ -9,7 +9,7 @@ Avant toute modification :
 3. Lire `DOCS_FOLDER/AI/PROJECT-USEFUL-COMMANDS.md` pour connaître les commandes de développement, build, test, lint et setup.
 4. Lire `memory/MEMORY.md` et charger seulement les fichiers mémoire utiles à la tâche.
 5. Lire toutes les règles dans `DOCS_FOLDER/AI/rules/*.md`.
-6. Lire `DOCS_FOLDER/WORKLOG/current-task.md` si présent pour reprendre l'état de la tâche courante.
+6. Lire `DOCS_FOLDER/WORKLOG/current-task.md` si présent pour reprendre l'état de la tâche courante, et `DOCS_FOLDER/WORKLOG/ROADMAP.md` si présent pour savoir quel ticket attaquer ensuite.
 7. Inspecter les ADR dans `DOCS_FOLDER/ADRS/` en lisant d'abord `description` et `tags`, puis ouvrir l'ADR complet seulement s'il est pertinent.
 8. Vérifier si le MCP `living-ai-documentation` est disponible et l'utiliser pour créer, mettre à jour et fiabiliser la documentation lorsque la tâche touche une décision, une règle, une commande, la stack ou un document technique.
 

package/dist/starter-doc-fr/AI/default/CLAUDE.md

@@ -9,7 +9,7 @@ Avant toute modification :
 3. Lire `DOCS_FOLDER/AI/PROJECT-USEFUL-COMMANDS.md` pour connaître les commandes de développement, build, test, lint et setup.
 4. Lire `memory/MEMORY.md` et charger seulement les fichiers mémoire utiles à la tâche.
 5. Lire toutes les règles dans `DOCS_FOLDER/AI/rules/*.md`.
-6. Lire `DOCS_FOLDER/WORKLOG/current-task.md` si présent pour reprendre l'état de la tâche courante.
+6. Lire `DOCS_FOLDER/WORKLOG/current-task.md` si présent pour reprendre l'état de la tâche courante, et `DOCS_FOLDER/WORKLOG/ROADMAP.md` si présent pour savoir quel ticket attaquer ensuite.
 7. Inspecter les ADR dans `DOCS_FOLDER/ADRS/` en lisant d'abord `description` et `tags`, puis ouvrir l'ADR complet seulement s'il est pertinent.
 8. Vérifier si le MCP `living-ai-documentation` est disponible et l'utiliser pour créer, mettre à jour et fiabiliser la documentation lorsque la tâche touche une décision, une règle, une commande, la stack ou un document technique.
 

package/dist/starter-doc-fr/WORKLOG/ROADMAP.md

@@ -0,0 +1,41 @@
+---
+**date:** 2026-01-01
+**description:** Exemple de roadmap de tickets — backlog ordonné pour livrer progressivement le produit, avec un critère d'acceptation visible par ticket. Cette roadmap est écrite par l'utilisateur, elle est fournie à titre d'exemple.
+**tags:** roadmap, tickets, mvp, planning
+---
+
+# Tickets (exemple)
+
+> Ceci est une roadmap d'exemple fournie par le starter Living Documentation. Remplacer les tickets ci-dessous par le backlog réel du projet. Les agents IA doivent se baser sur cette roadmap pour savoir quel ticket attaquer ensuite.
+
+## Convention de cochage
+
+- `[ ]` ou `[]` — ticket non démarré ;
+- `[x] ~~Ticket XX - ...~~` — ticket terminé, barré pour la lisibilité.
+
+## Ordre recommandé
+
+1. [x] ~~Ticket 01 - Initialiser le projet~~
+2. [ ] Ticket 02 - Premier écran du parcours nominal
+
+> Ceci est un exemple de ticket pour l'utilisateur (supprimer cette ligne une fois la vraie roadmap écrite)
+
+## Ticket 01 - Initialiser le projet
+
+Objectif : poser la base applicative, prête à évoluer.
+
+Tâches :
+
+- créer la structure du projet (arborescence, dépendances de base) ;
+- configurer le linting et le formatage ;
+- ajouter un layout minimal et un système de routes ;
+- valider que l'application démarre localement.
+
+Critères d'acceptation :
+
+- l'application démarre localement sans erreur ;
+- les routes principales existent ;
+- le code est typé si la stack le permet ;
+- aucun backend n'est requis à ce stade.
+
+## Ticket 02 - Complétez ...

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "living-ai-documentation",
-  "version": "1.3.0",
+  "version": "1.6.0",
   "description": "Local Markdown documentation hub with a built-in MCP server — coding agents create ADRs, draw diagrams and detect drift while you code.",
   "main": "dist/src/server.js",
   "bin": {