agentic-numerical-control 0.1.6 → 0.2.0

package/dist/server/settings-import.js

@@ -0,0 +1,237 @@
+// Optional import of settings from other CNC software. Read-only discovery
+// looks in a few known places on this computer; import only adds tools to
+// ANC's library, never replaces or removes anything. Credentials, secrets,
+// shell commands and controller firmware settings are never read into ANC.
+//
+// Sources for now:
+//   Kiri:Moto  tool exports (.km / .b64: base64 JSON with `tools`, or a
+//              settings export with `settings.tools`)
+//   Fusion     tool library exports (.json with `data: [{ type, geometry }]`)
+//   CNCjs      ~/.cncrc: machine profiles are reported, nothing is imported
+//              (ANC reads travel from the controller itself)
+import crypto from "node:crypto";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { listTools, saveTool } from "./cam.js";
+import { JOBS_DIR } from "./product.js";
+const MAX_BYTES = 5 << 20;
+const IN = 25.4;
+/** Folders searched (one level deep): the usual download and document folders, ANC's jobs folder, Fusion's local tool libraries. */
+function searchFolders() {
+    const home = os.homedir();
+    const appData = process.env.APPDATA ?? path.join(home, "Library", "Application Support");
+    return [
+        path.join(home, "Downloads"),
+        path.join(home, "Documents"),
+        path.join(home, "Desktop"),
+        JOBS_DIR,
+        path.join(appData, "Autodesk", "CAM360", "libraries", "Local"),
+    ];
+}
+const sourceId = (file) => crypto.createHash("sha256").update(path.resolve(file)).digest("hex").slice(0, 10);
+function readSmall(file) {
+    try {
+        const st = fs.statSync(file);
+        return st.isFile() && st.size <= MAX_BYTES ? fs.readFileSync(file, "utf-8") : null;
+    }
+    catch {
+        return null;
+    }
+}
+// ------------------------------------------------------------------ Kiri:Moto
+function fromKiri(text, src) {
+    let data;
+    try {
+        const t = text.trim();
+        data = JSON.parse(t.startsWith("{") ? t : Buffer.from(t, "base64").toString("utf-8"));
+    }
+    catch {
+        return false;
+    }
+    const tools = data?.tools ?? data?.settings?.tools;
+    if (!Array.isArray(tools)) {
+        if (data?.device && data?.code)
+            src.notes.push(`Machine profile "${data.device}" is not imported: ANC reads travel and limits from the controller.`);
+        return Boolean(data?.device && data?.time);
+    }
+    for (const t of tools) {
+        const label = `${t?.name ?? "unnamed"} (${t?.type ?? "unknown type"})`;
+        const type = { endmill: "flat", ballmill: "ball", tapermill: "vbit", drill: "drill" }[t?.type];
+        const k = t?.metric === false ? IN : 1;
+        const diameter = Number(t?.flute_diam) * k;
+        const fluteLength = Number(t?.flute_len) * k;
+        if (!type) {
+            src.skipped.push(`${label}: ANC has no ${t?.type ?? "such"} tools yet`);
+            continue;
+        }
+        if (!(diameter > 0) || !(fluteLength > 0)) {
+            src.skipped.push(`${label}: no diameter or flute length`);
+            continue;
+        }
+        src.tools.push({
+            from: label,
+            name: String(t.name ?? `${diameter} mm ${type}`).slice(0, 60),
+            type,
+            diameter: round(diameter),
+            fluteLength: round(fluteLength),
+            shankDiameter: Number(t.shaft_diam) > 0 ? round(Number(t.shaft_diam) * k) : undefined,
+            // Kiri's taper_angle is half the included angle.
+            angle: type === "vbit" && Number(t.taper_angle) > 0 ? round(Number(t.taper_angle) * 2) : undefined,
+            number: Number.isInteger(t.number) && t.number > 0 ? t.number : undefined,
+        });
+    }
+    return true;
+}
+// --------------------------------------------------------------------- Fusion
+function fromFusion(text, src) {
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        return false;
+    }
+    if (!Array.isArray(data?.data) || !data.data.some((t) => t?.geometry && typeof t?.type === "string"))
+        return false;
+    for (const t of data.data) {
+        if (t?.type === "holder" || t?.type === "probe")
+            continue;
+        const label = `${t?.description || t?.["product-id"] || "unnamed"} (${t?.type})`;
+        const type = { "flat end mill": "flat", "ball end mill": "ball", "chamfer mill": "vbit", "drill": "drill" }[t?.type];
+        const g = t?.geometry ?? {};
+        const k = /^in/i.test(t?.unit ?? "") ? IN : 1;
+        const diameter = Number(g.DC) * k;
+        const fluteLength = Number(g.LCF) * k;
+        if (!type) {
+            src.skipped.push(`${label}: ANC has no ${t?.type} tools yet`);
+            continue;
+        }
+        if (!(diameter > 0) || !(fluteLength > 0)) {
+            src.skipped.push(`${label}: no diameter or flute length`);
+            continue;
+        }
+        const number = Number(t?.["post-process"]?.number);
+        src.tools.push({
+            from: label,
+            name: String(t.description || `${round(diameter)} mm ${type}`).slice(0, 60),
+            type,
+            diameter: round(diameter),
+            fluteLength: round(fluteLength),
+            shankDiameter: Number(g.SFDM) > 0 ? round(Number(g.SFDM) * k) : undefined,
+            // Fusion's taper angle (TA) is half the included angle.
+            angle: type === "vbit" && Number(g.TA) > 0 ? round(Number(g.TA) * 2) : undefined,
+            number: Number.isInteger(number) && number > 0 ? number : undefined,
+        });
+    }
+    return true;
+}
+// ---------------------------------------------------------------------- CNCjs
+function fromCncrc(text, src) {
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        return false;
+    }
+    const machines = Array.isArray(data?.machines) ? data.machines : [];
+    for (const m of machines) {
+        const l = m?.limits ?? {};
+        const size = ["x", "y", "z"].map((a) => round(Math.abs(Number(l[`${a}max`] ?? 0) - Number(l[`${a}min`] ?? 0))));
+        src.notes.push(`Machine profile "${m?.name ?? "unnamed"}" (${size.join(" x ")} mm) is not imported: ANC reads travel from the controller.`);
+    }
+    const macros = Array.isArray(data?.macros) ? data.macros.length : 0;
+    if (macros)
+        src.notes.push(`${macros} macros, not imported (ANC has no macros).`);
+    const ignored = ["secret", "users", "commands", "events"].filter((k) => data?.[k] !== undefined && (!Array.isArray(data[k]) || data[k].length));
+    if (ignored.length)
+        src.notes.push(`Never imported: ${ignored.join(", ")} (secrets, sign-ins and shell commands).`);
+    return true;
+}
+const round = (n) => Math.round(n * 1000) / 1000;
+// ------------------------------------------------------------------ discovery
+function inspect(file) {
+    const text = readSmall(file);
+    if (text === null)
+        return null;
+    let modified = "";
+    try {
+        modified = fs.statSync(file).mtime.toISOString();
+    }
+    catch { }
+    const source = (app) => ({ id: sourceId(file), app, file, modified, tools: [], skipped: [], notes: [] });
+    const ext = path.extname(file).toLowerCase();
+    if (path.basename(file) === ".cncrc") {
+        const src = source("CNCjs");
+        return fromCncrc(text, src) ? src : null;
+    }
+    if (ext === ".km" || ext === ".b64") {
+        const src = source("Kiri:Moto");
+        return fromKiri(text, src) ? src : null;
+    }
+    if (ext === ".json") {
+        const src = source("Fusion");
+        if (fromFusion(text, src))
+            return src;
+        const kiri = source("Kiri:Moto");
+        return fromKiri(text, kiri) && kiri.tools.length ? kiri : null;
+    }
+    return null;
+}
+/** Looks for other CNC software's settings in the usual places. Reads only. */
+export function findSettings() {
+    const found = [];
+    const cncrc = inspect(path.join(os.homedir(), ".cncrc"));
+    if (cncrc)
+        found.push(cncrc);
+    const searched = searchFolders();
+    for (const dir of searched) {
+        let names = [];
+        try {
+            names = fs.readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const name of names) {
+            if (!/\.(km|b64|json)$/i.test(name))
+                continue;
+            const src = inspect(path.join(dir, name));
+            if (src && (src.tools.length || src.skipped.length || src.notes.length))
+                found.push(src);
+        }
+    }
+    return { searched: [path.join(os.homedir(), ".cncrc"), ...searched], found };
+}
+/**
+ * Adds a found source's tools to ANC's library (all, or the ones at `pick`,
+ * 0-based). Tools already in the library (same type, diameter and name) are
+ * left alone; nothing existing is changed.
+ */
+export function importTools(id, pick) {
+    const src = findSettings().found.find((s) => s.id === id);
+    if (!src)
+        throw new Error(`No settings source "${id}". Run anc_find_settings to list them.`);
+    if (!src.tools.length)
+        throw new Error(`${src.file} has no tools ANC can import.`);
+    const chosen = pick?.length ? pick.map((i) => src.tools[i]).filter(Boolean) : src.tools;
+    if (!chosen.length)
+        throw new Error(`None of those tool numbers are in ${src.file} (0 to ${src.tools.length - 1}).`);
+    const added = [];
+    const alreadyThere = [];
+    const numbers = new Set(listTools().map((t) => t.number));
+    for (const { from, ...tool } of chosen) {
+        const same = listTools().find((t) => t.type === tool.type && Math.abs(t.diameter - tool.diameter) < 0.001 && t.name === tool.name);
+        if (same) {
+            alreadyThere.push(`${from}: already in the library as tool ${same.id}`);
+            continue;
+        }
+        // Keep the other app's tool number only when it doesn't clash with one ANC already has.
+        const number = tool.number !== undefined && !numbers.has(tool.number) ? tool.number : undefined;
+        const saved = saveTool({ ...tool, number });
+        numbers.add(saved.number);
+        added.push(saved);
+    }
+    return { from: src.file, added, alreadyThere, skipped: src.skipped, tools: listTools() };
+}