@pga-ai/adapters-storage-postgres 0.8.0

package/README.md

@@ -0,0 +1,150 @@
+# @pga-ai/adapters-storage-postgres
+
+> PostgreSQL storage adapter for GSEP (Genomic Self-Evolving Prompts)
+
+## Installation
+
+```bash
+npm install @pga-ai/core @pga-ai/adapters-storage-postgres
+```
+
+## Usage
+
+```typescript
+import { PGA } from '@pga-ai/core';
+import { ClaudeAdapter } from '@pga-ai/adapters-llm-anthropic';
+import { PostgresAdapter } from '@pga-ai/adapters-storage-postgres';
+
+const pga = new PGA({
+  llm: new ClaudeAdapter({
+    apiKey: process.env.ANTHROPIC_API_KEY,
+  }),
+  storage: new PostgresAdapter({
+    connectionString: process.env.DATABASE_URL,
+    autoInitialize: true, // Creates tables automatically
+  }),
+});
+
+await pga.initialize();
+
+const genome = await pga.createGenome({ name: 'my-assistant' });
+const response = await genome.chat('Hello!', { userId: 'user123' });
+
+console.log(response);
+```
+
+## Configuration
+
+### `PostgresAdapter(config)`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `connectionString` | `string` | required | PostgreSQL connection string |
+| `maxConnections` | `number` | `20` | Maximum pool size |
+| `autoInitialize` | `boolean` | `true` | Auto-create database schema |
+
+### Connection String Format
+
+```
+postgresql://user:password@host:port/database
+```
+
+**Example:**
+```
+postgresql://postgres:secret@localhost:5432/pga
+```
+
+## Database Schema
+
+The adapter automatically creates the following tables:
+
+- `pga_genomes` - Genome metadata
+- `pga_alleles` - Gene alleles (Layer 0, 1, 2)
+- `pga_user_dna` - User cognitive profiles
+- `pga_interactions` - Interaction logs
+- `pga_mutations` - Mutation history
+- `pga_feedback` - User feedback signals
+- `pga_analytics` - Pre-aggregated stats
+
+See [`sql/schema.sql`](./sql/schema.sql) for full schema.
+
+## Manual Schema Setup
+
+If you prefer to manage migrations yourself:
+
+```typescript
+const adapter = new PostgresAdapter({
+  connectionString: process.env.DATABASE_URL,
+  autoInitialize: false, // Don't auto-create tables
+});
+
+// Run your own migrations
+await runMigrations();
+
+// Then initialize GSEP (will skip schema creation)
+await pga.initialize();
+```
+
+## Performance
+
+### Connection Pooling
+
+The adapter uses `pg` connection pooling by default:
+
+```typescript
+const adapter = new PostgresAdapter({
+  connectionString: process.env.DATABASE_URL,
+  maxConnections: 50, // Increase for high load
+});
+```
+
+### Indexes
+
+All critical queries are indexed:
+- Genome lookups: `pga_genomes(id)`
+- Allele selection: `pga_alleles(genome_id, layer, gene, status)`
+- User DNA: `pga_user_dna(user_id, genome_id)`
+- Analytics queries: All have composite indexes
+
+## Production Checklist
+
+✅ Use connection pooling (`maxConnections: 20+`)
+✅ Enable SSL for remote databases
+✅ Set up database backups
+✅ Monitor connection pool usage
+✅ Use read replicas for analytics queries
+✅ Consider partitioning `pga_interactions` table for high volume
+
+## Troubleshooting
+
+### "relation does not exist" error
+
+```typescript
+// Ensure autoInitialize is true
+const adapter = new PostgresAdapter({
+  connectionString: process.env.DATABASE_URL,
+  autoInitialize: true, // ← This creates tables
+});
+
+await pga.initialize();
+```
+
+### Connection timeout
+
+```typescript
+// Increase max connections
+const adapter = new PostgresAdapter({
+  connectionString: process.env.DATABASE_URL,
+  maxConnections: 50, // Default is 20
+});
+```
+
+### SSL connection required
+
+```
+postgresql://user:pass@host:5432/db?sslmode=require
+```
+
+## License
+
+MIT © Luis Alfredo Velasquez Duran

package/dist/index.d.ts

