@the-magic-tower/fixhive-opencode-plugin 0.1.0 → 0.1.2

package/README.de.md

@@ -0,0 +1,147 @@
+# FixHive
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="README.ko.md">한국어</a> |
+  <a href="README.zh.md">中文</a> |
+  <a href="README.ja.md">日本語</a> |
+  <a href="README.es.md">Español</a> |
+  <a href="README.de.md">Deutsch</a> |
+  <a href="README.fr.md">Français</a> |
+  <a href="README.nl.md">Nederlands</a>
+</p>
+
+> Community-basiertes Fehlerwissen-Sharing für OpenCode
+
+FixHive ist ein OpenCode-Plugin, das während der Entwicklungssitzungen automatisch Fehler erfasst, eine Community-Wissensdatenbank nach Lösungen abfragt und gelöste Fehler mit anderen Entwicklern teilt.
+
+## Funktionen
+
+- **Automatische Fehlererkennung**: Erkennt automatisch Fehler aus Tool-Ausgaben (bash, edit, etc.)
+- **Cloud-Wissensdatenbank**: Suche nach Community-Lösungen mit semantischer Ähnlichkeit (pgvector)
+- **Lokaler Cache**: SQLite-basierter lokaler Speicher für Offline-Zugriff
+- **Datenschutzfilterung**: Entfernt automatisch sensible Daten (API-Schlüssel, Pfade, E-Mails)
+- **Echtzeit-Synchronisierung**: Sofortige Cloud-Kommunikation bei Fehler/Lösung
+
+## Installation
+
+```bash
+npm install @the-magic-tower/fixhive-opencode-plugin
+```
+
+## Konfiguration
+
+Setzen Sie die folgenden Umgebungsvariablen:
+
+```bash
+# Erforderlich für Cloud-Funktionen
+FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
+FIXHIVE_SUPABASE_KEY=your-anon-key
+
+# Optional: Für embedding-basierte semantische Suche
+OPENAI_API_KEY=sk-...
+
+# Optional: Benutzerdefinierte Mitwirkenden-ID (wird automatisch generiert, wenn nicht gesetzt)
+FIXHIVE_CONTRIBUTOR_ID=your-contributor-id
+```
+
+## Verwendung
+
+### Als OpenCode-Plugin
+
+Fügen Sie zu Ihrer OpenCode-Konfiguration hinzu (`opencode.config.ts`):
+
+```typescript
+import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
+
+export default {
+  plugins: [FixHivePlugin],
+};
+```
+
+### Verfügbare Befehle
+
+| Befehl | Beschreibung |
+|--------|--------------|
+| `fixhive_search` | Wissensdatenbank nach Fehlerlösungen durchsuchen |
+| `fixhive_resolve` | Fehler als gelöst markieren und Lösung teilen |
+| `fixhive_list` | Fehler in der aktuellen Sitzung auflisten |
+| `fixhive_vote` | Lösung hoch-/runtervoten |
+| `fixhive_stats` | Nutzungsstatistiken anzeigen |
+| `fixhive_helpful` | Melden, dass eine Lösung hilfreich war |
+
+### Beispiel-Workflow
+
+1. **Fehler tritt auf** → FixHive erkennt und protokolliert ihn automatisch
+2. **Lösungen suchen** → `fixhive_search "Module not found: react"`
+3. **Fix anwenden** → Community-Lösung befolgen
+4. **Lösung teilen** → `fixhive_resolve <error-id> "Fehlende Abhängigkeit installiert"`
+
+## Cloud-Setup (Supabase)
+
+1. Neues Supabase-Projekt erstellen
+2. Setup-Skript im SQL-Editor ausführen:
+
+```bash
+cat scripts/setup-supabase.sql | pbcopy
+# Im Supabase SQL-Editor einfügen
+```
+
+3. Projekt-URL und Anon-Key unter Settings > API abrufen
+
+## Architektur
+
+```
+FixHive Plugin
+├── Error Detection (tool.execute.after Hook)
+├── Privacy Filter (entfernt sensible Daten)
+├── Local Storage (SQLite)
+│   ├── error_records
+│   └── query_cache
+└── Cloud Client (Supabase + pgvector)
+    ├── knowledge_entries
+    └── usage_logs
+```
+
+## Datenschutz
+
+FixHive filtert automatisch sensible Informationen:
+
+- API-Schlüssel (OpenAI, GitHub, AWS, Stripe, etc.)
+- JWT-Token und Bearer-Token
+- E-Mail-Adressen
+- Dateipfade (ersetzt durch `~` oder `<PROJECT>`)
+- Umgebungsvariablen mit sensiblen Namen
+- Datenbankverbindungszeichenfolgen
+- IP-Adressen (außer localhost)
+
+## Entwicklung
+
+```bash
+# Abhängigkeiten installieren
+npm install
+
+# Bauen
+npm run build
+
+# Watch-Modus
+npm run dev
+
+# Typ-Prüfung
+npm run typecheck
+
+# Tests ausführen
+npm test
+```
+
+## Lizenz
+
+MIT
+
+## Mitwirken
+
+1. Repository forken
+2. Feature-Branch erstellen
+3. Änderungen committen
+4. Zum Branch pushen
+5. Pull Request erstellen

