vertex-notes 0.1.4 → 0.2.0

package/dist/{chunk-DDFOKGIX.js → chunk-XGZKUOFI.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-PBF5EE4Y.js";
 import {
   createSupabaseClient
-} from "./chunk-4QLCD6TZ.js";
+} from "./chunk-WM6QVD53.js";
 
 // src/lib/client.ts
 var cachedClient = null;
@@ -47,4 +47,4 @@ export {
   getClient,
   getUserId
 };
-//# sourceMappingURL=chunk-DDFOKGIX.js.map
+//# sourceMappingURL=chunk-XGZKUOFI.js.map

package/dist/commands/capture.js

@@ -1,13 +1,13 @@
 import {
   getClient,
   getUserId
-} from "../chunk-DDFOKGIX.js";
+} from "../chunk-XGZKUOFI.js";
 import "../chunk-PBF5EE4Y.js";
 import {
   getBlocksForNote,
   listNotes,
   saveNoteContent
-} from "../chunk-4QLCD6TZ.js";
+} from "../chunk-WM6QVD53.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-DDFOKGIX.js";
+} from "../chunk-XGZKUOFI.js";
 import "../chunk-PBF5EE4Y.js";
 import {
   exportNoteAsMarkdown,
   getOrCreateDailyNote,
   listNotes
-} from "../chunk-4QLCD6TZ.js";
+} from "../chunk-WM6QVD53.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-DDFOKGIX.js";
+} from "../chunk-XGZKUOFI.js";
 import "../chunk-PBF5EE4Y.js";
 import {
   listNotes,
   softDeleteNote
-} from "../chunk-4QLCD6TZ.js";
+} from "../chunk-WM6QVD53.js";
 
 // src/commands/delete.ts
 import { Command, Args } from "@oclif/core";

package/dist/commands/edit.js

@@ -1,16 +1,14 @@
-import {
-  markdownToTiptap
-} from "../chunk-FWK2J3FR.js";
 import {
   getClient,
   getUserId
-} from "../chunk-DDFOKGIX.js";
+} from "../chunk-XGZKUOFI.js";
 import "../chunk-PBF5EE4Y.js";
 import {
   exportNoteAsMarkdown,
   listNotes,
+  markdownToTiptap,
   saveNoteContent
-} from "../chunk-4QLCD6TZ.js";
+} from "../chunk-WM6QVD53.js";
 
 // src/commands/edit.ts
 import { Command, Args } from "@oclif/core";

