@gobi-ai/cli 0.9.13 → 1.1.0

package/.claude-plugin/marketplace.json

@@ -4,12 +4,12 @@
     "name": "gobi-ai"
   },
   "description": "Claude Code plugin for the Gobi collaborative knowledge platform CLI",
-  "version": "0.9.13",
+  "version": "1.1.0",
   "plugins": [
     {
       "name": "gobi",
-      "description": "Manage the Gobi collaborative knowledge platform from the command line. Search and ask brains, publish brain documents, create threads, manage sessions, generate images and videos.",
-      "version": "0.9.13",
+      "description": "Manage the Gobi collaborative knowledge platform from the command line. Search and ask vaults, publish vault documents, create threads, manage sessions, generate images and videos.",
+      "version": "1.1.0",
       "author": {
         "name": "gobi-ai"
       },
@@ -18,7 +18,7 @@
       "skills": [
         "./skills/gobi-core",
         "./skills/gobi-space",
-        "./skills/gobi-brain",
+        "./skills/gobi-vault",
         "./skills/gobi-media",
         "./skills/gobi-sense",
         "./skills/gobi-homepage"

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gobi",
   "description": "Manage the Gobi collaborative knowledge platform from the command line",
-  "version": "0.9.13",
+  "version": "1.1.0",
   "author": {
     "name": "gobi-ai"
   },
@@ -9,7 +9,7 @@
   "skills": [
     "./skills/gobi-core",
     "./skills/gobi-space",
-    "./skills/gobi-brain",
+    "./skills/gobi-vault",
     "./skills/gobi-media",
     "./skills/gobi-sense",
     "./skills/gobi-homepage"

package/README.md

@@ -40,11 +40,11 @@ gobi init
 # Select a space
 gobi space warp
 
-# Search brains across your spaces
-gobi brain search --query "machine learning"
+# Search public vaults
+gobi vault search --query "machine learning"
 
-# Ask a brain a question
-gobi brain ask --vault-slug my-vault --question "What is RAG?"
+# Ask a vault a question
+gobi vault ask --vault-slug my-vault --question "What is RAG?"
 ```
 
 ## Commands
@@ -65,34 +65,33 @@ gobi brain ask --vault-slug my-vault --question "What is RAG?"
 | `gobi space list` | List spaces you are a member of |
 | `gobi space warp [spaceSlug]` | Select the active space (interactive if slug omitted) |
 
-### Brains
+### Vaults
 
 | Command | Description |
 |---------|-------------|
-| `gobi brain search --query <q>` | Search public brains by text and semantic similarity |
-| `gobi brain ask --vault-slug <slug> --question <q>` | Ask a brain a question (creates a 1:1 session) |
-| `gobi brain publish` | Upload `BRAIN.md` to your vault |
-| `gobi brain unpublish` | Remove `BRAIN.md` from your vault |
+| `gobi vault search --query <q>` | Search public vaults by text and semantic similarity |
+| `gobi vault ask --vault-slug <slug> --question <q>` | Ask a vault a question (creates a 1:1 session) |
+| `gobi vault publish` | Upload `PUBLISH.md` to your vault |
+| `gobi vault unpublish` | Remove `PUBLISH.md` from your vault |
 
-Public brains are accessible at `https://gobispace.com/@{vaultSlug}`.
+Public vaults are accessible at `https://gobispace.com/@{vaultSlug}`.
 
-`brain ask` also accepts `--rich-text <json>` (mutually exclusive with `--question`) and `--mode <auto|manual>`.
+`vault ask` also accepts `--rich-text <json>` (mutually exclusive with `--question`) and `--mode <auto|manual>`.
 
-### Brain Updates
+### Spaces
+
+> Space and member administration (creating spaces, inviting/approving members, joining/leaving) is web-UI only and not available in the CLI.
 
 | Command | Description |
 |---------|-------------|
-| `gobi brain list-updates` | List brain updates |
-| `gobi brain list-updates --mine` | List only your own brain updates |
-| `gobi brain post-update --title <t> --content <c>` | Post a brain update |
-| `gobi brain edit-update <id> [--title <t>] [--content <c>]` | Edit a brain update (at least one required) |
-| `gobi brain delete-update <id>` | Delete a brain update |
-
-`list-updates` also accepts `--space-slug <slug>` to scope to a space, and `--limit`/`--cursor` for pagination.
-`post-update` and `edit-update` accept `--auto-attachments` to upload wiki-linked `[[files]]` before posting.
+| `gobi space get [spaceSlug]` | Show space details (uses current space if slug omitted) |
+| `gobi space messages` | Unified message feed (threads + replies, newest first) |
+| `gobi space ancestors <threadId>` | Walk a thread/reply's lineage from root → immediate parent |
 
 ### Threads
 
+> **Migration note:** Vault-update (formerly brain-update) commands have been removed. To post user-level content, use `gobi global create-thread` (platform-wide global) or `gobi space create-thread` (a specific space).
+
 | Command | Description |
 |---------|-------------|
 | `gobi space list-threads` | List threads in the current space |
@@ -109,6 +108,18 @@ Public brains are accessible at `https://gobispace.com/@{vaultSlug}`.
 | `gobi space edit-reply <replyId> --content <c>` | Edit a reply |
 | `gobi space delete-reply <replyId>` | Delete a reply |
 
+### Global thread space
+
+The global thread space is a slugless message feed visible across all spaces.
+
+| Command | Description |
+|---------|-------------|
+| `gobi global messages` | List the global unified message feed (newest first) |
+| `gobi global get-thread <id>` | Get a global thread and its direct replies |
+| `gobi global ancestors <id>` | Walk a global thread/reply's lineage |
+| `gobi global create-thread [--title <t>] (--content <c> \| --rich-text <json>)` | Create a thread in the global space |
+| `gobi global reply <threadId> (--content <c> \| --rich-text <json>)` | Reply to a global thread |
+
 ### Sessions
 
 | Command | Description |
@@ -153,7 +164,7 @@ Times are ISO 8601 UTC (e.g. `2026-03-20T00:00:00Z`).
 |--------|-------|-------------|
 | `--json` | All commands | Output results as JSON |
 | `--space-slug <slug>` | `space` commands | Override the default space (from `.gobi/settings.yaml`) |
-| `--vault-slug <slug>` | Per-command | Override the default vault; available on `brain list-updates`, `brain post-update`, `brain edit-update`, `space create-thread`, `space edit-thread`, `space edit-reply` |
+| `--vault-slug <slug>` | Per-command | Override the default vault; available on `space create-thread`, `space edit-thread`, `space edit-reply` |
 
 ## Configuration
 

package/commands/space-explore.md

@@ -8,13 +8,11 @@ Always use the globally installed `gobi` binary (not via npx or ts-node).
 
 Explore the active Gobi space to surface discussions, topics, and learnings from others:
 
-1. Run these three commands in parallel:
-   - `gobi --json space list-threads` — recent discussions in the space
+1. Run these commands in parallel:
+   - `gobi --json space messages` — unified feed of recent threads and replies in the space
    - `gobi --json space list-topics` — available topics across the platform
-   - `gobi --json brain list-updates` — learnings and brain updates shared by members
-2. Display results in a readable summary, grouped by type (Topics / Discussions / Learnings).
+2. Display results in a readable summary, grouped by type (Topics / Discussions).
 3. If `$ARGUMENTS` is provided, filter or highlight entries relevant to that topic or keyword. If a matching topic is found, also run `gobi --json space list-topic-threads <topicSlug>` to show threads tagged with that topic.
 4. Ask the user if they'd like to read anything in full:
    - For a topic: run `gobi space list-topic-threads <topicSlug>` and show the threads.
    - For a thread: run `gobi space get-thread <threadId>` and show it with replies.
-   - For a brain update: show the full content from the list output.

package/commands/space-share.md

@@ -1,6 +1,6 @@
 ---
 name: space-share
-description: Summarize recent learnings from this session and draft a brain update to share to the active Gobi space.
+description: Summarize recent learnings from this session and draft a thread to share to the active Gobi space.
 argument-hint: "[context]"
 ---
 
@@ -16,7 +16,7 @@ gobi --json auth status
 
 Check that `.gobi/settings.yaml` exists and contains both `vaultSlug` and `selectedSpaceSlug`. If not warped, stop and ask the user to run `/gobi:warp` first.
 
-## Draft a brain update
+## Draft a thread
 
 If `$ARGUMENTS` is provided, treat it as additional context or emphasis to guide the draft (e.g. "Emphasize the auth fix" or "Focus on the API design decision").
 
@@ -34,12 +34,12 @@ Focus on:
 
 ## Present to the user
 
-Format the draft as a short brain update (2–5 bullet points max). Show it to the user and ask for confirmation before posting.
+Format the draft as a short thread (2–5 bullet points max). Show it to the user and ask for confirmation before posting.
 
-Once confirmed, post it:
+Once confirmed, post it as a thread in the active space:
 
 ```bash
-gobi brain post-update --title "<short title>" --content "<confirmed content>"
+gobi space create-thread --title "<short title>" --content "<confirmed content>"
 ```
 
 Confirm success and show the user the result.

package/dist/commands/global.js

@@ -0,0 +1,203 @@
+import { readFileSync } from "fs";
+import { apiGet, apiPost } from "../client.js";
+import { isJsonMode, jsonOut, unwrapResp } from "./utils.js";
+function readContent(value) {
+    if (value === "-")
+        return readFileSync("/dev/stdin", "utf8");
+    return value;
+}
+function formatMessageLine(m) {
+    const isReply = m.parentThreadId != null;
+    const id = `[${isReply ? "r" : "t"}:${m.id}]`;
+    const kind = isReply ? "reply " : "thread";
+    const author = m.author?.name ||
+        `User ${m.authorId ?? "?"}`;
+    let label;
+    if (isReply) {
+        const text = m.content || "";
+        label = text.length > 80 ? text.slice(0, 80) + "…" : text;
+        label = label.replace(/\s+/g, " ").trim();
+    }
+    else {
+        label = m.title || m.content || "";
+    }
+    return `${id} ${kind} ${author}  "${label}"  ${m.createdAt}`;
+}
+export function registerGlobalCommand(program) {
+    const global = program
+        .command("global")
+        .description("Global thread commands. Global is the platform-wide thread feed visible to everyone on Gobi.");
+    // ── Messages (unified feed) ──
+    global
+        .command("messages")
+        .description("List the global unified message feed (threads and replies, newest first).")
+        .option("--limit <number>", "Items per page", "20")
+        .option("--cursor <string>", "Pagination cursor from previous response")
+        .action(async (opts) => {
+        const params = {
+            limit: parseInt(opts.limit, 10),
+        };
+        if (opts.cursor)
+            params.cursor = opts.cursor;
+        const resp = (await apiGet(`/global/messages`, params));
+        if (isJsonMode(global)) {
+            jsonOut({
+                items: resp.data || [],
+                pagination: resp.pagination || {},
+            });
+            return;
+        }
+        const items = (resp.data || []);
+        const pagination = (resp.pagination || {});
+        if (!items.length) {
+            console.log("No messages found.");
+            return;
+        }
+        const lines = items.map(formatMessageLine);
+        const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
+        console.log(`Global messages (${items.length} items, newest first):\n` + lines.join("\n") + footer);
+    });
+    // ── Get thread ──
+    global
+        .command("get-thread <threadId>")
+        .description("Get a global thread and its direct replies (paginated).")
+        .option("--limit <number>", "Replies per page", "20")
+        .option("--cursor <string>", "Pagination cursor from previous response")
+        .action(async (threadId, opts) => {
+        const params = {
+            limit: parseInt(opts.limit, 10),
+        };
+        if (opts.cursor)
+            params.cursor = opts.cursor;
+        const resp = (await apiGet(`/global/threads/${threadId}`, params));
+        const data = unwrapResp(resp);
+        const pagination = (resp.pagination || {});
+        if (isJsonMode(global)) {
+            jsonOut({ ...data, pagination });
+            return;
+        }
+        const thread = (data.thread || data);
+        const replies = (data.items || []);
+        const author = thread.author?.name ||
+            `User ${thread.authorId}`;
+        const replyLines = [];
+        for (const r of replies) {
+            const rAuthor = r.author?.name ||
+                `User ${r.authorId}`;
+            const text = r.content || "";
+            const truncated = text.length > 200 ? text.slice(0, 200) + "…" : text;
+            replyLines.push(`  - ${rAuthor}: ${truncated} (${r.createdAt})`);
+        }
+        const isReply = thread.parentThreadId != null;
+        const heading = isReply
+            ? `Reply [r:${thread.id}]`
+            : `Thread: ${thread.title || "(no title)"}`;
+        const output = [
+            heading,
+            `By: ${author} on ${thread.createdAt}`,
+            "",
+            thread.content,
+            "",
+            `Replies (${replies.length} items):`,
+            ...replyLines,
+            ...(pagination.hasMore ? [`  Next cursor: ${pagination.nextCursor}`] : []),
+        ].join("\n");
+        console.log(output);
+    });
+    // ── Ancestors ──
+    global
+        .command("ancestors <threadId>")
+        .description("Show the ancestor lineage of a global thread or reply (root → immediate parent).")
+        .action(async (threadId) => {
+        const resp = (await apiGet(`/global/threads/${threadId}/ancestors`));
+        const data = unwrapResp(resp);
+        const ancestors = (data.ancestors || []);
+        if (isJsonMode(global)) {
+            jsonOut({ ancestors });
+            return;
+        }
+        if (!ancestors.length) {
+            console.log("No ancestors (this is a root thread).");
+            return;
+        }
+        const lines = [];
+        ancestors.forEach((a, i) => {
+            lines.push(`${i + 1}. ${formatMessageLine(a)}`);
+        });
+        console.log(`Ancestors (${ancestors.length} items, root first):\n` + lines.join("\n"));
+    });
+    // ── Create thread ──
+    global
+        .command("create-thread")
+        .description("Create a global thread (visible platform-wide).")
+        .option("--title <title>", "Title of the thread")
+        .option("--content <content>", "Thread content (markdown supported, use \"-\" for stdin)")
+        .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
+        .action(async (opts) => {
+        if (!opts.content && !opts.richText) {
+            throw new Error("Provide either --content or --rich-text.");
+        }
+        if (opts.content && opts.richText) {
+            throw new Error("--content and --rich-text are mutually exclusive.");
+        }
+        const body = {};
+        if (opts.title != null)
+            body.title = opts.title;
+        if (opts.content != null)
+            body.content = readContent(opts.content);
+        if (opts.richText != null) {
+            let parsed;
+            try {
+                parsed = JSON.parse(opts.richText);
+            }
+            catch {
+                throw new Error("Invalid --rich-text JSON.");
+            }
+            body.richText = parsed;
+        }
+        const resp = (await apiPost(`/global/threads`, body));
+        const thread = unwrapResp(resp);
+        if (isJsonMode(global)) {
+            jsonOut(thread);
+            return;
+        }
+        console.log(`Global thread created!\n` +
+            `  ID: ${thread.id}\n` +
+            (thread.title ? `  Title: ${thread.title}\n` : "") +
+            `  Created: ${thread.createdAt}`);
+    });
+    // ── Reply ──
+    global
+        .command("reply <threadId>")
+        .description("Reply to a global thread.")
+        .option("--content <content>", "Reply content (markdown supported, use \"-\" for stdin)")
+        .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
+        .action(async (threadId, opts) => {
+        if (!opts.content && !opts.richText) {
+            throw new Error("Provide either --content or --rich-text.");
+        }
+        if (opts.content && opts.richText) {
+            throw new Error("--content and --rich-text are mutually exclusive.");
+        }
+        const body = {};
+        if (opts.content != null)
+            body.content = readContent(opts.content);
+        if (opts.richText != null) {
+            let parsed;
+            try {
+                parsed = JSON.parse(opts.richText);
+            }
+            catch {
+                throw new Error("Invalid --rich-text JSON.");
+            }
+            body.richText = parsed;
+        }
+        const resp = (await apiPost(`/global/threads/${threadId}/replies`, body));
+        const reply = unwrapResp(resp);
+        if (isJsonMode(global)) {
+            jsonOut(reply);
+            return;
+        }
+        console.log(`Reply created!\n  ID: ${reply.id}\n  Created: ${reply.createdAt}`);
+    });
+}

package/dist/commands/init.js

@@ -205,11 +205,11 @@ export async function runInitFlow() {
     writeVaultSetting(vaultId);
     console.log(`Vault set to "${vaultName}" (${vaultId})`);
     console.log(`Updated ${SETTINGS_DIR}/${SETTINGS_FILE}`);
-    // Create default BRAIN.md if it doesn't exist
-    const brainPath = join(process.cwd(), "BRAIN.md");
-    if (!existsSync(brainPath)) {
-        writeFileSync(brainPath, `---\ntitle: ${vaultName}\ntags: []\ndescription:\nthumbnail:\nprompt:\n---\n`, "utf-8");
-        console.log("Created BRAIN.md");
+    // Create default PUBLISH.md if it doesn't exist
+    const publishMdPath = join(process.cwd(), "PUBLISH.md");
+    if (!existsSync(publishMdPath)) {
+        writeFileSync(publishMdPath, `---\ntitle: ${vaultName}\ntags: []\ndescription:\nthumbnail:\nprompt:\n---\n`, "utf-8");
+        console.log("Created PUBLISH.md");
     }
 }
 export function registerInitCommand(program) {

package/dist/commands/space.js

@@ -9,10 +9,27 @@ function readContent(value) {
         return readFileSync("/dev/stdin", "utf8");
     return value;
 }
+function formatMessageLine(m) {
+    const isReply = m.parentThreadId != null;
+    const id = `[${isReply ? "r" : "t"}:${m.id}]`;
+    const kind = isReply ? "reply " : "thread";
+    const author = m.author?.name ||
+        `User ${m.authorId ?? "?"}`;
+    let label;
+    if (isReply) {
+        const text = m.content || "";
+        label = text.length > 80 ? text.slice(0, 80) + "…" : text;
+        label = label.replace(/\s+/g, " ").trim();
+    }
+    else {
+        label = m.title || m.content || "";
+    }
+    return `${id} ${kind} ${author}  "${label}"  ${m.createdAt}`;
+}
 export function registerSpaceCommand(program) {
     const space = program
         .command("space")
-        .description("Space commands (threads, replies).")
+        .description("Space commands. A Space is a shared room of members where they post threads and replies, organized by topics.")
         .option("--space-slug <slug>", "Space slug (overrides .gobi/settings.yaml)");
     // ── List spaces ──
     space
@@ -36,6 +53,23 @@ export function registerSpaceCommand(program) {
         }
         console.log(`Spaces (${items.length}):\n` + lines.join("\n"));
     });
+    // ── Get space ──
+    space
+        .command("get [spaceSlug]")
+        .description("Get details for a space. Pass a slug or omit to use the current space (from .gobi/settings.yaml or --space-slug).")
+        .action(async (spaceSlug) => {
+        const slug = spaceSlug || resolveSpaceSlug(space);
+        const resp = (await apiGet(`/spaces/${slug}`));
+        const s = unwrapResp(resp);
+        if (isJsonMode(space)) {
+            jsonOut(s);
+            return;
+        }
+        const desc = s.description ? `\n  Description: ${s.description}` : "";
+        console.log(`Space [${s.slug}] ${s.name}${desc}\n` +
+            `  ID: ${s.id}\n` +
+            `  Created: ${s.createdAt}`);
+    });
     // ── Warp (space selection) ──
     space
         .command("warp [spaceSlug]")
@@ -126,6 +160,60 @@ export function registerSpaceCommand(program) {
             lines.join("\n") +
             footer);
     });
+    // ── Messages (unified feed) ──
+    space
+        .command("messages")
+        .description("List the unified message feed (threads and replies, newest first) in a space.")
+        .option("--limit <number>", "Items per page", "20")
+        .option("--cursor <string>", "Pagination cursor from previous response")
+        .action(async (opts) => {
+        const spaceSlug = resolveSpaceSlug(space);
+        const params = {
+            limit: parseInt(opts.limit, 10),
+        };
+        if (opts.cursor)
+            params.cursor = opts.cursor;
+        const resp = (await apiGet(`/spaces/${spaceSlug}/messages`, params));
+        if (isJsonMode(space)) {
+            jsonOut({
+                items: resp.data || [],
+                pagination: resp.pagination || {},
+            });
+            return;
+        }
+        const items = (resp.data || []);
+        const pagination = (resp.pagination || {});
+        if (!items.length) {
+            console.log("No messages found.");
+            return;
+        }
+        const lines = items.map(formatMessageLine);
+        const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
+        console.log(`Messages (${items.length} items, newest first):\n` + lines.join("\n") + footer);
+    });
+    // ── Ancestors ──
+    space
+        .command("ancestors <threadId>")
+        .description("Show the ancestor lineage of a thread or reply (root → immediate parent).")
+        .action(async (threadId) => {
+        const spaceSlug = resolveSpaceSlug(space);
+        const resp = (await apiGet(`/spaces/${spaceSlug}/threads/${threadId}/ancestors`));
+        const data = unwrapResp(resp);
+        const ancestors = (data.ancestors || []);
+        if (isJsonMode(space)) {
+            jsonOut({ ancestors });
+            return;
+        }
+        if (!ancestors.length) {
+            console.log("No ancestors (this is a root thread).");
+            return;
+        }
+        const lines = [];
+        ancestors.forEach((a, i) => {
+            lines.push(`${i + 1}. ${formatMessageLine(a)}`);
+        });
+        console.log(`Ancestors (${ancestors.length} items, root first):\n` + lines.join("\n"));
+    });
     // ── Threads (get, list, create, edit, delete) ──
     space
         .command("get-thread <threadId>")

package/dist/commands/vault.js

@@ -0,0 +1,141 @@
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { apiGet, apiPost } from "../client.js";
+import { WEBDRIVE_BASE_URL } from "../constants.js";
+import { getValidToken } from "../auth/manager.js";
+import { getVaultSlug } from "./init.js";
+import { isJsonMode, jsonOut, unwrapResp } from "./utils.js";
+export function registerVaultCommand(program) {
+    const vaultCmd = program
+        .command("vault")
+        .description("Vault commands. A Vault is your personal knowledge container — search public vaults, ask them questions, and publish a PUBLISH.md to make a vault public.");
+    // ── Search ──
+    vaultCmd
+        .command("search")
+        .description("Search public vaults by text and semantic similarity.")
+        .requiredOption("--query <query>", "Search query")
+        .action(async (opts) => {
+        const resp = (await apiGet(`/vault/public/search`, {
+            query: opts.query,
+        }));
+        const results = (Array.isArray(resp) ? resp : resp.data || resp);
+        if (isJsonMode(vaultCmd)) {
+            jsonOut(results || []);
+            return;
+        }
+        if (!results || results.length === 0) {
+            console.log(`No vaults found matching "${opts.query}".`);
+            return;
+        }
+        const lines = [];
+        for (const entry of results) {
+            const vault = (entry.vault || entry);
+            const owner = (entry.owner || {});
+            const ownerName = owner.name ? ` by ${owner.name}` : "";
+            const sim = entry.similarity != null
+                ? ` [similarity: ${entry.similarity.toFixed(3)}]`
+                : "";
+            const spaceSlug = (entry.spaceSlug || vault.spaceSlug || "");
+            const vaultSlug = (vault.slug || vault.vaultSlug || vault.id || "N/A");
+            lines.push(`- ${vault.name || vault.title || "N/A"} (vault: ${vaultSlug}, space: ${spaceSlug || "N/A"})${ownerName}${sim}`);
+        }
+        console.log(`Vaults matching "${opts.query}":\n` + lines.join("\n"));
+    });
+    // ── Ask ──
+    vaultCmd
+        .command("ask")
+        .description("Ask a vault a question. Creates a targeted session (1:1 conversation).")
+        .requiredOption("--vault-slug <vaultSlug>", "Slug of the vault to ask")
+        .option("--question <question>", "The question to ask (markdown supported)")
+        .option("--rich-text <richText>", "Rich-text JSON array (e.g. [{\"type\":\"text\",\"text\":\"hello\"}])")
+        .option("--mode <mode>", 'Session mode: "auto" or "manual"')
+        .action(async (opts) => {
+        if (!opts.question && !opts.richText) {
+            throw new Error("Provide either --question or --rich-text.");
+        }
+        if (opts.question && opts.richText) {
+            throw new Error("--question and --rich-text are mutually exclusive.");
+        }
+        const body = {
+            vaultSlug: opts.vaultSlug,
+        };
+        if (opts.question != null)
+            body.question = opts.question;
+        if (opts.richText != null) {
+            let parsed;
+            try {
+                parsed = JSON.parse(opts.richText);
+            }
+            catch {
+                throw new Error("Invalid --rich-text JSON.");
+            }
+            body.richText = parsed;
+        }
+        if (opts.mode != null)
+            body.mode = opts.mode;
+        const resp = (await apiPost(`/chat/targeted`, body));
+        const data = unwrapResp(resp);
+        if (isJsonMode(vaultCmd)) {
+            jsonOut(data);
+            return;
+        }
+        const session = (data.session || {});
+        const members = (data.members || []);
+        console.log(`Session created!\n` +
+            `  Session ID: ${session.id}\n` +
+            `  Mode: ${session.mode}\n` +
+            `  Members: ${members.length}\n` +
+            `  Question sent.`);
+    });
+    // ── Publish ──
+    vaultCmd
+        .command("publish")
+        .description("Upload PUBLISH.md to the vault root on webdrive. Triggers post-processing (vault sync, metadata update, Discord notification).")
+        .action(async () => {
+        const vaultId = getVaultSlug();
+        const filePath = join(process.cwd(), "PUBLISH.md");
+        if (!existsSync(filePath)) {
+            throw new Error(`PUBLISH.md not found in ${process.cwd()}`);
+        }
+        const content = readFileSync(filePath, "utf-8");
+        const token = await getValidToken();
+        const url = `${WEBDRIVE_BASE_URL}/api/v1/vaults/${vaultId}/file/PUBLISH.md`;
+        const res = await fetch(url, {
+            method: "PUT",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "text/markdown",
+            },
+            body: content,
+        });
+        if (!res.ok) {
+            throw new Error(`Upload failed: HTTP ${res.status}: ${(await res.text()) || "(no body)"}`);
+        }
+        if (isJsonMode(vaultCmd)) {
+            jsonOut({ vaultId });
+            return;
+        }
+        console.log(`Published PUBLISH.md to vault "${vaultId}"`);
+    });
+    // ── Unpublish ──
+    vaultCmd
+        .command("unpublish")
+        .description("Delete PUBLISH.md from the vault on webdrive.")
+        .action(async () => {
+        const vaultId = getVaultSlug();
+        const token = await getValidToken();
+        const url = `${WEBDRIVE_BASE_URL}/api/v1/vaults/${vaultId}/file/PUBLISH.md`;
+        const res = await fetch(url, {
+            method: "DELETE",
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        if (!res.ok) {
+            throw new Error(`Delete failed: HTTP ${res.status}: ${(await res.text()) || "(no body)"}`);
+        }
+        if (isJsonMode(vaultCmd)) {
+            jsonOut({ vaultId });
+            return;
+        }
+        console.log(`Deleted PUBLISH.md from vault "${vaultId}"`);
+    });
+}