package/README.es.md

@@ -0,0 +1,147 @@
+# FixHive
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="README.ko.md">한국어</a> |
+  <a href="README.zh.md">中文</a> |
+  <a href="README.ja.md">日本語</a> |
+  <a href="README.es.md">Español</a> |
+  <a href="README.de.md">Deutsch</a> |
+  <a href="README.fr.md">Français</a> |
+  <a href="README.nl.md">Nederlands</a>
+</p>
+
+> Sistema de Compartición de Conocimiento de Errores Basado en la Comunidad para OpenCode
+
+FixHive es un plugin de OpenCode que captura automáticamente errores durante las sesiones de desarrollo, consulta una base de conocimientos comunitaria para encontrar soluciones y comparte errores resueltos con otros desarrolladores.
+
+## Características
+
+- **Detección Automática de Errores**: Detecta automáticamente errores de las salidas de herramientas (bash, edit, etc.)
+- **Base de Conocimientos en la Nube**: Búsqueda de soluciones comunitarias usando similitud semántica (pgvector)
+- **Caché Local**: Almacenamiento local basado en SQLite para acceso sin conexión
+- **Filtrado de Privacidad**: Redacta automáticamente datos sensibles (claves API, rutas, correos electrónicos)
+- **Sincronización en Tiempo Real**: Comunicación inmediata con la nube en error/resolución
+
+## Instalación
+
+```bash
+npm install @the-magic-tower/fixhive-opencode-plugin
+```
+
+## Configuración
+
+Configure las siguientes variables de entorno:
+
+```bash
+# Requerido para funciones en la nube
+FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
+FIXHIVE_SUPABASE_KEY=your-anon-key
+
+# Opcional: Para búsqueda semántica basada en embeddings
+OPENAI_API_KEY=sk-...
+
+# Opcional: ID de contribuidor personalizado (se genera automáticamente si no se establece)
+FIXHIVE_CONTRIBUTOR_ID=your-contributor-id
+```
+
+## Uso
+
+### Como Plugin de OpenCode
+
+Agregue a su configuración de OpenCode (`opencode.config.ts`):
+
+```typescript
+import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
+
+export default {
+  plugins: [FixHivePlugin],
+};
+```
+
+### Comandos Disponibles
+
+| Comando | Descripción |
+|---------|-------------|
+| `fixhive_search` | Buscar soluciones de errores en la base de conocimientos |
+| `fixhive_resolve` | Marcar error como resuelto y compartir solución |
+| `fixhive_list` | Listar errores en la sesión actual |
+| `fixhive_vote` | Votar a favor/en contra de una solución |
+| `fixhive_stats` | Ver estadísticas de uso |
+| `fixhive_helpful` | Reportar que una solución fue útil |
+
+### Flujo de Trabajo de Ejemplo
+
+1. **Ocurre un error** → FixHive lo detecta y registra automáticamente
+2. **Buscar soluciones** → `fixhive_search "Module not found: react"`
+3. **Aplicar corrección** → Seguir la solución de la comunidad
+4. **Compartir resolución** → `fixhive_resolve <error-id> "Instalada dependencia faltante"`
+
+## Configuración en la Nube (Supabase)
+
+1. Crear un nuevo proyecto de Supabase
+2. Ejecutar el script de configuración en el Editor SQL:
+
+```bash
+cat scripts/setup-supabase.sql | pbcopy
+# Pegar en el Editor SQL de Supabase
+```
+
+3. Obtener la URL del proyecto y la clave anon desde Settings > API
+
+## Arquitectura
+
+```
+FixHive Plugin
+├── Error Detection (hook tool.execute.after)
+├── Privacy Filter (redacta datos sensibles)
+├── Local Storage (SQLite)
+│   ├── error_records
+│   └── query_cache
+└── Cloud Client (Supabase + pgvector)
+    ├── knowledge_entries
+    └── usage_logs
+```
+
+## Privacidad
+
+FixHive filtra automáticamente información sensible:
+
+- Claves API (OpenAI, GitHub, AWS, Stripe, etc.)
+- Tokens JWT y tokens Bearer
+- Direcciones de correo electrónico
+- Rutas de archivos (reemplazadas con `~` o `<PROJECT>`)
+- Variables de entorno con nombres sensibles
+- Cadenas de conexión a bases de datos
+- Direcciones IP (excepto localhost)
+
+## Desarrollo
+
+```bash
+# Instalar dependencias
+npm install
+
+# Compilar
+npm run build
+
+# Modo observación
+npm run dev
+
+# Verificación de tipos
+npm run typecheck
+
+# Ejecutar pruebas
+npm test
+```
+
+## Licencia
+
+MIT
+
+## Contribuir
+
+1. Hacer fork del repositorio
+2. Crear su rama de características
+3. Hacer commit de sus cambios
+4. Hacer push a la rama
+5. Crear un Pull Request

