smashspace 0.1.6 → 0.1.8

package/README.md

@@ -34,11 +34,17 @@ server below. (Headless? use `smash login --token <PAT>`.)
 
 ## Onboard a project for agents: `smash init`
 
-Run once per repo to scaffold everything agents (Claude Code / Codex) need to
-operate SmashSpace as the task backbone — no manual copying:
+**One project = one `smash init` = one space.** Run it once inside each repo, so
+that project's agents (Claude Code / Codex) operate their own space:
 
 ```bash
-smash init --board-id b_xxxxxxxx
+cd your/dir/project
+
+# create a new space and pin it to this project
+smash init --new-space "Your Project"
+
+# …or pin an existing space
+smash init --space-id s_xxxxxxxx
 ```
 
 It writes (and is safe to re-run — existing config is kept unless `--force`):
@@ -46,12 +52,16 @@ It writes (and is safe to re-run — existing config is kept unless `--force`):
 - `.claude/skills/smash/SKILL.md` + `.codex/skills/smash/SKILL.md` — the
   SmashSpace Operator playbook (CLI/MCP usage + Inbox→Todo→Doing→Review→Done
   workflow + safety rules). Always refreshed to the installed CLI version.
-- `.smashspace.json` — pins the instance + board.
+- `.smashspace.json` — pins the instance + space (which space this dir talks to).
 - `.mcp.json` — wires the `smashspace` MCP server (merged, other servers kept).
 
-Flags: `--skills-only` (just the operator skill), `--no-mcp`, `--force`,
-`--board-id <id>`. Then `smash login` once on the machine and the agents are
-ready.
+Plain `smash init` (no space flag) is safe: it installs the skill and writes a
+`.smashspace.json` with a **placeholder** space id, then prints how to set a real
+one (`--new-space` / `--space-id`). It never guesses or deletes anything.
+
+Flags: `--new-space <name>`, `--space-id <id>` (`--board-id` is a legacy alias),
+`--skills-only` (just the operator skill), `--no-mcp`, `--force`. Sign in once
+with `smash login` first (`--new-space` needs it).
 
 ## Project config: `.smashspace.json`
 

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) => {
@@ -4722,7 +4763,7 @@ program2.command("status").aliases(["context", "where"]).description(
 });
 program2.command("init").description(
   "Scaffold this project for agents: operator skill + .smashspace.json + .mcp.json"
-).option("--board-id <id>", "Board/space id to pin in .smashspace.json / .mcp.json").option("--skills-only", "Only (re)install the operator skill files").option("--no-mcp", "Skip writing .mcp.json").option("-f, --force", "Overwrite .smashspace.json / .mcp.json if they exist").action(
+).option("--new-space <name>", "create a new space with this name, then pin it (needs login)").option("--space-id <id>", "existing space id to pin, e.g. s_xxxxxxxx").option("--board-id <id>", "alias for --space-id (legacy)").option("--skills-only", "Only (re)install the operator skill files").option("--no-mcp", "Skip writing .mcp.json").option("-f, --force", "Overwrite .smashspace.json / .mcp.json if they exist").action(
   async (opts) => {
     const cwd = process.cwd();
     const actions = [];
@@ -4747,15 +4788,26 @@ program2.command("init").description(
       "\u2713 operator skill \u2192 .claude/skills/smash/ + .codex/skills/smash/"
     );
     const baseUrl = resolveBaseUrl();
-    const boardId = opts.boardId ?? "b_xxxxxxxx";
-    const placeholder = boardId === "b_xxxxxxxx";
+    let boardId;
+    if (opts.newSpace) {
+      const space = await api(
+        "/api/boards",
+        { method: "POST", body: JSON.stringify({ title: opts.newSpace }) },
+        baseUrl
+      );
+      boardId = space.id;
+      actions.push(`\u2713 created space "${space.title || opts.newSpace}" (${space.id})`);
+    } else {
+      boardId = opts.spaceId ?? opts.boardId ?? "s_xxxxxxxx";
+    }
+    const placeholder = boardId === "s_xxxxxxxx";
     if (!opts.skillsOnly) {
       if (await exists(CONFIG_FILENAME) && !opts.force) {
         actions.push(`\u2022 ${CONFIG_FILENAME} exists \u2014 kept (use --force)`);
       } else {
         await put(CONFIG_FILENAME, smashspaceJson(baseUrl, boardId));
         actions.push(
-          `\u2713 ${CONFIG_FILENAME}${placeholder ? " (placeholder space_id \u2014 edit it)" : ` (${boardId})`}`
+          `\u2713 ${CONFIG_FILENAME}${placeholder ? " (placeholder space_id \u2014 set a real one below)" : ` \u2192 ${boardId}`}`
         );
       }
       if (opts.mcp !== false) {
@@ -4790,9 +4842,14 @@ program2.command("init").description(
         }
       }
     }
-    const next = ["", "Next:", "  1. smash login              # sign in (browser approval)"];
+    const next = ["", "Next:"];
     if (!opts.skillsOnly && placeholder) {
-      next.push("  2. edit .smashspace.json    # set your real space_id (`smash board list` to find it)");
+      next.push("  This project isn't pinned to a space yet. Pick one:");
+      next.push('    smash init --new-space "My Project" --force   # create + pin a new space');
+      next.push("    smash init --space-id s_xxxxxxxx --force      # pin an existing space");
+      next.push("    (find ids with:  smash space list)");
+    } else if (!opts.skillsOnly) {
+      next.push("  smash login   # if you haven't yet \u2014 then you're ready.");
     }
     next.push(
       "  \u2192 Claude Code / Codex pick up .claude|.codex/skills/smash automatically"
@@ -4804,24 +4861,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.8",
   "description": "SmashSpace CLI + MCP — operate SmashSpace boards from your terminal, Claude Code, Cursor, and Codex.",
   "type": "module",
   "bin": {