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.ymljoblocal-ci (linux)runsscripts/local_ci.sh --skip-docs) and locally withscripts/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.jsonandscripts/check_gate_evidence.py(insidescripts/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 |