@stackmemoryai/stackmemory 0.3.1 → 0.3.5

package/dist/cli/commands/chromadb.js

@@ -0,0 +1,267 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { ChromaDBAdapter } from "../../core/storage/chromadb-adapter.js";
+import { FrameManager } from "../../core/context/frame-manager.js";
+import { Logger } from "../../core/monitoring/logger.js";
+import Table from "cli-table3";
+import dotenv from "dotenv";
+import path from "path";
+import { fileURLToPath } from "url";
+import fs from "fs";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+dotenv.config({
+  path: path.join(__dirname, "../../../.env"),
+  override: true,
+  silent: true
+});
+const logger = new Logger("ChromaDB-CLI");
+function createChromaDBCommand() {
+  const chromadb = new Command("chromadb").description("Manage ChromaDB vector storage for context").alias("chroma");
+  chromadb.command("init").description("Initialize ChromaDB connection").option("--api-key <key>", "ChromaDB API key").option("--tenant <tenant>", "ChromaDB tenant ID").option("--database <database>", "ChromaDB database name").option("--user-id <id>", "User ID for segmentation").option("--team-id <id>", "Team ID for segmentation").action(async (options) => {
+    const spinner = ora("Initializing ChromaDB...").start();
+    try {
+      const config = {
+        apiKey: options.apiKey || process.env.CHROMADB_API_KEY || "",
+        tenant: options.tenant || process.env.CHROMADB_TENANT || "",
+        database: options.database || process.env.CHROMADB_DATABASE || "stackmemory"
+      };
+      const userId = options.userId || process.env.USER || "default";
+      const teamId = options.teamId || process.env.CHROMADB_TEAM_ID;
+      if (!config.apiKey || !config.tenant) {
+        spinner.fail("Missing ChromaDB credentials");
+        console.log(chalk.yellow("\nPlease provide:"));
+        console.log("  --api-key <key>    ChromaDB API key");
+        console.log("  --tenant <tenant>  ChromaDB tenant ID");
+        console.log("\nOr set environment variables:");
+        console.log("  CHROMADB_API_KEY");
+        console.log("  CHROMADB_TENANT");
+        return;
+      }
+      const adapter = new ChromaDBAdapter(config, userId, teamId);
+      await adapter.initialize();
+      const envPath = path.join(__dirname, "../../../.env");
+      let envContent = "";
+      if (fs.existsSync(envPath)) {
+        envContent = fs.readFileSync(envPath, "utf8");
+      }
+      const updates = [];
+      if (!envContent.includes("CHROMADB_API_KEY")) {
+        updates.push(`CHROMADB_API_KEY=${config.apiKey}`);
+      }
+      if (!envContent.includes("CHROMADB_TENANT")) {
+        updates.push(`CHROMADB_TENANT=${config.tenant}`);
+      }
+      if (!envContent.includes("CHROMADB_DATABASE")) {
+        updates.push(`CHROMADB_DATABASE=${config.database}`);
+      }
+      if (updates.length > 0) {
+        fs.appendFileSync(envPath, "\n# ChromaDB Configuration\n" + updates.join("\n") + "\n");
+      }
+      spinner.succeed("ChromaDB initialized successfully");
+      console.log(chalk.green("\n\u2705 Configuration:"));
+      console.log(`  Tenant: ${config.tenant}`);
+      console.log(`  Database: ${config.database}`);
+      console.log(`  User ID: ${userId}`);
+      if (teamId) {
+        console.log(`  Team ID: ${teamId}`);
+      }
+    } catch (error) {
+      spinner.fail("Failed to initialize ChromaDB");
+      logger.error("Initialization error", error);
+      console.error(chalk.red(error instanceof Error ? error.message : "Unknown error"));
+    }
+  });
+  chromadb.command("store").description("Store current context in ChromaDB").option("--type <type>", "Context type (frame/decision/observation)", "frame").option("--content <content>", "Content to store").option("--project <name>", "Project name").action(async (options) => {
+    const spinner = ora("Storing context...").start();
+    try {
+      const config = {
+        apiKey: process.env.CHROMADB_API_KEY || "",
+        tenant: process.env.CHROMADB_TENANT || "",
+        database: process.env.CHROMADB_DATABASE || "stackmemory"
+      };
+      const userId = process.env.USER || "default";
+      const teamId = process.env.CHROMADB_TEAM_ID;
+      const adapter = new ChromaDBAdapter(config, userId, teamId);
+      await adapter.initialize();
+      if (options.type === "frame") {
+        const frameManager = new FrameManager();
+        const frames = frameManager.getAllFrames();
+        for (const frame of frames) {
+          await adapter.storeFrame(frame);
+        }
+        spinner.succeed(`Stored ${frames.length} frames`);
+      } else {
+        const content = options.content || `${options.type} at ${(/* @__PURE__ */ new Date()).toISOString()}`;
+        const metadata = {
+          project_name: options.project || path.basename(process.cwd())
+        };
+        if (process.env.STACKMEMORY_SESSION_ID) {
+          metadata.session_id = process.env.STACKMEMORY_SESSION_ID;
+        }
+        await adapter.storeContext(
+          options.type,
+          content,
+          metadata
+        );
+        spinner.succeed(`Stored ${options.type}`);
+      }
+    } catch (error) {
+      spinner.fail("Failed to store context");
+      logger.error("Store error", error);
+      console.error(chalk.red(error instanceof Error ? error.message : "Unknown error"));
+    }
+  });
+  chromadb.command("query <search>").description("Query contexts from ChromaDB").option("--limit <n>", "Number of results", "10").option("--type <type>", "Filter by type").option("--project <name>", "Filter by project").action(async (search, options) => {
+    const spinner = ora("Searching...").start();
+    try {
+      const config = {
+        apiKey: process.env.CHROMADB_API_KEY || "",
+        tenant: process.env.CHROMADB_TENANT || "",
+        database: process.env.CHROMADB_DATABASE || "stackmemory"
+      };
+      const userId = process.env.USER || "default";
+      const teamId = process.env.CHROMADB_TEAM_ID;
+      const adapter = new ChromaDBAdapter(config, userId, teamId);
+      await adapter.initialize();
+      const filters = {};
+      if (options.type) {
+        filters.type = [options.type];
+      }
+      if (options.project) {
+        filters.projectName = options.project;
+      }
+      const results = await adapter.queryContexts(
+        search,
+        parseInt(options.limit),
+        filters
+      );
+      spinner.stop();
+      if (results.length === 0) {
+        console.log(chalk.yellow("No results found"));
+        return;
+      }
+      const table = new Table({
+        head: ["Type", "Project", "Content", "Distance"],
+        colWidths: [15, 20, 50, 10],
+        wordWrap: true
+      });
+      for (const result of results) {
+        const content = result.content.substring(0, 100) + (result.content.length > 100 ? "..." : "");
+        table.push([
+          result.metadata.type || "unknown",
+          result.metadata.project_name || "default",
+          content,
+          result.distance.toFixed(3)
+        ]);
+      }
+      console.log(table.toString());
+      console.log(chalk.green(`
+\u2705 Found ${results.length} results`));
+    } catch (error) {
+      spinner.fail("Failed to query contexts");
+      logger.error("Query error", error);
+      console.error(chalk.red(error instanceof Error ? error.message : "Unknown error"));
+    }
+  });
+  chromadb.command("recent").description("Get recent contexts").option("--limit <n>", "Number of results", "20").option("--type <type>", "Filter by type").action(async (options) => {
+    const spinner = ora("Fetching recent contexts...").start();
+    try {
+      const config = {
+        apiKey: process.env.CHROMADB_API_KEY || "",
+        tenant: process.env.CHROMADB_TENANT || "",
+        database: process.env.CHROMADB_DATABASE || "stackmemory"
+      };
+      const userId = process.env.USER || "default";
+      const teamId = process.env.CHROMADB_TEAM_ID;
+      const adapter = new ChromaDBAdapter(config, userId, teamId);
+      await adapter.initialize();
+      const results = await adapter.getRecentContexts(
+        parseInt(options.limit),
+        options.type
+      );
+      spinner.stop();
+      if (results.length === 0) {
+        console.log(chalk.yellow("No recent contexts found"));
+        return;
+      }
+      const table = new Table({
+        head: ["Time", "Type", "Project", "Content"],
+        colWidths: [20, 12, 20, 48],
+        wordWrap: true
+      });
+      for (const result of results) {
+        const time = new Date(result.metadata.timestamp).toLocaleString();
+        const content = result.content.substring(0, 100) + (result.content.length > 100 ? "..." : "");
+        table.push([
+          time,
+          result.metadata.type || "unknown",
+          result.metadata.project_name || "default",
+          content
+        ]);
+      }
+      console.log(table.toString());
+      console.log(chalk.green(`
+\u2705 Found ${results.length} recent contexts`));
+    } catch (error) {
+      spinner.fail("Failed to get recent contexts");
+      logger.error("Recent error", error);
+      console.error(chalk.red(error instanceof Error ? error.message : "Unknown error"));
+    }
+  });
+  chromadb.command("stats").description("Get ChromaDB storage statistics").action(async () => {
+    const spinner = ora("Fetching statistics...").start();
+    try {
+      const config = {
+        apiKey: process.env.CHROMADB_API_KEY || "",
+        tenant: process.env.CHROMADB_TENANT || "",
+        database: process.env.CHROMADB_DATABASE || "stackmemory"
+      };
+      const userId = process.env.USER || "default";
+      const teamId = process.env.CHROMADB_TEAM_ID;
+      const adapter = new ChromaDBAdapter(config, userId, teamId);
+      await adapter.initialize();
+      const stats = await adapter.getStats();
+      spinner.stop();
+      console.log(chalk.cyan("\n\u{1F4CA} ChromaDB Statistics\n"));
+      console.log(`Total Documents: ${chalk.bold(stats.totalDocuments)}`);
+      console.log(`User Documents: ${chalk.bold(stats.userDocuments)}`);
+      if (stats.teamDocuments !== void 0) {
+        console.log(`Team Documents: ${chalk.bold(stats.teamDocuments)}`);
+      }
+      console.log("\nDocuments by Type:");
+      for (const [type, count] of Object.entries(stats.documentsByType)) {
+        console.log(`  ${type}: ${count}`);
+      }
+    } catch (error) {
+      spinner.fail("Failed to get statistics");
+      logger.error("Stats error", error);
+      console.error(chalk.red(error instanceof Error ? error.message : "Unknown error"));
+    }
+  });
+  chromadb.command("clean").description("Clean old contexts").option("--days <n>", "Delete contexts older than N days", "30").action(async (options) => {
+    const spinner = ora("Cleaning old contexts...").start();
+    try {
+      const config = {
+        apiKey: process.env.CHROMADB_API_KEY || "",
+        tenant: process.env.CHROMADB_TENANT || "",
+        database: process.env.CHROMADB_DATABASE || "stackmemory"
+      };
+      const userId = process.env.USER || "default";
+      const teamId = process.env.CHROMADB_TEAM_ID;
+      const adapter = new ChromaDBAdapter(config, userId, teamId);
+      await adapter.initialize();
+      const deleted = await adapter.deleteOldContexts(parseInt(options.days));
+      spinner.succeed(`Deleted ${deleted} old contexts`);
+    } catch (error) {
+      spinner.fail("Failed to clean contexts");
+      logger.error("Clean error", error);
+      console.error(chalk.red(error instanceof Error ? error.message : "Unknown error"));
+    }
+  });
+  return chromadb;
+}
+export {
+  createChromaDBCommand
+};
+//# sourceMappingURL=chromadb.js.map

