Eve library

AUD-004 evidence pack — qualified Unreal execution instructions

Evidence

Revision 1

On this page

Work-package charter#

  • Task ID: AUD-004
  • Owner: Oshun portfolio audit-integrity maintainer; implementation owner: Codex
  • Accountable product: V1–V9 autonomous-content portfolio
  • Priority: P0
  • Target milestone: 2026-07-15 SOTA gap-closure program
  • Risk tier: High execution-evidence integrity
  • Dependencies: Unreal Engine 5.5 project descriptors, designated Linux Unreal runners, GitHub Actions, immutable source history
  • Affected schemas and content slots: New executed Unreal evidence schema and host-observation record; closure instructions only, with no shipped content or gameplay artifact changed
  • Rollout strategy: Qualify every affected instruction, enforce a single executed-evidence identity, make V4 remotely dispatchable, and keep incapable host observations separate from commandlet results.
  • Rollback strategy: Revert the runbook, schema/writer, workflow, smoke harness, and instruction qualifications together. Never preserve an executed claim after removing its identity or artifact checks.
  • Evidence-pack location: This file and evidence/v1-v9/AUD-004/

Completed implementation#

  1. The ue55-linux profile fixes UE 5.5.x, the exact Linux editor path, ueagent, LinuxEditor automation, Linux cook/BuildGraph execution, and the [self-hosted, Linux, Unreal] runner class.
  2. Every affected product instruction is marked [UE-AUD-004] and names its actual project. V8 explicitly has no standalone .uproject, so no unrelated project may be selected to manufacture a V8 engine claim.
  3. oshun.unreal-evidence.v1 records a full source commit, host, engine version and executable digest, project and digest, commandlet, exact argv, run-as user, target platform, timestamps, exit code, and retained output hashes. The writer rejects the wrong OS/user/project/tool/target, a dirty tracked worktree, a source mismatch, missing artifacts, substituted fields, and a host without the exact UE executable.
  4. V4's dispatchable PR gate now runs its commandlet only on the designated self-hosted runner and uploads its log, Automation report, and evidence JSON. Remote instructions require the returned headSha to equal the intended commit. Existing nonconforming V2/V3/V6 jobs are documented as insufficient, and V2, V3, V5, V6, or V7 remains open until its project-owned job emits the same record.
  5. At initial closure, the main audit reported the local result as not-run-on-this-host, not as project or engine unavailability. A static CI contract protects the instruction, runner, schema, writer, and smoke-harness agreement.

Historical host observation and claim boundary#

  • Committed contract source: ee25c59ab561b8e35df0d62fffbb4650966e905f
  • Observed at: 2026-07-15T14:57:59.116Z
  • Host: dev-server; Linux 6.8.0-110-generic x86_64
  • Toolchain: Node.js v24.14.1, pnpm 10.25.0, Git 2.43.0
  • At the recorded observation time, the exact editor executable was absent and id ueagent did not resolve.
  • V2/ue/V2.uproject, V3/ue/V3.uproject, V4/ue/V4.uproject, V5/ue/V5.uproject, V6/ue/V6.uproject, and V7/ue/Mawu.uproject were all present. No V8 .uproject was found.
  • The machine-readable observation is evidence/v1-v9/AUD-004/host-observation.json. It deliberately uses oshun.unreal-host-observation.v1, not the executed-evidence schema.
  • No Unreal commandlet or remote workflow was executed for this task. This pack proves instruction/evidence integrity and only the observed 2026-07-15 host's incapability at that timestamp; it does not prove an Unreal build, automation, cook, playback, project failure, or project success.

Current 2026-08-02 host state#

The immutable 2026-07-15 observation remains part of the contract's adversarial history, but it is not current host truth. Source-bound records now establish that UE 5.5.4, UnrealEditor-Cmd, RunUAT.sh, and ueagent are present:

  • evidence/v1-v9/V2-unreal-host-preflight.json reports V2 rebuild-required because its editor build ID is stale.
  • evidence/v1-v9/V3-unreal-host-preflight.json reports V3 rebuild-required because its project editor modules are absent.
  • evidence/v1-v9/V4-001-unreal-evidence.json, evidence/v1-v9/V5-001-unreal-evidence.json, and evidence/v1-v9/V7-003-unreal-runtime-report.json retain qualified executed engine evidence for their exact bounded product slices.

These newer records supersede only the historical host-capability observation. They do not weaken missing provider, human-review, media, operational, or release evidence, and they do not convert either V2/V3 preflight into execution.

Contract integrity digests#

File SHA-256 at committed contract source
scripts/audit/unreal-evidence.schema.json 32d38b0a5a0058f89a0225c4603622be9d650bfcb28c17cb2d728169ac4f3fdc
scripts/audit/write-unreal-evidence-record.mjs 41c135aade9e11b84586598ac16c714c89a3757a722f7867507c1e4a41a674fa
scripts/audit/write-unreal-evidence-record.test.mjs 37c4bb0c024ee3de84dd3dd5954571227b26474d37597bea8b0b4519d1e28b36
scripts/audit/verify-unreal-closure-contract.mjs c7e738523adf4e537747e1f74eae61d6d3f6b869f4bc8a110112c28243b6744a
evidence/v1-v9/AUD-004/unreal-evidence-runbook.md 361a15b604db2539d97b7bcb6b78fa796b6919baa1e0a8566f3f46b42205a064
.github/workflows/unreal-closure-contract.yml 02fd927eff89a4bcb6aa613ddc68bd9925d3d3aa5915b8783581598a5fdcd60f
.github/workflows/v4-pr-gate.yml 03d9d99b0fb63dd38b390ca890dd2354bc7ed009ffe437c5328f35c02da81164
V4/.ci/run-ue-automation-smoke.sh f477f2f1f7be8208bd7670de2f8425b7967bd743c0365844a48e4a735dff047a

Verification#

  • node --test scripts/audit/write-unreal-evidence-record.test.mjs — 3/3 passed, including valid editor/cook/BuildGraph records, identity substitution rejection, and one-byte artifact-tree mutation detection.
  • node scripts/audit/verify-unreal-closure-contract.mjs — passed; instruction, host, remote-job, evidence, and not-run semantics agree.
  • Targeted ESLint over all three audit .mjs files — passed.
  • Node syntax checks for all three audit .mjs files — passed.
  • bash -n V4/.ci/run-ue-automation-smoke.sh — passed.
  • Both affected workflows parsed as YAML — passed.
  • Targeted Prettier checks and git diff --check — passed.
  • pnpm verify:audit:v1-v9-verification-record — 8/8 adversarial tests and existing AUD-003 record coherence passed.
  • Direct writer invocation on the recorded 2026-07-15 host exited 1 with the exact missing-editor path and created no executed record. Direct V4 smoke invocation likewise exited 1 before automation rather than manufacturing a green result.