@porchestra/cli 1.0.0 → 1.0.1

package/src/commands/pull.ts

@@ -1,220 +0,0 @@
-import { Command } from 'commander';
-import path from 'path';
-import pc from 'picocolors';
-import ora from 'ora';
-import { ApiClient } from '../core/api/client.js';
-import { ConfigManager } from '../core/config/config-manager.js';
-import { CodeGenerator } from '../core/generators/code-generator.js';
-import { ProjectTracker } from '../core/config/project-tracker.js';
-
-interface PullOptions {
-  project?: string;
-  agent?: string;
-  version?: string;
-  env?: 'PRODUCTION' | 'STAGING' | 'DEVELOPMENT';
-  output?: string;
-  force?: boolean;
-}
-
-export function createPullCommand(
-  configManager: ConfigManager,
-  apiClient: ApiClient,
-  codeGenerator: CodeGenerator
-): Command {
-  const projectTracker = new ProjectTracker(configManager);
-
-  return new Command('pull')
-    .description('Generate tool code for tracked agents')
-    .option('-p, --project <id>', 'Pull specific project only')
-    .option('-a, --agent <id>', 'Pull specific agent only')
-    .option('-e, --env <environment>', 'Target environment (production|staging|development)')
-    .option('-o, --output <path>', 'Override output directory')
-    .option('--force', 'Overwrite implementation files (WARNING: may lose code)')
-    .action(async (options: PullOptions) => {
-      // Check if logged in
-      const config = await configManager.get();
-      if (!config.auth?.token) {
-        console.log(pc.red('Not logged in. Run `porchestra login` first.'));
-        process.exit(1);
-      }
-
-      // Get tracked projects
-      let trackedProjects = await projectTracker.getTrackedProjects();
-
-      // Auto-trigger explore if no projects tracked
-      if (trackedProjects.length === 0) {
-        console.log(pc.yellow('\n⚠ No projects selected for tracking.\n'));
-        console.log(pc.gray('Starting project explorer...\n'));
-        
-        // Import and run explore dynamically
-        const { createExploreCommand } = await import('./explore.js');
-        const exploreCmd = createExploreCommand(configManager, apiClient);
-        // Execute the explore command to let user select projects
-        await exploreCmd.parseAsync(['node', 'script', 'explore']);
-        
-        // Re-check tracking after explore
-        trackedProjects = await projectTracker.getTrackedProjects();
-        
-        if (trackedProjects.length === 0) {
-          console.log(pc.red('\n❌ No projects selected. Run `porchestra explore` to select projects.'));
-          process.exit(1);
-        }
-      }
-
-      // Filter by options
-      if (options.project) {
-        trackedProjects = trackedProjects.filter(
-          p => p.projectId === options.project || p.projectSlug === options.project
-        );
-        if (trackedProjects.length === 0) {
-          console.log(pc.red(`Project "${options.project}" not found in tracked projects`));
-          process.exit(1);
-        }
-      }
-
-      // Pull each project
-      const baseOutputDir = options.output || config.output?.baseDir || path.resolve(process.cwd(), 'src/porchestra/agents');
-      let totalAgents = 0;
-      let successCount = 0;
-
-      for (const project of trackedProjects) {
-        // Filter agents if specified
-        let agents = project.agents;
-        if (options.agent) {
-          agents = agents.filter(
-            a => a.agentId === options.agent || a.agentSlug === options.agent
-          );
-        }
-
-        if (agents.length === 0) continue;
-
-        console.log(pc.bold(`\n📦 ${project.projectName}\n`));
-        totalAgents += agents.length;
-
-        // Process each agent with progress
-        for (let i = 0; i < agents.length; i++) {
-          const agent = agents[i];
-          const progress = `[${i + 1}/${agents.length}]`;
-          const spinner = ora(`${progress} Fetching ${agent.agentName}...`).start();
-
-          try {
-            // Fetch agent tools
-            const toolsResponse = await apiClient.getAgentTools(
-              project.projectId,
-              agent.agentId,
-              options.env
-            );
-
-            spinner.text = `${progress} Generating code...`;
-
-            const normalizeToolset = (toolset: any[] = []) =>
-              toolset.map((t, idx) => ({
-                id: t.id ?? `toolset-${idx}`,
-                name: t.name,
-                description: t.description ?? '',
-                parameters: t.parameters ?? {},
-                returns: t.returns ?? null,
-                isBuiltin: t.isBuiltin ?? false,
-                builtinType: t.builtinType,
-              }));
-
-            const rawToolConfig = toolsResponse?.components?.toolConfig?.content as any;
-            const parsedToolConfig = (() => {
-              if (typeof rawToolConfig === 'string') {
-                try {
-                  return JSON.parse(rawToolConfig);
-                } catch {
-                  return undefined;
-                }
-              }
-              return rawToolConfig;
-            })();
-
-            const findToolArray = (value: any): any[] | undefined => {
-              if (Array.isArray(value)) {
-                const hasNamedObjects = value.every(v => v && typeof v === 'object' && 'name' in v);
-                return hasNamedObjects ? value : undefined;
-              }
-              if (value && typeof value === 'object') {
-                if (Array.isArray(value.toolset)) return value.toolset;
-                if (Array.isArray(value.tools)) return value.tools;
-                for (const key of Object.keys(value)) {
-                  const found = findToolArray((value as any)[key]);
-                  if (found) return found;
-                }
-              }
-              return undefined;
-            };
-
-            const toolsetFromConfig = findToolArray(parsedToolConfig) ?? [];
-
-            const resolvedTools = (toolsResponse?.tools && toolsResponse.tools.length > 0)
-              ? toolsResponse.tools
-              : (Array.isArray(toolsResponse?.toolset)
-                  ? normalizeToolset(toolsResponse.toolset)
-                  : normalizeToolset(toolsetFromConfig));
-
-            if (!toolsResponse?.agent || !toolsResponse?.components) {
-              throw new Error('Invalid tools response from API');
-            }
-
-            // Generate code
-            const outputDir = codeGenerator.calculateOutputPath(
-              baseOutputDir,
-              agent.folderPath,
-              toolsResponse.agent.name
-            );
-
-            await codeGenerator.generate({
-              agent: toolsResponse.agent,
-              tools: resolvedTools,
-              components: toolsResponse.components,
-              outputDir,
-              forceOverwrite: options.force || false
-            });
-
-            spinner.succeed(`${progress} ${agent.agentName} → ${pc.gray(outputDir)}`);
-            successCount++;
-
-            // Update last pulled info
-            await projectTracker.updateLastPulled(
-              project.projectId,
-              agent.agentId,
-              toolsResponse.agent.version
-            );
-
-          } catch (error) {
-            spinner.fail(`${progress} ${agent.agentName}`);
-            console.error(pc.red(`   ✗ ${(error as Error).message}`));
-          }
-        }
-      }
-
-      // Summary
-      console.log(pc.bold('\n✨ Pull Complete\n'));
-      
-      if (successCount === totalAgents) {
-        console.log(`  ${pc.green('✓')} Generated: ${successCount} / ${totalAgents} agents`);
-      } else if (successCount > 0) {
-        console.log(`  ${pc.yellow('⚠')} Generated: ${successCount} / ${totalAgents} agents`);
-        console.log(`  ${pc.red('✗')} Failed: ${totalAgents - successCount} agents`);
-      } else {
-        console.log(`  ${pc.red('✗')} Failed: All ${totalAgents} agents`);
-      }
-      
-      console.log(`  Output: ${pc.gray(baseOutputDir)}`);
-      
-      if (successCount > 0) {
-        console.log(pc.gray('\nNext steps:'));
-        console.log(pc.gray('  1. Implement tool functions in tool-impl.ts files'));
-        console.log(pc.gray('  2. Import and use the tool dispatcher in your code'));
-      }
-      
-      console.log();
-      
-      // Exit with error if any agents failed
-      if (successCount < totalAgents) {
-        process.exit(1);
-      }
-    });
-}

