@gobi-ai/cli 2.0.29 → 2.0.31

package/.claude-plugin/marketplace.json

@@ -4,12 +4,12 @@
     "name": "gobi-ai"
   },
   "description": "Claude Code plugin for the Gobi collaborative knowledge platform CLI",
-  "version": "2.0.29",
+  "version": "2.0.31",
   "plugins": [
     {
       "name": "gobi",
       "description": "Manage the Gobi collaborative knowledge platform from the command line. Publish vault profiles, create posts and replies, generate images and videos.",
-      "version": "2.0.29",
+      "version": "2.0.31",
       "author": {
         "name": "gobi-ai"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gobi",
   "description": "Manage the Gobi collaborative knowledge platform from the command line",
-  "version": "2.0.29",
+  "version": "2.0.31",
   "author": {
     "name": "gobi-ai"
   },

package/dist/attachments.js

@@ -4,10 +4,13 @@ import { basename, join, extname, isAbsolute, resolve } from "path";
 import ignore from "ignore";
 import { WEBDRIVE_BASE_URL } from "./constants.js";
 import { apiPost } from "./client.js";
+import { normalizeSyncPattern } from "./commands/sync.js";
 // Best-effort extension → MIME mapping. Anything we don't recognize falls
 // back to `application/octet-stream`; the backend caps size per content-type
-// tier (5MB photos / 15MB GIFs / 512MB video) so it's the authority on what's
-// allowed. We're just trying to set a usable Content-Type for the S3 PUT.
+// tier (10MB photos / 15MB GIFs / 512MB video / 250MB document files) so
+// it's the authority on what's allowed. We're just trying to set a usable
+// Content-Type for the S3 PUT — and for document files the declared MIME is
+// what routes the post row into the 'file' kind, so it must be accurate.
 const POST_MEDIA_MIME_MAP = {
     ".jpg": "image/jpeg",
     ".jpeg": "image/jpeg",
@@ -25,20 +28,30 @@ const POST_MEDIA_MIME_MAP = {
     ".webm": "video/webm",
     ".m4v": "video/x-m4v",
     ".pdf": "application/pdf",
+    ".md": "text/markdown",
+    ".markdown": "text/markdown",
+    ".txt": "text/plain",
+    ".csv": "text/csv",
 };
-// X-style cap: 4 photos OR 1 GIF OR 1 video. Anything not photo/gif/video
-// is treated as "photo" for cap purposes so misclassified files still get
-// the 4-cap rather than slipping through unlimited.
+const FILE_EXTENSIONS = [".pdf", ".md", ".markdown", ".txt", ".csv"];
+const VIDEO_EXTENSIONS = [".mp4", ".mov", ".webm", ".m4v"];
+// Mirrors the backend mix rule: up to 4 photos + up to 4 document files
+// (pdf/md/txt/csv) together, OR 1 GIF, OR 1 video — GIF and video are
+// exclusive with everything. Unknown extensions count against the photo cap
+// (the backend's 'other' kind) so nothing slips through unlimited.
 export function assertPostAttachmentMix(paths) {
     let photos = 0;
     let gifs = 0;
     let videos = 0;
+    let files = 0;
     for (const p of paths) {
         const ext = extname(p).toLowerCase();
         if (ext === ".gif")
             gifs += 1;
-        else if ([".mp4", ".mov", ".webm", ".m4v"].includes(ext))
+        else if (VIDEO_EXTENSIONS.includes(ext))
             videos += 1;
+        else if (FILE_EXTENSIONS.includes(ext))
+            files += 1;
         else
             photos += 1;
     }
@@ -48,10 +61,12 @@ export function assertPostAttachmentMix(paths) {
         throw new Error("Only 1 GIF allowed per post");
     if (photos > 4)
         throw new Error("Up to 4 photos allowed per post");
-    if (videos > 0 && (gifs > 0 || photos > 0)) {
+    if (files > 4)
+        throw new Error("Up to 4 files allowed per post");
+    if (videos > 0 && (gifs > 0 || photos > 0 || files > 0)) {
         throw new Error("A video can't be combined with other media");
     }
-    if (gifs > 0 && (videos > 0 || photos > 0)) {
+    if (gifs > 0 && (videos > 0 || photos > 0 || files > 0)) {
         throw new Error("A GIF can't be combined with other media");
     }
 }
@@ -89,7 +104,15 @@ export async function uploadPostAttachment(filePath) {
     if (!putRes.ok) {
         throw new Error(`Failed to PUT ${filePath} to S3: HTTP ${putRes.status}`);
     }
-    return { mediaUrl, mediaKey };
+    const attachment = { mediaUrl, mediaKey };
+    // Document files carry name + MIME on the row: the declared mimeType is
+    // what the backend trusts for kind/preview routing, and the original
+    // filename only survives here (the S3 key is a UUID).
+    if (FILE_EXTENSIONS.includes(ext)) {
+        attachment.fileName = basename(abs);
+        attachment.mimeType = contentType;
+    }
+    return attachment;
 }
 export async function uploadPostAttachments(paths) {
     const out = [];
@@ -129,8 +152,9 @@ function addToLocalSyncfiles(gobiDir, filePath) {
     if (isPathCovered(filePath, patterns))
         return;
     const syncfilesPath = join(gobiDir, "syncfiles");
-    appendFileSync(syncfilesPath, `${EOL}${filePath}`);
-    console.log(`Added to syncfiles: ${filePath}`);
+    const pattern = normalizeSyncPattern(filePath);
+    appendFileSync(syncfilesPath, `${EOL}${pattern}`);
+    console.log(`Added to syncfiles: ${pattern}`);
 }
 export async function uploadAttachments(vaultSlug, links, token, options) {
     const addToSyncfiles = options?.addToSyncfiles ?? false;

package/dist/client.js

@@ -38,6 +38,9 @@ export function apiPost(path, body) {
 export function apiPatch(path, body) {
     return request("PATCH", path, { body });
 }
+export function apiPut(path, body) {
+    return request("PUT", path, { body });
+}
 export function apiDelete(path) {
     return request("DELETE", path);
 }

package/dist/commands/global.js

@@ -1,6 +1,6 @@
 import { WEB_BASE_URL } from "../constants.js";
-import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
-import { isJsonMode, jsonOut, readStdin, unwrapResp, } from "./utils.js";
+import { apiGet, apiPost, apiPatch, apiPut, apiDelete } from "../client.js";
+import { formatAttachmentLines, formatAttachmentSummary, formatReactionChips, isJsonMode, jsonOut, readStdin, unwrapResp, } from "./utils.js";
 import { uploadPostAttachments, assertPostAttachmentMix, } from "../attachments.js";
 function readContent(value) {
     if (value === "-")
@@ -26,7 +26,11 @@ 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}` : ""));
 }
 export function registerGlobalCommand(program) {
     const global = program
@@ -145,20 +149,28 @@ export function registerGlobalCommand(program) {
                 `User ${r.authorId}`;
             const text = r.content || "";
             const truncated = opts.full || text.length <= 200 ? text : text.slice(0, 200) + "…";
-            replyLines.push(`  - ${rAuthor}: ${truncated} (${r.createdAt})`);
+            const rChips = formatReactionChips(r);
+            const rAttach = formatAttachmentSummary(r);
+            replyLines.push(`  - [r:${r.id}] ${rAuthor}: ${truncated} (${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,
@@ -176,7 +188,7 @@ export function registerGlobalCommand(program) {
         .option("--content <content>", "Post content (markdown supported, use \"-\" for stdin)")
         .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("--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.")
         .action(async (opts) => {
         if (!opts.content && !opts.richText) {
@@ -234,7 +246,7 @@ export function registerGlobalCommand(program) {
         .option("--title <title>", "New title")
         .option("--content <content>", "New content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
-        .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);
@@ -297,7 +309,7 @@ export function registerGlobalCommand(program) {
         .description("Create a reply to a post in the global feed.")
         .option("--content <content>", "Reply content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
-        .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.");
@@ -376,4 +388,34 @@ export function registerGlobalCommand(program) {
         }
         console.log(`Reply ${replyId} deleted.`);
     });
+    // ── Reactions (react, unreact) ──
+    global
+        .command("react <postId> <emoji>")
+        .description("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.")
+        .action(async (postId, emoji) => {
+        const resp = (await apiPut(`/posts/${postId}/reactions`, {
+            emoji,
+        }));
+        const data = unwrapResp(resp);
+        if (isJsonMode(global)) {
+            jsonOut(data);
+            return;
+        }
+        const chips = formatReactionChips(data);
+        console.log(`Reacted ${emoji} to ${postId}.` + (chips ? `\n  Now: ${chips}` : ""));
+    });
+    global
+        .command("unreact <postId> <emoji>")
+        .description("Remove your emoji reaction from a global-feed post or reply. <postId> is the numeric id of a post OR a reply.")
+        .action(async (postId, emoji) => {
+        const resp = (await apiDelete(`/posts/${postId}/reactions/${encodeURIComponent(emoji)}`));
+        const data = unwrapResp(resp);
+        if (isJsonMode(global)) {
+            jsonOut(data);
+            return;
+        }
+        const chips = formatReactionChips(data);
+        console.log(`Removed ${emoji} reaction from ${postId}.` +
+            (chips ? `\n  Now: ${chips}` : ""));
+    });
 }

package/dist/commands/init.js

@@ -31,6 +31,15 @@ export function getVaultSlug() {
     }
     return vault;
 }
+/**
+ * Starter PUBLISH.md frontmatter. Shared by `vault init` (seed) and
+ * `vault publish` (scaffold-on-missing) so the two paths can't drift.
+ * `description` is intentionally left blank — the vault won't list publicly
+ * until the user fills in both `title` and `description`.
+ */
+export function defaultPublishMd(title) {
+    return `---\ntitle: ${title}\ntags: []\ndescription:\nthumbnail:\nprompt:\n---\n`;
+}
 // Per-command requirement markers. Tri-state: true / false override / inherit
 // from parent. The pre-action warning uses these to decide whether to remind
 // the user to run `gobi vault init` / `gobi space warp`.
@@ -221,7 +230,7 @@ export async function runVaultInitFlow() {
     // Create default PUBLISH.md if it doesn't exist
     const publishPath = join(process.cwd(), "PUBLISH.md");
     if (!existsSync(publishPath)) {
-        writeFileSync(publishPath, `---\ntitle: ${vaultName}\ntags: []\ndescription:\nthumbnail:\nprompt:\n---\n`, "utf-8");
+        writeFileSync(publishPath, defaultPublishMd(vaultName), "utf-8");
         console.log("Created PUBLISH.md");
     }
 }

package/dist/commands/personal.js

@@ -1,5 +1,5 @@
-import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
-import { isJsonMode, jsonOut, readStdin, unwrapResp, } from "./utils.js";
+import { apiGet, apiPost, apiPatch, apiPut, apiDelete } from "../client.js";
+import { formatAttachmentLines, formatAttachmentSummary, formatReactionChips, isJsonMode, jsonOut, readStdin, unwrapResp, } from "./utils.js";
 import { uploadPostAttachments, assertPostAttachmentMix, } from "../attachments.js";
 function readContent(value) {
     if (value === "-")
@@ -22,7 +22,11 @@ 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}` : ""));
 }
 export function registerPersonalCommand(program) {
     const personal = program
@@ -147,20 +151,28 @@ export function registerPersonalCommand(program) {
                 `User ${r.authorId}`;
             const text = r.content || "";
             const truncated = opts.full || text.length <= 200 ? text : text.slice(0, 200) + "…";
-            replyLines.push(`  - ${rAuthor}: ${truncated} (${r.createdAt})`);
+            const rChips = formatReactionChips(r);
+            const rAttach = formatAttachmentSummary(r);
+            replyLines.push(`  - [r:${r.id}] ${rAuthor}: ${truncated} (${r.createdAt})${rAttach ? `  ${rAttach}` : ""}${rChips ? `  ${rChips}` : ""}`);
         }
         const isReplyPost = post.parentPostId != null;
         const heading = isReplyPost
             ? `Reply [r:${post.id}] (private)`
             : `Post: ${post.title || "(no title)"} (private)`;
+        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,
@@ -184,7 +196,7 @@ export function registerPersonalCommand(program) {
         .option("--content <content>", "Post content (markdown supported, use \"-\" for stdin)")
         .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("--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 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.")
         .action(async (opts) => {
         if (!opts.content && !opts.richText) {
@@ -245,7 +257,7 @@ export function registerPersonalCommand(program) {
         .option("--title <title>", "New title")
         .option("--content <content>", "New content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
-        .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);
@@ -313,7 +325,7 @@ export function registerPersonalCommand(program) {
         .description("Reply to a personal-space post. The reply inherits the parent's private scope automatically.")
         .option("--content <content>", "Reply content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
-        .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.");
@@ -392,4 +404,34 @@ export function registerPersonalCommand(program) {
         }
         console.log(`Reply ${replyId} deleted.`);
     });
+    // ── Reactions (react, unreact) ──
+    personal
+        .command("react <postId> <emoji>")
+        .description("Add an emoji reaction to a personal-space post or reply (idempotent). <postId> is the numeric id of a post OR a reply.")
+        .action(async (postId, emoji) => {
+        const resp = (await apiPut(`/posts/${postId}/reactions`, {
+            emoji,
+        }));
+        const data = unwrapResp(resp);
+        if (isJsonMode(personal)) {
+            jsonOut(data);
+            return;
+        }
+        const chips = formatReactionChips(data);
+        console.log(`Reacted ${emoji} to ${postId}.` + (chips ? `\n  Now: ${chips}` : ""));
+    });
+    personal
+        .command("unreact <postId> <emoji>")
+        .description("Remove your emoji reaction from a personal-space post or reply. <postId> is the numeric id of a post OR a reply.")
+        .action(async (postId, emoji) => {
+        const resp = (await apiDelete(`/posts/${postId}/reactions/${encodeURIComponent(emoji)}`));
+        const data = unwrapResp(resp);
+        if (isJsonMode(personal)) {
+            jsonOut(data);
+            return;
+        }
+        const chips = formatReactionChips(data);
+        console.log(`Removed ${emoji} reaction from ${postId}.` +
+            (chips ? `\n  Now: ${chips}` : ""));
+    });
 }

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({
@@ -251,20 +266,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 +300,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 +309,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 +329,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 +343,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 +382,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 +406,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 +475,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 +560,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"));
+    });
 }