@gobi-ai/cli 2.0.23 → 2.0.25

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,36 +379,32 @@ 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 &&
             opts.richText == null &&
-            !wantsVaultChange) {
-            throw new Error("Provide at least --title, --content, --rich-text, or --vault-slug to update.");
+            !wantsVaultChange &&
+            !wantsAttachChange) {
+            throw new Error("Provide at least --title, --content, --rich-text, --vault-slug, or --attach 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) {
+        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;
@@ -456,6 +418,10 @@ export function registerSpaceCommand(program) {
         }
         if (authorVaultSlug !== undefined)
             body.authorVaultSlug = authorVaultSlug;
+        if (opts.attach && opts.attach.length > 0) {
+            assertPostAttachmentMix(opts.attach);
+            body.attachments = await uploadPostAttachments(opts.attach);
+        }
         const resp = (await apiPatch(`/spaces/${spaceSlug}/posts/${postId}`, body));
         const post = unwrapResp(resp);
         if (isJsonMode(space)) {
@@ -486,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) => {
@@ -498,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;
@@ -542,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.");
         }
@@ -555,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.23",
+  "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)

package/skills/gobi-artifact/references/artifact.md

@@ -0,0 +1,142 @@
+# gobi artifact
+
+```
+Usage: gobi artifact [options] [command]
+
+Versioned creations attached to posts. Kinds: image | video | gif | markdown | meeting_summary. Always human-owned; revisions form a draft/published tree (at most one published per artifact).
+
+Options:
+  -h, --help                       display help for command
+
+Commands:
+  create [options]                 Create an artifact. markdown/meeting_summary kinds take a body via --file, --content, or stdin ("-"). image/gif/video kinds upload --file. Pass --post-id to attach
+                                   the new artifact to a post.
+  revise [options] <artifactId>    Add a draft revision to an artifact. New body via --file, --content, or stdin (markdown), or --file (media). Use --from to branch off a specific revision.
+  publish [options] <artifactId>   Publish a revision (becomes the artifact's single published revision).
+  revert [options] <artifactId>    Revert the artifact's published pointer to an earlier revision.
+  history <artifactId>             List the artifact's full revision tree (owner only).
+  download [options] <artifactId>  Download an artifact's content. markdown → write the body; media → fetch the bytes. Defaults to the published/latest revision; pass --revision to pick one. Writes
+                                   to --out or stdout (markdown).
+  delete <artifactId>              Delete an artifact (and its revision tree).
+  get <artifactId>                 Get one artifact with its current revision.
+  list [options]                   List your artifacts (newest first).
+  help [command]                   display help for command
+```
+
+## create
+
+```
+Usage: gobi artifact create [options]
+
+Create an artifact. markdown/meeting_summary kinds take a body via --file, --content, or stdin ("-"). image/gif/video kinds upload --file. Pass --post-id to attach the new artifact to a post.
+
+Options:
+  --kind <kind>         Artifact kind: image | video | gif | markdown | meeting_summary
+  --file <path>         Local file: markdown body (markdown kinds) or media file (media kinds)
+  --content <md>        Markdown body inline (markdown kinds; pass "-" for stdin)
+  --title <t>           Display title
+  --vault-slug <slug>   Anchor vault for [[wikilink]] resolution (markdown kinds). Stored in metadata.vaultSlug.
+  --post-id <id>        Attach the created artifact to this post afterward
+  --auto-attachments    Upload wiki-linked [[files]] to webdrive before creating (markdown kinds; uses --vault-slug)
+  --change-note <note>  Note describing this revision
+  -h, --help            display help for command
+```
+
+## revise
+
+```
+Usage: gobi artifact revise [options] <artifactId>
+
+Add a draft revision to an artifact. New body via --file, --content, or stdin (markdown), or --file (media). Use --from to branch off a specific revision.
+
+Options:
+  --file <path>         Local file: markdown body (markdown kinds) or media file (media kinds)
+  --content <md>        Markdown body inline (markdown kinds; pass "-" for stdin)
+  --change-note <note>  Note describing this revision
+  --from <revisionId>   Branch the new draft off this revision (defaults to the latest)
+  --auto-attachments    Upload wiki-linked [[files]] to webdrive before revising (markdown kinds; uses the artifact's stored metadata.vaultSlug)
+  -h, --help            display help for command
+```
+
+## publish
+
+```
+Usage: gobi artifact publish [options] <artifactId>
+
+Publish a revision (becomes the artifact's single published revision).
+
+Options:
+  --revision <revisionId>  Revision to publish
+  -h, --help               display help for command
+```
+
+## revert
+
+```
+Usage: gobi artifact revert [options] <artifactId>
+
+Revert the artifact's published pointer to an earlier revision.
+
+Options:
+  --to <revisionId>  Revision to revert to
+  -h, --help         display help for command
+```
+
+## history
+
+```
+Usage: gobi artifact history [options] <artifactId>
+
+List the artifact's full revision tree (owner only).
+
+Options:
+  -h, --help  display help for command
+```
+
+## download
+
+```
+Usage: gobi artifact download [options] <artifactId>
+
+Download an artifact's content. markdown → write the body; media → fetch the bytes. Defaults to the published/latest revision; pass --revision to pick one. Writes to --out or stdout (markdown).
+
+Options:
+  --revision <revisionId>  Specific revision (defaults to the artifact's current revision)
+  --out <path>             Write to this file (markdown defaults to stdout)
+  -h, --help               display help for command
+```
+
+## delete
+
+```
+Usage: gobi artifact delete [options] <artifactId>
+
+Delete an artifact (and its revision tree).
+
+Options:
+  -h, --help  display help for command
+```
+
+## get
+
+```
+Usage: gobi artifact get [options] <artifactId>
+
+Get one artifact with its current revision.
+
+Options:
+  -h, --help  display help for command
+```
+
+## list
+
+```
+Usage: gobi artifact list [options]
+
+List your artifacts (newest first).
+
+Options:
+  --kind <kind>  Filter by kind: image | video | gif | markdown | meeting_summary
+  --limit <n>    Max items to return
+  -h, --help     display help for command
+```

package/skills/gobi-core/SKILL.md

@@ -8,12 +8,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.23"
+  version: "2.0.25"
 ---
 
 # gobi-core
 
-Core CLI commands for the Gobi collaborative knowledge platform (v2.0.23).
+Core CLI commands for the Gobi collaborative knowledge platform (v2.0.25).
 
 ## Prerequisites
 
@@ -41,7 +41,7 @@ brew tap gobi-ai/tap && brew install gobi
 - **Personal Post**: A post on the author's profile that surfaces in the public global feed. Same `Post` data model as a Space Post — only the scope differs.
 - **Space Post**: A post inside a community space.
 - **Space**: A shared community knowledge area. A user can be a member of one or more spaces; each space contains posts, replies, and connected vaults.
-- **Draft**: A unit of standing guidance authored by an agent during chat. Each draft carries 0–3 AI-suggested actions the user picks from. The top 5 pending drafts feed the agent's system prompt every turn.
+- **Artifact**: A versioned, human-owned creation (image, video, gif, markdown, or meeting_summary) attached to posts. Its revisions form a draft/published tree (at most one published). See the **gobi-artifact** skill.
 
 ## Setup steps (run only what you need)
 
@@ -50,7 +50,7 @@ There is **no `gobi init`** command — each setup step is its own command, and
 | Step | Command | Unlocks |
 |------|---------|---------|
 | 1. Log in | `gobi auth login` | All authenticated commands |
-| 2. Configure a vault for this directory | `gobi vault init` | Every `gobi vault …` command; also lets `global create-post --auto-attachments` resolve that vault automatically |
+| 2. Configure a vault for this directory | `gobi vault init` | Every `gobi vault …` command; also lets `artifact create --auto-attachments` resolve that vault automatically |
 | 3. Pick an active space for this directory | `gobi space warp` | Every `gobi space …` post/reply/feed command without needing `--space-slug` |
 
 After step 2 + step 3, `.gobi/settings.yaml` looks like:
@@ -72,7 +72,7 @@ gobi auth status
 
 | Command family | Needs vault in `.gobi`? | Needs space in `.gobi`? | Per-call override |
 |----------------|------------------------|------------------------|-------------------|
-| `auth …`, `update`, `draft …`, `media …`, `sense …` | no | no | – |
+| `auth …`, `update`, `artifact …`, `media …`, `sense …` | no | no | – |
 | `vault publish` / `unpublish` / `sync` | **yes** | no | none — must run `gobi vault init` first |
 | `vault init` | no (it sets it up) | no | – |
 | `space list` / `warp [slug]` / `get [slug]` | no | no | – |
@@ -84,7 +84,7 @@ gobi auth status
 | `personal create-post` | optional¹ | no | command-level `--vault-slug <slug>` |
 | `personal edit-post` | optional² | no | command-level `--vault-slug <slug>` |
 
-¹ `global create-post` accepts `--vault-slug` and `--auto-attachments`, both optional. With neither flag and no `vaultSlug` in `.gobi`, the post is created with no `authorVaultSlug` (vault-less personal post) — same as a Space post that isn't attributed to any vault. Set `--vault-slug` (or have `vaultSlug` in `.gobi` plus pass `--auto-attachments`) to attribute it.
+¹ `global create-post` accepts `--vault-slug`, optional. With no flag and no `vaultSlug` in `.gobi`, the post is created with no `authorVaultSlug` (vault-less personal post) — same as a Space post that isn't attributed to any vault. Set `--vault-slug` to attribute it.
 
 ² `global edit-post` only consults `--vault-slug` when you pass it explicitly. Use `--vault-slug ""` to detach an existing attribution; non-empty re-attaches.
 
@@ -139,4 +139,3 @@ Read-only commands (`auth status`, `space list`) run without confirmation.
 | `GOBI_BASE_URL` | `https://api.joingobi.com` | API server URL |
 | `GOBI_WEBDRIVE_BASE_URL` | `https://webdrive.joingobi.com` | File storage URL |
 | `GOBI_WEB_BASE_URL` | `https://gobispace.com` | Public web URL (used when assembling shareable links) |
-| `GOBI_SESSION_ID` | — | Default `--session` for `gobi draft add` (set automatically inside agent runs) |

package/skills/gobi-homepage/SKILL.md

@@ -7,7 +7,7 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.23"
+  version: "2.0.25"
 ---
 
 # Gobi Homepage Developer Guide

package/skills/gobi-media/SKILL.md

@@ -10,12 +10,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.23"
+  version: "2.0.25"
 ---
 
 # gobi-media
 
-Gobi media generation commands (v2.0.23).
+Gobi media generation commands (v2.0.25).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 

package/skills/gobi-sense/SKILL.md

@@ -7,12 +7,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.23"
+  version: "2.0.25"
 ---
 
 # gobi-sense
 
-Gobi sense commands for activity and transcription data (v2.0.23).
+Gobi sense commands for activity and transcription data (v2.0.25).
 
 Requires gobi-cli installed and authenticated. See the **gobi-core** skill for setup.