@stackmemoryai/stackmemory 0.2.8 → 0.3.0

package/dist/src/integrations/pg-aiguide/timescale-analytics.js

@@ -0,0 +1,215 @@
+import { logger } from '../../core/monitoring/logger.js';
+export class TimescaleAnalytics {
+    pool;
+    config;
+    constructor(config) {
+        this.pool = config.pool;
+        this.config = config;
+    }
+    async createContinuousAggregate(name, interval, columns) {
+        const aggregates = columns
+            .map((col) => `
+      AVG(${col}) as avg_${col},
+      MIN(${col}) as min_${col},
+      MAX(${col}) as max_${col},
+      SUM(${col}) as sum_${col}
+    `)
+            .join(',\n      ');
+        const query = `
+      CREATE MATERIALIZED VIEW IF NOT EXISTS ${name}
+      WITH (timescaledb.continuous) AS
+      SELECT 
+        time_bucket('${interval}', ${this.config.timeColumn}) as bucket,
+        COUNT(*) as count,
+        ${aggregates}
+      FROM ${this.config.tableName}
+      GROUP BY bucket
+      WITH NO DATA
+    `;
+        await this.pool.query(query);
+        // Add refresh policy
+        await this.pool.query(`
+      SELECT add_continuous_aggregate_policy('${name}',
+        start_offset => INTERVAL '1 month',
+        end_offset => INTERVAL '1 hour',
+        schedule_interval => INTERVAL '1 hour',
+        if_not_exists => TRUE
+      )
+    `);
+        logger.info(`Created continuous aggregate: ${name}`);
+    }
+    async getTimeSeries(startTime, endTime, interval, columns) {
+        const selectedColumns = columns || this.config.valueColumns;
+        const aggregates = selectedColumns
+            .map((col) => `
+      AVG(${col})::float as avg_${col},
+      MIN(${col})::float as min_${col},
+      MAX(${col})::float as max_${col},
+      SUM(${col})::float as sum_${col}
+    `)
+            .join(',\n      ');
+        const query = `
+      SELECT 
+        time_bucket($1, ${this.config.timeColumn}) as period,
+        COUNT(*)::int as count,
+        ${aggregates}
+      FROM ${this.config.tableName}
+      WHERE ${this.config.timeColumn} >= $2
+        AND ${this.config.timeColumn} <= $3
+      GROUP BY period
+      ORDER BY period
+    `;
+        const result = await this.pool.query(query, [interval, startTime, endTime]);
+        return result.rows.map((row) => {
+            const avg = {};
+            const min = {};
+            const max = {};
+            const sum = {};
+            selectedColumns.forEach((col) => {
+                avg[col] = row[`avg_${col}`];
+                min[col] = row[`min_${col}`];
+                max[col] = row[`max_${col}`];
+                sum[col] = row[`sum_${col}`];
+            });
+            return {
+                period: row.period,
+                count: row.count,
+                avg,
+                min,
+                max,
+                sum,
+            };
+        });
+    }
+    async detectAnomalies(column, sensitivity = 2.5, lookback = '7 days') {
+        const query = `
+      WITH stats AS (
+        SELECT 
+          AVG(${column})::float as mean,
+          STDDEV(${column})::float as stddev
+        FROM ${this.config.tableName}
+        WHERE ${this.config.timeColumn} >= NOW() - INTERVAL '${lookback}'
+      ),
+      anomalies AS (
+        SELECT 
+          ${this.config.timeColumn} as timestamp,
+          ${column} as value,
+          metadata,
+          ABS(${column} - stats.mean) / NULLIF(stats.stddev, 0) as z_score
+        FROM ${this.config.tableName}, stats
+        WHERE ${this.config.timeColumn} >= NOW() - INTERVAL '${lookback}'
+          AND ABS(${column} - stats.mean) / NULLIF(stats.stddev, 0) > $1
+      )
+      SELECT * FROM anomalies
+      ORDER BY z_score DESC
+    `;
+        const result = await this.pool.query(query, [sensitivity]);
+        return result.rows.map((row) => ({
+            timestamp: row.timestamp,
+            values: { [column]: row.value, z_score: row.z_score },
+            metadata: row.metadata,
+        }));
+    }
+    async forecast(column, periods, method = 'linear') {
+        // Simple linear regression forecast
+        if (method === 'linear') {
+            const query = `
+        WITH regression AS (
+          SELECT 
+            regr_slope(${column}, EXTRACT(EPOCH FROM ${this.config.timeColumn}))::float as slope,
+            regr_intercept(${column}, EXTRACT(EPOCH FROM ${this.config.timeColumn}))::float as intercept,
+            MAX(${this.config.timeColumn}) as last_time,
+            EXTRACT(EPOCH FROM MAX(${this.config.timeColumn})) as last_epoch
+          FROM ${this.config.tableName}
+          WHERE ${this.config.timeColumn} >= NOW() - INTERVAL '30 days'
+        ),
+        forecast_times AS (
+          SELECT 
+            last_time + (INTERVAL '1 hour' * generate_series(1, $1)) as forecast_time
+          FROM regression
+        )
+        SELECT 
+          forecast_time as timestamp,
+          (intercept + slope * EXTRACT(EPOCH FROM forecast_time))::float as forecast_value
+        FROM forecast_times, regression
+      `;
+            const result = await this.pool.query(query, [periods]);
+            return result.rows.map((row) => ({
+                timestamp: row.timestamp,
+                values: { [column]: row.forecast_value, forecast: true },
+            }));
+        }
+        // Seasonal decomposition would require more complex logic
+        logger.warn('Seasonal forecasting not yet implemented');
+        return [];
+    }
+    async getRetentionPolicy() {
+        const query = `
+      SELECT 
+        hypertable_name as table_name,
+        drop_after::text as retention_period,
+        schedule_interval IS NOT NULL as is_enabled
+      FROM timescaledb_information.retention_policies
+      WHERE hypertable_name = $1
+    `;
+        const result = await this.pool.query(query, [this.config.tableName]);
+        return result.rows.map((row) => ({
+            tableName: row.table_name,
+            retentionPeriod: row.retention_period,
+            isEnabled: row.is_enabled,
+        }));
+    }
+    async setRetentionPolicy(retentionPeriod) {
+        const query = `
+      SELECT add_retention_policy($1, 
+        drop_after => INTERVAL '${retentionPeriod}',
+        if_not_exists => TRUE
+      )
+    `;
+        await this.pool.query(query, [this.config.tableName]);
+        logger.info(`Set retention policy for ${this.config.tableName}: ${retentionPeriod}`);
+    }
+    async compress(olderThan) {
+        // Enable compression
+        await this.pool.query(`
+      ALTER TABLE ${this.config.tableName} 
+      SET (timescaledb.compress, 
+           timescaledb.compress_segmentby = 'type',
+           timescaledb.compress_orderby = '${this.config.timeColumn} DESC')
+    `);
+        // Add compression policy
+        await this.pool.query(`
+      SELECT add_compression_policy($1,
+        compress_after => INTERVAL '${olderThan}',
+        if_not_exists => TRUE
+      )
+    `, [this.config.tableName]);
+        logger.info(`Enabled compression for ${this.config.tableName} older than ${olderThan}`);
+    }
+    async getChunkStats() {
+        const query = `
+      SELECT 
+        COUNT(*) as total_chunks,
+        COUNT(*) FILTER (WHERE is_compressed) as compressed_chunks,
+        pg_size_pretty(SUM(total_bytes)) as total_size,
+        pg_size_pretty(SUM(total_bytes) FILTER (WHERE is_compressed)) as compressed_size,
+        CASE 
+          WHEN SUM(uncompressed_total_bytes) > 0 
+          THEN (1 - SUM(total_bytes)::float / SUM(uncompressed_total_bytes))::numeric(4,2)
+          ELSE 0
+        END as compression_ratio
+      FROM timescaledb_information.chunks
+      WHERE hypertable_name = $1
+    `;
+        const result = await this.pool.query(query, [this.config.tableName]);
+        const row = result.rows[0];
+        return {
+            totalChunks: parseInt(row.total_chunks) || 0,
+            compressedChunks: parseInt(row.compressed_chunks) || 0,
+            totalSize: row.total_size || '0 bytes',
+            compressedSize: row.compressed_size || '0 bytes',
+            compressionRatio: parseFloat(row.compression_ratio) || 0,
+        };
+    }
+}
+//# sourceMappingURL=timescale-analytics.js.map

package/dist/src/integrations/pg-aiguide/timescale-analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timescale-analytics.js","sourceRoot":"","sources":["../../../../src/integrations/pg-aiguide/timescale-analytics.ts"],"names":[],"mappings":"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"}

package/dist/src/mcp/stackmemory-mcp-server.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * StackMemory MCP Server - Integrates with Claude Desktop
+ *
+ * This MCP server exposes StackMemory's agent task management
+ * and context persistence to Claude sessions automatically.
+ */
+export {};
+//# sourceMappingURL=stackmemory-mcp-server.d.ts.map

package/dist/src/mcp/stackmemory-mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stackmemory-mcp-server.d.ts","sourceRoot":"","sources":["../../../src/mcp/stackmemory-mcp-server.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}