package/src/commands/status.ts

@@ -1,78 +0,0 @@
-import { Command } from 'commander';
-import pc from 'picocolors';
-import { ConfigManager } from '../core/config/config-manager.js';
-import { ProjectTracker } from '../core/config/project-tracker.js';
-import { formatDistanceToNow } from '../utils/date.js';
-
-export function createStatusCommand(
-  configManager: ConfigManager
-): Command {
-  const projectTracker = new ProjectTracker(configManager);
-
-  return new Command('status')
-    .description('Show CLI status and tracked projects')
-    .action(async () => {
-      const config = await configManager.get();
-      
-      console.log(pc.bold('\n📊 Porchestra CLI Status\n'));
-
-      // Auth status
-      if (config.auth?.token) {
-        const expiresAt = new Date(config.auth.expiresAt!);
-        const daysUntilExpiry = Math.ceil(
-          (expiresAt.getTime() - Date.now()) / (1000 * 60 * 60 * 24)
-        );
-        const expiryColor = daysUntilExpiry < 7 ? pc.yellow : pc.green;
-        
-        console.log(pc.bold('🔑 Authentication'));
-        console.log(`  Status:   ${pc.green('✓ Logged in')}`);
-        console.log(`  Device:   ${config.auth.deviceName}`);
-        console.log(`  Expires:  ${expiryColor(daysUntilExpiry + ' days')} (${config.auth.expiresAt})`);
-      } else {
-        console.log(pc.bold('🔑 Authentication'));
-        console.log(`  Status:   ${pc.yellow('✗ Not logged in')}`);
-        console.log(pc.gray('  Run `porchestra login` to authenticate'));
-      }
-
-      // API Configuration
-      console.log(pc.bold('\n🔗 API Configuration'));
-      console.log(`  URL:      ${config.api?.baseUrl || pc.gray('(default)')}`);
-      if (config.api?.skipTlsVerify) {
-        console.log(pc.yellow(`  ⚠️ TLS verification disabled`));
-      }
-
-      // Tracked Projects
-      const projects = await projectTracker.getTrackedProjects();
-      console.log(pc.bold('\n📁 Tracked Projects'));
-      
-      if (projects.length === 0) {
-        console.log(pc.gray('  No projects tracked'));
-        console.log(pc.gray('  Run `porchestra explore` to select projects'));
-      } else {
-        console.log(`  Projects: ${projects.length}`);
-        console.log(`  Agents:   ${projects.reduce((sum, p) => sum + p.agents.length, 0)}`);
-        
-        projects.forEach(project => {
-          const lastPulled = project.lastPulledAt 
-            ? formatDistanceToNow(new Date(project.lastPulledAt))
-            : pc.gray('never');
-          
-          console.log(pc.gray(`\n  ${project.projectName}`));
-          project.agents.forEach(agent => {
-            const agentPulled = agent.lastPulledAt
-              ? formatDistanceToNow(new Date(agent.lastPulledAt))
-              : pc.gray('pending');
-            console.log(pc.gray(`    └─ ${agent.agentName} ${pc.cyan(agent.folderPath)} (${agentPulled})`));
-          });
-          console.log(pc.gray(`    Last pulled: ${lastPulled}`));
-        });
-      }
-
-      // Output Configuration
-      console.log(pc.bold('\n📂 Output Configuration'));
-      console.log(`  Base dir: ${config.output?.baseDir || './src/agents'}`);
-      console.log(`  Index files: ${config.output?.createIndexFiles ? 'yes' : 'no'}`);
-
-      console.log();
-    });
-}

