neuronlayer 0.1.0 → 1.1.0

package/package.json

@@ -1,63 +1,67 @@
-{
-  "name": "neuronlayer",
-  "version": "0.1.0",
-  "description": "Persistent memory layer for AI coding assistants - MCP server that makes AI truly understand your codebase",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "neuronlayer": "dist/index.js"
-  },
-  "scripts": {
-    "build": "node esbuild.config.js",
-    "build:benchmark": "node esbuild.benchmark.cjs",
-    "build:all": "npm run build && npm run build:benchmark",
-    "dev": "node --watch dist/index.js",
-    "start": "node dist/index.js",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest",
-    "test:run": "vitest run",
-    "benchmark": "npm run build:all && node dist/benchmark/working-benchmark.js",
-    "benchmark:quick": "npm run build:all && node dist/benchmark/working-benchmark.js --quick",
-    "benchmark:full": "npm run build:all && node dist/benchmark/working-benchmark.js --iterations 50"
-  },
-  "keywords": [
-    "mcp",
-    "ai",
-    "memory",
-    "context",
-    "codebase",
-    "claude",
-    "embeddings",
-    "agent",
-    "coding-assistant",
-    "llm"
-  ],
-  "author": "Abhishek Arun Savakar <abhishek@savakar.com> (https://savakar.com)",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/abhisavakar/memorylayer.git"
-  },
-  "bugs": {
-    "url": "https://github.com/abhisavakar/memorylayer/issues"
-  },
-  "homepage": "https://github.com/abhisavakar/memorylayer#readme",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "@xenova/transformers": "^2.17.0",
-    "better-sqlite3": "^11.0.0",
-    "chokidar": "^3.6.0",
-    "glob": "^10.0.0",
-    "web-tree-sitter": "^0.22.0"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "^7.6.0",
-    "@types/node": "^20.0.0",
-    "esbuild": "^0.20.0",
-    "typescript": "^5.4.0",
-    "vitest": "^1.3.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
+{
+  "name": "neuronlayer",
+  "version": "1.1.0",
+  "description": "Turn any AI coding assistant into an intelligent one - MCP server with code intelligence, semantic search, and persistent memory",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "neuronlayer": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node esbuild.config.js",
+    "build:benchmark": "node esbuild.benchmark.cjs",
+    "build:all": "npm run build && npm run build:benchmark",
+    "dev": "node --watch dist/index.js",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "benchmark": "npm run build:all && node dist/benchmark/working-benchmark.js",
+    "benchmark:quick": "npm run build:all && node dist/benchmark/working-benchmark.js --quick",
+    "benchmark:full": "npm run build:all && node dist/benchmark/working-benchmark.js --iterations 50"
+  },
+  "keywords": [
+    "mcp",
+    "ai",
+    "memory",
+    "context",
+    "codebase",
+    "claude",
+    "embeddings",
+    "agent",
+    "coding-assistant",
+    "llm"
+  ],
+  "author": "Abhishek Arun Savakar <abhishek@savakar.com> (https://savakar.com)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/abhisavakar/neuronlayer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/abhisavakar/neuronlayer/issues"
+  },
+  "homepage": "https://github.com/abhisavakar/neuronlayer#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "@xenova/transformers": "^2.17.0",
+    "better-sqlite3": "^11.8.0",
+    "chokidar": "^4.0.0",
+    "glob": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.25.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/CONTRIBUTING.md

