superkit-mcp-server 1.1.3 → 1.2.0

package/commands/git.toml

@@ -0,0 +1,236 @@
+description = "Git operations with security scan and auto-commit (Git Manager Agent)"
+
+prompt = """
+# 📦 GIT MANAGER AGENT
+
+Git operation:
+
+**Request:** {{args}}
+
+## QUICK COMMANDS
+
+| Command | Action | Time |
+|---------|--------|------|
+| `/git cm` | Commit with auto-message | 10-15s |
+| `/git cp` | Commit + Push | 15-20s |
+| `/git merge` | Merge branches | 10-20s |
+| `/git status` | Review changes | 5s |
+| `/git pr` | Generate PR summary | 30s |
+
+---
+
+## AUTO-COMMIT MESSAGE
+
+### From Diff Analysis
+```bash
+git diff --staged
+```
+
+### Message Format (Conventional Commits)
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer]
+```
+
+### Commit Types
+| Type | Use Case |
+|------|----------|
+| `feat` | New feature |
+| `fix` | Bug fix |
+| `docs` | Documentation only |
+| `refactor` | Code restructuring |
+| `perf` | Performance improvement |
+| `test` | Adding tests |
+| `chore` | Maintenance (deps, config) |
+| `style` | Formatting (no code change) |
+
+---
+
+## SECURITY SCAN (Pre-commit)
+
+### ❌ Patterns Blocked
+```javascript
+// API Keys
+const API_KEY = "sk-1234567890abcdef";
+
+// Database URLs
+const DB_URL = "postgres://user:pass@host/db";
+
+// OAuth Tokens
+const TOKEN = "ghp_xxxxxxxxxxxx";
+
+// AWS Credentials
+const AWS_SECRET = "wJalrXUtnFEMI/K7MDENG/bPxRf";
+```
+
+### ✅ Allowed Patterns
+```javascript
+const API_KEY = process.env.API_KEY;
+const DB_URL = process.env.DATABASE_URL;
+```
+
+### Scan Result
+| Check | Status | Details |
+|-------|--------|---------|
+| API Keys | ✅/❌ | `file.ts:42` |
+| DB Credentials | ✅/❌ | - |
+| OAuth Tokens | ✅/❌ | - |
+| Private Keys | ✅/❌ | - |
+
+**Block commit if secrets detected!**
+
+---
+
+## MULTI-FILE DETECTION
+
+For complex changes across multiple files:
+```
+feat(dashboard): add interactive chart component
+
+- Add Chart.tsx with D3 integration
+- Update Dashboard.tsx to include chart
+- Add chart styles in styles.css
+- Update tests for new component
+```
+
+---
+
+## WORKFLOW
+
+### Standard Commit
+```bash
+git status           # 1. Review changes
+git add .            # 2. Stage files
+/git cm              # 3. Auto-commit
+git log -1           # 4. Verify
+/git cp              # 5. Push (optional)
+```
+
+### Fix Push Failures
+```bash
+git pull --rebase origin main
+# Resolve conflicts if any
+/git cp              # Retry push
+```
+
+---
+
+## PRE-PUSH SAFETY CHECKS (for /git cp)
+
+### 1. Pre-Push Validation
+Before pushing, automatically run:
+```
+Running pre-push checks...
+✓ TypeScript: No errors
+✓ Lint: Passed
+✓ Tests: All passed (if fast)
+✓ Security: No sensitive files
+Safe to push.
+```
+
+### 2. Conflict Detection
+```
+⚠ Warning: Remote has changes
+Remote branch has X new commits.
+Options:
+1. Pull and rebase: git pull --rebase
+2. Pull and merge: git pull
+3. Cancel push
+```
+
+### 3. Force Push Prevention
+```
+❌ Error: Would require force push
+Your branch is behind 'origin/main' by X commits.
+Options:
+1. Pull and rebase: git pull --rebase
+2. Create new branch
+3. Cancel
+```
+
+**Never force push to main/master without explicit approval!**
+
+### Logical Grouping
+```bash
+git add src/auth/*
+/git cm              # Commits only auth
+
+git add src/components/*
+/git cm              # Separate UI changes
+```
+
+### Merge Branches
+```bash
+/git merge feature-branch into main
+
+# Workflow:
+# 1. Checkout target branch
+# 2. Merge source branch
+# 3. Resolve conflicts if any
+# 4. Commit merge
+# 5. Push if requested
+```
+
+---
+
+## PR FORMAT (for /git pr)
+
+### Auto-generated PR Description:
+```markdown
+## Summary
+[Brief description of changes]
+
+## Changes Made
+- ✅ Feature: [description]
+- 🐛 Fix: [description]
+- ♻️ Refactor: [description]
+
+## Files Changed
+- `src/file1.ts` - [description]
+- `src/file2.ts` - [description]
+
+## Test Plan
+- [ ] Unit tests pass
+- [ ] Manual testing on localhost
+- [ ] No TypeScript errors
+- [ ] No lint warnings
+
+## Screenshots (if UI changes)
+[Attach screenshots]
+
+## Checklist
+- [ ] Code follows project conventions
+- [ ] Documentation updated
+- [ ] No breaking changes
+```
+
+### Usage:
+```bash
+/git pr                     # PR to main
+/git pr develop            # PR to develop
+/git pr --draft            # Draft PR
+```
+
+---
+
+## SAFETY RULES
+- ✅ Always review before commit
+- ✅ Conventional commits format
+- ❌ No force push to main/master
+- ✅ Security scan before push
+- ✅ Backup before risky ops
+
+> **Key Takeaway:** Clean commit history with security-first automation. No leaked secrets, no AI attribution.
+"""
+
+# ---
+# USAGE:
+# /git cm              - Commit with auto-message
+# /git cp              - Commit and push
+# /git status          - Check git status
+# /git pr              - Generate PR summary
+# /git conflict        - Help resolve conflicts
+# ---

