@pga-ai/cli 0.8.0

package/README.md

@@ -0,0 +1,449 @@
+# @pga-ai/cli
+
+Interactive command-line interface for GSEP (Genomic Self-Evolving Prompts).
+
+## Installation
+
+### Global Installation (Recommended)
+
+```bash
+npm install -g @pga-ai/cli
+```
+
+### Local Installation
+
+```bash
+npm install --save-dev @pga-ai/cli
+```
+
+## Quick Start
+
+```bash
+# Initialize a new GSEP project
+pga init
+
+# Create a genome
+pga create --name my-assistant
+
+# Start an interactive chat session
+pga chat
+
+# Run benchmarks
+pga benchmark <genome-id>
+
+# View metrics
+pga metrics
+
+# Check system health
+pga status
+```
+
+## Commands
+
+### `pga init`
+
+Initialize a new GSEP project with templates.
+
+```bash
+pga init                      # Interactive template selection
+pga init --template basic     # Basic template
+pga init --template advanced  # Advanced with monitoring
+pga init --template enterprise # Enterprise-ready
+pga init --dir ./my-project   # Specify directory
+```
+
+**Templates:**
+- **basic** - Simple GSEP setup with Claude
+- **advanced** - Multi-model support + monitoring
+- **enterprise** - Production-ready with PostgreSQL
+
+### `pga create`
+
+Create a new genome.
+
+```bash
+pga create                              # Interactive mode
+pga create --name my-assistant          # With name
+pga create --model claude-sonnet-4.5    # Specify model
+```
+
+### `pga chat`
+
+Start an interactive chat session.
+
+```bash
+pga chat                    # Select genome interactively
+pga chat <genome-id>        # Chat with specific genome
+pga chat --user john-doe    # Specify user ID
+```
+
+**Chat Commands:**
+- Type your message and press Enter
+- `exit` or `quit` to end session
+
+### `pga list`
+
+List all genomes.
+
+```bash
+pga list                    # Table format
+pga list --format json      # JSON output
+pga list --sort fitness     # Sort by field
+```
+
+### `pga evolve`
+
+Manually trigger genome evolution.
+
+```bash
+pga evolve <genome-id>              # Auto-select layer
+pga evolve <genome-id> --layer 2    # Specific layer
+pga evolve <genome-id> --gene response_style  # Specific gene
+```
+
+### `pga benchmark`
+
+Run evaluation benchmarks.
+
+```bash
+pga benchmark                       # Interactive genome selection
+pga benchmark <genome-id>           # Benchmark specific genome
+pga benchmark --tasks debug-1,impl-1  # Specific tasks
+pga benchmark --compare <genome-id>   # Compare two genomes
+```
+
+### `pga metrics`
+
+View performance and cost metrics.
+
+```bash
+pga metrics                    # Last 24 hours
+pga metrics --period 1h        # Last hour
+pga metrics --period 7d        # Last 7 days
+pga metrics --export metrics.json  # Export to file
+```
+
+### `pga status`
+
+Show system health status.
+
+```bash
+pga status              # Current status
+pga status --watch      # Watch mode (updates every 5s)
+```
+
+### `pga config`
+
+Configure GSEP settings.
+
+```bash
+pga config --list                           # List all settings
+pga config --get api_key                    # Get specific value
+pga config --set model=claude-sonnet-4.5    # Set value
+```
+
+### `pga export`
+
+Export genome or data.
+
+```bash
+pga export <genome-id>                  # Default JSON
+pga export <genome-id> -o backup.json   # Specify output
+pga export <genome-id> --format yaml    # YAML format
+```
+
+### `pga import`
+
+Import genome from file.
+
+```bash
+pga import backup.json                  # Import genome
+pga import backup.json --name restored  # With custom name
+```
+
+### `pga doctor`
+
+Run diagnostics and check for issues.
+
+```bash
+pga doctor          # Run all checks
+pga doctor --fix    # Attempt to fix issues
+```
+
+**Checks:**
+- Node.js version (requires 20+)
+- TypeScript installation
+- GSEP core package
+- Environment variables
+
+## Project Templates
+
+### Basic Template
+
+Simple GSEP setup for getting started quickly.
+
+**Includes:**
+- TypeScript configuration
+- Claude adapter
+- Basic genome configuration
+- Example chat implementation
+
+```typescript
+import { PGA } from '@pga-ai/core';
+import { ClaudeAdapter } from '@pga-ai/adapters-llm-anthropic';
+
+const pga = new PGA({
+  llmAdapter: new ClaudeAdapter({
+    apiKey: process.env.ANTHROPIC_API_KEY!,
+  }),
+});
+```
+
+### Advanced Template
+
+Multi-model support with monitoring.
+
+**Includes:**
+- Claude + OpenAI adapters
+- MetricsCollector integration
+- Performance tracking
+- Cost monitoring
+- Alert configuration
+
+```typescript
+import { PGA, MetricsCollector } from '@pga-ai/core';
+import { ClaudeAdapter } from '@pga-ai/adapters-llm-anthropic';
+import { OpenAIAdapter } from '@pga-ai/adapters-llm-openai';
+
+const metrics = new MetricsCollector({
+  alertThresholds: {
+    maxCostPerHour: 50,
+    maxErrorRate: 0.05,
+  },
+});
+```
+
+### Enterprise Template
+
+Production-ready with all features.
+
+**Includes:**
+- PostgreSQL storage adapter
+- Comprehensive monitoring
+- Evaluation framework
+- Health monitoring
+- Audit logging
+- Graceful shutdown handling
+
+```typescript
+import { PGA, MetricsCollector, Evaluator } from '@pga-ai/core';
+import { ClaudeAdapter } from '@pga-ai/adapters-llm-anthropic';
+import { PostgresAdapter } from '@pga-ai/adapters-storage-postgres';
+
+const storage = new PostgresAdapter({
+  connectionString: process.env.DATABASE_URL!,
+});
+
+const pga = new PGA({
+  llmAdapter: new ClaudeAdapter({
+    apiKey: process.env.ANTHROPIC_API_KEY!,
+  }),
+  storageAdapter: storage,
+});
+```
+
+## Configuration
+
+The CLI uses environment variables for configuration:
+
+```bash
+# Required
+ANTHROPIC_API_KEY=your-api-key
+
+# Optional
+OPENAI_API_KEY=your-openai-key
+DATABASE_URL=postgresql://localhost/pga
+PGA_CONFIG_DIR=~/.pga
+```
+
+## Examples
+
+### Initialize and Run a Project
+
+```bash
+# 1. Create new project
+pga init --template advanced
+
+# 2. Navigate to project
+cd my-pga-project
+
+# 3. Install dependencies
+npm install
+
+# 4. Configure environment
+cp .env.example .env
+# Edit .env with your API keys
+
+# 5. Run the application
+npm run dev
+```
+
+### Create and Test a Genome
+
+```bash
+# Create genome
+pga create --name coding-assistant
+
+# Run benchmark
+pga benchmark <genome-id>
+
+# Chat with genome
+pga chat <genome-id>
+```
+
+### Monitor Production System
+
+```bash
+# Check system status
+pga status --watch
+
+# View metrics
+pga metrics --period 24h
+
+# Export metrics for analysis
+pga metrics --export daily-metrics.json
+```
+
+### Genome Backup and Restore
+
+```bash
+# Export genome
+pga export genome-123 -o backup.json
+
+# Import genome
+pga import backup.json --name restored-genome
+```
+
+## Global Options
+
+Available for all commands:
+
+```bash
+-v, --verbose     # Enable verbose output
+--no-color        # Disable colored output
+--help            # Show help for command
+--version         # Show CLI version
+```
+
+## Best Practices
+
+### 1. Use Templates
+
+Start with a template that matches your use case:
+- **Prototyping** → Basic
+- **Development** → Advanced
+- **Production** → Enterprise
+
+### 2. Version Control
+
+Always commit your `package.json` and `tsconfig.json`:
+
+```bash
+git add package.json tsconfig.json src/
+git commit -m "Initialize GSEP project"
+```
+
+### 3. Environment Variables
+
+Never commit `.env` files:
+
+```bash
+# In .gitignore
+.env
+*.env.local
+```
+
+### 4. Regular Backups
+
+Export genomes regularly:
+
+```bash
+pga export <genome-id> -o backups/genome-$(date +%Y%m%d).json
+```
+
+### 5. Monitoring
+
+Use `doctor` command to check for issues:
+
+```bash
+pga doctor
+```
+
+## Troubleshooting
+
+### Command Not Found
+
+```bash
+# Ensure global installation
+npm install -g @pga-ai/cli
+
+# Or use npx
+npx @pga-ai/cli init
+```
+
+### Permission Errors
+
+```bash
+# macOS/Linux
+sudo npm install -g @pga-ai/cli
+
+# Or use user directory
+npm config set prefix ~/.npm-global
+export PATH=~/.npm-global/bin:$PATH
+```
+
+### TypeScript Errors
+
+```bash
+# Install TypeScript globally
+npm install -g typescript
+
+# Or locally
+npm install --save-dev typescript
+```
+
+## Development
+
+To contribute to the CLI:
+
+```bash
+# Clone repository
+git clone https://github.com/pga-ai/pga-platform
+
+# Navigate to CLI package
+cd packages/cli
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Test locally
+npm link
+pga --help
+```
+
+## License
+
+MIT
+
+## Author
+
+**Luis Alfredo Velasquez Duran** (Germany, 2025)
+
+## Links
+
+- [GSEP Core](../../core/README.md)
+- [Documentation](https://gsepcore.com/docs)
+- [GitHub](https://github.com/pga-ai/pga-platform)

package/dist/commands/benchmark.d.ts

@@ -0,0 +1,2 @@
+export declare function benchmark(genomeId: string | undefined, options: any): Promise<void>;
+//# sourceMappingURL=benchmark.d.ts.map

package/dist/commands/benchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.d.ts","sourceRoot":"","sources":["../../src/commands/benchmark.ts"],"names":[],"mappings":"AAIA,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzF"}

package/dist/commands/benchmark.js

@@ -0,0 +1,6 @@
+export async function benchmark(genomeId, options) {
+    console.log('Benchmark command - coming soon');
+    console.log('Genome ID:', genomeId);
+    console.log('Options:', options);
+}
+//# sourceMappingURL=benchmark.js.map

package/dist/commands/benchmark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.js","sourceRoot":"","sources":["../../src/commands/benchmark.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAA4B,EAAE,OAAY;IACtE,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/commands/chat.d.ts

@@ -0,0 +1,6 @@
+interface ChatOptions {
+    user?: string;
+}
+export declare function chat(genomeId: string | undefined, options: ChatOptions): Promise<void>;
+export {};
+//# sourceMappingURL=chat.d.ts.map

package/dist/commands/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AAUA,UAAU,WAAW;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA8E5F"}

package/dist/commands/chat.js

@@ -0,0 +1,67 @@
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import ora from 'ora';
+export async function chat(genomeId, options) {
+    console.log(chalk.bold('\n💬 Interactive Chat Session\n'));
+    if (!genomeId) {
+        const answers = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'genomeId',
+                message: 'Enter genome ID:',
+                validate: (input) => {
+                    if (!input.trim()) {
+                        return 'Genome ID is required';
+                    }
+                    return true;
+                },
+            },
+        ]);
+        genomeId = answers.genomeId;
+    }
+    const userId = options.user || 'cli-user';
+    console.log(chalk.gray(`Genome: ${genomeId}`));
+    console.log(chalk.gray(`User: ${userId}`));
+    console.log(chalk.gray('Type "exit" or "quit" to end the session\n'));
+    while (true) {
+        const { message } = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'message',
+                message: chalk.cyan('You:'),
+                validate: (input) => {
+                    if (!input.trim()) {
+                        return 'Message cannot be empty';
+                    }
+                    return true;
+                },
+            },
+        ]);
+        if (message.toLowerCase() === 'exit' || message.toLowerCase() === 'quit') {
+            console.log(chalk.yellow('\nEnding chat session. Goodbye!\n'));
+            break;
+        }
+        const spinner = ora('Thinking...').start();
+        try {
+            await new Promise((resolve) => setTimeout(resolve, 1000));
+            spinner.stop();
+            const response = `[This is a placeholder response. Connect to GSEP instance to get real responses]
+
+Your message: "${message}"
+
+To connect this CLI to a live GSEP instance:
+1. Initialize a GSEP instance in your application
+2. Expose it via API or IPC
+3. Configure the CLI to connect to it
+
+For now, this command demonstrates the interactive chat interface.`;
+            console.log(chalk.green('AI:'), chalk.white(response));
+            console.log();
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Failed to get response'));
+            console.error(error);
+        }
+    }
+}
+//# sourceMappingURL=chat.js.map

