@gobi-ai/cli 0.3.1 → 0.3.3

package/README.md

@@ -38,13 +38,13 @@ npm link
 gobi init
 
 # Select a space
-gobi astra warp
+gobi space warp
 
-# Search brains in your space
-gobi astra search-brain --query "machine learning"
+# Search brains across your spaces
+gobi brain search --query "machine learning"
 
 # Ask a brain a question
-gobi astra ask-brain --vault-slug my-vault --question "What is RAG?"
+gobi brain ask --vault-slug my-vault --space-slug my-space --question "What is RAG?"
 ```
 
 ## Commands
@@ -62,59 +62,61 @@ gobi astra ask-brain --vault-slug my-vault --question "What is RAG?"
 | Command | Description |
 |---------|-------------|
 | `gobi init` | Log in (if needed) and select or create a vault |
-| `gobi astra warp` | Select the active space |
+| `gobi space warp` | Select the active space |
 
 ### Brains
 
 | Command | Description |
 |---------|-------------|
-| `gobi astra search-brain --query <q>` | Search brains in a space |
-| `gobi astra ask-brain --vault-slug <slug> --question <q>` | Ask a brain a question (creates a 1:1 session) |
-| `gobi astra publish-brain` | Upload `BRAIN.md` to your vault |
-| `gobi astra unpublish-brain` | Remove `BRAIN.md` from your vault |
+| `gobi brain search --query <q>` | Search brains across all your spaces |
+| `gobi brain ask --vault-slug <slug> --space-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 |
 
-### Posts
+### Brain Updates
 
 | Command | Description |
 |---------|-------------|
-| `gobi astra list-posts` | List posts in the current space |
-| `gobi astra get-post <id>` | Get a post and its replies |
-| `gobi astra create-post --title <t> --content <c>` | Create a post |
-| `gobi astra edit-post <id> --title <t>` | Edit a post |
-| `gobi astra delete-post <id>` | Delete a post |
+| `gobi brain list-updates` | List brain updates for your vault |
+| `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>` | Edit a brain update |
+| `gobi brain delete-update <id>` | Delete a brain update |
 
-### Replies
+### Threads
 
 | Command | Description |
 |---------|-------------|
-| `gobi astra create-reply <postId> --content <c>` | Reply to a post |
-| `gobi astra edit-reply <replyId> --content <c>` | Edit a reply |
-| `gobi astra delete-reply <replyId>` | Delete a reply |
+| `gobi space list-threads` | List threads in the current space |
+| `gobi space get-thread <id>` | Get a thread and its replies |
+| `gobi space create-thread --title <t> --content <c>` | Create a thread |
+| `gobi space edit-thread <id> --title <t>` | Edit a thread |
+| `gobi space delete-thread <id>` | Delete a thread |
 
-### Sessions
+### Replies
 
 | Command | Description |
 |---------|-------------|
-| `gobi astra list-sessions` | List your sessions |
-| `gobi astra get-session <id>` | Get a session and its messages |
-| `gobi astra reply-session <id> --content <c>` | Send a message in a session |
-| `gobi astra update-session <id> --mode <mode>` | Set session mode (auto/manual) |
+| `gobi space create-reply <threadId> --content <c>` | Reply to a thread |
+| `gobi space edit-reply <replyId> --content <c>` | Edit a reply |
+| `gobi space delete-reply <replyId>` | Delete a reply |
 
-### Brain updates
+### Sessions
 
 | Command | Description |
 |---------|-------------|
-| `gobi astra list-brain-updates` | List brain updates in the space |
-| `gobi astra create-brain-update --title <t> --content <c>` | Create a brain update |
-| `gobi astra edit-brain-update <id> --title <t>` | Edit a brain update |
-| `gobi astra delete-brain-update <id>` | Delete a brain update |
+| `gobi session list` | List your sessions |
+| `gobi session get <id>` | Get a session and its messages |
+| `gobi session reply <id> --content <c>` | Send a message in a session |
+| `gobi session update <id> --mode <mode>` | Set session mode (auto/manual) |
 
 ### Global options
 
 | Option | Description |
 |--------|-------------|
 | `--json` | Output results as JSON |
-| `--space-slug <slug>` | Override the default space (astra commands) |
+| `--space-slug <slug>` | Override the default space (on `space` commands); required on `brain ask`, optional filter on `session list` |
+| `--vault-slug <slug>` | Override the default vault (on `brain list-updates` and `brain post-update`) |
 
 ## Configuration
 

package/dist/commands/astra.js

@@ -1,36 +1,15 @@
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
 import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
