From 77efac02835c1962a850d6ca10830ee981859b74 Mon Sep 17 00:00:00 2001
From: Seth Freiberg <seth@sethfreiberg.com>
Date: Wed, 18 Mar 2026 02:01:12 -0400
Subject: [PATCH] Add knowledge corpus: 14 command references, server context,
 and TF-IDF search index (Phase 1.3)

- knowledge/mc-commands/commands.json: 14 MC commands with JE syntax, args, examples, common errors, 1.21 version notes
- knowledge/server-context/servers.json: all 4 servers (mc1, shrink, paper-ai, paper-dev) with full config
- knowledge/build_index.py: TF-IDF indexer + search function (19 docs, 725 terms)
- All command syntax validated live on dev server via RCON (12/13 passed)
- PLAN.md: mark Phase 1.3 complete
---
 PLAN.md                               |   19 +-
 knowledge/build_index.py              |  219 +++
 knowledge/index.json                  | 2159 +++++++++++++++++++++++++
 knowledge/mc-commands/commands.json   |  356 ++++
 knowledge/server-context/servers.json |   82 +
 5 files changed, 2825 insertions(+), 10 deletions(-)
 create mode 100644 knowledge/build_index.py
 create mode 100644 knowledge/index.json
 create mode 100644 knowledge/mc-commands/commands.json
 create mode 100644 knowledge/server-context/servers.json

diff --git a/PLAN.md b/PLAN.md
index 9e42c82..a2b0fff 100644
--- a/PLAN.md
+++ b/PLAN.md
@@ -119,16 +119,15 @@ These projects informed the plan but solve different problems:
 - [x] Seed 31 examples from repair code, prayer logs, sudo logs, and session history (`data/processed/seed_dataset.jsonl`)
 
 #### 1.3 Knowledge Corpus
-- [ ] Scrape Minecraft Wiki command reference pages for 1.21.x syntax
-  - Target: `/give`, `/effect`, `/tp`, `/execute`, `/worldborder`, `/weather`, `/gamemode`, `/enchant`, `/fill`, `/setblock`, `/clone`, `/scoreboard`, `/data`, `/function`
-  - Store as structured JSON (command, syntax, parameters, examples, version notes)
-- [ ] Extract and chunk local server context:
-  - `server.properties` from mc1 and shrink-world
-  - Datapack definitions (shrinkborder, morespawns)
-  - Player list and UUID mappings
-  - RCON connection parameters (sanitized)
-- [ ] Index knowledge corpus for RAG retrieval (simple TF-IDF or embedding-based)
-- [ ] Validate: query the index with sample questions, spot-check relevance
+- [x] Scrape Minecraft Wiki command reference pages for 1.21.x syntax (14 commands in `knowledge/mc-commands/commands.json`)
+  - Includes JE syntax, arguments, examples, version notes, and common errors per command
+  - Commands validated live on dev server (Paper 1.21.11) -- 12/13 passed, 1 false negative (already in target state)
+- [x] Extract and chunk local server context (`knowledge/server-context/servers.json`)
+  - All 4 servers (mc1, shrink-world, paper-ai, paper-dev) with ports, RCON, settings, plugins
+  - Player list with UUIDs, infrastructure details, version-specific notes
+- [x] Index knowledge corpus for RAG retrieval (`knowledge/build_index.py` -- TF-IDF with title boosting)
+  - 19 documents indexed, 725 unique terms
+- [x] Validated with 6 test queries -- all return relevant top results
 
 #### 1.4 Baseline Assistant (No Fine-Tuning)
 - [ ] Build prompt-only assistant using `qwen3-coder` (via Ollama at 192.168.0.179)
