opencode-enhancer-plugin 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenCode Enhancer Plugin Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,237 @@
+# 🚀 OpenCode Enhancer Plugin
+
+[![npm version](https://img.shields.io/npm/v/opencode-enhancer-plugin.svg)](https://www.npmjs.com/package/opencode-enhancer-plugin)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![OpenCode](https://img.shields.io/badge/OpenCode-Plugin-purple.svg)](https://opencode.ai)
+
+> **Universal Technical Architect & Prompt Enhancer** - Transform vague ideas into precise, context-aware engineering specifications.
+
+## ✨ What is Enhancer?
+
+The **Enhancer** is a third primary agent mode for OpenCode that sits alongside **Plan** and **Build**. It acts as your technical architect, analyzing your codebase and generating detailed, actionable prompts that you can execute in Build mode.
+
+### 🎯 Key Features
+
+- **🔍 Intelligent Context Analysis** - Automatically explores your project structure, tech stack, and relevant files
+- **🧠 Intent Classification** - Categorizes requests as FIX, FEAT, REFACTOR, TEST, or EXPLAIN
+- **📚 Context7 Integration** - Conditionally includes `use context7` when documentation-heavy frameworks are detected
+- **🎨 Style-Aware** - Mimics your project's coding style and patterns
+- **⚡ One-Click Workflow** - Generates copy-pasteable prompts ready for Build mode
+
+## 🚀 Quick Start
+
+### Installation
+
+#### From npm (Recommended)
+
+Add to your OpenCode config (`~/.config/opencode/opencode.json`):
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    "opencode-enhancer-plugin@latest"
+  ]
+}
+```
+
+**Restart OpenCode** and press `Tab` to cycle through modes:
+```
+Plan → Build → Enhancer → Plan
+```
+
+#### From Source (Development)
+
+1. **Clone** this repository:
+   ```bash
+   git clone https://github.com/MaansenV/opencode-enhancer-plugin.git
+   cd opencode-enhancer-plugin
+   ```
+
+2. **Install dependencies** and build:
+   ```bash
+   npm install
+   npm run build
+   ```
+
+3. **Add to your OpenCode config** using the local path:
+   ```json
+   {
+     "plugin": [
+       "file:///path/to/opencode-enhancer-plugin/dist/index.js"
+     ]
+   }
+   ```
+
+### Version Management
+
+- **Latest version**: `"opencode-enhancer-plugin@latest"`
+- **Specific version**: `"opencode-enhancer-plugin@1.0.0"`
+- **Update**: OpenCode auto-updates plugins on startup, or run `opencode --update-plugins`
+
+### Uninstall
+
+Remove from your `opencode.json`:
+```json
+{
+  "plugin": []
+}
+```
+
+## 📖 How It Works
+
+```
+┌─────────────┐     ┌──────────────┐     ┌─────────────┐
+│   User      │────▶│  Enhancer    │────▶│   Build     │
+│  Request    │     │   Agent      │     │   Mode      │
+└─────────────┘     └──────────────┘     └─────────────┘
+                           │
+                           ▼
+                    ┌──────────────┐
+                    │  Explore-    │
+                    │   Context    │
+                    │  (Subagent)  │
+                    └──────────────┘
+```
+
+### Workflow
+
+1. **Select Enhancer Mode** (Tab to cycle)
+2. **Describe your goal** - "Fix the login bug" or "Add user authentication"
+3. **Enhancer analyzes** - Calls explore-context to map your codebase
+4. **Receive enhanced prompt** - Structured markdown with context, instructions, and technical requirements
+5. **Copy & Execute** - Switch to Build mode and run the generated prompt
+
+## 🎨 Example Output
+
+```markdown
+# Task: Fix Authentication Token Validation
+
+## Context
+Detected **React + TypeScript + Express** project. Authentication logic located in `src/auth/middleware.ts` and `src/utils/token.ts`.
+
+## Instructions
+use context7
+1. Modify `src/auth/middleware.ts`:
+   - Locate function `validateToken` (line 45)
+   - Add null check for `req.headers.authorization`
+   - Implement JWT verification using existing `verify()` pattern
+2. Update `src/utils/token.ts`:
+   - Add error handling for expired tokens
+   - Return structured error object instead of throwing
+3. Testing:
+   - Run `npm test` to verify auth flow
+   - Check edge cases: missing token, expired token, malformed token
+
+## Technical Requirements
+- **Style**: Follow existing async/await patterns
+- **Error Handling**: Use `try/catch` with custom AuthError class
+- **TypeScript**: Maintain strict typing, add interfaces for token payload
+```
+
+## 🛠️ Architecture
+
+### Components
+
+| Component | Type | Description |
+|-----------|------|-------------|
+| **Enhancer** | Primary Agent | Main interface, intent classification, prompt generation |
+| **Explore-Context** | Subagent | Read-only codebase analysis, tech stack detection |
+| **check_context7** | Tool | Decides if libraries need Context7 documentation |
+
+### Supported Tech Stacks
+
+- **Web**: React, Vue, Angular, Svelte, Next.js, Nuxt, Vite
+- **Backend**: Express, Django, Flask, FastAPI, Rails, Laravel, Spring
+- **Game Engines**: Unity, Godot, Unreal Engine
+- **Data/ML**: TensorFlow, PyTorch, NumPy, Pandas
+- **Infrastructure**: Docker, Kubernetes, Terraform
+- **And more...**
+
+## ⚙️ Configuration
+
+### Agent Configuration
+
+The plugin automatically registers both agents via the `config` hook:
+
+```typescript
+// Enhancer (Primary Agent)
+{
+  mode: "primary",
+  model: "opencode/kimi-k2.5-free",
+  description: "Universal Technical Architect & Prompt Enhancer",
+  color: "#9C27B0",
+  steps: 15,
+  tools: { task: true, read: true }
+}
+
+// Explore-Context (Subagent)
+{
+  mode: "subagent",
+  hidden: true,
+  model: "opencode/kimi-k2.5-free",
+  tools: { list: true, read: true, grep: true, bash: true }
+}
+```
+
+### Context7 Integration
+
+The plugin automatically detects libraries that benefit from Context7:
+
+```typescript
+// Libraries triggering "use context7"
+["react", "django", "unity", "tensorflow", "docker", ...]
+```
+
+## 🔧 Development
+
+### Project Structure
+
+```
+opencode-enhancer-plugin/
+├── src/
+│   └── index.ts          # Source TypeScript
+├── dist/                 # Compiled output (published to npm)
+│   ├── index.js
+│   └── index.d.ts
+├── package.json          # Package metadata
+├── tsconfig.json         # TypeScript config
+└── README.md             # This file
+```
+
+### Hooks
+
+- **`config`** - Registers both agents on startup
+- **`tool.execute.before`** - Logs explore-context calls
+- **`message.updated`** - Appends Build mode hint to outputs
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+### Ideas for Contributions
+
+- Add more tech stack detectors
+- Improve Context7 heuristics
+- Add support for additional intent types
+- Enhance prompt templates
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- Built for [OpenCode](https://opencode.ai)
+- Inspired by the need for better context-aware AI assistance
+- Thanks to the OpenCode community for feedback and ideas
+
+---
+
+<div align="center">
+
+**[⬆ Back to Top](#-opencode-enhancer-plugin)**
+
+Made with ❤️ for the OpenCode community
+
+</div>

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "@opencode-ai/plugin";
+export declare const EnhancerPlugin: Plugin;
+export default EnhancerPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAEjD,eAAO,MAAM,cAAc,EAAE,MA0E5B,CAAA;AAED,eAAe,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,70 @@
+export const EnhancerPlugin = async ({ client }) => {
+    client.app.log({
+        service: "enhancer",
+        level: "info",
+        message: "Enhancer plugin initialized"
+    }).catch(() => { });
+    return {
+        config: async (input) => {
+            if (!input.agent) {
+                input.agent = {};
+            }
+            input.agent["explore-context"] = {
+                mode: "subagent",
+                hidden: true,
+                model: "opencode/kimi-k2.5-free",
+                prompt: `You are the UNIVERSAL CONTEXT DETECTIVE. Map the codebase and extract technical context.`,
+                tools: {
+                    list: true,
+                    read: true,
+                    grep: true,
+                    bash: true
+                }
+            };
+            input.agent.enhancer = {
+                mode: "primary",
+                model: "opencode/kimi-k2.5-free",
+                description: "Universal Technical Architect & Prompt Enhancer",
+                color: "#9C27B0",
+                steps: 15,
+                tools: {
+                    task: true,
+                    read: true,
+                    bash: false,
+                    edit: false,
+                    write: false
+                },
+                prompt: `You are the CHIEF ARCHITECT (Enhancer). Translate user wishes into precise engineering specifications.`
+            };
+        },
+        "tool.execute.before": async (input, output) => {
+            if (input.tool === "task") {
+                const args = output.args;
+                if (args?.subagent_type === "explore-context") {
+                    client.app.log({
+                        service: "enhancer",
+                        level: "debug",
+                        message: "Calling explore-context subagent"
+                    }).catch(() => { });
+                }
+            }
+        },
+        "message.updated": async (input, output) => {
+            if (input.session?.agent?.name !== "enhancer") {
+                return;
+            }
+            const content = input.message?.content || "";
+            if (content.includes("Build mode") || content.includes("Build Mode")) {
+                return;
+            }
+            if (content.includes("```markdown") || content.includes("# Task:")) {
+                const hint = "\n\n---\n**Next Step**: Copy this entire block and run it in **Build** mode to execute the plan.";
+                if (output && typeof output === "object") {
+                    output.content = content + hint;
+                }
+            }
+        }
+    };
+};
+export default EnhancerPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAW,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IACzD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QACb,OAAO,EAAE,UAAU;QACnB,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,6BAA6B;KACvC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAElB,OAAO;QACL,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACtB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACjB,KAAK,CAAC,KAAK,GAAG,EAAE,CAAA;YAClB,CAAC;YAED,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAG;gBAC/B,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,yBAAyB;gBAChC,MAAM,EAAE,0FAA0F;gBAClG,KAAK,EAAE;oBACL,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,IAAI;iBACX;aACF,CAAA;YAED,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG;gBACrB,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,yBAAyB;gBAChC,WAAW,EAAE,iDAAiD;gBAC9D,KAAK,EAAE,SAAS;gBAChB,KAAK,EAAE,EAAE;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,KAAK;oBACX,IAAI,EAAE,KAAK;oBACX,KAAK,EAAE,KAAK;iBACb;gBACD,MAAM,EAAE,wGAAwG;aACjH,CAAA;QACH,CAAC;QAED,qBAAqB,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,IAA8C,CAAA;gBAClE,IAAI,IAAI,EAAE,aAAa,KAAK,iBAAiB,EAAE,CAAC;oBAC9C,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;wBACb,OAAO,EAAE,UAAU;wBACnB,KAAK,EAAE,OAAO;wBACd,OAAO,EAAE,kCAAkC;qBAC5C,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;QAED,iBAAiB,EAAE,KAAK,EAAE,KAAU,EAAE,MAAW,EAAE,EAAE;YACnD,IAAI,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC9C,OAAM;YACR,CAAC;YAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAA;YAC5C,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACrE,OAAM;YACR,CAAC;YAED,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACnE,MAAM,IAAI,GAAG,kGAAkG,CAAA;gBAC/G,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;oBACzC,MAAM,CAAC,OAAO,GAAG,OAAO,GAAG,IAAI,CAAA;gBACjC,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC,CAAA;AAED,eAAe,cAAc,CAAA"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "opencode-enhancer-plugin",
+  "version": "1.0.0",
+  "description": "Universal Technical Architect & Prompt Enhancer for OpenCode",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "enhancer",
+    "prompt",
+    "context",
+    "ai",
+    "agent",
+    "openai",
+    "anthropic",
+    "gemini"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MaansenV/opencode-enhancer-plugin.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MaansenV/opencode-enhancer-plugin/issues"
+  },
+  "homepage": "https://github.com/MaansenV/opencode-enhancer-plugin#readme",
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.1.39",
+    "typescript": "^5.9.3"
+  }
+}