@gobi-ai/cli 1.3.3 → 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.3",
+  "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.3",
+      "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.3",
+  "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

@@ -72,6 +72,26 @@ export function registerProposalCommand(program) {
             }
         }
     });
+    // ── 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>")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobi-ai/cli",
-  "version": "1.3.3",
+  "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
+```