@stackmemoryai/stackmemory 0.5.0 → 0.5.1

package/dist/core/storage/simplified-storage.js

@@ -0,0 +1,328 @@
+import Database from "better-sqlite3";
+import { Pool } from "pg";
+import { S3Client, PutObjectCommand, GetObjectCommand } from "@aws-sdk/client-s3";
+import { logger } from "../monitoring/logger.js";
+import * as zlib from "zlib";
+import { promisify } from "util";
+const gzipAsync = promisify(zlib.gzip);
+const gunzipAsync = promisify(zlib.gunzip);
+var StorageTier = /* @__PURE__ */ ((StorageTier2) => {
+  StorageTier2["HOT"] = "hot";
+  StorageTier2["COLD"] = "cold";
+  return StorageTier2;
+})(StorageTier || {});
+const DEFAULT_SIMPLIFIED_CONFIG = {
+  database: {
+    type: process.env["DATABASE_URL"]?.startsWith("postgres") ? "postgresql" : "sqlite",
+    url: process.env["DATABASE_URL"] || "./storage/stackmemory.db",
+    maxConnections: 10
+  },
+  objectStorage: {
+    endpoint: process.env["S3_ENDPOINT"] || "https://s3.amazonaws.com",
+    bucket: process.env["S3_BUCKET"] || "stackmemory-archive",
+    accessKeyId: process.env["S3_ACCESS_KEY_ID"] || "",
+    secretAccessKey: process.env["S3_SECRET_ACCESS_KEY"] || "",
+    region: process.env["S3_REGION"] || "us-east-1"
+  },
+  tiers: {
+    archiveAfterDays: 30,
+    // Archive after 30 days instead of complex 3-tier
+    compressionThreshold: 1024
+    // Compress items > 1KB
+  }
+};
+class SimplifiedStorage {
+  config;
+  db;
+  pgPool;
+  s3Client;
+  isInitialized = false;
+  constructor(config = DEFAULT_SIMPLIFIED_CONFIG) {
+    this.config = config;
+    if (this.config.objectStorage.accessKeyId && this.config.objectStorage.secretAccessKey) {
+      this.s3Client = new S3Client({
+        endpoint: this.config.objectStorage.endpoint,
+        region: this.config.objectStorage.region,
+        credentials: {
+          accessKeyId: this.config.objectStorage.accessKeyId,
+          secretAccessKey: this.config.objectStorage.secretAccessKey
+        }
+      });
+    }
+  }
+  async initialize() {
+    if (this.isInitialized) return;
+    try {
+      if (this.config.database.type === "postgresql") {
+        await this.initializePostgreSQL();
+      } else {
+        await this.initializeSQLite();
+      }
+      await this.createTables();
+      this.isInitialized = true;
+      this.startArchivalProcess();
+      logger.info("Simplified storage initialized", {
+        databaseType: this.config.database.type,
+        objectStorageEnabled: !!this.s3Client
+      });
+    } catch (error) {
+      logger.error("Failed to initialize simplified storage", { error });
+      throw error;
+    }
+  }
+  async initializePostgreSQL() {
+    this.pgPool = new Pool({
+      connectionString: this.config.database.url,
+      max: this.config.database.maxConnections,
+      idleTimeoutMillis: 3e4
+    });
+  }
+  async initializeSQLite() {
+    this.db = new Database(this.config.database.url);
+    this.db.pragma("foreign_keys = ON");
+    this.db.pragma("journal_mode = WAL");
+  }
+  async createTables() {
+    const schema = `
+      CREATE TABLE IF NOT EXISTS storage_items (
+        id TEXT PRIMARY KEY,
+        data BLOB,
+        metadata TEXT,
+        tier TEXT NOT NULL,
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        last_accessed TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        compressed BOOLEAN DEFAULT FALSE,
+        object_key TEXT -- For cold storage reference
+      );
+      CREATE INDEX IF NOT EXISTS idx_storage_tier ON storage_items(tier);
+      CREATE INDEX IF NOT EXISTS idx_storage_created ON storage_items(created_at);
+    `;
+    if (this.pgPool) {
+      await this.pgPool.query(schema.replace(/BLOB/g, "BYTEA").replace(/TIMESTAMP DEFAULT CURRENT_TIMESTAMP/g, "TIMESTAMP DEFAULT NOW()"));
+    } else if (this.db) {
+      this.db.exec(schema);
+    }
+  }
+  /**
+   * Store item in hot tier (database)
+   */
+  async store(id, data, metadata = {}) {
+    if (!this.isInitialized) await this.initialize();
+    let processedData = data;
+    let compressed = false;
+    if (data.length > this.config.tiers.compressionThreshold) {
+      processedData = await gzipAsync(data);
+      compressed = true;
+      logger.debug("Compressed storage item", { id, originalSize: data.length, compressedSize: processedData.length });
+    }
+    const item = {
+      id,
+      data: processedData,
+      metadata,
+      tier: "hot" /* HOT */,
+      createdAt: /* @__PURE__ */ new Date(),
+      lastAccessed: /* @__PURE__ */ new Date(),
+      compressed
+    };
+    if (this.pgPool) {
+      await this.pgPool.query(
+        `INSERT INTO storage_items (id, data, metadata, tier, created_at, last_accessed, compressed)
+         VALUES ($1, $2, $3, $4, $5, $6, $7)
+         ON CONFLICT (id) DO UPDATE SET
+           data = EXCLUDED.data,
+           metadata = EXCLUDED.metadata,
+           last_accessed = EXCLUDED.last_accessed,
+           compressed = EXCLUDED.compressed`,
+        [id, processedData, JSON.stringify(metadata), item.tier, item.createdAt, item.lastAccessed, compressed]
+      );
+    } else if (this.db) {
+      const stmt = this.db.prepare(`
+        INSERT OR REPLACE INTO storage_items (id, data, metadata, tier, created_at, last_accessed, compressed)
+        VALUES (?, ?, ?, ?, ?, ?, ?)
+      `);
+      stmt.run(id, processedData, JSON.stringify(metadata), item.tier, item.createdAt?.toISOString(), item.lastAccessed?.toISOString(), compressed ? 1 : 0);
+    }
+    logger.debug("Stored item in hot tier", { id, size: processedData.length, compressed });
+  }
+  /**
+   * Retrieve item from appropriate tier
+   */
+  async retrieve(id) {
+    if (!this.isInitialized) await this.initialize();
+    await this.updateLastAccessed(id);
+    let row;
+    if (this.pgPool) {
+      const { rows } = await this.pgPool.query("SELECT * FROM storage_items WHERE id = $1", [id]);
+      row = rows[0];
+    } else if (this.db) {
+      row = this.db.prepare("SELECT * FROM storage_items WHERE id = ?").get(id);
+    }
+    if (!row) return null;
+    let data;
+    if (row.tier === "cold" /* COLD */ && row.object_key && this.s3Client) {
+      data = await this.retrieveFromColdStorage(row.object_key);
+    } else {
+      data = row.data;
+    }
+    if (row.compressed) {
+      data = await gunzipAsync(data);
+    }
+    logger.debug("Retrieved item", { id, tier: row.tier, compressed: row.compressed });
+    return data;
+  }
+  /**
+   * Archive old items to cold storage
+   */
+  async archiveOldItems() {
+    if (!this.s3Client) return;
+    const cutoffDate = /* @__PURE__ */ new Date();
+    cutoffDate.setDate(cutoffDate.getDate() - this.config.tiers.archiveAfterDays);
+    let rows;
+    if (this.pgPool) {
+      const { rows: pgRows } = await this.pgPool.query(
+        "SELECT * FROM storage_items WHERE tier = $1 AND created_at < $2 LIMIT 100",
+        ["hot" /* HOT */, cutoffDate]
+      );
+      rows = pgRows;
+    } else if (this.db) {
+      rows = this.db.prepare(
+        "SELECT * FROM storage_items WHERE tier = ? AND created_at < ? LIMIT 100"
+      ).all("hot" /* HOT */, cutoffDate.toISOString());
+    } else {
+      return;
+    }
+    for (const row of rows) {
+      try {
+        await this.archiveItem(row);
+        logger.debug("Archived item to cold storage", { id: row.id });
+      } catch (error) {
+        logger.warn("Failed to archive item", { id: row.id, error });
+      }
+    }
+    if (rows.length > 0) {
+      logger.info("Archived old items", { count: rows.length, cutoffDate });
+    }
+  }
+  async archiveItem(row) {
+    if (!this.s3Client) return;
+    const objectKey = `archived/${row.id}`;
+    await this.s3Client.send(
+      new PutObjectCommand({
+        Bucket: this.config.objectStorage.bucket,
+        Key: objectKey,
+        Body: row.data,
+        Metadata: {
+          originalId: row.id,
+          compressed: row.compressed.toString(),
+          archivedAt: (/* @__PURE__ */ new Date()).toISOString()
+        }
+      })
+    );
+    if (this.pgPool) {
+      await this.pgPool.query(
+        "UPDATE storage_items SET tier = $1, data = NULL, object_key = $2 WHERE id = $3",
+        ["cold" /* COLD */, objectKey, row.id]
+      );
+    } else if (this.db) {
+      this.db.prepare(
+        "UPDATE storage_items SET tier = ?, data = NULL, object_key = ? WHERE id = ?"
+      ).run("cold" /* COLD */, objectKey, row.id);
+    }
+  }
+  async retrieveFromColdStorage(objectKey) {
+    if (!this.s3Client) throw new Error("Object storage not configured");
+    const response = await this.s3Client.send(
+      new GetObjectCommand({
+        Bucket: this.config.objectStorage.bucket,
+        Key: objectKey
+      })
+    );
+    if (!response.Body) throw new Error("Empty response from cold storage");
+    const chunks = [];
+    const reader = response.Body;
+    return new Promise((resolve, reject) => {
+      reader.on("data", (chunk) => chunks.push(chunk));
+      reader.on("end", () => resolve(Buffer.concat(chunks)));
+      reader.on("error", reject);
+    });
+  }
+  async updateLastAccessed(id) {
+    const now = /* @__PURE__ */ new Date();
+    if (this.pgPool) {
+      await this.pgPool.query(
+        "UPDATE storage_items SET last_accessed = $1 WHERE id = $2",
+        [now, id]
+      );
+    } else if (this.db) {
+      this.db.prepare("UPDATE storage_items SET last_accessed = ? WHERE id = ?").run(now.toISOString(), id);
+    }
+  }
+  startArchivalProcess() {
+    setInterval(async () => {
+      try {
+        await this.archiveOldItems();
+      } catch (error) {
+        logger.error("Archival process failed", { error });
+      }
+    }, 6 * 60 * 60 * 1e3);
+    logger.info("Started archival process", { intervalHours: 6 });
+  }
+  /**
+   * Get storage statistics
+   */
+  async getStats() {
+    if (!this.isInitialized) await this.initialize();
+    let hotItems = 0;
+    let coldItems = 0;
+    let totalSize = 0;
+    if (this.pgPool) {
+      const { rows } = await this.pgPool.query(`
+        SELECT tier, COUNT(*) as count, SUM(length(data)) as size
+        FROM storage_items
+        GROUP BY tier
+      `);
+      for (const row of rows) {
+        if (row.tier === "hot" /* HOT */) {
+          hotItems = parseInt(row.count);
+          totalSize += parseInt(row.size || 0);
+        } else {
+          coldItems = parseInt(row.count);
+        }
+      }
+    } else if (this.db) {
+      const stmt = this.db.prepare(`
+        SELECT tier, COUNT(*) as count, SUM(length(data)) as size
+        FROM storage_items
+        GROUP BY tier
+      `);
+      const rows = stmt.all();
+      for (const row of rows) {
+        if (row.tier === "hot" /* HOT */) {
+          hotItems = row.count;
+          totalSize += row.size || 0;
+        } else {
+          coldItems = row.count;
+        }
+      }
+    }
+    return { hotItems, coldItems, totalSize };
+  }
+  async close() {
+    if (this.pgPool) {
+      await this.pgPool.end();
+    }
+    if (this.db) {
+      this.db.close();
+    }
+    this.isInitialized = false;
+    logger.info("Simplified storage closed");
+  }
+}
+var simplified_storage_default = SimplifiedStorage;
+export {
+  DEFAULT_SIMPLIFIED_CONFIG,
+  SimplifiedStorage,
+  StorageTier,
+  simplified_storage_default as default
+};
+//# sourceMappingURL=simplified-storage.js.map

