@creator-notes/cnotes 0.25.1 → 0.25.2

package/skills/cnotes/SKILL.md

@@ -284,13 +284,31 @@ cnotes canvas from-template <templateId> --populate               # Auto-populat
 
 # Agent-run bracketing — group a sequence of canvas changes into one operation
 # with before/after snapshots so the user can see "AI did X" and revert as a unit.
-# REQUIRED when an AI agent modifies a canvas. See "Agent-Run Bracketing" below.
+# REQUIRED when an AI agent modifies a canvas. Notes directly below the block.
 cnotes canvas agent-run wrap  --canvas <id> --prompt "<intent>" -- <command>   # one-shot
 cnotes canvas agent-run begin --canvas <id> --prompt "<intent>" [--rationale "<plan>"]  # multi-step
-cnotes canvas agent-run end   --canvas <id>
+cnotes canvas agent-run end   --canvas <id>   # no --run-id needed; ends the active run
 cnotes canvas activity <canvasId>   # inspect operations + attribution after the fact
 ```
 
+`begin` persists the run as the active run for this server (the same pointer
+`cnotes operations begin` uses), so **every subsequent cnotes write attaches to
+it automatically** — across separate shells and stateless tool calls, with no
+env var to thread through. `end` closes that active run, so it needs no
+`--run-id`. Only one run can be open at a time: a second `begin` refuses with
+exit 5 (CONFLICT) rather than silently clobbering the first — pass `--force` to
+end the prior run server-side and start fresh.
+
+Prefer `wrap` for a single command (it auto-closes even on failure, and its run
+is scoped to the subprocess, so it nests correctly inside an open `operations`
+run). Use `begin`/`end` when the batch spans several commands.
+
+**Always close the run.** If you can't, a later `begin --force` ends the stale
+one and starts clean. Verify attribution with `cnotes canvas activity <id>`:
+writes made inside a run show `operationType: agent.run` / `actorSource: agent`.
+If you see `manual.edit` / `actorSource: human`, the bracket did not take and
+the timeline is crediting your edits to the user.
+
 ### Timeline (`cnotes timeline` / `cnotes tl`)
 ```bash
 # Show recent changes (default: last 7 days)