@gobi-ai/cli 1.3.8 → 2.0.0

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

@@ -3,29 +3,28 @@
 ```
 Usage: gobi space [options] [command]
 
-Space commands (threads, replies). Space and member admin is web-UI only.
+Space commands (posts, replies). Space and member admin is web-UI only.
 
 Options:
-  --space-slug <slug>                       Space slug (overrides .gobi/settings.yaml)
-  -h, --help                                display help for command
+  --space-slug <slug>                     Space slug (overrides .gobi/settings.yaml)
+  -h, --help                              display help for command
 
 Commands:
-  list                                      List spaces you are a member of.
-  get [spaceSlug]                           Get details for a space. Pass a slug or omit to use the current space (from .gobi/settings.yaml or --space-slug).
-  warp [spaceSlug]                          Select the active space. Pass a slug to warp directly, or omit for interactive selection.
-  list-topics [options]                     List topics in a space, ordered by most recent content linkage.
-  list-topic-threads [options] <topicSlug>  List threads tagged with a topic in a space (cursor-paginated).
-  messages [options]                        List the unified message feed (threads and replies, newest first) in a space.
-  ancestors <threadId>                      Show the ancestor lineage of a thread or reply (root → immediate parent).
-  get-thread [options] <threadId>           Get a thread and its replies (paginated).
-  list-threads [options]                    List threads in a space (paginated).
-  create-thread [options]                   Create a thread in a space.
-  edit-thread [options] <threadId>          Edit a thread. You must be the author.
-  delete-thread <threadId>                  Delete a thread. You must be the author.
-  create-reply [options] <threadId>         Create a reply to a thread in a space.
-  edit-reply [options] <replyId>            Edit a reply. You must be the author.
-  delete-reply <replyId>                    Delete a reply. You must be the author.
-  help [command]                            display help for command
+  list                                    List spaces you are a member of.
+  get [spaceSlug]                         Get details for a space. Pass a slug or omit to use the current space (from .gobi/settings.yaml or --space-slug).
+  warp [spaceSlug]                        Select the active space. Pass a slug to warp directly, or omit for interactive selection.
+  list-topics [options]                   List topics in a space, ordered by most recent content linkage.
+  list-topic-posts [options] <topicSlug>  List posts tagged with a topic in a space (cursor-paginated).
+  feed [options]                          List the unified feed (posts and replies, newest first) in a space.
+  get-post [options] <postId>             Get a post with its ancestors and replies (paginated).
+  list-posts [options]                    List posts in a space (paginated).
+  create-post [options]                   Create a post in a space.
+  edit-post [options] <postId>            Edit a post. You must be the author.
+  delete-post <postId>                    Delete a post. You must be the author.
+  create-reply [options] <postId>         Create a reply to a post in a space.
+  edit-reply [options] <replyId>          Edit a reply. You must be the author.
+  delete-reply <replyId>                  Delete a reply. You must be the author.
+  help [command]                          display help for command
 ```
 
 ## get
@@ -51,12 +50,12 @@ Options:
   -h, --help        display help for command
 ```
 
-## list-topic-threads
+## list-topic-posts
 
 ```
-Usage: gobi space list-topic-threads [options] <topicSlug>
+Usage: gobi space list-topic-posts [options] <topicSlug>
 
-List threads tagged with a topic in a space (cursor-paginated).
+List posts tagged with a topic in a space (cursor-paginated).
 
 Options:
   --limit <number>   Items per page (default: "20")
@@ -64,12 +63,12 @@ Options:
   -h, --help         display help for command
 ```
 
-## messages
+## feed
 
 ```
-Usage: gobi space messages [options]
+Usage: gobi space feed [options]
 
-List the unified message feed (threads and replies, newest first) in a space.
+List the unified feed (posts and replies, newest first) in a space.
 
 Options:
   --limit <number>   Items per page (default: "20")
@@ -77,23 +76,12 @@ Options:
   -h, --help         display help for command
 ```
 
-## ancestors
+## get-post
 
 ```
