@gobi-ai/cli 2.0.29 → 2.0.31

package/dist/commands/sync.js

@@ -142,6 +142,22 @@ export function saveSyncState(gobiDir, state) {
     }
 }
 // ─── Syncfiles ────────────────────────────────────────────────────────────────
+/**
+ * Webdrive requires every sync/private pattern to be root-anchored — the server
+ * rejects anything not starting with "/" (HTTP 400: "Pattern must start with
+ * '/'"). Older syncfiles, hand-edits, and `--auto-attachments` appends can all
+ * produce slash-less entries that hard-fail the whole sync with a cryptic 400,
+ * so anchor them to the vault root here. Negation patterns ("!foo") keep their
+ * leading "!". Patterns already starting with "/" are returned unchanged, so
+ * anything the server currently accepts is untouched.
+ */
+export function normalizeSyncPattern(pattern) {
+    if (pattern.startsWith("!")) {
+        const rest = pattern.slice(1);
+        return rest.startsWith("/") ? pattern : `!/${rest}`;
+    }
+    return pattern.startsWith("/") ? pattern : `/${pattern}`;
+}
 export function readSyncfiles(gobiDir) {
     const syncfilesPath = join(gobiDir, "syncfiles");
     if (!existsSync(syncfilesPath)) {
@@ -151,7 +167,8 @@ export function readSyncfiles(gobiDir) {
     const patterns = content
         .split("\n")
         .map((l) => l.trim())
-        .filter((l) => l.length > 0 && !l.startsWith("#"));
+        .filter((l) => l.length > 0 && !l.startsWith("#"))
+        .map(normalizeSyncPattern);
     const contentHash = createHash("md5").update(content).digest("hex");
     return { patterns, contentHash };
 }
@@ -162,7 +179,8 @@ export function readPrivatefiles(gobiDir) {
     return readFileSync(path, "utf-8")
         .split("\n")
         .map((l) => l.trim())
-        .filter((l) => l.length > 0 && !l.startsWith("#"));
+        .filter((l) => l.length > 0 && !l.startsWith("#"))
+        .map(normalizeSyncPattern);
 }
 export function buildWhitelistMatcher(patterns) {
     if (patterns.length === 0)

package/dist/commands/utils.js

@@ -28,3 +28,73 @@ export function unwrapResp(resp) {
     }
     return resp;
 }
+// Compact reaction chips for single-line output: `👍2* 🎉1` — the trailing
+// `*` marks emojis the caller has reacted with (remove via `unreact`).
+export function formatReactionChips(m) {
+    const reactions = m.reactions || [];
+    if (!Array.isArray(reactions) || !reactions.length)
+        return "";
+    return reactions
+        .map((r) => `${r.emoji}${r.count}${r.reactedByMe ? "*" : ""}`)
+        .join(" ");
+}
+// Classify a wire attachment the way the clients do: declared mimeType first,
+// then the media-url extension (covers rows that predate the mimeType field).
+function attachmentKind(a) {
+    if (a.artifact)
+        return "artifact";
+    const mime = (a.mimeType || "").toLowerCase();
+    const url = (a.mediaUrl || "").toLowerCase().split("?")[0];
+    if (mime === "image/gif" || (!mime && url.endsWith(".gif")))
+        return "gif";
+    if (mime.startsWith("image/"))
+        return "photo";
+    if (mime.startsWith("video/"))
+        return "video";
+    if (mime)
+        return "file";
+    if (/\.(jpe?g|png|webp|heic|heif|avif|svg|bmp|tiff)$/.test(url))
+        return "photo";
+    if (/\.(mp4|mov|webm|m4v)$/.test(url))
+        return "video";
+    if (/\.(pdf|md|txt|csv)$/.test(url))
+        return "file";
+    return "media";
+}
+// Compact attachment marker for single-line output: `📎 2 photos, 1 file`.
+// Counts per kind; full URLs are in `get-post` (or --json).
+export function formatAttachmentSummary(m) {
+    const attachments = m.attachments || [];
+    if (!Array.isArray(attachments) || !attachments.length)
+        return "";
+    const counts = new Map();
+    for (const a of attachments) {
+        const kind = attachmentKind(a);
+        counts.set(kind, (counts.get(kind) ?? 0) + 1);
+    }
+    const parts = [];
+    for (const [kind, count] of counts) {
+        parts.push(count === 1 ? `1 ${kind}` : `${count} ${kind}s`);
+    }
+    return `📎 ${parts.join(", ")}`;
+}
+// One line per attachment with the fetchable URL — used by `get-post` so an
+// agent can download/describe the media without re-querying in --json mode.
+export function formatAttachmentLines(m, indent = "  ") {
+    const attachments = m.attachments || [];
+    if (!Array.isArray(attachments) || !attachments.length)
+        return [];
+    return attachments.map((a) => {
+        const kind = attachmentKind(a);
+        if (kind === "artifact") {
+            const art = a.artifact;
+            const title = art.title ? ` "${art.title}"` : "";
+            const status = art.isPublished ? "published" : "unpublished";
+            return `${indent}- artifact [${art.kind}]${title} (${art.artifactId}, ${status})${art.mediaUrl ? ` — ${art.mediaUrl}` : ""}`;
+        }
+        const dims = a.width && a.height ? ` ${a.width}×${a.height}` : "";
+        const name = a.fileName ? ` "${a.fileName}"` : "";
+        const mime = a.mimeType ? ` (${a.mimeType})` : "";
+        return `${indent}- ${kind}${name}${dims}${mime} — ${a.mediaUrl}`;
+    });
+}

package/dist/commands/vault.js

@@ -1,10 +1,10 @@
-import { existsSync, readFileSync } from "fs";
+import { existsSync, readFileSync, writeFileSync } from "fs";
 import { join, resolve as pathResolve } from "path";
 import { WEB_BASE_URL, WEBDRIVE_BASE_URL } from "../constants.js";
 import { getValidToken } from "../auth/manager.js";
 import { GobiError } from "../errors.js";
 import { apiDelete, apiGet, apiPatch, apiPost } from "../client.js";
-import { getVaultSlug, requireVault, runVaultInitFlow } from "./init.js";
+import { defaultPublishMd, getVaultSlug, requireVault, runVaultInitFlow } from "./init.js";
 import { isJsonMode, jsonOut, unwrapResp } from "./utils.js";
 import { runSync } from "./sync.js";
 export const PUBLISH_FILENAME = "PUBLISH.md";
@@ -156,7 +156,19 @@ export function registerVaultCommand(program) {
         const vaultId = getVaultSlug();
         const filePath = join(process.cwd(), PUBLISH_FILENAME);
         if (!existsSync(filePath)) {
-            throw new Error(`${PUBLISH_FILENAME} not found in ${process.cwd()}`);
+            // Scaffold a starter profile locally instead of dead-ending, but do NOT
+            // push it — an empty profile shouldn't go live without the user's review.
+            // (Legacy vaults that predate PUBLISH.md, e.g. BRAIN.md-only, land here.)
+            writeFileSync(filePath, defaultPublishMd(vaultId), "utf-8");
+            const msg = `${PUBLISH_FILENAME} not found, so a starter one was created at ${filePath}. ` +
+                `Fill in at least "title" and "description" (add "homepage" too if you have a custom homepage), ` +
+                `then re-run "gobi vault publish".`;
+            if (isJsonMode(vault)) {
+                jsonOut({ vaultId, published: false, created: PUBLISH_FILENAME, message: msg });
+                return;
+            }
+            console.log(msg);
+            return;
         }
         const content = readFileSync(filePath, "utf-8");
         const token = await getValidToken();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobi-ai/cli",
-  "version": "2.0.29",
+  "version": "2.0.31",
   "description": "CLI client for the Gobi collaborative knowledge platform",
   "license": "MIT",
   "type": "module",

package/skills/gobi-artifact/SKILL.md

@@ -9,12 +9,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.29"
+  version: "2.0.31"
 ---
 
 # gobi-artifact
 
-Gobi artifact commands for versioned, post-attachable creations (v2.0.29).
+Gobi artifact commands for versioned, post-attachable creations (v2.0.31).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 

package/skills/gobi-core/SKILL.md

@@ -8,12 +8,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.29"
+  version: "2.0.31"
 ---
 
 # gobi-core
 
-Core CLI commands for the Gobi collaborative knowledge platform (v2.0.29).
+Core CLI commands for the Gobi collaborative knowledge platform (v2.0.31).
 
 ## Prerequisites
 

package/skills/gobi-core/references/space.md

@@ -6,13 +6,13 @@ Usage: gobi space [options] [command]
 Space commands (posts, replies). Space and member admin is web-UI only.
 
 Options:
-  --space-slug <spaceSlug>                Space slug (overrides .gobi/settings.yaml)
-  -h, --help                              display help for command
+  --space-slug <spaceSlug>                    Space slug (overrides .gobi/settings.yaml)
+  -h, --help                                  display help for command
 
 Commands:
-  list                                    List spaces you are a member of.
-  warp [spaceSlug]                        Select the active space. Pass a slug to warp directly, or omit for interactive selection.
-  help [command]                          display help for command
+  list                                        List spaces you are a member of.
+  warp [spaceSlug]                            Select the active space. Pass a slug to warp directly, or omit for interactive selection.
+  help [command]                              display help for command
 ```
 
 ## list

package/skills/gobi-homepage/SKILL.md

@@ -7,7 +7,7 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.29"
+  version: "2.0.31"
 ---
 
 # Gobi Homepage Developer Guide
@@ -20,13 +20,26 @@ A **Gobi Homepage** is a custom HTML page hosted on a vault's webdrive and serve
 
 ## Setup
 
-1. Create an HTML file in the vault (e.g. `app/home.html`) and upload:
+A homepage is registered only after `PUBLISH.md` references it **and** the vault is re-published. Uploading the HTML alone does **not** set the homepage — `gobi vault status` will keep reporting `homepagePath: null` until you publish.
+
+1. **Create** the HTML file at a vault-root-relative path, e.g. `app/home.html` (not `_Gobi_/app/home.html` — paths are relative to the vault root).
+2. **Reference it** in `PUBLISH.md` frontmatter via the `homepage` property:
+   - `homepage: "[[app/home.html]]"` — Gobi sidebar visible alongside the homepage
+   - `homepage: "[[app/home.html?nav=false]]"` — full-screen, no Gobi chrome
+3. **Upload** the HTML to webdrive:
    ```bash
-   gobi vault sync
+   gobi vault sync --upload-only --path app/home.html
    ```
-2. Set `homepage` in PUBLISH.md (homepage property):
-   - `homepage: "[[app/home.html]]"` — Gobi sidebars visible alongside the homepage
-   - `homepage: "[[app/home.html?nav=false]]"` — full-screen, no Gobi chrome
+4. **Publish** so the updated frontmatter takes effect (this uploads `PUBLISH.md` and re-syncs vault metadata):
+   ```bash
+   gobi vault publish
+   ```
+5. **Verify** the homepage is registered:
+   ```bash
+   gobi --json vault status   # expect "homepagePath": "app/home.html"
+   ```
+
+> Any time you change the `homepage` frontmatter, re-run `gobi vault publish` — the file upload alone won't update the profile. See the **gobi-vault** skill for the full publishing workflow.
 
 ---
 

package/skills/gobi-media/SKILL.md

@@ -10,12 +10,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.29"
+  version: "2.0.31"
 ---
 
 # gobi-media
 
-Gobi media generation commands (v2.0.29).
+Gobi media generation commands (v2.0.31).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 

package/skills/gobi-sense/SKILL.md

@@ -7,12 +7,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.29"
+  version: "2.0.31"
 ---
 
 # gobi-sense
 
-Gobi sense commands for activity and transcription data (v2.0.29).
+Gobi sense commands for activity and transcription data (v2.0.31).
 
 Requires gobi-cli installed and authenticated. See the **gobi-core** skill for setup.
 

package/skills/gobi-space/SKILL.md

@@ -11,12 +11,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.29"
+  version: "2.0.31"
 ---
 
 # gobi-space
 
-Gobi space, global, and personal-space posts (v2.0.29).
+Gobi space, global, and personal-space posts (v2.0.31).
 
 Requires gobi-cli installed and authenticated. See the **gobi-core** skill for setup.
 
@@ -51,13 +51,15 @@ Posts have no vault attribution. Both `create-post` and `edit-post` across all t
 
 > **Wiki-link uploads moved to artifacts.** The `--auto-attachments` flag that used to upload `[[wiki-linked files]]` from a post body now lives on `gobi artifact create` / `gobi artifact revise` (markdown kinds). To publish a markdown creation with resolvable wikilinks, create a markdown artifact with `--vault-slug` + `--auto-attachments` and attach it to the post (`--post-id`). See the **gobi-artifact** skill. Before relying on wikilink resolution, confirm the anchor vault is published: `gobi --json vault status --vault-slug <slug>` should report `isPublished: true`.
 
-## Post media attachments (`--attach`)
+## Post media + file attachments (`--attach`)
 
-`create-post` and `create-reply` across all three scopes (`gobi space`, `gobi global`, `gobi personal`) accept `--attach <file>` (repeatable) for inline post media — the photos/GIF/video that render in-feed alongside the post body. The CLI uploads each file to S3 via `POST /posts/upload-url` and passes the resulting `{ mediaUrl, mediaKey }` array as the post's `attachments`.
+`create-post` and `create-reply` across all three scopes (`gobi space`, `gobi global`, `gobi personal`) accept `--attach <file>` (repeatable) for inline post attachments — photos/GIF/video that render in-feed alongside the post body, and document files (**pdf/md/txt/csv**) that render as Slack-style file cards. The CLI uploads each file to S3 via `POST /posts/upload-url`; document files additionally carry `fileName` + `mimeType` on the row (the S3 key is a UUID, so that's the only place the original name survives).
 
-X-style mix rule (enforced client-side before upload): up to **4 photos** OR **1 GIF** OR **1 video** — they don't combine. Server-side ceilings: 5MB photos, 15MB GIFs, 512MB video.
+Mix rule (enforced client-side before upload): up to **4 photos + 4 document files** together, OR **1 GIF**, OR **1 video** — GIF and video are exclusive with everything. Size ceilings: 10MB photos, 15MB GIFs, 512MB video, 250MB document files.
 
-Use `--attach` for media you want shown in the post itself; use a markdown **artifact** (`gobi artifact create`) for `[[wikilinks]]`-bearing creations attached to the post.
+Use `--attach` for media/files you want shown in the post itself; use a markdown **artifact** (`gobi artifact create`) for `[[wikilinks]]`-bearing creations attached to the post.
+
+**Reading attachments back:** feed and list lines show a compact marker like `📎 2 photos, 1 file`; `get-post` prints an `Attachments (N):` block with one line per attachment — kind, original fileName, dimensions/MIME, and the fetchable CDN URL (artifact attachments show kind/title/artifactId instead). In `--json` mode the full `attachments` array is on every post/reply object.
 
 ## Public link formats
 
@@ -106,7 +108,7 @@ gobi --json space list-posts
 - `gobi space list-topic-posts` — List posts tagged with a topic in a space (cursor-paginated).
 
 ### Feed
-- `gobi space feed` — List the unified feed (posts and replies, newest first).
+- `gobi space feed` — List the unified feed (posts and replies, newest first). `--channel <channelId>` reads a channel's feed instead of the main feed.
 
 ### Space posts
 - `gobi space list-posts` — List posts in a space (paginated).
@@ -120,6 +122,22 @@ gobi --json space list-posts
 - `gobi space edit-reply <replyId>` — Edit a reply. You must be the author.
 - `gobi space delete-reply <replyId>` — Delete a reply. You must be the author.
 
+### Reactions
+
+Emoji reactions on posts **and** replies, across all three scopes (`gobi space`, `gobi global`, `gobi personal`). The id is the bare number from the `[p:N]`/`[r:N]` ids in feed output. Feed and `get-post` lines render existing reactions as compact chips like `👍2* 🎉1` — the count follows each emoji, and a trailing `*` marks ones you reacted with.
+
+- `gobi space react <postId> <emoji>` — Add a reaction (idempotent; re-reacting with the same emoji is a no-op).
+- `gobi space unreact <postId> <emoji>` — Remove your reaction. Pass the emoji literally (`gobi space unreact 123 👍`).
+
+### Channels (space scope only)
+
+Channels are private, member-gated sub-feeds inside a space. The **main feed is not a channel** — `feed` / `list-posts` / `create-post` without `--channel` target it, as always. Members see their own channels; space owners/admins see all of them; the space agent sees only channels with agent access enabled. Posting into a channel requires being able to see it. Channel administration (create, rename, delete, add/remove members, leave) is web-UI only — like space and member admin, the CLI deliberately doesn't expose it.
+
+- `gobi space list-channels` — List channels visible to you (shows member count, your membership, agent access).
+- `gobi space get-channel <channelId>` — Get one channel's details.
+- `gobi space list-channel-members <channelId>` — List a channel's members.
+- `--channel <channelId>` on `feed`, `list-posts`, and `create-post` reads/writes that channel instead of the main feed.
+
 ### Personal posts (global feed)
 
 `gobi global` is the same surface for Personal Posts — posts that live on the author's profile and surface in the public global feed.
@@ -157,8 +175,9 @@ Most posts and replies are publicly visible — in a community space (`gobi spac
 - `create-post` / `create-reply` — content goes live on submission.
 - `edit-post` / `edit-reply` — confirm the *new* content; people who already saw the original may re-see it.
 - `delete-post` / `delete-reply` — irreversible. Flag that explicitly and confirm the target id before running.
+- `react` / `unreact` are lightweight and reversible — when the user asked for the reaction, no extra confirmation needed.
 
-Read-only commands (`list-posts`, `get-post`, `feed`, `list-topics`, `list-topic-posts`, `get`) run without confirmation.
+Read-only commands (`list-posts`, `get-post`, `feed`, `list-topics`, `list-topic-posts`, `get`, `list-channels`, `get-channel`, `list-channel-members`) run without confirmation.
 
 ## Reference Documentation
 

package/skills/gobi-space/references/global.md

@@ -18,6 +18,8 @@ Commands:
   create-reply [options] <postId>  Create a reply to a post in the global feed.
   edit-reply [options] <replyId>   Edit a reply you authored in the global feed.
   delete-reply <replyId>           Delete a reply you authored in the global feed.
+  react <postId> <emoji>           Add an emoji reaction to a global-feed post or reply (idempotent). <postId> is the numeric id of a post OR a reply — the [p:N]/[r:N] ids shown in feed output.
+  unreact <postId> <emoji>         Remove your emoji reaction from a global-feed post or reply. <postId> is the numeric id of a post OR a reply.
   help [command]                   display help for command
 ```
 
@@ -75,7 +77,8 @@ Options:
   --content <content>        Post content (markdown supported, use "-" for stdin)
   --rich-text <richText>     Rich-text JSON array (mutually exclusive with --content)
   --artifact <artifactId>    Attach an existing artifact to the post (repeatable). Create artifacts with `gobi artifact create`. (default: [])
-  --attach <file>            Local media file to attach. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. (default: [])
+  --attach <file>            Local media or document file to attach. Repeatable. Mix rule: up to 4 photos + up to 4 document files (pdf/md/txt/csv) OR 1 GIF OR 1 video. Size ceilings: 10MB photos /
+                             15MB GIFs / 512MB video / 250MB files. (default: [])
   --repost-post-id <postId>  Wrap an existing top-level post as the embedded card on this new post. Composes with --content / --rich-text / --attach (the wrapping author's text + media render above
                              the embedded card). Reposts-of-reposts are collapsed to the transitive root server-side. The referenced post must exist, not be deleted, and not itself be a reply.
   -h, --help                 display help for command
@@ -92,8 +95,8 @@ Options:
   --title <title>          New title
   --content <content>      New content (markdown supported, use "-" for stdin)
   --rich-text <richText>   Rich-text JSON array (mutually exclusive with --content)
-  --attach <file>          Replace the post's media attachments with the given files (existing attachments are removed). Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size
-                           ceilings: 5MB photos / 15MB GIFs / 512MB video. Omit to leave attachments unchanged. (default: [])
+  --attach <file>          Replace the post's media attachments with the given files (existing attachments are removed). Repeatable. Mix rule: up to 4 photos + up to 4 document files (pdf/md/txt/csv)
+                           OR 1 GIF OR 1 video. Size ceilings: 10MB photos / 15MB GIFs / 512MB video / 250MB files. Omit to leave attachments unchanged. (default: [])
   --artifact <artifactId>  Replace the post's artifact attachments with the given artifact(s) (existing artifact attachments are removed). Repeatable. Omit to leave them unchanged. Create artifacts
                            with `gobi artifact create`. (default: [])
   -h, --help               display help for command
@@ -120,8 +123,8 @@ Create a reply to a post in the global feed.
 Options:
   --content <content>     Reply content (markdown supported, use "-" for stdin)
   --rich-text <richText>  Rich-text JSON array (mutually exclusive with --content)
-  --attach <file>         Local media file to attach to this reply. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. (default:
-                          [])
+  --attach <file>         Local media or document file to attach to this reply. Repeatable. Mix rule: up to 4 photos + up to 4 document files (pdf/md/txt/csv) OR 1 GIF OR 1 video. Size ceilings: 10MB
+                          photos / 15MB GIFs / 512MB video / 250MB files. (default: [])
   -h, --help              display help for command
 ```
 
@@ -148,3 +151,25 @@ Delete a reply you authored in the global feed.
 Options:
   -h, --help  display help for command
 ```
+
+## react
+
+```
+Usage: gobi global react [options] <postId> <emoji>
+
+Add an emoji reaction to a global-feed post or reply (idempotent). <postId> is the numeric id of a post OR a reply — the [p:N]/[r:N] ids shown in feed output.
+
+Options:
+  -h, --help  display help for command
+```
+
+## unreact
+
+```
+Usage: gobi global unreact [options] <postId> <emoji>
+
+Remove your emoji reaction from a global-feed post or reply. <postId> is the numeric id of a post OR a reply.
+
+Options:
+  -h, --help  display help for command
+```

package/skills/gobi-space/references/personal.md

@@ -19,6 +19,8 @@ Commands:
   create-reply [options] <postId>  Reply to a personal-space post. The reply inherits the parent's private scope automatically.
   edit-reply [options] <replyId>   Edit a reply you authored in your personal space.
   delete-reply <replyId>           Delete a reply you authored in your personal space.
+  react <postId> <emoji>           Add an emoji reaction to a personal-space post or reply (idempotent). <postId> is the numeric id of a post OR a reply.
+  unreact <postId> <emoji>         Remove your emoji reaction from a personal-space post or reply. <postId> is the numeric id of a post OR a reply.
   help [command]                   display help for command
 ```
 
@@ -74,7 +76,8 @@ Options:
   --content <content>        Post content (markdown supported, use "-" for stdin)
   --rich-text <richText>     Rich-text JSON array (mutually exclusive with --content)
   --artifact <artifactId>    Attach an existing artifact to the post (repeatable). Create artifacts with `gobi artifact create`. (default: [])
-  --attach <file>            Local media file to attach. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. (default: [])
+  --attach <file>            Local media or document file to attach. Repeatable. Mix rule: up to 4 photos + up to 4 document files (pdf/md/txt/csv) OR 1 GIF OR 1 video. Size ceilings: 10MB photos /
+                             15MB GIFs / 512MB video / 250MB files. (default: [])
   --repost-post-id <postId>  Wrap an existing top-level post as the embedded card on this new private post. The referenced post must be visible to you (your own personal-space post, a global-feed
                              post, or a post in a space you're a member of). Reposting someone else's personal-space post returns 404.
   -h, --help                 display help for command
@@ -91,8 +94,8 @@ Options:
   --title <title>          New title
   --content <content>      New content (markdown supported, use "-" for stdin)
   --rich-text <richText>   Rich-text JSON array (mutually exclusive with --content)
-  --attach <file>          Replace the post's media attachments with the given files (existing attachments are removed). Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size
-                           ceilings: 5MB photos / 15MB GIFs / 512MB video. Omit to leave attachments unchanged. (default: [])
+  --attach <file>          Replace the post's media attachments with the given files (existing attachments are removed). Repeatable. Mix rule: up to 4 photos + up to 4 document files (pdf/md/txt/csv)
+                           OR 1 GIF OR 1 video. Size ceilings: 10MB photos / 15MB GIFs / 512MB video / 250MB files. Omit to leave attachments unchanged. (default: [])
   --artifact <artifactId>  Replace the post's artifact attachments with the given artifact(s) (existing artifact attachments are removed). Repeatable. Omit to leave them unchanged. Create artifacts
                            with `gobi artifact create`. (default: [])
   -h, --help               display help for command
@@ -119,8 +122,8 @@ Reply to a personal-space post. The reply inherits the parent's private scope au
 Options:
   --content <content>     Reply content (markdown supported, use "-" for stdin)
   --rich-text <richText>  Rich-text JSON array (mutually exclusive with --content)
-  --attach <file>         Local media file to attach to this reply. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. (default:
-                          [])
+  --attach <file>         Local media or document file to attach to this reply. Repeatable. Mix rule: up to 4 photos + up to 4 document files (pdf/md/txt/csv) OR 1 GIF OR 1 video. Size ceilings: 10MB
+                          photos / 15MB GIFs / 512MB video / 250MB files. (default: [])
   -h, --help              display help for command
 ```
 
@@ -147,3 +150,25 @@ Delete a reply you authored in your personal space.
 Options:
   -h, --help  display help for command
 ```
+
+## react
+
+```
+Usage: gobi personal react [options] <postId> <emoji>
+
+Add an emoji reaction to a personal-space post or reply (idempotent). <postId> is the numeric id of a post OR a reply.
+
+Options:
+  -h, --help  display help for command
+```
+
+## unreact
+
+```
+Usage: gobi personal unreact [options] <postId> <emoji>
+
+Remove your emoji reaction from a personal-space post or reply. <postId> is the numeric id of a post OR a reply.
+
+Options:
+  -h, --help  display help for command
+```