@@ -1,127 +0,0 @@
-# Contributing to MemoryLayer
-
-Thank you for your interest in contributing to MemoryLayer! This document provides guidelines and information for contributors.
-
-## Code of Conduct
-
-Be respectful, inclusive, and constructive. We're all here to build something great together.
-
-## How to Contribute
-
-### Reporting Bugs
-
-1. Check existing issues to avoid duplicates
-2. Use a clear, descriptive title
-3. Include:
-   - Steps to reproduce
-   - Expected vs actual behavior
-   - Environment (OS, Node.js version)
-   - Relevant logs or error messages
-
-### Suggesting Features
-
-1. Check if the feature is already planned (see Roadmap in README)
-2. Open an issue with `[Feature]` prefix
-3. Describe the use case and proposed solution
-4. Be open to discussion and alternatives
-
-### Pull Requests
-
-1. Fork the repository
-2. Create a feature branch from `main`
-3. Make your changes
-4. Write/update tests as needed
-5. Run `npm run typecheck` and `npm test`
-6. Submit a PR with a clear description
-
-## Development Setup
-
-```bash
-# Clone your fork
-git clone https://github.com/YOUR_USERNAME/memorylayer.git
-cd memorylayer
-
-# Install dependencies
-npm install
-
-# Build
-npm run build
-
-# Run tests
-npm test
-
-# Type check
-npm run typecheck
-```
-
-## Project Structure
-
-```
-src/
-├── core/           # Business logic (engine, features)
-├── server/         # MCP server and tools
-├── storage/        # Data persistence (SQLite, vectors)
-├── indexing/       # File indexing and AST
-├── types/          # TypeScript type definitions
-├── utils/          # Shared utilities
-└── agent/          # Standalone agent (optional)
-```
-
-## Coding Standards
-
-### TypeScript
-
-- Use TypeScript strict mode
-- Prefer explicit types over `any`
-- Use interfaces for object shapes
-- Export types from `src/types/`
-
-### Code Style
-
-- Use meaningful variable/function names
-- Keep functions focused and small
-- Add comments for non-obvious logic
-- Follow existing patterns in the codebase
-
-### Testing
-
-- Write tests for new features
-- Tests go in `__tests__/` directories or `*.test.ts` files
-- Use Vitest for testing
-
-### Commits
-
-- Use clear, descriptive commit messages
-- Follow conventional commits when possible:
-  - `feat:` new features
-  - `fix:` bug fixes
-  - `docs:` documentation
-  - `refactor:` code restructuring
-  - `test:` test additions/changes
-
-## Areas Where Help Is Needed
-
-### High Priority
-
-1. **Language Support** - Add AST parsing for Python, Go, Rust
-2. **Bug Fixes** - Check open issues
-3. **Test Coverage** - Increase test coverage
-
-### Medium Priority
-
-1. **Documentation** - Improve README, add examples
-2. **Performance** - Optimize indexing and search
-3. **IDE Extensions** - VS Code extension
-
-### Good First Issues
-
-Look for issues labeled `good-first-issue` for beginner-friendly tasks.
-
-## Questions?
-
-- Open a Discussion on GitHub
-- Check existing issues and documentation
-
-## License
-
-By contributing, you agree that your contributions will be licensed under the MIT License.

package/esbuild.config.js

@@ -1,26 +0,0 @@
-import { build } from 'esbuild';
-
-const commonOptions = {
-  bundle: true,
-  platform: 'node',
-  target: 'node18',
-  format: 'esm',
-  sourcemap: true,
-  external: [
-    'better-sqlite3',    // Native module
-    '@xenova/transformers', // Large, keep external
-    'chokidar',          // Uses CommonJS require
-    'glob',              // Keep external
-    'web-tree-sitter'    // WASM module
-  ]
-};
-
-// Build main MCP server
-await build({
-  ...commonOptions,
-  entryPoints: ['src/index.ts'],
-  outfile: 'dist/index.js',
-  banner: { js: '#!/usr/bin/env node' },
-});
-
-console.log('Build complete!');

package/src/cli/commands.ts

