StableLlamaAI · StableLlama · May 6, 2026 · May 6, 2026 · May 8, 2026 · May 9, 2026
diff --git a/.github/workflows/code-quality.yml b/.github/workflows/code-quality.yml
@@ -76,3 +76,26 @@ jobs:
       run: |
         cd src/frontend
         npm audit --audit-level=high
+
+  frontend-e2e-checks:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v6
+    - name: Set up Node.js
+      uses: actions/setup-node@v6
+      with:
+        node-version: '24'
+        cache: 'npm'
+        cache-dependency-path: src/frontend/package-lock.json
+    - name: Install dependencies
+      run: |
+        cd src/frontend
+        npm ci --legacy-peer-deps
+    - name: Install Playwright browsers
+      run: |
+        cd src/frontend
+        npx playwright install --with-deps chromium
+    - name: Run E2E cursor/caret regression tests
+      run: |
+        cd src/frontend
+        npm run test:e2e
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -28,5 +28,5 @@ repos:
         language: system
         # Run eslint using the local installation in frontend/node_modules
         # This ensures it uses the correct version and plugins
-        entry: src/frontend/node_modules/.bin/eslint --config src/frontend/eslint.config.cjs
-        files: ^src/frontend/.*\.(js|jsx|ts|tsx)$
+        entry: src/frontend/node_modules/.bin/eslint --config src/frontend/eslint.config.cjs --ext .ts,.tsx
+        files: ^src/frontend/.*\.(ts|tsx)$
diff --git a/.vscode/launch.json b/.vscode/launch.json
@@ -14,6 +14,19 @@
         "AUGQ_LLM_DUMP_LEVEL": "normal"
       }
     },
+    {
+      "name": "Backend (Dev API 28000) Verbose",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "augmentedquill.main",
+      "args": ["--host", "127.0.0.1", "--port", "28000", "--reload", "--llm-dump"],
+      "console": "integratedTerminal",
+      "justMyCode": true,
+      "preLaunchTask": "backend: prepare",
+      "env": {
+        "AUGQ_LLM_DUMP_LEVEL": "debug"
+      }
+    },
     {
       "name": "Frontend (Vite 28001)",
       "type": "node-terminal",
@@ -31,6 +44,11 @@
       "name": "Full Stack Dev (Backend + Frontend)",
       "configurations": ["Backend (Dev API 28000)", "Frontend (Vite 28001)"],
       "stopAll": true
+    },
+    {
+      "name": "Full Stack Dev (Backend + Frontend) Verbose",
+      "configurations": ["Backend (Dev API 28000) Verbose", "Frontend (Vite 28001)"],
+      "stopAll": true
     }
   ]
 }
diff --git a/AGENTS.md b/AGENTS.md
@@ -117,6 +117,10 @@ npm run check:generated-types
 
 ## 7. Style And Conventions
 
+### Test driven development (TDD)
+
+Implement test cases to cover the user specification first and then implement the solution. Finish with implementing test cases that cover every valid input as well as those that have bad input to test correct error handling, so that any regression is easily detected.
+
 ### Required file headers
 
 - Every new/modified `.py`, `.ts`, `.tsx`, `.js` file must include:
@@ -191,10 +195,11 @@ python tools/check_copyright.py .
 
 ## 9.5 Project File Schema Evolution Rules
 
-- Changes to project/story files must either be backward compatible or explicitly bump the config/schema version.
+- Changes to project/story files must either be intrinsic backward compatible or explicitly bump the config/schema version.
 - Any version bump must include an automatic conversion function from the prior version.
 - Conversions must be chainable step-by-step (for example v2 -> v3 -> v4) so older versions can be upgraded safely through intermediate migrations.
 - Never introduce a breaking project-file format change without a tested migration path.
+- Never introduce code that handles older versions of the files, always relay on the files having the current version and the version conversion scripts are used to make the files compatible. Do not use in project code for backward compatability.
 
 ## 10. Security And Operational Guardrails
 
@@ -205,7 +210,7 @@ python tools/check_copyright.py .
 ## 11. Agent Workflow Heuristics
 
 - Read only what is needed for the current task.
-- Prefer surgical edits over broad rewrites.
+- Prefer surgical edits over broad rewrites. But also do not hesitate a rewrite when that increases maintainability and prevents duplication.
 - After edits, run relevant checks and report concrete outcomes.
 - If failures are unrelated to your change, report them clearly instead of silently changing unrelated code.
 - Preserve existing style and naming in touched files.

