MetaList 0.14.0__tar.gz → 0.16.0__tar.gz

{metalist-0.14.0 → metalist-0.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metalist
-Version: 0.14.0
+Version: 0.16.0
 Summary: A minimalist single-user note-taking app with SSR, fast in-memory tree operations, and efficient sync.
 Project-URL: Homepage, https://github.com/evolvingstuff/metalist
 Project-URL: Repository, https://github.com/evolvingstuff/metalist
@@ -20,6 +20,7 @@ Requires-Dist: nh3==0.3.6
 Requires-Dist: openai==2.54.0
 Requires-Dist: pillow==12.3.0
 Requires-Dist: pydantic==2.13.4
+Requires-Dist: pygments==2.20.0
 Requires-Dist: pypdf==6.19.0
 Requires-Dist: python-dotenv==1.2.2
 Requires-Dist: python-multipart==0.0.32
@@ -50,6 +51,23 @@ A minimalist single-user note-taking app focused on server-side rendering (SSR),
 - Multi-tab search contexts with server-persisted scroll/search state (survives browser restarts)
 - Manual namespace backups/restores to a user-selected backup folder with retention controls
 
+## Changes in 0.16.0
+
+- Right-clicking outside any note opens a fuller menu: Add/Paste Note at Top, Undo, Redo, Go to Top, Go to Bottom, Fully Expand/Collapse All, View (All or Untagged notes), Sort by, Show (Chat, Tabs, Tags in List), Theme (System, Light, Dark), New Tab, Open/Switch Namespace, Reminders, Export View as HTML and Log Out. The current choices are ticked.
+- The note menu is grouped: Copy Note, Paste, Add, Move, Outline, Focus, Export, the editing actions, and Delete Note last. Keyboard shortcuts show on the right of both menus, and actions that cannot happen from that note are hidden.
+- Move to Bottom (in Move, or ⇧⌘↓) puts a note after its last sibling, or after the view's last note (the last match in a search). The view stays put: the notes above keep their place and the ones below close the gap.
+- A down arrow under the up arrow goes to the bottom of the list, even when the end is not loaded yet; each arrow is dimmed when you are already at its end. Both arrows, and Focus ▸ Full Screen (now also offered while editing), save the note and leave edit mode first.
+- The right-click menu closes when the pointer moves well away from it, and keys pressed in full-screen view no longer reach the list behind it.
+
+## Changes in 0.15.0
+
+- Pasting JSON, a chess position (FEN), a diff, a Mermaid diagram or a LaTeX block tags the note for it as you paste: the plain tag into an empty note, `((…))` around the paste in a note that already has text. ⌘Z right after the paste removes the tag with it; ⇧⌘V pastes without detection.
+- New formats: `@code=python` (or any language) highlights code, `@diff` colours diffs, `@mermaid` draws a diagram without a Markdown fence, and `@chess` draws a FEN position as a board. JSON, code and diff blocks are more compact.
+- Switching namespace stays in one tab: on the login screen the panel clears as you pick and the other namespace's login screen fades in under the same logo, with no white flash. In the app, Open/Switch namespace offers Open in This Tab or Open in New Tab.
+- Tag suggestions: tags used elsewhere in the tree, or named in nearby notes, no longer get a boost; only the note's own text does. A new Tag Suggestions setting can also suggest tags that a parent or the rules already apply.
+- Change password with no password opens Add password, and Open/Switch namespace with only one namespace opens Create namespace. The AI tag-proposal menu items now say they are about AI-proposed tags.
+- Fixed: Add reminder did nothing (a missing title now says so); a password change could end on Session locked; right-clicking math or a Mermaid diagram showed the browser's menu; the Untagged notes × needed two clicks while editing a note; indented JSON and pie charts pasted into a note showed as invalid; a tiny scrollbar beside tall math; a white stripe and logo shift on the login screen with always-visible scrollbars.
+
 ## Changes in 0.14.0
 
 - A new login screen: one dark screen with the MetaList logo. The namespace, password and OK fade in together; once the password is accepted, the loading progress slides in with the current step and the seconds elapsed. When the first login after an update backs up and upgrades the namespace, a note under OK says so. The Session locked page has the same look, and there is no white flash between them.

{metalist-0.14.0 → metalist-0.16.0}/README.md

@@ -12,6 +12,23 @@ A minimalist single-user note-taking app focused on server-side rendering (SSR),
 - Multi-tab search contexts with server-persisted scroll/search state (survives browser restarts)
 - Manual namespace backups/restores to a user-selected backup folder with retention controls
 
+## Changes in 0.16.0
+
+- Right-clicking outside any note opens a fuller menu: Add/Paste Note at Top, Undo, Redo, Go to Top, Go to Bottom, Fully Expand/Collapse All, View (All or Untagged notes), Sort by, Show (Chat, Tabs, Tags in List), Theme (System, Light, Dark), New Tab, Open/Switch Namespace, Reminders, Export View as HTML and Log Out. The current choices are ticked.
+- The note menu is grouped: Copy Note, Paste, Add, Move, Outline, Focus, Export, the editing actions, and Delete Note last. Keyboard shortcuts show on the right of both menus, and actions that cannot happen from that note are hidden.
+- Move to Bottom (in Move, or ⇧⌘↓) puts a note after its last sibling, or after the view's last note (the last match in a search). The view stays put: the notes above keep their place and the ones below close the gap.
+- A down arrow under the up arrow goes to the bottom of the list, even when the end is not loaded yet; each arrow is dimmed when you are already at its end. Both arrows, and Focus ▸ Full Screen (now also offered while editing), save the note and leave edit mode first.
+- The right-click menu closes when the pointer moves well away from it, and keys pressed in full-screen view no longer reach the list behind it.
+
+## Changes in 0.15.0
+
+- Pasting JSON, a chess position (FEN), a diff, a Mermaid diagram or a LaTeX block tags the note for it as you paste: the plain tag into an empty note, `((…))` around the paste in a note that already has text. ⌘Z right after the paste removes the tag with it; ⇧⌘V pastes without detection.
+- New formats: `@code=python` (or any language) highlights code, `@diff` colours diffs, `@mermaid` draws a diagram without a Markdown fence, and `@chess` draws a FEN position as a board. JSON, code and diff blocks are more compact.
+- Switching namespace stays in one tab: on the login screen the panel clears as you pick and the other namespace's login screen fades in under the same logo, with no white flash. In the app, Open/Switch namespace offers Open in This Tab or Open in New Tab.
+- Tag suggestions: tags used elsewhere in the tree, or named in nearby notes, no longer get a boost; only the note's own text does. A new Tag Suggestions setting can also suggest tags that a parent or the rules already apply.
+- Change password with no password opens Add password, and Open/Switch namespace with only one namespace opens Create namespace. The AI tag-proposal menu items now say they are about AI-proposed tags.
+- Fixed: Add reminder did nothing (a missing title now says so); a password change could end on Session locked; right-clicking math or a Mermaid diagram showed the browser's menu; the Untagged notes × needed two clicks while editing a note; indented JSON and pie charts pasted into a note showed as invalid; a tiny scrollbar beside tall math; a white stripe and logo shift on the login screen with always-visible scrollbars.
+
 ## Changes in 0.14.0
 
 - A new login screen: one dark screen with the MetaList logo. The namespace, password and OK fade in together; once the password is accepted, the loading progress slides in with the current step and the seconds elapsed. When the first login after an update backs up and upgrades the namespace, a note under OK says so. The Session locked page has the same look, and there is no white flash between them.

{metalist-0.14.0 → metalist-0.16.0}/app/api/note_requests.py

@@ -60,6 +60,7 @@ class ViewDiffRequest(TypedDict):
     visibleTopRootId: Text | None
     visibleBottomRootId: Text | None
     isUntaggedView: bool
+    startAtListEnd: bool
 
 @with_config(ConfigDict(strict=True))
 class UpdateTabStateRequest(TypedDict):
@@ -272,6 +273,14 @@ class MoveNoteToTopEndpointRequest(TypedDict):
     undoContext: UndoContext
     viewport: Viewport
 
+@with_config(ConfigDict(strict=True))
+class MoveNoteToBottomEndpointRequest(TypedDict):
+    search_query: Text | None
+    tab_id: Identifier
+    clientId: Identifier
+    undoContext: UndoContext
+    viewport: Viewport
+
 @with_config(ConfigDict(strict=True))
 class IndentNoteEndpointRequest(TypedDict):
     visible_prev_id: Text | None

{metalist-0.14.0 → metalist-0.16.0}/app/api/routes/notes.py

@@ -38,6 +38,7 @@ from app.api.note_requests import (
     RunShellEndpointRequest,
     ToggleReferenceModeEndpointRequest,
     MoveNoteEndpointRequest,
+    MoveNoteToBottomEndpointRequest,
     MoveNoteToTopEndpointRequest,
     IndentNoteEndpointRequest,
     OutdentNoteEndpointRequest,
@@ -81,7 +82,7 @@ from app.usecases.tag_proposals import (
 )
 from app.usecases.delete_subtree import CmdDeleteSubtree
 from app.usecases.move import CmdMove
-from app.usecases.move_to_top import CmdMoveToTop
+from app.usecases.move_to_top import CmdMoveToBottom, CmdMoveToTop
 from app.usecases.prioritize import CmdPrioritize
 from app.usecases.alphabetize_root_notes import CmdAlphabetizeRootNotes
 from app.usecases.reset_updated_at import CmdResetUpdatedAtToCreatedAt
@@ -138,6 +139,7 @@ from app.services.link_titles import link_title_store
 from app.services.search_index import search_index
 from app.services.dictation_cleanup import clean_dictated_paste
 from app.services.tag_suggestions import suggest_tags_for_note
+from app.services.client_state_service import suggests_already_applying_tags
 from app.services.undo_state import reset_undo_stack
 from app.usecases.prioritize import list_prioritize_tag_suggestions
 from app.services.selected_text_tag import SelectedTextTagValidationError
@@ -277,6 +279,10 @@ def view_diff(payload: ViewDiffRequest):
     is_untagged_view = payload["isUntaggedView"]
     if not isinstance(is_untagged_view, bool):
         raise TypeError("isUntaggedView must be a boolean")
+    # Go to Bottom: load the band that ends at the view's last root.
+    start_at_list_end = payload["startAtListEnd"]
+    if not isinstance(start_at_list_end, bool):
+        raise TypeError("startAtListEnd must be a boolean")
     if not isinstance(tab_view_empty, bool):
         raise TypeError("tabViewEmpty must be a boolean")
 
@@ -328,6 +334,7 @@ def view_diff(payload: ViewDiffRequest):
         visible_top_root_id=visible_top_root_id,
         visible_bottom_root_id=visible_bottom_root_id,
         is_untagged_view=is_untagged_view,
+        start_at_list_end=start_at_list_end,
     )
     update_uuid = get_current_sync_uuid()
     root_ids = list(state.children_by_parent.get(None, []))
@@ -599,7 +606,7 @@ def dictation_paste(payload: DictationPasteRequest) -> Dict[str, object]:
 
 @router.post("/notes/tag-suggestions")
 @transactional_route
-def tag_suggestions(payload: TagSuggestionsRequest) -> Dict[str, object]:
+def tag_suggestions(request: Request, payload: TagSuggestionsRequest) -> Dict[str, object]:
     note_id = payload["note_id"]
     anchors = payload["anchors"]
     explicit_tags = payload["explicit_tags"]
@@ -626,6 +633,7 @@ def tag_suggestions(payload: TagSuggestionsRequest) -> Dict[str, object]:
         prefix=prefix,
         content_html=content_html,
         limit=MAX_TAG_SUGGESTIONS,
+        include_already_applying=suggests_already_applying_tags(token=_require_bearer_token(request)),
     )
     return {"suggestions": suggestions}
 
