From b3a769ea147533be30ad62b8cfc37df97cd7664b Mon Sep 17 00:00:00 2001
From: moilstack <moilstack.tech@gmail.com>
Date: Tue, 14 Jul 2026 09:50:21 +0530
Subject: [PATCH 01/14] Add frontmatter tags UI, tag search, undo fixes

Introduce tag support and editor/UX improvements: add Tag modal (editor context) to read/write YAML frontmatter tags; make main process strip BOM and parse frontmatter-only tags; add tag-search syntax (#tag or tag:name) and surface tag matches in search results; snapshot editor state before toolbar/context-menu range edits so Ctrl+Z undoes them; add copy/paste context actions, Tags action, and Ctrl+Shift+N to create a file in the Explorer; show tags with tooltip in the file tree; CSS tweaks and table-builder undo snapshot.
---
 src/main/ipc.js                 |  89 +++++++++++++-------
 src/renderer/editorCore.js      |  38 ++++++++-
 src/renderer/fileOperations.js  |   7 +-
 src/renderer/fileTreeManager.js |   3 +-
 src/renderer/hamburgerMenu.js   |   5 ++
 src/renderer/index.html         |  63 +++++++++++---
 src/renderer/index.js           |  10 ++-
 src/renderer/styles.css         |  24 +++++-
 src/renderer/tableBuilder.js    |   1 +
 src/renderer/tagModal.js        | 141 ++++++++++++++++++++++++++++++++
 10 files changed, 330 insertions(+), 51 deletions(-)
 create mode 100644 src/renderer/tagModal.js

diff --git a/src/main/ipc.js b/src/main/ipc.js
index 2c9bd97..2e1aced 100644
--- a/src/main/ipc.js
+++ b/src/main/ipc.js
@@ -139,12 +139,22 @@ function fetchJson(urlStr) {
   })
 }
 
