perfgate-adapters 0.4.1

Process execution and host probing adapters for perfgate
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

# perfgate-adapters


Infrastructure adapters for process execution and host probing.

## Responsibilities


- Runs benchmark commands through `StdProcessRunner` and `ProcessRunner`.
- Captures wall-clock timing, exit code, timeout status, and capped stdout/stderr.
- Collects process metrics when available:
  - Unix: `cpu_ms`, `max_rss_kb`, `page_faults`, `ctx_switches` (via `wait4`/`rusage`)
  - Windows: best-effort `cpu_ms` and `max_rss_kb`
- Probes host info via `StdHostProbe` (`os`, `arch`, CPU count, memory, optional hostname hash).
- Provides `FakeProcessRunner` for deterministic tests.

## Platform Notes


- Unix supports command timeouts.
- Windows currently returns `AdapterError::TimeoutUnsupported` if timeout is requested.
- Other platforms run without timeout support and with limited metrics.

## Boundaries


- No policy or threshold logic.
- No markdown/report rendering.
- No CLI argument parsing.

## Workspace Role


`perfgate-adapters` is the "touch the world" layer used by application use-cases:

`perfgate-types` + `perfgate-domain` + `perfgate-adapters` -> `perfgate-app`

## License


Licensed under either Apache-2.0 or MIT.