@blackbox_ai/blackbox-cli 0.0.9 → 0.8.1

package/dist/src/on-demand-extensions/README.md

@@ -0,0 +1,266 @@
+# On-Demand Extensions
+
+This directory contains extensions that are shipped with the Blackbox CLI but are **not automatically installed**. Users can browse and install them on demand.
+
+## Difference from Built-in Extensions
+
+| Feature | Built-in Extensions | On-Demand Extensions |
+|---------|-------------------|---------------------|
+| **Location** | `built-in-extensions/` | `on-demand-extensions/` |
+| **Installation** | Automatic (embedded in binary) | Manual (user installs when needed) |
+| **Availability** | Always available | Available after installation |
+| **Use Case** | Core functionality | Optional enhancements |
+| **Examples** | conductor | git-helper, code-review, test-generator |
+
+## How It Works
+
+### 1. Registry System
+
+The `registry.json` file contains metadata about all available on-demand extensions:
+
+```json
+{
+  "extensions": [
+    {
+      "name": "extension-name",
+      "version": "1.0.0",
+      "description": "What this extension does",
+      "category": "productivity|quality|testing|other",
+      "author": "Author Name",
+      "path": "./extension-name"
+    }
+  ]
+}
+```
+
+### 2. User Discovery
+
+Users can browse available extensions using:
+
+```bash
+# In the CLI
+/browse-extensions
+
+# Or from terminal
+blackbox extensions list --available  # (if implemented)
+```
+
+### 3. Installation
+
+Users can install extensions in two ways:
+
+**Method 1: Using the registry**
+```bash
+blackbox extensions install --from-registry extension-name
+```
+
+**Method 2: Direct path (for development)**
+```bash
+blackbox extensions install /path/to/extension
+```
+
+### 4. Extension Storage
+
+Once installed, extensions are copied to:
+- `~/.blackboxcli/extensions/<extension-name>/`
+
+## Creating a New On-Demand Extension
+
+### Step 1: Create Extension Directory
+
+```bash
+mkdir -p packages/cli/src/on-demand-extensions/my-extension/commands
+```
+
+### Step 2: Create `blackbox-extension.json`
+
+```json
+{
+  "name": "my-extension",
+  "version": "1.0.0",
+  "contextFileName": "README.md"
+}
+```
+
+### Step 3: Create README.md
+
+```markdown
+# My Extension
+
+Description of what your extension does.
+
+## Commands
+
+- `/my:command` - Description
+
+## Installation
+
+\`\`\`bash
+blackbox extensions install --from-registry my-extension
+\`\`\`
+```
+
+### Step 4: Create Commands
+
+Create TOML files in `commands/` directory:
+
+```toml
+# commands/my/command.toml
+description = "What this command does"
+prompt = """
+Your prompt here
+"""
+```
+
+### Step 5: Register in registry.json
+
+Add your extension to `registry.json`:
+
+```json
+{
+  "extensions": [
+    {
+      "name": "my-extension",
+      "version": "1.0.0",
+      "description": "Brief description",
+      "category": "productivity",
+      "author": "Your Name",
+      "path": "./my-extension"
+    }
+  ]
+}
+```
+
+## Available Extensions
+
+### 1. git-helper (Productivity)
+
+Git workflow automation commands for common operations.
+
+**Commands:**
+- `/git:smart-commit` - Analyzes staged changes and generates conventional commit messages
+- `/git:branch-cleanup` - Helps clean up merged branches
+
+**Install:**
+```bash
+blackbox extensions install --from-registry git-helper
+```
+
+### 2. code-review (Quality)
+
+Automated code review assistant with best practices checking.
+
+**Commands:**
+- `/review:security` - Performs security-focused code review
+- `/review:performance` - Analyzes code for performance issues
+- `/review:best-practices` - Checks adherence to coding best practices
+
+**Install:**
+```bash
+blackbox extensions install --from-registry code-review
+```
+
+### 3. test-generator (Testing)
+
+Automatically generate unit tests for your code.
+
+**Commands:**
+- `/test:unit` - Generates unit tests for the current file or function
+- `/test:integration` - Generates integration test templates
+- `/test:coverage` - Analyzes test coverage and suggests missing tests
+
+**Install:**
+```bash
+blackbox extensions install --from-registry test-generator
+```
+
+## Best Practices
+
+### When to Create an On-Demand Extension
+
+Create an on-demand extension when:
+- ✅ The functionality is useful but not essential for all users
+- ✅ It targets a specific use case or workflow
+- ✅ It adds significant value for certain user segments
+- ✅ You want to keep the core CLI lean
+
+### When to Create a Built-in Extension
+
+Create a built-in extension when:
+- ✅ The functionality is core to the CLI experience
+- ✅ Most users will benefit from it
+- ✅ It's part of the default workflow
+- ✅ Example: conductor (Context-Driven Development)
+
+### Extension Design Guidelines
+
+1. **Clear Purpose**: Each extension should have a focused purpose
+2. **Good Documentation**: Include comprehensive README with examples
+3. **Useful Commands**: Provide commands that solve real problems
+4. **Proper Categorization**: Use appropriate category in registry
+5. **Version Management**: Follow semantic versioning
+
+## Testing Your Extension
+
+### Local Testing
+
+1. Create your extension in `on-demand-extensions/`
+2. Add it to `registry.json`
+3. Build the CLI: `npm run build`
+4. Install from registry:
+   ```bash
+   blackbox extensions install --from-registry your-extension
+   ```
+5. Restart CLI and test commands
+
+### Development Workflow
+
+For rapid iteration during development:
+
+```bash
+# Link extension for development
+blackbox extensions link /path/to/your-extension
+
+# Make changes to your extension files
+
+# Restart CLI to see changes
+```
+
+## Maintenance
+
+### Updating Extensions
+
+When updating an extension:
+1. Update the extension files
+2. Increment version in `blackbox-extension.json`
+3. Update version in `registry.json`
+4. Document changes in extension's README
+5. Test installation and functionality
+
+### Deprecating Extensions
+
+To deprecate an extension:
+1. Mark as deprecated in `registry.json` (add `"deprecated": true`)
+2. Update README with deprecation notice
+3. Provide migration path if applicable
+4. Remove from registry after grace period
+
+## Contributing
+
+To contribute a new on-demand extension:
+
+1. Follow the creation steps above
+2. Ensure high quality and usefulness
+3. Test thoroughly
+4. Submit PR with:
+   - Extension files
+   - Registry entry
+   - Documentation
+   - Example usage
+
+## Support
+
+For issues or questions about on-demand extensions:
+- File an issue in the main repository
+- Tag with `extension` label
+- Provide extension name and version

