@l4yercak3/cli 1.3.1 → 2.0.0-alpha.0

package/src/mcp/registry/index.js

@@ -1,164 +0,0 @@
-/**
- * MCP Tool Registry
- *
- * Central registry for all MCP tools organized by domain.
- * Handles tool discovery, filtering by auth context, and execution.
- *
- * @module mcp/registry
- */
-
-const { requireAuth, hasPermission } = require('../auth');
-
-// Import tool domains
-const coreDomain = require('./domains/core');
-const crmDomain = require('./domains/crm');
-const eventsDomain = require('./domains/events');
-const formsDomain = require('./domains/forms');
-const codegenDomain = require('./domains/codegen');
-const applicationsDomain = require('./domains/applications');
-const benefitsDomain = require('./domains/benefits');
-
-/**
- * @typedef {Object} ToolDefinition
- * @property {string} name - Tool name (e.g., 'l4yercak3_get_capabilities')
- * @property {string} description - Human-readable description
- * @property {Object} inputSchema - JSON Schema for tool parameters
- * @property {Function} handler - Async function(params, authContext) => result
- * @property {boolean} requiresAuth - Whether auth is required
- * @property {string[]} [requiredPermissions] - Permissions needed to use this tool
- */
-
-/**
- * @typedef {Object} ToolDomain
- * @property {string} name - Domain name (e.g., 'crm')
- * @property {string} description - Domain description
- * @property {ToolDefinition[]} tools - Tools in this domain
- */
-
-/**
- * All registered tool domains
- * @type {ToolDomain[]}
- */
-const toolDomains = [
-  coreDomain,
-  applicationsDomain,
-  crmDomain,
-  eventsDomain,
-  formsDomain,
-  benefitsDomain,
-  codegenDomain,
-];
-
-/**
- * Get all available tools for the current auth context
- *
- * @param {Object|null} authContext - Current auth context
- * @returns {ToolDefinition[]} Available tools
- */
-function getAvailableTools(authContext) {
-  const tools = [];
-
-  for (const domain of toolDomains) {
-    for (const tool of domain.tools) {
-      // Include if no auth required
-      if (!tool.requiresAuth) {
-        tools.push(tool);
-        continue;
-      }
-
-      // Skip if auth required but not authenticated
-      if (!authContext) {
-        continue;
-      }
-
-      // Check required permissions
-      if (tool.requiredPermissions && tool.requiredPermissions.length > 0) {
-        const hasAllPermissions = tool.requiredPermissions.every(perm =>
-          hasPermission(authContext, perm)
-        );
-        if (!hasAllPermissions) {
-          continue;
-        }
-      }
-
-      tools.push(tool);
-    }
-  }
-
-  return tools;
-}
-
-/**
- * Find a tool by name
- *
- * @param {string} name - Tool name
- * @returns {ToolDefinition|null}
- */
-function findTool(name) {
-  for (const domain of toolDomains) {
-    const tool = domain.tools.find(t => t.name === name);
-    if (tool) {
-      return tool;
-    }
-  }
-  return null;
-}
-
-/**
- * Execute a tool
- *
- * @param {string} name - Tool name
- * @param {Object} params - Tool parameters
- * @param {Object|null} authContext - Current auth context
- * @returns {Promise<any>} Tool result
- */
-async function executeTool(name, params, authContext) {
-  const tool = findTool(name);
-
-  if (!tool) {
-    throw new Error(`Unknown tool: ${name}`);
-  }
-
-  // Check auth requirements
-  if (tool.requiresAuth) {
-    requireAuth(authContext);
-
-    // Check permissions
-    if (tool.requiredPermissions && tool.requiredPermissions.length > 0) {
-      for (const perm of tool.requiredPermissions) {
-        if (!hasPermission(authContext, perm)) {
-          throw new Error(
-            `Permission denied: ${perm} required for tool ${name}`
-          );
-        }
-      }
-    }
-  }
-
-  // Execute the tool
-  try {
-    return await tool.handler(params, authContext);
-  } catch (error) {
-    // Re-throw with context
-    const enhancedError = new Error(`Tool ${name} failed: ${error.message}`);
-    enhancedError.toolName = name;
-    enhancedError.originalError = error;
-    throw enhancedError;
-  }
-}
-
-/**
- * Get all domains (for documentation/discovery)
- *
- * @returns {ToolDomain[]}
- */
-function getDomains() {
-  return toolDomains;
-}
-
-module.exports = {
-  getAvailableTools,
-  findTool,
-  executeTool,
-  getDomains,
-};

package/src/mcp/server.js