-import { WEBDRIVE_BASE_URL } from "../constants.js";
-import { getValidToken } from "../auth/manager.js";
-import { getSpaceSlug, getVaultSlug, selectSpace, writeSpaceSetting } from "./init.js";
-function isJsonMode(cmd) {
-    return !!cmd.parent?.opts().json;
-}
-function jsonOut(data) {
-    console.log(JSON.stringify({ success: true, data }));
-}
-function resolveSpaceSlug(cmd) {
-    return cmd.opts().spaceSlug || getSpaceSlug();
-}
-function resolveVaultSlug(opts) {
-    return opts.vaultSlug || getVaultSlug();
-}
-function unwrapResp(resp) {
-    if (typeof resp === "object" && resp !== null && "data" in resp) {
-        return resp.data;
-    }
-    return resp;
-}
+import { selectSpace, writeSpaceSetting } from "./init.js";
+import { isJsonMode, jsonOut, resolveSpaceSlug, unwrapResp } from "./utils.js";
 export function registerAstraCommand(program) {
-    const astra = program
-        .command("astra")
-        .description("Astra commands (posts, sessions, brains, brain updates).")
+    const space = program
+        .command("space")
+        .description("Space commands (threads, replies).")
         .option("--space-slug <slug>", "Space slug (overrides .gobi/settings.yaml)");
     // ── Warp (space selection) ──
-    astra
+    space
         .command("warp")
-        .description("Select the active space for astra commands.")
+        .description("Select the active space.")
         .action(async () => {
         const result = await selectSpace();
         if (result === null) {
@@ -38,146 +17,36 @@ export function registerAstraCommand(program) {
             return;
         }
         writeSpaceSetting(result.slug);
-        if (isJsonMode(astra)) {
+        if (isJsonMode(space)) {
             jsonOut({ spaceSlug: result.slug, spaceName: result.name });
             return;
         }
         console.log(`Warped to space "${result.name}" (${result.slug})`);
     });
-    // ── Brains ──
-    astra
-        .command("search-brain")
-        .description("Search brains (second brains/vaults) in a space using text and semantic search.")
-        .requiredOption("--query <query>", "Search query")
-        .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const resp = (await apiGet(`/spaces/${spaceSlug}/brains`, {
-            query: opts.query,
-        }));
-        const results = (Array.isArray(resp) ? resp : resp.data || resp);
-        if (isJsonMode(astra)) {
-            jsonOut(results || []);
-            return;
-        }
-        if (!results || results.length === 0) {
-            console.log(`No brains 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)}]`
-                : "";
-            lines.push(`- ${vault.name || vault.title || "N/A"} (ID: ${vault.vaultId || vault.id || "N/A"})${ownerName}${sim}`);
-        }
-        console.log(`Brains matching "${opts.query}":\n` + lines.join("\n"));
-    });
-    astra
-        .command("ask-brain")
-        .description("Ask a brain a question. Creates a targeted session (1:1 conversation).")
-        .requiredOption("--vault-slug <vaultSlug>", "Slug of the brain/vault to ask")
-        .requiredOption("--question <question>", "The question to ask (markdown supported)")
-        .option("--mode <mode>", 'Session mode: "auto" or "manual"')
-        .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const body = {
-            vaultSlug: opts.vaultSlug,
-            spaceSlug,
-            question: opts.question,
-        };
-        if (opts.mode != null)
-            body.mode = opts.mode;
-        const resp = (await apiPost(`/session/targeted`, body));
-        const data = unwrapResp(resp);
-        if (isJsonMode(astra)) {
-            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.`);
-    });
-    astra
-        .command("publish-brain")
-        .description("Upload BRAIN.md to the vault root on webdrive. Triggers post-processing (brain sync, metadata update, Discord notification).")
-        .action(async () => {
-        const vaultId = getVaultSlug();
-        const filePath = join(process.cwd(), "BRAIN.md");
-        if (!existsSync(filePath)) {
-            throw new Error(`BRAIN.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}/files/BRAIN.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(astra)) {
-            jsonOut({ vaultId });
-            return;
-        }
-        console.log(`Published BRAIN.md to vault "${vaultId}"`);
-    });
-    astra
-        .command("unpublish-brain")
-        .description("Delete BRAIN.md from the vault on webdrive.")
-        .action(async () => {
-        const vaultId = getVaultSlug();
-        const token = await getValidToken();
-        const url = `${WEBDRIVE_BASE_URL}/api/v1/vaults/${vaultId}/files/BRAIN.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(astra)) {
-            jsonOut({ vaultId });
-            return;
-        }
-        console.log(`Deleted BRAIN.md from vault "${vaultId}"`);
-    });
-    // ── Posts (get, list, create, edit, delete) ──
-    astra
-        .command("get-post <postId>")
-        .description("Get a post and its replies (paginated).")
+    // ── Threads (get, list, create, edit, delete) ──
+    space
+        .command("get-thread <threadId>")
+        .description("Get a thread and its replies (paginated).")
         .option("--limit <number>", "Replies per page", "20")
-        .option("--offset <number>", "Offset for reply pagination", "0")
-        .action(async (postId, opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const resp = (await apiGet(`/spaces/${spaceSlug}/posts/${postId}`, {
+        .option("--cursor <string>", "Pagination cursor from previous response")
+        .action(async (threadId, opts) => {
+        const spaceSlug = resolveSpaceSlug(space);
+        const params = {
             limit: parseInt(opts.limit, 10),
-            offset: parseInt(opts.offset, 10),
-        }));
+        };
+        if (opts.cursor)
+            params.cursor = opts.cursor;
+        const resp = (await apiGet(`/spaces/${spaceSlug}/threads/${threadId}`, params));
         const data = unwrapResp(resp);
         const pagination = (resp.pagination || {});
-        if (isJsonMode(astra)) {
+        if (isJsonMode(space)) {
             jsonOut({ ...data, pagination });
             return;
         }
-        const msg = (data.post || data);
+        const thread = (data.thread || data);
         const replies = (data.items || []);
-        const totalReplies = pagination.total ||
-            msg.replyCount ||
-            0;
-        const author = msg.author?.name ||
-            `User ${msg.authorId}`;
+        const author = thread.author?.name ||
+            `User ${thread.authorId}`;
         const replyLines = [];
         for (const r of replies) {
             const rAuthor = r.author?.name ||
@@ -187,28 +56,31 @@ export function registerAstraCommand(program) {
             replyLines.push(`  - ${rAuthor}: ${truncated} (${r.createdAt})`);
         }
         const output = [
-            `Post: ${msg.title}`,
-            `By: ${author} on ${msg.createdAt}`,
+            `Thread: ${thread.title}`,
+            `By: ${author} on ${thread.createdAt}`,
             "",
-            msg.content,
+            thread.content,
             "",
-            `Replies (${replies.length} of ${totalReplies}):`,
+            `Replies (${replies.length} items):`,
             ...replyLines,
+            ...(pagination.hasMore ? [`  Next cursor: ${pagination.nextCursor}`] : []),
         ].join("\n");
         console.log(output);
     });
-    astra
-        .command("list-posts")
-        .description("List posts in a space (paginated).")
+    space
+        .command("list-threads")
+        .description("List threads in a space (paginated).")
         .option("--limit <number>", "Items per page", "20")
-        .option("--offset <number>", "Offset for pagination", "0")
+        .option("--cursor <string>", "Pagination cursor from previous response")
         .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const resp = (await apiGet(`/spaces/${spaceSlug}/posts`, {
+        const spaceSlug = resolveSpaceSlug(space);
+        const params = {
             limit: parseInt(opts.limit, 10),
-            offset: parseInt(opts.offset, 10),
-        }));
-        if (isJsonMode(astra)) {
+        };
+        if (opts.cursor)
+            params.cursor = opts.cursor;
+        const resp = (await apiGet(`/spaces/${spaceSlug}/threads`, params));
+        if (isJsonMode(space)) {
             jsonOut({
                 items: resp.data || [],
                 pagination: resp.pagination || {},
@@ -218,344 +90,116 @@ export function registerAstraCommand(program) {
         const items = (resp.data || []);
         const pagination = (resp.pagination || {});
         if (!items.length) {
-            console.log("No posts found.");
+            console.log("No threads found.");
             return;
         }
         const lines = [];
-        for (const msg of items) {
-            const author = msg.author?.name ||
-                `User ${msg.authorId}`;
-            lines.push(`- [${msg.id}] "${msg.title}" by ${author} (${msg.replyCount} replies, ${msg.createdAt})`);
-        }
-        const total = pagination.total || items.length;
-        console.log(`Posts (${items.length} of ${total}):\n` + lines.join("\n"));
-    });
-    astra
-        .command("create-post")
-        .description("Create a post in a space.")
-        .requiredOption("--title <title>", "Title of the post")
-        .requiredOption("--content <content>", "Post content (markdown supported)")
+        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 footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
+        console.log(`Threads (${items.length} items):\n` + lines.join("\n") + footer);
+    });
+    space
+        .command("create-thread")
+        .description("Create a thread in a space.")
+        .requiredOption("--title <title>", "Title of the thread")
+        .requiredOption("--content <content>", "Thread content (markdown supported)")
         .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const resp = (await apiPost(`/spaces/${spaceSlug}/posts`, {
+        const spaceSlug = resolveSpaceSlug(space);
+        const resp = (await apiPost(`/spaces/${spaceSlug}/threads`, {
             title: opts.title,
             content: opts.content,
         }));
-        const msg = unwrapResp(resp);
-        if (isJsonMode(astra)) {
-            jsonOut(msg);
-            return;
-        }
-        console.log(`Post created!\n` +
-            `  ID: ${msg.id}\n` +
-            `  Title: ${msg.title}\n` +
-            `  Created: ${msg.createdAt}`);
-    });
-    astra
-        .command("edit-post <postId>")
-        .description("Edit a post. You must be the author.")
-        .option("--title <title>", "New title for the post")
-        .option("--content <content>", "New content for the post (markdown supported)")
-        .action(async (postId, opts) => {
+        const thread = unwrapResp(resp);
+        if (isJsonMode(space)) {
+            jsonOut(thread);
+            return;
+        }
+        console.log(`Thread created!\n` +
+            `  ID: ${thread.id}\n` +
+            `  Title: ${thread.title}\n` +
+            `  Created: ${thread.createdAt}`);
+    });
+    space
+        .command("edit-thread <threadId>")
+        .description("Edit a thread. You must be the author.")
+        .option("--title <title>", "New title for the thread")
+        .option("--content <content>", "New content for the thread (markdown supported)")
+        .action(async (threadId, opts) => {
         if (!opts.title && !opts.content) {
             throw new Error("Provide at least --title or --content to update.");
         }
-        const spaceSlug = resolveSpaceSlug(astra);
+        const spaceSlug = resolveSpaceSlug(space);
         const body = {};
         if (opts.title != null)
             body.title = opts.title;
         if (opts.content != null)
             body.content = opts.content;
-        const resp = (await apiPatch(`/spaces/${spaceSlug}/posts/${postId}`, body));
-        const msg = unwrapResp(resp);
-        if (isJsonMode(astra)) {
-            jsonOut(msg);
+        const resp = (await apiPatch(`/spaces/${spaceSlug}/threads/${threadId}`, body));
+        const thread = unwrapResp(resp);
+        if (isJsonMode(space)) {
+            jsonOut(thread);
             return;
         }
-        console.log(`Post edited!\n` +
-            `  ID: ${msg.id}\n` +
-            `  Title: ${msg.title}\n` +
-            `  Edited: ${msg.editedAt}`);
+        console.log(`Thread edited!\n` +
+            `  ID: ${thread.id}\n` +
+            `  Title: ${thread.title}\n` +
+            `  Edited: ${thread.editedAt}`);
     });
-    astra
-        .command("delete-post <postId>")
-        .description("Delete a post. You must be the author.")
-        .action(async (postId) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        await apiDelete(`/spaces/${spaceSlug}/posts/${postId}`);
-        if (isJsonMode(astra)) {
-            jsonOut({ id: postId });
+    space
+        .command("delete-thread <threadId>")
+        .description("Delete a thread. You must be the author.")
+        .action(async (threadId) => {
+        const spaceSlug = resolveSpaceSlug(space);
+        await apiDelete(`/spaces/${spaceSlug}/threads/${threadId}`);
+        if (isJsonMode(space)) {
+            jsonOut({ id: threadId });
             return;
         }
-        console.log(`Post ${postId} deleted.`);
+        console.log(`Thread ${threadId} deleted.`);
     });
     // ── Replies (create, edit, delete) ──
-    astra
-        .command("create-reply <postId>")
-        .description("Create a reply to a post in a space.")
+    space
+        .command("create-reply <threadId>")
+        .description("Create a reply to a thread in a space.")
         .requiredOption("--content <content>", "Reply content (markdown supported)")
-        .action(async (postId, opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const resp = (await apiPost(`/spaces/${spaceSlug}/posts/${postId}/replies`, { content: opts.content }));
+        .action(async (threadId, opts) => {
+        const spaceSlug = resolveSpaceSlug(space);
+        const resp = (await apiPost(`/spaces/${spaceSlug}/threads/${threadId}/replies`, { content: opts.content }));
         const msg = unwrapResp(resp);
-        if (isJsonMode(astra)) {
+        if (isJsonMode(space)) {
             jsonOut(msg);
             return;
         }
         console.log(`Reply created!\n  ID: ${msg.id}\n  Created: ${msg.createdAt}`);
     });
-    astra
+    space
         .command("edit-reply <replyId>")
         .description("Edit a reply. You must be the author.")
         .requiredOption("--content <content>", "New content for the reply (markdown supported)")
         .action(async (replyId, opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
+        const spaceSlug = resolveSpaceSlug(space);
         const resp = (await apiPatch(`/spaces/${spaceSlug}/replies/${replyId}`, { content: opts.content }));
         const msg = unwrapResp(resp);
-        if (isJsonMode(astra)) {
+        if (isJsonMode(space)) {
             jsonOut(msg);
             return;
         }
         console.log(`Reply edited!\n  ID: ${msg.id}\n  Edited: ${msg.editedAt}`);
     });
-    astra
+    space
         .command("delete-reply <replyId>")
         .description("Delete a reply. You must be the author.")
         .action(async (replyId) => {
-        const spaceSlug = resolveSpaceSlug(astra);
+        const spaceSlug = resolveSpaceSlug(space);
         await apiDelete(`/spaces/${spaceSlug}/replies/${replyId}`);
-        if (isJsonMode(astra)) {
+        if (isJsonMode(space)) {
             jsonOut({ replyId });
             return;
         }
         console.log(`Reply ${replyId} deleted.`);
     });
-    // ── Sessions (get, list, reply) ──
-    astra
-        .command("get-session <sessionId>")
-        .description("Get a session and its messages (paginated).")
-        .option("--limit <number>", "Messages per page", "20")
-        .option("--offset <number>", "Offset for message pagination", "0")
-        .action(async (sessionId, opts) => {
-        const resp = (await apiGet(`/session/${sessionId}`, {
-            limit: parseInt(opts.limit, 10),
-            offset: parseInt(opts.offset, 10),
-        }));
-        const data = unwrapResp(resp);
-        if (isJsonMode(astra)) {
-            jsonOut(data);
-            return;
-        }
-        const session = (data.session || data);
-        const messages = (data.messages || []);
-        const pagination = (data.pagination || {});
-        const totalMessages = pagination.total || messages.length;
-        const msgLines = [];
-        for (const m of messages) {
-            const author = m.author?.name ||
-                m.source ||
-                `User ${m.authorId}`;
-            const text = m.content;
-            const truncated = text.length > 200 ? text.slice(0, 200) + "\u2026" : text;
-            msgLines.push(`  - ${author}: ${truncated} (${m.createdAt})`);
-        }
-        const output = [
-            `Session: ${session.title}`,
-            `  ID: ${session.id}`,
-            `  Mode: ${session.mode}`,
-            `  Last activity: ${session.lastMessageAt}`,
-            "",
-            `Messages (${messages.length} of ${totalMessages}):`,
-            ...msgLines,
-        ].join("\n");
-        console.log(output);
-    });
-    astra
-        .command("list-sessions")
-        .description("List all sessions you are part of, sorted by most recent activity.")
-        .option("--limit <number>", "Items per page", "20")
-        .option("--offset <number>", "Offset for pagination", "0")
-        .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const limit = parseInt(opts.limit, 10);
-        const offset = parseInt(opts.offset, 10);
-        const resp = (await apiGet(`/session/my-sessions`, {
-            spaceSlug,
-            limit,
-            offset,
-        }));
-        const items = (resp.data || []);
-        const pagination = (resp.pagination || {});
-        const total = pagination.total ?? items.length;
-        if (isJsonMode(astra)) {
-            jsonOut({
-                items,
-                pagination: resp.pagination || {},
-            });
-            return;
-        }
-        if (!items.length) {
-            console.log("No sessions found.");
-            return;
-        }
-        const lines = [];
-        for (const s of items) {
-            const title = s.title || "(no title)";
-            const members = s.members || [];
-            const memberCount = s.memberCount ?? 0;
-            let memberInfo = "";
-            if (members.length > 0) {
-                const names = members.map((m) => m.vaultName || m.name || "Unknown");
-                const overflow = memberCount - members.length - 1; // -1 for "me"
-                memberInfo = ` | with: ${names.join(", ")}`;
-                if (overflow > 0)
-                    memberInfo += ` +${overflow} more`;
-            }
-            lines.push(`- [${s.id}] "${title}" (mode: ${s.mode}, last activity: ${s.lastMessageAt})${memberInfo}`);
-        }
-        console.log(`Sessions (${items.length} of ${total}):\n` + lines.join("\n"));
-    });
-    astra
-        .command("reply-session <sessionId>")
-        .description("Send a human reply to a session you are a member of.")
-        .requiredOption("--content <content>", "Reply content (markdown supported)")
-        .action(async (sessionId, opts) => {
-        const resp = (await apiPost(`/session/${sessionId}/reply`, {
-            content: opts.content,
-        }));
-        const msg = unwrapResp(resp);
-        if (isJsonMode(astra)) {
-            jsonOut(msg);
-            return;
-        }
-        console.log(`Reply sent!\n` +
-            `  Message ID: ${msg.id}\n` +
-            `  Source: ${msg.source}\n` +
-            `  Created: ${msg.createdAt}`);
-    });
-    astra
-        .command("update-session <sessionId>")
-        .description('Update a session. "auto" lets the AI respond automatically; "manual" requires human replies.')
-        .option("--mode <mode>", 'Session mode: "auto" or "manual"')
-        .action(async (sessionId, opts) => {
-        if (!opts.mode) {
-            throw new Error("Provide at least one option to update (e.g. --mode).");
-        }
-        const body = {};
-        if (opts.mode != null) {
-            if (opts.mode !== "auto" && opts.mode !== "manual") {
-                throw new Error('Invalid mode. Must be "auto" or "manual".');
-            }
-            body.mode = opts.mode;
-        }
-        const resp = (await apiPatch(`/session/${sessionId}`, body));
-        const data = unwrapResp(resp);
-        if (isJsonMode(astra)) {
-            jsonOut(data);
-            return;
-        }
-        const session = (data.session || data);
-        console.log(`Session updated!\n` +
-            `  ID: ${session.id}\n` +
-            `  Mode: ${session.mode}`);
-    });
-    // ── Brain Updates (list, create, edit, delete) ──
-    astra
-        .command("list-brain-updates")
-        .description("List recent brain updates in a space (paginated).")
-        .option("--limit <number>", "Items per page", "20")
-        .option("--offset <number>", "Offset for pagination", "0")
-        .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const resp = (await apiGet(`/spaces/${spaceSlug}/brain-updates`, {
-            limit: parseInt(opts.limit, 10),
-            offset: parseInt(opts.offset, 10),
-        }));
-        if (isJsonMode(astra)) {
-            jsonOut({
-                items: resp.data || [],
-                pagination: resp.pagination || {},
-            });
-            return;
-        }
-        const items = (resp.data || []);
-        const pagination = (resp.pagination || {});
-        if (!items.length) {
-            console.log("No brain updates found.");
-            return;
-        }
-        const lines = [];
-        for (const u of items) {
-            const author = u.author?.name ||
-                `User ${u.authorId}`;
-            const vaultSlug = u.vault?.vaultSlug ||
-                "?";
-            lines.push(`- [${u.id}] "${u.title}" by ${author} (vault: ${vaultSlug}, ${u.createdAt})`);
-        }
-        const total = pagination.total || items.length;
-        console.log(`Brain updates (${items.length} of ${total}):\n` + lines.join("\n"));
-    });
-    astra
-        .command("create-brain-update")
-        .description("Create a brain update in a space. Uses the vault from settings.")
-        .option("--vault-slug <vaultSlug>", "Vault slug (overrides .gobi/settings.yaml)")
-        .requiredOption("--title <title>", "Title of the update")
-        .requiredOption("--content <content>", "Update content (markdown supported)")
-        .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        const vaultSlug = resolveVaultSlug(opts);
-        const resp = (await apiPost(`/spaces/${spaceSlug}/brain-updates`, {
-            vaultSlug,
-            title: opts.title,
-            content: opts.content,
-        }));
-        const u = unwrapResp(resp);
-        if (isJsonMode(astra)) {
-            jsonOut(u);
-            return;
-        }
-        console.log(`Brain update created!\n` +
-            `  ID: ${u.id}\n` +
-            `  Title: ${u.title}\n` +
-            `  Vault: ${u.vaultSlug || vaultSlug}\n` +
-            `  Created: ${u.createdAt}`);
-    });
-    astra
-        .command("edit-brain-update <updateId>")
-        .description("Edit a published brain update. You must be the author.")
-        .option("--title <title>", "New title for the update")
-        .option("--content <content>", "New content for the update (markdown supported)")
-        .action(async (updateId, opts) => {
-        if (!opts.title && !opts.content) {
-            throw new Error("Provide at least --title or --content to update.");
-        }
-        const spaceSlug = resolveSpaceSlug(astra);
-        const body = {};
-        if (opts.title != null)
-            body.title = opts.title;
-        if (opts.content != null)
-            body.content = opts.content;
-        const resp = (await apiPatch(`/spaces/${spaceSlug}/brain-updates/${updateId}`, body));
-        const u = unwrapResp(resp);
-        if (isJsonMode(astra)) {
-            jsonOut(u);
-            return;
-        }
-        console.log(`Brain update edited!\n` +
-            `  ID: ${u.id}\n` +
-            `  Title: ${u.title}\n` +
-            `  Updated: ${u.updatedAt}`);
-    });
-    astra
-        .command("delete-brain-update <updateId>")
-        .description("Delete a published brain update. You must be the author.")
-        .action(async (updateId) => {
-        const spaceSlug = resolveSpaceSlug(astra);
-        await apiDelete(`/spaces/${spaceSlug}/brain-updates/${updateId}`);
-        if (isJsonMode(astra)) {
-            jsonOut({ id: updateId });
-            return;
-        }
-        console.log(`Brain update ${updateId} deleted.`);
-    });
 }

package/dist/commands/brain.js

@@ -0,0 +1,232 @@
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
+import { WEBDRIVE_BASE_URL } from "../constants.js";
+import { getValidToken } from "../auth/manager.js";
+import { getVaultSlug } from "./init.js";
+import { isJsonMode, jsonOut, resolveVaultSlug, unwrapResp } from "./utils.js";
+export function registerBrainCommand(program) {
+    const brain = program
+        .command("brain")
+        .description("Brain commands (search, ask, publish, unpublish, updates).");
+    // ── Search ──
+    brain
+        .command("search")
+        .description("Search public brains 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(brain)) {
+            jsonOut(results || []);
+            return;
+        }
+        if (!results || results.length === 0) {
+            console.log(`No brains 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(`Brains matching "${opts.query}":\n` + lines.join("\n"));
+    });
+    // ── Ask ──
+    brain
+        .command("ask")
+        .description("Ask a brain a question. Creates a targeted session (1:1 conversation).")
+        .requiredOption("--vault-slug <vaultSlug>", "Slug of the brain/vault to ask")
+        .requiredOption("--space-slug <spaceSlug>", "Space slug where the brain belongs")
+        .requiredOption("--question <question>", "The question to ask (markdown supported)")
+        .option("--mode <mode>", 'Session mode: "auto" or "manual"')
+        .action(async (opts) => {
+        const spaceSlug = opts.spaceSlug;
+        const body = {
+            vaultSlug: opts.vaultSlug,
+            spaceSlug,
+            question: opts.question,
+        };
+        if (opts.mode != null)
+            body.mode = opts.mode;
+        const resp = (await apiPost(`/session/targeted`, body));
+        const data = unwrapResp(resp);
+        if (isJsonMode(brain)) {
+            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 ──
+    brain
+        .command("publish")
+        .description("Upload BRAIN.md to the vault root on webdrive. Triggers post-processing (brain sync, metadata update, Discord notification).")
+        .action(async () => {
+        const vaultId = getVaultSlug();
+        const filePath = join(process.cwd(), "BRAIN.md");
+        if (!existsSync(filePath)) {
+            throw new Error(`BRAIN.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}/files/BRAIN.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(brain)) {
+            jsonOut({ vaultId });
+            return;
+        }
+        console.log(`Published BRAIN.md to vault "${vaultId}"`);
+    });
+    // ── Unpublish ──
+    brain
+        .command("unpublish")
+        .description("Delete BRAIN.md from the vault on webdrive.")
+        .action(async () => {
+        const vaultId = getVaultSlug();
+        const token = await getValidToken();
+        const url = `${WEBDRIVE_BASE_URL}/api/v1/vaults/${vaultId}/files/BRAIN.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(brain)) {
+            jsonOut({ vaultId });
+            return;
+        }
+        console.log(`Deleted BRAIN.md from vault "${vaultId}"`);
+    });
+    // ── Updates (list, post, edit, delete) ──
+    brain
+        .command("list-updates")
+        .description("List recent brain updates. Without --space-slug, lists all updates for you. With --space-slug, lists updates for that space. Use --mine to show only updates by you.")
+        .option("--vault-slug <vaultSlug>", "Vault slug (overrides .gobi/settings.yaml)")
+        .option("--space-slug <spaceSlug>", "List updates for a space")
+        .option("--mine", "List only my own brain updates")
+        .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;
+        if (opts.mine)
+            params.mine = true;
+        if (opts.vaultSlug)
+            params.vaultSlug = opts.vaultSlug;
+        const path = opts.spaceSlug
+            ? `/spaces/${opts.spaceSlug}/brain-updates`
+            : `/brain-updates`;
+        const resp = (await apiGet(path, params));
+        if (isJsonMode(brain)) {
+            jsonOut({
+                items: resp.data || [],
+                pagination: resp.pagination || {},
+            });
+            return;
+        }
+        const items = (resp.data || []);
+        const pagination = (resp.pagination || {});
+        if (!items.length) {
+            console.log("No brain updates found.");
+            return;
+        }
+        const lines = [];
+        for (const u of items) {
+            const author = u.author?.name ||
+                `User ${u.authorId}`;
+            const vaultSlug = u.vault?.vaultSlug ||
+                "?";
+            lines.push(`- [${u.id}] "${u.title}" by ${author} (vault: ${vaultSlug}, ${u.createdAt})`);
+        }
+        const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
+        console.log(`Brain updates (${items.length} items):\n` + lines.join("\n") + footer);
+    });
+    brain
+        .command("post-update")
+        .description("Post a brain update for a vault.")
+        .option("--vault-slug <vaultSlug>", "Vault slug (overrides .gobi/settings.yaml)")
+        .requiredOption("--title <title>", "Title of the update")
+        .requiredOption("--content <content>", "Update content (markdown supported)")
+        .action(async (opts) => {
+        const vaultSlug = resolveVaultSlug(opts);
+        const resp = (await apiPost(`/brain-updates/vault/${vaultSlug}`, {
+            title: opts.title,
+            content: opts.content,
+        }));
+        const u = unwrapResp(resp);
+        if (isJsonMode(brain)) {
+            jsonOut(u);
+            return;
+        }
+        console.log(`Brain update posted!\n` +
+            `  ID: ${u.id}\n` +
+            `  Title: ${u.title}\n` +
+            `  Vault: ${u.vaultSlug || vaultSlug}\n` +
+            `  Created: ${u.createdAt}`);
+    });
+    brain
+        .command("edit-update <updateId>")
+        .description("Edit a published brain update. You must be the author.")
+        .option("--title <title>", "New title for the update")
+        .option("--content <content>", "New content for the update (markdown supported)")
+        .action(async (updateId, opts) => {
+        if (!opts.title && !opts.content) {
+            throw new Error("Provide at least --title or --content to update.");
+        }
+        const body = {};
+        if (opts.title != null)
+            body.title = opts.title;
+        if (opts.content != null)
+            body.content = opts.content;
+        const resp = (await apiPatch(`/brain-updates/${updateId}`, body));
+        const u = unwrapResp(resp);
+        if (isJsonMode(brain)) {
+            jsonOut(u);
+            return;
+        }
+        console.log(`Brain update edited!\n` +
+            `  ID: ${u.id}\n` +
+            `  Title: ${u.title}\n` +
+            `  Updated: ${u.updatedAt}`);
+    });
+    brain
+        .command("delete-update <updateId>")
+        .description("Delete a published brain update. You must be the author.")
+        .action(async (updateId) => {
+        await apiDelete(`/brain-updates/${updateId}`);
+        if (isJsonMode(brain)) {
+            jsonOut({ id: updateId });
+            return;
+        }
+        console.log(`Brain update ${updateId} deleted.`);
+    });
+}

package/dist/commands/init.js

@@ -21,7 +21,7 @@ export function getSpaceSlug() {
     const settings = readSettings();
     const slug = settings?.selectedSpaceSlug;
     if (!slug) {
-        throw new Error("Space not set. Run 'gobi astra warp' first.");
+        throw new Error("Space not set. Run 'gobi space warp' first.");
     }
     return slug;
 }
@@ -38,7 +38,7 @@ export function printContext() {
     const vault = settings?.vaultSlug;
     const space = settings?.selectedSpaceSlug;
     if (!vault && !space) {
-        console.log("Run 'gobi init' to set up, then 'gobi astra warp' to select a space.");
+        console.log("Run 'gobi init' to set up, then 'gobi space warp' to select a space.");
         return;
     }
     if (!vault) {
@@ -46,7 +46,7 @@ export function printContext() {
         return;
     }
     if (!space) {
-        console.log(`Vault: ${vault} | Space not set. Run 'gobi astra warp' to select a space.`);
+        console.log(`Vault: ${vault} | Space not set. Run 'gobi space warp' to select a space.`);
         return;
     }
     console.log(`Space: ${space} | Vault: ${vault}`);

package/dist/commands/sessions.js

@@ -0,0 +1,140 @@
+import { apiGet, apiPost, apiPatch } from "../client.js";
+import { isJsonMode, jsonOut, unwrapResp } from "./utils.js";
+export function registerSessionsCommand(program) {
+    const sessions = program
+        .command("session")
+        .description("Session commands (get, list, reply, update).");
+    // ── Get ──
+    sessions
+        .command("get <sessionId>")
+        .description("Get a session and its messages (paginated).")
+        .option("--limit <number>", "Messages per page", "20")
+        .option("--cursor <string>", "Pagination cursor from previous response")
+        .action(async (sessionId, opts) => {
+        const params = {
+            limit: parseInt(opts.limit, 10),
+        };
+        if (opts.cursor)
+            params.cursor = opts.cursor;
+        const resp = (await apiGet(`/session/${sessionId}`, params));
+        const data = unwrapResp(resp);
+        if (isJsonMode(sessions)) {
+            jsonOut(data);
+            return;
+        }
+        const session = (data.session || data);
+        const messages = (data.messages || []);
+        const pagination = (data.pagination || {});
+        const msgLines = [];
+        for (const m of messages) {
+            const author = m.author?.name ||
+                m.source ||
+                `User ${m.authorId}`;
+            const text = m.content;
+            const truncated = text.length > 200 ? text.slice(0, 200) + "\u2026" : text;
+            msgLines.push(`  - ${author}: ${truncated} (${m.createdAt})`);
+        }
+        const output = [
+            `Session: ${session.title}`,
+            `  ID: ${session.id}`,
+            `  Mode: ${session.mode}`,
+            `  Last activity: ${session.lastMessageAt}`,
+            "",
+            `Messages (${messages.length} items):`,
+            ...msgLines,
+            ...(pagination.hasMore ? [`  Next cursor: ${pagination.nextCursor}`] : []),
+        ].join("\n");
+        console.log(output);
+    });
+    // ── List ──
+    sessions
+        .command("list")
+        .description("List all sessions you are part of, sorted by most recent activity.")
+        .option("--space-slug <spaceSlug>", "Filter by space slug")
+        .option("--limit <number>", "Items per page", "20")
+        .option("--cursor <string>", "Pagination cursor from previous response")
+        .action(async (opts) => {
+        const query = { limit: parseInt(opts.limit, 10) };
+        if (opts.cursor)
+            query.cursor = opts.cursor;
+        if (opts.spaceSlug)
+            query.spaceSlug = opts.spaceSlug;
+        const resp = (await apiGet(`/session/my-sessions`, query));
+        const items = (resp.data || []);
+        const pagination = (resp.pagination || {});
+        if (isJsonMode(sessions)) {
+            jsonOut({
+                items,
+                pagination: resp.pagination || {},
+            });
+            return;
+        }
+        if (!items.length) {
+            console.log("No sessions found.");
+            return;
+        }
+        const lines = [];
+        for (const s of items) {
+            const title = s.title || "(no title)";
+            const members = s.members || [];
+            const memberCount = s.memberCount ?? 0;
+            let memberInfo = "";
+            if (members.length > 0) {
+                const names = members.map((m) => m.vaultName || m.name || "Unknown");
+                const overflow = memberCount - members.length - 1; // -1 for "me"
+                memberInfo = ` | with: ${names.join(", ")}`;
+                if (overflow > 0)
+                    memberInfo += ` +${overflow} more`;
+            }
+            lines.push(`- [${s.id}] "${title}" (mode: ${s.mode}, last activity: ${s.lastMessageAt})${memberInfo}`);
+        }
+        const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
+        console.log(`Sessions (${items.length} items):\n` + lines.join("\n") + footer);
+    });
+    // ── Reply ──
+    sessions
+        .command("reply <sessionId>")
+        .description("Send a human reply to a session you are a member of.")
+        .requiredOption("--content <content>", "Reply content (markdown supported)")
+        .action(async (sessionId, opts) => {
+        const resp = (await apiPost(`/session/${sessionId}/reply`, {
+            content: opts.content,
+        }));
+        const msg = unwrapResp(resp);
+        if (isJsonMode(sessions)) {
+            jsonOut(msg);
+            return;
+        }
+        console.log(`Reply sent!\n` +
+            `  Message ID: ${msg.id}\n` +
+            `  Source: ${msg.source}\n` +
+            `  Created: ${msg.createdAt}`);
+    });
+    // ── Update ──
+    sessions
+        .command("update <sessionId>")
+        .description('Update a session. "auto" lets the AI respond automatically; "manual" requires human replies.')
+        .option("--mode <mode>", 'Session mode: "auto" or "manual"')
+        .action(async (sessionId, opts) => {
+        if (!opts.mode) {
+            throw new Error("Provide at least one option to update (e.g. --mode).");
+        }
+        const body = {};
+        if (opts.mode != null) {
+            if (opts.mode !== "auto" && opts.mode !== "manual") {
+                throw new Error('Invalid mode. Must be "auto" or "manual".');
+            }
+            body.mode = opts.mode;
+        }
+        const resp = (await apiPatch(`/session/${sessionId}`, body));
+        const data = unwrapResp(resp);
+        if (isJsonMode(sessions)) {
+            jsonOut(data);
+            return;
+        }
+        const session = (data.session || data);
+        console.log(`Session updated!\n` +
+            `  ID: ${session.id}\n` +
+            `  Mode: ${session.mode}`);
+    });
+}

package/dist/commands/utils.js

@@ -0,0 +1,19 @@
+import { getSpaceSlug, getVaultSlug } from "./init.js";
+export function isJsonMode(cmd) {
+    return !!cmd.parent?.opts().json;
+}
+export function jsonOut(data) {
+    console.log(JSON.stringify({ success: true, data }));
+}
+export function resolveSpaceSlug(cmd) {
+    return cmd.opts().spaceSlug || getSpaceSlug();
+}
+export function resolveVaultSlug(opts) {
+    return opts.vaultSlug || getVaultSlug();
+}
+export function unwrapResp(resp) {
+    if (typeof resp === "object" && resp !== null && "data" in resp) {
+        return resp.data;
+    }
+    return resp;
+}

package/dist/main.js

@@ -5,6 +5,8 @@ import { ApiError, AstraError } from "./errors.js";
 import { registerAuthCommand } from "./commands/auth.js";
 import { registerInitCommand, printContext } from "./commands/init.js";
 import { registerAstraCommand } from "./commands/astra.js";
+import { registerBrainCommand } from "./commands/brain.js";
+import { registerSessionsCommand } from "./commands/sessions.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../package.json");
 const SKIP_BANNER_COMMANDS = new Set(["auth", "init"]);
@@ -26,6 +28,8 @@ export async function cli() {
     registerAuthCommand(program);
     registerInitCommand(program);
     registerAstraCommand(program);
+    registerBrainCommand(program);
+    registerSessionsCommand(program);
     // Propagate helpWidth to all subcommands
     const helpWidth = process.stdout.columns || 200;
     for (const cmd of program.commands) {

package/package.json

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