package/dist/src/on-demand-extensions/git-helper/README.md

@@ -0,0 +1,16 @@
+# Git Helper Extension
+
+Provides helpful Git workflow automation commands for common operations.
+
+## Commands
+
+- `/git:smart-commit` - Analyzes staged changes and generates a conventional commit message
+- `/git:branch-cleanup` - Helps clean up merged branches
+
+## Installation
+
+```bash
+blackbox extensions install --from-registry git-helper
+```
+
+Or use `/browse-extensions` in the CLI and select this extension.

package/dist/src/on-demand-extensions/git-helper/blackbox-extension.json

@@ -0,0 +1,5 @@
+{
+  "name": "git-helper",
+  "version": "1.0.0",
+  "contextFileName": "README.md"
+}

package/dist/src/on-demand-extensions/git-helper/commands/git/branch-cleanup.toml

@@ -0,0 +1,18 @@
+description = "Helps clean up merged branches"
+prompt = """
+Please help me clean up merged Git branches.
+
+Current branches:
+!{git branch -a}
+
+Merged branches:
+!{git branch --merged}
+
+Please:
+1. Identify branches that have been merged to main/master
+2. Exclude protected branches (main, master, develop, staging)
+3. Suggest which branches can be safely deleted
+4. Provide the commands to delete them
+
+Do not delete any branches automatically - just provide recommendations.
+"""

package/dist/src/on-demand-extensions/git-helper/commands/git/smart-commit.toml

