@tmhs/godot-correctness-mcp 0.1.0

package/dist/godot/text-format.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Build the MCP server with all tools registered. Exported for offline tests. */
+export declare function createServer(): McpServer;

package/dist/index.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { pathToFileURL } from "node:url";
+import { registerSkillResources } from "./resources/skills.js";
+import { getServerInfo, readVersion, SERVER_NAME } from "./server-info.js";
+import { registerApiTools } from "./tools/api.js";
+import { registerLintTools } from "./tools/lint.js";
+import { registerSceneTools } from "./tools/scenes.js";
+/** Build the MCP server with all tools registered. Exported for offline tests. */
+export function createServer() {
+    const server = new McpServer({ name: SERVER_NAME, version: readVersion() });
+    server.tool("server_info", "Report this server's version, the pinned Godot versions it targets (4.4, 4.5), " +
+        "and which correctness pillars (GDScript lint, API symbols, scene/resource analysis) " +
+        "are currently available. Takes no arguments.", {}, async () => ({
+        content: [{ type: "text", text: JSON.stringify(getServerInfo(), null, 2) }],
+    }));
+    registerApiTools(server);
+    registerLintTools(server);
+    registerSceneTools(server);
+    registerSkillResources(server);
+    return server;
+}
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+// Run the stdio server only when executed directly, not when imported by tests.
+const invokedDirectly = process.argv[1] !== undefined &&
+    import.meta.url === pathToFileURL(process.argv[1]).href;
+if (invokedDirectly) {
+    main().catch((err) => {
+        console.error(err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,kFAAkF;AAClF,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;IAE5E,MAAM,CAAC,IAAI,CACT,aAAa,EACb,iFAAiF;QAC/E,sFAAsF;QACtF,8CAA8C,EAChD,EAAE,EACF,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAC5E,CAAC,CACH,CAAC;IAEF,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE/B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,gFAAgF;AAChF,MAAM,eAAe,GACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;IAC7B,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAE1D,IAAI,eAAe,EAAE,CAAC;IACpB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QAC5B,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lint/config.d.ts

@@ -0,0 +1,83 @@
+import { z } from "zod";
+import type { Severity } from "./types.js";
+export declare const CONFIG_FILENAME = "godot-correctness.config.json";
+declare const ruleConfigSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    severity: z.ZodOptional<z.ZodEnum<["error", "warning", "info"]>>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    enabled?: boolean | undefined;
+    severity?: "error" | "warning" | "info" | undefined;
+    options?: Record<string, unknown> | undefined;
+}, {
+    enabled?: boolean | undefined;
+    severity?: "error" | "warning" | "info" | undefined;
+    options?: Record<string, unknown> | undefined;
+}>;
+export type RuleConfig = z.infer<typeof ruleConfigSchema>;
+export declare const configSchema: z.ZodObject<{
+    /** Globs (relative to project root) of files to lint. */
+    include: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Globs to exclude. */
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Per-rule enable/disable, severity override, and options. */
+    rules: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        severity: z.ZodOptional<z.ZodEnum<["error", "warning", "info"]>>;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        enabled?: boolean | undefined;
+        severity?: "error" | "warning" | "info" | undefined;
+        options?: Record<string, unknown> | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        severity?: "error" | "warning" | "info" | undefined;
+        options?: Record<string, unknown> | undefined;
+    }>>>;
+    /** Directories of data-driven .tres registries to deep-validate (Phase 4). */
+    registryDirs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Property-name globs to treat as resource paths (Phase 4). */
+    pathPropertyPatterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    include?: string[] | undefined;
+    exclude?: string[] | undefined;
+    rules?: Record<string, {
+        enabled?: boolean | undefined;
+        severity?: "error" | "warning" | "info" | undefined;
+        options?: Record<string, unknown> | undefined;
+    }> | undefined;
+    registryDirs?: string[] | undefined;
+    pathPropertyPatterns?: string[] | undefined;
+}, {
+    include?: string[] | undefined;
+    exclude?: string[] | undefined;
+    rules?: Record<string, {
+        enabled?: boolean | undefined;
+        severity?: "error" | "warning" | "info" | undefined;
+        options?: Record<string, unknown> | undefined;
+    }> | undefined;
+    registryDirs?: string[] | undefined;
+    pathPropertyPatterns?: string[] | undefined;
+}>;
+export type GodotCorrectnessConfig = z.infer<typeof configSchema>;
+export declare const DEFAULT_INCLUDE: string[];
+export declare const DEFAULT_EXCLUDE: string[];
+export declare const DEFAULT_PATH_PROPERTY_PATTERNS: string[];
+/** A fully-resolved config with defaults applied. */
+export interface ResolvedConfig {
+    include: string[];
+    exclude: string[];
+    rules: Record<string, RuleConfig>;
+    registryDirs: string[];
+    pathPropertyPatterns: string[];
+}
+export declare function resolveConfig(raw?: GodotCorrectnessConfig): ResolvedConfig;
+/** Load and validate the config from a project root, or defaults when absent. */
+export declare function loadConfig(projectRoot: string): ResolvedConfig;
+/** Whether a rule is enabled (default: enabled unless explicitly disabled). */
+export declare function isRuleEnabled(config: ResolvedConfig, ruleId: string): boolean;
+/** Config severity override for a rule, if any. */
+export declare function severityOverride(config: ResolvedConfig, ruleId: string): Severity | undefined;
+/** Per-rule options from config. */
+export declare function ruleOptions(config: ResolvedConfig, ruleId: string): Record<string, unknown>;
+export {};

package/dist/lint/config.js

@@ -0,0 +1,55 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { z } from "zod";
+export const CONFIG_FILENAME = "godot-correctness.config.json";
+const severitySchema = z.enum(["error", "warning", "info"]);
+const ruleConfigSchema = z.object({
+    enabled: z.boolean().optional(),
+    severity: severitySchema.optional(),
+    options: z.record(z.string(), z.unknown()).optional(),
+});
+export const configSchema = z.object({
+    /** Globs (relative to project root) of files to lint. */
+    include: z.array(z.string()).optional(),
+    /** Globs to exclude. */
+    exclude: z.array(z.string()).optional(),
+    /** Per-rule enable/disable, severity override, and options. */
+    rules: z.record(z.string(), ruleConfigSchema).optional(),
+    /** Directories of data-driven .tres registries to deep-validate (Phase 4). */
+    registryDirs: z.array(z.string()).optional(),
+    /** Property-name globs to treat as resource paths (Phase 4). */
+    pathPropertyPatterns: z.array(z.string()).optional(),
+});
+export const DEFAULT_INCLUDE = ["**/*.gd"];
+export const DEFAULT_EXCLUDE = ["**/.godot/**"];
+export const DEFAULT_PATH_PROPERTY_PATTERNS = ["*_path", "*_scene", "*_texture", "*_resource"];
+export function resolveConfig(raw = {}) {
+    return {
+        include: raw.include ?? DEFAULT_INCLUDE,
+        exclude: raw.exclude ?? DEFAULT_EXCLUDE,
+        rules: raw.rules ?? {},
+        registryDirs: raw.registryDirs ?? [],
+        pathPropertyPatterns: raw.pathPropertyPatterns ?? DEFAULT_PATH_PROPERTY_PATTERNS,
+    };
+}
+/** Load and validate the config from a project root, or defaults when absent. */
+export function loadConfig(projectRoot) {
+    const path = join(projectRoot, CONFIG_FILENAME);
+    if (!existsSync(path))
+        return resolveConfig();
+    const raw = JSON.parse(readFileSync(path, "utf-8"));
+    return resolveConfig(configSchema.parse(raw));
+}
+/** Whether a rule is enabled (default: enabled unless explicitly disabled). */
+export function isRuleEnabled(config, ruleId) {
+    return config.rules[ruleId]?.enabled !== false;
+}
+/** Config severity override for a rule, if any. */
+export function severityOverride(config, ruleId) {
+    return config.rules[ruleId]?.severity;
+}
+/** Per-rule options from config. */
+export function ruleOptions(config, ruleId) {
+    return config.rules[ruleId]?.options ?? {};
+}
+//# sourceMappingURL=config.js.map

package/dist/lint/config.js.map

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

package/dist/lint/engine.d.ts

@@ -0,0 +1,7 @@
+import { type ResolvedConfig } from "./config.js";
+import type { Finding } from "./types.js";
+/**
+ * Lint one GDScript source string. `file` is used only for the reported path.
+ * Severity precedence: config override > per-finding severity > rule default.
+ */
+export declare function lintSource(file: string, source: string, config: ResolvedConfig): Promise<Finding[]>;

package/dist/lint/engine.js

@@ -0,0 +1,33 @@
+import { parseGDScript } from "../gdscript/parser.js";
+import { isRuleEnabled, ruleOptions, severityOverride, } from "./config.js";
+import { DEFAULT_RULES } from "./rules/index.js";
+/**
+ * Lint one GDScript source string. `file` is used only for the reported path.
+ * Severity precedence: config override > per-finding severity > rule default.
+ */
+export async function lintSource(file, source, config) {
+    const tree = await parseGDScript(source);
+    const root = tree.rootNode;
+    const findings = [];
+    for (const rule of DEFAULT_RULES) {
+        if (!isRuleEnabled(config, rule.id))
+            continue;
+        const raws = rule.check({ root, source, options: ruleOptions(config, rule.id) });
+        for (const raw of raws) {
+            const severity = severityOverride(config, rule.id) ?? raw.severity ?? rule.defaultSeverity;
+            const pos = raw.node.startPosition;
+            findings.push({
+                file,
+                line: pos.row + 1,
+                col: pos.column + 1,
+                ruleId: rule.id,
+                severity,
+                message: raw.message,
+                suggestion: raw.suggestion,
+            });
+        }
+    }
+    findings.sort((a, b) => a.line - b.line || a.col - b.col || a.ruleId.localeCompare(b.ruleId));
+    return findings;
+}
+//# sourceMappingURL=engine.js.map

package/dist/lint/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/lint/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,aAAa,EACb,WAAW,EACX,gBAAgB,GAEjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAY,EACZ,MAAc,EACd,MAAsB;IAEtB,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC3B,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;YAAE,SAAS;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACjF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,eAAe,CAAC;YAC3F,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC;YACnC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,IAAI,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC;gBACjB,GAAG,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC;gBACnB,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,QAAQ;gBACR,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,UAAU,EAAE,GAAG,CAAC,UAAU;aAC3B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9F,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/lint/project.d.ts

@@ -0,0 +1,12 @@
+import { type ResolvedConfig } from "./config.js";
+import type { Finding } from "./types.js";
+export interface ProjectLintResult {
+    root: string;
+    fileCount: number;
+    findings: Finding[];
+    errorCount: number;
+    warningCount: number;
+    infoCount: number;
+}
+/** Walk a project root, lint every included .gd file, and aggregate findings. */
+export declare function lintProject(root: string, config?: ResolvedConfig): Promise<ProjectLintResult>;

package/dist/lint/project.js

@@ -0,0 +1,49 @@
+import { readdirSync, readFileSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+import picomatch from "picomatch";
+import { loadConfig } from "./config.js";
+import { lintSource } from "./engine.js";
+function toPosix(p) {
+    return p.split(sep).join("/");
+}
+function collectFiles(root) {
+    const out = [];
+    const walkDir = (dir) => {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            if (entry.isDirectory()) {
+                if (entry.name === ".git")
+                    continue;
+                walkDir(join(dir, entry.name));
+            }
+            else if (entry.isFile()) {
+                out.push(join(dir, entry.name));
+            }
+        }
+    };
+    walkDir(root);
+    return out;
+}
+/** Walk a project root, lint every included .gd file, and aggregate findings. */
+export async function lintProject(root, config) {
+    const cfg = config ?? loadConfig(root);
+    const isIncluded = picomatch(cfg.include, { dot: true });
+    const isExcluded = picomatch(cfg.exclude, { dot: true });
+    const files = collectFiles(root)
+        .map((full) => ({ full, rel: toPosix(relative(root, full)) }))
+        .filter(({ rel }) => isIncluded(rel) && !isExcluded(rel));
+    const findings = [];
+    for (const { full, rel } of files) {
+        const source = readFileSync(full, "utf-8");
+        findings.push(...(await lintSource(rel, source, cfg)));
+    }
+    findings.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.col - b.col);
+    return {
+        root,
+        fileCount: files.length,
+        findings,
+        errorCount: findings.filter((f) => f.severity === "error").length,
+        warningCount: findings.filter((f) => f.severity === "warning").length,
+        infoCount: findings.filter((f) => f.severity === "info").length,
+    };
+}
+//# sourceMappingURL=project.js.map

package/dist/lint/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/lint/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,SAAS,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAuB,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,SAAS,OAAO,CAAC,CAAS;IACxB,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,CAAC,GAAW,EAAQ,EAAE;QACpC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC9D,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;oBAAE,SAAS;gBACpC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACjC,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,GAAG,CAAC;AACb,CAAC;AAWD,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,MAAuB;IAEvB,MAAM,GAAG,GAAG,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC;SAC7B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;SAC7D,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAE5D,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,KAAK,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,QAAQ,CAAC,IAAI,CACX,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAC3E,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,KAAK,CAAC,MAAM;QACvB,QAAQ;QACR,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM;QACjE,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM;QACrE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM;KAChE,CAAC;AACJ,CAAC"}

package/dist/lint/rules/await-misuse.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from "../types.js";
+/** Flags `await` applied to a literal value. Conservative: literals only. */
+export declare const awaitMisuse: Rule;

package/dist/lint/rules/await-misuse.js

@@ -0,0 +1,34 @@
+import { findAll } from "../../gdscript/ast.js";
+// Awaiting any of these is always wrong; awaiting an identifier/call is left
+// alone because it may resolve to a Signal or coroutine (unknowable statically).
+const LITERALS = new Set([
+    "integer",
+    "float",
+    "string",
+    "string_name",
+    "true",
+    "false",
+    "array",
+    "dictionary",
+]);
+/** Flags `await` applied to a literal value. Conservative: literals only. */
+export const awaitMisuse = {
+    id: "await-misuse",
+    description: "await applied to a literal value (expects a signal or coroutine).",
+    defaultSeverity: "warning",
+    check(ctx) {
+        const out = [];
+        for (const aw of findAll(ctx.root, "await_expression")) {
+            const operand = aw.namedChild(0);
+            if (operand && LITERALS.has(operand.type)) {
+                out.push({
+                    node: aw,
+                    message: "await on a literal value; await expects a signal or a coroutine.",
+                    suggestion: "Await a signal (e.g. `await timer.timeout`) or a coroutine call.",
+                });
+            }
+        }
+        return out;
+    },
+};
+//# sourceMappingURL=await-misuse.js.map

package/dist/lint/rules/await-misuse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"await-misuse.js","sourceRoot":"","sources":["../../../src/lint/rules/await-misuse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGhD,6EAA6E;AAC7E,iFAAiF;AACjF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC;IACvB,SAAS;IACT,OAAO;IACP,QAAQ;IACR,aAAa;IACb,MAAM;IACN,OAAO;IACP,OAAO;IACP,YAAY;CACb,CAAC,CAAC;AAEH,6EAA6E;AAC7E,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,EAAE,EAAE,cAAc;IAClB,WAAW,EAAE,mEAAmE;IAChF,eAAe,EAAE,SAAS;IAC1B,KAAK,CAAC,GAAG;QACP,MAAM,GAAG,GAAG,EAAE,CAAC;QACf,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,kBAAkB,CAAC,EAAE,CAAC;YACvD,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACjC,IAAI,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1C,GAAG,CAAC,IAAI,CAAC;oBACP,IAAI,EAAE,EAAE;oBACR,OAAO,EAAE,kEAAkE;oBAC3E,UAAU,EAAE,kEAAkE;iBAC/E,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF,CAAC"}

package/dist/lint/rules/connect-without-disconnect.d.ts

@@ -0,0 +1,7 @@
+import type { Rule } from "../types.js";
+/**
+ * Flags connect() in _ready() with no CONNECT_ONE_SHOT flag and no disconnect()
+ * anywhere in the file. Conservative: if the file disconnects at all, or uses a
+ * one-shot flag, it stays silent to avoid false positives.
+ */
+export declare const connectWithoutDisconnect: Rule;

package/dist/lint/rules/connect-without-disconnect.js

@@ -0,0 +1,38 @@
+import { calleeName, fieldText, findAll, text, walk } from "../../gdscript/ast.js";
+/**
+ * Flags connect() in _ready() with no CONNECT_ONE_SHOT flag and no disconnect()
+ * anywhere in the file. Conservative: if the file disconnects at all, or uses a
+ * one-shot flag, it stays silent to avoid false positives.
+ */
+export const connectWithoutDisconnect = {
+    id: "connect-without-disconnect",
+    description: "Signal connected in _ready() with no matching disconnect or one-shot flag.",
+    defaultSeverity: "info",
+    check(ctx) {
+        const hasDisconnect = [...walk(ctx.root)].some((n) => (n.type === "call" || n.type === "attribute_call") &&
+            calleeName(n, ctx.source) === "disconnect");
+        if (hasDisconnect)
+            return [];
+        const out = [];
+        for (const fn of findAll(ctx.root, "function_definition")) {
+            if (fieldText(fn, "name", ctx.source) !== "_ready")
+                continue;
+            for (const n of walk(fn)) {
+                if (n.type !== "call" && n.type !== "attribute_call")
+                    continue;
+                if (calleeName(n, ctx.source) !== "connect")
+                    continue;
+                const args = n.childForFieldName("arguments");
+                if (args && text(args, ctx.source).includes("CONNECT_ONE_SHOT"))
+                    continue;
+                out.push({
+                    node: n,
+                    message: "Signal connected in _ready() with no disconnect() or CONNECT_ONE_SHOT; risks double-connect or a dangling reference.",
+                    suggestion: "Disconnect in _exit_tree(), pass CONNECT_ONE_SHOT, or guard with is_connected().",
+                });
+            }
+        }
+        return out;
+    },
+};
+//# sourceMappingURL=connect-without-disconnect.js.map

package/dist/lint/rules/connect-without-disconnect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-without-disconnect.js","sourceRoot":"","sources":["../../../src/lint/rules/connect-without-disconnect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAGnF;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAS;IAC5C,EAAE,EAAE,4BAA4B;IAChC,WAAW,EAAE,4EAA4E;IACzF,eAAe,EAAE,MAAM;IACvB,KAAK,CAAC,GAAG;QACP,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAC5C,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC;YAClD,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,YAAY,CAC7C,CAAC;QACF,IAAI,aAAa;YAAE,OAAO,EAAE,CAAC;QAE7B,MAAM,GAAG,GAAG,EAAE,CAAC;QACf,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,qBAAqB,CAAC,EAAE,CAAC;YAC1D,IAAI,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ;gBAAE,SAAS;YAC7D,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB;oBAAE,SAAS;gBAC/D,IAAI,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,SAAS;oBAAE,SAAS;gBACtD,MAAM,IAAI,GAAG,CAAC,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;gBAC9C,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;oBAAE,SAAS;gBAC1E,GAAG,CAAC,IAAI,CAAC;oBACP,IAAI,EAAE,CAAC;oBACP,OAAO,EAAE,sHAAsH;oBAC/H,UAAU,EAAE,kFAAkF;iBAC/F,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF,CAAC"}

package/dist/lint/rules/delta-misuse.d.ts

@@ -0,0 +1,7 @@
+import type { Rule } from "../types.js";
+/**
+ * error: `velocity` scaled by delta in a function that calls move_and_slide()
+ * (double-scales, since move_and_slide already applies frame timing).
+ * info: position/rotation mutated in _process without any delta factor.
+ */
+export declare const deltaMisuse: Rule;

package/dist/lint/rules/delta-misuse.js

@@ -0,0 +1,78 @@
+import { containsIdentifier, fieldText, findAll, functionCalls, operatorOf, text, walk, } from "../../gdscript/ast.js";
+const PROCESS_FNS = new Set(["_process", "_physics_process"]);
+/** Base identifier of an assignment target: `velocity` or `x` in `self.x`/`x.y`. */
+function targetName(left, source) {
+    if (left.type === "identifier")
+        return text(left, source);
+    if (left.type === "attribute") {
+        // `self.velocity` -> last identifier; `position.x` -> base identifier.
+        const first = left.namedChild(0);
+        if (first && first.type === "identifier" && text(first, source) === "self") {
+            const second = left.namedChild(1);
+            return second && second.type === "identifier" ? text(second, source) : null;
+        }
+        return first && first.type === "identifier" ? text(first, source) : null;
+    }
+    return null;
+}
+/** RHS contains a `*` with `delta` as a direct operand (either order). */
+function multipliesByDelta(node, source) {
+    for (const b of walk(node)) {
+        if (b.type !== "binary_operator" || operatorOf(b, source) !== "*")
+            continue;
+        const l = b.childForFieldName("left");
+        const r = b.childForFieldName("right");
+        const isDelta = (n) => !!n && n.type === "identifier" && text(n, source) === "delta";
+        if (isDelta(l) || isDelta(r))
+            return true;
+    }
+    return false;
+}
+/**
+ * error: `velocity` scaled by delta in a function that calls move_and_slide()
+ * (double-scales, since move_and_slide already applies frame timing).
+ * info: position/rotation mutated in _process without any delta factor.
+ */
+export const deltaMisuse = {
+    id: "delta-misuse",
+    description: "velocity * delta into move_and_slide(); or delta-less position/rotation change in _process.",
+    defaultSeverity: "error",
+    check(ctx) {
+        const out = [];
+        for (const fn of findAll(ctx.root, "function_definition")) {
+            const fname = fieldText(fn, "name", ctx.source);
+            const callsMove = functionCalls(fn, "move_and_slide", ctx.source);
+            for (const stmt of walk(fn)) {
+                if (stmt.type !== "assignment" && stmt.type !== "augmented_assignment")
+                    continue;
+                const left = stmt.childForFieldName("left");
+                const right = stmt.childForFieldName("right");
+                if (!left || !right)
+                    continue;
+                const target = targetName(left, ctx.source);
+                if (callsMove && target === "velocity" && multipliesByDelta(right, ctx.source)) {
+                    out.push({
+                        node: stmt,
+                        severity: "error",
+                        message: "velocity multiplied by delta before move_and_slide(); move_and_slide() already applies frame timing, so this double-scales movement.",
+                        suggestion: "Set velocity in units per second (no * delta); move_and_slide() handles delta.",
+                    });
+                    continue;
+                }
+                if (fname &&
+                    PROCESS_FNS.has(fname) &&
+                    (target === "position" || target === "rotation") &&
+                    !containsIdentifier(right, "delta", ctx.source)) {
+                    out.push({
+                        node: stmt,
+                        severity: "info",
+                        message: `${fname}() changes ${target} without a delta factor; motion becomes frame-rate dependent.`,
+                        suggestion: "Scale the change by delta for frame-rate independence.",
+                    });
+                }
+            }
+        }
+        return out;
+    },
+};
+//# sourceMappingURL=delta-misuse.js.map

package/dist/lint/rules/delta-misuse.js.map

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

package/dist/lint/rules/float-grid-equality.d.ts

@@ -0,0 +1,6 @@
+import type { Rule } from "../types.js";
+/**
+ * Flags `==` / `!=` where one operand is a float literal or Vector constructor.
+ * Info-only and false-positive prone by nature; easy to disable per project.
+ */
+export declare const floatGridEquality: Rule;

package/dist/lint/rules/float-grid-equality.js

@@ -0,0 +1,39 @@
+import { calleeName, findAll, operatorOf } from "../../gdscript/ast.js";
+const VEC_CTORS = new Set(["Vector2", "Vector3", "Vector4"]);
+function isFloatOrVector(node, source) {
+    if (!node)
+        return false;
+    if (node.type === "float")
+        return true;
+    if (node.type === "call" && VEC_CTORS.has(calleeName(node, source) ?? ""))
+        return true;
+    return false;
+}
+/**
+ * Flags `==` / `!=` where one operand is a float literal or Vector constructor.
+ * Info-only and false-positive prone by nature; easy to disable per project.
+ */
+export const floatGridEquality = {
+    id: "float-grid-equality",
+    description: "Direct == / != on float or Vector values (floating-point precision).",
+    defaultSeverity: "info",
+    check(ctx) {
+        const out = [];
+        for (const b of findAll(ctx.root, "binary_operator")) {
+            const op = operatorOf(b, ctx.source);
+            if (op !== "==" && op !== "!=")
+                continue;
+            const l = b.childForFieldName("left");
+            const r = b.childForFieldName("right");
+            if (isFloatOrVector(l, ctx.source) || isFloatOrVector(r, ctx.source)) {
+                out.push({
+                    node: b,
+                    message: "Direct equality on float/Vector values is unreliable due to floating-point precision.",
+                    suggestion: "Use is_equal_approx() / is_zero_approx() (or Vector2.is_equal_approx()).",
+                });
+            }
+        }
+        return out;
+    },
+};
+//# sourceMappingURL=float-grid-equality.js.map

package/dist/lint/rules/float-grid-equality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"float-grid-equality.js","sourceRoot":"","sources":["../../../src/lint/rules/float-grid-equality.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAE7D,SAAS,eAAe,CAAC,IAAiB,EAAE,MAAc;IACxD,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACvF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,EAAE,EAAE,qBAAqB;IACzB,WAAW,EAAE,sEAAsE;IACnF,eAAe,EAAE,MAAM;IACvB,KAAK,CAAC,GAAG;QACP,MAAM,GAAG,GAAG,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,CAAC;YACrD,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI;gBAAE,SAAS;YACzC,MAAM,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,eAAe,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrE,GAAG,CAAC,IAAI,CAAC;oBACP,IAAI,EAAE,CAAC;oBACP,OAAO,EAAE,uFAAuF;oBAChG,UAAU,EAAE,0EAA0E;iBACvF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF,CAAC"}

package/dist/lint/rules/get-node-in-process.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from "../types.js";
+/** Flags $ / get_node() lookups inside _process / _physics_process. */
+export declare const getNodeInProcess: Rule;

package/dist/lint/rules/get-node-in-process.js

@@ -0,0 +1,31 @@
+import { calleeName, fieldText, findAll, walk } from "../../gdscript/ast.js";
+const PROCESS_FNS = new Set(["_process", "_physics_process"]);
+const NODE_GETTERS = new Set(["get_node", "get_node_or_null"]);
+/** Flags $ / get_node() lookups inside _process / _physics_process. */
+export const getNodeInProcess = {
+    id: "get-node-in-process",
+    description: "Node lookups ($ or get_node()) inside _process/_physics_process run every frame.",
+    defaultSeverity: "warning",
+    check(ctx) {
+        const out = [];
+        for (const fn of findAll(ctx.root, "function_definition")) {
+            const name = fieldText(fn, "name", ctx.source);
+            if (!name || !PROCESS_FNS.has(name))
+                continue;
+            for (const n of walk(fn)) {
+                const isDollar = n.type === "get_node";
+                const isGetterCall = (n.type === "call" || n.type === "attribute_call") &&
+                    NODE_GETTERS.has(calleeName(n, ctx.source) ?? "");
+                if (isDollar || isGetterCall) {
+                    out.push({
+                        node: n,
+                        message: `Node lookup inside ${name}() runs every frame.`,
+                        suggestion: "Cache the node once in an @onready var and reference that instead.",
+                    });
+                }
+            }
+        }
+        return out;
+    },
+};
+//# sourceMappingURL=get-node-in-process.js.map

package/dist/lint/rules/get-node-in-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-node-in-process.js","sourceRoot":"","sources":["../../../src/lint/rules/get-node-in-process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAG7E,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAC9D,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAE/D,uEAAuE;AACvE,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,EAAE,EAAE,qBAAqB;IACzB,WAAW,EAAE,kFAAkF;IAC/F,eAAe,EAAE,SAAS;IAC1B,KAAK,CAAC,GAAG;QACP,MAAM,GAAG,GAAG,EAAE,CAAC;QACf,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,qBAAqB,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YAC/C,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC9C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBACzB,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC;gBACvC,MAAM,YAAY,GAChB,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC;oBAClD,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBACpD,IAAI,QAAQ,IAAI,YAAY,EAAE,CAAC;oBAC7B,GAAG,CAAC,IAAI,CAAC;wBACP,IAAI,EAAE,CAAC;wBACP,OAAO,EAAE,sBAAsB,IAAI,sBAAsB;wBACzD,UAAU,EAAE,oEAAoE;qBACjF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF,CAAC"}

package/dist/lint/rules/index.d.ts

@@ -0,0 +1,4 @@
+import type { Rule } from "../types.js";
+/** The default GDScript ruleset, in stable reporting order. */
+export declare const DEFAULT_RULES: Rule[];
+export declare const RULES_BY_ID: Map<string, Rule>;