-Usage: gobi space ancestors [options] <threadId>
+Usage: gobi space get-post [options] <postId>
 
-Show the ancestor lineage of a thread or reply (root → immediate parent).
-
-Options:
-  -h, --help  display help for command
-```
-
-## get-thread
-
-```
-Usage: gobi space get-thread [options] <threadId>
-
-Get a thread and its replies (paginated).
+Get a post with its ancestors and replies (paginated).
 
 Options:
   --limit <number>   Replies per page (default: "20")
@@ -101,12 +89,12 @@ Options:
   -h, --help         display help for command
 ```
 
-## list-threads
+## list-posts
 
 ```
-Usage: gobi space list-threads [options]
+Usage: gobi space list-posts [options]
 
-List threads in a space (paginated).
+List posts in a space (paginated).
 
 Options:
   --limit <number>   Items per page (default: "20")
@@ -114,42 +102,42 @@ Options:
   -h, --help         display help for command
 ```
 
-## create-thread
+## create-post
 
 ```
-Usage: gobi space create-thread [options]
+Usage: gobi space create-post [options]
 
-Create a thread in a space.
+Create a post in a space.
 
 Options:
-  --title <title>           Title of the thread
-  --content <content>       Thread content (markdown supported)
+  --title <title>           Title of the post
+  --content <content>       Post content (markdown supported)
   --auto-attachments        Upload wiki-linked [[files]] to webdrive before posting
   --vault-slug <vaultSlug>  Vault slug for attachment uploads (overrides .gobi/settings.yaml)
   -h, --help                display help for command
 ```
 
-## edit-thread
+## edit-post
 
 ```
-Usage: gobi space edit-thread [options] <threadId>
+Usage: gobi space edit-post [options] <postId>
 
-Edit a thread. You must be the author.
+Edit a post. You must be the author.
 
 Options:
-  --title <title>           New title for the thread
-  --content <content>       New content for the thread (markdown supported)
+  --title <title>           New title for the post
+  --content <content>       New content for the post (markdown supported)
   --auto-attachments        Upload wiki-linked [[files]] to webdrive before editing
   --vault-slug <vaultSlug>  Vault slug for attachment uploads (overrides .gobi/settings.yaml)
   -h, --help                display help for command
 ```
 
-## delete-thread
+## delete-post
 
 ```
-Usage: gobi space delete-thread [options] <threadId>
+Usage: gobi space delete-post [options] <postId>
 
-Delete a thread. You must be the author.
+Delete a post. You must be the author.
 
 Options:
   -h, --help  display help for command