package/dist/core/storage/simplified-storage.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/storage/simplified-storage.ts"],
+  "sourcesContent": ["/**\n * Simplified 2-Tier Storage System\n * Tier 1: SQLite/PostgreSQL (Hot) - Active data, immediate access\n * Tier 2: Object Storage (Cold) - Archive data, cost-effective long-term storage\n * \n * ARCHITECT RECOMMENDATION: Removed Redis complexity, GCS overkill\n */\n\nimport Database from 'better-sqlite3';\nimport { Pool } from 'pg';\nimport { S3Client, PutObjectCommand, GetObjectCommand } from '@aws-sdk/client-s3';\nimport { logger } from '../monitoring/logger.js';\nimport * as zlib from 'zlib';\nimport { promisify } from 'util';\n\nconst gzipAsync = promisify(zlib.gzip);\nconst gunzipAsync = promisify(zlib.gunzip);\n\nexport enum StorageTier {\n  HOT = 'hot',   // SQLite/PostgreSQL: Active data\n  COLD = 'cold', // Object Storage: Archive data\n}\n\nexport interface SimplifiedStorageConfig {\n  database: {\n    type: 'sqlite' | 'postgresql';\n    url: string;\n    maxConnections?: number;\n  };\n  objectStorage: {\n    endpoint: string;\n    bucket: string;\n    accessKeyId: string;\n    secretAccessKey: string;\n    region: string;\n  };\n  tiers: {\n    archiveAfterDays: number; // Move to cold storage after N days\n    compressionThreshold: number; // Compress items larger than N bytes\n  };\n}\n\nexport const DEFAULT_SIMPLIFIED_CONFIG: SimplifiedStorageConfig = {\n  database: {\n    type: process.env['DATABASE_URL']?.startsWith('postgres') ? 'postgresql' : 'sqlite',\n    url: process.env['DATABASE_URL'] || './storage/stackmemory.db',\n    maxConnections: 10,\n  },\n  objectStorage: {\n    endpoint: process.env['S3_ENDPOINT'] || 'https://s3.amazonaws.com',\n    bucket: process.env['S3_BUCKET'] || 'stackmemory-archive',\n    accessKeyId: process.env['S3_ACCESS_KEY_ID'] || '',\n    secretAccessKey: process.env['S3_SECRET_ACCESS_KEY'] || '',\n    region: process.env['S3_REGION'] || 'us-east-1',\n  },\n  tiers: {\n    archiveAfterDays: 30, // Archive after 30 days instead of complex 3-tier\n    compressionThreshold: 1024, // Compress items > 1KB\n  },\n};\n\nexport interface StoredItem {\n  id: string;\n  data: Buffer;\n  metadata: Record<string, unknown>;\n  tier: StorageTier;\n  createdAt: Date;\n  lastAccessed: Date;\n  compressed: boolean;\n}\n\ninterface DatabaseRow {\n  id: string;\n  data: Buffer;\n  metadata: string;\n  tier: string;\n  created_at: string;\n  last_accessed: string;\n  compressed: number | boolean;\n  object_key?: string;\n}\n\n/**\n * Simplified Storage System (Architect-approved)\n * Removes Redis complexity, GCS overkill, premature optimization\n */\nexport class SimplifiedStorage {\n  private config: SimplifiedStorageConfig;\n  private db?: Database.Database;\n  private pgPool?: Pool;\n  private s3Client?: S3Client;\n  private isInitialized = false;\n\n  constructor(config: SimplifiedStorageConfig = DEFAULT_SIMPLIFIED_CONFIG) {\n    this.config = config;\n    \n    // Only initialize S3 if properly configured\n    if (this.config.objectStorage.accessKeyId && this.config.objectStorage.secretAccessKey) {\n      this.s3Client = new S3Client({\n        endpoint: this.config.objectStorage.endpoint,\n        region: this.config.objectStorage.region,\n        credentials: {\n          accessKeyId: this.config.objectStorage.accessKeyId,\n          secretAccessKey: this.config.objectStorage.secretAccessKey,\n        },\n      });\n    }\n  }\n\n  async initialize(): Promise<void> {\n    if (this.isInitialized) return;\n\n    try {\n      if (this.config.database.type === 'postgresql') {\n        await this.initializePostgreSQL();\n      } else {\n        await this.initializeSQLite();\n      }\n\n      await this.createTables();\n      this.isInitialized = true;\n      \n      // Start background archival process (simple cron-like)\n      this.startArchivalProcess();\n      \n      logger.info('Simplified storage initialized', {\n        databaseType: this.config.database.type,\n        objectStorageEnabled: !!this.s3Client,\n      });\n    } catch (error) {\n      logger.error('Failed to initialize simplified storage', { error });\n      throw error;\n    }\n  }\n\n  private async initializePostgreSQL(): Promise<void> {\n    this.pgPool = new Pool({\n      connectionString: this.config.database.url,\n      max: this.config.database.maxConnections,\n      idleTimeoutMillis: 30000,\n    });\n  }\n\n  private async initializeSQLite(): Promise<void> {\n    this.db = new Database(this.config.database.url);\n    this.db.pragma('foreign_keys = ON');\n    this.db.pragma('journal_mode = WAL');\n  }\n\n  private async createTables(): Promise<void> {\n    const schema = `\n      CREATE TABLE IF NOT EXISTS storage_items (\n        id TEXT PRIMARY KEY,\n        data BLOB,\n        metadata TEXT,\n        tier TEXT NOT NULL,\n        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n        last_accessed TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n        compressed BOOLEAN DEFAULT FALSE,\n        object_key TEXT -- For cold storage reference\n      );\n      CREATE INDEX IF NOT EXISTS idx_storage_tier ON storage_items(tier);\n      CREATE INDEX IF NOT EXISTS idx_storage_created ON storage_items(created_at);\n    `;\n\n    if (this.pgPool) {\n      await this.pgPool.query(schema.replace(/BLOB/g, 'BYTEA').replace(/TIMESTAMP DEFAULT CURRENT_TIMESTAMP/g, 'TIMESTAMP DEFAULT NOW()'));\n    } else if (this.db) {\n      this.db.exec(schema);\n    }\n  }\n\n  /**\n   * Store item in hot tier (database)\n   */\n  async store(id: string, data: Buffer, metadata: Record<string, unknown> = {}): Promise<void> {\n    if (!this.isInitialized) await this.initialize();\n\n    let processedData = data;\n    let compressed = false;\n\n    // Compress if over threshold\n    if (data.length > this.config.tiers.compressionThreshold) {\n      processedData = await gzipAsync(data);\n      compressed = true;\n      logger.debug('Compressed storage item', { id, originalSize: data.length, compressedSize: processedData.length });\n    }\n\n    const item: Partial<StoredItem> = {\n      id,\n      data: processedData,\n      metadata,\n      tier: StorageTier.HOT,\n      createdAt: new Date(),\n      lastAccessed: new Date(),\n      compressed,\n    };\n\n    if (this.pgPool) {\n      await this.pgPool.query(\n        `INSERT INTO storage_items (id, data, metadata, tier, created_at, last_accessed, compressed)\n         VALUES ($1, $2, $3, $4, $5, $6, $7)\n         ON CONFLICT (id) DO UPDATE SET\n           data = EXCLUDED.data,\n           metadata = EXCLUDED.metadata,\n           last_accessed = EXCLUDED.last_accessed,\n           compressed = EXCLUDED.compressed`,\n        [id, processedData, JSON.stringify(metadata), item.tier, item.createdAt, item.lastAccessed, compressed]\n      );\n    } else if (this.db) {\n      const stmt = this.db.prepare(`\n        INSERT OR REPLACE INTO storage_items (id, data, metadata, tier, created_at, last_accessed, compressed)\n        VALUES (?, ?, ?, ?, ?, ?, ?)\n      `);\n      stmt.run(id, processedData, JSON.stringify(metadata), item.tier, item.createdAt?.toISOString(), item.lastAccessed?.toISOString(), compressed ? 1 : 0);\n    }\n\n    logger.debug('Stored item in hot tier', { id, size: processedData.length, compressed });\n  }\n\n  /**\n   * Retrieve item from appropriate tier\n   */\n  async retrieve(id: string): Promise<Buffer | null> {\n    if (!this.isInitialized) await this.initialize();\n\n    // Update last accessed timestamp\n    await this.updateLastAccessed(id);\n\n    let row: DatabaseRow | undefined;\n    if (this.pgPool) {\n      const { rows } = await this.pgPool.query('SELECT * FROM storage_items WHERE id = $1', [id]);\n      row = rows[0];\n    } else if (this.db) {\n      row = this.db.prepare('SELECT * FROM storage_items WHERE id = ?').get(id);\n    }\n\n    if (!row) return null;\n\n    let data: Buffer;\n    \n    if (row.tier === StorageTier.COLD && row.object_key && this.s3Client) {\n      // Retrieve from cold storage\n      data = await this.retrieveFromColdStorage(row.object_key);\n    } else {\n      // Retrieve from hot storage\n      data = row.data;\n    }\n\n    // Decompress if needed\n    if (row.compressed) {\n      data = await gunzipAsync(data);\n    }\n\n    logger.debug('Retrieved item', { id, tier: row.tier, compressed: row.compressed });\n    return data;\n  }\n\n  /**\n   * Archive old items to cold storage\n   */\n  private async archiveOldItems(): Promise<void> {\n    if (!this.s3Client) return; // Skip if object storage not configured\n\n    const cutoffDate = new Date();\n    cutoffDate.setDate(cutoffDate.getDate() - this.config.tiers.archiveAfterDays);\n\n    let rows: DatabaseRow[];\n    if (this.pgPool) {\n      const { rows: pgRows } = await this.pgPool.query(\n        'SELECT * FROM storage_items WHERE tier = $1 AND created_at < $2 LIMIT 100',\n        [StorageTier.HOT, cutoffDate]\n      );\n      rows = pgRows;\n    } else if (this.db) {\n      rows = this.db.prepare(\n        'SELECT * FROM storage_items WHERE tier = ? AND created_at < ? LIMIT 100'\n      ).all(StorageTier.HOT, cutoffDate.toISOString());\n    } else {\n      return;\n    }\n\n    for (const row of rows) {\n      try {\n        await this.archiveItem(row);\n        logger.debug('Archived item to cold storage', { id: row.id });\n      } catch (error) {\n        logger.warn('Failed to archive item', { id: row.id, error });\n      }\n    }\n\n    if (rows.length > 0) {\n      logger.info('Archived old items', { count: rows.length, cutoffDate });\n    }\n  }\n\n  private async archiveItem(row: DatabaseRow): Promise<void> {\n    if (!this.s3Client) return;\n\n    const objectKey = `archived/${row.id}`;\n    \n    // Upload to S3\n    await this.s3Client.send(\n      new PutObjectCommand({\n        Bucket: this.config.objectStorage.bucket,\n        Key: objectKey,\n        Body: row.data,\n        Metadata: {\n          originalId: row.id,\n          compressed: row.compressed.toString(),\n          archivedAt: new Date().toISOString(),\n        },\n      })\n    );\n\n    // Update database record\n    if (this.pgPool) {\n      await this.pgPool.query(\n        'UPDATE storage_items SET tier = $1, data = NULL, object_key = $2 WHERE id = $3',\n        [StorageTier.COLD, objectKey, row.id]\n      );\n    } else if (this.db) {\n      this.db.prepare(\n        'UPDATE storage_items SET tier = ?, data = NULL, object_key = ? WHERE id = ?'\n      ).run(StorageTier.COLD, objectKey, row.id);\n    }\n  }\n\n  private async retrieveFromColdStorage(objectKey: string): Promise<Buffer> {\n    if (!this.s3Client) throw new Error('Object storage not configured');\n\n    const response = await this.s3Client.send(\n      new GetObjectCommand({\n        Bucket: this.config.objectStorage.bucket,\n        Key: objectKey,\n      })\n    );\n\n    if (!response.Body) throw new Error('Empty response from cold storage');\n\n    // Convert stream to buffer\n    const chunks: Buffer[] = [];\n    const reader = response.Body as NodeJS.ReadableStream;\n    \n    return new Promise((resolve, reject) => {\n      reader.on('data', (chunk: Buffer) => chunks.push(chunk));\n      reader.on('end', () => resolve(Buffer.concat(chunks)));\n      reader.on('error', reject);\n    });\n  }\n\n  private async updateLastAccessed(id: string): Promise<void> {\n    const now = new Date();\n    \n    if (this.pgPool) {\n      await this.pgPool.query(\n        'UPDATE storage_items SET last_accessed = $1 WHERE id = $2',\n        [now, id]\n      );\n    } else if (this.db) {\n      this.db.prepare('UPDATE storage_items SET last_accessed = ? WHERE id = ?')\n        .run(now.toISOString(), id);\n    }\n  }\n\n  private startArchivalProcess(): void {\n    // Run archival every 6 hours instead of complex real-time monitoring\n    setInterval(async () => {\n      try {\n        await this.archiveOldItems();\n      } catch (error) {\n        logger.error('Archival process failed', { error });\n      }\n    }, 6 * 60 * 60 * 1000); // 6 hours\n\n    logger.info('Started archival process', { intervalHours: 6 });\n  }\n\n  /**\n   * Get storage statistics\n   */\n  async getStats(): Promise<{ hotItems: number; coldItems: number; totalSize: number }> {\n    if (!this.isInitialized) await this.initialize();\n\n    let hotItems = 0;\n    let coldItems = 0;\n    let totalSize = 0;\n\n    if (this.pgPool) {\n      const { rows } = await this.pgPool.query(`\n        SELECT tier, COUNT(*) as count, SUM(length(data)) as size\n        FROM storage_items\n        GROUP BY tier\n      `);\n      \n      for (const row of rows) {\n        if (row.tier === StorageTier.HOT) {\n          hotItems = parseInt(row.count);\n          totalSize += parseInt(row.size || 0);\n        } else {\n          coldItems = parseInt(row.count);\n        }\n      }\n    } else if (this.db) {\n      const stmt = this.db.prepare(`\n        SELECT tier, COUNT(*) as count, SUM(length(data)) as size\n        FROM storage_items\n        GROUP BY tier\n      `);\n      const rows = stmt.all();\n      \n      for (const row of rows) {\n        if (row.tier === StorageTier.HOT) {\n          hotItems = row.count;\n          totalSize += row.size || 0;\n        } else {\n          coldItems = row.count;\n        }\n      }\n    }\n\n    return { hotItems, coldItems, totalSize };\n  }\n\n  async close(): Promise<void> {\n    if (this.pgPool) {\n      await this.pgPool.end();\n    }\n    if (this.db) {\n      this.db.close();\n    }\n    this.isInitialized = false;\n    logger.info('Simplified storage closed');\n  }\n}\n\nexport default SimplifiedStorage;"],
+  "mappings": "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",
+  "names": ["StorageTier"]
+}

