namnam-skills 2.2.2 → 2.5.0

package/README.md

@@ -41,11 +41,13 @@ npx namnam-skills platforms
 | Cursor | `.cursorrules` | ✅ | - |
 | Windsurf | `.windsurfrules` | ✅ | - |
 | Cline | `.clinerules` | ✅ | - |
+| **Roo Code** | `.roo/rules/` | ✅ | - |
 | Aider | `.aider.conf.yml` | ✅ | - |
 | OpenAI Codex | `codex.md` | ✅ | - |
 | Google Gemini | `GEMINI.md` | ✅ | - |
 | Universal | `AGENTS.md` | ✅ | - |
 
+
 ## Available Categories
 
 | Category | Description | Files |
@@ -102,6 +104,101 @@ npx namnam-skills platforms
 npx namnam-skills uninstall
 ```
 
+### 🧠 Semantic Commands (Augment-like Features!)
+
+The semantic layer provides LLM-powered codebase understanding through embeddings and RAG:
+
+```bash
+# Build semantic index with code embeddings
+namnam semantic index
+namnam sem index --force                    # Re-index everything
+namnam sem index --provider openai          # Use OpenAI embeddings
+
+# Semantic search - find code by meaning, not just text
+namnam sem search "authentication logic"
+namnam sem search "how to handle errors" --top 5
+
+# Ask questions about your codebase (RAG)
+namnam sem ask "how does the login flow work?"
+namnam sem ask "what design patterns are used?" --provider openai
+
+# Find similar code
+namnam sem similar src/auth.js
+namnam sem similar components/Button.tsx --top 10
+
+# Generate context for AI tasks
+namnam sem context "implement logout feature"
+
+# View index statistics
+namnam sem stats
+
+# Configure providers
+namnam sem config --show
+namnam sem config --embedding-provider openai --embedding-model text-embedding-3-small
+namnam sem config --llm-provider anthropic --llm-model claude-3-sonnet-20240229
+
+# Clear index
+namnam sem clear
+```
+
+#### Supported Providers
+
+| Type | Provider | Models | Notes |
+|------|----------|--------|-------|
+| **Embeddings** | `ollama` | nomic-embed-text, all-minilm | 🆓 Local, no API key |
+| | `openai` | text-embedding-3-small/large | ☁️ Cloud, fast |
+| | `voyage` | voyage-code-2 | 🎯 Code-optimized |
+| **LLM** | `ollama` | codellama, llama2, mistral | 🆓 Local, no API key |
+| | `openai` | gpt-4o, gpt-4-turbo | ☁️ Best quality |
+| | `anthropic` | claude-3-sonnet, claude-3-opus | ☁️ Best for code |
+
+#### Quick Setup (Zero Cost with Ollama)
+
+```bash
+# 1. Install Ollama (https://ollama.ai)
+# 2. Pull embedding model
+ollama pull nomic-embed-text
+
+# 3. Pull LLM model  
+ollama pull codellama
+
+# 4. Build index
+namnam sem index
+
+# 5. Start asking questions!
+namnam sem ask "explain the main architecture"
+```
+
+#### 🤖 Auto Mode (Like Augment AI!)
+
+**Zero configuration needed!** When you install namnam-skills, it automatically:
+1. Indexes your codebase with embeddings
+2. Watches for file changes  
+3. Provides context for AI prompts
+
+```bash
+# Check auto mode status
+namnam sem auto
+
+# Enable full auto mode
+namnam sem auto --enable
+
+# Start real-time file watcher
+namnam sem watch
+
+# Generate context for current task
+namnam sem auto-context -q "implement logout" -f src/auth.js
+
+# Integrate with Claude Code
+namnam sem integrate
+```
+
+**How it works:**
+- On `npm install` → Auto-indexes codebase
+- On file changes → Updates vectors automatically
+- On AI prompt → Context is available via `namnam sem auto-context`
+
+
 ## The `/namnam` Command
 
 After installation, use the powerful `/namnam` universal orchestrator:
@@ -169,6 +266,7 @@ your-project/
 ├── .cursorrules        # For Cursor AI
 ├── .windsurfrules      # For Windsurf
 ├── .clinerules         # For Cline
+├── .roo/rules/         # For Roo Code (5 rule files)
 ├── codex.md            # For OpenAI Codex
 ├── GEMINI.md           # For Google Gemini
 └── .aider.conf.yml     # For Aider

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "namnam-skills",
-  "version": "2.2.2",
-  "description": "Ultimate AI Skills Installer - Universal support for Claude, Codex, Cursor, Windsurf, Cline, Aider, Gemini, and Antigravity. 2000+ agents, workflows, and skills with auto-integration.",
+  "version": "2.5.0",
+  "description": "Ultimate AI Skills Installer with Auto-Semantic Mode (like Augment AI!) - Auto-indexing, file watching, RAG. Universal support for Claude, Codex, Cursor, Windsurf, Cline, Aider, Gemini. 2000+ agents, workflows, and skills.",
   "author": "NamNam",
   "license": "MIT",
   "keywords": [
@@ -15,6 +15,9 @@
     "cursor",
     "windsurf",
     "cline",
+    "roo",
+    "roocode",
+    "roo-code",
     "aider",
     "anthropic",
     "bmad",
@@ -27,7 +30,15 @@
     "ai-coding",
     "developer-tools",
     "antigravity",
-    "gemini"
+    "gemini",
+    "embeddings",
+    "rag",
+    "semantic-search",
+    "vector-search",
+    "code-understanding",
+    "augment",
+    "ollama",
+    "voyage"
   ],
   "type": "module",
   "bin": {

package/src/auto-semantic.js

@@ -0,0 +1,432 @@
+/**
+ * Auto-Semantic Engine for NamNam CLI
+ * 
+ * Provides automatic semantic indexing like Augment AI:
+ * - Auto-index on project init
+ * - File watcher for real-time updates
+ * - Auto-inject context into AI prompts
+ * - Background processing
+ */
+
+import fs from 'fs-extra';
+import path from 'path';
+import { SemanticIndex, loadConfig, saveConfig } from './semantic.js';
+
+// ============================================
+// Auto-Index Configuration
+// ============================================
+
+const AUTO_CONFIG_FILE = '.namnam/auto-semantic.json';
+
+const DEFAULT_AUTO_CONFIG = {
+    enabled: true,
+    autoIndex: true,
+    watchFiles: true,
+    autoContext: true,
+    indexOnInstall: true,
+    debounceMs: 2000,
+    excludePatterns: [
+        '**/node_modules/**',
+        '**/.git/**',
+        '**/dist/**',
+        '**/build/**',
+        '**/.namnam/**'
+    ]
+};
+
+// ============================================
+// Auto-Config Management
+// ============================================
+
+async function getAutoConfig(cwd = process.cwd()) {
+    const configPath = path.join(cwd, AUTO_CONFIG_FILE);
+
+    if (await fs.pathExists(configPath)) {
+        try {
+            const config = await fs.readJson(configPath);
+            return { ...DEFAULT_AUTO_CONFIG, ...config };
+        } catch {
+            return DEFAULT_AUTO_CONFIG;
+        }
+    }
+    return DEFAULT_AUTO_CONFIG;
+}
+
+async function saveAutoConfig(config, cwd = process.cwd()) {
+    const configPath = path.join(cwd, AUTO_CONFIG_FILE);
+    await fs.ensureDir(path.dirname(configPath));
+    await fs.writeJson(configPath, config, { spaces: 2 });
+}
+
+async function isAutoSemanticEnabled(cwd = process.cwd()) {
+    const config = await getAutoConfig(cwd);
+    return config.enabled;
+}
+
+// ============================================
+// Auto-Index on Install
+// ============================================
+
+/**
+ * Run auto-indexing after npm install
+ * Called from postinstall.js
+ */
+async function runAutoIndex(cwd = process.cwd(), options = {}) {
+    const autoConfig = await getAutoConfig(cwd);
+
+    if (!autoConfig.enabled || !autoConfig.indexOnInstall) {
+        return { skipped: true, reason: 'Auto-index disabled' };
+    }
+
+    try {
+        const semanticConfig = await loadConfig(cwd);
+        const index = new SemanticIndex(cwd, semanticConfig);
+
+        await index.initialize();
+        const result = await index.buildIndex({ force: options.force });
+
+        // Save timestamp
+        await saveAutoConfig({
+            ...autoConfig,
+            lastIndexed: new Date().toISOString(),
+            lastIndexCount: result.total
+        }, cwd);
+
+        return {
+            success: true,
+            indexed: result.indexed,
+            total: result.total
+        };
+    } catch (error) {
+        return {
+            success: false,
+            error: error.message
+        };
+    }
+}
+
+// ============================================
+// File Watcher for Real-time Updates
+// ============================================
+
+let watcherInstance = null;
+let debounceTimer = null;
+let pendingFiles = new Set();
+
+/**
+ * Start watching for file changes
+ */
+async function startWatcher(cwd = process.cwd()) {
+    if (watcherInstance) {
+        return { already: true };
+    }
+
+    const autoConfig = await getAutoConfig(cwd);
+
+    if (!autoConfig.enabled || !autoConfig.watchFiles) {
+        return { skipped: true, reason: 'File watching disabled' };
+    }
+
+    const { watch } = await import('fs');
+
+    // Use recursive watching
+    watcherInstance = watch(cwd, { recursive: true }, async (eventType, filename) => {
+        if (!filename) return;
+
+        // Check if file should be indexed
+        const ext = path.extname(filename).toLowerCase();
+        const codeExtensions = ['.js', '.ts', '.jsx', '.tsx', '.py', '.go', '.rs', '.java'];
+
+        if (!codeExtensions.includes(ext)) return;
+
+        // Check exclude patterns
+        const shouldExclude = autoConfig.excludePatterns.some(pattern => {
+            const regex = new RegExp(pattern.replace(/\*\*/g, '.*').replace(/\*/g, '[^/]*'));
+            return regex.test(filename);
+        });
+
+        if (shouldExclude) return;
+
+        // Add to pending and debounce
+        pendingFiles.add(filename);
+
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+        }
+
+        debounceTimer = setTimeout(async () => {
+            const files = Array.from(pendingFiles);
+            pendingFiles.clear();
+
+            try {
+                await updateIndexIncremental(files, cwd);
+            } catch (error) {
+                console.error('Auto-index update failed:', error.message);
+            }
+        }, autoConfig.debounceMs);
+    });
+
+    return { started: true };
+}
+
+/**
+ * Stop file watcher
+ */
+function stopWatcher() {
+    if (watcherInstance) {
+        watcherInstance.close();
+        watcherInstance = null;
+    }
+    if (debounceTimer) {
+        clearTimeout(debounceTimer);
+        debounceTimer = null;
+    }
+    pendingFiles.clear();
+
+    return { stopped: true };
+}
+
+/**
+ * Update index incrementally for changed files
+ */
+async function updateIndexIncremental(changedFiles, cwd = process.cwd()) {
+    const semanticConfig = await loadConfig(cwd);
+    const index = new SemanticIndex(cwd, semanticConfig);
+
+    await index.initialize();
+
+    // For now, just rebuild the index
+    // Future: implement true incremental update
+    return index.buildIndex({ force: false });
+}
+
+// ============================================
+// Auto-Context Generation
+// ============================================
+
+/**
+ * Generate context automatically based on user's current activity
+ * This is the key feature that makes it work like Augment
+ */
+async function generateAutoContext(options = {}, cwd = process.cwd()) {
+    const {
+        query = '',           // User's current question/task
+        currentFile = '',     // File user is currently editing
+        recentFiles = [],     // Recently opened files
+        maxChunks = 10,
+        maxTokens = 8000
+    } = options;
+
+    const autoConfig = await getAutoConfig(cwd);
+
+    if (!autoConfig.enabled || !autoConfig.autoContext) {
+        return null;
+    }
+
+    try {
+        const semanticConfig = await loadConfig(cwd);
+        const index = new SemanticIndex(cwd, semanticConfig);
+        await index.initialize();
+
+        const contextParts = [];
+        let totalTokens = 0;
+
+        // 1. Add current file context if available
+        if (currentFile && await fs.pathExists(path.join(cwd, currentFile))) {
+            const content = await fs.readFile(path.join(cwd, currentFile), 'utf-8');
+            const fileContext = `## Current File: ${currentFile}\n\`\`\`\n${content.substring(0, 3000)}\n\`\`\`\n`;
+            contextParts.push(fileContext);
+            totalTokens += Math.ceil(fileContext.length / 4);
+        }
+
+        // 2. Add semantic search results if query provided
+        if (query && query.trim()) {
+            const searchResults = await index.search(query, { k: maxChunks, threshold: 0.5 });
+
+            if (searchResults.length > 0) {
+                let semanticContext = `## Relevant Code (based on: "${query}")\n\n`;
+
+                for (const result of searchResults) {
+                    if (totalTokens > maxTokens) break;
+
+                    const meta = result.metadata;
+                    const chunk = `### ${meta.filePath}:${meta.startLine}-${meta.endLine}\n\`\`\`\n${meta.content}\n\`\`\`\n\n`;
+
+                    const chunkTokens = Math.ceil(chunk.length / 4);
+                    if (totalTokens + chunkTokens > maxTokens) break;
+
+                    semanticContext += chunk;
+                    totalTokens += chunkTokens;
+                }
+
+                contextParts.push(semanticContext);
+            }
+        }
+
+        // 3. Add recent files context
+        if (recentFiles.length > 0) {
+            let recentContext = '## Recently Edited Files\n\n';
+
+            for (const file of recentFiles.slice(0, 3)) {
+                if (totalTokens > maxTokens) break;
+
+                const filePath = path.join(cwd, file);
+                if (await fs.pathExists(filePath)) {
+                    const content = await fs.readFile(filePath, 'utf-8');
+                    const snippet = content.substring(0, 1000);
+                    const chunk = `### ${file}\n\`\`\`\n${snippet}${content.length > 1000 ? '\n...' : ''}\n\`\`\`\n\n`;
+
+                    const chunkTokens = Math.ceil(chunk.length / 4);
+                    if (totalTokens + chunkTokens > maxTokens) break;
+
+                    recentContext += chunk;
+                    totalTokens += chunkTokens;
+                }
+            }
+
+            if (recentContext !== '## Recently Edited Files\n\n') {
+                contextParts.push(recentContext);
+            }
+        }
+
+        if (contextParts.length === 0) {
+            return null;
+        }
+
+        return {
+            context: contextParts.join('\n'),
+            tokenEstimate: totalTokens,
+            sources: {
+                currentFile: !!currentFile,
+                semanticSearch: query ? true : false,
+                recentFiles: recentFiles.length > 0
+            }
+        };
+    } catch (error) {
+        console.error('Auto-context generation failed:', error.message);
+        return null;
+    }
+}
+
+// ============================================
+// Claude Code Integration
+// ============================================
+
+/**
+ * Generate CLAUDE.md with semantic context instructions
+ */
+async function generateClaudeIntegration(cwd = process.cwd()) {
+    const claudeMd = `# NamNam Semantic Context
+
+This project uses NamNam's semantic layer for enhanced code understanding.
+
+## Auto-Context
+
+The semantic index provides automatic context injection. When asking questions about this codebase:
+
+1. **Semantic Search**: Use \`namnam sem search "<query>"\` to find relevant code
+2. **Ask Questions**: Use \`namnam sem ask "<question>"\` for RAG-powered answers
+3. **Find Similar**: Use \`namnam sem similar <file>\` to find related code
+
+## Context Generation
+
+For any task, generate relevant context with:
+\`\`\`bash
+namnam sem context "<your task description>"
+\`\`\`
+
+This will output relevant code snippets that you should consider when working on the task.
+
+## Configuration
+
+- Embedding: Ollama (local) / OpenAI / Voyage
+- LLM: Ollama (local) / OpenAI / Anthropic
+- Run \`namnam sem config --show\` to see current settings
+
+## Auto-Index Status
+
+The semantic index is automatically maintained. Check status with:
+\`\`\`bash
+namnam sem stats
+\`\`\`
+`;
+
+    const claudePath = path.join(cwd, '.claude', 'docs', 'SEMANTIC.md');
+    await fs.ensureDir(path.dirname(claudePath));
+    await fs.writeFile(claudePath, claudeMd);
+
+    return claudePath;
+}
+
+/**
+ * Create a hook file that Claude Code can use to get context
+ */
+async function createContextHook(cwd = process.cwd()) {
+    const hookContent = `#!/usr/bin/env node
+/**
+ * NamNam Semantic Context Hook
+ * 
+ * This script is called by Claude Code to get relevant context.
+ * Usage: node .namnam/context-hook.js "<query>" [--current-file <file>]
+ */
+
+import { generateAutoContext } from './src/auto-semantic.js';
+
+const args = process.argv.slice(2);
+const query = args[0] || '';
+const currentFileIndex = args.indexOf('--current-file');
+const currentFile = currentFileIndex > -1 ? args[currentFileIndex + 1] : '';
+
+(async () => {
+  const result = await generateAutoContext({
+    query,
+    currentFile
+  });
+  
+  if (result) {
+    console.log(result.context);
+  }
+})();
+`;
+
+    const hookPath = path.join(cwd, '.namnam', 'hooks', 'context-hook.js');
+    await fs.ensureDir(path.dirname(hookPath));
+    await fs.writeFile(hookPath, hookContent);
+
+    return hookPath;
+}
+
+// ============================================
+// Exports
+// ============================================
+
+export {
+    // Config
+    getAutoConfig,
+    saveAutoConfig,
+    isAutoSemanticEnabled,
+    DEFAULT_AUTO_CONFIG,
+
+    // Auto-index
+    runAutoIndex,
+
+    // File watcher
+    startWatcher,
+    stopWatcher,
+    updateIndexIncremental,
+
+    // Auto-context
+    generateAutoContext,
+
+    // Claude integration
+    generateClaudeIntegration,
+    createContextHook
+};
+
+export default {
+    runAutoIndex,
+    startWatcher,
+    stopWatcher,
+    generateAutoContext,
+    generateClaudeIntegration
+};