@closedloop-ai/cli 0.2.0

package/src/api/auth.ts

@@ -0,0 +1,21 @@
+import axios from 'axios';
+import { CONFIG } from '../config/constants';
+import { CliError, handleApiError, ERROR_CODES } from '../utils/errors';
+
+export async function validateApiKey(apiKey: string): Promise<boolean> {
+  try {
+    const response = await axios.get(`${CONFIG.API_BASE_URL}/health`, {
+      headers: {
+        'Authorization': `Bearer ${apiKey}`
+      },
+      timeout: CONFIG.TIMEOUT_MS
+    });
+    
+    return response.status === 200;
+  } catch (error: any) {
+    if (error.response?.status === 401) {
+      return false;
+    }
+    throw handleApiError(error);
+  }
+}

package/src/api/feedback.ts

@@ -0,0 +1,64 @@
+import axios from 'axios';
+import { config } from '../config';
+import { FeedbackData, ListResponse, CommandOptions, InputData } from '../types';
+import { CONFIG, MESSAGES } from '../config/constants';
+import { CliError, handleApiError, ERROR_CODES } from '../utils/errors';
+
+const getClient = () => {
+  const apiKey = config.get('apiKey');
+
+  if (!apiKey) {
+    throw new CliError(MESSAGES.NO_API_KEY, ERROR_CODES.NO_API_KEY);
+  }
+
+  return axios.create({
+    baseURL: CONFIG.API_BASE_URL,
+    headers: {
+      'Authorization': `Bearer ${apiKey}`,
+      'Content-Type': 'application/json',
+      'User-Agent': CONFIG.USER_AGENT
+    },
+    timeout: CONFIG.TIMEOUT_MS
+  });
+};
+
+export async function submitFeedback(data: Partial<InputData>): Promise<{ id: string }> {
+  try {
+    const client = getClient();
+    const response = await client.post('/feedbacks', data);
+    return response.data.data;
+  } catch (error) {
+    throw handleApiError(error);
+  }
+}
+
+export async function listFeedbacks(params: CommandOptions, isNew = false): Promise<ListResponse<FeedbackData>> {
+  try {
+    const client = getClient();
+    const endpoint = isNew ? '/feedbacks/new' : '/feedbacks';
+    const response = await client.get(endpoint, { params });
+    return response.data.data;
+  } catch (error) {
+    throw handleApiError(error);
+  }
+}
+
+export async function getFeedbackStatus(id: string): Promise<FeedbackData> {
+  try {
+    const client = getClient();
+    const response = await client.get(`/feedbacks/new/${id}`);
+    return response.data.data;
+  } catch (error) {
+    throw handleApiError(error);
+  }
+}
+
+export async function getFeedbackDetail(id: string): Promise<FeedbackData> {
+  try {
+    const client = getClient();
+    const response = await client.get(`/feedbacks/${id}`);
+    return response.data.data;
+  } catch (error) {
+    throw handleApiError(error);
+  }
+}

package/src/api/input.ts

@@ -0,0 +1,55 @@
+import axios from 'axios';
+import { config } from '../config';
+import { InputData, ListResponse, CommandOptions } from '../types';
+import { CONFIG, MESSAGES } from '../config/constants';
+import { CliError, handleApiError, ERROR_CODES } from '../utils/errors';
+
+const getClient = () => {
+  const apiKey = config.get('apiKey');
+
+  if (!apiKey) {
+    throw new CliError(MESSAGES.NO_API_KEY, ERROR_CODES.NO_API_KEY);
+  }
+
+  return axios.create({
+    baseURL: CONFIG.API_BASE_URL,
+    headers: {
+      'Authorization': `Bearer ${apiKey}`,
+      'Content-Type': 'application/json',
+      'User-Agent': CONFIG.USER_AGENT
+    },
+    timeout: CONFIG.TIMEOUT_MS
+  });
+};
+
+export async function listInputs(page: number = 1, limit: number = 20): Promise<ListResponse<InputData>> {
+  try {
+    const client = getClient();
+    const response = await client.get('/inputs', { 
+      params: { page, limit } 
+    });
+    return response.data.data;
+  } catch (error) {
+    throw handleApiError(error);
+  }
+}
+
+export async function getInputDetail(id: string): Promise<InputData> {
+  try {
+    const client = getClient();
+    const response = await client.get(`/inputs/${id}`);
+    return response.data.data;
+  } catch (error) {
+    throw handleApiError(error);
+  }
+}
+
+export async function getInputStatus(id: string): Promise<InputData> {
+  try {
+    const client = getClient();
+    const response = await client.get(`/inputs/${id}`);
+    return response.data.data;
+  } catch (error) {
+    throw handleApiError(error);
+  }
+}

