@gobi-ai/cli 2.0.30 → 2.0.32

package/dist/commands/space.js

@@ -1,7 +1,7 @@
 import { WEB_BASE_URL } from "../constants.js";
-import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
+import { apiGet, apiPost, apiPatch, apiPut, apiDelete } from "../client.js";
 import { requireSpace, selectSpace, setSpaceRequirement, writeSpaceSetting, } from "./init.js";
-import { isJsonMode, jsonOut, readStdin, resolveSpaceSlug, unwrapResp, } from "./utils.js";
+import { formatAttachmentLines, formatAttachmentSummary, formatReactionChips, isJsonMode, jsonOut, readStdin, resolveSpaceSlug, unwrapResp, } from "./utils.js";
 import { uploadPostAttachments, assertPostAttachmentMix, } from "../attachments.js";
 function readContent(value) {
     if (value === "-")
@@ -23,7 +23,20 @@ function formatFeedLine(m) {
     else {
         label = m.title || m.content || "";
     }
-    return `${id} ${kind} ${author}  "${label}"  ${m.createdAt}`;
+    const chips = formatReactionChips(m);
+    const attachSummary = formatAttachmentSummary(m);
+    return (`${id} ${kind} ${author}  "${label}"  ${m.createdAt}` +
+        (attachSummary ? `  ${attachSummary}` : "") +
+        (chips ? `  ${chips}` : ""));
+}
+function parseChannelIdOption(value) {
+    if (value == null)
+        return undefined;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n <= 0) {
+        throw new Error("--channel must be a positive integer channel id.");
+    }
+    return n;
 }
 export function registerSpaceCommand(program) {
     const space = program
@@ -179,6 +192,7 @@ export function registerSpaceCommand(program) {
         .description("List the unified feed (posts and replies, newest first) in a space.")
         .option("--limit <number>", "Items per page", "20")
         .option("--cursor <string>", "Pagination cursor from previous response")
+        .option("--channel <channelId>", "Channel id to read instead of the main feed (see `list-channels`). Omit for the main feed.")
         .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .action(async (opts) => {
         const spaceSlug = resolveSpaceSlug(space, opts);
@@ -187,6 +201,7 @@ export function registerSpaceCommand(program) {
         };
         if (opts.cursor)
             params.cursor = opts.cursor;
+        params.channelId = parseChannelIdOption(opts.channel);
         const resp = (await apiGet(`/spaces/${spaceSlug}/feed`, params));
         if (isJsonMode(space)) {
             jsonOut({
@@ -205,6 +220,44 @@ export function registerSpaceCommand(program) {
         const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
         console.log(`Feed (${items.length} items, newest first):\n` + lines.join("\n") + footer);
     });
+    // ── Search ──
+    space
+        .command("search-posts <query>")
+        .description("Search a space's posts and replies (newest first). The query supports keywords " +
+        'plus from:<name> and topic:<tag> operators (quote multi-word values, e.g. from:"Jane Doe"). ' +
+        "Each result is an individual post or reply, not a whole thread.")
+        .option("--limit <number>", "Items per page", "20")
+        .option("--cursor <string>", "Pagination cursor from previous response")
+        .option("--channel <channelId>", "Restrict results to one channel (see `list-channels`). Omit to search the main feed and all channels visible to you.")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
+        .action(async (query, opts) => {
+        const spaceSlug = resolveSpaceSlug(space, opts);
+        const params = {
+            q: query,
+            limit: parseInt(opts.limit, 10),
+        };
+        if (opts.cursor)
+            params.cursor = opts.cursor;
+        params.channelId = parseChannelIdOption(opts.channel);
+        const resp = (await apiGet(`/spaces/${spaceSlug}/search`, params));
+        if (isJsonMode(space)) {
+            jsonOut({
+                items: resp.data || [],
+                pagination: resp.pagination || {},
+                mentions: resp.mentions || {},
+            });
+            return;
+        }
+        const items = (resp.data || []);
+        const pagination = (resp.pagination || {});
+        if (!items.length) {
+            console.log("No results found.");
+            return;
+        }
+        const lines = items.map(formatFeedLine);
+        const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
+        console.log(`Search results (${items.length} items, newest first):\n` + lines.join("\n") + footer);
+    });
     // ── Posts (get, list, create, edit, delete) ──
     space
         .command("get-post <postId>")
@@ -251,20 +304,28 @@ export function registerSpaceCommand(program) {
             const body = opts.full || !text || text.length <= 200
                 ? text
                 : text.slice(0, 200) + "…";
-            replyLines.push(`  - ${rAuthor}: ${body} (${r.createdAt})`);
+            const rChips = formatReactionChips(r);
+            const rAttach = formatAttachmentSummary(r);
+            replyLines.push(`  - [r:${r.id}] ${rAuthor}: ${body} (${r.createdAt})${rAttach ? `  ${rAttach}` : ""}${rChips ? `  ${rChips}` : ""}`);
         }
         const isReplyPost = post.parentPostId != null;
         const heading = isReplyPost
             ? `Reply [r:${post.id}]`
             : `Post: ${post.title || "(no title)"}`;
+        const postChips = formatReactionChips(post);
+        const attachmentLines = formatAttachmentLines(post);
         const output = [
             heading,
             `By: ${author} on ${post.createdAt}`,
+            ...(postChips ? [`Reactions: ${postChips}`] : []),
             ...(ancestorLines.length
                 ? ["", `Ancestors (${ancestors.length} items, root first):`, ...ancestorLines]
                 : []),
             "",
             post.content || "",
+            ...(attachmentLines.length
+                ? ["", `Attachments (${attachmentLines.length}):`, ...attachmentLines]
+                : []),
             "",
             `Replies (${replies.length} items):`,
             ...replyLines,
@@ -277,6 +338,7 @@ export function registerSpaceCommand(program) {
         .description("List posts in a space (paginated).")
         .option("--limit <number>", "Items per page", "20")
         .option("--cursor <string>", "Pagination cursor from previous response")
+        .option("--channel <channelId>", "Channel id to read instead of the main feed (see `list-channels`). Omit for the main feed.")
         .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .action(async (opts) => {
         const spaceSlug = resolveSpaceSlug(space, opts);
@@ -285,6 +347,7 @@ export function registerSpaceCommand(program) {
         };
         if (opts.cursor)
             params.cursor = opts.cursor;
+        params.channelId = parseChannelIdOption(opts.channel);
         const resp = (await apiGet(`/spaces/${spaceSlug}/posts`, params));
         if (isJsonMode(space)) {
             jsonOut({
@@ -304,7 +367,8 @@ export function registerSpaceCommand(program) {
         for (const t of items) {
             const author = t.author?.name ||
                 `User ${t.authorId}`;
-            lines.push(`- [${t.id}] "${t.title}" by ${author} (${t.replyCount} replies, ${t.createdAt})`);
+            const attachSummary = formatAttachmentSummary(t);
+            lines.push(`- [${t.id}] "${t.title}" by ${author} (${t.replyCount} replies, ${t.createdAt})${attachSummary ? `  ${attachSummary}` : ""}`);
         }
         const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
         console.log(`Posts (${items.length} items):\n` + lines.join("\n") + footer);
@@ -317,8 +381,9 @@ export function registerSpaceCommand(program) {
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
         .option("--artifact <artifactId>", "Attach an existing artifact to the post (repeatable). Create artifacts with `gobi artifact create`.", (value, prev = []) => [...prev, value], [])
         .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
-        .option("--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.", (value, prev = []) => [...prev, value], [])
+        .option("--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.", (value, prev = []) => [...prev, value], [])
         .option("--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.")
+        .option("--channel <channelId>", "Channel id to post into (see `list-channels`). Omit to post to the space's main feed. You must be able to see the channel (member, space owner/admin, or the space agent on an agent-enabled channel).")
         .action(async (opts) => {
         if (!opts.content && !opts.richText) {
             throw new Error("Provide either --content or --rich-text.");
@@ -355,6 +420,9 @@ export function registerSpaceCommand(program) {
             }
             body.repostPostId = n;
         }
+        const channelId = parseChannelIdOption(opts.channel);
+        if (channelId != null)
+            body.channelId = channelId;
         const spaceSlug = resolveSpaceSlug(space, opts);
         const resp = (await apiPost(`/spaces/${spaceSlug}/posts`, body));
         const post = unwrapResp(resp);
@@ -376,7 +444,7 @@ export function registerSpaceCommand(program) {
         .option("--content <content>", "New content for the post (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
         .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
-        .option("--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.", (value, prev = []) => [...prev, value], [])
+        .option("--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.", (value, prev = []) => [...prev, value], [])
         .option("--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`.", (value, prev = []) => [...prev, value], [])
         .action(async (postId, opts) => {
         const wantsAttachChange = !!(opts.attach && opts.attach.length > 0);
@@ -445,7 +513,7 @@ export function registerSpaceCommand(program) {
         .option("--content <content>", "Reply content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
         .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
-        .option("--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.", (value, prev = []) => [...prev, value], [])
+        .option("--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.", (value, prev = []) => [...prev, value], [])
         .action(async (postId, opts) => {
         if (!opts.content && !opts.richText) {
             throw new Error("Provide either --content or --rich-text.");
@@ -530,4 +598,113 @@ export function registerSpaceCommand(program) {
         }
         console.log(`Reply ${replyId} deleted.`);
     });
+    // ── Reactions (react, unreact) ──
+    space
+        .command("react <postId> <emoji>")
+        .description("Add an emoji reaction to a 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.")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
+        .action(async (postId, emoji, opts) => {
+        const spaceSlug = resolveSpaceSlug(space, opts);
+        const resp = (await apiPut(`/spaces/${spaceSlug}/posts/${postId}/reactions`, { emoji }));
+        const data = unwrapResp(resp);
+        if (isJsonMode(space)) {
+            jsonOut(data);
+            return;
+        }
+        const chips = formatReactionChips(data);
+        console.log(`Reacted ${emoji} to ${postId}.` + (chips ? `\n  Now: ${chips}` : ""));
+    });
+    space
+        .command("unreact <postId> <emoji>")
+        .description("Remove your emoji reaction from a post or reply. <postId> is the numeric id of a post OR a reply.")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
+        .action(async (postId, emoji, opts) => {
+        const spaceSlug = resolveSpaceSlug(space, opts);
+        const resp = (await apiDelete(`/spaces/${spaceSlug}/posts/${postId}/reactions/${encodeURIComponent(emoji)}`));
+        const data = unwrapResp(resp);
+        if (isJsonMode(space)) {
+            jsonOut(data);
+            return;
+        }
+        const chips = formatReactionChips(data);
+        console.log(`Removed ${emoji} reaction from ${postId}.` +
+            (chips ? `\n  Now: ${chips}` : ""));
+    });
+    // ── Channels (read-only; channel admin is web-UI only) ──
+    //
+    // Private member-gated sub-feeds inside a space. The main feed is virtual
+    // (no channel row): feed/list-posts/create-post without --channel target
+    // it. Members see their channels; space owners/admins see all; the space
+    // agent sees agent-enabled channels only. Create/rename/delete and roster
+    // management are deliberately not exposed here — like space and member
+    // admin, that's web-UI territory.
+    space
+        .command("list-channels")
+        .description("List channels visible to you in a space (members: yours; space owner/admin: all). The main feed is not a channel — read it by omitting --channel on `feed`.")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
+        .action(async (opts) => {
+        const spaceSlug = resolveSpaceSlug(space, opts);
+        const resp = (await apiGet(`/spaces/${spaceSlug}/channels`));
+        const items = (resp.data || []);
+        if (isJsonMode(space)) {
+            jsonOut(items);
+            return;
+        }
+        if (!items.length) {
+            console.log("No channels found.");
+            return;
+        }
+        const lines = [];
+        for (const c of items) {
+            const flags = [
+                `${c.memberCount} member${c.memberCount === 1 ? "" : "s"}`,
+                c.isMember ? "member: you" : "member: no",
+                c.agentAccess ? "agent: on" : "agent: off",
+            ].join(", ");
+            lines.push(`- [${c.id}] #${c.name} (${flags})`);
+            if (c.description)
+                lines.push(`    Description: ${c.description}`);
+        }
+        console.log(`Channels (${items.length}):\n` + lines.join("\n"));
+    });
+    space
+        .command("get-channel <channelId>")
+        .description("Get one channel (channel members, space owner/admin, or the agent on agent-enabled channels).")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
+        .action(async (channelId, opts) => {
+        const spaceSlug = resolveSpaceSlug(space, opts);
+        const resp = (await apiGet(`/spaces/${spaceSlug}/channels/${channelId}`));
+        const c = unwrapResp(resp);
+        if (isJsonMode(space)) {
+            jsonOut(c);
+            return;
+        }
+        const desc = c.description ? `\n  Description: ${c.description}` : "";
+        console.log(`Channel [${c.id}] #${c.name}${desc}\n` +
+            `  Agent access: ${c.agentAccess ? "on" : "off"}\n` +
+            `  Created: ${c.createdAt}`);
+    });
+    space
+        .command("list-channel-members <channelId>")
+        .description("List the members of a channel.")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
+        .action(async (channelId, opts) => {
+        const spaceSlug = resolveSpaceSlug(space, opts);
+        const resp = (await apiGet(`/spaces/${spaceSlug}/channels/${channelId}/members`));
+        const items = (resp.data || []);
+        if (isJsonMode(space)) {
+            jsonOut(items);
+            return;
+        }
+        if (!items.length) {
+            console.log("No members found.");
+            return;
+        }
+        const lines = [];
+        for (const m of items) {
+            const user = (m.user || {});
+            lines.push(`- [${m.userId}] ${user.name || "Unknown"} (joined ${m.createdAt})`);
+        }
+        console.log(`Channel members (${items.length}):\n` + lines.join("\n"));
+    });
 }

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobi-ai/cli",
-  "version": "2.0.30",
+  "version": "2.0.32",
   "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.30"
+  version: "2.0.32"
 ---
 
 # gobi-artifact
 
-Gobi artifact commands for versioned, post-attachable creations (v2.0.30).
+Gobi artifact commands for versioned, post-attachable creations (v2.0.32).
 
 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.30"
+  version: "2.0.32"
 ---
 
 # gobi-core
 
-Core CLI commands for the Gobi collaborative knowledge platform (v2.0.30).
+Core CLI commands for the Gobi collaborative knowledge platform (v2.0.32).
 
 ## 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.30"
+  version: "2.0.32"
 ---
 
 # Gobi Homepage Developer Guide

package/skills/gobi-media/SKILL.md

@@ -10,12 +10,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.30"
+  version: "2.0.32"
 ---
 
 # gobi-media
 
-Gobi media generation commands (v2.0.30).
+Gobi media generation commands (v2.0.32).
 
 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.30"
+  version: "2.0.32"
 ---
 
 # gobi-sense
 
-Gobi sense commands for activity and transcription data (v2.0.30).
+Gobi sense commands for activity and transcription data (v2.0.32).
 
 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.30"
+  version: "2.0.32"
 ---
 
 # gobi-space
 
-Gobi space, global, and personal-space posts (v2.0.30).
+Gobi space, global, and personal-space posts (v2.0.32).
 
 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,11 @@ 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.
+
+### Search
+- `gobi space search-posts <query>` — Search a space's posts **and** replies, newest first. The query supports free-text keywords plus `from:<name>` (author) and `topic:<tag>` operators; quote multi-word values (`from:"Jane Doe"`). Each result is an individual post or reply, not a whole thread. `--channel <channelId>` restricts results to one channel; omit to search the main feed and every channel visible to you.
+- `gobi personal search-posts <query>` — Same query syntax over your private personal-space posts and replies. There is no `gobi global` search.
 
 ### Space posts
 - `gobi space list-posts` — List posts in a space (paginated).
@@ -120,6 +126,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.
@@ -141,6 +163,7 @@ gobi --json space list-posts
 A couple of read-side flags don't mirror — `personal feed` has no `--following` (there's no follow graph in a private space), and `personal list-posts` has no `--mine` (everything in the personal space is already yours).
 
 - `gobi personal feed` — Your personal-space feed (posts and replies, newest first).
+- `gobi personal search-posts <query>` — Search your personal-space posts and replies (same `from:` / `topic:` query syntax as `gobi space search-posts`).
 - `gobi personal list-posts` — List your personal-space posts.
 - `gobi personal get-post <postId>` — Get a personal-space post with its ancestors and replies.
 - `gobi personal create-post` — Create a private personal-space post. Same flags as `gobi global create-post` (`--artifact`, `--repost-post-id`, `--attach`).
@@ -157,8 +180,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`, `search-posts`, `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
+```