@@ -1097,8 +1105,19 @@ def move_note_endpoint(note_id: str, body: MoveNoteEndpointRequest):
 @router.post("/notes/{note_id}/move-to-top")
 @transactional_route
 def move_note_to_top_endpoint(note_id: str, body: MoveNoteToTopEndpointRequest):
+    return _move_note_to_edge(note_id, body, command_class=CmdMoveToTop, context="notes.move-to-top")
+
+
+@router.post("/notes/{note_id}/move-to-bottom")
+@transactional_route
+def move_note_to_bottom_endpoint(note_id: str, body: MoveNoteToBottomEndpointRequest):
+    return _move_note_to_edge(note_id, body, command_class=CmdMoveToBottom, context="notes.move-to-bottom")
+
+
+def _move_note_to_edge(note_id: str, body: MoveNoteToTopEndpointRequest, *, command_class: type, context: str):
+    """Move a note to the top or bottom of its siblings (of the view's roots for a root)."""
     viewport = _require_viewport(body)
-    _require_note_present(note_id, context="notes.move-to-top")
+    _require_note_present(note_id, context=context)
 
     search_query = body["search_query"]
     normalized_search: str | None = search_query
@@ -1117,7 +1136,7 @@ def move_note_to_top_endpoint(note_id: str, body: MoveNoteToTopEndpointRequest):
         new_parent_id=None,
     )
 
