Release/v0.4.0

.github/workflows/flutter-linux.yml

@@ -111,7 +111,7 @@ jobs:
       - name: Run real WebKit, PlantUML, Mermaid, OpenAPI, and D2 smoke tests
         run: |
           xvfb-run -a -s '-screen 0 1280x1024x24' \
-            env WEBKIT_DISABLE_COMPOSITING_MODE=1 LIBGL_ALWAYS_SOFTWARE=1 \
+            env GDK_BACKEND=x11 LIBGL_ALWAYS_SOFTWARE=1 \
             /usr/bin/python3 -u tools/visualization_smoke.py \
             --assets build/linux/x64/release/bundle/share/busymark/visualization \
             --d2 build/linux/x64/release/bundle/libexec/busymark/d2 \
@@ -123,7 +123,7 @@ jobs:
           report="${RUNNER_TEMP}/visualization-release-x11.json"
           timeout --signal=TERM 300s \
             xvfb-run -a -s '-screen 0 1280x1024x24' \
-            env BUSYMARK_RELEASE_SMOKE=1 WEBKIT_DISABLE_COMPOSITING_MODE=1 \
+            env GDK_BACKEND=x11 BUSYMARK_RELEASE_SMOKE=1 \
             LIBGL_ALWAYS_SOFTWARE=1 \
             build/linux/x64/release/bundle/busymark \
             --visualization-release-smoke="$report"
@@ -151,8 +151,7 @@ jobs:
           done
           test -S "$runtime_dir/wayland-99"
           XDG_RUNTIME_DIR="$runtime_dir" WAYLAND_DISPLAY=wayland-99 \
-            GDK_BACKEND=wayland WEBKIT_DISABLE_COMPOSITING_MODE=1 \
-            LIBGL_ALWAYS_SOFTWARE=1 \
+            GDK_BACKEND=wayland LIBGL_ALWAYS_SOFTWARE=1 \
             /usr/bin/python3 -u tools/visualization_smoke.py \
             --assets build/linux/x64/release/bundle/share/busymark/visualization \
             --d2 build/linux/x64/release/bundle/libexec/busymark/d2 \
@@ -161,7 +160,7 @@ jobs:
           report="${RUNNER_TEMP}/visualization-release-wayland.json"
           XDG_RUNTIME_DIR="$runtime_dir" WAYLAND_DISPLAY=wayland-99 \
             GDK_BACKEND=wayland BUSYMARK_RELEASE_SMOKE=1 \
-            WEBKIT_DISABLE_COMPOSITING_MODE=1 LIBGL_ALWAYS_SOFTWARE=1 \
+            LIBGL_ALWAYS_SOFTWARE=1 \
             timeout --signal=TERM 300s \
             build/linux/x64/release/bundle/busymark \
             --visualization-release-smoke="$report"
@@ -228,7 +227,7 @@ jobs:
           mkdir -p "$(dirname "$report")"
           timeout --signal=TERM 300s \
             xvfb-run -a -s '-screen 0 1280x1024x24' \
-            env BUSYMARK_RELEASE_SMOKE=1 WEBKIT_DISABLE_COMPOSITING_MODE=1 \
+            env GDK_BACKEND=x11 BUSYMARK_RELEASE_SMOKE=1 \
             LIBGL_ALWAYS_SOFTWARE=1 snap run busymark \
             --visualization-release-smoke="$report"
           python3 -c 'import json,sys; report=json.load(open(sys.argv[1], encoding="utf-8")); assert report["ok"], report' "$report"
@@ -257,7 +256,7 @@ jobs:
           report="$HOME/snap/busymark/common/visualization-release-wayland.json"
           XDG_RUNTIME_DIR="$runtime_dir" WAYLAND_DISPLAY=wayland-99 \
             GDK_BACKEND=wayland BUSYMARK_RELEASE_SMOKE=1 \
-            WEBKIT_DISABLE_COMPOSITING_MODE=1 LIBGL_ALWAYS_SOFTWARE=1 \
+            LIBGL_ALWAYS_SOFTWARE=1 \
             timeout --signal=TERM 300s snap run busymark \
             --visualization-release-smoke="$report"
           python3 -c 'import json,sys; report=json.load(open(sys.argv[1], encoding="utf-8")); assert report["ok"], report' "$report"

