@gobi-ai/cli 2.0.4 → 2.0.6

package/dist/commands/space.js

@@ -1,5 +1,5 @@
 import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
-import { selectSpace, writeSpaceSetting } from "./init.js";
+import { requireSpace, selectSpace, setSpaceRequirement, writeSpaceSetting, } from "./init.js";
 import { isJsonMode, jsonOut, readStdin, resolveSpaceSlug, resolveVaultSlug, unwrapResp, } from "./utils.js";
 import { extractWikiLinks, uploadAttachments } from "../attachments.js";
 import { getValidToken } from "../auth/manager.js";
@@ -29,9 +29,12 @@ export function registerSpaceCommand(program) {
     const space = program
         .command("space")
         .description("Space commands (posts, replies). Space and member admin is web-UI only.")
-        .option("--space-slug <slug>", "Space slug (overrides .gobi/settings.yaml)");
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)");
+    // Default: every space subcommand needs a configured space (or --space-slug).
+    // `list`, `warp`, and `get` opt out below.
+    requireSpace(space);
     // ── List spaces ──
-    space
+    const listCmd = space
         .command("list")
         .description("List spaces you are a member of.")
         .action(async () => {
@@ -47,17 +50,22 @@ export function registerSpaceCommand(program) {
         }
         const lines = [];
         for (const s of items) {
-            const desc = s.description ? ` - ${s.description}` : "";
-            lines.push(`- [${s.slug}] ${s.name}${desc}`);
+            lines.push(`- [${s.slug}] ${s.name}`);
+            if (s.description)
+                lines.push(`    Description: ${s.description}`);
+            if (s.rules)
+                lines.push(`    Rules: ${s.rules}`);
         }
         console.log(`Spaces (${items.length}):\n` + lines.join("\n"));
     });
+    setSpaceRequirement(listCmd, false);
     // ── Get space ──
