my_wins 1.5.0 → 1.5.1

package/docs/conemu.md

@@ -0,0 +1,40 @@
+# ConEmu integration
+
+`my_wins` can open console commands in `ConEmu` tabs instead of separate system `cmd.exe` windows.
+
+## How it works
+
+- Top-level `conemu` in `my_wins.json` points to `ConEmu.exe` or `ConEmu64.exe`.
+- When `conemu` is configured, console wins use `ConEmu` by default.
+- Per-win `conemu: true|false` overrides the default.
+- New tabs are created through `ConEmu` shell/macros.
+- After tab creation, `my_wins` explicitly renames the visible ConEmu tab caption to the win `title`.
+- The internal console title may still change while commands run, but the ConEmu tab caption should stay stable.
+
+## Example
+
+```json5
+{
+  conemu: "D:\\ProgsReady\\ConEmu\\ConEmu64.exe",
+  wins: {
+    api: {
+      title: "API",
+      cmd: "npm run dev"
+    },
+    worker: {
+      title: "Worker",
+      cmd: "npm run worker"
+    },
+    plain_cmd: {
+      conemu: false,
+      cmd: "echo this one uses a normal cmd window"
+    }
+  }
+}
+```
+
+## Current limitations
+
+- `ConEmu` support is Windows-only.
+- Background color for `ConEmu` tabs is applied after the tab is activated.
+- Automated integration testing for `ConEmu` is skipped if `ConEmu` is not installed at the expected test path.

package/lib/index.js

@@ -61,6 +61,13 @@ function toPowerShellSingleQuotedString(value) {
 	return `'${String(value).replace(/'/g, "''")}'`;
 }
 
