Merge pull request #211 from beNative/codex/review-documentation-for-recent-commits

Document v0.6.9 features and UI updates

Author: beNative

FUNCTIONAL_MANUAL.md

@@ -28,6 +28,7 @@ The resizable left panel is your main navigation and organization area.
 - **Search:** A search bar at the top lets you filter your documents and folders. It instantly checks titles while also running a background full-text search across document bodies, returning contextual snippets with the matched terms highlighted so you can quickly confirm relevance.
 - **Documents List:** A hierarchical tree view of all your documents and folders.
     - **Action Toolbar:** A toolbar at the top of the list provides icon buttons to quickly create a new document, create a new root folder, create a new document from a template, expand/collapse all folders, and toggle the active document's lock state.
+    - **Row Quick Actions:** Hover or focus any row to reveal a compact strip of icons for the most common tasks—duplicate, export, rename, lock/unlock (for editable repositories), and more. The quick actions float over the right edge so the row keeps its full height and the title stays readable.
     - **Folders:** Can be expanded or collapsed.
     - **Documents:** Individual document files. Selecting a document opens it in the Main Content Area.
 - **Templates List:** A separate panel below your documents for managing reusable templates. This panel is resizable; you can drag its top border to adjust its height.
@@ -115,8 +116,10 @@ The document editor is powered by Monaco, the same editor core used in VS Code,
     - **Editor Only:** The default text editing view.
     - **Preview Only:** A rendered view of your content.
     - **Split Vertical/Horizontal:** A side-by-side or top-and-bottom view of the editor and the live preview.
+- **Aligned Controls:** The language selector, Cancel Changes button, and preview toggles are grouped together so the toolbar stays organized even as you resize the window.
 - **Toolbar Actions:**
     - **Save Version:** Manually save the current content as a new version in the document's history. The button icon will be highlighted when there are unsaved changes.
+    - **Cancel Changes:** Discard all unsaved edits and revert to the last saved version without closing the tab or navigating away.
     - **Version History:** Open a view to see all saved versions of the document.
     - **Format:** Automatically tidy up supported languages—Markdown, JSON, JavaScript, and TypeScript—using DocForge's integrated formatter.
     - **Lock/Unlock:** Click the padlock icon to switch the document between editable and read-only modes. Locked documents disable title regeneration, formatting, AI refinement, and manual saves until you unlock them.

README.md

@@ -11,12 +11,14 @@ DocForge is a desktop application designed to streamline the process of creating
 - **Full Context Menu & Keyboard Navigation:** Navigate and manage items using a complete right-click context menu or use only the keyboard for a faster workflow.
 - **Universal Monaco Editor:** A powerful, VS Code-like editor is used for all document types, including Markdown, HTML, and various source code files, with syntax highlighting and code folding.
 - **One-Click Formatting:** Clean up Markdown, JSON, JavaScript, and TypeScript documents directly from the editor toolbar.
+- **Cancel Unsaved Changes:** Instantly roll a document back to its last saved state with a dedicated toolbar button when an experiment goes sideways.
 - **Document Locking:** Protect sensitive drafts by toggling a padlock button that flips the editor into a read-only mode until you intentionally unlock it.
 - **Multi-Document Tabs:** Keep several documents open at once, pin important files, and quickly jump between them using the tab strip and overflow picker.
 - **Multi-Format Live Preview:** Get a real-time, rendered preview for Markdown, HTML, PDFs, and common image formats. The preview can be displayed side-by-side (vertically or horizontally) with the editor, and binary formats open straight into preview mode with zoom and pan controls tailored to each viewer.
 - **AI-Powered Refinement:** Use your connected local LLM to automatically refine and improve your documents with a single click.
 - **Document Templating:** Create reusable document templates with variables to quickly generate new documents for recurring tasks.
 - **Document Export:** Save any document to your filesystem with a suggested filename and the correct extension for its detected type, whether you're running the Electron app or using the browser build.
+- **Hover-First Tree Actions:** Keep document titles readable while revealing quick actions—duplicate, export, lock, etc.—only when you hover or focus each row in the sidebar.
 - **Integrated Python Workflow:** Open an inline Python console tied to your documents to execute snippets, review logs, and manage isolated environments without leaving DocForge.
 - **Shell & PowerShell Execution:** Run or syntax-test scripts directly from the editor with per-document environment overrides that merge with workspace defaults configured in Settings.
 - **Version History:** Explicitly save new versions of your documents. Manage your history by viewing diffs, deleting old versions, and restoring to any point in time.