package/src/commands/whoami.ts

@@ -1,56 +0,0 @@
-import { Command } from 'commander';
-import pc from 'picocolors';
-import { AuthService } from '../core/auth/auth-service.js';
-import { ConfigManager } from '../core/config/config-manager.js';
-import { ProjectTracker } from '../core/config/project-tracker.js';
-
-export function createWhoamiCommand(
-  configManager: ConfigManager,
-  authService: AuthService
-): Command {
-  const projectTracker = new ProjectTracker(configManager);
-
-  return new Command('whoami')
-    .description('Show current user and token information')
-    .action(async () => {
-      const config = await configManager.get();
-      
-      if (!config.auth?.token) {
-        console.log(pc.yellow('Not logged in. Run `porchestra login`'));
-        return;
-      }
-
-      try {
-        const userInfo = await authService.getCurrentUser(config.auth.token);
-        const expiresAt = new Date(config.auth.expiresAt!);
-        const isExpiringSoon = expiresAt.getTime() - Date.now() < 7 * 24 * 60 * 60 * 1000;
-
-        console.log(pc.bold('\n👤 User Information\n'));
-        console.log(`  Email:    ${pc.cyan(userInfo.email)}`);
-        console.log(`  Name:     ${userInfo.name || 'N/A'}`);
-        
-        console.log(pc.bold('\n🔑 Token Information\n'));
-        console.log(`  Device:   ${config.auth.deviceName || 'N/A'}`);
-        console.log(`  Expires:  ${isExpiringSoon ? pc.yellow(expiresAt.toISOString()) : pc.green(expiresAt.toISOString())}`);
-        
-        if (isExpiringSoon) {
-          console.log(pc.yellow('  ⚠️  Expires within 7 days - will auto-refresh'));
-        }
-        
-        if (config.api?.baseUrl !== 'https://api.porchestra.io/v1') {
-          console.log(pc.bold('\n🔗 API Configuration\n'));
-          console.log(`  URL:      ${config.api?.baseUrl}`);
-        }
-
-        // Show tracked projects summary
-        const summary = await projectTracker.getSummary();
-        console.log(pc.bold('\n📁 Tracked Projects\n'));
-        console.log(`  Projects: ${summary.projectCount}`);
-        console.log(`  Agents:   ${summary.agentCount}`);
-
-      } catch (error) {
-        console.log(pc.red('Failed to fetch user info. Token may be invalid.'));
-        console.log(pc.gray('Run `porchestra login` to re-authenticate.'));
-      }
-    });
-}

