Add visual testing framework and refactor progress bar analysis (#63)

* feat(visual-testing): Add visual testing framework for azd progress bars

- Introduced a comprehensive visual testing suite to capture terminal outputs at various widths.
- Implemented scripts for capturing outputs, running Playwright tests, and generating reports.
- Created HTML renderer for terminal outputs and integrated ANSI color support.
- Added metadata generation for captured outputs and duplicate detection logic.
- Developed a visual comparison page to facilitate easy inspection of results.
- Included troubleshooting steps and common tasks in documentation for user guidance.

* Remove outdated visual testing documentation and add comprehensive port manager configuration and visual testing architecture details

* docs: Add terminal display information for progress bars in CLI reference

* Refactor visual testing suite into progress bar analysis framework

- Removed visual testing documentation and related files (quick-start.md, architecture.md, server.js, terminal.html).
- Updated metadata.json to reflect new capture filenames and timestamps.
- Renamed package.json to reflect new purpose and updated dependencies.
- Simplified playwright.config.ts by removing unnecessary configurations.
- Modified run-visual-tests.ps1 to focus on analysis rather than visual testing.
- Updated progress-bars.spec.ts to analyze terminal outputs instead of rendering them visually.
- Introduced new helper functions for resource management in service/helpers.go.
- Implemented WebSocket health monitoring in dashboard/websocket.go.
- Enhanced security measures in portmanager and validation files.
- Streamlined logging across the application for consistency and clarity.
- Improved performance by removing browser dependencies and reducing test execution time.
- Added comprehensive refactoring summary in refactoring-depstable.md.

Author: jongio

.gitignore

@@ -103,6 +103,7 @@ tests/**/.azure/cache/
 tests/projects/node/test-pnpm-project/azure.yaml
 tests/projects/python/test-uv-project/azure.yaml
 tests/projects/aspire-test/azure.yaml
+
 cli2/jongio.azd.app/build.ps1
 cli2/jongio.azd.app/build.sh
 cli2/jongio.azd.app/changelog.md

cli/README.md

@@ -356,25 +356,24 @@ azd-app-extension/
 │       └── azure/
 
 ├── docs/                       # Documentation
-│   ├── cli-reference.md
-│   ├── environment-variables.md
-│   ├── environment-variables-quick-reference.md
-│   ├── commands/
+│   ├── cli-reference.md       # User-facing: CLI reference
+│   ├── environment-variables.md # User-facing: Environment variable configuration
+│   ├── ports.md               # User-facing: Port configuration
+│   ├── commands/              # User-facing: Command documentation
 │   │   ├── reqs.md
 │   │   ├── deps.md
 │   │   ├── run.md
 │   │   ├── logs.md
 │   │   ├── info.md
 │   │   └── version.md
-│   ├── dev/
+│   ├── schema/                # User-facing: Schema documentation
+│   │   └── azure.yaml.md
+│   ├── dev/                   # Developer-only: Internal implementation docs
 │   │   ├── azd-context-inheritance.md
-│   │   ├── environment-variables.md
 │   │   ├── testing.md
 │   │   └── release.md
-│   ├── design/
-│   │   └── ports.md
-│   └── schema/
-│       └── azure.yaml.md
+│   └── design/                # Developer-only: Design documents
+│       └── ports.md
 ├── .github/
 │   └── workflows/
 │       ├── ci.yml              # CI pipeline

cli/docs/cli-reference.md

@@ -8,6 +8,10 @@ All commands automatically inherit azd environment context when run through `azd
 
 See [dev/azd-context-inheritance.md](dev/azd-context-inheritance.md) for details on accessing azd environment variables.
 
+### Terminal Display
+
+Progress bars automatically adapt to terminal width. Narrow terminals (<70 columns) use compact mode to prevent line wrapping.
+
 ### Global Flags
 
 These flags are available for all commands:

cli/docs/commands/deps.md

@@ -21,7 +21,12 @@ azd app deps
 
 ### Flags
 
-This command has no additional flags. It automatically detects and installs dependencies for all projects.
+| Flag | Short | Type | Default | Description |
+|------|-------|------|---------|-------------|
+| `--verbose` | `-v` | bool | `false` | Show full installation output |
+| `--clean` | | bool | `false` | Remove existing dependencies before installing (clears node_modules, .venv, etc.) |
+| `--no-cache` | | bool | `false` | Force fresh dependency installation and bypass cached results |
+| `--force` | `-f` | bool | `false` | Force clean reinstall (combines --clean and --no-cache) |
 
 ## Execution Flow
 

cli/docs/commands/version.md

@@ -59,17 +59,18 @@ Example: 0.5.1
 
 ```bash
 $ azd app version
-azd app extension version 0.5.1
+azd app extension
+Version: 0.5.1
+Built: 2024-11-04T10:00:00Z
 ```
 
-### JSON Output (future)
+### JSON Output
 
 ```bash
 $ azd app version --output json
 {
   "version": "0.5.1",
-  "commit": "abc1234",
-  "buildDate": "2024-11-04T10:00:00Z"
+  "buildTime": "2024-11-04T10:00:00Z"
 }
 ```
 
@@ -79,7 +80,9 @@ $ azd app version --output json
 
 ```bash
 $ azd app version
-azd app extension version 0.5.1
+azd app extension
+Version: 0.5.1
+Built: 2024-11-04T10:00:00Z
 ```
 
 ### 2. Verify Installation
@@ -89,7 +92,9 @@ $ which azd-app
 /usr/local/bin/azd-app
 
 $ azd app version
-azd app extension version 0.5.1
+azd app extension
+Version: 0.5.1
+Built: 2024-11-04T10:00:00Z
 ```
 
 ### 3. Troubleshooting
@@ -98,7 +103,9 @@ When reporting issues, include version information:
 
 ```bash
 $ azd app version
-azd app extension version 0.5.1
+azd app extension
+Version: 0.5.1
+Built: 2024-11-04T10:00:00Z
 
 # Include in bug report
 ```
@@ -114,7 +121,9 @@ azd version 1.5.0
 
 # Check azd app version
 $ azd app version
-azd app extension version 0.5.1
+azd app extension
+Version: 0.5.1
+Built: 2024-11-04T10:00:00Z
 ```
 
 ## Version Compatibility
@@ -146,7 +155,9 @@ The extension is designed to be compatible with:
 
 ```bash
 $ azd app version
-azd app extension version 0.5.1
+azd app extension
+Version: 0.5.1
+Built: 2024-11-04T10:00:00Z
 ```
 
 ### Example 2: In Scripts
@@ -170,5 +181,7 @@ echo "Using azd app version: $VERSION"
 ```bash
 $ azd version && azd app version
 azd version 1.5.0
-azd app extension version 0.5.1
+azd app extension
+Version: 0.5.1
+Built: 2024-11-04T10:00:00Z
 ```