opencode-froggy 0.4.0 → 0.5.0

package/README.md

@@ -18,9 +18,9 @@ Plugin providing Claude Code–style hooks, specialized agents (doc-writer, code
 - [Agents](#agents)
 - [Tools](#tools)
   - [gitingest](#gitingest)
-  - [diff-summary](#diff-summary)
   - [prompt-session](#prompt-session)
   - [list-child-sessions](#list-child-sessions)
+  - [agent-promote](#agent-promote)
   - [Blockchain](#blockchain)
     - [Configuration](#configuration)
     - [eth-transaction](#eth-transaction)
@@ -66,7 +66,9 @@ Alternatively, clone or copy the plugin files to one of these directories:
 
 | Command | Description | Agent |
 |---------|-------------|-------|
+| `/agent-promote <name> <grade>` | Change the type of a plugin agent at runtime. Grades: `subagent`, `primary`, `all` | - |
 | `/commit-push` | Stage, commit, and push changes with user confirmation | `build` |
+| `/diff-summary [source] [target]` | Show working tree changes or diff between branches | - |
 | `/doc-changes` | Update documentation based on uncommitted changes (new features only) | `doc-writer` |
 | `/review-changes` | Review uncommitted changes (staged + unstaged, including untracked files) | `code-reviewer` |
 | `/review-pr <source> <target>` | Review changes from source branch into target branch | `code-reviewer` |
@@ -74,6 +76,28 @@ Alternatively, clone or copy the plugin files to one of these directories:
 | `/simplify-changes` | Simplify uncommitted changes (staged + unstaged, including untracked files) | `code-simplifier` |
 | `/tests-coverage` | Run the full test suite with coverage report and suggest fixes for failures | `build` |
 
+### /diff-summary
+
+The `/diff-summary` command supports two modes:
+
+**Working tree mode** (no parameters):
+```bash
+/diff-summary
+```
+Shows staged changes, unstaged changes, and untracked file contents.
+
+**Branch comparison mode** (with parameters):
+```bash
+# Compare a branch with the current branch (HEAD)
+/diff-summary feature-branch
+
+# Compare two specific branches
+/diff-summary feature-branch main
+```
+Shows stats overview, commits, files changed, and full diff between branches.
+
+> **Note:** The `/review-pr` command uses `/diff-summary` internally to generate the diff for code review.
+
 ---
 
 ## Agents
@@ -139,50 +163,6 @@ gitingest({
 
 ---
 
-### diff-summary
-
-**Command** that displays a structured summary of git working tree changes (staged, unstaged, and untracked files). Injects git diff output directly into the prompt using bash commands.
-
-#### Usage
-
-```bash
-/diff-summary
-```
-
-#### What it shows
-
-- Git status (porcelain format)
-- Staged changes (stats and full diff)
-- Unstaged changes (stats and full diff)
-- Untracked files content (first 50 lines of each file)
-
-#### Implementation
-
-This command uses OpenCode's `!`\`...\`` syntax to inject bash command output directly into the prompt, avoiding the 2000-line truncation limit that affects tools.
-
-See `command/diff-summary.md` for the full implementation.
-
-#### Output Structure
-
-**For branch comparisons:**
-- Stats Overview: Summary of changes (insertions, deletions)
-- Commits to Review: List of commits in the range
-- Files Changed: List of modified files
-- Full Diff: Complete diff with context
-
-**For working tree changes:**
-- Status Overview: Git status output
-- Staged Changes: Stats, files, and diff for staged changes
-- Unstaged Changes: Stats, files, and diff for unstaged changes
-- Untracked Files: List and diffs for new untracked files
-
-#### Notes
-
-- When comparing branches, the tool fetches from the remote before generating the diff
-- Diffs include 5 lines of context and function context for better readability
-
----
-
 ### prompt-session
 
 Send a message to a child session (subagent) to continue the conversation. Useful for iterating with subagents without creating new sessions.
@@ -250,6 +230,46 @@ Child sessions (2):
 
 ---
 
+### agent-promote
+
+Change the type of a plugin agent at runtime. Promotes subagents to primary agents (visible in Tab selection) or demotes them back.
+
+#### Parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `name` | `string` | Yes | Name of the plugin agent (e.g., `rubber-duck`, `architect`) |
+| `grade` | `string` | Yes | Target type: `subagent`, `primary`, or `all` |
+
+#### Grade Types
+
+| Grade | Effect |
+|-------|--------|
+| `subagent` | Available only as a subagent (default for most agents) |
+| `primary` | Appears in Tab selection for direct use |
+| `all` | Available both as primary and subagent |
+
+#### Usage Examples
+
+```bash
+# Promote rubber-duck to use it directly via Tab
+/agent-promote rubber-duck primary
+
+# Make architect available everywhere
+/agent-promote architect all
+
+# Revert code-reviewer to subagent only
+/agent-promote code-reviewer subagent
+```
+
+#### Notes
+
+- Only agents from this plugin can be promoted (see [Agents](#agents) table)
+- Changes persist in memory until OpenCode restarts
+- After promotion, use `Tab` or `<leader>a` to select the agent
+
+---
+
 ### Blockchain
 
 Tools for querying Ethereum and EVM-compatible blockchains via Etherscan APIs.

package/command/agent-promote.md

@@ -0,0 +1,5 @@
+---
+description: Change the type of an agent to primary, subagent or all
+---
+
+Use the agent-promote tool to change agent $1 to grade $2.

package/command/commit-push.md

@@ -13,8 +13,13 @@ agent: build
 2. Present a summary to the user:
    - Files modified/added/deleted with stats
    - Proposed commit message based on the changes
-3. Ask the user for confirmation before proceeding
-4. Only if the user confirms:
+3. **If the current branch is `master`, `main`, `develop`, or `dev`:**
+   - Warn the user that committing directly to this branch is discouraged
+   - Propose to create a new feature branch with a suggested name based on the changes
+   - Ask the user if they want to: (a) create the suggested branch, (b) provide a custom branch name, or (c) continue on the current branch anyway
+   - If the user chooses to create a branch, create it and switch to it before proceeding
+4. Ask the user for confirmation before proceeding
+5. Only if the user confirms:
    - Stage all changes (`git add -A`)
    - Create the commit with the agreed message
    - Push to origin on the current branch

package/command/diff-summary.md

@@ -1,19 +1,51 @@
 ---
-description: Show working tree changes (staged, unstaged, untracked)
+description: Show working tree changes or diff between branches ($1=source, $2=target)
 ---
 
-# Diff Summary: Working Tree → HEAD
+# Diff Summary
 
-## Status
-!`git status --porcelain`
+!`bash -c '
+SOURCE="$1"
+TARGET="$2"
+TARGET="${TARGET:-HEAD}"
 
-## Staged Changes
-!`git diff --cached --stat`
-!`git diff --cached`
+if [ -n "$SOURCE" ]; then
+  echo "## Branch Comparison: $SOURCE → $TARGET"
+  echo ""
+  git fetch --all --prune 2>/dev/null || true
+  
+  echo "### Stats Overview"
+  git diff --stat "$TARGET"..."$SOURCE"
+  
+  echo ""
+  echo "### Commits"
+  git log --oneline --no-merges "$TARGET".."$SOURCE"
+  
+  echo ""
+  echo "### Files Changed"
+  git diff --name-only "$TARGET"..."$SOURCE"
+  
+  echo ""
+  echo "### Full Diff"
+  git diff "$TARGET"..."$SOURCE"
+else
+  echo "## Status"
+  git status --porcelain
 
-## Unstaged Changes
-!`git diff --stat`
-!`git diff`
+  echo ""
+  echo "## Staged Changes"
+  git diff --cached --stat
+  git diff --cached
 
-## Untracked Files Content
-!`bash -c 'git ls-files --others --exclude-standard | while read f; do [ -f "$f" ] && echo "=== $f ===" && sed -n "1,50p" "$f" && sed -n "51p" "$f" | grep -q . && echo "... (truncated)"; done'`
+  echo ""
+  echo "## Unstaged Changes"
+  git diff --stat
+  git diff
+
+  echo ""
+  echo "## Untracked Files Content"
+  git ls-files --others --exclude-standard | while read f; do
+    [ -f "$f" ] && echo "=== $f ===" && sed -n "1,50p" "$f" && sed -n "51p" "$f" | grep -q . && echo "... (truncated)"
+  done
+fi
+'`

package/command/gh-create-pr.md

@@ -0,0 +1,18 @@
+---
+description: Commit, push and create a GitHub PR
+agent: build
+---
+
+## Context
+
+- Current branch: !`git branch --show-current`
+- Default branch: !`gh repo view --json defaultBranchRef --jq '.defaultBranchRef.name'`
+
+## Your task
+
+1. Execute `/commit-push` to commit and push all changes
+2. Once the push is complete, create a PR using `gh pr create`:
+   - Use the commit message as PR title
+   - Generate a brief PR description summarizing the changes
+   - Target the repository's default branch
+3. Display the PR URL to the user

package/command/review-pr.md

@@ -5,19 +5,6 @@ agent: code-reviewer
 
 # Review: $1 → $2
 
-## Fetch latest
-!`git fetch --all --prune 2>/dev/null || true`
-
-## Stats Overview
-!`git diff --stat $2...$1`
-
-## Commits to Review
-!`git log --oneline --no-merges $2..$1`
-
-## Files Changed
-!`git diff --name-only $2...$1`
-
-## Full Diff
-!`git diff -U5 --function-context $2...$1`
+/diff-summary $1 $2
 
 Review the above changes for quality, correctness, and adherence to project guidelines.

package/dist/index.js

@@ -5,7 +5,7 @@ import { getGlobalHookDir, getProjectHookDir } from "./config-paths";
 import { hasCodeExtension } from "./code-files";
 import { log } from "./logger";
 import { executeBashAction, DEFAULT_BASH_TIMEOUT, } from "./bash-executor";
-import { gitingestTool, createPromptSessionTool, createListChildSessionsTool, ethTransactionTool, ethAddressTxsTool, ethAddressBalanceTool, ethTokenTransfersTool, } from "./tools";
+import { gitingestTool, createPromptSessionTool, createListChildSessionsTool, createAgentPromoteTool, getPromotedAgents, ethTransactionTool, ethAddressTxsTool, ethAddressBalanceTool, ethTokenTransfersTool, } from "./tools";
 export { parseFrontmatter, loadAgents, loadCommands } from "./loaders";
 // ============================================================================
 // CONSTANTS
@@ -32,6 +32,7 @@ const SmartfrogPlugin = async (ctx) => {
         hooks: Array.from(hooks.keys()),
         tools: [
             "gitingest",
+            "agent-promote",
             "eth-transaction",
             "eth-address-txs",
             "eth-address-balance",
@@ -173,8 +174,14 @@ const SmartfrogPlugin = async (ctx) => {
     }
     return {
         config: async (config) => {
-            if (Object.keys(agents).length > 0) {
-                config.agent = { ...(config.agent ?? {}), ...agents };
+            const loadedAgents = loadAgents(AGENT_DIR);
+            for (const [name, mode] of getPromotedAgents()) {
+                if (loadedAgents[name]) {
+                    loadedAgents[name].mode = mode;
+                }
+            }
+            if (Object.keys(loadedAgents).length > 0) {
+                config.agent = { ...(config.agent ?? {}), ...loadedAgents };
             }
             if (Object.keys(commands).length > 0) {
                 config.command = { ...(config.command ?? {}), ...commands };
@@ -184,6 +191,7 @@ const SmartfrogPlugin = async (ctx) => {
             gitingest: gitingestTool,
             "prompt-session": createPromptSessionTool(ctx.client),
             "list-child-sessions": createListChildSessionsTool(ctx.client),
+            "agent-promote": createAgentPromoteTool(ctx.client, Object.keys(agents)),
             "eth-transaction": ethTransactionTool,
             "eth-address-txs": ethAddressTxsTool,
             "eth-address-balance": ethAddressBalanceTool,

package/dist/tools/agent-promote-core.d.ts

@@ -0,0 +1,6 @@
+export type AgentMode = "subagent" | "primary" | "all";
+export declare const VALID_GRADES: AgentMode[];
+export declare function getPromotedAgents(): ReadonlyMap<string, AgentMode>;
+export declare function setPromotedAgent(name: string, mode: AgentMode): void;
+export declare function validateGrade(grade: string): grade is AgentMode;
+export declare function validateAgentName(name: string, pluginAgentNames: string[]): boolean;

package/dist/tools/agent-promote-core.js

@@ -0,0 +1,14 @@
+export const VALID_GRADES = ["subagent", "primary", "all"];
+const promotedAgents = new Map();
+export function getPromotedAgents() {
+    return promotedAgents;
+}
+export function setPromotedAgent(name, mode) {
+    promotedAgents.set(name, mode);
+}
+export function validateGrade(grade) {
+    return VALID_GRADES.includes(grade);
+}
+export function validateAgentName(name, pluginAgentNames) {
+    return pluginAgentNames.includes(name);
+}

package/dist/tools/agent-promote.d.ts

@@ -0,0 +1,19 @@
+import { type ToolContext } from "@opencode-ai/plugin";
+import type { createOpencodeClient } from "@opencode-ai/sdk";
+export { type AgentMode, VALID_GRADES, getPromotedAgents, setPromotedAgent, validateGrade, validateAgentName, } from "./agent-promote-core";
+type Client = ReturnType<typeof createOpencodeClient>;
+export interface AgentPromoteArgs {
+    name: string;
+    grade: string;
+}
+export declare function createAgentPromoteTool(client: Client, pluginAgentNames: string[]): {
+    description: string;
+    args: {
+        name: import("zod").ZodString;
+        grade: import("zod").ZodString;
+    };
+    execute(args: {
+        name: string;
+        grade: string;
+    }, context: ToolContext): Promise<string>;
+};

package/dist/tools/agent-promote.js

@@ -0,0 +1,39 @@
+import { tool } from "@opencode-ai/plugin";
+import { log } from "../logger";
+import { VALID_GRADES, setPromotedAgent, validateGrade, validateAgentName, } from "./agent-promote-core";
+export { VALID_GRADES, getPromotedAgents, setPromotedAgent, validateGrade, validateAgentName, } from "./agent-promote-core";
+export function createAgentPromoteTool(client, pluginAgentNames) {
+    return tool({
+        description: "Change the type of an agent to primary, subagent or all",
+        args: {
+            name: tool.schema.string().describe("Name of the agent"),
+            grade: tool.schema.string().describe("Target type: 'subagent', 'primary', or 'all'"),
+        },
+        async execute(args, _context) {
+            const { name, grade } = args;
+            if (!validateGrade(grade)) {
+                return `Invalid grade "${grade}". Valid grades: ${VALID_GRADES.join(", ")}`;
+            }
+            if (!validateAgentName(name, pluginAgentNames)) {
+                return `Agent "${name}" not found in this plugin. Available: ${pluginAgentNames.join(", ")}`;
+            }
+            const agentsResp = await client.app.agents();
+            const agents = agentsResp.data ?? [];
+            const existingAgent = agents.find((a) => a.name === name);
+            if (existingAgent && existingAgent.mode === grade) {
+                return `Agent "${name}" is already of type "${grade}"`;
+            }
+            setPromotedAgent(name, grade);
+            log("[agent-promote] Agent type changed", { name, grade });
+            await client.tui.showToast({
+                body: {
+                    message: `Promoting agent "${name}" to "${grade}"...`,
+                    variant: "success",
+                    duration: 3000,
+                },
+            });
+            await client.instance.dispose();
+            return `Agent "${name}" changed to type "${grade}". Use Tab or <leader>a to select it.`;
+        },
+    });
+}

package/dist/tools/agent-promote.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/agent-promote.test.js

@@ -0,0 +1,71 @@
+import { describe, it, expect } from "vitest";
+import { validateGrade, validateAgentName, getPromotedAgents, setPromotedAgent, VALID_GRADES, } from "./agent-promote-core";
+describe("agent-promote", () => {
+    const pluginAgentNames = ["rubber-duck", "architect", "code-reviewer"];
+    describe("VALID_GRADES", () => {
+        it("should contain subagent, primary, and all", () => {
+            expect(VALID_GRADES).toContain("subagent");
+            expect(VALID_GRADES).toContain("primary");
+            expect(VALID_GRADES).toContain("all");
+            expect(VALID_GRADES).toHaveLength(3);
+        });
+    });
+    describe("validateGrade", () => {
+        it("should return true for valid grade: subagent", () => {
+            expect(validateGrade("subagent")).toBe(true);
+        });
+        it("should return true for valid grade: primary", () => {
+            expect(validateGrade("primary")).toBe(true);
+        });
+        it("should return true for valid grade: all", () => {
+            expect(validateGrade("all")).toBe(true);
+        });
+        it("should return false for invalid grade", () => {
+            expect(validateGrade("invalid")).toBe(false);
+            expect(validateGrade("foo")).toBe(false);
+            expect(validateGrade("")).toBe(false);
+        });
+    });
+    describe("validateAgentName", () => {
+        it("should return true for agent in plugin", () => {
+            expect(validateAgentName("rubber-duck", pluginAgentNames)).toBe(true);
+            expect(validateAgentName("architect", pluginAgentNames)).toBe(true);
+            expect(validateAgentName("code-reviewer", pluginAgentNames)).toBe(true);
+        });
+        it("should return false for agent not in plugin", () => {
+            expect(validateAgentName("unknown", pluginAgentNames)).toBe(false);
+            expect(validateAgentName("build", pluginAgentNames)).toBe(false);
+            expect(validateAgentName("", pluginAgentNames)).toBe(false);
+        });
+    });
+    describe("promotedAgents Map", () => {
+        it("should set and get promoted agent", () => {
+            setPromotedAgent("test-agent-1", "primary");
+            const promoted = getPromotedAgents();
+            expect(promoted.get("test-agent-1")).toBe("primary");
+        });
+        it("should update existing promotion", () => {
+            setPromotedAgent("test-agent-2", "primary");
+            expect(getPromotedAgents().get("test-agent-2")).toBe("primary");
+            setPromotedAgent("test-agent-2", "all");
+            expect(getPromotedAgents().get("test-agent-2")).toBe("all");
+            setPromotedAgent("test-agent-2", "subagent");
+            expect(getPromotedAgents().get("test-agent-2")).toBe("subagent");
+        });
+        it("should handle multiple agents", () => {
+            setPromotedAgent("agent-a", "primary");
+            setPromotedAgent("agent-b", "all");
+            setPromotedAgent("agent-c", "subagent");
+            const promoted = getPromotedAgents();
+            expect(promoted.get("agent-a")).toBe("primary");
+            expect(promoted.get("agent-b")).toBe("all");
+            expect(promoted.get("agent-c")).toBe("subagent");
+        });
+        it("should return readonly map", () => {
+            const promoted = getPromotedAgents();
+            expect(typeof promoted.get).toBe("function");
+            expect(typeof promoted.has).toBe("function");
+            expect(typeof promoted.forEach).toBe("function");
+        });
+    });
+});

package/dist/tools/index.d.ts

@@ -1,4 +1,5 @@
 export { gitingestTool, fetchGitingest, type GitingestArgs } from "./gitingest";
 export { createPromptSessionTool, type PromptSessionArgs } from "./prompt-session";
 export { createListChildSessionsTool } from "./list-child-sessions";
+export { createAgentPromoteTool, getPromotedAgents, type AgentPromoteArgs } from "./agent-promote";
 export { ethTransactionTool, ethAddressTxsTool, ethAddressBalanceTool, ethTokenTransfersTool, EtherscanClient, EtherscanClientError, weiToEth, formatTimestamp, shortenAddress, type EthTransactionArgs, type EthAddressTxsArgs, type EthAddressBalanceArgs, type EthTokenTransfersArgs, } from "./blockchain";

package/dist/tools/index.js

@@ -1,4 +1,5 @@
 export { gitingestTool, fetchGitingest } from "./gitingest";
 export { createPromptSessionTool } from "./prompt-session";
 export { createListChildSessionsTool } from "./list-child-sessions";
+export { createAgentPromoteTool, getPromotedAgents } from "./agent-promote";
 export { ethTransactionTool, ethAddressTxsTool, ethAddressBalanceTool, ethTokenTransfersTool, EtherscanClient, EtherscanClientError, weiToEth, formatTimestamp, shortenAddress, } from "./blockchain";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-froggy",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "OpenCode plugin with a hook layer (tool.before.*, session.idle...), agents (code-reviewer, doc-writer), and commands (/review-pr, /commit)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",