@intelligentelectron/universal-netlist 0.0.12

package/dist/circuit-traversal.js

@@ -0,0 +1,299 @@
+/**
+ * Circuit traversal utilities for netlist analysis
+ * Pure functions for identifying power/ground nets and passive components
+ */
+import { createHash } from "crypto";
+import { getPinNet } from "./types.js";
+// Regex patterns for net classification
+const GROUND_NET_PATTERN = /^(GND|VSS|AGND|DGND|PGND|SGND|CGND)$/i;
+const POWER_NET_PATTERN = /^(VCC\w*|VDD\w*|VIN\w*|VOUT\w*|VBAT\w*|VBUS\w*|VSYS\w*|PWR_\w+|RAIL_\w+|PP\w*|PN\w*|LD_PP\w*|LD_PN\w*|[+-]?\d+V\d*\w*|[+-].+)$/i;
+const STOP_NET_PATTERN = /^(GND|VSS|AGND|DGND|PGND|SGND|CGND|VCC\w*|VDD\w*|VIN\w*|VOUT\w*|VBAT\w*|VBUS\w*|VSYS\w*|PWR_\w+|RAIL_\w+|PP\w*|PN\w*|LD_PP\w*|LD_PN\w*|[+-]?\d+V\d*\w*|[+-].+)$/i;
+const DNS_PATTERN = /\b(DNS|DNP|DNF|DNI)\b|DO\s*NOT\s*(STUFF|POPULATE|INSTALL)|NOT\s*POPULATED|NO\s*POP/i;
+/**
+ * Check if a net name matches the ground pattern.
+ */
+export const isGroundNet = (netName) => GROUND_NET_PATTERN.test(netName);
+/**
+ * Check if a net name matches the power pattern.
+ */
+export const isPowerNet = (netName) => POWER_NET_PATTERN.test(netName);
+/**
+ * Check if a net name matches the stop pattern (power or ground).
+ */
+export const isStopNet = (netName) => STOP_NET_PATTERN.test(netName);
+/**
+ * Determine if a component is a traversable passive (R/RS, L, C, FB).
+ */
+export const isPassive = (refdes) => {
+    const refdesUpper = refdes.toUpperCase();
+    return (refdesUpper.startsWith("RS") ||
+        refdesUpper.startsWith("R") ||
+        refdesUpper.startsWith("FR") ||
+        refdesUpper.startsWith("L") ||
+        refdesUpper.startsWith("C") ||
+        refdesUpper.startsWith("FB"));
+};
+/**
+ * Check if a string is a valid refdes (letters followed by alphanumerics).
+ * Filters out Cadence instance paths like "@DESIGN.SHEET:INS123@PART".
+ */
+export const isValidRefdes = (refdes) => /^[A-Z][A-Z0-9_]*$/i.test(refdes);
+/**
+ * Extract a refdes prefix (letters only).
+ */
+export const getRefdesPrefix = (refdes) => {
+    const match = refdes.toUpperCase().match(/^[A-Z]+/);
+    return match ? match[0] : refdes.toUpperCase();
+};
+/**
+ * Check if a refdes matches a prefix filter.
+ */
+export const matchesRefdesType = (refdes, type) => {
+    const refdesUpper = refdes.toUpperCase();
+    const typeUpper = type.toUpperCase();
+    return refdesUpper.startsWith(typeUpper);
+};
+/**
+ * Detect Do Not Stuff components using common markers.
+ */
+export const isDnsComponent = (component) => {
+    if (!component)
+        return false;
+    const haystack = `${component.mpn ?? ""} ${component.description ?? ""} ${component.comment ?? ""}`;
+    return DNS_PATTERN.test(haystack);
+};
+/**
+ * Generate a natural sort key for strings with numbers.
+ * Allows proper sorting like: U1, U2, U10 (instead of U1, U10, U2)
+ */
+export const naturalSortKey = (s) => {
+    const str = String(s);
+    const parts = str.split(/(\d+)/);
+    return parts.map((part) => {
+        const num = parseInt(part, 10);
+        return isNaN(num) ? part.toLowerCase() : num;
+    });
+};
+/**
+ * Natural sort comparator function.
+ * Usage: array.sort(naturalSort)
+ */
+export const naturalSort = (a, b) => {
+    const aKey = naturalSortKey(a);
+    const bKey = naturalSortKey(b);
+    for (let i = 0; i < Math.min(aKey.length, bKey.length); i++) {
+        const aVal = aKey[i];
+        const bVal = bKey[i];
+        if (aVal < bVal)
+            return -1;
+        if (aVal > bVal)
+            return 1;
+    }
+    return aKey.length - bKey.length;
+};
+/**
+ * Compute a stable hash for a circuit.
+ * Components with the same XNET produce identical hashes regardless of query starting point.
+ */
+export const computeCircuitHash = (components) => {
+    if (!components || components.length === 0) {
+        return "0".repeat(16);
+    }
+    const sortedComponents = [...components].sort((a, b) => naturalSort(a.refdes, b.refdes));
+    const canonicalForm = sortedComponents.map((comp) => ({
+        refdes: comp.refdes,
+        mpn: comp.mpn,
+        connections: comp.connections
+            .map((conn) => ({
+            pins: [...conn.pins].sort(naturalSort),
+            net: conn.net,
+        }))
+            .sort((a, b) => a.net.localeCompare(b.net)),
+    }));
+    const canonicalJson = JSON.stringify(canonicalForm);
+    const hash = createHash("sha256").update(canonicalJson).digest("hex");
+    return hash.substring(0, 16);
+};
+/**
+ * Group flat pin connections by component (refdes).
+ * Consolidates multiple pin entries for the same component.
+ * Aggregates pins by net - multiple pins on the same net are grouped together.
+ */
+const groupCircuitPins = (flat, visitedNets, skipped) => {
+    const byRefdes = new Map();
+    for (const entry of flat) {
+        let comp = byRefdes.get(entry.refdes);
+        if (!comp) {
+            comp = {
+                refdes: entry.refdes,
+                mpn: entry.mpn,
+                description: entry.description,
+                comment: entry.comment,
+                value: entry.value,
+                dns: entry.dns,
+                netToPins: new Map(),
+            };
+            byRefdes.set(entry.refdes, comp);
+        }
+        if (!comp.netToPins.has(entry.net)) {
+            comp.netToPins.set(entry.net, []);
+        }
+        const pinsForNet = comp.netToPins.get(entry.net);
+        if (!pinsForNet.includes(entry.pin)) {
+            pinsForNet.push(entry.pin);
+        }
+    }
+    const components = [];
+    for (const comp of byRefdes.values()) {
+        const connections = [];
+        for (const [net, pinList] of comp.netToPins.entries()) {
+            connections.push({
+                net,
+                pins: pinList.sort(naturalSort),
+            });
+        }
+        connections.sort((a, b) => naturalSort(a.pins[0] || "", b.pins[0] || ""));
+        components.push({
+            refdes: comp.refdes,
+            mpn: comp.mpn,
+            description: comp.description,
+            comment: comp.comment,
+            value: comp.value,
+            dns: comp.dns,
+            connections,
+        });
+    }
+    return {
+        components,
+        visited_nets: visitedNets,
+        skipped,
+    };
+};
+/**
+ * Traverse circuit from a starting net, following passive components.
+ * Uses BFS to explore connections through R, L, C, FB components.
+ * Stops at active components and power/ground nets.
+ */
+export const traverseCircuitFromNet = (startNet, nets, components, options = {}) => {
+    if (!startNet || !nets[startNet]) {
+        return { components: [], visited_nets: [], skipped: {} };
+    }
+    const skipTypes = (options.skipTypes ?? []).map((type) => type.trim().toUpperCase());
+    const includeDns = options.includeDns ?? false;
+    const skipped = {};
+    const skippedComponents = new Set();
+    const shouldSkipComponent = (refdes, _component, isDns) => {
+        if (!includeDns && isDns) {
+            return true;
+        }
+        const refdesUpper = refdes.toUpperCase();
+        const matchedType = skipTypes.find((type) => refdesUpper.startsWith(type));
+        if (matchedType) {
+            if (!skippedComponents.has(refdes)) {
+                skippedComponents.add(refdes);
+                skipped[matchedType] = (skipped[matchedType] || 0) + 1;
+            }
+            return true;
+        }
+        return false;
+    };
+    const visitedNets = new Set([startNet]);
+    const visitedPins = new Set();
+    const queue = [startNet];
+    const flatCircuit = [];
+    while (queue.length > 0) {
+        const currentNet = queue.shift();
+        const netConnections = nets[currentNet] || {};
+        for (const [refdes, pins] of Object.entries(netConnections)) {
+            const comp = components[refdes];
+            const dns = isDnsComponent(comp);
+            if (shouldSkipComponent(refdes, comp, dns)) {
+                continue;
+            }
+            const dnsFlag = includeDns && dns ? true : undefined;
+            const pinArray = Array.isArray(pins) ? pins : [pins];
+            for (const pin of pinArray) {
+                const pinId = `${refdes}:${pin}`;
+                if (visitedPins.has(pinId))
+                    continue;
+                visitedPins.add(pinId);
+                flatCircuit.push({
+                    refdes,
+                    pin,
+                    net: currentNet,
+                    mpn: comp?.mpn,
+                    description: comp?.description,
+                    comment: comp?.comment,
+                    value: comp?.value,
+                    dns: dnsFlag,
+                });
+                if (comp?.pins && isPassive(refdes)) {
+                    for (const [otherPin, otherNet] of Object.entries(comp.pins)) {
+                        if (otherPin === pin)
+                            continue;
+                        const otherPinId = `${refdes}:${otherPin}`;
+                        if (visitedPins.has(otherPinId))
+                            continue;
+                        visitedPins.add(otherPinId);
+                        const otherNetName = getPinNet(otherNet);
+                        flatCircuit.push({
+                            refdes,
+                            pin: otherPin,
+                            net: otherNetName,
+                            mpn: comp?.mpn,
+                            description: comp?.description,
+                            comment: comp?.comment,
+                            value: comp?.value,
+                            dns: dnsFlag,
+                        });
+                        if (visitedNets.has(otherNetName))
+                            continue;
+                        visitedNets.add(otherNetName);
+                        if (isStopNet(otherNetName))
+                            continue;
+                        const otherNetConns = nets[otherNetName] || {};
+                        let hasPassiveToFollow = false;
+                        for (const [otherRefdes] of Object.entries(otherNetConns)) {
+                            const otherComp = components[otherRefdes];
+                            const otherDns = isDnsComponent(otherComp);
+                            if (shouldSkipComponent(otherRefdes, otherComp, otherDns)) {
+                                continue;
+                            }
+                            const otherDnsFlag = includeDns && otherDns ? true : undefined;
+                            if (isPassive(otherRefdes)) {
+                                hasPassiveToFollow = true;
+                            }
+                            else {
+                                const pinsOnNet = otherNetConns[otherRefdes];
+                                const pinsArray = Array.isArray(pinsOnNet)
+                                    ? pinsOnNet
+                                    : [pinsOnNet];
+                                for (const activePin of pinsArray) {
+                                    const activePinId = `${otherRefdes}:${activePin}`;
+                                    if (!visitedPins.has(activePinId)) {
+                                        visitedPins.add(activePinId);
+                                        flatCircuit.push({
+                                            refdes: otherRefdes,
+                                            pin: activePin,
+                                            net: otherNetName,
+                                            mpn: otherComp?.mpn,
+                                            description: otherComp?.description,
+                                            comment: otherComp?.comment,
+                                            value: otherComp?.value,
+                                            dns: otherDnsFlag,
+                                        });
+                                    }
+                                }
+                            }
+                        }
+                        if (hasPassiveToFollow) {
+                            queue.push(otherNetName);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return groupCircuitPins(flatCircuit, Array.from(visitedNets), skipped);
+};
+//# sourceMappingURL=circuit-traversal.js.map

package/dist/circuit-traversal.js.map

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

package/dist/cli/commands.d.ts

@@ -0,0 +1,23 @@
+/**
+ * CLI command handlers for --version, --help, --update, and --uninstall.
+ */
+/**
+ * Print version information.
+ */
+export declare const printVersion: () => void;
+/**
+ * Print help message.
+ */
+export declare const printHelp: () => void;
+/**
+ * Handle --update command.
+ * Checks for updates and installs if available.
+ * For npm installs, directs users to use npm update instead.
+ */
+export declare const handleUpdateCommand: () => Promise<void>;
+/**
+ * Handle --uninstall command.
+ * Removes the binary and PATH entries from shell rc files.
+ */
+export declare const handleUninstallCommand: () => Promise<void>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/cli/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH;;GAEG;AACH,eAAO,MAAM,YAAY,QAAO,IAE/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,QAAO,IA2B5B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAAa,OAAO,CAAC,IAAI,CA6DxD,CAAC;AAYF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAa,OAAO,CAAC,IAAI,CAmC3D,CAAC"}

package/dist/cli/commands.js

@@ -0,0 +1,140 @@
+/**
+ * CLI command handlers for --version, --help, --update, and --uninstall.
+ */
+import { existsSync, rmSync } from "node:fs";
+import { dirname } from "node:path";
+import { VERSION, GITHUB_REPO, BINARY_NAME } from "../version.js";
+import { checkForUpdate, performUpdate, isNpmInstall } from "./updater.js";
+import { confirm } from "./prompts.js";
+import { removeFromPath } from "./shell.js";
+/**
+ * Print version information.
+ */
+export const printVersion = () => {
+    console.log(`${BINARY_NAME} v${VERSION}`);
+};
+/**
+ * Print help message.
+ */
+export const printHelp = () => {
+    console.log(`
+${BINARY_NAME} v${VERSION}
+
+MCP server for querying EDA netlists. Supports Cadence and Altium Designer formats.
+
+USAGE:
+  ${BINARY_NAME} [OPTIONS]
+
+OPTIONS:
+  --version, -v    Print version and exit
+  --help, -h       Show this help message
+  --update         Check for and install updates
+  --uninstall      Remove binary and PATH entries
+  --no-update      Disable auto-update check on startup
+
+INSTALLATION:
+  curl -fsSL https://raw.githubusercontent.com/${GITHUB_REPO}/main/install.sh | bash
+
+ENVIRONMENT:
+  UNIVERSAL_NETLIST_MCP_NO_UPDATE=1    Disable auto-updates
+
+MORE INFO:
+  https://github.com/${GITHUB_REPO}
+`.trim());
+};
+/**
+ * Handle --update command.
+ * Checks for updates and installs if available.
+ * For npm installs, directs users to use npm update instead.
+ */
+export const handleUpdateCommand = async () => {
+    // For npm installs, provide npm-specific update instructions
+    if (isNpmInstall()) {
+        console.log(`Checking for updates...`);
+        const check = await checkForUpdate();
+        if (check.error) {
+            console.error(`Error checking for updates: ${check.error}`);
+            process.exit(1);
+        }
+        if (!check.updateAvailable) {
+            console.log(`Already at latest version (${VERSION})`);
+            return;
+        }
+        console.log(`Update available: ${VERSION} -> ${check.latestVersion}`);
+        console.log("");
+        console.log("To update, run:");
+        console.log("  npm update -g universal-netlist");
+        return;
+    }
+    console.log(`Checking for updates...`);
+    const check = await checkForUpdate();
+    if (check.error) {
+        console.error(`Error checking for updates: ${check.error}`);
+        process.exit(1);
+    }
+    if (!check.updateAvailable) {
+        console.log(`Already at latest version (${VERSION})`);
+        return;
+    }
+    console.log(`Update available: ${VERSION} -> ${check.latestVersion}`);
+    if (!check.downloadUrl) {
+        console.error("No download URL available for your platform");
+        process.exit(1);
+    }
+    const confirmed = await confirm("Install update?");
+    if (!confirmed) {
+        console.log("Update cancelled");
+        return;
+    }
+    console.log("Downloading update...");
+    const result = await performUpdate(check.downloadUrl, check.latestVersion);
+    if (!result.success) {
+        console.error(`Update failed: ${result.error}`);
+        process.exit(1);
+    }
+    console.log(`Updated from ${result.previousVersion} to ${result.newVersion}`);
+    console.log("Please restart to use the new version.");
+};
+/**
+ * Get the path to the current executable.
+ */
+const getCurrentExecutablePath = () => {
+    if (process.execPath.includes("node") || process.execPath.includes("bun")) {
+        return process.argv[1];
+    }
+    return process.execPath;
+};
+/**
+ * Handle --uninstall command.
+ * Removes the binary and PATH entries from shell rc files.
+ */
+export const handleUninstallCommand = async () => {
+    const confirmed = await confirm(`This will remove ${BINARY_NAME} from your system. Continue?`);
+    if (!confirmed) {
+        console.log("Uninstall cancelled");
+        return;
+    }
+    const binaryPath = getCurrentExecutablePath();
+    const binDir = dirname(binaryPath);
+    const installDir = dirname(binDir);
+    // Remove PATH entries from shell rc files
+    console.log("Removing PATH entries...");
+    const modifiedFiles = removeFromPath();
+    if (modifiedFiles.length > 0) {
+        console.log(`Modified: ${modifiedFiles.join(", ")}`);
+    }
+    // Remove install directory
+    console.log(`Removing install directory: ${installDir}`);
+    if (existsSync(installDir)) {
+        try {
+            rmSync(installDir, { recursive: true });
+        }
+        catch (error) {
+            console.error(`Failed to remove directory: ${error instanceof Error ? error.message : error}`);
+            console.log("You may need to remove it manually.");
+        }
+    }
+    console.log("");
+    console.log(`${BINARY_NAME} has been uninstalled.`);
+};
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAS,EAAE;IACrC,OAAO,CAAC,GAAG,CAAC,GAAG,WAAW,KAAK,OAAO,EAAE,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAS,EAAE;IAClC,OAAO,CAAC,GAAG,CACT;EACF,WAAW,KAAK,OAAO;;;;;IAKrB,WAAW;;;;;;;;;;iDAUkC,WAAW;;;;;;uBAMrC,WAAW;CACjC,CAAC,IAAI,EAAE,CACL,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,IAAmB,EAAE;IAC3D,6DAA6D;IAC7D,IAAI,YAAY,EAAE,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QAEvC,MAAM,KAAK,GAAG,MAAM,cAAc,EAAE,CAAC;QAErC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,+BAA+B,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,8BAA8B,OAAO,GAAG,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,OAAO,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAEvC,MAAM,KAAK,GAAG,MAAM,cAAc,EAAE,CAAC;IAErC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,+BAA+B,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,8BAA8B,OAAO,GAAG,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,OAAO,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;IAEtE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChC,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,aAAc,CAAC,CAAC;IAE5E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,eAAe,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9E,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;AACxD,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,wBAAwB,GAAG,GAAW,EAAE;IAC5C,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1E,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,CAAC;AAC1B,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,IAAmB,EAAE;IAC9D,MAAM,SAAS,GAAG,MAAM,OAAO,CAC7B,oBAAoB,WAAW,8BAA8B,CAC9D,CAAC;IACF,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,wBAAwB,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnC,0CAA0C;IAC1C,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IACxC,MAAM,aAAa,GAAG,cAAc,EAAE,CAAC;IACvC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,aAAa,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,2BAA2B;IAC3B,OAAO,CAAC,GAAG,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAC;IACzD,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAChF,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,GAAG,WAAW,wBAAwB,CAAC,CAAC;AACtD,CAAC,CAAC"}

package/dist/cli/prompts.d.ts

@@ -0,0 +1,10 @@
+/**
+ * User interaction utilities for CLI prompts.
+ */
+/**
+ * Prompt user for confirmation with a y/N prompt.
+ * @param question - The question to ask the user
+ * @returns Promise resolving to true if user confirms, false otherwise
+ */
+export declare const confirm: (question: string) => Promise<boolean>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/cli/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/cli/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,OAAO,CAY/D,CAAC"}

package/dist/cli/prompts.js

@@ -0,0 +1,22 @@
+/**
+ * User interaction utilities for CLI prompts.
+ */
+import * as readline from "node:readline";
+/**
+ * Prompt user for confirmation with a y/N prompt.
+ * @param question - The question to ask the user
+ * @returns Promise resolving to true if user confirms, false otherwise
+ */
+export const confirm = async (question) => {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(`${question} [y/N] `, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+        });
+    });
+};
+//# sourceMappingURL=prompts.js.map

package/dist/cli/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/cli/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,QAAgB,EAAoB,EAAE;IAClE,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,GAAG,QAAQ,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;YAC3C,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/cli/shell.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shell rc file manipulation for PATH integration.
+ */
+/**
+ * Get shell configuration file paths to check for PATH entries.
+ * @returns Array of paths to shell rc files
+ */
+export declare const getShellRcFiles: () => string[];
+/**
+ * Remove universal-netlist PATH entries from shell rc files.
+ * Looks for "# Universal Netlist MCP Server" comment blocks and removes them.
+ * @returns Array of file paths that were modified
+ */
+export declare const removeFromPath: () => string[];
+//# sourceMappingURL=shell.d.ts.map

package/dist/cli/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/cli/shell.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAO,MAAM,EASxC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,MAAM,EA2CvC,CAAC"}

package/dist/cli/shell.js

@@ -0,0 +1,66 @@
+/**
+ * Shell rc file manipulation for PATH integration.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+/**
+ * Get shell configuration file paths to check for PATH entries.
+ * @returns Array of paths to shell rc files
+ */
+export const getShellRcFiles = () => {
+    const home = os.homedir();
+    return [
+        path.join(home, ".zshrc"),
+        path.join(home, ".bashrc"),
+        path.join(home, ".bash_profile"),
+        path.join(home, ".profile"),
+        path.join(home, ".config", "fish", "config.fish"),
+    ];
+};
+/**
+ * Remove universal-netlist PATH entries from shell rc files.
+ * Looks for "# Universal Netlist MCP Server" comment blocks and removes them.
+ * @returns Array of file paths that were modified
+ */
+export const removeFromPath = () => {
+    const modified = [];
+    for (const rcFile of getShellRcFiles()) {
+        if (!fs.existsSync(rcFile))
+            continue;
+        const content = fs.readFileSync(rcFile, "utf-8");
+        const lines = content.split("\n");
+        const filtered = [];
+        let i = 0;
+        let changed = false;
+        while (i < lines.length) {
+            const line = lines[i];
+            // Skip "# Universal Netlist MCP Server" comment and the following export/fish_add_path line
+            if (line.trim() === "# Universal Netlist MCP Server") {
+                changed = true;
+                i++; // Skip comment
+                // Skip the next line if it's the PATH export
+                if (i < lines.length && lines[i].includes("universal-netlist")) {
+                    i++;
+                }
+                // Skip trailing empty line if present
+                if (i < lines.length && lines[i].trim() === "") {
+                    i++;
+                }
+                continue;
+            }
+            filtered.push(line);
+            i++;
+        }
+        if (changed) {
+            // Remove trailing newlines
+            while (filtered.length > 0 && filtered[filtered.length - 1] === "") {
+                filtered.pop();
+            }
+            fs.writeFileSync(rcFile, filtered.join("\n") + "\n");
+            modified.push(rcFile);
+        }
+    }
+    return modified;
+};
+//# sourceMappingURL=shell.js.map

package/dist/cli/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/cli/shell.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAa,EAAE;IAC5C,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC;KAClD,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAa,EAAE;IAC3C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,SAAS;QAErC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,4FAA4F;YAC5F,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,gCAAgC,EAAE,CAAC;gBACrD,OAAO,GAAG,IAAI,CAAC;gBACf,CAAC,EAAE,CAAC,CAAC,eAAe;gBACpB,6CAA6C;gBAC7C,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;oBAC/D,CAAC,EAAE,CAAC;gBACN,CAAC;gBACD,sCAAsC;gBACtC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;oBAC/C,CAAC,EAAE,CAAC;gBACN,CAAC;gBACD,SAAS;YACX,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC,EAAE,CAAC;QACN,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,2BAA2B;YAC3B,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;gBACnE,QAAQ,CAAC,GAAG,EAAE,CAAC;YACjB,CAAC;YACD,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YACrD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}