vertex-notes 0.1.4 → 0.2.1

package/dist/commands/howto.js

@@ -0,0 +1,379 @@
+// src/commands/howto.ts
+import { Command } from "@oclif/core";
+var D = "\x1B[90m";
+var B = "\x1B[1m";
+var C = "\x1B[36m";
+var Y = "\x1B[33m";
+var G = "\x1B[32m";
+var P = "\x1B[35m";
+var R = "\x1B[0m";
+var Howto = class extends Command {
+  static description = "Complete guide for AI agents to create and manage Vertex notes";
+  async run() {
+    this.log(`
+${B}${P}  Vertex \u2014 Complete AI Guide${R}
+${D}  Everything an AI agent needs to create, edit, and manage notes.${R}
+${D}  Read this once, then you can do anything in Vertex.${R}
+${D}  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550${R}
+
+${C}${B}  1. WHAT IS VERTEX?${R}
+${D}  A knowledge workspace. Notes are stored in the cloud (Supabase).${R}
+${D}  You write markdown in the terminal \u2192 it renders as rich content${R}
+${D}  (diagrams, math, code, callouts) in the web app.${R}
+${D}  Notes can link to each other via [[wiki links]] and #tags.${R}
+
+${C}${B}  2. HOW TO CREATE A NOTE${R}
+
+${D}  Option A: Create and edit in one step${R}
+  ${G}vertex new "My Note Title"${R}
+  ${G}vertex edit "My Note"${R}              ${D}\u2190 opens in $EDITOR (vim/nano/code)${R}
+
+${D}  Option B: Write a .md file, then import${R}
+  ${G}cat > note.md << 'EOF'${R}
+  ${Y}# My Note Title${R}
+  ${Y}Content here...${R}
+  ${G}EOF${R}
+  ${G}vertex import note.md -t "My Note Title"${R}
+
+${D}  Option C: Quick one-liner to inbox${R}
+  ${G}vertex capture "Remember to review PR #42"${R}
+
+${C}${B}  3. HOW TO EDIT AN EXISTING NOTE${R}
+
+  ${G}vertex edit "Note Title"${R}           ${D}\u2190 partial match works: "Note" matches "Note Title"${R}
+${D}  This exports the note as markdown, opens your $EDITOR,${R}
+${D}  and when you save & quit, it parses the markdown back${R}
+${D}  and updates the note in the database.${R}
+
+${D}  To use a specific editor:${R}
+  ${G}EDITOR=nano vertex edit "My Note"${R}
+  ${G}EDITOR="code --wait" vertex edit "My Note"${R}
+  ${G}EDITOR=vim vertex edit "My Note"${R}
+
+${C}${B}  4. HOW TO VIEW A NOTE (read-only)${R}
+
+  ${G}vertex view "Note Title"${R}           ${D}\u2190 prints markdown to stdout${R}
+  ${G}vertex view "Note" | less${R}          ${D}\u2190 paginated view${R}
+  ${G}vertex export "Note" -o note.md${R}    ${D}\u2190 save to file${R}
+
+${C}${B}  5. HOW TO LIST AND FIND NOTES${R}
+
+  ${G}vertex notes${R}                       ${D}\u2190 list all notes${R}
+  ${G}vertex search "keyword"${R}            ${D}\u2190 full-text search${R}
+  ${G}vertex search "#tagname"${R}           ${D}\u2190 search by tag${R}
+  ${G}vertex search "type:todo status:open"${R}  ${D}\u2190 find open todos${R}
+  ${G}vertex tags${R}                        ${D}\u2190 list all tags${R}
+  ${G}vertex daily --last${R}                ${D}\u2190 view latest daily note${R}
+
+${D}  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550${R}
+
+${C}${B}  6. MARKDOWN SYNTAX \u2014 ALL BLOCK TYPES${R}
+
+${D}  \u250C\u2500 IMPORTANT \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500${R}
+${D}  \u2502 Every block must be separated by a BLANK LINE.${R}
+${D}  \u2502 The first # H1 heading becomes the note title.${R}
+${D}  \u2502 Tags must start with a letter (a-z): #valid  not #123${R}
+${D}  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500${R}
+
+${C}  HEADINGS${R}
+${Y}  # Heading 1${R}
+${Y}  ## Heading 2${R}
+${Y}  ### Heading 3${R}
+
+${C}  TEXT FORMATTING${R}
+${Y}  **bold text**${R}
+${Y}  *italic text*${R}
+${Y}  \`inline code\`${R}
+${Y}  ~~strikethrough~~${R}
+
+${C}  BULLET LIST${R}
+${Y}  - Item one${R}
+${Y}  - Item two${R}
+${Y}  - Item three${R}
+
+${C}  NUMBERED LIST${R}
+${Y}  1. First${R}
+${Y}  2. Second${R}
+${Y}  3. Third${R}
+
+${C}  TODO TASKS${R}
+${Y}  - [ ] Open task${R}
+${Y}  - [x] Completed task${R}
+
+${C}  BLOCKQUOTE${R}
+${Y}  > Quoted text here${R}
+
+${C}  DIVIDER${R}
+${Y}  ---${R}
+
+${C}  CODE BLOCK${R}
+${Y}  \`\`\`python${R}
+${Y}  def hello():${R}
+${Y}      print("Hello!")${R}
+${Y}  \`\`\`${R}
+${D}  Languages: python, javascript, typescript, rust, go, java,${R}
+${D}  c, cpp, sql, html, css, json, yaml, bash, ruby, swift, etc.${R}
+
+${C}  MERMAID DIAGRAM${R}
+${Y}  \`\`\`mermaid${R}
+${Y}  graph TD;${R}
+${Y}      A --> B --> C;${R}
+${Y}  \`\`\`${R}
+${D}  Types: graph/flowchart, sequenceDiagram, classDiagram,${R}
+${D}  erDiagram, stateDiagram, gantt, pie, gitGraph, mindmap${R}
+
+${C}  INLINE MATH${R}
+${Y}  The value $E = mc^2$ is inline.${R}
+${Y}  Solve $\\frac{-b \\pm \\sqrt{b^2-4ac}}{2a}$ for $x$.${R}
+${D}  Use single $ for inline math within text.${R}
+
+${C}  BLOCK MATH (LaTeX via KaTeX)${R}
+${Y}  $$${R}
+${Y}  E = mc^2${R}
+${Y}  $$${R}
+${D}  Use $$ on separate lines for standalone equations.${R}
+${D}  LaTeX: \\frac{a}{b}  \\sqrt{x}  \\sum_{i=1}^{n}  \\int_0^1${R}
+${D}  \\alpha \\beta \\pi \\infty  \\text{label}  x^{2}  x_{i}${R}
+
+${C}  CALLOUT${R}
+${Y}  > [!info]${R}
+${Y}  > Informational note${R}
+${D}  Variants: info, warning, error, tip${R}
+${D}  Multi-line: each line starts with >  ${R}
+
+${C}  QUERY BLOCK${R}
+${Y}  > [!query]${R}
+${Y}  > type:todo status:open #work${R}
+
+${C}  INLINE LINK${R}
+${Y}  [Link Text](https://example.com)${R}
+${D}  Opens in new tab. Standard markdown link syntax.${R}
+
+${C}  EMBED (link preview)${R}
+${Y}  > [!embed]${R}
+${Y}  > https://youtube.com/watch?v=ID${R}
+${D}  YouTube \u2192 video player. Other URLs \u2192 preview card.${R}
+
+${C}  IMAGE${R}
+${Y}  ![description](https://url.com/image.png)${R}
+
+${C}  FILE ATTACHMENT${R}
+${Y}  > [!file]${R}
+${Y}  > [filename.pdf](https://url.com/file.pdf)${R}
+${Y}  > application/pdf 149780${R}
+
+${D}  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550${R}
+
+${C}${B}  7. WIKI LINKS \u2014 HOW TO CONNECT NOTES${R}
+
+${D}  Wiki links create connections between notes.${R}
+${D}  They render as clickable purple links in the web app.${R}
+${D}  The linked note shows a "backlink" at the bottom.${R}
+
+${Y}  Check out [[Project Roadmap]] for details.${R}
+${Y}  This connects to [[AI Research Notes]] and [[Meeting Notes]].${R}
+
+${D}  Rules:${R}
+${D}  \u2022 Use the exact note title inside [[ ]]${R}
+${D}  \u2022 Case-insensitive: [[my note]] matches "My Note"${R}
+${D}  \u2022 If the note doesn't exist yet, the link is still created${R}
+${D}  \u2022 Multiple links in one paragraph is fine${R}
+${D}  \u2022 Wiki links work in any text: paragraphs, todos, callouts${R}
+
+${D}  Example: Create a network of linked notes${R}
+  ${G}vertex new "Hub Note"${R}
+  ${G}vertex edit "Hub Note"${R}
+${D}  Then write:${R}
+${Y}  # Hub Note${R}
+${Y}  ${R}
+${Y}  This connects to:${R}
+${Y}  - [[Topic A]] \u2014 first topic${R}
+${Y}  - [[Topic B]] \u2014 second topic${R}
+${Y}  - [[Topic C]] \u2014 third topic${R}
+
+${C}${B}  8. TAGS \u2014 HOW THEY WORK${R}
+
+${D}  Tags categorize content. They appear as purple pills in the web app.${R}
+${D}  Tags are auto-created when you use them \u2014 no need to create first.${R}
+
+${C}  Basic tags:${R}
+${Y}  This paragraph has #work and #important tags.${R}
+${Y}  - [x] Finish report #work #deadline${R}
+
+${C}  Rules:${R}
+${D}  \u2022 Must start with a letter: #valid, #tag123${R}
+${D}  \u2022 Can contain letters, numbers, hyphens, underscores: #my-tag, #my_tag${R}
+${D}  \u2022 NO spaces: #my tag is wrong \u2192 use #my-tag${R}
+${D}  \u2022 Tags are case-insensitive: #Work = #work${R}
+${D}  \u2022 Tags work everywhere: paragraphs, todos, headings, callouts${R}
+
+${C}${B}  9. TAG HIERARCHY \u2014 PARENT/CHILD RELATIONSHIPS${R}
+
+${D}  Tags can have parent-child relationships using / separator.${R}
+${D}  This creates a DAG (directed acyclic graph) of tags.${R}
+
+${Y}  This is about #work/frontend${R}      ${D}\u2190 creates: work \u2192 frontend${R}
+${Y}  Also covers #work/backend${R}         ${D}\u2190 creates: work \u2192 backend${R}
+${Y}  Deep nesting: #cs/algo/sorting${R}    ${D}\u2190 creates: cs \u2192 algo \u2192 sorting${R}
+
+${D}  What happens:${R}
+${D}  \u2022 Only the LEAF tag is applied to the block: "frontend" not "work"${R}
+${D}  \u2022 Parent tags are auto-created if they don't exist${R}
+${D}  \u2022 Parent\u2192child edges are created in the tag hierarchy${R}
+${D}  \u2022 Searching #work finds blocks tagged with #work AND all children${R}
+${D}    (frontend, backend, etc.)${R}
+
+${D}  You can also set relationships via command palette (Cmd+K in web):${R}
+${D}  "Tag Extend" \u2192 pick parent and child tags${R}
+
+${C}${B}  10. SEARCH QUERY SYNTAX${R}
+
+  ${G}vertex search "keyword"${R}           ${D}\u2190 full-text search${R}
+  ${G}vertex search "#work"${R}             ${D}\u2190 all blocks tagged #work (+ children)${R}
+  ${G}vertex search "#work/frontend"${R}    ${D}\u2190 searches the leaf tag "frontend"${R}
+  ${G}vertex search "type:todo"${R}         ${D}\u2190 all todo blocks${R}
+  ${G}vertex search "type:code"${R}         ${D}\u2190 all code blocks${R}
+  ${G}vertex search "type:heading"${R}      ${D}\u2190 all headings${R}
+  ${G}vertex search "status:open"${R}       ${D}\u2190 unchecked todos${R}
+  ${G}vertex search "status:done"${R}       ${D}\u2190 checked todos${R}
+  ${G}vertex search "type:todo status:open #work"${R}  ${D}\u2190 combine filters${R}
+  ${G}vertex search "type:todo #work keyword"${R}      ${D}\u2190 all three${R}
+
+${C}${B}  11. DAILY NOTES${R}
+
+  ${G}vertex daily${R}                      ${D}\u2190 view/create today's daily note${R}
+  ${G}vertex daily --last${R}               ${D}\u2190 view most recent daily (no create)${R}
+  ${G}vertex today${R}                      ${D}\u2190 open latest daily in interactive TUI${R}
+
+${D}  Daily notes are auto-titled with the date: "April 14, 2026"${R}
+${D}  One daily note per day \u2014 calling vertex daily twice won't duplicate.${R}
+
+${C}${B}  12. INTERACTIVE MODE${R}
+
+  ${G}vertex interactive "Note Title"${R}   ${D}\u2190 open any note${R}
+  ${G}vertex today${R}                      ${D}\u2190 shortcut for latest daily${R}
+
+${D}  Controls:${R}
+${D}  \u2191 \u2193       Move cursor between items${R}
+${D}  Enter      Toggle todo done/undone${R}
+${D}  t          Add new todo${R}
+${D}  n          Add new text line${R}
+${D}  d          Delete item at cursor${R}
+${D}  e          Open in $EDITOR for full editing${R}
+${D}  s          Save changes${R}
+${D}  q          Save and quit${R}
+
+${C}${B}  13. TRASH & DELETE${R}
+
+  ${G}vertex delete "Note"${R}              ${D}\u2190 soft delete (recoverable)${R}
+  ${G}vertex trash${R}                      ${D}\u2190 list trashed notes${R}
+  ${G}vertex restore "Note"${R}             ${D}\u2190 restore from trash${R}
+  ${G}vertex trash:empty${R}                ${D}\u2190 permanent delete all (irreversible)${R}
+
+${D}  Soft delete: note goes to trash, can be restored${R}
+${D}  Hard delete (trash:empty): note + files + tags permanently removed${R}
+
+${C}${B}  14. ALL COMMANDS REFERENCE${R}
+
+  ${G}vertex login${R}                      ${D}\u2190 authenticate (GitHub/Google/Email)${R}
+  ${G}vertex logout${R}                     ${D}\u2190 clear session${R}
+  ${G}vertex whoami${R}                     ${D}\u2190 show logged-in user${R}
+  ${G}vertex notes${R}                      ${D}\u2190 list all notes${R}
+  ${G}vertex new [title]${R}                ${D}\u2190 create note${R}
+  ${G}vertex view <title>${R}               ${D}\u2190 view as markdown${R}
+  ${G}vertex edit <title>${R}               ${D}\u2190 edit in $EDITOR${R}
+  ${G}vertex daily${R}                      ${D}\u2190 today's daily note${R}
+  ${G}vertex daily --last${R}               ${D}\u2190 latest daily note${R}
+  ${G}vertex today${R}                      ${D}\u2190 latest daily \u2192 interactive${R}
+  ${G}vertex interactive <title>${R}        ${D}\u2190 interactive TUI mode${R}
+  ${G}vertex capture "text"${R}             ${D}\u2190 quick capture to inbox${R}
+  ${G}vertex search <query>${R}             ${D}\u2190 search notes${R}
+  ${G}vertex tags${R}                       ${D}\u2190 list tags${R}
+  ${G}vertex import <file.md>${R}           ${D}\u2190 import markdown as note${R}
+  ${G}vertex import <file> -t "T"${R}       ${D}\u2190 import with title${R}
+  ${G}vertex export <title>${R}             ${D}\u2190 export as markdown${R}
+  ${G}vertex export <title> -o file${R}     ${D}\u2190 export to file${R}
+  ${G}vertex export <title> --json${R}      ${D}\u2190 export as JSON${R}
+  ${G}vertex delete <title>${R}             ${D}\u2190 soft delete${R}
+  ${G}vertex restore <title>${R}            ${D}\u2190 restore from trash${R}
+  ${G}vertex trash${R}                      ${D}\u2190 list trash${R}
+  ${G}vertex trash:empty${R}                ${D}\u2190 empty trash permanently${R}
+  ${G}vertex status${R}                     ${D}\u2190 storage, note count, version${R}
+  ${G}vertex syntax${R}                     ${D}\u2190 markdown syntax reference${R}
+  ${G}vertex howto${R}                      ${D}\u2190 this guide${R}
+  ${G}vertex help${R}                       ${D}\u2190 command overview${R}
+
+${C}${B}  15. FULL EXAMPLE \u2014 AI CREATING A COMPLETE NOTE${R}
+${D}  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500${R}
+
+  ${G}cat > /tmp/my-note.md << 'VERTEX'${R}
+  ${Y}# Distributed Systems Study Guide${R}
+  ${Y}${R}
+  ${Y}Notes from studying distributed systems. #learning #cs${R}
+  ${Y}${R}
+  ${Y}## CAP Theorem${R}
+  ${Y}${R}
+  ${Y}A distributed system can only guarantee 2 of 3:${R}
+  ${Y}${R}
+  ${Y}- **Consistency** \u2014 every read gets the latest write${R}
+  ${Y}- **Availability** \u2014 every request gets a response${R}
+  ${Y}- **Partition tolerance** \u2014 system works despite network failures${R}
+  ${Y}${R}
+  ${Y}> [!warning]${R}
+  ${Y}> In practice, P is non-negotiable. You choose between CP and AP.${R}
+  ${Y}${R}
+  ${Y}## Consensus Algorithm${R}
+  ${Y}${R}
+  ${Y}\`\`\`mermaid${R}
+  ${Y}sequenceDiagram${R}
+  ${Y}    Leader->>Follower1: AppendEntries${R}
+  ${Y}    Leader->>Follower2: AppendEntries${R}
+  ${Y}    Follower1-->>Leader: ACK${R}
+  ${Y}    Follower2-->>Leader: ACK${R}
+  ${Y}    Leader->>Leader: Commit (majority ACK)${R}
+  ${Y}\`\`\`${R}
+  ${Y}${R}
+  ${Y}## Consistency Models${R}
+  ${Y}${R}
+  ${Y}$$${R}
+  ${Y}\\text{Linearizability} \\subset \\text{Sequential} \\subset \\text{Causal} \\subset \\text{Eventual}${R}
+  ${Y}$$${R}
+  ${Y}${R}
+  ${Y}## Implementation${R}
+  ${Y}${R}
+  ${Y}\`\`\`go${R}
+  ${Y}type RaftNode struct {${R}
+  ${Y}    state    State${R}
+  ${Y}    term     int${R}
+  ${Y}    votedFor string${R}
+  ${Y}    log      []Entry${R}
+  ${Y}}${R}
+  ${Y}\`\`\`${R}
+  ${Y}${R}
+  ${Y}## Reading List${R}
+  ${Y}${R}
+  ${Y}- [x] Designing Data-Intensive Applications #learning/books${R}
+  ${Y}- [ ] Raft paper #learning/papers${R}
+  ${Y}- [ ] Paxos Made Simple #learning/papers${R}
+  ${Y}${R}
+  ${Y}> [!tip]${R}
+  ${Y}> Start with Raft \u2014 it's simpler than Paxos and used in etcd.${R}
+  ${Y}${R}
+  ${Y}---${R}
+  ${Y}${R}
+  ${Y}Related: [[Project Roadmap]] \xB7 [[AI Research Notes]]${R}
+  ${G}VERTEX${R}
+
+  ${G}vertex import /tmp/my-note.md -t "Distributed Systems Study Guide"${R}
+
+${D}  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500${R}
+${D}  This creates a note with: heading, bullets, callouts, mermaid,${R}
+${D}  math, code, todos with scoped tags, wiki links, and a divider.${R}
+${D}  Open the web app to see it rendered with rich blocks.${R}
+`);
+  }
+};
+export {
+  Howto as default
+};
+//# sourceMappingURL=howto.js.map