package/README.fr.md

@@ -0,0 +1,147 @@
+# FixHive
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="README.ko.md">한국어</a> |
+  <a href="README.zh.md">中文</a> |
+  <a href="README.ja.md">日本語</a> |
+  <a href="README.es.md">Español</a> |
+  <a href="README.de.md">Deutsch</a> |
+  <a href="README.fr.md">Français</a> |
+  <a href="README.nl.md">Nederlands</a>
+</p>
+
+> Partage de Connaissances d'Erreurs Basé sur la Communauté pour OpenCode
+
+FixHive est un plugin OpenCode qui capture automatiquement les erreurs pendant les sessions de développement, interroge une base de connaissances communautaire pour trouver des solutions et partage les erreurs résolues avec d'autres développeurs.
+
+## Fonctionnalités
+
+- **Détection Automatique des Erreurs** : Détecte automatiquement les erreurs des sorties d'outils (bash, edit, etc.)
+- **Base de Connaissances Cloud** : Recherche de solutions communautaires par similarité sémantique (pgvector)
+- **Cache Local** : Stockage local basé sur SQLite pour l'accès hors ligne
+- **Filtrage de Confidentialité** : Supprime automatiquement les données sensibles (clés API, chemins, e-mails)
+- **Synchronisation en Temps Réel** : Communication cloud immédiate lors d'erreur/résolution
+
+## Installation
+
+```bash
+npm install @the-magic-tower/fixhive-opencode-plugin
+```
+
+## Configuration
+
+Définissez les variables d'environnement suivantes :
+
+```bash
+# Requis pour les fonctionnalités cloud
+FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
+FIXHIVE_SUPABASE_KEY=your-anon-key
+
+# Optionnel : Pour la recherche sémantique basée sur les embeddings
+OPENAI_API_KEY=sk-...
+
+# Optionnel : ID de contributeur personnalisé (généré automatiquement si non défini)
+FIXHIVE_CONTRIBUTOR_ID=your-contributor-id
+```
+
+## Utilisation
+
+### En tant que Plugin OpenCode
+
+Ajoutez à votre configuration OpenCode (`opencode.config.ts`) :
+
+```typescript
+import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
+
+export default {
+  plugins: [FixHivePlugin],
+};
+```
+
+### Commandes Disponibles
+
+| Commande | Description |
+|----------|-------------|
+| `fixhive_search` | Rechercher des solutions d'erreurs dans la base de connaissances |
+| `fixhive_resolve` | Marquer une erreur comme résolue et partager la solution |
+| `fixhive_list` | Lister les erreurs de la session en cours |
+| `fixhive_vote` | Voter pour/contre une solution |
+| `fixhive_stats` | Voir les statistiques d'utilisation |
+| `fixhive_helpful` | Signaler qu'une solution a été utile |
+
+### Exemple de Flux de Travail
+
+1. **Une erreur survient** → FixHive la détecte et l'enregistre automatiquement
+2. **Rechercher des solutions** → `fixhive_search "Module not found: react"`
+3. **Appliquer le correctif** → Suivre la solution de la communauté
+4. **Partager la résolution** → `fixhive_resolve <error-id> "Dépendance manquante installée"`
+
+## Configuration Cloud (Supabase)
+
+1. Créer un nouveau projet Supabase
+2. Exécuter le script de configuration dans l'éditeur SQL :
+
+```bash
+cat scripts/setup-supabase.sql | pbcopy
+# Coller dans l'éditeur SQL Supabase
+```
+
+3. Obtenir l'URL du projet et la clé anon depuis Settings > API
+
+## Architecture
+
+```
+FixHive Plugin
+├── Error Detection (hook tool.execute.after)
+├── Privacy Filter (supprime les données sensibles)
+├── Local Storage (SQLite)
+│   ├── error_records
+│   └── query_cache
+└── Cloud Client (Supabase + pgvector)
+    ├── knowledge_entries
+    └── usage_logs
+```
+
+## Confidentialité
+
+FixHive filtre automatiquement les informations sensibles :
+
+- Clés API (OpenAI, GitHub, AWS, Stripe, etc.)
+- Jetons JWT et jetons Bearer
+- Adresses e-mail
+- Chemins de fichiers (remplacés par `~` ou `<PROJECT>`)
+- Variables d'environnement avec des noms sensibles
+- Chaînes de connexion aux bases de données
+- Adresses IP (sauf localhost)
+
+## Développement
+
+```bash
+# Installer les dépendances
+npm install
+
+# Compiler
+npm run build
+
+# Mode surveillance
+npm run dev
+
+# Vérification des types
+npm run typecheck
+
+# Exécuter les tests
+npm test
+```
+
+## Licence
+
+MIT
+
+## Contribuer
+
+1. Forker le dépôt
+2. Créer votre branche de fonctionnalité
+3. Committer vos modifications
+4. Pousser vers la branche
+5. Créer une Pull Request

