living-ai-documentation 1.4.0 → 1.8.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,34 @@
   "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.inline_insert_btn": "Insert a snippet here",
+  "snippet.inline_insert_modal_title": "Insert a snippet",
+  "snippet.inline_insert_failed": "Inline insertion failed: ",
+  "snippet.inline_edit_btn_table": "Edit table",
+  "snippet.inline_edit_btn_code_block": "Edit code block",
+  "snippet.inline_edit_btn_blockquote": "Edit blockquote",
+  "snippet.inline_edit_btn_ordered_list": "Edit numbered list",
+  "snippet.inline_edit_btn_unordered_list": "Edit bullet list",
+  "snippet.inline_edit_btn_tree": "Edit tree",
+  "snippet.inline_edit_btn_colored_section": "Edit colored section",
+  "snippet.inline_edit_btn_colored_text": "Edit colored text",
+  "snippet.inline_edit_btn_collapsible": "Edit collapsible block",
+  "snippet.inline_edit_btn_link": "Edit link",
+  "snippet.inline_edit_btn_doc_link": "Edit document link",
+  "snippet.inline_edit_btn_anchor_link": "Edit anchor link",
+  "snippet.inline_edit_btn_anchor_doc_link": "Edit document + anchor link",
+  "snippet.inline_edit_btn_image": "Edit image",
+  "snippet.inline_edit_btn_separator": "Edit separator",
   "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,34 @@
   "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.inline_insert_btn": "Insérer un snippet ici",
+  "snippet.inline_insert_modal_title": "Insérer un snippet",
+  "snippet.inline_insert_failed": "Échec de l'insertion inline : ",
+  "snippet.inline_edit_btn_table": "Éditer le tableau",
+  "snippet.inline_edit_btn_code_block": "Éditer le bloc de code",
+  "snippet.inline_edit_btn_blockquote": "Éditer la citation",
+  "snippet.inline_edit_btn_ordered_list": "Éditer la liste numérotée",
+  "snippet.inline_edit_btn_unordered_list": "Éditer la liste à puces",
+  "snippet.inline_edit_btn_tree": "Éditer l'arborescence",
+  "snippet.inline_edit_btn_colored_section": "Éditer la section colorée",
+  "snippet.inline_edit_btn_colored_text": "Éditer le texte coloré",
+  "snippet.inline_edit_btn_collapsible": "Éditer le bloc repliable",
+  "snippet.inline_edit_btn_link": "Éditer le lien",
+  "snippet.inline_edit_btn_doc_link": "Éditer le lien vers un document",
+  "snippet.inline_edit_btn_anchor_link": "Éditer le lien d'ancre",
+  "snippet.inline_edit_btn_anchor_doc_link": "Éditer le lien document + ancre",
+  "snippet.inline_edit_btn_image": "Éditer l'image",
+  "snippet.inline_edit_btn_separator": "Éditer le séparateur",
   "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,416 @@