VERSION_LOG.md

@@ -1,24 +1,27 @@
 # Version Log
 
-## v0.6.9 - The Release Prep Maintenance
+## v0.6.9 - The Workflow & Execution Update
+
+### ✨ Features
+
+-   Added Save to File actions across the document tree, editor toolbar, and command palette so any document can be exported with a context-aware filename and extension.
+-   Introduced Shell and PowerShell execution panels that let you test or run scripts with per-document environment overrides, surfaced logs, and remembered histories alongside the existing Python runner.
+-   Added a Cancel Changes button to the editor toolbar, enabling you to instantly discard unsaved edits and return to the last saved version without leaving the document.
+-   Enabled document locking throughout the UI so a quick padlock toggle puts the editor into read-only mode, preventing accidental saves, formatting, or AI refinements until you explicitly unlock it again.
+-   Refined the sidebar tree so quick actions collapse into an icon row on hover, labels maintain their full width, and repository-backed nodes display a lock toggle beside other controls.
+-   Polished the editor toolbar layout by grouping the language selector and preview controls, keeping the action cluster aligned even as the window resizes.
 
 ### 🐛 Fixes
 
 -   Updated the release workflow fixtures to validate the `v0.6.9` tag and installers, keeping the automated publishing checks aligned with the shipped binaries.
 
 ### 📝 Documentation
 
--   Refreshed the release preparation guides so every README and manual references the `v0.6.9` tagging flow and synchronized documentation updates.
-
-## Unreleased - The Document Export Primer
+-   Refreshed the release preparation guides so every README and manual references the `v0.6.9` tagging flow, the new export workflow, and script execution guidance.
 
-### ✨ New
+## Unreleased
 
--   Added a Save to File action throughout the document tree and command palette so any document can be exported with a context-aware filename and extension.
-
-### 📝 Documentation
-
--   Documented the export workflow across the README and manuals, including technical notes about the new `documentExportService` and how the Electron bridge streams files to disk.
+-   _No entries yet._
 
 ## v0.6.8 - The Shortcut & Clipboard Update
 
@@ -53,11 +56,6 @@
 -   Integrated GitHub Spec Kit workflows and refreshed assets so future changes
     arrive with automated specification checks.
 
-> TODO: Document how to clear or reset keyboard shortcuts in the Functional
-> Manual's settings chapter.
-> TODO: Call out PlantUML and TOML syntax coverage in the published manuals so
-> users can discover the new language support.
-
 ## v0.6.7 - The Auto-Update Reliability Pass
 
 ### ✨ Features

docs/FUNCTIONAL_MANUAL.md

@@ -28,6 +28,7 @@ The resizable left panel is your main navigation and organization area.
 - **Search:** A search bar at the top lets you filter your documents and folders. It instantly checks titles while also running a background full-text search across document bodies, returning contextual snippets with the matched terms highlighted so you can quickly confirm relevance.
 - **Documents List:** A hierarchical tree view of all your documents and folders.
     - **Action Toolbar:** A toolbar at the top of the list provides icon buttons to quickly create a new document, create a new root folder, create a new document from a template, expand/collapse all folders, and toggle the active document's lock state.
+    - **Row Quick Actions:** Hover or focus any row to reveal a compact strip of icons for frequent tasks—duplicate, export, rename, lock/unlock (for editable repositories), and more. The controls float on the right edge so the row height stays consistent and labels retain their full width.
     - **Folders:** Can be expanded or collapsed.
     - **Documents:** Individual document files. Selecting a document opens it in the Main Content Area.
 - **Templates List:** A separate panel below your documents for managing reusable templates. This panel is resizable; you can drag its top border to adjust its height.
@@ -115,8 +116,10 @@ The document editor is powered by Monaco, the same editor core used in VS Code,
     - **Editor Only:** The default text editing view.
     - **Preview Only:** A rendered view of your content.
     - **Split Vertical/Horizontal:** A side-by-side or top-and-bottom view of the editor and the live preview.
+- **Aligned Controls:** The language selector, Cancel Changes button, and preview toggles are grouped together so the toolbar stays organized even as you resize the window.
 - **Toolbar Actions:**
     - **Save Version:** Manually save the current content as a new version in the document's history. The button icon will be highlighted when there are unsaved changes.
