Tweaks & fixes

requirements.md

@@ -16,14 +16,16 @@ An Obsidian plugin that provides a more traditional task management GUI for desi
 
 ### 1.2 Structure
 
-- Task files consist entirely of markdown checklist items (`- [ ] …` / `- [x] …`).
+- Task files consist of markdown checklist items (`- [ ] …` / `- [x] …`) and optional header content.
+- Any non-checklist lines **before the first checklist item** are treated as **header text**: they are not parsed as tasks, not shown in the UI, and are preserved verbatim when the file is written back.
 - Any non-checklist lines immediately following a checklist item are treated as **notes** for that item.
+- Notes are separated from their parent task in the file by a blank line.
 - The ordering of checklist items in the file reflects the display order in the UI.
 - Completed items remain in the file until the user marks them as done, at which point they are moved to the current Daily Note (see §5).
 
 ### 1.3 Inbox File
 
-- One task file is designated as the **Inbox** — the default destination for new tasks.
+- One task file is designated as the **Inbox** — the default destination when opened via the command palette.
 - The Inbox file path is configured in plugin settings.
 - Default: `Tasks/Inbox.md`.
 
@@ -31,7 +33,13 @@ An Obsidian plugin that provides a more traditional task management GUI for desi
 
 ## 2. Task View UI
 
-### 2.1 Layout
+### 2.1 Source Mode
+
+- The task view header contains an **"Edit source"** action button (code icon).
+- Clicking it switches the current leaf to Obsidian's standard markdown editor in source mode, bypassing the normal intercept that redirects task files to the task view.
+- To return to task view, use the tab's **"Open as… > YAOTP Task View"** context menu option, or close and reopen the file.
+
+### 2.2 Layout
 
 - The custom view replaces the standard markdown editor for task files.
 - Each checklist item is displayed as a task row containing:
@@ -40,14 +48,14 @@ An Obsidian plugin that provides a more traditional task management GUI for desi
   - Notes are **not** shown inline; they are accessible via the task editor (§3).
 - The view does not render raw markdown syntax.
 
-### 2.2 Reordering
+### 2.3 Reordering
 
 - Task rows can be reordered by dragging and dropping within the view.
 - On mobile, reordering is triggered by a long-press on the drag handle, followed by dragging.
 - Reordering the UI immediately reorders the corresponding checklist items in the markdown file.
 - Notes travel with their parent task during reordering.
 
-### 2.3 File Switcher
+### 2.4 File Switcher
 
 - A header bar or sidebar control lets the user quickly switch between:
   - The Inbox file.
@@ -57,7 +65,7 @@ An Obsidian plugin that provides a more traditional task management GUI for desi
   - Creates the file in the configured tasks folder (or a location derived from the regex).
   - Opens the new file in the task view.
 
-### 2.3 Adding a Task
+### 2.5 Adding a Task
 
 - The first row of every task list is a persistent **add-task row** that looks identical to a regular task row.
 - The add-task row contains:
@@ -68,7 +76,7 @@ An Obsidian plugin that provides a more traditional task management GUI for desi
 - The new task is immediately persisted to the markdown file.
 - The add-task row is always visible, even when the list is empty.
 
-### 2.4 Completing a Task
+### 2.6 Completing a Task
 
 - Clicking a task's checkbox marks it as complete.
 - The task (and its notes) is removed from the current task file.
@@ -79,11 +87,13 @@ An Obsidian plugin that provides a more traditional task management GUI for desi
 
 ## 3. Task Editor
 
-- Clicking the **text** of a task opens an editor modal or inline panel.
+- Clicking the **text** of a task opens an editor modal.
 - The editor provides:
-  - A single **multiline text area** containing the task text on the first line, followed by the notes. The first line is the task title; any subsequent lines are notes. The user edits both in one continuous field.
+  - A single **multiline text area** with the task title on the first line, a blank line, then the notes. The blank line separator is always present when notes exist; if the user removes it or writes notes without it, a blank line is inserted automatically on save.
   - A **file selector** (dropdown or fuzzy-search picker) to move the task to a different task file. Selecting a different file removes the task from the current file and appends it to the bottom of the selected file.
+  - A **Delete** button that, after a confirmation prompt, permanently removes the task from the file.
 - Changes are saved back to the markdown file on confirm/close.
+- The **"+ New list"** button opens a modal prompting for a file name and creates the file in the configured tasks folder.
 
 ---
 
@@ -123,6 +133,7 @@ An Obsidian plugin that provides a more traditional task management GUI for desi
 |---|---|---|
 | **Inbox file path** | Vault-relative path to the Inbox task file | `Tasks/Inbox.md` |
 | **Task file regex** | Regex matched against vault-relative file paths to identify task files | `^Tasks\/.*\.md$` |
+| **Task file folder** | Vault-relative folder where new task lists are created via the "New list" button; leave empty for the vault root | `Tasks` |
 | **Daily note date format** | Date format string used to locate the daily note (should match Daily Notes plugin setting) | `YYYY-MM-DD` |
 | **Daily note folder** | Folder where daily notes are stored (should match Daily Notes plugin setting) | *(empty — vault root)* |