@@ -1,116 +0,0 @@
-/**
- * L4YERCAK3 MCP Server
- *
- * Exposes L4YERCAK3 backend capabilities to Claude Code via MCP protocol.
- * This allows Claude Code to discover and use L4YERCAK3 features to help
- * users integrate their projects.
- *
- * Usage:
- * - Users add via: claude mcp add l4yercak3 -- npx l4yercak3 mcp-server
- * - Reads auth from ~/.l4yercak3/config.json (created by l4yercak3 login)
- *
- * @module mcp/server
- */
-
-const { Server } = require('@modelcontextprotocol/sdk/server/index.js');
-const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');
-const {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-} = require('@modelcontextprotocol/sdk/types.js');
-
-const { getAuthContext } = require('./auth');
-const { getAvailableTools, executeTool } = require('./registry');
-
-/**
- * Create and configure the MCP server
- */
-function createServer() {
-  const server = new Server(
-    {
-      name: 'l4yercak3',
-      version: require('../../package.json').version,
-    },
-    {
-      capabilities: {
-        tools: {},
-      },
-    }
-  );
-
-  // Handle ListTools request
-  server.setRequestHandler(ListToolsRequestSchema, async () => {
-    const authContext = await getAuthContext();
-    const tools = getAvailableTools(authContext);
-
-    return {
-      tools: tools.map(tool => ({
-        name: tool.name,
-        description: tool.description,
-        inputSchema: tool.inputSchema,
-      })),
-    };
-  });
-
-  // Handle CallTool request
-  server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-
-    try {
-      const authContext = await getAuthContext();
-      const result = await executeTool(name, args || {}, authContext);
-
-      return {
-        content: [
-          {
-            type: 'text',
-            text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
-          },
-        ],
-      };
-    } catch (error) {
-      return {
-        content: [
-          {
-            type: 'text',
-            text: `Error: ${error.message}`,
-          },
-        ],
-        isError: true,
-      };
-    }
-  });
-
-  return server;
-}
-
-/**
- * Start the MCP server
- */
-async function startServer() {
-  const server = createServer();
-  const transport = new StdioServerTransport();
-
-  await server.connect(transport);
-
-  // Log startup to stderr (stdout is used for MCP protocol)
-  console.error('[L4YERCAK3 MCP] Server started');
-
-  // Handle graceful shutdown
-  process.on('SIGINT', async () => {
-    console.error('[L4YERCAK3 MCP] Shutting down...');
-    await server.close();
-    process.exit(0);
-  });
-
-  process.on('SIGTERM', async () => {
-    console.error('[L4YERCAK3 MCP] Shutting down...');
-    await server.close();
-    process.exit(0);
-  });
-}
-
-module.exports = {
-  createServer,
-  startServer,
-};

package/src/utils/file-utils.js

@@ -1,117 +0,0 @@
-/**
- * File Utilities
- * Helper functions for safe file operations
- */
-
-const fs = require('fs');
-const path = require('path');
-const crypto = require('crypto');
-const inquirer = require('inquirer');
-const chalk = require('chalk');
-
-const GENERATED_HEADER = 'Auto-generated by @l4yercak3/cli';
-
-/**
- * Check if a file was generated by our CLI
- */
-function isGeneratedFile(filePath) {
-  if (!fs.existsSync(filePath)) {
-    return false;
-  }
-
-  try {
-    const content = fs.readFileSync(filePath, 'utf8');
-    // Check first 500 chars for our header
-    return content.substring(0, 500).includes(GENERATED_HEADER);
-  } catch (error) {
-    return false;
-  }
-}
-
-/**
- * Check if file exists and prompt for action if needed
- * Returns: 'write' | 'skip' | 'backup'
- */
-async function checkFileOverwrite(filePath, options = {}) {
-  const { silent = false, defaultAction = 'prompt' } = options;
-
-  if (!fs.existsSync(filePath)) {
-    return 'write';
-  }
-
-  // If it's our generated file, safe to overwrite
-  if (isGeneratedFile(filePath)) {
-    if (!silent) {
-      console.log(chalk.gray(`  Updating ${path.basename(filePath)} (previously generated)`));
-    }
-    return 'write';
-  }
-
-  // File exists and wasn't generated by us - prompt user
-  if (defaultAction === 'skip') {
-    return 'skip';
-  }
-
-  const relativePath = path.basename(filePath);
-  console.log(chalk.yellow(`\n  ⚠️  ${relativePath} already exists and appears to be modified`));
-
-  const { action } = await inquirer.prompt([
-    {
-      type: 'list',
-      name: 'action',
-      message: `What would you like to do with ${relativePath}?`,
-      choices: [
-        { name: 'Overwrite (replace with generated code)', value: 'write' },
-        { name: 'Backup and overwrite (save old file as .backup)', value: 'backup' },
-        { name: 'Skip (keep existing file)', value: 'skip' },
-      ],
-    },
-  ]);
-
-  return action;
-}
-
-/**
- * Write file with optional backup
- */
-function writeFileWithBackup(filePath, content, action) {
-  if (action === 'skip') {
-    return null;
-  }
-
-  if (action === 'backup' && fs.existsSync(filePath)) {
-    const backupPath = `${filePath}.backup`;
-    fs.copyFileSync(filePath, backupPath);
-    console.log(chalk.gray(`  Backed up to ${path.basename(backupPath)}`));
-  }
-
-  fs.writeFileSync(filePath, content, 'utf8');
-  return filePath;
-}
-
-/**
- * Ensure directory exists
- */
-function ensureDir(dirPath) {
-  if (!fs.existsSync(dirPath)) {
-    fs.mkdirSync(dirPath, { recursive: true });
-  }
-}
-
-/**
- * Generate SHA256 hash of project path for identification
- * This is used to identify returning projects when registering with backend
- */
-function generateProjectPathHash(projectPath) {
-  const absolutePath = path.resolve(projectPath);
-  return crypto.createHash('sha256').update(absolutePath).digest('hex');
-}
-
-module.exports = {
-  GENERATED_HEADER,
-  isGeneratedFile,
-  checkFileOverwrite,
-  writeFileWithBackup,
-  ensureDir,
-  generateProjectPathHash,
-};