package/dist/commands/edit.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/commands/edit.ts"],"sourcesContent":["import { Command, Args } from \"@oclif/core\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { writeFileSync, readFileSync } from \"node:fs\";\nimport { execSync } from \"node:child_process\";\nimport { createInterface } from \"node:readline\";\nimport { listNotes, exportNoteAsMarkdown, saveNoteContent } from \"@vertex/core\";\nimport { getClient, getUserId } from \"../lib/client.js\";\nimport { markdownToTiptap } from \"../lib/md-to-tiptap.js\";\n\nconst SYNTAX_GUIDE = `\n  Markdown Syntax Guide\n  ─────────────────────\n\n  Headings:       # H1    ## H2    ### H3\n  Formatting:     **bold**  *italic*  \\`code\\`  ~~strike~~\n  Links:          [[Wiki Link]]    #tagname\n\n  Lists:          - bullet         1. numbered\n  Tasks:          - [x] done       - [ ] open\n  Other:          > blockquote     --- divider\n\n  Code block:     \\`\\`\\`python        Math block:    $$\n                  print(\"hi\")                    E = mc^2\n                  \\`\\`\\`                             $$\n\n  Web app only: mermaid, callouts, query blocks, file uploads\n`;\n\nexport default class Edit extends Command {\n  static override description = \"Edit a note in your $EDITOR\";\n\n  static override args = {\n    title: Args.string({ description: \"Note title (partial match)\", required: true }),\n  };\n\n  async run(): Promise<void> {\n    const { args } = await this.parse(Edit);\n    const client = await getClient();\n    const userId = await getUserId();\n    const notes = await listNotes(client, { user_id: userId });\n    const query = args.title.toLowerCase();\n    const match = notes.find((n) => !n.deleted_at && n.title.toLowerCase().includes(query));\n\n    if (!match) {\n      this.error(`No note matching \"${args.title}\"`);\n    }\n\n    const editor = process.env.EDITOR || process.env.VISUAL || \"vim\";\n\n    this.log(`\\n  Editing: ${match.title}`);\n    this.log(`  Editor:  ${editor}`);\n    this.log(SYNTAX_GUIDE);\n\n    const rl = createInterface({ input: process.stdin, output: process.stdout });\n    await new Promise<void>((resolve) => {\n      rl.question(\"  Press Enter to open editor...\", () => { rl.close(); resolve(); });\n    });\n\n    const md = await exportNoteAsMarkdown(client, match.id);\n    const tmpFile = join(tmpdir(), `vertex-${match.id}.md`);\n    writeFileSync(tmpFile, md, \"utf-8\");\n\n    try {\n      execSync(`${editor} \"${tmpFile}\"`, { stdio: \"inherit\" });\n    } catch {\n      this.error(\"Editor exited with error\");\n    }\n\n    const edited = readFileSync(tmpFile, \"utf-8\");\n    if (edited === md) {\n      this.log(\"No changes.\");\n      return;\n    }\n\n    const tiptapJson = markdownToTiptap(edited);\n    await saveNoteContent(client, match.id, userId, tiptapJson);\n    this.log(`Saved: ${match.title}`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAAA,SAAS,SAAS,YAAY;AAC9B,SAAS,cAAc;AACvB,SAAS,YAAY;AACrB,SAAS,eAAe,oBAAoB;AAC5C,SAAS,gBAAgB;AACzB,SAAS,uBAAuB;AAKhC,IAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmBrB,IAAqB,OAArB,MAAqB,cAAa,QAAQ;AAAA,EACxC,OAAgB,cAAc;AAAA,EAE9B,OAAgB,OAAO;AAAA,IACrB,OAAO,KAAK,OAAO,EAAE,aAAa,8BAA8B,UAAU,KAAK,CAAC;AAAA,EAClF;AAAA,EAEA,MAAM,MAAqB;AACzB,UAAM,EAAE,KAAK,IAAI,MAAM,KAAK,MAAM,KAAI;AACtC,UAAM,SAAS,MAAM,UAAU;AAC/B,UAAM,SAAS,MAAM,UAAU;AAC/B,UAAM,QAAQ,MAAM,UAAU,QAAQ,EAAE,SAAS,OAAO,CAAC;AACzD,UAAM,QAAQ,KAAK,MAAM,YAAY;AACrC,UAAM,QAAQ,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,MAAM,YAAY,EAAE,SAAS,KAAK,CAAC;AAEtF,QAAI,CAAC,OAAO;AACV,WAAK,MAAM,qBAAqB,KAAK,KAAK,GAAG;AAAA,IAC/C;AAEA,UAAM,SAAS,QAAQ,IAAI,UAAU,QAAQ,IAAI,UAAU;AAE3D,SAAK,IAAI;AAAA,aAAgB,MAAM,KAAK,EAAE;AACtC,SAAK,IAAI,cAAc,MAAM,EAAE;AAC/B,SAAK,IAAI,YAAY;AAErB,UAAM,KAAK,gBAAgB,EAAE,OAAO,QAAQ,OAAO,QAAQ,QAAQ,OAAO,CAAC;AAC3E,UAAM,IAAI,QAAc,CAAC,YAAY;AACnC,SAAG,SAAS,mCAAmC,MAAM;AAAE,WAAG,MAAM;AAAG,gBAAQ;AAAA,MAAG,CAAC;AAAA,IACjF,CAAC;AAED,UAAM,KAAK,MAAM,qBAAqB,QAAQ,MAAM,EAAE;AACtD,UAAM,UAAU,KAAK,OAAO,GAAG,UAAU,MAAM,EAAE,KAAK;AACtD,kBAAc,SAAS,IAAI,OAAO;AAElC,QAAI;AACF,eAAS,GAAG,MAAM,KAAK,OAAO,KAAK,EAAE,OAAO,UAAU,CAAC;AAAA,IACzD,QAAQ;AACN,WAAK,MAAM,0BAA0B;AAAA,IACvC;AAEA,UAAM,SAAS,aAAa,SAAS,OAAO;AAC5C,QAAI,WAAW,IAAI;AACjB,WAAK,IAAI,aAAa;AACtB;AAAA,IACF;AAEA,UAAM,aAAa,iBAAiB,MAAM;AAC1C,UAAM,gBAAgB,QAAQ,MAAM,IAAI,QAAQ,UAAU;AAC1D,SAAK,IAAI,UAAU,MAAM,KAAK,EAAE;AAAA,EAClC;AACF;","names":[]}
+{"version":3,"sources":["../../src/commands/edit.ts"],"sourcesContent":["import { Command, Args } from \"@oclif/core\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { writeFileSync, readFileSync } from \"node:fs\";\nimport { execSync } from \"node:child_process\";\nimport { createInterface } from \"node:readline\";\nimport { listNotes, exportNoteAsMarkdown, saveNoteContent } from \"@vertex/core\";\nimport { getClient, getUserId } from \"../lib/client.js\";\nimport { markdownToTiptap } from \"@vertex/core\";\n\nconst SYNTAX_GUIDE = `\n  Markdown Syntax Guide\n  ─────────────────────\n\n  Headings:       # H1    ## H2    ### H3\n  Formatting:     **bold**  *italic*  \\`code\\`  ~~strike~~\n  Links:          [[Wiki Link]]    #tagname\n\n  Lists:          - bullet         1. numbered\n  Tasks:          - [x] done       - [ ] open\n  Other:          > blockquote     --- divider\n\n  Code block:     \\`\\`\\`python        Math block:    $$\n                  print(\"hi\")                    E = mc^2\n                  \\`\\`\\`                             $$\n\n  Web app only: mermaid, callouts, query blocks, file uploads\n`;\n\nexport default class Edit extends Command {\n  static override description = \"Edit a note in your $EDITOR\";\n\n  static override args = {\n    title: Args.string({ description: \"Note title (partial match)\", required: true }),\n  };\n\n  async run(): Promise<void> {\n    const { args } = await this.parse(Edit);\n    const client = await getClient();\n    const userId = await getUserId();\n    const notes = await listNotes(client, { user_id: userId });\n    const query = args.title.toLowerCase();\n    const match = notes.find((n) => !n.deleted_at && n.title.toLowerCase().includes(query));\n\n    if (!match) {\n      this.error(`No note matching \"${args.title}\"`);\n    }\n\n    const editor = process.env.EDITOR || process.env.VISUAL || \"vim\";\n\n    this.log(`\\n  Editing: ${match.title}`);\n    this.log(`  Editor:  ${editor}`);\n    this.log(SYNTAX_GUIDE);\n\n    const rl = createInterface({ input: process.stdin, output: process.stdout });\n    await new Promise<void>((resolve) => {\n      rl.question(\"  Press Enter to open editor...\", () => { rl.close(); resolve(); });\n    });\n\n    const md = await exportNoteAsMarkdown(client, match.id);\n    const tmpFile = join(tmpdir(), `vertex-${match.id}.md`);\n    writeFileSync(tmpFile, md, \"utf-8\");\n\n    try {\n      execSync(`${editor} \"${tmpFile}\"`, { stdio: \"inherit\" });\n    } catch {\n      this.error(\"Editor exited with error\");\n    }\n\n    const edited = readFileSync(tmpFile, \"utf-8\");\n    if (edited === md) {\n      this.log(\"No changes.\");\n      return;\n    }\n\n    const tiptapJson = markdownToTiptap(edited);\n    await saveNoteContent(client, match.id, userId, tiptapJson);\n    this.log(`Saved: ${match.title}`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAAA,SAAS,SAAS,YAAY;AAC9B,SAAS,cAAc;AACvB,SAAS,YAAY;AACrB,SAAS,eAAe,oBAAoB;AAC5C,SAAS,gBAAgB;AACzB,SAAS,uBAAuB;AAKhC,IAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmBrB,IAAqB,OAArB,MAAqB,cAAa,QAAQ;AAAA,EACxC,OAAgB,cAAc;AAAA,EAE9B,OAAgB,OAAO;AAAA,IACrB,OAAO,KAAK,OAAO,EAAE,aAAa,8BAA8B,UAAU,KAAK,CAAC;AAAA,EAClF;AAAA,EAEA,MAAM,MAAqB;AACzB,UAAM,EAAE,KAAK,IAAI,MAAM,KAAK,MAAM,KAAI;AACtC,UAAM,SAAS,MAAM,UAAU;AAC/B,UAAM,SAAS,MAAM,UAAU;AAC/B,UAAM,QAAQ,MAAM,UAAU,QAAQ,EAAE,SAAS,OAAO,CAAC;AACzD,UAAM,QAAQ,KAAK,MAAM,YAAY;AACrC,UAAM,QAAQ,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,MAAM,YAAY,EAAE,SAAS,KAAK,CAAC;AAEtF,QAAI,CAAC,OAAO;AACV,WAAK,MAAM,qBAAqB,KAAK,KAAK,GAAG;AAAA,IAC/C;AAEA,UAAM,SAAS,QAAQ,IAAI,UAAU,QAAQ,IAAI,UAAU;AAE3D,SAAK,IAAI;AAAA,aAAgB,MAAM,KAAK,EAAE;AACtC,SAAK,IAAI,cAAc,MAAM,EAAE;AAC/B,SAAK,IAAI,YAAY;AAErB,UAAM,KAAK,gBAAgB,EAAE,OAAO,QAAQ,OAAO,QAAQ,QAAQ,OAAO,CAAC;AAC3E,UAAM,IAAI,QAAc,CAAC,YAAY;AACnC,SAAG,SAAS,mCAAmC,MAAM;AAAE,WAAG,MAAM;AAAG,gBAAQ;AAAA,MAAG,CAAC;AAAA,IACjF,CAAC;AAED,UAAM,KAAK,MAAM,qBAAqB,QAAQ,MAAM,EAAE;AACtD,UAAM,UAAU,KAAK,OAAO,GAAG,UAAU,MAAM,EAAE,KAAK;AACtD,kBAAc,SAAS,IAAI,OAAO;AAElC,QAAI;AACF,eAAS,GAAG,MAAM,KAAK,OAAO,KAAK,EAAE,OAAO,UAAU,CAAC;AAAA,IACzD,QAAQ;AACN,WAAK,MAAM,0BAA0B;AAAA,IACvC;AAEA,UAAM,SAAS,aAAa,SAAS,OAAO;AAC5C,QAAI,WAAW,IAAI;AACjB,WAAK,IAAI,aAAa;AACtB;AAAA,IACF;AAEA,UAAM,aAAa,iBAAiB,MAAM;AAC1C,UAAM,gBAAgB,QAAQ,MAAM,IAAI,QAAQ,UAAU;AAC1D,SAAK,IAAI,UAAU,MAAM,KAAK,EAAE;AAAA,EAClC;AACF;","names":[]}

package/dist/commands/export.js

@@ -1,13 +1,13 @@
 import {
   getClient,
   getUserId
-} from "../chunk-DDFOKGIX.js";
+} from "../chunk-XGZKUOFI.js";
 import "../chunk-PBF5EE4Y.js";
 import {
   exportNoteAsJson,
   exportNoteAsMarkdown,
   listNotes
-} from "../chunk-4QLCD6TZ.js";
+} from "../chunk-WM6QVD53.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-4QLCD6TZ.js";
+} from "../chunk-WM6QVD53.js";
 
 // src/commands/hello.ts
 import { Command } from "@oclif/core";

