mcp-garry-codes 1.0.0

package/dist/integrations/glualint_adapter.js

@@ -0,0 +1,62 @@
+import { getConfig } from "../config/env.js";
+import { ProcessRunner } from "../core/process_runner.js";
+import { GLuaAnalyzer } from "../domain/glua/ast.js";
+import { logger } from "../core/logger.js";
+import fs from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+export class GLuaLintAdapter {
+    static async lint(code, realm = "shared", fixFormatting = false) {
+        const config = getConfig();
+        const binary = config.GLUALINT_PATH;
+        let externalDiagnostics = [];
+        let formattedCode = undefined;
+        if (binary) {
+            try {
+                const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "gmod_lint_"));
+                const tempFile = path.join(tempDir, "temp.lua");
+                await fs.writeFile(tempFile, code, "utf-8");
+                const args = ["--lint", tempFile];
+                if (fixFormatting) {
+                    args.push("--fix");
+                }
+                const result = await ProcessRunner.execute(binary, args, { timeoutMs: 5000 });
+                // Parse glualint output lines: [file]:[line]:[col]: [message]
+                const lines = (result.stdout + "\n" + result.stderr).split("\n");
+                for (const line of lines) {
+                    const match = line.match(/:(\d+):(\d+):\s*(.*)$/);
+                    if (match) {
+                        externalDiagnostics.push({
+                            line: parseInt(match[1], 10),
+                            column: parseInt(match[2], 10),
+                            severity: line.toLowerCase().includes("warning") ? "warning" : "error",
+                            code: "GLUALINT",
+                            message: match[3].trim()
+                        });
+                    }
+                }
+                if (fixFormatting) {
+                    formattedCode = await fs.readFile(tempFile, "utf-8");
+                }
+                await fs.rm(tempDir, { recursive: true, force: true }).catch(() => { });
+            }
+            catch (err) {
+                logger.warn("glualint execution failed, using embedded AST analyzer fallback:", { error: String(err) });
+            }
+        }
+        // Run embedded AST analysis
+        const internalDiagnostics = GLuaAnalyzer.analyze(code, realm);
+        const combinedDiagnostics = [...externalDiagnostics, ...internalDiagnostics];
+        const errorCount = combinedDiagnostics.filter(d => d.severity === "error").length;
+        const warningCount = combinedDiagnostics.filter(d => d.severity === "warning").length;
+        return {
+            valid: errorCount === 0,
+            error_count: errorCount,
+            warning_count: warningCount,
+            realm_detected: realm,
+            diagnostics: combinedDiagnostics,
+            formatted_code: formattedCode
+        };
+    }
+}
+//# sourceMappingURL=glualint_adapter.js.map

package/dist/integrations/glualint_adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glualint_adapter.js","sourceRoot":"","sources":["../../src/integrations/glualint_adapter.ts"],"names":[],"mappings":"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"}

package/dist/integrations/python_test_harness.d.ts

@@ -0,0 +1,5 @@
+import { RunGLuaTestInput, RunGLuaTestOutput } from "../contracts/test_contracts.js";
+export declare class PythonTestHarness {
+    static runTest(input: RunGLuaTestInput): Promise<RunGLuaTestOutput>;
+}
+//# sourceMappingURL=python_test_harness.d.ts.map

package/dist/integrations/python_test_harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python_test_harness.d.ts","sourceRoot":"","sources":["../../src/integrations/python_test_harness.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAQrF,qBAAa,iBAAiB;WACR,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA8DjF"}

package/dist/integrations/python_test_harness.js

