fix(tools): formatter bracket rules, LSP compiler diagnostics, vocabulary sync

- ludic-fmt: `rows[i]`, `new []int`, `s[a..b]`, `emit(`, `~x`, list-literal
  and query-tag braces stay tight; member calls hug their paren
  (`Date.new(`, `Prefab.spawn(`); `<< >> & | ^ ~` are operators and
  `&& ||` are not — mirrored in ludic_syntax.h, LudicLexer.kt and the
  TextMate grammar. 149 of 274 tracked sources failed --check before.
- ludic-lsp: `initializationOptions.compilerDiagnostics` / `compilerPath`
  are honoured — on save the document's compilation unit is compiled and
  `file:line: error: msg` is published as a "ludicc" diagnostic (the
  option had been documented but never implemented); the workspace scan
  file is per process; bracket codes spelled as char literals
- Overlay added to LUDIC_PHASES, LudicTokens.kt, ludic-mode.el and the
  grammar (the game uses it; check-vocabulary flagged the drift)
- editors: VS Code snippets/package.json/extension.js (`${workspaceFolder}`
  and `~` expansion, PATH lookup, Apache-2.0, real repo URL), Neovim root
  markers, Helix/Zed/Sublime bin/ paths, Emacs vocabulary, JetBrains
  comments; tools/editors/README.md no longer describes C tooling
- .forgejo workflows clone `${{ github.server_url }}/${{ github.repository }}`
  so a fork or mirror tests itself; the docs publish pushes the same way

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

tools/editors/jetbrains/src/main/kotlin/io/ludic/ide/LudicEditorSupport.kt

@@ -35,7 +35,7 @@ class LudicBraceMatcher : PairedBraceMatcher {
     private companion object {
         // Structural braces only: a record literal shares the token type, so
         // marking them all structural would make the "matched brace" gutter
-        // noisy inside `spawn Hero { Pos = { x = 1 } }`.
+        // noisy inside `spawn Hero { Pos { x: 1 } }`.
         val PAIRS = arrayOf(
             BracePair(LudicTokens.BRACE, LudicTokens.BRACE, true),
             BracePair(LudicTokens.BRACKET, LudicTokens.BRACKET, false),

tools/editors/jetbrains/src/main/kotlin/io/ludic/ide/LudicLexer.kt

@@ -7,7 +7,7 @@ import com.intellij.psi.tree.IElementType
 /**
  * A hand-written lexer matching tools/ludic-tools/ludic_syntax.h token for
  * token. Hand-written rather than generated because the grammar is small, the
- * rules are the ones the C lexer already implements, and keeping the two
+ * rules are the ones the shared header already implements, and keeping the two
  * readable side by side is worth more here than a JFlex spec.
  *
  * It must never throw and never fail to advance: the IDE lexes half-typed text
@@ -142,7 +142,7 @@ class LudicLexer : LexerBase() {
     }
 
     private companion object {
-        val TWO_CHAR_OPS = setOf("->", "+=", "-=", "*=", "/=", "==", "!=", "<=", ">=", "&&", "||", "..", "=>")
-        const val SINGLE_CHAR_OPS = "+-*/%<>=:.!@;"
+        val TWO_CHAR_OPS = setOf("->", "+=", "-=", "*=", "/=", "==", "!=", "<=", ">=", "<<", ">>", "..", "=>")
+        const val SINGLE_CHAR_OPS = "+-*/%<>=:.!@;&|^~"
     }
 }

tools/editors/jetbrains/src/main/kotlin/io/ludic/ide/LudicServer.kt

@@ -17,7 +17,7 @@ import java.io.File
 
 /**
  * Where to find the toolchain. Both paths may be left blank, in which case the
- * plugin looks under the project root for what tools/build-tools.sh produces —
+ * plugin looks under the project root for what `bin/x tools` produces —
  * which is the case for anyone working in the Ludic repository itself.
  */
 @Service(Service.Level.PROJECT)
@@ -110,7 +110,7 @@ class LudicConnectionProvider(private val project: Project) : ProcessStreamConne
             }
             append("  and on PATH.\n")
         }
-        append("\nBuild it with ./tools/build-tools.sh from the repository root, ")
+        append("\nBuild it with `bin/x tools` from the repository root, ")
         append("or set the path in Settings | Languages & Frameworks | Ludic. ")
         append("Syntax highlighting works without it; completion and diagnostics do not.")
     }

tools/editors/jetbrains/src/main/kotlin/io/ludic/ide/LudicTokens.kt

@@ -20,8 +20,8 @@ object LudicTokens {
     val IDENTIFIER = LudicTokenType("IDENTIFIER")
     val TYPE_NAME = LudicTokenType("TYPE_NAME")       // Capitalised: component, archetype, scene
     val KEYWORD = LudicTokenType("KEYWORD")
-    val DECL_KEYWORD = LudicTokenType("DECL_KEYWORD") // game, component, system, function, ...
-    val CLAUSE = LudicTokenType("CLAUSE")             // phase, query, reads, writes, ...
+    val DECL_KEYWORD = LudicTokenType("DECL_KEYWORD") // program, property, model, handler, function, ...
+    val CLAUSE = LudicTokenType("CLAUSE")             // phase, query, on, layer, ...
     val PRIMITIVE = LudicTokenType("PRIMITIVE")       // int, fixed, bool, entity, string, pointer, void
     val PHASE = LudicTokenType("PHASE")               // Start, Update, Render, ...
     val BOOLEAN = LudicTokenType("BOOLEAN")
@@ -53,7 +53,7 @@ object LudicVocabulary {
         "and", "or", "not", "break", "continue", "new", "emit", "cancel", "try"
     )
     val PRIMITIVES = setOf("int", "long", "fixed", "countdown", "bool", "entity", "string", "pointer", "byte", "words", "fixeds", "pointers", "Vector", "IVec2", "Rect", "void")
-    val PHASES = setOf("Start", "Input", "FixedUpdate", "Update", "LateUpdate", "Render")
+    val PHASES = setOf("Start", "Input", "FixedUpdate", "Update", "LateUpdate", "Render", "Overlay")
     val WIDGETS = setOf("panel", "col", "row", "label", "button", "image", "spacer")
 
     val BUILTINS = setOf(

tools/editors/jetbrains/src/main/resources/META-INF/plugin.xml

@@ -67,7 +67,7 @@
             name="Ludic"
             factoryClass="io.ludic.ide.LudicLanguageServerFactory">
             <description><![CDATA[
-            The Ludic language server. Built by <code>tools/build-tools.sh</code>.
+            The Ludic language server. Built by <code>bin/x tools</code>.
             ]]></description>
         </server>
         <languageMapping language="Ludic" serverId="ludic"/>