[fivetran-paulharper]

---

Stack

• main
  • Add CI with unit and integration tests for the install and management scripts #13
    • Pin the plain agent version in the version file #12
    • feat(windows): honor HTTPS_PROXY, HTTP_PROXY and NO_PROXY in PowerShell scripts #14
    • Add a doctor command to the management scripts #16 👈

[Copilot]

🟡 Changes recommended

Fallback report filenames can collide within the same second, causing overwritten or truncated diagnostics in both scripts and file-sharing failures that prevent PowerShell doctor runs from starting.

1 open issue

• Use a unique fallback report filename for each invocation · New

What changed in this PR

Adds a doctor command to both management scripts, allowing installation and connectivity checks in a separate container without stopping the running agent.

Changes:

• Reuses the agent’s configuration, log mounts, and memory limit while forwarding doctor options and preserving its exit code.
• Saves doctor logs and archives on the host, with captured output as a fallback.
• Adds unit and integration coverage and documents command usage.

File	Description
tests/​stub/​heartbeat.sh	Simulates doctor output, artifacts, and failure on Linux.
tests/​stub/​heartbeat.ps1	Simulates doctor behavior in Windows containers.
tests/​pwsh/​Manager.Tests.ps1	Tests PowerShell doctor arguments, logging, and agent isolation.
tests/​integration/​windows.ps1	Verifies doctor artifacts, output, and exit status on Windows.
tests/​integration/​linux.sh	Verifies doctor artifacts, output, and exit status on Linux.
tests/​bash/​stubs/​docker	Adds configurable doctor behavior to the Docker stub.
tests/​bash/​manager.bats	Tests Bash doctor execution and fallback logging.
README.md	Documents doctor usage, saved diagnostics, and test coverage.
proxy-agent-manager.sh	Implements doctor execution and shared container arguments in Bash.
proxy-agent-manager.ps1	Implements doctor execution and shared container arguments in PowerShell.

_{Review effort: Balanced}