prompttest-mobile 1.5.1

package/CONTRIBUTING.md

@@ -0,0 +1,80 @@
+# Contributing to PromptTest
+
+Thank you for your interest in contributing to **PromptTest**!
+
+PromptTest is an ultra-fast, zero-code autonomous mobile testing & visual QA brain designed for Android. We welcome contributions from the community.
+
+---
+
+## 🚀 Getting Started
+
+1. **Fork and Clone the Repository**:
+
+   ```bash
+   git clone https://github.com/<your-username>/prompttest.git
+   cd prompttest
+   ```
+
+2. **Install Dependencies**:
+
+   ```bash
+   npm install
+   ```
+
+3. **Verify Build**:
+
+   ```bash
+   npm run build
+   ```
+
+4. **Connect an Android Device or Emulator**:
+   Ensure `adb` is in your system PATH and run:
+   ```bash
+   npm run devices
+   ```
+
+---
+
+## 🛠 Project Structure
+
+- `bin/prompttest.ts`: CLI entry point and command router (`run`, `explore`, `status`, `devices`).
+- `lib/adb.ts`: High-performance ADB driver for fast XML hierarchy dumping, input dispatching, and screenshot capture.
+- `lib/prompt-runner.ts`: Core test execution engine with expectation-driven polling, auto-scroll triage, and collision disambiguation.
+- `lib/patterns.ts`: Plain-English DSL parser and step tokenizers.
+- `lib/memory.ts`: Persistent autonomous knowledge engine and fast-forward cache.
+- `lib/dictionary.ts`: Standard UI component vocabulary and intent mapping heuristics.
+- `lib/crawler.ts` & `lib/explorer.ts`: Autonomous screen exploration and dynamic component graph discovery.
+- `lib/reporter.ts`: Markdown & JSON QA test report generator with visual blackbox capture.
+- `specs/`: Sample test spec files written in plain English.
+
+---
+
+## 📝 Adding New Prompt Grammar / Verbs
+
+If you want to introduce a new plain-English command:
+
+1. Update `PromptStepType` and parser regex in [`lib/patterns.ts`](lib/patterns.ts).
+2. Add execution handler in `PromptRunner.executeStep()` inside [`lib/prompt-runner.ts`](lib/prompt-runner.ts).
+3. Add corresponding unit or integration tests in `specs/`.
+
+---
+
+## 🧪 Testing Guidelines
+
+Before opening a pull request:
+
+1. Ensure TypeScript compiles with zero errors:
+   ```bash
+   npm run build
+   ```
+2. Test against a connected Android device or emulator:
+   ```bash
+   npm run test:teacher
+   ```
+3. Keep code modular, universal (no hardcoded application-specific coordinates or package IDs), and well-documented.
+
+---
+
+## 📄 Code of Conduct & Licensing
+
+By contributing, you agree that your contributions will be licensed under the project's [MIT License](LICENSE).

package/LICENSE

@@ -0,0 +1,42 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:
+PromptTest (Shriram Singh)
+
+Licensed Work:
+PromptTest (including its command-line interface, autonomous state-graph exploration engine,
+heuristic gesture systems, and programmatic SDK), in source code, binary, and bundled distribution forms.
+
+Additional Use Grant:
+You may use the Licensed Work free of charge for:
+1. Non-commercial, educational, academic, and open-source purposes.
+2. Personal and evaluation use.
+3. Internal software testing within organizations that have an annual gross revenue of less
+   than $100,000 USD (or equivalent) and fewer than 10 employees.
+
+Commercial License Requirement:
+Any use within organizations exceeding the revenue or employee threshold, any use by testing
+agencies providing commercial QA services to third-party clients, or any deployment into production
+commercial CI/CD pipelines requires a commercial license from the Licensor.
+
+Hosting & Managed Service Restriction:
+You may not provide the Licensed Work, whether modified or unmodified, as a hosted service,
+managed QA service, or cloud testing platform to third parties without prior written consent.
+
+Change Date:
+2030-09-14
+
+Change License:
+Apache License, Version 2.0
+
+Notice:
+For commercial licensing inquiries, enterprise agreements, or custom SLAs, contact:
+PromptTest (https://github.com/shriramsingh/promptTest)
+
+Scope Notice:
+This License applies solely to the Licensed Work identified above (the PromptTest
+command-line interface, SDK, and associated engine). PromptTest Studio and any other
+PromptTest-branded products or services are separate products governed by their own
+license agreements and are NOT licensed under this License.

package/LICENSES.md

@@ -0,0 +1,81 @@
+# Open Source Software Licenses & Bill of Materials (SBOM)
+
+PromptTest is licensed under the [Business Source License 1.1 (BSL 1.1)](LICENSE).
+
+This document catalogs third-party dependencies utilized by PromptTest, their licenses, and compliance attestations.
+
+---
+
+## License Compliance Attestation
+
+- **Zero Copyleft / Zero GPL**: PromptTest does **not** link against or distribute any code licensed under GPL, LGPL, AGPL, or other reciprocal copyleft licenses.
+- **Enterprise Friendly**: All runtime dependencies use widely accepted permissive licenses (MIT, ISC, Apache-2.0), making PromptTest safe for commercial and proprietary enterprise deployments.
+
+---
+
+## Production Runtime Dependencies
+
+| Package        | Version  | License | Primary Purpose                                | Home / Repository                    |
+| :------------- | :------- | :------ | :--------------------------------------------- | :----------------------------------- |
+| **chalk**      | `^5.3.0` | MIT     | Terminal colorization and CLI styling          | https://github.com/chalk/chalk       |
+| **pixelmatch** | `^7.2.0` | ISC     | Visual pixel-by-pixel regression image diffing | https://github.com/mapbox/pixelmatch |
+| **pngjs**      | `^7.0.0` | MIT     | PNG image encoding and decoding                | https://github.com/lukeapage/pngjs   |
+
+---
+
+## Development & Build Dependencies
+
+| Package                 | Version    | License    | Purpose                               |
+| :---------------------- | :--------- | :--------- | :------------------------------------ |
+| **typescript**          | `^5.7.2`   | Apache-2.0 | Static type checking and compiler     |
+| **vitest**              | `^5.0.0`   | MIT        | Fast unit and integration test runner |
+| **eslint**              | `^10.10.0` | MIT        | Code quality and lint analysis        |
+| **prettier**            | `^3.9.6`   | MIT        | Opinionated code formatter            |
+| **tsx**                 | `^4.19.2`  | MIT        | TypeScript execution engine           |
+| **@vitest/coverage-v8** | `^5.0.0`   | MIT        | V8 code coverage provider             |
+| **typescript-eslint**   | `^8.70.0`  | MIT        | TypeScript ESLint tooling             |
+| **@types/node**         | `^22.10.2` | MIT        | Node.js TypeScript definitions        |
+| **@types/pixelmatch**   | `^5.2.6`   | MIT        | Pixelmatch TypeScript definitions     |
+| **@types/pngjs**        | `^6.0.5`   | MIT        | PNGjs TypeScript definitions          |
+
+---
+
+## Full License Texts
+
+### MIT License
+
+```text
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+### ISC License
+
+```text
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+```