@gobi-ai/cli 2.0.23 → 2.0.25

package/skills/gobi-space/SKILL.md

@@ -11,12 +11,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.23"
+  version: "2.0.25"
 ---
 
 # gobi-space
 
-Gobi space, global, and personal-space posts (v2.0.23).
+Gobi space, global, and personal-space posts (v2.0.25).
 
 Requires gobi-cli installed and authenticated. See the **gobi-core** skill for setup.
 
@@ -49,17 +49,15 @@ The same applies to replies: a reply has only `--content` (no title), so do not
 
 `create-post` / `edit-post` across all three scopes (`gobi space`, `gobi global`, `gobi personal`) accept `--vault-slug <slug>`. When set, the slug becomes the post's `authorVaultSlug` — the vault the user is posting on behalf of. The caller must hold `role: 'owner'` on that vault. Pass `--vault-slug ""` on edit to detach.
 
-`--auto-attachments` resolves a vault for upload and **also** uses it as `authorVaultSlug` automatically — one flag, two effects.
-
-> **Before using `--auto-attachments`, check that the target vault is published.** Run `gobi --json vault status` (or `gobi vault status --vault-slug <slug>`) and verify `isPublished: true`. Files uploaded to a non-public vault are stored on webdrive but are not reachable at `gobispace.com/@{vaultSlug}` — readers will see broken `[[wikilinks]]`. If the status reports unpublished, ask the user to run `gobi vault publish` first (the server rejects the publish if `title` and `description` are missing from `PUBLISH.md` frontmatter). See the **gobi-vault** skill.
+> **Wiki-link uploads moved to artifacts.** The `--auto-attachments` flag that used to upload `[[wiki-linked files]]` from a post body now lives on `gobi artifact create` / `gobi artifact revise` (markdown kinds). To publish a markdown creation with resolvable wikilinks, create a markdown artifact with `--vault-slug` + `--auto-attachments` and attach it to the post (`--post-id`). See the **gobi-artifact** skill. Before relying on wikilink resolution, confirm the anchor vault is published: `gobi --json vault status --vault-slug <slug>` should report `isPublished: true`.
 
 ## Post media attachments (`--attach`)
 
-Separate from `--auto-attachments`, `create-post` and `create-reply` across all three scopes (`gobi space`, `gobi global`, `gobi personal`) accept `--attach <file>` (repeatable) for inline post media — the photos/GIF/video that render in-feed alongside the post body. The CLI uploads each file to S3 via `POST /posts/upload-url` and passes the resulting `{ mediaUrl, mediaKey }` array as the post's `attachments`.
+`create-post` and `create-reply` across all three scopes (`gobi space`, `gobi global`, `gobi personal`) accept `--attach <file>` (repeatable) for inline post media — the photos/GIF/video that render in-feed alongside the post body. The CLI uploads each file to S3 via `POST /posts/upload-url` and passes the resulting `{ mediaUrl, mediaKey }` array as the post's `attachments`.
 
 X-style mix rule (enforced client-side before upload): up to **4 photos** OR **1 GIF** OR **1 video** — they don't combine. Server-side ceilings: 5MB photos, 15MB GIFs, 512MB video.
 
-Use `--attach` for media you want shown in the post itself; use `--auto-attachments` for `[[wikilinks]]` to vault files referenced in the body.
+Use `--attach` for media you want shown in the post itself; use a markdown **artifact** (`gobi artifact create`) for `[[wikilinks]]`-bearing creations attached to the post.
 
 ## Public link formats
 
