# AUD-004 evidence pack — qualified Unreal execution instructions

## 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.