package/dist/commands/help.js

@@ -1,6 +1,6 @@
 import {
   VERTEX_VERSION
-} from "../chunk-4QLCD6TZ.js";
+} from "../chunk-WM6QVD53.js";
 
 // src/commands/help.ts
 import { Command } from "@oclif/core";
@@ -48,6 +48,7 @@ ${row("vertex interactive <title>", "Open any note \u2192 interactive")}
   ${DIM}\u2502${R} ${YELLOW}t${R}        ${DIM}\u2502${R} Add new todo                               ${DIM}\u2502${R}
   ${DIM}\u2502${R} ${YELLOW}n${R}        ${DIM}\u2502${R} Add new text line                          ${DIM}\u2502${R}
   ${DIM}\u2502${R} ${YELLOW}d${R}        ${DIM}\u2502${R} Delete item at cursor                      ${DIM}\u2502${R}
+  ${DIM}\u2502${R} ${YELLOW}e${R}        ${DIM}\u2502${R} Open in $EDITOR for full editing            ${DIM}\u2502${R}
   ${DIM}\u2502${R} ${YELLOW}s${R}        ${DIM}\u2502${R} Save changes                               ${DIM}\u2502${R}
   ${DIM}\u2502${R} ${YELLOW}q${R}        ${DIM}\u2502${R} Quit ${DIM}(auto-saves if changed)${R}               ${DIM}\u2502${R}
   ${DIM}\u2502${R} ${YELLOW}Esc${R}      ${DIM}\u2502${R} Cancel input                               ${DIM}\u2502${R}
