Prepare AdbPureFlow for Windows verification

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,33 +1,35 @@
 ---
 name: Bug Report
-about: Create a report to help us improve ADBPureFlow
+about: Create a report to help us improve AdbPureFlow
 title: '[BUG] '
 labels: bug
 assignees: ''
 
 ---
 
 **Describe the bug**
-A clear and concise description of what the bug is.
+A clear and concise description of what happened.
 
 **To Reproduce**
 Steps to reproduce the behavior:
-1. Open ADBPureFlow (GUI or CLI) on platform '[e.g. Windows/macOS/Linux]'
-2. Connect device '[e.g. Pixel 7]'
-3. Drag and drop APK file '[or specify other action]'
-4. See error: [e.g. "Installation failed" or log output]
+1. Open AdbPureFlow on Windows '[e.g. Windows 11 23H2]'
+2. Connect/select device '[e.g. Pixel 7 over USB, Android 15]'
+3. Open workspace/action '[e.g. Screen → Start Mirror, Apps → Clear Data, Deploy]'
+4. See error/status: [paste the user-facing message]
 
 **Expected behavior**
 A clear and concise description of what you expected to happen.
 
-**Screenshots/Logs**
-If applicable, add screenshots or paste the logs from the ADBPureFlow Log Area / terminal console to help explain your problem.
+**Diagnostics / logs**
+Please run **Diagnostics** in AdbPureFlow and paste relevant user-facing messages plus expandable technical details. If the issue involves Logs, include the filtered/raw logcat rows that matter.
 
-**Environment (please complete the following information):**
-- OS: [e.g. macOS Sonoma, Windows 11, Ubuntu 24.04]
-- Go Version: [e.g. 1.21]
-- Connected Android Device & OS Version: [e.g. Samsung Galaxy S23, Android 14]
-- ADBPureFlow Version: [e.g. v5.0.0]
+**Environment**
+- OS: [e.g. Windows 11]
+- AdbPureFlow version: [e.g. dev build hash or release version]
+- Android device and version: [e.g. Samsung Galaxy S23, Android 14]
+- Connection type: [USB / Wireless debugging]
+- ADB source: [AdbPureFlow-provisioned / Android platform-tools on PATH / unknown]
+- scrcpy source if relevant: [AdbPureFlow-provisioned / PATH / unknown]
 
 **Additional context**
 Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,23 +1,23 @@
 ---
 name: Feature Request
-about: Suggest an idea or enhancement for ADBPureFlow
+about: Suggest a focused AdbPureFlow improvement
 title: '[FEATURE] '
 labels: enhancement
 assignees: ''
 
 ---
 
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+**What workflow would this improve?**
+Choose one: Devices / Wireless Debugging / Screen / APK / Apps / Logs / Deploy / Workflows / Diagnostics / Windows Integration / Other.
 
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen. How would this feature work?
+**Describe the problem**
+What Android device-management or development task is currently difficult?
 
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
+**Describe the proposed solution**
+What should AdbPureFlow let the user do without requiring manual ADB/scrcpy commands?
 
-**How does this fit the project scope?**
-Why is this enhancement important to the broader ADBPureFlow developer community?
+**Windows-native expectations**
+If this touches files, windows, notifications, clipboard, Explorer, shortcuts, or settings, describe the expected Windows behavior.
 
-**Additional context**
-Add any other context, mockup designs, or screenshots about the feature request here.
+**Technical notes**
+If you know the relevant ADB/scrcpy/Android behavior, include it here. Please avoid proposals that only add decorative UI without a reliable underlying operation.

.gitignore

@@ -0,0 +1,20 @@
+# Build outputs
+*.exe
+*.dll
+*.so
+*.dylib
+/dist/
+/build/
+/out/
+
+# Runtime-provisioned Android tools
+adb_engine/
+scrcpy_core/
+**/adb_engine/
+**/scrcpy_core/
+
+# Temporary archives and logs
+*.zip
+*.tar.gz
+*.log
+.adbpureflow/

