npm - mcp-maestro-mobile-ai - Versions diffs - 1.1.0 - Mend

mcp-maestro-mobile-ai 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (25) hide show

package/CHANGELOG.md +114 -0
package/CONTRIBUTING.md +417 -0
package/LICENSE +22 -0
package/README.md +719 -0
package/ROADMAP.md +239 -0
package/docs/ENTERPRISE_READINESS.md +545 -0
package/docs/MCP_SETUP.md +180 -0
package/docs/PRIVACY.md +198 -0
package/docs/REACT_NATIVE_AUTOMATION_GUIDELINES.md +584 -0
package/docs/SECURITY.md +573 -0
package/package.json +69 -0
package/prompts/example-login-tests.txt +9 -0
package/prompts/example-youtube-tests.txt +8 -0
package/src/mcp-server/index.js +625 -0
package/src/mcp-server/tools/contextTools.js +194 -0
package/src/mcp-server/tools/promptTools.js +191 -0
package/src/mcp-server/tools/runTools.js +357 -0
package/src/mcp-server/tools/utilityTools.js +721 -0
package/src/mcp-server/tools/validateTools.js +220 -0
package/src/mcp-server/utils/appContext.js +295 -0
package/src/mcp-server/utils/logger.js +52 -0
package/src/mcp-server/utils/maestro.js +508 -0
package/templates/mcp-config-claude-desktop.json +15 -0
package/templates/mcp-config-cursor.json +15 -0
package/templates/mcp-config-vscode.json +13 -0

package/ROADMAP.md ADDED Viewed

