vertex-notes 0.3.3 → 0.3.4

package/README.md

@@ -1,130 +1,130 @@
-# ▲ Vertex CLI
-
-**Your knowledge, structured — from the terminal.**
-
-Vertex is a keyboard-first knowledge workspace. This CLI gives you full access to your notes, todos, tags, and search from the command line.
-
-## Install
-
-```bash
-npm install -g vertex-notes
-```
-
-## Quick Start
-
-```bash
-vertex login          # Log in with GitHub, Google, or Email
-vertex notes          # List all your notes
-vertex today          # Open daily note in interactive mode
-vertex capture "idea" # Quick capture to Inbox
-```
-
-## Commands
-
-### Auth
-| Command | Description |
-|---------|-------------|
-| `vertex login` | Log in (GitHub, Google, or Email) |
-| `vertex logout` | Log out and clear session |
-| `vertex whoami` | Show logged-in user |
-
-### Notes
-| Command | Description |
-|---------|-------------|
-| `vertex notes` | List all notes |
-| `vertex new [title]` | Create a new note |
-| `vertex view <title>` | View note as markdown |
-| `vertex edit <title>` | Edit in $EDITOR (vim/nano/code) |
-| `vertex daily` | View or create today's daily note |
-| `vertex daily --last` | View the most recent daily note |
-
-### Interactive Mode
-
-Open any note in a terminal UI with todo toggling:
-
-```bash
-vertex today                 # Latest daily note
-vertex interactive <title>   # Any note
-```
-
-**Controls:**
-
-| Key | Action |
-|-----|--------|
-| `↑ ↓` | Move between items |
-| `Enter` | Toggle todo done/undone |
-| `t` | Add new todo |
-| `n` | Add new text line |
-| `d` | Delete item at cursor |
-| `s` | Save changes |
-| `q` | Save and quit |
-
-### Capture & Search
-
-```bash
-vertex capture "buy groceries"           # Quick capture to Inbox
-vertex search "keyword"                  # Full-text search
-vertex search "#tag"                     # Search by tag
-vertex search "type:todo status:open"    # Open todos
-vertex tags                              # List all tags
-```
-
-### Export
-
-```bash
-vertex export "Meeting Notes"            # Print as markdown
-vertex export "Meeting Notes" --json     # Print as JSON
-vertex export "Meeting Notes" -o out.md  # Save to file
-```
-
-### Trash
-
-```bash
-vertex delete <title>    # Move to trash
-vertex restore <title>   # Restore from trash
-vertex trash             # List trashed notes
-vertex trash:empty       # Permanently delete all
-```
-
-### Info
-
-```bash
-vertex status    # Storage usage, note count
-vertex help      # Full help with all commands
-```
-
-## Editor Syntax
-
-When using `vertex edit`, you write in markdown:
-
-```markdown
-# Heading
-**bold** *italic* `code` ~~strike~~
-- Bullet list
-1. Numbered list
-- [x] Done task
-- [ ] Open task
-> Blockquote
-[[Wiki Link]] #tagname
-```
-
-Code blocks, math blocks (`$$ ... $$`), and standard markdown all work. Rich blocks (mermaid, callouts, file uploads) require the [web app](https://vertex-alu.pages.dev).
-
-## Architecture
-
-The CLI shares the same backend as the Vertex web app:
-
-- **Database**: Supabase (PostgreSQL with RLS)
-- **Auth**: Supabase Auth (GitHub, Google, Email)
-- **Storage**: Cloudflare R2
-
-Notes created in the CLI appear in the web app and vice versa.
-
-## Requirements
-
-- Node.js 18+
-- A Vertex account (sign up via `vertex login`)
-
-## License
-
-MIT
+# ▲ Vertex CLI
+
+**Your knowledge, structured — from the terminal.**
+
+Vertex is a keyboard-first knowledge workspace. This CLI gives you full access to your notes, todos, tags, and search from the command line.
+
+## Install
+
+```bash
+npm install -g vertex-notes
+```
+
+## Quick Start
+
+```bash
+vertex login          # Log in with GitHub, Google, or Email
+vertex notes          # List all your notes
+vertex today          # Open daily note in interactive mode
+vertex capture "idea" # Quick capture to Inbox
+```
+
+## Commands
+
+### Auth
+| Command | Description |
+|---------|-------------|
+| `vertex login` | Log in (GitHub, Google, or Email) |
+| `vertex logout` | Log out and clear session |
+| `vertex whoami` | Show logged-in user |
+
+### Notes
+| Command | Description |
+|---------|-------------|
+| `vertex notes` | List all notes |
+| `vertex new [title]` | Create a new note |
+| `vertex view <title>` | View note as markdown |
+| `vertex edit <title>` | Edit in $EDITOR (vim/nano/code) |
+| `vertex daily` | View or create today's daily note |
+| `vertex daily --last` | View the most recent daily note |
+
+### Interactive Mode
+
+Open any note in a terminal UI with todo toggling:
+
+```bash
+vertex today                 # Latest daily note
+vertex interactive <title>   # Any note
+```
+
+**Controls:**
+
+| Key | Action |
+|-----|--------|
+| `↑ ↓` | Move between items |
+| `Enter` | Toggle todo done/undone |
+| `t` | Add new todo |
+| `n` | Add new text line |
+| `d` | Delete item at cursor |
+| `s` | Save changes |
+| `q` | Save and quit |
+
+### Capture & Search
+
+```bash
+vertex capture "buy groceries"           # Quick capture to Inbox
+vertex search "keyword"                  # Full-text search
+vertex search "#tag"                     # Search by tag
+vertex search "type:todo status:open"    # Open todos
+vertex tags                              # List all tags
+```
+
+### Export
+
+```bash
+vertex export "Meeting Notes"            # Print as markdown
+vertex export "Meeting Notes" --json     # Print as JSON
+vertex export "Meeting Notes" -o out.md  # Save to file
+```
+
+### Trash
+
+```bash
+vertex delete <title>    # Move to trash
+vertex restore <title>   # Restore from trash
+vertex trash             # List trashed notes
+vertex trash:empty       # Permanently delete all
+```
+
+### Info
+
+```bash
+vertex status    # Storage usage, note count
+vertex help      # Full help with all commands
+```
+
+## Editor Syntax
+
+When using `vertex edit`, you write in markdown:
+
+```markdown
+# Heading
+**bold** *italic* `code` ~~strike~~
+- Bullet list
+1. Numbered list
+- [x] Done task
+- [ ] Open task
+> Blockquote
+[[Wiki Link]] #tagname
+```
+
+Code blocks, math blocks (`$$ ... $$`), and standard markdown all work. Rich blocks (mermaid, callouts, file uploads) require the [web app](https://vertex-alu.pages.dev).
+
+## Architecture
+
+The CLI shares the same backend as the Vertex web app:
+
+- **Database**: Supabase (PostgreSQL with RLS)
+- **Auth**: Supabase Auth (GitHub, Google, Email)
+- **Storage**: Cloudflare R2
+
+Notes created in the CLI appear in the web app and vice versa.
+
+## Requirements
+
+- Node.js 18+
+- A Vertex account (sign up via `vertex login`)
+
+## License
+
+MIT

package/bin/run.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-
-import { execute } from "@oclif/core";
-await execute({ dir: import.meta.url });
+
+import { execute } from "@oclif/core";
+await execute({ dir: import.meta.url });

package/dist/{chunk-LXT34CD7.js → chunk-QQO4JMNC.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-DRIWYEQE.js";
 import {
   createSupabaseClient
-} from "./chunk-K5SQERJ7.js";
+} from "./chunk-XJVEK2OB.js";
 
 // src/lib/client.ts
 var cachedClient = null;

package/dist/{chunk-K5SQERJ7.js → chunk-XJVEK2OB.js}

@@ -1,10 +1,14 @@
 // ../core/dist/index.js
 import { createClient } from "@supabase/supabase-js";
+import { WebSocket } from "ws";
 function createSupabaseClient(url, anonKey) {
   return createClient(url, anonKey, {
     auth: {
       autoRefreshToken: true,
       persistSession: true
+    },
+    realtime: {
+      transport: WebSocket
     }
   });
 }
@@ -198,11 +202,28 @@ async function getUserTags(client, userId) {
   if (error) throw error;
   return data ?? [];
 }
+async function deleteTag(client, tagId) {
+  const { error } = await client.from("tags").delete().eq("id", tagId);
+  if (error) throw error;
+}
 async function addTagEdge(client, userId, parentId, childId) {
   const { data, error } = await client.from("tag_edges").insert({ parent_id: parentId, child_id: childId, user_id: userId }).select().single();
   if (error) throw error;
   return data;
 }
+async function removeTagEdge(client, parentId, childId) {
+  const { error } = await client.from("tag_edges").delete().eq("parent_id", parentId).eq("child_id", childId);
+  if (error) throw error;
+}
+async function getTagChildren(client, tagId) {
+  const { data, error } = await client.from("tag_edges").select("child_id").eq("parent_id", tagId);
+  if (error) throw error;
+  if (!data || data.length === 0) return [];
+  const childIds = data.map((e) => e.child_id);
+  const { data: tags, error: tagErr } = await client.from("tags").select("*").in("id", childIds);
+  if (tagErr) throw tagErr;
+  return tags ?? [];
+}
 async function getTagDescendants(client, tagId) {
   const { data, error } = await client.rpc("get_tag_descendants", {
     root_tag_id: tagId
@@ -252,6 +273,29 @@ async function getBlocksForNote(client, noteId) {
   return data ?? [];
 }
 var saveLocks = /* @__PURE__ */ new Map();
+var tagPathCache = /* @__PURE__ */ new Map();
+var TAG_PATH_REGEX = /#([a-zA-Z][a-zA-Z0-9_-]*(?:\/[a-zA-Z][a-zA-Z0-9_-]*)*)/g;
+function extractAllTagPaths(blockRows) {
+  const paths = /* @__PURE__ */ new Set();
+  for (const block of blockRows) {
+    let m;
+    while ((m = TAG_PATH_REGEX.exec(block.content)) !== null) {
+      paths.add(m[1].toLowerCase());
+    }
+  }
+  return paths;
+}
+function setsAreEqual(a, b) {
+  if (a.size !== b.size) return false;
+  for (const item of a) {
+    if (!b.has(item)) return false;
+  }
+  return true;
+}
+async function getNoteTagPathsFromDb(client, noteId) {
+  const { data } = await client.from("note_tags").select("tag_path").eq("note_id", noteId);
+  return new Set((data ?? []).map((r) => r.tag_path));
+}
 async function saveNoteContent(client, noteId, userId, tiptapJson) {
   const existing = saveLocks.get(noteId);
   const doSave = async () => {
@@ -279,35 +323,73 @@ async function _saveNoteContentInner(client, noteId, userId, tiptapJson) {
     metadata: { tiptap: node }
   }));
   if (blocksToInsert.length === 0) return;
-  const { error } = await client.from("blocks").delete().eq("note_id", noteId);
-  if (error) throw error;
+  const { data: existingBlocks } = await client.from("blocks").select("id").eq("note_id", noteId);
+  const oldBlockIds = (existingBlocks ?? []).map((b) => b.id);
   const { error: insertError } = await client.from("blocks").insert(blocksToInsert);
   if (insertError) throw insertError;
+  if (oldBlockIds.length > 0) {
+    const { error: deleteError } = await client.from("blocks").delete().in("id", oldBlockIds);
+    if (deleteError) throw deleteError;
+  }
   const { data: insertedBlocks } = await client.from("blocks").select("id, content, type").eq("note_id", noteId).order("position");
   const blockRows = insertedBlocks ?? [];
-  await client.from("block_tags").delete().in("block_id", blockRows.map((b) => b.id));
-  await client.from("note_tags").delete().eq("note_id", noteId);
-  const noteTagIds = /* @__PURE__ */ new Set();
-  const SKIP_TAG_TYPES = /* @__PURE__ */ new Set(["code", "mermaid", "math", "image", "divider", "chart", "file"]);
-  for (const block of blockRows) {
-    if (SKIP_TAG_TYPES.has(block.type)) continue;
-    const leafTags = extractLeafTags(block.content);
-    for (const tagName of leafTags) {
-      const tag = await getOrCreateTag(client, userId, tagName);
-      await addBlockTag(client, block.id, tag.id).catch(() => {
-      });
-      noteTagIds.add(tag.id);
+  const currentPaths = extractAllTagPaths(blockRows);
+  const prevPaths = tagPathCache.get(noteId);
+  if (prevPaths && setsAreEqual(currentPaths, prevPaths)) {
+  } else {
+    let oldPathsForCleanup = prevPaths;
+    if (!oldPathsForCleanup) {
+      oldPathsForCleanup = await getNoteTagPathsFromDb(client, noteId);
     }
-    const scopedTags = extractScopedTags(block.content);
-    for (const { parent, child } of scopedTags) {
-      const parentTag = await getOrCreateTag(client, userId, parent);
-      const childTag = await getOrCreateTag(client, userId, child);
-      await addTagEdge(client, userId, parentTag.id, childTag.id).catch(() => {
-      });
+    await client.from("block_tags").delete().in("block_id", blockRows.map((b) => b.id));
+    await client.from("note_tags").delete().eq("note_id", noteId);
+    const SKIP_TAG_TYPES = /* @__PURE__ */ new Set(["code", "mermaid", "math", "image", "divider", "chart", "file", "summary"]);
+    const insertedNoteTags = [];
+    for (const block of blockRows) {
+      if (SKIP_TAG_TYPES.has(block.type)) continue;
+      const tagPaths = extractTagPaths(block.content);
+      for (const tagPath of tagPaths) {
+        const segments = tagPath.split("/");
+        const leafName = segments[segments.length - 1];
+        const tag = await getOrCreateTag(client, userId, leafName);
+        await addBlockTag(client, block.id, tag.id).catch(() => {
+        });
+        insertedNoteTags.push({ note_id: noteId, tag_id: tag.id, tag_path: tagPath });
+      }
+      const scopedTags = extractScopedTags(block.content);
+      for (const { parent, child } of scopedTags) {
+        const parentTag = await getOrCreateTag(client, userId, parent);
+        const childTag = await getOrCreateTag(client, userId, child);
+        await addTagEdge(client, userId, parentTag.id, childTag.id).catch(() => {
+        });
+      }
+    }
+    const seen = /* @__PURE__ */ new Set();
+    for (const nt of insertedNoteTags) {
+      if (seen.has(nt.tag_path)) continue;
+      seen.add(nt.tag_path);
+      await client.from("note_tags").upsert({ note_id: nt.note_id, tag_id: nt.tag_id, tag_path: nt.tag_path }, { onConflict: "note_id,tag_path" });
+    }
+    tagPathCache.set(noteId, currentPaths);
+    if (oldPathsForCleanup) {
+      const oldEdges = extractEdgesFromPaths(oldPathsForCleanup);
+      const newEdges = extractEdgesFromPaths(currentPaths);
+      const edgesToRemove = oldEdges.filter(
+        (oe) => !newEdges.some((ne) => ne.parent === oe.parent && ne.child === oe.child)
+      );
+      for (const { parent: parentName, child: childName } of edgesToRemove) {
+        const parentTag = await getOrCreateTag(client, userId, parentName);
+        const childTag = await getOrCreateTag(client, userId, childName);
+        await removeTagEdge(client, parentTag.id, childTag.id).catch(() => {
+        });
+        const { count: parentNoteTagCount } = await client.from("note_tags").select("*", { count: "exact", head: true }).eq("tag_id", parentTag.id);
+        const children = await getTagChildren(client, parentTag.id);
+        if (parentNoteTagCount === 0 && children.length === 0) {
+          await deleteTag(client, parentTag.id).catch(() => {
+          });
+        }
+      }
     }
-  }
-  for (const tagId of noteTagIds) {
-    await client.from("note_tags").upsert({ note_id: noteId, tag_id: tagId }, { onConflict: "note_id,tag_id" });
   }
   const fullText = blockRows.map((b) => b.content).join(" ");
   const wikiLinkTitles = extractWikiLinks(fullText);
@@ -330,6 +412,7 @@ function mapTiptapTypeToBlockType(tiptapType) {
     mathBlock: "math",
     calloutBlock: "callout",
     queryBlock: "query",
+    summaryBlock: "summary",
     horizontalRule: "divider",
     fileBlock: "file",
     linkPreview: "text",
@@ -347,21 +430,26 @@ function extractPlainText(node) {
   if (!content) return "";
   return content.map(extractPlainText).join("");
 }
-function extractLeafTags(text) {
+function extractTagPaths(text) {
   const matches = text.match(/#([a-zA-Z][a-zA-Z0-9_-]*(?:\/[a-zA-Z][a-zA-Z0-9_-]*)*)/g);
   if (!matches) return [];
   const tags = /* @__PURE__ */ new Set();
   for (const m of matches) {
-    const full = m.slice(1).toLowerCase();
-    if (full.includes("/")) {
-      const parts = full.split("/");
-      tags.add(parts[parts.length - 1]);
-    } else {
-      tags.add(full);
-    }
+    tags.add(m.slice(1).toLowerCase());
   }
   return [...tags];
 }
+function extractEdgesFromPaths(paths) {
+  const edges = [];
+  for (const path of paths) {
+    if (!path.includes("/")) continue;
+    const segments = path.split("/");
+    for (let i = 0; i < segments.length - 1; i++) {
+      edges.push({ parent: segments[i], child: segments[i + 1] });
+    }
+  }
+  return edges;
+}
 function extractScopedTags(text) {
   const matches = text.match(/#([a-zA-Z][a-zA-Z0-9_-]*(?:\/[a-zA-Z][a-zA-Z0-9_-]*)+)/g);
   if (!matches) return [];
@@ -393,11 +481,23 @@ async function fullTextSearch(client, userId, query, limit = 30) {
   });
 }
 async function searchByTag(client, userId, tagName, includeDescendants = true) {
-  let tagQuery = client.from("tags").select("id").eq("user_id", userId);
-  if (tagName) {
-    tagQuery = tagQuery.ilike("name", `${tagName}%`);
+  if (tagName.includes("/")) {
+    const matchPattern = includeDescendants ? `${tagName}%` : tagName;
+    const { data: noteTagRows } = await client.from("note_tags").select("note_id").ilike("tag_path", matchPattern);
+    if (!noteTagRows || noteTagRows.length === 0) return [];
+    const noteIds = [...new Set(noteTagRows.map((r) => r.note_id))];
+    const { data: blocks } = await client.from("blocks").select("*, notes!inner(id, title)").in("note_id", noteIds).eq("user_id", userId).is("deleted_at", null);
+    return (blocks ?? []).map((row) => {
+      const notes = row.notes;
+      return {
+        block: row,
+        noteId: notes.id,
+        noteTitle: notes.title,
+        matchType: "tag"
+      };
+    });
   }
-  const { data: matchedTags } = await tagQuery;
+  const { data: matchedTags } = await client.from("tags").select("id").eq("user_id", userId).ilike("name", `${tagName}%`);
   if (!matchedTags || matchedTags.length === 0) return [];
   const allTagIds = /* @__PURE__ */ new Set();
   for (const tag of matchedTags) {
@@ -442,8 +542,7 @@ function parseQuery(input) {
   const textParts = [];
   for (const part of parts) {
     if (part.startsWith("#")) {
-      const raw = part.slice(1).toLowerCase();
-      filter.tag = raw.includes("/") ? raw.split("/").pop() : raw;
+      filter.tag = part.slice(1).toLowerCase();
     } else if (part.startsWith("type:")) {
       filter.type = part.slice(5);
     } else if (part.startsWith("status:")) {
@@ -481,6 +580,344 @@ async function executeQuery(client, userId, input, limit = 30) {
   }
   return results;
 }
+var HELP_SECTIONS = {
+  "shortcuts": `# Keyboard Shortcuts
+
+## Global
+- Cmd+B \u2014 Toggle sidebar
+- Cmd+K \u2014 Command palette
+- Cmd+P \u2014 Global search
+- Cmd+G \u2014 Graph view
+- Cmd+O \u2014 New note
+- Cmd+S \u2014 Save snapshot (version checkpoint)
+- Cmd+Shift+D \u2014 Open/create today's daily note
+- F2 \u2014 Rename current note
+- Cmd+Backspace \u2014 Delete current note (to Trash)
+- Cmd+W \u2014 Close current tab
+- Alt+Right \u2014 Next tab
+- Alt+Left \u2014 Previous tab
+- Cmd+\\ \u2014 Toggle focus mode
+- Alt+Space \u2014 Quick capture to Inbox
+- Cmd+/ \u2014 Open help
+- Cmd+Shift+A \u2014 Toggle AI Chat panel
+- Alt+Up \u2014 Move block up
+- Alt+Down \u2014 Move block down
+- Cmd+Z \u2014 Undo
+- Cmd+Shift+Z \u2014 Redo
+
+## Multi-Pane
+- Cmd+D \u2014 Split right (side by side)
+- Cmd+Shift+E \u2014 Split down (top/bottom)
+- Cmd+J \u2014 Close active pane
+- Cmd+] \u2014 Focus next pane
+- Cmd+[ \u2014 Focus previous pane
+
+## Text Formatting
+- Cmd+B \u2014 Bold
+- Cmd+I \u2014 Italic
+- Cmd+E \u2014 Inline code
+- Cmd+Shift+X \u2014 Strikethrough
+- Cmd+Shift+M \u2014 Insert math block
+
+## Block Navigation
+- Cmd+Enter \u2014 Exit code/math/mermaid block \u2192 preview + new paragraph
+- / \u2014 Open slash command menu
+- # \u2014 Tag autocomplete (type to filter)
+- [[ \u2014 Wiki link autocomplete (type to filter)
+
+## Reminders
+- Click clock icon on a todo \u2014 Set reminder
+- Amber clock means a reminder is already set
+- Sidebar \u2192 Reminders section \u2014 View all active reminders`,
+  "editor": `# Editor
+
+## Markdown Shortcuts (type at start of line)
+- # \u2014 Heading 1
+- ## \u2014 Heading 2
+- ### \u2014 Heading 3
+- #### \u2014 Heading 4
+- - \u2014 Bullet list
+- 1. \u2014 Numbered list
+- [ ] \u2014 Task/checkbox
+- > \u2014 Blockquote
+- --- \u2014 Horizontal divider
+- \`\`\` \u2014 Code block
+
+## Inline Syntax
+- **text** \u2014 Bold
+- *text* \u2014 Italic
+- \`code\` \u2014 Inline code
+- #tagname \u2014 Tag (renders as purple pill)
+- #parent/child \u2014 Scoped tag (creates hierarchy)
+- [[Note Name]] \u2014 Wiki link to another note
+- $...$ \u2014 Inline math (LaTeX)
+
+## Note Title
+The first H1 heading in a note automatically becomes the note title. You can also rename via F2, double-click the title in the status bar, or Cmd+K \u2192 Rename Note.`,
+  "blocks": `# Block Types
+
+## Slash Menu (type / at start of a line)
+
+Available blocks:
+- Text \u2014 Plain paragraph
+- Heading 1\u20133 \u2014 Section headings
+- Bullet List \u2014 Unordered list
+- Numbered List \u2014 Ordered list
+- Todo \u2014 Checkbox task item (supports nesting, has a clock icon for reminders)
+- Code Block \u2014 Syntax-highlighted code with language selector and copy button
+- Quote \u2014 Blockquote
+- Divider \u2014 Horizontal rule
+- Math \u2014 LaTeX equation. Edit the source, then press Cmd+Enter to preview the rendered formula (uses KaTeX).
+- Callout \u2014 Info/Warning/Error/Tip box with a dropdown to switch type. Has colored backgrounds per variant.
+- Mermaid \u2014 Diagram (flowchart, sequence, class, state, Gantt, pie, etc.). Edit the source, then press Cmd+Enter to preview.
+- Table \u2014 Insert a 3x3 table with header row. Use Tab to navigate cells.
+- Image \u2014 Upload, paste, or drag an image. Stored in Supabase Storage. Supports common formats.
+- Excalidraw \u2014 Embedded whiteboard canvas. Opens a full drawing interface inline.
+- File \u2014 PDF or audio file. Upload and view inline. Stored in R2 (Cloudflare).
+- Summary \u2014 Collapsible preview block. Shows a snippet with a "Show more" toggle.
+- Query \u2014 Live search block. Type a query and click Run to see matching results inline within the note.
+
+## Query Block Syntax
+- type:todo \u2014 All todo blocks
+- type:todo status:open \u2014 Open todos only
+- type:todo status:done \u2014 Completed todos
+- type:code \u2014 All code blocks
+- #tagname \u2014 Blocks tagged with that tag
+- keyword \u2014 Full-text search
+
+## Exiting Blocks
+Press Cmd+Enter inside a code block, math block, or mermaid block to exit it, switch to preview mode, and create a new paragraph below.`,
+  "search": `# Search
+
+## Global Search (Cmd+P)
+Search across all your notes and blocks. Results show the block content with a link to the source note. Click a result to navigate.
+
+### Filter Syntax
+- keyword \u2014 Full-text search across all blocks
+- #tagname \u2014 Find all blocks tagged with that tag (includes child tags via DAG)
+- #parent/child \u2014 Searches by the leaf tag (e.g. #dsa/dp/tabular searches tabular)
+- type:todo \u2014 All todo/checkbox blocks
+- type:code \u2014 All code blocks
+- type:heading \u2014 All headings
+- status:open \u2014 Unchecked todos
+- status:done \u2014 Checked todos
+- Combine filters: type:todo status:open #work
+
+## Command Palette (Cmd+K)
+Quick access to actions and note switching. Type to fuzzy-search.
+
+Available actions:
+- New Note \u2014 Create a blank note
+- Today's Daily Note \u2014 Open or create today's daily note
+- Rename Note \u2014 Rename the current note
+- Delete Note \u2014 Soft-delete to Trash
+- Tag Extend \u2014 Set parent\u2192child relationship between tags
+- Graph View \u2014 Open the visual knowledge graph
+- [note titles] \u2014 Switch to any note by typing its name`,
+  "tags": `# Tags
+
+Tags are a core organizational feature of Vertex. They work like folders/tags in other tools but are more flexible.
+
+## Basic Usage
+Type #tagname anywhere in your note text. Tags render as purple pills inline.
+
+## Hierarchical / Scoped Tags
+Use #parent/child to create hierarchical tags:
+- #work/projects \u2014 creates a "projects" tag with "work" as its parent
+- #work/projects/alpha \u2014 deeper nesting
+- Multi-parent and multi-level are supported (it's a DAG, not a tree)
+
+## Folder Structure
+Tags create a folder-like hierarchy in the sidebar. Each tag path (e.g. "company/projects") gets its own folder node with correct note counts. This lets you organize notes like a file system \u2014 think of tags as folders:
+- #design/mockups \u2014 all design mockup notes
+- #engineering/frontend \u2014 frontend engineering notes
+- #personal/finances \u2014 personal finance notes
+
+## How Tags Work
+- Tags are stored per-block (not per-note), so different blocks in the same note can have different tags
+- The sidebar shows a "Tags" section listing all tags with color dots and lock toggles
+- Tag autocomplete: type # and start typing to see suggestions from existing tags
+- Tag Extend: Cmd+K \u2192 "Tag Extend" to manually create parent\u2192child edges between existing tags
+- The tag DAG (directed acyclic graph) supports complex hierarchies \u2014 a child can have multiple parents
+
+## Tag Locking
+Lock any tag from the sidebar to prevent AI from reading notes under that tag. Locking walks the entire DAG \u2014 all descendant tags are also locked.
+
+## Tag Colors
+Each tag can have a custom color (shown as a dot in the sidebar).`,
+  "wiki-links": `# Wiki Links & Backlinks
+
+## Creating Wiki Links
+Type [[Note Name]] to create a link to another note. An autocomplete dropdown suggests existing notes as you type.
+
+## Navigation
+Click any wiki link to navigate to the linked note.
+
+## Backlinks
+The backlinks panel at the bottom of the editor shows all notes that link to the current note. Each backlink shows the source note title and you can click to navigate.`,
+  "version-history": `# Version History (Snapshots)
+
+## Saving Snapshots
+- Manual: Press Cmd+S to save a version checkpoint
+- Auto: Snapshots are automatically created every 5 saves
+
+## Viewing History
+Click "Show version history" below the editor to see all snapshots. Each snapshot shows the timestamp.
+
+## Comparing Versions
+Select any two versions to see a side-by-side diff view (opens as a new tab). Additions and removals are highlighted at the block level.
+
+## Rollback
+Click "Restore" on any snapshot to rollback the note to that version with one click.`,
+  "graph-view": `# Graph View
+
+Press Cmd+G to open the knowledge graph.
+
+## What You See
+- Gray dots represent notes
+- Purple dots represent tags
+- Lines show wiki link connections (between notes) and tag relationships
+
+## Controls
+- Hover over any dot to enlarge its label
+- Click a note to navigate to it
+- Mouse wheel to zoom
+- Drag to pan
+
+The graph uses ForceAtlas2 layout (powered by graphology + sigma.js) for natural-looking node positioning.`,
+  "quick-capture": `# Quick Capture
+
+Press Alt+Space from anywhere in the app to open a quick capture input dialog.
+
+Type anything and press Enter \u2014 the text is saved directly to your Inbox note. You stay on your current note (no navigation). This is useful for quickly jotting down ideas without context switching.`,
+  "multi-pane": `# Multi-Pane Layout
+
+## Splitting
+- Cmd+D \u2014 Split the editor side-by-side (horizontal split)
+- Cmd+Shift+E \u2014 Split top/bottom (vertical split)
+
+## Each Pane
+Each pane has its own:
+- Tab bar with open notes
+- Editor with full functionality
+- Status bar
+
+## Controls
+- Drag the purple divider to resize panes
+- Cmd+J \u2014 Close the active pane
+- Cmd+] \u2014 Focus the next pane
+- Cmd+[ \u2014 Focus the previous pane
+
+The active pane's editor is shared with the AI Chat panel, so the AI knows which note you're currently editing.`,
+  "reminders": `# Reminders & Notifications
+
+## Setting Reminders
+Every todo item (checkbox task) has a clock icon next to it. Click the clock to open the reminder picker. Set:
+- Due date and time
+- Repeat: once, daily, weekly, monthly, yearly, or custom
+- "Custom" lets you pick specific days of the week (Mon, Tue, Wed, etc.) that fire every week, or specific dates of the month (1st\u201331st) that fire every month
+- "Keep notifying until done": re-fires the reminder every N minutes until the task is checked off
+
+## Visual Indicator
+An amber-colored clock icon means a reminder is already set on that todo. Gray means no reminder.
+
+## Delivery
+- Push notifications are delivered via the browser's Web Push API (works on Chrome, Firefox, Edge)
+- A Cloudflare R2 worker checks for due reminders every 5 minutes
+- When a reminder fires, you get a browser notification \u2014 click it to open the note
+- Notification title shows the task text
+
+## Repeating Reminders
+For daily/weekly/monthly/yearly reminders:
+- After firing, the reminder auto-reschedules to the next interval
+- The task is automatically unchecked so you get reminded again
+- For example, a daily reminder at 9 AM will fire every day at 9 AM
+
+## Notify Until Done
+The reminder re-fires every N minutes (configurable delay) until you mark the task as done. Marking it done deletes the reminder and checks the task.
+
+## Viewing Reminders
+- Sidebar \u2192 Reminders section lists all active reminders
+- Each entry shows: task text, note title, and relative due date
+- You can mark a reminder done directly from the sidebar
+
+## Stable Block IDs
+Each task item has a persistent UUID (crypto.randomUUID()) that survives page reloads. This ensures reminders stay matched to their todo even after editing.`,
+  "ai-integration": `# AI Integration
+
+## AI Chat Panel
+Press Cmd+Shift+A or click the AI button in the status bar to toggle the AI Chat panel.
+
+### Two Modes
+1. Ask mode \u2014 Q&A and research. The AI can search your notes, list todos, find tagged blocks, read daily notes, and answer questions based on your data.
+2. Edit mode \u2014 Structured inline content editing. The AI returns actions (insert, replace, delete, etc.) that appear as green/red suggestions in the editor. Accept or reject each change individually.
+
+### How Ask Mode Works
+The AI has 7 tools it can use to fetch information:
+1. get_current_note \u2014 Read the currently open note's content
+2. search_notes \u2014 Full-text search across all notes
+3. get_note_by_title \u2014 Find a note by its title
+4. get_note_content \u2014 Get full content of a specific note by its ID
+5. get_recent_daily_notes \u2014 Get recent daily journal entries
+6. list_all_notes \u2014 List all note titles and dates
+7. list_todos \u2014 List tasks from notes, scoped to the current note + latest daily note by default
+
+### How Edit Mode Works
+The AI understands the block structure of your note. It can:
+- Insert new blocks after/before a specific block
+- Replace a block's content
+- Delete a block
+- Use special syntax: {summary}...{/summary}, {callout info}...{/callout}, {query value="..."}{/query}
+
+Changes appear as inline suggestions (green for inserts, red strikethrough for deletions) with accept/reject buttons. The editor is locked while changes are pending.
+
+### Providers & Settings
+Supported AI providers: OpenRouter, Groq, OpenAI, Gemini, Cerebras
+Configure API keys via the status bar gear icon \u2192 AI Settings. Keys are encrypted using AES-256-GCM and stored in the database.
+
+## AI Privacy (Tag Locking)
+Lock any tag from the sidebar to prevent AI from reading notes under that tag. The AI will receive "locked: true" with no content and will stop trying to access that note. Locking walks the full tag DAG \u2014 locking a parent locks all descendants.`,
+  "share-links": `# Share Links
+
+Click the share button in the status bar to generate a public share link. Anyone with the link can view the note without signing in. The link uses an unguessable random token.
+
+You can revoke share links at any time from the share dialog. Shared notes appear in a "Shared Notes" section in the sidebar.`,
+  "tag-locking": `# Tag Locking (AI Privacy)
+
+## What It Does
+Locking prevents AI from reading any note that has a locked tag. This is useful for sensitive notes that you don't want AI to access.
+
+## How It Works
+- Note-level: Toggle the lock in the status bar \u2014 locks the current note
+- Tag-level: Lock a tag from the sidebar \u2014 ALL notes under that tag are locked
+- The locking walks the entire tag DAG: if you lock #work, every note tagged with #work/projects, #work/meetings, etc. is also locked
+- Locked notes show a lock icon in the tab bar, sidebar, and status bar
+- The AI Chat panel shows a banner for locked notes
+- When AI tries to access a locked note, it receives "NOTE LOCKED" and is instructed to stop immediately`,
+  "mobile": `# Mobile
+
+On mobile devices, Vertex provides:
+- A bottom toolbar with quick access to AI chat, undo, redo, quick capture, and search
+- Touch-friendly interface with adjusted hit targets
+- Sidebar slides in as a full-width overlay with backdrop
+- Responsive design adapts to smaller screens`,
+  "trash": `# Trash
+
+Deleted notes go to Trash (soft delete \u2014 they can be recovered).
+
+- Open the sidebar \u2192 Trash section to see trashed notes
+- Hover over a trashed note to reveal:
+  - \u21BA Restore \u2014 brings the note back
+  - \u2297 Permanently delete \u2014 deletes the note and all associated blocks, tags, links, and snapshots
+- "Empty" button deletes all trashed notes permanently
+- Notes in trash still count toward your total note count`,
+  "themes": `# Themes
+
+Click the \u2600\uFE0F/\u{1F319} button in the top bar to toggle between dark and light mode. Your preference is saved in localStorage and persists across sessions.
+
+The app uses CSS variables for theming (--foreground, --background, --accent, --border, etc.) giving a consistent look across all UI elements.`
+};
+var HELP_TOPICS = Object.keys(HELP_SECTIONS).sort();
 function extractTextFromNode(node) {
   if (typeof node.text === "string") return node.text;
   const content = node.content;
@@ -927,7 +1364,7 @@ function parseInline(text) {
   }
   return nodes.length > 0 ? nodes : [{ type: "text", text: text || " " }];
 }
-var VERTEX_VERSION = "0.1.0";
+var VERTEX_VERSION = "0.3.4";
 
 export {
   createSupabaseClient,

package/dist/commands/capture.js

@@ -1,13 +1,13 @@
 import {
   getClient,
   getUserId
-} from "../chunk-LXT34CD7.js";
+} from "../chunk-QQO4JMNC.js";
 import "../chunk-DRIWYEQE.js";
 import {
   getBlocksForNote,
   listNotes,
   saveNoteContent
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/capture.ts
 import { Command, Args } from "@oclif/core";

package/dist/commands/daily.js

@@ -1,13 +1,13 @@
 import {
   getClient,
   getUserId
-} from "../chunk-LXT34CD7.js";
+} from "../chunk-QQO4JMNC.js";
 import "../chunk-DRIWYEQE.js";
 import {
   exportNoteAsMarkdown,
   getOrCreateDailyNote,
   listNotes
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/daily.ts
 import { Command, Flags } from "@oclif/core";

package/dist/commands/delete.js

@@ -1,12 +1,12 @@
 import {
   getClient,
   getUserId
-} from "../chunk-LXT34CD7.js";
+} from "../chunk-QQO4JMNC.js";
 import "../chunk-DRIWYEQE.js";
 import {
   listNotes,
   softDeleteNote
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/delete.ts
 import { Command, Args } from "@oclif/core";

package/dist/commands/edit.js

@@ -1,14 +1,14 @@
 import {
   getClient,
   getUserId
-} from "../chunk-LXT34CD7.js";
+} from "../chunk-QQO4JMNC.js";
 import "../chunk-DRIWYEQE.js";
 import {
   exportNoteAsMarkdown,
   listNotes,
   markdownToTiptap,
   saveNoteContent
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/edit.ts
 import { Command, Args } from "@oclif/core";

package/dist/commands/export.js

@@ -1,13 +1,13 @@
 import {
   getClient,
   getUserId
-} from "../chunk-LXT34CD7.js";
+} from "../chunk-QQO4JMNC.js";
 import "../chunk-DRIWYEQE.js";
 import {
   exportNoteAsJson,
   exportNoteAsMarkdown,
   listNotes
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/export.ts
 import { Command, Args, Flags } from "@oclif/core";

package/dist/commands/hello.js

@@ -1,6 +1,6 @@
 import {
   VERTEX_VERSION
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/hello.ts
 import { Command } from "@oclif/core";

package/dist/commands/help.js

@@ -1,6 +1,6 @@
 import {
   VERTEX_VERSION
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/help.ts
 import { Command } from "@oclif/core";

package/dist/commands/import.js

@@ -1,13 +1,13 @@
 import {
   getClient,
   getUserId
-} from "../chunk-LXT34CD7.js";
+} from "../chunk-QQO4JMNC.js";
 import "../chunk-DRIWYEQE.js";
 import {
   createNote,
   markdownToTiptap,
   saveNoteContent
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/import.ts
 import { Command, Args, Flags } from "@oclif/core";

package/dist/commands/interactive.js

@@ -1,7 +1,7 @@
 import {
   getClient,
   getUserId
-} from "../chunk-LXT34CD7.js";
+} from "../chunk-QQO4JMNC.js";
 import "../chunk-DRIWYEQE.js";
 import {
   exportNoteAsMarkdown,
@@ -9,7 +9,7 @@ import {
   listNotes,
   markdownToTiptap,
   saveNoteContent
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/interactive.ts
 import { Command, Args } from "@oclif/core";

package/dist/commands/login.js

@@ -4,7 +4,7 @@ import {
 } from "../chunk-DRIWYEQE.js";
 import {
   createSupabaseClient
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/login.ts
 import { Command } from "@oclif/core";

package/dist/commands/new.js

@@ -1,11 +1,11 @@
 import {
   getClient,
   getUserId
-} from "../chunk-LXT34CD7.js";
+} from "../chunk-QQO4JMNC.js";
 import "../chunk-DRIWYEQE.js";
 import {
   createNote
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/new.ts
 import { Command, Args } from "@oclif/core";

package/dist/commands/notes.js

@@ -1,11 +1,11 @@
 import {
   getClient,
   getUserId
-} from "../chunk-LXT34CD7.js";
+} from "../chunk-QQO4JMNC.js";
 import "../chunk-DRIWYEQE.js";
 import {
   listNotes
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/notes.ts
 import { Command } from "@oclif/core";

package/dist/commands/restore.js

@@ -1,12 +1,12 @@
 import {
   getClient,
   getUserId
-} from "../chunk-LXT34CD7.js";
+} from "../chunk-QQO4JMNC.js";
 import "../chunk-DRIWYEQE.js";
 import {
   listNotes,
   restoreNote
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/restore.ts
 import { Command, Args } from "@oclif/core";

package/dist/commands/search.js

@@ -1,11 +1,11 @@
 import {
   getClient,
   getUserId
-} from "../chunk-LXT34CD7.js";
+} from "../chunk-QQO4JMNC.js";
 import "../chunk-DRIWYEQE.js";
 import {
   executeQuery
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/search.ts
 import { Command, Args } from "@oclif/core";

package/dist/commands/status.js

@@ -1,7 +1,7 @@
 import {
   getClient,
   getUserId
-} from "../chunk-LXT34CD7.js";
+} from "../chunk-QQO4JMNC.js";
 import {
   loadConfig
 } from "../chunk-DRIWYEQE.js";
@@ -10,7 +10,7 @@ import {
   formatFileSize,
   getStorageInfo,
   listNotes
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/status.ts
 import { Command } from "@oclif/core";

package/dist/commands/tags.js

@@ -1,11 +1,11 @@
 import {
   getClient,
   getUserId
-} from "../chunk-LXT34CD7.js";
+} from "../chunk-QQO4JMNC.js";
 import "../chunk-DRIWYEQE.js";
 import {
   getUserTags
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/tags.ts
 import { Command } from "@oclif/core";

package/dist/commands/today.js

@@ -1,11 +1,11 @@
 import {
   getClient,
   getUserId
-} from "../chunk-LXT34CD7.js";
+} from "../chunk-QQO4JMNC.js";
 import "../chunk-DRIWYEQE.js";
 import {
   listNotes
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/today.ts
 import { Command } from "@oclif/core";

package/dist/commands/trash/empty.js

@@ -4,11 +4,11 @@ import {
 import {
   getClient,
   getUserId
-} from "../../chunk-LXT34CD7.js";
+} from "../../chunk-QQO4JMNC.js";
 import "../../chunk-DRIWYEQE.js";
 import {
   emptyTrash
-} from "../../chunk-K5SQERJ7.js";
+} from "../../chunk-XJVEK2OB.js";
 
 // src/commands/trash/empty.ts
 import { Command } from "@oclif/core";

package/dist/commands/trash/index.js

@@ -1,11 +1,11 @@
 import {
   getClient,
   getUserId
-} from "../../chunk-LXT34CD7.js";
+} from "../../chunk-QQO4JMNC.js";
 import "../../chunk-DRIWYEQE.js";
 import {
   listNotes
-} from "../../chunk-K5SQERJ7.js";
+} from "../../chunk-XJVEK2OB.js";
 
 // src/commands/trash/index.ts
 import { Command } from "@oclif/core";

package/dist/commands/view.js

@@ -1,12 +1,12 @@
 import {
   getClient,
   getUserId
-} from "../chunk-LXT34CD7.js";
+} from "../chunk-QQO4JMNC.js";
 import "../chunk-DRIWYEQE.js";
 import {
   exportNoteAsMarkdown,
   listNotes
-} from "../chunk-K5SQERJ7.js";
+} from "../chunk-XJVEK2OB.js";
 
 // src/commands/view.ts
 import { Command, Args } from "@oclif/core";

package/dist/lib/client.js

@@ -1,9 +1,9 @@
 import {
   getClient,
   getUserId
-} from "../chunk-LXT34CD7.js";
+} from "../chunk-QQO4JMNC.js";
 import "../chunk-DRIWYEQE.js";
-import "../chunk-K5SQERJ7.js";
+import "../chunk-XJVEK2OB.js";
 export {
   getClient,
   getUserId

package/package.json

@@ -1,54 +1,56 @@
-{
-  "name": "vertex-notes",
-  "version": "0.3.3",
-  "description": "Vertex — keyboard-first knowledge workspace CLI",
-  "type": "module",
-  "bin": {
-    "vertex": "bin/run.js"
-  },
-  "main": "dist/index.js",
-  "files": [
-    "bin",
-    "dist",
-    "README.md"
-  ],
-  "keywords": [
-    "vertex",
-    "notes",
-    "cli",
-    "knowledge",
-    "todo",
-    "markdown",
-    "productivity"
-  ],
-  "author": "Sahil Kumar Sinha",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/sahilcodes2002/vertex.git"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "build": "tsup",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "prepublishOnly": "pnpm build"
-  },
-  "dependencies": {
-    "@oclif/core": "^4.2.0",
-    "@supabase/supabase-js": "^2.49.0"
-  },
-  "devDependencies": {
-    "@vertex/core": "workspace:*",
-    "tsup": "^8.4.0",
-    "typescript": "^5.7.0",
-    "oclif": "^4.17.0"
-  },
-  "oclif": {
-    "bin": "vertex",
-    "dirname": "vertex",
-    "commands": "./dist/commands"
-  }
-}
+{
+  "name": "vertex-notes",
+  "version": "0.3.4",
+  "description": "Vertex — keyboard-first knowledge workspace CLI",
+  "type": "module",
+  "bin": {
+    "vertex": "bin/run.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "bin",
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "vertex",
+    "notes",
+    "cli",
+    "knowledge",
+    "todo",
+    "markdown",
+    "productivity"
+  ],
+  "author": "Sahil Kumar Sinha",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sahilcodes2002/vertex.git"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "@oclif/core": "^4.11.0",
+    "@supabase/supabase-js": "^2.49.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.18.0",
+    "@vertex/core": "workspace:*",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.0",
+    "oclif": "^4.17.0"
+  },
+  "oclif": {
+    "bin": "vertex",
+    "dirname": "vertex",
+    "commands": "./dist/commands"
+  }
+}