@godot-mcp/control-plane 0.0.0 → 0.1.0

package/dist/project/projectMutationService.d.ts

@@ -0,0 +1,40 @@
+import { type ProjectMutationResult, type ProjectOperationInput } from "@godot-mcp/protocol";
+type ProjectMutationInput = Extract<ProjectOperationInput, {
+    operation: "settings_apply" | "plugin_set";
+}>;
+export declare class ProjectMutationJournal {
+    private readonly path;
+    private readonly latest;
+    private tail;
+    static open(path: string): Promise<ProjectMutationJournal>;
+    private constructor();
+    reconcile(key: string, requestDigest: string): {
+        state: "missing" | "unknown";
+    } | {
+        state: "completed";
+        result: ProjectMutationResult;
+    };
+    begin(key: string, requestDigest: string): Promise<void>;
+    complete(key: string, requestDigest: string, result: ProjectMutationResult): Promise<void>;
+    private append;
+    private remember;
+}
+export interface ProjectMutationBridge {
+    request(method: "project.operation", params: unknown, options: {
+        timeoutMs: number;
+        maxResponseBytes: number;
+        correlationId: string;
+    }): Promise<{
+        data: unknown;
+    }>;
+}
+export declare class ProjectMutationService {
+    private readonly bridge;
+    private readonly journal;
+    private tail;
+    constructor(bridge: () => ProjectMutationBridge | null, journal: ProjectMutationJournal);
+    execute(rawInput: ProjectMutationInput, correlationId: string): Promise<ProjectMutationResult>;
+    private executeExclusive;
+}
+export {};
+//# sourceMappingURL=projectMutationService.d.ts.map

package/dist/project/projectMutationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectMutationService.d.ts","sourceRoot":"","sources":["../../src/project/projectMutationService.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAM7B,KAAK,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,EAAE;IAAE,SAAS,EAAE,gBAAgB,GAAG,YAAY,CAAA;CAAE,CAAC,CAAC;AAgC3G,qBAAa,sBAAsB;IAuBb,OAAO,CAAC,QAAQ,CAAC,IAAI;IAtBzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,IAAI,CAAuC;WAEtC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAmBhE,OAAO;IAEP,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,SAAS,GAAG,SAAS,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,qBAAqB,CAAA;KAAE;IAOjI,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;YAIlF,MAAM;IASpB,OAAO,CAAC,QAAQ;CAKjB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACpK;AAED,qBAAa,sBAAsB;IAGrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAsC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFjG,OAAO,CAAC,IAAI,CAAoC;gBAEnB,MAAM,EAAE,MAAM,qBAAqB,GAAG,IAAI,EAAmB,OAAO,EAAE,sBAAsB;IAEnH,OAAO,CAAC,QAAQ,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;YAMtF,gBAAgB;CAqB/B"}

package/dist/project/projectMutationService.js

