feat(Chobby): add declarative sharing modes system

.busted

@@ -0,0 +1,43 @@
+return {
+
+  default = {
+    -- add your project roots to Lua’s package.path for tests
+    -- This is necessary during the initial phase of the Lux rollout
+    --   where we don't have a project root and `src/` directory in accordance with canonical lua rock/package structure
+    --   https://github.com/beyond-all-reason/Beyond-All-Reason/pull/6005#issuecomment-3504830009
+    lpath = table.concat({
+      "./?.lua", "./?/init.lua",
+      "common/?.lua", "common/?/init.lua",
+      "common/luaUtilities/?.lua", "common/luaUtilities/?/init.lua",
+      "luarules/?.lua", "luarules/?/init.lua",
+      "luaui/?.lua", "luaui/?/init.lua",
+      "spec/?.lua", "spec/?/init.lua",
+    }, ";")
+  },
+  -- Default configuration
+  verbose = true,
+  output = "utfTerminal",
+  pattern = "_spec",
+  ROOT = { "spec/" },
+
+  -- Named tasks
+  _all = {
+    verbose = true,
+    output = "utfTerminal",
+    pattern = "_spec",
+    helper = "spec/spec_helper.lua",
+    ROOT = { "spec/" }
+  },
+  unit = {
+    verbose = true,
+    ROOT = { "spec/" }
+  },
+  coverage = {
+    verbose = true,
+    output = "utfTerminal",
+    pattern = "_spec",
+    helper = "spec/spec_helper.lua",
+    coverage = true,
+    ROOT = { "spec/" }
+  }
+}

.github/PULL_REQUEST_TEMPLATE.md

@@ -35,3 +35,8 @@ changes so it's easier for reviewers to see what is different in this PR
 #### AFTER:
 (screenshot from branch)
 -->
+
+<!-- If relevant
+### AI / LLM usage statement:
+Tell us if you used an AI or LLM in the creation of this code, which AI tool was used, and to what extent.
+-->

.github/workflows/test_integration.yml

@@ -0,0 +1,50 @@
+name: Run Integration Tests
+
+on:
+  workflow_dispatch:
+    inputs:
+      custom_engine_url:
+        description: 'Optional custom engine URL (overrides stock engine)'
+        required: false
+        default: ''
+  pull_request:
+  push:
+    branches:
+      - 'master'
+
+jobs:
+  run-tests:
+    name: docker compose up (headless)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Upload Event File
+        uses: actions/upload-artifact@v4
+        with:
+          name: Event File
+          path: ${{ github.event_path }}
+
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Build Test Image
+        env:
+          CUSTOM_ENGINE_URL: ${{ github.event.inputs.custom_engine_url || vars.CUSTOM_ENGINE_URL || '' }}
+        run: |
+          BUILD_ARGS=""
+          if [ -n "$CUSTOM_ENGINE_URL" ]; then
+            BUILD_ARGS="--build-arg CUSTOM_ENGINE_URL=$CUSTOM_ENGINE_URL"
+          fi
+          docker compose -f tools/headless_testing/docker-compose.yml build $BUILD_ARGS bar
+        timeout-minutes: 15
+
+      - name: Run Tests
+        run: docker compose -f tools/headless_testing/docker-compose.yml up --no-build
+        timeout-minutes: 30
+
+      - name: Upload Integration Test Results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: Integration Test Results
+          path: |
+            tools/headless_testing/testlog/results.json

.github/workflows/test_integration_report.yml

@@ -0,0 +1,38 @@
+name: Process Integration Tests
+
+on:
+  workflow_run:
+    workflows: ["Run Integration Tests"]
+    types:
+      - completed
+
+permissions: {}
+
+run-name: "Process Integration Tests - ${{ github.event.workflow_run.display_title }}"
+jobs:
+  process-test-results:
+    name: Integration Test Results
+    runs-on: ubuntu-latest
+    if: github.event.workflow_run.conclusion != 'skipped'
+    permissions:
+      checks: write
+      pull-requests: write
+      actions: read
+
+    steps:
+      - name: Download Artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+          github-token: ${{ github.token }}
+          run-id: ${{ github.event.workflow_run.id }}
+      - name: Publish Test Results
+        uses: EnricoMi/publish-unit-test-result-action@v2
+        with:
+          check_name: Integration Test Results
+          action_fail_on_inconclusive: true
+          time_unit: milliseconds
+          commit: ${{ github.event.workflow_run.head_sha }}
+          event_file: artifacts/Event File/event.json
+          event_name: ${{ github.event.workflow_run.event }}
+          files: "artifacts/Integration Test Results/*.json"