package/README.ja.md

@@ -0,0 +1,147 @@
+# FixHive
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="README.ko.md">한국어</a> |
+  <a href="README.zh.md">中文</a> |
+  <a href="README.ja.md">日本語</a> |
+  <a href="README.es.md">Español</a> |
+  <a href="README.de.md">Deutsch</a> |
+  <a href="README.fr.md">Français</a> |
+  <a href="README.nl.md">Nederlands</a>
+</p>
+
+> OpenCode向けコミュニティベースのエラー知識共有システム
+
+FixHiveは、開発セッション中にエラーを自動的にキャプチャし、コミュニティナレッジベースからソリューションを検索し、解決したエラーを他の開発者と共有するOpenCodeプラグインです。
+
+## 機能
+
+- **自動エラー検出**：ツール出力（bash、editなど）からエラーを自動検出
+- **クラウドナレッジベース**：セマンティック類似性（pgvector）を使用したコミュニティソリューション検索
+- **ローカルキャッシュ**：オフラインアクセス用のSQLiteベースのローカルストレージ
+- **プライバシーフィルタリング**：機密データ（APIキー、パス、メールアドレス）の自動除去
+- **リアルタイム同期**：エラー/解決時の即時クラウド通信
+
+## インストール
+
+```bash
+npm install @the-magic-tower/fixhive-opencode-plugin
+```
+
+## 設定
+
+以下の環境変数を設定してください：
+
+```bash
+# クラウド機能に必須
+FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
+FIXHIVE_SUPABASE_KEY=your-anon-key
+
+# オプション：埋め込みベースのセマンティック検索用
+OPENAI_API_KEY=sk-...
+
+# オプション：カスタム貢献者ID（未設定の場合は自動生成）
+FIXHIVE_CONTRIBUTOR_ID=your-contributor-id
+```
+
+## 使用方法
+
+### OpenCodeプラグインとして
+
+OpenCode設定ファイル（`opencode.config.ts`）に追加：
+
+```typescript
+import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
+
+export default {
+  plugins: [FixHivePlugin],
+};
+```
+
+### 利用可能なコマンド
+
+| コマンド | 説明 |
+|----------|------|
+| `fixhive_search` | エラーソリューションのナレッジベースを検索 |
+| `fixhive_resolve` | エラーを解決済みとしてマークし、ソリューションを共有 |
+| `fixhive_list` | 現在のセッションのエラー一覧を表示 |
+| `fixhive_vote` | ソリューションに投票（賛成/反対） |
+| `fixhive_stats` | 使用統計を表示 |
+| `fixhive_helpful` | ソリューションが役立ったことを報告 |
+
+### ワークフロー例
+
+1. **エラー発生** → FixHiveが自動的に検出して記録
+2. **ソリューション検索** → `fixhive_search "Module not found: react"`
+3. **修正を適用** → コミュニティソリューションに従う
+4. **解決を共有** → `fixhive_resolve <error-id> "不足している依存関係をインストール"`
+
+## クラウドセットアップ（Supabase）
+
+1. 新しいSupabaseプロジェクトを作成
+2. SQLエディタでセットアップスクリプトを実行：
+
+```bash
+cat scripts/setup-supabase.sql | pbcopy
+# Supabase SQLエディタに貼り付け
+```
+
+3. Settings > APIからプロジェクトURLとanon keyを取得
+
+## アーキテクチャ
+
+```
+FixHive Plugin
+├── Error Detection（tool.execute.afterフック）
+├── Privacy Filter（機密データを除去）
+├── Local Storage（SQLite）
+│   ├── error_records
+│   └── query_cache
+└── Cloud Client（Supabase + pgvector）
+    ├── knowledge_entries
+    └── usage_logs
+```
+
+## プライバシー
+
+FixHiveは機密情報を自動的にフィルタリングします：
+
+- APIキー（OpenAI、GitHub、AWS、Stripeなど）
+- JWTトークンとBearerトークン
+- メールアドレス
+- ファイルパス（`~`または`<PROJECT>`に置換）
+- 機密名を含む環境変数
+- データベース接続文字列
+- IPアドレス（localhost除く）
+
+## 開発
+
+```bash
+# 依存関係をインストール
+npm install
+
+# ビルド
+npm run build
+
+# ウォッチモード
+npm run dev
+
+# 型チェック
+npm run typecheck
+
+# テスト実行
+npm test
+```
+
+## ライセンス
+
+MIT
+
+## コントリビュート
+
+1. リポジトリをフォーク
+2. 機能ブランチを作成
+3. 変更をコミット
+4. ブランチにプッシュ
+5. Pull Requestを作成

package/README.ko.md

