@gobi-ai/cli 2.0.4 → 2.0.6

package/dist/commands/init.js

@@ -3,8 +3,6 @@ import { join } from "path";
 import inquirer from "inquirer";
 import yaml from "js-yaml";
 import { apiGet, apiPost } from "../client.js";
-import { isAuthenticated } from "../auth/manager.js";
-import { runLoginFlow } from "./auth.js";
 const SETTINGS_DIR = ".gobi";
 const SETTINGS_FILE = "settings.yaml";
 function settingsPath() {
@@ -21,7 +19,7 @@ export function getSpaceSlug() {
     const settings = readSettings();
     const slug = settings?.selectedSpaceSlug;
     if (!slug) {
-        throw new Error("Space not set. Run 'gobi space warp' first.");
+        throw new Error("Space not set. Run 'gobi space warp' to select a space, or pass --space-slug.");
     }
     return slug;
 }
@@ -29,27 +27,44 @@ export function getVaultSlug() {
     const settings = readSettings();
     const vault = settings?.vaultSlug;
     if (!vault) {
-        throw new Error("Not initialized. Run 'gobi init' first.");
+        throw new Error("Vault not set. Run 'gobi vault init' first.");
     }
     return vault;
 }
-export function printContext() {
-    const settings = readSettings();
-    const vault = settings?.vaultSlug;
-    const space = settings?.selectedSpaceSlug;
-    if (!vault && !space) {
-        console.log("Run 'gobi init' to set up, then 'gobi space warp' to select a space.");
-        return;
-    }
-    if (!vault) {
-        console.log("Vault not set. Run 'gobi init' to set up.");
-        return;
-    }
-    if (!space) {
-        console.log(`Vault: ${vault} | Space not set. Run 'gobi space warp' to select a space.`);
-        return;
+// Per-command requirement markers. Tri-state: true / false override / inherit
+// from parent. The pre-action warning uses these to decide whether to remind
+// the user to run `gobi vault init` / `gobi space warp`.
+const REQUIRES_VAULT = Symbol.for("gobi.requiresVault");
+const REQUIRES_SPACE = Symbol.for("gobi.requiresSpace");
+export function setVaultRequirement(cmd, value) {
+    cmd[REQUIRES_VAULT] = value;
+    return cmd;
+}
+export function setSpaceRequirement(cmd, value) {
+    cmd[REQUIRES_SPACE] = value;
+    return cmd;
+}
+export function requireVault(cmd) {
+    return setVaultRequirement(cmd, true);
+}
+export function requireSpace(cmd) {
+    return setSpaceRequirement(cmd, true);
+}
+function resolveRequirement(cmd, key) {
+    let cur = cmd;
+    while (cur) {
+        const v = cur[key];
+        if (v !== undefined)
+            return v;
+        cur = cur.parent;
     }
-    console.log(`Space: ${space} | Vault: ${vault}`);
+    return false;
+}
+export function commandRequiresVault(cmd) {
+    return resolveRequirement(cmd, REQUIRES_VAULT);
+}
+export function commandRequiresSpace(cmd) {
+    return resolveRequirement(cmd, REQUIRES_SPACE);
 }
 function ensureSettingsDir() {
     const dir = join(process.cwd(), SETTINGS_DIR);
@@ -171,13 +186,7 @@ async function createNewVault() {
     console.log(`Created vault "${vault.name}" (${vault.vaultId})`);
     return { vaultId: vault.vaultId, name: vault.name };
 }
-export async function runInitFlow() {
-    if (!isAuthenticated()) {
-        console.log("Not logged in. Starting login flow...\n");
-        await runLoginFlow();
-        console.log("");
-    }
-    // Select or create vault
+export async function runVaultInitFlow() {
     let vaultId;
     let vaultName;
     while (true) {
@@ -216,11 +225,3 @@ export async function runInitFlow() {
         console.log("Created PUBLISH.md");
     }
 }
-export function registerInitCommand(program) {
-    program
-        .command("init")
-        .description("Log in (if needed) and select or create the vault for the current directory.")
-        .action(async () => {
-        await runInitFlow();
-    });
-}

package/dist/commands/media.js

@@ -127,7 +127,7 @@ export function registerMediaCommand(program) {
     //  Avatars & Voices
     // ════════════════════════════════════════════════════════════════════
     media
-        .command("avatars")
+        .command("list-avatars")
         .description("List available avatars.")
         .action(async () => {
         const resp = (await apiGet("/media-gen/avatars"));
@@ -146,7 +146,7 @@ export function registerMediaCommand(program) {
         }
     });
     media
-        .command("voices")
+        .command("list-voices")
         .description("List available voices.")
         .action(async () => {
         const resp = (await apiGet("/media-gen/voices"));
@@ -168,7 +168,7 @@ export function registerMediaCommand(program) {
     //  Videos
     // ════════════════════════════════════════════════════════════════════
     media
-        .command("video-create")
+        .command("create-video")
         .description("Create an avatar video generation job.")
         .option("--name <name>", "Name for the video (auto-generated if omitted)")
         .requiredOption("--avatar-id <avatarId>", "Avatar to use")
@@ -220,7 +220,7 @@ export function registerMediaCommand(program) {
         }
     });
     media
-        .command("video-list")
+        .command("list-videos")
         .description("List all videos.")
         .action(async () => {
         const resp = (await apiGet("/media-gen/videos"));
@@ -239,65 +239,65 @@ export function registerMediaCommand(program) {
         }
     });
     media
-        .command("video-get <id>")
+        .command("get-video <videoId>")
         .description("Get video metadata.")
-        .action(async (id) => {
-        const resp = (await apiGet(`/media-gen/videos/${id}`));
+        .action(async (videoId) => {
+        const resp = (await apiGet(`/media-gen/videos/${videoId}`));
         const data = unwrapResp(resp);
         if (isJsonMode(media)) {
             jsonOut(data);
             return;
         }
-        console.log(`Video ${id}:`);
+        console.log(`Video ${videoId}:`);
         for (const [k, v] of Object.entries(data)) {
             console.log(`  ${k}: ${typeof v === "object" ? JSON.stringify(v) : v}`);
         }
     });
     media
-        .command("video-status <id>")
-        .description("Poll video generation status.")
+        .command("get-video-status <videoId>")
+        .description("Get video generation status.")
         .option("--wait", "Poll until a terminal state is reached")
         .option("-o, --output <path>", "Download video to this path when complete (implies --wait)")
-        .action(async (id, opts) => {
+        .action(async (videoId, opts) => {
         const shouldWait = opts.wait || !!opts.output;
         if (shouldWait) {
-            const data = await pollStatus(`/media-gen/videos/${id}/status`, ["inference_complete", "inference_failed"]);
+            const data = await pollStatus(`/media-gen/videos/${videoId}/status`, ["inference_complete", "inference_failed"]);
             // Download if -o specified and completed
             if (opts.output && data.status === "inference_complete") {
-                const dlId = (data.videoId || data.id || id);
+                const dlId = (data.videoId || data.id || videoId);
                 const { contentType, size } = await downloadVideoToFile(dlId, opts.output);
                 if (isJsonMode(media)) {
                     jsonOut({ ...data, filename: opts.output, contentType, size });
                     return;
                 }
-                console.log(`Video ${id} — ${data.status}\nSaved to ${opts.output} (${size} bytes)`);
+                console.log(`Video ${videoId} — ${data.status}\nSaved to ${opts.output} (${size} bytes)`);
                 return;
             }
             if (isJsonMode(media)) {
                 jsonOut(data);
                 return;
             }
-            console.log(`Video ${id} — status: ${data.status}`);
+            console.log(`Video ${videoId} — status: ${data.status}`);
             return;
         }
-        const resp = (await apiGet(`/media-gen/videos/${id}/status`));
+        const resp = (await apiGet(`/media-gen/videos/${videoId}/status`));
         const data = unwrapResp(resp);
         if (isJsonMode(media)) {
             jsonOut(data);
             return;
         }
-        console.log(`Video ${id} — status: ${data.status || "unknown"}`);
+        console.log(`Video ${videoId} — status: ${data.status || "unknown"}`);
     });
     media
-        .command("video-download <id>")
+        .command("download-video <videoId>")
         .description("Download a completed video (or get its URL).")
         .option("-o, --output <path>", "Save video to this file path")
-        .action(async (id, opts) => {
+        .action(async (videoId, opts) => {
         const token = await getValidToken();
-        const url = `${BASE_URL}/media-gen/videos/${id}/download`;
+        const url = `${BASE_URL}/media-gen/videos/${videoId}/download`;
         // If -o specified, download directly to file
         if (opts.output) {
-            const { contentType, size } = await downloadVideoToFile(id, opts.output);
+            const { contentType, size } = await downloadVideoToFile(videoId, opts.output);
             if (isJsonMode(media)) {
                 jsonOut({ filename: opts.output, contentType, size });
                 return;
@@ -317,12 +317,12 @@ export function registerMediaCommand(program) {
                 jsonOut({ downloadUrl: location });
                 return;
             }
-            console.log(`Download URL for video ${id}:\n  ${location}`);
+            console.log(`Download URL for video ${videoId}:\n  ${location}`);
             return;
         }
         if (!res.ok) {
             const text = (await res.text()) || "(no body)";
-            throw new ApiError(res.status, `/media-gen/videos/${id}/download`, text);
+            throw new ApiError(res.status, `/media-gen/videos/${videoId}/download`, text);
         }
         // If it returns JSON instead of a redirect
         const resp = (await res.json());
@@ -331,13 +331,13 @@ export function registerMediaCommand(program) {
             jsonOut(data);
             return;
         }
-        console.log(`Download URL for video ${id}:\n  ${data.url || data.downloadUrl || JSON.stringify(data)}`);
+        console.log(`Download URL for video ${videoId}:\n  ${data.url || data.downloadUrl || JSON.stringify(data)}`);
     });
     // ════════════════════════════════════════════════════════════════════
     //  Cinematic Video
     // ════════════════════════════════════════════════════════════════════
     media
-        .command("cinematic-create")
+        .command("create-cinematic")
         .description("Create a cinematic video from a text prompt.")
         .requiredOption("--prompt <prompt>", "Text prompt describing the video")
         .option("--name <name>", "Name for the video (auto-generated if omitted)")
@@ -425,7 +425,7 @@ export function registerMediaCommand(program) {
     //  Custom Avatars
     // ════════════════════════════════════════════════════════════════════
     media
-        .command("avatar-design")
+        .command("design-avatar")
         .description("Start a design-your-avatar job.")
         .option("--name <name>", "Name for the avatar (auto-generated if omitted)")
         .requiredOption("--gender <gender>", "Gender for the avatar design")
@@ -464,13 +464,13 @@ export function registerMediaCommand(program) {
             `  Job ID: ${jobId}\n` +
             `  Status: ${status}`);
         if (status === "variants_ready") {
-            console.log(`  Confirm: gobi media avatar-confirm --job-id ${jobId}`);
+            console.log(`  Confirm: gobi media confirm-avatar --job-id ${jobId}`);
         }
     });
     media
-        .command("avatar-confirm")
+        .command("confirm-avatar")
         .description("Confirm avatar variant(s) after design.")
-        .requiredOption("--job-id <jobId>", "Job ID from avatar-design")
+        .requiredOption("--job-id <jobId>", "Job ID from design-avatar")
         .option("--variant <variant>", "Variant to confirm (1 or 2); omit to confirm both")
         .action(async (opts) => {
         const body = { jobId: opts.jobId };
@@ -491,8 +491,8 @@ export function registerMediaCommand(program) {
             `  Avatar ID: ${avatarId || JSON.stringify(data)}`);
     });
     media
-        .command("avatar-from-selfie")
-        .description("Create an avatar from a selfie (instant or enhanced with prompt).")
+        .command("design-avatar-from-selfie")
+        .description("Design an avatar from a selfie (instant or enhanced with prompt).")
         .option("--name <name>", "Name for the avatar (auto-generated if omitted)")
         .requiredOption("--photo <file>", "Selfie photo file (auto-uploaded)")
         .option("--prompt <prompt>", "Enhancement prompt (triggers async enhance flow)")
@@ -532,8 +532,8 @@ export function registerMediaCommand(program) {
         }
     });
     media
-        .command("avatar-job-status <jobId>")
-        .description("Check avatar job status.")
+        .command("get-avatar-job-status <jobId>")
+        .description("Get avatar job status.")
         .option("--wait", "Poll until a terminal state is reached")
         .action(async (jobId, opts) => {
         let data;
@@ -554,7 +554,7 @@ export function registerMediaCommand(program) {
     //  Images
     // ════════════════════════════════════════════════════════════════════
     media
-        .command("image-generate")
+        .command("generate-image")
         .description("Generate an image from a text prompt. Types: image (default), thumbnail (YouTube-optimized), asset (logo/product). Aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4")
         .requiredOption("--prompt <prompt>", "Text prompt for image generation")
         .option("--name <name>", "Name for the generated image (auto-generated from prompt if omitted)")
@@ -636,7 +636,7 @@ export function registerMediaCommand(program) {
         }
     });
     media
-        .command("image-edit")
+        .command("edit-image")
         .description("Edit an existing image with a prompt (image-to-image).")
         .requiredOption("--image <file>", "Source image file (auto-uploaded)")
         .requiredOption("--prompt <prompt>", "Edit instruction")
@@ -699,7 +699,7 @@ export function registerMediaCommand(program) {
         }
     });
     media
-        .command("image-inpaint")
+        .command("inpaint-image")
         .description("Inpaint an image region using a mask.")
         .requiredOption("--image <file>", "Source image file (auto-uploaded)")
         .requiredOption("--mask <file>", "Mask image file (auto-uploaded)")
@@ -766,8 +766,8 @@ export function registerMediaCommand(program) {
         }
     });
     media
-        .command("image-status <jobId>")
-        .description("Check image generation job status.")
+        .command("get-image-status <jobId>")
+        .description("Get image generation job status.")
         .option("--wait", "Poll until a terminal state is reached")
         .action(async (jobId, opts) => {
         let data;
@@ -794,7 +794,7 @@ export function registerMediaCommand(program) {
         }
     });
     media
-        .command("image-download <jobId>")
+        .command("download-image <jobId>")
         .description("Download a generated image.")
         .option("--wait", "Poll until generation completes before downloading")
         .option("--type <type>", "Image type (image, thumbnail, asset)")

package/dist/commands/saved.js

@@ -24,16 +24,17 @@ function formatSavedPostLine(item) {
     const space = item.spaceSlug ? `, space: ${item.spaceSlug}` : "";
     return `- [${item.postId}] "${snippet.replace(/\n/g, " ")}" by ${author ?? "?"}${space} (saved ${item.savedAt})`;
 }
-function registerNoteCommands(saved) {
-    const note = saved
-        .command("note")
-        .description("Personal saved notes (create, list, get, edit, delete).");
-    note
-        .command("list")
+export function registerSavedCommand(program) {
+    const saved = program
+        .command("saved")
+        .description("Saved-knowledge commands (notes and bookmarked posts).");
+    // ── Notes ──
+    saved
+        .command("list-notes")
         .description("List your notes. Without --date, returns recent notes via cursor pagination. With --date, returns all notes for that day.")
         .option("--date <date>", "Filter to a single day (YYYY-MM-DD)")
         .option("--timezone <tz>", "IANA timezone name (default: system timezone)")
-        .option("--limit <number>", "Items per page (1-100)", "50")
+        .option("--limit <number>", "Items per page", "20")
         .option("--cursor <string>", "Pagination cursor from previous response")
         .action(async (opts) => {
         const params = {
@@ -61,8 +62,8 @@ function registerNoteCommands(saved) {
             : "";
         console.log(`Notes (${items.length} items):\n` + lines.join("\n") + footer);
     });
-    note
-        .command("get <noteId>")
+    saved
+        .command("get-note <noteId>")
         .description("Get a single note by id.")
         .action(async (noteId) => {
         const resp = (await apiGet(`/app/notes/${noteId}`));
@@ -90,8 +91,8 @@ function registerNoteCommands(saved) {
             .trimEnd();
         console.log(output);
     });
-    note
-        .command("create")
+    saved
+        .command("create-note")
         .description("Create a note. Provide --content (use '-' for stdin) and/or attachments.")
         .option("--content <content>", 'Note content (markdown supported, use "-" for stdin)')
         .option("--timezone <tz>", "IANA timezone name (default: system timezone)")
@@ -115,8 +116,8 @@ function registerNoteCommands(saved) {
         }
         console.log(`Note created!\n  ID: ${note.id}\n  Date: ${note.eventDate}\n  Created: ${note.createdAt}`);
     });
-    note
-        .command("edit <noteId>")
+    saved
+        .command("edit-note <noteId>")
         .description("Edit a note. Provide --content and/or --agent-id.")
         .option("--content <content>", 'New note content (markdown supported, use "-" for stdin)')
         .option("--agent-id <number>", 'New agent id, or "null" to clear the association')
@@ -140,8 +141,8 @@ function registerNoteCommands(saved) {
         }
         console.log(`Note edited!\n  ID: ${note.id}\n  Updated: ${note.updatedAt}`);
     });
-    note
-        .command("delete <noteId>")
+    saved
+        .command("delete-note <noteId>")
         .description("Delete a note you authored.")
         .action(async (noteId) => {
         await apiDelete(`/app/notes/${noteId}`);
@@ -151,16 +152,12 @@ function registerNoteCommands(saved) {
         }
         console.log(`Note ${noteId} deleted.`);
     });
-}
-function registerPostCommands(saved) {
-    const post = saved
-        .command("post")
-        .description("Saved posts (snapshots of posts and replies you bookmark).");
-    post
-        .command("list")
-        .description("List posts you have saved.")
+    // ── Saved posts (bookmarks) ──
+    saved
+        .command("list-posts")
+        .description("List posts you have bookmarked (paginated).")
         .option("--type <type>", "Filter by type: all|article|space-post", "all")
-        .option("--limit <number>", "Items per page (1-50)", "20")
+        .option("--limit <number>", "Items per page", "20")
         .option("--cursor <string>", "Pagination cursor from previous response")
         .action(async (opts) => {
         const params = {
@@ -184,8 +181,8 @@ function registerPostCommands(saved) {
         const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
         console.log(`Saved posts (${items.length} items):\n` + lines.join("\n") + footer);
     });
-    post
-        .command("get <postId>")
+    saved
+        .command("get-post <postId>")
         .description("Get a saved post snapshot by post id.")
         .action(async (postId) => {
         const resp = (await apiGet(`/feed/${postId}`));
@@ -205,10 +202,10 @@ function registerPostCommands(saved) {
             post.content || "",
         ].join("\n"));
     });
-    post
-        .command("create")
-        .description("Save a post or reply. Records a snapshot in your saved-posts collection.")
-        .requiredOption("--source <id>", "Source post or reply id to save (numeric)")
+    saved
+        .command("create-post")
+        .description("Bookmark a post or reply by id. Records a snapshot in your saved-posts collection.")
+        .requiredOption("--source <id>", "Source post or reply id to bookmark (numeric)")
         .action(async (opts) => {
         const sourceId = parseInt(opts.source, 10);
         if (!Number.isFinite(sourceId)) {
@@ -219,27 +216,20 @@ function registerPostCommands(saved) {
         }));
         const data = unwrapResp(resp);
         if (isJsonMode(saved)) {
-            jsonOut({ postId: sourceId, ...data });
+            jsonOut({ id: sourceId, ...data });
             return;
         }
         console.log(`Saved post ${sourceId}.`);
     });
-    post
-        .command("delete <postId>")
+    saved
+        .command("delete-post <postId>")
         .description("Remove a post from your saved-posts collection.")
         .action(async (postId) => {
         await apiDelete(`/reactions/posts/${postId}/save`);
         if (isJsonMode(saved)) {
-            jsonOut({ postId });
+            jsonOut({ id: postId });
             return;
         }
         console.log(`Removed post ${postId} from saved.`);
     });
 }
-export function registerSavedCommand(program) {
-    const saved = program
-        .command("saved")
-        .description("Saved-knowledge commands (notes and posts).");
-    registerNoteCommands(saved);
-    registerPostCommands(saved);
-}

package/dist/commands/sense.js

@@ -6,8 +6,8 @@ export function registerSenseCommand(program) {
         .description("Sense commands (activities, transcriptions).");
     // ── Activities ──
     sense
-        .command("activities")
-        .description("Fetch activity records within a time range.")
+        .command("list-activities")
+        .description("List activity records within a time range.")
         .requiredOption("--start-time <iso>", "Start of time range (ISO 8601 UTC, e.g. 2026-03-20T00:00:00Z)")
         .requiredOption("--end-time <iso>", "End of time range (ISO 8601 UTC, e.g. 2026-03-20T23:59:59Z)")
         .action(async (opts) => {
@@ -55,8 +55,8 @@ export function registerSenseCommand(program) {
     });
     // ── Transcriptions ──
     sense
-        .command("transcriptions")
-        .description("Fetch transcription records within a time range.")
+        .command("list-transcriptions")
+        .description("List transcription records within a time range.")
         .requiredOption("--start-time <iso>", "Start of time range (ISO 8601 UTC, e.g. 2026-03-20T00:00:00Z)")
         .requiredOption("--end-time <iso>", "End of time range (ISO 8601 UTC, e.g. 2026-03-20T23:59:59Z)")
         .action(async (opts) => {

package/dist/commands/sessions.js

@@ -1,14 +1,14 @@
 import { apiGet, apiPost } from "../client.js";
-import { isJsonMode, jsonOut, unwrapResp } from "./utils.js";
+import { isJsonMode, jsonOut, readStdin, unwrapResp } from "./utils.js";
 export function registerSessionsCommand(program) {
     const sessions = program
         .command("session")
-        .description("Session commands (get, list, reply).");
+        .description("Session commands (get, list, create-reply).");
     // ── Get ──
     sessions
         .command("get <sessionId>")
         .description("Get a session and its messages (paginated).")
-        .option("--limit <number>", "Messages per page", "20")
+        .option("--limit <number>", "Items per page", "20")
         .option("--cursor <string>", "Pagination cursor from previous response")
         .action(async (sessionId, opts) => {
         const params = {
@@ -85,9 +85,9 @@ export function registerSessionsCommand(program) {
     });
     // ── Reply ──
     sessions
-        .command("reply <sessionId>")
+        .command("create-reply <sessionId>")
         .description("Send a human reply to a session you are a member of.")
-        .option("--content <content>", "Reply content (markdown supported)")
+        .option("--content <content>", "Reply content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (e.g. [{\"type\":\"text\",\"text\":\"hello\"}])")
         .action(async (sessionId, opts) => {
         if (!opts.content && !opts.richText) {
@@ -108,7 +108,7 @@ export function registerSessionsCommand(program) {
             body.richText = parsed;
         }
         else {
-            body.content = opts.content;
+            body.content = opts.content === "-" ? readStdin() : opts.content;
         }
         const resp = (await apiPost(`/chat/${sessionId}/reply`, body));
         const msg = unwrapResp(resp);