@@ -0,0 +1,67 @@
+import { getConfig } from "../config/env.js";
+import { ProcessRunner } from "../core/process_runner.js";
+import { PathGuard } from "../security/path_guard.js";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export class PythonTestHarness {
+    static async runTest(input) {
+        const config = getConfig();
+        const pythonBin = config.PYTHON_PATH;
+        // Resolve script path
+        const testerScript = path.resolve(__dirname, "..", "test_harness", "python", "gmod_tester.py");
+        let testFile = "";
+        if (input.test_file_path) {
+            testFile = PathGuard.resolveSafePath(input.test_file_path);
+        }
+        const args = [testerScript];
+        if (testFile) {
+            args.push(testFile);
+        }
+        else {
+            args.push("");
+        }
+        args.push(input.mock_realm ?? "shared");
+        try {
+            const processResult = await ProcessRunner.execute(pythonBin, args, {
+                timeoutMs: input.timeout_ms ?? 5000,
+                env: input.code_to_test ? { INLINE_GLUA: input.code_to_test } : undefined
+            });
+            // gmod_tester.py prints a JSON line
+            const lines = processResult.stdout.trim().split("\n");
+            const jsonLine = lines.find(l => l.startsWith("{") && l.endsWith("}"));
+            if (jsonLine) {
+                return JSON.parse(jsonLine);
+            }
+            return {
+                passed: processResult.exitCode === 0,
+                tests_run: 1,
+                failures: processResult.exitCode === 0 ? 0 : 1,
+                errors: processResult.exitCode === 0 ? [] : [{
+                        test_name: "Execution Error",
+                        error_message: processResult.stderr || processResult.stdout,
+                        stack_trace: ""
+                    }],
+                output_log: processResult.stdout + "\n" + processResult.stderr,
+                execution_time_ms: 50
+            };
+        }
+        catch (err) {
+            const errorMsg = String(err);
+            return {
+                passed: false,
+                tests_run: 1,
+                failures: 1,
+                errors: [{
+                        test_name: "Harness Failure",
+                        error_message: errorMsg,
+                        stack_trace: ""
+                    }],
+                output_log: errorMsg,
+                execution_time_ms: 0
+            };
+        }
+    }
+}
+//# sourceMappingURL=python_test_harness.js.map

package/dist/integrations/python_test_harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python_test_harness.js","sourceRoot":"","sources":["../../src/integrations/python_test_harness.ts"],"names":[],"mappings":"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"}

package/dist/integrations/web_search_adapter.d.ts

@@ -0,0 +1,6 @@
+import { WebSearchResultItem } from "../contracts/wiki_contracts.js";
+export declare class WebSearchAdapter {
+    static search(query: string, domainFilter?: "github" | "facepunch" | "reddit" | "steam" | "all", maxResults?: number): Promise<WebSearchResultItem[]>;
+    private static getFallbackResults;
+}
+//# sourceMappingURL=web_search_adapter.d.ts.map

package/dist/integrations/web_search_adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web_search_adapter.d.ts","sourceRoot":"","sources":["../../src/integrations/web_search_adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,qBAAa,gBAAgB;WACP,MAAM,CACxB,KAAK,EAAE,MAAM,EACb,YAAY,GAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAa,EACzE,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAqEjC,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAmBlC"}

package/dist/integrations/web_search_adapter.js

