@l4yercak3/cli 1.2.21 → 1.3.1

package/src/api/backend-client.js

@@ -294,6 +294,155 @@ class BackendClient {
   async syncApplication(applicationId, syncData) {
     return await this.request('POST', `/api/v1/cli/applications/${applicationId}/sync`, syncData);
   }
+
+  // ============================================
+  // Activity Protocol / Page Detection API
+  // ============================================
+
+  /**
+   * Bulk register pages for an application
+   * @param {string} applicationId - The application ID
+   * @param {Array<{path: string, name: string, pageType?: string}>} pages - Pages to register
+   * @returns {Promise<{success: boolean, results: Array, total: number, created: number, updated: number}>}
+   */
+  async bulkRegisterPages(applicationId, pages) {
+    return await this.request('POST', '/api/v1/activity/pages/bulk', {
+      applicationId,
+      pages,
+    });
+  }
+
+  /**
+   * Register a single page
+   * @param {string} applicationId - The application ID
+   * @param {object} pageData - Page data
+   * @returns {Promise<{success: boolean, pageId: string, created: boolean}>}
+   */
+  async registerPage(applicationId, pageData) {
+    return await this.request('POST', '/api/v1/activity/pages', {
+      applicationId,
+      ...pageData,
+    });
+  }
+
+  /**
+   * Get all pages for an application
+   * @param {string} applicationId - The application ID
+   * @param {object} options - Query options (status)
+   * @returns {Promise<{success: boolean, pages: Array, total: number}>}
+   */
+  async getApplicationPages(applicationId, options = {}) {
+    let url = `/api/v1/activity/pages?applicationId=${applicationId}`;
+    if (options.status) {
+      url += `&status=${options.status}`;
+    }
+    return await this.request('GET', url);
+  }
+
+  /**
+   * Log an activity event
+   * @param {string} applicationId - The application ID
+   * @param {object} eventData - Event data
+   * @returns {Promise<{success: boolean, eventId: string, timestamp: number}>}
+   */
+  async logActivityEvent(applicationId, eventData) {
+    return await this.request('POST', '/api/v1/activity/events', {
+      applicationId,
+      ...eventData,
+    });
+  }
+
+  /**
+   * Get activity events for an application
+   * @param {string} applicationId - The application ID
+   * @param {object} options - Query options (severity, category, limit)
+   * @returns {Promise<{success: boolean, events: Array, hasMore: boolean, nextCursor: string|null}>}
+   */
+  async getActivityEvents(applicationId, options = {}) {
+    let url = `/api/v1/activity/events?applicationId=${applicationId}`;
+    if (options.severity) {
+      url += `&severity=${options.severity}`;
+    }
+    if (options.category) {
+      url += `&category=${options.category}`;
+    }
+    if (options.limit) {
+      url += `&limit=${options.limit}`;
+    }
+    return await this.request('GET', url);
+  }
+
+  /**
+   * Get activity statistics for an application
+   * @param {string} applicationId - The application ID
+   * @param {string} timeRange - Time range ('1h', '24h', '7d')
+   * @returns {Promise<{success: boolean, stats: object}>}
+   */
+  async getActivityStats(applicationId, timeRange = '24h') {
+    return await this.request(
+      'GET',
+      `/api/v1/activity/stats?applicationId=${applicationId}&timeRange=${timeRange}`
+    );
+  }
+
+  /**
+   * Get activity settings for an application
+   * @param {string} applicationId - The application ID
+   * @returns {Promise<object>}
+   */
+  async getActivitySettings(applicationId) {
+    return await this.request('GET', `/api/v1/activity/settings?applicationId=${applicationId}`);
+  }
+
+  /**
+   * Update activity settings for an application
+   * @param {string} applicationId - The application ID
+   * @param {object} settings - Settings to update
+   * @returns {Promise<object>}
+   */
+  async updateActivitySettings(applicationId, settings) {
+    return await this.request('PATCH', '/api/v1/activity/settings', {
+      applicationId,
+      ...settings,
+    });
+  }
+
+  // ============================================
+  // Repository Connection API
+  // ============================================
+
+  /**
+   * Connect a GitHub repository to a connected application
+   * Triggers repo analysis on the platform side
+   * @param {string} applicationId - The application ID
+   * @param {object} repoData - Repository connection data
+   * @param {string} repoData.repoUrl - Full GitHub repo URL
+   * @param {string} repoData.branch - Branch to analyze (e.g., 'main')
+   * @param {string} [repoData.githubConnectionId] - Optional GitHub OAuth connection ID
+   * @returns {Promise<object>}
+   */
+  async connectRepo(applicationId, repoData) {
+    return await this.request(
+      'POST',
+      `/api/v1/cli/applications/${applicationId}/connect-repo`,
+      repoData
+    );
+  }
+
+  /**
+   * Sync project manifest data to the platform
+   * Pushes the .l4yercak3.json content for platform-side analysis
+   * @param {string} applicationId - The application ID
+   * @param {object} manifest - The manifest object from .l4yercak3.json
+   * @returns {Promise<object>}
+   */
+  async syncManifest(applicationId, manifest) {
+    return await this.request(
+      'POST',
+      `/api/v1/cli/applications/${applicationId}/sync-manifest`,
+      manifest
+    );
+  }
 }
 
 module.exports = new BackendClient();

