# GSP Windows Agent Process Management

Workspace reference: [`GSP-WORKSPACE.md`](../../GSP-WORKSPACE.md)

The Windows agent manages customer servers through the Cygwin runtime and the OGP Perl agent.

## Current model

- `OGP64` is the Cygwin root for the maintained launcher
- process state is tracked through the agent runtime and PID files
- configured port validation is handled by `server_status` in `OGP64/OGP/ogp_agent.pl`
- manual startup and shutdown are handled by the root batch scripts
- Windows-specific user and service assumptions belong here, not in the Panel

## Important files

- `OGP64/agent_start.bat`
- `OGP64/agent_stop.bat`
- `OGP64/OGP/ogp_agent.pl`
- `OGP64/OGP/Cfg/`

## Rule

Keep startup and stop behavior visible and explicit. Failures should be reported in the same console when launched manually.

## Port validation

Detailed status validation design:

- [`GSP_WINDOWS_AGENT_PORT_VALIDATION.md`](GSP_WINDOWS_AGENT_PORT_VALIDATION.md)