@@ -0,0 +1,80 @@
+import { logger } from "../core/logger.js";
+export class WebSearchAdapter {
+    static async search(query, domainFilter = "all", maxResults = 5) {
+        let siteFilter = "";
+        if (domainFilter === "github") {
+            siteFilter = "site:github.com ";
+        }
+        else if (domainFilter === "facepunch") {
+            siteFilter = "site:wiki.facepunch.com OR site:forum.facepunch.com ";
+        }
+        else if (domainFilter === "reddit") {
+            siteFilter = "site:reddit.com/r/gmod ";
+        }
+        else if (domainFilter === "steam") {
+            siteFilter = "site:steamcommunity.com ";
+        }
+        const fullQuery = `garrys mod ${siteFilter}${query}`;
+        const url = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(fullQuery)}`;
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 5000);
+            const response = await fetch(url, {
+                headers: {
+                    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
+                },
+                signal: controller.signal
+            });
+            clearTimeout(timeout);
+            if (!response.ok) {
+                return this.getFallbackResults(query, domainFilter);
+            }
+            const html = await response.text();
+            const results = [];
+            // Parse DuckDuckGo search result links and snippets
+            const resultRegex = /<a class="result__url" href="([^"]+)">[\s\S]*?<a class="result__snippet[^>]*>([\s\S]*?)<\/a>/g;
+            let match;
+            while ((match = resultRegex.exec(html)) !== null && results.length < maxResults) {
+                const rawUrl = match[1].trim();
+                const snippet = match[2].replace(/<[^>]+>/g, "").trim();
+                // Decode DDG uddg param if present
+                let actualUrl = rawUrl;
+                const uddgMatch = rawUrl.match(/uddg=([^&]+)/);
+                if (uddgMatch) {
+                    actualUrl = decodeURIComponent(uddgMatch[1]);
+                }
+                results.push({
+                    title: `GMod Resource: ${query}`,
+                    url: actualUrl,
+                    snippet,
+                    source: domainFilter === "all" ? "community" : domainFilter
+                });
+            }
+            if (results.length === 0) {
+                return this.getFallbackResults(query, domainFilter);
+            }
+            return results;
+        }
+        catch (err) {
+            logger.warn(`Web search request failed: ${String(err)}`);
+            return this.getFallbackResults(query, domainFilter);
+        }
+    }
+    static getFallbackResults(query, domainFilter) {
+        return [
+            {
+                title: `Facepunch Wiki & Community for '${query}'`,
+                url: `https://wiki.facepunch.com/gmod/?q=${encodeURIComponent(query)}`,
+                snippet: `Facepunch official documentation and developer references matching '${query}'.`,
+                source: domainFilter
+            },
+            {
+                title: `GitHub GLua Repositories for '${query}'`,
+                url: `https://github.com/search?q=garrysmod+${encodeURIComponent(query)}+language%3ALua`,
+                snippet: `Open source Garry's Mod addons, SWEPs, and gamemodes containing '${query}'.`,
+                source: "github"
+            }
+        ];
+    }
+}
+//# sourceMappingURL=web_search_adapter.js.map

package/dist/integrations/web_search_adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web_search_adapter.js","sourceRoot":"","sources":["../../src/integrations/web_search_adapter.ts"],"names":[],"mappings":"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"}

package/dist/integrations/wiki_client.d.ts

@@ -0,0 +1,13 @@
+import { WikiDocEntry } from "../domain/wiki/types.js";
+export declare class WikiClient {
+    private cache;
+    constructor();
+    search(query: string, options?: {
+        category?: string;
+        realm?: string;
+        maxResults?: number;
+    }): Promise<WikiDocEntry[]>;
+    getSymbol(symbol: string): Promise<WikiDocEntry | null>;
+    private fetchLiveWiki;
+}
+//# sourceMappingURL=wiki_client.d.ts.map

package/dist/integrations/wiki_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki_client.d.ts","sourceRoot":"","sources":["../../src/integrations/wiki_client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAKvD,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAW;;IAMX,MAAM,CACjB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GACA,OAAO,CAAC,YAAY,EAAE,CAAC;IAyCb,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;YAgCtD,aAAa;CA0C5B"}

package/dist/integrations/wiki_client.js

