@veolab/discoverylab 0.1.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,15 @@
+{
+  "name": "veolab-plugins",
+  "owner": {
+    "name": "Anderson Melo"
+  },
+  "plugins": [
+    {
+      "name": "discoverylab",
+      "source": ".",
+      "description": "AI-powered app testing & marketing asset generator",
+      "version": "0.1.0",
+      "keywords": ["app-testing", "maestro", "playwright", "mcp", "mobile", "web", "screenshots"]
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,12 @@
+{
+  "name": "discoverylab",
+  "description": "AI-powered app testing & marketing asset generator",
+  "version": "0.1.0",
+  "author": {
+    "name": "Anderson Melo"
+  },
+  "homepage": "https://github.com/veolab/applab-discovery",
+  "repository": "https://github.com/veolab/applab-discovery",
+  "license": "MIT",
+  "keywords": ["app-testing", "maestro", "playwright", "screenshots", "mcp", "mobile", "web"]
+}

package/.mcp.json

@@ -0,0 +1,6 @@
+{
+  "discoverylab": {
+    "command": "npx",
+    "args": ["-y", "@veolab/discoverylab@latest", "mcp"]
+  }
+}

package/README.md

@@ -0,0 +1,214 @@
+# AppLab Discovery
+
+> AI-Powered App Testing & Marketing Asset Generator
+
+A localhost-first tool for developers that combines automated testing, AI analysis, and marketing asset generation. Distributed as a Claude Code Plugin (MCP Server).
+
+![AppLab Discovery](assets/applab-discovery.jpeg)
+
+## Features
+
+### Core Features
+- **Video Analysis** - Extract frames, OCR text, detect features using Apple Intelligence
+- **3D Mockups** - Professional device mockups (iPhone, Android, Browser)
+- **Text Effects** - Behind-object, title, subtitle overlays
+- **Screen Capture** - Record emulators, windows, or web apps
+- **Maestro Integration** - Automated mobile app testing
+- **Playwright Integration** - Automated web app testing with recording (uses user's Chrome)
+- **Export** - PNG, MP4, GIF with professional quality
+
+### Task Hub
+Centralized task management with external tool integration:
+- **Multiple Links** - Add multiple Jira, Notion, Figma, and GitHub links per project
+- **MCP Metadata Fetch** - Automatically extract ticket keys, page IDs, file info from URLs
+- **AI-Generated Requirements** - Auto-generate requirements from linked sources
+- **Test Map** - AI-generated test checklist with progress tracking
+- **Status Tracking** - Visual indicators for task progress
+
+### LLM Provider Configuration
+Flexible AI backend with multiple provider support:
+- **Anthropic API** - Use your own API key for Claude models
+- **OpenAI API** - GPT-4/5 models support
+- **Ollama** - Local LLM support (llama3, mistral, etc.)
+- **Claude CLI** - Automatic fallback with optimized settings
+- **Model Selection** - Configure specific models per provider in Settings UI
+
+## Installation
+
+### Via Claude Code Plugin Marketplace (Recommended)
+
+```bash
+# Add the marketplace
+/plugin marketplace add veolab/applab-discovery
+
+# Install the plugin
+/plugin install discoverylab@veolab-applab-discovery
+```
+
+The MCP server is automatically configured when you install via the marketplace.
+
+### Via npm (Manual)
+
+```bash
+npm install -g @veolab/discoverylab
+```
+
+Then add to your `~/.claude.json`:
+```json
+{
+  "mcpServers": {
+    "discoverylab": {
+      "command": "npx",
+      "args": ["-y", "@veolab/discoverylab@latest", "mcp"]
+    }
+  }
+}
+```
+
+### Via Bun (Faster)
+
+```bash
+bun add -g @veolab/discoverylab
+```
+
+Then add to your `~/.claude.json`:
+```json
+{
+  "mcpServers": {
+    "discoverylab": {
+      "command": "bunx",
+      "args": ["@veolab/discoverylab", "mcp"]
+    }
+  }
+}
+```
+
+## Usage
+
+### Skills (Slash Commands)
+
+After installing the plugin, use these skills in Claude Code:
+
+| Skill | Description |
+|-------|-------------|
+| `/discoverylab:open-ui` | Open the DiscoveryLab web interface |
+| `/discoverylab:quick-capture` | Quickly capture iOS/Android emulator screen |
+| `/discoverylab:mobile-test` | Full mobile testing workflow with Maestro |
+| `/discoverylab:web-test` | Web testing workflow with Playwright |
+| `/discoverylab:generate-assets` | Generate marketing assets from screenshots |
+| `/discoverylab:task-hub` | Manage links, requirements and test maps |
+
+### CLI Usage
+
+```bash
+# Start localhost UI
+discoverylab serve
+
+# Analyze a video
+discoverylab analyze video.mp4
+
+# Capture emulator
+discoverylab capture --emulator ios
+```
+
+### Natural Language with Claude
+
+```
+# Basic usage
+Use applab to analyze my app recording and generate marketing screenshots
+
+# Task Hub integration
+Add this Jira ticket to my project: https://company.atlassian.net/browse/PROJ-123
+Generate requirements and test map from all my project links
+Show me my test progress for the current project
+
+# Recording
+Start recording my iOS simulator
+Run Maestro tests on my app
+```
+
+### Available MCP Tools
+- **Projects**: `dlab.project.*` - Create, list, manage projects
+- **Task Hub**: `dlab.taskhub.*` - Links, requirements, test maps
+- **Recording**: `dlab.capture.*`, `dlab.maestro.*`, `dlab.playwright.*`
+- **Export**: `dlab.notion.*`, `dlab.drive.*`, `dlab.jira.*`
+
+## Requirements
+
+- **Node.js 20+**
+- **FFmpeg** (for video export)
+- **Maestro CLI** (optional, for mobile testing)
+- **Playwright** (optional, for web testing)
+
+## Platform Compatibility
+
+| Feature | macOS | Windows | Linux |
+|---------|-------|---------|-------|
+| Web UI | Full | Full | Full |
+| Video Upload & Analysis | Full | Full | Full |
+| Grid Composer | Full | Full | Full |
+| PNG/Image Export | Full | Full | Full |
+| Vision OCR (Apple Intelligence) | Full | Fallback* | Fallback* |
+| iOS Simulator Capture | Full | N/A | N/A |
+| Android Emulator Capture | Full | Full | Full |
+| Playwright Web Testing | Full | Full | Full |
+| Maestro Mobile Testing | Full | Full | Full |
+
+*Fallback: Uses Tesseract.js for OCR when Apple Vision is unavailable.
+
+### macOS (Recommended)
+Full functionality including iOS Simulator capture and Apple Intelligence Vision OCR.
+
+### Windows / Linux
+Most features work with some limitations:
+- iOS Simulator capture requires macOS
+- Vision OCR falls back to Tesseract.js
+- Android Emulator and Playwright work normally
+
+## API Endpoints
+
+### Task Hub Endpoints
+
+```
+PUT  /api/projects/:id/links     - Update project links (legacy + taskHubLinks)
+POST /api/mcp/fetch              - Fetch metadata from a single URL
+POST /api/mcp/fetch-batch        - Fetch metadata from multiple URLs
+POST /api/ai/generate-task-info  - Generate requirements and test map from links
+POST /api/projects/sync-orphans  - Sync orphan directories from disk to database
+```
+
+### Recording Endpoints
+
+```
+POST   /api/mobile/record/start  - Start Maestro mobile recording
+POST   /api/mobile/record/stop   - Stop and process mobile recording
+POST   /api/web/record/start     - Start Playwright web recording (uses user's Chrome)
+POST   /api/web/record/stop      - Stop and process web recording
+DELETE /api/recordings/:id       - Delete a recording with cascade cleanup
+```
+
+### LLM Settings Endpoints
+
+```
+GET  /api/settings/llm           - Get LLM provider settings (API keys masked)
+POST /api/settings/llm           - Update LLM provider settings
+GET  /api/ollama/status          - Check Ollama server status and available models
+GET  /api/mobile-chat/providers  - Get available chat providers for mobile testing
+POST /api/mobile-chat            - Send chat message during mobile testing session
+```
+
+## Documentation
+
+See [CLAUDE.md](./CLAUDE.md) for Claude Code specific instructions.
+
+## License
+
+MIT - See LICENSE file
+
+## Credits
+
+Built with:
+- Three.js (3D mockups)
+- Remotion (video rendering)
+- Apple Vision & NaturalLanguage frameworks
+- Claude MCP SDK

package/assets/icons/apple-logo.svg

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?><!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
+<svg fill="#000000" width="800px" height="800px" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+<path d="M18.71 19.5C17.88 20.74 17 21.95 15.66 21.97C14.32 22 13.89 21.18 12.37 21.18C10.84 21.18 10.37 21.95 9.09997 22C7.78997 22.05 6.79997 20.68 5.95997 19.47C4.24997 17 2.93997 12.45 4.69997 9.39C5.56997 7.87 7.12997 6.91 8.81997 6.88C10.1 6.86 11.32 7.75 12.11 7.75C12.89 7.75 14.37 6.68 15.92 6.84C16.57 6.87 18.39 7.1 19.56 8.82C19.47 8.88 17.39 10.1 17.41 12.63C17.44 15.65 20.06 16.66 20.09 16.67C20.06 16.74 19.67 18.11 18.71 19.5ZM13 3.5C13.73 2.67 14.94 2.04 15.94 2C16.07 3.17 15.6 4.35 14.9 5.19C14.21 6.04 13.07 6.7 11.95 6.61C11.8 5.46 12.36 4.26 13 3.5Z"/>
+</svg>

package/assets/icons/claude-ai-icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" shape-rendering="geometricPrecision" text-rendering="geometricPrecision" image-rendering="optimizeQuality" fill-rule="evenodd" clip-rule="evenodd" viewBox="0 0 512 509.64"><path fill="#D77655" d="M115.612 0h280.775C459.974 0 512 52.026 512 115.612v278.415c0 63.587-52.026 115.612-115.613 115.612H115.612C52.026 509.639 0 457.614 0 394.027V115.612C0 52.026 52.026 0 115.612 0z"/><path fill="#FCF2EE" fill-rule="nonzero" d="M142.27 316.619l73.655-41.326 1.238-3.589-1.238-1.996-3.589-.001-12.31-.759-42.084-1.138-36.498-1.516-35.361-1.896-8.897-1.895-8.34-10.995.859-5.484 7.482-5.03 10.717.935 23.683 1.617 35.537 2.452 25.782 1.517 38.193 3.968h6.064l.86-2.451-2.073-1.517-1.618-1.517-36.776-24.922-39.81-26.338-20.852-15.166-11.273-7.683-5.687-7.204-2.451-15.721 10.237-11.273 13.75.935 3.513.936 13.928 10.716 29.749 23.027 38.848 28.612 5.687 4.727 2.275-1.617.278-1.138-2.553-4.271-21.13-38.193-22.546-38.848-10.035-16.101-2.654-9.655c-.935-3.968-1.617-7.304-1.617-11.374l11.652-15.823 6.445-2.073 15.545 2.073 6.547 5.687 9.655 22.092 15.646 34.78 24.265 47.291 7.103 14.028 3.791 12.992 1.416 3.968 2.449-.001v-2.275l1.997-26.641 3.69-32.707 3.589-42.084 1.239-11.854 5.863-14.206 11.652-7.683 9.099 4.348 7.482 10.716-1.036 6.926-4.449 28.915-8.72 45.294-5.687 30.331h3.313l3.792-3.791 15.342-20.372 25.782-32.227 11.374-12.789 13.27-14.129 8.517-6.724 16.1-.001 11.854 17.617-5.307 18.199-16.581 21.029-13.75 17.819-19.716 26.54-12.309 21.231 1.138 1.694 2.932-.278 44.536-9.479 24.062-4.347 28.714-4.928 12.992 6.066 1.416 6.167-5.106 12.613-30.71 7.583-36.018 7.204-53.636 12.689-.657.48.758.935 24.164 2.275 10.337.556h25.301l47.114 3.514 12.309 8.139 7.381 9.959-1.238 7.583-18.957 9.655-25.579-6.066-59.702-14.205-20.474-5.106-2.83-.001v1.694l17.061 16.682 31.266 28.233 39.152 36.397 1.997 8.999-5.03 7.102-5.307-.758-34.401-25.883-13.27-11.651-30.053-25.302-1.996-.001v2.654l6.926 10.136 36.574 54.975 1.895 16.859-2.653 5.485-9.479 3.311-10.414-1.895-21.408-30.054-22.092-33.844-17.819-30.331-2.173 1.238-10.515 113.261-4.929 5.788-11.374 4.348-9.478-7.204-5.03-11.652 5.03-23.027 6.066-30.052 4.928-23.886 4.449-29.674 2.654-9.858-.177-.657-2.173.278-22.37 30.71-34.021 45.977-26.919 28.815-6.445 2.553-11.173-5.789 1.037-10.337 6.243-9.2 37.257-47.392 22.47-29.371 14.508-16.961-.101-2.451h-.859l-98.954 64.251-17.618 2.275-7.583-7.103.936-11.652 3.589-3.791 29.749-20.474-.101.102.024.101z"/></svg>

package/dist/chunk-7IDQLLBW.js

@@ -0,0 +1,311 @@
+import {
+  createJsonResult,
+  createTextResult
+} from "./chunk-QJXXHOV7.js";
+import {
+  DATA_DIR,
+  DB_PATH
+} from "./chunk-VY3BLXBW.js";
+
+// src/mcp/tools/setup.ts
+import { z } from "zod";
+import { execSync } from "child_process";
+import { existsSync } from "fs";
+import { platform, homedir } from "os";
+var dependencies = [
+  {
+    name: "FFmpeg",
+    command: "ffmpeg -version",
+    versionPattern: /ffmpeg version (\d+\.\d+(?:\.\d+)?)/,
+    required: true,
+    description: "Video processing and export",
+    installHint: "brew install ffmpeg (macOS) or apt install ffmpeg (Linux)"
+  },
+  {
+    name: "Maestro CLI",
+    command: "",
+    // Special handling - check multiple paths
+    versionPattern: /(\d+\.\d+\.\d+)/,
+    required: false,
+    description: "Mobile app testing automation",
+    installHint: 'curl -Ls "https://get.maestro.mobile.dev" | bash'
+  },
+  {
+    name: "Playwright",
+    command: "npx playwright --version",
+    versionPattern: /(\d+\.\d+\.\d+)/,
+    required: false,
+    description: "Web app testing and browser automation",
+    installHint: "npm install -g playwright"
+  },
+  {
+    name: "Xcode CLI Tools",
+    command: "xcode-select -p",
+    versionPattern: /.*/,
+    required: false,
+    description: "iOS Simulator access (macOS only)",
+    installHint: "xcode-select --install"
+  },
+  {
+    name: "ADB",
+    command: "adb version",
+    versionPattern: /Android Debug Bridge version (\d+\.\d+\.\d+)/,
+    required: false,
+    description: "Android Emulator access",
+    installHint: "Install Android Studio or: brew install android-platform-tools"
+  }
+];
+function checkDependency(dep) {
+  if (dep.name === "Maestro CLI") {
+    return checkMaestro(dep);
+  }
+  try {
+    const output = execSync(dep.command, { encoding: "utf-8", timeout: 5e3 }).trim();
+    const match = output.match(dep.versionPattern);
+    return {
+      installed: true,
+      version: match ? match[1] || "installed" : "installed"
+    };
+  } catch (error) {
+    return {
+      installed: false,
+      version: null,
+      error: error instanceof Error ? error.message : "Command failed"
+    };
+  }
+}
+function checkMaestro(dep) {
+  const homeDir = homedir();
+  const maestroPaths = [
+    `${homeDir}/.maestro/bin/maestro`,
+    "/usr/local/bin/maestro",
+    "/opt/homebrew/bin/maestro"
+  ];
+  try {
+    const output = execSync("maestro --version 2>/dev/null || maestro version 2>/dev/null", {
+      encoding: "utf-8",
+      timeout: 5e3,
+      shell: "/bin/bash"
+    }).trim();
+    const match = output.match(dep.versionPattern);
+    return {
+      installed: true,
+      version: match ? match[1] : "installed"
+    };
+  } catch {
+  }
+  for (const maestroPath of maestroPaths) {
+    if (existsSync(maestroPath)) {
+      try {
+        const output = execSync(`"${maestroPath}" --version 2>/dev/null || "${maestroPath}" version 2>/dev/null`, {
+          encoding: "utf-8",
+          timeout: 5e3,
+          shell: "/bin/bash"
+        }).trim();
+        const match = output.match(dep.versionPattern);
+        return {
+          installed: true,
+          version: match ? match[1] : "installed"
+        };
+      } catch {
+        return {
+          installed: true,
+          version: "installed"
+        };
+      }
+    }
+  }
+  return {
+    installed: false,
+    version: null,
+    error: "Maestro not found in PATH or common installation directories"
+  };
+}
+var setupStatusTool = {
+  name: "dlab.setup.status",
+  description: "Check the status of DiscoveryLab setup and all dependencies.",
+  inputSchema: z.object({}),
+  handler: async () => {
+    const results = [];
+    let allRequiredInstalled = true;
+    for (const dep of dependencies) {
+      if (dep.name === "Xcode CLI Tools" && platform() !== "darwin") {
+        continue;
+      }
+      const status = checkDependency(dep);
+      results.push({
+        name: dep.name,
+        installed: status.installed,
+        version: status.version,
+        required: dep.required,
+        description: dep.description,
+        installHint: status.installed ? null : dep.installHint
+      });
+      if (dep.required && !status.installed) {
+        allRequiredInstalled = false;
+      }
+    }
+    const dataReady = existsSync(DATA_DIR);
+    const dbReady = existsSync(DB_PATH);
+    return createJsonResult({
+      ready: allRequiredInstalled && dataReady,
+      platform: platform(),
+      dataDirectory: {
+        path: DATA_DIR,
+        exists: dataReady
+      },
+      database: {
+        path: DB_PATH,
+        exists: dbReady
+      },
+      dependencies: results,
+      summary: {
+        total: results.length,
+        installed: results.filter((r) => r.installed).length,
+        missing: results.filter((r) => !r.installed).length,
+        requiredMissing: results.filter((r) => r.required && !r.installed).map((r) => r.name)
+      }
+    });
+  }
+};
+var setupCheckTool = {
+  name: "dlab.setup.check",
+  description: "Quick check if a specific tool is installed.",
+  inputSchema: z.object({
+    tool: z.enum(["ffmpeg", "maestro", "playwright", "xcode", "adb"]).describe("Tool to check")
+  }),
+  handler: async (params) => {
+    const toolMap = {
+      ffmpeg: dependencies[0],
+      maestro: dependencies[1],
+      playwright: dependencies[2],
+      xcode: dependencies[3],
+      adb: dependencies[4]
+    };
+    const dep = toolMap[params.tool];
+    if (!dep) {
+      return createTextResult(`Unknown tool: ${params.tool}`);
+    }
+    const status = checkDependency(dep);
+    if (status.installed) {
+      return createTextResult(`${dep.name} is installed (version: ${status.version})`);
+    } else {
+      return createTextResult(`${dep.name} is NOT installed.
+Install with: ${dep.installHint}`);
+    }
+  }
+};
+var setupInitTool = {
+  name: "dlab.setup.init",
+  description: "Initialize DiscoveryLab data directories and database.",
+  inputSchema: z.object({}),
+  handler: async () => {
+    try {
+      const { getDatabase, DATA_DIR: DATA_DIR2, PROJECTS_DIR, EXPORTS_DIR, FRAMES_DIR } = await import("./db-IWIL65EX.js");
+      getDatabase();
+      return createJsonResult({
+        message: "DiscoveryLab initialized successfully",
+        directories: {
+          data: DATA_DIR2,
+          projects: PROJECTS_DIR,
+          exports: EXPORTS_DIR,
+          frames: FRAMES_DIR
+        }
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Initialization failed";
+      return createTextResult(`Error: ${message}`);
+    }
+  }
+};
+var setupInstallTool = {
+  name: "dlab.setup.install",
+  description: "Get installation commands for missing DiscoveryLab dependencies. Claude should run these commands after user approval.",
+  inputSchema: z.object({
+    tool: z.enum(["all", "ffmpeg", "maestro", "playwright", "xcode", "adb"]).optional().describe("Specific tool to install (default: all missing)")
+  }),
+  handler: async (params) => {
+    const toolToInstall = params.tool || "all";
+    const installCommands = [];
+    const isMac = platform() === "darwin";
+    if (toolToInstall === "all" || toolToInstall === "ffmpeg") {
+      const status = checkDependency(dependencies[0]);
+      if (!status.installed) {
+        installCommands.push({
+          name: "FFmpeg",
+          command: isMac ? "brew install ffmpeg" : "sudo apt install -y ffmpeg",
+          description: "Required for video processing and export"
+        });
+      }
+    }
+    if (toolToInstall === "all" || toolToInstall === "maestro") {
+      const status = checkDependency(dependencies[1]);
+      if (!status.installed) {
+        installCommands.push({
+          name: "Maestro CLI",
+          command: 'curl -Ls "https://get.maestro.mobile.dev" | bash',
+          description: "Mobile app testing automation"
+        });
+      }
+    }
+    if (toolToInstall === "all" || toolToInstall === "playwright") {
+      const status = checkDependency(dependencies[2]);
+      if (!status.installed) {
+        installCommands.push({
+          name: "Playwright",
+          command: "npm install -g playwright && npx playwright install",
+          description: "Web app testing and browser automation"
+        });
+      }
+    }
+    if (isMac && (toolToInstall === "all" || toolToInstall === "xcode")) {
+      const status = checkDependency(dependencies[3]);
+      if (!status.installed) {
+        installCommands.push({
+          name: "Xcode CLI Tools",
+          command: "xcode-select --install",
+          description: "Required for iOS Simulator access"
+        });
+      }
+    }
+    if (toolToInstall === "all" || toolToInstall === "adb") {
+      const status = checkDependency(dependencies[4]);
+      if (!status.installed) {
+        installCommands.push({
+          name: "ADB (Android Debug Bridge)",
+          command: isMac ? "brew install android-platform-tools" : "sudo apt install -y adb",
+          description: "Required for Android Emulator access"
+        });
+      }
+    }
+    if (installCommands.length === 0) {
+      return createTextResult(
+        toolToInstall === "all" ? "\u2705 All dependencies are already installed!" : `\u2705 ${toolToInstall} is already installed!`
+      );
+    }
+    const instructions = installCommands.map(
+      (cmd, i) => `${i + 1}. **${cmd.name}** (${cmd.description})
+   \`\`\`bash
+   ${cmd.command}
+   \`\`\``
+    ).join("\n\n");
+    return createTextResult(
+      `## Missing Dependencies
+
+Please run the following commands to install missing dependencies:
+
+` + instructions + `
+
+*Run these commands one at a time and verify each installation before proceeding.*`
+    );
+  }
+};
+var setupTools = [setupStatusTool, setupCheckTool, setupInitTool, setupInstallTool];
+
+export {
+  setupStatusTool,
+  setupCheckTool,
+  setupInitTool,
+  setupInstallTool,
+  setupTools
+};

package/dist/chunk-MLKGABMK.js

@@ -0,0 +1,9 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+export {
+  __export
+};