@codesys/mcp-toolkit 1.5.8 → 2.0.0

package/dist/cli.js

@@ -0,0 +1,196 @@
+#!/usr/bin/env node
+/**
+ * codesys-mcp-tool: stdio MCP server for CODESYS V3.5.
+ *
+ * Options (v1 names kept where they existed):
+ *   --codesys-path <exe>      CODESYS.exe (default: newest install under Program Files)
+ *   --codesys-profile <name>  profile, e.g. "CODESYS V3.5 SP21" (default: the install's newest)
+ *   --workspace <dir>         base folder for relative project paths (default: cwd)
+ *   --project <file>          open this project once CODESYS is up
+ *   --session-dir <dir>       where session folders go (default: %TEMP%\codesys-mcp-toolkit)
+ *   --no-autostart            start CODESYS on the first tool call instead of at launch
+ *   --no-autosave             don't save after each change (use save_project)
+ *   --viewer-port <port>      port of the browser viewer on 127.0.0.1 (default 5180, next free one if taken)
+ *   --no-viewer               don't serve the browser viewer
+ *   --no-shared               run CODESYS in this process instead of the shared session
+ *
+ * By default every process started with the same options shares one session
+ * (one CODESYS, one viewer): see daemon.ts.
+ */
+import { spawn } from "node:child_process";
+import { openSync, statSync } from "node:fs";
+import { parseArgs } from "node:util";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { serveStdio, StdioServerTransport } from "@modelcontextprotocol/server/stdio";
+import { CodesysBridge, pruneSessions } from "./bridge/bridge.js";
+import { ensureWorkspace, resolveCodesys } from "./codesys/install.js";
+import { createServer, VERSION } from "./server.js";
+import { ChangeStore } from "./codesys/changes.js";
+import { ProjectCache } from "./codesys/cache.js";
+import { Driver } from "./driver.js";
+import { startViewer } from "./viewer.js";
+import { connectDaemon, serveDaemon, sessionKey } from "./daemon.js";
+const log = (m) => process.stderr.write(`[codesys-mcp] ${m}\n`);
+/** Options from when the toolkit simulated in truST. Still accepted, so existing client setups keep starting. */
+const REMOVED_OPTIONS = ["trust-runtime", "mirror-dir", "no-sim"];
+async function main() {
+    const { values } = parseArgs({
+        options: {
+            "codesys-path": { type: "string" },
+            "codesys-profile": { type: "string" },
+            "codesys-additional-folder": { type: "string" },
+            workspace: { type: "string" },
+            project: { type: "string" },
+            "session-dir": { type: "string" },
+            "no-autostart": { type: "boolean" },
+            "no-autosave": { type: "boolean" },
+            "viewer-port": { type: "string" },
+            "no-viewer": { type: "boolean" },
+            "no-shared": { type: "boolean" },
+            "trust-runtime": { type: "string" },
+            "mirror-dir": { type: "string" },
+            "no-sim": { type: "boolean" },
+            // internal: run as the shared session's owner (see daemon.ts)
+            daemon: { type: "string" },
+            version: { type: "boolean" },
+            help: { type: "boolean", short: "h" },
+        },
+        strict: true,
+    });
+    if (values.version) {
+        process.stdout.write(`${VERSION}\n`);
+        return;
+    }
+    if (values.help) {
+        process.stdout.write("codesys-mcp-tool [--codesys-path <CODESYS.exe>] [--codesys-profile <name>] [--codesys-additional-folder <dir>] [--workspace <dir>] [--project <file>] [--session-dir <dir>] [--no-autostart] [--no-autosave] [--viewer-port <port>] [--no-viewer] [--no-shared]\n");
+        return;
+    }
+    const stateDir = process.env.CODESYS_MCP_STATE_DIR ?? join(process.env.LOCALAPPDATA ?? tmpdir(), "codesys-mcp-toolkit");
+    const cliFile = fileURLToPath(import.meta.url);
+    // Processes with the same options (and the same build) share a session.
+    const forward = process.argv.slice(2).filter((a) => a !== "--no-shared" && !a.startsWith("--daemon"));
+    const key = sessionKey({
+        args: forward,
+        cwd: process.cwd(),
+        version: VERSION,
+        build: statSync(cliFile).mtimeMs,
+        env: [],
+    });
+    if (values.daemon === undefined && !values["no-shared"]) {
+        try {
+            const c = await connectDaemon({
+                dir: stateDir,
+                key,
+                spawnDaemon: (logFile) => {
+                    const out = openSync(logFile, "a");
+                    spawn(process.execPath, [cliFile, ...forward, `--daemon=${key}`], { detached: true, stdio: ["ignore", out, out], windowsHide: true, cwd: process.cwd(), env: process.env }).unref();
+                },
+            });
+            log(`${c.spawned ? "started" : "joined"} the shared CODESYS session (pid ${c.info.pid}; log ${c.log})`);
+            process.stdin.pipe(c.socket);
+            c.socket.pipe(process.stdout);
+            c.socket.on("close", () => process.exit(0));
+            process.stdin.on("end", () => c.socket.end());
+            return;
+        }
+        catch (e) {
+            log(`shared session unavailable (${e.message}); running in this process`);
+        }
+    }
+    const codesys = resolveCodesys(values["codesys-path"], values["codesys-profile"], values["codesys-additional-folder"]);
+    const watcherSource = join(dirname(fileURLToPath(import.meta.url)), "..", "watcher");
+    const sessionRoot = values["session-dir"] ?? join(tmpdir(), "codesys-mcp-toolkit");
+    await pruneSessions(sessionRoot);
+    const bridge = new CodesysBridge({
+        command: codesys.exe,
+        profile: codesys.profile,
+        additionalFolder: codesys.install.additionalFolder,
+        watcherSource,
+        sessionRoot,
+        log,
+    });
+    const ctx = {
+        bridge,
+        autosave: !values["no-autosave"],
+        workspace: ensureWorkspace(resolve(values.workspace ?? process.cwd()), log),
+        templatesDir: codesys.install.templatesDir,
+        codesys: { exe: codesys.exe, profile: codesys.profile, label: codesys.install.label },
+        startWaitMs: 90_000,
+        log,
+    };
+    ctx.changes = new ChangeStore(join(process.env.LOCALAPPDATA ?? tmpdir(), "codesys-mcp-toolkit", "checkpoints"));
+    ctx.cache = new ProjectCache();
+    ctx.driver = new Driver();
+    const ignored = REMOVED_OPTIONS.filter((o) => values[o] !== undefined);
+    if (ignored.length)
+        log(`ignoring ${ignored.map((o) => `--${o}`).join(", ")}: truST support was removed`);
+    if (codesys.warning)
+        log(`warning: ${codesys.warning}`);
+    log(`v${VERSION}: ${codesys.install.label} (${codesys.reason}), profile "${codesys.profile}"${codesys.install.additionalFolder ? `, add-ons in ${codesys.install.additionalFolder}` : ""}, sessions in ${sessionRoot}`);
+    if (!values["no-viewer"]) {
+        try {
+            ctx.viewer = await startViewer(ctx, { port: values["viewer-port"] ? Number(values["viewer-port"]) : undefined, log });
+        }
+        catch (e) {
+            log(`viewer not started: ${e.message}`);
+        }
+    }
+    let stopping = false;
+    let closeShared;
+    let handle;
+    const shutdown = async () => {
+        if (stopping)
+            return;
+        stopping = true;
+        closeShared?.();
+        await bridge.stop().catch(() => undefined);
+        await handle?.close();
+        process.exit(0);
+    };
+    if (values.daemon !== undefined) {
+        // The shared session's owner: serve every client that connects, stop when idle.
+        const idleMs = Number(process.env.CODESYS_MCP_IDLE_MS ?? 120_000);
+        const owner = await serveDaemon({
+            dir: stateDir,
+            key: values.daemon || key,
+            idleMs,
+            log,
+            onIdle: () => {
+                log(`no clients for ${Math.round(idleMs / 1000)} s: stopping`);
+                void shutdown();
+            },
+            onConnection: async (socket) => {
+                const server = createServer(ctx);
+                socket.on("close", () => void server.close().catch(() => undefined));
+                await server.connect(new StdioServerTransport(socket, socket));
+            },
+        });
+        closeShared = owner.close;
+        log(`shared session ${owner.info.key} on 127.0.0.1:${owner.info.port} (pid ${process.pid})`);
+    }
+    else {
+        handle = serveStdio(() => createServer(ctx));
+        process.stdin.on("close", shutdown);
+    }
+    if (!values["no-autostart"]) {
+        bridge
+            .start()
+            .then(async () => {
+            if (values.project) {
+                const r = await bridge.call("project.open", { path: resolve(ctx.workspace, values.project) }, { timeoutMs: 300_000 });
+                ctx.project = { path: r.path, application: r.application };
+                log(`opened ${r.path}`);
+            }
+        })
+            .catch((e) => log(`CODESYS start failed: ${e.message}`));
+    }
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+}
+main().catch((e) => {
+    log(`fatal: ${e.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/codesys/cache.d.ts

@@ -0,0 +1,48 @@
+/**
+ * What the server knows about the open project, for the workspace panel.
+ *
+ * The panel must never call CODESYS itself: the bridge runs one request at a
+ * time, so panel polling would stall the model's tool calls. Instead the
+ * tools keep this cache current as a side effect of their own calls (open,
+ * export, write, create, delete, rename, compile), and the panel reads it.
+ */
+import type { TreeNode } from "./st.js";
+export interface CompileResult {
+    at: string;
+    errors: number;
+    warnings: number;
+    messages: {
+        severity: string;
+        text: string;
+        object?: string | null;
+        position?: string | null;
+        length?: number;
+        code?: string;
+    }[];
+}
+export interface Focus {
+    /** Object path the model last touched. */
+    path: string;
+    action: "read" | "write" | "create" | "delete" | "rename" | "revert";
+    at: string;
+}
+export declare class ProjectCache {
+    project?: string;
+    nodes?: TreeNode[];
+    /** Bumped on every change, so the panel refetches only when needed. */
+    version: number;
+    compile?: CompileResult;
+    focus?: Focus;
+    reset(project?: string): void;
+    setAll(nodes: TreeNode[]): void;
+    /** Replace or add one object (and keep the order: new ones go after their parent's last child). */
+    upsert(node: TreeNode): void;
+    /** Remove an object and everything under it. */
+    remove(path: string): void;
+    rename(path: string, newName: string): void;
+    /** Something the workspace shows changed without a node change (e.g. the review baseline). */
+    bump(): void;
+    touch(path: string, action: Focus["action"]): void;
+    setCompile(c: CompileResult): void;
+    get(path: string): TreeNode | undefined;
+}

package/dist/codesys/cache.js

@@ -0,0 +1,82 @@
+export class ProjectCache {
+    project;
+    nodes;
+    /** Bumped on every change, so the panel refetches only when needed. */
+    version = 0;
+    compile;
+    focus;
+    reset(project) {
+        this.project = project;
+        this.nodes = undefined;
+        this.compile = undefined;
+        this.focus = undefined;
+        this.version++;
+    }
+    setAll(nodes) {
+        this.nodes = nodes;
+        this.version++;
+    }
+    /** Replace or add one object (and keep the order: new ones go after their parent's last child). */
+    upsert(node) {
+        if (!this.nodes)
+            return;
+        const key = node.path.toLowerCase();
+        const i = this.nodes.findIndex((n) => n.path.toLowerCase() === key);
+        if (i >= 0)
+            this.nodes[i] = { ...this.nodes[i], ...node };
+        else {
+            const parent = node.path.includes("/") ? node.path.slice(0, node.path.lastIndexOf("/")).toLowerCase() : "";
+            let at = this.nodes.length;
+            for (let k = this.nodes.length - 1; k >= 0; k--) {
+                const p = this.nodes[k].path.toLowerCase();
+                if (p === parent || p.startsWith(parent ? parent + "/" : "")) {
+                    at = k + 1;
+                    break;
+                }
+            }
+            this.nodes.splice(at, 0, node);
+        }
+        this.version++;
+    }
+    /** Remove an object and everything under it. */
+    remove(path) {
+        if (!this.nodes)
+            return;
+        const key = path.toLowerCase();
+        this.nodes = this.nodes.filter((n) => n.path.toLowerCase() !== key && !n.path.toLowerCase().startsWith(key + "/"));
+        this.version++;
+    }
+    rename(path, newName) {
+        if (!this.nodes)
+            return;
+        const key = path.toLowerCase();
+        const parent = path.includes("/") ? path.slice(0, path.lastIndexOf("/") + 1) : "";
+        const to = parent + newName;
+        this.nodes = this.nodes.map((n) => {
+            const p = n.path.toLowerCase();
+            if (p === key)
+                return { ...n, path: to, name: newName };
+            if (p.startsWith(key + "/"))
+                return { ...n, path: to + n.path.slice(path.length) };
+            return n;
+        });
+        this.version++;
+    }
+    /** Something the workspace shows changed without a node change (e.g. the review baseline). */
+    bump() {
+        this.version++;
+    }
+    touch(path, action) {
+        this.focus = { path, action, at: new Date().toISOString() };
+        this.version++;
+    }
+    setCompile(c) {
+        this.compile = c;
+        this.version++;
+    }
+    get(path) {
+        const key = path.toLowerCase();
+        return this.nodes?.find((n) => n.path.toLowerCase() === key);
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/codesys/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/codesys/cache.ts"],"names":[],"mappings":"AAwBA,MAAM,OAAO,YAAY;IACvB,OAAO,CAAU;IACjB,KAAK,CAAc;IACnB,uEAAuE;IACvE,OAAO,GAAG,CAAC,CAAC;IACZ,OAAO,CAAiB;IACxB,KAAK,CAAS;IAEd,KAAK,CAAC,OAAgB;QACpB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,KAAiB;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,mGAAmG;IACnG,MAAM,CAAC,IAAc;QACnB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,GAAG,IAAI,EAAE,CAAC;aACtD,CAAC;YACJ,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3G,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YAC3B,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAChD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC5C,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;oBAC7D,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;oBACX,MAAM;gBACR,CAAC;YACH,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,gDAAgD;IAChD,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;QACnH,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,OAAe;QAClC,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,MAAM,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAChC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,GAAG;gBAAE,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACxD,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC;gBAAE,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACnF,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,8FAA8F;IAC9F,IAAI;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAY,EAAE,MAAuB;QACzC,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5D,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,UAAU,CAAC,CAAgB;QACzB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,GAAG,CAAC,IAAY;QACd,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/codesys/changes.d.ts

@@ -0,0 +1,57 @@
+import type { TreeNode } from "./st.js";
+export { formatDiff, lineDiff, type DiffOp } from "./diff.js";
+export interface SnapObject {
+    path: string;
+    name: string;
+    kind: TreeNode["kind"];
+    sub?: string;
+    st?: boolean;
+    declaration?: string;
+    implementation?: string;
+    /** PLCopenXML of a graphical body (SFC, CFC, LD, FBD), to recreate it. */
+    xml?: string;
+}
+export interface Checkpoint {
+    name: string;
+    at: string;
+    project: string;
+    objects: SnapObject[];
+}
+export declare function snapshot(nodes: TreeNode[]): SnapObject[];
+export interface ObjectChange {
+    path: string;
+    kind: string;
+    change: "added" | "removed" | "modified";
+    decl?: {
+        plus: number;
+        minus: number;
+    };
+    impl?: {
+        plus: number;
+        minus: number;
+    };
+}
+export declare function diffObjects(before: SnapObject[], after: SnapObject[]): ObjectChange[];
+export declare class ChangeStore {
+    readonly root: string;
+    /** Projects that already have a session-start checkpoint in this process. */
+    private started;
+    constructor(root: string);
+    dir(project: string): string;
+    private file;
+    save(project: string, name: string, nodes: TreeNode[]): Promise<Checkpoint>;
+    load(project: string, name: string): Promise<Checkpoint | undefined>;
+    list(project: string): Promise<{
+        name: string;
+        at: string;
+        objects: number;
+    }[]>;
+    /** Take the session-start checkpoint once per project per process. */
+    sessionStart(project: string, exportNodes: () => Promise<TreeNode[]>): Promise<boolean>;
+    /** The review baseline (what the user has accepted); falls back to session-start. */
+    review(project: string): Promise<Checkpoint | undefined>;
+    /** Accept the current state of an object and everything under it into the review baseline. */
+    accept(project: string, path: string, now: SnapObject[]): Promise<number>;
+}
+/** Name of the checkpoint the workspace's diffs and badges compare against. */
+export declare const REVIEW = "review";

package/dist/codesys/changes.js

@@ -0,0 +1,133 @@
+/**
+ * Change tracking for CODESYS edits: checkpoints (snapshots of every ST
+ * object's text), diffs against them, and what's needed to revert.
+ * Checkpoints live on disk per project, so they survive a server restart.
+ */
+import { createHash } from "node:crypto";
+import { existsSync } from "node:fs";
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { countDiff as count, lineDiff } from "./diff.js";
+export { formatDiff, lineDiff } from "./diff.js";
+/** Object kinds whose text is tracked (folders are tracked for structure only). */
+const TRACKED = new Set(["pou", "method", "property", "accessor", "action", "dut", "gvl", "interface", "interface_method", "folder"]);
+export function snapshot(nodes) {
+    return nodes
+        .filter((n) => TRACKED.has(n.kind))
+        .map((n) => ({
+        path: n.path,
+        name: n.name,
+        kind: n.kind,
+        ...(n.sub ? { sub: n.sub } : {}),
+        ...(n.st === false ? { st: false } : {}),
+        ...(n.declaration !== undefined ? { declaration: n.declaration } : {}),
+        ...(n.implementation !== undefined ? { implementation: n.implementation } : {}),
+        ...(n.xml !== undefined ? { xml: n.xml } : {}),
+    }));
+}
+const norm = (s) => (s ?? "").replace(/\r\n?/g, "\n").replace(/\s+$/, "");
+export function diffObjects(before, after) {
+    const b = new Map(before.map((o) => [o.path.toLowerCase(), o]));
+    const a = new Map(after.map((o) => [o.path.toLowerCase(), o]));
+    const out = [];
+    for (const [k, o] of a) {
+        const old = b.get(k);
+        if (!old) {
+            out.push({ path: o.path, kind: o.kind, change: "added" });
+            continue;
+        }
+        const d = norm(old.declaration) === norm(o.declaration) ? undefined : count(lineDiff(norm(old.declaration), norm(o.declaration)));
+        const i = norm(old.implementation) === norm(o.implementation) ? undefined : count(lineDiff(norm(old.implementation), norm(o.implementation)));
+        if (d || i)
+            out.push({ path: o.path, kind: o.kind, change: "modified", ...(d ? { decl: d } : {}), ...(i ? { impl: i } : {}) });
+    }
+    for (const [k, o] of b)
+        if (!a.has(k))
+            out.push({ path: o.path, kind: o.kind, change: "removed" });
+    return out.sort((x, y) => x.path.localeCompare(y.path));
+}
+export class ChangeStore {
+    root;
+    /** Projects that already have a session-start checkpoint in this process. */
+    started = new Set();
+    constructor(root) {
+        this.root = root;
+    }
+    dir(project) {
+        const base = basename(project).replace(/\.project$/i, "").replace(/[^A-Za-z0-9_.-]/g, "_");
+        const h = createHash("sha256").update(project.toLowerCase()).digest("hex").slice(0, 8);
+        return join(this.root, `${base}-${h}`);
+    }
+    file(project, name) {
+        return join(this.dir(project), `${name.replace(/[^A-Za-z0-9_.-]/g, "_")}.json`);
+    }
+    async save(project, name, nodes) {
+        const cp = { name, at: new Date().toISOString(), project, objects: snapshot(nodes) };
+        await mkdir(this.dir(project), { recursive: true });
+        await writeFile(this.file(project, name), JSON.stringify(cp), "utf8");
+        return cp;
+    }
+    async load(project, name) {
+        const f = this.file(project, name);
+        if (!existsSync(f))
+            return undefined;
+        return JSON.parse(await readFile(f, "utf8"));
+    }
+    async list(project) {
+        const d = this.dir(project);
+        if (!existsSync(d))
+            return [];
+        const out = [];
+        for (const f of await readdir(d)) {
+            if (!f.endsWith(".json"))
+                continue;
+            try {
+                const cp = JSON.parse(await readFile(join(d, f), "utf8"));
+                out.push({ name: cp.name, at: cp.at, objects: cp.objects.length });
+            }
+            catch {
+                /* skip unreadable */
+            }
+        }
+        return out.sort((x, y) => x.at.localeCompare(y.at));
+    }
+    /** Take the session-start checkpoint once per project per process. */
+    async sessionStart(project, exportNodes) {
+        const key = project.toLowerCase();
+        if (this.started.has(key))
+            return false;
+        this.started.add(key);
+        try {
+            const nodes = await exportNodes();
+            await this.save(project, "session-start", nodes);
+            // The review baseline starts as the session start; Accept moves it per object.
+            await this.save(project, REVIEW, nodes);
+            return true;
+        }
+        catch {
+            this.started.delete(key);
+            return false;
+        }
+    }
+    /** The review baseline (what the user has accepted); falls back to session-start. */
+    async review(project) {
+        return (await this.load(project, REVIEW)) ?? (await this.load(project, "session-start"));
+    }
+    /** Accept the current state of an object and everything under it into the review baseline. */
+    async accept(project, path, now) {
+        const cp = await this.review(project);
+        if (!cp)
+            throw new Error("No review baseline yet: open the project first.");
+        const key = path.replace(/^\/+/, "").toLowerCase();
+        const inTree = (o) => o.path.toLowerCase() === key || o.path.toLowerCase().startsWith(key + "/");
+        const kept = cp.objects.filter((o) => !inTree(o));
+        const taken = now.filter(inTree);
+        const objects = [...kept, ...taken];
+        await mkdir(this.dir(project), { recursive: true });
+        await writeFile(this.file(project, REVIEW), JSON.stringify({ ...cp, name: REVIEW, at: new Date().toISOString(), objects }), "utf8");
+        return taken.length;
+    }
+}
+/** Name of the checkpoint the workspace's diffs and badges compare against. */
+export const REVIEW = "review";
+//# sourceMappingURL=changes.js.map

package/dist/codesys/changes.js.map

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

package/dist/codesys/decl.d.ts

@@ -0,0 +1,45 @@
+/**
+ * A tolerant parser for CODESYS ST declarations: headers (kind, name,
+ * EXTENDS / IMPLEMENTS, return type, modifiers), variable sections with
+ * names, types, initial values, AT addresses and comments, enum members and
+ * struct fields. Used for the outline and the I/O list; it never rejects
+ * input, it just extracts what it recognises.
+ */
+export type SectionKind = "VAR_INPUT" | "VAR_OUTPUT" | "VAR_IN_OUT" | "VAR" | "VAR_TEMP" | "VAR_STAT" | "VAR_INST" | "VAR_GLOBAL" | "VAR_EXTERNAL" | "VAR_CONFIG";
+export interface VarDecl {
+    name: string;
+    type: string;
+    init?: string;
+    at?: string;
+    comment?: string;
+    section: SectionKind;
+    constant?: boolean;
+    retain?: boolean;
+    persistent?: boolean;
+}
+export interface Header {
+    keyword: string;
+    name?: string;
+    modifiers: string[];
+    extends?: string[];
+    implements?: string[];
+    returnType?: string;
+    attributes: string[];
+}
+export interface ParsedDecl {
+    header: Header;
+    vars: VarDecl[];
+    /** Enum members with optional values (DUT enums). */
+    enumMembers?: {
+        name: string;
+        value?: string;
+    }[];
+    /** Base type of an enum (`(A, B) INT`) or an alias target. */
+    baseType?: string;
+    /** STRUCT / UNION fields (DUTs). */
+    fields?: VarDecl[];
+    dutKind?: "enum" | "struct" | "union" | "alias";
+}
+export declare function parseDeclaration(decl: string | undefined): ParsedDecl;
+/** One-line signature, e.g. `METHOD Reset(bHard : BOOL) : BOOL`. */
+export declare function signature(p: ParsedDecl, name?: string): string;