@@ -158,9 +146,9 @@ Options:
 ## create-reply
 
 ```
-Usage: gobi space create-reply [options] <threadId>
+Usage: gobi space create-reply [options] <postId>
 
-Create a reply to a thread in a space.
+Create a reply to a post in a space.
 
 Options:
   --content <content>  Reply content (markdown supported)

package/skills/gobi-vault/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: gobi-vault
+description: >-
+  Gobi vault commands for publishing your vault profile and syncing files:
+  publish/unpublish PUBLISH.md and run the local-to-webdrive sync. Use when
+  the user wants to publish their vault, unpublish it, or push/pull files.
+allowed-tools: Bash(gobi:*)
+metadata:
+  author: gobi-ai
+  version: "0.9.13"
+---
+
+# gobi-vault
+
+Gobi vault commands for publishing your vault profile and syncing files (v0.9.13).
+
+Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
+
+## Gobi Vault
+
+A "vault" is your file-backed knowledge home. Public vaults are accessible at `https://gobispace.com/@{vaultSlug}`. Each vault has a profile written to `PUBLISH.md` at its root; publishing pushes that file to webdrive, which then updates vault metadata and the public profile.
+
+## Important: JSON Mode
+
+For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
+
+```bash
+gobi --json vault publish
+```
+
+## Available Commands
+
+- `gobi vault publish` — Upload `PUBLISH.md` to the vault root on webdrive. Triggers post-processing (vault profile sync, metadata update, Discord notification).
+- `gobi vault unpublish` — Delete `PUBLISH.md` from the vault on webdrive.
+- `gobi vault sync` — Sync local vault files with Gobi Webdrive. Supports `--upload-only`, `--download-only`, `--conflict <ask|server|client|skip>`, `--dry-run`, `--full`, `--path <p>`, `--plan-file`, `--execute`.
+
+## PUBLISH.md Frontmatter Reference
+
+`PUBLISH.md` is the metadata file at the root of every vault. Its YAML frontmatter controls the vault's public profile, homepage, and AI agent behavior. Example:
+
+```yaml
+---
+title: My Vault
+tags:
+  - topic1
+  - topic2
+description: A short description of what this vault is about.
+thumbnail: "[[PROFILE.png]]"
+homepage: "[[app/home.html?nav=false]]"
+prompt: "[[system-prompt.md]]"
+---
+```
+
+### Fields
+
+- **`title`** (required) — Display name of the vault.
+- **`description`** (required for public listing) — Short description shown on the vault card and public profile. Without both `title` and `description`, the vault won't appear in the public catalog.
+- **`tags`** — Tags for categorization and discovery. Supports YAML block list or inline array format:
+  ```yaml
+  # Block list
+  tags:
+    - ambient ai
+    - wearables
+
+  # Inline array
+  tags: [ambient ai, wearables]
+  ```
+- **`thumbnail`** — Profile image for the vault card. Uses wiki-link syntax pointing to an image file in the vault (e.g. `"[[PROFILE.png]]"`).
+- **`homepage`** — Custom HTML page to serve as the vault's public homepage at `gobispace.com/@{vaultSlug}`. Uses wiki-link syntax pointing to an HTML file in the vault. Supports a `nav` query parameter to control Gobi's sidebar navigation:
+  - `"[[app/home.html]]"` — Shows the Gobi sidebar alongside the homepage (default)
+  - `"[[app/home.html?nav=false]]"` — Full-screen, no Gobi sidebar/chrome
+- **`prompt`** — Wiki-link to a custom system prompt file for the vault's AI agent (e.g. `"[[system-prompt.md]]"`).
+
+> For details on building custom HTML homepages and using the `window.gobi` API, see the **gobi-homepage** skill.
+
+## Publishing Workflow
+
+After editing `PUBLISH.md` frontmatter, follow these steps to make your changes live:
+
+1. **Edit `PUBLISH.md`** in the vault root with the desired frontmatter fields.
+2. **Sync referenced files** — if the homepage HTML, thumbnail image, or prompt file is new or updated, upload them first:
+   ```bash
+   gobi vault sync
+   ```
+3. **Publish the vault**:
+   ```bash
+   gobi vault publish
+   ```
+   This uploads `PUBLISH.md` to webdrive, triggers post-processing that extracts metadata (title, description, tags, thumbnail, homepage path), updates the vault's public profile, and sends a Discord notification.
+4. The vault is now live at `https://gobispace.com/@{vaultSlug}`.
+
+> **Important:** Any time you change `PUBLISH.md` frontmatter (e.g. adding or updating `homepage`), you must re-run `gobi vault publish` for the changes to take effect.

package/skills/{gobi-core/references/sync.md → gobi-vault/references/vault.md}

