smashspace 0.1.6 → 0.1.7

package/dist/smash.mjs

@@ -3599,7 +3599,11 @@ the target board for you.
   shim that fails with "Volta error: Could not execute command".
 - MCP server: \`smashspace-mcp\` (exposes \`smash_*\` tools, same token as the CLI)
 - Sign in once per machine: \`smash login\` (browser approval; token saved to
-  \`~/.config/smash/credentials.json\` and reused by MCP)
+  \`~/.config/smash/credentials.json\` and reused by MCP). It is idempotent \u2014 if a
+  valid token is already saved it does nothing, so don't re-run it in a loop.
+- If \`smash\` is on PATH, **call it directly** \u2014 do not prefix
+  \`PATH=\u2026/node/\u2026/bin\`. A "Volta error: Could not execute command" means a stale
+  install; fix it with \`volta install smashspace\` rather than PATH-hacking.
 
 ### Which board am I on?
 
@@ -3671,7 +3675,20 @@ Keep the card's agent state current while you work:
 }
 \`\`\`
 
-Set \`status: "done"\` only after verification passes.
+Set \`status: "done"\` only after verification passes. Keep it current on
+meaningful moves/edits too (not just during todo-dev) so a human can see whose
+turn it is at a glance.
+
+## Batching (stay inside the CLI)
+
+Prefer the CLI's own batch flags over dropping to a shell/node loop:
+
+\`\`\`bash
+smash create "Title" --desc-file spec.md      # multi-line description, no quoting pain
+smash card update <cardId> --desc-file -       # description from stdin
+smash checklist add <cardId> --file steps.txt  # one item per line (or many args)
+smash checklist add <cardId> "Step 1" "Step 2" "Step 3"
+\`\`\`
 
 ## Command: /smash list
 
@@ -3829,6 +3846,15 @@ function show(data, headerLines = []) {
   if (data !== void 0)
     console.log(JSON.stringify(data, null, 2));
 }
+async function readTextArg(pathOrDash) {
+  if (pathOrDash === "-") {
+    const chunks = [];
+    for await (const chunk of stdin)
+      chunks.push(chunk);
+    return Buffer.concat(chunks).toString("utf8");
+  }
+  return readFile2(pathOrDash, "utf8");
+}
 function resolveBaseUrl(loaded = loadProjectConfig()) {
   if (program2.getOptionValueSource("baseUrl") === "cli")
     return getOpts().baseUrl;
@@ -4058,12 +4084,14 @@ ${detail.card.description}`);
     }
   }
 });