+// ── 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_EDIT_AFFORDANCE_BY_TYPE = {
+  table: { labelKey: "snippet.inline_edit_btn_table", iconClass: "fa-solid fa-table-cells" },
+  "code-block": { labelKey: "snippet.inline_edit_btn_code_block", iconClass: "fa-solid fa-code" },
+  blockquote: { labelKey: "snippet.inline_edit_btn_blockquote", iconClass: "fa-solid fa-quote-right" },
+  "ordered-list": { labelKey: "snippet.inline_edit_btn_ordered_list", iconClass: "fa-solid fa-list-ol" },
+  "unordered-list": { labelKey: "snippet.inline_edit_btn_unordered_list", iconClass: "fa-solid fa-list-ul" },
+  tree: { labelKey: "snippet.inline_edit_btn_tree", iconClass: "fa-solid fa-folder-tree" },
+  "colored-section": { labelKey: "snippet.inline_edit_btn_colored_section", iconClass: "fa-solid fa-fill-drip" },
+  "colored-text": { labelKey: "snippet.inline_edit_btn_colored_text", iconClass: "fa-solid fa-highlighter" },
+  collapsible: { labelKey: "snippet.inline_edit_btn_collapsible", iconClass: "fa-solid fa-caret-right" },
+  link: { labelKey: "snippet.inline_edit_btn_link", iconClass: "fa-solid fa-link" },
+  "doc-link": { labelKey: "snippet.inline_edit_btn_doc_link", iconClass: "fa-solid fa-file-lines" },
+  "anchor-link": { labelKey: "snippet.inline_edit_btn_anchor_link", iconClass: "fa-solid fa-anchor" },
+  "anchor-doc-link": { labelKey: "snippet.inline_edit_btn_anchor_doc_link", iconClass: "fa-solid fa-anchor" },
+  image: { labelKey: "snippet.inline_edit_btn_image", iconClass: "fa-solid fa-image" },
+  separator: { labelKey: "snippet.inline_edit_btn_separator", iconClass: "fa-solid fa-minus" },
+};
+
+function _inlineEditAffordance(type) {
+  const known = _INLINE_EDIT_AFFORDANCE_BY_TYPE[type];
+  if (known) return known;
+  return { labelKey: "snippet.inline_edit_btn", iconClass: "fa-solid fa-pen-to-square" };
+}
+
+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 _inlineLineIndentBefore(content, idx) {
+  let i = idx;
+  while (i > 0 && content[i - 1] !== "\n") i -= 1;
+  const prefix = content.slice(i, idx);
+  return /^[ \t]+$/.test(prefix) ? prefix : "";
+}
+
+function _inlineAddCodeBlockRanges(ranges, content) {
+  const regex = /```[\s\S]*?```/g;
+  let match;
+  while ((match = regex.exec(content))) {
+    const raw = match[0];
+    if (!raw.trim()) {
+      if (raw.length === 0) regex.lastIndex += 1;
+      continue;
+    }
+    const type = detectSnippetType(raw);
+    if (!type || !_INLINE_SNIPPET_TYPES.has(type)) continue;
+    const indent = _inlineLineIndentBefore(content, match.index);
+    const start = match.index - indent.length;
+    const end = match.index + raw.length;
+    const candidate = { start, end, type, indent };
+    if (ranges.some((existing) => _inlineRangesOverlap(existing, candidate))) {
+      continue;
+    }
+    ranges.push(candidate);
+  }
+}
+
+function _inlineCollectSnippetRanges(content) {
+  const ranges = [];
+
+  _inlineAddCodeBlockRanges(ranges, content);
+  _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, { iconClass, labelKey, onActivate, dataAction, dataType }) {
+  _inlineClosePopup();
+  const popup = document.createElement("div");
+  popup.id = "inline-snippet-popup";
+  if (dataAction) popup.dataset.action = dataAction;
+  if (dataType) popup.dataset.snippetType = dataType;
+  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 = iconClass;
+  icon.setAttribute("aria-hidden", "true");
+  const label = document.createElement("span");
+  label.textContent = window.t(labelKey);
+  btn.append(icon, label);
+  btn.addEventListener("click", (e) => {
+    e.preventDefault();
+    e.stopPropagation();
+    _inlineClosePopup();
+    onActivate();
+  });
+  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 _inlineTopLevelBlock(contentEl, target) {
+  let block = target instanceof Element ? target : null;
+  while (block && block.parentElement && block.parentElement !== contentEl) {
+    block = block.parentElement;
+  }
+  if (!block || block === contentEl || block.parentElement !== contentEl) {
+    return null;
+  }
+  return block;
+}
+
+function _inlineNearestBlockByY(contentEl, clientY) {
+  if (typeof clientY !== "number") return null;
+  const children = Array.from(contentEl.children);
+  if (!children.length) return null;
+  let above = null;
+  let below = null;
+  for (const child of children) {
+    const rect = child.getBoundingClientRect();
+    if (rect.bottom < clientY) above = child;
+    else if (rect.top > clientY) {
+      if (!below) below = child;
+    } else return child;
+  }
+  return above || below;
+}
+
+function _inlineResolveBlockEnd(block, candidates) {
+  if (block.matches("[data-inline-snippet-index]")) {
+    const range = candidates[Number(block.dataset.inlineSnippetIndex)];
+    if (range) return range.end;
+  }
+  let anchorIdx = null;
+  const desc = Array.from(
+    block.querySelectorAll("[data-inline-snippet-index]"),
+  );
+  if (desc.length > 0) {
+    let maxEnd = -1;
+    for (const d of desc) {
+      const range = candidates[Number(d.dataset.inlineSnippetIndex)];
+      if (range && range.end > maxEnd) maxEnd = range.end;
+    }
+    if (maxEnd >= 0) anchorIdx = maxEnd;
+  } else {
+    const text = (block.textContent || "").trim();
+    if (text) {
+      const firstLine = text.split("\n")[0].trim().slice(0, 60);
+      if (firstLine) {
+        const idx = currentDocContent.indexOf(firstLine);
+        if (idx >= 0) anchorIdx = idx;
+      }
+    }
+  }
+  if (anchorIdx === null) return null;
+  const blankIdx = currentDocContent.indexOf("\n\n", anchorIdx);
+  return blankIdx >= 0 ? blankIdx : currentDocContent.length;
+}
+
+function _inlineResolveBlockStart(block, candidates) {
+  if (block.matches("[data-inline-snippet-index]")) {
+    const range = candidates[Number(block.dataset.inlineSnippetIndex)];
+    if (range) return range.start;
+  }
+  const desc = Array.from(
+    block.querySelectorAll("[data-inline-snippet-index]"),
+  );
+  if (desc.length > 0) {
+    let minStart = Infinity;
+    for (const d of desc) {
+      const range = candidates[Number(d.dataset.inlineSnippetIndex)];
+      if (range && range.start < minStart) minStart = range.start;
+    }
+    if (minStart < Infinity) return minStart;
+  }
+  const text = (block.textContent || "").trim();
+  if (text) {
+    const firstLine = text.split("\n")[0].trim().slice(0, 60);
+    if (firstLine) {
+      const idx = currentDocContent.indexOf(firstLine);
+      if (idx >= 0) return idx;
+    }
+  }
+  return null;
+}
+
+function _inlineFindInsertPosition(contentEl, target, candidates, clientY) {
+  if (typeof currentDocContent !== "string") return null;
+  const topBlock =
+    _inlineTopLevelBlock(contentEl, target) ||
+    _inlineNearestBlockByY(contentEl, clientY);
+  if (!topBlock) return currentDocContent.length;
+
+  const directEnd = _inlineResolveBlockEnd(topBlock, candidates);
+  if (directEnd !== null) return directEnd;
+
+  let prev = topBlock.previousElementSibling;
+  while (prev) {
+    const end = _inlineResolveBlockEnd(prev, candidates);
+    if (end !== null) {
+      const next = currentDocContent.indexOf("\n\n", end + 1);
+      return next >= 0 ? next : currentDocContent.length;
+    }
+    prev = prev.previousElementSibling;
+  }
+
+  let nxt = topBlock.nextElementSibling;
+  while (nxt) {
+    const start = _inlineResolveBlockStart(nxt, candidates);
+    if (start !== null) {
+      const prevBlank = currentDocContent.lastIndexOf("\n\n", start);
+      return prevBlank >= 0 ? prevBlank : 0;
+    }
+    nxt = nxt.nextElementSibling;
+  }
+
+  return currentDocContent.length;
+}
+
+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)) {
+      const range = candidates[Number(target.dataset.inlineSnippetIndex)];
+      if (!range) return;
+      event.preventDefault();
+      const affordance = _inlineEditAffordance(range.type);
+      _inlineShowPopup(event, {
+        iconClass: affordance.iconClass,
+        labelKey: affordance.labelKey,
+        dataAction: "edit",
+        dataType: range.type,
+        onActivate: () => openSnippetsModalForInlineEdit(range),
+      });
+      return;
+    }
+    if (!contentEl.contains(event.target)) return;
+    const insertPos = _inlineFindInsertPosition(
+      contentEl,
+      event.target,
+      candidates,
+      event.clientY,
+    );
+    if (insertPos === null) return;
+    event.preventDefault();
+    _inlineShowPopup(event, {
+      iconClass: "fa-solid fa-plus",
+      labelKey: "snippet.inline_insert_btn",
+      dataAction: "insert",
+      onActivate: () => openSnippetsModalForInlineInsert(insertPos),
+    });
+  };
+  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,19 @@
 
 let _snippetSelStart = 0;
 let _snippetSelEnd = 0;