@@ -0,0 +1,145 @@
+import { createHash, randomUUID } from "node:crypto";
+import { ProjectMutationResultSchema, ProjectOperationInputSchema, canonicalFloat64Le, canonicalJson, } from "@godot-mcp/protocol";
+import { z } from "zod";
+import { GodotMcpException } from "../errors.js";
+import { appendSecureJournal, readSecureJournal } from "./secureJournalFile.js";
+const Sha256Schema = z.string().regex(/^[a-f0-9]{64}$/);
+const MAX_JOURNAL_BYTES = 4 * 1024 * 1024;
+const RecordSchema = z.discriminatedUnion("state", [
+    z.object({ schemaVersion: z.literal(1), state: z.literal("started"), keySha256: Sha256Schema, requestDigest: Sha256Schema, recordedAt: z.string().datetime() }).strict(),
+    z.object({ schemaVersion: z.literal(1), state: z.literal("completed"), keySha256: Sha256Schema, requestDigest: Sha256Schema, recordedAt: z.string().datetime(), result: ProjectMutationResultSchema }).strict(),
+]);
+function sha256(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+function settingValueSha256(value) {
+    const canonical = typeof value === "number" && !Number.isSafeInteger(value)
+        ? canonicalJson({ $godotMcpFloat64Le: canonicalFloat64Le(value) })
+        : canonicalJson(value);
+    return sha256(canonical);
+}
+function conflict(message, partialEffects = false) {
+    return new GodotMcpException({
+        code: "CONFLICT",
+        message,
+        retryable: false,
+        correlationId: randomUUID(),
+        partialEffects,
+        rollback: partialEffects ? "not_attempted" : "not_needed",
+    });
+}
+export class ProjectMutationJournal {
+    path;
+    latest = new Map();
+    tail = Promise.resolve();
+    static async open(path) {
+        const journal = new ProjectMutationJournal(path);
+        try {
+            const text = await readSecureJournal(path, MAX_JOURNAL_BYTES);
+            if (text === null)
+                return journal;
+            for (const [index, line] of text.split("\n").entries()) {
+                if (!line)
+                    continue;
+                try {
+                    journal.remember(RecordSchema.parse(JSON.parse(line)));
+                }
+                catch {
+                    throw conflict(`Project mutation journal record ${index + 1} is malformed`);
+                }
+            }
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+        return journal;
+    }
+    constructor(path) {
+        this.path = path;
+    }
+    reconcile(key, requestDigest) {
+        const record = this.latest.get(sha256(key));
+        if (!record)
+            return { state: "missing" };
+        if (record.requestDigest !== requestDigest)
+            throw conflict("Idempotency key was already used for another project mutation");
+        return record.state === "completed" ? { state: "completed", result: record.result } : { state: "unknown" };
+    }
+    async begin(key, requestDigest) {
+        await this.append({ schemaVersion: 1, state: "started", keySha256: sha256(key), requestDigest, recordedAt: new Date().toISOString() });
+    }
+    async complete(key, requestDigest, result) {
+        await this.append({ schemaVersion: 1, state: "completed", keySha256: sha256(key), requestDigest, recordedAt: new Date().toISOString(), result });
+    }
+    async append(record) {
+        const write = this.tail.then(async () => {
+            await appendSecureJournal(this.path, `${JSON.stringify(record)}\n`);
+            this.remember(record);
+        });
+        this.tail = write.catch(() => undefined);
+        await write;
+    }
+    remember(record) {
+        this.latest.delete(record.keySha256);
+        this.latest.set(record.keySha256, record);
+        while (this.latest.size > 256)
+            this.latest.delete(this.latest.keys().next().value);
+    }
+}
+export class ProjectMutationService {
+    bridge;
+    journal;
+    tail = Promise.resolve();
+    constructor(bridge, journal) {
+        this.bridge = bridge;
+        this.journal = journal;
+    }
+    async execute(rawInput, correlationId) {
+        const run = this.tail.then(() => this.executeExclusive(rawInput, correlationId));
+        this.tail = run.then(() => undefined, () => undefined);
+        return run;
+    }
+    async executeExclusive(rawInput, correlationId) {
+        const parsed = ProjectOperationInputSchema.parse(rawInput);
+        if (parsed.operation !== "settings_apply" && parsed.operation !== "plugin_set")
+            throw conflict("Operation is not a project mutation");
+        const input = parsed;
+        const requestDigest = sha256(JSON.stringify(input));
+        const reconciliation = this.journal.reconcile(input.idempotencyKey, requestDigest);
+        if (reconciliation.state === "completed")
+            return reconciliation.result;
+        if (reconciliation.state === "unknown")
+            throw conflict("A prior project mutation has an unknown outcome; reconcile project state before using a new key", true);
+        const bridge = this.bridge();
+        if (!bridge) {
+            throw new GodotMcpException({ code: "NOT_ATTACHED", message: "Godot editor addon is not attached", retryable: true, correlationId, partialEffects: false, rollback: "not_needed" });
+        }
+        await this.journal.begin(input.idempotencyKey, requestDigest);
+        const response = await bridge.request("project.operation", input, { timeoutMs: 30_000, maxResponseBytes: 256 * 1024, correlationId });
+        const result = ProjectMutationResultSchema.parse(response.data);
+        if (!receiptMatchesRequest(input, result)) {
+            throw conflict("Godot returned a mismatched project mutation receipt", true);
+        }
+        await this.journal.complete(input.idempotencyKey, requestDigest, result);
+        return result;
+    }
+}
+function receiptMatchesRequest(input, result) {
+    if (result.operation !== input.operation)
+        return false;
+    if (result.operation === "plugin_set" && input.operation === "plugin_set") {
+        return result.pluginSha256 === sha256(input.pluginPath) && result.enabled === input.enabled;
+    }
+    if (result.operation !== "settings_apply" || input.operation !== "settings_apply" || result.changes.length !== input.changes.length)
+        return false;
+    return result.changes.every((receipt, index) => {
+        const change = input.changes[index];
+        if (!change)
+            return false;
+        if (receipt.settingNameSha256 !== sha256(change.name) || receipt.postimageSha256 !== settingValueSha256(change.value))
+            return false;
+        return change.expectedValue === undefined || receipt.preimageSha256 === settingValueSha256(change.expectedValue);
+    });
+}
+//# sourceMappingURL=projectMutationService.js.map

package/dist/project/projectMutationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectMutationService.js","sourceRoot":"","sources":["../../src/project/projectMutationService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,kBAAkB,EAClB,aAAa,GAGd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhF,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;AACxD,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1C,MAAM,YAAY,GAAG,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE;IACjD,CAAC,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACxK,CAAC,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC,CAAC,MAAM,EAAE;CAChN,CAAC,CAAC;AAGH,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAuC;IACjE,MAAM,SAAS,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QACzE,CAAC,CAAC,aAAa,CAAC,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAClE,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe,EAAE,cAAc,GAAG,KAAK;IACvD,OAAO,IAAI,iBAAiB,CAAC;QAC3B,IAAI,EAAE,UAAU;QAChB,OAAO;QACP,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,UAAU,EAAE;QAC3B,cAAc;QACd,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY;KAC1D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,OAAO,sBAAsB;IAuBI;IAtBpB,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IACnD,IAAI,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEnD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY;QAC5B,MAAM,OAAO,GAAG,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;YAC9D,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO,OAAO,CAAC;YAClC,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;gBACvD,IAAI,CAAC,IAAI;oBAAE,SAAS;gBACpB,IAAI,CAAC;oBACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC,CAAC,CAAC;gBACpE,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,QAAQ,CAAC,mCAAmC,KAAK,GAAG,CAAC,eAAe,CAAC,CAAC;gBAC9E,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;QACtE,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,YAAqC,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAErD,SAAS,CAAC,GAAW,EAAE,aAAqB;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC,aAAa,KAAK,aAAa;YAAE,MAAM,QAAQ,CAAC,+DAA+D,CAAC,CAAC;QAC5H,OAAO,MAAM,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAC7G,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,aAAqB;QAC5C,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACzI,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,aAAqB,EAAE,MAA6B;QAC9E,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACnJ,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,MAAqB;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YACtC,MAAM,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACpE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,KAAK,CAAC;IACd,CAAC;IAEO,QAAQ,CAAC,MAAqB;QACpC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,GAAG;YAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAe,CAAC,CAAC;IAC/F,CAAC;CACF;AAMD,MAAM,OAAO,sBAAsB;IAGJ;IAA6D;IAFlF,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEhD,YAA6B,MAA0C,EAAmB,OAA+B;QAA5F,WAAM,GAAN,MAAM,CAAoC;QAAmB,YAAO,GAAP,OAAO,CAAwB;IAAG,CAAC;IAE7H,KAAK,CAAC,OAAO,CAAC,QAA8B,EAAE,aAAqB;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACvD,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,QAA8B,EAAE,aAAqB;QAClF,MAAM,MAAM,GAAG,2BAA2B,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3D,IAAI,MAAM,CAAC,SAAS,KAAK,gBAAgB,IAAI,MAAM,CAAC,SAAS,KAAK,YAAY;YAAE,MAAM,QAAQ,CAAC,qCAAqC,CAAC,CAAC;QACtI,MAAM,KAAK,GAAG,MAAM,CAAC;QACrB,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACpD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;QACnF,IAAI,cAAc,CAAC,KAAK,KAAK,WAAW;YAAE,OAAO,cAAc,CAAC,MAAM,CAAC;QACvE,IAAI,cAAc,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,QAAQ,CAAC,iGAAiG,EAAE,IAAI,CAAC,CAAC;QAChK,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,iBAAiB,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,oCAAoC,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;QACtL,CAAC;QACD,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,GAAG,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QACtI,MAAM,MAAM,GAAG,2BAA2B,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;YAC1C,MAAM,QAAQ,CAAC,sDAAsD,EAAE,IAAI,CAAC,CAAC;QAC/E,CAAC;QACD,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;QACzE,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,SAAS,qBAAqB,CAAC,KAA2B,EAAE,MAA6B;IACvF,IAAI,MAAM,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACvD,IAAI,MAAM,CAAC,SAAS,KAAK,YAAY,IAAI,KAAK,CAAC,SAAS,KAAK,YAAY,EAAE,CAAC;QAC1E,OAAO,MAAM,CAAC,YAAY,KAAK,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC;IAC9F,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,gBAAgB,IAAI,KAAK,CAAC,SAAS,KAAK,gBAAgB,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAClJ,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC1B,IAAI,OAAO,CAAC,iBAAiB,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,eAAe,KAAK,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACpI,OAAO,MAAM,CAAC,aAAa,KAAK,SAAS,IAAI,OAAO,CAAC,cAAc,KAAK,kBAAkB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACnH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/project/projectPreflight.d.ts

@@ -0,0 +1,7 @@
+export declare function assertBuildSolutionsPreflight(projectRoot: string): Promise<void>;
+export declare function assertExportPreflight(projectRoot: string, presetName: string): Promise<void>;
+export declare function projectOperationPreflight(projectRoot: string, input: {
+    operation: string;
+    preset?: string;
+}): Promise<void>;
+//# sourceMappingURL=projectPreflight.d.ts.map

package/dist/project/projectPreflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectPreflight.d.ts","sourceRoot":"","sources":["../../src/project/projectPreflight.ts"],"names":[],"mappings":"AAkBA,wBAAsB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKtF;AAED,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAelG;AAED,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjI"}

package/dist/project/projectPreflight.js

@@ -0,0 +1,50 @@
+import { lstat, readdir, readFile, realpath } from "node:fs/promises";
+import { resolve, sep } from "node:path";
+import { GodotMcpException } from "../errors.js";
+function denied(message) {
+    return new GodotMcpException({ code: "CONFLICT", message, retryable: false, correlationId: "project-preflight", partialEffects: false, rollback: "not_needed" });
+}
+async function containedRegularFile(projectRoot, relativePath) {
+    const root = await realpath(projectRoot);
+    const path = resolve(root, relativePath);
+    if (!path.startsWith(`${root}${sep}`))
+        throw denied("Project preflight path escaped the project");
+    const metadata = await lstat(path);
+    if (metadata.isSymbolicLink() || !metadata.isFile())
+        throw denied("Project preflight input is not a regular file");
+    return path;
+}
+export async function assertBuildSolutionsPreflight(projectRoot) {
+    const entries = await readdir(projectRoot, { withFileTypes: true });
+    if (!entries.some((entry) => entry.isFile() && (entry.name.endsWith(".sln") || entry.name.endsWith(".csproj")))) {
+        throw denied("Build solutions requires a top-level .sln or .csproj file");
+    }
+}
+export async function assertExportPreflight(projectRoot, presetName) {
+    let text;
+    try {
+        text = await readFile(await containedRegularFile(projectRoot, "export_presets.cfg"), "utf8");
+    }
+    catch (error) {
+        if (error instanceof GodotMcpException)
+            throw error;
+        throw denied("Export requires export_presets.cfg");
+    }
+    if (Buffer.byteLength(text) > 1024 * 1024)
+        throw denied("Export preset file exceeds 1 MiB");
+    const sections = text.split(/^\[preset\.\d+\]\s*$/mu).slice(1);
+    const section = sections.find((candidate) => candidate.match(/^name="(.*)"$/mu)?.[1] === presetName);
+    if (!section)
+        throw denied("Selected export preset does not exist");
+    const excludes = section.match(/^exclude_filter="(.*)"$/mu)?.[1]?.split(",").map((value) => value.trim()) ?? [];
+    if (!excludes.includes("addons/godot_mcp/**")) {
+        throw denied("Export preset must exclude addons/godot_mcp/**");
+    }
+}
+export async function projectOperationPreflight(projectRoot, input) {
+    if (input.operation === "build_start")
+        await assertBuildSolutionsPreflight(projectRoot);
+    if (input.operation === "export_start")
+        await assertExportPreflight(projectRoot, input.preset ?? "");
+}
+//# sourceMappingURL=projectPreflight.js.map

package/dist/project/projectPreflight.js.map

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

package/dist/project/projectProcess.d.ts

@@ -0,0 +1,40 @@
+import { type OwnedRuntimeProcess } from "../runtime/runtimeProcess.js";
+export type ProjectProcessInput = {
+    operation: "import";
+    projectRoot: string;
+} | {
+    operation: "run";
+    projectRoot: string;
+    headless: boolean;
+    scenePath?: string;
+} | {
+    operation: "build";
+    projectRoot: string;
+} | {
+    operation: "export";
+    projectRoot: string;
+    artifactRoot: string;
+    mode: "release" | "debug" | "pack";
+    preset: string;
+    outputPath: string;
+};
+export declare function projectGodotArguments(input: ProjectProcessInput): string[];
+export declare function scrubProjectEnvironment(environment: NodeJS.ProcessEnv): Record<string, string>;
+export declare function projectProcessFingerprint(pid: number): Promise<string>;
+export declare class OwnedProjectProcess implements OwnedRuntimeProcess {
+    private readonly child;
+    readonly pid: number;
+    readonly fingerprint: string;
+    private stopPromise;
+    private output;
+    private constructor();
+    static launch(input: ProjectProcessInput & {
+        godotBin: string;
+        environment?: NodeJS.ProcessEnv;
+    }): Promise<OwnedProjectProcess>;
+    diagnostics(): string;
+    wait(): Promise<number>;
+    stop(graceMs?: number): Promise<void>;
+}
+export declare function recoverOwnedProjectProcess(pid: number, fingerprint: string): Promise<"stopped" | "missing" | "ambiguous">;
+//# sourceMappingURL=projectProcess.d.ts.map

package/dist/project/projectProcess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectProcess.d.ts","sourceRoot":"","sources":["../../src/project/projectProcess.ts"],"names":[],"mappings":"AAKA,OAAO,EAA6C,KAAK,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AASnH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,SAAS,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,SAAS,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAM/I,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAwB1E;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAK9F;AAED,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK5E;AAUD,qBAAa,mBAAoB,YAAW,mBAAmB;IAK3D,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM;IAN9B,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,MAAM,CAAM;IAEpB,OAAO;WAMM,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA6BrI,WAAW,IAAI,MAAM;IAIrB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvB,IAAI,CAAC,OAAO,SAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAoCrC;AAED,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC,CAsB/H"}

package/dist/project/projectProcess.js

@@ -0,0 +1,196 @@
+import { execFile, spawn } from "node:child_process";
+import { isAbsolute, resolve, sep } from "node:path";
+import { promisify } from "node:util";
+import { GodotMcpException } from "../errors.js";
+import { childHasExited, shouldRefuseProcessSignal } from "../runtime/runtimeProcess.js";
+const execFileAsync = promisify(execFile);
+const ENVIRONMENT_ALLOWLIST = [
+    "HOME", "LANG", "LC_ALL", "LC_CTYPE", "PATH", "TMPDIR", "XDG_RUNTIME_DIR",
+    "DOTNET_ROOT", "JAVA_HOME", "ANDROID_HOME", "ANDROID_SDK_ROOT",
+];
+const PRESET_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_. -]{0,63}$/;
+function validateProjectRoot(projectRoot) {
+    if (!isAbsolute(projectRoot) || projectRoot.includes("\0"))
+        throw new TypeError("Project root must be an absolute path");
+}
+export function projectGodotArguments(input) {
+    validateProjectRoot(input.projectRoot);
+    if (input.operation === "import")
+        return ["--headless", "--editor", "--path", input.projectRoot, "--import"];
+    if (input.operation === "run") {
+        if (input.scenePath !== undefined && (!input.scenePath.startsWith("res://") ||
+            !input.scenePath.endsWith(".tscn") ||
+            input.scenePath.length > 512 ||
+            input.scenePath.includes("\0") ||
+            input.scenePath.slice(6).split("/").includes("..")))
+            throw new TypeError("Project run scene is invalid");
+        return [
+            ...(input.headless ? ["--headless"] : []),
+            "--path", input.projectRoot,
+            ...(input.scenePath ? ["--scene", input.scenePath] : []),
+        ];
+    }
+    if (input.operation === "build")
+        return ["--headless", "--path", input.projectRoot, "--build-solutions", "--quit"];
+    if (!PRESET_PATTERN.test(input.preset))
+        throw new TypeError("Export preset name is invalid");
+    const artifactRoot = resolve(input.artifactRoot);
+    const outputPath = resolve(input.outputPath);
+    if (outputPath === artifactRoot || !outputPath.startsWith(`${artifactRoot}${sep}`))
+        throw new TypeError("Export output must stay inside the owned artifact root");
+    const flag = input.mode === "release" ? "--export-release" : input.mode === "debug" ? "--export-debug" : "--export-pack";
+    return ["--headless", "--path", input.projectRoot, flag, input.preset, outputPath];
+}
+export function scrubProjectEnvironment(environment) {
+    return Object.fromEntries(ENVIRONMENT_ALLOWLIST.flatMap((name) => {
+        const value = environment[name];
+        return value === undefined ? [] : [[name, value]];
+    }));
+}
+export async function projectProcessFingerprint(pid) {
+    const { stdout } = await execFileAsync("ps", ["-o", "lstart=", "-p", String(pid)]);
+    const started = stdout.trim();
+    if (!started)
+        throw new Error("Owned project process start time is unavailable");
+    return `${pid}:${started}`;
+}
+function waitForExit(child) {
+    if (childHasExited(child))
+        return Promise.resolve(child.exitCode ?? 1);
+    return new Promise((resolveWait, reject) => {
+        child.once("error", reject);
+        child.once("close", (code) => resolveWait(code ?? 1));
+    });
+}
+export class OwnedProjectProcess {
+    child;
+    pid;
+    fingerprint;
+    stopPromise;
+    output = "";
+    constructor(child, pid, fingerprint) {
+        this.child = child;
+        this.pid = pid;
+        this.fingerprint = fingerprint;
+    }
+    static async launch(input) {
+        const child = spawn(input.godotBin, projectGodotArguments(input), {
+            env: scrubProjectEnvironment(input.environment ?? process.env),
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        await new Promise((resolveSpawn, reject) => {
+            child.once("spawn", resolveSpawn);
+            child.once("error", reject);
+        });
+        const pid = child.pid;
+        if (!pid)
+            throw new Error("Godot project operation did not report a PID");
+        let fingerprint;
+        try {
+            fingerprint = await projectProcessFingerprint(pid);
+        }
+        catch (error) {
+            if (!childHasExited(child))
+                child.kill("SIGKILL");
+            await waitForExit(child).catch(() => undefined);
+            throw error;
+        }
+        const owned = new OwnedProjectProcess(child, pid, fingerprint);
+        const append = (chunk) => {
+            owned.output = `${owned.output}${chunk.toString()}`.slice(-4 * 1024 * 1024);
+        };
+        child.stdout?.on("data", append);
+        child.stderr?.on("data", append);
+        child.once("exit", (code, signal) => append(`\n[godot project operation exited: ${signal ?? `code ${code ?? "unknown"}`}]\n`));
+        return owned;
+    }
+    diagnostics() {
+        return this.output;
+    }
+    wait() {
+        return waitForExit(this.child);
+    }
+    stop(graceMs = 2_000) {
+        if (!this.stopPromise) {
+            const activeStop = (async () => {
+                if (childHasExited(this.child))
+                    return;
+                const current = await projectProcessFingerprint(this.pid).catch(() => "");
+                if (shouldRefuseProcessSignal(this.child, current, this.fingerprint)) {
+                    throw new GodotMcpException({
+                        code: "CONFLICT",
+                        message: "Owned project process fingerprint changed; refusing to signal",
+                        retryable: false,
+                        correlationId: this.fingerprint,
+                        partialEffects: false,
+                        rollback: "not_attempted",
+                    });
+                }
+                if (childHasExited(this.child))
+                    return;
+                this.child.kill("SIGTERM");
+                const stopped = await Promise.race([
+                    waitForExit(this.child).then(() => true),
+                    new Promise((resolveTimeout) => setTimeout(() => resolveTimeout(false), graceMs)),
+                ]);
+                if (!stopped && !childHasExited(this.child)) {
+                    const beforeKill = await projectProcessFingerprint(this.pid).catch(() => "");
+                    if (shouldRefuseProcessSignal(this.child, beforeKill, this.fingerprint))
+                        throw new Error("Owned project process fingerprint changed before escalation");
+                    if (childHasExited(this.child))
+                        return;
+                    this.child.kill("SIGKILL");
+                    await waitForExit(this.child);
+                }
+            })();
+            this.stopPromise = activeStop;
+            void activeStop.catch(() => {
+                if (this.stopPromise === activeStop)
+                    this.stopPromise = undefined;
+            });
+        }
+        return this.stopPromise;
+    }
+}
+export async function recoverOwnedProjectProcess(pid, fingerprint) {
+    const current = await projectProcessFingerprint(pid).catch(() => "");
+    if (!current)
+        return "missing";
+    if (current !== fingerprint)
+        return "ambiguous";
+    try {
+        process.kill(pid, "SIGTERM");
+    }
+    catch {
+        return "ambiguous";
+    }
+    for (let attempt = 0; attempt < 40; attempt += 1) {
+        await new Promise((resolveWait) => setTimeout(resolveWait, 50));
+        const observed = await projectProcessFingerprint(pid).catch(() => "");
+        if (!observed)
+            return "stopped";
+        if (observed !== fingerprint)
+            return "ambiguous";
+    }
+    const beforeKill = await projectProcessFingerprint(pid).catch(() => "");
+    if (!beforeKill)
+        return "stopped";
+    if (beforeKill !== fingerprint)
+        return "ambiguous";
+    try {
+        process.kill(pid, "SIGKILL");
+    }
+    catch {
+        return "ambiguous";
+    }
+    for (let attempt = 0; attempt < 40; attempt += 1) {
+        await new Promise((resolveWait) => setTimeout(resolveWait, 50));
+        const observed = await projectProcessFingerprint(pid).catch(() => "");
+        if (!observed)
+            return "stopped";
+        if (observed !== fingerprint)
+            return "ambiguous";
+    }
+    return "ambiguous";
+}
+//# sourceMappingURL=projectProcess.js.map

package/dist/project/projectProcess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectProcess.js","sourceRoot":"","sources":["../../src/project/projectProcess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAA4B,MAAM,8BAA8B,CAAC;AAEnH,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC1C,MAAM,qBAAqB,GAAG;IAC5B,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB;IACzE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB;CACtD,CAAC;AACX,MAAM,cAAc,GAAG,oCAAoC,CAAC;AAQ5D,SAAS,mBAAmB,CAAC,WAAmB;IAC9C,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;AAC3H,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAA0B;IAC9D,mBAAmB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACvC,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,CAAC,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAC7G,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,CACnC,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC;YACrC,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;YAClC,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,GAAG;YAC5B,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC9B,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CACnD;YAAE,MAAM,IAAI,SAAS,CAAC,8BAA8B,CAAC,CAAC;QACvD,OAAO;YACL,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,QAAQ,EAAE,KAAK,CAAC,WAAW;YAC3B,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,OAAO;QAAE,OAAO,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,mBAAmB,EAAE,QAAQ,CAAC,CAAC;IACnH,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;IAC7F,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,UAAU,KAAK,YAAY,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,YAAY,GAAG,GAAG,EAAE,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,wDAAwD,CAAC,CAAC;IAClK,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC;IACzH,OAAO,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAA8B;IACpE,OAAO,MAAM,CAAC,WAAW,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC/D,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,GAAW;IACzD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACjF,OAAO,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,WAAW,CAAC,KAAmB;IACtC,IAAI,cAAc,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;IACvE,OAAO,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE;QACzC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,OAAO,mBAAmB;IAKX;IACR;IACA;IANH,WAAW,CAA4B;IACvC,MAAM,GAAG,EAAE,CAAC;IAEpB,YACmB,KAAmB,EAC3B,GAAW,EACX,WAAmB;QAFX,UAAK,GAAL,KAAK,CAAc;QAC3B,QAAG,GAAH,GAAG,CAAQ;QACX,gBAAW,GAAX,WAAW,CAAQ;IAC3B,CAAC;IAEJ,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAkF;QACpG,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,qBAAqB,CAAC,KAAK,CAAC,EAAE;YAChE,GAAG,EAAE,uBAAuB,CAAC,KAAK,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC;YAC9D,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE;YAC/C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAC1E,IAAI,WAAmB,CAAC;QACxB,IAAI,CAAC;YACH,WAAW,GAAG,MAAM,yBAAyB,CAAC,GAAG,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAClD,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAChD,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,mBAAmB,CAAC,KAAK,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QAC/D,MAAM,MAAM,GAAG,CAAC,KAAsB,EAAQ,EAAE;YAC9C,KAAK,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;QAC9E,CAAC,CAAC;QACF,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,sCAAsC,MAAM,IAAI,QAAQ,IAAI,IAAI,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QAC/H,OAAO,KAAK,CAAC;IACf,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI;QACF,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,CAAC,OAAO,GAAG,KAAK;QAClB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG,CAAC,KAAK,IAAI,EAAE;gBAC7B,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;oBAAE,OAAO;gBACvC,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC1E,IAAI,yBAAyB,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;oBACrE,MAAM,IAAI,iBAAiB,CAAC;wBAC1B,IAAI,EAAE,UAAU;wBAChB,OAAO,EAAE,+DAA+D;wBACxE,SAAS,EAAE,KAAK;wBAChB,aAAa,EAAE,IAAI,CAAC,WAAW;wBAC/B,cAAc,EAAE,KAAK;wBACrB,QAAQ,EAAE,eAAe;qBAC1B,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;oBAAE,OAAO;gBACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC3B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;oBACjC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;oBACxC,IAAI,OAAO,CAAU,CAAC,cAAc,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;iBAC3F,CAAC,CAAC;gBACH,IAAI,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC5C,MAAM,UAAU,GAAG,MAAM,yBAAyB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;oBAC7E,IAAI,yBAAyB,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC;wBAAE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;oBACxJ,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;wBAAE,OAAO;oBACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBAC3B,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;YACL,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;YAC9B,KAAK,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE;gBACzB,IAAI,IAAI,CAAC,WAAW,KAAK,UAAU;oBAAE,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;YACpE,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,GAAW,EAAE,WAAmB;IAC/E,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,IAAI,OAAO,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC;IAChD,IAAI,CAAC;QAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,WAAW,CAAC;IAAC,CAAC;IACnE,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,EAAE,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,OAAO,CAAO,CAAC,WAAW,EAAE,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAChC,IAAI,QAAQ,KAAK,WAAW;YAAE,OAAO,WAAW,CAAC;IACnD,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,yBAAyB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACxE,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC;IACnD,IAAI,CAAC;QAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,WAAW,CAAC;IAAC,CAAC;IACnE,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,EAAE,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,OAAO,CAAO,CAAC,WAAW,EAAE,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAChC,IAAI,QAAQ,KAAK,WAAW;YAAE,OAAO,WAAW,CAAC;IACnD,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/project/projectService.d.ts

@@ -0,0 +1,20 @@
+import type { ProjectOperationInput } from "@godot-mcp/protocol";
+import type { ProjectJobService } from "./projectJobService.js";
+import type { ProjectMutationService } from "./projectMutationService.js";
+export declare class ProjectService {
+    private readonly mutations;
+    private readonly jobs;
+    constructor(mutations: ProjectMutationService, jobs: ProjectJobService);
+    execute(input: ProjectOperationInput, correlationId: string): Promise<{
+        data: unknown;
+        evidence?: string[];
+        audit?: {
+            targetIdentities: unknown[];
+            preconditions: unknown[];
+            idempotencyKeySha256: string | null;
+            partialEffects: boolean;
+            rollback: "not_needed" | "succeeded" | "failed" | "not_attempted";
+        };
+    }>;
+}
+//# sourceMappingURL=projectService.d.ts.map

package/dist/project/projectService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectService.d.ts","sourceRoot":"","sources":["../../src/project/projectService.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,SAAS;IAA0B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAxD,SAAS,EAAE,sBAAsB,EAAmB,IAAI,EAAE,iBAAiB;IAElG,OAAO,CAAC,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAC1E,IAAI,EAAE,OAAO,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,EAAE;YAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;YAAC,aAAa,EAAE,OAAO,EAAE,CAAC;YAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,cAAc,EAAE,OAAO,CAAC;YAAC,QAAQ,EAAE,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,eAAe,CAAA;SAAE,CAAC;KACpM,CAAC;CAsBH"}

package/dist/project/projectService.js

@@ -0,0 +1,35 @@
+import { createHash } from "node:crypto";
+export class ProjectService {
+    mutations;
+    jobs;
+    constructor(mutations, jobs) {
+        this.mutations = mutations;
+        this.jobs = jobs;
+    }
+    async execute(input, correlationId) {
+        if (input.operation === "settings_apply" || input.operation === "plugin_set") {
+            const result = await this.mutations.execute(input, correlationId);
+            return {
+                data: result,
+                audit: {
+                    targetIdentities: input.operation === "settings_apply"
+                        ? result.operation === "settings_apply" ? result.changes.map((change) => change.settingNameSha256) : []
+                        : result.operation === "plugin_set" ? [result.pluginSha256] : [],
+                    preconditions: [],
+                    idempotencyKeySha256: createHash("sha256").update(input.idempotencyKey).digest("hex"),
+                    partialEffects: false,
+                    rollback: result.rollback,
+                },
+            };
+        }
+        if (input.operation === "import_start" || input.operation === "run_start" || input.operation === "build_start" || input.operation === "export_start")
+            return { data: this.jobs.start(input) };
+        if (input.operation === "job_status")
+            return { data: this.jobs.status(input.jobToken) };
+        if (input.operation === "job_cancel")
+            return { data: this.jobs.cancel(input.jobToken) };
+        const result = this.jobs.result(input.jobToken);
+        return { data: result, evidence: result.evidence };
+    }
+}
+//# sourceMappingURL=projectService.js.map

package/dist/project/projectService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectService.js","sourceRoot":"","sources":["../../src/project/projectService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzC,MAAM,OAAO,cAAc;IACI;IAAoD;IAAjF,YAA6B,SAAiC,EAAmB,IAAuB;QAA3E,cAAS,GAAT,SAAS,CAAwB;QAAmB,SAAI,GAAJ,IAAI,CAAmB;IAAG,CAAC;IAE5G,KAAK,CAAC,OAAO,CAAC,KAA4B,EAAE,aAAqB;QAK/D,IAAI,KAAK,CAAC,SAAS,KAAK,gBAAgB,IAAI,KAAK,CAAC,SAAS,KAAK,YAAY,EAAE,CAAC;YAC7E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;YAClE,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE;oBACL,gBAAgB,EAAE,KAAK,CAAC,SAAS,KAAK,gBAAgB;wBACpD,CAAC,CAAC,MAAM,CAAC,SAAS,KAAK,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE;wBACvG,CAAC,CAAC,MAAM,CAAC,SAAS,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE;oBAClE,aAAa,EAAE,EAAE;oBACjB,oBAAoB,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;oBACrF,cAAc,EAAE,KAAK;oBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;iBAC1B;aACF,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,SAAS,KAAK,cAAc,IAAI,KAAK,CAAC,SAAS,KAAK,WAAW,IAAI,KAAK,CAAC,SAAS,KAAK,aAAa,IAAI,KAAK,CAAC,SAAS,KAAK,cAAc;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9L,IAAI,KAAK,CAAC,SAAS,KAAK,YAAY;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxF,IAAI,KAAK,CAAC,SAAS,KAAK,YAAY;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxF,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IACrD,CAAC;CACF"}

package/dist/project/secureJournalFile.d.ts

@@ -0,0 +1,3 @@
+export declare function readSecureJournal(path: string, maxBytes: number): Promise<string | null>;
+export declare function appendSecureJournal(path: string, line: string): Promise<void>;
+//# sourceMappingURL=secureJournalFile.d.ts.map

package/dist/project/secureJournalFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secureJournalFile.d.ts","sourceRoot":"","sources":["../../src/project/secureJournalFile.ts"],"names":[],"mappings":"AAyBA,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAW9F;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQnF"}