@@ -86,7 +84,7 @@ When you echo a "Post created!" line (or the JSON response is consumed by anothe
 
 If `.gobi/settings.yaml` has no `selectedSpaceSlug` and `--space-slug` isn't passed, the command will error.
 
-`gobi global` commands target the public global feed and have no space requirement and no `.gobi` requirement. `gobi global create-post` is symmetric with `gobi space create-post`: a vault is **optional** — pass `--vault-slug <slug>` (or rely on `.gobi`'s `vaultSlug` when using `--auto-attachments`) to attribute the post; with neither flag the post is created without an `authorVaultSlug`.
+`gobi global` commands target the public global feed and have no space requirement and no `.gobi` requirement. `gobi global create-post` is symmetric with `gobi space create-post`: a vault is **optional** — pass `--vault-slug <slug>` to attribute the post; with no flag the post is created without an `authorVaultSlug`.
 
 ## Important: JSON Mode
 
@@ -114,7 +112,7 @@ gobi --json space list-posts
 ### Space posts
 - `gobi space list-posts` — List posts in a space (paginated).
 - `gobi space get-post <postId>` — Get a post with its ancestors and replies (paginated). Ancestors and replies are returned together; there is no separate `ancestors` or `list-replies` command.
-- `gobi space create-post` — Create a space post. `--vault-slug` attributes it to a vault you own; `--auto-attachments` uploads `[[wikilinks]]` to that vault and uses it as `authorVaultSlug`.
+- `gobi space create-post` — Create a space post. `--vault-slug` attributes it to a vault you own.
 - `gobi space edit-post <postId>` — Edit a space post. You must be the author. `--vault-slug ""` detaches the vault.
 - `gobi space delete-post <postId>` — Delete a space post. You must be the author.
 
@@ -130,11 +128,11 @@ gobi --json space list-posts
 - `gobi global feed` — List the public global feed (posts and replies, newest first).
 - `gobi global list-posts` — List personal posts. `--mine` for your own; `--vault-slug <slug>` to filter by author vault.
 - `gobi global get-post <postId>` — Get a personal post with its ancestors and replies.
-- `gobi global create-post` — Create a personal post. `--vault-slug` and `--auto-attachments` work the same as on `space create-post`. Both are optional: with neither, the post is created without an `authorVaultSlug` (vault-less personal post).
-- `gobi global edit-post <postId>` — Edit a personal post you authored. `--vault-slug ""` detaches the vault; `--auto-attachments` uploads wiki-links before saving.
+- `gobi global create-post` — Create a personal post. `--vault-slug` works the same as on `space create-post`. It is optional: with no flag, the post is created without an `authorVaultSlug` (vault-less personal post).
+- `gobi global edit-post <postId>` — Edit a personal post you authored. `--vault-slug ""` detaches the vault.
 - `gobi global delete-post <postId>` — Delete a personal post you authored.
 - `gobi global create-reply <postId>` — Reply to a personal post.
-- `gobi global edit-reply <replyId>` — Edit a reply you authored. Accepts `--auto-attachments` and `--vault-slug` for attachment uploads (mirrors `space edit-reply`).
+- `gobi global edit-reply <replyId>` — Edit a reply you authored. Accepts `--vault-slug` for author attribution (mirrors `space edit-reply`).
 - `gobi global delete-reply <replyId>` — Delete a reply you authored.
 
 ### Personal-space posts (private)
@@ -146,7 +144,7 @@ A couple of read-side flags don't mirror — `personal feed` has no `--following
 - `gobi personal feed` — Your personal-space feed (posts and replies, newest first).
 - `gobi personal list-posts` — List your personal-space posts.
 - `gobi personal get-post <postId>` — Get a personal-space post with its ancestors and replies.
-- `gobi personal create-post` — Create a private personal-space post. Same flags as `gobi global create-post` (`--vault-slug`, `--auto-attachments`, `--draft-id`, `--repost-post-id`, `--attach`).
+- `gobi personal create-post` — Create a private personal-space post. Same flags as `gobi global create-post` (`--vault-slug`, `--repost-post-id`, `--attach`).
 - `gobi personal edit-post <postId>` — Edit a personal-space post you authored.
 - `gobi personal delete-post <postId>` — Delete a personal-space post you authored.
 - `gobi personal create-reply <postId>` — Reply to a personal-space post (inherits the parent's private scope).
@@ -155,13 +153,9 @@ A couple of read-side flags don't mirror — `personal feed` has no `--following
 
 ## Confirm before mutating
 
-Most posts and replies are publicly visible — in a community space (`gobi space …`) or in the global feed (`gobi global …`). `gobi personal …` is the exception: those rows are private to the author. Either way, before running any write, confirm with the user — show the exact command and the resolved title, content (or a short preview), and `authorVaultSlug` if `--vault-slug` / `--auto-attachments` is set. This applies even when running autonomously.
+Most posts and replies are publicly visible — in a community space (`gobi space …`) or in the global feed (`gobi global …`). `gobi personal …` is the exception: those rows are private to the author. Either way, before running any write, confirm with the user — show the exact command and the resolved title, content (or a short preview), and `authorVaultSlug` if `--vault-slug` is set. This applies even when running autonomously.
 
 - `create-post` / `create-reply` — content goes live on submission.
-
-### Linking back to a draft
-
-When a `create-post` is the side-effect of an actioned draft (e.g. the user picked "Post to Global Feed" / "Post to <space>"), pass `--draft-id <draftId>` to `gobi space create-post` or `gobi global create-post`. `--draft-id` is the **sole** source of `title` and `content` — it cannot coexist with `--title`, `--content`, or `--rich-text`. To change the wording, `gobi draft revise` first, then create the post. The draft's `vaultSlug` (when set) seeds the post's `--vault-slug` if not given explicitly. `--auto-attachments` and an explicit `--vault-slug` override are still allowed. On success the CLI records `{ postId, spaceSlug? }` on `draft.metadata`, which the client renders as an "Open post" button on the actioned draft.
 - `edit-post` / `edit-reply` — confirm the *new* content; people who already saw the original may re-see it.
 - `delete-post` / `delete-reply` — irreversible. Flag that explicitly and confirm the target id before running.
 

package/skills/gobi-space/references/global.md

@@ -12,8 +12,8 @@ Commands:
   feed [options]                   List the unified feed (posts and replies, newest first) in the global public feed.
   list-posts [options]             List posts in the global feed (paginated). Pass --mine to limit to your own posts.
   get-post [options] <postId>      Get a global post with its ancestors and replies (paginated).
-  create-post [options]            Create a post in the global feed. --vault-slug attributes it to a vault you own. With no --vault-slug and no --auto-attachments, the post is created without an
-                                   authorVaultSlug (vault-less personal post).
+  create-post [options]            Create a post in the global feed. --vault-slug attributes it to a vault you own. With no --vault-slug, the post is created without an authorVaultSlug (vault-less
+                                   personal post).
   edit-post [options] <postId>     Edit a post you authored in the global feed.
   delete-post <postId>             Delete a post you authored in the global feed.
   create-reply [options] <postId>  Create a reply to a post in the global feed.
@@ -70,17 +70,13 @@ Options:
 ```
 Usage: gobi global create-post [options]
 
-Create a post in the global feed. --vault-slug attributes it to a vault you own. With no --vault-slug and no --auto-attachments, the post is created without an authorVaultSlug (vault-less personal
-post).
+Create a post in the global feed. --vault-slug attributes it to a vault you own. With no --vault-slug, the post is created without an authorVaultSlug (vault-less personal post).
 
 Options:
   --title <title>            Title of the post
   --content <content>        Post content (markdown supported, use "-" for stdin)
   --rich-text <richText>     Rich-text JSON array (mutually exclusive with --content)
   --vault-slug <vaultSlug>   Attribute the post to this vault (sets authorVaultSlug). Caller must own the vault.
-  --auto-attachments         Upload wiki-linked [[files]] to webdrive before posting (also sets authorVaultSlug to that vault)
-  --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 on
-                             draft.metadata so the client can render an 'Open post' button. The draft's vaultSlug seeds --vault-slug when not given explicitly.
   --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. (default: [])
   --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.
@@ -99,7 +95,8 @@ Options:
   --content <content>       New content (markdown supported, use "-" for stdin)
   --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
   --vault-slug <vaultSlug>  Attribute the post to this vault (sets authorVaultSlug).
-  --auto-attachments        Upload wiki-linked [[files]] to webdrive before editing (uses --vault-slug or .gobi vault)
+  --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. (default: [])
   -h, --help                display help for command
 ```
 
@@ -124,8 +121,7 @@ Create a reply to a post in the global feed.
 Options:
   --content <content>       Reply content (markdown supported, use "-" for stdin)
   --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
-  --vault-slug <vaultSlug>  Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
-  --auto-attachments        Upload wiki-linked [[files]] to webdrive before posting (also attributes the reply to that vault)
+  --vault-slug <vaultSlug>  Attribute the reply to this vault (sets authorVaultSlug).
   --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. (default:
                             [])
   -h, --help                display help for command
@@ -141,8 +137,7 @@ Edit a reply you authored in the global feed.
 Options:
   --content <content>       New reply content (markdown supported, use "-" for stdin)
   --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
-  --vault-slug <vaultSlug>  Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
-  --auto-attachments        Upload wiki-linked [[files]] to webdrive before editing (also attributes the reply to that vault)
+  --vault-slug <vaultSlug>  Attribute the reply to this vault (sets authorVaultSlug).
   -h, --help                display help for command
 ```
 

package/skills/gobi-space/references/personal.md

@@ -74,9 +74,6 @@ Options:
   --content <content>        Post content (markdown supported, use "-" for stdin)
   --rich-text <richText>     Rich-text JSON array (mutually exclusive with --content)
   --vault-slug <vaultSlug>   Attribute the post to this vault (sets authorVaultSlug). Caller must own the vault.
-  --auto-attachments         Upload wiki-linked [[files]] to webdrive before posting (also sets authorVaultSlug to that vault)
-  --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.
   --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. (default: [])
   --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.
@@ -95,7 +92,8 @@ Options:
   --content <content>       New content (markdown supported, use "-" for stdin)
   --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
   --vault-slug <vaultSlug>  Attribute the post to this vault (sets authorVaultSlug).
-  --auto-attachments        Upload wiki-linked [[files]] to webdrive before editing (uses --vault-slug or .gobi vault)
+  --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. (default: [])
   -h, --help                display help for command
 ```
 
@@ -120,8 +118,7 @@ Reply to a personal-space post. The reply inherits the parent's private scope au
 Options:
   --content <content>       Reply content (markdown supported, use "-" for stdin)
   --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
-  --vault-slug <vaultSlug>  Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
-  --auto-attachments        Upload wiki-linked [[files]] to webdrive before posting (also attributes the reply to that vault)
+  --vault-slug <vaultSlug>  Attribute the reply to this vault (sets authorVaultSlug).
   --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. (default:
                             [])
   -h, --help                display help for command
@@ -137,8 +134,7 @@ Edit a reply you authored in your personal space.
 Options:
   --content <content>       New reply content (markdown supported, use "-" for stdin)
   --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
-  --vault-slug <vaultSlug>  Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
-  --auto-attachments        Upload wiki-linked [[files]] to webdrive before editing (also attributes the reply to that vault)
+  --vault-slug <vaultSlug>  Attribute the reply to this vault (sets authorVaultSlug).
   -h, --help                display help for command
 ```
 

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

@@ -118,11 +118,8 @@ Options:
   --title <title>            Title of the post
   --content <content>        Post content (markdown supported, use "-" for stdin)
   --rich-text <richText>     Rich-text JSON array (mutually exclusive with --content)
-  --auto-attachments         Upload wiki-linked [[files]] to webdrive before posting (also attributes the post to that vault)
-  --vault-slug <vaultSlug>   Attribute the post to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
+  --vault-slug <vaultSlug>   Attribute the post to this vault (sets authorVaultSlug). Caller must own the vault.
   --space-slug <spaceSlug>   Space slug (overrides .gobi/settings.yaml)
-  --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.
   --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. (default: [])
   --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.
@@ -140,9 +137,10 @@ Options:
   --title <title>           New title for the post
   --content <content>       New content for the post (markdown supported, use "-" for stdin)
   --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
-  --auto-attachments        Upload wiki-linked [[files]] to webdrive before editing (also attributes the post to that vault)
-  --vault-slug <vaultSlug>  Attribute the post to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
+  --vault-slug <vaultSlug>  Attribute the post to this vault (sets authorVaultSlug). Caller must own the vault.
   --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
+  --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. (default: [])
   -h, --help                display help for command
 ```
 
@@ -168,8 +166,7 @@ Create a reply to a post in a space.
 Options:
   --content <content>       Reply content (markdown supported, use "-" for stdin)
   --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
-  --auto-attachments        Upload wiki-linked [[files]] to webdrive before posting (also attributes the reply to that vault)
-  --vault-slug <vaultSlug>  Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
+  --vault-slug <vaultSlug>  Attribute the reply to this vault (sets authorVaultSlug). Caller must own the vault.
   --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
   --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. (default:
                             [])
@@ -186,8 +183,7 @@ Edit a reply you authored in a space.
 Options:
   --content <content>       New content for the reply (markdown supported, use "-" for stdin)
   --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
-  --auto-attachments        Upload wiki-linked [[files]] to webdrive before editing (also attributes the reply to that vault)
-  --vault-slug <vaultSlug>  Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
+  --vault-slug <vaultSlug>  Attribute the reply to this vault (sets authorVaultSlug). Caller must own the vault.
   --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
   -h, --help                display help for command
 ```

package/skills/gobi-vault/SKILL.md

@@ -8,12 +8,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.23"
+  version: "2.0.25"
 ---
 
 # gobi-vault
 
-Gobi vault commands for publishing your vault profile and syncing files (v2.0.23).
+Gobi vault commands for publishing your vault profile and syncing files (v2.0.25).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 
@@ -42,7 +42,7 @@ gobi --json vault publish
 
 - `gobi vault init` — Interactive: select an existing vault or create a new one. Writes `vaultSlug` to `.gobi/settings.yaml` in the current directory and seeds `PUBLISH.md`. Requires the user to be logged in (`gobi auth login`).
 - `gobi vault list` — List vaults you own. The primary vault is marked.
-- `gobi vault status` — Show the configured vault's publish state (`isPublished`), profile fields (`title`, `description`, `tags`), referenced files (`thumbnailPath`, `homepagePath`, `promptPath`), file count, and the public profile URL. Use this as a diagnostic before posting with `--auto-attachments` (see gobi-space skill) to confirm the vault is public — files uploaded to a non-public vault are stored on webdrive but are not visible at `gobispace.com/@{vaultSlug}` until you run `gobi vault publish`.
+- `gobi vault status` — Show the configured vault's publish state (`isPublished`), profile fields (`title`, `description`, `tags`), referenced files (`thumbnailPath`, `homepagePath`, `promptPath`), file count, and the public profile URL. Use this as a diagnostic before authoring a markdown artifact with `--auto-attachments` (see gobi-artifact skill) to confirm the vault is public — files uploaded to a non-public vault are stored on webdrive but are not visible at `gobispace.com/@{vaultSlug}` until you run `gobi vault publish`.
 - `gobi vault create <slug> --name <name>` — Create a new vault with the given slug and display name. Slug must be unique (use `vault list` to see what's taken). Does not change the configured vault — run `vault init` here or `vault set-primary <slug>` afterwards if you want to anchor to it.
 - `gobi vault rename <newName>` — Rename the configured vault's display name. Pass `--vault-slug <slug>` to target another vault. Local handle only — the public profile title comes from `PUBLISH.md` frontmatter and is unaffected.
 - `gobi vault set-primary <slug>` — Mark a vault as your primary. Unsets primary on the others. Required arg, no `.gobi` fallback (avoids accidental promotion).

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

@@ -18,7 +18,7 @@ Commands:
                               first.
   set-primary <slug>          Mark a vault as your primary. Unsets primary on the other vaults you own. Slug must be passed explicitly.
   list                        List vaults you own.
-  status [options]            Show the configured vault's publish state and metadata (use before posting with --auto-attachments to confirm the vault is public).
+  status [options]            Show the configured vault's publish state and metadata (use before authoring a markdown artifact with --auto-attachments to confirm the vault is public).
   publish                     Upload PUBLISH.md to the vault root on webdrive. Triggers post-processing (vault sync, metadata update).
   unpublish                   Delete PUBLISH.md from the vault on webdrive.
   sync [options]              Sync local vault files with Gobi Webdrive.
@@ -100,7 +100,7 @@ Options:
 ```
 Usage: gobi vault status [options]
 
-Show the configured vault's publish state and metadata (use before posting with --auto-attachments to confirm the vault is public).
+Show the configured vault's publish state and metadata (use before authoring a markdown artifact with --auto-attachments to confirm the vault is public).
 
 Options:
   --vault-slug <vaultSlug>  Vault slug to inspect (defaults to .gobi/settings.yaml)

package/dist/commands/draft.js

@@ -1,230 +0,0 @@
-import { apiDelete, apiGet, apiPatch, apiPost } from "../client.js";
-import { isJsonMode, jsonOut, readStdin, unwrapResp } from "./utils.js";
-function readContent(value) {
-    if (value === "-")
-        return readStdin();
-    return value;
-}
-function snippet(content, max = 80) {
-    const single = content.replace(/\s+/g, " ");
-    return single.length > max ? `${single.slice(0, max)}…` : single;
-}
-function parseActionFlags(values) {
-    if (!values)
-        return [];
-    return values
-        .map((v) => v.trim())
-        .filter(Boolean)
-        .slice(0, 3)
-        .map((entry) => {
-        const sep = entry.indexOf("::");
-        if (sep === -1)
-            return { label: entry };
-        const label = entry.slice(0, sep).trim();
-        const message = entry.slice(sep + 2).trim();
-        return message ? { label, message } : { label };
-    })
-        .filter((a) => a.label.length > 0);
-}
-function formatDraftLine(d) {
-    const status = d.status === "pending" ? "·" : "✓";
-    const actionCount = d.actions.length;
-    return `- [${status}] p${d.priority} rev${d.revision} ${d.draftId.slice(0, 8)}  ${snippet(d.title)} (${actionCount} action${actionCount === 1 ? "" : "s"})`;
-}
-export function registerDraftCommand(program) {
-    // The draft command surface is designed for agent use: every subcommand
-    // accepts `--json` (set globally) and returns the same envelope shape, and
-    // the agent-authoring flow funnels through `add` + `revise` while user-
-    // facing decisions go through `action` and `revise` (with --comment).
-    const draft = program
-        .command("draft")
-        .description("Drafts authored by your agent during chat. Each carries up to 3 AI-suggested actions. Top-5 pending feed the system prompt; picking an action posts a synthesized message into the originating session.");
-    // ── List ──
-    draft
-        .command("list")
-        .description("List drafts (priority ASC, then newest first).")
-        .option("--limit <number>", "Items per page", "20")
-        .action(async (opts) => {
-        const params = { limit: parseInt(opts.limit, 10) };
-        const resp = (await apiGet("/app/drafts", params));
-        const items = (resp.data || []);
-        if (isJsonMode(draft)) {
-            jsonOut(items);
-            return;
-        }
-        if (!items.length) {
-            console.log("No drafts.");
-            return;
-        }
-        console.log(`Drafts (${items.length}):`);
-        for (const d of items)
-            console.log(formatDraftLine(d));
-    });
-    // ── Get ──
-    draft
-        .command("get <draftId>")
-        .description("Get one draft with its history and suggested actions.")
-        .action(async (draftId) => {
-        const resp = (await apiGet(`/app/drafts/${draftId}`));
-        const d = unwrapResp(resp);
-        if (isJsonMode(draft)) {
-            jsonOut(d);
-            return;
-        }
-        console.log(`Draft ${d.draftId}`);
-        console.log(`  title:    ${d.title}`);
-        console.log(`  status:   ${d.status}`);
-        console.log(`  priority: ${d.priority}`);
-        console.log(`  revision: ${d.revision}`);
-        console.log(`  session:  ${d.sessionId}`);
-        if (d.vaultSlug)
-            console.log(`  vault:    ${d.vaultSlug}`);
-        console.log(`  created:  ${d.createdAt}`);
-        console.log("");
-        console.log("Content:");
-        console.log(d.content);
-        if (d.actions.length) {
-            console.log("");
-            console.log("Suggested actions:");
-            d.actions.forEach((a, i) => {
-                console.log(`  [${i}] ${a.label}`);
-                if (a.message)
-                    console.log(`      → ${a.message}`);
-            });
-        }
-        if (d.history.length) {
-            console.log("");
-            console.log("History:");
-            for (const h of d.history) {
-                console.log(`  ${h.createdAt}  rev${h.revision}  ${h.type}`);
-                if (h.type === "created" || h.type === "revised") {
-                    if (h.title !== undefined)
-                        console.log(`    title:   ${h.title}`);
-                    if (h.content !== undefined) {
-                        console.log(`    content: ${snippet(h.content, 200)}`);
-                    }
-                    if (h.actions !== undefined && h.actions.length) {
-                        console.log(`    actions: ${h.actions
-                            .map((a) => (a.message ? `${a.label} :: ${a.message}` : a.label))
-                            .join(" | ")}`);
-                    }
-                    if (h.comment !== undefined)
-                        console.log(`    comment: ${h.comment}`);
-                }
-                else if (h.type === "prioritized" && h.priority !== undefined) {
-                    console.log(`    priority=${h.priority}`);
-                }
-                else if (h.type === "actioned") {
-                    console.log(`    action[${h.actionIndex}]=${h.actionLabel}`);
-                }
-            }
-        }
-    });
-    // ── Add ──
-    draft
-        .command("add <title> <content>")
-        .description("Add a draft. Pass '-' for content to read from stdin. Pass --action up to 3 times to attach AI-suggested actions. Session id is optional: the Gobi agent runtime exports GOBI_SESSION_ID automatically and `--session` takes precedence; if neither is set, the server mints a new chat session anchored to your primary vault and seeds it with the draft so clicking an action later has somewhere to land.")
-        .option("--session <sessionId>", "Originating chat session UUID. Falls back to $GOBI_SESSION_ID; if unset, the server creates a new session.")
-        .option("--priority <number>", "Priority (lower = higher), default 100")
-        .option("--action <label[::message]>", "Suggested action (repeatable, max 3). `label` is the button text; an optional `::message` suffix is what the user is taken to be saying to the agent on click. Without the suffix, the message falls back to the label.", (value, prev = []) => [...prev, value], [])
-        .option("--vault-slug <vaultSlug>", "Anchor vault for this draft. When set, clients render the draft against this vault, and a sessionId-less create bootstraps the new chat session here instead of your primary vault.")
-        .action(async (title, content, opts) => {
-        const sessionId = opts.session || process.env.GOBI_SESSION_ID;
-        const body = {
-            title,
-            content: readContent(content),
-        };
-        if (sessionId)
-            body.sessionId = sessionId;
-        if (opts.priority)
-            body.priority = parseInt(opts.priority, 10);
-        const actions = parseActionFlags(opts.action);
-        if (actions.length)
-            body.actions = actions;
-        if (opts.vaultSlug)
-            body.vaultSlug = opts.vaultSlug;
-        const resp = (await apiPost("/app/drafts", body));
-        const d = unwrapResp(resp);
-        if (isJsonMode(draft)) {
-            jsonOut(d);
-            return;
-        }
-        console.log(`Created ${d.draftId} (priority ${d.priority}, ${d.actions.length} action${d.actions.length === 1 ? "" : "s"}).`);
-    });
-    // ── Delete ──
-    draft
-        .command("delete <draftId>")
-        .description("Delete a draft.")
-        .action(async (draftId) => {
-        await apiDelete(`/app/drafts/${draftId}`);
-        if (isJsonMode(draft)) {
-            jsonOut({ id: draftId });
-            return;
-        }
-        console.log(`Deleted ${draftId}.`);
-    });
-    // ── Prioritize ──
-    draft
-        .command("prioritize <draftId> <priority>")
-        .description("Set priority (lower = higher). Top 5 feed the system prompt.")
-        .action(async (draftId, priority) => {
-        const resp = (await apiPatch(`/app/drafts/${draftId}/priority`, {
-            priority: parseInt(priority, 10),
-        }));
-        const d = unwrapResp(resp);
-        if (isJsonMode(draft)) {
-            jsonOut(d);
-            return;
-        }
-        console.log(`Set ${d.draftId} priority to ${d.priority}.`);
-    });
-    // ── Action ──
-    draft
-        .command("action <draftId> <actionIndex>")
-        .description("Take one of the draft's suggested actions by 0-based index. Marks the draft 'actioned' and the client posts the synthesized message into the originating session.")
-        .action(async (draftId, actionIndex) => {
-        const idx = parseInt(actionIndex, 10);
-        if (Number.isNaN(idx) || idx < 0 || idx > 2) {
-            throw new Error("actionIndex must be 0, 1, or 2.");
-        }
-        const resp = (await apiPost(`/app/drafts/${draftId}/action`, {
-            actionIndex: idx,
-        }));
-        const d = unwrapResp(resp);
-        if (isJsonMode(draft)) {
-            jsonOut(d);
-            return;
-        }
-        const label = d.actions[idx]?.label ?? `action ${idx}`;
-        console.log(`Took action "${label}" on ${d.draftId}.`);
-    });
-    // ── Revise ──
-    draft
-        .command("revise <draftId> <comment>")
-        .description("Bump the draft to a new revision. Comment is required. Pass --title, --content, and/or --action to update the draft in the same call (--action repeatable, max 3, replaces all). Pass '-' for any of comment/title/content to read from stdin.")
-        .option("--title <title>", "Replacement title")
-        .option("--content <content>", "Replacement content; pass '-' to read from stdin")
-        .option("--action <label[::message]>", "Replacement suggested action (repeatable, max 3). Same `label[::message]` syntax as `draft add`. When passed, replaces the entire actions array.", (value, prev = []) => [...prev, value], [])
-        .option("--vault-slug <vaultSlug>", "Replacement anchor vault. When set, switches the draft's anchor vault. Carries forward when omitted.")
-        .action(async (draftId, comment, opts) => {
-        const body = {
-            comment: readContent(comment),
-        };
-        if (opts.title !== undefined)
-            body.title = opts.title;
-        if (opts.content !== undefined)
-            body.content = readContent(opts.content);
-        if (opts.action && opts.action.length > 0) {
-            body.actions = parseActionFlags(opts.action);
-        }
-        if (opts.vaultSlug !== undefined)
-            body.vaultSlug = opts.vaultSlug;
-        const resp = (await apiPost(`/app/drafts/${draftId}/revise`, body));
-        const d = unwrapResp(resp);
-        if (isJsonMode(draft)) {
-            jsonOut(d);
-            return;
-        }
-        console.log(`Revised ${d.draftId} → rev${d.revision}.`);
-    });
-}