seedfast 1.23.14

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Seedfast
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,184 @@
+# Seedfast CLI
+
+[![npm version](https://badge.fury.io/js/seedfast.svg)](https://www.npmjs.com/package/seedfast)
+[![npm downloads](https://img.shields.io/npm/dm/seedfast.svg)](https://www.npmjs.com/package/seedfast)
+
+> AI-powered PostgreSQL database seeding tool
+
+Seedfast CLI generates realistic test data for PostgreSQL databases. It connects to a backend service that uses AI to understand your database schema and create meaningful, contextually appropriate seed data.
+
+## Features
+
+- **AI-Powered Planning**: Automatically analyzes your database schema and generates an intelligent seeding plan
+- **Realistic Data**: Creates contextually appropriate test data based on table relationships and constraints
+- **Interactive UI**: Rich terminal interface with real-time progress tracking
+- **Concurrent Execution**: Multi-worker architecture for fast data generation
+- **Secure Authentication**: OAuth-style device flow with OS-level credential storage
+- **Schema-Aware**: Respects foreign keys, constraints, and relationships between tables
+
+## Installation
+
+### npm (Node.js/JavaScript projects)
+
+```bash
+# Global installation
+npm install -g seedfast
+
+# Or use with npx (no installation required)
+npx seedfast seed
+```
+
+### Homebrew (macOS and Linux)
+
+```bash
+brew install argon-it/tap/seedfast
+```
+
+### Download Binary
+
+Download the latest release for your platform from the [releases page](https://github.com/argon-it/seedfast-cli/releases/latest).
+
+### From Source
+
+Requires Go 1.25+:
+
+```bash
+git clone <repository-url>
+cd cli
+go build -o seedfast
+```
+
+## Quick Start
+
+### 1. Authenticate
+
+```bash
+seedfast login
+```
+
+Opens your browser for authentication. The CLI waits until you complete the login.
+
+### 2. Connect to Database
+
+```bash
+seedfast connect
+```
+
+Enter your PostgreSQL connection string:
+```
+postgres://user:password@localhost:5432/dbname?sslmode=disable
+```
+
+### 3. Seed Your Database
+
+```bash
+seedfast seed
+```
+
+The CLI will:
+1. Analyze your database schema
+2. Present a seeding plan for your approval
+3. Generate and insert realistic test data
+4. Show real-time progress for each table
+
+## Commands
+
+```bash
+seedfast login      # Authenticate with the backend service
+seedfast connect    # Configure database connection
+seedfast seed       # Start the seeding process
+seedfast me         # Check authentication status (formerly whoami)
+seedfast logout     # Clear stored credentials
+seedfast --version  # Show version information
+```
+
+## Configuration
+
+### Environment Variables
+
+- `SEEDFAST_DSN` - PostgreSQL connection string (overrides stored value)
+- `DATABASE_URL` - Alternative PostgreSQL connection string (fallback)
+- `SEEDFAST_VERBOSE` - Enable verbose logging (`1` to enable)
+
+### Database Connection
+
+You can configure the database connection in three ways (in order of priority):
+
+1. Environment variable `SEEDFAST_DSN`
+2. Environment variable `DATABASE_URL`
+3. Stored value from `seedfast connect` command (saved in OS keychain)
+
+## How It Works
+
+1. **Authentication**: OAuth-style device flow securely authenticates with the backend
+2. **Schema Analysis**: Backend analyzes your PostgreSQL schema (tables, relationships, constraints)
+3. **AI Planning**: AI planner determines optimal seeding strategy and generates realistic data
+4. **Execution**: CLI receives SQL tasks via gRPC and executes them locally
+5. **Progress Tracking**: Real-time UI shows progress for each table being seeded
+
+## Troubleshooting
+
+### Authentication Issues
+
+```bash
+# Check current auth status
+seedfast me
+
+# Re-authenticate
+seedfast logout
+seedfast login
+```
+
+### Database Connection Issues
+
+```bash
+# Reconfigure connection
+seedfast connect
+
+# Or set via environment variable
+export SEEDFAST_DSN="postgres://user:password@localhost:5432/dbname?sslmode=disable"
+```
+
+### Verbose Logging
+
+```bash
+export SEEDFAST_VERBOSE=1
+seedfast seed
+```
+
+## Development
+
+For local development and testing with custom backends, see [DEVELOPMENT.md](DEVELOPMENT.md).
+
+**Quick summary:**
+- Production builds: Connect to production backend only
+- Dev builds (`go build -tags dev`): Support `--backend-url` and `--grpc-url` flags for local testing
+
+## Requirements
+
+- PostgreSQL database with `app` schema
+- Active internet connection for backend communication
+- OS keychain support (macOS Keychain or Windows Credential Manager)
+
+## Platform Support
+
+- macOS (x64, ARM64)
+- Linux (x64, ARM64)
+- Windows (x64, ARM64)
+
+Note: Linux systems don't support keychain storage. Use environment variables for credentials.
+
+## Contributing
+
+This is a private repository. For contributions, please contact the maintainers.
+
+## License
+
+See [LICENSE](LICENSE) file for details.
+
+## Built With
+
+- [Cobra](https://github.com/spf13/cobra) - CLI framework
+- [pterm](https://github.com/pterm/pterm) - Terminal UI
+- [pgx](https://github.com/jackc/pgx) - PostgreSQL driver
+- [gRPC](https://grpc.io/) - RPC framework

package/index.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+const { execFileSync } = require('child_process');
+const path = require('path');
+const os = require('os');
+
+const platform = os.platform();
+const arch = os.arch();
+
+let pkg;
+if (platform === 'darwin' && arch === 'x64') pkg = 'seedfast_darwin_amd64';
+else if (platform === 'darwin' && arch === 'arm64') pkg = 'seedfast_darwin_arm64';
+else if (platform === 'linux' && arch === 'x64') pkg = 'seedfast_linux_amd64';
+else if (platform === 'linux' && arch === 'arm64') pkg = 'seedfast_linux_arm64';
+else if (platform === 'win32' && arch === 'x64') pkg = 'seedfast_windows_amd64';
+else { console.error(`Unsupported platform: ${platform}-${arch}`); process.exit(1); }
+
+const bin = path.join(__dirname, 'node_modules', pkg, platform === 'win32' ? 'seedfast.exe' : 'seedfast');
+execFileSync(bin, process.argv.slice(2), { stdio: 'inherit' });

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "seedfast",
+  "version": "1.23.14",
+  "description": "AI-powered PostgreSQL database seeding tool",
+  "keywords": ["postgresql", "database", "seeding", "testing", "ai"],
+  "bin": {
+    "seedfast": "./index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/argon-it/seedfast-cli"
+  },
+  "license": "MIT",
+  "optionalDependencies": {
+    "seedfast_darwin_amd64": "1.23.14",
+    "seedfast_darwin_arm64": "1.23.14",
+    "seedfast_linux_amd64": "1.23.14",
+    "seedfast_linux_arm64": "1.23.14",
+    "seedfast_windows_amd64": "1.23.14"
+  }
+}