First upload

docs/reference/Untitled

@@ -0,0 +1,13 @@
+## 13. Prompting: deep analytic experience
+
+**Mode A — single transcript, JSON only**
+
+> “For this single transcript, use **Mode A: Extraction** and respond only with a single JSON object that follows the top‑level structure in the ‘Single‑transcript JSON response schema’ and the field definitions in ‘Transcript analytics schemas (per‑field definitions)’. Follow the General extraction rules. Output only valid JSON.”
+
+**Mode B — single transcript, narrative**
+
+> “Using the schemas in this document (support issue categories, ticket tags, wiki categories and slug patterns, game‑specific topics, game detection, Broccolini team IDs, wiki suggestion & outcome analytics), summarize this ticket transcript. Include account & contact, issue (with game_detected and game_or_server), reproduction, environment, priority & impact, rules/abuse if applicable, suggested wiki slugs, and any staff mentions/requests/sentiment. Note whether any wiki article appeared to solve or not solve the issue, and whether the user wanted Broccolini to ‘do it’ or was walked through doing it themselves.”
+
+**Mode C — batch analytics**
+
+> “Using **Mode C: Batch analytics** over transcripts in [path] or a list of JSON objects from Mode A, compute per‑ticket and aggregate analytics from this document: issue categories, tags, game_detected and game_or_server distributions, wiki usage and success/failure, staff involvement and wiki‑linked outcomes, email analytics, frequency/impact distributions, resolution patterns, intake gaps, and all recurring analytics in the Broccolini support section. Output tables and a concise narrative per major dimension.”

docs/reference/game-list.md