README.md

@@ -14,13 +14,81 @@ Markdown and Writerside editor for Linux.
 
 * **Markdown editing** — Source, Editor, Reading, and Split views with formatting tools, syntax highlighting, code folding, tables, images, links, code blocks, callouts, collapsible content, and document diagnostics.
 * **Writerside projects** — Open and create Writerside-compatible projects; edit Markdown and XML topics; manage instances, tables of contents, reusable TOC libraries, and project structure.
-* **Project navigation and search** — Files, TOC, and Outline views, tabbed documents, command palette, keyboard shortcuts, document search and replace, reviewed workspace-wide replacement, and Markdown TOC generation.
+* **Project navigation and search** — Files, Topics, and Outline views, tabbed documents, command palette, keyboard shortcuts, document search and replace, reviewed workspace-wide replacement, and Markdown TOC generation.
 * **Technical documentation** — Local rendering of Mermaid, PlantUML, D2, fenced OpenAPI specifications, and MathJax mathematical expressions.
 * **PDF and HTML publishing** — Export Markdown documents and Writerside instances to configurable PDF or portable offline HTML, with controls for layout, typography, tables of contents, heading numbering, and HTML styling.
 * **Git integration** — Review changes and diffs, stage and unstage files, commit, create and switch branches, fetch, pull, push, inspect file and project history, compare historical versions, and restore earlier file versions.
+* **Clipboard and Local History** — Reuse source, rich-text, and image fragments during the current session; compare and restore persistent on-device document revisions independently of Git.
 * **AI-assisted editing** — Optional Ollama, OpenAI, and Gemini integration with explicit edit scope and shared context, proposal review before changes are applied, and AI-assisted Git commit-message drafting.
 * **Workspace reliability** — Detect files changed outside BusyMark, recover unsaved documents, restore previous workspace sessions, manage remote-image permissions, and protect Git operations behind workspace trust.
 
+## Installation
+
+Install BusyMark from the Snap Store:
+
+```bash
+sudo snap install busymark --beta
+```
+
+The Snap uses strict confinement. See [Snap confinement](docs/snap-confinement.md)
+for filesystem and Git-integration details.
+
+## Run from source
+
+BusyMark currently uses Flutter 3.47.2. Install the Linux packages required by
+Flutter and BusyMark's CMake configuration:
+
+```bash
+sudo apt-get install -y \
+  clang \
+  cmake \
+  curl \
+  fonts-noto-core \
+  fonts-noto-mono \
+  libgtk-3-dev \
+  libhandy-1-dev \
+  libsecret-1-dev \
+  libwebkit2gtk-4.1-dev \
+  ninja-build \
+  pkg-config \
+  xz-utils
+```
+
+Node.js 22 or newer with npm is also required to build the bundled web
+components.
+
+Prepare and run the application:
+
+```bash
+flutter doctor
+flutter pub get
+flutter run -d linux
+```
+
+Pass a Markdown file or documentation directory after `--` to open it at
+startup:
+
+```bash
+flutter run -d linux -- /absolute/path/to/document.md
+flutter run -d linux -- /absolute/path/to/documentation
+```
+
+Build and run the standard checks with:
+
+```bash
+flutter build linux
+flutter analyze
+flutter test
+```
+
+The build assembles BusyMark's runtime components. Packaged users do not need
+separate Typst, Java, Node.js, or Chromium installations.
+
+The CI workflow installs additional packages for headless X11/Wayland, browser,
+PDF, and sandbox verification. Those packages are not required for an ordinary
+local build; see [the Linux workflow](.github/workflows/flutter-linux.yml) when
+reproducing release verification.
+
 ## Screenshots
 
 <table>
@@ -74,6 +142,11 @@ Markdown and Writerside editor for Linux.
   </tr>
 </table>
 
