@stackmemoryai/stackmemory 0.2.7 → 0.2.9

package/dist/src/core/persistence/postgres-adapter.js

@@ -0,0 +1,316 @@
+import { Pool } from 'pg';
+import { logger } from '../monitoring/logger.js';
+export class PostgresAdapter {
+    pool;
+    config;
+    isInitialized = false;
+    constructor(config) {
+        this.config = {
+            ...config,
+            vectorDimensions: config.vectorDimensions || 1536, // OpenAI ada-002 dimensions
+        };
+        this.pool = new Pool(this.config);
+    }
+    async connect() {
+        try {
+            await this.pool.connect();
+            await this.initialize();
+            this.isInitialized = true;
+            logger.info('PostgreSQL connected successfully');
+        }
+        catch (error) {
+            logger.error('Failed to connect to PostgreSQL', error instanceof Error ? error : undefined);
+            throw error;
+        }
+    }
+    async disconnect() {
+        await this.pool.end();
+        this.isInitialized = false;
+        logger.info('PostgreSQL disconnected');
+    }
+    async execute(query, params) {
+        try {
+            const result = await this.pool.query(query, params);
+            return {
+                rows: result.rows,
+                rowCount: result.rowCount || 0,
+                fields: result.fields?.map((f) => ({
+                    name: f.name,
+                    type: f.dataTypeID.toString(),
+                })),
+            };
+        }
+        catch (error) {
+            logger.error('Query execution failed', error instanceof Error ? error : new Error(String(error)), { query });
+            throw error;
+        }
+    }
+    async beginTransaction() {
+        await this.execute('BEGIN');
+    }
+    async commit() {
+        await this.execute('COMMIT');
+    }
+    async rollback() {
+        await this.execute('ROLLBACK');
+    }
+    isConnected() {
+        return this.isInitialized;
+    }
+    async initialize() {
+        // Create base schema
+        await this.createBaseSchema();
+        // Enable extensions if configured
+        if (this.config.enableTimescale) {
+            await this.enableTimescale();
+        }
+        if (this.config.enablePgvector) {
+            await this.enablePgvector();
+        }
+    }
+    async createBaseSchema() {
+        const queries = [
+            // Projects table
+            `CREATE TABLE IF NOT EXISTS projects (
+        id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+        name VARCHAR(255) NOT NULL,
+        path TEXT NOT NULL,
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        metadata JSONB
+      )`,
+            // Sessions table
+            `CREATE TABLE IF NOT EXISTS sessions (
+        id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+        project_id UUID REFERENCES projects(id) ON DELETE CASCADE,
+        branch VARCHAR(255),
+        started_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        ended_at TIMESTAMP,
+        metadata JSONB
+      )`,
+            // Traces table
+            `CREATE TABLE IF NOT EXISTS traces (
+        id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+        session_id UUID REFERENCES sessions(id) ON DELETE CASCADE,
+        timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        type VARCHAR(100) NOT NULL,
+        data JSONB NOT NULL,
+        metadata JSONB,
+        INDEX idx_traces_session_timestamp (session_id, timestamp)
+      )`,
+            // Context frames table
+            `CREATE TABLE IF NOT EXISTS context_frames (
+        id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+        project_id UUID REFERENCES projects(id) ON DELETE CASCADE,
+        branch VARCHAR(255),
+        content TEXT NOT NULL,
+        summary TEXT,
+        timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        type VARCHAR(100) NOT NULL,
+        metadata JSONB,
+        INDEX idx_context_project_branch (project_id, branch)
+      )`,
+            // Decisions table
+            `CREATE TABLE IF NOT EXISTS decisions (
+        id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+        project_id UUID REFERENCES projects(id) ON DELETE CASCADE,
+        session_id UUID REFERENCES sessions(id) ON DELETE CASCADE,
+        decision TEXT NOT NULL,
+        rationale TEXT,
+        timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        metadata JSONB
+      )`,
+        ];
+        for (const query of queries) {
+            await this.execute(query);
+        }
+    }
+    async enableTimescale() {
+        try {
+            await this.execute('CREATE EXTENSION IF NOT EXISTS timescaledb');
+            // Convert traces to hypertable
+            await this.execute(`
+        SELECT create_hypertable('traces', 'timestamp',
+          if_not_exists => TRUE,
+          chunk_time_interval => INTERVAL '1 day'
+        )
+      `);
+            // Convert context_frames to hypertable
+            await this.execute(`
+        SELECT create_hypertable('context_frames', 'timestamp',
+          if_not_exists => TRUE,
+          chunk_time_interval => INTERVAL '7 days'
+        )
+      `);
+            logger.info('TimescaleDB extension enabled');
+        }
+        catch (error) {
+            logger.warn('Failed to enable TimescaleDB', error instanceof Error ? error : undefined);
+        }
+    }
+    async enablePgvector() {
+        try {
+            await this.execute('CREATE EXTENSION IF NOT EXISTS vector');
+            // Add embedding columns
+            await this.execute(`
+        ALTER TABLE context_frames 
+        ADD COLUMN IF NOT EXISTS embedding vector(${this.config.vectorDimensions})
+      `);
+            await this.execute(`
+        ALTER TABLE traces 
+        ADD COLUMN IF NOT EXISTS embedding vector(${this.config.vectorDimensions})
+      `);
+            // Create vector indexes
+            await this.execute(`
+        CREATE INDEX IF NOT EXISTS idx_context_embedding 
+        ON context_frames 
+        USING ivfflat (embedding vector_cosine_ops)
+        WITH (lists = 100)
+      `);
+            logger.info('pgvector extension enabled');
+        }
+        catch (error) {
+            logger.warn('Failed to enable pgvector', error instanceof Error ? error : undefined);
+        }
+    }
+    // Data access methods
+    async saveTrace(trace) {
+        await this.execute(`INSERT INTO traces (id, session_id, timestamp, type, data, metadata)
+       VALUES ($1, $2, $3, $4, $5, $6)`, [
+            trace.id,
+            trace.sessionId,
+            trace.timestamp,
+            trace.type,
+            JSON.stringify(trace.data),
+            trace.metadata ? JSON.stringify(trace.metadata) : null,
+        ]);
+    }
+    async saveContext(context) {
+        await this.execute(`INSERT INTO context_frames (id, project_id, branch, content, timestamp, type, metadata)
+       VALUES ($1, $2, $3, $4, $5, $6, $7)`, [
+            context.id,
+            context.projectId,
+            context.branch || null,
+            context.content,
+            context.timestamp,
+            context.type,
+            context.metadata ? JSON.stringify(context.metadata) : null,
+        ]);
+    }
+    async getRecentTraces(sessionId, limit = 100) {
+        const result = await this.execute(`SELECT * FROM traces 
+       WHERE session_id = $1 
+       ORDER BY timestamp DESC 
+       LIMIT $2`, [sessionId, limit]);
+        return result.rows.map((row) => ({
+            id: row.id,
+            sessionId: row.session_id,
+            timestamp: row.timestamp,
+            type: row.type,
+            data: row.data,
+            metadata: row.metadata,
+        }));
+    }
+    async getRecentContext(projectId, branch, limit = 50) {
+        const query = branch
+            ? `SELECT * FROM context_frames 
+         WHERE project_id = $1 AND branch = $2 
+         ORDER BY timestamp DESC 
+         LIMIT $3`
+            : `SELECT * FROM context_frames 
+         WHERE project_id = $1 
+         ORDER BY timestamp DESC 
+         LIMIT $2`;
+        const params = branch ? [projectId, branch, limit] : [projectId, limit];
+        const result = await this.execute(query, params);
+        return result.rows.map((row) => ({
+            id: row.id,
+            projectId: row.project_id,
+            branch: row.branch,
+            content: row.content,
+            timestamp: row.timestamp,
+            type: row.type,
+            metadata: row.metadata,
+        }));
+    }
+    // Hybrid SQLite/PostgreSQL migration helper
+    async migrateFromSQLite(sqliteDb) {
+        logger.info('Starting migration from SQLite to PostgreSQL');
+        try {
+            await this.beginTransaction();
+            // Migrate projects
+            const projects = sqliteDb
+                .prepare('SELECT * FROM projects')
+                .all();
+            for (const project of projects) {
+                await this.execute('INSERT INTO projects (id, name, path, created_at, updated_at, metadata) VALUES ($1, $2, $3, $4, $5, $6)', [
+                    project.id,
+                    project.name,
+                    project.path,
+                    project.created_at,
+                    project.updated_at,
+                    project.metadata,
+                ]);
+            }
+            // Migrate sessions
+            const sessions = sqliteDb
+                .prepare('SELECT * FROM sessions')
+                .all();
+            for (const session of sessions) {
+                await this.execute('INSERT INTO sessions (id, project_id, branch, started_at, ended_at, metadata) VALUES ($1, $2, $3, $4, $5, $6)', [
+                    session.id,
+                    session.project_id,
+                    session.branch,
+                    session.started_at,
+                    session.ended_at,
+                    session.metadata,
+                ]);
+            }
+            // Migrate traces in batches
+            const traceCount = sqliteDb
+                .prepare('SELECT COUNT(*) as count FROM traces')
+                .get();
+            const batchSize = 1000;
+            for (let offset = 0; offset < traceCount.count; offset += batchSize) {
+                const traces = sqliteDb
+                    .prepare('SELECT * FROM traces LIMIT ? OFFSET ?')
+                    .all(batchSize, offset);
+                for (const trace of traces) {
+                    await this.execute('INSERT INTO traces (id, session_id, timestamp, type, data, metadata) VALUES ($1, $2, $3, $4, $5, $6)', [
+                        trace.id,
+                        trace.session_id,
+                        trace.timestamp,
+                        trace.type,
+                        trace.data,
+                        trace.metadata,
+                    ]);
+                }
+                logger.info(`Migrated ${offset + traces.length}/${traceCount.count} traces`);
+            }
+            // Migrate context frames
+            const contexts = sqliteDb
+                .prepare('SELECT * FROM context_frames')
+                .all();
+            for (const context of contexts) {
+                await this.execute('INSERT INTO context_frames (id, project_id, branch, content, summary, timestamp, type, metadata) VALUES ($1, $2, $3, $4, $5, $6, $7, $8)', [
+                    context.id,
+                    context.project_id,
+                    context.branch,
+                    context.content,
+                    context.summary,
+                    context.timestamp,
+                    context.type,
+                    context.metadata,
+                ]);
+            }
+            await this.commit();
+            logger.info('Migration completed successfully');
+        }
+        catch (error) {
+            await this.rollback();
+            logger.error('Migration failed', error instanceof Error ? error : undefined);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=postgres-adapter.js.map

package/dist/src/core/persistence/postgres-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-adapter.js","sourceRoot":"","sources":["../../../../src/core/persistence/postgres-adapter.ts"],"names":[],"mappings":"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"}

package/dist/src/core/query/query-parser.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Query Parser for StackMemory
+ * Handles both natural language and structured queries
+ */
+export interface TimeFilter {
+    last?: string;
+    since?: Date;
+    until?: Date;
+    between?: [Date, Date];
+    specific?: Date;
+}
+export interface ContentFilter {
+    topic?: string[];
+    files?: string[];
+    errors?: string[];
+    tools?: string[];
+}
+export interface FrameFilter {
+    type?: FrameType[];
+    status?: FrameStatus[];
+    score?: {
+        min?: number;
+        max?: number;
+    };
+    depth?: {
+        min?: number;
+        max?: number;
+    };
+}
+export interface PeopleFilter {
+    owner?: string[];
+    contributors?: string[];
+    team?: string;
+}
+export interface OutputControl {
+    limit?: number;
+    sort?: 'time' | 'score' | 'relevance';
+    include?: ('digests' | 'events' | 'anchors')[];
+    format?: 'full' | 'summary' | 'ids';
+}
+export interface StackMemoryQuery {
+    time?: TimeFilter;
+    content?: ContentFilter;
+    frame?: FrameFilter;
+    people?: PeopleFilter;
+    output?: OutputControl;
+}
+export interface QueryResponse {
+    original: string;
+    interpreted: StackMemoryQuery;
+    expanded: StackMemoryQuery;
+    suggestions?: string[];
+    validationErrors?: string[];
+}
+export declare enum FrameType {
+    TASK = "task",
+    DEBUG = "debug",
+    FEATURE = "feature",
+    ARCHITECTURE = "architecture",
+    BUG = "bug",
+    REFACTOR = "refactor"
+}
+export declare enum FrameStatus {
+    OPEN = "open",
+    CLOSED = "closed",
+    STALLED = "stalled"
+}
+export declare class QueryParser {
+    private shortcuts;
+    /**
+     * Parse natural language query into structured format
+     */
+    parseNaturalLanguage(query: string): StackMemoryQuery;
+    /**
+     * Parse structured query with validation
+     */
+    parseStructured(query: StackMemoryQuery): StackMemoryQuery;
+    /**
+     * Parse hybrid query (natural language with structured modifiers)
+     */
+    parseHybrid(naturalQuery: string, modifiers?: Partial<StackMemoryQuery>): StackMemoryQuery;
+    private parseTimePatterns;
+    private parseTopicPatterns;
+    private parsePeoplePatterns;
+    private expandShortcuts;
+    private mergeQueries;
+    /**
+     * Expand query with synonyms and related terms
+     */
+    expandQuery(query: StackMemoryQuery): StackMemoryQuery;
+    /**
+     * Main parse method that returns a complete QueryResponse
+     */
+    parse(query: string | StackMemoryQuery): QueryResponse;
+    /**
+     * Validate query for errors and inconsistencies
+     */
+    private validateQuery;
+    /**
+     * Generate query suggestions based on the interpreted query
+     */
+    private generateSuggestions;
+}
+//# sourceMappingURL=query-parser.d.ts.map

package/dist/src/core/query/query-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-parser.d.ts","sourceRoot":"","sources":["../../../../src/core/query/query-parser.ts"],"names":[],"mappings":"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"}