Self-Hosted Certification Evidence Issue Template
Use this template to drive Codex orchestration from an issue URL.
Setup Catalog
- legacy-2020-desktop-linux
- legacy-2020-desktop-windows
- host-2026-desktop-linux
- host-2026-desktop-windows
Desired Outcome
All listed setups complete self-hosted-machine-certification.yml with certified=true.
{
"workflow_file": "self-hosted-machine-certification.yml",
"ref": "cert/self-hosted-machine-certification-evidence",
"trigger_mode": "auto",
"recorder_name": "cdev-certification-recorder",
"require_local_ref_sync": true,
"required_script_paths": [
"scripts/Invoke-MachineCertificationFromIssue.ps1",
"scripts/Start-SelfHostedMachineCertification.ps1",
"scripts/Assert-InstallerHarnessMachinePreflight.ps1",
"scripts/Invoke-EndToEndPortMatrixLocal.ps1"
],
"setup_names": [
"legacy-2020-desktop-linux",
"legacy-2020-desktop-windows",
"host-2026-desktop-linux",
"host-2026-desktop-windows"
]
}
When merged to main, change ref to main.
Bootstrap (Required)
- Checkout the repository at
ref from config before executing any command.
- Verify local
HEAD equals the remote head SHA of ref.
- Validate
required_script_paths exist.
- Post
CERT_SESSION_START and detect stale open sessions before dispatch.
- If any required script is missing, stop and classify as
branch_drift_missing_script.
- Do not author replacement scripts from scratch in this flow.
- Ensure upstream runners include setup-specific collision-guard labels.
- Ensure Docker context auto-switch is enabled for each setup (
switch_docker_context=true).
- Ensure Docker Desktop auto-start is enabled for each setup (
start_docker_desktop_if_needed=true).
Evidence
| Setup |
Machine |
Run URL |
Conclusion |
Artifact URL |
Certified |
| legacy-2020-desktop-linux |
GHOST-lvcdev-surface-upstream |
run |
success |
artifact |
true |
| legacy-2020-desktop-windows |
GHOST-lvcdev-surface-upstream |
run |
success |
artifact |
true |
| host-2026-desktop-linux |
GHOST-lvcdev-surface-upstream |
run |
success |
artifact |
true |
| host-2026-desktop-windows |
GHOST-lvcdev-surface-upstream |
run |
success |
artifact |
true |
Failure Classification
- runner_label_mismatch
- missing_labview_installation
- docker_context_switch_failed
- docker_context_unreachable
- port_contract_failure
- workflow_dependency_missing
- branch_drift_missing_script
- runner_label_collision_guard_unconfigured
Self-Hosted Certification Evidence Issue Template
Use this template to drive Codex orchestration from an issue URL.
Setup Catalog
Desired Outcome
All listed setups complete
self-hosted-machine-certification.ymlwithcertified=true.{
"workflow_file": "self-hosted-machine-certification.yml",
"ref": "cert/self-hosted-machine-certification-evidence",
"trigger_mode": "auto",
"recorder_name": "cdev-certification-recorder",
"require_local_ref_sync": true,
"required_script_paths": [
"scripts/Invoke-MachineCertificationFromIssue.ps1",
"scripts/Start-SelfHostedMachineCertification.ps1",
"scripts/Assert-InstallerHarnessMachinePreflight.ps1",
"scripts/Invoke-EndToEndPortMatrixLocal.ps1"
],
"setup_names": [
"legacy-2020-desktop-linux",
"legacy-2020-desktop-windows",
"host-2026-desktop-linux",
"host-2026-desktop-windows"
]
}
When merged to
main, changereftomain.Bootstrap (Required)
reffrom config before executing any command.HEADequals the remote head SHA ofref.required_script_pathsexist.CERT_SESSION_STARTand detect stale open sessions before dispatch.branch_drift_missing_script.switch_docker_context=true).start_docker_desktop_if_needed=true).Evidence
Failure Classification