mdpockla 0.2.0 → 0.3.0

package/README.md

@@ -48,6 +48,11 @@ mdpockla note version restore "$URL" 3
 mdpockla note edit "$URL" --content ./CHANGELOG.md --save-version --label "Release $TAG"
 ```
 
+`--save-version` applies the edit and snapshots the result as a new
+version in a single request. If the note has no versions yet, the
+pre-edit content is also captured as a baseline so the original stays
+recoverable.
+
 ### Commands
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdpockla",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "CLI for md.pockla.com - save and edit markdown notes from your shell or CI. Pairs with the md pockla MCP server for agent-native sharing.",
   "type": "module",
   "bin": {

package/src/commands/note.mjs

@@ -65,24 +65,16 @@ export async function noteEdit(argv) {
   if (Object.keys(body).length === 0) {
     throw exit("Nothing to update — pass at least one of --content, --title, --visibility, --tag");
   }
+  // --save-version is handled server-side in one PATCH: the edit is
+  // applied and the result is snapshotted as a new version (plus a
+  // baseline of the pre-edit content when the note has no versions yet).
+  if (args["save-version"]) {
+    body.save_as_version = true;
+    if (args.label != null) body.version_label = args.label;
+  }
   const note = await api("PATCH", `/api/v1/notes/${encodeURIComponent(target)}`, {
     body,
   });
-  if (args["save-version"]) {
-    try {
-      await api(
-        "POST",
-        `/api/v1/notes/${encodeURIComponent(target)}/versions`,
-        { body: { label: args.label ?? null } }
-      );
-    } catch (err) {
-      // Snapshot failed but the edit landed — surface the warning but
-      // exit 0 so the user can see the share URL.
-      process.stderr.write(
-        `warning: --save-version failed: ${err.message ?? err}\n`
-      );
-    }
-  }
   if (args.json) process.stdout.write(JSON.stringify(note, null, 2) + "\n");
   else process.stdout.write(note.url + "\n");
 }

package/src/index.mjs

@@ -1,3 +1,4 @@
+import { readFileSync } from "node:fs";
 import { login, logout, whoami } from "./commands/auth.mjs";
 import {
   noteCreate,
@@ -15,6 +16,12 @@ import {
   noteVersionDelete,
 } from "./commands/note.mjs";
 
+// Single source of truth for the version — read from package.json so
+// `--version` can never drift from the published package again.
+const VERSION = JSON.parse(
+  readFileSync(new URL("../package.json", import.meta.url), "utf8")
+).version;
+
 const HELP = `mdpockla — md.pockla.com from your shell.
 
 Authentication
@@ -34,7 +41,8 @@ Notes
     --title <s>                       Set title.
     --visibility <public|private>     Change visibility.
     --tag <name> ...                  Replace tag set.
-    --save-version                    Snapshot the head after the edit.
+    --save-version                    Save the edit as a new version
+                                      (baselines the original first).
     --label <s>                       Label for the new version.
 
   mdpockla note get <id|url>          Fetch a note.
@@ -72,7 +80,7 @@ export async function run(argv) {
     return;
   }
   if (argv[0] === "--version" || argv[0] === "-V") {
-    process.stdout.write("0.1.0\n");
+    process.stdout.write(VERSION + "\n");
     return;
   }
   const [cmd, ...rest] = argv;