@@ -1,7 +1,46 @@
-# gobi sync
+# gobi vault
 
 ```
-Usage: gobi sync [options]
+Usage: gobi vault [options] [command]
+
+Vault commands (publish/unpublish profile, sync files).
+
+Options:
+  -h, --help      display help for command
+
+Commands:
+  publish         Upload PUBLISH.md to the vault root on webdrive. Triggers post-processing (vault sync, metadata update, Discord notification).
+  unpublish       Delete PUBLISH.md from the vault on webdrive.
+  sync [options]  Sync local vault files with Gobi Webdrive.
+  help [command]  display help for command
+```
+
+## publish
+
+```
+Usage: gobi vault publish [options]
+
+Upload PUBLISH.md to the vault root on webdrive. Triggers post-processing (vault sync, metadata update, Discord notification).
+
+Options:
+  -h, --help  display help for command
+```
+
+## unpublish
+
+```
+Usage: gobi vault unpublish [options]
+
+Delete PUBLISH.md from the vault on webdrive.
+
+Options:
+  -h, --help  display help for command
+```
+
+## sync
+
+```
+Usage: gobi vault sync [options]
 
 Sync local vault files with Gobi Webdrive.
 

package/dist/commands/brain.js

@@ -1,141 +0,0 @@
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
-import { apiGet, apiPost } from "../client.js";
-import { WEBDRIVE_BASE_URL } from "../constants.js";
-import { getValidToken } from "../auth/manager.js";
-import { getVaultSlug } from "./init.js";
-import { isJsonMode, jsonOut, unwrapResp } from "./utils.js";
-export function registerBrainCommand(program) {
-    const brain = program
-        .command("brain")
-        .description("Brain commands (search, ask, publish, unpublish).");
-    // ── Search ──
-    brain
-        .command("search")
-        .description("Search public brains by text and semantic similarity.")
-        .requiredOption("--query <query>", "Search query")
-        .action(async (opts) => {
-        const resp = (await apiGet(`/vault/public/search`, {
-            query: opts.query,
-        }));
-        const results = (Array.isArray(resp) ? resp : resp.data || resp);
-        if (isJsonMode(brain)) {
-            jsonOut(results || []);
-            return;
-        }
-        if (!results || results.length === 0) {
-            console.log(`No brains found matching "${opts.query}".`);
-            return;
-        }
-        const lines = [];
-        for (const entry of results) {
-            const vault = (entry.vault || entry);
-            const owner = (entry.owner || {});
-            const ownerName = owner.name ? ` by ${owner.name}` : "";
-            const sim = entry.similarity != null
-                ? ` [similarity: ${entry.similarity.toFixed(3)}]`
-                : "";
-            const spaceSlug = (entry.spaceSlug || vault.spaceSlug || "");
-            const vaultSlug = (vault.slug || vault.vaultSlug || vault.id || "N/A");
-            lines.push(`- ${vault.name || vault.title || "N/A"} (vault: ${vaultSlug}, space: ${spaceSlug || "N/A"})${ownerName}${sim}`);
-        }
-        console.log(`Brains matching "${opts.query}":\n` + lines.join("\n"));
-    });
-    // ── Ask ──
-    brain
-        .command("ask")
-        .description("Ask a brain a question. Creates a targeted session (1:1 conversation).")
-        .requiredOption("--vault-slug <vaultSlug>", "Slug of the brain/vault to ask")
-        .option("--question <question>", "The question to ask (markdown supported)")
-        .option("--rich-text <richText>", "Rich-text JSON array (e.g. [{\"type\":\"text\",\"text\":\"hello\"}])")
-        .option("--mode <mode>", 'Session mode: "auto" or "manual"')
-        .action(async (opts) => {
-        if (!opts.question && !opts.richText) {
-            throw new Error("Provide either --question or --rich-text.");
-        }
-        if (opts.question && opts.richText) {
-            throw new Error("--question and --rich-text are mutually exclusive.");
-        }
-        const body = {
-            vaultSlug: opts.vaultSlug,
-        };
-        if (opts.question != null)
-            body.question = opts.question;
-        if (opts.richText != null) {
-            let parsed;
-            try {
-                parsed = JSON.parse(opts.richText);
-            }
-            catch {
-                throw new Error("Invalid --rich-text JSON.");
-            }
-            body.richText = parsed;
-        }
-        if (opts.mode != null)
-            body.mode = opts.mode;
-        const resp = (await apiPost(`/chat/targeted`, body));
-        const data = unwrapResp(resp);
-        if (isJsonMode(brain)) {
-            jsonOut(data);
-            return;
-        }
-        const session = (data.session || {});
-        const members = (data.members || []);
-        console.log(`Session created!\n` +
-            `  Session ID: ${session.id}\n` +
-            `  Mode: ${session.mode}\n` +
-            `  Members: ${members.length}\n` +
-            `  Question sent.`);
-    });
-    // ── Publish ──
-    brain
-        .command("publish")
-        .description("Upload BRAIN.md to the vault root on webdrive. Triggers post-processing (brain sync, metadata update, Discord notification).")
-        .action(async () => {
-        const vaultId = getVaultSlug();
-        const filePath = join(process.cwd(), "BRAIN.md");
-        if (!existsSync(filePath)) {
-            throw new Error(`BRAIN.md not found in ${process.cwd()}`);
-        }
-        const content = readFileSync(filePath, "utf-8");
-        const token = await getValidToken();
-        const url = `${WEBDRIVE_BASE_URL}/api/v1/vaults/${vaultId}/file/BRAIN.md`;
-        const res = await fetch(url, {
-            method: "PUT",
-            headers: {
-                Authorization: `Bearer ${token}`,
-                "Content-Type": "text/markdown",
-            },
-            body: content,
-        });
-        if (!res.ok) {
-            throw new Error(`Upload failed: HTTP ${res.status}: ${(await res.text()) || "(no body)"}`);
-        }
-        if (isJsonMode(brain)) {
-            jsonOut({ vaultId });
-            return;
-        }
-        console.log(`Published BRAIN.md to vault "${vaultId}"`);
-    });
-    // ── Unpublish ──
-    brain
-        .command("unpublish")
-        .description("Delete BRAIN.md from the vault on webdrive.")
-        .action(async () => {
-        const vaultId = getVaultSlug();
-        const token = await getValidToken();
-        const url = `${WEBDRIVE_BASE_URL}/api/v1/vaults/${vaultId}/file/BRAIN.md`;
-        const res = await fetch(url, {
-            method: "DELETE",
-            headers: { Authorization: `Bearer ${token}` },
-        });
-        if (!res.ok) {
-            throw new Error(`Delete failed: HTTP ${res.status}: ${(await res.text()) || "(no body)"}`);
-        }
-        if (isJsonMode(brain)) {
-            jsonOut({ vaultId });
-            return;
-        }
-        console.log(`Deleted BRAIN.md from vault "${vaultId}"`);
-    });
-}

package/dist/commands/feed.js

@@ -1,148 +0,0 @@
-import { readFileSync } from "fs";
-import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
-import { isJsonMode, jsonOut, unwrapResp } from "./utils.js";
-export function registerFeedCommand(program) {
-    const feed = program
-        .command("feed")
-        .description("Feed of brain updates from people across the platform.");
-    // ── List ──
-    feed
-        .command("list")
-        .description("List recent brain updates from the global public feed.")
-        .option("--limit <number>", "Items per page", "20")
-        .option("--cursor <string>", "Pagination cursor from previous response")
-        .action(async (opts) => {
-        const params = {
-            limit: parseInt(opts.limit, 10),
-        };
-        if (opts.cursor)
-            params.cursor = opts.cursor;
-        const resp = (await apiGet(`/feed`, params));
-        if (isJsonMode(feed)) {
-            jsonOut({
-                items: resp.data || [],
-                pagination: resp.pagination || {},
-                mentions: resp.mentions || {},
-            });
-            return;
-        }
-        const items = (resp.data || []);
-        const pagination = (resp.pagination || {});
-        if (!items.length) {
-            console.log("No feed items found.");
-            return;
-        }
-        const lines = [];
-        for (const u of items) {
-            const author = u.author?.name ||
-                `User ${u.authorId}`;
-            const vaultSlug = u.vault?.vaultSlug ||
-                u.authorVault?.vaultSlug ||
-                "?";
-            const replyCount = u.replyCount ?? 0;
-            const replies = replyCount ? `, ${replyCount} ${replyCount === 1 ? "reply" : "replies"}` : "";
-            lines.push(`- [${u.id}] "${u.title}" by ${author} (vault: ${vaultSlug}, ${u.createdAt}${replies})`);
-        }
-        const footer = pagination.hasMore
-            ? `\n  Next cursor: ${pagination.nextCursor}`
-            : "";
-        console.log(`Feed (${items.length} items):\n` + lines.join("\n") + footer);
-    });
-    // ── Get ──
-    feed
-        .command("get <updateId>")
-        .description("Get a feed brain update and its replies (paginated).")
-        .option("--limit <number>", "Replies per page", "20")
-        .option("--cursor <string>", "Pagination cursor from previous response")
-        .option("--full", "Show full reply content without truncation")
-        .action(async (updateId, opts) => {
-        const params = {
-            limit: parseInt(opts.limit, 10),
-        };
-        if (opts.cursor)
-            params.cursor = opts.cursor;
-        const resp = (await apiGet(`/feed/${updateId}`, params));
-        const data = unwrapResp(resp);
-        const pagination = (resp.pagination || {});
-        const mentions = (resp.mentions || {});
-        if (isJsonMode(feed)) {
-            jsonOut({ ...data, pagination, mentions });
-            return;
-        }
-        const update = (data.update || data);
-        const replies = (data.replies || []);
-        const author = update.author?.name ||
-            `User ${update.authorId}`;
-        const vault = update.vault?.vaultSlug ||
-            update.authorVault?.vaultSlug ||
-            "?";
-        const replyLines = [];
-        for (const r of replies) {
-            const rAuthor = r.author?.name ||
-                `User ${r.authorId}`;
-            const text = r.content || "";
-            const truncated = opts.full || text.length <= 200 ? text : text.slice(0, 200) + "…";
-            replyLines.push(`  - ${rAuthor}: ${truncated} (${r.createdAt})`);
-        }
-        const output = [
-            `Feed Update: ${update.title || "(no title)"}`,
-            `By: ${author} (vault: ${vault}) on ${update.createdAt}`,
-            "",
-            update.content || "",
-            "",
-            `Replies (${replies.length} items):`,
-            ...replyLines,
-            ...(pagination.hasMore
-                ? [`  Next cursor: ${pagination.nextCursor}`]
-                : []),
-        ].join("\n");
-        console.log(output);
-    });
-    // ── Reply ──
-    feed
-        .command("post-reply <updateId>")
-        .description("Post a reply to a brain update in the feed.")
-        .requiredOption("--content <content>", 'Reply content (markdown supported, use "-" for stdin)')
-        .action(async (updateId, opts) => {
-        const content = opts.content === "-" ? readFileSync("/dev/stdin", "utf8") : opts.content;
-        const resp = (await apiPost(`/feed/${updateId}/replies`, {
-            content,
-        }));
-        const reply = unwrapResp(resp);
-        const mentions = (resp.mentions || {});
-        if (isJsonMode(feed)) {
-            jsonOut({ ...reply, mentions });
-            return;
-        }
-        console.log(`Reply created!\n  ID: ${reply.id}\n  Created: ${reply.createdAt}`);
-    });
-    // ── Edit reply ──
-    feed
-        .command("edit-reply <replyId>")
-        .description("Edit a reply you authored in the feed.")
-        .requiredOption("--content <content>", 'New reply content (markdown supported, use "-" for stdin)')
-        .action(async (replyId, opts) => {
-        const content = opts.content === "-" ? readFileSync("/dev/stdin", "utf8") : opts.content;
-        const resp = (await apiPatch(`/brain-updates/replies/${replyId}`, {
-            content,
-        }));
-        const reply = unwrapResp(resp);
-        if (isJsonMode(feed)) {
-            jsonOut(reply);
-            return;
-        }
-        console.log(`Reply edited!\n  ID: ${reply.id}\n  Edited: ${reply.editedAt}`);
-    });
-    // ── Delete reply ──
-    feed
-        .command("delete-reply <replyId>")
-        .description("Delete a reply you authored in the feed.")
-        .action(async (replyId) => {
-        await apiDelete(`/brain-updates/replies/${replyId}`);
-        if (isJsonMode(feed)) {
-            jsonOut({ replyId });
-            return;
-        }
-        console.log(`Reply ${replyId} deleted.`);
-    });
-}