package/commands/help.toml

@@ -0,0 +1,84 @@
+# Gemini-Kit Help
+# Usage: /help description = "Help and usage information"
+# - /help → Show all commands
+# - /help plan → Show help for /plan
+# - /help tools → Show all MCP tools
+
+description = "Help and usage information"
+
+
+
+
+prompt = """
+{{#if args}}
+Show detailed help for: {{args}}
+
+If {{args}} is a command name (like "plan", "cook", "scout"), explain:
+1. What the command does
+2. When to use it
+3. Example usage
+4. Related commands
+
+If {{args}} is "tools", list all 17 MCP tools with descriptions.
+If {{args}} is "hooks", explain the 5 lifecycle hooks.
+{{else}}
+# 🧰 Gemini-Kit Help
+
+## 📋 Available Commands (20)
+
+### 🔧 Core Workflow
+| Command | Description |
+|---------|-------------|
+| `/plan` | Create implementation plan with approval |
+| `/cook` | Execute changes with auto-checkpoint |
+| `/scout` | Search and analyze codebase |
+| `/code` | Implement features |
+| `/test` | Generate and run tests |
+| `/debug` | Diagnose and fix bugs |
+| `/review` | Code review |
+
+### 🔗 Integrations
+| Command | Description |
+|---------|-------------|
+| `/pr` | Create GitHub Pull Request |
+| `/review-pr` | Review PR in detail |
+| `/ticket` | Get Jira/GitHub issue |
+| `/git` | Git operations |
+
+### 📝 Content & Docs
+| Command | Description |
+|---------|-------------|
+| `/docs` | Generate documentation |
+| `/copywrite` | Content writing |
+| `/journal` | Dev journal |
+
+### 💡 Research & Design
+| Command | Description |
+|---------|-------------|
+| `/brainstorm` | Brainstorm ideas |
+| `/research` | Deep research |
+| `/design` | UI/UX design |
+| `/db` | Database operations |
+| `/project` | Project management |
+
+### 🛡️ Special
+| Command | Description |
+|---------|-------------|
+| `/code-preview` | Dry-run mode (preview only) |
+
+---
+
+## 🛠️ MCP Tools (17)
+Type `/kit tools` to see all tools.
+
+## 🔗 Hooks (5)
+Type `/kit hooks` to see lifecycle hooks.
+
+---
+
+**Usage:** `/kit <command>` for detailed help
+**Example:** `/kit plan` or `/kit cook`
+
+**GitHub:** https://github.com/nth5693/gemini-kit
+{{/if}}
+"""