package/src/core/api/client.ts

@@ -1,133 +0,0 @@
-import got from 'got';
-import { ConfigManager } from '../config/config-manager.js';
-import { NetworkError, AuthenticationError } from '../../utils/errors.js';
-import {
-  ProjectsBriefResponse,
-  AgentsListResponse,
-  AgentToolsResponse,
-  UserInfo,
-  CliConfigResponse,
-  ApiResponse,
-} from '../../types/index.js';
-
-const MAX_RETRIES = 3;
-const RETRY_DELAY = 1000;
-
-interface RequestOptions {
-  method: 'GET' | 'POST' | 'DELETE';
-  headers?: Record<string, string>;
-}
-
-export class ApiClient {
-  private configManager: ConfigManager;
-
-  constructor(configManager: ConfigManager) {
-    this.configManager = configManager;
-  }
-
-  private async getBaseUrl(): Promise<string> {
-    const config = await this.configManager.get();
-    return config.api?.baseUrl || 'https://api.porchestra.io/v1';
-  }
-
-  private async getToken(): Promise<string | undefined> {
-    const config = await this.configManager.get();
-    return config.auth?.token;
-  }
-
-  private async requestWithRetry<T>(
-    url: string,
-    options: RequestOptions,
-    attempt = 1
-  ): Promise<T> {
-    try {
-      const token = await this.getToken();
-      const headers: Record<string, string> = {
-        'Content-Type': 'application/json',
-        ...(token && { Authorization: `Bearer ${token}` }),
-        ...(options.headers || {}),
-      };
-
-      const response = await got(url, {
-        method: options.method,
-        headers,
-        retry: { limit: 0 },
-      }).json<ApiResponse<T>>();
-
-      return response.data;
-    } catch (error: any) {
-      if (error.response?.statusCode === 401) {
-        throw new AuthenticationError('Authentication failed. Please login again.');
-      }
-
-      const isRetryable =
-        error.code === 'ECONNRESET' ||
-        error.code === 'ETIMEDOUT' ||
-        error.code === 'ENOTFOUND' ||
-        (error.response?.statusCode && error.response.statusCode >= 500);
-
-      if (isRetryable && attempt < MAX_RETRIES) {
-        await new Promise(resolve => setTimeout(resolve, RETRY_DELAY * attempt));
-        return this.requestWithRetry(url, options, attempt + 1);
-      }
-
-      throw new NetworkError(
-        `API request failed: ${error.message}`,
-        error.response?.statusCode,
-        isRetryable
-      );
-    }
-  }
-
-  async getProjectsBrief(): Promise<ProjectsBriefResponse> {
-    const baseUrl = await this.getBaseUrl();
-    return this.requestWithRetry<ProjectsBriefResponse>(
-      `${baseUrl}/projects/brief`,
-      { method: 'GET' }
-    );
-  }
-
-  async getProjectAgents(
-    projectId: string,
-    environment?: 'PRODUCTION' | 'STAGING' | 'DEVELOPMENT'
-  ): Promise<AgentsListResponse> {
-    const baseUrl = await this.getBaseUrl();
-    const query = environment ? `?environment=${environment}` : '';
-    return this.requestWithRetry<AgentsListResponse>(
-      `${baseUrl}/projects/${projectId}/agents${query}`,
-      { method: 'GET' }
-    );
-  }
-
-  async getAgentTools(
-    projectId: string,
-    agentId: string,
-    environment?: 'PRODUCTION' | 'STAGING' | 'DEVELOPMENT'
-  ): Promise<AgentToolsResponse> {
-    const baseUrl = await this.getBaseUrl();
-    const query = environment ? `?environment=${environment}` : '';
-    return this.requestWithRetry<AgentToolsResponse>(
-      `${baseUrl}/projects/${projectId}/agents/${agentId}/tools${query}`,
-      { method: 'GET' }
-    );
-  }
-
-  async getCurrentUser(token: string): Promise<UserInfo> {
-    const baseUrl = await this.getBaseUrl();
-    return this.requestWithRetry<UserInfo>(
-      `${baseUrl}/auth/me`,
-      {
-        method: 'GET',
-        headers: { Authorization: `Bearer ${token}` },
-      }
-    );
-  }
-
-  async getCliConfig(): Promise<CliConfigResponse> {
-    const baseUrl = await this.getBaseUrl();
-    return this.requestWithRetry<CliConfigResponse>(
-      `${baseUrl}/cli/config`,
-      { method: 'GET' }
-    );
-  }
-}

