@twelvehart/supermemory-runtime 1.0.0-next.1 → 1.0.0-next.3

package/Dockerfile

@@ -0,0 +1,120 @@
+# =============================================================================
+# SuperMemory Clone API - Multi-stage Dockerfile
+# =============================================================================
+# This Dockerfile uses a multi-stage build for optimal image size:
+# - Stage 1 (deps): Install all dependencies
+# - Stage 2 (builder): Build TypeScript to JavaScript
+# - Stage 3 (runner): Production runtime with minimal footprint
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Stage 1: Dependencies
+# -----------------------------------------------------------------------------
+# Install all dependencies including devDependencies for building
+FROM node:20-alpine AS deps
+
+# Install build dependencies required for native modules (better-sqlite3)
+# - python3 and make are needed for node-gyp
+# - g++ is the C++ compiler
+# - libc6-compat ensures glibc compatibility
+RUN apk add --no-cache python3 make g++ libc6-compat
+
+WORKDIR /app
+
+# Copy package files for dependency installation
+# This layer is cached unless package*.json changes
+COPY package.json package-lock.json ./
+
+# Install all dependencies (including dev for TypeScript compilation)
+# Use --legacy-peer-deps if you encounter peer dependency issues
+RUN npm ci
+
+# -----------------------------------------------------------------------------
+# Stage 2: Builder
+# -----------------------------------------------------------------------------
+# Compile TypeScript to JavaScript
+FROM node:20-alpine AS builder
+
+WORKDIR /app
+
+# Copy dependencies from deps stage
+COPY --from=deps /app/node_modules ./node_modules
+
+# Copy source code and configuration files
+COPY package.json package-lock.json tsconfig.json ./
+COPY src ./src
+COPY drizzle.config.ts ./
+
+# Build TypeScript
+RUN npm run build
+
+# Generate drizzle migrations if schema exists
+# This ensures migrations are available in production
+RUN npm run db:generate || true
+
+# Prune dev dependencies for production
+# This removes TypeScript, test frameworks, etc.
+RUN npm prune --production
+
+# -----------------------------------------------------------------------------
+# Stage 3: Production Runner
+# -----------------------------------------------------------------------------
+# Minimal production image
+FROM node:20-alpine AS runner
+
+# Add labels for container metadata
+LABEL org.opencontainers.image.title="SuperMemory Clone API"
+LABEL org.opencontainers.image.description="Personal AI memory assistant with semantic search"
+LABEL org.opencontainers.image.version="1.0.0"
+LABEL org.opencontainers.image.vendor="SuperMemory Clone"
+
+# Install runtime dependencies only
+# - libc6-compat: Required for better-sqlite3 native bindings
+# - tini: Proper init system for signal handling in containers
+RUN apk add --no-cache libc6-compat tini
+
+# Create non-root user for security
+# Running as root in containers is a security risk
+RUN addgroup --system --gid 1001 nodejs && \
+    adduser --system --uid 1001 supermemory
+
+WORKDIR /app
+
+# Create data directory for SQLite database
+# This directory should be mounted as a volume in production
+RUN mkdir -p /app/data && chown -R supermemory:nodejs /app/data
+
+# Copy production files from builder
+COPY --from=builder --chown=supermemory:nodejs /app/node_modules ./node_modules
+COPY --from=builder --chown=supermemory:nodejs /app/dist ./dist
+COPY --from=builder --chown=supermemory:nodejs /app/package.json ./
+COPY --from=builder --chown=supermemory:nodejs /app/drizzle ./drizzle
+
+# Copy entrypoint script
+COPY --chown=supermemory:nodejs scripts/docker-entrypoint.sh /app/docker-entrypoint.sh
+RUN chmod +x /app/docker-entrypoint.sh
+
+# Switch to non-root user
+USER supermemory
+
+# Set environment variables
+# NODE_ENV=production enables production optimizations
+ENV NODE_ENV=production
+ENV API_HOST=0.0.0.0
+ENV API_PORT=3000
+
+# Expose API port
+EXPOSE 3000
+
+# Health check to verify the container is running properly
+# Checks the /health endpoint every 30 seconds
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
+
+# Use tini as init system for proper signal handling
+# This ensures SIGTERM is properly forwarded to Node.js
+ENTRYPOINT ["/sbin/tini", "--"]
+
+# Run with node directly (not npm) for proper signal handling
+# npm doesn't forward signals properly to child processes
+CMD ["/app/docker-entrypoint.sh"]

package/README.md

@@ -33,12 +33,12 @@ It stores documents, extracts memories, indexes embeddings, and serves search/pr
 Primary path for first-time users:
 
 ```bash
-npx -y @twelvehart/supermemory@latest full --dir ./supermemory --mcp project
-cd ./supermemory
+npx -y @twelvehart/supermemory@latest full --mcp project
+cd ~/.supermemory
 claude
 ```
 
-That command unpacks the runtime into `./supermemory`, runs the canonical `scripts/install.sh` from the final directory, registers Claude MCP against that final path, and prints only the next steps a new user can actually take.
+That command unpacks the runtime into `~/.supermemory`, runs the canonical `scripts/install.sh` from the final directory, registers Claude MCP against that final path, and prints only the next steps a new user can actually take.
 
 The npx installer supports:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@twelvehart/supermemory-runtime",