@@ -59,7 +60,9 @@ ${row("vertex search <query>", "Search notes")}
 ${row("vertex tags", "List all tags")}
 
   ${DIM}Query syntax:  ${PURPLE}keyword${R}${DIM} \xB7 ${PURPLE}#tag${R}${DIM} \xB7 ${PURPLE}type:todo${R}${DIM} \xB7 ${PURPLE}status:open${R}${DIM} \xB7 ${PURPLE}status:done${R}
-${heading("EXPORT")}
+${heading("IMPORT & EXPORT")}
+${row("vertex import <file.md>", "Import markdown file as new note")}
+${row('vertex import <file> -t "Title"', "Import with custom title")}
 ${row("vertex export <title>", "Export as markdown to stdout")}
 ${row("vertex export <title> --json", "Export as JSON")}
 ${row("vertex export <title> -o file", "Export to file")}
@@ -72,21 +75,27 @@ ${heading("INFO")}
 ${row("vertex status", "Storage usage, note count, version")}
 ${row("vertex hello", "Verify CLI is working")}
 ${row("vertex help", "Show this help")}
+${row("vertex syntax", "Markdown syntax reference")}
+${row("vertex howto", "Complete AI guide \u2014 everything to know")}
 ${heading("EDITOR SYNTAX")}
 ${sub("for use with: vertex edit <title>")}
 