@@ -0,0 +1,97 @@
+# Game list (Broccolini Bot schema)
+
+Canonical list of games and their **display name**, **key** (snake_case), and **aliases**. Used by `config.js` (`GAME_LIST`, `GAME_ALIASES`, `GAME_NAME_TO_KEY`) and `game-options.json`.
+
+## GAME_LIST (display names, comma-separated)
+
+Use this value for the `GAME_LIST` env var:
+
+```
+7 Days to Die, Abiotic Factor, ARK: Survival Evolved, Conan Exiles, Core Keeper, Counter-Strike 2, DayZ, ECO, Enshrouded, Factorio, FiveM, The Front, Garry's Mod, Hytale, ICARUS, Minecraft, Necesse, Palworld, Project Zomboid, Rust, Satisfactory, Sons of the Forest, Soulmask, Star Rupture, Terraria, Valheim, VEIN, Vintage Story, Voyagers of Nera, V Rising
+```
+
+## Table (display name, key, aliases)
+
+| Display name | Key | Aliases |
+|--------------|-----|--------|
+| 7 Days to Die | `7_days_to_die` | `7D2D`, `7 days` |
+| Abiotic Factor | `abiotic_factor` | — |
+| ARK: Survival Evolved | `ark_survival_evolved` | `Ark` |
+| Conan Exiles | `conan_exiles` | — |
+| Core Keeper | `core_keeper` | — |
+| Counter-Strike 2 | `counter_strike_2` | `CS2` |
+| DayZ | `dayz` | — |
+| ECO | `eco` | — |
+| Enshrouded | `enshrouded` | — |
+| Factorio | `factorio` | — |
+| FiveM | `fivem` | — |
+| The Front | `the_front` | — |
+| Garry's Mod | `garrys_mod` | — |
+| Hytale | `hytale` | — |
+| ICARUS | `icarus` | — |
+| Minecraft | `minecraft` | `MC` |
+| Necesse | `necesse` | — |
+| Palworld | `palworld` | — |
+| Project Zomboid | `project_zomboid` | `PZ`, `zomboid` |
+| Rust | `rust` | — |
+| Satisfactory | `satisfactory` | — |
+| Sons of the Forest | `sons_of_the_forest` | `SOTF` |
+| Soulmask | `soulmask` | — |
+| Star Rupture | `star_rupture` | — |
+| Terraria | `terraria` | — |
+| Valheim | `valheim` | — |
+| VEIN | `vein` | — |
+| Vintage Story | `vintage_story` | — |
+| Voyagers of Nera | `voyagers_of_nera` | — |
+| V Rising | `v_rising` | — |
+
+---
+
+## Matching rules (e.g. 7D2D → 7 Days to Die)
+
+Game detection lives in **`utils.js`** (`detectGame(subject, body)`). It only looks at the **combined subject + body** (lowercased). Matching is **case-insensitive** and uses **word boundaries**.
+
+### 1. Full names first
+
+- **Source:** `GAME_NAMES` (from env `GAME_LIST`, comma-separated, trimmed).
+- **How:** For each game name, the code builds a regex: `\b` + escaped name + `\b`, with flag `i`.
+- So the **exact display name** must appear as **whole words**.  
+  Examples: “7 days to die” matches → `7 Days to Die`; “zomboid” alone does *not* match “Project Zomboid” (would need “project zomboid” as words).
+
+### 2. Aliases second
+
+- **Source:** `GAME_ALIASES` in `config.js` (alias → full display name).
+- **How:** For each alias, the **alias** is lowercased, then the same pattern: `\b` + escaped alias + `\b`, case-insensitive.
+- If it matches, the function returns the **full game name** (the value in `GAME_ALIASES`).
+- So “7d2d”, “7D2D”, “7 days” match and resolve to **7 Days to Die**; “PZ” / “zomboid” resolve to **Project Zomboid**; “MC” → **Minecraft**; “Ark” → **ARK: Survival Evolved**; “SOTF” → **Sons of the Forest**; “CS2” → **Counter-Strike 2**.
+
+### 3. Word boundaries
+
+- `\b` means “word boundary” (between word and non-word character, or start/end of string).
+- So “7d2d” matches “my 7d2d server” or “7D2D” but not “7d2dmod” (no boundary after 7d2d) unless that substring appears as a separate word.
+
+### 4. Order and “first match wins”
+
+- Full names are checked **before** aliases. So if the text contains both a full name and an alias, the full name wins when it matches as whole words.
+- First matching game in `GAME_NAMES` or first matching alias in `GAME_ALIASES` wins; no tie-breaking between games.
+
+### 5. No match
+
+- If neither a full name nor an alias matches (with word boundaries), `detectGame` returns **`'Not Mentioned'`**.
+
+### Summary
+
+| Input (in subject/body) | Resolved game |
+|-------------------------|----------------|
+| 7d2d, 7D2D, 7 days     | 7 Days to Die |
+| PZ, zomboid             | Project Zomboid |
+| MC                      | Minecraft |
+| Ark                     | ARK: Survival Evolved |
+| SOTF                    | Sons of the Forest |
+| CS2                     | Counter-Strike 2 |
+
+When adding a new game:
+
+1. Add its **display name** to `GAME_LIST` (env) and to `GAME_NAME_TO_KEY` in `config.js`.
+2. Add **key → display name** to `game-options.json`.
+3. If users might type a shorthand (e.g. 7D2D), add an entry to **`GAME_ALIASES`** in `config.js` mapping that alias to the full display name.

docs/reference/regex-and-games.md

@@ -0,0 +1,60 @@
+# Regex detection code and games list
+
+## Regex detection code (utils.js)
+
+```javascript
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+const detectGame = (subject, body) => {
+  const txt = `${subject} ${body}`.toLowerCase();
+
+  for (const game of GAME_NAMES) {
+    const g = game.toLowerCase();
+    const re = new RegExp(`\\b${escapeRegex(g)}\\b`, 'i');
+    if (re.test(txt)) return game;
+  }
+
+  for (const [alias, fullName] of Object.entries(GAME_ALIASES)) {
+    const a = alias.toLowerCase();
+    const re = new RegExp(`\\b${escapeRegex(a)}\\b`, 'i');
+    if (re.test(txt)) return fullName;
+  }
+
+  return 'Not Mentioned';
+};
+```
+
+## Games list
+
+- 7 Days to Die
+- Abiotic Factor
+- ARK: Survival Evolved
+- Conan Exiles
+- Core Keeper
+- Counter-Strike 2
+- DayZ
+- ECO
+- Enshrouded
+- Factorio
+- FiveM
+- The Front
+- Garry's Mod
+- Hytale
+- ICARUS
+- Minecraft
+- Necesse
+- Palworld
+- Project Zomboid
+- Rust
+- Satisfactory
+- Sons of the Forest
+- Soulmask
+- Star Rupture
+- Terraria
+- Valheim
+- VEIN
+- Vintage Story
+- Voyagers of Nera
+- V Rising