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#
- The
ue55-linuxprofile fixes UE 5.5.x, the exact Linux editor path,ueagent,LinuxEditorautomation, Linux cook/BuildGraph execution, and the[self-hosted, Linux, Unreal]runner class. - 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. oshun.unreal-evidence.v1records 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.- 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
headShato 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. - 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; Linux6.8.0-110-genericx86_64 - Toolchain: Node.js
v24.14.1, pnpm10.25.0, Git2.43.0 - At the recorded observation time, the exact editor executable was absent and
id ueagentdid not resolve. V2/ue/V2.uproject,V3/ue/V3.uproject,V4/ue/V4.uproject,V5/ue/V5.uproject,V6/ue/V6.uproject, andV7/ue/Mawu.uprojectwere all present. No V8.uprojectwas found.- The machine-readable observation is
evidence/v1-v9/AUD-004/host-observation.json. It deliberately usesoshun.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.jsonreports V2rebuild-requiredbecause its editor build ID is stale.evidence/v1-v9/V3-unreal-host-preflight.jsonreports V3rebuild-requiredbecause its project editor modules are absent.evidence/v1-v9/V4-001-unreal-evidence.json,evidence/v1-v9/V5-001-unreal-evidence.json, andevidence/v1-v9/V7-003-unreal-runtime-report.jsonretain 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
.mjsfiles — passed. - Node syntax checks for all three audit
.mjsfiles — 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
1with the exact missing-editor path and created no executed record. Direct V4 smoke invocation likewise exited1before automation rather than manufacturing a green result.