package/dist/cli/commands/chromadb.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/commands/chromadb.ts"],
+  "sourcesContent": ["/**\n * ChromaDB CLI Commands for StackMemory\n * \n * Provides commands to interact with ChromaDB vector storage\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport { ChromaDBAdapter } from '../../core/storage/chromadb-adapter.js';\nimport { FrameManager } from '../../core/context/frame-manager.js';\nimport { Logger } from '../../core/monitoring/logger.js';\nimport Table from 'cli-table3';\nimport dotenv from 'dotenv';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\nimport fs from 'fs';\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\n// Load environment variables\ndotenv.config({ \n  path: path.join(__dirname, '../../../.env'),\n  override: true,\n  silent: true\n});\n\nconst logger = new Logger('ChromaDB-CLI');\n\nexport function createChromaDBCommand(): Command {\n  const chromadb = new Command('chromadb')\n    .description('Manage ChromaDB vector storage for context')\n    .alias('chroma');\n\n  // Initialize ChromaDB\n  chromadb\n    .command('init')\n    .description('Initialize ChromaDB connection')\n    .option('--api-key <key>', 'ChromaDB API key')\n    .option('--tenant <tenant>', 'ChromaDB tenant ID')\n    .option('--database <database>', 'ChromaDB database name')\n    .option('--user-id <id>', 'User ID for segmentation')\n    .option('--team-id <id>', 'Team ID for segmentation')\n    .action(async (options) => {\n      const spinner = ora('Initializing ChromaDB...').start();\n\n      try {\n        // Get config from options or environment\n        const config = {\n          apiKey: options.apiKey || process.env.CHROMADB_API_KEY || '',\n          tenant: options.tenant || process.env.CHROMADB_TENANT || '',\n          database: options.database || process.env.CHROMADB_DATABASE || 'stackmemory',\n        };\n\n        const userId = options.userId || process.env.USER || 'default';\n        const teamId = options.teamId || process.env.CHROMADB_TEAM_ID;\n\n        if (!config.apiKey || !config.tenant) {\n          spinner.fail('Missing ChromaDB credentials');\n          console.log(chalk.yellow('\\nPlease provide:'));\n          console.log('  --api-key <key>    ChromaDB API key');\n          console.log('  --tenant <tenant>  ChromaDB tenant ID');\n          console.log('\\nOr set environment variables:');\n          console.log('  CHROMADB_API_KEY');\n          console.log('  CHROMADB_TENANT');\n          return;\n        }\n\n        // Initialize adapter\n        const adapter = new ChromaDBAdapter(config, userId, teamId);\n        await adapter.initialize();\n\n        // Save config to .env if not present\n        const envPath = path.join(__dirname, '../../../.env');\n        let envContent = '';\n        \n        if (fs.existsSync(envPath)) {\n          envContent = fs.readFileSync(envPath, 'utf8');\n        }\n\n        const updates: string[] = [];\n        if (!envContent.includes('CHROMADB_API_KEY')) {\n          updates.push(`CHROMADB_API_KEY=${config.apiKey}`);\n        }\n        if (!envContent.includes('CHROMADB_TENANT')) {\n          updates.push(`CHROMADB_TENANT=${config.tenant}`);\n        }\n        if (!envContent.includes('CHROMADB_DATABASE')) {\n          updates.push(`CHROMADB_DATABASE=${config.database}`);\n        }\n\n        if (updates.length > 0) {\n          fs.appendFileSync(envPath, '\\n# ChromaDB Configuration\\n' + updates.join('\\n') + '\\n');\n        }\n\n        spinner.succeed('ChromaDB initialized successfully');\n        \n        console.log(chalk.green('\\n\u2705 Configuration:'));\n        console.log(`  Tenant: ${config.tenant}`);\n        console.log(`  Database: ${config.database}`);\n        console.log(`  User ID: ${userId}`);\n        if (teamId) {\n          console.log(`  Team ID: ${teamId}`);\n        }\n      } catch (error) {\n        spinner.fail('Failed to initialize ChromaDB');\n        logger.error('Initialization error', error);\n        console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));\n      }\n    });\n\n  // Store current context\n  chromadb\n    .command('store')\n    .description('Store current context in ChromaDB')\n    .option('--type <type>', 'Context type (frame/decision/observation)', 'frame')\n    .option('--content <content>', 'Content to store')\n    .option('--project <name>', 'Project name')\n    .action(async (options) => {\n      const spinner = ora('Storing context...').start();\n\n      try {\n        const config = {\n          apiKey: process.env.CHROMADB_API_KEY || '',\n          tenant: process.env.CHROMADB_TENANT || '',\n          database: process.env.CHROMADB_DATABASE || 'stackmemory',\n        };\n\n        const userId = process.env.USER || 'default';\n        const teamId = process.env.CHROMADB_TEAM_ID;\n\n        const adapter = new ChromaDBAdapter(config, userId, teamId);\n        await adapter.initialize();\n\n        if (options.type === 'frame') {\n          // Store current frames\n          const frameManager = new FrameManager();\n          const frames = frameManager.getAllFrames();\n          \n          for (const frame of frames) {\n            await adapter.storeFrame(frame);\n          }\n          \n          spinner.succeed(`Stored ${frames.length} frames`);\n        } else {\n          // Store decision or observation\n          const content = options.content || `${options.type} at ${new Date().toISOString()}`;\n          const metadata: any = {\n            project_name: options.project || path.basename(process.cwd()),\n          };\n          \n          // Only add session_id if it exists\n          if (process.env.STACKMEMORY_SESSION_ID) {\n            metadata.session_id = process.env.STACKMEMORY_SESSION_ID;\n          }\n          \n          await adapter.storeContext(\n            options.type as 'decision' | 'observation',\n            content,\n            metadata\n          );\n          \n          spinner.succeed(`Stored ${options.type}`);\n        }\n      } catch (error) {\n        spinner.fail('Failed to store context');\n        logger.error('Store error', error);\n        console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));\n      }\n    });\n\n  // Query contexts\n  chromadb\n    .command('query <search>')\n    .description('Query contexts from ChromaDB')\n    .option('--limit <n>', 'Number of results', '10')\n    .option('--type <type>', 'Filter by type')\n    .option('--project <name>', 'Filter by project')\n    .action(async (search, options) => {\n      const spinner = ora('Searching...').start();\n\n      try {\n        const config = {\n          apiKey: process.env.CHROMADB_API_KEY || '',\n          tenant: process.env.CHROMADB_TENANT || '',\n          database: process.env.CHROMADB_DATABASE || 'stackmemory',\n        };\n\n        const userId = process.env.USER || 'default';\n        const teamId = process.env.CHROMADB_TEAM_ID;\n\n        const adapter = new ChromaDBAdapter(config, userId, teamId);\n        await adapter.initialize();\n\n        const filters: any = {};\n        if (options.type) {\n          filters.type = [options.type];\n        }\n        if (options.project) {\n          filters.projectName = options.project;\n        }\n\n        const results = await adapter.queryContexts(\n          search,\n          parseInt(options.limit),\n          filters\n        );\n\n        spinner.stop();\n\n        if (results.length === 0) {\n          console.log(chalk.yellow('No results found'));\n          return;\n        }\n\n        // Display results\n        const table = new Table({\n          head: ['Type', 'Project', 'Content', 'Distance'],\n          colWidths: [15, 20, 50, 10],\n          wordWrap: true,\n        });\n\n        for (const result of results) {\n          const content = result.content.substring(0, 100) + \n                          (result.content.length > 100 ? '...' : '');\n          \n          table.push([\n            result.metadata.type || 'unknown',\n            result.metadata.project_name || 'default',\n            content,\n            result.distance.toFixed(3),\n          ]);\n        }\n\n        console.log(table.toString());\n        console.log(chalk.green(`\\n\u2705 Found ${results.length} results`));\n      } catch (error) {\n        spinner.fail('Failed to query contexts');\n        logger.error('Query error', error);\n        console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));\n      }\n    });\n\n  // Get recent contexts\n  chromadb\n    .command('recent')\n    .description('Get recent contexts')\n    .option('--limit <n>', 'Number of results', '20')\n    .option('--type <type>', 'Filter by type')\n    .action(async (options) => {\n      const spinner = ora('Fetching recent contexts...').start();\n\n      try {\n        const config = {\n          apiKey: process.env.CHROMADB_API_KEY || '',\n          tenant: process.env.CHROMADB_TENANT || '',\n          database: process.env.CHROMADB_DATABASE || 'stackmemory',\n        };\n\n        const userId = process.env.USER || 'default';\n        const teamId = process.env.CHROMADB_TEAM_ID;\n\n        const adapter = new ChromaDBAdapter(config, userId, teamId);\n        await adapter.initialize();\n\n        const results = await adapter.getRecentContexts(\n          parseInt(options.limit),\n          options.type\n        );\n\n        spinner.stop();\n\n        if (results.length === 0) {\n          console.log(chalk.yellow('No recent contexts found'));\n          return;\n        }\n\n        // Display results\n        const table = new Table({\n          head: ['Time', 'Type', 'Project', 'Content'],\n          colWidths: [20, 12, 20, 48],\n          wordWrap: true,\n        });\n\n        for (const result of results) {\n          const time = new Date(result.metadata.timestamp).toLocaleString();\n          const content = result.content.substring(0, 100) + \n                          (result.content.length > 100 ? '...' : '');\n          \n          table.push([\n            time,\n            result.metadata.type || 'unknown',\n            result.metadata.project_name || 'default',\n            content,\n          ]);\n        }\n\n        console.log(table.toString());\n        console.log(chalk.green(`\\n\u2705 Found ${results.length} recent contexts`));\n      } catch (error) {\n        spinner.fail('Failed to get recent contexts');\n        logger.error('Recent error', error);\n        console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));\n      }\n    });\n\n  // Get statistics\n  chromadb\n    .command('stats')\n    .description('Get ChromaDB storage statistics')\n    .action(async () => {\n      const spinner = ora('Fetching statistics...').start();\n\n      try {\n        const config = {\n          apiKey: process.env.CHROMADB_API_KEY || '',\n          tenant: process.env.CHROMADB_TENANT || '',\n          database: process.env.CHROMADB_DATABASE || 'stackmemory',\n        };\n\n        const userId = process.env.USER || 'default';\n        const teamId = process.env.CHROMADB_TEAM_ID;\n\n        const adapter = new ChromaDBAdapter(config, userId, teamId);\n        await adapter.initialize();\n\n        const stats = await adapter.getStats();\n\n        spinner.stop();\n\n        console.log(chalk.cyan('\\n\uD83D\uDCCA ChromaDB Statistics\\n'));\n        console.log(`Total Documents: ${chalk.bold(stats.totalDocuments)}`);\n        console.log(`User Documents: ${chalk.bold(stats.userDocuments)}`);\n        \n        if (stats.teamDocuments !== undefined) {\n          console.log(`Team Documents: ${chalk.bold(stats.teamDocuments)}`);\n        }\n\n        console.log('\\nDocuments by Type:');\n        for (const [type, count] of Object.entries(stats.documentsByType)) {\n          console.log(`  ${type}: ${count}`);\n        }\n      } catch (error) {\n        spinner.fail('Failed to get statistics');\n        logger.error('Stats error', error);\n        console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));\n      }\n    });\n\n  // Clean old contexts\n  chromadb\n    .command('clean')\n    .description('Clean old contexts')\n    .option('--days <n>', 'Delete contexts older than N days', '30')\n    .action(async (options) => {\n      const spinner = ora('Cleaning old contexts...').start();\n\n      try {\n        const config = {\n          apiKey: process.env.CHROMADB_API_KEY || '',\n          tenant: process.env.CHROMADB_TENANT || '',\n          database: process.env.CHROMADB_DATABASE || 'stackmemory',\n        };\n\n        const userId = process.env.USER || 'default';\n        const teamId = process.env.CHROMADB_TEAM_ID;\n\n        const adapter = new ChromaDBAdapter(config, userId, teamId);\n        await adapter.initialize();\n\n        const deleted = await adapter.deleteOldContexts(parseInt(options.days));\n\n        spinner.succeed(`Deleted ${deleted} old contexts`);\n      } catch (error) {\n        spinner.fail('Failed to clean contexts');\n        logger.error('Clean error', error);\n        console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));\n      }\n    });\n\n  return chromadb;\n}"],
+  "mappings": "AAMA,SAAS,eAAe;AACxB,OAAO,WAAW;AAClB,OAAO,SAAS;AAChB,SAAS,uBAAuB;AAChC,SAAS,oBAAoB;AAC7B,SAAS,cAAc;AACvB,OAAO,WAAW;AAClB,OAAO,YAAY;AACnB,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAC9B,OAAO,QAAQ;AAEf,MAAM,YAAY,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AAG7D,OAAO,OAAO;AAAA,EACZ,MAAM,KAAK,KAAK,WAAW,eAAe;AAAA,EAC1C,UAAU;AAAA,EACV,QAAQ;AACV,CAAC;AAED,MAAM,SAAS,IAAI,OAAO,cAAc;AAEjC,SAAS,wBAAiC;AAC/C,QAAM,WAAW,IAAI,QAAQ,UAAU,EACpC,YAAY,4CAA4C,EACxD,MAAM,QAAQ;AAGjB,WACG,QAAQ,MAAM,EACd,YAAY,gCAAgC,EAC5C,OAAO,mBAAmB,kBAAkB,EAC5C,OAAO,qBAAqB,oBAAoB,EAChD,OAAO,yBAAyB,wBAAwB,EACxD,OAAO,kBAAkB,0BAA0B,EACnD,OAAO,kBAAkB,0BAA0B,EACnD,OAAO,OAAO,YAAY;AACzB,UAAM,UAAU,IAAI,0BAA0B,EAAE,MAAM;AAEtD,QAAI;AAEF,YAAM,SAAS;AAAA,QACb,QAAQ,QAAQ,UAAU,QAAQ,IAAI,oBAAoB;AAAA,QAC1D,QAAQ,QAAQ,UAAU,QAAQ,IAAI,mBAAmB;AAAA,QACzD,UAAU,QAAQ,YAAY,QAAQ,IAAI,qBAAqB;AAAA,MACjE;AAEA,YAAM,SAAS,QAAQ,UAAU,QAAQ,IAAI,QAAQ;AACrD,YAAM,SAAS,QAAQ,UAAU,QAAQ,IAAI;AAE7C,UAAI,CAAC,OAAO,UAAU,CAAC,OAAO,QAAQ;AACpC,gBAAQ,KAAK,8BAA8B;AAC3C,gBAAQ,IAAI,MAAM,OAAO,mBAAmB,CAAC;AAC7C,gBAAQ,IAAI,uCAAuC;AACnD,gBAAQ,IAAI,yCAAyC;AACrD,gBAAQ,IAAI,iCAAiC;AAC7C,gBAAQ,IAAI,oBAAoB;AAChC,gBAAQ,IAAI,mBAAmB;AAC/B;AAAA,MACF;AAGA,YAAM,UAAU,IAAI,gBAAgB,QAAQ,QAAQ,MAAM;AAC1D,YAAM,QAAQ,WAAW;AAGzB,YAAM,UAAU,KAAK,KAAK,WAAW,eAAe;AACpD,UAAI,aAAa;AAEjB,UAAI,GAAG,WAAW,OAAO,GAAG;AAC1B,qBAAa,GAAG,aAAa,SAAS,MAAM;AAAA,MAC9C;AAEA,YAAM,UAAoB,CAAC;AAC3B,UAAI,CAAC,WAAW,SAAS,kBAAkB,GAAG;AAC5C,gBAAQ,KAAK,oBAAoB,OAAO,MAAM,EAAE;AAAA,MAClD;AACA,UAAI,CAAC,WAAW,SAAS,iBAAiB,GAAG;AAC3C,gBAAQ,KAAK,mBAAmB,OAAO,MAAM,EAAE;AAAA,MACjD;AACA,UAAI,CAAC,WAAW,SAAS,mBAAmB,GAAG;AAC7C,gBAAQ,KAAK,qBAAqB,OAAO,QAAQ,EAAE;AAAA,MACrD;AAEA,UAAI,QAAQ,SAAS,GAAG;AACtB,WAAG,eAAe,SAAS,iCAAiC,QAAQ,KAAK,IAAI,IAAI,IAAI;AAAA,MACvF;AAEA,cAAQ,QAAQ,mCAAmC;AAEnD,cAAQ,IAAI,MAAM,MAAM,yBAAoB,CAAC;AAC7C,cAAQ,IAAI,aAAa,OAAO,MAAM,EAAE;AACxC,cAAQ,IAAI,eAAe,OAAO,QAAQ,EAAE;AAC5C,cAAQ,IAAI,cAAc,MAAM,EAAE;AAClC,UAAI,QAAQ;AACV,gBAAQ,IAAI,cAAc,MAAM,EAAE;AAAA,MACpC;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,KAAK,+BAA+B;AAC5C,aAAO,MAAM,wBAAwB,KAAK;AAC1C,cAAQ,MAAM,MAAM,IAAI,iBAAiB,QAAQ,MAAM,UAAU,eAAe,CAAC;AAAA,IACnF;AAAA,EACF,CAAC;AAGH,WACG,QAAQ,OAAO,EACf,YAAY,mCAAmC,EAC/C,OAAO,iBAAiB,6CAA6C,OAAO,EAC5E,OAAO,uBAAuB,kBAAkB,EAChD,OAAO,oBAAoB,cAAc,EACzC,OAAO,OAAO,YAAY;AACzB,UAAM,UAAU,IAAI,oBAAoB,EAAE,MAAM;AAEhD,QAAI;AACF,YAAM,SAAS;AAAA,QACb,QAAQ,QAAQ,IAAI,oBAAoB;AAAA,QACxC,QAAQ,QAAQ,IAAI,mBAAmB;AAAA,QACvC,UAAU,QAAQ,IAAI,qBAAqB;AAAA,MAC7C;AAEA,YAAM,SAAS,QAAQ,IAAI,QAAQ;AACnC,YAAM,SAAS,QAAQ,IAAI;AAE3B,YAAM,UAAU,IAAI,gBAAgB,QAAQ,QAAQ,MAAM;AAC1D,YAAM,QAAQ,WAAW;AAEzB,UAAI,QAAQ,SAAS,SAAS;AAE5B,cAAM,eAAe,IAAI,aAAa;AACtC,cAAM,SAAS,aAAa,aAAa;AAEzC,mBAAW,SAAS,QAAQ;AAC1B,gBAAM,QAAQ,WAAW,KAAK;AAAA,QAChC;AAEA,gBAAQ,QAAQ,UAAU,OAAO,MAAM,SAAS;AAAA,MAClD,OAAO;AAEL,cAAM,UAAU,QAAQ,WAAW,GAAG,QAAQ,IAAI,QAAO,oBAAI,KAAK,GAAE,YAAY,CAAC;AACjF,cAAM,WAAgB;AAAA,UACpB,cAAc,QAAQ,WAAW,KAAK,SAAS,QAAQ,IAAI,CAAC;AAAA,QAC9D;AAGA,YAAI,QAAQ,IAAI,wBAAwB;AACtC,mBAAS,aAAa,QAAQ,IAAI;AAAA,QACpC;AAEA,cAAM,QAAQ;AAAA,UACZ,QAAQ;AAAA,UACR;AAAA,UACA;AAAA,QACF;AAEA,gBAAQ,QAAQ,UAAU,QAAQ,IAAI,EAAE;AAAA,MAC1C;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,KAAK,yBAAyB;AACtC,aAAO,MAAM,eAAe,KAAK;AACjC,cAAQ,MAAM,MAAM,IAAI,iBAAiB,QAAQ,MAAM,UAAU,eAAe,CAAC;AAAA,IACnF;AAAA,EACF,CAAC;AAGH,WACG,QAAQ,gBAAgB,EACxB,YAAY,8BAA8B,EAC1C,OAAO,eAAe,qBAAqB,IAAI,EAC/C,OAAO,iBAAiB,gBAAgB,EACxC,OAAO,oBAAoB,mBAAmB,EAC9C,OAAO,OAAO,QAAQ,YAAY;AACjC,UAAM,UAAU,IAAI,cAAc,EAAE,MAAM;AAE1C,QAAI;AACF,YAAM,SAAS;AAAA,QACb,QAAQ,QAAQ,IAAI,oBAAoB;AAAA,QACxC,QAAQ,QAAQ,IAAI,mBAAmB;AAAA,QACvC,UAAU,QAAQ,IAAI,qBAAqB;AAAA,MAC7C;AAEA,YAAM,SAAS,QAAQ,IAAI,QAAQ;AACnC,YAAM,SAAS,QAAQ,IAAI;AAE3B,YAAM,UAAU,IAAI,gBAAgB,QAAQ,QAAQ,MAAM;AAC1D,YAAM,QAAQ,WAAW;AAEzB,YAAM,UAAe,CAAC;AACtB,UAAI,QAAQ,MAAM;AAChB,gBAAQ,OAAO,CAAC,QAAQ,IAAI;AAAA,MAC9B;AACA,UAAI,QAAQ,SAAS;AACnB,gBAAQ,cAAc,QAAQ;AAAA,MAChC;AAEA,YAAM,UAAU,MAAM,QAAQ;AAAA,QAC5B;AAAA,QACA,SAAS,QAAQ,KAAK;AAAA,QACtB;AAAA,MACF;AAEA,cAAQ,KAAK;AAEb,UAAI,QAAQ,WAAW,GAAG;AACxB,gBAAQ,IAAI,MAAM,OAAO,kBAAkB,CAAC;AAC5C;AAAA,MACF;AAGA,YAAM,QAAQ,IAAI,MAAM;AAAA,QACtB,MAAM,CAAC,QAAQ,WAAW,WAAW,UAAU;AAAA,QAC/C,WAAW,CAAC,IAAI,IAAI,IAAI,EAAE;AAAA,QAC1B,UAAU;AAAA,MACZ,CAAC;AAED,iBAAW,UAAU,SAAS;AAC5B,cAAM,UAAU,OAAO,QAAQ,UAAU,GAAG,GAAG,KAC9B,OAAO,QAAQ,SAAS,MAAM,QAAQ;AAEvD,cAAM,KAAK;AAAA,UACT,OAAO,SAAS,QAAQ;AAAA,UACxB,OAAO,SAAS,gBAAgB;AAAA,UAChC;AAAA,UACA,OAAO,SAAS,QAAQ,CAAC;AAAA,QAC3B,CAAC;AAAA,MACH;AAEA,cAAQ,IAAI,MAAM,SAAS,CAAC;AAC5B,cAAQ,IAAI,MAAM,MAAM;AAAA,eAAa,QAAQ,MAAM,UAAU,CAAC;AAAA,IAChE,SAAS,OAAO;AACd,cAAQ,KAAK,0BAA0B;AACvC,aAAO,MAAM,eAAe,KAAK;AACjC,cAAQ,MAAM,MAAM,IAAI,iBAAiB,QAAQ,MAAM,UAAU,eAAe,CAAC;AAAA,IACnF;AAAA,EACF,CAAC;AAGH,WACG,QAAQ,QAAQ,EAChB,YAAY,qBAAqB,EACjC,OAAO,eAAe,qBAAqB,IAAI,EAC/C,OAAO,iBAAiB,gBAAgB,EACxC,OAAO,OAAO,YAAY;AACzB,UAAM,UAAU,IAAI,6BAA6B,EAAE,MAAM;AAEzD,QAAI;AACF,YAAM,SAAS;AAAA,QACb,QAAQ,QAAQ,IAAI,oBAAoB;AAAA,QACxC,QAAQ,QAAQ,IAAI,mBAAmB;AAAA,QACvC,UAAU,QAAQ,IAAI,qBAAqB;AAAA,MAC7C;AAEA,YAAM,SAAS,QAAQ,IAAI,QAAQ;AACnC,YAAM,SAAS,QAAQ,IAAI;AAE3B,YAAM,UAAU,IAAI,gBAAgB,QAAQ,QAAQ,MAAM;AAC1D,YAAM,QAAQ,WAAW;AAEzB,YAAM,UAAU,MAAM,QAAQ;AAAA,QAC5B,SAAS,QAAQ,KAAK;AAAA,QACtB,QAAQ;AAAA,MACV;AAEA,cAAQ,KAAK;AAEb,UAAI,QAAQ,WAAW,GAAG;AACxB,gBAAQ,IAAI,MAAM,OAAO,0BAA0B,CAAC;AACpD;AAAA,MACF;AAGA,YAAM,QAAQ,IAAI,MAAM;AAAA,QACtB,MAAM,CAAC,QAAQ,QAAQ,WAAW,SAAS;AAAA,QAC3C,WAAW,CAAC,IAAI,IAAI,IAAI,EAAE;AAAA,QAC1B,UAAU;AAAA,MACZ,CAAC;AAED,iBAAW,UAAU,SAAS;AAC5B,cAAM,OAAO,IAAI,KAAK,OAAO,SAAS,SAAS,EAAE,eAAe;AAChE,cAAM,UAAU,OAAO,QAAQ,UAAU,GAAG,GAAG,KAC9B,OAAO,QAAQ,SAAS,MAAM,QAAQ;AAEvD,cAAM,KAAK;AAAA,UACT;AAAA,UACA,OAAO,SAAS,QAAQ;AAAA,UACxB,OAAO,SAAS,gBAAgB;AAAA,UAChC;AAAA,QACF,CAAC;AAAA,MACH;AAEA,cAAQ,IAAI,MAAM,SAAS,CAAC;AAC5B,cAAQ,IAAI,MAAM,MAAM;AAAA,eAAa,QAAQ,MAAM,kBAAkB,CAAC;AAAA,IACxE,SAAS,OAAO;AACd,cAAQ,KAAK,+BAA+B;AAC5C,aAAO,MAAM,gBAAgB,KAAK;AAClC,cAAQ,MAAM,MAAM,IAAI,iBAAiB,QAAQ,MAAM,UAAU,eAAe,CAAC;AAAA,IACnF;AAAA,EACF,CAAC;AAGH,WACG,QAAQ,OAAO,EACf,YAAY,iCAAiC,EAC7C,OAAO,YAAY;AAClB,UAAM,UAAU,IAAI,wBAAwB,EAAE,MAAM;AAEpD,QAAI;AACF,YAAM,SAAS;AAAA,QACb,QAAQ,QAAQ,IAAI,oBAAoB;AAAA,QACxC,QAAQ,QAAQ,IAAI,mBAAmB;AAAA,QACvC,UAAU,QAAQ,IAAI,qBAAqB;AAAA,MAC7C;AAEA,YAAM,SAAS,QAAQ,IAAI,QAAQ;AACnC,YAAM,SAAS,QAAQ,IAAI;AAE3B,YAAM,UAAU,IAAI,gBAAgB,QAAQ,QAAQ,MAAM;AAC1D,YAAM,QAAQ,WAAW;AAEzB,YAAM,QAAQ,MAAM,QAAQ,SAAS;AAErC,cAAQ,KAAK;AAEb,cAAQ,IAAI,MAAM,KAAK,mCAA4B,CAAC;AACpD,cAAQ,IAAI,oBAAoB,MAAM,KAAK,MAAM,cAAc,CAAC,EAAE;AAClE,cAAQ,IAAI,mBAAmB,MAAM,KAAK,MAAM,aAAa,CAAC,EAAE;AAEhE,UAAI,MAAM,kBAAkB,QAAW;AACrC,gBAAQ,IAAI,mBAAmB,MAAM,KAAK,MAAM,aAAa,CAAC,EAAE;AAAA,MAClE;AAEA,cAAQ,IAAI,sBAAsB;AAClC,iBAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,MAAM,eAAe,GAAG;AACjE,gBAAQ,IAAI,KAAK,IAAI,KAAK,KAAK,EAAE;AAAA,MACnC;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,KAAK,0BAA0B;AACvC,aAAO,MAAM,eAAe,KAAK;AACjC,cAAQ,MAAM,MAAM,IAAI,iBAAiB,QAAQ,MAAM,UAAU,eAAe,CAAC;AAAA,IACnF;AAAA,EACF,CAAC;AAGH,WACG,QAAQ,OAAO,EACf,YAAY,oBAAoB,EAChC,OAAO,cAAc,qCAAqC,IAAI,EAC9D,OAAO,OAAO,YAAY;AACzB,UAAM,UAAU,IAAI,0BAA0B,EAAE,MAAM;AAEtD,QAAI;AACF,YAAM,SAAS;AAAA,QACb,QAAQ,QAAQ,IAAI,oBAAoB;AAAA,QACxC,QAAQ,QAAQ,IAAI,mBAAmB;AAAA,QACvC,UAAU,QAAQ,IAAI,qBAAqB;AAAA,MAC7C;AAEA,YAAM,SAAS,QAAQ,IAAI,QAAQ;AACnC,YAAM,SAAS,QAAQ,IAAI;AAE3B,YAAM,UAAU,IAAI,gBAAgB,QAAQ,QAAQ,MAAM;AAC1D,YAAM,QAAQ,WAAW;AAEzB,YAAM,UAAU,MAAM,QAAQ,kBAAkB,SAAS,QAAQ,IAAI,CAAC;AAEtE,cAAQ,QAAQ,WAAW,OAAO,eAAe;AAAA,IACnD,SAAS,OAAO;AACd,cAAQ,KAAK,0BAA0B;AACvC,aAAO,MAAM,eAAe,KAAK;AACjC,cAAQ,MAAM,MAAM,IAAI,iBAAiB,QAAQ,MAAM,UAAU,eAAe,CAAC;AAAA,IACnF;AAAA,EACF,CAAC;AAEH,SAAO;AACT;",
+  "names": []
+}

