42 lines (31 loc) · 1.33 KB

Troubleshooting

SmartScreen Warning

ThreadPilot releases are currently unsigned. Windows SmartScreen may warn before first launch.

What to do:

Verify the installer hash using SHA256SUMS.txt from the release page.
Open file Properties and check the downloaded path/source.
Use "More info" then "Run anyway" only after verification.

UAC Prompt and Elevation

ThreadPilot requires administrator privileges at startup.

What to do:

Launch ThreadPilot and approve the UAC prompt.
If elevation is denied, restart and approve elevation.
For startup automation, ensure the launch task runs with highest privileges.

WMI Errors or Delayed Process Detection

If WMI is unavailable or slow, process event monitoring can degrade.

What to do:

Ensure the Windows Management Instrumentation service is running.
Reboot if repository consistency is suspected to be corrupted.
Keep fallback polling enabled (default behavior).

Performance Counter Access Denied

Some performance counters may fail on restricted systems.

What to do:

Run with elevated privileges.
Ensure Performance Logs and Alerts services are healthy.
Validate that perflib counters are enabled on the machine.

Smoke Test Command

For CI or local validation:

ThreadPilot.exe --smoke-test

Exit code 0 means startup wiring and DI resolution succeeded.