-  "version": "1.0.0-next.1",
+  "version": "1.0.0-next.3",
   "description": "A personal AI memory assistant - supermemory.ai clone",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,6 +8,7 @@
   "files": [
     "README.md",
     ".env.example",
+    "Dockerfile",
     "package-lock.json",
     "src",
     "scripts",

package/scripts/check-runtime-pack.ts

@@ -14,6 +14,7 @@ interface PackResult {
 
 const REQUIRED_PATHS = [
   '.env.example',
+  'Dockerfile',
   'docker-compose.prod.yml',
   'docker-compose.yml',
   'package.json',

package/scripts/install.sh

@@ -5,6 +5,14 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 REPO_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
 cd "$REPO_ROOT"
 
+if [[ -d "$HOME/.local/bin" ]]; then
+  PATH="$HOME/.local/bin:$PATH"
+fi
+
+if [[ -d "/usr/local/bin" ]]; then
+  PATH="/usr/local/bin:$PATH"
+fi
+
 ACTION="install"
 INSTALL_MODE="agent"
 ENV_FILE=""

package/scripts/mcp-setup.ts

@@ -2,7 +2,8 @@
 import { execSync } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
 import { createInterface } from 'node:readline';
-import { resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { delimiter, resolve } from 'node:path';
 import pkg from 'pg';
 import { loadEnvFile } from '../src/config/env.js';
 import {
@@ -52,9 +53,26 @@ function formatRemovalCommand(scope: ClaudeMcpScope): string {
   return `claude mcp remove --scope ${scope} supermemory`;
 }
 
+function createCommandEnv(): NodeJS.ProcessEnv {
+  const preferredPaths = [`${homedir()}/.local/bin`, '/usr/local/bin'];
+  const currentPath = process.env.PATH ?? '';
+  const mergedPath = [...preferredPaths, currentPath]
+    .filter(Boolean)
+    .join(delimiter);
+
+  return {
+    ...process.env,
+    PATH: mergedPath,
+  };
+}
+
 function commandExists(name: string): boolean {
   try {
-    execSync(`command -v ${name}`, { stdio: 'ignore', shell: '/bin/zsh' });
+    execSync(`command -v ${name}`, {
+      env: createCommandEnv(),
+      stdio: 'ignore',
+      shell: '/bin/zsh',
+    });
     return true;
   } catch {
     return false;
@@ -162,7 +180,7 @@ async function run(): Promise<void> {
     if (answer === '' || answer.toLowerCase() === 'y') {
       console.log('Building...');
       try {
-        execSync('npm run build', { stdio: 'inherit' });
+        execSync('npm run build', { env: createCommandEnv(), stdio: 'inherit' });
       } catch {
         console.error('Build failed. Fix errors and try again.');
         process.exit(1);
@@ -238,7 +256,7 @@ async function run(): Promise<void> {
     const removeCmd = formatRemovalCommand(selectedScope);
     console.log(`[INFO] Existing ${selectedScope} scope registration does not match the current build output; repairing with: ${removeCmd} && ${cmd}`);
     try {
-      execSync(removeCmd, { stdio: 'inherit', shell: '/bin/zsh' });
+      execSync(removeCmd, { env: createCommandEnv(), stdio: 'inherit', shell: '/bin/zsh' });
     } catch (error) {
       const msg = error instanceof Error ? error.message : String(error);
       console.error(`\nCould not remove the existing ${selectedScope} scope registration: ${msg}`);
@@ -250,6 +268,7 @@ async function run(): Promise<void> {
 
   try {
     execSync(`claude mcp add supermemory --scope ${selectedScope} -- node ${JSON.stringify(entryPoint)}`, {
+      env: createCommandEnv(),
       stdio: 'inherit',
       shell: '/bin/zsh',
     });

package/scripts/migrations/run_migrations.sh

@@ -31,6 +31,25 @@ fi
 # Database URL from environment or default
 DATABASE_URL="${DATABASE_URL:-postgresql://supermemory:supermemory_secret@localhost:15432/supermemory}"
 
+run_drizzle_migrations() {
+    print_info "Applying Drizzle schema migrations..."
+
+    if ! command -v npm >/dev/null 2>&1; then
+        print_error "npm is required to run Drizzle migrations"
+        return 1
+    fi
+
+    if ! (cd "$PROJECT_ROOT" && npm run db:migrate > /dev/null 2>&1); then
+        print_error "Drizzle schema migration failed"
+        print_info "Run with verbose mode from the project root:"
+        print_info "  npm run db:migrate"
+        return 1
+    fi
+
+    print_success "Drizzle schema migration completed"
+    return 0
+}
+
 # Check if DATABASE_URL is set
 if [ -z "$DATABASE_URL" ]; then
     echo -e "${RED}Error: DATABASE_URL not set${NC}"
@@ -122,7 +141,6 @@ run_migration() {
 run_all_migrations() {
     local migrations=(
         "001_create_pgvector_extension.sql"
-        "003_create_hnsw_index.sql"
     )
 
     print_info "Starting migration process..."
@@ -144,6 +162,35 @@ run_all_migrations() {
         echo ""
     done
 
+    if ! run_drizzle_migrations; then
+        print_error "Migration process aborted"
+        return 1
+    fi
+
+    echo ""
+
+    local optional_migrations=(
+        "003_create_hnsw_index.sql"
+    )
+
+    for migration in "${optional_migrations[@]}"; do
+        local migration_path="$MIGRATIONS_DIR/$migration"
+
+        if [ ! -f "$migration_path" ]; then
+            print_warning "Optional migration file not found: $migration"
+            continue
+        fi
+
+        if ! run_migration "$migration_path"; then
+            print_warning "Optional migration failed: $migration"
+            print_warning "Continuing because the core schema is already installed"
+            echo ""
+            continue
+        fi
+
+        echo ""
+    done
+
     print_success "All migrations completed successfully!"
     return 0
 }