@@ -0,0 +1,22 @@
+description = "Analyzes staged changes and generates a conventional commit message"
+prompt = """
+Please analyze the staged git changes and generate a conventional commit message.
+
+Staged changes:
+!{git diff --staged}
+
+Generate a commit message following the Conventional Commits specification:
+- Use appropriate type (feat, fix, docs, style, refactor, test, chore)
+- Include a concise description
+- Add a body if changes are complex
+- List breaking changes if any
+
+Format:
+```
+type(scope): description
+
+[optional body]
+
+[optional footer]
+```
+"""

package/dist/src/on-demand-extensions/greet/README.md

@@ -0,0 +1,76 @@
+# Greet Extension
+
+A simple greeting extension that demonstrates how to create on-demand extensions for Blackbox CLI.
+
+## Description
+
+This extension adds a friendly greeting command that says hello to users. It's a minimal example showing the basic structure of an on-demand extension.
+
+## Commands
+
+- `/greet` - Displays a friendly greeting message
+
+## Installation
+
+### Via Browse Extensions Dialog (Recommended)
+
+```bash
+# In the CLI
+/browse-extensions
+# Navigate to "greet" and press Enter or 'i' to install
+```
+
+### Via Command Line
+
+```bash
+blackbox extensions install --from-registry greet
+```
+
+After installation, restart the CLI to use the extension.
+
+## Usage
+
+```bash
+# Start the CLI
+blackbox
+
+# Use the greet command
+/greet
+```
+
+The command will display a friendly greeting message.
+
+## Example Output
+
+```
+👋 Hello! Welcome to Blackbox CLI!
+
+I'm here to help you with your development tasks.
+Have a great day! 🌟
+```
+
+## Extension Details
+
+- **Name**: greet
+- **Version**: 1.0.0
+- **Category**: fun
+- **Author**: Blackbox Team
+
+## Purpose
+
+This extension serves as:
+1. A simple example for developers learning to create extensions
+2. A friendly welcome message for new users
+3. A demonstration of the on-demand extension system
+
+## Contributing
+
+Feel free to enhance this extension by:
+- Adding personalized greetings
+- Including time-based greetings (morning, afternoon, evening)
+- Adding multi-language support
+- Including motivational quotes
+
+## License
+
+Same as Blackbox CLI

package/dist/src/on-demand-extensions/greet/blackbox-extension.json

@@ -0,0 +1,5 @@
+{
+  "name": "greet",
+  "version": "1.0.0",
+  "contextFileName": "README.md"
+}

package/dist/src/on-demand-extensions/greet/commands/greet/hello.toml

@@ -0,0 +1,9 @@
+description = "Display a friendly greeting message"
+prompt = """
+Please display a friendly greeting message to the user. Include:
+- A warm welcome
+- A brief mention that you're here to help with development tasks
+- A positive closing message
+
+Make it friendly and encouraging. Use emojis to make it more welcoming.
+"""

package/dist/src/on-demand-extensions/registry.json