+## Documentation
+
+The [documentation index](docs/README.md) lists user guides and the separate
+developer notes.
+
 ## Markdown and Writerside
 
 BusyMark opens Markdown files using `.md` and `.markdown` extensions and can work with ordinary documentation folders.
@@ -82,11 +155,18 @@ Writerside-compatible projects are recognized through `writerside.cfg` and the o
 
 More information:
 
+* [Writerside support and limitations](docs/writerside-support.md)
 * [Writerside instances](docs/writerside-instances.md)
 * [Writerside videos](docs/videos.md)
 * [Admonitions](docs/admonitions.md)
 * [Collapsible elements](docs/collapsible-elements.md)
 
+## Search and replace
+
+BusyMark supports active-document replacement and reviewed workspace-wide
+replacement. See [Search and replace](docs/search-and-replace.md) for search
+options, scope, preview behavior, and stale-result handling.
+
 ## Diagrams and mathematics
 
 BusyMark renders Mermaid, PlantUML, D2, and fenced OpenAPI content locally. Mathematical expressions are rendered with the bundled MathJax environment.
@@ -116,64 +196,12 @@ BusyMark supports Ollama, OpenAI, and Google Gemini. Proposed edits are presente
 
 See [AI editing](docs/local-ai.md) for configuration, privacy, provider behavior, and security information.
 
-## Installation
-
-Install BusyMark from the Snap Store:
-
-```bash
-sudo snap install busymark --beta
-```
-
-The Snap uses strict confinement. See [Snap confinement notes](docs/snap-confinement.md) for details about filesystem and Git integration.
-
-## Run from source
-
-BusyMark currently uses Flutter 3.47.0.
-
-Install the required Linux development packages:
+## History and recovery
 
-```bash
-sudo apt-get install \
-  curl \
-  libhandy-1-dev \
-  xz-utils \
-  libwebkit2gtk-4.1-dev \
-  fonts-noto-core \
-  fonts-noto-mono
-```
-
-Node.js 22 or newer with npm is also required when building the bundled web components.
-
-Prepare and run the application:
-
-```bash
-flutter doctor
-flutter pub get
-flutter run -d linux
-```
-
-A Markdown file or documentation folder can be opened directly from the command line:
-
-```bash
-flutter run -d linux
-```
-
-## Build
-
-Build the Linux desktop application with:
-
-```bash
-flutter build linux
-```
-
-The build assembles the runtime components required by BusyMark. Packaged users do not need separate Typst, Java, Node.js, or Chromium installations.
-
-## Test
-
-```bash
-flutter analyze
-flutter test
-```
+See [Clipboard History and Local History](docs/history.md) for collection scope,
+limits, retention, restoration, exclusions, and how these tools differ from
+undo, crash recovery, and Git. Implementation and verification details are in
+[the history implementation notes](docs/development/history.md).
 
 ## Contributing
 

docs/README.md

@@ -0,0 +1,39 @@
+# BusyMark documentation
+
+This directory contains user guides for BusyMark and a separate set of notes
+for contributors. Start with the workflow you need; syntax and limitation pages
+are intentionally independent so they can be referenced directly.
+
+## Everyday workflows
+
+- [Search and replace](search-and-replace.md)
+- [AI editing](local-ai.md)
+- [Clipboard History and Local History](history.md)
+- [Snap confinement](snap-confinement.md)
+
+## Writerside
+
+- [Supported content and limitations](writerside-support.md)
+- [Instances and TOC libraries](writerside-instances.md)
+- [Admonitions](admonitions.md)
+- [Collapsible elements](collapsible-elements.md)
+- [Videos](videos.md)
+
+## Technical content
+
+- [Mathematical expressions](math.md)
+- [Offline visualizations](visualizations.md)
+
+## Export
+
+- [PDF export](pdf-export.md)
+- [Writerside PDF export](writerside-pdf-export.md)
+- [HTML export](html-export.md)
+
+## Developer notes
+
+- [AI implementation and qualification](development/ai.md)
+- [Export verification](development/export-verification.md)
+- [History implementation](development/history.md)
+- [Visualization implementation and verification](development/visualizations.md)
+- [Writerside verification](development/writerside-verification.md)