squish-memory 1.0.1 → 1.0.2

package/dist/db/bootstrap.js

@@ -330,6 +330,44 @@ CREATE TABLE IF NOT EXISTS memory_hash_cache (
 
 CREATE INDEX IF NOT EXISTS memory_hash_cache_project_id_idx ON memory_hash_cache(project_id);
 CREATE INDEX IF NOT EXISTS memory_hash_cache_simhash_idx ON memory_hash_cache(simhash);
+
+-- Namespaces table (v1.0.x) - Hierarchical organization
+CREATE TABLE IF NOT EXISTS namespaces (
+  id TEXT PRIMARY KEY,
+  project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,
+  name TEXT NOT NULL,
+  path TEXT,
+  description TEXT,
+  parent_id TEXT REFERENCES namespaces(id) ON DELETE SET NULL,
+  created_at INTEGER DEFAULT (strftime('%s','now')) NOT NULL,
+  updated_at INTEGER DEFAULT (strftime('%s','now')) NOT NULL
+);
+CREATE INDEX IF NOT EXISTS namespaces_project_idx ON namespaces(project_id);
+CREATE INDEX IF NOT EXISTS namespaces_parent_idx ON namespaces(parent_id);
+
+-- Maintenance jobs table (v1.0.x) - Cron scheduler
+CREATE TABLE IF NOT EXISTS maintenance_jobs (
+  id TEXT PRIMARY KEY,
+  job_name TEXT NOT NULL UNIQUE,
+  job_type TEXT NOT NULL,
+  cron_expression TEXT,
+  enabled INTEGER DEFAULT 1 NOT NULL,
+  last_run_at INTEGER,
+  last_run_duration INTEGER,
+  last_run_status TEXT,
+  last_run_error TEXT,
+  total_runs INTEGER DEFAULT 0,
+  success_count INTEGER DEFAULT 0,
+  failure_count INTEGER DEFAULT 0,
+  job_config TEXT,
+  next_run_at INTEGER,
+  created_at INTEGER DEFAULT (strftime('%s','now')) NOT NULL,
+  updated_at INTEGER DEFAULT (strftime('%s','now')) NOT NULL
+);
+CREATE INDEX IF NOT EXISTS maintenance_jobs_name_idx ON maintenance_jobs(job_name);
+CREATE INDEX IF NOT EXISTS maintenance_jobs_next_run_idx ON maintenance_jobs(next_run_at);
+CREATE INDEX IF NOT EXISTS maintenance_jobs_type_idx ON maintenance_jobs(job_type);
+CREATE INDEX IF NOT EXISTS maintenance_jobs_enabled_idx ON maintenance_jobs(enabled);
 `;
 const postgresStatements = [
     `CREATE EXTENSION IF NOT EXISTS pgcrypto;`,
@@ -565,97 +603,71 @@ async function runSqliteMigrations(sqlite) {
         // No migrations needed
         return;
     }
-    // Migrations for memories table
+    // Migrations for memories table (deduplicated, ordered by version)
     const memoriesMigrations = [
+        // Base columns (v0.1.x - v0.5.x)
         { col: 'embedding', sql: 'ALTER TABLE memories ADD COLUMN embedding BLOB' },
-        { col: 'is_private', sql: 'ALTER TABLE memories ADD COLUMN is_private INTEGER DEFAULT 0' },
-        { col: 'has_secrets', sql: 'ALTER TABLE memories ADD COLUMN has_secrets INTEGER DEFAULT 0' },
         { col: 'relevance_score', sql: 'ALTER TABLE memories ADD COLUMN relevance_score INTEGER DEFAULT 50' },
+        // Merge tracking (v0.6.x)
         { col: 'is_merged', sql: 'ALTER TABLE memories ADD COLUMN is_merged INTEGER DEFAULT 0' },
         { col: 'merged_into_id', sql: 'ALTER TABLE memories ADD COLUMN merged_into_id TEXT' },
         { col: 'is_mergeable', sql: 'ALTER TABLE memories ADD COLUMN is_mergeable INTEGER DEFAULT 1' },
         { col: 'is_canonical', sql: 'ALTER TABLE memories ADD COLUMN is_canonical INTEGER DEFAULT 0' },
-        // v0.8.0: Importance scoring
+        { col: 'merged_at', sql: 'ALTER TABLE memories ADD COLUMN merged_at INTEGER' },
+        { col: 'merge_source_ids', sql: 'ALTER TABLE memories ADD COLUMN merge_source_ids TEXT' },
+        { col: 'merge_version', sql: 'ALTER TABLE memories ADD COLUMN merge_version INTEGER DEFAULT 1' },
+        // Importance scoring (v0.8.0)
         { col: 'importance_score', sql: 'ALTER TABLE memories ADD COLUMN importance_score INTEGER DEFAULT 50' },
         { col: 'importance_decay_rate', sql: 'ALTER TABLE memories ADD COLUMN importance_decay_rate INTEGER DEFAULT 30' },
         { col: 'last_importance_recalc', sql: 'ALTER TABLE memories ADD COLUMN last_importance_recalc INTEGER' },
-        // v0.8.0: Consolidation
+        // Consolidation (v0.8.0)
         { col: 'consolidated_into', sql: 'ALTER TABLE memories ADD COLUMN consolidated_into TEXT' },
         { col: 'consolidated_at', sql: 'ALTER TABLE memories ADD COLUMN consolidated_at INTEGER' },
         { col: 'is_consolidated', sql: 'ALTER TABLE memories ADD COLUMN is_consolidated INTEGER DEFAULT 0' },
-        { col: 'merged_at', sql: 'ALTER TABLE memories ADD COLUMN merged_at INTEGER' },
+        // Memory lifecycle (v0.8.0)
         { col: 'sector', sql: 'ALTER TABLE memories ADD COLUMN sector TEXT DEFAULT "episodic"' },
         { col: 'tier', sql: 'ALTER TABLE memories ADD COLUMN tier TEXT DEFAULT "hot"' },
         { col: 'context_status', sql: 'ALTER TABLE memories ADD COLUMN context_status TEXT DEFAULT "out-of-context"' },
         { col: 'decay_rate', sql: 'ALTER TABLE memories ADD COLUMN decay_rate INTEGER DEFAULT 30' },
         { col: 'coactivation_score', sql: 'ALTER TABLE memories ADD COLUMN coactivation_score INTEGER DEFAULT 0' },
         { col: 'last_decay_at', sql: 'ALTER TABLE memories ADD COLUMN last_decay_at INTEGER DEFAULT (strftime(\'%s\',\'now\'))' },
+        // Agent tracking (v0.8.0)
         { col: 'agent_id', sql: 'ALTER TABLE memories ADD COLUMN agent_id TEXT' },
         { col: 'agent_role', sql: 'ALTER TABLE memories ADD COLUMN agent_role TEXT' },
         { col: 'retrieval_priority', sql: 'ALTER TABLE memories ADD COLUMN retrieval_priority INTEGER DEFAULT 50' },
-        // v0.9.0: New schema columns
+        // Data governance (v0.9.0)
         { col: 'recorded_at', sql: 'ALTER TABLE memories ADD COLUMN recorded_at INTEGER DEFAULT (strftime(\'%s\',\'now\'))' },
         { col: 'confidence', sql: 'ALTER TABLE memories ADD COLUMN confidence INTEGER DEFAULT 100' },
-        { col: 'is_private', sql: 'ALTER TABLE memories ADD COLUMN is_private INTEGER DEFAULT 0' },
-        { col: 'has_secrets', sql: 'ALTER TABLE memories ADD COLUMN has_secrets INTEGER DEFAULT 0' },
         { col: 'valid_from', sql: 'ALTER TABLE memories ADD COLUMN valid_from INTEGER' },
         { col: 'valid_to', sql: 'ALTER TABLE memories ADD COLUMN valid_to INTEGER' },
         { col: 'superseded_by', sql: 'ALTER TABLE memories ADD COLUMN superseded_by TEXT' },
         { col: 'version', sql: 'ALTER TABLE memories ADD COLUMN version INTEGER DEFAULT 1' },
-        { col: 'merge_source_ids', sql: 'ALTER TABLE memories ADD COLUMN merge_source_ids TEXT' },
-        { col: 'merge_version', sql: 'ALTER TABLE memories ADD COLUMN merge_version INTEGER DEFAULT 1' },
-        { col: 'user_id', sql: 'ALTER TABLE memories ADD COLUMN user_id TEXT' },
-        { col: 'confidence', sql: 'ALTER TABLE memories ADD COLUMN confidence INTEGER DEFAULT 100' },
         { col: 'is_active', sql: 'ALTER TABLE memories ADD COLUMN is_active INTEGER DEFAULT 1' },
         { col: 'expires_at', sql: 'ALTER TABLE memories ADD COLUMN expires_at INTEGER' },
-        { col: 'decay_rate', sql: 'ALTER TABLE memories ADD COLUMN decay_rate INTEGER DEFAULT 30' },
-        { col: 'coactivation_score', sql: 'ALTER TABLE memories ADD COLUMN coactivation_score INTEGER DEFAULT 0' },
-        { col: 'last_decay_at', sql: 'ALTER TABLE memories ADD COLUMN last_decay_at INTEGER' },
-        { col: 'agent_id', sql: 'ALTER TABLE memories ADD COLUMN agent_id TEXT' },
-        { col: 'agent_role', sql: 'ALTER TABLE memories ADD COLUMN agent_role TEXT' },
-        { col: 'retrieval_priority', sql: 'ALTER TABLE memories ADD COLUMN retrieval_priority INTEGER DEFAULT 50' },
-        // v0.8.0: Consolidation
-        { col: 'consolidated_into', sql: 'ALTER TABLE memories ADD COLUMN consolidated_into TEXT' },
-        { col: 'consolidated_at', sql: 'ALTER TABLE memories ADD COLUMN consolidated_at INTEGER' },
-        { col: 'is_consolidated', sql: 'ALTER TABLE memories ADD COLUMN is_consolidated INTEGER DEFAULT 0' },
-        { col: 'merged_at', sql: 'ALTER TABLE memories ADD COLUMN merged_at INTEGER' },
-        { col: 'sector', sql: 'ALTER TABLE memories ADD COLUMN sector TEXT DEFAULT "episodic"' },
-        { col: 'tier', sql: 'ALTER TABLE memories ADD COLUMN tier TEXT DEFAULT "hot"' },
-        { col: 'context_status', sql: 'ALTER TABLE memories ADD COLUMN context_status TEXT DEFAULT "out-of-context"' },
-        { col: 'decay_rate', sql: 'ALTER TABLE memories ADD COLUMN decay_rate INTEGER DEFAULT 30' },
-        { col: 'coactivation_score', sql: 'ALTER TABLE memories ADD COLUMN coactivation_score INTEGER DEFAULT 0' },
-        { col: 'last_decay_at', sql: 'ALTER TABLE memories ADD COLUMN last_decay_at INTEGER DEFAULT (strftime(\'%s\',\'now\'))' },
-        { col: 'agent_id', sql: 'ALTER TABLE memories ADD COLUMN agent_id TEXT' },
-        { col: 'agent_role', sql: 'ALTER TABLE memories ADD COLUMN agent_role TEXT' },
+        // Privacy & access (v0.9.0)
+        { col: 'is_private', sql: 'ALTER TABLE memories ADD COLUMN is_private INTEGER DEFAULT 0' },
+        { col: 'has_secrets', sql: 'ALTER TABLE memories ADD COLUMN has_secrets INTEGER DEFAULT 0' },
         { col: 'visibility_scope', sql: 'ALTER TABLE memories ADD COLUMN visibility_scope TEXT DEFAULT "private"' },
         { col: 'is_protected', sql: 'ALTER TABLE memories ADD COLUMN is_protected INTEGER DEFAULT 0' },
         { col: 'is_pinned', sql: 'ALTER TABLE memories ADD COLUMN is_pinned INTEGER DEFAULT 0' },
         { col: 'is_immutable', sql: 'ALTER TABLE memories ADD COLUMN is_immutable INTEGER DEFAULT 0' },
         { col: 'write_scope', sql: 'ALTER TABLE memories ADD COLUMN write_scope TEXT' },
         { col: 'read_scope', sql: 'ALTER TABLE memories ADD COLUMN read_scope TEXT' },
+        // Usage tracking (v0.9.0)
         { col: 'triggered_by', sql: 'ALTER TABLE memories ADD COLUMN triggered_by TEXT' },
         { col: 'capture_reason', sql: 'ALTER TABLE memories ADD COLUMN capture_reason TEXT' },
         { col: 'last_used_at', sql: 'ALTER TABLE memories ADD COLUMN last_used_at INTEGER' },
         { col: 'usage_count', sql: 'ALTER TABLE memories ADD COLUMN usage_count INTEGER DEFAULT 0' },
-        { col: 'valid_from', sql: 'ALTER TABLE memories ADD COLUMN valid_from INTEGER' },
-        { col: 'valid_to', sql: 'ALTER TABLE memories ADD COLUMN valid_to INTEGER' },
-        { col: 'superseded_by', sql: 'ALTER TABLE memories ADD COLUMN superseded_by TEXT' },
-        { col: 'version', sql: 'ALTER TABLE memories ADD COLUMN version INTEGER DEFAULT 1' },
-        { col: 'merge_source_ids', sql: 'ALTER TABLE memories ADD COLUMN merge_source_ids TEXT' },
-        { col: 'merge_version', sql: 'ALTER TABLE memories ADD COLUMN merge_version INTEGER DEFAULT 1' },
         { col: 'user_id', sql: 'ALTER TABLE memories ADD COLUMN user_id TEXT' },
-        { col: 'confidence', sql: 'ALTER TABLE memories ADD COLUMN confidence INTEGER DEFAULT 100' },
-        { col: 'is_active', sql: 'ALTER TABLE memories ADD COLUMN is_active INTEGER DEFAULT 1' },
-        { col: 'expires_at', sql: 'ALTER TABLE memories ADD COLUMN expires_at INTEGER' },
-        { col: 'decay_rate', sql: 'ALTER TABLE memories ADD COLUMN decay_rate INTEGER DEFAULT 30' },
-        { col: 'coactivation_score', sql: 'ALTER TABLE memories ADD COLUMN coactivation_score INTEGER DEFAULT 0' },
-        { col: 'last_decay_at', sql: 'ALTER TABLE memories ADD COLUMN last_decay_at INTEGER' },
-        { col: 'agent_id', sql: 'ALTER TABLE memories ADD COLUMN agent_id TEXT' },
-        { col: 'agent_role', sql: 'ALTER TABLE memories ADD COLUMN agent_role TEXT' },
-        { col: 'retrieval_priority', sql: 'ALTER TABLE memories ADD COLUMN retrieval_priority INTEGER DEFAULT 50' },
-        { col: 'importance_score', sql: 'ALTER TABLE memories ADD COLUMN importance_score INTEGER DEFAULT 50' },
-        { col: 'importance_decay_rate', sql: 'ALTER TABLE memories ADD COLUMN importance_decay_rate INTEGER DEFAULT 30' },
-        { col: 'last_importance_recalc', sql: 'ALTER TABLE memories ADD COLUMN last_importance_recalc INTEGER' },
+        // Layer tracking (v0.9.x)
+        { col: 'has_l0_abstract', sql: 'ALTER TABLE memories ADD COLUMN has_l0_abstract INTEGER DEFAULT 0' },
+        { col: 'has_l1_overview', sql: 'ALTER TABLE memories ADD COLUMN has_l1_overview INTEGER DEFAULT 0' },
+        { col: 'last_layer_update', sql: 'ALTER TABLE memories ADD COLUMN last_layer_update INTEGER' },
+        // Namespace support (v1.0.x)
+        { col: 'namespace_id', sql: 'ALTER TABLE memories ADD COLUMN namespace_id TEXT REFERENCES namespaces(id) ON DELETE SET NULL' },
+        { col: 'namespace_path', sql: 'ALTER TABLE memories ADD COLUMN namespace_path TEXT' },
+        // Token tracking (v1.0.x)
+        { col: 'tokens_estimate', sql: 'ALTER TABLE memories ADD COLUMN tokens_estimate INTEGER DEFAULT 0' },
     ];
     // Get existing columns for memories table
     const tableInfo = sqlite.prepare("PRAGMA table_info(memories)").all();
@@ -676,28 +688,90 @@ async function runSqliteMigrations(sqlite) {
                     throw new Error(`Migration failed for column ${migration.col}: ${msg}`);
                 }
             }
-            // v0.9.2: Add tokens_estimate to core_memory
-            const coreMemoryTableCheck = sqlite.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='core_memory'").get();
-            if (coreMemoryTableCheck) {
-                const coreMemoryInfo = sqlite.prepare("PRAGMA table_info(core_memory)").all();
-                const existingCoreMemoryColumns = new Set(coreMemoryInfo.map(col => col.name));
-                const coreMemoryMigrations = [
-                    { col: 'tokens_estimate', sql: 'ALTER TABLE core_memory ADD COLUMN tokens_estimate INTEGER DEFAULT 0 NOT NULL' },
-                ];
-                for (const migration of coreMemoryMigrations) {
-                    if (!existingCoreMemoryColumns.has(migration.col)) {
-                        try {
-                            sqlite.exec(migration.sql);
-                            logger.info(`Migration: Added column ${migration.col} to core_memory table`);
+        }
+    }
+    // v0.9.2: Add tokens_estimate to core_memory
+    const coreMemoryTableCheck = sqlite.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='core_memory'").get();
+    if (coreMemoryTableCheck) {
+        const coreMemoryInfo = sqlite.prepare("PRAGMA table_info(core_memory)").all();
+        const existingCoreMemoryColumns = new Set(coreMemoryInfo.map(col => col.name));
+        const coreMemoryMigrations = [
+            { col: 'tokens_estimate', sql: 'ALTER TABLE core_memory ADD COLUMN tokens_estimate INTEGER DEFAULT 0 NOT NULL' },
+        ];
+        for (const migration of coreMemoryMigrations) {
+            if (!existingCoreMemoryColumns.has(migration.col)) {
+                try {
+                    sqlite.exec(migration.sql);
+                    logger.info(`Migration: Added column ${migration.col} to core_memory table`);
+                }
+                catch (error) {
+                    const msg = error instanceof Error ? error.message : String(error);
+                    if (msg.includes('duplicate column name')) {
+                        logger.debug(`Migration skipped for ${migration.col}: column already exists`);
+                    }
+                    else {
+                        throw new Error(`Migration failed for column ${migration.col}: ${msg}`);
+                    }
+                }
+            }
+        }
+    }
+    // Migrations for maintenance_jobs table (v1.0.x)
+    const maintenanceJobsTableCheck = sqlite.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='maintenance_jobs'").get();
+    if (maintenanceJobsTableCheck) {
+        const maintenanceJobsInfo = sqlite.prepare("PRAGMA table_info(maintenance_jobs)").all();
+        const existingMaintenanceJobsColumns = new Set(maintenanceJobsInfo.map(col => col.name));
+        // Check if table has wrong schema (camelCase columns from bug in earlier version)
+        const hasCamelCaseColumns = existingMaintenanceJobsColumns.has('jobName') ||
+            existingMaintenanceJobsColumns.has('jobType') ||
+            existingMaintenanceJobsColumns.has('cronExpression');
+        if (hasCamelCaseColumns) {
+            // Table has incorrect camelCase schema - need to recreate it
+            logger.warn('Maintenance jobs table has incorrect schema (camelCase columns). Recreating...');
+            try {
+                // Drop the malformed table
+                sqlite.exec('DROP TABLE IF EXISTS maintenance_jobs');
+                // Recreate with correct schema - it will be created by the schema SQL
+                logger.info('Dropped malformed maintenance_jobs table. It will be recreated with correct schema.');
+            }
+            catch (error) {
+                logger.error('Failed to recreate maintenance_jobs table:', error);
+            }
+        }
+        else {
+            // Normal migrations for correct schema
+            const maintenanceJobsMigrations = [
+                { col: 'schedule', sql: 'ALTER TABLE maintenance_jobs DROP COLUMN schedule' },
+                { col: 'cron_expression', sql: 'ALTER TABLE maintenance_jobs ADD COLUMN cron_expression TEXT' },
+                { col: 'last_run_at', sql: 'ALTER TABLE maintenance_jobs ADD COLUMN last_run_at INTEGER' },
+                { col: 'last_run_duration', sql: 'ALTER TABLE maintenance_jobs ADD COLUMN last_run_duration INTEGER' },
+                { col: 'last_run_status', sql: 'ALTER TABLE maintenance_jobs ADD COLUMN last_run_status TEXT' },
+                { col: 'last_run_error', sql: 'ALTER TABLE maintenance_jobs ADD COLUMN last_run_error TEXT' },
+                { col: 'total_runs', sql: 'ALTER TABLE maintenance_jobs ADD COLUMN total_runs INTEGER DEFAULT 0' },
+                { col: 'success_count', sql: 'ALTER TABLE maintenance_jobs ADD COLUMN success_count INTEGER DEFAULT 0' },
+                { col: 'failure_count', sql: 'ALTER TABLE maintenance_jobs ADD COLUMN failure_count INTEGER DEFAULT 0' },
+                { col: 'job_config', sql: 'ALTER TABLE maintenance_jobs ADD COLUMN job_config TEXT' },
+                { col: 'next_run_at', sql: 'ALTER TABLE maintenance_jobs ADD COLUMN next_run_at INTEGER' },
+                { col: 'run_count', sql: 'ALTER TABLE maintenance_jobs DROP COLUMN run_count' },
+            ];
+            for (const migration of maintenanceJobsMigrations) {
+                // For DROP migrations, only run if column EXISTS
+                // For ADD migrations, only run if column does NOT exist
+                const shouldRun = migration.sql.startsWith('ALTER TABLE maintenance_jobs DROP COLUMN')
+                    ? existingMaintenanceJobsColumns.has(migration.col)
+                    : !existingMaintenanceJobsColumns.has(migration.col);
+                if (shouldRun) {
+                    try {
+                        sqlite.exec(migration.sql);
+                        logger.info(`Migration: ${migration.col} on maintenance_jobs table`);
+                    }
+                    catch (error) {
+                        const msg = error instanceof Error ? error.message : String(error);
+                        if (msg.includes('duplicate column name') || msg.includes('no such column')) {
+                            logger.debug(`Migration skipped for ${migration.col}: ${msg.includes('duplicate column name') ? 'column already exists' : 'column does not exist'}`);
                         }
-                        catch (error) {
-                            const msg = error instanceof Error ? error.message : String(error);
-                            if (msg.includes('duplicate column name')) {
-                                logger.debug(`Migration skipped for ${migration.col}: column already exists`);
-                            }
-                            else {
-                                throw new Error(`Migration failed for column ${migration.col}: ${msg}`);
-                            }
+                        else {
+                            throw new Error(`Migration failed for column ${migration.col}: ${msg}`);
                         }
                     }
                 }

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.1';
+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"
+    }
+  ]
+}