diff --git a/docs/user_manual/01_getting_started.md b/docs/user_manual/01_getting_started.md
@@ -92,10 +92,10 @@ On medium screens the less common buttons collapse into a **Format** dropdown (t
 
 | Control                                                                                                                             | Description                                                                                                                                                             |
 | ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **Images** (<img src="assets/eye.svg" alt="Image icon" width="16" height="16" style="vertical-align:text-bottom;" /> image icon)    | Opens the **Project Images** dialog to manage all visual assets for this project. (See [Project Images](06_project_images.md).)                                         |
+| **Images** (<img src="assets/eye.svg" alt="Image icon" width="16" height="16" style="vertical-align:text-bottom;" /> image icon)    | Opens the **Project Images** dialog to manage all visual assets for this project. (See [Project Images](09_project_images.md).)                                         |
 | **Settings** (<img src="assets/settings.svg" alt="Settings icon" width="16" height="16" style="vertical-align:text-bottom;" />)     | Opens the Settings dialog (same as clicking the logo).                                                                                                                  |
-| **Appearance** (<img src="assets/type.svg" alt="Type icon" width="16" height="16" style="vertical-align:text-bottom;" /> Type icon) | Opens the Appearance popup to adjust the visual theme, font size, and line width. (See [Appearance and Display](08_appearance_and_display.md).)                         |
-| **Debug Logs** (bug icon)                                                                                                           | Opens the LLM Debug Logs overlay — a developer-focused view of all AI requests and responses. (See [Appearance and Display](08_appearance_and_display.md#debug-logs).)  |
+| **Appearance** (<img src="assets/type.svg" alt="Type icon" width="16" height="16" style="vertical-align:text-bottom;" /> Type icon) | Opens the Appearance popup to adjust the visual theme, font size, and line width. (See [Appearance and Display](10_appearance_and_display.md).)                         |
+| **Debug Logs** (bug icon)                                                                                                           | Opens the LLM Debug Logs overlay — a developer-focused view of all AI requests and responses. (See [Appearance and Display](10_appearance_and_display.md#debug-logs).)  |
 | **Hide / AI** (panel icon)                                                                                                          | Toggles the right Chat Assistant panel open or closed. The current label flips between **Hide** (chevron-right) and **AI** (chevron-left) depending on the panel state. |
 
 ---

diff --git a/docs/user_manual/02_projects_and_settings.md b/docs/user_manual/02_projects_and_settings.md
@@ -27,11 +27,11 @@ The Projects tab lists every project stored on this machine and lets you create,
 
 Three buttons sit above the project list:
 
-| Button          | Icon                                                                                                            | Action                                                                                                                                                                                        |
-| --------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **Refresh**     | <img src="assets/edit-2.svg" alt="Refresh icon" width="16" height="16" style="vertical-align:text-bottom;" /> ↺ | Rescans the projects folder from disk — useful if you have added or removed project folders manually.                                                                                         |
-| **Import**      | ↑ Upload                                                                                                        | Opens a file picker that accepts `.zip` files. AugmentedQuill will unpack the archive and add the project to your list. This is the matching action to the Export button on each project row. |
-| **New Project** | <img src="assets/plus.svg" alt="Plus icon" width="16" height="16" style="vertical-align:text-bottom;" />        | Opens the **Create Project** dialog (see below).                                                                                                                                              |
+| Button          | Icon                                                                                                              | Action                                                                                                                                                                                        |
+| --------------- | ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Refresh**     | <img src="assets/refresh-cw.svg" alt="Refresh icon" width="16" height="16" style="vertical-align:text-bottom;" /> | Rescans the projects folder from disk — useful if you have added or removed project folders manually.                                                                                         |
+| **Import**      | ↑ Upload                                                                                                          | Opens a file picker that accepts `.zip` files. AugmentedQuill will unpack the archive and add the project to your list. This is the matching action to the Export button on each project row. |
+| **New Project** | <img src="assets/plus.svg" alt="Plus icon" width="16" height="16" style="vertical-align:text-bottom;" />          | Opens the **Create Project** dialog (see below).                                                                                                                                              |
 
 ### Project Cards
 
@@ -305,10 +305,6 @@ Click **Save & Close** at the bottom of the Settings dialog to write your machin
 
 ---
 
-Next up: Explore [The Writing Interface](03_writing_interface.md).
-
----
-
 ## Multiple Languages (GUI vs Project)
 
 AugmentedQuill supports distinct languages for its interface (GUI) and your story content.
@@ -325,3 +321,7 @@ The story language dictates the spellchecking and grammar tools used by your cho
 1. When creating a **New Project**, select the language in the project dialog.
 2. OR, open the **Project Settings** (by clicking your story title in the corner or typing in the Project tab) and change the language dropdown.
 3. Chat fields, Editors, and Images will automatically adapt their spellchecker to the project's saved language.
+
+---
+
+Next up: Explore [The Writing Interface](03_writing_interface.md).
diff --git a/docs/user_manual/03_writing_interface.md b/docs/user_manual/03_writing_interface.md
@@ -28,7 +28,7 @@ You can switch modes at any time without losing data; the underlying markdown fi
 
 ### Dropping Images Into the Editor
 
-Drag an image file (PNG, JPEG, GIF, WEBP) and drop it onto the editor paper area. A highlighted drop zone appears while the image is being dragged over. On release, the image uploads to the server and an inline markdown image tag (`![title](url)`) is inserted at the current cursor position. You can manage all project images from the **Project Images** dialog (see [Project Images](06_project_images.md)).
+Drag an image file (PNG, JPEG, GIF, WEBP) and drop it onto the editor paper area. A highlighted drop zone appears while the image is being dragged over. On release, the image uploads to the server and an inline markdown image tag (`![title](url)`) is inserted at the current cursor position. You can manage all project images from the **Project Images** dialog (see [Project Images](09_project_images.md)).
 
 ---
 
@@ -225,7 +225,7 @@ These controls update the planning layer around a chapter rather than the prose
 - The suggestion pane always shows the last set of continuations, so you can keep requesting more or hit `Dismiss` once you are satisfied.
 - Even when AI actions are running, you can keep typing because the UI disables only the relevant button and leaves the rest of the editor responsive.
 - Switch between Raw, MD, and Visual modes freely — the underlying file is the same markdown source regardless of which view you use.
-- Press **Ctrl+F** (or **Cmd+F** on macOS) at any time — or click the **<img src="assets/search.svg" alt="Search icon" width="16" height="16" style="vertical-align:text-bottom;" /> Search** icon in the top-right header — to open the project-wide **Search and Replace** dialog. See [Search and Replace](12_search_and_replace.md) for the full guide.
+- Press **Ctrl+F** (or **Cmd+F** on macOS) at any time — or click the **<img src="assets/search.svg" alt="Search icon" width="16" height="16" style="vertical-align:text-bottom;" /> Search** icon in the top-right header — to open the project-wide **Search and Replace** dialog. See [Search and Replace](08_search_and_replace.md) for the full guide.
 
 ---
 

diff --git a/docs/user_manual/04_chapters_and_books.md b/docs/user_manual/04_chapters_and_books.md
@@ -57,7 +57,7 @@ The Metadata Editor is a full-screen or sidebar panel that opens whenever you cl
 
 - The text area holds the public description that appears in the sidebar card and is sent to every AI call that involves this chapter or story.
 - When the summary is empty, an **AI Write** button (<img src="assets/wand.svg" alt="Wand icon" width="16" height="16" style="vertical-align:text-bottom;" />) asks the <img src="assets/swatches/fuchsia.svg" alt="Fuchsia swatch" width="16" height="16" style="vertical-align:text-bottom;" /> **EDITING** model to draft a summary from the chapter content.
-- Once a summary exists, the button becomes **AI Update** (<img src="assets/edit-2.svg" alt="Refresh icon" width="16" height="16" style="vertical-align:text-bottom;" />) which updates the existing text, and an adjacent **AI Rewrite** (<img src="assets/pen.svg" alt="Pen icon" width="16" height="16" style="vertical-align:text-bottom;" />) button regenerates it from scratch — useful when the story direction has changed.
+- Once a summary exists, the button becomes **AI Update** (<img src="assets/refresh-cw.svg" alt="Refresh icon" width="16" height="16" style="vertical-align:text-bottom;" />) which updates the existing text, and an adjacent **AI Rewrite** (<img src="assets/pen.svg" alt="Pen icon" width="16" height="16" style="vertical-align:text-bottom;" />) button regenerates it from scratch — useful when the story direction has changed.
 
 **Notes tab:**
 

diff --git a/docs/user_manual/05_sourcebook.md b/docs/user_manual/05_sourcebook.md
@@ -93,7 +93,7 @@ The Image Picker is a sub-modal that appears when you click **Manage Images** in
 - A count below the grid shows how many images are currently selected.
 - Click **Done** (✓) to close the picker and apply the selection to the entry.
 
-Images shown here are managed in the [Project Images](06_project_images.md) dialog. You can upload new images there and they will appear in this picker immediately.
+Images shown here are managed in the [Project Images](09_project_images.md) dialog. You can upload new images there and they will appear in this picker immediately.
 
 ---
 
@@ -118,4 +118,4 @@ Mouse-over tooltips on the **Auto** control, spinner, and disabled checkboxes ex
 
 ---
 
-Next up: Manage your project's visual assets in [Project Images](06_project_images.md).
+Next up: Apply everything you've learned in the [Tutorial: Writing Your First Story](06_tutorial_first_story.md).
diff --git a/docs/user_manual/06_project_images.md b/docs/user_manual/06_project_images.md
@@ -94,4 +94,4 @@ Paste the copied prompt into your preferred image generation tool (Stable Diffus
 
 ---
 
-Next up: Discover your AI writing partner in [The AI Chat Assistant](07_ai_chat_assistant.md).
+Next up: Customize the look and feel in [Appearance and Display](08_appearance_and_display.md).
Original file line number	Diff line number	Diff line change
Expand Up		@@ -94,4 +94,4 @@ Paste the copied prompt into your preferred image generation tool (Stable Diffus

		---

		Next up: Discover your AI writing partner in [The AI Chat Assistant](07_ai_chat_assistant.md).
		Next up: Customize the look and feel in [Appearance and Display](08_appearance_and_display.md).