+/**
+ * Strip a leading UTF-8 BOM (U+FEFF), if present.
+ * fs.readFile(..., 'utf8') does not strip it, and several common Windows
+ * editors (Notepad, some Git configs) write one by default — without this,
+ * `content.startsWith('---')` silently fails for otherwise-valid frontmatter.
+ */
+function _stripBOM(content) {
+  return content.charCodeAt(0) === 0xFEFF ? content.slice(1) : content
+}
+
 /**
  * Extract a plain-text first line from file content.
  * Skips YAML frontmatter and strips basic Markdown syntax.
  */
 function _extractFirstLine(content) {
-  let text = content
+  let text = _stripBOM(content)
   if (text.startsWith('---')) {
     const fmEnd = text.indexOf('\n---', 3)
     if (fmEnd !== -1) text = text.slice(fmEnd + 4)
@@ -163,40 +173,39 @@ function _extractFirstLine(content) {
 }
 
 /**
- * Extract up to 5 tags from file content.
- * Checks YAML frontmatter `tags:` first, then inline `#hashtag` patterns.
+ * Extract up to 5 tags from a file's YAML frontmatter `tags:` field.
+ * Recognized shapes only — inline array `tags: [a, b]` or a YAML list:
+ *   tags:
+ *     - a
+ *     - b
+ * No inline #hashtag fallback: scanning file prose for stray `#word` text
+ * produced false positives (URLs, anchors, code) with no way to tell a real
+ * tag from a coincidental match, so tags are only ever what the user
+ * explicitly declared in frontmatter.
  */
 function _extractTags(content) {
+  content = _stripBOM(content)
+  if (!content.startsWith('---')) return []
+  const fmEnd = content.indexOf('\n---', 3)
+  if (fmEnd === -1) return []
+
   const tags = new Set()
-  const sample = content.slice(0, 2000)
-
-  if (sample.startsWith('---')) {
-    const fmEnd = sample.indexOf('\n---', 3)
-    if (fmEnd !== -1) {
-      const fm = sample.slice(3, fmEnd)
-      const inlineMatch = fm.match(/^tags:\s*\[([^\]]+)\]/m)
-      if (inlineMatch) {
-        for (const t of inlineMatch[1].split(',')) {
-          const tag = t.trim().replace(/^['"]|['"]$/g, '')
-          if (tag) tags.add(tag)
-        }
-      }
-      if (tags.size === 0) {
-        const listMatch = fm.match(/^tags:\s*\n((?:[ \t]*-[ \t]+.+\n?)+)/m)
-        if (listMatch) {
-          for (const line of listMatch[1].split('\n')) {
-            const tag = line.replace(/^[ \t]*-[ \t]+/, '').replace(/^['"]|['"]$/g, '').trim()
-            if (tag) tags.add(tag)
-          }
-        }
-      }
+  const fm = content.slice(3, fmEnd)
+  const inlineMatch = fm.match(/^tags:\s*\[([^\]]+)\]/m)
+  if (inlineMatch) {
+    for (const t of inlineMatch[1].split(',')) {
+      const tag = t.trim().replace(/^['"]|['"]$/g, '')
+      if (tag) tags.add(tag)
     }
   }
-
   if (tags.size === 0) {
-    const re = /(?<=\s)#([a-zA-Z][a-zA-Z0-9_-]{1,20})/g
-    let m
-    while ((m = re.exec(sample)) !== null && tags.size < 5) tags.add(m[1])
+    const listMatch = fm.match(/^tags:\s*\n((?:[ \t]*-[ \t]+.+\n?)+)/m)
+    if (listMatch) {
+      for (const line of listMatch[1].split('\n')) {
+        const tag = line.replace(/^[ \t]*-[ \t]+/, '').replace(/^['"]|['"]$/g, '').trim()
+        if (tag) tags.add(tag)
+      }
+    }
   }
 
   return [...tags].slice(0, 5)
@@ -596,11 +605,26 @@ function registerIpcHandlers() {
    * Matches a single file against a lowercased query, returning a
    * SearchResult ({ filePath, fileName, snippet, matchType }) or null.
    * Shared by search:files (folder walk) and search:recent-files (explicit list).
+   *
+   * Query syntax: a leading `#` or `tag:` (e.g. `#project`, `tag:project`)
+   * searches only the file's frontmatter tags (see _extractTags) instead of
+   * filename/content — lets a user look up files by tag specifically rather
+   * than relying on the tag word happening to also appear in the text.
    */
   async function _matchFile(fullPath, fileName, q) {
-    const nameMatch = fileName.toLowerCase().includes(q)
     let content = ''
     try { content = await fs.readFile(fullPath, 'utf8') } catch { return null }
+
+    const tagQuery = q.match(/^(?:#|tag:)\s*(.+)$/)
+    if (tagQuery) {
+      const wanted = tagQuery[1].trim()
+      if (!wanted) return null
+      const tags = _extractTags(content)
+      if (!tags.some(t => t.toLowerCase().includes(wanted))) return null
+      return { filePath: fullPath, fileName, snippet: `Tags: ${tags.join(', ')}`, matchType: 'tag' }
+    }
+
+    const nameMatch = fileName.toLowerCase().includes(q)
     const contentMatch = content.toLowerCase().includes(q)
     if (!nameMatch && !contentMatch) return null
 
@@ -620,10 +644,12 @@ function registerIpcHandlers() {
 
   /**
    * search:files — full-text + filename search across a folder tree.
+   * A query starting with `#` or `tag:` (e.g. `#project`) matches only
+   * against frontmatter tags instead — see _matchFile.
    *
    * Args: { folderPath: string, query: string }
    * Returns: { results: SearchResult[] }
-   *   SearchResult: { filePath, fileName, snippet, matchType: 'name'|'content' }
+   *   SearchResult: { filePath, fileName, snippet, matchType: 'name'|'content'|'tag' }
    * Caps at 30 results. Skips hidden files and non-text files.
    */
   ipcMain.handle('search:files', async (_event, { folderPath, query }) => {
@@ -658,6 +684,7 @@ function registerIpcHandlers() {
    * search:recent-files — full-text + filename search over an explicit list
    * of file paths (used for Custom/no-folder Explorer mode, where there is
    * no folder tree to walk — only the Recent Files list).
+   * Same `#tag` / `tag:` query syntax as search:files — see _matchFile.
    *
    * Args: { filePaths: string[], query: string }
    * Returns: { results: SearchResult[] }
diff --git a/src/renderer/editorCore.js b/src/renderer/editorCore.js
index ac9b2b8..f05419d 100644
--- a/src/renderer/editorCore.js
+++ b/src/renderer/editorCore.js
@@ -27,6 +27,17 @@ const EditorCore = (() => {
   const aiUndoStack  = [];
   const AI_UNDO_LIMIT = 20; // keep at most 20 AI-edit snapshots
 
+  /**
+   * Snapshot the editor's current value onto the undo stack before a
+   * toolbar/context-menu edit. `setRangeText` mutates the textarea directly
+   * and isn't recorded by the browser's native undo history, so without this
+   * snapshot Ctrl+Z has nothing to revert for these actions.
+   */
+  function _snapshotUndo(editor) {
+    aiUndoStack.push(editor.value);
+    if (aiUndoStack.length > AI_UNDO_LIMIT) aiUndoStack.shift();
+  }
+
   /** Heading regex — used by buildHighlight to colour heading lines. */
   const HEADING_RE = /^(#{1,6})(\s)/;
 
@@ -452,6 +463,7 @@ const EditorCore = (() => {
     if (!ta) return;
     const start = ta.selectionStart, end = ta.selectionEnd;
     const sel = ta.value.substring(start, end);
+    _snapshotUndo(ta);
     ta.focus();
     ta.setSelectionRange(start, end);
     ta.setRangeText(before + sel + after, start, end, 'end');
@@ -468,6 +480,7 @@ const EditorCore = (() => {
     if (!ta) return;
     const start     = ta.selectionStart;
     const lineStart = ta.value.lastIndexOf('\n', start - 1) + 1;
+    _snapshotUndo(ta);
     ta.focus();
     ta.setSelectionRange(lineStart, lineStart);
     ta.setRangeText(prefix, lineStart, lineStart, 'end');
@@ -486,6 +499,7 @@ const EditorCore = (() => {
     const end      = editor.selectionEnd;
     const selected = editor.value.slice(start, end) || placeholder;
     const insertion = before + selected + after;
+    _snapshotUndo(editor);
     editor.focus();
     editor.setSelectionRange(start, end);
     editor.setRangeText(insertion, start, end, 'end');
@@ -517,6 +531,7 @@ const EditorCore = (() => {
       : lines.map(l => prefix + l).join('\n');
 
     const realEnd = lineEnd === -1 ? val.length : lineEnd;
+    _snapshotUndo(editor);
     editor.focus();
     editor.setSelectionRange(lineStart, realEnd);
     editor.setRangeText(newBlock, lineStart, realEnd, 'end');
@@ -528,12 +543,26 @@ const EditorCore = (() => {
   /* ── Toolbar actions map ────────────────────────────────────────── */
 
   const TOOLBAR_ACTIONS = {
+    // ── Clipboard ──────────────────────────────────────────────────
+    copy: () => {
+      const editor = _deps.getEditor ? _deps.getEditor() : null;
+      if (!editor) return;
+      editor.focus();
+      document.execCommand('copy');
+    },
+    paste: () => {
+      const editor = _deps.getEditor ? _deps.getEditor() : null;
+      if (!editor) return;
+      editor.focus();
+      document.execCommand('paste');
+    },
+
     // ── Toolbar-left buttons (insertMd / insertLine) ──────────────────
     bold:          () => insertMd('**', '**'),
     italic:        () => insertMd('*',  '*'),
     inlinecode:    () => insertMd('`',  '`'),
     link:          () => insertMd('[',  '](url)'),
-    image:         () => insertMd('![alt](', ')'),
+    image:         () => insertMd('![', '](url)'),
     h1:            () => insertLine('# '),
     h2:            () => insertLine('## '),
     list:          () => insertLine('- '),
@@ -560,6 +589,7 @@ const EditorCore = (() => {
         ? lines.map((l, i) => l.slice(`${i + 1}. `.length)).join('\n')
         : lines.map((l, i) => `${i + 1}. ${l}`).join('\n');
       const realEnd = lineEnd === -1 ? val.length : lineEnd;
+      _snapshotUndo(editor);
       editor.focus();
       editor.setSelectionRange(lineStart, realEnd);
       editor.setRangeText(newBlock, lineStart, realEnd, 'end');
@@ -591,6 +621,7 @@ const EditorCore = (() => {
       const end      = editor.selectionEnd;
       const selected = editor.value.slice(start, end) || 'code here';
       const insertion = '```\n' + selected + '\n```';
+      _snapshotUndo(editor);
       editor.focus();
       editor.setSelectionRange(start, end);
       editor.setRangeText(insertion, start, end, 'end');
@@ -605,12 +636,16 @@ const EditorCore = (() => {
       const val    = editor.value;
       const before = val[pos - 1] === '\n' || pos === 0 ? '' : '\n';
       const after  = val[pos]     === '\n'              ? '' : '\n';
+      _snapshotUndo(editor);
       editor.focus();
       editor.setSelectionRange(pos, pos);
       editor.setRangeText(`${before}---${after}`, pos, pos, 'end');
       editor.dispatchEvent(new Event('input', { bubbles: true }));
       triggerUpdate();
     },
+    tags: () => {
+      if (typeof TagModal !== 'undefined') TagModal.show();
+    },
   };
 
   /* ── Ruler state getters (used by ChatPanel via deps injection) ─── */
@@ -788,6 +823,7 @@ const EditorCore = (() => {
     renderMarkdown,
     setEditorContentUndoable,
     clearAiUndoStack,
+    snapshotUndo: _snapshotUndo,
     syncRuler,
     visualRowsForLine,
     computeMatches,
diff --git a/src/renderer/fileOperations.js b/src/renderer/fileOperations.js
index 93e896f..db79186 100644
--- a/src/renderer/fileOperations.js
+++ b/src/renderer/fileOperations.js
@@ -212,7 +212,7 @@ const FileOperations = (() => {
     });
   }
 
-  document.getElementById('btn-new-file')?.addEventListener('click', async () => {
+  async function triggerExplorerNewFile() {
     const explorerMode = localStorage.getItem('explorerMode') || 'multi-level';
     if (explorerMode === 'custom') {
       await window.newUntitledFile?.();
@@ -229,7 +229,9 @@ const FileOperations = (() => {
         showNewFileInput();
       }
     }
-  });
+  }
+
+  document.getElementById('btn-new-file')?.addEventListener('click', triggerExplorerNewFile);
 
   return {
     startInlineRename,
@@ -237,6 +239,7 @@ const FileOperations = (() => {
     showNewFileInput,
     hideNewFileInput,
     confirmNewFile,
+    triggerExplorerNewFile,
   };
 })();
 
diff --git a/src/renderer/fileTreeManager.js b/src/renderer/fileTreeManager.js
index 0ec12f0..10a21dc 100644
--- a/src/renderer/fileTreeManager.js
+++ b/src/renderer/fileTreeManager.js
@@ -132,6 +132,7 @@ const FileTreeManager = (() => {
     const tags = file.tags || [];
     const preview = file.firstLine || '';
     const tagsHTML = tags.map(t => `<span class="file-tag">${_escHtml('#' + t)}</span>`).join('');
+    const tagsTitle = tags.length ? ` title="${_escHtml(tags.map(t => '#' + t).join(', '))}"` : '';
     const labelDot = label
       ? `<svg class="file-item__label-dot" width="8" height="8" viewBox="0 0 8 8" xmlns="http://www.w3.org/2000/svg" aria-hidden="true"><circle cx="4" cy="4" r="4" fill="${label.color}"/></svg>`
       : '';
@@ -143,7 +144,7 @@ const FileTreeManager = (() => {
           ${_fileIconSVG(file.name)}
           <span class="file-item__name">${file.name}</span>
           ${labelDot}
-          ${tagsHTML ? `<div class="file-item__tags">${tagsHTML}</div>` : ''}
+          ${tagsHTML ? `<div class="file-item__tags"${tagsTitle}>${tagsHTML}</div>` : ''}
           <button class="file-pin-btn${pinned ? ' file-pin-btn--active' : ''}"
                   data-pin-path="${escapedPath}"
                   title="${pinned ? 'Unpin file' : 'Pin file'}"
diff --git a/src/renderer/hamburgerMenu.js b/src/renderer/hamburgerMenu.js
index 3ce090c..0209e46 100644
--- a/src/renderer/hamburgerMenu.js
+++ b/src/renderer/hamburgerMenu.js
@@ -43,6 +43,11 @@ const HamburgerMenu = (() => {
     await newUntitledFile();
   });
 
+  document.getElementById('hmenu-new-explorer-file')?.addEventListener('click', async () => {
+    closeHamburgerMenu();
+    await FileOperations.triggerExplorerNewFile();
+  });
+
   document.getElementById('hmenu-open-file')?.addEventListener('click', async () => {
     closeHamburgerMenu();
     const result = await window.electronAPI?.openFile();
diff --git a/src/renderer/index.html b/src/renderer/index.html
index 671e81d..062b25e 100644
--- a/src/renderer/index.html
+++ b/src/renderer/index.html
@@ -39,6 +39,10 @@
             <span class="hamburger-item__label">New</span>
             <kbd class="hamburger-item__kbd">Ctrl+N</kbd>
           </button>
+          <button class="hamburger-item" id="hmenu-new-explorer-file" role="menuitem">
+            <span class="hamburger-item__label">New File (Explorer)</span>
+            <kbd class="hamburger-item__kbd">Ctrl+Shift+N</kbd>
+          </button>
           <div class="hamburger-divider"></div>
           <button class="hamburger-item" id="hmenu-open-file" role="menuitem">
             <span class="hamburger-item__label">Open File</span>
@@ -816,6 +820,17 @@ <h3 class="ai-welcome-title">AI Assistant</h3>
 
   <!-- ── Editor context menu ──────────────────────────────────────── -->
   <div id="ctx-menu" role="menu" aria-label="Format text">
+    <div class="ctx-group">
+      <button class="ctx-item" data-action="copy">
+        <svg width="13" height="13" viewBox="0 0 14 14" fill="none" aria-hidden="true"><rect x="4.5" y="4.5" width="8" height="8" rx="1" stroke="currentColor" stroke-width="1.2"/><path d="M2.5 9.5h-1a1 1 0 0 1-1-1v-6a1 1 0 0 1 1-1h6a1 1 0 0 1 1 1v1" stroke="currentColor" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"/></svg>
+        Copy        <kbd>Ctrl C</kbd>
+      </button>
+      <button class="ctx-item" data-action="paste">
+        <svg width="13" height="13" viewBox="0 0 14 14" fill="none" aria-hidden="true"><rect x="3" y="2.5" width="8" height="10" rx="1" stroke="currentColor" stroke-width="1.2"/><path d="M5 2.5V2a1 1 0 0 1 1-1h2a1 1 0 0 1 1 1v.5" stroke="currentColor" stroke-width="1.2" stroke-linecap="round"/><path d="M5.5 6.5h3M5.5 8.5h3M5.5 10.5h2" stroke="currentColor" stroke-width="1.1" stroke-linecap="round"/></svg>
+        Paste       <kbd>Ctrl V</kbd>
+      </button>
+    </div>
+    <div class="ctx-divider"></div>
     <div class="ctx-group">
       <button class="ctx-item" data-action="bold">        <b>B</b>         Bold        <kbd>Ctrl B</kbd></button>
       <button class="ctx-item" data-action="italic">      <i>I</i>         Italic       <kbd>Ctrl I</kbd></button>
@@ -830,14 +845,6 @@ <h3 class="ai-welcome-title">AI Assistant</h3>
     </div>
     <div class="ctx-divider"></div>
     <div class="ctx-group">
-      <button class="ctx-item" data-action="ul">
-        <svg width="13" height="13" viewBox="0 0 14 14" fill="none" aria-hidden="true"><circle cx="2.5" cy="4" r="1" fill="currentColor"/><circle cx="2.5" cy="7" r="1" fill="currentColor"/><circle cx="2.5" cy="10" r="1" fill="currentColor"/><path d="M5 4h8M5 7h8M5 10h8" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"/></svg>
-        Bullet List
-      </button>
-      <button class="ctx-item" data-action="ol">
-        <svg width="13" height="13" viewBox="0 0 14 14" fill="none" aria-hidden="true"><path d="M1.5 3h1.2v4M1.5 7h2.4M2.2 10.5h1a.7.7 0 0 1 0 1.5H2M5 4h8M5 7h8M5 10.5h8" stroke="currentColor" stroke-width="1.2" stroke-linecap="round"/></svg>
-        Numbered List
-      </button>
       <button class="ctx-item" data-action="blockquote">
         <svg width="13" height="13" viewBox="0 0 14 14" fill="none" aria-hidden="true"><path d="M2 3v3a2 2 0 0 0 2 2M7 3v3a2 2 0 0 0 2 2" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round"/></svg>
         Blockquote
@@ -857,15 +864,18 @@ <h3 class="ai-welcome-title">AI Assistant</h3>
         <svg width="13" height="13" viewBox="0 0 14 14" fill="none" aria-hidden="true"><rect x="1.5" y="2.5" width="11" height="9" rx="1.5" stroke="currentColor" stroke-width="1.2"/><circle cx="5" cy="5.5" r="1" fill="currentColor"/><path d="M1.5 9.5 4.5 7l2.5 2 2-1.5 3 3" stroke="currentColor" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"/></svg>
         Image
       </button>
-      <button class="ctx-item" data-action="hr">
-        <svg width="13" height="13" viewBox="0 0 14 14" fill="none" aria-hidden="true"><path d="M1 7h12" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"/></svg>
-        Divider
-      </button>
       <button class="ctx-item" data-action="table">
         <svg width="13" height="13" viewBox="0 0 14 14" fill="none" aria-hidden="true"><rect x="1.5" y="2.5" width="11" height="9" rx="1.5" stroke="currentColor" stroke-width="1.2"/><path d="M1.5 5.5h11M5 2.5v9" stroke="currentColor" stroke-width="1.2" stroke-linecap="round"/></svg>
         Table…
       </button>
     </div>
+    <div class="ctx-divider"></div>
+    <div class="ctx-group">
+      <button class="ctx-item" data-action="tags">
+        <svg width="13" height="13" viewBox="0 0 14 14" fill="none" aria-hidden="true"><path d="M7.5 1.5h4a1 1 0 0 1 1 1v4L5 14 1.5 10.5 8.5 3M4 5a1 1 0 1 0 0-2 1 1 0 0 0 0 2Z" stroke="currentColor" stroke-width="1.2" stroke-linejoin="round"/></svg>
+        Add Tags…
+      </button>
+    </div>
   </div>
 
   <!-- ── Settings Modal ─────────────────────────────────────────────── -->
@@ -1044,7 +1054,7 @@ <h3 class="settings-section-title">File Explorer</h3>
             <div class="settings-row">
               <div class="settings-row__label">
                 <span class="settings-row__name">Explorer Mode</span>
-                <span class="settings-row__desc">Root only shows date groups, content previews, and tags. Custom hides folders entirely — Recent Files is the only way to open something.</span>
+                <span class="settings-row__desc">Root only shows date groups, content previews, and tags — start the file with a frontmatter block (<code>---</code> ... <code>tags: [work, project]</code> ... <code>---</code>) to tag it; search with <code>#tag</code> or <code>tag:name</code>. Custom hides folders entirely — Recent Files is the only way to open something.</span>
               </div>
               <div class="settings-row__control">
                 <select id="explorerMode" class="form-input settings-select">
@@ -1234,6 +1244,32 @@ <h3 class="settings-section-title">File Explorer</h3>
     </div>
   </div>
 
+  <!-- ── Tag Modal ─────────────────────────────────────────────────────── -->
+  <div id="tagModalOverlay" class="label-modal-overlay hidden"
+       role="dialog" aria-modal="true" aria-label="Add tags">
+    <div class="label-modal">
+      <div class="label-modal__header">
+        <span class="label-modal__title">Add Tags</span>
+        <button id="btnCloseTagModal" class="settings-close-btn" title="Close">
+          <svg width="14" height="14" viewBox="0 0 14 14" fill="none" aria-hidden="true">
+            <path d="M2 2l10 10M12 2 2 12" stroke="currentColor" stroke-width="1.6"
+                  stroke-linecap="round"/>
+          </svg>
+        </button>
+      </div>
+      <div class="label-modal__body">
+        <p class="tag-modal__hint">
+          Comma-separated. Saved to this file's frontmatter — shown in Root-only Explorer and
+          searchable with <code>#tag</code> or <code>tag:name</code>.
+        </p>
+        <input type="text" id="tagModalInput" class="form-input" placeholder="work, project">
+        <div class="label-modal__actions">
+          <button id="btnSaveTags" class="btn btn-primary btn-sm">Save</button>
+        </div>
+      </div>
+    </div>
+  </div>
+
   <!-- ── Table Builder Modal ──────────────────────────────────────────── -->
   <div id="tableBuilderOverlay" class="settings-overlay hidden"
        role="dialog" aria-modal="true" aria-label="Insert table">
@@ -1277,6 +1313,7 @@ <h3 class="settings-section-title">File Explorer</h3>
   <script src="welcomeScreen.js"></script>
   <script src="findReplaceWidget.js"></script>
   <script src="contextMenus.js"></script>
+  <script src="tagModal.js"></script>
   <script src="fileOperations.js"></script>
   <script src="fileTreeManager.js"></script>
   <script src="recentsPanel.js"></script>
diff --git a/src/renderer/index.js b/src/renderer/index.js
index 248ba3d..8e72a52 100644
--- a/src/renderer/index.js
+++ b/src/renderer/index.js
@@ -414,12 +414,20 @@ document.addEventListener('keydown', async e => {
 
 // Ctrl+N — new untitled file (notepad-style; no folder or sidebar required)
 document.addEventListener('keydown', async e => {
-  if ((e.ctrlKey || e.metaKey) && e.key === 'n') {
+  if ((e.ctrlKey || e.metaKey) && !e.shiftKey && e.key.toLowerCase() === 'n') {
     e.preventDefault();
     await newUntitledFile();
   }
 });
 
+// Ctrl+Shift+N — new file in the explorer (creates a file on disk in the active folder)
+document.addEventListener('keydown', async e => {
+  if ((e.ctrlKey || e.metaKey) && e.shiftKey && e.key.toLowerCase() === 'n') {
+    e.preventDefault();
+    await FileOperations.triggerExplorerNewFile();
+  }
+});
+
 /* ── Window close guards ──────────────────────────────────────────── */
 
 // Block close when unsaved — triggers Electron's will-prevent-unload
diff --git a/src/renderer/styles.css b/src/renderer/styles.css
index 83a5ac8..041112c 100644
--- a/src/renderer/styles.css
+++ b/src/renderer/styles.css
@@ -1046,13 +1046,16 @@ body {
   overflow: hidden;
   text-overflow: ellipsis;
   flex: 1;
-  min-width: 0;
+  min-width: 56px; /* keep the filename legible even when tags would otherwise crowd it out */
 }
 
 .file-item__tags {
   display: flex;
   gap: 3px;
-  flex-shrink: 0;
+  flex-shrink: 1;
+  min-width: 0;
+  max-width: 50%;
+  overflow: hidden;
   align-items: center;
   margin-left: auto;
 }
@@ -3315,6 +3318,23 @@ select.form-input {
   gap: 8px;
 }
 
+/* ── Tag Modal (reuses .label-modal shell) ────────────────────────── */
+#tagModalOverlay .label-modal { width: 320px; }
+
+.tag-modal__hint {
+  font-size: 12px;
+  line-height: 1.5;
+  color: var(--text-secondary);
+  margin: 0;
+}
+.tag-modal__hint code {
+  font-size: 11px;
+  padding: 1px 4px;
+  border-radius: 4px;
+  background: var(--input-bg);
+  border: 1px solid var(--border);
+}
+
 /* ════════════════════════════════════════════════════════════════════
    Settings Modal — sidebar layout
    ════════════════════════════════════════════════════════════════════ */
diff --git a/src/renderer/tableBuilder.js b/src/renderer/tableBuilder.js
index 238ce28..0bda853 100644
--- a/src/renderer/tableBuilder.js
+++ b/src/renderer/tableBuilder.js
@@ -237,6 +237,7 @@ const TableBuilder = (() => {
     if (!editor) { _hide(); return; }
 
     editor.focus();
+    if (typeof EditorCore !== 'undefined') EditorCore.snapshotUndo(editor);
 
     if (_selStart !== null && _selEnd !== null) {
       editor.setSelectionRange(_selStart, _selEnd);
diff --git a/src/renderer/tagModal.js b/src/renderer/tagModal.js
new file mode 100644
index 0000000..32a416a
--- /dev/null
+++ b/src/renderer/tagModal.js
@@ -0,0 +1,141 @@
+/**
+ * tagModal.js — "Add Tags…" editor context-menu action.
+ *
+ * Reads/writes the `tags:` field in the current file's YAML frontmatter,
+ * using the same shapes the main process's _extractTags (src/main/ipc.js)
+ * recognizes: inline array `tags: [a, b]`. Frontmatter tags are the only
+ * tag source recognized anywhere in the app (no inline #hashtag fallback).
+ */
+
+const TagModal = (() => {
+  const _overlay  = document.getElementById('tagModalOverlay');
+  const _input    = document.getElementById('tagModalInput');
+  const _saveBtn  = document.getElementById('btnSaveTags');
+  const _closeBtn = document.getElementById('btnCloseTagModal');
+
+  /** Split content into frontmatter lines and body lines, or null if none. */
+  function _splitFrontmatter(content) {
+    if (!content.startsWith('---')) return null;
+    const lines = content.split('\n');
+    if (lines[0].trim() !== '---') return null;
+    let endIdx = -1;
+    for (let i = 1; i < lines.length; i++) {
+      if (lines[i].trim() === '---') { endIdx = i; break; }
+    }
+    if (endIdx === -1) return null;
+    return { fmLines: lines.slice(1, endIdx), bodyLines: lines.slice(endIdx + 1) };
+  }
+
+  function _getExistingTags(fmLines) {
+    for (let i = 0; i < fmLines.length; i++) {
+      const line = fmLines[i];
+      const inlineMatch = line.match(/^tags:\s*\[([^\]]*)\]\s*$/);
+      if (inlineMatch) {
+        return inlineMatch[1].split(',').map(t => t.trim().replace(/^['"]|['"]$/g, '')).filter(Boolean);
+      }
+      if (/^tags:\s*$/.test(line)) {
+        const tags = [];
+        let j = i + 1;
+        while (j < fmLines.length && /^[ \t]*-[ \t]+/.test(fmLines[j])) {
+          tags.push(fmLines[j].replace(/^[ \t]*-[ \t]+/, '').replace(/^['"]|['"]$/g, '').trim());
+          j++;
+        }
+        return tags;
+      }
+    }
+    return [];
+  }
+
+  /** Remove any existing `tags:` declaration (inline or list form) from frontmatter lines. */
+  function _removeTagsLines(fmLines) {
+    const out = [];
+    let i = 0;
+    while (i < fmLines.length) {
+      const line = fmLines[i];
+      if (/^tags:\s*\[[^\]]*\]\s*$/.test(line)) { i++; continue; }
+      if (/^tags:\s*$/.test(line)) {
+        i++;
+        while (i < fmLines.length && /^[ \t]*-[ \t]+/.test(fmLines[i])) i++;
+        continue;
+      }
+      out.push(line);
+      i++;
+    }
+    return out;
+  }
+
+  function _applyTags(content, tags) {
+    const parsed   = _splitFrontmatter(content);
+    const tagsLine = tags.length ? `tags: [${tags.join(', ')}]` : null;
+
+    if (parsed) {
+      const fmLines = _removeTagsLines(parsed.fmLines);
+      if (tagsLine) fmLines.push(tagsLine);
+      if (fmLines.length === 0) return parsed.bodyLines.join('\n'); // frontmatter now empty — drop it
+      return ['---', ...fmLines, '---', ...parsed.bodyLines].join('\n');
+    }
+    if (!tagsLine) return content; // nothing to add, no existing frontmatter
+    return ['---', tagsLine, '---', '', content].join('\n');
+  }
+
+  function _hide() {
+    _overlay?.classList.add('hidden');
+  }
+
+  function show() {
+    const editor = document.getElementById('mdEditor');
+    if (!editor || !_overlay || !_input) return;
+
+    const parsed   = _splitFrontmatter(editor.value);
+    const existing = parsed ? _getExistingTags(parsed.fmLines) : [];
+    _input.value = existing.join(', ');
+    _overlay.classList.remove('hidden');
+    _input.focus();
+    _input.select();
+  }
+
+  function _save() {
+    const editor = document.getElementById('mdEditor');
+    if (!editor) { _hide(); return; }
+
+    const tags       = _input.value.split(',').map(t => t.trim()).filter(Boolean).slice(0, 5);
+    const oldContent = editor.value;
+    const newContent = _applyTags(oldContent, tags);
+    if (newContent !== oldContent) {
+      // The tags line always lives in frontmatter (it must, to be recognized
+      // as YAML frontmatter at all) — but that shouldn't yank the user's
+      // cursor to the top of the file. Everything after the frontmatter
+      // block (the "body") is untouched by _applyTags, so shift the caret by
+      // however much the frontmatter's length changed, keeping it at the
+      // same spot in the body rather than wherever setEditorContentUndoable
+      // resets it (position 0, as a side effect of reassigning editor.value).
+      const cursorPos    = editor.selectionStart;
+      const oldParsed    = _splitFrontmatter(oldContent);
+      const oldBody      = oldParsed ? oldParsed.bodyLines.join('\n') : oldContent;
+      const oldPrefixLen = oldContent.length - oldBody.length;
+      const newPrefixLen = newContent.length - oldBody.length;
+
+      EditorCore.setEditorContentUndoable(newContent);
+
+      const newCursor = cursorPos >= oldPrefixLen
+        ? cursorPos + (newPrefixLen - oldPrefixLen)
+        : newPrefixLen; // cursor was inside the old frontmatter — land at body start
+      editor.setSelectionRange(newCursor, newCursor);
+    }
+    _hide();
+  }
+
+  _saveBtn?.addEventListener('click', _save);
+  _closeBtn?.addEventListener('click', _hide);
+  _input?.addEventListener('keydown', e => {
+    if (e.key === 'Enter')  { e.preventDefault(); _save(); }
+    if (e.key === 'Escape') { e.preventDefault(); _hide(); }
+  });
+  _overlay?.addEventListener('click', e => { if (e.target === _overlay) _hide(); });
+
+  return { show };
+})();
+
+if (typeof module !== 'undefined' && module.exports) {
+  module.exports = { TagModal };
+}

From 3f29af749dcd4a49e78e4fe893d0ed1ccf7ba062 Mon Sep 17 00:00:00 2001
From: moilstack <moilstack.tech@gmail.com>
Date: Tue, 14 Jul 2026 10:11:08 +0530
Subject: [PATCH 02/14] Add remove-from-recents UI and Explorer link
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add 'remove from recents' buttons to the sidebar recent folders and welcome screen, with event handlers that stop propagation and update StorageManager. Change folder recent rows from <button> to <div>, add tabindex and keyboard handlers so rows remain accessible while nesting a remove button. Add SVG icon assets and CSS for remove buttons, hover states, and a brief settings-row flash. Add clickable 'Explorer' label that opens Settings → Explorer and scrolls/flash highlights the Explorer setting. Fix editor image insertion to use an empty src (']()') to avoid eager file:// fetches.
---
 src/renderer/editorCore.js      |  6 ++-
 src/renderer/fileTreeManager.js | 33 +++++++++++--
 src/renderer/hamburgerMenu.js   | 18 +++++++
 src/renderer/index.html         | 13 ++++-
 src/renderer/styles.css         | 85 +++++++++++++++++++++++++++++++++
 src/renderer/welcomeScreen.js   | 13 +++++
 6 files changed, 162 insertions(+), 6 deletions(-)

diff --git a/src/renderer/editorCore.js b/src/renderer/editorCore.js
index f05419d..f0bebbc 100644
--- a/src/renderer/editorCore.js
+++ b/src/renderer/editorCore.js
@@ -562,7 +562,11 @@ const EditorCore = (() => {
     italic:        () => insertMd('*',  '*'),
     inlinecode:    () => insertMd('`',  '`'),
     link:          () => insertMd('[',  '](url)'),
-    image:         () => insertMd('![', '](url)'),
+    // Empty URL slot (not a literal "url" placeholder) — the live preview
+    // renders this straight into <img src="...">, and a non-empty bogus
+    // relative path gets eagerly fetched under file://, throwing
+    // net::ERR_FILE_NOT_FOUND. An explicit src="" fires no request at all.
+    image:         () => insertMd('![', ']()'),
     h1:            () => insertLine('# '),
     h2:            () => insertLine('## '),
     list:          () => insertLine('- '),
diff --git a/src/renderer/fileTreeManager.js b/src/renderer/fileTreeManager.js
index 10a21dc..6df9c98 100644
--- a/src/renderer/fileTreeManager.js
+++ b/src/renderer/fileTreeManager.js
@@ -61,6 +61,11 @@ const FileTreeManager = (() => {
           stroke-linejoin="round" stroke-linecap="round"/>
   </svg>`;
 
+  const REMOVE_ICON_SVG = `<svg width="9" height="9" viewBox="0 0 9 9" fill="none"
+     xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
+  <path d="M1 1l7 7M8 1 1 8" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"/>
+</svg>`;
+
   /* ── HTML builders ────────────────────────────────────────────────── */
 
   function _escHtml(str) {
@@ -568,9 +573,13 @@ const FileTreeManager = (() => {
       }
 
       folders.forEach(item => {
-        const row = document.createElement('button');
+        // A <div> here, not a <button> — it needs to nest the remove
+        // button below, and a <button> can't legally contain another
+        // <button> (the browser would silently close the outer one early).
+        const row = document.createElement('div');
         row.className = 'folder-recent-item';
         row.setAttribute('role', 'menuitem');
+        row.setAttribute('tabindex', '0');
         row.setAttribute('title', item.path);
 
         row.innerHTML = `
@@ -582,11 +591,29 @@ const FileTreeManager = (() => {
           <div style="min-width:0;flex:1;display:flex;flex-direction:column;gap:4px;">
             <span class="folder-recent-item__name">${item.name}</span>
             <span class="folder-recent-item__path">${item.path}</span>
-          </div>`;
+          </div>
+          <button class="folder-recent-remove-btn" title="Remove from Recents"
+                  aria-label="Remove ${item.name} from recent folders">
+            ${REMOVE_ICON_SVG}
+          </button>`;
 
-        row.addEventListener('click', async () => {
+        const _open = async () => {
           _closeDropdown();
           await setActiveFolder(item.path);
+        };
+
+        row.addEventListener('click', (e) => {
+          if (e.target.closest('.folder-recent-remove-btn')) return;
+          _open();
+        });
+        row.addEventListener('keydown', (e) => {
+          if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); _open(); }
+        });
+
+        row.querySelector('.folder-recent-remove-btn').addEventListener('click', (e) => {
+          e.stopPropagation();
+          StorageManager.removeRecentItem(item.path);
+          _populateDropdown(); // refresh in place, keep the dropdown open
         });
 
         dropdown.appendChild(row);
diff --git a/src/renderer/hamburgerMenu.js b/src/renderer/hamburgerMenu.js
index 0209e46..2453509 100644
--- a/src/renderer/hamburgerMenu.js
+++ b/src/renderer/hamburgerMenu.js
@@ -105,6 +105,24 @@ const HamburgerMenu = (() => {
     document.getElementById('btnSettings')?.click();
   });
 
+  /* ── "Explorer" label (sidebar header) — jumps to Explorer settings ── */
+  function _openExplorerSettings() {
+    document.getElementById('btnSettings')?.click();
+    document.querySelector('.settings-nav-item[data-settings-panel="explorer"]')?.click();
+    requestAnimationFrame(() => {
+      const row = document.getElementById('settingsRow-explorerMode');
+      if (!row) return;
+      row.scrollIntoView({ behavior: 'smooth', block: 'center' });
+      row.classList.add('settings-row--flash');
+      setTimeout(() => row.classList.remove('settings-row--flash'), 1200);
+    });
+  }
+  const _sidebarExplorerLabel = document.getElementById('sidebarExplorerLabel');
+  _sidebarExplorerLabel?.addEventListener('click', _openExplorerSettings);
+  _sidebarExplorerLabel?.addEventListener('keydown', (e) => {
+    if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); _openExplorerSettings(); }
+  });
+
   /* ── Collapse All button (sidebar header) ─────────────────────────── */
   // Disabled in Root folder only mode, since that view has no sub-folders to
   // collapse (see FileTreeManager.updateFolderToolbarButtons).
diff --git a/src/renderer/index.html b/src/renderer/index.html
index 062b25e..37c194e 100644
--- a/src/renderer/index.html
+++ b/src/renderer/index.html
@@ -215,7 +215,16 @@
 
       <!-- 1. Section header row -->
       <div class="sidebar-section">
-        <span class="sidebar-section__label">Explorer</span>
+        <span class="sidebar-section__label sidebar-section__label--link" id="sidebarExplorerLabel"
+              role="button" tabindex="0" title="Explorer settings">
+          Explorer
+          <svg class="sidebar-section__label-icon" width="10" height="10" viewBox="0 0 14 14"
+               fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
+            <path d="M7 4.5A2.5 2.5 0 1 0 7 9.5 2.5 2.5 0 0 0 7 4.5Z" stroke="currentColor" stroke-width="1.1"/>
+            <path d="M7 1.5v1.2M7 11.3v1.2M12.5 7h-1.2M2.7 7H1.5M10.8 3.2l-.85.85M4.05 9.95l-.85.85M10.8 10.8l-.85-.85M4.05 4.05l-.85-.85"
+                  stroke="currentColor" stroke-width="1.1" stroke-linecap="round"/>
+          </svg>
+        </span>
         <div class="sidebar-section__actions">
 
           <!-- Open Folder button -->
@@ -1051,7 +1060,7 @@ <h3 class="settings-section-title">File Explorer</h3>
             </div>
 
             <!-- Explorer Mode -->
-            <div class="settings-row">
+            <div class="settings-row" id="settingsRow-explorerMode">
               <div class="settings-row__label">
                 <span class="settings-row__name">Explorer Mode</span>
                 <span class="settings-row__desc">Root only shows date groups, content previews, and tags — start the file with a frontmatter block (<code>---</code> ... <code>tags: [work, project]</code> ... <code>---</code>) to tag it; search with <code>#tag</code> or <code>tag:name</code>. Custom hides folders entirely — Recent Files is the only way to open something.</span>
diff --git a/src/renderer/styles.css b/src/renderer/styles.css
index 041112c..d27d47a 100644
--- a/src/renderer/styles.css
+++ b/src/renderer/styles.css
@@ -294,6 +294,33 @@ body {
   opacity: 0.7;
 }
 
+.folder-recent-remove-btn {
+  display: none;          /* hidden until the row is hovered/focused */
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  width: 20px;
+  height: 20px;
+  padding: 0;
+  border: none;
+  border-radius: 4px;
+  background: transparent;
+  color: var(--text-secondary);
+  cursor: pointer;
+  transition: color 0.1s, background 0.1s;
+}
+.folder-recent-remove-btn svg { opacity: 1; }
+
+.folder-recent-item:hover .folder-recent-remove-btn,
+.folder-recent-item:focus-within .folder-recent-remove-btn {
+  display: flex;
+}
+
+.folder-recent-remove-btn:hover {
+  background: var(--hover-bg, rgba(128,128,128,0.12));
+  color: var(--danger, #ef4444);
+}
+
 .folder-recent-item__name {
   font-size: 13px;
   font-weight: 500;
@@ -638,6 +665,31 @@ body {
   user-select: none;
 }
 
+.sidebar-section__label--link {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  cursor: pointer;
+  border-radius: 4px;
+  transition: color 0.15s;
+}
+.sidebar-section__label--link:hover,
+.sidebar-section__label--link:focus-visible {
+  color: var(--text-primary);
+  outline: none;
+}
+
+.sidebar-section__label-icon {
+  color: var(--text-secondary);
+  opacity: 0.7;
+  transition: opacity 0.15s, transform 0.2s;
+}
+.sidebar-section__label--link:hover .sidebar-section__label-icon,
+.sidebar-section__label--link:focus-visible .sidebar-section__label-icon {
+  opacity: 1;
+  transform: rotate(35deg);
+}
+
 .sidebar-section__actions {
   display: flex;
   align-items: center;
@@ -3602,6 +3654,32 @@ select.form-input {
   flex: 1;
 }
 
+.welcome-recent-remove-btn {
+  display: none;          /* hidden until the row is hovered */
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  width: 20px;
+  height: 20px;
+  margin-left: 4px;
+  padding: 0;
+  border: none;
+  border-radius: 4px;
+  background: transparent;
+  color: var(--text-secondary);
+  cursor: pointer;
+  transition: color 0.1s, background 0.1s;
+}
+
+.welcome-recent-item:hover .welcome-recent-remove-btn {
+  display: flex;
+}
+
+.welcome-recent-remove-btn:hover {
+  background: var(--hover-bg);
+  color: var(--danger, #ef4444);
+}
+
 .welcome-recent-empty {
   font-size: 0.82rem;
   color: var(--text-secondary);
@@ -3628,6 +3706,13 @@ select.form-input {
   gap: 16px;
   padding: 14px 0;
   border-bottom: 1px solid var(--border);
+  border-radius: 6px;
+  transition: background-color 0.3s;
+}
+
+/* Briefly highlights a row scrolled-to programmatically (e.g. from the sidebar "Explorer" label) */
+.settings-row--flash {
+  background-color: color-mix(in srgb, var(--primary) 16%, transparent);
 }
 
 .settings-row:last-of-type {
diff --git a/src/renderer/welcomeScreen.js b/src/renderer/welcomeScreen.js
index ffa7120..ac81122 100644
--- a/src/renderer/welcomeScreen.js
+++ b/src/renderer/welcomeScreen.js
@@ -15,6 +15,10 @@ const WelcomeScreen = (() => {
     <path d="M7.5 1.5V4H10" stroke="currentColor" stroke-width="1.1" stroke-linejoin="round"/>
   </svg>`;
 
+  const REMOVE_ICON = `<svg width="9" height="9" viewBox="0 0 9 9" fill="none" aria-hidden="true">
+    <path d="M1 1l7 7M8 1 1 8" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"/>
+  </svg>`;
+
   function showWelcomeScreen() {
     const screen = document.getElementById('welcome-screen');
     if (!screen) return;
@@ -40,10 +44,19 @@ const WelcomeScreen = (() => {
                     ${icon}
                     <span class="welcome-recent-item__name">${item.name}</span>
                     <span class="welcome-recent-item__path">${item.path}</span>
+                    <button class="welcome-recent-remove-btn" title="Remove from Recents">
+                      ${REMOVE_ICON}
+                    </button>
                   </li>`;
         }).join('');
 
         listEl.querySelectorAll('.welcome-recent-item').forEach(li => {
+          li.querySelector('.welcome-recent-remove-btn')?.addEventListener('click', (e) => {
+            e.stopPropagation();
+            StorageManager.removeRecentItem(li.dataset.path);
+            showWelcomeScreen();
+          });
+
           li.addEventListener('click', async () => {
             const { type, path } = li.dataset;
             if (type === 'folder') {

From f621c55a4a6eefc9989781499aaf329f9952474b Mon Sep 17 00:00:00 2001
From: moilstack <moilstack.tech@gmail.com>
Date: Tue, 14 Jul 2026 10:39:20 +0530
Subject: [PATCH 03/14] Update CHANGELOG with unreleased features

Add documentation for upcoming release including new editor and explorer features (copy/paste context menu, file tagging, quick jump to Explorer settings), improvements to file handling and context menu, and bug fixes for undo tracking and UI layout issues.
---
 CHANGELOG.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index cc6ca45..c637de5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,29 @@ All notable new features and critical fixes for MoilStack .md.
 
 ---
 
+## [Unreleased]
+
+### Added
+- **Copy / Paste in the editor context menu** — added as a new group at the top, above the formatting options, with `Ctrl C` / `Ctrl V` shown as hints
+- **Ctrl+Shift+N — New File (Explorer)** — creates a file on disk in the active Explorer folder (prompting to open a folder first if none is active), distinct from Ctrl+N's in-memory untitled buffer; also added to the hamburger menu
+- **File tagging** — right-click → "Add Tags…" opens a small modal to add/edit a file's tags, stored in its YAML frontmatter (`tags: [work, project]`); pre-fills with existing tags and preserves cursor position in the document body when saved
+  - Tags are shown as `#tag` pills next to filenames in Root folder only Explorer mode
+  - Search by tag with `#tag` or `tag:name` in the header search box — works across Multi-level, Root-only, and Custom (Recents) explorer modes, matching only real frontmatter tags rather than plain text
+  - Settings → File Explorer now explains the frontmatter format and search syntax directly in the Explorer Mode description
+- **Quick jump to Explorer settings** — clicking the "Explorer" label in the sidebar header (now shown with a small gear icon) opens Settings, switches to the Explorer tab, and scrolls to/highlights the Explorer Mode row
+- **Remove recent folders** — a hover-revealed × button now lets you remove a folder from the recents list without switching to it first, in both the Welcome screen's Recents list and the header folder-path dropdown
+
+### Changed
+- **Editor context menu decluttered** — removed Bullet List and Numbered List (they only ever applied to the first level and behaved inconsistently on nested lists) and Divider/horizontal-rule; users can still type Markdown list/`---` syntax directly
+- **File tags are frontmatter-only** — dropped the inline `#hashtag`-in-body fallback for tag detection (it produced false positives from URLs, anchors, and code); a file's tags now only come from an explicit `tags:` field in YAML frontmatter
+- **Image toolbar/context-menu action** — selected text now becomes the image's alt text (`![alt](url)`), matching how the Link action already worked, instead of incorrectly becoming the image path
+
+### Fixed
+- **Ctrl+Z not undoing context-menu formatting actions** — Bold, Italic, Strikethrough, headings, lists, blockquote, code block, and table insert now push an undo snapshot before editing, so Ctrl+Z correctly reverts them (previously these used a text-insertion method that the browser's native undo history didn't track)
+- **Long tag lists squeezing the filename out of view** — in Root folder only Explorer mode, a file with several tags could shrink its filename down to nothing; the filename now keeps a minimum width and the tag list clips instead
+
+---
+
 ## [1.0.1] - 2026-07-08
 
 ### Added

From e6551a723c04ff2efeb649ba97439a9d8340311c Mon Sep 17 00:00:00 2001
From: moilstack <moilstack.tech@gmail.com>
Date: Tue, 14 Jul 2026 13:35:05 +0530
Subject: [PATCH 04/14] Replace custom AI undo stack with native browser undo

Replace the custom AI undo stack mechanism with the browser's native execCommand('insertText') API. This allows Ctrl+Z to chain with user typing history instead of resetting the undo chain.

Key changes:
- Remove aiUndoStack and _snapshotUndo in favor of replaceRangeNative() and setEditorContentNative()
- New _minimalDiff() computes the smallest changed range to ensure full-document edits land in native undo history
- Update all toolbar, context-menu, AI, and find-replace operations to use the new native undo functions
- Improve focus management in chat panel so Ctrl+Z targets the editor after AI edits
- Always show "Untitled (unsaved)" row in recents panel for one-click access to blank documents

Fixes context-menu formatting and AI edits being undoable with Ctrl+Z.
---
 CHANGELOG.md                      |   1 +
 src/renderer/chatPanel.js         |  36 ++++--
 src/renderer/editorCore.js        | 182 ++++++++++++++----------------
 src/renderer/fileTreeManager.js   |   1 -
 src/renderer/findReplaceWidget.js |   5 +-
 src/renderer/index.js             |   8 +-
 src/renderer/recentsPanel.js      |  15 ++-
 src/renderer/tableBuilder.js      |   9 +-
 src/renderer/tagModal.js          |   7 +-
 9 files changed, 132 insertions(+), 132 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c637de5..bb80ed6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -24,6 +24,7 @@ All notable new features and critical fixes for MoilStack .md.
 ### Fixed
 - **Ctrl+Z not undoing context-menu formatting actions** — Bold, Italic, Strikethrough, headings, lists, blockquote, code block, and table insert now push an undo snapshot before editing, so Ctrl+Z correctly reverts them (previously these used a text-insertion method that the browser's native undo history didn't track)
 - **Long tag lists squeezing the filename out of view** — in Root folder only Explorer mode, a file with several tags could shrink its filename down to nothing; the filename now keeps a minimum width and the tag list clips instead
+- **"Untitled (unsaved)" row disappearing after Save As** — the Recent Files sidebar now always shows an "Untitled (unsaved)" row, so there's a one-click way back to a blank document after saving instead of having to press Ctrl+N again
 
 ---
 
diff --git a/src/renderer/chatPanel.js b/src/renderer/chatPanel.js
index aca6e02..76ccfe3 100644
--- a/src/renderer/chatPanel.js
+++ b/src/renderer/chatPanel.js
@@ -696,7 +696,7 @@ const ChatPanel = (() => {
     if (!row) return;
     const newContent = row.dataset.aiText;
     if (!newContent) return;
-    _deps.setEditorContentUndoable(newContent);
+    _deps.setEditorContentNative(newContent);
     _deps.saveFile();
   }
 
@@ -711,7 +711,7 @@ const ChatPanel = (() => {
     if (!row) return;
     const before = row.dataset.beforeText;
     if (before === undefined || before === null) return;
-    _deps.setEditorContentUndoable(before);
+    _deps.setEditorContentNative(before);
     _deps.saveFile();
     const origHTML = btn.innerHTML;
     btn.textContent = '✓ Restored';
@@ -787,10 +787,19 @@ const ChatPanel = (() => {
     if (sendBtn)   sendBtn.disabled   = true;
     if (chatInput) chatInput.disabled = true;
 
-    /** Re-enable input — called in all exit paths (success, error, no-model). */
-    function _reenableInput() {
+    /**
+     * Re-enable input — called in all exit paths (success, error, no-model).
+     * @param {boolean} [focusChatInput=true]  Pass false after a document/block
+     *   edit was just applied — the edit already focused the editor so that
+     *   Ctrl+Z operates on it, and stealing focus back to the chat box here
+     *   would make Ctrl+Z target the chat textarea's own undo history instead.
+     */
+    function _reenableInput(focusChatInput = true) {
       if (sendBtn)   sendBtn.disabled   = false;
-      if (chatInput) { chatInput.disabled = false; chatInput.focus(); }
+      if (chatInput) {
+        chatInput.disabled = false;
+        if (focusChatInput) chatInput.focus();
+      }
     }
 
     // 5. Build messages array — rules first, then file context appended at the end
@@ -884,6 +893,11 @@ const ChatPanel = (() => {
         // Priority: BLOCK_EDIT (selection active) → DOC_EDIT → conversational
         const blockContent = capturedSelection ? extractBlockEdit(fullResponse) : null;
         const docContent   = blockContent === null ? extractDocEdit(fullResponse) : null;
+        // Any of the three edit paths below focuses the editor via
+        // replaceRangeNative()/setEditorContentNative() — keep focus there
+        // afterward (see _reenableInput) so Ctrl+Z targets the editor.
+        const editorWasEdited = blockContent !== null || docContent !== null
+          || (!isAskMode && capturedSelection);
 
         if (blockContent !== null) {
           // ── BLOCK EDIT path ──────────────────────────────────────────
@@ -897,7 +911,7 @@ const ChatPanel = (() => {
           if (!origEndsNL && replacement.endsWith('\n'))  replacement = replacement.slice(0, -1);
 
           if (editor) {
-            editor.setRangeText(replacement, blockStart, blockEnd, 'end');
+            _deps.replaceRangeNative(blockStart, blockEnd, replacement);
             _deps.updateStats();
             _deps.updateHighlight();
             _deps.triggerUpdate();
@@ -937,10 +951,12 @@ const ChatPanel = (() => {
             streaming.row.dataset.beforeText = editorContent;
           }
 
-          // ③ Apply the AI edit — through the native undo stack so Ctrl+Z works
+          // ③ Apply the AI edit via the browser's native undo stack (execCommand
+          //    'insertText') rather than a direct .value assign, so Ctrl+Z chains
+          //    back through the user's own prior typing instead of stopping here.
           const editor = _deps.getEditor();
           if (editor) {
-            _deps.setEditorContentUndoable(docContent);
+            _deps.setEditorContentNative(docContent);
             _deps.saveFile();
           }
 
@@ -978,7 +994,7 @@ const ChatPanel = (() => {
             if (origEndsNL && !replacement.endsWith('\n'))  replacement += '\n';
             if (!origEndsNL && replacement.endsWith('\n'))  replacement = replacement.slice(0, -1);
 
-            editor.setRangeText(replacement, blockStart, blockEnd, 'end');
+            _deps.replaceRangeNative(blockStart, blockEnd, replacement);
             _deps.updateStats();
             _deps.updateHighlight();
             _deps.triggerUpdate();
@@ -1028,7 +1044,7 @@ const ChatPanel = (() => {
         updateChatCount();
         updateTokenEstimate();
         scrollChatToBottom();
-        _reenableInput();
+        _reenableInput(!editorWasEdited);
       })
       .catch((err) => {
         console.error('[sendMessage] AI error:', err);
diff --git a/src/renderer/editorCore.js b/src/renderer/editorCore.js
index f0bebbc..a2a8fcd 100644
--- a/src/renderer/editorCore.js
+++ b/src/renderer/editorCore.js
@@ -19,25 +19,6 @@ const EditorCore = (() => {
      Private state
      ═══════════════════════════════════════════════════════════════════ */
 
-  /**
-   * Stack of full-document snapshots taken before each AI edit.
-   * Drained by the Ctrl+Z interceptor in the editor keydown handler.
-   * @type {string[]}
-   */
-  const aiUndoStack  = [];
-  const AI_UNDO_LIMIT = 20; // keep at most 20 AI-edit snapshots
-
-  /**
-   * Snapshot the editor's current value onto the undo stack before a
-   * toolbar/context-menu edit. `setRangeText` mutates the textarea directly
-   * and isn't recorded by the browser's native undo history, so without this
-   * snapshot Ctrl+Z has nothing to revert for these actions.
-   */
-  function _snapshotUndo(editor) {
-    aiUndoStack.push(editor.value);
-    if (aiUndoStack.length > AI_UNDO_LIMIT) aiUndoStack.shift();
-  }
-
   /** Heading regex — used by buildHighlight to colour heading lines. */
   const HEADING_RE = /^(#{1,6})(\s)/;
 
@@ -370,7 +351,7 @@ const EditorCore = (() => {
     );
 
     if (found && newMd !== editor.value) {
-      setEditorContentUndoable(newMd);
+      setEditorContentNative(newMd);
       _deps.markDirty();
       // Manually update just the preview — skip triggerUpdate() debounce so the
       // checkbox toggle feels instant.
@@ -427,25 +408,84 @@ const EditorCore = (() => {
   }
 
   /* ═══════════════════════════════════════════════════════════════════
-     AI undo stack
+     Native undo-recorded content replacement
      ═══════════════════════════════════════════════════════════════════ */
 
   /**
-   * Replace the entire editor content and push a snapshot to the AI undo stack.
-   * Goes through direct assignment so it targets the correct element every time.
+   * Replace a range of the editor content via document.execCommand('insertText', ...)
+   * instead of direct `.value =`/`setRangeText()` mutation, so the change lands in
+   * the textarea's native undo/redo history and chains with the user's own
+   * keystroke history. jsdom (used by the Jest test environment) has no
+   * execCommand implementation, so this falls back to direct slicing there.
    *
-   * @param {string} content  New content to place in the editor.
+   * @param {number} start        Range start offset.
+   * @param {number} end          Range end offset.
+   * @param {string} replacement  Text to place in [start, end).
    */
-  function setEditorContentUndoable(content) {
+  function replaceRangeNative(start, end, replacement) {
     const editor = _deps.getEditor ? _deps.getEditor() : null;
     if (!editor) return;
 
-    // Push current content onto the AI undo stack before overwriting
-    aiUndoStack.push(editor.value);
-    if (aiUndoStack.length > AI_UNDO_LIMIT) aiUndoStack.shift(); // cap size
-
-    editor.value = content;
     editor.focus();
+
+    // True no-op (nothing selected, nothing to insert) — skip execCommand
+    // entirely. Calling it anyway would still push an empty edit onto the
+    // native undo stack, forcing an extra Ctrl+Z press to skip past it
+    // before reaching any real prior edit.
+    if (start === end && replacement === '') return;
+
+    editor.setSelectionRange(start, end);
+    let applied = false;
+    try { applied = document.execCommand('insertText', false, replacement); }
+    catch (_) { applied = false; }
+    if (!applied) {
+      editor.value = editor.value.slice(0, start) + replacement + editor.value.slice(end);
+      const caret = start + replacement.length;
+      editor.setSelectionRange(caret, caret);
+      editor.dispatchEvent(new Event('input', { bubbles: true }));
+    }
+  }
+
+  /**
+   * Find the smallest [start, end) range in `oldStr` that differs from `newStr`,
+   * by trimming the longest common prefix and suffix. Selecting-and-replacing
+   * the *entire* buffer via execCommand doesn't reliably chain into the native
+   * undo history the way a small, localized edit does — so full-document
+   * replacements are turned into the minimal underlying patch before applying.
+   *
+   * @param {string} oldStr
+   * @param {string} newStr
+   * @returns {{start: number, end: number, replacement: string}}
+   */
+  function _minimalDiff(oldStr, newStr) {
+    const maxCommon = Math.min(oldStr.length, newStr.length);
+    let start = 0;
+    while (start < maxCommon && oldStr[start] === newStr[start]) start++;
+
+    let oldEnd = oldStr.length;
+    let newEnd = newStr.length;
+    while (oldEnd > start && newEnd > start && oldStr[oldEnd - 1] === newStr[newEnd - 1]) {
+      oldEnd--;
+      newEnd--;
+    }
+
+    return { start, end: oldEnd, replacement: newStr.slice(start, newEnd) };
+  }
+
+  /**
+   * Replace the editor content with `content`, patching only the minimal
+   * changed range (via replaceRangeNative) so full-document edits (AI edits,
+   * checkbox toggles, tag edits, find/replace-all) chain into the browser's
+   * native undo/redo history instead of resetting it.
+   *
+   * @param {string} content  New content to place in the editor.
+   */
+  function setEditorContentNative(content) {
+    const editor = _deps.getEditor ? _deps.getEditor() : null;
+    if (!editor) return;
+
+    const { start, end, replacement } = _minimalDiff(editor.value, content);
+    replaceRangeNative(start, end, replacement);
     updateStats();
     updateHighlight();
     triggerUpdate();
@@ -463,11 +503,7 @@ const EditorCore = (() => {
     if (!ta) return;
     const start = ta.selectionStart, end = ta.selectionEnd;
     const sel = ta.value.substring(start, end);
-    _snapshotUndo(ta);
-    ta.focus();
-    ta.setSelectionRange(start, end);
-    ta.setRangeText(before + sel + after, start, end, 'end');
-    ta.dispatchEvent(new Event('input', { bubbles: true }));
+    replaceRangeNative(start, end, before + sel + after);
     ta.setSelectionRange(start + before.length, start + before.length + sel.length);
     updateStats();
   }
@@ -480,11 +516,7 @@ const EditorCore = (() => {
     if (!ta) return;
     const start     = ta.selectionStart;
     const lineStart = ta.value.lastIndexOf('\n', start - 1) + 1;
-    _snapshotUndo(ta);
-    ta.focus();
-    ta.setSelectionRange(lineStart, lineStart);
-    ta.setRangeText(prefix, lineStart, lineStart, 'end');
-    ta.dispatchEvent(new Event('input', { bubbles: true }));
+    replaceRangeNative(lineStart, lineStart, prefix);
     ta.setSelectionRange(start + prefix.length, start + prefix.length);
     updateStats();
   }
@@ -499,11 +531,7 @@ const EditorCore = (() => {
     const end      = editor.selectionEnd;
     const selected = editor.value.slice(start, end) || placeholder;
     const insertion = before + selected + after;
-    _snapshotUndo(editor);
-    editor.focus();
-    editor.setSelectionRange(start, end);
-    editor.setRangeText(insertion, start, end, 'end');
-    editor.dispatchEvent(new Event('input', { bubbles: true }));
+    replaceRangeNative(start, end, insertion);
     editor.setSelectionRange(start + before.length, start + before.length + selected.length);
     triggerUpdate();
   }
@@ -531,11 +559,7 @@ const EditorCore = (() => {
       : lines.map(l => prefix + l).join('\n');
 
     const realEnd = lineEnd === -1 ? val.length : lineEnd;
-    _snapshotUndo(editor);
-    editor.focus();
-    editor.setSelectionRange(lineStart, realEnd);
-    editor.setRangeText(newBlock, lineStart, realEnd, 'end');
-    editor.dispatchEvent(new Event('input', { bubbles: true }));
+    replaceRangeNative(lineStart, realEnd, newBlock);
     editor.setSelectionRange(lineStart, lineStart + newBlock.length);
     triggerUpdate();
   }
@@ -593,11 +617,7 @@ const EditorCore = (() => {
         ? lines.map((l, i) => l.slice(`${i + 1}. `.length)).join('\n')
         : lines.map((l, i) => `${i + 1}. ${l}`).join('\n');
       const realEnd = lineEnd === -1 ? val.length : lineEnd;
-      _snapshotUndo(editor);
-      editor.focus();
-      editor.setSelectionRange(lineStart, realEnd);
-      editor.setRangeText(newBlock, lineStart, realEnd, 'end');
-      editor.dispatchEvent(new Event('input', { bubbles: true }));
+      replaceRangeNative(lineStart, realEnd, newBlock);
       editor.setSelectionRange(lineStart, lineStart + newBlock.length);
       triggerUpdate();
     },
@@ -625,11 +645,7 @@ const EditorCore = (() => {
       const end      = editor.selectionEnd;
       const selected = editor.value.slice(start, end) || 'code here';
       const insertion = '```\n' + selected + '\n```';
-      _snapshotUndo(editor);
-      editor.focus();
-      editor.setSelectionRange(start, end);
-      editor.setRangeText(insertion, start, end, 'end');
-      editor.dispatchEvent(new Event('input', { bubbles: true }));
+      replaceRangeNative(start, end, insertion);
       editor.setSelectionRange(start + 4, start + 4 + selected.length);
       triggerUpdate();
     },
@@ -640,11 +656,7 @@ const EditorCore = (() => {
       const val    = editor.value;
       const before = val[pos - 1] === '\n' || pos === 0 ? '' : '\n';
       const after  = val[pos]     === '\n'              ? '' : '\n';
-      _snapshotUndo(editor);
-      editor.focus();
-      editor.setSelectionRange(pos, pos);
-      editor.setRangeText(`${before}---${after}`, pos, pos, 'end');
-      editor.dispatchEvent(new Event('input', { bubbles: true }));
+      replaceRangeNative(pos, pos, `${before}---${after}`);
       triggerUpdate();
     },
     tags: () => {
@@ -723,10 +735,6 @@ const EditorCore = (() => {
           const value    = editor.value;
           const INDENT   = '  ';
 
-          // Snapshot for Ctrl+Z undo
-          if (aiUndoStack.length >= AI_UNDO_LIMIT) aiUndoStack.shift();
-          aiUndoStack.push(value);
-
           if (selEnd > selStart) {
             // Indent every line touched by the selection
             const firstLineStart = value.lastIndexOf('\n', selStart - 1) + 1;
@@ -737,19 +745,20 @@ const EditorCore = (() => {
             const lines    = value.slice(firstLineStart, regionEnd).split('\n');
             const indented = lines.map(l => INDENT + l).join('\n');
 
-            editor.value          = value.slice(0, firstLineStart) + indented + value.slice(regionEnd);
+            replaceRangeNative(firstLineStart, regionEnd, indented);
             editor.selectionStart = selStart + INDENT.length;
             editor.selectionEnd   = selEnd + lines.length * INDENT.length;
           } else {
             // No selection: insert two spaces at the cursor
-            editor.setRangeText(INDENT, selStart, selEnd, 'end');
+            replaceRangeNative(selStart, selEnd, INDENT);
           }
-
-          editor.dispatchEvent(new Event('input', { bubbles: true }));
         }
       });
 
-      // Keyboard shortcuts: Ctrl+B, Ctrl+I, Ctrl+Z (AI undo)
+      // Keyboard shortcuts: Ctrl+B, Ctrl+I
+      // (Ctrl+Z/Ctrl+Shift+Z are left to the textarea's native undo/redo —
+      // every programmatic edit now goes through replaceRangeNative()/
+      // setEditorContentNative(), which records into that same history.)
       editor.addEventListener('keydown', e => {
         if ((e.ctrlKey || e.metaKey) && e.key === 'b') {
           e.preventDefault();
@@ -759,23 +768,6 @@ const EditorCore = (() => {
           e.preventDefault();
           TOOLBAR_ACTIONS.italic();
         }
-
-        // Ctrl+Z — AI undo takes priority over textarea's native undo.
-        // Once the AI stack is empty the event falls through to the browser
-        // so normal keystroke undo continues to work.
-        if ((e.ctrlKey || e.metaKey) && e.key === 'z' && !e.shiftKey) {
-          if (aiUndoStack.length > 0) {
-            e.preventDefault();
-            const prev = aiUndoStack.pop();
-            editor.value = prev;
-            updateStats();
-            updateHighlight();
-            triggerUpdate();
-            const filePath = deps.getCurrentFilePath ? deps.getCurrentFilePath() : null;
-            if (filePath) deps.saveFile();
-          }
-          // else: let native undo handle regular typing
-        }
       });
     }
 
@@ -815,9 +807,6 @@ const EditorCore = (() => {
 
   /* ── Public API ─────────────────────────────────────────────────── */
 
-  /** Clear the AI undo stack — must be called whenever a new file is loaded. */
-  function clearAiUndoStack() { aiUndoStack.length = 0; }
-
   return {
     init,
     updateHighlight,
@@ -825,9 +814,8 @@ const EditorCore = (() => {
     updateStats,
     triggerUpdate,
     renderMarkdown,
-    setEditorContentUndoable,
-    clearAiUndoStack,
-    snapshotUndo: _snapshotUndo,
+    setEditorContentNative,
+    replaceRangeNative,
     syncRuler,
     visualRowsForLine,
     computeMatches,
diff --git a/src/renderer/fileTreeManager.js b/src/renderer/fileTreeManager.js
index 6df9c98..6a71271 100644
--- a/src/renderer/fileTreeManager.js
+++ b/src/renderer/fileTreeManager.js
@@ -416,7 +416,6 @@ const FileTreeManager = (() => {
 
         const editor = document.getElementById('mdEditor');
         if (editor) {
-          EditorCore.clearAiUndoStack();
           editor.value     = content;
           editor.scrollTop = 0;
           const gutter = document.getElementById('line-numbers');
diff --git a/src/renderer/findReplaceWidget.js b/src/renderer/findReplaceWidget.js
index 05c5493..4ab7c3c 100644
--- a/src/renderer/findReplaceWidget.js
+++ b/src/renderer/findReplaceWidget.js
@@ -181,8 +181,7 @@ const FindReplaceWidget = (() => {
     const { start, end } = _matches[_activeIndex];
 
     SaveManager.markDirty();
-    editor.focus();
-    editor.setRangeText(replaceWith, start, end, 'end');
+    EditorCore.replaceRangeNative(start, end, replaceWith);
     EditorCore.updateStats();
 
     runSearch();
@@ -200,7 +199,7 @@ const FindReplaceWidget = (() => {
       result = result.slice(0, start) + replaceWith + result.slice(end);
     }
 
-    EditorCore.setEditorContentUndoable(result);
+    EditorCore.setEditorContentNative(result);
     SaveManager.markDirty();
     if (currentFile.path) SaveManager.saveFile();
 
diff --git a/src/renderer/index.js b/src/renderer/index.js
index 8e72a52..c889ad1 100644
--- a/src/renderer/index.js
+++ b/src/renderer/index.js
@@ -98,7 +98,6 @@ async function openFileByPath(filePath, { addToRecents = false } = {}) {
   const content = result.content ?? '';
 
   if (mdEditor) {
-    EditorCore.clearAiUndoStack();
     mdEditor.value     = content;
     mdEditor.scrollTop = 0;
     mdEditor.setSelectionRange(0, 0);
@@ -175,7 +174,6 @@ async function openRecentFile(filePath) {
   const content = result.content ?? '';
 
   if (mdEditor) {
-    EditorCore.clearAiUndoStack();
     mdEditor.value     = content;
     mdEditor.scrollTop = 0;
     mdEditor.setSelectionRange(0, 0);
@@ -221,7 +219,6 @@ async function restoreDraftFile() {
   const draft = SaveManager.getDraft();
 
   if (mdEditor) {
-    EditorCore.clearAiUndoStack();
     mdEditor.value     = draft;
     mdEditor.scrollTop = 0;
     mdEditor.setSelectionRange(0, 0);
@@ -265,7 +262,6 @@ async function openSingleFile(filePath) {
   const content = result.content ?? '';
 
   if (mdEditor) {
-    EditorCore.clearAiUndoStack();
     mdEditor.value     = content;
     mdEditor.scrollTop = 0;
     mdEditor.setSelectionRange(0, 0);
@@ -297,7 +293,6 @@ async function openSingleFile(filePath) {
  */
 function _resetToBlankUntitled() {
   if (mdEditor) {
-    EditorCore.clearAiUndoStack();
     mdEditor.value     = '';
     mdEditor.scrollTop = 0;
     mdEditor.setSelectionRange(0, 0);
@@ -579,7 +574,8 @@ document.addEventListener('DOMContentLoaded', async () => {
     getEditor:                () => document.getElementById('mdEditor'),
     getCurrentFile:           () => currentFile,
     escapeHtml:               MarkdownRenderer.escapeHtml,
-    setEditorContentUndoable: EditorCore.setEditorContentUndoable,
+    setEditorContentNative:   EditorCore.setEditorContentNative,
+    replaceRangeNative:       EditorCore.replaceRangeNative,
     saveFile:                 SaveManager.saveFile,
     updateStats:              EditorCore.updateStats,
     updateHighlight:          EditorCore.updateHighlight,
diff --git a/src/renderer/recentsPanel.js b/src/renderer/recentsPanel.js
index f877094..8cc2a11 100644
--- a/src/renderer/recentsPanel.js
+++ b/src/renderer/recentsPanel.js
@@ -110,11 +110,12 @@ const RecentsPanel = (() => {
     if (!listEl || !countEl) return;
 
     // The buffer currently loaded in the editor is untitled — show it live,
-    // whether or not it has been typed into yet. Once switched away from,
-    // its slot stays reachable (SaveManager.hasDraft()) even if it was
-    // never typed into — nothing about it should vanish silently.
+    // whether or not it has been typed into yet.
     const isLive   = !currentFile.path;
-    const showDraft = isLive || SaveManager.hasDraft();
+    // Pinned unconditionally (not just while a draft exists) so there's
+    // always a one-click way back to a blank document, even right after
+    // Save-As clears the draft and points currentFile at the saved path.
+    const showDraft = true;
 
     // Content-preview second line only in Custom mode (no folder tree to
     // provide that context) — Multi-level/Root-only stay single-line.
@@ -262,7 +263,11 @@ const RecentsPanel = (() => {
     }
 
     if (row.dataset.role === 'draft') {
-      await window.restoreDraftFile?.();
+      if (SaveManager.hasDraft()) {
+        await window.restoreDraftFile?.();   // real persisted content — restore it
+      } else {
+        await window.newUntitledFile?.();    // nothing persisted — fresh blank buffer
+      }
     } else if (row.dataset.path) {
       await window.openRecentFile?.(row.dataset.path);
     }
diff --git a/src/renderer/tableBuilder.js b/src/renderer/tableBuilder.js
index 0bda853..c864b4a 100644
--- a/src/renderer/tableBuilder.js
+++ b/src/renderer/tableBuilder.js
@@ -237,20 +237,15 @@ const TableBuilder = (() => {
     if (!editor) { _hide(); return; }
 
     editor.focus();
-    if (typeof EditorCore !== 'undefined') EditorCore.snapshotUndo(editor);
 
     if (_selStart !== null && _selEnd !== null) {
-      editor.setSelectionRange(_selStart, _selEnd);
-      editor.setRangeText(md, _selStart, _selEnd, 'end');
-      editor.dispatchEvent(new Event('input', { bubbles: true }));
+      if (typeof EditorCore !== 'undefined') EditorCore.replaceRangeNative(_selStart, _selEnd, md);
     } else {
       const pos    = editor.selectionStart;
       const val    = editor.value;
       const before = pos > 0 && val[pos - 1] !== '\n' ? '\n' : '';
       const after  = pos < val.length && val[pos] !== '\n' ? '\n' : '';
-      editor.setSelectionRange(pos, pos);
-      editor.setRangeText(before + md + after, pos, pos, 'end');
-      editor.dispatchEvent(new Event('input', { bubbles: true }));
+      if (typeof EditorCore !== 'undefined') EditorCore.replaceRangeNative(pos, pos, before + md + after);
     }
 
     if (typeof EditorCore !== 'undefined') EditorCore.triggerUpdate();
diff --git a/src/renderer/tagModal.js b/src/renderer/tagModal.js
index 32a416a..ed0264d 100644
--- a/src/renderer/tagModal.js
+++ b/src/renderer/tagModal.js
@@ -107,15 +107,16 @@ const TagModal = (() => {
       // cursor to the top of the file. Everything after the frontmatter
       // block (the "body") is untouched by _applyTags, so shift the caret by
       // however much the frontmatter's length changed, keeping it at the
-      // same spot in the body rather than wherever setEditorContentUndoable
-      // resets it (position 0, as a side effect of reassigning editor.value).
+      // same spot in the body rather than wherever setEditorContentNative
+      // leaves it (end of the inserted text, as a side effect of the
+      // whole-document replace).
       const cursorPos    = editor.selectionStart;
       const oldParsed    = _splitFrontmatter(oldContent);
       const oldBody      = oldParsed ? oldParsed.bodyLines.join('\n') : oldContent;
       const oldPrefixLen = oldContent.length - oldBody.length;
       const newPrefixLen = newContent.length - oldBody.length;
 
-      EditorCore.setEditorContentUndoable(newContent);
+      EditorCore.setEditorContentNative(newContent);
 
       const newCursor = cursorPos >= oldPrefixLen
         ? cursorPos + (newPrefixLen - oldPrefixLen)

From 2810749785a873550ada52cb2743ff8e984499a0 Mon Sep 17 00:00:00 2001
From: moilstack <moilstack.tech@gmail.com>
Date: Tue, 14 Jul 2026 17:39:53 +0530
Subject: [PATCH 05/14] Add GitHub release checking and notifications

Implements automatic checking for new GitHub releases on app startup. When a newer version is available, a dismissible notification appears in the top-right corner with a link to the release page. Also adds version display to the status bar and updates the build artifact naming convention. Version bumped to 1.1.0.
---
 package-lock.json             |  4 +--
 package.json                  |  5 +--
 src/main/index.js             |  3 ++
 src/main/releaseCheck.js      | 65 +++++++++++++++++++++++++++++++++++
 src/preload/index.js          |  3 ++
 src/renderer/index.html       |  8 +++++
 src/renderer/index.js         |  6 +++-
 src/renderer/releaseNotice.js | 35 +++++++++++++++++++
 src/renderer/styles.css       | 59 +++++++++++++++++++++++++++++++
 9 files changed, 183 insertions(+), 5 deletions(-)
 create mode 100644 src/main/releaseCheck.js
 create mode 100644 src/renderer/releaseNotice.js

diff --git a/package-lock.json b/package-lock.json
index 24e0352..7375ac5 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "moilstack-md",
-  "version": "1.0.0-beta.1",
+  "version": "1.1.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "moilstack-md",
-      "version": "1.0.0-beta.1",
+      "version": "1.1.0",
       "license": "MIT",
       "dependencies": {
         "katex": "^0.17.0"
diff --git a/package.json b/package.json
index f6ebb32..9dafa6f 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "moilstack-md",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Markdown editor with AI assistance by MoilStack",
   "main": "src/main/index.js",
   "scripts": {
@@ -40,7 +40,8 @@
         "nsis",
         "zip"
       ],
-      "icon": "src/assets/icon.ico"
+      "icon": "src/assets/icon.ico",
+      "artifactName": "MoilStack.md.${ext}"
     },
     "nsis": {
       "oneClick": false,
diff --git a/src/main/index.js b/src/main/index.js
index cbb2cd1..723e14c 100644
--- a/src/main/index.js
+++ b/src/main/index.js
@@ -2,6 +2,7 @@ const { app, BrowserWindow, Menu, dialog, ipcMain, protocol, net } = require('el
 const path = require('path')
 const fs   = require('fs')
 const { registerIpcHandlers, updateJumpList } = require('./ipc')
+const { startReleaseCheck } = require('./releaseCheck')
 
 // ── Window state persistence ───────────────────────────────────────────────
 // Stored in <userData>/window-state.json so it survives app restarts.
@@ -229,6 +230,8 @@ if (!gotLock) {
     // First window — pass any file/folder from the CLI args
     createWindow(getArgsFromArgv(process.argv))
 
+    startReleaseCheck()
+
     app.on('activate', () => {
       // macOS: re-create a window when dock icon is clicked and no windows exist
       if (BrowserWindow.getAllWindows().length === 0) createWindow()
diff --git a/src/main/releaseCheck.js b/src/main/releaseCheck.js
new file mode 100644
index 0000000..3edfb80
--- /dev/null
+++ b/src/main/releaseCheck.js
@@ -0,0 +1,65 @@
+const https = require('https')
+const { app, BrowserWindow } = require('electron')
+
+// "owner/repo" — used to query the GitHub Releases API and to build the
+// release page URL shown in the notification.
+const REPO = 'moilstack/moilstack-md'
+const CHECK_DELAY_MS = 5000
+
+/** Fetch the latest published (non-draft, non-prerelease) GitHub release. */
+function fetchLatestRelease() {
+  return new Promise((resolve, reject) => {
+    const req = https.get({
+      hostname: 'api.github.com',
+      path: `/repos/${REPO}/releases/latest`,
+      headers: { 'User-Agent': 'moilstack-md', Accept: 'application/vnd.github+json' },
+    }, (res) => {
+      if (res.statusCode !== 200) {
+        res.resume()
+        reject(new Error(`GitHub API responded ${res.statusCode}`))
+        return
+      }
+      let body = ''
+      res.on('data', (chunk) => { body += chunk })
+      res.on('end', () => {
+        try { resolve(JSON.parse(body)) } catch (err) { reject(err) }
+      })
+    })
+    req.on('error', reject)
+    req.setTimeout(10_000, () => req.destroy(new Error('timeout')))
+  })
+}
+
+/** True if version `a` (e.g. "1.2.0") is newer than `b`. */
+function isNewer(a, b) {
+  const pa = a.split('.').map(Number)
+  const pb = b.split('.').map(Number)
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const na = pa[i] || 0
+    const nb = pb[i] || 0
+    if (na !== nb) return na > nb
+  }
+  return false
+}
+
+async function checkForNewRelease() {
+  try {
+    const release = await fetchLatestRelease()
+    const latestVersion = String(release.tag_name || '').replace(/^v/, '')
+    if (!latestVersion || !isNewer(latestVersion, app.getVersion())) return
+
+    for (const win of BrowserWindow.getAllWindows()) {
+      win.webContents.send('release:available', { version: latestVersion, url: release.html_url })
+    }
+  } catch (err) {
+    // Offline, rate-limited, or no releases published yet — never bother the user about it.
+    console.error('[releaseCheck]', err)
+  }
+}
+
+/** Check once, a few seconds after launch (gives the window time to load first). */
+function startReleaseCheck() {
+  setTimeout(checkForNewRelease, CHECK_DELAY_MS)
+}
+
+module.exports = { startReleaseCheck }
diff --git a/src/preload/index.js b/src/preload/index.js
index 5c74886..bb553a6 100644
--- a/src/preload/index.js
+++ b/src/preload/index.js
@@ -93,6 +93,9 @@ contextBridge.exposeInMainWorld('electronAPI', {
     listModels: (host) => ipcRenderer.invoke('ollama:list-models', { host }),
   },
 
+  // Fired once, a few seconds after launch, if a newer GitHub release exists.
+  onReleaseAvailable: (cb) => ipcRenderer.on('release:available', (_e, info) => cb(info)),
+
   // ── AI Streaming ─────────────────────────────────────────────────────
   // Fire the AI request (Ollama or API backend)
   askAI: (payload) => ipcRenderer.invoke('ai:ask', payload),
diff --git a/src/renderer/index.html b/src/renderer/index.html
index 37c194e..4fb45b9 100644
--- a/src/renderer/index.html
+++ b/src/renderer/index.html
@@ -574,6 +574,13 @@ <h2 class="welcome-recent-title">Recent</h2>
           <span style="color:var(--primary);font-weight:500;">Markdown</span>
         </div>
 
+        <span class="statusbar-sep">|</span>
+
+        <!-- App version -->
+        <div class="statusbar-item">
+          <span id="sbVersion"></span>
+        </div>
+
       </div><!-- /statusbar -->
 
     </main><!-- /main-content -->
@@ -1318,6 +1325,7 @@ <h3 class="settings-section-title">File Explorer</h3>
   <script src="themeManager.js"></script>
   <script src="sidebarManager.js"></script>
   <script src="statusBar.js"></script>
+  <script src="releaseNotice.js"></script>
   <script src="saveManager.js"></script>
   <script src="welcomeScreen.js"></script>
   <script src="findReplaceWidget.js"></script>
diff --git a/src/renderer/index.js b/src/renderer/index.js
index c889ad1..61172c4 100644
--- a/src/renderer/index.js
+++ b/src/renderer/index.js
@@ -499,7 +499,11 @@ document.addEventListener('DOMContentLoaded', async () => {
   RecentsPanel.applyExplorerMode();
 
   const _version = window.electronAPI?.appVersion;
-  if (_version) document.title = `MoilStack .md ${_version}`;
+  if (_version) {
+    document.title = `MoilStack .md ${_version}`;
+    const sbVersion = document.getElementById('sbVersion');
+    if (sbVersion) sbVersion.textContent = `v${_version}`;
+  }
 
   const _openFileParam = new URLSearchParams(location.search).get('openFile');
 
diff --git a/src/renderer/releaseNotice.js b/src/renderer/releaseNotice.js
new file mode 100644
index 0000000..8308552
--- /dev/null
+++ b/src/renderer/releaseNotice.js
@@ -0,0 +1,35 @@
+/**
+ * releaseNotice.js — notifies when a newer version is published on GitHub.
+ * Just a link out to the release page; the app never downloads or installs
+ * anything itself.
+ */
+
+document.addEventListener('DOMContentLoaded', () => {
+  if (!window.electronAPI?.onReleaseAvailable) return;
+
+  window.electronAPI.onReleaseAvailable(({ version, url }) => {
+    const el = document.createElement('div');
+    el.id = 'release-notice';
+    el.className = 'release-notice';
+
+    const text = document.createElement('span');
+    text.textContent = `Version ${version} is available.`;
+
+    const viewBtn = document.createElement('button');
+    viewBtn.textContent = 'View Release';
+    viewBtn.onclick = () => window.electronAPI.openExternal(url);
+
+    const dismissBtn = document.createElement('button');
+    dismissBtn.className = 'release-notice__dismiss';
+    dismissBtn.textContent = '×';
+    dismissBtn.title = 'Dismiss';
+    dismissBtn.onclick = () => el.remove();
+
+    el.append(text, viewBtn, dismissBtn);
+    document.body.appendChild(el);
+
+    requestAnimationFrame(() => requestAnimationFrame(() => {
+      el.classList.add('release-notice--visible');
+    }));
+  });
+});
diff --git a/src/renderer/styles.css b/src/renderer/styles.css
index d27d47a..536ae5b 100644
--- a/src/renderer/styles.css
+++ b/src/renderer/styles.css
@@ -4047,6 +4047,65 @@ select.form-input {
   box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4);
 }
 
+/* ── New-release notice ───────────────────────────────────────────────
+   Shown once, a few seconds after launch, when a newer GitHub release
+   exists. Stays until dismissed — unlike focus-toast, it's an action
+   the user may want to come back to, not a transient blip.
+   ──────────────────────────────────────────────────────────────────── */
+.release-notice {
+  position: fixed;
+  top: 12px;
+  right: 12px;
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  background: var(--surface);
+  color: var(--text-secondary);
+  border: 1px solid var(--border);
+  border-left: 3px solid #6366f1;
+  border-radius: 6px;
+  padding: 8px 10px 8px 14px;
+  font-size: 12px;
+  line-height: 1.4;
+  max-width: calc(100vw - 32px);
+  z-index: 9999;
+  opacity: 0;
+  transform: translateY(-6px);
+  transition: opacity 0.18s ease, transform 0.18s ease;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.12);
+}
+
+.release-notice--visible {
+  opacity: 1;
+  transform: translateY(0);
+}
+
+.release-notice button {
+  font-size: 12px;
+  padding: 4px 10px;
+  border-radius: 4px;
+  border: 1px solid var(--border);
+  background: var(--bg);
+  color: var(--text-primary);
+  cursor: pointer;
+}
+
+.release-notice button:hover {
+  background: var(--border);
+}
+
+.release-notice__dismiss {
+  border: none;
+  background: transparent;
+  font-size: 14px;
+  padding: 2px 6px;
+  color: var(--text-secondary);
+}
+
+[data-theme="dark"] .release-notice {
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4);
+}
+
 /* ════════════════════════════════════════════════════════════════════
    Table Builder Modal
    ════════════════════════════════════════════════════════════════════ */

From 0f78c7b5e6bdfafddd299a1080a2f7a126a929aa Mon Sep 17 00:00:00 2001
From: moilstack <moilstack.tech@gmail.com>
Date: Thu, 16 Jul 2026 13:25:08 +0530
Subject: [PATCH 06/14] Add Linux CI, patch-package, and AppX patch

Add a GitHub Actions job to build and package the Electron app on Ubuntu (creates releases for tags and uploads artifacts for branch/PR builds). Add patch-package as a dev dependency and postinstall script. Include a patch (patches/app-builder-lib+24.13.3.patch) that updates AppxTarget to set Executable and EntryPoint on protocol and fileTypeAssociation extensions so packaged Appx/MSIX apps handle protocols/file associations correctly. package-lock updated accordingly.
---
 .github/workflows/build.yml           |  58 +++++-
 package-lock.json                     | 262 ++++++++++++++++++++++++++
 package.json                          |   4 +-
 patches/app-builder-lib+24.13.3.patch |  22 +++
 4 files changed, 344 insertions(+), 2 deletions(-)
 create mode 100644 patches/app-builder-lib+24.13.3.patch

diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index 6c6c895..67fb487 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -1,4 +1,4 @@
-name: Build and Package Electron App (Windows Only)
+name: Build and Package Electron App (Windows & Linux)
 
 on:
   push:
@@ -67,3 +67,59 @@ jobs:
             dist/*.zip
           retention-days: 3
           if-no-files-found: error
+
+  build-linux:
+    name: Build for Linux
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+
+      - name: Install Dependencies
+        run: npm ci
+
+      - name: Run Tests
+        run: npm test
+
+      - name: Build Frontend Assets
+        run: npm run build --if-present
+
+      # Always build without publishing — release step handles upload separately
+      - name: Package Electron App
+        run: npm run package -- --linux --publish never
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      # On version tag → create a GitHub Release and attach the built installers
+      # Tags with -beta / -alpha / -rc are automatically marked as pre-release
+      - name: Create GitHub Release
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            dist/*.AppImage
+            dist/*.deb
+          draft: false
+          prerelease: ${{ contains(github.ref, '-beta') || contains(github.ref, '-alpha') || contains(github.ref, '-rc') }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      # On branch / PR builds → upload as a temporary artifact (expires in 3 days)
+      - name: Upload Artifacts (non-release builds)
+        if: "!startsWith(github.ref, 'refs/tags/')"
+        uses: actions/upload-artifact@v4
+        with:
+          name: electron-linux-build
+          path: |
+            dist/*.AppImage
+            dist/*.deb
+          retention-days: 3
+          if-no-files-found: error
diff --git a/package-lock.json b/package-lock.json
index 7375ac5..ad8f67a 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -17,6 +17,7 @@
         "jest": "^29.7.0",
         "jest-environment-jsdom": "^29.7.0",
         "nodemon": "^3.1.14",
+        "patch-package": "^8.0.1",
         "png-to-ico": "^2.1.8",
         "sharp": "^0.33.5"
       }
@@ -1894,6 +1895,13 @@
         "node": ">=14.6"
       }
     },
+    "node_modules/@yarnpkg/lockfile": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@yarnpkg/lockfile/-/lockfile-1.1.0.tgz",
+      "integrity": "sha512-GpSwvyXOcOOlV70vbnzjj4fW5xW/FdUF6nQEt1ENy7m4ZCczi1+/buVUPAqmGfqznsORNFzUMjctTIp8a9tuCQ==",
+      "dev": true,
+      "license": "BSD-2-Clause"
+    },
     "node_modules/7zip-bin": {
       "version": "5.2.0",
       "resolved": "https://registry.npmjs.org/7zip-bin/-/7zip-bin-5.2.0.tgz",
@@ -2683,6 +2691,25 @@
         "source-map": "^0.6.0"
       }
     },
+    "node_modules/call-bind": {
+      "version": "1.0.9",
+      "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.9.tgz",
+      "integrity": "sha512-a/hy+pNsFUTR+Iz8TCJvXudKVLAnz/DyeSUo10I5yvFDQJBFU2s9uqQpoSrJlroHUKoKqzg+epxyP9lqFdzfBQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "get-intrinsic": "^1.3.0",
+        "set-function-length": "^1.2.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/call-bind-apply-helpers": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
@@ -2697,6 +2724,23 @@
         "node": ">= 0.4"
       }
     },
+    "node_modules/call-bound": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
+      "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "get-intrinsic": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/callsites": {
       "version": "3.1.0",
       "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz",
@@ -3235,6 +3279,24 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/define-data-property": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz",
+      "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-define-property": "^1.0.0",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/delayed-stream": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
@@ -3890,6 +3952,16 @@
         "node": ">=8"
       }
     },
+    "node_modules/find-yarn-workspace-root": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/find-yarn-workspace-root/-/find-yarn-workspace-root-2.0.0.tgz",
+      "integrity": "sha512-1IMnbjt4KzsQfnhnzNd8wUEgXZ44IzZaZmnLYx7D5FZlaHt2gW20Cri8Q+E/t5tIj4+epTBub+2Zxu/vNILzqQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "micromatch": "^4.0.2"
+      }
+    },
     "node_modules/foreground-child": {
       "version": "3.3.1",
       "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.1.tgz",
@@ -4185,6 +4257,19 @@
         "node": ">=8"
       }
     },
+    "node_modules/has-property-descriptors": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz",
+      "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-define-property": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/has-symbols": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
@@ -4476,6 +4561,22 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/is-docker": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-2.2.1.tgz",
+      "integrity": "sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "is-docker": "cli.js"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/is-extglob": {
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
@@ -4549,6 +4650,19 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/is-wsl": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-2.2.0.tgz",
+      "integrity": "sha512-fKzAra0rGJUUBwGBgNkHZuToZcn+TtXHpeCgmkMJMMYx1sQDYaCSyjJBSCa2nH1DGm7s3n1oBnohoVTBaN7Lww==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-docker": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
     "node_modules/isarray": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
@@ -5387,6 +5501,33 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/json-stable-stringify": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/json-stable-stringify/-/json-stable-stringify-1.3.0.tgz",
+      "integrity": "sha512-qtYiSSFlwot9XHtF9bD9c7rwKjr+RecWT//ZnPvSmEjpV5mmPOCN4j8UjY5hbjNkOwZ/jQv3J6R1/pL7RwgMsg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind": "^1.0.8",
+        "call-bound": "^1.0.4",
+        "isarray": "^2.0.5",
+        "jsonify": "^0.0.1",
+        "object-keys": "^1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/json-stable-stringify/node_modules/isarray": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/isarray/-/isarray-2.0.5.tgz",
+      "integrity": "sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/json5": {
       "version": "2.2.3",
       "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
@@ -5423,6 +5564,16 @@
         "node": ">= 10.0.0"
       }
     },
+    "node_modules/jsonify": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/jsonify/-/jsonify-0.0.1.tgz",
+      "integrity": "sha512-2/Ki0GcmuqSrgFyelQq9M05y7PS0mEwuIzrf3f1fPqkVDVRvZrPZtVSMHxdgo8Aq0sxAOb/cr2aqqA3LeWHVPg==",
+      "dev": true,
+      "license": "Public Domain",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/katex": {
       "version": "0.17.0",
       "resolved": "https://registry.npmjs.org/katex/-/katex-0.17.0.tgz",
@@ -5448,6 +5599,16 @@
         "node": ">= 12"
       }
     },
+    "node_modules/klaw-sync": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/klaw-sync/-/klaw-sync-6.0.0.tgz",
+      "integrity": "sha512-nIeuVSzdCCs6TDPTqI8w1Yre34sSq7AkZ4B3sfOBbI2CgVSB4Du4aLQijFU2+lhAFCwt9+42Hel6lQNIv6AntQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "graceful-fs": "^4.1.11"
+      }
+    },
     "node_modules/kleur": {
       "version": "3.0.3",
       "resolved": "https://registry.npmjs.org/kleur/-/kleur-3.0.3.tgz",
@@ -5945,6 +6106,16 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/object-keys": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz",
+      "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
     "node_modules/once": {
       "version": "1.4.0",
       "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
@@ -5971,6 +6142,23 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/open": {
+      "version": "7.4.2",
+      "resolved": "https://registry.npmjs.org/open/-/open-7.4.2.tgz",
+      "integrity": "sha512-MVHddDVweXZF3awtlAS+6pgKLlm/JgxZ90+/NBurBoQctVOOB/zDdVjcyPzQ+0laDGbsWgrRkflI65sQeOgT9Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-docker": "^2.0.0",
+        "is-wsl": "^2.1.1"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/p-limit": {
       "version": "3.1.0",
       "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz",
@@ -6065,6 +6253,46 @@
         "url": "https://github.com/inikulin/parse5?sponsor=1"
       }
     },
+    "node_modules/patch-package": {
+      "version": "8.0.1",
+      "resolved": "https://registry.npmjs.org/patch-package/-/patch-package-8.0.1.tgz",
+      "integrity": "sha512-VsKRIA8f5uqHQ7NGhwIna6Bx6D9s/1iXlA1hthBVBEbkq+t4kXD0HHt+rJhf/Z+Ci0F/HCB2hvn0qLdLG+Qxlw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@yarnpkg/lockfile": "^1.1.0",
+        "chalk": "^4.1.2",
+        "ci-info": "^3.7.0",
+        "cross-spawn": "^7.0.3",
+        "find-yarn-workspace-root": "^2.0.0",
+        "fs-extra": "^10.0.0",
+        "json-stable-stringify": "^1.0.2",
+        "klaw-sync": "^6.0.0",
+        "minimist": "^1.2.6",
+        "open": "^7.4.2",
+        "semver": "^7.5.3",
+        "slash": "^2.0.0",
+        "tmp": "^0.2.4",
+        "yaml": "^2.2.2"
+      },
+      "bin": {
+        "patch-package": "index.js"
+      },
+      "engines": {
+        "node": ">=14",
+        "npm": ">5"
+      }
+    },
+    "node_modules/patch-package/node_modules/slash": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/slash/-/slash-2.0.0.tgz",
+      "integrity": "sha512-ZYKh3Wh2z1PpEXWr0MpSBZ0V6mZHAQfYevttO11c51CaWjGTaadiKZ+wVt1PbMlDV5qhMFslpZCemhwOK7C89A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
     "node_modules/path-exists": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
@@ -6632,6 +6860,24 @@
         "node": ">=10"
       }
     },
+    "node_modules/set-function-length": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz",
+      "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "define-data-property": "^1.1.4",
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2",
+        "get-intrinsic": "^1.2.4",
+        "gopd": "^1.0.1",
+        "has-property-descriptors": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
     "node_modules/sharp": {
       "version": "0.33.5",
       "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.33.5.tgz",
@@ -7538,6 +7784,22 @@
       "dev": true,
       "license": "ISC"
     },
+    "node_modules/yaml": {
+      "version": "2.9.0",
+      "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.9.0.tgz",
+      "integrity": "sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "yaml": "bin.mjs"
+      },
+      "engines": {
+        "node": ">= 14.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/eemeli"
+      }
+    },
     "node_modules/yargs": {
       "version": "17.7.2",
       "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.7.2.tgz",
diff --git a/package.json b/package.json
index 9dafa6f..4b53932 100644
--- a/package.json
+++ b/package.json
@@ -8,7 +8,8 @@
     "test": "jest",
     "make-app-icon": "node build/make-app-icon.js",
     "make-file-icon": "node build/make-file-icon.js",
-    "package": "electron-builder"
+    "package": "electron-builder",
+    "postinstall": "patch-package"
   },
   "build": {
     "appId": "com.moilstack.markdown",
@@ -95,6 +96,7 @@
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
     "nodemon": "^3.1.14",
+    "patch-package": "^8.0.1",
     "png-to-ico": "^2.1.8",
     "sharp": "^0.33.5"
   },
diff --git a/patches/app-builder-lib+24.13.3.patch b/patches/app-builder-lib+24.13.3.patch
new file mode 100644
index 0000000..58ba704
--- /dev/null
+++ b/patches/app-builder-lib+24.13.3.patch
@@ -0,0 +1,22 @@
+diff --git a/node_modules/app-builder-lib/out/targets/AppxTarget.js b/node_modules/app-builder-lib/out/targets/AppxTarget.js
+index 1bb0b5f..66f36b2 100644
+--- a/node_modules/app-builder-lib/out/targets/AppxTarget.js
++++ b/node_modules/app-builder-lib/out/targets/AppxTarget.js
+@@ -233,7 +233,7 @@ class AppXTarget extends core_1.Target {
+         for (const protocol of uriSchemes) {
+             for (const scheme of (0, builder_util_1.asArray)(protocol.schemes)) {
+                 extensions += `
+-          <uap:Extension Category="windows.protocol">
++          <uap:Extension Category="windows.protocol" Executable="${executable}" EntryPoint="Windows.FullTrustApplication">
+             <uap:Protocol Name="${scheme}">
+                <uap:DisplayName>${protocol.name}</uap:DisplayName>
+              </uap:Protocol>
+@@ -243,7 +243,7 @@ class AppXTarget extends core_1.Target {
+         for (const fileAssociation of fileAssociations) {
+             for (const ext of (0, builder_util_1.asArray)(fileAssociation.ext)) {
+                 extensions += `
+-          <uap:Extension Category="windows.fileTypeAssociation">
++          <uap:Extension Category="windows.fileTypeAssociation" Executable="${executable}" EntryPoint="Windows.FullTrustApplication">
+             <uap:FileTypeAssociation Name="${ext}">
+               <uap:SupportedFileTypes>
+                 <uap:FileType>.${ext}</uap:FileType>

From 3621a1774bf42d20865173d56b0c5fac967b1ac6 Mon Sep 17 00:00:00 2001
From: moilstack <moilstack.tech@gmail.com>
Date: Thu, 16 Jul 2026 13:52:38 +0530
Subject: [PATCH 07/14] Convert Save/Export buttons to icon-only design

Refactor Save and Export buttons in the editor toolbar to use an icon-only design with larger 32x32px icons. Status feedback is now conveyed via button tooltips and toast notifications instead of changing button text. This creates a cleaner, more compact toolbar while improving accessibility with proper aria-labels.
---
 src/renderer/index.html     | 28 +++++++++++++---------------
 src/renderer/saveManager.js | 35 ++++++++++++++++++++++-------------
 src/renderer/styles.css     | 14 ++++++++++++++
 3 files changed, 49 insertions(+), 28 deletions(-)

diff --git a/src/renderer/index.html b/src/renderer/index.html
index 4fb45b9..f965841 100644
--- a/src/renderer/index.html
+++ b/src/renderer/index.html
@@ -381,8 +381,19 @@ <h2 class="welcome-recent-title">Recent</h2>
 
           <!-- Right: Export + Save buttons + Edit/Preview toggle -->
           <div class="topbar-actions">
-            <button class="btn btn-outline" id="btn-export" title="Export Markdown file">
-              <svg width="13" height="13" viewBox="0 0 24 24" fill="none"
+            <button class="icon-btn icon-btn--lg" id="btn-save" title="Save file (Ctrl+S)" aria-label="Save file">
+              <svg width="18" height="18" viewBox="0 0 13 13" fill="none"
+                   xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
+                <rect x="1" y="1" width="11" height="11" rx="1.5"
+                      stroke="currentColor" stroke-width="1.3"/>
+                <rect x="3.5" y="1" width="4" height="3.5" rx=".5"
+                      fill="currentColor" stroke="none"/>
+                <rect x="2.5" y="7" width="8" height="4" rx=".8"
+                      stroke="currentColor" stroke-width="1.2"/>
+              </svg>
+            </button>
+            <button class="icon-btn icon-btn--lg" id="btn-export" title="Export Markdown file" aria-label="Export Markdown file">
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none"
                    xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
                 <path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"
                       stroke="currentColor" stroke-width="2"
@@ -394,19 +405,6 @@ <h2 class="welcome-recent-title">Recent</h2>
                       stroke="currentColor" stroke-width="2"
                       stroke-linecap="round"/>
               </svg>
-              <span>Export</span>
-            </button>
-            <button class="btn btn-primary" id="btn-save" title="Save file (Ctrl+S)">
-              <svg width="13" height="13" viewBox="0 0 13 13" fill="none"
-                   xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
-                <rect x="1" y="1" width="11" height="11" rx="1.5"
-                      stroke="currentColor" stroke-width="1.3"/>
-                <rect x="3.5" y="1" width="4" height="3.5" rx=".5"
-                      fill="currentColor" stroke="none"/>
-                <rect x="2.5" y="7" width="8" height="4" rx=".8"
-                      stroke="currentColor" stroke-width="1.2"/>
-              </svg>
-              <span>Save</span>
             </button>
           </div>
 
diff --git a/src/renderer/saveManager.js b/src/renderer/saveManager.js
index 4ac7137..64e3d9b 100644
--- a/src/renderer/saveManager.js
+++ b/src/renderer/saveManager.js
@@ -171,7 +171,7 @@ const SaveManager = (() => {
 
   /* ── Manual save ──────────────────────────────────────────────────── */
 
-  const FLOPPY_SVG = `<svg width="13" height="13" viewBox="0 0 13 13" fill="none"
+  const FLOPPY_SVG = `<svg width="18" height="18" viewBox="0 0 13 13" fill="none"
      xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
   <rect x="1" y="1" width="11" height="11" rx="1.5"
         stroke="currentColor" stroke-width="1.3"/>
@@ -181,7 +181,7 @@ const SaveManager = (() => {
         stroke="currentColor" stroke-width="1.2"/>
 </svg>`;
 
-  const SPINNER_SVG = `<svg width="13" height="13" viewBox="0 0 13 13" fill="none"
+  const SPINNER_SVG = `<svg width="18" height="18" viewBox="0 0 13 13" fill="none"
      xmlns="http://www.w3.org/2000/svg" aria-hidden="true" class="spin">
   <circle cx="6.5" cy="6.5" r="5" stroke="currentColor" stroke-width="1.5"
           stroke-dasharray="22" stroke-dashoffset="10" stroke-linecap="round"/>
@@ -204,7 +204,8 @@ const SaveManager = (() => {
 
     btn.dataset.saving = '1';
     btn.disabled       = true;
-    btn.innerHTML      = `${SPINNER_SVG}<span>Saving…</span>`;
+    btn.innerHTML      = SPINNER_SVG;
+    btn.title          = 'Saving…';
 
     try {
       const result = await window.electronAPI.writeFile(filePath, content);
@@ -213,12 +214,15 @@ const SaveManager = (() => {
       markClean();
       _updateSidebarPreview(filePath, content);
       FileTreeManager.touchFile(filePath, _extractFirstLine(content));
-      btn.innerHTML = `<span>✓ Saved</span>`;
-      setTimeout(() => { btn.innerHTML = `${FLOPPY_SVG}<span>Save</span>`; }, 1500);
+      btn.innerHTML = FLOPPY_SVG;
+      btn.title     = 'Saved';
+      StatusBar.showToast(`Saved "${currentFile.name}" successfully.`);
+      setTimeout(() => { btn.title = 'Save file (Ctrl+S)'; }, 1500);
     } catch (err) {
       console.error('[saveFile]', err);
-      btn.innerHTML = `<span>✗ Error</span>`;
-      setTimeout(() => { btn.innerHTML = `${FLOPPY_SVG}<span>Save</span>`; }, 2000);
+      btn.innerHTML = FLOPPY_SVG;
+      btn.title     = `Save failed: ${err.message}`;
+      setTimeout(() => { btn.title = 'Save file (Ctrl+S)'; }, 2000);
       StatusBar.showToast(`Save failed: ${err.message}`);
     } finally {
       btn.disabled = false;
@@ -339,19 +343,24 @@ const SaveManager = (() => {
 <body>${bodyHtml}</body>
 </html>`;
 
-    const origHTML = btn ? btn.innerHTML : '';
-    if (btn) { btn.disabled = true; btn.innerHTML = '<span>Exporting…</span>'; }
+    const origTitle = btn ? btn.title : '';
+    const origHTML  = btn ? btn.innerHTML : '';
+    if (btn) { btn.disabled = true; btn.title = 'Exporting…'; btn.innerHTML = SPINNER_SVG; }
 
     try {
       const result = await window.electronAPI.exportPdf(html, filename);
-      if (result?.canceled) return;
+      if (result?.canceled) { if (btn) { btn.title = origTitle; btn.innerHTML = origHTML; } return; }
       if (!result?.ok) throw new Error(result?.error || 'Unknown error');
-      if (btn) { btn.innerHTML = '<span>✓ Exported</span>'; }
-      setTimeout(() => { if (btn) { btn.disabled = false; btn.innerHTML = origHTML; } }, 1800);
+      if (btn) { btn.title = 'Exported'; btn.innerHTML = origHTML; }
+      const pdfName = filename.replace(/\.md$/i, '') + '.pdf';
+      StatusBar.showToast(`Exported "${pdfName}" successfully.`);
+      setTimeout(() => { if (btn) { btn.title = origTitle; } }, 1800);
     } catch (err) {
       console.error('[exportFile]', err);
+      if (btn) { btn.title = origTitle; btn.innerHTML = origHTML; }
       alert(`Export failed: ${err.message}`);
-      if (btn) { btn.disabled = false; btn.innerHTML = origHTML; }
+    } finally {
+      if (btn) { btn.disabled = false; }
     }
   }
 
diff --git a/src/renderer/styles.css b/src/renderer/styles.css
index 536ae5b..12e6931 100644
--- a/src/renderer/styles.css
+++ b/src/renderer/styles.css
@@ -737,6 +737,12 @@ body {
   pointer-events: none;
 }
 
+/* Larger icon-only variant (e.g. Export/Save in the editor toolbar) */
+.icon-btn--lg {
+  width: 32px;
+  height: 32px;
+}
+
 /* ── 2. Folder row ───────────────────────────────────────────────── */
 .folder-row {
   display: flex;
@@ -1536,6 +1542,14 @@ body {
   background: #c9302c;
 }
 
+.btn-warning {
+  background: #f0ad4e;
+  color: #ffffff;
+}
+.btn-warning:hover {
+  background: #ec971f;
+}
+
 .delete-confirm-message {
   margin: 0 0 8px;
   font-size: 13px;

From 00ccde093e71f504b68a685e9d817762457d5f9f Mon Sep 17 00:00:00 2001
From: moilstack <moilstack.tech@gmail.com>
Date: Fri, 17 Jul 2026 11:37:48 +0530
Subject: [PATCH 08/14] Fix underscore emphasis word boundaries

Update markdown renderer to respect CommonMark intraword-emphasis rule. Add negative lookahead/lookbehind assertions to underscore emphasis patterns to prevent mid-word underscores from triggering emphasis.

This fixes cases where identifiers like `debt_summary_table` would have underscores incorrectly processed, leaving parts of the name italicized.
---
 src/renderer/markdownRenderer.js | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/src/renderer/markdownRenderer.js b/src/renderer/markdownRenderer.js
index dc6a12c..b7751f3 100644
--- a/src/renderer/markdownRenderer.js
+++ b/src/renderer/markdownRenderer.js
@@ -76,13 +76,16 @@ const MarkdownRenderer = (() => {
     s = s
       // Bold + italic (***text***)
       .replace(/\*\*\*(.+?)\*\*\*/g,  '<strong><em>$1</em></strong>')
-      .replace(/___(.+?)___/g,         '<strong><em>$1</em></strong>')
+      .replace(/(?<!\w)___(.+?)___(?!\w)/g, '<strong><em>$1</em></strong>')
       // Bold (**text**)
       .replace(/\*\*(.+?)\*\*/g,       '<strong>$1</strong>')
-      .replace(/__(.+?)__/g,            '<strong>$1</strong>')
+      .replace(/(?<!\w)__(.+?)__(?!\w)/g,   '<strong>$1</strong>')
       // Italic (*text*)
       .replace(/\*([^*\n]+?)\*/g,       '<em>$1</em>')
-      .replace(/_([^_\n]+?)_/g,         '<em>$1</em>')
+      // Underscore italic — unlike *, _ must NOT trigger mid-word (CommonMark
+      // intraword-emphasis rule), otherwise identifiers like debt_summary_table
+      // get their underscores eaten and part of the name turned italic.
+      .replace(/(?<!\w)_([^_\n]+?)_(?!\w)/g, '<em>$1</em>')
       // Strikethrough (~~text~~)
       .replace(/~~(.+?)~~/g,            '<del>$1</del>')
       // Inline code (`code`) — input is already HTML-escaped by the caller, no double-escape

From 952605c69209169f79e635016c7c1cdee79bcc57 Mon Sep 17 00:00:00 2001
From: moilstack <moilstack.tech@gmail.com>
Date: Sat, 18 Jul 2026 16:50:52 +0530
Subject: [PATCH 09/14] Update ipcHandlers.test.js

---
 tests/ipcHandlers.test.js | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/ipcHandlers.test.js b/tests/ipcHandlers.test.js
index 7d81e77..db592bb 100644
--- a/tests/ipcHandlers.test.js
+++ b/tests/ipcHandlers.test.js
@@ -24,7 +24,7 @@ const path = require('path');
  * Returns basename only (no parent-dir escapes).
  */
 function sanitizeFilename(fileName) {
-  const safeName = path.basename(fileName.trim());
+  const safeName = path.win32.basename(fileName.trim());
   if (!safeName) throw new Error('Invalid filename.');
   return safeName;
 }
@@ -42,7 +42,7 @@ function ensureMarkdownExt(fileName) {
  * Format: originalname_ISO-TIMESTAMP.md
  */
 function generateBackupPath(filePath) {
-  const basename = path.basename(filePath, path.extname(filePath));
+  const basename = path.win32.basename(filePath, path.win32.extname(filePath));
   const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
   return `${basename}_${timestamp}.md`;
 }

From 87f07e8a7a0b4d231a8685061b360f16d9b13adc Mon Sep 17 00:00:00 2001
From: moilstack <moilstack.tech@gmail.com>
Date: Sat, 18 Jul 2026 16:54:53 +0530
Subject: [PATCH 10/14] Update package.json

---
 package.json | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/package.json b/package.json
index 4b53932..df70e56 100644
--- a/package.json
+++ b/package.json
@@ -24,11 +24,7 @@
     },
     "fileAssociations": [
       {
-        "ext": [
-          "md",
-          "markdown",
-          "txt"
-        ],
+        "ext": "md",
         "name": "Markdown File",
         "description": "Markdown Document",
         "icon": "src/assets/file-icon-md",

From d03f47fc8e630c9ef1330b6f7bc18a015a381f93 Mon Sep 17 00:00:00 2001
From: moilstack <moilstack.tech@gmail.com>
Date: Sat, 18 Jul 2026 16:59:21 +0530
Subject: [PATCH 11/14] Add maintainer info to Linux builds

Adds maintainer metadata to the Electron Linux build configuration (AppImage and deb packages). This field specifies the package maintainer contact information for Linux distributions.
---
 package.json | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/package.json b/package.json
index df70e56..fc5cef1 100644
--- a/package.json
+++ b/package.json
@@ -68,7 +68,8 @@
       "target": [
         "AppImage",
         "deb"
-      ]
+      ],
+      "maintainer": "MoilStack <support@moilstack.com>"
     }
   },
   "keywords": [

From 60020512e1b5cfd98c562069c7bde229cf4ff5c4 Mon Sep 17 00:00:00 2001
From: moilstack <moilstack.tech@gmail.com>
Date: Sat, 18 Jul 2026 20:09:27 +0530
Subject: [PATCH 12/14] Update README.md and add AI setup guide for local and
 cloud configurations

---
 AI_SETUP.md |  61 +++++++++++++++++++++
 README.md   | 151 +++++++---------------------------------------------
 2 files changed, 79 insertions(+), 133 deletions(-)
 create mode 100644 AI_SETUP.md

diff --git a/AI_SETUP.md b/AI_SETUP.md
new file mode 100644
index 0000000..b5b583c
--- /dev/null
+++ b/AI_SETUP.md
@@ -0,0 +1,61 @@
+# AI Configuration & Model Setup Guide
+
+MoilStack .md uses the standard OpenAI Chat Completions API format for its AI capabilities. This guide provides detailed instructions on configuring both cloud infrastructure and local offline models[cite: 1].
+
+---
+
+## Cloud API Providers
+
+To connect a cloud provider, navigate to **Settings** (⚙ gear icon) → **AI Models** → **Add Model**, choose a provider type, and input your credentials[cite: 1].
+
+| Provider | Base URL | Free Tier Details |
+|---|---|---|
+| [Groq](https://console.groq.com) | `https://api.groq.com/openai/v1` | ✅ No credit card required[cite: 1] |
+| [Google Gemini](https://aistudio.google.com/app/apikey) | `https://generativelanguage.googleapis.com/v1beta/openai/` | ✅ Free tier available[cite: 1] |
+| [OpenRouter](https://openrouter.ai/keys) | `https://openrouter.ai/api/v1` | ✅ Free models available (append `:free`)[cite: 1] |
+| [Mistral](https://console.mistral.ai) | `https://api.mistral.ai/v1` | ✅ Free tier available[cite: 1] |
+| [Together AI](https://api.together.ai) | `https://api.together.xyz/v1` | ✅ $1 credit on signup[cite: 1] |
+| [OpenAI](https://platform.openai.com/api-keys) | `https://api.openai.com/v1` | Paid tier only[cite: 1] |
+
+---
+
+## Local Ollama Setup (Fully Private)
+
+For maximum data privacy, you can run large language models completely local to your machine with zero data leakage[cite: 1].
+
+1. Download and install the core framework from [ollama.com/download](https://ollama.com/download)[cite: 1].
+2. Open your local terminal window and pull your preferred model[cite: 1]. We highly recommend running `ollama pull qwen2.5:7b` or `ollama pull llama3.2`[cite: 1].
+3. Inside MoilStack .md, open the Settings menu, add a new model with the type set to **Ollama**, and click **Detect** to auto-discover your active local engines[cite: 1].
+
+> *Note: Running local models under 7B parameters may yield less reliable results when processing strict inline document edits[cite: 1].*
+
+---
+
+## Recommended Models
+
+| Model Name | Integration Provider | Editing Accuracy | Speed Metrics |
+|---|---|---|---|
+| `llama-3.3-70b-versatile` | Groq (Free) | ⭐⭐⭐⭐⭐ | Ultra Fast[cite: 1] |
+| `gemini-2.0-flash` | Google (Free) | ⭐⭐⭐⭐⭐ | Exceptionally Fast[cite: 1] |
+| `gpt-4o-mini` | OpenAI (Paid) | ⭐⭐⭐⭐⭐ | Fast[cite: 1] |
+| `qwen2.5:7b` | Ollama (Local) | ⭐⭐⭐⭐ | Medium[cite: 1] |
+| `llama3.2` | Ollama (Local) | ⭐⭐⭐ | Fast[cite: 1] |
+
+---
+
+## Core Provider Compatibility
+
+| Provider Integration | Support Status | Architecture Notes |
+|---|---|---|
+| Groq | ✅ Fully Supported | Standard OpenAI format integration with free options[cite: 1]. |
+| OpenAI | ✅ Fully Supported | Native standard compatibility[cite: 1]. |
+| Together AI | ✅ Fully Supported | Native standard compatibility[cite: 1]. |
+| Mistral AI | ✅ Fully Supported | Native standard compatibility[cite: 1]. |
+| OpenRouter | ✅ Fully Supported | Native standard compatibility[cite: 1]. |
+| Google Gemini | ✅ Fully Supported | Accessible via standard OpenAI-compatible endpoints[cite: 1]. |
+| Cerebras | ✅ Fully Supported | Native standard compatibility[cite: 1]. |
+| Perplexity | ✅ Fully Supported | Native standard compatibility[cite: 1]. |
+| Azure OpenAI | ⚠️ Partial Support | Utilizes a unique deployment URL layout rather than global endpoints[cite: 1]. |
+| Anthropic Claude | ❌ Not Supported | Relies on a non-standard API structure that is not yet supported[cite: 1]. |
+| AWS Bedrock | ❌ Not Supported | Demands AWS SigV4 request signatures which are not yet supported[cite: 1]. |
+| Ollama | ✅ Fully Supported | Integrated via dedicated Ollama NDJSON streaming endpoints[cite: 1]. |
\ No newline at end of file
diff --git a/README.md b/README.md
index 188d0b6..ed9a576 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,10 @@
-# MoilStack .md
+# MoilStack .md (markdown) — Privacy-First Markdown AI Editor & Viewer
 
 [![Version](https://img.shields.io/github/v/release/moilstack/moilstack-md?label=version&include_prereleases)](https://github.com/moilstack/moilstack-md/releases)
 ![Platform](https://img.shields.io/badge/platform-Windows-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
 
-A desktop Markdown editor with an integrated AI assistant, built with Electron.  
-Write and edit Markdown files with syntax highlighting, preview, and AI-powered editing — all running locally on your machine.
+An open-source desktop **Markdown AI editor** and standalone markdown viewer built with Electron. Write, edit, and view Markdown files with syntax highlighting, live split-pane preview, and an integrated local AI assistant — all running privately on your machine.
 
 ---
 
@@ -73,83 +72,32 @@ Output goes to the `dist/` folder. Targets: NSIS/ZIP (Windows), DMG/ZIP (macOS),
 
 ## AI Assistant Setup
 
-Open **Settings** (⚙ gear icon) → **AI Models** → **Add Model** and choose a provider type.
+MoilStack .md relies on the standard OpenAI Chat Completions API architectural design, allowing you to instantly deploy powerful cloud models or execute complex workflows completely offline.
 
-### Cloud API
+### Flexible Deployment Options
+* **Fully Offline & Private:** Protect sensitive information by running local text operations straight on your machine through **Ollama**.
+* **High-Speed Cloud API Infrastructure:** Connect native accounts from **Google Gemini**, **Groq**, **OpenAI**, **Mistral**, or **Together AI**.
 
-Any OpenAI-compatible provider works. Enter the Base URL, your API key, and a model name, then save.
+For definitive step-by-step setup guides, free tier account endpoint links, local model terminal scripts, and detailed performance matrices, see our dedicated [AI Configuration & Model Setup Guide](AI_SETUP.md).
 
-| Provider | Base URL | Free? |
-|---|---|---|
-| [Groq](https://console.groq.com) | `https://api.groq.com/openai/v1` | ✅ No credit card |
-| [Google Gemini](https://aistudio.google.com/app/apikey) | `https://generativelanguage.googleapis.com/v1beta/openai/` | ✅ Free tier |
-| [OpenRouter](https://openrouter.ai/keys) | `https://openrouter.ai/api/v1` | ✅ Free models (append `:free`) |
-| [Mistral](https://console.mistral.ai) | `https://api.mistral.ai/v1` | ✅ Free tier |
-| [Together AI](https://api.together.ai) | `https://api.together.xyz/v1` | ✅ $1 credit on signup |
-| [OpenAI](https://platform.openai.com/api-keys) | `https://api.openai.com/v1` | Paid |
-
-### Ollama (local, fully private)
-
-1. Install from [ollama.com/download](https://ollama.com/download)
-2. Pull a model: `ollama pull qwen2.5:7b` (recommended) or `ollama pull llama3.2`
-3. In Settings, add a model with type **Ollama** and click **Detect** to find running models
-
-> Models below 7B parameters may not follow the document editing format reliably.
-
-### Recommended models
-
-| Model | Provider | Doc Editing | Speed |
-|---|---|---|---|
-| `llama-3.3-70b-versatile` | Groq (free) | ⭐⭐⭐⭐⭐ | Fast |
-| `gemini-2.0-flash` | Google (free) | ⭐⭐⭐⭐⭐ | Very fast |
-| `gpt-4o-mini` | OpenAI (paid) | ⭐⭐⭐⭐⭐ | Fast |
-| `qwen2.5:7b` | Ollama | ⭐⭐⭐⭐ | Medium |
-| `llama3.2` | Ollama | ⭐⭐⭐ | Fast |
-
----
 
 ## Using the AI Assistant
 
-### Chat basics
-
-- Type a prompt in the chat panel on the right and press **Enter** (or click the send button)
-- Use **Alt+Enter** to insert a newline in your prompt
+MoilStack .md acts as an interactive markdown AI editor, allowing you to seamlessly communicate text changes directly to your local workspace.
 
-### Document editing
+### Document Editing & Refinement
+Simply ask the AI assistant to modify your active file text:
+* "Fix the grammar and layout flow in this document"
+* "Add a clean summary section right at the top"
+* "Convert this raw text paragraph into a clear bulleted list"
 
-Ask the AI to modify your document:
+When the AI assistant processes an edit, changes are applied silently and instantly into the editor pane. A structural summary of the modifications appears inside the chat window.
 
-```
-Fix the grammar in this document
-Add a summary section at the top
-Convert this to use bullet points
-Make the introduction more concise
-```
-
-When the AI makes a document edit:
-- Changes are **applied silently and instantly** — no streaming wall of text
-- A summary of what changed appears in the chat bubble
-- Use the **Undo** button (↺) on the bubble to revert, or press `Ctrl+Z`
-- Use the **Re-apply** button (↻) to reapply the last undone edit
-- A backup is saved to `.markflow/backups/` before every AI edit
-
-### Informational questions
-
-Ask anything about writing, Markdown, or your document:
-
-```
-What's the difference between a blockquote and a code block?
-How do I create a table in Markdown?
-Summarise what this document is about
-```
+### Safety & Version Controls
+* **Instant Undo:** Every single document modification made by the AI can be instantly reversed using the UI Undo button (↺) or by pressing `Ctrl+Z`.
+* **Automatic Snapshots:** For absolute safety, MoilStack .md saves automatic file backups to the active directory's `<your-folder>/.markflow/backups/` directory before any AI processing occurs.
+* **Scoped Selections:** Highlight specific sentences or code lines inside the editor pane before typing a prompt to limit the AI assistant's scope exclusively to that text selection.
 
-Answers stream directly into the chat.
-
-### Line selection
-
-Select lines in the editor before sending a prompt to scope the AI's edit to just those lines.
-
----
 
 ## Keyboard Shortcuts
 
@@ -165,8 +113,6 @@ Select lines in the editor before sending a prompt to scope the AI's edit to jus
 | `Alt+Enter` | New line in chat input |
 | `Escape` | Close any open modal or dropdown |
 
----
-
 ## File Backups
 
 Every time the AI edits your document, MoilStack .md saves a backup to:
@@ -177,68 +123,7 @@ Every time the AI edits your document, MoilStack .md saves a backup to:
 
 Files are named `<filename>_<timestamp>.md` and the last **10 backups per file** are kept automatically. Use these to recover from any unwanted AI changes.
 
----
-
-## Provider Compatibility
-
-MoilStack .md uses the **OpenAI Chat Completions API format** for all API-type models. Any provider that offers an OpenAI-compatible endpoint works out of the box.
-
-| Provider | Compatible? | Notes |
-|---|---|---|
-| Groq | ✅ | Fully compatible, free tier |
-| OpenAI | ✅ | Fully compatible |
-| Together AI | ✅ | Fully compatible |
-| Mistral AI | ✅ | Fully compatible |
-| OpenRouter | ✅ | Fully compatible |
-| Google Gemini | ✅ | Via OpenAI-compatible endpoint |
-| Cerebras | ✅ | Fully compatible |
-| Perplexity | ✅ | Fully compatible |
-| Azure OpenAI | ⚠️ | Different URL structure — use the deployment-specific endpoint |
-| Anthropic Claude | ❌ | Different API format — not yet supported |
-| AWS Bedrock | ❌ | Requires AWS SigV4 signing — not yet supported |
-| Ollama | ✅ | Via built-in Ollama type (NDJSON streaming) |
 
----
-
-## Project Structure
-
-```
-moilstack-md/
-├── src/
-│   ├── main/
-│   │   ├── index.js              # Electron main process, window management
-│   │   └── ipc.js                # IPC handlers (file I/O, AI requests, config)
-│   ├── preload/
-│   │   └── index.js              # Context bridge (safe API exposure to renderer)
-│   ├── assets/
-│   │   ├── icon.png              # App icon
-│   │   └── file-icon-md.svg      # .md file association icon
-│   └── renderer/
-│       ├── index.html            # App shell
-│       ├── index.js              # Main renderer entry point
-│       ├── styles.css            # All styles
-│       ├── aiConfig.js           # AI model settings UI
-│       ├── aiService.js          # AI request dispatcher
-│       ├── chatPanel.js          # AI chat panel
-│       ├── editorCore.js         # Editor logic, undo, ruler
-│       ├── fileTreeManager.js    # File explorer tree rendering
-│       ├── fileOperations.js     # Create, rename, delete files/folders
-│       ├── markdownRenderer.js   # Markdown → HTML preview
-│       ├── saveManager.js        # Save / dirty-state tracking
-│       ├── storageManager.js     # localStorage / IPC persistence
-│       ├── tableBuilder.js       # Visual table builder modal
-│       ├── exportService.js      # PDF export
-│       └── themeManager.js       # Dark / light theme
-├── build/
-│   ├── installer.nsh             # NSIS installer customisation
-│   └── make-file-icon.js         # Icon generation script
-├── assets/                       # Screenshots and marketing assets (add here)
-├── CHANGELOG.md
-├── package.json
-└── README.md
-```
-
----
 
 ## Contributing
 

From e7a491d6b57f27fd760c43bdc7e4a113b75e60bc Mon Sep 17 00:00:00 2001
From: moilstack <moilstack.tech@gmail.com>
Date: Sat, 18 Jul 2026 20:14:52 +0530
Subject: [PATCH 13/14] Update README.md to enhance platform support details
 and clarify backup locations

---
 README.md | 29 +++++++++++++++++------------
 1 file changed, 17 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index ed9a576..49a5eb5 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,12 @@
 # MoilStack .md (markdown) — Privacy-First Markdown AI Editor & Viewer
 
 [![Version](https://img.shields.io/github/v/release/moilstack/moilstack-md?label=version&include_prereleases)](https://github.com/moilstack/moilstack-md/releases)
-![Platform](https://img.shields.io/badge/platform-Windows-blue)
+![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS%20(soon)-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
 
 An open-source desktop **Markdown AI editor** and standalone markdown viewer built with Electron. Write, edit, and view Markdown files with syntax highlighting, live split-pane preview, and an integrated local AI assistant — all running privately on your machine.
 
----
+
 
 ![MoilStack .md](assets/screenshot-editor.png)
 
@@ -17,25 +17,26 @@ Pre-built installers are available on the [Releases page](https://github.com/moi
 | Platform | Format |
 |---|---|
 | Windows | NSIS installer, portable ZIP |
-
----
+| Linux | AppImage, DEB |
+| macOS | DMG, ZIP (coming soon) |
 
 ## Features
 
 - **Dual-pane editor** — syntax-highlighted editor with Markdown preview (`Ctrl+\`` to toggle)
-- **File explorer** — browse, create, rename, and open `.md` files from a folder
+- **File explorer** — browse, create, rename, and open `.md` files from a folder, with Multi-level, Root-only, and Custom (no-folder) sidebar modes
+- **Global search** — find filenames and in-file content across the open folder (`Ctrl+Shift+F`), with tag search via `#tag` or `tag:name`
 - **AI Assistant** — ask the AI to edit your document, answer questions, or improve your writing
 - **Smart AI editing** — document edits are applied silently and instantly; informational answers stream as chat
 - **Undo AI edits** — every AI document change is reversible with the Undo button or `Ctrl+Z`
 - **Visual table builder** — insert Markdown tables with a point-and-click grid editor
-- **File labels** — colour-tag files in the explorer for quick navigation
-- **File backups** — automatic `.markflow/backups/` snapshots before every AI edit
+- **File labels & tags** — colour-tag files in the explorer for quick navigation, or add searchable tags stored in YAML frontmatter
+- **File backups** — automatic snapshots to the app's user data folder before every AI edit
+- **File trash** — delete files to the OS Recycle Bin from the context menu
 - **Multi-model support** — connect any OpenAI-compatible API (Groq, OpenAI, Mistral, Together AI) or run Ollama locally
 - **Export to PDF** — one-click export via native save dialog
 - **Dark / light theme** — persisted across sessions
 - **Configurable editor** — font size and font family settings
 
----
 ## Screens
 ![AI assistant editing](assets/screenshot-preview.png)
 ![AI assistant editing](assets/screenshot-ai-edit.png)
@@ -95,7 +96,7 @@ When the AI assistant processes an edit, changes are applied silently and instan
 
 ### Safety & Version Controls
 * **Instant Undo:** Every single document modification made by the AI can be instantly reversed using the UI Undo button (↺) or by pressing `Ctrl+Z`.
-* **Automatic Snapshots:** For absolute safety, MoilStack .md saves automatic file backups to the active directory's `<your-folder>/.markflow/backups/` directory before any AI processing occurs.
+* **Automatic Snapshots:** For absolute safety, MoilStack .md saves automatic file backups to the app's user data directory (not your workspace folder) before any AI processing occurs.
 * **Scoped Selections:** Highlight specific sentences or code lines inside the editor pane before typing a prompt to limit the AI assistant's scope exclusively to that text selection.
 
 
@@ -107,20 +108,24 @@ When the AI assistant processes an edit, changes are applied silently and instan
 | `Ctrl+Z` | Undo (AI edits first, then native undo) |
 | `Ctrl+\`` | Toggle Edit / Preview mode |
 | `Ctrl+O` | Open folder picker |
-| `Ctrl+N` | New file in current folder |
+| `Ctrl+N` | New untitled file (in-memory) |
+| `Ctrl+Shift+N` | New file on disk in Explorer's active folder |
 | `Ctrl+F` | Find & replace |
+| `Ctrl+Shift+F` | Global search (filenames & content) |
 | `Enter` | Send chat message |
 | `Alt+Enter` | New line in chat input |
 | `Escape` | Close any open modal or dropdown |
 
 ## File Backups
 
-Every time the AI edits your document, MoilStack .md saves a backup to:
+Every time the AI edits your document, MoilStack .md saves a backup to the app's user data directory, keyed to your file's parent folder — not inside your workspace:
 
 ```
-<your-folder>/.markflow/backups/
+<app userData>/backups/<folder-name>-<folder-hash>/
 ```
 
+On Windows this is typically under `%APPDATA%`, on macOS under `~/Library/Application Support`, and on Linux under `~/.config`.
+
 Files are named `<filename>_<timestamp>.md` and the last **10 backups per file** are kept automatically. Use these to recover from any unwanted AI changes.
 
 

From 173884d942c71feece5ee9d3fa41f3a695c76ce6 Mon Sep 17 00:00:00 2001
From: moilstack <moilstack.tech@gmail.com>
Date: Sat, 18 Jul 2026 20:22:09 +0530
Subject: [PATCH 14/14] Update CHANGELOG.md to release version 1.1.0 and
 document new features

---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index bb80ed6..3bc3a71 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,7 +4,7 @@ All notable new features and critical fixes for MoilStack .md.
 
 ---
 
-## [Unreleased]
+## [1.1.0] - 2026-07-18
 
 ### Added
 - **Copy / Paste in the editor context menu** — added as a new group at the top, above the formatting options, with `Ctrl C` / `Ctrl V` shown as hints