Skip to content

Gates Index

Generated by python3 scripts/generate_gates_index.py --markdown docs/reference/generated/gates.md; --check runs as a local_ci.sh stage, so this page cannot drift from the scripts and workflows it lists.

Every check that decides whether Kanama is green, in one place: what each one proves (in the script's own words), where it runs, and when it first landed. Three tiers:

  • Local CI stages run on every PR and push to main (ci.yml job local-ci (linux) runs scripts/local_ci.sh --skip-docs) and locally with scripts/local_ci.sh <godot>.
  • CI workflow jobs are the GitHub lanes around it: docs, mobile builds, the Web browser matrix, packaging.
  • Local-only gates need a device, a GUI browser, or a release host. They appear in no workflow, so their runs are ledgered in evidence/gates.json and scripts/check_gate_evidence.py (inside scripts/audit_claims.sh) fails when a Supported claim's latest run predates the current Godot pin.

A green PR means the first two tiers passed. It does not mean the third tier was run — that is what the ledger is for.

Local CI stages (96)

In scripts/local_ci.sh order. "What it proves" is the first sentence of the script's docstring or header where a script exists, otherwise the stage's own comment.

# Stage What it proves Where it runs Script First landed
1 JVM unit tests + kanama-common-api contract JVM unit tests across all modules. PR + push to main (ci.yml local-ci); local "$ROOT_DIR/gradlew" -p "$ROOT_DIR" jvmTest test :kanama-common-api:jvmTest :kan… —
2 buildSrc unit tests + formatting buildSrc holds build logic with unit tests (the iOS source-line table generator, task 131 item 13); Gradle compiles buildSrc for every build but no longer runs its tests, so they run here. PR + push to main (ci.yml local-ci); local "$ROOT_DIR/gradlew" -p "$ROOT_DIR/buildSrc" test ktfmtCheck —
3 Android remap buildSrc unit tests (task 138 item 28) android/godot-plugin/buildSrc holds the PanamaPort remap and its comment stripper; its Python mirror (check_android_remap_sources.py, below) is held to the same inputs. PR + push to main (ci.yml local-ci); local "$ROOT_DIR/gradlew" -p "$ROOT_DIR/android/godot-plugin/buildSrc" test —
4 public docs local-path guard Tracked public docs and templates contain no local machine paths or personal checkout names. PR + push to main (ci.yml local-ci); local if git -C "$ROOT_DIR" grep -nE '(/Users/[[:alnum:]_.-]+\|/home/[[:alnum:]_.-]+\|l… —
5 validate Godot API constants Validate hand-written Godot ABI constants against extension_api.json. PR + push to main (ci.yml local-ci); local scripts/validate_godot_api.py 2026-05-20
6 API wrapper coverage report Report hand-written Kotlin API wrapper coverage against extension_api.json. PR + push to main (ci.yml local-ci); local scripts/api_wrapper_coverage.py 2026-05-20
7 API wrapper coverage docs check Report hand-written Kotlin API wrapper coverage against extension_api.json. PR + push to main (ci.yml local-ci); local scripts/api_wrapper_coverage.py 2026-05-20
8 API wrapper generator report docs check Dry-run the conservative wrapper generator across the full Godot API. PR + push to main (ci.yml local-ci); local scripts/api_wrapper_generator_report.py 2026-05-20
9 enum migration table docs check (task 128 A) Migrate Kotlin sources from the pre-0.5 enum constants to the typed Godot enums (task 128 A). PR + push to main (ci.yml local-ci); local scripts/migrate_enum_constants.py 2026-10-02
10 iOS handwritten report docs check Generate the iOS hand-written / stub registry from in-code KANAMA-IOS-* markers. PR + push to main (ci.yml local-ci); local scripts/ios_handwritten_report.py 2026-06-11
11 gates index docs check Generate docs/reference/generated/gates.md: every gate, what it proves, where it runs (task 99, R18). PR + push to main (ci.yml local-ci); local scripts/generate_gates_index.py 2026-09-09
12 red-run mutations still apply Red runs for the repo's gates (task 118): every gate is shown to FAIL on a known-bad input. PR + push to main (ci.yml local-ci); local scripts/gate_red_runs.py 2026-10-04
13 wrapper KDoc staleness check (<pin>) Guarded: KDoc is synced from Godot's doc/classes (see docs/contributing/wrapper-maintenance.md "Docs version pin"). local only when a Godot doc/classes checkout is present (GODOT_DOCS); on CI it prints SKIP: kdoc-staleness and is allowed to skip only through KANAMA_ALLOW_SKIP in ci.yml kdoc_docs="${GODOT_DOCS:-}" —
14 API shell wrapper generator coverage check Generate handle-only API shell wrappers from extension_api.json. PR + push to main (ci.yml local-ci); local scripts/generate_api_shell_wrappers.py 2026-05-20
15 wrapper MethodBind signature audit Audit wrapper MethodBind call helpers against extension_api.json. PR + push to main (ci.yml local-ci); local scripts/audit_wrapper_signatures.py 2026-05-20
16 exact wrapper ABI policy audit Report wrapper MethodBind calls against the exact ABI policy model. PR + push to main (ci.yml local-ci); local scripts/audit_wrapper_abi_policy.py 2026-05-20
17 API wrapper inheritance audit Audit API wrapper base classes against extension_api.json. PR + push to main (ci.yml local-ci); local scripts/audit_api_wrapper_inheritance.py 2026-05-20
18 singleton RefCounted lifetime audit Audit singleton lifetime policy for Godot 4.7 RefCounted singleton warnings. PR + push to main (ci.yml local-ci); local scripts/audit_singleton_refcounted_policy.py 2026-05-22
19 conservative wrapper generator fixture Check the wrapper generator: representative fixtures, the locked iOS policies, and the single-tree drift gate (committed generated wrappers == a fresh regen, on every platform). PR + push to main (ci.yml local-ci); local scripts/check_wrapper_generator.py 2026-05-20
20 generated property coverage gate Property-coverage gate: fail on any silently dropped generated wrapper property. PR + push to main (ci.yml local-ci); local scripts/check_property_coverage.py 2026-07-23
21 iOS no-silent-stubs check Fail if the iOS backend has an UN-ANNOTATED silent stub. PR + push to main (ci.yml local-ci); local scripts/check_ios_no_silent_stubs.py 2026-06-11
22 Godot version pin consistency Assert the Godot baseline version is consistent across all pins (review F4). PR + push to main (ci.yml local-ci); local scripts/check_godot_version_pin.py 2026-06-22
23 Kotlin/KSP pin consistency Assert every Kotlin, KSP and kotlinx-coroutines version pin in the repo matches its one source. PR + push to main (ci.yml local-ci); local scripts/check_kotlin_pins.py 2026-10-17
24 kit version pin lockstep Assert a kit's version pins move in lockstep with the checkout that builds it (task 135 item 5). PR + push to main (ci.yml local-ci); local scripts/check_kit_version_pins.py 2026-10-24
25 GDExtension modernization + backend convergence Fail loud if any backend binds a deprecated GDExtension interface function, or if the desktop/Android (JVM) and iOS backends bind different variants of the same function family. PR + push to main (ci.yml local-ci); local scripts/check_gdextension_modernization.py 2026-07-23
26 native call surface prewarm audit Gate: every native downcall adapter shape is prewarmed before the first upcall. PR + push to main (ci.yml local-ci); local scripts/check_native_call_surface.py 2026-08-07
27 claim audit (task 85 aggregator) run every "is this still true?" check in one place (task 85). PR + push to main (ci.yml local-ci); local. The task-index check inside it runs only where kanama-tasks exists; elsewhere it prints SKIP: task-index, and CI allows that skip only through KANAMA_ALLOW_SKIP in ci.yml scripts/audit_claims.sh 2026-08-20
28 web callback flush audit Every Web callback boundary that runs user Kotlin must flush the command buffer. PR + push to main (ci.yml local-ci); local scripts/check_web_callback_flush.py 2026-08-13
29 vararg ptrcall audit Fail if a vararg Godot method is wrapped through ptrcall. PR + push to main (ci.yml local-ci); local scripts/audit_vararg_ptrcalls.py 2026-05-20
30 type marshal coverage audit Cross-reference every Kotlin type under src/commonMain/kotlin/net/multigesture/kanama/types/ against the four coverage tables maintained elsewhere PR + push to main (ci.yml local-ci); local scripts/type_coverage_audit.py 2026-05-20
31 generator call-shape policy audit Audit conservative wrapper-generator call-shape policy. PR + push to main (ci.yml local-ci); local scripts/audit_generator_shape_policy.py 2026-05-20
32 generator object policy audit Audit conservative wrapper-generator object typing policy. PR + push to main (ci.yml local-ci); local scripts/audit_generator_object_policy.py 2026-05-20
33 ptrcall helper layout ABI audit Audit ObjectCalls ptrcall helper bodies for obvious ABI layout drift. PR + push to main (ci.yml local-ci); local scripts/audit_ptrcall_helper_layouts.py 2026-05-20
34 builtin storage size ABI audit Audit builtin storage allocations against extension_api.json. PR + push to main (ci.yml local-ci); local scripts/audit_builtin_storage_sizes.py 2026-05-20
35 Variant marshalling policy audit Audit generic Variant marshalling policy. PR + push to main (ci.yml local-ci); local scripts/audit_variant_marshalling_policy.py 2026-05-20
36 GodotObject script-path audit Guard GodotObject convenience APIs that must preserve script semantics. PR + push to main (ci.yml local-ci); local scripts/audit_godot_object_script_paths.py 2026-05-20
37 runtime node/RPC guardrail audit Audit Kotlin scripts for risky runtime node lookups and string calls. PR + push to main (ci.yml local-ci); local scripts/audit_runtime_node_lookups.py 2026-05-22
38 replicated script-property guardrail audit Audit SceneReplicationConfig root properties against Kotlin script properties. PR + push to main (ci.yml local-ci); local scripts/audit_replicated_script_properties.py 2026-05-22
39 value-type builtin parity audit Audit hand-written Kanama value-type wrappers against Godot builtins. PR + push to main (ci.yml local-ci); local scripts/audit_value_type_wrappers.py 2026-05-20
40 value-type builtin operators and methods generated (task 134 B) Generate the value types' builtin operators and methods from extension_api.json (task 134 B). PR + push to main (ci.yml local-ci); local scripts/generate_builtin_ops.py 2026-10-04
41 builtin operator/method coverage (task 134 B) Gate: every builtin operator and method in extension_api.json has a Kotlin member or a recorded reason, and every builtin constant and enum a Kotlin counterpart (task 134 B). PR + push to main (ci.yml local-ci); local scripts/check_builtin_coverage.py 2026-10-04
42 ObjectCalls member/name parity (desktop vs iOS) Gate: every ObjectCalls helper the shared wrapper tree calls is a MEMBER of object ObjectCalls on desktop and on iOS, with the same parameter names in the same order. PR + push to main (ci.yml local-ci); local scripts/check_objectcalls_parity.py 2026-09-15
43 API exercise inventory drift Every ObjectCalls helper the shared wrapper tree calls is classified by how a generated API exercise can observe it. PR + push to main (ci.yml local-ci); local scripts/generate_api_exercise.py 2026-10-16
44 no default argument on an expect declaration (task 117 D24) Gate: no expect declaration in a *.expect.kt file carries a default argument (task 117 D24). PR + push to main (ci.yml local-ci); local scripts/check_expect_no_defaults.py 2026-10-01
45 runtime sources survive the Android source remap (task 131) Gate: the runtime sources survive the Android PanamaPort source remap (task 131). PR + push to main (ci.yml local-ci); local scripts/check_android_remap_sources.py 2026-10-02
46 no public member an expect lacks on an actual (task 117 D1) Gate: an actual declares no public member its expect does not (task 117 D1, P4′ review). PR + push to main (ci.yml local-ci); local scripts/check_actual_public_surface.py 2026-10-01
47 typed Godot enums and required returns (task 128 A) Gate: Godot enums surface as their value classes, required object returns are non-null, and the generated enum names follow their rules (task 128 A). PR + push to main (ci.yml local-ci); local scripts/check_typed_enums.py 2026-10-02
48 public API signatures vs snapshot (task 126) Gate: the public signatures of the Godot API surface change only when CHANGELOG.md says so (task 126). PR + push to main (ci.yml local-ci); local scripts/check_public_signature_changes.py 2026-10-03
49 virtual-method signature table drift (task 128 B) Generate (and with --check, drift-gate) the virtual-method signature table the KSP processor reads. PR + push to main (ci.yml local-ci); local scripts/generate_virtual_signature_table.py 2026-06-21
50 engine method-name table drift (task 133 B) Generate (and with --check, drift-gate) the engine method-name table the KSP processor reads. PR + push to main (ci.yml local-ci); local scripts/generate_engine_method_table.py 2026-10-03
51 iOS static-method dispatch (no zero instance reaches a guarded C entry, task 117 P2') Gate: nothing can hand a zero instance to a guarded iOS C entry point. PR + push to main (ci.yml local-ci); local scripts/check_ios_static_dispatch.py 2026-09-22
52 iOS self-test phases (no scene-init row constructs a class needing a late server) Gate: the iOS scene-init self-test constructs no class whose constructor needs a late server. PR + push to main (ci.yml local-ci); local. The staleness half runs only with a Godot source checkout of the pinned version; elsewhere it prints SKIP: ios-unsafe-classes-staleness, and CI allows that skip only through KANAMA_ALLOW_SKIP in ci.yml scripts/check_ios_selftest_phases.py 2026-11-08
53 iOS read-backs run the Godot method once (no measure-then-fill double call, task 129 D) Gate: every iOS Kotlin function runs a Godot method at most once per call. PR + push to main (ci.yml local-ci); local scripts/check_ios_single_call_returns.py 2026-10-14
54 iOS shim fault coverage (no guarded early return is silent, task 124) Gate: no guarded early return in the iOS C shim returns silently (task 124). PR + push to main (ci.yml local-ci); local scripts/check_ios_shim_faults.py 2026-10-01
55 iOS PT tag table parity (five copies, task 119 item 30) Gate: the five copies of the iOS ptrcall type-tag (PT_*) table agree, name by name and value by value. PR + push to main (ci.yml local-ci); local scripts/check_pt_tag_tables.py 2026-09-18
56 script portability (task 138 item 34) Script portability gate (task 138 item 34): one portable path, platform branches only in a shared helper. PR + push to main (ci.yml local-ci); local scripts/check_script_portability.py 2026-10-14
57 shell script lint (shellcheck) shellcheck gate over the repo's gate/smoke shell scripts. PR + push to main (ci.yml local-ci); local scripts/check_shell_lint.sh 2026-08-11
58 swallowed-failure audit (task 118) Gate: every swallowed failure in the gate scripts is justified in the code (task 118). PR + push to main (ci.yml local-ci); local scripts/audit_swallowed_failures.py 2026-10-04
59 hand-kept copies: iOS annotations, autoload KSP inputs (task 133 C2) Hand-kept copies that must stay equal (task 133 C2). PR + push to main (ci.yml local-ci); local scripts/check_hand_copies.py 2026-10-04
60 hand-code budget: every hand-written API file listed and line-ratcheted (task 129) Gate: every hand-written Kotlin file of the API package is on the budget, and none grows. PR + push to main (ci.yml local-ci); local scripts/check_hand_code_budget.py 2026-10-05
61 JDK install-location table parity (kanama#277) The JDK install-location table exists twice and the two copies must be equal (kanama#277). PR + push to main (ci.yml local-ci); local scripts/check_jdk_locations_parity.py 2026-10-02
62 JDWP bootstrap/project-setting guard The JDWP debug settings, the libjvm diagnostic and the editor/game-runner split are wired through bootstrap.c and both editor plugins. PR + push to main (ci.yml local-ci); local if ! grep -Eq 'debug/jdwp_port' "$ROOT_DIR/bootstrap/bootstrap.c" "$ROOT_DIR/ex… —
63 Gradle templates configure (starters + documented commands) the Gradle files users receive still configure under the repo's Gradle. PR + push to main (ci.yml local-ci); local scripts/check_gradle_templates_configure.sh 2026-10-02
64 gradle sync syncExampleAddonJar builds the addon jar and copies it into example_project. PR + push to main (ci.yml local-ci); local "$ROOT_DIR/gradlew" -p "$ROOT_DIR" syncExampleAddonJar —
65 ktfmt formatting check Formats hand-written Kotlin; generated api/ wrappers are excluded in build.gradle.kts. PR + push to main (ci.yml local-ci); local "$ROOT_DIR/gradlew" -p "$ROOT_DIR" ktfmtCheck —
66 KSP script-property default literals The KSP-generated registrars carry the source default literals, export metadata, cleanup hooks and method/RPC helpers the example project expects. PR + push to main (ci.yml local-ci); local find_project_script_registrar() { —
67 external addon install installAddonJar into a fresh project yields kanama.jar, kanama-scripts.jar, the .gdextension and the native bootstrap, and enables the extension. PR + push to main (ci.yml local-ci); local install_check_dir="$(mktemp -d "${TMPDIR:-/tmp}/kanama_local_ci_install.XXXXXX"… —
68 Linux native bootstrap preflight: file The installed Linux bootstrap is an ELF shared object. PR + push to main (Linux runner); Linux hosts only if ! file "$linux_native" \| grep -Eq 'ELF .*shared object'; then —
69 Linux native bootstrap preflight: ldd The installed Linux bootstrap has no missing dynamic dependencies. PR + push to main (Linux runner); Linux hosts only if ldd "$linux_native" \| grep -Eq 'not found'; then —
70 Linux native bootstrap preflight: readelf The installed Linux bootstrap's dynamic section carries no build-machine absolute paths. PR + push to main (Linux runner); Linux hosts only readelf -d "$linux_native" >/dev/null —
71 publish to mavenLocal publishKanamaToMavenLocal succeeds. PR + push to main (ci.yml local-ci); local "$ROOT_DIR/gradlew" -p "$ROOT_DIR" publishKanamaToMavenLocal —
72 mavenLocal publication The kanama, annotations and processor jars and sources jars exist at the published version in mavenLocal. PR + push to main (ci.yml local-ci); local maven_local="${KANAMA_MAVEN_LOCAL_REPO:-${HOME}/.m2/repository}/net/multigestur… —
73 bootstrap JDK resolution (kanama#277) The native bootstrap's CMake configure picks the right JDK and refuses a stale jni.h on every OS. PR + push to main (ci.yml local-ci); local scripts/check_bootstrap_jdk_resolution.sh 2026-10-02
74 bootstrap cmake build The native bootstrap configures and builds in Release with CMake. PR + push to main; local when cmake is installed (--skip-bootstrap skips) bootstrap_build_dir="$(mktemp -d "${TMPDIR:-/tmp}/kanama_bootstrap_build.XXXXXX… —
75 mkdocs strict build mkdocs build --strict passes (a broken link or a page missing from the nav fails). PR + push to main via the docs (mkdocs strict) job (local-ci passes --skip-docs); local when mkdocs is installed (cd "$ROOT_DIR" && mkdocs build --strict) —
76 web bridge + driver syntax node --check parses the JS bridge and every Web driver. PR + push to main; local when node is installed (--skip-web skips) node --check "$ROOT_DIR/web-runtime/src/webSpikeGodot/assets/kanama-web-bridge.… —
77 web bridge simulated-clock self-test The bridge's simulated clock is game time, not game time x scripted nodes (task 138 item 33 review). PR + push to main (ci.yml local-ci); local node "$ROOT_DIR/scripts/web/bridge_simtime_selftest.mjs" —
78 web bridge start self-test The bridge refuses a Kotlin/Wasm module it cannot run with one line saying what to do: no module, a runtime its main() did not start, a module of another protocol (task 135 item 5). PR + push to main (ci.yml local-ci); local node "$ROOT_DIR/scripts/web/bridge_bootstrap_selftest.mjs" —
79 web bridge live-script census self-test The bridge's live-script census counts a script once from its first _ready to its teardown, also after request_ready and when a slot's handle value comes back (task 142 review). PR + push to main (ci.yml local-ci); local node "$ROOT_DIR/scripts/web/bridge_live_scripts_selftest.mjs" —
80 web bridge RefCounted-hold self-test The bridge's RefCounted holds where no browser run reaches them: without a working FinalizationRegistry a snapshot hold or a dropped temporary releases nothing, and the lent cap evicts the least recently wrapped lend and bounds a Variant r… PR + push to main (ci.yml local-ci); local node "$ROOT_DIR/scripts/web/bridge_rc_ownership_selftest.mjs" —
81 web dodge round self-test The dodge driver's round logic: a round the player was hit in early is resumed to 4 mobs (the cell does not depend on the RNG), a second hit in a round, a hit before a round's first mob or sooner than a mob can reach the player is red, and… PR + push to main (ci.yml local-ci); local node "$ROOT_DIR/scripts/web/dodge_restart_selftest.mjs" —
82 web tpsdemo slow-page self-test The tpsdemo driver on a page that answers only between frames (Chrome on SwiftShader on the hosted runner: 11-31 s per frame): an evaluate waits up to PAGE_EVALUATE_TIMEOUT_MS, the input hold and the teardown wait for frames, not only for… PR + push to main (ci.yml local-ci); local node "$ROOT_DIR/scripts/web/tpsdemo_slow_page_selftest.mjs" —
83 web driver lint (eslint) Correctness lint over the same drivers (task 86: an unused variable held the Safari envelope's performance section back for two weeks). PR + push to main; local when node is installed (--skip-web skips) ( —
84 web export-smoke scaffold self-test exercises web_export_smoke.sh against a static fake fixture (Task 57f1 scaffold validation). PR + push to main (ci.yml local-ci); local scripts/web/scaffold_selftest.sh 2026-07-23
85 web budget builtin-call self-test Enforce the Web performance budgets (Task 60f, promotion criterion W4). PR + push to main (ci.yml local-ci); local scripts/web/check_budgets.py 2026-07-30
86 web backend dispatch drift gate Generate the Kotlin/Wasm Web backend dispatch from the Web backend call contract. PR + push to main (ci.yml local-ci); local scripts/generate_web_backend.py 2026-07-23
87 web wrapper tree drift gate Generate the Kotlin/Wasm Web wrapper tree from the Web call contract (task 96). PR + push to main (ci.yml local-ci); local scripts/generate_web_wrappers.py 2026-09-09
88 Web API exercise drift Generate the Web API exercise: one row per Web call shape. PR + push to main (ci.yml local-ci); local scripts/generate_web_exercise.py 2026-10-17
89 web typed Godot enums and required returns (task 128 C) Gate: the Web wrappers surface Godot enums as their value classes and keep Godot's required returns non-null (task 128 C) -- the Kotlin/Wasm twin of scripts/check_typed_enums.py. PR + push to main (ci.yml local-ci); local scripts/check_web_typed_enums.py 2026-10-02
90 web Wasm compile + coverage gate Kotlin/Wasm compile + the fail-loud gameplay coverage gate, over a project that is not a demo (task 142): a fresh starter goes through the user path -- the kotlin-src merge, KSP over a real script, the Wasm compile of it, and the generic s… PR + push to main (ci.yml local-ci); local web_starter_root="$(mktemp -d "${TMPDIR:-/tmp}/kanama_local_ci_web_starter.XXXX… —
91 runtime smoke: <godot> Godot loads the GDExtension, starts the JVM, registers the script language and resource loader, loads Kotlin scripts, and runs the example project to its expected log markers. PR + push to main (ci.yml local-ci); local scripts/runtime_smoke.sh 2026-05-20
92 @Tool smoke: <godot> A @Tool script executes inside the headless editor process and its expected log patterns appear. PR + push to main (ci.yml local-ci); local scripts/tool_smoke.sh 2026-05-20
93 editor probes: <godot> A saved Kotlin edit in a real editor is built on save by the checkout's Gradle build, reloaded, and seen by the editor: the status light, the new members, the inspector, the saved scene, and a compile error's red light. PR + push to main (ci.yml local-ci); local scripts/editor_probe_smoke.sh 2026-11-01
94 JDK lookup parity, bootstrap.c vs plugin: <godot> The runtime (bootstrap.c) and the editor plugin pick the same JDK from the same layout (kanama#277). PR + push to main (ci.yml local-ci); local scripts/check_jdk_lookup_parity.sh 2026-10-02
95 hot reload smoke: <godot> Across two editor runs around a HelloScript.kt rebuild, the hot-reload: reloaded scripts from ...kanama-scripts.jar (loader, old_loader, rebound, autoloads) marker appears. PR + push to main (ci.yml local-ci); local scripts/hot_reload_smoke.sh 2026-05-20
96 in-process hot reload smoke: <godot> One running editor process reloads an edited script after the in-process hot reload smoke ready signal, without a restart. PR + push to main (ci.yml local-ci); local scripts/hot_reload_in_process_smoke.sh 2026-05-20

CI workflow jobs

Parsed from .github/workflows/{ci,web,package}.yml. Scripts are the repo gate scripts a job invokes directly; local-ci runs every stage above.

Workflow Job When Scripts
ci.yml local-ci (linux) (gate) PR + push to main scripts/local_ci.sh
ci.yml docs (mkdocs strict) (docs) PR + push to main —
ci.yml detect changes (changes) PR + push to main scripts/gate_red_runs.py
ci.yml gate red runs (fast set) (gate-red-runs) PR + push to main, only when gates paths changed (docs-only PRs skip; push to main always runs) scripts/gate_red_runs.py
ci.yml gdextension-header (gdextension-header) PR + push to main, only when mobile paths changed (docs-only PRs skip; push to main always runs) —
ci.yml android (aar build) (android) PR + push to main, only when mobile paths changed (docs-only PRs skip; push to main always runs) scripts/generate_api_exercise.py
ci.yml ios (xcframework build) (ios) PR + push to main, only when mobile paths changed (docs-only PRs skip; push to main always runs) —
web.yml detect changes (changes) PR + push to main + nightly (cron) + manual —
web.yml web matrix (chrome + firefox) (matrix) PR + push to main + nightly (cron) + manual, only when web paths changed (docs-only PRs skip; push to main always runs) scripts/check_unapplied_annotations.py, scripts/web_ci_matrix.sh
web.yml issue #370 control (plain GDScript notifier) (visibility-control) nightly + manual only scripts/web/visibility_probe.py
web.yml soak (leak gate, chrome) (soak) nightly + manual only scripts/web_ci_matrix.sh
package.yml gdextension-header (gdextension-header) tag v* + manual scripts/check_godot_version_pin.py
package.yml android-aar (android-aar) tag v* + manual —
package.yml ${{ matrix.classifier }} (desktop-kit) tag v* + manual scripts/package_install_smoke.sh
package.yml cross-runtime (${{ matrix.target }} built on macOS) (cross-runtimes) tag v* + manual —
package.yml exported-game (${{ matrix.target }}, macOS-built runtime) (exported-game) tag v* + manual scripts/check_godot_version_pin.py, scripts/download_godot_macos.sh, scripts/export_game_smoke.sh
package.yml store-addon (store-addon) tag v* + manual scripts/package_install_smoke.sh
package.yml store-addon-windows (store-addon-windows) tag v* + manual scripts/package_install_smoke.sh, scripts/store_addon_editor_smoke.sh
package.yml android-export (${{ matrix.package }}) (android-export) tag v* + manual scripts/package_install_smoke.sh
package.yml ios-export (${{ matrix.package }}${{ matrix.mode == '--ios-without-scripts' && ', no scripts' || '' }}) (ios-export) tag v* + manual scripts/download_godot_macos.sh, scripts/package_install_smoke.sh
package.yml web-export (${{ matrix.package }}) (web-export) tag v* + manual scripts/package_install_smoke.sh
package.yml publish-release (publish-release) tag v* only —

Local-only gates

Hand-maintained in scripts/generate_gates_index.py (LOCAL_ONLY_GATES); descriptions come from the script headers where they exist.

Gate What it proves Where it runs Script First landed
Android device matrix (debug, four models) Nine-demo debug APK matrix on real hardware: export, install, launch, Kanama startup in logcat, non-blank screenshot; per demo via android_smoke.sh, the matrix loop is kanama-demos/scripts/android_smoke_all.sh local only (adb device); ledger by hand: record_gate_evidence.py --gate android-device-matrix scripts/android_smoke.sh 2026-05-20
Android Vulkan/Mobile renderer matrix The same nine-demo matrix with KANAMA_ANDROID_RENDERER=mobile, asserting the Vulkan renderer actually initialized (a silent GL fallback fails) local only (adb device); ledger by hand: record_gate_evidence.py --gate android-vulkan-mobile-matrix scripts/android_smoke.sh 2026-05-20
Android R8-minified release Reproducible R8-minified Android release smoke for the Kanama plugin. local only (adb device); ledger by hand: record_gate_evidence.py --gate android-r8-release scripts/android_export_minified.sh 2026-06-26
iOS device gate Runs Kanama's public-safe iOS physical-device validation gate local only (USB device + Apple team); ledgers itself on PASS scripts/ios_device_gate.sh 2026-06-25
iOS visual smoke Creates a temporary pure-Godot visual scene, installs Kanama's experimental iOS addon artifacts, exports an iOS Xcode project, builds it for a physical iOS device or an explicitly selected simulator, installs it, and launches it. local only (device or simulator) scripts/ios_visual_smoke.sh 2026-06-11
iOS export-template preflight Checks that a Godot iOS export template contains arm64 simulator engine archives. local (also invoked by the iOS Gradle export path) scripts/ios_template_preflight.sh 2026-06-11
Web Safari corpus The Web export corpus driven in Safari (--engine safari, run alone): Safari has no headless mode, so this is a GUI-session gate, spot-checked not gated local only; ledgers itself on PASS (Safari runs) scripts/web_ci_matrix.sh 2026-07-28
Web tps-demo cell The one corpus demo a hosted runner cannot build (Kotlin/Wasm compile OOM): --demo-set full runs it, ci announces and skips it local only (--demo-set full); nightly CI records it as skipped-with-reason scripts/web_ci_matrix.sh 2026-07-28
Web per-cell export smoke production Web export smoke harness (Task 57f). PR + push to main + nightly via web_ci_matrix.sh; local scripts/web_export_smoke.sh 2026-07-23
Web fresh-checkout export fresh-source-checkout Web export gate (Task 60g, W3). local only (pre-release, pre-promotion) scripts/web_fresh_checkout_smoke.sh 2026-07-27
Web package smoke prove a packaged Web export zip IS the game. local only (after packageWebExport) scripts/web_package_smoke.sh 2026-08-12
Fresh-clone source + demo gate Clones Kanama and kanama-demos into an isolated temporary workspace, uses temporary Gradle and Maven-local state, then runs the source and demo smoke checks a new contributor would depend on. local only (before a release tag) scripts/fresh_clone_smoke.sh 2026-05-26
Exported-game smoke Task 63 (issue #102) — exported-game smoke: prove the unpack-and-play story. tag / manual (package.yml exported-game); local — host runs ledgered by hand (macos-exported-game, windows-exported-game-hardware) scripts/export_game_smoke.sh 2026-08-03
Package install smoke Unzips a packaged Kanama desktop kit or store addon into a temporary project, builds the starter Kotlin script without a sibling Kanama source checkout, and optionally launches Godot: the starter must run, and a pack export must hold nothi… tag / manual (package.yml desktop-kit, store-addon); local scripts/package_install_smoke.sh 2026-05-27
Desktop demo smoke matrix Nine-demo desktop runtime smoke on a host Godot binary; the demos repo has no CI, so this is the desktop gameplay evidence for every host local only; ledger by hand per host (macos-local-ci-desktop-smoke, windows-local-revalidation, linux-*-full-gate) kanama-demos/scripts/desktop_smoke_all.sh —

Retired gates

Removed on purpose, with the evidence that another gate covers the same ground. Hand-maintained in scripts/generate_gates_index.py (RETIRED_GATES, KEPT_AFTER_REVIEW).

Script Retired Subsumed by Evidence
scripts/audit_scalar_float_abi.py 2026-09-09 (task 99) scripts/audit_ptrcall_helper_layouts.py The layout audit fails any helper without a Color slot that uses JAVA_FLOAT and any float-slot helper that does not use JAVA_DOUBLE (audit_helper), across all 1,500 parsed helpers; the retired script name-matched 30 ptrcall*Float* helpers (20 of them packed-array helpers) and a ±10-line "Color" text window. Measured at retirement: all 30 helpers and all 464 JAVA_FLOAT sites in ObjectCalls.kt lie inside layout-audited bodies. Not carried over: the KDoc-wording check that those 30 helpers say "scalar float".
scripts/check_wrapper_parity.py 2026-10-01 (task 117 P4′) the Kotlin compiler (expect/actual); scripts/check_wrapper_generator.py; scripts/check_actual_public_surface.py The gate (with scripts/wrapper_parity_allowlist.txt) diffed the desktop and iOS copies of the hand-shaped per-platform classes, GodotSignal and SignalConnection at the end, member by member. Since P4′ they are expect classes in src/commonMain/.../api/GodotSignal.expect.kt and MainThread an expect object, so the compiler fails any expect member without an actual on either platform, and a mismatched kind, modality, supertype, constructor or signature. The gate's stale-root check (a per-platform copy of GodotObject / RefCounted / GodotCallable) stayed in the drift gate check_wrapper_generator.py (red run in b375b019). What the compiler does NOT reject — an actual carrying an extra public member, D1's one-sided-member finding — is check_actual_public_surface.py. Not carried over: comparing the two actuals' parameter NAMES (expect/actual matching is by signature; common callers see the expect's names).

Reviewed as a retirement candidate and kept:

Script Candidate successor Why it stays
scripts/audit_wrapper_signatures.py scripts/audit_wrapper_abi_policy.py The ABI policy audit re-checks arity, argument and return storage kinds with the exact value_policy model (stricter than the coarse compatible()), but has no counterpart for the three name-collision checks: generated methods colliding with java.lang.Object (wait/notify/getClass), a Godot close shadowing AutoCloseable.close(), and collisions with final GodotObject API. Both the policy audit and the layout audit also import helper_shape, BIND_RE, CALL_RE and friends from it.

Gate evidence ledger

evidence/gates.json records each run of a local-only gate: gate, Godot pin, Kanama commit, date, device or browser, result, and the doc line it backs. scripts/ios_device_gate.sh and scripts/web_ci_matrix.sh (Safari runs) append to it on PASS via scripts/record_gate_evidence.py; the Android matrix (its loop lives in the demos repo) and the Windows/Linux host revalidations are recorded by hand:

python3 scripts/record_gate_evidence.py --gate android-device-matrix --result PASS \
  --where "Pixel 7 (Android 16), Moto g 5G 2023 (Android 14)" --claim "Android Supported"

scripts/check_gate_evidence.py fails when the latest run of a gate is on an older pin than gradle.properties unless the entry carries acceptedStaleUntil (a future date) and acceptedStaleReason; an accepted-stale entry passes with a loud WARN, and an expired acceptance fails. Latest run per gate:

Gate Claim Last run Godot pin Result Accepted stale until
android-debug-matrix Android Supported 2026-10-01 4.7.2.stable PASS 2026-12-31
android-device-matrix Android Supported 2026-07-13 4.7.stable PASS 2026-12-31
android-r8-release Android Supported 2026-10-01 4.7.2.stable PASS 2026-12-31
android-vulkan-mobile-matrix Android Supported 2026-07-10 4.7.stable PASS 2026-12-31
ios-device-gate iOS Supported 2026-09-11 4.7.2.stable PASS 2026-12-31
linux-arm64-full-gate Linux arm64 Supported 2026-07-14 4.7.stable PASS 2026-12-31
linux-x86_64-full-gate Linux x86_64 Supported 2026-07-14 4.7.stable PASS 2026-12-31
macos-exported-game macOS exported games boot from the bundled jlink runtime 2026-09-10 4.7.2.stable PASS 2026-12-31
macos-local-ci-desktop-smoke Godot 4.7 stable, macOS arm64 Supported 2026-09-08 4.7.2.stable PASS 2026-12-31
web-ios-safari-hand-pass Web Experimental (iOS/iPadOS hand-checked, not gated) 2026-08-03 4.7.stable PARTIAL 2026-12-31
web-safari-local-corpus Web Experimental (Safari validated-at, spot-checked not gated) 2026-08-20 4.7.stable PASS 2026-12-31
windows-exported-game-hardware Windows x86_64 Supported 2026-08-10 4.7.stable PASS 2026-12-31
windows-local-revalidation Windows x86_64 Supported 2026-07-13 4.7.stable PASS 2026-12-31