@gobi-ai/cli 0.9.13 → 1.1.0

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

@@ -0,0 +1,66 @@
+# gobi vault
+
+```
+Usage: gobi vault [options] [command]
+
+Vault commands. A Vault is your personal knowledge container — search public vaults, ask them questions, and publish a PUBLISH.md to make a vault public.
+
+Options:
+  -h, --help        display help for command
+
+Commands:
+  search [options]  Search public vaults by text and semantic similarity.
+  ask [options]     Ask a vault a question. Creates a targeted session (1:1 conversation).
+  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.
+  help [command]    display help for command
+```
+
+## search
+
+```
+Usage: gobi vault search [options]
+
+Search public vaults by text and semantic similarity.
+
+Options:
+  --query <query>  Search query
+  -h, --help       display help for command
+```
+
+## ask
+
+```
+Usage: gobi vault ask [options]
+
+Ask a vault a question. Creates a targeted session (1:1 conversation).
+
+Options:
+  --vault-slug <vaultSlug>  Slug of the vault to ask
+  --question <question>     The question to ask (markdown supported)
+  --rich-text <richText>    Rich-text JSON array (e.g. [{"type":"text","text":"hello"}])
+  --mode <mode>             Session mode: "auto" or "manual"
+  -h, --help                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
+```

package/dist/commands/brain.js

