@hpmicro-tools/hpmmfgctl 0.0.0-stage → 0.0.1

package/dist/command/validate.js

@@ -0,0 +1,48 @@
+import { basename, isAbsolute } from "node:path";
+import { stat } from "node:fs/promises";
+/** Checks the installed CMD name, version, failure exit behavior, and required options. */
+export async function validatePath(path, runner, signal) {
+    if (!isAbsolute(path)) {
+        return {
+            compatible: false,
+            message: "manufacturing command path must be absolute",
+        };
+    }
+    const expected = `hpm_manufacturing_cmd${process.platform === "win32" ? ".exe" : ""}`;
+    if (basename(path).toLowerCase() !== expected) {
+        return {
+            compatible: false,
+            message: `command file name must be ${expected}`,
+        };
+    }
+    try {
+        const info = await stat(path);
+        if (!info.isFile() || (process.platform !== "win32" && !(info.mode & 0o111))) {
+            throw new Error("command must be an executable file");
+        }
+        const version = await runner.run(path, ["--version"], 10000, signal);
+        if (!version.success) {
+            return { compatible: false, message: "--version failed: " + version.log };
+        }
+        const noArgs = await runner.run(path, [], 10000, signal);
+        if (noArgs.exitCode <= 0 || noArgs.timedOut || signal?.aborted) {
+            return {
+                compatible: false,
+                message: "command must fail with a nonzero exit code when called without arguments",
+            };
+        }
+        const help = await runner.run(path, ["--help"], 10000, signal);
+        if (!help.success ||
+            !["-p", "-u", "-r", "-t", "-f"].every((option) => help.log.includes(option))) {
+            return { compatible: false, message: "missing required command options" };
+        }
+        return { compatible: true, version: version.log.trim() };
+    }
+    catch (error) {
+        if (signal?.aborted) {
+            throw error;
+        }
+        return { compatible: false, message: String(error) };
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/command/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/command/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAIxC,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,MAAc,EACd,MAAoB;IAEpB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,OAAO,EAAE,6CAA6C;SACvD,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,wBAAwB,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACtF,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,OAAO,EAAE,6BAA6B,QAAQ,EAAE;SACjD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YAC7E,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACrE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC5E,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACzD,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YAC/D,OAAO;gBACL,UAAU,EAAE,KAAK;gBACjB,OAAO,EAAE,0EAA0E;aACpF,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC/D,IACE,CAAC,IAAI,CAAC,OAAO;YACb,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAC5E,CAAC;YACD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;QAC5E,CAAC;QACD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,KAAK,CAAC;QACd,CAAC;QACD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACvD,CAAC;AACH,CAAC"}

package/dist/config/config-path.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resolves a stable user configuration path, preferring HPMMFGCTL_CONFIG.
+ * @param environmentVariables Environment providing the override and APPDATA/XDG_CONFIG_HOME.
+ * @param platform Target OS; defaults to the current OS and is injectable for tests.
+ * @param home User home directory for platform-specific fallback paths.
+ * @returns File path; does not create files.
+ */
+export declare function defaultPath(environmentVariables?: NodeJS.ProcessEnv, platform?: NodeJS.Platform, home?: string): string;

package/dist/config/config-path.js

@@ -0,0 +1,27 @@
+import * as os from "node:os";
+import * as path from "node:path";
+/**
+ * Resolves a stable user configuration path, preferring HPMMFGCTL_CONFIG.
+ * @param environmentVariables Environment providing the override and APPDATA/XDG_CONFIG_HOME.
+ * @param platform Target OS; defaults to the current OS and is injectable for tests.
+ * @param home User home directory for platform-specific fallback paths.
+ * @returns File path; does not create files.
+ */
+export function defaultPath(environmentVariables = process.env, platform = process.platform, home = os.homedir()) {
+    if (environmentVariables.HPMMFGCTL_CONFIG) {
+        return environmentVariables.HPMMFGCTL_CONFIG;
+    }
+    let configDirectory;
+    switch (platform) {
+        case "win32":
+            configDirectory = environmentVariables.APPDATA || path.join(home, "AppData", "Roaming");
+            break;
+        case "darwin":
+            configDirectory = path.join(home, "Library", "Application Support");
+            break;
+        default:
+            configDirectory = environmentVariables.XDG_CONFIG_HOME || path.join(home, ".config");
+    }
+    return path.join(configDirectory, "hpmicro", "hpmmfgctl", "config.json");
+}
+//# sourceMappingURL=config-path.js.map

package/dist/config/config-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-path.js","sourceRoot":"","sources":["../../src/config/config-path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,oBAAoB,GAAG,OAAO,CAAC,GAAG,EAClC,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAC3B,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE;IAEnB,IAAI,oBAAoB,CAAC,gBAAgB,EAAE,CAAC;QAC1C,OAAO,oBAAoB,CAAC,gBAAgB,CAAC;IAC/C,CAAC;IACD,IAAI,eAAuB,CAAC;IAC5B,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,eAAe,GAAG,oBAAoB,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YACxF,MAAM;QACR,KAAK,QAAQ;YACX,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAC;YACpE,MAAM;QACR;YACE,eAAe,GAAG,oBAAoB,CAAC,eAAe,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;AAC3E,CAAC"}

package/dist/config/config-store.d.ts

@@ -0,0 +1,13 @@
+import type { Config } from "./config-type.js";
+/** Persists configuration at a stable per-user path without caching file contents. */
+export declare class Store {
+    readonly filePath: string;
+    /** Uses the supplied file path or the platform default resolved by defaultPath. */
+    constructor(filePath?: string);
+    /** Returns the resolved configuration file path. */
+    path(): string;
+    /** Reads the latest configuration; a missing file returns an empty configuration. */
+    load(): Promise<Config>;
+    /** Flushes a temporary file and replaces configuration in the same directory. */
+    save(config: Config): Promise<void>;
+}

package/dist/config/config-store.js

@@ -0,0 +1,61 @@
+import { mkdir, readFile, rename, unlink, open } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { randomUUID } from "node:crypto";
+import { defaultPath } from "./config-path.js";
+/** Persists configuration at a stable per-user path without caching file contents. */
+export class Store {
+    filePath;
+    /** Uses the supplied file path or the platform default resolved by defaultPath. */
+    constructor(filePath = defaultPath()) {
+        this.filePath = filePath;
+    }
+    /** Returns the resolved configuration file path. */
+    path() {
+        return this.filePath;
+    }
+    /** Reads the latest configuration; a missing file returns an empty configuration. */
+    async load() {
+        const path = this.path();
+        let text;
+        try {
+            text = await readFile(path, "utf8");
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return {};
+            }
+            throw error;
+        }
+        const value = JSON.parse(text);
+        if (!value || typeof value !== "object" || Array.isArray(value)) {
+            throw new Error("Invalid config object");
+        }
+        const cfg = value;
+        if (cfg.mfgCmdPath !== undefined && typeof cfg.mfgCmdPath !== "string") {
+            throw new Error("Invalid mfgCmdPath");
+        }
+        return cfg;
+    }
+    /** Flushes a temporary file and replaces configuration in the same directory. */
+    async save(config) {
+        const path = this.path();
+        const directory = dirname(path);
+        await mkdir(directory, { recursive: true, mode: 0o700 });
+        const tmp = join(directory, `.config-${randomUUID()}.tmp`);
+        try {
+            const file = await open(tmp, "wx", 0o600);
+            try {
+                await file.writeFile(JSON.stringify(config, null, 2) + "\n");
+                await file.sync();
+            }
+            finally {
+                await file.close();
+            }
+            await rename(tmp, path);
+        }
+        finally {
+            await unlink(tmp).catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=config-store.js.map

package/dist/config/config-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.js","sourceRoot":"","sources":["../../src/config/config-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,sFAAsF;AACtF,MAAM,OAAO,KAAK;IAEK;IADrB,mFAAmF;IACnF,YAAqB,WAAW,WAAW,EAAE;QAAxB,aAAQ,GAAR,QAAQ,CAAgB;IAAG,CAAC;IAEjD,oDAAoD;IACpD,IAAI;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,qFAAqF;IACrF,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,GAAG,GAAG,KAAe,CAAC;QAC5B,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,iFAAiF;IACjF,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,UAAU,EAAE,MAAM,CAAC,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YAC1C,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC7D,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YACpB,CAAC;oBAAS,CAAC;gBACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;YACD,MAAM,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;CACF"}

package/dist/config/config-type.d.ts

@@ -0,0 +1,5 @@
+/** Serialized configuration compatible with the Go manufacturing server. */
+export interface Config {
+    /** Absolute installed CMD executable path; omitted when not configured. */
+    mfgCmdPath?: string;
+}

package/dist/config/config-type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config-type.js.map

package/dist/config/config-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-type.js","sourceRoot":"","sources":["../../src/config/config-type.ts"],"names":[],"mappings":""}

package/dist/device/enumerator.d.ts

@@ -0,0 +1,12 @@
+import type { DeviceInfo, Enumerator } from "./types.js";
+/** HPMicro USB vendor ID used when the caller omits a HID vendor filter. */
+export declare const defaultVID = 13495;
+/** Discovers devices using native OS bindings on supported manufacturing platforms. */
+export declare class SystemEnumerator implements Enumerator {
+    /** Rejects platforms outside the Manufacturing CMD support matrix. */
+    private supported;
+    /** Lists serial ports; Windows accessibility is verified later by the CMD probe. */
+    listSerial(): Promise<DeviceInfo[]>;
+    /** Lists matching HID interfaces and checks whether each can be opened. */
+    listHID(vid: number, pid: number): Promise<DeviceInfo[]>;
+}

package/dist/device/enumerator.js

@@ -0,0 +1,65 @@
+import { access } from "node:fs/promises";
+import { constants } from "node:fs";
+/** HPMicro USB vendor ID used when the caller omits a HID vendor filter. */
+export const defaultVID = 0x34b7;
+/** Discovers devices using native OS bindings on supported manufacturing platforms. */
+export class SystemEnumerator {
+    /** Rejects platforms outside the Manufacturing CMD support matrix. */
+    supported() {
+        if (!["win32", "linux"].includes(process.platform) || process.arch !== "x64") {
+            throw new Error("Supported platforms: Windows x64 and Linux x86_64");
+        }
+    }
+    /** Lists serial ports; Windows accessibility is verified later by the CMD probe. */
+    async listSerial() {
+        this.supported();
+        const { autoDetect } = await import("@serialport/bindings-cpp");
+        const ports = await autoDetect().list();
+        return Promise.all(ports.map(async (port) => {
+            const accessible = process.platform === "win32" ||
+                (await access(port.path, constants.R_OK | constants.W_OK).then(() => true, () => false));
+            return {
+                path: port.path,
+                description: port.manufacturer ?? "",
+                accessible,
+                ...(accessible ? {} : { hint: "Check device permissions and group membership" }),
+            };
+        }));
+    }
+    /** Lists matching HID interfaces and checks whether each can be opened. */
+    async listHID(vid, pid) {
+        this.supported();
+        const hid = await import("node-hid");
+        // Linux CMD expects hidraw paths rather than libusb bus identifiers.
+        if (process.platform === "linux") {
+            hid.setDriverType("hidraw");
+        }
+        const devices = (await hid.devicesAsync()).filter((device) => device.path && (!vid || device.vendorId === vid) && (!pid || device.productId === pid));
+        const result = [];
+        for (const device of devices) {
+            let accessible = false;
+            try {
+                const handle = await hid.HIDAsync.open(device.path);
+                await handle.close();
+                accessible = true;
+            }
+            catch {
+                /* Permission or exclusive-access failure. */
+            }
+            result.push({
+                path: device.path,
+                vid: device.vendorId,
+                pid: device.productId,
+                description: device.product ?? "",
+                accessible,
+                ...(accessible
+                    ? {}
+                    : {
+                        hint: "Check HID permissions or another application's exclusive access",
+                    }),
+            });
+        }
+        return result.sort((left, right) => left.path.localeCompare(right.path));
+    }
+}
+//# sourceMappingURL=enumerator.js.map

package/dist/device/enumerator.js.map

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

package/dist/device/types.d.ts

@@ -0,0 +1,22 @@
+/** Operating-system device information returned by discovery. */
+export interface DeviceInfo {
+    /** Serial device or HID interface path used to create a target. */
+    path: string;
+    /** USB vendor ID, when available. */
+    vid?: number;
+    /** USB product ID, when available. */
+    pid?: number;
+    /** Human-readable device description reported by the operating system. */
+    description: string;
+    /** Discovery accessibility hint; actual CMD access is verified during target creation. */
+    accessible: boolean;
+    /** Permission or exclusive-access guidance for unavailable devices. */
+    hint?: string;
+}
+/** Device discovery boundary, replaceable for service tests. */
+export interface Enumerator {
+    /** Lists serial devices without performing ROM communication. */
+    listSerial(): Promise<DeviceInfo[]>;
+    /** Lists HID devices filtered by vendor and product; zero disables that filter. */
+    listHID(vid: number, pid: number): Promise<DeviceInfo[]>;
+}

package/dist/device/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/device/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/device/types.ts"],"names":[],"mappings":""}

package/dist/hpm-mfg-service.d.ts

@@ -0,0 +1,37 @@
+import { Store } from "./config/config-store.js";
+import { Runner } from "./command/runner.js";
+import type { Validation } from "./command/types.js";
+import type { Enumerator } from "./device/types.js";
+import type { ROMName } from "./mcp/mcp-type.js";
+import type { TargetCreateInput } from "./service-type.js";
+/** Coordinates configuration, device probing, and serialized ROM operations. */
+export declare class Service {
+    readonly store: Store;
+    readonly runner: Runner;
+    readonly devices: Enumerator;
+    private targets;
+    private next;
+    private cached?;
+    /** Injects storage, process execution, and discovery without accessing hardware. */
+    constructor(store?: Store, runner?: Runner, devices?: Enumerator);
+    /** Caches successful compatibility checks by file identity; forced checks invalidate stale success. */
+    validate(path: string, signal?: AbortSignal, force?: boolean): Promise<Validation>;
+    /** Refreshes compatibility and reports the active plugin configuration. */
+    doctor(signal?: AbortSignal): Promise<Record<string, unknown>>;
+    /** Persists an absolute CMD path only after a successful compatibility check. */
+    set(path: string, signal?: AbortSignal): Promise<Validation>;
+    /** Clears persisted CMD settings and cached compatibility. */
+    clear(): Promise<Record<string, unknown>>;
+    /** Discovers devices without registering targets or issuing ROM commands. */
+    discover(transport: "serial" | "hid", vid?: number, pid?: number): Promise<Record<string, unknown>>;
+    /** Probes query-rte 0 and registers the target only when CMD reports success. */
+    create(input: TargetCreateInput, signal?: AbortSignal): Promise<Record<string, unknown>>;
+    /** Returns connection settings for targets registered in this process. */
+    list(): Record<string, unknown>;
+    /** Deletes a registered target and rejects unknown IDs. */
+    delete(targetId: string): Record<string, unknown>;
+    /** Validates a ROM request and executes it against a registered target. */
+    rom(name: ROMName, raw: unknown, signal?: AbortSignal): Promise<Record<string, unknown>>;
+    /** Resolves a compatible CMD and executes the transport-specific ROM arguments. */
+    private run;
+}

package/dist/hpm-mfg-service.js

@@ -0,0 +1,155 @@
+import { normalize } from "node:path";
+import { stat } from "node:fs/promises";
+import { Store } from "./config/config-store.js";
+import { Runner } from "./command/runner.js";
+import { buildArgs } from "./command/arguments.js";
+import { validatePath } from "./command/validate.js";
+import { SystemEnumerator, defaultVID } from "./device/enumerator.js";
+import { buildROM, defaultTimeout } from "./operations/rom.js";
+/** Coordinates configuration, device probing, and serialized ROM operations. */
+export class Service {
+    store;
+    runner;
+    devices;
+    targets = new Map();
+    next = 0;
+    cached;
+    /** Injects storage, process execution, and discovery without accessing hardware. */
+    constructor(store = new Store(), runner = new Runner(), devices = new SystemEnumerator()) {
+        this.store = store;
+        this.runner = runner;
+        this.devices = devices;
+    }
+    /** Caches successful compatibility checks by file identity; forced checks invalidate stale success. */
+    async validate(path, signal, force = false) {
+        let key = "";
+        try {
+            const info = await stat(path);
+            key = `${normalize(path)}:${info.size}:${info.mtimeMs}:${info.ctimeMs}`;
+        }
+        catch {
+            /* Invalid paths are not cached. */
+        }
+        if (!force && key && this.cached?.key === key) {
+            return this.cached.validation;
+        }
+        const validation = await validatePath(path, this.runner, signal);
+        if (validation.compatible && key) {
+            this.cached = { key, validation };
+        }
+        else if (this.cached?.key === key) {
+            this.cached = undefined;
+        }
+        return validation;
+    }
+    /** Refreshes compatibility and reports the active plugin configuration. */
+    async doctor(signal) {
+        const config = await this.store.load();
+        const validation = await this.validate(config.mfgCmdPath ?? "", signal, true);
+        return {
+            mcpVersion: "0.1.0",
+            os: process.platform,
+            arch: process.arch,
+            configPath: this.store.path(),
+            configuredPath: config.mfgCmdPath ?? "",
+            validation,
+            pathWhitespaceUnsupported: true,
+        };
+    }
+    /** Persists an absolute CMD path only after a successful compatibility check. */
+    async set(path, signal) {
+        const validation = await this.validate(path, signal, true);
+        if (!validation.compatible) {
+            throw new Error(validation.message);
+        }
+        await this.store.save({ mfgCmdPath: normalize(path) });
+        return validation;
+    }
+    /** Clears persisted CMD settings and cached compatibility. */
+    async clear() {
+        await this.store.save({});
+        this.cached = undefined;
+        return { cleared: true };
+    }
+    /** Discovers devices without registering targets or issuing ROM commands. */
+    async discover(transport, vid = defaultVID, pid = 0) {
+        return {
+            transport,
+            devices: transport === "serial"
+                ? await this.devices.listSerial()
+                : await this.devices.listHID(vid || defaultVID, pid),
+        };
+    }
+    /** Probes query-rte 0 and registers the target only when CMD reports success. */
+    async create(input, signal) {
+        const target = { ...input };
+        delete target.timeoutMs;
+        if (target.transport === "serial") {
+            target.baudRate ||= 115200;
+            if (!target.port) {
+                const list = await this.devices.listSerial();
+                if (list.length !== 1) {
+                    throw new Error(`Exactly one serial device required; found ${list.length}`);
+                }
+                target.port = list[0].path;
+            }
+        }
+        else {
+            target.vid ||= defaultVID;
+            if (!target.path) {
+                const list = await this.devices.listHID(target.vid, target.pid ?? 0);
+                if (list.length !== 1) {
+                    throw new Error(`Exactly one HID device required; found ${list.length}`);
+                }
+                if (!list[0].accessible) {
+                    throw new Error("HID device is not accessible");
+                }
+                target.path = list[0].path;
+            }
+        }
+        const probe = await this.run(target, input.timeoutMs ?? 10000, "query-rte 0", signal);
+        if (!probe.success) {
+            return { ...probe };
+        }
+        const targetId = `target-${++this.next}`;
+        this.targets.set(targetId, target);
+        return { target: { targetId, ...target }, probe };
+    }
+    /** Returns connection settings for targets registered in this process. */
+    list() {
+        return {
+            targets: [...this.targets].map(([targetId, target]) => ({
+                targetId,
+                ...target,
+            })),
+        };
+    }
+    /** Deletes a registered target and rejects unknown IDs. */
+    delete(targetId) {
+        if (!this.targets.delete(targetId)) {
+            throw new Error("unknown targetId");
+        }
+        return { targetId, deleted: true };
+    }
+    /** Validates a ROM request and executes it against a registered target. */
+    async rom(name, raw, signal) {
+        const { input, command } = await buildROM(name, raw);
+        const target = this.targets.get(input.targetId);
+        if (!target) {
+            throw new Error("unknown targetId");
+        }
+        return {
+            ...(await this.run(target, input.timeoutMs ?? defaultTimeout(name), command, signal)),
+        };
+    }
+    /** Resolves a compatible CMD and executes the transport-specific ROM arguments. */
+    async run(target, timeout, command, signal) {
+        const { mfgCmdPath = "" } = await this.store.load();
+        const validation = await this.validate(mfgCmdPath, signal);
+        if (!validation.compatible) {
+            throw new Error(`Manufacturing command is not ready: ${validation.message}`);
+        }
+        return this.runner.run(mfgCmdPath, buildArgs(target, timeout, command), timeout + 5000, signal);
+    }
+}
+//# sourceMappingURL=hpm-mfg-service.js.map

package/dist/hpm-mfg-service.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/main.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";
+import { createServer } from "./mcp/server.js";
+/** CLI arguments select the stdio transport; stdout remains reserved for MCP. */
+const args = process.argv.slice(2);
+if (args.length === 0 || args.includes("--help")) {
+    console.error("Usage: hpmmfgctl mcp | hpmmfgctl serve --stdio");
+}
+else if ((args.length === 1 && args[0] === "mcp") ||
+    (args.length === 2 && args[0] === "serve" && args[1] === "--stdio")) {
+    const server = createServer();
+    for (const signal of ["SIGINT", "SIGTERM"]) {
+        process.once(signal, () => {
+            void server.close();
+        });
+    }
+    await server.connect(new StdioServerTransport());
+}
+else {
+    console.error("Usage: hpmmfgctl mcp | hpmmfgctl serve --stdio");
+    process.exitCode = 1;
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,iFAAiF;AACjF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IACjD,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;AAClE,CAAC;KAAM,IACL,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC;IACxC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,EACnE,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;YACxB,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACnD,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAChE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/mcp/configuration.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/server";
+import type { Service } from "../hpm-mfg-service.js";
+/** Registers configuration tools without accessing files or starting CMD processes. */
+export declare function registerConfigurationTools(server: McpServer, service: Service): void;

package/dist/mcp/configuration.js

@@ -0,0 +1,30 @@
+import { cmdSetSchema, emptyInputSchema } from "./schemas.js";
+import { registerTool } from "./registration.js";
+/** Registers configuration tools without accessing files or starting CMD processes. */
+export function registerConfigurationTools(server, service) {
+    registerTool(server, "mfg.doctor", {
+        description: "Refresh manufacturing command compatibility and report configuration",
+        inputSchema: emptyInputSchema,
+        readOnly: true,
+        destructive: false,
+    }, (_input, signal) => service.doctor(signal));
+    registerTool(server, "mfg.get", {
+        description: "Get configured CMD path",
+        inputSchema: emptyInputSchema,
+        readOnly: true,
+        destructive: false,
+    }, async () => ({ ...(await service.store.load()) }));
+    registerTool(server, "mfg.set", {
+        description: "Validate and save the installed CMD absolute path",
+        inputSchema: cmdSetSchema,
+        readOnly: false,
+        destructive: false,
+    }, async (input, signal) => ({ ...(await service.set(input.path, signal)) }));
+    registerTool(server, "mfg.clear", {
+        description: "Clear configured CMD path",
+        inputSchema: emptyInputSchema,
+        readOnly: false,
+        destructive: false,
+    }, () => service.clear());
+}
+//# sourceMappingURL=configuration.js.map

package/dist/mcp/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../src/mcp/configuration.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,uFAAuF;AACvF,MAAM,UAAU,0BAA0B,CAAC,MAAiB,EAAE,OAAgB;IAC5E,YAAY,CACV,MAAM,EACN,YAAY,EACZ;QACE,WAAW,EAAE,sEAAsE;QACnF,WAAW,EAAE,gBAAgB;QAC7B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,KAAK;KACnB,EACD,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAC3C,CAAC;IAEF,YAAY,CACV,MAAM,EACN,SAAS,EACT;QACE,WAAW,EAAE,yBAAyB;QACtC,WAAW,EAAE,gBAAgB;QAC7B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,KAAK;KACnB,EACD,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAClD,CAAC;IAEF,YAAY,CACV,MAAM,EACN,SAAS,EACT;QACE,WAAW,EAAE,mDAAmD;QAChE,WAAW,EAAE,YAAY;QACzB,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,KAAK;KACnB,EACD,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAC1E,CAAC;IAEF,YAAY,CACV,MAAM,EACN,WAAW,EACX;QACE,WAAW,EAAE,2BAA2B;QACxC,WAAW,EAAE,gBAAgB;QAC7B,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,KAAK;KACnB,EACD,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CACtB,CAAC;AACJ,CAAC"}

package/dist/mcp/discovery.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/server";
+import type { Service } from "../hpm-mfg-service.js";
+/** Registers OS discovery and process-local target management tools. */
+export declare function registerDiscoveryTools(server: McpServer, service: Service): void;

package/dist/mcp/discovery.js

@@ -0,0 +1,30 @@
+import { deviceDiscoverSchema, emptyInputSchema, targetCreateSchema, targetDeleteSchema, } from "./schemas.js";
+import { registerTool } from "./registration.js";
+/** Registers OS discovery and process-local target management tools. */
+export function registerDiscoveryTools(server, service) {
+    registerTool(server, "device.discover", {
+        description: "Discover serial or HID devices using OS interfaces",
+        inputSchema: deviceDiscoverSchema,
+        readOnly: true,
+        destructive: false,
+    }, (input) => service.discover(input.transport, input.vid, input.pid));
+    registerTool(server, "device.create", {
+        description: "Probe with query-rte 0 and register an in-process ROM target",
+        inputSchema: targetCreateSchema,
+        readOnly: false,
+        destructive: false,
+    }, (input, signal) => service.create(input, signal));
+    registerTool(server, "device.list", {
+        description: "List registered targets",
+        inputSchema: emptyInputSchema,
+        readOnly: true,
+        destructive: false,
+    }, () => service.list());
+    registerTool(server, "device.delete", {
+        description: "Delete registered target",
+        inputSchema: targetDeleteSchema,
+        readOnly: false,
+        destructive: false,
+    }, (input) => service.delete(input.targetId));
+}
+//# sourceMappingURL=discovery.js.map

package/dist/mcp/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/mcp/discovery.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,wEAAwE;AACxE,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,OAAgB;IACxE,YAAY,CACV,MAAM,EACN,iBAAiB,EACjB;QACE,WAAW,EAAE,oDAAoD;QACjE,WAAW,EAAE,oBAAoB;QACjC,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,KAAK;KACnB,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CACnE,CAAC;IAEF,YAAY,CACV,MAAM,EACN,eAAe,EACf;QACE,WAAW,EAAE,8DAA8D;QAC3E,WAAW,EAAE,kBAAkB;QAC/B,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,KAAK;KACnB,EACD,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CACjD,CAAC;IAEF,YAAY,CACV,MAAM,EACN,aAAa,EACb;QACE,WAAW,EAAE,yBAAyB;QACtC,WAAW,EAAE,gBAAgB;QAC7B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,KAAK;KACnB,EACD,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CACrB,CAAC;IAEF,YAAY,CACV,MAAM,EACN,eAAe,EACf;QACE,WAAW,EAAE,0BAA0B;QACvC,WAAW,EAAE,kBAAkB;QAC/B,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,KAAK;KACnB,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAC1C,CAAC;AACJ,CAAC"}