{"id":50115419,"url":"https://github.com/widgrensit/asobi-test-harness","last_synced_at":"2026-05-23T14:34:19.739Z","repository":{"id":354578949,"uuid":"1219382368","full_name":"widgrensit/asobi-test-harness","owner":"widgrensit","description":"Docker-compose + deterministic Lua game mode for validating Asobi SDK clients in CI.","archived":false,"fork":false,"pushed_at":"2026-04-29T05:33:16.000Z","size":19,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-29T07:23:55.518Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Erlang","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/widgrensit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-23T20:24:36.000Z","updated_at":"2026-04-29T05:33:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/widgrensit/asobi-test-harness","commit_stats":null,"previous_names":["widgrensit/asobi-test-harness"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/widgrensit/asobi-test-harness","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/widgrensit%2Fasobi-test-harness","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/widgrensit%2Fasobi-test-harness/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/widgrensit%2Fasobi-test-harness/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/widgrensit%2Fasobi-test-harness/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/widgrensit","download_url":"https://codeload.github.com/widgrensit/asobi-test-harness/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/widgrensit%2Fasobi-test-harness/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33400248,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T04:15:53.637Z","status":"ssl_error","status_checked_at":"2026-05-23T04:15:53.242Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-23T14:34:16.778Z","updated_at":"2026-05-23T14:34:19.733Z","avatar_url":"https://github.com/widgrensit.png","language":"Erlang","funding_links":[],"categories":[],"sub_categories":[],"readme":"# asobi-test-harness\n\nA minimal, deterministic Asobi backend for validating SDKs in CI. Not a demo, not a dev environment — just a fixed game mode and a known-good server every SDK's smoke test can run against.\n\n## What's in the box\n\n- `docker-compose.yml` — Postgres + `ghcr.io/widgrensit/asobi_lua:latest` on port 8080.\n- `lua/smoke.lua` — a deliberately boring 2-player match that echoes inputs into state. Tick counter increments; the match auto-finishes at tick 150.\n- `lua/smoke_world.lua` — parallel world-mode fixture (entity-per-player, single zone). Used by the multiplayer-CT fanout property and any SDK world-mode smoke test.\n- `lua/config.lua` — registers the `smoke` and `smoke_world` modes with asobi_lua.\n- `scenarios/canonical.md` — the contract every SDK's smoke test must satisfy.\n- `multiplayer_ct/` — Erlang/PropEr CT suite that drives N concurrent clients into one `smoke_world` world and asserts zone-broadcast fanout. See `multiplayer_ct/README.md`.\n\n## Running locally\n\n```bash\ndocker compose up -d\n# wait ~10 seconds for health\ncurl http://localhost:8080/api/v1/health\n```\n\nTear down when done:\n\n```bash\ndocker compose down -v\n```\n\n## SDK smoke test layout\n\nEvery client SDK has a `smoke_tests/` folder with one runnable script that:\n\n1. Reads `ASOBI_URL` (default `http://localhost:8080`).\n2. Exercises the 3 canonical scenarios in `scenarios/canonical.md`.\n3. Exits non-zero on failure.\n\nCI in each SDK repo starts this harness, runs the smoke test, tears down. See `asobi-js/smoke_tests/` for the reference implementation.\n\n## Why this repo is separate\n\n- **Single source of truth.** One game mode, one Docker setup, seven SDKs pointing at it. If the protocol drifts, one test file fails in one repo.\n- **Not a demo.** No art, no UI, no scenes. Meant for CI, not for showing off.\n- **Parallel to the demos.** Per-engine demo projects (`asobi-unreal-demo`, `asobi-unity-demo`, etc.) still exist — they're the marketing / DX layer. This is the validation layer.\n\n## License\n\nApache 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwidgrensit%2Fasobi-test-harness","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwidgrensit%2Fasobi-test-harness","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwidgrensit%2Fasobi-test-harness/lists"}