BLOCK_LEDGER.json

{
  "schema_version": 1,
  "block_id": "BP-090-094",
  "package_id": "BP-094",
  "parent_package_id": "BP-093",
  "block_parent_package_id": "BP-085-089R8",
  "parent_status": "compat_109_release_candidate_v1",
  "parent_fingerprint": "0x29b72a98",
  "candidate_status": "compat_109_final_candidate_v1",
  "candidate_fingerprint": "0xe04a7727",
  "reference_sha256": "04862c835c399bc9184f62101ae0390c2a758c21656ec06dcc0384e0f373d588",
  "reference_bytes": 435712,
  "reference_pe_machine": "0x014c",
  "external_gates": [
    "original_binary_interop",
    "external_glquake_visual_reference"
  ],
  "steps": [
    {
      "id": "BP-090",
      "title": "Verified original GLQuake 1.09 reference",
      "fixtures": 20,
      "status": "candidate"
    },
    {
      "id": "BP-091",
      "title": "Original GLQuake server to MiniQuake client",
      "fixtures": 20,
      "process_pairs": 2,
      "status": "candidate",
      "original_server_process_mode": "listen",
      "requires_video_context": true,
      "dedicated_mode_supported": false,
      "condebug_enabled": false,
      "readiness_evidence": "protocol3_server_info_then_target_udp_protocol15_signon4",
      "network_scope": "loopback_only",
      "bind_address": "127.0.0.1",
      "firewall_prompt_expected": false,
      "temporary_firewall_rules": true,
      "firewall_rule_scope": "exact_program_udp_loopback_only",
      "firewall_rule_count": 4,
      "firewall_cleanup": "automatic",
      "network_provenance_required": true,
      "required_transport": "udp",
      "local_fallback_rejected": true,
      "demo_fallback_rejected": true,
      "remote_address_must_match_target": true,
      "readiness_probe_timeout_ms": 180000,
      "port_selection": "loopback_bind_probe",
      "cold_start_safe": true
    },
    {
      "id": "BP-092",
      "title": "MiniQuake server to original GLQuake client",
      "fixtures": 20,
      "process_pairs": 2,
      "status": "candidate",
      "condebug_enabled": false,
      "evidence_source": "miniquake_server_protocol15_summary",
      "network_scope": "loopback_only",
      "bind_address": "127.0.0.1",
      "firewall_prompt_expected": false,
      "temporary_firewall_rules": true,
      "firewall_rule_scope": "exact_program_udp_loopback_only",
      "firewall_rule_count": 4,
      "firewall_cleanup": "automatic",
      "original_command_parser": "Cmd_TokenizeString_COM_Parse",
      "connect_token": "127.0.0.1",
      "remote_port_source": "-port_to_net_hostport",
      "default_port_without_fix": 26000
    },
    {
      "id": "BP-093",
      "title": "Raw external GLQuake visual reference",
      "fixtures": 20,
      "scenarios": [
        "demo1",
        "demo2",
        "demo3"
      ],
      "frame": 256,
      "search_radius": 2,
      "minimum_ssim": 0.95,
      "normalization": "none",
      "status": "candidate",
      "condebug_enabled": false,
      "evidence_source": "original_tga_screenshot",
      "network_scope": "disabled",
      "udp_disabled": true,
      "firewall_prompt_expected": false,
      "mini_startup_gamma": 1.0,
      "clear_color_rgba": [
        1.0,
        0.0,
        0.0,
        0.0
      ],
      "brush_render_path": "canonical_R_DrawBrushModelForSubmodel",
      "brush_lightmap_blend": "GL_ZERO_GL_ONE_MINUS_SRC_COLOR",
      "brush_texture_frame_source": "entity.frame",
      "expected_original_backbuffer_offset": -2,
      "capture_completion": "validated_tga_size_hash_stability",
      "original_runs_per_scenario": 2,
      "reference_consistency_mode": "exact_or_dual_reference_ssim",
      "minimum_reference_ssim": 0.98,
      "candidate_reference_aggregation": "minimum_ssim",
      "requires_exact_original_pair": false
    },
    {
      "id": "BP-094",
      "title": "External compatibility closure",
      "fixtures": 24,
      "status": "candidate"
    }
  ],
  "delivery_revision": "OPT-001CR3R4",
  "delivery_parent": "OPT-001CR3R3",
  "hotfixes": [
    {
      "revision": "BP-090-094R1",
      "classification": "PowerShell parser / delivery infrastructure",
      "changed_engine_code": false,
      "changed_native_code": false,
      "fix": "brace Scenario interpolation before a literal colon and add package-wide verifier protection",
      "status": "candidate"
    },
    {
      "revision": "BP-090-094R2",
      "classification": "Verifier CLI / delivery preflight",
      "changed_engine_code": false,
      "changed_native_code": false,
      "fix": "use canonical --root invocation and retain the historical positional root as a compatibility alias",
      "status": "candidate"
    },
    {
      "revision": "BP-090-094R3",
      "classification": "External original-binary harness / GL-capable server launch mode",
      "changed_engine_code": false,
      "changed_native_code": false,
      "fix": "run verified GLQUAKE.EXE as a windowed listen server because GL map loading requires a WGL context; add remote-client and early-exit diagnostics",
      "status": "candidate"
    },
    {
      "revision": "BP-090-094R4",
      "classification": "External original-binary harness / legacy debug-log overflow",
      "changed_engine_code": false,
      "changed_native_code": false,
      "fix": "omit -condebug for all original GLQuake GUI runs and replace qconsole evidence with Protocol summaries, process liveness and screenshot files",
      "status": "candidate"
    },
    {
      "revision": "BP-090-094R5",
      "classification": "External original-binary harness / unattended firewall isolation",
      "changed_engine_code": true,
      "changed_native_code": false,
      "engine_change_scope": "interop-only CLI modes bind 127.0.0.1",
      "fix": "bind original and MiniQuake interop endpoints exclusively to 127.0.0.1; disable UDP for original visual runs so Windows Firewall does not require an interactive approval prompt",
      "status": "candidate"
    },
    {
      "revision": "BP-090-094R6",
      "classification": "external original-binary harness / temporary Windows Defender Firewall authorization",
      "changed_engine_code": false,
      "changed_native_code": false,
      "fix": "request elevation before build, install four exact-program UDP loopback-only rules, remove them in finally, and preserve timeout logs",
      "status": "candidate"
    },
    {
      "revision": "BP-090-094R7",
      "classification": "external original-binary harness / original console port tokenization",
      "changed_engine_code": false,
      "changed_native_code": false,
      "fix": "pass the original client target port through -port/net_hostport and execute connect 127.0.0.1 without a colon; add parallel process diagnostics",
      "status": "candidate"
    },
    {
      "revision": "BP-090-094R8",
      "classification": "renderer parity / original visual-reference diagnostics",
      "changed_engine_code": true,
      "changed_native_code": false,
      "engine_change_scope": "startup evidence gamma, GL clear colour and brush-model render handoff",
      "fix": "match original -gamma 1 startup palette, preserve red GL clear colour, and route brush entities through canonical animated GL_LUMINANCE lightmap rendering",
      "status": "candidate"
    },
    {
      "revision": "BP-090-094R9",
      "classification": "external original-server interop / false-positive local fallback",
      "changed_engine_code": true,
      "changed_native_code": false,
      "engine_change_scope": "interop-only client provenance validation",
      "fix": "require the accepted signon-4 client to use UDP to the requested peer and reject local-server, local-authoritative and demo fallbacks; independently enforce the same markers in PowerShell",
      "status": "candidate"
    },
    {
      "revision": "BP-090-094R10",
      "classification": "external original-server interop / cold-start readiness race",
      "changed_engine_code": false,
      "changed_native_code": false,
      "fix": "wait for a real CCREP_SERVER_INFO response from the exact original-server UDP endpoint before launching the full MiniQuake client; bind-test random loopback ports and emit readiness diagnostics",
      "status": "candidate"
    },
    {
      "revision": "BP-090-094R11",
      "classification": "external original-reference source-selector handoff",
      "changed_engine_code": false,
      "changed_native_code": false,
      "fix": "resolve and validate the external reference before elevation/build, forward it explicitly and via environment fallback, require exactly one selector, and record the effective argument contract",
      "status": "candidate"
    },
    {
      "revision": "BP-090-094R12",
      "classification": "external original-server Protocol-3 connect handshake",
      "changed_engine_code": true,
      "changed_native_code": false,
      "engine_change_scope": "interop-only persistent control socket and strict connection path",
      "fix": "reuse one UDP source endpoint, resend CCREQ_CONNECT every 500 ms, bypass startup +connect fallback, and emit raw packet diagnostics",
      "status": "candidate"
    },
    {
      "revision": "BP-090-094R13",
      "classification": "external original-server startup sequencing and readiness guard lifetime",
      "changed_engine_code": true,
      "changed_native_code": false,
      "engine_change_scope": "interop-only pre-fallback connect path",
      "fix": "consume the private original target during Host_Init before standalone fallback, reuse the same persistent handshake, and keep the readiness UDP guard open until after the original process stops",
      "status": "candidate"
    },
    {
      "revision": "BP-090-094R14",
      "classification": "external original-TGA completion race and bounded reference-run variance",
      "changed_engine_code": false,
      "changed_native_code": false,
      "fix": "wait for complete byte-stable TGAs and use a dual-reference minimum-SSIM gate",
      "status": "candidate"
    },
    {
      "revision": "BP-090-094R15",
      "classification": "external original/MiniQuake visual simulation timestep parity",
      "changed_engine_code": false,
      "changed_native_code": false,
      "fix": "set original host_framerate to 0.02 before timedemo so time-dependent damage kick and cshift decay match MiniQuake evidence",
      "status": "candidate"
    }
  ],
  "optimization": {
    "status": "opt001cr3r3_named_build_binding_candidate_v1",
    "fingerprint": "0x1c001c08",
    "parent": "OPT-001CR3R2",
    "parent_windows_status": "PASS",
    "parent_handle_classification": "PLATEAU",
    "scope": "CR3 inline/array hotpaths plus binary live output and exact named build parameter binding",
    "maps": [
      "e1m1",
      "e1m2"
    ],
    "baseline_revision": "OPT-001B",
    "next": [
      "OPT-001CR3R3 Windows acceptance",
      "OPT-001D",
      "OPT-001E"
    ],
    "delivery_revision": "OPT-001CR3R3",
    "delivery_parent": "OPT-001CR3R2",
    "opt001c_windows_result": {
      "result_archive": "MiniQuake_OPT-001C_RESULTS_20260807-180739.zip",
      "status": "FAIL before first MiniLang target compiled",
      "failure": "world.ml delimiter mismatch: Expected RBRACK, got RPAREN",
      "performance_classification": "UNKNOWN",
      "superseded_by": "OPT-001CR1"
    },
    "r1_fix": "named trace-hash locals plus whole-tree MiniLang delimiter preflight",
    "opt001cr1_windows_result": {
      "result_archive": "MiniQuake_OPT-001CR1_RESULTS_20260807-212403.zip",
      "status": "all product and correctness gates PASS; harness analyzers false FAIL",
      "performance_classification_reconstructed": "TARGET_MET",
      "handle_sequence": "275,275,275,276",
      "handle_classification": "INCONCLUSIVE"
    },
    "r2_fix": "consume native stdout for live console, use per-child status JSON, return one integer exit code",
    "cr3r1_windows_result": {
      "result_archive": "MiniQuake_OPT-001CR3R1_RESULTS_20260809-094348.zip",
      "status": "package verification PASS; harness false FAIL before build",
      "failure": "native child stdout contaminated PowerShell function return stream",
      "steps_executed": 1,
      "failures_recorded": 0
    },
    "cr3r2_windows_result": {
      "status": "package verification PASS; build parameter binding FAIL before MiniLang compilation",
      "failure": "StdLib path misbound to Configuration",
      "fix": "direct named -File invocation"
    }
  },
  "optimization_candidate": {
    "status": "opt001cr3r4_entry_helper_namespace_candidate_v1",
    "fingerprint": "0x1c001c09",
    "parent": "OPT-001CR3",
    "delivery_revision": "OPT-001CR3R4",
    "delivery_parent": "OPT-001CR3R3",
    "windows_acceptance": "pending"
  },
  "opt001cr3r4_hotfix": {
    "status": "candidate; Windows build pending",
    "root_cause": "package-free test helper check/2 shadowed miniquake.zone.check/1",
    "fix": "entry helper namespace plus transitive import-closure arity collision verifier"
  }
}