Complete native companion ownership and Gen2 rod lifecycle

.github/workflows/api3-contract.yml

@@ -0,0 +1,60 @@
+name: API 3 contracts
+on:
+  pull_request:
+    paths:
+      - '.github/workflows/api3-contract.yml'
+      - 'src/**'
+      - 'tests/api3_contract/**'
+      - 'tests/engine/api3_*.lua'
+      - 'tools/api3-contract-check/**'
+  push:
+    branches: [main, dev]
+    paths:
+      - '.github/workflows/api3-contract.yml'
+      - 'src/**'
+      - 'tests/api3_contract/**'
+      - 'tests/engine/api3_*.lua'
+      - 'tools/api3-contract-check/**'
+permissions:
+  contents: read
+concurrency:
+  group: api3-contract-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  compare:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        reference: [79ea62f45fb2ea8f65d081a109431e4eb1bbdb36, 535a5ec088c1ae1bf4d91dd3e35a56f64cf46d91]
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          path: gen2
+          sparse-checkout: |
+            src
+            data
+            tests
+            tools/api3-contract-check
+      - uses: actions/checkout@v7
+        with:
+          repository: bryanthaboi/gen1recomp
+          ref: ${{ matrix.reference }}
+          path: gen1-reference
+          sparse-checkout: |
+            src
+            data
+            tests
+            assets/fonts
+      - name: install LuaJIT
+        run: sudo apt-get update && sudo apt-get install -y luajit
+      - name: identical mod contracts on both engines
+        run: >-
+          python3 gen2/tools/api3-contract-check/check.py
+          --gen1 gen1-reference --gen2 gen2
+          --report "${{ runner.temp }}/api3-report.json"
+      - uses: actions/upload-artifact@v7
+        with:
+          name: api3-contract-report-${{ matrix.reference }}
+          path: ${{ runner.temp }}/api3-report.json
+          if-no-files-found: error

.github/workflows/async-get.yml

@@ -0,0 +1,38 @@
+name: Async mod HTTP and file downloads
+on:
+  pull_request:
+  workflow_dispatch:
+permissions:
+  contents: read
+jobs:
+  transport:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.x'
+      - if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install -y love
+      - name: Exercise real worker requests against a local server
+        shell: python
+        run: |
+          import os, pathlib, shutil, subprocess, urllib.request, zipfile
+          host = os.environ['RUNNER_OS']
+          if host == 'Linux':
+              executable = shutil.which('love')
+          else:
+              suffix = 'macos' if host == 'macOS' else 'win64'
+              target = pathlib.Path(os.environ['RUNNER_TEMP']) / 'love-get-check'
+              target.mkdir()
+              archive = target / 'runtime.zip'
+              urllib.request.urlretrieve(f'https://github.com/love2d/love/releases/download/11.5/love-11.5-{suffix}.zip', archive)
+              with zipfile.ZipFile(archive) as z: z.extractall(target)
+              executable = next(target.rglob('love.app/Contents/MacOS/love')) if host == 'macOS' else next(target.rglob('lovec.exe'))
+              if host == 'macOS': executable.chmod(0o755)
+          subprocess.run(['python', 'tools/check_async_get.py', '--love', str(executable), '--tls'], check=True)

.github/workflows/core-update-contract.yml

@@ -0,0 +1,43 @@
+name: portable core.update contract
+on:
+  pull_request:
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: core-update-contract-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  contract:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/checkout@v7
+        with:
+          repository: bryanthaboi/gen1recomp
+          ref: 79ea62f45fb2ea8f65d081a109431e4eb1bbdb36
+          path: .contract-reference/gen1
+      - name: Install ROM-free test runtime
+        run: sudo apt-get update && sudo apt-get install -y luajit
+      - name: Check frame dispatch and native host routing
+        run: |
+          luajit tests/engine/core_update.lua
+          luajit tests/engine/core_update_routing.lua
+      - name: Compare both native engines through the same mod
+        run: |
+          mkdir -p /tmp/core-update-contract
+          python3 tools/core-update-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --report /tmp/core-update-contract/api2-native.json
+      - name: Check unified callback and API-3 integration
+        run: |
+          python3 tools/core-update-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --format unified --report /tmp/core-update-contract/api2-unified.json
+          python3 tools/core-update-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 3 --format unified --report /tmp/core-update-contract/api3.json
+      - uses: actions/upload-artifact@v6
+        if: always()
+        with:
+          name: core-update-contract
+          path: /tmp/core-update-contract
+          if-no-files-found: ignore