+function buildConEmuCreateTabCommand(win) {
+	const titleCommand = `title ${win.matchTitle}`;
+	return {
+		titleCommand,
+	};
+}
+
 function getConEmuInfo(settings) {
 	if (!settings.conemu) return null;
 
@@ -94,24 +101,25 @@ function shouldUseConEmuForWin(settings, win, conemuInfo) {
 	return true;
 }
 
-async function execConEmuMacro(conemu, macro) {
+async function execConEmuMacro(conemu, macro, tabIndex) {
 	if (!conemu || !conemu.guiPid) throw new Error("ConEmu GUI PID is not initialized");
+	const guiMacroTarget = tabIndex ? `-GuiMacro:${conemu.guiPid}:T${tabIndex}` : `-GuiMacro:${conemu.guiPid}`;
 	const command = [
 		"&",
 		toPowerShellSingleQuotedString(conemu.macroPath),
-		toPowerShellSingleQuotedString(`-GuiMacro:${conemu.guiPid}`),
+		toPowerShellSingleQuotedString(guiMacroTarget),
 		toPowerShellSingleQuotedString(macro),
 	].join(" ");
 	const result = await execFileAsync("powershell", ["-NoProfile", "-Command", command]);
 	return (result.stdout || "").trim();
 }
 
-async function execConEmuCommand(conemu, command, commandArgs) {
+async function execConEmuCommand(conemu, command, commandArgs, tabIndex) {
 	const serializedArgs = (commandArgs || []).map((arg)=>{
 		if (typeof arg === "number") return String(arg);
 		return `"${String(arg).replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
 	});
-	return execConEmuMacro(conemu, `${command}(${serializedArgs.join(",")})`);
+	return execConEmuMacro(conemu, `${command}(${serializedArgs.join(",")})`, tabIndex);
 }
 
 async function findConEmuGuiPidByActiveTitle(title) {
@@ -178,7 +186,7 @@ async function waitForConEmuGuiPid(title, timeoutMs, beforePids) {
 }
 
 async function launchConEmuTab(conemu, win, isFirstTab) {
-	const titleCommand = `title ${win.tabTitle}`;
+	const { titleCommand } = buildConEmuCreateTabCommand(win);
 	if (isFirstTab) {
 		const beforePids = await listConEmuGuiPids();
 		const beforePid = beforePids.length ? beforePids[beforePids.length - 1] : null;
@@ -191,14 +199,18 @@ async function launchConEmuTab(conemu, win, isFirstTab) {
 		child.unref();
 		conemu.guiPid = await waitForConEmuGuiPid(null, 10000, beforePids);
 		const afterTabs = await listConEmuTabsByPid(conemu.guiPid, conemu.macroPath);
-		return afterTabs.length > beforeTabs.length ? afterTabs.length : afterTabs.length;
+		const tabIndex = afterTabs.length > beforeTabs.length ? afterTabs.length : afterTabs.length;
+		await renameConEmuTab(conemu, tabIndex, win.tabTitle);
+		return tabIndex;
 	}
 
 	const beforeTabs = await listConEmuTabsByPid(conemu.guiPid, conemu.macroPath);
 	await execConEmuCommand(conemu, "Shell", ["new_console", "cmd.exe", `/k ${titleCommand}`]);
 	await awaitDelay(300);
 	const afterTabs = await listConEmuTabsByPid(conemu.guiPid, conemu.macroPath);
-	return afterTabs.length > beforeTabs.length ? afterTabs.length : afterTabs.length;
+	const tabIndex = afterTabs.length > beforeTabs.length ? afterTabs.length : afterTabs.length;
+	await renameConEmuTab(conemu, tabIndex, win.tabTitle);
+	return tabIndex;
 }
 
 async function activateConEmuTab(conemu, tabIndex) {
@@ -206,22 +218,33 @@ async function activateConEmuTab(conemu, tabIndex) {
 	await awaitDelay(150);
 }
 
+async function renameConEmuTab(conemu, tabIndex, tabTitle) {
+	if (!tabTitle) return;
+	await execConEmuCommand(conemu, "Rename", [1, tabTitle], tabIndex);
+	await awaitDelay(150);
+}
+
+async function stabilizeConEmuTabTitle(conemu, win) {
+	if (!conemu || !win || !win.conemuTabIndex || !win.tabTitle) return;
+	await awaitDelay(500);
+	await renameConEmuTab(conemu, win.conemuTabIndex, win.tabTitle);
+	await awaitDelay(1000);
+	await renameConEmuTab(conemu, win.conemuTabIndex, win.tabTitle);
+}
+
 async function setConEmuBackgroundColor(conemu, tabIndex, backgroundcolor) {
 	if (!backgroundcolor) return;
-	await activateConEmuTab(conemu, tabIndex);
-	await execConEmuCommand(conemu, "SetOption", ["bgImage", backgroundcolor]);
+	await execConEmuCommand(conemu, "SetOption", ["bgImage", backgroundcolor], tabIndex);
 	await awaitDelay(150);
 }
 
 async function printInConEmuTab(conemu, tabIndex, cmd) {
-	await activateConEmuTab(conemu, tabIndex);
-	await execConEmuCommand(conemu, "Print", [cmd]);
+	await execConEmuCommand(conemu, "Print", [cmd], tabIndex);
 	await awaitDelay(200);
 }
 
 async function pressEnterInConEmuTab(conemu, tabIndex) {
-	await activateConEmuTab(conemu, tabIndex);
-	await execConEmuCommand(conemu, "Keys", ["Enter"]);
+	await execConEmuCommand(conemu, "Keys", ["Enter"], tabIndex);
 	await awaitDelay(200);
 }
 
@@ -436,6 +459,9 @@ async function runOnce(baseSettings, filterNames) {
 					await awaitDelay(delay);
 				}
 				await w.pressEnter();
+				if (shouldUseConEmuForWin(settings, w, conemu)) {
+					await stabilizeConEmuTabTitle(conemu, w);
+				}
 			}
 		}
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "my_wins",
-    "version": "1.5.0",
+    "version": "1.5.1",
     "description": "Automates starting and laying out your console windows for tsc, babel, tests, verdaccio, etc...",
     "keywords": [
         "automation",

package/readme.md

@@ -5,6 +5,7 @@ Automates starting your console windows for tsc, babel, tests, verdaccio, etc...
 my_wins opens **cmd** promts for you, position them nicely and types-in your commands into them.
 
 If you set `conemu`, my_wins will open tabs in that ConEmu instance instead of separate system `cmd` windows.
+Project docs are gradually being collected in [`docs`](./docs).
 
 ## Why?
 
@@ -125,6 +126,7 @@ It's recommended to gitignore "my_wins_personal.json".
 **x,y,height,width** *number* - is first cmd window's position and size
 
 **conemu** *string* - optional full path to `ConEmu.exe` or `ConEmu64.exe`. When present, console commands use ConEmu by default and are sent through ConEmu GuiMacro instead of the window key sender.
+ConEmu tabs keep their visible title from the win `title` field even if commands later change the internal console title.
 
 **y** gets incremented by **height** for each next window
 

package/test/run-test.js

@@ -8,6 +8,7 @@ const tempDir = path.join(repoRoot, "temp");
 const conemuTestFile = path.join(tempDir, "my_wins_conemu_test.txt");
 const conemuPath = "D:\\ProgsReady\\ConEmu\\ConEmu64.exe";
 const conemuTabTitle = "My Wins Visible Title";
+const conemuRuntimeTitle = "Changed By Command";
 const conemuBackgroundColor = "#123456";
 
 function sleep(ms) {
@@ -60,7 +61,7 @@ async function run() {
 					test_conemu: {
 						title: conemuTabTitle,
 						backgroundcolor: conemuBackgroundColor,
-						cmd: `echo my_wins conemu test> ${conemuTestFile} && ping -n 6 127.0.0.1 > nul && exit`,
+						cmd: `title ${conemuRuntimeTitle} && echo my_wins conemu test> ${conemuTestFile} && ping -n 12 127.0.0.1 > nul`,
 					},
 				},
 			},
@@ -89,14 +90,23 @@ async function run() {
 	}
 
 	const macroPath = path.join(path.dirname(conemuPath), "ConEmu", "ConEmuC64.exe");
-	const guiPid = execFileSync("powershell", [
+	const guiPidsRaw = execFileSync("powershell", [
 		"-NoProfile",
 		"-Command",
-		"(Get-Process ConEmu64,ConEmu -ErrorAction SilentlyContinue | Where-Object { $_.MainWindowHandle -ne 0 -and $_.MainWindowTitle -notlike 'About ConEmu*' } | Sort-Object Id -Descending | Select-Object -First 1 -ExpandProperty Id)",
+		"(Get-Process ConEmu64,ConEmu -ErrorAction SilentlyContinue | Where-Object { $_.MainWindowHandle -ne 0 -and $_.MainWindowTitle -notlike 'About ConEmu*' } | Sort-Object Id -Descending | Select-Object -ExpandProperty Id)",
 	], { encoding: "utf8" }).trim();
-	const tabs = execFileSync(macroPath, [`-GuiMacro:${guiPid}`, "Tab(12)"], { encoding: "utf8" });
-	if (!tabs.includes(conemuTabTitle)) {
-		throw new Error(`Expected ConEmu tabs list to include visible title '${conemuTabTitle}', got: ${tabs}`);
+	const guiPids = guiPidsRaw
+		.split(/\r?\n/)
+		.map((line) => line.trim())
+		.filter(Boolean);
+	const tabsByPid = guiPids.map((guiPid) => ({
+		guiPid,
+		tabs: execFileSync(macroPath, [`-GuiMacro:${guiPid}`, "Tab(12)"], { encoding: "utf8" }),
+	}));
+	const matchingWindow = tabsByPid.find((entry) => entry.tabs.includes(conemuTabTitle));
+	if (!matchingWindow) {
+		const allTabs = tabsByPid.map((entry) => `[${entry.guiPid}]\n${entry.tabs}`).join("\n---\n");
+		throw new Error(`Expected some ConEmu tabs list to include visible title '${conemuTabTitle}', got: ${allTabs}`);
 	}
 }