@@ -0,0 +1,147 @@
+# FixHive
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="README.ko.md">한국어</a> |
+  <a href="README.zh.md">中文</a> |
+  <a href="README.ja.md">日本語</a> |
+  <a href="README.es.md">Español</a> |
+  <a href="README.de.md">Deutsch</a> |
+  <a href="README.fr.md">Français</a> |
+  <a href="README.nl.md">Nederlands</a>
+</p>
+
+> OpenCode를 위한 커뮤니티 기반 오류 지식 공유 시스템
+
+FixHive는 개발 세션 중 발생하는 오류를 자동으로 캡처하고, 커뮤니티 지식 베이스에서 솔루션을 검색하며, 해결된 오류를 다른 개발자들과 공유하는 OpenCode 플러그인입니다.
+
+## 주요 기능
+
+- **자동 오류 감지**: 도구 출력(bash, edit 등)에서 오류를 자동으로 감지
+- **클라우드 지식 베이스**: 시맨틱 유사도(pgvector)를 사용한 커뮤니티 솔루션 검색
+- **로컬 캐싱**: 오프라인 접근을 위한 SQLite 기반 로컬 저장소
+- **개인정보 필터링**: 민감한 데이터(API 키, 경로, 이메일) 자동 삭제
+- **실시간 동기화**: 오류/해결 시 즉각적인 클라우드 통신
+
+## 설치
+
+```bash
+npm install @the-magic-tower/fixhive-opencode-plugin
+```
+
+## 설정
+
+다음 환경 변수를 설정하세요:
+
+```bash
+# 클라우드 기능 필수
+FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
+FIXHIVE_SUPABASE_KEY=your-anon-key
+
+# 선택: 임베딩 기반 시맨틱 검색용
+OPENAI_API_KEY=sk-...
+
+# 선택: 사용자 정의 기여자 ID (미설정시 자동 생성)
+FIXHIVE_CONTRIBUTOR_ID=your-contributor-id
+```
+
+## 사용법
+
+### OpenCode 플러그인으로 사용
+
+OpenCode 설정 파일(`opencode.config.ts`)에 추가:
+
+```typescript
+import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
+
+export default {
+  plugins: [FixHivePlugin],
+};
+```
+
+### 사용 가능한 명령어
+
+| 명령어 | 설명 |
+|--------|------|
+| `fixhive_search` | 오류 솔루션 지식 베이스 검색 |
+| `fixhive_resolve` | 오류를 해결됨으로 표시하고 솔루션 공유 |
+| `fixhive_list` | 현재 세션의 오류 목록 조회 |
+| `fixhive_vote` | 솔루션 추천/비추천 |
+| `fixhive_stats` | 사용 통계 조회 |
+| `fixhive_helpful` | 솔루션이 도움됐음을 보고 |
+
+### 사용 예시 워크플로우
+
+1. **오류 발생** → FixHive가 자동으로 감지하고 기록
+2. **솔루션 검색** → `fixhive_search "Module not found: react"`
+3. **수정 적용** → 커뮤니티 솔루션 따라하기
+4. **해결 공유** → `fixhive_resolve <error-id> "누락된 의존성 설치"`
+
+## 클라우드 설정 (Supabase)
+
+1. 새 Supabase 프로젝트 생성
+2. SQL 에디터에서 설정 스크립트 실행:
+
+```bash
+cat scripts/setup-supabase.sql | pbcopy
+# Supabase SQL 에디터에 붙여넣기
+```
+
+3. Settings > API에서 프로젝트 URL과 anon key 획득
+
+## 아키텍처
+
+```
+FixHive Plugin
+├── Error Detection (tool.execute.after 훅)
+├── Privacy Filter (민감한 데이터 삭제)
+├── Local Storage (SQLite)
+│   ├── error_records
+│   └── query_cache
+└── Cloud Client (Supabase + pgvector)
+    ├── knowledge_entries
+    └── usage_logs
+```
+
+## 개인정보 보호
+
+FixHive는 민감한 정보를 자동으로 필터링합니다:
+
+- API 키 (OpenAI, GitHub, AWS, Stripe 등)
+- JWT 토큰 및 Bearer 토큰
+- 이메일 주소
+- 파일 경로 (`~` 또는 `<PROJECT>`로 대체)
+- 민감한 이름의 환경 변수
+- 데이터베이스 연결 문자열
+- IP 주소 (localhost 제외)
+
+## 개발
+
+```bash
+# 의존성 설치
+npm install
+
+# 빌드
+npm run build
+
+# 감시 모드
+npm run dev
+
+# 타입 검사
+npm run typecheck
+
+# 테스트 실행
+npm test
+```
+
+## 라이선스
+
+MIT
+
+## 기여하기
+
+1. 저장소 포크
+2. 기능 브랜치 생성
+3. 변경 사항 커밋
+4. 브랜치에 푸시
+5. Pull Request 생성

package/README.md

