@gobi-ai/cli 2.0.24 → 2.0.25

package/dist/commands/personal.js

@@ -1,7 +1,6 @@
 import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
-import { fetchDraftSummary, isJsonMode, jsonOut, readStdin, resolveVaultSlug, unwrapResp, } from "./utils.js";
-import { extractWikiLinks, uploadAttachments, uploadPostAttachments, assertPostAttachmentMix, } from "../attachments.js";
-import { getValidToken } from "../auth/manager.js";
+import { isJsonMode, jsonOut, readStdin, resolveVaultSlug, unwrapResp, } from "./utils.js";
+import { uploadPostAttachments, assertPostAttachmentMix, } from "../attachments.js";
 function readContent(value) {
     if (value === "-")
         return readStdin();
@@ -191,43 +190,24 @@ export function registerPersonalCommand(program) {
         .option("--content <content>", "Post content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
         .option("--vault-slug <vaultSlug>", "Attribute the post to this vault (sets authorVaultSlug). Caller must own the vault.")
-        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before posting (also sets authorVaultSlug to that vault)")
-        .option("--draft-id <draftId>", "Use this draft as the source of title and content (mutually exclusive with --title/--content/--rich-text). On success, links the post back via draft.metadata. The draft's vaultSlug seeds --vault-slug when not given explicitly.")
         .option("--attach <file>", "Local media file to attach. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video.", (value, prev = []) => [...prev, value], [])
         .option("--repost-post-id <postId>", "Wrap an existing top-level post as the embedded card on this new private post. The referenced post must be visible to you (your own personal-space post, a global-feed post, or a post in a space you're a member of). Reposting someone else's personal-space post returns 404.")
         .action(async (opts) => {
-        if (opts.draftId) {
-            if (opts.title || opts.content || opts.richText) {
-                throw new Error("--draft-id sources title and content from the draft; --title, --content, and --rich-text are not allowed alongside it.");
-            }
+        if (!opts.content && !opts.richText) {
+            throw new Error("Provide either --content or --rich-text.");
         }
-        else {
-            if (!opts.content && !opts.richText) {
-                throw new Error("Provide either --content or --rich-text (or --draft-id).");
-            }
-            if (opts.content && opts.richText) {
-                throw new Error("--content and --rich-text are mutually exclusive.");
-            }
+        if (opts.content && opts.richText) {
+            throw new Error("--content and --rich-text are mutually exclusive.");
         }
-        const draft = opts.draftId ? await fetchDraftSummary(opts.draftId) : null;
-        const effectiveTitle = draft ? draft.title : opts.title;
-        const effectiveContent = draft ? draft.content : opts.content;
-        const effectiveVaultSlugOpt = opts.vaultSlug ?? draft?.vaultSlug ?? undefined;
         let authorVaultSlug;
-        if (effectiveVaultSlugOpt || opts.autoAttachments) {
-            authorVaultSlug = resolveVaultSlug({ vaultSlug: effectiveVaultSlugOpt });
+        if (opts.vaultSlug) {
+            authorVaultSlug = resolveVaultSlug({ vaultSlug: opts.vaultSlug });
         }
         const body = {};
-        if (effectiveTitle != null)
-            body.title = effectiveTitle;
-        if (effectiveContent != null) {
-            const content = draft ? effectiveContent : readContent(effectiveContent);
-            if (opts.autoAttachments && authorVaultSlug) {
-                const token = await getValidToken();
-                const links = extractWikiLinks(content);
-                await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
-            }
-            body.content = content;
+        if (opts.title != null)
+            body.title = opts.title;
+        if (opts.content != null) {
+            body.content = readContent(opts.content);
         }
         if (opts.richText != null) {
             let parsed;
@@ -254,17 +234,6 @@ export function registerPersonalCommand(program) {
         }
         const resp = (await apiPost(`/posts/personal-space`, body));
         const post = unwrapResp(resp);
-        if (opts.draftId && post.id != null) {
-            try {
-                await apiPatch(`/app/drafts/${opts.draftId}/metadata`, {
-                    postId: typeof post.id === "number" ? post.id : Number(post.id),
-                    spaceSlug: null,
-                });
-            }
-            catch (e) {
-                console.error(`Warning: failed to link post to draft ${opts.draftId}: ${e.message}`);
-            }
-        }
         if (isJsonMode(personal)) {
             jsonOut(post);
             return;
@@ -273,8 +242,7 @@ export function registerPersonalCommand(program) {
             `  ID: ${post.id}\n` +
             (post.title ? `  Title: ${post.title}\n` : "") +
             `  Created: ${post.createdAt}\n` +
-            `  Visibility: private (only you can see this)` +
-            (opts.draftId ? `\n  Linked to draft: ${opts.draftId}` : ""));
+            `  Visibility: private (only you can see this)`);
     });
     // ── Edit post ──
     //
@@ -288,10 +256,9 @@ export function registerPersonalCommand(program) {
         .option("--content <content>", "New content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
         .option("--vault-slug <vaultSlug>", "Attribute the post to this vault (sets authorVaultSlug).")
-        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before editing (uses --vault-slug or .gobi vault)")
         .option("--attach <file>", "Replace the post's media attachments with the given files (existing attachments are removed). Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. Omit to leave attachments unchanged.", (value, prev = []) => [...prev, value], [])
         .action(async (postId, opts) => {
-        const wantsVaultChange = !!(opts.vaultSlug || opts.autoAttachments);
+        const wantsVaultChange = !!opts.vaultSlug;
         const wantsAttachChange = !!(opts.attach && opts.attach.length > 0);
         if (opts.title == null &&
             opts.content == null &&
@@ -304,20 +271,14 @@ export function registerPersonalCommand(program) {
             throw new Error("--content and --rich-text are mutually exclusive.");
         }
         let authorVaultSlug;
-        if (opts.vaultSlug || opts.autoAttachments) {
+        if (opts.vaultSlug) {
             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 && authorVaultSlug) {
-                const token = await getValidToken();
-                const links = extractWikiLinks(content);
-                await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
-            }
-            body.content = content;
+            body.content = readContent(opts.content);
         }
         if (opts.richText != null) {
             let parsed;
@@ -366,8 +327,7 @@ export function registerPersonalCommand(program) {
         .description("Reply to a personal-space post. The reply inherits the parent's private scope automatically.")
         .option("--content <content>", "Reply content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
-        .option("--vault-slug <vaultSlug>", "Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.")
-        .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).")
         .option("--attach <file>", "Local media file to attach to this reply. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video.", (value, prev = []) => [...prev, value], [])
         .action(async (postId, opts) => {
         if (!opts.content && !opts.richText) {
@@ -377,18 +337,12 @@ export function registerPersonalCommand(program) {
             throw new Error("--content and --rich-text are mutually exclusive.");
         }
         let authorVaultSlug;
-        if (opts.vaultSlug || opts.autoAttachments) {
+        if (opts.vaultSlug) {
             authorVaultSlug = resolveVaultSlug(opts);
         }
         const body = {};
         if (opts.content != null) {
-            const content = readContent(opts.content);
-            if (opts.autoAttachments && authorVaultSlug) {
-                const token = await getValidToken();
-                const links = extractWikiLinks(content);
-                await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
-            }
-            body.content = content;
+            body.content = readContent(opts.content);
         }
         if (opts.richText != null) {
             let parsed;
@@ -419,10 +373,9 @@ export function registerPersonalCommand(program) {
         .description("Edit a reply you authored in your personal space.")
         .option("--content <content>", "New reply content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
-        .option("--vault-slug <vaultSlug>", "Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.")
-        .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).")
         .action(async (replyId, opts) => {
-        const wantsVaultChange = !!(opts.vaultSlug || opts.autoAttachments);
+        const wantsVaultChange = !!opts.vaultSlug;
         if (opts.content == null && opts.richText == null && !wantsVaultChange) {
             throw new Error("Provide at least --content, --rich-text, or --vault-slug to update.");
         }
@@ -430,18 +383,12 @@ export function registerPersonalCommand(program) {
             throw new Error("--content and --rich-text are mutually exclusive.");
         }
         let authorVaultSlug;
-        if (opts.vaultSlug || opts.autoAttachments) {
+        if (opts.vaultSlug) {
             authorVaultSlug = resolveVaultSlug(opts);
         }
         const body = {};
         if (opts.content != null) {
-            const content = readContent(opts.content);
-            if (opts.autoAttachments && authorVaultSlug) {
-                const token = await getValidToken();
-                const links = extractWikiLinks(content);
-                await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
-            }
-            body.content = content;
+            body.content = readContent(opts.content);
         }
         if (opts.richText != null) {
             let parsed;

package/dist/commands/space.js

@@ -1,9 +1,8 @@
 import { WEB_BASE_URL } from "../constants.js";
 import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
 import { requireSpace, selectSpace, setSpaceRequirement, writeSpaceSetting, } from "./init.js";
-import { fetchDraftSummary, isJsonMode, jsonOut, readStdin, resolveSpaceSlug, resolveVaultSlug, unwrapResp, } from "./utils.js";
-import { extractWikiLinks, uploadAttachments, uploadPostAttachments, assertPostAttachmentMix, } from "../attachments.js";
-import { getValidToken } from "../auth/manager.js";
+import { isJsonMode, jsonOut, readStdin, resolveSpaceSlug, resolveVaultSlug, unwrapResp, } from "./utils.js";
+import { uploadPostAttachments, assertPostAttachmentMix, } from "../attachments.js";
 function readContent(value) {
     if (value === "-")
         return readStdin();
@@ -316,45 +315,26 @@ export function registerSpaceCommand(program) {
         .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 authorVaultSlug). Also used as upload destination for --auto-attachments.")
+        .option("--vault-slug <vaultSlug>", "Attribute the post to this vault (sets authorVaultSlug). Caller must own the vault.")
         .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
-        .option("--draft-id <draftId>", "Use this draft as the source of title and content (mutually exclusive with --title/--content/--rich-text). On success, links the post back by recording postId/spaceSlug on draft.metadata so the client can render an 'Open post' button. The draft's vaultSlug seeds --vault-slug when not given explicitly.")
         .option("--attach <file>", "Local media file to attach. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video.", (value, prev = []) => [...prev, value], [])
         .option("--repost-post-id <postId>", "Wrap an existing top-level post as the embedded card on this new post. Composes with --content / --rich-text / --attach (the wrapping author's text + media render above the embedded card). Reposts-of-reposts are collapsed to the transitive root server-side. The referenced post must exist, not be deleted, and not itself be a reply.")
         .action(async (opts) => {
-        if (opts.draftId) {
-            if (opts.title || opts.content || opts.richText) {
-                throw new Error("--draft-id sources title and content from the draft; --title, --content, and --rich-text are not allowed alongside it.");
-            }
+        if (!opts.content && !opts.richText) {
+            throw new Error("Provide either --content or --rich-text.");
         }
-        else {
-            if (!opts.content && !opts.richText) {
-                throw new Error("Provide either --content or --rich-text (or --draft-id).");
-            }
-            if (opts.content && opts.richText) {
-                throw new Error("--content and --rich-text are mutually exclusive.");
-            }
+        if (opts.content && opts.richText) {
+            throw new Error("--content and --rich-text are mutually exclusive.");
         }
-        const draft = opts.draftId ? await fetchDraftSummary(opts.draftId) : null;
-        const effectiveTitle = draft ? draft.title : opts.title;
-        const effectiveContent = draft ? draft.content : opts.content;
-        const effectiveVaultSlugOpt = opts.vaultSlug ?? draft?.vaultSlug ?? undefined;
         let authorVaultSlug;
-        if (effectiveVaultSlugOpt || opts.autoAttachments) {
-            authorVaultSlug = resolveVaultSlug({ vaultSlug: effectiveVaultSlugOpt });
+        if (opts.vaultSlug) {
+            authorVaultSlug = resolveVaultSlug({ vaultSlug: opts.vaultSlug });
         }
         const body = {};
-        if (effectiveTitle != null)
-            body.title = effectiveTitle;
-        if (effectiveContent != null) {
-            const content = draft ? effectiveContent : readContent(effectiveContent);
-            if (opts.autoAttachments) {
-                const token = await getValidToken();
-                const links = extractWikiLinks(content);
-                await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
-            }
-            body.content = content;
+        if (opts.title != null)
+            body.title = opts.title;
+        if (opts.content != null) {
+            body.content = readContent(opts.content);
         }
         if (opts.richText != null) {
             let parsed;
@@ -382,19 +362,6 @@ export function registerSpaceCommand(program) {
         const spaceSlug = resolveSpaceSlug(space, opts);
         const resp = (await apiPost(`/spaces/${spaceSlug}/posts`, body));
         const post = unwrapResp(resp);
-        if (opts.draftId && post.id != null) {
-            try {
-                await apiPatch(`/app/drafts/${opts.draftId}/metadata`, {
-                    postId: typeof post.id === "number" ? post.id : Number(post.id),
-                    spaceSlug,
-                });
-            }
-            catch (e) {
-                // Don't fail the create if linking fails — the post is live; just
-                // surface a warning so the agent can mention it.
-                console.error(`Warning: failed to link post to draft ${opts.draftId}: ${e.message}`);
-            }
-        }
         const shareUrl = `${WEB_BASE_URL}/spaces/${spaceSlug}/posts/${post.id}`;
         if (isJsonMode(space)) {
             jsonOut({ ...post, shareUrl });
@@ -404,8 +371,7 @@ export function registerSpaceCommand(program) {
             `  ID: ${post.id}\n` +
             (post.title ? `  Title: ${post.title}\n` : "") +
             `  Created: ${post.createdAt}\n` +
-            `  URL: ${shareUrl}` +
-            (opts.draftId ? `\n  Linked to draft: ${opts.draftId}` : ""));
+            `  URL: ${shareUrl}`);
     });
     space
         .command("edit-post <postId>")
@@ -413,12 +379,11 @@ export function registerSpaceCommand(program) {
         .option("--title <title>", "New title for the post")
         .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 authorVaultSlug). Also used as upload destination for --auto-attachments.")
+        .option("--vault-slug <vaultSlug>", "Attribute the post to this vault (sets authorVaultSlug). Caller must own the vault.")
         .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .option("--attach <file>", "Replace the post's media attachments with the given files (existing attachments are removed). Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. Omit to leave attachments unchanged.", (value, prev = []) => [...prev, value], [])
         .action(async (postId, opts) => {
-        const wantsVaultChange = !!(opts.vaultSlug || opts.autoAttachments);
+        const wantsVaultChange = !!opts.vaultSlug;
         const wantsAttachChange = !!(opts.attach && opts.attach.length > 0);
         if (opts.title == null &&
             opts.content == null &&
@@ -432,20 +397,14 @@ export function registerSpaceCommand(program) {
         }
         const spaceSlug = resolveSpaceSlug(space, opts);
         let authorVaultSlug;
-        if (opts.vaultSlug || opts.autoAttachments) {
+        if (opts.vaultSlug) {
             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 token = await getValidToken();
-                const links = extractWikiLinks(content);
-                await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
-            }
-            body.content = content;
+            body.content = readContent(opts.content);
         }
         if (opts.richText != null) {
             let parsed;
@@ -493,8 +452,7 @@ export function registerSpaceCommand(program) {
         .description("Create a reply to a post in a space.")
         .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("--vault-slug <vaultSlug>", "Attribute the reply to this vault (sets authorVaultSlug). Caller must own the vault.")
         .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .option("--attach <file>", "Local media file to attach to this reply. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video.", (value, prev = []) => [...prev, value], [])
         .action(async (postId, opts) => {
@@ -505,18 +463,12 @@ export function registerSpaceCommand(program) {
             throw new Error("--content and --rich-text are mutually exclusive.");
         }
         let authorVaultSlug;
-        if (opts.vaultSlug || opts.autoAttachments) {
+        if (opts.vaultSlug) {
             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;
+            body.content = readContent(opts.content);
         }
         if (opts.richText != null) {
             let parsed;
@@ -549,11 +501,10 @@ export function registerSpaceCommand(program) {
         .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("--vault-slug <vaultSlug>", "Attribute the reply to this vault (sets authorVaultSlug). Caller must own the vault.")
         .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .action(async (replyId, opts) => {
-        const wantsVaultChange = !!(opts.vaultSlug || opts.autoAttachments);
+        const wantsVaultChange = !!opts.vaultSlug;
         if (opts.content == null && opts.richText == null && !wantsVaultChange) {
             throw new Error("Provide at least --content, --rich-text, or --vault-slug to update.");
         }
@@ -562,18 +513,12 @@ export function registerSpaceCommand(program) {
         }
         const spaceSlug = resolveSpaceSlug(space, opts);
         let authorVaultSlug;
-        if (opts.vaultSlug || opts.autoAttachments) {
+        if (opts.vaultSlug) {
             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;
+            body.content = readContent(opts.content);
         }
         if (opts.richText != null) {
             let parsed;

package/dist/commands/utils.js

@@ -1,20 +1,5 @@
 import { readFileSync } from "fs";
-import { apiGet } from "../client.js";
 import { getSpaceSlug, getVaultSlug } from "./init.js";
-// Fetch a draft and return just the fields a post-creation flow needs. Used
-// by `space create-post` and `global create-post` when --draft-id is passed:
-// title/content come from the draft, vaultSlug seeds the post's authorship
-// when the caller did not pass --vault-slug.
-export async function fetchDraftSummary(draftId) {
-    const resp = (await apiGet(`/app/drafts/${draftId}`));
-    const data = unwrapResp(resp);
-    return {
-        draftId: String(data.draftId ?? draftId),
-        title: String(data.title ?? ""),
-        content: String(data.content ?? ""),
-        vaultSlug: data.vaultSlug ?? null,
-    };
-}
 // Reads all of stdin synchronously. Uses fd 0 (cross-platform) instead of
 // "/dev/stdin", which doesn't exist on Windows.
 export function readStdin() {

package/dist/commands/vault.js

@@ -103,7 +103,7 @@ export function registerVaultCommand(program) {
     });
     const statusCmd = vault
         .command("status")
-        .description("Show the configured vault's publish state and metadata (use before posting with --auto-attachments to confirm the vault is public).")
+        .description("Show the configured vault's publish state and metadata (use before authoring a markdown artifact with --auto-attachments to confirm the vault is public).")
         .option("--vault-slug <vaultSlug>", "Vault slug to inspect (defaults to .gobi/settings.yaml)")
         .action(async (opts) => {
         const slug = opts.vaultSlug ?? getVaultSlug();

package/dist/main.js

@@ -11,7 +11,7 @@ import { registerVaultCommand } from "./commands/vault.js";
 import { registerSenseCommand } from "./commands/sense.js";
 import { registerUpdateCommand } from "./commands/update.js";
 import { registerMediaCommand } from "./commands/media.js";
-import { registerDraftCommand } from "./commands/draft.js";
+import { registerArtifactCommand } from "./commands/artifact.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../package.json");
 function hasParentOption(cmd, key) {
@@ -64,7 +64,7 @@ export async function cli() {
     registerSenseCommand(program);
     registerUpdateCommand(program);
     registerMediaCommand(program);
-    registerDraftCommand(program);
+    registerArtifactCommand(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": "2.0.24",
+  "version": "2.0.25",
   "description": "CLI client for the Gobi collaborative knowledge platform",
   "license": "MIT",
   "type": "module",

package/skills/gobi-artifact/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: gobi-artifact
+description: >-
+  Gobi artifact commands for versioned creations attached to posts: create,
+  revise, publish, revert, history, download, delete, get, list. An artifact
+  is a human-owned creation (image, video, gif, markdown, or meeting_summary)
+  whose revisions form a draft/published tree. Use when the user wants to
+  author, version, publish, or attach an artifact to a post.
+allowed-tools: Bash(gobi:*)
+metadata:
+  author: gobi-ai
+  version: "2.0.25"
+---
+
+# gobi-artifact
+
+Gobi artifact commands for versioned, post-attachable creations (v2.0.25).
+
+Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
+
+## What is an artifact?
+
+An artifact is a versioned creation that can be attached to one or more posts. Each artifact has:
+
+- **kind** — one of `image | video | gif | markdown | meeting_summary`. `markdown` and `meeting_summary` carry a markdown **body**; `image`, `gif`, and `video` carry an uploaded **media file**.
+- **title** — optional display title.
+- **owner** — always a human (the calling user). Even when an agent runs the CLI, the artifact is owned by the agent's owner.
+- **revisions** — a draft/published tree. New revisions start as `draft`; publishing one makes it the artifact's single `published` revision (at most one published per artifact). `revise --from <revisionId>` branches off an earlier revision instead of the latest, so the history can fork.
+- **metadata** — per-kind extras. For markdown kinds, `metadata.vaultSlug` is the anchor vault used to resolve `[[wikilinks]]` in the body.
+
+Markdown bodies can reference vault notes with `[[wikilinks]]`. Resolution against the anchor vault (`--vault-slug` on create) only works for viewers who can read that vault.
+
+## Important: JSON Mode
+
+For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
+
+```bash
+gobi --json artifact list --limit 20
+gobi --json artifact create --kind markdown --content "# Notes" --title "My note"
+gobi --json artifact get <artifactId>
+```
+
+JSON mode wraps the response as `{"success": true, "data": <artifact|revision|...>}` (or `{"success": false, "error": "..."}`).
+
+## Typical Workflow (markdown artifact)
+
+Create a markdown artifact, attaching it to a post in the same call:
+
+```bash
+gobi --json artifact create --kind markdown --file notes.md --title "Design notes" \
+  --vault-slug my-vault --post-id 12345
+```
+
+The body can come from `--file <path>`, `--content <md>` inline, or stdin (`--content -`). `--vault-slug` anchors `[[wikilink]]` resolution and is stored as `metadata.vaultSlug`.
+
+Add `--auto-attachments` (markdown kinds only) to upload any `[[wiki-linked files]]` in the body to the `--vault-slug` vault on webdrive before creating:
+
+```bash
+gobi --json artifact create --kind markdown --file notes.md --vault-slug my-vault --auto-attachments
+```
+
+Revise it (adds a new draft revision), then publish that revision:
+
+```bash
+gobi --json artifact revise <artifactId> --file notes-v2.md --change-note "Tighten intro"
+gobi --json artifact publish <artifactId> --revision <revisionId>
+```
+
+`revise --auto-attachments` reuses the artifact's stored `metadata.vaultSlug` (it GETs the artifact first), so you don't repeat `--vault-slug`.
+
+Inspect and roll back:
+
+```bash
+gobi --json artifact history <artifactId>          # full revision tree (owner only)
+gobi --json artifact revert <artifactId> --to <revisionId>
+```
+
+## Typical Workflow (media artifact)
+
+Image / gif / video kinds upload a local file (init → PUT → create) instead of a body:
+
+```bash
+gobi --json artifact create --kind image --file diagram.png --title "Architecture" --post-id 12345
+```
+
+Media-file size ceilings mirror post media: 5MB photos / 15MB GIFs / 512MB video, derived from the file's content type. Revise a media artifact by uploading a replacement file:
+
+```bash
+gobi --json artifact revise <artifactId> --file diagram-v2.png --change-note "Add cache layer"
+```
+
+## Download
+
+`download` defaults to the artifact's current (published, else latest) revision; pass `--revision` to pick one.
+
+- markdown → writes the body to `--out <path>`, or prints to stdout when `--out` is omitted.
+- media → fetches the `mediaUrl` bytes to `--out <path>` (defaults to `<artifactId>.<ext>`).
+
+```bash
+gobi artifact download <artifactId> --out notes.md
+gobi artifact download <artifactId> --revision <revisionId> --out image.png
+```
+
+## Attaching to a post
+
+`create --post-id <id>` attaches the new artifact to a post **without clobbering** the post's existing artifacts: the CLI reads the post's current artifact attachments, appends the new id, and writes the merged set via the post edit endpoint (`PATCH /posts/:id` with `artifactIds`). The post API's `artifactIds` is otherwise a full replacement.
+
+Attaching is done at artifact-create time via `--post-id`. The post commands (`create-post` / `edit-post`) do **not** expose an artifact-attach flag — to attach to an existing post, create the artifact with `--post-id <that post's id>`.
+
+## Available Commands
+
+- `gobi artifact create` — Create an artifact (markdown body or uploaded media). `--post-id` attaches it to a post; `--auto-attachments` (markdown) uploads `[[wikilinks]]`.
+- `gobi artifact revise` — Add a draft revision (new body or media file). `--from` branches off a specific revision.
+- `gobi artifact publish` — Publish a revision (becomes the single published revision).
+- `gobi artifact revert` — Move the published pointer to an earlier revision.
+- `gobi artifact history` — List the full revision tree (owner only).
+- `gobi artifact download` — Download a revision's content (markdown body or media bytes).
+- `gobi artifact delete` — Delete an artifact and its revision tree.
+- `gobi artifact get` — Get one artifact with its current revision.
+- `gobi artifact list` — List your artifacts (`--kind`, `--limit`).
+
+## Confirm before mutating
+
+Artifacts are user-owned creations. The authoring commands (`create`, `revise`) are the normal flow and run without extra confirmation. Two commands change what's live or destroy data — confirm first:
+
+- `publish <id> --revision <id>` / `revert <id> --to <id>` — change which revision is published (visible on attached posts). Confirm the target revision with the user.
+- `delete <id>` — irreversible (removes the artifact and its whole revision tree). Confirm the target id before running.
+
+Read-only commands (`get`, `list`, `history`) and `download` run without confirmation.
+
+## Reference Documentation
+
+- [gobi artifact](references/artifact.md)