package/src/core/auth/auth-service.ts

@@ -1,176 +0,0 @@
-import { ConfigManager } from '../config/config-manager.js';
-import { AuthenticationError, NetworkError } from '../../utils/errors.js';
-import {
-  ApiResponse,
-  CliTokenResponse,
-  CliTokenRefreshResponse,
-  CliTokenRevokeResponse,
-  UserInfo,
-} from '../../types/index.js';
-import got from 'got';
-import os from 'os';
-
-interface LoginCredentials {
-  email: string;
-  password: string;
-  apiUrl?: string;
-  deviceName?: string;
-  skipTlsVerify?: boolean;
-}
-
-export class AuthService {
-  private configManager: ConfigManager;
-
-  constructor(configManager: ConfigManager) {
-    this.configManager = configManager;
-  }
-
-  async login(credentials: LoginCredentials): Promise<CliTokenResponse> {
-    const config = await this.configManager.get();
-    const baseUrl = credentials.apiUrl || config.api?.baseUrl || 'https://api.porchestra.io/v1';
-    
-    const deviceInfo = {
-      os: os.platform(),
-      version: os.release(),
-      cliVersion: '1.0.0',
-    };
-
-    const deviceName = credentials.deviceName || `${os.hostname()} - ${deviceInfo.os}`;
-
-    try {
-      const response = await got.post(`${baseUrl}/cli/login`, {
-        json: {
-          email: credentials.email,
-          password: credentials.password,
-          deviceName,
-          deviceInfo,
-        },
-        headers: {
-          'Content-Type': 'application/json',
-        },
-        https: {
-          rejectUnauthorized: !credentials.skipTlsVerify,
-        },
-      }).json<ApiResponse<CliTokenResponse>>();
-
-      return response.data;
-    } catch (error: any) {
-      if (error.response?.statusCode) {
-        if (error.response.statusCode === 401) {
-          throw new AuthenticationError('Invalid email or password');
-        }
-        throw new AuthenticationError(`Login failed: ${error.message}`);
-      }
-      if (error.code === 'ECONNREFUSED' || error.code === 'ENOTFOUND' || error.code === 'ETIMEDOUT') {
-        throw new NetworkError(`Network error: ${error.message}`);
-      }
-      throw error;
-    }
-  }
-
-  async refreshToken(tokenId: string, currentToken: string): Promise<CliTokenRefreshResponse> {
-    const config = await this.configManager.get();
-    const baseUrl = config.api?.baseUrl || 'https://api.porchestra.io/v1';
-
-    try {
-      const response = await got.post(`${baseUrl}/cli/token/refresh`, {
-        json: {
-          tokenId,
-          currentToken,
-        },
-        headers: {
-          'Authorization': `Bearer ${currentToken}`,
-          'Content-Type': 'application/json',
-        },
-      }).json<ApiResponse<CliTokenRefreshResponse>>();
-
-      return response.data;
-    } catch (error: any) {
-      if (error.response?.statusCode === 401) {
-        throw new AuthenticationError('Token refresh failed. Please login again.');
-      }
-      throw error;
-    }
-  }
-
-  async revokeToken(token: string, revokeAll = false): Promise<CliTokenRevokeResponse> {
-    const config = await this.configManager.get();
-    const baseUrl = config.api?.baseUrl || 'https://api.porchestra.io/v1';
-
-    try {
-      const response = await got.delete(`${baseUrl}/cli/token`, {
-        json: {
-          revokeAll,
-        },
-        headers: {
-          'Authorization': `Bearer ${token}`,
-          'Content-Type': 'application/json',
-        },
-      }).json<ApiResponse<CliTokenRevokeResponse>>();
-
-      return response.data;
-    } catch (error: any) {
-      if (error.response?.statusCode === 401) {
-        throw new AuthenticationError('Token already revoked or invalid');
-      }
-      throw error;
-    }
-  }
-
-  async getCurrentUser(token: string): Promise<UserInfo> {
-    const config = await this.configManager.get();
-    const baseUrl = config.api?.baseUrl || 'https://api.porchestra.io/v1';
-
-    try {
-      const response = await got.get(`${baseUrl}/auth/me`, {
-        headers: {
-          'Authorization': `Bearer ${token}`,
-        },
-      }).json<ApiResponse<UserInfo>>();
-
-      return response.data;
-    } catch (error: any) {
-      if (error.response?.statusCode === 401) {
-        throw new AuthenticationError('Token is invalid or expired');
-      }
-      throw error;
-    }
-  }
-
-  async checkAndRefreshTokenIfNeeded(): Promise<boolean> {
-    const config = await this.configManager.get();
-    
-    if (!config.auth?.token || !config.auth?.tokenId || !config.auth?.expiresAt) {
-      return false;
-    }
-
-    const expiresAt = new Date(config.auth.expiresAt);
-    const now = new Date();
-    const sevenDaysFromNow = new Date(now.getTime() + 7 * 24 * 60 * 60 * 1000);
-
-    // If token expires within 7 days, refresh it
-    if (expiresAt < sevenDaysFromNow) {
-      try {
-        const refreshed = await this.refreshToken(
-          config.auth.tokenId,
-          config.auth.token
-        );
-
-        await this.configManager.update((cfg) => ({
-          ...cfg,
-          auth: {
-            ...cfg.auth,
-            token: refreshed.token,
-            expiresAt: refreshed.expiresAt,
-          },
-        }));
-
-        return true;
-      } catch {
-        return false;
-      }
-    }
-
-    return true;
-  }
-}