ACB System Diagnostics

This skill checks if the user's system meets the minimum specifications for Anypoint Code Builder and applies necessary Windows optimizations.

Minimum Specifications

CPU: 8 cores/8 vCPU
RAM: 32GB
Storage Type: NVMe SSD (PCIe 3.0+)
Free Disk Space: 50GB
Network Speed: 1Gbps

Steps

Step 1: Detect Operating System

Identify if the user is on Windows, macOS, or Linux

Step 2: Gather System Information

CPU: Number of cores/vCPUs
RAM: Total memory in GB
Storage Type: Verify the storage uses NVMe standard (must be NVMe, not SATA SSD or HDD)
Free Disk Space: Available space in GB
Network Speed: Network interface speed

For Windows systems, use these PowerShell commands:

CPU & RAM Info: powershell.exe -Command "Get-ComputerInfo | Select-Object CsProcessors, CsTotalPhysicalMemory, OsArchitecture"
Logical Processors: powershell.exe -Command "(Get-WmiObject -Class Win32_Processor).NumberOfLogicalProcessors"
Storage Info: powershell.exe -Command "Get-PhysicalDisk | Select-Object MediaType, BusType, Size, FriendlyName"
Disk Space: powershell.exe -Command "Get-PSDrive C | Select-Object Used, Free"
Network Speed: powershell.exe -Command "Get-NetAdapter | Select-Object Name, Status, LinkSpeed"

For macOS systems, use these commands:

CPU Cores: sysctl -n hw.physicalcpu && sysctl -n hw.logicalcpu
- Returns physical and logical cores (use logical for comparison)
RAM: sysctl -n hw.memsize
- Returns bytes, divide by 1073741824 to get GB
Disk Space: df -h /
- Shows total, used, and available disk space
Storage Type (NVMe): system_profiler SPNVMeDataType
- Shows NVMe SSD details including model, capacity, and TRIM support
Network Hardware: networksetup -listallhardwareports
- Lists all network interfaces
Wi-Fi Status: ifconfig en0 | grep 'status:' && networksetup -getinfo Wi-Fi
- Shows if Wi-Fi is active and configuration details
Wi-Fi PHY Mode: system_profiler SPAirPortDataType | grep -A 10 "Current Network Information" | grep -E "Link Speed|PHY Mode"
- Shows Wi-Fi standard (802.11ax = Wi-Fi 6, etc.)

Step 3: Compare Against Minimum Specifications

For each component, indicate if it meets (✓) or fails (✗) the minimum requirement
IMMEDIATELY after gathering system info, display a clear summary table showing:
- Component
- Current Value
- Minimum Required
- Status (Pass/Fail)
Do not wait until the end of the skill to show this table

Step 4: Windows-Specific Optimizations

(only if on Windows)

A. IOPS Performance Test

Locate DiskSpd executable:
- Detect the processor architecture (amd64, arm64, or x86)
- Use the appropriate diskspd.exe from the skill's assets folder (relative to the skill base directory):
  - For amd64: {skill_base_directory}/assets/DiskSpd/amd64/diskspd.exe
  - For arm64: {skill_base_directory}/assets/DiskSpd/arm64/diskspd.exe
  - For x86: {skill_base_directory}/assets/DiskSpd/x86/diskspd.exe
- If the DiskSpd assets folder or the required diskspd.exe is missing, download and extract it:
  - Before downloading, inform the user in one concise sentence what is being downloaded and why, e.g. "Fetching Microsoft's DiskSpd utility from the official GitHub release to benchmark your disk's IOPS performance."
  - Download URL: https://github.com/microsoft/diskspd/releases/download/v2.2/DiskSpd.ZIP
  - Target location: {skill_base_directory}/assets/DiskSpd/
  - Use PowerShell to download and extract:
```
$target = "{skill_base_directory}/assets/DiskSpd"
$zip = Join-Path $env:TEMP "DiskSpd.ZIP"
New-Item -ItemType Directory -Force -Path $target | Out-Null
Invoke-WebRequest -Uri "https://github.com/microsoft/diskspd/releases/download/v2.2/DiskSpd.ZIP" -OutFile $zip -UseBasicParsing
Expand-Archive -Path $zip -DestinationPath $target -Force
Remove-Item $zip -Force
```
  - After extraction, verify that diskspd.exe exists under the architecture-specific subfolder (amd64, arm64, or x86)
  - If the download fails (no network, proxy issues, etc.), inform the user clearly, provide the download URL, and skip the IOPS test rather than failing the whole skill
