@gobi-ai/cli 1.3.2 → 1.3.4

package/.claude-plugin/marketplace.json

@@ -4,12 +4,12 @@
     "name": "gobi-ai"
   },
   "description": "Claude Code plugin for the Gobi collaborative knowledge platform CLI",
-  "version": "1.3.2",
+  "version": "1.3.4",
   "plugins": [
     {
       "name": "gobi",
       "description": "Manage the Gobi collaborative knowledge platform from the command line. Search and ask brains, publish brain documents, create threads, manage sessions, generate images and videos.",
-      "version": "1.3.2",
+      "version": "1.3.4",
       "author": {
         "name": "gobi-ai"
       },
@@ -21,6 +21,7 @@
         "./skills/gobi-brain",
         "./skills/gobi-feed",
         "./skills/gobi-notes",
+        "./skills/gobi-proposal",
         "./skills/gobi-media",
         "./skills/gobi-sense",
         "./skills/gobi-homepage"

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gobi",
   "description": "Manage the Gobi collaborative knowledge platform from the command line",
-  "version": "1.3.2",
+  "version": "1.3.4",
   "author": {
     "name": "gobi-ai"
   },
@@ -12,6 +12,7 @@
     "./skills/gobi-brain",
     "./skills/gobi-feed",
     "./skills/gobi-notes",
+    "./skills/gobi-proposal",
     "./skills/gobi-media",
     "./skills/gobi-sense",
     "./skills/gobi-homepage"

package/README.md

@@ -150,6 +150,22 @@ Times are ISO 8601 UTC (e.g. `2026-03-20T00:00:00Z`).
 `notes list` and `notes create` accept `--timezone <iana>` (default: system timezone) for day boundaries.
 `notes list` also accepts `--limit`/`--cursor` for pagination.
 
+### Proposals
+
+Proposals are authored by your agent during chat (or by external agents using `gobi proposal add` as their tool layer). The top 5 pending proposals (lowest priority first) feed the agent's system prompt every turn.
+
+| Command | Description |
+|---------|-------------|
+| `gobi proposal list [--limit N]` | List proposals (priority ASC, then newest first) |
+| `gobi proposal get <id>` | Show one proposal with its history |
+| `gobi proposal add <content> [--session <id>] [--priority N]` | Add a proposal (use `-` for stdin) |
+| `gobi proposal edit <id> <content>` | Replace content; bumps revision |
+| `gobi proposal delete <id>` | Delete a proposal |
+| `gobi proposal prioritize <id> <priority>` | Set priority (lower = higher) |
+| `gobi proposal accept <id>` | Accept; posts "Accept your proposal X" into the originating session |
+| `gobi proposal reject <id>` | Reject; posts "Reject your proposal X" into the originating session |
+| `gobi proposal revise <id> <comment>` | Ask the agent to revise; posts the comment into the session |
+
 ### Sync
 
 | Command | Description |

package/dist/commands/proposal.js

@@ -0,0 +1,178 @@
+import { readFileSync } from "fs";
+import { apiDelete, apiGet, apiPatch, apiPost } from "../client.js";
+import { isJsonMode, jsonOut, unwrapResp } from "./utils.js";
+function readContent(value) {
+    if (value === "-")
+        return readFileSync("/dev/stdin", "utf8");
+    return value;
+}
+function snippet(content, max = 80) {
+    const single = content.replace(/\s+/g, " ");
+    return single.length > max ? `${single.slice(0, max)}…` : single;
+}
+function formatProposalLine(p) {
+    const status = p.status === "pending" ? "·" : p.status === "accepted" ? "✓" : "✗";
+    return `- [${status}] p${p.priority} rev${p.revision} ${p.proposalId.slice(0, 8)}  ${snippet(p.content)}`;
+}
+export function registerProposalCommand(program) {
+    const proposal = program
+        .command("proposal")
+        .description("Proposals authored by your agent during chat. Top-5 feed the system prompt; accept/reject/revise post into the originating chat session.");
+    // ── List ──
+    proposal
+        .command("list")
+        .description("List proposals (priority ASC, then newest first).")
+        .option("--limit <number>", "Max proposals to return (1-200)", "50")
+        .action(async (opts) => {
+        const params = { limit: parseInt(opts.limit, 10) };
+        const resp = (await apiGet("/app/proposals", params));
+        const items = (resp.data || []);
+        if (isJsonMode(proposal)) {
+            jsonOut(items);
+            return;
+        }
+        if (!items.length) {
+            console.log("No proposals.");
+            return;
+        }
+        console.log(`Proposals (${items.length}):`);
+        for (const p of items)
+            console.log(formatProposalLine(p));
+    });
+    // ── Get ──
+    proposal
+        .command("get <proposalId>")
+        .description("Show one proposal with its history.")
+        .action(async (proposalId) => {
+        const resp = (await apiGet(`/app/proposals/${proposalId}`));
+        const p = unwrapResp(resp);
+        if (isJsonMode(proposal)) {
+            jsonOut(p);
+            return;
+        }
+        console.log(`Proposal ${p.proposalId}`);
+        console.log(`  status:   ${p.status}`);
+        console.log(`  priority: ${p.priority}`);
+        console.log(`  revision: ${p.revision}`);
+        console.log(`  session:  ${p.sessionId ?? "(none)"}`);
+        console.log(`  created:  ${p.createdAt}`);
+        console.log("");
+        console.log("Content:");
+        console.log(p.content);
+        if (p.history.length) {
+            console.log("");
+            console.log("History:");
+            for (const h of p.history) {
+                const detail = h.type === "revise_requested"
+                    ? `: ${h.comment}`
+                    : h.type === "prioritized"
+                        ? `: priority=${h.priority}`
+                        : "";
+                console.log(`  ${h.createdAt}  rev${h.revision}  ${h.type}${detail}`);
+            }
+        }
+    });
+    // ── Add ──
+    proposal
+        .command("add <content>")
+        .description("Add a proposal directly. Pass '-' to read from stdin.")
+        .option("--session <sessionId>", "Originate from a chat session (UUID)")
+        .option("--priority <number>", "Priority (lower = higher), default 100")
+        .action(async (content, opts) => {
+        const body = { content: readContent(content) };
+        if (opts.session)
+            body.sessionId = opts.session;
+        if (opts.priority)
+            body.priority = parseInt(opts.priority, 10);
+        const resp = (await apiPost("/app/proposals", body));
+        const p = unwrapResp(resp);
+        if (isJsonMode(proposal)) {
+            jsonOut(p);
+            return;
+        }
+        console.log(`Created ${p.proposalId} (priority ${p.priority}).`);
+    });
+    // ── Edit content ──
+    proposal
+        .command("edit <proposalId> <content>")
+        .description("Replace proposal content (bumps revision). Pass '-' for stdin.")
+        .action(async (proposalId, content) => {
+        const resp = (await apiPatch(`/app/proposals/${proposalId}`, {
+            content: readContent(content),
+        }));
+        const p = unwrapResp(resp);
+        if (isJsonMode(proposal)) {
+            jsonOut(p);
+            return;
+        }
+        console.log(`Updated ${p.proposalId} → rev${p.revision}.`);
+    });
+    // ── Delete ──
+    proposal
+        .command("delete <proposalId>")
+        .description("Delete a proposal.")
+        .action(async (proposalId) => {
+        await apiDelete(`/app/proposals/${proposalId}`);
+        if (isJsonMode(proposal)) {
+            jsonOut({ deleted: proposalId });
+            return;
+        }
+        console.log(`Deleted ${proposalId}.`);
+    });
+    // ── Prioritize ──
+    proposal
+        .command("prioritize <proposalId> <priority>")
+        .description("Set priority (lower = higher). Top 5 feed the system prompt.")
+        .action(async (proposalId, priority) => {
+        const resp = (await apiPatch(`/app/proposals/${proposalId}/priority`, {
+            priority: parseInt(priority, 10),
+        }));
+        const p = unwrapResp(resp);
+        if (isJsonMode(proposal)) {
+            jsonOut(p);
+            return;
+        }
+        console.log(`Set ${p.proposalId} priority to ${p.priority}.`);
+    });
+    // ── Accept ──
+    proposal
+        .command("accept <proposalId>")
+        .description('Accept — posts "Accept your proposal X" into the originating chat session.')
+        .action(async (proposalId) => {
+        const resp = (await apiPost(`/app/proposals/${proposalId}/accept`));
+        const p = unwrapResp(resp);
+        if (isJsonMode(proposal)) {
+            jsonOut(p);
+            return;
+        }
+        console.log(`Accepted ${p.proposalId}.`);
+    });
+    // ── Reject ──
+    proposal
+        .command("reject <proposalId>")
+        .description('Reject — posts "Reject your proposal X" into the originating chat session.')
+        .action(async (proposalId) => {
+        const resp = (await apiPost(`/app/proposals/${proposalId}/reject`));
+        const p = unwrapResp(resp);
+        if (isJsonMode(proposal)) {
+            jsonOut(p);
+            return;
+        }
+        console.log(`Rejected ${p.proposalId}.`);
+    });
+    // ── Revise ──
+    proposal
+        .command("revise <proposalId> <comment>")
+        .description('Ask the agent to revise — posts "Update your proposal X. Here\'s my comment. {comment}" into the chat session.')
+        .action(async (proposalId, comment) => {
+        const resp = (await apiPost(`/app/proposals/${proposalId}/revise`, {
+            comment: readContent(comment),
+        }));
+        const p = unwrapResp(resp);
+        if (isJsonMode(proposal)) {
+            jsonOut(p);
+            return;
+        }
+        console.log(`Revision requested on ${p.proposalId}.`);
+    });
+}

package/dist/main.js

@@ -13,6 +13,7 @@ import { registerSenseCommand } from "./commands/sense.js";
 import { registerSyncCommand } from "./commands/sync.js";
 import { registerUpdateCommand } from "./commands/update.js";
 import { registerMediaCommand } from "./commands/media.js";
+import { registerProposalCommand } from "./commands/proposal.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../package.json");
 const SKIP_BANNER_COMMANDS = new Set(["auth", "init", "update"]);
@@ -42,6 +43,7 @@ export async function cli() {
     registerSyncCommand(program);
     registerUpdateCommand(program);
     registerMediaCommand(program);
+    registerProposalCommand(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": "1.3.2",
+  "version": "1.3.4",
   "description": "CLI client for the Gobi collaborative knowledge platform",
   "license": "MIT",
   "type": "module",

package/skills/gobi-proposal/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: gobi-proposal
+description: >-
+  Gobi proposal commands for managing agent-authored proposals: list, get, add,
+  edit, delete, prioritize, accept, reject, or revise. The top-priority pending
+  proposals feed into the agent's system prompt every turn. Use when the user
+  wants to review, organize, or respond to proposals — or when an agent (using
+  gobi-cli as its tool layer) wants to record a proposal it just composed.
+allowed-tools: Bash(gobi:*)
+metadata:
+  author: gobi-ai
+  version: "1.3.4"
+---
+
+# gobi-proposal
+
+Gobi proposal commands for managing agent-authored proposals (v1.3.4).
+
+Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
+
+## What is a proposal?
+
+A proposal is a unit of standing guidance authored by an agent (in-process during chat, or via `gobi proposal add` when the agent uses gobi-cli as its tool layer). Each proposal has:
+
+- **content** — the proposal text (markdown, up to 8000 chars)
+- **priority** — lower number = higher priority; default `100`
+- **status** — `pending`, `accepted`, or `rejected`
+- **revision** — bumped each time the content is edited
+- **sessionId** — optional; the chat session the proposal originated from
+- **history** — append-only log of `created`, `edited`, `prioritized`, `accepted`, `rejected`, and `revise_requested` events
+
+The top 5 pending proposals (lowest priority first) are injected into the agent's system prompt every turn — that's how proposals turn into standing instructions.
+
+## Lifecycle
+
+`accept` and `reject` are terminal: they post a synthesized user message into the originating chat session ("Accept your proposal X" / "Reject your proposal X") so the agent can react. `revise` keeps the proposal pending and posts the user's comment into the session, asking the agent to revise. Only pending proposals can be revised.
+
+## Important: JSON Mode
+
+For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
+
+```bash
+gobi --json proposal list --limit 20
+gobi --json proposal add "Prefer concise titles" --priority 50
+```
+
+JSON mode wraps the response as `{"success": true, "data": <proposal>}` (or `{"success": false, "error": "..."}`).
+
+## Available Commands
+
+- `gobi proposal` — Proposals authored by your agent during chat. Top-5 feed the system prompt; accept/reject/revise post into the originating chat session.
+  - `gobi proposal list` — List proposals (priority ASC, then newest first).
+  - `gobi proposal get` — Show one proposal with its history.
+  - `gobi proposal edit` — Replace proposal content (bumps revision). Pass '-' for stdin.
+  - `gobi proposal delete` — Delete a proposal.
+  - `gobi proposal prioritize` — Set priority (lower = higher). Top 5 feed the system prompt.
+  - `gobi proposal accept` — Accept — posts "Accept your proposal X" into the originating chat session.
+  - `gobi proposal reject` — Reject — posts "Reject your proposal X" into the originating chat session.
+  - `gobi proposal revise` — Ask the agent to revise — posts "Update your proposal X. Here's my comment. {comment}" into the chat session.
+
+## Reference Documentation
+
+- [gobi proposal](references/proposal.md)

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

@@ -0,0 +1,124 @@
+# gobi proposal
+
+```
+Usage: gobi proposal [options] [command]
+
+Proposals authored by your agent during chat. Top-5 feed the system prompt; accept/reject/revise post into the originating chat session.
+
+Options:
+  -h, --help                          display help for command
+
+Commands:
+  list [options]                      List proposals (priority ASC, then newest first).
+  get <proposalId>                    Show one proposal with its history.
+  add [options] <content>             Add a proposal directly. Pass '-' to read from stdin.
+  edit <proposalId> <content>         Replace proposal content (bumps revision). Pass '-' for stdin.
+  delete <proposalId>                 Delete a proposal.
+  prioritize <proposalId> <priority>  Set priority (lower = higher). Top 5 feed the system prompt.
+  accept <proposalId>                 Accept — posts "Accept your proposal X" into the originating chat session.
+  reject <proposalId>                 Reject — posts "Reject your proposal X" into the originating chat session.
+  revise <proposalId> <comment>       Ask the agent to revise — posts "Update your proposal X. Here's my comment. {comment}" into the chat session.
+  help [command]                      display help for command
+```
+
+## list
+
+```
+Usage: gobi proposal list [options]
+
+List proposals (priority ASC, then newest first).
+
+Options:
+  --limit <number>  Max proposals to return (1-200) (default: "50")
+  -h, --help        display help for command
+```
+
+## get
+
+```
+Usage: gobi proposal get [options] <proposalId>
+
+Show one proposal with its history.
+
+Options:
+  -h, --help  display help for command
+```
+
+## add
+
+```
+Usage: gobi proposal add [options] <content>
+
+Add a proposal directly. Pass '-' to read from stdin.
+
+Options:
+  --session <sessionId>  Originate from a chat session (UUID)
+  --priority <number>    Priority (lower = higher), default 100
+  -h, --help             display help for command
+```
+
+## edit
+
+```
+Usage: gobi proposal edit [options] <proposalId> <content>
+
+Replace proposal content (bumps revision). Pass '-' for stdin.
+
+Options:
+  -h, --help  display help for command
+```
+
+## delete
+
+```
+Usage: gobi proposal delete [options] <proposalId>
+
+Delete a proposal.
+
+Options:
+  -h, --help  display help for command
+```
+
+## prioritize
+
+```
+Usage: gobi proposal prioritize [options] <proposalId> <priority>
+
+Set priority (lower = higher). Top 5 feed the system prompt.
+
+Options:
+  -h, --help  display help for command
+```
+
+## accept
+
+```
+Usage: gobi proposal accept [options] <proposalId>
+
+Accept — posts "Accept your proposal X" into the originating chat session.
+
+Options:
+  -h, --help  display help for command
+```
+
+## reject
+
+```
+Usage: gobi proposal reject [options] <proposalId>
+
+Reject — posts "Reject your proposal X" into the originating chat session.
+
+Options:
+  -h, --help  display help for command
+```
+
+## revise
+
+```
+Usage: gobi proposal revise [options] <proposalId> <comment>
+
+Ask the agent to revise — posts "Update your proposal X. Here's my comment. {comment}" into the chat session.
+
+Options:
+  -h, --help  display help for command
+```