Compute expected build outputs for a configuration. Args: repo_root: Repository root. configuration: Visual Studio configuration.

Parse a text architecture report. Args: lines: Captured report lines. expected_platform: Optional platform to use when the report

Get the next line, or `None` if the stream ended. Args: timeout_seconds: Maximum time to wait. Returns: A li

Normalize a Visual Studio solution platform option. Args: value: User-provided platform name. Returns: A supported platform

Resolve MSBuild from an explicit path, PATH, or common Visual Studio installs. Args: explicit: Optional user-provided MSBuild path.

Normalize an acceptance harness mode option. Args: value: User-provided acceptance mode. Returns: A supported acceptance mod

Create a generic timer/re-entry artifact layout. Args: repo_root: Repository root. configuration: Visual Studio configuration.

Write a minimal PE-shaped file. Args: path: Output path. machine: IMAGE_FILE_MACHINE value. Returns: Output path.

Convert Typer's optional path value into a resolved path when present. Args: value: Optional CLI path. Returns: A resolved p

Return a friendly PE machine name. Args: machine: Numeric IMAGE_FILE_MACHINE value. Returns: Known PE machine name or a hexa

Return the Visual Studio solution platform spelling for MSBuild. Args: platform_name: Canonical harness platform. Returns: M

Normalize a Visual Studio configuration option. Args: value: User-provided configuration name. Returns: A supported configur

Return the expected native pointer width for a platform. Args: platform_name: Canonical harness platform. Returns: Expected

Resolve NASM from PATH or the standard winget install directory. Returns: Path to `nasm.exe`. Raises: AcceptanceError: If NA

Find the repository root by walking upward from a path. Args: start: Directory or file path to start from. Defaults to the current direct

Require an executable's PE machine to match the requested platform. Args: executable: PE image path. platform: Expected Gargoyle

Return the first matching field value. Args: fields: Normalized report fields. keys: Accepted normalized keys. Returns:

Create an x64 artifact layout. Args: repo_root: Repository root. configuration: Visual Studio configuration. output_dir:

Create a Win32 artifact layout. Args: repo_root: Repository root. configuration: Visual Studio configuration. output_dir:

Parse and validate Gargoyle's setup banner. Args: lines: Captured process output. platform: Platform-specific banner format.

Return the fake process status.

Read the COFF machine value from a PE executable. Args: executable: PE image path. Returns: Parsed PE machine evidence.

Require the current platform to be Windows. Args: system_name: Optional platform override for tests. Raises: AcceptanceError

Require an architecture report to match the requested platform. Args: report: Parsed architecture report. expected_platform: Expe

Require the executable and PIC blobs to exist. Args: artifacts: Expected build outputs. Raises: AcceptanceError: If any expe

Return expected ARM-family artifact layouts. Args: repo_root: Repository root. configuration: Visual Studio configuration.

Build a report for non-live acceptance modes. Args: artifacts: Resolved executable and PIC paths. build: Optional build result.

Create a consistent PE format detail. Args: executable: PE image path. problem: Short format problem. Returns: Error

Return non-optional artifact paths for a build. Args: artifacts: Candidate artifact layout. Returns: Required paths.

Run Gargoyle once and capture stdout. Args: artifacts: Resolved executable and PIC paths. extra_args: Command-line arguments for

Loads a raw PIC blob and marks it executable.

Return whether captured lines contain a usable architecture report. Args: lines: Captured report lines. expected_platform: Option

Return a friendly list of expected PE machine names. Args: platform: Expected Gargoyle platform. Returns: Human-readable PE

Return whether a PE machine value is compatible with a platform. Args: machine: Numeric IMAGE_FILE_MACHINE value. platform: Expec

Resolve all external build tools. Args: msbuild: Optional explicit MSBuild path. Returns: Resolved toolchain paths.

Return the fake process exit code. Args: timeout: Ignored timeout. Returns: Fake process exit code.

Return likely Visual Studio output locations. Args: repo_root: Repository root. configuration: Visual Studio configuration.

Build an environment where MSBuild can find NASM. Args: toolchain: Resolved toolchain paths. Returns: Environment variables

Close the benign MessageBox payload for a number of rounds. Args: process: Running Gargoyle process. controller: Window controlle

Return optional MSBuild properties supplied through the environment. Returns: Additional `/p:` arguments for MSBuild.

Return common MSBuild install paths for current Visual Studio releases. Returns: Candidate `MSBuild.exe` paths.

Ask `vswhere.exe` for the latest MSBuild-capable Visual Studio install. Args: vswhere: Path to `vswhere.exe`. Returns: Path

Normalize a report key for loose matching. Args: value: Raw report key. Returns: Lowercase key with common separators collap

Parse address lines from Gargoyle's setup banner. Args: lines: Captured process output. address_labels: Address labels expected f

Parse key-value fields from report lines. Args: lines: Captured report lines. Returns: Normalized report fields.

Parse a PE machine token. Args: value: Raw machine token. Returns: Numeric machine value, or `None` when unsupported.

Parse a platform field. Args: value: Raw field value. Returns: Parsed platform, or `None` when unsupported.

Parse a pointer-size field. Args: value: Raw pointer-size token. Returns: Pointer width in bits. Raises: Accept

Render a user-actionable failure panel. Args: error: Acceptance failure to display.

Render a successful acceptance report. Args: report: Completed acceptance report.

Run the executable's architecture-report command. Args: artifacts: Resolved executable and PIC paths. platform: Expected platform

Run the executable's headless setup-smoke command. Args: artifacts: Resolved executable and PIC paths. platform: Expected platfor

Start Gargoyle from the output directory. Args: artifacts: Resolved executable and PIC paths. extra_args: Optional command-line a

Return a compact tail of command output. Args: text: Complete command output. lines: Number of trailing lines to keep. Retur

Return a compact tail of command output. Args: text: Complete command output. lines: Number of trailing lines to keep. Retur

Terminate a still-running Gargoyle process. Args: process: Running Gargoyle process.

Find `vswhere.exe` if Visual Studio installed it. Returns: Path to `vswhere.exe`, or `None`.

Wait for Gargoyle to print a complete setup banner. Args: process: Running Gargoyle process. platform: Platform-specific banner f

Read the UTF-16 title text for a window. Args: hwnd: Native window handle. Returns: Window title text.

Build `Gargoyle.sln` for the requested configuration. Args: repo_root: Repository root containing `Gargoyle.sln`. configuration:

Close a window by posting `WM_CLOSE`. Args: hwnd: Native window handle. Raises: AcceptanceError: If `PostMes

Enumerate visible windows that look like Gargoyle MessageBoxes. Args: pid: Process ID that should own the window. tit

Selects either a system-DLL gadget or the tiny fallback gadget PIC.

Finds a compatible stack-pivot gadget in an executable section of a system DLL.

Mark the process as force-killed.

Wires together the PIC, gadget, trampoline, scratch stack, and demo payload.

Run the Typer app.

Return the canonical platform for a PE machine value. Args: machine: Numeric IMAGE_FILE_MACHINE value. Returns: Matching pla