package/commands/integrate.toml

@@ -0,0 +1,127 @@
+# Integrate - External Service Integrations
+# Usage: /integrate <service> [requirements]
+# Supports: payments, auth, database, email, SMS
+
+description = "Integration with external services"
+
+
+
+prompt = """
+{{#if args}}
+# 🔌 Integration Engineer
+
+You are an expert at integrating third-party services.
+
+**Request:** {{args}}
+
+## Workflow:
+
+### 1. Service Detection
+Parse "{{args}}" to identify:
+- Service name
+- Features needed
+- Current stack (check package.json)
+
+### 2. Supported Services
+
+#### 💳 Payments
+| Service | Features |
+|---------|----------|
+| **stripe** | Checkout, subscriptions, webhooks |
+| **polar** | Open-source subscriptions |
+| **sepay** | Vietnam payments |
+| **paypal** | Global payments |
+
+#### 🔐 Authentication
+| Service | Features |
+|---------|----------|
+| **supabase** | Auth, database, realtime |
+| **firebase** | Auth, Firestore, Functions |
+| **auth0** | SSO, MFA, social login |
+| **clerk** | User management, components |
+
+#### 📧 Communication
+| Service | Features |
+|---------|----------|
+| **resend** | Transactional emails |
+| **twilio** | SMS, voice |
+| **nodemailer** | SMTP emails |
+
+#### 🗄️ Database
+| Service | Features |
+|---------|----------|
+| **prisma** | ORM, migrations |
+| **drizzle** | TypeScript ORM |
+| **mongoose** | MongoDB ODM |
+
+### 3. Implementation
+
+1. **Install** packages
+2. **Configure** env vars
+3. **Create** client/service file
+4. **Add** API routes/webhooks
+5. **Build** UI components
+6. **Test** integration
+7. **Document** setup
+
+### 4. Output Format
+
+```markdown
+## Integration: [Service]
+
+### Install
+npm install [packages]
+
+### Environment Variables
+SERVICE_KEY=xxx
+
+### Files Created
+- src/lib/[service].ts
+- src/routes/api/[service]/
+
+### Usage
+[code example]
+```
+
+---
+
+Implement: {{args}}
+{{else}}
+# 🔌 Integration Helper
+
+Integrate external services with AI assistance.
+
+## Usage:
+```
+/integrate <service> [requirements]
+```
+
+## Categories:
+
+### 💳 Payments
+- `/integrate stripe subscriptions`
+- `/integrate polar billing`
+- `/integrate sepay vn payments`
+
+### 🔐 Auth
+- `/integrate supabase auth`
+- `/integrate clerk users`
+- `/integrate auth0 sso`
+
+### 📧 Email/SMS
+- `/integrate resend emails`
+- `/integrate twilio sms`
+
+### 🗄️ Database
+- `/integrate prisma postgres`
+- `/integrate drizzle orm`
+
+## Example:
+```
+/integrate stripe Add checkout and subscriptions
+/integrate supabase Add auth with Google OAuth
+```
+
+What service do you want to integrate?
+{{/if}}
+"""

package/commands/journal.toml