package/src/api/usage.ts

@@ -0,0 +1,45 @@
+import axios from 'axios';
+import { config } from '../config';
+import { UsageData, ListResponse } from '../types';
+import { CONFIG, MESSAGES } from '../config/constants';
+import { CliError, handleApiError, ERROR_CODES } from '../utils/errors';
+
+const getClient = () => {
+  const apiKey = config.get('apiKey');
+
+  if (!apiKey) {
+    throw new CliError(MESSAGES.NO_API_KEY, ERROR_CODES.NO_API_KEY);
+  }
+
+  return axios.create({
+    baseURL: CONFIG.API_BASE_URL,
+    headers: {
+      'Authorization': `Bearer ${apiKey}`,
+      'Content-Type': 'application/json',
+      'User-Agent': CONFIG.USER_AGENT
+    },
+    timeout: CONFIG.TIMEOUT_MS
+  });
+};
+
+export async function listUsage(page: number = 1, limit: number = 20): Promise<ListResponse<UsageData>> {
+  try {
+    const client = getClient();
+    const response = await client.get('/usage', { 
+      params: { page, limit } 
+    });
+    return response.data.data;
+  } catch (error) {
+    throw handleApiError(error);
+  }
+}
+
+export async function getUsageDetail(id: string): Promise<UsageData> {
+  try {
+    const client = getClient();
+    const response = await client.get(`/usage/${id}`);
+    return response.data.data;
+  } catch (error) {
+    throw handleApiError(error);
+  }
+}

package/src/cli.ts

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { handleInputCommand } from './commands/input';
+import { handleFeedbackCommand } from './commands/feedback';
+import { configCommand } from './commands/config';
+import { CliError, handleApiError } from './utils/errors';
+import { CommandOptions } from './types';
+
+// Create the main program
+const program = new Command();
+
+program
+  .name('cl')
+  .description('ClosedLoop AI CLI - AI-powered customer feedback analysis for product management')
+  .version('0.2.0')
+  .addHelpText('before', chalk.blue(`
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                        ClosedLoop AI CLI v0.2.0                            ║
+║                    AI-Powered Customer Feedback Analysis                     ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+`))
+  .addHelpText('after', chalk.black(`
+Commands:
+  input [content]              Submit customer input for AI analysis
+  input                        List all customer inputs
+  input <id>                   Show specific input details
+
+  feedback                     List AI-generated feedback
+  feedback <id>                Show specific feedback details
+
+  config                       Show current configuration
+  config set --api-key <key>   Set API key
+
+  version                      Show version information
+  help [command]               Show help for a command
+
+Examples:
+  $ cl input "Dashboard is confusing"
+  $ cl input
+  $ cl input 74e3dd87-878f-41cf-8e5a-87527bbf7770
+  $ cl feedback
+  $ cl feedback 2ea8f556-052b-4f5c-bf86-833780b3d00d
+  $ cl config set --api-key your-api-key-here
+
+Pagination:
+  $ cl input --page 2 --limit 10
+  $ cl feedback --page 2
+
+Get API keys for free at https://closedloop.sh
+`));
+
+// Add input command
+program
+  .command('input [content]')
+  .description('Submit customer input for AI analysis or list inputs')
+  .option('-t, --title <title>', 'Title for this input')
+  .option('-u, --url <url>', 'Source URL (support ticket, survey, etc.)')
+  .option('-c, --customer <id>', 'Customer identifier')
+  .option('-n, --name <name>', 'Name of person who provided the input')
+  .option('-e, --email <email>', 'Email of person who provided the input')
+  .option('--interactive', 'Fill in details step by step')
+  .option('-w, --wait', 'Wait until processing is completed')
+  .option('--json', 'Output in JSON format')
+  .option('--page <number>', 'Page number for list', '1')
+  .option('--limit <number>', 'Items per page for list', '20')
+  .option('--status <status>', 'Filter by status (processing, completed, failed)')
+  .option('--search <query>', 'Search in input content')
+  .action(async (content, options: CommandOptions) => {
+    try {
+      await handleInputCommand(content, options);
+    } catch (error: any) {
+      handleError(error, options);
+    }
+  });
+
+// Add feedback command
+program
+  .command('feedback [id]')
+  .description('List AI-generated feedback or show specific feedback details')
+  .option('--json', 'Output in JSON format')
+  .option('--page <number>', 'Page number for list', '1')
+  .option('--limit <number>', 'Items per page for list', '20')
+  .option('--search <query>', 'Search feedback by content')
+  .action(async (id, options: CommandOptions) => {
+    try {
+      await handleFeedbackCommand(id, options);
+    } catch (error: any) {
+      handleError(error, options);
+    }
+  });
+
+// Add config command
+program.addCommand(configCommand);
+
+// Add version command
+program
+  .command('version')
+  .description('Show version information')
+  .action(() => {
+    console.log(chalk.blue('ClosedLoop AI CLI v0.2.0'));
+    console.log(chalk.gray('AI-Powered Customer Feedback Analysis'));
+    console.log(chalk.gray('Get started: https://closedloop.sh'));
+  });
+
+// Add help command
+program
+  .command('help [command]')
+  .description('Show help for a command')
+  .action((command) => {
+    if (command) {
+      program.outputHelp();
+    } else {
+      program.outputHelp();
+    }
+  });
+
+// Error handling function
+function handleError(error: any, options: CommandOptions) {
+  if (options.json) {
+    console.log(JSON.stringify({
+      success: false,
+      error: error.message,
+      code: error.code || 'UNKNOWN_ERROR',
+      details: error.response?.data || 'Unknown error occurred'
+    }, null, 2));
+  } else {
+    if (error instanceof CliError) {
+      console.error(chalk.red('❌ Error:'), error.message);
+      if (error.code === 'NO_API_KEY') {
+        console.log(chalk.black('\n💡 To fix:'));
+        console.log(chalk.black('   1. Get your free API key at: https://closedloop.sh'));
+        console.log(chalk.black('   2. Run: cl config set --api-key <your-key>'));
+      }
+    } else {
+      const cliError = handleApiError(error);
+      console.error(chalk.red('❌ Error:'), cliError.message);
+      console.log(chalk.black('\n💡 Get help: cl --help'));
+    }
+  }
+  process.exit(error.exitCode || 1);
+}
+
+// Handle unknown commands
+program.on('command:*', (operands) => {
+  console.error(chalk.red(`Unknown command: ${operands[0]}`));
+  console.log(chalk.gray('Run "cl --help" to see available commands'));
+  process.exit(1);
+});
+
+// Parse command line arguments
+program.parse();
+
+// If no command provided, show help
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}