package/dist/commands/howto.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commands/howto.ts"],"sourcesContent":["import { Command } from \"@oclif/core\";\n\nconst D = \"\\x1b[90m\";\nconst B = \"\\x1b[1m\";\nconst C = \"\\x1b[36m\";\nconst Y = \"\\x1b[33m\";\nconst G = \"\\x1b[32m\";\nconst P = \"\\x1b[35m\";\nconst R = \"\\x1b[0m\";\n\nexport default class Howto extends Command {\n  static override description = \"Complete guide for AI agents to create and manage Vertex notes\";\n\n  async run(): Promise<void> {\n    this.log(`\n${B}${P}  Vertex — Complete AI Guide${R}\n${D}  Everything an AI agent needs to create, edit, and manage notes.${R}\n${D}  Read this once, then you can do anything in Vertex.${R}\n${D}  ══════════════════════════════════════════════════════════════${R}\n\n${C}${B}  1. WHAT IS VERTEX?${R}\n${D}  A knowledge workspace. Notes are stored in the cloud (Supabase).${R}\n${D}  You write markdown in the terminal → it renders as rich content${R}\n${D}  (diagrams, math, code, callouts) in the web app.${R}\n${D}  Notes can link to each other via [[wiki links]] and #tags.${R}\n\n${C}${B}  2. HOW TO CREATE A NOTE${R}\n\n${D}  Option A: Create and edit in one step${R}\n  ${G}vertex new \"My Note Title\"${R}\n  ${G}vertex edit \"My Note\"${R}              ${D}← opens in $EDITOR (vim/nano/code)${R}\n\n${D}  Option B: Write a .md file, then import${R}\n  ${G}cat > note.md << 'EOF'${R}\n  ${Y}# My Note Title${R}\n  ${Y}Content here...${R}\n  ${G}EOF${R}\n  ${G}vertex import note.md -t \"My Note Title\"${R}\n\n${D}  Option C: Quick one-liner to inbox${R}\n  ${G}vertex capture \"Remember to review PR #42\"${R}\n\n${C}${B}  3. HOW TO EDIT AN EXISTING NOTE${R}\n\n  ${G}vertex edit \"Note Title\"${R}           ${D}← partial match works: \"Note\" matches \"Note Title\"${R}\n${D}  This exports the note as markdown, opens your $EDITOR,${R}\n${D}  and when you save & quit, it parses the markdown back${R}\n${D}  and updates the note in the database.${R}\n\n${D}  To use a specific editor:${R}\n  ${G}EDITOR=nano vertex edit \"My Note\"${R}\n  ${G}EDITOR=\"code --wait\" vertex edit \"My Note\"${R}\n  ${G}EDITOR=vim vertex edit \"My Note\"${R}\n\n${C}${B}  4. HOW TO VIEW A NOTE (read-only)${R}\n\n  ${G}vertex view \"Note Title\"${R}           ${D}← prints markdown to stdout${R}\n  ${G}vertex view \"Note\" | less${R}          ${D}← paginated view${R}\n  ${G}vertex export \"Note\" -o note.md${R}    ${D}← save to file${R}\n\n${C}${B}  5. HOW TO LIST AND FIND NOTES${R}\n\n  ${G}vertex notes${R}                       ${D}← list all notes${R}\n  ${G}vertex search \"keyword\"${R}            ${D}← full-text search${R}\n  ${G}vertex search \"#tagname\"${R}           ${D}← search by tag${R}\n  ${G}vertex search \"type:todo status:open\"${R}  ${D}← find open todos${R}\n  ${G}vertex tags${R}                        ${D}← list all tags${R}\n  ${G}vertex daily --last${R}                ${D}← view latest daily note${R}\n\n${D}  ══════════════════════════════════════════════════════════════${R}\n\n${C}${B}  6. MARKDOWN SYNTAX — ALL BLOCK TYPES${R}\n\n${D}  ┌─ IMPORTANT ────────────────────────────────────────────────${R}\n${D}  │ Every block must be separated by a BLANK LINE.${R}\n${D}  │ The first # H1 heading becomes the note title.${R}\n${D}  │ Tags must start with a letter (a-z): #valid  not #123${R}\n${D}  └──────────────────────────────────────────────────────────${R}\n\n${C}  HEADINGS${R}\n${Y}  # Heading 1${R}\n${Y}  ## Heading 2${R}\n${Y}  ### Heading 3${R}\n\n${C}  TEXT FORMATTING${R}\n${Y}  **bold text**${R}\n${Y}  *italic text*${R}\n${Y}  \\`inline code\\`${R}\n${Y}  ~~strikethrough~~${R}\n\n${C}  BULLET LIST${R}\n${Y}  - Item one${R}\n${Y}  - Item two${R}\n${Y}  - Item three${R}\n\n${C}  NUMBERED LIST${R}\n${Y}  1. First${R}\n${Y}  2. Second${R}\n${Y}  3. Third${R}\n\n${C}  TODO TASKS${R}\n${Y}  - [ ] Open task${R}\n${Y}  - [x] Completed task${R}\n\n${C}  BLOCKQUOTE${R}\n${Y}  > Quoted text here${R}\n\n${C}  DIVIDER${R}\n${Y}  ---${R}\n\n${C}  CODE BLOCK${R}\n${Y}  \\`\\`\\`python${R}\n${Y}  def hello():${R}\n${Y}      print(\"Hello!\")${R}\n${Y}  \\`\\`\\`${R}\n${D}  Languages: python, javascript, typescript, rust, go, java,${R}\n${D}  c, cpp, sql, html, css, json, yaml, bash, ruby, swift, etc.${R}\n\n${C}  MERMAID DIAGRAM${R}\n${Y}  \\`\\`\\`mermaid${R}\n${Y}  graph TD;${R}\n${Y}      A --> B --> C;${R}\n${Y}  \\`\\`\\`${R}\n${D}  Types: graph/flowchart, sequenceDiagram, classDiagram,${R}\n${D}  erDiagram, stateDiagram, gantt, pie, gitGraph, mindmap${R}\n\n${C}  INLINE MATH${R}\n${Y}  The value $E = mc^2$ is inline.${R}\n${Y}  Solve $\\\\frac{-b \\\\pm \\\\sqrt{b^2-4ac}}{2a}$ for $x$.${R}\n${D}  Use single $ for inline math within text.${R}\n\n${C}  BLOCK MATH (LaTeX via KaTeX)${R}\n${Y}  $$${R}\n${Y}  E = mc^2${R}\n${Y}  $$${R}\n${D}  Use $$ on separate lines for standalone equations.${R}\n${D}  LaTeX: \\\\frac{a}{b}  \\\\sqrt{x}  \\\\sum_{i=1}^{n}  \\\\int_0^1${R}\n${D}  \\\\alpha \\\\beta \\\\pi \\\\infty  \\\\text{label}  x^{2}  x_{i}${R}\n\n${C}  CALLOUT${R}\n${Y}  > [!info]${R}\n${Y}  > Informational note${R}\n${D}  Variants: info, warning, error, tip${R}\n${D}  Multi-line: each line starts with >  ${R}\n\n${C}  QUERY BLOCK${R}\n${Y}  > [!query]${R}\n${Y}  > type:todo status:open #work${R}\n\n${C}  INLINE LINK${R}\n${Y}  [Link Text](https://example.com)${R}\n${D}  Opens in new tab. Standard markdown link syntax.${R}\n\n${C}  EMBED (link preview)${R}\n${Y}  > [!embed]${R}\n${Y}  > https://youtube.com/watch?v=ID${R}\n${D}  YouTube → video player. Other URLs → preview card.${R}\n\n${C}  IMAGE${R}\n${Y}  ![description](https://url.com/image.png)${R}\n\n${C}  FILE ATTACHMENT${R}\n${Y}  > [!file]${R}\n${Y}  > [filename.pdf](https://url.com/file.pdf)${R}\n${Y}  > application/pdf 149780${R}\n\n${D}  ══════════════════════════════════════════════════════════════${R}\n\n${C}${B}  7. WIKI LINKS — HOW TO CONNECT NOTES${R}\n\n${D}  Wiki links create connections between notes.${R}\n${D}  They render as clickable purple links in the web app.${R}\n${D}  The linked note shows a \"backlink\" at the bottom.${R}\n\n${Y}  Check out [[Project Roadmap]] for details.${R}\n${Y}  This connects to [[AI Research Notes]] and [[Meeting Notes]].${R}\n\n${D}  Rules:${R}\n${D}  • Use the exact note title inside [[ ]]${R}\n${D}  • Case-insensitive: [[my note]] matches \"My Note\"${R}\n${D}  • If the note doesn't exist yet, the link is still created${R}\n${D}  • Multiple links in one paragraph is fine${R}\n${D}  • Wiki links work in any text: paragraphs, todos, callouts${R}\n\n${D}  Example: Create a network of linked notes${R}\n  ${G}vertex new \"Hub Note\"${R}\n  ${G}vertex edit \"Hub Note\"${R}\n${D}  Then write:${R}\n${Y}  # Hub Note${R}\n${Y}  ${R}\n${Y}  This connects to:${R}\n${Y}  - [[Topic A]] — first topic${R}\n${Y}  - [[Topic B]] — second topic${R}\n${Y}  - [[Topic C]] — third topic${R}\n\n${C}${B}  8. TAGS — HOW THEY WORK${R}\n\n${D}  Tags categorize content. They appear as purple pills in the web app.${R}\n${D}  Tags are auto-created when you use them — no need to create first.${R}\n\n${C}  Basic tags:${R}\n${Y}  This paragraph has #work and #important tags.${R}\n${Y}  - [x] Finish report #work #deadline${R}\n\n${C}  Rules:${R}\n${D}  • Must start with a letter: #valid, #tag123${R}\n${D}  • Can contain letters, numbers, hyphens, underscores: #my-tag, #my_tag${R}\n${D}  • NO spaces: #my tag is wrong → use #my-tag${R}\n${D}  • Tags are case-insensitive: #Work = #work${R}\n${D}  • Tags work everywhere: paragraphs, todos, headings, callouts${R}\n\n${C}${B}  9. TAG HIERARCHY — PARENT/CHILD RELATIONSHIPS${R}\n\n${D}  Tags can have parent-child relationships using / separator.${R}\n${D}  This creates a DAG (directed acyclic graph) of tags.${R}\n\n${Y}  This is about #work/frontend${R}      ${D}← creates: work → frontend${R}\n${Y}  Also covers #work/backend${R}         ${D}← creates: work → backend${R}\n${Y}  Deep nesting: #cs/algo/sorting${R}    ${D}← creates: cs → algo → sorting${R}\n\n${D}  What happens:${R}\n${D}  • Only the LEAF tag is applied to the block: \"frontend\" not \"work\"${R}\n${D}  • Parent tags are auto-created if they don't exist${R}\n${D}  • Parent→child edges are created in the tag hierarchy${R}\n${D}  • Searching #work finds blocks tagged with #work AND all children${R}\n${D}    (frontend, backend, etc.)${R}\n\n${D}  You can also set relationships via command palette (Cmd+K in web):${R}\n${D}  \"Tag Extend\" → pick parent and child tags${R}\n\n${C}${B}  10. SEARCH QUERY SYNTAX${R}\n\n  ${G}vertex search \"keyword\"${R}           ${D}← full-text search${R}\n  ${G}vertex search \"#work\"${R}             ${D}← all blocks tagged #work (+ children)${R}\n  ${G}vertex search \"#work/frontend\"${R}    ${D}← searches the leaf tag \"frontend\"${R}\n  ${G}vertex search \"type:todo\"${R}         ${D}← all todo blocks${R}\n  ${G}vertex search \"type:code\"${R}         ${D}← all code blocks${R}\n  ${G}vertex search \"type:heading\"${R}      ${D}← all headings${R}\n  ${G}vertex search \"status:open\"${R}       ${D}← unchecked todos${R}\n  ${G}vertex search \"status:done\"${R}       ${D}← checked todos${R}\n  ${G}vertex search \"type:todo status:open #work\"${R}  ${D}← combine filters${R}\n  ${G}vertex search \"type:todo #work keyword\"${R}      ${D}← all three${R}\n\n${C}${B}  11. DAILY NOTES${R}\n\n  ${G}vertex daily${R}                      ${D}← view/create today's daily note${R}\n  ${G}vertex daily --last${R}               ${D}← view most recent daily (no create)${R}\n  ${G}vertex today${R}                      ${D}← open latest daily in interactive TUI${R}\n\n${D}  Daily notes are auto-titled with the date: \"April 14, 2026\"${R}\n${D}  One daily note per day — calling vertex daily twice won't duplicate.${R}\n\n${C}${B}  12. INTERACTIVE MODE${R}\n\n  ${G}vertex interactive \"Note Title\"${R}   ${D}← open any note${R}\n  ${G}vertex today${R}                      ${D}← shortcut for latest daily${R}\n\n${D}  Controls:${R}\n${D}  ↑ ↓       Move cursor between items${R}\n${D}  Enter      Toggle todo done/undone${R}\n${D}  t          Add new todo${R}\n${D}  n          Add new text line${R}\n${D}  d          Delete item at cursor${R}\n${D}  e          Open in $EDITOR for full editing${R}\n${D}  s          Save changes${R}\n${D}  q          Save and quit${R}\n\n${C}${B}  13. TRASH & DELETE${R}\n\n  ${G}vertex delete \"Note\"${R}              ${D}← soft delete (recoverable)${R}\n  ${G}vertex trash${R}                      ${D}← list trashed notes${R}\n  ${G}vertex restore \"Note\"${R}             ${D}← restore from trash${R}\n  ${G}vertex trash:empty${R}                ${D}← permanent delete all (irreversible)${R}\n\n${D}  Soft delete: note goes to trash, can be restored${R}\n${D}  Hard delete (trash:empty): note + files + tags permanently removed${R}\n\n${C}${B}  14. ALL COMMANDS REFERENCE${R}\n\n  ${G}vertex login${R}                      ${D}← authenticate (GitHub/Google/Email)${R}\n  ${G}vertex logout${R}                     ${D}← clear session${R}\n  ${G}vertex whoami${R}                     ${D}← show logged-in user${R}\n  ${G}vertex notes${R}                      ${D}← list all notes${R}\n  ${G}vertex new [title]${R}                ${D}← create note${R}\n  ${G}vertex view <title>${R}               ${D}← view as markdown${R}\n  ${G}vertex edit <title>${R}               ${D}← edit in $EDITOR${R}\n  ${G}vertex daily${R}                      ${D}← today's daily note${R}\n  ${G}vertex daily --last${R}               ${D}← latest daily note${R}\n  ${G}vertex today${R}                      ${D}← latest daily → interactive${R}\n  ${G}vertex interactive <title>${R}        ${D}← interactive TUI mode${R}\n  ${G}vertex capture \"text\"${R}             ${D}← quick capture to inbox${R}\n  ${G}vertex search <query>${R}             ${D}← search notes${R}\n  ${G}vertex tags${R}                       ${D}← list tags${R}\n  ${G}vertex import <file.md>${R}           ${D}← import markdown as note${R}\n  ${G}vertex import <file> -t \"T\"${R}       ${D}← import with title${R}\n  ${G}vertex export <title>${R}             ${D}← export as markdown${R}\n  ${G}vertex export <title> -o file${R}     ${D}← export to file${R}\n  ${G}vertex export <title> --json${R}      ${D}← export as JSON${R}\n  ${G}vertex delete <title>${R}             ${D}← soft delete${R}\n  ${G}vertex restore <title>${R}            ${D}← restore from trash${R}\n  ${G}vertex trash${R}                      ${D}← list trash${R}\n  ${G}vertex trash:empty${R}                ${D}← empty trash permanently${R}\n  ${G}vertex status${R}                     ${D}← storage, note count, version${R}\n  ${G}vertex syntax${R}                     ${D}← markdown syntax reference${R}\n  ${G}vertex howto${R}                      ${D}← this guide${R}\n  ${G}vertex help${R}                       ${D}← command overview${R}\n\n${C}${B}  15. FULL EXAMPLE — AI CREATING A COMPLETE NOTE${R}\n${D}  ──────────────────────────────────────────────────────────────${R}\n\n  ${G}cat > /tmp/my-note.md << 'VERTEX'${R}\n  ${Y}# Distributed Systems Study Guide${R}\n  ${Y}${R}\n  ${Y}Notes from studying distributed systems. #learning #cs${R}\n  ${Y}${R}\n  ${Y}## CAP Theorem${R}\n  ${Y}${R}\n  ${Y}A distributed system can only guarantee 2 of 3:${R}\n  ${Y}${R}\n  ${Y}- **Consistency** — every read gets the latest write${R}\n  ${Y}- **Availability** — every request gets a response${R}\n  ${Y}- **Partition tolerance** — system works despite network failures${R}\n  ${Y}${R}\n  ${Y}> [!warning]${R}\n  ${Y}> In practice, P is non-negotiable. You choose between CP and AP.${R}\n  ${Y}${R}\n  ${Y}## Consensus Algorithm${R}\n  ${Y}${R}\n  ${Y}\\`\\`\\`mermaid${R}\n  ${Y}sequenceDiagram${R}\n  ${Y}    Leader->>Follower1: AppendEntries${R}\n  ${Y}    Leader->>Follower2: AppendEntries${R}\n  ${Y}    Follower1-->>Leader: ACK${R}\n  ${Y}    Follower2-->>Leader: ACK${R}\n  ${Y}    Leader->>Leader: Commit (majority ACK)${R}\n  ${Y}\\`\\`\\`${R}\n  ${Y}${R}\n  ${Y}## Consistency Models${R}\n  ${Y}${R}\n  ${Y}$$${R}\n  ${Y}\\\\text{Linearizability} \\\\subset \\\\text{Sequential} \\\\subset \\\\text{Causal} \\\\subset \\\\text{Eventual}${R}\n  ${Y}$$${R}\n  ${Y}${R}\n  ${Y}## Implementation${R}\n  ${Y}${R}\n  ${Y}\\`\\`\\`go${R}\n  ${Y}type RaftNode struct {${R}\n  ${Y}    state    State${R}\n  ${Y}    term     int${R}\n  ${Y}    votedFor string${R}\n  ${Y}    log      []Entry${R}\n  ${Y}}${R}\n  ${Y}\\`\\`\\`${R}\n  ${Y}${R}\n  ${Y}## Reading List${R}\n  ${Y}${R}\n  ${Y}- [x] Designing Data-Intensive Applications #learning/books${R}\n  ${Y}- [ ] Raft paper #learning/papers${R}\n  ${Y}- [ ] Paxos Made Simple #learning/papers${R}\n  ${Y}${R}\n  ${Y}> [!tip]${R}\n  ${Y}> Start with Raft — it's simpler than Paxos and used in etcd.${R}\n  ${Y}${R}\n  ${Y}---${R}\n  ${Y}${R}\n  ${Y}Related: [[Project Roadmap]] · [[AI Research Notes]]${R}\n  ${G}VERTEX${R}\n\n  ${G}vertex import /tmp/my-note.md -t \"Distributed Systems Study Guide\"${R}\n\n${D}  ──────────────────────────────────────────────────────────────${R}\n${D}  This creates a note with: heading, bullets, callouts, mermaid,${R}\n${D}  math, code, todos with scoped tags, wiki links, and a divider.${R}\n${D}  Open the web app to see it rendered with rich blocks.${R}\n`);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/commands/import.js