package/src/commands/connect.js

@@ -0,0 +1,243 @@
+/**
+ * Connect Command
+ * Connects the project to the L4YERCAK3 platform by:
+ * 1. Loading the .l4yercak3.json manifest
+ * 2. Registering the app (if not already registered)
+ * 3. Connecting the GitHub repository for platform-side analysis
+ * 4. Writing env vars for platform integration
+ */
+
+const fs = require('fs');
+const path = require('path');
+const configManager = require('../config/config-manager');
+const backendClient = require('../api/backend-client');
+const manifestGenerator = require('../generators/manifest-generator');
+const githubDetector = require('../detectors/github-detector');
+const { generateProjectPathHash } = require('../utils/file-utils');
+const {
+  requireAuth,
+  selectOrganization,
+  generateNewApiKey,
+} = require('../utils/init-helpers');
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+const pkg = require('../../package.json');
+
+async function handleConnect() {
+  requireAuth(configManager);
+
+  console.log(chalk.cyan('  🔗 Connecting project to L4YERCAK3...\n'));
+
+  try {
+    const projectPath = process.cwd();
+
+    // Step 1: Load manifest
+    const manifest = manifestGenerator.loadManifest(projectPath);
+    if (!manifest) {
+      console.log(chalk.yellow('  ⚠️  No .l4yercak3.json manifest found.'));
+      console.log(chalk.gray('     Run "l4yercak3 init" first to scan your project.\n'));
+      process.exit(1);
+    }
+
+    console.log(chalk.green(`  ✅ Loaded manifest (${manifest.framework}, ${manifest.detectedModels?.length || 0} models, ${manifest.detectedRoutes?.length || 0} routes)`));
+
+    // Step 2: Organization selection
+    console.log(chalk.cyan('\n  📦 Organization Setup\n'));
+    const existingConfig = configManager.getProjectConfig(projectPath);
+    let organizationId, organizationName;
+
+    if (existingConfig && existingConfig.organizationId) {
+      console.log(chalk.green(`  ✅ Using organization: ${existingConfig.organizationName || existingConfig.organizationId}`));
+      organizationId = existingConfig.organizationId;
+      organizationName = existingConfig.organizationName;
+    } else {
+      const defaultName = manifest.framework || 'My Organization';
+      const result = await selectOrganization(defaultName);
+      organizationId = result.organizationId;
+      organizationName = result.organizationName;
+    }
+
+    // Step 3: Register application if not already registered
+    let applicationId = existingConfig?.applicationId || null;
+
+    if (!applicationId) {
+      console.log(chalk.cyan('\n  📱 Registering application...\n'));
+      const projectPathHash = generateProjectPathHash(projectPath);
+
+      try {
+        const existingApp = await backendClient.checkExistingApplication(organizationId, projectPathHash);
+
+        if (existingApp.found && existingApp.application) {
+          applicationId = existingApp.application.id;
+          console.log(chalk.green(`  ✅ Found existing registration: ${existingApp.application.name}\n`));
+        } else {
+          const folderName = path.basename(projectPath);
+          const registrationData = {
+            organizationId,
+            name: folderName,
+            description: `Connected via CLI from ${manifest.framework} project`,
+            source: {
+              type: 'cli',
+              projectPathHash,
+              cliVersion: pkg.version,
+              framework: manifest.framework,
+              routerType: manifest.routerType,
+              hasTypeScript: manifest.typescript || false,
+            },
+            connection: {
+              features: [],
+            },
+            deployment: {},
+          };
+
+          const result = await backendClient.registerApplication(registrationData);
+          applicationId = result.applicationId;
+          console.log(chalk.green(`  ✅ Application registered with L4YERCAK3\n`));
+        }
+      } catch (regError) {
+        console.log(chalk.yellow(`  ⚠️  Could not register application: ${regError.message}`));
+        console.log(chalk.gray('     Continuing with GitHub connection...\n'));
+      }
+    } else {
+      console.log(chalk.green(`  ✅ Application already registered (${applicationId})`));
+    }
+
+    // Step 4: API key setup
+    let apiKey = null;
+    const envPath = path.join(projectPath, '.env.local');
+
+    if (fs.existsSync(envPath)) {
+      try {
+        const envContent = fs.readFileSync(envPath, 'utf8');
+        const match = envContent.match(/^L4YERCAK3_API_KEY=(.+)$/m);
+        if (match && match[1] && match[1].startsWith('sk_')) {
+          console.log(chalk.green(`  ✅ API key found in .env.local`));
+        } else {
+          apiKey = await generateNewApiKey(organizationId);
+        }
+      } catch {
+        apiKey = await generateNewApiKey(organizationId);
+      }
+    } else {
+      apiKey = await generateNewApiKey(organizationId);
+    }
+
+    // Step 5: Detect and connect GitHub repository
+    console.log(chalk.cyan('\n  🐙 GitHub Repository Connection\n'));
+    const githubInfo = githubDetector.detect(projectPath);
+
+    if (githubInfo.isGitHub) {
+      console.log(chalk.green(`  ✅ Detected: ${githubInfo.owner}/${githubInfo.repo}`));
+      console.log(chalk.gray(`     Branch: ${githubInfo.branch || 'main'}`));
+      console.log(chalk.gray(`     URL: ${githubInfo.url}\n`));
+
+      const { connectRepo } = await inquirer.prompt([
+        {
+          type: 'confirm',
+          name: 'connectRepo',
+          message: 'Connect this repository to L4YERCAK3 for platform analysis?',
+          default: true,
+        },
+      ]);
+
+      if (connectRepo && applicationId) {
+        try {
+          await backendClient.connectRepo(applicationId, {
+            repoUrl: githubInfo.url,
+            branch: githubInfo.branch || 'main',
+          });
+          console.log(chalk.green('\n  ✅ Repository connected! The platform will analyze your codebase.'));
+          console.log(chalk.gray('     Your app will appear in the builder once analysis completes.\n'));
+        } catch (repoError) {
+          console.log(chalk.yellow(`\n  ⚠️  Could not connect repository: ${repoError.message}`));
+          console.log(chalk.gray('     This feature may not be available yet on the platform.\n'));
+        }
+      } else if (connectRepo && !applicationId) {
+        console.log(chalk.yellow('\n  ⚠️  Cannot connect repo without a registered application.'));
+        console.log(chalk.gray('     Try running "l4yercak3 connect" again after resolving registration.\n'));
+      }
+    } else if (githubInfo.hasGit) {
+      console.log(chalk.yellow('  ⚠️  Git repository detected but not hosted on GitHub.'));
+      console.log(chalk.gray('     GitHub connection is required for platform analysis.\n'));
+    } else {
+      console.log(chalk.yellow('  ⚠️  No git repository detected.'));
+      console.log(chalk.gray('     Initialize a git repo and push to GitHub for platform analysis.\n'));
+    }
+
+    // Step 6: Sync manifest to platform
+    if (applicationId) {
+      try {
+        await backendClient.syncManifest(applicationId, manifest);
+        console.log(chalk.green('  ✅ Manifest synced to platform'));
+      } catch (syncError) {
+        console.log(chalk.yellow(`  ⚠️  Could not sync manifest: ${syncError.message}`));
+        console.log(chalk.gray('     This feature may not be available yet.\n'));
+      }
+    }
+
+    // Step 7: Update .env.local
+    if (apiKey || applicationId || organizationId) {
+      const envVars = {};
+      if (apiKey) envVars.L4YERCAK3_API_KEY = apiKey;
+      if (organizationId) envVars.L4YERCAK3_ORG_ID = organizationId;
+      if (applicationId) envVars.L4YERCAK3_APP_ID = applicationId;
+
+      updateEnvFile(envPath, envVars);
+      console.log(chalk.green('  ✅ Environment variables written to .env.local\n'));
+    }
+
+    // Step 8: Save project config
+    const projectConfig = {
+      ...(existingConfig || {}),
+      organizationId,
+      organizationName,
+      applicationId,
+      projectPathHash: generateProjectPathHash(projectPath),
+      connectedAt: Date.now(),
+      githubRepo: githubInfo.isGitHub ? `${githubInfo.owner}/${githubInfo.repo}` : undefined,
+    };
+
+    configManager.saveProjectConfig(projectPath, projectConfig);
+
+    console.log(chalk.cyan('  🎉 Connection complete!\n'));
+    console.log(chalk.gray('  Next steps:'));
+    console.log(chalk.gray('     • Run "l4yercak3 scaffold" to generate integration files'));
+    console.log(chalk.gray('     • Run "l4yercak3 sync" after changing your project structure\n'));
+
+  } catch (error) {
+    console.error(chalk.red(`\n  ❌ Error: ${error.message}\n`));
+    if (process.env.L4YERCAK3_DEBUG && error.stack) {
+      console.error(chalk.gray(error.stack));
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * Update .env.local file, merging new vars with existing content
+ * @param {string} envPath - Path to .env.local
+ * @param {Object<string, string>} vars - Key-value pairs to set
+ */
+function updateEnvFile(envPath, vars) {
+  let content = '';
+  if (fs.existsSync(envPath)) {
+    content = fs.readFileSync(envPath, 'utf8');
+  }
+
+  for (const [key, value] of Object.entries(vars)) {
+    const regex = new RegExp(`^${key}=.*$`, 'm');
+    if (regex.test(content)) {
+      content = content.replace(regex, `${key}=${value}`);
+    } else {
+      content = `${content.trimEnd()}${content ? '\n' : ''}${key}=${value}\n`;
+    }
+  }
+
+  fs.writeFileSync(envPath, content, 'utf8');
+}
+
+module.exports = {
+  command: 'connect',
+  description: 'Connect your project to the L4YERCAK3 platform',
+  handler: handleConnect,
+};