labanalyze 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fei Fang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,183 @@
+# labanalyze — Azure Local Lab MCP Server
+
+`labanalyze` is an MCP server that gives AI assistants (Copilot CLI, Claude, etc.) direct access to Azure Local lab **Deployment Virtual Machines (DVMs)** and cluster nodes via PowerShell remoting (WinRM). It exposes 15 tools covering connection management, cluster health, log retrieval, and arbitrary PowerShell execution — no credentials are ever stored on disk.
+
+## Architecture
+
+```
+┌──────────────┐     stdio      ┌──────────────┐    WinRM/PS     ┌─────────┐
+│ Copilot CLI  │ ◄────────────► │  labanalyze  │ ──────────────► │   DVM   │  (discovery only)
+│  (or other   │   (MCP proto)  │  MCP server  │  (Administrator)└─────────┘
+│  MCP client) │                │              │    WinRM/PS     ┌──────────────┐
+└──────────────┘                │   (Node.js,  │ ──────────────► │ Cluster Node │  (direct access)
+                                │   spawns     │  (domain\hci-   │ ⭐ Seed Node │  (deploy logs)
+                                │    pwsh)     │  deploymentuser)│              │
+                                └──────────────┘                 └──────────────┘
+```
+
+The server runs as a Node.js process started by the MCP client. It manages a single long-lived `pwsh` (or Windows `powershell.exe`) child process that holds persistent `PSSession` connections — one to the DVM (for AD/cluster discovery, opened as `Administrator`) and one per cluster node (opened lazily as `<domain>\hcideploymentuser` for direct queries). The WinRM client lives inside the `pwsh` child; Node communicates with it over stdin/stdout via a delimiter-framed protocol. Credentials live only in process memory.
+
+## Quick start (recommended)
+
+Add the following snippet to your MCP configuration (e.g. `~/.copilot/mcp-config.json`):
+
+```json
+{
+  "mcpServers": {
+    "labanalyze": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "labanalyze"]
+    }
+  }
+}
+```
+
+> **Note**: This works once the package is published to npm. For local development from the tarball, see [Build from source](#build-from-source).
+
+## Prerequisites
+
+- Node.js 18+
+- PowerShell 7+ (`pwsh`) recommended; on Windows the server falls back to `powershell.exe` automatically
+- Network access to the lab (VPN connected)
+- DVM password (provided at runtime via `connect_to_dvm` — never stored)
+
+## Lab conventions
+
+- **DVM** is used for discovery only — finding the cluster name/IP and node names/IPs. Accessed as `Administrator` (no domain prefix).
+- **Cluster nodes** are accessed **directly** via WinRM using `<domain>\hcideploymentuser` with the same password as the DVM.
+- **Seed node** is the first node alphabetically — Azure Local deployment logs are always at `C:\CloudDeployment\Logs` on this node.
+- Cluster objects in AD have names like `*-cl` or `s-cluster*`.
+
+## Usage
+
+### 1. Connect to DVM (just IP + password)
+```
+User: Connect to the DVM at 10.57.64.5 with password <secret>
+→ connect_to_dvm(ip="10.57.64.5", password="...")
+```
+Domain is auto-discovered. Username defaults to `Administrator`.
+
+### 2. List cluster nodes
+```
+User: List the cluster nodes
+→ list_cluster_nodes()
+```
+Returns cluster name, node IPs, and identifies the seed node.
+
+### 3. Check cluster status (defaults to seed node)
+```
+User: What's the cluster status?
+→ get_cluster_status()    ← automatically uses seed node
+```
+
+### 4. Get ECE deployment logs (from seed node)
+```
+User: Show the last 100 lines of ECE logs
+→ get_ece_logs(tail_lines=100)    ← automatically targets seed node
+```
+
+### 5. Run arbitrary commands
+```
+User: Run Get-Process on node hci-node-1
+→ run_command_on_node(node="hci-node-1", command="Get-Process")
+```
+
+### 6. Disconnect
+```
+User: Disconnect from the lab
+→ disconnect_from_dvm()
+```
+
+## Available tools
+
+| Category | Tool | Description |
+|----------|------|-------------|
+| **Connection** | `connect_to_dvm` | Connect to DVM (IP + password, username defaults to Administrator) |
+| | `disconnect_from_dvm` | Disconnect and clear credentials from memory |
+| | `get_connection_status` | Show connection state, cluster info, seed node |
+| | `list_cluster_nodes` | Discover cluster + nodes from DVM (marks seed node) |
+| **Cluster** | `get_cluster_status` | Overall cluster health (defaults to seed node) |
+| | `get_cluster_resources` | List cluster resources and status |
+| | `get_cluster_network_info` | Cluster networks and interfaces |
+| | `get_node_info` | Node details — OS, uptime, hardware |
+| | `get_storage_info` | Storage pools and virtual disks |
+| **Logs** | `get_event_logs` | Windows Event Log entries (defaults to seed node) |
+| | `get_ece_logs` | ECE deployment logs from `C:\CloudDeployment\Logs` |
+| | `get_deployment_status` | Azure Local deployment action plan status |
+| | `get_file_content` | Read any file from a cluster node |
+| **Commands** | `run_command_on_dvm` | Execute arbitrary PowerShell on DVM |
+| | `run_command_on_node` | Execute arbitrary PowerShell on cluster node (direct) |
+
+## Security
+
+- **No hardcoded credentials** — password passed as tool parameter at runtime
+- **In-memory only** — credentials and sessions exist only in process memory
+- **No config file secrets** — MCP config contains only the command to start the server
+- **Lab/test use only** — the general-purpose command tools execute arbitrary PowerShell by design
+
+## Troubleshooting
+
+### "Not connected to a DVM"
+Call `connect_to_dvm` first with the DVM IP and password.
+
+### WinRM connection fails
+- Ensure you are connected to the lab VPN
+- Verify the DVM IP is correct and reachable (`ping <ip>`)
+- Check that WinRM is enabled on the DVM (port 5985 for HTTP)
+
+### "No seed node discovered"
+Call `list_cluster_nodes` after connecting to the DVM. This discovers the cluster and its nodes.
+
+### "Access denied" on cluster nodes
+- Cluster nodes are accessed directly as `<domain>\hcideploymentuser`
+- Domain is auto-discovered from the DVM — ensure the DVM is domain-joined
+- The password is the same as the DVM password
+
+### "PowerShell host not found"
+Install PowerShell 7 (`pwsh`) from https://github.com/PowerShell/PowerShell/releases, or run on Windows where `powershell.exe` is available (the server falls back automatically).
+
+## Build from source
+
+```bash
+cd labanalyzemcp
+npm install
+npm run build
+node dist/index.js
+```
+
+Tests run with `npm test` (53 tests across formatting, state, powershellHost, and connectionManager).
+
+## Project structure
+
+```
+labanalyzemcp/
+├── package.json              # name=labanalyze, bin → dist/index.js
+├── tsconfig.json
+├── README.md
+├── .gitignore
+├── .npmignore
+├── src/
+│   ├── index.ts              # bin entry: #!/usr/bin/env node + main()
+│   ├── server.ts             # MCP server bootstrap, registers tools, stdio transport
+│   ├── state.ts              # ServerState, DvmConnectionInfo, CaseInsensitiveMap
+│   ├── connection/
+│   │   ├── powershellHost.ts # long-lived pwsh child + delimiter protocol
+│   │   └── connectionManager.ts  # DVM/node PSSession lifecycle, AD discovery
+│   ├── helpers/
+│   │   └── formatting.ts     # markdown output helpers
+│   └── tools/
+│       ├── _helpers.ts       # requireConnected / resolveNode (shared)
+│       ├── connectionTools.ts # connect/disconnect/status/list_cluster_nodes (4)
+│       ├── clusterTools.ts   # cluster status/resources/network/node/storage (5)
+│       ├── logTools.ts       # event/ECE/deployment-status/file-content (4)
+│       └── commandTools.ts   # arbitrary command on DVM / node (2)
+└── tests/
+    ├── state.test.ts
+    ├── formatting.test.ts
+    ├── powershellHost.test.ts
+    ├── connectionManager.test.ts
+    └── fixtures/
+        └── mock-pwsh.mjs     # Node-based pwsh stand-in for unit tests
+```
+

package/dist/connection/connectionManager.js

@@ -0,0 +1,163 @@
+/** Wraps a user-supplied string value in single quotes, doubling any embedded single quotes. */
+function psQuote(s) {
+    return "'" + s.replaceAll("'", "''") + "'";
+}
+export class ConnectionManager {
+    state;
+    _host;
+    constructor(state, host) {
+        this.state = state;
+        this._host = host;
+    }
+    get isConnected() {
+        return this.state.connected && this._host.isAlive();
+    }
+    ensureConnected() {
+        if (!this.isConnected) {
+            throw new Error("Not connected to a DVM. Call connect_to_dvm first.");
+        }
+    }
+    async connect(info) {
+        this.state.connectionInfo = info;
+        try {
+            if (!this._host.isAlive()) {
+                await this._host.start();
+            }
+            await this._host.setEnvVar("LABMCP_PWD", info.password);
+            const usernameQ = psQuote(info.username);
+            const ipQ = psQuote(info.ip);
+            const sslSwitch = info.useSsl ? " -UseSSL" : "";
+            const connectScript = [
+                `$script:DvmCred = New-Object System.Management.Automation.PSCredential(${usernameQ}, (ConvertTo-SecureString $env:LABMCP_PWD -AsPlainText -Force))`,
+                `Remove-Item Env:\\LABMCP_PWD -ErrorAction SilentlyContinue`,
+                `$so = New-PSSessionOption -SkipCACheck -SkipCNCheck -SkipRevocationCheck -OperationTimeout 60000 -OpenTimeout 30000`,
+                `$script:DvmSession = New-PSSession -ComputerName ${ipQ} -Port ${info.winRmPort} -Authentication Negotiate -Credential $script:DvmCred -SessionOption $so${sslSwitch}`,
+                `Invoke-Command -Session $script:DvmSession -ScriptBlock { hostname }`,
+            ].join("\n");
+            const result = await this._host.runScript(connectScript);
+            if (result.stderr || !result.stdout.trim()) {
+                this.state.connected = false;
+                this.state.lastError = result.stderr;
+                return `Failed to connect to DVM at ${info.ip}: ${result.stderr}`;
+            }
+            const hostname = result.stdout.trim();
+            // Auto-discover domain from DVM
+            const domainResult = await this._host.runScript(`Invoke-Command -Session $script:DvmSession -ScriptBlock { (Get-CimInstance Win32_ComputerSystem).Domain }`);
+            if (!domainResult.stderr && domainResult.stdout.trim()) {
+                const fqdn = domainResult.stdout.trim();
+                this.state.domain = fqdn.includes(".") ? fqdn.split(".")[0] : fqdn;
+            }
+            this.state.connected = true;
+            this.state.lastError = "";
+            return `Connected to DVM at ${info.ip} (hostname: ${hostname}, domain: ${this.state.domain})`;
+        }
+        catch (ex) {
+            this.state.connected = false;
+            this.state.lastError = ex instanceof Error ? ex.message : String(ex);
+            return `Failed to connect to DVM at ${info.ip}: ${this.state.lastError}`;
+        }
+    }
+    async disconnect() {
+        const ip = this.state.connectionInfo.ip;
+        const disconnectScript = [
+            `if ($script:DvmSession) { Remove-PSSession $script:DvmSession -ErrorAction SilentlyContinue; $script:DvmSession = $null }`,
+            `if ($script:NodeSessions) { $script:NodeSessions.Values | ForEach-Object { Remove-PSSession $_ -ErrorAction SilentlyContinue }; $script:NodeSessions = @{} }`,
+            `$script:DvmCred = $null; $script:ClusterCred = $null`,
+        ].join("\n");
+        await this._host.runScript(disconnectScript);
+        this.state.reset();
+        return `Disconnected from DVM at ${ip}`;
+    }
+    async runOnDvm(command) {
+        this.ensureConnected();
+        return this._host.runScript(`Invoke-Command -Session $script:DvmSession -ScriptBlock { ${command} }`);
+    }
+    async runOnNode(node, command) {
+        this.ensureConnected();
+        const ip = this.state.nodeIpMap.get(node) ?? node;
+        const info = this.state.connectionInfo;
+        const clusterUserQ = psQuote(this.state.clusterQualifiedUsername);
+        const ipQ = psQuote(ip);
+        const sslSwitch = info.useSsl ? " -UseSSL" : "";
+        try {
+            const nodeScript = [
+                `if (-not $script:NodeSessions) { $script:NodeSessions = @{} }`,
+                `if (-not $script:ClusterCred) {`,
+                `  $script:ClusterCred = New-Object System.Management.Automation.PSCredential(${clusterUserQ}, $script:DvmCred.Password)`,
+                `}`,
+                `if (-not $script:NodeSessions[${ipQ}]) {`,
+                `  $so = New-PSSessionOption -SkipCACheck -SkipCNCheck -SkipRevocationCheck -OperationTimeout 60000 -OpenTimeout 30000`,
+                `  $script:NodeSessions[${ipQ}] = New-PSSession -ComputerName ${ipQ} -Port ${info.winRmPort} -Authentication Negotiate -Credential $script:ClusterCred -SessionOption $so${sslSwitch}`,
+                `}`,
+                `Invoke-Command -Session $script:NodeSessions[${ipQ}] -ScriptBlock { ${command} }`,
+            ].join("\n");
+            return await this._host.runScript(nodeScript);
+        }
+        catch (err) {
+            return { stdout: "", stderr: `Failed to connect to node ${node} (${ip}): ${err}`, exitCode: -1 };
+        }
+    }
+    async discoverNodes() {
+        this.ensureConnected();
+        // Query AD for cluster objects matching lab naming patterns (*-cl or s-cluster)
+        // Copied character-for-character from ConnectionManager.cs
+        const clusterQuery = "try { " +
+            "  $clusters = Get-ADComputer -Filter 'Name -like \"*-cl\" -or Name -like \"s-cluster*\"' -Properties IPv4Address -ErrorAction Stop; " +
+            "  $clusters | ForEach-Object { \"$($_.Name)|$($_.IPv4Address)\" } " +
+            "} catch { 'AD_QUERY_FAILED' }";
+        const clusterResult = await this.runOnDvm(clusterQuery);
+        if (clusterResult.exitCode === 0 &&
+            clusterResult.stdout.trim() &&
+            clusterResult.stdout.trim() !== "AD_QUERY_FAILED") {
+            const lines = clusterResult.stdout
+                .trim()
+                .split("\n")
+                .filter((l) => l.trim());
+            for (const line of lines) {
+                const parts = line.trim().split("|");
+                if (parts.length >= 2) {
+                    this.state.clusterName = parts[0].trim();
+                    this.state.clusterIp = parts[1].trim();
+                    break; // Take the first cluster found
+                }
+            }
+        }
+        // Query AD for all computers except DVM and cluster object, to find actual nodes
+        // Copied character-for-character from ConnectionManager.cs
+        const nodesQuery = "try { " +
+            "  $dvmName = $env:COMPUTERNAME; " +
+            "  Get-ADComputer -Filter * -Properties IPv4Address, OperatingSystem -ErrorAction Stop | " +
+            "    Where-Object { $_.Name -ne $dvmName -and $_.Name -notlike '*-cl' -and $_.Name -notlike 's-cluster*' -and $_.OperatingSystem -like '*Azure Stack HCI*' } | " +
+            "    ForEach-Object { \"$($_.Name)|$($_.IPv4Address)\" } " +
+            "} catch { 'AD_QUERY_FAILED' }";
+        const nodesResult = await this.runOnDvm(nodesQuery);
+        if (nodesResult.exitCode === 0 &&
+            nodesResult.stdout.trim() &&
+            nodesResult.stdout.trim() !== "AD_QUERY_FAILED") {
+            const tempMap = new Map();
+            const lines = nodesResult.stdout
+                .trim()
+                .split("\n")
+                .filter((l) => l.trim());
+            for (const line of lines) {
+                const parts = line.trim().split("|");
+                if (parts.length >= 2 && parts[0].trim() && parts[1].trim()) {
+                    tempMap.set(parts[0].trim(), parts[1].trim());
+                }
+            }
+            const sortedNodes = Array.from(tempMap.keys()).sort((a, b) => a.localeCompare(b, undefined, { sensitivity: "base" }));
+            this.state.discoveredNodes = sortedNodes;
+            this.state.nodeIpMap.clear();
+            for (const [name, nodeIp] of tempMap) {
+                this.state.nodeIpMap.set(name, nodeIp);
+            }
+            this.state.seedNode = sortedNodes.length > 0 ? sortedNodes[0] : "";
+            return sortedNodes;
+        }
+        return [];
+    }
+    async dispose() {
+        await this._host.dispose();
+    }
+}
+//# sourceMappingURL=connectionManager.js.map

package/dist/connection/connectionManager.js.map

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

package/dist/connection/powershellHost.js

@@ -0,0 +1,192 @@
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+const DEFAULT_TIMEOUT_MS = 60_000;
+const PS_ARGS = ["-NoProfile", "-NoLogo", "-NonInteractive", "-Command", "-"];
+export class PowerShellHost {
+    _opts;
+    _child;
+    _rlOut;
+    _rlErr;
+    _alive = false;
+    _id = 0;
+    _queue = Promise.resolve();
+    _pendingReject;
+    _lineHandlers = [];
+    constructor(opts) {
+        this._opts = opts ?? {};
+    }
+    _log(msg) {
+        if (this._opts.logger) {
+            this._opts.logger(msg);
+        }
+        else {
+            process.stderr.write(`[pwsh] ${msg}\n`);
+        }
+    }
+    async start() {
+        if (this._child)
+            return;
+        const child = await this._spawnChild();
+        this._child = child;
+        this._alive = true;
+        this._rlOut = createInterface({ input: child.stdout, crlfDelay: Infinity });
+        this._rlErr = createInterface({ input: child.stderr, crlfDelay: Infinity });
+        this._rlErr.on("line", (line) => {
+            this._log(line);
+        });
+        this._rlOut.on("line", (line) => {
+            const trimmed = line.replace(/\r$/, "");
+            for (const handler of this._lineHandlers) {
+                handler(trimmed);
+            }
+        });
+        child.once("exit", (code) => {
+            this._alive = false;
+            if (this._pendingReject) {
+                const reject = this._pendingReject;
+                this._pendingReject = undefined;
+                reject(new Error(`PowerShell host exited (code ${code})`));
+            }
+        });
+    }
+    _spawnChild() {
+        if (this._opts.hostCommand) {
+            const { cmd, args } = this._opts.hostCommand;
+            return new Promise((resolve, reject) => {
+                const child = spawn(cmd, args, { stdio: ["pipe", "pipe", "pipe"] });
+                child.once("error", reject);
+                child.once("spawn", () => {
+                    child.removeListener("error", reject);
+                    resolve(child);
+                });
+            });
+        }
+        return new Promise((resolve, reject) => {
+            const tryFallback = () => {
+                const child2 = spawn("powershell.exe", PS_ARGS, { stdio: ["pipe", "pipe", "pipe"] });
+                child2.once("error", reject);
+                child2.once("spawn", () => {
+                    child2.removeListener("error", reject);
+                    resolve(child2);
+                });
+            };
+            const onError = (err) => {
+                if (err.code === "ENOENT" && process.platform === "win32") {
+                    tryFallback();
+                }
+                else {
+                    reject(err);
+                }
+            };
+            const child1 = spawn("pwsh", PS_ARGS, { stdio: ["pipe", "pipe", "pipe"] });
+            child1.once("error", onError);
+            child1.once("spawn", () => {
+                child1.removeListener("error", onError);
+                resolve(child1);
+            });
+        });
+    }
+    async runScript(script) {
+        const result = this._queue.then(() => this._runScriptImpl(script));
+        this._queue = result.then(() => undefined, () => undefined);
+        return result;
+    }
+    _runScriptImpl(script) {
+        if (!this._alive || !this._child) {
+            return Promise.reject(new Error("PowerShell host is not running"));
+        }
+        const id = ++this._id;
+        const endMarker = `__LABMCP_END__${id}__`;
+        const wrapper = `try { & { ${script} } *>&1 | ForEach-Object { if ($_ -is [System.Management.Automation.ErrorRecord]) { Write-Output ('__LABMCP_ERR__' + $_.ToString()) } else { Write-Output $_ } } } catch { Write-Output ('__LABMCP_ERR__' + $_.ToString()) }\n` +
+            `Write-Output '${endMarker}'\n`;
+        const outLines = [];
+        const errLines = [];
+        const timeoutMs = this._opts.commandTimeoutMs ?? DEFAULT_TIMEOUT_MS;
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const settle = (fn) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timeoutHandle);
+                this._pendingReject = undefined;
+                const idx = this._lineHandlers.indexOf(lineHandler);
+                if (idx >= 0)
+                    this._lineHandlers.splice(idx, 1);
+                fn();
+            };
+            const lineHandler = (line) => {
+                if (line === endMarker) {
+                    settle(() => resolve({
+                        stdout: outLines.join("\n"),
+                        stderr: errLines.join("\n"),
+                        exitCode: errLines.length ? 1 : 0,
+                    }));
+                }
+                else if (line.startsWith("__LABMCP_ERR__")) {
+                    errLines.push(line.slice("__LABMCP_ERR__".length));
+                }
+                else {
+                    outLines.push(line);
+                }
+            };
+            this._lineHandlers.push(lineHandler);
+            this._pendingReject = (err) => {
+                settle(() => reject(err));
+            };
+            const timeoutHandle = setTimeout(() => {
+                this._alive = false;
+                try {
+                    this._child?.kill("SIGKILL");
+                }
+                catch { /* ignore */ }
+                settle(() => reject(new Error("PowerShell command timed out")));
+            }, timeoutMs);
+            try {
+                this._child.stdin.write(wrapper);
+            }
+            catch (err) {
+                settle(() => reject(err instanceof Error ? err : new Error(String(err))));
+            }
+        });
+    }
+    async setEnvVar(name, value) {
+        if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) {
+            throw new Error(`Invalid environment variable name: ${name}`);
+        }
+        const escaped = value.replaceAll("'", "''");
+        await this.runScript(`$env:${name} = '${escaped}'`);
+    }
+    async clearEnvVar(name) {
+        if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) {
+            throw new Error(`Invalid environment variable name: ${name}`);
+        }
+        await this.runScript(`Remove-Item Env:\\${name} -ErrorAction SilentlyContinue`);
+    }
+    isAlive() {
+        return this._alive;
+    }
+    async dispose() {
+        if (!this._alive)
+            return;
+        this._alive = false;
+        const child = this._child;
+        if (!child)
+            return;
+        return new Promise((resolve) => {
+            child.once("close", resolve);
+            try {
+                child.stdin.write("exit\n");
+                child.stdin.end();
+            }
+            catch { /* stdin may already be closed */ }
+            setTimeout(() => {
+                try {
+                    child.kill("SIGKILL");
+                }
+                catch { /* ignore */ }
+            }, 2000);
+        });
+    }
+}
+//# sourceMappingURL=powershellHost.js.map

