smashspace 0.1.8 → 0.2.0

package/README.md

@@ -55,11 +55,13 @@ It writes (and is safe to re-run — existing config is kept unless `--force`):
 - `.smashspace.json` — pins the instance + space (which space this dir talks to).
 - `.mcp.json` — wires the `smashspace` MCP server (merged, other servers kept).
 
-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.
+Plain `smash init` (no space flag) doesn't guess: it prints how to specify a
+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).
 
@@ -83,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",
@@ -4781,34 +4816,47 @@ program2.command("init").description(
         return false;
       }
     };
+    const baseUrl = resolveBaseUrl();
+    if (!opts.skillsOnly && !opts.newSpace && !opts.spaceId && !opts.boardId) {
+      console.error(
+        [
+          "\u30B9\u30DA\u30FC\u30B9\u306E\u6307\u5B9A\u304C\u5FC5\u8981\u3067\u3059\u3002\u6B21\u306E\u3069\u3061\u3089\u304B\u3092\u4ED8\u3051\u3066\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044:",
+          "",
+          '  smash init --new-space "Your Project"   # \u65B0\u3057\u304F\u4F5C\u3063\u3066\u7D50\u3073\u3064\u3051\u308B',
+          "  smash init --space-id s_xxxxxxxx        # \u65E2\u5B58\u306E\u30B9\u30DA\u30FC\u30B9\u306B\u7D50\u3073\u3064\u3051\u308B",
+          "",
+          "\u65E2\u5B58\u30B9\u30DA\u30FC\u30B9\u306E id \u306F `smash space list` \u3067\u78BA\u8A8D\u3067\u304D\u307E\u3059\u3002",
+          "\u30B9\u30AD\u30EB\u3060\u3051\u5165\u308C\u305F\u3044\u5834\u5408\u306F `smash init --skills-only`\u3002"
+        ].join("\n")
+      );
+      process.exit(1);
+    }
     await put(".claude/skills/smash/SKILL.md", SMASH_SKILL_MD);
     await put(".codex/skills/smash/SKILL.md", SMASH_SKILL_MD);
     await put(".codex/skills/smash/agents/openai.yaml", OPENAI_AGENT_YAML);
-    actions.push(
-      "\u2713 operator skill \u2192 .claude/skills/smash/ + .codex/skills/smash/"
-    );
-    const baseUrl = resolveBaseUrl();
-    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";
+    actions.push("\u2713 operator skill \u2192 .claude/skills/smash/ + .codex/skills/smash/");
+    let boardId = "";
+    if (!opts.skillsOnly) {
+      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 {
+        const raw = opts.spaceId ?? opts.boardId;
+        const m = raw.match(/\/(?:board|space)\/((?:board_|b_|s_)[a-z0-9]+)/i);
+        boardId = m ? m[1] : raw;
+      }
     }
-    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 set a real one below)" : ` \u2192 ${boardId}`}`
-        );
+        actions.push(`\u2713 ${CONFIG_FILENAME} \u2192 ${boardId}`);
       }
       if (opts.mcp !== false) {
         let mcp = { mcpServers: {} };
@@ -4843,19 +4891,14 @@ program2.command("init").description(
       }
     }
     const next = ["", "Next:"];
-    if (!opts.skillsOnly && placeholder) {
-      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) {
+    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"
     );
     if (getOpts().json) {
-      show({ cwd, actions, baseUrl, boardId: placeholder ? null : boardId });
+      show({ cwd, actions, baseUrl, boardId: boardId || null });
       return;
     }
     show(void 0, [...actions, ...next]);
@@ -4901,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.8",
+  "version": "0.2.0",
   "description": "SmashSpace CLI + MCP — operate SmashSpace boards from your terminal, Claude Code, Cursor, and Codex.",
   "type": "module",
   "bin": {