@@ -0,0 +1,39 @@
+import {
+  getClient,
+  getUserId
+} from "../chunk-URRSVCB7.js";
+import "../chunk-PBF5EE4Y.js";
+import {
+  createNote,
+  markdownToTiptap,
+  saveNoteContent
+} from "../chunk-EEEL6ZKK.js";
+
+// src/commands/import.ts
+import { Command, Args, Flags } from "@oclif/core";
+import { readFileSync } from "fs";
+import { basename } from "path";
+var Import = class _Import extends Command {
+  static description = "Import a markdown file as a note";
+  static args = {
+    file: Args.string({ description: "Path to .md file", required: true })
+  };
+  static flags = {
+    title: Flags.string({ char: "t", description: "Note title (default: filename)" })
+  };
+  async run() {
+    const { args, flags } = await this.parse(_Import);
+    const client = await getClient();
+    const userId = await getUserId();
+    const md = readFileSync(args.file, "utf-8");
+    const title = flags.title ?? basename(args.file, ".md");
+    const tiptapJson = markdownToTiptap(md);
+    const note = await createNote(client, { user_id: userId, title });
+    await saveNoteContent(client, note.id, userId, tiptapJson);
+    this.log(`Imported: ${title} (${note.id})`);
+  }
+};
+export {
+  Import as default
+};
+//# sourceMappingURL=import.js.map