@@ -0,0 +1,110 @@
+import { GMOD_OFFLINE_DOCS } from "../domain/wiki/offline_db.js";
+import { TTLCache } from "../core/cache.js";
+import { getConfig } from "../config/env.js";
+import { logger } from "../core/logger.js";
+export class WikiClient {
+    cache;
+    constructor() {
+        this.cache = new TTLCache(getConfig().WIKI_CACHE_DIR);
+    }
+    async search(query, options) {
+        const qLower = query.toLowerCase().trim();
+        const category = options?.category ?? "all";
+        const realm = options?.realm ?? "all";
+        const maxResults = options?.maxResults ?? 5;
+        // Filter offline database
+        const matches = GMOD_OFFLINE_DOCS.filter(doc => {
+            // Category filter
+            if (category !== "all" && doc.category !== category) {
+                return false;
+            }
+            // Realm filter
+            if (realm !== "all" && doc.realm !== realm && doc.realm !== "shared") {
+                return false;
+            }
+            // Keyword match
+            const symbolMatch = doc.symbol.toLowerCase().includes(qLower);
+            const nameMatch = doc.name.toLowerCase().includes(qLower);
+            const descMatch = doc.description.toLowerCase().includes(qLower);
+            return symbolMatch || nameMatch || descMatch;
+        });
+        // Score relevance: exact symbol matches first, then prefix, then fuzzy
+        matches.sort((a, b) => {
+            const aExact = a.symbol.toLowerCase() === qLower ? 100 : 0;
+            const bExact = b.symbol.toLowerCase() === qLower ? 100 : 0;
+            if (aExact !== bExact)
+                return bExact - aExact;
+            const aPrefix = a.symbol.toLowerCase().startsWith(qLower) ? 50 : 0;
+            const bPrefix = b.symbol.toLowerCase().startsWith(qLower) ? 50 : 0;
+            if (aPrefix !== bPrefix)
+                return bPrefix - aPrefix;
+            return a.symbol.localeCompare(b.symbol);
+        });
+        return matches.slice(0, maxResults);
+    }
+    async getSymbol(symbol) {
+        const normalized = symbol.trim().toLowerCase();
+        // Check offline DB first
+        const offlineMatch = GMOD_OFFLINE_DOCS.find(doc => doc.symbol.toLowerCase() === normalized || doc.name.toLowerCase() === normalized);
+        if (offlineMatch) {
+            return offlineMatch;
+        }
+        // Check cache
+        const cached = await this.cache.get(`symbol_${normalized}`);
+        if (cached) {
+            return cached;
+        }
+        // Try live fetch from Facepunch Wiki
+        try {
+            const live = await this.fetchLiveWiki(symbol);
+            if (live) {
+                // Cache for 24 hours
+                await this.cache.set(`symbol_${normalized}`, live, 24 * 60 * 60 * 1000);
+                return live;
+            }
+        }
+        catch (err) {
+            logger.warn(`Failed live wiki lookup for '${symbol}':`, { error: String(err) });
+        }
+        return null;
+    }
+    async fetchLiveWiki(symbol) {
+        const url = `https://wiki.facepunch.com/gmod/${encodeURIComponent(symbol)}`;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 4000);
+        try {
+            const response = await fetch(url, {
+                headers: { "User-Agent": "mcp-garry-codes/1.0" },
+                signal: controller.signal
+            });
+            if (!response.ok) {
+                return null;
+            }
+            const text = await response.text();
+            // Basic HTML extraction for wiki title & description
+            const titleMatch = text.match(/<h1[^>]*>([^<]+)<\/h1>/i);
+            const descMatch = text.match(/<div class="description"[^>]*>([\s\S]*?)<\/div>/i) ||
+                text.match(/<p>([\s\S]*?)<\/p>/i);
+            const title = titleMatch ? titleMatch[1].trim() : symbol;
+            const desc = descMatch ? descMatch[1].replace(/<[^>]+>/g, "").trim() : "Facepunch Wiki documentation.";
+            return {
+                symbol: title,
+                name: title.split(/[:.]/).pop() ?? title,
+                category: title.includes(":") ? "hooks" : "functions",
+                realm: text.includes("client") ? (text.includes("server") ? "shared" : "client") : "server",
+                description: desc,
+                signature: `${title}()`,
+                arguments: [],
+                returns: [],
+                examples: [],
+                notes: [],
+                warnings: [],
+                wiki_url: url
+            };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=wiki_client.js.map

package/dist/integrations/wiki_client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki_client.js","sourceRoot":"","sources":["../../src/integrations/wiki_client.ts"],"names":[],"mappings":"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"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,73 @@
+export declare const AUDIT_ADDON_PROMPT: {
+    name: string;
+    description: string;
+    arguments: {
+        name: string;
+        description: string;
+        required: boolean;
+    }[];
+    handler: (args?: Record<string, string>) => {
+        messages: {
+            role: "user";
+            content: {
+                type: "text";
+                text: string;
+            };
+        }[];
+    };
+};
+export declare const FIX_NET_EXPLOIT_PROMPT: {
+    name: string;
+    description: string;
+    arguments: {
+        name: string;
+        description: string;
+        required: boolean;
+    }[];
+    handler: (args?: Record<string, string>) => {
+        messages: {
+            role: "user";
+            content: {
+                type: "text";
+                text: string;
+            };
+        }[];
+    };
+};
+export declare const SCAFFOLD_SWEP_PROMPT: {
+    name: string;
+    description: string;
+    arguments: {
+        name: string;
+        description: string;
+        required: boolean;
+    }[];
+    handler: (args?: Record<string, string>) => {
+        messages: {
+            role: "user";
+            content: {
+                type: "text";
+                text: string;
+            };
+        }[];
+    };
+};
+export declare const BUILD_DERMA_MENU_PROMPT: {
+    name: string;
+    description: string;
+    arguments: {
+        name: string;
+        description: string;
+        required: boolean;
+    }[];
+    handler: (args?: Record<string, string>) => {
+        messages: {
+            role: "user";
+            content: {
+                type: "text";
+                text: string;
+            };
+        }[];
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB;;;;;;;;qBAUZ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;;CAmBxC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;qBAehB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;;CAmBxC,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;qBAed,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;;CAiBxC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;qBAUjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;;CAiBxC,CAAC"}

package/dist/prompts/index.js

@@ -0,0 +1,127 @@
+export const AUDIT_ADDON_PROMPT = {
+    name: "audit_addon",
+    description: "Comprehensive security and performance audit workflow for a Garry's Mod addon.",
+    arguments: [
+        {
+            name: "addon_dir",
+            description: "Path to addon directory to audit (defaults to workspace)",
+            required: false
+        }
+    ],
+    handler: (args) => {
+        const dir = args?.addon_dir ?? "the current workspace";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Please perform a comprehensive audit of ${dir}:
+1. Run 'audit_net_security' to check for unauthenticated net.Receive messages, SQL injections, and missing util.AddNetworkString.
+2. Run 'package_and_validate' to inspect addon.json, Steam Workshop compliance, and illegal file extensions.
+3. For all client/shared rendering scripts, run 'analyze_performance' to identify Zero-GC hot-path violations (allocations in HUDPaint/RenderScreenspaceEffects).
+4. Run 'lint_glua' across all files to detect realm mismatches and syntax errors.
+5. Provide a prioritized report of critical vulnerabilities and immediate fixes.`
+                    }
+                }
+            ]
+        };
+    }
+};
+export const FIX_NET_EXPLOIT_PROMPT = {
+    name: "fix_net_exploit",
+    description: "Guided repair workflow for net message vulnerabilities.",
+    arguments: [
+        {
+            name: "message_name",
+            description: "Vulnerable net message identifier to repair",
+            required: true
+        },
+        {
+            name: "file_path",
+            description: "File containing the vulnerable handler",
+            required: true
+        }
+    ],
+    handler: (args) => {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Repair the vulnerable net message '${args?.message_name}' in '${args?.file_path}':
+1. Read the code using your file view tool.
+2. Add server-side caller validation: check 'if not IsValid(ply) or not ply:IsAdmin() then return end'.
+3. Validate all payload inputs (lengths of net.ReadString, bounds on net.ReadUInt).
+4. Escape any SQL parameters using sql.SQLStr().
+5. Verify util.AddNetworkString('${args?.message_name}') is registered on the server.
+6. Verify fix using 'audit_net_security'.`
+                    }
+                }
+            ]
+        };
+    }
+};
+export const SCAFFOLD_SWEP_PROMPT = {
+    name: "scaffold_swep",
+    description: "Scaffold a production-grade, predicted Garry's Mod weapon.",
+    arguments: [
+        {
+            name: "name",
+            description: "Identifier for weapon (e.g. 'weapon_laser_smg')",
+            required: true
+        },
+        {
+            name: "category",
+            description: "Spawnmenu category",
+            required: false
+        }
+    ],
+    handler: (args) => {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Scaffold a custom SWEP named '${args?.name}' (Category: '${args?.category ?? "Custom"}'):
+1. Run 'scaffold_gmod_component' with component_type 'swep'.
+2. Ensure AddCSLuaFile() is properly placed.
+3. Configure primary fire with client-side prediction (effects/sounds) and server-side hit verification.
+4. Run 'lint_glua' on the resulting file to ensure zero syntax or realm errors.`
+                    }
+                }
+            ]
+        };
+    }
+};
+export const BUILD_DERMA_MENU_PROMPT = {
+    name: "build_derma_menu",
+    description: "Construct a responsive, DPI-scaled Garry's Mod Derma VGUI menu.",
+    arguments: [
+        {
+            name: "menu_name",
+            description: "Panel class name (e.g. 'DStoreMenu')",
+            required: true
+        }
+    ],
+    handler: (args) => {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Construct a custom Derma menu '${args?.menu_name}':
+1. Use 'scaffold_gmod_component' with component_type 'vgui_panel'.
+2. Use ScrW() and ScrH() ratios for responsive sizing.
+3. Ensure Paint functions use pre-allocated Color tables (Zero-GC rule).
+4. Register the panel via vgui.Register.`
+                    }
+                }
+            ]
+        };
+    }
+};
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,gFAAgF;IAC7F,SAAS,EAAE;QACT;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,0DAA0D;YACvE,QAAQ,EAAE,KAAK;SAChB;KACF;IACD,OAAO,EAAE,CAAC,IAA6B,EAAE,EAAE;QACzC,MAAM,GAAG,GAAG,IAAI,EAAE,SAAS,IAAI,uBAAuB,CAAC;QACvD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,2CAA2C,GAAG;;;;;iFAKiB;qBACtE;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,yDAAyD;IACtE,SAAS,EAAE;QACT;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,6CAA6C;YAC1D,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,wCAAwC;YACrD,QAAQ,EAAE,IAAI;SACf;KACF;IACD,OAAO,EAAE,CAAC,IAA6B,EAAE,EAAE;QACzC,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,sCAAsC,IAAI,EAAE,YAAY,SAAS,IAAI,EAAE,SAAS;;;;;mCAK/D,IAAI,EAAE,YAAY;0CACX;qBAC/B;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,4DAA4D;IACzE,SAAS,EAAE;QACT;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,iDAAiD;YAC9D,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,oBAAoB;YACjC,QAAQ,EAAE,KAAK;SAChB;KACF;IACD,OAAO,EAAE,CAAC,IAA6B,EAAE,EAAE;QACzC,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,iCAAiC,IAAI,EAAE,IAAI,iBAAiB,IAAI,EAAE,QAAQ,IAAI,QAAQ;;;;gFAIxB;qBACrE;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,iEAAiE;IAC9E,SAAS,EAAE;QACT;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,sCAAsC;YACnD,QAAQ,EAAE,IAAI;SACf;KACF;IACD,OAAO,EAAE,CAAC,IAA6B,EAAE,EAAE;QACzC,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,kCAAkC,IAAI,EAAE,SAAS;;;;yCAI1B;qBAC9B;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/resources/realms_resources.d.ts