@@ -0,0 +1,239 @@
+# Roadmap
+> **Maestro MCP Server** - Product Roadmap
+This document outlines the planned development trajectory for Maestro MCP. Items are subject to change based on community feedback and priorities.
+---
+## Vision
+**Make mobile test automation accessible to everyone through natural language.**
+Transform how teams approach mobile testing by enabling:
+- Non-technical testers to write effective tests
+- Rapid test creation without learning new syntax
+- AI-assisted debugging and maintenance
+- Enterprise-grade reliability and security
+---
+## Release Timeline
+```
+2025 Q1          2025 Q2          2025 Q3          2025 Q4
+   │                │                │                │
+   ▼                ▼                ▼                ▼
+┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐
+│ v1.x     │   │ v2.x     │   │ v3.x     │   │ v4.x     │
+│ Security │   │ Platform │   │ Scale    │   │ Enterprise│
+│ & CI     │   │ & Quality│   │ & Perf   │   │ Features │
+└──────────┘   └──────────┘   └──────────┘   └──────────┘
+```
+---
+## Q1 2025: Security & CI Foundation
+**Theme**: Enterprise Trust & Automation
+### v1.1.0 - Security Boundaries
+| Feature | Priority | Status |
+|---------|----------|--------|
+| Safe Mode (default ON) | 🔴 Critical | 🔲 Planned |
+| Command allowlist | 🔴 Critical | 🔲 Planned |
+| Blocked operations list | 🔴 Critical | 🔲 Planned |
+| Input validation (Zod schemas) | 🟠 High | 🔲 Planned |
+### v1.2.0 - CI/CD Mode
+| Feature | Priority | Status |
+|---------|----------|--------|
+| `--ci` headless mode | 🔴 Critical | 🔲 Planned |
+| Exit codes (0/1/2) | 🔴 Critical | 🔲 Planned |
+| `--prompt-file` direct execution | 🟠 High | 🔲 Planned |
+| JUnit XML output | 🟠 High | 🔲 Planned |
+### v1.3.0 - Audit & Observability
+| Feature | Priority | Status |
+|---------|----------|--------|
+| Enhanced audit trail | 🟠 High | 🔲 Planned |
+| YAML preservation | 🟠 High | 🔲 Planned |
+| Structured logging (JSON) | 🟡 Medium | 🔲 Planned |
+| Health check tool | 🟡 Medium | 🔲 Planned |
+---
+## Q2 2025: Platform & Quality
+**Theme**: Cross-Platform & Reliability
+### v2.0.0 - iOS Support
+| Feature | Priority | Status |
+|---------|----------|--------|
+| iOS device detection | 🔴 Critical | 🔲 Planned |
+| iOS app installation check | 🔴 Critical | 🔲 Planned |
+| iOS screenshot capture | 🟠 High | 🔲 Planned |
+| Cross-platform test definitions | 🟠 High | 🔲 Planned |
+### v2.1.0 - TypeScript Migration
+| Feature | Priority | Status |
+|---------|----------|--------|
+| Full TypeScript conversion | 🟠 High | 🔲 Planned |
+| Type definitions (.d.ts) | 🟠 High | 🔲 Planned |
+| Strict mode enabled | 🟡 Medium | 🔲 Planned |
+### v2.2.0 - Test Quality
+| Feature | Priority | Status |
+|---------|----------|--------|
+| Unit test suite (80% coverage) | 🟠 High | 🔲 Planned |
+| Integration tests | 🟠 High | 🔲 Planned |
+| E2E test framework | 🟡 Medium | 🔲 Planned |
+---
+## Q3 2025: Scale & Performance
+**Theme**: Speed & Flexibility
+### v3.0.0 - Parallel Execution
+| Feature | Priority | Status |
+|---------|----------|--------|
+| Parallel test execution | 🟠 High | 🔲 Planned |
+| Multi-device orchestration | 🟠 High | 🔲 Planned |
+| Load distribution | 🟡 Medium | 🔲 Planned |
+### v3.1.0 - Reporting
+| Feature | Priority | Status |
+|---------|----------|--------|
+| HTML report generation | 🟠 High | 🔲 Planned |
+| Allure integration | 🟡 Medium | 🔲 Planned |
+| Test history & trends | 🟡 Medium | 🔲 Planned |
+| Flaky test detection | 🟡 Medium | 🔲 Planned |
+### v3.2.0 - Extensibility
+| Feature | Priority | Status |
+|---------|----------|--------|
+| Plugin/hook system | 🟡 Medium | 🔲 Planned |
+| Custom tool registration | 🟡 Medium | 🔲 Planned |
+| Event webhooks | 🟡 Medium | 🔲 Planned |
+---
+## Q4 2025: Enterprise Features
+**Theme**: Enterprise Scale & Governance
+### v4.0.0 - Governance
+| Feature | Priority | Status |
+|---------|----------|--------|
+| RBAC (Role-Based Access) | 🟠 High | 🔲 Planned |
+| Configuration governance | 🟠 High | 🔲 Planned |
+| Audit log export | 🟡 Medium | 🔲 Planned |
+### v4.1.0 - Integrations
+| Feature | Priority | Status |
+|---------|----------|--------|
+| Slack notifications | 🟡 Medium | 🔲 Planned |
+| Teams notifications | 🟡 Medium | 🔲 Planned |
+| Jira integration | 🟡 Medium | 🔲 Planned |
+| TestRail integration | 🟢 Low | 🔲 Planned |
+### v4.2.0 - Web Dashboard (Optional)
+| Feature | Priority | Status |
+|---------|----------|--------|
+| Web-based dashboard | 🟡 Medium | 🔲 Planned |
+| Visual test management | 🟡 Medium | 🔲 Planned |
+| Real-time execution view | 🟢 Low | 🔲 Planned |
+---
+## 2026 and Beyond
+### Exploration Areas
+| Area | Description |
+|------|-------------|
+| **Visual Testing** | Screenshot comparison, visual regression |
+| **AI Improvements** | Smarter selector generation, self-healing tests |
+| **Cloud Execution** | Optional cloud device farms |
+| **Multi-tenant SaaS** | Managed service offering |
+| **Cross-platform** | Flutter, Xamarin, native support |
+---
+## Priority Legend
+| Priority | Meaning |
+|----------|---------|
+| 🔴 Critical | Required for enterprise adoption |
+| 🟠 High | Significantly improves value |
+| 🟡 Medium | Good to have |
+| 🟢 Low | Nice to have |
+## Status Legend
+| Status | Meaning |
+|--------|---------|
+| ✅ Done | Released |
+| 🔄 In Progress | Currently being developed |
+| 🔲 Planned | Scheduled for development |
+| 💭 Considering | Under evaluation |
+---
+## How to Influence the Roadmap
+### Feature Requests
+1. Open a [GitHub Issue](https://github.com/krunal-mahera/mcp-maestro-mobile-ai/issues)
+2. Use the "Feature Request" template
+3. Describe the use case and expected behavior
+4. Vote (👍) on existing requests
+### Priority Feedback
+- Enterprise customers can prioritize features
+- Community votes influence scheduling
+- Security issues always take priority
+---
+## Completed Milestones
+### ✅ v1.0.0 - Foundation (January 2025)
+- [x] MCP server implementation
+- [x] 14 core tools
+- [x] Device management
+- [x] Result storage
+- [x] Retry mechanism
+- [x] Pre-flight checks
+- [x] npm publication
+---
+## Disclaimer
+This roadmap represents current intentions and is subject to change. Features may be added, removed, or rescheduled based on:
+- Community feedback
+- Technical constraints
+- Resource availability
+- Market conditions
+---
+*Last Updated: January 2025*