@@ -1,382 +0,0 @@
-import { ProjectManager, type ProjectInfo } from '../core/project-manager.js';
-import { ADRExporter } from '../core/adr-exporter.js';
-import { initializeDatabase } from '../storage/database.js';
-import { Tier2Storage } from '../storage/tier2.js';
-import { join } from 'path';
-import { existsSync } from 'fs';
-
-const projectManager = new ProjectManager();
-
-interface CommandResult {
-  success: boolean;
-  message: string;
-  data?: unknown;
-}
-
-// List all projects
-export function listProjects(): CommandResult {
-  const projects = projectManager.listProjects();
-  const activeProject = projectManager.getActiveProject();
-
-  if (projects.length === 0) {
-    return {
-      success: true,
-      message: 'No projects registered. Use "memorylayer projects add <path>" to add one.'
-    };
-  }
-
-  const lines = ['Registered Projects:', ''];
-  for (const project of projects) {
-    const isActive = activeProject?.id === project.id ? ' (active)' : '';
-    lines.push(`  ${project.name}${isActive}`);
-    lines.push(`    ID: ${project.id}`);
-    lines.push(`    Path: ${project.path}`);
-    lines.push(`    Files: ${project.totalFiles}, Decisions: ${project.totalDecisions}`);
-    lines.push(`    Languages: ${project.languages.join(', ') || 'N/A'}`);
-    lines.push('');
-  }
-
-  return {
-    success: true,
-    message: lines.join('\n'),
-    data: projects
-  };
-}
-
-// Add a project
-export function addProject(projectPath: string): CommandResult {
-  try {
-    const projectInfo = projectManager.registerProject(projectPath);
-    projectManager.setActiveProject(projectInfo.id);
-
-    return {
-      success: true,
-      message: `Project "${projectInfo.name}" registered and set as active.\nID: ${projectInfo.id}\nData directory: ${projectInfo.dataDir}`,
-      data: projectInfo
-    };
-  } catch (error) {
-    return {
-      success: false,
-      message: `Failed to add project: ${error instanceof Error ? error.message : String(error)}`
-    };
-  }
-}
-
-// Remove a project
-export function removeProject(projectId: string): CommandResult {
-  const project = projectManager.getProject(projectId);
-
-  if (!project) {
-    return {
-      success: false,
-      message: `Project not found: ${projectId}`
-    };
-  }
-
-  const removed = projectManager.removeProject(projectId);
-
-  return {
-    success: removed,
-    message: removed
-      ? `Project "${project.name}" removed from registry.`
-      : `Failed to remove project.`
-  };
-}
-
-// Switch to a project
-export function switchProject(projectId: string): CommandResult {
-  const project = projectManager.getProject(projectId);
-
-  if (!project) {
-    return {
-      success: false,
-      message: `Project not found: ${projectId}`
-    };
-  }
-
-  const switched = projectManager.setActiveProject(projectId);
-
-  return {
-    success: switched,
-    message: switched
-      ? `Switched to project: ${project.name}`
-      : `Failed to switch project.`
-  };
-}
-
-// Discover projects
-export function discoverProjects(): CommandResult {
-  const discovered = projectManager.discoverProjects();
-
-  if (discovered.length === 0) {
-    return {
-      success: true,
-      message: 'No projects discovered in common locations.'
-    };
-  }
-
-  const lines = [`Discovered ${discovered.length} potential projects:`, ''];
-  for (const path of discovered) {
-    const name = path.split(/[/\\]/).pop();
-    lines.push(`  ${name}`);
-    lines.push(`    ${path}`);
-    lines.push('');
-  }
-  lines.push('Use "memorylayer projects add <path>" to register a project.');
-
-  return {
-    success: true,
-    message: lines.join('\n'),
-    data: discovered
-  };
-}
-
-// Export decisions to ADR
-export function exportDecisions(
-  projectPath?: string,
-  options: { outputDir?: string; format?: 'madr' | 'nygard' | 'simple' } = {}
-): CommandResult {
-  // Determine project path
-  let targetPath = projectPath;
-  if (!targetPath) {
-    const activeProject = projectManager.getActiveProject();
-    if (!activeProject) {
-      return {
-        success: false,
-        message: 'No project specified and no active project. Use "memorylayer projects switch <id>" first.'
-      };
-    }
-    targetPath = activeProject.path;
-  }
-
-  // Get project info
-  const projectInfo = projectManager.getProjectByPath(targetPath);
-  if (!projectInfo) {
-    return {
-      success: false,
-      message: `Project not registered: ${targetPath}. Use "memorylayer projects add ${targetPath}" first.`
-    };
-  }
-
-  // Open database and get decisions
-  const dbPath = join(projectInfo.dataDir, 'memorylayer.db');
-  if (!existsSync(dbPath)) {
-    return {
-      success: false,
-      message: `Project database not found. Has the project been indexed?`
-    };
-  }
-
-  const db = initializeDatabase(dbPath);
-  const tier2 = new Tier2Storage(db);
-  const decisions = tier2.getAllDecisions();
-  db.close();
-
-  if (decisions.length === 0) {
-    return {
-      success: true,
-      message: 'No decisions to export.'
-    };
-  }
-
-  // Export
-  const exporter = new ADRExporter(targetPath);
-  const exportedFiles = exporter.exportAllDecisions(decisions, {
-    outputDir: options.outputDir,
-    format: options.format,
-    includeIndex: true
-  });
-
-  return {
-    success: true,
-    message: `Exported ${exportedFiles.length} ADR files to ${options.outputDir || join(targetPath, 'docs', 'decisions')}`,
-    data: exportedFiles
-  };
-}
-
-// Show project info
-export function showProject(projectId?: string): CommandResult {
-  let project: ProjectInfo | null;
-
-  if (projectId) {
-    project = projectManager.getProject(projectId);
-  } else {
-    project = projectManager.getActiveProject();
-  }
-
-  if (!project) {
-    return {
-      success: false,
-      message: projectId
-        ? `Project not found: ${projectId}`
-        : 'No active project. Use "memorylayer projects switch <id>" first.'
-    };
-  }
-
-  const lines = [
-    `Project: ${project.name}`,
-    `ID: ${project.id}`,
-    `Path: ${project.path}`,
-    `Data Directory: ${project.dataDir}`,
-    `Files Indexed: ${project.totalFiles}`,
-    `Decisions: ${project.totalDecisions}`,
-    `Languages: ${project.languages.join(', ') || 'N/A'}`,
-    `Last Accessed: ${new Date(project.lastAccessed).toLocaleString()}`
-  ];
-
-  return {
-    success: true,
-    message: lines.join('\n'),
-    data: project
-  };
-}
-
-// Print help
-export function printHelp(): void {
-  console.log(`
-MemoryLayer CLI - Persistent Memory for AI Coding Assistants
-
-USAGE:
-  memorylayer [command] [options]
-
-COMMANDS:
-  (no command)              Start MCP server for Claude Desktop
-  projects list             List all registered projects
-  projects add <path>       Add a project to the registry
-  projects remove <id>      Remove a project from the registry
-  projects switch <id>      Set a project as active
-  projects show [id]        Show project details
-  projects discover         Discover projects in common locations
-  export [options]          Export decisions to ADR files
-  help                      Show this help message
-
-OPTIONS:
-  --project, -p <path>      Path to the project directory
-  --output, -o <dir>        Output directory for exports
-  --format <type>           ADR format: madr, nygard, simple
-
-EXAMPLES:
-  # Start MCP server
-  memorylayer --project /path/to/project
-
-  # List all projects
-  memorylayer projects list
-
-  # Add a new project
-  memorylayer projects add /path/to/my-project
-
-  # Switch active project
-  memorylayer projects switch abc123
-
-  # Export decisions to ADR files
-  memorylayer export --format madr
-
-  # Discover projects
-  memorylayer projects discover
-
-For more information, visit: https://github.com/your-org/memorylayer
-`);
-}
-
-// Parse and execute CLI commands
-export function executeCLI(args: string[]): void {
-  const command = args[0];
-  const subcommand = args[1];
-
-  switch (command) {
-    case 'help':
-    case '--help':
-    case '-h':
-      printHelp();
-      break;
-
-    case 'projects': {
-      switch (subcommand) {
-        case 'list':
-          console.log(listProjects().message);
-          break;
-        case 'add': {
-          const path = args[2];
-          if (!path) {
-            console.error('Error: Project path required.');
-            console.error('Usage: memorylayer projects add <path>');
-            process.exit(1);
-          }
-          const result = addProject(path);
-          console.log(result.message);
-          if (!result.success) process.exit(1);
-          break;
-        }
-        case 'remove': {
-          const id = args[2];
-          if (!id) {
-            console.error('Error: Project ID required.');
-            console.error('Usage: memorylayer projects remove <id>');
-            process.exit(1);
-          }
-          const result = removeProject(id);
-          console.log(result.message);
-          if (!result.success) process.exit(1);
-          break;
-        }
-        case 'switch': {
-          const id = args[2];
-          if (!id) {
-            console.error('Error: Project ID required.');
-            console.error('Usage: memorylayer projects switch <id>');
-            process.exit(1);
-          }
-          const result = switchProject(id);
-          console.log(result.message);
-          if (!result.success) process.exit(1);
-          break;
-        }
-        case 'show': {
-          const id = args[2];
-          const result = showProject(id);
-          console.log(result.message);
-          if (!result.success) process.exit(1);
-          break;
-        }
-        case 'discover':
-          console.log(discoverProjects().message);
-          break;
-        default:
-          console.error(`Unknown subcommand: ${subcommand}`);
-          console.error('Available: list, add, remove, switch, show, discover');
-          process.exit(1);
-      }
-      break;
-    }
-
-    case 'export': {
-      // Parse export options
-      let outputDir: string | undefined;
-      let format: 'madr' | 'nygard' | 'simple' | undefined;
-
-      for (let i = 1; i < args.length; i++) {
-        const arg = args[i];
-        const nextArg = args[i + 1];
-        if ((arg === '--output' || arg === '-o') && nextArg) {
-          outputDir = nextArg;
-          i++;
-        } else if (arg === '--format' && nextArg) {
-          format = nextArg as 'madr' | 'nygard' | 'simple';
-          i++;
-        }
-      }
-
-      const result = exportDecisions(undefined, { outputDir, format });
-      console.log(result.message);
-      if (!result.success) process.exit(1);
-      break;
-    }
-
-    default:
-      // If no command matches, it might be the default MCP server mode
-      // Return without handling - let main() handle it
-      return;
-  }
-
-  process.exit(0);
-}