squish-memory 1.0.0 → 1.0.2

package/dist/db/index.d.ts

@@ -1,6 +1,10 @@
 import { createDb } from './adapter.js';
 import { config } from '../config.js';
-export declare function getDb(): Promise<any>;
+export declare function getDb(): Promise<(import("drizzle-orm/node-postgres").NodePgDatabase<typeof import("../drizzle/schema.js")> & {
+    $client: import("pg").Pool;
+}) | (import("drizzle-orm/better-sqlite3").BetterSQLite3Database<typeof import("../drizzle/schema-sqlite.js")> & {
+    $client: import("better-sqlite3").Database;
+}) | import("drizzle-orm/sql-js").SQLJsDatabase<typeof import("../drizzle/schema-sqlite.js")>>;
 export declare function checkDatabaseHealth(): Promise<boolean>;
 export { config };
 export { createDb };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Squish v1.0.0 - Universal Memory Plugin System
+ * Squish v1.0.2 - Universal Memory Plugin System
  *
  * Modes:
  * - CLI Mode: For any MCP client bash execution (e.g., `squish remember "text"`)

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Squish v1.0.0 - Universal Memory Plugin System
+ * Squish v1.0.2 - Universal Memory Plugin System
  *
  * Modes:
  * - CLI Mode: For any MCP client bash execution (e.g., `squish remember "text"`)
@@ -17,6 +17,7 @@
  */
 import 'dotenv/config';
 import fs from 'node:fs';
+import { existsSync } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -48,11 +49,12 @@ import { searchWithQMD, isQMDAvailable } from './core/search/qmd-search.js';
 import { initializeCoreMemory, getCoreMemory, editCoreMemorySection, appendCoreMemorySection, getCoreMemoryStats, } from './core/core-memory.js';
 import { loadMemoryToContext, evictMemoryFromContext, viewLoadedMemories, getContextStatus, } from './core/context-paging.js';
 import { ensureDataDirectory } from './db/bootstrap.js';
+import { getDataDir } from './config.js';
 import { performAutoLoad, shouldAutoLoad, getAutoLoadConfig } from './core/session/auto-load.js';
 import { initializeScheduler, registerJobHandler } from './core/scheduler/cron-scheduler.js';
 import { startHeartbeatChecking, heartbeat } from './core/scheduler/heartbeat.js';
 import { runNightlyJob, runWeeklyJob } from './core/scheduler/job-runner.js';