package/dist/plugins/linear/index.js

@@ -0,0 +1,166 @@
+import { LinearClient } from "@linear/sdk";
+import { logger } from "../../core/monitoring/logger.js";
+class LinearPlugin {
+  name = "linear-integration";
+  version = "1.0.0";
+  description = "Linear task synchronization for StackMemory";
+  client = null;
+  apiKey = null;
+  async initialize() {
+    this.apiKey = process.env["LINEAR_API_KEY"] || null;
+    if (!this.apiKey) {
+      logger.info("Linear plugin: No API key found, running in offline mode");
+      return;
+    }
+    try {
+      this.client = new LinearClient({ apiKey: this.apiKey });
+      await this.client.me;
+      logger.info("Linear plugin initialized successfully");
+    } catch (error) {
+      logger.warn("Linear plugin: Failed to connect", error);
+      this.client = null;
+    }
+  }
+  async shutdown() {
+    this.client = null;
+    logger.info("Linear plugin shut down");
+  }
+  registerCommands() {
+    return [
+      {
+        name: "linear-sync",
+        description: "Sync tasks with Linear",
+        action: this.syncTasks.bind(this),
+        options: [
+          {
+            flag: "--team <id>",
+            description: "Linear team ID"
+          },
+          {
+            flag: "--project <id>",
+            description: "Linear project ID"
+          }
+        ]
+      },
+      {
+        name: "linear-create",
+        description: "Create a Linear issue from current context",
+        action: this.createIssue.bind(this),
+        options: [
+          {
+            flag: "--title <title>",
+            description: "Issue title"
+          },
+          {
+            flag: "--description <desc>",
+            description: "Issue description"
+          }
+        ]
+      }
+    ];
+  }
+  registerTools() {
+    return [
+      {
+        name: "linear_sync",
+        description: "Sync current context with Linear tasks",
+        inputSchema: {
+          type: "object",
+          properties: {
+            teamId: { type: "string", description: "Linear team ID" },
+            projectId: { type: "string", description: "Linear project ID" }
+          }
+        },
+        handler: async (input) => {
+          return await this.syncTasks(input);
+        }
+      },
+      {
+        name: "linear_create_issue",
+        description: "Create a Linear issue",
+        inputSchema: {
+          type: "object",
+          properties: {
+            title: { type: "string" },
+            description: { type: "string" },
+            teamId: { type: "string" }
+          },
+          required: ["title"]
+        },
+        handler: async (input) => {
+          return await this.createIssue(input);
+        }
+      }
+    ];
+  }
+  onFrameCreated(frame) {
+    if (frame.type === "task" && this.client) {
+      this.syncFrameToLinear(frame).catch((error) => {
+        logger.debug("Failed to sync frame to Linear", error);
+      });
+    }
+  }
+  async syncTasks(options) {
+    if (!this.client) {
+      return { success: false, message: "Linear not connected" };
+    }
+    try {
+      const issues = await this.client.issues({
+        filter: {
+          team: { id: { eq: options.teamId } }
+        }
+      });
+      return {
+        success: true,
+        synced: issues.nodes.length,
+        message: `Synced ${issues.nodes.length} issues from Linear`
+      };
+    } catch (error) {
+      logger.error("Linear sync failed", error);
+      return { success: false, error: error.message };
+    }
+  }
+  async createIssue(options) {
+    if (!this.client) {
+      return { success: false, message: "Linear not connected" };
+    }
+    try {
+      const issue = await this.client.createIssue({
+        title: options.title,
+        description: options.description,
+        teamId: options.teamId || await this.getDefaultTeamId()
+      });
+      return {
+        success: true,
+        issueId: issue.issue?.id,
+        url: issue.issue?.url,
+        message: `Created Linear issue: ${issue.issue?.identifier}`
+      };
+    } catch (error) {
+      logger.error("Failed to create Linear issue", error);
+      return { success: false, error: error.message };
+    }
+  }
+  async syncFrameToLinear(frame) {
+    if (frame.name && frame.content) {
+      await this.createIssue({
+        title: frame.name,
+        description: frame.content
+      });
+    }
+  }
+  async getDefaultTeamId() {
+    if (!this.client) throw new Error("Linear not connected");
+    const teams = await this.client.teams();
+    if (teams.nodes.length > 0) {
+      return teams.nodes[0].id;
+    }
+    throw new Error("No Linear teams found");
+  }
+}
+var linear_default = LinearPlugin;
+export {
+  LinearPlugin,
+  linear_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/plugins/linear/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/plugins/linear/index.ts"],
+  "sourcesContent": ["/**\n * Linear Integration Plugin for StackMemory\n * Provides task synchronization with Linear as an optional feature\n */\n\nimport { StackMemoryPlugin, PluginCommand, PluginTool } from '../plugin-interface.js';\nimport { LinearClient } from '@linear/sdk';\nimport { logger } from '../../core/monitoring/logger.js';\n\nexport class LinearPlugin implements StackMemoryPlugin {\n  name = 'linear-integration';\n  version = '1.0.0';\n  description = 'Linear task synchronization for StackMemory';\n  \n  private client: LinearClient | null = null;\n  private apiKey: string | null = null;\n  \n  async initialize(): Promise<void> {\n    this.apiKey = process.env['LINEAR_API_KEY'] || null;\n    \n    if (!this.apiKey) {\n      logger.info('Linear plugin: No API key found, running in offline mode');\n      return;\n    }\n    \n    try {\n      this.client = new LinearClient({ apiKey: this.apiKey });\n      await this.client.me; // Test connection\n      logger.info('Linear plugin initialized successfully');\n    } catch (error) {\n      logger.warn('Linear plugin: Failed to connect', error);\n      this.client = null;\n    }\n  }\n  \n  async shutdown(): Promise<void> {\n    this.client = null;\n    logger.info('Linear plugin shut down');\n  }\n  \n  registerCommands(): PluginCommand[] {\n    return [\n      {\n        name: 'linear-sync',\n        description: 'Sync tasks with Linear',\n        action: this.syncTasks.bind(this),\n        options: [\n          {\n            flag: '--team <id>',\n            description: 'Linear team ID',\n          },\n          {\n            flag: '--project <id>',\n            description: 'Linear project ID',\n          }\n        ]\n      },\n      {\n        name: 'linear-create',\n        description: 'Create a Linear issue from current context',\n        action: this.createIssue.bind(this),\n        options: [\n          {\n            flag: '--title <title>',\n            description: 'Issue title',\n          },\n          {\n            flag: '--description <desc>',\n            description: 'Issue description',\n          }\n        ]\n      }\n    ];\n  }\n  \n  registerTools(): PluginTool[] {\n    return [\n      {\n        name: 'linear_sync',\n        description: 'Sync current context with Linear tasks',\n        inputSchema: {\n          type: 'object',\n          properties: {\n            teamId: { type: 'string', description: 'Linear team ID' },\n            projectId: { type: 'string', description: 'Linear project ID' }\n          }\n        },\n        handler: async (input) => {\n          return await this.syncTasks(input);\n        }\n      },\n      {\n        name: 'linear_create_issue',\n        description: 'Create a Linear issue',\n        inputSchema: {\n          type: 'object',\n          properties: {\n            title: { type: 'string' },\n            description: { type: 'string' },\n            teamId: { type: 'string' }\n          },\n          required: ['title']\n        },\n        handler: async (input) => {\n          return await this.createIssue(input);\n        }\n      }\n    ];\n  }\n  \n  onFrameCreated(frame: any): void {\n    // Auto-sync with Linear when a task frame is created\n    if (frame.type === 'task' && this.client) {\n      this.syncFrameToLinear(frame).catch(error => {\n        logger.debug('Failed to sync frame to Linear', error);\n      });\n    }\n  }\n  \n  private async syncTasks(options: any): Promise<any> {\n    if (!this.client) {\n      return { success: false, message: 'Linear not connected' };\n    }\n    \n    try {\n      // Basic sync implementation\n      const issues = await this.client.issues({\n        filter: {\n          team: { id: { eq: options.teamId } }\n        }\n      });\n      \n      return {\n        success: true,\n        synced: issues.nodes.length,\n        message: `Synced ${issues.nodes.length} issues from Linear`\n      };\n    } catch (error) {\n      logger.error('Linear sync failed', error);\n      return { success: false, error: (error as Error).message };\n    }\n  }\n  \n  private async createIssue(options: any): Promise<any> {\n    if (!this.client) {\n      return { success: false, message: 'Linear not connected' };\n    }\n    \n    try {\n      const issue = await this.client.createIssue({\n        title: options.title,\n        description: options.description,\n        teamId: options.teamId || (await this.getDefaultTeamId())\n      });\n      \n      return {\n        success: true,\n        issueId: issue.issue?.id,\n        url: issue.issue?.url,\n        message: `Created Linear issue: ${issue.issue?.identifier}`\n      };\n    } catch (error) {\n      logger.error('Failed to create Linear issue', error);\n      return { success: false, error: (error as Error).message };\n    }\n  }\n  \n  private async syncFrameToLinear(frame: any): Promise<void> {\n    // Simple frame to Linear sync\n    if (frame.name && frame.content) {\n      await this.createIssue({\n        title: frame.name,\n        description: frame.content\n      });\n    }\n  }\n  \n  private async getDefaultTeamId(): Promise<string> {\n    if (!this.client) throw new Error('Linear not connected');\n    \n    const teams = await this.client.teams();\n    if (teams.nodes.length > 0) {\n      return teams.nodes[0].id;\n    }\n    throw new Error('No Linear teams found');\n  }\n}\n\n// Export for plugin registration\nexport default LinearPlugin;"],
+  "mappings": "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",
+  "names": []
+}