@@ -1,5 +1,16 @@
 # FixHive
 
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="README.ko.md">한국어</a> |
+  <a href="README.zh.md">中文</a> |
+  <a href="README.ja.md">日本語</a> |
+  <a href="README.es.md">Español</a> |
+  <a href="README.de.md">Deutsch</a> |
+  <a href="README.fr.md">Français</a> |
+  <a href="README.nl.md">Nederlands</a>
+</p>
+
 > Community-based Error Knowledge Sharing for OpenCode
 
 FixHive is an OpenCode plugin that automatically captures errors during development sessions, queries a community knowledge base for solutions, and shares resolved errors with other developers.
@@ -15,7 +26,7 @@ FixHive is an OpenCode plugin that automatically captures errors during developm
 ## Installation
 
 ```bash
-npm install @fixhive/opencode-plugin
+npm install @the-magic-tower/fixhive-opencode-plugin
 ```
 
 ## Configuration
@@ -38,12 +49,14 @@ FIXHIVE_CONTRIBUTOR_ID=your-contributor-id
 
 ### As OpenCode Plugin
 
-Add to your OpenCode configuration:
+Add to your OpenCode configuration (`opencode.config.ts`):
 
 ```typescript
-import FixHivePlugin from '@fixhive/opencode-plugin';
+import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
 
-export default FixHivePlugin;
+export default {
+  plugins: [FixHivePlugin],
+};
 ```
 
 ### Available Commands

package/README.nl.md

@@ -0,0 +1,147 @@
+# FixHive
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="README.ko.md">한국어</a> |
+  <a href="README.zh.md">中文</a> |
+  <a href="README.ja.md">日本語</a> |
+  <a href="README.es.md">Español</a> |
+  <a href="README.de.md">Deutsch</a> |
+  <a href="README.fr.md">Français</a> |
+  <a href="README.nl.md">Nederlands</a>
+</p>
+
+> Community-gebaseerd Foutkennis Delen voor OpenCode
+
+FixHive is een OpenCode-plugin die automatisch fouten vastlegt tijdens ontwikkelsessies, een community-kennisbank raadpleegt voor oplossingen en opgeloste fouten deelt met andere ontwikkelaars.
+
+## Functies
+
+- **Automatische Foutdetectie**: Detecteert automatisch fouten uit tool-uitvoer (bash, edit, etc.)
+- **Cloud Kennisbank**: Zoek community-oplossingen met semantische gelijkenis (pgvector)
+- **Lokale Cache**: SQLite-gebaseerde lokale opslag voor offline toegang
+- **Privacy Filtering**: Verwijdert automatisch gevoelige gegevens (API-sleutels, paden, e-mails)
+- **Realtime Synchronisatie**: Directe cloudcommunicatie bij fout/oplossing
+
+## Installatie
+
+```bash
+npm install @the-magic-tower/fixhive-opencode-plugin
+```
+
+## Configuratie
+
+Stel de volgende omgevingsvariabelen in:
+
+```bash
+# Vereist voor cloudfuncties
+FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
+FIXHIVE_SUPABASE_KEY=your-anon-key
+
+# Optioneel: Voor embedding-gebaseerd semantisch zoeken
+OPENAI_API_KEY=sk-...
+
+# Optioneel: Aangepaste bijdrager-ID (automatisch gegenereerd indien niet ingesteld)
+FIXHIVE_CONTRIBUTOR_ID=your-contributor-id
+```
+
+## Gebruik
+
+### Als OpenCode Plugin
+
+Voeg toe aan uw OpenCode-configuratie (`opencode.config.ts`):
+
+```typescript
+import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
+
+export default {
+  plugins: [FixHivePlugin],
+};
+```
+
+### Beschikbare Commando's
+
+| Commando | Beschrijving |
+|----------|--------------|
+| `fixhive_search` | Zoek foutoplossingen in de kennisbank |
+| `fixhive_resolve` | Markeer fout als opgelost en deel oplossing |
+| `fixhive_list` | Lijst fouten in huidige sessie |
+| `fixhive_vote` | Stem voor/tegen een oplossing |
+| `fixhive_stats` | Bekijk gebruiksstatistieken |
+| `fixhive_helpful` | Meld dat een oplossing nuttig was |
+
+### Voorbeeld Workflow
+
+1. **Fout treedt op** → FixHive detecteert en registreert deze automatisch
+2. **Zoek oplossingen** → `fixhive_search "Module not found: react"`
+3. **Pas fix toe** → Volg de community-oplossing
+4. **Deel oplossing** → `fixhive_resolve <error-id> "Ontbrekende dependency geïnstalleerd"`
+
+## Cloud Setup (Supabase)
+
+1. Maak een nieuw Supabase-project aan
+2. Voer het setup-script uit in de SQL-editor:
+
+```bash
+cat scripts/setup-supabase.sql | pbcopy
+# Plak in Supabase SQL-editor
+```
+
+3. Haal uw project-URL en anon-sleutel op via Settings > API
+
+## Architectuur
+
+```
+FixHive Plugin
+├── Error Detection (tool.execute.after hook)
+├── Privacy Filter (verwijdert gevoelige gegevens)
+├── Local Storage (SQLite)
+│   ├── error_records
+│   └── query_cache
+└── Cloud Client (Supabase + pgvector)
+    ├── knowledge_entries
+    └── usage_logs
+```
+
+## Privacy
+
+FixHive filtert automatisch gevoelige informatie:
+
+- API-sleutels (OpenAI, GitHub, AWS, Stripe, etc.)
+- JWT-tokens en Bearer-tokens
+- E-mailadressen
+- Bestandspaden (vervangen door `~` of `<PROJECT>`)
+- Omgevingsvariabelen met gevoelige namen
+- Database-verbindingsstrings
+- IP-adressen (behalve localhost)
+
+## Ontwikkeling
+
+```bash
+# Installeer dependencies
+npm install
+
+# Bouwen
+npm run build
+
+# Watch-modus
+npm run dev
+
+# Type-controle
+npm run typecheck
+
+# Tests uitvoeren
+npm test
+```
+
+## Licentie
+
+MIT
+
+## Bijdragen
+
+1. Fork de repository
+2. Maak uw feature-branch aan
+3. Commit uw wijzigingen
+4. Push naar de branch
+5. Maak een Pull Request

