# GSP Windows Agent

Cygwin-based packaging tree for the GSP Windows agent. The maintained runtime lives under `OGP64/`, which contains the Cygwin environment, the bundled OGP Perl agent, startup scripts, and supporting files.

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

## What this repository owns

- Windows/Cygwin agent packaging
- startup and stop scripts
- bundled runtime files for the OGP Perl agent
- Windows-specific installation and update helpers
- Windows agent documentation

## Runtime model

The Windows agent mirrors the Linux agent as closely as practical while using Cygwin to provide the command and process model expected by the OGP Perl agent.

## Important paths

| Path | Purpose |
| --- | --- |
| `OGP64/` | Cygwin root and runtime bundle |
| `OGP64/OGP/ogp_agent.pl` | Core Windows agent Perl service |
| `OGP64/agent_start.bat` | Root launcher used to start the agent manually |
| `OGP64/agent_stop.bat` | Root launcher used to stop the agent manually |
| `OGP64/OGP/Cfg/` | Runtime config and template files |

## Documentation entry points

- [`docs/AGENT_ARCHITECTURE.md`](docs/AGENT_ARCHITECTURE.md)
- [`docs/CYGWIN_INTEGRATION.md`](docs/CYGWIN_INTEGRATION.md)
- [`docs/COMMAND_EXECUTION.md`](docs/COMMAND_EXECUTION.md)
- [`docs/GSP_WINDOWS_AGENT_PORT_VALIDATION.md`](docs/GSP_WINDOWS_AGENT_PORT_VALIDATION.md)
- [`docs/PROCESS_MANAGEMENT.md`](docs/PROCESS_MANAGEMENT.md)
- [`docs/PANEL_INTEGRATION.md`](docs/PANEL_INTEGRATION.md)

## Related documentation

- [`OGP64/OGP/README.md`](OGP64/OGP/README.md)
- [`OGP64/OGP/documentation/agent-guide.md`](OGP64/OGP/documentation/agent-guide.md)