package/dist/connection/powershellHost.js.map

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

package/dist/helpers/formatting.js

@@ -0,0 +1,61 @@
+export function formatCommandResult(title, stdout, stderr, exitCode) {
+    const parts = [`## ${title}`];
+    parts.push(exitCode !== 0
+        ? `**Status**: ❌ Failed (exit code ${exitCode})`
+        : "**Status**: ✅ Success");
+    if (stdout.trim().length > 0)
+        parts.push(`\n### Output\n\`\`\`\n${stdout.trim()}\n\`\`\``);
+    if (stderr.trim().length > 0)
+        parts.push(`\n### Errors\n\`\`\`\n${stderr.trim()}\n\`\`\``);
+    return parts.join("\n");
+}
+export function formatTable(headers, rows) {
+    if (rows.length === 0)
+        return "(no data)";
+    const lines = [
+        "| " + headers.join(" | ") + " |",
+        "| " + headers.map(() => "---").join(" | ") + " |",
+    ];
+    for (const row of rows)
+        lines.push("| " + row.join(" | ") + " |");
+    return lines.join("\n");
+}
+export function formatConnectionStatus(connected, ip, domain, username, nodes, clusterName, clusterIp, seedNode) {
+    const parts = [
+        "## DVM Connection Status",
+        `**Connected**: ${connected ? "✅ Yes" : "❌ No"}`,
+    ];
+    if (connected) {
+        parts.push(`**DVM IP**: ${ip}`);
+        parts.push(`**Domain**: ${domain === "" ? "(auto-discovering...)" : domain}`);
+        parts.push(`**Username**: ${username}`);
+        if (clusterName !== "")
+            parts.push(`**Cluster**: ${clusterName} (${clusterIp})`);
+        if (seedNode !== "")
+            parts.push(`**Seed Node**: ${seedNode} (deployment logs here)`);
+        parts.push(nodes.length > 0
+            ? `**Discovered Nodes**: ${nodes.join(", ")}`
+            : "**Discovered Nodes**: (none yet — call list_cluster_nodes)");
+    }
+    return parts.join("\n");
+}
+export function formatError(message) {
+    return `❌ **Error**: ${message}`;
+}
+export function formatNodeList(nodes, nodeIpMap, seedNode, clusterName, clusterIp) {
+    if (nodes.length === 0)
+        return "No cluster nodes discovered. The DVM may not have cluster cmdlets installed, or the cluster may not be deployed yet.";
+    const parts = ["## Cluster Nodes"];
+    if (clusterName !== "")
+        parts.push(`**Cluster**: ${clusterName} (${clusterIp})`);
+    parts.push("");
+    for (let i = 0; i < nodes.length; i++) {
+        const node = nodes[i];
+        const ip = nodeIpMap.get(node) ?? "unknown";
+        const marker = node.toLowerCase() === seedNode.toLowerCase() ? " ⭐ seed node" : "";
+        parts.push(`${i + 1}. \`${node}\` (${ip})${marker}`);
+    }
+    parts.push(`\n**Total**: ${nodes.length} node(s)`);
+    return parts.join("\n");
+}
+//# sourceMappingURL=formatting.js.map

package/dist/helpers/formatting.js.map

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