smashspace 0.1.7 → 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

@@ -4763,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 = [];
@@ -4788,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) {
@@ -4831,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"

package/package.json

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