@picahq/cli 0.2.0 → 0.3.0

package/src/commands/init.ts

@@ -1,548 +0,0 @@
-import * as p from '@clack/prompts';
-import pc from 'picocolors';
-import { writeConfig, readConfig, getConfigPath } from '../lib/config.js';
-import {
-  getAllAgents,
-  installMcpConfig,
-  isMcpInstalled,
-  getAgentConfigPath,
-  supportsProjectScope,
-  getAgentStatuses,
-  type InstallScope,
-  type AgentStatus,
-} from '../lib/agents.js';
-import { PicaApi } from '../lib/api.js';
-import { getApiKeyUrl, openApiKeyPage } from '../lib/browser.js';
-import { printTable } from '../lib/table.js';
-import type { Agent } from '../lib/types.js';
-
-export async function initCommand(options: { yes?: boolean; global?: boolean; project?: boolean }): Promise<void> {
-  p.intro(pc.bgCyan(pc.black(' Pica ')));
-
-  const existingConfig = readConfig();
-
-  if (existingConfig) {
-    await handleExistingConfig(existingConfig.apiKey, options);
-    return;
-  }
-
-  // First-run: no config exists
-  await freshSetup(options);
-}
-
-// ── Status display + action menu when config already exists ──────────
-
-async function handleExistingConfig(
-  apiKey: string,
-  options: { yes?: boolean; global?: boolean; project?: boolean },
-): Promise<void> {
-  const statuses = getAgentStatuses();
-
-  // Display current setup
-  const masked = maskApiKey(apiKey);
-  console.log();
-  console.log(`  ${pc.bold('Current Setup')}`);
-  console.log(`  ${pc.dim('─'.repeat(42))}`);
-  console.log(`  ${pc.dim('API Key:')}  ${masked}`);
-  console.log(`  ${pc.dim('Config:')}   ${getConfigPath()}`);
-  console.log();
-
-  // Agent status table
-  printTable(
-    [
-      { key: 'agent', label: 'Agent' },
-      { key: 'global', label: 'Global' },
-      { key: 'project', label: 'Project' },
-    ],
-    statuses.map(s => ({
-      agent: s.agent.name,
-      global: !s.detected
-        ? pc.dim('-')
-        : s.globalMcp
-          ? pc.green('\u25cf yes')
-          : pc.yellow('\u25cb no'),
-      project: s.projectMcp === null
-        ? pc.dim('-')
-        : s.projectMcp
-          ? pc.green('\u25cf yes')
-          : pc.yellow('\u25cb no'),
-    })),
-  );
-
-  const notDetected = statuses.filter(s => !s.detected);
-  if (notDetected.length > 0) {
-    console.log(`  ${pc.dim('- = not detected on this machine')}`);
-  }
-  console.log();
-
-  // Build action menu: only show relevant options
-  type Action = 'update-key' | 'install-more' | 'install-project' | 'start-fresh';
-  const actionOptions: { value: Action; label: string; hint?: string }[] = [];
-
-  actionOptions.push({
-    value: 'update-key',
-    label: 'Update API key',
-  });
-
-  const agentsMissingGlobal = statuses.filter(s => s.detected && !s.globalMcp);
-  if (agentsMissingGlobal.length > 0) {
-    actionOptions.push({
-      value: 'install-more',
-      label: 'Install MCP to more agents',
-      hint: agentsMissingGlobal.map(s => s.agent.name).join(', '),
-    });
-  }
-
-  const agentsMissingProject = statuses.filter(s => s.projectMcp === false);
-  if (agentsMissingProject.length > 0) {
-    actionOptions.push({
-      value: 'install-project',
-      label: 'Install MCP for this project',
-      hint: agentsMissingProject.map(s => s.agent.name).join(', '),
-    });
-  }
-
-  actionOptions.push({
-    value: 'start-fresh',
-    label: 'Start fresh (reconfigure everything)',
-  });
-
-  const action = await p.select({
-    message: 'What would you like to do?',
-    options: actionOptions,
-  });
-
-  if (p.isCancel(action)) {
-    p.outro('No changes made.');
-    return;
-  }
-
-  switch (action) {
-    case 'update-key':
-      await handleUpdateKey(statuses);
-      break;
-    case 'install-more':
-      await handleInstallMore(apiKey, agentsMissingGlobal);
-      break;
-    case 'install-project':
-      await handleInstallProject(apiKey, agentsMissingProject);
-      break;
-    case 'start-fresh':
-      await freshSetup({ yes: true });
-      break;
-  }
-}
-
-// ── Action handlers ──────────────────────────────────────────────────
-
-async function handleUpdateKey(statuses: AgentStatus[]): Promise<void> {
-  p.note(`Get your API key at:\n${pc.cyan(getApiKeyUrl())}`, 'API Key');
-
-  const openBrowser = await p.confirm({
-    message: 'Open browser to get API key?',
-    initialValue: true,
-  });
-
-  if (p.isCancel(openBrowser)) {
-    p.cancel('Cancelled.');
-    process.exit(0);
-  }
-
-  if (openBrowser) {
-    await openApiKeyPage();
-  }
-
-  const newKey = await p.text({
-    message: 'Enter your new Pica API key:',
-    placeholder: 'sk_live_...',
-    validate: (value) => {
-      if (!value) return 'API key is required';
-      if (!value.startsWith('sk_live_') && !value.startsWith('sk_test_')) {
-        return 'API key should start with sk_live_ or sk_test_';
-      }
-      return undefined;
-    },
-  });
-
-  if (p.isCancel(newKey)) {
-    p.cancel('Cancelled.');
-    process.exit(0);
-  }
-
-  // Validate
-  const spinner = p.spinner();
-  spinner.start('Validating API key...');
-
-  const api = new PicaApi(newKey);
-  const isValid = await api.validateApiKey();
-
-  if (!isValid) {
-    spinner.stop('Invalid API key');
-    p.cancel(`Invalid API key. Get a valid key at ${getApiKeyUrl()}`);
-    process.exit(1);
-  }
-
-  spinner.stop('API key validated');
-
-  // Re-install MCP to every agent that currently has it (preserve scopes)
-  const reinstalled: string[] = [];
-  for (const s of statuses) {
-    if (s.globalMcp) {
-      installMcpConfig(s.agent, newKey, 'global');
-      reinstalled.push(`${s.agent.name} (global)`);
-    }
-    if (s.projectMcp) {
-      installMcpConfig(s.agent, newKey, 'project');
-      reinstalled.push(`${s.agent.name} (project)`);
-    }
-  }
-
-  // Update config
-  const config = readConfig();
-  writeConfig({
-    apiKey: newKey,
-    installedAgents: config?.installedAgents ?? [],
-    createdAt: config?.createdAt ?? new Date().toISOString(),
-  });
-
-  if (reinstalled.length > 0) {
-    p.log.success(`Updated MCP configs: ${reinstalled.join(', ')}`);
-  }
-
-  p.outro('API key updated.');
-}
-
-async function handleInstallMore(apiKey: string, missing: AgentStatus[]): Promise<void> {
-  if (missing.length === 1) {
-    // Only one option, just confirm
-    const agent = missing[0].agent;
-    const confirm = await p.confirm({
-      message: `Install Pica MCP to ${agent.name}?`,
-      initialValue: true,
-    });
-
-    if (p.isCancel(confirm) || !confirm) {
-      p.outro('No changes made.');
-      return;
-    }
-
-    installMcpConfig(agent, apiKey, 'global');
-    updateConfigAgents(agent.id);
-    p.log.success(`${agent.name}: MCP installed`);
-    p.outro('Done.');
-    return;
-  }
-
-  const selected = await p.multiselect({
-    message: 'Select agents to install MCP:',
-    options: missing.map(s => ({
-      value: s.agent.id,
-      label: s.agent.name,
-    })),
-  });
-
-  if (p.isCancel(selected)) {
-    p.outro('No changes made.');
-    return;
-  }
-
-  const agents = missing.filter(s => (selected as string[]).includes(s.agent.id));
-  for (const s of agents) {
-    installMcpConfig(s.agent, apiKey, 'global');
-    updateConfigAgents(s.agent.id);
-    p.log.success(`${s.agent.name}: MCP installed`);
-  }
-
-  p.outro('Done.');
-}
-
-async function handleInstallProject(apiKey: string, missing: AgentStatus[]): Promise<void> {
-  if (missing.length === 1) {
-    const agent = missing[0].agent;
-    const confirm = await p.confirm({
-      message: `Install project-level MCP for ${agent.name}?`,
-      initialValue: true,
-    });
-
-    if (p.isCancel(confirm) || !confirm) {
-      p.outro('No changes made.');
-      return;
-    }
-
-    installMcpConfig(agent, apiKey, 'project');
-    const configPath = getAgentConfigPath(agent, 'project');
-    p.log.success(`${agent.name}: ${configPath} created`);
-    p.note(
-      pc.yellow('Project config files can be committed to share with your team.\n') +
-      pc.yellow('Team members will need their own API key.'),
-      'Tip',
-    );
-    p.outro('Done.');
-    return;
-  }
-
-  const selected = await p.multiselect({
-    message: 'Select agents for project-level MCP:',
-    options: missing.map(s => ({
-      value: s.agent.id,
-      label: s.agent.name,
-    })),
-  });
-
-  if (p.isCancel(selected)) {
-    p.outro('No changes made.');
-    return;
-  }
-
-  const agents = missing.filter(s => (selected as string[]).includes(s.agent.id));
-  for (const s of agents) {
-    installMcpConfig(s.agent, apiKey, 'project');
-    const configPath = getAgentConfigPath(s.agent, 'project');
-    p.log.success(`${s.agent.name}: ${configPath} created`);
-  }
-
-  p.note(
-    pc.yellow('Project config files can be committed to share with your team.\n') +
-    pc.yellow('Team members will need their own API key.'),
-    'Tip',
-  );
-  p.outro('Done.');
-}
-
-// ── First-run setup (no existing config) ─────────────────────────────
-
-async function freshSetup(options: { yes?: boolean; global?: boolean; project?: boolean }): Promise<void> {
-  // Get API key
-  p.note(`Get your API key at:\n${pc.cyan(getApiKeyUrl())}`, 'API Key');
-
-  const openBrowser = await p.confirm({
-    message: 'Open browser to get API key?',
-    initialValue: true,
-  });
-
-  if (p.isCancel(openBrowser)) {
-    p.cancel('Setup cancelled.');
-    process.exit(0);
-  }
-
-  if (openBrowser) {
-    await openApiKeyPage();
-  }
-
-  const apiKey = await p.text({
-    message: 'Enter your Pica API key:',
-    placeholder: 'sk_live_...',
-    validate: (value) => {
-      if (!value) return 'API key is required';
-      if (!value.startsWith('sk_live_') && !value.startsWith('sk_test_')) {
-        return 'API key should start with sk_live_ or sk_test_';
-      }
-      return undefined;
-    },
-  });
-
-  if (p.isCancel(apiKey)) {
-    p.cancel('Setup cancelled.');
-    process.exit(0);
-  }
-
-  // Validate API key
-  const spinner = p.spinner();
-  spinner.start('Validating API key...');
-
-  const api = new PicaApi(apiKey);
-  const isValid = await api.validateApiKey();
-
-  if (!isValid) {
-    spinner.stop('Invalid API key');
-    p.cancel(`Invalid API key. Get a valid key at ${getApiKeyUrl()}`);
-    process.exit(1);
-  }
-
-  spinner.stop('API key validated');
-
-  // Save API key to config first
-  writeConfig({
-    apiKey,
-    installedAgents: [],
-    createdAt: new Date().toISOString(),
-  });
-
-  // Ask which agent to install for
-  const allAgents = getAllAgents();
-
-  const agentChoice = await p.select({
-    message: 'Where do you want to install the MCP?',
-    options: [
-      {
-        value: 'all',
-        label: 'All agents',
-        hint: 'Claude Code, Claude Desktop, Cursor, Windsurf',
-      },
-      ...allAgents.map(agent => ({
-        value: agent.id,
-        label: agent.name,
-      })),
-    ],
-  });
-
-  if (p.isCancel(agentChoice)) {
-    p.cancel('Setup cancelled.');
-    process.exit(0);
-  }
-
-  const selectedAgents: Agent[] = agentChoice === 'all'
-    ? allAgents
-    : allAgents.filter(a => a.id === agentChoice);
-
-  // Ask about installation scope if any selected agent supports project scope
-  let scope: InstallScope = 'global';
-  const hasProjectScopeAgent = selectedAgents.some(a => supportsProjectScope(a));
-
-  if (options.global) {
-    scope = 'global';
-  } else if (options.project) {
-    scope = 'project';
-  } else if (hasProjectScopeAgent) {
-    const scopeChoice = await p.select({
-      message: 'How do you want to install it?',
-      options: [
-        {
-          value: 'global',
-          label: 'Global (Recommended)',
-          hint: 'Available in all your projects',
-        },
-        {
-          value: 'project',
-          label: 'Project only',
-          hint: 'Creates config files in current directory',
-        },
-      ],
-    });
-
-    if (p.isCancel(scopeChoice)) {
-      p.cancel('Setup cancelled.');
-      process.exit(0);
-    }
-
-    scope = scopeChoice as InstallScope;
-  }
-
-  // Handle project scope installation
-  if (scope === 'project') {
-    const projectAgents = selectedAgents.filter(a => supportsProjectScope(a));
-    const nonProjectAgents = selectedAgents.filter(a => !supportsProjectScope(a));
-
-    if (projectAgents.length === 0) {
-      const supported = allAgents.filter(a => supportsProjectScope(a)).map(a => a.name).join(', ');
-      p.note(
-        `${selectedAgents.map(a => a.name).join(', ')} does not support project-level MCP.\n` +
-        `Project scope is supported by: ${supported}`,
-        'Not Supported'
-      );
-      p.cancel('Run again and choose global scope or a different agent.');
-      process.exit(1);
-    }
-
-    // Install project-scoped agents
-    for (const agent of projectAgents) {
-      const wasInstalled = isMcpInstalled(agent, 'project');
-      installMcpConfig(agent, apiKey, 'project');
-      const configPath = getAgentConfigPath(agent, 'project');
-      const status = wasInstalled ? 'updated' : 'created';
-      p.log.success(`${agent.name}: ${configPath} ${status}`);
-    }
-
-    // If "all agents" was selected and some don't support project scope,
-    // install those globally and let the user know
-    if (nonProjectAgents.length > 0) {
-      p.log.info(`Installing globally for agents without project scope support:`);
-      for (const agent of nonProjectAgents) {
-        const wasInstalled = isMcpInstalled(agent, 'global');
-        installMcpConfig(agent, apiKey, 'global');
-        const status = wasInstalled ? 'updated' : 'installed';
-        p.log.success(`${agent.name}: MCP ${status} (global)`);
-      }
-    }
-
-    const allInstalled = [...projectAgents, ...nonProjectAgents];
-
-    // Update config
-    writeConfig({
-      apiKey,
-      installedAgents: allInstalled.map(a => a.id),
-      createdAt: new Date().toISOString(),
-    });
-
-    const configPaths = projectAgents
-      .map(a => `  ${a.name}: ${pc.dim(getAgentConfigPath(a, 'project'))}`)
-      .join('\n');
-
-    let summary = `Config saved to: ${pc.dim(getConfigPath())}\n` +
-      `MCP configs:\n${configPaths}\n\n`;
-
-    if (nonProjectAgents.length > 0) {
-      const globalPaths = nonProjectAgents
-        .map(a => `  ${a.name}: ${pc.dim(getAgentConfigPath(a, 'global'))}`)
-        .join('\n');
-      summary += `Global configs:\n${globalPaths}\n\n`;
-    }
-
-    summary +=
-      pc.yellow('Note: Project config files can be committed to share with your team.\n') +
-      pc.yellow('Team members will need their own API key.\n\n') +
-      `Next steps:\n` +
-      `  ${pc.cyan('pica add gmail')}       - Connect Gmail\n` +
-      `  ${pc.cyan('pica platforms')}        - See all 200+ integrations`;
-
-    p.note(summary, 'Setup Complete');
-    p.outro('Pica MCP installed!');
-    return;
-  }
-
-  // Global scope: install to all selected agents
-  const installedAgentIds: string[] = [];
-
-  for (const agent of selectedAgents) {
-    const wasInstalled = isMcpInstalled(agent, 'global');
-    installMcpConfig(agent, apiKey, 'global');
-    installedAgentIds.push(agent.id);
-
-    const status = wasInstalled ? 'updated' : 'installed';
-    p.log.success(`${agent.name}: MCP ${status}`);
-  }
-
-  // Save config
-  writeConfig({
-    apiKey,
-    installedAgents: installedAgentIds,
-    createdAt: new Date().toISOString(),
-  });
-
-  p.note(
-    `Config saved to: ${pc.dim(getConfigPath())}\n\n` +
-    `Next steps:\n` +
-    `  ${pc.cyan('pica add gmail')}       - Connect Gmail\n` +
-    `  ${pc.cyan('pica platforms')}        - See all 200+ integrations\n` +
-    `  ${pc.cyan('pica connection list')}  - View your connections`,
-    'Setup Complete'
-  );
-
-  p.outro('Your AI agents now have access to Pica integrations!');
-}
-
-// ── Helpers ──────────────────────────────────────────────────────────
-
-function maskApiKey(key: string): string {
-  if (key.length <= 12) return key.slice(0, 8) + '...';
-  return key.slice(0, 8) + '...' + key.slice(-4);
-}
-
-function updateConfigAgents(agentId: string): void {
-  const config = readConfig();
-  if (!config) return;
-  if (!config.installedAgents.includes(agentId)) {
-    config.installedAgents.push(agentId);
-    writeConfig(config);
-  }
-}