-    space
+    const getCmd = 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);
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
+        .action(async (spaceSlug, opts) => {
+        const slug = spaceSlug || resolveSpaceSlug(space, opts);
         const resp = (await apiGet(`/spaces/${slug}`));
         const s = unwrapResp(resp);
         if (isJsonMode(space)) {
@@ -69,15 +77,18 @@ export function registerSpaceCommand(program) {
             `  ID: ${s.id}\n` +
             `  Created: ${s.createdAt}`);
     });
+    // `get [spaceSlug]` accepts a positional arg; treat as not requiring space
+    // config so the no-arg case falls through to the action's own error.
+    setSpaceRequirement(getCmd, false);
     // ── Warp (space selection) ──
-    space
+    const warpCmd = space
         .command("warp [spaceSlug]")
         .description("Select the active space. Pass a slug to warp directly, or omit for interactive selection.")
         .action(async (spaceSlug) => {
         if (spaceSlug) {
             writeSpaceSetting(spaceSlug);
             if (isJsonMode(space)) {
-                jsonOut({ spaceSlug });
+                jsonOut({ spaceSlug, spaceName: null });
                 return;
             }
             console.log(`Warped to space "${spaceSlug}"`);
@@ -95,13 +106,15 @@ export function registerSpaceCommand(program) {
         }
         console.log(`Warped to space "${result.name}" (${result.slug})`);
     });
+    setSpaceRequirement(warpCmd, false);
     // ── Topics ──
     space
         .command("list-topics")
         .description("List topics in a space, ordered by most recent content linkage.")
-        .option("--limit <number>", "Max topics to return (0 = all)", "50")
+        .option("--limit <number>", "Items per page", "20")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(space);
+        const spaceSlug = resolveSpaceSlug(space, opts);
         const params = {
             limit: parseInt(opts.limit, 10),
         };
@@ -127,8 +140,9 @@ export function registerSpaceCommand(program) {
         .description("List posts tagged with a topic in a space (cursor-paginated).")
         .option("--limit <number>", "Items per page", "20")
         .option("--cursor <string>", "Pagination cursor from previous response")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .action(async (topicSlug, opts) => {
-        const spaceSlug = resolveSpaceSlug(space);
+        const spaceSlug = resolveSpaceSlug(space, opts);
         const params = {
             limit: parseInt(opts.limit, 10),
         };
@@ -165,8 +179,9 @@ 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("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(space);
+        const spaceSlug = resolveSpaceSlug(space, opts);
         const params = {
             limit: parseInt(opts.limit, 10),
         };
@@ -194,10 +209,12 @@ export function registerSpaceCommand(program) {
     space
         .command("get-post <postId>")
         .description("Get a post with its ancestors and replies (paginated).")
-        .option("--limit <number>", "Replies per page", "20")
+        .option("--limit <number>", "Items per page", "20")
         .option("--cursor <string>", "Pagination cursor from previous response")
+        .option("--full", "Show full reply content without truncation")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .action(async (postId, opts) => {
-        const spaceSlug = resolveSpaceSlug(space);
+        const spaceSlug = resolveSpaceSlug(space, opts);
         const params = {
             limit: parseInt(opts.limit, 10),
         };
@@ -231,8 +248,10 @@ export function registerSpaceCommand(program) {
             const rAuthor = r.author?.name ||
                 `User ${r.authorId}`;
             const text = r.content;
-            const truncated = text && text.length > 200 ? text.slice(0, 200) + "…" : text;
-            replyLines.push(`  - ${rAuthor}: ${truncated} (${r.createdAt})`);
+            const body = opts.full || !text || text.length <= 200
+                ? text
+                : text.slice(0, 200) + "…";
+            replyLines.push(`  - ${rAuthor}: ${body} (${r.createdAt})`);
         }
         const isReplyPost = post.parentPostId != null;
         const heading = isReplyPost
@@ -258,8 +277,9 @@ 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("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(space);
+        const spaceSlug = resolveSpaceSlug(space, opts);
         const params = {
             limit: parseInt(opts.limit, 10),
         };
@@ -292,28 +312,48 @@ export function registerSpaceCommand(program) {
     space
         .command("create-post")
         .description("Create a post in a space.")
-        .requiredOption("--title <title>", "Title of the post")
-        .requiredOption("--content <content>", "Post content (markdown supported)")
+        .option("--title <title>", "Title of the post")
+        .option("--content <content>", "Post content (markdown supported, use \"-\" for stdin)")
+        .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
         .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before posting (also attributes the post to that vault)")
         .option("--vault-slug <vaultSlug>", "Attribute the post to this vault (sets authorVaultId). Also used as upload destination for --auto-attachments.")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .action(async (opts) => {
-        const content = readContent(opts.content);
+        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.");
+        }
         let authorVaultSlug;
         if (opts.vaultSlug || opts.autoAttachments) {
             authorVaultSlug = resolveVaultSlug(opts);
         }
-        if (opts.autoAttachments) {
-            const token = await getValidToken();
-            const links = extractWikiLinks(content);
-            await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
+        const body = {};
+        if (opts.title != null)
+            body.title = opts.title;
+        if (opts.content != null) {
+            const content = readContent(opts.content);
+            if (opts.autoAttachments) {
+                const token = await getValidToken();
+                const links = extractWikiLinks(content);
+                await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
+            }
+            body.content = 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 spaceSlug = resolveSpaceSlug(space);
-        const body = {
-            title: opts.title,
-            content,
-        };
         if (authorVaultSlug)
             body.authorVaultSlug = authorVaultSlug;
+        const spaceSlug = resolveSpaceSlug(space, opts);
         const resp = (await apiPost(`/spaces/${spaceSlug}/posts`, body));
         const post = unwrapResp(resp);
         if (isJsonMode(space)) {
@@ -322,28 +362,32 @@ export function registerSpaceCommand(program) {
         }
         console.log(`Post created!\n` +
             `  ID: ${post.id}\n` +
-            `  Title: ${post.title}\n` +
+            (post.title ? `  Title: ${post.title}\n` : "") +
             `  Created: ${post.createdAt}`);
     });
     space
         .command("edit-post <postId>")
-        .description("Edit a post. You must be the author.")
+        .description("Edit a post you authored in a space.")
         .option("--title <title>", "New title for the post")
-        .option("--content <content>", "New content for the post (markdown supported)")
+        .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("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before editing (also attributes the post to that vault)")
-        .option("--vault-slug <vaultSlug>", "Attribute the post to this vault (sets authorVaultId). Also used as upload destination for --auto-attachments. Pass an empty string to detach.")
+        .option("--vault-slug <vaultSlug>", "Attribute the post to this vault (sets authorVaultId). Also used as upload destination for --auto-attachments.")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .action(async (postId, opts) => {
-        const wantsVaultChange = opts.vaultSlug !== undefined || opts.autoAttachments;
-        if (!opts.title && !opts.content && !wantsVaultChange) {
-            throw new Error("Provide at least --title, --content, or --vault-slug to update.");
+        const wantsVaultChange = !!(opts.vaultSlug || opts.autoAttachments);
+        if (opts.title == null &&
+            opts.content == null &&
+            opts.richText == null &&
+            !wantsVaultChange) {
+            throw new Error("Provide at least --title, --content, --rich-text, or --vault-slug to update.");
         }
-        const spaceSlug = resolveSpaceSlug(space);
-        let authorVaultSlug;
-        if (opts.vaultSlug !== undefined) {
-            // Empty string detaches; non-empty resolves through settings fallback.
-            authorVaultSlug = opts.vaultSlug === "" ? "" : resolveVaultSlug(opts);
+        if (opts.content && opts.richText) {
+            throw new Error("--content and --rich-text are mutually exclusive.");
         }
-        else if (opts.autoAttachments) {
+        const spaceSlug = resolveSpaceSlug(space, opts);
+        let authorVaultSlug;
+        if (opts.vaultSlug || opts.autoAttachments) {
             authorVaultSlug = resolveVaultSlug(opts);
         }
         const body = {};
@@ -358,6 +402,16 @@ export function registerSpaceCommand(program) {
             }
             body.content = content;
         }
+        if (opts.richText != null) {
+            let parsed;
+            try {
+                parsed = JSON.parse(opts.richText);
+            }
+            catch {
+                throw new Error("Invalid --rich-text JSON.");
+            }
+            body.richText = parsed;
+        }
         if (authorVaultSlug !== undefined)
             body.authorVaultSlug = authorVaultSlug;
         const resp = (await apiPatch(`/spaces/${spaceSlug}/posts/${postId}`, body));
@@ -368,14 +422,15 @@ export function registerSpaceCommand(program) {
         }
         console.log(`Post edited!\n` +
             `  ID: ${post.id}\n` +
-            `  Title: ${post.title}\n` +
+            (post.title ? `  Title: ${post.title}\n` : "") +
             `  Edited: ${post.editedAt}`);
     });
     space
         .command("delete-post <postId>")
-        .description("Delete a post. You must be the author.")
-        .action(async (postId) => {
-        const spaceSlug = resolveSpaceSlug(space);
+        .description("Delete a post you authored in a space.")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
+        .action(async (postId, opts) => {
+        const spaceSlug = resolveSpaceSlug(space, opts);
         await apiDelete(`/spaces/${spaceSlug}/posts/${postId}`);
         if (isJsonMode(space)) {
             jsonOut({ id: postId });
@@ -387,10 +442,46 @@ export function registerSpaceCommand(program) {
     space
         .command("create-reply <postId>")
         .description("Create a reply to a post in a space.")
-        .requiredOption("--content <content>", "Reply content (markdown supported)")
+        .option("--content <content>", "Reply content (markdown supported, use \"-\" for stdin)")
+        .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
+        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before posting (also attributes the reply to that vault)")
+        .option("--vault-slug <vaultSlug>", "Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .action(async (postId, opts) => {
-        const spaceSlug = resolveSpaceSlug(space);
-        const resp = (await apiPost(`/spaces/${spaceSlug}/posts/${postId}/replies`, { content: readContent(opts.content) }));
+        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.");
+        }
+        let authorVaultSlug;
+        if (opts.vaultSlug || opts.autoAttachments) {
+            authorVaultSlug = resolveVaultSlug(opts);
+        }
+        const body = {};
+        if (opts.content != null) {
+            const content = readContent(opts.content);
+            if (opts.autoAttachments) {
+                const token = await getValidToken();
+                const links = extractWikiLinks(content);
+                await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
+            }
+            body.content = content;
+        }
+        if (opts.richText != null) {
+            let parsed;
+            try {
+                parsed = JSON.parse(opts.richText);
+            }
+            catch {
+                throw new Error("Invalid --rich-text JSON.");
+            }
+            body.richText = parsed;
+        }
+        if (authorVaultSlug)
+            body.authorVaultSlug = authorVaultSlug;
+        const spaceSlug = resolveSpaceSlug(space, opts);
+        const resp = (await apiPost(`/spaces/${spaceSlug}/posts/${postId}/replies`, body));
         const msg = unwrapResp(resp);
         const mentions = (resp.mentions || {});
         if (isJsonMode(space)) {
@@ -401,20 +492,48 @@ export function registerSpaceCommand(program) {
     });
     space
         .command("edit-reply <replyId>")
-        .description("Edit a reply. You must be the author.")
-        .requiredOption("--content <content>", "New content for the reply (markdown supported)")
-        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before editing")
-        .option("--vault-slug <vaultSlug>", "Vault slug for attachment uploads (overrides .gobi/settings.yaml)")
+        .description("Edit a reply you authored in a space.")
+        .option("--content <content>", "New content for the reply (markdown supported, use \"-\" for stdin)")
+        .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
+        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before editing (also attributes the reply to that vault)")
+        .option("--vault-slug <vaultSlug>", "Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .action(async (replyId, opts) => {
-        const spaceSlug = resolveSpaceSlug(space);
-        const content = readContent(opts.content);
-        if (opts.autoAttachments) {
-            const vaultSlug = resolveVaultSlug(opts);
-            const token = await getValidToken();
-            const links = extractWikiLinks(content);
-            await uploadAttachments(vaultSlug, links, token, { addToSyncfiles: true });
-        }
-        const resp = (await apiPatch(`/spaces/${spaceSlug}/replies/${replyId}`, { content }));
+        const wantsVaultChange = !!(opts.vaultSlug || opts.autoAttachments);
+        if (opts.content == null && opts.richText == null && !wantsVaultChange) {
+            throw new Error("Provide at least --content, --rich-text, or --vault-slug to update.");
+        }
+        if (opts.content && opts.richText) {
+            throw new Error("--content and --rich-text are mutually exclusive.");
+        }
+        const spaceSlug = resolveSpaceSlug(space, opts);
+        let authorVaultSlug;
+        if (opts.vaultSlug || opts.autoAttachments) {
+            authorVaultSlug = resolveVaultSlug(opts);
+        }
+        const body = {};
+        if (opts.content != null) {
+            const content = readContent(opts.content);
+            if (opts.autoAttachments) {
+                const token = await getValidToken();
+                const links = extractWikiLinks(content);
+                await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
+            }
+            body.content = content;
+        }
+        if (opts.richText != null) {
+            let parsed;
+            try {
+                parsed = JSON.parse(opts.richText);
+            }
+            catch {
+                throw new Error("Invalid --rich-text JSON.");
+            }
+            body.richText = parsed;
+        }
+        if (authorVaultSlug !== undefined)
+            body.authorVaultSlug = authorVaultSlug;
+        const resp = (await apiPatch(`/spaces/${spaceSlug}/replies/${replyId}`, body));
         const msg = unwrapResp(resp);
         if (isJsonMode(space)) {
             jsonOut(msg);
@@ -424,12 +543,13 @@ export function registerSpaceCommand(program) {
     });
     space
         .command("delete-reply <replyId>")
-        .description("Delete a reply. You must be the author.")
-        .action(async (replyId) => {
-        const spaceSlug = resolveSpaceSlug(space);
+        .description("Delete a reply you authored in a space.")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
+        .action(async (replyId, opts) => {
+        const spaceSlug = resolveSpaceSlug(space, opts);
         await apiDelete(`/spaces/${spaceSlug}/replies/${replyId}`);
         if (isJsonMode(space)) {
-            jsonOut({ replyId });
+            jsonOut({ id: replyId });
             return;
         }
         console.log(`Reply ${replyId} deleted.`);

package/dist/commands/utils.js

@@ -11,8 +11,13 @@ export function isJsonMode(cmd) {
 export function jsonOut(data) {
     console.log(JSON.stringify({ success: true, data }));
 }
-export function resolveSpaceSlug(cmd) {
-    return cmd.opts().spaceSlug || getSpaceSlug();
+// Resolves the space slug from (in order): the leaf subcommand's --space-slug
+// option, the parent `gobi space` command's --space-slug option, then
+// `.gobi/settings.yaml`. Either side of the subcommand works:
+//   gobi space --space-slug foo list-posts   (parent-level)
+//   gobi space list-posts --space-slug foo   (leaf-level)
+export function resolveSpaceSlug(parent, leafOpts) {
+    return leafOpts?.spaceSlug || parent.opts().spaceSlug || getSpaceSlug();
 }
 export function resolveVaultSlug(opts) {
     return opts.vaultSlug || getVaultSlug();

package/dist/commands/vault.js

@@ -3,15 +3,48 @@ import { join, resolve as pathResolve } from "path";
 import { WEBDRIVE_BASE_URL } from "../constants.js";
 import { getValidToken } from "../auth/manager.js";
 import { GobiError } from "../errors.js";
-import { getVaultSlug } from "./init.js";
+import { apiGet } from "../client.js";
+import { getVaultSlug, requireVault, runVaultInitFlow } from "./init.js";
 import { isJsonMode, jsonOut } from "./utils.js";
 import { runSync } from "./sync.js";
 export const PUBLISH_FILENAME = "PUBLISH.md";
 export function registerVaultCommand(program) {
     const vault = program
         .command("vault")
-        .description("Vault commands (publish/unpublish profile, sync files).");
+        .description("Vault commands (init, list, publish/unpublish profile, sync files).");
     vault
+        .command("init")
+        .description("Select or create the vault for the current directory. Writes .gobi/settings.yaml and seeds PUBLISH.md.")
+        .action(async () => {
+        await runVaultInitFlow();
+    });
+    vault
+        .command("list")
+        .description("List vaults you own.")
+        .action(async () => {
+        const resp = (await apiGet("/vaults"));
+        const items = (Array.isArray(resp)
+            ? resp
+            : Array.isArray(resp?.data)
+                ? resp.data
+                : []);
+        if (isJsonMode(vault)) {
+            jsonOut(items);
+            return;
+        }
+        if (!items.length) {
+            console.log("No vaults found.");
+            return;
+        }
+        const lines = [];
+        for (const v of items) {
+            const slug = (v.vaultId || v.slug);
+            const isPrimary = v.isPrimary ? " (primary)" : "";
+            lines.push(`- [${slug}] ${v.name}${isPrimary}`);
+        }
+        console.log(`Vaults (${items.length}):\n` + lines.join("\n"));
+    });
+    const publishCmd = vault
         .command("publish")
         .description(`Upload ${PUBLISH_FILENAME} to the vault root on webdrive. Triggers post-processing (vault sync, metadata update, Discord notification).`)
         .action(async () => {
@@ -40,7 +73,8 @@ export function registerVaultCommand(program) {
         }
         console.log(`Published ${PUBLISH_FILENAME} to vault "${vaultId}"`);
     });
-    vault
+    requireVault(publishCmd);
+    const unpublishCmd = vault
         .command("unpublish")
         .description(`Delete ${PUBLISH_FILENAME} from the vault on webdrive.`)
         .action(async () => {
@@ -60,7 +94,8 @@ export function registerVaultCommand(program) {
         }
         console.log(`Deleted ${PUBLISH_FILENAME} from vault "${vaultId}"`);
     });
-    vault
+    requireVault(unpublishCmd);
+    const syncCmd = vault
         .command("sync")
         .description("Sync local vault files with Gobi Webdrive.")
         .option("--upload-only", "Only upload local changes to server")
@@ -110,4 +145,5 @@ export function registerVaultCommand(program) {
             jsonMode: isJsonMode(this),
         });
     });
+    requireVault(syncCmd);
 }

package/dist/main.js

@@ -3,7 +3,7 @@ import { Command } from "commander";
 import { initCredentials } from "./auth/manager.js";
 import { ApiError, GobiError } from "./errors.js";
 import { registerAuthCommand } from "./commands/auth.js";
-import { registerInitCommand, printContext } from "./commands/init.js";
+import { commandRequiresSpace, commandRequiresVault, readSettings, } from "./commands/init.js";
 import { registerSpaceCommand } from "./commands/space.js";
 import { registerGlobalCommand } from "./commands/global.js";
 import { registerVaultCommand } from "./commands/vault.js";
@@ -15,12 +15,38 @@ import { registerMediaCommand } from "./commands/media.js";
 import { registerDraftCommand } from "./commands/draft.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../package.json");
-const SKIP_BANNER_COMMANDS = new Set(["auth", "init", "update"]);
-function shouldShowBanner() {
-    const args = process.argv.slice(2);
-    if (args.length === 0)
-        return true;
-    return !SKIP_BANNER_COMMANDS.has(args[0]);
+function hasParentOption(cmd, key) {
+    let cur = cmd;
+    while (cur) {
+        const v = cur.opts()[key];
+        if (v !== undefined && v !== "" && v !== false)
+            return true;
+        cur = cur.parent;
+    }
+    return false;
+}
+function maybePrintRequirementWarnings(actionCommand) {
+    const needsVault = commandRequiresVault(actionCommand);
+    const needsSpace = commandRequiresSpace(actionCommand);
+    if (!needsVault && !needsSpace)
+        return;
+    const settings = readSettings();
+    const hasVault = !!settings?.vaultSlug;
+    const hasSpace = !!settings?.selectedSpaceSlug;
+    const vaultOverride = hasParentOption(actionCommand, "vaultSlug");
+    const spaceOverride = hasParentOption(actionCommand, "spaceSlug");
+    const warnings = [];
+    if (needsVault && !hasVault && !vaultOverride) {
+        warnings.push("Vault not set. Run 'gobi vault init' first, or pass --vault-slug.");
+    }
+    if (needsSpace && !hasSpace && !spaceOverride) {
+        warnings.push("Space not set. Run 'gobi space warp' first, or pass --space-slug.");
+    }
+    if (warnings.length) {
+        for (const w of warnings)
+            console.log(w);
+        console.log("");
+    }
 }
 export async function cli() {
     const program = new Command();
@@ -32,7 +58,6 @@ export async function cli() {
         .configureHelp({ helpWidth: process.stdout.columns || 200 });
     // Register all command groups
     registerAuthCommand(program);
-    registerInitCommand(program);
     registerSpaceCommand(program);
     registerGlobalCommand(program);
     registerVaultCommand(program);
@@ -50,12 +75,11 @@ export async function cli() {
             sub.configureHelp({ helpWidth });
         }
     }
-    // Hook into the pre-action to init credentials and show banner
-    program.hook("preAction", async () => {
+    // Hook into the pre-action to init credentials and show requirement warnings
+    program.hook("preAction", async (_thisCommand, actionCommand) => {
         await initCredentials();
-        if (!program.opts().json && shouldShowBanner()) {
-            printContext();
-            console.log("");
+        if (!program.opts().json) {
+            maybePrintRequirementWarnings(actionCommand);
         }
     });
     try {

package/package.json

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