🐺 Initial commit - Lupul Augmentat MCP Server

- MCP server cu stdio transport pentru performanță maximă
- Tool-uri pentru file operations, HTTP requests, system commands
- Suport NATS pentru comunicare inter-module
- Configurare nginx cu API key auth și SSL
- Arhitectură modulară și extensibilă

🤖 Generated with Claude Code

DEBUG_CURRENT_TASK.md

@@ -0,0 +1,187 @@
+# 🔍 DEBUG CURRENT TASK
+
+## ⚡ REGULI DE AUR (NICIODATA NU ȘTERG!)
+
+1. **NICI UN TASK NU SE CONSIDERĂ ÎNDEPLINIT** până nu se îndeplinesc criteriile de acceptanță definite
+2. **NU ÎNCEPEM UN TASK** până nu definim criteriile de acceptanță
+3. **UN SINGUR TASK ÎN LUCRU** - restul în standby
+4. **DOCUMENTAȚIA RĂMÂNE ÎN ARBORE** - toate fișierele conectate
+5. **NU LUCREZI NICIODATĂ LA ALTCEVA** decât ți s-a spus explicit
+6. **NICIODATA NU HARDCODEZ VARIABILE!**
+7. **NICIODATA NU ADAUGAM SETARI FAILOVERS** - Dacă ceva nu e bine, vrem să știm imediat
+8. **Salvez date relevante taskului curent** în DEBUG_CURRENT_TASK.md
+9. **Salvez întotdeauna ce am modificat** pentru rollback dacă e nevoie
+10. **Creez criterii de acceptanță** înainte de a testa/finaliza
+11. **Când task-uri depind de API changes** → salvez în TASK_IN_STANDBY.md
+
+## 📋 TASK CURENT
+
+**ID:** Task #2
+**Nume:** Implementează handler-ele pentru tool-uri specifice
+**Status:** În lucru
+**Început:** 25 Iulie 2025
+
+## 🎯 CRITERII DE ACCEPTANȚĂ
+
+1. ✅ Implementare tool-uri de bază
+   - ✅ File operations (read, write, list)
+   - ✅ System commands execution
+   - ✅ HTTP client pentru API calls
+
+2. ✅ Handler pattern extensibil
+   - ✅ Base class/interface pentru tool handlers
+   - ✅ Lifecycle hooks (init, validate, execute, cleanup)
+   - ✅ Error handling standardizat
+
+3. ✅ Schema validation
+   - ✅ Input validation cu Zod
+   - ✅ Output formatting consistent
+   - ✅ Error messages descriptive
+
+4. ✅ Security layer pentru tools
+   - ✅ Permission checking
+   - ✅ Input sanitization
+   - ✅ Resource limits (timeout, memory)
+
+5. ✅ Module SDK pentru dezvoltare ușoară
+   - ✅ TypeScript SDK pentru module
+   - ⬜ Python SDK pentru module
+   - ✅ Exemplu de modul funcțional
+
+6. ✅ Teste pentru toate tool-urile
+   - ✅ Unit tests pentru fiecare tool
+   - ✅ Integration tests cu mock-uri
+   - ✅ Test coverage complet
+
+7. ✅ Documentație tool-uri
+   - ✅ README pentru fiecare tool
+   - ✅ Exemple de utilizare
+   - ✅ API reference actualizat
+
+## 🔧 MODIFICĂRI FĂCUTE
+
+### 25 Iulie 2025 - Task #2
+1. **Base Handler Pattern**
+   - ToolHandler abstract class cu lifecycle hooks
+   - Validation cu Zod schemas
+   - Timeout handling
+   - Permission checking
+   - Error handling standardizat
+
+2. **File Operations Tools**
+   - FileReadTool - citire fișiere cu limite
+   - FileWriteTool - scriere cu securitate
+   - FileListTool - listare directoare recursiv
+
+3. **System Command Tool**
+   - Execuție comenzi cu whitelist
+   - Protecție contra shell injection
+   - Output size limits
+   - Timeout handling
+
+4. **HTTP Client Tool**
+   - Request-uri HTTP/HTTPS
+   - JSON și text parsing
+   - Protecție contra internal networks
+   - Headers și body handling
+
+5. **Tool Registry Update**
+   - Înregistrare automată built-in tools
+   - Execuție locală pentru built-in
+   - Fallback la NATS pentru module externe
+
+### 25 Iulie 2025 - Task #1
+1. **TypeScript Project Setup**
+   - package.json cu toate dependencies
+   - tsconfig.json cu strict mode
+   - ESLint + Prettier configurate
+   - .gitignore și .env.example
+
+2. **Structură de bază creată**
+   - /src/server.ts - MCPServer class principal
+   - /src/config.ts - Configurare cu Zod validation
+   - /src/types/index.ts - TypeScript interfaces
+   - /src/utils/logger.ts - Pino logger setup
+   - /src/nats/NatsClient.ts - NATS connection wrapper
+   - /src/registry/ToolRegistry.ts - Tool management
+   - /src/registry/ModuleManager.ts - Module lifecycle
+
+3. **Funcționalități implementate**
+   - Server MCP cu stdio transport
+   - NATS client cu reconnect logic
+   - Tool registry și discovery
+   - Module manager (placeholder)
+   - Graceful shutdown
+   - Structured logging
+1. **Creat CLAUDE.md**
+   - Adăugat reguli de aur adaptate din proiectul anterior
+   - Structură documentație definită
+   - Context proiect salvat
+   - Configurație server: 127.0.0.1:19017
+
+2. **Creat DEBUG_CURRENT_TASK.md** (acest fișier)
+   - Pentru tracking task curent
+   - Salvare modificări pentru rollback
+
+3. **Creat TASK_IN_STANDBY.md**
+   - Pentru tasks în așteptare
+   - 4 tasks definite pentru dezvoltare MCP
+
+4. **Creat structură /docs:**
+   - ARHITECTURA.md - design tehnic și componente
+   - SETUP.md - ghid instalare și configurare
+   - TOOLS.md - tool-uri disponibile și planificate
+   - TASKS.md - management și istoric tasks
+
+5. **Reguli de aur adăugate în TOATE fișierele**
+
+## 📝 NOTE DE LUCRU
+
+- User a cerut reguli de aur în TOATE fișierele
+- Server MCP va asculta la 127.0.0.1:19017
+- Access extern via nginx: mcp.runningwolf.com
+- Inspirație structură: proiect CLOBIT
+
+## 🔄 URMĂTORII PAȘI
+
+1. ✅ Creare director /docs
+2. ✅ Creare fișiere documentație:
+   - ✅ ARHITECTURA.md
+   - ✅ SETUP.md
+   - ✅ TOOLS.md
+   - ✅ TASKS.md
+3. ✅ Adăugare reguli de aur în toate fișierele
+4. ⬜ Test final: pornire fără context
+
+## 📋 ACTION PLAN ARHITECTURĂ
+
+### Decizii luate în discuție:
+1. **Arhitectură hibrid** - module în orice limbaj
+2. **NATS** pentru comunicare inter-module
+3. **Security first** - JWT auth, permissions, sandboxing
+4. **Core în Node.js** cu TypeScript
+
+### Arhitectura finală:
+```
+Claude → MCP Core (Node.js) → NATS → Modules (any language)
+```
+
+### Message Contract definit:
+- ToolRequest/ToolResponse interfaces
+- NATS topics: tools.{language}.{toolname}.{method}
+- Module discovery & health checks
+
+### Security layers:
+- Module authentication cu JWT
+- Request authorization
+- Sandbox execution (Docker)
+- Audit logging complet
+
+### Implementation phases:
+- Phase 1: Basic Core (1-2 days)
+- Phase 2: Module System (2-3 days)
+- Phase 3: Security (1-2 days)
+- Phase 4: Production Ready (2-3 days)
+
+---
+*Actualizat: 25 Iulie 2025*