@creator-notes/cnotes 0.57.0 → 0.57.1

package/README.md

@@ -42,6 +42,7 @@ cnotes search semantic "onboarding flow"
 | `cnotes canvas from-template` | | Create canvas from template |
 | `cnotes review request\|get\|list\|complete` | `cnotes reviews` | Official review requests: ask (a member, yourself, or an outside email), receive as structured work (`list --assigned-to me`), fetch the envelope, record one outcome |
 | `cnotes review send-again\|revoke` | | Ask someone else the same questions; take back an unanswered ask |
+| `cnotes focus plan\|list\|cancel` | | Plan protected focus blocks; `--canvas` + `--target` land a block on the exact card it works on |
 | `cnotes search semantic` | `cnotes s` | Semantic search across notes |
 | `cnotes timeline` | `cnotes tl` | Recent activity feed |
 | `cnotes relationships list` | `cnotes rel` | Note relationships |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@creator-notes/cnotes",
-  "version": "0.57.0",
+  "version": "0.57.1",
   "description": "CLI for CreatorNotes \u2014 create notes, build canvases, search knowledge from the terminal",
   "type": "module",
   "bin": {

package/skills/cnotes/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cnotes
-description: CreatorNotes CLI for the terminal. The command is `cnotes`. Use when the user mentions CreatorNotes or the cnotes CLI, asks to use this CLI skill, or wants to create, read, update, search, summarize, organize, or visualize notes, canvases, or transcripts in a CreatorNotes workspace. Covers cnotes notes, cnotes canvas, cnotes timeline, cnotes shared (what teammates shared with you), cnotes review (official review requests: request, receive, complete), cnotes search, cnotes versions, relationships, and operations. Prefer the cnotes CLI, verify the active workspace with cnotes workspace current, use --json when parsing output, and wrap write operations in cnotes operations begin and cnotes operations end.
+description: CreatorNotes CLI for the terminal. The command is `cnotes`. Use when the user mentions CreatorNotes or the cnotes CLI, asks to use this CLI skill, or wants to create, read, update, search, summarize, organize, or visualize notes, canvases, or transcripts in a CreatorNotes workspace. Covers cnotes notes, cnotes canvas, cnotes timeline, cnotes shared (what teammates shared with you), cnotes review (official review requests: request, receive, complete), cnotes focus (plan flow-state blocks landed on a target card), cnotes search, cnotes versions, relationships, and operations. Prefer the cnotes CLI, verify the active workspace with cnotes workspace current, use --json when parsing output, and wrap write operations in cnotes operations begin and cnotes operations end.
 metadata:
   short-description: Work with CreatorNotes via the cnotes CLI
 ---
@@ -536,6 +536,38 @@ cnotes review return <requestId> --reason "I can't open the Gong recording"
 # pasted review link is enough to pick the work up here.
 ```
 
+### Focus plans (`cnotes focus`)
+
+Protected flow-state blocks, private to the user. The Focus calendar overlays
+plans on recorded attention; kept/missed is derived, so there is no
+"complete" verb.
+
+```bash
+# Plan a block. Link the prepared canvas so opening the block orients in
+# seconds — and --target to land it on the exact card the block works on.
+cnotes focus plan --start 09:00 --duration 90m \
+  --goal "Decide the pricing wedge" --canvas CANVAS-12
+
+# --target names a NOTE-… or SECTION-… display id ON that canvas (an
+# Attention card, a Decision). Needs --canvas; validated at plan time (a
+# ref not on the canvas is refused). The calendar block then renders
+# "CANVAS-80 → ATTENTION-6J4 · <title>" and clicking it opens the canvas
+# landed on that card.
+cnotes focus plan --start 09:00 --duration 45m \
+  --goal "Approve the customer target" \
+  --canvas CANVAS-80 --target ATTENTION-6J4
+
+cnotes focus list [--days <n>] [--past <n>]   # target shows in the canvas column
+cnotes focus cancel <planId>
+```
+
+**Keep the plan row thin.** Time, goal, destination — nothing else. The
+durable clues (decisions, criteria, "complete when") live IN the target note,
+never in the goal string: a display id pasted into the goal is inert prose the
+graph cannot see, while `--target` is the clickable, validated form of the
+same intent. A plan with no `--canvas` renders as a non-clickable block; that
+is by design, not a bug — there is nothing to open.
+
 ### Relationships (`cnotes relationships` / `cnotes rel`)
 ```bash
 # Backlinks + outbound links for a note. This IS the editor's "Backlinks"