diff --git a/knowledge/build_index.py b/knowledge/build_index.py
new file mode 100644
index 0000000..84488d1
--- /dev/null
+++ b/knowledge/build_index.py
@@ -0,0 +1,219 @@
+#!/usr/bin/env python3
+"""
+Build a simple TF-IDF-based search index over the knowledge corpus.
+
+Indexes:
+  - knowledge/mc-commands/commands.json  (command reference)
+  - knowledge/server-context/servers.json (server configs)
+  - knowledge/wiki-chunks/*.json          (wiki content, if present)
+
+Outputs: knowledge/index.json
+
+Usage: python3 knowledge/build_index.py
+"""
+
+import json
+import os
+import re
+from collections import Counter
+from pathlib import Path
+import math
+
+ROOT = Path(__file__).resolve().parent
+
+
+def tokenize(text: str) -> list:
+    """Simple whitespace + punctuation tokenizer."""
+    return re.findall(r'[a-z0-9_:/.]{2,}', (text or '').lower())
+
+
+def build_command_docs(commands_path: Path) -> list:
+    """Build searchable documents from commands.json."""
+    docs = []
+    if not commands_path.exists():
+        return docs
+    commands = json.loads(commands_path.read_text())
+    for cmd in commands:
+        name = cmd.get('command', '')
+        # Build a text blob from all fields
+        parts = [
+            f"/{name} command",
+            cmd.get('description', ''),
+            ' '.join(cmd.get('je_syntax', [])),
+        ]
+        # Arguments
+        for arg_name, arg_info in cmd.get('arguments', {}).items():
+            if isinstance(arg_info, dict):
+                parts.append(f"{arg_name}: {arg_info.get('description', '')}")
+            else:
+                parts.append(f"{arg_name}: {arg_info}")
+        # Examples
+        for ex_name, ex_val in cmd.get('examples', {}).items():
+            parts.append(f"example {ex_name}: {ex_val}")
+        # Common errors
+        for err in cmd.get('common_errors', []):
+            parts.append(f"common error: {err}")
+        # Version notes
+        parts.append(cmd.get('version_notes', ''))
+
+        text = '\n'.join(p for p in parts if p)
+        snippet = f"/{name}: {cmd.get('description', '')}. Syntax: {'; '.join(cmd.get('je_syntax', [])[:2])}"
+
+        docs.append({
+            'id': f'cmd_{name}',
+            'type': 'command',
+            'title': f'/{name}',
+            'text': text,
+            'snippet': snippet[:300],
+            'source': 'mc-commands/commands.json',
+        })
+    return docs
+
+
+def build_server_docs(servers_path: Path) -> list:
+    """Build searchable documents from servers.json."""
+    docs = []
+    if not servers_path.exists():
+        return docs
+    data = json.loads(servers_path.read_text())
+    for srv in data.get('servers', []):
+        name = srv.get('name', '')
+        text = json.dumps(srv, indent=2)
+        snippet = f"Server '{name}': {srv.get('type', '')} {srv.get('version', '')} on port {srv.get('game_port', '')}. {srv.get('notes', '')}"
+        docs.append({
+            'id': f'srv_{name}',
+            'type': 'server',
+            'title': f'Server: {name}',
+            'text': text,
+            'snippet': snippet[:300],
+            'source': 'server-context/servers.json',
+        })
+    # Version notes as a separate doc
+    vn = data.get('version_notes', {})
+    if vn:
+        text = '\n'.join(f"{k}: {v}" for k, v in vn.items())
+        docs.append({
+            'id': 'version_notes',
+            'type': 'reference',
+            'title': 'Minecraft 1.21 Version Notes',
+            'text': text,
+            'snippet': text[:300],
+            'source': 'server-context/servers.json',
+        })
+    return docs
+
+
+def build_wiki_docs(wiki_dir: Path) -> list:
+    """Build searchable documents from wiki chunk files."""
+    docs = []
+    if not wiki_dir.exists():
+        return docs
+    for p in wiki_dir.glob('*.json'):
+        try:
+            chunks = json.loads(p.read_text())
+            if isinstance(chunks, list):
+                for i, chunk in enumerate(chunks):
+                    text = chunk.get('text', '') if isinstance(chunk, dict) else str(chunk)
+                    title = chunk.get('title', p.stem) if isinstance(chunk, dict) else p.stem
+                    docs.append({
+                        'id': f'wiki_{p.stem}_{i}',
+                        'type': 'wiki',
+                        'title': title,
+                        'text': text,
+                        'snippet': text[:300],
+                        'source': f'wiki-chunks/{p.name}',
+                    })
+        except Exception:
+            pass
+    return docs
+
+
+def build_index():
+    """Build and save the search index."""
+    docs = []
+    docs.extend(build_command_docs(ROOT / 'mc-commands' / 'commands.json'))
+    docs.extend(build_server_docs(ROOT / 'server-context' / 'servers.json'))
+    docs.extend(build_wiki_docs(ROOT / 'wiki-chunks'))
+
+    # Build TF-IDF
+    doc_freq = Counter()
+    for doc in docs:
+        tokens = set(tokenize(doc['text']))
+        doc['_tokens'] = list(tokens)
+        for t in tokens:
+            doc_freq[t] += 1
+
+    N = len(docs)
+    idf = {t: math.log(N / (1 + df)) for t, df in doc_freq.items()}
+
+    # Store index
+    index = {
+        'generated_at': __import__('time').time(),
+        'doc_count': N,
+        'docs': [{
+            'id': d['id'],
+            'type': d['type'],
+            'title': d['title'],
+            'snippet': d['snippet'],
+            'source': d['source'],
+            'tokens': d['_tokens'],
+        } for d in docs],
+        'idf': {t: round(v, 4) for t, v in sorted(idf.items()) if v > 0.1},
+    }
+
+    out_path = ROOT / 'index.json'
+    out_path.write_text(json.dumps(index, ensure_ascii=True, indent=2))
+    print(f"Index built: {N} documents, {len(idf)} unique terms -> {out_path}")
+    return index
+
+
+def search(query: str, index: dict = None, limit: int = 5) -> list:
+    """Search the index. Returns top matches."""
+    if index is None:
+        idx_path = ROOT / 'index.json'
+        index = json.loads(idx_path.read_text())
+
+    q_tokens = set(tokenize(query))
+    idf = index.get('idf', {})
+    results = []
+
+    for doc in index.get('docs', []):
+        d_tokens = set(doc.get('tokens', []))
+        overlap = q_tokens & d_tokens
+        if not overlap:
+            continue
+        score = sum(idf.get(t, 0.5) for t in overlap)
+        # Boost title matches
+        title_tokens = set(tokenize(doc.get('title', '')))
+        title_overlap = q_tokens & title_tokens
+        score += len(title_overlap) * 2.0
+        results.append((score, doc))
+
+    results.sort(key=lambda x: x[0], reverse=True)
+    return [{'score': round(s, 2), **d} for s, d in results[:limit]]
+
+
+if __name__ == '__main__':
+    import sys
+    if len(sys.argv) > 1 and sys.argv[1] == 'search':
+        query = ' '.join(sys.argv[2:])
+        results = search(query)
+        for r in results:
+            print(f"[{r['score']:.1f}] {r['title']}: {r['snippet'][:100]}")
+    else:
+        build_index()
+        # Run test queries
+        print()
+        for q in [
+            "how to give enchanted sword",
+            "effect speed player",
+            "weather thunder storm",
+            "execute as vs at position",
+            "paper server port rcon",
+            "1.21 enchantment syntax",
+        ]:
+            results = search(q)
+            print(f"Query: '{q}'")
+            for r in results[:3]:
+                print(f"  [{r['score']:.1f}] {r['title']}")
+            print()
diff --git a/knowledge/index.json b/knowledge/index.json
new file mode 100644
index 0000000..ce41431
--- /dev/null
+++ b/knowledge/index.json
@@ -0,0 +1,2159 @@
+{
+  "generated_at": 1773813635.0107534,
+  "doc_count": 19,
+  "docs": [
+    {
+      "id": "cmd_give",
+      "type": "command",
+      "title": "/give",
+      "snippet": "/give: Gives items to players. Syntax: give <targets> <item> [<count>]",
+      "source": "mc-commands/commands.json",
+      "tokens": [
+        "lvl:5",
+        "minecraft:wolf_spawn_egg",
+        "tags",
+        "common",
+        "uuid.",
+        "diamond_sword",
+        "sharpness:5",
+        "error:",
+        "components.",
+        "minecraft:night_vision",
+        "players.",
+        "players",
+        "with",
+        "count",
+        "/give",
+        "invalid",
+        "of",
+        "1.21",
+        "with_enchantments:",
+        "entity_data",
+        "replaced",
+        "64",
+        "must",
+        "max_stack_size",
+        "format:",
+        "since",
+        "targets",
+        "enchantments",
+        "is",
+        "or",
+        "minecraft:totem_of_undying",
+        "1.20.5",
+        "optional",
+        "id",
+        "item",
+        "prefix",
+        "item:",
+        "value",
+        "using",
+        "nbt",
+        "id:sharpness",
+        "item_id",
+        "enchantment",
+        "potion_contents",
+        "enchantments:",
+        "targets:",
+        "target",
+        "minecraft:diamond_sword",
+        "gives",
+        "food",
+        "unbreaking:3",
+        "player",
+        "components:",
+        "oak_log",
+        "command",
+        "basic:",
+        "namespace",
+        "old",
+        "component",
+        "name",
+        "minecraft:potion",
+        "resolve",
+        "in",
+        "to",
+        "2147483647",
+        "id:",
+        "1.",
+        "specific",
+        "minecraft:",
+        "minecraft:diamond",
+        "missing",
+        "nbt.",
+        "custom_max_stack:",
+        "wood",
+        "with_lore:",
+        "diamond",
+        "number",
+        "uses",
+        "data",
+        "defaults",
+        "example",
+        "spawn_egg_override:",
+        "count:",
+        "with_potion:",
+        "give",
+        "potion:",
+        "selector",
+        "minecraft:cat",
+        "components",
+        "new",
+        "2304",
+        "items",
+        "...",
+        "instead",
+        "arguments:",
+        "lore",
+        "transposed"
+      ]
+    },
+    {
+      "id": "cmd_effect",
+      "type": "command",
+      "title": "/effect",
+      "snippet": "/effect: Adds or removes status effects from entities. Syntax: effect give <targets> <effect> [<seconds>] [<amplifier>] [<hideParticles>]; effect give <targets> <effect> infinite [<amplifier>] [<hideParticles>]",
+      "source": "mc-commands/commands.json",
+      "tokens": [
+        "ticks.",
+        "clear_specific:",
+        "common",
+        "particles",
+        "uuid.",
+        "exist.",
+        "error:",
+        "255",
+        "infinite_duration:",
+        "minecraft:night_vision",
+        "invulnerability",
+        "not",
+        "syntax",
+        "amplifier",
+        "with",
+        "effect:",
+        "hideparticles",
+        "hud",
+        "for",
+        "split",
+        "absorption",
+        "instant",
+        "must",
+        "minus",
+        "without",
+        "since",
+        "1000000",
+        "targets",
+        "false.",
+        "is",
+        "or",
+        "1.13",
+        "ii",
+        "30.",
+        "seconds:",
+        "minecraft:speed",
+        "true",
+        "into",
+        "invalid.",
+        "effects",
+        "clear_all:",
+        "id",
+        "effect",
+        "resistance_hidden:",
+        "prefix",
+        "whether",
+        "e.g.",
+        "regeneration",
+        "speed",
+        "does",
+        "targets:",
+        "target",
+        "status",
+        "be",
+        "player",
+        "effects:",
+        "command",
+        "namespace",
+        "/effect",
+        "infinite",
+        "name",
+        "clear",
+        "in",
+        "basic_speed:",
+        "on",
+        "to",
+        "etc.",
+        "0.",
+        "minecraft:",
+        "hideparticles:",
+        "missing",
+        "adds",
+        "resistance",
+        "bare",
+        "60",
+        "seconds",
+        "use",
+        "minecraft:haste",
+        "game",
+        "and",
+        "amplifier:",
+        "minecraft:resistance",
+        "removes",
+        "defaults",
+        "example",
+        "indicator.",
+        "level",
+        "entities",
+        "from",
+        "give",
+        "subcommand:",
+        "selector",
+        "duration",
+        "hide",
+        "inventing",
+        "instead"
+      ]
+    },
+    {
+      "id": "cmd_tp",
+      "type": "command",
+      "title": "/tp",
+      "snippet": "/tp: Teleports entities to positions or other entities. Syntax: tp <destination>; tp <targets> <destination>",
+      "source": "mc-commands/commands.json",
+      "tokens": [
+        "alias",
+        "if",
+        "entity.",
+        "rotation:",
+        "common",
+        "rotation",
+        "cross_dimension:",
+        "coordinates.",
+        "yaw:",
+        "notation.",
+        "error:",
+        "responses",
+        "benevolent",
+        "not",
+        "tp",
+        "with",
+        "are",
+        "single",
+        "yaw",
+        "positions",
+        "forward_one_block:",
+        "as",
+        "west.",
+        "when",
+        "position",
+        "teleport",
+        "of",
+        "/teleport",
+        "other",
+        "identical",
+        "facinganchor",
+        "didn",
+        "for",
+        "move",
+        "omitted",
+        "64",
+        "pitch",
+        "must",
+        "100",
+        "without",
+        "since",
+        "targets",
+        "200",
+        "teleporting",
+        "destination:",
+        "is",
+        "or",
+        "local/caret",
+        "teleporting.",
+        "1.13",
+        "entity",
+        "facing",
+        "after",
+        "north",
+        "south",
+        "using",
+        "both.",
+        "relative:",
+        "eyes",
+        "targets:",
+        "to_coords:",
+        "minecraft:the_nether",
+        "90",
+        "player",
+        "command",
+        "to_player:",
+        "but",
+        "at",
+        "location:",
+        "execute",
+        "causes",
+        "resolve",
+        "in",
+        "to",
+        "an",
+        "/tp",
+        "to.",
+        "feet.",
+        "ask",
+        "coordinates",
+        "teleport.",
+        "degrees.",
+        "facinglocation",
+        "facingentity:",
+        "facinglocation:",
+        "relative",
+        "facinganchor:",
+        "alice",
+        "up",
+        "east",
+        "facingentity",
+        "location",
+        "and",
+        "destination",
+        "defaults",
+        "example",
+        "context",
+        "teleports",
+        "face",
+        "entities",
+        "syntax.",
+        "supports",
+        "changes",
+        "entity/entities",
+        "all_to_self:",
+        "180",
+        "executor",
+        "instead",
+        "executor.",
+        "slow_falling",
+        "damage",
+        "fall",
+        "run"
+      ]
+    },
+    {
+      "id": "cmd_execute",
+      "type": "command",
+      "title": "/execute",
+      "snippet": "/execute: Executes commands with modified context (executor, position, conditions). Syntax: execute align <axes> -> execute; execute anchored <anchor> -> execute",
+      "source": "mc-commands/commands.json",
+      "tokens": [
+        "summon",
+        "conditional:",
+        "if",
+        "take",
+        "common",
+        "relation",
+        "cross_dimension:",
+        "nearby",
+        "unless",
+        "gamemode",
+        "coords",
+        "restructured",
+        "error:",
+        "say",
+        "locate",
+        "not",
+        "block",
+        "tp",
+        "zombies",
+        "with",
+        "fill",
+        "as",
+        "position",
+        "set",
+        "/execute",
+        "axes",
+        "for",
+        "64",
+        "distance",
+        "simplified",
+        "align",
+        "server/console",
+        "dimension",
+        "heightmap",
+        "since",
+        "targets",
+        "can",
+        "commands",
+        "is",
+        "or",
+        "1.13",
+        "entity",
+        "facing",
+        "positioned",
+        "completely",
+        "over",
+        "invalid.",
+        "origin",
+        "result",
+        "store",
+        "does",
+        "minecraft:the_nether",
+        "nesting:",
+        "be",
+        "player",
+        "directly",
+        "format",
+        "sheep",
+        "command",
+        "structure",
+        "old",
+        "at",
+        "execute",
+        "grass",
+        "chains.",
+        "modified",
+        "resolve",
+        "pos",
+        "in",
+        "on",
+        "to",
+        "found",
+        "..10",
+        "minecraft:stone",
+        "the",
+        "position.",
+        "success",
+        "at_player:",
+        "zombie",
+        "unnecessary",
+        "slingshooter08",
+        "rotated",
+        "relative",
+        "player.",
+        "use",
+        "that",
+        "subcommand",
+        "anchor",
+        "example",
+        "context",
+        "type",
+        "rot",
+        "executes",
+        "minecraft:fortress",
+        "...",
+        "executor",
+        "argument",
+        "block_check:",
+        "anchored",
+        "as_all_entities:",
+        "minecraft:grass_block",
+        "conditions",
+        "creative",
+        "run"
+      ]
+    },
+    {
+      "id": "cmd_weather",
+      "type": "command",
+      "title": "/weather",
+      "snippet": "/weather: Sets the weather. Syntax: weather (clear|rain|thunder) [<duration>]",
+      "source": "mc-commands/commands.json",
+      "tokens": [
+        "the",
+        "one",
+        "values",
+        "invalid",
+        "ticks",
+        "random",
+        "other",
+        "thunderstorm",
+        "common",
+        "of:",
+        "type:",
+        "duration:",
+        "18000",
+        "thunder",
+        "900",
+        "300",
+        "error:",
+        "seconds",
+        "use",
+        "/weather",
+        "rain",
+        "rainstorm",
+        "thunder.",
+        "timed:",
+        "defaults",
+        "1000000",
+        "example",
+        "significant",
+        "rain:",
+        "command",
+        "is",
+        "storm",
+        "changes",
+        "1.21.",
+        "duration",
+        "sets",
+        "weather",
+        "are",
+        "clear",
+        "thunder:",
+        "600",
+        "no",
+        "in",
+        "clear:",
+        "to",
+        "6000"
+      ]
+    },
+    {
+      "id": "cmd_gamemode",
+      "type": "command",
+      "title": "/gamemode",
+      "snippet": "/gamemode: Sets a player's game mode. Syntax: gamemode <gamemode> [<target>]",
+      "source": "mc-commands/commands.json",
+      "tokens": [
+        "one",
+        "survival",
+        "if",
+        "spectator_all:",
+        "common",
+        "camelcase",
+        "abbreviations",
+        "of:",
+        "slingshooter08",
+        "gamemode",
+        "gamemode:",
+        "je",
+        "target",
+        "modes",
+        "valid",
+        "spectator",
+        "spectator.",
+        "target:",
+        "error:",
+        "omitted.",
+        "use",
+        "sp",
+        "game",
+        "player",
+        "and",
+        "defaults",
+        "example",
+        "significant",
+        "only",
+        "not",
+        "full",
+        "ids",
+        "adventure",
+        "change.",
+        "command",
+        "is",
+        "changes",
+        "1.21.",
+        "sets",
+        "are",
+        "executor",
+        "numeric",
+        "no",
+        "abbreviations.",
+        "creative_self:",
+        "/gamemode",
+        "in",
+        "words",
+        "to",
+        "survival_player:",
+        "je.",
+        "mode",
+        "lowercase",
+        "creative"
+      ]
+    },
+    {
+      "id": "cmd_fill",
+      "type": "command",
+      "title": "/fill",
+      "snippet": "/fill: Fills a region with a specified block. Syntax: fill <from> <to> <block> [destroy|hollow|keep|outline|replace [<filter>]]",
+      "source": "mc-commands/commands.json",
+      "tokens": [
+        "one",
+        "fire",
+        "including",
+        "common",
+        "minecraft:fire",
+        "blocks",
+        "unchanged",
+        "replaces",
+        "minecraft:air",
+        "error:",
+        "numbers:",
+        "68",
+        "70",
+        "only",
+        "filter:",
+        "block",
+        "25",
+        "notation",
+        "fire_replace_air:",
+        "with",
+        "74",
+        "fill",
+        "minecraft:oak_stairs",
+        "when",
+        "drop",
+        "80",
+        "invalid",
+        "of",
+        "matching",
+        "64",
+        "hollow",
+        "minecraft:glass",
+        "air",
+        "is",
+        "or",
+        "1.21.",
+        "facing",
+        "metadata",
+        "north",
+        "hollow_box:",
+        "invalid.",
+        "optional",
+        "id",
+        "prefix",
+        "/fill",
+        "using",
+        "from:",
+        "basic_fill:",
+        "opposite",
+        "fills",
+        "1.21:",
+        "filter.",
+        "volume",
+        "20",
+        "block:",
+        "region",
+        "default",
+        "command",
+        "filter",
+        "this",
+        "per",
+        "max",
+        "clear_area:",
+        "to:",
+        "no",
+        "in",
+        "on",
+        "to",
+        "region.",
+        "minecraft:stone",
+        "the",
+        "minecraft:",
+        "mode:",
+        "missing",
+        "destroy",
+        "numbers.",
+        "drops",
+        "60",
+        "replace",
+        "use",
+        "inside",
+        "replace_air:",
+        "10",
+        "example",
+        "specified",
+        "keep",
+        "from",
+        "states:",
+        "32768",
+        "all",
+        "corner",
+        "integers",
+        "items",
+        "...",
+        "outline",
+        "edges",
+        "interior"
+      ]
+    },
+    {
+      "id": "cmd_setblock",
+      "type": "command",
+      "title": "/setblock",
+      "snippet": "/setblock: Places a block at a position. Syntax: setblock <pos> <block> [destroy|keep|replace]",
+      "source": "mc-commands/commands.json",
+      "tokens": [
+        "the",
+        "if",
+        "pos:",
+        "lower",
+        "minecraft:",
+        "common",
+        "mode:",
+        "missing",
+        "destroy",
+        "places",
+        "place",
+        "for",
+        "setblock",
+        "64",
+        "half",
+        "drops",
+        "minecraft:diamond_block",
+        "keep:",
+        "error:",
+        "replace",
+        "minecraft:oak_door",
+        "air",
+        "example",
+        "block:",
+        "only",
+        "significant",
+        "default",
+        "block",
+        "/setblock",
+        "command",
+        "keep",
+        "basic:",
+        "is",
+        "old",
+        "at",
+        "changes",
+        "states:",
+        "1.21.",
+        "facing",
+        "block.",
+        "with_state:",
+        "with",
+        "north",
+        "upper",
+        "minecraft:torch",
+        "no",
+        "pos",
+        "as",
+        "current",
+        "optional",
+        "to",
+        "on",
+        "position",
+        "in",
+        "id",
+        "item",
+        "prefix"
+      ]
+    },
+    {
+      "id": "cmd_clone",
+      "type": "command",
+      "title": "/clone",
+      "snippet": "/clone: Copies blocks from one region to another. Syntax: clone [from <sourceDimension>] <begin> <end> [to <targetDimension>] <destination> [replace|masked] [force|move|normal]; clone [from <sourceDimension>] <begin> <end> [to <targetDimension>] <destination> filtered <filter> [force|move|normal]",
+      "source": "mc-commands/commands.json",
+      "tokens": [
+        "one",
+        "allows",
+        "of",
+        "lower",
+        "equals",
+        "common",
+        "maskmode:",
+        "another",
+        "normal",
+        "matching",
+        "opposite",
+        "blocks",
+        "fills",
+        "northwest",
+        "move",
+        "64",
+        "sourcedimension",
+        "100",
+        "clone",
+        "error:",
+        "replace",
+        "dimension",
+        "masked",
+        "without",
+        "allowed",
+        "10",
+        "and",
+        "arguments.",
+        "copies",
+        "op",
+        "destination",
+        "air",
+        "1.20.2",
+        "/clone",
+        "example",
+        "only",
+        "region",
+        "force",
+        "added",
+        "overlap",
+        "default",
+        "command",
+        "targetdimension",
+        "from",
+        "region.",
+        "destination:",
+        "basic:",
+        "filter",
+        "clonemode:",
+        "cross",
+        "begin",
+        "source",
+        "corner",
+        "end:",
+        "all",
+        "with",
+        "74",
+        "move:",
+        "cloning",
+        "no",
+        "to",
+        "end",
+        "masked:",
+        "skip",
+        "begin:",
+        "overlapping",
+        "filtered",
+        "mode"
+      ]
+    },
+    {
+      "id": "cmd_summon",
+      "type": "command",
+      "title": "/summon",
+      "snippet": "/summon: Summons an entity. Syntax: summon <entity> [<pos>] [<nbt>]",
+      "source": "mc-commands/commands.json",
+      "tokens": [
+        "summon",
+        "the",
+        "invalid",
+        "count.",
+        "etc.",
+        "pos:",
+        "position.",
+        "tags",
+        "of",
+        "one",
+        "minecraft:",
+        "nbt",
+        "common",
+        "entity.",
+        "tnt",
+        "cannot",
+        "minecraft:tnt",
+        "with_nbt:",
+        "missing",
+        "for",
+        "65",
+        "isbaby:1",
+        "must",
+        "minecraft:zombie",
+        "at_coords:",
+        "customname:",
+        "error:",
+        "use",
+        "20",
+        "uses",
+        "nbt:",
+        "data",
+        "entities.",
+        "defaults",
+        "example",
+        "type",
+        "named:",
+        "entity:",
+        "not",
+        "still",
+        "command",
+        "bob",
+        "basic:",
+        "commands",
+        "is",
+        "multiple",
+        "namespace",
+        "minecraft:villager",
+        "append",
+        "entity",
+        "components",
+        "1.21.",
+        "creates",
+        "separate",
+        "/summon",
+        "executor",
+        "summons",
+        "each",
+        "call",
+        "pos",
+        "count",
+        "as",
+        "on",
+        "to",
+        "an",
+        "position",
+        "at.",
+        "id:",
+        "exactly",
+        "prefix"
+      ]
+    },
+    {
+      "id": "cmd_worldborder",
+      "type": "command",
+      "title": "/worldborder",
+      "snippet": "/worldborder: Manages the world border. Syntax: worldborder add <distance> [<time>]; worldborder center <pos>",
+      "source": "mc-commands/commands.json",
+      "tokens": [
+        "the",
+        "warning",
+        "pos:",
+        "border",
+        "get",
+        "manages",
+        "blocks.",
+        "common",
+        "negative",
+        "zero",
+        "for",
+        "coordinates.",
+        "center",
+        "distance",
+        "distance:",
+        "target",
+        "/worldborder",
+        "damageperblock",
+        "reach",
+        "killing",
+        "100",
+        "its",
+        "diameter",
+        "error:",
+        "seconds",
+        "shrink_over_time:",
+        "time:",
+        "example",
+        "significant",
+        "500",
+        "size.",
+        "add",
+        "positive",
+        "players",
+        "command",
+        "center:",
+        "buffer",
+        "changes",
+        "instant.",
+        "world",
+        "1.21.",
+        "all",
+        "600",
+        "sets",
+        "outside",
+        "worldborder",
+        "amount",
+        "expands",
+        "time",
+        "shrinks.",
+        "set_500:",
+        "pos",
+        "get_size:",
+        "in",
+        "damage",
+        "effectively",
+        "to",
+        "no",
+        "set"
+      ]
+    },
+    {
+      "id": "cmd_enchant",
+      "type": "command",
+      "title": "/enchant",
+      "snippet": "/enchant: Enchants the held item of a player. Syntax: enchant <targets> <enchantment> [<level>]",
+      "source": "mc-commands/commands.json",
+      "tokens": [
+        "the",
+        "1.",
+        "affects",
+        "minecraft:sharpness",
+        "etc.",
+        "of",
+        "unreliable",
+        "using",
+        "fully",
+        "common",
+        "levels",
+        "enchanted",
+        "e.g.",
+        "cannot",
+        "enchantment",
+        "prefer",
+        "for",
+        "diamond_sword",
+        "enchant.",
+        "targets:",
+        "/enchant",
+        "minecraft:protection",
+        "works",
+        "enchant",
+        "currently",
+        "sharpness:5",
+        "error:",
+        "use",
+        "level.",
+        "it",
+        "player",
+        "and",
+        "minecraft:unbreaking",
+        "defaults",
+        "example",
+        "enchants",
+        "targets",
+        "level:",
+        "only",
+        "respects",
+        "guaranteed",
+        "incompatible",
+        "compatibility",
+        "level",
+        "held",
+        "syntax",
+        "command",
+        "enchantments",
+        "basic:",
+        "give",
+        "is",
+        "component",
+        "rules.",
+        "exceed",
+        "enchantment:",
+        "limits.",
+        "components",
+        "max",
+        "smite",
+        "holding.",
+        "with",
+        "items",
+        "vanilla",
+        "pre",
+        "sharpness",
+        "whose",
+        "on",
+        "to",
+        "instead:",
+        "stack",
+        "all_players:",
+        "results.",
+        "id:",
+        "item",
+        "/give"
+      ]
+    },
+    {
+      "id": "cmd_scoreboard",
+      "type": "command",
+      "title": "/scoreboard",
+      "snippet": "/scoreboard: Manages scoreboard objectives and player scores. Syntax: scoreboard objectives add <objective> <criteria> [<displayName>]; scoreboard objectives list",
+      "source": "mc-commands/commands.json",
+      "tokens": [
+        "scores",
+        "get",
+        "manages",
+        "/scoreboard",
+        "set_score:",
+        "modify",
+        "deaths",
+        "display",
+        "integer",
+        "hearts",
+        "slot",
+        "deathcount",
+        "target",
+        "scoreboard",
+        "numberformat",
+        "displayname",
+        "player",
+        "and",
+        "create_objective:",
+        "example",
+        "targets",
+        "significant",
+        "add",
+        "display:",
+        "score",
+        "players",
+        "command",
+        "add_score:",
+        "objectives",
+        "targetobjective",
+        "reset",
+        "changes",
+        "remove",
+        "1.21.",
+        "name",
+        "source",
+        "list",
+        "...",
+        "sourceobjective",
+        "setdisplay",
+        "operation",
+        "no",
+        "in",
+        "objective",
+        "criteria",
+        "enable",
+        "rendertype",
+        "set",
+        "sidebar"
+      ]
+    },
+    {
+      "id": "cmd_data",
+      "type": "command",
+      "title": "/data",
+      "snippet": "/data: Gets, merges, modifies, or removes NBT data from entities, block entities, or storage. Syntax: data get (block <targetPos>|entity <target>|storage <target>) [<path>] [<scale>]; data merge (block <targetPos>|entity <target>|storage <target>) <nbt>",
+      "source": "mc-commands/commands.json",
+      "tokens": [
+        "set",
+        "the",
+        "chests",
+        "etc.",
+        "cases",
+        "value",
+        "regular",
+        "nbt",
+        "get",
+        "start",
+        "common",
+        "most",
+        "modify",
+        "modifies",
+        "cannot",
+        "blocks",
+        "slingshooter08",
+        "insert",
+        "targetpath",
+        "64",
+        "get_block_data:",
+        "works",
+        "target",
+        "storage",
+        "signs",
+        "get_health:",
+        "gets",
+        "get_inventory:",
+        "index",
+        "error:",
+        "grass.",
+        "player",
+        "data",
+        "non",
+        "directly",
+        "removes",
+        "example",
+        "only",
+        "inventory",
+        "not",
+        "like",
+        "entities",
+        "command",
+        "block",
+        "from",
+        "path",
+        "merges",
+        "or",
+        "string",
+        "get_player_pos:",
+        "returns",
+        "scale",
+        "is",
+        "append",
+        "entity",
+        "remove",
+        "health",
+        "source",
+        "with",
+        "stone",
+        "sourcepath",
+        "pos",
+        "prepend",
+        "in",
+        "on",
+        "end",
+        "merge",
+        "/data",
+        "sourcepos",
+        "targetpos"
+      ]
+    },
+    {
+      "id": "srv_mc1",
+      "type": "server",
+      "title": "Server: mc1",
+      "snippet": "Server 'mc1': vanilla 1.21.x on port 25565. Main vanilla survival server. MCSManager-managed.",
+      "source": "server-context/servers.json",
+      "tokens": [
+        "survival",
+        "notes",
+        "25575",
+        "game_port",
+        "gamemode",
+        "difficulty",
+        "managed.",
+        "max_players",
+        "mcsmanager",
+        "20",
+        "type",
+        "version",
+        "main",
+        "host",
+        "192.168.0.244",
+        "name",
+        "vanilla",
+        "easy",
+        "true",
+        "online_mode",
+        "pvp",
+        "mc1",
+        "rcon_port",
+        "server.",
+        "25565",
+        "1.21.x"
+      ]
+    },
+    {
+      "id": "srv_shrink-world",
+      "type": "server",
+      "title": "Server: shrink-world",
+      "snippet": "Server 'shrink-world': vanilla 1.21.x on port 25566. Hardcore-style challenge server. World border starts at 500x500.",
+      "source": "server-context/servers.json",
+      "tokens": [
+        "survival",
+        "border",
+        "morespawns",
+        "notes",
+        "game_port",
+        "creeper",
+        "shrinks",
+        "gamemode",
+        "500x500.",
+        "difficulty",
+        "style",
+        "5x",
+        "max_players",
+        "hardcore",
+        "starts",
+        "20",
+        "shrinkborder",
+        "type",
+        "version",
+        "25576",
+        "shrink",
+        "hard",
+        "datapacks",
+        "at",
+        "host",
+        "192.168.0.244",
+        "world",
+        "name",
+        "25566",
+        "vanilla",
+        "challenge",
+        "true",
+        "death",
+        "online_mode",
+        "pvp",
+        "spawns",
+        "on",
+        "rcon_port",
+        "server.",
+        "1.21.x"
+      ]
+    },
+    {
+      "id": "srv_paper-ai",
+      "type": "server",
+      "title": "Server: paper-ai",
+      "snippet": "Server 'paper-ai': paper 1.21.11 on port 25567. Paper fork with AI God, sudo translator, and world observation tools.",
+      "source": "server-context/servers.json",
+      "tokens": [
+        "survival",
+        "1.21.11",
+        "session",
+        "observation",
+        "notes",
+        "luckperms",
+        "plugins",
+        "game_port",
+        "aigod",
+        "paper",
+        "ai",
+        "gamemode",
+        "difficulty",
+        "max_players",
+        "20",
+        "god/sudo",
+        "and",
+        "langgraph",
+        "25567",
+        "type",
+        "version",
+        "gateway.service",
+        "sudo",
+        "hard",
+        "ai_services",
+        "tools.",
+        "host",
+        "fork",
+        "192.168.0.244",
+        "god",
+        "world",
+        "name",
+        "with",
+        "gateway",
+        "true",
+        "online_mode",
+        "pvp",
+        "translator",
+        "25577",
+        "rcon_port",
+        "fastasyncworldedit",
+        "mc",
+        "paper.service"
+      ]
+    },
+    {
+      "id": "srv_paper-dev",
+      "type": "server",
+      "title": "Server: paper-dev",
+      "snippet": "Server 'paper-dev': paper 1.21.11 on port 25568. Offline dev server for AI training bots. Superflat, no mobs.",
+      "source": "server-context/servers.json",
+      "tokens": [
+        "1.21.11",
+        "notes",
+        "dev",
+        "25578",
+        "game_port",
+        "for",
+        "superflat",
+        "paper",
+        "ai",
+        "gamemode",
+        "difficulty",
+        "mobs.",
+        "max_players",
+        "training",
+        "type",
+        "version",
+        "peaceful",
+        "offline",
+        "world_type",
+        "bots.",
+        "50",
+        "host",
+        "false",
+        "192.168.0.244",
+        "name",
+        "server",
+        "online_mode",
+        "pvp",
+        "no",
+        "rcon_port",
+        "flat",
+        "25568",
+        "creative"
+      ]
+    },
+    {
+      "id": "version_notes",
+      "type": "reference",
+      "title": "Minecraft 1.21 Version Notes",
+      "snippet": "enchantment_syntax: 1.21+: give player item[enchantments={name:level}]. Old NBT format {Enchantments:[...]} is INVALID.\neffect_syntax: 1.13+: Must use 'effect give <target> <effect>'. Bare 'effect <target> <effect>' is INVALID.\nweather_values: Only valid values: clear, rain, thunder. 'storm', 'rains",
+      "source": "server-context/servers.json",
+      "tokens": [
+        "chests",
+        "if",
+        "position.",
+        "1.21",
+        "regular",
+        "nbt",
+        "get",
+        "values:",
+        "blocks",
+        "bare",
+        "for",
+        "relative",
+        "coordinates.",
+        "enchantments:",
+        "test",
+        "works",
+        "target",
+        "execute_as_vs_at:",
+        "signs",
+        "must",
+        "valid",
+        "name:level",
+        "use",
+        "rain",
+        "player",
+        "thunder.",
+        "rainstorm",
+        "data",
+        "enchantment_syntax:",
+        "format",
+        "type.",
+        "only",
+        "not",
+        "block",
+        "enchantments",
+        "entities",
+        "give",
+        "is",
+        "old",
+        "but",
+        "storm",
+        "at",
+        "changes",
+        "execute",
+        "1.13",
+        "are",
+        "data_get_blocks:",
+        "clear",
+        "...",
+        "effect_syntax:",
+        "executor",
+        "invalid.",
+        "as",
+        "on",
+        "to",
+        "weather_values:",
+        "effect",
+        "item"
+      ]
+    }
+  ],
+  "idf": {
+    "...": 1.1527,
+    "..10": 2.2513,
+    "/clone": 2.2513,
+    "/data": 2.2513,
+    "/effect": 2.2513,
+    "/enchant": 2.2513,
+    "/execute": 2.2513,
+    "/fill": 2.2513,
+    "/gamemode": 2.2513,
+    "/give": 1.8458,
+    "/scoreboard": 2.2513,
+    "/setblock": 2.2513,
+    "/summon": 2.2513,
+    "/teleport": 2.2513,
+    "/tp": 2.2513,
+    "/weather": 2.2513,
+    "/worldborder": 2.2513,
+    "0.": 2.2513,
+    "1.": 1.8458,
+    "1.13": 1.335,
+    "1.20.2": 2.2513,
+    "1.20.5": 2.2513,
+    "1.21": 1.8458,
+    "1.21.": 0.865,
+    "1.21.11": 1.8458,
+    "1.21.x": 1.8458,
+    "1.21:": 2.2513,
+    "10": 1.8458,
+    "100": 1.5581,
+    "1000000": 1.8458,
+    "180": 2.2513,
+    "18000": 2.2513,
+    "192.168.0.244": 1.335,
+    "20": 1.1527,
+    "200": 2.2513,
+    "2147483647": 2.2513,
+    "2304": 2.2513,
+    "25": 2.2513,
+    "255": 2.2513,
+    "25565": 2.2513,
+    "25566": 2.2513,
+    "25567": 2.2513,
+    "25568": 2.2513,
+    "25575": 2.2513,
+    "25576": 2.2513,
+    "25577": 2.2513,
+    "25578": 2.2513,
+    "30.": 2.2513,
+    "300": 2.2513,
+    "32768": 2.2513,
+    "50": 2.2513,
+    "500": 2.2513,
+    "500x500.": 2.2513,
+    "5x": 2.2513,
+    "60": 1.8458,
+    "600": 1.8458,
+    "6000": 2.2513,
+    "64": 0.865,
+    "65": 2.2513,
+    "68": 2.2513,
+    "70": 2.2513,
+    "74": 1.8458,
+    "80": 2.2513,
+    "90": 2.2513,
+    "900": 2.2513,
+    "abbreviations": 2.2513,
+    "abbreviations.": 2.2513,
+    "absorption": 2.2513,
+    "add": 1.8458,
+    "add_score:": 2.2513,
+    "added": 2.2513,
+    "adds": 2.2513,
+    "adventure": 2.2513,
+    "affects": 2.2513,
+    "after": 2.2513,
+    "ai": 1.8458,
+    "ai_services": 2.2513,
+    "aigod": 2.2513,
+    "air": 1.5581,
+    "alias": 2.2513,
+    "alice": 2.2513,
+    "align": 2.2513,
+    "all": 1.5581,
+    "all_players:": 2.2513,
+    "all_to_self:": 2.2513,
+    "allowed": 2.2513,
+    "allows": 2.2513,
+    "amount": 2.2513,
+    "amplifier": 2.2513,
+    "amplifier:": 2.2513,
+    "an": 1.8458,
+    "anchor": 2.2513,
+    "anchored": 2.2513,
+    "and": 0.865,
+    "another": 2.2513,
+    "append": 1.8458,
+    "are": 1.335,
+    "argument": 2.2513,
+    "arguments.": 2.2513,
+    "arguments:": 2.2513,
+    "as": 1.1527,
+    "as_all_entities:": 2.2513,
+    "ask": 2.2513,
+    "at": 1.1527,
+    "at.": 2.2513,
+    "at_coords:": 2.2513,
+    "at_player:": 2.2513,
+    "axes": 2.2513,
+    "bare": 1.8458,
+    "basic:": 1.1527,
+    "basic_fill:": 2.2513,
+    "basic_speed:": 2.2513,
+    "be": 1.8458,
+    "begin": 2.2513,
+    "begin:": 2.2513,
+    "benevolent": 2.2513,
+    "block": 1.1527,
+    "block.": 2.2513,
+    "block:": 1.8458,
+    "block_check:": 2.2513,
+    "blocks": 1.335,
+    "blocks.": 2.2513,
+    "bob": 2.2513,
+    "border": 1.8458,
+    "both.": 2.2513,
+    "bots.": 2.2513,
+    "buffer": 2.2513,
+    "but": 1.8458,
+    "call": 2.2513,
+    "camelcase": 2.2513,
+    "can": 2.2513,
+    "cannot": 1.5581,
+    "cases": 2.2513,
+    "causes": 2.2513,
+    "center": 2.2513,
+    "center:": 2.2513,
+    "chains.": 2.2513,
+    "challenge": 2.2513,
+    "change.": 2.2513,
+    "changes": 0.865,
+    "chests": 1.8458,
+    "clear": 1.5581,
+    "clear:": 2.2513,
+    "clear_all:": 2.2513,
+    "clear_area:": 2.2513,
+    "clear_specific:": 2.2513,
+    "clone": 2.2513,
+    "clonemode:": 2.2513,
+    "cloning": 2.2513,
+    "command": 0.2364,
+    "commands": 1.8458,
+    "common": 0.3054,
+    "compatibility": 2.2513,
+    "completely": 2.2513,
+    "component": 1.8458,
+    "components": 1.5581,
+    "components.": 2.2513,
+    "components:": 2.2513,
+    "conditional:": 2.2513,
+    "conditions": 2.2513,
+    "context": 1.8458,
+    "coordinates": 2.2513,
+    "coordinates.": 1.5581,
+    "coords": 2.2513,
+    "copies": 2.2513,
+    "corner": 1.8458,
+    "count": 1.8458,
+    "count.": 2.2513,
+    "count:": 2.2513,
+    "create_objective:": 2.2513,
+    "creates": 2.2513,
+    "creative": 1.5581,
+    "creative_self:": 2.2513,
+    "creeper": 2.2513,
+    "criteria": 2.2513,
+    "cross": 2.2513,
+    "cross_dimension:": 1.8458,
+    "current": 2.2513,
+    "currently": 2.2513,
+    "custom_max_stack:": 2.2513,
+    "customname:": 2.2513,
+    "damage": 1.8458,
+    "damageperblock": 2.2513,
+    "data": 1.335,
+    "data_get_blocks:": 2.2513,
+    "datapacks": 2.2513,
+    "death": 2.2513,
+    "deathcount": 2.2513,
+    "deaths": 2.2513,
+    "default": 1.5581,
+    "defaults": 0.865,
+    "degrees.": 2.2513,
+    "destination": 1.8458,
+    "destination:": 1.8458,
+    "destroy": 1.8458,
+    "dev": 2.2513,
+    "diameter": 2.2513,
+    "diamond": 2.2513,
+    "diamond_sword": 1.8458,
+    "didn": 2.2513,
+    "difficulty": 1.335,
+    "dimension": 1.8458,
+    "directly": 1.8458,
+    "display": 2.2513,
+    "display:": 2.2513,
+    "displayname": 2.2513,
+    "distance": 1.8458,
+    "distance:": 2.2513,
+    "does": 1.8458,
+    "drop": 2.2513,
+    "drops": 1.8458,
+    "duration": 1.8458,
+    "duration:": 2.2513,
+    "e.g.": 1.8458,
+    "each": 2.2513,
+    "east": 2.2513,
+    "easy": 2.2513,
+    "edges": 2.2513,
+    "effect": 1.8458,
+    "effect:": 2.2513,
+    "effect_syntax:": 2.2513,
+    "effectively": 2.2513,
+    "effects": 2.2513,
+    "effects:": 2.2513,
+    "enable": 2.2513,
+    "enchant": 2.2513,
+    "enchant.": 2.2513,
+    "enchanted": 2.2513,
+    "enchantment": 1.8458,
+    "enchantment:": 2.2513,
+    "enchantment_syntax:": 2.2513,
+    "enchantments": 1.5581,
+    "enchantments:": 1.8458,
+    "enchants": 2.2513,
+    "end": 1.8458,
+    "end:": 2.2513,
+    "entities": 1.335,
+    "entities.": 2.2513,
+    "entity": 1.335,
+    "entity.": 1.8458,
+    "entity/entities": 2.2513,
+    "entity:": 2.2513,
+    "entity_data": 2.2513,
+    "equals": 2.2513,
+    "error:": 0.3054,
+    "etc.": 1.335,
+    "exactly": 2.2513,
+    "example": 0.2364,
+    "exceed": 2.2513,
+    "execute": 1.5581,
+    "execute_as_vs_at:": 2.2513,
+    "executes": 2.2513,
+    "executor": 1.1527,
+    "executor.": 2.2513,
+    "exist.": 2.2513,
+    "expands": 2.2513,
+    "eyes": 2.2513,
+    "face": 2.2513,
+    "facing": 1.335,
+    "facinganchor": 2.2513,
+    "facinganchor:": 2.2513,
+    "facingentity": 2.2513,
+    "facingentity:": 2.2513,
+    "facinglocation": 2.2513,
+    "facinglocation:": 2.2513,
+    "fall": 2.2513,
+    "false": 2.2513,
+    "false.": 2.2513,
+    "fastasyncworldedit": 2.2513,
+    "feet.": 2.2513,
+    "fill": 1.8458,
+    "fills": 1.8458,
+    "filter": 1.8458,
+    "filter.": 2.2513,
+    "filter:": 2.2513,
+    "filtered": 2.2513,
+    "fire": 2.2513,
+    "fire_replace_air:": 2.2513,
+    "flat": 2.2513,
+    "food": 2.2513,
+    "for": 0.6419,
+    "force": 2.2513,
+    "fork": 2.2513,
+    "format": 1.8458,
+    "format:": 2.2513,
+    "forward_one_block:": 2.2513,
+    "found": 2.2513,
+    "from": 1.335,
+    "from:": 2.2513,
+    "full": 2.2513,
+    "fully": 2.2513,
+    "game": 1.8458,
+    "game_port": 1.335,
+    "gamemode": 0.9985,
+    "gamemode:": 2.2513,
+    "gateway": 2.2513,
+    "gateway.service": 2.2513,
+    "get": 1.335,
+    "get_block_data:": 2.2513,
+    "get_health:": 2.2513,
+    "get_inventory:": 2.2513,
+    "get_player_pos:": 2.2513,
+    "get_size:": 2.2513,
+    "gets": 2.2513,
+    "give": 1.335,
+    "gives": 2.2513,
+    "god": 2.2513,
+    "god/sudo": 2.2513,
+    "grass": 2.2513,
+    "grass.": 2.2513,
+    "guaranteed": 2.2513,
+    "half": 2.2513,
+    "hard": 1.8458,
+    "hardcore": 2.2513,
+    "health": 2.2513,
+    "hearts": 2.2513,
+    "heightmap": 2.2513,
+    "held": 2.2513,
+    "hide": 2.2513,
+    "hideparticles": 2.2513,
+    "hideparticles:": 2.2513,
+    "holding.": 2.2513,
+    "hollow": 2.2513,
+    "hollow_box:": 2.2513,
+    "host": 1.335,
+    "hud": 2.2513,
+    "id": 1.335,
+    "id:": 1.5581,
+    "id:sharpness": 2.2513,
+    "identical": 2.2513,
+    "ids": 2.2513,
+    "if": 1.1527,
+    "ii": 2.2513,
+    "in": 0.4595,
+    "including": 2.2513,
+    "incompatible": 2.2513,
+    "index": 2.2513,
+    "indicator.": 2.2513,
+    "infinite": 2.2513,
+    "infinite_duration:": 2.2513,
+    "insert": 2.2513,
+    "inside": 2.2513,
+    "instant": 2.2513,
+    "instant.": 2.2513,
+    "instead": 1.5581,
+    "instead:": 2.2513,
+    "integer": 2.2513,
+    "integers": 2.2513,
+    "interior": 2.2513,
+    "into": 2.2513,
+    "invalid": 1.335,
+    "invalid.": 1.335,
+    "inventing": 2.2513,
+    "inventory": 2.2513,
+    "invulnerability": 2.2513,
+    "is": 0.3795,
+    "isbaby:1": 2.2513,
+    "it": 2.2513,
+    "item": 1.335,
+    "item:": 2.2513,
+    "item_id": 2.2513,
+    "items": 1.5581,
+    "its": 2.2513,
+    "je": 2.2513,
+    "je.": 2.2513,
+    "keep": 1.8458,
+    "keep:": 2.2513,
+    "killing": 2.2513,
+    "langgraph": 2.2513,
+    "level": 1.8458,
+    "level.": 2.2513,
+    "level:": 2.2513,
+    "levels": 2.2513,
+    "like": 2.2513,
+    "limits.": 2.2513,
+    "list": 2.2513,
+    "local/caret": 2.2513,
+    "locate": 2.2513,
+    "location": 2.2513,
+    "location:": 2.2513,
+    "lore": 2.2513,
+    "lower": 1.8458,
+    "lowercase": 2.2513,
+    "luckperms": 2.2513,
+    "lvl:5": 2.2513,
+    "main": 2.2513,
+    "managed.": 2.2513,
+    "manages": 1.8458,
+    "masked": 2.2513,
+    "masked:": 2.2513,
+    "maskmode:": 2.2513,
+    "matching": 1.8458,
+    "max": 1.8458,
+    "max_players": 1.335,
+    "max_stack_size": 2.2513,
+    "mc": 2.2513,
+    "mc1": 2.2513,
+    "mcsmanager": 2.2513,
+    "merge": 2.2513,
+    "merges": 2.2513,
+    "metadata": 2.2513,
+    "minecraft:": 1.1527,
+    "minecraft:air": 2.2513,
+    "minecraft:cat": 2.2513,
+    "minecraft:diamond": 2.2513,
+    "minecraft:diamond_block": 2.2513,
+    "minecraft:diamond_sword": 2.2513,
+    "minecraft:fire": 2.2513,
+    "minecraft:fortress": 2.2513,
+    "minecraft:glass": 2.2513,
+    "minecraft:grass_block": 2.2513,
+    "minecraft:haste": 2.2513,
+    "minecraft:night_vision": 1.8458,
+    "minecraft:oak_door": 2.2513,
+    "minecraft:oak_stairs": 2.2513,
+    "minecraft:potion": 2.2513,
+    "minecraft:protection": 2.2513,
+    "minecraft:resistance": 2.2513,
+    "minecraft:sharpness": 2.2513,
+    "minecraft:speed": 2.2513,
+    "minecraft:stone": 1.8458,
+    "minecraft:the_nether": 1.8458,
+    "minecraft:tnt": 2.2513,
+    "minecraft:torch": 2.2513,
+    "minecraft:totem_of_undying": 2.2513,
+    "minecraft:unbreaking": 2.2513,
+    "minecraft:villager": 2.2513,
+    "minecraft:wolf_spawn_egg": 2.2513,
+    "minecraft:zombie": 2.2513,
+    "minus": 2.2513,
+    "missing": 1.1527,
+    "mobs.": 2.2513,
+    "mode": 1.8458,
+    "mode:": 1.8458,
+    "modes": 2.2513,
+    "modified": 2.2513,
+    "modifies": 2.2513,
+    "modify": 1.8458,
+    "morespawns": 2.2513,
+    "most": 2.2513,
+    "move": 1.8458,
+    "move:": 2.2513,
+    "multiple": 2.2513,
+    "must": 1.1527,
+    "name": 0.865,
+    "name:level": 2.2513,
+    "named:": 2.2513,
+    "namespace": 1.5581,
+    "nbt": 1.335,
+    "nbt.": 2.2513,
+    "nbt:": 2.2513,
+    "nearby": 2.2513,
+    "negative": 2.2513,
+    "nesting:": 2.2513,
+    "new": 2.2513,
+    "no": 0.7472,
+    "non": 2.2513,
+    "normal": 2.2513,
+    "north": 1.5581,
+    "northwest": 2.2513,
+    "not": 0.865,
+    "notation": 2.2513,
+    "notation.": 2.2513,
+    "notes": 1.335,
+    "number": 2.2513,
+    "numberformat": 2.2513,
+    "numbers.": 2.2513,
+    "numbers:": 2.2513,
+    "numeric": 2.2513,
+    "oak_log": 2.2513,
+    "objective": 2.2513,
+    "objectives": 2.2513,
+    "observation": 2.2513,
+    "of": 0.9985,
+    "of:": 1.8458,
+    "offline": 2.2513,
+    "old": 1.335,
+    "omitted": 2.2513,
+    "omitted.": 2.2513,
+    "on": 0.6419,
+    "one": 1.1527,
+    "online_mode": 1.335,
+    "only": 0.865,
+    "op": 2.2513,
+    "operation": 2.2513,
+    "opposite": 1.8458,
+    "optional": 1.5581,
+    "or": 0.9985,
+    "origin": 2.2513,
+    "other": 1.8458,
+    "outline": 2.2513,
+    "outside": 2.2513,
+    "over": 2.2513,
+    "overlap": 2.2513,
+    "overlapping": 2.2513,
+    "paper": 1.8458,
+    "paper.service": 2.2513,
+    "particles": 2.2513,
+    "path": 2.2513,
+    "peaceful": 2.2513,
+    "per": 2.2513,
+    "pitch": 2.2513,
+    "place": 2.2513,
+    "places": 2.2513,
+    "player": 0.6419,
+    "player.": 2.2513,
+    "players": 1.5581,
+    "players.": 2.2513,
+    "plugins": 2.2513,
+    "pos": 1.1527,
+    "pos:": 1.5581,
+    "position": 1.335,
+    "position.": 1.5581,
+    "positioned": 2.2513,
+    "positions": 2.2513,
+    "positive": 2.2513,
+    "potion:": 2.2513,
+    "potion_contents": 2.2513,
+    "pre": 2.2513,
+    "prefer": 2.2513,
+    "prefix": 1.1527,
+    "prepend": 2.2513,
+    "pvp": 1.335,
+    "rain": 1.8458,
+    "rain:": 2.2513,
+    "rainstorm": 1.8458,
+    "random": 2.2513,
+    "rcon_port": 1.335,
+    "reach": 2.2513,
+    "regeneration": 2.2513,
+    "region": 1.8458,
+    "region.": 1.8458,
+    "regular": 1.8458,
+    "relation": 2.2513,
+    "relative": 1.5581,
+    "relative:": 2.2513,
+    "remove": 1.8458,
+    "removes": 1.8458,
+    "rendertype": 2.2513,
+    "replace": 1.5581,
+    "replace_air:": 2.2513,
+    "replaced": 2.2513,
+    "replaces": 2.2513,
+    "reset": 2.2513,
+    "resistance": 2.2513,
+    "resistance_hidden:": 2.2513,
+    "resolve": 1.5581,
+    "respects": 2.2513,
+    "responses": 2.2513,
+    "restructured": 2.2513,
+    "result": 2.2513,
+    "results.": 2.2513,
+    "returns": 2.2513,
+    "rot": 2.2513,
+    "rotated": 2.2513,
+    "rotation": 2.2513,
+    "rotation:": 2.2513,
+    "rules.": 2.2513,
+    "run": 1.8458,
+    "say": 2.2513,
+    "scale": 2.2513,
+    "score": 2.2513,
+    "scoreboard": 2.2513,
+    "scores": 2.2513,
+    "seconds": 1.5581,
+    "seconds:": 2.2513,
+    "selector": 1.8458,
+    "separate": 2.2513,
+    "server": 2.2513,
+    "server.": 1.8458,
+    "server/console": 2.2513,
+    "session": 2.2513,
+    "set": 1.335,
+    "set_500:": 2.2513,
+    "set_score:": 2.2513,
+    "setblock": 2.2513,
+    "setdisplay": 2.2513,
+    "sets": 1.5581,
+    "sharpness": 2.2513,
+    "sharpness:5": 1.8458,
+    "sheep": 2.2513,
+    "shrink": 2.2513,
+    "shrink_over_time:": 2.2513,
+    "shrinkborder": 2.2513,
+    "shrinks": 2.2513,
+    "shrinks.": 2.2513,
+    "sidebar": 2.2513,
+    "significant": 1.1527,
+    "signs": 1.8458,
+    "simplified": 2.2513,
+    "since": 1.335,
+    "single": 2.2513,
+    "size.": 2.2513,
+    "skip": 2.2513,
+    "slingshooter08": 1.5581,
+    "slot": 2.2513,
+    "slow_falling": 2.2513,
+    "smite": 2.2513,
+    "source": 1.5581,
+    "sourcedimension": 2.2513,
+    "sourceobjective": 2.2513,
+    "sourcepath": 2.2513,
+    "sourcepos": 2.2513,
+    "south": 2.2513,
+    "sp": 2.2513,
+    "spawn_egg_override:": 2.2513,
+    "spawns": 2.2513,
+    "specific": 2.2513,
+    "specified": 2.2513,
+    "spectator": 2.2513,
+    "spectator.": 2.2513,
+    "spectator_all:": 2.2513,
+    "speed": 2.2513,
+    "split": 2.2513,
+    "stack": 2.2513,
+    "start": 2.2513,
+    "starts": 2.2513,
+    "states:": 1.8458,
+    "status": 2.2513,
+    "still": 2.2513,
+    "stone": 2.2513,
+    "storage": 2.2513,
+    "store": 2.2513,
+    "storm": 1.8458,
+    "string": 2.2513,
+    "structure": 2.2513,
+    "style": 2.2513,
+    "subcommand": 2.2513,
+    "subcommand:": 2.2513,
+    "success": 2.2513,
+    "sudo": 2.2513,
+    "summon": 1.8458,
+    "summons": 2.2513,
+    "superflat": 2.2513,
+    "supports": 2.2513,
+    "survival": 1.335,
+    "survival_player:": 2.2513,
+    "syntax": 1.8458,
+    "syntax.": 2.2513,
+    "tags": 1.8458,
+    "take": 2.2513,
+    "target": 0.865,
+    "target:": 2.2513,
+    "targetdimension": 2.2513,
+    "targetobjective": 2.2513,
+    "targetpath": 2.2513,
+    "targetpos": 2.2513,
+    "targets": 0.9985,
+    "targets:": 1.335,
+    "teleport": 2.2513,
+    "teleport.": 2.2513,
+    "teleporting": 2.2513,
+    "teleporting.": 2.2513,
+    "teleports": 2.2513,
+    "test": 2.2513,
+    "that": 2.2513,
+    "the": 0.7472,
+    "this": 2.2513,
+    "thunder": 2.2513,
+    "thunder.": 1.8458,
+    "thunder:": 2.2513,
+    "thunderstorm": 2.2513,
+    "ticks": 2.2513,
+    "ticks.": 2.2513,
+    "time": 2.2513,
+    "time:": 2.2513,
+    "timed:": 2.2513,
+    "tnt": 2.2513,
+    "to": 0.3054,
+    "to.": 2.2513,
+    "to:": 2.2513,
+    "to_coords:": 2.2513,
+    "to_player:": 2.2513,
+    "tools.": 2.2513,
+    "tp": 1.8458,
+    "training": 2.2513,
+    "translator": 2.2513,
+    "transposed": 2.2513,
+    "true": 1.335,
+    "type": 0.9985,
+    "type.": 2.2513,
+    "type:": 2.2513,
+    "unbreaking:3": 2.2513,
+    "unchanged": 2.2513,
+    "unless": 2.2513,
+    "unnecessary": 2.2513,
+    "unreliable": 2.2513,
+    "up": 2.2513,
+    "upper": 2.2513,
+    "use": 0.7472,
+    "uses": 1.8458,
+    "using": 1.335,
+    "uuid.": 1.8458,
+    "valid": 1.8458,
+    "value": 1.8458,
+    "values": 2.2513,
+    "values:": 2.2513,
+    "vanilla": 1.5581,
+    "version": 1.335,
+    "volume": 2.2513,
+    "warning": 2.2513,
+    "weather": 2.2513,
+    "weather_values:": 2.2513,
+    "west.": 2.2513,
+    "when": 1.8458,
+    "whether": 2.2513,
+    "whose": 2.2513,
+    "with": 0.5465,
+    "with_enchantments:": 2.2513,
+    "with_lore:": 2.2513,
+    "with_nbt:": 2.2513,
+    "with_potion:": 2.2513,
+    "with_state:": 2.2513,
+    "without": 1.5581,
+    "wood": 2.2513,
+    "words": 2.2513,
+    "works": 1.5581,
+    "world": 1.5581,
+    "world_type": 2.2513,
+    "worldborder": 2.2513,
+    "yaw": 2.2513,
+    "yaw:": 2.2513,
+    "zero": 2.2513,
+    "zombie": 2.2513,
+    "zombies": 2.2513
+  }
+}
\ No newline at end of file
diff --git a/knowledge/mc-commands/commands.json b/knowledge/mc-commands/commands.json
new file mode 100644
index 0000000..3441384
--- /dev/null
+++ b/knowledge/mc-commands/commands.json
@@ -0,0 +1,356 @@
+[
+  {
+    "command": "give",
+    "description": "Gives items to players",
+    "je_syntax": ["give <targets> <item> [<count>]"],
+    "arguments": {
+      "targets": {"type": "entity", "description": "Player name, target selector, or UUID. Must resolve to players."},
+      "item": {"type": "item_stack", "description": "Item ID with optional data components: item_id[component=value]. Since 1.20.5, uses data components instead of NBT."},
+      "count": {"type": "integer", "description": "Number of items (1-2147483647). Defaults to 1."}
+    },
+    "examples": {
+      "basic": "give @p minecraft:diamond_sword 1",
+      "with_enchantments": "give @p minecraft:diamond_sword[enchantments={sharpness:5,unbreaking:3}] 1",
+      "with_lore": "give @p minecraft:diamond_sword[lore=[\"Example\"]] 1",
+      "with_potion": "give @a minecraft:potion[potion_contents={potion:\"minecraft:night_vision\"}] 1",
+      "spawn_egg_override": "give @p minecraft:wolf_spawn_egg[entity_data={id:\"minecraft:cat\"}] 1",
+      "custom_max_stack": "give @s minecraft:totem_of_undying[max_stack_size=64] 2304"
+    },
+    "version_notes": "1.20.5+: NBT data tags replaced with data components. Old format: give @p diamond_sword{Enchantments:[{id:sharpness,lvl:5}]}. New format: give @p diamond_sword[enchantments={sharpness:5}].",
+    "common_errors": [
+      "Missing minecraft: namespace prefix (give @p diamond 1 -> give @p minecraft:diamond 1)",
+      "Transposed arguments: give @p 64 diamond -> give @p minecraft:diamond 64",
+      "Old NBT enchantment format: {Enchantments:[...]} is invalid in 1.21+",
+      "Using 'wood' instead of 'oak_log', 'food' instead of specific item ID"
+    ]
+  },
+  {
+    "command": "effect",
+    "description": "Adds or removes status effects from entities",
+    "je_syntax": [
+      "effect give <targets> <effect> [<seconds>] [<amplifier>] [<hideParticles>]",
+      "effect give <targets> <effect> infinite [<amplifier>] [<hideParticles>]",
+      "effect clear [<targets>] [<effect>]"
+    ],
+    "arguments": {
+      "targets": {"type": "entity", "description": "Player name, target selector, or UUID."},
+      "effect": {"type": "resource", "description": "Effect ID with minecraft: namespace (e.g. minecraft:speed, minecraft:resistance)."},
+      "seconds": {"type": "integer", "description": "Duration in seconds (0-1000000). Defaults to 30. For instant effects, duration is in game ticks."},
+      "amplifier": {"type": "integer", "description": "Effect level minus 1 (0-255). 0 = level I, 1 = level II, etc. Defaults to 0."},
+      "hideParticles": {"type": "bool", "description": "Whether to hide particles and HUD indicator. Defaults to false."}
+    },
+    "examples": {
+      "basic_speed": "effect give @p minecraft:speed 60 1",
+      "resistance_hidden": "effect give @s minecraft:resistance 1000000 4 true",
+      "clear_all": "effect clear @a",
+      "clear_specific": "effect clear @a minecraft:haste",
+      "infinite_duration": "effect give @p minecraft:night_vision infinite 0"
+    },
+    "version_notes": "Since 1.13, syntax split into 'effect give' and 'effect clear'. Bare 'effect <player> <effect>' without 'give' is INVALID.",
+    "common_errors": [
+      "Missing 'give' subcommand: 'effect @p speed 60' is invalid. Must be 'effect give @p minecraft:speed 60'",
+      "Inventing effects: 'invulnerability' does not exist. Use resistance 4 + regeneration 2 + absorption 4 instead",
+      "Missing minecraft: prefix on effect ID"
+    ]
+  },
+  {
+    "command": "tp",
+    "aliases": ["teleport"],
+    "description": "Teleports entities to positions or other entities",
+    "je_syntax": [
+      "tp <destination>",
+      "tp <targets> <destination>",
+      "tp <location>",
+      "tp <targets> <location>",
+      "tp <targets> <location> <rotation>",
+      "tp <targets> <location> facing <facingLocation>",
+      "tp <targets> <location> facing entity <facingEntity> [<facingAnchor>]"
+    ],
+    "arguments": {
+      "targets": {"type": "entity", "description": "Entity/entities to teleport. If omitted, defaults to command executor."},
+      "destination": {"type": "entity", "description": "Entity to teleport to. Must resolve to single entity."},
+      "location": {"type": "vec3", "description": "X Y Z coordinates. Supports ~ (relative) and ^ (local/caret) notation."},
+      "rotation": {"type": "rotation", "description": "Yaw and pitch in degrees. Yaw: -180=north, -90=east, 0=south, 90=west."},
+      "facingLocation": {"type": "vec3", "description": "Coordinates to face after teleporting."},
+      "facingEntity": {"type": "entity", "description": "Entity to face after teleporting."},
+      "facingAnchor": {"type": "entity_anchor", "description": "eyes or feet. Defaults to feet."}
+    },
+    "examples": {
+      "to_player": "tp @s Alice",
+      "all_to_self": "tp @a @s",
+      "to_coords": "tp @s 100 64 -200",
+      "relative": "tp @s ~ ~3 ~",
+      "forward_one_block": "tp @s ^ ^ ^1",
+      "cross_dimension": "execute in minecraft:the_nether run tp @s ~ ~ ~"
+    },
+    "version_notes": "Since 1.13, /tp is an alias for /teleport with identical syntax. Coordinates are relative to executor for both.",
+    "common_errors": [
+      "Using 'execute as' instead of 'execute at' for relative coordinates -- 'as' changes executor but not position context",
+      "Teleporting ~100 up without slow_falling -- causes fall damage",
+      "Using tp in benevolent responses when player didn't ask to move"
+    ]
+  },
+  {
+    "command": "execute",
+    "description": "Executes commands with modified context (executor, position, conditions)",
+    "je_syntax": [
+      "execute align <axes> -> execute",
+      "execute anchored <anchor> -> execute",
+      "execute as <targets> -> execute",
+      "execute at <targets> -> execute",
+      "execute facing (<pos>|entity <targets> <anchor>) -> execute",
+      "execute in <dimension> -> execute",
+      "execute on <relation> -> execute",
+      "execute positioned (<pos>|as <targets>|over <heightmap>) -> execute",
+      "execute rotated (<rot>|as <targets>) -> execute",
+      "execute store (result|success) ... -> execute",
+      "execute summon <entity> -> execute",
+      "execute (if|unless) ... -> [execute]",
+      "execute run <command>"
+    ],
+    "key_subcommands": {
+      "as": "Changes executor (@s) but NOT position. Use for targeting entities.",
+      "at": "Changes execution position, rotation, AND dimension to match entity. Use for relative coordinates.",
+      "positioned": "Changes only position. Does not change rotation or dimension.",
+      "if/unless block": "Tests block at position. 'execute if block X Y Z minecraft:stone'",
+      "if/unless entity": "Tests entity existence. 'execute if entity @e[type=zombie,distance=..10]'",
+      "run": "Executes the final command. Must be last in the chain."
+    },
+    "examples": {
+      "at_player": "execute at slingshooter08 run fill ~-5 ~-1 ~-5 ~5 ~-1 ~5 minecraft:stone",
+      "as_all_entities": "execute as @e[type=sheep] at @s run tp @s ~ ~1 ~",
+      "conditional": "execute if entity @e[type=zombie,distance=..10] run say Zombies nearby!",
+      "cross_dimension": "execute in minecraft:the_nether run locate structure minecraft:fortress",
+      "block_check": "execute if block 0 64 0 minecraft:grass_block run say Found grass"
+    },
+    "version_notes": "Since 1.13, completely restructured with subcommand chains. Old 'execute <entity> ~ ~ ~ <command>' format is invalid.",
+    "common_errors": [
+      "'execute as <player> run fill ~ ~ ~ ...' -- 'as' does NOT set position. Relative coords resolve to server/console origin, not the player. Use 'execute at' or 'execute as <player> at @s'",
+      "Unnecessary nesting: 'execute as X run execute positioned ~ ~ ~ run ...' can be simplified to 'execute at X run ...'",
+      "'execute as X run gameMode creative' -- 'as' is unnecessary for commands that take a player argument directly"
+    ]
+  },
+  {
+    "command": "weather",
+    "description": "Sets the weather",
+    "je_syntax": ["weather (clear|rain|thunder) [<duration>]"],
+    "arguments": {
+      "type": {"type": "literal", "description": "One of: clear, rain, thunder. NO other values (storm, rainstorm, thunderstorm are INVALID)."},
+      "duration": {"type": "integer", "description": "Duration in seconds (0-1000000). Defaults to random 6000-18000 ticks (300-900 seconds)."}
+    },
+    "examples": {
+      "clear": "weather clear",
+      "rain": "weather rain",
+      "thunder": "weather thunder",
+      "timed": "weather rain 600"
+    },
+    "version_notes": "No significant changes in 1.21.",
+    "common_errors": [
+      "'weather storm' is INVALID -- use 'weather thunder'",
+      "'weather rainstorm' is INVALID -- use 'weather thunder'",
+      "'weather thunderstorm' is INVALID -- use 'weather thunder'"
+    ]
+  },
+  {
+    "command": "gamemode",
+    "description": "Sets a player's game mode",
+    "je_syntax": ["gamemode <gamemode> [<target>]"],
+    "arguments": {
+      "gamemode": {"type": "gamemode", "description": "One of: survival, creative, adventure, spectator. Full words only, not abbreviations."},
+      "target": {"type": "entity", "description": "Player(s) to change. Defaults to executor if omitted."}
+    },
+    "examples": {
+      "creative_self": "gamemode creative",
+      "survival_player": "gamemode survival slingshooter08",
+      "spectator_all": "gamemode spectator @a"
+    },
+    "version_notes": "No significant changes in 1.21. Numeric IDs (0,1,2,3) and abbreviations (s,c,a,sp) are NOT valid in JE.",
+    "common_errors": [
+      "'gameMode' (camelCase) is not a valid command -- use lowercase 'gamemode'",
+      "Abbreviations 's', 'c', 'a', 'sp' are NOT valid in JE -- use full words",
+      "Numeric modes '0', '1', '2', '3' are NOT valid in JE -- use full words"
+    ]
+  },
+  {
+    "command": "fill",
+    "description": "Fills a region with a specified block",
+    "je_syntax": ["fill <from> <to> <block> [destroy|hollow|keep|outline|replace [<filter>]]"],
+    "arguments": {
+      "from": {"type": "block_pos", "description": "One corner of the fill region (X Y Z integers or ~ notation)."},
+      "to": {"type": "block_pos", "description": "Opposite corner of the fill region."},
+      "block": {"type": "block_state", "description": "Block to fill with, including optional states: minecraft:stone, minecraft:oak_stairs[facing=north]."},
+      "mode": {"type": "literal", "description": "destroy (drops items), hollow (fills edges only, air inside), keep (only replaces air), outline (fills edges only, interior unchanged), replace (default, replaces all blocks)."},
+      "filter": {"type": "block_predicate", "description": "When using 'replace', only replace blocks matching this filter."}
+    },
+    "examples": {
+      "basic_fill": "fill 0 64 0 10 68 10 minecraft:stone",
+      "replace_air": "fill -10 60 -10 10 70 10 minecraft:glass replace air",
+      "hollow_box": "fill 0 64 0 10 74 10 minecraft:stone hollow",
+      "clear_area": "fill -20 60 -20 20 80 20 minecraft:air",
+      "fire_replace_air": "fill -25 64 -25 25 68 25 minecraft:fire replace air"
+    },
+    "version_notes": "1.21: No block metadata numbers. 'fill ... fire 0 replace air' is invalid. Use 'fill ... minecraft:fire replace air'.",
+    "common_errors": [
+      "Using metadata numbers: 'fill ... fire 0' is invalid in 1.21. Drop the '0'.",
+      "Max fill volume is 32768 blocks per command",
+      "Missing minecraft: prefix on block ID"
+    ]
+  },
+  {
+    "command": "setblock",
+    "description": "Places a block at a position",
+    "je_syntax": ["setblock <pos> <block> [destroy|keep|replace]"],
+    "arguments": {
+      "pos": {"type": "block_pos", "description": "X Y Z position for the block."},
+      "block": {"type": "block_state", "description": "Block to place with optional states: minecraft:oak_door[facing=north,half=upper]."},
+      "mode": {"type": "literal", "description": "destroy (drops old block as item), keep (only place if current block is air), replace (default)."}
+    },
+    "examples": {
+      "basic": "setblock 0 64 0 minecraft:diamond_block",
+      "with_state": "setblock 0 64 0 minecraft:oak_door[facing=north,half=lower]",
+      "keep": "setblock 0 64 0 minecraft:torch keep"
+    },
+    "version_notes": "No significant changes in 1.21.",
+    "common_errors": ["Missing minecraft: prefix on block ID"]
+  },
+  {
+    "command": "clone",
+    "description": "Copies blocks from one region to another",
+    "je_syntax": [
+      "clone [from <sourceDimension>] <begin> <end> [to <targetDimension>] <destination> [replace|masked] [force|move|normal]",
+      "clone [from <sourceDimension>] <begin> <end> [to <targetDimension>] <destination> filtered <filter> [force|move|normal]"
+    ],
+    "arguments": {
+      "begin": {"type": "block_pos", "description": "One corner of source region."},
+      "end": {"type": "block_pos", "description": "Opposite corner of source region."},
+      "destination": {"type": "block_pos", "description": "Lower northwest corner of destination region."},
+      "maskMode": {"type": "literal", "description": "replace (all blocks), masked (skip air blocks), filtered (only matching blocks)."},
+      "cloneMode": {"type": "literal", "description": "force (allows overlap), move (fills source with air), normal (default, no overlap allowed)."}
+    },
+    "examples": {
+      "basic": "clone 0 64 0 10 74 10 100 64 100",
+      "masked": "clone 0 64 0 10 74 10 100 64 100 masked",
+      "move": "clone 0 64 0 10 74 10 100 64 100 replace move"
+    },
+    "version_notes": "1.20.2+: Added cross-dimension cloning with 'from' and 'to' dimension arguments.",
+    "common_errors": ["Cloning to overlapping region without 'force' mode", "No-op clone (source equals destination)"]
+  },
+  {
+    "command": "summon",
+    "description": "Summons an entity",
+    "je_syntax": ["summon <entity> [<pos>] [<nbt>]"],
+    "arguments": {
+      "entity": {"type": "resource", "description": "Entity type ID: minecraft:zombie, minecraft:tnt, etc."},
+      "pos": {"type": "vec3", "description": "Position to summon at. Defaults to executor position."},
+      "nbt": {"type": "compound_tag", "description": "NBT data for the entity (still uses NBT, not data components)."}
+    },
+    "examples": {
+      "basic": "summon minecraft:zombie ~ ~ ~",
+      "at_coords": "summon minecraft:tnt 0 65 0",
+      "with_nbt": "summon minecraft:zombie ~ ~ ~ {IsBaby:1}",
+      "named": "summon minecraft:villager ~ ~ ~ {CustomName:'\"Bob\"'}"
+    },
+    "version_notes": "summon still uses NBT tags (not data components) as of 1.21. Cannot append count to summon -- each call creates exactly one entity.",
+    "common_errors": [
+      "'summon tnt ~ ~1 ~ 20' is INVALID -- cannot append count. Must use separate summon commands for multiple entities.",
+      "Missing minecraft: namespace prefix on entity type"
+    ]
+  },
+  {
+    "command": "worldborder",
+    "description": "Manages the world border",
+    "je_syntax": [
+      "worldborder add <distance> [<time>]",
+      "worldborder center <pos>",
+      "worldborder damage amount <damagePerBlock>",
+      "worldborder damage buffer <distance>",
+      "worldborder get",
+      "worldborder set <distance> [<time>]",
+      "worldborder warning distance <distance>",
+      "worldborder warning time <time>"
+    ],
+    "arguments": {
+      "distance": {"type": "float/int", "description": "Border diameter in blocks. For 'add', positive expands, negative shrinks."},
+      "time": {"type": "integer", "description": "Seconds for the border to reach its target size. 0 = instant."},
+      "pos": {"type": "vec2", "description": "X Z center coordinates."}
+    },
+    "examples": {
+      "get_size": "worldborder get",
+      "set_500": "worldborder set 500",
+      "shrink_over_time": "worldborder set 100 600",
+      "center": "worldborder center 0 0"
+    },
+    "version_notes": "No significant changes in 1.21.",
+    "common_errors": ["'worldborder set 0' sets border to zero, effectively killing all players outside center"]
+  },
+  {
+    "command": "enchant",
+    "description": "Enchants the held item of a player",
+    "je_syntax": ["enchant <targets> <enchantment> [<level>]"],
+    "arguments": {
+      "targets": {"type": "entity", "description": "Player(s) whose held item to enchant."},
+      "enchantment": {"type": "resource", "description": "Enchantment ID: minecraft:sharpness, minecraft:protection, etc."},
+      "level": {"type": "integer", "description": "Enchantment level. Defaults to 1. Cannot exceed max vanilla level."}
+    },
+    "examples": {
+      "basic": "enchant @s minecraft:sharpness 5",
+      "all_players": "enchant @a minecraft:unbreaking 3"
+    },
+    "version_notes": "The /enchant command only works on the item the player is currently holding. It respects vanilla max levels and compatibility rules. For pre-enchanted items, use /give with component syntax instead: give @s diamond_sword[enchantments={sharpness:5}]",
+    "common_errors": [
+      "Using /enchant to fully enchant items is unreliable -- it only affects held item and respects vanilla limits. Prefer /give with enchantment components for guaranteed results.",
+      "Cannot stack incompatible enchantments (e.g. sharpness + smite)"
+    ]
+  },
+  {
+    "command": "scoreboard",
+    "description": "Manages scoreboard objectives and player scores",
+    "je_syntax": [
+      "scoreboard objectives add <objective> <criteria> [<displayName>]",
+      "scoreboard objectives list",
+      "scoreboard objectives modify <objective> displayname <displayName>",
+      "scoreboard objectives modify <objective> rendertype (hearts|integer)",
+      "scoreboard objectives remove <objective>",
+      "scoreboard objectives setdisplay <slot> [<objective>]",
+      "scoreboard players add <targets> <objective> <score>",
+      "scoreboard players display name <targets> <objective> <name>",
+      "scoreboard players display numberformat <targets> <objective> ...",
+      "scoreboard players enable <targets> <objective>",
+      "scoreboard players get <target> <objective>",
+      "scoreboard players list [<target>]",
+      "scoreboard players operation <targets> <targetObjective> <operation> <source> <sourceObjective>",
+      "scoreboard players remove <targets> <objective> <score>",
+      "scoreboard players reset <targets> [<objective>]",
+      "scoreboard players set <targets> <objective> <score>"
+    ],
+    "examples": {
+      "create_objective": "scoreboard objectives add deaths deathCount \"Deaths\"",
+      "set_score": "scoreboard players set @s deaths 0",
+      "add_score": "scoreboard players add @s deaths 1",
+      "display": "scoreboard objectives setdisplay sidebar deaths"
+    },
+    "version_notes": "No significant changes in 1.21.",
+    "common_errors": []
+  },
+  {
+    "command": "data",
+    "description": "Gets, merges, modifies, or removes NBT data from entities, block entities, or storage",
+    "je_syntax": [
+      "data get (block <targetPos>|entity <target>|storage <target>) [<path>] [<scale>]",
+      "data merge (block <targetPos>|entity <target>|storage <target>) <nbt>",
+      "data modify (block <targetPos>|entity <target>|storage <target>) <targetPath> (append|insert <index>|merge|prepend|set) (from (block <sourcePos>|entity <source>|storage <source>) [<sourcePath>]|string (block <sourcePos>|entity <source>|storage <source>) [<sourcePath>] [<start>] [<end>]|value <value>)",
+      "data remove (block <targetPos>|entity <target>|storage <target>) <path>"
+    ],
+    "examples": {
+      "get_player_pos": "data get entity slingshooter08 Pos",
+      "get_block_data": "data get block 0 64 0",
+      "get_health": "data get entity @p Health",
+      "get_inventory": "data get entity @p Inventory"
+    },
+    "version_notes": "'data get block' only works on block entities (chests, signs, etc.), NOT regular blocks like stone or grass.",
+    "common_errors": [
+      "'data get block' on non-block-entity blocks returns 'The target block is not a block entity'",
+      "Cannot modify player data directly with 'data merge entity' in most cases"
+    ]
+  }
+]
diff --git a/knowledge/server-context/servers.json b/knowledge/server-context/servers.json
new file mode 100644
index 0000000..f6f8970
--- /dev/null
+++ b/knowledge/server-context/servers.json
@@ -0,0 +1,82 @@
+{
+  "servers": [
+    {
+      "name": "mc1",
+      "type": "vanilla",
+      "version": "1.21.x",
+      "game_port": 25565,
+      "rcon_port": 25575,
+      "host": "192.168.0.244",
+      "difficulty": "easy",
+      "gamemode": "survival",
+      "max_players": 20,
+      "online_mode": true,
+      "pvp": true,
+      "notes": "Main vanilla survival server. MCSManager-managed."
+    },
+    {
+      "name": "shrink-world",
+      "type": "vanilla",
+      "version": "1.21.x",
+      "game_port": 25566,
+      "rcon_port": 25576,
+      "host": "192.168.0.244",
+      "difficulty": "hard",
+      "gamemode": "survival",
+      "max_players": 20,
+      "online_mode": true,
+      "pvp": true,
+      "datapacks": ["shrinkborder (world border shrinks on death)", "morespawns (5x creeper spawns)"],
+      "notes": "Hardcore-style challenge server. World border starts at 500x500."
+    },
+    {
+      "name": "paper-ai",
+      "type": "paper",
+      "version": "1.21.11",
+      "game_port": 25567,
+      "rcon_port": 25577,
+      "host": "192.168.0.244",
+      "difficulty": "hard",
+      "gamemode": "survival",
+      "max_players": 20,
+      "online_mode": true,
+      "pvp": true,
+      "plugins": ["FastAsyncWorldEdit", "LuckPerms"],
+      "ai_services": ["mc-aigod-paper.service (God/sudo AI)", "mc-langgraph-gateway.service (session gateway)"],
+      "notes": "Paper fork with AI God, sudo translator, and world observation tools."
+    },
+    {
+      "name": "paper-dev",
+      "type": "paper",
+      "version": "1.21.11",
+      "game_port": 25568,
+      "rcon_port": 25578,
+      "host": "192.168.0.244",
+      "difficulty": "peaceful",
+      "gamemode": "creative",
+      "max_players": 50,
+      "online_mode": false,
+      "pvp": false,
+      "world_type": "flat",
+      "notes": "Offline dev server for AI training bots. Superflat, no mobs."
+    }
+  ],
+  "infrastructure": {
+    "ct_id": 644,
+    "node": "node-112",
+    "ip": "192.168.0.244",
+    "java_version": "21 (Temurin)",
+    "panel": "MCSManager at mc.sethpc.xyz",
+    "bot_framework": "/opt/mc-ai-bots/ (Mineflayer, Node.js v20)"
+  },
+  "players": [
+    {"username": "slingshooter08", "uuid": "45374469-5333-43e1-9881-39ad6b5f3301", "role": "admin/owner"}
+  ],
+  "version_notes": {
+    "enchantment_syntax": "1.21+: give player item[enchantments={name:level}]. Old NBT format {Enchantments:[...]} is INVALID.",
+    "effect_syntax": "1.13+: Must use 'effect give <target> <effect>'. Bare 'effect <target> <effect>' is INVALID.",
+    "weather_values": "Only valid values: clear, rain, thunder. 'storm', 'rainstorm' are INVALID.",
+    "execute_as_vs_at": "'execute as' changes executor (@s) but NOT position. 'execute at' changes position. Use 'at' for relative coordinates.",
+    "data_get_blocks": "'data get block' only works on block entities (chests, signs). For regular blocks, use 'execute if block' to test type."
+  }
+}