Fix messaging bugs, add tests, CI, and project docs

.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.lua]
+indent_style = space
+indent_size = 4
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{toc,txt}]
+indent_style = space
+indent_size = 4

.gitattributes

@@ -0,0 +1,12 @@
+* text=auto eol=lf
+
+*.lua text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+*.md text eol=lf
+*.toc text eol=lf
+*.txt text eol=lf
+*.sh text eol=lf
+.luacheckrc text eol=lf
+.editorconfig text eol=lf
+.gitignore text eol=lf

.github/workflows/ci.yml

@@ -0,0 +1,70 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install Lua 5.1 and Luacheck
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y lua5.1 liblua5.1-0-dev luarocks
+          sudo luarocks --lua-version=5.1 install luacheck
+          luacheck --version
+
+      - name: Run tests (Lua 5.1, full suite)
+        run: lua5.1 tests/run.lua
+
+      - name: Run Luacheck on core helpers and tests
+        run: |
+          luacheck --config .luacheckrc \
+            AIO_Server/queue.lua AIO_Client/queue.lua \
+            AIO_Server/aio_util.lua AIO_Client/aio_util.lua \
+            AIO_Server/aio_framing.lua AIO_Client/aio_framing.lua \
+            AIO_Server/aio_reassembler.lua AIO_Client/aio_reassembler.lua \
+            AIO_Server/aio_rpc.lua AIO_Client/aio_rpc.lua \
+            AIO_Server/aio_core.lua AIO_Client/aio_core.lua \
+            tests/run.lua tests/test_queue.lua tests/test_smallfolk.lua \
+            tests/test_framing.lua tests/test_util.lua tests/test_stored.lua \
+            tests/test_path_legacy.lua tests/test_reassembler.lua tests/test_lualzw.lua \
+            tests/test_aio_rpc.lua tests/test_aio_core.lua \
+            tests/lua_compat.lua tests/wow_stub.lua tests/aio_integration_util.lua \
+            tests/test_aio_integration_server.lua tests/test_aio_integration_client.lua
+
+      - name: Run Luacheck on WoW-only side modules
+        run: |
+          luacheck --config .luacheckrc \
+            AIO_Server/aio_server_pipeline.lua AIO_Client/aio_client_ui.lua
+
+      - name: Verify server and client shared modules stay in sync
+        run: |
+          diff -q AIO_Server/AIO.lua AIO_Client/AIO.lua
+          diff -q AIO_Server/aio_util.lua AIO_Client/aio_util.lua
+          diff -q AIO_Server/aio_framing.lua AIO_Client/aio_framing.lua
+          diff -q AIO_Server/aio_reassembler.lua AIO_Client/aio_reassembler.lua
+          diff -q AIO_Server/aio_rpc.lua AIO_Client/aio_rpc.lua
+          diff -q AIO_Server/queue.lua AIO_Client/queue.lua
+          diff -q AIO_Server/aio_core.lua AIO_Client/aio_core.lua
+
+  test-server-lua:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        lua: ["5.2", "5.3", "5.4"]
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install Lua ${{ matrix.lua }}
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y "lua${{ matrix.lua }}"
+
+      - name: Run tests (unit + server AIO integration; client suite skipped)
+        run: lua${{ matrix.lua }} tests/run.lua

.gitignore

@@ -0,0 +1,17 @@
+# OS and editor
+.DS_Store
+Thumbs.db
+*.swp
+*.swo
+*~
+
+# Local config overrides (if used)
+config.lua
+
+# IDE
+.idea/
+.vscode/
+*.code-workspace
+
+# Test / build artifacts
+*.luac

.luacheckrc

@@ -0,0 +1,98 @@
+std = "lua51"
+
+exclude_files = {
+    "AIO_Server/Dep_*",
+    "AIO_Client/Dep_*",
+    "AIO_Server/lualzw-zeros/**",
+    "AIO_Client/lualzw-zeros/**",
+    "Examples/**",
+}
+
+max_line_length = 120
+
+globals = {
+    "AIO",
+    "LibStub",
+    "GetLuaEngine",
+    "GetTime",
+    "GetStateMapId",
+    "RegisterServerEvent",
+    "RegisterPlayerEvent",
+    "CreateFrame",
+    "CreateLuaEvent",
+    "GetPlayersInWorld",
+    "SendAddonMessage",
+    "UnitName",
+    "ReloadUI",
+    "SlashCmdList",
+    "_ERRORMESSAGE",
+    "Smallfolk",
+    "NewQueue",
+    "lualzw",
+    "Ping",
+    "test",
+    "assert_eq",
+    "assert_true",
+    "require",
+    "package",
+    "debug",
+}
+
+files["AIO_Server/aio_util.lua"] = {}
+files["AIO_Client/aio_util.lua"] = {}
+
+files["AIO_Server/queue.lua"] = {}
+files["AIO_Client/queue.lua"] = {}
+
+files["AIO_Server/aio_framing.lua"] = {}
+files["AIO_Client/aio_framing.lua"] = {}
+
+files["AIO_Server/aio_reassembler.lua"] = {}
+files["AIO_Client/aio_reassembler.lua"] = {}
+
+files["AIO_Server/aio_rpc.lua"] = {}
+files["AIO_Client/aio_rpc.lua"] = {}
+
+files["AIO_Server/aio_core.lua"] = {}
+files["AIO_Client/aio_core.lua"] = {}
+
+files["AIO_Server/aio_server_pipeline.lua"] = {
+    ignore = {"1.", "2.", "3.", "4.", "5.", "6."},
+}
+
+files["AIO_Client/aio_client_ui.lua"] = {
+    ignore = {"1.", "2.", "3.", "4.", "5.", "6."},
+}
+
+files["AIO_Server/AIO.lua"] = {
+    ignore = {"1.", "2.", "3.", "4.", "5.", "6."},
+}
+
+files["AIO_Client/AIO.lua"] = {
+    ignore = {"1.", "2.", "3.", "4.", "5.", "6."},
+}
+
+files["tests/run.lua"] = {
+    globals = {"dofile", "os", "skip"},
+}
+
+files["tests/lua_compat.lua"] = {
+    ignore = {"1.", "2.", "3.", "4.", "5.", "6."},
+}
+
+files["tests/wow_stub.lua"] = {
+    ignore = {"1.", "2.", "3.", "4.", "5.", "6."},
+}
+
+files["tests/aio_integration_util.lua"] = {
+    ignore = {"1.", "2.", "3.", "4.", "5.", "6."},
+}
+
+files["tests/test_aio_integration_server.lua"] = {
+    ignore = {"1.", "2.", "3.", "4.", "5.", "6."},
+}
+
+files["tests/test_aio_integration_client.lua"] = {
+    ignore = {"1.", "2.", "3.", "4.", "5.", "6."},
+}
+