.github/workflows/test_unit.yml

@@ -0,0 +1,35 @@
+name: Run Unit Tests
+
+on:
+  push:
+    branches: ['*']
+  pull_request:
+    branches: ['*']
+
+jobs:
+  busted:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v5
+
+    - name: Install Lua 5.1
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y lua5.1 liblua5.1-0-dev
+
+    - name: Install Lux
+      uses: lumen-oss/gh-actions-lux@v1
+      with:
+        version: 0.26.1
+
+    - name: Cache Lux dependencies
+      uses: actions/cache@v4
+      with:
+        path: .lux
+        key: lux-5.1-${{ runner.os }}-${{ hashFiles('lux.lock') }}
+        restore-keys: |
+          lux-5.1-${{ runner.os }}-
+
+    - name: Run busted
+      run: lx --lua-version 5.1 test

.gitignore

@@ -6,3 +6,4 @@
 *.iml
 .project
 *.code-workspace
+.lux/

.luarc.json

@@ -1,24 +1,55 @@
 {
   "$schema": "https://raw.githubusercontent.com/sumneko/vscode-lua/master/setting/schema.json",
-  "runtime.version": "Lua 5.1",
   "completion.requireSeparator": "/",
+  "diagnostics": {
+    "type": {
+      "definition": [
+        ".lux/",
+        "types/",
+        "recoil-lua-library/library/"
+      ]
+    }
+  },
   "runtime.path": [
-      "?",
-      "?.lua"
+    "?",
+    "?.lua"
   ],
   "runtime.special": {
-      "VFS.Include": "require",
-      "include": "require",
-      "shard_include": "require"
+    "VFS.Include": "require",
+    "include": "require",
+    "shard_include": "require"
+  },
+  "runtime.version": "Lua 5.1",
+  "semantic": {
+    "enable": true
   },
   "workspace": {
-    "library": [
-      "recoil-lua-library"
-    ],
     "ignoreDir": [
       ".vscode",
       "luaui/Tests",
       "luaui/TestsExamples"
+    ],
+    "library": [
+      "common/luaUtilities",
+      "recoil-lua-library",
+      "luarules",
+      "luaui",
+      "spec",
+      "types",
+      ".lux/5.1/test_dependencies/5.1/01a3c364614bddff7370223a5a9c4580f8e62d144384148444c518ec5367a59b-mediator_lua@1.1.2-0/src",
+      ".lux/5.1/test_dependencies/5.1/287e827f4a088d41bba04af5f61a13614346c16fe8150eb7c4246e67d6fd163e-lua-term@0.8-1/src",
+      ".lux/5.1/test_dependencies/5.1/316ac0b30e04e86a253d64886f3b110bd0508267474e6b58a3b973bd6857dbf4-penlight@1.14.0-3/src",
+      ".lux/5.1/test_dependencies/5.1/3b3d395f3fb9f72fec6e61ddca4f99228008e0fe4aa433b4823e9f50f4d93d84-luafilesystem@1.8.0-1/src",
+      ".lux/5.1/test_dependencies/5.1/455cd98d50c6191a9685cffcda4ce783efbb957934625e134c39f43bd5df6818-luassert@1.9.0-1/src",
+      ".lux/5.1/test_dependencies/5.1/47b12edcdc032232157ace97bddf34bddd17f6f458095885e62bbd602ad9e9ec-luasystem@0.6.3-1/src",
+      ".lux/5.1/test_dependencies/5.1/4e9592a499c9ced4f8ce366db9db7d9c0dd1424ea8d4c8c16c1550ea3a61a696-say@1.4.1-3/src",
+      ".lux/5.1/test_dependencies/5.1/6ce29c2c535c40246c386c056f24689344cddb56ec397473931431e6b67694d2-say@1.4.1-3/src",
+      ".lux/5.1/test_dependencies/5.1/832fd9862ce671c0c9777855d4c8b19f9ad9c2679fb5466c3a183785a51b76b0-luafilesystem@1.8.0-1/src",
+      ".lux/5.1/test_dependencies/5.1/8925c25e69bb2ef4a2007b536827894dfcca7c1ff54572256002997105acb847-inspect@3.1.3-0/src",
+      ".lux/5.1/test_dependencies/5.1/a6c5176043cb3de56336b7de119443dbb3d9e024be1d50e06289ad4b4959a2da-lua_cliargs@3.0.2-1/src",
+      ".lux/5.1/test_dependencies/5.1/e4f17b9e67313bbd5e90f425672fc8998dd0bfa43335f7c57ed2de7a799e07a6-dkjson@2.8-1/src",
+      ".lux/5.1/test_dependencies/5.1/fa396ffe12257288dc0716c35d37ecff7c262c8b242e95906777055a08419940-busted@2.2.0-1/src",
+      ".lux/5.1/test_dependencies/5.1/fd314d02e320aea863d0e3d2105fc515bd41704f3ef68c947cf074313878e8c2-luassert@1.9.0-1/src"
     ]
   }
-}
+}

