@forvibe/cli 0.1.0

package/dist/report-generator-NMGCGKPS.js

@@ -0,0 +1,168 @@
+// src/ai/report-generator.ts
+import { GoogleGenerativeAI } from "@google/generative-ai";
+var SYSTEM_PROMPT = `You are a senior mobile app analyst and App Store Optimization specialist. You will receive technical data about a mobile application project including its tech stack, dependencies, config files, README, project file tree, and source code excerpts.
+
+Your job is to deeply analyze the project and produce a comprehensive structured JSON analysis report.
+
+## ANALYSIS APPROACH \u2014 THINK LIKE A DETECTIVE:
+1. Study the PROJECT FILE TREE carefully. Directory names like "screens/", "models/", "services/", "pages/" reveal the app's architecture. File names like "plant_detail.dart", "watering_schedule.dart", "shop_screen.dart" reveal features.
+2. Read the SOURCE CODE thoroughly. Look for: screen/page names, navigation routes, data models, API calls, UI components, business logic, state management patterns.
+3. Cross-reference the README (if available) with actual code to understand the app's purpose.
+4. Even if the source code is minimal (e.g., a new project), infer the app's intent from naming conventions, file structure, bundle ID, and any available context.
+
+## DESCRIPTION REQUIREMENTS \u2014 THIS IS CRITICAL:
+The "description" field must be a DETAILED, RICH description of 4-8 sentences that:
+- Explains what the app does and its core purpose
+- Describes the main features and user experience
+- Mentions the target use case (e.g., "helps plant lovers track watering schedules")
+- Notes any notable technical aspects (e.g., "uses real-time syncing", "leverages AI")
+- If code is minimal, infer from app name, bundle ID, file structure, and README. NEVER leave this empty.
+- Write as if you're explaining the app to someone who has never seen it. Be specific, not generic.
+
+## KEY FEATURES REQUIREMENTS:
+- List 5-10 specific features you can identify from the code, file tree, and README
+- Each feature should be a clear, descriptive phrase (e.g., "Plant watering schedule with customizable reminders" NOT just "Scheduling")
+- Infer features from file names, screen names, model classes, and navigation structure
+- If you see a "shop" screen, there's a shopping feature. If you see "notification", there's push notifications. Etc.
+
+## UNIQUE SELLING POINTS:
+- 3-5 points that make this app stand out
+- Be specific based on actual features found in the code
+
+## RESPONSE RULES:
+- Respond ONLY with a valid JSON object, no markdown, no explanation
+- All string values must be non-empty \u2014 NEVER return empty strings
+- app_type must be one of: game, health, finance, ecommerce, education, media, utility, social, other
+- advertising_type must be one of: personalized, non_personalized, none
+- business_model.model must be one of: free, paid, freemium
+- business_model.purchase_type must be one of: one_time, subscription, both, none
+- app_category_suggestion should be an App Store category name (e.g., "Photo & Video", "Productivity", "Health & Fitness", "Lifestyle")
+- target_audience should be a 2-3 sentence description of who would use this app and why`;
+function buildUserPrompt(input) {
+  const parts = [];
+  parts.push(`## Tech Stack
+- Framework: ${input.techStack.label}
+- Platforms: ${input.techStack.platforms.join(", ")}
+- Config files found: ${input.techStack.configFiles.join(", ")}`);
+  parts.push(`## Project Configuration
+- App Name: ${input.config.app_name || "Unknown"}
+- Bundle ID: ${input.config.bundle_id || "Unknown"}
+- Version: ${input.config.version || "Unknown"}
+- Min iOS: ${input.config.min_ios_version || "N/A"}
+- Min Android SDK: ${input.config.min_android_sdk || "N/A"}
+- Description from config: ${input.config.description || "N/A"}`);
+  if (input.projectTree) {
+    parts.push(`## Project File Tree (IMPORTANT \u2014 analyze directory and file names to understand the app's features and architecture)
+${input.projectTree}`);
+  }
+  if (input.sdkScan.detected_sdks.length > 0) {
+    parts.push(`## Detected SDKs (${input.sdkScan.detected_sdks.length})
+${input.sdkScan.detected_sdks.map((sdk) => `- ${sdk.name} (${sdk.category})`).join("\n")}
+
+Data collected: ${input.sdkScan.data_collected.join(", ") || "none detected"}
+Advertising type: ${input.sdkScan.advertising_type}
+Has in-app purchases: ${input.sdkScan.has_iap}`);
+  } else {
+    parts.push(`## Detected SDKs
+No known SDKs detected in dependencies. Determine data collection and business model from source code analysis.`);
+  }
+  if (input.readmeContent) {
+    parts.push(`## README Content (USE THIS to understand the app's purpose)
+${input.readmeContent.substring(0, 8e3)}`);
+  }
+  if (input.sourceCode) {
+    parts.push(`## Source Code Excerpts (ANALYZE CAREFULLY \u2014 look for screens, routes, models, features, API calls)
+${input.sourceCode.substring(0, 4e4)}`);
+  }
+  parts.push(`## Required JSON Response Format
+{
+  "description": "4-8 sentence detailed description covering: what the app does, main features, target use case, and notable aspects. MUST be specific and non-empty.",
+  "app_type": "one of: game, health, finance, ecommerce, education, media, utility, social, other",
+  "is_for_children": false,
+  "app_category_suggestion": "App Store category name (e.g. Lifestyle, Health & Fitness, Productivity)",
+  "key_features": ["Detailed feature 1", "Detailed feature 2", "...up to 10 specific features found in code/tree"],
+  "target_audience": "2-3 sentences describing who would use this app and why",
+  "unique_selling_points": ["Specific USP 1", "Specific USP 2", "...3-5 items"],
+  "business_model": {
+    "model": "free | paid | freemium",
+    "purchase_type": "one_time | subscription | both | none",
+    "has_trial": false,
+    "has_auto_renewal": false
+  }
+}`);
+  return parts.join("\n\n");
+}
+async function generateReport(input, apiKey) {
+  const genAI = new GoogleGenerativeAI(apiKey);
+  const model = genAI.getGenerativeModel({
+    model: "gemini-2.5-flash",
+    generationConfig: {
+      temperature: 0.4,
+      responseMimeType: "application/json"
+    }
+  });
+  const userPrompt = buildUserPrompt(input);
+  const result = await model.generateContent([
+    { text: SYSTEM_PROMPT },
+    { text: userPrompt }
+  ]);
+  const responseText = result.response.text();
+  let aiAnalysis;
+  try {
+    aiAnalysis = JSON.parse(responseText);
+  } catch {
+    const jsonMatch = responseText.match(/\{[\s\S]*\}/);
+    const rawJson = jsonMatch ? jsonMatch[0] : responseText;
+    try {
+      const cleaned = rawJson.replace(/,\s*([}\]])/g, "$1").replace(
+        /[\x00-\x1F\x7F]/g,
+        (ch) => ch === "\n" || ch === "\r" || ch === "	" ? ch : ""
+      );
+      aiAnalysis = JSON.parse(cleaned);
+    } catch {
+      throw new Error("Failed to parse AI response as JSON");
+    }
+  }
+  const report = {
+    // Basic identification
+    app_name: input.config.app_name || "Unknown App",
+    bundle_id: input.config.bundle_id || "com.unknown.app",
+    description: aiAnalysis.description || input.config.description || "",
+    platforms: input.techStack.platforms,
+    tech_stack: input.techStack.label,
+    min_os_versions: {
+      ios: input.config.min_ios_version || void 0,
+      android: input.config.min_android_sdk || void 0
+    },
+    version: input.config.version || "1.0.0",
+    // Legal/Privacy from SDK scan + AI
+    app_type: aiAnalysis.app_type || "utility",
+    is_for_children: aiAnalysis.is_for_children || false,
+    data_collected: input.sdkScan.data_collected,
+    advertising_type: input.sdkScan.advertising_type,
+    third_party_services: input.sdkScan.third_party_services,
+    business_model: {
+      model: aiAnalysis.business_model?.model || "free",
+      purchase_type: aiAnalysis.business_model?.purchase_type || (input.sdkScan.has_iap ? "subscription" : "none"),
+      has_trial: aiAnalysis.business_model?.has_trial,
+      has_auto_renewal: aiAnalysis.business_model?.has_auto_renewal
+    },
+    // ASO
+    app_category_suggestion: aiAnalysis.app_category_suggestion || "Utilities",
+    key_features: aiAnalysis.key_features || [],
+    target_audience: aiAnalysis.target_audience || "",
+    unique_selling_points: aiAnalysis.unique_selling_points || [],
+    // Branding
+    primary_color: input.branding.primary_color || "#007AFF",
+    secondary_color: input.branding.secondary_color || "#5856D6",
+    app_icon_base64: input.branding.app_icon_base64,
+    // Raw data
+    detected_sdks: input.sdkScan.detected_sdks,
+    readme_content: input.readmeContent,
+    config_files_found: input.techStack.configFiles
+  };
+  return report;
+}
+export {
+  generateReport
+};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@forvibe/cli",
+  "version": "0.1.0",
+  "description": "Forvibe CLI - AI-powered project analyzer for App Store automation",
+  "type": "module",
+  "bin": {
+    "forvibe": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts --format esm --watch",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build",
+    "release": "npm run build && npm publish --access public",
+    "release:dry": "npm run build && npm publish --access public --dry-run"
+  },
+  "keywords": [
+    "forvibe",
+    "app-store",
+    "aso",
+    "cli",
+    "ai",
+    "automation"
+  ],
+  "author": "Forvibe",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Forvibe/cli.git"
+  },
+  "homepage": "https://forvibe.com",
+  "bugs": {
+    "url": "https://github.com/Forvibe/cli/issues"
+  },
+  "dependencies": {
+    "@google/generative-ai": "^0.24.0",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "ora": "^8.2.0",
+    "plist": "^3.1.0",
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.0",
+    "@types/plist": "^3.0.5",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ]
+}