@@ -1,347 +0,0 @@
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
-import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
-import { WEBDRIVE_BASE_URL } from "../constants.js";
-import { getValidToken } from "../auth/manager.js";
-import { getVaultSlug } from "./init.js";
-import { isJsonMode, jsonOut, resolveVaultSlug, unwrapResp } from "./utils.js";
-import { extractWikiLinks, uploadAttachments } from "../attachments.js";
-export function registerBrainCommand(program) {
-    const brain = program
-        .command("brain")
-        .description("Brain commands (search, ask, publish, unpublish, updates).");
-    // ── 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}"`);
-    });
-    // ── Updates (list, post, edit, delete) ──
-    brain
-        .command("list-updates")
-        .description("List recent brain updates. Without --space-slug, lists all updates for you. With --space-slug, lists updates for that space. Use --mine to show only updates by you.")
-        .option("--vault-slug <vaultSlug>", "Vault slug (overrides .gobi/settings.yaml)")
-        .option("--space-slug <spaceSlug>", "List updates for a space")
-        .option("--mine", "List only my own brain updates")
-        .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;
-        if (opts.mine)
-            params.mine = true;
-        if (opts.vaultSlug)
-            params.vaultSlug = opts.vaultSlug;
-        const path = opts.spaceSlug
-            ? `/spaces/${opts.spaceSlug}/brain-updates`
-            : `/brain-updates`;
-        const resp = (await apiGet(path, params));
-        if (isJsonMode(brain)) {
-            jsonOut({
-                items: resp.data || [],
-                pagination: resp.pagination || {},
-            });
-            return;
-        }
-        const items = (resp.data || []);
-        const pagination = (resp.pagination || {});
-        if (!items.length) {
-            console.log("No brain updates found.");
-            return;
-        }
-        const lines = [];
-        for (const u of items) {
-            const author = u.author?.name ||
-                `User ${u.authorId}`;
-            const vaultSlug = u.vault?.vaultSlug ||
-                "?";
-            lines.push(`- [${u.id}] "${u.title}" by ${author} (vault: ${vaultSlug}, ${u.createdAt})`);
-        }
-        const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
-        console.log(`Brain updates (${items.length} items):\n` + lines.join("\n") + footer);
-    });
-    brain
-        .command("post-update")
-        .description("Post a brain update for a vault.")
-        .option("--vault-slug <vaultSlug>", "Vault slug (overrides .gobi/settings.yaml)")
-        .requiredOption("--title <title>", "Title of the update")
-        .requiredOption("--content <content>", "Update content (markdown supported)")
-        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before posting")
-        .action(async (opts) => {
-        const vaultSlug = resolveVaultSlug(opts);
-        if (opts.autoAttachments) {
-            const token = await getValidToken();
-            const links = extractWikiLinks(opts.content);
-            await uploadAttachments(vaultSlug, links, token, { addToSyncfiles: true });
-        }
-        const resp = (await apiPost(`/brain-updates/vault/${vaultSlug}`, {
-            title: opts.title,
-            content: opts.content,
-        }));
-        const u = unwrapResp(resp);
-        if (isJsonMode(brain)) {
-            jsonOut(u);
-            return;
-        }
-        console.log(`Brain update posted!\n` +
-            `  ID: ${u.id}\n` +
-            `  Title: ${u.title}\n` +
-            `  Vault: ${u.vaultSlug || vaultSlug}\n` +
-            `  Created: ${u.createdAt}`);
-    });
-    brain
-        .command("edit-update <updateId>")
-        .description("Edit a published brain update. You must be the author.")
-        .option("--title <title>", "New title for the update")
-        .option("--content <content>", "New content for the update (markdown supported)")
-        .option("--vault-slug <vaultSlug>", "Vault slug for attachment uploads (overrides .gobi/settings.yaml)")
-        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before editing")
-        .action(async (updateId, opts) => {
-        if (!opts.title && !opts.content) {
-            throw new Error("Provide at least --title or --content to update.");
-        }
-        if (opts.autoAttachments && opts.content) {
-            const vaultSlug = resolveVaultSlug(opts);
-            const token = await getValidToken();
-            const links = extractWikiLinks(opts.content);
-            await uploadAttachments(vaultSlug, links, token, { addToSyncfiles: true });
-        }
-        const body = {};
-        if (opts.title != null)
-            body.title = opts.title;
-        if (opts.content != null)
-            body.content = opts.content;
-        const resp = (await apiPatch(`/brain-updates/${updateId}`, body));
-        const u = unwrapResp(resp);
-        if (isJsonMode(brain)) {
-            jsonOut(u);
-            return;
-        }
-        console.log(`Brain update edited!\n` +
-            `  ID: ${u.id}\n` +
-            `  Title: ${u.title}\n` +
-            `  Updated: ${u.updatedAt}`);
-    });
-    brain
-        .command("delete-update <updateId>")
-        .description("Delete a published brain update. You must be the author.")
-        .action(async (updateId) => {
-        await apiDelete(`/brain-updates/${updateId}`);
-        if (isJsonMode(brain)) {
-            jsonOut({ id: updateId });
-            return;
-        }
-        console.log(`Brain update ${updateId} deleted.`);
-    });
-    // ── Update Replies (get-update, reply-to-update, edit-update-reply, delete-update-reply) ──
-    brain
-        .command("get-update <updateId>")
-        .description("Get a 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(`/brain-updates/${updateId}`, params));
-        const data = unwrapResp(resp);
-        const pagination = (resp.pagination || {});
-        if (isJsonMode(brain)) {
-            jsonOut({ ...data, pagination });
-            return;
-        }
-        const update = (data.update || data);
-        const replies = (data.replies || []);
-        const author = update.author?.name ||
-            `User ${update.authorId}`;
-        const vault = update.vault?.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) + "\u2026";
-            replyLines.push(`  - ${rAuthor}: ${truncated} (${r.createdAt})`);
-        }
-        const output = [
-            `Brain 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);
-    });
-    brain
-        .command("reply-to-update <updateId>")
-        .description("Reply to a brain update.")
-        .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(`/brain-updates/${updateId}/replies`, { content }));
-        const reply = unwrapResp(resp);
-        if (isJsonMode(brain)) {
-            jsonOut(reply);
-            return;
-        }
-        console.log(`Reply created!\n  ID: ${reply.id}\n  Created: ${reply.createdAt}`);
-    });
-    brain
-        .command("edit-update-reply <replyId>")
-        .description("Edit a brain update reply. You must be the author.")
-        .requiredOption("--content <content>", "New content for the reply (markdown supported)")
-        .action(async (replyId, opts) => {
-        const resp = (await apiPatch(`/brain-updates/replies/${replyId}`, { content: opts.content }));
-        const reply = unwrapResp(resp);
-        if (isJsonMode(brain)) {
-            jsonOut(reply);
-            return;
-        }
-        console.log(`Reply edited!\n  ID: ${reply.id}\n  Edited: ${reply.editedAt}`);
-    });
-    brain
-        .command("delete-update-reply <replyId>")
-        .description("Delete a brain update reply. You must be the author.")
-        .action(async (replyId) => {
-        await apiDelete(`/brain-updates/replies/${replyId}`);
-        if (isJsonMode(brain)) {
-            jsonOut({ replyId });
-            return;
-        }
-        console.log(`Brain update reply ${replyId} deleted.`);
-    });
-}

package/skills/gobi-brain/SKILL.md

@@ -1,113 +0,0 @@
----
-name: gobi-brain
-description: >-
-  Gobi brain commands for knowledge management: search public brains by text
-  and semantic similarity, ask brains questions, publish/unpublish BRAIN.md,
-  and manage brain updates (list/post/edit/delete). Use when the user wants
-  to search knowledge, ask a brain, publish their brain document, or manage
-  brain updates.
-allowed-tools: Bash(gobi:*)
-metadata:
-  author: gobi-ai
-  version: "0.8.0"
----
-
-# gobi-brain
-
-Gobi brain commands for knowledge management (v0.8.0).
-
-Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
-
-## Gobi Brain — Knowledge Management
-
-`gobi brain` commands manage your vault's brain: search across all spaces, ask brains questions, and publish/unpublish your BRAIN.md. Public brains are accessible at `https://gobispace.com/@{vaultSlug}`.
-
-## Space Slug Override
-
-For `gobi brain list-updates`, you can filter by space with a subcommand option:
-
-```bash
-gobi brain list-updates --space-slug <slug>
-```
-
-Note: `--space-slug` is not available on other `brain` subcommands.
-
-## Important: JSON Mode
-
-For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
-
-```bash
-gobi --json brain search --query "machine learning"
-```
-
-## Available Commands
-
-- `gobi brain search` — Search public brains by text and semantic similarity.
-- `gobi brain ask` — Ask a brain a question. Creates a targeted session (1:1 conversation).
-- `gobi brain publish` — Upload BRAIN.md to the vault root on webdrive. Triggers post-processing (brain sync, metadata update, Discord notification).
-- `gobi brain unpublish` — Delete BRAIN.md from the vault on webdrive.
-- `gobi brain list-updates` — List recent brain updates. Without --space-slug, lists all updates for you. With --space-slug, lists updates for that space. Use --mine to show only updates by you.
-- `gobi brain post-update` — Post a brain update for a vault.
-- `gobi brain edit-update` — Edit a published brain update. You must be the author.
-- `gobi brain delete-update` — Delete a published brain update. You must be the author.
-
-## BRAIN.md Frontmatter Reference
-
-`BRAIN.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 Brain
-tags:
-  - topic1
-  - topic2
-description: A short description of what this brain is about.
-thumbnail: "[[BRAIN.png]]"
-homepage: "[[app/home.html?nav=false]]"
-prompt: "[[system-prompt.md]]"
----
-```
-
-### Fields
-
-- **`title`** (required) — Display name of the brain/vault.
-- **`description`** (required for public listing) — Short description shown on the brain card and public profile. Without both `title` and `description`, the brain 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 brain card. Uses wiki-link syntax pointing to an image file in the vault (e.g. `"[[BRAIN.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 brain'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 `BRAIN.md` frontmatter, follow these steps to make your changes live:
-
-1. **Edit `BRAIN.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 sync
-   ```
-3. **Publish the brain**:
-   ```bash
-   gobi brain publish
-   ```
-   This uploads `BRAIN.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 `BRAIN.md` frontmatter (e.g. adding or updating `homepage`), you must re-run `gobi brain publish` for the changes to take effect.
-
-## Reference Documentation
-
-- [gobi brain](references/brain.md)