ralph-starter 0.0.1 → 0.1.1-beta.0

package/dist/commands/auth.js

@@ -0,0 +1,243 @@
+import crypto from 'node:crypto';
+import chalk from 'chalk';
+import ora from 'ora';
+import { getRandomPort, openBrowser } from '../auth/browser.js';
+import { getCallbackUrl, startOAuthServer } from '../auth/oauth-server.js';
+import { generatePKCE } from '../auth/pkce.js';
+import { getProvider, getProviderNames } from '../auth/providers/index.js';
+import { deleteSourceCredential, getSourceCredentials, getSourcesConfigPath, setSourceCredential, } from '../sources/config.js';
+/**
+ * Auth command - Browser-based OAuth authentication for integrations
+ *
+ * Usage:
+ *   ralph-starter auth <service>    Start OAuth flow for a service
+ *   ralph-starter auth --list       Show auth status for all services
+ *   ralph-starter auth --logout <service>  Remove credentials for a service
+ */
+export async function authCommand(service, options) {
+    // Handle --list
+    if (options.list) {
+        await showAuthStatus();
+        return;
+    }
+    // Handle --logout
+    if (options.logout) {
+        await logoutService(options.logout);
+        return;
+    }
+    // No service specified - show help
+    if (!service) {
+        showAuthHelp();
+        return;
+    }
+    // Start OAuth flow for the service
+    await startOAuthFlow(service);
+}
+/**
+ * Show authentication status for all services
+ */
+async function showAuthStatus() {
+    console.log(chalk.bold('\nAuthentication Status'));
+    console.log(chalk.dim(`Credentials stored in: ${getSourcesConfigPath()}\n`));
+    const providers = getProviderNames();
+    for (const name of providers) {
+        const provider = getProvider(name);
+        if (!provider)
+            continue;
+        const credentials = getSourceCredentials(name);
+        const hasToken = credentials?.token || credentials?.apiKey;
+        const isConfigured = checkProviderConfigured(provider);
+        const authMethod = provider.supportsPKCE ? 'Browser OAuth (PKCE)' : 'Manual API key';
+        if (hasToken) {
+            console.log(`  ${chalk.green('✓')} ${chalk.bold(provider.displayName)} - Authenticated`);
+        }
+        else if (isConfigured && provider.supportsPKCE) {
+            // PKCE provider with client_id configured - ready for browser auth
+            console.log(`  ${chalk.yellow('○')} ${chalk.bold(provider.displayName)} - ${authMethod}`);
+            console.log(chalk.dim(`      Run: ralph-starter auth ${name}`));
+        }
+        else if (provider.supportsPKCE && !isConfigured) {
+            // PKCE provider but no client_id - needs env var
+            console.log(`  ${chalk.dim('○')} ${chalk.bold(provider.displayName)} - ${authMethod} (not configured)`);
+            console.log(chalk.dim(`      Set RALPH_${name.toUpperCase()}_CLIENT_ID env var`));
+        }
+        else {
+            // Non-PKCE provider - manual API key only
+            console.log(`  ${chalk.dim('○')} ${chalk.bold(provider.displayName)} - ${authMethod}`);
+            console.log(chalk.dim(`      Run: ralph-starter config set ${name}.apiKey <your-key>`));
+            console.log(chalk.dim(`      Get key: ${getApiKeyUrl(name)}`));
+        }
+    }
+    console.log();
+}
+/**
+ * Logout from a service (remove credentials)
+ */
+async function logoutService(service) {
+    const provider = getProvider(service);
+    if (!provider) {
+        console.error(chalk.red(`Unknown service: ${service}`));
+        console.error(chalk.dim(`\nAvailable services: ${getProviderNames().join(', ')}`));
+        process.exit(1);
+    }
+    // Delete token and apiKey
+    const deletedToken = deleteSourceCredential(service, 'token');
+    const deletedApiKey = deleteSourceCredential(service, 'apiKey');
+    if (deletedToken || deletedApiKey) {
+        console.log(chalk.green(`✓ Logged out from ${provider.displayName}`));
+    }
+    else {
+        console.log(chalk.yellow(`No credentials found for ${provider.displayName}`));
+    }
+}
+/**
+ * Start the OAuth flow for a service
+ */
+async function startOAuthFlow(service) {
+    const provider = getProvider(service);
+    if (!provider) {
+        console.error(chalk.red(`Unknown service: ${service}`));
+        console.error(chalk.dim(`\nAvailable services: ${getProviderNames().join(', ')}`));
+        process.exit(1);
+    }
+    // Check if this provider supports browser OAuth
+    if (!provider.supportsPKCE) {
+        console.log(chalk.yellow(`\n${provider.displayName} doesn't support browser OAuth.`));
+        console.log(chalk.dim('\nUse manual API key configuration instead:'));
+        console.log(chalk.cyan(`  ralph-starter config set ${service}.apiKey <your-api-key>`));
+        console.log(chalk.dim(`\nGet your API key from: ${getApiKeyUrl(service)}`));
+        return;
+    }
+    // Check if OAuth is configured for this provider
+    if (!checkProviderConfigured(provider)) {
+        console.error(chalk.red(`OAuth not configured for ${provider.displayName}`));
+        console.error(chalk.dim('\nTo enable browser OAuth, set this environment variable:'));
+        console.error(chalk.cyan(`  RALPH_${service.toUpperCase()}_CLIENT_ID=<your-client-id>`));
+        console.error(chalk.dim('\nOr use manual API key configuration:'));
+        console.error(chalk.cyan(`  ralph-starter config set ${service}.apiKey <your-api-key>`));
+        console.error(chalk.dim(`\nGet API keys from: ${getApiKeyUrl(service)}`));
+        process.exit(1);
+    }
+    console.log();
+    console.log(chalk.bold(`Authenticating with ${provider.displayName}...`));
+    // Get a random port for the callback server
+    const port = getRandomPort();
+    const redirectUri = getCallbackUrl(port);
+    // Generate state for CSRF protection
+    const state = crypto.randomBytes(16).toString('hex');
+    // Generate PKCE challenge
+    const pkce = generatePKCE();
+    // Build authorization URL with PKCE
+    const authUrl = provider.buildAuthUrl(redirectUri, state, pkce.challenge);
+    console.log(chalk.dim(`Opening browser for authorization...`));
+    console.log(chalk.dim(`Using PKCE for secure authentication`));
+    console.log();
+    // Start the callback server
+    const serverPromise = startOAuthServer({
+        port,
+        timeoutMs: 5 * 60 * 1000, // 5 minutes
+    });
+    // Open browser to authorization URL
+    try {
+        await openBrowser(authUrl);
+    }
+    catch (_error) {
+        console.log(chalk.yellow('Could not open browser automatically.'));
+        console.log(chalk.dim('Please open this URL manually:'));
+        console.log();
+        console.log(chalk.cyan(authUrl));
+        console.log();
+    }
+    // Wait for callback
+    const spinner = ora('Waiting for authorization...').start();
+    try {
+        const result = await serverPromise;
+        // Verify state
+        if (result.state !== state) {
+            spinner.fail('State mismatch - possible CSRF attack');
+            process.exit(1);
+        }
+        spinner.text = 'Exchanging code for token...';
+        // Exchange code for token with PKCE verifier
+        const tokens = await provider.exchangeCode(result.code, redirectUri, pkce.verifier);
+        // Save the token
+        setSourceCredential(service, 'token', tokens.accessToken);
+        if (tokens.refreshToken) {
+            setSourceCredential(service, 'refreshToken', tokens.refreshToken);
+        }
+        spinner.succeed(chalk.green(`Successfully authenticated with ${provider.displayName}!`));
+        console.log();
+        console.log(chalk.dim('You can now use this integration:'));
+        console.log(chalk.cyan(`  ralph-starter run --from ${service} --project <id>`));
+        console.log();
+    }
+    catch (error) {
+        spinner.fail(chalk.red('Authentication failed'));
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        console.error(chalk.dim(errorMessage));
+        process.exit(1);
+    }
+}
+/**
+ * Check if a provider has OAuth configured
+ */
+function checkProviderConfigured(provider) {
+    const p = provider;
+    return p.isConfigured?.() ?? !!(provider.clientId && provider.clientSecret);
+}
+/**
+ * Get the URL where users can get API keys for a service
+ */
+function getApiKeyUrl(service) {
+    const urls = {
+        notion: 'https://www.notion.so/my-integrations',
+        linear: 'https://linear.app/settings/api',
+        todoist: 'https://todoist.com/prefs/integrations',
+        github: 'https://github.com/settings/tokens',
+    };
+    return urls[service] || "the service's developer settings";
+}
+/**
+ * Show auth command help
+ */
+function showAuthHelp() {
+    console.log(`
+${chalk.bold('ralph-starter auth')} - Authentication for integrations
+
+${chalk.bold('Usage:')}
+  ralph-starter auth <service>         Start OAuth flow (for supported services)
+  ralph-starter auth --list            Show authentication status
+  ralph-starter auth --logout <service> Remove credentials for a service
+
+${chalk.bold('Services:')}
+  ${chalk.green('linear')}   - Browser OAuth (PKCE) - just run: ralph-starter auth linear
+  ${chalk.yellow('notion')}   - Manual API key required
+  ${chalk.yellow('todoist')}  - Manual API key required
+
+${chalk.bold('Examples:')}
+  ${chalk.dim('# Linear - browser OAuth (seamless!)')}
+  ralph-starter auth linear
+
+  ${chalk.dim('# Notion/Todoist - manual API key')}
+  ralph-starter config set notion.apiKey <your-key>
+  ralph-starter config set todoist.apiKey <your-key>
+
+  ${chalk.dim('# Check status')}
+  ralph-starter auth --list
+
+${chalk.bold('Browser OAuth Setup (Linear):')}
+  Linear supports PKCE, so you just need a client ID:
+  RALPH_LINEAR_CLIENT_ID=<client-id>
+
+  Get it from: https://linear.app/settings/api/applications
+
+${chalk.bold('Manual API Keys (Notion, Todoist):')}
+  These services require manual API key configuration:
+
+  ${chalk.dim('Notion:')}  https://www.notion.so/my-integrations
+  ${chalk.dim('Todoist:')} https://todoist.com/prefs/integrations
+
+  Then run: ralph-starter config set <service>.apiKey <key>
+`);
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

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

package/dist/commands/check.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Check command for ralph-starter
+ * Verifies configuration and tests LLM connection
+ */
+export interface CheckCommandOptions {
+    verbose?: boolean;
+}
+/**
+ * Run the check command
+ */
+export declare function checkCommand(options: CheckCommandOptions): Promise<void>;
+//# sourceMappingURL=check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAYD;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+G9E"}

package/dist/commands/check.js

@@ -0,0 +1,124 @@
+/**
+ * Check command for ralph-starter
+ * Verifies configuration and tests LLM connection
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { getConfiguredLLM, readConfig } from '../config/manager.js';
+import { PROVIDERS } from '../llm/index.js';
+import { isClaudeCodeAvailable, testClaudeCodeConnection } from '../setup/agent-detector.js';
+import { testApiConnection } from '../setup/llm-tester.js';
+/**
+ * Mask an API key for display
+ */
+function maskKey(key) {
+    if (key.length <= 8) {
+        return '*'.repeat(key.length);
+    }
+    return key.slice(0, 4) + '*'.repeat(key.length - 8) + key.slice(-4);
+}
+/**
+ * Run the check command
+ */
+export async function checkCommand(options) {
+    console.log();
+    console.log(chalk.bold('Checking ralph-starter configuration...'));
+    console.log();
+    const _config = readConfig();
+    let hasLLM = false;
+    let usesClaudeCode = false;
+    // Step 1: Check for Claude Code CLI (highest priority)
+    console.log(chalk.dim('  Detecting LLM...'));
+    const claudeCheck = await isClaudeCodeAvailable();
+    if (claudeCheck.available) {
+        const version = claudeCheck.version ? `v${claudeCheck.version}` : '';
+        console.log(chalk.green(`  ✓ Claude Code CLI found ${version}`));
+        if (options.verbose && claudeCheck.executablePath) {
+            console.log(chalk.dim(`    Path: ${claudeCheck.executablePath}`));
+        }
+        hasLLM = true;
+        usesClaudeCode = true;
+    }
+    else {
+        console.log(chalk.dim('  ✗ Claude Code CLI not found'));
+    }
+    // Step 2: Check for API key configuration
+    const llmConfig = getConfiguredLLM();
+    if (llmConfig) {
+        const providerName = PROVIDERS[llmConfig.provider].displayName;
+        // Determine source of key
+        const envVar = PROVIDERS[llmConfig.provider].envVar;
+        const fromEnv = process.env[envVar] === llmConfig.apiKey;
+        const source = fromEnv ? 'environment' : 'config file';
+        console.log(chalk.green(`  ✓ API Key configured (${providerName})`));
+        console.log(chalk.dim(`    Key: ${maskKey(llmConfig.apiKey)} (from ${source})`));
+        hasLLM = true;
+    }
+    else if (!usesClaudeCode) {
+        console.log(chalk.yellow('  ✗ No API key configured'));
+    }
+    // Step 3: Test connection
+    if (!hasLLM) {
+        console.log();
+        console.log(chalk.red('  No LLM available!'));
+        console.log();
+        console.log(chalk.bold('  To get started, either:'));
+        console.log(chalk.dim('    1. Install Claude Code: https://claude.ai/code'));
+        console.log(chalk.dim('    2. Run setup wizard: ralph-starter setup'));
+        console.log(chalk.dim('    3. Set API key: export ANTHROPIC_API_KEY=your-key'));
+        console.log();
+        process.exit(1);
+    }
+    console.log();
+    const spinner = ora('Testing connection...').start();
+    let testResult;
+    if (usesClaudeCode) {
+        // Test Claude Code connection
+        const result = await testClaudeCodeConnection();
+        testResult = {
+            success: result.success,
+            responseTime: result.responseTime,
+            error: result.error,
+            provider: 'Claude Code CLI',
+        };
+    }
+    else if (llmConfig) {
+        // Test API connection
+        const result = await testApiConnection(llmConfig.provider, llmConfig.apiKey);
+        testResult = {
+            success: result.success,
+            responseTime: result.responseTime,
+            error: result.error,
+            provider: PROVIDERS[llmConfig.provider].displayName,
+        };
+    }
+    if (testResult?.success) {
+        const time = testResult.responseTime ? ` (${testResult.responseTime}ms)` : '';
+        spinner.succeed(`Response received${time}`);
+    }
+    else {
+        spinner.fail(`Connection failed: ${testResult?.error || 'Unknown error'}`);
+        console.log();
+        console.log(chalk.yellow('  The connection test failed. This could mean:'));
+        console.log(chalk.dim('    • API key is invalid or expired'));
+        console.log(chalk.dim('    • Network connectivity issues'));
+        console.log(chalk.dim('    • Claude Code is not authenticated'));
+        console.log();
+        console.log(chalk.dim('  Try running: ralph-starter setup'));
+        console.log();
+        process.exit(1);
+    }
+    // Summary
+    console.log();
+    console.log(`${chalk.green.bold('  All checks passed!')} You're ready to go.`);
+    console.log();
+    const usingProvider = usesClaudeCode
+        ? 'Claude Code CLI (no API key needed)'
+        : llmConfig?.provider
+            ? `${PROVIDERS[llmConfig.provider].displayName} API`
+            : 'Unknown provider';
+    console.log(chalk.dim(`  Using: ${usingProvider}`));
+    console.log(chalk.dim("  Run 'ralph-starter' to launch the wizard."));
+    console.log();
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

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

package/dist/commands/config.d.ts

@@ -0,0 +1,13 @@
+export type ConfigCommandOptions = {};
+/**
+ * Config command - manage source credentials and settings
+ *
+ * Usage:
+ *   ralph-starter config list                    - List all configured sources
+ *   ralph-starter config get <source>            - Show config for a source
+ *   ralph-starter config set <source>.<key> <value> - Set a config value
+ *   ralph-starter config delete <source>.<key>  - Delete a config value
+ *   ralph-starter config delete <source>        - Delete all config for a source
+ */
+export declare function configCommand(action: string, args: string[], _options?: ConfigCommandOptions): 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":"AAoBA,MAAM,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEtC;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAmEf"}