-cardCmd.command("update <cardId>").description("Update card fields (title, description, due date, cover, checklist title)").option("--title <title>", "New title").option("--description <description>", "New description (markdown)").option("--due <iso>", "Due date as ISO string, or empty string to clear").option("--cover <attachmentId>", "Cover attachment ID, or empty string to clear").option("--checklist-title <title>", "Custom checklist section title, or empty string to clear").action(
+cardCmd.command("update <cardId>").description("Update card fields (title, description, due date, cover, checklist title)").option("--title <title>", "New title").option("--description <description>", "New description (markdown)").option("--desc-file <path>", "read description from a file (or - for stdin)").option("--due <iso>", "Due date as ISO string, or empty string to clear").option("--cover <attachmentId>", "Cover attachment ID, or empty string to clear").option("--checklist-title <title>", "Custom checklist section title, or empty string to clear").action(
   async (cardId, opts) => {
     const patch = {};
     if (opts.title !== void 0)
       patch.title = opts.title;
-    if (opts.description !== void 0)
+    if (opts.descFile !== void 0)
+      patch.description = await readTextArg(opts.descFile);
+    else if (opts.description !== void 0)
       patch.description = opts.description;
     if (opts.due !== void 0)
       patch.dueAt = opts.due === "" ? null : opts.due;
@@ -4072,7 +4100,7 @@ cardCmd.command("update <cardId>").description("Update card fields (title, descr
     if (opts.checklistTitle !== void 0)
       patch.checklistTitle = opts.checklistTitle === "" ? null : opts.checklistTitle;
     if (Object.keys(patch).length === 0) {
-      console.error("Provide at least one of: --title, --description, --due, --cover, --checklist-title");
+      console.error("Provide at least one of: --title, --description, --desc-file, --due, --cover, --checklist-title");
       process.exit(1);
     }
     const card = await api(`/api/cards/${cardId}`, {
@@ -4198,15 +4226,28 @@ archiveCmd.command("purge <cardId>").description("Permanently delete an archived
   console.log(`\u2713 card ${cardId} permanently deleted`);
 });
 var checklistCmd = program2.command("checklist").description("Card checklist items");
-checklistCmd.command("add <cardId> <title>").description("Add a checklist item to a card").action(async (cardId, title) => {
-  const item = await api(
-    `/api/cards/${cardId}/checklist-items`,
-    {
-      method: "POST",
-      body: JSON.stringify({ title })
-    }
-  );
-  show(item, [`\u2713 checklist item ${item.id} added`]);
+checklistCmd.command("add <cardId> [titles...]").description("Add one or more checklist items (repeat titles, or --file with one per line)").option("--file <path>", "read items from a file, one per line (or - for stdin)").action(async (cardId, titles, opts) => {
+  let items = titles ?? [];
+  if (opts.file) {
+    const text = await readTextArg(opts.file);
+    items = items.concat(
+      text.split(/\r?\n/).map((s) => s.trim()).filter(Boolean)
+    );
+  }
+  if (items.length === 0) {
+    console.error("Provide at least one item title, or --file <path>");
+    process.exit(1);
+  }
+  const created = [];
+  for (const title of items) {
+    created.push(
+      await api(`/api/cards/${cardId}/checklist-items`, {
+        method: "POST",
+        body: JSON.stringify({ title })
+      })
+    );
+  }
+  show(created, [`\u2713 ${created.length} checklist item(s) added`]);
 });
 checklistCmd.command("toggle <itemId>").description("Toggle a checklist item to checked/unchecked").option("--check", "Mark as checked", false).option("--uncheck", "Mark as unchecked", false).action(
   async (itemId, opts) => {
@@ -4804,24 +4845,18 @@ program2.command("init").description(
     show(void 0, [...actions, ...next]);
   }
 );
-program2.command("create <title>").description(`Create a card on the resolved board (${CONFIG_FILENAME}, default "main")`).option("-b, --board <label>", "board label from config").option("--board-id <id>", "explicit board id (bypass config)").option("-l, --list <name>", "target list name (default: first list)").option("-d, --desc <text>", "card description (Markdown)").action(async (title, opts) => {
+program2.command("create <title>").description(`Create a card on the resolved board (${CONFIG_FILENAME}, default "main")`).option("-b, --board <label>", "board label from config").option("--board-id <id>", "explicit board id (bypass config)").option("-l, --list <name>", "target list name (default: first list)").option("-d, --desc <text>", "card description (Markdown)").option("--desc-file <path>", "read description from a file (or - for stdin)").action(async (title, opts) => {
   const ctx = resolveContext(opts);
   const detail = await fetchBoard(ctx.boardId, ctx.baseUrl);
   const list = opts.list ? findListByName(detail, opts.list) : detail.lists[0];
   if (!list)
     throw new Error(`Board ${ctx.boardId} has no lists`);
+  const description = opts.descFile ? await readTextArg(opts.descFile) : opts.desc;
   const card = await api(
     `/api/lists/${list.id}/cards`,
-    { method: "POST", body: JSON.stringify({ title }) },
+    { method: "POST", body: JSON.stringify(description ? { title, description } : { title }) },
     ctx.baseUrl
   );
-  if (opts.desc) {
-    await api(
-      `/api/cards/${card.id}`,
-      { method: "PATCH", body: JSON.stringify({ description: opts.desc }) },
-      ctx.baseUrl
-    );
-  }
   show(card, [`\u2713 created ${card.id} "${title}" in ${list.title} (board ${ctx.entry.label})`]);
 });
 program2.command("read").description(`Show the resolved board \u2014 lists + cards (${CONFIG_FILENAME}, default "main")`).option("-b, --board <label>", "board label from config").option("--board-id <id>", "explicit board id (bypass config)").action(async (opts) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smashspace",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "SmashSpace CLI + MCP — operate SmashSpace boards from your terminal, Claude Code, Cursor, and Codex.",
   "type": "module",
   "bin": {