CHANGELOG.md

@@ -1,41 +1,32 @@
 # Changelog
 
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
----
-
-## [5.0.0] - 2026-08-04
-
-### Added
-- **Full Cross-Platform Support:** Refactored both CLI and GUI setups to automatically download, identify, and configure platform tools (ADB, Scrcpy) for macOS, Linux, and Windows, rather than forcing Windows-specific `.exe` tools.
-- **Zip & Tar Slip Preventions:** Patched major security loopholes in file decompression helpers in both CLI and GUI backends, preventing directory traversal vulnerabilities.
-- **Modernized Landing Page:** Completely redesigned the static website interface into an ultra-modern dark/light mode dashboard with a live browser-based simulator.
-- **Robust Multi-Platform CI/CD Pipeline:** Fully configured a GitHub Actions pipeline compiling both Go Fyne GUI and Go CLI binaries, verifying format compliance, running test coverage, and publishing tagged releases automatically.
-- **Detailed Unit Testing:** Wrote initial test suites with mocking mechanisms covering string package parsing and directory indexing.
+## Unreleased
 
 ### Changed
-- Improved error feedback on ADB download interruptions, missing permissions, and non-existent APK file targets.
-- Cleaned up obsolete platform tool dependencies and redundant legacy files.
 
----
-
-## [4.0.0] - 2026-03-12
+- Repositioned AdbPureFlow as a Windows-first native Android device management and development workstation.
+- Reworked the GUI from a single APK installer window into a device-centric shell with Devices, Screen, Apps, Logs, Deploy, Workflows, Diagnostics, and Help workspaces.
+- Introduced typed domain models and a process-runner abstraction for ADB/scrcpy operations.
+- Rewrote documentation to match the desktop product direction.
 
 ### Added
-- Integrated basic support for launching screen mirroring using `scrcpy`.
-- Developed interactive desktop panel utilizing the Fyne toolkit.
-
-### Fixed
-- Fixed critical directory lookup bugs for device selection.
-
----
 
-## [1.0.0] - 2025-11-20
-
-### Added
-- Initial release of the CLI utility.
-- Basic drag-and-drop mechanics for installing `.apk` packages over USB.
-- Core automated package identity-verifications using before-and-after state snapshots.
+- Real wireless debugging pairing-code workflow using `adb pair` and `adb connect`.
+- Device enrichment for manufacturer, model, Android version, SDK, battery, screen size, and storage where available.
+- Managed scrcpy lifecycle, mirror options, and screenshot capture through native Save File dialogs.
+- APK inspection with zip validation, SHA-256, size, and optional `aapt` badging metadata.
+- Apps workspace with searchable user-app list and actions for launch, force-stop, clear data, and uninstall.
+- Logs workspace with live `logcat` streaming, filtering, pause/resume, and clear behavior.
+- Deploy workflow backed by an extensible Flow engine.
+- Diagnostics/Doctor checks for ADB, ADB server, devices/authorization, and scrcpy.
+- First-launch onboarding and Help & Tutorials content.
+- Windows build helper script with SHA-256 checksum output.
+- Persistent non-sensitive app state in per-user config storage.
+- Removed checked-in executable/platform-tools artifacts; runtime tools are now provisioned/discovered and ignored by Git.
+- Passive device monitor, strict package/address validation, deterministic selected-device reconciliation, bounded log buffering, log stop/level filtering, deploy cancellation, screen recording entry point, clipboard actions, theme setting, device aliases, wireless reconnect/forget actions, screenshot file-manager handoff, and hardened Windows build script.
+- Manual Windows smoke test, real-device test matrix, troubleshooting bundle, release checklist, and Windows release README template.
+
+### Retained
+
+- Legacy CLI helper remains available during migration.
+- ADB and scrcpy auto-provisioning retain archive traversal protections.