Create Test File:
- Command: diskspd.exe -c1G testfile.dat
- This creates a 1GB test file required for IOPS testing
- Note: DiskSpd requires a pre-existing file to test against
Run Random Read IOPS Test:
- Command: diskspd.exe -b4K -d30 -o32 -t4 -r -w0 -Sh testfile.dat
- This tests random read IOPS with 4KB blocks for 30 seconds
- Requirement: ≥10,000 IOPS
Run Random Write IOPS Test:
- Command: diskspd.exe -b4K -d30 -o32 -t4 -r -w100 -Sh testfile.dat
- This tests random write IOPS with 4KB blocks for 30 seconds
- Requirement: ≥8,000 IOPS
Parse and Display Results:
- Extract the IOPS values from the DiskSpd output
- Compare against minimum requirements:
  - Random Read: 10,000 IOPS minimum
  - Random Write: 8,000 IOPS minimum
- IMMEDIATELY display a table with the read and write IOPS result and Pass/Fail status
- If tests fail, provide guidance on storage improvements
Clean up:
- Delete the testfile.dat after testing

B. Microsoft Defender Exclusions

First, check current exclusions:
- Use PowerShell to check existing process exclusions: Get-MpPreference | Select-Object -ExpandProperty ExclusionProcess
- Use PowerShell to check existing path exclusions: Get-MpPreference | Select-Object -ExpandProperty ExclusionPath
- Detect the current user's username dynamically
- Compare current exclusions against recommended exclusions:
  - Process exclusions: java.exe, javaw.exe, node.exe, Code.exe
  - Path exclusions (use current username):
    - C:\Users\<USERNAME>\AnypointCodeBuilder
    - C:\Users\<USERNAME>\.vscode
    - C:\Users\<USERNAME>\.m2
    - C:\Users\<USERNAME>\AppData\Local\Temp
Determine what's missing:
- Identify which processes are NOT already excluded
- Identify which paths are NOT already excluded
- If all exclusions already exist, inform the user and skip this step
Ask for user permission (only if exclusions are missing):
- Show the user which specific files/paths are not yet excluded
- Explain why these exclusions improve ACB performance (reduces scanning overhead)
- Ask if the user wants to add the missing exclusions
- Allow the user to decline
Apply exclusions (only if user agrees):
- Run PowerShell commands to add missing exclusions:
  - Use Add-MpPreference -ExclusionProcess for executables
  - Use Add-MpPreference -ExclusionPath for directories
- Handle admin privilege errors:
  - If commands fail due to insufficient privileges, catch the error
  - Inform the user they need administrator privileges
  - Provide the exact commands they should ask their admin to run
  - Do not show scary error messages, just explain clearly what's needed

C. Power Plan Analysis

Check the current active power plan using: powershell.exe -Command "powercfg /getactivescheme"
Display the current power plan to the user
Analyze if the current power plan is sufficient for ACB:
- High Performance: ✓ Optimal for ACB - no change needed
- Balanced: ⚠ May impact ACB performance - recommend switching to High Performance
- Power Saver: ✗ Not recommended for ACB - strongly recommend switching to High Performance
If the current plan is not High Performance:
- Explain why High Performance is recommended for ACB
- Ask the user if they want to switch to High Performance
- Provide the command: powercfg /setactive SCHEME_MIN (requires admin)
- Allow the user to skip this step if they choose
If the current plan is already High Performance, inform the user and skip this step

Step 5: Output Format

Present findings in a clear, formatted table
For Windows systems, provide clear status of optimization steps
For power plan: display current plan, provide analysis, and ask for user confirmation before making changes
If admin privileges are required, inform the user and provide the exact commands they need to run
If any specification is not met, highlight it clearly and suggest potential solutions
Respect user choices to skip optional optimization steps

Important Notes

Windows optimizations require administrator privileges
Always verify system information before making changes
Provide clear feedback on what was checked and what actions were taken
For non-Windows systems (macOS, Linux), do NOT mention Windows-specific optimizations at all