.stylelua.toml

@@ -0,0 +1,12 @@
+syntax = "All"
+column_width = 120
+line_endings = "Unix"
+indent_type = "Spaces"
+indent_width = 2
+quote_style = "AutoPreferDouble"
+call_parentheses = "Always"
+collapse_simple_statement = "Never"
+space_after_function_names = "Never"
+
+[sort_requires]
+enabled = true

AI_POLICY.md

@@ -0,0 +1,69 @@
+# AI Usage Policy  
+
+## Disclosure requirements
+
+**AI usage in generating code must be explicitly disclosed in the associated Pull Request.**  
+Contributors must clearly state:
+- which AI tool(s) were used (for example: Claude Code, Cursor, Copilot)
+- the extent to which the contribution was AI-assisted
+
+**Undisclosed AI usage will result in closure.**  
+If maintainers reasonably suspect undisclosed AI use, the pull request will be closed.
+
+**Non-direct AI usage does not require disclosure.**  
+The above requirements apply to cases where AI is used to write production code.  
+If AI is used solely as an advisory or educational tool, disclosure is not required.
+
+## Verification and testing
+
+**All AI-assisted code must be fully verified by a human contributor.**  
+Contributors are responsible for ensuring that:
+- the code has been run and tested
+- the code behaves correctly in practice, not just in theory
+
+It is recommended to attach test artifacts, such as screenshots or recordings, that demonstrate your code working for each test step.
+
+## Issues and discussions
+
+**AI assistance is permitted in issues and discussions, with a strict human-in-the-loop requirement:**
+
+- AI-generated content must be reviewed and edited by a human before submission.
+- Verbosity, noise, and speculative content must be removed.
+- Contributors remain responsible for research, accuracy, and clarity.
+
+AI may assist with explanations, summaries, or drafting, but must not replace understanding or judgment.
+
+## Prohibited content
+
+**AI-generated media is not permitted.**  
+This includes, but is not limited to: art, images, videos, and audio.  
+Only text and code are eligible for AI assistance, subject to the rules above.
+
+## Enforcement
+
+**Repeated or intentional misuse of AI tools may result in contributor bans.**  
+Maintainers may enforce this policy at their discretion.
+
+## Why is this important?
+
+Beyond All Reason is maintained by humans.
+
+Every issue, discussion, and pull request is read and reviewed by maintainers who volunteer their time and expertise. Submitting low-effort, unverified, or poorly understood work shifts the burden of validation onto maintainers and is considered disrespectful of that effort.
+
+The primary behavior this policy seeks to prevent is **Vibe Coding**, defined as the uncritical generation and submission of AI-produced code without sufficient understanding, verification, or accountability by the contributor. This policy exists to prevent wasted maintainer time and to ensure high standards of code quality and maintainability.
+
+This policy exists to protect maintainers, preserve code quality, and ensure that collaboration remains productive and sustainable.
+
+## Responsible AI usage is welcome
+
+Beyond All Reason maintainers actively use AI tools as part of their workflow. 
+This policy does not represent an anti-AI position.
+
+The restrictions outlined above exist due to repeated misuse of AI by contributors who submit unverified, low-quality, or poorly understood work. The issue is not the tools themselves, but how they are applied.
+
+When used responsibly, transparently, and with proper human oversight, AI can be a valuable productivity aid.
+
+## Attribution
+
+This policy is adapted from the original AI usage policy published by the [Ghostty](https://github.com/ghostty-org/ghostty/blob/main/AI_POLICY.md) organization.  
+The Beyond All Reason team acknowledges and appreciates the clarity and intent of the original text.