package/dist/cli/commands/clear.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import * as fs from "fs/promises";
+import * as path from "path";
+import Database from "better-sqlite3";
+import { existsSync } from "fs";
+import { ClearSurvival } from "../../core/session/clear-survival-stub.js";
+import { FrameManager } from "../../core/context/frame-manager.js";
+import { sessionManager } from "../../core/session/session-manager.js";
+const clearCommand = new Command("clear").description("Manage context clearing with ledger preservation").option("--save", "Save continuity ledger before clearing").option("--restore", "Restore from continuity ledger").option("--check", "Check if clear is recommended").option("--auto", "Automatically save if needed and clear").option("--status", "Show current context usage").option("--show-ledger", "Display current ledger").action(async (options) => {
+  const spinner = ora();
+  try {
+    const projectRoot = process.cwd();
+    const dbPath = path.join(projectRoot, ".stackmemory", "context.db");
+    if (!existsSync(dbPath)) {
+      console.error(
+        chalk.red("\u2717 StackMemory not initialized in this directory")
+      );
+      console.log(chalk.yellow("Run: stackmemory init"));
+      process.exit(1);
+    }
+    const db = new Database(dbPath);
+    await sessionManager.initialize();
+    const session = await sessionManager.getOrCreateSession({
+      projectPath: projectRoot
+    });
+    const frameManager = new FrameManager(db, session.projectId);
+    const handoffGenerator = {
+      generateHandoff: () => Promise.resolve("Mock handoff"),
+      getHandoffPath: () => "mock.md"
+    };
+    const clearSurvival = new ClearSurvival(
+      frameManager,
+      handoffGenerator,
+      projectRoot
+    );
+    if (options.status) {
+      await showContextStatus(clearSurvival);
+    } else if (options.check) {
+      await checkIfClearRecommended(clearSurvival);
+    } else if (options.save) {
+      await saveLedger(clearSurvival, spinner);
+    } else if (options.restore) {
+      await restoreFromLedger(clearSurvival, spinner);
+    } else if (options.showLedger) {
+      await showLedger(projectRoot);
+    } else if (options.auto) {
+      await autoClear(clearSurvival, spinner);
+    } else {
+      await showContextStatus(clearSurvival);
+      console.log("\nOptions:");
+      console.log("  --status     Show current context usage");
+      console.log("  --check      Check if clear is recommended");
+      console.log("  --save       Save continuity ledger");
+      console.log("  --restore    Restore from ledger");
+      console.log("  --auto       Auto-save if needed and clear");
+    }
+  } catch (error) {
+    console.error(chalk.red("Error: " + error.message));
+    if (process.env.NODE_ENV !== "test") {
+      process.exit(1);
+    }
+  }
+});
+async function showContextStatus(clearSurvival) {
+  const usage = await clearSurvival.getContextUsage();
+  const status = clearSurvival.assessContextStatus(usage);
+  console.log(chalk.bold("\n\u{1F4CA} Context Usage Status"));
+  console.log("\u2500".repeat(40));
+  const percentage = Math.round(usage.percentageUsed);
+  const statusColor = getStatusColor(status);
+  console.log(`Usage: ${percentage}% ${getProgressBar(percentage)}`);
+  console.log(`Status: ${statusColor}`);
+  console.log(`Active Frames: ${usage.activeFrames}`);
+  console.log(`Total Frames: ${usage.totalFrames}`);
+  console.log(`Sessions: ${usage.sessionCount}`);
+  if (status === "critical" || status === "saved") {
+    console.log(
+      chalk.yellow("\n\u26A0\uFE0F  Consider clearing context to improve performance")
+    );
+    console.log(chalk.cyan("Run: stackmemory clear --save"));
+  }
+}
+async function checkIfClearRecommended(clearSurvival) {
+  const usage = await clearSurvival.getContextUsage();
+  const status = clearSurvival.assessContextStatus(usage);
+  if (status === "critical" || status === "saved") {
+    console.log(chalk.yellow("\u2713 Clear recommended"));
+    console.log(`Context usage: ${Math.round(usage.percentageUsed)}%`);
+    process.exit(0);
+  } else {
+    console.log(chalk.green("\u2717 Clear not needed"));
+    console.log(`Context usage: ${Math.round(usage.percentageUsed)}%`);
+    process.exit(1);
+  }
+}
+async function saveLedger(clearSurvival, spinner) {
+  spinner.start("Saving continuity ledger...");
+  const ledgerPath = await clearSurvival.saveContinuityLedger();
+  spinner.succeed(chalk.green("Continuity ledger saved"));
+  console.log(chalk.cyan(`Location: ${ledgerPath}`));
+  const ledger = JSON.parse(await fs.readFile(ledgerPath, "utf-8"));
+  console.log("\nSaved:");
+  console.log(`  \u2022 ${ledger.activeFrames.length} active frames`);
+  console.log(`  \u2022 ${ledger.decisions.length} key decisions`);
+  console.log(`  \u2022 ${ledger.context.importantTasks?.length || 0} important tasks`);
+}
+async function restoreFromLedger(clearSurvival, spinner) {
+  spinner.start("Restoring from continuity ledger...");
+  const result = await clearSurvival.restoreFromLedger();
+  if (result.success) {
+    spinner.succeed(chalk.green("Context restored from ledger"));
+    console.log("\nRestored:");
+    console.log(`  \u2022 ${result.restoredFrames} frames`);
+    console.log(`  \u2022 ${result.restoredDecisions} decisions`);
+  } else {
+    spinner.fail(chalk.red("Failed to restore from ledger"));
+    console.log(chalk.yellow(result.message));
+  }
+}
+async function showLedger(projectRoot) {
+  const ledgerPath = path.join(projectRoot, ".stackmemory", "continuity.json");
+  if (!existsSync(ledgerPath)) {
+    console.log(chalk.yellow("No continuity ledger found"));
+    return;
+  }
+  const ledger = JSON.parse(await fs.readFile(ledgerPath, "utf-8"));
+  console.log(chalk.bold("\n\u{1F4D6} Continuity Ledger"));
+  console.log("\u2500".repeat(40));
+  console.log(`Created: ${new Date(ledger.timestamp).toLocaleString()}`);
+  console.log(`Active Frames: ${ledger.activeFrames.length}`);
+  console.log(`Key Decisions: ${ledger.decisions.length}`);
+  if (ledger.activeFrames.length > 0) {
+    console.log("\nActive Work:");
+    ledger.activeFrames.slice(0, 5).forEach((frame) => {
+      console.log(`  \u2022 ${frame.name} (${frame.type})`);
+    });
+  }
+  if (ledger.decisions.length > 0) {
+    console.log("\nKey Decisions:");
+    ledger.decisions.slice(0, 3).forEach((decision) => {
+      console.log(`  \u2022 ${decision.decision}`);
+    });
+  }
+}
+async function autoClear(clearSurvival, spinner) {
+  const usage = await clearSurvival.getContextUsage();
+  const status = clearSurvival.assessContextStatus(usage);
+  if (status === "critical" || status === "saved") {
+    spinner.start("Auto-saving ledger before clear...");
+    await clearSurvival.saveContinuityLedger();
+    spinner.succeed("Ledger saved");
+    spinner.start("Clearing context...");
+    await new Promise((resolve) => setTimeout(resolve, 1e3));
+    spinner.succeed("Context cleared successfully");
+  } else {
+    console.log(chalk.green("Context usage is healthy, no clear needed"));
+  }
+}
+function getProgressBar(percentage) {
+  const filled = Math.round(percentage / 5);
+  const empty = 20 - filled;
+  let bar = "[";
+  bar += chalk.green("\u25A0").repeat(Math.min(filled, 10));
+  bar += chalk.yellow("\u25A0").repeat(Math.max(0, Math.min(filled - 10, 5)));
+  bar += chalk.red("\u25A0").repeat(Math.max(0, filled - 15));
+  bar += chalk.gray("\u25A1").repeat(empty);
+  bar += "]";
+  return bar;
+}
+function getStatusColor(status) {
+  switch (status) {
+    case "healthy":
+      return chalk.green("\u2713 Healthy (<50%)");
+    case "moderate":
+      return chalk.blue("\u26A1 Moderate (50-70%)");
+    case "critical":
+      return chalk.yellow("\u26A0\uFE0F Critical (70-85%)");
+    case "saved":
+      return chalk.red("\u{1F4BE} Auto-saved (>85%)");
+    default:
+      return status;
+  }
+}
+var clear_default = clearCommand;
+export {
+  clear_default as default
+};
+//# sourceMappingURL=clear.js.map