@@ -0,0 +1,65 @@
+import type { StorageAdapter, Genome, UserDNA, Interaction, MutationLog, SemanticFact, GeneRegistryEntry } from '@pga-ai/core';
+export interface PostgresAdapterConfig {
+    connectionString: string;
+    maxConnections?: number;
+    autoInitialize?: boolean;
+}
+export declare class PostgresAdapter implements StorageAdapter {
+    private pool;
+    private config;
+    constructor(config: PostgresAdapterConfig);
+    initialize(): Promise<void>;
+    saveGenome(genome: Genome): Promise<void>;
+    loadGenome(genomeId: string): Promise<Genome | null>;
+    listGenomes(): Promise<Genome[]>;
+    deleteGenome(genomeId: string): Promise<void>;
+    saveDNA(userId: string, genomeId: string, dna: UserDNA): Promise<void>;
+    loadDNA(userId: string, genomeId: string): Promise<UserDNA | null>;
+    recordInteraction(interaction: Interaction): Promise<void>;
+    logMutation(mutation: MutationLog): Promise<void>;
+    getMutationHistory(genomeId: string, limit?: number): Promise<MutationLog[]>;
+    getGeneMutationHistory(genomeId: string, gene: string, limit?: number): Promise<MutationLog[]>;
+    getRecentInteractions(genomeId: string, userId: string, limit?: number): Promise<unknown[]>;
+    recordFeedback(feedback: {
+        genomeId: string;
+        userId: string;
+        gene: string;
+        sentiment: 'positive' | 'negative' | 'neutral';
+        timestamp: Date;
+    }): Promise<void>;
+    getAnalytics(genomeId: string): Promise<{
+        totalMutations: number;
+        totalInteractions: number;
+        avgFitnessImprovement: number;
+        userSatisfaction: number;
+        topGenes: Array<{
+            gene: string;
+            fitness: number;
+        }>;
+    }>;
+    saveFact(fact: SemanticFact, userId: string, genomeId: string): Promise<void>;
+    getFacts(userId: string, genomeId: string, includeExpired?: boolean): Promise<SemanticFact[]>;
+    getFact(factId: string): Promise<SemanticFact | null>;
+    updateFact(factId: string, updates: Partial<SemanticFact>): Promise<void>;
+    deleteFact(factId: string): Promise<void>;
+    deleteUserFacts(userId: string, genomeId: string): Promise<void>;
+    cleanExpiredFacts(userId: string, genomeId: string): Promise<number>;
+    saveToGeneRegistry(entry: {
+        id: string;
+        familyId: string;
+        gene: string;
+        variant: string;
+        content: string;
+        layer: 0 | 1 | 2;
+        fitness: number;
+        sampleCount: number;
+        successRate: number;
+        metadata: Record<string, unknown>;
+        createdAt: Date;
+    }): Promise<void>;
+    queryGeneRegistry(familyId: string, gene?: string, minFitness?: number): Promise<GeneRegistryEntry[]>;
+    getBestRegistryGene(familyId: string, gene: string): Promise<GeneRegistryEntry | null>;
+    private mapRowToGeneRegistryEntry;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,501 @@
+import { Pool } from 'pg';
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export class PostgresAdapter {
+    pool;
+    config;
+    constructor(config) {
+        this.config = {
+            connectionString: config.connectionString,
+            maxConnections: config.maxConnections ?? 20,
+            autoInitialize: config.autoInitialize ?? true,
+        };
+        const poolConfig = {
+            connectionString: this.config.connectionString,
+            max: this.config.maxConnections,
+        };
+        this.pool = new Pool(poolConfig);
+    }
+    async initialize() {
+        if (!this.config.autoInitialize) {
+            return;
+        }
+        try {
+            const schemaPath = join(__dirname, '../sql/schema.sql');
+            const schema = readFileSync(schemaPath, 'utf-8');
+            await this.pool.query(schema);
+            console.log('[GSEP] PostgreSQL schema initialized');
+        }
+        catch (error) {
+            throw new Error(`Failed to initialize PostgreSQL schema: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    async saveGenome(genome) {
+        const client = await this.pool.connect();
+        try {
+            await client.query('BEGIN');
+            await client.query(`INSERT INTO pga_genomes (id, name, config, created_at, updated_at)
+                 VALUES ($1, $2, $3, $4, $5)
+                 ON CONFLICT (id) DO UPDATE SET
+                    name = $2,
+                    config = $3,
+                    updated_at = $5`, [
+                genome.id,
+                genome.name,
+                JSON.stringify(genome.config),
+                genome.createdAt,
+                genome.updatedAt,
+            ]);
+            await client.query('DELETE FROM pga_alleles WHERE genome_id = $1', [genome.id]);
+            for (const layer of [0, 1, 2]) {
+                const layerKey = `layer${layer}`;
+                const alleles = genome.layers[layerKey];
+                for (const allele of alleles) {
+                    await client.query(`INSERT INTO pga_alleles (
+                            genome_id, layer, gene, variant, content, fitness,
+                            sample_count, parent_variant, generation, status,
+                            sandbox_tested, sandbox_score, recent_scores,
+                            created_at, updated_at
+                        ) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15)`, [
+                        genome.id,
+                        layer,
+                        allele.gene,
+                        allele.variant,
+                        allele.content,
+                        allele.fitness,
+                        allele.sampleCount || 0,
+                        allele.parentVariant,
+                        allele.generation || 0,
+                        allele.status,
+                        allele.sandboxTested || false,
+                        allele.sandboxScore,
+                        JSON.stringify(allele.recentScores || []),
+                        allele.createdAt,
+                        new Date(),
+                    ]);
+                }
+            }
+            await client.query('COMMIT');
+        }
+        catch (error) {
+            await client.query('ROLLBACK');
+            throw error;
+        }
+        finally {
+            client.release();
+        }
+    }
+    async loadGenome(genomeId) {
+        const result = await this.pool.query('SELECT * FROM pga_genomes WHERE id = $1', [genomeId]);
+        if (result.rows.length === 0) {
+            return null;
+        }
+        const row = result.rows[0];
+        const allelesResult = await this.pool.query('SELECT * FROM pga_alleles WHERE genome_id = $1 ORDER BY layer, gene, fitness DESC', [genomeId]);
+        const layer0 = [];
+        const layer1 = [];
+        const layer2 = [];
+        for (const alleleRow of allelesResult.rows) {
+            const allele = {
+                gene: alleleRow.gene,
+                variant: alleleRow.variant,
+                content: alleleRow.content,
+                fitness: parseFloat(alleleRow.fitness),
+                sampleCount: alleleRow.sample_count,
+                parentVariant: alleleRow.parent_variant,
+                generation: alleleRow.generation,
+                status: alleleRow.status,
+                sandboxTested: alleleRow.sandbox_tested,
+                sandboxScore: alleleRow.sandbox_score ? parseFloat(alleleRow.sandbox_score) : undefined,
+                recentScores: alleleRow.recent_scores || [],
+                createdAt: alleleRow.created_at,
+            };
+            if (alleleRow.layer === 0)
+                layer0.push(allele);
+            else if (alleleRow.layer === 1)
+                layer1.push(allele);
+            else if (alleleRow.layer === 2)
+                layer2.push(allele);
+        }
+        return {
+            id: row.id,
+            name: row.name,
+            config: row.config,
+            layers: {
+                layer0,
+                layer1,
+                layer2,
+            },
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    async listGenomes() {
+        const result = await this.pool.query('SELECT id FROM pga_genomes ORDER BY created_at DESC');
+        const genomes = [];
+        for (const row of result.rows) {
+            const genome = await this.loadGenome(row.id);
+            if (genome) {
+                genomes.push(genome);
+            }
+        }
+        return genomes;
+    }
+    async deleteGenome(genomeId) {
+        await this.pool.query('DELETE FROM pga_genomes WHERE id = $1', [genomeId]);
+    }
+    async saveDNA(userId, genomeId, dna) {
+        await this.pool.query(`INSERT INTO pga_user_dna (
+                user_id, genome_id, traits, confidence, generation, last_evolved, updated_at
+            ) VALUES ($1, $2, $3, $4, $5, $6, $7)
+            ON CONFLICT (user_id, genome_id) DO UPDATE SET
+                traits = $3,
+                confidence = $4,
+                generation = $5,
+                last_evolved = $6,
+                updated_at = $7`, [
+            userId,
+            genomeId,
+            JSON.stringify(dna.traits),
+            JSON.stringify(dna.confidence),
+            dna.generation,
+            dna.lastEvolved,
+            new Date(),
+        ]);
+    }
+    async loadDNA(userId, genomeId) {
+        const result = await this.pool.query('SELECT * FROM pga_user_dna WHERE user_id = $1 AND genome_id = $2', [userId, genomeId]);
+        if (result.rows.length === 0) {
+            return null;
+        }
+        const row = result.rows[0];
+        return {
+            userId: row.user_id,
+            genomeId: row.genome_id,
+            traits: row.traits,
+            confidence: row.confidence,
+            generation: row.generation,
+            lastEvolved: row.last_evolved,
+        };
+    }
+    async recordInteraction(interaction) {
+        await this.pool.query(`INSERT INTO pga_interactions (
+                genome_id, user_id, user_message, assistant_response,
+                tool_calls, score, task_type, timestamp
+            ) VALUES ($1, $2, $3, $4, $5, $6, $7, $8)`, [
+            interaction.genomeId,
+            interaction.userId,
+            interaction.userMessage,
+            interaction.assistantResponse,
+            JSON.stringify(interaction.toolCalls),
+            interaction.score,
+            interaction.taskType,
+            interaction.timestamp,
+        ]);
+    }
+    async logMutation(mutation) {
+        await this.pool.query(`INSERT INTO pga_mutations (
+                genome_id, layer, gene, variant, mutation_type,
+                parent_variant, trigger_reason, fitness_delta,
+                deployed, details, timestamp
+            ) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11)`, [
+            mutation.genomeId,
+            mutation.layer,
+            mutation.gene,
+            mutation.variant,
+            mutation.mutationType,
+            mutation.parentVariant,
+            mutation.triggerReason,
+            mutation.fitnessDelta,
+            mutation.deployed,
+            JSON.stringify(mutation.details || {}),
+            mutation.timestamp,
+        ]);
+    }
+    async getMutationHistory(genomeId, limit = 100) {
+        const result = await this.pool.query(`SELECT * FROM pga_mutations
+             WHERE genome_id = $1
+             ORDER BY timestamp DESC
+             LIMIT $2`, [genomeId, limit]);
+        return result.rows.map((row) => ({
+            genomeId: row.genome_id,
+            layer: row.layer,
+            gene: row.gene,
+            variant: row.variant,
+            mutationType: row.mutation_type,
+            parentVariant: row.parent_variant,
+            triggerReason: row.trigger_reason,
+            fitnessDelta: parseFloat(row.fitness_delta),
+            deployed: row.deployed,
+            details: row.details,
+            createdAt: row.timestamp,
+            timestamp: row.timestamp,
+        }));
+    }
+    async getGeneMutationHistory(genomeId, gene, limit = 50) {
+        const result = await this.pool.query(`SELECT * FROM pga_mutations
+             WHERE genome_id = $1 AND gene = $2
+             ORDER BY timestamp DESC
+             LIMIT $3`, [genomeId, gene, limit]);
+        return result.rows.map((row) => ({
+            genomeId: row.genome_id,
+            layer: row.layer,
+            gene: row.gene,
+            variant: row.variant,
+            mutationType: row.mutation_type,
+            parentVariant: row.parent_variant,
+            triggerReason: row.trigger_reason,
+            fitnessDelta: parseFloat(row.fitness_delta),
+            deployed: row.deployed,
+            details: row.details,
+            createdAt: row.timestamp,
+            timestamp: row.timestamp,
+        }));
+    }
+    async getRecentInteractions(genomeId, userId, limit = 20) {
+        const result = await this.pool.query(`SELECT * FROM pga_interactions
+             WHERE genome_id = $1 AND user_id = $2
+             ORDER BY timestamp DESC
+             LIMIT $3`, [genomeId, userId, limit]);
+        return result.rows.map((row) => ({
+            genomeId: row.genome_id,
+            userId: row.user_id,
+            userMessage: row.user_message,
+            assistantResponse: row.assistant_response,
+            toolCalls: row.tool_calls,
+            score: row.score ? parseFloat(row.score) : undefined,
+            timestamp: row.timestamp,
+        }));
+    }
+    async recordFeedback(feedback) {
+        await this.pool.query(`INSERT INTO pga_feedback (
+                genome_id, user_id, gene, sentiment, timestamp
+            ) VALUES ($1, $2, $3, $4, $5)`, [
+            feedback.genomeId,
+            feedback.userId,
+            feedback.gene,
+            feedback.sentiment,
+            feedback.timestamp,
+        ]);
+    }
+    async getAnalytics(genomeId) {
+        const [interactionsResult, mutationsResult, feedbackResult, topGenesResult,] = await Promise.all([
+            this.pool.query('SELECT COUNT(*) as count FROM pga_interactions WHERE genome_id = $1', [genomeId]),
+            this.pool.query('SELECT COUNT(*) as count, AVG(fitness_improvement) as avg_improvement FROM pga_mutations WHERE genome_id = $1 AND deployed = true', [genomeId]),
+            this.pool.query(`SELECT
+                    COUNT(*) FILTER (WHERE sentiment = 'positive') as positive,
+                    COUNT(*) as total
+                 FROM pga_feedback WHERE genome_id = $1`, [genomeId]),
+            this.pool.query(`SELECT gene, AVG(sandbox_score) as fitness
+                 FROM pga_mutations
+                 WHERE genome_id = $1 AND deployed = true
+                 GROUP BY gene
+                 ORDER BY fitness DESC
+                 LIMIT 5`, [genomeId]),
+        ]);
+        const totalFeedback = parseInt(feedbackResult.rows[0]?.total || '0');
+        const positiveFeedback = parseInt(feedbackResult.rows[0]?.positive || '0');
+        return {
+            totalMutations: parseInt(mutationsResult.rows[0]?.count || '0'),
+            totalInteractions: parseInt(interactionsResult.rows[0]?.count || '0'),
+            avgFitnessImprovement: parseFloat(mutationsResult.rows[0]?.avg_improvement || '0'),
+            userSatisfaction: totalFeedback > 0 ? positiveFeedback / totalFeedback : 0,
+            topGenes: topGenesResult.rows.map((row) => ({
+                gene: row.gene,
+                fitness: parseFloat(row.fitness || '0'),
+            })),
+        };
+    }
+    async saveFact(fact, userId, genomeId) {
+        await this.pool.query(`INSERT INTO semantic_facts (
+                id, user_id, genome_id, fact, category, confidence,
+                source_turn, source_interaction_id, extracted_at,
+                expiry, verified
+            ) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11)
+            ON CONFLICT (id) DO UPDATE SET
+                fact = $4,
+                category = $5,
+                confidence = $6,
+                verified = $11,
+                expiry = $10,
+                updated_at = NOW()`, [
+            fact.id,
+            userId,
+            genomeId,
+            fact.fact,
+            fact.category,
+            fact.confidence,
+            fact.sourceTurn,
+            fact.sourceInteractionId,
+            fact.extractedAt,
+            fact.expiry,
+            fact.verified,
+        ]);
+    }
+    async getFacts(userId, genomeId, includeExpired = false) {
+        const query = includeExpired
+            ? `SELECT * FROM semantic_facts
+               WHERE user_id = $1 AND genome_id = $2
+               ORDER BY verified DESC, confidence DESC, extracted_at DESC`
+            : `SELECT * FROM semantic_facts
+               WHERE user_id = $1 AND genome_id = $2
+               AND (expiry IS NULL OR expiry > NOW())
+               ORDER BY verified DESC, confidence DESC, extracted_at DESC`;
+        const result = await this.pool.query(query, [userId, genomeId]);
+        return result.rows.map((row) => ({
+            id: row.id,
+            fact: row.fact,
+            category: row.category,
+            confidence: parseFloat(row.confidence),
+            sourceTurn: row.source_turn,
+            sourceInteractionId: row.source_interaction_id,
+            extractedAt: row.extracted_at,
+            expiry: row.expiry,
+            verified: row.verified,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        }));
+    }
+    async getFact(factId) {
+        const result = await this.pool.query('SELECT * FROM semantic_facts WHERE id = $1', [factId]);
+        if (result.rows.length === 0) {
+            return null;
+        }
+        const row = result.rows[0];
+        return {
+            id: row.id,
+            fact: row.fact,
+            category: row.category,
+            confidence: parseFloat(row.confidence),
+            sourceTurn: row.source_turn,
+            sourceInteractionId: row.source_interaction_id,
+            extractedAt: row.extracted_at,
+            expiry: row.expiry,
+            verified: row.verified,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    async updateFact(factId, updates) {
+        const setClauses = [];
+        const values = [];
+        let paramIndex = 1;
+        if (updates.fact !== undefined) {
+            setClauses.push(`fact = $${paramIndex++}`);
+            values.push(updates.fact);
+        }
+        if (updates.category !== undefined) {
+            setClauses.push(`category = $${paramIndex++}`);
+            values.push(updates.category);
+        }
+        if (updates.confidence !== undefined) {
+            setClauses.push(`confidence = $${paramIndex++}`);
+            values.push(updates.confidence);
+        }
+        if (updates.verified !== undefined) {
+            setClauses.push(`verified = $${paramIndex++}`);
+            values.push(updates.verified);
+        }
+        if (updates.expiry !== undefined) {
+            setClauses.push(`expiry = $${paramIndex++}`);
+            values.push(updates.expiry);
+        }
+        if (setClauses.length === 0) {
+            return;
+        }
+        setClauses.push(`updated_at = NOW()`);
+        values.push(factId);
+        const query = `UPDATE semantic_facts SET ${setClauses.join(', ')} WHERE id = $${paramIndex}`;
+        await this.pool.query(query, values);
+    }
+    async deleteFact(factId) {
+        await this.pool.query('DELETE FROM semantic_facts WHERE id = $1', [factId]);
+    }
+    async deleteUserFacts(userId, genomeId) {
+        await this.pool.query('DELETE FROM semantic_facts WHERE user_id = $1 AND genome_id = $2', [userId, genomeId]);
+    }
+    async cleanExpiredFacts(userId, genomeId) {
+        const result = await this.pool.query(`DELETE FROM semantic_facts
+             WHERE user_id = $1 AND genome_id = $2
+             AND expiry IS NOT NULL AND expiry <= NOW()
+             RETURNING id`, [userId, genomeId]);
+        return result.rowCount || 0;
+    }
+    async saveToGeneRegistry(entry) {
+        await this.pool.query(`INSERT INTO pga_gene_registry (id, family_id, gene, variant, content, layer, fitness, sample_count, success_rate, metadata, created_at)
+             VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11)
+             ON CONFLICT (id) DO UPDATE SET
+                fitness = EXCLUDED.fitness,
+                sample_count = EXCLUDED.sample_count,
+                success_rate = EXCLUDED.success_rate,
+                metadata = EXCLUDED.metadata`, [
+            entry.id,
+            entry.familyId,
+            entry.gene,
+            entry.variant,
+            entry.content,
+            entry.layer,
+            entry.fitness,
+            entry.sampleCount,
+            entry.successRate,
+            JSON.stringify(entry.metadata),
+            entry.createdAt,
+        ]);
+    }
+    async queryGeneRegistry(familyId, gene, minFitness) {
+        let query = 'SELECT * FROM pga_gene_registry WHERE family_id = $1';
+        const params = [familyId];
+        let paramIndex = 2;
+        if (gene) {
+            query += ` AND gene = $${paramIndex++}`;
+            params.push(gene);
+        }
+        if (minFitness !== undefined) {
+            query += ` AND fitness >= $${paramIndex++}`;
+            params.push(minFitness);
+        }
+        query += ' ORDER BY fitness DESC';
+        const result = await this.pool.query(query, params);
+        return result.rows.map((row) => this.mapRowToGeneRegistryEntry(row));
+    }
+    async getBestRegistryGene(familyId, gene) {
+        const result = await this.pool.query(`SELECT * FROM pga_gene_registry
+             WHERE family_id = $1 AND gene = $2
+             ORDER BY fitness DESC
+             LIMIT 1`, [familyId, gene]);
+        if (result.rows.length === 0)
+            return null;
+        return this.mapRowToGeneRegistryEntry(result.rows[0]);
+    }
+    mapRowToGeneRegistryEntry(row) {
+        const rawMetadata = typeof row.metadata === 'string'
+            ? JSON.parse(row.metadata)
+            : row.metadata || {};
+        return {
+            id: row.id,
+            familyId: row.family_id,
+            gene: row.gene,
+            variant: row.variant,
+            content: row.content,
+            layer: row.layer,
+            fitness: parseFloat(row.fitness),
+            sampleCount: row.sample_count,
+            successRate: parseFloat(row.success_rate),
+            metadata: {
+                sourceGenomeId: rawMetadata.sourceGenomeId || '',
+                sourceVersion: rawMetadata.sourceVersion || 0,
+                publishedBy: rawMetadata.publishedBy || '',
+                description: rawMetadata.description,
+                tags: rawMetadata.tags,
+            },
+            createdAt: new Date(row.created_at),
+        };
+    }
+    async close() {
+        await this.pool.end();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@pga-ai/adapters-storage-postgres",
+  "version": "0.8.0",
+  "description": "PostgreSQL storage adapter for GSEP",
+  "author": "Luis Alfredo Velasquez Duran <contact@gsepcore.com>",
+  "license": "MIT",
+  "homepage": "https://gsepcore.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LuisvelMarketer/pga-platform",
+    "directory": "packages/adapters-storage/postgres"
+  },
+  "bugs": {
+    "url": "https://github.com/LuisvelMarketer/pga-platform/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "sql"
+  ],
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "pg": "^8.13.1",
+    "@pga-ai/core": "*"
+  },
+  "devDependencies": {
+    "@types/pg": "^8.11.10",
+    "typescript": "^5.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/sql/schema.sql

@@ -0,0 +1,251 @@
+-- PGA PostgreSQL Schema
+-- Created by Luis Alfredo Velasquez Duran (Germany, 2025)
+
+-- ═══════════════════════════════════════════════════════════
+-- GENOMES
+-- ═══════════════════════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS pga_genomes (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL,
+    config JSONB NOT NULL DEFAULT '{}',
+    -- Living OS v1.0: Lineage tracking
+    family_id TEXT,
+    version INTEGER DEFAULT 1,
+    lineage JSONB DEFAULT '{}',
+    c0_hash TEXT,
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_genomes_name ON pga_genomes(name);
+CREATE INDEX IF NOT EXISTS idx_genomes_family ON pga_genomes(family_id, version DESC);
+
+-- ═══════════════════════════════════════════════════════════
+-- LAYERS (Three-Layer Architecture)
+-- ═══════════════════════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS pga_alleles (
+    id BIGSERIAL PRIMARY KEY,
+    genome_id TEXT NOT NULL REFERENCES pga_genomes(id) ON DELETE CASCADE,
+    layer INTEGER NOT NULL CHECK (layer IN (0, 1, 2)),
+    gene TEXT NOT NULL,
+    variant TEXT NOT NULL,
+    content TEXT NOT NULL,
+    fitness NUMERIC(5,4) DEFAULT 0.5000,
+    sample_count INTEGER DEFAULT 0,
+    parent_variant TEXT,
+    generation INTEGER DEFAULT 0,
+    status TEXT DEFAULT 'active' CHECK (status IN ('active', 'retired')),
+    sandbox_tested BOOLEAN DEFAULT FALSE,
+    sandbox_score NUMERIC(5,4),
+    recent_scores JSONB DEFAULT '[]',
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW(),
+    UNIQUE(genome_id, layer, gene, variant)
+);
+
+CREATE INDEX IF NOT EXISTS idx_alleles_genome ON pga_alleles(genome_id);
+CREATE INDEX IF NOT EXISTS idx_alleles_active ON pga_alleles(genome_id, layer, gene, status) WHERE status = 'active';
+CREATE INDEX IF NOT EXISTS idx_alleles_fitness ON pga_alleles(genome_id, layer, gene, fitness DESC);
+
+-- ═══════════════════════════════════════════════════════════
+-- USER DNA (Cognitive Profiles)
+-- ═══════════════════════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS pga_user_dna (
+    user_id TEXT NOT NULL,
+    genome_id TEXT NOT NULL REFERENCES pga_genomes(id) ON DELETE CASCADE,
+    traits JSONB NOT NULL DEFAULT '{}',
+    confidence JSONB NOT NULL DEFAULT '{}',
+    generation INTEGER DEFAULT 0,
+    last_evolved TIMESTAMPTZ DEFAULT NOW(),
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW(),
+    PRIMARY KEY (user_id, genome_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_user_dna_genome ON pga_user_dna(genome_id);
+CREATE INDEX IF NOT EXISTS idx_user_dna_evolved ON pga_user_dna(genome_id, last_evolved DESC);
+
+-- ═══════════════════════════════════════════════════════════
+-- INTERACTIONS (Learning Data)
+-- ═══════════════════════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS pga_interactions (
+    id BIGSERIAL PRIMARY KEY,
+    genome_id TEXT NOT NULL REFERENCES pga_genomes(id) ON DELETE CASCADE,
+    user_id TEXT NOT NULL,
+    user_message TEXT NOT NULL,
+    assistant_response TEXT NOT NULL,
+    tool_calls JSONB DEFAULT '[]',
+    score NUMERIC(5,4),
+    user_satisfied BOOLEAN,
+    task_type TEXT,
+    timestamp TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_interactions_genome ON pga_interactions(genome_id, timestamp DESC);
+CREATE INDEX IF NOT EXISTS idx_interactions_user ON pga_interactions(genome_id, user_id, timestamp DESC);
+
+-- ═══════════════════════════════════════════════════════════
+-- MUTATIONS (Evolution Log)
+-- ═══════════════════════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS pga_mutations (
+    id BIGSERIAL PRIMARY KEY,
+    genome_id TEXT NOT NULL REFERENCES pga_genomes(id) ON DELETE CASCADE,
+    layer INTEGER NOT NULL,
+    gene TEXT NOT NULL,
+    variant TEXT NOT NULL,
+    mutation_type TEXT NOT NULL,
+    parent_variant TEXT,
+    trigger_reason TEXT,
+    fitness_delta NUMERIC(5,4),
+    deployed BOOLEAN DEFAULT FALSE,
+    details JSONB DEFAULT '{}',
+    timestamp TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_mutations_genome ON pga_mutations(genome_id, timestamp DESC);
+CREATE INDEX IF NOT EXISTS idx_mutations_gene ON pga_mutations(genome_id, gene, timestamp DESC);
+CREATE INDEX IF NOT EXISTS idx_mutations_deployed ON pga_mutations(genome_id, deployed, timestamp DESC);
+
+-- ═══════════════════════════════════════════════════════════
+-- FEEDBACK (User Feedback Signals)
+-- ═══════════════════════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS pga_feedback (
+    id BIGSERIAL PRIMARY KEY,
+    genome_id TEXT NOT NULL REFERENCES pga_genomes(id) ON DELETE CASCADE,
+    user_id TEXT NOT NULL,
+    gene TEXT,
+    sentiment TEXT NOT NULL CHECK (sentiment IN ('positive', 'negative', 'neutral')),
+    timestamp TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_feedback_genome ON pga_feedback(genome_id, timestamp DESC);
+CREATE INDEX IF NOT EXISTS idx_feedback_user ON pga_feedback(genome_id, user_id, timestamp DESC);
+
+-- ═══════════════════════════════════════════════════════════
+-- ANALYTICS (Pre-aggregated Stats)
+-- ═══════════════════════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS pga_analytics (
+    genome_id TEXT NOT NULL REFERENCES pga_genomes(id) ON DELETE CASCADE,
+    metric TEXT NOT NULL,
+    value JSONB NOT NULL,
+    snapshot_at TIMESTAMPTZ DEFAULT NOW(),
+    PRIMARY KEY (genome_id, metric, snapshot_at)
+);
+
+CREATE INDEX IF NOT EXISTS idx_analytics_genome ON pga_analytics(genome_id, snapshot_at DESC);
+
+-- ═══════════════════════════════════════════════════════════
+-- GENE REGISTRY (Cross-Genome Knowledge Inheritance)
+-- ═══════════════════════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS pga_gene_registry (
+    id TEXT PRIMARY KEY,
+    family_id TEXT NOT NULL,
+    gene TEXT NOT NULL,
+    variant TEXT NOT NULL,
+    content TEXT NOT NULL,
+    layer INTEGER NOT NULL CHECK (layer IN (0, 1, 2)),
+    fitness NUMERIC(5,4) NOT NULL,
+    sample_count INTEGER NOT NULL,
+    success_rate NUMERIC(5,4) NOT NULL,
+    metadata JSONB NOT NULL DEFAULT '{}',
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    UNIQUE(family_id, gene, variant)
+);
+
+CREATE INDEX IF NOT EXISTS idx_gene_registry_family ON pga_gene_registry(family_id, fitness DESC);
+CREATE INDEX IF NOT EXISTS idx_gene_registry_gene ON pga_gene_registry(family_id, gene, fitness DESC);
+
+-- ═══════════════════════════════════════════════════════════
+-- CALIBRATION HISTORY (Dynamic Threshold Tuning)
+-- Living OS v1.0 Final 10/10
+-- ═══════════════════════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS pga_calibration_history (
+    id BIGSERIAL PRIMARY KEY,
+    context_key TEXT NOT NULL,
+    layer INTEGER CHECK (layer IN (0, 1, 2)),
+    operator TEXT,
+    task_type TEXT,
+    threshold NUMERIC(5,4) NOT NULL,
+    total_candidates INTEGER NOT NULL,
+    passed_sandbox INTEGER NOT NULL,
+    deployed_successfully INTEGER NOT NULL,
+    rolled_back INTEGER NOT NULL,
+    false_positive_rate NUMERIC(5,4) NOT NULL,
+    false_negative_rate NUMERIC(5,4) NOT NULL,
+    optimal_threshold NUMERIC(5,4) NOT NULL,
+    timestamp TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_calibration_context ON pga_calibration_history(context_key, timestamp DESC);
+CREATE INDEX IF NOT EXISTS idx_calibration_layer ON pga_calibration_history(layer, timestamp DESC);
+
+-- ═══════════════════════════════════════════════════════════
+-- SEMANTIC FACTS (Layered Memory - Long Term Storage)
+-- v0.3.0 - Production-Ready Persistence
+-- ═══════════════════════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS semantic_facts (
+    id TEXT PRIMARY KEY,
+    user_id TEXT NOT NULL,
+    genome_id TEXT NOT NULL REFERENCES pga_genomes(id) ON DELETE CASCADE,
+
+    -- Fact content
+    fact TEXT NOT NULL,
+    category TEXT NOT NULL CHECK (category IN ('profile', 'preference', 'constraint', 'knowledge')),
+
+    -- Metadata
+    confidence NUMERIC(5,4) NOT NULL CHECK (confidence >= 0.0 AND confidence <= 1.0),
+    source_turn INTEGER NOT NULL,
+    source_interaction_id TEXT,
+
+    -- Lifecycle
+    extracted_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    expiry TIMESTAMPTZ,  -- NULL = never expires
+    verified BOOLEAN NOT NULL DEFAULT FALSE,
+
+    -- Timestamps
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- Indexes for performance
+CREATE INDEX IF NOT EXISTS idx_semantic_facts_user_genome
+    ON semantic_facts(user_id, genome_id);
+
+CREATE INDEX IF NOT EXISTS idx_semantic_facts_expiry
+    ON semantic_facts(expiry)
+    WHERE expiry IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_semantic_facts_category
+    ON semantic_facts(genome_id, category);
+
+CREATE INDEX IF NOT EXISTS idx_semantic_facts_verified
+    ON semantic_facts(genome_id, verified)
+    WHERE verified = TRUE;
+
+CREATE INDEX IF NOT EXISTS idx_semantic_facts_active
+    ON semantic_facts(user_id, genome_id, expiry)
+    WHERE expiry IS NULL OR expiry > NOW();
+
+-- Auto-update updated_at trigger
+CREATE OR REPLACE FUNCTION update_semantic_facts_updated_at()
+RETURNS TRIGGER AS $$
+BEGIN
+    NEW.updated_at = NOW();
+    RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE TRIGGER trigger_semantic_facts_updated_at
+    BEFORE UPDATE ON semantic_facts
+    FOR EACH ROW
+    EXECUTE FUNCTION update_semantic_facts_updated_at();