smashspace 0.1.9 → 0.2.0

package/README.md

@@ -60,7 +60,8 @@ space (`--new-space` / `--space-id`) and exits without writing anything. Same,
 predictable behaviour in a terminal, an agent, or CI — nothing hangs, nothing is
 written half-way. (`--skills-only` installs just the skill, no space needed.)
 
-Flags: `--new-space <name>`, `--space-id <id>` (`--board-id` is a legacy alias),
+Flags: `--new-space <name>`, `--space-id <id-or-url>` (accepts a full
+`https://…/space/s_xxx` URL too; `--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).
 
@@ -84,13 +85,23 @@ prefer, so `smash` knows which board to operate on:
 ```bash
 smash status                     # what context is this directory in? (see below)
 smash read                       # show the board (lists + cards)
-smash scan --list "やること"      # actionable cards as JSON (for agents)
-smash create "Fix signup bug"    # add a card (to the first list, or --list)
+smash scan --list "やること"      # cards as JSON (id/title/list only)
+smash scan --list "やること" --full   # + description/agentMeta/labels — pick up work in ONE request
+smash create "Fix signup bug"    # add a card (to the first list, or --list; --desc for a body)
 smash move <cardId> "レビュー"    # move a card to a list by name
 smash archive <cardId>           # archive (soft-delete) a card
 smash --help                     # full command list (board/list/card/…)
 ```
 
+Output is a concise line by default; add `--json` for machine-readable output on
+any command. For agents:
+
+```bash
+smash scan --full                              # or --fields description,agentMeta
+smash agent-meta set <cardId> --set status=working --set progress=0.4 --merge
+smash card update <cardId> --desc-file spec.md   # multi-line body from a file / -  (stdin)
+```
+
 Pick a board with `-b <label>` (defaults to `main`), or bypass config with
 `--board-id <id>`.
 

package/dist/smash.mjs

@@ -3811,7 +3811,10 @@ function mcpServerEntry(baseUrl, boardId) {
 // ../../cli/index.ts
 var DEFAULT_BASE_URL = process.env.SMASH_BASE_URL ?? "https://smashspace.app";
 var program2 = new Command();
-program2.name("smash").description("SmashSpace CLI \u2014 Trello as a spreadsheet for the AI agent era").option("--base-url <url>", "API base URL", DEFAULT_BASE_URL).option("--json", "Output raw JSON", false);
+program2.name("smash").description("SmashSpace CLI \u2014 Trello as a spreadsheet for the AI agent era").option("--base-url <url>", "API base URL", DEFAULT_BASE_URL).option("--json", "Output raw JSON", false).showSuggestionAfterError().addHelpText(
+  "after",
+  '\nTop-level verbs (create/read/move/scan/archive) act on the space resolved\nfrom .smashspace.json (default "main"). The card/board/list groups take\nexplicit ids. Default output is a concise line; add --json for machine-readable.'
+);
 function getOpts() {
   const o = program2.opts();
   return { baseUrl: o.baseUrl ?? DEFAULT_BASE_URL, json: !!o.json };
@@ -3841,8 +3844,11 @@ function show(data, headerLines = []) {
     console.log(JSON.stringify(data, null, 2));
     return;
   }
-  for (const l of headerLines)
-    console.log(l);
+  if (headerLines.length > 0) {
+    for (const l of headerLines)
+      console.log(l);
+    return;
+  }
   if (data !== void 0)
     console.log(JSON.stringify(data, null, 2));
 }
@@ -4060,7 +4066,7 @@ cardCmd.command("create <listId> <title>").description("Create a card in a list"
   });
   show(card, [`\u2713 card ${card.id} created in ${listId}`]);
 });
-cardCmd.command("show <cardId>").description("Show card detail (description, checklist, comments, activity)").action(async (cardId) => {
+cardCmd.command("show <cardId>").alias("get").description("Show card detail (description, checklist, comments, activity)").action(async (cardId) => {
   const detail = await api(`/api/cards/${cardId}`);
   if (getOpts().json) {
     console.log(JSON.stringify(detail, null, 2));
@@ -4084,15 +4090,16 @@ ${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("--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(
+cardCmd.command("update <cardId>").description("Update card fields (title, description, due date, cover, checklist title)").option("--title <title>", "New title").option("-d, --description <description>", "New description (markdown)").option("--desc <description>", "alias for --description").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;
+    const desc = opts.description ?? opts.desc;
     if (opts.descFile !== void 0)
       patch.description = await readTextArg(opts.descFile);
-    else if (opts.description !== void 0)
-      patch.description = opts.description;
+    else if (desc !== void 0)
+      patch.description = desc;
     if (opts.due !== void 0)
       patch.dueAt = opts.due === "" ? null : opts.due;
     if (opts.cover !== void 0)
@@ -4393,29 +4400,57 @@ labelCmd.command("delete <labelId>").description("Delete a label from the board"
   console.log(`\u2713 label ${labelId} deleted`);
 });
 var agentMetaCmd = program2.command("agent-meta").description("Set or clear a card's agent_meta (structured field for external agents)");
-agentMetaCmd.command("set <cardId>").description("Set agent_meta on a card. Provide JSON via --data or --file.").option("--data <json>", "Inline JSON string").option("--file <path>", "Read JSON from a file path (use - for stdin)").action(async (cardId, opts) => {
-  let raw;
-  if (opts.data && opts.file) {
-    console.error("Provide --data or --file, not both");
-    process.exit(1);
-  } else if (opts.data !== void 0) {
-    raw = opts.data;
-  } else if (opts.file !== void 0) {
-    raw = opts.file === "-" ? await new Response(process.stdin).text() : await readFile2(opts.file, "utf8");
-  } else {
-    console.error("Provide --data '<...>' or --file <path>");
-    process.exit(1);
-  }
+agentMetaCmd.command("set <cardId>").description("Set agent_meta on a card. Use --set key=value (repeatable), or --data/--file for full JSON.").option("--set <pair>", "key=value (repeatable; value parsed as JSON if valid, else string)", (v, acc) => {
+  acc.push(v);
+  return acc;
+}, []).option("--merge", "merge into the existing agent_meta instead of replacing it").option("--data <json>", "Inline JSON string (full object)").option("--file <path>", "Read JSON from a file path (use - for stdin)").action(async (cardId, opts) => {
   let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch (e) {
-    console.error(`Invalid JSON: ${e instanceof Error ? e.message : String(e)}`);
-    process.exit(1);
+  if (opts.set.length > 0) {
+    parsed = {};
+    for (const pair of opts.set) {
+      const i = pair.indexOf("=");
+      if (i < 0) {
+        console.error(`--set expects key=value, got: ${pair}`);
+        process.exit(1);
+      }
+      const key = pair.slice(0, i);
+      const rawVal = pair.slice(i + 1);
+      try {
+        parsed[key] = JSON.parse(rawVal);
+      } catch {
+        parsed[key] = rawVal;
+      }
+    }
+  } else {
+    let raw;
+    if (opts.data && opts.file) {
+      console.error("Provide --set, --data, or --file (not more than one source)");
+      process.exit(1);
+    } else if (opts.data !== void 0) {
+      raw = opts.data;
+    } else if (opts.file !== void 0) {
+      raw = opts.file === "-" ? await new Response(process.stdin).text() : await readFile2(opts.file, "utf8");
+    } else {
+      console.error("Provide --set key=value, --data '<json>', or --file <path>");
+      process.exit(1);
+    }
+    let p;
+    try {
+      p = JSON.parse(raw);
+    } catch (e) {
+      console.error(`Invalid JSON: ${e instanceof Error ? e.message : String(e)}`);
+      process.exit(1);
+    }
+    if (typeof p !== "object" || p === null || Array.isArray(p)) {
+      console.error("agent_meta must be a JSON object");
+      process.exit(1);
+    }
+    parsed = p;
   }
-  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-    console.error("agent_meta must be a JSON object");
-    process.exit(1);
+  if (opts.merge) {
+    const detail = await api(`/api/cards/${cardId}`);
+    const existing = detail.card.agentMeta ?? {};
+    parsed = { ...existing, ...parsed };
   }
   const card = await api(`/api/cards/${cardId}`, {
     method: "PATCH",
@@ -4811,7 +4846,9 @@ program2.command("init").description(
         boardId = space.id;
         actions.push(`\u2713 created space "${space.title || opts.newSpace}" (${space.id})`);
       } else {
-        boardId = opts.spaceId ?? opts.boardId;
+        const raw = opts.spaceId ?? opts.boardId;
+        const m = raw.match(/\/(?:board|space)\/((?:board_|b_|s_)[a-z0-9]+)/i);
+        boardId = m ? m[1] : raw;
       }
     }
     if (!opts.skillsOnly) {
@@ -4907,19 +4944,29 @@ program2.command("move <cardId> <listName>").description("Move a card to a list
   );
   show(card, [`\u2713 moved ${cardId} \u2192 ${list.title} (board ${ctx.entry.label})`]);
 });
-program2.command("scan").description("Emit the board's cards as JSON (agent-facing: pick up work programmatically)").option("-b, --board <label>", "board label from config").option("--board-id <id>", "explicit board id (bypass config)").option("-l, --list <name>", "only cards in this list").action(async (opts) => {
+program2.command("scan").description("Emit the board's cards as JSON (agent-facing: pick up work programmatically)").option("-b, --board <label>", "board label from config").option("--board-id <id>", "explicit board id (bypass config)").option("-l, --list <name>", "only cards in this list").option("--full", "include all card fields (description, agentMeta, labelIds, \u2026) \u2014 no extra requests").option("--fields <list>", "comma-separated extra fields to include, e.g. description,agentMeta").action(async (opts) => {
   const ctx = resolveContext(opts);
   const detail = await fetchBoard(ctx.boardId, ctx.baseUrl);
   const lists = opts.list ? [findListByName(detail, opts.list)] : detail.lists;
+  const extraFields = opts.fields ? opts.fields.split(",").map((s) => s.trim()).filter(Boolean) : [];
   const cards = lists.flatMap(
-    (l) => l.cards.map((c) => ({
-      id: c.id,
-      title: c.title,
-      list: l.title,
-      listId: l.id,
-      position: c.position,
-      dueAt: c.dueAt ?? null
-    }))
+    (l) => l.cards.map((c) => {
+      if (opts.full)
+        return { list: l.title, ...c };
+      const base = {
+        id: c.id,
+        title: c.title,
+        list: l.title,
+        listId: l.id,
+        position: c.position,
+        dueAt: c.dueAt ?? null
+      };
+      for (const f of extraFields) {
+        if (f in c)
+          base[f] = c[f];
+      }
+      return base;
+    })
   );
   console.log(
     JSON.stringify(

package/package.json

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