package/README.zh.md

@@ -0,0 +1,147 @@
+# FixHive
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="README.ko.md">한국어</a> |
+  <a href="README.zh.md">中文</a> |
+  <a href="README.ja.md">日本語</a> |
+  <a href="README.es.md">Español</a> |
+  <a href="README.de.md">Deutsch</a> |
+  <a href="README.fr.md">Français</a> |
+  <a href="README.nl.md">Nederlands</a>
+</p>
+
+> OpenCode 社区错误知识共享系统
+
+FixHive 是一个 OpenCode 插件，可在开发会话期间自动捕获错误，从社区知识库查询解决方案，并与其他开发者共享已解决的错误。
+
+## 功能特性
+
+- **自动错误检测**：自动检测工具输出（bash、edit 等）中的错误
+- **云端知识库**：使用语义相似度（pgvector）搜索社区解决方案
+- **本地缓存**：基于 SQLite 的本地存储，支持离线访问
+- **隐私过滤**：自动过滤敏感数据（API 密钥、路径、电子邮件）
+- **实时同步**：错误/解决时立即与云端通信
+
+## 安装
+
+```bash
+npm install @the-magic-tower/fixhive-opencode-plugin
+```
+
+## 配置
+
+设置以下环境变量：
+
+```bash
+# 云端功能必需
+FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
+FIXHIVE_SUPABASE_KEY=your-anon-key
+
+# 可选：用于基于嵌入的语义搜索
+OPENAI_API_KEY=sk-...
+
+# 可选：自定义贡献者 ID（未设置时自动生成）
+FIXHIVE_CONTRIBUTOR_ID=your-contributor-id
+```
+
+## 使用方法
+
+### 作为 OpenCode 插件
+
+添加到 OpenCode 配置文件（`opencode.config.ts`）：
+
+```typescript
+import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
+
+export default {
+  plugins: [FixHivePlugin],
+};
+```
+
+### 可用命令
+
+| 命令 | 描述 |
+|------|------|
+| `fixhive_search` | 搜索错误解决方案知识库 |
+| `fixhive_resolve` | 将错误标记为已解决并共享解决方案 |
+| `fixhive_list` | 列出当前会话中的错误 |
+| `fixhive_vote` | 对解决方案投票（赞/踩） |
+| `fixhive_stats` | 查看使用统计 |
+| `fixhive_helpful` | 报告解决方案有帮助 |
+
+### 示例工作流程
+
+1. **发生错误** → FixHive 自动检测并记录
+2. **搜索解决方案** → `fixhive_search "Module not found: react"`
+3. **应用修复** → 按照社区解决方案操作
+4. **共享解决方案** → `fixhive_resolve <error-id> "安装缺失的依赖"`
+
+## 云端设置（Supabase）
+
+1. 创建新的 Supabase 项目
+2. 在 SQL 编辑器中运行设置脚本：
+
+```bash
+cat scripts/setup-supabase.sql | pbcopy
+# 粘贴到 Supabase SQL 编辑器
+```
+
+3. 从 Settings > API 获取项目 URL 和 anon key
+
+## 架构
+
+```
+FixHive Plugin
+├── Error Detection（tool.execute.after 钩子）
+├── Privacy Filter（过滤敏感数据）
+├── Local Storage（SQLite）
+│   ├── error_records
+│   └── query_cache
+└── Cloud Client（Supabase + pgvector）
+    ├── knowledge_entries
+    └── usage_logs
+```
+
+## 隐私保护
+
+FixHive 自动过滤敏感信息：
+
+- API 密钥（OpenAI、GitHub、AWS、Stripe 等）
+- JWT 令牌和 Bearer 令牌
+- 电子邮件地址
+- 文件路径（替换为 `~` 或 `<PROJECT>`）
+- 包含敏感名称的环境变量
+- 数据库连接字符串
+- IP 地址（localhost 除外）
+
+## 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 构建
+npm run build
+
+# 监视模式
+npm run dev
+
+# 类型检查
+npm run typecheck
+
+# 运行测试
+npm test
+```
+
+## 许可证
+
+MIT
+
+## 贡献
+
+1. Fork 仓库
+2. 创建功能分支
+3. 提交更改
+4. 推送到分支
+5. 创建 Pull Request

package/dist/index.js

@@ -1254,19 +1254,41 @@ ${errorRecord.errorStack || ""}`;
     };
   }
   /**
-   * Vote on a knowledge entry
+   * Vote on a knowledge entry (with duplicate vote prevention)
    */
   async vote(knowledgeId, helpful) {
-    const column = helpful ? "upvotes" : "downvotes";
-    await this.supabase.rpc("increment_vote", {
-      entry_id: knowledgeId,
-      vote_type: column
+    const voteType = helpful ? "up" : "down";
+    const { data, error } = await this.supabase.rpc("safe_vote", {
+      p_entry_id: knowledgeId,
+      p_user_hash: this.contributorId,
+      p_vote_type: voteType
     });
-    await this.supabase.from("usage_logs").insert({
-      knowledge_id: knowledgeId,
-      action: helpful ? "upvote" : "downvote",
-      user_hash: this.contributorId
+    if (error) {
+      return { success: false, error: error.message };
+    }
+    const result = data;
+    if (result.success) {
+      await this.supabase.from("usage_logs").insert({
+        knowledge_id: knowledgeId,
+        action: helpful ? "upvote" : "downvote",
+        user_hash: this.contributorId
+      });
+    }
+    return result;
+  }
+  /**
+   * Report an entry for review
+   */
+  async reportEntry(knowledgeId, reason) {
+    const { data, error } = await this.supabase.rpc("report_entry", {
+      p_entry_id: knowledgeId,
+      p_user_hash: this.contributorId,
+      p_reason: reason || null
     });
+    if (error) {
+      return { success: false };
+    }
+    return data;
   }
   /**
    * Report helpful usage
@@ -1452,10 +1474,33 @@ function createTools(localStore, cloudClient, privacyFilter, context) {
         helpful: tool.schema.boolean().describe("True for upvote, false for downvote")
       },
       async execute(args) {
-        await cloudClient.vote(args.knowledgeId, args.helpful);
+        const result = await cloudClient.vote(args.knowledgeId, args.helpful);
+        if (!result.success) {
+          if (result.error === "Already voted") {
+            return "You have already voted on this solution.";
+          }
+          return `Vote failed: ${result.error}`;
+        }
         return args.helpful ? "Thanks for the feedback! Solution upvoted." : "Thanks for the feedback! Solution downvoted.";
       }
     }),
+    /**
+     * Report inappropriate content
+     */
+    fixhive_report: tool({
+      description: "Report a FixHive solution for inappropriate content, spam, or incorrect information.",
+      args: {
+        knowledgeId: tool.schema.string().describe("Knowledge entry ID to report"),
+        reason: tool.schema.string().optional().describe("Reason for reporting (spam, incorrect, inappropriate, etc.)")
+      },
+      async execute(args) {
+        const result = await cloudClient.reportEntry(args.knowledgeId, args.reason);
+        if (!result.success) {
+          return "Failed to submit report. Please try again later.";
+        }
+        return "Report submitted. Thank you for helping keep FixHive clean!";
+      }
+    }),
     /**
      * Get usage statistics
      */
@@ -1691,10 +1736,14 @@ ${errors.map((e) => `- [${e.id.slice(0, 8)}] ${e.errorType}: ${e.errorMessage.sl
     })
   };
 }
+var COMMUNITY_SUPABASE = {
+  url: "https://flpqzkrpufrgnpxvftip.supabase.co",
+  anonKey: "sb_publishable_w3Y2uo-0vb4bFVamntChVw_Aqi0rv2y"
+};
 function loadConfig() {
   return {
-    supabaseUrl: process.env.FIXHIVE_SUPABASE_URL || "",
-    supabaseAnonKey: process.env.FIXHIVE_SUPABASE_KEY || "",
+    supabaseUrl: process.env.FIXHIVE_SUPABASE_URL || COMMUNITY_SUPABASE.url,
+    supabaseAnonKey: process.env.FIXHIVE_SUPABASE_KEY || COMMUNITY_SUPABASE.anonKey,
     openaiApiKey: process.env.OPENAI_API_KEY || process.env.FIXHIVE_OPENAI_KEY || "",
     contributorId: process.env.FIXHIVE_CONTRIBUTOR_ID || "",
     cacheExpirationMs: DEFAULT_CONFIG.cacheExpirationMs,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-magic-tower/fixhive-opencode-plugin",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Community-based error knowledge sharing for OpenCode",
   "type": "module",
   "main": "dist/index.js",