-    cmd = CmdMoveToTop(
+    cmd = command_class(
         note_id=note_id,
         search_query=normalized_search,
         client_id=body["clientId"],

{metalist-0.14.0 → metalist-0.16.0}/app/presentation/login_page.py

@@ -5,14 +5,19 @@ from __future__ import annotations
 from starlette.requests import Request
 
 from app.api.request_auth import AUTH_COOKIE_NAME
+from app.services.tokens import token_service
 
 
 def login_is_certainly_needed(request: Request) -> bool:
     """Whether a password namespace's page can open on the login screen at once,
     with no white page before the browser checks its session: a re-login was asked
-    for (the Session locked page's Go to Login), or the browser has no session."""
+    for (the Session locked page's Go to Login), or the browser has no session the
+    server still knows (no cookie, or one from a session that has ended)."""
     if not isinstance(request, Request):
         raise TypeError("request must be a Request")
     if request.query_params.get("force_reauth") == "1":
         return True
-    return request.cookies.get(AUTH_COOKIE_NAME) is None
+    cookie_token = request.cookies.get(AUTH_COOKIE_NAME)
+    if cookie_token is None:
+        return True
+    return not token_service.verify_token(cookie_token)

{metalist-0.14.0 → metalist-0.16.0}/app/services/agent/skills/help-ai.md

@@ -83,7 +83,7 @@ for missing bulk undo. Removing an accepted tag requires editing that note's tag
 which this chat workflow cannot do. An explanation of these limits does not itself
 request opening the proposal-management dialog.
 
-Manage tag proposals opens the bulk acceptance/removal form. Tagging vocabulary
+Accept or reject AI-proposed tags opens the bulk acceptance/removal form. AI tagging vocabulary
 chooses existing tags only, or existing and new tags. The AI's prompts and skills
 (including the tagging instructions and these help texts) are built into MetaList
 and cannot be edited, so the AI behaves the same for everyone; instructions saved

{metalist-0.14.0 → metalist-0.16.0}/app/services/agent/skills/help-data.md

@@ -2,7 +2,9 @@
 
 Namespaces isolate notes, preferences, tags, reminders, and authentication. A
 namespace is not a search tab. Search tabs are views within the same namespace.
-Switch namespace opens a picker of reachable namespaces. Create namespace opens
+Open/Switch namespace opens a picker of reachable namespaces with two buttons: Open in
+This Tab (switching keeps one tab) and Open in New Tab; with no other namespace
+yet it opens Create namespace instead. Create namespace opens
 a name/port form. Rename current namespace opens a rename form. Delete namespace
 opens a confirmation form; do not execute deletion or imply it has happened.
 Manage namespace ports edits saved future launch profiles; saving does not launch,

{metalist-0.14.0 → metalist-0.16.0}/app/services/agent/skills/help-dictation.md

@@ -53,7 +53,7 @@ fixed rules, no AI, and it only reacts to pasting: typed text is never changed.
   like an acronym (`GPT`). Each word is its own tag unless the words together match
   one of the user's tags; a new multi-word tag has to be typed.
 - **Other one-tag fields** (Edit Tag Relationships' search box, Add tag, Implied
-  tag, Synonym tag, Rename tag; Prioritize Tag; Manage tag proposals' tag filter):
+  tag, Synonym tag, Rename tag; Prioritize Tag; Accept or reject AI-proposed tags' tag filter):
   the whole paste becomes one tag, "Machine learning" gives `machine-learning`.
 - **Tag relationship conditions:** existing tags and quoted text; no regular
   expressions by voice.

{metalist-0.14.0 → metalist-0.16.0}/app/services/agent/skills/help-formatting.md

@@ -180,3 +180,38 @@ Other (non-meta) tags may also appear inside wrapper tokens (e.g. `{{foo bar}}`)
 - `@csv`: parses the note content as CSV and renders it as a table in view mode.
 - Invalid CSV shows a red "Invalid CSV" badge and the raw content.
 - Scoped wrappers (e.g. `((@csv))`) render only the wrapped region as a CSV table.
+
+## Chess meta tags
+- `@chess`: reads the note content as a FEN (Forsyth–Edwards Notation) position and draws it as a chess board in view mode, White at the bottom, files a–h and ranks 1–8 labelled. Example: `rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1` is the starting position.
+- Only the piece placement (the first field) is required. When the FEN has them, a caption under the board gives the side to move, the move number, castling rights and the en passant square.
+- Pieces use the chess symbols of the system font, coloured white or black. Hovering a square shows its name and piece (for example "e4 white pawn").
+- A FEN that does not parse shows a red "Invalid FEN" badge, what to fix, and the raw content.
+- Scoped wrappers (e.g. `((@chess))`) draw a board for only the wrapped FEN, inside the surrounding text.
+- One position per note or wrapper; whole games (PGN) are not supported.
+- A hidden extra: typed in the tag bar, not offered in the Add Style menu.
+
+## Diff meta tags
+- `@diff`: shows the note content as a unified diff (what `git diff` and `diff -u` print) in view mode: added lines (`+`) green, removed lines (`-`) red, section starts (`@@ -1,3 +1,3 @@`) purple, file headers (`---`, `+++`, `diff --git`) grey and bold, unchanged lines plain.
+- Lines jotted by hand with only `+`/`-` marks work too; nothing needs to parse, so there is no error state.
+- Scoped wrappers (e.g. `((@diff))`) colour only the wrapped region.
+
+## Code meta tags
+- `@code=<language>`: shows the note content as source code with syntax highlighting in view mode, for example `@code=python`, `@code=javascript`, `@code=sql`. One tag for every language: any name or alias the server's highlighter (Pygments) knows works (`py`, `js`, `c++`, `c#`...), case-insensitively. The language name is shown above the code.
+- An unknown language (`@code=pyhton`) shows the code plainly with an "Unknown language" badge.
+- Scoped wrappers (e.g. `((@code=sql))`) highlight only the wrapped region.
+
+## Mermaid meta tags
+- `@mermaid`: the note content is one Mermaid diagram (no Markdown fence needed), drawn in view mode like a fenced `mermaid` block under `@markdown`, in its own block. Until it is drawn, and when it is invalid (with an `Invalid Mermaid diagram` badge), the source shows as a code block.
+- Scoped wrappers (e.g. `((@mermaid))`) draw only the wrapped region.
+
+## Paste format detection
+- Pasting text in an unambiguous format tags the note for it at the moment of the paste (the tag appears in the tag bar; the text renders when the note leaves editing):
+  - JSON (a complete object or array) → `@json`
+  - a chess FEN position → `@chess`
+  - a unified diff (with `@@` section lines, `---`/`+++` headers, or `diff --git`) → `@diff`
+  - Mermaid starting with a diagram keyword (`graph TD`, `sequenceDiagram`, `gantt`...) → `@mermaid`; a fenced ```` ```mermaid ```` block → `@markdown`
+  - a pure LaTeX block (`$$...$$`, `\[...\]`, or `\begin{...}...\end{...}`) → `@LaTeX`
+- Into an otherwise empty note (or with all of its text selected), and when pasting creates a new note, the plain tag is added. Into a note with content, the pasted text is wrapped `((...))` and `((@json))` (etc.) is added, so the existing text is untouched.
+- Nothing is added for anything uncertain (prose, code, CSV, JSON-looking text that does not parse), when the note already has a renderer tag, when pasting inside an existing wrapped region, or when `((...))` is already in use in that note.
+- `⌘Z` right after the paste removes the added tag together with the pasted text (one undo step, like a normal paste). `⇧⌘V` (Ctrl+Shift+V) pastes as plain text without detection.
+- Implementation: `paste-format-detection-service.js` (detection and planning, tests in `tests/unit/paste_format_detection.test.mjs`), wired in `keyboard-events.js`.

{metalist-0.14.0 → metalist-0.16.0}/app/services/agent/skills/help-menus.md

@@ -19,9 +19,9 @@ Opening or dismissing the command palette does not clear undo/redo. Global actio
 
 ## Tag proposal controls
 
-- **Manage tag proposals** selects acceptance/removal, current context/entire namespace, and an exact case-insensitive tag filter (blank means all proposals). Apply executes directly without another confirmation, model call, or progress/cancellation modal; the normal busy spinner remains visible until completion.
-- **Remove all tag suggestions (current context)** asks for confirmation, then removes every pending proposal in the active search context. It uses the same atomic bulk path and requires no configuration form or model call. After confirmation, the normal busy spinner replaces the confirmation without opening a second modal.
-- **Tagging vocabulary** sets one categorical preference: existing tags only or allow new tags. The tagging instructions themselves are built in and cannot be edited.
+- **Accept or reject AI-proposed tags** (tags the AI chat proposed, not yet accepted) selects acceptance/removal, current context/entire namespace, and an exact case-insensitive tag filter (blank means all proposals). Apply executes directly without another confirmation, model call, or progress/cancellation modal; the normal busy spinner remains visible until completion.
+- **Reject all AI-proposed tags (current context)** asks for confirmation, then removes every pending proposal in the active search context. It uses the same atomic bulk path and requires no configuration form or model call. After confirmation, the normal busy spinner replaces the confirmation without opening a second modal.
+- **AI tagging vocabulary** sets one categorical preference: existing tags only or allow new tags. The tagging instructions themselves are built in and cannot be edited.
 - Generate proposals by explicitly requesting them in AI chat. Generation is not a menu action.
 
 ## Semantics
@@ -63,6 +63,7 @@ Opening or dismissing the command palette does not clear undo/redo. Global actio
 - Palette preferences (`pref.*`) and command usage history are persisted per namespace in the main SQLite DB via `/api2/auth/client-state*`, not in browser `localStorage`.
 - `Animated transitions` is on by default and controls UI motion such as tag-bar edit transitions and note expand/collapse transitions.
 - `Dictation Settings` sets the spoken phrases for pasted dictated text: the phrase that starts tags in a note (`start tags`), the phrases that start and end a quote (`quote`, `end quote`), and the phrase that excludes the next search term (`minus`). Each is words of letters, 2 to 64 characters; the quote and exclusion phrases must differ. Save applies them, Escape or a click outside closes without saving.
+- `Tag Suggestions` opens a settings window with one checkbox, saved immediately: `Allow suggesting tags that already apply` (off by default). On: tags a parent already has, and tags the rules imply from them, are suggested and ranked like any other tag. Off: they are left out until typed, then listed after the other matches.
 - `Visual Cues` opens one window of independent checkboxes, all on by default and saved immediately. Under Drag and drop: `Drag ghost` (a dashed outline of the dragged note and its visible children follows the pointer), `Drop indicator` (a grey landing line plus a faint outline on the note it lands beside or under), and `Direction cursor` (the mouse cursor itself becomes an up, down, indent or outdent icon for a possible move; impossible moves and the option turned off keep the usual grabbing hand). They change only what is shown; dragging works the same. Close the window with Escape or by clicking outside it.
 - `Note Layout & Appearance` stores namespace-scoped presets for top-level note size, child indentation, vertical spacing, note corners, and tag style. The defaults are `Larger`, `Standard`, `Comfortable`, `Round`, and `Pills` respectively. Note corners can be `Subtle`, `Rounded`, or `Round`; tag style shows visible note tags as outlined `Pills` or `Plain text` in both themes.
 - `Search suggestion stats & settings` is the single suggestion-personalization control surface. Its ordered 1–365 day slots and default-on time-window-label and one-credit-per-note-per-search-context toggles save immediately when changed. The modal also displays retained daily tag-credit statistics and provides the confirmed activity reset. An empty slot list disables personalization; the default slots are 1, 7, and 30 days.
@@ -89,7 +90,8 @@ Opening or dismissing the command palette does not clear undo/redo. Global actio
 - `Note Layout & Appearance`: previews and saves the note hierarchy presets. Search terms include `layout`, `appearance`, `font`, `size`, `spacing`, `indentation`, and `hierarchy`.
 - `Search suggestion stats & settings`: combines ordered personalized-window editing, promoted-suggestion label visibility, default-on per-context note-credit suppression, retained daily tag-credit statistics, and confirmed activity reset. It does not collect search text or note content.
 - `AI Agent Settings`: configures the OpenAI API key, model, cloud privacy policy, evidence-token limit, and tagging batch size. Model and thinking level are also selected beside chat Send. See `docs/ui/ai-chat.md`.
-- `Switch namespace`: opens a simple namespace picker, leaves the current namespace tab open, and opens the selected non-current namespace in a new browser tab. A running namespace with an unchanged launch profile keeps its process and warm cache; stopped namespaces launch, and changed port profiles restart the target. Each namespace still permits only one active browser tab/session.
+- `Open/Switch namespace`: opens a simple namespace picker with two buttons. `Open in This Tab` loads the selected non-current namespace in the same tab, on its login screen, so switching back and forth keeps one tab (Back returns to the previous namespace). `Open in New Tab` opens it in a new browser tab and leaves the current tab as it is. With no other namespace yet, it opens Create namespace instead.
+  Either way, a running namespace with an unchanged launch profile keeps its process and warm cache; stopped namespaces launch, and changed port profiles restart the target. Each namespace still permits only one active browser tab/session.
 - `Create namespace`: opens a namespace creation modal with defaulted HTTP / HTTPS ports that skip both saved MetaList reservations and ports with active OS listeners, saves the profile, launches the namespace, and opens it. Launch-time port races fail without terminating the process that owns the port. Running namespace servers revalidate their on-disk namespace identity every five seconds and terminate themselves if their database or launch profile disappears.
 - `Manage namespace ports`: opens a table of saved launch profiles from each namespace's main DB; saving this table only updates future launch profiles and does not switch tabs, launch namespaces, or restart the current process. Current-namespace port edits apply on the next MetaList launch.
 - `Delete namespace`: asks which namespace to delete, then opens a destructive confirmation view for that target. The confirm button is red and the user must type the namespace name. Deletion never requires the namespace password, so an inaccessible encrypted namespace can still be removed. Deleting the active namespace moves the tab to a dedicated namespace-removal status page; deleting an inactive namespace stays in the current tab and reports completion in the modal.

{metalist-0.14.0 → metalist-0.16.0}/app/services/agent/skills/help-notes.md

@@ -26,6 +26,7 @@ Sources: docs/ui/controls.md
 | `⌘ + ↑` | Move current note up (one visible sibling) |
 | `⇧ + ⌘ + ↑` | Move the selected root note to the top of the current root view (including filtered/search views), or move a child note to the top of its siblings |
 | `⌘ + ↓` | Move current note down (one visible sibling) |
+| `⇧ + ⌘ + ↓` | Move the selected note to the bottom (a child after its last sibling; a root after the view's last root, or last match in a search). The view stays put; editing ends with the note saved. |
 | `⌘ + C` | Copy selection (default), or copy whole note when no selection |
 | `⌘ + R` | Paste embedded reference from the most recently copied note UUID |
 | `⌘ + S` | Split note at selection/caret into sibling notes; selected segment becomes its own note |
@@ -148,7 +149,7 @@ On macOS, `⌘ + Y` normally opens Safari History rather than performing native
 |--------|--------|
 | Click `+` button | Add new note at top |
 | Click menu (`≡`) button | Open command palette |
-| Click `↑` button | Scroll the page to the top. |
+| Click `↑` / `↓` button | Go to the top / bottom of the list (bottom: the last note's bottom at the window's bottom); dimmed at that end. While editing, first saves and leaves edit mode. Unloaded notes are loaded by rebuilding the view at that end. |
 | Click note arrow | Toggle collapse/expand note. If the arrow is within the current edited note subtree, that edit session remains active; outside that subtree, the current edit saves/exits first. |
 | Click `⋮` under the edited note's tag bar | Expand that collapsed parent note to reveal its hidden children. |
 | Click note or blank space inside its outer card | Edit/select that note. Parent-note whitespace still counts as the parent until you click into a child note/card. What you clicked stays under the pointer while the note switches to its editable source, and the caret goes there: on the clicked text when it appears in the source (also when the source adds markup around it, such as `- ` list markers or `#` heading marks); on a Mermaid diagram box, at that box's label in the diagram source, with that source line under the pointer; elsewhere on a Mermaid diagram, at the start of its ```` ```mermaid ```` source, which starts where the diagram did; on a rendered LaTeX formula, at the start of its TeX source, which goes where the formula was. CSV rows, JSON keys and Markdown table rows map through their text. Leaving edit mode with the caret inside a formula's source keeps the rendered formula where that source was. |
@@ -162,17 +163,17 @@ On macOS, `⌘ + Y` normally opens Safari History rather than performing native
 | Click the tag bar while editing | Focus the tag input without re-selecting the note shell. Mouse or keyboard focus adds a soft focus ring and, when Animated Transitions is enabled, a single subtle outward halo. |
 | Click a Grammarly suggestion card | Keep the current note in edit mode while the assistant applies the correction. A subsequent ordinary outside click or `Escape` saves and exits as usual. |
 | Double-click a tag in the search input or tag bar | Select the complete tag, including prefixes and internal punctuation (`foo-bar`, `@red`), without surrounding whitespace. Scoped groups select only the individual tag. Quoted search text and tag-bar comments keep native word selection. |
-| Drag note body (while not editing) | Reorder among visible siblings based on vertical drop position (overshooting below the lowest sibling moves the note to the end of its siblings, and above the first sibling to the start; it never leaves its parent), or indent/outdent on horizontal drags. Once movement crosses the drag threshold, releasing back over the source note does not count as a click. While dragging, a dashed grey ghost of the note and its visible children follows the pointer on the drag's axis (vertical for reordering, horizontal for indent/outdent) and only within legal moves: between the first and lowest sibling, one level in under the note above, or one level out to the parent. A grey line marks where the note will land, with a faint outline on the note it lands beside or under; when a release would change nothing the ghost turns lighter and no line shows. The mouse cursor itself changes to name the action: an up or down arrow (the Move Note to Top icon and its mirror) for reordering, or indent/outdent icons for horizontal drags. A move that is not possible from there (dragging the first note up, indenting with nothing above to nest under, outdenting a root note) shows no icon, only the plain grabbing hand. The note lands where the drop line showed: its top on the line when moved up, its bottom on it when moved down, and the page does not scroll, whether the note is short or taller than the window. Only when that edge would land behind the search bar does the page scroll, just enough to put the note right below the bar with no extra space. Each of the three (ghost, drop indicator, direction cursor) can be turned on or off in the command palette's `Visual Cues` window; all are on by default and none changes the notes themselves. |
+| Drag note body (while not editing) | Reorder among visible siblings based on vertical drop position (overshooting below the lowest sibling moves the note to the end of its siblings, and above the first sibling to the start; it never leaves its parent), or indent/outdent on horizontal drags. Once movement crosses the drag threshold, releasing back over the source note does not count as a click. While dragging, a dashed grey ghost of the note and its visible children follows the pointer on the drag's axis (vertical for reordering, horizontal for indent/outdent) and only within legal moves: between the first and lowest sibling, one level in under the note above, or one level out to the parent. A grey line marks where the note will land, with a faint outline on the note it lands beside or under; when a release would change nothing the ghost turns lighter and no line shows. The mouse cursor itself changes to name the action: an up or down arrow (the Move to Top icon and its mirror) for reordering, or indent/outdent icons for horizontal drags. A move that is not possible from there (dragging the first note up, indenting with nothing above to nest under, outdenting a root note) shows no icon, only the plain grabbing hand. The note lands where the drop line showed: its top on the line when moved up, its bottom on it when moved down, and the page does not scroll, whether the note is short or taller than the window. Only when that edge would land behind the search bar does the page scroll, just enough to put the note right below the bar with no extra space. Each of the three (ghost, drop indicator, direction cursor) can be turned on or off in the command palette's `Visual Cues` window; all are on by default and none changes the notes themselves. |
 | Drag-select text in note | Available only in edit mode; releasing mouse outside note keeps edit mode + selection |
 | Right-click external link | Open a link-only context menu with `Copy Link` and `Open Link in New Tab`. Note actions are hidden for link targets. |
-| Right-click note | Open the note context menu (`Copy Note`, `View Full Screen`, `Paste Sibling Note`, `Paste Child Note`, `Paste Sibling Reference`, `Paste Child Reference`, `Add Sibling Note`, `Add Child Note`, `Delete Note`, `Move Note to Top`, `Fully Expand Note`, `Fully Collapse Note`, `Export Note as HTML`, `Export View as HTML`). Fully expanding/collapsing applies recursively to the selected note and all descendants, including descendants hidden by collapsed ancestors. A dark, non-interactive footer at the bottom always shows the note's locally formatted `Created` and `Updated` date/times. `View Full Screen` is available only outside edit mode; it renders the selected note edge-to-edge with its complete descendant subtree but without ancestors, hides the menu and scroll-to-top controls, and closes with the upper-right `×` or `Esc`. While actively editing that note, `Add Style` opens a connected formatting flyout and `Remove Formatting` performs the same operation as `Cmd/Ctrl+U`. Paste actions appear only when a note has been copied. |
-| Open in Floating Window (note menu) | Open that note and its complete descendant subtree in a read-only floating window. The title shows a ↗ reference link that opens the source note in ML3; password titles stay masked. Open multiple windows, drag the title-bar grip or empty space, and resize using the bottom-right handle (or focus the handle and use arrow keys). Windows stay fixed while the background scrolls and survive searches and ML3 tab changes. Saved changes appear live. Links, password/username copying, copyable text, and file downloads remain interactive; note references open another floating window. Close with × or Escape while focused. Windows close on page reload, logout, or namespace navigation. |
-| Right-click selected note text | Open the note context menu with `Copy` for the selected text instead of `Copy Note`; while editing, `Add Style` scopes the chosen formatting tag to that range and `Remove Formatting` removes formatting only from that range. |
+| Right-click note | Open the note menu: what you clicked (image, diagram or reference actions) first; `Copy Note`; `Paste ▸` (sibling/child note and reference, once a note is copied); `Add ▸` (sibling, child, and `Add Note at Top` outside edit mode); `Move ▸` (`Move to Top`, `Move Up`, `Move Down`, `Move to Bottom`); `Outline ▸` (`Fully Expand`, `Fully Collapse` for notes with children; `Indent`, `Outdent`); `Focus ▸` (`Full Screen`, `Floating Window`); `Export ▸` (note or view as HTML); while editing `Add Style`, `Remove Formatting`, `Add Excalidraw Diagram`; `Delete Note` last; a footer with Created/Updated times. Actions that cannot happen from that note are hidden (root moves too while a sort order is active); a group with one action shows it in place. Shortcuts show on the right. Moves act on the clicked note, saving another edited note first. Full Screen shows the note and its whole subtree edge-to-edge (no ancestors); from edit mode it first leaves edit mode as `Esc` would; close with `×` or `Esc`. |
+| Focus ▸ Floating Window (note menu) | Open that note and its complete descendant subtree in a read-only floating window. The title shows a ↗ reference link that opens the source note in ML3; password titles stay masked. Open multiple windows, drag the title-bar grip or empty space, and resize using the bottom-right handle (or focus the handle and use arrow keys). Windows stay fixed while the background scrolls and survive searches and ML3 tab changes. Saved changes appear live. Links, password/username copying, copyable text, and file downloads remain interactive; note references open another floating window. Close with × or Escape while focused. Windows close on page reload, logout, or namespace navigation. |
+| Right-click selected note text | Open the note menu with `Copy` and `Add as Tag` for the selected text instead of `Copy Note`; while editing, `Add Style` scopes the chosen formatting tag to that range and `Remove Formatting` removes formatting only from that range. |
 | Right-click image in note | Adds image actions to the note context menu: `Copy Image`, `Save Image`, `Zoom Image`, `Open Image in New Tab` |
 | Right-click anywhere in a completed AI response bubble (including padding and links) | Choose `Copy Response` to place its raw Markdown on the MetaList note clipboard with `@markdown @llm`, while also writing rendered HTML and raw Markdown to the system clipboard. It can be pasted as a note but not as a reference until inserted. |
-| Right-click notes view background | Outside edit mode, open the view context menu with dynamic `Show/Hide Tabs`, `Show/Hide AI Chat`, `Show/Hide Tags in List`, a `Sort by` submenu, and `Export View as HTML` actions |
+| Right-click notes view background | Open the view menu: outside edit mode `Add Note at Top`, `Paste Note at Top` (once a note is copied), `Undo`, `Redo`; `Go to Top`, `Go to Bottom` (unless at that end), `Fully Expand All`, `Fully Collapse All`; `View ▸` (All / Untagged notes), `Sort by ▸`, `Show ▸` (Chat, Tabs, Tags in List), `Theme ▸` (System, Light, Dark), each ticking the current choice; `New Tab`, `Open/Switch Namespace…`, `Reminders…`; `Export View as HTML`; `Log Out`. Shortcuts show on the right; items that do not apply are hidden. |
 | Right-click tag in search input, tag bar, or their suggestion lists | Open tag context menu (Edit Tag Relationships). If a note is being edited, it is saved and the view refresh completes first, restoring view-only rendering such as cached URL titles. |
-| Right-click left or right lane | Open the same view menu: show/hide tabs, AI chat, or note-list tags, choose a sort mode, or export the current view as HTML |
+| Right-click left or right lane | Open the same view menu |
 | Hover left side of search bar | Show the tab/search-context overlay |
 | Hover/click search input | Hide the tab/search-context overlay |
 
@@ -200,7 +201,7 @@ On macOS, `⌘ + Y` normally opens Safari History rather than performing native
 
 > Note: On Windows/Linux, use `Ctrl` instead of `⌘` (Command)
 
-App menus close with `Escape` or an outside click. Every modal has a standard upper-right circular `×` matching full-screen note view and also closes with `Escape` or an outside click. Dismiss-only footer `Close`/`OK` buttons are omitted; `Enter` still submits a modal's declared primary workflow action.
+App menus close with `Escape` or an outside click. The right-click menu also closes once the pointer moves about 28px away from it and any open submenu, like the tab overlay; small movements just past its edge keep it open. Every modal has a standard upper-right circular `×` matching full-screen note view and also closes with `Escape` or an outside click. Dismiss-only footer `Close`/`OK` buttons are omitted; `Enter` still submits a modal's declared primary workflow action.
 
 When `Show tags in list` is enabled, the grey right-aligned tag column wraps and is capped at 25% of its note row so note content retains the majority of the available width.
 

{metalist-0.14.0 → metalist-0.16.0}/app/services/agent/skills/help-privacy.md

@@ -120,7 +120,8 @@ current loading step and the seconds elapsed. When a database upgrade is due,
 that login takes longer. "Session locked" means the session moved to another tab
 or device; Go to Login opens the login screen.
 
-The Add password, Change password, and Remove password menus open forms. Opening
+The Add password, Change password, and Remove password menus open forms. Change
+password in a namespace with no password opens the Add password form. Opening
 is not submitting. An encryption explanation alone does not request a form or a
 password change. Never ask for an actual password or API key in chat.
 

{metalist-0.14.0 → metalist-0.16.0}/app/services/agent/skills/help-releases.md

@@ -5,6 +5,23 @@ README. Changes made after the newest listed version are not described here.
 Compare with installed_version from the help lookup to tell the user whether
 they already have a release. Version info offers updates (see the data topic).
 
+## 0.16.0
+
+- Right-clicking outside any note opens a fuller menu: Add/Paste Note at Top, Undo, Redo, Go to Top, Go to Bottom, Fully Expand/Collapse All, View (All or Untagged notes), Sort by, Show (Chat, Tabs, Tags in List), Theme (System, Light, Dark), New Tab, Open/Switch Namespace, Reminders, Export View as HTML and Log Out. The current choices are ticked.
+- The note menu is grouped: Copy Note, Paste, Add, Move, Outline, Focus, Export, the editing actions, and Delete Note last. Keyboard shortcuts show on the right of both menus, and actions that cannot happen from that note are hidden.
+- Move to Bottom (in Move, or ⇧⌘↓) puts a note after its last sibling, or after the view's last note (the last match in a search). The view stays put: the notes above keep their place and the ones below close the gap.
+- A down arrow under the up arrow goes to the bottom of the list, even when the end is not loaded yet; each arrow is dimmed when you are already at its end. Both arrows, and Focus ▸ Full Screen (now also offered while editing), save the note and leave edit mode first.
+- The right-click menu closes when the pointer moves well away from it, and keys pressed in full-screen view no longer reach the list behind it.
+
+## 0.15.0
+
+- Pasting JSON, a chess position (FEN), a diff, a Mermaid diagram or a LaTeX block tags the note for it as you paste: the plain tag into an empty note, `((…))` around the paste in a note that already has text. ⌘Z right after the paste removes the tag with it; ⇧⌘V pastes without detection.
+- New formats: `@code=python` (or any language) highlights code, `@diff` colours diffs, `@mermaid` draws a diagram without a Markdown fence, and `@chess` draws a FEN position as a board. JSON, code and diff blocks are more compact.
+- Switching namespace stays in one tab: on the login screen the panel clears as you pick and the other namespace's login screen fades in under the same logo, with no white flash. In the app, Open/Switch namespace offers Open in This Tab or Open in New Tab.
+- Tag suggestions: tags used elsewhere in the tree, or named in nearby notes, no longer get a boost; only the note's own text does. A new Tag Suggestions setting can also suggest tags that a parent or the rules already apply.
+- Change password with no password opens Add password, and Open/Switch namespace with only one namespace opens Create namespace. The AI tag-proposal menu items now say they are about AI-proposed tags.
+- Fixed: Add reminder did nothing (a missing title now says so); a password change could end on Session locked; right-clicking math or a Mermaid diagram showed the browser's menu; the Untagged notes × needed two clicks while editing a note; indented JSON and pie charts pasted into a note showed as invalid; a tiny scrollbar beside tall math; a white stripe and logo shift on the login screen with always-visible scrollbars.
+
 ## 0.14.0
 
 - A new login screen: one dark screen with the MetaList logo. The namespace, password and OK fade in together; once the password is accepted, the loading progress slides in with the current step and the seconds elapsed. When the first login after an update backs up and upgrades the namespace, a note under OK says so. The Session locked page has the same look, and there is no white flash between them.

{metalist-0.14.0 → metalist-0.16.0}/app/services/agent/skills/help-tags.md

@@ -100,6 +100,16 @@ Examples (autocorrected while typing):
 - CSV meta tags:
   - `@csv` renders note content as a CSV table; invalid CSV shows an error badge and raw text.
   - `((@csv))` renders only the wrapped content as a CSV table.
+- Chess meta tags:
+  - `@chess` draws the note's FEN chess position as a board (White at the bottom, with a caption for side to move, move number, castling and en passant); an invalid FEN shows an error badge saying what to fix.
+  - `((@chess))` draws a board for only the wrapped FEN, inside the surrounding text.
+- Diff meta tags:
+  - `@diff` colours a unified diff (git diff / diff -u): added lines green, removed red, `@@` section starts and file headers marked; `((@diff))` colours only the wrapped content.
+- Mermaid meta tags:
+  - `@mermaid` draws the note content as one Mermaid diagram (no Markdown fence needed); `((@mermaid))` draws only the wrapped content.
+- Pasting JSON, a chess FEN, a unified diff, Mermaid or a pure LaTeX block adds the matching tag at once (`@json`, `@chess`, `@diff`, `@mermaid`, `@LaTeX`): the plain tag into an otherwise empty note, `((...))` and `((@json))` into a note with content. ⌘Z right after removes it with the paste; ⇧⌘V pastes without detection.
+- Code meta tags:
+  - `@code=<language>` (for example `@code=python`, `@code=sql`) highlights source code; any language name the highlighter knows works, and an unknown one shows an "Unknown language" badge; `((@code=python))` highlights only the wrapped content.
 
 Wrapper regions in note content are always allowed (e.g. `((foo))`), but they are only consumed/hidden in view mode when there is a matching scoped wrapper tag in the tag bar (meta tags like `{{@red}}` or regular tags like `{{foo}}`). Otherwise the wrappers remain literal text.
 
@@ -136,7 +146,7 @@ Unclosed comments behave like unclosed wrappers:
 - Tags that match phrases in the current note content and the strongest direct co-occurrence hits from the current note's explicit non-meta tags share the top slots together: the strongest content hit appears first, then the strongest co-occurrence hit, then the next content hit, and so on.
 - Within those content hits, an exact standalone tag written in the current note is prioritized ahead of synonym-expanded recommendations. This keeps a specific literal such as `suprapubic` ahead of a generic ontology representative derived from an earlier word such as `message`.
 - For blank-prefix suggestions only, if a candidate's literal content match is driven entirely by segments that are already represented in an explicit or inherited tag on the note, that candidate is suppressed as redundant. Example: with `fat.appearance` already present, content-only matches like `fat-loss` or `body-fat` do not crowd out unrelated co-occurrence suggestions such as `overindulging`.
-- After that, suggestions are boosted by nearby hierarchy context: explicit tags and literal content matches from the current note's descendants, nearby sibling subtree, and ancestor note content.
+- Where the note sits in the tree gives no boost: tags used on its children, siblings or anywhere under its parent, and tag names written in those notes' or its ancestors' text, compete like any other tag (they are not left out). A tag on two of three children does not belong on the parent, and a sibling naming Kyoto says nothing about this note. Only the note's own text counts.
 - Remaining suggestions fall back to other notes whose effective context overlaps the current note's explicit/inherited/inferred non-meta tags, but the emitted non-meta suggestions still come only from explicit tags assigned on those notes.
 - A literal content hit on any connector-separated segment can also surface a tag, but low-signal glue segments like `and`, `no`, `of`, `the`, `to`, or `up` do not count on their own. They still participate in exact full-phrase literal matches, so content like `No Kings` can strongly promote `no-kings` even though bare `no` would not.
 - Connector-heavy tags need near-complete literal coverage before they surface from content alone: after ignoring numeric-only chunks, a tag with `k` remaining connector-separated chunks requires at least `max(1, k-1)` meaningful matches, capped by its number of meaningful non-noise chunks. Thus `gpt-6-astra` behaves like `gpt-astra`: either `GPT` or `Astra` can surface it. Decimal versions such as `5.6` are ignored in the same way. `X-Y-Z` still needs two matches and cannot surface from just `X`, `Y`, or `Z`.
@@ -150,7 +160,7 @@ Unclosed comments behave like unclosed wrappers:
 - Ontology-equivalent tags are usually collapsed to one displayed suggestion. The representative is the most-used eligible tag spelling explicitly written in tag bars, not the ontology-inferred search frequency, but prefix filtering happens first, so typing `emo` can still show `emotion` even if `mood` is the more common synonym overall. If the current note content exactly matches a synonym alias, that alias can still appear immediately after the common representative within the interleaved content/co-occurrence ordering.
 - Tags declared in ontology rules remain eligible for literal-content matching and typed-prefix completion even when they have never been explicitly assigned to a note. With a blank prefix, unrelated unused ontology tags are not added as generic fallback suggestions.
 - Tags already present explicitly in the current tag bar are never suggested.
-- Tags already present only via inheritance or ontology inference are suppressed unless they match the prefix. For one-character prefixes they come right after the suggestions with evidence; for longer prefixes they appear at the bottom.
+- Tags already present only via inheritance or ontology inference are suppressed unless they match the prefix. For one-character prefixes they come right after the suggestions with evidence; for longer prefixes they appear at the bottom. The **Tag Suggestions** settings dialog has `Allow suggesting tags that already apply` (off by default): when on, tags a parent already has and tags the rules imply from them are ranked like any other tag. Tags written in the note's own bar are still never suggested.
 - Suggestions appear below the tag bar when there is room; if the tag bar is near the bottom, the list flips upward but keeps the same best-on-top ordering and initial scroll position.
 - The server returns at most `MAX_TAG_SUGGESTIONS` note tag suggestions; the default is 20.