-  ${DIM}\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\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\u2510${R}
-  ${DIM}\u2502${R} ${YELLOW}# ## ###${R}             ${DIM}\u2502${R} Headings                         ${DIM}\u2502${R}
-  ${DIM}\u2502${R} ${YELLOW}**bold** *italic*${R}     ${DIM}\u2502${R} Formatting                       ${DIM}\u2502${R}
-  ${DIM}\u2502${R} ${YELLOW}\`code\` ~~strike~~${R}     ${DIM}\u2502${R} Inline code & strikethrough      ${DIM}\u2502${R}
-  ${DIM}\u2502${R} ${YELLOW}[[Link]] #tag${R}         ${DIM}\u2502${R} Wiki links & tags                ${DIM}\u2502${R}
-  ${DIM}\u2502${R} ${YELLOW}- item${R}  ${YELLOW}1. item${R}      ${DIM}\u2502${R} Bullet & numbered lists          ${DIM}\u2502${R}
-  ${DIM}\u2502${R} ${YELLOW}- [x]${R}   ${YELLOW}- [ ]${R}        ${DIM}\u2502${R} Done & open tasks                ${DIM}\u2502${R}
-  ${DIM}\u2502${R} ${YELLOW}> quote${R}  ${YELLOW}---${R}          ${DIM}\u2502${R} Blockquote & divider             ${DIM}\u2502${R}
-  ${DIM}\u2502${R} ${YELLOW}\`\`\`lang ... \`\`\`${R}       ${DIM}\u2502${R} Code block                       ${DIM}\u2502${R}
-  ${DIM}\u2502${R} ${YELLOW}$$ ... $$${R}             ${DIM}\u2502${R} Math block (LaTeX)               ${DIM}\u2502${R}
-  ${DIM}\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\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\u2518${R}
-  ${DIM}Web app only: mermaid, callouts, query blocks, file uploads${R}
+  ${DIM}\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\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\u2510${R}
+  ${DIM}\u2502${R} ${YELLOW}# ## ###${R}               ${DIM}\u2502${R} Headings                       ${DIM}\u2502${R}
+  ${DIM}\u2502${R} ${YELLOW}**bold** *italic*${R}       ${DIM}\u2502${R} Formatting                     ${DIM}\u2502${R}
+  ${DIM}\u2502${R} ${YELLOW}\`code\` ~~strike~~${R}       ${DIM}\u2502${R} Inline code & strikethrough    ${DIM}\u2502${R}
+  ${DIM}\u2502${R} ${YELLOW}[[Link]] #tag${R}           ${DIM}\u2502${R} Wiki links & tags              ${DIM}\u2502${R}
+  ${DIM}\u2502${R} ${YELLOW}- item${R}  ${YELLOW}1. item${R}        ${DIM}\u2502${R} Bullet & numbered lists        ${DIM}\u2502${R}
+  ${DIM}\u2502${R} ${YELLOW}- [x]${R}   ${YELLOW}- [ ]${R}          ${DIM}\u2502${R} Done & open tasks              ${DIM}\u2502${R}
+  ${DIM}\u2502${R} ${YELLOW}> quote${R}  ${YELLOW}---${R}            ${DIM}\u2502${R} Blockquote & divider           ${DIM}\u2502${R}
+  ${DIM}\u2502${R} ${YELLOW}\`\`\`lang ... \`\`\`${R}         ${DIM}\u2502${R} Code block                     ${DIM}\u2502${R}
+  ${DIM}\u2502${R} ${YELLOW}\`\`\`mermaid ... \`\`\`${R}      ${DIM}\u2502${R} Mermaid diagram                ${DIM}\u2502${R}
+  ${DIM}\u2502${R} ${YELLOW}$$ ... $$${R}               ${DIM}\u2502${R} Math block (LaTeX)             ${DIM}\u2502${R}
+  ${DIM}\u2502${R} ${YELLOW}> [!info] > text${R}        ${DIM}\u2502${R} Callout (info/warning/error/tip)${DIM}\u2502${R}
+  ${DIM}\u2502${R} ${YELLOW}> [!query] > query${R}      ${DIM}\u2502${R} Live query block               ${DIM}\u2502${R}
+  ${DIM}\u2502${R} ${YELLOW}![alt](url)${R}             ${DIM}\u2502${R} Image                          ${DIM}\u2502${R}
+  ${DIM}\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\u2534\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\u2518${R}
+  ${DIM}All block types work in CLI edit, export, and import${R}
 ${heading("TIPS")}
   ${DIM}\u2022${R} Title args use partial matching ${DIM}("proj" \u2192 "Project Plan")${R}
   ${DIM}\u2022${R} Set ${YELLOW}EDITOR=nano${R} or ${YELLOW}EDITOR="code --wait"${R} for preferred editor

package/dist/commands/help.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/commands/help.ts"],"sourcesContent":["import { Command } from \"@oclif/core\";\nimport { VERTEX_VERSION } from \"@vertex/core\";\n\nconst DIM = \"\\x1b[90m\";\nconst BOLD = \"\\x1b[1m\";\nconst CYAN = \"\\x1b[36m\";\nconst YELLOW = \"\\x1b[33m\";\nconst GREEN = \"\\x1b[32m\";\nconst PURPLE = \"\\x1b[35m\";\nconst R = \"\\x1b[0m\";\n\nfunction heading(text: string): string {\n  return `\\n  ${BOLD}${CYAN}${text}${R}`;\n}\n\nfunction row(cmd: string, desc: string): string {\n  return `  ${GREEN}${cmd.padEnd(32)}${R}${DIM}${desc}${R}`;\n}\n\nfunction sub(text: string): string {\n  return `  ${DIM}${text}${R}`;\n}\n\nexport default class Help extends Command {\n  static override description = \"Show all Vertex CLI commands\";\n\n  async run(): Promise<void> {\n    this.log(`\n  ${BOLD}${PURPLE}▲ Vertex CLI${R} ${DIM}v${VERTEX_VERSION}${R}\n  ${DIM}Your knowledge, structured — from the terminal.${R}\n${heading(\"AUTH\")}\n${row(\"vertex login\", \"Log in (GitHub, Google, or Email)\")}\n${row(\"vertex logout\", \"Log out and clear saved session\")}\n${row(\"vertex whoami\", \"Show logged-in user email\")}\n${heading(\"NOTES\")}\n${row(\"vertex notes\", \"List all notes\")}\n${row(\"vertex new [title]\", \"Create a new note\")}\n${row(\"vertex view <title>\", \"View note as markdown\")}\n${row(\"vertex edit <title>\", \"Edit note in $EDITOR\")}\n${row(\"vertex daily\", \"View or create today's daily note\")}\n${row(\"vertex daily --last\", \"View most recent daily note\")}\n${heading(\"INTERACTIVE MODE\")}\n${row(\"vertex today\", \"Latest daily note → interactive\")}\n${row(\"vertex interactive <title>\", \"Open any note → interactive\")}\n\n  ${DIM}┌──────────┬────────────────────────────────────────────┐${R}\n  ${DIM}│${R} ${YELLOW}↑ ↓${R}      ${DIM}│${R} Move cursor between items                  ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}Enter${R}    ${DIM}│${R} Toggle todo ${DIM}[ ] → [✓] → [ ]${R}               ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}t${R}        ${DIM}│${R} Add new todo                               ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}n${R}        ${DIM}│${R} Add new text line                          ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}d${R}        ${DIM}│${R} Delete item at cursor                      ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}s${R}        ${DIM}│${R} Save changes                               ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}q${R}        ${DIM}│${R} Quit ${DIM}(auto-saves if changed)${R}               ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}Esc${R}      ${DIM}│${R} Cancel input                               ${DIM}│${R}\n  ${DIM}└──────────┴────────────────────────────────────────────┘${R}\n${heading(\"CAPTURE\")}\n${row(\"vertex capture \\\"text\\\"\", \"Quick capture to Inbox note\")}\n${heading(\"SEARCH & ORGANIZE\")}\n${row(\"vertex search <query>\", \"Search notes\")}\n${row(\"vertex tags\", \"List all tags\")}\n\n  ${DIM}Query syntax:  ${PURPLE}keyword${R}${DIM} · ${PURPLE}#tag${R}${DIM} · ${PURPLE}type:todo${R}${DIM} · ${PURPLE}status:open${R}${DIM} · ${PURPLE}status:done${R}\n${heading(\"EXPORT\")}\n${row(\"vertex export <title>\", \"Export as markdown to stdout\")}\n${row(\"vertex export <title> --json\", \"Export as JSON\")}\n${row(\"vertex export <title> -o file\", \"Export to file\")}\n${heading(\"TRASH\")}\n${row(\"vertex delete <title>\", \"Soft delete → trash\")}\n${row(\"vertex restore <title>\", \"Restore from trash\")}\n${row(\"vertex trash\", \"List trashed notes\")}\n${row(\"vertex trash:empty\", \"Permanently delete all trash\")}\n${heading(\"INFO\")}\n${row(\"vertex status\", \"Storage usage, note count, version\")}\n${row(\"vertex hello\", \"Verify CLI is working\")}\n${row(\"vertex help\", \"Show this help\")}\n${heading(\"EDITOR SYNTAX\")}\n${sub(\"for use with: vertex edit <title>\")}\n\n  ${DIM}┌──────────────────────┬──────────────────────────────────┐${R}\n  ${DIM}│${R} ${YELLOW}# ## ###${R}             ${DIM}│${R} Headings                         ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}**bold** *italic*${R}     ${DIM}│${R} Formatting                       ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}\\`code\\` ~~strike~~${R}     ${DIM}│${R} Inline code & strikethrough      ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}[[Link]] #tag${R}         ${DIM}│${R} Wiki links & tags                ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}- item${R}  ${YELLOW}1. item${R}      ${DIM}│${R} Bullet & numbered lists          ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}- [x]${R}   ${YELLOW}- [ ]${R}        ${DIM}│${R} Done & open tasks                ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}> quote${R}  ${YELLOW}---${R}          ${DIM}│${R} Blockquote & divider             ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}\\`\\`\\`lang ... \\`\\`\\`${R}       ${DIM}│${R} Code block                       ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}$$ ... $$${R}             ${DIM}│${R} Math block (LaTeX)               ${DIM}│${R}\n  ${DIM}└──────────────────────┴──────────────────────────────────┘${R}\n  ${DIM}Web app only: mermaid, callouts, query blocks, file uploads${R}\n${heading(\"TIPS\")}\n  ${DIM}•${R} Title args use partial matching ${DIM}(\"proj\" → \"Project Plan\")${R}\n  ${DIM}•${R} Set ${YELLOW}EDITOR=nano${R} or ${YELLOW}EDITOR=\"code --wait\"${R} for preferred editor\n  ${DIM}•${R} Session stored in ${DIM}~/.vertex/config.json${R}\n  ${DIM}•${R} New users get 50 MB storage, upgradeable per account\n  ${DIM}•${R} ${GREEN}vertex today${R} is the fastest way to manage daily todos\n${heading(\"EXAMPLES\")}\n  ${DIM}$${R} vertex today\n  ${DIM}$${R} vertex capture \"buy groceries\"\n  ${DIM}$${R} vertex search \"#work type:todo status:open\"\n  ${DIM}$${R} vertex export \"Meeting Notes\" -o meeting.md\n  ${DIM}$${R} EDITOR=nano vertex edit \"Ideas\"\n`);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/commands/help.ts"],"sourcesContent":["import { Command } from \"@oclif/core\";\nimport { VERTEX_VERSION } from \"@vertex/core\";\n\nconst DIM = \"\\x1b[90m\";\nconst BOLD = \"\\x1b[1m\";\nconst CYAN = \"\\x1b[36m\";\nconst YELLOW = \"\\x1b[33m\";\nconst GREEN = \"\\x1b[32m\";\nconst PURPLE = \"\\x1b[35m\";\nconst R = \"\\x1b[0m\";\n\nfunction heading(text: string): string {\n  return `\\n  ${BOLD}${CYAN}${text}${R}`;\n}\n\nfunction row(cmd: string, desc: string): string {\n  return `  ${GREEN}${cmd.padEnd(32)}${R}${DIM}${desc}${R}`;\n}\n\nfunction sub(text: string): string {\n  return `  ${DIM}${text}${R}`;\n}\n\nexport default class Help extends Command {\n  static override description = \"Show all Vertex CLI commands\";\n\n  async run(): Promise<void> {\n    this.log(`\n  ${BOLD}${PURPLE}▲ Vertex CLI${R} ${DIM}v${VERTEX_VERSION}${R}\n  ${DIM}Your knowledge, structured — from the terminal.${R}\n${heading(\"AUTH\")}\n${row(\"vertex login\", \"Log in (GitHub, Google, or Email)\")}\n${row(\"vertex logout\", \"Log out and clear saved session\")}\n${row(\"vertex whoami\", \"Show logged-in user email\")}\n${heading(\"NOTES\")}\n${row(\"vertex notes\", \"List all notes\")}\n${row(\"vertex new [title]\", \"Create a new note\")}\n${row(\"vertex view <title>\", \"View note as markdown\")}\n${row(\"vertex edit <title>\", \"Edit note in $EDITOR\")}\n${row(\"vertex daily\", \"View or create today's daily note\")}\n${row(\"vertex daily --last\", \"View most recent daily note\")}\n${heading(\"INTERACTIVE MODE\")}\n${row(\"vertex today\", \"Latest daily note → interactive\")}\n${row(\"vertex interactive <title>\", \"Open any note → interactive\")}\n\n  ${DIM}┌──────────┬────────────────────────────────────────────┐${R}\n  ${DIM}│${R} ${YELLOW}↑ ↓${R}      ${DIM}│${R} Move cursor between items                  ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}Enter${R}    ${DIM}│${R} Toggle todo ${DIM}[ ] → [✓] → [ ]${R}               ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}t${R}        ${DIM}│${R} Add new todo                               ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}n${R}        ${DIM}│${R} Add new text line                          ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}d${R}        ${DIM}│${R} Delete item at cursor                      ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}e${R}        ${DIM}│${R} Open in $EDITOR for full editing            ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}s${R}        ${DIM}│${R} Save changes                               ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}q${R}        ${DIM}│${R} Quit ${DIM}(auto-saves if changed)${R}               ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}Esc${R}      ${DIM}│${R} Cancel input                               ${DIM}│${R}\n  ${DIM}└──────────┴────────────────────────────────────────────┘${R}\n${heading(\"CAPTURE\")}\n${row(\"vertex capture \\\"text\\\"\", \"Quick capture to Inbox note\")}\n${heading(\"SEARCH & ORGANIZE\")}\n${row(\"vertex search <query>\", \"Search notes\")}\n${row(\"vertex tags\", \"List all tags\")}\n\n  ${DIM}Query syntax:  ${PURPLE}keyword${R}${DIM} · ${PURPLE}#tag${R}${DIM} · ${PURPLE}type:todo${R}${DIM} · ${PURPLE}status:open${R}${DIM} · ${PURPLE}status:done${R}\n${heading(\"IMPORT & EXPORT\")}\n${row(\"vertex import <file.md>\", \"Import markdown file as new note\")}\n${row(\"vertex import <file> -t \\\"Title\\\"\", \"Import with custom title\")}\n${row(\"vertex export <title>\", \"Export as markdown to stdout\")}\n${row(\"vertex export <title> --json\", \"Export as JSON\")}\n${row(\"vertex export <title> -o file\", \"Export to file\")}\n${heading(\"TRASH\")}\n${row(\"vertex delete <title>\", \"Soft delete → trash\")}\n${row(\"vertex restore <title>\", \"Restore from trash\")}\n${row(\"vertex trash\", \"List trashed notes\")}\n${row(\"vertex trash:empty\", \"Permanently delete all trash\")}\n${heading(\"INFO\")}\n${row(\"vertex status\", \"Storage usage, note count, version\")}\n${row(\"vertex hello\", \"Verify CLI is working\")}\n${row(\"vertex help\", \"Show this help\")}\n${row(\"vertex syntax\", \"Markdown syntax reference\")}\n${row(\"vertex howto\", \"Complete AI guide — everything to know\")}\n${heading(\"EDITOR SYNTAX\")}\n${sub(\"for use with: vertex edit <title>\")}\n\n  ${DIM}┌────────────────────────┬────────────────────────────────┐${R}\n  ${DIM}│${R} ${YELLOW}# ## ###${R}               ${DIM}│${R} Headings                       ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}**bold** *italic*${R}       ${DIM}│${R} Formatting                     ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}\\`code\\` ~~strike~~${R}       ${DIM}│${R} Inline code & strikethrough    ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}[[Link]] #tag${R}           ${DIM}│${R} Wiki links & tags              ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}- item${R}  ${YELLOW}1. item${R}        ${DIM}│${R} Bullet & numbered lists        ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}- [x]${R}   ${YELLOW}- [ ]${R}          ${DIM}│${R} Done & open tasks              ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}> quote${R}  ${YELLOW}---${R}            ${DIM}│${R} Blockquote & divider           ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}\\`\\`\\`lang ... \\`\\`\\`${R}         ${DIM}│${R} Code block                     ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}\\`\\`\\`mermaid ... \\`\\`\\`${R}      ${DIM}│${R} Mermaid diagram                ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}$$ ... $$${R}               ${DIM}│${R} Math block (LaTeX)             ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}> [!info] > text${R}        ${DIM}│${R} Callout (info/warning/error/tip)${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}> [!query] > query${R}      ${DIM}│${R} Live query block               ${DIM}│${R}\n  ${DIM}│${R} ${YELLOW}![alt](url)${R}             ${DIM}│${R} Image                          ${DIM}│${R}\n  ${DIM}└────────────────────────┴────────────────────────────────┘${R}\n  ${DIM}All block types work in CLI edit, export, and import${R}\n${heading(\"TIPS\")}\n  ${DIM}•${R} Title args use partial matching ${DIM}(\"proj\" → \"Project Plan\")${R}\n  ${DIM}•${R} Set ${YELLOW}EDITOR=nano${R} or ${YELLOW}EDITOR=\"code --wait\"${R} for preferred editor\n  ${DIM}•${R} Session stored in ${DIM}~/.vertex/config.json${R}\n  ${DIM}•${R} New users get 50 MB storage, upgradeable per account\n  ${DIM}•${R} ${GREEN}vertex today${R} is the fastest way to manage daily todos\n${heading(\"EXAMPLES\")}\n  ${DIM}$${R} vertex today\n  ${DIM}$${R} vertex capture \"buy groceries\"\n  ${DIM}$${R} vertex search \"#work type:todo status:open\"\n  ${DIM}$${R} vertex export \"Meeting Notes\" -o meeting.md\n  ${DIM}$${R} EDITOR=nano vertex edit \"Ideas\"\n`);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/commands/howto.js

@@ -0,0 +1,373 @@
+// 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}  MATH (LaTeX via KaTeX)${R}
+${Y}  $$${R}
+${Y}  E = mc^2${R}
+${Y}  $$${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