package/dist/cli/commands/clear.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/commands/clear.ts"],
+  "sourcesContent": ["#!/usr/bin/env node\n/**\n * Clear command for StackMemory\n * Manages context clearing with ledger preservation\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport * as fs from 'fs/promises';\nimport * as path from 'path';\nimport Database from 'better-sqlite3';\nimport { existsSync } from 'fs';\nimport { ClearSurvival } from '../../core/session/clear-survival-stub.js';\nimport { FrameManager } from '../../core/context/frame-manager.js';\nimport { HandoffGenerator } from '../../core/session/handoff-generator.js';\nimport { sessionManager } from '../../core/session/session-manager.js';\n\nconst clearCommand = new Command('clear')\n  .description('Manage context clearing with ledger preservation')\n  .option('--save', 'Save continuity ledger before clearing')\n  .option('--restore', 'Restore from continuity ledger')\n  .option('--check', 'Check if clear is recommended')\n  .option('--auto', 'Automatically save if needed and clear')\n  .option('--status', 'Show current context usage')\n  .option('--show-ledger', 'Display current ledger')\n  .action(async (options) => {\n    const spinner = ora();\n\n    try {\n      // Initialize managers\n      const projectRoot = process.cwd();\n      const dbPath = path.join(projectRoot, '.stackmemory', 'context.db');\n\n      // Check if StackMemory is initialized\n      if (!existsSync(dbPath)) {\n        console.error(\n          chalk.red('\u2717 StackMemory not initialized in this directory')\n        );\n        console.log(chalk.yellow('Run: stackmemory init'));\n        process.exit(1);\n      }\n\n      const db = new Database(dbPath);\n      \n      // Initialize session manager\n      await sessionManager.initialize();\n      const session = await sessionManager.getOrCreateSession({\n        projectPath: projectRoot,\n      });\n\n      const frameManager = new FrameManager(db, session.projectId);\n      // For testing - use a mock handoff generator\n      const handoffGenerator = {\n        generateHandoff: () => Promise.resolve('Mock handoff'),\n        getHandoffPath: () => 'mock.md'\n      };\n      const clearSurvival = new ClearSurvival(\n        frameManager,\n        handoffGenerator,\n        projectRoot\n      );\n\n      // Handle different options\n      if (options.status) {\n        await showContextStatus(clearSurvival);\n      } else if (options.check) {\n        await checkIfClearRecommended(clearSurvival);\n      } else if (options.save) {\n        await saveLedger(clearSurvival, spinner);\n      } else if (options.restore) {\n        await restoreFromLedger(clearSurvival, spinner);\n      } else if (options.showLedger) {\n        await showLedger(projectRoot);\n      } else if (options.auto) {\n        await autoClear(clearSurvival, spinner);\n      } else {\n        // Default: Show status and options\n        await showContextStatus(clearSurvival);\n        console.log('\\nOptions:');\n        console.log('  --status     Show current context usage');\n        console.log('  --check      Check if clear is recommended');\n        console.log('  --save       Save continuity ledger');\n        console.log('  --restore    Restore from ledger');\n        console.log('  --auto       Auto-save if needed and clear');\n      }\n    } catch (error) {\n      // Don't exit in tests - just log the error\n      console.error(chalk.red('Error: ' + (error as Error).message));\n      if (process.env.NODE_ENV !== 'test') {\n        process.exit(1);\n      }\n    }\n  });\n\nasync function showContextStatus(clearSurvival: ClearSurvival): Promise<void> {\n  const usage = await clearSurvival.getContextUsage();\n  const status = clearSurvival.assessContextStatus(usage);\n\n  console.log(chalk.bold('\\n\uD83D\uDCCA Context Usage Status'));\n  console.log('\u2500'.repeat(40));\n  \n  const percentage = Math.round(usage.percentageUsed);\n  const statusColor = getStatusColor(status);\n  \n  console.log(`Usage: ${percentage}% ${getProgressBar(percentage)}`);\n  console.log(`Status: ${statusColor}`);\n  console.log(`Active Frames: ${usage.activeFrames}`);\n  console.log(`Total Frames: ${usage.totalFrames}`);\n  console.log(`Sessions: ${usage.sessionCount}`);\n  \n  if (status === 'critical' || status === 'saved') {\n    console.log(\n      chalk.yellow('\\n\u26A0\uFE0F  Consider clearing context to improve performance')\n    );\n    console.log(chalk.cyan('Run: stackmemory clear --save'));\n  }\n}\n\nasync function checkIfClearRecommended(clearSurvival: ClearSurvival): Promise<void> {\n  const usage = await clearSurvival.getContextUsage();\n  const status = clearSurvival.assessContextStatus(usage);\n  \n  if (status === 'critical' || status === 'saved') {\n    console.log(chalk.yellow('\u2713 Clear recommended'));\n    console.log(`Context usage: ${Math.round(usage.percentageUsed)}%`);\n    process.exit(0);\n  } else {\n    console.log(chalk.green('\u2717 Clear not needed'));\n    console.log(`Context usage: ${Math.round(usage.percentageUsed)}%`);\n    process.exit(1);\n  }\n}\n\nasync function saveLedger(clearSurvival: ClearSurvival, spinner: ora.Ora): Promise<void> {\n  spinner.start('Saving continuity ledger...');\n  \n  const ledgerPath = await clearSurvival.saveContinuityLedger();\n  \n  spinner.succeed(chalk.green('Continuity ledger saved'));\n  console.log(chalk.cyan(`Location: ${ledgerPath}`));\n  \n  // Show what was saved\n  const ledger = JSON.parse(await fs.readFile(ledgerPath, 'utf-8'));\n  console.log('\\nSaved:');\n  console.log(`  \u2022 ${ledger.activeFrames.length} active frames`);\n  console.log(`  \u2022 ${ledger.decisions.length} key decisions`);\n  console.log(`  \u2022 ${ledger.context.importantTasks?.length || 0} important tasks`);\n}\n\nasync function restoreFromLedger(clearSurvival: ClearSurvival, spinner: ora.Ora): Promise<void> {\n  spinner.start('Restoring from continuity ledger...');\n  \n  const result = await clearSurvival.restoreFromLedger();\n  \n  if (result.success) {\n    spinner.succeed(chalk.green('Context restored from ledger'));\n    console.log('\\nRestored:');\n    console.log(`  \u2022 ${result.restoredFrames} frames`);\n    console.log(`  \u2022 ${result.restoredDecisions} decisions`);\n  } else {\n    spinner.fail(chalk.red('Failed to restore from ledger'));\n    console.log(chalk.yellow(result.message));\n  }\n}\n\nasync function showLedger(projectRoot: string): Promise<void> {\n  const ledgerPath = path.join(projectRoot, '.stackmemory', 'continuity.json');\n  \n  if (!existsSync(ledgerPath)) {\n    console.log(chalk.yellow('No continuity ledger found'));\n    return;\n  }\n  \n  const ledger = JSON.parse(await fs.readFile(ledgerPath, 'utf-8'));\n  \n  console.log(chalk.bold('\\n\uD83D\uDCD6 Continuity Ledger'));\n  console.log('\u2500'.repeat(40));\n  console.log(`Created: ${new Date(ledger.timestamp).toLocaleString()}`);\n  console.log(`Active Frames: ${ledger.activeFrames.length}`);\n  console.log(`Key Decisions: ${ledger.decisions.length}`);\n  \n  if (ledger.activeFrames.length > 0) {\n    console.log('\\nActive Work:');\n    ledger.activeFrames.slice(0, 5).forEach((frame: any) => {\n      console.log(`  \u2022 ${frame.name} (${frame.type})`);\n    });\n  }\n  \n  if (ledger.decisions.length > 0) {\n    console.log('\\nKey Decisions:');\n    ledger.decisions.slice(0, 3).forEach((decision: any) => {\n      console.log(`  \u2022 ${decision.decision}`);\n    });\n  }\n}\n\nasync function autoClear(clearSurvival: ClearSurvival, spinner: ora.Ora): Promise<void> {\n  const usage = await clearSurvival.getContextUsage();\n  const status = clearSurvival.assessContextStatus(usage);\n  \n  if (status === 'critical' || status === 'saved') {\n    spinner.start('Auto-saving ledger before clear...');\n    await clearSurvival.saveContinuityLedger();\n    spinner.succeed('Ledger saved');\n    \n    spinner.start('Clearing context...');\n    // Note: Actual clear implementation would go here\n    // For now, just simulate\n    await new Promise(resolve => setTimeout(resolve, 1000));\n    spinner.succeed('Context cleared successfully');\n  } else {\n    console.log(chalk.green('Context usage is healthy, no clear needed'));\n  }\n}\n\nfunction getProgressBar(percentage: number): string {\n  const filled = Math.round(percentage / 5);\n  const empty = 20 - filled;\n  \n  let bar = '[';\n  bar += chalk.green('\u25A0').repeat(Math.min(filled, 10));\n  bar += chalk.yellow('\u25A0').repeat(Math.max(0, Math.min(filled - 10, 5)));\n  bar += chalk.red('\u25A0').repeat(Math.max(0, filled - 15));\n  bar += chalk.gray('\u25A1').repeat(empty);\n  bar += ']';\n  \n  return bar;\n}\n\nfunction getStatusColor(status: string): string {\n  switch (status) {\n    case 'healthy':\n      return chalk.green('\u2713 Healthy (<50%)');\n    case 'moderate':\n      return chalk.blue('\u26A1 Moderate (50-70%)');\n    case 'critical':\n      return chalk.yellow('\u26A0\uFE0F Critical (70-85%)');\n    case 'saved':\n      return chalk.red('\uD83D\uDCBE Auto-saved (>85%)');\n    default:\n      return status;\n  }\n}\n\n// Export for use in main CLI\nexport default clearCommand;"],
+  "mappings": ";AAMA,SAAS,eAAe;AACxB,OAAO,WAAW;AAClB,OAAO,SAAS;AAChB,YAAY,QAAQ;AACpB,YAAY,UAAU;AACtB,OAAO,cAAc;AACrB,SAAS,kBAAkB;AAC3B,SAAS,qBAAqB;AAC9B,SAAS,oBAAoB;AAE7B,SAAS,sBAAsB;AAE/B,MAAM,eAAe,IAAI,QAAQ,OAAO,EACrC,YAAY,kDAAkD,EAC9D,OAAO,UAAU,wCAAwC,EACzD,OAAO,aAAa,gCAAgC,EACpD,OAAO,WAAW,+BAA+B,EACjD,OAAO,UAAU,wCAAwC,EACzD,OAAO,YAAY,4BAA4B,EAC/C,OAAO,iBAAiB,wBAAwB,EAChD,OAAO,OAAO,YAAY;AACzB,QAAM,UAAU,IAAI;AAEpB,MAAI;AAEF,UAAM,cAAc,QAAQ,IAAI;AAChC,UAAM,SAAS,KAAK,KAAK,aAAa,gBAAgB,YAAY;AAGlE,QAAI,CAAC,WAAW,MAAM,GAAG;AACvB,cAAQ;AAAA,QACN,MAAM,IAAI,sDAAiD;AAAA,MAC7D;AACA,cAAQ,IAAI,MAAM,OAAO,uBAAuB,CAAC;AACjD,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,UAAM,KAAK,IAAI,SAAS,MAAM;AAG9B,UAAM,eAAe,WAAW;AAChC,UAAM,UAAU,MAAM,eAAe,mBAAmB;AAAA,MACtD,aAAa;AAAA,IACf,CAAC;AAED,UAAM,eAAe,IAAI,aAAa,IAAI,QAAQ,SAAS;AAE3D,UAAM,mBAAmB;AAAA,MACvB,iBAAiB,MAAM,QAAQ,QAAQ,cAAc;AAAA,MACrD,gBAAgB,MAAM;AAAA,IACxB;AACA,UAAM,gBAAgB,IAAI;AAAA,MACxB;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAGA,QAAI,QAAQ,QAAQ;AAClB,YAAM,kBAAkB,aAAa;AAAA,IACvC,WAAW,QAAQ,OAAO;AACxB,YAAM,wBAAwB,aAAa;AAAA,IAC7C,WAAW,QAAQ,MAAM;AACvB,YAAM,WAAW,eAAe,OAAO;AAAA,IACzC,WAAW,QAAQ,SAAS;AAC1B,YAAM,kBAAkB,eAAe,OAAO;AAAA,IAChD,WAAW,QAAQ,YAAY;AAC7B,YAAM,WAAW,WAAW;AAAA,IAC9B,WAAW,QAAQ,MAAM;AACvB,YAAM,UAAU,eAAe,OAAO;AAAA,IACxC,OAAO;AAEL,YAAM,kBAAkB,aAAa;AACrC,cAAQ,IAAI,YAAY;AACxB,cAAQ,IAAI,2CAA2C;AACvD,cAAQ,IAAI,8CAA8C;AAC1D,cAAQ,IAAI,uCAAuC;AACnD,cAAQ,IAAI,oCAAoC;AAChD,cAAQ,IAAI,8CAA8C;AAAA,IAC5D;AAAA,EACF,SAAS,OAAO;AAEd,YAAQ,MAAM,MAAM,IAAI,YAAa,MAAgB,OAAO,CAAC;AAC7D,QAAI,QAAQ,IAAI,aAAa,QAAQ;AACnC,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACF,CAAC;AAEH,eAAe,kBAAkB,eAA6C;AAC5E,QAAM,QAAQ,MAAM,cAAc,gBAAgB;AAClD,QAAM,SAAS,cAAc,oBAAoB,KAAK;AAEtD,UAAQ,IAAI,MAAM,KAAK,kCAA2B,CAAC;AACnD,UAAQ,IAAI,SAAI,OAAO,EAAE,CAAC;AAE1B,QAAM,aAAa,KAAK,MAAM,MAAM,cAAc;AAClD,QAAM,cAAc,eAAe,MAAM;AAEzC,UAAQ,IAAI,UAAU,UAAU,KAAK,eAAe,UAAU,CAAC,EAAE;AACjE,UAAQ,IAAI,WAAW,WAAW,EAAE;AACpC,UAAQ,IAAI,kBAAkB,MAAM,YAAY,EAAE;AAClD,UAAQ,IAAI,iBAAiB,MAAM,WAAW,EAAE;AAChD,UAAQ,IAAI,aAAa,MAAM,YAAY,EAAE;AAE7C,MAAI,WAAW,cAAc,WAAW,SAAS;AAC/C,YAAQ;AAAA,MACN,MAAM,OAAO,kEAAwD;AAAA,IACvE;AACA,YAAQ,IAAI,MAAM,KAAK,+BAA+B,CAAC;AAAA,EACzD;AACF;AAEA,eAAe,wBAAwB,eAA6C;AAClF,QAAM,QAAQ,MAAM,cAAc,gBAAgB;AAClD,QAAM,SAAS,cAAc,oBAAoB,KAAK;AAEtD,MAAI,WAAW,cAAc,WAAW,SAAS;AAC/C,YAAQ,IAAI,MAAM,OAAO,0BAAqB,CAAC;AAC/C,YAAQ,IAAI,kBAAkB,KAAK,MAAM,MAAM,cAAc,CAAC,GAAG;AACjE,YAAQ,KAAK,CAAC;AAAA,EAChB,OAAO;AACL,YAAQ,IAAI,MAAM,MAAM,yBAAoB,CAAC;AAC7C,YAAQ,IAAI,kBAAkB,KAAK,MAAM,MAAM,cAAc,CAAC,GAAG;AACjE,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;AAEA,eAAe,WAAW,eAA8B,SAAiC;AACvF,UAAQ,MAAM,6BAA6B;AAE3C,QAAM,aAAa,MAAM,cAAc,qBAAqB;AAE5D,UAAQ,QAAQ,MAAM,MAAM,yBAAyB,CAAC;AACtD,UAAQ,IAAI,MAAM,KAAK,aAAa,UAAU,EAAE,CAAC;AAGjD,QAAM,SAAS,KAAK,MAAM,MAAM,GAAG,SAAS,YAAY,OAAO,CAAC;AAChE,UAAQ,IAAI,UAAU;AACtB,UAAQ,IAAI,YAAO,OAAO,aAAa,MAAM,gBAAgB;AAC7D,UAAQ,IAAI,YAAO,OAAO,UAAU,MAAM,gBAAgB;AAC1D,UAAQ,IAAI,YAAO,OAAO,QAAQ,gBAAgB,UAAU,CAAC,kBAAkB;AACjF;AAEA,eAAe,kBAAkB,eAA8B,SAAiC;AAC9F,UAAQ,MAAM,qCAAqC;AAEnD,QAAM,SAAS,MAAM,cAAc,kBAAkB;AAErD,MAAI,OAAO,SAAS;AAClB,YAAQ,QAAQ,MAAM,MAAM,8BAA8B,CAAC;AAC3D,YAAQ,IAAI,aAAa;AACzB,YAAQ,IAAI,YAAO,OAAO,cAAc,SAAS;AACjD,YAAQ,IAAI,YAAO,OAAO,iBAAiB,YAAY;AAAA,EACzD,OAAO;AACL,YAAQ,KAAK,MAAM,IAAI,+BAA+B,CAAC;AACvD,YAAQ,IAAI,MAAM,OAAO,OAAO,OAAO,CAAC;AAAA,EAC1C;AACF;AAEA,eAAe,WAAW,aAAoC;AAC5D,QAAM,aAAa,KAAK,KAAK,aAAa,gBAAgB,iBAAiB;AAE3E,MAAI,CAAC,WAAW,UAAU,GAAG;AAC3B,YAAQ,IAAI,MAAM,OAAO,4BAA4B,CAAC;AACtD;AAAA,EACF;AAEA,QAAM,SAAS,KAAK,MAAM,MAAM,GAAG,SAAS,YAAY,OAAO,CAAC;AAEhE,UAAQ,IAAI,MAAM,KAAK,+BAAwB,CAAC;AAChD,UAAQ,IAAI,SAAI,OAAO,EAAE,CAAC;AAC1B,UAAQ,IAAI,YAAY,IAAI,KAAK,OAAO,SAAS,EAAE,eAAe,CAAC,EAAE;AACrE,UAAQ,IAAI,kBAAkB,OAAO,aAAa,MAAM,EAAE;AAC1D,UAAQ,IAAI,kBAAkB,OAAO,UAAU,MAAM,EAAE;AAEvD,MAAI,OAAO,aAAa,SAAS,GAAG;AAClC,YAAQ,IAAI,gBAAgB;AAC5B,WAAO,aAAa,MAAM,GAAG,CAAC,EAAE,QAAQ,CAAC,UAAe;AACtD,cAAQ,IAAI,YAAO,MAAM,IAAI,KAAK,MAAM,IAAI,GAAG;AAAA,IACjD,CAAC;AAAA,EACH;AAEA,MAAI,OAAO,UAAU,SAAS,GAAG;AAC/B,YAAQ,IAAI,kBAAkB;AAC9B,WAAO,UAAU,MAAM,GAAG,CAAC,EAAE,QAAQ,CAAC,aAAkB;AACtD,cAAQ,IAAI,YAAO,SAAS,QAAQ,EAAE;AAAA,IACxC,CAAC;AAAA,EACH;AACF;AAEA,eAAe,UAAU,eAA8B,SAAiC;AACtF,QAAM,QAAQ,MAAM,cAAc,gBAAgB;AAClD,QAAM,SAAS,cAAc,oBAAoB,KAAK;AAEtD,MAAI,WAAW,cAAc,WAAW,SAAS;AAC/C,YAAQ,MAAM,oCAAoC;AAClD,UAAM,cAAc,qBAAqB;AACzC,YAAQ,QAAQ,cAAc;AAE9B,YAAQ,MAAM,qBAAqB;AAGnC,UAAM,IAAI,QAAQ,aAAW,WAAW,SAAS,GAAI,CAAC;AACtD,YAAQ,QAAQ,8BAA8B;AAAA,EAChD,OAAO;AACL,YAAQ,IAAI,MAAM,MAAM,2CAA2C,CAAC;AAAA,EACtE;AACF;AAEA,SAAS,eAAe,YAA4B;AAClD,QAAM,SAAS,KAAK,MAAM,aAAa,CAAC;AACxC,QAAM,QAAQ,KAAK;AAEnB,MAAI,MAAM;AACV,SAAO,MAAM,MAAM,QAAG,EAAE,OAAO,KAAK,IAAI,QAAQ,EAAE,CAAC;AACnD,SAAO,MAAM,OAAO,QAAG,EAAE,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,SAAS,IAAI,CAAC,CAAC,CAAC;AACrE,SAAO,MAAM,IAAI,QAAG,EAAE,OAAO,KAAK,IAAI,GAAG,SAAS,EAAE,CAAC;AACrD,SAAO,MAAM,KAAK,QAAG,EAAE,OAAO,KAAK;AACnC,SAAO;AAEP,SAAO;AACT;AAEA,SAAS,eAAe,QAAwB;AAC9C,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO,MAAM,MAAM,uBAAkB;AAAA,IACvC,KAAK;AACH,aAAO,MAAM,KAAK,0BAAqB;AAAA,IACzC,KAAK;AACH,aAAO,MAAM,OAAO,gCAAsB;AAAA,IAC5C,KAAK;AACH,aAAO,MAAM,IAAI,6BAAsB;AAAA,IACzC;AACE,aAAO;AAAA,EACX;AACF;AAGA,IAAO,gBAAQ;",
+  "names": []
+}