@@ -0,0 +1,2 @@
+export declare function getRealmsMatrixContent(): string;
+//# sourceMappingURL=realms_resources.d.ts.map

package/dist/resources/realms_resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realms_resources.d.ts","sourceRoot":"","sources":["../../src/resources/realms_resources.ts"],"names":[],"mappings":"AAAA,wBAAgB,sBAAsB,IAAI,MAAM,CAgC/C"}

package/dist/resources/realms_resources.js

@@ -0,0 +1,30 @@
+export function getRealmsMatrixContent() {
+    return JSON.stringify({
+        description: "Garry's Mod Three-Realm Matrix and Rules",
+        realms: {
+            SERVER: {
+                authority: "Dedicated or P2P Host Server",
+                powers: ["Physics simulation", "Entity lifecycle authority", "sql.Query / MySQL", "Damage calculation", "util.AddNetworkString"],
+                restrictions: ["No VGUI/UI", "No LocalPlayer()", "No surface/draw rendering calls", "No Cam3D2D"],
+                distribution_requirement: "Must call AddCSLuaFile() to transmit client files to joining players."
+            },
+            CLIENT: {
+                authority: "Local Player Instance",
+                powers: ["HUDPaint (2D HUD)", "RenderScreenspaceEffects (Shaders)", "VGUI / Derma Windows", "LocalPlayer()", "Viewmodel / Camera positioning"],
+                restrictions: ["Zero authority over health, inventory, or physics", "Cannot call util.AddNetworkString", "Cannot call ply:Ban() / ply:Kick() directly"],
+                performance_mandate: "ZERO GC allocations in HUDPaint and render hooks (pre-allocate Color and Vector tables)."
+            },
+            SHARED: {
+                authority: "Executes simultaneously on both Server and Client",
+                scope: ["Weapons (lua/weapons/)", "Entities (lua/entities/)", "Predicted movement (SetupMove / Move)"],
+                prediction_rules: "Client predicts tracers/sounds; server validates bullet hit and ammo."
+            },
+            MENU: {
+                authority: "Main Menu Sandbox",
+                scope: ["Server browser", "Options menu", "Addon manager"],
+                restrictions: ["Runs outside any active map or game session."]
+            }
+        }
+    }, null, 2);
+}
+//# sourceMappingURL=realms_resources.js.map