package/src/commands/platforms.ts

@@ -1,92 +0,0 @@
-import * as p from '@clack/prompts';
-import pc from 'picocolors';
-import { getApiKey } from '../lib/config.js';
-import { PicaApi } from '../lib/api.js';
-import { printTable } from '../lib/table.js';
-import type { Platform } from '../lib/types.js';
-
-export async function platformsCommand(options: { category?: string; json?: boolean }): Promise<void> {
-  const apiKey = getApiKey();
-  if (!apiKey) {
-    p.cancel('Not configured. Run `pica init` first.');
-    process.exit(1);
-  }
-
-  const api = new PicaApi(apiKey);
-
-  const spinner = p.spinner();
-  spinner.start('Loading platforms...');
-
-  try {
-    const platforms = await api.listPlatforms();
-    spinner.stop(`${platforms.length} platforms available`);
-
-    if (options.json) {
-      console.log(JSON.stringify(platforms, null, 2));
-      return;
-    }
-
-    // Group by category
-    const byCategory = new Map<string, Platform[]>();
-    for (const plat of platforms) {
-      const category = plat.category || 'Other';
-      if (!byCategory.has(category)) {
-        byCategory.set(category, []);
-      }
-      byCategory.get(category)!.push(plat);
-    }
-
-    console.log();
-
-    // Filter by category if specified
-    if (options.category) {
-      const categoryPlatforms = byCategory.get(options.category);
-      if (!categoryPlatforms) {
-        const categories = [...byCategory.keys()].sort();
-        p.note(`Available categories:\n  ${categories.join(', ')}`, 'Unknown Category');
-        process.exit(1);
-      }
-
-      const rows = categoryPlatforms
-        .sort((a, b) => a.platform.localeCompare(b.platform))
-        .map(plat => ({
-          platform: plat.platform,
-          name: plat.name,
-          category: plat.category || 'Other',
-        }));
-
-      printTable(
-        [
-          { key: 'platform', label: 'Platform' },
-          { key: 'name', label: 'Name' },
-        ],
-        rows
-      );
-    } else {
-      const rows = platforms
-        .sort((a, b) => a.category.localeCompare(b.category) || a.platform.localeCompare(b.platform))
-        .map(plat => ({
-          platform: plat.platform,
-          name: plat.name,
-          category: plat.category || 'Other',
-        }));
-
-      printTable(
-        [
-          { key: 'category', label: 'Category' },
-          { key: 'platform', label: 'Platform' },
-          { key: 'name', label: 'Name' },
-        ],
-        rows
-      );
-    }
-
-    console.log();
-    p.note(`Connect with: ${pc.cyan('pica connection add <platform>')}`, 'Tip');
-  } catch (error) {
-    spinner.stop('Failed to load platforms');
-    p.cancel(`Error: ${error instanceof Error ? error.message : 'Unknown error'}`);
-    process.exit(1);
-  }
-}
-