-const VERSION = '1.0.0';
+const VERSION = '1.0.2';
 // Load plugin manifest for self-verification
 function loadPluginManifest() {
     try {
@@ -89,21 +91,197 @@ function verifyManifest(manifest) {
     return { ok: errors.length === 0, errors };
 }
 // ============================================================================
-// CLI MODE DETECTION
+// HELPER FUNCTIONS
 // ============================================================================
-const args = process.argv.slice(2);
-const hasCliArgs = args.length > 0 && args[0] !== '--mcp';
-if (hasCliArgs) {
-    // === CLI MODE (for OpenClaw) ===
-    runCliMode().catch((e) => {
-        console.error(JSON.stringify({ error: e.message }, null, 2));
+function showHelp() {
+    console.log(`
+Squish Memory v${VERSION} - Universal Memory Plugin System
+
+Usage:
+  squish                      Start interactive wizard
+  squish run mcp              Start MCP server
+  squish run web              Start Web UI only
+  squish <command> [options]  Run CLI commands for agents
+
+CLI Commands (for agents):
+  squish remember <content>   Store a memory
+  squish search <query>       Search memories
+  squish health               Check system health
+  squish stats                View statistics
+  squish core_memory          Manage core memory
+
+Examples:
+  squish run mcp              # Start MCP server (for Claude Code)
+  squish run web              # Start Web UI only
+  squish remember "Hello"     # Store memory via CLI
+  squish search "query"       # Search memories via CLI
+
+For more info: https://github.com/michielhdoteth/squish
+`);
+}
+async function runInteractiveInstaller() {
+    const { select } = await import('@clack/prompts');
+    const { isCancel } = await import('@clack/prompts');
+    const { log } = await import('@clack/prompts');
+    const { intro, outro } = await import('@clack/prompts');
+    intro(`Squish Memory v${VERSION}`);
+    const options = [
+        { value: 'mcp', label: 'Start MCP Server (for AI Assistants: Claude Code, OpenCode, etc.)' },
+        { value: 'web', label: 'Start Web UI Only' },
+        { value: 'health', label: 'Health & Stats' },
+        { value: 'help', label: 'Show Help' },
+        { value: 'exit', label: 'Exit' }
+    ];
+    const selected = await select({
+        message: 'What would you like to do?',
+        options: options,
+    });
+    if (isCancel(selected)) {
+        outro('Cancelled');
+        process.exit(0);
+        return;
+    }
+    switch (selected) {
+        case 'mcp':
+            log.step('Starting MCP server...');
+            await runMcpMode();
+            break;
+        case 'web':
+            log.step('Starting Web UI...');
+            await runWebOnly();
+            break;
+        case 'health':
+            log.step('Checking health...');
+            await runCliCommand('health');
+            await runCliCommand('stats');
+            break;
+        case 'help':
+            showHelp();
+            process.exit(0);
+            break;
+        case 'exit':
+            outro('Goodbye! 👋');
+            process.exit(0);
+            break;
+    }
+}
+async function runCliCommand(command) {
+    // Run CLI command programmatically
+    const program = new Command();
+    program.hook('preAction', async () => {
+        await ensureDataDirectory();
+    });
+    if (command === 'health') {
+        const dbHealth = await checkDatabaseHealth();
+        const redisHealth = await checkRedisHealth();
+        const dataDir = process.env.SQUISH_DATA_DIR || path.join(os.homedir(), '.squish');
+        const dirExists = fs.existsSync(dataDir);
+        console.log(`\n  Squish Memory v${VERSION}`);
+        console.log(`  ====================`);
+        console.log(`  Mode:     ${config.isTeamMode ? 'team' : 'local'}`);
+        console.log(`  Database: ${dbHealth ? 'ok' : 'error'}`);
+        console.log(`  Cache:    ${redisHealth ? 'ok' : 'unavailable'}`);
+        console.log(`  Data Dir: ${dataDir}`);
+        console.log(`  Status:   ${dbHealth ? 'HEALTHY' : 'UNHEALTHY'}\n`);
+    }
+    else if (command === 'stats') {
+        const stats = await getMemoryStats(process.cwd());
+        console.log(JSON.stringify({ ok: true, ...stats }, null, 2));
+    }
+}
+async function spawnInstallerWizard() {
+    const distDir = path.dirname(fileURLToPath(import.meta.url));
+    const packageDir = path.dirname(distDir);
+    const installScript = path.join(packageDir, 'scripts', 'install-interactive.mjs');
+    if (!fs.existsSync(installScript)) {
+        console.error('Installer not found at:', installScript);
         process.exit(1);
+    }
+    console.log('\nLaunching full installer wizard...\n');
+    const result = spawnSync('node', [`"${installScript}"`], {
+        stdio: 'inherit',
+        shell: true,
+        cwd: packageDir
     });
+    process.exit(result.status || 0);
+}
+function isDatabaseInitialized() {
+    try {
+        const dataDir = getDataDir();
+        const dbPath = path.join(dataDir, 'squish.db');
+        return existsSync(dataDir) && existsSync(dbPath);
+    }
+    catch (error) {
+        return false;
+    }
+}
+async function runWebOnly() {
+    console.log(`[squish] Starting Web UI only...`);
+    await ensureDataDirectory();
+    startWebServer();
+}
+// ============================================================================
+// CLI MODE DETECTION
+// ============================================================================
+const args = process.argv.slice(2);
+const firstArg = args[0];
+// Detect command type
+const isNoArgs = args.length === 0;
+const isRunCommand = firstArg === 'run';
+const isHelpCommand = firstArg === '--help' || firstArg === '-h' || firstArg === 'help';
+if (isNoArgs) {
+    // Check if database exists - if not, run installer automatically
+    if (!isDatabaseInitialized()) {
+        console.log(`[squish] No existing database found. Launching installer wizard...\n`);
+        await spawnInstallerWizard();
+    }
+    else {
+        // === INTERACTIVE WIZARD (default when no args) ===
+        runInteractiveInstaller().catch((e) => {
+            console.error('Installer error:', e.message);
+            process.exit(1);
+        });
+    }
+}
+else if (isRunCommand) {
+    // === RUN SUBCOMMAND ===
+    const subcommand = args[1];
+    if (subcommand === 'mcp') {
+        runMcpMode().catch((e) => {
+            logger.error('Fatal error', e);
+            process.exit(1);
+        });
+    }
+    else if (subcommand === 'web') {
+        runWebOnly().catch((e) => {
+            logger.error('Web server error', e);
+            process.exit(1);
+        });
+    }
+    else {
+        console.log(`
+Usage: squish run <command>
+
+Commands:
+  mcp    Start MCP server
+  web    Start Web UI only
+
+Examples:
+  squish run mcp   # Start MCP server with web UI
+  squish run web   # Start Web UI only
+`);
+        process.exit(subcommand ? 1 : 0);
+    }
+}
+else if (isHelpCommand) {
+    // === SHOW HELP ===
+    showHelp();
+    process.exit(0);
 }
 else {
-    // === MCP MODE (for Claude Code) - DEFAULT ===
-    runMcpMode().catch((e) => {
-        logger.error('Fatal error', e);
+    // === CLI MODE (for agents/OpenClaw) ===
+    runCliMode().catch((e) => {
+        console.error(JSON.stringify({ error: e.message }, null, 2));
         process.exit(1);
     });
 }
@@ -365,7 +543,7 @@ async function runCliMode() {
     // squish stats
     program
         .command('stats')
-        .description('Get memory statistics')
+        .description('View statistics')
         .option('-p, --project <project>', 'Project path', process.cwd())
         .action(async (options) => {
         try {
@@ -377,44 +555,12 @@ async function runCliMode() {
             process.exit(1);
         }
     });
-    // squish install (for OpenClaw self-install)
+    // squish install
     program
         .command('install')
-        .description('Install Squish for OpenClaw (self-configure MCP)')
-        .option('-o, --openclaw-dir <dir>', 'OpenClaw directory')
-        .option('-n, --dry-run', 'Show what would be done without making changes', false)
-        .option('--skip-install', 'Skip global npm install step', false)
-        .action(async (options) => {
-        // Find the install script - it's in scripts/ relative to the package root
-        // When running from dist/index.js, scripts is at ../scripts/
-        const distDir = path.dirname(fileURLToPath(import.meta.url));
-        const packageDir = path.dirname(distDir);
-        const installScript = path.join(packageDir, 'scripts', 'install.mjs');
-        // Check if the script exists
-        if (!fs.existsSync(installScript)) {
-            console.log(JSON.stringify({
-                ok: false,
-                error: `Install script not found at: ${installScript}`,
-                hint: 'Please ensure squish-memory is installed correctly'
-            }, null, 2));
-            process.exit(1);
-        }
-        // Build command with quoted path for Windows compatibility
-        const args = [`"${installScript}"`];
-        if (options.dryRun)
-            args.push('--dry-run');
-        if (options.openclawDir)
-            args.push('--openclaw-dir', `"${options.openclawDir}"`);
-        if (options.skipInstall)
-            args.push('--skip-install');
-        const result = spawnSync('node', args, {
-            stdio: 'inherit',
-            shell: true,
-            cwd: packageDir
-        });
-        if (result.status !== 0) {
-            process.exit(result.status || 1);
-        }
+        .description('Run the interactive installer wizard')
+        .action(async () => {
+        await spawnInstallerWizard();
     });
     await program.parseAsync(process.argv);
 }

package/generated/mcp/manifest.json

@@ -1,23 +1,23 @@
-{
-  "mode": "universal",
-  "generatedAt": "2026-03-14T16:50:48.822Z",
-  "source": "config/mcp.json",
-  "files": [
-    {
-      "file": "mcp-servers.json",
-      "sha256": "2c90cc52893f55bc92cc4f29c77bfeeb635c1c73fa46038d287548caeb35ca6a"
-    },
-    {
-      "file": "mcporter.json",
-      "sha256": "af42e1c03d44f66fcbe2a9b7694f1d3a126527147c66b760236e72348e1e4573"
-    },
-    {
-      "file": "openclaw-memory-qmd.json",
-      "sha256": "8a158ff45e98e0db7a7aff41dba7be76652b72aea82443773f9efc7fb056d615"
-    },
-    {
-      "file": "runtime.json",
-      "sha256": "4afbdec03de92c6a29fc24df32f01305c2e9cf69ed2d02866a01e361492d14b6"
-    }
-  ]
-}
+{
+  "mode": "universal",
+  "generatedAt": "2026-03-18T18:13:29.152Z",
+  "source": "config/mcp.json",
+  "files": [
+    {
+      "file": "mcp-servers.json",
+      "sha256": "2c90cc52893f55bc92cc4f29c77bfeeb635c1c73fa46038d287548caeb35ca6a"
+    },
+    {
+      "file": "mcporter.json",
+      "sha256": "af42e1c03d44f66fcbe2a9b7694f1d3a126527147c66b760236e72348e1e4573"
+    },
+    {
+      "file": "openclaw-memory-qmd.json",
+      "sha256": "8a158ff45e98e0db7a7aff41dba7be76652b72aea82443773f9efc7fb056d615"
+    },
+    {
+      "file": "runtime.json",
+      "sha256": "4afbdec03de92c6a29fc24df32f01305c2e9cf69ed2d02866a01e361492d14b6"
+    }
+  ]
+}

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "squish-memory",
-  "version": "1.0.0",
-  "description": "Universal plugin architecture memory system - works as plugin across Claude Code, OpenClaw, OpenCode, Codex, Cursor, VSCode, Windsurf. MCP server with CLI fallback, QMD search, and two-tier storage.",
+  "version": "1.0.2",
+  "description": "Two-tier memory for AI agents: QMD-based fast file search (short-term) + SQLite/Postgres (long-term). Works out-of-the-box, no setup required.",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
     "squish": "dist/index.js",
     "squish-mcp": "dist/commands/mcp-server.js",
+    "squish-add": "bin/squish-add.mjs",
+    "squish-rm": "bin/squish-rm.mjs",
     "squish-install": "npx-installer.js",
     "squish-install-plugin": "scripts/install-plugin.mjs"
   },
@@ -15,14 +17,12 @@
     "build:plugins": "npm run build && npm run build:claude && npm run build:openclaw",
     "build:claude": "cp -r .claude-plugin packages/plugin-claude-code/",
     "build:openclaw": "mkdir -p packages/plugin-openclaw/dist && cp -r plugins/openclaw/* packages/plugin-openclaw/ && (cd packages/plugin-openclaw && npm run build 2>/dev/null || true)",
-    "build:mcp": "tsc commands/mcp-server.ts --outDir dist/commands --module ES2022 --moduleResolution node --esModuleInterop --target ES2022 --skipLibCheck",
-    "mcp:cjs": "esbuild commands/mcp-server.ts --bundle --platform=node --outfile=dist/commands/mcp-server.cjs --format=cjs --external:better-sqlite3 --external:pg --external:drizzle-orm/*",
     "start": "node dist/index.js",
-    "mcp": "node dist/commands/mcp-server.cjs",
+    "mcp": "node dist/commands/mcp-server.js",
     "web": "node dist/api/web/web-server.js",
     "web:bun": "bun run dist/api/web/web-server.js",
-    "dev": "bun --hot src/index.ts",
-    "dev:mcp": "bun --hot src/commands/mcp-server.ts",
+    "dev": "bun --hot index.ts",
+    "dev:mcp": "bun --hot commands/mcp-server.ts",
     "verify:mcp": "node scripts/verify-mcp.mjs",
     "preflight:remote": "node scripts/remote-preflight.mjs",
     "fallback:dry": "node scripts/squish-fallback.mjs --op health --simulate-mcp-failure --dry-run",
@@ -75,8 +75,6 @@
     "vscode",
     "plugin",
     "plugin-architecture",
-    "openclaw-plugin",
-    "claude-code-plugin",
     "qmd",
     "sqlite",
     "postgres",
@@ -86,83 +84,98 @@
     "local-first",
     "privacy",
     "agent-framework",
-    "agent-memory"
+    "agent-memory",
+    "ai-memory",
+    "agentic",
+    "context-window",
+    "long-term-memory",
+    "rag",
+    "vector-embeddings",
+    "session-persistence"
   ],
-   "files": [
-     "dist",
-     "scripts",
-     "!scripts/init-dirs.ts",
-     "skills",
-     "hooks",
-     "config",
-     "bin",
-     "generated",
-     "packages/plugin-claude-code/dist",
-     "packages/plugin-claude-code/package.json",
-     "packages/plugin-claude-code/README.md",
-     "packages/plugin-openclaw/dist",
-     "packages/plugin-openclaw/package.json",
-     "packages/plugin-openclaw/README.md",
-     "packages/plugin-openclaw/openclaw.plugin.json",
-     "packages/plugin-opencode/package.json",
-     "packages/plugin-opencode/install.mjs",
-     "plugin.json",
-     ".claude-plugin",
-     ".mcp.json",
-     ".env.mcp.example",
-     "LICENSE",
-     "README.md",
-     "CHANGELOG.md",
-     "QUICK-START.md",
-     "commands/context-paging.md",
-     "commands/context-status.md",
-     "commands/context.md",
-     "commands/core-memory.md",
-     "commands/health.md",
-     "commands/init.md",
-     "commands/merge.md",
-     "commands/observe.md",
-     "commands/recall.md",
-     "commands/remember.md",
-     "commands/search.md"
-   ],
-  "author": "michielhdoteth",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "dist/**/*.cjs",
+    "scripts",
+    "!scripts/init-dirs.ts",
+    "skills",
+    "hooks",
+    "config",
+    "bin",
+    "generated",
+    "packages/plugin-claude-code/dist/*.js",
+    "packages/plugin-claude-code/dist/*.d.ts",
+    "packages/plugin-claude-code/package.json",
+    "packages/plugin-claude-code/README.md",
+    "packages/plugin-openclaw/dist/*.js",
+    "packages/plugin-openclaw/dist/*.d.ts",
+    "packages/plugin-openclaw/package.json",
+    "packages/plugin-openclaw/README.md",
+    "packages/plugin-openclaw/openclaw.plugin.json",
+    "packages/plugin-opencode/package.json",
+    "packages/plugin-opencode/install.mjs",
+    "plugin.json",
+    ".claude-plugin",
+    ".mcp.json",
+    ".env.mcp.example",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md",
+    "QUICK-START.md",
+    "commands/context-paging.md",
+    "commands/context-status.md",
+    "commands/context.md",
+    "commands/core-memory.md",
+    "commands/health.md",
+    "commands/init.md",
+    "commands/merge.md",
+    "commands/observe.md",
+    "commands/recall.md",
+    "commands/remember.md",
+    "commands/search.md"
+  ],
+  "author": "michielhdoteth <michiel@4mlabs.io>",
   "license": "MIT",
   "engines": {
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.27.1",
+    "@clack/prompts": "^0.7.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "better-sqlite3": "12.6.2",
     "bull": "^4.16.0",
     "commander": "^12.0.0",
     "cors": "2.8.6",
     "dotenv": "^16.4.0",
     "drizzle-orm": "^0.38.0",
-    "express": "^4.21.0",
-    "pg": "8.19.0",
+    "express": "^5.2.1",
+    "express-rate-limit": "^8.3.1",
+    "hono": "^4.12.8",
+    "node-cron": "^3.0.0",
+    "pg": "^8.20.0",
     "pgvector": "^0.2.0",
-    "redis": "^4.7.0",
+    "picocolors": "^1.0.0",
+    "redis": "^5.11.0",
+    "sql.js": "^1.14.1",
     "tree-sitter": "^0.22.0",
     "tree-sitter-javascript": "^0.23.0",
     "tree-sitter-python": "^0.23.0",
     "tree-sitter-typescript": "^0.23.0",
-    "uuid": "^9.0.1",
+    "uuid": "^13.0.0",
     "ws": "^8.18.0",
-    "zod": "^3.24.0",
-    "node-cron": "^3.0.0"
+    "zod": "^3.24.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/cors": "^2.8.17",
     "@types/express": "^5.0.0",
     "@types/node": "^22.0.0",
-    "@types/pg": "^8.11.10",
     "@types/node-cron": "^3.0.11",
+    "@types/pg": "^8.11.10",
     "@types/ws": "^8.5.13",
     "drizzle-kit": "^0.30.0",
     "pkg": "^5.8.1",
-    "typescript": "^5.7.0",
-    "vitest": "^4.0.17"
+    "typescript": "^5.7.0"
   }
 }

package/scripts/install-interactive.mjs

@@ -116,7 +116,8 @@ function parseArgs(argv) {
     dryRun: false,
     help: false,
     verbose: false,
-    quick: false
+    quick: false,
+    interactive: false
   };
   
   for (let i = 2; i < argv.length; i++) {
@@ -136,6 +137,8 @@ function parseArgs(argv) {
       flags.help = true;
     } else if (token === "--quick" || token === "-q") {
       flags.quick = true;
+    } else if (token === "--interactive" || token === "-i") {
+      flags.interactive = true;
     } else if (token.startsWith("--select=")) {
       flags.select = token.slice(9).split(",").map(s => s.trim());
     } else if (token === "--select") {
@@ -647,13 +650,13 @@ async function main() {
     verbose: flags.verbose
   };
   
-  // Non-interactive mode
-  if (flags.auto || flags.quick || flags.select.length > 0 || shouldUseNonInteractive()) {
+  // Non-interactive mode (only if explicitly requested and not in interactive mode)
+  if (!flags.interactive && (flags.auto || flags.quick || flags.select.length > 0 || shouldUseNonInteractive())) {
     await handleNonInteractive(flags, options);
     return;
   }
   
-  // Interactive wizard mode
+  // Interactive wizard mode (default when no flags, or when --interactive is passed)
   await runWizard(options);
 }