@gobi-ai/cli 1.3.8 → 2.0.1

package/dist/commands/space.js

@@ -1,18 +1,17 @@
-import { readFileSync } from "fs";
 import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
 import { selectSpace, writeSpaceSetting } from "./init.js";
-import { isJsonMode, jsonOut, resolveSpaceSlug, resolveVaultSlug, unwrapResp } from "./utils.js";
+import { isJsonMode, jsonOut, readStdin, resolveSpaceSlug, resolveVaultSlug, unwrapResp, } from "./utils.js";
 import { extractWikiLinks, uploadAttachments } from "../attachments.js";
 import { getValidToken } from "../auth/manager.js";
 function readContent(value) {
     if (value === "-")
-        return readFileSync("/dev/stdin", "utf8");
+        return readStdin();
     return value;
 }
-function formatMessageLine(m) {
-    const isReply = m.parentThreadId != null;
-    const id = `[${isReply ? "r" : "t"}:${m.id}]`;
-    const kind = isReply ? "reply " : "thread";
+function formatFeedLine(m) {
+    const isReply = m.parentPostId != null;
+    const id = `[${isReply ? "r" : "p"}:${m.id}]`;
+    const kind = isReply ? "reply" : "post ";
     const author = m.author?.name ||
         `User ${m.authorId ?? "?"}`;
     let label;
@@ -29,7 +28,7 @@ function formatMessageLine(m) {
 export function registerSpaceCommand(program) {
     const space = program
         .command("space")
-        .description("Space commands (threads, replies). Space and member admin is web-UI only.")
+        .description("Space commands (posts, replies). Space and member admin is web-UI only.")
         .option("--space-slug <slug>", "Space slug (overrides .gobi/settings.yaml)");
     // ── List spaces ──
     space
@@ -124,8 +123,8 @@ export function registerSpaceCommand(program) {
         console.log(`Topics (${items.length}):\n` + lines.join("\n"));
     });
     space
-        .command("list-topic-threads <topicSlug>")
-        .description("List threads tagged with a topic in a space (cursor-paginated).")
+        .command("list-topic-posts <topicSlug>")
+        .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")
         .action(async (topicSlug, opts) => {
@@ -135,7 +134,7 @@ export function registerSpaceCommand(program) {
         };
         if (opts.cursor)
             params.cursor = opts.cursor;
-        const resp = (await apiGet(`/spaces/${spaceSlug}/topics/${topicSlug}/threads`, params));
+        const resp = (await apiGet(`/spaces/${spaceSlug}/topics/${topicSlug}/posts`, params));
         const data = unwrapResp(resp);
         const pagination = (resp.pagination || {});
         if (isJsonMode(space)) {
@@ -143,27 +142,27 @@ export function registerSpaceCommand(program) {
             return;
         }
         const topic = (data.topic || {});
-        const threads = (data.threads || []);
-        if (!threads.length) {
-            console.log(`No threads found for topic "${topic.name || topicSlug}".`);
+        const posts = (data.posts || []);
+        if (!posts.length) {
+            console.log(`No posts found for topic "${topic.name || topicSlug}".`);
             return;
         }
         const lines = [];
-        for (const t of threads) {
+        for (const t of posts) {
             const author = t.author?.name || "Unknown";
             const spaceName = t.space?.name || "";
             lines.push(`- [${t.id}] "${t.title}" by ${author} in ${spaceName} (${t.replyCount} replies, ${t.createdAt})`);
         }
         const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
         console.log(`Topic: ${topic.name || topicSlug}\n` +
-            `Threads (${threads.length} items):\n` +
+            `Posts (${posts.length} items):\n` +
             lines.join("\n") +
             footer);
     });
-    // ── Messages (unified feed) ──
+    // ── Feed (unified) ──
     space
-        .command("messages")
-        .description("List the unified message feed (threads and replies, newest first) in a space.")
+        .command("feed")
+        .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")
         .action(async (opts) => {
@@ -173,7 +172,7 @@ export function registerSpaceCommand(program) {
         };
         if (opts.cursor)
             params.cursor = opts.cursor;
-        const resp = (await apiGet(`/spaces/${spaceSlug}/messages`, params));
+        const resp = (await apiGet(`/spaces/${spaceSlug}/feed`, params));
         if (isJsonMode(space)) {
             jsonOut({
                 items: resp.data || [],
@@ -184,74 +183,69 @@ export function registerSpaceCommand(program) {
         const items = (resp.data || []);
         const pagination = (resp.pagination || {});
         if (!items.length) {
-            console.log("No messages found.");
+            console.log("No items found.");
             return;
         }
-        const lines = items.map(formatMessageLine);
+        const lines = items.map(formatFeedLine);
         const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
-        console.log(`Messages (${items.length} items, newest first):\n` + lines.join("\n") + footer);
+        console.log(`Feed (${items.length} items, newest first):\n` + lines.join("\n") + footer);
     });
-    // ── Ancestors ──
+    // ── Posts (get, list, create, edit, delete) ──
     space
-        .command("ancestors <threadId>")
-        .description("Show the ancestor lineage of a thread or reply (root → immediate parent).")
-        .action(async (threadId) => {
-        const spaceSlug = resolveSpaceSlug(space);
-        const resp = (await apiGet(`/spaces/${spaceSlug}/threads/${threadId}/ancestors`));
-        const data = unwrapResp(resp);
-        const ancestors = (data.ancestors || []);
-        if (isJsonMode(space)) {
-            jsonOut({ ancestors });
-            return;
-        }
-        if (!ancestors.length) {
-            console.log("No ancestors (this is a root thread).");
-            return;
-        }
-        const lines = [];
-        ancestors.forEach((a, i) => {
-            lines.push(`${i + 1}. ${formatMessageLine(a)}`);
-        });
-        console.log(`Ancestors (${ancestors.length} items, root first):\n` + lines.join("\n"));
-    });
-    // ── Threads (get, list, create, edit, delete) ──
-    space
-        .command("get-thread <threadId>")
-        .description("Get a thread and its replies (paginated).")
+        .command("get-post <postId>")
+        .description("Get a post with its ancestors and replies (paginated).")
         .option("--limit <number>", "Replies per page", "20")
         .option("--cursor <string>", "Pagination cursor from previous response")
-        .action(async (threadId, opts) => {
+        .action(async (postId, opts) => {
         const spaceSlug = resolveSpaceSlug(space);
         const params = {
             limit: parseInt(opts.limit, 10),
         };
         if (opts.cursor)
             params.cursor = opts.cursor;
-        const resp = (await apiGet(`/spaces/${spaceSlug}/threads/${threadId}`, params));
-        const data = unwrapResp(resp);
-        const pagination = (resp.pagination || {});
-        const mentions = (resp.mentions || {});
+        const [postResp, ancestorsResp] = await Promise.all([
+            apiGet(`/spaces/${spaceSlug}/posts/${postId}`, params),
+            apiGet(`/spaces/${spaceSlug}/posts/${postId}/ancestors`),
+        ]);
+        const data = unwrapResp(postResp);
+        const pagination = (postResp.pagination || {});
+        const mentions = (postResp.mentions || {});
+        const ancestorsData = unwrapResp(ancestorsResp);
+        const ancestors = (ancestorsData.ancestors || []);
         if (isJsonMode(space)) {
-            jsonOut({ ...data, pagination, mentions });
+            jsonOut({ ...data, ancestors, pagination, mentions });
             return;
         }
-        const thread = (data.thread || data);
+        const post = (data.thread || data);
         const replies = (data.items || []);
-        const author = thread.author?.name ||
-            `User ${thread.authorId}`;
+        const author = post.author?.name ||
+            `User ${post.authorId}`;
+        const ancestorLines = [];
+        if (ancestors.length) {
+            ancestors.forEach((a, i) => {
+                ancestorLines.push(`  ${i + 1}. ${formatFeedLine(a)}`);
+            });
+        }
         const replyLines = [];
         for (const r of replies) {
             const rAuthor = r.author?.name ||
                 `User ${r.authorId}`;
             const text = r.content;
-            const truncated = text.length > 200 ? text.slice(0, 200) + "\u2026" : text;
+            const truncated = text && text.length > 200 ? text.slice(0, 200) + "…" : text;
             replyLines.push(`  - ${rAuthor}: ${truncated} (${r.createdAt})`);
         }
+        const isReplyPost = post.parentPostId != null;
+        const heading = isReplyPost
+            ? `Reply [r:${post.id}]`
+            : `Post: ${post.title || "(no title)"}`;
         const output = [
-            `Thread: ${thread.title}`,
-            `By: ${author} on ${thread.createdAt}`,
+            heading,
+            `By: ${author} on ${post.createdAt}`,
+            ...(ancestorLines.length
+                ? ["", `Ancestors (${ancestors.length} items, root first):`, ...ancestorLines]
+                : []),
             "",
-            thread.content,
+            post.content || "",
             "",
             `Replies (${replies.length} items):`,
             ...replyLines,
@@ -260,8 +254,8 @@ export function registerSpaceCommand(program) {
         console.log(output);
     });
     space
-        .command("list-threads")
-        .description("List threads in a space (paginated).")
+        .command("list-posts")
+        .description("List posts in a space (paginated).")
         .option("--limit <number>", "Items per page", "20")
         .option("--cursor <string>", "Pagination cursor from previous response")
         .action(async (opts) => {
@@ -271,7 +265,7 @@ export function registerSpaceCommand(program) {
         };
         if (opts.cursor)
             params.cursor = opts.cursor;
-        const resp = (await apiGet(`/spaces/${spaceSlug}/threads`, params));
+        const resp = (await apiGet(`/spaces/${spaceSlug}/posts`, params));
         if (isJsonMode(space)) {
             jsonOut({
                 items: resp.data || [],
@@ -283,7 +277,7 @@ export function registerSpaceCommand(program) {
         const items = (resp.data || []);
         const pagination = (resp.pagination || {});
         if (!items.length) {
-            console.log("No threads found.");
+            console.log("No posts found.");
             return;
         }
         const lines = [];
@@ -293,94 +287,110 @@ export function registerSpaceCommand(program) {
             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);
+        console.log(`Posts (${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)")
-        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before posting")
-        .option("--vault-slug <vaultSlug>", "Vault slug for attachment uploads (overrides .gobi/settings.yaml)")
+        .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("--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.")
         .action(async (opts) => {
         const content = readContent(opts.content);
+        let authorVaultSlug;
+        if (opts.vaultSlug || opts.autoAttachments) {
+            authorVaultSlug = resolveVaultSlug(opts);
+        }
         if (opts.autoAttachments) {
-            const vaultSlug = resolveVaultSlug(opts);
             const token = await getValidToken();
             const links = extractWikiLinks(content);
-            await uploadAttachments(vaultSlug, links, token, { addToSyncfiles: true });
+            await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
         }
         const spaceSlug = resolveSpaceSlug(space);
-        const resp = (await apiPost(`/spaces/${spaceSlug}/threads`, {
+        const body = {
             title: opts.title,
             content,
-        }));
-        const thread = unwrapResp(resp);
+        };
+        if (authorVaultSlug)
+            body.authorVaultSlug = authorVaultSlug;
+        const resp = (await apiPost(`/spaces/${spaceSlug}/posts`, body));
+        const post = unwrapResp(resp);
         if (isJsonMode(space)) {
-            jsonOut(thread);
+            jsonOut(post);
             return;
         }
-        console.log(`Thread created!\n` +
-            `  ID: ${thread.id}\n` +
-            `  Title: ${thread.title}\n` +
-            `  Created: ${thread.createdAt}`);
+        console.log(`Post created!\n` +
+            `  ID: ${post.id}\n` +
+            `  Title: ${post.title}\n` +
+            `  Created: ${post.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)")
-        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before editing")
-        .option("--vault-slug <vaultSlug>", "Vault slug for attachment uploads (overrides .gobi/settings.yaml)")
-        .action(async (threadId, opts) => {
-        if (!opts.title && !opts.content) {
-            throw new Error("Provide at least --title or --content to update.");
+        .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)")
+        .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.")
+        .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 spaceSlug = resolveSpaceSlug(space);
+        let authorVaultSlug;
+        if (opts.vaultSlug !== undefined) {
+            // Empty string detaches; non-empty resolves through settings fallback.
+            authorVaultSlug = opts.vaultSlug === "" ? "" : resolveVaultSlug(opts);
+        }
+        else if (opts.autoAttachments) {
+            authorVaultSlug = resolveVaultSlug(opts);
+        }
         const body = {};
         if (opts.title != null)
             body.title = opts.title;
         if (opts.content != null) {
             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 });
+                await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
             }
             body.content = content;
         }
-        const resp = (await apiPatch(`/spaces/${spaceSlug}/threads/${threadId}`, body));
-        const thread = unwrapResp(resp);
+        if (authorVaultSlug !== undefined)
+            body.authorVaultSlug = authorVaultSlug;
+        const resp = (await apiPatch(`/spaces/${spaceSlug}/posts/${postId}`, body));
+        const post = unwrapResp(resp);
         if (isJsonMode(space)) {
-            jsonOut(thread);
+            jsonOut(post);
             return;
         }
-        console.log(`Thread edited!\n` +
-            `  ID: ${thread.id}\n` +
-            `  Title: ${thread.title}\n` +
-            `  Edited: ${thread.editedAt}`);
+        console.log(`Post edited!\n` +
+            `  ID: ${post.id}\n` +
+            `  Title: ${post.title}\n` +
+            `  Edited: ${post.editedAt}`);
     });
     space
-        .command("delete-thread <threadId>")
-        .description("Delete a thread. You must be the author.")
-        .action(async (threadId) => {
+        .command("delete-post <postId>")
+        .description("Delete a post. You must be the author.")
+        .action(async (postId) => {
         const spaceSlug = resolveSpaceSlug(space);
-        await apiDelete(`/spaces/${spaceSlug}/threads/${threadId}`);
+        await apiDelete(`/spaces/${spaceSlug}/posts/${postId}`);
         if (isJsonMode(space)) {
-            jsonOut({ id: threadId });
+            jsonOut({ id: postId });
             return;
         }
-        console.log(`Thread ${threadId} deleted.`);
+        console.log(`Post ${postId} deleted.`);
     });
     // ── Replies (create, edit, delete) ──
     space
-        .command("create-reply <threadId>")
-        .description("Create a reply to a thread in a space.")
+        .command("create-reply <postId>")
+        .description("Create a reply to a post in a space.")
         .requiredOption("--content <content>", "Reply content (markdown supported)")
-        .action(async (threadId, opts) => {
+        .action(async (postId, opts) => {
         const spaceSlug = resolveSpaceSlug(space);
-        const resp = (await apiPost(`/spaces/${spaceSlug}/threads/${threadId}/replies`, { content: readContent(opts.content) }));
+        const resp = (await apiPost(`/spaces/${spaceSlug}/posts/${postId}/replies`, { content: readContent(opts.content) }));
         const msg = unwrapResp(resp);
         const mentions = (resp.mentions || {});
         if (isJsonMode(space)) {

package/dist/commands/sync.js

@@ -1,7 +1,7 @@
 import { createHash } from "crypto";
 import { existsSync, readFileSync, rmSync, mkdirSync, readdirSync, statSync } from "fs";
 import { writeFile } from "fs/promises";
-import { join, dirname, extname, resolve as pathResolve } from "path";
+import { join, dirname, extname } from "path";
 import Database from "better-sqlite3";
 import inquirer from "inquirer";
 import ignore from "ignore";
@@ -9,8 +9,7 @@ import trash from "trash";
 import { WEBDRIVE_BASE_URL } from "../constants.js";
 import { getValidToken } from "../auth/manager.js";
 import { GobiError } from "../errors.js";
-import { getVaultSlug } from "./init.js";
-import { isJsonMode, jsonOut } from "./utils.js";
+import { jsonOut } from "./utils.js";
 // ─── Constants ────────────────────────────────────────────────────────────────
 const SYNC_IGNORE_NAMES = new Set([
     ".gobi",
@@ -880,56 +879,3 @@ async function executeSyncPlan(opts, baseUrl, token, gobiDir) {
     }
     return result;
 }
-// ─── Commander Registration ───────────────────────────────────────────────────
-export function registerSyncCommand(program) {
-    program
-        .command("sync")
-        .description("Sync local vault files with Gobi Webdrive.")
-        .option("--upload-only", "Only upload local changes to server")
-        .option("--download-only", "Only download server changes to local")
-        .option("--conflict <strategy>", "Conflict resolution strategy: ask|server|client|skip", "ask")
-        .option("--dir <path>", "Local vault directory (default: current directory)")
-        .option("--dry-run", "Preview changes without making them")
-        .option("--full", "Full sync: ignore cursor and hash cache, re-check every file")
-        .option("--path <path>", "Restrict sync to a specific file or folder (repeatable)", (v, prev) => prev.concat(v), [])
-        .option("--plan-file <path>", "Write dry-run plan to file (use with --dry-run) or read plan to execute (use with --execute)")
-        .option("--execute", "Execute a previously written plan file (requires --plan-file)")
-        .option("--conflict-choices <json>", "Per-file conflict resolutions as JSON object, e.g. '{\"file.md\":\"server\"}' (use with --execute)")
-        .action(async function (opts) {
-        if (opts.uploadOnly && opts.downloadOnly) {
-            throw new GobiError("--upload-only and --download-only are mutually exclusive.", "INVALID_OPTION");
-        }
-        if (opts.execute && !opts.planFile) {
-            throw new GobiError("--execute requires --plan-file", "INVALID_OPTION");
-        }
-        const validStrategies = ["ask", "server", "client", "skip"];
-        if (!validStrategies.includes(opts.conflict)) {
-            throw new GobiError(`Invalid --conflict value "${opts.conflict}". Use: ask|server|client|skip`, "INVALID_OPTION");
-        }
-        let conflictChoices;
-        if (opts.conflictChoices) {
-            try {
-                conflictChoices = JSON.parse(opts.conflictChoices);
-            }
-            catch {
-                throw new GobiError("--conflict-choices must be valid JSON", "INVALID_OPTION");
-            }
-        }
-        const vaultSlug = getVaultSlug();
-        const dir = opts.dir ? pathResolve(opts.dir) : process.cwd();
-        await runSync({
-            vaultSlug,
-            dir,
-            uploadOnly: !!opts.uploadOnly,
-            downloadOnly: !!opts.downloadOnly,
-            conflict: opts.conflict,
-            dryRun: !!opts.dryRun,
-            full: !!opts.full,
-            paths: opts.path ?? [],
-            planFile: opts.planFile,
-            execute: !!opts.execute,
-            conflictChoices,
-            jsonMode: isJsonMode(this),
-        });
-    });
-}

package/dist/commands/update.js

@@ -10,20 +10,26 @@ async function fetchLatestVersion() {
     const data = (await res.json());
     return data.version;
 }
-function detectInstallMethod() {
+// `which` is Unix-only; Windows uses `where`. `where` may print multiple
+// matches on separate lines — take the first one.
+function locateGobi() {
+    const cmd = process.platform === "win32" ? "where gobi" : "which gobi";
     try {
-        const gobiBin = execSync("which gobi", { encoding: "utf-8" }).trim();
-        if (gobiBin.includes("/Cellar/") || gobiBin.includes("/homebrew/")) {
-            return "brew";
-        }
+        const out = execSync(cmd, { encoding: "utf-8" }).trim();
+        return out.split(/\r?\n/)[0] || null;
     }
     catch {
-        // ignore
+        return null;
+    }
+}
+function detectInstallMethod() {
+    const gobiBin = locateGobi();
+    if (gobiBin && (gobiBin.includes("/Cellar/") || gobiBin.includes("/homebrew/"))) {
+        return "brew";
     }
     try {
         const npmGlobalDir = execSync("npm root -g", { encoding: "utf-8" }).trim();
-        const gobiBin = execSync("which gobi", { encoding: "utf-8" }).trim();
-        if (gobiBin.includes(npmGlobalDir.replace("/lib/node_modules", ""))) {
+        if (gobiBin && gobiBin.includes(npmGlobalDir.replace("/lib/node_modules", ""))) {
             return "npm";
         }
     }

package/dist/commands/utils.js

@@ -1,4 +1,10 @@
+import { readFileSync } from "fs";
 import { getSpaceSlug, getVaultSlug } from "./init.js";
+// Reads all of stdin synchronously. Uses fd 0 (cross-platform) instead of
+// "/dev/stdin", which doesn't exist on Windows.
+export function readStdin() {
+    return readFileSync(0, "utf8");
+}
 export function isJsonMode(cmd) {
     return !!cmd.parent?.opts().json;
 }

package/dist/commands/vault.js

@@ -0,0 +1,113 @@
+import { existsSync, readFileSync } from "fs";
+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 { 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).");
+    vault
+        .command("publish")
+        .description(`Upload ${PUBLISH_FILENAME} to the vault root on webdrive. Triggers post-processing (vault sync, metadata update, Discord notification).`)
+        .action(async () => {
+        const vaultId = getVaultSlug();
+        const filePath = join(process.cwd(), PUBLISH_FILENAME);
+        if (!existsSync(filePath)) {
+            throw new Error(`${PUBLISH_FILENAME} not found in ${process.cwd()}`);
+        }
+        const content = readFileSync(filePath, "utf-8");
+        const token = await getValidToken();
+        const url = `${WEBDRIVE_BASE_URL}/api/v1/vaults/${vaultId}/file/${PUBLISH_FILENAME}`;
+        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(vault)) {
+            jsonOut({ vaultId });
+            return;
+        }
+        console.log(`Published ${PUBLISH_FILENAME} to vault "${vaultId}"`);
+    });
+    vault
+        .command("unpublish")
+        .description(`Delete ${PUBLISH_FILENAME} from the vault on webdrive.`)
+        .action(async () => {
+        const vaultId = getVaultSlug();
+        const token = await getValidToken();
+        const url = `${WEBDRIVE_BASE_URL}/api/v1/vaults/${vaultId}/file/${PUBLISH_FILENAME}`;
+        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(vault)) {
+            jsonOut({ vaultId });
+            return;
+        }
+        console.log(`Deleted ${PUBLISH_FILENAME} from vault "${vaultId}"`);
+    });
+    vault
+        .command("sync")
+        .description("Sync local vault files with Gobi Webdrive.")
+        .option("--upload-only", "Only upload local changes to server")
+        .option("--download-only", "Only download server changes to local")
+        .option("--conflict <strategy>", "Conflict resolution strategy: ask|server|client|skip", "ask")
+        .option("--dir <path>", "Local vault directory (default: current directory)")
+        .option("--dry-run", "Preview changes without making them")
+        .option("--full", "Full sync: ignore cursor and hash cache, re-check every file")
+        .option("--path <path>", "Restrict sync to a specific file or folder (repeatable)", (v, prev) => prev.concat(v), [])
+        .option("--plan-file <path>", "Write dry-run plan to file (use with --dry-run) or read plan to execute (use with --execute)")
+        .option("--execute", "Execute a previously written plan file (requires --plan-file)")
+        .option("--conflict-choices <json>", "Per-file conflict resolutions as JSON object, e.g. '{\"file.md\":\"server\"}' (use with --execute)")
+        .action(async function (opts) {
+        if (opts.uploadOnly && opts.downloadOnly) {
+            throw new GobiError("--upload-only and --download-only are mutually exclusive.", "INVALID_OPTION");
+        }
+        if (opts.execute && !opts.planFile) {
+            throw new GobiError("--execute requires --plan-file", "INVALID_OPTION");
+        }
+        const validStrategies = ["ask", "server", "client", "skip"];
+        if (!validStrategies.includes(opts.conflict)) {
+            throw new GobiError(`Invalid --conflict value "${opts.conflict}". Use: ask|server|client|skip`, "INVALID_OPTION");
+        }
+        let conflictChoices;
+        if (opts.conflictChoices) {
+            try {
+                conflictChoices = JSON.parse(opts.conflictChoices);
+            }
+            catch {
+                throw new GobiError("--conflict-choices must be valid JSON", "INVALID_OPTION");
+            }
+        }
+        const vaultSlug = getVaultSlug();
+        const dir = opts.dir ? pathResolve(opts.dir) : process.cwd();
+        await runSync({
+            vaultSlug,
+            dir,
+            uploadOnly: !!opts.uploadOnly,
+            downloadOnly: !!opts.downloadOnly,
+            conflict: opts.conflict,
+            dryRun: !!opts.dryRun,
+            full: !!opts.full,
+            paths: opts.path ?? [],
+            planFile: opts.planFile,
+            execute: !!opts.execute,
+            conflictChoices,
+            jsonMode: isJsonMode(this),
+        });
+    });
+}