package/dist/plugins/loader.js

@@ -0,0 +1,57 @@
+import { pluginManager } from "./plugin-interface.js";
+import { logger } from "../core/monitoring/logger.js";
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+async function loadPlugins() {
+  const configPath = join(process.cwd(), ".stackmemory", "plugins.json");
+  let enabledPlugins = [];
+  if (existsSync(configPath)) {
+    try {
+      const config = JSON.parse(readFileSync(configPath, "utf-8"));
+      enabledPlugins = config.enabled || [];
+    } catch (error) {
+      logger.warn("Failed to load plugin configuration", error);
+    }
+  } else {
+    enabledPlugins = [];
+    if (process.env["ENABLE_LINEAR_PLUGIN"] === "true") {
+      enabledPlugins.push("linear");
+    }
+  }
+  for (const pluginName of enabledPlugins) {
+    try {
+      await loadPlugin(pluginName);
+    } catch (error) {
+      logger.warn(`Failed to load plugin ${pluginName}`, error);
+    }
+  }
+  const loadedPlugins = pluginManager.getAllPlugins();
+  if (loadedPlugins.length > 0) {
+    logger.info(
+      `Loaded ${loadedPlugins.length} plugins: ${loadedPlugins.map((p) => p.name).join(", ")}`
+    );
+  }
+}
+async function loadPlugin(name) {
+  switch (name) {
+    case "linear": {
+      const { LinearPlugin } = await import("./linear/index.js");
+      const plugin = new LinearPlugin();
+      await pluginManager.register(plugin);
+      break;
+    }
+    // Future plugins can be added here
+    // case 'github': {
+    //   const { GitHubPlugin } = await import('./github/index.js');
+    //   await pluginManager.register(new GitHubPlugin());
+    //   break;
+    // }
+    default:
+      logger.warn(`Unknown plugin: ${name}`);
+  }
+}
+export {
+  loadPlugins,
+  pluginManager
+};
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/plugins/loader.ts"],
+  "sourcesContent": ["/**\n * Plugin Loader for StackMemory\n * Automatically loads plugins based on configuration\n */\n\nimport { pluginManager } from './plugin-interface.js';\nimport { logger } from '../core/monitoring/logger.js';\nimport { existsSync, readFileSync } from 'fs';\nimport { join } from 'path';\n\nexport async function loadPlugins(): Promise<void> {\n  // Check for plugin configuration\n  const configPath = join(process.cwd(), '.stackmemory', 'plugins.json');\n\n  let enabledPlugins: string[] = [];\n\n  if (existsSync(configPath)) {\n    try {\n      const config = JSON.parse(readFileSync(configPath, 'utf-8'));\n      enabledPlugins = config.enabled || [];\n    } catch (error) {\n      logger.warn('Failed to load plugin configuration', error);\n    }\n  } else {\n    // Default plugins (none by default, all optional)\n    enabledPlugins = [];\n\n    // Check environment variables for opt-in plugins\n    if (process.env['ENABLE_LINEAR_PLUGIN'] === 'true') {\n      enabledPlugins.push('linear');\n    }\n  }\n\n  // Load enabled plugins\n  for (const pluginName of enabledPlugins) {\n    try {\n      await loadPlugin(pluginName);\n    } catch (error) {\n      logger.warn(`Failed to load plugin ${pluginName}`, error);\n    }\n  }\n\n  const loadedPlugins = pluginManager.getAllPlugins();\n  if (loadedPlugins.length > 0) {\n    logger.info(\n      `Loaded ${loadedPlugins.length} plugins: ${loadedPlugins.map((p) => p.name).join(', ')}`\n    );\n  }\n}\n\nasync function loadPlugin(name: string): Promise<void> {\n  switch (name) {\n    case 'linear': {\n      const { LinearPlugin } = await import('./linear/index.js');\n      const plugin = new LinearPlugin();\n      await pluginManager.register(plugin);\n      break;\n    }\n\n    // Future plugins can be added here\n    // case 'github': {\n    //   const { GitHubPlugin } = await import('./github/index.js');\n    //   await pluginManager.register(new GitHubPlugin());\n    //   break;\n    // }\n\n    default:\n      logger.warn(`Unknown plugin: ${name}`);\n  }\n}\n\nexport { pluginManager };\n"],
+  "mappings": "AAKA,SAAS,qBAAqB;AAC9B,SAAS,cAAc;AACvB,SAAS,YAAY,oBAAoB;AACzC,SAAS,YAAY;AAErB,eAAsB,cAA6B;AAEjD,QAAM,aAAa,KAAK,QAAQ,IAAI,GAAG,gBAAgB,cAAc;AAErE,MAAI,iBAA2B,CAAC;AAEhC,MAAI,WAAW,UAAU,GAAG;AAC1B,QAAI;AACF,YAAM,SAAS,KAAK,MAAM,aAAa,YAAY,OAAO,CAAC;AAC3D,uBAAiB,OAAO,WAAW,CAAC;AAAA,IACtC,SAAS,OAAO;AACd,aAAO,KAAK,uCAAuC,KAAK;AAAA,IAC1D;AAAA,EACF,OAAO;AAEL,qBAAiB,CAAC;AAGlB,QAAI,QAAQ,IAAI,sBAAsB,MAAM,QAAQ;AAClD,qBAAe,KAAK,QAAQ;AAAA,IAC9B;AAAA,EACF;AAGA,aAAW,cAAc,gBAAgB;AACvC,QAAI;AACF,YAAM,WAAW,UAAU;AAAA,IAC7B,SAAS,OAAO;AACd,aAAO,KAAK,yBAAyB,UAAU,IAAI,KAAK;AAAA,IAC1D;AAAA,EACF;AAEA,QAAM,gBAAgB,cAAc,cAAc;AAClD,MAAI,cAAc,SAAS,GAAG;AAC5B,WAAO;AAAA,MACL,UAAU,cAAc,MAAM,aAAa,cAAc,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;AAAA,IACxF;AAAA,EACF;AACF;AAEA,eAAe,WAAW,MAA6B;AACrD,UAAQ,MAAM;AAAA,IACZ,KAAK,UAAU;AACb,YAAM,EAAE,aAAa,IAAI,MAAM,OAAO,mBAAmB;AACzD,YAAM,SAAS,IAAI,aAAa;AAChC,YAAM,cAAc,SAAS,MAAM;AACnC;AAAA,IACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASA;AACE,aAAO,KAAK,mBAAmB,IAAI,EAAE;AAAA,EACzC;AACF;",
+  "names": []
+}