🧠 Neural Memory v2.0

Sistema MCP (Model Context Protocol) per memorizzazione e recupero contestuale della conoscenza.

---

🚀 Prova Neural Memory ORA!

Vuoi provarlo subito nel tuo Cline? Aggiungi questa configurazione al tuo cline_mcp_settings.json:

{
  "mcpServers": {
    "neural-memory": {
      "timeout": 120,
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@drakonkat/neural-memory@latest"
      ]
    }
  }
}

Per uso locale (sviluppo)

{
  "mcpServers": {
    "neural-memory": {
      "timeout": 120,
      "type": "stdio",
      "command": "node",
      "args": [
        "./neural-memory/src/index.js"
      ]
    }
  }
}

⚠️ Nota: Sostituisci il path con quello del tuo progetto locale!

---

Novità v2.0

🎯 Database Unificato

• No più database separati per progetto! Tutta la memoria risiede in un unico database SQLite
• Più veloce, più semplice, zero configurazione

📋 Session Management

• Inizia/riprendi/chiudi sessioni di lavoro
• Tracciamento automatico: nodi creati, skills apprese, durata
• Snapshot contesto dettagliato

🎓 Skills Framework

• Schema rigido per registrare skills con struttura consistente
• framework, language, filePattern, learnSteps, useCases
• Suggerimento automatico basato su contesto

📊 Reports HTML

• Genera report visivi della tua memoria
• Statistiche, skills più usate, lavoro recente

Quick Start

import { initialize, handleMcpRequest } from 'neural-memory';

// Inizializza il servizio
await initialize();

// Inizia una sessione
const session = await handleMcpRequest('start_session', {
  name: 'Refactoring API Gateway',
  tags: ['backend', 'api']
});

// Registra una skill
await handleMcpRequest('register_skill', {
  name: 'Fastify CRUD API',
  framework: 'fastify',
  language: 'javascript',
  filePattern: '**/*.service.js',
  learnSteps: [
    '1. Inizializzare progetto',
    '2. Creare schema validazione',
    '3. Implementare handler'
  ],
  useCases: [
    'Creare API REST',
    'Gestire errori standardizzati'
  ]
});

// Cerca skills
const skills = await handleMcpRequest('suggest_skills', {
  currentKeywords: ['fastify', 'api'],
  domain: 'javascript'
});

// Salva contesto
await handleMcpRequest('save_context_snapshot', {
  summary: 'Refactoring completato 80%',
  pendingTasks: ['Test integrazione', 'Deploy staging'],
  learnings: ['Prisma richiede migration esplicite']
});

// Chiudi sessione
await handleMcpRequest('end_session', {
  sessionId: session.session_id
});

Tools Disponibili

Session Management

Tool	Descrizione
start_session	Inizia nuova sessione
resume_session	Riprendi sessione esistente
end_session	Chiudi sessione
list_sessions	Lista sessioni con filtri

Skills Framework

Tool	Descrizione
register_skill	Registra skill (schema rigido)
apply_skill	Trova e applica skill
suggest_skills	Suggerisci skills

Context Management

Tool	Descrizione
save_context_snapshot	Salva snapshot
restore_context	Recupera contesto
generate_session_summary	Riassunto sessione

Node Management

Tool	Descrizione
add_node	Aggiungi nodo
search_nodes	Cerca nodi (con confidence)
get_node_context	Contesto nodo
link_nodes	Collega nodi
update_node	Aggiorna nodo
delete_node	Elimina nodo

Reports

Tool	Descrizione
get_memory_report	Report JSON/HTML
suggest_nodes	Suggerisci nodi

Node Types

Type	Priority	Use Case
skill	⭐⭐⭐	Knowledge skill
error	⭐⭐⭐	Errore risolto
operation	⭐⭐	How-to
convention	⭐⭐	Regole naming
edge_case	⭐⭐	Caso limite
pattern	⭐	Design pattern
task	⭐	Task completato
generic	⭐	Nodo generico

Confidence Scoring

Il sistema calcola un confidence score (0.0-1.0) per ogni risultato basato su:

• BM25 Score (35%) - Full-text search ranking
• Keyword Match (25%) - Sovrapposizione keywords
• Recency Bonus (10%) - Nodi recenti preferiti
• Type Score (15%) - Skills/errors più importanti
• Weight (15%) - Peso manuale

Schema Skill Rigido

{
  "name": "Nome Skill",
  "framework": "fastify|react|prisma|...",
  "language": "javascript|typescript|python|...",
  "filePattern": "**/*.service.js",
  "learnSteps": ["Passo 1", "Passo 2"],
  "useCases": ["Caso 1", "Caso 2"],
  "implementation": "// Codice...",
  "examples": ["file1.js"],
  "prerequisites": ["Prerequisito 1"]
}

Installazione

npm install neural-memory

Database

Il database unificato si trova in:

data/neural-memory-unified.sqlite

License

MIT