+    - **Cancel Changes:** Discard all unsaved edits and revert to the last saved version without closing the tab or navigating away.
     - **Version History:** Open a view to see all saved versions of the document.
     - **Format:** Automatically tidy up supported languages—Markdown, JSON, JavaScript, and TypeScript—using DocForge's integrated formatter.
     - **Lock/Unlock:** Click the padlock icon to switch the document between editable and read-only modes. Locked documents disable title regeneration, formatting, AI refinement, and manual saves until you unlock them.

docs/README.md

@@ -14,7 +14,9 @@ DocForge is a desktop application designed to streamline the process of creating
 - **AI-Powered Refinement:** Use your connected local LLM to automatically refine and improve your documents with a single click.
 - **Document Templating:** Create reusable document templates with variables to quickly generate new documents for recurring tasks.
 - **Document Export:** Save any document to your filesystem with a suggested filename and the correct extension for its detected type, whether you're running the Electron app or using the browser build.
+- **Cancel Unsaved Changes:** Instantly roll a document back to its last saved state with a dedicated toolbar button when an experiment goes sideways.
 - **Document Locking:** Protect sensitive drafts by toggling a padlock button that flips the editor into a read-only mode until you intentionally unlock it.
+- **Hover-First Tree Actions:** Keep document titles readable while revealing quick actions—duplicate, export, lock, etc.—only when you hover or focus each row in the sidebar.
 - **Integrated Python Workflow:** Open an inline Python console tied to your documents to execute snippets, review logs, and manage isolated environments without leaving DocForge.
 - **Shell & PowerShell Execution:** Run or syntax-test scripts directly from the editor with per-document environment overrides that merge with workspace defaults configured in Settings.
 - **Version History:** Explicitly save new versions of your documents. Manage your history by viewing diffs, deleting old versions, and restoring to any point in time.

docs/VERSION_LOG.md

@@ -1,24 +1,27 @@
 # Version Log
 
-## v0.6.9 - The Release Prep Maintenance
+## v0.6.9 - The Workflow & Execution Update
+
+### ✨ Features
+
+-   Added Save to File actions across the document tree, editor toolbar, and command palette so any document can be exported with a context-aware filename and extension.
+-   Introduced Shell and PowerShell execution panels that let you test or run scripts with per-document environment overrides, surfaced logs, and remembered histories alongside the existing Python runner.
+-   Added a Cancel Changes button to the editor toolbar, enabling you to instantly discard unsaved edits and return to the last saved version without leaving the document.
+-   Enabled document locking throughout the UI so a quick padlock toggle puts the editor into read-only mode, preventing accidental saves, formatting, or AI refinements until you explicitly unlock it again.
+-   Refined the sidebar tree so quick actions collapse into an icon row on hover, labels maintain their full width, and repository-backed nodes display a lock toggle beside other controls.
+-   Polished the editor toolbar layout by grouping the language selector and preview controls, keeping the action cluster aligned even as the window resizes.
 
 ### 🐛 Fixes
 
 -   Updated the release workflow fixtures to validate the `v0.6.9` tag and installers, keeping the automated publishing checks aligned with the shipped binaries.
 
 ### 📝 Documentation
 
--   Refreshed the release preparation guides so every README and manual references the `v0.6.9` tagging flow and synchronized documentation updates.
-
-## Unreleased - The Document Export Primer
+-   Refreshed the release preparation guides so every README and manual references the `v0.6.9` tagging flow, the new export workflow, and script execution guidance.
 
-### ✨ New
+## Unreleased
 
--   Added a Save to File action throughout the document tree and command palette so any document can be exported with a context-aware filename and extension.
-
-### 📝 Documentation
-
--   Documented the export workflow across the README and manuals, including technical notes about the new `documentExportService` and how the Electron bridge streams files to disk.
+-   _No entries yet._
 
 ## v0.6.8 - The Shortcut & Clipboard Update
 
@@ -53,11 +56,6 @@
 -   Integrated GitHub Spec Kit workflows and refreshed assets so future changes
     arrive with automated specification checks.
 
-> TODO: Document how to clear or reset keyboard shortcuts in the Functional
-> Manual's settings chapter.
-> TODO: Call out PlantUML and TOML syntax coverage in the published manuals so
-> users can discover the new language support.
-
 ## v0.6.7 - The Auto-Update Reliability Pass
 
 ### ✨ Features