@@ -0,0 +1,137 @@
+description = "Journal entry or incident report with institutional knowledge (Journal Writer Agent)"
+
+prompt = """
+# 📓 JOURNAL WRITER AGENT
+
+Write documentation for:
+
+**Context:** {{args}}
+
+## MODE DETECTION
+Based on context, select appropriate mode:
+
+### PROGRESS JOURNAL (default)
+When tracking daily/weekly progress.
+
+### INCIDENT REPORT
+When keywords: "bug", "outage", "down", "crash", "failed", "error", "incident" are present.
+
+---
+
+## PROGRESS JOURNAL MODE
+
+### Entry: [Date]
+
+#### What Was Done
+- [Accomplishment 1]
+- [Accomplishment 2]
+
+#### Challenges Encountered
+- [Challenge] → [How solved]
+
+#### Lessons Learned
+- [Key takeaway]
+
+#### Next Steps
+- [ ] [Action item 1]
+- [ ] [Action item 2]
+
+---
+
+## INCIDENT REPORT MODE
+
+### 🚨 Incident Report: [Title]
+**Date:** [YYYY-MM-DD HH:MM]
+**Severity:** Critical / High / Medium / Low
+**Duration:** [X hours/minutes]
+**Tags:** #incident #[system] #[type]
+
+#### Timeline
+| Time | Event | Emotion |
+|------|-------|---------|
+| HH:MM | [Initial symptom] | 😱 Panic |
+| HH:MM | [Investigation started] | 🔍 Focus |
+| HH:MM | [Root cause identified] | 💡 Aha! |
+| HH:MM | [Fix deployed] | 🤞 Hope |
+| HH:MM | [Resolution confirmed] | 😮‍💨 Relief |
+
+#### Root Cause
+[Technical explanation of what went wrong]
+
+#### Failed Attempts
+1. [Attempt 1] - Why it didn't work
+2. [Attempt 2] - Why it didn't work
+3. [Attempt 3] - Why it didn't work
+
+(Learning comes from what DIDN'T work!)
+
+#### Final Fix
+```[language]
+// The fix that worked
+```
+
+#### Impact (Be Specific!)
+| Metric | Value |
+|--------|-------|
+| Downtime | X hours |
+| Users affected | Y users |
+| Revenue impact | $X estimated |
+| Support tickets | Z tickets |
+| Data loss | Yes/No |
+
+#### Cost Breakdown
+```
+Revenue lost:     $X
+Engineering time: $Y (Z hours × $rate)
+Support costs:    $W
+Total impact:     $TOTAL
+```
+
+#### Why Monitoring Didn't Catch It
+[Explain gap - this prevents future incidents!]
+
+#### Preventive Measures
+- [ ] [Action 1 to prevent recurrence]
+- [ ] [Action 2 to prevent recurrence]
+- [ ] [New monitoring/alerting]
+
+#### Lessons Learned
+⚠️ **Key Takeaways:**
+1. [Lesson 1]
+2. [Lesson 2]
+3. [Systemic cause, not individual blame]
+
+#### Related Files
+- [File 1 that was modified]
+- [File 2 that was modified]
+
+---
+
+## 💡 PRO TIPS
+
+1. **Write immediately** - Emotional context fades fast
+2. **Include failed attempts** - Learning = what didn't work
+3. **Use real language** - "We screwed up" not "encountered issue"
+4. **Show numbers** - $cost, time, impact metrics
+5. **Add code snippets** - Error logs, broken → fixed
+6. **Make searchable** - Use #tags for future lookup
+7. **Blame the system** - Focus on process failures
+
+---
+
+## OUTPUT
+Structured markdown, thorough but concise.
+Blame the system, not individuals.
+Include code snippets where relevant.
+Make it searchable with tags.
+
+> **Key Takeaway:** Transform expensive failures into permanent institutional knowledge. Learn once, don't fail repeatedly.
+"""
+
+# ---
+# USAGE:
+# /journal What I accomplished today on the auth feature
+# /journal Found race condition in payment 2hrs before release
+# /journal Production DB outage for 6 hours
+# /journal Weekly status update for team
+# ---

package/commands/kit-setup.toml

@@ -0,0 +1,41 @@
+description = "Interactive project setup wizard - create context files for new projects"
+
+prompt = """
+# 🚀 Kit Setup Wizard
+
+Hello! This is the wizard to setup project context for Gemini-Kit.
+
+## I will help you create 3 context files:
+
+1. **product.md** - Product description, users, goals
+2. **tech-stack.md** - Language, framework, database
+3. **guidelines.md** - Code style, commit conventions
+
+---
+
+## Step 1: Product Context
+
+Please tell me about your project:
+
+**Questions:**
+1. What are you building? (One-line description)
+2. Who are the primary users? (Developers, End users, Enterprises, etc.)
+3. What is the main goal of the product?
+4. What are the main features?
+
+---
+
+When you finish answering, I will:
+1. Create file `.gemini-kit/product.md`
+2. Continue asking about Tech Stack
+3. Continue asking about Guidelines
+4. Complete setup!
+
+**You can answer freely or following the format:**
+```
+Product: [description]
+Users: [who uses it]
+Goals: [goals]
+Features: [main features]
+```
+"""