package/src/utils/init-helpers.js

@@ -1,243 +0,0 @@
-/**
- * Init Helpers
- * Shared helper functions for project initialization, connection, and sync commands
- * Extracted from spread.js for reuse across connect.js, scaffold.js, sync.js
- */
-
-const { execSync } = require('child_process');
-const inquirer = require('inquirer');
-const chalk = require('chalk');
-const backendClient = require('../api/backend-client');
-
-/**
- * Create an organization on the platform
- * @param {string} orgName - Organization name
- * @returns {Promise<{organizationId: string, organizationName: string}>}
- */
-async function createOrganization(orgName) {
-  console.log(chalk.gray(`  Creating organization "${orgName}"...`));
-  const newOrg = await backendClient.createOrganization(orgName);
-  const organizationId = newOrg.organizationId || newOrg.id || newOrg.data?.organizationId || newOrg.data?.id;
-  const organizationName = newOrg.name || orgName;
-
-  if (!organizationId) {
-    throw new Error('Organization ID not found in response. Please check backend API endpoint.');
-  }
-
-  console.log(chalk.green(`  ✅ Organization created: ${organizationName}\n`));
-  return { organizationId, organizationName };
-}
-
-/**
- * Generate a new API key for an organization
- * @param {string} organizationId
- * @returns {Promise<string>} The API key
- */
-async function generateNewApiKey(organizationId) {
-  console.log(chalk.gray('  Generating API key...'));
-  const apiKeyResponse = await backendClient.generateApiKey(
-    organizationId,
-    'CLI Generated Key',
-    ['*']
-  );
-  const apiKey = apiKeyResponse.key || apiKeyResponse.apiKey || apiKeyResponse.data?.key || apiKeyResponse.data?.apiKey;
-
-  if (!apiKey) {
-    throw new Error('API key not found in response. Please check backend API endpoint.');
-  }
-
-  console.log(chalk.green(`  ✅ API key generated\n`));
-  return apiKey;
-}
-
-/**
- * Check if the project is a git repository
- * @param {string} projectPath
- * @returns {boolean}
- */
-function isGitRepo(projectPath) {
-  try {
-    execSync('git rev-parse --is-inside-work-tree', {
-      cwd: projectPath,
-      stdio: 'pipe',
-    });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Get git status (uncommitted changes)
- * @param {string} projectPath
- * @returns {string}
- */
-function getGitStatus(projectPath) {
-  try {
-    const status = execSync('git status --porcelain', {
-      cwd: projectPath,
-      encoding: 'utf8',
-    });
-    return status.trim();
-  } catch {
-    return '';
-  }
-}
-
-/**
- * Check for uncommitted changes and prompt user to commit first
- * @param {string} projectPath
- * @returns {Promise<boolean>} true if should proceed, false to abort
- */
-async function checkGitStatusBeforeGeneration(projectPath) {
-  const debug = process.env.L4YERCAK3_DEBUG;
-
-  if (debug) {
-    console.log('\n[DEBUG] Git status check:');
-    console.log(`  projectPath: "${projectPath}"`);
-  }
-
-  if (!isGitRepo(projectPath)) {
-    if (debug) console.log('  → Not a git repo, skipping check');
-    return true;
-  }
-
-  const status = getGitStatus(projectPath);
-
-  if (debug) {
-    console.log(`  → Git status: "${status.substring(0, 100)}${status.length > 100 ? '...' : ''}"`);
-  }
-
-  if (!status) {
-    if (debug) console.log('  → No uncommitted changes, proceeding');
-    return true;
-  }
-
-  const changes = status.split('\n').filter(line => line.trim());
-  const modifiedCount = changes.filter(line => line.startsWith(' M') || line.startsWith('M ')).length;
-  const untrackedCount = changes.filter(line => line.startsWith('??')).length;
-  const stagedCount = changes.filter(line => /^[MADRC]/.test(line)).length;
-
-  console.log(chalk.yellow('  ⚠️  Uncommitted changes detected\n'));
-
-  if (modifiedCount > 0) console.log(chalk.gray(`     ${modifiedCount} modified file(s)`));
-  if (untrackedCount > 0) console.log(chalk.gray(`     ${untrackedCount} untracked file(s)`));
-  if (stagedCount > 0) console.log(chalk.gray(`     ${stagedCount} staged file(s)`));
-
-  console.log('');
-  console.log(chalk.gray('  We recommend committing your changes before generating'));
-  console.log(chalk.gray('  new files, so you can easily revert if needed.\n'));
-
-  const { action } = await inquirer.prompt([
-    {
-      type: 'list',
-      name: 'action',
-      message: 'How would you like to proceed?',
-      choices: [
-        { name: 'Continue anyway - I\'ll handle it later', value: 'continue' },
-        { name: 'Commit changes now - Create a checkpoint commit', value: 'commit' },
-        { name: 'Abort - I\'ll commit manually first', value: 'abort' },
-      ],
-    },
-  ]);
-
-  if (action === 'abort') {
-    console.log(chalk.gray('\n  No worries! Run the command again after committing.\n'));
-    return false;
-  }
-
-  if (action === 'commit') {
-    try {
-      execSync('git add -A', { cwd: projectPath, stdio: 'pipe' });
-      const commitMessage = 'chore: checkpoint before L4YERCAK3 integration';
-      execSync(`git commit -m "${commitMessage}"`, { cwd: projectPath, stdio: 'pipe' });
-
-      console.log(chalk.green('\n  ✅ Changes committed successfully'));
-      console.log(chalk.gray(`     Message: "${commitMessage}"`));
-      console.log(chalk.gray('     You can revert with: git reset --soft HEAD~1\n'));
-    } catch (error) {
-      console.log(chalk.yellow('\n  ⚠️  Could not create commit automatically'));
-      console.log(chalk.gray(`     ${error.message}`));
-      console.log(chalk.gray('     Proceeding with file generation anyway...\n'));
-    }
-  }
-
-  return true;
-}
-
-/**
- * Select or create an organization
- * @returns {Promise<{organizationId: string, organizationName: string}>}
- */
-async function selectOrganization(defaultName) {
-  const orgsResponse = await backendClient.getOrganizations();
-  const organizations = Array.isArray(orgsResponse)
-    ? orgsResponse
-    : orgsResponse.organizations || orgsResponse.data || [];
-
-  if (organizations.length === 0) {
-    const { orgName } = await inquirer.prompt([
-      {
-        type: 'input',
-        name: 'orgName',
-        message: 'Organization name:',
-        default: defaultName || 'My Organization',
-        validate: (input) => input.trim().length > 0 || 'Organization name is required',
-      },
-    ]);
-    return createOrganization(orgName);
-  }
-
-  const { orgChoice } = await inquirer.prompt([
-    {
-      type: 'list',
-      name: 'orgChoice',
-      message: 'Select organization:',
-      choices: [
-        ...organizations.map(org => ({
-          name: `${org.name} (${org.id})`,
-          value: org.id,
-        })),
-        { name: '➕ Create new organization', value: '__create__' },
-      ],
-    },
-  ]);
-
-  if (orgChoice === '__create__') {
-    const { orgName } = await inquirer.prompt([
-      {
-        type: 'input',
-        name: 'orgName',
-        message: 'Organization name:',
-        default: defaultName || 'My Organization',
-        validate: (input) => input.trim().length > 0 || 'Organization name is required',
-      },
-    ]);
-    return createOrganization(orgName);
-  }
-
-  const selectedOrg = organizations.find(org => org.id === orgChoice);
-  console.log(chalk.green(`  ✅ Selected organization: ${selectedOrg.name}\n`));
-  return { organizationId: orgChoice, organizationName: selectedOrg.name };
-}
-
-/**
- * Require the user to be logged in, exit if not
- */
-function requireAuth(configManager) {
-  if (!configManager.isLoggedIn()) {
-    console.log(chalk.yellow('  ⚠️  You must be logged in first'));
-    console.log(chalk.gray('\n  Run "l4yercak3 login" to authenticate\n'));
-    process.exit(1);
-  }
-}
-
-module.exports = {
-  createOrganization,
-  generateNewApiKey,
-  isGitRepo,
-  getGitStatus,
-  checkGitStatusBeforeGeneration,
-  selectOrganization,
-  requireAuth,
-};