package/dist/commands/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,GAAG,MAAM,KAAK,CAAC;AAMtB,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,QAA4B,EAAE,OAAoB;IACzE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC,CAAC;IAG3D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;YAClC;gBACI,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,kBAAkB;gBAC3B,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;oBACxB,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;wBAChB,OAAO,uBAAuB,CAAC;oBACnC,CAAC;oBACD,OAAO,IAAI,CAAC;gBAChB,CAAC;aACJ;SACJ,CAAC,CAAC;QAEH,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAChC,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC;IAE1C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC,CAAC;IAGtE,OAAO,IAAI,EAAE,CAAC;QACV,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;YACtC;gBACI,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;gBAC3B,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;oBACxB,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;wBAChB,OAAO,yBAAyB,CAAC;oBACrC,CAAC;oBACD,OAAO,IAAI,CAAC;gBAChB,CAAC;aACJ;SACJ,CAAC,CAAC;QAGH,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,mCAAmC,CAAC,CAAC,CAAC;YAC/D,MAAM;QACV,CAAC;QAGD,MAAM,OAAO,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,CAAC;QAE3C,IAAI,CAAC;YAGD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;YAE1D,OAAO,CAAC,IAAI,EAAE,CAAC;YAEf,MAAM,QAAQ,GAAG;;iBAEZ,OAAO;;;;;;;mEAO2C,CAAC;YAExD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YACvD,OAAO,CAAC,GAAG,EAAE,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC;YAClD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/commands/config.d.ts

@@ -0,0 +1,2 @@
+export declare function config(options: any): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAIA,wBAAsB,MAAM,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxD"}

package/dist/commands/config.js

@@ -0,0 +1,5 @@
+export async function config(options) {
+    console.log('Config command - coming soon');
+    console.log('Options:', options);
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAY;IACrC,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/commands/create.d.ts

@@ -0,0 +1,2 @@
+export declare function create(options: any): Promise<void>;
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAIA,wBAAsB,MAAM,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxD"}

package/dist/commands/create.js

@@ -0,0 +1,5 @@
+export async function create(options) {
+    console.log('Create genome command - coming soon');
+    console.log('Options:', options);
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAY;IACrC,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,4 @@
+export declare function doctor(_options: {
+    fix?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAmBA,wBAAsB,MAAM,CAAC,QAAQ,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8DvE"}