.github/workflows/gba-modal.yml

@@ -0,0 +1,44 @@
+name: Native GBA modal ownership
+on:
+  pull_request:
+    paths:
+      - '.github/workflows/gba-modal.yml'
+      - 'src/**'
+      - 'tests/gba_modal/**'
+      - 'tests/engine/gen3_modal*.lua'
+      - 'tools/gba-modal-check/**'
+  workflow_dispatch:
+permissions:
+  contents: read
+jobs:
+  native-modal:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          path: gen2
+      - uses: actions/checkout@v7
+        with:
+          repository: bryanthaboi/gen1recomp
+          ref: 535a5ec088c1ae1bf4d91dd3e35a56f64cf46d91
+          path: gen1-reference
+          sparse-checkout: |
+            src
+            data
+            tests
+            assets/fonts
+      - name: Install LuaJIT
+        run: sudo apt-get update && sudo apt-get install -y luajit
+      - name: Native ownership, reload, input and visibility
+        working-directory: gen2
+        run: |
+          luajit tests/engine/gen3_modal_stack.lua
+          luajit tests/engine/gen3_modal_shared.lua
+      - name: Identical consumer on pinned native engines
+        run: python3 gen2/tools/gba-modal-check/check.py --gen1 gen1-reference --gen2 gen2 --report "${{ runner.temp }}/gba-modal.json"
+      - uses: actions/upload-artifact@v7
+        with:
+          name: native-gba-modal-comparison
+          path: ${{ runner.temp }}/gba-modal.json
+          if-no-files-found: error

.github/workflows/input-hook-contract.yml

@@ -0,0 +1,43 @@
+name: portable input hook contract
+on:
+  pull_request:
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: input-hook-contract-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  contract:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/checkout@v7
+        with:
+          repository: bryanthaboi/gen1recomp
+          ref: 79ea62f45fb2ea8f65d081a109431e4eb1bbdb36
+          path: .contract-reference/gen1
+      - name: Install ROM-free test runtime
+        run: sudo apt-get update && sudo apt-get install -y luajit
+      - name: Check native input and host routing
+        run: |
+          luajit tests/engine/portable_input_hooks.lua
+          luajit tests/engine/portable_input_routing.lua
+      - name: Compare both native engines through the same mod
+        run: |
+          mkdir -p /tmp/input-hook-contract
+          python3 tools/input-hook-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --report /tmp/input-hook-contract/api2-native.json
+      - name: Check unified callback and API-3 integration
+        run: |
+          python3 tools/input-hook-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --format unified --report /tmp/input-hook-contract/api2-unified.json
+          python3 tools/input-hook-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 3 --format unified --report /tmp/input-hook-contract/api3.json
+      - uses: actions/upload-artifact@v6
+        if: always()
+        with:
+          name: input-hook-contract
+          path: /tmp/input-hook-contract
+          if-no-files-found: ignore

.github/workflows/logic-speed-contract.yml

