pnote 0.2.0 → 0.3.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 
 // src/lib/errors.ts
 import pc from "picocolors";
@@ -455,7 +455,7 @@ authCommand.command("logout").description("Remove stored credentials").action(lo
 authCommand.command("whoami").description("Show current authenticated user").action(whoamiAction);
 
 // src/commands/notes/index.ts
-import { Command as Command2 } from "commander";
+import { Command as Command3 } from "commander";
 
 // src/lib/output.ts
 import pc6 from "picocolors";
@@ -554,9 +554,10 @@ function outputNotes(notes, ctx) {
     }
   }
 }
-function outputNote(note, snippet, ctx) {
+function outputNote(note, snippets, ctx) {
+  const latestSnippet = snippets.length > 0 ? snippets[snippets.length - 1] : null;
   if (ctx.json) {
-    outputJson({ ...note, latest_snippet: snippet });
+    outputJson({ ...note, snippets, latest_snippet: latestSnippet });
     return;
   }
   const c = getColors(ctx);
@@ -573,21 +574,24 @@ function outputNote(note, snippet, ctx) {
     if (status.length > 0) {
       console.log(c.dim("Status: ") + status.join(", "));
     }
-    if (snippet) {
-      console.log("");
-      console.log(c.dim(`--- Snippet v${snippet.version} ---`));
-      console.log(snippet.content);
-    } else {
+    if (snippets.length === 0) {
       console.log("");
       console.log(c.dim("(no content)"));
+    } else {
+      for (const snippet of snippets) {
+        const header = `v${snippet.version}` + (snippet.favorite ? c.yellow(" \u2605") : "") + c.dim(` (${formatRelativeTime(snippet.created_at)})`);
+        console.log("");
+        console.log(c.dim("--- Snippet ") + c.bold(header) + c.dim(" ---"));
+        console.log(snippet.content);
+      }
     }
   } else {
     console.log(`Title: ${note.title}`);
     console.log(`ID: ${note.id}`);
     console.log(`Tags: ${note.tags.join(", ")}`);
-    if (snippet) {
+    for (const snippet of snippets) {
       console.log("");
-      console.log(snippet.content);
+      console.log(`v${snippet.version}	${snippet.content}`);
     }
   }
 }
@@ -844,13 +848,14 @@ async function listNotesAction(options, ctx) {
 }
 
 // src/commands/notes/get.ts
-async function getNoteAction(id, ctx) {
+async function getNoteAction(id, options, ctx) {
   try {
     const result = await getNote(id, { pin: ctx.pin });
     if (!result) {
       throw new NotFoundError("Note", id);
     }
-    outputNote(result, result.latest_snippet, ctx);
+    const snippets = options.latest ? result.latest_snippet ? [result.latest_snippet] : [] : result.snippets || [];
+    outputNote(result, snippets, ctx);
     if (result.protection_status?.error && !ctx.json) {
       console.error("");
       console.error("Warning: " + result.protection_status.error);
@@ -1001,12 +1006,199 @@ async function updateNoteAction(id, options, ctx) {
   }
 }
 
+// src/commands/notes/snippetCmd.ts
+import { Command as Command2 } from "commander";
+
+// src/commands/snippet/show.ts
+async function showSnippetAction(noteId, options, ctx) {
+  try {
+    if (options.all) {
+      const result = await listSnippets(
+        { note_id: noteId, limit: 100 },
+        { pin: ctx.pin }
+      );
+      outputSnippets(result.snippets, ctx);
+    } else {
+      const result = await getNote(noteId, { pin: ctx.pin });
+      if (result.latest_snippet) {
+        outputSnippet(result.latest_snippet, ctx);
+      } else {
+        if (!ctx.json) {
+          console.error("No snippet content found.");
+        }
+        process.exit(3);
+      }
+    }
+  } catch (error) {
+    handleError(error, ctx.noColor);
+  }
+}
+
+// src/commands/snippet/copy.ts
+import pc8 from "picocolors";
+
+// src/lib/clipboard.ts
+import { default as clipboardy } from "clipboardy";
+async function copyToClipboard(text) {
+  try {
+    await clipboardy.write(text);
+  } catch (error) {
+    if (error instanceof Error && error.message.includes("xsel")) {
+      throw new CLIError(
+        "Clipboard not available. Install xsel or xclip on Linux.",
+        1,
+        "Content will be printed to stdout instead."
+      );
+    }
+    throw new CLIError("Failed to copy to clipboard");
+  }
+}
+
+// src/commands/snippet/copy.ts
+async function copySnippetAction(noteId, options, ctx) {
+  try {
+    let snippet = null;
+    if (options.version) {
+      const versionNum = parseInt(options.version, 10);
+      if (isNaN(versionNum)) {
+        throw new CLIError("Invalid version number");
+      }
+      const result = await listSnippets(
+        { note_id: noteId, limit: 100 },
+        { pin: ctx.pin }
+      );
+      snippet = result.snippets.find((s) => s.version === versionNum) || null;
+      if (!snippet) {
+        throw new CLIError(`Version ${versionNum} not found`);
+      }
+    } else {
+      const result = await getNote(noteId, { pin: ctx.pin });
+      snippet = result.latest_snippet;
+    }
+    if (!snippet) {
+      throw new CLIError("No snippet content found");
+    }
+    try {
+      await copyToClipboard(snippet.content);
+      logStatus("Copied to clipboard");
+      if (ctx.json) {
+        console.log(JSON.stringify({ copied: true, content: snippet.content }));
+      }
+    } catch (clipboardError) {
+      if (!ctx.json) {
+        console.error(pc8.yellow("Clipboard not available, printing to stdout:"));
+        console.error("");
+      }
+      console.log(snippet.content);
+    }
+  } catch (error) {
+    handleError(error, ctx.noColor);
+  }
+}
+
+// src/commands/snippet/add.ts
+async function addSnippetAction(noteId, options, ctx) {
+  try {
+    let content;
+    if (process.stdin.isTTY) {
+      throw new CLIError(
+        "No content provided",
+        1,
+        "Pipe content to this command: echo 'content' | pnote snippet add <note-id>"
+      );
+    }
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+      chunks.push(chunk);
+    }
+    content = Buffer.concat(chunks).toString("utf-8");
+    if (content.endsWith("\n")) {
+      content = content.slice(0, -1);
+    }
+    if (!content) {
+      throw new CLIError("Empty content provided");
+    }
+    const result = await createSnippet(
+      {
+        note_id: noteId,
+        content,
+        title: options.title
+      },
+      { pin: ctx.pin }
+    );
+    if (ctx.json) {
+      outputJson(result);
+    } else {
+      outputMessage(`Created snippet v${result.snippet.version}`, ctx);
+    }
+  } catch (error) {
+    handleError(error, ctx.noColor);
+  }
+}
+
+// src/commands/snippet/update.ts
+async function updateSnippetAction(snippetId, options, ctx) {
+  try {
+    let content;
+    if (!process.stdin.isTTY) {
+      const chunks = [];
+      for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+      }
+      content = Buffer.concat(chunks).toString("utf-8");
+      if (content.endsWith("\n")) {
+        content = content.slice(0, -1);
+      }
+      if (!content) {
+        content = void 0;
+      }
+    }
+    if (!content && !options.title) {
+      throw new CLIError(
+        "No content or title provided",
+        1,
+        "Pipe content to this command: echo 'content' | pnote snippet update <snippet-id>"
+      );
+    }
+    const data = {};
+    if (content) data.content = content;
+    if (options.title) data.title = options.title;
+    const result = await updateSnippet(
+      snippetId,
+      data,
+      { pin: ctx.pin }
+    );
+    if (ctx.json) {
+      outputJson(result);
+    } else {
+      outputMessage("Updated snippet", ctx);
+    }
+  } catch (error) {
+    handleError(error, ctx.noColor);
+  }
+}
+
+// src/commands/snippet/favorite.ts
+async function favoriteSnippetAction(snippetId, ctx) {
+  try {
+    const result = await toggleFavorite(snippetId, { pin: ctx.pin });
+    if (ctx.json) {
+      outputJson(result);
+    } else {
+      const status = result.snippet.favorite ? "favorited" : "unfavorited";
+      outputMessage(`Snippet ${status}`, ctx);
+    }
+  } catch (error) {
+    handleError(error, ctx.noColor);
+  }
+}
+
 // src/lib/pin.ts
 import { createInterface as createInterface2 } from "readline";
 import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2, unlinkSync as unlinkSync2, statSync } from "fs";
 import { tmpdir } from "os";
 import { join as join2 } from "path";
-import pc8 from "picocolors";
+import pc9 from "picocolors";
 var PIN_CACHE_TTL_MS = 5 * 60 * 1e3;
 var PIN_MAX_ATTEMPTS = 3;
 function getPinCachePath() {
@@ -1059,12 +1251,12 @@ async function promptForPin(noteTitle, hint, maxAttempts = PIN_MAX_ATTEMPTS) {
     return null;
   }
   if (noteTitle) {
-    console.error(pc8.yellow("\u{1F512}") + ` Note "${noteTitle}" is PIN-protected.`);
+    console.error(pc9.yellow("\u{1F512}") + ` Note "${noteTitle}" is PIN-protected.`);
   } else {
-    console.error(pc8.yellow("\u{1F512}") + " This action requires your PIN.");
+    console.error(pc9.yellow("\u{1F512}") + " This action requires your PIN.");
   }
   if (hint) {
-    console.error(pc8.dim(`Hint: ${hint}`));
+    console.error(pc9.dim(`Hint: ${hint}`));
   }
   for (let attempt = 1; attempt <= maxAttempts; attempt++) {
     const pin = await readPinHidden(
@@ -1074,10 +1266,10 @@ async function promptForPin(noteTitle, hint, maxAttempts = PIN_MAX_ATTEMPTS) {
       return pin;
     }
     if (attempt < maxAttempts) {
-      console.error(pc8.red("Invalid or empty PIN. Try again."));
+      console.error(pc9.red("Invalid or empty PIN. Try again."));
     }
   }
-  console.error(pc8.red("Too many attempts."));
+  console.error(pc9.red("Too many attempts."));
   return null;
 }
 async function readPinHidden(prompt) {
@@ -1154,8 +1346,71 @@ async function resolvePin(options) {
   return null;
 }
 
-// src/commands/notes/index.ts
+// src/commands/notes/snippetCmd.ts
 async function buildContext(globalOpts) {
+  const pin = await resolvePin({
+    pinArg: globalOpts.pin,
+    pinFromStdin: globalOpts.pinStdin,
+    skipPrompt: true
+  });
+  return {
+    json: globalOpts.json ?? false,
+    noColor: globalOpts.noColor ?? false,
+    plain: globalOpts.plain ?? false,
+    pin: pin ?? void 0
+  };
+}
+var notesSnippetCommand = new Command2("snippet").description("Read and manage snippets for a note").argument("[note-id]", "Note ID to show latest snippet for").action(async (noteId, _options, cmd) => {
+  const globalOpts = cmd.parent?.parent?.opts() || {};
+  const ctx = await buildContext(globalOpts);
+  if (noteId) {
+    await showSnippetAction(noteId, {}, ctx);
+  } else {
+    cmd.help();
+  }
+}).addHelpText(
+  "after",
+  `
+Examples:
+  $ pnote notes snippet abc123              Show latest snippet (pipe-friendly)
+  $ pnote notes snippet list abc123         Show all versions
+  $ pnote notes snippet copy abc123         Copy to clipboard
+  $ cat file.txt | pnote notes snippet add abc123
+`
+);
+notesSnippetCommand.command("list").description("List all snippet versions for a note").argument("<note-id>", "Note ID").action(async (noteId, _options, cmd) => {
+  const globalOpts = cmd.parent?.parent?.parent?.opts() || {};
+  const ctx = await buildContext(globalOpts);
+  try {
+    const result = await getNote(noteId, { pin: ctx.pin });
+    outputSnippets(result.snippets || [], ctx);
+  } catch (error) {
+    handleError(error, ctx.noColor);
+  }
+});
+notesSnippetCommand.command("copy").description("Copy snippet content to clipboard").argument("<note-id>", "Note ID").option("--version <n>", "Specific version number").action(async (noteId, options, cmd) => {
+  const globalOpts = cmd.parent?.parent?.parent?.opts() || {};
+  const ctx = await buildContext(globalOpts);
+  await copySnippetAction(noteId, options, ctx);
+});
+notesSnippetCommand.command("add").description("Add a new snippet version (from stdin)").argument("<note-id>", "Note ID").option("--title <title>", "Snippet title").action(async (noteId, options, cmd) => {
+  const globalOpts = cmd.parent?.parent?.parent?.opts() || {};
+  const ctx = await buildContext(globalOpts);
+  await addSnippetAction(noteId, options, ctx);
+});
+notesSnippetCommand.command("update").description("Update an existing snippet (from stdin)").argument("<snippet-id>", "Snippet ID").option("--title <title>", "New snippet title").action(async (snippetId, options, cmd) => {
+  const globalOpts = cmd.parent?.parent?.parent?.opts() || {};
+  const ctx = await buildContext(globalOpts);
+  await updateSnippetAction(snippetId, options, ctx);
+});
+notesSnippetCommand.command("favorite").description("Toggle favorite status on a snippet").argument("<snippet-id>", "Snippet ID").action(async (snippetId, _options, cmd) => {
+  const globalOpts = cmd.parent?.parent?.parent?.opts() || {};
+  const ctx = await buildContext(globalOpts);
+  await favoriteSnippetAction(snippetId, ctx);
+});
+
+// src/commands/notes/index.ts
+async function buildContext2(globalOpts) {
   const pin = await resolvePin({
     pinArg: globalOpts.pin,
     pinFromStdin: globalOpts.pinStdin,
@@ -1169,243 +1424,61 @@ async function buildContext(globalOpts) {
     pin: pin ?? void 0
   };
 }
-var notesCommand = new Command2("notes").description("List and manage notes").option("--tag <tag>", 'Filter by tag (e.g., "AI/art")').option("--archived", "Show archived notes").option("--pinned", "Show only pinned notes").option("--deleted", "Show deleted notes").option("--search <query>", "Search notes by title").option("--limit <n>", "Limit number of results", "50").action(async (options, cmd) => {
+var notesCommand = new Command3("notes").description("List and manage notes").option("--tag <tag>", 'Filter by tag (e.g., "AI/art")').option("--archived", "Show archived notes").option("--pinned", "Show only pinned notes").option("--deleted", "Show deleted notes").option("--search <query>", "Search notes by title").option("--limit <n>", "Limit number of results", "50").action(async (options, cmd) => {
   const globalOpts = cmd.parent?.opts() || {};
-  const ctx = await buildContext(globalOpts);
+  const ctx = await buildContext2(globalOpts);
   await listNotesAction(options, ctx);
 }).addHelpText(
   "after",
   `
 Examples:
-  $ pnote notes                    List all active notes
-  $ pnote notes --tag "AI/art"     Filter by tag
-  $ pnote notes --archived         Show archived notes
-  $ pnote notes --pinned           Show only pinned notes
-  $ pnote notes get abc123         Get note details
-  $ pnote notes create "My Note"   Create a new note
-  $ pnote notes update abc123 --title "New Title"
+  $ pnote notes                              List all active notes
+  $ pnote notes --tag "AI/art"              Filter by tag
+  $ pnote notes --archived                   Show archived notes
+  $ pnote notes --pinned                     Show only pinned notes
+  $ pnote notes get abc123                   Get note with all snippet versions
+  $ pnote notes get abc123 --latest          Get note with only latest snippet
+  $ pnote notes create "My Note"             Create a new note
+  $ pnote notes snippet abc123              Show latest snippet (pipe-friendly)
+  $ pnote notes snippet list abc123         Show all snippet versions
+  $ cat file.txt | pnote notes snippet add abc123
 `
 );
-notesCommand.command("get").description("Get a note with its latest snippet").argument("<id>", "Note ID").action(async (id, _options, cmd) => {
+notesCommand.command("get").description("Get a note with all its snippet versions").argument("<id>", "Note ID").option("--latest", "Show only the latest snippet version").action(async (id, options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
-  const ctx = await buildContext(globalOpts);
-  await getNoteAction(id, ctx);
+  const ctx = await buildContext2(globalOpts);
+  await getNoteAction(id, options, ctx);
 });
 notesCommand.command("create").description("Create a new note").argument("<title>", "Note title").option("--tags <tags...>", "Tags for the note").option("--content <content>", "Initial snippet content").action(async (title, options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
-  const ctx = await buildContext(globalOpts);
+  const ctx = await buildContext2(globalOpts);
   await createNoteAction(title, options, ctx);
 });
 notesCommand.command("archive").description("Archive or unarchive a note").argument("<id>", "Note ID").option("--undo", "Unarchive the note").action(async (id, options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
-  const ctx = await buildContext(globalOpts);
+  const ctx = await buildContext2(globalOpts);
   await archiveNoteAction(id, options, ctx);
 });
 notesCommand.command("pin").description("Pin or unpin a note").argument("<id>", "Note ID").action(async (id, _options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
-  const ctx = await buildContext(globalOpts);
+  const ctx = await buildContext2(globalOpts);
   await pinNoteAction(id, ctx);
 });
 notesCommand.command("update").description("Update a note title or tags").argument("<id>", "Note ID").option("--title <title>", "New title").option("--tags <tags...>", "New tags (replaces existing)").action(async (id, options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
-  const ctx = await buildContext(globalOpts);
+  const ctx = await buildContext2(globalOpts);
   await updateNoteAction(id, options, ctx);
 });
 notesCommand.command("delete").description("Delete a note (soft delete)").argument("<id>", "Note ID").option("--force", "Skip confirmation").action(async (id, options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
-  const ctx = await buildContext(globalOpts);
+  const ctx = await buildContext2(globalOpts);
   await deleteNoteAction(id, options, ctx);
 });
+notesCommand.addCommand(notesSnippetCommand);
 
 // src/commands/snippet/index.ts
-import { Command as Command3 } from "commander";
-
-// src/commands/snippet/show.ts
-async function showSnippetAction(noteId, options, ctx) {
-  try {
-    if (options.all) {
-      const result = await listSnippets(
-        { note_id: noteId, limit: 100 },
-        { pin: ctx.pin }
-      );
-      outputSnippets(result.snippets, ctx);
-    } else {
-      const result = await getNote(noteId, { pin: ctx.pin });
-      if (result.latest_snippet) {
-        outputSnippet(result.latest_snippet, ctx);
-      } else {
-        if (!ctx.json) {
-          console.error("No snippet content found.");
-        }
-        process.exit(3);
-      }
-    }
-  } catch (error) {
-    handleError(error, ctx.noColor);
-  }
-}
-
-// src/commands/snippet/copy.ts
-import pc9 from "picocolors";
-
-// src/lib/clipboard.ts
-import { default as clipboardy } from "clipboardy";
-async function copyToClipboard(text) {
-  try {
-    await clipboardy.write(text);
-  } catch (error) {
-    if (error instanceof Error && error.message.includes("xsel")) {
-      throw new CLIError(
-        "Clipboard not available. Install xsel or xclip on Linux.",
-        1,
-        "Content will be printed to stdout instead."
-      );
-    }
-    throw new CLIError("Failed to copy to clipboard");
-  }
-}
-
-// src/commands/snippet/copy.ts
-async function copySnippetAction(noteId, options, ctx) {
-  try {
-    let snippet = null;
-    if (options.version) {
-      const versionNum = parseInt(options.version, 10);
-      if (isNaN(versionNum)) {
-        throw new CLIError("Invalid version number");
-      }
-      const result = await listSnippets(
-        { note_id: noteId, limit: 100 },
-        { pin: ctx.pin }
-      );
-      snippet = result.snippets.find((s) => s.version === versionNum) || null;
-      if (!snippet) {
-        throw new CLIError(`Version ${versionNum} not found`);
-      }
-    } else {
-      const result = await getNote(noteId, { pin: ctx.pin });
-      snippet = result.latest_snippet;
-    }
-    if (!snippet) {
-      throw new CLIError("No snippet content found");
-    }
-    try {
-      await copyToClipboard(snippet.content);
-      logStatus("Copied to clipboard");
-      if (ctx.json) {
-        console.log(JSON.stringify({ copied: true, content: snippet.content }));
-      }
-    } catch (clipboardError) {
-      if (!ctx.json) {
-        console.error(pc9.yellow("Clipboard not available, printing to stdout:"));
-        console.error("");
-      }
-      console.log(snippet.content);
-    }
-  } catch (error) {
-    handleError(error, ctx.noColor);
-  }
-}
-
-// src/commands/snippet/add.ts
-async function addSnippetAction(noteId, options, ctx) {
-  try {
-    let content;
-    if (process.stdin.isTTY) {
-      throw new CLIError(
-        "No content provided",
-        1,
-        "Pipe content to this command: echo 'content' | pnote snippet add <note-id>"
-      );
-    }
-    const chunks = [];
-    for await (const chunk of process.stdin) {
-      chunks.push(chunk);
-    }
-    content = Buffer.concat(chunks).toString("utf-8");
-    if (content.endsWith("\n")) {
-      content = content.slice(0, -1);
-    }
-    if (!content) {
-      throw new CLIError("Empty content provided");
-    }
-    const result = await createSnippet(
-      {
-        note_id: noteId,
-        content,
-        title: options.title
-      },
-      { pin: ctx.pin }
-    );
-    if (ctx.json) {
-      outputJson(result);
-    } else {
-      outputMessage(`Created snippet v${result.snippet.version}`, ctx);
-    }
-  } catch (error) {
-    handleError(error, ctx.noColor);
-  }
-}
-
-// src/commands/snippet/update.ts
-async function updateSnippetAction(snippetId, options, ctx) {
-  try {
-    let content;
-    if (!process.stdin.isTTY) {
-      const chunks = [];
-      for await (const chunk of process.stdin) {
-        chunks.push(chunk);
-      }
-      content = Buffer.concat(chunks).toString("utf-8");
-      if (content.endsWith("\n")) {
-        content = content.slice(0, -1);
-      }
-      if (!content) {
-        content = void 0;
-      }
-    }
-    if (!content && !options.title) {
-      throw new CLIError(
-        "No content or title provided",
-        1,
-        "Pipe content to this command: echo 'content' | pnote snippet update <snippet-id>"
-      );
-    }
-    const data = {};
-    if (content) data.content = content;
-    if (options.title) data.title = options.title;
-    const result = await updateSnippet(
-      snippetId,
-      data,
-      { pin: ctx.pin }
-    );
-    if (ctx.json) {
-      outputJson(result);
-    } else {
-      outputMessage("Updated snippet", ctx);
-    }
-  } catch (error) {
-    handleError(error, ctx.noColor);
-  }
-}
-
-// src/commands/snippet/favorite.ts
-async function favoriteSnippetAction(snippetId, ctx) {
-  try {
-    const result = await toggleFavorite(snippetId, { pin: ctx.pin });
-    if (ctx.json) {
-      outputJson(result);
-    } else {
-      const status = result.snippet.favorite ? "favorited" : "unfavorited";
-      outputMessage(`Snippet ${status}`, ctx);
-    }
-  } catch (error) {
-    handleError(error, ctx.noColor);
-  }
-}
-
-// src/commands/snippet/index.ts
-async function buildContext2(globalOpts) {
+import { Command as Command4 } from "commander";
+async function buildContext3(globalOpts) {
   const pin = await resolvePin({
     pinArg: globalOpts.pin,
     pinFromStdin: globalOpts.pinStdin,
@@ -1418,9 +1491,12 @@ async function buildContext2(globalOpts) {
     pin: pin ?? void 0
   };
 }
-var snippetCommand = new Command3("snippet").description("Read and manage snippets (note versions)").argument("[note-id]", "Note ID to show snippet for").option("--all", "Show all snippet versions").action(async (noteId, options, cmd) => {
+var DEPRECATION_NOTICE = '\nDeprecated: "pnote snippet" is deprecated. Use "pnote notes snippet" instead.\n\n';
+var snippetCommand = new Command4("snippet").description('Read and manage snippets (note versions) [deprecated: use "notes snippet"]').argument("[note-id]", "Note ID to show snippet for").option("--all", "Show all snippet versions").hook("preAction", () => {
+  process.stderr.write(DEPRECATION_NOTICE);
+}).action(async (noteId, options, cmd) => {
   const globalOpts = cmd.parent?.opts() || {};
-  const ctx = await buildContext2(globalOpts);
+  const ctx = await buildContext3(globalOpts);
   if (noteId) {
     await showSnippetAction(noteId, options, ctx);
   } else {
@@ -1438,27 +1514,27 @@ Examples:
 );
 snippetCommand.command("copy").description("Copy snippet content to clipboard").argument("<note-id>", "Note ID").option("--version <n>", "Specific version number").action(async (noteId, options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
-  const ctx = await buildContext2(globalOpts);
+  const ctx = await buildContext3(globalOpts);
   await copySnippetAction(noteId, options, ctx);
 });
 snippetCommand.command("add").description("Add a new snippet version (from stdin)").argument("<note-id>", "Note ID").option("--title <title>", "Snippet title").action(async (noteId, options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
-  const ctx = await buildContext2(globalOpts);
+  const ctx = await buildContext3(globalOpts);
   await addSnippetAction(noteId, options, ctx);
 });
 snippetCommand.command("update").description("Update an existing snippet (from stdin)").argument("<snippet-id>", "Snippet ID").option("--title <title>", "New snippet title").action(async (snippetId, options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
-  const ctx = await buildContext2(globalOpts);
+  const ctx = await buildContext3(globalOpts);
   await updateSnippetAction(snippetId, options, ctx);
 });
 snippetCommand.command("favorite").description("Toggle favorite status on a snippet").argument("<snippet-id>", "Snippet ID").action(async (snippetId, _options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
-  const ctx = await buildContext2(globalOpts);
+  const ctx = await buildContext3(globalOpts);
   await favoriteSnippetAction(snippetId, ctx);
 });
 
 // src/commands/tags/index.ts
-import { Command as Command4 } from "commander";
+import { Command as Command5 } from "commander";
 
 // src/commands/tags/list.ts
 async function listTagsAction(options, ctx) {
@@ -1521,7 +1597,7 @@ async function mergeTagsAction(sourceTags, targetTag, ctx) {
 }
 
 // src/commands/tags/index.ts
-async function buildContext3(globalOpts) {
+async function buildContext4(globalOpts) {
   const pin = await resolvePin({
     pinArg: globalOpts.pin,
     pinFromStdin: globalOpts.pinStdin,
@@ -1534,9 +1610,9 @@ async function buildContext3(globalOpts) {
     pin: pin ?? void 0
   };
 }
-var tagsCommand = new Command4("tags").description("List and manage tags").option("--include-archived", "Include tags from archived notes").action(async (options, cmd) => {
+var tagsCommand = new Command5("tags").description("List and manage tags").option("--include-archived", "Include tags from archived notes").action(async (options, cmd) => {
   const globalOpts = cmd.parent?.opts() || {};
-  const ctx = await buildContext3(globalOpts);
+  const ctx = await buildContext4(globalOpts);
   await listTagsAction(options, ctx);
 }).addHelpText(
   "after",
@@ -1549,17 +1625,17 @@ Examples:
 );
 tagsCommand.command("rename").description("Rename a tag across all notes").argument("<old-tag>", "Current tag name").argument("<new-tag>", "New tag name").action(async (oldTag, newTag, _options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
-  const ctx = await buildContext3(globalOpts);
+  const ctx = await buildContext4(globalOpts);
   await renameTagAction(oldTag, newTag, ctx);
 });
 tagsCommand.command("merge").description("Merge multiple tags into one").argument("<source-tags...>", "Tags to merge (space-separated)").requiredOption("--into <target>", "Target tag to merge into").action(async (sourceTags, options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
-  const ctx = await buildContext3(globalOpts);
+  const ctx = await buildContext4(globalOpts);
   await mergeTagsAction(sourceTags, options.into, ctx);
 });
 
 // src/commands/search.ts
-import { Command as Command5 } from "commander";
+import { Command as Command6 } from "commander";
 async function searchAction(query, options, ctx) {
   try {
     let search_notes = true;
@@ -1585,7 +1661,7 @@ async function searchAction(query, options, ctx) {
     handleError(error, ctx.noColor);
   }
 }
-var searchCommand = new Command5("search").description("Search notes and snippets").argument("<query>", "Search query").option("--notes-only", "Only search note titles and tags").option("--snippets-only", "Only search snippet content").option("--limit <n>", "Limit results", "20").action(async (query, options, cmd) => {
+var searchCommand = new Command6("search").description("Search notes and snippets").argument("<query>", "Search query").option("--notes-only", "Only search note titles and tags").option("--snippets-only", "Only search snippet content").option("--limit <n>", "Limit results", "20").action(async (query, options, cmd) => {
   const globalOpts = cmd.parent?.opts() || {};
   const pin = await resolvePin({
     pinArg: globalOpts.pin,
@@ -1610,7 +1686,7 @@ Examples:
 );
 
 // src/commands/share/index.ts
-import { Command as Command6 } from "commander";
+import { Command as Command7 } from "commander";
 
 // src/commands/share/tags.ts
 async function listSharedTagsAction(ctx) {
@@ -1648,7 +1724,7 @@ async function listSharedNotesAction(options, ctx) {
 }
 
 // src/commands/share/index.ts
-async function buildContext4(globalOpts) {
+async function buildContext5(globalOpts) {
   const pin = await resolvePin({
     pinArg: globalOpts.pin,
     pinFromStdin: globalOpts.pinStdin,
@@ -1661,7 +1737,7 @@ async function buildContext4(globalOpts) {
     pin: pin ?? void 0
   };
 }
-var shareCommand = new Command6("share").description("View shared tags and shared note links").addHelpText(
+var shareCommand = new Command7("share").description("View shared tags and shared note links").addHelpText(
   "after",
   `
 Examples:
@@ -1673,7 +1749,7 @@ Examples:
 );
 shareCommand.command("tags").description("List shared tags or view notes in a shared tag").argument("[id]", "Shared tag ID to view notes").option("--limit <n>", "Limit notes returned").action(async (id, options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
-  const ctx = await buildContext4(globalOpts);
+  const ctx = await buildContext5(globalOpts);
   if (id) {
     await getSharedTagNotesAction(id, options, ctx);
   } else {
@@ -1682,12 +1758,12 @@ shareCommand.command("tags").description("List shared tags or view notes in a sh
 });
 shareCommand.command("notes").description("List public share links for your notes").option("--include-revoked", "Include revoked share links").action(async (options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
-  const ctx = await buildContext4(globalOpts);
+  const ctx = await buildContext5(globalOpts);
   await listSharedNotesAction(options, ctx);
 });
 
 // src/commands/skills/index.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 
 // src/commands/skills/list.ts
 import pc10 from "picocolors";
@@ -1886,7 +1962,7 @@ function collectFiles(baseDir, currentDir) {
 }
 
 // src/commands/skills/index.ts
-async function buildContext5(globalOpts) {
+async function buildContext6(globalOpts) {
   const pin = await resolvePin({
     pinArg: globalOpts.pin,
     pinFromStdin: globalOpts.pinStdin,
@@ -1899,9 +1975,9 @@ async function buildContext5(globalOpts) {
     pin: pin ?? void 0
   };
 }
-var skillsCommand = new Command7("skills").description("Manage agent skills (sync between cloud and local)").action(async (_options, cmd) => {
+var skillsCommand = new Command8("skills").description("Manage agent skills (sync between cloud and local)").action(async (_options, cmd) => {
   const globalOpts = cmd.parent?.opts() || {};
-  const ctx = await buildContext5(globalOpts);
+  const ctx = await buildContext6(globalOpts);
   await listSkillsAction(ctx);
 }).addHelpText(
   "after",
@@ -1918,18 +1994,117 @@ They sync to ~/.claude/skills/<skill-name>/<filename> for use with Claude Code.
 );
 skillsCommand.command("pull").description("Download skills from cloud to local (~/.claude/skills/)").argument("[skill-name]", "Specific skill to pull (pulls all if omitted)").option("--dir <path>", "Custom output directory (default: ~/.claude/skills)").option("--dry-run", "Show what would be downloaded without writing files").action(async (skillName, options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
-  const ctx = await buildContext5(globalOpts);
+  const ctx = await buildContext6(globalOpts);
   await pullSkillsAction(skillName, options, ctx);
 });
 skillsCommand.command("push").description("Upload a local skill directory to cloud").argument("<dir>", "Path to skill directory (must contain SKILL.md)").option("--name <name>", "Override skill name (default: directory name)").action(async (dir, options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
-  const ctx = await buildContext5(globalOpts);
+  const ctx = await buildContext6(globalOpts);
   await pushSkillsAction(dir, options, ctx);
 });
 
+// src/lib/update-check.ts
+import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync4, mkdirSync as mkdirSync3 } from "fs";
+import { join as join5 } from "path";
+import pc13 from "picocolors";
+var CACHE_FILE = "update-check.json";
+var CHECK_INTERVAL = 60 * 60 * 1e3;
+var FETCH_TIMEOUT = 2e3;
+function getCachePath() {
+  return join5(getConfigDir(), CACHE_FILE);
+}
+function readCache() {
+  try {
+    const path3 = getCachePath();
+    if (!existsSync4(path3)) return null;
+    return JSON.parse(readFileSync4(path3, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function writeCache(cache) {
+  try {
+    const dir = getConfigDir();
+    if (!existsSync4(dir)) {
+      mkdirSync3(dir, { recursive: true, mode: 448 });
+    }
+    writeFileSync4(getCachePath(), JSON.stringify(cache), "utf-8");
+  } catch {
+  }
+}
+async function fetchLatestVersion(packageName) {
+  try {
+    const res = await fetch(
+      `https://registry.npmjs.org/${packageName}/latest`,
+      { signal: AbortSignal.timeout(FETCH_TIMEOUT) }
+    );
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data.version ?? null;
+  } catch {
+    return null;
+  }
+}
+function isOlderVersion(current, latest) {
+  const parse = (v) => v.split(".").map(Number);
+  const [cMaj, cMin, cPat] = parse(current);
+  const [lMaj, lMin, lPat] = parse(latest);
+  if (cMaj !== lMaj) return cMaj < lMaj;
+  if (cMin !== lMin) return cMin < lMin;
+  return cPat < lPat;
+}
+function printNotice(current, latest, packageName) {
+  const useColor = process.stderr.isTTY && !process.env.NO_COLOR && process.env.TERM !== "dumb";
+  const yellow = useColor ? pc13.yellow : (s) => s;
+  const bold = useColor ? pc13.bold : (s) => s;
+  const dim = useColor ? pc13.dim : (s) => s;
+  const msg = `Update available: ${dim(current)} \u2192 ${bold(latest)}`;
+  const cmd = `Run ${bold(`npm i -g ${packageName}`)} to update`;
+  const lines = [msg, cmd];
+  const strip = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
+  const maxLen = Math.max(...lines.map((l) => strip(l).length));
+  const pad2 = (s) => s + " ".repeat(maxLen - strip(s).length);
+  const top = yellow("\u250C" + "\u2500".repeat(maxLen + 2) + "\u2510");
+  const bot = yellow("\u2514" + "\u2500".repeat(maxLen + 2) + "\u2518");
+  const row = (s) => yellow("\u2502") + " " + pad2(s) + " " + yellow("\u2502");
+  const box = [
+    "",
+    top,
+    row(lines[0]),
+    row(lines[1]),
+    bot,
+    ""
+  ].join("\n");
+  process.stderr.write(box);
+}
+async function checkAndNotifyUpdate(currentVersion, packageName) {
+  if (!process.stderr.isTTY) return;
+  if (process.env.NO_UPDATE_NOTIFIER) return;
+  if (process.env.CI) return;
+  if (process.env.NODE_ENV === "test") return;
+  try {
+    const cache = readCache();
+    let latestVersion = null;
+    if (cache && Date.now() - cache.lastCheck < CHECK_INTERVAL) {
+      latestVersion = cache.latestVersion;
+    } else {
+      latestVersion = await fetchLatestVersion(packageName);
+      if (latestVersion) {
+        writeCache({ lastCheck: Date.now(), latestVersion });
+      } else if (cache) {
+        latestVersion = cache.latestVersion;
+      }
+    }
+    if (latestVersion && isOlderVersion(currentVersion, latestVersion)) {
+      printNotice(currentVersion, latestVersion, packageName);
+    }
+  } catch {
+  }
+}
+
 // src/index.ts
-var program = new Command8();
-program.name("pnote").description("pnote - The PromptNote CLI").version("0.1.0", "-V, --version", "Show version number").option("--json", "Output as JSON (for scripting)").option("--no-color", "Disable colored output").option("--plain", "Force plain text output (no formatting)").option("-p, --pin <pin>", "PIN for accessing protected notes").option("--pin-stdin", "Read PIN from stdin (first line only)").configureHelp({
+var program = new Command9();
+program.name("pnote").description("pnote - The PromptNote CLI").version("0.3.0", "-V, --version", "Show version number").option("--json", "Output as JSON (for scripting)").option("--no-color", "Disable colored output").option("--plain", "Force plain text output (no formatting)").option("-p, --pin <pin>", "PIN for accessing protected notes").option("--pin-stdin", "Read PIN from stdin (first line only)").configureHelp({
   sortSubcommands: true,
   sortOptions: true
 }).addHelpText(
@@ -1960,6 +2135,9 @@ program.addCommand(tagsCommand);
 program.addCommand(searchCommand);
 program.addCommand(shareCommand);
 program.addCommand(skillsCommand);
+program.hook("preAction", async () => {
+  await checkAndNotifyUpdate("0.3.0", "pnote");
+});
 process.on("SIGINT", () => {
   console.error("\nInterrupted");
   process.exit(130);