package/dist/commands/import.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commands/import.ts"],"sourcesContent":["import { Command, Args, Flags } from \"@oclif/core\";\nimport { readFileSync } from \"node:fs\";\nimport { basename } from \"node:path\";\nimport { createNote, saveNoteContent } from \"@vertex/core\";\nimport { getClient, getUserId } from \"../lib/client.js\";\nimport { markdownToTiptap } from \"@vertex/core\";\n\nexport default class Import extends Command {\n  static override description = \"Import a markdown file as a note\";\n\n  static override args = {\n    file: Args.string({ description: \"Path to .md file\", required: true }),\n  };\n\n  static override flags = {\n    title: Flags.string({ char: \"t\", description: \"Note title (default: filename)\" }),\n  };\n\n  async run(): Promise<void> {\n    const { args, flags } = await this.parse(Import);\n    const client = await getClient();\n    const userId = await getUserId();\n\n    const md = readFileSync(args.file, \"utf-8\");\n    const title = flags.title ?? basename(args.file, \".md\");\n    const tiptapJson = markdownToTiptap(md);\n\n    const note = await createNote(client, { user_id: userId, title });\n    await saveNoteContent(client, note.id, userId, tiptapJson);\n\n    this.log(`Imported: ${title} (${note.id})`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAAA,SAAS,SAAS,MAAM,aAAa;AACrC,SAAS,oBAAoB;AAC7B,SAAS,gBAAgB;AAKzB,IAAqB,SAArB,MAAqB,gBAAe,QAAQ;AAAA,EAC1C,OAAgB,cAAc;AAAA,EAE9B,OAAgB,OAAO;AAAA,IACrB,MAAM,KAAK,OAAO,EAAE,aAAa,oBAAoB,UAAU,KAAK,CAAC;AAAA,EACvE;AAAA,EAEA,OAAgB,QAAQ;AAAA,IACtB,OAAO,MAAM,OAAO,EAAE,MAAM,KAAK,aAAa,iCAAiC,CAAC;AAAA,EAClF;AAAA,EAEA,MAAM,MAAqB;AACzB,UAAM,EAAE,MAAM,MAAM,IAAI,MAAM,KAAK,MAAM,OAAM;AAC/C,UAAM,SAAS,MAAM,UAAU;AAC/B,UAAM,SAAS,MAAM,UAAU;AAE/B,UAAM,KAAK,aAAa,KAAK,MAAM,OAAO;AAC1C,UAAM,QAAQ,MAAM,SAAS,SAAS,KAAK,MAAM,KAAK;AACtD,UAAM,aAAa,iBAAiB,EAAE;AAEtC,UAAM,OAAO,MAAM,WAAW,QAAQ,EAAE,SAAS,QAAQ,MAAM,CAAC;AAChE,UAAM,gBAAgB,QAAQ,KAAK,IAAI,QAAQ,UAAU;AAEzD,SAAK,IAAI,aAAa,KAAK,KAAK,KAAK,EAAE,GAAG;AAAA,EAC5C;AACF;","names":[]}