package/src/commands/config.ts

@@ -0,0 +1,192 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { config } from '../config';
+import { validateApiKey } from '../api/auth';
+import { CommandOptions } from '../types';
+import { CONFIG, MESSAGES, URLS } from '../config/constants';
+import { validateApiKey as validateApiKeyFormat } from '../utils/validation';
+
+// Create config command
+export const configCommand = new Command('config')
+  .description('Configure your API key and settings')
+  .option('--set-api-key <key>', 'Set your API key')
+  .option('--set-team <team>', 'Set your team (future feature)')
+  .option('--json', 'Output in JSON format')
+  .action(async (options: CommandOptions) => {
+    try {
+      await handleConfig(options);
+    } catch (error: any) {
+      handleError(error, options);
+    }
+  });
+
+// Create config subcommands
+const configSetCommand = new Command('set')
+  .description('Set configuration values')
+  .option('--api-key <key>', 'Set API key')
+  .option('--team <team>', 'Set team (future feature)')
+  .action(async (options: CommandOptions) => {
+    try {
+      await handleConfigSet(options);
+    } catch (error: any) {
+      handleError(error, options);
+    }
+  });
+
+const configShowCommand = new Command('show')
+  .description('Show current configuration')
+  .option('--json', 'Output in JSON format')
+  .action(async (options: CommandOptions) => {
+    try {
+      await handleConfigShow(options);
+    } catch (error: any) {
+      handleError(error, options);
+    }
+  });
+
+// Add subcommands to main config command
+configCommand.addCommand(configSetCommand);
+configCommand.addCommand(configShowCommand);
+
+// Helper functions
+async function handleConfig(options: CommandOptions) {
+  const currentConfig = config.get();
+
+  if (options.setApiKey) {
+    await setApiKey(options.setApiKey, options);
+    return;
+  }
+
+  if (options.setTeam) {
+    console.log(chalk.yellow('⚠️  Team configuration is not yet implemented'));
+    console.log(chalk.black('This feature will be available in a future update.'));
+    return;
+  }
+
+  // Show current config
+  await showConfig(currentConfig, options);
+}
+
+async function handleConfigSet(options: CommandOptions) {
+  if (options.apiKey) {
+    await setApiKey(options.apiKey, options);
+  } else if (options.team) {
+    console.log(chalk.yellow('⚠️  Team configuration is not yet implemented'));
+    console.log(chalk.black('This feature will be available in a future update.'));
+  } else {
+    console.log(chalk.red('❌ No configuration option specified'));
+    console.log(chalk.black('Use --api-key or --team to set values'));
+    process.exit(1);
+  }
+}
+
+async function handleConfigShow(options: CommandOptions) {
+  const currentConfig = config.get();
+  await showConfig(currentConfig, options);
+}
+
+async function setApiKey(apiKey: string, options: CommandOptions) {
+  try {
+    // Validate API key format
+    const validatedApiKey = validateApiKeyFormat(apiKey);
+    
+    // Validate API key by making a test request
+    const spinner = ora('Validating API key...').start();
+    
+    try {
+      await validateApiKey(validatedApiKey);
+      spinner.succeed('API key validated successfully!');
+      
+      // Save the API key
+      config.set('apiKey', validatedApiKey);
+      
+      if (options.json) {
+        console.log(JSON.stringify({
+          success: true,
+          message: 'API key set successfully',
+          data: {
+            apiKey: validatedApiKey.substring(0, 8) + '...',
+            configFile: config.getConfigPath(),
+            configured: true
+          }
+        }, null, 2));
+      } else {
+        console.log(chalk.green('✅ API key set successfully!'));
+        console.log(chalk.black(`Config file: ${config.getConfigPath()}`));
+      }
+    } catch (error: any) {
+      spinner.fail('API key validation failed');
+      
+      if (error.response?.status === 401) {
+        console.error(chalk.red('❌ Invalid API key'));
+        console.log(chalk.black('\n💡 To get a valid API key:'));
+        console.log(chalk.black('   1. Visit: https://closedloop.sh'));
+        console.log(chalk.black('   2. Sign up or log in'));
+        console.log(chalk.black('   3. Generate an API key'));
+        console.log(chalk.black('   4. Run: cl config set-api-key <your-key>'));
+      } else {
+        console.error(chalk.red('❌ Validation Error:'), error.message);
+        console.log(chalk.black('\n💡 Check your internet connection and try again'));
+      }
+      process.exit(1);
+    }
+  } catch (error: any) {
+    console.error(chalk.red('❌ Invalid API key. Get your free API key at https://closedloop.sh'));
+    process.exit(1);
+  }
+}
+
+async function showConfig(currentConfig: any, options: CommandOptions) {
+  if (options.json) {
+    console.log(JSON.stringify({
+      success: true,
+      data: {
+        apiKey: currentConfig.apiKey ? currentConfig.apiKey.substring(0, 8) + '...' : null,
+        configFile: config.getConfigPath(),
+        configured: !!currentConfig.apiKey
+      }
+    }, null, 2));
+    return;
+  }
+
+  console.log(chalk.blue('\n⚙️  Configuration:'));
+  console.log(chalk.black('─'.repeat(40)));
+  
+  if (currentConfig.apiKey) {
+    console.log(chalk.blue('API Key:'), chalk.green('✓ Configured'));
+  } else {
+    console.log(chalk.blue('API Key:'), chalk.red('✗ Not configured'));
+    console.log(chalk.black('Run: cl config set-api-key <your-key>'));
+  }
+  
+  console.log(chalk.blue('Config File:'), config.getConfigPath());
+  
+  if (!currentConfig.apiKey) {
+    console.log(chalk.yellow('\n💡 Get started:'));
+    console.log(chalk.black('   1. Get your free API key at: https://closedloop.sh'));
+    console.log(chalk.black('   2. Run: cl config set-api-key <your-key>'));
+    console.log(chalk.black('   3. Submit your first input: cl input "Your feedback here"'));
+  }
+}
+
+function handleError(error: any, options: CommandOptions) {
+  if (options.json) {
+    console.log(JSON.stringify({
+      success: false,
+      error: error.message,
+      details: error.response?.data || 'Unknown error occurred'
+    }, null, 2));
+  } else {
+    if (error.code === 'ENOTFOUND' || error.code === 'ECONNREFUSED') {
+      console.error(chalk.red('❌ Connection Error:'), 'Cannot connect to ClosedLoop AI servers');
+      console.log(chalk.black('\n💡 Check your internet connection and try again'));
+    } else {
+      console.error(chalk.red('❌ Error:'), error.message);
+      console.log(chalk.black('\n💡 Get help: cl --help'));
+    }
+  }
+  process.exit(1);
+}
+
+export { configCommand as default };