package/dist/resources/realms_resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realms_resources.js","sourceRoot":"","sources":["../../src/resources/realms_resources.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,WAAW,EAAE,0CAA0C;QACvD,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,SAAS,EAAE,8BAA8B;gBACzC,MAAM,EAAE,CAAC,oBAAoB,EAAE,4BAA4B,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,uBAAuB,CAAC;gBAChI,YAAY,EAAE,CAAC,YAAY,EAAE,kBAAkB,EAAE,iCAAiC,EAAE,YAAY,CAAC;gBACjG,wBAAwB,EAAE,uEAAuE;aAClG;YACD,MAAM,EAAE;gBACN,SAAS,EAAE,uBAAuB;gBAClC,MAAM,EAAE,CAAC,mBAAmB,EAAE,oCAAoC,EAAE,sBAAsB,EAAE,eAAe,EAAE,gCAAgC,CAAC;gBAC9I,YAAY,EAAE,CAAC,mDAAmD,EAAE,mCAAmC,EAAE,6CAA6C,CAAC;gBACvJ,mBAAmB,EAAE,0FAA0F;aAChH;YACD,MAAM,EAAE;gBACN,SAAS,EAAE,mDAAmD;gBAC9D,KAAK,EAAE,CAAC,wBAAwB,EAAE,0BAA0B,EAAE,uCAAuC,CAAC;gBACtG,gBAAgB,EAAE,uEAAuE;aAC1F;YACD,IAAI,EAAE;gBACJ,SAAS,EAAE,mBAAmB;gBAC9B,KAAK,EAAE,CAAC,gBAAgB,EAAE,cAAc,EAAE,eAAe,CAAC;gBAC1D,YAAY,EAAE,CAAC,8CAA8C,CAAC;aAC/D;SACF;KACF,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC"}