@@ -0,0 +1,46 @@
+name: portable core.logic_speed contract
+on:
+  pull_request:
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: logic-speed-contract-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  contract:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/checkout@v7
+        with:
+          repository: bryanthaboi/gen1recomp
+          ref: 79ea62f45fb2ea8f65d081a109431e4eb1bbdb36
+          path: .contract-reference/gen1
+      - name: Install ROM-free test runtime
+        run: sudo apt-get update && sudo apt-get install -y luajit
+      - name: Check native speed dispatch, ownership and clocks
+        run: |
+          luajit tests/engine/logic_speed.lua
+          luajit tests/engine/logic_speed_routing.lua
+          luajit tests/engine/logic_speed_clock.lua
+      - name: Compare native API 1 and 2
+        run: |
+          mkdir -p /tmp/logic-speed-contract
+          python3 tools/logic-speed-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 1 --report /tmp/logic-speed-contract/api1-native.json
+          python3 tools/logic-speed-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --report /tmp/logic-speed-contract/api2-native.json
+      - name: Compare unified callbacks and API 3
+        run: |
+          python3 tools/logic-speed-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --format unified --report /tmp/logic-speed-contract/api2-unified.json
+          python3 tools/logic-speed-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 3 --format unified --report /tmp/logic-speed-contract/api3.json
+      - uses: actions/upload-artifact@v6
+        if: always()
+        with:
+          name: logic-speed-contract
+          path: /tmp/logic-speed-contract
+          if-no-files-found: ignore

.github/workflows/mod-asset-packs.yml

@@ -0,0 +1,37 @@
+name: Portable asset pack contracts
+on:
+  pull_request:
+    paths:
+      - 'src/import/Pack*.lua'
+      - 'src/import/Importers.lua'
+      - 'src/import/CacheFs.lua'
+      - 'src/import/LuaWriter.lua'
+      - 'src/import/lttp/**'
+      - 'src/import/snes/**'
+      - 'src/import/RomImporter.lua'
+      - 'src/mods/AssetPacks.lua'
+      - 'src/mods/StreamMD5.lua'
+      - 'src/mods/Manifest.lua'
+      - 'src/mods/Loader.lua'
+      - 'src/mods/LauncherMods.lua'
+      - 'src/mods/ManagerState.lua'
+      - 'tests/engine/asset_pack_contracts.lua'
+      - 'tests/engine/native_pack_producers.lua'
+      - 'tests/pack_sources/**'
+      - 'tests/asset_pack_runtime/**'
+      - 'tests/native_pack_runtime/**'
+      - '.github/workflows/mod-asset-packs.yml'
+  workflow_dispatch:
+permissions:
+  contents: read
+jobs:
+  packs:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v7
+      - run: sudo apt-get update && sudo apt-get install -y luajit lua5.4
+      - run: luajit tests/engine/asset_pack_contracts.lua
+      - run: luajit tests/engine/native_pack_producers.lua
+      - name: Check the portable data parser on plain Lua
+        run: lua5.4 -e 'local d=require("src.import.PackData");local w=require("src.import.LuaWriter");assert(d.decode(w.encode({1,true,"x"}))[3]=="x");assert(not d.decode("return os.exit()"))'

.github/workflows/mod-input-contract.yml

@@ -0,0 +1,44 @@
+name: portable logical mod input contract
+on:
+  pull_request:
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: mod-input-contract-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  contract:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/checkout@v7
+        with:
+          repository: bryanthaboi/gen1recomp
+          ref: 79ea62f45fb2ea8f65d081a109431e4eb1bbdb36
+          path: .contract-reference/gen1
+      - name: Install ROM-free test runtime
+        run: sudo apt-get update && sudo apt-get install -y luajit
+      - name: Check logical input, headless loading and lifecycle
+        run: |
+          luajit tests/engine/portable_mod_input.lua
+          luajit tests/engine/mod_input_lifecycle.lua
+          luajit tests/engine/mod_input_headless.lua
+      - name: Compare both native engines through the same mod
+        run: |
+          mkdir -p /tmp/mod-input-contract
+          python3 tools/mod-input-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --report /tmp/mod-input-contract/api2-native.json
+      - name: Check unified callback and API-3 integration
+        run: |
+          python3 tools/mod-input-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --format unified --report /tmp/mod-input-contract/api2-unified.json
+          python3 tools/mod-input-contract-check/check.py --gen1 .contract-reference/gen1 \
+            --api 3 --format unified --report /tmp/mod-input-contract/api3.json
+      - uses: actions/upload-artifact@v6
+        if: always()
+        with:
+          name: mod-input-contract
+          path: /tmp/mod-input-contract
+          if-no-files-found: ignore