@creator-notes/cnotes 0.71.0 → 0.73.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "creator-notes-cli",
-  "version": "0.71.0",
+  "version": "0.73.0",
   "description": "CreatorNotes CLI: create notes, build canvases, search knowledge from the terminal",
   "author": {
     "name": "CreatorNotes",

package/README.md

@@ -36,6 +36,7 @@ cnotes search semantic "onboarding flow"
 | `cnotes versions list\|create` | `cnotes v` | Note version history |
 | `cnotes canvas list\|get\|create\|delete` | `cnotes c` | Manage canvases |
 | `cnotes canvas place` | | Declarative layout — server packs items with no overlap |
+| `cnotes canvas milestone create\|list\|show` | | Save and read canvas milestones (git-style message; attaches to the active operations run) |
 | `cnotes canvas add-node\|add-text\|add-list\|add-link` | | Add a single node at explicit `--x`/`--y` (`add-richtext` is a deprecated alias of `add-text`) |
 | `cnotes canvas bulk-add\|bulk-move` | | Bulk canvas operations — requires explicit coordinates |
 | `cnotes canvas bulk-remove` | | Take nodes/edges off a canvas (the notes themselves are untouched) |
@@ -152,6 +153,13 @@ cnotes canvas read <canvasId>
 # editing, or to confirm a previous agent run actually applied.
 cnotes canvas activity <canvasId> [--limit 50]
 
+# Save a milestone. First line is the headline, the rest is the body.
+# Verb-first wording is guidance, not a check. The message is stored as
+# written. An active operations run is stamped onto the milestone.
+cnotes canvas milestone create <canvasId> --message "Opened pricing question: charge for agents or the workspace?"
+cnotes canvas milestone list <canvasId>
+cnotes canvas milestone show <milestoneId>
+
 # Place items with a declarative layout (preferred — no x/y math)
 cnotes canvas place <canvasId> --spec ./layout.json
 

package/dist/commands/canvas-milestone.d.ts

@@ -0,0 +1,12 @@
+import type { Command } from "commander";
+/**
+ * `cnotes canvas milestone`: save and read the same canvas milestones the
+ * web UI writes (`canvasSnapshots` kind "milestone", via createMilestone).
+ *
+ * The message is one git-style field: first line is the timeline headline,
+ * the rest is the body. Verb-first wording is help text, not a validator.
+ * Writes ride the active operations run through X-Agent-Run-Id, the same
+ * header every other CLI write sends.
+ */
+export declare function registerCanvasMilestoneCommands(canvas: Command, program: Command): void;
+//# sourceMappingURL=canvas-milestone.d.ts.map

package/dist/commands/canvas-milestone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-milestone.d.ts","sourceRoot":"","sources":["../../src/commands/canvas-milestone.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA4KvF"}

package/dist/commands/canvas-milestone.js

@@ -0,0 +1,165 @@
+import { ApiClient } from "../lib/api-client.js";
+import { milestonesCollectionPath, milestoneShowPath } from "../lib/canvas-paths.js";
+import { resolveConfig } from "../lib/config.js";
+import { handleError } from "../lib/errors.js";
+import { readMilestoneMessage } from "../lib/milestone-message.js";
+import { outputJson, outputQuiet, outputTable, timeAgo, truncate } from "../lib/output.js";
+/**
+ * `cnotes canvas milestone`: save and read the same canvas milestones the
+ * web UI writes (`canvasSnapshots` kind "milestone", via createMilestone).
+ *
+ * The message is one git-style field: first line is the timeline headline,
+ * the rest is the body. Verb-first wording is help text, not a validator.
+ * Writes ride the active operations run through X-Agent-Run-Id, the same
+ * header every other CLI write sends.
+ */
+export function registerCanvasMilestoneCommands(canvas, program) {
+    const milestone = canvas
+        .command("milestone")
+        .description("Save and read canvas milestones. A milestone is a named snapshot of the canvas, like a git tag. " +
+        "The message is one field: the first line is the headline shown on the timeline, and the rest is the body. " +
+        "Write the headline verb-first (a meaningful verb, the specific object, and the twist). " +
+        "That shape is guidance, not a check. See https://creatornotes.app/blog/timeline-as-navigation");
+    milestone
+        .command("create")
+        .description("Save a milestone for the canvas's current state. Does nothing when there are no unsaved changes. " +
+        "The message you pass is stored as you wrote it and is not replaced by an AI summary.")
+        .argument("<canvasId>", "Canvas ID or CANVAS-<n> display id")
+        .option("-m, --message <text>", "Checkpoint message. First line is the headline; the rest is the body.")
+        .option("-F, --message-file <path>", "Read the checkpoint message from a file")
+        .addHelpText("after", `
+The headline is a scan-first label, not a summary of the canvas. Lead with a
+verb: "Opened pricing question: charge for agents or the shared workspace?"
+A one-line message is enough. Add a blank line and a body when the reason
+matters later. The command does not reject other wording.
+
+If an operations run is active (cnotes operations begin, or canvas agent-run),
+the save attaches to it and is recorded as that run's actor, not as a human
+edit in the web UI.
+
+Examples:
+  $ cnotes canvas milestone create <canvasId> --message "Opened pricing question: charge for agents or the workspace?"
+  $ cnotes canvas milestone create <canvasId> --message-file ./milestone.txt
+  $ echo "Locked the launch board" | cnotes canvas milestone create <canvasId>
+`)
+        .action(async (canvasId, opts) => {
+        const cfg = resolveConfig(program.opts());
+        const api = new ApiClient(cfg.serverUrl, cfg.token);
+        try {
+            const message = await readMilestoneMessage({
+                message: opts.message,
+                messageFile: opts.messageFile,
+                stdinIsTTY: Boolean(process.stdin.isTTY),
+            });
+            const data = await api.post(milestonesCollectionPath(canvasId, cfg.workspaceId), { description: message.description });
+            if (data.noChanges === true) {
+                if (cfg.json) {
+                    outputJson({ noChanges: true, canvasId });
+                    return;
+                }
+                console.log("No pending canvas changes. Milestone not saved.");
+                return;
+            }
+            if (cfg.quiet) {
+                outputQuiet(String(data.id ?? ""));
+                return;
+            }
+            if (cfg.json) {
+                outputJson(data);
+                return;
+            }
+            console.log(`Saved milestone v${data.snapshotNumber}`);
+            console.log(`  ${data.headline}`);
+            if (typeof data.body === "string" && data.body) {
+                console.log("");
+                for (const line of data.body.split("\n"))
+                    console.log(`  ${line}`);
+            }
+            console.log(`  id: ${data.id}`);
+        }
+        catch (error) {
+            handleError(error, cfg.json);
+        }
+    });
+    milestone
+        .command("list")
+        .description("List milestones for a canvas, newest first. Auto-checkpoints are not included.")
+        .argument("<canvasId>", "Canvas ID or CANVAS-<n> display id")
+        .option("--limit <n>", "Max milestones (default 50, max 200)", "50")
+        .addHelpText("after", `
+Examples:
+  $ cnotes canvas milestone list <canvasId>
+  $ cnotes canvas milestone list <canvasId> --json
+`)
+        .action(async (canvasId, opts) => {
+        const cfg = resolveConfig(program.opts());
+        const api = new ApiClient(cfg.serverUrl, cfg.token);
+        try {
+            const parsed = Number.parseInt(opts.limit ?? "50", 10);
+            const limit = Number.isFinite(parsed) ? parsed : 50;
+            const data = await api.get(milestonesCollectionPath(canvasId, cfg.workspaceId, limit));
+            const rows = data.milestones ?? [];
+            if (cfg.quiet) {
+                outputQuiet(rows.map((row) => String(row.id ?? "")).join("\n"));
+                return;
+            }
+            if (cfg.json) {
+                outputJson(data);
+                return;
+            }
+            if (rows.length === 0) {
+                console.log("No milestones yet.");
+                return;
+            }
+            outputTable(["WHEN", "V", "WHO", "HEADLINE"], rows.map((row) => [
+                timeAgo(row.createdAt),
+                `v${row.snapshotNumber}`,
+                String(row.createdBySource ?? "human"),
+                truncate(String(row.headline ?? "(no description)"), 60),
+            ]));
+        }
+        catch (error) {
+            handleError(error, cfg.json);
+        }
+    });
+    milestone
+        .command("show")
+        .description("Show one milestone, including the full checkpoint message.")
+        .argument("<milestoneId>", "Milestone id (the id printed by milestone create or list)")
+        .addHelpText("after", `
+Examples:
+  $ cnotes canvas milestone show <milestoneId>
+  $ cnotes canvas milestone show <milestoneId> --json
+`)
+        .action(async (milestoneId) => {
+        const cfg = resolveConfig(program.opts());
+        const api = new ApiClient(cfg.serverUrl, cfg.token);
+        try {
+            const data = await api.get(milestoneShowPath(milestoneId, cfg.workspaceId));
+            const row = data.milestone;
+            if (cfg.quiet) {
+                outputQuiet(String(row.id ?? milestoneId));
+                return;
+            }
+            if (cfg.json) {
+                outputJson(data);
+                return;
+            }
+            console.log(`v${row.snapshotNumber} · ${row.createdBySource ?? "human"} · ${timeAgo(row.createdAt)}`);
+            console.log(String(row.headline ?? "(no description)"));
+            if (typeof row.body === "string" && row.body) {
+                console.log("");
+                console.log(row.body);
+            }
+            const counts = `+${row.addedCount ?? 0} added  ~${row.modifiedCount ?? 0} modified  -${row.removedCount ?? 0} removed`;
+            console.log("");
+            console.log(counts);
+            console.log(`id: ${row.id}`);
+            console.log(`canvas: ${row.canvasId}`);
+        }
+        catch (error) {
+            handleError(error, cfg.json);
+        }
+    });
+}
+//# sourceMappingURL=canvas-milestone.js.map

package/dist/commands/canvas-milestone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-milestone.js","sourceRoot":"","sources":["../../src/commands/canvas-milestone.ts"],"names":[],"mappings":"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"}

package/dist/commands/canvas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../src/commands/canvas.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAgK5C,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAixF7D"}
+{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../src/commands/canvas.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAiK5C,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmxF7D"}

package/dist/commands/canvas.js

@@ -12,6 +12,7 @@ import { resolveAgentSession } from "../lib/claude-session.js";
 import { WARN, dim } from "../lib/style.js";
 import { canvasUrl, canvasLinkForRef } from "../lib/urls.js";
 import { canvasActionPath, commentsListPath, parseCommentStatus, } from "../lib/canvas-paths.js";
+import { registerCanvasMilestoneCommands } from "./canvas-milestone.js";
 /**
  * A list item is a *collection of member notes* with a short markdown description
  * that frames them — not a place to dump prose. When a description carries several
@@ -435,6 +436,7 @@ Examples:
             handleError(error, cfg.json);
         }
     });
+    registerCanvasMilestoneCommands(canvas, program);
     canvas
         .command("read")
         .description("Read every note on a canvas as one concatenated markdown document, " +