+let _snippetInlineEdit = false;
+let _snippetInlineInsert = false;
+let _snippetInlineIndent = "";
 const _SNIPPET_PANELS = [
   "collapsible",
   "link",
   "doc-link",
   "anchor-link",
   "anchor-doc-link",
+  "ordered-list",
+  "unordered-list",
   "code-block",
+  "blockquote",
   "image",
   "table",
   "tree",
@@ -626,11 +632,44 @@ async function snippetAnchorDocChanged() {
   snippetUpdatePreview();
 }
 
-function openSnippetsModal() {
-  const editor = document.getElementById("doc-editor");
-  _snippetSelStart = editor.selectionStart;
-  _snippetSelEnd = editor.selectionEnd;
+function _setSnippetModalMode(mode) {
+  const isInlineEdit = mode === "inline-edit";
+  const isInlineInsert = mode === "inline-insert";
+  const isInline = isInlineEdit || isInlineInsert;
+  _snippetInlineEdit = isInlineEdit;
+  _snippetInlineInsert = isInlineInsert;
+  if (!isInlineEdit) _snippetInlineIndent = "";
+  const title = document.getElementById("snippet-modal-title");
+  if (title) {
+    let key = "snippet.modal_title";
+    if (isInlineEdit) key = "snippet.inline_modal_title";
+    else if (isInlineInsert) key = "snippet.inline_insert_modal_title";
+    title.textContent = window.t(key);
+  }
+  const submit = document.getElementById("snippet-submit-btn");
+  if (submit) {
+    submit.textContent = window.t(
+      isInlineEdit ? "snippet.inline_save_btn" : "snippet.insert_btn",
+    );
+  }
+  const typeSelect = document.getElementById("snippet-type");
+  if (typeSelect) {
+    typeSelect.disabled = isInlineEdit;
+    typeSelect.classList.toggle("cursor-not-allowed", isInlineEdit);
+    typeSelect.classList.toggle("opacity-70", isInlineEdit);
+  }
+  const deleteBtn = document.getElementById("snippet-delete-btn");
+  if (deleteBtn) {
+    deleteBtn.classList.toggle("hidden", !isInlineEdit);
+  }
+  const card = document.getElementById("snippet-modal-card");
+  if (card) {
+    card.classList.toggle("max-w-lg", !isInline);
+    card.classList.toggle("max-w-5xl", isInline);
+  }
+}
 
+function _openSnippetsModalForText(selectedText, detectedOverride = null) {
   const docOpts = allDocs
     .map((d) => `<option value="${d.id}">${d.title}</option>`)
     .join("");
@@ -640,13 +679,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 +723,39 @@ function openSnippetsModal() {
   document.getElementById("snippets-modal").classList.remove("hidden");
 }
 
+function openSnippetsModal() {
+  const editor = document.getElementById("doc-editor");
+  _snippetSelStart = editor.selectionStart;
+  _snippetSelEnd = editor.selectionEnd;
+  _setSnippetModalMode("insert");
+  _openSnippetsModalForText(editor.value.slice(_snippetSelStart, _snippetSelEnd));
+}
+
+function openSnippetsModalForInlineEdit(range) {
+  if (!range || typeof currentDocContent !== "string") return;
+  _snippetSelStart = range.start;
+  _snippetSelEnd = range.end;
+  _setSnippetModalMode("inline-edit");
+  _snippetInlineIndent = range.indent || "";
+  const selectedText = currentDocContent.slice(_snippetSelStart, _snippetSelEnd);
+  _openSnippetsModalForText(selectedText, range.type || null);
+}
+
+function openSnippetsModalForInlineInsert(insertPos) {
+  if (typeof currentDocContent !== "string") return;
+  const pos = Math.max(
+    0,
+    Math.min(currentDocContent.length, Number(insertPos) || 0),
+  );
+  _snippetSelStart = pos;
+  _snippetSelEnd = pos;
+  _setSnippetModalMode("inline-insert");
+  _openSnippetsModalForText("");
+}
+
 function closeSnippetsModal() {
   document.getElementById("snippets-modal").classList.add("hidden");
+  _setSnippetModalMode("insert");
 }
 
 function snippetTypeChanged() {
@@ -698,8 +764,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 +900,77 @@ 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";
+      const block = `\`\`\`${lang}\n${code}\n\`\`\``;
+      if (_snippetInlineEdit && _snippetInlineIndent) {
+        return block
+          .split("\n")
+          .map((line) => _snippetInlineIndent + line)
+          .join("\n");
+      }
+      return block;
+    }
+    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 +1027,14 @@ function snippetUpdatePreview() {
     buildSnippetMarkdown();
 }
 
-function insertSnippet() {
+async function insertSnippet() {
   const type = document.getElementById("snippet-type").value;
+  if (
+    (_snippetInlineEdit || _snippetInlineInsert) &&
+    (type === "diagram" || type === "attachment")
+  ) {
+    return;
+  }
   if (type === "diagram") {
     insertDiagramSnippet();
     return;
@@ -915,7 +1045,48 @@ function insertSnippet() {
     return;
   }
   const text = buildSnippetMarkdown();
+  const wasInlineEdit = _snippetInlineEdit;
+  const wasInlineInsert = _snippetInlineInsert;
   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;
+  }
+  if (wasInlineInsert) {
+    const before = currentDocContent.slice(0, _snippetSelStart);
+    const after = currentDocContent.slice(_snippetSelStart);
+    const leadingBlank =
+      before.length === 0 || /\n\n$/.test(before)
+        ? ""
+        : before.endsWith("\n")
+          ? "\n"
+          : "\n\n";
+    const trailingBlank =
+      after.length === 0 || /^\n\n/.test(after)
+        ? ""
+        : after.startsWith("\n")
+          ? "\n"
+          : "\n\n";
+    const payload = leadingBlank + text + trailingBlank;
+    try {
+      await saveCurrentDocumentContent(before + payload + after);
+    } catch (err) {
+      alert(
+        window.t("snippet.inline_insert_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 +1096,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 +1178,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 +1280,42 @@ 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(/^```[ \t]*([^\n]*)\n([\s\S]*?)\n[ \t]*```$/);
+      document.getElementById("snip-code-lang").value = m ? m[1].trim() : "";
+      let codeContent = m ? m[2] : "";
+      if (m && _snippetInlineIndent) {
+        const escapedIndent = _snippetInlineIndent.replace(
+          /[.*+?^${}()|[\]\\]/g,
+          "\\$&",
+        );
+        codeContent = codeContent.replace(
+          new RegExp("^" + escapedIndent, "gm"),
+          "",
+        );
+      }
+      document.getElementById("snip-code-content").value = codeContent;
+      break;
+    }
+    case "blockquote": {
+      document.getElementById("snip-blockquote-content").value = t
+        .split("\n")
+        .map((line) => line.replace(/^>\s?/, ""))
+        .join("\n");
       break;
     }
     case "image": {
@@ -1083,14 +1331,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "living-ai-documentation",
-  "version": "1.4.0",
+  "version": "1.8.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": {