@@ -0,0 +1,251 @@
+{
+  "extensions": [
+    {
+      "name": "git-helper",
+      "version": "1.0.0",
+      "description": "Git workflow automation commands for common git operations",
+      "category": "productivity",
+      "author": "Blackbox Team",
+      "path": "./git-helper"
+    },
+    {
+      "name": "greet",
+      "version": "1.0.0",
+      "description": "A friendly greeting extension that says hello",
+      "category": "fun",
+      "author": "Blackbox Team",
+      "path": "./greet"
+    },
+    {
+      "name": "workspace",
+      "version": "1.0.0",
+      "description": "Access Google Workspace when using CLI",
+      "category": "productivity",
+      "gitUrl": "https://github.com/gemini-cli-extensions/workspace.git"
+    },
+    {
+      "name": "security",
+      "version": "1.0.0",
+      "description": "Google's Security extension for the CLI that finds vulnerabilities in your code changes and pull requests",
+      "category": "quality",
+      "gitUrl": "https://github.com/gemini-cli-extensions/security.git"
+    },
+    {
+      "name": "code-review",
+      "version": "1.0.0",
+      "description": "Google's Code Review extension for the CLI that reviews your code changes",
+      "category": "quality",
+      "gitUrl": "https://github.com/gemini-cli-extensions/code-review.git"
+    },
+    {
+      "name": "alloydb",
+      "version": "1.0.0",
+      "description": "AlloyDB extension for CLI",
+      "category": "database",
+      "gitUrl": "https://github.com/gemini-cli-extensions/alloydb.git"
+    },
+    {
+      "name": "bigquery-data-analytics",
+      "version": "1.0.0",
+      "description": "BigQuery Data Analytics extension for CLI",
+      "category": "analytics",
+      "gitUrl": "https://github.com/gemini-cli-extensions/bigquery-data-analytics.git"
+    },
+    {
+      "name": "cloud-sql-postgresql",
+      "version": "1.0.0",
+      "description": "Cloud SQL PostgreSQL extension for CLI",
+      "category": "database",
+      "gitUrl": "https://github.com/gemini-cli-extensions/cloud-sql-postgresql.git"
+    },
+    {
+      "name": "cloud-sql-mysql",
+      "version": "1.0.0",
+      "description": "Cloud SQL MySQL extension for CLI",
+      "category": "database",
+      "gitUrl": "https://github.com/gemini-cli-extensions/cloud-sql-mysql.git"
+    },
+    {
+      "name": "cloud-sql-sqlserver",
+      "version": "1.0.0",
+      "description": "Cloud SQL SQL Server extension for CLI",
+      "category": "database",
+      "gitUrl": "https://github.com/gemini-cli-extensions/cloud-sql-sqlserver.git"
+    },
+    {
+      "name": "dataplex",
+      "version": "1.0.0",
+      "description": "Dataplex extension for CLI",
+      "category": "data",
+      "gitUrl": "https://github.com/gemini-cli-extensions/dataplex.git"
+    },
+    {
+      "name": "firestore-native",
+      "version": "1.0.0",
+      "description": "Firestore Native extension for CLI",
+      "category": "database",
+      "gitUrl": "https://github.com/gemini-cli-extensions/firestore-native.git"
+    },
+    {
+      "name": "looker",
+      "version": "1.0.0",
+      "description": "Looker extension for CLI",
+      "category": "analytics",
+      "gitUrl": "https://github.com/gemini-cli-extensions/looker.git"
+    },
+    {
+      "name": "spanner",
+      "version": "1.0.0",
+      "description": "Spanner extension for CLI",
+      "category": "database",
+      "gitUrl": "https://github.com/gemini-cli-extensions/spanner.git"
+    },
+    {
+      "name": "mcp-toolbox",
+      "version": "1.0.0",
+      "description": "MCP Toolbox extension for CLI",
+      "category": "tools",
+      "gitUrl": "https://github.com/gemini-cli-extensions/mcp-toolbox.git"
+    },
+    {
+      "name": "postgres",
+      "version": "1.0.0",
+      "description": "PostgreSQL extension for CLI",
+      "category": "database",
+      "gitUrl": "https://github.com/gemini-cli-extensions/postgres.git"
+    },
+    {
+      "name": "mysql",
+      "version": "1.0.0",
+      "description": "MySQL extension for CLI",
+      "category": "database",
+      "gitUrl": "https://github.com/gemini-cli-extensions/mysql.git"
+    },
+    {
+      "name": "sql-server",
+      "version": "1.0.0",
+      "description": "SQL Server extension for CLI",
+      "category": "database",
+      "gitUrl": "https://github.com/gemini-cli-extensions/sql-server.git"
+    },
+    {
+      "name": "cloud-sql-postgresql-observability",
+      "version": "1.0.0",
+      "description": "Cloud SQL PostgreSQL Observability extension for CLI",
+      "category": "observability",
+      "gitUrl": "https://github.com/gemini-cli-extensions/cloud-sql-postgresql-observability.git"
+    },
+    {
+      "name": "cloud-sql-mysql-observability",
+      "version": "1.0.0",
+      "description": "Cloud SQL MySQL Observability extension for CLI",
+      "category": "observability",
+      "gitUrl": "https://github.com/gemini-cli-extensions/cloud-sql-mysql-observability.git"
+    },
+    {
+      "name": "cloud-sql-sqlserver-observability",
+      "version": "1.0.0",
+      "description": "Cloud SQL SQL Server Observability extension for CLI",
+      "category": "observability",
+      "gitUrl": "https://github.com/gemini-cli-extensions/cloud-sql-sqlserver-observability.git"
+    },
+    {
+      "name": "alloydb-observability",
+      "version": "1.0.0",
+      "description": "AlloyDB Observability extension for CLI",
+      "category": "observability",
+      "gitUrl": "https://github.com/gemini-cli-extensions/alloydb-observability.git"
+    },
+    {
+      "name": "flutter",
+      "version": "1.0.0",
+      "description": "Flutter extension for CLI",
+      "category": "development",
+      "gitUrl": "https://github.com/gemini-cli-extensions/flutter.git"
+    },
+    {
+      "name": "gcloud",
+      "version": "1.0.0",
+      "description": "gcloud CLI Extension",
+      "category": "cloud",
+      "gitUrl": "https://github.com/gemini-cli-extensions/gcloud.git"
+    },
+    {
+      "name": "bigquery-conversational-analytics",
+      "version": "1.0.0",
+      "description": "BigQuery Conversational Analytics extension for CLI",
+      "category": "analytics",
+      "gitUrl": "https://github.com/gemini-cli-extensions/bigquery-conversational-analytics.git"
+    },
+    {
+      "name": "observability",
+      "version": "1.0.0",
+      "description": "Cloud Observability CLI Extension",
+      "category": "observability",
+      "gitUrl": "https://github.com/gemini-cli-extensions/observability.git"
+    },
+    {
+      "name": "firebase",
+      "version": "1.0.0",
+      "description": "Firebase extension for CLI",
+      "category": "development",
+      "gitUrl": "https://github.com/gemini-cli-extensions/firebase.git"
+    },
+    {
+      "name": "genkit",
+      "version": "1.0.0",
+      "description": "Genkit extension for CLI",
+      "category": "development",
+      "gitUrl": "https://github.com/gemini-cli-extensions/genkit.git"
+    },
+    {
+      "name": "jules",
+      "version": "1.0.0",
+      "description": "A CLI extension that allows you to use the CLI to orchestrate the Jules asynchronous agent to perform coding tasks like bug fixing, refactoring, and dependency updates",
+      "category": "productivity",
+      "gitUrl": "https://github.com/gemini-cli-extensions/jules.git"
+    },
+    {
+      "name": "datacommons",
+      "version": "1.0.0",
+      "description": "Data Commons extension for CLI",
+      "category": "data",
+      "gitUrl": "https://github.com/gemini-cli-extensions/datacommons.git"
+    },
+    {
+      "name": "looker-conversational-analytics",
+      "version": "1.0.0",
+      "description": "Looker Conversational Analytics extension for CLI",
+      "category": "analytics",
+      "gitUrl": "https://github.com/gemini-cli-extensions/looker-conversational-analytics.git"
+    },
+    {
+      "name": "vertex",
+      "version": "1.0.0",
+      "description": "A CLI extension provides tools to manage prompts in Vertex AI",
+      "category": "cloud",
+      "gitUrl": "https://github.com/gemini-cli-extensions/vertex.git"
+    },
+    {
+      "name": "stitch",
+      "version": "1.0.0",
+      "description": "The Stitch extension for CLI enables you to interact with the Stitch MCP server using natural language commands",
+      "category": "tools",
+      "gitUrl": "https://github.com/gemini-cli-extensions/stitch.git"
+    },
+    {
+      "name": "angular",
+      "version": "1.0.0",
+      "description": "Angular Extension for CLI",
+      "category": "development",
+      "gitUrl": "https://github.com/gemini-cli-extensions/angular.git"
+    },
+    {
+      "name": "conductor",
+      "version": "1.0.0",
+      "description": "Conductor is a CLI extension that allows you to specify, plan, and implement software features",
+      "category": "productivity",
+      "gitUrl": "https://github.com/gemini-cli-extensions/conductor.git"
+    }
+  ]
+}